You are here: Start » Function Reference » Surface Features » SurfaceProfileAlongPath

SurfaceProfileAlongPath

Creates a series of segments across the input path, measures the average surface height on each of the segments, and creates the final profile from that values.

Header:	AVL.h

Syntax

void avl::SurfaceProfileAlongPath
(
	SurfaceProfileAlongPathState& ioState,
	const avl::Surface& inSurface,
	const avl::Path& inScanPath,
	atl::Optional<const avl::CoordinateSystem2D&> inScanPathAlignment,
	int inScanWidth,
	avl::InterpolationMethod::Type inSurfaceInterpolation,
	atl::Optional<int> inMaxInterpolationLength,
	float inSmoothingStdDev,
	avl::Profile& outProfile,
	avl::Path& outPath,
	atl::Optional<avl::Path&> outAlignedScanPath = atl::NIL
)

void SurfaceProfileAlongPath
(
	ref SurfaceProfileAlongPathState ioState,
	Surface inSurface,
	Path inScanPath,
	CoordinateSystem2D? inScanPathAlignment,
	int inScanWidth,
	InterpolationMethod inSurfaceInterpolation,
	int? inMaxInterpolationLength,
	float inSmoothingStdDev,
	out Profile outProfile,
	out Path outPath,
	out Path? outAlignedScanPath
)

Parameters

Name	Type	Range	Default	Description
ioState	SurfaceProfileAlongPathState&			Object used to maintain state of the function.
inSurface	const Surface&			Input surface
inScanPath	const Path&			Path along which the profile is extracted
inScanPathAlignment	Optional<const CoordinateSystem2D&>		NIL	Adjusts the scan path to the position of the inspected object
inScanWidth	int	1 -	5	Width of the scan field in pixels
inSurfaceInterpolation	InterpolationMethod::Type		Bilinear	Interpolation method used for extraction of surface points
inMaxInterpolationLength	Optional<int>		NIL	Maximal number of consecutive not existing profile points
inSmoothingStdDev	float	0.0 -	0.6f	Standard deviation of the gaussian smoothing applied to the extracted profile
outProfile	Profile&			The resulting profile of the surface height
outPath	Path&			The path consisting of the points from which the resulting profile is extracted
outAlignedScanPath	Optional<Path&>		NIL	Path along which the scan is performed; in the image coordinate system