QCameraImageProcessing露

PyQt5.QtMultimedia.QCameraImageProcessing: Inherits from QObject.

Description露

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

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.

Enums露

ColorFilter

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

WhiteBalanceMode

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

Methods露

brightness() → float: Returns the brightness adjustment setting.

See also

setBrightness().

colorFilter() → ColorFilter: Returns the color filter which will be applied to image data captured by the camera.

See also

setColorFilter().

contrast() → float: Returns the contrast adjustment setting.

See also

setContrast().

denoisingLevel() → float: Returns the denoising adjustment level.

See also

setDenoisingLevel().

isAvailable() → bool: Returns true if image processing related settings are supported by this camera.

isColorFilterSupported(ColorFilter) → bool: Returns true if a color filter is supported.

isWhiteBalanceModeSupported(WhiteBalanceMode) → bool: Returns true if the white balance mode is supported.

manualWhiteBalance() → float: Returns the current color temperature if the current white balance mode is WhiteBalanceManual. For other modes the return value is undefined.

See also

setManualWhiteBalance().

saturation() → float: Returns the saturation adjustment value.

See also

setSaturation().

setBrightness(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().

setColorFilter(ColorFilter): Sets the color filter which will be applied to image data captured by the camera.

See also

colorFilter().

setContrast(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().

setDenoisingLevel(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().

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

See also

manualWhiteBalance().

setSaturation(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().

setSharpeningLevel(float)

Sets the sharpening adjustment level.

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

See also

sharpeningLevel().

setWhiteBalanceMode(WhiteBalanceMode): Sets the white balance to mode.

See also

whiteBalanceMode().

sharpeningLevel() → float: Returns the sharpening adjustment level.

See also

setSharpeningLevel().

whiteBalanceMode() → WhiteBalanceMode: Returns the white balance mode being used.

See also

setWhiteBalanceMode().