You are here: Start » Function Reference » Image » Image Spatial Transforms » ImageAlongArc

ImageAlongArc

Header:	FIL.h
Namespace:	fil
Module:	FoundationBasic

Creates an image from pixels traversed along an arc.

Applications: E.g. "Unwrapping" of object contours, so that they appear as 1D structures on the output image.

Syntax

void fil::ImageAlongArc
(
	const fil::Image& inImage,
	const fil::Arc2D& inAxisArc,
	ftl::Optional<const fil::CoordinateSystem2D&> inAxisArcAlignment,
	int inScanWidth,
	fil::Axis::Type inAxisType,
	fil::InterpolationMethod::Type inInterpolationMethod,
	ftl::Optional<const fil::Pixel&> inBorderColor,
	fil::Image& outImage,
	ftl::Optional<fil::Arc2D&> outAlignedAxisArc = ftl::NIL,
	ftl::Array<fil::Path>& diagSamplingPoints = ftl::Dummy<ftl::Array<fil::Path> >()
)

Parameters

Name	Type	Range	Default	Description
inImage	const Image&			Input image
inAxisArc	const Arc2D&			Input arc
inAxisArcAlignment	Optional<const CoordinateSystem2D&>		NIL	Adjusts the axis arc to the position of the inspected object
inScanWidth	int	1 -	5	The width of the stripe of pixels along the given arc
inAxisType	Axis::Type		Y	Type of axis the transformed axis arc will be parallel to
inInterpolationMethod	InterpolationMethod::Type		Bilinear	The interpolation method used to compute pixel brightness in locations of not-integer coordinates
inBorderColor	Optional<const Pixel&>		NIL	Color of pixel outside image. If inBorderColor = NIL then algorithm repeats color of boarder.
outImage	Image&			Output image
outAlignedAxisArc	Optional<Arc2D&>		NIL	Input arc after transformation (in the image coordinates)
diagSamplingPoints	Array<Path>&			Array of paths each one containing the sampling points corresponding to one row of the resulting image

Optional Outputs

The computation of following outputs can be switched off by passing value ftl::NIL to these parameters: outAlignedAxisArc.

Description

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

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

Examples