Функция EngStretchBltROP (winddi.h)

Статья
08/27/2023

Функция EngStretchBltROP выполняет растягивающую передачу битовых блоков с помощью ROP.

Синтаксис

ENGAPI BOOL EngStretchBltROP(
       SURFOBJ         *psoDest,
       SURFOBJ         *psoSrc,
       SURFOBJ         *psoMask,
       CLIPOBJ         *pco,
       XLATEOBJ        *pxlo,
       COLORADJUSTMENT *pca,
       POINTL          *pptlHTOrg,
  [in] RECTL           *prclDest,
  [in] RECTL           *prclSrc,
       POINTL          *pptlMask,
  [in] ULONG           iMode,
       BRUSHOBJ        *pbo,
  [in] DWORD           rop4
);

Параметры

psoDest

Указатель на структуру SURFOBJ , описывающую поверхность, на которой выполняется рисование.

psoSrc

Указатель на структуру SURFOBJ, которая описывает исходную поверхность для передачи битового блока.

psoMask

Указатель на структуру SURFOBJ, которая определяет маску для исходной поверхности. Маска определяется схемой логики, которая представляет собой точечный рисунок с 1 битом на пиксель. Как правило, маска ограничивает область, которая должна быть изменена в области назначения. Эта маска всегда должна иметь тот же размер, что и исходная поверхность.

pco

Указатель на структуру CLIPOBJ , ограничивающую область, которая должна быть изменена в назначении. Подпрограммы службы CLIPOBJ_Xxx предоставляются для перечисления области клипа в виде набора прямоугольников.

По возможности GDI упрощает обрезку. Однако, в отличие от EngBitBlt, EngStretchBltROP можно вызывать с помощью одного прямоугольника обрезки. Это предотвращает ошибки округления при обрезке выходных данных.

pxlo

Указатель на структуру XLATEOBJ , указывающую способ преобразования цветовых индексов между исходной и целевой поверхностями.

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

pca

Указатель на структуру COLORADJUSTMENT, которая определяет значения настройки цвета, применяемые к исходному растровом рисунку перед растяжением битов. Дополнительные сведения см. в документации по Windows SDK.

pptlHTOrg

Указатель на структуру POINTL , которая определяет источник полутоновой кисти на целевой поверхности. При использовании полутоновых кистей GDI выравнивает верхний левый пиксель узора кисти на этом этапе и повторяет кисть в соответствии с ее размерами. GDI игнорирует этот параметр, если для параметра rop4 не требуется шаблон.

[in] prclDest

Указатель на структуру RECTL , которая определяет изменяемую прямоугольную область. Этот прямоугольник задается в системе координат поверхности назначения и определяется двумя точками: верхней левой и нижней правой. Две точки, определяющие прямоугольник, не всегда хорошо упорядочены, а это означает, что координаты второй точки не обязательно больше координат первой точки. Если прямоугольник назначения не упорядочен, GDI делает это так.

Прямоугольник является исключающим в правом нижнем углу; то есть его нижний и правый края не являются частью копии.

EngStretchBltROP никогда не должен вызываться с пустым прямоугольником назначения.

[in] prclSrc

Указатель на структуру RECTL, которая определяет копируемые области. Этот прямоугольник задается в системе координат исходной поверхности и определяется двумя точками: верхней левой и нижней правой. Две точки, определяющие прямоугольник, всегда хорошо упорядочены.

Этот прямоугольник сопоставляется с прямоугольником, на который указывает prclDest .

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

pptlMask

Указатель на структуру POINTL, определяющую пиксель в маске, на которую указывает prclMask . Этот пиксель соответствует верхнему левому пикселю в исходном прямоугольнике, на который указывает prclSrc . Этот параметр игнорируется, если маска не указана; то есть GDI игнорирует pptlMask , если prclMask имеет значение NULL.

[in] iMode

Указывает, как объединяются исходные пиксели для получения выходных пикселей. Режим HALFTONE медленнее, чем в других режимах, но создает изображения более высокого качества. Этот параметр может иметь одно из следующих значений:

Значение	Значение
BLACKONWHITE	При сжимающейся передаче битовых блоков GDI объединяет пиксели с операцией BOOLEAN AND. При растянутой передаче битового блока пиксели реплицируются.
COLORONCOLOR	При сжатии битового блока GDI игнорирует достаточно пикселей, поэтому их не нужно объединять. При растянутой передаче битового блока пиксели реплицируются.
ПОЛУТОНАХ	GDI использует группы пикселей на выходной поверхности для оптимального приближения к цвету или серого уровня входных данных.
WHITEONBLACK	При сжатой передаче битового блока пиксели должны объединяться с логической операцией OR. При растягивая передача битового блока пиксели должны быть реплицированы.

pbo

Указатель на структуру BRUSHOBJ , используемую для определения шаблона для передачи битовых блоков. Подпрограмма службы BRUSHOBJ_pvGetRbrush GDI извлекает реализацию кисти устройства. GDI игнорирует этот параметр, если для параметра rop4 не требуется шаблон.

[in] rop4

Представляет растровую операцию, которая определяет, как маски, шаблона, исходного и целевого пикселей объединяются для записи выходного пикселя на целевую поверхность.

Это кватернарная растровая операция, которая является естественным продолжением обычной тернарной операции Rop3. Rop4 имеет 16 соответствующих битов, которые аналогичны 8 определяющим битам Rop3. (Другие избыточные биты Rop3 игнорируются.) Самый простой способ реализации Rop4 — рассмотреть 2 байта отдельно. Нижний байт указывает Rop3, который должен вычисляться везде, где маска, на которую указывает psoMask , равно 1. Высокий байт указывает Rop3, который можно вычислить и применить, где маска равна нулю.

Возвращаемое значение

EngStretchBltROP возвращает значение TRUE при успешном выполнении. В противном случае он сообщает об ошибке и возвращает значение FALSE.

Сопоставление определяется prclSrc и prclDest. Точки, указанные в prclDest и prclSrc , лежат на целочисленных координатах, соответствующих пиксельным центрам. Прямоугольник, определенный двумя такими точками, считается геометрическим прямоугольником с двумя вершинами, координатами которых являются заданные точки, но с 0,5, вычитаемыми из каждой координаты. (Структуры POINTL — это сокращенная нотация для указания этих вершин дробной координаты.)

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
Целевая платформа	Универсальное
Верхняя часть	winddi.h (включая Winddi.h)
Библиотека	Win32k.lib
DLL	Win32k.sys