Button

Buttons are the primary component of any UI, and can perform a variety of functions.

uic buttons example

To get started, click Button in the top bar and select one of the following:

After creating a button, you can adjust its appearance using the controls in the Properties > General pane on the right.
To make additional buttons with the same appearance, simply copy and paste.

Behaviour

The Properties > Behaviour pane on the right contains the Button ID and the following Press/Release Functions:

  • Activate preset - Triggers a lighting Preset scene in the selected Area.

  • Stop Fade - Pauses the current fade between presets in the selected Area.

  • Send Channel Level - Sends the selected channel level command to a single lighting Channel in the selected Area.

  • Temperature Control - Increment (raise) or decrement (lower) the temperature setpoint in the selected Area.
    The step size is defined in Project Settings > General > Temperature settings

  • Save Channel To Preset - Saves the current channel level(s) in the selected Area to a specific Preset.

  • Save To Current Preset - Saves the current channel level(s) in the selected Area to the currently active preset.

  • Go to page - Opens the selected UI Page. This function uses the page name defined in Page Properties > General.

  • Navigate to Home - Opens the Home page.

  • Previous Page / Next Page - Opens the previous/next page in the Pages list on the left.

Previous/Next Page follows the displayed order of the Pages list on the left. To adjust the navigation order, drag each page up or down to the required position.

This is not related to the page number, which acts as a target ID for the Go to page function and DyNet Page Flip command.

  • Clean Screen - Locks the screen for 30 seconds to avoid accidental input while cleaning.

  • Task Control - Start, stop, pause, or resume the selected Task.

  • Send DyNet message - Transmit a predefined DyNet Packet to the DyNet network.

  • One Touch - Toggles between the selected On/Off preset scenes.

    • Enable Ramping - If ticked, holding the button ramps the light level towards the target preset until released.

    • Enable Program - If ticked, releasing the button while ramping saves the current light level as the new On preset.

  • Log out - Logs the current user out and returns to the Landing page defined in Project Settings > General.

  • Open schedule - Navigates to the Schedules page.

  • Open settings menu - Opens the Settings page.

Each button can perform up to two Press Functions and/or two Release Functions in sequence. For example, you can pair Activate preset or Task Control with Go to page to initiate the command and immediately load a new page with specific buttons or indicators related to that preset/task.
You can also use functionless buttons as a static design element to display text with a custom background and border color.