The map interface editor

How to build a map-based interface in Ilevia Manager for ILEVIA Control: Map user, pages, free positioning of components, background, grid, alignment, layers, context menu, and page and component options.

In the map-based interface, commands are not arranged in rows of icons, as in the Classic interface, but freely placed on a page: you can set a floor plan or photo as the background and position lights, shutters, and thermostats exactly where they are in the house. This page explains the map editor in Ilevia Manager.

Map interface editor with a living room photo as the background and three lights positioned on it
The map editor: a living room photo as the background and three lights positioned over the light points

Do you already have the smartphone interface? You can start from that: with Users > Import interface from Manager creates pages and components with the same structure, and all you need to do is add the backgrounds and position the icons. See From the smartphone interface to the map interface.

Creating a map user

The interface type depends on the user. To create a map user:

  1. Open Users > New user (or Users > Edit user for an existing user).

  2. In User type, choose Map.

  3. Enter the user name and password.

  4. In Width and Height, specify the page size in pixels (1024 × 768 by default). Use the screen proportions on which the interface will be displayed.

  5. Press Ok, then open the User Interface tab and select the user in User.

User management window with User type Map, Width 735 and Height 864
A Map user, with page width and height

How the editor is structured

  • Left column: the interface main menu (icons or scenarios). Use + to add an item and choose its icon.

  • Top tabs: the pages of the selected item. The green + adds a page; the wheel next to the name opens the page options.

  • Central area: the page, with the grid. At the bottom right are the zoom controls: zoom out, current value (click for actual size), zoom in, fit to window.

  • Right panel: Components with the components to drag onto the page (and Label, a free text label); Structure with the tree of items, pages, and components.

  • Bottom bars: editing commands and page settings (see below).

Choosing the background

Each page can have a background image: a floor plan, a rendering, or a photo of the room. You then place the commands on top of it.

  1. Select the menu item and the page.

  2. In the bottom bar, next to Background, press Select file.

  3. Choose the image on the computer and press Open. Manager copies it into the project, then it is uploaded to the server together with the rest using Project > Upload to server.

The image is fit to the page while keeping its proportions and is centered. Use the × next to Select file to remove it; use Visible to show or hide it; Color is the color that remains visible where the image does not cover the page.

Map editor with a living room photo as the background and three light commands positioned on top
A photo as the background, with the lights positioned over the actual light points

Use an image with the same proportions as the page. If the proportions are different, the image will not fill the page and bars of the background color will remain. The easiest way is to prepare the image already at the size specified in the user's Width and Height (in the example 735 × 864), or set Width and Height to match the image pixels.

Vertical photo narrower than the page: black bars remain on the sides
Different proportions: the photo does not fill the page and bars of the background color remain

Positioning the components over the image

  1. In the Components panel, drag the component onto the page, over the object it controls (the lamp, shutter, thermostat…).

  2. Move it by dragging it; resize it using the handles at the corners and sides.

  3. For an exact position, enter the coordinates in X, Y (top-left corner) and W, H (width and height) in the bottom bar. The values are in page pixels, that is, the user's Width × Height size.

Room page with two lights positioned on the wall lamp and the LED strip of the step; at the bottom X 210, Y 600, W 100, H 100
The Room page: the selected light is at X 210, Y 600, 100 pixels wide and high

The same component can appear multiple times, even on different pages: for example, the same light on the floor plan and on the room photo.

Tips for a good result:

  • Work at actual size (Ctrl+1) to see how much space a command really occupies over the image.

  • Reduce the grid (for example Grid 5 px) or disable it with Active when you need to center a command on a small object; with Shift + arrows you move it one pixel at a time.

  • Reduce the size of the command with W and H or with Scale factor in the component options, so it does not cover the object in the photo.

  • Lock the position (Ctrl+L or Lock component from the context menu) when the command is in place, so you do not move it by mistake.

  • Do not change the page size afterward: positions are in pixels and do not follow the image. If you change the user's Width or Height, the commands stay where they were while the image is resized, and they must be repositioned.

To add text, drag Label onto the page and type the text in its options.

Selecting and moving

  • Click selects an item; Ctrl/Shift + click adds it to or removes it from the selection.

  • Dragging on an empty area selects all elements within the rectangle (hold Shift to add them).

  • Alt + click selects the element underneath the selected one, if they overlap.

  • Ctrl+A selects the whole page, Esc cancels the selection, Tab / Shift+Tab move to the next or previous element.

  • Arrow keys: move the selection by one grid step; Shift + arrows by one pixel.

The command bar

Command bar and page settings bar of the map editor
The two bars at the bottom

Command

Function

Key

Undo / Redo

Cancels or repeats the last change.

Ctrl+Z / Ctrl+Y

Edit

Opens the options of the selected elements.

Enter

Remove

Deletes the selected elements.

Del

Cut / Copy / Paste

Cut, copy, paste.

Ctrl+X / Ctrl+C / Ctrl+V

Duplicate

Duplicates the selected elements.

Ctrl+D

Move back / Move front

Sends the element behind or in front of the other elements.

—

Align left / center / right

Aligns the selected elements horizontally.

—

Align top / middle / bottom

Aligns the selected elements vertically.

—

Distribute evenly

Distributes the elements at equal intervals, horizontally or vertically.

—

Group / Ungroup

Groups the elements so they can be moved together, or separates them.

Ctrl+G / Ctrl+Shift+G

X, Y, W, H

Position and size of the selection.

—

Other keys: Ctrl+L locks or unlocks the position, Ctrl+K keeps proportions while resizing, Ctrl + mouse wheel or Ctrl + +/− zoom, Ctrl+0 fits the page to the window, Ctrl+1 shows it at actual size, Space + drag (or middle button, or Shift + mouse wheel) moves the view.

Page settings

The second bar applies to the open page:

Setting

Function

Background · Select file

Selects the background image (for example, the floor plan).

Visible

Shows or hides the background image.

Color

Page background color.

Transparent

Transparent background.

Gesture

Enables or disables app gestures on this page.

View depth

In the editor, shows only the elements up to the selected level: useful when many elements overlap.

Grid … px

Grid step, also used for arrow-key movements.

Active

Enables or disables the grid in the editor.

The context menu

Right-clicking an element with the right mouse button opens a menu with additional functions.

Context menu opened on a light on the Living room page

Item

Function

Remove / Copy / Paste element

Deletes, copies, or pastes the element.

Duplicate

Duplicates the element.

Group / Ungroup

Groups or separates the selected elements.

Remove page

Deletes the page.

Copy page / Paste page

Copies all elements on the page and pastes them into another one, with the same positions and sizes.

Clear page

Removes all elements from the page.

Edit

Opens the element options.

Lock component

Locks the element position: it will not move until you unlock it.

Free proportion / Keep proportion

Free resizing or resizing with proportions locked.

Copy position / Paste position

Copies an element's position and applies it to another one.

Assign to

Links the element on the page to the component selected in the Components panel, replacing the current one.

Undo / Redo

Cancels or repeats.

For identical rooms: prepare a page, use Copy page and Paste page on the new page, then use Assign to to link each element to the correct component of the new room. Check the UID in the element options to verify the link.

Component options

Double-clicking a component (or Edit) opens Component options. At the top you find the group, name, and UID of the linked component.

Component options window in the map editor
The options of a Switch on the map

In addition to the Classic interface options (Title with Sync name, Hidden, User group, Blink / Hide / Disable icon when, Readonly), the map includes:

Option

Meaning

Icon (two)

The icons for the two states of the component, for example off and on.

Disable circle icon / Color to circle icon

Removes the circle around the icon or colors it according to the state.

Scale factor

Component size as a percentage.

Scale width / Scale height

Horizontal and vertical scaling, to distort the icon in only one direction.

View mode

How the component appears on the page: for example Classic, text only, images only, or hidden. Available items depend on the component type.

Detail mode

What opens when tapping the component in the app: Modal, Popup (small window), or Hidden (no window).

Bottom part of the component options: scale, View mode, Detail mode, icon conditions, Readonly
Scale, display mode, and icon conditions

For examples of the modes, see Component display modes.

With View mode set to hidden, you can place an invisible component over an object in the background image: the user taps the object and controls the component.

Page options

The wheel next to the page name (or a double-click on the tab) opens Page options.

Page options window for the Bedroom page
The Bedroom page options

Option

Meaning

Title

The page name in the app.

Hidden

Hides the page in the app.

Icon

The page tab icon.

Default tab

The page that opens first when the user selects the menu item.

Password

Requests a password to open the page.

User group

Restricts the page to the specified user groups.

Blink / Hide icon when – Is

Makes the page icon blink or hides it based on the state of a component.

The displayed items can change from page to page: for example, on the first page of the menu item, set as Default tab, Enabled appears instead of Hidden, and the icon conditions are missing.

Before uploading

  • Check the pages at actual size (Ctrl+1) to see how they will appear on the screen.

  • Use Structure to verify that each page contains the correct components and that nothing is hidden by mistake.

  • Upload the project with Project > Upload to server and test the interface in the app with the mapped user.

Last updated: