用于 marathon ACX-DP 的 Acquisition Applets#
图像采集卡的功能由特定的硬件相关程序定义。这种硬件实现称为 applet。每款图像采集卡均提供多个 applet。
通过将 applet 加载到图像采集卡上，您可以定义图像采集卡的功能，并使其适应您的具体应用需求。
marathon ACX-DP 的 Acquisition Applets 包含在 Framegrabber SDK 中。
在 marathon 图像采集卡上，applet 一经烧录到图像采集卡上即可使用。
要求#
- 主机软件：带硬件相关 acquisition applets 的 Framegrabber SDK（5.7、5.10a 或更高版本）
- 硬件：marathon ACX-DP 采集卡已连接至您的系统
限制
在所有 applet 中，无法分配大于 4GB 的缓冲区。即使 applet 允许更大的缓冲区大小，由于驱动程序和固件中的限制，您也无法分配大于 4GB 的缓冲区。
您可以按如下方式计算缓冲区大小：
缓冲区大小 = 图像高度 * 图像宽度 * (像素位宽 / 8)。
对于 RGB 图像：缓冲区大小 = (图像高度 * 图像宽度 * (像素位宽 / 8)) * 3。
文档#
以下章节提供了指向 acquisition applets 文档的链接：
面阵 Acquisition Applets#
提供以下面阵 Acquisition Applets：
- Acq_SingleCXP6x2AreaBayer
- Acq_SingleCXP6x2AreaGray
- Acq_SingleCXP6x2AreaRGB
- Acq_DualCXP6x1AreaBayer
- Acq_DualCXP6x1AreaGray
- Acq_DualCXP6x1AreaRGB
Applet 名称中的“single”和“dual”表示您可以连接的最大相机数量。有关详细信息，请参阅 Choosing the Right Area Scan Acquisition Applet。
选择合适的面阵 Acquisition Applet#
您必须为相机设置选择正确的 applet。否则，将无法正确处理或显示从相机接收到的图像，或者相机的性能可能会显著降低。
哪款 applet 是正确的取决于相机数量、每个相机的通道数以及所需的 ROI 步长。
ROI 步长取决于图像预处理的并行度，因此随相机和图像采集卡而变化。
| 相机数量 | 相机端口数 | 采集卡端口数 | 模式 | 小程序 | ROI 步长 [像素] | 拓扑 |
|---|---|---|---|---|---|---|
| 1 | 2 | 2 | Bayer 格式 | Acq_SingleCXP6x2AreaBayer | x: 8 y: 1 |  |
| 1 | 2 | 2 | 灰度 | Acq_SingleCXP6x2AreaGray | x: 16 y: 1 |  |
| 1 | 2 | 2 | RGB | Acq_SingleCXP6x2AreaRGB | x: 4 y: 1 |  |
| 2 | 1 | 2 | Bayer 格式 | Acq_DualCXP6x1AreaBayer | x: 8 y: 1 |  |
| 2 | 1 | 2 | 灰度 | Acq_DualCXP6x1AreaGray | x: 16 y: 1 |  |
| 2 | 1 | 2 | RGB | Acq_DualCXP6x1AreaRGB | x: 4 y: 1 |  |
所有面阵 Acquisition Applets 的通用规格#
| 相机类型 | CXP-6 |
| 镜像 | 是，水平和垂直 |
| 图像选择器 | 是 |
| 查找表 (LUT) | 完整分辨率 |
| 总 DMA 带宽 [MB/s] b | 1800 |
面阵 Acquisition Applets 之间的规格差异#
| 最大图像尺寸 [px] c | 相机端口 | ROI 步长 [像素] | Bit Depth Processing [bit] | Bit Depth Output [bit] | 模式 | Bayer Color Reconstruction (HQe) | 白平衡 | Bandwidth: Mean per Camera [MP/s] | |
|---|---|---|---|---|---|---|---|---|---|
| Acq_DualCXP6x1AreaBayer | 16k x 64k | 2 | x: 8 y: 1 | 每个颜色分量 14 | BGR 24, 30 packed, 36 packed, 42 packed, or 48 | Bayer 格式 | 是，High Quality Extended (HQe) | 是 | 600 |
| Acq_DualCXP6x1AreaGray | 64k x 64k | 2 | x: 16 y: 1 | 16 | Grayscale 8, 10 packed, 12 packed, 14 packed, or 16 | 灰度 | 无 | 无 | 600 |
| Acq_DualCXP6x1AreaRGB | 64k x 64k | 2 | x: 4 y: 1 | 16 per color component | BGR 24, 30 packed, 36 packed, 42 packed, or 48 | RGB | 无 | 是 | 200 |
| Acq_SingleCXP6x2AreaBayer | 48k x 64k | 1 | x: 8 y: 1 | 每个颜色分量 14 | BGR 24, 30 packed, 36 packed, 42 packed, or 48 | Bayer 格式 | 是，High Quality Extended (HQe) | 是 | 1200 |
| Acq_SingleCXP6x2AreaGray | 64k x 64k | 1 | x: 16 y: 1 | 16 | Grayscale 8, 10 packed, 12 packed, 14 packed, or 16 | 灰度 | 无 | 无 | 1200 |
| Acq_SingleCXP6x2AreaRGB | 64k x 64k | 1 | x: 4 y: 1 | 16 per color component | BGR 24, 30 packed, 36 packed, 42 packed, or 48 | RGB | 无 | 是 | 400 |
线阵 Acquisition Applets#
提供以下 Line Scan Acquisition Applets：
- Acq_SingleCXP6x2LineGray
- Acq_SingleCXP6x2LineRGB
- Acq_DualCXP6x1LineGray
- Acq_DualCXP6x1LineRGB
小程序名称中的分母“single”和“dual”指可连接的最大相机数量。有关更多信息，请参见Choosing the Right Line Scan Acquisition Applet。
选择合适的线阵 Acquisition Applet#
您必须为您的相机设置选择正确的 applet。否则，相机可能无法工作或相机性能会显著下降。
哪款 applet 是正确的取决于相机数量、每个相机的通道数以及所需的 ROI 步长。
ROI 步长取决于图像预处理的并行度，因此随相机和图像采集卡而变化。
| 相机数量 | 相机端口数 | 采集卡端口数 | 模式 | 小程序 | ROI 步长 [像素] | 拓扑 |
|---|---|---|---|---|---|---|
| 1 | 2 | 2 | 灰度 | Acq_SingleCXP6x2LineGray | x: 16 y: 1 | |
| 1 | 2 | 2 | RGB | Acq_SingleCXP6x2LineRGB | x: 4 y: 1 | |
| 2 | 1 | 2 | 灰度 | Acq_DualCXP6xLineGray | x: 16 y: 1 | |
| 2 | 1 | 2 | RGB | Acq_DualCXP6xLineRGB | x: 4 y: 1 | |
所有线阵 Acquisition Applets 的通用规格#
| 最大图像尺寸 [px] | 64k x 8Mc |
| 相机类型 | CXP-6 |
| 镜像 | 是，水平和垂直 |
| 图像选择器 | 是 |
| Bayer Color Reconstruction (HQe) | 无 |
| 查找表 (LUT) | 完整分辨率 |
| 总 DMA 带宽 [MB/s] b | 1800 |
线阵 Acquisition Applets 之间的规格差异#
| 相机端口 | ROI 步长 [像素] | Bit Depth Processing [bit] | Bit Depth Output [bit] | 模式 | 白平衡 | Bandwidth: Mean per Camera [MP/s] | |
|---|---|---|---|---|---|---|---|
| Acq_DualCXP6x1LineGray | 2 | x: 16 y: 1 | 16 | Grayscale 8, 10 packed, 12 packed, 14 packed, or 16 | 灰度 | 无 | 600 |
| Acq_DualCXP6x1LineRGB | 2 | x: 4 y: 1 | 16 per color component | BGR 24, 30 packed, 36 packed, 42 packed, or 48 | RGB | 是 | 200 |
| Acq_SingleCXP6x2LineGray | 1 | x: 16 y: 1 | 16 | Grayscale 8, 10 packed, 12 packed, 14 packed, or 16 | 灰度 | 无 | 1200 |
| Acq_SingleCXP6x2LineRGB | 1 | x: 4 y: 1 | 16 per color component | BGR 24, 30 packed, 36 packed, 42 packed, or 48 | RGB | 是 | 400 |
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 等 |
使用 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（及其参数化选项）。
为此，系统为您提供了 microDisplay X 工具，该工具作为 Framegrabber SDK 环境的一部分已安装在您的计算机上。有关如何加载和测试 applet 的说明，请参见 Configuring the Applet (microDisplay X)。
保存 Applet 配置#
在配置完 applet（在 microDisplay X 中或通过 Framegrabber API）后，您可以保存配置。有关更多信息，请参见 Other Tasks (microDisplay X)。