Revision 1 of 2, by Trev on 1-15-2020. The page as it is now.

BGRABitmap Pixel types/ru

Список типов пикселей и функций библиотеки BGRABitmap. Они предоставляются модулем BGRABitmapTypes.

Типы пикселей и функции

PBGRAPixel = ^TBGRAPixel;

</td>

</tr>

</td>

Указатель для прямого доступа к пикселям. Данные хранятся в виде последовательности TBGRAPixel. См. BGRABitmap tutorial 4

</td>

</tr>

</td>

</tr>

TBGRAPixel = packed record blue, green, red, alpha: byte;

</td>

</tr>

</td>

Каждый пиксель представляет собой последовательность из 4 байтов, содержащую синий, зеленый, красный и альфа-канал. Диапазон значений от 0 до 255, цвет в цветовом пространстве sRGB. Альфа-значение: 0 - прозрачно, 255 - непрозрачно. В растровых данных, когда пиксель полностью прозрачен, значения RGB должны быть установлены на ноль.

</td>

</tr>

</td>

</tr>

<tr>

</td>

function BGRA(red, green, blue, alpha: byte): TBGRAPixel; overload; inline;

</td>

</tr>

<tr>

</td>

</td>

Создает пиксель с заданными значениями RGBA

</td>

</tr>

</td>

</tr>

<tr>

</td>

function BGRA(red, green, blue: byte): TBGRAPixel; overload; inline;

</td>

</tr>

<tr>

</td>

</td>

Создает непрозрачный пиксель с заданными значениями RGB

</td>

</tr>

</td>

</tr>

<tr>

</td>

operator = (const c1, c2: TBGRAPixel): boolean; inline;

</td>

</tr>

<tr>

</td>

</td>

Проверяет, равны ли два пикселя. Если они оба прозрачны, значения RGB игнорируются

</td>

</tr>

</td>

</tr>

<tr>

</td>

function GetIntensity(c: TBGRAPixel): word; inline;

</td>

</tr>

<tr>

</td>

</td>

Возвращает интенсивность пикселя. Интенсивность - это максимальное значение, достигаемое любым компонентом

</td>

</tr>

</td>

</tr>

<tr>

</td>

function SetIntensity(c: TBGRAPixel; intensity: word): TBGRAPixel;

</td>

</tr>

<tr>

</td>

</td>

Устанавливает интенсивность пикселя

</td>

</tr>

</td>

</tr>

<tr>

</td>

function GetLightness(c: TBGRAPixel): word;

</td>

</tr>

<tr>

</td>

</td>

Возвращает свечение пикселя. Свечение - это воспринимаемая яркость, 0 - черный, а 65535 - белый.

</td>

</tr>

</td>

</tr>

<tr>

</td>

function SetLightness(c: TBGRAPixel; lightness: word): TBGRAPixel;

</td>

</tr>

<tr>

</td>

</td>

Возвращает свечение пикселя

</td>

</tr>

</td>

</tr>

<tr>

</td>

function ApplyLightnessFast(color: TBGRAPixel; lightness: word): TBGRAPixel; inline;

</td>

</tr>

<tr>

</td>

</td>

Быстро устанавливает свечение, уменьшая в сторону черного, если lightness меньше 32768, и уменьшая в сторону белого, если lightness больше 32768

</td>

</tr>

</td>

</tr>

<tr>

</td>

function ApplyIntensityFast(color: TBGRAPixel; lightness: longword): TBGRAPixel;

</td>

</tr>

<tr>

</td>

</td>

Быстро устанавливает интенсивность, уменьшая в сторону черного, если lightness меньше 32768, и умножая все составляющие, если lightness больше 32768. В случае насыщения, она исчезает в сторону белого

</td>

</tr>

</td>

</tr>

<tr>

</td>

function CombineLightness(lightness1,lightness2: Int32or64): Int32or64;

</td>

</tr>

<tr>

</td>

</td>

Объединяет две яркости вместе. Значение 32768 является нейтральным. Результат может превысить 65535

</td>

</tr>

</td>

</tr>

<tr>

</td>

function BGRAToGrayscale(c: TBGRAPixel): TBGRAPixel;

</td>

</tr>

<tr>

</td>

</td>

Преобразует цвет в оттенки серого

</td>

</tr>

</td>

</tr>

<tr>

</td>

function GrayscaleToBGRA(lightness: word): TBGRAPixel;

</td>

</tr>

<tr>

</td>

</td>

Создает серый цвет с заданной яркостью

</td>

</tr>

</td>

</tr>

<tr>

</td>

function MergeBGRA(c1, c2: TBGRAPixel): TBGRAPixel; overload;

</td>

</tr>

<tr>

</td>

</td>

Слияние двух цветов без гамма-коррекции

</td>

</tr>

</td>

</tr>

<tr>

</td>

function MergeBGRA(c1: TBGRAPixel; weight1: integer; c2: TBGRAPixel; weight2: integer): TBGRAPixel; overload;

</td>

</tr>

<tr>

</td>

</td>

Слияние двух цветов без гамма-коррекции. weight1 и weight2 указывает на вес цветового барицентра

</td>

</tr>

</td>

</tr>

<tr>

</td>

function MergeBGRAWithGammaCorrection(c1: TBGRAPixel; weight1: byte; c2: TBGRAPixel; weight2: byte): TBGRAPixel;

</td>

</tr>

<tr>

</td>

</td>

Слияние двух цветов с гамма-коррекцией. weight1 и weight2 указывает на вес цветового барицентра

</td>

</tr>

</td>

</tr>

<tr>

</td>

function ColorToBGRA(color: TColor): TBGRAPixel; overload;

</td>

</tr>

<tr>

</td>

</td>

Преобразует значение TColor в непрозрачный пиксель

</td>

</tr>

</td>

</tr>

<tr>

</td>

function ColorToBGRA(color: TColor; opacity: byte): TBGRAPixel; overload;

</td>

</tr>

<tr>

</td>

</td>

Преобразует значение TColor в пиксель с заданной непрозрачностью

</td>

</tr>

</td>

</tr>

<tr>

</td>

function BGRAToColor(c: TBGRAPixel): TColor;

</td>

</tr>

<tr>

</td>

</td>

Преобразует пиксель в значение TColor, отбрасывая значение альфа

</td>

</tr>

</td>

</tr>

<tr>

</td>

function FPColorToBGRA(AValue: TFPColor): TBGRAPixel;

</td>

</tr>

<tr>

</td>

</td>

Преобразует значение TFPColor в пиксель. Обратите внимание, что даже если TFPColor имеет 16-битные значения, они не считаются расширенной гаммой

</td>

</tr>

</td>

</tr>

<tr>

</td>

function BGRAToFPColor(AValue: TBGRAPixel): TFPColor; inline;

</td>

</tr>

<tr>

</td>

</td>

Преобразует пиксель в TFPColor

</td>

</tr>

</td>

</tr>

<tr>

</td>

function BGRAWordDiff(c1, c2: TBGRAPixel): word;

</td>

</tr>

<tr>

</td>

</td>

Вычисляет разницу (с гамма-коррекцией) между двумя пикселями с учетом всех размеров, включая прозрачность. Результат варьирует от 0 до 65535

</td>

</tr>

</td>

</tr>

<tr>

</td>

function BGRADiff(c1, c2: TBGRAPixel): byte;

</td>

</tr>

<tr>

</td>

</td>

Вычисляет разницу (с гамма-коррекцией) между двумя пикселями с учетом всех размеров, включая прозрачность. Результат варьирует от 0 до 255

</td>

</tr>

</td>

</tr>

ArrayOfTBGRAPixel = array of TBGRAPixel;

</td>

</tr>

</td>

Массив пикселей

</td>

</tr>

</td>

</tr>

<tr>

</td>

function MergeBGRA(const colors: array of TBGRAPixel): TBGRAPixel; overload;

</td>

</tr>

<tr>

</td>

</td>

Объединяет данные цвета без гамма-коррекции

</td>

</tr>

</td>

</tr>

TExpandedPixel = packed record red, green, blue, alpha: word;

</td>

</tr>

</td>

Хранит гамму расширенного цвета RGB. Диапазон значений от 0 до 65535

</td>

</tr>

</td>

</tr>

<tr>

</td>

function GammaExpansion(c: TBGRAPixel): TExpandedPixel; inline;

</td>

</tr>

<tr>

</td>

</td>

Преобразует пиксель из sRGB в расширенную гамму RGB

</td>

</tr>

</td>

</tr>

<tr>

</td>

function GammaCompression(const ec: TExpandedPixel): TBGRAPixel; inline;

</td>

</tr>

<tr>

</td>

</td>

Преобразует пиксель из гамма-развернутого RGB в sRGB

</td>

</tr>

</td>

</tr>

<tr>

</td>

function GammaCompression(red,green,blue,alpha: word): TBGRAPixel; inline;

</td>

</tr>

<tr>

</td>

</td>

Преобразует пиксель из гамма-развернутого RGB в sRGB

</td>

</tr>

</td>

</tr>

<tr>

</td>

function GetIntensity(const c: TExpandedPixel): word; inline;

</td>

</tr>

<tr>

</td>

</td>

Возвращает интенсивность гамма-расширенного пикселя. Интенсивность - это максимальное значение, достигаемое любым компонентом

</td>

</tr>

</td>

</tr>

<tr>

</td>

function SetIntensity(const c: TExpandedPixel; intensity: word): TExpandedPixel;

</td>

</tr>

<tr>

</td>

</td>

Устанавливает интенсивность гамма-расширенного пикселя

</td>

</tr>

</td>

</tr>

<tr>

</td>

function GetLightness(const c: TExpandedPixel): word; inline;

</td>

</tr>

<tr>

</td>

</td>

Возвращает яркость гамма-расширенного пикселя. lightness - это воспринимаемая яркость, 0 - черный, а 65535 - белый.

</td>

</tr>

</td>

</tr>

<tr>

</td>

function SetLightness(const c: TExpandedPixel; lightness: word): TExpandedPixel;

</td>

</tr>

<tr>

</td>

</td>

Устанавливает яркость гамма-развернутого пикселя

</td>

</tr>

</td>

</tr>

<tr>

</td>

function SetLightness(const c: TExpandedPixel; lightness: word; curLightness: word): TExpandedPixel;

</td>

</tr>

<tr>

</td>

</td>

Устанавливает яркость расширенного гамма-пикселя при условии, что вы уже знаете текущее значение яркости curlightness. Это немного быстрее, чем предыдущая функция

</td>

</tr>

</td>

</tr>

<tr>

</td>

function ColorImportance(ec: TExpandedPixel): word;

</td>

</tr>

<tr>

</td>

</td>

Возвращает важность цвета. Это похоже на насыщенность в цветовом пространстве HSL, за исключением того, что это гамма-коррекция. Значение ноль обозначает черный/серый/белый, а значение 65535 обозначает яркий цвет

</td>

</tr>

</td>

</tr>

<tr>

</td>

function MergeBGRA(ec1, ec2: TExpandedPixel): TExpandedPixel; overload;

</td>

</tr>

<tr>

</td>

</td>

Объединение двух расширенных гамма-пикселей (с учетом коррекции гаммы)

</td>

</tr>

</td>

</tr>

<tr>

</td>

function ExpandedDiff(ec1, ec2: TExpandedPixel): word;

</td>

</tr>

<tr>

</td>

</td>

</td>

</tr>

</td>

</tr>

THSLAPixel = packed record

</td>

</tr>

</td>

Цвет пикселя определяется в цветовом пространстве HSL. Диапазон значений от 0 до 65535

</td>

</tr>

</td>

</tr>

<tr>

</td>

hue: word;

</td>

</tr>

<tr>

</td>

</td>

Оттенок пикселя. Экстремальные значения 0 и 65535 - красные

</td>

</tr>

</td>

</tr>

<tr>

</td>

saturation: word;

</td>

</tr>

<tr>

</td>

</td>

Насыщенность цвета. 0 - серый, а 65535 - самый яркий цвет

</td>

</tr>

</td>

</tr>

<tr>

</td>

lightness: word;

</td>

</tr>

<tr>

</td>

</td>

Яркость цвета. 0 черный, 32768 нормальный, 65535 белый

</td>

</tr>

</td>

</tr>

<tr>

</td>

alpha: word;

</td>

</tr>

<tr>

</td>

</td>

Непрозрачность пикселя. 0 прозрачный и 65535 непрозрачный

</td>

</tr>

</td>

</tr>

<tr>

</td>

function HSLA(hue, saturation, lightness, alpha: word): THSLAPixel; overload; inline;

</td>

</tr>

<tr>

</td>

</td>

Создает пиксель с заданными значениями HSLA, где A обозначает альфа

</td>

</tr>

</td>

</tr>

<tr>

</td>

function HSLA(hue, saturation, lightness: word): THSLAPixel; overload; inline;

</td>

</tr>

<tr>

</td>

</td>

Создает непрозрачный пиксель с заданными значениями HSL

</td>

</tr>

</td>

</tr>

<tr>

</td>

function BGRAToHSLA(c: TBGRAPixel): THSLAPixel;

</td>

</tr>

<tr>

</td>

</td>

Преобразует пиксель из sRGB в цветовое пространство HSL

</td>

</tr>

</td>

</tr>

<tr>

</td>

function ExpandedToHSLA(const ec: TExpandedPixel): THSLAPixel;

</td>

</tr>

<tr>

</td>

</td>

Преобразует пиксель из гамма-развернутого RGB в цветовое пространство HSL

</td>

</tr>

</td>

</tr>

<tr>

</td>

function HSLAToExpanded(const c: THSLAPixel): TExpandedPixel;

</td>

</tr>

<tr>

</td>

</td>

Преобразует пиксель из гамма-развернутого RGB в цветовое пространство HSL

</td>

</tr>

</td>

</tr>

<tr>

</td>

function HSLAToBGRA(const c: THSLAPixel): TBGRAPixel;

</td>

</tr>

<tr>

</td>

</td>

Преобразует пиксель из цветового пространства HSL в sRGB

</td>

</tr>

</td>

</tr>

<tr>

</td>

function HueDiff(h1, h2: word): word;

</td>

</tr>

<tr>

</td>

</td>

Вычисляет разницу оттенков

</td>

</tr>

</td>

</tr>

<tr>

</td>

function GetHue(ec: TExpandedPixel): word;

</td>

</tr>

<tr>

</td>

</td>

Возвращает оттенок расширенного гамма-пикселя

</td>

</tr>

</td>

</tr>

TGSBAPixel = THSLAPixel;

</td>

</tr>

</td>

Цвет пикселя определяется в исправленном цветовом пространстве HSL. G обозначает исправленный оттенок, а B обозначает фактическую яркость. Диапазон значений от 0 до 65535

</td>

</tr>

</td>

</tr>

<tr>

</td>

function BGRAToGSBA(c: TBGRAPixel): TGSBAPixel;

</td>

</tr>

<tr>

</td>

</td>

Преобразует пиксель из sRGB в корректное цветовое пространство HSL

</td>

</tr>

</td>

</tr>

<tr>

</td>

function ExpandedToGSBA(ec: TExpandedPixel): TGSBAPixel;

</td>

</tr>

<tr>

</td>

</td>

Преобразует пиксель из гамма-развернутого RGB в корректное цветовое пространство HSL

</td>

</tr>

</td>

</tr>

<tr>

</td>

function GtoH(ghue: word): word;

</td>

</tr>

<tr>

</td>

</td>

Преобразует оттенок G (GSBA) в оттенок H (HSLA)

</td>

</tr>

</td>

</tr>

<tr>

</td>

function HtoG(hue: word): word;

</td>

</tr>

<tr>

</td>

</td>

Преобразует оттенок H (HSLA) в оттенок G (GSBA)

</td>

</tr>

</td>

</tr>

<tr>

</td>

function GSBAToBGRA(c: TGSBAPixel): TBGRAPixel;

</td>

</tr>

<tr>

</td>

</td>

Преобразует пиксель из исправленного HSL в sRGB

</td>

</tr>

</td>

</tr>

<tr>

</td>

function GSBAToExpanded(c: TGSBAPixel): TExpandedPixel;

</td>

</tr>

<tr>

</td>

</td>

Преобразует пиксель из корректного HSL в расширенный гамма RGB

</td>

</tr>

</td>

</tr>

<tr>

</td>

function GSBAToHSLA(c: TGSBAPixel): THSLAPixel;

</td>

</tr>

<tr>

</td>

</td>

Преобразует пиксель из корректного HSL в обычный HSL

</td>

</tr>

</td>

</tr>

TColorF = packed array[1..4] of single;

</td>

</tr>

</td>

Цветовая переменная общего назначения со значениями с плавающей точкой одинарной точности

</td>

</tr>

</td>

</tr>

<tr>

</td>

function ColorF(red,green,blue,alpha: single): TColorF;

</td>

</tr>

<tr>

</td>

</td>

Создает структуру TColorF

</td>

</tr>

</td>

</tr>

<tr>

</td>

operator - (const c1, c2: TColorF): TColorF; inline;

</td>

</tr>

<tr>

</td>

</td>

Вычитает каждый компонент отдельно

</td>

</tr>

</td>

</tr>

<tr>

</td>

operator + (const c1, c2: TColorF): TColorF; inline;

</td>

</tr>

<tr>

</td>

</td>

Добавляет каждый компонент отдельно

</td>

</tr>

</td>

</tr>

<tr>

</td>

operator * (const c1, c2: TColorF): TColorF; inline;

</td>

</tr>

<tr>

</td>

</td>

Умножает каждый компонент отдельно

</td>

</tr>

</td>

</tr>

<tr>

</td>

operator * (const c1: TColorF; factor: single): TColorF; inline;

</td>

</tr>

<tr>

</td>

</td>

Умножает каждый компонент на factor

</td>

</tr>

</td>

</tr>

TDrawMode = (

</td>

</tr>

</td>

Возможные режимы при рисовании пикселя поверх другого

</td>

</tr>

</td>

</tr>

<tr>

</td>

dmSet,

</td>

</tr>

<tr>

</td>

</td>

Пиксель заменяется

</td>

</tr>

</td>

</tr>

<tr>

</td>

dmSetExceptTransparent,

</td>

</tr>

<tr>

</td>

</td>

Пиксель заменяется, если пиксель имеет значение альфа 255

</td>

</tr>

</td>

</tr>

<tr>

</td>

dmLinearBlend,

</td>

</tr>

<tr>

</td>

</td>

Пиксель смешивается с другим в соответствии с альфа-значениями, однако гамма-коррекция не применяется. Другими словами, цветовое пространство предполагается линейным

</td>

</tr>

</td>

</tr>

<tr>

</td>

dmDrawWithTransparency,

</td>

</tr>

<tr>

</td>

</td>

Пиксель смешивается с другим в соответствии с альфа-значениями, и применяется гамма-коррекция. Другими словами, цветовое пространство предполагается sRGB

</td>

</tr>

</td>

</tr>

<tr>

</td>

dmXor);

</td>

</tr>

<tr>

</td>

</td>

Значения всех каналов объединяются [посредством] Xor. Это полезно для вычисления двоичной разницы, однако не имеет смысла отображать на экране

</td>

</tr>

</td>

</tr>

<tr>

</td>

dmFastBlend = dmLinearBlend;

</td>

</tr>

<tr>

</td>

</td>

Псевдоним для линейного наложения, потому что он быстрее, чем наложение с гамма-коррекцией

</td>

</tr>

</td>

</tr>

TBlendOperation = (

</td>

</tr>

</td>

Расширенные режимы наложения. См. Paint.NET blend modes и Formulas. Смешивание слоев имеет два этапа. Первый - применяются операции смешивания, перечисленные ниже, а второй - фактическое слияние цветов.

</td>

</tr>

</td>

</tr>

<tr>

</td>

boLinearBlend,

</td>

</tr>

<tr>

</td>

</td>

Простое смешивание, за исключением того, что оно вызывает линейное объединение, поэтому оно эквивалентно dmLinearBlend

</td>

</tr>

</td>

</tr>

<tr>

</td>

boTransparent,

</td>

</tr>

<tr>

</td>

</td>

Простое смешивание. Оно эквивалентно dmLinearBlend или dmDrawWithTransparency

</td>

</tr>

</td>

</tr>

<tr>

</td>

boLighten, boScreen, boAdditive, boLinearAdd, boColorDodge, boDivide, boNiceGlow, boSoftLight, boHardLight,

</td>

</tr>

<tr>

</td>

</td>

Режимы смешивания яркости (имеют тенденцию увеличивать свечение)

</td>

</tr>

</td>

</tr>

<tr>

</td>

boGlow, boReflect, boOverlay, boDarkOverlay, boDarken, boMultiply, boColorBurn,

</td>

</tr>

<tr>

</td>

</td>

Маскировка режимов наложения (имеет тенденцию уменьшать свечение)

</td>

</tr>

</td>

</tr>

<tr>

</td>

boDifference, boLinearDifference, boExclusion, boLinearExclusion, boSubtract, boLinearSubtract, boSubtractInverse, boLinearSubtractInverse,

</td>

</tr>

<tr>

</td>

</td>

Режимы смешивания различий

</td>

</tr>

</td>

</tr>

<tr>

</td>

boNegation, boLinearNegation,

</td>

</tr>

<tr>

</td>

</td>

Режимы наложения негатива

</td>

</tr>

</td>

</tr>

<tr>

</td>

boXor);

</td>

</tr>

<tr>

</td>

</td>

Режим смешивания Xor. Он немного отличается от dm Xor, поскольку альфа-значение используется, как и в других режимах наложения.

</td>

</tr>

</td>

</tr>

<tr>

</td>

boGlowMask = boGlow;

</td>

</tr>

<tr>

</td>

</td>

Псевдоним свечения, который выражает, что этот режим смешивания маскирует часть, где верхний слой черный

</td>

</tr>

</td>

</tr>

<tr>

</td>

boLinearMultiply = boMultiply;

</td>

</tr>

<tr>

</td>

</td>

Псевдоним, потому что линейные или нелинейные режимы умножения идентичны

</td>

</tr>

</td>

</tr>

<tr>

</td>

boNonLinearOverlay = boDarkOverlay;

</td>

</tr>

<tr>

</td>

</td>

Псевдоним, чтобы выразить это темное наложение - это просто наложение с гамма-коррекцией

</td>

</tr>

</td>

</tr>

<tr>

</td>

BlendOperationStr : array[TBlendOperation] of string

</td>

</tr>

<tr>

</td>

</td>

Строковые константы для режимов наложения

</td>

</tr>

</td>

</tr>

<tr>

</td>

function StrToBlendOperation(str: string): TBlendOperation;

</td>

</tr>

<tr>

</td>

</td>

Возвращает режим наложения, выраженный строкой

</td>

</tr>

</td>

</tr>

TChannel = (cRed, cGreen, cBlue, cAlpha);

</td>

</tr>

</td>

Возможные каналы в растровом изображении с использованием любого цветового пространства RGBA

</td>

</tr>

</td>

</tr>

<tr>

</td>

TChannels = set of TChannel;

</td>

</tr>

<tr>

</td>

</td>

Сочетание каналов

</td>

</tr>

</td>

</tr>

TAlphaChannelPaletteOption = (

</td>

</tr>

</td>

Определяет, как палитра обрабатывает альфа-канал

</td>

</tr>

</td>

</tr>

<tr>

</td>

acIgnore,

</td>

</tr>

<tr>

</td>

</td>

Альфа-канал игнорируется. Считается, что альфа-канал хранится в другом месте.

</td>

</tr>

</td>

</tr>

<tr>

</td>

acTransparentEntry,

</td>

</tr>

<tr>

</td>

</td>

Одна точка входа выделяется полностью прозрачным цветом

</td>

</tr>

</td>

</tr>

<tr>

</td>

acFullChannelInPalette);

</td>

</tr>

<tr>

</td>

</td>

Альфа-канал полностью встроен в палитру, поэтому цвет определяется четырьмя каналами RGBA.

</td>

</tr>

</td>

</tr>

TDitheringAlgorithm = (

</td>

</tr>

</td>

Алгоритмы сглаживания, которые определяют, как обрабатывать цвета, которые не найдены в палитре

</td>

</tr>

</td>

</tr>

<tr>

</td>

daNearestNeighbor,

</td>

</tr>

<tr>

</td>

</td>

Ближайший цвет должен использоваться вместо

</td>

</tr>

</td>

</tr>

<tr>

</td>

daFloydSteinberg);

</td>

</tr>

<tr>

</td>

</td>

Можно использовать ближайший цвет, но можно использовать и другой цвет для компенсации ошибки, следуя алгоритму Флойда-Стейнберга

</td>

</tr>

</td>

</tr>

</table>

From the Free Pascal wiki, page "BGRABitmap Pixel types/ru", as it stood on 2020-01-15 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's Licensing page. If you have concerns about this material, message the admin.