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

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

一般資訊#

產品名稱已從 Basler Runtime 變更為 Basler Framegrabber SDK。
Framegrabber SDK 現已支援 Windows 11 (64-bit) 與 Linux Ubuntu 22.04 (64-bit)。（票證 ID：231590 與 244875）
The Framegrabber SDK installer for Windows has been updated. Among others, installation paths (e.g. <Basler>), environment variables (e.g. BASLER_FG_SDK_DIR)，且名稱已變更。如需詳細資訊，請參閱環境變數與標頭檔重新命名。(票證編號：218027 和 227082)
Windows 32 位元程式庫現已整合至 Windows 64 位元安裝程式中。(票證 ID：253234)
Framegrabber SDK 的 GenICam 參考實作程式庫已移至主安裝資料夾中。(票證 ID：236467)
在 Linux 上，所有 GUI 與命令列工具（例如 microDisplay X、FirmwareUpdater 等）皆應透過位於 /bin 下的相關指令碼來啟動。(票證編號：250971 與 253097)

環境變數與標頭檔重新命名#

安裝期間設定的環境變數已重新命名：

SISODIR5 已更改為 BASLER_FG_SDK_DIR.

下列標頭檔已重新命名：

舊名稱	新名稱	包含於
fgrab_define.h	fg_define.h 與 fg_error_codes.h	basler_fg.h
fgrab_struct.h	fg_struct.h	basler_fg.h
fgrab_prototyp.h	basler_fg.h

下列標頭檔已重新結構化：

檔案名稱	變更
fgrab_define.h	fgrab_define.h 的大部分內容現在已重新命名為檔案 fg_define.h。
fgrab_define.h	先前位於 fgrab_define.h 中的錯誤定義，現在已移至新的標頭檔 fg_error_define.h 中。

下列標頭檔已被移除：

fgrab_triangultion.h
fgrab_blob.h

檔案 fgrab_define.h、fgrab_struct.h 和 fgrab_prototyp.h 仍以最精簡的標頭檔形式存在。如果您包含其中一個已停用的標頭檔，將會發生以下情況：

您會收到「depricated」警告。
系統將自動包含對應的新 fg_ 檔案，而不是已停用的 fgrab_ 檔案。

自 Framegrabber SDK 5.10 版本起，僅應使用 basler_fg.h。

停用項目#

Windows 32 位元#

Framegrabber SDK 不再支援 Windows 32 位元和 Linux 32 位元作業系統。(票證 ID：231590)

擷取卡#

以下擷取卡已終止支援：

microEnable IV
microEnable 5 marathon CLHS
microEnable 5 ironman

關於所有停用產品的詳細資訊，請參閱 Basler 停用產品頁面

第三方介面#

下列第三方介面已停用：

LabView（另請參閱 API 範例）
專有的 Cognex VisionPro Adapter
專有的 MVTec HALCON 配接器
CVB

Cognex VisionPro Adapter 和 MVTec HALCON 配接器可以透過 GenTL 介面取代。（問題單 ID：231588、212114、212120、255221）

Framegrabber API#

改善了未找到 Applet 時日誌訊息的用語。（問題單 ID：225003）

microDiagnostics 與 microDisplay X 工具#

microDisplay X 中的 Help 選單位置已變更。Help 選單現在位於此處：

（問題單 ID：230984）
在此之前，當使用尚未燒錄韌體的 microDiagnostics 關閉時，結束對話方塊詢問的是是否要燒錄「applets」而非「firmware」。結束對話方塊中的用詞已修正。（工單 ID：212124）

API 範例#

C/C++ SDK 範例現在可以使用較新版本的 Microsoft Visual Studio 進行建置，例如 Visual Studio 2019 或更新版本。（問題單 ID：226757、249321、227119）
National Instruments LabView 範例程式已從 Framegrabber SDK 發行套件中移除。如有需要，請參閱 Basler 技術支援以取得適用於 NI LabView 的範例程式。（工單 ID：231588 與 227110）

驅動程式#

imaWorx CXP-12 Quad frame grabber 的驅動程式在其自動停止行為方面得到了改進。現在，當相機傳送了要求的影格數時，擷取就會停止。此外，最終進入虛擬緩衝區的影格現在也會被納入考量。在此之前，當使用者在其使用者緩衝區中接收到要求的影格數時，擷取就會停止。（工單 ID：235859）
microEnable 5 frame grabbers 的驅動程式現在包含一個用於取得影格編號的 API。（工單 ID：227072）
microEnable 5 驅動程式的緩衝區處理已得到改進。（工單 ID：235850 與 236981）
相機與擷取卡之間透過 ClSerComWrapper2 進行的通訊速度已提高。（工單 ID：236732）
與 microEnable 5 擷取卡的通訊已擴充，以支援硬體的不同變體。（問題單 ID：231003、232694）
裝置探索功能已獲得改善。（問題單 ID：238309）
CXP 和 Camera Link 相機的探索功能已獲得改善（問題單 ID：229754、226742、230948、240393）。

修正的問題#

在此之前，GenTL BUFFER_INFO_FRAME_ID，可以透過以下方式查詢 DSGetBufferInfo，未包含來自 CXP 影像標頭的來源標籤。取而代之的是，它包含傳送至電腦的所有影格的計數器。此問題已修正。（問題單 ID：197430）
先前，在讀取 CXP 相機 XML 的 URL 時，Framegrabber SDK 假設暫存器大小為 256 位元組。然而，在讀取相機 XML 的 URL 時假設特定的暫存器大小違反了 CXP 標準。此問題已修正。現在，不再假設暫存器大小，且 Framegrabber SDK 遵循 CXP 標準。（問題單 ID：228438）
先前，在讀取 CXP 相機 XML 的 URL 時，Framegrabber SDK 假設 XML 根元素是帶有大寫「L」的「Local」。然而，CXP 標準規定 URL 不區分大小寫。此問題已修正。現在，URL 的解析方式已變更為適用於任何大小寫。（問題單 ID：228439）
先前，GenICam GenTL Producer 並未為所有節點提供「Selecting」的值。此問題已修正。（問題單 ID：212118）
先前，GenICam GenTL Producer 未在屬性中提供正確的廠商名稱和介面 ID。此問題已修正。（問題單 ID：225073）
已修正可能的 GenICam GenTL 死結問題。（問題單 ID：238352）
先前，在 microDisplay X 中變更 microEnable 5 擷取卡的 Applet 並不總是成功。此問題已修正。（問題單 ID：229736）
ROI 功能的行為已最佳化。（問題單 ID：229952）
在此之前，透過 -h 開啟命令列工具 gpioTool 的 Help 功能時，顯示的範例不正確且無法運作。此問題已修正。（工單 ID：221628）
在此之前，FirmwareUpdate 工具的一些錯誤訊息容易令人誤解或拼寫錯誤。因此，錯誤訊息的用詞已獲得改善。（工單 ID：223690、223689）
先前，在 Linux 20.04 上啟動 microDisplay X 和 microDiagnostics 時，工具會因錯誤而關閉。此問題已修正。（票證 ID：233534）
先前，microDisplay X 在載入後解除載入 Applet 時傳回錯誤。此問題已修正。（票證 ID：212132）
先前，microDisplay X 在變更 Applet 時未停止影像擷取。此問題已修正。（票證 ID：220077）
在此之前，microDisplay X 中的 Save Parameters 和 Load Parameters 按鈕無法正常運作。此問題已修正。（工單 ID：238752）
先前，PC 重新開機後在 microDisplay X 中載入 Applet 會導致錯誤。此問題已修正。（票證 ID：236228）
先前，載入影像序列時 microDisplay X 當機。此問題已修正。（票證 ID：212616）
先前，轉換迴圈參數在 microDisplay X 中未正確顯示。此問題已修正。（票證 ID：234064）
先前，microDisplay X 未識別 Basler 雙通道 CXP-12 相機。此問題已修正。（票證 ID：235720）
先前，如果在捲動視窗時進行影像擷取，microDisplay X 會當機。此問題已修正。（票證 ID：238904）
先前，在 imaWorx CXP-12 Quad 上載入 HAP 檔案時 microDisplay X 當機。此問題已修正。（票證 ID：235946）
先前，microDisplay X 未顯示 Property 描述。此問題已修正。（票證 ID：242207）
先前，microDisplay 無法正確顯示大型影像（例如 10500 x 43500 像素）。此問題已修正。（票證 ID：246410）
先前，在 microEnable 5擷取卡上的 microDiagnostics X 中載入 HDR0 並未總是正常運作。此問題已修正。（票證 ID：234254）
先前，在 Linux Ubuntu 系統上初始化 imaWorx CXP-12 Quad 上的 Applet 時 Fg_init 失敗。此問題已修正。（票證 ID：234499）
先前，在 LookupTable 中設定或選取 imaWorx CXP-12 Quad 的 Applet 值無法運作。此問題已修正。（票證 ID：221621）
先前，遞增某些 imaWorx CXP-12 Quad Applet 的 ROI 寬度會導致錯誤。此問題已修正。（票證 ID：249177）
先前，當呼叫 Fg_AllocMemHead 在 imaWorx CXP-12 Quad 上多次呼叫時，每次呼叫此函式後執行時間會增加。此問題已修正。（票證 ID：247416）
先前，呼叫 Sgc_(re)storeLowLevelLinkProfile() 在 imaWorx CXP-12 Quad 上時發生錯誤。此問題已修正。（票證 ID：246768）
擷取卡庫事件現在是執行緒安全的（Thread-Safe）。（票證 ID：236809）
先前，載入每部相機具有多個 DMA 的 Applet 會導致 microDisplay X 發生錯誤。此問題已修正（票證 ID：237342）
先前，由於 HAP 檔案載入失敗，導致初始化擷取卡失敗。此問題現已修正。(票證 ID：237013)
當開啟/關閉 AutomaticROIControl 參數時，相關參數的可見性現在能正常運作。(票證 ID：217774)
Fg_getSWVersion() 現在會傳回您已安裝的 Framegrabber SDK 的正確版本號碼。(票證 ID：202240)
前 MVTec HALCON 專有適配器的最新 13.0.11 版本經過改進，支援高達 4 GBytes 的傳輸。此適配器隨 Framegrabber SDK 5.10.0 一起停用，Basler 建議改用 GenICam GenTL 介面。(票證 ID：231049、231326、218503)
先前，使用前 MVTec HALCON 專有適配器時，影像擷取會意外停止。此問題現已修正。此適配器隨 Framegrabber SDK 5.10.0 一起停用，Basler 建議改用 GenICam GenTL 介面。(票證 ID：229938)