ID2D1Geometry::ComputePointAtLength(FLOAT,constD2D1_MATRIX_3X2_F&,FLOAT,D2D1_POINT_2F*,D2D1_POINT_2F*)-Methode (d2d1.h)

  • Artikel

Berechnet den Punkt- und Tangensvektor im angegebenen Abstand entlang der Geometrie, nachdem er von der angegebenen Matrix transformiert und mit der angegebenen Toleranz vereinfacht wurde.

Syntax

HRESULT ComputePointAtLength(
  FLOAT                     length,
  const D2D1_MATRIX_3X2_F & worldTransform,
  FLOAT                     flatteningTolerance,
  D2D1_POINT_2F             *point,
  D2D1_POINT_2F             *unitTangentVector
);

Parameter

length

Typ: [in] FLOAT

Der Abstand entlang der Geometrie des zu findenden Punkts und Tangens. Wenn dieser Abstand kleiner als 0 ist, berechnet diese Methode den ersten Punkt in der Geometrie. Wenn dieser Abstand größer als die Länge der Geometrie ist, berechnet diese Methode den letzten Punkt in der Geometrie.

worldTransform

Typ: [in] const D2D1_MATRIX_3X2_F &

Die Transformation, die vor der Berechnung des angegebenen Punkts und Tangens auf die Geometrie angewendet werden soll.

flatteningTolerance

Typ: [in] 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 ab als die Toleranz für die Vereinfachung. Kleinere Werte liefern genauere Ergebnisse, führen jedoch zu einer langsameren Ausführung.

point

Typ: [out, optional] D2D1_POINT_2F*

Die Position im angegebenen Abstand entlang der Geometrie. Wenn die Geometrie leer ist, enthält dieser Punkt NaN als x- und y-Werte.

unitTangentVector

Typ: [out, optional] D2D1_POINT_2F*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf den Tangensvektor im angegebenen Abstand entlang der Geometrie. Wenn die Geometrie leer ist, enthält dieser Vektor NaN als x- und y-Werte. Sie müssen Speicher für diesen Parameter zuordnen.

Rückgabewert

Typ: HRESULT

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

Anforderungen

Anforderung Wert
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

ID2D1Geometry