> ## 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.

# CoordinatesConverter オブジェクト（ICoordinatesConverter インターフェイス）

> ABBYY FineReader Engine API の CoordinatesConverter オブジェクト（ICoordinatesConverter インターフェイス）— ImageDocument から取得された時点での画像のピクセル座標情報を保持し、変更状態またはイメージプレーン間でピクセル座標を変換できます。

このオブジェクトには、[ImageDocument](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument) オブジェクト ([CoordinatesConverter](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument#coordinatesconverter) プロパティ) から取得された時点での画像上のピクセル座標に関する情報が格納されています。これにより、ある変更状態から別の変更状態へピクセル座標を変換できます。

このオブジェクトを使用すると、画像処理内の任意の 2 つの段階の間でピクセル座標を変換できます。例:

1. 画像を開いた直後にこのオブジェクトを取得します。このとき、画像の傾き補正が実行されます。
2. さらにいくつかの変更を適用し、ImageDocument からこのオブジェクトの別のインスタンスを取得します。
3. これで、ConvertCoordinates メソッドを 2 回適用することで、最初に傾き補正されたイメージプレーンと変更後のイメージプレーンの間でピクセル座標を変換できます:
   * 1 つ目の CoordinatesConverter インスタンスを使用して、傾き補正済みのイメージプレーンから元のイメージプレーンへ変換します。
   * 2 つ目の CoordinatesConverter インスタンスを使用して、結果を元のイメージプレーンから変更後のイメージプレーンへ変換します。

CoordinatesConverter オブジェクトは永続化可能なオブジェクトです。つまり、オブジェクトの現在の状態を永続ストレージに書き込むことができます。後で、永続ストレージからオブジェクトの状態を読み取ることで、オブジェクトを再作成できます。オブジェクトの永続化には、次のメソッドを使用します。

Linux: [SaveToFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)、および [LoadFromFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)

Windows: [SaveToFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)、[LoadFromFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)、[SaveToMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method)、および [LoadFromMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method)。

<div id="properties">
  ## プロパティ
</div>

| Name        | 型                                                                                                                                                                                                                | 説明                  |
| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- |
| Application | [Engine](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface), [読み取り専用](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties) | Engine オブジェクトを返します。 |

<div id="methods">
  ## メソッド
</div>

| 名前                                                                                                                              | 説明                                                                                                                             |
| ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| [ConvertCoordinates](/ja/fine-reader/engine/api-reference/image-related-objects/coordinatesconverter/convertcoordinates-method) | [ImageDocument](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument) の異なる変更状態またはイメージプレーン間で、ピクセルの座標を変換します。 |
| [LoadFromFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)                      | ディスク上のファイルからオブジェクトの内容を復元します。                                                                                                   |
| [LoadFromMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method)                  | グローバルメモリからオブジェクトの内容を復元します。 <Note> *Windows で使用できます。*</Note>                                                                    |
| [SaveToFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)                          | オブジェクトの内容をディスク上のファイルに保存します。                                                                                                    |
| [SaveToMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method)                      | オブジェクトの内容をグローバルメモリに保存します。 <Note> *Windows で使用できます。*</Note>                                                                     |

<div id="related-objects">
  ## 関連するオブジェクト
</div>

<img src="https://mintcdn.com/abbyy/6udH-pkk8zkVafYH/images/fine-reader/engine/coordinatesconverter.gif?s=569f3a2af2749c842aa6594c093cc407" alt="CoordinatesConverter" width="141" height="57" data-path="images/fine-reader/engine/coordinatesconverter.gif" />[](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument#coordinatesconverter)[](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument)

[オブジェクト図](/ja/fine-reader/engine/api-reference/object-diagram)

<div id="samples">
  ## サンプル
</div>

以下は、このオブジェクトを使用して、2つの異なる変更状態間で座標を変換する Windows 向けのサンプルです。

<div id="c">
  ### C\#
</div>

```csharp theme={null}
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 には傾き補正済みイメージプレーン上の目的の点の座標が格納されています
```

このオブジェクトは、macOS 向けの [名刺認識](/ja/fine-reader/engine/guided-tour/samples#bcr_mac) コードサンプルでも使われています。

<div id="see-also">
  ## 関連項目
</div>

[ImageDocument](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument)

[画像の操作](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-images)

[プロパティの操作](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)