Linear Gaugedis_lineargauge.png

Displays the connected variable on a vertical or horizontal linear scale.

It can optionally be configured to support user input to set the value of the associated variable, or a new value can be set by dragging the gauge handle to a new position.

A Linear Gauge with 2 color zones and displaying the variable value:

dis_lineargauge2.png 

A linear gauge using a background image:

dis_lineargauge3.png 

Geometrylineargaugeprop1.png

See Geometry.

Gauge Dimensions

Gauge Top/Left Corner

Position of the top left corner of the gauge within the widget. This is specified as a comma separated pair of values: x,y.

Gauge Length

Length of the gauge in pixels.

Visual Properties lineargaugeprop2.png

Orientation

Orientation, either vertical or horizontal, of the gauge.

Show Scale

Show the labels and associated tick marks.

Show Value

Show the value of the associated variable.

Bar Width

Width in pixels for the gauge’s bar.

Ticks

Number of major ticks along the gauge.

Minor Ticks

Number of minor ticks between major ticks.

Indicator Width

Width in pixels for the gauge’s indicator.

Indicator Offset from Scale

Distance in pixels from the gauge’s bar to start drawing the indicator.

Indicator Length

Length in pixels of the indicator.

Tick Length

Length in pixes of the major ticks. Minor ticks are half this size.

Start Label

Value of the first scale label.

Number of Labels

Number of labels to draw along the scale.

Label Spacing

Distance separating successive label values measured in units of the associated variable.

Value Position

Position of the value specified as a comma separated pair of values: x,y.

Backgroundlineargaugeprop3.png

Image

File image to display in the background of the widget.

Fonts

Label Font

Font of the labels.

Value Font

Font of the value when shown.

Formats

Scale

printf” style numerical format used to format the gauge’s scale labels. HTML tags are not supported.

Value

printf” style numerical format used to format the value. HTML tags are not supported.

Colorslineargaugeprop4.png

Background Color

Background color of the widget. Click on the x button to set null background color. When a null background is selected, the background of the HMI display itself is visible behind the active elements of the widget.

Background Transparency

The transparency of the widget background. This applies to the background image as well when a background image is specified. This is a number between 0.0 (completely transparent) and 1.0 (completely opaque).

Bar Color

Color of the gauge’s bar.

Indicator Color

Color of the gauge’s indicator.

Label Color

Color of the labels.

Tick Color

Color of the ticks.

Value Color

Color of the value.

Expected Value Range

Maximum Value

Maximum expected value for the connected variable. This is the highest value displayed by the gauge.

Minimum Value

Minimum expected value for the connected variable. This is the lowest value displayed by the gauge.

Scale

Numeric scaling factor to multiply the value of the labels when we draw them. I.e for a tachometer, use 0.001 so that the label will show as 1,2,3,... when the value is 1000,2000,3000,....

User Inputlineargaugeprop5.png

Allows entering a new value for the associated variable.

 To set a new value for the variable, click the mouse inside the widget. An entry field will be created where the value can be entered.

Or, click and drag the mouse to drag the pointer to a new value. Or, right click at the location of the new value.

Maximum

Maximum value that can be specified for this value. If the value provided is greater than this maximum, an error message dialog is shown and the value is not sent to the real-time host.

Minimum

Minimum value that can be specified for this value. If the value provided is less than this minimum, an error message dialog is shown and the value is not sent to to the real-time host.

Function Call

See Remote Function Calls.

Color Zones

Define position and color for each color zone to display. Color zones are bands of color parallel to the scale used to convey information about values within a particular range.

Edit the entries in the table by clicking on the  button. The following dialog will appear:

gauge_zonedlg00039.png 

Each zone has the following properties:

Maximum Value Column

Value where this zone ends in units of the connected variable.

Minimum Value Column

Value where this zone begins in units of the connected variable.

Color Column

Color of the zone.

Zone Width Column

Width of the zone in pixels.

Text Tags

Place user defined text on the widget display.

Edit the entries in the table by clicking on the  button. The following dialog will appear:

gauge_texttagdlg00041.png 

Each text tag has the following properties:

Text

Text to display. HTML tags are not supported.

Text Font

Font of the text.

Color

Color of the text.

Text Position

Position of the text specified as a comma separated pair of values: x,y.

Border Properties

See Border Properties