You are here: Start » Function Reference » Image » Image Features » ImageProfileAlongPath

ImageProfileAlongPath

Header:	AVL.h
Namespace:	avl
Module:	FoundationPro

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.

Applications: This is the first step of all 1D Edge Detection operations. Here available for direct use by the user.

Syntax

void avl::ImageProfileAlongPath
(
	ScanMapState& ioState,
	const avl::Image& inImage,
	const avl::Path& inScanPath,
	atl::Optional<const avl::CoordinateSystem2D&> inScanPathAlignment,
	int inScanWidth,
	const avl::SamplingParams& inSamplingParams,
	float inSmoothingStdDev,
	avl::AccumulationMode::Type inAccumulationMode,
	avl::Profile& outProfile,
	avl::Path& outPath,
	atl::Optional<avl::Path&> outAlignedScanPath = atl::NIL,
	atl::Array<avl::Path>& diagSamplingPoints,
	float& diagSamplingStep
)

Parameters

Name	Type	Range	Default	Description
ioState	ScanMapState&			Object used to maintain state of the function.
inImage	const Image&			Input image
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
inSamplingParams	const SamplingParams&			Parameters controlling the sampling process
inSmoothingStdDev	float	0.0 -	0.6f	Standard deviation of the gaussian smoothing applied to the extracted profile
inAccumulationMode	AccumulationMode::Type			Determines how the pixel values are combined
outProfile	Profile&			The resulting profile of the pixel brightness
outPath	Path&			The path consisting of the points from which the resulting profile is extracted
outAlignedScanPath	Optional<Path&>		NIL	Input scan path after transformation (in the image coordinates)
diagSamplingPoints	Array<Path>&			Array of paths each one containing the sampling points that contributed to a single value of the extracted profile
diagSamplingStep	float&			Used distance between consecutive sampling points on the scan path

Optional Outputs

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

Examples

ImageProfileAlongPath applied on an image of a bottle (inScanWidth = 5)