适用于 marathon VCL 的 Acquisition Applets#
图像采集卡的功能由特定的硬件相关程序定义。这种硬件实现称为 applet。每款图像采集卡均提供多个 applet。
通过将 applet 加载到图像采集卡上，您可以定义图像采集卡的功能，并使其适应您的具体应用需求。
适用于 marathon VCL 的 Acquisition Applets 包含在 Framegrabber SDK 中。
在 marathon 图像采集卡上，applet 一经烧录到图像采集卡上即可使用。
要求#
- 主机软件：带硬件相关 acquisition applets 的 Framegrabber SDK（5.7、5.10a 或更高版本）
- 硬件：系统已连接 marathon VCL 采集卡
限制
在所有 applet 中，无法分配大于 4GB 的缓冲区。即使 applet 允许更大的缓冲区大小，由于驱动程序和固件中的限制，您也无法分配大于 4GB 的缓冲区。
您可以按如下方式计算缓冲区大小：
缓冲区大小 = 图像高度 * 图像宽度 * (像素位宽 / 8)。
对于 RGB 图像：缓冲区大小 = (图像高度 * 图像宽度 * (像素位宽 / 8)) * 3。
文档#
以下章节提供了指向 acquisition applets 文档的链接：
面阵 Acquisition Applets#
提供以下面阵 Acquisition Applets：
- Acq_DualBaseAreaBayer
- Acq_DualBaseAreaGray
- Acq_DualBaseAreaRGB
- Acq_SingleFullAreaBayer
- Acq_SingleFullAreaGray
- Acq_SingleFullAreaRGB
- Acq_SingleMediumAreaBayer
- Acq_SingleMediumAreaGray
- Acq_SingleMediumAreaRGB
Applet 名称中的“single”和“dual”表示您可以连接的最大相机数量。有关详细信息，请参阅 Choosing the Right Area Scan Acquisition Applet。
选择合适的面阵 Acquisition Applet#
您必须为相机设置选择正确的 applet。否则，将无法正确处理或显示从相机接收到的图像，或者相机的性能可能会显著降低。
哪款 applet 是正确的取决于相机数量、每个相机的通道数以及所需的 ROI 步长。
ROI 步长取决于图像预处理的并行度，因此随相机和图像采集卡而变化。
| 相机数量 | 相机端口数 | 采集卡端口数 | 模式 | 小程序 | ROI 步长 [像素] | 拓扑 |
|---|---|---|---|---|---|---|
| 1 | 2 | 2 | Bayer 格式 | Acq_SingleFullAreaBayer Acq_SingleMediumAreaBayer | x: 8; y: 1 x: 4; y: 1 |  |
| 1 | 2 | 2 | 灰度 | Acq_SingleFullAreaGray Acq_SingleMediumAreaGray | x: 8; y: 1 x: 4; y: 1 |  |
| 1 | 2 | 2 | RGB | Acq_SingleFullAreaRGB Acq_SingleMediumAreaRGB | x: 4; y: 1 x: 4; y: 1 |  |
| 2 | 1 | 2 | Bayer 格式 | Acq_DualBaseAreaBayer | x: 4 y: 1 |  |
| 2 | 1 | 2 | 灰度 | Acq_DualBaseAreaGray | x: 4 y: 1 |  |
| 2 | 1 | 2 | RGB | Acq_DualBaseAreaRGB | x: 1 y: 1 |  |
所有面阵 Acquisition Applets 的通用规格#
| 最大图像尺寸 [px] | 16k x 64kb |
| 镜像 | 是，水平和垂直 |
| 最大相机时钟 | 85 MHz |
| 图像选择器 | 是 |
| 查找表 (LUT) | 完整分辨率 |
| 总 DMA 带宽 [MB/s] c | 1800 |
面阵 Acquisition Applets 之间的规格差异#
| 相机端口 | 相机类型 | ROI 步长 [像素] | Bit Depth Processing [bit] | Bit Depth Output [bit] | 模式 | 镜像 | 抽头几何结构排序 | Bayer Color Reconstruction (HQe) | 白平衡 | Bandwidth: Mean per Camera [MP/s] | |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Acq_DualBaseAreaBayer | 2 | BASE | x: 4 y: 1 | 每颜色分量 12 | BGR 24、30 packed、36 packed 或 48 | Bayer 格式 | 是，水平和垂直 | 1、2、4（水平和垂直） | 是，High Quality Extended (HQe) | 是 | 255 |
| Acq_DualBaseAreaGray | 2 | BASE | x: 4 y: 1 | 16 | 灰度 8、10 packed、12 packed 或 16 | 灰度 | 是，水平和垂直 | 1、2、4（水平和垂直） | 无 | 无 | 255 |
| Acq_DualBaseAreaRGB | 2 | BASE | x: 1 y: 1 | 每颜色分量 8 | BGR 24 | RGB | 是，水平和垂直 | 1、2、4（水平和垂直） | 无 | 是 | 85 |
| Acq_SingleFullAreaBayer | 1 | FULL | x: 8 y: 1 | 每颜色分量 10 | BGR 24、30 packed 或 48 | Bayer 格式 | 是，水平 | 8、10（水平） | 是，High Quality Extended (HQe) | 是 | 850 |
| Acq_SingleFullAreaGray | 1 | FULL | x: 8 y: 1 | 10 | 灰度 8、10 packed 或 16 | 灰度 | 是，水平 | 8、10（水平） | 无 | 无 | 850 |
| Acq_SingleFullAreaRGB | 1 | FULL | x: 4 y: 1 | 每颜色分量 10 | BGR 24、30 packed 或 48 | RGB | 是，水平 | 1、2、4（水平和垂直） | 无 | 是 | 284 |
| Acq_SingleMediumAreaBayer | 1 | MEDIUM | x: 4 y: 1 | 每颜色分量 12 | BGR 24、30 packed、36 packed 或 48 | Bayer 格式 | 是，水平和垂直 | 1、2、4（水平和垂直） | 是，High Quality Extended (HQe) | 是 | 340 |
| Acq_SingleMediumAreaGray | 1 | MEDIUM | x: 4 y: 1 | 12 | 灰度 8、10 packed 或 16 | 灰度 | 是，水平和垂直 | 1、2、4（水平和垂直） | 无 | 无 | 340 |
| Acq_SingleMediumAreaRGB | 1 | MEDIUM | x: 4 y: 1 | 每颜色分量 12 | BGR 24、30 packed、36 packed 或 48 | RGB | 是，水平和垂直 | 1、2、4（水平和垂直） | 无 | 是 | 170 |
线阵 Acquisition Applets#
提供以下 Line Scan Acquisition Applets：
- Acq_SingleFullLineBayer_RB_GG
- Acq_SingleFullLineBayer_RG_GB
- Acq_SingleFullLineGray
- Acq_SingleFullLineRGB
- Acq_SingleMediumLineGray
- Acq_SingleMediumLineRGB
- Acq_DualBaseLineBayer_RG_GB
- Acq_DualBaseLineGray
- Acq_DualBaseLineRGB
小程序名称中的分母“single”和“dual”指可连接的最大相机数量。有关更多信息，请参见Choosing the Right Line Scan Acquisition Applet。
选择合适的线阵 Acquisition Applet#
您必须为您的相机设置选择正确的 applet。否则，相机可能无法工作或相机性能会显著下降。
哪款 applet 是正确的取决于相机数量、每个相机的通道数以及所需的 ROI 步长。
ROI 步长取决于图像预处理的并行度，因此随相机和图像采集卡而变化。
| 相机数量 | 相机端口数 | 采集卡端口数 | 模式 | 小程序 | ROI 步长 [像素] | 拓扑 |
|---|---|---|---|---|---|---|
| 1 | 2 | 2 | Bayer 格式 | Acq_SingleFullLineBayer_RB_GG Acq_SingleFullLineBayer_RB_GB | x: 8; y: 1 x: 8; y: 1 | |
| 1 | 2 | 2 | 灰度 | Acq_SingleFullLineGray Acq_SingleMediumLineGray | x: 8; y: 1 x: 8; y: 1 | |
| 1 | 2 | 2 | RGB | Acq_SingleFullLineRGB Acq_SingleMediumLineRGB | x: 4; y: 1 x: 4; y: 1 | |
| 2 | 1 | 2 | Bayer 格式 | Acq_DualBaseLineBayer_RG_GB | x: 4 y: 1 | |
| 2 | 1 | 2 | 灰度 | Acq_DualBaseLineGray | x: 4 y: 1 | |
| 2 | 1 | 2 | RGB | Acq_DualBaseLineRGB | x: 1 y: 1 | |
所有线阵 Acquisition Applets 的通用规格#
| 相机时钟 | 85 MHz |
| 图像选择器 | 是 |
| 查找表 (LUT) | 完整分辨率 |
线阵 Acquisition Applets 之间的规格差异#
| 图像尺寸 [px] b | 相机端口 | 相机类型 | ROI 步长 [像素] | Bit Depth Processing [bit] | Bit Depth Output [bit] | 模式 | 镜像 | 抽头几何结构排序 | Bayer Color Reconstruction (HQe) | 白平衡 | Bandwidth: Mean per Camera [MP/s] | 总 DMA 带宽 [MB/s] c | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Acq_DualBaseLineBayer_RG_GB | 16k x 64k | 2 | BASE | x: 4 y: 1 | 每颜色分量 8 | BGR 24 | Bayer 格式 | 无 | 无 | 是（2 行） | 是 | 566 | 900 |
| Acq_DualBaseLineGray | 48k x 16M | 2 | BASE | x: 4 y: 1 | 16 | 灰度 8、10 packed、12 packed 或 16 | 灰度 | 是，水平 | 1、2、3、4（水平） | 无 | 无 | 255 | 1800 |
| Acq_DualBaseLineRGB | 32k x 16M | 2 | BASE | x: 1 y: 1 | 每颜色分量 8 | BGR 24 | RGB | 是，水平 | 1、2、4（水平） | 无 | 是 | 85 | 1800 |
| Acq_SingleFullLineBayer_RB_GG | 16k x 16M | 1 | FULL | x: 8 y: 1 | 每颜色分量 8 | BGR 24 | Bayer 格式 | 是，水平 | 8、10（水平） | 是（2 行） | 是 | 850 | 1800 |
| Acq_SingleFullLineBayer_RG_GB | 16k x 16M | 1 | FULL | x: 8 y: 1 | 每颜色分量 8 | BGR 24 | Bayer 格式 | 是，水平 | 8、10（水平） | 是（2 行） | 是 | 566 | 1800 |
| Acq_SingleFullLineGray | 51k x 16M | 1 | FULL | x: 8 y: 1 | 10 | 灰度 8、10 packed 或 16 | 灰度 | 是，水平 | 8、10（水平） | 无 | 无 | 850 | 1800 |
| Acq_SingleFullLineRGB | 32k x 16M | 1 | FULL | x: 4 y: 1 | 每颜色分量 10 | BGR 24、30 packed 或 48 | RGB | 是，水平 | 1、2、4（水平） | 无 | 是 | 284 | 1800 |
| Acq_SingleMediumLineGray | 48k x 16M | 1 | MEDIUM | x: 8 y: 1 | 12 | 灰度 8、10 packed、12 packed 或 16 | 灰度 | 是，水平 | 1、2、3、4（水平） | 无 | 无 | 340 | 1800 |
| Acq_SingleMediumLineRGB | 32k x 16M | 1 | MEDIUM | x: 4 y: 1 | 每颜色分量 12 | BGR 24、30 packed、36 packed 或 48 | RGB | 是，水平 | 1、2、4（水平） | 无 | 是 | 170 | 1800 |
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)。