PySide6.QtMultimedia.QImageCapture¶

class QImageCapture¶

QImageCapture 类用于记录媒体内容。更多…

概要¶

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

警告

本节包含从C++自动翻译到Python的代码片段，可能包含错误。

QImageCapture 类是一个高级图像录制类。它不打算单独使用，而是用于访问其他媒体对象的媒体录制功能，例如 QCamera。

captureSession = QMediaCaptureSession()
camera = QCamera()
captureSession.setCamera(camera)
viewfinder = QVideoWidget()
viewfinder.show()
captureSession.setVideoOutput(viewfinder)
imageCapture = QImageCapture(camera)
captureSession.setImageCapture(imageCapture)
camera.start()
#on shutter button pressed
imageCapture.capture()

另请参阅

QCamera

class Error¶

常量	描述
QImageCapture.NoError	没有错误。
QImageCapture.NotReadyError	服务尚未准备好进行捕获。
QImageCapture.ResourceError	设备未准备好或不可用。
QImageCapture.OutOfSpaceError	设备上没有剩余空间。
QImageCapture.NotSupportedFeatureError	设备不支持静态图像捕获。
QImageCapture.FormatError	当前格式不受支持。

class Quality¶

枚举质量编码级别。

常量

描述

QImageCapture.非常低质量

QImageCapture.低质量

QImageCapture.普通质量

QImageCapture.高质量

QImageCapture.非常高质量

常量	描述
QImageCapture.非常低质量
QImageCapture.低质量
QImageCapture.普通质量
QImageCapture.高质量
QImageCapture.非常高质量

class FileFormat¶

选择以下图像格式之一：

常量

描述

QImageCapture.UnspecifiedFormat

未指定格式

QImageCapture.JPEG

.jpg 或 .jpeg 格式

QImageCapture.PNG

.png 格式

QImageCapture.WebP

.webp 格式

QImageCapture.Tiff

.tiff 格式

常量	描述
QImageCapture.UnspecifiedFormat	未指定格式
QImageCapture.JPEG	`.jpg` 或 `.jpeg` 格式
QImageCapture.PNG	`.png` 格式
QImageCapture.WebP	`.webp` 格式
QImageCapture.Tiff	`.tiff` 格式

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property errorᅟ: QImageCapture.错误¶

返回当前的错误状态。

另请参阅

errorString()

Access functions:

error()
信号 errorChanged()

property errorStringᅟ: str¶

返回描述当前错误状态的字符串。

另请参阅

error()

Access functions:

errorString()
信号 errorChanged()

property fileFormatᅟ: QImageCapture.FileFormat¶

此属性保存图像格式。

Access functions:

fileFormat()
信号 fileFormatChanged()

property metaDataᅟ: QMediaMetaData¶

此属性保存将嵌入到图像中的元数据。

注意

相机后端可能会添加时间戳或位置等额外字段。

Access functions:

metaData()
setMetaData()
信号 metaDataChanged()

property qualityᅟ: QImageCapture.Quality¶

此属性保存图像编码质量。

Access functions:

quality()
信号 qualityChanged()

property readyForCaptureᅟ: bool¶

如果相机准备好立即捕捉图像，则保持true。当readyForCapture为false时，不允许调用capture()，否则会导致错误。

Access functions:

isReadyForCapture()
信号 readyForCaptureChanged()

__init__([parent=None])¶

Parameters:: 父对象 – QObject

从parent构造一个图像捕获对象，该对象可以捕获由相机生成的单个静止图像。

您必须将图像捕获对象和QCamera都连接到捕获会话以捕获图像。

addMetaData(metaData)¶

Parameters:: metaData – QMediaMetaData

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

capture()¶

Return type:: 整数

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

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

另请参阅

isReadyForCapture()

captureSession()¶

Return type:: QMediaCaptureSession

返回此相机连接的捕获会话，如果相机未连接到捕获会话，则返回nullptr。

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

captureToFile([location=""])¶

Parameters:: 位置 – str
Return type:: 整数

捕获图像并将其保存到file。在大多数情况下，此操作是异步的，随后会发出信号imageExposed()、imageCaptured()、imageSaved()或error()。

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

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

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

另请参阅

isReadyForCapture()

error()¶

Return type:: 错误

属性 errorᅟ 的获取器。

errorChanged()¶

属性 errorᅟ 的通知信号。

errorOccurred(id, error, errorString)¶

Parameters:

id – int
错误 – Error
errorString – str

表示捕获请求 id 因 error 和 errorString 描述而失败。

errorString()¶

Return type:: 字符串

属性 errorStringᅟ 的获取器。

fileFormat()¶

Return type:: FileFormat

另请参阅

setFileFormat()

属性 fileFormatᅟ 的获取器。

fileFormatChanged()¶

属性 fileFormatᅟ 的通知信号。

static fileFormatDescription(c)¶

Parameters:: c – FileFormat
Return type:: 字符串

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

static fileFormatName(c)¶

Parameters:: c – FileFormat
Return type:: 字符串

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

imageAvailable(id, frame)¶

Parameters:

id – int
frame – QVideoFrame

当具有请求id的frame可用时发出的信号。

imageCaptured(id, preview)¶

Parameters:

id – int
预览 – QImage

当带有请求id的帧被捕获但尚未处理和保存时发出的信号。帧preview可以显示给用户。

imageExposed(id)¶

Parameters:: id – int

当带有请求id的帧被暴露时发出的信号。

imageMetadataAvailable(id, metaData)¶

Parameters:

id – int
metaData – QMediaMetaData

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

imageSaved(id, fileName)¶

Parameters:

id – int
fileName – str

当设置了QImageCapture::CaptureToFile并且带有请求id的帧被保存到fileName时发出的信号。

isAvailable()¶

Return type:: 布尔

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

isReadyForCapture()¶

Return type:: 布尔

属性 readyForCaptureᅟ 的获取器。

metaData()¶

Return type:: QMediaMetaData

另请参阅

setMetaData()

属性 metaDataᅟ 的获取器。

metaDataChanged()¶

属性 metaDataᅟ 的通知信号。

quality()¶

Return type:: 质量

另请参阅

setQuality()

属性 qualityᅟ 的获取器。

qualityChanged()¶

属性 qualityᅟ 的通知信号。

readyForCaptureChanged(ready)¶

Parameters:: ready – 布尔值

表示相机的ready状态已更改，可以开始拍摄。

属性 readyForCaptureᅟ 的通知信号。

resolution()¶

Return type:: QSize

返回编码图像的分辨率。

另请参阅

setResolution()

resolutionChanged()¶

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

setFileFormat(format)¶

Parameters:: 格式 – FileFormat

设置图像的format。

另请参阅

fileFormat()

setMetaData(metaData)¶

Parameters:: metaData – QMediaMetaData

用一组metaData替换任何现有的元数据，这些元数据将被嵌入到捕获的图像中。

另请参阅

metaData()

属性 metaDataᅟ 的设置器。

setQuality(quality)¶

Parameters:: 质量 – Quality

设置图像编码quality。

另请参阅

quality()

setResolution(resolution)¶

Parameters:: 分辨率 – QSize

设置编码图像的resolution。

一个空的 QSize 表示编码器应根据图像源提供的内容和编解码器的限制做出最佳选择。

另请参阅

resolution()

setResolution(width, height)

Parameters:

width – int
height – int

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

这是一个重载函数。

static supportedFormats()¶

Return type:: QImageCapture.FileFormat 的列表

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

另请参阅

FileFormat

PySide6.QtMultimedia.QImageCapture¶

概要¶

属性¶

方法¶

插槽¶

信号¶

静态函数¶

详细描述¶