Collapse all Symbian^3 Product 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

CImagingConfigManager
- CBase

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