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.
このオブジェクトには、ImageDocument オブジェクト (CoordinatesConverter プロパティ) から取得された時点での画像上のピクセル座標に関する情報が格納されています。これにより、ある画像変更状態から別の画像変更状態へピクセル座標を変換できます。
このオブジェクトを使用すると、画像処理内の任意の 2 つの段階の間でピクセル座標を変換できます。例:
- 画像を開いた直後にこのオブジェクトを取得します。このとき、画像の傾き補正が実行されます。
- さらにいくつかの変更を適用し、ImageDocument からこのオブジェクトの別のインスタンスを取得します。
- これで、ConvertCoordinates メソッドを 2 回適用することで、最初に傾き補正されたイメージプレーンと変更後のイメージプレーンの間でピクセル座標を変換できます:
- 1 つ目の CoordinatesConverter インスタンスを使用して、傾き補正済みのイメージプレーンから元のイメージプレーンへ変換します。
- 2 つ目の CoordinatesConverter インスタンスを使用して、結果を元のイメージプレーンから変更後のイメージプレーンへ変換します。
CoordinatesConverter オブジェクトは永続化可能なオブジェクトです。つまり、オブジェクトの現在の状態を永続ストレージに書き込むことができます。後で、永続ストレージからオブジェクトの状態を読み取ることで、オブジェクトを再作成できます。オブジェクトの永続化には、次のメソッドを使用します。
Linux: SaveToFile、および LoadFromFile
Windows: SaveToFile、LoadFromFile、SaveToMemory、および LoadFromMemory。
| Name | 型 | 説明 |
|---|
| Application | Engine, 読み取り専用 | Engine オブジェクトを返します。 |
| 名前 | 説明 |
|---|
| ConvertCoordinates | ImageDocument の異なる変更状態またはイメージプレーン間で、ピクセルの座標を変換します。 |
| LoadFromFile | ディスク上のファイルからオブジェクトの内容を復元します。 |
| LoadFromMemory | グローバルメモリからオブジェクトの内容を復元します。 |
| SaveToFile | オブジェクトの内容をディスク上のファイルに保存します。 |
| SaveToMemory | オブジェクトの内容をグローバルメモリに保存します。 |
オブジェクト図
以下は、このオブジェクトを使用して、2つの異なる変更状態間で座標を変換する Windows 向けのサンプルです。
FREngine.IEngine engine;
FREngine.IFRDocument frDoc;
// 画像をDocumentに追加する際、デフォルトで傾き補正が実行されます
frDoc.AddImageFile ("D:\\Sample.tif", null, null);
// 最初のページのImageDocumentを開く
FREngine.IImageDocument imageDoc = frDoc.Pages[0].ImageDocument;
// 開いた後の座標スナップショットを作成する
FREngine.ICoordinatesConverter convAfterOpening = imageDoc.CoordinatesConverter;
// さらに画像を変換する
imageDoc.Transform(FREngine.RotationTypeEnum.RT_Counterclockwise, false, false);
// 変換後の座標スナップショットを作成する
FREngine.ICoordinatesConverter convAfterModification = imageDoc.CoordinatesConverter;
...
// 処理後、変換が必要な座標を持つピクセルが変更済みイメージプレーン上で見つかった場合
int x, y;
convAfterModification.ConvertCoordinates(FREngine.ImageTypeEnum.IT_Base, FREngine.ImageTypeEnum.IT_Modified, ref x, ref y);
convAfterOpening.ConvertCoordinates(FREngine.ImageTypeEnum.IT_Modified, FREngine.ImageTypeEnum.IT_Base, ref x, ref y);
// この時点で x, y には傾き補正済みイメージプレーン上の目的の点の座標が格納されています
