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 这些参数均用于表示通道的大小。各通道的具体用途将根据 而定。对于RGB模式，firstSize将表示红色通道；对于CMYK模式，则表示青色通道的值。fourthSize fifthSize alphaSize colorModel

alphaUsage 表示是否使用 alpha 通道。

alphaPosition 是 alpha 通道的位置。

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

typeInterpretation 表示像素的解释方式。

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

subEnum 用于需要通过提供额外枚举来存储某些附加信息的色彩模型。YUV 会使用此参数来存储 YUV 类型，默认值为 0。

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

用于获取 alpha 通道相对于颜色通道位置的访问器函数。

对于各通道分别映射到独立单位的格式，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 通道预留空间，因此 `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 ，因为该值会在构造函数中被转换为系统的字节序值。

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

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

如果像素格式与主机字节序不匹配，则必须特别注意这一点。在这种情况下，诸如QImage 之类的类不会交换内部位来匹配主机系统的字节序。

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

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

用于获取通道数的访问函数。

通道数表示大小大于 0 的通道（颜色和透明度）。

[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

magenta 颜色通道的 Accessor 函数。

[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 的像素深度（pixel format ）为每像素 1 位，类型解释（type interpretation）为QPixelFormat::UnsignedByte ，应作为单个byte 读取。同样，QImage::Format_RGB888 的像素深度（pixel format ）为每像素 24 位，类型解释（type interpretation）为QPixelFormat::UnsignedByte ，应作为三个连续的byte读取。

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

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

另请参阅 byteOrder()。

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

黄色色通的辅助函数。

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

YUVLayout 的辅助函数。由于 YUV 色彩模型使用宏像素，因此很难描述 YUV 像素格式的颜色通道。相反，像素的布局被存储为一个枚举类型。