ABBYY FineReader Engine 12 と 11 の互換性

ABBYY FineReader Engine 12 は、ABBYY FineReader Engine 11 とバイナリ互換ではありません。ABBYY FineReader Engine 11 を使用してコンパイルされたアプリケーションは、ABBYY FineReader Engine 12 のヘッダーおよびライブラリを使用して再コンパイルする必要があります。ABBYY FineReader Engine API の改良に伴い、ソースコードの一部を変更する必要が生じる場合があります。

この記事では、変更点の一覧と、新しいバージョンで動作するようにコードを書き換えるための推奨事項を紹介します。

主な変更点:

• 廃止された DocumentAnalyzer オブジェクトと Exporter オブジェクトは、Engine オブジェクトの処理メソッドとともに削除されました。完全な文書処理に必要なすべての情報を扱う、より効率的な FRDocument オブジェクトおよび FRPage オブジェクトのメソッドを使用してください。これにより、すべての処理段階で DocumentInfo オブジェクトを維持したり、対応する Layout とともにすべての画像ドキュメントを追跡したり、IRecognizedPages インターフェイスを実装したりする必要はなくなりました。

• 文書の論理構造 (DocumentStructure、PageStructure、およびそれらのサブオブジェクト) へのアクセスを提供していた API は削除されました。削除されたオブジェクトを介して文書のプロパティや内容を編集すると、エクスポート時に予測不能な結果を招くおそれがあったためです。認識結果を検証または後処理する必要がある場合は、各 FRPage の Layout サブオブジェクトを通じてデータを扱い、完了後に文書の合成を実行するいずれかのメソッドを呼び出してください。そうすると、文書の論理構造が再作成されてエクスポート時に使用されますが、FineReader Engine API 経由で編集することはできなくなります。今後の ABBYY FineReader Engine のバージョンでは、文書の論理構造の一部に対して読み取り専用アクセスが提供される可能性があります。

• Classification API は、改良された新しいアルゴリズムを採用し、組み込みの交差検証手法を備えた新しいものに完全に置き換えられました。

• エンジン オブジェクトは、今後は InitializeEngine 関数でロードする必要があります。エンジンのロードに使用する GetEngineObject 関数および GetEngineObjectEx 関数は、ABBYY FineReader Engine から削除されました。

  Engine オブジェクト

  プロパティ/メソッド/定数	変更内容	コメント
  CreateDocumentAnalyzer CreateDocumentInfo CreateExporter	削除	これらのメソッドが作成していたオブジェクトが削除されたため、これらのメソッドは不要になりました。
  CreateExportFileWriter	署名が変更されました	非推奨の PagesCount パラメーターが削除されました。
  CreateImageDocumentsInMemory 注記: Windows のみ。	廃止	イメージドキュメントは常にメモリ内に作成されます。イメージドキュメントをディスクに保存する必要がある場合は、SaveTo または SaveToFile メソッドを使用できます。
  CreateLayout	廃止	Layout オブジェクトは、対応するページから切り離して使用できなくなりました。
  CreateMultipageImageWriter	動作が変更されました	このメソッドでは、JPEG および TIFF 形式向けの拡張画像保存パラメーターを使用できるようになりました。
  CreateMultipageImageWriterEx	名称変更	このメソッドは現在、CreateMultipageImageWriter という名称になっています。従来の CreateMultipageImageWriter メソッドの実装は削除されました。
  ExportPage	削除	代わりに、IFRPage::Export メソッドを使用してください。
  ExportPagesEx	削除	代わりに IFRDocument::Export メソッドを使用してください。
  InjectTextLayer	動作変更	このメソッドでは、テキストレイヤーの挿入に関する追加のパラメーターに加え、処理対象とする PDF ファイルのページを選択するオプションや、警告とエラーを処理するための Callback インターフェイスも利用できるようになりました。
  InjectTextLayerEx InjectTextLayerEx2	削除	新しいバージョンのInjectTextLayerメソッドでは、これらのメソッドで以前利用できたすべてのオプションが提供されるようになりました。
  OpenImageFile	廃止	処理用に画像ファイルを開いてドキュメントに追加するには、IFRDocument::AddImageFile メソッドを使用します。ImageDocument オブジェクトには、対応する FRPage を介してアクセスできます。
  PrepareImageFile	廃止	処理用に画像ファイルを開いてドキュメントに追加するには、IFRDocument::AddImageFile メソッドを使用します。ImageDocument オブジェクトは、対応する FRPage を介してアクセスでき、後でディスクに保存することもできます。
  ProcessPage	廃止	代わりに、IFRDocument::Process メソッドを使用してください。
  ProcessPagesEx	廃止	代わりに、IFRDocument::Process メソッドを使用してください。
  SynthesizePagesEx	削除	代わりに、IFRDocument::Synthesize メソッドを使用してください。
  OpenMemoryImageFormat10	削除	このメソッドは、ABBYY FineReader Engine 10 との互換性を確保するためだけに提供されていました。
  OpenBitmap OpenBitmapBits OpenDib PrepareBitmap PrepareBitmapBits PrepareDib	Linux および macOS で非推奨	これらのプロパティは現在非推奨となっており、今後のバージョンで削除される予定です。

  Java 用 Engine

  | メソッド | 変更内容 | コメント | | ----------- | ------------------ | -------------------------------------------------------- | | Load LoadEx | 削除 | 非推奨となったメソッドです。代わりに Engine.InitializeEngine を使用してください。 |

  画像関連のオブジェクト

  		廃止されました	代わりに メソッドを使用してください。このメソッドでは、指定した複数の色相のオブジェクトを一度に削除できるほか、削除されたオブジェクトの画像も取得できます。
  		動作が変更されました	このメソッドは引き続き白黒プレーン上でごみを検出しますが、その削除は画像のすべてのカラープレーンに対して行われます。
  		名称変更	このメソッドの名称は現在 です。従来のこのメソッドの実装は削除されました。
  		名称変更、型変更	このプロパティの名称は現在 となっており、型は です。既定の動作は従来どおりです。
  		非推奨	このプロパティは現在非推奨となっており、今後のバージョンで削除される予定です。
  		削除済み	この列挙型を使用していたプロパティの型は、現在は別のものになっています。
  		Linux および macOS では非推奨	これらのプロパティは現在非推奨となっており、今後のバージョンで削除される予定です。
  		Linux および macOS では非推奨	このプロパティは現在非推奨となっており、今後のバージョンで削除される予定です。

  Layout関連オブジェクト

  		動作が変更されました	このプロパティは読み取り専用になりました。
  		動作が変更されました	このプロパティは読み取り専用になりました。 および では、レイヤータイプは メソッドを使用して変更できます。
  	BLT_Unknown	削除	この定数は廃止され、現在は使用されていません。

  テキスト関連のオブジェクト

  		削除	これらのプロパティはサポート対象外になりました。段落が2ページにまたがっているかどうかは、現在は検出できません。
  		削除	このプロパティは画像に対応する PageElement の ID を返していましたが、PageElement オブジェクトがドキュメント構造 API の他の部分とともに削除されたため、現在は有用ではありません。
  		動作が変更されました	このメソッドでは、ユーザー定義ブックマーク名を “UserDefinedBookmark:<my_user_bookmark>” の形式で指定する必要があります。
  		削除	段落のプロパティには、 オブジェクトを介してのみアクセスできるようになりました。
  		動作が変更されました	これらのプロパティは現在、読み取り専用です。段落スタイルのプロパティは一切編集できません。
  		削除	段落スタイルのプロパティは編集できず、別のオブジェクトからコピーすることもできません。
  		廃止	段落スタイルには オブジェクトからアクセスできます。
  		名称変更	このメソッドは現在 AddNew という名前です。従来の AddNew メソッドの実装は削除されました。
  		動作が変更されました	このメソッドでは、作成時にタブリーダーのすべてのプロパティを設定できるようになりました。
  		削除	タブ ストップのすべてのプロパティは、オブジェクトの作成時に メソッドを使用して オブジェクトで指定する必要があります。これらのプロパティは、変更したり別のオブジェクトからコピーしたりすることはできません。
  		動作が変更されました	これらのプロパティは現在、読み取り専用です。これらは、そのオブジェクトの作成時に メソッドを使用して、 オブジェクトで指定する必要があり、後から変更したり、別のオブジェクトからコピーしたりすることはできません。
  		削除	このプロパティは前バージョンで非推奨となりました。
  		削除	このプロパティは、文書の論理構造 API の削除に伴い廃止されました。論理構造内での役割に基づいて文書の各部分にアクセスできなくなったためです。
  		削除	この列挙型を使用していたプロパティは削除されました。
  		削除	このプロパティは非推奨となり、削除予定でした。現在は次の 2 つのプロパティに置き換えられています。 は、左から右に読む場合の単語の先頭文字を示します。また、 は、その言語で使用される読み取り方向に応じた、論理上の先頭文字を示します。
  	CFL_Picture	削除	この定数を使用していたプロパティは削除されました。
  		非推奨	これらのプロパティは現在非推奨となっており、今後のバージョンで削除される予定です。
  		動作が変更されました	このプロパティでは、ハイパーリンクの作成時に、“UserDefinedBookmark:<my_user_bookmark>” の形式でユーザーブックマーク名を指定する必要があります。

  ドキュメント関連オブジェクト

  		名称変更	このインターフェイスの名称は現在 です。このインターフェイスの旧バージョンは削除されました。
  		パラメーターが変更されました	このメソッドには、警告の対象となるドキュメント内のページのインデックスを指定するパラメーターが追加されました。
  		削除	これらのオブジェクトは、文書とその各部分の論理構造を表していました。文書構造の編集は、誤って使用するとエクスポートした文書の 表示に影響を及ぼすおそれがあるため、現在はサポートされていません。テキストの検証やその他の変更は、ドキュメント API ( , およびそのサブオブジェクト) を使用して実行できます。今後の ABBYY FineReader Engine のバージョンでは、文書の論理構造の一部に対する読み取り専用アクセスが提供される可能性があります。
  		削除	これらの列挙型は、現在は提供されていないドキュメント構造オブジェクトで使用されていました。
  		動作が変更されました	このメソッドでは、空ページ検出用の拡張パラメーターを使用できるようになりました。
  		名称変更	このメソッドの名前は現在 です。以前の IsEmpty メソッドの実装は削除されました。
  		廃止	ページの分類は、 メソッドで オブジェクトを使用して実行できるようになりました。入力パラメーターとして、 が必要です。これは、 メソッドを使用して作成できます。
  		非推奨	このプロパティは現在非推奨であり、今後のバージョンで削除される予定です。ファイルにテキストコンテンツがあるかどうかを確認するには、 メソッドを使用してください。

  Batch Processor

  ​

  | オブジェクト/列挙体 | プロパティ/メソッド/定数 | 変更内容 | コメント | | ---------------------------------------------------------------------------------- | ------------------------ | ------------------ |

  | | BatchProcessor | StartEx | 削除 | Start メソッドで、高度な画像ソース インターフェイスが使用されるようになりました。このインターフェイスの名前も IImageSource に変更されました。 | | IImageSourceEx | | 名称変更 | このインターフェイスは現在 IImageSource という名称です。 | | IImageSource | | 動作変更 | この インターフェイスでは、画像ファイルに加えて画像ドキュメントもキューに追加できるようになりました。 |

  メカニズムオブジェクト

  		削除	このオブジェクトは廃止されています。そのメソッドは、 および オブジェクトの、より効率的なメソッドに置き換えられました。これらのメソッドでは、どの処理段階でも DocumentInfo オブジェクトを保持したり、IRecognizedPages インターフェイスを実装したりする必要はありません。
  		削除済み	キャッシュ辞書を扱うには、 、 、 メソッドを使用します。
  		削除されました	メソッドを代わりに使用してください。
  		削除	代わりに メソッドを使用してください。
  		削除済み	代わりに メソッドを使用してください。
  		削除済み	メソッドを代わりに使用してください。
  		削除済み	まったく同じように動作する プロパティを使用してください。
  		削除	代わりに メソッドを使用してください。これはまったく同様に動作します。
  		廃止	代わりに IImageDocument::RemoveGeometricalDistortions メソッドを使用してください。
  		削除済み	メソッドを代わりに使用してください。
  		削除	代わりに、 メソッドを使用してください。
  		削除済み	代わりに メソッドを使用してください。
  		削除されました	代わりに メソッドを使用してください。
  		削除されました	代わりに メソッドを使用してください。
  		削除	代わりに メソッドを使用してください。このメソッドは、文書の合成を含む文書全体の処理を実行します。
  		削除	代わりに メソッドを使用してください。
  		廃止	代わりに メソッドを使用してください。
  		削除されました	代わりに メソッドを使用してください。
  		削除されました	画像をプレーンテキストとして認識するには、 を画像から作成するために メソッドを使用し、 メソッドで文書を認識した後、 プロパティにアクセスします。
  		削除	ページをプレーンテキストとして認識するには、 メソッドを使用し、その後 プロパティにアクセスします。
  		削除	代わりに メソッドを使用します。
  		廃止	代わりに メソッドを使用してください。
  		削除	このオブジェクトは廃止されています。そのメソッドは、より効率的な および オブジェクトのメソッドに置き換えられました。これらのメソッドでは、すべての処理段階で DocumentInfo オブジェクトを保持したり、IRecognizedPages インターフェイスを実装したりする必要はありません。
  		廃止	代わりに メソッドを使用してください。
  		廃止	代わりに メソッドを使用してください。
  		削除	イベントを通知していたオブジェクトが削除されたため、このインターフェイスは不要になりました。 および インターフェイスは、DocumentAnalyzer の代わりとなるオブジェクトについて、進行状況やエラーに関する同様の情報を提供します。
  		削除	イベントを通知するオブジェクトが削除されたため、このインターフェイスは不要になりました。 これらの および インターフェイスは、Exporter に代わって使用されるオブジェクトについて、進行状況やエラーに関する同様の情報を提供します。
  		削除	この型のオブジェクトを必要とするメソッドは削除されました。
  	FREM_DocumentAnalyzer	削除	この定数は現在は使用されていません。

  Parameter オブジェクト

  		削除	このプロパティは FineReader Engine 11 以降で廃止されました。代わりに プロパティを使用してください。
  		削除	このプロパティは FineReader Engine 11 以降で廃止されました。代わりに、 プロパティ ( オブジェクト) を使用してください。
  		削除	プロパティを使用すると、スペースを使って元のテキストのレイアウトを再現できます。
  	WS_Default	削除済み	Windows 最高の認識精度を得るため、WS_Auto の使用を推奨します。 現在のオペレーティングシステムの言語に対応する筆記スタイルを選択する必要がある場合は、WS_DetectByLocale を使用してください。
  		廃止	代わりに、KeepPageBreaks プロパティを使用してください。
  	PEM_SingleLineParagraphsWithSpaceFormatting	削除	TXT形式へのエクスポート時にスペースを使って元のテキストの見た目を再現するには、 プロパティを使用します。
  		削除	暗号化の種類を選択するには、 プロパティを使用します。
  		廃止	認識言語の自動検出を制御するには、LanguageDetectionMode プロパティを使用します。
  		削除	新しい プロパティを使用してください。これにより、さまざまな信頼度レベルを区別する必要がなくなり、不確かに認識された文字をハイライトするかどうかをシンプルに選択できます。より細かな区別が必要な場合は、 で選択した のプロパティを使用してください。ただし、異なる文字の認識信頼度を同じしきい値で比較しても、必ずしも一貫した結果が得られるとは限りません。
  		非推奨	認識モードの設定には プロパティと 定数を使用してください (RM_Normal は BalancedMode = TRUE に、RM_Fast は FastMode = TRUE に対応します) 。
  	AEM_FastMode AEM_BalancedMode	非推奨	これらの定数を使用するモジュールは非推奨になりました。
  		削除	この列挙型を使用していたプロパティは削除されました。
  		名前が変更され、型も変更されました	これらのプロパティの名称は現在 および CorrectResolution で、型は です。既定の動作は従来どおりです。
  		名称変更、型変更	これらのプロパティは 、 に名称変更され、型は 型になりました。既定値の動作は従来どおりです。
  		名称と型が変更されました	このプロパティの名称は現在 に変更されており、型は です。既定では、画像は背景の一部として扱われません。
  		削除されました	これらの列挙型を使用していたプロパティは、現在は別の型になっています。
  		非推奨	このプロパティは現在非推奨であり、今後のバージョンで削除される予定です。同じ結果を得るには、 プロパティを TXTLRM_ExactCopy に設定します。
  		削除されました	このプロパティはすでに非推奨となっていました。
  		非推奨	このプロパティは非推奨となっており、今後のバージョンで削除される予定です。
  		非推奨	これらのプロパティは現在非推奨であり、今後のバージョンで削除される予定です。
  		Windows および Linux では非推奨	このプロパティは現在非推奨であり、今後のバージョンで削除されます。

  分類関連オブジェクト

  ​

  | オブジェクト/列挙体 | プロパティ/メソッド/定数 | 変更内容 | コメント | |

  ​

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

  | | ClassificationEtalon ClassificationParams ClassificationClass ClassificationClasses ClassificationTrainer ClassificationTrainerError ClassificationTrainerErrors ClassificationTrainerErrorTypeEnum ClassificationModeEnum | | 削除 | 旧Classification APIは削除されました。分類モデルの学習は現在、 Trainerオブジェクトで実行し、設定は TrainingParamsおよび ValidationParamsで指定し、入力データは TrainingDataとして渡します。文書またはページの分類は、 Modelオブジェクトを使用して実行できます。学習と分類のいずれでも、事前に文書またはページを ClassificationObjectに変換しておく必要があります。これは、 ClassificationEngineオブジェクトのメソッドで行えます。併せて、Classification-Related ObjectsおよびClassificationシナリオの 説明も参照してください。 |

  補助オブジェクト

  		削除	この型のオブジェクトを必要としていたメソッドは削除されました。
  		削除	文書の著者、キーワード、件名、タイトルに関する情報を含むこのオブジェクトは、FRDocument オブジェクトの プロパティから取得できます。