QPixelFormat Class

成员函数文档

[constexpr noexcept] QPixelFormat::QPixelFormat()

创建空像素格式。该格式映射到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)

创建一个 QPixelFormat，并将其数据分配给属性。colorModel 将被放入一个 4 位长的缓冲区。

firstSize secondSize thirdSize fourthSize fifthSize alphaSize 所有这些都是为了表示通道的大小。通道的不同用途取决于colorModel 。对于 RGB，firstSize 表示红色通道。对于 CMYK，它代表青色通道的值。

alphaUsage 代表是否使用 alpha 通道。

alphaPosition 是 alpha 通道的位置。

premultiplied 表示 alpha 通道是否已与颜色通道相乘。

typeInterpretation 是像素的解释方式。

byteOrder 表示像素格式的字节序。默认值为CurrentSystemEndian ，对于非字节有序格式，该值将被解析为系统的字节序，对于QPixelFormat::UnsignedByte ，该值将被解析为QPixelFormat::BigEndian 。

subEnum 用于需要通过提供额外枚举来存储一些额外信息的 colorModels。默认值为 0。

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

阿尔法通道相对于颜色通道位置的访问函数。

对于单个通道映射到单个单位的格式，alpha 位置是相对于这些单位而言的。例如，QImage::Format_RGBA16FPx4 的 alpha 位置为QPixelFormat::AtEnd ，alpha 就是最后读取的qfloat16 。

对于将多个通道打包成一个单元的格式，QPixelFormat::AtBeginning 和QPixelFormat::AtEnd 的值映射到打包单元的最重要位和最不重要位，与格式本身的byteOrder() 相对。

例如，对于QImage::Format_ARGB32 ，其类型解释为QPixelFormat::UnsignedInteger ，而byteOrder() 始终与主机系统相匹配，QPixelFormat::AtBeginning 的 alpha 位置意味着 alpha 始终可以在0xFF000000 找到。

如果像素格式和主机字节序不匹配，必须注意将像素格式布局正确映射到主机内存布局。

另请参阅 alphaUsage()、alphaSize() 和premultiplied()。

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

alpha 通道大小的访问函数。

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

是否使用 alpha 通道的访问函数。

有时像素格式会为 alpha 通道预留位置，因此alphaSize() 将返回 > 0，但 alpha 通道未被使用/忽略。

例如，对于QImage::Format_RGB32 ，bitsPerPixel() 为 32，因为 alpha 通道的大小为 8，但 alphaUsage() 反映的是QPixelFormat::IgnoresAlpha 。

请注意，在这种情况下，未使用的 alpha 通道的position 仍然很重要，因为它会影响颜色通道的位置。

另请参见 alphaPosition()、alphaSize() 和premultiplied()。

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

每个像素所用比特的访问函数。该函数返回所有颜色通道的总和 + Alpha 通道的大小。

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

黑色/关键色通道的辅助功能。

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

蓝色通道大小的访问函数。

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

亮度通道尺寸的访问函数。

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

像素格式的字节顺序决定了各个类型单元的内存布局，如typeInterpretation() 所述。

该函数永远不会返回QPixelFormat::CurrentSystemEndian ，因为该值会在构造函数中转换为系统的 endian 值。

对于带有typeInterpretation()QPixelFormat::UnsignedByte 的像素格式，通常会返回QPixelFormat::BigEndian ，而其他类型的解释通常会反映当前系统的字节序。

如果像素格式的字节序与当前系统一致，则无论主机系统的字节序如何，都可以使用相同的位掩码和操作来读取和处理单个类型单元。例如，对于具有QPixelFormat::UnsignedInteger 类型解释的QImage::Format_ARGB32 ，无论主机系统的字节序如何，都可以通过屏蔽unsigned int 和0xFF000000 来读取 alpha。

如果像素格式和主机的 endianness不匹配，则必须考虑到这一点。在这种情况下，像QImage 这样的类不会交换内部位来匹配主机系统的 endianness。

另请参阅 typeInterpretation() 和alphaPosition()。

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

通道计数的访问函数。

通道计数代表大小大于 0 的通道（颜色和 Alpha）。

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

颜色模型的访问函数。

请注意，对于QPixelFormat::YUV ，无法描述单个宏像素。取而代之的是提供一个YUV formats 列表，并从 YUV 布局中推导出bitsPerPixel() 值。

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

青色通道的访问函数。

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

绿色通道大小的访问函数。

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

色调通道大小的访问函数。

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

亮度通道大小的访问函数。

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

洋红颜色通道的访问函数。

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

访问函数，用于确定是否将 alpha 通道乘以颜色通道。

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

红色通道大小的访问函数。

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

饱和通道大小的访问函数。

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

类型解释决定了每个像素的读取方式。

每个像素表示为一个或多个指定类型的单元，在内存中按顺序排列。

例如，QImage::Format_Mono 有一个每像素 1 位的pixel format 和一个QPixelFormat::UnsignedByte 类型解释，应作为单个byte 读取。同样，QImage::Format_RGB888 的pixel format 为每个像素 24 位，而QPixelFormat::UnsignedByte 的类型解释应读作三个连续的bytes。

许多QImage formats 是 32 位的，其类型解释为QPixelFormat::UnsignedInteger ，应读作单个unsigned int 。

对于QPixelFormat::FloatingPoint 格式（如QImage::Format_RGBA16FPx4 或QImage::Format_RGBA32FPx4 ），其类型根据各个颜色/阿尔法通道的大小确定，qfloat16 表示 16 位半浮点格式，float 表示 32 位全浮点格式。

另请参阅 byteOrder() 。

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

黄色通道的访问函数。

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

YUVLayout 的访问函数。由于 YUV 颜色模型使用宏像素，因此很难描述 YUV 像素格式的颜色通道。相反，像素的布局是以枚举形式存储的。