TVideoPictureHeader Class Reference

#include "devvideobase.h"

Link against: devvideo.lib

class TVideoPictureHeader

Detailed 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.

Member Attribute Documentation

iDecodingTimestamp

TTimeIntervalMicroSeconds iDecodingTimestamp

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

iDisplayedRect

TRect iDisplayedRect

The portion of the full image to display.

iIsRandomAccessible

TBool iIsRandomAccessible

True if the picture is a random-accessible picture.

iLevel

TInt iLevel

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

iOptional

const TDesC8 *iOptional

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.

iOptions

TUint32 iOptions

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

iPictureLayer

TUint iPictureLayer

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.

iPictureNumber

TUint iPictureNumber

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.

iPostDecoderBufferSize

TUint iPostDecoderBufferSize

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.

iPreDecoderBufferSize

TUint iPreDecoderBufferSize

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

iPresentationTimestamp

TTimeIntervalMicroSeconds iPresentationTimestamp

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

iProfile

TInt iProfile

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

iRandomAccessBufferOccupancy

TUint iRandomAccessBufferOccupancy

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.

iRandomAccessBufferingPeriod

TTimeIntervalMicroSeconds32 iRandomAccessBufferingPeriod

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.

iSizeInMemory

TSize iSizeInMemory

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

iSupplementalData

const TDesC8 *iSupplementalData

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.

iVersion

TInt iVersion

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

Member Enumeration Documentation

Enum THeaderOptions

EnumeratorValueDescription
EDecodingTimestamp0x00000001

Decoding timestamp is valid

EPresentationTimestamp0x00000002

Presentation timestamp is valid

EPreDecoderBufferSize0x00000004

Pre-decoder buffersize is valid

EPostDecoderBufferSize0x00000008

Post-decoder buffersize is valid

EPictureNumber0x00000010

Picture number field is valid

ELayeredCoding0x00000020

Layered coding is used and the layer number field is valid

ESupplementalData0x00000040

Supplemental data is available

ERandomAccessBufferingPeriod0x00000080

Random access buffering period is valid

ERandomAccessBufferOccupancy0x00000100

Random access buffer occupancy is valid