Operator StringParamReference

Operator Library: Parameters

该算子会根据设计中任意位置的模块参数生成一个 1:1 的映射参数（位于参数 "Value" 中）。您需要在参数 "Reference" 中指定所引用的参数（路径和名称）。

所引用的参数可以是以下三种类型之一：VA_STRING、VA_FILENAME 或 VA_METADATA。映射参数始终为字符串。

您可以在设计层次结构中定义一个目标，以便在其中使引用的 参数可见并可访问。 目标由两个参数定义：DisplayHierarchy 和 DisplayName。 在 DisplayHierarchy 中，您寻址的是引用 operator 自身所在的 同一进程中的一个分层框。 在参数 DisplayName 中，您为目标参数设置名称。 如果同时设置了 DisplayHierarchy 和 DisplayName，则由 DisplayName 定义的参数将在 DisplayHierarchy 寻址的分层框中可用。 如果 DisplayName 为空，则不会创建任何参数。 如果设置了 DisplayName，但 DisplayHierarchy 为空， 则由 DisplayName 定义的参数将添加到父级层次结构（即引用 operator 自身所在的 分层框）中。

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

映射的参数本身也可以被引用。 因此，您可以引用 reference operator 中参数 Value 的内容， 或者引用您在参数 DisplayName 和 DisplayHierarchy 中定义的参数。 在由其他受保护的分层框构建受保护的 分层框时，这一点尤为重要。

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

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

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

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

示例：

映射参数 "CoeffFileParam" 现在可在 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
范围 有符号整数 (64 位)、无符号整数 (64 位)

用于从引用参数访问以及访问引用参数的 Map parameter。 此参数具有与引用参数相同的 Property。

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

Here, you define the position of the referenced parameter within the design.

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

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

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

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

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

使用示例

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

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