En esta página

QColorTransform Class

La clase QColorTransform permite realizar transformaciones entre espacios de color. Más información...

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

Funciones públicas

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)

Descripción detallada

QColorTransform es una instancia de una transformación entre espacios de color. Se puede aplicar a colores y píxeles para convertirlos de un espacio de color a otro.

Para crear un QColorTransform, utiliza QColorSpace::transformationToColorSpace():

QColorSpace sourceColorSpace(QColorSpace::SRgb);
QColorSpace targetColorSpace(QColorSpace::DisplayP3);
QColorTransform srgbToP3Transform = sourceColorSpace.transformationToColorSpace(targetColorSpace);

La configuración de un QColorTransform requiere cierto procesamiento previo, por lo que se recomienda mantener a mano los QColorTransforms que se utilicen con frecuencia, en lugar de generarlos sobre la marcha.

Documentación de las funciones miembro

[constexpr noexcept default] QColorTransform::QColorTransform()

Crea por defecto una instancia de ` QColorTransform`.

[constexpr noexcept default] QColorTransform::QColorTransform(QColorTransform &&colorTransform)

Crea una instancia de ` QColorTransform` mediante la construcción «move».

[noexcept, since 6.4] bool QColorTransform::isIdentity() const

Devuelve «true» si la transformación de color es la transformación identidad.

Esta función se introdujo en Qt 6.4.

QRgb QColorTransform::map(QRgb argb) const

Aplica la transformación de color al valor « QRgb » argb.

La entrada debe ser opaca o no premultiplicada.

QRgba64 QColorTransform::map(QRgba64 rgba64) const

Aplica la transformación de color al valor « QRgba64 » rgba64.

La entrada debe ser opaca o sin premultiplicación.

[since 6.4] QRgbaFloat16 QColorTransform::map(QRgbaFloat16 rgbafp16) const

Aplica la transformación de color al valor de « QRgbaFloat16 » rgbafp16.

La entrada debe ser opaca o no multiplicada por adelantado.

Esta función se introdujo en Qt 6.4.

[since 6.4] QRgbaFloat32 QColorTransform::map(QRgbaFloat32 rgbafp32) const

Aplica la transformación de color al valor « QRgbaFloat32 » rgbafp32.

La entrada debe ser opaca o no premultiplicada.

Esta función se introdujo en Qt 6.4.

QColor QColorTransform::map(const QColor &color) const

Aplica la transformación de color al valor « QColor » color.

Elementos no miembros relacionados

[since 6.4] bool operator!=(const QColorTransform &ct1, const QColorTransform &ct2)

Devuelve «true» si ` ct1 ` no define la misma transformación que ` ct2`.

Esta función se introdujo en Qt 6.4.

[since 6.4] bool operator==(const QColorTransform &ct1, const QColorTransform &ct2)

Devuelve «true» si ` ct1 ` define la misma transformación de color que ` ct2`.

Esta función se introdujo en 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.