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

# ABBYY FineReader Engine AI and 12 Compatibility

> Compatibility changes between ABBYY FineReader Engine AI and 12 — streamlined image preprocessing settings; remove obsolete options before recompiling.

ABBYY FineReader Engine AI brings improvements to image preprocessing. The settings are more streamlined and work better out of the box, without any additional tuning on your side.

The code of FineReader Engine AI will not be binary compatible with previous versions, so you will need to recompile your application. Please also review your application code and remove the settings which are no longer supported. See the full list below.

<Accordion title="Engine object">
  <table><thead><tr><th><p><strong>Property/Method/Constant</strong></p></th><th><p><strong>What has happened?</strong></p></th><th><p><strong>Comment</strong></p></th></tr></thead><tbody><tr><td><p><strong>CreateOrientationDetectionParams</strong></p></td><td><p>Removed</p></td><td><p>The <strong>OrientationDetectionParams</strong> object was removed.</p></td></tr><tr><td><p><strong><a href="/fine-reader/engine/api-reference/enumerations/frenginemoduleenum">FREngineModuleEnum::FREM\_RecognizerHP</a></strong></p></td><td><p>Renamed</p></td><td><p>This constant is now called FREM\_ICR, and the module has been renamed to ICR. This module warms up processing not only for handprinted texts, but also for handwriting, and loads the resources required for analysis as well as recognition.</p></td></tr><tr><td><p><strong><a href="/fine-reader/engine/api-reference/engine-object-iengine-interface/supplementary-methods/loadpredefinedprofile-method">LoadPredefinedProfile</a></strong></p></td><td><p>Supported parameters changed</p></td><td><p>The following profiles were removed:</p><ul><li>BookArchiving\_Accuracy</li><li>BookArchiving\_Speed</li><li>Version9Compatibility</li></ul><p>The DocumentConversion\_Speed profile was replaced with DocumentConversion\_Normal.</p></td></tr></tbody></table>
</Accordion>

| <img src="https://mintcdn.com/abbyy/lsETHFYUFiongXSm/images/fine-reader/engine/hmtoggle_plus1.gif?s=98fcb049cbc5c3814a758240a8c3f612" alt="hmtoggle_plus1" width="16" height="16" data-path="images/fine-reader/engine/hmtoggle_plus1.gif" /> | [Image-related objects](javascript:HMToggle\('toggle','TOGGLE0186A2','TOGGLE0186A2_ICON'\)) |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |

### Object/Enumeration

* [ImageDocument](/fine-reader/engine/api-reference/image-related-objects/imagedocument)

### Property/Method/Constant

### What has happened?

### Comment

* [ConvertCoordinates](/fine-reader/engine/api-reference/image-related-objects/coordinatesconverter/convertcoordinates-method)

* [PrepareImageMode](/fine-reader/engine/api-reference/image-related-objects/prepareimagemode)

* [RasterizeFreeText](/fine-reader/engine/api-reference/image-related-objects/prepareimagemode)

* AutoOverwriteResolution

* OverwriteResolution

* XResolutionToOverwrite

* YResolutionToOverwrite

* BackgroundFillingColor

* BinarizationThreshold

* InvertImage

* MirrorImage

* Rotation

* CorrectSkew

* CorrectSkewMode

* CreatePreview

* PreviewHeight

* PreviewWidth

* DiscardColorImage

* UseFastBinarization

* EnhanceLocalContrast

* KeepOriginalCoordinatesInfo

* PhotoProcessingMode

* [ImageModification](/fine-reader/engine/api-reference/image-related-objects/imagemodification)

* AddRemoveGarbageRegion

* ClearRemoveGarbageRegions

* CorrectSkewModeEnum

* PhotoProcessingModeEnum

* RemoveGarbageRegionFlags

<Accordion title="Document-related objects">
  <table><thead><tr><th><p><strong>Object/Enumeration</strong></p></th><th><p><strong>Property/Method/Constant</strong></p></th><th><p><strong>What has happened?</strong></p></th><th><p><strong>Comment</strong></p></th></tr></thead><tbody><tr><td rowspan="3"><p><strong><a href="/fine-reader/engine/api-reference/document-related-objects/frdocument">FRDocument</a></strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/document-related-objects/frdocument/preprocess-method">Preprocess</a></strong></p><p><strong><a href="/fine-reader/engine/api-reference/document-related-objects/frdocument/preprocesspages-method">PreprocessPages</a></strong></p></td><td><p>Parameter removed</p></td><td><p>The <em>SplittingParams</em> parameter was removed, as the page splitting parameters are now part of <em>PreprocessingParams</em>.</p></td></tr><tr><td><p><strong><a href="/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefile-method">AddImageFile</a></strong></p><p><strong><a href="/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefilefromattachment-method">AddImageFileFromAttachment</a></strong></p><p><strong><a href="/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefilefrommemory-method">AddImageFileFromMemory</a></strong></p><p><strong><a href="/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefilefromstream-method">AddImageFileFromStream</a></strong></p><p><strong><a href="/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefilewithpassword-method">AddImageFileWithPassword</a></strong></p><p><strong><a href="/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefilewithpasswordcallback-method">AddImageFileWithPasswordCallback</a></strong></p></td><td><p>Behavior changed</p></td><td><p>These methods no longer allow duplicates in the <em>PageIndices</em> input parameter. To add the same page from an image file to the document, call the method repeatedly.</p></td></tr><tr><td><p><strong>SourceHasTextualContent</strong></p></td><td><p>Deleted</p></td><td><p>This property was deprecated and has now been deleted. Use the <strong><a href="/fine-reader/engine/api-reference/document-related-objects/frdocument/checktextlayer-method">CheckTextLayer</a></strong> method to find out if a file has textual content.</p></td></tr><tr><td rowspan="3"><p><strong><a href="/fine-reader/engine/api-reference/document-related-objects/frpage">FRPage</a></strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/document-related-objects/frpage/preprocess-method">Preprocess</a></strong></p></td><td><p>Parameter removed</p></td><td><p>The <em>SplittingParams</em> parameter was removed, as the page splitting parameters are now part of <em>PreprocessingParams</em>.</p></td></tr><tr><td><p><strong><a href="/fine-reader/engine/api-reference/document-related-objects/frpage/detectorientation-method">DetectOrientation</a></strong></p></td><td><p>Parameter removed</p></td><td><p>The <em>OrientationParams</em> parameter was removed. Orientation is now corrected automatically.</p></td></tr><tr><td><p><strong>CorrectGeometricalDistortions</strong></p></td><td><p>Removed</p></td><td><p>Use the <strong>IImageDocument::RemoveGeometricalDistortions</strong> method instead.</p></td></tr></tbody></table>
</Accordion>

<Accordion title="Batch Processor">
  | Property/Method/Constant                                                               | What has happened? | Comment                                                                                                       |
  | -------------------------------------------------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------- |
  | [Start](/fine-reader/engine/api-reference/batch-processor/batchprocessor/start-method) | Parameter removed  | The SplittingParams parameter was removed, as the page splitting parameters are now part of ProcessingParams. |
</Accordion>

<Accordion title="Text-related objects">
  | Object/Enumeration                                                                                                | Property/Method/Constant                                                                                            | What has happened? | Comment                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
  | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | [PlainText](/fine-reader/engine/api-reference/text-related-objects/plaintext)                                     | [CharConfidence](/fine-reader/engine/api-reference/text-related-objects/plaintext/charconfidence-property)          | Behavior changed   | This property now returns values from 0 to 55, and in cases of undefined confidence may return a negative value as before. To get a probability-like value from 0 to 100, use the [ErrorProbability](/fine-reader/engine/api-reference/text-related-objects/plaintext/errorprobability-property) property that provides an estimate of the probability of error in the specified character.                                                                                                                                                                                                    |
  | [CharacterRecognitionVariant](/fine-reader/engine/api-reference/text-related-objects/characterrecognitionvariant) | [CharConfidence](/fine-reader/engine/api-reference/text-related-objects/characterrecognitionvariant#charconfidence) | Behavior changed   | This property now returns values from 0 to 55, and in cases of undefined confidence may return a negative value as before. To get a probability-like value from 0 to 100, use the [ErrorProbability](/fine-reader/engine/api-reference/text-related-objects/charparams#errorprobability) property of the [CharParams](/fine-reader/engine/api-reference/text-related-objects/charparams) object. It provides an estimate of the probability of error in the specified character, and it can only be calculated for the result of recognition in context, not for each of recognition variants. |
  | [BarcodeSymbol](/fine-reader/engine/api-reference/text-related-objects/barcodesymbol)                             | [CharConfidence](/fine-reader/engine/api-reference/text-related-objects/barcodesymbol#charconfidence)               | Behavior changed   | This property now returns values from 0 to 55, and in cases of undefined confidence may return a negative value as before.                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
</Accordion>

<Accordion title="Mechanism objects">
  | Object/Enumeration                                                                       | Property/Method/Constant | What has happened? | Comment                                                                                                                                                                  |
  | ---------------------------------------------------------------------------------------- | ------------------------ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | [ExportFileWriter](/fine-reader/engine/api-reference/mechanism-objects/exportfilewriter) |                          | Deprecated         | This object has been deprecated and will be removed in future versions. We no longer recommend using session export, because regular export speed is the same or faster. |
</Accordion>

<Accordion title="Parameter objects">
  <table><thead><tr><th><p><strong>Object/Enumeration</strong></p></th><th><p><strong>Property/Method/Constant</strong></p></th><th><p><strong>What has happened?</strong></p></th><th><p><strong>Comment</strong></p></th></tr></thead><tbody><tr><td rowspan="5"><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><strong>ApplySigmaFilter</strong></p><p><strong>CorrectShadowsAndHighlights</strong></p></td><td><p>Removed</p></td><td><p>Use the corresponding methods of the <strong><a href="/fine-reader/engine/api-reference/image-related-objects/imagedocument">ImageDocument</a></strong> object instead.</p></td></tr><tr><td><p><strong>CorrectInvertedImage</strong></p></td><td><p>Removed</p></td><td><p>These settings for preparing images now function automatically, and you don't need to adjust them yourself now.</p></td></tr><tr><td><p><strong>CorrectSkewMode</strong></p></td><td><p>Removed</p></td><td><p>Now all settings are specified via the <strong><a href="/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pagepreprocessingparams#correctskew">CorrectSkew</a></strong> property of the same object.</p></td></tr><tr><td><p><strong>CorrectResolution</strong></p></td><td><p>Removed</p></td><td><p>Use the <strong><a href="/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pagepreprocessingparams#overwriteresolutionmode">OverwriteResolutionMode</a></strong> and <strong><a href="/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pagepreprocessingparams#resolutiontooverwrite">ResolutionToOverwrite</a></strong> properties instead.</p></td></tr><tr><td><p><strong>CorrectOrientation</strong></p><p><strong>OrientationDetectionParams</strong></p></td><td><p>Removed</p></td><td><p>Now all settings are specified via the <strong><a href="/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pagepreprocessingparams#correctorientationmode">CorrectOrientationMode</a></strong> property of the same object.</p></td></tr><tr><td rowspan="3"><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><strong>EnableExhaustiveAnalysisMode</strong></p><p><strong>ProhibitModelAnalysis</strong></p></td><td><p>Removed</p></td><td><p>These properties were deprecated in the previous version.</p></td></tr><tr><td><p><strong>EnableTextExtractionMode</strong></p><p><strong>AggressiveTableDetection</strong></p></td><td><p>Removed</p></td><td><p>Layout analysis mechanisms were improved significantly and don't need such fine-grained settings to be set manually.</p></td></tr><tr><td><p><strong>DetectMultipleBusinessCards</strong></p></td><td><p>Removed</p></td><td><p>A page with several business cards can still be split using the <strong><a href="/fine-reader/engine/api-reference/document-related-objects/frdocument/splitpages-method">SplitPages</a></strong> method of the <strong><a href="/fine-reader/engine/api-reference/document-related-objects/frdocument">FRDocument</a></strong> object.</p></td></tr><tr><td><p><strong>OrientationDetectionParams</strong></p><p><strong>OrientationDetectionModeEnum</strong></p></td><td /><td><p>Removed</p></td><td><p>The settings of orientation correction are now provided by the <strong><a href="/fine-reader/engine/api-reference/enumerations/correctorientationmodeenum">CorrectOrientationModeEnum</a></strong>.</p></td></tr><tr><td><p><strong><a href="/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/documentprocessingparams">DocumentProcessingParams</a></strong></p></td><td><p><strong>SplittingParams</strong></p></td><td><p>Moved to another object</p></td><td><p>Set up page splitting parameters in the <strong><a href="/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pagepreprocessingparams">PagePreprocessingParams</a></strong> object instead.</p></td></tr><tr><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><strong><a href="/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams#exactconfidencecalculation">ExactConfidenceCalculation</a></strong></p></td><td><p>Deprecated</p></td><td><p>This property no longer affects confidence calculation and is scheduled to be removed.</p></td></tr><tr><td><p><strong><a href="/fine-reader/engine/api-reference/layout-related-objects/textblockanalysisparams">TextBlockAnalysisParams</a></strong></p></td><td><p><strong>AutodetectInversion</strong></p></td><td><p>Removed</p></td><td><p>Text inversion will be detected during layout analysis without any additional settings.</p></td></tr></tbody></table>
</Accordion>

<Accordion title="License-related objects">
  <table><thead><tr><th><p><strong>Object/Enumeration</strong></p></th><th><p><strong>Property/Method/Constant</strong></p></th><th><p><strong>What has happened?</strong></p></th><th><p><strong>Comment</strong></p></th></tr></thead><tbody><tr><td><p><strong><a href="/fine-reader/engine/api-reference/enumerations/availableenginemodulesflags">AvailableEngineModulesFlags</a></strong></p></td><td><p>AEM\_CyrillicHandprint</p></td><td><p>Removed</p></td><td rowspan="2"><p>Handprinted and handwritten recognition is now available by default and not protected by any license flags.</p></td></tr><tr><td><p><strong><a href="/fine-reader/engine/api-reference/enumerations/availabletexttypesflags">AvailableTextTypesFlags</a></strong></p></td><td><p>ATT\_Handprinted</p></td><td><p>Removed</p></td></tr></tbody></table>
</Accordion>