pylon Software Suite 26.10 版本資訊#

發布日期：2026-10-27

二進位相容性#

Data Processing = 6.0.0
使用舊版本 Data Processing 建立的應用程式將無法相容。
pylon C SDK = 10.1.0
使用 10.1.x 或早期 10.x.x 版本 pylon C SDK 建置的應用程式相容。
pylon .NET SDK = 9.0.0
使用早期版本 pylon .NET SDK 建置的應用程式不相容。

新功能 / 變更#

vTools：[360948] 新增了 Pattern OCR vTool。若要使用此 vTool，必須安裝 pylon AI 的 pylon Supplementary Package 1.6.1 或更高版本。
GigE：[369750] 新增了 AutoFrameRetention 參數。啟用後，它會根據當前幀率自動計算 FrameRetention 值，並包含固定的安全邊際。
GenTL/GigE：[369750] 新增了 AutoFrameRetention 參數。這會根據當前幀率自動計算 FrameRetention 值，並包含固定的安全邊際。
GigE：[347002] pylon GigE Configurator 現在會自動停用最佳化網路介面卡上的節能乙太網路 (EEE)，因為據觀察，在閒置期間由 EEE 引發的連線轉換會導致 GigE Vision 相機出現連線和傳輸錯誤。在 Windows 上，當工具結束時會恢復原始設定。驅動程式未提供 EEE 控制的介面卡將被默默略過。
GigE：[335939] 針對 Windows 上的多相機 GigE 設定更新了 pylon GigE Configurator。已實作應用程式備忘錄 AW00194001000 中的所有建議。
GigE：[371519] 將 pylon GigE Filter Driver 更新至版本 5.7.0.1310。該驅動程式現在包含 GenDC 支援。
pylon .NET SDK：[369354] 新增了 IDataContainer.GetFirstImageDataComponent() 與 TryGetFirstImageDataComponent()，以便從 (GenDC) 資料容器中擷取第一個符合的影像資料元件。
pylon .NET SDK：[369354] 新增了透過 IDataComponent.AsPixelDataView() 與新的 DataSize Property 對像素資料進行零複製存取的功能。
pylon .NET SDK：[369354] 更新了所有擷取範例，透過 IDataContainer/IDataComponent 讀取影像資料，以便它們能與支援 GenDC 的相機以及傳統擷取結果正確協同運作。
Data Processing：[370224] 擴充了 BuildersRecipe::SaveAs，允許控制設定資料的詳細層級。
pylon Event Logger：[366731] 現在可以在啟動擷取工作階段後變更訊息檢視中顯示的最大訊息數量。為此，必須先暫停工作階段。
Workbench：[371341] 新增了 pylon Lean Runtime Recipe 選項。這允許在 Workbench 中僅儲存執行階段操作所需的資訊來儲存配方。
vTools：[369524] 新增了 pylon Lean Runtime Recipe 選項。這允許在 Workbench 中僅儲存執行階段操作所需的資訊來儲存配方。包含 Matching Basic、Matching Pro 或 Calibration vTools 的 Lean Runtime Recipes 不具備向下相容性。
PylonVToolCreatorRuntime：[370222] 新增了 Settings::GetDetailLevel() 以判定配方儲存詳細層級。

修正#

GigE：[368428] 修復了 GigE Vision 封包重新傳送問題，以便當一個接收批次包含多個間隙時，仍會要求接收對應表中尚存的所有遺失封包範圍。
GigE: [335939] 已修正 Windows DHCP 狀態變更並拒絕不支援的 RSS CPU 計數。在具備多個處理器群組的系統上，RSS 配置現在會使用支援群組中的邏輯處理器。
GigE: [335939] 已修正 pylon GigE Configurator 的 –dry-run 選項。它不再需要管理員或 root 權限。在 Linux 與 macOS 上，它也不再開啟系統檔案進行寫入，且最佳化系統設定時發生的失敗現在會反映在結束代碼中。
pylon Viewer: [369747] 修正了導致無法正確編輯使用者定義 Property 標籤的問題。
pylon Viewer: [369748] 修正了重新連接相機後串流按鈕狀態不正確的問題。Start、Stop 與 Single Shot 按鈕現在能正確反映相機目前的擷取狀態。
pylon Viewer: [360865] 改進了 Firmware Updater 的韌體相容性檢查。這使得針對無法存取的相機、無效的更新檔案以及不相容的韌體，能產生更清晰的錯誤訊息。相容性現在會在開啟更新選擇頁面時自動檢查，也可以手動再次檢查。
pylon Viewer: [369409] 改進了 Flat-Field Correction 的相機相容性偵測與初始化。衝突的 HDR 設定現在會針對區塊式校正自動停用，且初始化錯誤的回報也會更為清晰。
pylon Viewer: [368551] 修正了一個可能導致應用程式在 Bandwidth Manager 中執行分析時停止回應的問題。輸送量更新不再會觸發對封包間延遲的非預期變更。
pylon Viewer: [371680] 修正了 pylon Viewer 所記錄的影像計數顯示結尾百分比符號的問題。
Workbench: [350603] 修正了 Pin Data View 下拉選單在點擊之前顯示不正確的啟用/停用 Pin 的問題。

限制#

pylon Viewer：Stereo ace 2 相機擷取的影像暫時無法顯示。
pylon Viewer：在配備 Intel HD 顯示卡的電腦上，可能需要將顯示卡驅動程式更新至最新版本。
pylon Viewer：在某些情況下 (例如電腦非常慢或忙碌)，如果相機已經在 pylon Viewer 中開啟，Color Calibrator 可能無法運作。為防止這種情況發生，請在使用 Color Calibrator 之前關閉相機。
pylon Viewer：Color Calibrator 不支援所有 Basler 彩色相機。由於相機功能集不同，因此不支援 Basler dart 和 boost V 相機。
pylon Viewer：pylon Viewer 中已實作新的影像節流功能，以改善整體穩定性和效能。這引進了一項影響 pylon Viewer 影片錄製功能的新限制。在影像處理管線中，每個相機每秒僅允許 250 張影像，當超過此限制時，將限制錄製每張畫面的能力。
Workbench：Workbench 的 Statistics 功能可用於量測 vTools 的執行時間。Statistics 功能所量測的時間可能會因系統組態與整體 CPU 負載而有所不同。這是因為 CPU 可能會根據當前負載以不同的頻率執行（例如，由於動態頻率 Scaling）。
Workbench：在 Workbench 中使用多個主動顯示資料的接腳資料檢視，可能會導致 CPU 負載增加並降低整體效能。Basler 建議盡可能減少使用接腳資料檢視。
3D：使用 Stereo ace 3D 相機需要安裝 pylon Supplementary Package for Stereo ace。pylon Supplementary Package for Stereo ace 可從 Basler 網站下載。
3D：使用 Basler blaze 3D 相機需要安裝 pylon Supplementary Package for blaze。pylon Supplementary Package for blaze 可從 Basler 網站下載。
3D：使用 Stereo mini 3D 相機需要安裝 pylon Supplementary Package for Stereo mini。pylon Supplementary Package for Stereo mini 可於 Basler 網站上下載。
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 功能，然後再開始錄製。
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」。
GenTL: 對於 GenTL 版本 1.4 及更舊版本的 Producer，GenTL 支援有限。
GigE: 為了最佳化使用 Basler ace 2 5GigE 與 1GigE 相機，Basler 建議使用雙通道 DDR4-3600 RAM 或更高規格。使用較慢的 RAM 可能會導致緩衝區不足和影像遺失。此外，Basler 建議使用 pylon GigE Configurator 工具來最佳化整體設定。
GigE: IP Configurator 工具未完整支援單一網路介面上的多個 IP 設定。
GigE： 如果回報了錯誤訊息 "Failed to allocate resources."，Basler 建議使用 pylon GigE Configurator 工具來最佳化 NIC 和相機的 IP 設定。
pylon C++ SDK： 某些 ace 2 相機可能會使用布林參數代替常用的列舉來進行事件通知。可以使用以下程式碼片段來繞過此問題。對於 C++，除了 camera.EventNotification.TrySetValue(EventNotification_On); 之外，您還可以使用：CBooleanParameter(camera.GetNodeMap(), "EventNotification").TrySetValue(true);
pylon C++ SDK： 使用 Visual Studio 2017 時，您可能會收到 MSB4211 警告。若要移除此警告，請在 Release 和 Debug 專案屬性中指定 Windows SDK 的版本（Configuration Properties -> General -> Windows SDK Version）。
pylon C++ SDK： 使用 CMake 建置範例時，您可能會遇到作業系統的路徑長度限制。您可能會收到建置錯誤，指出路徑超過 260 個字元的最大路徑長度。如果您的 CMake 建置目錄的絕對路徑超過 80 個字元，就可能會發生這種情況。建置目錄是當前工作目錄或您呼叫 cmake 時由 '-B' 選項指定的目錄。如果您遇到此錯誤，請使用路徑較短且不超過 80 個字元的建置目錄，例如直接在您的使用者個人資料 C:\Users\ 中\Samples。您可以在 Windows 10 版本 1607 及更新版本上啟用長路徑。請參閱 Microsoft 文件以取得更多資訊。
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 .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 偵錯工具選項中啟用「受管理的相容性」模式。
vTools: 如果配方包含 Color Classifier vTool 以及一或多個 Region vTools（Region Morphology、Region Selection、Region Feature Extraction），系統會列出 Blob Analysis Basic 授權以及 Color Blob Analysis Basic 授權供購買。
vTools: 如果配方包含 Measurements Basic vTool 以及一或多個 Measurements Pro vTools，系統會列出 Measurements Basic 授權以及 Measurements Pro 授權供購買。
GigE: 使用 Nebula Matrix SmartNIC 驅動程式時，不支援搭配 Extended ID 進行串流。影像將會損毀。

下載#

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