跳至內容
測試伺服器
開發伺服器

pylon Software Suite 8.1.0 發行版本資訊#

發布日期：2025-03-14

二進位相容性#

  • Data Processing = 3.0.1
    使用 3.0.x 或較早 3.x.x 版本的 Data Processing 建置的應用程式相容。
  • pylon C SDK = 10.0.0
    使用較早版本的 pylon C SDK 建置的應用程式不相容。
  • pylon C++ SDK = 10.2.1
    使用較早版本的 pylon C++ SDK 建置的應用程式不相容。

新功能 / 變更#

  • pylon .NET 5+ SDK：新增針對 Linux、Windows 和 macOS 利用 .NET 8.0 的語言繫結。
  • pylon C++ SDK：[322697] 修復了搭配 .NET 執行應用程式時執行 EltAppender 的問題。
  • pylon C++ SDK：[323481] CBaslerUniversalInstantCamera 類別已更新。
  • pylon C++ SDK：[324026] 已新增版本字尾至 GenICam 圖書館。
  • pylon C++ SDK：[324026] 新增了反向通道伺服器，允許在執行階段設定 Basler 記錄系統（EltAppender / pylon Event Logger）。
  • pylon C++ SDK：[316909] PylonGigEConfigurator：修復了 Windows 自動最佳化功能。它現在會再次設定最佳化值。
  • pylon C++ SDK：[321363] 改進了解壓縮的錯誤處理與說明文件。
  • pylon .NET SDK：[323481] 參數清單已更新。
  • CXP IC：[318735] 將 biColor 插補係數變更為 -0.5 1 -05，以遵循相機版本的插補。
  • CXP IC：[318735] 移除了 biColor 模式 GBGR 和 GRGB。
  • CXP IC：[318735] 擴充了 CameraStreamStatus 事件資訊。
  • GenTL：[323605] GEV/blaze GenTL 列舉的 DeviceInfo 物件現在包含 IP 位址、MAC 位址、子網路遮罩、預設閘道以及裝置製造商資訊等項目正確的值。
  • GenTL：[326394] 若沒有可用的 chunk，將不再擷取 chunk 資料。
  • GenTL/CXP： [320807,323583,320739,320740,320738,323587] 關於日誌記錄的多項變更。
    • GenTL Producer 內的頂層日誌類別現在稱為 FgSdk 而不是 FgSdk.
    • 對於每一個接收到的張量，額外的資訊（時間戳記、酬載大小等）會被記錄至日誌類別 FgSdk.GenTL.Acq。此類別預設會設定為日誌層級 FATAL 因為它對較高影格速率的效能有嚴重的影響。將此類別的日誌層級設定為 NOTICE 或更高即可啟用記錄功能。
    • 另一個日誌類別 FgSdk.fglib.Acq 是為了類似的目的而引入的，但僅在使用 Frame Grabber SDK 時直接生效。對於 pylon 應用程式，此項應始終設定為 FATAL.
    • 若要取得關於擷取卡（或 applet）事件的資訊，需使用新的 log category FgSdk.fglib.Events 已引入。由於事件發生的頻率也可能非常高，因此每個影格擷取卡 (frame grabber) 事件都會被記錄到類別 FgSdk.fglib.Events.<EventName> 其中 <EventName> 是事件的實際名稱。請使用這些類別進行精細的日誌記錄設定。請注意，必須由您的應用程式啟用影格擷取卡 (frame grabber) 事件，才能產生並記錄這些事件。
    • 用於偵測 CXP 連線問題的其他日誌訊息。
  • vTools：已將 CodeMeter 升級至 8.20a。
  • vTools：[320336] 新增了 Anomaly Detection vTool。
  • vTools：[316670] 為 Classification vTool 新增了批次處理 (Batching) 功能。批次處理允許您同時處理多個興趣區域 (ROI)，從而提高處理速度。
  • vTools：[298566] 新增了 Multiplexer vTool。
  • vTools：[307044] 新增了 OPC UA Client vTool。
  • Data Processing：[275911] 改進了執行緒集區 (thread pool) 實作，以優先處理較舊的圖形更新，並新增了執行緒優先順序。
  • Data Processing：[319406] 新增了關於 CBuildersRecipe 以及如何透過 pylon Data Processing C++ API 使用配方壓縮的資訊。
  • Data Processing：[319578] 更新了範例尋找工具，使其相容於未來 Basler 內部的 GenICam 版本。
  • Data Processing：[317568] 更新了範例尋找工具，使其相容於未來的 pylon 版本。
  • Data Processing：[310128] 為 CBuildersRecipe 類別新增了 SaveAs 方法，允許使用者指定配方檔案格式。
  • pylon Event Logger：[323553] 將 log4j.category.basler 變更為 log4j.category.FgSdk。
  • pylon Event Logger：[321118] 新增了啟動設定檔，用於設定已啟動或正在執行的日誌記錄應用程式。
  • pylon Event Logger：[320249] 改進了訊息檢視中新增日誌訊息的處理方式。過去在更新訊息檢視時會出現延遲，這意味著多個新訊息會同時新增。現在，新訊息會逐一新增，從而創造更流暢的體驗。
  • pylon Event Logger：[320856] 改進了狀態名稱、工具提示和其他使用者介面文字。
  • pylon Event Logger：[320418] 修復了顯示過濾器效能的問題。
  • pylon Event Logger：[320312] 現在可以匯入和匯出顯示與突顯過濾器設定。
  • pylon Event Logger：[319932] 現在可以設定檢視中的最大訊息數量。
  • pylon Event Logger：[320428] 將活動檢視中預設啟用的日誌級別變更為 WARN、ERROR 和 UNKNOWN。
  • pylon Event Logger：[319443] 在導覽檢視中新增了「捲動至結尾」(Scroll to End) 按鈕。
  • pylon Event Logger：[319447] 改進了訊息檢視中的捲動行為。
  • pylon Event Logger: [319890] 在 Display/Highlight Filter 對話方塊中新增了 Not Equals 和 Not Contains 運算子。
  • pylon Event Logger: [319441] 如果偵測到多個 properties 檔案，現在會顯示警告。
  • pylon Event Logger: [319892] 在 Capture 選單中新增了 Export Graph 命令。
  • pylon Event Logger: [319928] 在訊息檢視中捲動或使用其他導覽功能時，會停用 Autoscroll to End 選項。
  • pylon Event Logger: [319889] 在訊息檢視的捷徑功能表中新增了 Copy All 命令。
  • pylon Event Logger: [319439] 更新了導覽檢視中的圖示。

修正#

  • GigE: [329078] 修復了 FrameRetention 參數無法如預期運作的問題。如果影像傳輸超過 300 毫秒，您需要增加 FrameRetention 參數值。否則，影像擷取將會失敗，並回報緩衝區不完整。
  • GigE: [329076] 修復了重新發送要求產生不正確的問題。此項已包含在 pylon GEV Driver 5.5.0.1290 版本中。
  • GigE: [316669] 驅動程式不再將 BlockID64 資料轉換為 BlockID16 資料。
  • pylon Viewer: [322017] 修復了當這些窗格存在且已停駐時，CTRL+C 捷徑會隨時複製直方圖 / Line Profile 資料的問題。
  • pylon Viewer: [321363] 修復了擷取黑暗影像時發生的 CPU 高負載問題。
  • pylon Viewer: [305905] 更新了 Firmware Updater 的圖示。
  • pylon Viewer: [319360] 修復了啟用 Sharpness Indicator 時無法移動 Line Profile 功能線條的錯誤。
  • vTools: [324010,323143,323161] 更新了 PatternMatching vTools 節點對應表中的某些參數名稱、工具提示和說明。
  • vTools: [314793] 修復了校正 basic 中的無效來源處理。
  • vTools: [314945] 在 Image Morphology Starter vTool 中，Median Filter 的 Width 和 Height 參數現在已連結。
  • pylon C++ SDK: [316618] 修復了關閉 pylon 時 EltAppender 中潛在的死結。
  • pylon C++ SDK: [321363] 提供修復以避免從已解壓縮的擷取酬載取得壓縮資訊。
  • DirectShow: [320992] DirectShow 驅動程式現在支援 CoaXPress 相機。
  • Twain: [320992] Twain 驅動程式現在支援 CoaXPress 相機。
  • CXP IC: [318735] 更正了 biColor 插補的右邊緣像素插補。
  • CXP IC: [318735] 更正了觸發參數的 MCF 檔案儲存。
  • pylon Event Logger: [329848] 透過 pylon Event Logger 啟動時，主控台應用程式現在會顯示。
  • pylon Event Logger: [321046] 修復了啟動 pylon Event Logger 時未建立 properties 檔案的問題。
  • pylon Event Logger: [321028] 修復了一些路徑處理問題。
  • pylon Event Logger: [321207] 當 pylon Event Logger 正在擷取訊息時，設定 (Settings) 對話方塊現已無法使用。
  • pylon Event Logger: [320195] 當 pylon Event Logger 的狀態為「擷取中」(Capturing) 或「已清除」(Cleared) 時，已停用導覽檢視中的搜尋功能。
  • pylon Event Logger: [319933] 已停用「啟動並啟動記錄來源」(Start and Launch Logging Source) 選項，直到主動處理序完成或產生錯誤為止。
  • pylon Event Logger: [319120] 修復了從主動篩選器建立篩選器群組時，導致通知檢視中顯示錯誤的問題。
  • pylon Event Logger: [319516] 清除工作階段時，現在將會刪除工作階段目錄。
  • pylon Event Logger: [319446] 當關閉 pylon Event Logger 且訊息檢視中有未儲存的資料時，系統會顯示警告，允許使用者儲存資料。
  • pylon Event Logger: [315944] 修復了深色模式下通知的文字顏色。
  • pylon Event Logger: [315370] 修復了開啟和儲存對話方塊的預設目錄。現在會使用使用者的根目錄。

限制#

  • vTools: 如果您將 CodeMeter 從 8.20a 降級至 7.4x，CmActLicense 容器將不再運作。在這種情況下，您需要刪除該容器並建立一個新容器。
  • 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 相機擷取的影像暫時無法顯示。
  • Workbench：在 Workbench 中使用多個主動顯示資料的接腳資料檢視，可能會導致 CPU 負載增加並降低整體效能。Basler 建議盡可能減少使用接腳資料檢視。
  • Workbench：Workbench 的 Statistics 功能可用於量測 vTools 的執行時間。Statistics 功能所量測的時間可能會因系統組態與整體 CPU 負載而有所不同。這是因為 CPU 可能會根據當前負載以不同的頻率執行（例如，由於動態頻率 Scaling）。
  • pylon C SDK：pylon C API 尚未提供便於使用 GenDC 和 Basler blaze 3D 相機的函式。
  • pylon C SDK：為了使用 GenTL Consumer (例如搭配 CoaXPress)，pylon C 中新增了額外的功能，以便能夠明確地啟動和停止串流。此功能尚未記錄在 pylon C 工程師指南中。請參閱 pylon C++ 工程師指南 (請參閱「從先前的版本移轉 - 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);
  • GigE： 如果回報了錯誤訊息 "Failed to allocate resources."，Basler 建議使用 pylon GigE Configurator 工具來最佳化 NIC 和相機的 IP 設定。
  • GigE: IP Configurator 工具未完整支援單一網路介面上的多個 IP 設定。
  • pylon C++ SDK: InstantCameraArray 類別最多可從 21 台相機擷取影像。
  • GigE: 為了最佳化使用 Basler ace 2 5GigE 與 1GigE 相機，Basler 建議使用雙通道 DDR4-3600 RAM 或更高規格。使用較慢的 RAM 可能會導致緩衝區不足和影像遺失。此外，Basler 建議使用 pylon GigE Configurator 工具來最佳化整體設定。
  • GenTL: 對於 GenTL 版本 1.4 及更舊版本的 Producer，GenTL 支援有限。
  • USB： 由於 Basler U3V 裝置可能會發生不同步的情況，因此必須關閉 Intel USB 主控制器所使用的電源管理功能。若發生此情況，在某些情況下，系統開機後可能無法使用 Basler U3V 裝置。請透過下列步驟停用 USB3 匯流排上的 LPM 套件：
    1. 執行以下指令以啟用進階設定：
      powercfg -attributes 2a737441-1930-4402-8d77-b2bebba308a3 d4e98f31-5ffe- 4ce1-be31-1b38b384c009 -ATTRIB_HIDE
    2. 變更電源選項中的 LPM 設定。
      1. 開啟控制台中的「電源選項」。
      2. 按一下所選電源計畫的「變更計畫設定」。
      3. 按一下「變更進階電源設定」。
      4. 在「電源選項」對話方塊的「進階設定」索引標籤上，選取「USB 設定」。
      5. 將「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 網站下載。
  • 3D：使用 Stereo ace 3D 相機需要安裝 pylon Supplementary Package for Stereo ace。pylon Supplementary Package for Stereo ace 可從 Basler 網站下載。
  • GenTL/GigE：GigE Vision 的 GenTL Producer 不支援動作指令。
  • GenTL/GigE：GigE Vision 的 GenTL Producer 不支援多點傳送組態。
  • 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 偵錯工具選項中啟用「受管理的相容性」模式。
  • CXP IC: 對於線形掃描小程式 (Applet)，行週期與行曝光的範圍無法正確處理。最大值可能會小於預期值。
  • GenTL/CXP: 現在是使用 Visual Studio 2022 進行編譯，這表示必須安裝 Visual Studio 2022 可轉散發套件才能載入程式庫。
  • GenTL/CXP: 實際緩衝區大小限制為 2 Gbit，這因此對生產者中的 Width 和 Height 允許值施加了限制，並導致影像的最大大小為 2GB。
  • GenTL/CXP: fps 限制從 50.000 fps 到 90.000 fps 不等，具體取決於緩衝區數量和影像大小。若要取得更詳細的近似值，10 個緩衝區且最小影像大小為 48x1 的限制約為 50,000 FPS，50 個緩衝區且最小影像大小為 48x1 的限制約為 90,000 FPS，而 50 個緩衝區且影像大小為 8192x1 的限制則約為 50,000 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: 在 Linux 中使用安全開機 (UEFI 模式) 需要使用受信任憑證簽署的驅動程式。由於驅動程式是以原始程式碼形式提供，因此無法使用受信任的 Basler 憑證進行簽署。若要使用此驅動程式，可以停用安全開機。或者，也可以按照此 Ubuntu 部落格文章中的說明對驅動程式進行自我簽署：https://ubuntu.com/blog/how-to-sign-things-for- secure-boot
  • 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 Software Suite