Class TFrameInfo

TFrameInfo

Support

Supported from 6.0

Description

Contains information about a frame.

A frame is a single image within a stream of data that may contain multiple images, e.g. an animated GIF. An object of this class is filled by calling CMdaImageUtility::FrameInfo().

Defined in TFrameInfo:
EAlphaChannel, ECanDither, EColor, EConstantAspectRatio, EFullyScaleable, ELeaveInPlace, ERestoreToBackground, ERestoreToPrevious, ETransparencyPossible, TFrameInfoFlags, iBitsPerPixel, iDelay, iFlags, iFrameCoordsInPixels, iFrameSizeInTwips, iOverallSizeInPixels

See also:

• CMdaImageUtility::FrameInfo()

TRect iFrameCoordsInPixels

Description

The coordinates of the frame within the screen in pixels.

TSize iFrameSizeInTwips

Description

The size of the frame in twips.

TInt iBitsPerPixel

Description

The number of bits per pixel for the frame.

TTimeIntervalMicroSeconds iDelay

Description

The delay in microseconds before displaying the next frame.

TUint32 iFlags;

Description

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

TSize iOverallSizeInPixels

Description

The overall size of the image. A frame can occupy a rectangle within the overall image. In this case, the frame size is less than the overall image size, but iOverallSizeInPixels remains the same.

TFrameInfoFlags

Description

Flags that define the attributes of a frame.

The three image disposal methods (ELeaveInPlace, ERestoreToBackground and ERestoreToPrevious) indicate what should happen to a GIF frame after it has been displayed, before drawing the next one. They are mutually exclusive.

EColor Indicates whether or not the frame supports colour, i.e. if not set, the frame must be monochrome or greyscale. ETransparencyPossible Indicates whether or not transparency is possible in the frame. If not set, the frame must be fully opaque. EFullyScaleable Indicates whether or not the frame is fully scalable. If not set, the frame can only be resized to 1/2, 1/4 or 1/8th of the original frame size. EConstantAspectRatio Indicates whether or not the aspect ratio must be maintained during scaling. If not set, scaling need not maintain the aspect ratio, i.e. the frame can be stretched. ECanDither If set, indicates that the frame can be drawn dithered. If not set, the frame will not use dithering. EAlphaChannel If set, the image contains alpha-blending information. ELeaveInPlace Does not dispose of the frame — the frame is left in place. ERestoreToBackground Restores the area used by the frame to the background color. ERestoreToPrevious Restores the area used by the frame to whatever was there beforehand.