Enhanced Applets (imaFlex CXP-12 Quad)#

本主题为您介绍 Enhanced Applets。Enhanced Applets 是一组面向 Basler CXP-12 采集卡和接口卡的全新开箱即用 Applets。

您可以从 Basler 网站以 ZIP 文件形式下载 Enhanced Applets、Flat-Field Correction 插件以及用于计算平场校正值的 Python 脚本。

目前，Enhanced Applets 适用于：

CXP-12 Interface Card 1C
CXP-12 接口卡 2C
CXP-12 接口卡 4C
imaWorx CXP-12 Quad
imaFlex CXP-12 Quad

Enhanced Applets 是 Acquisition Applets 与 Custom Applets 之间的纽带：Acquisition Applets 包含用于采集和预处理图像与信号数据以及处理系统信息的功能。

Enhanced Applets 包含了 Acquisition Applets 的功能范围以及更多高级图像处理功能。

Custom Applets 通过 VisualApplets 创建，可提供个性化功能。它们可以基于 Acquisition Applets 或 Enhanced Applets 的设计进行定制。

Acquisition Applets 和 Enhanced Applets 随受支持的采集卡和 CXP-12 接口卡一同提供。

适配与定制#

单一的 Applets 集合永远无法满足所有的客户需求。Enhanced Applets 的理念在于快速适应特定需求：

生成符合您需求的全新或修改版 Enhanced Applets
生成完全符合您需求但不会包含在通用版本中的自定义 Enhanced Applets。根据自定义处理的复杂程度，这可能仅适用于 imaFlex 采集卡。
在 VisualApplets 中复制功能块以实现高度灵活的自定义处理并自行完成实现。这适用于 imaFlex 采集卡。

VisualApplets 功能示例#

VisualApplets 随附了设计示例，您可以使用它们来计算基于块的平场校正。您可以在 VisualApplets 教程中找到有关这些示例及其存储位置的信息。

除了在 VisualApplets 中进行自定义处理之外，请查看调整与自定义部分中提到的自定义可能性。

要求#

主机软件：Framegrabber SDK 5.11.3 版以及 pylon Viewer 8.0.1 或 8.0.2 版。
硬件： 您的系统已连接以下采集卡或接口卡之一：
- CXP-12 Interface Card 1C
- CXP-12 接口卡 2C
- CXP-12 接口卡 4C
- imaWorx CXP-12 Quad
- imaFlex CXP-12 Quad

限制

在所有 applet 中，无法分配大于 4GB 的缓冲区。即使 applet 允许更大的缓冲区大小，由于驱动程序和固件的限制，您也无法分配大于 4GB 的缓冲区。

您可以按如下方式计算缓冲区大小：

Buffer size = image height * image width * (pixel width / 8).

对于 RGB 图像：buffer size = (image height * image width * (pixel width / 8)) * 3 .

文档#

以下部分提供了通往 Enhanced Applets 文档的链接：

面阵采集 Applets#

GenTL	Fglib
Enh_SingleCXP12Area	Enh_SingleCXP12Area
Enh_DualCXP12Area	Enh_DualCXP12Area
Enh_QuadCXP12Area	Enh_QuadCXP12Area

面阵采集 Applets#

目前，Enhanced Applets 适用于面阵相机。这些 applet 完美扩展了 boost v 相机的功能，可满足您的图像预处理需求。

提供以下面阵 Enhanced Applets：

Enh_SingleCXP12Area
Enh_DualCXP12Area
Enh_QuadCXP12Area

选择合适的面阵采集中转 Applet#

选择合适的 Enhanced Applet 仅取决于连接到采集卡的相机数量，而与链路配置无关。因此，选择正确 applet 的矩阵如下：

相机数量	小程序	拓扑
1	Enh_SingleCXP12Area
2	Enh_DualCXP12Area
4	Enh_QuadCXP12Area

有关 applet 的具体规格，请阅读applet 文档的“功能”章节。

与 Acquisition Applets 相比，Enhanced Applets 均具有以下附加功能：

高达 4x4 的 Binning
适用于单色和彩色相机的基于块的平场校正 (FFC)
PGI 高质量 Debayering 和图像质量提升

使用 Enhanced Applets#

将 Enhanced Applets 与 Framegrabber SDK 配合使用#

在此处查找关于将 applet 与 Framegrabber SDK 配合使用的一般信息：Acquisition Applets。

安装 Enhanced Applets#

在采集卡上使用特定的 applet 之前，需要将其安装到采集卡上。有关安装 applet 的说明，请访问管理 Applet (microDiagnostics)。

手动添加 Enhanced Applets#

要添加您收到的小程序，请执行以下操作： DLL 将文件（而非安装程序）复制到主机文件系统：

获取小程序DLL 您已收到的文件。
Copy this file into the following directory: <Framegrabber SDK installation directory>\Dll\<frame grabber model>
确保 GenTL 环境变量指向 Framegrabber SDK 安装目录。

现在，您可以在 microDisplay X、任何 GenTL 消费者端或使用 Framegrabber SDK API 编写您自己的 SDK 程序中使用这些新 Applets。

测试图像采集#

在您自己的软件（通过 API）中使用 applet 之前，您可能需要测试系统设置或单个 applet（及其参数化选项）。

为此，您可以借助作为 Framegrabber SDK 环境的一部分安装在主机上的 microDisplay X 工具。有关如何加载和测试 applet 的说明，请参阅 Configuring the Applet (microDisplay X)。

保存 Applet 配置#

配置完小程序后（在 microDisplay X 中或通过 Framegrabber API），您可以保存配置。有关更多信息，请参阅 Other Tasks (microDisplay X)。

将 Enhanced Applets 与 pylon Viewer 配合使用#

Enhanced Applets 作为 pylon Viewer 的插件提供。请联系 Basler 销售代表或现场应用工程师索取此插件。

安装 pylon 的 Enhanced Applets 插件#

您收到的 pylon 的 Enhanced Applets 插件为 DLL 文件。要安装 pylon 的 Enhanced Applets 插件：

Copy the DLL files into the pylon installation directory Runtime\x64\pylonCXP\dll\<frame grabber name>.
确保 GenTL 环境变量指向 pylon 安装目录。

现在，您可以在 microDisplay X、任何 GenTL 消费者端或使用 Framegrabber SDK API 编写您自己的 SDK 程序中使用这些新 Applets。