Acquisition Start, Stop, and Abort#

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

機能を使用する#

Starting Image Acquisition#

画像取得をオンにするには、AcquisitionStartコマンドを実行します。

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

Stopping Image Acquisition#

To switch off image acquisition, execute the AcquisitionStop command. When the command is executed, the following occurs:

On area scan cameras:

• カメラが現在フレームを取得していない場合、画像取得は直ちにオフになります。
• カメラが現在画像データを読み取っている場合、読み取りプロセスは終了できます。その後、画像取得がオフになります。
• カメラが現在フレームを露光している場合：
  • 一部のカメラモデルでは、AcquisitionStopコマンドを実行すると、露光が中止されます。この場合、カメラはすぐに露光を停止し、画像データの読み取りを開始します。読み取りプロセスは終了できます。その後、画像取得がオフになります。
  • On some camera models, you can configure whether executing an AcquisitionStop command aborts exposure or not. To do so, set the AcquisitionStopMode parameter to AbortExposure or Complete.

On line scan cameras:

• The AcquisitionStopMode parameter for line scan cameras is always set to Immediate.
• カメラが現在フレームを取得していない場合、画像取得は直ちにオフになります。
• If the camera is currently exposing a line, the AcquisitionStop command leads to the following for all racer 2 line scan cameras:
  The exposure of the current line is completed. Acquisition stops immediately. The last acquired line is transmitted to the host computer.
• In addtion, for racer 2 S cameras with GigE interface, the following is true:
  Only the lines acquired up to the point when the command was executed are delivered to the host computer. This may result in a partial frame being transmitted.

Aborting Image Acquisition#

画像取得を中止するには、AcquisitionAbortコマンドを実行します（使用可能な場合）。

On area scan cameras, the following occurs when the command is executed:

• If the camera is not currently acquiring a frame, image acquisition is switched off immediately.
• If the camera is currently exposing a frame, the camera stops exposing immediately. The readout process, if already started, is aborted. The current frame will be incomplete and is not transmitted to the host computer. Afterwards, image acquisition is switched off.
• If the camera is currently reading out image data, the camera stops the readout process immediately. The current frame will be incomplete and is not transmitted to the host computer. Afterwards, image acquisition is switched off.

On line scan cameras, the following occurs when the command is executed:

• If the camera is not currently acquiring a line, image acquisition is switched off immediately.
• If the camera is currently exposing a line, the camera stops exposing immediately. The readout process, if already started, is continued. Only the lines acquired up to the point when the command was executed are delivered to the host computer. For line scan cameras with GigE interface, this may result in a partial frame being transmitted. Afterwards, image acquisition is switched off.
• If the camera is currently reading out image data, the camera continues the readout process until all lines acquired up to the point when the command was executed are delivered to the host computer. For line scan cameras with GigE interface, this means that the current frame may be incomplete (partial frame).
  Afterwards, image acquisition is switched off.

特性#

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

サンプルコード#

// 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を使用して、パラメーターを簡単に設定することもできます。