Symbian^3 Application Developer Library >

CImagingConfigManager Class Reference

class CImagingConfigManager : public CBase

API class for getting imaging configurations and settings

This class can be used to query supported Video and Image quality settings (defined above) and CamcorderMMFPlugin settings.

imagingconfigmanager.lib
Since
S60 v3.2

Inherits from

Public Member Functions
~CImagingConfigManager ()
IMPORT_C TInt GetCamcorderMMFPluginSettings ( TCamcorderMMFPluginSettings &)
IMPORT_C TInt GetImageQualityLevelsL ( CArrayFixFlat < TUint > &, TUint )
IMPORT_C TInt GetImageQualitySet ( TImageQualitySet &, TInt , TUint )
IMPORT_C TInt GetImageQualitySet ( TImageQualitySet &, const TSize &, TUint )
IMPORT_C TInt GetVideoQualityLevelsL ( CArrayFixFlat < TUint > &, TUint )
IMPORT_C TInt GetVideoQualitySet ( TVideoQualitySet &, TInt , TUint )
IMPORT_C TInt GetVideoQualitySet ( TVideoQualitySet &, const TSize &, const TDesC8 &, TUint , TUint , TFourCC , TUint )
IMPORT_C CImagingConfigManager * NewL ()
IMPORT_C CImagingConfigManager * NewLC ()
IMPORT_C TInt NumberOfImageQualityLevels ()
IMPORT_C TInt NumberOfVideoQualityLevels ()
Private Member Functions
CImagingConfigManager ()
TBool CheckIfNegative (const TInt )
void ConstructL ()
TPtrC GetLeftPart (const TPtrC &)
TPtrC GetRightPartL (const TPtr &, const TDesC &)
void SetTextStringL (const TPtrC &, TText8 *)
TInt SortLevels ( CArrayFixFlat < TUint > &)
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()
Public Member Enumerations
enum TQualityLevels { EQualityMin  = 0, EQualityLow  = 100, EQualityNormal  = 200, EQualityHigh  = 300 }
Private Attributes
TCamcorderMMFPluginSettings iCamcorderMMFPluginSettings
CArrayFixFlat < TImageQualitySet > * iImageQualitySets
CArrayFixFlat < TVideoQualitySet > * iVideoQualitySets

Constructor & Destructor Documentation

CImagingConfigManager()

CImagingConfigManager ( ) [private]

Default constructor, doing nothing

~CImagingConfigManager()

~CImagingConfigManager ( )

Destructor

Since
S60 v3.2

Member Functions Documentation

CheckIfNegative(const TInt)

TBool CheckIfNegative ( const TInt aValue ) const [private]

Helper function to check if the given value is negative

Parameters

const TInt aValue

ConstructL()

void ConstructL ( ) [private]

Actual constructor where the reading from the Central Repository happens

GetCamcorderMMFPluginSettings(TCamcorderMMFPluginSettings &)

IMPORT_C TInt GetCamcorderMMFPluginSettings ( TCamcorderMMFPluginSettings & aSet ) const

Get all settings for Camcorder

Since
S60 v3.2

Parameters

TCamcorderMMFPluginSettings & aSet Returned setting set for CamcorderMMFPlugin

GetImageQualityLevelsL(CArrayFixFlat< TUint > &, TUint)

IMPORT_C TInt GetImageQualityLevelsL ( CArrayFixFlat < TUint > & aLevels,
TUint aCameraDisplayID = 0
)

Get an array of quality levels that are in use with the current product (for the given CameraDisplayId or for all levels)

Possible leave codes: KErrGeneral & KErrNoMemory

Since
S60 v3.2

Parameters

CArrayFixFlat < TUint > & aLevels Returns an array of image quality levels
TUint aCameraDisplayID = 0 Unique ID for some camera-display combination. If 0, then all levels are returned.

GetImageQualitySet(TImageQualitySet &, TInt, TUint)

IMPORT_C TInt GetImageQualitySet ( TImageQualitySet & aSet,
TInt aLevel,
TUint aCameraDisplayID = 0
)

Get image quality set associated with the given level. The level should be between EQualityHigh and EQualityMin. One the defined nominal levels should be used especially if NumberOfQualityLevels() == KNumberOfNominalLevels. If there is no set associated with given intermediate level, then set from a nearest level is returned.

Since
S60 v3.2

Parameters

TImageQualitySet & aSet Returned image quality set
TInt aLevel Level for which a quality set if requested
TUint aCameraDisplayID = 0 Unique ID for some camera-display combination. If 0, then ignored and the smallest ID is returned with given aLevel

GetImageQualitySet(TImageQualitySet &, const TSize &, TUint)

IMPORT_C TInt GetImageQualitySet ( TImageQualitySet & aSet,
const TSize & aImageResolution,
TUint aCameraDisplayID = 0
)

Get quality set associated with the given image resolution. Leaves if there is no defined set for the resolution.

Since
S60 v3.2

Parameters

TImageQualitySet & aSet Returned image quality set
const TSize & aImageResolution Size of the image resolution that is requested
TUint aCameraDisplayID = 0 Unique ID for some camera-display combination. If 0, then ignored and the smallest ID is returned with given aLevel

GetLeftPart(const TPtrC &)

TPtrC GetLeftPart ( const TPtrC & aPtrc ) const [private]

Helper function to get the left part of a string before the colon

Parameters

const TPtrC & aPtrc

GetRightPartL(const TPtr &, const TDesC &)

TPtrC GetRightPartL ( const TPtr & aPtr,
const TDesC & aSearchable
) const [private]

Helper function to get the right part of a string starting after the given key word

Parameters

const TPtr & aPtr
const TDesC & aSearchable

GetVideoQualityLevelsL(CArrayFixFlat< TUint > &, TUint)

IMPORT_C TInt GetVideoQualityLevelsL ( CArrayFixFlat < TUint > & aLevels,
TUint aCameraDisplayID = 0
)

Get an array of quality levels that are in use with the current product (for the given CameraDisplayId or for all levels)

Possible leave codes: KErrGeneral & KErrNoMemory

Since
S60 v3.2

Parameters

CArrayFixFlat < TUint > & aLevels Returns an array of video quality levels
TUint aCameraDisplayID = 0 Unique ID for some camera-display combination. If 0, then all levels are returned.

GetVideoQualitySet(TVideoQualitySet &, TInt, TUint)

IMPORT_C TInt GetVideoQualitySet ( TVideoQualitySet & aSet,
TInt aLevel,
TUint aCameraDisplayID = 0
)

Get quality set associated with the given level. The level should be between EQualityHigh and EQualityMin, but these are just for guidance in general. These are specified in their own documentation more specifically. If there is no set associated with given intermediate level, then set from a nearest level is returned.

Since
S60 v3.2

Parameters

TVideoQualitySet & aSet Returned video quality set
TInt aLevel Level for which a quality set if requested
TUint aCameraDisplayID = 0 Unique ID for some camera-display combination. If 0, then ignored and the smallest ID is returned with given aLevel

GetVideoQualitySet(TVideoQualitySet &, const TSize &, const TDesC8 &, TUint, TUint, TFourCC, TUint)

IMPORT_C TInt GetVideoQualitySet ( TVideoQualitySet & aSet,
const TSize & aVideoResolution,
const TDesC8 & aVideoCodecMimeType,
TUint aVideoPixelAspectRatioNum,
TUint aVideoPixelAspectRatioDenom,
TFourCC aAudioFourCCType,
TUint aCameraDisplayID = 0
)

Get quality set associated with the given video resolution, its MIME-type and audio fourCC. Both of these are needed to be uniquely able to select a single quality setting set. If certain pixel aspect ratio is wanted for the video, it can be requested with aVideoPixelAspectRatioNum and aVideoPixelAspectRatioDenom parameters. Otherwise they should be set to zero.

Since
S60 v3.2

Parameters

TVideoQualitySet & aSet Returned video quality set
const TSize & aVideoResolution Size of the video resolution that is requested
const TDesC8 & aVideoCodecMimeType MIME type of the video codec
TUint aVideoPixelAspectRatioNum Numerator of video's pixel aspect ratio
TUint aVideoPixelAspectRatioDenom Denominator of video's pixel aspect ratio
TFourCC aAudioFourCCType Four Character Code of the audio type
TUint aCameraDisplayID = 0 Unique ID for some camera-display combination. If 0, then ignored and the smallest ID is returned for the given parameters

NewL()

IMPORT_C CImagingConfigManager * NewL ( ) [static]

Create new CImagingConfigManager object

Possible leave codes: KErrGeneral & KErrNoMemory + possibly other CenRep Error codes

Since
S60 v3.2

NewLC()

IMPORT_C CImagingConfigManager * NewLC ( ) [static]

Create new CImagingConfigManager object

Possible leave codes: KErrGeneral & KErrNoMemory + possibly other CenRep Error codes

Since
S60 v3.2

NumberOfImageQualityLevels()

IMPORT_C TInt NumberOfImageQualityLevels ( ) const

Get number of defined image quality levels. This is always at least KNumberOfNominalLevels but can be higher

Since
S60 v3.2

NumberOfVideoQualityLevels()

IMPORT_C TInt NumberOfVideoQualityLevels ( ) const

Get number of defined video quality levels. This is always at least KNumberOfNominalLevels but can be higher

Since
S60 v3.2

SetTextStringL(const TPtrC &, TText8 *)

void SetTextStringL ( const TPtrC & aPtr,
TText8 * aStringToFill
) const [private]

Helper function to copy TPtrC to TText8*

Parameters

const TPtrC & aPtr
TText8 * aStringToFill

SortLevels(CArrayFixFlat< TUint > &)

TInt SortLevels ( CArrayFixFlat < TUint > & aLevels ) [private]

Method for sorting level numbers in ascending order

Parameters

CArrayFixFlat < TUint > & aLevels

Member Enumerations Documentation

Enum TQualityLevels

Enumerators

EQualityMin = 0
EQualityLow = 100
EQualityNormal = 200
EQualityHigh = 300

Member Data Documentation

TCamcorderMMFPluginSettings iCamcorderMMFPluginSettings

TCamcorderMMFPluginSettings iCamcorderMMFPluginSettings [private]

Camcorder MMF Plug-in's settings are stored here Own

CArrayFixFlat< TImageQualitySet > * iImageQualitySets

CArrayFixFlat < TImageQualitySet > * iImageQualitySets [private]

Image quality setting sets are stored internally to this pointer Own

CArrayFixFlat< TVideoQualitySet > * iVideoQualitySets

CArrayFixFlat < TVideoQualitySet > * iVideoQualitySets [private]

Video quality setting sets are stored internally to this pointer Own

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.