You are here: Start » Function Reference » Computer Vision » Image Segmentation » SegmentImage_Edges

SegmentImage_Edges

Header:	FIL.h
Namespace:	fil
Module:	FoundationPro

Segments an image into blobs using image edges as their borders.

Applications: Detection of objects of undefined shape, but characterized by good contrast to the background and fairly uniform internal brightness.

Syntax

void fil::SegmentImage_Edges
(
	const fil::Image& inImage,
	ftl::Optional<const fil::Region&> inRoi,
	const int inFrameSize,
	float inStdDev,
	float inEdgeThreshold,
	float inEdgeHysteresis,
	const float inMaxJoiningDistance,
	const int inMinArea,
	ftl::Optional<int> inMaxArea,
	bool inComputeNestingLevels,
	const int inEdgeClosing,
	ftl::Array<fil::Region>& outBlobs,
	ftl::Optional<ftl::Array<int>&> outNestingLevels = ftl::NIL,
	fil::Region& diagEdgeRegion = ftl::Dummy<fil::Region>()
)

Parameters

Name	Type	Range	Default	Description
inImage	const Image&			Image from which blobs are extracted
inRoi	Optional<const Region&>		NIL	Range of pixels to be processed
inFrameSize	const int	0 -	1	How many pixels from the region border are excluded from the results
inStdDev	float	0.0 -	2.0f	Amount of smoothing used by the edge filter
inEdgeThreshold	float	0.0 -	15.0f	Sufficient edge strength; edges of that strength will always be detected
inEdgeHysteresis	float	0.0 -	5.0f	Value by which the edge threshold is decreased for edge points neighboring with sufficiently strong edges
inMaxJoiningDistance	const float	0.0 -	0.0f	Maximal distance between edges that can be joined
inMinArea	const int	0 -	50	Minimal area of a detected blob
inMaxArea	Optional<int>	0 -	NIL	Maximal area of a detected blob
inComputeNestingLevels	bool			Flag indicating whether nesting levels should be computed
inEdgeClosing	const int	0 -	1	Radius of enclosing small holes in the detected blobs
outBlobs	Array<Region>&			Blobs extracted from the input image
outNestingLevels	Optional<Array<int>&>		NIL	Nesting level of each extracted blob
diagEdgeRegion	Region&			Region of the found edges

Optional Outputs

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