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

pylon Software Suite 25.10 發行說明#

發行日期：2025年10月23日

二進位相容性#

  • pylon C++ SDK = 11.2.0
    使用 11.2.x 或早期 11.x.x 版本 pylon C++ SDK 建置的應用程式具備相容性。
  • pylon .NET SDK = 9.0.0
    使用較早版本的 pylon .NET SDK 所建置的應用程式將無法相容。
  • pylon C SDK = 10.1.0
    使用 pylon C SDK 10.1.x 或更早的 10.x.x 版本建立的應用程式皆相容。
  • Data Processing = 3.5.2
    使用 3.5.x 或早期 3.x.x 版本 Data Processing 建置的應用程式具備相容性。

新功能 / 變更#

  • 資料處理：[342495] 更新了 pylon 資料處理 C++ API 範例，改為使用 pylon 和 pylonDataProcessing 套件所提供的 CMake 配置檔案，而非自訂的 finder。
  • 資料處理：[342495] 新增了 CMake 配置檔案，以簡化將 pylon 資料處理 C++ API 整合至基於 CMake 的專案的流程。
  • 資料處理：[345966] 針對 SPointF2D、SCircleF、SEllipseF、SLineF2D、SRectangleF 及 CTransformationData 這幾種資料型別，實作了比較方法與運算子。
  • 資料處理：[317523] 為 CRecipe 類別新增了執行時間測量資料（CSV 格式），並在 CUpdate 類別中實作了一個用於擷取執行時間的方法。
  • 資料處理：[346791] 已實作將 CGrabResultPtr（含影像或 GenCP 有效載荷）直接放入 CVariant 的支援功能，以提升 CInstantCamera 與配方之間的互通性。
  • GenTL/GigE：[347265] 修正了 EventGetDataInfo 中的問題，該問題導致 EVENT_DATA_ID 被錯誤地以非字串格式傳回。此修正確保事件識別的一致性，使其始終以字串格式傳回 EVENT_DATA_ID。
  • GenTL/GigE：[348365] 修正了當有效載荷類型非「Image」時，BUFFER_INFO_DELIVERED_CHUNKPAYLOAD_SIZE 未正確設定的問題。
  • GenTL/GigE：[344914] 適用於 GigE Vision 的「GenTL Producer 」現已可配置相機設定以支援多播串流。
  • GenTL/USB：[347265] 修正了 EventGetDataInfo 中的問題，該問題導致 EVENT_DATA_ID 被錯誤地以非字串格式傳回。此修正確保了事件識別的一致性，使其始終以字串形式傳回 EVENT_DATA_ID。
  • GigE：[341766] Marvell AQtion 網路介面卡Windows 驅動程式已更新為新版 3.1.10.0。
  • pylon C SDK：[348880] 已在 include\pylonc 目錄中新增 PylonCVersion.h 標頭檔，以便在 pylon C 中查詢版本號。
  • pylon C++ SDK：[345142] 為確保各版本間的一致性，已將巨集 PYLON_6_0_NO_DEPRECATE 替換為 PYLON_NO_DEPRECATE。已移除標頭檔 api_autoconf.h。所有先前對 api_autoconf.h 的包含，現在都應替換為 Platform.h。
  • pylon C++ SDK：[341515] 修正了一個問題，該問題是因 pylon 標頭檔的包含順序不正確，導致意外連結到除錯函式庫。
  • pylon C++ SDK：[343776] 修正了 Video Writer 類別中的一個問題，該問題會導致當影像寬度不是 64 像素的倍數時，畫面底部邊緣出現視覺瑕疵。
  • pylon C++ SDK：[342031] CBaslerUniversalInstantCamera 類別已更新。
  • pylon C++ SDK：[304977] 將GenICam 更新至 3.5.0 版。
  • Workbench:[345137] 若某個 vTool 沒有專屬的設定對話方塊，現在雙擊該 vTool 將在對話方塊中開啟「功能窗格」。

修正#

  • PylonVToolCreatorRuntime：[336505] 修正了將 IArray 作為輸入類型時會觸發例外狀況的問題。
  • 資料處理：[345946] 修正了 SmartInstantCamera.h 與 PylonDataProcessingIncludes.h 之間的循環包含依賴關係。
  • vTools：[344949] 可繼續使用包含功能流的現有配方。請注意，使用這些更新後的 vTools 所建立的配方，與舊版 pylon 並不相容。此修正係因GenICam 版本 3.5 的更新所引發。
  • pylon Viewer:[345748] 修正了一個問題：先前使用者必須先點擊「單張拍攝」按鈕兩次，才能讓「儲存圖片」按鈕變得可用。
  • pylon Viewer:[346268] 修正了一個問題：使用「錄製」功能所建立的圖片，在某些圖片瀏覽器中開啟時，會比在「pylon Viewer 」中檢視時顯得更暗。
  • pylon Viewer:[346656] 修正了「銳利度指示器」在開啟後無法立即生效的問題。
  • pylon C++ SDK：[348540] 將 zlib 更新至 1.3.1 版本，使該軟體免受 CVE-2023-45853 漏洞的影響。

限制#

  • pylon C++ SDK：如果您使用 GenICam File Access 功能從 GigE 相機下載檔案，且檔案大小無法被 4 整除，目前會下載大小為 0 位元組的檔案。這可能會導致問題，特別是包含使用者資料的校正與設定檔（例如 Vignetting Correction 資料、Shading Correction 資料、3D 資料）。
  • 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 的版本（組態屬性 -> 一般 -> Windows SDK 版本）。
  • pylon C++ SDK: 部分 ace 2 相機可能會使用布林值參數而非通常的列舉來進行 event notifications。可以使用以下程式碼片段來解決此問題。對於 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 設定。
  • pylon C++ SDK: InstantCameraArray 類別最多可以從 21 台相機擷取影像。
  • GigE: 為了發揮 Basler ace 2 5GigE 和 1GigE 相機的最佳效能，Basler 建議使用雙通道 DDR4-3600 RAM 或更高規格。使用較慢的 RAM 可能會導致緩衝區下溢並遺失影像。此外，Basler 建議使用 pylon GigE Configurator 工具來最佳化完整的設定。
  • GigE: 如果回報了錯誤訊息「Failed to allocate resources.」，Basler 建議使用 pylon GigE Configurator 工具來最佳化 NIC 和相機的 IP 設定。
  • GigE: IP Configurator 工具不完全支援單一網路介面上的多個 IP 設定。
  • GenTL: 對於 GenTL 版本 1.4 及更舊版本的 Producer，GenTL 支援有限。
  • USB: Intel USB 主控制器使用的電源管理必須關閉，否則 Basler U3V 裝置可能會發生不同步的情況。如果發生這種情況，在某些情況下，系統開機後可能無法使用 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 連結電源管理」設為「關閉」。
  • 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 相機中的 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 網站下載。
  • 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 偵錯工具選項中啟用「受管理的相容性」模式。
  • GenTL/GigE: GigE Vision 的 GenTL Producer 不支援動作指令。
  • 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 Viewer: pylon Viewer 中已實作新的影像限流器，以提升整體穩定性與效能。這帶來了一項影響 pylon Viewer 影片錄製功能的新限制。當成像管線中每秒每台相機僅允許 250 張影像時，若超出此限制，將無法錄製每一個畫格。
  • pylon Viewer: Color Calibrator 不支援所有 Basler 彩色相機。由於相機功能集不同，因此不支援 Basler dart 與 boost V 相機。
  • pylon Viewer:在某些情況下（例如電腦運行極為緩慢或負載過重），若相機已在「pylon Viewer 」中開啟，色彩校正工具可能無法運作。為避免此情況，請在使用色彩校正工具前先關閉相機。
  • pylon Viewer:若電腦配備 Intel HD 顯示卡，可能需要將顯示卡驅動程式更新至最新版本。
  • pylon Viewer:由Stereo ace 抓取的圖片，其中 2 張目前無法顯示。
  • Workbench: 在 Workbench 中使用多個主動顯示資料的 pin data views 可能會增加 CPU 負載並降低整體效能. Basler 建議盡可能減少使用 pin data views.
  • Workbench: Workbench 的 Statistics 功能可用於測量 vTool 的執行時間。Statistics 功能所測得的時間可能會因您的系統組態與整體 CPU 負載而有所不同。這是因為 CPU 可能會根據當前的負載以不同的頻率運行（例如，由於動態 Scaling）。
  • GenTL: 對於 GenTL 版本 1.4 及更舊版本的 Producer，GenTL 支援有限。

下載#

您可以在這裡下載此版本的 pylon Software Suite。