Destructor. Deletes all objects.

This function cancels the outstanding asynchronous read audio/video frame request.

No callback function will be called.

Note: As only one asynchronous parse audio or video frame(s) operation can be ongoing at any given time, this function can be used to cancel audio or video read request.

This function completes the parsing operation.

If C3GPParse::Complete is called before the parse is initialised, it will be ignored and KErrNone is returned.

The parser can be reused again after this call, following another call to C3GPParse::Open to re-initialise the parser.

This function reads DecoderSpecificInfo data from 3GP metadata and returns it to the caller.

Note: AMR DecoderSpecificInfo data structure is returned in runtime in an architecture-specific Endian format, that is, no Endian conversion is necessary for the data.

C3GPParse::GetAudioDecoderSpecificInfoSize

Returns size of audio DecoderSpecificInfo data from 3GP metadata.

This function returns the total size of the audio frames in the immediate audio sample based on the current position of the parser.

This function has no effect on the parser s current position.

This function returns the parameters describing the audio stream.

If no file or CAF object is supplied during parser initialisation, this should be called after enough data has been inserted into the library so that the 3GP headers containing the information can be read.

This function gives the audio sample entry index of the next audio frame to be read.

The smallest index value is 1.

This function returns the parameters that describe the contents of the input file or buffer.

If no file or CAF object is supplied during parser initialisation, this should be called after enough data has been inserted into the library so that the headers containing the information can be read.

This function determines whether the next frame of the type aType is available.

This function has no effect on the parser s current position.

This function returns the type of the next audio/video frame in the stream.

This function has no effect on the parser s current position.

This function provides the video level of the H263 video stream contained in the 3GP data.

This function returns the number of bytes that the library instance has in its allocated buffers.

The function is only valid when the parser is initialized without any parameters. Zero is returned when in file mode, that is, the parser has been initialized with a valid filename, file handle or a CAF object.

C3GPParse::InsertData.

Returns the number of video frames.

This function provides the storage mode of 13K QCELP in 3G2 file.

In 3G2 files, QCELP can be registered to be stored in two ways: using the QCELP Sample Entry ('sqcp') Box or using the MPEG4 Audio Sample Description ('esds') Box.

This function determines whether the input 3GP stream is streamable, that is, whether the media data is arranged in such a manner that playback can be started without downloading the entire stream.

Retrieves an atom of given type from user data atom (UDTA) to the given buffer.

The buffer returned stores an atom of structure that conforms to the definition of a "full box" as specified in ISO/IEC 14496-12:2003: "Information technology Coding of audio-visual objects Part 12: ISO base media file format."

For more information on user data atoms, see Section 8 Asset Information of "3GPP TS 26.244 version 6.1.0 3GP file format (Rel 6)."

Returns the needed size for memory buffer to store an atom of given type from user data atom (UDTA).

This function reads DecoderSpecificInfo data from 3GP metadata and returns it to the caller. For files with MPEG-4 video this data is read from the esds atom. For files with AVC video this data is read from the avcC atom.

Note: Only MPEG-4 video and H.264/AVC video streams contain DecoderSpecificInfo.

C3GPParse::GetVideoDecoderSpecificInfoSize

Return size of video DecoderSpecificInfo. For files with MPEG-4 video this data is read from the esds atom. For files with AVC video this data is read from the avcC atom.

Note: Only MPEG-4 video and H.264/AVC video streams contain DecoderSpecificInfo.

This function gets the next frame's dependency information from SDTP box.

Checks if a video frame of with index aIndex exists.

This function gets frame properties, from aStartIndex for a count of aNumberOfFrames frames.

Properties obtained are start time, frame type, and frame size, stored in the T3GPFrameInfoParameters struct.

This function returns the size of the immediate next video frame based on the current position of the parser.

Calling this function does not change the current position of the parser.

Returns video frame size.

Returns video frame start time.

This function returns the parameters describing the video stream.

If no file or CAF object is supplied during parser initialisation, this should be called after enough data has been inserted into the library buffers so that the 3GP headers containing the information can be read.

The aFrameRate parameter refers to the frame rate of the original video material.

This function gives the video sample entry index of the next video frame to be read.

The smallest index value is 1.

Returns the timestamp of the next video frame. The current position of the video stream will be moved forward.

The function can be used to find out which frames have been coded to optimize the input frame selection if video frame rate needs to be modified.

When this function call returns KErrEof, there are no more video frames left in the 3GP file and the timestamp returned with the previous call was the timestamp of the last video frame.

Note: C3GPParse::Seek can be used to change the current position in the 3GP file.

This function inserts MP4/3GP/3G2 data into the parser.

It is only necessary to call this function if no parameter has been supplied when C3GPParse::Open is called. Several functions can return KErr3gpLibMoreDataRequired if the library does not have enough data to return the information that the caller requests. In this case, more data needs to be inserted to the library before calling those functions again.

This function makes a copy of the data inserted into the library so the caller can use the input buffer for other purposes. If the function returns KErrNoMemory, the buffer contents have not been copied into the library and the caller needs to reduce the buffer content before calling again.

If an empty string is supplied for the argument aBuffer, it indicates that there is be no more data to feed through this function. Such a function call must be done to indicate that all 3GP/MP4/3G2 data has been written to the library's internal memory.

Creates an instance of a 3GP Parser for reading 3GP/3G2/MP4 data using default buffer size.

The default value for read buffer size is 8k.

Creates an instance of a 3GP Parser for reading 3GP/3G2/MP4 data, and sets the internal file read buffer size.

This function initialises the 3GP Parser for reading 3GP/3G2/MP4 data from a buffer and expects data to be inserted through subsequent calls to C3GPParse::InsertData.

C3GPParse::InsertData

This function initialises the 3GP Parser for reading 3GP/3G2/MP4 data from a file.

This function initialises the 3GP Parser for reading 3GP/3G2/MP4 data from a file.

This function initialises the 3GP Parser for reading 3GP/3G2/MP4 data from a file.

This function initialises the 3GP Parser for reading 3GP/3G2/MP4 data from a CAF object.

This function reads the audio frames that are stored in the current audio sample from the 3GP file/stream and returns them to the caller. The current position of audio stream will be moved forward.

Note: The next frame depends on the position in the input 3GP file. C3GPParse::Seek can be used to change the current position in the 3GP file.

If the function returns KErr3gpLibMoreDataRequired, the caller needs to call C3GPParse::InsertData to insert more data before calling the function again.

Note: aReturnedFrames may differ from the correct value when accessing the last audio sample.

Note: Since there are separate cursors for storing current positions for video and audio streams, calling this function does not change current position of the parser for video stream.

This function reads the audio frames that are stored in the current audio sample from the input file and returns them to the caller asynchronously. The current position of audio stream will be moved forward.

This function is not supported when the parser is in buffer mode.

C3GPParse::CancelReadFrame can be used to cancel an outstanding asynchronous frame read request.

Note: Only one asynchronous parse audio or video frame(s) operation can be ongoing at any given time.

Upon completion, successfully or otherwise, the callback function M3GPParseCallback::AudioFramesAvailable is called.

This function reads the next video frame from the 3GP file/stream and returns it to the caller. The current position of video stream will be moved forward.

The next frame depends on the position in the input 3GP file. C3GPParse::Seek can be used to change the current position in the 3GP file.

If the function returns KErr3gpLibMoreDataRequired, the caller needs to call C3GPParse::InsertData to insert more data before calling the function again.

Since there are separate cursors for storing current positions of video and audio streams, calling this function does not affect the position of the next audio stream.

This function reads the current video frame from an input file and returns it to the caller asynchronously. The current position of video stream will be moved forward.

This function is not supported when the parser is in buffer mode.

C3GPParse::CancelReadFrame can be used to cancel an outstanding asynchronous frame read request.

Note: Only one asynchronous parse audio or video frame(s) operation can be ongoing at any given time.

Upon completion, successfully or otherwise, the callback function M3GPParseCallback::VideoFrameAvailable is called.

This function seeks the position specified by the aPosition parameter in the input 3GP file/stream.

The position is considered to start from the beginning of the presentation time line in the 3GP file. Thus audio and video positions cannot be given separately.

The function will set the current audio and video positions in the following manner:

If there is only audio data in the file, the current position is set to the audio frame at or just before the given position.

If there is only video in the file and the key frame is EFalse, the current position is set to the video frame at or just before the given position. If the key frame is set to ETrue, the current position is set to the first key frame at or before the current position.

If there are both audio and video in the file, video is first positioned as explained above and then audio is sought to the closest position in relation to video.

If the position to seek is greater than the duration of video or audio, the video or audio position is set to the position of the last video or audio frame as explained above.

If the function returns KErr3gpLibMoreDataRequired, the caller needs to call C3GPParse::InsertData to insert more data before calling the function again.