| class MCameraAdvancedSettings |
Mixin class for implementation by providers of the Advanced Settings Camera Extension API. 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.
| TInt | Aperture | ( | ) | const [pure virtual] |
Get current aperture value. The default aperture value is ECAM implementation specific and could be either auto aperture or any other supported value.
In case there is an error, a negative error value from system wide error should be returned.
| TBool | ApertureExposureLockOn | ( | ) | const [pure virtual] |
Gets the current state for aperture and exposure lock.
| CCamera::CCameraAdvancedSettings::TAutoFocusArea | AutoFocusArea | ( | ) | const [pure virtual] |
Gets current chosen auto focus area on the device.
| TBool | AutoFocusLockOn | ( | ) | const [pure virtual] |
Checks whether AutoFocus value is locked or not.
| CCamera::CCameraAdvancedSettings::TAutoFocusType | AutoFocusType | ( | ) | const [pure virtual] |
Gets current auto focus type on the device.
| TBool | AutomaticSizeSelectionChangeOn | ( | ) | const [pure virtual] |
Retrieves the state for automatic size selection option. Default value is EFalse.
| CCamera::CCameraAdvancedSettings::TBracketMode | BracketMode | ( | ) | const [pure virtual] |
Get current bracket mode.
| CCamera::CCameraAdvancedSettings::TBracketParameter | BracketParameter | ( | ) | const [pure virtual] |
Get current bracket parameter.
| CCamera::CCameraAdvancedSettings::TBracketStep | BracketStep | ( | ) | const [pure virtual] |
Get current bracket step.
| TInt | BurstImages | ( | ) | const [pure virtual] |
: due to memory or image size limitations the actual number may be less.
| TInt | CameraIndex | ( | ) | const [pure virtual] |
Gets current camera index. The index uniquely identifies the camera on the device.
| CCamera::CCameraAdvancedSettings::TCameraType | CameraType | ( | ) | const [pure virtual] |
Gets the type of this camera. TCameraType
| CCamera::CCameraAdvancedSettings::TCameraType | CameraType | ( | TInt | aCameraIndex | ) | const [pure virtual] |
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.
| TInt aCameraIndex | An integer in the range of [0: CCamera::CamerasAvailable()-1]. |
| TInt | ContinuousAutoFocusTimeout | ( | ) | const [pure virtual] |
Gets the current value for continuous autofocus timeout. Timeouts are in microseconds.
In case there is an error, a negative error value from system wide error should be returned.
| TInt | DigitalZoom | ( | ) | const [pure virtual] |
Gets the currently set digital zoom value.
In case there is an error, a negative error value from system wide error should be returned.
| CCamera::CCameraAdvancedSettings::TDriveMode | DriveMode | ( | ) | const [pure virtual] |
Gets currently active drive mode.
| TInt | ExposureCompensation | ( | ) | const [pure virtual] |
Use TInt GetExposureCompensation(TInt& aExposureCompensation);
Get the current exposure compensation value as integer 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.
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.
| TInt | ExposureCompensationStep | ( | ) | const [pure virtual] |
Use TInt GetExposureCompensationStep(TInt& aExposureCompensationStep);
Get current exposure compensation step.
| TBool | ExposureLockOn | ( | ) | const [pure virtual] |
Checks whether exposure value is locked or not.
| CCamera::TExposure | ExposureMode | ( | ) | const [pure virtual] |
Gets the currently set exposure setting value.
| TInt | FlashCompensation | ( | ) | const [pure virtual] |
Use TInt GetFlashCompensation(TInt& aFlashCompensation);
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.
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.
| TInt | FlashCompensationStep | ( | ) | const [pure virtual] |
Use TInt GetFlashCompensationStep(TInt& aFlashCompensationStep);
Get current flash power compensation step.
| CCamera::CCameraAdvancedSettings::TFocusMode | FocusMode | ( | ) | const [pure virtual] |
Gets current focus mode on the device. The result is a valid TFocusMode value.
| CCamera::CCameraAdvancedSettings::TFocusRange | FocusRange | ( | ) | const [pure virtual] |
Gets current focus range on the device.
| void | GetActiveSettingsL | ( | RArray < TUid > & | aActiveSettings | ) | const [pure virtual] |
Gets an array of all the advanced settings parameters currently active on the device. These are identified by UIDs and relate to the set or subset of it of all supported settings UIDs.
| void | GetAperturesL | ( | RArray < TInt > & | aFStops, |
| TValueInfo & | aInfo | |||
| ) | const [pure virtual] | |||
Gets the current discrete aperture steps (F-stops) supported by the device.
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 should be returned and TValueInfo should be ENotActive, and the corresponding getter/setters for this feature should not be used.
| RArray < TInt > & aFStops | A reference to an empty array of TInt which would be populated by the implementation with the specific supported values. If the array is empty on return, the camera supports all integer values in the aperture range. Each value is multiplied by a factor of KECamFineResolutionFactor. |
| TValueInfo & aInfo | a reference to TValueInfo, which establishes the type of the returned data. |
| void | GetBracketMerge | ( | TInt & | aStartIndex, |
| TInt & | aFrames | |||
| ) | const [pure virtual] | |||
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.
It is very much TBracketMode setting dependent.
| void | GetDigitalZoomStepsL | ( | RArray < TInt > & | aDigitalZoomSteps, |
| TValueInfo & | aInfo | |||
| ) | const [pure virtual] | |||
Gets the digital zoom levels.
Such approach allows for support for both linear and non-linear zoom steps. When camera device doesn't support this, empty array should be returned and TValueInfo should be ENotActive and the corresponding getter/setters for this feature should not be used.
| RArray < TInt > & aDigitalZoomSteps | Array to hold digital zoom values multiplied by KECamFineResolutionFactor to retain precision. So that if zoom is not supported the array will return a single element of value KECamFineResolutionFactor. |
| TValueInfo & aInfo | a reference to TValueInfo, which establishes the type of the returned data. |
| void | GetDisabledSettingsL | ( | RArray < TUid > & | aDisabledSettings | ) | const [pure virtual] |
Gets an array of all the advanced settings parameters currently disabled on the device. These are identified by UIDs and relate to the set or subset of it of all supported settings UIDs.
| TInt | GetExposureCompensation | ( | TInt & | aExposureCompensation | ) | const [pure virtual] |
Get the current exposure compensation value as integer 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.
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.
| TInt & aExposureCompensation | Reference to the current number of compensation steps as an integer. |
| void | GetExposureCompensationRangeInSteps | ( | TInt & | aNegativeCompensation, |
| TInt & | aPositiveCompensation | |||
| ) | const [pure virtual] | |||
Get current exposure compensation range in steps. It depends on the previously selected exposure compensation step.
| TInt | GetExposureCompensationStep | ( | TInt & | aExposureCompensationStep | ) | const [pure virtual] |
Get current exposure compensation step.
| TInt & aExposureCompensationStep | Reference to the current exposure compensation step. |
| void | GetExposureCompensationStepsL | ( | RArray < TInt > & | aExposureCompensationSteps, |
| TValueInfo & | aInfo | |||
| ) | const [pure virtual] | |||
Get exposure compensation steps as integers multiplied by KECamFineResolutionFactor. For example 0.3 EV is 30.
When camera device doesn't support this, empty array should be returned and TValueInfo should be ENotActive, and the corresponding getter/setters for this feature should not be used. When camera device is incapable of revealing the exposure 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 should be returned and TValueInfo should be ENotActive, and the corresponding getter/setters for this feature should not be used.
| RArray < TInt > & aExposureCompensationSteps | an RArray of integers which is populated to reflect the supported exposure compensation steps, all values have been multiplied by KECamFineResolutionFactor before truncated to integers. |
| TValueInfo & aInfo | a reference to TValueInfo, which establishes the type of the returned data. |
| TInt | GetFlashCompensation | ( | TInt & | aFlashCompensation | ) | const [pure virtual] |
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.
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.
| TInt & aFlashCompensation | Reference to the current number of compensation steps as an integer. |
| void | GetFlashCompensationRangeInSteps | ( | TInt & | aNegativeCompensation, |
| TInt & | aPositiveCompensation | |||
| ) | const [pure virtual] | |||
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 multplier (in steps) and the direction (the sign). Steps are always assumed integers.
| TInt | GetFlashCompensationStep | ( | TInt & | aFlashCompensationStep | ) | const [pure virtual] |
Get current flash power compensation step.
| TInt & aFlashCompensationStep | Reference to the current flash power compensation step. |
| void | GetFlashCompensationStepsL | ( | RArray < TInt > & | aFlashCompensationSteps, |
| TValueInfo & | aInfo | |||
| ) | const [pure virtual] | |||
Get flash compensation steps as integers multiplied by KECamFineResolutionFactor. For example 0.5 EV is 50.
When camera device doesn't support this, empty array should be returned and TValueInfo should be ENotActive, and the corresponding getter/setters for this feature should not be used. 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 should be returned and TValueInfo should be ENotActive, and the corresponding getter/setters for this feature should not be used.
| RArray < TInt > & aFlashCompensationSteps | an RArray of integers which is populated on return to reflect the supported flash compensation steps. |
| TValueInfo & aInfo | an TValueInfo reference, which establishes the organization of the returned data. |
| void | GetManualFlashPowerLevelsL | ( | RArray < TInt > & | aManualFlashPowerLevels, |
| TValueInfo & | aInfo | |||
| ) | const [pure virtual] | |||
Gets the current discrete manual flash power levels supported by the device in range 0-100 as a percentage of maximum power level.
When camera device doesn't support this, empty array should be returned and TValueInfo should be ENotActive, and the corresponding getter/setters for this feature should not be used. 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 parmanently set value. If this value is not known, empty array should be returned and TValueInfo should be ENotActive, and the corresponding getter/setters for this feature should not be used.
| RArray < TInt > & aManualFlashPowerLevels | An empty array of TInt which would be populated by the implementation with the specific supported values. If the array is empty on return, the camera does not support this functionality. |
| TValueInfo & aInfo | a reference to TValueInfo, which establishes the type of the returned data. |
| TInt | GetMinFocalLength | ( | ) | const [pure virtual] |
Get minimum focus distance in millimetres.
Current Focal length is calculated as focalLength = opticalZoom * minFocalLength;
| void | GetOpticalZoomStepsL | ( | RArray < TInt > & | aOpticalZoomSteps, |
| TValueInfo & | aInfo | |||
| ) | const [pure virtual] | |||
Gets the optical zoom levels.
Such approach allows for support for both linear and non-linear zoom steps. When camera device doesn't support this, empty array should be returned and TValueInfo should be ENotActive, and the corresponding getter/setters for this feature should not be used.
| RArray < TInt > & aOpticalZoomSteps | Array to hold optical zoom values multiplied by KECamFineResolutionFactor to retain precision. So that if zoom is not supported the array will return a single element of value KECamFineResolutionFactor. |
| TValueInfo & aInfo | a reference to TValueInfo, which establishes the type of the returned data. |
| void | GetShutterSpeedsL | ( | RArray < TInt > & | aShutterSpeeds, |
| TValueInfo & | aInfo | |||
| ) | const [pure virtual] | |||
Gets the set of supported shutter speeds
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 should be returned and TValueInfo should be ENotActive, and the corresponding getter/setters for this feature should not be used.
| RArray < TInt > & aShutterSpeeds | a reference to an RArray of TInt representing the discrete shutter speeds supported currently by the device. |
| TValueInfo & aInfo | a reference to TValueInfo, which establishes the type of the returned data. |
| void | GetSupportedContinuousAutoFocusTimeoutsL | ( | RArray < TInt > & | aTimeouts, |
| TValueInfo & | aInfo | |||
| ) | const [pure virtual] | |||
Retrieves the timeout values camera supported by the camera when in continuous auto focus mode. Timeouts are in microseconds.
When camera device doesn't support this, empty array should be returned and TValueInfo should be ENotActive and the corresponding getter/setters for this feature should not be used.
| RArray < TInt > & aTimeouts | An empty array to hold timeout values. |
| TValueInfo & aInfo | a reference to TValueInfo, which establishes the type of the returned data. |
| void | GetSupportedIsoRatesL | ( | RArray < TInt > & | aSupportedIsoRates | ) | const [pure virtual] |
Gets the set of camera supported ISO rates.
When camera device is incapable of revealing the ISO rates supported, it has to be assumed that camera will work only on the parmanently set value. If this value is not known, empty array should be returned, and the corresponding getter/setters for this feature for this feature should not be used.
| void | GetSupportedSettingsL | ( | RArray < TUid > & | aSettings | ) | const [pure virtual] |
Gets an array of all the advanced settings parameters supported by the device. These are identified by UIDs and relate to the set or subset of it of all defined settings UIDs.
| void | GetTimeLapse | ( | TTime & | aStart, |
| TTime & | aEnd, | |||
| TTime & | aInterval | |||
| ) | const [pure virtual] | |||
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.
| void | GetTimeLapsePeriodRange | ( | TTime & | aTimeLapseMin, |
| TTime & | aTimeLapseMax | |||
| ) | const [pure virtual] | |||
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.
| void | GetTimerIntervalsL | ( | RArray < TInt > & | aTimerIntervals, |
| TValueInfo & | aInfo | |||
| ) | const [pure virtual] | |||
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.
When camera device doesn't support this, empty array should be returned and TValueInfo should be ENotActive, and the corresponding getter/setters for this feature should not be used.
| RArray < TInt > & aTimerIntervals | an RArray of integers which is populated to reflect the supported timer interval steps. |
| TValueInfo & aInfo | an TValueInfo reference, which establishes the organization of the returned data. |
| void | GetWBRgbValue | ( | TRgb & | aValue | ) | const [pure virtual] |
Get white balance value represented as a RGB triplet ( TRgb )
| TRgb & aValue | a reference to TRgb object which will contain the current white balance. |
| void | GetWBSupportedColorTemperaturesL | ( | RArray < TInt > & | aWBColorTemperatures, |
| TValueInfo & | aInfo | |||
| ) | const [pure virtual] | |||
Get the white balance values, as temperature measured in Kelvin, supported on the device.
When camera device doesn't support this, empty array should be returned and TValueInfo should be ENotActive, and the corresponding getter/setters for this feature should not be used.
| RArray < TInt > & aWBColorTemperatures | A reference to an empty array of TInt which would be populated by the implementation with the specific supported values. |
| TValueInfo & aInfo | a reference to TValueInfo, which establishes the type of the returned data. |
| TBool | IsCameraPresent | ( | ) | const [pure virtual] |
Checks whether the current camera is present.
| TBool | IsCameraPresent | ( | TInt | aCameraIndex | ) | const [pure virtual] |
Checks whether the camera, denoted by its index, is currently present. The index uniquely identifies the camera on the device.
| TInt aCameraIndex | An integer in the range of [0:CCamera::CamerasAvailable()-1] specifying the camera device to use |
| TBool | IsExternalFlashPresent | ( | ) | const [pure virtual] |
Check whether there is an external flash source.
| TInt | IsoRate | ( | ) | const [pure virtual] |
Gets current ISO rate.
In case there is an error, a negative error value from system wide error should be returned.
| TInt | ManualFlashPowerLevel | ( | ) | const [pure virtual] |
Gets the current manual flash power level on the device.
In case there is an error, a negative error value from system wide error should be returned.
| CCamera::CCameraAdvancedSettings::TMeteringMode | MeteringMode | ( | ) | const [pure virtual] |
Get current metering mode.
| TInt | OpticalZoom | ( | ) | const [pure virtual] |
Gets the currently set zoom value.
In case there is an error, a negative error value from system wide error should be returned.
| CCamera::CCameraAdvancedSettings::TPictureOrientation | PictureOrientation | ( | ) | const [pure virtual] |
Get current picture orientation.
| CCamera::CCameraAdvancedSettings::TPixelAspectRatio | PixelAspectRatio | ( | ) | const [pure virtual] |
Get current pixel aspect ratio.
| TBool | RedEyeReduceOn | ( | ) | const [pure virtual] |
Gets whether the flash red eye reduction is switched on.
| void | SetAperture | ( | TInt | aFStop | ) | [pure virtual] |
Set a new aperture value. All MCameraObserver2 clients of the camera receive a KUidECamEventCameraSettingAperture event notification when aperture value is changed.
The aperture parameter value is an integer, multiplied by KECamFineResolutionFactor. For example to set an aperture of F2.8, call SetAperture(280).
| TInt aFStop | a new aperture value in the supported by the device range. |
| void | SetApertureExposureLockOn | ( | TBool | aAELock | ) | [pure virtual] |
Sets the current state for aperture and exposure lock. Triggers a KUidECamEventAELock event to all MCameraObserver2 clients.
| TBool aAELock | a value whether to lock exposure and aperture together. |
| void | SetAutoFocusArea | ( | CCamera::CCameraAdvancedSettings::TAutoFocusArea | aAutoFocusArea | ) | [pure virtual] |
Sets a specific auto focus area on the device. Focus area change fires a KUidECamEventCameraSettingAutoFocusArea event to all MCameraObserver2 clients of the camera.
| CCamera::CCameraAdvancedSettings::TAutoFocusArea aAutoFocusArea | Autofocus area selection. |
| void | SetAutoFocusLockOn | ( | TBool | aState | ) | [pure virtual] |
Sets autofocus lock state. Triggers a KUidECamEventCameraSettingAutoFocusLock event to all MCameraObserver2 clients.
| TBool aState | Required new state. |
| void | SetAutoFocusType | ( | CCamera::CCameraAdvancedSettings::TAutoFocusType | aAutoFocusType | ) | [pure virtual] |
Sets a specific auto focus type on the device. The focus type change fires both, KUidECamEventCameraSettingAutoFocusType and KUidECamEventCameraSettingAutoFocusType2 event to all MCameraObserver2 clients of the camera. KUidECamEventCameraSettingAutoFocusType
| CCamera::CCameraAdvancedSettings::TAutoFocusType aAutoFocusType | Autofocus selection. |
| void | SetAutomaticSizeSelectionChangeOn | ( | TBool | aSetOn | ) | [pure virtual] |
Allow camera to proactively change image size due external factors. Default value is EFalse. Triggers a KUidECamEventCameraSettingAutomaticSizeSelection event notification.
| TBool aSetOn | whether the option should be switched on |
| void | SetBracketMerge | ( | TInt | aStartIndex, |
| TInt | aFrames | |||
| ) | [pure virtual] | |||
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.
It is very TBracketMode setting dependent.
| void | SetBracketMode | ( | CCamera::CCameraAdvancedSettings::TBracketMode | aBracketMode | ) | [pure virtual] |
Set new bracket mode. All MCameraObserver2 clients are notified with a KUidECamEventCameraSettingBracketMode event.
| CCamera::CCameraAdvancedSettings::TBracketMode aBracketMode | new selection for bracket mode of type TBracketMode. |
| void | SetBracketParameter | ( | CCamera::CCameraAdvancedSettings::TBracketParameter | aBracketParameter | ) | [pure virtual] |
Set new bracket parameter When set all clients are notified with a KUidECamEventCameraSettingBracketParameter event.
| CCamera::CCameraAdvancedSettings::TBracketParameter aBracketParameter | new selection for parameter type of type TBracketParameter. |
| void | SetBracketStep | ( | CCamera::CCameraAdvancedSettings::TBracketStep | aBracketStep | ) | [pure virtual] |
Set new bracket step. All MCameraObserver2 clients are notified with KUidECamEventCameraSettingBracketStep.
| CCamera::CCameraAdvancedSettings::TBracketStep aBracketStep | new selection for step of type TBracketStep. |
| void | SetBurstImages | ( | TInt | aImages | ) | [pure virtual] |
: due to memory or image size limitations the actual number may be less.
Unless reduced Latency scheme is not used (ie CaptureImageL(TInt aSequenceNumber) or PerformantStopVideoCaptureL()) if an image/video capture is still outstanding, this method may report error KErrInUse.
| TInt aImages | the number of images set to capture in burst mode. |
| void | SetContinuousAutoFocusTimeout | ( | TInt | aTimeout | ) | [pure virtual] |
Sets new 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.
| TInt aTimeout | a new timeout value in microseconds. |
| void | SetDigitalZoom | ( | TInt | aDigitalZoom | ) | [pure virtual] |
Sets the digital zoom value. Triggers a KUidECamEventCameraSettingDigitalZoom event to all MCameraObserver2 clients.
| TInt aDigitalZoom | Required zoom value. |
| void | SetDriveMode | ( | CCamera::CCameraAdvancedSettings::TDriveMode | aDriveMode | ) | [pure virtual] |
Set the current metering mode. When set all MCameraObserver2 clients are notified with a KUidECamEventCameraSettingDriveMode event.
Unless reduced Latency scheme is not used (ie CaptureImageL(TInt aSequenceNumber) or PerformantStopVideoCaptureL()) if an image/video capture is still outstanding, this method may report error KErrInUse.
| CCamera::CCameraAdvancedSettings::TDriveMode aDriveMode | new selection for drive mode value of type TDriveMode. |
| void | SetExposureCompensation | ( | TInt | aExposureCompensationSteps | ) | [pure virtual] |
Set the current exposure compensation value as integer steps. Triggers a KUidECamEventCameraSettingExposureCompensation event to all MCameraObserver2 clients.
| TInt aExposureCompensationSteps | a required compensation value negative value reduce the exposure time positive increases the exposure time. |
| void | SetExposureCompensationStep | ( | TInt | aExposureCompensationStep | ) | [pure virtual] |
Set current exposure compensation step as an integer multiplied by KECamFineResolutionFactor. All MCameraObserver2 clients receive a KUidECamEventCameraSettingExposureCompensationStep event, when the value has changed.
| TInt aExposureCompensationStep | a new value for the exposure compensation step. |
| void | SetExposureLockOn | ( | TBool | aState | ) | [pure virtual] |
Sets exposure lock state. Triggers a KUidECamEventCameraSettingExposureLock event to all MCameraObserver2 clients.
| TBool aState | Required new state. |
| void | SetExposureMode | ( | CCamera::TExposure | aExposureMode | ) | [pure virtual] |
Sets the exposure mode of the device.
Triggers a KUidECamEventCameraSettingExposureMode event to all MCameraObserver2 clients.
| CCamera::TExposure aExposureMode | The required exposure adjustment. |
| void | SetFlashCompensation | ( | TInt | aFlashCompensationSteps | ) | [pure virtual] |
Set the current flash compensation value as integer steps. Positive values increase power, negative reduce 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. Triggers a KUidECamEventCameraSettingFlashCompensation event.
| TInt aFlashCompensationSteps | a required compensation steps - negative value reduce the flash power positive boosts up the flash power. |
| void | SetFlashCompensationStep | ( | TInt | aFlashCompensationStep | ) | [pure virtual] |
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.
| TInt aFlashCompensationStep | a new value for the flash compensation step. |
| void | SetFlashMode | ( | CCamera::TFlash | aMode | ) | [pure virtual] |
Sets the flash mode.
Triggers a KUidECamEventCameraSettingFlashMode event to all camera MCameraObserver2 clients.
| CCamera::TFlash aMode | The required flash mode. |
| void | SetFocusDistance | ( | TInt | aDistance | ) | [pure virtual] |
Set focus distance in millimetres. Focus distance change fires a KUidECamEventCameraSettingFocusDistance event to all MCameraObserver2 clients of the camera.
| TInt aDistance | the current value in millimetres, directly from user setting of lenses. |
| void | SetFocusMode | ( | CCamera::CCameraAdvancedSettings::TFocusMode | aFocusMode | ) | [pure virtual] |
Sets a specific focus mode on the device. Focus mode change fires a KUidECamEventCameraSettingFocusMode event to all MCameraObserver2 clients of the camera.
| CCamera::CCameraAdvancedSettings::TFocusMode aFocusMode | new focus mode of TFocusMode type. |
| void | SetFocusRange | ( | CCamera::CCameraAdvancedSettings::TFocusRange | aFocusRange | ) | [pure virtual] |
Sets a specific focus range on the device. The focus range change fires both, KUidECamEventCameraSettingFocusRange and KUidECamEventCameraSettingFocusRange2 event to all MCameraObserver2 clients of the camera. KUidECamEventCameraSettingFocusRange
| CCamera::CCameraAdvancedSettings::TFocusRange aFocusRange | newly selected focus range. |
| void | SetIsoRate | ( | TInt | aRate | ) | [pure virtual] |
Set current ISO rate for the camera. Triggers a KUidECamEventCameraSettingIsoRate event to all MCameraObserver2 clients of the camera.
| TInt aRate | required new ISO rate. |
| void | SetManualFlashPowerLevel | ( | TInt | aManualFlashPowerLevel | ) | [pure virtual] |
Sets the current manual flash power level on the device. Triggers a KUidECamEventCameraSettingFlashManualPower event to all MCameraObserver2 clients.
| TInt aManualFlashPowerLevel | one of the values returned in GetManualFlashPowerLevelsL(). |
| void | SetMeteringMode | ( | CCamera::CCameraAdvancedSettings::TMeteringMode | aMeteringMode | ) | [pure virtual] |
Set the current metering mode. When set, all MCameraObserver2 clients are notified with a KUidECamEventCameraSettingMeteringMode event.
| CCamera::CCameraAdvancedSettings::TMeteringMode aMeteringMode | a new selection for metering mode of type TMeteringMode. |
| void | SetOpticalZoom | ( | TInt | aOpticalZoom | ) | [pure virtual] |
Sets the zoom using a specific value. Triggers a KUidECamEventCameraSettingOpticalZoom event to all MCameraObserver2 clients.
| TInt aOpticalZoom | Required zoom value. |
| void | SetPictureOrientation | ( | CCamera::CCameraAdvancedSettings::TPictureOrientation | aOrientation | ) | [pure virtual] |
Set a new picture orientation This triggers a KUidECamEventCameraSettingPictureOrientation event to all MCameraObserver2 clients.
| CCamera::CCameraAdvancedSettings::TPictureOrientation aOrientation | a value of TPictureOrientation denoting the new orientation. |
| void | SetPixelAspectRatio | ( | CCamera::CCameraAdvancedSettings::TPixelAspectRatio | aPixelAspectRatio | ) | [pure virtual] |
Set a new pixel aspect ratio. This triggers a KUidECamEventPixelAspectRatio event to all MCameraObserver2 clients.
| CCamera::CCameraAdvancedSettings::TPixelAspectRatio aPixelAspectRatio | a value of TPixelAspectRatio denoting the new pixel aspect ratio. |
| void | SetRedEyeReduceOn | ( | TBool | aState | ) | [pure virtual] |
Sets the flash red eye reduction on or off.
Triggers a KUidECamEventCameraSettingFlashRedEyeReduce event to all camera MCameraObserver2 clients.
| TBool aState | The required state ETrue for switching it on and EFalse for switching it off. |
| void | SetShootClickOn | ( | TBool | aShootClickOn | ) | [pure virtual] |
Sets the button clicking sound effect on /off. Triggers a KUidECamEventSoundClick event to all MCameraObserver2 clients.
| TBool aShootClickOn | boolean, ETrue to switch clicking sound on, EFalse sound is switched off. |
| void | SetShutterSpeed | ( | TInt | aShutterSpeed | ) | [pure virtual] |
Sets the current shutter speed. When set, all MCameraObserver2 clients of the camera receive a KUidECamEventCameraSettingShutterSpeed event
| TInt aShutterSpeed | the required shutter speed in microseconds. |
| void | SetStabilizationComplexity | ( | CCamera::CCameraAdvancedSettings::TStabilizationAlgorithmComplexity | aComplexity | ) | [pure virtual] |
Sets a specific stabilization algorithm on the device. When a value is set, MCameraObserver2 clients for that camera will receive a KUidECamEventSettingsStabilizationAlgorithmComplexity event notification.
| CCamera::CCameraAdvancedSettings::TStabilizationAlgorithmComplexity aComplexity | stabilization effect selection of type TStabilizationAlgorithmComplexity. |
| void | SetStabilizationEffect | ( | CCamera::CCameraAdvancedSettings::TStabilizationEffect | aEffect | ) | [pure virtual] |
Sets a specific stabilization effect on the device. When a value is set, MCameraObserver2 clients for that camera will receive a KUidECamEventCameraSettingsStabilizationEffect event notification.
| CCamera::CCameraAdvancedSettings::TStabilizationEffect aEffect | stabilization effect selection of type TStabilizationEffect. |
| void | SetStabilizationMode | ( | CCamera::CCameraAdvancedSettings::TStabilizationMode | aStabilizationMode | ) | [pure virtual] |
Sets a specific stabilization mode on the device.
Stabilization mode change fires a KUidECamEventCameraSettingStabilizationMode event to all MCameraObserver2 clients of this specific camera.
| CCamera::CCameraAdvancedSettings::TStabilizationMode aStabilizationMode | new stabilization mode of TStabilizationMode type. |
| void | SetTimeLapse | ( | const TTime & | aStart, |
| const TTime & | aEnd, | |||
| const TTime & | aInterval | |||
| ) | [pure virtual] | |||
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.
| void | SetTimerInterval | ( | TInt | aTimerInterval | ) | [pure virtual] |
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.
| TInt aTimerInterval | The selected timer interval in microseconds |
| void | SetWBColorTemperature | ( | TInt | aWBColorTemperature | ) | [pure virtual] |
Set white balance value using a temperature, measured in Kelvin. Change in value causes an event notification KUidECamEventCameraSettingsWBValue to be sent to all MCameraObserver2 clients of this camera.
| TInt aWBColorTemperature | the new white balance value in Kelvin. |
| void | SetWBRgbValue | ( | const TRgb & | aValue | ) | [pure virtual] |
Set white balance value using a RGB triplet ( TRgb ). Change in value causes an event notification KUidECamEventCameraSettingsWBValue to be sent to all MCameraObserver2 clients of this camera.
| const TRgb & aValue | a const reference to TRgb object, which contains the new white balance. |
| void | SetWhiteBalanceMode | ( | CCamera::TWhiteBalance | aWhiteBalanceMode | ) | [pure virtual] |
Sets the white balance adjustment of the device.
No effect if this is not supported, see TCameraInfo::iWhiteBalanceModesSupported . Triggers a KUidECamEventCameraSettingWhiteBalanceMode event to all MCameraObserver2 clients.
| CCamera::TWhiteBalance aWhiteBalanceMode | The required white balance mode. |
| void | SetYuvRange | ( | CCamera::CCameraAdvancedSettings::TYuvRange | aYuvRange | ) | [pure virtual] |
Set a new YUV range. This triggers a KUidECamEventYuvRange event to all MCameraObserver2 clients.
| CCamera::CCameraAdvancedSettings::TYuvRange aYuvRange | a value of TYuvRange denoting the new YUV range. |
| TBool | ShootClickOn | ( | ) | const [pure virtual] |
Gets the current state for button clicking sound effect.
| TInt | ShutterSpeed | ( | ) | const [pure virtual] |
Gets the current shutter speed
In case there is an error, a negative error value from system wide error should be returned.
| CCamera::CCameraAdvancedSettings::TStabilizationAlgorithmComplexity | StabilizationComplexity | ( | ) | const [pure virtual] |
Gets current active stabilization algorithm selection on the device.
| CCamera::CCameraAdvancedSettings::TStabilizationEffect | StabilizationEffect | ( | ) | const [pure virtual] |
Gets current active stabilization effect on the device.
| CCamera::CCameraAdvancedSettings::TStabilizationMode | StabilizationMode | ( | ) | const [pure virtual] |
Gets current stabilization mode on the device. The result is a valid TStabilizationMode value.
| TInt | SupportedAutoFocusAreas | ( | ) | const [pure virtual] |
Gets all supported auto focus areas on the device.
| TInt | SupportedAutoFocusTypes | ( | ) | const [pure virtual] |
Gets all supported auto focus types on the device.
| TInt | SupportedBracketModes | ( | ) | const [pure virtual] |
Get all supported bracket modes as bitfields.
| TInt | SupportedBracketParameters | ( | ) | const [pure virtual] |
Get all supported bracket parameters as bitfields.
| TInt | SupportedBracketSteps | ( | ) | const [pure virtual] |
Get all supported bracket steps as bitfields.
| TInt | SupportedDriveModes | ( | ) | const [pure virtual] |
Get all supported drive modes as bitfields of TDriveMode type.
| TInt | SupportedExposureModes | ( | ) | const [pure virtual] |
Get Supported exposure modes - bitfields of CCamera::TExposure
| TInt | SupportedFlashModes | ( | ) | const [pure virtual] |
Get camera all supported flash modes CCamera::TFlash
| TInt | SupportedFocusModes | ( | ) | const [pure virtual] |
Gets all of the supported focus modes on the device. The result is a bitfield of the valid TFocusMode flags.
| TInt | SupportedFocusRanges | ( | ) | const [pure virtual] |
Gets all supported focus ranges on the device.
| TInt | SupportedMeteringModes | ( | ) | const [pure virtual] |
Get all supported metering modes on this device represented as bitfield of type TMeteringMode.
| TInt | SupportedPixelAspectRatios | ( | ) | const [pure virtual] |
Get supported pixel aspect ratio.
| TInt | SupportedStabilizationComplexityValues | ( | ) | const [pure virtual] |
Gets all supported stabilization algorithm values on the device.
| TInt | SupportedStabilizationEffects | ( | ) | const [pure virtual] |
Gets all supported stabilization effects on the device.
| TInt | SupportedStabilizationModes | ( | ) | const [pure virtual] |
Gets all of the supported stabilization modes on the device. The result is a bitfield of the valid TStabilizationMode flags.
| CCamera::CCameraAdvancedSettings::TWBUnits | SupportedWBUnits | ( | ) | const [pure virtual] |
Gets the units in which the white balance is measured on the device. The methods used to get or set these differ depending on the supported unit type. It is expected that a device will support only a single type or none.
| TInt | SupportedWhiteBalanceModes | ( | ) | const [pure virtual] |
Gets camera supported set of white balance adjustments.
| TInt | TimerInterval | ( | ) | const [pure virtual] |
Get current timer value. Active only when drive mode is EDriveModeTimed. Timer resolution is in microseconds.
In case there is an error, a negative error value from system wide error should be returned.
| TInt | WBColorTemperature | ( | ) | const [pure virtual] |
Get the white balance as a temperature in Kelvin.
In case there is an error, a negative error value from system wide error should be returned.
| CCamera::TWhiteBalance | WhiteBalanceMode | ( | ) | const [pure virtual] |
Gets the current white balance value.
| CCamera::CCameraAdvancedSettings::TYuvRange | YuvRange | ( | ) | const [pure virtual] |
Get the current YUV range.
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.