class QImageCapture#

QImageCapture 类用于多媒体内容的录制。更多信息...更多信息…

Inheritance diagram of PySide6.QtMultimedia.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 错误#

常量

描述

QImageCapture.NoError

无错误。

QImageCapture.NotReadyError

服务还未准备好进行捕获。

QImageCapture.ResourceError

设备未准备就绪或不可用。

QImageCapture.OutOfSpaceError

设备上没有剩余空间。

QImageCapture.NotSupportedFeatureError

设备不支持静态图像捕获。

QImageCapture.FormatError

当前格式不受支持。
class 质量#

枚举质量编码级别。

常量

描述

QImageCapture.VeryLowQuality

QImageCapture.LowQuality

QImageCapture.NormalQuality

QImageCapture.HighQuality

QImageCapture.VeryHighQuality
class 文件格式#

选择以下图像格式之一

常量

描述

QImageCapture.UnspecifiedFormat

未指定格式

QImageCapture.JPEG

.jpg 或 .jpeg 格式

QImageCapture.PNG

.png 格式

QImageCapture.WebP

.webp 格式

QImageCapture.Tiff

.tiff 格式

注

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

属性error: QImageCapture.Error#

返回当前的错误状态。

另请参阅

errorString()

访问函数
属性errorString: str#

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

另请参阅

error()

访问函数
属性fileFormat: QImageCapture.FileFormat#

此属性包含图像格式。

访问函数
属性metaData: QMediaMetaData#

此属性包含将嵌入到图像中的元数据。

注

相机制造商后端可能还会添加额外的字段，例如时间戳或位置信息。

访问函数
属性quality: QImageCapture.Quality#

此属性包含图像编码质量。

访问函数
属性readyForCapture: bool#

当相机立即准备捕获图像时，true。当readyForCapture为false时调用capture()是不被允许的，并会导致错误。

访问函数
__init__([parent=None])#
参数：

parent – QObject

从父对象构建一个图像捕获对象，该对象可以捕获由相机产生的单个静止图像。

要将图像捕获对象和QCamera连接到捕获会话才能捕获图像。

addMetaData(metaData)#
参数：

metaData – QMediaMetaData

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

capture()#
返回类型：:

int

捕获图像并将其作为QImage可用。此操作在大多数情况下是异步的，之后是信号imageExposed() 、imageCaptured() 或 error() 。

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

另请参阅

isReadyForCapture()

captureSession()#
返回类型：:

QMediaCaptureSession

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

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

captureToFile([location=""])#
参数：

location – 字符串

返回类型：:

int

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

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

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

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

另请参阅

isReadyForCapture()

error()#
返回类型：:

Error

error属性的访问器。

errorChanged()#

error属性的属性变更通知信号。

errorOccurred(id, error, errorString)#
参数：

  • id – 整数

  • 错误 – Error

  • errorString – str

信号表示捕获请求 id 已失败，并返回错误和错误描述的 errorString。

errorString()#
返回类型：:

str

属性 errorString 的获取器。

fileFormat()#
返回类型：:

FileFormat

另请参阅

setFileFormat()

属性 fileFormat 的获取器。

fileFormatChanged()#

属性 fileFormat 的属性更改通知信号。

static fileFormatDescription(c)#
参数：

c – FileFormat

返回类型：:

str

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

static fileFormatName(c)#
参数：

c – FileFormat

返回类型：:

str

返回给定格式 f 的名称。

imageAvailable(id, frame)#
参数：

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

imageCaptured(id, preview)#
参数：

  • id – 整数

  • preview – QImage

当捕获并显示请求帧 id 的画面时发出信号，但尚未进行处理和保存。帧 preview 可以向用户显示。

imageExposed(id)#
参数：

id – 整数

当请求帧 id 被曝光时发出信号。

imageMetadataAvailable(id, metaData)#
参数：

指示以 id 标识的图像具有 metaData。

imageSaved(id, fileName)#
参数：

  • id – 整数

  • fileName – 字符串

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

isAvailable()#
返回类型：:

布尔值

如果图像捕获服务准备好使用，则返回 true。

isReadyForCapture()#
返回类型：:

布尔值

属性 readyForCaptureᅟ 的getter。

metaData()#
返回类型：:

QMediaMetaData

另请参阅

setMetaData()

属性 metaDataᅟ 的getter。

metaDataChanged()#

属性 metaDataᅟ 的通知信号。

quality()#
返回类型：:

质量

另请参阅

setQuality()

属性 qualityᅟ 的getter。

qualityChanged()#

属性 qualityᅟ 的通知信号。

readyForCaptureChanged(ready)#
参数：

ready – 布尔值

指示相机的捕获状态（ready）已更改。

属性readyForCapture的通告信号。

resolution()链接到此处
返回类型：:

QSize

返回编码图像的分辨率。

另请参阅

setResolution()

resolutionChanged()链接到此处

当图像分辨率更改时发出信号。

setFileFormat(format)链接到此处
参数：

format – FileFormat

设置图像的格式。

另请参阅

fileFormat()

setMetaData(metaData)链接到此处
参数：

metaData – QMediaMetaData

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

另请参阅

metaData()

metaData属性的设置器。

setQuality(quality)链接到此处
参数：

quality – Quality

设置图像编码的quality。

另请参阅

quality()

setResolution(arg__1)链接到此处
参数：

arg__1 – QSize

设置编码图像的resolution。

一个空的QSize指示编码器应根据从图像源获得的内容和编解码器的限制进行最佳选择。

另请参阅

resolution()

setResolution(width, height)
参数：

  • width – int

  • height – int

设置编码图像分辨率的宽度和高度。

这是一个重载函数。

静态supportedFormats()链接到此处
返回类型：:

支持文件格式列表 QImageCapture.FileFormat

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

另请参阅

FileFormat