ABBYY FineReader Engine AI and 12 Compatibility
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.
In addition, the whole Document Comparison API is temporarily not functional because of the image preprocessing changes. We are working to restore it as soon as possible.
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.
Engine object
| Property/Method/Constant | What has happened? | Comment |
|---|---|---|
| CreateOrientationDetectionParams | Removed | The OrientationDetectionParams object was removed. |
| FREngineModuleEnum::FREM_RecognizerHP | Renamed | 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. |
| LoadPredefinedProfile | Supported parameters changed |
The following profiles were removed:
The DocumentConversion_Speed profile was replaced with DocumentConversion_Normal. |
Image-related objects
| Object/Enumeration | Property/Method/Constant | What has happened? | Comment |
|---|---|---|---|
| ImageDocument | PreviewImage | Renamed, behavior changed |
Use the GetPreviewImage and GetPreviewImageSpecificSize methods instead. The preview is no longer created during image preparation. The preview image of the required size will be created when you first call the method, which may take some time. |
| CorrectSkew | Parameter removed | The CorrectSkewFlags parameter has been removed. The automatic skew correction has been improved and needs no additional tuning. | |
| SaveImageRegionTo | Parameter removed | The PrepareMode parameter has been removed. The image is saved as is. | |
| IsModified | Renamed | This property is now called HasUnsavedData. | |
| Behavior changed | These properties now show image modifications from the original image instead of only the modifications after the ImageDocument was last saved. | ||
| CoordinatesConverter | ConvertCoordinates | Behavior changed | You can now convert coordinates to or from the preview image plane only if it has already been created and hasn't been reset by additional image modifications. |
| PrepareImageMode | RasterizeFreeText | Default value changed | The default value of this property is now TRUE, to avoid accidental loss of Free Text annotations in PDF files. |
|
AutoOverwriteResolution OverwriteResolution XResolutionToOverwrite YResolutionToOverwrite |
Moved to another object |
Use the OverwriteResolutionMode and ResolutionToOverwrite properties of the PagePreprocessingParams object instead. | |
|
BackgroundFillingColor BinarizationThreshold InvertImage MirrorImage Rotation |
Removed | These settings for preparing images now function automatically, and you don't need to adjust them yourself now. | |
|
CorrectSkew CorrectSkewMode |
Removed | Use the CorrectSkew property of the PagePreprocessingParams object instead. | |
|
CreatePreview PreviewHeight PreviewWidth |
Removed | The preview is no longer created at image preprocessing stage. If you need a preview image, call the GetPreviewImage / GetPreviewImageSpecificSize method of the ImageDocument object. It will create the preview image on demand, which may take more time than before. | |
|
DiscardColorImage UseFastBinarization |
Moved to another object | Use the same properties in the PagePreprocessingParams object instead. | |
| EnhanceLocalContrast | Removed | Use the EnhanceLocalContrast method of the ImageDocument object. | |
| KeepOriginalCoordinatesInfo | Removed | This property was already deprecated since Release 1. | |
| PhotoProcessingMode | Renamed, behavior changed | The ImageSourceType property is now used to specify where the image is taken from. It includes more than photos vs non-photos distinction. | |
| ImageModification |
AddRemoveGarbageRegion ClearRemoveGarbageRegions |
Removed | Automatic image preprocessing improved significantly, so there is no need for manual modifications. |
| CorrectSkewModeEnum | Removed | The properties that used this enumeration were removed. | |
| PhotoProcessingModeEnum | Removed | The enumeration was replaced with the ImageSourceTypeEnum enumeration, which has more constants for various source types. | |
| RemoveGarbageRegionFlags | Removed | The method that used this enumeration was removed. |
Document-related objects
| Object/Enumeration | Property/Method/Constant | What has happened? | Comment |
|---|---|---|---|
| FRDocument | Parameter removed | The SplittingParams parameter was removed, as the page splitting parameters are now part of PreprocessingParams. | |
| Behavior changed | These methods no longer allow duplicates in the PageIndices input parameter. To add the same page from an image file to the document, call the method repeatedly. | ||
| SourceHasTextualContent | Deleted | This property was deprecated and has now been deleted. Use the CheckTextLayer method to find out if a file has textual content. | |
| FRPage | Preprocess | Parameter removed | The SplittingParams parameter was removed, as the page splitting parameters are now part of PreprocessingParams. |
| DetectOrientation | Parameter removed | The OrientationParams parameter was removed. Orientation is now corrected automatically. | |
| CorrectGeometricalDistortions | Removed | Use the IImageDocument::RemoveGeometricalDistortions method instead. |
Batch Processor
| Property/Method/Constant | What has happened? | Comment |
|---|---|---|
| Start | Parameter removed | The SplittingParams parameter was removed, as the page splitting parameters are now part of ProcessingParams. |
Text-related objects
| Object/Enumeration | Property/Method/Constant | What has happened? | Comment |
|---|---|---|---|
| PlainText | 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 property that provides an estimate of the probability of error in the specified character. |
| 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 property of the 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 | 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. |
Mechanism objects
| Object/Enumeration | Property/Method/Constant | What has happened? | Comment |
|---|---|---|---|
| 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. |
Parameter objects
| Object/Enumeration | Property/Method/Constant | What has happened? | Comment |
|---|---|---|---|
| PagePreprocessingParams |
ApplySigmaFilter CorrectShadowsAndHighlights |
Removed | Use the corresponding methods of the ImageDocument object instead. |
| CorrectInvertedImage | Removed | These settings for preparing images now function automatically, and you don't need to adjust them yourself now. | |
| CorrectSkewMode | Removed | Now all settings are specified via the CorrectSkew property of the same object. | |
| CorrectResolution | Removed | Use the OverwriteResolutionMode and ResolutionToOverwrite properties instead. | |
|
CorrectOrientation OrientationDetectionParams |
Removed | Now all settings are specified via the CorrectOrientationMode property of the same object. | |
| PageAnalysisParams |
EnableExhaustiveAnalysisMode ProhibitModelAnalysis |
Removed | These properties were deprecated in the previous version. |
|
EnableTextExtractionMode AggressiveTableDetection |
Removed | Layout analysis mechanisms were improved significantly and don't need such fine-grained settings to be set manually. | |
| DetectMultipleBusinessCards | Removed | A page with several business cards can still be split using the SplitPages method of the FRDocument object. | |
|
OrientationDetectionParams OrientationDetectionModeEnum |
Removed | The settings of orientation correction are now provided by the CorrectOrientationModeEnum. | |
| DocumentProcessingParams | SplittingParams | Moved to another object | Set up page splitting parameters in the PagePreprocessingParams object instead. |
| RecognizerParams | ExactConfidenceCalculation | Deprecated | This property no longer affects confidence calculation and is scheduled to be removed. |
| TextBlockAnalysisParams | AutodetectInversion | Removed | Text inversion will be detected during layout analysis without any additional settings. |
License-related objects
| Object/Enumeration | Property/Method/Constant | What has happened? | Comment |
|---|---|---|---|
| AvailableEngineModulesFlags | AEM_CyrillicHandprint | Removed | Handprinted and handwritten recognition is now available by default and not protected by any license flags. |
| AvailableTextTypesFlags | ATT_Handprinted | Removed |
11/7/2025 12:48:30 PM