ID2D1CommandSink1::SetPrimitiveBlend1-Methode

Legt einen neuen primitiven Überblendmodus fest.

Syntax

HRESULT SetPrimitiveBlend1(
   D2D1_PRIMITIVE_BLEND primitiveBlend
);

Parameter

primitiveBlend

Typ: D2D1 _ PRIMITIVE _ BLEND

Die primitive Mischung, die auf nachfolgende Primitive 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

Für das Rendering mit Aliasing (mit Ausnahme des MIN-Modus) wird der Ausgabewert O berechnet, indem der Wert blend(S, D) linear mit dem Zielpixelwert interpoliert wird, basierend auf dem Betrag, den der Primitive das Zielpixel abdeckt.

In der folgenden Tabelle sind die primitiven Überblendungsmodi für Alias- und Antialiasingblending aufgeführt. Die in der Tabelle aufgeführten Gleichungen verwenden die folgenden Elemente:

  • O = Ausgabe
  • S = Quelle
  • SA = Quell alpha
  • D = Ziel
  • DA = Ziel alpha
  • C = Pixelabdeckung
Primitiver Überblendmodus Aliasblending Antialiased Blending BESCHREIBUNG
D2D1 _ PRIMITIVE _ BLEND _ SOURCE _ OVER O = (S + (1 SA) * D) * C + D * (1 C) O = S * C + D * (1 SA * C) Der Standardmischungsmodus von Quelle über Ziel.
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 Direct2d-Überblendungsmodi mit unterschiedlicher Deckkraft und unterschiedlichen Hintergründen.

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

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

Die primitive Mischung gilt für das Innere aller primitiven Typen, die im Kontext gezeichnet werden. Im Fall von DrawImage wirddies durch das Bildrechteck, den Offset und die Welttransformation impliziert.

Wenn die primitive Mischung etwas anderes als D2D1 _ PRIMITIVE _ BLEND _ OVER ist, wird ClearType-Rendering deaktiviert. Wenn die Anwendung explizit das ClearType-Rendering in diesen Modi erzwingt, wird der Zeichnungskontext in einen Fehlerzustand gesetzt. D2DERR _ WRONG STATE wird entweder von _ EndDraw oder Flush zurückgegeben.

Requirements (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]

Weitere Informationen

ID2D1CommandSink1