QCameraImageProcessing¶

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

Synopsis¶

Functions¶

def brightness ()
def colorFilter ()
def contrast ()
def denoisingLevel ()
def isAvailable ()
def isColorFilterSupported (filter)
def isWhiteBalanceModeSupported (mode)
def manualWhiteBalance ()
def saturation ()
def setBrightness (value)
def setColorFilter (filter)
def setContrast (value)
def setDenoisingLevel (value)
def setManualWhiteBalance (colorTemperature)
def setSaturation (value)
def setSharpeningLevel (value)
def setWhiteBalanceMode (mode)
def sharpeningLevel ()
def whiteBalanceMode ()

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

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: qreal

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: qreal

Returns the contrast adjustment setting.

See also

setContrast()

PySide2.QtMultimedia.QCameraImageProcessing.denoisingLevel()¶

Return type: qreal

Returns the denoising adjustment level.

See also

setDenoisingLevel()

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: filter – ColorFilter
Return type: bool

Returns true if a color filter is supported.

PySide2.QtMultimedia.QCameraImageProcessing.isWhiteBalanceModeSupported(mode)¶

Parameters: mode – WhiteBalanceMode
Return type: bool

Returns true if the white balance mode is supported.

PySide2.QtMultimedia.QCameraImageProcessing.manualWhiteBalance()¶

Return type: qreal

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

See also

setManualWhiteBalance()

PySide2.QtMultimedia.QCameraImageProcessing.saturation()¶

Return type: qreal

Returns the saturation adjustment value.

See also

setSaturation()

PySide2.QtMultimedia.QCameraImageProcessing.setBrightness(value)¶

Parameters: value – qreal

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: filter – ColorFilter

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 – qreal

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 – qreal

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)¶