MCameraV2DirectViewFinder Class Reference

class MCameraV2DirectViewFinder

Mixin class for implementation of CCameraV2DirectViewFinder methods.

Member Functions Documentation

CreateHistogramImplFactoryL(MImplementationFactory *&)

voidCreateHistogramImplFactoryL(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 *& aImplFactoryPtrThe concrete factory handle for the histogram implementation specific to the given view finder.

GetDirectSnapshotImpl(TUid)

TAny *GetDirectSnapshotImpl(TUidaInterface)const [pure virtual]

Provides the interface pointers for the concrete implementation of CCameraDirectSnapshot.

Parameters

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

GetDirectViewFinderPropertiesL(TInt &, TRect &, TRect &)

voidGetDirectViewFinderPropertiesL(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 & aScreenNumberRetrieves the screen number on which the direct viewfinder is supposed to run.
TRect & aScreenRectRetrieves the TRect which identifies the portion of the screen to which view finder data is to be transferred.
TRect & aClipRectRetrieves the TRect which identifies the rectangle to which the screen will be clipped.

GetImageProcessingImplFactoryL(MImplementationFactory *&)

voidGetImageProcessingImplFactoryL(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 *& aImplFactoryPtrThe concrete factory handle for the image processing implementation specific to the given view finder.

GetViewFinderStateL(CCamera::CCameraV2DirectViewFinder::TViewFinderState &)

voidGetViewFinderStateL(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 & aViewFinderStateRetrieves the state of the direct viewfinder.

PauseViewFinderDirect()

voidPauseViewFinderDirect()[pure virtual]

Pauses the direct viewfinder.

Release(CCamera::CCameraV2DirectViewFinder *)

voidRelease(CCamera::CCameraV2DirectViewFinder *aDirectViewFinderHandle)[pure virtual]

Releases the interface.

Parameters

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

ResumeViewFinderDirect()

voidResumeViewFinderDirect()[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 *)

voidSetDirectViewFinderHandle(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 * aDirectViewFinderHandleThe pointer to the direct view finder class object.

SetDirectViewFinderObserver(MDirectViewFinderObserver &)

voidSetDirectViewFinderObserver(MDirectViewFinderObserver &aDirectViewFinderObserver)[pure virtual]

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

Parameters

MDirectViewFinderObserver & aDirectViewFinderObserverThe reference to the direct view finder observer.

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

voidStartViewFinderDirectL(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 & aWsWindow server session.
CWsScreenDevice & aScreenDeviceScreen device.
RWindowBase & aWindowDisplayable window.
TRect & aScreenRectPortion 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 &)

voidStartViewFinderDirectL(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 & aWsWindow server session.
CWsScreenDevice & aScreenDeviceScreen device.
RWindowBase & aWindowDisplayable window.
TRect & aScreenRectPortion 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 & aClipRectThe rectangle to which the screen will be clipped.

StopDirectViewFinder()

voidStopDirectViewFinder()[pure virtual]

Stops the direct viewfinder.