Dashboards

Templates

Start from a ready-made dashboard, take single screens from one, keep your own dashboards and widgets for later, and use a template made for another screen size.

A template is a starting point: once you use it, it is your dashboard to change on the canvas.

The starter dashboards

Any of them works on any board with a screen: a template made for another size is scaled on the way in (Templates made for another screen size).

Use a dashboard

The template replaces what you have open, and the board keeps it only after Save to board.

Add screens from a dashboard

  • The same window opens from the canvas: right-click an empty spot › Insert screen….
  • An added screen and its widgets get new names, and tap actions that lead to a screen you did not take lose their action.
  • Unlike Use, adding screens can be undone like any other change.

Templates made for another screen size

When a dashboard was made for a display of another size, the configurator scales it on the way in: positions and sizes, and with them font sizes, borders, corners and line widths. How it scales is your choice:

ChoiceWhat happens
Fit (the default)One factor for both directions, and the layout is centred. Nothing is distorted, but bars of empty space can stay at two sides.
StretchEach direction is scaled on its own, so the layout fills the whole display. Round shapes become oval.

The choice is the Fit / Stretch switch at the right end of the status bar under the canvas. It shows there only while no board is connected, and the configurator remembers it: to use a template stretched on a connected board, disconnect, choose Stretch, and connect again. Use and Add both follow it, and so does moving a dashboard to another board.

The Layout transfer box: scaled by 1.25 and centred from 480 × 480 to 1024 × 600
The Layout transfer box after using the Round dial 480 on the 1024 × 600 display of a JC1060P470C.

After Use, the Layout transfer box reports what it lists for a converted draft. Add scales the same way but shows no report.

Save your own

The Save to templates dialog saving a container as a widget
Saving the container with the gear, speed and revs as a widget.
  • On the Canvas page, Save to templates keeps the selected widget, or the whole dashboard when nothing is selected. A container brings everything inside it, which is how a rev counter with its lights becomes one entry.
  • With several widgets selected, only the one you picked last is saved. Wrap them in a container first to keep them together (Containers).
  • The name needs at least one letter from A to Z or a digit, because the file is named after it. Two names that differ only in capitals, spaces or punctuation share a file: saving the second asks whether to replace the first.
  • Your templates are files on this computer, in the templates folder of the configurator’s data — on Windows %APPDATA%\Pitrig\templates, on a Mac ~/Library/Application Support/Pitrig/templates — with saved widgets in its widgets folder. To share one, copy its file into the same folder on the other computer, keeping the file name.

The widget library

A saved widget in the Widgets library with Add and the bin
A saved widget in the Widgets library.

After Add, the widget follows the pointer on the Canvas page: click where it should go, or press Escape to stop. It lands inside a container when the container holds its whole box, otherwise on the screen. The same list is on the canvas: right-click an empty spot › Insert widget. A widget arrives at the size it was saved at, shrunk only when it is bigger than the display.

Good to know

  • Deleting a template cannot be undone.
  • A template names its fonts but does not carry them. When it uses a family your font library does not hold, an amber note says so (When a font is missing).
  • A template does not carry pictures either: an image widget names a picture, and the picture has to be on the board.
  • The previews show each widget’s zero value, never live data.

Limits

WhatLimit
Saved dashboards64
Saved widgets64
Template name1 to 64 characters, with at least one letter from A to Z or a digit
Description240 characters
Screens on a dashboard, added ones included4