QCameraImageProcessing

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

Inheritance diagram of PySide2.QtMultimedia.QCameraImageProcessing

Synopsis

Functions

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 .

class PySide2.QtMultimedia.QCameraImageProcessing
PySide2.QtMultimedia.QCameraImageProcessing.WhiteBalanceMode

Constant

Description

QCameraImageProcessing.WhiteBalanceAuto

Auto white balance mode.

QCameraImageProcessing.WhiteBalanceManual

Manual white balance. In this mode the white balance should be set with setManualWhiteBalance()

QCameraImageProcessing.WhiteBalanceSunlight

Sunlight white balance mode.

QCameraImageProcessing.WhiteBalanceCloudy

Cloudy white balance mode.

QCameraImageProcessing.WhiteBalanceShade

Shade white balance mode.

QCameraImageProcessing.WhiteBalanceTungsten

Tungsten (incandescent) white balance mode.

QCameraImageProcessing.WhiteBalanceFluorescent

Fluorescent white balance mode.

QCameraImageProcessing.WhiteBalanceFlash

Flash white balance mode.

QCameraImageProcessing.WhiteBalanceSunset

Sunset white balance mode.

QCameraImageProcessing.WhiteBalanceVendor

Base value for vendor defined white balance modes.

PySide2.QtMultimedia.QCameraImageProcessing.ColorFilter

Constant

Description

QCameraImageProcessing.ColorFilterNone

No filter is applied to images.

QCameraImageProcessing.ColorFilterGrayscale

A grayscale filter.

QCameraImageProcessing.ColorFilterNegative

A negative filter.

QCameraImageProcessing.ColorFilterSolarize

A solarize filter.

QCameraImageProcessing.ColorFilterSepia

A sepia filter.

QCameraImageProcessing.ColorFilterPosterize

A posterize filter.

QCameraImageProcessing.ColorFilterWhiteboard

A whiteboard filter.

QCameraImageProcessing.ColorFilterBlackboard

A blackboard filter.

QCameraImageProcessing.ColorFilterAqua

An aqua filter.

QCameraImageProcessing.ColorFilterVendor

The base value for vendor defined filters.

PySide2.QtMultimedia.QCameraImageProcessing.brightness()
Return type:

float

Returns the brightness adjustment setting.

See also

setBrightness()

PySide2.QtMultimedia.QCameraImageProcessing.colorFilter()
Return type:

ColorFilter

Returns the color filter which will be applied to image data captured by the camera.

See also

setColorFilter()

PySide2.QtMultimedia.QCameraImageProcessing.contrast()
Return type:

float

Returns the contrast adjustment setting.

See also

setContrast()

PySide2.QtMultimedia.QCameraImageProcessing.denoisingLevel()
Return type:

float

Returns the denoising adjustment level.

PySide2.QtMultimedia.QCameraImageProcessing.isAvailable()
Return type:

bool

Returns true if image processing related settings are supported by this camera.

PySide2.QtMultimedia.QCameraImageProcessing.isColorFilterSupported(filter)
Parameters:

filterColorFilter

Return type:

bool

Returns true if a color filter is supported.

PySide2.QtMultimedia.QCameraImageProcessing.isWhiteBalanceModeSupported(mode)
Parameters:

modeWhiteBalanceMode

Return type:

bool

Returns true if the white balance mode is supported.

PySide2.QtMultimedia.QCameraImageProcessing.manualWhiteBalance()
Return type:

float

Returns the current color temperature if the current white balance mode is WhiteBalanceManual . For other modes the return value is undefined.

PySide2.QtMultimedia.QCameraImageProcessing.saturation()
Return type:

float

Returns the saturation adjustment value.

See also

setSaturation()

PySide2.QtMultimedia.QCameraImageProcessing.setBrightness(value)
Parameters:

value – float

Set the brightness adjustment to value .

Valid brightness adjustment values range between -1.0 and 1.0, with a default of 0.

See also

brightness()

PySide2.QtMultimedia.QCameraImageProcessing.setColorFilter(filter)
Parameters:

filterColorFilter

Sets the color filter which will be applied to image data captured by the camera.

See also

colorFilter()

PySide2.QtMultimedia.QCameraImageProcessing.setContrast(value)
Parameters:

value – float

Set the contrast adjustment to value .

Valid contrast adjustment values range between -1.0 and 1.0, with a default of 0.

See also

contrast()

PySide2.QtMultimedia.QCameraImageProcessing.setDenoisingLevel(value)
Parameters:

value – float

Sets the denoising adjustment level .

Valid denoising values range between -1.0 and 1.0, with a default of 0.

If the parameter value is set to 0, the amount of denoising applied is selected by camera and depends on camera capabilities and settings. Changing value in -1.0..1.0 range adjusts the amount of denoising applied within the supported range.

See also

denoisingLevel()

PySide2.QtMultimedia.QCameraImageProcessing.setManualWhiteBalance(colorTemperature)
Parameters:

colorTemperature – float

Sets manual white balance to colorTemperature . This is used when whiteBalanceMode() is set to WhiteBalanceManual . The units are Kelvin.

PySide2.QtMultimedia.QCameraImageProcessing.setSaturation(value)
Parameters:

value – float

Sets the saturation adjustment value to value .

Valid saturation values range between -1.0 and 1.0, with a default of 0.

See also

saturation()

PySide2.QtMultimedia.QCameraImageProcessing.setSharpeningLevel(value)
Parameters:

value – float

Sets the sharpening adjustment level .

Valid sharpening values range between -1.0 and 1.0, with a default of 0.

PySide2.QtMultimedia.QCameraImageProcessing.setWhiteBalanceMode(mode)
Parameters:

modeWhiteBalanceMode

Sets the white balance to mode .

PySide2.QtMultimedia.QCameraImageProcessing.sharpeningLevel()
Return type:

float

Returns the sharpening adjustment level.

PySide2.QtMultimedia.QCameraImageProcessing.whiteBalanceMode()
Return type:

WhiteBalanceMode

Returns the white balance mode being used.