Symbian^3 Application Developer Library >

MCameraV2DirectViewFinder Class Reference

class MCameraV2DirectViewFinder

Mixin class for implementation of CCameraV2DirectViewFinder methods.

Public Member Functions
void CreateHistogramImplFactoryL ( MImplementationFactory *&)
TAny * GetDirectSnapshotImpl ( TUid )
void GetDirectViewFinderPropertiesL ( TInt &, TRect &, TRect &)
void GetImageProcessingImplFactoryL ( MImplementationFactory *&)
void GetViewFinderStateL ( CCamera::CCameraV2DirectViewFinder::TViewFinderState &)
void PauseViewFinderDirect ()
void Release ( CCamera::CCameraV2DirectViewFinder *)
void ResumeViewFinderDirect ()
void SetDirectViewFinderHandle ( CCamera::CCameraV2DirectViewFinder *)
void SetDirectViewFinderObserver ( MDirectViewFinderObserver &)
void StartViewFinderDirectL (RWsSession &, CWsScreenDevice &, RWindowBase &, TRect &)
void StartViewFinderDirectL (RWsSession &, CWsScreenDevice &, RWindowBase &, TRect &, TRect &)
void StopDirectViewFinder ()

Member Functions Documentation

CreateHistogramImplFactoryL(MImplementationFactory *&)

void CreateHistogramImplFactoryL ( MImplementationFactory *& aImplFactoryPtr ) const [pure virtual]

Retrieves the concrete factory handle for the histogram implementation in order to use it specifically for a particular viewfinder.

leave
May leave with any error code.

Parameters

MImplementationFactory *& aImplFactoryPtr The concrete factory handle for the histogram implementation specific to the given view finder.

GetDirectSnapshotImpl(TUid)

TAny * GetDirectSnapshotImpl ( TUid aInterface ) const [pure virtual]

Provides the interface pointers for the concrete implementation of CCameraDirectSnapshot.

Parameters

TUid aInterface Interface uid for a particular M-class of direct snapshot.

GetDirectViewFinderPropertiesL(TInt &, TRect &, TRect &)

void GetDirectViewFinderPropertiesL ( TInt & aScreenNumber,
TRect & aScreenRect,
TRect & aClipRect
) const [pure virtual]

Retrieves the parameters associated with the direct viewfinder.

leave
May leave with any error code.

Parameters

TInt & aScreenNumber Retrieves the screen number on which the direct viewfinder is supposed to run.
TRect & aScreenRect Retrieves the TRect which identifies the portion of the screen to which view finder data is to be transferred.
TRect & aClipRect Retrieves the TRect which identifies the rectangle to which the screen will be clipped.

GetImageProcessingImplFactoryL(MImplementationFactory *&)

void GetImageProcessingImplFactoryL ( MImplementationFactory *& aImplFactoryPtr ) const [pure virtual]

Retrieves the concrete factory handle for the image processing implementation in order to use it specifically for a particular viewfinder.

leave
May leave with any error code.

Parameters

MImplementationFactory *& aImplFactoryPtr The concrete factory handle for the image processing implementation specific to the given view finder.

GetViewFinderStateL(CCamera::CCameraV2DirectViewFinder::TViewFinderState &)

void GetViewFinderStateL ( CCamera::CCameraV2DirectViewFinder::TViewFinderState & aViewFinderState ) const [pure virtual]

Retrieves the state of the direct viewfinder.

leave
May leave with any error code.

Parameters

CCamera::CCameraV2DirectViewFinder::TViewFinderState & aViewFinderState Retrieves the state of the direct viewfinder.

PauseViewFinderDirect()

void PauseViewFinderDirect ( ) [pure virtual]

Pauses the direct viewfinder.

Release(CCamera::CCameraV2DirectViewFinder *)

void Release ( CCamera::CCameraV2DirectViewFinder * aDirectViewFinderHandle ) [pure virtual]

Releases the interface.

Parameters

CCamera::CCameraV2DirectViewFinder * aDirectViewFinderHandle The pointer to the direct viewfinder class object which would be destroyed by the client.

ResumeViewFinderDirect()

void ResumeViewFinderDirect ( ) [pure virtual]

Resumes the direct viewfinder

Note:

MDirectViewFinderObserver::DirectViewFinderFirstFrameDisplayed() will be used to notify clients that the first frame has been displayed.

SetDirectViewFinderHandle(CCamera::CCameraV2DirectViewFinder *)

void SetDirectViewFinderHandle ( CCamera::CCameraV2DirectViewFinder * aDirectViewFinderHandle ) [pure virtual]

The pointer to the client view finder class used to pass back to the client via observer callbacks. Implementation is not supposed to destroy this object.

MDirectViewFinderObserver

Parameters

CCamera::CCameraV2DirectViewFinder * aDirectViewFinderHandle The pointer to the direct view finder class object.

SetDirectViewFinderObserver(MDirectViewFinderObserver &)

void SetDirectViewFinderObserver ( MDirectViewFinderObserver & aDirectViewFinderObserver ) [pure virtual]

The observer for the direct view finder is passed to the implementation for passing callbacks on it.

Parameters

MDirectViewFinderObserver & aDirectViewFinderObserver The reference to the direct view finder observer.

StartViewFinderDirectL(RWsSession &, CWsScreenDevice &, RWindowBase &, TRect &)

void StartViewFinderDirectL ( RWsSession & aWs,
CWsScreenDevice & aScreenDevice,
RWindowBase & aWindow,
TRect & aScreenRect
) [pure virtual]

Creates a new viewfinder and starts transfer of view finder data to the given portion of the screen using direct screen access.

The aScreenRect parameter is in screen coordinates and may be modified if, for example, the camera requires the destination to have a certain byte alignment, and so on.

leave
KErrInUse if another direct viewfinder is running with the same set of window parameters. May leave with any other error code.
Note:

MDirectViewFinderObserver::DirectViewFinderFirstFrameDisplayed() will be used to notify clients that the first frame has been displayed.

Parameters

RWsSession & aWs Window server session.
CWsScreenDevice & aScreenDevice Screen device.
RWindowBase & aWindow Displayable window.
TRect & aScreenRect Portion of the screen to which view finder data is to be transferred. This is in screen co-ordinates and may be modified if, for example, the camera requires the destination to have a certain byte alignment.

StartViewFinderDirectL(RWsSession &, CWsScreenDevice &, RWindowBase &, TRect &, TRect &)

void StartViewFinderDirectL ( RWsSession & aWs,
CWsScreenDevice & aScreenDevice,
RWindowBase & aWindow,
TRect & aScreenRect,
TRect & aClipRect
) [pure virtual]

Creates a new viewfinder and starts transfer of view finder data to the given portion of the screen using direct screen access and also clips to the specified portion of the screen.

The view finder has the same size and position as aScreenRect but is only visible in the intersection of aScreenRect and aClipRect. May leave with KErrNotSupported or KErrNotReady if Reserve() has not been called, or has not yet completed.

leave
KErrInUse if another direct viewfinder is running with the same set of window parameters. May leave with any other error code.
Note:

MDirectViewFinderObserver::DirectViewFinderFirstFrameDisplayed() will be used to notify clients that the first frame has been displayed.

Parameters

RWsSession & aWs Window server session.
CWsScreenDevice & aScreenDevice Screen device.
RWindowBase & aWindow Displayable window.
TRect & aScreenRect Portion of the screen to which view finder data is to be transferred. This is in screen coordinates and may be modified if, for example, the camera requires the destination to have a certain byte alignment.
TRect & aClipRect The rectangle to which the screen will be clipped.

StopDirectViewFinder()

void StopDirectViewFinder ( ) [pure virtual]

Stops the direct viewfinder.

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.