![[Index]](../../../../a_stock/images/btn_index.gif)
![[Previous]](../../../../a_stock/images/btn_prev_top.gif)
![[Next]](../../../../a_stock/images/btn_next_top.gif)
|
|
|
|
|
|
||
class CCamera : public CBase;
Base class for camera devices.
Provides the interface that an application uses to control, and acquire images from, the camera.
An application must supply an implementation of MCameraObserver2 (or MCameraObserver).
CBase -
Base class for all classes to be instantiated on the heap.
CCamera - Base class for camera devices.
Defined in CCamera:
Brightness()constGets the currently set brightness adjustment value.BuffersInUse()constGets the number of buffers currently in use.CCameraAdvancedSettings...CCameraDirectViewFinder...CCameraImageProcessingThis class is used to perform image processing operations on the camera. These i...CCameraOverlayThis class provides support for image overlays. The client can use it to overlay...CCameraPresetsThis API is used to simplify user - camera interaction by allowing simultaneous ...CameraInfo(TCameraInfo &)constGets information about the camera device.CamerasAvailable()Determines the number of cameras on the device.CancelCaptureImage()Cancels the asynchronous still image capture.CaptureImage()Asynchronously performs still image capture.Contrast()constGets the currently set contrast value.CustomInterface(TUid)Gets a custom interface. The client has to cast the returned pointer to the appr...DigitalZoomFactor()constGets the currently set digital zoom factor.EBrightnessAutoSets the brightness automatically. EContrastAutoSets the contrast automatically. EExposureAperturePriorityAperture setting is given priority. EExposureAutoSet exposure automatically. Default, always supported. EExposureBacklightBacklight setting for bright backgrounds. EExposureBeachBeach setting for daylight exposure with reflective glare. EExposureCenterCentered mode for ignoring surroundings. EExposureInfraExposure for infra-red sensor on the camera EExposureManual
User selectable exposure value setting. EExposureNightNight-time setting for long exposures. EExposureProgramProgrammed exposure setting. EExposureShutterPriorityShutter speed setting is given priority. EExposureSnowSnow setting for daylight exposure. EExposureSportSport setting for very short exposures. EExposureSuperNightExposure night setting with colour removed to get rid of colour noise. EExposureVeryLongGeneralised setting for very long exposures. EFlashAutoFlash will automatically fire when required. EFlashFillInReduced flash for general lighting EFlashForcedFlash will always fire. EFlashManual
User configurable setting EFlashNoneNo flash, always supported. EFlashRedEyeReduceRed-eye reduction mode. EFlashSlowFrontSyncFlash at the moment when shutter opens. EFlashSlowRearSyncFlash at the moment when shutter closes. EFlashVideoLightConstant emission of light during video mode EFormat16BitRGB565Packed RGB triplets, 5 bits per pixel for red and blue and 6 bits for green, wit...EFormat16bitRGB444Packed RGB triplets, 4 bits per pixel with red in the least significant bits and...EFormat32BitRGB888Packed RGB triplets, 8 bits per pixel with red in the least significant bits and...EFormatExifEXIF JPEG EFormatFbsBitmapColor16MCFbsBitmap object with display mode EColor16M. EFormatFbsBitmapColor16MUCFbsBitmap object with display mode EColor16MU. EFormatFbsBitmapColor4KCFbsBitmap object with display mode EColor4K. EFormatFbsBitmapColor64KCFbsBitmap object with display mode EColor64K. EFormatJpegJFIF JPEG. EFormatMonochrome8 bit greyscale values, 0=black, 255=white. EFormatUserDefinedImplementation dependent. EFormatYUV420Interleaved4:2:0 format, 8 bits per sample, Y00Y01Y10Y11UV. EFormatYUV420Planar4:2:0 format, 8 bits per sample, Y00Y01Y02Y03...U0...V0... EFormatYUV420SemiPlanar4:2:0 format, 8 bits per sample, Y00Y01Y02Y03...U0V0... EFormatYUV4224:2:2 format, 8 bits per sample, UY0VY1. EFormatYUV422Reversed4:2:2 format, 8 bits per sample, Y1VY0U. EFormatYUV4444:4:4 format, 8 bits per sample, Y00U00V00 Y01U01V01... EWBAutoSet white balance automatically. Default, always supported. EWBAutoSkinauto skinEWBBeachHigh contrast daylight primarily near the sea EWBCloudyOvercast daylight. EWBDaylightNormal daylight. EWBDaylightUnderWaterDaylight Under WaterEWBFlashFlash lighting. EWBFluorescentFluorescent tube lighting EWBHorizonhorizonEWBManual
User configurable mode EWBShadeShade EWBSnowHigh contrast daylight primarily snowy EWBTungstenTungsten filament lighting. EnumerateCaptureSizes(TSize &,TInt,TFormat)constEnumerates through the available image capture sizes, based on the specified siz...EnumerateVideoFrameRates(TReal32 &,TInt,TFormat,TInt,TExposure)constEnumerates through the available video frame rates, based on the specified rate ...EnumerateVideoFrameSizes(TSize &,TInt,TFormat)constEnumerates through the available video frame sizes, based on the specified size ...Exposure()constGets the currently set exposure setting value.Flash()constGets the currently set flash mode.FrameRate()constGets the frame rate currently in use.FramesPerBuffer()constGets the number of frames per buffer currently in use.GetFrameSize(TSize &)constGets the frame size currently in use.Handle()Gets the device-unique handle of this camera object.JpegQuality()constGets the currently set jpeg quality value.New2L(MCameraObserver2 &,TInt,TInt)Creates an object representing a camera. Clients prepare themselves to receive u...NewDuplicate2L(MCameraObserver2 &,TInt)Duplicates the original camera object for use by, for example, multimedia system...NewDuplicateL(MCameraObserver &,TInt)Duplicates the original camera object for use by, for example, multimedia system...NewDuplicateL(MCameraObserver2 &,TInt)Duplicates the original camera object for use by, for example, multimedia system...NewL(MCameraObserver &,TInt)Creates an object representing a camera.NewL(MCameraObserver2 &,TInt,TInt)Creates an object representing a camera.PowerOff()Synchronous function for switching off camera power.PowerOn()Asynchronous method to switch on camera power.PrepareImageCaptureL(TFormat,TInt)Performs setup and allocation of memory.PrepareImageCaptureL(TFormat,TInt,const TRect &)Performs setup and allocation of memory and clips the image to the specified rec...PrepareVideoCaptureL(TFormat,TInt,TInt,TInt,TInt)Prepares for video capture.PrepareVideoCaptureL(TFormat,TInt,TInt,TInt,TInt,const TRect &)Prepares for video capture and clips the frames to the given rectangle.Release()De-initialises the camera, allowing it to be used by other clients.Reserve()Asynchronous function that performs any required initialisation and reserves the...SetBrightnessL(TInt)Sets the brightness adjustment of the device.SetContrastL(TInt)Sets the contrast adjustment of the device.SetDigitalZoomFactorL(TInt)Sets the digital zoom factor.SetExposureL(TExposure)Sets the exposure adjustment of the device.SetFlashL(TFlash)Sets the flash mode.SetJpegQuality(TInt)Sets the quality value to use if jpeg is a supported image for video format.SetViewFinderMirrorL(TBool)Sets whether view finder mirroring is on.SetWhiteBalanceL(TWhiteBalance)Sets the white balance adjustment of the device.SetZoomFactorL(TInt)Sets the zoom factor.StartVideoCapture()Starts capturing video.StartViewFinderBitmapsL(TSize &)Starts transfer of view finder data.StartViewFinderBitmapsL(TSize &,TRect &)Starts transfer of view finder data and clips the bitmap to the specified clip r...StartViewFinderDirectL(RWsSession &,CWsScreenDevice &,RWindowBase &,TRect &)Starts transfer of view finder data to the given portion of the screen using dir...StartViewFinderDirectL(RWsSession &,CWsScreenDevice &,RWindowBase &,TRect &,TRect &)Starts transfer of view finder data to the given portion of the screen using dir...StartViewFinderL(TFormat,TSize &)Starts transfer of view finder data.StartViewFinderL(TFormat,TSize &,TRect &)Starts transfer of view finder data and clips the picture to the specified clip ...StopVideoCapture()Stops video capture.StopViewFinder()Stops transfer of view finder data to the screen.TBrightnessSpecifies whether brightness is set automatically. TContrastSpecifies whether contrast is set automatically. TExposureSpecifies the type of exposure. - EExposureAuto is the default value. TFlashSpecifies the type of flash. TFormatPossible still image and video frame formatsTWhiteBalanceSpecifies how the white balance is set. VideoCaptureActive()constTests whether video capture is active.ViewFinderActive()constQueries whether the view finder is active.ViewFinderMirror()constGets whether view finder mirroring is active.WhiteBalance()constGets the currently set white balance adjustment value.ZoomFactor()constGets the currently set zoom factor.Inherited from CBase:
Delete(CBase *)Deletes the specified object.Extension_(TUint,TAny *&,TAny *)Extension function operator new(TUint)Allocates the object from the heap and then initialises its contents to binary z...operator new(TUint,TAny *)Initialises the object to binary zeroes.operator new(TUint,TLeave)Allocates the object from the heap and then initialises its contents to binary z...operator new(TUint,TLeave,TUint)Allocates the object from the heap and then initialises its contents to binary z...operator new(TUint,TUint)Allocates the object from the heap and then initialises its contents to binary z...| Interface status: | deprecated | Use static CCamera* New2L(MCameraObserver2& aObserver,TInt aCameraIndex,TInt aPriority); |
| Capability: | MultimediaDD | A process requesting or using this method that has MultimediaDD capability will always have precedence over a process that does not have MultimediaDD. |
| Capability: | UserEnvironment | An application that creates a CCamera object must have the UserEnvironment capability. |
IMPORT_C static CCamera* NewL(MCameraObserver2 &aObserver, TInt aCameraIndex, TInt aPriority);
Creates an object representing a camera.
Note: Applications using this method to create camera object may not receive enums/uids added in future(after being baselined).
To receive them, they should rather use CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt), in which case, they should prepare themselves to receive unrecognised values.
|
|
|
| Capability: | UserEnvironment | An application that creates a CCamera object must have the UserEnvironment capability. |
IMPORT_C static CCamera* NewL(MCameraObserver &aObserver, TInt aCameraIndex);
Creates an object representing a camera.
Note: Applications using this method to create camera object may not receive enums/uids added in future(after being baselined).
To receive them, they should rather use CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt), in which case, they should prepare themselves to receive unrecognised values.
|
|
|
|
|
IMPORT_C static TInt CamerasAvailable();
Determines the number of cameras on the device.
|
| Capability: | MultimediaDD | A process requesting or using this method that has MultimediaDD capability will always have precedence over a process that does not have MultimediaDD. |
| Capability: | UserEnvironment | An application that creates a CCamera object must have the UserEnvironment capability. |
IMPORT_C static CCamera* New2L(MCameraObserver2 &aObserver, TInt aCameraIndex, TInt aPriority);
Creates an object representing a camera. Clients prepare themselves to receive unrecognised enum, uids etc.
Note: Clients using this creation method should prepare themselves to receive any unrecognised enum values, uids from 'supported' or 'getter' methods
|
|
|
| Interface status: | deprecated | Use static CCamera* NewDuplicate2L(MCameraObserver2& aObserver,TInt aCameraHandle); |
| Capability: | UserEnvironment | An application that creates a CCamera object must have the UserEnvironment capability. |
IMPORT_C static CCamera* NewDuplicateL(MCameraObserver2 &aObserver, TInt aCameraHandle);
Duplicates the original camera object for use by, for example, multimedia systems.
May leave with KErrNoMemory or KErrNotFound if aCameraHandle is not valid.
Note: Applications using this method to create camera object may not receive enums/uids added in future(after being baselined).
To receive them, they should rather use CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt), in which case, they should prepare themselves to receive unrecognised values.
|
|
|
| Capability: | UserEnvironment | An application that creates a CCamera object must have the UserEnvironment capability. |
IMPORT_C static CCamera* NewDuplicate2L(MCameraObserver2 &aObserver, TInt aCameraHandle);
Duplicates the original camera object for use by, for example, multimedia systems. Clients prepare themselves to receive unrecognised enum, uids etc.
May leave with KErrNoMemory or KErrNotFound if aCameraHandle is not valid.
Note: Clients using this creation method should prepare themselves to receive any unrecognised enum values, uids from 'supported' or 'getter' methods
|
|
|
| Capability: | UserEnvironment | An application that creates a CCamera object must have the UserEnvironment capability. |
IMPORT_C static CCamera* NewDuplicateL(MCameraObserver &aObserver, TInt aCameraHandle);
Duplicates the original camera object for use by, for example, multimedia systems.
Note: Applications using this method to create camera object may not receive enums/uids added in future(after being baselined).
To receive them, they should rather use CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt), in which case, they should prepare themselves to receive unrecognised values.
|
|
|
virtual void CameraInfo(TCameraInfo &aInfo) const=0;
Gets information about the camera device.
|
virtual void Reserve()=0;
Asynchronous function that performs any required initialisation and reserves the camera for exclusive use.
Calls MCameraObserver:: ReserveComplete() when complete.
virtual void Release()=0;
De-initialises the camera, allowing it to be used by other clients.
virtual void PowerOn()=0;
Asynchronous method to switch on camera power.
User must have successfully called CCamera::Reserve() prior to calling this function.
Calls MCameraObserver::PowerOnComplete(TInt) when power on is complete.
virtual TInt Handle()=0;
Gets the device-unique handle of this camera object.
|
virtual void SetZoomFactorL(TInt aZoomFactor=0)=0;
Sets the zoom factor.
This must be in the range of TCameraInfo::iMinZoom to TCameraInfo::iMaxZoom inclusive. May leave with KErrNotSupported if the specified zoom factor is out of range.
|
virtual TInt ZoomFactor() const=0;
Gets the currently set zoom factor.
|
virtual void SetDigitalZoomFactorL(TInt aDigitalZoomFactor=0)=0;
Sets the digital zoom factor.
This must be in the range of 0 to TCameraInfo::iMaxDigitalZoom inclusive.
May leave with KErrNotSupported if the zoom factor is out of range.
|
virtual TInt DigitalZoomFactor() const=0;
Gets the currently set digital zoom factor.
|
virtual void SetContrastL(TInt aContrast)=0;
Sets the contrast adjustment of the device.
This must be in the range of -100 to +100 or EContrastAuto. May leave with KErrNotSupported if the specified contrast value is out of range.
|
virtual TInt Contrast() const=0;
Gets the currently set contrast value.
|
virtual void SetBrightnessL(TInt aBrightness)=0;
Sets the brightness adjustment of the device.
No effect if this is not supported, see TCameraInfo::iBrightnessSupported.
This must be in the range of -100 to +100 or EBrightnessAuto. May leave with KErrNotSupported if the brightness adjustment is out of range.
|
virtual TInt Brightness() const=0;
Gets the currently set brightness adjustment value.
|
virtual void SetFlashL(TFlash aFlash=EFlashNone)=0;
Sets the flash mode.
No effect if this is not supported, see TCameraInfo::iFlashModesSupported.
May leave with KErrNotSupported if the specified flash mode is invalid.
|
virtual TFlash Flash() const=0;
Gets the currently set flash mode.
Note: if CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) is not used to create CCamera object, it is assumed that application is not prepared to receive extra added enum values (unrecognised).
So, any extra enum value(unrecognised) (set in the ECAM implementation because of sharing clients) should not be returned
from the ECAM implementation. To receive extra added enum values, application should rather use CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) to create camera object. ECAM implementation, after verifying this,(by checking version no.) may send new values, if set.
In this case, application is assumed to be prepared to receive unrecognised enum values.
|
![[Top]](../../../../a_stock/images/arrow_up_2.gif){kind=icon}
CCamera::CCameraAdvancedSettings::FlashMode()constGets the currently set flash mode.virtual void SetExposureL(TExposure aExposure=EExposureAuto)=0;
Sets the exposure adjustment of the device.
No effect if this is not supported, see CameraInfo::iExposureModesSupported.
May leave with KErrNotSupported if the specified exposure adjustment is invalid.
|
virtual TExposure Exposure() const=0;
Gets the currently set exposure setting value.
|
virtual void SetWhiteBalanceL(TWhiteBalance aWhiteBalance=EWBAuto)=0;
Sets the white balance adjustment of the device.
No effect if this is not supported, see TCameraInfo::iWhiteBalanceModesSupported.
|
|
virtual TWhiteBalance WhiteBalance() const=0;
Gets the currently set white balance adjustment value.
Note: if CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) is not used to create CCamera object, it is assumed that application is not prepared to receive extra added enum values (unrecognised).
So, any extra enum value(unrecognised) (set in the ECAM implementation because of sharing clients) should not be returned
from the ECAM implementation. To receive extra added enum values, application should rather use CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) to create camera object. ECAM implementation, after verifying this,(by checking version no.) may send new values, if set.
In this case, application is assumed to be prepared to receive unrecognised enum values. Refer CCamera::CCameraAdvancedSettings::WhiteBalanceMode()const implementation
|
CCamera::CCameraAdvancedSettings::WhiteBalanceMode()constGets the current white balance value.virtual void StartViewFinderDirectL(RWsSession &aWs, CWsScreenDevice &aScreenDevice, RWindowBase &aWindow, TRect &aScreenRect)=0;
Starts transfer of view finder data to the given portion of the screen using direct screen access.
The aScreenRect parameter is in screen co-ordinates and may be modified if, eg, the camera requires the destination to have a certain byte alignment, etc.
Note: This method is assumed to be meant for default display only. KECamDefaultViewFinderHandle should be used to refer viewfinders started using CCamera methods.
|
|
virtual void StartViewFinderDirectL(RWsSession &aWs, CWsScreenDevice &aScreenDevice, RWindowBase &aWindow, TRect &aScreenRect,
TRect &aClipRect)=0;
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 CCamera::Reserve() has not been called, or has not yet completed.
Note: This method is assumed to be meant for default display only. KECamDefaultViewFinderHandle should be used to refer viewfinders started using CCamera methods.
|
|
virtual void StartViewFinderBitmapsL(TSize &aSize)=0;
Starts transfer of view finder data.
Bitmaps are returned by MCameraObserver::ViewFinderFrameReady(CFbsBitmap &).
Note: This method is assumed to be meant for default display only.
|
|
virtual void StartViewFinderBitmapsL(TSize &aSize, TRect &aClipRect)=0;
Starts transfer of view finder data and clips the bitmap to the specified clip rectangle.
The bitmap is the size of the intersection of aSize and aClipRect, not simply aSize padded with white space.
Note: This method is assumed to be meant for default display only.
|
|
virtual void StartViewFinderL(TFormat aImageFormat, TSize &aSize)=0;
Starts transfer of view finder data.
Picture data is returned by MCameraObserver2::ViewFinderReady(MCameraBuffer &,TInt).
Note: This method is assumed to be meant for default display only. KECamDefaultViewFinderHandle should be used to refer viewfinders started using CCamera methods.
|
|
virtual void StartViewFinderL(TFormat aImageFormat, TSize &aSize, TRect &aClipRect)=0;
Starts transfer of view finder data and clips the picture to the specified clip rectangle. Picture data is returned by MCameraObserver2::ViewFinderReady(MCameraBuffer &,TInt).
The picture is the size of the intersection of aSize and aClipRect, not simply aSize padded with white space.
Note: This method is assumed to be meant for default display only. KECamDefaultViewFinderHandle should be used to refer viewfinders started using CCamera methods.
|
|
virtual void StopViewFinder()=0;
Stops transfer of view finder data to the screen.
Note: This method is assumed to be meant for default display only. KECamDefaultViewFinderHandle should be used to refer viewfinders started using CCamera methods.
virtual TBool ViewFinderActive() const=0;
Queries whether the view finder is active.
Note: This method is assumed to be meant for default display only. KECamDefaultViewFinderHandle should be used to refer viewfinders started using CCamera methods.
|
virtual void SetViewFinderMirrorL(TBool aMirror)=0;
Sets whether view finder mirroring is on.
Used to switch between what the camera sees and what you would see if the device were a mirror.
Note: This method is assumed to be meant for default display only. KECamDefaultViewFinderHandle should be used to refer viewfinders started using CCamera methods.
|
|
virtual TBool ViewFinderMirror() const=0;
Gets whether view finder mirroring is active.
Note: This method is assumed to be meant for default display only. KECamDefaultViewFinderHandle should be used to refer viewfinders started using CCamera methods.
|
virtual void PrepareImageCaptureL(TFormat aImageFormat, TInt aSizeIndex)=0;
Performs setup and allocation of memory.
Called prior to calling CCamera::CaptureImage() to keep the latency of that function to a minimum.
Needs to be called only once for multiple CCamera::CaptureImage() calls. May leave with KErrNotSupported or KErrNoMemory or KErrInUse or KErrNotReady.
The specified image format must be one of the formats supported (see TCameraInfo::iImageFormatsSupported).
The specified size index must be in the range of 0 to TCameraInfo::iNumImageSizesSupported-1 inclusive.
|
|
virtual void PrepareImageCaptureL(TFormat aImageFormat, TInt aSizeIndex, const TRect &aClipRect)=0;
Performs setup and allocation of memory and clips the image to the specified rectangle.
No effect unless TCameraInfo::iImageClippingSupported is set to ETrue. The image captured is the intersection of aClipRect
and the rectangle from (0,0) to aSize. Needs to be called only once for multiple CCamera::CaptureImage() calls. May leave with KErrNotSupported or KErrNoMemory.
The specified image format must be one of the formats supported (see TCameraInfo::iImageFormatsSupported).
The specified size index must be in the range of 0 to TCameraInfo::iNumImageSizesSupported-1 inclusive.
|
|
virtual void CaptureImage()=0;
Asynchronously performs still image capture.
Calls MCameraObserver::ImageReady(CFbsBitmap *,HBufC8 *,TInt) when complete.
virtual void EnumerateCaptureSizes(TSize &aSize, TInt aSizeIndex, TFormat aFormat) const=0;
Enumerates through the available image capture sizes, based on the specified size index and format
The size index must be in the range 0 to TCameraInfo::iNumImageSizesSupported-1 inclusive.
|
virtual void PrepareVideoCaptureL(TFormat aFormat, TInt aSizeIndex, TInt aRateIndex, TInt aBuffersToUse, TInt aFramesPerBuffer)=0;
Prepares for video capture.
Performs setup and allocation of memory prior to calling CCamera::StartVideoCapture() to keep the latency of that function to a minimum.
May leave with KErrNotSupported or KErrNoMemory.
|
|
virtual void PrepareVideoCaptureL(TFormat aFormat, TInt aSizeIndex, TInt aRateIndex, TInt aBuffersToUse, TInt aFramesPerBuffer,
const TRect &aClipRect)=0;
Prepares for video capture and clips the frames to the given rectangle.
Performs setup and allocation of memory prior to calling CCamera::StartVideoCapture() to keep the latency of that function to a minimum.
May leave with KErrNotSupported or KErrNoMemory.
|
|
virtual void StartVideoCapture()=0;
Starts capturing video.
Calls MCameraObserver::FrameBufferReady(MFrameBuffer *,TInt) when each buffer has been filled with the required number of frames, as set by CCamera::PrepareVideoCaptureL(TFormat,TInt,TInt,TInt,TInt).
virtual TBool VideoCaptureActive() const=0;
Tests whether video capture is active.
|
virtual void EnumerateVideoFrameSizes(TSize &aSize, TInt aSizeIndex, TFormat aFormat) const=0;
Enumerates through the available video frame sizes, based on the specified size index and format.
|
virtual void EnumerateVideoFrameRates(TReal32 &aRate, TInt aRateIndex, TFormat aFormat, TInt aSizeIndex, TExposure aExposure=EExposureAuto)
const=0;
Enumerates through the available video frame rates, based on the specified rate index, video frame format, size index and exposure mode.
|
virtual void GetFrameSize(TSize &aSize) const=0;
Gets the frame size currently in use.
|
virtual TReal32 FrameRate() const=0;
Gets the frame rate currently in use.
|
virtual TInt BuffersInUse() const=0;
Gets the number of buffers currently in use.
|
virtual TInt FramesPerBuffer() const=0;
Gets the number of frames per buffer currently in use.
|
virtual void SetJpegQuality(TInt aQuality)=0;
Sets the quality value to use if jpeg is a supported image for video format.
Ignored if jpeg is not a supported image for video format.
|
virtual TInt JpegQuality() const=0;
Gets the currently set jpeg quality value.
Returns 0 if not supported.
|
virtual TAny* CustomInterface(TUid aInterface)=0;
Gets a custom interface. The client has to cast the returned pointer to the appropriate type.
|
|
|
|
class CCameraDirectViewFinder : public CBase;
CCamera direct view finder class is used to provide support for Direct View Finder functionalities like pause/resume.
Note: This class is not intended for sub-classing and used to standardise existing varieties of implementations.
Note: This class features are supposed to be meant for the direct viewfinder started using CCamera methods.
Note: If the class methods leave, the output type parameter value is not guaranteed to be valid.
CBase -
Base class for all classes to be instantiated on the heap.
CCamera::CCameraDirectViewFinder - ...
Defined in CCamera::CCameraDirectViewFinder:
EViewFinderActiveView Finder is activated EViewFinderInActiveView Finder has been stopped or hasn't yet started. Default state. EViewFinderPauseView Finder has been paused NewL(CCamera &)Factory function for creating the CCamera::CCameraDirectViewFinder object.PauseViewFinderDirectL()Pauses the direct viewfinderResumeViewFinderDirectL()Resumes the direct viewfinderTViewFinderStateSpecifies direct viewfinder state. ViewFinderState()constGets the current view finder state.~CCameraDirectViewFinder()Destructor Inherited from CBase:
Delete(CBase *)Deletes the specified object.Extension_(TUint,TAny *&,TAny *)Extension function operator new(TUint)Allocates the object from the heap and then initialises its contents to binary z...operator new(TUint,TAny *)Initialises the object to binary zeroes.operator new(TUint,TLeave)Allocates the object from the heap and then initialises its contents to binary z...operator new(TUint,TLeave,TUint)Allocates the object from the heap and then initialises its contents to binary z...operator new(TUint,TUint)Allocates the object from the heap and then initialises its contents to binary z...NewL(CCamera &)IMPORT_C static CCameraDirectViewFinder* NewL(CCamera &aOwner);
Factory function for creating the CCamera::CCameraDirectViewFinder object.
|
|
|
~CCameraDirectViewFinder()IMPORT_C ~CCameraDirectViewFinder();
Destructor
PauseViewFinderDirectL()IMPORT_C void PauseViewFinderDirectL();
Pauses the direct viewfinder
Note: This will pause the direct viewfinder which is started using the CCamera method.
|
CCamera::StartViewFinderDirectL(RWsSession &,CWsScreenDevice &,RWindowBase &,TRect &)Starts transfer of view finder data to the given portion of the screen using dir...CCamera::StartViewFinderDirectL(RWsSession &,CWsScreenDevice &,RWindowBase &,TRect &,TRect &)Starts transfer of view finder data to the given portion of the screen using dir...ResumeViewFinderDirectL()IMPORT_C void ResumeViewFinderDirectL();
Resumes the direct viewfinder
Note: This will resume the direct viewfinder which is started using the CCamera method.
|
CCamera::StartViewFinderDirectL(RWsSession &,CWsScreenDevice &,RWindowBase &,TRect &)Starts transfer of view finder data to the given portion of the screen using dir...CCamera::StartViewFinderDirectL(RWsSession &,CWsScreenDevice &,RWindowBase &,TRect &,TRect &)Starts transfer of view finder data to the given portion of the screen using dir...ViewFinderState()constIMPORT_C TViewFinderState ViewFinderState() const;
Gets the current view finder state.
Note: This will retrieve the state of the direct viewfinder which is started using the CCamera method.
|
CCamera::StartViewFinderDirectL(RWsSession &,CWsScreenDevice &,RWindowBase &,TRect &)Starts transfer of view finder data to the given portion of the screen using dir...CCamera::StartViewFinderDirectL(RWsSession &,CWsScreenDevice &,RWindowBase &,TRect &,TRect &)Starts transfer of view finder data to the given portion of the screen using dir...TViewFinderStateTViewFinderState
Specifies direct viewfinder state.
|
class CCameraOverlay : public CBase;
This class provides support for image overlays. The client can use it to overlay an image onto the viewfinder, snapshots, still images and video. A client can create multiple overlays, where each overlay can be in a different format. The properties of an overlay can be changed after it has been created.
Note: This class provides a standardised client interface for the camera overlay. Classes cannot be derived from it.
Note: If the class methods leave, the output type parameter value is not guaranteed to be valid.
CBase -
Base class for all classes to be instantiated on the heap.
CCamera::CCameraOverlay - This class provides support for image overlays. The client can use it to overlay...
Defined in CCamera::CCameraOverlay:
CreateOverlayL(const TOverlayParameters &,CFbsBitmap *)Creates an image overlay object on the ECam implementation, returning a handle t...EBinarySupports only binary blending. If alpha value is 0xFF, it is opaque, otherwise t...EBinaryDynamicSupports only dynamic binary blending - allows values to be changed when overlay...EBlendNoneDoes not support blending. EFullRangeFull support for blending - all values in the range [0:255]. EFullRangeDynamicFull support for dynamic blending - all values in the range [0:255]EModeClientViewfinderThe image is to be overlaid on client-based viewfinder EModeDirectViewfinderThe image is to be overlaid on direct viewfinder EModeNoneOverlays are not supported for any camera mode. EModeSnapshotThe image can be overlaid on a snapshot. The camera has snapshot functionality s...EModeStillImageThe image can be overlaid on captured images. The camera is in still image mode....EModeStillImageBracketThe image is to be overlaid when Still Image Bracketing driving mode is active. EModeStillImageBracketMergeThe image is to be overlaid when Still Image Bracketing with Merge option drivin...EModeStillImageBurstThe image is to be overlaid when Still Image Burst driving mode is active. EModeStillImageContinuousThe image is to be overlaid when Continuous Still Image driving mode is active. EModeStillImageTimeLapseThe image is to be overlaid when Timed Still Image with Lapse option driving mod...EModeStillImageTimedThe image is to be overlaid when Timed Still Image driving mode is active. EModeVideoThe image can be overlaid on a video frame. The camera is in video mode. EModeViewfinderThe image can be overlaid on a viewfinder. The camera is displaying directly to ...EOverlayNoneDoes not support overlays. EPerPixelBlending is on a per pixel basis, where the alpha value information is provided ...EPerPlaneBlending is on a per plane basis, where all pixels are affected by the same alph...GetAllOverlaysInZOrderL(RArray< TUint > &)Gets all the overlay handles maintained by the ECam implementation, in order of ...GetOverlayBitmapL(TUint,CFbsBitmap *)Gets the overlay image data for a specified overlay.GetOverlayParametersL(TUint,TOverlayParameters &)Gets the parameters that characterize a given overlay.GetOverlaySupport(TOverlaySupportInfo &)Gets information on the overlay functionality supported by the ECam implementati...NewL(CCamera &)Factory function that creates a new camera overlay object on the heap.ReleaseOverlay(TUint)Releases the specified overlay handle.SetAllOverlaysInZOrderL(const RArray< TUint > &)Sets the Z-Order of all the overlay handles known by this CCamera::CCameraOverla...SetOverlayBitmapL(TUint,const CFbsBitmap *)Allows the overlay image data to be changed for a specified overlay. Use this fu...SetOverlayParametersL(TUint,const TOverlayParameters &)Sets new parameters that characterize a given overlay.TBlendingTypeBlending typesTOverlayCameraModeOverlay camera mode typesTOverlayTypeOverlay types~CCameraOverlay()Destructor for the CCamera::CCameraOverlay class. Inherited from CBase:
Delete(CBase *)Deletes the specified object.Extension_(TUint,TAny *&,TAny *)Extension function operator new(TUint)Allocates the object from the heap and then initialises its contents to binary z...operator new(TUint,TAny *)Initialises the object to binary zeroes.operator new(TUint,TLeave)Allocates the object from the heap and then initialises its contents to binary z...operator new(TUint,TLeave,TUint)Allocates the object from the heap and then initialises its contents to binary z...operator new(TUint,TUint)Allocates the object from the heap and then initialises its contents to binary z...NewL(CCamera &)IMPORT_C static CCameraOverlay* NewL(CCamera &aCamera);
Factory function that creates a new camera overlay object on the heap.
Note: Clients using MCameraObserver are not recommended to use this extension class since they cannot handle events.
|
|
|
~CCameraOverlay()IMPORT_C ~CCameraOverlay();
Destructor for the CCamera::CCameraOverlay class.
GetOverlaySupport(TOverlaySupportInfo &)IMPORT_C void GetOverlaySupport(TOverlaySupportInfo &aInfo);
Gets information on the overlay functionality supported by the ECam implementation.
|
CreateOverlayL(const TOverlayParameters &,CFbsBitmap *)IMPORT_C TUint CreateOverlayL(const TOverlayParameters &aParameters, CFbsBitmap *aBitmap);
Creates an image overlay object on the ECam implementation, returning a handle to the newly created object.
|
|
|
ReleaseOverlay(TUint)IMPORT_C void ReleaseOverlay(TUint aOverlayHandle);
Releases the specified overlay handle.
Note: If the handle specified in aOverlayHandle is invalid (out of range) the function call is ignored and no error is reported.
|
SetOverlayBitmapL(TUint,const CFbsBitmap *)IMPORT_C void SetOverlayBitmapL(TUint aOverlayHandle, const CFbsBitmap *aBitmap);
Allows the overlay image data to be changed for a specified overlay. Use this function to set the overlay image data if it
was not specified when the overlay was created using CCamera::CCameraOverlay::CreateOverlayL(const TOverlayParameters &,CFbsBitmap *).
Note: Once this method is called, overlay size should not be changed for the given overlay. Hence, SetOverlayParametersL should not be called after this method.
|
|
GetOverlayBitmapL(TUint,CFbsBitmap *)IMPORT_C void GetOverlayBitmapL(TUint aOverlayHandle, CFbsBitmap *aBitmap);
Gets the overlay image data for a specified overlay.
Note: The ECam implementation will transfer the ownership of the aBitmap to the client.
|
|
GetOverlayParametersL(TUint,TOverlayParameters &)IMPORT_C void GetOverlayParametersL(TUint aOverlayHandle, TOverlayParameters &aInfo);
Gets the parameters that characterize a given overlay.
|
|
SetOverlayParametersL(TUint,const TOverlayParameters &)IMPORT_C void SetOverlayParametersL(TUint aOverlayHandle, const TOverlayParameters &aParameters);
Sets new parameters that characterize a given overlay.
|
|
GetAllOverlaysInZOrderL(RArray< TUint > &)IMPORT_C void GetAllOverlaysInZOrderL(RArray< TUint > &aOverlayHandles);
Gets all the overlay handles maintained by the ECam implementation, in order of their Z-Value.
Note: Implementation shall give preference to the sequence in which the client has passed the overlay handles in case of any mis-match with the 'z-order' of each such overlay. Implementation shall amend the 'z-order' of the overlays if required to remove any ambiguity.
|
|
SetAllOverlaysInZOrderL(const RArray< TUint > &)IMPORT_C void SetAllOverlaysInZOrderL(const RArray< TUint > &aOverlayHandles);
Sets the Z-Order of all the overlay handles known by this CCamera::CCameraOverlay object.
Note: Implementation shall give preference to the sequence in which the client has passed the overlay handles in case of any mis-match with the 'z-order' of each such overlay. Implementation shall amend the 'z-order' of the overlays if required to remove any ambiguity.
|
|
TOverlayCameraModeTOverlayCameraMode
Overlay camera mode types
Represents the possible camera modes in which the overlay could be used. Several types can be combined when returning ECam implementation support for various modes.
|
TOverlayTypeTOverlayType
Overlay types
Type in which alpha value will be provided.
|
TBlendingTypeTBlendingType
Blending types
Type of supported blending.
|
class CCameraImageProcessing : public CBase;
This class is used to perform image processing operations on the camera. These include brightness, contrast, gamma, hue, sharpness and saturation adjustments. The client is also able to perform simple image transformations like cropping, rotation, mirroring, scaling, noise reduction and glare reduction. . When an operation selection is complete, all clients are notified with the respective event UID.
As often cameras may support only a subset of discrete values of the allowed range, the API allows the client to retrieve those and use them explicitly.
Note: This class is not intended for sub-classing and used to standardise existing varieties of implementations.
Note: it is assumed that setting a new value for a transformations(transform, adjust, effect) effectively activates the transformations. Whilst for effects and adjustments there is always a value, transforms may have a dependency on other parameters and crop - requires setting of source rectangle. scale - will use setting of source rectangle, and the magnification factor is determined by the source rectangle and the output size. This is always magnification. if a value is set, it is assumed to be a scaling factor multiplied by KECamFineResolutionFactor and set to integer. mirror - values of TMirror type. rotation - the angle in degrees. noise reduction - TNoiseReduction. glare removal - TGlareReduction.
Example
// Lets assume that an application would need to check whether gamma correction is
// supported on a particular platform. After obtaining a valid pointer to the interface,
// it would call GetSupportedTransformationsL() to obtain the list of the supported
// transformations and check whether KUidECamEventImageProcessingAdjustGamma
// is in the list. If it is then call SetTranformationValue(KUidECamEventImageProcessingAdjustGamma, 200);
// to set the new value. A notification will be generated to the client to indicate success.
RArray<TUid> suppTransforms; // array of supported transformations
CleanupClosePushL(suppTransforms);
imageProcess->GetSupportedTransformationsL(suppTransfUids);
...
// if the gamma is supported
TInt gammaCorrection = 200; // gamma correction of 2.0
imageProcess->SetTranformationValue(KUidECamEventImageProcessingAdjustGamma, gammaCorrection);
...
// pop stack to close the RArrayNote: If the class methods leave, the output type parameter value is not guaranteed to be valid.
CBase -
Base class for all classes to be instantiated on the heap.
CCamera::CCameraImageProcessing - This class is used to perform image processing operations on the camera. These i...
Defined in CCamera::CCameraImageProcessing:
CancelColorAccentL()Cancel the color accent process.CancelColorSwappingL()Cancel the color swapping process.EEffectCineCine visual effect.EEffectColorAccentWhere a list of color can be kept as they are and the rest converted to gray.EEffectColorSwapColor swap visual effect.EEffectEmbossEmboss visual effect. EEffectLowSharpeningSelective sharpening visual effect. EEffectMonochromeBlack and white visual effect. EEffectNaturalNatural visual effect.EEffectNegativeNegative visual effect. EEffectNeutralNeutral colour visual effect. EEffectNoneEffects off is default, always supported EEffectOldFilmOld film visual effect.EEffectRedEyeReductionRed eye glare reduction visual effect. EEffectSepiaSepia visual effect. EEffectSolarizeSolarization visual effect. EEffectVividVivid colour visual effect. EGammaAutoSets the gamma adjustment automatically. EGlareReductionBasicmost basic glare reduction. EGlareReductionNoneDefault value. Glare reduction disabled. EHueAutoSets the hue adjustment automatically. EMirrorBothMirror along horizontal and vertical axis. EMirrorHorizontalMirror along horizontal axis. EMirrorNoneDefault value. Mirroring is disabled. EMirrorVerticalMirror along vertical axis. ENoiseReductionBasicmost basic noise reduction. ENoiseReductionNoneDefault value. Noise reduction disabled. ERepresentationMultipleThe given color represents a group of colors ERepresentationNoneFeature is not supported ERepresentationSingleThe given color is uniquely represented ERgbGroupingAutomaticThis means neighbourhood colors are to be automatically decided by the implement...ERgbGroupingFixedThis means no neighbourhood colors are considered ERgbGroupingNoneFeature is not supported ERgbGroupingSignificantBitsThis means neighbourhood colors for source have to be decided by ignoring few st...ERgbGroupingUniformThis means colors in target are obtained as some uniform proportion using source...ESaturationAutoSets the saturation adjustment automatically. ESharpnessAutoSets the sharpness adjustment automatically. GetActiveTransformSequenceL(RArray< TUid > &)constGet the sequence of all active transforms, ordered in order of execution.GetActiveTransformationsL(RArray< TUid > &)constGet currently active transformations on the camera.GetColorAccentCapabilitiesL(TInt,TColorOperationCapabilities &)constRetrieves the color accent capabilites per entry, if different entries have diff...GetColorAccentEntryL(TInt,TColorOperationEntry &)constGet the details of the color accent entry corresponding to the given indexGetColorSwapCapabilitiesL(TInt,TColorOperationCapabilities &)constRetrieves the color swapping capabilites per entry, if different entries have di...GetColorSwapEntryL(TInt,TColorOperationEntry &)constGet the details of the color swap entry corresponding to the given indexGetConcurrentColorAccentSupportedL(TInt &)constRetrieves the maximum number of color entries on which simultaneous color accent...GetConcurrentColorSwappingsSupportedL(TInt &)constRetrieves the maximum number of simultaneous color swapping possible.GetSourceRect(TRect &)constGet the source rectangle for KUidECamEventImageProcessingTransformScale or KUidE...GetSupportedTransformationsL(RArray< TUid > &)constGet all transformations supported on the camera.GetTransformationSupportedValuesL(TUid,RArray< TInt > &,TValueInfo &)constGet all values supported by an active transformation.GetTransformationValue(TUid,TInt &)constGet the current value of a transformationNewL(CCamera &)Factory function for creating the CCamera::CCameraImageProcessing object. The cr...RemoveColorAccentEntryL(TInt)Removes the color accent entry corresponding to the given indexRemoveColorSwapEntryL(TInt)Removes the color swap entry corresponding to the given indexSetActiveTransformSequenceL(RArray< TUid > &)Set the order of all active transform in terms of execution. The transforms with...SetColorAccentEntryL(TInt,const TColorOperationEntry &)Set the color accent entriesSetColorSwapEntryL(TInt,const TColorOperationEntry &)Set the color swap entriesSetSourceRect(const TRect &)Set the source rectangle for KUidECamEventImageProcessingTransformScale or KUidE...SetTransformationValue(TUid,TInt)Set new value for a transformation. A notification event with the transformation...StartColorAccentL()Starts the color accent process after taking into account the color accent entri...StartColorSwappingL()Starts the color swapping process after taking into account the color swap entri...TBitsIgnoreClass used to control the number of bits to ignore for Red, Green, Blue or Alpha...TColorOperationCapabilitiesColor operation capabilities characterizing both color swap and color accent fea...TColorOperationEntryColor operation parameters characterizing both color swap and color accent featu...TColorOperationRepresentationUsed for color swap and color accent feature in TEffect. It describes whether th...TColorOperationRgbGroupingModeUsed for color swap and color accent feature in TEffect. It describes the type o...TEffectSettings for the supported effects TGammaGamma settings TGlareReductionGlare reduction settings THueHue Settings TMirrorMirror settings TNoiseReductionNoise filter settings TSaturationSaturation Settings TSharpnessSharpness Settings TransformationValue(TUid)constGet the current value of a transformation~CCameraImageProcessing()Destructor Inherited from CBase:
Delete(CBase *)Deletes the specified object.Extension_(TUint,TAny *&,TAny *)Extension function operator new(TUint)Allocates the object from the heap and then initialises its contents to binary z...operator new(TUint,TAny *)Initialises the object to binary zeroes.operator new(TUint,TLeave)Allocates the object from the heap and then initialises its contents to binary z...operator new(TUint,TLeave,TUint)Allocates the object from the heap and then initialises its contents to binary z...operator new(TUint,TUint)Allocates the object from the heap and then initialises its contents to binary z...NewL(CCamera &)IMPORT_C static CCameraImageProcessing* NewL(CCamera &aCamera);
Factory function for creating the CCamera::CCameraImageProcessing object. The created object is supposed to be meant for image captures only.
Note: Clients using MCameraObserver are not recommended to use this extension class since they cannot handle events.
|
|
|
~CCameraImageProcessing()IMPORT_C ~CCameraImageProcessing();
Destructor
GetSupportedTransformationsL(RArray< TUid > &)constIMPORT_C void GetSupportedTransformationsL(RArray< TUid > &aTransformations) const;
Get all transformations supported on the camera.
KBaselinedImageProcessing is the baseline. Any image processing attribute with greater uid value means that it has been added in later versions
|
|
GetActiveTransformationsL(RArray< TUid > &)constIMPORT_C void GetActiveTransformationsL(RArray< TUid > &aTransformations) const;
Get currently active transformations on the camera.
KBaselinedImageProcessing is the baseline. Any image processing attribute with greater uid value means that it has been added in later versions
|
|
GetTransformationSupportedValuesL(TUid,RArray< TInt > &,TValueInfo &)constIMPORT_C void GetTransformationSupportedValuesL(TUid aTransformation, RArray< TInt > &aValues, TValueInfo &aInfo) const;
Get all values supported by an active transformation.
Note: Depending on the value of aInfo parameter, same array of values may describe different set of values. When camera device doesn't support this, empty array may be returned and TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case.
Note: If CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) is not used to create CCamera object, it is assumed that application is not prepared to receive extra added enum values for Effects. So, any extra enum
value(unrecognised) passed from the implementation will be filtered at this point. To receive extra added enum values, application
should rather use CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values
it is assumed that implementation will use EBitField to pack all supported effects
|
|
TransformationValue(TUid)const| Interface status: | deprecated | Use TInt GetTransformationValue(TUid aTransformation, TInt& aTransformationValue); |
IMPORT_C TInt TransformationValue(TUid aTransformation) const;
Get the current value of a transformation
Note: If CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) is not used to create CCamera object, it is assumed that application is not prepared to receive extra added enum values for Effects. So, any extra enum
value (unrecognised) received from the implementation will be dropped and EEffectNone would be passed instead. To receive
extra added enum values, application should rather use CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values
|
|
GetTransformationValue(TUid,TInt &)constIMPORT_C TInt GetTransformationValue(TUid aTransformation, TInt &aTransformationValue) const;
Get the current value of a transformation
Note: If CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) is not used to create CCamera object, it is assumed that application is not prepared to receive extra added enum values for Effects. So, any extra enum
value (unrecognised) received from the implementation will be dropped and EEffectNone would be passed instead. To receive
extra added enum values, application should rather use CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values
Note: Use this method instead of deprecated TInt TransformationValue(TUid aTransformation)
|
|
SetTransformationValue(TUid,TInt)IMPORT_C void SetTransformationValue(TUid aTransformation, TInt aValue);
Set new value for a transformation. A notification event with the transformation UID is sent to all clients. UIDs are in the form KUidECamEventImageProcessingXXXX.
|
GetActiveTransformSequenceL(RArray< TUid > &)constIMPORT_C void GetActiveTransformSequenceL(RArray< TUid > &aTransformSequence) const;
Get the sequence of all active transforms, ordered in order of execution.
KBaselinedImageProcessing is the baseline. Any image processing attribute with greater uid value means that it has been added in later versions
|
|
SetActiveTransformSequenceL(RArray< TUid > &)IMPORT_C void SetActiveTransformSequenceL(RArray< TUid > &aTransformSequence);
Set the order of all active transform in terms of execution. The transforms with smaller index are executed earlier.
|
|
SetSourceRect(const TRect &)IMPORT_C void SetSourceRect(const TRect &aRect);
Set the source rectangle for KUidECamEventImageProcessingTransformScale or KUidECamEventImageProcessingTransformCrop. The coordinates should fall within the current image rectangle. The result is always a logical AND operation between the two rectangles.
|
GetSourceRect(TRect &)constIMPORT_C void GetSourceRect(TRect &aRect) const;
Get the source rectangle for KUidECamEventImageProcessingTransformScale or KUidECamEventImageProcessingTransformCrop. The coordinates should fall within the current image rectangle. The result is always a logical AND operation between the two rectangles.
|
GetConcurrentColorSwappingsSupportedL(TInt &)constIMPORT_C void GetConcurrentColorSwappingsSupportedL(TInt &aConcurrentColorSwappingSupported) const;
Retrieves the maximum number of simultaneous color swapping possible.
|
|
GetColorSwapCapabilitiesL(TInt,TColorOperationCapabilities &)constIMPORT_C void GetColorSwapCapabilitiesL(TInt aIndex, TColorOperationCapabilities &aColorSwapCapabilities) const;
Retrieves the color swapping capabilites per entry, if different entries have different capabilities otherwise the same capabilities retrieved for a particular entry can be assumed to be valid for every entry
|
|
SetColorSwapEntryL(TInt,const TColorOperationEntry &)IMPORT_C void SetColorSwapEntryL(TInt aIndex, const TColorOperationEntry &aColorSwapParameters);
Set the color swap entries
Note: Triggers KUidECamEventCIPSetColorSwapEntry to all MCameraObserver2 clients of the camera. HandleEvent is used to report the result or any possible error. TECAMEvent2 class should be used in order to provide the entry no. of the color being set.
|
|
RemoveColorSwapEntryL(TInt)IMPORT_C void RemoveColorSwapEntryL(TInt aIndex);
Removes the color swap entry corresponding to the given index
Note: Triggers KUidECamEventCIPRemoveColorSwapEntry to all MCameraObserver2 clients of the camera. HandleEvent is used to report the result or any possible error. TECAMEvent2 class should be used in order to provide the entry no. of the color being removed.
|
|
GetColorSwapEntryL(TInt,TColorOperationEntry &)constIMPORT_C void GetColorSwapEntryL(TInt aIndex, TColorOperationEntry &aColorSwapParameters) const;
Get the details of the color swap entry corresponding to the given index
|
|
StartColorSwappingL()IMPORT_C void StartColorSwappingL();
Starts the color swapping process after taking into account the color swap entries updated up to this point.
Note: Triggers KUidECamEventCIPStartColorSwap to all MCameraObserver2 clients of the camera. HandleEvent is used to report the result or any possible error. One possible error case is when more
than one entry describe the same color source. New ecam error KErrECamColorOperationConflict used in such a case.
|
CancelColorSwappingL()IMPORT_C void CancelColorSwappingL();
Cancel the color swapping process.
Note: Used to cancel the color swapping process which might have been just started. If the issued CCamera::CCameraImageProcessing::StartColorSwappingL() gets cancelled, its event should report KErrCancel.
|
GetConcurrentColorAccentSupportedL(TInt &)constIMPORT_C void GetConcurrentColorAccentSupportedL(TInt &aConcurrentColorAccentSupported) const;
Retrieves the maximum number of color entries on which simultaneous color accent process is possible.
|
|
GetColorAccentCapabilitiesL(TInt,TColorOperationCapabilities &)constIMPORT_C void GetColorAccentCapabilitiesL(TInt aIndex, TColorOperationCapabilities &aColorAccentCapabilities) const;
Retrieves the color accent capabilites per entry, if different entries have different capabilities otherwise the same capabilities retrieved for a particular entry can be assumed to be valid for every entry
|
|
SetColorAccentEntryL(TInt,const TColorOperationEntry &)IMPORT_C void SetColorAccentEntryL(TInt aIndex, const TColorOperationEntry &aColorAccentParameters);
Set the color accent entries
Note: Triggers KUidECamEventCIPSetColorAccentEntry to all MCameraObserver2 clients of the camera. HandleEvent is used to report the result or any possible error. TECAMEvent2 class should be used in order to provide the entry no. of the color being set.
|
|
RemoveColorAccentEntryL(TInt)IMPORT_C void RemoveColorAccentEntryL(TInt aIndex);
Removes the color accent entry corresponding to the given index
Note: Triggers KUidECamEventCIPRemoveColorAccentEntry to all MCameraObserver2 clients of the camera. HandleEvent is used to report the result or any possible error. TECAMEvent2 class should be used in order to provide the entry no. of the color being removed.
|
|
GetColorAccentEntryL(TInt,TColorOperationEntry &)constIMPORT_C void GetColorAccentEntryL(TInt aIndex, TColorOperationEntry &aColorAccentParameters) const;
Get the details of the color accent entry corresponding to the given index
|
|
StartColorAccentL()IMPORT_C void StartColorAccentL();
Starts the color accent process after taking into account the color accent entries updated up to this point.
Note: Triggers KUidECamEventCIPStartColorAccent to all MCameraObserver2 clients of the camera. HandleEvent is used to report the result or any possible error.
|
CancelColorAccentL()IMPORT_C void CancelColorAccentL();
Cancel the color accent process.
Note: Used to cancel the color accent process which might have been just started. If the issued CCamera::CCameraImageProcessing::StartColorAccentL() gets cancelled, its event should report KErrCancel.
|
TColorOperationCapabilitiesclass TColorOperationCapabilities;
Color operation capabilities characterizing both color swap and color accent feature
Defined in CCamera::CCameraImageProcessing::TColorOperationCapabilities:
Size()constReturns the size of the class. Used for extensibility by deriving from this base...TColorOperationCapabilities()Constructor. Sets the size of this class in iSize.Version()constReturns the version of the class. Used for extensibility specially when the clas...iIsCapabilityUniformThis indicates whether the mapping mode and Rgb grouping mode uniform for every ...iSupportedSourceRepresentationThe source color representation that the server supports. The supported represen...iSupportedSourceRgbGroupingModeThe source color Rgb grouping modes that the server supports. The modes are held...iSupportedTargetRepresentationThe target color representation that the server supports. The supported represen...iSupportedTargetRgbGroupingModeThe target color Rgb grouping modes that the server supports. The modes are held...TColorOperationCapabilities()IMPORT_C TColorOperationCapabilities();
Constructor. Sets the size of this class in iSize.
Size()constIMPORT_C TInt Size() const;
Returns the size of the class. Used for extensibility by deriving from this base class and adding new member variables. Intended to be used for implementation of methods where this class reference is passed as function arguments. Implementation of such methods can find out the whether the actual class passed is base or the derived one. So, if a new application is made to run on an old implementation, an error may occur in such cases after the old implementation detects this by getting the size information of the T class passed. Also, if old application is made to run on a new implementation, this could be properly handled if the derived class variables handling is done in a proper 'if-else' statement.
Note: The size will be modified when the T-class gets updated.
|
Version()constIMPORT_C TUint Version() const;
Returns the version of the class. Used for extensibility specially when the class members are not added but the Reserved members get used at a later stage.
Note: The version will be modified when the T-class gets updated.
|
iSupportedSourceRepresentationTUint iSupportedSourceRepresentation;
The source color representation that the server supports. The supported representations are held as a bitwise logical OR of
the relevant individual modes defined in CCamera::CCameraImageProcessing:: TColorOperationRepresentation.
iSupportedTargetRepresentationTUint iSupportedTargetRepresentation;
The target color representation that the server supports. The supported representations are held as a bitwise logical OR of
the relevant individual modes defined in CCamera::CCameraImageProcessing:: TColorOperationRepresentation. Not applicable for color accent
iSupportedSourceRgbGroupingModeTUint iSupportedSourceRgbGroupingMode;
The source color Rgb grouping modes that the server supports. The modes are held as a bitwise logical OR of the relevant individual
modes defined in CCamera::CCameraImageProcessing:: TColorOperationRgbGroupingMode.
iSupportedTargetRgbGroupingModeTUint iSupportedTargetRgbGroupingMode;
The target color Rgb grouping modes that the server supports. The modes are held as a bitwise logical OR of the relevant individual
modes defined in CCamera::CCameraImageProcessing:: TColorOperationRgbGroupingMode. Not applicable for color accent
iIsCapabilityUniformTBool iIsCapabilityUniform;
This indicates whether the mapping mode and Rgb grouping mode uniform for every color entry
TBitsIgnoreclass TBitsIgnore;
Class used to control the number of bits to ignore for Red, Green, Blue or Alpha. This may be used when deciding for neighbourhood for source color in case of color swap and color accent feature
Defined in CCamera::CCameraImageProcessing::TBitsIgnore:
Size()constReturns the size of the class. Used for extensibility by deriving from this base...TBitsIgnore()Constructor. Sets the size of this class in iSize.Version()constReturns the version of the class. Used for extensibility specially when the clas...iAlphaBitsIgnoreThis gives the no. of bits to ignore for Alpha. Varies from 0 to 8. Any other va...iBlueBitsIgnoreThis gives the no. of bits to ignore for Blue color. Varies from 0 to 8. Any oth...iGreenBitsIgnoreThis gives the no. of bits to ignore for Green color. Varies from 0 to 8. Any ot...iRedBitsIgnoreThis gives the no. of bits to ignore for Red color. Varies from 0 to 8. Any othe...TBitsIgnore()IMPORT_C TBitsIgnore();
Constructor. Sets the size of this class in iSize.
Size()constIMPORT_C TInt Size() const;
Returns the size of the class. Used for extensibility by deriving from this base class and adding new member variables. Intended to be used for implementation of methods where this class reference is passed as function arguments. Implementation of such methods can find out the whether the actual class passed is base or the derived one. So, if a new application is made to run on an old implementation, an error may occur in such cases after the old implementation detects this by getting the size information of the T class passed. Also, if old application is made to run on a new implementation, this could be properly handled if the derived class variables handling is done in a proper 'if-else' statement.
Note: The size will be modified when the T-class gets updated.
|
Version()constIMPORT_C TUint Version() const;
Returns the version of the class. Used for extensibility specially when the class members are not added but the Reserved members get used at a later stage.
Note: The version will be modified when the T-class gets updated.
|
iRedBitsIgnoreTUint iRedBitsIgnore;
This gives the no. of bits to ignore for Red color. Varies from 0 to 8. Any other value should be an error
iGreenBitsIgnoreTUint iGreenBitsIgnore;
This gives the no. of bits to ignore for Green color. Varies from 0 to 8. Any other value should be an error
iBlueBitsIgnoreTUint iBlueBitsIgnore;
This gives the no. of bits to ignore for Blue color. Varies from 0 to 8. Any other value should be an error
iAlphaBitsIgnoreTUint iAlphaBitsIgnore;
This gives the no. of bits to ignore for Alpha. Varies from 0 to 8. Any other value should be an error
TColorOperationEntryclass TColorOperationEntry;
Color operation parameters characterizing both color swap and color accent feature; and for a particular entry.
Defined in CCamera::CCameraImageProcessing::TColorOperationEntry:
Size()constReturns the size of the class. Used for extensibility by deriving from this base...TColorOperationEntry()Constructor. Sets the size of this class in iSize.Version()constReturns the version of the class. Used for extensibility specially when the clas...iColorOperationSourceRgbGroupingModeThis defines the type of grouping for multiple representation of source color iColorOperationTargetRgbGroupingModeThis defines the type of grouping for multiple representation of target color in...iEntryStatusThis gives the entry status of every color operation entry. If entry is not set ...iNumBitsIgnoredThis gives the number of bits to ignore in case ERgbGroupingSignificantBits is u...iSourceColorThe source color (rgb triplet) which is changed to target color in case of Color...iSourceColorRepresentationThis defines whether the given source color represents itself or a group of colo...iTargetColorThe target color (rgb triplet) which replaces the source color in case of Color ...iTargetColorRepresentationThis defines whether the given target color represents itself or a group of colo...TColorOperationEntry()IMPORT_C TColorOperationEntry();
Constructor. Sets the size of this class in iSize.
Size()constIMPORT_C TInt Size() const;
Returns the size of the class. Used for extensibility by deriving from this base class and adding new member variables. Intended to be used for implementation of methods where this class reference is passed as function arguments. Implementation of such methods can find out the whether the actual class passed is base or the derived one. So, if a new application is made to run on an old implementation, an error may occur in such cases after the old implementation detects this by getting the size information of the T class passed. Also, if old application is made to run on a new implementation, this could be properly handled if the derived class variables handling is done in a proper 'if-else' statement.
Note: The size will be modified when the T-class gets updated.
|
Version()constIMPORT_C TUint Version() const;
Returns the version of the class. Used for extensibility specially when the class members are not added but the Reserved members get used at a later stage.
Note: The version will be modified when the T-class gets updated.
|
iSourceColorTRgb iSourceColor;
The source color (rgb triplet) which is changed to target color in case of Color Swap operation and remains unaffected in case of Color Accent operation
iTargetColorTRgb iTargetColor;
The target color (rgb triplet) which replaces the source color in case of Color Swap operation. Redundant for Color Accent operation
iSourceColorRepresentationTColorOperationRepresentation iSourceColorRepresentation;
This defines whether the given source color represents itself or a group of colors
iTargetColorRepresentationTColorOperationRepresentation iTargetColorRepresentation;
This defines whether the given target color represents itself or a group of colors in case of Color Swap operation. Redundant for Color Accent operation
iColorOperationSourceRgbGroupingModeTColorOperationRgbGroupingMode iColorOperationSourceRgbGroupingMode;
This defines the type of grouping for multiple representation of source color
iColorOperationTargetRgbGroupingModeTColorOperationRgbGroupingMode iColorOperationTargetRgbGroupingMode;
This defines the type of grouping for multiple representation of target color in case of Color Swap operation. Redundant for Color Accent operation
iNumBitsIgnoredTBitsIgnore iNumBitsIgnored;
This gives the number of bits to ignore in case ERgbGroupingSignificantBits is used for multiple representation of source color. For any other case, no. of bits ignored for red, green, blue or alpha should be 0
iEntryStatusTValueInfo iEntryStatus;
This gives the entry status of every color operation entry. If entry is not set or removed, this is ENotActive. And if entry is set, then this is EDiscreteSteps
TGammaTGamma
Gamma settings
|
TSharpnessTSharpness
Sharpness Settings
|
TSaturationTSaturation
Saturation Settings
|
THueTHue
Hue Settings
|
TEffectTEffect
Settings for the supported effects
|
TMirrorTMirror
Mirror settings
|
TNoiseReductionTNoiseReduction
Noise filter settings
|
TGlareReductionTGlareReduction
Glare reduction settings
|
TColorOperationRepresentationTColorOperationRepresentation
Used for color swap and color accent feature in TEffect. It describes whether the given source or target color represents itself or a group of color.
|
TColorOperationRgbGroupingModeTColorOperationRgbGroupingMode
Used for color swap and color accent feature in TEffect. It describes the type of grouping for source and target colors when they represent a group of color.
|
class CCameraAdvancedSettings : public CBase;
CCamera advanced settings class exposes an API for controlling individually digital camera advanced settings. These settings directly
relate to the image acquisition phase both for still images and video.
Note: This class is not intended for sub-classing and used to standardise existing varieties of implementations.
Note: If the class methods leave, the output type parameter value is not guaranteed to be valid.
CBase -
Base class for all classes to be instantiated on the heap.
CCamera::CCameraAdvancedSettings - ...
Defined in CCamera::CCameraAdvancedSettings:
Aperture()constGet current aperture value.ApertureExposureLockOn()constGets the current state for aperture and exposure lock.AutoFocusArea()constGets current chosen auto focus area on the camera.AutoFocusLockOn()constChecks whether AutoFocus value is locked or not.AutoFocusType()constGets current auto focus type on the camera. AutomaticSizeSelectionChangeOn()constRetrieves the state for automatic size selection option. Default value is EFalse...BracketMode()constGet current bracket mode.BracketParameter()constGet current bracket parameter.BracketParameterApertureAperture settings change. BracketParameterAutoFocusAutofocus settings change. BracketStep()constGet current bracket step.BurstImages()constGet the number of images captured normally under EDriveModeBurst condition. CameraIndex()constGets current camera index. The index uniquely identifies the camera on the devic...CameraType()constGets the type of this camera. CameraType(TInt)Get the type of a specific camera denoted by its index. A pluggable camera may n...ContinuousAutoFocusTimeout()constGets the current value for continuous autofocus timeout. Timeouts are in microse...DigitalZoom()constGets the currently set digital zoom value.DriveMode()constGets currently active drive mode.EAFAssistantLightAutoPut the AF assistant light in auto mode. It will be automatically decided when t...EAFAssistantLightManualOnswitch on the AF assistant light manually EAFAssistantLightOffswitch off the AF assistant light from either of 'manual on' or 'auto' mode EAutoFocusTypeAutoAutomatic. Default value EAutoFocusTypeContinuousContinious autofocus, more precise but consumes more power. also known as AF Ser...EAutoFocusTypeMultiAreaCenteredMultiple points of an object, more weighting for centre points. EAutoFocusTypeOffAutofocus is switched off. EAutoFocusTypeSingleOperates on a single shot, consumes less power. EAutoFocusTypeSingleAreaSingle area, suitable for relatively flat surfaces and portrait. EBracketMode3ImageBracket mode on. Three consecutive pictures are taken in order under (-1), on (0...EBracketMode5ImageBracket mode on. Five consecutive pictures are taken in order under (-2),under (...EBracketModeOffBracket mode is switched off. Default value. EBracketParameterColourBalanceColour balance settings change. EBracketParameterExposureExposure settings change. EBracketParameterFlashPowerFlash power change. EBracketParameterNoneNone. EBracketStepLargeLarge value. EBracketStepMediumMedium value. EBracketStepNonConfigNot supported. EBracketStepSmallSmall value. ECameraOnBoardCamera is non-detachable from device. Camera is always present. ECameraPluggableCamera is detachable from device. Camera is not always present. ECameraUnknownUnable to identify. EDriveModeAutoAutomatic. Default EDriveModeBracketCamera is in bracketing mode, producing individual frames. EDriveModeBracketMergeCamera is in bracketing mode, but producing a single image. EDriveModeBurstCamera captures a set of images as fast as it can, but in batches(bursts). EDriveModeContinuousCamera continuously captures images (as fast as it can) until stopped or out of ...EDriveModeSingleShotCamera takes a single image/shot. EDriveModeTimeLapseCamera captures a set of images with an uniform interval between them. EDriveModeTimedcamera captures a single shot after specified time period. EEPixelAspect10To11Pixel Ratio 10:11. EEPixelAspect11To10Pixel Ratio 11:10. EEPixelAspect16To11Pixel Ratio 16:11. EEPixelAspect40To33Pixel Ratio 40:33. EEPixelAspect59To54Pixel Ratio 59:54. EFocusModeAutoFocus is automatic, default. EFocusModeFixedFocus is fixed. EFocusModeManualFocus is manually set. EFocusModeUnknownFocus mode is unknown. EFocusRangeAutoAuto. Default EFocusRangeHyperfocalAll objects at distances from half of the hyperfocal distance out to infinity wi...EFocusRangeInfiniteWhen there is a near obstacle or better focus wanted for far away objects.EFocusRangeMacroFocus operates in close range (macro). EFocusRangeNormalNormal operation. EFocusRangePortraitFocus at larger areas at short to medium distance. EFocusRangeSuperMacroOptimised macro operation, where depth of field is very shallow and observation ...EFocusRangeTeleExtended (tele) operation. EISOAutoAperturePrioritisedCamera chooses the ISO on its own after prioritising aperture opening. EISOAutoISOPrioritisedCamera chooses the ISO on its own by prioritising ISO. EISOAutoShutterSpeedPrioritisedCamera chooses the ISO on its own after prioritising shutter speed. EISOAutoUnPrioritisedCamera chooses the ISO on its own without prioritising any particular exposure p...EISOManualCamera gives a list of manual ISO rates to the user to set. Recommendation is to...EISONoneISO Not supported. Camera uses a fixed ISO rate internally and never reveals thi...EMeteringModeAutoAutomatic mode, default. EMeteringModeCenterWeightedMetering in which the center is given a weighted priority. EMeteringModeEvaluativeMetering is evaluated over a matrix(several spots) and calculated as a function ...EMeteringModeSpotMetering of a central area/spot only, also known as partial. EModeClientViewFinderClient based Viewfinder runs EModeDSAViewFinderDSA based Viewfinder runs EModeIdleCamera is Idle EPCWBadFocuswarning to indicate that focussing is not optimum. This is valid for manual/fixe...EPCWDigiZoomBadQualitywarning to indicate that the desired digital zoom affects the quality of image EPCWFlashNotReadywarning to indicate that flash is not ready. Recommendation: user may subscribe ...EPCWGeneralWarningunknown reason EPCWHandShakePossiblewarning to indicate that camera might not be firmly gripped (Tripod required). T...EPCWLowLightwarning to indicate that camera operates under insufficient lightning conditions...EPCWNoneNo warnings EPCWNotEnoughPowerForFlashwarning to indicate that camera has not enough power to survive the flash operat...EPCWOverExposurewarning to indicate that camera sensor is over exposed EPCWUnderExposurewarning to indicate that camera sensor is under exposed EPCWWrongDigiZoomValuewarning to indicate that the current digital zoom value is not the desired one EPCWWrongFlashValuewarning to indicate that the current flash value is not the desired one EPCWWrongWhiteBalanceValuewarning to indicate that the current white balance is not the desired one EPictureOrientationLandscapeLandscape width larger than height. EPictureOrientationPortraitPortrait - height larger than width. EPictureOrientationSquareSquare width equals the height. EPictureOrientationUnknownNo information about picture orientation. EPixelAspect12To11Pixel Ratio 12:11 EPixelAspect1To1Pixel Ratio 1:1. EPixelAspectUnknownPixel ratio undetermined EStabilizationAutoStabilization effect is automatic, default. EStabilizationComplexityAutoStabilization algorithm selection is automatic, default. EStabilizationComplexityHighStabilization algorithm is of high complexity. EStabilizationComplexityLowStabilization algorithm is simple - less precise but fast. EStabilizationComplexityMediumStabilization algorithm is of medium complexity. EStabilizationFineStabilization effect is very small in magnitude. EStabilizationMediumStabilization effect is average in magnitude. EStabilizationModeAutoAutomatic stabilization. EStabilizationModeHorizontalStabilization only in horizontal direction. EStabilizationModeManualManual stabilization. EStabilizationModeOffNot present or switched off, default EStabilizationModeRotationRotational stabilization. EStabilizationModeVerticalStabilization only in vertical direction. EStabilizationOffStabilization effect is off. EStabilizationStrongStabilization effect is large in magnitude. EWBColorTemperatureThe white balance is represented as temperature degrees in Kelvin. EWBRgbThe white balance is represented as RGB triples. EWBUnknownThe units type is undetermined or not supported. EYuvRangeFullYuv Full Range. The nominal Y,U and V colours range is [0:255]. EYuvRangeUnknownYuv range undetermined EYuvRangeVideoCroppedYuv Cropped Range. The nominal Y range is [16:235] and the U and V ranges [16:24...ExposureCompensation()constGet the current exposure compensation steps. Positive values increase exposure t...ExposureCompensationStep()constGet current exposure compensation step.ExposureLockOn()constChecks whether exposure value is locked or not.ExposureMode()constGets the currently set exposure setting value.FlashCompensation()constGet the current flash compensation value as integer steps. Positive values boost...FlashCompensationStep()constGet current flash power compensation step.FlashMode()constGets the currently set flash mode.FocusDistance()constGet focus distance in millimetres.FocusMode()constGets current focus mode on the camera. The result is a valid TFocusMode value.FocusRange()constGets current focus range on the camera.GetAFAssistantLightL(TAFAssistantLight &)constGet the type ( and state) of AF assistant light currently set.GetActiveSettingsL(RArray< TUid > &)constGets an array of all the advanced settings parameters currently active on the ca...GetAperturesL(RArray< TInt > &,TValueInfo &)constGets the current discrete aperture steps (F-stops) supported by the camera.GetBracketMerge(TInt &,TInt &)constGets the settings for which frames to merge. Valid only in EDriveModeBracketMerg...GetCurrentFocusModeStepsL(RArray< TInt > &,TValueInfo &)constGet the number of focus steps for current focus mode.GetDigitalZoomStepsL(RArray< TInt > &,TValueInfo &)constGets the digital zoom levels.GetDisabledSettingsL(RArray< TUid > &)constGets an array of all the advanced settings parameters currently disabled on the ...GetExposureCompensation(TInt &)constGet the current exposure compensation steps. Positive values increase exposure t...GetExposureCompensationRangeInSteps(TInt &,TInt &)constGet current exposure compensation range in steps. It depends on the previously s...GetExposureCompensationStep(TInt &)constGet current exposure compensation step.GetExposureCompensationStepsL(RArray< TInt > &,TValueInfo &)constGet exposure compensation steps as integers multiplied by KECamFineResolutionFac...GetFlashCompensation(TInt &)constGet the current flash compensation value as integer steps. Positive values boost...GetFlashCompensationRangeInSteps(TInt &,TInt &)constGet current flash power compensation range measured in a already selected compen...GetFlashCompensationStep(TInt &)constGet current flash power compensation step.GetFlashCompensationStepsL(RArray< TInt > &,TValueInfo &)constGet flash compensation steps as integers multiplied by KECamFineResolutionFactor...GetISORateL(TISORateType &,TInt &,TInt &)constGet the type of ISO rate, exposure parameter and value set.GetManualFlashPowerLevelsL(RArray< TInt > &,TValueInfo &)constGets the current discrete manual flash power levels supported by the camera in r...GetMinFocalLength()constGet minimum focus distance in millimetresGetOpticalZoomStepsL(RArray< TInt > &,TValueInfo &)constGets the optical zoom levels.GetPreCaptureWarningL(TInt &)constGet the status of every warnings defined.GetPreCaptureWarningSupportedL(TCameraMode,TInt &)constRetrieves the pre capture warnings supported for a given camera modeGetShutterSpeedsL(RArray< TInt > &,TValueInfo &)constGets the set of supported shutter speeds.GetSupportedAFAssistantLightL(TInt &)constRetrieve the different supported AF assistant light.GetSupportedContinuousAutoFocusTimeoutsL(RArray< TInt > &,TValueInfo &)constRetrieves the timeout values camera supported by the camera when in continuous a...GetSupportedISORateTypeL(TInt &)constGets all supported ISO types on the device.GetSupportedIsoRatesL(RArray< TInt > &)constGets the set of camera supported ISO rates.GetSupportedSettingsL(RArray< TUid > &)constGets an array of all the advanced settings parameters supported by the camera. T...GetTimeLapse(TTime &,TTime &,TTime &)constGet current time lapse value. Active only when drive mode EDriveModeTimeLapse. T...GetTimeLapsePeriodRange(TTime &,TTime &)constGet camera supported time lapse period range. Active only when drive mode EDrive...GetTimerIntervalsL(RArray< TInt > &,TValueInfo &)constGet camera supported timer values. Active only when drive mode EDriveModeTimed. ...GetWBRgbValue(TRgb &)constGet white balance value represented as a RGB triplet.GetWBSupportedColorTemperaturesL(RArray< TInt > &,TValueInfo &)constGet the white balance values, as temperature measured in Kelvin, supported on th...IsCameraPresent()constChecks whether the current camera is present.IsCameraPresent(TInt)Checks whether the camera, denoted by its index, is currently present. The index...IsExternalFlashPresent()constCheck whether there is an external flash source.IsFlashReady(TBool &)constChecks whether the flash is ready.IsoRate()constGets current ISO rate.ManualFlashPowerLevel()constGets the current manual flash power level on the camera.MeteringMode()constGet current metering mode.NewL(CCamera &)Factory function for creating the CCamera::CCameraAdvancedSettings object.OpticalZoom()constGets the currently set zoom value.PictureOrientation()constGet current picture orientationPixelAspectRatio()constGet current pixel aspect ratio.RedEyeReduceOn()constGets whether the flash red eye reduction is switched on.SetAFAssistantLightL(TAFAssistantLight)Set a particular type ( and state) of AF assistant light.SetAperture(TInt)Set a new aperture value. All MCameraObserver2 clients of the camera receive a K...SetApertureExposureLockOn(TBool)Sets the current state for aperture and exposure lock. Triggers a KUidECamEventA...SetAutoFocusArea(TAutoFocusArea)Sets a specific auto focus area on the camera. Focus area change fires a KUidECa...SetAutoFocusLockOn(TBool)Sets autofocus lock state. Triggers a KUidECamEventCameraSettingAutoFocusLock ev...SetAutoFocusType(TAutoFocusType)Sets a specific auto focus type on the camera. The focus type change fires both,...SetAutomaticSizeSelectionChangeOn(TBool)Allow camera to proactively change image size due external factors. Default valu...SetBracketMerge(TInt,TInt)Sets the settings for which frames to merge. Valid only in EDriveModeBracketMerg...SetBracketMode(TBracketMode)Set new bracket mode. All MCameraObserver2 clients are notified with KUidECamEve...SetBracketParameter(TBracketParameter)Set new bracket parameter When set all clients are notified with KUidECamEventCa...SetBracketStep(TBracketStep)Set new bracket step. All MCameraObserver2 clients are notified with KUidECamEve...SetBurstImages(TInt)Set the number of images captured normally under EDriveModeBurst condition. Trig...SetContinuousAutoFocusTimeout(TInt)Sets the current value for continuous autofocus timeout. Timeouts are in microse...SetDigitalZoom(TInt)Sets the digital zoom value. Triggers a KUidECamEventCameraSettingDigitalZoom ev...SetDriveMode(TDriveMode)Set the current metering mode. When set all MCameraObserver2 clients are notifie...SetExposureCompensation(TInt)Set the current exposure compensation value as integer steps. Triggers a KUidECa...SetExposureCompensationStep(TInt)Set current exposure compensation step as an integer multiplied by KECamFineReso...SetExposureLockOn(TBool)Sets exposure lock state. Triggers a KUidECamEventCameraSettingExposureLock even...SetFlashCompensation(TInt)Set the current flash compensation value as integer steps. Positive values incre...SetFlashCompensationStep(TInt)Set current flash compensation step as an integer multiplied by KECamFineResolut...SetFocusDistance(TInt)Set focus distance in millimetres. Focus distance change fires a KUidECamEventCa...SetFocusMode(TFocusMode)Sets a specific focus mode on the camera. Focus mode change fires a KUidECamEven...SetFocusRange(TFocusRange)Sets a specific focus range on the camera. The focus range change fires both, KU...SetISORateL(TISORateType,TInt)Set the type of ISO rate and the exposure parameter or value specified.SetIsoRate(TInt)Set current ISO rate for the camera. Triggers KUidECamEventCameraSettingIsoRate ...SetManualFlashPowerLevel(TInt)Sets the current manual flash power level on the camera. Triggers a KUidECamEven...SetMeteringMode(TMeteringMode)Set the current metering mode. When set, all MCameraObserver2 clients are notifi...SetOpticalZoom(TInt)Sets the zoom using a specific value. Triggers a KUidECamEventCameraSettingOptic...SetPictureOrientation(TPictureOrientation)Set a new picture orientation This triggers a KUidECamEventCameraSettingPictureO...SetPixelAspectRatio(TPixelAspectRatio)Set a new pixel aspect ratio. This triggers a KUidECamEventPixelAspectRatio even...SetRedEyeReduceOn(TBool)Sets the flash red eye reduction on or off.SetReferenceScreenL(CWsScreenDevice &)Provide reference screen for orientation information.SetShootClickOn(TBool)Sets the button clicking sound on /off. Triggers a KUidECamEventSoundClick event...SetShutterSpeed(TInt)Sets the current shutter speed. When set, all MCameraObserver2 clients of the ca...SetStabilizationComplexity(TStabilizationAlgorithmComplexity)Sets a specific stabilization algorithm on the camera. When a value is set, MCam...SetStabilizationEffect(TStabilizationEffect)Sets a specific stabilization effect on the camera. When a value is set, MCamera...SetStabilizationMode(TStabilizationMode)Sets a specific stabilization mode on the camera.SetTimeLapse(const TTime &,const TTime &,const TTime &)Set current time lapse value. Active only when drive mode EDriveModeTimeLapse. T...SetTimerInterval(TInt)Set current timer value. Active only when drive mode EDriveModeTimed. This is th...SetWBColorTemperature(TInt)Set the white balance as a temperature in KelvinSetWBRgbValue(const TRgb &)Set white balance value using a RGB triplet. Change in value causes an event not...SetYuvRange(TYuvRange)Set a new YUV range. This triggers a KUidECamEventYuvRange event to all MCameraO...ShootClickOn()constGets the current state for button clicking sound effect.ShutterSpeed()constGets the current shutter speedStabilizationComplexity()constGets current active stabilization algorithm selection on the camera.StabilizationEffect()constGets all supported stabilization effects on the camera.StabilizationMode()constGets current stabilization mode on the camera. The result is a valid TStabilizat...SubscribeToPreCaptureWarningL(TInt)Subscribe in order to receive event which indicates warnings on occurrence of so...SupportedAutoFocusAreas()constGets all supported auto focus areas on the camera.SupportedAutoFocusTypes()constGets all supported auto focus types on the camera.SupportedBracketModes()constGet all supported bracket modes as bitfields.SupportedBracketParameters()constGet all supported bracket parameters as bitfields.SupportedBracketSteps()constGet all supported bracket steps as bitfields.SupportedDriveModes()constGet all supported drive modes as bitfields of TDriveMode type.SupportedExposureModes()constGet Supported exposure modes - bitfields of CCamera::TExposure
SupportedFlashModes()constGet camera all supported flash modes CCamera::TFlash
SupportedFocusModes()constGets all of the supported focus modes on the camera. The result is a bitfield of...SupportedFocusRanges()constGets all supported focus ranges on the camera.SupportedMeteringModes()constGet all supported metering modes on this camera represented as bitfield of type ...SupportedPixelAspectRatios()constGet supported pixel aspect ratio.SupportedStabilizationComplexityValues()constGets all supported stabilization algorithm values on the camera.SupportedStabilizationEffects()constGets the current stabilization effect on the camera.SupportedStabilizationModes()constGets all of the supported stabilization modes on the camera. The result is a bit...SupportedWBUnits()constGets the units in which the white balance is measured on the camera. SupportedWhiteBalanceModes()constGets camera supported set of white balance adjustments.SupportedYuvRanges()constGet supported YUV ranges.TAFAssistantLightSpecifies the different types of auto focus assistant lightTAutoFocusAreaSpecifies the autofocus area. TAutoFocusTypeSpecifies the supported autofocus types. TBracketModeSpecifies Bracket mode. TBracketParameterSupported parameters used for bracketing. TBracketStepSpecifies the magnitude of bracketing step. The actual value and availability is...TCameraModeDescribes the camera mode.TCameraTypeSpecifies camera type. TDriveModeSpecifies the drive mode for the camera. This determines how and in what sucessi...TFocusModeSupported focus modes. TFocusRangeSupported focus ranges. TISORateTypeSpecifies the ISO type supported by the camera. ISO refers to the sensivity of t...TMeteringModeSpecifies the Metering mode for the camera. EMeteringModeAuto is the default val...TPictureOrientationSpecifies the orientation of the picture. TPixelAspectRatioSpecifies the pixel aspect ratio TPreCaptureWarningSpecifies the unfavourable circumstances as pre capture warnings which may be is...TStabilizationAlgorithmComplexitySupported stabilization algorithms, graded on complexity. TStabilizationEffectSupported magnitudes of stabilization effect when in manual mode. TStabilizationModeSpecifies stabilization mode of the camera. TWBUnitsSpecifies the units supported by the camera for manual white balance setting.TYuvRangeSpecifies YUV colour space dynamic range. TimerInterval()constGet current timer value. Active only when drive mode is EDriveModeTimed. Timer r...UnSubscribePreCaptureWarningL()Unsubscribe so that further events are not received when warnings get issued.WBColorTemperature()constGet the white balance as a temperature in KelvinWhiteBalanceMode()constGets the current white balance value.YuvRange()constGet current YUV range.~CCameraAdvancedSettings()Destructor Inherited from CBase:
Delete(CBase *)Deletes the specified object.Extension_(TUint,TAny *&,TAny *)Extension function operator new(TUint)Allocates the object from the heap and then initialises its contents to binary z...operator new(TUint,TAny *)Initialises the object to binary zeroes.operator new(TUint,TLeave)Allocates the object from the heap and then initialises its contents to binary z...operator new(TUint,TLeave,TUint)Allocates the object from the heap and then initialises its contents to binary z...operator new(TUint,TUint)Allocates the object from the heap and then initialises its contents to binary z...NewL(CCamera &)IMPORT_C static CCameraAdvancedSettings* NewL(CCamera &aCamera);
Factory function for creating the CCamera::CCameraAdvancedSettings object.
Note: Clients using MCameraObserver are not recommended to use this extension class since they cannot handle events.
|
|
|
~CCameraAdvancedSettings()IMPORT_C ~CCameraAdvancedSettings();
Destructor
CameraType()constIMPORT_C TCameraType CameraType() const;
Gets the type of this camera.
|
CCamera::CCameraAdvancedSettings::TCameraTypeSpecifies camera type. CameraType(TInt)IMPORT_C TCameraType CameraType(TInt aCameraIndex);
Get the type of a specific camera denoted by its index. A pluggable camera may not necessarily be physically present. The type denotes whether the slot allocated to that index is for pluggable or onboard camera.
|
|
CCamera::CCameraAdvancedSettings::TCameraTypeSpecifies camera type. IsCameraPresent()constIMPORT_C TBool IsCameraPresent() const;
Checks whether the current camera is present.
|
IsCameraPresent(TInt)IMPORT_C TBool IsCameraPresent(TInt aCameraIndex);
Checks whether the camera, denoted by its index, is currently present. The index uniquely identifies the camera on the device.
|
|
CameraIndex()constIMPORT_C TInt CameraIndex() const;
Gets current camera index. The index uniquely identifies the camera on the device.
|
SupportedStabilizationModes()constIMPORT_C TInt SupportedStabilizationModes() const;
Gets all of the supported stabilization modes on the camera. The result is a bitfield of the valid TStabilizationMode flags.
|
CCamera::CCameraAdvancedSettings::TStabilizationModeSpecifies stabilization mode of the camera. StabilizationMode()constIMPORT_C TStabilizationMode StabilizationMode() const;
Gets current stabilization mode on the camera. The result is a valid TStabilizationMode value.
|
SetStabilizationMode(TStabilizationMode)IMPORT_C void SetStabilizationMode(TStabilizationMode aStabilizationMode);
Sets a specific stabilization mode on the camera.
Stabilization mode change fires a KUidECamEventCameraSettingStabilizationMode event to all MCameraObserver2 clients of this specific camera.
|
SupportedFocusModes()constIMPORT_C TInt SupportedFocusModes() const;
Gets all of the supported focus modes on the camera. The result is a bitfield of the valid TFocusMode flags.
|
CCamera::CCameraAdvancedSettings::TFocusModeSupported focus modes. FocusMode()constIMPORT_C TFocusMode FocusMode() const;
Gets current focus mode on the camera. The result is a valid TFocusMode value.
|
SetFocusMode(TFocusMode)IMPORT_C void SetFocusMode(TFocusMode aFocusMode);
Sets a specific focus mode on the camera. Focus mode change fires a KUidECamEventCameraSettingFocusMode event to all MCameraObserver2 clients of the camera.
|
SupportedFocusRanges()constIMPORT_C TInt SupportedFocusRanges() const;
Gets all supported focus ranges on the camera.
Note: if CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) is not used to create CCamera object, it is assumed that application is not prepared to receive extra added enum values. So, any extra enum value passed
from the implementation will be filtered at this point. To receive extra added enum values, application should rather use
CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values
|
FocusRange()constIMPORT_C TFocusRange FocusRange() const;
Gets current focus range on the camera.
Note: if CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) is not used to create CCamera object, it is assumed that application is not prepared to receive extra added enum values. So, any extra enum value received
from the implementation will be dropped and EFocusRangeAuto would be passed instead. To receive extra added enum values, application
should rather use CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values
|
SetFocusRange(TFocusRange)IMPORT_C void SetFocusRange(TFocusRange aFocusRange);
Sets a specific focus range on the camera. The focus range change fires both, KUidECamEventCameraSettingFocusRange and KUidECamEventCameraSettingFocusRange2
event to all MCameraObserver2 clients of the camera.
|
KUidECamEventCameraSettingFocusRangeFocus range. SupportedAutoFocusTypes()constIMPORT_C TInt SupportedAutoFocusTypes() const;
Gets all supported auto focus types on the camera.
|
AutoFocusType()constIMPORT_C TAutoFocusType AutoFocusType() const;
Gets current auto focus type on the camera.
|
CCamera::CCameraAdvancedSettings::TAutoFocusTypeSpecifies the supported autofocus types. SetAutoFocusType(TAutoFocusType)IMPORT_C void SetAutoFocusType(TAutoFocusType aAutoFocusType);
Sets a specific auto focus type on the camera. The focus type change fires both, KUidECamEventCameraSettingAutoFocusType and
KUidECamEventCameraSettingAutoFocusType2 event to all MCameraObserver2 clients of the camera.
|
KUidECamEventCameraSettingAutoFocusTypeAutofocus type. SupportedAutoFocusAreas()constIMPORT_C TInt SupportedAutoFocusAreas() const;
Gets all supported auto focus areas on the camera.
|
AutoFocusArea()constIMPORT_C TAutoFocusArea AutoFocusArea() const;
Gets current chosen auto focus area on the camera.
|
SetAutoFocusArea(TAutoFocusArea)IMPORT_C void SetAutoFocusArea(TAutoFocusArea aAutoFocusArea);
Sets a specific auto focus area on the camera. Focus area change fires a KUidECamEventCameraSettingAutoFocusArea event to
all MCameraObserver2 clients of the camera.
|
FocusDistance()constIMPORT_C TInt FocusDistance() const;
Get focus distance in millimetres.
|
SetFocusDistance(TInt)IMPORT_C void SetFocusDistance(TInt aDistance);
Set focus distance in millimetres. Focus distance change fires a KUidECamEventCameraSettingFocusDistance event to all MCameraObserver2 clients of the camera.
Note: KUidECamEvent2CameraSettingFocusDistance may be used to provide the focussing feedback as well. This means that the feedback will state whether the proper focussing has been achieved after setting the given focus distance.
|
GetMinFocalLength()constIMPORT_C TInt GetMinFocalLength() const;
Get minimum focus distance in millimetres
Note: Current Focal length is calculated as focalLength = opticalZoom * minFocalLength;
|
GetSupportedIsoRatesL(RArray< TInt > &)constIMPORT_C void GetSupportedIsoRatesL(RArray< TInt > &aSupportedIsoRates) const;
Gets the set of camera supported ISO rates.
Note: When camera device is incapable of revealing the ISO rates supported, it has to be assumed that camera will work only on the permanently set value. If this value is not known, empty array may be returned; corresponding getter/setters for this feature should not be used in such a case.
|
IsoRate()constIMPORT_C TInt IsoRate() const;
Gets current ISO rate.
Note: The returned value may be checked with the list of supported ISO rates. If value returned does not belong to this list, then it may be treated as an error case.
|
SetIsoRate(TInt)IMPORT_C void SetIsoRate(TInt aRate);
Set current ISO rate for the camera. Triggers KUidECamEventCameraSettingIsoRate to all MCameraObserver2 clients of the camera.
|
GetAperturesL(RArray< TInt > &,TValueInfo &)constIMPORT_C void GetAperturesL(RArray< TInt > &aFStops, TValueInfo &aInfo) const;
Gets the current discrete aperture steps (F-stops) supported by the camera.
Note: When camera device is incapable of revealing the aperture openings supported, it has to be assumed that camera will work only on the parmanently set value. If this value is not known, empty array may be returned and TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case.
|
|
Aperture()constIMPORT_C TInt Aperture() const;
Get current aperture value.
|
SetAperture(TInt)IMPORT_C void SetAperture(TInt aFStop);
Set a new aperture value. All MCameraObserver2 clients of the camera receive a KUidECamEventCameraSettingAperture event notification when aperture value is changed.
Note: The aperture parameter value is an integer, multiplied by KECamFineResolutionFactor. For example to set an aperture of F2.8, call SetAperture(280).
|
GetShutterSpeedsL(RArray< TInt > &,TValueInfo &)constIMPORT_C void GetShutterSpeedsL(RArray< TInt > &aShutterSpeeds, TValueInfo &aInfo) const;
Gets the set of supported shutter speeds.
Note: When camera device is incapable of revealing the shutter speeds supported, it has to be assumed that camera will work only on the parmanently set value. If this value is not known, empty array may be returned and TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case.
|
|
ShutterSpeed()constIMPORT_C TInt ShutterSpeed() const;
Gets the current shutter speed
|
SetShutterSpeed(TInt)IMPORT_C void SetShutterSpeed(TInt aShutterSpeed);
Sets the current shutter speed. When set, all MCameraObserver2 clients of the camera receive a KUidECamEventCameraSettingShutterSpeed event
|
SupportedMeteringModes()constIMPORT_C TInt SupportedMeteringModes() const;
Get all supported metering modes on this camera represented as bitfield of type TMeteringMode.
|
MeteringMode()constIMPORT_C TMeteringMode MeteringMode() const;
Get current metering mode.
|
SetMeteringMode(TMeteringMode)IMPORT_C void SetMeteringMode(TMeteringMode aMeteringMode);
Set the current metering mode. When set, all MCameraObserver2 clients are notified with a KUidECamEventCameraSettingMeteringMode event.
|
SupportedDriveModes()constIMPORT_C TInt SupportedDriveModes() const;
Get all supported drive modes as bitfields of TDriveMode type.
|
DriveMode()constIMPORT_C TDriveMode DriveMode() const;
Gets currently active drive mode.
|
SetDriveMode(TDriveMode)IMPORT_C void SetDriveMode(TDriveMode aDriveMode);
Set the current metering mode. When set all MCameraObserver2 clients are notified with KUidECamEventCameraSettingDriveMode.
Note: Unless reduced Latency scheme is not used (ie CaptureImageL(TInt aSequenceNumber) or StartPerformantVideoCaptureL()) if an image/video capture is still outstanding, this method may report error KErrInUse.
|
SupportedBracketModes()constIMPORT_C TInt SupportedBracketModes() const;
Get all supported bracket modes as bitfields.
|
BracketMode()constIMPORT_C TBracketMode BracketMode() const;
Get current bracket mode.
|
SetBracketMode(TBracketMode)IMPORT_C void SetBracketMode(TBracketMode aBracketMode);
Set new bracket mode. All MCameraObserver2 clients are notified with KUidECamEventCameraSettingBracketMode.
|
SupportedBracketParameters()constIMPORT_C TInt SupportedBracketParameters() const;
Get all supported bracket parameters as bitfields.
|
BracketParameter()constIMPORT_C TBracketParameter BracketParameter() const;
Get current bracket parameter.
|
SetBracketParameter(TBracketParameter)IMPORT_C void SetBracketParameter(TBracketParameter aBracketParameter);
Set new bracket parameter When set all clients are notified with KUidECamEventCameraSettingBracketParameter.
|
SupportedBracketSteps()constIMPORT_C TInt SupportedBracketSteps() const;
Get all supported bracket steps as bitfields.
|
BracketStep()constIMPORT_C TBracketStep BracketStep() const;
Get current bracket step.
|
SetBracketStep(TBracketStep)IMPORT_C void SetBracketStep(TBracketStep aBracketStep);
Set new bracket step. All MCameraObserver2 clients are notified with KUidECamEventCameraSettingBracketStep.
|
GetBracketMerge(TInt &,TInt &)constIMPORT_C void GetBracketMerge(TInt &aStartIndex, TInt &aFrames) const;
Gets the settings for which frames to merge. Valid only in EDriveModeBracketMerge mode.
Note: there must be at least two images to merge. All are assumed to form a sequence and are identified using the first frame index and number of frames e.g. to merge two frames - one on and one +1, when in EBracketMode3Image, one sets the start index to 1 and frames to two.
Note: It is very much TBracketMode setting dependent operation.
|
SetBracketMerge(TInt,TInt)IMPORT_C void SetBracketMerge(TInt aStartIndex, TInt aFrames);
Sets the settings for which frames to merge. Valid only in EDriveModeBracketMerge mode.
Note: there must be at least two images to merge. All are assumed to form a sequence and are identified using the first frame
index and number of frames e.g. to merge two frames - one on and one +1, when in EBracketMode3Image, one sets the start index
to 1 and frames to 2. MCameraObserver2 clients are notified with a KUidECamEventBracketMerge event.
Note: It is very TBracketMode setting dependent.
|
SupportedFlashModes()constIMPORT_C TInt SupportedFlashModes() const;
Get camera all supported flash modes CCamera::TFlash
Note: Some of the flash modes are available only for clients using either CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt)
|
CCamera::TFlashSpecifies the type of flash. FlashMode()constIMPORT_C CCamera::TFlash FlashMode() const;
Gets the currently set flash mode.
Note: Clients not using the CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) would be given CCamera::EFlashAuto if current flash mode exceeds CCamera::EFlashManual
|
CCamera::TFlashSpecifies the type of flash. SetFlashMode(CCamera::TFlash)IMPORT_C void SetFlashMode(CCamera::TFlash aMode);
Sets the flash mode.
Triggers a KUidECamEventCameraSettingFlashMode event to all camera MCameraObserver2 clients.
|
RedEyeReduceOn()constIMPORT_C TBool RedEyeReduceOn() const;
Gets whether the flash red eye reduction is switched on.
|
SetRedEyeReduceOn(TBool)IMPORT_C void SetRedEyeReduceOn(TBool aState);
Sets the flash red eye reduction on or off.
Triggers a KUidECamEventCameraSettingFlashRedEyeReduce event to all camera MCameraObserver2 clients.
|
GetFlashCompensationStepsL(RArray< TInt > &,TValueInfo &)constIMPORT_C void GetFlashCompensationStepsL(RArray< TInt > &aFlashCompensationSteps, TValueInfo &aInfo) const;
Get flash compensation steps as integers multiplied by KECamFineResolutionFactor. For example 0.5 EV is 50.
Note: When camera device doesn't support this, empty array may be returned and TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case.
Note: When camera device is incapable of revealing the flash compensation steps supported, it has to be assumed that camera will work only on the parmanently set value. If this value is not known, empty array may be returned and TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case.
|
|
FlashCompensationStep()const| Interface status: | deprecated | Use TInt GetFlashCompensationStep(TInt& aFlashCompensationStep); |
IMPORT_C TInt FlashCompensationStep() const;
Get current flash power compensation step.
|
GetFlashCompensationStep(TInt &)constIMPORT_C TInt GetFlashCompensationStep(TInt &aFlashCompensationStep) const;
Get current flash power compensation step.
Note: Use this method in place of deprecated TInt CCamera::CCameraAdvancedSettings::FlashCompensationStep()const
|
|
SetFlashCompensationStep(TInt)IMPORT_C void SetFlashCompensationStep(TInt aFlashCompensationStep);
Set current flash compensation step as an integer multiplied by KECamFineResolutionFactor. For example to set a compensation of -0.3 EV, one should use a parameter with value -30. All clients receive a KUidECamEventCameraSettingFlashCompensationStep event, when the value has changed.
|
GetFlashCompensationRangeInSteps(TInt &,TInt &)constIMPORT_C void GetFlashCompensationRangeInSteps(TInt &aNegativeCompensation, TInt &aPositiveCompensation) const;
Get current flash power compensation range measured in a already selected compensation step magnitude.
Note: This range may change if a different compensation step is selected. For example if flash compensation range is in the range -1EV 1.5EV and the selected flash compensation step is selected to be 0.3 EV, the result of this call will be aNegativeCompensation = -3 and aPositiveCompensation = 5. as there can be only three full steps for negative compensation (1/0.3) and five for flash power boost (1.5/0.3). In this way developers, having pre-selected a step value from the supported set, would need to provide just the multiplier (in steps) and the direction (the sign). Steps are always assumed integers.
|
FlashCompensation()const| Interface status: | deprecated | Use TInt GetFlashCompensation(TInt& aFlashCompensation); |
IMPORT_C TInt FlashCompensation() const;
Get the current flash compensation value as integer steps. Positive values boost flash power, negative reduce flash power. The change is not cumulative i.e. the change is stateless. Each call assumes no previous compensation has been performed i.e. that there is a zero compensation.
Note: if returned value is 2 (compensation steps) and the current flash compensation step is 0.3 EV, then the actual compensation effect will be 0.6 EV.
|
GetFlashCompensation(TInt &)constIMPORT_C TInt GetFlashCompensation(TInt &aFlashCompensation) const;
Get the current flash compensation value as integer steps. Positive values boost flash power, negative reduce flash power. The change is not cumulative i.e. the change is stateless. Each call assumes no previous compensation has been performed i.e. that there is a zero compensation.
Note: if retrieved value is 2 (compensation steps) and the current flash compensation step is 0.3 EV, then the actual compensation effect will be 0.6 EV.
Note: Use this method in place of deprecated TInt CCamera::CCameraAdvancedSettings::FlashCompensation()const
|
|
SetFlashCompensation(TInt)IMPORT_C void SetFlashCompensation(TInt aFlashCompensationInSteps);
Set the current flash compensation value as integer steps. Positive values increase power, negative reduce power. The change is not acumulative e.g. the change is stateless. Each call assumes no previous compensation has been performed i.e. that there is a zero compensation. Triggers a KUidECamEventCameraSettingFlashCompensation event.
|
IsExternalFlashPresent()constIMPORT_C TBool IsExternalFlashPresent() const;
Check whether there is an external flash source.
|
GetManualFlashPowerLevelsL(RArray< TInt > &,TValueInfo &)constIMPORT_C void GetManualFlashPowerLevelsL(RArray< TInt > &aManualFlashPowerLevels, TValueInfo &aInfo) const;
Gets the current discrete manual flash power levels supported by the camera in range 0-100 as a percentage of maximum power level.
Note: When camera device doesn't support this, empty array may be returned and TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case. When camera device is incapable of revealing the manual flash power levels supported, it has to be assumed that camera will work only on the permanently set value. If this value is not known, empty array may be returned and TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case.
|
|
ManualFlashPowerLevel()constIMPORT_C TInt ManualFlashPowerLevel() const;
Gets the current manual flash power level on the camera.
|
SetManualFlashPowerLevel(TInt)IMPORT_C void SetManualFlashPowerLevel(TInt aManualFlashPowerLevel);
Sets the current manual flash power level on the camera. Triggers a KUidECamEventCameraSettingFlashManualPower event to all
MCameraObserver2 clients.
|
SupportedExposureModes()constIMPORT_C TInt SupportedExposureModes() const;
Get Supported exposure modes - bitfields of CCamera::TExposure
|
ExposureMode()constIMPORT_C CCamera::TExposure ExposureMode() const;
Gets the currently set exposure setting value.
|
SetExposureMode(CCamera::TExposure)IMPORT_C void SetExposureMode(CCamera::TExposure aExposureMode);
Sets the exposure mode of the camera. Triggers a KUidECamEventCameraSettingExposureMode event to all MCameraObserver2 clients.
|
GetExposureCompensationStepsL(RArray< TInt > &,TValueInfo &)constIMPORT_C void GetExposureCompensationStepsL(RArray< TInt > &aExposureCompensationSteps, TValueInfo &aInfo) const;
Get exposure compensation steps as integers multiplied by KECamFineResolutionFactor. For example 0.3 EV is 30.
Note: When camera device doesn't support this, empty array may be returned and TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case. When camera device is incapable of revealing the exposure compensation steps supported, it has to be assumed that camera will work only on the permanently set value. If this value is not known, empty array may be returned and TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case.
|
|
ExposureCompensationStep()const| Interface status: | deprecated | Use TInt GetExposureCompensationStep(TInt& aExposureCompensationStep); |
IMPORT_C TInt ExposureCompensationStep() const;
Get current exposure compensation step.
|
GetExposureCompensationStep(TInt &)constIMPORT_C TInt GetExposureCompensationStep(TInt &aExposureCompensationStep) const;
Get current exposure compensation step.
Note: Use this method in place of deprecated TInt CCamera::CCameraAdvancedSettings::ExposureCompensationStep()const
|
|
SetExposureCompensationStep(TInt)IMPORT_C void SetExposureCompensationStep(TInt aExposureCompensationStep);
Set current exposure compensation step as an integer multiplied by KECamFineResolutionFactor. All MCameraObserver2 clients receive a KUidECamEventCameraSettingExposureCompensationStep event, when the value has changed.
|
GetExposureCompensationRangeInSteps(TInt &,TInt &)constIMPORT_C void GetExposureCompensationRangeInSteps(TInt &aNegativeCompensation, TInt &aPositiveCompensation) const;
Get current exposure compensation range in steps. It depends on the previously selected exposure compensation step.
|
CCamera::CCameraAdvancedSettings::GetFlashCompensationRangeInSteps(TInt &,TInt &)constGet current flash power compensation range measured in a already selected compen...ExposureCompensation()const| Interface status: | deprecated | Use TInt GetExposureCompensation(TInt& aExposureCompensation); |
IMPORT_C TInt ExposureCompensation() const;
Get the current exposure compensation steps. Positive values increase exposure times, negative reduce exposure times. The change is not cumulative i.e. the change is stateless. Each call assumes no previous compensation has been performed i.e. that there is a zero compensation.
Note: if returned value is 2 (compensation steps) and the current exposure compensation step is 0.3 EV, then the actual compensation effect will be 0.6 EV.
|
GetExposureCompensation(TInt &)constIMPORT_C TInt GetExposureCompensation(TInt &aExposureCompensation) const;
Get the current exposure compensation steps. Positive values increase exposure times, negative reduce exposure times. The change is not cumulative i.e. the change is stateless. Each call assumes no previous compensation has been performed i.e. that there is a zero compensation.
Note: if retrieved value is 2 (compensation steps) and the current exposure compensation step is 0.3 EV, then the actual compensation effect will be 0.6 EV.
Note: Use this method in place of deprecated TInt CCamera::CCameraAdvancedSettings::ExposureCompensation()const
|
|
SetExposureCompensation(TInt)IMPORT_C void SetExposureCompensation(TInt aExposureCompensationInSteps);
Set the current exposure compensation value as integer steps. Triggers a KUidECamEventCameraSettingExposureCompensation event
to all MCameraObserver2 clients.
|
SupportedWhiteBalanceModes()constIMPORT_C TInt SupportedWhiteBalanceModes() const;
Gets camera supported set of white balance adjustments.
Note: if CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) is not used to create CCamera object, it is assumed that application is not prepared to receive extra added enum values. So, any extra enum value(unrecognised)
passed from the implementation will be filtered at this point. To receive extra added enum values, application should rather
use CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values
|
WhiteBalanceMode()constIMPORT_C CCamera::TWhiteBalance WhiteBalanceMode() const;
Gets the current white balance value.
Note: if CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) is not used to create CCamera object, it is assumed that application is not prepared to receive extra added enum values. So, any extra enum value(unrecognised)
received from the implementation will be dropped and EWBAuto would be passed instead. To receive extra added enum values,
application should rather use CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values
|
SetWhiteBalanceMode(CCamera::TWhiteBalance)IMPORT_C void SetWhiteBalanceMode(CCamera::TWhiteBalance aWhiteBalanceMode);
Sets the white balance adjustment of the camera.
No effect if this is not supported, see TCameraInfo::iWhiteBalanceModesSupported. Triggers KUidECamEventCameraSettingWhiteBalanceMode event to all MCameraObserver2 clients.
|
ApertureExposureLockOn()constIMPORT_C TBool ApertureExposureLockOn() const;
Gets the current state for aperture and exposure lock.
|
SetApertureExposureLockOn(TBool)IMPORT_C void SetApertureExposureLockOn(TBool aAELock);
Sets the current state for aperture and exposure lock. Triggers a KUidECamEventAELock event to all MCameraObserver2 clients.
|
ShootClickOn()constIMPORT_C TBool ShootClickOn() const;
Gets the current state for button clicking sound effect.
|
SetShootClickOn(TBool)IMPORT_C void SetShootClickOn(TBool aShootClickOn);
Sets the button clicking sound on /off. Triggers a KUidECamEventSoundClick event to all MCameraObserver2 clients.
|
GetTimerIntervalsL(RArray< TInt > &,TValueInfo &)constIMPORT_C void GetTimerIntervalsL(RArray< TInt > &aTimerIntervals, TValueInfo &aInfo) const;
Get camera supported timer values. Active only when drive mode EDriveModeTimed. Time is in microseconds. As time interval is expected to be relatively short, integer value is considered sufficient.
Note: When camera device doesn't support this, empty array may be returned and TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case.
|
TimerInterval()constIMPORT_C TInt TimerInterval() const;
Get current timer value. Active only when drive mode is EDriveModeTimed. Timer resolution is in microseconds.
|
SetTimerInterval(TInt)IMPORT_C void SetTimerInterval(TInt aTimerInterval);
Set current timer value. Active only when drive mode EDriveModeTimed. This is the time interval (delay) in microseconds between
user pressing the button and image is taken. The setting of the value triggers a KUidECamEventCameraSettingTimerInterval event
to all MCameraObserver2 clients.
|
GetTimeLapsePeriodRange(TTime &,TTime &)constIMPORT_C void GetTimeLapsePeriodRange(TTime &aTimeLapseMin, TTime &aTimeLapseMax) const;
Get camera supported time lapse period range. Active only when drive mode EDriveModeTimeLapse. The time lapse is denoted as the uniform time period between consecutive frames.
|
GetTimeLapse(TTime &,TTime &,TTime &)constIMPORT_C void GetTimeLapse(TTime &aStart, TTime &aEnd, TTime &aInterval) const;
Get current time lapse value. Active only when drive mode EDriveModeTimeLapse. The time lapse is denoted as the uniform time period between consecutive frames and operation is configurable by its start, end and a fixed interval.
|
SetTimeLapse(const TTime &,const TTime &,const TTime &)IMPORT_C void SetTimeLapse(const TTime &aStart, const TTime &aEnd, const TTime &aInterval);
Set current time lapse value. Active only when drive mode EDriveModeTimeLapse. The time lapse is denoted as the uniform time
period between consecutive frames. Setting triggers a KUidECamEventCameraSettingTimeLapse event to all MCameraObserver2 camera clients.
|
PictureOrientation()constIMPORT_C TPictureOrientation PictureOrientation() const;
Get current picture orientation
|
SetPictureOrientation(TPictureOrientation)IMPORT_C void SetPictureOrientation(TPictureOrientation aOrientation);
Set a new picture orientation This triggers a KUidECamEventCameraSettingPictureOrientation event to all MCameraObserver2 clients.
|
SupportedPixelAspectRatios()constIMPORT_C TInt SupportedPixelAspectRatios() const;
Get supported pixel aspect ratio.
Note: Some of the pixel aspect ratios are available only for clients using either CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt)
Mask out new features for old clients
|
PixelAspectRatio()constIMPORT_C TPixelAspectRatio PixelAspectRatio() const;
Get current pixel aspect ratio.
Note: Some of the pixel aspect ratios are available only for clients using either CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt)
Mask out new features for old clients
|
SetPixelAspectRatio(TPixelAspectRatio)IMPORT_C void SetPixelAspectRatio(TPixelAspectRatio aPixelAspectRatio);
Set a new pixel aspect ratio. This triggers a KUidECamEventPixelAspectRatio event to all MCameraObserver2 clients.
|
SupportedYuvRanges()constIMPORT_C TInt SupportedYuvRanges() const;
Get supported YUV ranges.
|
YuvRange()constIMPORT_C TYuvRange YuvRange() const;
Get current YUV range.
|
SetYuvRange(TYuvRange)IMPORT_C void SetYuvRange(TYuvRange aYuvRange);
Set a new YUV range. This triggers a KUidECamEventYuvRange event to all MCameraObserver2 clients.
|
BurstImages()constIMPORT_C TInt BurstImages() const;
Get the number of images captured normally under EDriveModeBurst condition.
Note: : due to memory or image size limitations the actual number may be less.
|
SetBurstImages(TInt)IMPORT_C void SetBurstImages(TInt aImages);
Set the number of images captured normally under EDriveModeBurst condition. Triggers a KUidECamEventBurstImages event to all
MCameraObserver2 clients.
Note: : due to memory or image size limitations the actual number may be less.
Note: Unless reduced Latency scheme is not used (ie CaptureImageL(TInt aSequenceNumber) or StartPerformantVideoCaptureL()) if an image/video capture is still outstanding, this method may report error KErrInUse.
|
GetOpticalZoomStepsL(RArray< TInt > &,TValueInfo &)constIMPORT_C void GetOpticalZoomStepsL(RArray< TInt > &aOpticalZoomSteps, TValueInfo &aInfo) const;
Gets the optical zoom levels.
Note: Such approach allows for support for both linear and non-linear zoom steps. When camera device doesn't support this, empty array may be returned and TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case.
|
|
OpticalZoom()constIMPORT_C TInt OpticalZoom() const;
Gets the currently set zoom value.
|
SetOpticalZoom(TInt)IMPORT_C void SetOpticalZoom(TInt aOpticalZoom);
Sets the zoom using a specific value. Triggers a KUidECamEventCameraSettingOpticalZoom event to all MCameraObserver2 clients.
|
GetDigitalZoomStepsL(RArray< TInt > &,TValueInfo &)constIMPORT_C void GetDigitalZoomStepsL(RArray< TInt > &aDigitalZoomSteps, TValueInfo &aInfo) const;
Gets the digital zoom levels.
Note: Such approach allows for support for both linear and non-linear zoom steps. When camera device doesn't support this, empty array may be returned and TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case.
|
|
DigitalZoom()constIMPORT_C TInt DigitalZoom() const;
Gets the currently set digital zoom value.
|
SetDigitalZoom(TInt)IMPORT_C void SetDigitalZoom(TInt aDigitalZoom);
Sets the digital zoom value. Triggers a KUidECamEventCameraSettingDigitalZoom event to all MCameraObserver2 clients.
|
ExposureLockOn()constIMPORT_C TBool ExposureLockOn() const;
Checks whether exposure value is locked or not.
|
SetExposureLockOn(TBool)IMPORT_C void SetExposureLockOn(TBool aState);
Sets exposure lock state. Triggers a KUidECamEventCameraSettingExposureLock event to all MCameraObserver2 clients.
|
AutoFocusLockOn()constIMPORT_C TBool AutoFocusLockOn() const;
Checks whether AutoFocus value is locked or not.
|
SetAutoFocusLockOn(TBool)IMPORT_C void SetAutoFocusLockOn(TBool aState);
Sets autofocus lock state. Triggers a KUidECamEventCameraSettingAutoFocusLock event to all MCameraObserver2 clients.
|
GetSupportedSettingsL(RArray< TUid > &)constIMPORT_C void GetSupportedSettingsL(RArray< TUid > &aSettings) const;
Gets an array of all the advanced settings parameters supported by the camera. These are identified by UIDs and relate to the set or subset of it of all defined settings UIDs.
Note: if CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) is not used to create CCamera object, it is assumed that application is not prepared to receive extra added uid values (new settings added). So, any extra
uid value passed from the implementation will be filtered at this point. To receive extra added uid values, application should
rather use CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values
KUidECamEventCameraSettingAutoFocusType2UidValue is the baseline. Any settings with greater uid value means that it has been added in later versions
|
|
GetActiveSettingsL(RArray< TUid > &)constIMPORT_C void GetActiveSettingsL(RArray< TUid > &aActiveSettings) const;
Gets an array of all the advanced settings parameters currently active on the camera. These are identified by UIDs and relate to the set or subset of it of all supported settings UIDs.
Note: if CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) is not used to create CCamera object, it is assumed that application is not prepared to receive extra added uid values (new settings added). So, any extra
uid value passed from the implementation will be filtered at this point. To receive extra added uid values, application should
rather use CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values
KUidECamEventCameraSettingAutoFocusType2UidValue is the baseline. Any settings with greater uid value means that it has been added in later versions
|
|
GetDisabledSettingsL(RArray< TUid > &)constIMPORT_C void GetDisabledSettingsL(RArray< TUid > &aDisabledSettings) const;
Gets an array of all the advanced settings parameters currently disabled on the camera. These are identified by UIDs and relate to the set or subset of it of all supported settings UIDs.
Note: if CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) is not used to create CCamera object, it is assumed that application is not prepared to receive extra added uid values (new settings added). So, any extra
uid value passed from the implementation will be filtered at this point. To receive extra added uid values, application should
rather use CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values
KUidECamEventCameraSettingAutoFocusType2UidValue is the baseline. Any settings with greater uid value means that it has been added in later versions
|
|
AutomaticSizeSelectionChangeOn()constIMPORT_C TBool AutomaticSizeSelectionChangeOn() const;
Retrieves the state for automatic size selection option. Default value is EFalse.
|
SetAutomaticSizeSelectionChangeOn(TBool)IMPORT_C void SetAutomaticSizeSelectionChangeOn(TBool aSetOn);
Allow camera to proactively change image size due external factors. Default value is EFalse. Triggers a KUidECamEventCameraSettingAutomaticSizeSelection event notification.
|
GetSupportedContinuousAutoFocusTimeoutsL(RArray< TInt > &,TValueInfo &)constIMPORT_C void GetSupportedContinuousAutoFocusTimeoutsL(RArray< TInt > &aTimeouts, TValueInfo &aInfo) const;
Retrieves the timeout values camera supported by the camera when in continuous auto focus mode. Timeouts are in microseconds.
Note: When camera device doesn't support this, empty array may be returned and TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case.
|
|
ContinuousAutoFocusTimeout()constIMPORT_C TInt ContinuousAutoFocusTimeout() const;
Gets the current value for continuous autofocus timeout. Timeouts are in microseconds.
|
SetContinuousAutoFocusTimeout(TInt)IMPORT_C void SetContinuousAutoFocusTimeout(TInt aTimeout);
Sets the current value for continuous autofocus timeout. Timeouts are in microseconds. All MCameraObserver2 clients of the camera receive a KUidECamEventCameraSettingsContinuousAutoFocusTimeout event notification when timeout value
is changed.
|
SupportedStabilizationEffects()constIMPORT_C TInt SupportedStabilizationEffects() const;
Gets the current stabilization effect on the camera.
|
StabilizationEffect()constIMPORT_C TStabilizationEffect StabilizationEffect() const;
Gets all supported stabilization effects on the camera.
|
SetStabilizationEffect(TStabilizationEffect)IMPORT_C void SetStabilizationEffect(TStabilizationEffect aEffect);
Sets a specific stabilization effect on the camera. When a value is set, MCameraObserver2 clients for that camera will receive a KUidECamEventCameraSettingsStabilizationEffect event notification.
|
SupportedStabilizationComplexityValues()constIMPORT_C TInt SupportedStabilizationComplexityValues() const;
Gets all supported stabilization algorithm values on the camera.
|
StabilizationComplexity()constIMPORT_C TStabilizationAlgorithmComplexity StabilizationComplexity() const;
Gets current active stabilization algorithm selection on the camera.
|
SetStabilizationComplexity(TStabilizationAlgorithmComplexity)IMPORT_C void SetStabilizationComplexity(TStabilizationAlgorithmComplexity aComplexity);
Sets a specific stabilization algorithm on the camera. When a value is set, MCameraObserver2 clients for that camera will receive a KUidECamEventSettingsStabilizationAlgorithmComplexity event notification.
|
SupportedWBUnits()constIMPORT_C TWBUnits SupportedWBUnits() const;
Gets the units in which the white balance is measured on the camera.
Note: The methods used to get or set these differ depending on the supported unit type. It is expected that a camera will support only a single type or none.
|
GetWBRgbValue(TRgb &)constIMPORT_C void GetWBRgbValue(TRgb &aValue) const;
Get white balance value represented as a RGB triplet.
|
TRgb24-bit RGB colour value with 8 bits each for red, green and blue.SetWBRgbValue(const TRgb &)IMPORT_C void SetWBRgbValue(const TRgb &aValue);
Set white balance value using a RGB triplet. Change in value causes an event notification KUidECamEventCameraSettingsWBValue
to be sent to all MCameraObserver2 clients of this camera.
|
TRgb24-bit RGB colour value with 8 bits each for red, green and blue.GetWBSupportedColorTemperaturesL(RArray< TInt > &,TValueInfo &)constIMPORT_C void GetWBSupportedColorTemperaturesL(RArray< TInt > &aWBColorTemperatures, TValueInfo &aInfo) const;
Get the white balance values, as temperature measured in Kelvin, supported on the camera.
Note: When camera device doesn't support this, empty array may be returned and TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case.
|
WBColorTemperature()constIMPORT_C TInt WBColorTemperature() const;
Get the white balance as a temperature in Kelvin
|
SetWBColorTemperature(TInt)IMPORT_C void SetWBColorTemperature(TInt aWBColorTemperature);
Set the white balance as a temperature in Kelvin
|
IsFlashReady(TBool &)constIMPORT_C TInt IsFlashReady(TBool &aReady) const;
Checks whether the flash is ready.
|
|
GetCurrentFocusModeStepsL(RArray< TInt > &,TValueInfo &)constIMPORT_C void GetCurrentFocusModeStepsL(RArray< TInt > &aFocusModeSteps, TValueInfo &aInfo) const;
Get the number of focus steps for current focus mode.
Note: When camera device doesn't support this, empty array may be returned and TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case.
|
|
GetSupportedISORateTypeL(TInt &)constIMPORT_C void GetSupportedISORateTypeL(TInt &aSupportedISORateTypes) const;
Gets all supported ISO types on the device.
Note: When concrete implementation is provided, but camera device does not support this feature, then aSupportedISORateTypes retrieves EISONone.
|
|
SetISORateL(TISORateType,TInt)IMPORT_C void SetISORateL(TISORateType aISORateType, TInt aParam);
Set the type of ISO rate and the exposure parameter or value specified.
Note: Triggers KUidECamEventCameraSettingIsoRateType to all MCameraObserver2 clients of the camera. HandleEvent is used to report the result or any possible error. New setter functions leave only when
implementation is not there.
|
|
GetISORateL(TISORateType &,TInt &,TInt &)constIMPORT_C void GetISORateL(TISORateType &aISORateType, TInt &aParam, TInt &aISORate) const;
Get the type of ISO rate, exposure parameter and value set.
Note: When concrete implementation is provided, but camera device does not support this feature, then aISORateType retrieves EISONone.
Note: Since camera hardware may be incapable of providing the actual ISO value when one of the auto ISO type has been set, then, in these cases, the 3rd argument is retrieved as KErrNotFound.
|
|
SetReferenceScreenL(CWsScreenDevice &)IMPORT_C void SetReferenceScreenL(CWsScreenDevice &aScreenDevice);
Provide reference screen for orientation information.
Note: Triggers KUidECamEventCameraSettingReferenceScreen to all MCameraObserver2 clients of the camera. HandleEvent is used to report the result or any possible error. New setter functions leave only when
implementation is not there.
|
|
GetDigitalZoomStepsForStillL(RArray< TInt > &,TValueInfo &,TInt,CCamera::TFormat,TBool &)constIMPORT_C void GetDigitalZoomStepsForStillL(RArray< TInt > &aDigitalZoomSteps, TValueInfo &aInfo, TInt aSizeIndex, CCamera::TFormat
aFormat, TBool &aIsInfluencePossible) const;
Get the digital zoom steps for the still image when a particular image format and size are specified.
Note: This method retrieves the supported digital zoom steps irrespective of any stabilization influence. In case of stabilization etc. influence, the setting function should set the best possible digital zoom value and return error KErrECamDigitalZoomLimited along with dedicated event.
Note: When concrete implementation is provided, but camera device does not support this feature, empty array may be returned and TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case.
|
|
GetDigitalZoomStepsForVideoL(RArray< TInt > &,TValueInfo &,TInt,TInt,CCamera::TFormat,TBool &,CCamera::TExposure)constIMPORT_C void GetDigitalZoomStepsForVideoL(RArray< TInt > &aDigitalZoomSteps, TValueInfo &aInfo, TInt aFrameRateIndex, TInt
aSizeIndex, CCamera::TFormat aFormat, TBool &aIsInfluencePossible, CCamera::TExposure aExposure) const;
Get the digital zoom steps for the video when a particular video frame format, size and rate are specified.
Note: This method retrieves the supported digital zoom steps irrespective of any stabilization influence. In case of stabilization etc. influence, the setting function should set the best possible digital zoom value and return error KErrECamDigitalZoomLimited along with dedicated event.
Note: When concrete implementation is provided, but camera device does not support this feature, empty array may be returned and TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case.
|
|
GetPreCaptureWarningSupportedL(TCameraMode,TInt &)constIMPORT_C void GetPreCaptureWarningSupportedL(TCameraMode aCameraMode, TInt &aPreCaptureWarningSupported) const;
Retrieves the pre capture warnings supported for a given camera mode
|
|
SubscribeToPreCaptureWarningL(TInt)IMPORT_C void SubscribeToPreCaptureWarningL(TInt aPreCaptureWarning);
Subscribe in order to receive event which indicates warnings on occurrence of some specific unfavourable conditions before image/video capture.
Note: When any of the subscribed warnings (represented by aPreCaptureWarning) get generated by the camera device, event KUidECamEventCameraSettingPreCaptureWarning
is issued. TECAMEvent2 class should be used in order to provide the status of every PreCaptureWarning.
|
|
UnSubscribePreCaptureWarningL()IMPORT_C void UnSubscribePreCaptureWarningL();
Unsubscribe so that further events are not received when warnings get issued.
|
GetPreCaptureWarningL(TInt &)constIMPORT_C void GetPreCaptureWarningL(TInt &aPreCaptureWarning) const;
Get the status of every warnings defined.
Note: This method may be called after receiving the event KUidECamEventCameraSettingPreCaptureWarning OR user may also opt for polling on this.
|
|
GetSupportedAFAssistantLightL(TInt &)constIMPORT_C void GetSupportedAFAssistantLightL(TInt &aSupportedAFAssistantLight) const;
Retrieve the different supported AF assistant light.
Note: When concrete implementation is provided, but camera device does not support this feature, then aSupportedAFAssistantLight retrieves EAFAssistantLightOff. Corresponding getter/setters for this feature should not be called then.
|
|
GetAFAssistantLightL(TAFAssistantLight &)constIMPORT_C void GetAFAssistantLightL(TAFAssistantLight &aAFAssistantLight) const;
Get the type ( and state) of AF assistant light currently set.
|
|
SetAFAssistantLightL(TAFAssistantLight)IMPORT_C void SetAFAssistantLightL(TAFAssistantLight aAFAssistantLight);
Set a particular type ( and state) of AF assistant light.
Note: Triggers KUidECamEventCameraSettingAFAssistantLight to all MCameraObserver2 clients of the camera. HandleEvent is used to report the result or any possible error. New setter functions leave only when
implementation is not there.
|
|
TCameraTypeTCameraType
Specifies camera type.
|
TStabilizationModeTStabilizationMode
Specifies stabilization mode of the camera.
|
TStabilizationEffectTStabilizationEffect
Supported magnitudes of stabilization effect when in manual mode.
|
TStabilizationAlgorithmComplexityTStabilizationAlgorithmComplexity
Supported stabilization algorithms, graded on complexity.
|
TFocusModeTFocusMode
Supported focus modes.
|
TFocusRangeTFocusRange
Supported focus ranges.
|
TAutoFocusTypeTAutoFocusType
Specifies the supported autofocus types.
|
TAutoFocusAreaTAutoFocusArea
Specifies the autofocus area.
|
TMeteringModeTMeteringMode
Specifies the Metering mode for the camera. EMeteringModeAuto is the default value.
|
TDriveModeTDriveMode
Specifies the drive mode for the camera. This determines how and in what sucession are images shot. EDriveModeSingleShot is the default.
|
TBracketModeTBracketMode
Specifies Bracket mode.
|
TBracketParameterTBracketParameter
Supported parameters used for bracketing.
Note: Bracket mode parameter value changes by a selected uniform step between successive image shots.
CCamera::CCameraAdvancedSettings::TBracketStepSpecifies the magnitude of bracketing step. The actual value and availability is...CCamera::CCameraAdvancedSettings::TBracketModeSpecifies Bracket mode.
|
TBracketStepTBracketStep
Specifies the magnitude of bracketing step. The actual value and availability is parameter dependent.
CCamera::CCameraAdvancedSettings::TBracketParameterSupported parameters used for bracketing.
|
TPictureOrientationTPictureOrientation
Specifies the orientation of the picture.
|
TPixelAspectRatioTPixelAspectRatio
Specifies the pixel aspect ratio
Note: It is specified as a fraction of (x) horizontal pixel size divided by vertical (y) pixel size. The pixel aspect ratio for square pixels is 1/1.
|
TYuvRangeTYuvRange
Specifies YUV colour space dynamic range.
Note: video compressors often use narrower than the default range. The nominal Y range is [16:235] and the U and V ranges [16:240].
|
TWBUnitsTWBUnits
Specifies the units supported by the camera for manual white balance setting.
|
TISORateTypeTISORateType
Specifies the ISO type supported by the camera. ISO refers to the sensivity of the image sensor and is one of the factors influencing the exposure.
|
TPreCaptureWarningTPreCaptureWarning
Specifies the unfavourable circumstances as pre capture warnings which may be issued before image/video capture.
|
TCameraModeTCameraMode
Describes the camera mode.
|
TAFAssistantLightTAFAssistantLight
Specifies the different types of auto focus assistant light
|
class CCameraPresets : public CBase;
This API is used to simplify user - camera interaction by allowing simultaneous setting of various advanced camera hardware settings using a single parameter.
Preset is identified by a single UID and relates to a known predefined outcome. For example the 'Night' Preset will be used to set the camera into a night mode so that the user can take night photos.
The particular set of settings associated with the specific preset and their specific values and ranges are camera hardware specific and outside the scope of this API.
Note: This class is not intended for sub-classing and used to standardise existing varieties of implementations.
Note: If the class methods leave, the output type parameter value is not guaranteed to be valid.
CBase -
Base class for all classes to be instantiated on the heap.
CCamera::CCameraPresets - This API is used to simplify user - camera interaction by allowing simultaneous ...
Defined in CCamera::CCameraPresets:
GetAffectedSettingsL(RArray< TUid > &)constGet all settings affected by the current preset. This is to say that all setting...GetAssociatedSettingsL(TUid,RArray< TUid > &)constGet all settings associated with a specific preset, identified by a UID. This fu...GetSupportedPresetsL(RArray< TUid > &)constGets the presets supported by the camera. These are identified by UIDs and relat...NewL(CCamera &)Factory function for creating the CCamera::CCameraPresets object.Preset()constGets the current preset set on the camera.SetPreset(TUid)Sets a specific preset supported by the device. All clients, implementing the MC...~CCameraPresets()Destructor Inherited from CBase:
Delete(CBase *)Deletes the specified object.Extension_(TUint,TAny *&,TAny *)Extension function operator new(TUint)Allocates the object from the heap and then initialises its contents to binary z...operator new(TUint,TAny *)Initialises the object to binary zeroes.operator new(TUint,TLeave)Allocates the object from the heap and then initialises its contents to binary z...operator new(TUint,TLeave,TUint)Allocates the object from the heap and then initialises its contents to binary z...operator new(TUint,TUint)Allocates the object from the heap and then initialises its contents to binary z...NewL(CCamera &)IMPORT_C static CCameraPresets* NewL(CCamera &aCamera);
Factory function for creating the CCamera::CCameraPresets object.
Note: Clients using MCameraObserver are not recommended to use this extension class since they cannot handle events.
|
|
|
~CCameraPresets()IMPORT_C ~CCameraPresets();
Destructor
GetSupportedPresetsL(RArray< TUid > &)constIMPORT_C void GetSupportedPresetsL(RArray< TUid > &aPresets) const;
Gets the presets supported by the camera. These are identified by UIDs and relate to a known predefined outcome. The settings associated with a particular preset and their specific values and ranges are specific to each type of camera hardware and are therefore not defined by the API.
Note: if CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) is not used to create CCamera object, it is assumed that application is not prepared to receive extra added uid values (new presets added). So, any extra
uid value(unrecognised) passed from the implementation will be filtered at this point. To receive extra added uid values,
application should rather use CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values.
Note: Any preset uid, if added in future, has to have a uid value greater than KUidECamPresetFactoryDefaultUidValue otherwise unrecognized preset uids could not be checked.
|
|
SetPreset(TUid)IMPORT_C void SetPreset(TUid aPreset);
Sets a specific preset supported by the device. All clients, implementing the MCameraObserver2 interface will receive a notification with the UID of the specific preset, signalling a new preset has been selected.
|
Preset()constIMPORT_C TUid Preset() const;
Gets the current preset set on the camera.
Note: if CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) is not used to create CCamera object, it is assumed that application is not prepared to receive extra added uid values (new presets added). So, any extra
uid(unrecognised) value received from the implementation will be mapped to KUidECamPresetFactoryDefault at this point. To
receive extra added uid values, application should rather use CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values
|
GetAffectedSettingsL(RArray< TUid > &)constIMPORT_C void GetAffectedSettingsL(RArray< TUid > &aSettings) const;
Get all settings affected by the current preset. This is to say that all settings which are related to the preset in question will be included in the list, even though the value might not have changed.
Note: if CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) is not used to create CCamera object, it is assumed that application is not prepared to receive extra added uid values (new settings added). So, any extra
uid value passed from the implementation will be filtered at this point. To receive extra added uid values, application should
rather use CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values
|
|
GetAssociatedSettingsL(TUid,RArray< TUid > &)constIMPORT_C void GetAssociatedSettingsL(TUid aPreset, RArray< TUid > &aSettings) const;
Get all settings associated with a specific preset, identified by a UID. This function does not require a preset to have been
set prior the call as in CCamera::CCameraPresets::GetAffectedSettingsL(RArray< TUid > &)const function. The returned array will contain the UIDs of all settings which are associated and potentially affected by that
particular preset.
Note: if CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) is not used to create CCamera object, it is assumed that application is not prepared to receive extra added uid values (new settings added). So, any extra
uid value passed from the implementation will be filtered at this point. To receive extra added uid values, application should
rather use CCamera::New2L(MCameraObserver2 &,TInt,TInt) or CCamera::NewDuplicate2L(MCameraObserver2 &,TInt) to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values
|
|
|
|
TFormat
Possible still image and video frame formats
Formats are read from left to right, starting at the top of the image. YUV format is as defined by ITU-R BT.601-4.
|
TContrast
Specifies whether contrast is set automatically.
|
TBrightness
Specifies whether brightness is set automatically.
|
TFlash
Specifies the type of flash.
|
TExposure
Specifies the type of exposure. - EExposureAuto is the default value.
|
TWhiteBalance
Specifies how the white balance is set.
|
|
Copyright © 2005-2008 Symbian Software Ltd. |
|
![[Previous]](../../../../a_stock/images/btn_prev.gif)
![[Top]](../../../../a_stock/images/btn_top.gif)
![[Next]](../../../../a_stock/images/btn_next.gif)