Operator IntFieldVariable

Operator Library: Parameters

The IntFieldVariable operator generates a software variable field.

You can define a target within the design hierarchy where the variable will be visible and accessible. The target is defined by two parameters: DisplayHierarchy and DisplayName. In DisplayHierarchy you address a hierarchical box within the same process the operator itself is located in. With the DisplayName parameter, you set up the name for the target parameter. If DisplayHierarchy and DisplayName are both set, the parameter defined by DisplayName will be available in the hierarchical box addressed by DisplayHierarchy. If DisplayName is empty, no parameter is created. If DisplayName is set, but DisplayHierarchy is empty, the parameter defined by DisplayName is added to the parent hierarchy (i.e., the hierarchical box the operator itself is located in).

The operator has no inputs and outputs, because it doesn't interfere with the data flow structure of the design.

For a general introduction into the Parameters library, see Library Parameters.

I/O Properties

Property
Operator Type None, since there are no inputs or outputs.

Supported Link Format

参数

状态
键入 static read (although the GUI displays write) parameter
默认 none
范围 OK or error message

Displays the error status. If the Activate parameter is set to Yes, the other module parameters are checked. This parameter displays the result of this check, i.e. either OK or an error message.

This parameter is not part of the final applet.

DisplayName
键入 static write parameter
默认 none
范围 any string

If you want to grant access from and to the parameter at another point in the design (in addition to the operator instance itself), you need to define a new parameter. Specify here the name of this new parameter.

If this field is empty, no new parameter is created.

DisplayHierarchy
键入 static write parameter
默认 none
范围 any string

Specify here the hierarchical box to which you want to attach the new map parameter you defined with the DisplayName parameter.

For this parameter, you can use the autocompletion functionality and syntax highlighting. To use autocompletion, click into the Parameter Values field of this parameter in the Module Properties dialog, and press the TAB key of your keyboard. More detailed instructions for the autocompletion functionality are available at 'Autocompletion and Syntax Highlighting for Translator and Reference Operators'.

If you defined a new DisplayName parameter, but leave the DisplayHierarchy parameter empty: The new parameter is added to the hierarchical box that contains the operator instance. This is not possible if the operator instance is located on the highest (process) level.

[Note] Syntax for Setting up Path to Display Target

If you want the new parameter to show up in another place of the design, you need to specify the path to the hierarchical box that is to contain the new parameter in the DisplayHierarchy parameter.

The syntax is as follows:

<Path> is the relative path from the process level to the level of the design where the <Hierarchical Box> is located which will get the new parameter. Thus, the DisplayHierarchy parameter 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.

Example: Level0/Level1

大小
键入 static, dynamic, write, read parameter
默认 0
范围 Unsigned integer (31 bit)

With this parameter you can define the number of field entries.

ColumnCount
键入 static write, read parameter
默认 0
范围 [1,256]

With this parameter you can define the number of columns for entering field values in the module properties dialog.

Index
键入 dynamic write parameter
默认 0
范围 UInt

With this parameter you can set the field index here.

键入 dynamic, write, read parameter
默认 0
范围 Signed integer (64 bit)

With this parameter you can set or read the field entry addressed by the Index parameter.

Field
键入 static,dynamic, write, read parameter
默认 none
范围 array

This field parameter defines the content of the variable field.

Unit
键入 static write parameter
默认 -
范围 Latin-1

Enter here the unit for the Value parameter.

描述
键入 static write parameter
默认 -
范围 any text

Enter here the description for the Value parameter.

RangeFrom
键入 static write parameter
默认 0
范围

With this parameter you can define the smallest valid value. You can also enter a formula here.

RangeTo
键入 static write parameter
默认 255
范围

With this parameter you can define the biggest valid value. You can also enter a formula here.

RangeIncrement
键入 static write parameter
默认 1
范围

With this parameter you can define the interval between valid values (definition of step size). You can also enter a formula here.

Activate
键入 dynamic write parameter
默认
范围 {No,Yes}

Yes = Access to and from the variable is activated via the Value map parameter.

No = Access to and from the variable is de-activated and the Status parameter is disabled. The DisplayName and DisplayHierarchy parameters have no effect.