Compatibilité entre ABBYY FineReader Engine 12 et 11

ABBYY FineReader Engine 12 n’est pas compatible au niveau binaire avec ABBYY FineReader Engine 11. Les applications compilées à l’aide d’ABBYY FineReader Engine 11 doivent être recompilées avec les fichiers d’en-tête et la bibliothèque d’ABBYY FineReader Engine 12. Certaines modifications du code source peuvent être nécessaires en raison des améliorations apportées à l’API d’ABBYY FineReader Engine.

Cet article contient la liste complète des modifications, ainsi que des suggestions pour adapter votre code afin qu’il fonctionne avec la nouvelle version.

Principales modifications :

• Les objets obsolètes DocumentAnalyzer et Exporter ont été supprimés, ainsi que les méthodes de traitement de l’objet Engine. Utilisez les méthodes plus efficaces des objets FRDocument et FRPage, qui prennent en charge toutes les informations nécessaires au traitement complet des documents. Vous n’avez plus besoin de gérer l’objet DocumentInfo à toutes les étapes du traitement, de suivre toutes les images de document avec les mises en page correspondantes, ni d’implémenter l’interface IRecognizedPages.

• L’API qui donnait accès à la structure logique du document (DocumentStructure, PageStructure et leurs sous-objets) a été supprimée. La modification des propriétés et du contenu du document via les objets supprimés pouvait entraîner des résultats imprévisibles lors de l’export. Si vous devez vérifier ou post-traiter les résultats de la reconnaissance, travaillez avec les données du sous-objet Layout de chaque FRPage, puis appelez l’une des méthodes qui effectuent la synthèse de documents une fois cette opération terminée. La structure logique du document sera alors recréée et utilisée lors de l’export, bien qu’elle ne soit plus disponible pour modification via l’API FineReader Engine. Les futures versions d’ABBYY FineReader Engine pourront fournir un accès en lecture seule à certains éléments de la structure logique du document.

• L’API de classification a été entièrement remplacée par une nouvelle version, qui utilise des algorithmes améliorés et propose des techniques intégrées de validation croisée.

• L’objet Engine doit désormais être chargé via la fonction InitializeEngine. Les fonctions GetEngineObject et GetEngineObjectEx, utilisées pour charger Engine, ont été supprimées d’ABBYY FineReader Engine.

  Objet Engine

  Propriété/Méthode/Constante	Que s’est-il passé ?	Commentaire
  CreateDocumentAnalyzer CreateDocumentInfo CreateExporter	Supprimés	Ces méthodes ne sont plus nécessaires, car les objets qu’elles créaient ont été supprimés.
  CreateExportFileWriter	Signature modifiée	Le paramètre PagesCount obsolète a été supprimé.
  CreateImageDocumentsInMemory Remarque : Windows uniquement.	Supprimé	Les documents image sont toujours créés en mémoire. Vous pouvez utiliser les méthodes SaveTo ou SaveToFile lorsque vous devez enregistrer le document image sur le disque.
  CreateLayout	Supprimé	L’objet Layout ne peut plus être utilisé indépendamment de la page à laquelle il correspond.
  CreateMultipageImageWriter	Comportement modifié	Cette méthode accepte désormais des paramètres étendus d’enregistrement des images aux formats JPEG et TIFF.
  CreateMultipageImageWriterEx	Renommé	Cette méthode s’appelle désormais CreateMultipageImageWriter. L’ancienne implémentation de la méthode CreateMultipageImageWriter a été retirée.
  ExportPage	Supprimé	Utilisez plutôt la méthode IFRPage::Export.
  ExportPagesEx	Supprimé	Utilisez plutôt la méthode IFRDocument::Export.
  InjectTextLayer	Comportement modifié	Cette méthode fournit désormais des paramètres supplémentaires pour l’injection de la couche de texte, ainsi que la possibilité de sélectionner les pages du fichier PDF à traiter et une interface de rappel pour gérer les avertissements et les erreurs.
  InjectTextLayerEx InjectTextLayerEx2	Supprimé	La nouvelle version de la méthode InjectTextLayer offre désormais toutes les options qui étaient auparavant disponibles dans ces méthodes.
  OpenImageFile	Supprimé	Utilisez la méthode IFRDocument::AddImageFile pour ouvrir un fichier image et l’ajouter au document en vue de son traitement. L’objet ImageDocument sera accessible via la FRPage correspondante.
  PrepareImageFile	Supprimé	Utilisez la méthode IFRDocument::AddImageFile pour ouvrir un fichier image et l’ajouter au document en vue de son traitement. L’objet ImageDocument sera accessible via la FRPage correspondante et pourra ensuite être enregistré sur le disque.
  ProcessPage	Supprimé	Utilisez plutôt la méthode IFRDocument::Process.
  ProcessPagesEx	Supprimé	Utilisez la méthode IFRDocument::Process à la place.
  SynthesizePagesEx	Supprimé	Utilisez plutôt la méthode IFRDocument::Synthesize.
  OpenMemoryImageFormat10	Supprimé	Cette méthode était fournie uniquement à des fins de compatibilité avec ABBYY FineReader Engine 10.
  OpenBitmap OpenBitmapBits OpenDib PrepareBitmap PrepareBitmapBits PrepareDib	Obsolète sur Linux et macOS	Ces propriétés sont désormais déconseillées et seront supprimées dans de futures versions.

  Engine pour Java

  | Méthode | Que s’est-il passé ? | Commentaire | | ----------- | ------------------ | -------------------------------------------------------- | | Load LoadEx | Supprimées | Méthodes obsolètes ; utilisez plutôt Engine.InitializeEngine. |

  Objets liés à l’image

  		Supprimé	Utilisez plutôt la méthode, qui permet de supprimer en une seule fois des objets de plusieurs teintes spécifiées et d’obtenir également l’image des objets supprimés.
  		Comportement modifié	Cette méthode recherche toujours les parasites sur le plan noir et blanc, mais les supprime de tous les plans couleur de l’image.
  		Renommée	Cette méthode s’appelle désormais . L’ancienne implémentation de cette méthode a été supprimée.
  		Renommé, type modifié	Cette propriété s’appelle désormais et est de type . Le comportement par défaut reste inchangé.
  		Obsolète	Cette propriété est désormais obsolète et sera supprimée dans de futures versions.
  		Supprimé	La propriété qui utilisait cette énumération est désormais d’un autre type.
  		Obsolète sous Linux et macOS	Ces propriétés sont désormais obsolètes et seront supprimées dans les versions ultérieures.
  		Obsolète sous Linux et macOS	Cette propriété est désormais obsolète et sera supprimée dans de futures versions.

  Objets liés à Layout

  		Comportement modifié	Cette propriété est désormais en lecture seule.
  		Comportement modifié	Cette propriété est désormais en lecture seule. Pour et , le type de calque peut être modifié à l’aide de la méthode .
  	BLT_Unknown	Supprimé	Cette constante n’est plus utilisée.

  Objets relatifs au texte

  		Supprimé	Ces propriétés ne sont plus prises en charge : il n’est désormais plus possible de détecter si le paragraphe est scindé sur deux pages.
  		Supprimé	Cette propriété renvoyait l’ID de PageElement correspondant à l’image et n’est plus utile, car l’objet PageElement a été supprimé avec le reste de l’API de structure du document.
  		Comportement modifié	Cette méthode nécessite désormais d’indiquer le nom du signet utilisateur au format “UserDefinedBookmark:<my_user_bookmark>”.
  		Supprimé	Les propriétés du paragraphe ne sont désormais accessibles que via l’objet .
  		Comportement modifié	Ces propriétés sont désormais en lecture seule. Aucune propriété du style de paragraphe n’est modifiable.
  		Supprimé	Aucune propriété du style de paragraphe ne peut être modifiée ni copiée depuis un autre objet.
  		Supprimé	Le style de paragraphe est accessible via l’objet .
  		Renommé	Cette méthode s’appelle désormais AddNew. L’ancienne implémentation de la méthode AddNew a été supprimée.
  		Comportement modifié	Cette méthode permet désormais de définir toutes les propriétés du caractère de suite de tabulation lors de sa création.
  		Supprimé	Toutes les propriétés d’un taquet de tabulation doivent être définies lors de la création de l’objet à l’aide de la méthode de l’objet . Elles ne peuvent être ni modifiées ni copiées depuis un autre objet.
  		Comportement modifié	Les propriétés sont désormais en lecture seule. Elles doivent être définies au moment de la création de l’objet à l’aide de la méthode de l’objet et ne peuvent être ni modifiées ni copiées depuis un autre objet.
  		Supprimée	Cette propriété a été dépréciée dans la version précédente.
  		Supprimée	Cette propriété a été supprimée en raison de la suppression de l’API de structure logique du document, car il n’est plus possible d’accéder aux parties du document par leur rôle dans la structure logique.
  		Supprimé	La propriété utilisant cette énumération a été supprimée.
  		Supprimée	Cette propriété a été déconseillée et sa suppression était prévue. Elle a été remplacée par deux propriétés : , qui indique le premier caractère du mot lorsqu’il est lu de gauche à droite, et , qui indique le premier caractère logique, quelle que soit la direction de lecture utilisée pour la langue.
  	CFL_Picture	Supprimé	La propriété utilisant cette constante a été supprimée.
  		Obsolète	Ces propriétés sont désormais obsolètes et seront supprimées dans de futures versions.
  		Comportement modifié	Cette propriété nécessite désormais d’indiquer le nom du signet utilisateur au format “UserDefinedBookmark:<my_user_bookmark>” pour créer un hyperlien.

  Objets associés au document

  		Renommée	Cette interface s’appelle désormais . L’ancienne version de cette interface a été supprimée.
  		Paramètres modifiés	Cette méthode dispose désormais d’un paramètre supplémentaire qui indique l’indice de la page du document concernée par l’avertissement.
  		Supprimé	Ces objets représentaient la structure logique du document et de ses différentes parties. La modification de la structure du document n’est plus prise en charge, car une utilisation incorrecte pourrait affecter l’apparence du document exporté. Toute vérification du texte ou autre modification peut être effectuée via l’API du document ( , et ses sous-objets). Les futures versions d’ABBYY FineReader Engine pourront fournir un accès en lecture seule à certains éléments de la structure logique du document.
  		Supprimé	Ces énumérations étaient utilisées par des objets de structure de document qui ne sont plus disponibles.
  		Comportement modifié	Cette méthode propose désormais des paramètres avancés pour la détection des pages vides.
  		Renommée	Cette méthode s’appelle désormais . L’ancienne implémentation de la méthode IsEmpty a été supprimée.
  		Supprimé	La classification des pages peut désormais être effectuée à l’aide de la de l’objet . Elle nécessite comme paramètre d’entrée un , qui peut être créé à l’aide de la .
  		Obsolète	Cette propriété est désormais obsolète et sera supprimée dans de futures versions. Utilisez la méthode pour déterminer si un fichier contient du texte.

  Batch Processor

  ​

  | Objet/Énumération | Propriété/Méthode/Constante | Que s’est-il passé ? | Commentaire | | ---------------------------------------------------------------------------------- | ------------------------ | ------------------ |

  | | BatchProcessor | StartEx | Supprimé | La méthode Start utilise désormais l’interface avancée de source d’image, qui a elle-même été renommée en IImageSource. | | IImageSourceEx | | Renommé | Cette interface s’appelle désormais IImageSource. | | IImageSource | | Comportement modifié | Cette interface vous permet désormais d’ajouter à la file d’attente des documents d’image ainsi que des fichiers image. |

  Objets de mécanisme

  		Supprimé	L’objet est obsolète. Ses méthodes ont été remplacées par des méthodes plus efficaces des objets et , qui ne nécessitent pas de conserver l’objet DocumentInfo à toutes les étapes du traitement, ni d’implémenter l’interface IRecognizedPages.
  		Supprimé	Utilisez les , , pour utiliser les dictionnaires de cache.
  		Supprimé	Utilisez à la place.
  		Supprimé	Utilisez plutôt la méthode.
  		Supprimé	Utilisez plutôt la méthode .
  		Supprimée	Utilisez plutôt la méthode .
  		Supprimé	Utilisez la , qui fonctionne exactement de la même manière.
  		Supprimée	Utilisez la méthode qui fonctionne exactement de la même manière.
  		Supprimé	Utilisez plutôt la méthode IImageDocument::RemoveGeometricalDistortions.
  		Supprimé	Utilisez plutôt la méthode .
  		Supprimé	Utilisez la méthode à la place.
  		Supprimé	Utilisez plutôt la méthode.
  		Supprimé	Utilisez plutôt la méthode.
  		Supprimé	Utilisez la méthode à la place.
  		Supprimé	Utilisez plutôt la méthode. Elle assure le traitement complet du document, y compris la synthèse de documents.
  		Supprimé	Utilisez plutôt la méthode.
  		Supprimé	Utilisez plutôt la méthode.
  		Supprimé	Utilisez plutôt la méthode.
  		Supprimé	Pour reconnaître une image comme du texte brut, créez le à partir de l’image à l’aide de la méthode , puis utilisez la méthode pour reconnaître le document, avant d’accéder à la propriété .
  		Supprimé	Pour reconnaître la page en texte brut, utilisez la méthode , puis accédez à la propriété .
  		Supprimé	Utilisez plutôt la méthode.
  		Supprimé	Utilisez plutôt la méthode .
  		Supprimé	Cet objet est obsolète. Ses méthodes ont été remplacées par des méthodes plus efficaces des objets et , qui n’exigent pas de conserver l’objet DocumentInfo à toutes les étapes du traitement ni d’implémenter l’interface IRecognizedPages.
  		Supprimé	Utilisez plutôt la méthode.
  		Supprimé	Utilisez plutôt la méthode .
  		Supprimé	Cette interface n’est plus nécessaire, car l’objet qui émettait les événements a été supprimé. Les et interfaces fournissent des informations similaires sur l’avancement et les erreurs pour les objets qui ont remplacé DocumentAnalyzer.
  		Supprimée	Cette interface n’est plus nécessaire, car l’objet qui émettait ces événements a été supprimé. Les interfaces et fournissent des informations similaires sur la progression et les erreurs pour les objets qui ont remplacé Exporter.
  		Supprimé	Les méthodes qui requéraient un objet de ce type ont été supprimées.
  	FREM_DocumentAnalyzer	Supprimé	Cette constante n’est plus utilisée.

  Objets de paramétrage

  		Supprimé	Cette propriété est obsolète depuis FineReader Engine 11. Utilisez plutôt la propriété .
  		Supprimé	Cette propriété est obsolète depuis FineReader Engine 11. Utilisez plutôt la propriété de l’objet à la place.
  		Supprimé	Utilisez la propriété pour reproduire la mise en page du texte d’origine à l’aide d’espaces.
  	WS_Default	Supprimé	Windows Nous vous recommandons d’utiliser WS_Auto afin d’obtenir la meilleure qualité de reconnaissance. Si vous devez sélectionner le style d’écriture correspondant à la langue actuelle du système d’exploitation, utilisez WS_DetectByLocale.
  		Supprimé	Utilisez la propriété KeepPageBreaks à la place.
  	PEM_SingleLineParagraphsWithSpaceFormatting	Supprimé	Utilisez la propriété pour reproduire l’apparence du texte d’origine à l’aide d’espaces lors de l’exportation au format TXT.
  		Supprimé	Utilisez la propriété pour sélectionner le type de chiffrement.
  		Supprimé	Utilisez la propriété LanguageDetectionMode pour configurer la détection automatique des langues de reconnaissance.
  		Supprimé	Utilisez la nouvelle propriété, qui supprime les différents niveaux de confiance et vous offre un choix simple : mettre en évidence ou non les caractères reconnus de façon incertaine. Si vous avez besoin d’une distinction plus fine, utilisez la propriété du sélectionné, bien que la comparaison des scores de confiance de reconnaissance de différents caractères au même seuil ne fournisse pas toujours des résultats cohérents.
  		Obsolète	Utilisez la propriété pour définir le mode de reconnaissance à l’aide des constantes (RM_Normal correspond à BalancedMode = TRUE et RM_Fast correspond à FastMode = TRUE).
  	AEM_FastMode AEM_BalancedMode	Obsolète	Les modules utilisant ces constantes sont obsolètes.
  		Supprimé	La propriété qui utilisait cette énumération a été supprimée.
  		Renommées, type modifié	Ces propriétés s’appellent désormais et CorrectResolution, et sont de type . Leurs valeurs par défaut restent inchangées.
  		Renommées, type modifié	Ces propriétés s’appellent désormais , , et sont de type. Le comportement par défaut reste inchangé.
  		Renommé, type modifié	Cette propriété s’appelle désormais et est désormais de type . Par défaut, les images ne sont pas traitées comme faisant partie de l’arrière-plan.
  		Supprimé	Les propriétés qui utilisaient ces énumérations sont désormais d’un autre type.
  		Obsolète	Cette propriété est désormais obsolète et sera supprimée dans de futures versions. Le même résultat peut être obtenu en définissant la propriété sur TXTLRM_ExactCopy.
  		Supprimée	Cette propriété était déjà déconseillée.
  		Obsolète	Cette propriété est désormais obsolète et sera supprimée dans les prochaines versions.
  		Déconseillé	Ces propriétés sont désormais déconseillées et seront supprimées dans de futures versions.
  		Obsolète sous Windows et Linux	Cette propriété est désormais obsolète et sera supprimée dans les prochaines versions.

  Objets relatifs à la classification

  ​

  | Objet/Énumération | Propriété/Méthode/Constante | Que s’est-il passé ? | Commentaire | |

  ​

  | ------------------------ | ------------------ |

  | | ClassificationEtalon ClassificationParams ClassificationClass ClassificationClasses ClassificationTrainer ClassificationTrainerError ClassificationTrainerErrors ClassificationTrainerErrorTypeEnum ClassificationModeEnum | | Supprimé | L’ancienne API de classification a été supprimée. L’entraînement du modèle de classification s’effectue désormais via l’objet Trainer, avec les paramètres spécifiés dans TrainingParams et ValidationParams, et les données d’entrée fournies sous forme de TrainingData. La classification des documents ou des pages est possible via l’objet Model. L’entraînement comme la classification nécessitent au préalable de transformer un document ou une page en ClassificationObject, ce qui peut être réalisé à l’aide des méthodes de l’objet ClassificationEngine. Voir également Classification-Related Objects, ainsi que la description du scénario Classification. |

  Objets supplémentaires

  		Supprimé	Les méthodes qui nécessitaient un objet de ce type ont été supprimées.
  		Supprimé	L’objet contenant des informations sur l’auteur, les mots-clés, le sujet et le titre du document peut être obtenu à partir de la propriété de l’objet FRDocument.