VideoOutput QML Type

Afficher la vidéo ou le viseur de l'appareil photo. En savoir plus...

• 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 l'affichage vidéo non transformé, étiré et mis à l'échelle de manière uniforme. Pour une description de l'affichage étiré et mis à l'échelle de manière uniforme, consultez la description de la propriété fillMode.

Voir également MediaPlayer et Camera.

Documentation sur les propriétés

contentRect : rectangle

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

Cette propriété est utile lorsque d’autres coordonnées sont spécifiées par rapport aux dimensions de la source ; cela s’applique aux coordonnées relatives (normalisées) des images comprises entre 0 et 1,0.

Les zones situées en dehors de ce rectangle seront transparentes.

endOfStreamPolicy : enumeration [since 6.9]

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

L'endOfStreamPolicy e peut prendre l'une des valeurs suivantes :

La valeur par défaut est ClearOutput.

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

fillMode : enumeration

Définissez cette propriété pour déterminer comment la vidéo est redimensionnée afin de s'adapter à la zone cible.

• Étirer : la vidéo est redimensionnée pour s'adapter à la zone cible.
• PreserveAspectFit : la vidéo est redimensionnée de manière uniforme pour s'adapter sans être recadrée
• PreserveAspectCrop : la vidéo est redimensionnée de manière uniforme pour remplir la zone, 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 inversée par rapport à son axe vertical. Nous vous recommandons d'utiliser cette propriété si la transformation du flux vidéo source, provenant par exemple d'une caméra avant, ne correspond pas à la logique métier de l'application. L'inversion est appliquée après l'appel de la méthode ` orientation`.

La modification de cette propriété affecte le mappage des coordonnées de la source vers la fenêtre d’affichage.

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, selon lequel la vidéo affichée est pivotée dans le sens des aiguilles d'une montre dans le système de coordonnées vidéo, l'axe Y étant orienté vers le bas sur l'écran. La transformation d'orientation est appliquée avant l'mirrored.

Le changement d’orientation affecte la mise en correspondance des coordonnées entre la source et la fenêtre d’affichage.

Seuls les multiples de 90 degrés sont pris en charge, c'est-à-dire 0, 90, -90, 180, 270, etc. ; dans le cas contraire, la valeur spécifiée est ignorée.

Dans certains cas, le flux vidéo source nécessite une correction d’orientation. C’est notamment le cas de sources telles que le viseur d’une caméra, où l’image affichée 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 une rotation de l’interface utilisateur ou pour aligner la vue de sortie sur d’autres exigences fonctionnelles de l’application.

La valeur par défaut est « 0 ».

sourceRect : rectangle

Cette propriété contient la zone du contenu vidéo source 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 en pixels de la source.

Notez que, généralement, le coin supérieur gauche de ce rectangle correspond à 0,0, tandis que la largeur et la hauteur correspondent à celles du contenu d'entrée. Ces valeurs ne diffèrent que lorsque la source vidéo dispose d'une fenêtre d'affichage définie.

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

Voir également QVideoFrameFormat::viewport().

videoSink : object

Cette propriété contient l'objet C++ sous-jacent ` QVideoSink `, utilisé pour afficher les images vidéo dans cet élément ` VideoOutput `.

Une utilisation normale de ` VideoOutput ` depuis QML ne devrait pas nécessiter l'utilisation de cette propriété.

Documentation des méthodes

[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éconnecté la sortie vidéo de la source ou après la fin du flux source, lorsque la propriété ` endOfStreamPolicy ` de la sortie vidéo est définie sur ` KeepLastFrame`.

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