Share via


CD2DGeometry::ComputePointAtLength

Calculates the point and tangent vector at the specified distance along the geometry after it has been transformed by the specified matrix and flattened using the specified tolerance.

BOOL ComputePointAtLength(
   FLOAT length,
   const D2D1_MATRIX_3X2_F &worldTransform,
   CD2DPointF& point,
   CD2DPointF& unitTangentVector,
   FLOAT flatteningTolerance = D2D1_DEFAULT_FLATTENING_TOLERANCE
) const;

Parameters

  • length
    The distance along the geometry of the point and tangent to find. If this distance is less then 0, this method calculates the first point in the geometry. If this distance is greater than the length of the geometry, this method calculates the last point in the geometry.

  • worldTransform
    The transform to apply to the geometry before calculating the specified point and tangent.

  • point
    The location at the specified distance along the geometry. If the geometry is empty, this point contains NaN as its x and y values.

  • unitTangentVector
    When this method returns, contains a pointer to the tangent vector at the specified distance along the geometry. If the geometry is empty, this vector contains NaN as its x and y values. You must allocate storage for this parameter.

  • flatteningTolerance
    The maximum bounds on the distance between points in the polygonal approximation of the geometry. Smaller values produce more accurate results but cause slower execution.

Return Value

If the method succeeds, it returns TRUE. Otherwise, it returns FALSE.

Requirements

Header: afxrendertarget.h

See Also

Reference

CD2DGeometry Class