Enhanced Applets#

本主题向您介绍 Enhanced Applets。Enhanced Applets 是一套适用于 Basler CXP-12 采集卡和 Interface Cards 的全新即用型 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 Interface Cards 一起提供。

调整与定制#

要在单一的 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 的缓冲区。

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

缓冲区大小 = 图像高度 * 图像宽度 * (像素位宽 / 8)。

对于 RGB 图像：缓冲区大小 = (图像高度 * 图像宽度 * (像素位宽 / 8)) * 3。

文档#

以下各节提供了指向 Enhanced Applets 文档的链接：

CXP-12 Interface Card 1C#

GenTL	Fglib
Enh_SingleCXP12Area	Enh_SingleCXP12Area

CXP-12 接口卡 2C#

GenTL	Fglib
Enh_SingleCXP12Area	Enh_SingleCXP12Area
Enh_DualCXP12Area	Enh_DualCXP12Area

CXP-12 接口卡 4C#

GenTL	Fglib
Enh_SingleCXP12Area	Enh_SingleCXP12Area
Enh_DualCXP12Area	Enh_DualCXP12Area
Enh_QuadCXP12Area	Enh_QuadCXP12Area

面阵 Acquisition Applets#

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

以下面阵 Enhanced Applets 可用：

Enh_SingleCXP12Area
Enh_DualCXP12Area
Enh_QuadCXP12Area

选择合适的面阵 Acquisition Applet#

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

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

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

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

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

使用 Enhanced Applets#

结合 Framegrabber SDK 使用 Enhanced Applets#

在此可找到有关将 applet 与 Framegrabber SDK 配合使用的通用信息：Acquisition Applets。

安装 Enhanced Applets#

在采集卡上使用特定的 applet 之前，您需要将其安装到采集卡上。有关安装 applet 的说明，请参阅 Managing Applets (microDiagnostics)。

手动添加 Enhanced Applets#

要将作为 DLL 文件（而非以安装程序形式）接收到的 Applet 添加到主机文件系统：

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

现在，您可以在 microDisplayX、任何 GenTL 消费者或使用 Framegrabber API 编写的您自己的 SDK 程序中使用新的 applet。

测试图像采集#

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

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

保存 Applet 配置#

配置好 applet（在 microDisplay X 中或通过 Framegrabber API）后，您可以保存配置。有关更多信息，请参见配置 Applet (microDisplay X)。

结合 pylon Viewer 使用 Enhanced Applets#

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 安装目录。

现在，您可以在 microDisplayX、任何 GenTL 消费者或使用 Framegrabber API 编写的您自己的 SDK 程序中使用新的 applet。