You are here: Start » Filter Reference » Path Spatial Transforms » PathAlongPath

PathAlongPath

Transforms a path to a coordinate system in which the 'axis' path is vertical or horizontal.

Name	Type	Description
inPath	Path	Input path
inAxis	Path	Input axis path
inAxisType	Axis	Type of axis the input axis path is parallel to
inAxisCoordinate	Real	Coordinate of the axis path
inInverse	Bool	Switches to the inverse operation
outPath	Path	Transformed path

Applications

Usually used to revert an ImageAlongPath transformation.

Description

This filter transforms each point in inPath the same way how PointAlongPath does.

Examples

ImageAlongPath performed on the sample image with inAxisType = X and inScanWidth = 50. Blue path on output image was reprojected on original image using PathAlongPath with inAxisType = X, inAxisCoordinate = 25, inInverse = true. ImageAlongPath and PathAlongPath used the same path (the orange one) for transformations.

Remarks

No new points are being added to input path during transformation, and this may lead to some "distortions" of path. This is especially visible on long, straight portions of input path, which are described with only 2 points: the beginning one and the ending one. After transformation, such part of path is still a line, but it may not be corresponding to the transformed image. Easy way to overcome this problem is to increase number of points creating an transformed path.

Errors

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

Error type	Description
DomainError	Empty path on input in PathAlongPath.

Complexity Level

This filter is available on Advanced Complexity Level.