Framegrabber SDK 5.11.3 已知問題#

本節提供有關 Basler Framegrabber SDK 5.11.3 版已知問題的資訊。

所有元件#

總結	Applets Built with Vivado 2025.1 May Not Be Loaded
描述	使用 Vivado 2025.1 版本建立的 Applet 有時可能會載入失敗。
受影響的作業系統	Linux 與 Windows
因應措施	這個問題已在 Framegrabber SDK 5.11.6 中修正。因此，為避免此問題，請使用 Framegrabber SDK 5.11.6 或更高版本，或者使用 Vivado 2023.2 來建置您的 Applet。
票單 ID	341684

總結	儲存與載入 MCF-Files 導致倍精確度浮點數被四捨五入為整數
描述	從 MCF-file 載入組態時，使用逗號分隔符號的倍精確度浮點數可能會被四捨五入至最接近的整數。這是由 Linux 作業系統目前的地區設定（locale）所引起的。若地區設定使用點作為分隔符號，則不會發生四捨五入的情況。
受影響的作業系統	Linux
因應措施	在啟動 microDisplay X 或 microDiagnostics 之前，請設定適當的地區設定（locale），例如 `LC_NUMERIC="C" ./<applicationName>`。
票單 ID	265213

總結	相機無法輸出正確的影像
描述	若具備多個連線（link）的相機在透過連線分配影像資料時不符合 CXP 標準，相機將無法正確傳輸影像。在 JAI SP-12000C-CXP4 相機上觀察到了此問題。
受影響的作業系統	Windows 與 Linux
因應措施	沒有可用的因應措施。
票單 ID	211645

總結	Linux 驅動程式無法使用受信任的 Basler 憑證進行簽署
描述	在 Linux 中使用安全開機 (UEFI 模式) 需要使用以受信任憑證簽署的驅動程式。由於驅動程式是以原始程式碼的形式提供，因此無法使用受信任的 Basler 憑證進行簽署。
受影響的作業系統	Linux
因應措施	若要使用該驅動程式，可以停用安全開機。或者，您可以依照此 Ubuntu 部落格文章中的說明來簽署驅動程式。
票單 ID	–

總結	顯示高影格率的影像可能會導致輸入延遲
描述	當使用 display_lib Framegrabber API 程式庫（僅適用於 Windows）時，顯示高影格率（約每秒 10,000 個影格）的影像可能會導致主機電腦發生輸入延遲（例如鍵盤和滑鼠延遲）。
受影響的作業系統	Windows
因應措施	沒有可用的因應措施。
票單 ID	–

總結	系統中安裝的驅動程式數量多於 CLSer 連接埠的數量
描述	有時在使用 Install COM driver(s) for all Ports 時，安裝的驅動程式數量會多於系統中的 CLSer 連接埠數量。
受影響的作業系統	Windows
因應措施	請選取額外的連接埠，並使用 Remove selected COM driver 命令將其移除。
票單 ID	–

總結	使用 Basler Runtime 5.9.0 或更早版本時，無法辨識板卡類型
描述	使用 Basler Runtime 5.9.0 或更早版本時，無法辨識板卡類型，且連接埠僅會透過 CLSer識別碼顯示。
受影響的作業系統	Windows
因應措施	請將您的 Basler Runtime/Framegrabber SDK 版本更新至 5.10 或更高版本。
票單 ID	–

總結	裝置管理員中的連接埠設定無法反映實際設定
描述	裝置管理員中的連接埠設定無法反映實際設定，且變更不會生效。
受影響的作業系統	Windows
因應措施	使用 Windows COM Port API 來變更連接埠設定。
票單 ID	–

總結	Camera Parameters Changed after Image Acquisition Start Aren't Reflected in the Frame Grabber
描述	當在影像擷取期間變更相機參數時，該變更不會反映在擷取卡中。這是因為 GenTL Producer 會在開始擷取之前擷取相關參數（寬度、高度、影像格式等），並將這些參數與擷取卡進行同步。
受影響的作業系統	Windows 與 Linux
因應措施	沒有可用的因應措施。
票單 ID	195482 和 225591

總結	The GenTL Device ID Changes When the Applet Is Changed
描述	根據 GenTL 標準，裝置 ID 在兩個工作階段之間應保持不變。然而，當 Applet 變更時，GenTL 裝置 ID 也會隨之改變。因此，只有在 Applet 的名稱與產生該裝置 ID 的 Applet 相同時，才能重複使用該裝置 ID。
受影響的作業系統	Windows 與 Linux
因應措施	沒有可用的因應措施。
票單 ID	–

總結	對於包含兩個 Camera 運算子的 VisualApplets 設計，相機偵測有時無法在 microDisplay X 中運作
描述	對於包含兩個 Camera 運算子的 VisualApplets 設計，如果其中至少一個運算子具有兩個通道且資源索引按直接遞增順序分配，則相機偵測無法在 microDisplay X 中運作。例如，兩個 Camera 運算子各有兩個通道，運算子 A 使用連接埠 0 和 1，運算子 B 使用連接埠 2 和 3。
受影響的作業系統	Windows 與 Linux
因應措施	請勿直接按升序分配資源索引。例如，將營運商 A 的通道分配至埠 0 和 2，將營運商 B 的通道分配至埠 1 和 3。
票單 ID	314206

總結	microDisplay X 載入設計複雜的 HAP 檔案時會發生當機
描述	某些非常複雜的 VisualApplet 設計，可能會導致在microDisplay X 中載入小程式期間或載入完成後立即發生當機。在 SDK 程式中尚未觀察到此類當機情況。
受影響的作業系統	Windows 與 Linux
因應措施	請再次在microDisplay X 載入該小程式。若在microDisplay X 載入該小程式，通常嘗試兩三次後便能成功。
票單 ID	314234

總結	在全新安裝的 Linux 系統上，microDisplay X 無法啟動
描述	在全新安裝的 Linux 系統上，microDisplay X 無法啟動。此問題的原因在於全新安裝的 Linux 系統缺少 `xcb` QT 平台外掛程式。
受影響的作業系統	Linux
因應措施	請使用以下方式安裝缺少的外掛程式： `sudo apt install libxcb-xinerama0` 命令。
票單 ID	259941

總結	在 Linux 上，microDisplay X 關閉時可能會發生當機
描述	在 Linux 上，microDisplay X 在關閉時可能會發生當機。這不會造成其他後續影響，可以忽略。
受影響的作業系統	Linux
因應措施	沒有可用的因應措施。
票單 ID	211811

總結	沒有適用於 imaFlex 平台的 python Wrapper 範例
描述	Framegrabber SDK 未隨附適用於 imaFlex 平台的 python Wrapper 範例。
受影響的作業系統	Windows 與 Linux
因應措施	請改用適用於其他平台的範例並進行調整。
票單 ID	–

總結	C# Wrapper 不接受 FieldParameterInt 中的負值
描述	`FieldParameterInt.value` 是一個無符號整數，Framegrabber SDK 可以正確處理。在 C# wrapper 中，指派負值（例如 `-1`）將無法通過編譯，因此 `SiSoCsRt.Fg_setParameterWithFieldParameterInt` 無法直接使用該數字進行呼叫。
受影響的作業系統	Windows 與 Linux
因應措施	將值指派給 `unchecked` 之前，請先使用 `Fg_setParameterWithFieldParameterInt`對於 `-1`，則應使用 `fieldParameter.value = unchecked((uint)-1);`.
票單 ID	332625