Класс QColorSpace

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

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

Открытые типы

Открытые функции

Статические открытые члены

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[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)

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

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

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

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

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

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.

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

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

Таблица должна содержать как минимум 2 значения и содержать монотонно возрастающий список значений от 0 до 65535.

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

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 поддерживает только RGB-XYZ ICC профили, основанные на матрице с тремя компонентами.

Если 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().

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

Устанавливает функцию передачи transferFunctionTable.

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

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

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

Устанавливает функции передачи redTransferFunctionTable, greenTransferFunctionTable и blueTransferFunctionTable.

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

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

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 6.1] QColorSpace QColorSpace::withTransferFunction(const QList<uint16_t> &transferFunctionTable) const

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

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

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

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

Возвращает копию этого цветового пространства, за исключением использования функций передачи, описанных в redTransferFunctionTable, greenTransferFunctionTable и blueTransferFunctionTable.

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

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

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

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

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