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