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

Статья
08/27/2023

Функция DrvLineTo рисует одну сплошную, целочисленную косметическую линию.

Синтаксис

BOOL DrvLineTo(
  SURFOBJ  *pso,
  CLIPOBJ  *pco,
  BRUSHOBJ *pbo,
  LONG     x1,
  LONG     y1,
  LONG     x2,
  LONG     y2,
  RECTL    *prclBounds,
  MIX      mix
);

Параметры

pso

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

pco

Указатель на структуру CLIPOBJ , которая определяет область клипа, в которой должна выполняться отрисовка. Никакие пиксели не могут быть затронуты за пределами этой области клипа.

pbo

Указатель на структуру BRUSHOBJ , указывающую кисть, используемую при рисовании линии.

x1

Укажите целочисленные координаты X начальной точки линии.

y1

Укажите целочисленные координаты Y начальной точки линии.

x2

Укажите целочисленные координаты X конечной точки линии.

y2

Укажите целочисленные координаты Y конечной точки линии.

prclBounds

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

mix

Смешанный режим, определяющий операции переднего плана и фоновых растровых операций, используемых для кисти. В вызове DrvLineTo значения переднего плана и фоновой растровой операции совпадают. Дополнительные сведения о смешанном режиме см. в разделе Примечания.

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

DrvLineTo возвращает значение TRUE в случае успешного выполнения. В противном случае возвращается значение FALSE.

DrvLineTo — это необязательная точка входа, которую драйвер может предоставить в качестве оптимизации для вызовов приложений функции Win32 LineTo . Если драйвер не подключаетСя к DrvLineTo или драйвер возвращает значение FALSE из вызова этой функции, GDI автоматически вызывает DrvStrokePath . Драйвер, который подключил DrvLineTo , может вызывать EngLineTo , если поверхность отрисовки является DIB.

Эта функция проще , чем DrvStrokePath , так как поддерживает только целочисленные конечные точки и сплошные косметические линии. GDI имеет меньшие издержки при вызове DrvLineTo вместо DrvStrokePath; Следовательно, DrvLineTo предназначен для простой оптимизации драйверами, которые могут ускорить линии номинальной ширины в оборудовании.

Смешанный режим определяет, как входящий шаблон следует смешивать с данными, которые уже находятся на поверхности устройства. Тип данных MIX состоит из двух значений двоичной растровой операции (ROP2), упакованных в один ULONG. Байт наименьшего порядка определяет растровую операцию переднего плана; следующий байт определяет фоновую операцию растра. Дополнительные сведения о кодах растровых операций см. в документации по Microsoft Windows SDK.