pylon Software Suite 8.0.0 发行说明#
二进制兼容性#
- Data Processing = 3.0.1
使用 Data Processing 3.0.x 或更早 3.x.x 版本构建的应用保持兼容。 - pylon C SDK = 9.0.0
使用早期版本 pylon C SDK 构建的应用不兼容。 - pylon C++ SDK = 9.0.0
使用早期版本 pylon C++ SDK 构建的应用不兼容。 - pylon .NET SDK = 1.2.0
使用 pylon .NET SDK 1.2.x 或更早版本构建的应用保持兼容。
新功能 / 变更#
- 常规: [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 - 实例分割
- pylon Viewer: [314565] 在“工具”菜单中添加了 pylon Event Logger 作为外部工具。
- pylon Viewer: [311582] 自动图像调整 (Automatic Image Adjustment) 功能现在可在 dart M 相机上使用。
- pylon Viewer: [313572] 现在可以通过上下文菜单关闭窗格。
- pylon Viewer: [308989] 在“新功能”和“了解更多”对话框中添加了 AI 主题。
- pylon Viewer: [305588] 现在可以通过图像窗口的上下文菜单将 Line Profile 重置回其初始位置。
- pylon Viewer: [297026] 为 Line Profile 窗格添加了上下文菜单。
- Workbench: [308021] 引脚数据视图对显示的第一个图像应用“缩放以适应” (Zoom to Fit)。
- Workbench: [308968] 引脚数据视图中的“缩放以适应” (Zoom to Fit) 功能现在可以无缝缩放。
- Workbench: [308991] 在“欢迎”对话框的“许可证”选项卡上,添加了针对 AI vTools 的链接。在 Workbench 菜单中,已添加一个用于 pylon AI agent 的条目。
- CXP IC: [298766] 添加了 BoardStatus 部分,其中包含提供有关板卡状态信息的 Property。
- CXP IC: [298766] 添加了 Errors 部分,其中包含提供有关错误信息的 Property。
- 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 和事件。
- pylon C SDK: [298881] 现在为 pylon C 接口提供了一个独立的 CMake 查找器 (pylonC)。pylon C 内容已从现有的 pylon CMake 查找器中移除。
- 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 查找器中移除。现在为 pylon C 提供了一个独立的 CMake 查找器。
- pylon C++ SDK: [304030] 添加了新的 log4cpp 日志追加器,以支持新的 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 中,可以添加输出 pin 以输出相机 chunk 数据。
- vTools: [285171] 在 Camera vTool 中,可以添加输出 pin 以输出相机事件数据。
- vTools: [275698] Image Loading vTool 现在支持在配方 (recipe) 中使用图像源文件夹的相对路径。
修正#
- pylon Viewer: [285047] 当 Color Calibrator 未能成功完成第二步时,Continuous Shot 复选框保持选中状态。
- pylon Viewer: [312899] 修复了使用彩色图像时的直方图平移问题。
- 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 被错误地添加为 pin 数据视图数据源的问题。
- Workbench: [312967] 修复了加载没有 vTools 的配方时导致错误的问题。
- Workbench: [311609] 修复了在存在已分配的 Camera vTool 的情况下关闭 pylon Viewer 时可能导致其崩溃的问题。
- Workbench: [299047] 修复了一些有关 pin data view 的显示问题,包括 RGB 信息以及停止配方后的全屏模式。
- Workbench: [307585] 修复了可能导致 pin data view 中的文本显示不正确的问题。
- CXP:[304411] - “已修复:在此问题修复之前,applet 事件 Timestamp 不正确。它们被除以 2。此问题现已修复。现在,applet 事件 Timestamp 具有正确的值。”
- Data Processing:[312880] 修复了一个问题:当随后创建的引脚名称以第一个引脚的名称开头时,无法重命名输入和输出端子引脚。
- Data Processing:[309051] 更改了 GenericOutputObserver.h 中的嵌套命名空间定义,以使其与其他头文件保持一致。
- Camera Link:[307793] 在 pylon 运行时中添加了缺失的 Basler_CameraLink.zip,其中包含所需的 XML 文件。
- GigE:[314339] 修复了使用 Socket Driver 并结合 Compression Beyond 时出现的编码数据溢出错误。pylon GEV Driver Version 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 的文档。
- vTools:[301657] 改进了对 Calibration Basic 和 Pro vTools 中手动机器标定的支持。
- vTools:[305510] 更新了 Template Matching Basic vTool 的对话框外观。
- vTools:[306903] 在 Gray value Transformer Starter vTool 中,参数名称已更新。
限制#
- 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 显卡的计算机上,可能需要将显卡驱动程序更新到当前版本。
- Workbench:在 Workbench 中使用多个主动显示数据的引脚数据视图可能会导致 CPU 负载增加以及整体性能下降。Basler 建议尽可能少使用引脚数据视图。
- Workbench:Workbench 的 Statistics 功能可测量 vTools 的执行时间。Statistics 功能中测量的可能会根据您的系统配置和整体 CPU 负载而有所不同。这是因为 CPU 可能会根据当前负载以不同的频率运行(例如由于动态频率 Scaling)。
- CXP IC:对于线扫描 applets,行周期和行曝光的范围未得到正确处理。最大值可能低于预期。
- 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 软件包:
- 通过执行以下命令启用高级设置:
powercfg -attributes 2a737441-1930-4402-8d77-b2bebba308a3 d4e98f31-5ffe- 4ce1-be31-1b38b384c009 -ATTRIB_HIDE - 更改电源选项中的 LPM 设置。
- 打开控制面板中的“电源选项”。
- 单击所选电源计划的“更改计划设置”。
- 单击“更改高级电源设置”。
- 在“电源选项”对话框的“高级设置”选项卡上,选择“USB 设置”。
- 将“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 网站上下载。
- Direct Show:DirectShow 驱动程序不支持 CoaXPress 相机。
- Twain:Twain 驱动程序不支持 CoaXPress 相机。
- pylon AI Agent:在某些分辨率和 Scaling 设置下,按钮可能不可见。
下载#
您可以此处下载此版本的 pylon Software Suite。