Share via

ID2D1PathGeometry1::ComputePointAndSegmentAtLength(FLOAT,UINT32,constD2D1_MATRIX_3X2_F&,FLOAT,D2D1_POINT_DESCRIPTION*)-Methode (d2d1_1.h)

  • Artikel

Berechnet den Punkt, der in einer bestimmten Entfernung entlang der Pfadgeometrie vorhanden ist, zusammen mit dem Index des Segments, auf dem sich der Punkt befindet, und dem Richtungsvektor an diesem Punkt.

Syntax

HRESULT ComputePointAndSegmentAtLength(
        FLOAT                     length,
        UINT32                    startSegment,
  [ref] const D2D1_MATRIX_3X2_F & worldTransform,
        FLOAT                     flatteningTolerance,
  [out] D2D1_POINT_DESCRIPTION    *pointDescription
);

Parameter

length

Typ: FLOAT

Die Entfernung, die entlang des Pfads zu gehen ist.

startSegment

Typ: UINT32

Der Index des Segments, an dem mit dem Gehen begonnen werden soll. Hinweis: Dieser Index ist für den gesamten Pfad global, nicht nur für eine bestimmte Abbildung.

[ref] worldTransform

Typ: const D2D1_MATRIX_3X2_F

Die Transformation, die vor dem Gehen auf den Pfad angewendet werden soll.

flatteningTolerance

Typ: FLOAT

Die Beim Gehen entlang eines Bogens oder Béziersegments zu verwendende Flachungstoleranz. Die Toleranz für die Vereinfachung ist 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 ab als die Toleranz für die Vereinfachung. Kleinere Werte liefern genauere Ergebnisse, führen jedoch zu einer langsameren Ausführung.

[out] pointDescription

Typ: D2D1_POINT_DESCRIPTION*

Wenn diese Methode zurückgibt, enthält eine Beschreibung des Punkts, der an der angegebenen Position gefunden werden kann.

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 Eine der Eingaben lag in einem ungültigen Bereich.

Anforderungen

   
Zielplattform Windows
Kopfzeile d2d1_1.h (D2d1_1.h einschließen)
Bibliothek D2d1_3.lib
DLL D2d1_3.dll

Weitere Informationen

ID2D1PathGeometry1