Class TVideoPictureHeader

class TVideoPictureHeader;

Description

Header information for one decoded picture. The header information is returned alongside with decoded pictures, or it can be read separately when DevVideoPlay is being initialized.

Members

Defined in TVideoPictureHeader:
EDecodingTimestamp, ELayeredCoding, EPictureNumber, EPostDecoderBufferSize, EPreDecoderBufferSize, EPresentationTimestamp, ERandomAccessBufferOccupancy, ERandomAccessBufferingPeriod, ESupplementalData, THeaderOptions, iDecodingTimestamp, iDisplayedRect, iIsRandomAccessible, iLevel, iOptional, iOptions, iPictureLayer, iPictureNumber, iPostDecoderBufferSize, iPreDecoderBufferSize, iPresentationTimestamp, iProfile, iRandomAccessBufferOccupancy, iRandomAccessBufferingPeriod, iSizeInMemory, iSupplementalData, iVersion

THeaderOptions

Description

EDecodingTimestamp Decoding timestamp is valid EPresentationTimestamp Presentation timestamp is valid EPreDecoderBufferSize Pre-decoder buffersize is valid EPostDecoderBufferSize Post-decoder buffersize is valid EPictureNumber Picture number field is valid ELayeredCoding Layered coding is used and the layer number field is valid ESupplementalData Supplemental data is available ERandomAccessBufferingPeriod Random access buffering period is valid ERandomAccessBufferOccupancy Random access buffer occupancy is valid

TUint32 iOptions;

Description

Header options. The value is a bitfield combined from values from THeaderOptions.

TInt iProfile;

Description

Video codec profile used. Use -1 if not applicable or not defined.

TInt iLevel;

Description

Video codec level. Use -1 if not applicable or not defined.

TInt iVersion;

Description

Video codec version. Use -1 if not applicable or not defined.

const TDesC8 * iOptional;

Description

Pointer to a descriptor that contains optional codec-specific features. Set to NULL if not used. The format of the data is codec-specific. The pointer and descriptor data are valid as long as the header information structure is valid.

TSize iSizeInMemory;

Description

Image size in memory, in pixels. May be larger than the displayed picture.

TRect iDisplayedRect;

Description

The portion of the full image to display.

TTimeIntervalMicroSeconds iPresentationTimestamp;

Description

Picture presentation timestamp. Valid only if EPresentationTimestamp is set in the options. The clock frequency is stored in the timestamp structure.

TTimeIntervalMicroSeconds iDecodingTimestamp;

Description

Picture decoding timestamp. Valid only if EDecodingTimestamp is set in the options.

TUint iPreDecoderBufferSize;

Description

Expected pre-decoder buffer size in bytes. Valid only if EPreDecoderBufferSize is set in the options.

TUint iPostDecoderBufferSize;

Description

Expected post-decoder buffer size in bytes. Valid only if EPostDecoderBufferSize is set in the options. It is assumed that a frame buffer to be displayed is returned before the decoding of the next frame is started. If this is not the case, a larger post-decoder buffer may actually be needed.

TUint iPictureNumber;

Description

Picture number, valid only if EPictureNumber is set in the options. This field is used to indicate one of the following: picture number or long-term picture index for H.263, vop_id for MPEG-4 Visual, picture number or long-term picture number for AVC.

TUint iPictureLayer;

Description

Picture layer number if layered coding is used, valid only if ELayeredCoding is set in the options. Layers are numbered [0…n-1], where n is the number of layers available. The first layer (layer zero) is the base layer, it can be decoded independently from the other layers, and it has the lowest total bitrate.

const TDesC8 * iSupplementalData;

Description

Picture supplemental data, valid only if ESupplementalData is set in the options. The pointer and descriptor data are valid as long as the header information structure is valid.

TBool iIsRandomAccessible;

Description

True if the picture is a random-accessible picture.

TTimeIntervalMicroSeconds32 iRandomAccessBufferingPeriod;

Description

The expected initial pre-decoder buffering period before starting the playback from this picture. Valid only if this picture is randomly accessible (iIsRandomAccessible is true) and ERandomAccessBufferingPeriod is set in the options. MPEG-2 and H.264 | MPEG-4 AVC use this value.

TUint iRandomAccessBufferOccupancy;

Description

The expected initial pre-decoder buffer occupancy in bytes before starting the playback from this picture. Valid if this picture is randomly accessible (iIsRandomAccessible is true) and ERandomAccessBufferOccupancy is set in the options. MPEG-4 Visual uses this value.