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を使用して、パラメーターを簡単に設定することもできます。