QPixelFormat Class

Documentación de la función miembro

[constexpr noexcept] QPixelFormat::QPixelFormat()

Crea un formato de píxel nulo. Este formato se asigna a 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 pondrán en un buffer de 4 bits de longitud.

firstSize secondSize thirdSize fourthSize fifthSize alphaSize representan el tamaño de un canal. Los canales se utilizarán para diferentes usos dependiendo del colorModel. Para RGB el firstSize representará el canal Rojo. En CMYK representará el valor del canal Cian.

alphaUsage representa si se utiliza o no el canal alfa.

alphaPosition es la posición del canal alfa.

premultiplied representa si el canal alfa ya está multiplicado con los canales de color.

typeInterpretation es como se interpreta el pixel.

byteOrder representa el formato del píxel. Este valor por defecto es CurrentSystemEndian, que se resolverá con el endianness del sistema para formatos no ordenados por bytes, y QPixelFormat::BigEndian para QPixelFormat::UnsignedByte.

subEnum se utiliza para colorModels que tienen que almacenar alguna información adicional con el suministro de un enum extra. Esto es usado por YUV para almacenar el tipo YUV El valor por defecto es 0.

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

Función accesoria para la posición del canal alfa en relación con los canales de color.

Para los formatos en los que los canales individuales se asignan a unidades individuales, la posición alfa es relativa a estas unidades. Por ejemplo, para QImage::Format_RGBA16FPx4, que tiene una posición alfa de QPixelFormat::AtEnd, el alfa es el último qfloat16 leído.

Para los formatos en los que varios canales están empaquetados 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 empaquetada, con respecto al propio formato byteOrder().

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

Si el formato de píxel y el endianness del host no coinciden, se debe tener cuidado para mapear correctamente la disposición del formato de píxel a la disposición de la memoria del host.

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

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

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

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

Función accesoria para saber si se utiliza o no el canal alfa.

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

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

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

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

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

Función accesoria para los bits utilizados por píxel. Esta función devuelve la suma de todos los canales de color + el tamaño del canal alfa.

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

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

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

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

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

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

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

El orden de bytes del formato de píxel determina la disposición de memoria de las unidades de tipo individuales, como se describe en typeInterpretation().

Esta función nunca devolverá QPixelFormat::CurrentSystemEndian ya que este valor se traduce al valor endian del sistema en el constructor.

Para formatos de píxel con typeInterpretation() QPixelFormat::UnsignedByte esto será típicamente QPixelFormat::BigEndian, mientras que otras interpretaciones de tipo reflejarán típicamente la endianidad del sistema actual.

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

Si el formato de píxel y el ancho de banda del host no coinciden, hay que tener cuidado. Las clases como QImage no intercambian los bits internos para que coincidan con el ancho de banda del sistema anfitrión en estos casos.

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

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

Función accesoria para el recuento de canales.

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

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

Función accesoria para el modelo de color.

Tenga en cuenta que para QPixelFormat::YUV no se pueden describir los macropíxeles individuales. En su lugar, se proporciona una lista de YUV formats, y el valor bitsPerPixel() se deduce 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 accesoria para el tamaño del canal de color verde.

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

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

[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 accesoria para el canal de color megenta.

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

Función accesoria para saber si el canal alfa se multiplica en los canales de color.

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

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

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

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

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

La interpretación del tipo 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.

Por ejemplo, QImage::Format_Mono tiene un 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 un pixel format de 24 bits por píxel y una interpretación de tipo QPixelFormat::UnsignedByte, que debe leerse como tres bytes consecutivos.

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

Para formatos QPixelFormat::FloatingPoint como QImage::Format_RGBA16FPx4 o QImage::Format_RGBA32FPx4, el tipo se determina en función del tamaño de los canales de color/alfa individuales, con qfloat16 para formatos de medio flotante de 16 bits y float para formatos de flotante completo de 32 bits.

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 de acceso para YUVLayout. Es difícil describir los canales de color de un formato de píxel YUV, ya que el modelo de color YUV utiliza macropíxeles. En su lugar, la disposición de los píxeles se almacena como un enum.