Acquisition Applets for marathon VCLx#
采集卡的功能由特定的硬件相关程序定义。这种硬件实现称为 applet。每款采集卡都提供多个 applet。
通过将 Applet 加载到采集卡上，您可以定义采集卡的功能并使其适应特定应用的要求。
marathon VCLx 的 Acquisition Applets 包含在 Framegrabber SDK 中。
在 marathon 采集卡上，applet 一旦被写入到采集卡中即可使用。
要求#
- 主机软件：带硬件相关采集 applet 的 Framegrabber SDK（5.7、5.10a 或更高版本）
- 硬件：系统中连接了一个 marathon VCLx 采集卡
限制
在所有 applet 中，无法分配大于 4GB 的缓冲区。即使 applet 允许更大的缓冲区大小，由于驱动程序和固件的限制，您也无法分配大于 4GB 的缓冲区。
您可以按如下方式计算缓冲区大小：
Buffer size = image height * image width * (pixel width / 8).
对于 RGB 图像：buffer size = (image height * image width * (pixel width / 8)) * 3 .
文档#
以下部分提供了 acquisition applets 文档的链接：
面阵采集 Applets#
提供以下面阵采集 applets (Area Scan Acquisition Applets)：
- Acq_DualBaseAreaBayer
- Acq_DualBaseAreaGray
- Acq_DualBaseAreaRGB
- Acq_SingleFullAreaBayer
- Acq_SingleFullAreaGray
- Acq_SingleFullAreaRGB
- Acq_SingleMediumAreaBayer
- Acq_SingleMediumAreaGray
- Acq_SingleMediumAreaRGB
Applet 名称中的分母“single”和“dual”是指您可以连接的最大相机数量。有关更多信息，请参见选择正确的面阵采集 Applet。
选择合适的面阵采集中转 Applet#
您必须为相机设置选择正确的 applet。否则，将无法正确处理或显示从相机接收到的图像，或者相机的性能可能会大幅下降。
哪种 applet 是正确的，取决于相机的数量、每台相机的通道数以及所需的 ROI 步长。
ROI 步长取决于图像预处理的并行度，因此随相机和图像采集卡而变化。
| 相机数量 | 相机端口数 | 采集卡端口数 | Mode | 小程序 | ROI 步长 [像素] | 拓扑 |
|---|---|---|---|---|---|---|
| 1 | 2 | 2 | Bayer 格式 | Acq_SingleFullAreaBayer Acq_SingleMediumAreaBayer | x: 16; y: 1 x: 8; y: 1 |  |
| 1 | 2 | 2 | 灰度 | Acq_SingleFullAreaGray Acq_SingleMediumAreaGray | x: 16; y: 1 x: 8; y: 1 |  |
| 1 | 2 | 2 | RGB | Acq_SingleFullAreaRGB Acq_SingleMediumAreaRGB | x: 8; y: 1 x: 4; y: 1 |  |
| 2 | 1 | 2 | Bayer 格式 | Acq_DualBaseAreaBayer | x: 8 y: 1 |  |
| 2 | 1 | 2 | 灰度 | Acq_DualBaseAreaGray | x: 8 y: 1 |  |
| 2 | 1 | 2 | RGB | Acq_DualBaseAreaRGB | x: 8 y: 1 |  |
所有面阵采集 Applets 的通用规格#
| Max. Image Size [px] | 16k x 64kb |
| 最大相机时钟 | 85 MHz |
| Image Selector | 是 |
| 查找表 (LUT) | Full resolution |
| 总 DMA 带宽 [MB/s] c | 1800 |
不同面阵采集 Applets 之间的规格差异#
| Camera Ports | 相机类型 | ROI 步长 [像素] | Bit Depth Processing [bit] | Bit Depth Output [bit] | Mode | 镜像 | 点击几何排序 | Bayer Color Reconstruction (HQe) | 白平衡 | Bandwidth: Mean per Camera [MP/s] | |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Acq_DualBaseAreaBayer | 2 | BASE | x: 8 y: 1 | 每颜色分量 12 位 | BGR 24、30 packed、36 packed 或 48 | Bayer 格式 | 是，水平和垂直 | 1、2、4（水平和垂直） | Yes, High Quality Extended (HQe) | 是 | 255 |
| Acq_DualBaseAreaGray | 2 | BASE | x: 8 y: 1 | 16 | Grayscale 8、10 packed、12 packed 或 16 | 灰度 | 是，水平和垂直 | 1、2、4（水平和垂直） | 无 | 无 | 255 |
| Acq_DualBaseAreaRGB | 2 | BASE | x: 8 y: 1 | 每彩色分量 8 位 | BGR 24 | RGB | 是，水平和垂直 | 1、2、4（水平和垂直） | 无 | 是 | 85 |
| Acq_SingleFullAreaBayer | 1 | FULL | x: 16 y: 1 | 每颜色分量 10 位 | BGR 24、30 packed 或 48 | Bayer 格式 | 支持，水平方向 | 8, 10（水平方向） | Yes, High Quality Extended (HQe) | 是 | 850 |
| Acq_SingleFullAreaGray | 1 | FULL | x: 16 y: 1 | 10 | Grayscale 8, 10 packed, 16 | 灰度 | 支持，水平方向 | 8, 10（水平方向） | 无 | 无 | 850 |
| Acq_SingleFullAreaRGB | 1 | FULL | x: 8 y: 1 | 每颜色分量 10 位 | BGR 24、30 packed 或 48 | RGB | 支持，水平方向 | 1、2、4（水平和垂直） | 无 | 是 | 284 |
| Acq_SingleMediumAreaBayer | 1 | MEDIUM | x: 8 y: 1 | 每颜色分量 12 位 | BGR 24、30 packed、36 packed 或 48 | Bayer 格式 | 是，水平和垂直 | 1、2、4（水平和垂直） | Yes, High Quality Extended (HQe) | 是 | 340 |
| Acq_SingleMediumAreaGray | 1 | MEDIUM | x: 8 y: 1 | 12 | Grayscale 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 |
线阵采集 Applets#
提供以下线阵扫描 Acquisition Applets：
- Acq_SingleFullLineGray
- Acq_SingleFullLineRGB
- Acq_SingleMediumLineGray
- Acq_SingleMediumLineRGB
- Acq_DualBaseLineGray
- Acq_DualBaseLineRGB
applet 名称中的分母“single”和“dual”指可连接相机的最大数量。有关详细信息，请参阅 Choosing the Right Line Scan Acquisition Applet。
选择正确的线阵采集 Applet#
您必须为相机设置选择正确的 applet。否则，相机可能无法工作，或者相机性能可能会显著降低。
哪种 applet 是正确的，取决于相机的数量、每台相机的通道数以及所需的 ROI 步长。
ROI 步长取决于图像预处理的并行度，因此随相机和图像采集卡而变化。
| 相机数量 | 相机端口数 | 采集卡端口数 | Mode | 小程序 | ROI 步长 [像素] | 拓扑 |
|---|---|---|---|---|---|---|
| 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 | 灰度 | Acq_DualBaseLineGray | x: 4 y: 1 | |
| 2 | 1 | 2 | RGB | Acq_DualBaseLineRGB | x: 1 y: 1 | |
所有线阵采集 Applets 的通用规格#
| 镜像 | 支持，水平方向 |
| 相机时钟 | 85 MHz |
| Image Selector | 是 |
| Bayer Color Reconstruction (HQe) | 无 |
| 查找表 (LUT) | Full resolution |
| 总 DMA 带宽 (MB/s) c | 1800 |
不同线阵采集 Applets 之间的规格差异#
| 图像尺寸 [px] b | Camera Ports | 相机类型 | ROI 步长 [像素] | Bit Depth Processing [bit] | Bit Depth Output [bit] | Mode | 点击几何排序 | 白平衡 | Bandwidth: Mean per Camera [MP/s] | |
|---|---|---|---|---|---|---|---|---|---|---|
| Acq_DualBaseLineGray | 48k x 16M | 2 | BASE | x: 4 y: 1 | 16 | Grayscale 8、10 packed、12 packed 或 16 | 灰度 | 1, 2, 3, 4（水平方向） | 无 | 255 |
| Acq_DualBaseLineRGB | 32k x 16M | 2 | BASE | x: 1 y: 1 | 每彩色分量 8 位 | BGR 24 | RGB | 1、2、4（水平） | 是 | 85 |
| Acq_SingleFullLineGray | 51k x 16M | 1 | FULL | x: 8 y: 1 | 10 | Grayscale 8、10 packed 或 16 | 灰度 | 8, 10（水平方向） | 无 | 850 |
| Acq_SingleFullLineRGB | 32k x 16M | 1 | FULL | x: 4 y: 1 | 每颜色分量 10 位 | BGR 24、30 packed 或 48 | RGB | 1、2、4（水平） | 是 | 284 |
| Acq_SingleMediumLineGray | 48k x 16M | 1 | MEDIUM | x: 8 y: 1 | 12 | Grayscale 8、10 packed、12 packed 或 16 | 灰度 | 1, 2, 3, 4（水平方向） | 无 | 340 |
| Acq_SingleMediumLineRGB | 32k x 16M | 1 | MEDIUM | x: 4 y: 1 | 每颜色分量 12 位 | BGR 24、30 packed、36 packed 或 48 | RGB | 1、2、4（水平） | 是 | 170 |
Frame Grabber Test Applet#
此 applet 是一个 Frame Grabber Test Applet。其目的是测试硬件。
该 applet 提供以下功能：
| 功能 | 解释 |
|---|---|
| DMA Performance Test | 测试不同的图像尺寸，以适应不同的 Memory 大小和中断速率 |
| RAM Test | 检查错误和处理情况 |
| Check Camera Port Image Acquisition | 检查相机端口图像采集 |
| Send Trigger Signals to Camera | 向相机发送触发信号 |
| GPIO Monitoring | 监测 GPI 并设置 GPO |
| Event Test | 生成软件回调事件 |
| General Monitoring | 监测 FPGA 温度、电源管理、PoCXP 等 |
使用 Acquisition Applets#
在此处查找关于将 applet 与 Framegrabber SDK 配合使用的一般信息：Acquisition Applets。
安装 Applet#
在采集卡上使用特定小程序之前，必须将其安装到采集卡上。有关安装小程序的说明，请参阅 Managing Applets (microDiagnostics)。
手动添加 Applet#
要将作为 *.dll 文件（而不是以安装程序形式）收到的从小程序添加到主机文件系统中：
- 获取您收到的从小程序文件 (*.dll)。
- Copy this file into the following directory: <Framegrabber SDK installation directory>/Dll/<Frame grabber model>
现在您可以使用新小程序了。
测试图像采集#
在您自己的软件（通过 API）中使用 applet 之前，您可能需要测试系统设置或单个 applet（及其参数化选项）。
为此，系统为您提供了 microDisplay X 工具，该工具作为 Framegrabber SDK 环境的一部分已安装在您的计算机上。有关如何加载和测试小程序的说明，请参阅 Configuring the Applet (microDisplay X)。
保存 Applet 配置#
配置完小程序后（在 microDisplay X 中或通过 Framegrabber API），您可以保存配置。有关更多信息，请参阅 Other Tasks (microDisplay X)。