Start » Filter Reference » Image » Image Spatial Transforms » ImageAlongPath

ImageAlongPath

Advanced

Module: FoundationPro

Creates an image from pixels traversed along a path.

Applications

E.g. "Unwrapping" of object contours, so that they appear as 1D structures on the output image.
Name Type Range Description
Input value
 inImage Image Input image
Input value
 inAxisPath Path Input path
Input value
 inAxisPathAlignment CoordinateSystem2D* Adjusts the axis path to the position of the inspected object
Input value
 inScanWidth Integer 1 - The width of the stripe of pixels along the given path
Input value
 inAxisType Axis Type of axis the transformed axis path will be parallel to
Input value
 inInterpolationMethod InterpolationMethod The interpolation method used to compute pixel brightness in locations of not-integer coordinates
Input value
 inBorderColor Pixel* Color of pixel outside image. If inBorderColor = NIL then algorithm repeats color of boarder.
Output value
 outImage Image Output image
Output value
 outAlignedAxisPath Path Input path after transformation (in the image coordinates)
Diagnostic input
 diagSamplingPoints PathArray Array of paths each one containing the sampling points corresponding to one row of the resulting image

Description

The operation transforms the stripe of pixels of width inScanWidth along the inAxisPath in the way that transforms the path into straight segment. Two modes of pixel interpolation are available, the bilinear filtering being more precise and computationally expensive.

The optional parameter inAxisPathAlignment defines the transform to be performed on the inAxisPath so that the resulting path is defined in a new context, e.g. returned by one of Template Matching filters.

Examples

ImageAlongPath performed on the sample image with inScanWidth = 50 and inAxisType = Y. The result was transposed using TransposeImage for clarity.

Complexity Level

This filter is available on Advanced Complexity Level.

See Also

  • ImageProfileAlongPath – Creates a series of segments across the input path, measures the average pixel intensity on each of the segments, and creates the final profile from those values.
  • ImageAlongArc – Creates an image from pixels traversed along an arc.