跳转到内容

imaWorx CXP-12 Quad 的 Acquisition Applets#

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

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

通过将 applet 加载到图像采集卡上，您可以定义图像采集卡的功能，并使其适应您的具体应用需求。

imaWorx CXP-12 Quad 的 Acquisition Applets 包含在 Framegrabber SDK 和 pylon Software Suite 中。

在 imaWorx CXP-12 Quad 上，所有随附的小程序（applet）均已预装在 imaWorx CXP-12 Quad 采集卡上，但默认仅激活一个。如果您想在 imaWorx CXP-12 Quad 上激活另一个小程序，请按照说明操作：使用 Framegrabber SDK 激活小程序或使用 pylon 配置采集卡。

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

要求#

  • 主机软件： Framegrabber SDK（5.9 或更高版本）或带有硬件相关采集小程序的 pylon Software Suite（6.3 或更高版本）
  • 硬件： 系统已连接 imaWorx CXP-12 Quad 采集卡

限制

在所有 applet 中，无法分配大于 4GB 的缓冲区。即使 applet 允许更大的缓冲区大小，由于驱动程序和固件中的限制，您也无法分配大于 4GB 的缓冲区。

您可以按如下方式计算缓冲区大小：

缓冲区大小 = 图像高度 * 图像宽度 * (像素位宽 / 8)。

对于 RGB 图像：缓冲区大小 = (图像高度 * 图像宽度 * (像素位宽 / 8)) * 3。

文档#

以下章节提供了指向 acquisition applets 文档的链接：

面阵 Acquisition 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

线阵 Acquisition 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

面阵 Acquisition Applets#

提供以下面阵 Acquisition Applets：

  • Acq_SingleCXP12Area
  • Acq_DualCXP12Area
  • Acq_TripleCXP12Area
  • Acq_QuadCXP12Area

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

选择合适的面阵 Acquisition 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

所有面阵 Acquisition Applets 的通用规格#
最大图像尺寸 [px] 32k x 64ke
相机端口 4
相机类型 CXP-12
Bit Depth Processing [bit] 16（Bayer Demosaicing 为 14）
像素格式 Mono8-16
RGB8-16
RGBa8
BGR8-16
BGRa8
Bayer8-14
YUV422_8
镜像 是，水平和垂直
图像选择器 是
Bayer Color Reconstruction (HQe) 是，High Quality Extended (HQe)
白平衡 是
查找表 (LUT) 完整分辨率
Pixel Format 转换 RGB 或 Bayer 转单色，
Bayer 或单色转 RGB
总 DMA 带宽 [MB/s] f 7200

面阵 Acquisition 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

线阵 Acquisition Applets#

提供以下 Line Scan Acquisition Applets：

  • Acq_SingleCXP12Line
  • Acq_DualCXP12Line
  • Acq_TripleCXP12Line
  • Acq_QuadCXP12Line

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

选择合适的线阵 Acquisition 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

所有线阵 Acquisition Applets 的通用规格#
最大图像尺寸 [px] 32k x 8Me
相机端口 4
相机类型 CXP-12
Bit Depth Processing [bit] 16（双色转 BGR/RGB 转换为 12 bit）
像素格式 Mono8-16
RGB8-16
RGBa8
BGR8-16
BGRa8
BiColor8-12
YUV422_8
镜像 是，水平和垂直
抽头几何结构排序 仅限 1X-1Y
图像选择器 是
彩色滤光片 是，双线双色 (BiColor)
白平衡 无
查找表 (LUT) 完整分辨率
Pixel Format 转换 RGB 或双色转单色，
单色或双色转 RGB
带宽：总 DMA [MB/s] f 7200

线阵 Acquisition 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 针对不同的内存大小和中断速率测试不同的图像尺寸
RAM Test 检查错误和处理
Check Camera Port Image Acquisition 检查相机端口图像采集
Send Trigger Signals to Camera 向相机发送触发信号
GPIO 监控 监控 GPI 并设置 GPO
事件测试 生成软件回调事件
常规监控 监控 FPGA 温度、电源管理、PoCXP 等

使用 Acquisition Applets#

在 Framegrabber SDK 中使用 Acquisition Applets#

在此可找到有关将 applet 与 Framegrabber SDK 配合使用的通用信息：Acquisition Applets。

安装 Applet#

在采集卡上使用特定的 applet 之前，必须将其安装到采集卡上。有关安装 applet 的说明，请参见 Managing Applets (microDiagnostics)。

手动添加 Applet#

若要将作为 *.dll 文件（而非安装程序形式）收到的 applet 添加到主机文件系统中：

  1. 获取您收到的 applet 文件（*.dll）。
  2. 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)。

结合 pylon 使用 Acquisition Applets#

如果您想结合 pylon 使用这些小程序，请参阅使用 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（仅限单通道相机）。 ↩