内容

公共类型
公共函数
详细描述

QCameraImageProcessing Class

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

头：	#include <QCameraImageProcessing>
qmake:	QT += multimedia
继承：	QObject

所有成员列表，包括继承成员

公共类型

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

公共函数

qreal	brightness () const
ColorFilter	colorFilter () const
qreal	contrast () const
qreal	denoisingLevel () const
bool	isAvailable () const
bool	isColorFilterSupported (ColorFilter filter ) const
bool	isWhiteBalanceModeSupported (WhiteBalanceMode mode ) const
qreal	manualWhiteBalance () const
qreal	saturation () const
void	setBrightness (qreal value )
void	setColorFilter (ColorFilter filter )
void	setContrast (qreal value )
void	setDenoisingLevel (qreal level )
void	setManualWhiteBalance (qreal colorTemperature )
void	setSaturation (qreal value )
void	setSharpeningLevel (qreal level )
void	setWhiteBalanceMode (WhiteBalanceMode mode )
qreal	sharpeningLevel () const
WhiteBalanceMode	whiteBalanceMode () const

32 公共函数继承自 QObject

额外继承成员

1 特性继承自 QObject
1 公共槽继承自 QObject
2 信号继承自 QObject
11 静态公共成员继承自 QObject
9 保护函数继承自 QObject

详细描述

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 对象。

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 摄像头图像处理 .

另请参阅 QCameraImageProcessingControl .

成员类型文档编制

enum QCameraImageProcessing:: ColorFilter

常量	值	描述
`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.

该枚举在 Qt 5.5 引入或被修改。

enum QCameraImageProcessing:: WhiteBalanceMode

常量	值	描述
`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.

成员函数文档编制

qreal QCameraImageProcessing:: brightness () const

Returns the brightness adjustment setting.

另请参阅 setBrightness ().

ColorFilter QCameraImageProcessing:: colorFilter () const

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

该函数在 Qt 5.5 引入。

另请参阅 setColorFilter ().

qreal QCameraImageProcessing:: contrast () const

Returns the contrast adjustment setting.

另请参阅 setContrast ().

qreal QCameraImageProcessing:: denoisingLevel () const

Returns the denoising adjustment level.

另请参阅 setDenoisingLevel ().

bool QCameraImageProcessing:: isAvailable () const

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

bool QCameraImageProcessing:: isColorFilterSupported ( ColorFilter filter ) const

Returns true if a color filter is supported.

该函数在 Qt 5.5 引入。

bool QCameraImageProcessing:: isWhiteBalanceModeSupported ( 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.

另请参阅 setManualWhiteBalance ().

qreal QCameraImageProcessing:: saturation () const

Returns the saturation adjustment value.

另请参阅 setSaturation ().

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.

另请参阅 brightness ().

void QCameraImageProcessing:: setColorFilter ( ColorFilter filter )

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

该函数在 Qt 5.5 引入。

另请参阅 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.

另请参阅 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.

另请参阅 denoisingLevel ().

void QCameraImageProcessing:: setManualWhiteBalance ( qreal colorTemperature )

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

另请参阅 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.

另请参阅 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.

另请参阅 sharpeningLevel ().

void QCameraImageProcessing:: setWhiteBalanceMode ( WhiteBalanceMode mode )

Sets the white balance to mode .

另请参阅 whiteBalanceMode ().

qreal QCameraImageProcessing:: sharpeningLevel () const

Returns the sharpening adjustment level.

另请参阅 setSharpeningLevel ().

WhiteBalanceMode QCameraImageProcessing:: whiteBalanceMode () const

Returns the white balance mode being used.

另请参阅 setWhiteBalanceMode ().