DImageCapture类提供相机拍照相关功能. 更多...

#include <dimagecapture.h>

类 Dtk::Multimedia::DImageCapture 继承关系图:

Public 类型
enum	Quality { VeryLowQuality , LowQuality , NormalQuality , HighQuality , VeryHighQuality }
	拍照质量更多...

enum	FileFormat { UnspecifiedFormat , JPEG , PNG , WebP , Tiff , LastFileFormat = Tiff }
	拍照图片格式更多...

Public 槽
int	captureToFile (const QString &location=QString())
	信号槽-相机捕获图像到文件.

int	capture (const QString &location=QString())
	信号槽-相机捕获图像到目标.

信号
void	errorChanged ()
	相机捕获图像的错误状态改变.

void	errorOccurred (int id, DImageCapture::Error error, const QString &errorString)
	信号-相机捕获图像的错误触发.

void	readyForCaptureChanged (bool ready)
	信号-相机捕获图像是否已经准备发生改变.

void	metaDataChanged ()
	信号-设置相机捕获图像元数据发生改变.

void	fileFormatChanged ()
	信号-设置相机捕获图像格式发生改变.

void	qualityChanged ()
	信号-设置相机捕获图像质量数据发生改变.

void	resolutionChanged ()
	信号-设置相机捕获图像像素数据发生改变.

Public 成员函数
	DImageCapture (QMediaObject *parent=nullptr)

bool	isAvailable () const
	拍照功能是否可用.

DMediaCaptureSession *	captureSession () const
	返回相机的回话.

Error	error () const
	返回相机当前的错误状态.

QString	errorString () const
	返回相机当前的错误描述.

bool	isReadyForCapture () const
	返回相机是否准备好立即捕获图像.

FileFormat	fileFormat () const
	返回相机捕获图像的文件格式.

void	setFileFormat (FileFormat format)
	设置相机捕获图像的文件格式.

QSize	resolution () const
	返回相机捕获图像的分辨率.

void	setResolution (const QSize &)

void	setResolution (int width, int height)
	设置相机捕获图像的分辨率.

Quality	quality () const
	返回相机捕获图像的质量.

void	setQuality (Quality quality)
	设置相机捕获图像的质量.

DMediaMetaData	metaData () const
	返回相机捕获图像的元数据.

void	setMetaData (const DMediaMetaData &metaData)
	设置相机捕获图像的元数据.

void	addMetaData (const DMediaMetaData &metaData)
	添加相机捕获图像的元数据.

静态 Public 成员函数
static QList< FileFormat >	supportedFormats ()
	返回相机捕获图像的支持文件格式列表.

static QString	fileFormatName (FileFormat f)
	返回相机捕获图像的支持文件格式名称.

static QString	fileFormatDescription (FileFormat f)
	返回相机捕获图像的支持文件格式描述.

Protected 属性
QScopedPointer< DImageCapturePrivate >	d_ptr

详细描述

DImageCapture类提供相机拍照相关功能.

成员枚举类型说明

◆ FileFormat

enum Dtk::Multimedia::DImageCapture::FileFormat

拍照图片格式

枚举值
UnspecifiedFormat	未指定图片格式
JPEG	JPEG图片格式
PNG	PNG图片格式
WebP	WebP图片格式
Tiff	Tiff图片格式

◆ Quality

enum Dtk::Multimedia::DImageCapture::Quality

拍照质量

枚举值
VeryLowQuality	极低质量
LowQuality	低质量
NormalQuality	正常
HighQuality	较高质量
VeryHighQuality	高质量

成员函数说明

◆ addMetaData()

void DImageCapture::addMetaData ( const DMediaMetaData & metaData )

添加相机捕获图像的元数据.

参数

[in] metaData 捕获图像的元数据.

◆ capture

int DImageCapture::capture ( const QString & location = QString() )

slot

信号槽-相机捕获图像到目标.

参数

[in] location 保存目标位置.

返回: 返回0表示成功.

◆ captureSession()

DMediaCaptureSession * DImageCapture::captureSession ( ) const

返回相机的回话.

返回: 相机的回话的指针.

◆ captureToFile

int DImageCapture::captureToFile ( const QString & location = QString() )

slot

信号槽-相机捕获图像到文件.

参数

[in] location 文件位置.

返回: 返回0表示成功.

◆ error()

Error DImageCapture::error ( ) const

返回相机当前的错误状态.

返回: 相机当前的错误状态.

◆ errorOccurred

void DImageCapture::errorOccurred	(	int	id,
		DImageCapture::Error	error,
		const QString &	errorString
	)

signal

信号-相机捕获图像的错误触发.

参数

[in]	id	错误ID.
[in]	error	错误状态.
[in]	errorString	错误描述.

◆ errorString()

QString DImageCapture::errorString ( ) const

返回相机当前的错误描述.

返回: 相机当前的错误描述.

◆ fileFormat()

FileFormat DImageCapture::fileFormat ( ) const

返回相机捕获图像的文件格式.

返回: 图像的文件格式.

◆ fileFormatDescription()

static QString DImageCapture::fileFormatDescription ( FileFormat f )

static

返回相机捕获图像的支持文件格式描述.

参数

[in] format 图像的文件格式.

返回: 图像的支持文件格式描述.

◆ fileFormatName()

static QString DImageCapture::fileFormatName ( FileFormat f )

static

返回相机捕获图像的支持文件格式名称.

参数

[in] format 图像的文件格式.

返回: 图像的支持文件格式名称.

◆ isAvailable()

bool DImageCapture::isAvailable ( ) const

拍照功能是否可用.

返回: 拍照功能是否可用，true为可用.

◆ isReadyForCapture()

bool DImageCapture::isReadyForCapture ( ) const

返回相机是否准备好立即捕获图像.

返回: 相机是否准备好立即捕获图像，true为已做好准备.

◆ metaData()

DMediaMetaData DImageCapture::metaData ( ) const

返回相机捕获图像的元数据.

返回: 捕获图像的元数据.

◆ quality()

Quality DImageCapture::quality ( ) const

返回相机捕获图像的质量.

返回: 图像的质量.

◆ readyForCaptureChanged

void DImageCapture::readyForCaptureChanged ( bool ready )

signal

信号-相机捕获图像是否已经准备发生改变.

参数

[in] ready 是否准备好捕获图像，true表示可以捕获图像.

◆ resolution()

QSize DImageCapture::resolution ( ) const

返回相机捕获图像的分辨率.

返回: 图像的分辨率.

◆ setFileFormat()

void DImageCapture::setFileFormat ( FileFormat format )

设置相机捕获图像的文件格式.

参数

[in] format 图像的文件格式.

◆ setMetaData()

void DImageCapture::setMetaData ( const DMediaMetaData & metaData )

设置相机捕获图像的元数据.

参数

[in] metaData 捕获图像的元数据.

◆ setQuality()

void DImageCapture::setQuality ( Quality quality )

设置相机捕获图像的质量.

参数

[in] quality 图像的质量.

◆ setResolution()

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

inline

设置相机捕获图像的分辨率.

参数

[in]	width	图像的宽.
[in]	height	图像的高.

◆ supportedFormats()

static QList< FileFormat > DImageCapture::supportedFormats ( )

static

返回相机捕获图像的支持文件格式列表.

返回: 图像的支持文件格式列表.

该类的文档由以下文件生成:

include/dtkmultimedia/dimagecapture.h
docs/dtkmultimedia/dimagecapture.zh_CN.dox

Public 类型

Public 槽

信号

Public 成员函数

静态 Public 成员函数

Protected 属性

详细描述

成员枚举类型说明

◆ FileFormat

◆ Quality

成员函数说明

◆ addMetaData()

◆ capture

◆ captureSession()

◆ captureToFile

◆ error()

◆ errorOccurred

◆ errorString()

◆ fileFormat()

◆ fileFormatDescription()

◆ fileFormatName()

◆ isAvailable()

◆ isReadyForCapture()

◆ metaData()

◆ quality()

◆ readyForCaptureChanged

◆ resolution()

◆ setFileFormat()

◆ setMetaData()

◆ setQuality()

◆ setResolution()

◆ supportedFormats()