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 panes on a grid has been implemented. Opinionated settings that work in both "Standard" and "FPV View" modes are provided. Configuration is described below.

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.

Note that everything is defined in terms of a standard (vertical) panel. When in FPV Mode (horizontal panel), rows are columns are automatically transposed.

The default is:

# mwp panel v2
# name, row, col, width, height, span, mode
ahi,0,0,200,200,2,3
rssi,1,0,-1,-1,1,3
vario,1,1,-1,-1,1,3
wind,2,0,-1,-1,1,1
dirn,2,1,-1,-1,1,1
flight,3,0,-1,-1,2,3
volts,4,0,-1,-1,2,3

where:

  • rows and columns are 0 indexed
  • span describes the number of rows (or columns) that widget a spans, allowing "large" items.
  • The combination of columns and the sum of spans should be consistent across all rows to avoid blank items (see compressed example below).
  • width and height is only required for the ahi; otherwise -1 means "best fit"
  • mode is a bit mask defining whether a widget is shown when vertical (1) and horizontal (2) (so 3 means both).

No graphical means is currently available to edit the panel, it has to be done by a text editor.

Compressed example#

This FreeBSD VM has a quite restricted screen size. In order to have a useful panel, it was optimal to have three columns, with spans adjusted for consistency. This works in both modes:

# mwp panel v2
# 3 row example
# name, row, col, width, height, span, mode
rssi,0,0,-1,-1,1,3
ahi,0,1,100,100,1,3
vario,0,2,-1,-1,1,3
wind,2,0,-1,-1,2,1
dirn,2,2,-1,-1,1,1
flight,3,0,-1,-1,3,3
volts,4,0,-1,-1,3,3

freebsd vertical

freebsd horizontal

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.