Share via

ID2D1DeviceContext1::D rawGeometryRealization-Methode (d2d1_2.h)

  • Artikel

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

Weitere Informationen

ID2D1DeviceContext1