imaFlex CXP-12 Penta 的 Applets#
为确保优化使用系统资源，专为 imaFlex CXP-12 Penta 设计的所有图像采集和处理功能不会同时加载到 imaFlex CXP-12 Penta 上。相反，Basler 提供了特定图像采集和处理功能的各种编译组合，以满足特定应用领域的需求。
通常，一个 Applet 支持特定的相机接口标准和拓扑结构、特定的图像采集功能以及可能的图像（预）处理功能。通过将 Applet 加载到采集卡上，您可以定义采集卡的功能并使其适应您的特定应用需求。
Applets 分为两种：由 Basler 始终提供的采集 Applets（*.dll），以及您自己或 Basler 使用 VisualApplets 开发的自定义 Applets（*.hap）。除了随附的采集 Applets 之外，imaFlex CXP-12 Penta 还可编程以执行特定应用所需的高度特定的图像处理任务。编程可由 Basler、认证合作伙伴或您自己使用易用的图形化 FPGA 编程环境 VisualApplets 来完成。
imaFlex CXP-12 Penta 的 Acquisition Applets 包含在 Framegrabber SDK 以及 pylon Software Suite 中。
要求#
- 主机软件：Framegrabber SDK 5.11.3 或更高版本
- 硬件：系统已连接 imaFlex CXP-12 Penta 采集卡
限制
在所有 applet 中，无法分配大于 4GB 的缓冲区。即使 applet 允许更大的缓冲区大小，由于驱动程序和固件中的限制，您也无法分配大于 4GB 的缓冲区。
您可以按如下方式计算缓冲区大小：
缓冲区大小 = 图像高度 * 图像宽度 * (像素位宽 / 8)。
对于 RGB 图像：缓冲区大小 = (图像高度 * 图像宽度 * (像素位宽 / 8)) * 3。
文档#
以下章节提供了指向 acquisition applets 文档的链接：
面阵 Acquisition Applets#
| GenTL | Fglib |
|---|---|
| Acq_SingleCXP12Area PDF | Acq_SingleCXP12Area PDF |
| Acq_DualCXP12Area PDF | Acq_DualCXP12Area PDF |
| Acq_PentaCXP12Area PDF | Acq_PentaCXP12Area PDF |
线阵 Acquisition Applets#
| GenTL | Fglib |
|---|---|
| Acq_SingleCXP12Line PDF | Acq_SingleCXP12Line PDF |
| Acq_DualCXP12Line PDF | Acq_DualCXP12Line PDF |
| Acq_PentaCXP12line PDF | Acq_PentaCXP12line PDF |
Frame Grabber Test Applet#
| GenTL | Fglib |
|---|---|
| Frame Grabber Test Applet PDF | Frame Grabber Test Applet PDF |
面阵 Acquisition Applets#
提供以下面阵 Acquisition Applets：
- Acq_SingleCXP12Area
- Acq_DualCXP12Area
- Acq_PentaCXP12Area
Applet 名称中的“single”、“dual”和“penta”分母是指您可以连接的最大相机数量。有关详细信息，请参阅 选择正确的面阵采集 Applet。
选择合适的面阵 Acquisition Applet#
您必须为相机设置选择正确的 applet。否则，将无法正确处理或显示从相机接收到的图像，或者相机的性能可能会显著降低。
哪款 applet 是正确的取决于相机数量、每个相机的通道数以及所需的 ROI 步长。
ROI 步长取决于图像预处理的并行度，因此随相机和图像采集卡而变化。
| 最大相机数量 | 1 通道相机数量 | 2 通道相机数量 | 4 通道相机数量 | 小程序 | ROI 步长 [像素] |
|---|---|---|---|---|---|
| 5 | 1 | Acq_PentaCXP12Area | x: 8 y: 1 | ||
| 5 | 2 | Acq_PentaCXP12Area | x: 8 y: 1 | ||
| 5 | 3 | Acq_PentaCXP12Area | x: 8 y: 1 | ||
| 5 | 4 | Acq_PentaCXP12Area | x: 8 y: 1 | ||
| 5 | 5 | Acq_PentaCXP12Area | x: 8 y: 1 | ||
| 2 | 1 | Acq_DualCXP12Areaa | x: 16 y: 1 | ||
| 2 | 2 | Acq_DualCXP12Areaa | x: 16 y: 1 | ||
| 2 | 1 | 1 | Acq_DualCXP12Area | x: 16 y: 1 | |
| 2 | 1 | Acq_DualCXP12Area | x: 16 y: 1 | ||
| 2 | 2 | Acq_DualCXP12Area | x: 16 y: 1 | ||
| 1 | 1 | Acq_SingleCXP12Areaa | x: 32 y: 1 | ||
| 1 | 1 | Acq_SingleCXP12Areab | x: 32 y: 1 | ||
| 1 | 1 | Acq_SingleCXP12Area | x: 32 y: 1 |
所有面阵 Acquisition Applets 的通用规格#
| 最大图像尺寸 [px] | 32k x 64kc |
| CXP 端口 | 5 |
| 最大 CXP 速度 | CXP-12 |
| Bit Depth Processing [bit] | 16（Bayer Demosaicing 为 14） |
| 像素格式 | Mono8-16 RGB8-16 RGBa8 BGR8-16 BGRa8 Bayer8-14 YUV422_8 |
| 镜像 | 是，水平和垂直 |
| 图像选择器 | 是 |
| Bayer Color Reconstruction (HQe) | 是，High Quality Extended (HQe) |
| 白平衡 | 是 |
| 查找表 (LUT) | 完整分辨率 |
| Pixel Format 转换 | RGB 或 Bayer 转单色， Bayer 或单色转 RGB |
| 总 DMA 带宽 [MB/s]d | 7200 |
面阵 Acquisition Applets 之间的规格差异#
| ROI 步长 [像素] | Bandwidth: Mean per Camera [MP/s] | 抽头几何结构排序 | |
|---|---|---|---|
| Acq_SingleCXP12Area | x: 32 y: 1 | 4850 | 1X-1Y, 1X-2YE |
| Acq_DualCXP12Area | x: 16 y: 1 | 2400 | 1X-1Y, 1X-2YE |
| Acq_PentaCXP12Area | x: 8 y: 1 | 1200 | 仅限 1X-1Y |
线阵 Acquisition Applets#
提供以下 Line Scan Acquisition Applets：
- Acq_SingleCXP12Line
- Acq_DualCXP12Line
- Acq_PentaCXP12Line
Applet 名称中的“single”、“dual”和“penta”是指您可以连接的最大相机数量。有关详细信息，请参阅 选择正确的线阵采集 Applet。
选择合适的线阵 Acquisition Applet#
您必须为您的相机设置选择正确的 applet。否则，相机可能无法工作或相机性能会显著下降。
哪款 applet 是正确的取决于相机数量、每个相机的通道数以及所需的 ROI 步长。
ROI 步长取决于图像预处理的并行度，因此随相机和图像采集卡而变化。
| 最大相机数量 | 1 通道相机数量 | 2 通道相机数量 | 4 通道相机数量 | 小程序 | ROI 步长 [像素] |
|---|---|---|---|---|---|
| 5 | 1 | Acq_PentaCXP12Line | x: 8 y: 1 | ||
| 5 | 2 | Acq_PentaCXP12Line | x: 8 y: 1 | ||
| 5 | 3 | Acq_PentaCXP12Line | x: 8 y: 1 | ||
| 5 | 4 | Acq_PentaCXP12Line | x: 8 y: 1 | ||
| 5 | 5 | Acq_PentaCXP12Line | x: 8 y: 1 | ||
| 2 | 1 | Acq_DualCXP12Linee | x: 16 y: 1 | ||
| 2 | 2 | Acq_DualCXP12Linee | x: 16 y: 1 | ||
| 2 | 1 | 1 | Acq_DualCXP12Line | x: 16 y: 1 | |
| 2 | 1 | Acq_DualCXP12Line | x: 16 y: 1 | ||
| 2 | 2 | Acq_DualCXP12Line | x: 16 y: 1 | ||
| 1 | 1 | Acq_SingleCXP12Linee | x: 32 y: 1 | ||
| 1 | 1 | Acq_SingleCXP12Linef | x: 32 y: 1 | ||
| 1 | 1 | Acq_SingleCXP12Line | x: 32 y: 1 |
所有线阵 Acquisition Applets 的通用规格#
| 最大图像尺寸 [px] | 32k x 8Mc |
| 相机端口 | 5 |
| 相机类型 | CXP-12 |
| Bit Depth Processing [bit] | 16（双色转 BGR/RGB 转换为 12 bit） |
| 像素格式 | Mono8-16 RGB8-16 RGBa8 BGR8-16 BGRa8 BiColor8-12 YUV422_8 |
| 镜像 | 是，水平和垂直 |
| 抽头几何结构排序 | 仅限 1X-1Y |
| 图像选择器 | 是 |
| 彩色滤光片 | 是，双线双色 (BiColor) |
| 白平衡 | 是 |
| 查找表 (LUT) | 完整分辨率 |
| Pixel Format 转换 | RGB 或双色转单色， 单色或双色转 RGB |
| 带宽：总 DMA [MB/s]d | 7200 |
线阵 Acquisition Applets 之间的规格差异#
| ROI 步长 [像素] | Bandwidth: Mean per Camera [MP/s] | |
|---|---|---|
| Acq_SingleCXP12Line | x: 32 y: 1 | 4850 |
| Acq_DualCXP12Line | x: 16 y: 1 | 2400 |
| Acq_PentaCXP12Line | x: 8 y: 1 | 1200 |
Frame Grabber Test Applet#
此 applet 是一个 Frame Grabber Test Applet。其目的是测试硬件。
该 applet 提供以下功能：
| 功能 | 解释 |
|---|---|
| DMA Performance Test | 针对不同的内存大小和中断速率测试不同的图像尺寸 |
| RAM Test | 检查错误和处理 |
| Check Camera Port Image Acquisition | 检查相机端口图像采集 |
| Send Trigger Signals to Camera | 向相机发送触发信号 |
| GPIO 监控 | 监控 GPI 并设置 GPO |
| 事件测试 | 生成软件回调事件 |
| 常规监控 | 监控 FPGA 温度、电源管理、PoCXP 等 |
| DMAfromPC | 通过 DMA 将图像传输到采集卡。 |
使用 Acquisition Applets#
在 Framegrabber SDK 中使用 Acquisition Applets#
在此可找到有关将 applet 与 Framegrabber SDK 配合使用的通用信息：Acquisition Applets。
安装 Applet#
在采集卡上使用特定的 applet 之前，您需要将其安装到采集卡上。有关安装 applet 的说明，请参阅 Managing Applets (microDiagnostics)。
手动添加 Applet#
若要将作为 *.dll 文件（而非安装程序形式）收到的 applet 添加到主机文件系统中：
- 获取您收到的 applet 文件（*.dll）。
- Copy this file into the following directory: <Framegrabber SDK installation directory>/Dll/<frame grabber model>
现在您可以使用新的 applet 了。
测试图像采集#
在您自己的软件（通过 API）中开始使用 applet 之前，您可能需要测试系统设置或单个 applet（及其参数化选项）。
为此，您可以借助作为 Framegrabber SDK 环境的一部分安装在主机上的 microDisplay X 工具。有关如何加载和测试 applet 的说明，请参阅 Configuring the Applet (microDisplay X)。
保存 Applet 配置#
在配置完 applet（在 microDisplay X 中或通过 Framegrabber API）后，您可以保存配置。有关更多信息，请参见 Other Tasks (microDisplay X)。