Qt Mobility Reference Documentation

QCameraImageProcessingControl Class Reference

The QCameraImageProcessingControl class provides an abstract class for controling image processing parameters, like white balance, contrast, saturation, sharpening and denoising. More...

 #include <QCameraImageProcessingControl>

This class is under development and is subject to change.

Inherits QMediaControl.


Public Types

enum ProcessingParameter { Contrast, Saturation, Brightness, Sharpening, Denoising }

Public Functions

~QCameraImageProcessingControl ()
virtual bool isProcessingParameterSupported ( ProcessingParameter parameter ) const = 0
virtual bool isWhiteBalanceModeSupported ( QCameraImageProcessing::WhiteBalanceMode mode ) const = 0
virtual int manualWhiteBalance () const = 0
virtual QByteArray preset () const = 0
virtual QString presetDescription ( const QByteArray & preset ) const = 0
virtual QVariant processingParameter ( ProcessingParameter parameter ) const = 0
virtual void setManualWhiteBalance ( int colorTemperature ) = 0
virtual void setPreset ( const QByteArray & preset ) = 0
virtual void setProcessingParameter ( ProcessingParameter parameter, QVariant value ) = 0
virtual void setWhiteBalanceMode ( QCameraImageProcessing::WhiteBalanceMode mode ) = 0
virtual QList<QByteArray> supportedPresets () const = 0
virtual QCameraImageProcessing::WhiteBalanceMode whiteBalanceMode () const = 0

Protected Functions

QCameraImageProcessingControl ( QObject * parent = 0 )

Macros

QCameraImageProcessingControl_iid

Detailed Description

The QCameraImageProcessingControl class provides an abstract class for controling image processing parameters, like white balance, contrast, saturation, sharpening and denoising.

The interface name of QCameraImageProcessingControl is com.nokia.Qt.QCameraImageProcessingControl/1.0 as defined in QCameraImageProcessingControl_iid.

The Camera API of Qt Mobility is still in Technology Preview. It has not undergone the same level of review and testing as the rest of the APIs.

The API exposed by the classes in this component are not stable, and will undergo modification or removal prior to the final release of Qt Mobility.

See also QMediaService::requestControl() and QCamera.


Member Type Documentation

enum QCameraImageProcessingControl::ProcessingParameter


Member Function Documentation

QCameraImageProcessingControl::QCameraImageProcessingControl ( QObject * parent = 0 ) [protected]

Constructs an image processing control object with parent.

QCameraImageProcessingControl::~QCameraImageProcessingControl ()

Destruct the image processing control object.

bool QCameraImageProcessingControl::isProcessingParameterSupported ( ProcessingParameter parameter ) const [pure virtual]

Returns true if the camera supports adjusting image processing parameter.

Usually the the supported settings is static, but some parameter may not be available depending on other camera settings, like presets. In such case the currently supported parameters should be returned.

bool QCameraImageProcessingControl::isWhiteBalanceModeSupported ( QCameraImageProcessing::WhiteBalanceMode mode ) const [pure virtual]

Returns true if the white balance mode is supported. The backend should support at least QCameraImageProcessing::WhiteBalanceAuto mode.

int QCameraImageProcessingControl::manualWhiteBalance () const [pure virtual]

Return the manual white balance, in K.

See also setManualWhiteBalance().

QByteArray QCameraImageProcessingControl::preset () const [pure virtual]

Retuns the current image processing preset.

See also setPreset().

QString QCameraImageProcessingControl::presetDescription ( const QByteArray & preset ) const [pure virtual]

Returns the image processing preset description.

QVariant QCameraImageProcessingControl::processingParameter ( ProcessingParameter parameter ) const [pure virtual]

Returns the image processing parameter value.

See also setProcessingParameter().

void QCameraImageProcessingControl::setManualWhiteBalance ( int colorTemperature ) [pure virtual]

Set the white balance to colorTemperature

See also manualWhiteBalance().

void QCameraImageProcessingControl::setPreset ( const QByteArray & preset ) [pure virtual]

Sets the current image processing preset.

See also preset().

void QCameraImageProcessingControl::setProcessingParameter ( ProcessingParameter parameter, QVariant value ) [pure virtual]

Sets the image processing parameter value. Passing the null or invalid QVariant value allows backend to choose the suitable parameter value.

The valid values range depends on the parameter type, for contrast, saturation and brightness value should be between -100 and 100, the default is 0,

For sharpening and denoising the range is 0..100, 0 for sharpening or denoising disabled and 100 for maximum sharpening/denoising applied.

See also processingParameter().

void QCameraImageProcessingControl::setWhiteBalanceMode ( QCameraImageProcessing::WhiteBalanceMode mode ) [pure virtual]

Set the white balance mode to mode

See also whiteBalanceMode().

QList<QByteArray> QCameraImageProcessingControl::supportedPresets () const [pure virtual]

Returns the list of image processing presets camera supports.

QCameraImageProcessing::WhiteBalanceMode QCameraImageProcessingControl::whiteBalanceMode () const [pure virtual]

Return the white balance mode being used.

See also setWhiteBalanceMode().


Macro Documentation

QCameraImageProcessingControl_iid

com.nokia.Qt.QCameraImageProcessingControl/1.0

Defines the interface name of the QCameraImageProcessingControl class.


Copyright © 2009-2010 Nokia Corporation and/or its subsidiary(-ies) Trademarks
Qt Mobility Project 1.1.0