VideoOutput QML Type
Mostrar vídeo o el visor de la cámara. Más...
| Import Statement: | import QtMultimedia |
| Inherits: |
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, estirada y escalada uniformemente. Para obtener una descripción de la presentación estirada y escalada uniformemente, consulta la descripción de la propiedad fillMode.
Véase también MediaPlayer y Camera.
Documentación de propiedades
contentRect : rectangle
Esta propiedad contiene las coordenadas del elemento correspondiente al área que contendría el vídeo que se va a renderizar. Con determinados modos de relleno, este rectángulo será más grande que el área visible de VideoOutput.
Esta propiedad resulta útil cuando se especifican otras coordenadas en función de las dimensiones de la fuente; esto se aplica a las coordenadas relativas (normalizadas) del fotograma en el intervalo de 0 a 1,0.
Las áreas fuera de este rectángulo serán transparentes.
endOfStreamPolicy : enumeration [since 6.9]
Esta propiedad especifica la política que se aplicará cuando finalice la transmisión de vídeo. Esto ocurre al finalizar la reproducción del contenido multimedia o al desactivar la captura de la cámara, la pantalla o la ventana.
La propiedad « endOfStreamPolicy » puede adoptar uno de los siguientes valores:
| Constante | Descripción |
|---|---|
ClearOutput | Se borra la salida de vídeo. |
KeepLastFrame | La salida de vídeo sigue mostrando el último fotograma. Utilice el método clearOutput() para borrar la salida manualmente. |
El valor por defecto es ` ClearOutput`.
Esta propiedad se introdujo en Qt 6.9.
fillMode : enumeration
Configura esta propiedad para definir cómo se ajusta el vídeo al área de destino.
- Estirar: el vídeo se escala para ajustarse.
- PreserveAspectFit: el vídeo se escala de manera uniforme para ajustarse sin recortarlo
- PreserveAspectCrop: el vídeo se escala uniformemente para ocupar todo el espacio, recortándolo si es necesario
El modo de ajuste predeterminado es «PreserveAspectFit».
mirrored : bool [since 6.9]
Determina si el vídeo mostrado se refleja simétricamente respecto a su eje vertical. Recomendamos utilizar esta propiedad si la transformación del flujo de vídeo de origen —por ejemplo, el 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 la llamada a ` orientation`.
El cambio en la propiedad afecta a la correspondencia de coordenadas entre la fuente y la ventana de visualización.
El valor por defecto es false.
Esta propiedad se introdujo en Qt 6.9.
orientation : int
Esta propiedad determina el ángulo, en grados, en el que se gira el vídeo mostrado 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 correspondencia de coordenadas entre la fuente y la ventana de visualización.
Solo se admiten múltiplos de 90 grados, es decir, 0, 90, -90, 180, 270, etc.; en caso contrario, se ignora el valor especificado.
En algunos casos, es necesario corregir la orientación de la secuencia de vídeo de origen. Esto incluye fuentes como el visor de una cámara, en las que la imagen mostrada en el visor debe coincidir con la realidad, independientemente de la rotación que tenga el resto de la interfaz de usuario.
Recomendamos utilizar esta propiedad para compensar la rotación de la interfaz de usuario o para alinear la vista de salida con otros requisitos funcionales de la aplicación.
El valor por defecto es 0.
sourceRect : rectangle
Esta propiedad indica el área del contenido de vídeo de origen que se tiene en cuenta para la representación. Los valores se expresan en coordenadas de píxeles de origen, ajustadas según la relación de aspecto en píxeles del origen.
Ten en cuenta que, normalmente, la esquina superior izquierda de este rectángulo será 0,0, mientras que la anchura y la altura serán las del contenido de entrada. Solo cuando la fuente de vídeo tenga definida una ventana de visualización, estos valores variarán.
La configuración de orientación no afecta a este rectángulo.
Véase también QVideoFrameFormat::viewport().
videoSink : object
Esta propiedad contiene el objeto « QVideoSink » de C++ subyacente que se utiliza para renderizar los fotogramas de vídeo en este elemento « VideoOutput ».
El uso habitual 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 que se muestra actualmente. Se recomienda utilizar este método cuando sea necesario eliminar el último fotograma de vídeo tras desconectar la salida de vídeo de la fuente o una vez que la transmisión de la fuente haya finalizado y la propiedad « endOfStreamPolicy » de la salida de vídeo esté establecida en « KeepLastFrame ».
Este método se introdujo en Qt 6.9.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.