Operator FloatFieldParamReference

Operator Library: Parameters

该算子根据设计中任意位置的 Field 参数生成 1:1 的映射参数（位于参数 Field 中）。您可以在参数 Reference 中指定引用的参数（路径和名称）。

引用的 Field 参数可以属于 VA_DOUBLEFIELD 类型之一。映射参数会镜像引用参数的所有属性。

Since there are no field parameters specified in the GenICam standard, the created GenICam API and the created Framegrabber API code (FgLib) vary on this point. In the GenICam API code, the two parameters <DisplayName>_Index und <DisplayName>_Value are created.

您可以在设计层级中定义一个目标，以便引用参数在该目标处可见且可访问。 该目标由两个参数定义：DisplayHierarchy 和 DisplayName。 在 DisplayHierarchy 中，您可以寻址引用算子本身所在的同一进程内的分层框。 在参数 DisplayName 中，您可为目标参数设置名称。 如果同时设置了 DisplayHierarchy 和 DisplayName，则由 DisplayName 定义的参数将在 DisplayHierarchy 寻址的分层框中可用。 如果 DisplayName 为空，则不会创建参数。 如果设置了 DisplayName 但 DisplayHierarchy 为空， 则由 DisplayName 定义的参数将添加至父层级（即引用算子本身所在的分层框）。

这使您能够在设计的任何所需层级上使用设计中的 Field 参数。例如，您可以将受保护的分层框内模块的 Field 参数直接在受保护的分层框本身的 Property 下进行参数化。

映射参数本身也可以被引用。因此，您既可以在引用算子中引用参数 Field 的内容，也可以引用您在参数 DisplayName 和 DisplayHierarchy 中定义的参数。当受保护的分层框由其他受保护的分层框构建而成时，这一点尤为重要。

[注] 所有连接的参数会同时更新

如果其中一个连接的参数发生更改（引用参数、映射参数 Field 或目标参数），则所有其他连接参数中的值也会随之更改。

由于该算子不干预设计的数据流结构，因此它没有输入和输出。

有关库 Parameters 的一般介绍，请参见 Library Parameters。

示例：

映射参数 TransformCoeff 现在可在 Process0/Level0/Level1 中使用：

I/O Properties

Property 值
Operator Type 无（因为没有输入或输出）

支持的 Link Format

无

参数

状态
键入 静态读取（尽管 GUI 显示为写入）参数
默认 无
范围 OK 或错误消息

显示错误状态。如果参数 Activate 设为 Yes， 则会检查其他模块参数。 该参数显示此检查的结果， 即 OK 或错误消息。

此参数不是最终 Applet 的一部分。

DisplayName
键入 静态写入参数
默认 无
范围 任意字符串

如果您希望在设计中的另一个位置（除引用算子实例本身之外）授予对引用 Field 参数（在参数 Reference 中定义）的访问权限，则需要定义一个新参数。请在此处指定此新参数的名称。

如果此字段为空，则不会创建新参数。

DisplayHierarchy
键入 静态写入参数
默认 无
范围 任意字符串

在此处指定您要附加在参数 DisplayName 中定义的新映射参数的分层框。

对于此参数，您可以使用自动完成功能和语法高亮显示。要使用自动完成功能，请单击 Module Properties 对话框中此参数的 Parameter Values 字段， 并按键盘上的 TAB 键。有关自动完成功能的更详细说明， 请访问 'Autocompletion and Syntax Highlighting for Translator and Reference Operators'。

如果您定义了新参数 DisplayName， 但将参数 DisplayHierarchy 留空：新参数将 添加至包含引用算子实例的分层框。 （请注意，如果引用算子实例 位于最高（进程）级别，则无法执行此操作。）

[注] 设置显示目标路径的语法

如果您希望新参数显示在设计的其他位置， 则需要在参数 DisplayHierarchy 中指定包含新参数的分层框的路径。

语法如下：

<Path> is the relative path from process level to the hierarchical level of the design where the <Hierarchical Box> is located that is to receive the new parameter. Thus, parameter DisplayHierarchy can only address hierarchical boxes within the same process. Use a slash as separator between different hierarchical levels.

<HierarchicalBox> is the name of the hierarchical box that is to receive the new map parameter.

示例： Level0/Level1

索引
键入 dynamic write parameter
默认 0
范围 UInt

在此处设置 Field 索引。

值
键入 dynamic, write, read parameter
默认 0
范围 有符号整数（64 位）、无符号整数（64 位）

设置或读取由参数 Index 寻址的 Field 条目。

Field
键入 static,dynamic, write, read parameter
默认 无
范围 array

用于访问引用 Field 参数的映射参数。该参数镜像引用 Field 参数的所有属性。

描述
键入 静态写入参数
默认 -
范围 任意文本

在此输入参数 Value 的描述。

Reference
键入 静态写入参数
默认 无
范围 定义引用参数的任意字符串：模块的相对路径、模块名称和参数名称

在此处，您可以定义引用参数在设计中的位置。

对于此参数，您可以使用自动完成功能和语法高亮显示。要使用自动完成功能，请单击 Module Properties 对话框中此参数的 Parameter Values 字段， 并按键盘上的 TAB 键。有关自动完成功能的更详细说明， 请访问 'Autocompletion and Syntax Highlighting for Translator and Reference Operators'。

[注] 引用语法

语法如下：

<Path> is the relative path to the hierarchical level where the referenced module "Module" is located. Use a slash as separator between different hierarchical levels. Define the path as relative path from the hierarchical level the reference operator instance is located in.

<Module> is the name of the module (operator instance or hierarchical box) that contains the referenced parameter.

<ParamName> is the actual name of the referenced parameter.

If <Path> starts with a slash, the path is interpreted as absolute path starting from design level (e.g., /Process0/UUT/Transform.Coefficients）。

您还可以使用 ../ 以返回上一级。
不过，在设计可自由复制或可重定位的模块时，请注意不要使用此选项。

激活
键入 dynamic write parameter
默认 无
范围 {No,Yes}

Yes = 激活对引用参数的访问以及来自引用参数的访问（通过 map 参数 Value）。

No = 禁用对引用参数的访问以及来自引用参数的访问，并将参数 Status 设为 disabled。
参数 DisplayName 和 DisplayHierarchy 无效。

使用示例

以下示例展示了 FloatFieldParamReference 算子的用法：

  上一页     返回上级     下一步  
内容 顶部 主页