Back to FabImage Library website

You are here: Start » Function Reference » Computer Vision » Optical Character Recognition » GroupRegionsByLines

GroupRegionsByLines


Header: FIL.h
Namespace: fil
Module: OCR

Splits an array of blobs by distance to computed base lines.

Syntax

C++
C#
 
void fil::GroupRegionsByLines
(
	const ftl::Array<fil::Region>& inRegions,
	const fil::Rectangle2D& inRoi,
	const ftl::Optional<fil::CoordinateSystem2D>& inRoiAlignment,
	const int inLinesCount,
	const float inLineWidth,
	const bool inRemoveOutliers,
	ftl::Array<ftl::Array<fil::Region>>& outLines,
	ftl::Array<fil::Region>& outLine0,
	ftl::Array<fil::Region>& outLine1,
	ftl::Array<fil::Region>& outLine2,
	ftl::Array<fil::Region>& outLine3,
	fil::Rectangle2D& outAlignedRoi,
	ftl::Array<fil::Segment2D>& diagLines,
	ftl::Array<fil::Rectangle2D>& diagLineRanges,
	ftl::Array<fil::Point2D>& diagRegionPoints
)

Parameters

Name Type Range Default Description
Input value inRegions const Array<Region>& Input regions (parts of characters)
Input value inRoi const Rectangle2D& Range of character classification
Input value inRoiAlignment const Optional<CoordinateSystem2D>& NIL
Input value inLinesCount const int 0 - 1 ROI is divided into inLinesCount lines
Input value inLineWidth const float 0.0 - 1.0f Value of line range used if inRemoveOutliers is set to TRUE
Input value inRemoveOutliers const bool False If this flag is set blobs with distance greater than inLineWidth are removed.
Output value outLines Array<Array<Region>>& Lines in single Array
Output value outLine0 Array<Region>&
Output value outLine1 Array<Region>&
Output value outLine2 Array<Region>&
Output value outLine3 Array<Region>&
Output value outAlignedRoi Rectangle2D&
Diagnostic input diagLines Array<Segment2D>& Segments which indicates the position of lines
Diagnostic input diagLineRanges Array<Rectangle2D>& Rectangles represents range of lines which are included if inRemoveOutliers is set
Diagnostic input diagRegionPoints Array<Point2D>& Point which indicates region position

Examples

As you can see in the below picture, the filter's task is to divide the input region into several sub-regions by its placement in a line. As a result, each line represents a separate region.

Exemplary result of the filter's usage.