Acquisition Status#

相机的 Acquisition Status 功能可让您确定相机当前是否正在执行特定的图像采集任务。

例如，您可以确定相机是否正在等待触发信号。如果要优化触发图像采集并避免过度触发，这项功能非常有用。

该功能的使用#

要确定相机是否正在执行特定的图像采集任务：

1. 设置 AcquisitionStatusSelector 参数为以下值（如果可用）：
   • 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.

详情#

显示所有相机型号

示例代码#

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

您也可以使用 pylon Viewer 轻松设置参数。