You are here: Start » FIL.NET » Function Reference » Image » Image Spatial Transforms » FIL.ImageAlongPath

FIL.ImageAlongPath

Creates an image from pixels traversed along a path.

Namespace:FilNet
Assembly:FIL.NET.dll

Syntax

C++
C#
 
public static void ImageAlongPath
(
	FilNet.Image inImage,
	FilNet.Path inAxisPath,
	FilNet.CoordinateSystem2D? inAxisPathAlignment,
	int inScanWidth,
	FilNet.Axis inAxisType,
	FilNet.InterpolationMethod inInterpolationMethod,
	FilNet.Pixel? inBorderColor,
	FilNet.Image outImage
)

Parameters

Name Type Range Default Description
inImageFilNet.ImageInput image.
inAxisPathFilNet.PathInput path.
inAxisPathAlignmentFilNet.CoordinateSystem2D?Adjusts the axis path to the position of the inspected object. Default value: ftl::NIL.
inScanWidthint<1, INF>5The width of the stripe of pixels along the given path. Default value: 5.
inAxisTypeFilNet.AxisYType of axis the transformed axis path will be parallel to. Default value: Y.
inInterpolationMethodFilNet.InterpolationMethodBilinearThe interpolation method used to compute pixel brightness in locations of not-integer coordinates. Default value: Bilinear.
inBorderColorFilNet.Pixel?Pixel ( X: 0.0f Y: 0.0f Z: 0.0f W: 0.0f )Color of pixel outside image. If inBorderColor = NIL then algorithm repeats color of boarder. Default value: Pixel ( X: 0.0f Y: 0.0f Z: 0.0f W: 0.0f ).
outImageFilNet.ImageOutput 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.

Function Overrides

See also