# Calibrate

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

## Calibrate について

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

キャリブレーションフェーズでは、ワールド座標系での位置が分かっている特徴を含んでいる画像がこの関数で取り込まれます。ピクセル座標系で画像の位置を見つけてその特徴をレポートするため、この関数では や FindLine などのビジョンツールを使用します。

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

次のフェーズでは、Calibrate で、[ピクセルポイント] および [ワールドポイント] パラメータとしてピクセル座標系とワールド座標系の両方を入力します。ピクセルポイント座標系の場合、ビジョンツールの X 値と Y 値へのセル参照を使用します。ワールドポイント座標系の場合、Calibrate では数値を入力します。この関数によって、ピクセル座標系とワールド座標系の間で 2D 変換が計算され、この変換を表す Calib 構造体が作成されます。

Calibrate は、以下の変換にも使用できます。

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

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

## Calibrate の入力

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

## Calibrate の出力

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