Skip to main content
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. Later, the object can be re-created by reading the object’s state from the persistent storage. The following methods provide persistence of the object: Linux: SaveToFile, and LoadFromFile Windows 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.

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

NameDescription
CopyFromInitializes properties of the current object with values of similar properties of another object.
LoadFromFileRestores the object contents from a file on disk.
LoadFromMemory <Note> : Windows only. </Note>Restores the object contents from the global memory.
SaveToFileSaves the object contents into a file on disk.
SaveToMemory <Note> : Windows only. </Note>Saves the object contents into the global memory.
ObjectsExtractionParams 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 (Windows and Linux)

See also

Tuning Parameters of Preprocessing, Analysis, Recognition, and Synthesis PageProcessingParams Working with Properties