ID2D1CommandSink1::SetPrimitiveBlend1-Methode (d2d1_2.h)
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 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 |