En esta página

QVideoFrameFormat Class

La clase QVideoFrameFormat especifica el formato de flujo de una superficie de presentación de vídeo. Más información...

Cabecera: #include <QVideoFrameFormat>
CMake: find_package(Qt6 REQUIRED COMPONENTS Multimedia)
target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake: QT += multimedia

Tipos públicos

enum ColorRange { ColorRange_Unknown, ColorRange_Video, ColorRange_Full }
enum ColorSpace { ColorSpace_Undefined, ColorSpace_BT601, ColorSpace_BT709, ColorSpace_AdobeRgb, ColorSpace_BT2020 }
enum ColorTransfer { ColorTransfer_Unknown, ColorTransfer_BT709, ColorTransfer_BT601, ColorTransfer_Linear, ColorTransfer_Gamma22, …, ColorTransfer_STD_B67 }
enum Direction { TopToBottom, BottomToTop }
enum PixelFormat { Format_Invalid, Format_ARGB8888, Format_ARGB8888_Premultiplied, Format_XRGB8888, Format_BGRA8888, …, Format_YUV420P10 }

Funciones públicas

QVideoFrameFormat()
QVideoFrameFormat(const QSize &size, QVideoFrameFormat::PixelFormat format)
QVideoFrameFormat(const QVideoFrameFormat &other)
QVideoFrameFormat(QVideoFrameFormat &&other)
~QVideoFrameFormat()
QVideoFrameFormat::ColorRange colorRange() const
QVideoFrameFormat::ColorSpace colorSpace() const
QVideoFrameFormat::ColorTransfer colorTransfer() const
int frameHeight() const
qreal frameRate() const
QSize frameSize() const
int frameWidth() const
bool isMirrored() const
bool isValid() const
QVideoFrameFormat::PixelFormat pixelFormat() const
int planeCount() const
QtVideo::Rotation rotation() const
QVideoFrameFormat::Direction scanLineDirection() const
void setColorRange(QVideoFrameFormat::ColorRange range)
void setColorSpace(QVideoFrameFormat::ColorSpace colorSpace)
void setColorTransfer(QVideoFrameFormat::ColorTransfer colorTransfer)
void setFrameRate(qreal rate)
void setFrameSize(const QSize &size)
void setFrameSize(int width, int height)
void setMaxLuminance(float lum)
void setMirrored(bool mirrored)
void setRotation(QtVideo::Rotation angle)
void setScanLineDirection(QVideoFrameFormat::Direction direction)
void setStreamFrameRate(qreal rate)
void setViewport(const QRect &viewport)
qreal streamFrameRate() const
void swap(QVideoFrameFormat &other)
QRect viewport() const
bool operator!=(const QVideoFrameFormat &other) const
QVideoFrameFormat &operator=(QVideoFrameFormat &&other)
QVideoFrameFormat &operator=(const QVideoFrameFormat &other)
bool operator==(const QVideoFrameFormat &other) const

Miembros públicos estáticos

QImage::Format imageFormatFromPixelFormat(QVideoFrameFormat::PixelFormat format)
QVideoFrameFormat::PixelFormat pixelFormatFromImageFormat(QImage::Format format)
QString pixelFormatToString(QVideoFrameFormat::PixelFormat pixelFormat)

Descripción detallada

Un receptor de vídeo presenta un flujo de fotogramas de vídeo. QVideoFrameFormat describe el tipo de los fotogramas y determina cómo deben presentarse.

Las propiedades fundamentales de un flujo de vídeo necesarias para configurar un receptor de vídeo son el formato de píxeles, establecido mediante ` pixelFormat()``, y las dimensiones del fotograma, establecidas mediante ` frameSize()``.

La región de un fotograma que se muestra realmente en una superficie de vídeo viene determinada por la función viewport(). Un flujo puede tener una ventana de visualización menor que la región completa de un fotograma para dar cabida a vídeos más pequeños que el tamaño óptimo más cercano de un fotograma de vídeo. Por ejemplo, el ancho de un fotograma puede ampliarse para que el inicio de cada línea de barrido esté alineado a ocho bytes.

Otras propiedades comunes son « scanLineDirection()», « frameRate()» y «yCrCbColorSpace()».

Documentación sobre los tipos de miembro

enum QVideoFrameFormat::ColorRange

Describe la gama de colores utilizada por los datos de vídeo. Los datos de vídeo suelen presentarse en una gama de colores completa, en la que se utilizan todos los valores, o en una gama más limitada, utilizada tradicionalmente en los formatos de vídeo YUV, en la que se utiliza un subconjunto de todos los valores.

ConstanteValorDescripción
QVideoFrameFormat::ColorRange_Unknown0Se desconoce la gama de colores del vídeo.
QVideoFrameFormat::ColorRange_Video1 

La gama de colores utilizada tradicionalmente por la mayoría de los formatos de vídeo YUV. En los formatos de 8 bits, el componente Y está limitado a valores comprendidos entre 16 y 235. Los componentes U y V están limitados a valores comprendidos entre 16 y 240

Para profundidades de bits superiores, multiplica estos valores por 2^(profundidad-8).

ConstanteValor
QVideoFrameFormat::ColorRange_Full2

Gama de colores completa. Son válidos todos los valores comprendidos entre 0 y 2^profundidad - 1.

enum QVideoFrameFormat::ColorSpace

Enumera el espacio de color de los fotogramas de vídeo.

ConstanteValorDescripción
QVideoFrameFormat::ColorSpace_Undefined0No se especifica ningún espacio de color.
QVideoFrameFormat::ColorSpace_BT6011Un espacio de color definido por la recomendación BT.601 de la UIT-R, con un rango de valores Y de 16 a 235 y un rango de Cb/Cr de 16 a 240. Se utiliza principalmente en vídeos antiguos destinados a pantallas CRT.
QVideoFrameFormat::ColorSpace_BT7092Un espacio de color definido por la recomendación BT.709 de la UIT-R con el mismo rango de valores que ColorSpace_BT601. Es el espacio de color más utilizado en la actualidad.
QVideoFrameFormat::ColorSpace_AdobeRgb5El espacio de color YUV de rango completo utilizado en la mayoría de los archivos JPEG.
QVideoFrameFormat::ColorSpace_BT20206El espacio de color definido por la norma ITU-R BT.2020. Se utiliza principalmente para vídeos HDR.

enum QVideoFrameFormat::ColorTransfer

ConstanteValorDescripción
QVideoFrameFormat::ColorTransfer_Unknown0Se desconoce la función de transferencia de color.
QVideoFrameFormat::ColorTransfer_BT7091Los valores de color se codifican según la norma BT709. Véase también https://www.itu.int/rec/R-REC-BT.709/en. Se trata de una curva cercana a la curva gamma de 2,2, aunque no idéntica a ella, y es la misma curva de transferencia que se utiliza en sRGB.
QVideoFrameFormat::ColorTransfer_BT6012Los valores de color se codifican según BT601. Véase también https://www.itu.int/rec/R-REC-BT.601/en.
QVideoFrameFormat::ColorTransfer_Linear3Los valores de color son lineales
QVideoFrameFormat::ColorTransfer_Gamma224Los valores de color se codifican con un gamma de 2,2
QVideoFrameFormat::ColorTransfer_Gamma285Los valores de color se codifican con un gamma de 2,8
QVideoFrameFormat::ColorTransfer_ST20846Los valores de color se codifican utilizando la norma STME ST 2084. Esta función de transferencia es la más habitual en HDR y a menudo se denomina «cuantificador perceptual». Véase también https://www.itu.int/rec/R-REC-BT.2100 y https://en.wikipedia.org/wiki/Perceptual_quantizer.
QVideoFrameFormat::ColorTransfer_STD_B677Los valores de color se codifican utilizando la norma ARIB STD B67. A esta función de transferencia también se la conoce a menudo como «gamma logarítmica híbrida». Véase también https://www.itu.int/rec/R-REC-BT.2100 y https://en.wikipedia.org/wiki/Hybrid_log–gamma.

enum QVideoFrameFormat::Direction

Indica la dirección de disposición de las líneas de barrido del vídeo.

ConstanteValorDescripción
QVideoFrameFormat::TopToBottom0Las líneas de barrido se disponen de arriba abajo en el fotograma.
QVideoFrameFormat::BottomToTop1Las líneas de barrido se disponen de la parte inferior del fotograma hacia la parte superior.

enum QVideoFrameFormat::PixelFormat

Enumera los tipos de datos de vídeo.

ConstanteValorDescripción
QVideoFrameFormat::Format_Invalid0El fotograma no es válido.
QVideoFrameFormat::Format_ARGB88881El fotograma se almacena en formato ARGB con 8 bits por componente.
QVideoFrameFormat::Format_ARGB8888_Premultiplied2El fotograma se ha almacenado en formato ARGB premultiplicado con 8 bits por componente.
QVideoFrameFormat::Format_XRGB88883El fotograma se ha almacenado en formato RGB de 32 bits por píxel (0xff, R, G, B).
QVideoFrameFormat::Format_BGRA88884El fotograma se almacena en formato BGRA de 32 bits (0xBBGGRRAA).
QVideoFrameFormat::Format_BGRA8888_Premultiplied5El fotograma se almacena en formato BGRA de 32 bits premultiplicado.
QVideoFrameFormat::Format_ABGR88887El fotograma se almacena en formato ABGR de 32 bits (0xAABBGGRR).
QVideoFrameFormat::Format_XBGR88888El fotograma se almacena utilizando un formato BGR de 32 bits (0xffBBGGRR).
QVideoFrameFormat::Format_RGBA88889El fotograma se almacena en memoria como los bytes R, G, B, A/X, con R en la dirección más baja y A/X en la dirección más alta.
QVideoFrameFormat::Format_BGRX88886El fotograma se almacena en formato BGRx de 32 bits, [31:0] B:G:R:x 8:8:8:8 (little endian)
QVideoFrameFormat::Format_RGBX888810El fotograma se almacena en memoria como los bytes R, G, B, A/X, con R en la dirección más baja y A/X en la dirección más alta.
QVideoFrameFormat::Format_AYUV11El fotograma se almacena utilizando un formato AYUV de 32 bits empaquetado (0xAAYYUUVV).
QVideoFrameFormat::Format_AYUV_Premultiplied12El fotograma se almacena utilizando un formato AYUV de 32 bits premultiplicado y empaquetado (0xAAYYUUVV).
QVideoFrameFormat::Format_YUV420P13El fotograma se almacena utilizando un formato YUV planar de 8 bits por componente, con los planos U y V submuestreados horizontal y verticalmente; es decir, la altura y la anchura de los planos U y V son la mitad de las del plano Y.
QVideoFrameFormat::Format_YUV422P14El fotograma se almacena utilizando un formato YUV planar de 8 bits por componente, con los planos U y V submuestreados horizontalmente; es decir, la anchura de los planos U y V es la mitad de la del plano Y, y la altura de los planos U y V es la misma que la del plano Y.
QVideoFrameFormat::Format_YV1215El fotograma se almacena utilizando un formato YVU planar de 8 bits por componente, con los planos V y U submuestreados horizontal y verticalmente; es decir, la altura y la anchura de los planos V y U son la mitad de las del plano Y.
QVideoFrameFormat::Format_UYVY16El fotograma se almacena utilizando un formato YUV empaquetado de 8 bits por componente, con los planos U y V submuestreados horizontalmente (U-Y-V-Y); es decir, dos píxeles adyacentes horizontalmente se almacenan como un macropíxel de 32 bits que tiene un valor Y para cada píxel y valores U y V comunes.
QVideoFrameFormat::Format_YUYV17El fotograma se almacena utilizando un formato YUV empaquetado de 8 bits por componente, con los planos U y V sometidos a submuestreo horizontal (Y-U-Y-V); es decir, dos píxeles horizontalmente adyacentes se almacenan como un macropíxel de 32 bits que tiene un valor Y para cada píxel y valores U y V comunes.
QVideoFrameFormat::Format_NV1218El fotograma se almacena utilizando un formato YUV semiplanar de 8 bits por componente, con un plano Y (Y) seguido de un plano UV empaquetado, submuestreado horizontal y verticalmente (U-V).
QVideoFrameFormat::Format_NV2119El fotograma se almacena utilizando un formato YUV semiplanar de 8 bits por componente, con un plano Y (Y) seguido de un plano VU (V-U) compactado y submuestreado horizontal y verticalmente.
QVideoFrameFormat::Format_IMC120El fotograma se almacena utilizando un formato YUV planar de 8 bits por componente, con los planos U y V submuestreados horizontal y verticalmente. Esto es similar al tipo Format_YUV420P, salvo que los bytes por línea de los planos U y V se rellenan hasta alcanzar el mismo paso que el plano Y.
QVideoFrameFormat::Format_IMC221El fotograma se almacena utilizando un formato YUV planar de 8 bits por componente, con los planos U y V submuestreados horizontal y verticalmente. Esto es similar al tipo Format_YUV420P, salvo que las líneas de los planos U y V están intercaladas; es decir, cada línea de datos U va seguida de una línea de datos V, creando así una única línea con el mismo paso que los datos Y.
QVideoFrameFormat::Format_IMC322El fotograma se almacena utilizando un formato YVU planar de 8 bits por componente, con los planos V y U submuestreados horizontal y verticalmente. Esto es similar al tipo Format_YV12, salvo que los bytes por línea de los planos V y U se rellenan hasta alcanzar el mismo paso que el plano Y.
QVideoFrameFormat::Format_IMC423El fotograma se almacena utilizando un formato YVU planar de 8 bits por componente, con los planos V y U submuestreados horizontal y verticalmente. Esto es similar al tipo Format_YV12, salvo que las líneas de los planos V y U están intercaladas; es decir, cada línea de datos V va seguida de una línea de datos U, creando así una única línea con el mismo paso que los datos Y.
QVideoFrameFormat::Format_P01026El fotograma se almacena utilizando un formato YUV semiplanar de 16 bits por componente, con un plano Y (Y) seguido de un plano UV (U-V) empaquetado y submuestreado horizontal y verticalmente. Solo se utilizan los 10 bits más significativos de cada componente.
QVideoFrameFormat::Format_P01627El fotograma se almacena utilizando un formato YUV semiplanar de 16 bits por componente, con un plano Y (Y) seguido de un plano UV (U-V) compactado y submuestreado horizontal y verticalmente.
QVideoFrameFormat::Format_Y824El fotograma se almacena utilizando un formato de escala de grises de 8 bits.
QVideoFrameFormat::Format_Y1625El fotograma se almacena utilizando un formato de escala de grises lineal de 16 bits. Little endian.
QVideoFrameFormat::Format_Jpeg29El fotograma se almacena en formato JPEG comprimido.
QVideoFrameFormat::Format_SamplerExternalOES28El fotograma se almacena en formato de textura OES externo. Actualmente, esto solo se utiliza en Android.
QVideoFrameFormat::Format_SamplerRect30El fotograma se almacena en formato de textura rectangular (GL_TEXTURE_RECTANGLE). Solo se utiliza en macOS con una interfaz de hardware de renderizado basada en OpenGL. El formato de píxeles subyacente almacenado en la textura es Format_BRGA8888.
QVideoFrameFormat::Format_YUV420P1031Similar a YUV420, pero utiliza 16 bits por componente, 10 de los cuales son significativos.

Documentación de las funciones de miembro

QVideoFrameFormat::QVideoFrameFormat()

Crea un formato de flujo de vídeo nulo.

QVideoFrameFormat::QVideoFrameFormat(const QSize &size, QVideoFrameFormat::PixelFormat format)

Crea un flujo de vídeo con el fotograma size y el píxel format.

QVideoFrameFormat::QVideoFrameFormat(const QVideoFrameFormat &other)

Crea una copia de other.

[constexpr noexcept default] QVideoFrameFormat::QVideoFrameFormat(QVideoFrameFormat &&other)

Crea un objeto `QVideoFrameFormat` a partir de ` other`.

[noexcept] QVideoFrameFormat::~QVideoFrameFormat()

Elimina la descripción de una transmisión de vídeo.

QVideoFrameFormat::ColorRange QVideoFrameFormat::colorRange() const

Devuelve la gama de colores que debe utilizarse para reproducir el flujo de vídeo.

Véase también setColorRange().

QVideoFrameFormat::ColorSpace QVideoFrameFormat::colorSpace() const

Devuelve el espacio de color de una secuencia de vídeo.

Véase también setColorSpace().

QVideoFrameFormat::ColorTransfer QVideoFrameFormat::colorTransfer() const

Devuelve la función de transferencia de color que debe utilizarse para reproducir el flujo de vídeo.

Véase también setColorTransfer().

int QVideoFrameFormat::frameHeight() const

Devuelve la altura del fotograma en una secuencia de vídeo.

qreal QVideoFrameFormat::frameRate() const

Devuelve la frecuencia de fotogramas de una transmisión de vídeo en fotogramas por segundo.

Véase también setFrameRate().

QSize QVideoFrameFormat::frameSize() const

Devuelve las dimensiones de los fotogramas de una secuencia de vídeo.

Véase también setFrameSize(), frameWidth() y frameHeight().

int QVideoFrameFormat::frameWidth() const

Devuelve la anchura de los fotogramas de una secuencia de vídeo.

Véase también frameSize() y frameHeight().

[static] QImage::Format QVideoFrameFormat::imageFormatFromPixelFormat(QVideoFrameFormat::PixelFormat format)

Devuelve un formato de imagen equivalente a un píxel de un fotograma de vídeo format. Si no existe un formato equivalente, se devuelve en su lugar QImage::Format_Invalid.

Nota: En general, QImage no admite formatos YUV.

bool QVideoFrameFormat::isMirrored() const

Devuelve ` true ` si la superficie se refleja respecto a su eje vertical.

Las transformaciones de QVideoFrameFormat, concretamente la rotación y el reflejo, pueden determinarse mediante la orientación del sensor de la cámara, los ajustes de la cámara o la orientación del flujo de vídeo.

El reflejo se aplica después de la rotación.

Nota: El reflejo aquí difiere de QImage::mirrored, ya que un objeto « QImage » reflejado verticalmente se reflejará alrededor de su eje x.

bool QVideoFrameFormat::isValid() const

Determina si el formato de una superficie de vídeo tiene un formato de píxeles y un tamaño de fotograma válidos.

Devuelve «true» si el formato es válido y «false» en caso contrario.

QVideoFrameFormat::PixelFormat QVideoFrameFormat::pixelFormat() const

Devuelve el formato de píxeles de los fotogramas de una secuencia de vídeo.

[static] QVideoFrameFormat::PixelFormat QVideoFrameFormat::pixelFormatFromImageFormat(QImage::Format format)

Devuelve un formato de píxel de vídeo equivalente a una imagen format. Si no existe un formato equivalente, se devuelve en su lugar QVideoFrameFormat::Format_Invalid.

Nota: En general, QImage no admite formatos YUV.

[static] QString QVideoFrameFormat::pixelFormatToString(QVideoFrameFormat::PixelFormat pixelFormat)

Devuelve una representación en forma de cadena del objeto ` pixelFormat` indicado.

int QVideoFrameFormat::planeCount() const

Devuelve el número de planos utilizados. Este número depende del formato de píxeles y es 1 para los formatos basados en RGB, y un número comprendido entre 1 y 3 para los formatos basados en YUV.

QtVideo::Rotation QVideoFrameFormat::rotation() const

Devuelve el ángulo en el que se gira la superficie en el sentido de las agujas del reloj.

Las transformaciones de QVideoFrameFormat, concretamente la rotación y el reflejo, pueden determinarse mediante la orientación del sensor de la cámara, los ajustes de la cámara o la orientación del flujo de vídeo.

La rotación se aplica antes del reflejo.

Véase también setRotation().

QVideoFrameFormat::Direction QVideoFrameFormat::scanLineDirection() const

Devuelve la dirección de las líneas de barrido.

Véase también setScanLineDirection().

void QVideoFrameFormat::setColorRange(QVideoFrameFormat::ColorRange range)

Establece el rango de transferencia de color que se debe utilizar para renderizar el flujo de vídeo en range.

Véase también colorRange().

void QVideoFrameFormat::setColorSpace(QVideoFrameFormat::ColorSpace colorSpace)

Establece el « colorSpace » de una secuencia de vídeo.

Véase también colorSpace().

void QVideoFrameFormat::setColorTransfer(QVideoFrameFormat::ColorTransfer colorTransfer)

Establece la función de transferencia de color que se debe utilizar para renderizar el flujo de vídeo en colorTransfer.

Véase también colorTransfer().

void QVideoFrameFormat::setFrameRate(qreal rate)

Establece la velocidad de fotogramas rate de una secuencia de vídeo en fotogramas por segundo.

Véase también frameRate().

void QVideoFrameFormat::setFrameSize(const QSize &size)

Establece el tamaño de los fotogramas de una transmisión de vídeo en size.

Esto restablecerá la función viewport() para que ocupe todo el fotograma.

Véase también frameSize().

void QVideoFrameFormat::setFrameSize(int width, int height)

Establece los parámetros « width » y « height » de los fotogramas de una secuencia de vídeo.

Esto restablecerá el valor de viewport() para que ocupe todo el fotograma.

Se trata de una función sobrecargada.

void QVideoFrameFormat::setMaxLuminance(float lum)

Establece la luminancia máxima en el valor indicado, lum.

void QVideoFrameFormat::setMirrored(bool mirrored)

Establece si la superficie está sometida a una transformación de « mirrored » alrededor de su eje vertical.

Las transformaciones de « QVideoFrameFormat », concretamente la rotación y el reflejo, pueden determinarse mediante la orientación del sensor de la cámara, los ajustes de la cámara o la orientación del flujo de vídeo.

El reflejo se aplica tras la rotación.

El valor por defecto es « false ».

Nota: El reflejo aquí difiere de QImage::mirrored, ya que un QImage reflejado verticalmente se reflejará alrededor de su eje x.

Véase también isMirrored().

void QVideoFrameFormat::setRotation(QtVideo::Rotation angle)

Establece el valor de « angle » con el que se gira la superficie en el sentido de las agujas del reloj.

Las transformaciones de QVideoFrameFormat, concretamente la rotación y el reflejo, pueden determinarse por la orientación del sensor de la cámara, los ajustes de la cámara o la orientación de la secuencia de vídeo.

La rotación se aplica antes del reflejo.

El valor por defecto es ` QtVideo::Rotation::None`.

Véase también rotation().

void QVideoFrameFormat::setScanLineDirection(QVideoFrameFormat::Direction direction)

Establece el direction de las líneas de exploración.

Véase también scanLineDirection().

void QVideoFrameFormat::setStreamFrameRate(qreal rate)

Establece la frecuencia de fotogramas rate de una secuencia de vídeo en fotogramas por segundo.

Véase también streamFrameRate().

void QVideoFrameFormat::setViewport(const QRect &viewport)

Establece la ventana de visualización de una transmisión de vídeo en viewport.

Véase también viewport().

qreal QVideoFrameFormat::streamFrameRate() const

Devuelve la frecuencia de fotogramas de una transmisión de vídeo en fotogramas por segundo.

Véase también ` setStreamFrameRate()`.

[noexcept] void QVideoFrameFormat::swap(QVideoFrameFormat &other)

Cambia el formato actual del fotograma de vídeo por el de « other ».

QRect QVideoFrameFormat::viewport() const

Devuelve la ventana de visualización de una secuencia de vídeo.

La ventana de visualización es la región de un fotograma de vídeo que se muestra realmente.

Por defecto, la ventana de visualización abarca todo el fotograma.

Véase también setViewport().

bool QVideoFrameFormat::operator!=(const QVideoFrameFormat &other) const

Devuelve «true» si other es diferente a este formato de vídeo, y «false» si son iguales.

[noexcept] QVideoFrameFormat &QVideoFrameFormat::operator=(QVideoFrameFormat &&other)

Traslada « other » a esta dirección: QVideoFrameFormat.

QVideoFrameFormat &QVideoFrameFormat::operator=(const QVideoFrameFormat &other)

Asigna los valores de other a este objeto.

bool QVideoFrameFormat::operator==(const QVideoFrameFormat &other) const

Devuelve «true» si « other » es igual al formato de este vídeo, y «false» si son diferentes.

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