PageAnalysisParams Object (IPageAnalysisParams Interface)

This object provides access to parameters used for tuning the layout analysis process. It is passed as an input parameter or as a member of the PageProcessingParams object into FineReader Engine processing methods.

The PageAnalysisParams 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.
Block detection settings
DetectText VARIANT_BOOL

If this property is TRUE, the text areas are detected during layout analysis.

This property is TRUE by default.

EnableTextExtractionMode VARIANT_BOOL

This property set to TRUE tells FineReader Engine that text blocks can be located anywhere on the page. Isolated text blocks are detected during layout analysis. Tables are not detected.

This property is FALSE by default.

EnableExhaustiveAnalysisMode VARIANT_BOOL This property is deprecated and will be deleted in future versions.
DetectTables VARIANT_BOOL

If this property is TRUE, the tables are detected during layout analysis.

This property is TRUE by default.

TableAnalysisParams TableAnalysisParams Provides access to the subset of page processing parameters that affect the process of table analysis. If the DetectTables property is FALSE, these parameters are ignored.
AggressiveTableDetection VARIANT_BOOL

This property manages the table detection mode. If you set it to TRUE, FineReader Engine tries to find as many tables as possible on the page. This setting is recommended only for the documents which contain a lot of tables.

This property is FALSE by default.

DetectBarcodes VARIANT_BOOL

Specifies if barcodes are detected and, accordingly, barcode blocks created, during layout analysis. If this property is FALSE, barcodes may be detected as blocks of some other type (e.g., pictures).

This property is FALSE by default.

BarcodeParams BarcodeParams

Provides access to the subset of page processing parameters, affecting the process of barcode blocks recognition.

These parameters are ignored, if the value of the DetectBarcodes property is FALSE.

DetectSeparators VARIANT_BOOL

If this property is TRUE, the separators are detected during layout analysis.

This property is TRUE by default.

DetectPictures VARIANT_BOOL

If this property is TRUE, the pictures are detected during layout analysis.

This property is TRUE by default.

DetectVectorGraphics VARIANT_BOOL

If this property is TRUE, vector pictures are detected during layout analysis. Vector picture blocks can appear in the layout only if this property has been set to TRUE during layout analysis.

This property is TRUE by default.

Additional settings
DetectMultipleBusinessCards VARIANT_BOOL

Specifies whether a processing page can contain several business cards.

By default, the value of this property is FALSE.

NoShadowsMode VARIANT_BOOL

This property set to TRUE tells ABBYY FineReader Engine to presume that an image has no shadows from scanning.

This property is FALSE by default.

PaperSizeDetectionMode PaperSizeDetectionModeEnum

This property indicates if the whole preprocessed image can contain information for analysis. In case PaperSizeDetectionMode is set to PSDM_CloseToImageSize, the area for analysis will be defined close to the original image size.

Note: For correct operation of this property, the NoShadowsMode property must be set to FALSE.

The default value of this property is PSDM_Auto.

DetectVerticalEuropeanText VARIANT_BOOL

This property set to TRUE makes FineReader Engine look for vertically oriented text. It applies to all languages other than CJK. For CJK languages, vertical text detection is managed by the ProhibitCJKColumns property.

This property is FALSE by default.

ProhibitCJKColumns VARIANT_BOOL

The text in CJK languages can be written vertically as well as horizontally. Setting this property to TRUE tells ABBYY FineReader Engine to ignore the possibility of vertical text and recognize the image with the supposition that all text is arranged horizontally.

This property is valid only for CJK languages.

This property is FALSE by default.

ProhibitDoublePageMode VARIANT_BOOL

This property set to TRUE tells ABBYY FineReader Engine to presume that an image is not a book double page.

This property is FALSE by default.

ProhibitModelAnalysis VARIANT_BOOL

This property is deprecated and will be deleted in future versions. To detect the text blocks, set the EnableTextExtractionMode property to TRUE.

This property is FALSE by default.

CollectPdfExportData VARIANT_BOOL

This property set to TRUE tells FineReader Engine to collect data for PDF export during layout analysis. The collected data is used during export to image-only PDF (PEM_ImageOnly mode) with MRC compression.

Note: With this property set to TRUE, recognition is not supported. The recognized text is not needed to export the document to image-only PDF.

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 CreatePageAnalysisParams 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.

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.