Gaugedis_gauge.jpg

Displays the connected variable on a circular scale.

It can be configured to support user input to set the value of the associated variable.

A Gauge with 2 color zones and a text tag:

dis_gauge2.png 

A Gauge using a background image:

dis_gauge3.png 

Geometrygaugeprop1.png

See Geometry.

Gauge Dimensions

Gauge Top/Left Corner

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

Vertical Axis Length

Length in pixels of the vertical semi axis of the gauge’s elliptical arc. I.e., the ellipse minor axis b.

Horizontal Axis Length

Length in pixels of the horizontal semi axis of the gauge’s elliptical arc. I.e., the ellipse major axis a.

ellipse.png 

Start Angle

Angle in degrees of the beginning of the gauge arc. Angles are measured in trigonometric fashion where 0 is the right-most horizontal position (East) and the angle increments counter clockwise.

Arc Angle

Arc measured in degrees.

anglemeasure2.png 

Visual Propertiesgaugeprop2.png

Show Scale

Show the labels and associated tick marks.

Show Gauge Arc

Show the circular arc that defines the gauge.

Show Value

Show value of the associated variable.

Arc Width

Width of arc in pixels.

Ticks

Number of major ticks along the arc.

Minor Ticks

Number of minor ticks between the major ticks.

Needle Width

Width in pixels of the gauge’s needle.

Needle Offset from Center

Distance in pixels from the hub’s center to the start of the needle. From this point, the needle is drawn outward from hub’s center.

Needle Length

Length in pixels of the needle.

Hub Radius

Radius in pixels of the gauge’s center hub.

Tick Length

Length in pixels of the major ticks. Minor ticks 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 measured in units of the associated variable separating successive labels.

Value Position

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

Backgroundgaugeprop3.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 Format

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

Value Format

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

Colorsgaugeprop4.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).

Gauge Arc Color

Color of the gauge’s arc.

Center Hub Color

Color of the center hub.

Needle Color

Color of the needle.

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. It corresponds to the position of the start of the gauge’s arc.

Minimum Value

Minimum expected value for the connected variable. This is the lowest value displayed by the gauge. It corresponds to the position of the end of the gauge’s arc.

Scale

Numeric scaling factor to multiply the value of the labels. 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,....

Factor

Numeric factor to multiply the value of the connected variable before calculating the position of the gauge needle

Counter Clockwise

Check this so that the needle angular position is computed counter clockwise instead of the default clockwise behavior. Used for gauge that move in the opposite direction.

User Inputgaugeprop5.png

Allows the user to enter a new value for the associated variable. To set a new value for the variable, simply click the mouse inside the widget and an entry field will be created where the value can be entered.

Maximum

Maximum value the user can specify for this value. If the value provided is greater than this maximum, an error message is shown and the value is not sent to SIMulation Workbench.

Minimum

Minimum value the user can specify for this value. If the value provided is less than this minimum, an error message is shown and the value is not sent to SIMulation Workbench.

Function Call

See Remote Function Calls.

Color Zones

Defines 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_zonedlg.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

Places user defined text on the widget display.

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

gauge_texttagdlg.png 

Each text tag has the following properties:

Text Column

Text to display. HTML tags are not supported.

Text Font Column

Font of the text.

Color Column

Color to use to draw the text.

Text Position Column

Position of the text specified as a comma separated pair of values. where x,y where x is the offset from the widget left side and y is the offset from the widget top.

Border Properties

See Border Properties