Acquisition Start, Stop, and Abort#

Acquisition Start, Stop, and Abortコマンドを使用すると、画像取得を制御できます。

機能を使用する#

Starting Image Acquisition#

画像取り込みを有効にするには、次を実行します。 AcquisitionStart コマンド。

コマンドが実行されると、カメラはトリガー信号を待機します。トリガー信号は、カメラによって内部で生成される（フリーラン）か、外部で適用されます（トリガー画像取得）。

Stopping Image Acquisition#

画像取り込みを無効にするには、次を実行します。 AcquisitionStop コマンド）。コマンドが実行されると、次の動作が発生します。

エリアスキャンカメラの場合：

• カメラが現在フレームを取得していない場合、画像取得は直ちにオフになります。
• カメラが現在画像データを読み取っている場合、読み取りプロセスは終了できます。その後、画像取得がオフになります。
• カメラが現在フレームを露光している場合：
  • 一部のカメラモデルでは、 AcquisitionStop コマンド を実行すると 露光が中断されます。この場合、カメラはすぐに露光を停止し、画像データの読み出しを開始します。読み出しプロセスは最後まで実行されます。その後、画像acquisitionがオフになります。
  • 一部のカメラモデル、 設定 を実行すると露光が中断されるかどうかを AcquisitionStop できます。これを行うには、 AcquisitionStopMode パラメータを AbortExposure または Complete.

ラインスキャンカメラの場合：

• イメージ AcquisitionStopMode ラインスキャンカメラのパラメータは常に次のように設定されます。 Immediate.
• カメラが現在フレームを取得していない場合、画像取得は直ちにオフになります。
• カメラが現在ラインを露光中の場合、 AcquisitionStop コマンドを実行すると、 すべての racer 2 ラインスキャンカメラで次の動作が発生します。
  現在のラインの露光が完了します。acquisitionが直ちに停止します。最後に取得されたラインがホストコンピュータに転送されます。
• さらに、GigEインターフェースを備えたracer 2 Sカメラには、次のことが当てはまります。
  コマンドが実行された時点までに取得されたラインのみがホストコンピュータに配信されます。これにより、部分的なフレームが転送される場合があります。

Aborting Image Acquisition#

画像acquisitionを中断するには、 AcquisitionAbort コマンドを実行します（（使用している場合）に設定しますを使用します。

エリアスキャンカメラでは、コマンドの実行時に次の動作が発生します。

• カメラが現在フレームを取得していない場合、画像acquisitionは直ちにオフになります。
• カメラが現在フレームを露光中の場合、カメラはすぐに露光を停止します。すでに開始されている場合は、読み出しプロセスが中断されます。現在のフレームは不完全になり、ホストコンピュータには送信されません。その後、画像acquisitionがオフになります。
• カメラが現在画像データを読み出し中の場合、カメラは読み出しプロセスをすぐに停止します。現在のフレームは不完全になり、ホストコンピュータには送信されません。その後、画像acquisitionがオフになります。

ラインスキャンカメラでは、コマンドの実行時に以下の動作が発生します。

• カメラが現在ラインを取得中ではない場合、画像acquisitionはすぐにオフになります。
• カメラが現在ラインを露光中の場合、カメラはすぐに露光を停止します。すでに開始されている読み出しプロセスは継続されます。コマンドが実行された時点までに取得されたラインのみがホストコンピュータに送信されます。GigEインターフェースを搭載したラインスキャンカメラの場合、これによりパーシャルフレームが送信される可能性があります。その後、画像acquisitionがオフになります。
• カメラが現在画像データを読み出し中の場合、コマンドが実行された時点までに取得されたすべてのラインがホストコンピュータに送信されるまで、読み出しプロセスが継続されます。GigEインターフェースを搭載したラインスキャンカメラの場合、これは現在のフレームが不完全（パーシャルフレーム）になる可能性があることを意味します。
  その後、画像acquisitionがオフになります。

特性#

すべてのカメラモデルを表示します

サンプルコード#

// Configure continuous image acquisition on the cameras
camera.AcquisitionMode.SetValue(AcquisitionMode_Continuous);
// Switch on image acquisition
camera.AcquisitionStart.Execute();
// The camera waits for trigger signals
// (...)
// Switch off image acquisition
camera.AcquisitionStop.Execute();
// Switch image acquisition back on
camera.AcquisitionStart.Execute();
// The camera waits for trigger signals
// (...)
// Abort image acquisition
camera.AcquisitionAbort.Execute();

INodeMap& nodemap = camera.GetNodeMap();
// Configure continuous image acquisition on the cameras
CEnumParameter(nodemap, "AcquisitionMode").SetValue("Continuous");
// Switch on image acquisition
CCommandParameter(nodemap, "AcquisitionStart").Execute();
// The camera waits for trigger signals
// (...)
// Switch off image acquisition
CCommandParameter(nodemap, "AcquisitionStop").Execute();
// Switch image acquisition back on
CCommandParameter(nodemap, "AcquisitionStart").Execute();
// The camera waits for trigger signals
// (...)
// Abort image acquisition
CCommandParameter(nodemap, "AcquisitionAbort").Execute();

// Configure continuous image acquisition on the cameras
camera.Parameters[PLCamera.AcquisitionMode].SetValue(PLCamera.AcquisitionMode.Continuous);
// Switch on image acquisition
camera.Parameters[PLCamera.AcquisitionStart].Execute();
// The camera waits for trigger signals
// (...)
// Switch off image acquisition
camera.Parameters[PLCamera.AcquisitionStop].Execute();
// Switch image acquisition back on
camera.Parameters[PLCamera.AcquisitionStart].Execute();
// The camera waits for trigger signals
// (...)
// Abort image acquisition
camera.Parameters[PLCamera.AcquisitionAbort].Execute();

/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK;  /* Return value of pylon methods */
/* Configure continuous image acquisition on the cameras */
errRes = PylonDeviceFeatureFromString(hdev, "AcquisitionMode", "Continuous");
CHECK(errRes);
/* Switch on image acquisition */
errRes = PylonDeviceExecuteCommandFeature(hdev, "AcquisitionStart");
CHECK(errRes);
/* The camera waits for trigger signals */
/* (...) */
/* Switch off image acquisition */
errRes = PylonDeviceExecuteCommandFeature(hdev, "AcquisitionStop");
CHECK(errRes);
/* Switch image acquisition back on */
errRes = PylonDeviceExecuteCommandFeature(hdev, "AcquisitionStart");
CHECK(errRes);
/* The camera waits for trigger signals */
/* (...) */
/* Abort image acquisition */
errRes = PylonDeviceExecuteCommandFeature(hdev, "AcquisitionAbort");
CHECK(errRes);

# Configure continuous image acquisition on the cameras
camera.AcquisitionMode.Value = "Continuous"
# Switch on image acquisition
camera.AcquisitionStart.Execute()
# The camera waits for trigger signals
# (...)
# Switch off image acquisition
camera.AcquisitionStop.Execute()
# Switch image acquisition back on
camera.AcquisitionStart.Execute()
# The camera waits for trigger signals
# (...)
# Abort image acquisition
camera.AcquisitionAbort.Execute()

pylon Viewerを使用して、パラメーターを簡単に設定することもできます。