# CalibrateImage

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

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

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

## CalibrateImage の入力

パラメータ | 説明
画像 | この引数は、有効な 画像 データ構造体を含んでいるスプレッドシートのセルを参照している必要があります。 This parameter must reference a spreadsheet cell that contains an 画像 data structure; by default, this parameter references A0, the cell containing the Image data structure returned by function. This parameter can also reference other 画像 data structures, such as those returned by the Vision Tool 画像フィルタ関数 or 座標補正関数.
キャリブ | この引数は、有効な Calib データ構造体を含んでいるスプレッドシートのセルを参照している必要があります。

## CalibrateImage の出力

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