ID2D1Geometry::Outline(constD2D1_MATRIX_3X2_F*,FLOAT,ID2D1SimplifiedGeometrySink*)-Methode (d2d1.h)

  • Artikel

Berechnet die Gliederung der Geometrie und schreibt das Ergebnis in einen ID2D1SimplifiedGeometrySink.

Syntax

HRESULT Outline(
  [in, optional] const D2D1_MATRIX_3X2_F     *worldTransform,
                 FLOAT                       flatteningTolerance,
  [in]           ID2D1SimplifiedGeometrySink *geometrySink
);

Parameter

[in, optional] worldTransform

Typ: const D2D1_MATRIX_3X2_F*

Die Transformation, die auf die Geometriegliederung angewendet werden soll, oder NULL.

flatteningTolerance

Typ: FLOAT

Der maximal zulässige Fehler beim Erstellen einer polygonalen Näherung der Geometrie. Kein Punkt in der polygonalen Darstellung weicht von der ursprünglichen Geometrie um mehr als die Abflachungstoleranz ab. Kleinere Werte liefern genauere Ergebnisse, führen jedoch zu einer langsameren Ausführung.

[in] geometrySink

Typ: ID2D1SimplifiedGeometrySink*

Der ID2D1SimplifiedGeometrySink , an den die transformierte Gliederung der Geometrie angefügt wird.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Mit der Outline-Methode kann der Aufrufer eine Geometrie mit einer entsprechenden Füllung der Eingabegeometrie mit den folgenden zusätzlichen Eigenschaften erstellen:

  • Die Ausgabegeometrie enthält keine quer übergreifenden Schnittmengen; Das heißt, Segmente können sich berühren, aber sie kreuzen sich nie.
  • Die äußersten Figuren in der Ausgabegeometrie sind alle gegen den Uhrzeigersinn ausgerichtet.
  • Die Ausgabegeometrie ist Füllmodus invariant; Das heißt, die Füllung der Geometrie hängt nicht von der Wahl des Füllmodus ab.

    Weitere Informationen zum Füllmodus finden Sie unter D2D1_FILL_MODE.

Darüber hinaus kann die Outline-Methode nützlich sein, um redundante Teile dieser Geometrien zu entfernen, um komplexe Geometrien zu vereinfachen. Es kann auch in Kombination mit ID2D1GeometryGroup nützlich sein, um gleichzeitig Unions zwischen mehreren Geometrien zu erstellen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile d2d1.h
Bibliothek D2d1.lib
DLL D2d1.dll

Weitere Informationen

ID2D1Geometrie