ID2D1DeviceContext1::D rawGeometryRealization-Methode (d2d1_2.h)
Rendert eine angegebene Geometrierealisierung für das Ziel mit dem angegebenen Pinsel.
Syntax
void DrawGeometryRealization(
[in] ID2D1GeometryRealization *geometryRealization,
[in] ID2D1Brush *brush
);
Parameter
[in] geometryRealization
Typ: ID2D1GeometryRealization*
Die zu renderde Geometrierealisierung.
[in] brush
Typ: ID2D1Brush*
Der Pinsel, mit dem die Realisierung gerendert werden soll.
Rückgabewert
Typ: HRESULT
Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.
HRESULT | BESCHREIBUNG |
---|---|
S_OK | Kein Fehler ist aufgetreten. |
E_OUTOFMEMORY | Direct2D konnte nicht genügend Arbeitsspeicher zuweisen, um den Anruf abzuschließen. |
E_INVALIDARG | Ein ungültiger Wert wurde an die -Methode übergeben. |
Hinweise
Diese Methode berücksichtigt den gesamten aktuell festgelegten Zustand (Transformation, DPI, Einheitenmodus, Zielbild, Clips, Ebenen); Artefakte wie Faceting können jedoch beim Rendern der Realisierungen mit einem großen effektiven Maßstab (entweder über die Transformation oder die DPI) auftreten. Aufrufer sollten ihre Realisierungen mit einer geeigneten Flachungstoleranz erstellen, indem sie entweder D2D1_DEFAULT_FLATTENING_TOLERANCE oder ComputeFlatteningTolerance verwenden, um dies zu kompensieren.
Darüber hinaus sollten Aufrufer die sicheren Rendergrenzen beim Erstellen von Geometrierealisierungen kennen. Wenn sich eine Geometrie außerhalb von [-524,287, 524,287]-DIPs in X- oder Y-Richtung in ihrem ursprünglichen Koordinatenraum (Vortransformation) erstreckt, kann sie an diese Grenzen gekappt werden, wenn sie realisiert wird. Dieser Clipping ist auch dann sichtbar, wenn die Realisierung anschließend so transformiert wird, dass sie in die sicheren Rendergrenzen passt.
Anforderungen
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 |
Bibliothek | D2d1.lib |
DLL | D2d1.dll |