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

pylon Software Suite 26.05 發行版本資訊#

發行日期：2026-05-20

二進位相容性#

  • Data Processing = 5.0.0
    使用早期版本 Data Processing 建構的應用程式不相容。
  • pylon C++ SDK = 12.0.0
    使用 pylon C++ SDK 12.0.x 或更早的 12.x.x 版本建立的應用程式皆相容。
  • pylon C SDK = 10.1.0
    使用 pylon C SDK 10.1.x 或更早的 10.x.x 版本建立的應用程式皆相容。
  • 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 位元影像現在會在載入和儲存時，在小端序記憶體配置與大端序 PNG 儲存格式之間正確轉換。
  • GenTL/CXP： [334172] 相機的「壽命終止」(end of life) 訊息會在偵測到斷線時立即記錄，以便重複使用相機的記錄 ID 於新連接的相機。若在斷線後仍使用代碼 (handle)，系統會建立新的記錄內容，以便將記錄訊息與相機建立關聯，同時明確指出它已不再是作用中的相機。
  • GenTL/CXP： [357284] 在修復此問題之前，HAP 檔案可能會在啟動期間被錯誤回報為具有無效授權。此問題已修復。現在，授權驗證僅在擷取卡設定完成後才會進行，可避免產生錯誤的授權訊息。
  • GenTL/CXP： [358938] 移除 GenTL 生產器中不必要的限制，該限制先前將小程式整數特徵的最大值和步進值限制為 2^31-1 (INT32_MAX)。
  • GenTL/CXP： [355660] 在 1.3.1 版本中，無意間移除了針對無號整數特徵的小程式最大值自動限制。因此，大於 2^63-1 (INT64_MAX) 的值會被 GenApi 解釋為負數，導致最大值顯示得比最小值還小，並引發範圍檢查失敗。自動限制功能現已恢復。套用該限制時，系統會記錄警告以使該行為可見。
  • GenTL/CXP： [353866] 修復從 Windows WNDPROC 訊息處理函式中呼叫 Fg_FreeGrabber(…) 時可能發生的潛在死結 (deadlock)。
  • 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 且套用位移時，兩張影像之間的間隙未被 Fill 的問題。

限制#

  • pylon Viewer:由Stereo ace 抓取的圖片，其中 2 張目前無法顯示。
  • pylon Viewer:若電腦配備 Intel HD 顯示卡，可能需要將顯示卡驅動程式更新至最新版本。
  • pylon Viewer:在某些情況下（例如電腦運行極為緩慢或負載過重），若相機已在「pylon Viewer 」中開啟，色彩校正工具可能無法運作。為避免此情況，請在使用色彩校正工具前先關閉相機。
  • pylon Viewer: Color Calibrator 不支援所有 Basler 彩色相機。由於相機功能集不同，因此不支援 Basler dart 與 boost V 相機。
  • pylon Viewer: pylon Viewer 中已實作新的影像限流器，以提升整體穩定性與效能。這帶來了一項影響 pylon Viewer 影片錄製功能的新限制。當成像管線中每秒每台相機僅允許 250 張影像時，若超出此限制，將無法錄製每一個畫格。
  • Workbench: Workbench 的 Statistics 功能可用於測量 vTool 的執行時間。Statistics 功能所測得的時間可能會因您的系統組態與整體 CPU 負載而有所不同。這是因為 CPU 可能會根據當前的負載以不同的頻率運行（例如，由於動態 Scaling）。
  • Workbench: 在 Workbench 中使用多個主動顯示資料的 pin data views 可能會增加 CPU 負載並降低整體效能. Basler 建議盡可能減少使用 pin data views.
  • 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 相機中的 Compression Beyond 功能。當開始錄製且啟用 Compression Beyond 功能時，pylon Viewer 會先停用相機中的 Compression Beyond 功能，然後再開始錄製。
  • 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 連結電源管理」設為「關閉」。
  • 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 相機可能會使用布林值參數而非通常的列舉來進行 event notifications。可以使用以下程式碼片段來解決此問題。對於 C++，除了：camera.EventNotification.TrySetValue(EventNotification_On); 之外，您還可以使用：CBooleanParameter(camera.GetNodeMap(), "EventNotification").TrySetValue(true);。
  • pylon C++ SDK: 使用 Visual Studio 2017 時，您可能會收到 MSB4211 警告。若要移除此警告，請在 Release 和 Debug 專案屬性中指定 Windows SDK 的版本（組態屬性 -> 一般 -> Windows SDK 版本）。
  • 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()函式 GCCloseLib() 後不久呼叫 GCInitLib() 。(3) 對 GenTL Producer 呼叫
  • GenTL/CXP: 現在使用 Visual Studio 2022 進行編譯，因此必須安裝 Visual Studio 2022 可轉散發套件才能載入程式庫。
  • GenTL/CXP: 實際的緩衝區大小限制為 2 Gbit，這因此對 Producer 中 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-Producer 而產生問題，應由 pylon 或 Framegrabber SDK 負責操作 Basler 擷取卡及/或介面卡。
  • GenTL/CXP: 在 Linux 中使用安全開機 (UEFI 模式) 需要使用受信任憑證簽署的驅動程式。由於驅動程式是以原始程式碼的形式提供，因此無法使用受信任的 Basler 憑證來簽署。若要使用此驅動程式，可以停用安全開機。或者，也可以按照此 Ubuntu 部落格文章中所述對驅動程式進行自我簽署：https://ubuntu.com/blog/how-to-sign-things-for-secure-boot
  • GenTL/CXP: 配置用於擷取的緩衝區時，緩衝區位址必須對齊 8 位元組的倍數。如果您使用堆積記憶體，則會自動符合此條件。
  • 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:可透過 DSGetButtonInfo 查詢的 GenTL BUFFER_INFO_FRAME_ID 不包含來自 CXP 影像標頭的來源標籤。相反地，它包含傳送至電腦的所有幀的 Counter。
  • 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（Direct Memory Access）或更高規格的主機介面。使用較慢的主機介面可能會降低相機的 Acquisition Frame Rate 並導致影像遺失。
  • CXP12-IC-1C:當頻繁變更某個連接埠上的 CXP 連結速度時，可能會發生速度變更失效的情況。在這種情況下，會記錄「Failed to set bitrate of uplink transceivers」和「Failed to set bitrate of downlink 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。