跳转到内容
STAGING SERVER
DEVELOPMENT SERVER

pylon Software Suite 8.1.0 发行说明#

发布日期：2025-03-14

二进制兼容性#

  • Data Processing = 3.0.1
    使用 Data Processing 3.0.x 或更早 3.x.x 版本构建的应用保持兼容。
  • pylon C SDK = 10.0.0
    使用早期版本 pylon C SDK 构建的应用程序不兼容。
  • pylon C++ SDK = 10.2.1
    使用早期版本 pylon C++ SDK 构建的应用程序不兼容。

新功能 / 变更#

  • pylon .NET 5+ SDK：新增了针对 Linux、Windows 和 macOS 利用 .NET 8.0 的语言绑定。
  • pylon C++ SDK：[322697] 修复了运行带有 .NET 应用程序的 EltAppender 时的问题。
  • pylon C++ SDK：[323481] CBaslerUniversalInstantCamera 类已更新。
  • pylon C++ SDK：[324026] 已向 GenICam 库添加版本后缀。
  • pylon C++ SDK：[324026] 添加了反向通道服务器，以允许对 Basler 日志系统（EltAppender / pylon Event Logger）进行运行时配置。
  • pylon C++ SDK：[316909] PylonGigEConfigurator：修复了 Windows 自动优化功能。它现在会重新设置优化值。
  • pylon C++ SDK：[321363] 改进了解压缩的错误处理以及文档。
  • pylon .NET SDK：[323481] 参数列表已更新。
  • CXP IC：[318735] 将双色插值系数更改为 -0.5 1 -05，以遵循相机的插值版本。
  • CXP IC：[318735] 移除了双色模式 GBGR 和 GRGB。
  • CXP IC：[318735] 扩展了 CameraStreamStatus 事件信息。
  • GenTL：[323605] GEV/blaze GenTL 枚举的 DeviceInfo 对象现在包含 IP 地址、MAC 地址、子网掩码、默认网关和设备制造商信息条目的正确值。
  • GenTL：[326394] 如果没有可用的 chunk，则不再获取 chunk 数据。
  • GenTL/CXP: [320807,323583,320739,320740,320738,323587] 关于日志的多项更改。
    • GenTL Producer 内部的顶级日志类别现在称为 FgSdk 而不是 FgSdk.
    • 对于接收到的每一个帧，附加信息（时间戳、有效载荷大小等）都会记录到日志类别中 FgSdk.GenTL.Acq。默认情况下，此类别设置为日志级别 FATAL ，因为它会对较高帧率的性能产生严重影响。将此类别的日志级别设置为 NOTICE 或更高将启用日志记录。
    • 引入了另一个日志类别 FgSdk.fglib.Acq ，其目的类似，但仅在使用 Frame Grabber SDK 直接时生效。对于 pylon 应用程序，该项应始终设置为 FATAL.
    • 要获取有关采集卡（或 applet）事件的信息，请使用新的日志类别 FgSdk.fglib.Events 已引入。由于事件的发生频率也可能非常高，每个采集卡事件都会被记录到类别 FgSdk.fglib.Events.<EventName> 其中 <EventName> 是该事件的实际名称。使用这些类别可以进行精细化的日志配置。请注意，必须由您的应用程序启用采集卡事件，才能生成和记录这些事件。
    • 用于检测 CXP 链路连接问题的附加日志消息。
  • vTools: 将 CodeMeter 升级到了 8.20a 版本。
  • vTools: [320336] 添加了 Anomaly Detection vTool。
  • vTools: [316670] 为 Classification vTool 添加了批处理（Batching）功能。批处理允许您同时处理多个感兴趣区域 (ROI)，从而提高处理速度。
  • vTools: [298566] 添加了 Multiplexer vTool。
  • vTools: [307044] 添加了 OPC UA Client vTool。
  • Data Processing: [275911] 改进了线程池实现，使其优先处理较早的图更新，并添加了线程优先级。
  • Data Processing: [319406] 添加了有关 CBuildersRecipe 以及如何通过 pylon Data Processing C++ API 使用配方压缩的信息。
  • Data Processing: [319578] 更新了示例查找器，使其与未来的 Basler 内部 GenICam 版本兼容。
  • Data Processing: [317568] 更新了示例查找器，使其与未来的 pylon 版本兼容。
  • Data Processing: [310128] 向 CBuildersRecipe 类添加了 SaveAs 方法，允许用户指定配方文件格式。
  • pylon Event Logger: [323553] 将 log4j.category.basler 更改为了 log4j.category.FgSdk。
  • pylon Event Logger: [321118] 添加了启动配置文件，用于配置已启动或正在运行的日志记录应用程序。
  • pylon Event Logger: [320249] 改进了消息视图中添加新日志消息的处理方式。过去在更新消息视图时会出现延迟，这意味着会有多条新消息同时添加。现在，新消息将逐条添加，从而带来更流畅的体验。
  • pylon Event Logger: [320856] 改进了状态名称、工具提示和其他用户界面文本。
  • pylon Event Logger: [320418] 修复了显示过滤器的性能问题。
  • pylon Event Logger: [320312] 现在可以导入和导出显示和高亮过滤器设置。
  • pylon Event Logger: [319932] 现在可以配置视图中的最大消息数量。
  • pylon Event Logger: [320428] 将活动视图中默认启用的日志级别更改为 WARN、ERROR 和 UNKNOWN。
  • pylon Event Logger: [319443] 在导航视图中添加了“滚动到末尾”按钮。
  • pylon Event Logger: [319447] 改进了消息视图中的滚动行为。
  • pylon Event Logger: [319890] 在“显示/高亮过滤器”对话框中添加了“不等于”和“不包含”运算符。
  • pylon Event Logger: [319441] 如果检测到多个 Property 文件，现在会显示警告。
  • pylon Event Logger: [319892] 在 Capture 菜单中添加了 Export Graph 命令。
  • pylon Event Logger: [319928] 在消息视图中进行滚动或使用其他导航功能会禁用 Autoscroll to End 选项。
  • pylon Event Logger: [319889] 在消息视图的上下文菜单中添加了 Copy All 命令。
  • pylon Event Logger: [319439] 更新了导航视图中的图标。

修正#

  • GigE: [329078] 修复了 FrameRetention 参数无法按预期工作的问题。如果图像传输超过 300 ms，则需要增大 FrameRetention 参数值。否则，图像采集将会失败，并报告缓冲区不完整。
  • GigE: [329076] 修复了重新发送请求生成不正确的问题。此修复包含在 pylon GEV Driver 5.5.0.1290 版本中。
  • GigE： [316669] 驱动程序不再将 BlockID64 数据转换（cast）为 BlockID16 数据。
  • pylon Viewer: [322017] 修复了当直方图或 Line Profile 窗格存在且处于停靠状态时，CTRL+C 快捷键总是复制这些数据的问题。
  • pylon Viewer: [321363] 修复了采集暗场图像时出现的 CPU 占用率过高的问题。
  • pylon Viewer: [305905] 更新了 Firmware Updater 的图标。
  • pylon Viewer: [319360] 修复了启用 Sharpness Indicator 时无法移动 Line Profile 功能线条的 Bug。
  • vTools: [324010,323143,323161] 更新了 PatternMatching vTools 节点映射中的部分参数名称、工具提示和描述。
  • vTools: [314793] 修复了 calibration basic 中无效源的处理。
  • vTools: [314945] 在 Image Morphology Starter vTool 中，Median Filter 的 Width 和 Height 参数现在已关联。
  • pylon C++ SDK: [316618] 修复了关闭 pylon 时 EltAppender 中潜在的死锁问题。
  • pylon C++ SDK: [321363] 提供了修复方案，以避免从已解压的采集有效负载中获取压缩信息。
  • DirectShow: [320992] DirectShow 驱动程序现在支持 CoaXPress 相机。
  • Twain: [320992] Twain 驱动程序现在支持 CoaXPress 相机。
  • CXP IC: [318735] 校正了 biColor 插值的右边缘像素插值。
  • CXP IC: [318735] 校正了触发参数的 MCF 文件保存。
  • pylon Event Logger: [329848] 通过 pylon Event Logger 启动时，控制台应用程序现在可见。
  • pylon Event Logger: [321046] 修复了启动 pylon Event Logger 时未创建 Property 文件的问题。
  • pylon Event Logger: [321028] 修复了一些路径处理问题。
  • pylon Event Logger: [321207] pylon Event Logger 正在捕获消息时，Settings 对话框现在不可用。
  • pylon Event Logger: [320195] 当 pylon Event Logger 的状态为 Capturing 或 Cleared 时，禁用导航视图中的搜索功能。
  • pylon Event Logger：[319933] 禁用了“Start and Launch Logging Source”选项，直至活动进程结束或报错。
  • pylon Event Logger：[319120] 修复了从活动筛选器创建筛选器组时，通知视图中显示错误的问题。
  • pylon Event Logger：[319516] 现在清除会话时将删除会话目录。
  • pylon Event Logger：[319446] 在消息视图中存有未保存的数据时关闭 pylon Event Logger，将显示一条警告，允许用户保存数据。
  • pylon Event Logger：[315944] 修复了深色模式下通知的文本颜色。
  • pylon Event Logger：[315370] 修复了打开和保存对话框的默认目录。现在将使用用户的根目录。

限制#

  • vTools：如果您将 CodeMeter 从 8.20a 降级至 7.4x，CmActLicense 容器将无法正常工作。在此情况下，您需要删除该容器并创建一个新容器。
  • pylon Viewer：pylon Viewer 中实现了一种新的图像限流器 (image throttle)，以提高整体稳定性和性能。这引入了一项新限制，会影响 pylon Viewer 的视频录制功能。成像管道中每秒仅允许每个相机传输 250 张图像，当超出此限制时，将无法录制每一帧。
  • pylon Viewer：Color Calibrator 不支持所有 Basler 彩色相机。由于相机功能集不同，不支持 Basler dart 和 boost V 相机。
  • pylon Viewer：在某些情况下（例如计算机非常慢或繁忙），如果相机已经在 pylon Viewer 中打开，Color Calibrator 可能无法工作。为防止出现这种情况，请在使用 Color Calibrator 之前关闭相机。
  • pylon Viewer：在配有 Intel HD 显卡的计算机上，可能需要将显卡驱动程序更新到当前版本。
  • pylon Viewer：Stereo ace 2 相机抓取的图像暂无法显示。
  • Workbench：在 Workbench 中使用多个主动显示数据的引脚数据视图可能会导致 CPU 负载增加以及整体性能下降。Basler 建议尽可能少使用引脚数据视图。
  • Workbench：Workbench 的 Statistics 功能可测量 vTools 的执行时间。Statistics 功能中测量的可能会根据您的系统配置和整体 CPU 负载而有所不同。这是因为 CPU 可能会根据当前负载以不同的频率运行（例如由于动态频率 Scaling）。
  • 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 相机可能会使用布尔参数代替常规枚举来进行 Event Notification。可以使用以下代码片段来规避此问题。对于 C++，除了 camera.EventNotification.TrySetValue(EventNotification_On); 之外，您还可以使用：CBooleanParameter(camera.GetNodeMap(), "EventNotification").TrySetValue(true);
  • GigE：如果报告了错误消息“Failed to allocate resources.”，Basler 建议使用 pylon GigE Configurator 工具来优化网卡和相机的 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 链接电源管理”设置为“关闭”。
  • 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 功能，然后开始录制。
  • 3D：使用 Basler blaze 3D 相机需要安装 pylon Supplementary Package for blaze。pylon Supplementary Package for blaze 可在 Basler 网站上下载。
  • 3D：使用 Stereo ace 3D 相机需要安装 pylon Supplementary Package for Stereo ace。pylon Supplementary Package for Stereo ace 可在 Basler 网站上下载。
  • GenTL/GigE：GigE Vision 的 GenTL producer 不支持动作命令 (action commands)。
  • GenTL/GigE：用于 GigE Vision 的 GenTL Producer 不支持多播配置。
  • 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)。
  • CXP IC：对于线扫描 Applet，行周期和行曝光的范围无法得到正确处理。最大值可能会低于预期。
  • 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：如果您的计算机上安装了某个版本的 Basler Framegrabber SDK，在使用 CoaXPress 相机和采集卡时可能会遇到兼容性问题。因此，Basler 建议不要将 pylon 与 Framegrabber SDK 并行安装。
  • 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：可通过 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（直接内存访问）或更高性能的主机接口。使用较慢的主机接口可能会降低相机的采集帧率并导致图像丢失。

下载#

您可以在此处下载此版本的 pylon Software Suite