DrvLineTo-Funktion (winddi.h)

Artikel
08/27/2023

Die DrvLineTo-Funktion zeichnet eine einzelne, einfarbige, nur ganzzahlige kosmetische Linie.

Syntax

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

Parameter

pso

Zeiger auf eine SURFOBJ-Struktur , die die Zu zeichnende Oberfläche beschreibt.

pco

Zeiger auf eine CLIPOBJ-Struktur , die den Clipbereich definiert, in dem das Rendering erfolgen muss. Außerhalb dieses Clipbereichs können keine Pixel betroffen sein.

pbo

Zeiger auf eine BRUSHOBJ-Struktur , die den Pinsel angibt, der beim Zeichnen der Linie verwendet werden soll.

x1

Geben Sie die ganzzahligen x-Koordinaten des Anfangspunkts der Linie an.

y1

Geben Sie die ganzzahligen y-Koordinaten des Anfangspunkts der Linie an.

x2

Geben Sie die ganzzahligen x-Koordinaten des Endpunkts der Linie an.

y2

Geben Sie die ganzzahligen y-Koordinaten des Endpunkts der Linie an.

prclBounds

Zeiger auf die RECTL-Struktur , die das ganzzahlige Rechteck definiert, das die entklammerte Linie umgrenzt. Treiber, die das Zeichnen von Hardwarelinien unterstützen, können dieses Rechteck verwenden, um schnell zu bestimmen, ob die Linie in einen Koordinatenraum passt, der klein genug ist, um von der Hardware gerendert zu werden.

mix

Der Mischmodus, der die Für den Pinsel zu verwendenden Rastervorgänge im Vordergrund und im Hintergrund definiert. Beim Aufruf von DrvLineTo sind die Werte des Vordergrund- und Hintergrundrastervorgangs identisch. Weitere Informationen zum Mischmodus finden Sie unter Hinweise.

Rückgabewert

DrvLineTo gibt TRUE zurück, wenn es erfolgreich ist. Andernfalls wird FALSE zurückgegeben.

Hinweise

DrvLineTo ist ein optionaler Einstiegspunkt, den ein Treiber als Optimierung für Anwendungsaufrufe der Win32 LineTo-Funktion bereitstellen kann. Wenn der Treiber DrvLineTo nicht einhakt oder wenn der Treiber false von einem Aufruf dieser Funktion zurückgibt, ruft GDI stattdessen automatisch DrvStrokePath auf. Ein Treiber, der drvLineTo eingebunden hat, kann EngLineTo aufrufen, wenn die Renderingoberfläche ein DIB ist.

Diese Funktion ist einfacher als DrvStrokePath , da sie nur ganzzahlige Endpunkte und einfarbige kosmetische Linien unterstützt. GDI hat weniger Aufwand beim Aufrufen von DrvLineTo anstelle von DrvStrokePath; DrvLineTo soll daher als einfache Optimierung von Treibern verwendet werden, die die Nominalbreitenlinien in der Hardware beschleunigen können.

Der Mixmodus definiert, wie das eingehende Muster mit den Daten gemischt werden soll, die sich bereits auf der Geräteoberfläche befinden. Der MIX-Datentyp besteht aus zwei ROP2-Werten (Binary Raster Operation), die in eine einzelne ULONG gepackt sind. Das Byte der niedrigsten Ordnung definiert den Rastervorgang im Vordergrund. das nächste Byte definiert den Hintergrundrastervorgang. Weitere Informationen zu Rastervorgangscodes finden Sie in der Microsoft Windows SDK-Dokumentation.