VideoOutput QML Type

Rendre le viseur d'une vidéo ou d'une caméra. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

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

Méthodes

• void clearOutput() (since 6.9)

Description détaillée

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

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

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

L'élément VideoOutput prend en charge la présentation vidéo non transformée, étirée et à échelle uniforme. Pour une description de la présentation étirée à échelle uniforme, voir la description de la propriété fillMode.

Voir également MediaPlayer et Camera.

Documentation de la propriété

contentRect : rectangle

Cette propriété contient les coordonnées de l'élément de la zone qui contiendrait la vidéo à rendre. Avec certains modes de remplissage, ce rectangle sera plus grand que la zone visible du site VideoOutput.

Cette propriété est utile lorsque d'autres coordonnées sont spécifiées en termes de dimensions de la source - elle s'applique aux coordonnées de trame relatives (normalisées) comprises entre 0 et 1,0.

Les zones situées en dehors de cette zone seront transparentes.

endOfStreamPolicy : enumeration [since 6.9]

Cette propriété spécifie la politique à appliquer lorsque le flux vidéo se termine. Cela se produit à la fin de la lecture du média ou lors de la désactivation de la caméra, de l'écran ou de la fenêtre de capture.

L'adresse endOfStreamPolicy peut être l'une des suivantes

La valeur par défaut est ClearOutput.

Cette propriété a été introduite dans Qt 6.9.

fillMode : enumeration

Cette propriété permet de définir la manière dont la vidéo est mise à l'échelle pour s'adapter à la zone cible.

• Stretch - la vidéo est mise à l'échelle pour s'adapter.
• PreserveAspectFit - la vidéo est mise à l'échelle de manière uniforme pour s'adapter sans recadrage.
• PreserveAspectCrop - la vidéo est mise à l'échelle de manière uniforme pour s'adapter à la zone cible, avec recadrage si nécessaire.

Le mode de remplissage par défaut est PreserveAspectFit.

mirrored : bool [since 6.9]

Détermine si la vidéo affichée est reflétée autour de son axe vertical. Il est recommandé d'utiliser cette propriété si la transformation du flux vidéo source, provenant par exemple d'une caméra frontale, n'est pas conforme à la logique commerciale de l'application. La mise en miroir est appliquée après orientation.

La modification de la propriété affecte le mappage des coordonnées de la source à la fenêtre de visualisation.

La valeur par défaut est false.

Cette propriété a été introduite dans Qt 6.9.

orientation : int

Cette propriété détermine l'angle en degrés auquel la vidéo affichée est tournée dans le sens des aiguilles d'une montre en coordonnées vidéo, l'axe Y étant orienté vers le bas de l'écran. La transformation de l'orientation est appliquée avant mirrored.

Le changement d'orientation affecte le mappage des coordonnées de la source à la fenêtre de visualisation.

Seuls les multiples de 90 degrés sont pris en charge, c'est-à-dire 0, 90, -90, 180, 270, etc.

Dans certains cas, le flux vidéo source nécessite une certaine orientation pour être corrigé. Il s'agit notamment de sources telles que le viseur d'une caméra, dont l'affichage doit correspondre à la réalité, quelle que soit la rotation du reste de l'interface utilisateur.

Nous recommandons d'utiliser cette propriété pour compenser la rotation de l'interface utilisateur ou pour aligner la vue de sortie sur d'autres exigences de l'application.

La valeur par défaut est 0.

sourceRect : rectangle

Cette propriété indique la zone du contenu vidéo source qui est prise en compte pour le rendu. Les valeurs sont exprimées en coordonnées de pixels de la source, ajustées en fonction du rapport d'aspect des pixels de la source.

Notez qu'en général, le coin supérieur gauche de ce rectangle sera 0,0, tandis que la largeur et la hauteur correspondront à la largeur et à la hauteur du contenu d'entrée. Ces valeurs ne diffèrent que si la source vidéo est dotée d'une fenêtre de visualisation.

Le paramètre d'orientation n'affecte pas ce rectangle.

Voir également QVideoFrameFormat::viewport().

videoSink : object

Cette propriété contient l'objet C++ QVideoSink sous-jacent utilisé pour le rendu des images vidéo de cet élément VideoOutput.

L'utilisation normale de VideoOutput à partir de QML ne devrait pas nécessiter l'utilisation de cette propriété.

Documentation de la méthode

[since 6.9] void clearOutput()

Efface la sortie vidéo en supprimant l'image vidéo actuellement affichée. Cette méthode est recommandée lorsque vous devez supprimer la dernière image vidéo après avoir détaché la sortie vidéo de la source ou après que le flux source se termine alors que la propriété endOfStreamPolicy de la sortie vidéo est définie sur KeepLastFrame.

Cette méthode a été introduite dans Qt 6.9.