跳转到内容
STAGING SERVER
DEVELOPMENT SERVER

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 或更高版本。
  • 相机仿真：[362356] 为 pylon Camera Emulator 流采集器添加了块 ID 生成功能。
  • 相机仿真：[362356] 为 pylon Camera Emulator 传输层添加了事件采集器支持，支持 ExposureEnd 和 Test 事件。旨在用于测试和开发目的。
  • pylon C++ SDK：[362356] 为 CInstantCamera 类添加了 API 扩展，以便更好地控制相机事件采集，包括在单独线程中采集事件以及通过回调函数接收事件的能力。
  • pylon C++ SDK：[367973] 添加了基于 Sobel 滤波的新 GPU 图像处理示例：适用于所有平台的 Vulkan 示例以及适用于 Windows 和 Linux 的 CUDA 示例。
  • 常规：[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 毫秒的问题，而不考虑配置的 LinkCommandTimeout。
  • pylon C++ SDK: [362356] 修复了 CCameraEventHandler::OnCameraEvent 的文档，该文档错误地指出它是在相机锁外部调用的；实际上它一直都是在相机锁内部调用的。
  • pylon .NET 5+ SDK: [364409] 修复了使用 PixelDataConverter 类时发生的内存泄漏。
  • pylon .NET 5+ SDK: [369354] 修复了若干生命周期和线程安全问题：本机对象包装器上的释放后使用/双重释放、IRawParameter.ReadRaw 中的越界本机内存访问/WriteRaw，GrabResult.Clone() 共享状态而非复制，FileAdapterStream.Write 中泄漏的 GCHandle，失效的重复文件句柄保护，AviVideoWriter.Dispose 未释放本机写入器，以及 Interface/VideoWriter 上缺少终结器导致的 PylonLibrary 引用计数泄漏。
  • pylon .NET 5+ SDK: [369354] 修复了本机数组分配/所有权处理，使跨互操作边界返回的本机 C++ 数组能够被正确释放，从而避免泄漏和双重释放。
  • pylon Viewer: [370057] 修复了相机功能的“获取帮助”链接未能将用户正确重定向到 Basler Product Documentation 中相应功能主题的问题。
  • pylon Viewer: [368631] 修复了 USB Configurator 中的“修复驱动程序安装”链接不必要地重新安装 pylon USB3 Vision 驱动程序的问题。现在，它通过以提升的权限重新启动 USB Configurator 并自动重新关联正确的驱动程序，将已安装的 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 中实现了一种新的图像限流器 (image throttle)，以提高整体稳定性和性能。这引入了一项新限制，会影响 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：Recording 功能不支持 ace 2 Pro 相机中的 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 链接电源管理”设置为“关闭”。
  • 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 工具来优化网卡和相机的 IP 配置。
  • pylon C++ SDK：某些 ace 2 相机可能会使用布尔参数代替常规枚举来进行 Event Notification。可以使用以下代码片段来规避此问题。对于 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 已更改为 ref 类 Basler.Pylon.ParameterListEnum）。
  • pylon .NET SDK：如果为您的 .NET 项目启用了本地调试，且您的项目引用了 pylon 程序集，则在 Visual Studio 2012 或 Visual Studio 2013 调试器下运行应用程序时可能会崩溃。为避免此问题，请在 Visual Studio 调试器选项中启用托管兼容模式 (Managed Compatibility mode)。
  • 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。