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

# SynthesisParamsForPage Object (ISynthesisParamsForPage Interface)

This object is used for setting up the parameters of the page synthesis. Particularly, it allows you to specify the parameters of text and background color detection.

The SynthesisParamsForPage 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>Engine</strong> object.</p></td></tr><tr><td colspan="3"><p><em>Main settings</em></p></td></tr><tr><td><p><a name="businesscardsynthesisparams" /><strong>BusinessCardSynthesisParams</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/businesscardsynthesisparams">BusinessCardSynthesisParams</a></strong></p></td><td><p>Specifies parameters of business card synthesis.</p><Warning>This property must be specified when creating a recognition language in any way except the <a href="/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams/setpredefinedtextlanguage-method">SetPredefinedTextLanguage</a> method of the <a href="/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams">RecognizerParams</a> object.</Warning></td></tr><tr><td><p><a name="detectdocumentlinks" /><strong>DetectDocumentLinks</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>If this property is set to TRUE, document references (e.g., cross-references) are detected during page synthesis.</p><p>This property is set to TRUE by default.</p></td></tr><tr><td><p><a name="detectfontformattingatpagelevel" /><strong>DetectFontFormattingAtPageLevel</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>If this property is set to TRUE, font parameters are detected at the stage of page synthesis. This property set to TRUE enables detection of subscripts, superscripts, italic-face type, small capital letters at the stage of page synthesis and allows you to set additional parameters using <strong>FontFormattingDetectionParams</strong> property. If this property is FALSE, the <strong>FontFormattingDetectionParams</strong> property is ignored.</p><Warning>With the default settings, ABBYY FineReader Engine 12 detects font parameters at the stage of document synthesis. If you set the value of this property to TRUE, you must turn off detection of font parameters during document synthesis. To do this, set the <a href="/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/synthesisparamsfordocument#detectfontformatting">ISynthesisParamsForDocument::DetectFontFormatting</a> property to FALSE. Detection of font parameters during page synthesis enables the program to speed up the subsequent document synthesis and decrease memory usage. However, the quality of font detection may deteriorate.</Warning><p>This property is set to FALSE by default.</p></td></tr><tr><td><p><a name="detecthyperlinks" /><strong>DetectHyperlinks</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>If this property is set to TRUE, hyperlinks are detected during page synthesis.</p><p>This property is set to TRUE by default.</p></td></tr><tr><td><p><a name="fontformattingdetectionparams" /><strong>FontFormattingDetectionParams</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/fontformattingdetectionparams">FontFormattingDetectionParams</a></strong></p></td><td><p>Specifies additional parameters of font formatting detection at the stage of page synthesis.</p><p>This property is used, only if the <strong>DetectFontFormattingAtPageLevel</strong> property is set to TRUE.</p></td></tr><tr><td><p><a name="paragraphextractionmode" /><strong>ParagraphExtractionMode</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/enumerations/paragraphextractionmodeenum">ParagraphExtractionModeEnum</a></strong></p></td><td><p>Specifies the mode of paragraph extraction.</p><p>The default mode is PEM\_NormalExtraction.</p></td></tr><tr><td><p><a name="savecharactercoordinatesforallvariants" /><strong>SaveCharacterCoordinatesForAllVariants</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 the character coordinates should be saved for all the recognition variants. By default, the symbol coordinates are available only for the first recognition variant, i.e., the one actually chosen.</p><p>To access the character coordinates when this property is TRUE, use the <strong><a href="/fine-reader/engine/api-reference/text-related-objects/wordrecognitionvariant/getcharparams-method">GetCharParams</a></strong> method of the <strong><a href="/fine-reader/engine/api-reference/text-related-objects/wordrecognitionvariant">WordRecognitionVariant</a></strong> object to receive the <strong><a href="/fine-reader/engine/api-reference/text-related-objects/charparams">CharParams</a></strong> object for the character; its <strong>Top</strong>, <strong>Left</strong>, <strong>Right</strong>, <strong>Bottom</strong> properties contain the coordinates.</p><p>Turning this setting on makes sense only if <strong><a href="/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams#savewordrecognitionvariants">IRecognizerParams::SaveWordRecognitionVariants</a></strong> is TRUE.</p><p>The default value of this property is FALSE.</p></td></tr><tr><td><p><a name="synthesizebusinesscards" /><strong>SynthesizeBusinessCards</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>If this property is set to TRUE, FineReader Engine tries to find business cards on the page and fills in the collections of business cards of the document and of each page (<strong><a href="/fine-reader/engine/api-reference/document-related-objects/frdocument#businesscards">IFRDocument::BusinessCards</a></strong>, <strong><a href="/fine-reader/engine/api-reference/document-related-objects/frpage#businesscards">IFRPage::BusinessCards</a></strong>).</p><p>This property is set to FALSE by default.</p></td></tr><tr><td colspan="3"><p><em>Color settings</em></p></td></tr><tr><td><p><a name="detectbackgroundcolor" /><strong>DetectBackgroundColor</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/enumerations/threestatepropertyvalueenum">ThreeStatePropertyValueEnum</a></strong></p></td><td><p>If this property is set to TSPV\_Yes, the background color is detected during page synthesis.</p><p>This property is set to TSPV\_Auto by default.</p></td></tr><tr><td><p><a name="allowgraybackgroundcolor" /><strong>AllowGrayBackgroundColor</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/enumerations/threestatepropertyvalueenum">ThreeStatePropertyValueEnum</a></strong></p></td><td><p>If this property is set to TSPV\_Yes, the gray color is detected for background. Otherwise, background will be detected as black or white.</p><p>The value of this property is taken into account only if the <strong>DetectBackgroundColor </strong>property is set to TSPV\_Yes or TSPV\_Auto.</p><p>The default value of this property is TSPV\_Auto.</p></td></tr><tr><td><p><a name="detecttextcolor" /><strong>DetectTextColor</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/enumerations/threestatepropertyvalueenum">ThreeStatePropertyValueEnum</a></strong></p></td><td><p>If this property is set to TSPV\_Yes, the text color is detected during page synthesis.</p><p>This property is set to TSPV\_Auto by default.</p></td></tr><tr><td><p><a name="allowgraytextcolor" /><strong>AllowGrayTextColor</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/enumerations/threestatepropertyvalueenum">ThreeStatePropertyValueEnum</a></strong></p></td><td><p>If this property is set to TSPV\_Yes, the gray color is detected for text. Otherwise, text will be detected as black or white.</p><p>The value of this property is taken into account only if the <strong>DetectTextColor </strong>property is set to TSPV\_Yes or TSPV\_Auto.</p><p>The default value of this property is TSPV\_Auto.</p></td></tr><tr><td><p><a name="correctdynamicrange" /><strong>CorrectDynamicRange</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/enumerations/threestatepropertyvalueenum">ThreeStatePropertyValueEnum</a></strong></p></td><td><p>If this property is set to TSPV\_Yes, image colors will be corrected so that the background is white and the text is black, or vice versa, which improves image quality. Recognition, however, will slow down.</p><p>We recommend using this property only if the <strong>DetectBackgroundColor</strong> and <strong>DetectTextColor</strong> properties are set to TSPV\_Yes or TSPV\_Auto.</p><p>This property is set to TSPV\_Auto by default.</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/synthesisparamsforpage.gif?s=8ba3b11ad3d7ef459eb7367b27b73afa" alt="SynthesisParamsForPage" width="199" height="122" data-path="images/fine-reader/engine/synthesisparamsforpage.gif" />[](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/synthesisparamsforpage#businesscardsynthesisparams)[](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/businesscardsynthesisparams)[](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/synthesisparamsforpage#fontformattingdetectionparams)[](/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/pageprocessingparams)

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

## Output parameter

This object is the output parameter of the [CreateSynthesisParamsForPage](/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:

* [Recognize](/fine-reader/engine/api-reference/document-related-objects/frdocument/recognize-method), [RecognizePages](/fine-reader/engine/api-reference/document-related-objects/frdocument/recognizepages-method) of the [FRDocument](/fine-reader/engine/api-reference/document-related-objects/frdocument) object
* [Recognize](/fine-reader/engine/api-reference/document-related-objects/frpage/recognize-method), [RecognizeBlocks](/fine-reader/engine/api-reference/document-related-objects/frpage/recognizeblocks-method) of the [FRPage](/fine-reader/engine/api-reference/document-related-objects/frpage) object

## Samples

The object is used in the following code samples:

* Linux: [CommandLineInterface](/fine-reader/engine/guided-tour/samples#commandlineinterface)
* Windows: [CommandLineInterface](/fine-reader/engine/guided-tour/samples#commandlineinterface), [VisualComponents](/fine-reader/engine/guided-tour/samples#visualcomponents); and demo tools: [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)

[SynthesisParamsForDocument](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/synthesisparamsfordocument)

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