En esta página

QPixelFormat Class

QPixelFormat es una clase que sirve para describir diferentes distribuciones de píxeles en los búferes gráficos. Más información...

Encabezado: #include <QPixelFormat>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

Tipos públicos

enum AlphaPosition { AtBeginning, AtEnd }
enum AlphaPremultiplied { NotPremultiplied, Premultiplied }
enum AlphaUsage { IgnoresAlpha, UsesAlpha }
enum ByteOrder { LittleEndian, BigEndian, CurrentSystemEndian }
enum ColorModel { RGB, BGR, Indexed, Grayscale, CMYK, …, Alpha }
enum TypeInterpretation { UnsignedInteger, UnsignedShort, UnsignedByte, FloatingPoint }
enum YUVLayout { YUV444, YUV422, YUV411, YUV420P, YUV420SP, …, Y16 }

Funciones públicas

QPixelFormat()
QPixelFormat(QPixelFormat::ColorModel colorModel, uchar firstSize, uchar secondSize, uchar thirdSize, uchar fourthSize, uchar fifthSize, uchar alphaSize, QPixelFormat::AlphaUsage alphaUsage, QPixelFormat::AlphaPosition alphaPosition, QPixelFormat::AlphaPremultiplied premultiplied, QPixelFormat::TypeInterpretation typeInterpretation, QPixelFormat::ByteOrder byteOrder = CurrentSystemEndian, uchar subEnum = 0)
QPixelFormat::AlphaPosition alphaPosition() const
uchar alphaSize() const
QPixelFormat::AlphaUsage alphaUsage() const
uchar bitsPerPixel() const
uchar blackSize() const
uchar blueSize() const
uchar brightnessSize() const
QPixelFormat::ByteOrder byteOrder() const
uchar channelCount() const
QPixelFormat::ColorModel colorModel() const
uchar cyanSize() const
uchar greenSize() const
uchar hueSize() const
uchar lightnessSize() const
uchar magentaSize() const
QPixelFormat::AlphaPremultiplied premultiplied() const
uchar redSize() const
uchar saturationSize() const
QPixelFormat::TypeInterpretation typeInterpretation() const
uchar yellowSize() const
QPixelFormat::YUVLayout yuvLayout() const
QPixelFormat qPixelFormatAlpha(uchar channelSize, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::UnsignedInteger)
QPixelFormat qPixelFormatCmyk(uchar channelSize, uchar alphaSize = 0, QPixelFormat::AlphaUsage alphaUsage = QPixelFormat::IgnoresAlpha, QPixelFormat::AlphaPosition alphaPosition = QPixelFormat::AtBeginning, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::UnsignedInteger)
QPixelFormat qPixelFormatGrayscale(uchar channelSize, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::UnsignedInteger)
QPixelFormat qPixelFormatHsl(uchar channelSize, uchar alphaSize = 0, QPixelFormat::AlphaUsage alphaUsage = QPixelFormat::IgnoresAlpha, QPixelFormat::AlphaPosition alphaPosition = QPixelFormat::AtBeginning, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::FloatingPoint)
QPixelFormat qPixelFormatHsv(uchar channelSize, uchar alphaSize = 0, QPixelFormat::AlphaUsage alphaUsage = QPixelFormat::IgnoresAlpha, QPixelFormat::AlphaPosition alphaPosition = QPixelFormat::AtBeginning, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::FloatingPoint)
QPixelFormat qPixelFormatRgba(uchar redSize, uchar greenSize, uchar blueSize, uchar alphaSize, QPixelFormat::AlphaUsage alphaUsage, QPixelFormat::AlphaPosition alphaPosition, QPixelFormat::AlphaPremultiplied premultiplied = QPixelFormat::NotPremultiplied, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::UnsignedInteger)
QPixelFormat qPixelFormatYuv(QPixelFormat::YUVLayout yuvLayout, uchar alphaSize = 0, QPixelFormat::AlphaUsage alphaUsage = QPixelFormat::IgnoresAlpha, QPixelFormat::AlphaPosition alphaPosition = QPixelFormat::AtBeginning, QPixelFormat::AlphaPremultiplied premultiplied = QPixelFormat::NotPremultiplied, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::UnsignedByte, QPixelFormat::ByteOrder byteOrder = QPixelFormat::BigEndian)

Descripción detallada

En Qt suele ser necesario representar la disposición de los píxeles en un búfer gráfico. QPixelFormat puede describir hasta 5 canales de color y 1 canal alfa, incluyendo detalles sobre cómo se representan estos canales en la memoria, tanto individualmente como en relación entre sí.

Las funciones ` typeInterpretation()` y ` byteOrder()` determinan cómo debe leerse o interpretarse cada píxel, mientras que ` alphaSize()`, ` alphaUsage()`, ` alphaPosition()` y ` premultiplied()` describen la posición y las propiedades del posible canal alfa.

No se admite la descripción de los macropíxeles YUV. En su lugar, se proporciona una lista de YUV formats. Cuando un QPixelFormat describe un formato YUV, el valor de bitsPerPixel() se deduce a partir de la disposición YUV.

Documentación sobre los tipos de miembros

enum QPixelFormat::AlphaPosition

Esta enumeración describe la « alpha position » del formato de píxel.

ConstanteValorDescripción
QPixelFormat::AtBeginning0El canal alfa se colocará delante de los canales de color. Por ejemplo, ARGB.
QPixelFormat::AtEnd1El canal alfa se colocará detrás de los canales de color. Por ejemplo, RGBA.

Véase también alphaSize(), alphaUsage() y premultiplied().

enum QPixelFormat::AlphaPremultiplied

Esta enumeración indica si el canal alfa del formato de píxel está « premultiplied » en los canales de color o no.

ConstanteValorDescripción
QPixelFormat::NotPremultiplied0El canal alfa no se multiplica por los canales de color.
QPixelFormat::Premultiplied1El canal alfa se multiplica con los canales de color.

Véase también alphaSize(), alphaUsage() y alphaPosition().

enum QPixelFormat::AlphaUsage

Esta enumeración describe el « alpha usage » del formato de píxeles.

ConstanteValorDescripción
QPixelFormat::IgnoresAlpha1No se utiliza el canal alfa.
QPixelFormat::UsesAlpha0Se utiliza el canal alfa.

Véase también alphaSize(), alphaPosition() y premultiplied().

enum QPixelFormat::ByteOrder

Esta enumeración describe la « byte order » del formato de píxel.

ConstanteValorDescripción
QPixelFormat::LittleEndian0El orden de los bytes es «little endian».
QPixelFormat::BigEndian1El orden de los bytes es «big endian».
QPixelFormat::CurrentSystemEndian2Esta enumeración no se almacenará, sino que se convertirá en el constructor a la enumeración de endianidad que coincida con la del sistema actual.

Véase también typeInterpretation().

enum QPixelFormat::ColorModel

Esta enumeración describe la « color model » del formato de píxeles.

ConstanteValorDescripción
QPixelFormat::RGB0El modelo de color es RGB.
QPixelFormat::BGR1Lógicamente, se trata de la versión con el endianismo inverso del RGB. Sin embargo, para facilitar su uso, cuenta con su propio modelo.
QPixelFormat::Indexed2El modelo de color utiliza una paleta de colores.
QPixelFormat::Grayscale3El modelo de color es la escala de grises.
QPixelFormat::CMYK4El modelo de color es CMYK.
QPixelFormat::HSL5El modelo de color es HSL.
QPixelFormat::HSV6El modelo de color es HSV.
QPixelFormat::YUV7El modelo de color es YUV.
QPixelFormat::Alpha (since Qt 5.5)8No hay modelo de color, solo se utiliza el canal alfa.

enum QPixelFormat::TypeInterpretation

Esta enumeración describe la « type interpretation » del formato de píxeles.

ConstanteValorDescripción
QPixelFormat::UnsignedInteger0Los píxeles deben leerse como uno o más « unsigned int ».
QPixelFormat::UnsignedShort1Los píxeles deben leerse como una o más « unsigned short ».
QPixelFormat::UnsignedByte2Los píxeles deben leerse como uno o más valores de tipo « byte ».
QPixelFormat::FloatingPoint3Los píxeles deben leerse como uno o más números de punto flotante, con el tipo concreto definido por el canal de color/alfa, es decir, qfloat16 para formatos de 16 bits de punto flotante de precisión media y float para formatos de 32 bits de punto flotante de precisión completa.

Véase también byteOrder().

enum QPixelFormat::YUVLayout

Esta enumeración describe la « YUV layout » del formato de píxel, dado que tiene un modelo de color de tipo « QPixelFormat::YUV ».

ConstanteValor
QPixelFormat::YUV4440
QPixelFormat::YUV4221
QPixelFormat::YUV4112
QPixelFormat::YUV420P3
QPixelFormat::YUV420SP4
QPixelFormat::YV125
QPixelFormat::UYVY6
QPixelFormat::YUYV7
QPixelFormat::NV128
QPixelFormat::NV219
QPixelFormat::IMC110
QPixelFormat::IMC211
QPixelFormat::IMC312
QPixelFormat::IMC413
QPixelFormat::Y814
QPixelFormat::Y1615

Documentación de las funciones de miembro

[constexpr noexcept] QPixelFormat::QPixelFormat()

Crea un formato de píxel nulo. Este formato se corresponde con QImage::Format_Invalid.

[constexpr noexcept] QPixelFormat::QPixelFormat(QPixelFormat::ColorModel colorModel, uchar firstSize, uchar secondSize, uchar thirdSize, uchar fourthSize, uchar fifthSize, uchar alphaSize, QPixelFormat::AlphaUsage alphaUsage, QPixelFormat::AlphaPosition alphaPosition, QPixelFormat::AlphaPremultiplied premultiplied, QPixelFormat::TypeInterpretation typeInterpretation, QPixelFormat::ByteOrder byteOrder = CurrentSystemEndian, uchar subEnum = 0)

Crea un QPixelFormat que asigna sus datos a los atributos. « colorModel » se colocará en un búfer de 4 bits de longitud.

firstSize secondSize thirdSize Todos ellos representan el tamaño de un canal. Los canales se utilizarán para diferentes fines en función de . En RGB, firstSize representará el canal rojo. En CMYK, representará el valor del canal cian. fourthSize fifthSize alphaSize colorModel

alphaUsage Indica si se utiliza o no el canal alfa.

alphaPosition es la posición del canal alfa.

premultiplied Indica si el canal alfa ya se ha multiplicado por los canales de color.

typeInterpretation indica cómo se interpreta el píxel.

byteOrder representa el orden de bytes del formato de píxel. El valor por defecto es CurrentSystemEndian, que se resolverá según el orden de bytes del sistema para formatos no ordenados por bytes, y QPixelFormat::BigEndian para QPixelFormat::UnsignedByte.

subEnum Se utiliza para los modelos de color (colorModels) que deben almacenar información adicional mediante una enumeración adicional. YUV lo utiliza para almacenar el tipo YUV. El valor por defecto es 0.

Nota: Los formatosBGR tienen su propio modelo de color y no deben describirse utilizando la endianidad opuesta a la de un formato RGB.

[constexpr noexcept] QPixelFormat::AlphaPosition QPixelFormat::alphaPosition() const

Función de acceso para la posición del canal alfa con respecto a los canales de color.

En los formatos en los que cada canal se asigna a una unidad individual, la posición del canal alfa es relativa a dichas unidades. Por ejemplo, en el caso de QImage::Format_RGBA16FPx4, que tiene una posición alfa de QPixelFormat::AtEnd, el canal alfa es el último qfloat16 leído.

En los formatos en los que varios canales se agrupan en una sola unidad, los valores QPixelFormat::AtBeginning y QPixelFormat::AtEnd se asignan a los bits más significativos y menos significativos de la unidad agrupada, con respecto a la propia byteOrder() del formato.

Por ejemplo, para QImage::Format_ARGB32, que tiene una interpretación de tipo QPixelFormat::UnsignedInteger y un byteOrder() que siempre coincide con el sistema host, la posición alfa de QPixelFormat::AtBeginning significa que el alfa siempre se puede encontrar en 0xFF000000.

Si el formato de píxeles y el orden de bytes del sistema anfitrión no coinciden, hay que tener cuidado de asignar correctamente la disposición del formato de píxeles a la disposición de la memoria del sistema anfitrión.

Véanse también alphaUsage(), alphaSize() y premultiplied().

[constexpr noexcept] uchar QPixelFormat::alphaSize() const

Función accesora para el tamaño del canal alfa.

[constexpr noexcept] QPixelFormat::AlphaUsage QPixelFormat::alphaUsage() const

Función auxiliar que indica si se utiliza o no el canal alfa.

A veces, el formato de píxeles reserva espacio para un canal alfa, por lo que alphaSize() devolverá un valor > 0, pero el canal alfa no se utiliza o se ignora.

Por ejemplo, para QImage::Format_RGB32, el valor de bitsPerPixel() es 32, ya que el canal alfa tiene un tamaño de 8, pero alphaUsage() indica QPixelFormat::IgnoresAlpha.

Tenga en cuenta que, en tales situaciones, el valor de « position » del canal alfa no utilizado sigue siendo importante, ya que afecta a la ubicación de los canales de color.

Véanse también alphaPosition(), alphaSize() y premultiplied().

[constexpr noexcept] uchar QPixelFormat::bitsPerPixel() const

Función «accessor» para los bits utilizados por píxel. Esta función devuelve la suma de todos los canales de color más el tamaño del canal alfa.

[constexpr noexcept] uchar QPixelFormat::blackSize() const

Función auxiliar para el canal de color negro/clave.

[constexpr noexcept] uchar QPixelFormat::blueSize() const

Función accesora para el tamaño del canal de color azul.

[constexpr noexcept] uchar QPixelFormat::brightnessSize() const

Función accesora para el tamaño del canal de brillo.

[constexpr noexcept] QPixelFormat::ByteOrder QPixelFormat::byteOrder() const

El orden de los bytes del formato de píxeles determina la disposición en memoria de las unidades de tipo individuales, tal y como se describe en la función ` typeInterpretation()`.

Esta función nunca devolverá « QPixelFormat::CurrentSystemEndian », ya que este valor se convierte al valor de endian del sistema en el constructor.

Para formatos de píxel con typeInterpretation() QPixelFormat::UnsignedByte, esto suele ser QPixelFormat::BigEndian, mientras que otras interpretaciones de tipos suelen reflejar el endianismo del sistema actual.

Si el orden de los bytes del formato de píxel coincide con el del sistema actual, las unidades de tipo individuales pueden leerse y manipularse utilizando las mismas máscaras de bits y operaciones, independientemente de la endianidad del sistema anfitrión. Por ejemplo, con ` QImage::Format_ARGB32`, que tiene una interpretación de tipo ` QPixelFormat::UnsignedInteger `, el canal alfa siempre puede leerse enmascarando ` unsigned int ` con ` 0xFF000000`, independientemente de la endianidad del sistema anfitrión.

Si el formato de píxel y la endianidad del sistema anfitrión no coinciden, hay que tener esto en cuenta. En estos casos, clases como ` QImage ` no intercambian los bits internos para adaptarse a la endianidad del sistema anfitrión.

Véanse también typeInterpretation() y alphaPosition().

[constexpr noexcept] uchar QPixelFormat::channelCount() const

Función de acceso para el número de canales.

El recuento de canales representa los canales (color y alfa) con un tamaño > 0.

[constexpr noexcept] QPixelFormat::ColorModel QPixelFormat::colorModel() const

Función de acceso para el modelo de color.

Ten en cuenta que, en el caso de QPixelFormat::YUV, no es posible describir los macropíxeles individuales. En su lugar, se proporciona una lista de YUV formats, y el valor de bitsPerPixel() se deduce a partir de la disposición YUV.

[constexpr noexcept] uchar QPixelFormat::cyanSize() const

Función accesoria para el canal de color cian.

[constexpr noexcept] uchar QPixelFormat::greenSize() const

Función accesora para el tamaño del canal de color verde.

[constexpr noexcept] uchar QPixelFormat::hueSize() const

Función accesora para el tamaño del canal de matiz.

[constexpr noexcept] uchar QPixelFormat::lightnessSize() const

Función accesoria para el tamaño del canal de luminosidad.

[constexpr noexcept] uchar QPixelFormat::magentaSize() const

Función «accessor» para el canal de color magenta.

[constexpr noexcept] QPixelFormat::AlphaPremultiplied QPixelFormat::premultiplied() const

Función auxiliar que determina si el canal alfa se multiplica con los canales de color.

[constexpr noexcept] uchar QPixelFormat::redSize() const

Función accesora para el tamaño del canal de color rojo.

[constexpr noexcept] uchar QPixelFormat::saturationSize() const

Función accesora para el tamaño del canal de saturación.

[constexpr noexcept] QPixelFormat::TypeInterpretation QPixelFormat::typeInterpretation() const

La interpretación de tipos determina cómo debe leerse cada píxel.

Cada píxel se representa como una o más unidades del tipo dado, dispuestas secuencialmente en la memoria.

Nota: La « byte order » del formato de píxeles y el orden de bytes del sistema host solo afectan a la disposición en memoria de cada unidad individual que se lee, no al orden relativo de las unidades.

Por ejemplo, QImage::Format_Mono tiene una « pixel format » de 1 bit por píxel y una interpretación de tipo « QPixelFormat::UnsignedByte », que debe leerse como un único byte. Del mismo modo, QImage::Format_RGB888 tiene una « pixel format » de 24 bits por píxel y una interpretación de tipo « QPixelFormat::UnsignedByte », que debe leerse como tres byteconsecutivos.

Muchos de los QImage formats son de 32 bits con una interpretación de tipo QPixelFormat::UnsignedInteger, que debe interpretarse como un único unsigned int.

Para formatos de QPixelFormat::FloatingPoint como QImage::Format_RGBA16FPx4 o QImage::Format_RGBA32FPx4, el tipo se determina en función del tamaño de los canales individuales de color/alfa, siendo qfloat16 para formatos de 16 bits de tipo «half-float» y float para formatos de 32 bits de tipo «full-float».

Véase también byteOrder().

[constexpr noexcept] uchar QPixelFormat::yellowSize() const

Función accesoria para el canal de color amarillo.

[constexpr noexcept] QPixelFormat::YUVLayout QPixelFormat::yuvLayout() const

Función accesora para ` YUVLayout`. Resulta complicado describir los canales de color de un píxel en formato YUV, ya que el modelo de color YUV utiliza macropíxeles. En su lugar, la disposición de los píxeles se almacena como una enumeración.

Elementos no miembros relacionados

[constexpr noexcept] QPixelFormat qPixelFormatAlpha(uchar channelSize, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::UnsignedInteger)

Función constructora para crear un formato alfa. Se puede describir un formato de máscara pasando el valor 1 a channelSize. También es posible definir formatos alfa muy precisos utilizando valores de tipo «double» para describir cada píxel, pasando el valor 8 como channelSize y FloatingPoint como typeInterpretation.

Véase también QPixelFormat::TypeInterpretation.

[constexpr noexcept] QPixelFormat qPixelFormatCmyk(uchar channelSize, uchar alphaSize = 0, QPixelFormat::AlphaUsage alphaUsage = QPixelFormat::IgnoresAlpha, QPixelFormat::AlphaPosition alphaPosition = QPixelFormat::AtBeginning, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::UnsignedInteger)

Función constructora para crear formatos CMYK. El número de canales será 4 o 5, dependiendo de si alphaSize es mayor que cero o no. Todos los canales de color CMYK se establecerán en el valor de channelSize.

alphaUsage alphaPosition y son accesibles mediante los accesores del mismo nombre. typeInterpretation

Véase también QPixelFormat::TypeInterpretation.

[constexpr noexcept] QPixelFormat qPixelFormatGrayscale(uchar channelSize, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::UnsignedInteger)

Función constructora para crear un formato en escala de grises. Los formatos monocromáticos pueden describirse pasando el valor 1 a channelSize. También es posible definir formatos en escala de grises de gran precisión utilizando valores de tipo «double» para describir cada píxel, pasando el valor 8 como channelSize y FloatingPoint como typeInterpretation.

Véase también QPixelFormat::TypeInterpretation.

[constexpr noexcept] QPixelFormat qPixelFormatHsl(uchar channelSize, uchar alphaSize = 0, QPixelFormat::AlphaUsage alphaUsage = QPixelFormat::IgnoresAlpha, QPixelFormat::AlphaPosition alphaPosition = QPixelFormat::AtBeginning, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::FloatingPoint)

Función constructora para crear formatos HSL. El número de canales será 3 o 4, dependiendo de si alphaSize es mayor que 0.

channelSize Establecerá los valores de hueSize, saturationSize y lightnessSize en el mismo valor.

alphaUsage alphaPosition y son accesibles mediante los accesores del mismo nombre. typeInterpretation

[constexpr noexcept] QPixelFormat qPixelFormatHsv(uchar channelSize, uchar alphaSize = 0, QPixelFormat::AlphaUsage alphaUsage = QPixelFormat::IgnoresAlpha, QPixelFormat::AlphaPosition alphaPosition = QPixelFormat::AtBeginning, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::FloatingPoint)

Función constructora para crear formatos HSV. El número de canales será 3 o 4, dependiendo de si alphaSize es mayor que 0.

channelSize Establecerá hueSize, saturationSize y brightnessSize en el mismo valor.

alphaUsage alphaPosition y son accesibles mediante los accesores del mismo nombre. typeInterpretation

[constexpr noexcept] QPixelFormat qPixelFormatRgba(uchar redSize, uchar greenSize, uchar blueSize, uchar alphaSize, QPixelFormat::AlphaUsage alphaUsage, QPixelFormat::AlphaPosition alphaPosition, QPixelFormat::AlphaPremultiplied premultiplied = QPixelFormat::NotPremultiplied, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::UnsignedInteger)

Función constructora que crea un formato de píxel RGB. redSize greenSize blueSize representan el tamaño de cada canal de color. alphaSize describe el tamaño del canal alfa y su posición se describe con alphaPosition. alphaUsage se utiliza para determinar si se utiliza o no el canal alfa. Al establecer el tamaño del canal alfa en 8 y alphaUsage en IgnoresAlpha, es posible crear un formato de 32 bits en el que los canales RGB solo utilizan 24 bits en total. Se puede acceder a premultiplied y typeInterpretation mediante los accesores del mismo nombre.

Véase también QPixelFormat::TypeInterpretation.

QPixelFormat qPixelFormatYuv(QPixelFormat::YUVLayout yuvLayout, uchar alphaSize = 0, QPixelFormat::AlphaUsage alphaUsage = QPixelFormat::IgnoresAlpha, QPixelFormat::AlphaPosition alphaPosition = QPixelFormat::AtBeginning, QPixelFormat::AlphaPremultiplied premultiplied = QPixelFormat::NotPremultiplied, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::UnsignedByte, QPixelFormat::ByteOrder byteOrder = QPixelFormat::BigEndian)

Función constructora para crear un objeto ` QPixelFormat ` que describe un formato YUV con ` yuvLayout`. ` alphaSize ` describe el tamaño de un posible canal alfa y su posición se describe con ` alphaPosition`. Los canales «primero», «segundo», …, «quinto» se establecen todos en 0. ` alphaUsage `, ` premultiplied `, ` typeInterpretation ` y ` byteOrder ` funcionarán igual que con otros formatos.

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