Collapse all Symbian^3 Application Developer Library

MClientViewFinderObserver Class Reference

class MClientViewFinderObserver

A mixin class to be implemented by the client in order to use the client view finder API CCameraClientViewFinder. The derived class methods are called by the implementation when the client view finder operations are ready to be notified accordingly. Implementation shall keep track of CCameraClientViewFinder object deletion. It has to ensure that a callback is not send should the client destroy the particular CCameraClientViewFinder class object when the callback is queued to be send across. Ownership of CCameraClientViewFinder is retained by the client.

CCamera::CCameraClientViewFinder

Public Member Functions
void	ClientHistogramReady ( CCamera::CCameraClientViewFinder &, MHistogramV2Buffer *, TInt )
TInt	CustomInterface ( TUid , TAny *&)
void	DirectHistogramDisplayed ( CCamera::CCameraClientViewFinder &, CCamera::CCameraV2Histogram &, TInt )
void	ImageProcessingFailed ( CCamera::CCameraClientViewFinder &, TInt )
void	ViewFinderBufferReady ( CCamera::CCameraClientViewFinder &, TInt )

Member Functions Documentation

ClientHistogramReady(CCamera::CCameraClientViewFinder &, MHistogramV2Buffer *, TInt)

void	ClientHistogramReady	(	CCamera::CCameraClientViewFinder &	aClientViewFinderHandle,
			MHistogramV2Buffer *	aClientHistogramBuffer,
			TInt	aErrorCode
		)	[pure virtual]

Implementation sends this callback in order to notify the client about availability of the histogram data. If a call to CCameraV2Histogram::StartHistogram() is made without a previous successful call to CCameraV2Histogram:: PrepareClientHistogramL() then the callback returns KErrBadHandle.

Note:

Client shall use the currently available histogram for the viewfinder frames until a new histogram is available.

Parameters

CCamera::CCameraClientViewFinder & aClientViewFinderHandle	Reference to CCameraClientViewFinder class object which refers a particular client viewfinder for which the client histogram data have been generated.
MHistogramV2Buffer * aClientHistogramBuffer	Pointer to MHistogramV2Buffer which retrieves a single histogram alongwith relevant information about it. The ownership will be retained by the implementation. Client needs to call Release in order to indicate the implementation that the buffer can be re-used. Client shall never try to delete the pointer. NULL, if error.
TInt aErrorCode	Appropriate error code.

CustomInterface(TUid, TAny *&)

TInt	CustomInterface	(	TUid	aInterface,
			TAny *&	aPtrInterface
		)	[pure virtual]

Gets a custom interface for future callbacks. This method will be called by the implementation to get a new interface which would support future callbacks.

Parameters

TUid aInterface	The Uid of the particular interface function required for callbacks.
TAny *& aPtrInterface	The implementation has to type-cast the retrieved custom interface pointer to the appropriate type.

DirectHistogramDisplayed(CCamera::CCameraClientViewFinder &, CCamera::CCameraV2Histogram &, TInt)

void	DirectHistogramDisplayed	(	CCamera::CCameraClientViewFinder &	aClientViewFinderHandle,
			CCamera::CCameraV2Histogram &	aDirectHistogramDisplayed,
			TInt	aErrorCode
		)	[pure virtual]

Implementation sends this callback in order to notify the client when the direct histogram data gets displayed on the screen for the first time after starting a particular client viewfinder. If a call to CCameraV2Histogram:: StartHistogram() is made without a previous successful call to CCameraV2Histogram::PrepareDirectHistogramL() then the callback returns KErrBadHandle.

Parameters

CCamera::CCameraClientViewFinder & aClientViewFinderHandle	Reference to CCameraClientViewFinder class object which refers a particular client viewfinder.
CCamera::CCameraV2Histogram & aDirectHistogramDisplayed	Reference to CCameraV2Histogram class object which refers a particular type of histogram being displayed.
TInt aErrorCode	Appropriate error code.

ImageProcessingFailed(CCamera::CCameraClientViewFinder &, TInt)

void	ImageProcessingFailed	(	CCamera::CCameraClientViewFinder &	aClientViewFinderHandle,
			TInt	aErrorCode
		)	[pure virtual]

Implementation sends this callback in order to notify the client about failure of image processing for the client viewfinder frames.

Parameters

CCamera::CCameraClientViewFinder & aClientViewFinderHandle	Reference to CCameraClientViewFinder class object which refers a particular client viewfinder.
TInt aErrorCode	The reason of failure of the image processing.

ViewFinderBufferReady(CCamera::CCameraClientViewFinder &, TInt)

void	ViewFinderBufferReady	(	CCamera::CCameraClientViewFinder &	aClientViewFinderHandle,
			TInt	aErrorCode
		)	[pure virtual]

Implementation sends this callback in order to notify the client about the availability of viewfinder frames. Viewfinder frames can be retrieved by the client using the CCameraClientViewFinder::GetViewFinderBufferL ( MCameraBuffer2 & aClientViewFinderBuffer).

Parameters

CCamera::CCameraClientViewFinder & aClientViewFinderHandle
TInt aErrorCode	Appropriate error code.