Skip to content

Speed Arrows

The Speed Arrows show the direction of movement with one to three chevrons: more chevrons, more speed. A readout can show the speed in knots above them. The component is found in the Maritime - OpenBridge section of the Perspective Component Palette as Speed Arrows (Beta).

Note: This component is in beta: its properties may change in a later version.

Speed Arrows, two chevrons ahead, with a readout of 8.5 kn

The Speed Arrows are a symbol, like the indicators of the maritime instruments: they show the values they are given and compute nothing themselves.

A Speed Arrows component dropped from the palette shows one chevron:

Speed Arrows with default properties: one chevron

With nActiveArrows 0 and tintedArrows false it draws nothing.

The arrows have a fixed size of 96 × 101 px (169 px tall with the readout) and sit at the top left of the component’s box; they do not grow or shrink with the box. A new component has a box of 96 × 101 px. The blue frame is the component’s box:

Arrows in a larger box

nActiveArrows is the number of chevrons drawn, 0 to 3. Larger numbers draw three. Inactive chevrons are not drawn at all, unless tintedArrows is true: then all three positions are drawn, the inactive ones in a light tint.

nActiveArrows tintedArrows = false (default) tintedArrows = true
0 No chevrons Three tinted chevrons
1 One chevron One active chevron
2 Two chevrons Two active chevrons
3 Three chevrons

Use tintedArrows where the operator should see how far the speed is from the maximum.

Name Description Property Type
nActiveArrows Number of chevrons, 0 to 3. Default 1. value
tintedArrows Draw the inactive chevrons in a light tint. Default false. value

direction turns the chevrons. activeColor selects their colour:

direction activeColor = Regular (default) activeColor = Direction
forward (default) Forward Forward, green
backward Backward Backward, red
left Left Left, red
right Right Right, green
  • Regular — the neutral colour.

  • Enhanced — the enhanced (blue) colour, for the value the operator is steering by:

    Enhanced colour

  • Direction — green for forward and right, red for backward and left, like the starboard and port lights.

Name Description Property Type
direction forward, backward, left or right. Default forward. value
activeColor Regular, Enhanced or Direction. Default Regular. value

Set readout to true to show the speed above the chevrons, with the fixed label Speed and the unit KN. Bind speedKnots to the speed. fractionDigits is the number of decimals (default 0, so 8.5 is shown as 9) and maxDigits the number of digits before the decimal point that the readout makes room for.

fractionDigits = 1 fractionDigits = 0 (default)
Readout 8.5 Readout rounded to 9

The readout adds 68 px above the chevrons: make the box 169 px tall. The number of chevrons is not derived from the speed; bind nActiveArrows separately.

Name Description Property Type
readout Show the speed above the chevrons. Default false. value
speedKnots The speed in knots. Only shown when readout is true. Default 0. value
fractionDigits Number of decimals. Only shown when readout is true. Default 0. value
maxDigits Digits before the decimal point to make room for. Only shown when readout is true. Default 2. value

Properties not covered in the sections above:

Name Description Property Type
style Standard Perspective style object. object

The Speed Arrows have no component events of their own.

  1. Drop a Speed Arrows component into the view and make it 96 × 169 px.
  2. Set readout to true, fractionDigits to 1 and bind speedKnots to [default]Nav/SpeedThroughWater.
  3. Bind nActiveArrows to the expression if({[default]Nav/SpeedThroughWater} > 12, 3, if({[default]Nav/SpeedThroughWater} > 6, 2, if({[default]Nav/SpeedThroughWater} > 0.5, 1, 0))).
  4. Bind direction to if({[default]Nav/SpeedThroughWater} < 0, 'backward', 'forward'), set activeColor to Direction and tintedArrows to true.

Built on the OpenBridge Design System