Класс 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().

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