Operator FloatParamReference

Operator Library: Parameters

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

被引用的参数类型为 VA_DOUBLE。映射参数会镜像引用参数的所有 Property，其类型同样为 VA_DOUBLE。

您可以在设计层级结构中定义一个目标，选定的参数将在该目标处可见并可访问。该目标由两个参数定义： DisplayHierarchy和DisplayName。DisplayHierarchy参数用于指定引用运算符所在流程中的层级结构。DisplayName参数用于设置目标参数的名称。如果DisplayHierarchy和DisplayName都已设置，则 DisplayName定义的参数将在DisplayHierarchy指定的层级结构中可用。如果DisplayName为空，则不会创建参数。如果DisplayName已设置但DisplayHierarchy为空，则DisplayName定义的参数将添加到父层级结构（即引用运算符所在的层级结构）。

这样，您可以将设计中的某个参数置于设计的任何层级。例如，您可以将受保护层级框内模块的参数直接置于该受保护层级框本身的属性中，以便进行参数化。

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

[注意] 所有相关参数同时更新

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

该运算符没有输入和输出，因为它不会干扰设计的数据流结构。

您可以在“库参数”中找到有关库参数的一般介绍。

示例：

映射参数“WB_Red”现已在Process0/Level0/Level1中可用：

I/O Property

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

Supported Link Format

无

参数

状态
键入 静态读取（尽管 GUI 显示为写入）参数
默认 没有任何
范围 成功或错误信息

显示错误状态。如果参数“激活”设置为“是” ，则会检查其他模块参数。此参数显示检查结果，即“正常”或错误消息。

此参数不包含在最终的小程序中。

显示名称
键入 静态写参数
默认 没有任何
范围 任何字符串

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

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

显示层级
键入 静态写参数
默认 没有任何
范围 任何字符串

在此处指定您要附加在参数 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

值
键入 static, dynamic, write, read parameter
默认 0
范围 double

用于访问引用参数以及从引用参数进行访问的映射参数。 此参数镜像引用参数的所有 Property。

单位
键入 静态写参数
默认 -
范围 Latin-1

在此处输入参数 Value 的单位。

描述
键入 静态写参数
默认 -
范围 any text

在此处输入参数 Value 的描述。

Reference
键入 静态写参数
默认 没有任何
范围 any string defining the referenced parameter: relative path to module, module name, and parameter name

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

对于此参数，您可以使用自动完成功能和语法高亮显示。要使用自动完成功能，请点击 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/WhiteBalance.RedCoefficient）。

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

Activate
键入 动态写入参数
默认 无
范围 {No,Yes}

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

No = 停用对引用参数的访问和来自引用参数的访问，并禁用参数 Status。 参数 DisplayName 和 DisplayHierarchy 无效。

使用示例

以下示例展示了运算符 FloatParamReference 的使用：

  上一页     上一层     下一步  
内容 顶部 主页