Operator FloatParamSelector

Operator Library: Parameters

此算子在参数 Value 中生成一个映射参数。您可以通过参数 Select 在设计中任意位置的几个模块参数之间切换此映射参数。要在参数 References 中指定引用参数的路径和名称，请添加以分号分隔的列表。

引用的参数必须为 VA_DOUBLE 类型。映射参数会镜像当前选定引用参数的所有 Property。

您可以在设计层级中定义一个目标，选定的参数在该目标中将可见且可访问。 该目标由两个参数定义：DisplayHierarchy 和 DisplayName。 在 DisplayHierarchy 中，您可以寻址引用算子本身所在的同一进程内的分层框。 在参数 DisplayName 中，您可以设置目标参数的名称。这意味着：

  • 如果同时设置了 DisplayHierarchy 和 DisplayName，则由 DisplayName 定义的参数将在由 DisplayHierarchy 指定的分级框中可用。
  • 如果 DisplayName 为空，则不会创建任何参数。
  • 如果设置了 DisplayName，但 DisplayHierarchy 为空，则由 DisplayName 定义的参数将添加到父级层级结构中（即引用算子本身所在的分级框）。

这允许您使选定的参数在设计所需的任何分层级别上可用。 例如，您可以使受保护分层框内的模块参数直接在受保护分层框自身的 Property 下进行参数化。

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

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

如果更改了其中一个连接的参数（即选定的参数、映射参数 Value 或显示目标参数），则所有其他连接参数中的值也会随之更改。

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

您可以在此处找到有关该库的总体介绍 Parameters in Library Parameters.

I/O Property

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

Supported Link Format

无

参数

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

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

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

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

如果您想在设计中的另一个位置授予对参数 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, the 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

Select
键入 静态、动态、写入参数
默认 0
范围 取决于引用参数的数量

用于在参考参数之间进行切换的选择器。

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

用于访问选定参数以及从选定参数访问的映射参数。 此参数具有与当前选定的引用参数相同的 Property。

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

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

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

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

参考
键入 静态写参数
默认 无
范围 在以分号分隔的列表中定义引用参数的字符串：模块的相对路径、模块名称和参数名称

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

对于此参数，您可以使用自动完成功能和语法高亮显示。要使用自动完成功能，请点击 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 (i.e. an operator instance or a hierarchical box) that contains the referenced parameter.

<ParamName> is the 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/SetParam.Value）。

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

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

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

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

使用示例

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

  • 'Parameter Selection'

    示例 - 演示如何使用参数转换算子 IntParamSelector 和 FloatParamSelector。

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