Operator IntParamSelector

Operator Library: Parameters

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

引用的参数可以属于以下三种类型之一：

  • VA_SINT：带符号整数，例如算子 CONST 中的参数 Value。

  • VA_UINT：无符号整数，例如算子 SCALE 中的参数 ScaleFactor。

  • VA_ENUM：枚举，例如算子 SetSignalStatus 中的参数 mode。

映射参数本身始终为 Int64 类型。映射参数会镜像当前所选引用参数的所有 Property。

如果您想引用使用完整 64 位的无符号参数，则需要根据 Int64 类型对该值进行重新解释。

您可以在设计层级中定义一个目标，所选参数在该目标中将可见且可访问。该目标由两个参数定义：DisplayHierarchy 和 DisplayName。在 DisplayHierarchy 中，您可以寻址引用算子本身所在的同一进程内的分层框（hierarchical box）。在参数 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
范围 有符号整数 (64 位)、无符号整数 (64 位)

用于访问所选参数及被所选参数访问的映射参数。该参数具有与当前所选参考参数相同的 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 不起作用。

使用示例

以下示例展示了算子 IntParamSelector 的使用方法：

  • 'Parameter Selection'

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

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