Класс QPixelFormat

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

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

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

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

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

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

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

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

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

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

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

См. также TypeInterpretation.

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

перечисление QPixelFormat::AlphaPosition

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

перечисление QPixelFormat::AlphaPremultiplied

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

перечисление QPixelFormat::AlphaUsage

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

перечисление QPixelFormat::ByteOrder

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

перечисление QPixelFormat::ColorModel

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

перечисление QPixelFormat::TypeInterpretation

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

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

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

перечисление QPixelFormat::YUVLayout

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

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

QPixelFormat::QPixelFormat(QPixelFormat::ColorModel colorModel, uchar firstSize, uchar secondSize, uchar thirdSize, uchar fourthSize, uchar fifthSize, uchar alphaSize, QPixelFormat::AlphaUsage alphaUsage, QPixelFormat::AlphaPosition alphaPosition, QPixelFormat::AlphaPremultiplied premultiplied, QPixelFormat::TypeInterpretation typeInterpretation, QPixelFormat::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.

QPixelFormat::QPixelFormat()

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

QPixelFormat::AlphaPosition QPixelFormat::alphaPosition() const

Функция доступа к alphaPosition.

uchar QPixelFormat::alphaSize() const

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

QPixelFormat::AlphaUsage QPixelFormat::alphaUsage() const

Функция доступа к alphaUsage.

uchar QPixelFormat::bitsPerPixel() const

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

uchar QPixelFormat::blackSize() const

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

uchar QPixelFormat::blueSize() const

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

uchar QPixelFormat::brightnessSize() const

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

QPixelFormat::ByteOrder QPixelFormat::byteOrder() const

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

uchar QPixelFormat::channelCount() const

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

QPixelFormat::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

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

QPixelFormat::AlphaPremultiplied QPixelFormat::premultiplied() const

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

uchar QPixelFormat::redSize() const

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

uchar QPixelFormat::saturationSize() const

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

QPixelFormat::TypeInterpretation QPixelFormat::typeInterpretation() const

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

См. такжеTypeInterpretation.

uchar QPixelFormat::yellowSize() const

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

QPixelFormat::YUVLayout QPixelFormat::yuvLayout() const

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