跳转到内容

针对 imaWorx CXP-12 Quad 的 Acquisition Applets#

本主题为您介绍适用于 imaWorx CXP-12 Quad 采集卡的采集 Applet。

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

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

imaWorx CXP-12 Quad 的采集 Applet 包含在 Framegrabber SDK 以及 pylon Software Suite 中。

在 imaWorx CXP-12 Quad 上，所有随附的 applet 都已预装在 imaWorx CXP-12 Quad 采集卡上，但默认只激活了一个。如果您想在 imaWorx CXP-12 Quad 上激活其他 applet，请按照以下说明操作：使用 Framegrabber SDK 激活 Applet 或使用 pylon 配置采集卡。

除了 Acquisition Applets 之外，您还可以使用 Enhanced Applets。Enhanced Applets 属于原型，仅可通过您当地的 Basler 销售代表或现场应用工程师按需获取。所有 Enhanced Applets 都具备以下附加功能：

要求#

  • 宿主机软件：Framegrabber SDK（5.9 或更高版本）或 pylon Software Suite（6.3 或更高版本），并配备硬件相关的 acquisition applet
  • 硬件：系统中已连接一块 imaWorx CXP-12 Quad 采集卡

限制

在所有 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#

GenTL Fglib
Acq_SingleCXP12Area PDF Acq_SingleCXP12Area PDF
Acq_DualCXP12Area PDF Acq_DualCXP12Area PDF
Acq_TripleCXP12Area PDF Acq_TripleCXP12Area PDF
Acq_QuadCXP12Area PDF Acq_QuadCXP12Area PDF

线阵采集 Applets#

GenTL Fglib
Acq_SingleCXP12Line PDF Acq_SingleCXP12Line PDF
Acq_DualCXP12Line PDF Acq_DualCXP12Line PDF
Acq_TripleCXP12Line PDF Acq_TripleCXP12Line PDF
Acq_QuadCxp12line PDF Acq_QuadCxp12line PDF

Frame Grabber Test Applet#

GenTL Fglib
Frame Grabber Test Applet PDF Frame Grabber Test Applet PDF

面阵采集 Applets#

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

  • Acq_SingleCXP12Area
  • Acq_DualCXP12Area
  • Acq_TripleCXP12Area
  • Acq_QuadCXP12Area

Applet 名称中的分母“single”、“dual”、“triple”和“quad”是指您可以连接的最大相机数量。有关更多信息，请参阅选择正确的面阵采集 Applet。

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

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

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

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

最大相机数量 1 通道相机数量 2 通道相机数量 4 通道相机数量 小程序 ROI 步长 [像素]
4 1 Acq_QuadCXP12Area x: 8
y: 1
4 2 Acq_QuadCXP12Area x: 8
y: 1
4 3 Acq_QuadCXP12Area x: 8
y: 1
4 4 Acq_QuadCXP12Area x: 8
y: 1
3 1 Acq_TripleCXP12Areaa x: 16/8/8
y: 1
3 2 Acq_TripleCXP12Areaa x: 16/8/8
y: 1
3 3 Acq_TripleCXP12Areaa x: 16/8/8
y: 1
3 1 Acq_TripleCXP12Areab x: 16/8/8
y: 1
3 1 1 Acq_TripleCXP12Area x: 16/8/8
y: 1
3 2 1 Acq_TripleCXP12Area x: 16/8/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_DualCXP12Areac x: 16
y: 1
2 2 Acq_DualCXP12Area x: 16
y: 1
1 1 Acq_SingleCXP12Areaa x: 32
y: 1
1 1 Acq_SingleCXP12Aread x: 32
y: 1
1 1 Acq_SingleCXP12Area x: 32
y: 1

所有面阵采集 Applets 的通用规格#
Max. Image Size [px] 32k x 64ke
Camera Ports 4
相机类型 CXP-12
Bit Depth Processing [bit] 16 (Bayer Demosaicing 为 14)
像素格式 Mono8-16
RGB8-16
RGBa8
BGR8-16
BGRa8
Bayer8-14
YUV422_8
镜像 是，水平和垂直
Image Selector 是
Bayer Color Reconstruction (HQe) Yes, High Quality Extended (HQe)
白平衡 是
查找表 (LUT) Full resolution
Pixel Format 转换 RGB 或 Bayer 转单色，
Bayer 或单色转 RGB
总带宽 DMA [MB/s] f 7200

不同面阵采集 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_TripleCXP12Area x: 8
y: 1		 前两台相机为 1200
第三台相机为 2400		 仅限 1X-1Y
Acq_QuadCXP12Area x: 8
y: 1		 1200 仅限 1X-1Y

线阵采集 Applets#

提供以下线阵扫描 Acquisition Applets：

  • Acq_SingleCXP12Line
  • Acq_DualCXP12Line
  • Acq_TripleCXP12Line
  • Acq_QuadCXP12Line

小程序名称中的分母“single”、“dual”、“triple”和“quad”指的是可连接的最大相机数量。有关详细信息，请参阅 Choosing the Right Line Scan Acquisition Applet。

选择正确的线阵采集 Applet#

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

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

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

最大相机数量 1 通道相机数量 2 通道相机数量 4 通道相机数量 小程序 ROI 步长 [像素]
4 1 Acq_QuadCXP12Line x: 8
y: 1
4 2 Acq_QuadCXP12Line x: 8
y: 1
4 3 Acq_QuadCXP12Line x: 8
y: 1
4 4 Acq_QuadCXP12Line x: 8
y: 1
3 1 Acq_TripleCXP12Lineg x: 16/8/8
y: 1
3 2 Acq_TripleCXP12Lineg x: 16/8/8
y: 1
3 3 Acq_TripleCXP12Lineg x: 16/8/8
y: 1
3 1 Acq_TripleCXP12Lineh x: 16/8/8
y: 1
3 1 1 Acq_TripleCXP12Line x: 16/8/8
y: 1
3 2 1 Acq_TripleCXP12Line x: 16/8/8
y: 1
2 1 Acq_DualCXP12Lineg x: 16
y: 1
2 2 Acq_DualCXP12Lineg x: 16
y: 1
2 1 Acq_DualCXP12Line x: 16
y: 1
2 1 1 Acq_DualCXP12Linei x: 16
y: 1
2 2 Acq_DualCXP12Line x: 16
y: 1
1 1 Acq_SingleCXP12Line x: 32
y: 1
1 1 Acq_SingleCXP12Line x: 32
y: 1
1 1 Acq_SingleCXP12Line x: 32
y: 1

所有线阵采集 Applets 的通用规格#
Max. Image Size [px] 32k x 8Me
Camera Ports 4
相机类型 CXP-12
Bit Depth Processing [bit] 16（BiColor 转 BGR/RGB 转换为 12 bit）
像素格式 Mono8-16
RGB8-16
RGBa8
BGR8-16
BGRa8
BiColor8-12
YUV422_8
镜像 是，水平和垂直
点击几何排序 仅限 1X-1Y
Image Selector 是
彩色滤光片阵列 是，两行 BiColor
白平衡 无
查找表 (LUT) Full resolution
Pixel Format 转换 RGB 或 BiColor 转单色，
单色或 BiColor 转 RGB
带宽：总 DMA [MB/s] f 7200

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

ROI 步长 [像素] Bandwidth: Mean per Camera [MP/s]
Acq_SingleCXP12Line x: 32
y: 1		 4850
Acq_DualCXP12Line x: 16
y: 1		 2400
Acq_TripleCXP12Line x: 16
y: 1		 前两台相机为 1200
第三台相机为 2400
Acq_QuadCXP12Line x: 4
y: 1		 1200

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#

在 Framegrabber SDK 中使用 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)。

Using Acquisition Applets with pylon#

如果您想在 pylon 中使用这些 applet，请参阅使用 pylon 配置采集卡。

  1. 仅在需要镜像像素超过 8K 的图像时建议使用。否则，请使用 QuadCXP12Area。 ↩↩↩↩↩↩

  2. 不建议使用，请改用 DualCXP12Area。 ↩

  3. 仅在需要镜像像素超过 8K 的图像时建议使用。否则，请使用 TripleCXP12Area（仅限单通道相机）。 ↩

  4. 仅在需要镜像像素超过 21840 的图像时建议使用。否则，请使用 DualCXP12Area。 ↩

  5. 在此情况下，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 ↩↩

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

  7. 仅在需要镜像超过 8K 像素的图像时推荐使用。否则，请使用 QuadCXP12Line。 ↩↩↩↩↩

  8. 不推荐，请改用 DualCXP12Line。 ↩

  9. 仅在需要镜像超过 8K 像素的图像时推荐使用。否则，请使用 TripleCXP12Line（仅限单通道相机）。 ↩