# AcquireImage

AcquireImage 関数は、デジタル画像を取り込み、In-Sight ビジョンシステムの処理メモリに転送するためのパラメータを指定します。

In-Sight ビジョンシステムは、非同期リセットとプログレッシブスキャンを使用してすべての画像を取り込みます。グレースケールビジョンシステムが 8 ビット画像を生成するのに対して、カラービジョンシステム (末尾に C が付きます) は 24 ビット画像を生成します。すべてのビジョンシステムで約 250µs 以内に画像取り込みプロセスが開始され、次のように進行します。

- 画像センサは、[露光] パラメータで指定された時間、光を蓄積します。
- 画像センサに蓄積された画像は行単位でシリアルシフトレジスタに転送されます。

- すべての行転送に対し、センサはピクセルごとに画像センサ外部でシフトレジスタをクロッキングして、次の経路を通じてピクセル値を転送します。

  ビデオ増幅器 → ゲインおよびオフセット → A/D コンバータ → In-Sight センサのメモリ

取り込まれた画像を含むメモリバッファは、スプレッドシート内で Image データ構造体として表されます。AcquireImage によって返される Image データ構造体は、画像領域を処理する他の In-Sight スプレッドシート関数によって順番に参照されます。取り込まれた画像データに直接あるいは間接的に依存する関数はすべて、新しい画像が取り込まれると更新されます。入力画像とスプレッドシート内の他の関数との関係によって、In-Sight ビジョンシステムで実行される画像処理タスクが決まります。依存関係およびセルの実行順序の詳細については、「スプレッドシートのセルの実行」を参照してください。

スプレッドシートの初回作成時、AcquireImage 関数が自動的に追加され、セル A0 に配置されます。ほとんどのビジョンツール関数や他の多くの関数は、この関数を、セル A0 への絶対参照をそのデフォルトの画像ソースとして指定することによって利用します。詳細については、「セル参照」を参照してください。

注意 : AcquireImage 関数はスプレッドシートから削除できますが、画像取り込みができなくなるため削除しないでください。セル A0 から AcquireImage 関数を誤って削除した場合は、[編集] > [取り消し] メニューで削除を取り消すか、Ctrl+Z を押すか、または AcquireImage() セル数式を入力して関数を追加し直します。

AcquireImage 関数のパラメータを変更する場合は、スプレッドシート横の [取り込み] パネルをクリックします。詳細については、[取り込み] パネルを参照してください。

注 :

- 関数には引数がないため、セルをセルテンプレートとしてエクスポートする際、設定した取り込み設定は保持されません。取り込み設定をエクスポートするには、スプレッドシートに ApplyAcquisitionSettings を追加し、保持するパラメータを有効にして、設定を目的の値に設定し、ApplyAcquisitionSettings をセルテンプレートとしてエクスポートします。ApplyAcquisitionSettings を含むセルテンプレートをインポートし、ApplyAcquisitionSettings セルを実行すると、取り込み設定が 関数に適用されます。
- 画像パラメータを必要とする関数は、有効な Image データ構造体を含むスプレッドシートのセルを参照している必要があります。[画像] パラメータのデフォルトの参照先は､すべてのプロパティシートでセル A0 になります。セル A0 には、AcquireImage 関数によって返される Image データ構造体が含まれています。しかし、画像 関数によって返される Image データ構造体も、プロパティシートで [画像] パラメータ値の有効な参照先となります。

## ApplyAcquisitionSettings

[取り込み] パネルからスプレッドシートにパラメータをドラッグ & ドロップすると、ApplyAcquisitionSettings 関数がスプレッドシートに追加されます。この関数を使用すると、[取り込み] パネルを開くことなく実行時に画像取り込みパラメータを編集できます。[取り込み] パネルでは、ドラッグ & ドロップしたパラメータに青い感嘆符のアイコンが表示されます。このアイコンは、ApplyAcquisitionSettings 関数によってパラメータが上書きされていることを示します。このアイコンにマウスポインタを置くと、ApplyAcquisitionSettings 関数のセル位置がヒントとして表示されます。

注 :

- 関連するパラメータが ApplyAcquisitionSettings プロパティシートからドロップ & ドラッグされると、AcquireImage プロパティシートにも青い感嘆符のアイコンが表示されます。詳細については、「ApplyAcquisitionSettings」を参照してください。
- パラメータが複数の ApplyAcquisitionSettings 関数によって参照されている場合、このアイコンは、ApplyAcquisitionSettings 関数のセル位置 (最大 5 つ) を示します。

- ApplyAcquisitionSettings プロパティシートでパラメータのチェックをオフにすると、関連するパラメータの青い感嘆符アイコンは AcquireImage プロパティシートに表示されなくなります。