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
Member Functions Documentation
ClientHistogramReady(CCamera::CCameraClientViewFinder &, MHistogramV2Buffer *, TInt)
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)
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)
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)
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).
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.