pylon Software Suite 8.0.2 發行版本資訊#
二進位相容性#
- Data Processing = 3.0.1
使用 3.0.x 或較早 3.x.x 版本的 Data Processing 建置的應用程式相容。 - pylon C SDK = 9.0.0
使用較早版本 pylon SDK 建立的應用程式不相容。 - pylon C++ SDK = 9.1.1
使用 9.1.x 或更早 9.x.x 版本 pylon C++ SDK 建立的應用程式相容。 - pylon .NET SDK = 1.2.0
使用 1.2.x 或更早 1.x.x 版本 pylon .NET SDK 建立的應用程式相容。
新功能 / 變更#
- 通用:[313183] 新增對 racer 2 線性掃描彩色相機和 BiColor Pixel Format 的支援。
- pylon Viewer:[297112] 在修改設定檔線條的起點或終點時,滑鼠指標附近的工具提示會顯示該點目前的 X 和 Y 座標。
- pylon Viewer:[301476] 在影像顯示區域的狀態列中新增對 BiColor Pixel Format 的支援。
- pylon Viewer:[301474] 在 Histogram 功能中新增對 BiColor Pixel Format 的支援。
- pylon Viewer:[301473] 在 Line Profile 功能中新增對 BiColor Pixel Format 的支援。
- pylon Viewer:[297670] 改進了線條剖面軸刻度和標籤的位置。
- GenTL/CXP:[315154] 在 GenTL 中新增對 BiColor 格式的支援。根據 Device XML 中 'OutputPackedFormats' Property 的值,這些格式會自動轉換為 BGR 封包或未封包格式
- GenTL/CXP: [316516] 可以為執行中的擷取記錄更多詳細資料。由於某些訊息(例如傳入的影格)產生的頻率與影格率相同,因此提供了一個新的記錄類別
basler.GenTL.Acq現已可用於開啟或關閉這些訊息。這些訊息將在記錄層級NOTICE或更高層級時可見。 - pylon C++ SDK:[312362] CBaslerUniversalInstantCamera 類別已更新。
- pylon .NET SDK:[312362] PLCamera 類別已更新。
修正#
- pylon Viewer:[319153] 修復了幾個損壞的連結。
- pylon Viewer:[318731] 修復了 Features Pane 中的滑桿在設定值時表現不正確的問題。
- GigE:[313183] GigE Configurator 現在可以正確設定未建立連線的多埠介面卡的介面。
- GigE: [316669] 驅動程式不再將 BlockID64 資料轉換為 BlockID16 資料。
- Direct Show:[319213] 現在已設定連結相依項目的適當版本。
- vTools:[318406,319650] Image Loading vTool 現在可以載入和儲存包含 Unicode 字元的路徑中的配方。
限制#
- pylon Viewer:pylon Viewer 中已實作新的影像節流功能,以改善整體穩定性和效能。這引進了一項影響 pylon Viewer 影片錄製功能的新限制。在影像處理管線中,每個相機每秒僅允許 250 張影像,當超過此限制時,將限制錄製每張畫面的能力。
- pylon Viewer:Color Calibrator 不支援所有 Basler 彩色相機。由於相機功能集不同,因此不支援 Basler dart 和 boost V 相機。
- pylon Viewer:在某些情況下 (例如電腦非常慢或忙碌),如果相機已經在 pylon Viewer 中開啟,Color Calibrator 可能無法運作。為防止這種情況發生,請在使用 Color Calibrator 之前關閉相機。
- pylon Viewer:在配備 Intel HD 顯示卡的電腦上,可能需要將顯示卡驅動程式更新至最新版本。
- pylon Viewer:Stereo ace 2 相機擷取的影像暫時無法顯示。
- GenTL: 對於 GenTL 版本 1.4 及更舊版本的 Producer,GenTL 支援有限。
- GenTL/CXP:現在使用 Visual Studio 2022 進行編譯,因此必須安裝 Visual Studio 2022 可轉發套件才能載入 Memory。
- GenTL/CXP:實際的 buffer 大小限制為 2 Gbit,這因此對 producer 中 Width 和 Height 的允許值施加了限制,導致最大圖像大小為 2GB。
- GenTL/CXP:fps 限制從 50000 fps 到 90000 fps 不等,具體取決於 buffer 數量和圖像大小。關於更詳細的近似值,10 個 buffer 與最小圖像大小 48x1 的限制約為 50000 fps,50 個 buffer 與最小圖像大小 48x1 的限制約為 90000 fps,而 50 個 buffer 與圖像大小 8192x1 的限制則約為 50000 fps。
- GenTL/CXP: 當在影像擷取期間變更相機參數時,該變更不會反映在擷取卡中。這是因為 GenTL Producer 在開始擷取之前會擷取相關參數(寬度、高度、影像格式等),並將這些參數與擷取卡進行同步。
- GenTL/CXP: 根據 GenTL 標準,裝置 ID 在兩個工作階段之間應保持不變。但是,當變更小程式 (Applet) 時,GenTL 裝置 ID 會隨之改變。因此,只有在小程式 (Applet) 的名稱與產生裝置 ID 時所使用的小程式 (Applet) 名稱相同時,才能重複使用裝置 ID。
- GenTL/CXP: 如果您的電腦上安裝了某個版本的 Basler Framegrabber SDK,在使用 CoaXPress 相機和介面卡時可能會遇到相容性問題。因此,Basler 建議不要與 Framegrabber SDK 平行安裝 pylon。
- GenTL/CXP: 配置用於抓取的緩衝區時,緩衝區位址必須對齊 8 位元組的倍數。如果您使用堆積記憶體 (Heap Memory),則會自動符合此條件。
- GenTL/CXP: 不支援使用 Basler CXP-12 Interface Card 1C 以超過 50000 fps 的極高影格速率進行抓取。
- GenTL/CXP: 在罕見的情況下,電腦開機後可能會找不到相機。請將相機重新上電以解決此問題。
- GenTL/CXP: 當變更相機的 DeviceUserID 時,必須重新啟動 GenTL Producer,變更才會透過 GenTL API 反映出來。當使用 GUI 透過 GenTL 與相機互動(即 pylon Viewer)時,必須重新啟動該應用程式,變更才會顯現。
- GenTL/CXP: 在變更小程式 (Applet) 期間,連接到介面卡的相機仍然會顯示在裝置清單中,即使它們已無法存取。在這種狀態下嘗試開啟相機會導致錯誤訊息。
- GenTL/CXP: 可以透過 DSGetBufferInfo 查詢的 GenTL BUFFER_INFO_FRAME_ID 不包含來自 CXP 影像標頭的來源標籤。相反地,它包含傳送至電腦的所有影格的計數器。
- GenTL/CXP: 如果由於緩衝區滿溢而導致影像在介面卡上遺失(例如當使用者應用程式未能足夠快地將緩衝區(重新)加入佇列以傳送影像時),遺失的影像將由下一個傳送的緩衝區指出。遺失的影像將被標記為 INCOMPLETE,其檔案大小將為 0,並且自訂錯誤代碼 BUFFER_INFO_BASLER_XAPI_ERROR_CODE 將設為 42。此外,串流資訊中會增加一個遺失的影格。請注意,無論因滿溢而遺失了多少個影格,都剛好只會增加一個遺失的影格。
- GenTL/CXP: Basler CXP-12 Interface Card 1C/2C/4C 與 imaWorx CXP-12 Quad 擷取卡需要具備 PCIe Gen 3 x8(直接記憶體存取)或更高規格的主機介面。使用較慢的主機介面可能會降低相機的擷取影格速率並導致影像遺失。
- pylon C SDK:pylon C API 尚未提供便於使用 GenDC 和 Basler blaze 3D 相機的函式。
- pylon C and C.NET SDK:為了使用 GenTL Consumer(例如配合 CoaXPress),pylon C 中新增了額外功能,能夠明確地啟動和停止串流。此功能尚未記錄在 pylon C 程師指南中。請參閱 pylon C++ 程師指南(請參閱「Migrating from Previous Versions - Changes in the IStreamGrabber API」章節)或 pylonC OverlappedGrab 程範例。
- pylon C++ SDK: 使用 CMake 建置範例時,您可能會遇到作業系統的路徑長度限制。您可能會收到建置錯誤,指出路徑超過 260 個字元的最大路徑長度。如果您的 CMake 建置目錄的絕對路徑超過 80 個字元,就可能會發生這種情況。建置目錄是當前工作目錄或您呼叫 cmake 時由 '-B' 選項指定的目錄。如果您遇到此錯誤,請使用路徑較短且不超過 80 個字元的建置目錄,例如直接在您的使用者個人資料 C:\Users\ 中
\Samples。您可以在 Windows 10 版本 1607 及更新版本上啟用長路徑。請參閱 Microsoft 文件以取得更多資訊。 - pylon C++ SDK: 使用 Visual Studio 2017 時,您可能會收到 MSB4211 警告。若要移除此警告,請在 Release 和 Debug 專案屬性中指定 Windows SDK 的版本(Configuration Properties -> General -> Windows SDK Version)。
- pylon C++ SDK: 某些 ace 2 相機可能會使用布林參數代替常用的列舉來進行事件通知。可以使用以下程式碼片段來繞過此問題。對於 C++,除了 camera.EventNotification.TrySetValue(EventNotification_On); 之外,您還可以使用:CBooleanParameter(camera.GetNodeMap(), "EventNotification").TrySetValue(true);
- pylon C++ SDK: InstantCameraArray 類別最多可從 21 台相機擷取影像。
- GigE: 如果回報了錯誤訊息 "Failed to allocate resources.",Basler 建議使用 pylon GigE Configurator 工具來最佳化 NIC 和相機的 IP 設定。
- GigE: IP Configurator 工具未完整支援單一網路介面上的多個 IP 設定。
- GigE: 為了最佳化使用 Basler ace 2 5GigE 與 1GigE 相機,Basler 建議使用雙通道 DDR4-3600 RAM 或更高規格。使用較慢的 RAM 可能會導致緩衝區不足和影像遺失。此外,Basler 建議使用 pylon GigE Configurator 工具來最佳化整體設定。
- USB: 由於 Basler U3V 裝置可能會發生不同步的情況,因此必須關閉 Intel USB 主控制器所使用的電源管理功能。若發生此情況,在某些情況下,系統開機後可能無法使用 Basler U3V 裝置。請透過下列步驟停用 USB3 匯流排上的 LPM 套件:
- 執行以下指令以啟用進階設定:
powercfg -attributes 2a737441-1930-4402-8d77-b2bebba308a3 d4e98f31-5ffe- 4ce1-be31-1b38b384c009 -ATTRIB_HIDE - 變更電源選項中的 LPM 設定。
- 開啟控制台中的「電源選項」。
- 按一下所選電源計畫的「變更計畫設定」。
- 按一下「變更進階電源設定」。
- 在「電源選項」對話方塊的「進階設定」索引標籤上,選取「USB 設定」。
- 將「USB 3 Link Power Management」設定為「Off」。
- 執行以下指令以啟用進階設定:
- MP4:MP4 影片錄製需要安裝 pylon Supplementary Package for MPEG-4 才能運作。pylon Supplementary Package for MPEG-4 可從 Basler 網站下載。
- MP4:如果將 Quality 參數設定為 80% 或更高,使用解析度達 20 MP 或更高的相機錄製視訊檔案可能會失敗。作為因應措施,請將 Quality 參數設定為較低的值。
- MP4:ace 2 Pro 相機中的 Recording 功能不支援 Compression Beyond 功能。當開始錄製且啟用 Compression Beyond 功能時,pylon Viewer 會先停用相機中的 Compression Beyond 功能,然後再開始錄製。
- 3D:使用 Basler blaze 3D 相機需要安裝 pylon Supplementary Package for blaze。pylon Supplementary Package for blaze 可從 Basler 網站下載。
- Direct Show: DirectShow 驅動程式不支援 CoaXPress 相機。
- pylon .NET SDK:更新至此版本的 .NET API 需要您更新 .NET 專案檔以參照新的組件。這是由於 VB2015 相容性修正而必須執行的操作(介面類別別 Basler.Pylon.IParameterListEnum 已變更為參考類別別 Basler.Pylon.ParameterListEnum)。
- pylon .NET SDK:如果為 .NET 專案啟用了原生偵錯,且專案參照了 pylon 組件,則在 Visual Studio 2012 或 Visual Studio 2013 偵錯工具下執行應用程式時,應用程式可能會當機。為避免此問題,請在 Visual Studio 偵錯工具選項中啟用「受管理的相容性」模式。
下載#
您可以在這裡下載此版本的 pylon Software Suite。