En esta página

QAbstractVideoBuffer Class

La clase `QAbstractVideoBuffer` es una abstracción de los datos de vídeo. Más información...

Encabezado: #include <QAbstractVideoBuffer>
CMake: find_package(Qt6 REQUIRED COMPONENTS Multimedia)
target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake: QT += multimedia
Desde: Qt 6.8

Tipos públicos

struct MapData

Funciones públicas

virtual ~QAbstractVideoBuffer()
virtual QVideoFrameFormat format() const = 0
virtual QAbstractVideoBuffer::MapData map(QVideoFrame::MapMode mode) = 0
virtual void unmap()

Descripción detallada

La clase ` QVideoFrame ` utiliza internamente una clase `QAbstractVideoBuffer` para hacer referencia a un búfer de datos de vídeo. La creación de una subclase de `QAbstractVideoBuffer` permite construir fotogramas de vídeo a partir de búferes preasignados o estáticos. La subclase puede contener un búfer de hardware e implementar el acceso a los datos mediante la asignación del búfer a la memoria de la CPU.

Se puede acceder al contenido de un búfer asignándolo a la memoria mediante la función map(), que devuelve una estructura que contiene información sobre la disposición de los planos de los datos de vídeo actuales.

Véase también QVideoFrame, QVideoFrameFormat y QVideoFrame::MapMode.

Documentación de las funciones miembro

[virtual noexcept] QAbstractVideoBuffer::~QAbstractVideoBuffer()

Elimina un búfer de vídeo.

[pure virtual] QVideoFrameFormat QAbstractVideoBuffer::format() const

Obtiene el objeto ` QVideoFrameFormat ` del búfer de vídeo subyacente.

El formato debe estar disponible en el momento de la creación de ` QVideoFrame`. ` QVideoFrame ` contendrá una instancia del formato indicado, que podrá separarse y modificarse.

[pure virtual] QAbstractVideoBuffer::MapData QAbstractVideoBuffer::map(QVideoFrame::MapMode mode)

Asigna los planos de un búfer de vídeo a la memoria.

Devuelve una estructura ` MapData ` que contiene información sobre la disposición de los planos de los datos de vídeo actuales asignados. Si la asignación falla, el método devuelve la estructura por defecto. En el caso de los búferes de memoria de la CPU, se considera que los datos ya están asignados, por lo que la función simplemente devuelve la disposición de los planos de los datos subyacentes preasignados.

El mapa ` mode ` indica si el contenido de la memoria asignada debe leerse y/o escribirse en el búfer. Si el modo de asignación incluye el indicador ` QVideoFrame::ReadOnly `, la memoria asignada se rellenará con el contenido del búfer al asignarse inicialmente. Si el modo de asignación incluye el indicador ` QVideoFrame::WriteOnly `, el contenido de la memoria asignada, que puede haber sido modificado, se volverá a escribir en el búfer al desasignarla.

Cuando ya no se necesita acceder a los datos, se llama a la función ` unmap ` para liberar la memoria mapeada y, en su caso, actualizar el contenido del búfer.

Si el formato de los datos de vídeo es multiplanar, el método puede asignar todos los datos de píxeles como un único plano. En este caso, al asignar un búfer con ` QVideoFrame `, se calcularán planos adicionales a partir del paso de línea especificado del primer plano, la altura del fotograma y el tamaño de los datos.

[virtual] void QAbstractVideoBuffer::unmap()

Libera la memoria asignada mediante la función ` map()`.

Si la función ` MapMode ` incluía el indicador ` QVideoFrame::WriteOnly `, esto volverá a escribir el contenido actual de la memoria asignada en el fotograma de vídeo.

En el caso de los búferes de vídeo de la CPU, es posible que la función no se pueda sobrescribir. La implementación predeterminada de ` unmap ` no realiza ninguna acción.

Véase también map().

© 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.