QCameraImageProcessing Class

The QCameraImageProcessing class provides an interface for image processing related camera settings. More...

Header:	#include <QCameraImageProcessing>
qmake:	QT += multimedia
Inherits:	QObject

List of all members, including inherited members

Public Types

enum	ColorFilter { ColorFilterNone, ColorFilterGrayscale, ColorFilterNegative, ColorFilterSolarize, ColorFilterSepia, …, ColorFilterVendor }
enum	WhiteBalanceMode { WhiteBalanceAuto, WhiteBalanceManual, WhiteBalanceSunlight, WhiteBalanceCloudy, WhiteBalanceShade, …, WhiteBalanceVendor }

Detailed Description

After capturing the data for a camera frame, the camera hardware and software performs various image processing tasks to produce a final image. This includes compensating for ambient light color, reducing noise, as well as making some other adjustments to the image.

You can retrieve this class from an instance of a QCamera object.

For example, you can set the white balance (or color temperature) used for processing images:

 camera = new QCamera;
 QCameraImageProcessing *imageProcessing = camera->imageProcessing();

 if (imageProcessing->isAvailable()) {
     imageProcessing->setWhiteBalanceMode(QCameraImageProcessing::WhiteBalanceFluorescent);
 }

Or adjust the amount of denoising performed:

 imageProcessing->setDenoisingLevel(-0.3); //reduce the amount of denoising applied

In some cases changing these settings may result in a longer delay before an image is ready.

For more information on image processing of camera frames, see Camera Image Processing.

See also QCameraImageProcessingControl.

Member Type Documentation

enum QCameraImageProcessing::ColorFilter

Constant	Value	Description
`QCameraImageProcessing::ColorFilterNone`	`0`	No filter is applied to images.
`QCameraImageProcessing::ColorFilterGrayscale`	`1`	A grayscale filter.
`QCameraImageProcessing::ColorFilterNegative`	`2`	A negative filter.
`QCameraImageProcessing::ColorFilterSolarize`	`3`	A solarize filter.
`QCameraImageProcessing::ColorFilterSepia`	`4`	A sepia filter.
`QCameraImageProcessing::ColorFilterPosterize`	`5`	A posterize filter.
`QCameraImageProcessing::ColorFilterWhiteboard`	`6`	A whiteboard filter.
`QCameraImageProcessing::ColorFilterBlackboard`	`7`	A blackboard filter.
`QCameraImageProcessing::ColorFilterAqua`	`8`	An aqua filter.
`QCameraImageProcessing::ColorFilterVendor`	`1000`	The base value for vendor defined filters.

This enum was introduced or modified in Qt 5.5.

enum QCameraImageProcessing::WhiteBalanceMode

Constant	Value	Description
`QCameraImageProcessing::WhiteBalanceAuto`	`0`	Auto white balance mode.
`QCameraImageProcessing::WhiteBalanceManual`	`1`	Manual white balance. In this mode the white balance should be set with setManualWhiteBalance()
`QCameraImageProcessing::WhiteBalanceSunlight`	`2`	Sunlight white balance mode.
`QCameraImageProcessing::WhiteBalanceCloudy`	`3`	Cloudy white balance mode.
`QCameraImageProcessing::WhiteBalanceShade`	`4`	Shade white balance mode.
`QCameraImageProcessing::WhiteBalanceTungsten`	`5`	Tungsten (incandescent) white balance mode.
`QCameraImageProcessing::WhiteBalanceFluorescent`	`6`	Fluorescent white balance mode.
`QCameraImageProcessing::WhiteBalanceFlash`	`7`	Flash white balance mode.
`QCameraImageProcessing::WhiteBalanceSunset`	`8`	Sunset white balance mode.
`QCameraImageProcessing::WhiteBalanceVendor`	`1000`	Base value for vendor defined white balance modes.