QCamera 类

QCamera 类提供了对系统相机设备的接口。更多...

头文件	#include <QCamera>
CMake	find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake	QT += multimedia
实例化	Camera
继承	QObject

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

公共类型

枚举	Error { NoError, CameraError }
枚举	ExposureMode { ExposureAuto, ExposureManual, ExposurePortrait, ExposureNight, ExposureSports, …, ExposureBarcode }
枚举类	Feature { ColorTemperature, ExposureCompensation, IsoSensitivity, ManualExposureTime, CustomFocusPoint, FocusDistance }
标志	特征
枚举	FlashMode { FlashOff, FlashOn, FlashAuto }
枚举	FocusMode { FocusModeAuto, FocusModeAutoNear, FocusModeAutoFar, FocusModeHyperfocal, FocusModeInfinity, FocusModeManual }
枚举	TorchMode { TorchOff, TorchOn, TorchAuto }
枚举	WhiteBalanceMode { WhiteBalanceAuto, WhiteBalanceManual, WhiteBalanceSunlight, WhiteBalanceCloudy, WhiteBalanceShade, …, WhiteBalanceSunset }

属性

active : bool
cameraDevice : QCameraDevice
cameraFormat : QCameraFormat
colorTemperature : int
customFocusPoint : QPointF
error : const Error
errorString : const QString
exposureCompensation : float
exposureMode : QCamera::ExposureMode
exposureTime : const float
flashMode : QCamera::FlashMode
flashReady : const bool

focusDistance : float
focusMode : FocusMode
focusPoint : const QPointF
isoSensitivity : const int
manualExposureTime : int
manualIsoSensitivity : int
maximumZoomFactor : const float
minimumZoomFactor : const float
supportedFeatures : const Features
torchMode : QCamera::TorchMode
whiteBalanceMode : WhiteBalanceMode
zoomFactor : float

公共函数

	QCamera(QObject *parent = nullptr)
	QCamera(const QCameraDevice &cameraDevice, QObject *parent = nullptr)
	QCamera(QCameraDevice::Position position, QObject *parent = nullptr)
虚	~QCamera()
QCameraDevice	cameraDevice() const
QCameraFormat	cameraFormat() const
QMediaCaptureSession *	captureSession() const
int	colorTemperature() const
QPointF	customFocusPoint() const
QCamera::Error	error() const
QString	errorString() const
float	exposureCompensation() const
QCamera::ExposureMode	exposureMode() const
float	exposureTime() const
QCamera::FlashMode	flashMode() const
float	focusDistance() const
QCamera::FocusMode	focusMode() const
QPointF	focusPoint() const
bool	isActive() const
bool	isAvailable() const
bool	isExposureModeSupported(QCamera::ExposureMode mode) const
bool	isFlashModeSupported(QCamera::FlashMode mode) const
bool	isFlashReady() const
bool	isFocusModeSupported(QCamera::FocusMode mode) const
bool	isTorchModeSupported(QCamera::TorchMode mode) const
bool	isWhiteBalanceModeSupported(QCamera::WhiteBalanceMode mode) const
int	isoSensitivity() const
float	manualExposureTime() const
int	manualIsoSensitivity() const
float	maximumExposureTime() const
int	maximumIsoSensitivity() const
float	maximumZoomFactor() const
float	minimumExposureTime() const
int	minimumIsoSensitivity() const
float	minimumZoomFactor() const
void	setCameraDevice(const QCameraDevice &cameraDevice)
void	setCameraFormat(const QCameraFormat &format)
void	setCustomFocusPoint(const QPointF &point)
void	setFocusDistance(float d)
void	setFocusMode(QCamera::FocusMode mode)
void	setZoomFactor(float factor)
QCamera::Features	supportedFeatures() const
QCamera::TorchMode	torchMode() const
QCamera::WhiteBalanceMode	whiteBalanceMode() const
float	zoomFactor() const

公共槽

void	setActive(bool active)
void	设置自动曝光时间()
void	设置自动ISO灵敏度()
void	setColorTemperature(int colorTemperature)
void	setExposureCompensation(float ev)
void	setExposureMode(QCamera::ExposureMode mode)
void	setFlashMode(QCamera::FlashMode mode)
void	setManualExposureTime(float seconds)
void	setManualIsoSensitivity(int iso)
void	setTorchMode(QCamera::TorchMode mode)
void	setWhiteBalanceMode(QCamera::WhiteBalanceMode mode)
void	开始()
void	停止()
void	zoomTo(float factor, float rate)

信号

void	activeChanged(bool)
void	摄像头设备改变()
void	摄像头格式改变()
void	colorTemperatureChanged() const
void	自定义焦点改变()
void	错误改变()
void	errorOccurred(QCamera::Error error, const QString &errorString)
void	exposureCompensationChanged(float value)
void	曝光模式改变()
void	exposureTimeChanged(float speed)
void	闪光灯模式改变()
void	flashReady(bool ready)
void	focusDistanceChanged(float)
void	焦点模式改变()
void	焦点点改变()
void	isoSensitivityChanged(int value)
void	manualExposureTimeChanged(float speed)
void	manualIsoSensitivityChanged(int)
void	maximumZoomFactorChanged(float)
void	minimumZoomFactorChanged(float)
void	支持的功能改变()
void	torchModeChanged()
void	whiteBalanceModeChanged() const
void	zoomFactorChanged(float)

详细描述

可以将在QMediaCaptureSession中使用QCamera来视频录制和图像捕捉。

可以使用QCameraDevice列出可用的摄像头并选择使用哪个。

const QList<QCameraDevice> cameras = QMediaDevices::videoInputs();
for (const QCameraDevice &cameraDevice : cameras) {
    if (cameraDevice.description() == "mycamera")
        camera = new QCamera(cameraDevice);
}

在支持此功能的硬件上，QCamera允许您调整焦点和缩放。这还包括类似于“微距”模式的功能，用于近距离工作（例如，读取条形码或识别字母），或“触摸对焦” - 指示图像中重要的区域，以便硬件尝试对焦。

camera->setFocusPointMode(QCamera::FocusModeManual);
camera->setCustomFocusPoint(QPointF(0.25f, 0.75f)); // A point near the bottom left, 25% away from the corner, near that shiny vase

最小缩放因子()和最大缩放因子()方法提供了支持的缩放因子范围。zoomTo()方法允许更改缩放因子。

camera->setZoomFactor(3.0);

捕获摄像头帧的原始数据后，摄像头硬件和软件执行各种图像处理任务以生成最终图像。这包括对环境光颜色进行补偿，减少噪声，并对图像进行一些其他调整。

您可以通过摄像头属性控制许多这些处理步骤。例如，您可以设置用于处理图像的白平衡（或颜色温度）

camera->setWhiteBalanceMode(QCamera::WhiteBalanceFluorescent);

有关摄像头帧图像处理的更多信息，请参阅摄像头图像处理。

有关更多信息，请参阅摄像头概述。

成员类型文档

enum QCamera::Error

此枚举保存最后一个错误代码。

常量	值	描述
`QCamera::NoError`	`0`	没有发生错误。
`QCamera::CameraError`	`1`	发生了错误。

enum QCamera::ExposureMode

常量	值	描述
`QCamera::ExposureAuto`	`0`	自动模式。
`QCamera::ExposureManual`	`1`	手动模式。
`QCamera::ExposurePortrait`	`2`	人像曝光模式。
`QCamera::ExposureNight`	`3`	夜景模式。
`QCamera::ExposureSports`	`4`	斑点曝光模式。
`QCamera::ExposureSnow`	`5`	雪地曝光模式。
`QCamera::ExposureBeach`	`6`	海滩曝光模式。
`QCamera::ExposureAction`	`7`	动作模式。自5.5版本起
`QCamera::ExposureLandscape`	`8`	风景模式。自5.5版本起
`QCamera::ExposureNightPortrait`	`9`	夜景人像模式。自5.5版本起
`QCamera::ExposureTheatre`	`10`	舞台模式。自5.5版本起
`QCamera::ExposureSunset`	`11`	日落模式。自5.5版本起
`QCamera::ExposureSteadyPhoto`	`12`	稳像拍摄模式。自5.5版本起
`QCamera::ExposureFireworks`	`13`	烟花模式。自5.5版本起
`QCamera::ExposureParty`	`14`	派对模式。自5.5版本起
`QCamera::ExposureCandlelight`	`15`	烛光模式。自5.5版本起
`QCamera::ExposureBarcode`	`16`	条码模式。自5.5版本起

enum class QCamera::Feature
flags QCamera::Features

描述相机支持的一组功能。返回的值可以是以下值的组合

常量	值	描述
`QCamera::Feature::ColorTemperature`	`0x1`	相机支持设置自定义的颜色温度。
`QCamera::Feature::ExposureCompensation`	`0x2`	相机支持设置自定义的曝光补偿。
`QCamera::Feature::IsoSensitivity`	`0x4`	相机支持设置自定义的ISO敏感度。
`QCamera::Feature::ManualExposureTime`	`0x8`	相机支持设置手动曝光时间。
`QCamera::Feature::CustomFocusPoint`	`0x10`	相机支持设置自定义的焦点。
`QCamera::Feature::FocusDistance`	`0x20`	相机支持设置焦点距离属性。

Features类型是QFlags的typedef。它存储了特征值的OR组合。

enum QCamera::FlashMode

常量	值	描述
`QCamera::FlashOff`	`0`	闪光灯关闭。
`QCamera::FlashOn`	`1`	闪光灯开启。
`QCamera::FlashAuto`	`2`	自动闪光。

enum QCamera::FocusMode

常量	值	描述
`QCamera::FocusModeAuto`	`0`	连续自动对焦模式。
`QCamera::FocusModeAutoNear`	`1`	近距离连续自动对焦模式。
`QCamera::FocusModeAutoFar`	`2`	远距离连续自动对焦模式。
`QCamera::FocusModeHyperfocal`	`3`	对焦到超焦点距离，获得最大景深。从这距离的一半到无穷远的所有物体都将被接受为清晰。
`QCamera::FocusModeInfinity`	`4`	严格对焦到无穷远。
`QCamera::FocusModeManual`	`5`	手动或固定对焦模式。

enum QCamera::TorchMode

常量	值	描述
`QCamera::TorchOff`	`0`	手电筒关闭。
`QCamera::TorchOn`	`1`	手电筒开启。
`QCamera::TorchAuto`	`2`	自动手电筒。

enum QCamera::WhiteBalanceMode

常量	值	描述
`QCamera::WhiteBalanceAuto`	`0`	自动白平衡模式。
`QCamera::WhiteBalanceManual`	`1`	手动白平衡。在此模式下，应使用setColorTemperature()设置白平衡
`QCamera::WhiteBalanceSunlight`	`2`	日光白平衡模式。
`QCamera::WhiteBalanceCloudy`	`3`	阴天白平衡模式。
`QCamera::WhiteBalanceShade`	`4`	阴影白平衡模式。
`QCamera::WhiteBalanceTungsten`	`5`	钨丝（白炽灯）白平衡模式。
`QCamera::WhiteBalanceFluorescent`	`6`	荧光灯白平衡模式。
`QCamera::WhiteBalanceFlash`	`7`	闪光灯白平衡模式。
`QCamera::WhiteBalanceSunset`	`8`	日落白平衡模式。

属性文档

active : bool

描述相机当前是否处于活动状态。

访问函数

bool	isActive() const
void	setActive(bool active)

通知信号

void	activeChanged(bool)

cameraDevice : QCameraDevice

返回与该相机相关联的 QCameraDevice 对象。

访问函数

QCameraDevice	cameraDevice() const
void	setCameraDevice(const QCameraDevice &cameraDevice)

通知信号

void	摄像头设备改变()

cameraFormat : QCameraFormat

返回相机当前使用的相机格式。

注意：当在 Android 目标设备上使用 FFMPEG 后端时，如果您请求 YUV420P 格式，您将收到完全平面的 4:2:0 YUV420P 或半平面的 NV12/NV21。这取决于设备 OEM 实现的编解码器。

访问函数

QCameraFormat	cameraFormat() const
void	setCameraFormat(const QCameraFormat &format)

通知信号

void	摄像头格式改变()

另请参阅QCameraDevice::videoFormats.

colorTemperature : int

如果当前白平衡模式为 WhiteBalanceManual，则返回当前颜色温度。对于其他模式，返回值未定义。

访问函数

int	colorTemperature() const
void	setColorTemperature(int colorTemperature)

通知信号

void	colorTemperatureChanged() const

customFocusPoint : QPointF

此属性表示自定义焦点点的位置，以相对帧坐标为单位：QPointF(0,0) 指向左上角的帧点，QPointF(0.5,0.5) 指向帧中心。

仅在 FocusPointCustom 焦点模式中使用自定义焦点点属性。

您可以通过使用 Feature.CustomFocusPoint 标志调用 supportedFeatures() 来检查是否支持自定义焦点点。

访问函数

QPointF	customFocusPoint() const
void	setCustomFocusPoint(const QPointF &point)

通知信号

void	自定义焦点改变()

`[只读]` error : const Error

返回相机的错误状态。

访问函数

QCamera::Error error() const

通知信号

void	错误改变()

`[只读]` errorString : const QString

返回描述相机错误状态的文本。

访问函数

QString errorString() const

通知信号

void	错误改变()

exposureCompensation : float

曝光补偿的单位为 EV。

曝光补偿属性允许调整自动计算的曝光。

访问函数

float	exposureCompensation() const
void	setExposureCompensation(float ev)

通知信号

void	exposureCompensationChanged(float value)

曝光模式 : QCamera::ExposureMode

此属性持有正在使用的曝光模式。

访问函数

QCamera::ExposureMode	exposureMode() const
void	setExposureMode(QCamera::ExposureMode mode)

通知信号

void	曝光模式改变()

另请参见QCamera::isExposureModeSupported。

`[只读]` exposureTime : const float

相机的曝光时间（秒）。

访问函数

float exposureTime() const

通知信号

void	exposureTimeChanged(float speed)

另请参见minimumExposureTime()，maximumExposureTime()和setManualExposureTime。

闪光模式 : QCamera::FlashMode

此属性持有正在使用的闪光模式。

如果相机具有闪光灯，将启用特定的闪光模式。

访问函数

QCamera::FlashMode	flashMode() const
void	setFlashMode(QCamera::FlashMode mode)

通知信号

void	闪光灯模式改变()

另请参见QCamera::FlashMode，QCamera::isFlashModeSupported和QCamera::isFlashReady。

`[只读]` flashReady : const bool

指示闪光灯是否充电并准备好使用。

访问函数

bool isFlashReady() const [以下说明]

注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。

通知信号

void	flashReady(bool ready)

focusDistance : float

此属性返回相机的近似对焦距离。报告的值在0到1之间，0为最接近的可能对焦距离，1为最远的可能距离。请注意，1通常是无穷远，但不一定总是。

除非将对焦模式设置为FocusModeManual，否则将对焦距离的设置将被忽略。

访问函数

float	focusDistance() const
void	setFocusDistance(float d)

通知信号

void	focusDistanceChanged(float)

focusMode : FocusMode

此属性持有当前相机的对焦模式。

设置相机的不同对焦模式。所有自动对焦模式都会持续对焦。通过将焦点模式设置为FocusModeManual可以锁定焦点。这将保持当前焦点并停止任何自动对焦。

访问函数

QCamera::FocusMode	focusMode() const
void	setFocusMode(QCamera::FocusMode mode)

通知信号

void	焦点模式改变()

另请参见isFocusModeSupported。

`[只读]` focusPoint : const QPointF

返回自动对焦系统当前用于对焦的点。

访问函数

QPointF focusPoint() const

通知信号

void	焦点点改变()

`[只读]` isoSensitivity : const int

此属性存储传感器的ISO灵敏度。

描述相机当前使用的ISO灵敏度。

访问函数

int	isoSensitivity() const

通知信号

void	isoSensitivityChanged(int value)

另请参阅setAutoIsoSensitivity() 和 setManualIsoSensitivity。

manualExposureTime : int

设置手动曝光时间为秒

访问函数

float	manualExposureTime() const
void	setManualExposureTime(float seconds)

通知信号

void	manualExposureTimeChanged(float speed)

manualIsoSensitivity : int

描述手动设置的ISO灵敏度

将此属性设置为 -1（默认值）表示相机自动调整ISO灵敏度。

访问函数

int	manualIsoSensitivity() const
void	setManualIsoSensitivity(int iso)

通知信号

void	manualIsoSensitivityChanged(int)

`[只读]` maximumZoomFactor : const float

返回最大缩放系数。

在不支持缩放的相机上，这将等于 1.0。

访问函数

float maximumZoomFactor() const

通知信号

void	maximumZoomFactorChanged(float)

`[只读]` minimumZoomFactor : const float

返回最小缩放系数。

在不支持缩放的相机上，这将等于 1.0。

访问函数

float minimumZoomFactor() const

通知信号

void	minimumZoomFactorChanged(float)

`[只读]` supportedFeatures : const Features

返回此相机支持的功能。

访问函数

QCamera::Features supportedFeatures() const

通知信号

void	支持的功能改变()

另请参阅QCamera::Feature。

torchMode : QCamera::TorchMode

此属性包含正在使用的手电筒模式。

手电筒是连续光源。它可以在低光照条件下进行视频录制。启用手电筒模式通常会覆盖任何当前设置的闪光灯模式。

访问函数

QCamera::TorchMode	torchMode() const
void	setTorchMode(QCamera::TorchMode mode)

通知信号

void	torchModeChanged()

另请参阅QCamera::TorchMode、QCamera::isTorchModeSupported 和 QCamera::flashMode。

whiteBalanceMode : WhiteBalanceMode

返回正在使用的白平衡模式。

访问函数

QCamera::WhiteBalanceMode	whiteBalanceMode() const
void	setWhiteBalanceMode(QCamera::WhiteBalanceMode mode)

通知信号

void	whiteBalanceModeChanged() const

zoomFactor : float

此属性包含当前缩放系数。

获取或设置当前缩放系数。值将在 minimumZoomFactor 和 maximumZoomFactor 之间进行限制。

访问函数

float	zoomFactor() const
void	setZoomFactor(float factor)

通知信号

void	zoomFactorChanged(float)

成员函数文档

`[明确指定]` QCamera::QCamera(QObject **parent* = nullptr)

使用父对象构造 QCamera。

如果系统上有多个摄像头，则选择默认摄像头。

`[明确指定]` QCamera::QCamera(const QCameraDevice &cameraDevice, QObject **parent* = nullptr)

从摄像头描述 cameraDevice 和 parent 构造一个 QCamera。

`[明确指定]` QCamera::QCamera(QCameraDevice::Position position, QObject **parent* = nullptr)

构造一个使用位于指定 position 的硬件摄像头的 QCamera。

例如，在手机上，可以轻松地在前置摄像头和后置摄像头之间进行选择。

如果在指定的 position 处没有摄像头，或者 position 为 QCameraDevice::UnspecifiedPosition，则使用默认摄像头。

`[虚函数，noexcept]` QCamera::~QCamera()

销毁摄像头对象。

QMediaCaptureSession *QCamera::captureSession() const

返回摄像头连接的捕获会话，如果没有连接到捕获会话，则返回 nullptr。

使用 QMediaCaptureSession::setCamera() 将摄像头连接到会话。

`[信号]` void QCamera::errorOccurred(QCamera::Error error, const QString &errorString)

当错误状态变为 error 时，发出此信号。错误描述作为 errorString 提供。

`[信号]` void QCamera::exposureCompensationChanged(float value)

当曝光补偿变为 value 时发出信号。

注意：属性 exposureCompensation 的通知信号。

float QCamera::exposureTime() const

返回当前的曝光时间（秒）。

注意：曝光时间属性的获取函数。

`[信号]` void QCamera::exposureTimeChanged(float speed)

通知摄像头的曝光 speed 已更改。

注意：曝光时间属性的更改通知信号。

`[信号]` void QCamera::flashReady(bool ready)

通知闪光灯 ready 状态已更改。

注意：闪光灯准备状态的更改通知信号。

`[signal]` void QCamera::focusModeChanged()

当 focusMode 发生变化时发出信号。

注意：属性 focusMode 的通知器信号。

bool QCamera::isActive() const

如果相机当前处于活动状态，则返回 true。

注意：属性 active 的获取器函数。

bool QCamera::isAvailable() const

如果可以使用相机，则返回 true。

`[invokable]` bool QCamera::isExposureModeSupported(QCamera::ExposureMode mode) const

如果支持曝光 mode，则返回 true。

注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。

`[invokable]` bool QCamera::isFlashModeSupported(QCamera::FlashMode mode) const

如果支持闪光灯 mode，则返回 true。

注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。

`[invokable]` bool QCamera::isFlashReady() const

如果闪光灯已充电，则返回 true。

注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。

注意：属性 flashReady 的获取器函数。

`[invokable]` bool QCamera::isFocusModeSupported(QCamera::FocusMode mode) const

如果相机支持对焦 mode，则返回 true。

注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。

`[invokable]` bool QCamera::isTorchModeSupported(QCamera::TorchMode mode) const

如果支持手电筒 mode，则返回 true。

注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。

`[invokable]` bool QCamera::isWhiteBalanceModeSupported(QCamera::WhiteBalanceMode mode) const

如果支持白平衡 mode，则返回 true。

注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。

`[signal]` void QCamera::isoSensitivityChanged(int value)

当灵敏度变为 value 时发出信号。

注意：属性 isoSensitivity 的通知器信号。

float QCamera::manualExposureTime() const

以秒为单位返回手动曝光时间，如果相机使用自动曝光时间，则返回 -1。

注意：手动曝光时间的获取器函数。

另请参阅：setManualExposureTime()。

float QCamera::maximumExposureTime() const

最大曝光时间为秒。

int QCamera::maximumIsoSensitivity() const

返回相机支持的最高 ISO 灵敏度。

float QCamera::minimumExposureTime() const

最小曝光时间为秒。

int QCamera::minimumIsoSensitivity() const

返回相机支持的最小ISO灵敏度。

`[槽]` void QCamera::setActive(bool active)

如果active为true，则开启相机；如果为false，则关闭相机。

注意： 属性active的设置函数。

另请参阅 isActive().

`[槽]` void QCamera::setAutoExposureTime()

使用自动计算的曝光时间。

`[槽]` void QCamera::setAutoIsoSensitivity()

开启自动灵敏度。

void QCamera::setCameraDevice(const QCameraDevice &cameraDevice)

将相机对象连接到由cameraDevice描述的物理相机设备。使用默认构造的QCameraDevice对象作为cameraDevice将连接到系统默认相机设备。

注意： 属性cameraDevice的设置函数。

另请参阅 cameraDevice().

void QCamera::setCameraFormat(const QCameraFormat &format)

告诉相机使用由format描述的格式。这可以用来定义用于录制和图像捕获的特定分辨率和帧率。

注意： 属性cameraFormat的设置函数。

另请参阅 cameraFormat().

`[槽]` void QCamera::setColorTemperature(int colorTemperature)

将手动白平衡设置为colorTemperature。当设置whiteBalanceMode()为WhiteBalanceManual时使用。单位是开尔文。

设置颜色的温度只有在WhiteBalanceManual被支持时才会生效。在这种情况下，设置大于0的值将自动将白平衡模式设置到WhiteBalanceManual。将温度设置为0将白平衡模式重置到WhiteBalanceAuto。

注意： 属性colorTemperature的设置函数。

另请参阅 colorTemperature().

`[槽]` void QCamera::setWhiteBalanceMode(QCamera::WhiteBalanceMode mode)

将白平衡设置为mode。

注意： 属性whiteBalanceMode的设置函数。

另请参阅 whiteBalanceMode().

void QCamera::setZoomFactor(float factor)

以每秒1倍率的倍数增加到倍率。

注意：属性zoomFactor的设置函数。

另请参阅：zoomFactor。

`[slot]` void QCamera::start()

启动相机。

等同于setActive(true)。

如果由于某些原因无法启动相机，将发出errorOccurred()信号。

`[slot]` void QCamera::stop()

停止相机。等同于setActive(false)。

`[slot]` void QCamera::zoomTo(float factor, float rate)

使用rate放大至倍率factor。

该rate以每秒2的幂指定。速率为1时，将需2秒从倍率1增加到4。

注意：不是所有相机都支持特定的速率。如果不受支持，将尽可能快地进行缩放。

QCamera 类

公共类型

属性

公共函数

公共槽

信号

详细描述

成员类型文档

enum QCamera::Error

enum QCamera::ExposureMode

enum class QCamera::Featureflags QCamera::Features

enum QCamera::FlashMode

enum QCamera::FocusMode

enum QCamera::TorchMode

enum QCamera::WhiteBalanceMode

属性文档

active : bool

cameraDevice : QCameraDevice

cameraFormat : QCameraFormat

colorTemperature : int

customFocusPoint : QPointF

[只读] error : const Error

[只读] errorString : const QString

exposureCompensation : float

曝光模式 : QCamera::ExposureMode

[只读] exposureTime : const float

闪光模式 : QCamera::FlashMode

[只读] flashReady : const bool

focusDistance : float

focusMode : FocusMode

[只读] focusPoint : const QPointF

[只读] isoSensitivity : const int

manualExposureTime : int

manualIsoSensitivity : int

[只读] maximumZoomFactor : const float

[只读] minimumZoomFactor : const float

[只读] supportedFeatures : const Features

torchMode : QCamera::TorchMode

whiteBalanceMode : WhiteBalanceMode

zoomFactor : float

成员函数文档

[明确指定] QCamera::QCamera(QObject *parent = nullptr)

[明确指定] QCamera::QCamera(const QCameraDevice &cameraDevice, QObject *parent = nullptr)

[明确指定] QCamera::QCamera(QCameraDevice::Position position, QObject *parent = nullptr)

[虚函数，noexcept] QCamera::~QCamera()

QMediaCaptureSession *QCamera::captureSession() const

[信号] void QCamera::errorOccurred(QCamera::Error error, const QString &errorString)

[信号] void QCamera::exposureCompensationChanged(float value)

float QCamera::exposureTime() const

[信号] void QCamera::exposureTimeChanged(float speed)

[信号] void QCamera::flashReady(bool ready)

[signal] void QCamera::focusModeChanged()

bool QCamera::isActive() const

bool QCamera::isAvailable() const

[invokable] bool QCamera::isExposureModeSupported(QCamera::ExposureMode mode) const

[invokable] bool QCamera::isFlashModeSupported(QCamera::FlashMode mode) const

[invokable] bool QCamera::isFlashReady() const

[invokable] bool QCamera::isFocusModeSupported(QCamera::FocusMode mode) const

[invokable] bool QCamera::isTorchModeSupported(QCamera::TorchMode mode) const

[invokable] bool QCamera::isWhiteBalanceModeSupported(QCamera::WhiteBalanceMode mode) const

[signal] void QCamera::isoSensitivityChanged(int value)

float QCamera::manualExposureTime() const

float QCamera::maximumExposureTime() const

int QCamera::maximumIsoSensitivity() const

float QCamera::minimumExposureTime() const

int QCamera::minimumIsoSensitivity() const

[槽] void QCamera::setActive(bool active)

[槽] void QCamera::setAutoExposureTime()

[槽] void QCamera::setAutoIsoSensitivity()

void QCamera::setCameraDevice(const QCameraDevice &cameraDevice)

void QCamera::setCameraFormat(const QCameraFormat &format)

[槽] void QCamera::setColorTemperature(int colorTemperature)

[槽] void QCamera::setWhiteBalanceMode(QCamera::WhiteBalanceMode mode)

void QCamera::setZoomFactor(float factor)

[slot] void QCamera::start()

[slot] void QCamera::stop()

[slot] void QCamera::zoomTo(float factor, float rate)

enum class QCamera::Feature
flags QCamera::Features

`[只读]` error : const Error

`[只读]` errorString : const QString

`[只读]` exposureTime : const float

`[只读]` flashReady : const bool

`[只读]` focusPoint : const QPointF

`[只读]` isoSensitivity : const int

`[只读]` maximumZoomFactor : const float

`[只读]` minimumZoomFactor : const float

`[只读]` supportedFeatures : const Features

`[明确指定]` QCamera::QCamera(QObject **parent* = nullptr)

`[明确指定]` QCamera::QCamera(const QCameraDevice &cameraDevice, QObject **parent* = nullptr)

`[明确指定]` QCamera::QCamera(QCameraDevice::Position position, QObject **parent* = nullptr)

`[虚函数，noexcept]` QCamera::~QCamera()

`[信号]` void QCamera::errorOccurred(QCamera::Error error, const QString &errorString)

`[信号]` void QCamera::exposureCompensationChanged(float value)

`[信号]` void QCamera::exposureTimeChanged(float speed)

`[信号]` void QCamera::flashReady(bool ready)

`[signal]` void QCamera::focusModeChanged()

`[invokable]` bool QCamera::isExposureModeSupported(QCamera::ExposureMode mode) const

`[invokable]` bool QCamera::isFlashModeSupported(QCamera::FlashMode mode) const

`[invokable]` bool QCamera::isFlashReady() const

`[invokable]` bool QCamera::isFocusModeSupported(QCamera::FocusMode mode) const

`[invokable]` bool QCamera::isTorchModeSupported(QCamera::TorchMode mode) const

`[invokable]` bool QCamera::isWhiteBalanceModeSupported(QCamera::WhiteBalanceMode mode) const

`[signal]` void QCamera::isoSensitivityChanged(int value)

`[槽]` void QCamera::setActive(bool active)

`[槽]` void QCamera::setAutoExposureTime()

`[槽]` void QCamera::setAutoIsoSensitivity()

`[槽]` void QCamera::setColorTemperature(int colorTemperature)

`[槽]` void QCamera::setWhiteBalanceMode(QCamera::WhiteBalanceMode mode)

`[slot]` void QCamera::start()

`[slot]` void QCamera::stop()

`[slot]` void QCamera::zoomTo(float factor, float rate)