跳至內容

Framegrabber SDK 5.11.4 中的變更與修正問題#

本節提供有關 Basler Framegrabber SDK 5.11.4 版本的變更與修正問題的資訊。

GenTL Producer#

  • GenTL Producer 現在透過 FgSDk 和 GenTL 中的 GenCP 或 CLP 支援 Camera Link 中的相機 XML 發現功能。在 GenTL 中，您可以透過將發現模式設定為以下選項來啟用此功能： Mixed 或 Camera.

    當 ClpSharedLibraryPath 是 GenTL 介面模組中的一項功能，用於指定 CLP 程式庫 DLL 的位置。如果 ClpSharedLibraryPath 未設定為現有的 CLP DLL，GenCP 將成為預設通訊協定。載入程式庫會在開啟 GenTL 介面後生效，而 LoadedClpSharedLibraryPath 節點會指示程式庫是否成功載入。這可讓您根據可用的通訊協定順暢地設定相機設定。（票證 ID：268175）

  • 新增了對 GenTL 中 BiColor 格式的支援。這些格式會根據裝置 XML 中的 OutputPackedFormats 功能數值，自動轉換為 BGR 封包 (packed) 或未封包 (unpacked) 格式。(Ticket ID: 315154)

日誌記錄行為的變更#

  • 為了相容於 pylon Event Logger，現在會在尋找記錄組態時評估環境變數 PYLON_LOG_CONFIG 。目前的搜尋順序為：

    1. 環境變數 BASLER_FGSDK_LOGGING_CONFIG
    2. 環境變數 PYLON_LOG_CONFIG
    3. 檔案 BaslerFgSdkLogging.properties 位於 SDK 的 bin 目錄。

      如果 pylon 已經設定了日誌記錄，則 Framegrabber SDK 不會重新設定。（票證 ID：320756）

  • Applet 事件在接收時現在會記錄到類別 FgSdk.fglib.Events.<eventname>中。此記錄包含具備微秒解析度的 Timestamp。GenTL Producer 目前預設會啟用錯誤事件 (CameraStreamStatus, Overflow, TriggerExceededPeriodLimits, FrameTriggerMissed)。(Ticket ID: 320807,323583)

  • 事件處理常式的註冊與取消註冊會記錄在記錄類別 FgSdk.fglib.EventControl中。(Ticket ID 330155)

  • 現在可以記錄執行中擷取的更多詳細資料。由於某些訊息 (例如送達的畫面) 的產生頻率與影格率相同，您現在可以使用新的記錄類別來開啟或關閉這些訊息 basler.fglib.acq 進行明確的生命週期管理即呼叫 basler.gentl.acq。這些訊息在記錄層級 NOTICE 或更高時可見。當直接使用 Framegrabber SDK 時，請使用 basler.fglib.acq；當透過 GenTL Producer 使用時，請使用 basler.GenTL.Acq。(Ticket ID: 316516)

  • 新增了在已建立的 CXP 連結上偵測到錯誤以及連結被視為中斷連線時的記錄訊息。(Ticket ID: 320739,320740)

  • 第 1個 層級的記錄類別已重新命名為 basler 設為 FgSdk，以便與 pylon SDK 的記錄功能更為一致。(Ticket ID: 323587)

Framegrabber API#

  • 緩衝區佇列 API 現已提供於 C# 和 Python 封裝中。(票證 ID：315155)

其他#

  • Linux 和 Windows 中的範例現在包含一個根 CMake。(票證 ID：311719)

已修正的問題#

  • 在修正此問題之前，GPUDirect 中的擷取會回報與使用者無關的錯誤，導致無法檢查真正的錯誤。此問題現已修正，並已在 GPUDirect 範例中新增錯誤處理。(票證 ID：322499)
  • 在修正此問題之前，當連續 5 秒或更長時間沒有影像到達時，GPUDirect 中的擷取將會停止。此問題現已修正。現在，您可以透過呼叫來指定逾時 GDStartAcquisitionEx 或在 fgsdk.config 檔案中。（票證 ID：319200）
  • 在修正此問題之前，在 Python SDK 封裝中使用 Camera Link 序列埠時，Python 直譯器會當機。此問題現已修正，並已新增一個簡單的範例。(票證 ID：292560)
  • 在修正此問題之前，Windows 安裝程式會將 PATH 環境變數變更為 REG_SZ，這會破壞變數展開。此問題現已修正。(票證 ID：319997)
  • Applet 現在可在 Ubuntu 24.04 上載入，在此之前，這會受到以下相依性的阻礙： libtiff.so.5。(票證 ID：316368)
  • 在修正此問題之前， nullptr 字串類型輸出緩衝區中的內容先前不被允許，這會導致字串大小不正確。此問題現已修正。現在， nullptr 字串類型輸出緩衝區中的內容已被允許，且字串大小會正確寫入附加值中。(票證 ID：318444)
  • 對已過時變數的參考 SISODIR5, SISODIR5_32 進行明確的生命週期管理即呼叫 SISODIR5_64 已從 Windows 安裝程式中移除。(票證 ID：316211)
  • 已將遺失的工具 licenseTool 新增至 Linux bin 資料夾中。（票證 ID：311719）
  • 在修正此問題之前，遺失了 GenICam 標頭檔。因此，GenICam 範例專案無法進行編譯。此問題現已修正。(票證 ID：311719)