Skip to content

Gauge Horizontal

The Gauge Horizontal shows a value as a bar that fills a horizontal track, above or below a scale. It is found in the Maritime - OpenBridge section of the Perspective Component Palette as Gauge Horizontal.

Horizontal gauge at 60 with a setpoint at 75

The parts of the gauge:

  1. Bar — filled up to the value. See Value and Range and Fill.
  2. Scale — the band beside the bar, with tickmarks and labels. See Scale.
  3. Setpoint — a marker on the scale. See Setpoint.

The Gauge Horizontal is the horizontal form of the Gauge Vertical: the two have the same properties and work in the same way. It is one of the maritime instruments; state, priority, the setpoint and advice zones are shared by all of them and are described in Maritime Instruments — Common Features. This page covers what is specific to the Gauge Horizontal.

A Gauge Horizontal dropped from the palette has no value and an empty track:

Gauge Horizontal with default properties

The gauge has a fixed size: it takes up 384 × 132 px at the top left of the component’s box, and does not grow or shrink with the box. The bar itself is 320 px long and starts 32 px from the left edge; the labels are drawn in the room beside it. Make the box at least 384 px wide, or the right end of the gauge is cut off. The blue frame is the component’s box:

Gauge in a wide box

Set hasValue to true and bind value to the quantity to show. minValue and maxValue are the ends of the scale.

Setting Image
value = 60, 0 to 100 Gauge at 60
value = 20, −50 to 50 Gauge from −50 to 50
reverse = true Reversed gauge

The bar is drawn from zero, so with a range that spans zero it grows to the left or right of the zero line. With reverse the scale is turned around: minValue is at the right and the values grow to the left.

Name Description Property Type
hasValue Show a value. Default false. value
value The value. Only shown when hasValue is true. value
minValue Lowest value of the scale. Default 0. value
maxValue Highest value of the scale. Default 100. value
reverse Put minValue at the right. Default false. value

fillMode selects how the value is drawn:

fillMode Image
fill (default) Fill mode
tint Tint mode
  • fill — a solid bar up to the value.
  • tint — a lighter bar with a marker line at the value, which makes the value itself stand out.

highlightCurrentValue adds a dot at the value, in the scale band:

Value marked with a dot

The bar normally runs from zero to the value. fillMin and fillMax give it other ends, for showing a range instead of a level:

Bar from 40 to 80

Name Description Property Type
fillMode fill or tint. Default fill. value
highlightCurrentValue Mark the value with a dot in the scale band. Default false. value
hasFillMin Give the bar another start than zero. Default false. value
fillMin Start of the bar. Only shown when hasFillMin is true. value
hasFillMax Give the bar another end than the value. Default false. value
fillMax End of the bar. Only shown when hasFillMax is true. value

side places the scale below (bottom, the default) or above (top) the bar:

side Image
bottom (default) Scale below the bar
top Scale above the bar

With the scale on top the whole gauge moves down in its 132 px, to leave room for the labels above it. The values left and right belong to the Gauge Vertical; on this gauge they draw the scale on top, as top does.

The scale is empty until tickmarks are turned on. There are three levels, each with a has… property that turns it on and an interval, and a list of single values. They work as on the Gauge Vertical:

Tickmarks Image
Primary, every 25 Primary tickmarks
Primary 25, secondary 5, tertiary 1 All three levels
mainTickmarks = [0, 50, 100] Main tickmarks
  • Primary tickmarks are the longest and carry the labels. showLabels turns the labels off.
  • Secondary and tertiary tickmarks are shorter and have no labels.
  • mainTickmarks is a list of single values to mark, without labels. A tickmark at an end of the scale falls on the frame and is not seen.

borderRadiusPosition selects which corners of the gauge are rounded, for placing several gauges next to each other as one instrument:

borderRadiusPosition Image
innerFirstChild (default) First gauge
middleChild Middle gauge
middleRoundedChild Rounded middle gauge
outerLastChild Last gauge
Name Description Property Type
side Side of the bar the scale is on: bottom or top. Default bottom. value
showLabels Show the numbers at the primary tickmarks. Default true. value
hasPrimaryTickmarkInterval Show primary tickmarks. Default false. value
primaryTickmarkInterval Distance between primary tickmarks. Only shown when hasPrimaryTickmarkInterval is true. value
hasSecondaryTickmarkInterval Show secondary tickmarks. Default false. value
secondaryTickmarkInterval Distance between secondary tickmarks. Only shown when hasSecondaryTickmarkInterval is true. value
hasTertiaryTickmarkInterval Show tertiary tickmarks. Default false. value
tertiaryTickmarkInterval Distance between tertiary tickmarks. Only shown when hasTertiaryTickmarkInterval is true. value
mainTickmarks Single values to mark on the scale. Empty by default. array
borderRadiusPosition Which corners are rounded: innerFirstChild, middleChild, middleRoundedChild or outerLastChild. auto leaves the choice to the component. Default innerFirstChild. value

The setpoint works as described in Setpoint. The marker sits in the scale band and points at the bar:

Setpoint Image
Setpoint at 75 Gauge with a setpoint
A new setpoint being chosen Gauge with a new setpoint

advices is a list of advice zones, each with min and max in the unit of the scale. A zone is triggered when the value or the setpoint is inside it; adviceTrigger narrows that to one of them:

Gauge with a caution zone from 80 to 100


Setting Image
active Active gauge
loading Loading gauge
off Gauge that is off
priority = enhanced Enhanced gauge

In the loading and off states the bar is not drawn. See State and Priority.


These work in the same way on every maritime instrument, and are described in Maritime Instruments — Common Features:

  • State — state.
  • Priority — priority.
  • Setpoint — hasSetpoint, setpoint, autoAtSetpoint, autoAtSetpointDeadband, atSetpoint, touching, hasNewSetpoint, newSetpoint, animateSetpoint, setpointAtZeroDeadband, setpointOverride.
  • Advice Zones — advices, adviceTrigger, adviceEmphasis.
  • Style and Events — style.

focused is deprecated; use touching.

The Gauge Horizontal has no component events of its own.

  1. Drop a Gauge Horizontal into the view and make it 384 × 132 px.
  2. Set hasValue to true and bind value to [default]Engine/ME1/Load.
  3. Set hasPrimaryTickmarkInterval to true and primaryTickmarkInterval to 25.
  4. Set advices to [{"category": "caution", "min": 85, "max": 100}].

Built on the OpenBridge Design System