Acquisition Start, Stop, and Abort

The Acquisition Start, Stop, and Abort commands allow you to control image acquisition.

In this topic Hide

Using the Feature

Starting Image Acquisition

To switch on image acquisition, execute the AcquisitionStart command.

After the command has been executed, the camera waits for trigger signals. Trigger signals can either be generated internally by the camera (free run) or applied externally (triggered image acquisition).

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.

Stopping Image Acquisition

To switch off image acquisition, execute the AcquisitionStop command.

After the command has been executed, the following occurs:

Aborting Image Acquisition

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

After the command has been executed, the following occurs:

Specifics

Camera Model AcquisitionAbort Command Available AcquisitionStop Command Aborts Exposure
All ace 2 GigE camera models Yes Yes
All ace 2 USB 3.0 camera models Yes No
All ace USB 3.0 camera models No Yes
All ace GigE camera models No Yes
All boost CXP-12 camera models Yes No
All dart BCON for LVDS camera models No Yes
All dart BCON for MIPI cameras models No Yes
All dart USB 3.0 camera models No Yes
All pulse USB 3.0 camera models No Yes

Sample Code

// 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
CEnumerationPtr(nodemap.GetNode("AcquisitionMode"))->FromString("Continuous");
// Switch on image acquisition
CCommandPtr(nodemap.GetNode("AcquisitionStart"))->Execute();
// The camera waits for trigger signals
// (...)
// Switch off image acquisition
CCommandPtr(nodemap.GetNode("AcquisitionStop"))->Execute();
// Switch image acquisition back on
CCommandPtr(nodemap.GetNode("AcquisitionStart"))->Execute();
// The camera waits for trigger signals
// (...)
// Abort image acquisition
CCommandPtr(nodemap.GetNode("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();
// Configure continuous image acquisition on the cameras
Pylon.DeviceFeatureFromString(hdev, "AcquisitionMode", "Continuous");
// Switch on image acquisition
Pylon.DeviceExecuteCommandFeature(hdev, "AcquisitionStart");
// The camera waits for trigger signals
// (...)
// Switch off image acquisition
Pylon.DeviceExecuteCommandFeature(hdev, "AcquisitionStop");
// Switch image acquisition back on
Pylon.DeviceExecuteCommandFeature(hdev, "AcquisitionStart");
// The camera waits for trigger signals
// (...)
// Abort image acquisition
Pylon.DeviceExecuteCommandFeature(hdev, "AcquisitionAbort");
/* 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);