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. |
| AnalysisMode | PageAnalysisModeEnum |
Specifies layout analysis mode. For documents with tables, complex layouts, or many different objects to be extracted, we recommend setting this property to PAM_TextExtraction. The default value is PAM_DocumentConversion. |
| 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. |
| SpeedQualityMode | SpeedQualityModeEnum |
This property manages the balance between analysis accuracy and speed. You may need the SQM_Accurate setting when processing documents with complex backgrounds or watermarks. The default value is SQM_Fast. |
| DetectHandwritten | VARIANT_BOOL |
This property set to TRUE enables detection of handwritten text. Handwritten text can only be detected if the SpeedQualityMode property is set to SQM_Accurate, otherwise this setting is ignored. This property is FALSE by default. |
| 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. |
| 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. |
| DetectCheckmarks | VARIANT_BOOL |
If this property is TRUE, checkmarks are detected during layout analysis. This property is FALSE by default. |
| DetectSeparators | VARIANT_BOOL |
If this property is TRUE, separators are detected during layout analysis. This property is TRUE by default. |
| DetectPictures | VARIANT_BOOL |
If this property is TRUE, 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. |
| DetectStamps | VARIANT_BOOL |
If this property is TRUE, stamps are detected during layout analysis and put into blocks of BT_RasterPicture type. The text on the detected stamps will not be recognized. Stamps can only be detected if the SpeedQualityMode property is set to SQM_Accurate, otherwise this setting is ignored. This property is FALSE by default. |
| Additional settings | ||
| 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.
The default value of this property is PSDM_Auto. |
| 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. |
| 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. |
| 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.
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

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:
- Analyze, AnalyzePages method of the FRDocument object
- Analyze, AnalyzeRegion, AnalyzeTable method of the FRPage object
Samples
The object is used in the following code samples: CommandLineInterface.
See also
Tuning Parameters of Preprocessing, Analysis, Recognition, and Synthesis
11/7/2025 12:48:30 PM
