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

pylon Software Suite 26.09 發行說明#

發行日期：2026-10-01

二進位相容性#

  • Data Processing = 5.1.0
    使用較早版本 Data Processing 建立的應用程式不相容。
  • pylon C++ SDK = 12.0.0
    使用 12.0.x 或較早 12.x.x 版本 pylon C++ SDK 建立的應用程式皆相容。
  • pylon C SDK = 10.1.0
    使用 10.1.x 或早期 10.x.x 版本 pylon C SDK 建置的應用程式相容。
  • pylon .NET SDK = 9.0.0
    使用早期版本 pylon .NET SDK 建置的應用程式不相容。

新功能 / 變更#

  • GenTL/GigE: [368940] 資料串流節點對應表中新增了「Auto Packet Size」與「Probe Packet Size」功能，可與 pylon GigE 傳輸層相符。
  • GenTL/GigE: [368940] 裝置節點對應表中新增了「Heartbeat Timeout」功能，允許在執行階段檢查與變更控制通道心跳逾時。
  • GenTL/USB: [369125] 一般安全性改進
  • pylon .NET SDK: [369125] pylon .NET 組件與範例現在將目標指向 .NET Framework 4.7.2，而非 .NET Framework 4.0。使用 pylon .NET API 的應用程式必須將目標指向 .NET Framework 4.7.2 或更新版本。
  • Camera Emulation: [362356] 在 pylon Camera Emulator 串流擷取器中新增區塊 ID 產生功能。
  • Camera Emulation: [362356] 在 pylon Camera Emulator 傳輸層中新增事件擷取器支援，支援 ExposureEnd 與 Test 事件。旨在用於測試與開發目的。
  • pylon C++ SDK: [362356] 在 CInstantCamera 類別中新增 API 擴充功能，以便更妥善地控制相機事件擷取，包括在獨立執行緒中擷取事件以及透過回呼函式接收事件的能力。
  • pylon C++ SDK: [367973] 新增基於 Sobel 濾波的新 GPU 影像處理範例：適用於所有平台的 Vulkan 範例，以及適用於 Windows 和 Linux 的 CUDA 範例。
  • General: [356845] 新增 Python pypylon 範例以及包含 pypylon 入門指引的 README。
  • pylon .NET 5+ SDK: [366344] 改進 GrabResult 中的 GenDC 支援，使影像資料存取行為與先前版本保持一致。
  • pylon .NET 5+ SDK: [369354] 新增 IDataContainer.GetFirstImageDataComponent() 與 TryGetFirstImageDataComponent()，以便從 (GenDC) 資料容器中擷取第一個相符的影像資料元件。
  • pylon .NET 5+ SDK: [369354] 新增透過 IDataComponent.AsSpan()/AsReadOnlySpan() 對像素資料進行零複製存取的功能，以及新的 DataSize Property。
  • pylon .NET 5+ SDK: [369354] 更新所有擷取範例，透過 IDataContainer/IDataComponent 讀取影像資料，以便其能與啟用 GenDC 的相機以及傳統擷取結果正確配合運作。
  • vTools: [368419] 當選擇自訂校正板時，Calibration Basic 與 Calibration Pro vTools 現在接受副檔名為 .cpd 的 HALCON 校正板描述檔案。
  • vTools: [367744] 在 Geometric Pattern Matching Basic、Geometric Pattern Matching Pro 與 Template Matching Basic vTools 的節點對應表中新增 ReferencePointManual、ReferencePointRow 與 ReferencePointColumn 參數，允許透過節點對應表手動定義參考點。
  • vTools: [369588] 將 Painter vTool 從 vTools 窗格中的「Experimental」移至「Supporters」。
  • vTools: [361368] 在 Image Stitcher vTool 中，Padding Value 的數值範圍現在為 0 到 255。對於 16 位元影像，指定的數值會自動調整（乘以 257 的倍數因子）。
  • vTools: [362361] 將 Image Stitcher vTool 更名為 Image Concatenation vTool。

修正#

  • GenTL/GigE: [368940] 修復了使用後釋放 (use-after-free) 當機問題，並更正了緩衝區識別，使其在擷取已完成的擷取緩衝區時不再依賴提交順序。
  • GenTL/GigE: [368940] 修復了裝置探索功能，使主機不在同一子網路上的相機也能被重新找到，這與 pylon GigE 傳輸層的行為一致。
  • GenTL/GigE: [368940] 修復了串流抓取器選擇器節點的 'Type' 回報空白/未對應值而非實際使用之驅動程式（例如 macOS 上的 GigE Accelerator）的問題。
  • GigE: [370746] 提高了 GigE 相機自動封包大小協商的可靠性。僅嘗試相機支援的封包大小。如果協商失敗，將正確恢復串流通道和封包大小。
  • GigE: [368940] 修復了控制通道指令逾時在第一次嘗試時（以及當 LinkCommandRetryCount 設定為 0 時的唯一嘗試）被無預警限制為 200 ms 的問題，無論組態設定的 LinkCommandTimeout 為何。
  • pylon C++ SDK: [362356] 修復了 CCameraEventHandler::OnCameraEvent 的說明文件，該文件先前錯誤地聲稱它是在相機鎖定之外被呼叫；事實上它一直都是在相機鎖定之內被呼叫。
  • pylon .NET 5+ SDK: [364409] 修復了使用 PixelDataConverter 類別時發生的記憶體流失問題。
  • pylon .NET 5+ SDK: [369354] 修復了數個生存期與執行緒安全問題：原生物件包裝函式上的使用後釋放/重複釋放、IRawParameter.ReadRaw 中的越界原生記憶體存取/WriteRawGrabResult.Clone() 進行共用而非複製狀態、FileAdapterStream.Write 中流失的 GCHandle、失效的重複檔案代勞保護、AviVideoWriter.Dispose 未釋放原生寫入器，以及 Interface/VideoWriter 上缺少終結器，導致 PylonLibrary 參考計數流失。
  • pylon .NET 5+ SDK: [369354] 修復了原生陣列配置/擁有權處理機制，使跨互通性邊界傳回的原生 C++ 陣列能夠被正確釋放，從而避免流失和重複釋放。
  • pylon Viewer: [370057] 修復了相機功能的「取得說明」連結未能正確將使用者重新導向至 Basler 產品說明文件中對應功能主題的問題。
  • pylon Viewer: [368631] 修復了 USB 組態工具中的「修正驅動程式安裝」連結不必要地重新安裝 pylon USB3 Vision 驅動程式的問題。現在，它會透過以提升的權限重新啟動 USB 組態工具並自動重新關聯正確的驅動程式，將已安裝的 pylon USB3 Vision 驅動程式重新繫結至 Basler USB3 Vision 裝置。
  • pylon Viewer: [368882] 修復了啟用圖磚模式時，「裝置」樹狀結構中的相機選擇意外變更的問題。
  • vTools: [368685] Geometric Pattern Matching Basic 與 Template Matching Basic vTools 中從 Positions_px 連接埠輸出之相對座標現在會四捨五入至整數像素。
  • vTools: [289634] 修復了所有 Measurements Basic 與 Pro vTools 中使用 InverseTf 輸入資料時的錯誤座標處理。在此之前，區域未被正確轉換。現在，它們會被轉換為原始輸入影像座標。
  • vTools: [363246] 在 Array Element Iterator vTool 中，StartIndex 與 EndIndex 參數現在只有在 IterationMode 參數設定為 Range 時才可用。
  • vTools: [289634] 更新了配方以正確套用 InverseTf，這是跟進 Measurement Basic 與 Pro vTools 中修正後的座標處理機制。

限制#

  • 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 工具來最佳化整體設定。
  • 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 文件以取得更多資訊。
  • 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 授權供購買。

下載#

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