Skip to content

Side Bar Concepts and Usage#

The Side Bar, items 4 and 6 in the main window guide provides an area for optional widgets.

main

A very simple, bespoke panel comprising embedded resizeable panes has been implemented.

  • The panel consists for four vertical panels
  • The top panel can hold three horizontal panes
  • The other panels can hold two horizontal panes.

Each pane has a divider line between it and adjacent panels. The size of individual panes may be adjusted by moving the dividers. mwp will remember the relative sizing of the panels.

The main sidebar (dock) controls are shown below. Please note some of these images are from the legacy version of mwp.:

The following items are provided.

Artificial Horizon#

dockah

Direction View#

dockdir

Flight View#

dockdir

RSSI / LQ Status#

dockdir

Battery Monitor#

dockdir

Vario View#

dockdir dockdir dockdir

Wind Estimator (new / Gtk4)#

dockwind

The configuration may be user defined by a simple text file ~/.config/mwp/panel.conf.

Each entry is defined by a comma separated line defining the panel widget name, the row (0-3) and the column (0-2) and an optional minimum size (only required for the artificial horizon).

The default panel is defined (in the absence of a configuration file) as:

# default widgets
ahi,0,1,100
rssi, 1, 0
dirn, 1, 1
flight, 2, 0
volts, 3, 0

Which appears as: mwp4-panel-0

In line editor#

From 25.04.15, it is possible to edit the panel in-line. A popup menu is displayed on right mouse press on a panel pane. Note that in the default configuration, some of the pane dividers may be flush against an edge, and it will be necessary to drag the dividers to expose all the unused panels.

On a blank pane, the popup menu offers all non-deployed widgets. Here only "WindSpeed" is available to be added.

mwp4-panel-e0

The result after adding "WindSpeed":

mwp4-panel-e1

When the popup menu is invoked for a populated pane, only "Remove Item" is available.

Video example showing right mouse button menu usage.

Available Widgets#

The available panel widgets are named as:

Name Usage
ahi Artificial horizon
dirn Direction comparison
flight "Flight View" Position / Velocity / Satellites etc,
volts Battery information
vario Vario indicator
wind Wind Estimator (BBL replay only)

No other legacy widgets have been migrated.

So using the following ~/.config/mwp/panel.conf

# default + vario + wind widgets
ahi, 0, 1, 100
vario,0,2
rssi, 0, 0
wind, 1, 0
dirn, 1, 1
flight, 2, 0
volts, 3, 0

would appear as: mwp4-panel-1

Panel sizes have been adjusted to make best use of available space.