# CalibrateImage

キャリブレーションを画像と関連付けます。CalibrateImage は、キャリブデータ構造体を画像データ構造体と関連付けて、新しい画像データ構造体を作成します。得られるデータ構造体を別のビジョンツール関数が参照することで、参照されたキャリブレーションによって定義されたワールド座標でその結果を表示することができます。

例えば、Calibrate 関数を使用してセンサをキャリブレーションします。次に、CalibrateImage 関数を挿入し、[キャリブ] パラメータを、先ほど作成した Calibrate 関数のキャリブ構造体へのセル参照として設定します。次に、DetectBlobs などの別のビジョンツールを使用してその [画像] パラメータを CalibrateImage データ構造体へのセル参照として設定します。これによって、DetectBlobs 座標はキャリブレーションされた画像のワールド座標となります。

注: ワールド座標系で報告されるビジョンツールの出力を、他のビジョンツールでフィクスチャまたは領域の入力として使用することはできません。

## CalibrateImage の入力

パラメータ | 説明
画像 | この引数は、有効な画像データ構造体を含んでいるスプレッドシートのセルを参照している必要があります。 このパラメータは、スプレッドシートで画像データ構造体を含むセルを参照する必要があります。デフォルトでは、このパラメータは、 関数によって返された画像データ構造体を含むセル A0 を参照しています。また、このパラメータは、ビジョンツールの画像フィルタ関数や、座標補正関数により返された、その他の画像データ構造体も参照できます。
キャリブ | この引数は、有効なキャリブデータ構造体を含んでいるスプレッドシートのセルを参照している必要があります。

## CalibrateImage の出力

戻り値 | 処理済みの画像を含んでいる画像データ構造体。入力パラメータが無効であれば #ERR を返します。