Kompatibilität von ABBYY FineReader Engine 12 und 11

ABBYY FineReader Engine 12 ist nicht binärkompatibel mit ABBYY FineReader Engine 11. Anwendungen, die mit ABBYY FineReader Engine 11 kompiliert wurden, sollten mit den Header-Dateien und der Bibliothek von ABBYY FineReader Engine 12 neu kompiliert werden. Aufgrund von Verbesserungen der ABBYY FineReader Engine API können einige Änderungen am Quellcode erforderlich sein. Dieser Artikel enthält eine vollständige Liste der Änderungen sowie Hinweise dazu, wie Sie Ihren Code für die neue Version anpassen können. Wichtigste Änderungen:

Die veralteten Objekte DocumentAnalyzer und Exporter wurden zusammen mit den Verarbeitungsmethoden des Objekts Engine entfernt. Verwenden Sie stattdessen die effizienteren Methoden der Objekte FRDocument und FRPage, die alle für die vollständige Dokumentverarbeitung erforderlichen Informationen bereitstellen. Sie müssen das Objekt DocumentInfo nicht mehr in allen Verarbeitungsphasen pflegen, nicht mehr alle Bilddokumente mit den entsprechenden Layouts im Blick behalten und auch die Schnittstelle IRecognizedPages nicht mehr implementieren.
Die API, die Zugriff auf die logische Struktur des Dokuments (DocumentStructure, PageStructure und ihre Unterobjekte) bereitstellte, wurde entfernt. Das Bearbeiten der Eigenschaften und Inhalte des Dokuments über die entfernten Objekte konnte beim Export zu unvorhersehbaren Ergebnissen führen. Wenn Sie die Erkennungsergebnisse überprüfen oder nachbearbeiten müssen, arbeiten Sie mit den Daten im Unterobjekt Layout jeder FRPage und rufen Sie anschließend eine der Methoden auf, die die Dokumentsynthese durchführen. Die logische Struktur des Dokuments wird dann neu erstellt und beim Export verwendet, steht jedoch über die FineReader Engine API nicht mehr zur Bearbeitung zur Verfügung. Zukünftige Versionen von ABBYY FineReader Engine bieten möglicherweise Zugriff im Modus „nur lesbar“ auf Teile der logischen Struktur des Dokuments.
Die Classification API wurde vollständig ersetzt; die neue Version verwendet verbesserte Algorithmen und bietet integrierte Techniken zur Kreuzvalidierung.

Das Engine-Objekt muss jetzt mit der Funktion InitializeEngine geladen werden. Die Funktionen GetEngineObject und GetEngineObjectEx zum Laden der Engine wurden aus ABBYY FineReader Engine entfernt.

Engine-Objekt

Property/Methode/Konstante	Was hat sich geändert?	Kommentar
CreateDocumentAnalyzer CreateDocumentInfo CreateExporter	Entfernt	Die Methoden werden nicht mehr benötigt, da die von ihnen erstellten Objekte entfernt wurden.
CreateExportFileWriter	Signatur geändert	Der veraltete Parameter PagesCount wurde entfernt.
CreateImageDocumentsInMemory <Note> Nur unter Windows </Note>	Entfernt	Bilddokumente werden immer im Speicher erstellt. Sie können die Methoden SaveTo oder SaveToFile verwenden, wenn Sie das Bilddokument auf der Festplatte speichern müssen.
CreateLayout	Entfernt	Das Layout-Objekt kann nicht mehr unabhängig von der zugehörigen Seite verwendet werden.
CreateMultipageImageWriter	Verhalten geändert	Diese Methode unterstützt jetzt erweiterte Parameters zum Speichern von Bildern in den Formaten JPEG und TIFF.
CreateMultipageImageWriterEx	Umbenannt	Diese Methode heißt jetzt CreateMultipageImageWriter. Die bisherige Implementierung der Methode CreateMultipageImageWriter wurde entfernt.
ExportPage	Entfernt	Verwenden Sie stattdessen die Methode IFRPage::Export.
ExportPagesEx	Entfernt	Verwenden Sie stattdessen die Methode IFRDocument::Export.
InjectTextLayer	Verhalten geändert	Diese Methode bietet jetzt zusätzliche Parameter zum Einfügen der Textebene sowie die Möglichkeit, die zu verarbeitenden Seiten der PDF-Datei auszuwählen, und eine Callback-Schnittstelle zum Behandeln von Warnungen und Fehlern.
InjectTextLayerEx InjectTextLayerEx2	Entfernt	Die neue Version der Methode InjectTextLayer bietet jetzt alle Optionen, die bisher in diesen Methoden verfügbar waren.
OpenImageFile	Entfernt	Verwenden Sie die Methode IFRDocument::AddImageFile, um eine Bilddatei zu öffnen und sie dem Document zur Verarbeitung hinzuzufügen. Auf das Objekt ImageDocument kann über die zugehörige FRPage zugegriffen werden.
PrepareImageFile	Entfernt	Verwenden Sie die Methode IFRDocument::AddImageFile, um eine Bilddatei zu öffnen und sie dem Dokument zur Verarbeitung hinzuzufügen. Auf das Objekt ImageDocument kann über die entsprechende FRPage zugegriffen werden, und es kann später auf der Festplatte gespeichert werden.
ProcessPage	Entfernt	Verwenden Sie stattdessen die Methode IFRDocument::Process.
ProcessPagesEx	Entfernt	Verwenden Sie stattdessen die Methode IFRDocument::Process.
SynthesizePagesEx	Entfernt	Verwenden Sie stattdessen die IFRDocument::Synthesize-Methode.
OpenMemoryImageFormat10	Entfernt	Diese Methode wurde ausschließlich aus Kompatibilitätsgründen mit ABBYY FineReader Engine 10 bereitgestellt.
OpenBitmap OpenBitmapBits<br />OpenDib<br />PrepareBitmap<br />PrepareBitmapBits<br />PrepareDib	Veraltet unter Linux und macOS	Diese Eigenschaften sind inzwischen veraltet und werden in zukünftigen Versionen entfernt.

Engine für Java

Methode	Was hat sich geändert?	Kommentar
Load LoadEx	Entfernt	Veraltete Methoden; verwenden Sie stattdessen Engine.InitializeEngine.

Bildbezogene Objekte

Objekt/Aufzählung	Eigenschaft/Methode/Konstante	Was ist passiert?	Kommentar
ImageDocument	SuppressColorObjects	Entfernt	Verwenden Sie stattdessen die Methode RemoveColorObjectsEx, mit der Sie Objekte mehrerer angegebener Farbtöne gleichzeitig entfernen und außerdem das Bild der entfernten Objekte abrufen können.
	RemoveGarbage	Verhalten geändert	Diese Methode sucht weiterhin auf der Schwarz-Weiß-Ebene nach Bildstörungen, entfernt diese jedoch aus allen Farbebenen des Bildes.
	RemoveGarbageEx	Umbenannt	Diese Methode heißt jetzt RemoveGarbage. Die bisherige Implementierung dieser Methode wurde entfernt.
PrepareImageMode	ImageCompression	Umbenannt, Typ geändert	Diese Eigenschaft heißt jetzt CompressImage und ist vom Typ ThreeStatePropertyValueEnum. Das Standardverhalten ist wie zuvor.
PrepareImageMode	KeepOriginalCoordinatesInfo	Veraltet	Diese Eigenschaft ist jetzt veraltet und wird in künftigen Versionen entfernt.
ImageCompressionEnum		Entfernt	Die Eigenschaft, die diese Aufzählung verwendet hat, hat jetzt einen anderen Typ.
Image	EstimateBitmapSize GetBitmap	Unter Linux und macOS veraltet	Diese Methoden sind jetzt veraltet und werden in künftigen Versionen entfernt.
TrainingImage	SetBitmapBits	Unter Linux und macOS veraltet	Diese Methode ist jetzt veraltet und wird in künftigen Versionen entfernt.

Layout-bezogene Objekte

Objekt/Aufzählung	Eigenschaft/Methode/Konstante	Was hat sich geändert?	Kommentar
Block	BackgroundColor	Verhalten geändert	Diese Eigenschaft ist jetzt nur lesbar.
Block	BlockLayerType	Verhalten geändert	Diese Eigenschaft ist jetzt nur lesbar. Für RasterPictureBlock und VectorPictureBlock kann der Ebenentyp mit der Methode SetBlockLayerType geändert werden.
BlockLayerTypeEnum	BLT_Unknown	Entfernt	Diese Konstante wird nicht mehr verwendet.

Textbezogene Objekte


	Entfernt	Diese Eigenschaften werden nicht mehr unterstützt: Das Erkennen eines Absatzumbruchs über zwei Seiten ist nicht mehr möglich.
	Entfernt	Diese Eigenschaft gab die ID des PageElement zurück, das dem Bild entspricht, und ist nicht mehr relevant, da das PageElement-Objekt zusammen mit dem Rest der Document-Structure-API entfernt wurde.
	Verhalten geändert	Diese Methode erfordert nun die Angabe des Benutzer-Lesezeichennamens im Format “UserDefinedBookmark:<my_user_bookmark>”.
	Entfernt	Auf die Absatzeigenschaften kann nun nur noch über das-Objekt zugegriffen werden.
	Verhalten geändert	Diese Eigenschaften sind jetzt nur lesbar. Eigenschaften des Absatzstils können nicht bearbeitet werden.
	Entfernt	Eigenschaften des Absatzstils können weder bearbeitet noch von einem anderen Objekt kopiert werden.
	Entfernt	Auf den Absatzstil kann über das-Objekt zugegriffen werden.
	Umbenannt	Diese Methode heißt jetzt AddNew. Die alte Implementierung der AddNew-Methode wurde entfernt.
	Verhalten geändert	Diese Methode ermöglicht es nun, alle Eigenschaften des Tabulatorfüllzeichens bei der Erstellung festzulegen.
	Entfernt	Alle Eigenschaften eines Tabstopps müssen bei der Erstellung des Objekts mithilfe der-Methode des-Objekts angegeben werden. Sie können weder geändert noch von einem anderen Objekt kopiert werden.
	Verhalten geändert	Die Eigenschaften sind jetzt nur lesbar. Sie müssen bei der Erstellung des Objekts mithilfe dermethod of theobject and may not be changed or copied from another object.
	Removed	This property was deprecated in the previous version.
	Removed	This property has been removed due to the removal of document logical structure API, as it is no longer possible to access the parts of document by their role in the logical structure.
	Removed	The property that used this enumeration has been removed.
	Removed	Diese Eigenschaft wurde als veraltet markiert und sollte entfernt werden. Sie wurde durch zwei Eigenschaften ersetzt:, die das erste Zeichen im Wort bei Links-nach-rechts-Leserichtung angibt, und, die das logisch erste Zeichen für die in der jeweiligen Sprache verwendete Leserichtung angibt.
CFL_Picture	Removed	The property which used this constant has been removed.
	Deprecated	These properties are now deprecated and will be deleted in future versions.
	Behavior changed	This property now requires the specification of user bookmark name in the format “UserDefinedBookmark:<my_user_bookmark>” for creating a hyperlink.

Dokumentbezogene Objekte


		Umbenannt	Dieses Interface heißt jetzt. Die alte Version dieses Interface wurde entfernt.
		Parameter geändert	Diese Methode verfügt jetzt über einen zusätzlichen Parameter, der den Index der Seite im Dokument angibt, auf die sich die Warnung bezieht.
		Entfernt	Diese Objekte repräsentierten die logische Struktur des Dokuments und seiner verschiedenen Teile. Die Bearbeitung der Dokumentstruktur wird nicht mehr unterstützt, da eine fehlerhafte Verwendung das Erscheinungsbild des exportierten Dokuments beeinträchtigen könnte. Textverifizierung und andere Änderungen können über die Dokument-API durchgeführt werden (,und Unterobjekte). Zukünftige Versionen von ABBYY FineReader Engine können schreibgeschützten Zugriff auf Teile der logischen Dokumentstruktur bieten.
		Entfernt	Diese Aufzählungen wurden von den Dokumentstruktur-Objekten verwendet, die nicht mehr verfügbar sind.
		Verhalten geändert	Diese Methode bietet jetzt erweiterte Parameter zur Erkennung leerer Seiten.
		Umbenannt	Diese Methode heißt jetzt. Die alte Implementierung der IsEmpty-Methode wurde entfernt.
		Entfernt	Die Seitenklassifizierung kann jetzt über die-Methode des-Objekts durchgeführt werden. Als Eingabeparameter wird einbenötigt, das mit der-Methode erstellt werden kann.
		Veraltet	Diese Eigenschaft ist veraltet und wird in zukünftigen Versionen entfernt. Verwenden Sie die-Methode, um zu ermitteln, ob eine Datei Textinhalt enthält.

Batch Processor

Objekt/Aufzählung	Eigenschaft/Methode/Konstante	Was hat sich geändert?	Kommentar
BatchProcessor	StartEx	Entfernt	Die Methode Start verwendet jetzt die erweiterte Schnittstelle für Bildquellen, die ihrerseits in IImageSource umbenannt wurde.
IImageSourceEx	<br />	Umbenannt	Diese Schnittstelle heißt jetzt IImageSource.
IImageSource	<br />	Verhalten geändert	Mit dieser Schnittstelle können Sie jetzt sowohl Bilddokumente als auch Bilddateien der Warteschlange hinzufügen.

Mechanismus-Objekte


	Entfernt	Das Objekt ist veraltet. Seine Methoden wurden durch effizientere Methoden derandObjekte ersetzt, bei denen Sie das DocumentInfo-Objekt nicht mehr über alle Verarbeitungsstufen hinweg pflegen oder die Schnittstelle IRecognizedPages implementieren müssen.
	Entfernt	Verwenden Sie die Methoden,,für die Arbeit mit Cache-Wörterbüchern.
	Entfernt	Verwenden Sie stattdessen die Methode.
	Entfernt	Verwenden Sie stattdessen die Methode.
	Entfernt	Verwenden Sie stattdessen die Methode.
	Entfernt	Verwenden Sie stattdessen die Methode.
	Entfernt	Verwenden Sie die Eigenschaft, die auf genau dieselbe Weise funktioniert.
	Entfernt	Verwenden Sie die Methode, die auf genau dieselbe Weise funktioniert.
	Entfernt	Verwenden Sie stattdessen die Methode IImageDocument::RemoveGeometricalDistortions.
	Entfernt	Verwenden Sie stattdessen die Methode.
	Entfernt	Verwenden Sie stattdessen die Methode.
	Entfernt	Verwenden Sie stattdessen die MethodeMethode verwenden.
	Entfernt	Verwenden Sie stattdessen dieMethode.
	Entfernt	Verwenden Sie stattdessen dieMethode.
	Entfernt	Verwenden Sie stattdessen dieMethode. Diese führt die vollständige Verarbeitung des Dokuments durch, einschließlich der Dokumentsynthese.
	Entfernt	Verwenden Sie stattdessen dieMethode.
	Entfernt	Verwenden Sie stattdessen dieMethode.
	Entfernt	Verwenden Sie stattdessen dieMethode.
	Entfernt	Um ein Bild als Klartext zu erkennen, erstellen Sie dasaus dem Bild mithilfe derMethode, verwenden Sie dieMethode, um das Dokument zu erkennen, und greifen Sie anschließend auf dieEigenschaft zu.
	Entfernt	Um die Seite als Klartext zu erkennen, verwenden Sie dieMethode und greifen Sie anschließend auf dieEigenschaft zu.
	Entfernt	Verwenden Sie stattdessen dieMethode.
	Entfernt	Verwenden Sie stattdessen dieMethode.
	Entfernt	Das Objekt ist veraltet. Seine Methoden wurden durch effizientere Methoden derundObjekte ersetzt, bei denen das DocumentInfo-Objekt nicht auf allen Verarbeitungsstufen gepflegt oder die IRecognizedPages-Schnittstelle implementiert werden muss.
	Entfernt	Verwenden Sie stattdessen dieMethode.
	Entfernt	Verwenden Sie stattdessen die-Methode.
	Entfernt	Dieses Interface wird nicht mehr benötigt, da das Objekt, das Ereignisse gemeldet hat, entfernt wurde. Die und -Interfaces liefern ähnliche Informationen zu Fortschritt und Fehlern für die Objekte, die DocumentAnalyzer ersetzt haben.
	Entfernt	Dieses Interface wird nicht mehr benötigt, da das Objekt, das Ereignisse gemeldet hat, entfernt wurde. Die und -Interfaces liefern ähnliche Informationen zu Fortschritt und Fehlern für die Objekte, die Exporter ersetzt haben.
	Entfernt	Die Methoden, die ein Objekt dieses Typs erforderten, wurden entfernt.
FREM_DocumentAnalyzer	Entfernt	Diese Konstante wird nicht mehr verwendet.

Parameterobjekte


	Entfernt	Diese Property ist seit FineReader Engine 11 veraltet. Verwenden Sie stattdessen dieProperty.
	Entfernt	Diese Property ist seit FineReader Engine 11 veraltet. Verwenden Sie stattdessen dieProperty desObjekts.
	Entfernt	Verwenden Sie dieProperty, um das ursprüngliche Textlayout mithilfe von Leerzeichen nachzubilden.
WS_Default	Entfernt	Windows Wir empfehlen, WS_Auto zu verwenden, um die beste Erkennungsqualität zu erzielen. Wenn Sie den Schreibstil passend zur aktuellen Betriebssystemsprache auswählen möchten, verwenden Sie WS_DetectByLocale.
	Entfernt	Verwenden Sie stattdessen die KeepPageBreaks Property.
PEM_SingleLineParagraphsWithSpaceFormatting	Entfernt	Verwenden Sie dieProperty, um das ursprüngliche Textbild beim Export in das TXT-Format mithilfe von Leerzeichen nachzubilden.
	Entfernt	Verwenden Sie dieProperty, um den Verschlüsselungstyp festzulegen.
	Entfernt	Verwenden Sie die LanguageDetectionMode Property, um die automatische Spracherkennung zu steuern.
	Entfernt	Verwenden Sie die neueProperty, die auf unterschiedliche Konfidenzwert-Stufen verzichtet und Ihnen eine einfache Entscheidung ermöglicht: unsicher erkannte Zeichen hervorheben oder nicht. Wenn Sie eine feinere Unterscheidung benötigen, verwenden Sie dieProperty des ausgewählten, obwohl der Abgleich von Konfidenzwerten für verschiedene Zeichen mit demselben Schwellenwert nicht immer konsistente Ergebnisse liefert.
	Veraltet	Verwenden Sie die Eigenschaft, um den Erkennungsmodus mithilfe der Konstanten vonfestzulegen (RM_Normal entspricht BalancedMode = TRUE und RM_Fast entspricht FastMode = TRUE).
AEM_FastMode AEM_BalancedMode	Veraltet	Die Module, die diese Konstanten verwendet haben, sind veraltet.
	Entfernt	Die Eigenschaft, die diese Aufzählung verwendet hat, wurde entfernt.
	Umbenannt, Typ geändert	Diese Eigenschaften heißen jetztund CorrectResolution und sind vom Typ. Die Standardwerte bleiben unverändert.
	Umbenannt, Typ geändert	Diese Eigenschaften heißen jetzt,, und sind vom Typ. Die Standardwerte bleiben unverändert.
	Umbenannt, Typ geändert	Diese Eigenschaft heißt jetztund ist vom Typ. Standardmäßig werden Bilder nicht als Teil des Hintergrunds behandelt.
	Entfernt	Die Eigenschaften, die diese Aufzählungen verwendet haben, besitzen jetzt einen anderen Typ.
	Veraltet	Diese Eigenschaft ist veraltet und wird in zukünftigen Versionen entfernt. Dasselbe Ergebnis lässt sich erzielen, indem die Eigenschaftauf TXTLRM_ExactCopy gesetzt wird.
	Entfernt	Diese Eigenschaft war bereits als veraltet markiert.
	Veraltet	Diese Eigenschaft ist jetzt als veraltet markiert und wird in zukünftigen Versionen entfernt.
	Veraltet	Diese Eigenschaften sind jetzt als veraltet markiert und werden in zukünftigen Versionen entfernt.
	Veraltet unter Windows und Linux	Diese Eigenschaft ist jetzt als veraltet markiert und wird in zukünftigen Versionen entfernt.

Klassifizierungsbezogene Objekte

Objekt/Aufzählung	Property/Method/Constant	Was ist passiert?	Kommentar
ClassificationEtalon ClassificationParams ClassificationClass ClassificationClasses ClassificationTrainer ClassificationTrainerError ClassificationTrainerErrors ClassificationTrainerErrorTypeEnum ClassificationModeEnum	<br />	Entfernt	Die alte Classification API wurde entfernt. Das Training des Klassifizierungsmodells erfolgt jetzt über das Objekt Trainer, wobei die Einstellungen in TrainingParams und ValidationParams festgelegt und die Eingabedaten als TrainingData bereitgestellt werden. Dokumente oder Seiten können über das Objekt Model klassifiziert werden. Sowohl für das Training als auch für die Klassifizierung muss ein Dokument oder eine Seite zuvor in ein ClassificationObject umgewandelt werden; dies kann mit den Methoden des Objekts ClassificationEngine erfolgen. Siehe auch Classification-Related Objects und die Szenariobeschreibung Classification.

Ergänzende Objekte

Objekt/Aufzählung	Eigenschaft/Methode/Konstante	Was wurde geändert?	Kommentar
DocumentInfo		Entfernt	Die Methoden, für die ein Objekt dieses Typs erforderlich war, wurden entfernt.
DocumentInfo	DocumentContentInfo	Entfernt	Das Objekt mit Informationen zu Autor, Schlüsselwörtern, Betreff und Titel des Dokuments kann über die Eigenschaft DocumentContentInfo des Objekts FRDocument abgerufen werden.

Überblick

Exportformate

Probleme bei der Abwärtskompatibilität

Kompatibilität von ABBYY FineReader Engine 12 und 11