QColorTransform Class
QColorTransform 类用于在颜色空间之间进行转换。更多内容...
| 头文件： | #include <QColorTransform> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake： | QT += gui |
- 所有成员的列表，包括继承的成员
- QColorTransform 属于绘图类。
公共函数
| QColorTransform() | |
| QColorTransform(QColorTransform &&colorTransform) | |
(since 6.4) bool | isIdentity() const |
| QRgb | map(QRgb argb) const |
| QRgba64 | map(QRgba64 rgba64) const |
(since 6.4) QRgbaFloat16 | map(QRgbaFloat16 rgbafp16) const |
(since 6.4) QRgbaFloat32 | map(QRgbaFloat32 rgbafp32) const |
| QColor | map(const QColor &color) const |
相关的非成员
(since 6.4) bool | operator!=(const QColorTransform &ct1, const QColorTransform &ct2) |
(since 6.4) bool | operator==(const QColorTransform &ct1, const QColorTransform &ct2) |
详细说明
QColorTransform 是颜色空间之间转换的实例化。它可应用于颜色和像素，将其从一个颜色空间转换为另一个颜色空间。
要创建一个 QColorTransform，请使用QColorSpace::transformationToColorSpace()：
QColorSpace sourceColorSpace(QColorSpace::SRgb);
QColorSpace targetColorSpace(QColorSpace::DisplayP3);
QColorTransform srgbToP3Transform = sourceColorSpace.transformationToColorSpace(targetColorSpace);设置 QColorTransform 需要一些预处理工作，因此建议保留经常需要的 QColorTransform 实例，而不是在运行时动态生成。
成员函数文档
[constexpr noexcept default] QColorTransform::QColorTransform()
默认——构造一个QColorTransform 的实例。
[constexpr noexcept default] QColorTransform::QColorTransform(QColorTransform &&colorTransform)
通过 Move 构造一个 `QColorTransform` 的实例。
[noexcept, since 6.4] bool QColorTransform::isIdentity() const
如果颜色变换是单位变换，则返回 true。
该函数在 Qt 6.4 中引入。
QRgb QColorTransform::map(QRgb argb) const
对QRgb 值argb 应用颜色变换。
输入应为不透明值或未进行预乘的值。
QRgba64 QColorTransform::map(QRgba64 rgba64) const
对QRgba64 值rgba64 应用颜色变换。
输入应为不透明或未预乘的值。
[since 6.4] QRgbaFloat16 QColorTransform::map(QRgbaFloat16 rgbafp16) const
对QRgbaFloat16 值rgbafp16 应用颜色变换。
输入应为不透明值或未预乘值。
该函数于 Qt 6.4 中引入。
[since 6.4] QRgbaFloat32 QColorTransform::map(QRgbaFloat32 rgbafp32) const
对QRgbaFloat32 值rgbafp32 应用颜色变换。
输入应为不透明值或未预乘值。
该函数于 Qt 6.4 中引入。
QColor QColorTransform::map(const QColor &color) const
对QColor 的值color 应用颜色转换。
相关非成员
[since 6.4] bool operator!=(const QColorTransform &ct1, const QColorTransform &ct2)
如果 `ct1 ` 未定义与 `ct2` 相同的变换，则返回 true。
该函数在 Qt 6.4 中引入。
[since 6.4] bool operator==(const QColorTransform &ct1, const QColorTransform &ct2)
如果 `ct1 ` 定义的颜色转换与 `ct2` 相同，则返回 true。
该函数自 Qt 6.4 起引入。
© 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.
