跳转到内容

marathon ACX-QP 的 Acquisition Applets#

本主题介绍适用于 marathon ACX-QP 帧采集卡的 acquisition applets。

采集卡的功能由特定的硬件相关程序定义。这种硬件实现称为 applet。每款采集卡都提供多个 applet。

通过将 Applet 加载到采集卡上，您可以定义采集卡的功能并使其适应特定应用的要求。

marathon ACX-QP 的 acquisition applets 包含在 Framegrabber SDK 中。

在 marathon 采集卡上，applet 一旦被写入到采集卡中即可使用。

要求#

  • 主机软件：带硬件相关采集 applet 的 Framegrabber SDK（5.7、5.10a 或更高版本）
  • 硬件：系统已连接 marathon ACX-QP 采集卡

限制

在所有 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 测试 Applet
Acq_SingleCXP6x4AreaBayer PDF
Acq_SingleCXP6x4AreaGray PDF Acq_SingleCXP6x4LineGray PDF
Acq_SingleCXP6x4AreaRGB PDF Acq_SingleCXP6x4LineRGB PDF
Acq_DualCXP6x2AreaBayer PDF
Acq_DualCXP6x2AreaGray PDF Acq_DualCXP6x2LineGray PDF
Acq_DualCXP6x2AreaRGB PDF Acq_DualCXP6x2LineRGB PDF
Acq_QuadCXP6x1AreaBayer PDF
Acq_QuadCXP6x1AreaGray PDF Acq_QuadCXP6x1LineGray PDF
Acq_QuadCXP6x1AreaRGB PDF Acq_QuadCXP6x1LineRGB PDF
FrameGrabberTest PDF

面阵采集 Applets#

提供以下面阵采集 applets (Area Scan Acquisition Applets)：

  • Acq_DualCXP6x2AreaBayer
  • Acq_DualCXP6x2AreaGray
  • Acq_DualCXP6x2AreaRGB
  • Acq_QuadCXP6x1AreaBayer
  • Acq_QuadCXP6x1AreaGray
  • Acq_QuadCXP6x1AreaRGB
  • Acq_SingleCXP6x4AreaBayer
  • Acq_SingleCXP6x4AreaGray
  • Acq_SingleCXP6x4AreaRGB

applet 名称中的“single”、“dual”和“quad”分母是指您可以连接的最大相机数量。有关更多信息，请参见 Choosing the Right Area Scan Acquisition Applet。

选择合适的面阵采集中转 Applet#

您必须为相机设置选择正确的 applet。否则，将无法正确处理或显示从相机接收到的图像，或者相机的性能可能会大幅下降。

哪种 applet 是正确的，取决于相机的数量、每台相机的通道数以及所需的 ROI 步长。

ROI 步长取决于图像预处理的并行度，因此随相机和图像采集卡而变化。

相机数量 相机端口数 采集卡端口数 Mode 小程序 ROI 步长 [像素] 拓扑
1 4 4 Bayer 格式 Acq_SingleCXP6x4AreaBayer x: 8
y: 1		 一台相机，四个端口，Bayer 格式
1 4 4 灰度 Acq_SingleCXP6x4AreaGray x: 16
y: 1		 一台相机，四个端口，灰度
1 4 4 RGB Acq_SingleCXP6x4AreaRGB x: 8
y: 1		 一台相机，四个端口，RGB
2 2 4 Bayer 格式 Acq_DualCXP6x2AreaBayer x: 8
y: 1		 两台相机，每台两个端口，Bayer 格式
2 2 4 灰度 Acq_DualCXP6x2AreaGray x: 16
y: 1		 两台相机，每台两个端口，灰度
2 2 4 RGB Acq_DualCXP6x2AreaRGB x: 4
y: 1		 两台相机，每台两个端口，RGB
4 1 4 Bayer 格式 Acq_QuadCXP6x1AreaBayer x: 4
y: 1		 四个相机，四个端口，Bayer 格式
4 1 4 灰度 Acq_QuadCXP6x1AreaGray x: 8
y: 1		 Four Cameras, Four Ports, Grayscale
4 1 4 RGB Acq_QuadCXP6x1AreaRGB x: 4
y: 1		 Four Cameras, Four Ports, RGB

所有面阵采集 Applets 的通用规格#
相机类型 CXP-6
镜像 是，水平和垂直
Event Generation 是
Image Selector 是
查找表 (LUT) Full resolution
Bandwidth Total DMA [MB/s] b 1800

不同面阵采集 Applets 之间的规格差异#

相机端口 [px] c ROI 步长 [像素] Bit Depth Processing [bit] Bit Depth Output [bit] Mode 白平衡 Bandwidth: Mean per Camera [MP/s]
Acq_DualCXP6x2AreaBayer 16k x 64k x: 8
y: 1		 14 per color component BGR 24, 30 packed, 36 packed, 42 packed, or 48 Bayer 格式 是 1200
Acq_DualCXP6x2AreaGray 64k x 64k x: 16
y: 1		 16 Grayscale 8, 10 packed, 12 packed, 14 packed, or 16 灰度 无 1200
Acq_DualCXP6x2AreaRGB 64k x 64k x: 4
y: 1		 16 per color component BGR 24, 30 packed, 36 packed, 42 packed, or 48 RGB 是 400
Acq_QuadCXP6x1AreaBayer 8k x 64k x: 4
y: 1		 14 per color component BGR 24, 30 packed, 36 packed, 42 packed, or 48 Bayer 格式 是 600
Acq_QuadCXP6x1AreaGray 64k x 64k x: 8
y: 1		 16 Grayscale 8, 10 packed, 12 packed, 14 packed, or 16 灰度 无 600
Acq_QuadCXP6x1AreaRGB 64k x 64k x: 4
y: 1		 16 per color component BGR 24, 30 packed, 36 packed, 42 packed, or 48 RGB 是 200
Acq_SingleCXP6x4AreaBayer 48k x 64k x: 8
y: 1		 14 per color component BGR 24, 30 packed, 36 packed, 42 packed, or 48 Bayer 格式 是 2400
Acq_SingleCXP6x4AreaGray 64k x 64k x: 16
y: 1		 16 Grayscale 8, 10 packed, 12 packed, 14 packed, or 16 灰度 无 2400
Acq_SingleCXP6x4AreaRGB 64k x 64k x: 8
y: 1		 16 per color component BGR 24, 30 packed, 36 packed, 42 packed, or 48 RGB 是 800

线阵采集 Applets#

提供以下线阵扫描 Acquisition Applets：

  • Acq_DualCXP6x2LineGray
  • Acq_DualCXP6x2LineRGB
  • Acq_QuadCXP6x1LineGray
  • Acq_QuadCXP6x1LineRGB
  • Acq_SingleCXP6x4LineGray
  • Acq_SingleCXP6x4LineRGB

Applet 名称中的分母“single”、“dual”和“quad”指您可以连接的最大相机数量。有关更多信息，请参见 Choosing the Right Line Scan Acquisition Applet。

选择正确的线阵采集 Applet#

您必须为相机设置选择正确的 applet。否则，相机可能无法工作，或者相机性能可能会显著降低。

哪种 applet 是正确的，取决于相机的数量、每台相机的通道数以及所需的 ROI 步长。

ROI 步长取决于图像预处理的并行度，因此随相机和图像采集卡而变化。

相机数量 相机端口数 采集卡端口数 Mode 小程序 ROI 步长 [像素] 拓扑
1 4 4 灰度 Acq_SingleCXP6x4LineGray x: 16
y: 1		 一台相机，四个端口，灰度
1 4 4 RGB Acq_SingleCXP6x4LineRGB x: 8
y: 1		 一台相机，四个端口，RGB
2 2 4 灰度 Acq_DualCXP6x2LineGray x: 16
y: 1		 两台相机，每台两个端口，灰度
2 2 4 RGB Acq_DualCXP6x2LineRGB x: 4
y: 1		 两台相机，每台两个端口，RGB
4 1 4 灰度 Acq_QuadCXP6x1LineGray x: 8
y: 1		 四台相机，每台一个端口，灰度
4 1 4 RGB Acq_QuadCXP6x1LineRGB x: 4
y: 1		 四台相机，每台一个端口，RGB

所有线阵采集 Applets 的通用规格#
Max. Image Size [px] 64k x 8Mc
相机类型 CXP-6
镜像 是，水平和垂直
Event Generation 是
Image Selector 是
Bayer Color Reconstruction (HQe) 无
查找表 (LUT) Full resolution
Bandwidth Total DMA [MB/s] b 1800

不同线阵采集 Applets 之间的规格差异#

Camera Ports ROI 步长 [像素] Bit Depth Processing [bit] Bit Depth Output [bit] Mode 白平衡 Bandwidth: Mean per Camera [MP/s]
Acq_DualCXP6x2LineGray 2 x: 16
y: 1		 16 Grayscale 8, 10 packed, 12 packed, 14 packed, or 16 灰度 无 1200
Acq_DualCXP6x2LineRGB 2 x: 4
y: 1		 16 per color component BGR 24, 30 packed, 36 packed, 42 packed, or 48 RGB 是 400
Acq_QuadCXP6x1LineGray 4 x: 8
y: 1		 16 Grayscale 8, 10 packed, 12 packed, 14 packed, or 16 灰度 无 600
Acq_QuadCXP6x1LineRGB 4 x: 4
y: 1		 16 per color component BGR 24, 30 packed, 36 packed, 42 packed, or 48 RGB 是 200
Acq_SingleCXP6x4LineGray 1 x: 16
y: 1		 16 Grayscale 8, 10 packed, 12 packed, 14 packed, or 16 灰度 无 2400
Acq_SingleCXP6x4LineRGB 1 x: 8
y: 1		 16 per color component BGR 24, 30 packed, 36 packed, 42 packed, or 48 RGB 是 800

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 文件（而不是以安装程序形式）收到的从小程序添加到主机文件系统中：

  1. 获取您收到的从小程序文件 (*.dll)。
  2. 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)。

  1. Framegrabber SDK 5.9 版本不支持 mE5 图像采集卡。 ↩

  2. 实际的 DMA 带宽取决于主机的特定主板和芯片组。 ↩↩

  3. 在此情况下，k Px 和 M Px 指二进制格式。二进制计算的示例如下：

    16M px = 16384k px = 16777216 px

    8M px = 8192k px = 8388608 px

    64k px = 65536 px

    48k px = 49152 px

    32k px = 32768 px

    16k px = 16384 px ↩↩