![Symbian Developer Library](../../../../a_stock/images/mainheading.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()const
Gets the currently set brightness adjustment value.BuffersInUse()const
Gets the number of buffers currently in use.CCameraAdvancedSettings
...CCameraDirectViewFinder
...CCameraImageProcessing
This class is used to perform image processing operations on the camera. These i...CCameraOverlay
This class provides support for image overlays. The client can use it to overlay...CCameraPresets
This API is used to simplify user - camera interaction by allowing simultaneous ...CameraInfo(TCameraInfo &)const
Gets 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()const
Gets the currently set contrast value.CustomInterface(TUid)
Gets a custom interface. The client has to cast the returned pointer to the appr...DigitalZoomFactor()const
Gets the currently set digital zoom factor.EBrightnessAuto
Sets the brightness automatically. EContrastAuto
Sets the contrast automatically. EExposureAperturePriority
Aperture setting is given priority. EExposureAuto
Set exposure automatically. Default, always supported. EExposureBacklight
Backlight setting for bright backgrounds. EExposureBeach
Beach setting for daylight exposure with reflective glare. EExposureCenter
Centered mode for ignoring surroundings. EExposureInfra
Exposure for infra-red sensor on the camera EExposureManual
User selectable exposure value setting. EExposureNight
Night-time setting for long exposures. EExposureProgram
Programmed exposure setting. EExposureShutterPriority
Shutter speed setting is given priority. EExposureSnow
Snow setting for daylight exposure. EExposureSport
Sport setting for very short exposures. EExposureSuperNight
Exposure night setting with colour removed to get rid of colour noise. EExposureVeryLong
Generalised setting for very long exposures. EFlashAuto
Flash will automatically fire when required. EFlashFillIn
Reduced flash for general lighting EFlashForced
Flash will always fire. EFlashManual
User configurable setting EFlashNone
No flash, always supported. EFlashRedEyeReduce
Red-eye reduction mode. EFlashSlowFrontSync
Flash at the moment when shutter opens. EFlashSlowRearSync
Flash at the moment when shutter closes. EFlashVideoLight
Constant emission of light during video mode EFormat16BitRGB565
Packed RGB triplets, 5 bits per pixel for red and blue and 6 bits for green, wit...EFormat16bitRGB444
Packed RGB triplets, 4 bits per pixel with red in the least significant bits and...EFormat32BitRGB888
Packed RGB triplets, 8 bits per pixel with red in the least significant bits and...EFormatExif
EXIF JPEG EFormatFbsBitmapColor16M
CFbsBitmap object with display mode EColor16M. EFormatFbsBitmapColor16MU
CFbsBitmap object with display mode EColor16MU. EFormatFbsBitmapColor4K
CFbsBitmap object with display mode EColor4K. EFormatFbsBitmapColor64K
CFbsBitmap object with display mode EColor64K. EFormatJpeg
JFIF JPEG. EFormatMonochrome
8 bit greyscale values, 0=black, 255=white. EFormatUserDefined
Implementation dependent. EFormatYUV420Interleaved
4:2:0 format, 8 bits per sample, Y00Y01Y10Y11UV. EFormatYUV420Planar
4:2:0 format, 8 bits per sample, Y00Y01Y02Y03...U0...V0... EFormatYUV420SemiPlanar
4:2:0 format, 8 bits per sample, Y00Y01Y02Y03...U0V0... EFormatYUV422
4:2:2 format, 8 bits per sample, UY0VY1. EFormatYUV422Reversed
4:2:2 format, 8 bits per sample, Y1VY0U. EFormatYUV444
4:4:4 format, 8 bits per sample, Y00U00V00 Y01U01V01... EWBAuto
Set white balance automatically. Default, always supported. EWBAutoSkin
auto skinEWBBeach
High contrast daylight primarily near the sea EWBCloudy
Overcast daylight. EWBDaylight
Normal daylight. EWBDaylightUnderWater
Daylight Under WaterEWBFlash
Flash lighting. EWBFluorescent
Fluorescent tube lighting EWBHorizon
horizonEWBManual
User configurable mode EWBShade
Shade EWBSnow
High contrast daylight primarily snowy EWBTungsten
Tungsten filament lighting. EnumerateCaptureSizes(TSize &,TInt,TFormat)const
Enumerates through the available image capture sizes, based on the specified siz...EnumerateVideoFrameRates(TReal32 &,TInt,TFormat,TInt,TExposure)const
Enumerates through the available video frame rates, based on the specified rate ...EnumerateVideoFrameSizes(TSize &,TInt,TFormat)const
Enumerates through the available video frame sizes, based on the specified size ...Exposure()const
Gets the currently set exposure setting value.Flash()const
Gets the currently set flash mode.FrameRate()const
Gets the frame rate currently in use.FramesPerBuffer()const
Gets the number of frames per buffer currently in use.GetFrameSize(TSize &)const
Gets the frame size currently in use.Handle()
Gets the device-unique handle of this camera object.JpegQuality()const
Gets 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.TBrightness
Specifies whether brightness is set automatically. TContrast
Specifies whether contrast is set automatically. TExposure
Specifies the type of exposure. - EExposureAuto is the default value. TFlash
Specifies the type of flash. TFormat
Possible still image and video frame formatsTWhiteBalance
Specifies how the white balance is set. VideoCaptureActive()const
Tests whether video capture is active.ViewFinderActive()const
Queries whether the view finder is active.ViewFinderMirror()const
Gets whether view finder mirroring is active.WhiteBalance()const
Gets the currently set white balance adjustment value.ZoomFactor()const
Gets 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.
|
CCamera::CCameraAdvancedSettings::FlashMode()const
Gets 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()const
Gets 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
:
EViewFinderActive
View Finder is activated EViewFinderInActive
View Finder has been stopped or hasn't yet started. Default state. EViewFinderPause
View Finder has been paused NewL(CCamera &)
Factory function for creating the CCamera::CCameraDirectViewFinder object.PauseViewFinderDirectL()
Pauses the direct viewfinderResumeViewFinderDirectL()
Resumes the direct viewfinderTViewFinderState
Specifies direct viewfinder state. ViewFinderState()const
Gets 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()const
IMPORT_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...TViewFinderState
TViewFinderState
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...EBinary
Supports only binary blending. If alpha value is 0xFF, it is opaque, otherwise t...EBinaryDynamic
Supports only dynamic binary blending - allows values to be changed when overlay...EBlendNone
Does not support blending. EFullRange
Full support for blending - all values in the range [0:255]. EFullRangeDynamic
Full support for dynamic blending - all values in the range [0:255]EModeClientViewfinder
The image is to be overlaid on client-based viewfinder EModeDirectViewfinder
The image is to be overlaid on direct viewfinder EModeNone
Overlays are not supported for any camera mode. EModeSnapshot
The image can be overlaid on a snapshot. The camera has snapshot functionality s...EModeStillImage
The image can be overlaid on captured images. The camera is in still image mode....EModeStillImageBracket
The image is to be overlaid when Still Image Bracketing driving mode is active. EModeStillImageBracketMerge
The image is to be overlaid when Still Image Bracketing with Merge option drivin...EModeStillImageBurst
The image is to be overlaid when Still Image Burst driving mode is active. EModeStillImageContinuous
The image is to be overlaid when Continuous Still Image driving mode is active. EModeStillImageTimeLapse
The image is to be overlaid when Timed Still Image with Lapse option driving mod...EModeStillImageTimed
The image is to be overlaid when Timed Still Image driving mode is active. EModeVideo
The image can be overlaid on a video frame. The camera is in video mode. EModeViewfinder
The image can be overlaid on a viewfinder. The camera is displaying directly to ...EOverlayNone
Does not support overlays. EPerPixel
Blending is on a per pixel basis, where the alpha value information is provided ...EPerPlane
Blending 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.TBlendingType
Blending typesTOverlayCameraMode
Overlay camera mode typesTOverlayType
Overlay 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.
|
|
TOverlayCameraMode
TOverlayCameraMode
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.
|
TOverlayType
TOverlayType
Overlay types
Type in which alpha value will be provided.
|
TBlendingType
TBlendingType
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 RArray
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::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.EEffectCine
Cine visual effect.EEffectColorAccent
Where a list of color can be kept as they are and the rest converted to gray.EEffectColorSwap
Color swap visual effect.EEffectEmboss
Emboss visual effect. EEffectLowSharpening
Selective sharpening visual effect. EEffectMonochrome
Black and white visual effect. EEffectNatural
Natural visual effect.EEffectNegative
Negative visual effect. EEffectNeutral
Neutral colour visual effect. EEffectNone
Effects off is default, always supported EEffectOldFilm
Old film visual effect.EEffectRedEyeReduction
Red eye glare reduction visual effect. EEffectSepia
Sepia visual effect. EEffectSolarize
Solarization visual effect. EEffectVivid
Vivid colour visual effect. EGammaAuto
Sets the gamma adjustment automatically. EGlareReductionBasic
most basic glare reduction. EGlareReductionNone
Default value. Glare reduction disabled. EHueAuto
Sets the hue adjustment automatically. EMirrorBoth
Mirror along horizontal and vertical axis. EMirrorHorizontal
Mirror along horizontal axis. EMirrorNone
Default value. Mirroring is disabled. EMirrorVertical
Mirror along vertical axis. ENoiseReductionBasic
most basic noise reduction. ENoiseReductionNone
Default value. Noise reduction disabled. ERepresentationMultiple
The given color represents a group of colors ERepresentationNone
Feature is not supported ERepresentationSingle
The given color is uniquely represented ERgbGroupingAutomatic
This means neighbourhood colors are to be automatically decided by the implement...ERgbGroupingFixed
This means no neighbourhood colors are considered ERgbGroupingNone
Feature is not supported ERgbGroupingSignificantBits
This means neighbourhood colors for source have to be decided by ignoring few st...ERgbGroupingUniform
This means colors in target are obtained as some uniform proportion using source...ESaturationAuto
Sets the saturation adjustment automatically. ESharpnessAuto
Sets the sharpness adjustment automatically. GetActiveTransformSequenceL(RArray< TUid > &)const
Get the sequence of all active transforms, ordered in order of execution.GetActiveTransformationsL(RArray< TUid > &)const
Get currently active transformations on the camera.GetColorAccentCapabilitiesL(TInt,TColorOperationCapabilities &)const
Retrieves the color accent capabilites per entry, if different entries have diff...GetColorAccentEntryL(TInt,TColorOperationEntry &)const
Get the details of the color accent entry corresponding to the given indexGetColorSwapCapabilitiesL(TInt,TColorOperationCapabilities &)const
Retrieves the color swapping capabilites per entry, if different entries have di...GetColorSwapEntryL(TInt,TColorOperationEntry &)const
Get the details of the color swap entry corresponding to the given indexGetConcurrentColorAccentSupportedL(TInt &)const
Retrieves the maximum number of color entries on which simultaneous color accent...GetConcurrentColorSwappingsSupportedL(TInt &)const
Retrieves the maximum number of simultaneous color swapping possible.GetSourceRect(TRect &)const
Get the source rectangle for KUidECamEventImageProcessingTransformScale or KUidE...GetSupportedTransformationsL(RArray< TUid > &)const
Get all transformations supported on the camera.GetTransformationSupportedValuesL(TUid,RArray< TInt > &,TValueInfo &)const
Get all values supported by an active transformation.GetTransformationValue(TUid,TInt &)const
Get 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...TBitsIgnore
Class used to control the number of bits to ignore for Red, Green, Blue or Alpha...TColorOperationCapabilities
Color operation capabilities characterizing both color swap and color accent fea...TColorOperationEntry
Color operation parameters characterizing both color swap and color accent featu...TColorOperationRepresentation
Used for color swap and color accent feature in TEffect. It describes whether th...TColorOperationRgbGroupingMode
Used for color swap and color accent feature in TEffect. It describes the type o...TEffect
Settings for the supported effects TGamma
Gamma settings TGlareReduction
Glare reduction settings THue
Hue Settings TMirror
Mirror settings TNoiseReduction
Noise filter settings TSaturation
Saturation Settings TSharpness
Sharpness Settings TransformationValue(TUid)const
Get 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 > &)const
IMPORT_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 > &)const
IMPORT_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 &)const
IMPORT_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 &)const
IMPORT_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 > &)const
IMPORT_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 &)const
IMPORT_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 &)const
IMPORT_C void GetConcurrentColorSwappingsSupportedL(TInt &aConcurrentColorSwappingSupported) const;
Retrieves the maximum number of simultaneous color swapping possible.
|
|
GetColorSwapCapabilitiesL(TInt,TColorOperationCapabilities &)const
IMPORT_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 &)const
IMPORT_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 &)const
IMPORT_C void GetConcurrentColorAccentSupportedL(TInt &aConcurrentColorAccentSupported) const;
Retrieves the maximum number of color entries on which simultaneous color accent process is possible.
|
|
GetColorAccentCapabilitiesL(TInt,TColorOperationCapabilities &)const
IMPORT_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 &)const
IMPORT_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.
|
TColorOperationCapabilities
class TColorOperationCapabilities;
Color operation capabilities characterizing both color swap and color accent feature
Defined in CCamera::CCameraImageProcessing::TColorOperationCapabilities
:
Size()const
Returns the size of the class. Used for extensibility by deriving from this base...TColorOperationCapabilities()
Constructor. Sets the size of this class in iSize.Version()const
Returns the version of the class. Used for extensibility specially when the clas...iIsCapabilityUniform
This indicates whether the mapping mode and Rgb grouping mode uniform for every ...iSupportedSourceRepresentation
The source color representation that the server supports. The supported represen...iSupportedSourceRgbGroupingMode
The source color Rgb grouping modes that the server supports. The modes are held...iSupportedTargetRepresentation
The target color representation that the server supports. The supported represen...iSupportedTargetRgbGroupingMode
The 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()const
IMPORT_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()const
IMPORT_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.
|
iSupportedSourceRepresentation
TUint 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.
iSupportedTargetRepresentation
TUint 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
iSupportedSourceRgbGroupingMode
TUint 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.
iSupportedTargetRgbGroupingMode
TUint 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
iIsCapabilityUniform
TBool iIsCapabilityUniform;
This indicates whether the mapping mode and Rgb grouping mode uniform for every color entry
TBitsIgnore
class 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()const
Returns the size of the class. Used for extensibility by deriving from this base...TBitsIgnore()
Constructor. Sets the size of this class in iSize.Version()const
Returns the version of the class. Used for extensibility specially when the clas...iAlphaBitsIgnore
This gives the no. of bits to ignore for Alpha. Varies from 0 to 8. Any other va...iBlueBitsIgnore
This gives the no. of bits to ignore for Blue color. Varies from 0 to 8. Any oth...iGreenBitsIgnore
This gives the no. of bits to ignore for Green color. Varies from 0 to 8. Any ot...iRedBitsIgnore
This 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()const
IMPORT_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()const
IMPORT_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.
|
iRedBitsIgnore
TUint iRedBitsIgnore;
This gives the no. of bits to ignore for Red color. Varies from 0 to 8. Any other value should be an error
iGreenBitsIgnore
TUint iGreenBitsIgnore;
This gives the no. of bits to ignore for Green color. Varies from 0 to 8. Any other value should be an error
iBlueBitsIgnore
TUint iBlueBitsIgnore;
This gives the no. of bits to ignore for Blue color. Varies from 0 to 8. Any other value should be an error
iAlphaBitsIgnore
TUint iAlphaBitsIgnore;
This gives the no. of bits to ignore for Alpha. Varies from 0 to 8. Any other value should be an error
TColorOperationEntry
class TColorOperationEntry;
Color operation parameters characterizing both color swap and color accent feature; and for a particular entry.
Defined in CCamera::CCameraImageProcessing::TColorOperationEntry
:
Size()const
Returns the size of the class. Used for extensibility by deriving from this base...TColorOperationEntry()
Constructor. Sets the size of this class in iSize.Version()const
Returns the version of the class. Used for extensibility specially when the clas...iColorOperationSourceRgbGroupingMode
This defines the type of grouping for multiple representation of source color iColorOperationTargetRgbGroupingMode
This defines the type of grouping for multiple representation of target color in...iEntryStatus
This gives the entry status of every color operation entry. If entry is not set ...iNumBitsIgnored
This gives the number of bits to ignore in case ERgbGroupingSignificantBits is u...iSourceColor
The source color (rgb triplet) which is changed to target color in case of Color...iSourceColorRepresentation
This defines whether the given source color represents itself or a group of colo...iTargetColor
The target color (rgb triplet) which replaces the source color in case of Color ...iTargetColorRepresentation
This 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()const
IMPORT_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()const
IMPORT_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.
|
iSourceColor
TRgb 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
iTargetColor
TRgb iTargetColor;
The target color (rgb triplet) which replaces the source color in case of Color Swap operation. Redundant for Color Accent operation
iSourceColorRepresentation
TColorOperationRepresentation iSourceColorRepresentation;
This defines whether the given source color represents itself or a group of colors
iTargetColorRepresentation
TColorOperationRepresentation 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
iColorOperationSourceRgbGroupingMode
TColorOperationRgbGroupingMode iColorOperationSourceRgbGroupingMode;
This defines the type of grouping for multiple representation of source color
iColorOperationTargetRgbGroupingMode
TColorOperationRgbGroupingMode iColorOperationTargetRgbGroupingMode;
This defines the type of grouping for multiple representation of target color in case of Color Swap operation. Redundant for Color Accent operation
iNumBitsIgnored
TBitsIgnore 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
iEntryStatus
TValueInfo 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
TGamma
TGamma
Gamma settings
|
TSharpness
TSharpness
Sharpness Settings
|
TSaturation
TSaturation
Saturation Settings
|
THue
THue
Hue Settings
|
TEffect
TEffect
Settings for the supported effects
|
TMirror
TMirror
Mirror settings
|
TNoiseReduction
TNoiseReduction
Noise filter settings
|
TGlareReduction
TGlareReduction
Glare reduction settings
|
TColorOperationRepresentation
TColorOperationRepresentation
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.
|
TColorOperationRgbGroupingMode
TColorOperationRgbGroupingMode
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()const
Get current aperture value.ApertureExposureLockOn()const
Gets the current state for aperture and exposure lock.AutoFocusArea()const
Gets current chosen auto focus area on the camera.AutoFocusLockOn()const
Checks whether AutoFocus value is locked or not.AutoFocusType()const
Gets current auto focus type on the camera. AutomaticSizeSelectionChangeOn()const
Retrieves the state for automatic size selection option. Default value is EFalse...BracketMode()const
Get current bracket mode.BracketParameter()const
Get current bracket parameter.BracketParameterAperture
Aperture settings change. BracketParameterAutoFocus
Autofocus settings change. BracketStep()const
Get current bracket step.BurstImages()const
Get the number of images captured normally under EDriveModeBurst condition. CameraIndex()const
Gets current camera index. The index uniquely identifies the camera on the devic...CameraType()const
Gets the type of this camera. CameraType(TInt)
Get the type of a specific camera denoted by its index. A pluggable camera may n...ContinuousAutoFocusTimeout()const
Gets the current value for continuous autofocus timeout. Timeouts are in microse...DigitalZoom()const
Gets the currently set digital zoom value.DriveMode()const
Gets currently active drive mode.EAFAssistantLightAuto
Put the AF assistant light in auto mode. It will be automatically decided when t...EAFAssistantLightManualOn
switch on the AF assistant light manually EAFAssistantLightOff
switch off the AF assistant light from either of 'manual on' or 'auto' mode EAutoFocusTypeAuto
Automatic. Default value EAutoFocusTypeContinuous
Continious autofocus, more precise but consumes more power. also known as AF Ser...EAutoFocusTypeMultiAreaCentered
Multiple points of an object, more weighting for centre points. EAutoFocusTypeOff
Autofocus is switched off. EAutoFocusTypeSingle
Operates on a single shot, consumes less power. EAutoFocusTypeSingleArea
Single area, suitable for relatively flat surfaces and portrait. EBracketMode3Image
Bracket mode on. Three consecutive pictures are taken in order under (-1), on (0...EBracketMode5Image
Bracket mode on. Five consecutive pictures are taken in order under (-2),under (...EBracketModeOff
Bracket mode is switched off. Default value. EBracketParameterColourBalance
Colour balance settings change. EBracketParameterExposure
Exposure settings change. EBracketParameterFlashPower
Flash power change. EBracketParameterNone
None. EBracketStepLarge
Large value. EBracketStepMedium
Medium value. EBracketStepNonConfig
Not supported. EBracketStepSmall
Small value. ECameraOnBoard
Camera is non-detachable from device. Camera is always present. ECameraPluggable
Camera is detachable from device. Camera is not always present. ECameraUnknown
Unable to identify. EDriveModeAuto
Automatic. Default EDriveModeBracket
Camera is in bracketing mode, producing individual frames. EDriveModeBracketMerge
Camera is in bracketing mode, but producing a single image. EDriveModeBurst
Camera captures a set of images as fast as it can, but in batches(bursts). EDriveModeContinuous
Camera continuously captures images (as fast as it can) until stopped or out of ...EDriveModeSingleShot
Camera takes a single image/shot. EDriveModeTimeLapse
Camera captures a set of images with an uniform interval between them. EDriveModeTimed
camera captures a single shot after specified time period. EEPixelAspect10To11
Pixel Ratio 10:11. EEPixelAspect11To10
Pixel Ratio 11:10. EEPixelAspect16To11
Pixel Ratio 16:11. EEPixelAspect40To33
Pixel Ratio 40:33. EEPixelAspect59To54
Pixel Ratio 59:54. EFocusModeAuto
Focus is automatic, default. EFocusModeFixed
Focus is fixed. EFocusModeManual
Focus is manually set. EFocusModeUnknown
Focus mode is unknown. EFocusRangeAuto
Auto. Default EFocusRangeHyperfocal
All objects at distances from half of the hyperfocal distance out to infinity wi...EFocusRangeInfinite
When there is a near obstacle or better focus wanted for far away objects.EFocusRangeMacro
Focus operates in close range (macro). EFocusRangeNormal
Normal operation. EFocusRangePortrait
Focus at larger areas at short to medium distance. EFocusRangeSuperMacro
Optimised macro operation, where depth of field is very shallow and observation ...EFocusRangeTele
Extended (tele) operation. EISOAutoAperturePrioritised
Camera chooses the ISO on its own after prioritising aperture opening. EISOAutoISOPrioritised
Camera chooses the ISO on its own by prioritising ISO. EISOAutoShutterSpeedPrioritised
Camera chooses the ISO on its own after prioritising shutter speed. EISOAutoUnPrioritised
Camera chooses the ISO on its own without prioritising any particular exposure p...EISOManual
Camera gives a list of manual ISO rates to the user to set. Recommendation is to...EISONone
ISO Not supported. Camera uses a fixed ISO rate internally and never reveals thi...EMeteringModeAuto
Automatic mode, default. EMeteringModeCenterWeighted
Metering in which the center is given a weighted priority. EMeteringModeEvaluative
Metering is evaluated over a matrix(several spots) and calculated as a function ...EMeteringModeSpot
Metering of a central area/spot only, also known as partial. EModeClientViewFinder
Client based Viewfinder runs EModeDSAViewFinder
DSA based Viewfinder runs EModeIdle
Camera is Idle EPCWBadFocus
warning to indicate that focussing is not optimum. This is valid for manual/fixe...EPCWDigiZoomBadQuality
warning to indicate that the desired digital zoom affects the quality of image EPCWFlashNotReady
warning to indicate that flash is not ready. Recommendation: user may subscribe ...EPCWGeneralWarning
unknown reason EPCWHandShakePossible
warning to indicate that camera might not be firmly gripped (Tripod required). T...EPCWLowLight
warning to indicate that camera operates under insufficient lightning conditions...EPCWNone
No warnings EPCWNotEnoughPowerForFlash
warning to indicate that camera has not enough power to survive the flash operat...EPCWOverExposure
warning to indicate that camera sensor is over exposed EPCWUnderExposure
warning to indicate that camera sensor is under exposed EPCWWrongDigiZoomValue
warning to indicate that the current digital zoom value is not the desired one EPCWWrongFlashValue
warning to indicate that the current flash value is not the desired one EPCWWrongWhiteBalanceValue
warning to indicate that the current white balance is not the desired one EPictureOrientationLandscape
Landscape width larger than height. EPictureOrientationPortrait
Portrait - height larger than width. EPictureOrientationSquare
Square width equals the height. EPictureOrientationUnknown
No information about picture orientation. EPixelAspect12To11
Pixel Ratio 12:11 EPixelAspect1To1
Pixel Ratio 1:1. EPixelAspectUnknown
Pixel ratio undetermined EStabilizationAuto
Stabilization effect is automatic, default. EStabilizationComplexityAuto
Stabilization algorithm selection is automatic, default. EStabilizationComplexityHigh
Stabilization algorithm is of high complexity. EStabilizationComplexityLow
Stabilization algorithm is simple - less precise but fast. EStabilizationComplexityMedium
Stabilization algorithm is of medium complexity. EStabilizationFine
Stabilization effect is very small in magnitude. EStabilizationMedium
Stabilization effect is average in magnitude. EStabilizationModeAuto
Automatic stabilization. EStabilizationModeHorizontal
Stabilization only in horizontal direction. EStabilizationModeManual
Manual stabilization. EStabilizationModeOff
Not present or switched off, default EStabilizationModeRotation
Rotational stabilization. EStabilizationModeVertical
Stabilization only in vertical direction. EStabilizationOff
Stabilization effect is off. EStabilizationStrong
Stabilization effect is large in magnitude. EWBColorTemperature
The white balance is represented as temperature degrees in Kelvin. EWBRgb
The white balance is represented as RGB triples. EWBUnknown
The units type is undetermined or not supported. EYuvRangeFull
Yuv Full Range. The nominal Y,U and V colours range is [0:255]. EYuvRangeUnknown
Yuv range undetermined EYuvRangeVideoCropped
Yuv Cropped Range. The nominal Y range is [16:235] and the U and V ranges [16:24...ExposureCompensation()const
Get the current exposure compensation steps. Positive values increase exposure t...ExposureCompensationStep()const
Get current exposure compensation step.ExposureLockOn()const
Checks whether exposure value is locked or not.ExposureMode()const
Gets the currently set exposure setting value.FlashCompensation()const
Get the current flash compensation value as integer steps. Positive values boost...FlashCompensationStep()const
Get current flash power compensation step.FlashMode()const
Gets the currently set flash mode.FocusDistance()const
Get focus distance in millimetres.FocusMode()const
Gets current focus mode on the camera. The result is a valid TFocusMode value.FocusRange()const
Gets current focus range on the camera.GetAFAssistantLightL(TAFAssistantLight &)const
Get the type ( and state) of AF assistant light currently set.GetActiveSettingsL(RArray< TUid > &)const
Gets an array of all the advanced settings parameters currently active on the ca...GetAperturesL(RArray< TInt > &,TValueInfo &)const
Gets the current discrete aperture steps (F-stops) supported by the camera.GetBracketMerge(TInt &,TInt &)const
Gets the settings for which frames to merge. Valid only in EDriveModeBracketMerg...GetCurrentFocusModeStepsL(RArray< TInt > &,TValueInfo &)const
Get the number of focus steps for current focus mode.GetDigitalZoomStepsL(RArray< TInt > &,TValueInfo &)const
Gets the digital zoom levels.GetDisabledSettingsL(RArray< TUid > &)const
Gets an array of all the advanced settings parameters currently disabled on the ...GetExposureCompensation(TInt &)const
Get the current exposure compensation steps. Positive values increase exposure t...GetExposureCompensationRangeInSteps(TInt &,TInt &)const
Get current exposure compensation range in steps. It depends on the previously s...GetExposureCompensationStep(TInt &)const
Get current exposure compensation step.GetExposureCompensationStepsL(RArray< TInt > &,TValueInfo &)const
Get exposure compensation steps as integers multiplied by KECamFineResolutionFac...GetFlashCompensation(TInt &)const
Get the current flash compensation value as integer steps. Positive values boost...GetFlashCompensationRangeInSteps(TInt &,TInt &)const
Get current flash power compensation range measured in a already selected compen...GetFlashCompensationStep(TInt &)const
Get current flash power compensation step.GetFlashCompensationStepsL(RArray< TInt > &,TValueInfo &)const
Get flash compensation steps as integers multiplied by KECamFineResolutionFactor...GetISORateL(TISORateType &,TInt &,TInt &)const
Get the type of ISO rate, exposure parameter and value set.GetManualFlashPowerLevelsL(RArray< TInt > &,TValueInfo &)const
Gets the current discrete manual flash power levels supported by the camera in r...GetMinFocalLength()const
Get minimum focus distance in millimetresGetOpticalZoomStepsL(RArray< TInt > &,TValueInfo &)const
Gets the optical zoom levels.GetPreCaptureWarningL(TInt &)const
Get the status of every warnings defined.GetPreCaptureWarningSupportedL(TCameraMode,TInt &)const
Retrieves the pre capture warnings supported for a given camera modeGetShutterSpeedsL(RArray< TInt > &,TValueInfo &)const
Gets the set of supported shutter speeds.GetSupportedAFAssistantLightL(TInt &)const
Retrieve the different supported AF assistant light.GetSupportedContinuousAutoFocusTimeoutsL(RArray< TInt > &,TValueInfo &)const
Retrieves the timeout values camera supported by the camera when in continuous a...GetSupportedISORateTypeL(TInt &)const
Gets all supported ISO types on the device.GetSupportedIsoRatesL(RArray< TInt > &)const
Gets the set of camera supported ISO rates.GetSupportedSettingsL(RArray< TUid > &)const
Gets an array of all the advanced settings parameters supported by the camera. T...GetTimeLapse(TTime &,TTime &,TTime &)const
Get current time lapse value. Active only when drive mode EDriveModeTimeLapse. T...GetTimeLapsePeriodRange(TTime &,TTime &)const
Get camera supported time lapse period range. Active only when drive mode EDrive...GetTimerIntervalsL(RArray< TInt > &,TValueInfo &)const
Get camera supported timer values. Active only when drive mode EDriveModeTimed. ...GetWBRgbValue(TRgb &)const
Get white balance value represented as a RGB triplet.GetWBSupportedColorTemperaturesL(RArray< TInt > &,TValueInfo &)const
Get the white balance values, as temperature measured in Kelvin, supported on th...IsCameraPresent()const
Checks whether the current camera is present.IsCameraPresent(TInt)
Checks whether the camera, denoted by its index, is currently present. The index...IsExternalFlashPresent()const
Check whether there is an external flash source.IsFlashReady(TBool &)const
Checks whether the flash is ready.IsoRate()const
Gets current ISO rate.ManualFlashPowerLevel()const
Gets the current manual flash power level on the camera.MeteringMode()const
Get current metering mode.NewL(CCamera &)
Factory function for creating the CCamera::CCameraAdvancedSettings object.OpticalZoom()const
Gets the currently set zoom value.PictureOrientation()const
Get current picture orientationPixelAspectRatio()const
Get current pixel aspect ratio.RedEyeReduceOn()const
Gets 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()const
Gets the current state for button clicking sound effect.ShutterSpeed()const
Gets the current shutter speedStabilizationComplexity()const
Gets current active stabilization algorithm selection on the camera.StabilizationEffect()const
Gets all supported stabilization effects on the camera.StabilizationMode()const
Gets 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()const
Gets all supported auto focus areas on the camera.SupportedAutoFocusTypes()const
Gets all supported auto focus types on the camera.SupportedBracketModes()const
Get all supported bracket modes as bitfields.SupportedBracketParameters()const
Get all supported bracket parameters as bitfields.SupportedBracketSteps()const
Get all supported bracket steps as bitfields.SupportedDriveModes()const
Get all supported drive modes as bitfields of TDriveMode type.SupportedExposureModes()const
Get Supported exposure modes - bitfields of CCamera::TExposure
SupportedFlashModes()const
Get camera all supported flash modes CCamera::TFlash
SupportedFocusModes()const
Gets all of the supported focus modes on the camera. The result is a bitfield of...SupportedFocusRanges()const
Gets all supported focus ranges on the camera.SupportedMeteringModes()const
Get all supported metering modes on this camera represented as bitfield of type ...SupportedPixelAspectRatios()const
Get supported pixel aspect ratio.SupportedStabilizationComplexityValues()const
Gets all supported stabilization algorithm values on the camera.SupportedStabilizationEffects()const
Gets the current stabilization effect on the camera.SupportedStabilizationModes()const
Gets all of the supported stabilization modes on the camera. The result is a bit...SupportedWBUnits()const
Gets the units in which the white balance is measured on the camera. SupportedWhiteBalanceModes()const
Gets camera supported set of white balance adjustments.SupportedYuvRanges()const
Get supported YUV ranges.TAFAssistantLight
Specifies the different types of auto focus assistant lightTAutoFocusArea
Specifies the autofocus area. TAutoFocusType
Specifies the supported autofocus types. TBracketMode
Specifies Bracket mode. TBracketParameter
Supported parameters used for bracketing. TBracketStep
Specifies the magnitude of bracketing step. The actual value and availability is...TCameraMode
Describes the camera mode.TCameraType
Specifies camera type. TDriveMode
Specifies the drive mode for the camera. This determines how and in what sucessi...TFocusMode
Supported focus modes. TFocusRange
Supported focus ranges. TISORateType
Specifies the ISO type supported by the camera. ISO refers to the sensivity of t...TMeteringMode
Specifies the Metering mode for the camera. EMeteringModeAuto is the default val...TPictureOrientation
Specifies the orientation of the picture. TPixelAspectRatio
Specifies the pixel aspect ratio TPreCaptureWarning
Specifies the unfavourable circumstances as pre capture warnings which may be is...TStabilizationAlgorithmComplexity
Supported stabilization algorithms, graded on complexity. TStabilizationEffect
Supported magnitudes of stabilization effect when in manual mode. TStabilizationMode
Specifies stabilization mode of the camera. TWBUnits
Specifies the units supported by the camera for manual white balance setting.TYuvRange
Specifies YUV colour space dynamic range. TimerInterval()const
Get 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()const
Get the white balance as a temperature in KelvinWhiteBalanceMode()const
Gets the current white balance value.YuvRange()const
Get 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()const
IMPORT_C TCameraType CameraType() const;
Gets the type of this camera.
|
CCamera::CCameraAdvancedSettings::TCameraType
Specifies 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::TCameraType
Specifies camera type. IsCameraPresent()const
IMPORT_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()const
IMPORT_C TInt CameraIndex() const;
Gets current camera index. The index uniquely identifies the camera on the device.
|
SupportedStabilizationModes()const
IMPORT_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::TStabilizationMode
Specifies stabilization mode of the camera. StabilizationMode()const
IMPORT_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()const
IMPORT_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::TFocusMode
Supported focus modes. FocusMode()const
IMPORT_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()const
IMPORT_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()const
IMPORT_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.
|
KUidECamEventCameraSettingFocusRange
Focus range. SupportedAutoFocusTypes()const
IMPORT_C TInt SupportedAutoFocusTypes() const;
Gets all supported auto focus types on the camera.
|
AutoFocusType()const
IMPORT_C TAutoFocusType AutoFocusType() const;
Gets current auto focus type on the camera.
|
CCamera::CCameraAdvancedSettings::TAutoFocusType
Specifies 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.
|
KUidECamEventCameraSettingAutoFocusType
Autofocus type. SupportedAutoFocusAreas()const
IMPORT_C TInt SupportedAutoFocusAreas() const;
Gets all supported auto focus areas on the camera.
|
AutoFocusArea()const
IMPORT_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()const
IMPORT_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()const
IMPORT_C TInt GetMinFocalLength() const;
Get minimum focus distance in millimetres
Note: Current Focal length is calculated as focalLength = opticalZoom * minFocalLength;
|
GetSupportedIsoRatesL(RArray< TInt > &)const
IMPORT_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()const
IMPORT_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 &)const
IMPORT_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()const
IMPORT_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 &)const
IMPORT_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()const
IMPORT_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()const
IMPORT_C TInt SupportedMeteringModes() const;
Get all supported metering modes on this camera represented as bitfield of type TMeteringMode.
|
MeteringMode()const
IMPORT_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()const
IMPORT_C TInt SupportedDriveModes() const;
Get all supported drive modes as bitfields of TDriveMode type.
|
DriveMode()const
IMPORT_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()const
IMPORT_C TInt SupportedBracketModes() const;
Get all supported bracket modes as bitfields.
|
BracketMode()const
IMPORT_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()const
IMPORT_C TInt SupportedBracketParameters() const;
Get all supported bracket parameters as bitfields.
|
BracketParameter()const
IMPORT_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()const
IMPORT_C TInt SupportedBracketSteps() const;
Get all supported bracket steps as bitfields.
|
BracketStep()const
IMPORT_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 &)const
IMPORT_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()const
IMPORT_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::TFlash
Specifies the type of flash. FlashMode()const
IMPORT_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::TFlash
Specifies 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()const
IMPORT_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 &)const
IMPORT_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 &)const
IMPORT_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 &)const
IMPORT_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 &)const
IMPORT_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()const
IMPORT_C TBool IsExternalFlashPresent() const;
Check whether there is an external flash source.
|
GetManualFlashPowerLevelsL(RArray< TInt > &,TValueInfo &)const
IMPORT_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()const
IMPORT_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()const
IMPORT_C TInt SupportedExposureModes() const;
Get Supported exposure modes - bitfields of CCamera::TExposure
|
ExposureMode()const
IMPORT_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 &)const
IMPORT_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 &)const
IMPORT_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 &)const
IMPORT_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 &)const
Get 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 &)const
IMPORT_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()const
IMPORT_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()const
IMPORT_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()const
IMPORT_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()const
IMPORT_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 &)const
IMPORT_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()const
IMPORT_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 &)const
IMPORT_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 &)const
IMPORT_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()const
IMPORT_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()const
IMPORT_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()const
IMPORT_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()const
IMPORT_C TInt SupportedYuvRanges() const;
Get supported YUV ranges.
|
YuvRange()const
IMPORT_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()const
IMPORT_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 &)const
IMPORT_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()const
IMPORT_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 &)const
IMPORT_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()const
IMPORT_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()const
IMPORT_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()const
IMPORT_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 > &)const
IMPORT_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 > &)const
IMPORT_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 > &)const
IMPORT_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()const
IMPORT_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 &)const
IMPORT_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()const
IMPORT_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()const
IMPORT_C TInt SupportedStabilizationEffects() const;
Gets the current stabilization effect on the camera.
|
StabilizationEffect()const
IMPORT_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()const
IMPORT_C TInt SupportedStabilizationComplexityValues() const;
Gets all supported stabilization algorithm values on the camera.
|
StabilizationComplexity()const
IMPORT_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()const
IMPORT_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 &)const
IMPORT_C void GetWBRgbValue(TRgb &aValue) const;
Get white balance value represented as a RGB triplet.
|
TRgb
24-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.
|
TRgb
24-bit RGB colour value with 8 bits each for red, green and blue.GetWBSupportedColorTemperaturesL(RArray< TInt > &,TValueInfo &)const
IMPORT_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()const
IMPORT_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 &)const
IMPORT_C TInt IsFlashReady(TBool &aReady) const;
Checks whether the flash is ready.
|
|
GetCurrentFocusModeStepsL(RArray< TInt > &,TValueInfo &)const
IMPORT_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 &)const
IMPORT_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 &)const
IMPORT_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 &)const
IMPORT_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)const
IMPORT_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 &)const
IMPORT_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 &)const
IMPORT_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 &)const
IMPORT_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 &)const
IMPORT_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.
|
|
TCameraType
TCameraType
Specifies camera type.
|
TStabilizationMode
TStabilizationMode
Specifies stabilization mode of the camera.
|
TStabilizationEffect
TStabilizationEffect
Supported magnitudes of stabilization effect when in manual mode.
|
TStabilizationAlgorithmComplexity
TStabilizationAlgorithmComplexity
Supported stabilization algorithms, graded on complexity.
|
TFocusMode
TFocusMode
Supported focus modes.
|
TFocusRange
TFocusRange
Supported focus ranges.
|
TAutoFocusType
TAutoFocusType
Specifies the supported autofocus types.
|
TAutoFocusArea
TAutoFocusArea
Specifies the autofocus area.
|
TMeteringMode
TMeteringMode
Specifies the Metering mode for the camera. EMeteringModeAuto is the default value.
|
TDriveMode
TDriveMode
Specifies the drive mode for the camera. This determines how and in what sucession are images shot. EDriveModeSingleShot is the default.
|
TBracketMode
TBracketMode
Specifies Bracket mode.
|
TBracketParameter
TBracketParameter
Supported parameters used for bracketing.
Note: Bracket mode parameter value changes by a selected uniform step between successive image shots.
CCamera::CCameraAdvancedSettings::TBracketStep
Specifies the magnitude of bracketing step. The actual value and availability is...CCamera::CCameraAdvancedSettings::TBracketMode
Specifies Bracket mode.
|
TBracketStep
TBracketStep
Specifies the magnitude of bracketing step. The actual value and availability is parameter dependent.
CCamera::CCameraAdvancedSettings::TBracketParameter
Supported parameters used for bracketing.
|
TPictureOrientation
TPictureOrientation
Specifies the orientation of the picture.
|
TPixelAspectRatio
TPixelAspectRatio
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.
|
TYuvRange
TYuvRange
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].
|
TWBUnits
TWBUnits
Specifies the units supported by the camera for manual white balance setting.
|
TISORateType
TISORateType
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.
|
TPreCaptureWarning
TPreCaptureWarning
Specifies the unfavourable circumstances as pre capture warnings which may be issued before image/video capture.
|
TCameraMode
TCameraMode
Describes the camera mode.
|
TAFAssistantLight
TAFAssistantLight
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 > &)const
Get all settings affected by the current preset. This is to say that all setting...GetAssociatedSettingsL(TUid,RArray< TUid > &)const
Get all settings associated with a specific preset, identified by a UID. This fu...GetSupportedPresetsL(RArray< TUid > &)const
Gets the presets supported by the camera. These are identified by UIDs and relat...NewL(CCamera &)
Factory function for creating the CCamera::CCameraPresets object.Preset()const
Gets 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 > &)const
IMPORT_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()const
IMPORT_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 > &)const
IMPORT_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 > &)const
IMPORT_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.
|