Acquisition Start, Stop, and Abort#

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

该功能的使用#

开始图像采集#

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

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

停止图像采集#

要关闭图像采集，请执行 AcquisitionStop 命令。执行该命令时，将发生以下情况：

在面阵扫描相机上：

• 如果相机当前未在采集帧，则图像采集功能会立即关闭。
• 如果相机当前正在读出图像数据，则系统会允许读出过程完成。之后，图像采集功能会关闭。
• 如果相机当前正在帧曝光过程中：
  • 在某些相机型号上，执行 AcquisitionStop 命令 会中止 曝光。在这种情况下，相机将立即停止曝光并开始读出图像数据。读出过程将允许完成。之后，图像采集将被关闭。
  • 在某些相机型号上，您可以 配置 执行 AcquisitionStop 命令是否会中止曝光。为此，请设置 AcquisitionStopMode 参数至 AbortExposure 或 Complete.

在线阵扫描相机上：

• 即： AcquisitionStopMode 线阵扫描相机的参数始终设置为 Immediate.
• 如果相机当前未在采集帧，则图像采集功能会立即关闭。
• 如果相机当前正在对某一行进行曝光，则 AcquisitionStop 命令对于 所有 racer 2 线阵扫描相机将导致以下结果：
  当前行的曝光已完成。采集立即停止。最后采集的行将传输到主计算机。
• 此外，对于配备 GigE 接口的 racer 2 S 相机，以下情况适用：
  只有在执行命令时之前采集的行才会传送到主计算机。这可能会导致传输部分帧。

中止图像采集#

要中止图像采集，请执行以下命令： AcquisitionAbort 命令 （如果可用）。

对于面阵相机，执行此命令时会发生以下情况：

• 如果相机当前未在采集图像帧，则图像采集将立即关闭。
• 如果相机当前正在曝光图像帧，相机将立即停止曝光。如果读出过程已经开始，则会被中止。当前的图像帧将是不完整的，并且不会传输到主计算机。随后，图像采集将关闭。
• 如果相机当前正在读出图像数据，相机将立即停止读出过程。当前的图像帧将是不完整的，并且不会传输到主计算机。随后，图像采集将关闭。

对于线阵相机，执行此命令时会发生以下情况：

• 如果相机当前未在采集行，则图像采集将立即关闭。
• 如果相机当前正在曝光行，相机将立即停止曝光。如果读出过程已经开始，则会继续进行。只有在执行命令时之前采集到的行才会传输到主计算机。对于带有 GigE 接口的线阵相机，这可能会导致传输部分图像帧。随后，图像采集将关闭。
• 如果相机当前正在读出图像数据，相机将继续读出过程，直到在执行命令时之前采集到的所有行都传输到主计算机。对于带有 GigE 接口的线阵相机，这意味着当前图像帧可能是不完整的（部分图像帧）。
  随后，图像采集将关闭。

详情#

显示所有相机型号

示例代码#

// 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 轻松设置参数。