DrvGradientFill-Funktion (winddi.h)

Die DrvGradientFill-Funktion schattiert die angegebenen Grundtypen.

Syntax

BOOL DrvGradientFill(
  [in, out]      SURFOBJ   *psoDest,
  [in]           CLIPOBJ   *pco,
  [in, optional] XLATEOBJ  *pxlo,
  [in]           TRIVERTEX *pVertex,
  [in]           ULONG     nVertex,
  [in]           PVOID     pMesh,
  [in]           ULONG     nMesh,
  [in]           RECTL     *prclExtents,
  [in]           POINTL    *pptlDitherOrg,
  [in]           ULONG     ulMode
);

Parameter

[in, out] psoDest

Zeiger auf die SURFOBJ-Struktur , die die Oberfläche identifiziert, auf der gezeichnet werden soll.

[in] pco

Zeiger auf eine CLIPOBJ-Struktur . Die CLIPOBJ_Xxx-Dienstroutinen werden bereitgestellt, um den Clipbereich als Eine Reihe von Rechtecken aufzulisten. Diese Enumeration schränkt den Bereich des geänderten Ziels ein. Nach Möglichkeit vereinfacht GDI den Ausschnitt.

[in, optional] pxlo

Zeiger auf eine XLATEOBJ-Struktur . Dieser Parameter sollte vom Treiber ignoriert werden.

[in] pVertex

Zeiger auf ein Array von TRIVERTEX-Strukturen, wobei jeder Eintrag Positions- und Farbinformationen enthält. Die TRIVERTEX-Struktur wird in der Microsoft Windows SDK-Dokumentation beschrieben.

[in] nVertex

Gibt die Anzahl der TRIVERTEX-Strukturen im Array an, auf das pVertex zeigt.

[in] pMesh

Zeiger auf ein Array von Strukturen, die die Konnektivität der TRIVERTEX-Elemente definieren, auf die pVertex zeigt.

Wenn Rechtecke gezeichnet werden, zeigt pMesh auf ein Array von GRADIENT_RECT Strukturen, von denen jedes zwei TRIVERTEX-Elemente angibt, die ein Rechteck definieren. Die TRIVERTEX-Elemente können jedes diagonal entgegengesetzte Paar von rechteckigen Scheitelpunkten darstellen. Das Zeichnen von Rechtecken ist unten rechts exklusiv. Sowohl TRIVERTEX als auch GRADIENT_RECT sind in der Windows SDK-Dokumentation definiert.

Wenn Dreiecke gezeichnet werden, zeigt pMesh auf ein Array von GRADIENT_TRIANGLE Strukturen, von denen jedes die drei TRIVERTEX-Elemente angibt, die ein Dreieck definieren. Dreieckszeichnung ist unten rechts exklusiv. GRADIENT_TRIANGLE ist in der Windows SDK-Dokumentation definiert.

[in] nMesh

Gibt die Anzahl der Elemente im Array an, auf die pMesh zeigt.

[in] prclExtents

Zeiger auf eine RECTL-Struktur , die den Bereich definiert, in dem die Farbverlaufszeichnung erfolgen soll. Die Punkte werden im Koordinatensystem der Zieloberfläche angegeben. Dieser Parameter ist nützlich, um die Größe der Zeichnungsvorgänge zu schätzen.

[in] pptlDitherOrg

Zeiger auf eine POINTL-Struktur , die den Ursprung auf der Oberfläche für dithering definiert. Das obere linke Pixel des Dithermusters wird an diesem Punkt ausgerichtet.

[in] ulMode

Gibt den aktuellen Zeichnungsmodus und die Interpretation des Arrays an, auf das pMesh zeigt. Dieser Parameter kann einer der folgenden Werte sein:

GRADIENT_FILL_RECT_H

Der pMesh-Parameter verweist auf ein Array von GRADIENT_RECT Strukturen. Jedes Rechteck muss von links nach rechts schattiert werden. Insbesondere haben die Pixel oben links und unten links die gleiche Farbe, wie die Pixel oben rechts und unten rechts.

GRADIENT_FILL_RECT_V

Der pMesh-Parameter verweist auf ein Array von GRADIENT_RECT Strukturen. Jedes Rechteck muss von oben nach unten schattiert werden. Insbesondere haben die Pixel oben links und rechts oben die gleiche Farbe, wie die pixeluntere linke und untere rechte Untere Pixel.

GRADIENT_FILL_TRIANGLE

Der pMesh-Parameter verweist auf ein Array von GRADIENT_TRIANGLE Strukturen.

Die Farbverlaufsfüllberechnungen für jeden Modus sind im Abschnitt Hinweise dokumentiert.

Rückgabewert

DrvGradientFill gibt bei Erfolg TRUE zurück. Andernfalls wird FALSE zurückgegeben und durch Aufrufen von EngSetLastError ein Fehler gemeldet.

Hinweise

DrvGradientFill kann optional in Grafiktreibern implementiert werden. GDI ruft diese Funktion nie für palettierte Oberflächen auf.

Der Treiber bindet DrvGradientFill ein, indem er beim Aufrufen von EngAssociateSurface oder EngModifySurface das HOOK_GRADIENTFILL-Flag festlegt. Wenn der Treiber drvGradientFill eingebunden hat und aufgerufen wird, um einen Vorgang auszuführen, den er nicht unterstützt, sollte der Treiber den Vorgang verarbeiten lassen, indem er die Daten in einem Aufruf von EngGradientFill einpsticht.

GDI ruft DrvGradientFill für 8bpp-Zieloberflächen nicht auf.

Die Formeln zum Berechnen des Farbwerts für jedes Pixel des Grundtyps hängen von ulMode wie folgt ab:

Der Gesamtfehler, der über alle drei Farbkanäle akkumuliert wird, darf nicht mehr als acht (8) betragen. Weitere Informationen zu zulässigen Fehlern finden Sie unter Spezialeffekte in Anzeigetreibern.

Der Treiber sollte den Alphawert der Scheitelpunkte ignorieren und den Alphakanal für Oberflächen unverändert lassen, die die Alphamischung unterstützen.

Anforderungen

Weitere Informationen

EngAssociateSurface

EngGradientFill