Acquisition Status

The Acquisition Status camera feature allows you to determine whether the camera is currently performing a specific image acquisition task.

For example, you can determine whether the camera is waiting for trigger signals. This is useful if you want to optimize triggered image acquisition and avoid overtriggering.

Basler strongly recommends using the Acquisition Status feature only when the camera is configured for software triggering. When the camera is configured for hardware triggering, Basler recommends monitoring the camera's Trigger Wait signals instead.

Using the Feature

To determine whether the camera is performing a specific image acquisition task:

  1. Set the AcquisitionStatusSelector parameter to one of the following values (if available):
  2. Get the value of the AcquisitionStatus parameter.

If the AcquisitionStatus parameter is true, the camera is performing the selected acquisition task.

If the AcquisitionStatus parameter is false, the camera is not performing the selected acquisition task.

Specifics

Camera Model Available Acquisition States
All ace 2 GigE camera models
  • Acquisition Active
  • Exposure Active
  • Exposure Trigger Wait
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
All ace 2 USB 3.0 camera models
  • Acquisition Active
  • Exposure Active
  • Exposure Trigger Wait
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA640-90gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA640-90gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA640-120gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA640-120gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA640-121gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA640-300gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA640-300gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA720-290gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA720-290gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA780-75gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA780-75gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA800-200gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA800-200gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1280-60gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1280-60gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1300-22gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1300-22gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1300-30gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1300-30gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1300-60gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1300-60gmNIR
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1300-60gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1300-75gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1300-75gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1440-73gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1440-73gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1600-20gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1600-20gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1600-60gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1600-60gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1920-25gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1920-25gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1920-40gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1920-40gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1920-48gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1920-48gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1920-50gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1920-50gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2000-50gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2000-50gmNIR
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2000-50gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2040-25gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2040-25gmNIR
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2040-25gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2040-35gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2040-35gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2440-20gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2440-20gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2500-14gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2500-14gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2500-20gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2500-20gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2500-20gmMED
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2500-20gcMED
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA3088-16gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA3088-16gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA3800-10gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA3800-10gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4024-8gm
  • Acquisition Idle
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4024-8gc
  • Acquisition Idle
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4096-11gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4096-11gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4112-8gm
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4112-8gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4600-7gc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA5472-5gm
  • Acquisition Idle
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA5472-5gc
  • Acquisition Idle
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA640-750um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA640-750uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA640-90um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA640-90uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA640-120um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA640-120uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA720-520um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA720-520uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA800-510um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA800-510uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1300-200um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1300-200uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1300-30um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1300-30uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1440-220um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1440-220uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1600-20um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1600-20uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1920-25um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1920-25uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1920-40um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1920-40uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1920-40umMED
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1920-40ucMED
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1920-150um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1920-150uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1920-155um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1920-155uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1920-155umMED
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA1920-155ucMED
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2040-90um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2040-90umNIR
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2040-90uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2000-165um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2000-165umNIR
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2000-165uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2040-55um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2040-55uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2040-120um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2040-120uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2440-35um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2440-35uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2440-35umMED
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2440-35ucMED
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2440-75um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2440-75uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2440-75umMED
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2440-75ucMED
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2500-14um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2500-14uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2500-60um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA2500-60uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA3088-57um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA3088-57uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA3800-14um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA3800-14uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4024-29um
  • Acquisition Idle
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4024-29uc
  • Acquisition Idle
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4096-30um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4096-30uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4096-30umMED
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4096-30ucMED
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4096-40um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4096-40uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4096-40umMED
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4096-40ucMED
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4112-20um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4112-20uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4112-20umMED
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4112-20ucMED
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4112-30um
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4112-30uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4112-30umMED
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4112-30ucMED
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA4600-10uc
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA5472-17um
  • Acquisition Idle
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
acA5472-17uc
  • Acquisition Idle
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
All boost CXP-12 camera models
  • Acquisition Active
  • Exposure Active
  • Exposure Trigger Wait
  • Frame Burst Trigger Wait
  • Frame Trigger Wait
All dart BCON for LVDS camera models Acquisition Status feature not supported
All dart BCON for MIPI cameras models Acquisition Status feature not supported
All dart USB 3.0 camera models Acquisition Status feature not supported
All pulse USB 3.0 camera models Acquisition Status feature not supported

Sample Code

// Specify that you want to determine if the camera is waiting for Frame Start trigger signals
camera.AcquisitionStatusSelector.SetValue(AcquisitionStatusSelector_FrameTriggerWait);
// Get the acquisition status 
bool isWaitingForFrameStart = camera.AcquisitionStatus.GetValue();
if (isWaitingForFrameStart) { 
// It is now safe to apply Frame Start trigger signals
}
INodeMap& nodemap = camera.GetNodeMap();
// Specify that you want to determine if the camera is waiting for Frame Start trigger signals
CEnumerationPtr(nodemap.GetNode("AcquisitionStatusSelector"))->FromString("FrameTriggerWait");
// Get the acquisition status
bool isWaitingForFrameStart = CBooleanPtr(nodemap.GetNode("AcquisitionStatus"))->GetValue();
if(isWaitingForFrameStart){    
    // It is now safe to apply Frame Start trigger signals
}
// Specify that you want to determine if the camera is waiting for Frame Start trigger signals
camera.Parameters[PLCamera.AcquisitionStatusSelector].SetValue(PLCamera.AcquisitionStatusSelector.FrameTriggerWait);
// Get the acquisition status
bool isWaitingForFrameStart = camera.Parameters[PLCamera.AcquisitionStatus].GetValue();
if(isWaitingForFrameStart){    
    // It is now safe to apply Frame Start trigger signals
}
// Specify that you want to determine if the camera is waiting for Frame Start trigger signals
Pylon.DeviceFeatureFromString(hdev, "AcquisitionStatusSelector", "FrameTriggerWait");
// Get the acquisition status
bool isWaitingForFrameStart = Pylon.DeviceGetBooleanFeature(hdev, "AcquisitionStatus");
if(isWaitingForFrameStart){    
    // It is now safe to apply Frame Start trigger signals
}
/* 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 */
_Bool isWaitingForFrameStart = false;
/* Specify that you want to determine if the camera is waiting for Frame Start trigger signals */
errRes = PylonDeviceFeatureFromString(hdev, "AcquisitionStatusSelector", "FrameTriggerWait");
CHECK(errRes);
/* Get the acquisition status */
errRes = PylonDeviceGetBooleanFeature(hdev, "AcquisitionStatus", &isWaitingForFrameStart);
CHECK(errRes);
if(isWaitingForFrameStart){    
    /* It is now safe to apply Frame Start trigger signals */
}

You can also use the pylon Viewer to easily set the parameters.