Класс QColorSpace

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

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

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

Функции публичного доступа

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

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

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

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

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

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

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

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

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

enum QColorSpace::NamedColorSpace

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

enum class QColorSpace::Primaries

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

enum class QColorSpace::TransferFunction

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

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

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

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

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

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

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

Создаёт пользовательское цветовое пространство с первичными цветами primaries, используя функцию перевода transferFunction и необязательно 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().

См. также 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().

[since 5.15] QVariant QColorSpace::operator QVariant() const

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

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