Operator IntFieldParamReference

Operator Library: Parameters

此运算符根据设计中任意位置的字段参数生成一个 1:1 映射参数（位于参数Field中）。您需要在参数Reference中指定被引用的参数（路径和名称）。

被引用的字段参数可以是以下类型之一：VA_SINTFIELD 或 VA_UINTFIELD。映射参数反映被引用参数的所有属性。

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

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

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

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

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

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

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

有关库参数的总体介绍，请参见 Library Parameters。

Example:

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

I/O Properties

财产 值
操作员类型 无（因为没有输入或输出）

Supported Link Format

无

参数

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

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

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

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

如果您希望在设计中的其他位置（除了引用运算符实例本身之外）授予对引用字段参数（在参数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

索引
键入 动态写入参数
默认 0
范围 UInt

在此处设置字段索引。

值
键入 动态、写入、读取参数
默认 0
范围 有符号整数（64 位），无符号整数（64 位）

设置或读取参数Index所指向的字段条目。

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/LUT.LUTContent）。

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

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

Yes = 已激活对引用参数的访问权限以及从引用参数的访问权限（通过映射参数 Value）。

No = 对引用参数的访问权限以及从引用参数的访问权限已被停用，且参数 Status 已禁用。参数 DisplayName 和 DisplayHierarchy 无效。

Examples of Use

以下示例展示了 IntFieldParamReference 运算符的用法：

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