You are here: Start » Function Reference » Profile » Profile Features » ProfileEdges

ProfileEdges

Header:	FIL.h
Namespace:	fil
Module:	FoundationPro

Finds the locations at which the profile values raise or fall quickly.

Applications: Can be used for 1D edge detection when the brightness profile is extracted from an image in a non-standard way.

Syntax

void fil::ProfileEdges
(
	const fil::Profile& inProfile,
	ftl::Optional<const fil::Range&> inRange,
	bool inCyclic,
	const fil::EdgeScanParams& inEdgeScanParams,
	float inMinDistance,
	ftl::Optional<float> inMaxDistance,
	ftl::Optional<const fil::LocalBlindness&> inLocalBlindness,
	ftl::Array<fil::ProfileEdge>& outEdges,
	ftl::Optional<ftl::Array<float>&> outDistances = ftl::NIL,
	ftl::Optional<fil::Profile&> outResponseProfile = ftl::NIL
)

Parameters

Name	Type	Range	Default	Description
inProfile	const Profile&			Input profile
inRange	Optional<const Range&>		NIL
inCyclic	bool
inEdgeScanParams	const EdgeScanParams&		EdgeScanParams ( ProfileInterpolation: Quadratic4 SmoothingStdDev: 0.6f MinMagnitude: 5.0f EdgeTransition: BrightToDark )	Parameters controlling the edge extraction process
inMinDistance	float	0.0 -	0.0f	Minimal distance between consecutive edges
inMaxDistance	Optional<float>	0.0 -	NIL	Maximal distance between consecutive edges
inLocalBlindness	Optional<const LocalBlindness&>		NIL	Defines conditions in which weaker edges can be detected in the vicinity of stronger edges
outEdges	Array<ProfileEdge>&			Found edges
outDistances	Optional<Array<float>&>		NIL	Output distances between consecutive edges
outResponseProfile	Optional<Profile&>		NIL	Profile of the edge (derivative) operator response

Optional Outputs

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

Errors

List of possible exceptions:

Error type	Description
DomainError	Range exceeds the input profile in ProfileEdges.