QImageCapture Class

QMediaCaptureSession captureSession;
camera = new QCamera;
captureSession.setCamera(camera);

viewfinder = new QVideoWidget;
viewfinder->show();
captureSession.setVideoOutput(viewfinder);

imageCapture = new QImageCapture;
captureSession.setImageCapture(imageCapture);

camera->start();
// on shutter button pressed
imageCapture->capture();

成员函数文档

[explicit] QImageCapture::QImageCapture(QObject *parent = nullptr)

根据parent 创建一个图像捕获对象，该对象可捕获相机拍摄的单张静止图像。

要捕获图像，必须将图像捕获对象和QCamera 都连接到一个捕获会话中。

[override virtual noexcept] QImageCapture::~QImageCapture()

销毁捕获对象的图像。

void QImageCapture::addMetaData(const QMediaMetaData &metaData)

在任何现有的元数据中添加额外的metaData ，并将该元数据嵌入到捕获的图像中。

[slot] int QImageCapture::capture()

捕获图像并将其作为QImage 提供。在大多数情况下，此操作为异步操作，随后会触发QImageCapture::imageExposed()、QImageCapture::imageCaptured()或QImageCapture::error()信号。

QImageCapture::capture 返回捕获 ID 参数，该参数用于imageExposed()、imageCaptured() 和imageSaved() 信号。

另请参阅 isReadyForCapture()。

QMediaCaptureSession *QImageCapture::captureSession() const

返回该摄像头所连接的捕获会话；如果摄像头未连接到任何捕获会话，则返回 nullptr。

使用QMediaCaptureSession::setImageCapture() 将图像捕获连接到一个会话。

[slot] int QImageCapture::captureToFile(const QString &file = QString())

拍摄图片并将其保存至file 。在大多数情况下，此操作是异步进行的，随后会触发以下信号：QImageCapture::imageExposed()、QImageCapture::imageCaptured()、QImageCapture::imageSaved() 或QImageCapture::error()。

如果传递了一个空的 `file `，相机后端将选择系统上照片的默认位置和命名方案；如果仅指定了文件名而未指定完整路径，图像将保存到默认目录，并通过 `imageCaptured()` 和 `imageSaved()` 信号报告完整路径。

QCamera 保存所有拍摄参数（如曝光设置或图像处理参数），因此调用capture() 之后对相机参数所做的更改不会影响之前的拍摄请求。

QImageCapture::capture 返回捕获 ID 参数，该参数与imageExposed()、imageCaptured() 和imageSaved() 信号一起使用。

另请参阅 isReadyForCapture()。

[signal] void QImageCapture::errorOccurred(int id, QImageCapture::Error error, const QString &errorString)

表示捕获请求id 已失败，错误代码为error ，错误描述为errorString 。

[static] QString QImageCapture::fileFormatDescription(QImageCapture::FileFormat f)

返回指定文件格式的描述，f 。

[static] QString QImageCapture::fileFormatName(QImageCapture::FileFormat f)

返回指定格式的名称，f 。

[signal] void QImageCapture::imageAvailable(int id, const QVideoFrame &frame)

当请求id 的frame 可用时，会触发此信号。

[signal] void QImageCapture::imageCaptured(int id, const QImage &preview)

当捕获到包含请求id 的帧，但该帧尚未处理和保存时，会发出此信号。帧preview 可显示给用户。

[signal] void QImageCapture::imageExposed(int id)

当包含请求id 的帧被暴露时发出的信号。

[signal] void QImageCapture::imageMetadataAvailable(int id, const QMediaMetaData &metaData)

表示由id 标识的图像具有metaData 。

[signal] void QImageCapture::imageSaved(int id, const QString &fileName)

当调用 QImageCapture::CaptureToFile 时，若请求id 的帧已保存至fileName ，则会发出此信号。

bool QImageCapture::isAvailable() const

如果图像捕获服务已准备就绪，则返回 true。

[signal] void QImageCapture::readyForCaptureChanged(bool ready)

表示相机的ready 捕获状态已发生变化。

QSize QImageCapture::resolution() const

返回编码后图像的分辨率。

另请参阅 setResolution()。

[signal] void QImageCapture::resolutionChanged()

当图像分辨率发生变化时发出信号。

void QImageCapture::setFileFormat(QImageCapture::FileFormat format)

将图像设置为format 。

若为FileFormat 属性赋值一个不受支持的值，则不会产生任何效果。

另请参阅 fileFormat() 和supportedFormats 。

void QImageCapture::setMetaData(const QMediaMetaData &metaData)

将要嵌入到捕获图像中的任何现有元数据替换为一组metaData 。

另请参阅 metaData()。

void QImageCapture::setQuality(QImageCapture::Quality quality)

设置图像编码quality 。

另请参阅 quality()。

void QImageCapture::setResolution(const QSize &resolution)

设置编码图像的resolution 。

空的QSize 参数表示编码器应根据图像源提供的信息以及编解码器的限制，做出最优选择。

另请参阅 resolution()。

void QImageCapture::setResolution(int width, int height)

设置编码图像分辨率的width 和height 。

[static] QList<QImageCapture::FileFormat> QImageCapture::supportedFormats()

返回一个支持的文件格式列表。

另请参阅 FileFormat 。