Settings

Setting

Description

Background image

Image to use as widget background. Can be a bitmap or SVG image. Images can be uploaded by either dropping a file inside the dashed grey area or clicking it to browse for a file.

Padding

Padding of the background (optional, in pixels). The padding can be defined in different ways:

Four values
25 50 75 100
Top padding is 25px, right padding is 50px, bottom padding is 75 px, left padding is 100px
Three values
25 50 75
Top padding is 25px, right and left paddings are 50px, bottom padding is 75px
Two values
25 50
Top and bottom paddings are 25px, left and right paddings are 50px
One value
25
All four paddings are 25px

Map editor

Maximize / Minimize

The editor area can be maximized / minimized by clicking on the editor's background or on the Maximize / Minimize editor button.

Add hotspot

Add hotspots by clicking on the Add hotspot button.

Select hostpots

A hotspot can be selected by clicking on it in the editor. Multiple hotspots can be selected by either pressing the ctrl key while clicking on a hotspot or by using the rubber band tool.

All hotspots can be selected pressing ctrl+a.

Move / Resize hotspot

Selected hotspots can be moved or resized by Drag&Drop or using the arrow keys on the keyboard. Hotspots move 10 px per key press. To achieve more fine grained movements, the ctrl key can be pressed while using the arrow keys.

Snap lines help properly aligning multiple hotspots against each other.

Copy hotspot

Select the hotspot of your choice. Press ctrl+c and ctrl+v to get a copy of the hotspot on your map. Move the new object to the correct place on the map and configure it as usual.

Delete hotspot

Delete a hotspot by clicking the X button next to it.

Edit hotspot

A hotspots can be edited by either double-clicking it or clicking its gear wheel button in the hotspot list.

Setting	Description
Type	lightbulb (default), label, text, rectangle, icon.
Name	Name to identify the hotspot in the hotspot list.
Position	Coordinates in pixels relative to the hotspot map origin (top left corner).
Size	Size of the hotspot in pixels
Opacity	Opacity of the hotspot (0 - 100%, default is 100%)
Clickable	By default clicking on a hotspot opens its details view. This can be deactivated with this setting.

Hotspot types

Lightbulb

Setting	Description
Frame	Show or hide frame around the lightbulb: vs.
Default status	Displayed state of the lightbulb as long as no data is loaded.
Flash threshold	Threshold state at which the lightbulb should start to flash.
Label	Activate label.

Label

A label can be a hotspot itself:

The same settings are available for the label as shown above in the Lightbulb section.

Instead one can also display a label connected to a hotspot.

Text

Free formatted text can be added using the Text hotspot:

Rectangle

Setting	Description
Background color	Click to select the background color using a color chooser. Set the A value to 0 to set a transparent background or to any number between 0 and 100 to get a translucent background effect.
Border color	Click to select the border color using a color chooser.
Border style	Solid (default), dashed, dotted, double.
Border width	Border width in pixels.
Border radius	Border radius in pixels. Perfect circles can be achieved by setting this value to its maximum.
Shadow	Drop shadow width in pixels.
Label	Activate label.

Icon

Use the Icon hotspot to add custom state-dependent lightbulbs:

Setting	Description
Default Status	Displayed status as long as no data is loaded.
Default icon	Displayed icon if no state dependent icon is defined.
State dependent icons	One icon per state can be defined.
Label	Activate label.

Labels

Some hotspots have the ability to display a label next to it. To show a label, simply activate the Label checkbox.

Setting	Description
Position	Bottom, left, top, right
Field	The field to display hotspot_name Name of the hotspot hotspot_text Free text object_name Name of the selected object object_values Value of the selected object object_parameters Parameter of the selected object object_properties Property of the selected object
Text	Only visible if field is hotspot_text. Text to display
Object type	Only visible if field is object_values, object_parameters or object_properties. Type of selected object
Sub Type	Only visible if field is object_values or object_parameters. Sub type of the selected object.
Object value	Only visible if field is object_values. Displayed value.
Object parameter	Only visible if field is object_parameters. Displayed parameter.
Object property	Only visible if field is object_properties. Displayed property.
Font size	The label font size in pixels.

Setting	Description
Image	The image to be displayed in the widget.
Image (Dark Mode)	The image to be displayed when in dark mode. If not set, the image is shown also in dark mode.
Caption	Adds a caption at the bottom of the image (optional).

Edit Image

Settings