Back to FabImage Library website

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

ProfileStripes


Header: FIL.h
Namespace: fil
Module: FoundationPro

Finds pairs of opposite (raising and falling) edges in the input profile.

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

Syntax

C++
C#
 
void fil::ProfileStripes
(
	const fil::Profile& inProfile,
	ftl::Optional<const fil::Range&> inRange,
	bool inCyclic,
	const fil::StripeScanParams& inStripeScanParams,
	float inMinGapWidth,
	ftl::Optional<float> inMaxGapWidth,
	ftl::Optional<const fil::LocalBlindness&> inLocalBlindness,
	ftl::Array<fil::ProfileStripe>& outStripes,
	ftl::Optional<ftl::Array<float>&> outGapWidths = ftl::NIL,
	ftl::Optional<fil::Profile&> outResponseProfile = ftl::NIL
)

Parameters

Name Type Range Default Description
Input value
 inProfile const Profile& Input profile
Input value
 inRange Optional<const Range&> NIL
Input value
 inCyclic bool
Input value
 inStripeScanParams const StripeScanParams& StripeScanParams ( ProfileInterpolation: Quadratic4 SmoothingStdDev: 0.6f MinMagnitude: 5.0f MaxInnerEdgeMagnitude: Nil StripePolarity: Bright MinStripeWidth: 0.0f MaxStripeWidth: Nil ) Parameters controlling the stripe extraction process
Input value
 inMinGapWidth float 0.0 - 0.0f Minimal distance between consecutive stripes
Input value
 inMaxGapWidth Optional<float> 0.0 - NIL Maximal distance between consecutive stripes
Input value
 inLocalBlindness Optional<const LocalBlindness&> NIL Defines conditions in which weaker edges can be detected in the vicinity of stronger edges
Output value
 outStripes Array<ProfileStripe>& Found stripes
Output value
 outGapWidths Optional<Array<float>&> NIL Distances between consecutive stripes
Output value
 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: outGapWidths, outResponseProfile.

Read more about Optional Outputs.

Errors

List of possible exceptions:

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