pylon Software Suite 26.01 發行說明#

發行日期：2026-01-23

二進位相容性#

Data Processing = 4.1.1
使用 Data Processing 4.1.x 或更早 4.x.x 版本建置的應用程式具相容性。
pylon C++ SDK = 11.3.0
使用 pylon C++ SDK 11.3.x 或更早 11.x.x 版本建置的應用程式具相容性。
pylon C SDK = 10.1.0
使用 10.1.x 或早期 10.x.x 版本 pylon C SDK 建置的應用程式相容。
pylon .NET SDK = 9.0.0
使用早期版本 pylon .NET SDK 建置的應用程式不相容。

新功能 / 變更#

pylon Viewer：[351433] 改進了頻寬管理員（Bandwidth Manager）中的訊息。
pylon Viewer：[350780] 頻寬管理員（Bandwidth Manager）現在是一個無強制回應對話方塊（modeless dialog）。這允許直接在 pylon Viewer 中設定相機，而無需關閉頻寬管理員。因此，「設定相機」（Configure Cameras）按鈕（原本允許存取內嵌的特徵樹）已從頻寬管理員中移除。
pylon Viewer：[349776] 從所有應用程式的標題列中移除了「64 位元」。
Data Processing：[346991] 導入了公用程式方法，在使用 CVariant 和 CVariantContainer 類別時簡化資料的裝箱（boxing）與拆箱（unboxing）。
Data Processing：[319926] 新增了參數集合對影像與區域參數的支援。
vTools：[319926] 為下列 vTools 的節點對應表新增了新參數：Geometric Pattern Matching Basic、Geometric Pattern Matching Pro 以及 Template Matching Basic。這可讓使用者透過 pylon Data Processing C++ API 提供教學資料並存取教學結果。
vTools：[343109] 改進了 Calibration Pro vTool 在高解析度影像中對校正板的識別能力。
vTools：[292218] 帶來了顯著的效能提升與擴充功能。增強了 QR Code 與 GS1 Data Matrix 碼的解碼能力。QR Code Reader 已進一步最佳化，以提升速度與效率。此外，基帶形狀的匹配演算法也得到了改進，實現了更高的處理速度與更強的強固性
Workbench：[349292] 現在可以將相機指派給輸入終端機上的接腳。這可讓您在配方（recipe）中直接使用相機影像，而無需 Camera vTool。
vTools：[353917] 更新了代碼讀取函式庫。所有代碼讀取器 vTools 的 Starter 版本之檢測與效能均已獲得改善。
vTools：[353201] 新增 Painter vTool 作為實驗性功能。此 vTool 可能會有所變動，並在未來的版本中進行重大修改。Painter vTool 會將輸入資料繪製到影像上，例如區域、幾何形狀或文字。
vTools：[345795] Mini Script vTool 現已能處理影像與區域，提供對其 metadata 的存取，並支援從 input pins 到 output pins 的路由。
vTools：[353199] 新增 Data Writer vTool 作為實驗性功能。此 vTool 可能會有所變動，並在未來的版本中進行重大修改。Data Writer vTool 允許您記錄配方中的處理過程。您可以將配方中的所有結果儲存為各種格式（包括文字、影像或影片），以便進行封存或偵錯。此外，還提供多個可設定的觸發器，以指定何時擷取特定事件。
vTools：[340058] Camera vTool 現已支援 GenDC 擷取結果。當有單一類似影像的資料元件可用時，它會直接傳遞至 Image pin。對於包含多個元件的影像容器，會優先選用 Intensity 元件。
pylon C++ SDK：[336167] 在 GrabResult 中引入了 GetDataComponent，以擷取給定類型的所有元件。當啟用 GenDC 時，此功能可用。
pylon C++ SDK：[347316] 對於 GenDC 等基於容器的格式，GrabResult 緩衝區現在包含第一個強度影像，從而確保與現有 GrabResult 使用模式的相容性。
GenTL/GigE：[352009] 新增對 UseExtendedIdIfAvailable 功能的支援，以便在可用時啟用擴充 ID 使用。
pylon C SDK：[352237] 更正了程式範例的 include.props 檔案。在修正之前，它列出了 pylonC 函式庫的偵錯版本。

修正#

pylon Viewer：[349376] 修正了當游標移至「裝置」窗格中已開啟的相機上時，鍵盤導覽停止運作的問題。
pylon Viewer：[347274] 修正了頻寬管理員（Bandwidth Manager）可能會對可用有「DeviceLinkThroughputLimit」參數的 GigE 相機進行錯誤設定的問題。
pylon Viewer：[349678] 修正了當存在「DeviceLinkThroughputLimit」特徵時，頻寬管理員（Bandwidth Manager）可能會對 GigE 相機進行錯誤設定的問題。
Data Processing：[323172] 修正了如果使用相對路徑載入函式庫時，尋找 vTools 與簽章檔案的問題。
vTools：[345736] 提高了 Template Matching Starter vTool 的穩定性以及 AlignmentTf 資料的準確性。為了確保穩定可靠的效能，已移除對匹配旋轉模板的支援。請注意，使用此 vTool 建立的 recipe 與舊版本的 pylon 不相容。同樣地，使用先前 pylon 版本建立的 recipe 也與此 vTool 版本不相容。
vTools：[352227] 修復了雙擊 Histogram Extractor 與 Multiplexer vTools 時的不正確行為。現在不會開啟空白對話方塊，而是會顯示該 vTool 沒有可設定設定的訊息。
pylon C++ SDK：[352735] 解決了 StreamGrabber nodemap 中的 UseExtendedIdIfAvailable 功能始終被覆寫，導致無法在 pylon Viewer 等工具中使用的問題。現在可以設定該功能而不會被重設，從而確保各個應用程式之間的一致行為。
pylon C++ SDK：[349506] 修正了透過 GenICam File Access 從 GigE 相機下載檔案時，若檔案大小無法被 4 整除，會被儲存為 0 位元組的問題。
GenTL/GigE：[350406] 修復了當緩衝區大小小於所需緩衝區大小時，EventGetData 函式未傳回 GC_ERR_BUFFER_TOO_SMALL 的問題。
GenTL/GigE：[347257] 修復了擷取結果的 BlockID 未針對未完整擷取的影像進行設定的問題。
GenTL/GigE：[349506] 修正了透過 GenICam File Access 從 GigE 相機下載檔案時，若檔案大小無法被 4 整除，會被儲存為 0 位元組的問題。

限制#

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 建議盡可能減少使用接腳資料檢視。
pylon C++ SDK：若您使用 GenICam File Access 功能從 GigE 相機下載檔案，且檔案大小無法被 4 整除，目前會下載大小為 0 位元組的檔案。這可能會引發問題，特別是針對包含 Memory 等使用者資料的校正與設定檔案（例如 Vignetting Correction 資料、Shading Correction 資料、3D 資料）。
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 網站下載。
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 工具來最佳化整體設定。
pylon C++ SDK: InstantCameraArray 類別最多可從 21 台相機擷取影像。
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 文件以取得更多資訊。
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 .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。