You are here: Start » FIL.NET » FIL.ExtractText

FIL.ExtractText

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

Namespace:FilNet
Assembly:FIL.NET.dll

Syntax

C++
C#
 
public static void ExtractText
(
	FilNet.Image inImage,
	FilNet.Rectangle2D inRoi,
	FilNet.CoordinateSystem2D inRoiAlignment,
	FilNet.TextSegmentation inSegmentationModel,
	IList<FilNet.Region> outCharacters,
	FilNet.Region diagTextRegion,
	IList<FilNet.Region> diagAlignedCharacters,
	out FilNet.Rectangle2D diagAlignedRoi
)

Parameters

Name Type Range Default Description
inImageFilNet.ImageAn input image with text.
inRoiFilNet.Rectangle2DLocation of the text.
inRoiAlignmentFilNet.CoordinateSystem2DAdjusts the region of interest to the position of the inspected object.
inSegmentationModelFilNet.TextSegmentationModel used for separating text from background.
outCharactersSystem.Collections.Generic.IList<FilNet.Region>Split characters aligned to ROI.
diagTextRegionFilNet.RegionRegion of text after extraction.
diagAlignedCharactersSystem.Collections.Generic.IList<FilNet.Region>Character regions preserving original image orientation.
diagAlignedRoiFilNet.Rectangle2DROI rectangle after alignment.

Description

This filter distinguish characters from the background using a set of algorithms. This filter performs two steps: text extraction and text segmentation:

  • Text extraction – in this step filter uses some basic thresholding methods to get a characters region from the image.
  • Text segmentation – split previously found region into separate regions contains character.

Input inRoi should contains only a single line of text.

Examples

Result of reading text using the ExtractText.

Remarks

To read more about how to use OCR technique, refer to Machine Vision Guide: Optical Character Recognition

Errors

List of possible exceptions:

Error type Description
DomainError Invalid segmentation algorithm in ExtractText.
DomainError Invalid thresholding algorithm in ExtractText.

Function Overrides

See also