pylon Software Suite 26.05 發行版本資訊#

發行日期：2026-05-20

二進位相容性#

Data Processing = 5.0.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 建置的應用程式不相容。

新功能 / 變更#

vTools: [360573] 新增授權檔案，讓您可以建立 CodeMeter 授權容器（例如用於 vTool 授權）。
vTools: [355504] 新增 Free-Form OCR vTool。
pylon C++ SDK: [360807] 從所有 Configuration Event 處理常式中移除自動停用 GenDC 模式的功能。
pylon C++ SDK: [358101] 擴充 pylon C++ SDK，將擷取結果統一視為元件容器。受影響的 API：範例程式碼、CGrabResultData::GetFirstImageDataComponent、CGrabResultPtr::operator IImage&、CPylonImage::AttachGrabResultBuffer、CPylonDataContainer::GetFirstImageDataComponent 以及 CPylonDataComponent::GetComponentIndex。從 CGrabResultPtr 物件取得的資料元件現在會保留對底層擷取結果的參考，可防止緩衝區被重新用於擷取。
pylon C++ SDK: [265373] 移除已棄用的 include/pylon/gige 標頭檔。如果您的應用程式碼依賴這些檔案，您必須更新程式碼並改用 BaslerUniversalInstantCamera。
pylon C++ SDK: [265377] 移除舊的僅限 USB 標頭檔。請改用 BaslerUniversalCamera。
pylon C SDK: [359063] 縮短錯誤訊息中的檔案路徑，使其僅包含 pylon 根路徑。
GenTL/CXP: [357830] 將 zlib 從 1.3.1 版本更新至 1.3.2 版本。
pylon .NET 5+ SDK: [361223] 新增對 Stereo mini 相機的支援。
Workbench: [356499] 改進了輸入終端上資料產生接腳的視覺化與預設佇列行為。
vTools: [360288] 新增 Array Element Iterator vTool。
vTools: [355564] 新增 Array Creator vTool。

修正#

pylon C++ SDK: [360569] 修復了載入具備索引色彩（色盤）或位元深度低於 8 的 PNG 影像時的問題。
pylon C++ SDK: [358812] 修復了 PNG 影像持久化實作中的多個問題。Gray+Alpha 影像現在能正確載入為 Mono8 或 Mono16，同時捨棄 alpha 通道。BGR8packed 與 BGRA8packed 影像現在會以 PNG 規格所要求的標準 R、G、B(A) 通道順序儲存。16 位元影像現在於載入和儲存時，皆能在小到大端（little-endian）記憶體配置與大端（big-endian）PNG 儲存格式之間進行正確轉換。
GenTL/CXP: [334172] 一旦偵測到中斷連線，就會記錄相機的「使用壽命終止」訊息，以便將相機的記錄 ID 重新用於新連接的相機。如果在中斷連線後仍繼續使用控制代碼，將建立新的記錄內容，以便記錄訊息仍可與相機關聯，同時明確指出它已不再是作用中的相機。
GenTL/CXP: [357284] 在修復此問題之前，HAP 檔案可能會在啟動期間被錯誤回報為具有無效授權。此問題已修復。現在，授權驗證僅在設定畫面擷取卡之後進行，從而防止出現錯誤的授權錯誤。
GenTL/CXP: [358938] 移除 GenTL Producer 中的一項不必要限制，該限制將小程式整數特徵的最大值和步進值限制為 2^31-1 (INT32_MAX)。
GenTL/CXP: [355660] 在 1.3.1 版本中，無意間移除了無符號整數特徵的小程式最大值自動限制。因此，大於 2^63-1 (INT64_MAX) 的值被 GenApi 解釋為負數，導致最大值小於最小值並引發範圍檢查失敗。自動限制現已恢復。套用此限制時，將記錄一項警告以使該行為可見。
GenTL/CXP: [353866] 修復了從 Windows WNDPROC 訊息處理函式內部呼叫 Fg_FreeGrabber(…) 時可能發生的潛在死結。
GenTL/CXP: [357288] 修復了小程式迭代器回報 HAP 檔案的相機總數不正確的問題。
pylon .NET 5+ SDK: [347205] 修復了包含底線的 pylon 參數（例如 Statistic_Total_Buffer_Count）無法存取的問題。
pylon Viewer: [335478] 改進「檔案存取」對話方塊中的錯誤訊息。
pylon IP Configurator： [344809] 改進了 IP Configurator 中相機子網遮罩不匹配警告的可見性。
pylon Viewer： [356459] 修復了在 Feature Properties 和 vTool Documentation 標籤頁之間切換時，所選特徵可能會丟失的問題。
pylon Viewer： [358556] 修復了在單張和連續拍攝模式下無法放大和縮小畫面的問題。
pylon Viewer： [350977] 修復了 Get Help 連結會打開說明文件首頁而不是正確主題的問題。
pylon Viewer： [359221] 修復了在生成另一個 FFC 集時，預覽可能會導致 FFC 係數不正確的問題。
pylon Viewer： [349528] 更新了多個圖標以符合新的圖標設計。
pylon Viewer： [306300] 修復了針對黑白相機打開 Color Calibrator 後影像擷取可能會停止且無法重新啟動的問題。
pylon Viewer： [361441] 在尚未找到相機的裝置列舉期間，於 Devices 窗格中新增了忙碌指示器。
Workbench： [354845] 改進了過期演示授權訊息的設計，使其符合 UI/UX 指南。
vTools： [362054] 修復了當強制性接腳未連接到 Array Creator vTool 時的錯誤處理。
vTools： [362049] 更新了 Array Element Iterator vTool 關於來自不同更新之輸入同步的說明文件。
vTools： [361349] 修復了 Image Stitcher vTool 中的一個問題：當 PaddingValue 設定為 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 建議盡可能減少使用接腳資料檢視。
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 文件以取得更多資訊。
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 偵錯工具選項中啟用「受管理的相容性」模式。
CXP12-IC-1C: 對於線掃描 applet，行週期與行曝光範圍無法獲得正確處理。最大值可能低於預期。
GenTL/CXP： 當 SDK 設定為連線至 pylon Event Logger時，如果在初始化後直接關閉記錄功能，可能會發生死結。常見的情境包括 (1) 呼叫 Fg_FreeLibraries() 在不久之後 Fg_InitLibraries()。(2) 呼叫 Fg_... 函數，且未使用 Fg_InitLibraries() 和 Fg_FreeLibraries()進行明確的生命週期管理。(3) 呼叫 GCCloseLib() 在不久之後 GCInitLib() 進行明確的生命週期管理的情況下運作的函數。
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: 如果您的電腦同時安裝了 pylon 與 Framegrabber SDK，Basler 建議在 pylon 安裝過程中取消勾選 CXP 選項。為避免競爭 CXP-producers 所導致的問題，應由 pylon 或 Framegrabber SDK 其中之一來負責操作 Basler 擷取卡及/或介面卡。
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（直接記憶體存取）或更高規格的主機介面。使用較慢的主機介面可能會降低相機的擷取影格速率並導致影像遺失。
CXP12-IC-1C: 當頻繁變更某個連接埠上的 CXP 鏈結速度時，可能會發生速度變更失效的情況。在此情況下，系統會記錄「Failed to set bitrate of uplink transceivers」與「Failed to set bitrate of downregulation transceivers」等錯誤訊息。由於相機搜尋會探測未連線的連接埠並因此變更其鏈結速度，因此當應用程式頻繁嘗試在未連線的連接埠上搜尋新相機時，可能會發生此問題。
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。