跳转到内容

Acquisition Start, Stop, and Abort#

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

信息

  • These commands aren't available via the pylon Viewer feature tree. Instead, AcquisitionStart and AcquisitionStop commands are generated automatically when you use the Single Shot, Continuous Shot, and Stop buttons in the toolbar of the pylon Viewer.
  • pylon C++ API 和 pylon .NET API 提供了自动处理这些命令的相机类。Basler 建议使用这些类。
    如需了解详情,请参阅 pylon API 文档中的采集 (C++)采集 (.NET) 代码示例。

该功能的使用#

开始图像采集#

To switch on image acquisition, execute the AcquisitionStart command.

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

信息

To check whether the camera is currently waiting for a trigger signal, monitor the camera's Trigger Wait signals or use the Acquisition Status feature, if available.

停止图像采集#

To switch off image acquisition, execute the AcquisitionStop command.

执行此命令后,将发生以下情况:

  • 如果相机当前未在采集帧,则图像采集功能会立即关闭。
  • 如果相机当前正在读出图像数据,则系统会允许读出过程完成。之后,图像采集功能会关闭。
  • 如果相机当前正在帧曝光过程中:
    • On some camera models, executing an AcquisitionStop command aborts exposure. In this case, the camera stops exposing immediately and starts reading out image data. The readout process will be allowed to finish. Afterwards, image acquisition is switched off.
    • On some camera models, you can configure whether executing an AcquisitionStop command aborts exposure or not. To do so, set the BslAcquisitionStopMode parameter to AbortExposure or CompleteExposure.

中止图像采集#

To abort image acquisition, execute the AcquisitionAbort command (if available).

执行此命令后,将发生以下情况:

  • 如果相机当前未在采集帧,则图像采集功能会立即关闭。
  • 如果相机当前正在帧曝光过程中,相机将立即停止曝光。如果读出图像数据过程已启动,则会中止。当前帧将不完整。之后,图像采集功能将关闭。
  • 如果相机当前正在读出图像数据,则相机会立即停止读出过程。当前帧将不完整。之后,图像采集功能会关闭。

详情#

显示所有相机型号

相机型号 AcquisitionAbort 命令可用 AcquisitionStop 命令中止曝光
a2A640-240gmSWIR 可通过 BslAcquisitionStopMode 参数进行配置
a2A640-240umSWIR 可通过 BslAcquisitionStopMode 参数进行配置
a2A1280-80gmSWIR 可通过 BslAcquisitionStopMode 参数进行配置
a2A1280-125umSWIR 可通过 BslAcquisitionStopMode 参数进行配置
a2A1920-51gcBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A1920-51gcPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A1920-51gmBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A1920-51gmPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A1920-160ucBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A1920-160ucPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A1920-160umBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A1920-160umPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A1920-165g5cBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A1920-165g5mBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A2440-98g5cBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A2440-98g5mBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A2448-23gcBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A2448-23gcPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A2448-23gmBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A2448-23gmPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A2448-75ucBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A2448-75ucPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A2448-75umBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A2448-75umPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A2448-105g5cBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A2448-105g5mBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A2590-22gcBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A2590-22gcPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A2590-22gmBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A2590-22gmPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A2590-60ucBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A2590-60ucPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A2590-60umBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A2590-60umPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A2600-20gcBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A2600-20gcPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A2600-20gmBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A2600-20gmPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A2600-64ucBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A2600-64ucPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A2600-64umBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A2600-64umPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A2840-14gcBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A2840-14gcPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A2840-14gmBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A2840-14gmPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A2840-48ucBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A2840-48ucPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A2840-48umBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A2840-48umPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A2840-67g5cBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A2840-67g5mBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A3840-13gcBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A3840-13gcPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A3840-13gmBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A3840-13gmPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A3840-45ucBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A3840-45ucPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A3840-45umBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A3840-45umPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A4096-9gcBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A4096-9gcPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A4096-9gmBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A4096-9gmPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A4096-30ucBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A4096-30ucPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A4096-30umBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A4096-30umPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A4096-44g5cBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A4096-44g5mBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A4200-12gcBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A4200-12gcPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A4200-12gmBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A4200-12gmPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A4200-40ucBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A4200-40ucPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A4200-40umBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A4200-40umPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A4504-5gcBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A4504-5gcPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A4504-5gmBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A4504-5gmPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A4504-18ucBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A4504-18ucPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A4504-18umBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A4504-18umPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A4504-27g5cBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A4504-27g5mBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A4508-6gcBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A4508-6gcPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A4508-6gmBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A4508-6gmPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A4508-20ucBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A4508-20ucPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A4508-20umBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A4508-20umPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A5320-7gcBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A5320-7gcPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A5320-7gmBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A5320-7gmPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A5320-23ucBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A5320-23ucPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A5320-23umBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A5320-23umPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A5320-34g5cBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A5320-34g5mBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A5328-4gcBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A5328-4gcPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A5328-4gmBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A5328-4gmPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A5328-15ucBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A5328-15ucPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A5328-15umBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A5328-15umPRO 可通过 BslAcquisitionStopMode 参数进行配置
a2A5328-22g5cBAS 可通过 BslAcquisitionStopMode 参数进行配置
a2A5328-22g5mBAS 可通过 BslAcquisitionStopMode 参数进行配置
acA640-121gm
acA640-300gc
acA640-300gm
acA640-750uc
acA640-750um
acA720-290gc
acA720-290gm
acA720-520uc
acA720-520um
acA800-200gc
acA800-200gm
acA800-510uc
acA800-510um
acA1280-60gc
acA1280-60gm
acA1300-60gc
acA1300-60gm
acA1300-60gmNIR
acA1300-75gc
acA1300-75gm
acA1300-200uc
acA1300-200um
acA1440-73gc
acA1440-73gm
acA1440-220uc
acA1440-220um
acA1600-20gc
acA1600-20uc
acA1600-60gc
acA1600-60gm
acA1920-25gc
acA1920-25gm
acA1920-25uc
acA1920-25um
acA1920-40gc
acA1920-40gm
acA1920-40uc
acA1920-40ucMED
acA1920-40um
acA1920-40umMED
acA1920-48gc
acA1920-48gm
acA1920-50gc
acA1920-50gm
acA1920-150uc
acA1920-150um
acA1920-155uc
acA1920-155ucMED
acA1920-155um
acA1920-155umMED
acA2000-50gc
acA2000-50gm
acA2000-165uc
acA2000-165um
acA2040-25gc
acA2040-25gm
acA2040-25gmNIR
acA2040-35gc
acA2040-35gm
acA2040-55uc
acA2040-55um
acA2040-90uc
acA2040-90um
acA2040-90umNIR
acA2040-120uc
acA2040-120um
acA2440-20gc
acA2440-20gm
acA2440-35uc
acA2440-35ucMED
acA2440-35um
acA2440-35umMED
acA2440-75uc
acA2440-75ucMED
acA2440-75um
acA2440-75umMED
acA2500-14gc
acA2500-14gm
acA2500-14uc
acA2500-14um
acA2500-20gc
acA2500-20gcMED
acA2500-20gm
acA2500-20gmMED
acA2500-60uc
acA2500-60um
acA3088-16gc
acA3088-16gm
acA3088-57uc
acA3088-57ucMED
acA3088-57um
acA3088-57umMED
acA3800-10gc
acA3800-10gm
acA3800-14uc
acA3800-14um
acA4024-8gc
acA4024-8gm
acA4024-29uc
acA4024-29um
acA4096-11gc
acA4096-11gm
acA4096-30uc
acA4096-30ucMED
acA4096-30um
acA4096-30umMED
acA4096-40uc
acA4096-40ucMED
acA4096-40um
acA4096-40umMED
acA4112-8gc
acA4112-8gm
acA4112-20uc
acA4112-20ucMED
acA4112-20um
acA4112-20umMED
acA4112-30uc
acA4112-30ucMED
acA4112-30um
acA4112-30umMED
acA5472-5gc
acA5472-5gm
acA5472-17uc
acA5472-17ucMED
acA5472-17um
acA5472-17umMED
boA1936-400cc 可通过 BslAcquisitionStopMode 参数进行配置
boA1936-400cm 可通过 BslAcquisitionStopMode 参数进行配置
boA2448-250cc 可通过 BslAcquisitionStopMode 参数进行配置
bo2448-250cm 可通过 BslAcquisitionStopMode 参数进行配置
boA2832-190cc 可通过 BslAcquisitionStopMode 参数进行配置
bo2832-190cm 可通过 BslAcquisitionStopMode 参数进行配置
boA4096-93cc 可通过 BslAcquisitionStopMode 参数进行配置
boA4096-93cm 可通过 BslAcquisitionStopMode 参数进行配置
boA4096-180cc 可通过 BslAcquisitionStopMode 参数进行配置
bo4096-180cm 可通过 BslAcquisitionStopMode 参数进行配置
boA4112-68cc 可通过 BslAcquisitionStopMode 参数进行配置
boA4112-68cm 可通过 BslAcquisitionStopMode 参数进行配置
boA4500-45cc 可通过 BslAcquisitionStopMode 参数进行配置
boA4500-45cm 可通过 BslAcquisitionStopMode 参数进行配置
boA4504-100cc 可通过 BslAcquisitionStopMode 参数进行配置
boA4504-100cm 可通过 BslAcquisitionStopMode 参数进行配置
boA5120-150cc
boA5120-150cm
boA5120-230cc
boA5120-230cm
boA5320-150cc 可通过 BslAcquisitionStopMode 参数进行配置
boA5320-150cm 可通过 BslAcquisitionStopMode 参数进行配置
boA5328-100cc 可通过 BslAcquisitionStopMode 参数进行配置
boA5328-100cm 可通过 BslAcquisitionStopMode 参数进行配置
boA6500-36cc 可通过 BslAcquisitionStopMode 参数进行配置
boA6500-36cm 可通过 BslAcquisitionStopMode 参数进行配置
boA8100-16cc 可通过 BslAcquisitionStopMode 参数进行配置
boA8100-16cm 可通过 BslAcquisitionStopMode 参数进行配置
boA9344-30cc
boA9344-30cm
boA9344-70cc
boA9344-70cm
boA13440-17cm 可通过 BslAcquisitionStopMode 参数进行配置
daA720-520uc 可通过 BslAcquisitionStopMode 参数进行配置
daA720-520um 可通过 BslAcquisitionStopMode 参数进行配置
daA1280-54uc
daA1280-54um
daA1440-220uc 可通过 BslAcquisitionStopMode 参数进行配置
daA1440-220um 可通过 BslAcquisitionStopMode 参数进行配置
daA1600-60uc
daA1600-60um
daA1920-15um
daA1920-30uc
daA1920-30um
daA1920-160uc 可通过 BslAcquisitionStopMode 参数进行配置
daA1920-160um 可通过 BslAcquisitionStopMode 参数进行配置
daA2448-70uc 可通过 BslAcquisitionStopMode 参数进行配置
daA2448-70um 可通过 BslAcquisitionStopMode 参数进行配置
daA2500-14uc
daA2500-14um
daA3840-45uc 可通过 BslAcquisitionStopMode 参数进行配置
daA3840-45um 可通过 BslAcquisitionStopMode 参数进行配置
puA1280-54uc
puA1280-54um
puA1600-60uc
puA1600-60um
puA1920-30uc
puA1920-30um
puA2500-14uc
puA2500-14um

示例代码#

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