Класс QPixelFormat

QPixelFormat — это класс для описания различных компоновок пикселей в графических буферах Подробнее...

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

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

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

Связанные внешние функции

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

QPixelFormat — это класс для описания различных компоновок пикселей в графических буферах

В Qt часто возникает необходимость представлять компоновку пикселей в графическом буфере. Внутренне QPixelFormat хранит все в 64-битной структуре данных. Это обеспечивает производительность, но также накладывает некоторые ограничения.

QPixelFormat может описывать 5 цветовых каналов и 1 альфа-канал, каждый из которых может использовать 6 бит для описания размера цветового канала.

Положение альфа-канала описывается отдельным перечислением. Это позволяет описывать форматы QImage, такие как ARGB32, а также типичные форматы OpenGL, такие как RBGA8888.

Способ чтения пикселей определяется перечислением TypeInterpretation. Оно описывает, следует ли читать значения цвета побайтово или же пиксель следует читать как целое число, а затем применять маску.

Нет поддержки описания макропикселей YUV. Вместо этого был создан список форматов YUV. Когда QPixelFormat описывает формат YUV, значение bitsPerPixel выводится из перечисления YUV Layout. Кроме того, все цветовые каналы должны быть установлены в ноль, за исключением пятого цветового канала, который должен хранить значение bitsPerPixel.

См. также TypeInterpretation.

Описание типов членов

enum QPixelFormat::AlphaPosition

Этот тип перечисления используется для описания расположения альфа-канала относительно каналов цвета.

enum QPixelFormat::AlphaPremultiplied

Этот тип перечисления описывает булево состояние, умножается ли альфа-канал на каналы цвета или нет.

enum QPixelFormat::AlphaUsage

Это перечисление описывает, используется ли альфа-канал или нет. Иногда пиксельный формат имеет размер для альфа-канала, но сам формат на самом деле не использует альфа-канал. Например, формат RGB32 — это такой формат. Канал RGB имеет по 8 бит каждый, и нет альфа-канала. Но полный размер каждого пикселя составляет 32. Поэтому размер альфа-канала равен 8, но сам альфа-канал игнорируется. Важно отметить, что в таких ситуациях важно расположение альфа-канала.

enum QPixelFormat::ByteOrder

Это перечисление описывает порядок байтов пиксельного формата. Это перечисление в основном игнорируется, но имеет некоторые применения для форматов YUV. Форматы BGR имеют собственную модель цвета и не должны описываться с помощью обратного порядка байтов формата RGB.

enum QPixelFormat::ColorModel

Этот тип перечисления используется для описания модели цвета пиксельного формата. Альфа был добавлен в версии 5.5.

enum QPixelFormat::TypeInterpretation

Это перечисление описывает, как интерпретируется каждый пиксель. Если пиксель читается как целое 32-битное беззнаковое число, а затем каждый канал маскируется, или если каждый байт читается как значения беззнакового char. Обычно форматы QImage интерпретируют один пиксель как беззнаковое целое число, а затем каналы цвета маскируются. OpenGL, с другой стороны, обычно интерпретирует пиксели «по одному байту», т. е. беззнаковые байты.

QImage также имеет формат Format_RGBA8888 (и его производные), где пиксели интерпретируются как беззнаковые байты. OpenGL имеет расширения, которые позволяют загружать буферы пикселей в формате беззнакового целого числа.

На рисунке показан пиксель ARGB в памяти, читаемый как беззнаковое целое число. Однако, если этот пиксель читался бы байт за байтом в системе little endian, первый байт содержал бы байт с каналом B. Следующий байт — канал G, затем R и, наконец, A. Это показывает, что в системах little endian то, как интерпретируется каждый пиксель, важно для целочисленных форматов. В системах big endian это не так.

enum QPixelFormat::YUVLayout

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

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

QPixelFormat::QPixelFormat()

Создает нулевой пиксельный формат. Этот формат отображается на QImage::Format_Invalid.

QPixelFormat::QPixelFormat(ColorModel colorModel, uchar firstSize, uchar secondSize, uchar thirdSize, uchar fourthSize, uchar fifthSize, uchar alphaSize, AlphaUsage alphaUsage, AlphaPosition alphaPosition, AlphaPremultiplied premultiplied, TypeInterpretation typeInterpretation, ByteOrder byteOrder = CurrentSystemEndian, uchar subEnum = 0)

Создаёт QPixelFormat, который назначает свои данные атрибутам. colorModel будет помещён в буфер длиной 4 бита.

firstSize, secondSize, thirdSize, fourthSize, fifthSize и alphaSize предназначены для представления размера канала. Каналы будут использоваться для различных целей в зависимости от colorModel. Для RGB firstSize будет представлять красный канал. Для CMYK он будет представлять значение канала голубого цвета.

alphaUsage обозначает, используется ли альфа-канал.

alphaPosition — позиция альфа-канала.

premultiplied обозначает, умножается ли альфа-канал на цветовые каналы.

typeInterpretation — способ интерпретации пикселя.

byteOrder представляет порядок байтов пиксельного формата. По умолчанию используется CurrentSystemEndian.

subEnum используется для цветовых моделей, которым необходимо хранить дополнительную информацию с помощью дополнительного перечисления. Используется в YUV для хранения типа YUV. Значение по умолчанию равно 0.

AlphaPosition QPixelFormat::alphaPosition() const

Функция-аксессор для alphaPosition.

uchar QPixelFormat::alphaSize() const

Функция-аксессор для размера альфа-канала.

AlphaUsage QPixelFormat::alphaUsage() const

Функция-аксессор для alphaUsage.

uchar QPixelFormat::bitsPerPixel() const

Функция-аксессор для битов на пиксель. Эта функция возвращает сумму цветовых каналов + размер альфа-канала.

uchar QPixelFormat::blackSize() const

Функция-аксессор для чёрно-ключевого цветового канала.

uchar QPixelFormat::blueSize() const

Функция-аксессор для размера синего цветового канала.

uchar QPixelFormat::brightnessSize() const

Функция-аксессор для размера канала яркости.

ByteOrder QPixelFormat::byteOrder() const

Порядок байтов почти всегда устанавливается в соответствии с порядком байтов текущей системы. Однако он может быть полезен для описания некоторых форматов YUV. Эта функция никогда не должна возвращать QPixelFormat::CurrentSystemEndian, так как это значение преобразуется в значение порядка байтов в конструкторе.

uchar QPixelFormat::channelCount() const

Функция-аксессор для получения channelCount. Количество каналов определяется по цветам с размером > 0 и если размер альфа-канала > 0.

ColorModel QPixelFormat::colorModel() const

Функция-аксессор для получения colorModel.

uchar QPixelFormat::cyanSize() const

Функция-аксессор для канала голубого цвета.

uchar QPixelFormat::greenSize() const

Функция-аксессор для размера зелёного цветового канала.

uchar QPixelFormat::hueSize() const

Функция-аксессор для размера канала оттенка.

uchar QPixelFormat::lightnessSize() const

Функция-аксессор для размера канала светлоты.

uchar QPixelFormat::magentaSize() const

Функция-аксессор для канала пурпурного цвета.

AlphaPremultiplied QPixelFormat::premultiplied() const

Функция-аксессор для перечисления AlphaPremultiplied. Указывает, умножается ли альфа-канал на цветовые каналы.

uchar QPixelFormat::redSize() const

Функция-аксессор для размера красного цветового канала.

uchar QPixelFormat::saturationSize() const

Функция-аксессор для размера канала насыщенности.

TypeInterpretation QPixelFormat::typeInterpretation() const

Функция-аксессор для типа представления цветового канала или пикселя.

См. также TypeInterpretation.

uchar QPixelFormat::yellowSize() const

Функция-аксессор для канала жёлтого цвета.

YUVLayout QPixelFormat::yuvLayout() const

Функция-аксессор для YUVLayout. Сложно описать цветовые каналы формата YUV, так как цветовая модель YUV использует макропиксели. Вместо этого макет пикселей хранится как перечисление.