cameraDevice QML Value Type

カメラデバイスについて説明します。詳細...

プロパティ

• correctionAngle : QtVideo::Rotation (since 6.7)
• description : string
• id : string
• isDefault : bool
• position : enumeration
• videoFormats : CameraFormat

詳細説明

`cameraDevice` 値型は、システムに接続されているカメラデバイスのプロパティを表します。

cameraDevice インスタンスは、対応する物理デバイスが切断されたり、その設定が変更されたりした場合でも、そのライフサイクルを通じてプロパティを維持します。更新されたプロパティを追跡するには、関連するシグナルが発火した際に、MediaDevices から cameraDevice の新しいインスタンスを読み込む必要があります。

2つの`cameraDevice`インスタンスは、等価性について比較することができます。プロパティが等しいか、最新であるかに関係なく、同じ物理デバイスを表している場合、それらは等しいとみなされます。

カメラデバイスの一覧は、MediaDevices 型から取得できます。特定のカメラデバイスを選択するには、Camera でそのデバイスをデバイスとして設定します。

CaptureSession {
    camera: Camera {
        cameraDevice: mediaDevices.defaultVideoInput
    }
}
MediaDevices {
    id: mediaDevices
}

プロパティのドキュメント

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

カメラのネイティブ向きに対する物理的な回転を補正するために必要な回転角度を返します。つまり、このプロパティは、出力画像をデバイスの画面上でネイティブ向きに合わせて正しく表示するために、画像を時計回りに回転させる必要がある角度を表します。correctionAngle はネイティブ方位を基準としているため、この値はデバイスの向き（縦向き/横向き）を変更しても変化しません。補正角度がゼロ以外になるのは主にAndroidで、ここではネイティブ方位とカメラ方位がメーカーによって定義されているためです。

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

description : string [read-only]

カメラの、人間が読み取れる名前を保持します。

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

id : string [read-only]

カメラのデバイスIDを保持しています

これはカメラを識別するための一意のIDであり、人間が読み取れる形式ではない場合があります。

isDefault : bool [read-only]

これがデフォルトのカメラデバイスである場合に真となる。

position : enumeration [read-only]

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

戻り値は、以下のいずれかになります。

videoFormats : CameraFormat [read-only]

このカメラで対応している動画形式の一覧です。