pylon Software Suite 8.0.2 版本说明#

发布日期：2024-12-03

二进制兼容性#

Data Processing = 3.0.1
使用 Data Processing 3.0.x 或更早 3.x.x 版本构建的应用保持兼容。
pylon C SDK = 9.0.0
使用早期版本 pylon SDK 构建的应用程序不兼容。
pylon C++ SDK = 9.1.1
使用 9.1.x 或早期 9.x.x 版本 pylon C++ SDK 构建的应用程序兼容。
pylon .NET SDK = 1.2.0
使用 1.2.x 或早期 1.x.x 版本 pylon .NET SDK 构建的应用程序兼容。

新功能 / 变更#

通用： [313183] 增加了对 racer 2 线扫描彩色相机和 BiColor Pixel Format 的支持。
pylon Viewer： [297112] 在修改轮廓线的起点或终点时，鼠标指针附近的工具提示会显示该点的当前 X 和 Y 坐标。
pylon Viewer： [301476] 在图像显示区域的状态栏中增加了对 BiColor Pixel Format 的支持。
pylon Viewer： [301474] 在 Histogram 功能中增加了对 BiColor Pixel Format 的支持。
pylon Viewer： [301473] 在 Line Profile 功能中增加了对 BiColor Pixel Format 的支持。
pylon Viewer： [297670] 改进了行轮廓坐标轴刻度及标签的位置。
GenTL/CXP： [315154] 在 GenTL 中增加了对 BiColor 格式的支持。根据 Device XML 中“OutputPackedFormats”Property 的值，这些格式会自动转换为 BGR 紧凑或非紧凑格式
GenTL/CXP: [316516] 可以为正在进行的采集记录更多详细信息。由于某些消息（例如传入的帧）的生成频率与帧率相同，因此引入了一个新的日志类别 basler.GenTL.Acq 现已可用，用于开启或关闭这些消息。这些消息将在日志级别 NOTICE 或更高时可见。
pylon C++ SDK： [312362] 已更新 CBaslerUniversalInstantCamera 类。
pylon .NET SDK： [312362] 已更新 PLCamera 类。

修正#

pylon Viewer： [319153] 修复了若干失效链接。
pylon Viewer： [318731] 修复了 Features Pane 中的滑块在设置值时表现异常的问题。
GigE： [313183] GigE Configurator 现在可以正确配置多端口接口卡上未建立连接的接口。
GigE： [316669] 驱动程序不再将 BlockID64 数据转换（cast）为 BlockID16 数据。
Direct Show： [319213] 现在设置了链接依赖项的正确版本。
vTools： [318406,319650] Image Loading vTool 现在可以在包含 Unicode 字符的路径中加载和保存配方。

限制#

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 相机抓取的图像暂无法显示。
GenTL：对于 GenTL 1.4 及更低版本的 Producer，GenTL 支持有限。
GenTL/CXP：现在使用 Visual Studio 2022 进行编译，因此必须安装 Visual Studio 2022 运行库才能加载这些库
GenTL/CXP：实际的缓冲区大小限制为 2 Gbit，这反过来对 Producer 中的 Width 和 Height 的允许值施加了限制，从而导致最大图像大小为 2GB
GenTL/CXP：根据缓冲区数量和图像大小的不同，帧率限制在 50000 fps 到 90000 fps 之间。有关更详细的近似值，10 个缓冲区和 48x1 的最小图像大小的限制约为 50000 fps，50 个缓冲区和 48x1 的最小图像大小的限制约为 90000 fps，而 50 个缓冲区和 8192x1 的图像大小的限制约为 50000 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：在分配用于抓取的缓冲区时，缓冲区地址必须以 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 C SDK：pylon C API 尚不提供用于使用 GenDC 和 Basler blaze 3D 相机的便捷函数。
pylon C and C.NET 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);
pylon C++ SDK：InstantCameraArray 类最多可以从 21 台相机采集图像。
GigE：如果报告了错误消息“Failed to allocate resources.”，Basler 建议使用 pylon GigE Configurator 工具来优化网卡和相机的 IP 配置。
GigE：IP Configurator 工具并不完全支持单个网络接口上的多个 IP 配置。
GigE：为了以最佳状态使用 Basler 的 ace 2 5GigE 和 1GigE 相机，Basler 建议使用双通道 DDR4-3600 RAM 或更高规格的内存。使用较慢的 RAM 可能会导致缓冲区欠载和图像丢失。此外，Basler 建议使用 pylon GigE Configurator 工具来优化整个设置。
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 网站上下载。
Direct Show：DirectShow 驱动程序不支持 CoaXPress 相机。
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)。

下载#

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