Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



Location: devvideobase.h

This item is not part of the S60 3rd Edition SDK for Symbian OS, Feature Pack 2.

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


Member enumerations


Enum THeaderOptions

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

[Top]


Member data


iOptions

TUint32 iOptions;

Description

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


iProfile

TInt iProfile;

Description

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


iLevel

TInt iLevel;

Description

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


iVersion

TInt iVersion;

Description

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


iOptional

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.


iSizeInMemory

TSize iSizeInMemory;

Description

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


iDisplayedRect

TRect iDisplayedRect;

Description

The portion of the full image to display.


iPresentationTimestamp

TTimeIntervalMicroSeconds iPresentationTimestamp;

Description

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


iDecodingTimestamp

TTimeIntervalMicroSeconds iDecodingTimestamp;

Description

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


iPreDecoderBufferSize

TUint iPreDecoderBufferSize;

Description

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


iPostDecoderBufferSize

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.


iPictureNumber

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.


iPictureLayer

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.


iSupplementalData

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.


iIsRandomAccessible

TBool iIsRandomAccessible;

Description

True if the picture is a random-accessible picture.


iRandomAccessBufferingPeriod

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.


iRandomAccessBufferOccupancy

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.