Skip to content

Main Engine

The Main Engine shows the state of a main engine as two bars side by side: the engine speed on the left and the thrust on the right. Each can have a setpoint. It is found in the Maritime - OpenBridge section of the Perspective Component Palette as Main Engine.

Main Engine at 60 % speed and 40 % thrust, with setpoints

The parts of the instrument:

  1. Speed bar — on the left, filled from the bottom. See Speed.
  2. Thrust bar — on the right, filled from the zero line in the middle: upwards for ahead, downwards for astern. See Thrust.
  3. Setpoints — the markers on the outer edge of each bar. See Setpoints.

The Main Engine is one of the maritime instruments. State, priority, how a setpoint works 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 Main Engine. For a small symbol of the same engine, see the Main Engine Indicator.

A Main Engine dropped from the palette shows zero speed and zero thrust:

Main Engine with default properties

Bind speed to the engine speed in percent of its maximum, from 0 to 100. The bar on the left fills from the bottom.

speed = 20 speed = 60 speed = 90
Speed 20 % Speed 60 % Speed 90 %
Name Description Property Type
speed Engine speed in percent, 0 to 100. Default 0. value

Bind thrust to the thrust in percent, from -100 (full astern) to 100 (full ahead). The bar on the right fills from the zero line in the middle.

Ahead (40) Astern (-40)
Thrust ahead Thrust astern

thrustAdvices is a list of advice zones on the thrust bar, with min and max in percent of thrust. A zone that crosses zero is split at the zero line. Here, caution zones above 80 % ahead and astern:

Main Engine with caution zones on the thrust bar

speedAdvices does the same for the speed bar, with min and max in percent of speed. Its zones are drawn on the left edge of the speed bar, where the speed setpoint is.

A zone is triggered when the bar’s value or its setpoint is inside it. adviceTrigger narrows that to the value or the setpoint alone, and adviceEmphasis applies the design’s emphasis rules; both apply to the two bars.

Name Description Property Type
thrust Thrust in percent, -100 to 100; positive is ahead. Default 0. value
thrustAdvices Advice zones on the thrust bar, with min and max in percent. Empty by default. array
speedAdvices Advice zones on the speed bar, with min and max in percent. Empty by default. array
adviceTrigger Which reading triggers a zone, on both bars: both (the value or the setpoint), value or setpoint. Default both. value
adviceEmphasis Apply the design’s emphasis rules between go-to and no-go zones. Default false. value

Speed and thrust each have their own setpoint. They work as described in Setpoint, with Speed or Thrust in the property names. Set hasSpeedSetpoint or hasThrustSetpoint to true and bind the setpoint. The speed marker is on the left edge, the thrust marker on the right edge.

Speed setpoint at 80 % Reached Thrust setpoint at 70 % Reached
Speed setpoint Speed setpoint reached Thrust setpoint Thrust setpoint reached

Both setpoints decide by themselves when they are reached: autoAtSpeedSetpoint and autoAtThrustSetpoint are true by default, with a deadband of 1 %.

Each setpoint has its own “touching” property, speedTouching and thrustTouching: set it to true while the operator has a hand on that lever.

speedTouching = true thrustTouching = true
Speed lever touched Thrust lever touched

The Main Engine has no new-setpoint, override or animation properties.

Name Description Property Type
hasSpeedSetpoint Show the speed setpoint. Default false. value
speedSetpoint Ordered speed in percent. Only shown when hasSpeedSetpoint is true. value
autoAtSpeedSetpoint Let the instrument decide when the speed setpoint is reached. Default true. value
autoAtSpeedSetpointDeadband Percent the speed may differ from the setpoint and still count as reached. Default 1. value
atSpeedSetpoint Whether the speed setpoint is reached. Used when autoAtSpeedSetpoint is false. Default false. value
speedSetpointAtZeroDeadband How close to zero the speed setpoint must be to be drawn in its “zero” form. Default 0.5. value
speedTouching The operator is operating the speed lever. Default false. value
hasThrustSetpoint Show the thrust setpoint. Default false. value
thrustSetpoint Ordered thrust in percent. Only shown when hasThrustSetpoint is true. value
autoAtThrustSetpoint Let the instrument decide when the thrust setpoint is reached. Default true. value
autoAtThrustSetpointDeadband Percent the thrust may differ from the setpoint and still count as reached. Default 1. value
atThrustSetpoint Whether the thrust setpoint is reached. Used when autoAtThrustSetpoint is false. Default false. value
thrustSetpointAtZeroDeadband How close to zero the thrust setpoint must be to be drawn in its “zero” form. Default 0.5. value
thrustTouching The operator is operating the thrust lever. Default false. value

state and priority work as described in State and Priority. With priority enhanced, both bars and both setpoints are drawn in the enhanced colours.

active loading off enhanced
Active Loading Off Enhanced priority

The Main Engine is twice as tall as it is wide. It fills the height or the width of the component’s box, whichever is reached first, and is centred in it. The blue frame is the component’s box:

A box of the same proportions A wide box
Main Engine in a tall box Main Engine in a wide box

Give it a box twice as tall as wide, so it fills the box.


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

The Main Engine has no component events of its own.

Example 1 — Main Engine with Telegraph Orders

Section titled “Example 1 — Main Engine with Telegraph Orders”
  1. Drop a Main Engine into the view and make it 120 px wide and 240 px tall.
  2. Bind speed to [default]Propulsion/ME/SpeedPct and thrust to [default]Propulsion/ME/ThrustPct.
  3. Set hasSpeedSetpoint to true and bind speedSetpoint to [default]Propulsion/ME/SpeedOrder.
  4. Set hasThrustSetpoint to true and bind thrustSetpoint to [default]Propulsion/ME/ThrustOrder.
  5. Bind state to an expression that gives off when the engine is stopped, for example if({[default]Propulsion/ME/Running}, 'active', 'off').

Built on the OpenBridge Design System