Format a horizontal or vertical gauge
- Last UpdatedDec 19, 2024
- 4 minute read
Use the Format Gauge pane to customize a horizontal or vertical gauge and change its appearance, scale, and labels.
-
Right-click a gauge symbol and click Format Gauge to open the Format Gauge pane.
-
Under Style, customize the gauge's colors.
-
Bar
Color of the bar. The bar shows the value of a measurement on the scale.
-
Fill
Color of the fill. The fill is the gauge's background above the bar (or below the bar if the gauge is inverted).
-
Outline
Color of the border, value scale, and label.
-
Weight
Thickness of the border.
-
Value
Color of the value.
-
Format
Display format of the value.
Format
Description
Database
Show numbers in a format that depends on the data item:
-
For PI points or PI AF attributes with a PI point data reference, the format depends on the value of the point's DisplayDigits attribute:
-
Zero or positive numbers specify the number of digits to display to the right of the decimal point.
-
Negative numbers specify the number of significant digits.
-
-
For PI Vision calculations or PI AF attributes without a PI point data reference, numbers show 5 significant digits.
All data items show the thousands separator.
General
Show all significant digits for numbers except for trailing zeros. If the absolute value of the number is greater than 1x107 or less than 1x10-4, the format will switch to use scientific notation.
Number
Show numbers in the custom format that you specify:
-
Decimal Places
The number of digits shown after the decimal.
-
Use 1000 separator
Select this check box to show the thousands separator in large numbers.
Scientific
Show numbers in the format 0.00E+00.
-
-
Units
Set the display units for the value. Either Default for the base units or a listed unit to convert to. Only units appropriate for conversion from the base unit are listed.
-
-
Under Font, select your preferred font from the Name dropdown.
Note: If the selected font is not installed on a user’s system, an alternative font will be used by the browser. Roboto and Roboto Slab are installed with PI Vision, so will display consistently for all users.
To change the font size:
-
Select or enter a size in the Size dropdown.
-
Use the Increase Font Size
and Decrease Font Size
buttons to change the size incrementally.
-
-
Under Visibility, select the check boxes next to the information that you want on the gauge.
-
Label
Text that describes the gauge. Select a label from the list (an attribute name or description) or enter custom text.
-
Value
Value of the attribute.
-
Units
Units of measurement for the attribute.
-
-
Under Scale Range, configure the maximum and minimum values on the scale.
-
Database limits
Set the scale to the data item's configured minimum and maximum values.
Select the Invert Scale check box to reverse the start and end scale values.
-
Custom limits
Set the maximum and minimum values of the gauge manually. Enter the Top and Bottom values for vertical gauges, or enter the Right and Left values for horizontal gauges. To reverse the start and end scale values, enter the numbers in reverse.
-
Select a Start Value
Select Default to use the scale start value from the AF database.
Select Custom to change the point at which the scale values begin.
Note: If your actual value is less than your start value, your bar will display inversely.
-
-
If you want to reset all the settings in the pane to the default settings, select Reset to default.
-
If you want to save the current settings as the default settings for horizontal/vertical gauge symbols, select Save as default. The saved settings are applied by default when a user creates a new horizontal/vertical gauge symbol, and they are applied when a user selects Reset to default in this pane.
Note: You must have administrator privileges to save defaults.
-
Click the down arrow
at the top of the pane and then click Add Navigation Link to add a navigation link to the symbol.