# LatchImage

指定したイベントでの画像を保存 (ラッチ) します。

## LatchImage の入力

パラメータ | 説明
画像 | この引数は、有効な画像データ構造体を含んでいるスプレッドシートのセルを参照している必要があります。デフォルトで参照されるセルは A0 で、このセルには画像データ構造体が含まれています。
フィクスチャ | Fixture入力、またはビジョンツール関数の画像座標系の出力に関連する対象領域 (ROI) を定義します。フィクスチャに関連する ROI を設定すると、フィクスチャが回転または移動した場合に、フィクスチャに対応して ROI を確実に回転または移動できます。 デフォルト設定は画像の左上隅で、(0, 0, 0) になります。
X | 画像座標で X オフセットを指定します。
Y | 画像座標で Y オフセットを指定します。
角度 | 画像座標での角度
領域 | これは対象領域 (ROI) とも呼ばれ、画像処理の対象となる画像の領域を指定します。変換および回転可能な領域を作成します。このパラメータを選択して、ボタンを押すと、画像全体が対象になるように領域が自動的に拡張されます。
X | フィクスチャ座標での原点の X オフセット
Y | フィクスチャ座標での原点の Y オフセット
幅 | 領域の X 軸に沿った寸法
高さ | 領域の Y 軸に沿った寸法
角度 | フィクスチャ座標での角度
注: [フィクスチャ] および [領域] パラメータは、画像の範囲内で定義されている必要があります。画像の範囲内で定義されていない場合、この関数は #ERR を返します。
イベント | 画像を保存する更新イベントを指定します。このパラメータは、次のいずれかを参照している必要があります。 セル A0 (デフォルト、関数を含む) の画像データ構造体。 Button 関数を含んでいるセル。
カラー化 | カラー画像にのみ影響します。無効にすると、ラッチした画像は、グレースケールに変換されます。それ以外の場合、カラーのまま保持されます。
0 = 無効 (デフォルト)
1 = 有効
表示 | 画像の上に表示するグラフィックスオーバーレイを指定します。
0 = 非表示 (デフォルト) | 関数を含んでいるセルがスプレッドシート内のアクティブセルである場合を除き、グラフィックス項目は表示されません。 注: 入力領域が変更されると、2 番目の領域が表示され、指定した次のイベントでラッチが発生する位置を示します。
1 = 結果のグラフィックスのみ | 処理された画像が常に表示されます。
2 = 入力のグラフィックスのみ | 入力画像領域と関連付けられているグラフィックス項目が常に表示されます。

## LatchImage の出力

戻り値 | 最後のイベントで保存された画像を含む LatchImage データ構造体。