Collapse all Symbian^3 Product Developer Library

TFrameInfo Class Reference

class TFrameInfo

General frame info provided by all plugins.

Public Member Functions
IMPORT_C TInt	CurrentDataOffset()
IMPORT_C TFrameInfoState	CurrentFrameState()
IMPORT_C TInt	FrameDataOffset()
IMPORT_C void	SetCurrentDataOffset(TInt)
IMPORT_C void	SetCurrentFrameState(TFrameInfoState)
IMPORT_C void	SetFrameDataOffset(TInt)

Public Member Enumerations
enum	TFrameInfoFlags { EColor = 0x00000001, ETransparencyPossible = 0x00000002, EFullyScaleable = 0x00000004, EConstantAspectRatio = 0x00000008, ECanDither = 0x00000010, EAlphaChannel = 0x00000020, ELeaveInPlace = 0x00000040, ERestoreToBackground = 0x00000080, ERestoreToPrevious = 0x00000100, EPartialDecodeInvalid = 0x00000200, EMngMoreFramesToDecode = 0x00000400, EUsesFrameSizeInPixels = 0x00000800 }
enum	TFrameInfoState { EFrameInfoUninitialised, EFrameInfoProcessingFrameHeader, EFrameInfoProcessingFrame, EFrameInfoProcessingComplete }

Public Attributes
TRgb	iBackgroundColor
TInt	iBitsPerPixel
TTimeIntervalMicroSeconds	iDelay
TUint32	iFlags
TRect	iFrameCoordsInPixels
TDisplayMode	iFrameDisplayMode
TSize	iFrameSizeInPixels
TSize	iFrameSizeInTwips
TSize	iOverallSizeInPixels

Private Attributes
TInt	iCurrentDataOffset
TFrameInfoState	iCurrentFrameState
TInt	iFrameDataOffset
TInt	iReserved_1

Member Functions Documentation

CurrentDataOffset()

IMPORT_C TInt

CurrentDataOffset

(

)

const

Returns the current data offset.

CurrentFrameState()

IMPORT_C TFrameInfoState

CurrentFrameState

(

)

const

Returns the current frame state.

FrameDataOffset()

IMPORT_C TInt

FrameDataOffset

(

)

const

Returns the frame data offset.

SetCurrentDataOffset(TInt)

IMPORT_C void

SetCurrentDataOffset

(

TInt

aOffset

)

Sets the current data offset to the supplied value.

Parameters

TInt aOffset

The data offset.

SetCurrentFrameState(TFrameInfoState)

IMPORT_C void

SetCurrentFrameState

(

TFrameInfoState

aFrameInfoState

)

Sets the current frame state to the supplied value.

Parameters

TFrameInfoState aFrameInfoState

The frame state.

SetFrameDataOffset(TInt)

IMPORT_C void

SetFrameDataOffset

(

TInt

aOffset

)

Sets the frame data offset to the supplied value.

Parameters

TInt aOffset

The frame data offset.

Member Enumerations Documentation

Enum TFrameInfoFlags

Flags that define the attributes of a frame. These can be combined using an OR operation.

Enumerators

EColor = 0x00000001	Indicates whether or not the frame is colour.
ETransparencyPossible = 0x00000002	Indicates if any part of the frame is transparent.
EFullyScaleable = 0x00000004	Indicates whether or not the frame can be scaled.
EConstantAspectRatio = 0x00000008	Indicates whether or not the frame's aspect ratio must be maintained during scaling. If not set, the frame can be stretched.
ECanDither = 0x00000010	Indicates if the frame can be decoded and drawn dithered. If this is not set, the bitmap must use the recommended display mode.
EAlphaChannel = 0x00000020	Indicates if the frame contains alpha-blending information. This setting is only valid if ETransparencyPossible is set.
ELeaveInPlace = 0x00000040	Mutually exclusive image disposal method 1, no disposal specified. Image is not disposed of and graphic is left in place.
ERestoreToBackground = 0x00000080	Mutually exclusive image disposal method 2, restore to background colour. The area used by the graphic must be restored to the background colour.
ERestoreToPrevious = 0x00000100	Mutually exclusive image disposal method 3, restore to previous. The decoder is required to restore the area overwritten by the graphic with what was there prior to rendering the graphic.
EPartialDecodeInvalid = 0x00000200	If this flag is set and an image convert operation returns KErrUnderFlow, the partially decoded bitmap is not suitable for display.
EMngMoreFramesToDecode = 0x00000400	This flag is used by Mng decoder to indicate that there are more frames to decode
EUsesFrameSizeInPixels = 0x00000800	This flag is used to indicate that the code sets iFrameSizeInPixels

Enum TFrameInfoState

Indicates the current status of frame processing.

Enumerators

EFrameInfoUninitialised	The frame information has not been initialised.
EFrameInfoProcessingFrameHeader	The frame header is being processed.
EFrameInfoProcessingFrame	The frame is being processed.
EFrameInfoProcessingComplete	The frame has been processed.

Member Data Documentation

TRgb iBackgroundColor

TRgb	iBackgroundColor

The background color for the frame.

TInt iBitsPerPixel

TInt	iBitsPerPixel

The number of bits per pixel for the frame.

TInt iCurrentDataOffset

TInt

iCurrentDataOffset

[private]

TFrameInfoState iCurrentFrameState

TFrameInfoState

iCurrentFrameState

[private]

TTimeIntervalMicroSeconds iDelay

TTimeIntervalMicroSeconds

iDelay

The delay in microseconds before displaying the next frame.

TUint32 iFlags

TUint32

iFlags

Frame information flags. A combination of the values contained in the TFrameInfoFlags enum.

TRect iFrameCoordsInPixels

TRect

iFrameCoordsInPixels

The coordinates of the frame within the screen in pixels.

TInt iFrameDataOffset

TInt

iFrameDataOffset

[private]

TDisplayMode iFrameDisplayMode

TDisplayMode

iFrameDisplayMode

The display mode for the frame.

TSize iFrameSizeInPixels

TSize

iFrameSizeInPixels

The size of frame in pixels

TSize iFrameSizeInTwips

TSize

iFrameSizeInTwips

The size of the frame in twips.

TSize iOverallSizeInPixels

TSize

iOverallSizeInPixels

The size of the frame. A frame can occupy a rectangle within the overall image. In this case, the frame size is less than the overall image size. For a GIF image, the following applies: For the first frame of the image, iOverallSizeInPixels will be the greater of the logical screen size and the size of the first frame. The logical screen size is defined in the logical screen descriptor block of the GIF image. If the GIF is animated it will contain a set of frames. The first frame will be full size but subsequent frames are sub-frames and iOverallSizeInPixels may differ for each sub-frame.

TInt iReserved_1

TInt

iReserved_1

[private]