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:

• EDecodingTimestampDecoding timestamp is valid
• ELayeredCodingLayered coding is used and the layer number field is valid
• EPictureNumberPicture number field is valid
• EPostDecoderBufferSizePost-decoder buffersize is valid
• EPreDecoderBufferSizePre-decoder buffersize is valid
• EPresentationTimestampPresentation timestamp is valid
• ERandomAccessBufferOccupancyRandom access buffer occupancy is valid
• ERandomAccessBufferingPeriodRandom access buffering period is valid
• ESupplementalDataSupplemental data is available
• THeaderOptions
• iDecodingTimestampPicture decoding timestamp. Valid only if EDecodingTimestamp is set in the optio...
• iDisplayedRectThe portion of the full image to display.
• iIsRandomAccessibleTrue if the picture is a random-accessible picture.
• iLevelVideo codec level. Use -1 if not applicable or not defined.
• iOptionalPointer to a descriptor that contains optional codec-specific features. Set to N...
• iOptionsHeader options. The value is a bitfield combined from values from THeaderOptions...
• iPictureLayerPicture layer number if layered coding is used, valid only if ELayeredCoding is ...
• iPictureNumberPicture number, valid only if EPictureNumber is set in the options. This field i...
• iPostDecoderBufferSizeExpected post-decoder buffer size in bytes. Valid only if EPostDecoderBufferSize...
• iPreDecoderBufferSizeExpected pre-decoder buffer size in bytes. Valid only if EPreDecoderBufferSize i...
• iPresentationTimestampPicture presentation timestamp. Valid only if EPresentationTimestamp is set in t...
• iProfileVideo codec profile used. Use -1 if not applicable or not defined.
• iRandomAccessBufferOccupancyThe expected initial pre-decoder buffer occupancy in bytes before starting the p...
• iRandomAccessBufferingPeriodThe expected initial pre-decoder buffering period before starting the playback f...
• iSizeInMemoryImage size in memory, in pixels. May be larger than the displayed picture.
• iSupplementalDataPicture supplemental data, valid only if ESupplementalData is set in the options...
• iVersionVideo codec version. Use -1 if not applicable or not defined.

THeaderOptions

Description

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.