Back to Adaptive Vision Library website
You are here: Start » Function Reference » Path Spatial Transforms » PathAlongPath
PathAlongPath
Transforms a path to a coordinate system in which the 'axis' path is vertical or horizontal.
Header: | AVL.h |
---|
Syntax
C++
C#
void avl::PathAlongPath ( const avl::Path& inPath, const avl::Path& inAxis, avl::Axis::Type inAxisType, float inAxisCoordinate, bool inInverse, avl::Path& outPath )
Parameters
Name | Type | Default | Description | |
---|---|---|---|---|
inPath | const Path& | Input path | ||
inAxis | const Path& | Input axis path | ||
inAxisType | Axis::Type | Y | Type of axis the input axis path is parallel to | |
inAxisCoordinate | float | 0.0f | Coordinate of the axis path | |
inInverse | bool | True | Switches to the inverse operation | |
outPath | Path& | Transformed path |
Description
This filter transforms each point in inPath the same way how PointAlongPath does.
Examples
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
Error type | Description |
---|---|
DomainError | Empty path on input in PathAlongPath. |
See Also
- ImageAlongPath – Creates an image from pixels traversed along a path.
- PathAlongArc – Transforms a path to a coordinate system in which the 'axis' arc is vertical or horizontal.
- PointAlongPath – Transforms a point to a coordinate system in which the 'axis' path is vertical or horizontal.