mod_dyngui

From Sohatex CRIISTAL Wiki
Jump to: navigation, search

This module provides a dynamic, customizable user interface that allows to create, configure, move, resize and delete controls and indicators as such provided by mod_basicelements.

(Un)locking

The user interface exists in two modes: locked and unlocked.

Locked Mode

In the locked mode, all controls and indicators are available to be controlled directly. Values can be changed, buttons can be pressed. The background color of the main window is white. This is the mode in which the CRIISTAL user interface can be operated.

Unlocked Mode

In the unlocked mode, no controls and indicators can be interacted with. Instead, new elements can be created and existing ones can be configured, moved, resized or deleted. The background color of the main window switches to dark grey and element boundaries become visible. This is the mode in which the CRIISTAL user interface can be customized.

Switching

Switching between the locked and the unlocked mode is realized by the leftmost menu bar item in the main window which reads "Lock" or "Unlock", related to the current mode the user interface is in.

Creating Elements

GUIUIControlsMenu.png

New elements can be created by clicking on the "UI Controls" menu item of the main window and selecting the desired element. The new element is created in the top-left corner of the user interface and can be moved to a different location while the user interface is in unlocked mode.

Moving and Resizing Elements

GUIMoveResize.png

While the user interface is in unlocked mode, elements can be both moved and resized. To move an element, place the mouse cursor above it, until the mouse cursor is changed to a move icon [1]. Then drag the element with pressed left mouse button to the desired location. To resize an element, place the mouse cursor above the bottom-right corner of the element, until the mouse cursor is changed to a resize icon [2]. Then drag the corner with pressed left mouse button until the desired size is reached.

Note: Elements have a minimum size limit. Also, some elements cannot be resized to a bigger size.

All moving and resizing actions operate on a fixed 10x10 pixels grid.

Configuring Elements

To configure the settings of an element, place the mouse cursor above it until the move cursor shows (see above) and click the right mouse button. If the element below the mouse cursor has configurable parameters, a configuration window will pop up.

Removing Elements

To remove an element, place the mouse cursor above it until the move cursor shows (see above) and press the delete button on your keyboard ("Delete", "Del", german "Entf", etc.). The element will be deleted and its settings lost.

Video Tutorial