ID2D1CommandSink1::SetPrimitiveBlend1-Methode

Legt einen neuen primitiven Mischmodus fest.

Syntax

HRESULT SetPrimitiveBlend1(
   D2D1_PRIMITIVE_BLEND primitiveBlend
);

Parameter

primitiveBlend

Typ: D2D1_PRIMITIVE_BLEND

Die primitive Mischung, die auf nachfolgende Grundtypen angewendet wird.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Füllmethoden

Beim Aliasrendering (mit Ausnahme des MIN-Modus) wird der Ausgabewert O berechnet, indem die Wertmischung (S, D) linear mit dem Zielpixelwert interpoliert wird, basierend auf der Menge, die der Grundtyp das Zielpixel abdeckt.

In der folgenden Tabelle werden die primitiven Mischmodi für Aliase und Antialiased-Blending angezeigt. Die in der Tabelle aufgeführten Formeln verwenden die folgenden Elemente:

• O = Ausgabe
• S = Quelle
• SA = Quell alpha
• D = Ziel
• DA = Ziel alpha
• C = Pixelabdeckung

Primitiver Mischmodus	Alias-Überblendung	Antialiased-Mischung	Beschreibung
D2D1_PRIMITIVE_BLEND_SOURCE_OVER	O = (S + (1 SA) * D) * C + D * (1 C)	O = S * C + D *(1 SA *C)	Der Standard-Überblendmodus für Quell-über-Ziel.The standard source-over-destination blend mode.
D2D1_PRIMITIVE_BLEND_COPY	O = S * C + D * (1 C)	O = S * C + D * (1 C)	Die Quelle wird in das Ziel kopiert. die Zielpixel werden ignoriert.
D2D1_PRIMITIVE_BLEND_MIN	O = Min(S + 1-SA, D)	O = Min(S * C + 1 SA *C, D)	Die resultierenden Pixelwerte verwenden das Minimum der Quell- und Zielpixelwerte. Verfügbar in Windows 8 und höher.
D2D1_PRIMITIVE_BLEND_ADD	O = (S + D) * C + D * (1 C)	O = S * C + D	Die resultierenden Pixelwerte sind die Summe der Quell- und Zielpixelwerte. Verfügbar in Windows 8 und höher.

Abbildung der primitiven Mischmodi mit unterschiedlicher Deckkraft und unterschiedlichen Hintergründen.

Die primitive Mischung gilt für alle im Kontext gezeichneten Grundtypen, es sei denn, dies wird mit dem compositeMode-Parameter in der DrawImage-API überschrieben.

Die Grundtypmischung gilt für das Innere aller Grundtypen, die im Kontext gezeichnet werden. Im Fall von DrawImage wird dies durch das Bildrechteck, den Offset und die Welttransformation impliziert.

Wenn die primitive Mischung ein anderes als D2D1_PRIMITIVE_BLEND_OVER ist, wird das ClearType-Rendering deaktiviert. Wenn die Anwendung das ClearType-Rendering in diesen Modi explizit erzwingt, wird der Zeichnungskontext in einen Fehlerzustand versetzt. D2DERR_WRONG_STATE wird entweder von EndDraw oder Flush zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 R2 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Telefon)	Windows Phone 8.1 [Windows Phone Silverlight 8.1- und Windows-Runtime-Apps]

Siehe auch

ID2D1CommandSink1