# TransformImage

TransformImage は、CalibratePoints 関数によって生成された Calib データ構造体を使用して、歪みを考慮した Image データ構造体を生成します。

注 : この関数は、グレースケール画像のみを出力します。

## TransformImage の概要

TransformImage は、ExtractCalibrationPoints 関数によって引数として参照される CalibratePoints Calib データ構造体と Image データ構造体を使用して、Image データ構造体を生成します。この構造体は線形、非線形、およびレンズ歪みを考慮した「歪みのない」バージョンの画像を返します。この新しい出力画像は、内部 2D 変換が行われ、ワールド座標に基づいています。

注 : 関数がスプレッドシートに追加されたとき、指定の領域が変更されたとき、またはこの関数のジョブがロードされたときに生じる TransformImage 関数の学習の期間は、640 x 480 解像度の In-Sight ビジョンシステムでは 3 秒、1600 × 1200 解像度のビジョンシステムでは 30 秒かかることがあります。

2D ツールの寸法は 640x480 でした。ただし、3D - A1000 の場合は 1430x1006、3D - L4000 の場合は 2880x8000 に変わります。したがって、現在、A1000 シリーズビジョンシステムによって取り込まれる最大ライン数は 1430 になり、L4000 シリーズビジョンシステムによって取り込まれる最大ライン数は 2880 になります。A1000 In-Sight デバイスの最大幅は 1006、L4000 In-Sight デバイスの最大幅は 8000 です。

## TransformImage の入力

パラメータ | 説明
画像 | This parameter must reference a spreadsheet cell that contains an 画像 data structure; by default, this parameter references A0, the cell containing the data structure. This parameter can also reference other Image data structures, such as those returned by the 画像Vision Data Access functions or 座標補正関数.
キャリブレーション | この引数は、Calibrate 関数によって作成される有効な Calib データ構造体を含んでいるスプレッドシートのセルを参照している必要があります。
領域 | これは対象領域 (ROI) とも呼ばれ、解析の対象となる画像の領域を表します。[領域] パラメータをダブルクリックすると、変換と回転が可能な対話型グラフィックスモードを作成できます。このパラメータを選択して、プロパティシートの [ジョブの編集] ツールバーにある [領域の最大化] ボタンを押すと、画像全体が対象になるように領域が自動的に拡張されます。
X | フィクスチャ座標での原点の X オフセット.
Y | フィクスチャ座標での原点の Y オフセット
幅 | 領域の Y 軸に沿った寸法。
高さ | 領域の X 軸に沿った寸法。
画像スケール | 変換後の画像が表示されるスケールを指定します。最小の設定値は 0.01、最大の設定値は 10.00、デフォルトの設定値は 1.000 です。
参照点 | 変換の原点参照点を指定します。
0 = 画像の中心 (デフォルト) | 参照点は画像の中心になります。
1 = 領域の中心 | 参照点は ROI の中心になります。
表示 | 画像上の TransformImageグラフィックスの表示モードを指定します。
0 = 非表示 | TransformImageを含んでいるセルがスプレッドシート内でハイライトされている場合を除き、すべてのグラフィックスが表示されません。
1 = 結果のグラフィックスのみ | 歪みのない画像が常に表示されます。
2 = 入力と結果のグラフィックス | 入力画像領域と歪みのない画像が常に表示されます。

## TransformImage の出力

戻り値 | 処理済みの画像を含んでいる Image データ構造体。入力パラメータが無効であれば #ERR を返します。 新しい出力画像はワールド座標系に基づいています。この画像を参照する In-Sight ビジョンツールは、ワールド座標の値で結果を報告します。 注 : Image データ構造体に含まれている処理済みの画像領域の内容は、ジョブとともに保存されません。