ID2D1CommandSink1::SetPrimitiveBlend1-Methode (d2d1_2.h)

  • Artikel

Legt einen neuen primitiven Mischmodus fest.

Syntax

HRESULT SetPrimitiveBlend1(
  D2D1_PRIMITIVE_BLEND primitiveBlend
);

Parameter

primitiveBlend

Typ: D2D1_PRIMITIVE_BLEND

Die primitive Mischung, die für nachfolgende Primitive gilt.

Rückgabewert

Typ: HRESULT

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

Hinweise

Mischmodi

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

Die tabelle hier zeigt die primitiven Mischmodi für alias- und antialiased blending. 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 Aliasmischung 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 Standardmäßige Quell-über-Ziel-Mischmodus.
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.
  Eine Abbildung der primitiven Direct2D-Mischmodi mit unterschiedlicher Deckkraft und unterschiedlichen Hintergründen. Eine Abbildung der primitiven Mischmodi mit unterschiedlicher Deckkraft und unterschiedlichen Hintergründen.

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

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

Wenn die primitive Mischung etwas 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 werden 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]
Zielplattform Windows
Kopfzeile d2d1_2.h

Weitere Informationen

ID2D1CommandSink1