Start » Filter Reference » Path » Path Global Transforms » ConvertToEquidistantPath

ConvertToEquidistantPath


Module: FoundationBasic

Creates a new path whose characteristic points lie on the input path, but are equally spaced.

Name Type Range Description
Input value
inPath Path Input path
Input value
inStep Real 0.0 - Requested distance between consecutive points
Input value
inEquidistanceType EquidistanceType Defines how the distance is measured
Output value
outPath Path Output path

Description

The operation follows a path from its beginning to the end, reselecting its characteristic points every inStep pixels. Note that this operation can significantly change the shape of a path, especially when the inStep value is relatively big. The output path's last point is mostly not the same as the input path's last point, because it would lead to last output path's segment being too short.

To reduce the number of points in a path preserving its shape, one can use ReducePath filter.

Examples

Description of usage of this filter can be found in examples and tutorial: Capsules, Rubber Ring.

ConvertToEquidistantPath run on the sample path with inStep = 10 and inEquidistanceType = OutputPathEquidistance.

ConvertToEquidistantPath run on the sample path with inStep = 100 and inEquidistanceType = OutputPathEquidistance.

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
DomainError Input step has to be positive in ConvertToEquidistantPath.

Complexity Level

This filter is available on Advanced Complexity Level.

See Also

  • ReducePath – Reduces the number of points in a path preserving its shape with the specified precision.