Collapse all Symbian^3 Application Developer Library

MCameraObserver2 Class Reference

class MCameraObserver2

Mixin base class V2 for camera clients.

An application must implement an MCameraObserver2 (or MCameraObserver ) in order to use the camera API. This derived class is called when the camera is ready for use, an image has been captured or a buffer of video data is ready, including when errors occur.

Public Member Functions
void	HandleEvent (const TECAMEvent &)
void	ImageBufferReady ( MCameraBuffer &, TInt )
void	VideoBufferReady ( MCameraBuffer &, TInt )
void	ViewFinderReady ( MCameraBuffer &, TInt )

Member Functions Documentation

HandleEvent(const TECAMEvent &)

void

HandleEvent

(

const TECAMEvent &

aEvent

)

[pure virtual]

A camera event has completed.

Note:

Implementations of MCameraObserver2 should ignore events which are not recognised and should not leave.

Note:

This may internally call TECAMEvent2::IsEventEncapsulationValid(aEvent) and also for any other derived version of TECAMEvent class to know whether correct version of TECAMEvent base class has been used.

Parameters

const TECAMEvent & aEvent

A reference to a TECAMEvent. This can be completion of a call to Reserve() or a call to PowerOn() or a notification that the client has lost control of the camera. The event contains a uid identifying the event and an accompanying error code (KErrNone for the successful completion of a request). The error will be KErrNotReady for a request that was made out of the correct sequence. The error will be KErrAccessDenied for a Reserve() request that failed because a higher priority client already controls the camera.

ImageBufferReady(MCameraBuffer &, TInt)

void	ImageBufferReady	(	MCameraBuffer &	aCameraBuffer,
			TInt	aError
		)	[pure virtual]

Notifies the client of a new captured camera image. Called asynchronously when CCamera::CaptureImage() completes.

Note:

If new image capture classes used, then this callback will not be used. Refer MCaptureImageObserver

Parameters

MCameraBuffer & aCameraBuffer	A reference to an MCameraBuffer if successful, or NULL if not successful.
TInt aError	KErrNone if successful, or an error code if not successful.

VideoBufferReady(MCameraBuffer &, TInt)

void	VideoBufferReady	(	MCameraBuffer &	aCameraBuffer,
			TInt	aError
		)	[pure virtual]

Notifies the client of new captured video. Called asynchronously and periodically after CCamera::StartVideoCapture() is called. The buffer has been filled with the required number of video frames specified PrepareVideoCaptureL().

Parameters

MCameraBuffer & aCameraBuffer	A reference to an MCameraBuffer if successful, or NULL if not successful.
TInt aError	KErrNone if successful, or an error code if not successful.

ViewFinderReady(MCameraBuffer &, TInt)

void	ViewFinderReady	(	MCameraBuffer &	aCameraBuffer,
			TInt	aError
		)	[pure virtual]

Notifies client of new view finder data. Called periodically in response to the use of CCamera::StartViewFinderL() .

Parameters

MCameraBuffer & aCameraBuffer	A reference to an MCameraBuffer if successful, or NULL if not successful.
TInt aError	KErrNone if successful, or an error code if not successful.