Collapse all Symbian^3 Product Developer Library

MCameraContinuousZoom Class Reference

class MCameraContinuousZoom

Mixin class for implementation of extra methods of the Continuous Zoom API.

Public Member Functions
void	GetContinuousZoomId(TInt &)
void	GetContinuousZoomSupportInfoL(CCamera::CCameraAdvancedSettings::TContinuousZoomSupportInfo &)
void	Release()
void	SetContinuousZoomObserverAndHandle(MContinuousZoomObserver &, CCamera::CCameraContinuousZoom *)
void	StartContinuousZoomL(CCamera::CCameraAdvancedSettings::TContinuousZoomParameters)
void	StopContinuousZoom()

Member Functions Documentation

GetContinuousZoomId(TInt &)

void

GetContinuousZoomId

(

TInt &

aZoomId

)

const [pure virtual]

Retrieves the unique id of the continuous zoom object. This is used to identify the continuous zoom handle returned to clients via the MContinuousZoomObserver callback.

Parameters

TInt & aZoomId

The unique id of this Continuous Zoom object.

GetContinuousZoomSupportInfoL(CCamera::CCameraAdvancedSettings::TContinuousZoomSupportInfo &)

void

GetContinuousZoomSupportInfoL

(

CCamera::CCameraAdvancedSettings::TContinuousZoomSupportInfo &

aContinuousZoomInfo

)

const [pure virtual]

Retrieves information about the supported settings related to continuous zoom support.

leave: May leave with any error code.

Parameters

CCamera::CCameraAdvancedSettings::TContinuousZoomSupportInfo & aContinuousZoomInfo

The information of supported continuous zoom functionality.

Release()

void

Release

(

)

[pure virtual]

Releases the interface.

SetContinuousZoomObserverAndHandle(MContinuousZoomObserver &, CCamera::CCameraContinuousZoom *)

void	SetContinuousZoomObserverAndHandle	(	MContinuousZoomObserver &	aObserver,
			CCamera::CCameraContinuousZoom *	aContinuousZoomHandle
		)	[pure virtual]

Passes both the continuous zoom observer and pointer to the continuous zoom class to the implementation so callbacks can be sent to the client along with the continuous zoom handle.

MContinuousZoomObserver

Parameters

MContinuousZoomObserver & aObserver	The reference to the continuous zoom observer.
CCamera::CCameraContinuousZoom * aContinuousZoomHandle	The pointer to the continuous zoom class object.

StartContinuousZoomL(CCamera::CCameraAdvancedSettings::TContinuousZoomParameters)

void

StartContinuousZoomL

(

CCamera::CCameraAdvancedSettings::TContinuousZoomParameters

aContinuousZoomParameters

)

[pure virtual]

Starts the continuous zoom operation. Clients will receive MContinuousZoomObserver::ContinuousZoomProgress() callback for intermediate zoom factors achieved. It is up to the implementation to choose the zoom factors for which it will issue this callback. Implementation will not use this callback to notify reaching the target zoom factor. This will be done via MContinuousZoomObserver::ContinuousZoomComplete() callback.

Note:

If the implementation does not support re-configuring of zoom parameters whilst an existing continuous zoom operation is active then StartContinuousZoomL() will leave with KErrInUse.

If client has selected EDirectionTele zoom direction and the current zoom factor is greater than the target zoom factor, StartContinuousZoomL() will leave with KErrArgument. Similarly, StartContinuousZoomL() will also leave with KErrArgument if client has selected EDirectionWide zoom direction and current zoom factor is less than target zoom factor.

leave: May leave with any error code.

Parameters

CCamera::CCameraAdvancedSettings::TContinuousZoomParameters aContinuousZoomParameters

The desired parameters to be used for the continuous zoom operation.

StopContinuousZoom()

void

StopContinuousZoom

(

)

[pure virtual]

Stop any exisiting continuous zoom operation. Since this method is synchronous, no callback shall be issued for the concerned continuous zoom operation.