QCameraImageProcessing Class▲
-
Header: QCameraImageProcessing
-
qmake: QT += multimedia
-
Inherits: QObject
-
Group: QCameraImageProcessing is part of multimedia, multimedia_camera
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 appliedIn 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▲
See also QCameraImageProcessingControl
Member Type Documentation▲
[since 5.5] 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. |
Member Function Documentation▲
qreal QCameraImageProcessing::brightness() const▲
[since 5.5] QCameraImageProcessing::ColorFilter QCameraImageProcessing::colorFilter() const▲
Returns the color filter which will be applied to image data captured by the camera.
This function was introduced in Qt 5.5.
See Also▲
See also setColorFilter()
qreal QCameraImageProcessing::contrast() const▲
qreal QCameraImageProcessing::denoisingLevel() const▲
bool QCameraImageProcessing::isAvailable() const▲
Returns true if image processing related settings are supported by this camera.
[since 5.5] bool QCameraImageProcessing::isColorFilterSupported(QCameraImageProcessing::ColorFilter filter) const▲
Returns true if a color filter is supported.
This function was introduced in Qt 5.5.
bool QCameraImageProcessing::isWhiteBalanceModeSupported(QCameraImageProcessing::WhiteBalanceMode mode) const▲
Returns true if the white balance mode is supported.
qreal QCameraImageProcessing::manualWhiteBalance() const▲
Returns the current color temperature if the current white balance mode is WhiteBalanceManual. For other modes the return value is undefined.
See Also▲
See also setManualWhiteBalance()
qreal QCameraImageProcessing::saturation() const▲
void QCameraImageProcessing::setBrightness(qreal value)▲
Set the brightness adjustment to value.
Valid brightness adjustment values range between -1.0 and 1.0, with a default of 0.
See Also▲
See also brightness()
[since 5.5] void QCameraImageProcessing::setColorFilter(QCameraImageProcessing::ColorFilter filter)▲
Sets the color filter which will be applied to image data captured by the camera.
This function was introduced in Qt 5.5.
See Also▲
See also colorFilter()
void QCameraImageProcessing::setContrast(qreal value)▲
Set the contrast adjustment to value.
Valid contrast adjustment values range between -1.0 and 1.0, with a default of 0.
See Also▲
See also contrast()
void QCameraImageProcessing::setDenoisingLevel(qreal level)▲
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▲
See also denoisingLevel()
void QCameraImageProcessing::setManualWhiteBalance(qreal colorTemperature)▲
Sets manual white balance to colorTemperature. This is used when whiteBalanceMode() is set to WhiteBalanceManual. The units are Kelvin.
See Also▲
See also manualWhiteBalance()
void QCameraImageProcessing::setSaturation(qreal value)▲
Sets the saturation adjustment value to value.
Valid saturation values range between -1.0 and 1.0, with a default of 0.
See Also▲
See also saturation()
void QCameraImageProcessing::setSharpeningLevel(qreal level)▲
Sets the sharpening adjustment level.
Valid sharpening values range between -1.0 and 1.0, with a default of 0.
See Also▲
See also sharpeningLevel()
void QCameraImageProcessing::setWhiteBalanceMode(QCameraImageProcessing::WhiteBalanceMode mode)▲
qreal QCameraImageProcessing::sharpeningLevel() const▲
See Also▲
See also setSharpeningLevel()