| class MCameraImageProcessing |
Mixin class for implementation by providers of the Image Processing Camera Extension API.
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.
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.
| Public Member Functions | |
|---|---|
| void | GetActiveTransformSequenceL(RArray< TUid > &) |
| void | GetActiveTransformationsL(RArray< TUid > &) |
| void | GetSourceRect(TRect &) |
| void | GetSupportedTransformationsL(RArray< TUid > &) |
| void | GetTransformationSupportedValuesL(TUid, RArray< TInt > &, TValueInfo &) |
| TInt | GetTransformationValue(TUid, TInt &) |
| void | Release() |
| void | SetActiveTransformSequenceL(RArray< TUid > &) |
| void | SetSourceRect(const TRect &) |
| void | SetTransformationValue(TUid, TInt) |
| TInt | TransformationValue(TUid) |
| void | GetActiveTransformSequenceL | ( | RArray< TUid > & | aTransformSequence | ) | const [pure virtual] |
Get the sequence of all active transforms, ordered in order of execution.
| void | GetActiveTransformationsL | ( | RArray< TUid > & | aTransformations | ) | const [pure virtual] |
Get currently active transformations on the camera.
| void | GetSourceRect | ( | TRect & | aRect | ) | const [pure virtual] |
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.
| TRect & aRect | a reference to a TRect object to hold the current source rectangle coordinates. If it has not been set, the coordinates match these of the whole image. |
| void | GetSupportedTransformationsL | ( | RArray< TUid > & | aTransformations | ) | const [pure virtual] |
Get all transformations supported on the camera.
| void | GetTransformationSupportedValuesL | ( | TUid | aTransformation, |
| RArray< TInt > & | aValues, | |||
| TValueInfo & | aInfo | |||
| ) | const [pure virtual] | |||
Get all values supported by an active transformation.
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 should be returned and TValueInfo should be ENotActive, and the corresponding getter/setters for this feature should not be used.
| TUid aTransformation | The UID of active transform for which values are requested. |
| RArray< TInt > & aValues | An array of integers to represent the values for the requested transformation. |
| TValueInfo & aInfo | Additional information describing the returned array of values. |
| TInt | GetTransformationValue | ( | TUid | aTransformation, |
| TInt & | aTransformationValue | |||
| ) | const [pure virtual] | |||
Get the current value of a transformation
| void | SetActiveTransformSequenceL | ( | RArray< TUid > & | aTransformSequence | ) | [pure virtual] |
Set the order of all active transform in terms of execution. The transforms with smaller index are executed earlier.
| void | SetSourceRect | ( | const TRect & | aRect | ) | [pure virtual] |
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.
| const TRect & aRect | a reference to TRect object which describes the coordinates of the area of interest. |
| void | SetTransformationValue | ( | TUid | aTransformation, |
| TInt | aValue | |||
| ) | [pure virtual] | |||
Set new value for a transformation. A notification event with the transformation UID is sent to all clients. UIDs are in the form KUidECamEventImageProcessingXXXX.
| TInt | TransformationValue | ( | TUid | aTransformation | ) | const [pure virtual] |
Use TInt GetTransformationValue(TUid aTransformation, TInt& aTransformationValue);
Get the current value of a transformation
| TUid aTransformation | The UID of the transformation |
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.