VideoOutput QML Type

Video oder Kamerasucher rendern. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Methoden

• void clearOutput() (since 6.9)

Ausführliche Beschreibung

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

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

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

Das VideoOutput-Element unterstützt die Darstellung von Videos ohne Transformation, gestreckt sowie gleichmäßig skaliert. Eine Beschreibung der gestreckten und gleichmäßig skalierten Darstellung finden Sie in der Beschreibung der Eigenschaft „ fillMode “.

Siehe auch „ MediaPlayer “ und „ Camera “.

Eigenschaftsdokumentation

contentRect : rectangle

Diese Eigenschaft enthält die Koordinaten des Bereichs, der das zu rendernde Video enthalten würde. Bei bestimmten Füllmodi ist dieses Rechteck größer als der sichtbare Bereich des „ VideoOutput “.

Diese Eigenschaft ist nützlich, wenn andere Koordinaten in Bezug auf die Quellabmessungen angegeben werden – dies gilt für relative (normalisierte) Bildkoordinaten im Bereich von 0 bis 1,0.

Bereiche außerhalb dieses Bereichs sind transparent.

endOfStreamPolicy : enumeration [since 6.9]

Diese Eigenschaft legt fest, welche Richtlinie angewendet werden soll, wenn der Videostream endet. Dies geschieht am Ende der Medienwiedergabe oder bei Deaktivierung der Kamera, der Bildschirmaufnahme oder der Fensteraufnahme.

Der Wert „ endOfStreamPolicy “ kann einer der folgenden sein:

Der Standardwert ist „ ClearOutput “.

Diese Eigenschaft wurde in Qt 6.9 eingeführt.

fillMode : enumeration

Legen Sie diese Eigenschaft fest, um zu definieren, wie das Video an den Zielbereich angepasst wird.

• „Stretch“ – Das Video wird so skaliert, dass es in den Zielbereich passt.
• „PreserveAspectFit“ – Das Video wird gleichmäßig skaliert, ohne beschnitten zu werden.
• „PreserveAspectCrop“ – Das Video wird gleichmäßig so skaliert, dass es den Bereich ausfüllt, und bei Bedarf beschnitten.

Der Standard-Ausfüllmodus ist „PreserveAspectFit“.

mirrored : bool [since 6.9]

Legt fest, ob das angezeigte Video um seine vertikale Achse gespiegelt wird. Wir empfehlen die Verwendung dieser Eigenschaft, wenn die Transformation des Quellvideostreams, beispielsweise von einer Frontkamera, nicht mit der Geschäftslogik der Anwendung übereinstimmt. Die Spiegelung wird nach ` orientation` angewendet.

Die Änderung dieser Eigenschaft wirkt sich auf die Zuordnung der Koordinaten von der Quelle zum Ansichtsbereich aus.

Der Standardwert ist ` false`.

Diese Eigenschaft wurde in Qt 6.9 eingeführt.

orientation : int

Diese Eigenschaft legt den Winkel in Grad fest, um den das angezeigte Video in Videokoordinaten im Uhrzeigersinn gedreht wird, wobei die Y-Achse auf dem Bildschirm nach unten zeigt. Die Orientierungstransformation wird vor „ mirrored “ angewendet.

Die Orientierungsänderung wirkt sich auf die Abbildung der Koordinaten von der Quelle auf den Ansichtsbereich aus.

Es werden nur Vielfache von ` 90 ` Grad unterstützt, d. h. 0, 90, -90, 180, 270 usw.; andernfalls wird der angegebene Wert ignoriert.

In einigen Fällen muss die Ausrichtung des Quellvideostreams korrigiert werden. Dazu gehören Quellen wie ein Kamerasucher, bei dem die angezeigte Sucheransicht der Realität entsprechen sollte, unabhängig davon, wie der Rest der Benutzeroberfläche gedreht ist.

Wir empfehlen, diese Eigenschaft zu verwenden, um eine Drehung der Benutzeroberfläche auszugleichen oder die Ausgabeansicht an andere geschäftliche Anforderungen der Anwendung anzupassen.

Der Standardwert lautet „ 0 “.

sourceRect : rectangle

Diese Eigenschaft gibt den Bereich des Quellvideoinhalts an, der für die Darstellung berücksichtigt wird. Die Werte liegen in Quellpixelkoordinaten und sind an das Pixelseitenverhältnis der Quelle angepasst.

Beachten Sie, dass die obere linke Ecke dieses Rechtecks in der Regel bei 0,0 liegt, während Breite und Höhe der Breite und Höhe des Eingabeinhalts entsprechen. Nur wenn für die Videoquelle ein Viewport festgelegt ist, weichen diese Werte davon ab.

Die Einstellung für die Ausrichtung hat keinen Einfluss auf dieses Rechteck.

Siehe auch ` QVideoFrameFormat::viewport()` ().

videoSink : object

Diese Eigenschaft enthält das zugrunde liegende C++-Objekt ` QVideoSink `, das zum Rendern der Videobilder in dieses ` VideoOutput `-Element verwendet wird.

Bei normaler Verwendung von ` VideoOutput ` aus QML sollte die Nutzung dieser Eigenschaft nicht erforderlich sein.

Methodendokumentation

[since 6.9] void clearOutput()

Löscht die Videoausgabe, indem der aktuell angezeigte Videobildausschnitt entfernt wird. Diese Methode wird empfohlen, wenn Sie den letzten Videobildausschnitt entfernen müssen, nachdem die Verbindung der Videoausgabe zur Quelle getrennt wurde oder nachdem der Quellstream endet und die Eigenschaft „ endOfStreamPolicy “ der Videoausgabe auf „ KeepLastFrame “ gesetzt ist.

Diese Methode wurde in Qt 6.9 eingeführt.