VisualApplets
Operator Reference

Operator Library: Memory

该算子允许将图像文件从主机 PC 上传到采集卡，以便连续输出并用作图像源。此处，图像文件被用作通用的数据容器。因此，上传的图像可以包含任意数据，例如系数值。所有系数图像必须具有相同的像素宽度和高度，但可以采用完全不同的格式。例如，链路 0 的系数图像可以采用 GRAY 8 位格式，链路 1 可以提供 RGB16 格式的图像，而链路 2 可以是二值图像。所有系数图像均存储在 Frame Grabber RAM (DRAM) 中。这需要一个类型为 RAM 的 VisualApplets 资源。有关更多信息，请参阅 'Allocation of Device Resources'。有关算子延迟的信息，请参阅 Table 46, 'Individual Latencies of the Operators in Library Memory'。

	CoefficientBuffer 不适用于 imaFlex CXP-12 Quad 和 imaFlex CXP-12 Penta 平台
	imaFlex CXP-12 Quad 和 imaFlex CXP-12 Penta 平台不支持 CoefficientBuffer。'Functional Example for Loading Test Images Using ImageInjector' 示例展示了如何在 imaFlex CXP-12 Quad 或 imaFlex CXP-12 Penta 上使用 ImageInjector 算子替代 CoefficientBuffer 算子作为测试图像源的功能。 '2D Shading Correction / Flat Field Correction Using Operator RamLUT' 示例展示了如何在二维 Shading Correction 中使用 RamLUT 代替 CoefficientBuffer。

链路数量对应于存储在 CoefficientBuffer 中的系数图像数量。在没有运行图像采集时，只能通过软件将系数图像上传到 FPGA 缓冲区中。这可以通过写入参数 LoadCoefficients 来完成。

该算子的输出端口同步工作。第一个图像像素的传输在所有输出端口上完全同时开始。如果所有图像都已传输到接收算子，CoefficientBuffer 将再次开始同步输出图像。

	仿真期间的行为
	算子链路上的图像是同时输出的。在一个仿真步中，算子在每个链路上最多输出一个图像。如果在仿真步期间，所有存储的图像（每个链路一个）都已转发给接收算子（即未发生阻塞），则相同的输出（每个链路一个）将在接下来的仿真步中继续转发。

CoefficientBuffer 还支持感兴趣区 (RoI) 管理。RoI 由 4 个参数定义：XOffset、XLength、YOffset 和 YLength。XOffset 和 YOffset 定义 RoI 的左上角，即以像素为单位的起始坐标。RoI 的尺寸不得超过由参数 BufferWidth 和 BufferHeight 定义的存储系数图像的尺寸。可以在采集期间动态更新 RoI，或者在未运行采集时，通过将所有 4 个 RoI 坐标参数设置为新值并写入参数 UpdateROI 来更新。请注意，XLength 还必须满足链路 Parallelism 的粒度，即 XLength 模 LinkParallelism 等于 0。

对于每个输出链路，缓冲区中都会存储一个系数图像文件，即在链路 0 上提供系数图像 0。必须在采集开始之前将系数图像加载到 CoefficientBuffer 中。系数图像必须存储在由参数 CoefficientFile N 指定的文件中。N 分别代表链路编号或系数图像编号。系数文件必须采用 TIF 格式编码。

BufferWidth 以像素为单位指定存储在 CoefficientBuffer 中的所有系数图像的宽度。

BufferHeight 以像素为单位指定由 CoefficientBuffer 管理的所有系数图像的高度。BufferWidth 和 BufferHeight 决定了所有输出链路的最大输出图像尺寸。

对于灰度链路，必须使用灰度图像文件。对于彩色链路，必须使用 RGB 图像文件。

如果链路的 Bit Width 高于图像文件的 Bit Width，算子将使用多个图像文件像素来生成输出像素。例如，22 位链路将需要 8 位图像文件中的 3 个像素。因此，图像文件的图像宽度必须比参数 BufferWidth 大 3 倍。

如果链路的 Bit Width 低于图像文件的 Bit Width，算子将仅使用输入图像文件的低位。例如，8 位图像文件和 3 位链路将使用文件的第 0 位、第 1 位和第 2 位。

应谨慎使用 16 位 TIF 文件。

参数 LoadCoefficients 用于在图像采集开始之前将系数图像加载到缓冲区中。加载操作由写入周期的写操作或向该参数写入值 1 触发。写入值 0 无效。

参数 UpdateROI 用于在图像采集正在运行或未抓取图像时动态更新当前的 RoI。在写入此参数之前，必须通过 4 个 RoI 坐标参数指定新的 RoI。写入的值不影响更新过程，只有写周期才会触发它，即写入的值可以为 0 或 1。

参数 XOffset 指定从左图像边界到 RoI 第一列的水平方向偏移量。指定的值以像素为单位进行测量，且不得超过 BufferWidth-1 值。

Parameter XLength specifies the length of the RoI in horizontal direction in pixels. The specified value must not exceed BufferWidth and must be divisible by the output link parallelism. Also the following constraint must be met: XOffset + XLength <= BufferWidth.

参数 YOffset 指定从顶部图像边界到 RoI 第一行的垂直方向偏移量。YOffset 必须以像素为单位指定，且不得超过 BufferHeight-1。

Parameter YLength specifies the length of the RoI in vertical direction in pixels. The length must not exceed BufferHeight. Furthermore, the following constraint must be met: YOffset + YLength <= BufferHeight.

参数 CoefficientFile N 指定以 TIF 格式存储的用于链路 N 的系数图像的文件名。

注意

链路 0 的 Parallelism 决定了所有其他链路的 Parallelism。 设置链路 0 的 Parallelism 会修正 XLength 值，使其能被新的 Parallelism 整除。这在未来的 VA 版本中可能会以不同的方式处理。这意味着，当使用链路 Parallelism 属性微调框中的向上/向下按钮时，XLength 可能会被修改。因此，建议在连接并指定所有链路后检查 XLength 设置。 如果参数 BufferWidth 和 BufferHeight 中的任何一个超过了新的图像尺寸，设置它们将会修正 RoI 坐标。坐标将被修正为最接近的可能有效值。 CoefficientBuffer 支持 2D、1D 和 0D 图像。对于 1D 和 0D 图像，算子将连续提供作为 2D 图像存储的系数图像，而不会生成帧结束或行结束标记。 该算子正在使用 1 个 DDRRAM 组。因此，每个算子用于系数字像的存储空间受限于一个 RAM 组的容量（例如，mE5 板卡上的 256MByte）。此外，由于 DDRRAM 的内部格式化，实际存储空间可能会略小于物理存储空间。已用存储空间分别与链路格式以及每个链路的像素宽度相关。在理想情况下，所有链路像素宽度的总和可以被一个 RAM 组的容量（即 mE5 上的 256）整除。在这种情况下，所有系数字像可以一起存储在一个 Memory 组中。在任何其他情况下，存储空间的使用将不是最优的。有关硬件平台的更多信息，请查看 Device Resources。

带宽优化

流经使用 采集卡 RAM (DRAM) 的算子的理论带宽 [bits/second] 根据以下公式计算：

然而，由于 DRAM 效率的限制，实际带宽总是小于理论带宽。

当 Bit Width 和 Parallelism 的乘积等于内部 RAM 端口宽度 x 2（适用于只读参数）时，通过运算符的 最大带宽 达到最大值。

	平台特定值
	RAM Port Width 和 System Clock 是平台相关的。 请参阅 Device Resources 以获取有关您各个平台的详细信息。

Supported Link Format

Link Parameter	输出链路 O[n]
Bit Width	[1, 64]
Arithmetic	{unsigned, signed}
Parallelism	any
Kernel Columns	1
Kernel Rows	1
Img Protocol	{VALT_IMAGE2D, VALT_LINE1D, VALT_PIXEL0D}
Color Format	any
Color Flavor	any
Max. Img Width	BufferWidth
Max. Img Height	BufferHeight

	对于无符号输入，输出 bit width 的范围是 [1, 64]。对于有符号输入，范围是 [2, 64]。对于无符号彩色输入，范围是 [3, 63]，对于有符号彩色输入，范围是 [6, 63]。
	bit width 和 Parallelism 的乘积不得超过原生 RAM 数据宽度。请查看 Device Resources 了解更多信息。