Back to FabImage Library website

You are here: Start » Function Reference » Region » Region Features » RegionContours

RegionContours


Header: FIL.h
Namespace: fil
Module: FoundationBasic

Computes an array of closed paths corresponding to the contours of the input region.

Syntax

C++
C#
 
void fil::RegionContours
(
	const fil::Region& inRegion,
	const fil::RegionContourMode::Type inContourMode,
	fil::RegionConnectivity::Type inRegionConnectivity,
	ftl::Array<fil::Path>& outContours
)

Parameters

Name Type Default Description
Input value inRegion const Region& Input region
Input value inContourMode const RegionContourMode::Type
Input value inRegionConnectivity RegionConnectivity::Type EightDirections Region connectivity semantics
Output value outContours Array<Path>&

Description

The operation forms an array of paths that, depending on the value of the inContourMode parameter:

  • Pass through the centers of boundary pixels of the region, if inContourMode is set to PixelCenters
  • Run along the edges of boundary pixels of the region, if inContourMode is set to PixelEdges

To compute the approximation of the region perimeter length, one can use RegionPerimeterLength filter.

Examples

The computed outContours array drawn onto an empty image.

See Also