EngStrokePath-Funktion (winddi.h)

Artikel
08/27/2023

Die EngStrokePath-Funktion fordert an, dass GDI einen angegebenen Pfad strich.

Syntax

ENGAPI BOOL EngStrokePath(
       SURFOBJ   *pso,
       PATHOBJ   *ppo,
       CLIPOBJ   *pco,
       XFORMOBJ  *pxo,
       BRUSHOBJ  *pbo,
       POINTL    *pptlBrushOrg,
  [in] LINEATTRS *plineattrs,
  [in] MIX       mix
);

Parameter

pso

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

ppo

Zeiger auf eine PATHOBJ-Struktur . Die PATHOBJ_Xxx-Dienstroutinen werden bereitgestellt, um die Linien, Bezierkurven und andere Daten aufzulisten, aus denen der Pfad besteht. Dies gibt an, was gezeichnet werden soll.

pco

Zeiger auf eine CLIPOBJ-Struktur . Die CLIPOBJ_Xxx-Dienstroutinen werden bereitgestellt, um den Clipbereich als Eine Reihe von Rechtecken aufzulisten. Optional können alle Zeilen im Pfad durch diesen CLIPOBJ vorgeklammert werden. Dies bedeutet, dass Treiber alle Ihre Linienausschnittberechnungen für sie durchführen lassen können.

pxo

Zeiger auf eine XFORMOBJ-Struktur . Dies ist nur erforderlich, wenn eine geometrische breite Linie gezeichnet werden soll. Es gibt die Transformation an, die Weltkoordinaten in Gerätekoordinaten konvertiert. Dies ist erforderlich, da der Pfad in Gerätekoordinaten angegeben wird, aber eine geometrische breite Linie tatsächlich in Weltkoordinaten erweitert wird.

Der Treiber kann die XFORMOBJ_Xxx-Dienstroutinen verwenden, um die Transformation zu bestimmen.

pbo

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

pptlBrushOrg

Zeiger auf eine POINTL-Struktur , die den Pinselursprung enthält, der zum Ausrichten des Pinselmusters auf dem Gerät verwendet wird.

[in] plineattrs

Zeiger auf eine LINEATTRS-Struktur . Beachten Sie, dass das elStyleState-Element dieser Struktur als Teil dieser Funktion aktualisiert werden muss, wenn die Zeile formatiert ist. Beachten Sie außerdem, dass das ptlLastPel-Element derselben Struktur aktualisiert werden muss, wenn eine kosmetische Linie mit einer Pixelbreite gezeichnet wird.

[in] mix

Gibt an, wie der Pinsel mit dem Ziel kombiniert werden soll.

Rückgabewert

Der Rückgabewert ist TRUE , wenn GDI den Pfad stricht. Wenn der Treiber den Pfad streichen soll, ist der Rückgabewert FALSE, und es wird kein Fehler protokolliert. Wenn bei GDI ein Fehler auftritt, wird der Rückgabewert DDI_ERROR, und ein Fehlercode wird protokolliert.

Hinweise

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, die in eine einzelne ULONG gepackt sind. Das Byte mit niedriger 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.

Anforderungen


Unterstützte Mindestversion (Client)	Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Universell
Header	winddi.h (einschließlich Winddi.h)
Bibliothek	Win32k.lib
DLL	Win32k.sys