CCamera::CCameraPreImageCaptureControl Class Reference

class CCamera::CCameraPreImageCaptureControl : public CBase

CCameraPreImageCaptureControl class exposes an API for controlling image operations/settings prior to image capture.

Note:

This class is not intended for sub-classing and used to standardise existing varieties of implementations.

If the class methods leave, the output type parameter value is not guaranteed to be valid.

Client should not use old Capture methods present in class CCamera. Class CCameraImageCapture and class CCameraPostImageCaptureControl should be used rather.

Inherits from

CCamera::CCameraPreImageCaptureControl
- CBase

Nested Classes and Structures

Public Member Functions
	~CCameraPreImageCaptureControl()
IMPORT_C void	GetCaptureEventSupportInfoL(TUint &)
IMPORT_C void	GetDirectSavingTypeL(TDirectSavingType &)
IMPORT_C void	GetDirectSnapshotSupportInfoL(TUint &)
IMPORT_C void	GetImageFormatsSupportedL(TUint &, const TSize &)
IMPORT_C void	GetImageMaxMemorySizeL(TUint &)
IMPORT_C void	GetImageMaxMemorySizeSettingSupportInfoL(TBool &)
IMPORT_C void	GetPixelAspectsSupportedL(TUint &, CCamera::TFormat, const TSize &)
IMPORT_C void	GetSupportedDirectSavingTypeL(TDirectSavingType &)
IMPORT_C void	GetSupportedEmbeddedStillCaptureSettingsL(RArray< TUid > &)
IMPORT_C void	GetSupportedProcessingOptionsL(TUint &)
IMPORT_C CCameraPreImageCaptureControl *	NewL(CCamera &, MPreImageCaptureControlObserver &)
IMPORT_C void	PrepareImageCapture(const TPrepareImageParameters &, MCaptureImageObserver &)
IMPORT_C void	SetDirectSavingTypeL(TDirectSavingType)
IMPORT_C void	SetLowerResolutionSequentialImageFilenameL(const TDesC8 &, TInt)
IMPORT_C void	SetSequentialImageFilenameL(const TDesC8 &, TInt)

Private Member Functions
	CCameraPreImageCaptureControl(CCamera &)
void	ConstructL(MPreImageCaptureControlObserver &)
void	DisableSubFramesL()
void	EnableSubFramesL()
void	EndEmbeddedStillCaptureSettingsL()
void	GetColorSpaceL(TColorSpace &)
void	GetFailedEmbeddedStillCaptureSettingsL(RArray< TUid > &)
void	GetMaximumSpotsL(CCamera::CCameraAdvancedSettings::TFocusMode, TInt &)
void	GetPanoDirectionL(TPanoDirection &)
void	GetPanoModeSupportInfoL(TBool &, TInt &)
void	GetSpotsCombinationL(CCamera::CCameraAdvancedSettings::TFocusMode, TUint &)
void	GetStreamedImageSupportInfoL(TBool &)
void	GetStreamedImageSupportedTransformationsL(RArray< TUid > &)
void	GetSubFramesStateL(TBool &)
void	GetSupportedColorSpaceL(TUint &)
void	GetSupportedSpotsCombinationL(CCamera::CCameraAdvancedSettings::TFocusMode, RArray< TUint > &)
void	SetColorSpace(TColorSpace)
void	SetPanoDirection(TPanoDirection)
void	SetSpotsCombination(CCamera::CCameraAdvancedSettings::TFocusMode, TUint)
void	StartEmbeddedStillCaptureSettingsL()
void	StartPanoMode(TStitchingOption)
void	StartPanoMode(TStitchingOption, const RArray< TInt > &)
void	StopPanoModeL(TStitchedImageRetrieval)

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	TDirectSavingType { EDirectSavingNotUsed = 0x00, EDirectSavingHighResolutionFileOnly = 0x01, EDirectSavingWithLowerResolutionFile = 0x02 }
enum	TDirectSnapshotType { EDirectSnapshotNotSupported = 0x00, EDirectSnapshotSupported = 0x01 }
enum	TEcamProcessingOptions { EEcamProcessingNone = 0x00000000, EEcamNormalProcessing = 0x00000001, EEcamBackgroundProcessing = 0x00000002 }

Private Member Enumerations
enum	TColorSpace { EColorSpaceUnknown = 0x0000, EColorSpacesRGB = 0x0001, EColorSpaceAdobeRGB = 0x0002, EColorSpaceAdobeWideGamutRGB = 0x0004, EColorSpaceCMYK = 0x0008, EColorSpaceYIQ = 0x0010, EColorSpaceYUV = 0x0020, EColorSpaceYDbDr = 0x0040, EColorSpaceYCbCr = 0x0080, EColorSpaceHSB = 0x0100, EColorSpaceHSL = 0x0200 }
enum	TPanoDirection { EPanoRight, EPanoLeft, EPanoUp, EPanoDown }
enum	TStitchedImageRetrieval { EStitchedImageRetrieve, EStitchedImageDiscard }
enum	TStitchingOption { EStitchingOptionNone = 0x00, EStitchingOptionEnable = 0x01, EStitchingOptionDisable = 0x02 }

Private Attributes
MCameraPreImageCaptureControl *	iImpl
CCamera &	iOwner

Constructor & Destructor Documentation

CCameraPreImageCaptureControl(CCamera &)

CCameraPreImageCaptureControl

(

CCamera &

aOwner

)

[private]

Parameters

CCamera & aOwner

~CCameraPreImageCaptureControl()

IMPORT_C

~CCameraPreImageCaptureControl

(

)

Member Functions Documentation

ConstructL(MPreImageCaptureControlObserver &)

void

ConstructL

(

MPreImageCaptureControlObserver &

aPreImageCaptureControlObserver

)

[private]

Parameters

MPreImageCaptureControlObserver & aPreImageCaptureControlObserver

DisableSubFramesL()

void

DisableSubFramesL

(

)

[private]

EnableSubFramesL()

void

EnableSubFramesL

(

)

[private]

EndEmbeddedStillCaptureSettingsL()

void

EndEmbeddedStillCaptureSettingsL

(

)

[private]

GetCaptureEventSupportInfoL(TUint &)

IMPORT_C void

GetCaptureEventSupportInfoL

(

TUint &

aSupportedDriveModes

)

const

Parameters

TUint & aSupportedDriveModes

GetColorSpaceL(TColorSpace &)

void

GetColorSpaceL

(

TColorSpace &

aColorSpace

)

const [private]

Parameters

TColorSpace & aColorSpace

GetDirectSavingTypeL(TDirectSavingType &)

IMPORT_C void

GetDirectSavingTypeL

(

TDirectSavingType &

aDirectSavingType

)

const

Parameters

TDirectSavingType & aDirectSavingType

GetDirectSnapshotSupportInfoL(TUint &)

IMPORT_C void

GetDirectSnapshotSupportInfoL

(

TUint &

aIsDirectSnapshotSupported

)

const

Parameters

TUint & aIsDirectSnapshotSupported

GetFailedEmbeddedStillCaptureSettingsL(RArray< TUid > &)

void

GetFailedEmbeddedStillCaptureSettingsL

(

RArray< TUid > &

aFailedEmbeddedStillCaptureSettings

)

const [private]

Parameters

RArray< TUid > & aFailedEmbeddedStillCaptureSettings

GetImageFormatsSupportedL(TUint &, const TSize &)

IMPORT_C void	GetImageFormatsSupportedL	(	TUint &	aImageFormatsSupported,
			const TSize &	aSize
		)	const

Parameters

TUint & aImageFormatsSupported
const TSize & aSize

GetImageMaxMemorySizeL(TUint &)

IMPORT_C void

GetImageMaxMemorySizeL

(

TUint &

aMemorySize

)

const

Parameters

TUint & aMemorySize

GetImageMaxMemorySizeSettingSupportInfoL(TBool &)

IMPORT_C void

GetImageMaxMemorySizeSettingSupportInfoL

(

TBool &

aIsImageMaxMemorySizeSettingSupported

)

const

Parameters

TBool & aIsImageMaxMemorySizeSettingSupported

GetMaximumSpotsL(CCamera::CCameraAdvancedSettings::TFocusMode, TInt &)

void	GetMaximumSpotsL	(	CCamera::CCameraAdvancedSettings::TFocusMode	aFocusMode,
			TInt &	aMaximumSpots
		)	const [private]

Parameters

CCamera::CCameraAdvancedSettings::TFocusMode aFocusMode
TInt & aMaximumSpots

GetPanoDirectionL(TPanoDirection &)

void

GetPanoDirectionL

(

TPanoDirection &

aPanoDirection

)

const [private]

Parameters

TPanoDirection & aPanoDirection

GetPanoModeSupportInfoL(TBool &, TInt &)

void	GetPanoModeSupportInfoL	(	TBool &	aIsPanoModeSupported,
			TInt &	aSupportedStitchingOption
		)	const [private]

Parameters

TBool & aIsPanoModeSupported
TInt & aSupportedStitchingOption

GetPixelAspectsSupportedL(TUint &, CCamera::TFormat, const TSize &)

IMPORT_C void	GetPixelAspectsSupportedL	(	TUint &	aPixelAspectsSupported,
			CCamera::TFormat	aImageFormat,
			const TSize &	aSize
		)	const

Parameters

TUint & aPixelAspectsSupported
CCamera::TFormat aImageFormat
const TSize & aSize

GetSpotsCombinationL(CCamera::CCameraAdvancedSettings::TFocusMode, TUint &)

void	GetSpotsCombinationL	(	CCamera::CCameraAdvancedSettings::TFocusMode	aFocusMode,
			TUint &	aSpotsCombination
		)	const [private]

Parameters

CCamera::CCameraAdvancedSettings::TFocusMode aFocusMode
TUint & aSpotsCombination

GetStreamedImageSupportInfoL(TBool &)

void

GetStreamedImageSupportInfoL

(

TBool &

aIsStreamedImageSupported

)

const [private]

Parameters

TBool & aIsStreamedImageSupported

GetStreamedImageSupportedTransformationsL(RArray< TUid > &)

void

GetStreamedImageSupportedTransformationsL

(

RArray< TUid > &

aStreamedImageSupportedTransformations

)

const [private]

Parameters

RArray< TUid > & aStreamedImageSupportedTransformations

GetSubFramesStateL(TBool &)

void

GetSubFramesStateL

(

TBool &

aIsSubFrameEnabled

)

const [private]

Parameters

TBool & aIsSubFrameEnabled

GetSupportedColorSpaceL(TUint &)

void

GetSupportedColorSpaceL

(

TUint &

aSupportedColorSpace

)

const [private]

Parameters

TUint & aSupportedColorSpace

GetSupportedDirectSavingTypeL(TDirectSavingType &)

IMPORT_C void

GetSupportedDirectSavingTypeL

(

TDirectSavingType &

aSupportedDirectSavingType

)

const

Parameters

TDirectSavingType & aSupportedDirectSavingType

GetSupportedEmbeddedStillCaptureSettingsL(RArray< TUid > &)

IMPORT_C void

GetSupportedEmbeddedStillCaptureSettingsL

(

RArray< TUid > &

aSupportedEmbeddedStillCaptureSettings

)

const

Parameters

RArray< TUid > & aSupportedEmbeddedStillCaptureSettings

GetSupportedProcessingOptionsL(TUint &)

IMPORT_C void

GetSupportedProcessingOptionsL

(

TUint &

aECamProcessingOptionsSupported

)

const

Parameters

TUint & aECamProcessingOptionsSupported

GetSupportedSpotsCombinationL(CCamera::CCameraAdvancedSettings::TFocusMode, RArray< TUint > &)

void	GetSupportedSpotsCombinationL	(	CCamera::CCameraAdvancedSettings::TFocusMode	aFocusMode,
			RArray< TUint > &	aPossibleSpotCombinations
		)	const [private]

Parameters

CCamera::CCameraAdvancedSettings::TFocusMode aFocusMode
RArray< TUint > & aPossibleSpotCombinations

NewL(CCamera &, MPreImageCaptureControlObserver &)

IMPORT_C CCameraPreImageCaptureControl *	NewL	(	CCamera &	aCamera,
			MPreImageCaptureControlObserver &	aPreImageCaptureControlObserver
		)	[static]

Parameters

CCamera & aCamera
MPreImageCaptureControlObserver & aPreImageCaptureControlObserver

PrepareImageCapture(const TPrepareImageParameters &, MCaptureImageObserver &)

IMPORT_C void	PrepareImageCapture	(	const TPrepareImageParameters &	aPrepareImageParameters,
			MCaptureImageObserver &	aCaptureImageObserver
		)

Parameters

const TPrepareImageParameters & aPrepareImageParameters
MCaptureImageObserver & aCaptureImageObserver

SetColorSpace(TColorSpace)

void

SetColorSpace

(

TColorSpace

aColorSpace

)

[private]

Parameters

TColorSpace aColorSpace

SetDirectSavingTypeL(TDirectSavingType)

IMPORT_C void

SetDirectSavingTypeL

(

TDirectSavingType

aDirectSavingType

)

Parameters

TDirectSavingType aDirectSavingType

SetLowerResolutionSequentialImageFilenameL(const TDesC8 &, TInt)

IMPORT_C void	SetLowerResolutionSequentialImageFilenameL	(	const TDesC8 &	aLowerResolutionFilename,
			TInt	aStartingSequenceNumber
		)

Parameters

const TDesC8 & aLowerResolutionFilename
TInt aStartingSequenceNumber

SetPanoDirection(TPanoDirection)

void

SetPanoDirection

(

TPanoDirection

aPanoDirection

)

[private]

Parameters

TPanoDirection aPanoDirection

SetSequentialImageFilenameL(const TDesC8 &, TInt)

IMPORT_C void	SetSequentialImageFilenameL	(	const TDesC8 &	aFilename,
			TInt	aStartingSequenceNumber
		)

Parameters

const TDesC8 & aFilename
TInt aStartingSequenceNumber

SetSpotsCombination(CCamera::CCameraAdvancedSettings::TFocusMode, TUint)

void	SetSpotsCombination	(	CCamera::CCameraAdvancedSettings::TFocusMode	aFocusMode,
			TUint	aSpotsCombination
		)	[private]

Parameters

CCamera::CCameraAdvancedSettings::TFocusMode aFocusMode
TUint aSpotsCombination

StartEmbeddedStillCaptureSettingsL()

void

StartEmbeddedStillCaptureSettingsL

(

)

[private]

StartPanoMode(TStitchingOption)

void

StartPanoMode

(

TStitchingOption

aStitchingOption

)

[private]

Parameters

TStitchingOption aStitchingOption

StartPanoMode(TStitchingOption, const RArray< TInt > &)

void	StartPanoMode	(	TStitchingOption	aStitchingOption,
			const RArray< TInt > &	aVFHandle
		)	[private]

Parameters

TStitchingOption aStitchingOption
const RArray< TInt > & aVFHandle

StopPanoModeL(TStitchedImageRetrieval)

void

StopPanoModeL

(

TStitchedImageRetrieval

aStitchedImageRetrieval

)

[private]

Parameters

TStitchedImageRetrieval aStitchedImageRetrieval

Member Enumerations Documentation

Enum TColorSpace

Different types of color space. Camera will print or capture images in given color space. The enumeration list may be extended in future.

Enumerators

EColorSpaceUnknown = 0x0000	not known
EColorSpacesRGB = 0x0001	sRGB color space
EColorSpaceAdobeRGB = 0x0002	adobeRGB color space
EColorSpaceAdobeWideGamutRGB = 0x0004	adobeWideGamutRGB color space
EColorSpaceCMYK = 0x0008	CMY(K) color space
EColorSpaceYIQ = 0x0010	YIQ color space
EColorSpaceYUV = 0x0020	YUV color space
EColorSpaceYDbDr = 0x0040	YDbDr color space
EColorSpaceYCbCr = 0x0080	YCbCr color space
EColorSpaceHSB = 0x0100	HSB color space
EColorSpaceHSL = 0x0200	HSL color space

Enum TDirectSavingType

Specifies the type of direct saving. The enumeration list may be extended in future.

Enumerators

EDirectSavingNotUsed = 0x00	Image saved in buffers. Direct saving to file not being used. Callback used is MCaptureImageObserver::ImageBufferReady.
EDirectSavingHighResolutionFileOnly = 0x01	Image saved to file as per the format specified. Image saved after any processing options have completed. Callback used is MCaptureImageObserver::ImageDirectSavingCompleted().
EDirectSavingWithLowerResolutionFile = 0x02	Image saved to file as per the format specified. Also, a lower resolution image gets saved in a separately specified file. This helps in retrieving the lower resolution image sooner than the higher resolution image gets saved. Callback used for lower resolution image saving is MCaptureImageObserver:: CutDownImageDirectSavingCompleted().

Enum TDirectSnapshotType

Specifies the various type of direct snapshot support. The enumeration list may be extended in future.

Enumerators

EDirectSnapshotNotSupported = 0x00	Direct snapshot not supported.
EDirectSnapshotSupported = 0x01	Direct Snapshot supported. It will be displayed on the same direct viewfinder screen, out of which it has been created

Enum TEcamProcessingOptions

Specifies the available processing options. The enumeration list may be extended in future.

Enumerators

EEcamProcessingNone = 0x00000000	Processing options are not supported.
EEcamNormalProcessing = 0x00000001	Enable normal processing when image capture is initiated.
EEcamBackgroundProcessing = 0x00000002	Enable background processing when image capture is initiated.

Enum TPanoDirection

Specifies direction of panning. The enumeration list may be extended in future.

Enumerators

EPanoRight	Viewfinder displays towards the right of already captured images
EPanoLeft	Viewfinder displays towards the left of already captured images
EPanoUp	Viewfinder displays towards the top of already captured images
EPanoDown	Viewfinder displays towards the bottom of already captured images

Enum TStitchedImageRetrieval

Specifies whether the panned images captured under 'stitching enabled option' would be discarded by the implementation. The enumeration list may be extended in future.

Enumerators

EStitchedImageRetrieve	allow ecam implementation to provide the stitched images.
EStitchedImageDiscard	instruct ECAM Implementation to discard the stitched images.

Enum TStitchingOption

Specifies the stitching options when panning is started. The enumeration list may be extended in future.

Enumerators

EStitchingOptionNone = 0x00	Stitching of panned images is not supported by the ECAM Implementation.
EStitchingOptionEnable = 0x01	Stitching of panned images can be done by the ECAM Implementation.
EStitchingOptionDisable = 0x02	Stitching of panned images can be disabled/discarded by the ECAM Implementation.

Member Data Documentation

MCameraPreImageCaptureControl * iImpl

MCameraPreImageCaptureControl *

iImpl

[private]

CCamera & iOwner

CCamera &

iOwner

[private]