Symbian^3 Product Developer Library >

CImageDisplayFramework Class Reference

class CImageDisplayFramework : public CBase

Inherits from

  • CImageDisplayFramework
Private Member Functions
CImageDisplayFramework(CImageDisplay &, MIclImageDisplayObserver &, RFs &)
~CImageDisplayFramework()
voidCallbackImageReady(const CFbsBitmap *, TUint, const TRect &, TInt)
voidClearFlag(TInt)
CImageDisplayPlugin *DataNewL(const TDesC8 &, const TUid, const TUid, const TUid)
voidDeletePlugin()
const TSize &DestinationSizeInPixels()
TDisplayMode DisplayMode()
TInt ExtensionInterface(TUid, TAny *&)
CImageDisplayPlugin *FileHandleNewImplL(RFile &, const TUid, const TUid, const TUid)
CImageDisplayPlugin *FileNewImplL(const TDesC &, const TUid, const TUid, const TUid)
CImageDisplayPlugin *FindDisplayerNewL(const RImplInfoPtrArray &)
TBool FlagSet(TInt)
voidGetBitmap(const CFbsBitmap *&, const CFbsBitmap *&)
TUint ImageStatus()
voidImageTypeGetDisplayerListL(RImplInfoPtrArray &, const TDesC8 &, const TUid, const TUid, const TUid)
TBool MaintainAspectRatio()
voidMimeTypeGetDisplayerListL(RImplInfoPtrArray &, const TDesC8 &)
CImageDisplayPlugin *NewImplL(const TDesC8 &)
CImageDisplayFramework *NewL(CImageDisplay &, MIclImageDisplayObserver &, RFs &)
TInt NumFrames(TInt &)
TUint Options()
voidPause()
voidPlay()
const CImageDisplay::RImageSizeArray &RecommendedImageSizes()
voidReset()
voidResetSourceRect()
voidSetDisplayMode(TDisplayMode)
voidSetFlag(TInt)
TInt SetImageSource(const TMMSource &)
TInt SetOptions(TUint)
voidSetPluginUid(TUid)
voidSetSizeInPixels(const TSize &, TBool)
voidSetSourceImageType(TUid, TUid)
voidSetSourceMimeType(const TDesC8 &)
voidSetSourceRect(const TRect &)
voidSetupL()
const TDesC8 &SourceData()
const TDesC &SourceDataId()
ContentAccess::TIntent SourceDataIntent()
RFile &SourceFileHandle()
const TDesC &SourceFilename()
const TUidSourceImageSubType()
const TUidSourceImageType()
const TDesC8 &SourceMimeType()
TBool SourceRect(TRect &)
CImageDisplayPlugin::TImageSourceType SourceType()
voidStopPlay()
voidSuffixTypeGetDisplayerListL(RImplInfoPtrArray &, const TDesC &)
TBool ValidBitmap()
Inherited Functions
CBase::CBase()
CBase::Delete(CBase *)
CBase::Extension_(TUint,TAny *&,TAny *)
CBase::operator new(TUint)
CBase::operator new(TUint,TAny *)
CBase::operator new(TUint,TLeave)
CBase::operator new(TUint,TLeave,TUint)
CBase::operator new(TUint,TUint)
CBase::~CBase()
Private Member Enumerations
enumTFrameworkState { EStateOpened = 0, EStateConfigured, EStatePluginLoaded, EStateProcessing, EStatePaused }
enumTImageDisplayInternalFlags { EFlagMaintainAspectRatio = 0x00000001, EFlagSourceRectSet = 0x00000002 }
Private Attributes
MIclImageDisplayObserver &iCallback
TSize iDestinationSize
TDisplayMode iDisplayMode
TInt iFlags
RFs &iFs
CImageDisplay &iHandle
TUint iOptions
CImageDisplayPlugin *iPlugin
TUid iPluginUid
TImageParameterData iSourceImage
TRect iSourceRect
enum CImageDisplayFramework::TFrameworkStateiState

Constructor & Destructor Documentation

CImageDisplayFramework(CImageDisplay &, MIclImageDisplayObserver &, RFs &)

CImageDisplayFramework(CImageDisplay &aHandle,
MIclImageDisplayObserver &aCallback,
RFs &aFs
)[private]

CImageDisplayFramework

Parameters

CImageDisplay & aHandle
MIclImageDisplayObserver & aCallback
RFs & aFs

~CImageDisplayFramework()

~CImageDisplayFramework()[private]

~CImageDisplayFramework This is the destructor for the CImageDisplayFramework and is resposible for deallocating all resources allocated by the CImageDisplayFramework

Member Functions Documentation

CallbackImageReady(const CFbsBitmap *, TUint, const TRect &, TInt)

voidCallbackImageReady(const CFbsBitmap *aBitmap,
TUintaStatus,
const TRect &aUpdatedArea,
TIntaError
)[private]

Parameters

const CFbsBitmap * aBitmap
TUint aStatus
const TRect & aUpdatedArea
TInt aError

ClearFlag(TInt)

voidClearFlag(TIntaFlag)[private, inline]

Parameters

TInt aFlag

DataNewL(const TDesC8 &, const TUid, const TUid, const TUid)

CImageDisplayPlugin *DataNewL(const TDesC8 &aSourceData,
const TUidaImageType,
const TUidaImageSubType,
const TUidaPluginUid
)[private]

Creates a displayer for the image in the source buffer.

If the client supplies an image type (and sub-type, if applicable) or displayer UID, these will be used to try and select an appropriate plugin displayer. If not, then the selection will be done by matching the image header from the buffer. If it finds a displayer, it is created and then used to scan the beginning of the image buffer.

leave
KErrUnderflow Not enough data in descriptor to identify which plugin displayer to use.
leave
KEComErrNoInterfaceIdentified No plugin displayers were found.
panic
EIllegalImageSubType No base type given for sub-type.

Parameters

const TDesC8 & aSourceDataThe buffer containing the image to be displayed.
const TUid aImageTypeThe image type of the image in the file (optional, defaults to KNullUid).
const TUid aImageSubTypeThe image sub-type of the image in the file (optional, defaults to KNullUid).
const TUid aPluginUidThe implementation UID for a specific codec (optional, defaults to KNullUid). If this option is selected the image type and image sub type for the displayer must be supplied.

DeletePlugin()

voidDeletePlugin()[private, inline]

DestinationSizeInPixels()

const TSize &DestinationSizeInPixels()const [private]

DisplayMode()

TDisplayMode DisplayMode()const [private]

ExtensionInterface(TUid, TAny *&)

TInt ExtensionInterface(TUidaIFaceUid,
TAny *&aIFacePtr
)[private]

Gets a pointer to a plugin extension

panic
EIllegalCallSequence No plugin loaded.

Parameters

TUid aIFaceUid
TAny *& aIFacePtr

FileHandleNewImplL(RFile &, const TUid, const TUid, const TUid)

CImageDisplayPlugin *FileHandleNewImplL(RFile &aFileHandle,
const TUidaImageType,
const TUidaImageSubType,
const TUidaPluginUid
)[private]
Create a displayer for the image using the given file handle. If the client supplies an image type (and sub-type, if applicable) or displayer uid, these will be used to try and select an appropriate plugin displayer. If not, then the selection will be done by matching the image header in the file. If it finds a displayer it creates it and then goes on to use that displayer to scan the beginning of the image file.
leave
KErrUnderflow Not enough data in file to identify which plugin displayer to use.
leave
KEComErrNoInterfaceIdentified No plugin displayers were found.
panic
EIllegalImageSubType No base type given for sub-type.
panic
EIllegalImageType No base type given for displayer implementation.

Parameters

RFile & aFileHandleA reference to a file handle that contains an image data
const TUid aImageTypeThe image type of the image in the file (optional, defaults to KNullUid).
const TUid aImageSubTypeThe image sub-type of the image in the file (optional, defaults to KNullUid).
const TUid aPluginUidThe implementation uid for a specific codec (optional, defaults to KNullUid). If this option is selected the image type and image sub type for the displayer must be supplied.

FileNewImplL(const TDesC &, const TUid, const TUid, const TUid)

CImageDisplayPlugin *FileNewImplL(const TDesC &aSourceFilename,
const TUidaImageType,
const TUidaImageSubType,
const TUidaPluginUid
)[private]
Create a displayer for the image in the named file. If the client supplies an image type (and sub-type, if applicable) or displayer uid, these will be used to try and select an appropriate plugin displayer. If not, then the selection will be done by matching the image header in the file. If it finds a displayer it creates it and then goes on to use that displayer to scan the beginning of the image file.
leave
KErrUnderflow Not enough data in file to identify which plugin displayer to use.
leave
KEComErrNoInterfaceIdentified No plugin displayers were found.
panic
EIllegalImageSubType No base type given for sub-type.
panic
EIllegalImageType No base type given for displayer implementation.

Parameters

const TDesC & aSourceFilenameThe name of the file to be converted.
const TUid aImageTypeThe image type of the image in the file (optional, defaults to KNullUid).
const TUid aImageSubTypeThe image sub-type of the image in the file (optional, defaults to KNullUid).
const TUid aPluginUidThe implementation uid for a specific codec (optional, defaults to KNullUid). If this option is selected the image type and image sub type for the displayer must be supplied.

FindDisplayerNewL(const RImplInfoPtrArray &)

CImageDisplayPlugin *FindDisplayerNewL(const RImplInfoPtrArray &aDisplayerList)[private]

Scan a sorted list of displayers for the first one that can convert the image.

Parameters

const RImplInfoPtrArray & aDisplayerListA list of displayers that support the image format.

FlagSet(TInt)

TBool FlagSet(TIntaFlag)const [private, inline]

Parameters

TInt aFlag

GetBitmap(const CFbsBitmap *&, const CFbsBitmap *&)

voidGetBitmap(const CFbsBitmap *&aBitmap,
const CFbsBitmap *&aMask
)const [private]

Parameters

const CFbsBitmap *& aBitmap
const CFbsBitmap *& aMask

ImageStatus()

TUint ImageStatus()const [private]

ImageTypeGetDisplayerListL(RImplInfoPtrArray &, const TDesC8 &, const TUid, const TUid, const TUid)

voidImageTypeGetDisplayerListL(RImplInfoPtrArray &aDisplayerList,
const TDesC8 &aImageHeader,
const TUidaImageType,
const TUidaImageSubType,
const TUidaPluginUid
)[private]

Create a list of displayers that support the specified image type.

Parameters

RImplInfoPtrArray & aDisplayerListA list of displayers that support the specified image type.
const TDesC8 & aImageHeaderThe header of the image file.
const TUid aImageTypeThe image base type.
const TUid aImageSubTypeThe image sub type.
const TUid aPluginUidA specific displayer to convert the image.

MaintainAspectRatio()

TBool MaintainAspectRatio()const [private]

MimeTypeGetDisplayerListL(RImplInfoPtrArray &, const TDesC8 &)

voidMimeTypeGetDisplayerListL(RImplInfoPtrArray &aDisplayerList,
const TDesC8 &aMIMEType
)[private]

Create a list of converts that support the specified MIME type.

panic
EUndefinedMIMEType

Parameters

RImplInfoPtrArray & aDisplayerListCreate a list of converts that support the given MIME type.
const TDesC8 & aMIMETypeThe MIME type to convert.

NewImplL(const TDesC8 &)

CImageDisplayPlugin *NewImplL(const TDesC8 &aMIMEType)[private]
Create a display plugin for the image in the named file. The client supplies a MIME type which will be used to try and select an appropriate plugin Displayer. If it finds a Displayer it creates it and then goes on to use that displayer to scan the beginning of the image file.
leave
KEComErrNoInterfaceIdentified No plugin displayers were found.

Parameters

const TDesC8 & aMIMETypeThe MIME type of the image in the file.

NewL(CImageDisplay &, MIclImageDisplayObserver &, RFs &)

CImageDisplayFramework *NewL(CImageDisplay &aHandle,
MIclImageDisplayObserver &aCallback,
RFs &aFs
)[private, static]

NewL The function NewL constructs a CImageDisplayFramework

Parameters

CImageDisplay & aHandle
MIclImageDisplayObserver & aCallback
RFs & aFs

NumFrames(TInt &)

TInt NumFrames(TInt &aNumFrames)const [private]

Parameters

TInt & aNumFrames

Options()

TUint Options()const [private]

Pause()

voidPause()[private]

Play()

voidPlay()[private]

RecommendedImageSizes()

const CImageDisplay::RImageSizeArray &RecommendedImageSizes()const [private]

Reset()

voidReset()[private]

ResetSourceRect()

voidResetSourceRect()[private]

SetDisplayMode(TDisplayMode)

voidSetDisplayMode(TDisplayModeaDisplayMode)[private]

Parameters

TDisplayMode aDisplayMode

SetFlag(TInt)

voidSetFlag(TIntaFlag)[private, inline]

Parameters

TInt aFlag

SetImageSource(const TMMSource &)

TInt SetImageSource(const TMMSource &aImageSource)[private]

Parameters

const TMMSource & aImageSource

SetOptions(TUint)

TInt SetOptions(TUintaOptions)[private]

Parameters

TUint aOptions

SetPluginUid(TUid)

voidSetPluginUid(TUidaPluginUid)[private]

Parameters

TUid aPluginUid

SetSizeInPixels(const TSize &, TBool)

voidSetSizeInPixels(const TSize &aDestinationSize,
TBoolaMaintainAspectRatio
)[private]

Parameters

const TSize & aDestinationSize
TBool aMaintainAspectRatio

SetSourceImageType(TUid, TUid)

voidSetSourceImageType(TUidaImageType,
TUidaImageSubType
)[private]

Parameters

TUid aImageType
TUid aImageSubType

SetSourceMimeType(const TDesC8 &)

voidSetSourceMimeType(const TDesC8 &aMIMEType)[private]

Parameters

const TDesC8 & aMIMEType

SetSourceRect(const TRect &)

voidSetSourceRect(const TRect &aRect)[private]

Parameters

const TRect & aRect

SetupL()

voidSetupL()[private]

SourceData()

const TDesC8 &SourceData()const [private]

SourceDataId()

const TDesC &SourceDataId()const [private, inline]

SourceDataIntent()

ContentAccess::TIntent SourceDataIntent()const [private, inline]

SourceFileHandle()

RFile &SourceFileHandle()const [private]

SourceFilename()

const TDesC &SourceFilename()const [private]

SourceImageSubType()

const TUidSourceImageSubType()const [private]

SourceImageType()

const TUidSourceImageType()const [private]

SourceMimeType()

const TDesC8 &SourceMimeType()const [private]

SourceRect(TRect &)

TBool SourceRect(TRect &aRect)const [private]

Parameters

TRect & aRect

SourceType()

CImageDisplayPlugin::TImageSourceType SourceType()const [private]

StopPlay()

voidStopPlay()[private]

SuffixTypeGetDisplayerListL(RImplInfoPtrArray &, const TDesC &)

voidSuffixTypeGetDisplayerListL(RImplInfoPtrArray &aDisplayerList,
const TDesC &aFileName
)[private]

Create a list of displayers that support the specified file extension.

Parameters

RImplInfoPtrArray & aDisplayerListCreate a list of displayers that support the given file extension.
const TDesC & aFileNameThe file name from which the file extension will be taken.

ValidBitmap()

TBool ValidBitmap()const [private]

Member Enumerations Documentation

Enum TFrameworkState

Enumerators

EStateOpened = 0
EStateConfigured
EStatePluginLoaded
EStateProcessing
EStatePaused

Enum TImageDisplayInternalFlags

Enumerators

EFlagMaintainAspectRatio = 0x00000001
EFlagSourceRectSet = 0x00000002

Member Data Documentation

MIclImageDisplayObserver & iCallback

MIclImageDisplayObserver &iCallback[private]

TSize iDestinationSize

TSize iDestinationSize[private]

TDisplayMode iDisplayMode

TDisplayMode iDisplayMode[private]

TInt iFlags

TInt iFlags[private]

RFs & iFs

RFs &iFs[private]

CImageDisplay & iHandle

CImageDisplay &iHandle[private]

TUint iOptions

TUint iOptions[private]

CImageDisplayPlugin * iPlugin

CImageDisplayPlugin *iPlugin[private]

TUid iPluginUid

TUid iPluginUid[private]

TImageParameterData iSourceImage

TImageParameterData iSourceImage[private]

TRect iSourceRect

TRect iSourceRect[private]

enum CImageDisplayFramework::TFrameworkState iState

enum CImageDisplayFramework::TFrameworkStateiState[private]

Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.