| class MCameraPresets |
Mixin class for implementation by providers of the Presets Camera Extension API.
This API is used to simplify user - camera interaction by allowing simultaneous setting of various advanced camera hardware settings using a single parameter.
A preset is identified by a single UID and relates to a known predefined outcome. For example the 'Night' Preset is used to set the camera into a night mode so that the user can take photos in dark conditions.
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.
| Public Member Functions | |
|---|---|
| void | GetAffectedSettingsL(RArray< TUid > &) |
| void | GetAssociatedSettingsL(TUid, RArray< TUid > &) |
| void | GetSupportedPresetsL(RArray< TUid > &) |
| TUid | Preset() |
| void | Release() |
| void | SetPreset(TUid) |
| void | GetAffectedSettingsL | ( | RArray< TUid > & | aSettings | ) | const [pure virtual] |
Gets all settings affected by the current preset. All settings that are related to the preset in question will be included in the list, including any whose values have not changed as a result of applying the preset.
| void | GetAssociatedSettingsL | ( | TUid | aPreset, |
| RArray< TUid > & | aSettings | |||
| ) | const [pure virtual] | |||
Gets all settings associated with a specific preset. This function does not require a preset to have been set prior the call as in GetAffectedSettingsL() function. The returned array will contain the UIDs of all settings which are associated and potentially affected by that particular preset.
| void | GetSupportedPresetsL | ( | RArray< TUid > & | aPresets | ) | const [pure virtual] |
Gets the presets supported by the device. These are identified by UIDs and relate to a known expected 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.
| TUid | Preset | ( | ) | const [pure virtual] |
Gets the preset that was established by the last call to MCameraPresets SetPreset()
A particular preset is only active if it was established (through a call to MCameraPresets SetPreset()) as the most recent operation affecting camera settings. If some other camera setting is changed after calling MCameraPresets SetPreset() then the preset is no longer active.
| void | SetPreset | ( | TUid | aPreset | ) | [pure virtual] |
Sets a specific preset supported by the camera. All clients, implementing the MCameraObserver2 interface will receive a notification with the UID of the specific preset, signalling a new preset has been selected.
A particular preset is only active if it was established (through a call to MCameraPresets SetPreset()) as the most recent operation affecting camera settings. If some other camera setting is changed after calling MCameraPresets SetPreset() then the preset is no longer active.
| TUid aPreset | The UID of the new requested preset. |
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.