# ApplyAcquisitionSettings

AcquireImage プロパティシートからパラメータを選択し、そのパラメータをスプレッドシートにドラッグすることで、ApplyAcquisitionSettings 関数をスプレッドシートに追加できます。ApplyAcquisitionSettings 関数は、AcquireImage 関数で示されている画像取り込みパラメータの setter として機能します。この関数を使用すると、実行時にスプレッドシートから迅速かつ簡単に画像取り込み設定を変更したり、AcquireImage プロパティシートを開かずに外部通信 (FFP) またはビジョンツールの出力に基づいて設定を更新したりできるので便利です。

ApplyAcquisitionSettings 関数でサポートされているパラメータは次のとおりです。

- [トリガタイプ]、[デバウンス (ms)]、[遅延 (ms)]、[露光 (ms)]、[オフセット]、[ゲイン]、[方向]、[取り込み開始行]、[行数]
- 照明:[モード]、[明度]、[バンク有効]、[常に ON]
- ハイダイナミックレンジ:[HDR モード]、[HDR+ カーネルサイズ]

注 :

- その他のパラメータ ([トリガモード] など) を AcquireImage プロパティシートからスプレッドシートにドラッグ & ドロップすることはできません。

- 接続されているデバイスでサポートされていないパラメータはグレイアウトされ、ドラッグ & ドロップできません。
- 関数には引数がないため、セルをセルテンプレートとしてエクスポートする際、設定した取り込み設定は保持されません。取り込み設定をエクスポートするには、スプレッドシートに ApplyAcquisitionSettings を追加し、保持するパラメータを有効にして、設定を目的の値に設定し、ApplyAcquisitionSettings をセルテンプレートとしてエクスポートします。ApplyAcquisitionSettings を含むセルテンプレートをインポートし、ApplyAcquisitionSettings セルを実行すると、取り込み設定が 関数に適用されます。スプレッドシートセルテンプレートの詳細については、「テンプレートに対するセルのエクスポートとインポート」を参照してください。

## ApplyAcquisitionSettings の使用法

1. セル A0 の AcquireImage プロパティシートを開きます。
2. パラメータを AcquireImage プロパティシートからスプレッドシートにドラッグします。

3. ApplyAcquisitionSettings 関数がスプレッドシートに追加され、AcquisitionSettings データ構造体、パラメータのラベル、およびエディットコントロールが返されます。例えば、[デバウンス (ms)] パラメータをスプレッドシートにドラッグ & ドロップすると、AcquisitionSettings データ構造体、"デバウンス (ms)" ラベル、エディットコントロールがスプレッドシートに入力されます。

4. [OK] をクリックして AcquireImage プロパティシートを閉じます。

5. スプレッドシートに別の画像取り込みパラメータを追加する場合は、ApplyAcquisitionSettings プロパティシートを開きます。

   注 : 最初に ApplyAcquisitionSettings 関数を作成してからパラメータを ApplyAcquisitionSettings プロパティシートからドラッグ & ドロップするようお勧めします。複数のパラメータを AcquireImage からドラッグすると、複数の ApplyAcquisitionSettings 関数が作成され、各関数にどのパラメータが設定されているのかわからなくなります。

6. 目的のパラメータのチェックボックスをオンにします。例えば、[遅延 (ms)] パラメータをスプレッドシートに追加するには、[遅延 (ms)] パラメータのチェックボックスをオンにします。

7. パラメータをスプレッドシートにドラッグ & ドロップします。

8. パラメータのラベルとエディットコントロールがスプレッドシートに入力されます。例えば、[遅延 (ms)] パラメータをスプレッドシートにドラッグ & ドロップすると、"遅延 (ms)" ラベルとエディットコントロールがスプレッドシートに入力されます。

9. 目的のパラメータがすべて追加されるまで、手順 5 ～ 8 を繰り返します。
10. 必要に応じ、エディットコントロールの値を変更します。

11. 新しい値は、次の画像取り込み時に適用されます。

    注 : カメラトリガモードを使用している場合、新しい値は次のデバイストリガの後に適用されます。

注 :

- スプレッドシートに複数の ApplyAcquisitionSettings 関数がある場合、最後に更新された値のみが画像取り込みで使用されます。
- パラメータのラベルとエディットコントロールは、AcquireImage プロパティシートまたは ApplyAcquisitionSettings プロパティシートからスプレッドシートにパラメータをドラッグ & ドロップした場合にのみ入力されます。他の方法 (セルに ApplyAcquisitionSettings と入力するなど) で ApplyAcquisitionSettings 関数を挿入した場合、AcquisitionSettings データ構造体のみ入力されます。
- ApplyAcquisitionSettings プロパティシートでパラメータのチェックをオフにすると、AcquireImage 関数で、スプレッドシート上の関連するエディットコントロールによってその値が上書きされることがなくなります。

## ApplyAcquisitionSettings の出力

サポートされているパラメータを AcquireImage プロパティシートからスプレッドシートにドラッグ & ドロップすると、次が返されます。

戻り値 | AcquisitionSettings データ構造体 パラメータのラベル パラメータのエディットコントロール