Класс QPixelFormat

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

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

Типы public

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

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

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

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

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

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

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

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

См. также TypeInterpretation.

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

enum QPixelFormat::AlphaPosition

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

enum QPixelFormat::AlphaPremultiplied

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

enum QPixelFormat::AlphaUsage

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

enum QPixelFormat::ByteOrder

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

enum QPixelFormat::ColorModel

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

enum QPixelFormat::TypeInterpretation

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

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

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

enum 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 использует макропиксели. Вместо этого макет пикселей хранится как перечисление.