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.

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.
   • LineTriggerWait: Determines whether the camera is waiting for a Line 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

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
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
}

/* 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 */
}

# Specify that you want to determine if the camera is waiting for Frame Start trigger signals
camera.AcquisitionStatusSelector.Value = "FrameTriggerWait"
# Get the acquisition status
isWaitingForFrameStart = camera.AcquisitionStatus.Value
if isWaitingForFrameStart:
    # It is now safe to apply Frame Start trigger signals

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