Acquisition Start, Stop, and Abort#

Acquisition Start, Stop, and Abort 命令让您可以控制图像采集。

该功能的使用#

开始图像采集#

要打开图像采集，请执行 AcquisitionStart 命令。

执行此命令后，相机会等待触发信号。触发信号既可以在相机内部生成（自由运行），也可以从外部应用（触发图像采集）。

停止图像采集#

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.

中止图像采集#

要中止图像采集，请执行 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 轻松设置参数。