Framegrabber SDK 5.10.0 中的變更與修復問題#
一般資訊#
- 產品名稱已從 Basler Runtime 變更為 Basler Framegrabber SDK。
- Framegrabber SDK 現已支援 Windows 11 (64 位元) 與 Linux Ubuntu 22.04 (64 位元)。(票證 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)，且名稱已變更。如需詳細資訊，請參閱 環境變數與標頭檔重新命名。(票證 ID：218027 與 227082) - Windows 32 位元程式庫現已整合至 Windows 64 位元安裝程式中。(票證 ID：253234)
- Framegrabber SDK 的 GenICam 參考實作程式庫已移至主安裝資料夾中。(票證 ID：236467)
- 在 Linux 上，所有 GUI 與命令列工具 (例如 microDisplay X、FirmwareUpdater 等) 都應透過位於 /bin 下的相關指令碼來啟動。(票證 ID：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 位元作業系統。（問題單編號：231590）
擷取卡#
以下擷取卡已終止支援：
- microEnable IV
- microEnable 5 marathon CLHS
- microEnable 5 ironman
關於所有已停用產品的詳細資訊，請參閱 Basler 已停用產品頁面
第三方介面#
以下第三方介面已終止支援：
- LabView（另請參閱 API 範例）
- 專有的 Cognex VisionPro Adapter
- 專有的 HALCON adapter
- CVB
Cognex VisionPro Adapter 與 HALCON adapter 可以由 GenTL 介面取代。（問題單編號：231588、212114、212120、255221）
Framegrabber API#
- 針對未找到 Applet 的情況，日誌訊息的措辭已獲得改進。（問題單編號：225003）
微型工具 microDiagnostics 與 microDisplay X#
-
microDisplay X 中的 Help 功能表位置已變更。Help 功能表現在位於此處：
（問題單編號：230984）
-
先前，在使用未燒錄韌體關閉 microDiagnostics 時，結束對話方塊詢問是否應燒錄「applets」而非「firmware」。結束對話方塊中的用詞已修正。（問題單編號：212124）
API 範例#
- C/C++ SDK 範例現在可以使用較新版本的 Microsoft Visual Studio（例如 Visual Studio 2019 或更新版本）進行建置。（問題單編號：226757、249321、227119）
- National Instruments LabView 範例程式已從 Framegrabber SDK 發行套件中移除。如有需要，請參閱 Basler Technical Support 以取得適用於 NI LabView 的範例程式。（問題單編號：231588 與 227110）
驅動程式#
- 針對 imaWorx CXP-12 Quad frame grabber 的驅動程式已改善其自動停止行為。現在，當攝影機傳送完請求的影格數時，擷取即會停止。此外，最終落入虛擬緩衝區（dummy buffer）中的影格現在也會被納入考量。先前，擷取是在使用者在其使用者緩衝區中收到請求的影格數時停止。（問題單編號：235859）
- 針對 microEnable 5 frame grabbers 的驅動程式現在包含一個用於取得影格編號的 API。（問題單編號：227072）
- microEnable 5 驅動程式的緩衝區處理已獲得改善。（問題單編號：235850 與 236981）
- 透過 ClSerComWrapper2 在攝影機與擷取卡之間通訊速度已提升。（問題單編號：236732）
- 與 microEnable 5 frame grabbers 的通訊已擴充，以支援硬體的不同變體。（問題單編號：231003、232694）
- 裝置探索功能已獲得改善。（問題單編號：238309）
- CXP 與 Camera Link 攝影機的探索功能已獲得改善（問題單編號：229754、226742、230948、240393）。
已修正的問題#
- 先前，GenTL
BUFFER_INFO_FRAME_ID可透過DSGetBufferInfo進行查詢，其中未包含來自 CXP 影像標頭的來源標籤。取而代之的是，它包含傳送至電腦的所有影格的 Counter。此問題已修正。（問題單編號：197430） - 先前，當讀取 CXP 攝影機 XML 的 URL 時，Framegrabber SDK 假設暫存器大小為 256 位元組。然而，在讀取攝影機 XML 的 URL 時假設特定的暫存器大小違反了 CXP 標準。此問題已修正。現在不再假設暫存器大小，且 Framegrabber SDK 遵循 CXP 標準。（問題單編號：228438）
- 先前，當讀取 CXP 攝影機 XML 的 URL 時，Framegrabber SDK 假設 XML 根元素是大寫「L」開頭的「Local」。然而，CXP 標準規定 URL 不區分大小寫。此問題已修正。現在，URL 的解析方式已變更為可相容於任何大小寫。（問題單編號：228439）
- 先前，GenICam GenTL producer 未為所有節點提供「Selecting」的值。此問題已修正。（問題單編號：212118）
- 先前，GenICam GenTL producer 未在屬性中提供正確的供應商名稱和介面 ID。此問題已修正。（問題單編號：225073）
- 已修正可能的 GenICam GenTL 死結問題。（問題單編號：238352）
- 先前，在 microDisplay X 中變更 microEnable 5 frame grabber 的 applet 並非總是成功。此問題已修正。（問題單編號：229736）
- ROI 功能的行為已最佳化。（問題單編號：229952）
- 先前，透過 -h 開啟命令列工具 gpioTool 的 Help 功能時，顯示的範例不正確且無法運作。此問題已修正。（問題單編號：221628）
- 先前，FirmwareUpdate 工具的一些錯誤訊息容易令人混淆或拼寫錯誤。因此，錯誤訊息的用詞已獲得改善。（問題單編號：223690、223689）
- 此前，在 Linux 20.04 上啟動 microDisplay X 和 microDiagnostics 時，這些工具會因錯誤而關閉。此問題現已修正。（問題單編號：233534）
- 此前，microDisplay X 在載入後又卸載 applet 時會傳回錯誤。此問題現已修正。（問題單編號：212132）
- 此前，microDisplay X 在變更 applet 時未停止影像擷取。此問題現已修正。（問題單編號：220077）
- 此前，microDisplay X 中的 Save Parameters 與 Load Parameters 按鈕無法正常運作。此問題現已修正。（問題單編號：238752）
- 此前，PC 重新開機後在 microDisplay X 中載入 applet 會導致錯誤。此問題現已修正。（問題單編號：236228）
- 此前，載入一序列影像時 microDisplay X 會當機。此問題現已修正。（問題單編號：212616）
- 此前，microDisplay X 未能正確顯示迴圈轉換（translation loop）參數。此問題現已修正。（問題單編號：234064）
- 此前，microDisplay X 無法辨識 Basler 雙通道 CXP-12 相機。此問題現已修正。（問題單編號：235720）
- 此前，如果在影像擷取期間捲動視窗，microDisplay X 會當機。此問題現已修正。（問題單編號：238904）
- 此前，在 imaWorx CXP-12 Quad 上載入 HAP 檔案時 microDisplay X 會當機。此問題現已修正。（問題單編號：235946）
- 此前，microDisplay X 未顯示參數屬性的描述。此問題現已修正。（問題單編號：242207）
- 此前，microDisplay 無法正確顯示大型影像（例如 10500 x 43500 像素）。此問題現已修正。（問題單編號：246410）
- 此前，在 microEnable 5 取像卡上的 microDiagnostics X 中載入 HDR0 不一定能正常運作。此問題現已修正。（問題單編號：234254）
- 此前，在 Linux Ubuntu 系統上初始化 imaWorx CXP-12 Quad 上的 applet 與
Fg_init失敗。此問題現已修正。（問題單編號：234499） - 此前，在 LookupTable 中為 imaWorx CXP-12 Quad 的 applet 設定或選取值無法運作。此問題現已修正。（問題單編號：221621）
- 此前，增加某些 imaWorx CXP-12 Quad applet 的 ROI 寬度會導致錯誤。此問題現已修正。（問題單編號：249177）
- 先前，當呼叫
Fg_AllocMemHead在 imaWorx CXP-12 Quad 上多次執行時，每次呼叫此函式後執行時間都會增加。此問題現已修正。（問題單編號：247416） - 先前，在排隊緩衝區並在高影格率下使用
Sgc_(re)storeLowLevelLinkProfile()在 imaWorx CXP-12 Quad 上發生了錯誤。此問題現已修正。（問題單編號：246768） - 取像卡程式庫事件現已具備執行緒安全性（thread-safe）。（問題單編號：236809）
- 此前，在 microDisplay X 中載入每個相機具有多個 DMA 的 applet 會導致錯誤。此問題現已修正。（問題單編號：237342）
- 此前，由於 HAP 檔案載入失敗，導致初始化取像卡失敗。此問題現已修正。（問題單編號：237013）
- 開啟／關閉
AutomaticROIControl參數時，相關參數的可見性現在可正常運作。（問題單編號：217774） Fg_getSWVersion()現在會傳回您已安裝之 Framegrabber SDK 的正確版本號碼。（問題單編號：202240）- 針對前 MVTec HALCON 專有介面卡所推出的最新 13.0.11 版本經過改良，現已支援高達 4 GBytes 的資料傳輸。此介面卡已隨 Framegrabber SDK 5.10.0 一同停產，Basler 建議改用 GenICam GenTL 介面。(Ticket IDs: 231049, 231326, 218503)
- 以往使用前 MVTec HALCON 專有介面卡時，影像擷取會發生非預期停止的問題。此問題現已修復。此介面卡已隨 Framegrabber SDK 5.10.0 一同停產，Basler 建議改用 GenICam GenTL 介面。(Ticket ID: 229938)