QCameraDevice Class

QCameraDeviceクラスは、カメラ・デバイスに関する一般的な情報を提供します。詳細...

Header:	`#include <QCameraDevice>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS Multimedia)` `target_link_libraries(mytarget PRIVATE Qt6::Multimedia)`
qmake:	`QT += multimedia`

継承されたメンバを含む全メンバのリスト

パブリック・タイプ

enum	Position { UnspecifiedPosition, BackFace, FrontFace }

プロパティ

(since 6.7) correctionAngle : const QtVideo::Rotation
description : const QString
id : const QByteArray

isDefault : const bool
position : const Position
videoFormats : const QList<QCameraFormat>

パブリック関数

	QCameraDevice()
	QCameraDevice(const QCameraDevice &other)
	~QCameraDevice()
QtVideo::Rotation	correctionAngle() const
QString	description() const
QByteArray	id() const
bool	isDefault() const
bool	isNull() const
QList<QSize>	photoResolutions() const
QCameraDevice::Position	position() const
QList<QCameraFormat>	videoFormats() const
bool	operator!=(const QCameraDevice &other) const
QCameraDevice &	operator=(const QCameraDevice &other)
bool	operator==(const QCameraDevice &other) const

詳細説明

QCameraDevice は、物理的なカメラ・デバイスとそのプロパティを表します。

availableCameras()関数とdefaultCamera()関数を使用して、システムで利用可能なカメラを見つけることができます。これらは QtMultimedia::MediaDevices に含まれています。

この例では、利用可能なすべてのカメラの名前を表示します：

const QList<QCameraDevice> cameras = QMediaDevices::videoInputs();
for (const QCameraDevice &cameraDevice : cameras)
    qDebug() << cameraDevice.description();

QCameraDevice を使用して、QCamera を構築できます。次の例では、QCamera をインスタンス化し、そのカメラ・デバイスの名前はmycamera です：

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

QCameraDevice を使用して、カメラ・デバイスの説明やシステム上の物理的な位置などの一般的な情報を取得することもできます。

QCamera myCamera;
QCameraDevice cameraDevice = camera->cameraDevice();

if (cameraDevice.position() == QCameraDevice::FrontFace)
    qDebug() << "The camera is on the front face of the hardware system.";
else if (cameraDevice.position() == QCameraDevice::BackFace)
    qDebug() << "The camera is on the back face of the hardware system.";

QCameraも参照してください。

メンバ型ドキュメント

enum QCameraDevice::Position

この enum は、システムハードウェア上のカメラの物理位置を指定します。

定数	値	説明
`QCameraDevice::UnspecifiedPosition`	`0`	カメラの位置は未定義または不明。
`QCameraDevice::BackFace`	`1`	カメラはシステムハードウェアの裏面にある。例えばモバイルデバイスの場合、画面の反対側にあることを意味します。
`QCameraDevice::FrontFace`	`2`	カメラがシステムハードウェアの前面にある。例えばモバイル機器では、画面と同じ側にあることを意味する。正面を向いたカメラは、プロパティQVideoFrame::mirrored を`true` に設定したビデオ・フレームを生成します。これは、これらのフレームの表示が垂直軸を中心に反転され、ビデオ出力がミラーとして表示されるのに対し、録画ではQVideoFrame::surfaceFormat で指定された表面の変形のみが考慮されることを意味します。

position()も参照 。

プロパティの説明

`[read-only, since 6.7]` correctionAngle : const QtVideo::Rotation

このプロパティは、カメラの物理的な回転を補正するために必要な回転角度を返します。言い換えれば、このプロパティは、出力画像がネイティブな向きでデバイス画面上に直立するために回転させる必要がある時計回りの角度を表します。correctionAngle はネイティブの向きに対する相対的なものであるため、この値はデバイスの向き（ポートレート/ランドスケープ）を変えても変化しません。ネイティブの向きとカメラの向きがメーカーによって定義されている Android では、補正角度が 0 以外になることがあります。

$Example with 90 degrees \a correctionAngle$

このプロパティは Qt 6.7 で導入されました。

アクセス関数：

QtVideo::Rotation correctionAngle() const

`[read-only]` description : const QString

カメラの人間が読める説明を返します。

この文字列を使用して、ユーザーにデバイスを提示します。

アクセス関数

QString description() const

`[read-only]` id : const QByteArray

カメラのデバイスIDを返します。

これはカメラを識別するための固有のIDで、人間が読めない場合があります。

アクセス関数

QByteArray id() const

`[read-only]` isDefault : const bool

デフォルトのカメラデバイスの場合、trueを返します。

アクセス関数

bool	isDefault() const

`[read-only]` position : const Position

ハードウェアシステム上のカメラの物理的な位置を返します。

アクセス関数

QCameraDevice::Position position() const

`[read-only]` videoFormats : const QList<QCameraFormat>

アクセス関数：カメラがサポートするビデオフォーマットを返します。

アクセス関数

QList<QCameraFormat> videoFormats() const

メンバ関数ドキュメント

QCameraDevice::QCameraDevice()

NULL カメラデバイスを構築します。

QCameraDevice::QCameraDevice(const QCameraDevice &other)

other のコピーを構築します。

`[noexcept]` QCameraDevice::~QCameraDevice()

QCameraDevice を破棄します。

bool QCameraDevice::isNull() const

このQCameraDevice が null または無効な場合は true を返します。

QList<QSize> QCameraDevice::photoResolutions() const

カメラが静止画キャプチャに使用できる解像度のリストを返します。

QImageCaptureも参照してください。

bool QCameraDevice::operator!=(const QCameraDevice &other) const

このQCameraDevice がother と異なる場合、true を返します。

QCameraDevice &QCameraDevice::operator=(const QCameraDevice &other)

QCameraDevice オブジェクトをother と等しくなるように設定します。

bool QCameraDevice::operator==(const QCameraDevice &other) const

このQCameraDevice がother と等しい場合、true を返します。

©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の商標です。その他すべての商標は、それぞれの所有者に帰属します。

QCameraDevice Class

パブリック・タイプ

プロパティ

パブリック関数

詳細説明

メンバ型ドキュメント

enum QCameraDevice::Position

プロパティの説明

[read-only, since 6.7] correctionAngle : const QtVideo::Rotation

[read-only] description : const QString

[read-only] id : const QByteArray

[read-only] isDefault : const bool

[read-only] position : const Position

[read-only] videoFormats : const QList<QCameraFormat>

メンバ関数ドキュメント

QCameraDevice::QCameraDevice()

QCameraDevice::QCameraDevice(const QCameraDevice &other)

[noexcept] QCameraDevice::~QCameraDevice()

bool QCameraDevice::isNull() const

QList<QSize> QCameraDevice::photoResolutions() const

bool QCameraDevice::operator!=(const QCameraDevice &other) const

QCameraDevice &QCameraDevice::operator=(const QCameraDevice &other)

bool QCameraDevice::operator==(const QCameraDevice &other) const

`[read-only, since 6.7]` correctionAngle : const QtVideo::Rotation

`[read-only]` description : const QString

`[read-only]` id : const QByteArray

`[read-only]` isDefault : const bool

`[read-only]` position : const Position

`[read-only]` videoFormats : const QList<QCameraFormat>

`[noexcept]` QCameraDevice::~QCameraDevice()