ObjectsExtractionParams Object (IObjectsExtractionParams Interface)

This object provides access to the parameters used for objects extraction. Objects extraction is a process which detects additional objects (e.g., garbage, texture, small text areas of low quality) on an image before recognition.

The ObjectsExtractionParams object is a persistent object. This means that the object's current state can be written to persistent storage: an area in the global memory or a disk file. Later, the object can be re-created by reading the object's state from persistent storage. The following methods provide persistence of the object: SaveToFile, LoadFromFile, SaveToMemory, and LoadFromMemory.

Properties

Name Type Description
Application Engine, read-only Returns the Engine object.
Common settings
FastObjectsExtraction VARIANT_BOOL

If this property is TRUE, objects extraction will speed up, but its quality may deteriorate.

This property is FALSE by default.

ProhibitColorImage VARIANT_BOOL

This property set to TRUE tells ABBYY FineReader Engine to use only black-and-white plane during objects extraction. In this case, the detection quality of colored tables and pictures can get worse.

This property is FALSE by default.

SourceContentReuseMode SourceContentReuseModeEnum

Specifies how to use the text and image layers of the source PDF file.

This property is CRM_Auto by default.

Objects removing
RemoveGarbage VARIANT_BOOL

Specifies if garbage (excess dots that are smaller than a certain size) is to be removed from the image during objects extraction.

This property is FALSE by default.

RemoveTexture VARIANT_BOOL

This property set to TRUE tells ABBYY FineReader Engine to remove the background noise from a temporary image used for recognition. The source image remains unaffected.

This property is TRUE by default.

Objects detection
DetectMatrixPrinter VARIANT_BOOL

If this property is TRUE, the text printed on matrix printer is detected during objects extraction.

This property is TRUE by default.

DetectPorousText VARIANT_BOOL

If this property is TRUE, the regions with porous text are detected during objects extraction.

This property is TRUE by default.

DetectTextOnPictures VARIANT_BOOL

This property set to TRUE tells ABBYY FineReader Engine to detect all text on a page image, including text embedded into figures and pictures. Reading order is not changed to provide ability for full-text search later.

This property is FALSE by default.

EnableAggressiveTextExtraction VARIANT_BOOL

If this property is TRUE, FineReader Engine will try to extract as much text on the image as possible. We recommend using this mode when the image contains some low-quality text. This processing mode may lead to mistaken interpretation of pictures as text or vertical rearranging of the horizontal text.

This property is FALSE by default.

ProhibitDottedSeparators VARIANT_BOOL

If this property is set to TRUE, ABBYY FineReader Engine presumes that the document does not contain dotted separators. This property may be useful, if you are sure that the document does not contain dotted separators, or if some data is incorrectly recognized as a dotted separator. This is a temporary property, it may be removed in a future version.

This property is FALSE by default.

Methods

Name Description
CopyFrom Initializes properties of the current object with values of similar properties of another object.
LoadFromFile Restores the object contents from a file on disk.
LoadFromMemory Restores the object contents from the global memory.
SaveToFile Saves the object contents into a file on disk.
SaveToMemory Saves the object contents into the global memory.

Related objects

Object Diagram

Output parameter

This object is the output parameter of the CreateObjectsExtractionParams method of the Engine object.

Input parameter

This object is passed as an input parameter to the following methods:

Samples

The object is used in the following code samples: CommandLineInterface; and demo tools: Camera OCR, Image Preprocessing.

See also

Tuning Parameters of Preprocessing, Analysis, Recognition, and Synthesis

PageProcessingParams

Working with Properties

24.03.2023 8:51:52

Usage of Cookies. In order to optimize the website functionality and improve your online experience ABBYY uses cookies. You agree to the usage of cookies when you continue using this site. Further details can be found in our Privacy Notice.