Класс QColorSpace

Класс QColorSpace предоставляет абстракцию цветового пространства. Подробнее...

Этот класс был представлен в Qt 5.14.

• Список всех членов, включая унаследованные

Типы публичного доступа

Публичные функции

Статические публичные члены

Связанные нечлены

Подробное описание

Цветовые значения могут интерпретироваться по-разному, и в зависимости от интерпретации могут находиться в разных пространствах. Мы называем это цветовыми пространствами.

QColorSpace предоставляет доступ к созданию нескольких предопределённых цветовых пространств и может генерировать QColorTransforms для преобразования цветов из одного цветового пространства в другое.

QColorSpace также может представлять цветовые пространства, определённые профилями ICC или встроенные в изображения, которые иначе не соответствуют предопределённым цветовым пространствам.

Цветовое пространство, в общем случае, можно рассматривать как комбинацию набора основных цветов и функции передачи. Основные цвета определяют оси цветового пространства, а функция передачи определяет, как значения отображаются на осях. Основные цвета определяются тремя основными цветами, которые точно показывают, как красный, зелёный и синий выглядят в этом конкретном цветовом пространстве, и белым цветом, который показывает, где и насколько ярким является чистый белый цвет. Диапазон цветов, выражаемых основными цветами, называется гаммой, а цветовое пространство, которое может представлять более широкий диапазон цветов, также известно как широкоформатное цветовое пространство.

Функция передачи или гамма-кривая определяет, как каждый компонент в цветовом пространстве кодируется. Они используются потому, что восприятие человеком нелинейно, и функции передачи стремятся обеспечить, чтобы цвета казались равномерно распределёнными для человеческих глаз.

Документация по типам членов

перечисление QColorSpace::NamedColorSpace

Предопределённые цветовые пространства.

перечисление QColorSpace::Primaries

Предопределённые наборы основных цветов.

перечисление QColorSpace::TransferFunction

Предопределённые функции передачи или гамма-кривые.

Документация функций-членов

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

Создаёт пользовательское цветовое пространство с первичными цветами, основанными на цветовых характеристиках основных цветов whitePoint, redPoint, greenPoint и bluePoint, и использующей функцию преобразования fun и необязательно gamma.

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

Создаёт пользовательское цветовое пространство с первичными цветами primaries, используя функцию преобразования гамма gamma.

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

Создаёт пользовательское цветовое пространство с первичными цветами primaries, используя функцию преобразования fun и необязательно gamma.

QColorSpace::QColorSpace(QColorSpace::NamedColorSpace namedColorSpace)

Создаёт новый объект цветового пространства, представляющий namedColorSpace.

QColorSpace::QColorSpace()

Создаёт новый объект цветового пространства, представляющий неопределённое и недействительное цветовое пространство.

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

Создаёт QColorSpace из профиля ICC iccProfile.

Примечание: Не все профили ICC поддерживаются. QColorSpace поддерживает только профили ICC RGB-XYZ, основанные на матрице с тремя компонентами.

Если профиль ICC не поддерживается, возвращается недействительное QColorSpace, где вы по-прежнему можете прочитать исходный профиль ICC с помощью iccProfile().

Примечание: Если данные QByteArray созданы из внешних источников, они должны быть выровнены по крайней мере по 4 байтам.

См. также iccProfile().

float QColorSpace::gamma() const

Возвращает значение гамма для цветовых пространств с TransferFunction::Gamma, приблизительное значение гамма для других предопределённых цветовых пространств или 0.0, если приблизительное значение гамма неизвестно.

См. также transferFunction().

QByteArray QColorSpace::iccProfile() const

Возвращает профиль ICC, представляющий цветовое пространство.

Если цветовое пространство было сгенерировано из профиля ICC, возвращается этот профиль, иначе генерируется новый.

Примечание: Даже недействительные цветовые пространства могут возвращать профиль ICC, если они были сгенерированы из него, чтобы позволить приложениям реализовать более широкую поддержку.

См. также fromIccProfile().

bool QColorSpace::isValid() const

Возвращает true если цветовое пространство является действительным.

QColorSpace::Primaries QColorSpace::primaries() const

Возвращает предопределённые первичные цвета цветового пространства или primaries::Custom если оно не соответствует ни одному из них.

См. также setPrimaries().

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

Устанавливает первичные цвета для набора primariesId.

См. также primaries().

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

Устанавливает первичные цвета для цветовых характеристик whitePoint, redPoint, greenPoint и bluePoint.

См. также primaries().

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

Устанавливает функцию преобразования на transferFunction и gamma.

См. также transferFunction(), gamma() и withTransferFunction().

void QColorSpace::swap(QColorSpace &other)

Меняет цветовое пространство other с этим цветовым пространством. Эта операция очень быстрая и никогда не терпит неудачу.

QColorSpace::TransferFunction QColorSpace::transferFunction() const

Возвращает предопределённую функцию преобразования цветового пространства или TransferFunction::Custom если она не соответствует ни одной из них.

См. также gamma(), setTransferFunction() и withTransferFunction().

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

Генерирует и возвращает преобразование цветового пространства от этого цветового пространства к colorspace.

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

Возвращает копию этого цветового пространства, за исключением использования функции преобразования transferFunction и gamma.

См. также transferFunction(), gamma() и setTransferFunction().

QVariant QColorSpace::operator QVariant() const

Возвращает цветовое пространство в виде QVariant.

Эта функция была введена в Qt 5.15.