Skip to content

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.

Info

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):
    • AcquisitionActive: Determines whether acquisition has started, i.e., whether the camera has received an Acquisition Start command.
    • AcquisitionIdle: Determines whether acquisition is idle, i.e., whether the camera is not currently exposing or reading out image data, and is therefore ready to receive an Acquisition Start command.
    • ExposureActive: Determines whether the camera is currently exposing.
    • ExposureTriggerWait: Determines whether the camera is waiting for an Exposure Start trigger signal.
    • FrameBurstActive: Determines whether the camera is currently acquiring a series of images (a "burst" of images).
    • FrameBurstTriggerWait: Determines whether the camera is waiting for a Frame Burst Start trigger signal.
    • FrameTriggerWait: Determines whether the camera is waiting for a Frame Start trigger signal.
  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#

Show all camera models

Camera Model Available Acquisition States
a2A1920-51gcBAS Acquisition Active
Exposure Active
Exposure Trigger Wait
Frame Burst Active
Frame Burst Trigger Wait
Frame Trigger Wait
a2A1920-51gcPRO Acquisition Active
Exposure Active
Exposure Trigger Wait
Frame Burst Active
Frame Burst Trigger Wait
Frame Trigger Wait
a2A1920-51gmBAS Acquisition Active
Exposure Active
Exposure Trigger Wait
Frame Burst Active
Frame Burst Trigger Wait
Frame Trigger Wait
a2A1920-51gmPRO Acquisition Active
Exposure Active
Exposure Trigger Wait
Frame Burst Active
Frame Burst Trigger Wait
Frame Trigger Wait
a2A1920-160ucBAS Acquisition Active
Exposure Active
Exposure Trigger Wait
Frame Burst Active
Frame Burst Trigger Wait
Frame Trigger Wait
a2A1920-160ucPRO Acquisition Active
Exposure Active
Exposure Trigger Wait
Frame Burst Active
Frame Burst Trigger Wait
Frame Trigger Wait
a2A1920-160umBAS Acquisition Active
Exposure Active
Exposure Trigger Wait
Frame Burst Active
Frame Burst Trigger Wait
Frame Trigger Wait
a2A1920-160umPRO Acquisition Active
Exposure Active
Exposure Trigger Wait
Frame Burst Active
Frame Burst Trigger Wait
Frame Trigger Wait
a2A3840-13gcBAS Acquisition Active
Exposure Active
Exposure Trigger Wait
Frame Burst Active
Frame Burst Trigger Wait
Frame Trigger Wait
a2A3840-13gmBAS Acquisition Active
Exposure Active
Exposure Trigger Wait
Frame Burst Active
Frame Burst Trigger Wait
Frame Trigger Wait
a2A3840-45ucBAS Acquisition Active
Exposure Active
Exposure Trigger Wait
Frame Burst Active
Frame Burst Trigger Wait
Frame Trigger Wait
a2A3840-45umBAS Acquisition Active
Exposure Active
Exposure Trigger Wait
Frame Burst Active
Frame Burst Trigger Wait
Frame Trigger Wait
acA640-90gc Frame Burst Trigger Wait
Frame Trigger Wait
acA640-90gc Frame Burst Trigger Wait
Frame Trigger Wait
acA640-90gm Frame Burst Trigger Wait
Frame Trigger Wait
acA640-90uc Frame Burst Trigger Wait
Frame Trigger Wait
acA640-90um Frame Burst Trigger Wait
Frame Trigger Wait
acA640-120gc Frame Burst Trigger Wait
Frame Trigger Wait
acA640-120gm Frame Burst Trigger Wait
Frame Trigger Wait
acA640-120uc Frame Burst Trigger Wait
Frame Trigger Wait
acA640-120um Frame Burst Trigger Wait
Frame Trigger Wait
acA640-121gm Frame Burst Trigger Wait
Frame Trigger Wait
acA640-300gc Frame Burst Trigger Wait
Frame Trigger Wait
acA640-300gm Frame Burst Trigger Wait
Frame Trigger Wait
acA640-750uc Frame Burst Trigger Wait
Frame Trigger Wait
acA640-750um Frame Burst Trigger Wait
Frame Trigger Wait
acA720-290gc Frame Burst Trigger Wait
Frame Trigger Wait
acA720-290gm Frame Burst Trigger Wait
Frame Trigger Wait
acA720-520uc Frame Burst Trigger Wait
Frame Trigger Wait
acA720-520um Frame Burst Trigger Wait
Frame Trigger Wait
acA780-75gc Frame Burst Trigger Wait
Frame Trigger Wait
acA780-75gm Frame Burst Trigger Wait
Frame Trigger Wait
acA800-200gc Frame Burst Trigger Wait
Frame Trigger Wait
acA800-200gm Frame Burst Trigger Wait
Frame Trigger Wait
acA800-510uc Frame Burst Trigger Wait
Frame Trigger Wait
acA800-510um Frame Burst Trigger Wait
Frame Trigger Wait
acA1280-60gc Frame Burst Trigger Wait
Frame Trigger Wait
acA1280-60gm Frame Burst Trigger Wait
Frame Trigger Wait
acA1300-22gc Frame Burst Trigger Wait
Frame Trigger Wait
acA1300-22gm Frame Burst Trigger Wait
Frame Trigger Wait
acA1300-30gc Frame Burst Trigger Wait
Frame Trigger Wait
acA1300-30gm Frame Burst Trigger Wait
Frame Trigger Wait
acA1300-30uc Frame Burst Trigger Wait
Frame Trigger Wait
acA1300-30um Frame Burst Trigger Wait
Frame Trigger Wait
acA1300-60gc 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-75gc Frame Burst Trigger Wait
Frame Trigger Wait
acA1300-75gm Frame Burst Trigger Wait
Frame Trigger Wait
acA1300-200uc Frame Burst Trigger Wait
Frame Trigger Wait
acA1300-200um Frame Burst Trigger Wait
Frame Trigger Wait
acA1440-73gc Frame Burst Trigger Wait
Frame Trigger Wait
acA1440-73gm Frame Burst Trigger Wait
Frame Trigger Wait
acA1440-220uc Frame Burst Trigger Wait
Frame Trigger Wait
acA1440-220um Frame Burst Trigger Wait
Frame Trigger Wait
acA1600-20gc Frame Burst Trigger Wait
Frame Trigger Wait
acA1600-20gm Frame Burst Trigger Wait
Frame Trigger Wait
acA1600-20uc Frame Burst Trigger Wait
Frame Trigger Wait
acA1600-20um Frame Burst Trigger Wait
Frame Trigger Wait
acA1600-60gc Frame Burst Trigger Wait
Frame Trigger Wait
acA1600-60gm Frame Burst Trigger Wait
Frame Trigger Wait
acA1920-25gc Frame Burst Trigger Wait
Frame Trigger Wait
acA1920-25gm Frame Burst Trigger Wait
Frame Trigger Wait
acA1920-25uc Frame Burst Trigger Wait
Frame Trigger Wait
acA1920-25um Frame Burst Trigger Wait
Frame Trigger Wait
acA1920-40gc Frame Burst Trigger Wait
Frame Trigger Wait
acA1920-40gm Frame Burst Trigger Wait
Frame Trigger Wait
acA1920-40uc Frame Burst Trigger Wait
Frame Trigger Wait
acA1920-40ucMED Frame Burst Trigger Wait
Frame Trigger Wait
acA1920-40um Frame Burst Trigger Wait
Frame Trigger Wait
acA1920-40umMED Frame Burst Trigger Wait
Frame Trigger Wait
acA1920-48gc Frame Burst Trigger Wait
Frame Trigger Wait
acA1920-48gm Frame Burst Trigger Wait
Frame Trigger Wait
acA1920-50gc Frame Burst Trigger Wait
Frame Trigger Wait
acA1920-50gm Frame Burst Trigger Wait
Frame Trigger Wait
acA1920-150uc Frame Burst Trigger Wait
Frame Trigger Wait
acA1920-150um Frame Burst Trigger Wait
Frame Trigger Wait
acA1920-155uc Frame Burst Trigger Wait
Frame Trigger Wait
acA1920-155ucMED Frame Burst Trigger Wait
Frame Trigger Wait
acA1920-155um Frame Burst Trigger Wait
Frame Trigger Wait
acA1920-155umMED Frame Burst Trigger Wait
Frame Trigger Wait
acA2000-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-165uc 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
acA2040-25gc 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-35gc Frame Burst Trigger Wait
Frame Trigger Wait
acA2040-35gm Frame Burst Trigger Wait
Frame Trigger Wait
acA2040-55uc Frame Burst Trigger Wait
Frame Trigger Wait
acA2040-55um Frame Burst Trigger Wait
Frame Trigger Wait
acA2040-90uc 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-120uc Frame Burst Trigger Wait
Frame Trigger Wait
acA2040-120um Frame Burst Trigger Wait
Frame Trigger Wait
acA2440-20gc Frame Burst Trigger Wait
Frame Trigger Wait
acA2440-20gm Frame Burst Trigger Wait
Frame Trigger Wait
acA2440-35uc Frame Burst Trigger Wait
Frame Trigger Wait
acA2440-35ucMED Frame Burst Trigger Wait
Frame Trigger Wait
acA2440-35um Frame Burst Trigger Wait
Frame Trigger Wait
acA2440-35umMED Frame Burst Trigger Wait
Frame Trigger Wait
acA2440-75uc Frame Burst Trigger Wait
Frame Trigger Wait
acA2440-75ucMED Frame Burst Trigger Wait
Frame Trigger Wait
acA2440-75um Frame Burst Trigger Wait
Frame Trigger Wait
acA2440-75umMED Frame Burst Trigger Wait
Frame Trigger Wait
acA2500-14gc Frame Burst Trigger Wait
Frame Trigger Wait
acA2500-14gm Frame Burst Trigger Wait
Frame Trigger Wait
acA2500-14uc Frame Burst Trigger Wait
Frame Trigger Wait
acA2500-14um Frame Burst Trigger Wait
Frame Trigger Wait
acA2500-20gc Frame Burst Trigger Wait
Frame Trigger Wait
acA2500-20gcMED Frame Burst Trigger Wait
Frame Trigger Wait
acA2500-20gm Frame Burst Trigger Wait
Frame Trigger Wait
acA2500-20gmMED Frame Burst Trigger Wait
Frame Trigger Wait
acA2500-60uc Frame Burst Trigger Wait
Frame Trigger Wait
acA2500-60um Frame Burst Trigger Wait
Frame Trigger Wait
acA3088-16gc Frame Burst Trigger Wait
Frame Trigger Wait
acA3088-16gm Frame Burst Trigger Wait
Frame Trigger Wait
acA3088-57uc Frame Burst Trigger Wait
Frame Trigger Wait
acA3088-57um Frame Burst Trigger Wait
Frame Trigger Wait
acA3800-10gc Frame Burst Trigger Wait
Frame Trigger Wait
acA3800-10gm Frame Burst Trigger Wait
Frame Trigger Wait
acA3800-14uc Frame Burst Trigger Wait
Frame Trigger Wait
acA3800-14um Frame Burst Trigger Wait
Frame Trigger Wait
acA4024-8gc Acquisition Idle
Frame Burst Trigger Wait
Frame Trigger Wait
acA4024-8gm Acquisition Idle
Frame Burst Trigger Wait
Frame Trigger Wait
acA4024-29uc Acquisition Idle
Frame Burst Trigger Wait
Frame Trigger Wait
acA4024-29um Acquisition Idle
Frame Burst Trigger Wait
Frame Trigger Wait
acA4096-11gc Frame Burst Trigger Wait
Frame Trigger Wait
acA4096-11gm Frame Burst Trigger Wait
Frame Trigger Wait
acA4096-30uc Frame Burst Trigger Wait
Frame Trigger Wait
acA4096-30ucMED Frame Burst Trigger Wait
Frame Trigger Wait
acA4096-30um Frame Burst Trigger Wait
Frame Trigger Wait
acA4096-30umMED Frame Burst Trigger Wait
Frame Trigger Wait
acA4096-40uc Frame Burst Trigger Wait
Frame Trigger Wait
acA4096-40ucMED Frame Burst Trigger Wait
Frame Trigger Wait
acA4096-40um Frame Burst Trigger Wait
Frame Trigger Wait
acA4096-40umMED Frame Burst Trigger Wait
Frame Trigger Wait
acA4112-8gc Frame Burst Trigger Wait
Frame Trigger Wait
acA4112-8gm Frame Burst Trigger Wait
Frame Trigger Wait
acA4112-20uc Frame Burst Trigger Wait
Frame Trigger Wait
acA4112-20ucMED Frame Burst Trigger Wait
Frame Trigger Wait
acA4112-20um Frame Burst Trigger Wait
Frame Trigger Wait
acA4112-20umMED Frame Burst Trigger Wait
Frame Trigger Wait
acA4112-30uc Frame Burst Trigger Wait
Frame Trigger Wait
acA4112-30ucMED Frame Burst Trigger Wait
Frame Trigger Wait
acA4112-30um Frame Burst Trigger Wait
Frame Trigger Wait
acA4112-30umMED Frame Burst Trigger Wait
Frame Trigger Wait
acA4600-7gc Frame Burst Trigger Wait
Frame Trigger Wait
acA4600-10uc Frame Burst Trigger Wait
Frame Trigger Wait
acA5472-5gc Acquisition Idle
Frame Burst Trigger Wait
Frame Trigger Wait
acA5472-5gm Acquisition Idle
Frame Burst Trigger Wait
Frame Trigger Wait
acA5472-17uc Acquisition Idle
Frame Burst Trigger Wait
Frame Trigger Wait
acA5472-17um Acquisition Idle
Frame Burst Trigger Wait
Frame Trigger Wait
boA4096-93cc Acquisition Active
Exposure Active
Exposure Trigger Wait
Frame Burst Active
Frame Burst Trigger Wait
Frame Trigger Wait
boA4096-93cm Acquisition Active
Exposure Active
Exposure Trigger Wait
Frame Burst Active
Frame Burst Trigger Wait
Frame Trigger Wait
boA4112-68cc Acquisition Active
Exposure Active
Exposure Trigger Wait
Frame Burst Active
Frame Burst Trigger Wait
Frame Trigger Wait
boA4112-68cm Acquisition Active
Exposure Active
Exposure Trigger Wait
Frame Burst Active
Frame Burst Trigger Wait
Frame Trigger Wait
daA1280-54lc Acquisition Status feature not supported
daA1280-54lm Acquisition Status feature not supported
daA1280-54uc Acquisition Status feature not supported
daA1280-54um Acquisition Status feature not supported
daA1600-60lc Acquisition Status feature not supported
daA1600-60lm Acquisition Status feature not supported
daA1600-60uc Acquisition Status feature not supported
daA1600-60um Acquisition Status feature not supported
daA1920-15um Acquisition Status feature not supported
daA1920-30uc Acquisition Status feature not supported
daA1920-30um Acquisition Status feature not supported
daA2500-14lc Acquisition Status feature not supported
daA2500-14lm Acquisition Status feature not supported
daA2500-14uc Acquisition Status feature not supported
daA2500-14um Acquisition Status feature not supported
daA2500-60mc Acquisition Status feature not supported
puA1280-54uc Acquisition Status feature not supported
puA1280-54um Acquisition Status feature not supported
puA1600-60uc Acquisition Status feature not supported
puA1600-60um Acquisition Status feature not supported
puA1920-30uc Acquisition Status feature not supported
puA1920-30um Acquisition Status feature not supported
puA2500-14uc Acquisition Status feature not supported
puA2500-14um 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
}
INodeMap& nodemap = camera.GetNodeMap();
// Specify that you want to determine if the camera is waiting for Frame Start trigger signals
CEnumParameter(nodemap, "AcquisitionStatusSelector").SetValue("FrameTriggerWait");
// Get the acquisition status
bool isWaitingForFrameStart = CBooleanParameter(nodemap, "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.