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 TVideoPicture

class TVideoPicture;

Description

One uncompressed video picture. Used for both decoded picture output as well as uncompressed picture input.

Members

Defined in TVideoPicture:
EBitTargets, ECropRect, EEffectParameters, EHeader, EPictureEffect, EReqInstantRefresh, ESceneCut, ETimestamp, TVideoPictureOptions, iCropRect, iData, iEffect, iFadeParam, iHeader, iLayerBitRates, iLink, iOptions, iTimestamp, iUser


Member enumerations


Enum TVideoPictureOptions

TVideoPictureOptions

Description

ETimestamp

The timestamp field is valid.

ECropRect

The crop rectangle field is valid.

EHeader

Picture header information is present.

EBitTargets

The layer bit count targets field is valid.

EReqInstantRefresh

Set in encoder input to request an instantaneous decoder refresh. As a response, the encoder should code an intra frame and no consecutive frame should refer to any frame before the encoded intra frame (in coding order).

ESceneCut

Set in encoder input to indicate a scene cut in the picture stream.

EPictureEffect

Set if a picture effect is in use and the picture effect field is valid.

EEffectParameters

Set if picture effect parameters are valid.

[Top]


Member data


iData

TPictureData iData;

Description

The picture data. The picture data, including all pointers, must remain valid until the picture has been returned to its originator.


iOptions

TUint32 iOptions;

Description

Picture options. The value is a bitfield combined from values from TVideoPictureOptions.


iTimestamp

TTimeIntervalMicroSeconds iTimestamp;

Description

Picture timestamp. Valid if ETimestamp is set in the options. Used for presentation timestamps in video playback and capture timestamps in uncompressed video input for recording. If the timestamp is not specified for decoded video input for playback, the picture is displayed immediately. For decoded video output in playback and uncompressed video input for recording, the timestamp must always be set.


iCropRect

TRect iCropRect;

Description

Pan-scan cropping rectangle. Defines the area of the picture used for further processing. Only used for decoded video output.


iHeader

TVideoPictureHeader * iHeader;

Description

Picture header information. Valid if EHeader is set in the options. Normally this field is only used in decoded pictures returned from the playback API. In that case the header info pointer is valid until the picture is returned to the API.


iLayerBitRates

RArray< TUint > * iLayerBitRates;

Description

The target number of bits for each bit-rate scalability layer, valid when EBitTargets is set in the options. Used in video encoding when the caller controls the bit-rate for each picture separately. The field points to a table containing the target number of bits to use for each layer when encoding this picture, starting from the lowest layer. The bit count for an enhancement layer includes all lower layers. For example, if the client uses two layers, and reserves 1.5 kilobits for the base layer and three kilobits for the whole picture, this field is set to {1500, 3000}.


iEffect

TPictureEffect iEffect;

Description

The picture effect in use when capturing this picture, valid when EPictureEffect is set in the options. This information can be used when encoding the picture. Note that setting a picture effect does not imply that the encoder should modify the picture data based on the effect. Instead, it can be used as an encoding hint. For example, fade to black implies that the global picture brightness has been decreased, and this knowledge can be used to aid motion prediction.


iFadeParam

TUint iFadeParam;

Description

Picture effect parameter for fade to/from black, valid when EEffectParameters is set in the options and iEffect is EEffectFadeFromBlack or EEffectFadeToBlack. The value range is [0…65536], with zero indicating the picture is black and 65536 indicating that the lightness of the picture is unchanged. If the parameter is not given, the caller is unaware of the proper value or the value fluctuates spatially.


iUser

TAny * iUser;

Description

A pointer for free-form user data. The pointer is set by the module that created the buffer, and is usually used for memory management purposes.


iLink

TDblQueLink iLink;

Description

A queue link used internally by the MSL video components.