Acquisition Status#

Acquisition Status カメラ機能を使用すると、カメラが現在特定の画像取得タスクを実行しているかどうかを判別できます。

例えば、カメラがトリガー信号を待機しているかどうかを判別できます。これは、トリガー画像取得を最適化し、オーバートリガーを回避する場合に便利です。

機能を使用する#

カメラが特定の画像取得タスクを実行しているかどうかを判別するには、次の手順に従います。

1. パラメーターを AcquisitionStatusSelector 次のいずれかの値（使用している場合）に設定します：
   • AcquisitionActive：取得が開始されたかどうか、つまりカメラがAcquisition Startコマンドを受信したかどうかを判別します。
   • AcquisitionIdle：取得がアイドル状態かどうか、つまり、カメラが現在画像データを露光または読み取りしていないため、Acquisition Startコマンドの受信準備中かどうかを判別します。
   • ExposureActive：カメラが現在露光中かどうかを判別します。
   • ExposureTriggerWait：カメラがExposure Startトリガー信号を待機中かどうかを判別します。
   • FrameBurstActive：カメラが現在一連の画像（画像の「バースト」）を取得しているかどうかを判別します。
   • FrameBurstTriggerWait：カメラがFrame Burst Startトリガー信号を待機中かどうかを判別します。
   • FrameTriggerWait：カメラがFrame Startトリガー信号を待機中かどうかを判別します。
   • LineTriggerWait: Determines whether the camera is waiting for a Line Start trigger signal.
2. AcquisitionStatusパラメーターの値を取得します。

AcquisitionStatusパラメーターがtrueの場合、カメラは、選択された取得タスクを実行しています。

AcquisitionStatusパラメーターがfalseの場合、カメラは選択された取得タスクを実行していません。

特性#

すべてのカメラモデルを表示します

サンプルコード#

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