pylon Software Suite 8.0.0 發行版本說明#

發行日期：2024-09-24

二進位相容性#

Data Processing = 3.0.1
使用 3.0.x 或較早 3.x.x 版本的 Data Processing 建置的應用程式相容。
pylon C SDK = 9.0.0
使用舊版本 pylon C SDK 建置的應用程式不相容。
pylon C++ SDK = 9.0.0
使用舊版本 pylon C++ SDK 建置的應用程式不相容。
pylon .NET SDK = 1.2.0
使用 1.2.x 或舊版本 pylon .NET SDK 建置的應用程式相容。

新功能 / 變更#

一般： [311182] 遵循語意化版本 2.0 (Semantic Versioning 2.0)，pylon SDK 程式庫名稱現在僅標註主要版本號，不再標註次要版本號。
pylon AI Agent： [286592] pylon AI Agent 用於將模型部署至 AI vTools。您可以選擇透過 pylon AI Platform 或從儲存空間部署模型。模型可以部署在本機或遠端電腦上。
vTools： [286272, 286412, 285715, 285681] 新增了以下 vTools：- Object Detection - 分類 - Semantic Segmentation - Instance Segmentation
pylon Viewer： [314565] 在「工具」(Tools) 選單中新增 pylon Event Logger 作為外部工具。
pylon Viewer： [311582] Automatic Image Adjustment 功能現已適用於 dart M 相機。
pylon Viewer： [313572] 現在可以透過內容選單關閉窗格。
pylon Viewer： [308989] 在「新功能」(New Features) 和「暸解詳情」(Learn More) 對話方塊中新增了 AI 主題。
pylon Viewer： [305588] 現在可以透過影像視窗的內容選單將 Line Profile 重設回其初始位置。
pylon Viewer： [297026] 為 Line Profile 窗格新增了內容選單。
Workbench： [308021] 引腳資料檢視會對顯示的第一張影像套用「縮放至最適大小」(Zoom to Fit)。
Workbench： [308968] 引腳資料檢視中的「縮放至最適大小」(Zoom to Fit) 功能現在可進行平滑縮放。
Workbench： [308991] 在「歡迎」(Welcome) 對話方塊的「授權」(Licensing) 標籤頁上，新增了 AI vTools 的連結。在 Workbench 選單中，已新增 pylon AI agent 的項目。
CXP IC： [298766] 新增了 BoardStatus 區段，其中包含提供板卡狀態相關資訊的功能。
CXP IC： [298766] 新增了 Errors 區段，其中包含提供錯誤相關資訊的功能。
CXP IC： [298766] 新增了 CameraStatus 事件，以提供關於傳輸至擷取卡過程中遺失的遺失畫格資訊。
CXP IC： [298766] 將 CorrectedErrorCount 更名為 CameraCorrectedErrorCount。
CXP IC： [298766] 將 UncorrectedErrorCount 更名為 CameraUncorrectedErrorCount。
CXP IC： [306774] 解決了與 Opto-Coupled Trigger 5 板卡的通訊問題。
CXP IC： [220218] 修復了狀態運算子中的不正確數值，這些數值曾導致 CXP 狀態和連接埠狀態發生問題。
CXP IC： [303278] CustomSignalEvent0 和 CustomSignalEvent1 現在允許使用 FrontGPI2 和 FrontGPI3 作為來源。
Data Processing: [289432]透過最佳化資料類型的內部處理，提升了效能。
Data Processing: [274754]已變更 CRegion::GetBuffer() 的行為以實作寫時複製（copy-on-write）。
Data Processing: [300937] 新增範例，示範如何從 Camera vTool 接收 chunk 與 event。
pylon C SDK: [298881] pylon C 介面現在擁有獨立的 CMake finder (pylonC)。pylon C 內容已從現有的 pylon CMake finder 中移除。
pylon C++ SDK: [296692] 新增範例，示範如何使用 racer 2 線性掃描相機的 shading correction 功能。
pylon C++ SDK: [314002] CBaslerUniversalInstantCamera 類別已更新。
pylon C++ SDK: [303027] GrabResult 物件現在新增了一個成員，並且擴充了 CPylonDataComponent 以支援多部分（multipart）資料元件。
pylon C++ SDK: [298881] pylon C 內容已從 pylon CMake finder 中移除。現在為 pylon C 提供獨立的 CMake finder。
pylon C++ SDK: [304030] 新增 log4cpp logappender 以支援新的 Basler 日誌系統 ELT。
pylon C++ SDK: [303896,303897] 改進了日誌記錄功能以支援 pylon Event Logger，特別是針對 GenTL 與 CXP。
vTools: [307646] 新增更多校正板尺寸：800 mm、1200 mm、1600 mm 以及 2400 mm
vTools: [309025] 在 Image Loading vTool 中新增了儲存影像來源資料夾絕對路徑的選項。
vTools: [285172] 在 Camera vTool 中，可以新增輸出接腳（output pin）來輸出相機 chunk 資料。
vTools: [285171] 在 Camera vTool 中，可以新增輸出接腳（output pin）來輸出相機 event 資料。
vTools: [275698] Image Loading vTool 現在支援在配方（recipe）中使用指向影像來源資料夾的相對路徑。

修正#

pylon Viewer: [285047] 當 Color Calibrator 未能成功完成第二個步驟時，Continuous Shot 核取方塊將保持勾選狀態。
pylon Viewer: [312899] 修復了使用彩色影像時的 Histogram 平移問題。
pylon Viewer: [312817] 修復了 Line Profile 窗格中 Y 軸標籤的對齊問題。
pylon Viewer: [308356] 延長執行韌體更新後重新搜尋相機的等候時間。
pylon Viewer: [290732] 改進超出 Static Defect Pixel Correction 限制時的錯誤訊息。
pylon Viewer: [307521] 線性掃描相機現在在使用單張拍攝（single shot）功能時將使用正確的擷取模式。
pylon Viewer: [304190] 修復導致影像視窗頁籤標題中的文字與按鈕重疊的問題。
Workbench: [291903] 修復導致 vTools 的輸入接腳被錯誤新增為接腳資料檢視（pin data view）資料來源的問題。
Workbench: [312967] 修復載入不含 vTools 的配方時導致錯誤的問題。
Workbench: [311609] 修復在配置有 Camera vTool 的情況下關閉 pylon Viewer 時可能導致其當機的問題。
Workbench: [299047] 修復了一些與接腳資料檢視相關的顯示問題，包括 RGB 資訊以及停止配方後的全螢幕模式。
Workbench: [307585] 修復可能導致接腳資料檢視中的文字顯示不正確的問題。
CXP: [304411] - 「已修正：在修正此問題之前，applet 事件 Timestamp 不正確，它們被除以 2。此問題現已修正。現在，applet 事件 Timestamp 具有正確的值。」
Data Processing: [312880] 修正了一個問題：當後續建立的 pin 名稱以第一個 pin 的名稱開頭時，會無法重新命名輸入和輸出端點 pin。
Data Processing: [309051] 變更了 GenericOutputObserver.h 中的巢狀命名空間定義，以使其與其他標頭檔一致。
Camera Link: [307793] 新增了缺失的 Basler_CameraLink.zip（包含必要的 XML 檔案）至 pylon 執行階段。
GigE: [314339] 修正了使用 Socket Driver 並搭配 Compression Beyond 時發生的編碼資料外溢錯誤。此問題也在 pylon GEV Driver 5.4.1.1260 版本中得到修正。
Twain: [308082] 修正了 TWAIN 驅動程式載入時發生凍結的問題。
vTools: [314717, 314714, 314713, 314707, 314716, 314724, 314710, 314709] 更新了使用 Transformation Data 的 vTools 的錯誤處理機制。
vTools: [314724] 在 vTools 文件中取得協助時，OCR vTool 會開啟正確的文件頁面。
vTools: [305245] 在 Calibration Basic/Pro vTools 中，如果啟用了作業系統的畫面 Scaling 功能，影像座標的圖形顯示將會正確。
vTools: [303977] 修正了 Template Matching Basic vTool 中旋轉角度的對話方塊文字。
vTools: [311250] 移除了過時的 node map 項目，並更新了 Document Cropper vTool 的 vTool 文件。
vTools: [301657] 改進了 Calibration Basic 和 Pro vTools 對手動機器校準的支援。
vTools: [305510] 更新了 Template Matching Basic vTool 的對話方塊外觀。
vTools: [306903] 在 Gray value Transformer Starter vTool 中，已更新參數名稱。

限制#

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

下載#

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