Symbian^3 Application Developer Library >

MCameraObserver Class Reference

class MCameraObserver

Mixin base class for camera clients.

An application must implement an MCameraObserver or MCameraObserver2 (recommended) 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.

Implementations of the camera API should use MCameraObserver::FrameBufferReady() and MFrameBuffer::Release() to co-ordinate the mapping of any special memory objects.

Public Member Functions
void FrameBufferReady ( MFrameBuffer *, TInt )
void ImageReady (CFbsBitmap *, HBufC8 *, TInt )
void PowerOnComplete ( TInt )
void ReserveComplete ( TInt )
void ViewFinderFrameReady (CFbsBitmap &)

Member Functions Documentation

FrameBufferReady(MFrameBuffer *, TInt)

void FrameBufferReady ( MFrameBuffer * aFrameBuffer,
TInt aError
) [pure virtual]

Passes a filled frame buffer to the client.

Called asynchronously, when a buffer has been filled with the required number of video frames by CCamera::StartVideoCapture() .

Parameters

MFrameBuffer * aFrameBuffer On return, a pointer to an MFrameBuffer if successful, or NULL if not successful.
TInt aError KErrNone if successful, or an error code if not successful.

ImageReady(CFbsBitmap *, HBufC8 *, TInt)

void ImageReady ( CFbsBitmap * aBitmap,
HBufC8 * aData,
TInt aError
) [pure virtual]

Transfers the current image from the camera to the client.

Called asynchronously when CCamera::CaptureImage() completes.

Parameters

CFbsBitmap * aBitmap On return, a pointer to an image held in CFbsBitmap form if this was the format specified in CCamera::PrepareImageCaptureL().
HBufC8 * aData On return, a pointer to an HBufC8 if this was the format specified in CCamera::PrepareImageCaptureL(). NULL if there was an error.
TInt aError KErrNone on success or an error code on failure.

PowerOnComplete(TInt)

void PowerOnComplete ( TInt aError ) [pure virtual]

Indicates camera power on is complete.

Called on completion of CCamera :PowerOn().

Parameters

TInt aError KErrNone on success, KErrInUse if the camera is in use by another client or KErrNoMemory if insufficient system memory is available.

ReserveComplete(TInt)

void ReserveComplete ( TInt aError ) [pure virtual]

Camera reservation is complete.

Called asynchronously when CCamera::Reserve() completes.

Parameters

TInt aError An error on failure and KErrNone on success.

ViewFinderFrameReady(CFbsBitmap &)

void ViewFinderFrameReady ( CFbsBitmap & aFrame ) [pure virtual]

Tests whether transfer of view finder data has completed.

Called periodically in response to the use of CCamera::StartViewFinderBitmapsL() .

Parameters

CFbsBitmap & aFrame The view finder frame.

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.