Back to FabImage Library website

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

ExtractText2


Header: FIL.h
Namespace: fil
Module: OCR

Ready-to-use tool for extracting and splitting text elements to single characters.

Syntax

C++
C#
 
void fil::ExtractText2
(
	const fil::Image& inImage,
	const fil::Rectangle2D& inRoi,
	const fil::CoordinateSystem2D& inRoiAlignment,
	const fil::Polarity::Type inPolarity,
	const int inCharWidth,
	ftl::Optional<int> inStrokeWidth,
	ftl::Optional<int> inMinWordGap,
	ftl::Array<fil::Region>& outCharacters,
	ftl::Array<fil::Region>& diagAlignedCharacters
)

Parameters

Name Type Range Default Description
Input value inImage const Image& An input image with text
Input value inRoi const Rectangle2D& Location of the text
Input value inRoiAlignment const CoordinateSystem2D& Adjusts the region of interest to the position of the inspected object
Input value inPolarity const Polarity::Type Text polarity
Input value inCharWidth const int 5 - 200 50 Width of a single character in pixels
Input value inStrokeWidth Optional<int> 1 - 50 NIL Width of the stroke of the letters in pixels
Input value inMinWordGap Optional<int> 1 - 200 NIL Width of the smallest gap between letters that is to be treated as a space in pixels
Output value outCharacters Array<Region>& Regions representing individual characters aligned to the ROI
Diagnostic input diagAlignedCharacters Array<Region>& Regions representing individual characters aligned to the Image

Errors

List of possible exceptions:

Error type Description
DomainError inPolarity must be specified as Dark or Bright in ExtractText2.
DomainError inRoi is to narrow to fit a single character in ExtractText2.
DomainError It is impossible for inStrokeWidth to be greater than inCharWidth in ExtractText2.