> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PageProcessingParams Object (IPageProcessingParams Interface)

This object is used for tuning different parameters of page preprocessing, layout analysis, recognition, and page synthesis. It comprises child objects of [PagePreprocessingParams](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pagepreprocessingparams), [PageAnalysisParams](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pageanalysisparams), [ObjectsExtractionParams](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/objectsextractionparams), [RecognizerParams](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams), and [SynthesisParamsForPage](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/synthesisparamsforpage) types that are available through the corresponding properties. A pointer to this object is passed to different processing methods along with other parameters.

The PageProcessingParams 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](/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method), and [LoadFromFile](/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)

Windows [SaveToFile](/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method), [LoadFromFile](/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method), [SaveToMemory](/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method), and [LoadFromMemory](/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method).

## Properties

<table><thead><tr><th><p><strong>Name</strong></p></th><th><p><strong>Type</strong></p></th><th><p><strong>Description</strong></p></th></tr></thead><tbody><tr><td><p><strong>Application</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/engine-object-iengine-interface">Engine</a></strong>, <a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">read-only</a></p></td><td><p>Returns the <strong><a href="/fine-reader/engine/api-reference/engine-object-iengine-interface">Engine</a> </strong>object.</p></td></tr><tr><td colspan="3"><p><em>Preprocessing settings</em></p></td></tr><tr><td><p><a name="performpreprocessing" /><strong>PerformPreprocessing</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">VARIANT\_BOOL</a></strong></p></td><td><p>Specifies if page preprocessing is to be performed. Page preprocessing is performed before page analysis and includes correction of orientation, inversion, geometrical distortions. If this property is FALSE, the <strong>PagePreprocessingParams</strong> property is ignored.</p><p>This property is TRUE by default.</p></td></tr><tr><td><p><a name="pagepreprocessingparams" /><strong>PagePreprocessingParams</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pagepreprocessingparams">PagePreprocessingParams</a></strong></p></td><td><p>Provides access to the subset of page processing parameters that affect the process of page preprocessing. Page preprocessing is performed before page analysis and includes correction of orientation, inversion, geometrical distortions.</p><p>These parameters are ignored, if the value of the <strong>PerformPreprocessing</strong> property is FALSE.</p></td></tr><tr><td><p><a name="prohibitcolorobjectsatprocessing" /><strong>ProhibitColorObjectsAtProcessing</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">VARIANT\_BOOL</a></strong></p></td><td><p>Specifies if color objects must be filtered out on the image before layout analysis and recognition. If this property is set to FALSE, the <strong>ColorObjectsProhibitingParams</strong> property is ignored.</p><p>The default value of this property is FALSE.</p></td></tr><tr><td><p><a name="colorobjectsprohibitingparams" /><strong>ColorObjectsProhibitingParams</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/colorobjectsprohibitingparams">ColorObjectsProhibitingParams</a></strong>, <a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">read-only</a></p></td><td><p>Provides access to the parameters of color objects filtering.</p><p>The parameters are only taken into account if the <strong>ProhibitColorObjectsAtProcessing</strong> is set to TRUE.</p></td></tr><tr><td colspan="3"><p><em>Analysis and objects extraction settings</em></p></td></tr><tr><td><p><a name="performanalysis" /><strong>PerformAnalysis</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">VARIANT\_BOOL</a></strong></p></td><td><p>Specifies if page analysis is to be performed. If this property is FALSE, the <strong>PageAnalysisParams</strong> property is ignored.</p><p>This property is TRUE by default.</p><Note>If your license does not support the <a href="/fine-reader/engine/licensing/modules#analysis">Analysis</a> module, the default value of this property is FALSE.</Note></td></tr><tr><td><p><a name="pageanalysisparams" /><strong>PageAnalysisParams</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pageanalysisparams">PageAnalysisParams</a></strong></p></td><td><p>Provides access to the subset of page processing parameters that affect the process of page analysis.</p><p>These parameters are ignored, if the value of the <strong>PerformAnalysis</strong> property is FALSE.</p></td></tr><tr><td><p><a name="objectsextractionparams" /><strong>ObjectsExtractionParams</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/objectsextractionparams">ObjectsExtractionParams</a></strong></p></td><td><p>Provides access to the subset of page processing parameters that affect extraction of objects.</p></td></tr><tr><td colspan="3"><p><em>Recognition and page synthesis settings</em></p></td></tr><tr><td><p><a name="performrecognition" /><strong>PerformRecognition</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">VARIANT\_BOOL</a></strong></p></td><td><p>Specifies if recognition is to be performed. If this property is FALSE, the <strong>RecognizerParams</strong> property is ignored.</p><p>This property is TRUE by default.</p><Note>If your license does not support the <a href="/fine-reader/engine/licensing/modules#recognition">Recognition</a> module, the default value of this property is FALSE.</Note></td></tr><tr><td><p><a name="recognizerparams" /><strong>RecognizerParams</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams">RecognizerParams</a></strong></p></td><td><p>Provides access to the subset of page processing parameters that affect the process of page recognition.</p></td></tr><tr><td><p><a name="synthesisparamsforpage" /><strong>SynthesisParamsForPage</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/synthesisparamsforpage">SynthesisParamsForPage</a></strong></p></td><td><p>Provides access to the subset of page processing parameters that affect the process of page synthesis.</p></td></tr></tbody></table>

## Methods

| Name                                                                                                                                               | Description                                                                                       |
| -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| [CopyFrom](/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method)                              | Initializes properties of the current object with values of similar properties of another object. |
| [LoadFromFile](/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)                                            | Restores the object contents from a file on disk.                                                 |
| [LoadFromMemory](/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method) <br /><br /> **Note:** *Windows only.* | Restores the object contents from the global memory.                                              |
| [SaveToFile](/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)                                                | Saves the object contents into a file on disk.                                                    |
| [SaveToMemory](/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) <br /><br /> **Note:** *Windows only.*     | Saves the object contents into the global memory.                                                 |

## Related objects

<img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/pageprocessingparams.gif?s=4281495e7ab12998b05165a1de94fa93" alt="PageProcessingParams" width="284" height="416" data-path="images/fine-reader/engine/pageprocessingparams.gif" />[](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/fontformattingdetectionparams)[](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/synthesisparamsforpage)[](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pagepreprocessingparams)[](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/documentprocessingparams#pageprocessingparams)[](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/documentprocessingparams)[](/fine-reader/engine/api-reference/language-related-objects/textlanguage)[](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams)[](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/objectsextractionparams)[](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/barcodeparams)[](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/colorobjectsprohibitingparams)[](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/tableanalysisparams)[](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pageanalysisparams)

[Object Diagram](/fine-reader/engine/api-reference/object-diagram)

## Output parameter

This object is the output parameter of the [CreatePageProcessingParams](/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) method of the [Engine](/fine-reader/engine/api-reference/engine-object-iengine-interface) object.

## Input parameter

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

* [PreprocessAnalyzeRecognize](/fine-reader/engine/api-reference/document-related-objects/frpage/preprocessanalyzerecognize-method) method of the [FRPage](/fine-reader/engine/api-reference/document-related-objects/frpage) object
* In Linux and Windows: [Start](/fine-reader/engine/api-reference/batch-processor/batchprocessor/start-method), [ProcessPageAsync](/fine-reader/engine/api-reference/batch-processor/batchprocessor/processpageasync-method) methods of the [BatchProcessor](/fine-reader/engine/api-reference/batch-processor/batchprocessor) object

## Samples

<Accordion title="C# code">
  ```csharp theme={null}
  // We presume the document has already been created and images added
  FREngine.IEngine engine;
  FREngine.IFRDocument frdoc;
  // Create and set up page processing parameters
  FREngine.IPageProcessingParams pParams = engine.CreatePageProcessingParams();
  // We do not want to preprocess the image
  pParams.PerformPreprocessing = false;
  // We want to find barcodes on the image
  pParams.PageAnalysisParams.DetectBarcodes = true;
  ...
  // Use these settings to process the first page of the document
  frDoc.Pages[0].PreprocessAnalyzeRecognize( pParams );
  ... // work with the result
  ```
</Accordion>

The object is used in the following code samples:

* Linux: [CustomLanguage](/fine-reader/engine/guided-tour/samples#customlanguage), [CommandLineInterface](/fine-reader/engine/guided-tour/samples#commandlineinterface)
* Windows: [CustomLanguage](/fine-reader/engine/guided-tour/samples#customlanguage), [CommandLineInterface](/fine-reader/engine/guided-tour/samples#commandlineinterface); and demo tools: [BatchProcessingRecognition](/fine-reader/engine/guided-tour/samples#batchprocessingrecognition), [MultiProcessingRecognition](/fine-reader/engine/guided-tour/samples#multiprocessingrecognition), [PDFExportProfiles](/fine-reader/engine/guided-tour/samples#pdfexportprofiles), [User Pattern Training Utility](/fine-reader/engine/guided-tour/samples#user_pattern_training_utility)

## See also

[Tuning Parameters of Preprocessing, Analysis, Recognition, and Synthesis](/fine-reader/engine/guided-tour/advanced-techniques/tuning-parameters-of-preprocessing-analysis-recognition-and-synthesis)

[Working with Properties](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)