En esta página

QColorSpace Class

La clase QColorSpace ofrece una abstracción del espacio de color. Más información...

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

Tipos públicos

(since 6.9) struct PrimaryPoints
(since 6.8) enum class ColorModel { Undefined, Rgb, Gray, Cmyk }
enum NamedColorSpace { SRgb, SRgbLinear, AdobeRgb, DisplayP3, ProPhotoRgb, …, Bt2100Hlg }
enum class Primaries { Custom, SRgb, AdobeRgb, DciP3D65, ProPhotoRgb, Bt2020 }
enum class TransferFunction { Custom, Linear, Gamma, SRgb, ProPhotoRgb, …, Hlg }
(since 6.8) enum class TransformModel { ThreeComponentMatrix, ElementListProcessing }

Funciones públicas

QColorSpace()
QColorSpace(QColorSpace::NamedColorSpace namedColorSpace)
(since 6.1) QColorSpace(QColorSpace::Primaries gamut, const QList<uint16_t> &transferFunctionTable)
QColorSpace(QColorSpace::Primaries primaries, float gamma)
(since 6.8) QColorSpace(QPointF whitePoint, const QList<uint16_t> &transferFunctionTable)
QColorSpace(QColorSpace::Primaries primaries, QColorSpace::TransferFunction transferFunction, float gamma = 0.0f)
(since 6.8) QColorSpace(QPointF whitePoint, QColorSpace::TransferFunction transferFunction, float gamma = 0.0f)
(since 6.9) QColorSpace(const QColorSpace::PrimaryPoints &primaryPoints, QColorSpace::TransferFunction transferFunction, float gamma = 0.0f)
(since 6.1) QColorSpace(const QPointF &whitePoint, const QPointF &redPoint, const QPointF &greenPoint, const QPointF &bluePoint, const QList<uint16_t> &transferFunctionTable)
QColorSpace(const QPointF &whitePoint, const QPointF &redPoint, const QPointF &greenPoint, const QPointF &bluePoint, QColorSpace::TransferFunction transferFunction, float gamma = 0.0f)
(since 6.1) QColorSpace(const QPointF &whitePoint, const QPointF &redPoint, const QPointF &greenPoint, const QPointF &bluePoint, const QList<uint16_t> &redTransferFunctionTable, const QList<uint16_t> &greenTransferFunctionTable, const QList<uint16_t> &blueTransferFunctionTable)
QColorSpace(QColorSpace &&colorSpace)
(since 6.8) QColorSpace::ColorModel colorModel() const
(since 6.2) QString description() const
float gamma() const
QByteArray iccProfile() const
bool isValid() const
(since 6.8) bool isValidTarget() const
QColorSpace::Primaries primaries() const
(since 6.9) QColorSpace::PrimaryPoints primaryPoints() const
(since 6.2) void setDescription(const QString &description)
void setPrimaries(QColorSpace::Primaries primariesId)
void setPrimaries(const QPointF &whitePoint, const QPointF &redPoint, const QPointF &greenPoint, const QPointF &bluePoint)
(since 6.9) void setPrimaryPoints(const QColorSpace::PrimaryPoints &primaryPoints)
(since 6.1) void setTransferFunction(const QList<uint16_t> &transferFunctionTable)
void setTransferFunction(QColorSpace::TransferFunction transferFunction, float gamma = 0.0f)
(since 6.1) void setTransferFunctions(const QList<uint16_t> &redTransferFunctionTable, const QList<uint16_t> &greenTransferFunctionTable, const QList<uint16_t> &blueTransferFunctionTable)
(since 6.8) void setWhitePoint(QPointF whitePoint)
void swap(QColorSpace &other)
QColorSpace::TransferFunction transferFunction() const
(since 6.8) QColorSpace::TransformModel transformModel() const
QColorTransform transformationToColorSpace(const QColorSpace &colorspace) const
(since 6.8) QPointF whitePoint() const
(since 6.1) QColorSpace withTransferFunction(const QList<uint16_t> &transferFunctionTable) const
QColorSpace withTransferFunction(QColorSpace::TransferFunction transferFunction, float gamma = 0.0f) const
(since 6.1) QColorSpace withTransferFunctions(const QList<uint16_t> &redTransferFunctionTable, const QList<uint16_t> &greenTransferFunctionTable, const QList<uint16_t> &blueTransferFunctionTable) const
operator QVariant() const

Miembros públicos estáticos

QColorSpace fromIccProfile(const QByteArray &iccProfile)
bool operator!=(const QColorSpace &colorSpace1, const QColorSpace &colorSpace2)
QDataStream &operator<<(QDataStream &stream, const QColorSpace &colorSpace)
bool operator==(const QColorSpace &colorSpace1, const QColorSpace &colorSpace2)
QDataStream &operator>>(QDataStream &stream, QColorSpace &colorSpace)

Descripción detallada

Los valores de color pueden interpretarse de diferentes maneras y, en función de la interpretación, pueden pertenecer a diferentes espacios. A esto lo llamamos «espacios de color».

QColorSpace permite crear varios espacios de color predefinidos y puede generar QColorTransforms para convertir colores de un espacio de color a otro.

QColorSpace también puede representar espacios de color definidos por perfiles ICC o incrustados en imágenes, que de otro modo no encajarían en los espacios de color predefinidos.

En términos generales, un espacio de color puede concebirse como una combinación de un conjunto de colores primarios y una función de transferencia. Los colores primarios definen los ejes del espacio de color, y la función de transferencia determina cómo se asignan los valores a dichos ejes. En el caso de los espacios de color « ColorModel::Rgb », los colores primarios son tres colores que representan exactamente el aspecto del rojo, el verde y el azul en ese espacio de color concreto, además de un color blanco que indica dónde se sitúa y qué grado de brillo tiene el blanco puro. En el caso de los espacios de color en escala de grises, solo se necesita un único color primario blanco. La gama de colores que pueden expresarse mediante los colores primarios se denomina «gama», y un espacio de color capaz de representar una gama más amplia de colores también se conoce como «espacio de color de amplia gama».

La función de transferencia o curva gamma determina cómo se codifica cada componente del espacio de color. Se utilizan porque la percepción humana no funciona de forma lineal, y las funciones de transferencia tratan de garantizar que los colores parezcan espaciados de manera uniforme a los ojos humanos.

Documentación sobre tipos de miembros

[since 6.8] enum class QColorSpace::ColorModel

Define el modelo de color utilizado por los datos del espacio de color.

ConstanteValorDescripción
QColorSpace::ColorModel::Undefined0Sin modelo de color
QColorSpace::ColorModel::Rgb1Un modelo de color RGB con los colores rojo, verde y azul. Se puede aplicar a datos RGB y en escala de grises.
QColorSpace::ColorModel::Gray2Un modelo de color en escala de grises. Solo se puede aplicar a datos en escala de grises.
QColorSpace::ColorModel::Cmyk3Solo puede representar datos de color definidos con los colores cian, magenta, amarillo y negro. En la práctica, solo QImage::Format_CMYK32. Nota: Los espacios de color CMYK serán TransformModel::ElementListProcessing.

Esta enumeración se introdujo en Qt 6.8.

enum QColorSpace::NamedColorSpace

Espacios de color predefinidos.

ConstanteValorDescripción
QColorSpace::SRgb1El espacio de color sRGB, en el que Qt opera de forma predeterminada. Es una aproximación bastante fiel al funcionamiento de la mayoría de los monitores clásicos, y un modo compatible con la mayoría de programas y dispositivos. Registro ICC de sRGB.
QColorSpace::SRgbLinear2El espacio de color sRGB con gamma lineal. Útil para la mezcla con corrección de gamma.
QColorSpace::AdobeRgb3El espacio de color Adobe RGB es un espacio de color clásico de amplia gama, que utiliza un gamma de 2,2. Registro ICC de Adobe RGB (1998)
QColorSpace::DisplayP34Un espacio de color que utiliza los colores primarios de DCI-P3, pero con el punto blanco y la función de transferencia de sRGB. Es habitual en las pantallas modernas de amplia gama. Registro ICC de DCI-P3
QColorSpace::ProPhotoRgb5El espacio de color Pro Photo RGB, también conocido como ROMM RGB, es un espacio de color de gama muy amplia. Registro ICC de ROMM RGB
QColorSpace::Bt2020 (since Qt 6.8)6BT.2020, también conocido como Rec.2020, es un espacio de color básico de los televisores HDR. Registro ICC de BT.2020
QColorSpace::Bt2100Pq (since Qt 6.8)7BT.2100(PQ), también conocido como Rec.2100 o HDR10, es una codificación HDR con los mismos colores primarios que BT.2020, pero que utiliza la función de transferencia del cuantificador perceptual. Registro ICC de BT.2100
QColorSpace::Bt2100Hlg (since Qt 6.8)8BT.2100 (HLG) es una codificación HDR con los mismos colores primarios que BT.2020, pero que utiliza la función de transferencia Hybrid Log-Gamma.

enum class QColorSpace::Primaries

Conjuntos predefinidos de colores primarios.

ConstanteValorDescripción
QColorSpace::Primaries::Custom0Los colores primarios no están definidos o no coinciden con ningún conjunto predefinido.
QColorSpace::Primaries::SRgb1Los colores primarios sRGB
QColorSpace::Primaries::AdobeRgb2Los colores primarios de Adobe RGB
QColorSpace::Primaries::DciP3D653Los colores primarios DCI-P3 con el punto blanco D65
QColorSpace::Primaries::ProPhotoRgb4Los colores primarios de ProPhoto RGB con el punto blanco D50
QColorSpace::Primaries::Bt2020 (since Qt 6.8)5Los colores primarios BT.2020 con punto blanco D65

enum class QColorSpace::TransferFunction

Funciones de transferencia predefinidas o curvas gamma.

Valor constanteValorDescripción
QColorSpace::TransferFunction::Custom0La función de transferencia personalizada o nula
QColorSpace::TransferFunction::Linear1Las funciones de transferencia lineales
QColorSpace::TransferFunction::Gamma2Una función de transferencia que es una curva gamma real basada en el valor de gamma()
QColorSpace::TransferFunction::SRgb3La función de transferencia sRGB, compuesta por partes lineales y gamma
QColorSpace::TransferFunction::ProPhotoRgb4La función de transferencia ProPhoto RGB, compuesta por partes lineales y gamma
QColorSpace::TransferFunction::Bt2020 (since Qt 6.8)5La función de transferencia BT.2020, compuesta por partes lineales y gamma
QColorSpace::TransferFunction::St2084 (since Qt 6.8)6La función de transferencia SMPTE ST 2084, también conocida como cuantificador perceptual (PQ).
QColorSpace::TransferFunction::Hlg (since Qt 6.8)7La función de transferencia híbrida log-gamma.

[since 6.8] enum class QColorSpace::TransformModel

Define el modelo de procesamiento utilizado para las transformaciones del espacio de color.

ConstanteValorDescripción
QColorSpace::TransformModel::ThreeComponentMatrix0La transformación consiste en una matriz calculada a partir de los colores primarios y un conjunto de funciones de transferencia para cada canal de color. Es muy rápida y la utilizan todos los espacios de color predefinidos. Cualquier espacio de color de este tipo es reversible y siempre es válido tanto como origen como destino.
QColorSpace::TransformModel::ElementListProcessing1Las transformaciones consisten en una o dos listas de elementos de procesamiento que pueden realizar diversas funciones; cada lista solo procesa hacia el espacio de color de conexión o desde él. Esto resulta muy flexible, aunque bastante lento, y solo se puede configurar leyendo perfiles ICC (véase fromIccProfile()). Dado que las dos listas están separadas, un espacio de color de este tipo puede ser una fuente válida, pero no necesariamente también un destino válido. Al cambiar los primarios o la función de transferencia en un espacio de color de este tipo, se restablecerá a una forma ThreeComponentMatrix vacía.

Esta enumeración se introdujo en Qt 6.8.

Documentación de las funciones miembro

[constexpr noexcept default] QColorSpace::QColorSpace()

Crea un nuevo objeto de espacio de color que representa un espacio de color indefinido e inválido.

QColorSpace::QColorSpace(QColorSpace::NamedColorSpace namedColorSpace)

Crea un nuevo objeto de espacio de color que representa un ` namedColorSpace`.

[since 6.1] QColorSpace::QColorSpace(QColorSpace::Primaries gamut, const QList<uint16_t> &transferFunctionTable)

Crea un espacio de color personalizado con los colores primarios gamut, utilizando una función de transferencia personalizada descrita en transferFunctionTable.

La tabla debe contener al menos 2 valores y una lista de valores monótonamente creciente de 0 a 65535.

Esta función se introdujo en Qt 6.1.

QColorSpace::QColorSpace(QColorSpace::Primaries primaries, float gamma)

Crea un espacio de color personalizado con los colores primarios primaries, utilizando una función de transferencia gamma de gamma.

[explicit, since 6.8] QColorSpace::QColorSpace(QPointF whitePoint, const QList<uint16_t> &transferFunctionTable)

Crea un espacio de color personalizado en escala de grises con el punto blanco whitePoint y utilizando la función de transferencia personalizada descrita en transferFunctionTable.

Esta función se introdujo en Qt 6.8.

QColorSpace::QColorSpace(QColorSpace::Primaries primaries, QColorSpace::TransferFunction transferFunction, float gamma = 0.0f)

Crea un espacio de color personalizado con los colores primarios primaries, utilizando la función de transferencia transferFunction y, opcionalmente, gamma.

[explicit, since 6.8] QColorSpace::QColorSpace(QPointF whitePoint, QColorSpace::TransferFunction transferFunction, float gamma = 0.0f)

Crea un espacio de color personalizado en escala de grises con el punto blanco whitePoint, utilizando la función de transferencia transferFunction y, opcionalmente, gamma.

Esta función se introdujo en Qt 6.8.

[since 6.9] QColorSpace::QColorSpace(const QColorSpace::PrimaryPoints &primaryPoints, QColorSpace::TransferFunction transferFunction, float gamma = 0.0f)

Crea un espacio de color personalizado con colores primarios basados en las cromaticidades de los colores primarios primaryPoints, y utilizando la función de transferencia transferFunction y, opcionalmente, gamma.

Esta función se introdujo en Qt 6.9.

[since 6.1] QColorSpace::QColorSpace(const QPointF &whitePoint, const QPointF &redPoint, const QPointF &greenPoint, const QPointF &bluePoint, const QList<uint16_t> &transferFunctionTable)

Crea un espacio de color personalizado con colores primarios basados en las cromaticidades de los colores primarios whitePoint, redPoint, greenPoint y bluePoint, y utilizando la función de transferencia personalizada descrita en transferFunctionTable.

Esta función se introdujo en Qt 6.1.

QColorSpace::QColorSpace(const QPointF &whitePoint, const QPointF &redPoint, const QPointF &greenPoint, const QPointF &bluePoint, QColorSpace::TransferFunction transferFunction, float gamma = 0.0f)

Crea un espacio de color personalizado con colores primarios basados en las cromaticidades de los colores primarios whitePoint, redPoint, greenPoint y bluePoint, y utilizando la función de transferencia transferFunction y, opcionalmente, gamma.

[since 6.1] QColorSpace::QColorSpace(const QPointF &whitePoint, const QPointF &redPoint, const QPointF &greenPoint, const QPointF &bluePoint, const QList<uint16_t> &redTransferFunctionTable, const QList<uint16_t> &greenTransferFunctionTable, const QList<uint16_t> &blueTransferFunctionTable)

Crea un espacio de color personalizado con colores primarios basados en las cromaticidades de los colores primarios whitePoint, redPoint, greenPoint y bluePoint, y utilizando las funciones de transferencia personalizadas descritas en redTransferFunctionTable, greenTransferFunctionTable y blueTransferFunctionTable.

Esta función se introdujo en Qt 6.1.

[constexpr noexcept default] QColorSpace::QColorSpace(QColorSpace &&colorSpace)

Crea una instancia de ` QColorSpace` mediante la construcción por movimiento.

[noexcept, since 6.8] QColorSpace::ColorModel QColorSpace::colorModel() const

Devuelve el modelo de color que este espacio de color puede representar

Esta función se introdujo en Qt 6.8.

[noexcept, since 6.2] QString QColorSpace::description() const

Devuelve el nombre o una breve descripción. Si no se ha proporcionado una descripción en ` setDescription()` (), se devuelve el nombre original del perfil si este no ha sido modificado; se devuelve un nombre estimado si el perfil se ha reconocido como un espacio de color conocido; en caso contrario, se devuelve una cadena vacía.

Esta función se introdujo en Qt 6.2.

Véase también setDescription().

[static] QColorSpace QColorSpace::fromIccProfile(const QByteArray &iccProfile)

Crea un archivo « QColorSpace » a partir del perfil ICC « iccProfile ».

Nota: No todos los perfiles ICC son compatibles. QColorSpace solo admite perfiles ICC RGB o en escala de grises.

Si el perfil ICC no es compatible, se devuelve un ` QColorSpace ` no válido, aunque aún así se puede leer el perfil ICC original mediante ` iccProfile()`.

Véase también iccProfile().

[noexcept] float QColorSpace::gamma() const

Devuelve el valor gamma de los espacios de color con TransferFunction::Gamma, un valor gamma aproximado para otros espacios de color predefinidos, o 0,0 si no se conoce ningún valor gamma aproximado.

Véase también transferFunction().

QByteArray QColorSpace::iccProfile() const

Devuelve un perfil ICC que representa el espacio de color.

Si el espacio de color se ha generado a partir de un perfil ICC, se devuelve dicho perfil; de lo contrario, se genera uno.

Nota: Incluso los espacios de color no válidos pueden devolver el perfil ICC si se generaron a partir de uno, para permitir que las aplicaciones implementen por sí mismas una compatibilidad más amplia.

Véase también fromIccProfile().

[noexcept] bool QColorSpace::isValid() const

Devuelve « true » si el espacio de color es válido. Para un espacio de color con TransformModel::ThreeComponentMatrix, esto significa que se han definido tanto los colores primarios como las funciones de transferencia, lo que implica que isValidTarget(). Para un espacio de color con TransformModel::ElementListProcessing, significa que tiene una transformación de origen válida; para comprobar si también es un espacio de color de destino válido, utiliza isValidTarget().

Véase también isValidTarget().

[noexcept, since 6.8] bool QColorSpace::isValidTarget() const

Devuelve « true » si el espacio de color es un espacio de color de destino válido.

Esta función se introdujo en Qt 6.8.

[noexcept] QColorSpace::Primaries QColorSpace::primaries() const

Devuelve los colores primarios predefinidos del espacio de color o « primaries::Custom » si no coincide con ninguno de ellos.

Véase también setPrimaries().

[since 6.9] QColorSpace::PrimaryPoints QColorSpace::primaryPoints() const

Devuelve las cromaticidades primarias; si no están definidas, devuelve puntos nulos.

Esta función se introdujo en Qt 6.9.

Véase también primaries() y setPrimaryPoints().

[since 6.2] void QColorSpace::setDescription(const QString &description)

Establece el nombre o la descripción breve del espacio de color en « description ».

Si se deja vacío, description() devolverá las descripciones originales o las estimadas.

Esta función se introdujo en Qt 6.2.

Véase también description().

void QColorSpace::setPrimaries(QColorSpace::Primaries primariesId)

Establece los colores primarios según los definidos en el conjunto « primariesId ».

Véase también primaries().

void QColorSpace::setPrimaries(const QPointF &whitePoint, const QPointF &redPoint, const QPointF &greenPoint, const QPointF &bluePoint)

Establece los colores primarios según las cromaticidades de whitePoint, redPoint, greenPoint y bluePoint.

Véase también primaries() y setPrimaryPoints().

[since 6.9] void QColorSpace::setPrimaryPoints(const QColorSpace::PrimaryPoints &primaryPoints)

Establece todos los colores primarios con las cromaticidades de primaryPoints.

Esta función se introdujo en Qt 6.9.

Véase también primaries() y primaryPoints().

[since 6.1] void QColorSpace::setTransferFunction(const QList<uint16_t> &transferFunctionTable)

Establece la función de transferencia en transferFunctionTable.

Esta función se introdujo en Qt 6.1.

Véase también transferFunction() y withTransferFunction().

void QColorSpace::setTransferFunction(QColorSpace::TransferFunction transferFunction, float gamma = 0.0f)

Establece la función de transferencia en transferFunction y gamma.

Véase también transferFunction(), gamma() y withTransferFunction().

[since 6.1] void QColorSpace::setTransferFunctions(const QList<uint16_t> &redTransferFunctionTable, const QList<uint16_t> &greenTransferFunctionTable, const QList<uint16_t> &blueTransferFunctionTable)

Establece las funciones de transferencia en redTransferFunctionTable, greenTransferFunctionTable y blueTransferFunctionTable.

Esta función se introdujo en Qt 6.1.

Véase también withTransferFunctions().

[since 6.8] void QColorSpace::setWhitePoint(QPointF whitePoint)

Establece el punto blanco que se utilizará para este espacio de color en whitePoint.

Esta función se introdujo en Qt 6.8.

Véase también whitePoint().

[noexcept] void QColorSpace::swap(QColorSpace &other)

Intercambia este espacio de color con other. Esta operación es muy rápida y nunca falla.

[noexcept] QColorSpace::TransferFunction QColorSpace::transferFunction() const

Devuelve la función de transferencia predefinida del espacio de color o « TransferFunction::Custom » si no coincide con ninguna de ellas.

Véanse también gamma(), setTransferFunction() y withTransferFunction().

[noexcept, since 6.8] QColorSpace::TransformModel QColorSpace::transformModel() const

Devuelve el modelo de procesamiento de transformaciones utilizado para este espacio de color.

Esta función se introdujo en Qt 6.8.

QColorTransform QColorSpace::transformationToColorSpace(const QColorSpace &colorspace) const

Genera y devuelve una transformación de espacio de color desde este espacio de color a colorspace.

[since 6.8] QPointF QColorSpace::whitePoint() const

Devuelve el punto blanco utilizado para este espacio de color. Si no está definido, devuelve un valor nulo QPointF.

Esta función se introdujo en Qt 6.8.

Véase también setWhitePoint().

[since 6.1] QColorSpace QColorSpace::withTransferFunction(const QList<uint16_t> &transferFunctionTable) const

Devuelve una copia de este espacio de color, pero utilizando la función de transferencia descrita en transferFunctionTable.

Esta función se introdujo en Qt 6.1.

Véase también transferFunction() y setTransferFunction().

QColorSpace QColorSpace::withTransferFunction(QColorSpace::TransferFunction transferFunction, float gamma = 0.0f) const

Devuelve una copia de este espacio de color, pero utilizando las funciones de transferencia transferFunction y gamma.

Véase también transferFunction(), gamma() y setTransferFunction().

[since 6.1] QColorSpace QColorSpace::withTransferFunctions(const QList<uint16_t> &redTransferFunctionTable, const QList<uint16_t> &greenTransferFunctionTable, const QList<uint16_t> &blueTransferFunctionTable) const

Devuelve una copia de este espacio de color, pero utilizando las funciones de transferencia descritas en redTransferFunctionTable, greenTransferFunctionTable y blueTransferFunctionTable.

Esta función se introdujo en Qt 6.1.

Véase también setTransferFunctions().

QColorSpace::operator QVariant() const

Devuelve el espacio de color como un objeto de tipo ` QVariant`.

Elementos no miembros relacionados

bool operator!=(const QColorSpace &colorSpace1, const QColorSpace &colorSpace2)

Devuelve « true » si el espacio de color colorSpace1 no es igual al espacio de color colorSpace2; en caso contrario, devuelve false

QDataStream &operator<<(QDataStream &stream, const QColorSpace &colorSpace)

Escribe el archivo colorSpace en el archivo stream como un perfil ICC.

Véase también QColorSpace::iccProfile() y Serialización de tipos de datos de Qt.

bool operator==(const QColorSpace &colorSpace1, const QColorSpace &colorSpace2)

Devuelve « true » si el espacio de color colorSpace1 es igual al espacio de color colorSpace2; en caso contrario, devuelve false

QDataStream &operator>>(QDataStream &stream, QColorSpace &colorSpace)

Lee un espacio de color desde el archivo « stream » indicado y lo almacena en el archivo « colorSpace » indicado.

Véase también QColorSpace::fromIccProfile() y Serialización de tipos de datos de Qt.

© 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.