VideoOutput QML Type

Renderiza vídeo o el visor de la cámara. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

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

Métodos

• void clearOutput() (since 6.9)

Descripción detallada

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

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

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

El elemento VideoOutput admite la presentación de vídeo sin transformar, estirado y escalado uniformemente. Para una descripción de la presentación estirada a escala uniforme, véase la descripción de la propiedad fillMode.

Véase también MediaPlayer y Camera.

Documentación de la propiedad

contentRect : rectangle

Esta propiedad contiene las coordenadas de posición del área que contendría el vídeo a renderizar. Con ciertos modos de relleno, este rectángulo será mayor que el área visible de VideoOutput.

Esta propiedad es útil cuando otras coordenadas son especificadas en términos de las dimensiones de la fuente - esto aplicado para coordenadas de cuadro relativas (normalizadas) en el rango de 0 a 1.0.

Las áreas fuera de este rango serán transparentes.

endOfStreamPolicy : enumeration [since 6.9]

Esta propiedad especifica la política a aplicar cuando finaliza el flujo de vídeo. Esto ocurre al final de la reproducción multimedia o al desactivar la captura de cámara, pantalla o ventana.

El endOfStreamPolicy puede ser uno de los siguientes:

El valor por defecto es ClearOutput.

Esta propiedad se introdujo en Qt 6.9.

fillMode : enumeration

Establezca esta propiedad para definir cómo se escala el vídeo para ajustarlo al área de destino.

• Stretch - el vídeo se escala para ajustarse.
• PreserveAspectFit - el vídeo se escala uniformemente para ajustarse sin recortar.
• PreserveAspectCrop - el vídeo se escala uniformemente para rellenar, recortando si es necesario.

El modo de relleno predeterminado es PreserveAspectFit.

mirrored : bool [since 6.9]

Determina si el vídeo mostrado se refleja alrededor de su eje vertical. Se recomienda utilizar esta propiedad si la transformación del flujo de vídeo de origen, como el procedente de una cámara frontal, no se ajusta a la lógica de negocio de la aplicación. El reflejo se aplica después de orientation.

El cambio de propiedad afecta al mapeado de coordenadas de la fuente a la ventana gráfica.

El valor por defecto es false.

Esta propiedad se introdujo en Qt 6.9.

orientation : int

Esta propiedad determina el ángulo en, grados, con el que el vídeo visualizado se gira en el sentido de las agujas del reloj en coordenadas de vídeo, donde el eje Y apunta hacia abajo en la pantalla. La transformación de orientación se aplica antes de mirrored.

El cambio de orientación afecta a la asignación de coordenadas de la fuente a la ventana gráfica.

Sólo se admiten múltiplos de 90 grados, es decir, 0, 90, -90, 180, 270, etc., de lo contrario, se ignora el valor especificado.

En algunos casos, la fuente de vídeo requiere una cierta orientación para ser corregida. Esto incluye fuentes como el visor de una cámara, donde el visor mostrado debe coincidir con la realidad, sin importar la rotación que tenga el resto de la interfaz de usuario.

Recomendamos utilizar esta propiedad para compensar una rotación de la interfaz de usuario, o alinear la vista de salida con otros requisitos de negocio de la aplicación.

El valor por defecto es 0.

sourceRect : rectangle

Esta propiedad contiene el área del contenido de vídeo fuente que se tiene en cuenta para el renderizado. Los valores están en coordenadas de píxeles de la fuente, ajustados a la relación de aspecto de píxeles de la fuente.

Tenga en cuenta que normalmente la esquina superior izquierda de este rectángulo será 0,0 mientras que la anchura y la altura serán la anchura y la altura del contenido de entrada. Sólo cuando la fuente de vídeo tenga una ventana gráfica configurada, estos valores serán diferentes.

La orientación no afecta a este rectángulo.

Véase también QVideoFrameFormat::viewport().

videoSink : object

Esta propiedad contiene el objeto C++ QVideoSink subyacente que se utiliza para renderizar los fotogramas de vídeo en este elemento VideoOutput.

El uso normal de VideoOutput desde QML no debería requerir el uso de esta propiedad.

Documentación del método

[since 6.9] void clearOutput()

Borra la salida de vídeo eliminando el fotograma de vídeo actualmente visualizado. Este método se recomienda cuando se necesita eliminar el último fotograma de vídeo después de separar la salida de vídeo de la fuente o después de que el flujo de origen finalice con la propiedad endOfStreamPolicy de la salida de vídeo establecida en KeepLastFrame.

Este método se introdujo en Qt 6.9.