This repository was archived by the owner on Oct 15, 2025. It is now read-only.
Repository navigation
v0.0.2-unstable
Pre-release
Pre-release
v0.0.2-unstable
New Features
New Lua Globals:
VUI_mouse: a table for all mouse-related info, including:
- VUI_mouse.onPress: true if the mouse has just been pressed.
- VUI_mouse.onRelease: true if the mouse has just been released.
- VUI_mouse.down: true if the mouse button is currently down.
- VUI_mouse.x, VUI_mouse.y: the normalised mouse coordinates relative to the upper left corner.
VUI_signal: set flags through Lua that can be toggled to call conditional code in your C++ program. Set a field of VUI_signal to true to turn on the signal of that name; e.g:
VUI_signal.quit = true.Triggers:
if (uiHandler.HasSignalled("quit"))
// VUI_signal.quit is true
else
// false or nilFor more information on use, see the examples provided in the lua scripts of this build.
UI Text and Font Properties:
Font rendering now works, which means that the text field now specifies a string of UTF8-encoded (possibly subject to change) characters that will be drawn to the screen. Other font and text-related properties include:
- uiElement.textPos: The position of the top-left corner of the element's text, in normalised coordinates starting from the top-left of the viewport.
- uiElement.font: The filepath to the font file, relative to the current working directory. See freetype's supported font types for the list of compatible font formats, excluding fixed-size font formats.
- uiElement.fontColor: An RGBA value that determines the font color of the text. Doesn't actually do anything yet, but it's there.
- uiElement.textSize: Also currently does nothing, but it is there.
Note: text is always drawn one layer higher than its element's main vertices.

Try out the simple demo below, and mess around with the Lua script behind it!