# Calibrate

Calibrate は、ユーザ指定の 4 つの点を使用して、ピクセル座標系とワールド座標系の間で変換するための 2D 変換を作成します。

## Calibrate について

Calibrate 関数では、ユーザ指定の点を 2 つの異なる座標系で表す必要があります。取り込む対象物は物理的なワールド座標系、対象物の画像はピクセル座標系で表します。そのためには、Calibrate 関数でビジョンツールを使用して、画像から特徴を抽出する必要があります。次に、これらの特徴の位置をワールド座標とピクセル座標で入力します。

キャリブレーションフェーズでは、ワールド座標での位置が分かっている特徴を含んでいる画像が取り込まれます。FindLine などのビジョンツールを使用して、画像内の特徴を探してピクセル座標で報告します。

注: ピクセル座標の原点は常に左上のピクセルの左上隅です。

次に、ピクセル座標とワールド座標の両方を [ピクセルポイント] パラメータと [ワールドポイント] パラメータとして入力します。ピクセルポイント座標では、ビジョンツールの X 値と Y 値へのセル参照を使用しますが、ワールドポイントワールド座標を表すには数値を使用します。ピクセル座標とワールド座標の間で 2D 変換が計算され、この変換を表すキャリブ構造体が作成されます。

Calibrate は次の変換も行います。

- 2 次元での平行移動
- 3 本の軸まわりの回転
- 2 次元でのスケーリング
- 遠近歪み
- 平行四辺形化またはスキュー

注: Calibrate 関数を使用する場合、物理セットアップと光学セットアップ (レンズ、センサ、およびセンサと取り込まれるシーンの間の物理的関係) はキャリブレーション操作とランタイム操作の両方で同一にする必要があります。このうちのいずれかが変更された場合、システムを再キャリブレーションする必要があります。したがって、キャリブレートとランタイム画像の処理の両方で、同じセンサとレンズを使用することを推奨します。センサとレンズでは、元のセットアップおよびキャリブレーション設定を変更しないようにする必要があります。例えば、画像取り込みフォーマットの変更 (解像度の変更による) またはセンサの移動を行うと、ピクセルをワールド座標にマッピングする 2D 変換が不正になります。

## Calibrate の入力

入力 | 説明
--- | ---
ピクセルポイント 0 ～ N | ピクセル座標とワールド座標の関連付けのピクセル座標系を指定します。
X | 画像の X 座標。
Y | 画像の Y 座標。
ワールドポイント 0 ～ N | ピクセル座標とワールド座標の関連付けのワールド座標系を指定します。
X | ワールド値での X 軸座標。
Y | ワールド値での Y 軸座標。

## Calibrate の出力

戻り値 | 2 つの座標系間の変換を定義する係数を含むキャリブデータ構造体。