VideoOutput QML Type

動画またはカメラのファインダーをレンダリングします。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• contentRect : rectangle
• endOfStreamPolicy : enumeration (since 6.9)
• fillMode : enumeration
• mirrored : bool (since 6.9)
• orientation : int
• sourceRect : rectangle
• videoSink : object

方法

• void clearOutput() (since 6.9)

詳細な説明

Rectangle {
    width: 800
    height: 600
    color: "black"

    MediaPlayer {
        id: player
        source: "file://video.webm"
        videoOutput: videoOutput
    }

    VideoOutput {
        id: videoOutput
        anchors.fill: parent
    }
}

VideoOutput 項目は、変換なし、ストレッチ、および均一にスケーリングされたビデオ表示をサポートしています。ストレッチおよび均一にスケーリングされた表示の詳細については、fillMode プロパティの説明を参照してください。

「 MediaPlayer 」および「Camera 」も参照してください 。

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

contentRect : rectangle

このプロパティには、レンダリングされる動画を含む領域の座標が格納されます。特定の塗りつぶしモードでは、この矩形はVideoOutput の表示領域よりも大きくなります。

このプロパティは、他の座標がソースの寸法を基準として指定されている場合に役立ちます。これは、0 から 1.0 の範囲にある相対（正規化）フレーム座標に適用されます。

この範囲外の領域は透明になります。

endOfStreamPolicy : enumeration [since 6.9]

このプロパティは、ビデオストリームが終了した際に適用されるポリシーを指定します。これは、メディアの再生が終了したとき、またはカメラ、画面、ウィンドウのキャプチャが無効化されたときに発生します。

endOfStreamPolicy には、以下のいずれかを指定できます。

デフォルト値は `ClearOutput` です。

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

fillMode : enumeration

このプロパティを設定して、動画が対象領域に合わせてどのように拡大・縮小されるかを指定します。

• Stretch - 動画が領域に合わせて拡大・縮小されます。
• アスペクト比を維持してフィット - 動画をトリミングせずに均一に拡大・縮小して収めます。
• アスペクト比を維持してトリミング - 動画を均一に拡大縮小して領域を埋め、必要に応じてトリミングします

デフォルトの表示モードは「PreserveAspectFit」です。

mirrored : bool [since 6.9]

表示される動画が垂直軸を中心に反転されるかどうかを指定します。フロントカメラなどからのソース動画ストリームの変換が、アプリケーションのビジネスロジックと一致しない場合は、このプロパティの使用をお勧めします。反転処理は、orientation の後に適用されます。

このプロパティの変更は、ソースからビューポートへの座標のマッピングに影響します。

デフォルト値は `false` です。

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

orientation : int

このプロパティは、表示上のY軸が下向きとなるビデオ座標系において、表示されるビデオが時計回りに回転する角度（度単位）を指定します。この方向変換は、mirrored が実行される前に適用されます。

この向き変更は、ソースからビューポートへの座標のマッピングに影響を与えます。

90 の倍数（つまり 0、90、-90、180、270 など）のみがサポートされており、それ以外の場合は指定された値は無視されます。

場合によっては、ソースビデオストリームの向きを修正する必要があることがあります。これには、カメラのファインダーなどのソースが含まれます。この場合、ユーザーインターフェースの他の部分がどのような回転をしていても、表示されるファインダーは現実と一致している必要があります。

このプロパティを使用して、ユーザーインターフェースの回転を補正したり、出力ビューをアプリケーションのその他の業務要件に合わせて調整したりすることをお勧めします。

デフォルト値は0 です。

sourceRect : rectangle

このプロパティは、レンダリングの対象となるソース動画コンテンツの領域を保持します。値はソースのピクセル座標で指定され、ソースのピクセルアスペクト比に合わせて調整されます。

通常、この矩形の左上隅は0,0 となり、幅と高さは入力コンテンツの幅と高さになります。ビデオソースにビューポートが設定されている場合のみ、これらの値は異なります。

向き（orientation）の設定は、この矩形には影響しません。

QVideoFrameFormat::viewport()も参照してください 。

videoSink : object

このプロパティには、この `VideoOutput ` 要素にビデオフレームをレンダリングするために使用される、基盤となる C++ の `QVideoSink ` オブジェクトが格納されます。

QMLからVideoOutput を通常通りに使用する場合、このプロパティを使用する必要はありません。

メソッドのドキュメント

[since 6.9] void clearOutput()

現在表示されているビデオフレームを削除して、ビデオ出力をクリアします。このメソッドは、ソースからビデオ出力を切り離した後、またはソースストリームが終了し、ビデオ出力のendOfStreamPolicy プロパティがKeepLastFrame に設定されている場合に、最後のビデオフレームを削除する必要があるときに推奨されます。

このメソッドは Qt 6.9 で導入されました。