Releases - mupen64/ugui

mupen64/ugui

Watch

Fork 0

12 releases 12 tags

RSS feed

3.1.2 75be83a353

3.1.2 Stable
abart27 released this 2026-03-27 18:11:27 +00:00 | 11 commits to main since this release
Summary

This release fixes a bug that causes an error when tooltips appear.

Thanks to @hugou74130 for the quick fix!

🐞 Bugfixes
- Styler Pass font params to compute_rich_text in draw_tooltip (#70)
Downloads
- Source code (ZIP)
  0 downloads
- Source code (TAR.GZ)
  0 downloads
- breitbandgraphics-amalgamated.lua
  9 downloads · 2026-03-27 18:13:29 +00:00 · 36 KiB
- ugui-amalgamated.lua
  9 downloads · 2026-03-27 18:13:28 +00:00 · 167 KiB

3.1.1 ea73f233bd

3.1.1 Stable
abart27 released this 2026-03-21 12:53:34 +00:00 | 13 commits to main since this release
Summary

This release fixes a critical bug with the TabControl, as well as missing type annotations for STATIC_ENV.

🐞 Bugfixes
- TabControl Error when placed (#67)
- STATIC_ENV missing type annotation (#66)
Downloads
- Source code (ZIP)
  0 downloads
- Source code (TAR.GZ)
  0 downloads
- breitbandgraphics-amalgamated.lua
  0 downloads · 2026-03-21 12:55:49 +00:00 · 36 KiB
- ugui-amalgamated.lua
  0 downloads · 2026-03-21 12:55:48 +00:00 · 166 KiB

3.1.0 11037c0999

3.1.0 Stable
abart27 released this 2026-03-18 17:43:30 +00:00 | 18 commits to main since this release
Summary

This release adds the label control, clipboard support, better keyboard input handling, and click-drag support for the scrollbar, along with fixing some bugs.

Adoption

Clipboard support

Clipboard support requires providing a clipboard API surface.

If you're using the Mupen64 Lua API, you can do that as follows:
```
 ---@module "ugui-amalgamated"
 ugui = dofile('ugui-amalgamated.lua')

+ugui.STATIC_ENV = {
+    clipboard = {
+        get = function()
+            return clipboard.get('text')
+        end,
+        set = function(text)
+            clipboard.set('text', text)
+        end,
+    },
+}
```
Breaking Changes

Removed Environment::held_keys

The mechanism for passing keyboard info to ugui via held_keys has been
removed.

Provide a list of key events instead.

If you're using the Mupen64 Lua API, this is how your code would change:
```
-emu.atdrawd2d(function()
-    local keys = input.get()
-    ugui.begin_frame({
-        held_keys = keys,
-        ...
-    })
-    ugui.end_frame()
-end)

+local key_events = {}
+
+emu.atdrawd2d(function()
+    ugui.begin_frame({
+        key_events = key_events,
+        ...
+    })
+    ugui.end_frame()
+    key_events = {}
+end)
+
+emu.atkey(function(args)
+    key_events[#key_events + 1] = args
+end)
```
✨ Features
- Label Add label control (#60)
- Clipboard support (#61)
- ScrollBar Click-drag support (#54)
- [breaking] Event queue-based keyboard input handling (#51)
🐞 Bugfixes
- NumberBox Broken primary return value (#47)
- TabControl Broken selected_index diffing (#46)
- CarrouselButton Broken meta return value (#45)
Downloads
- Source code (ZIP)
  0 downloads
- Source code (TAR.GZ)
  0 downloads
- breitbandgraphics-amalgamated.lua
  0 downloads · 2026-03-18 17:47:10 +00:00 · 36 KiB
- ugui-amalgamated.lua
  0 downloads · 2026-03-18 17:47:09 +00:00 · 166 KiB

3.0.3 b9ce0cb441

3.0.3 Stable
abart27 released this 2026-02-22 19:36:33 +00:00 | 36 commits to main since this release
Summary

This release improves styler mixin performance and fixes a bug in BreitbandGraphics.invert_color.

⚡ Performance
- Faster styler mixins (#43)
🐞 Bugfixes
- BreitbandGraphics Incorrect values returned by BreitbandGraphics.invert_color
Downloads
- Source code (ZIP)
  0 downloads
- Source code (TAR.GZ)
  0 downloads

3.0.2 6bf3e11f88

3.0.2 Stable
abart27 released this 2025-11-11 20:17:17 +00:00 | 40 commits to main since this release
Summary

This release fixes a bug related to focus not resetting when clicking on dead space.

🐞 Bugfixes
- core focus not resetting when clicking dead space
Downloads
- Source code (ZIP)
  0 downloads
- Source code (TAR.GZ)
  0 downloads

3.0.1 a7a9176919

3.0.1 Stable
abart27 released this 2025-11-10 15:58:53 +00:00 | 42 commits to main since this release
Summary

This release fixes bugs related to the numberbox.

🐞 Bugfixes
- numberbox Keyboard-based digit set behaviour not working
- Missing math shims for lua 5.4
Downloads
- Source code (ZIP)
  0 downloads
- Source code (TAR.GZ)
  0 downloads

3.0.0 b25fda67c0

3.0.0 Stable
abart27 released this 2025-10-25 22:40:13 +00:00 | 46 commits to main since this release
Summary

ugui 3.0.0 brings with it buffered scene processing and various flexibility
improvements.

Control logic is still executed immediately, but input processing and rendering are now done at the end of the frame. This has implications for certain use-cases, so make sure to read the "Breaking Changes" section.

Scenes with overlapping controls are now handled correctly and control focus behaviour should be more consistent.

New Stuff

💡 Control metadata

Controls now return a second value, the meta table (not to be confused with
metatable).
```
local pressed, meta = ugui.button({
    uid = 10,
    rectangle = {x = 120, y = 10, width = 100, height = 23},
    text = 'Hello, world!',
})

print(meta) -- prints: { signal_change = 0 }
```
The meta table contains miscellaneous information about a control's state.

The signal_change field makes it easier to detect changes in the return value
of a control without relying solely on state diffing.

For more information, consult the Meta type docs and ./demos/interaction_state.lua.

⚛️ ugui.control()

You can now spawn controls of arbitrary types at runtime using ugui.control()

Usage example:
```
local result = ugui.control({
    uid = 1,
    ...
}, 'button')

local pressed = result.primary
if pressed then
    print("Hello World!")
end
```
For more information, consult the ugui.control() docs.

📋 Control Registry

Control-specific code (with the exception of composite controls, such as
spinner) is now located in the "ugui registry" instead of scattered across
individual functions.

Given that this is an implementation detail, it's irrelevant to library
consumers.

If you are writing a ugui extension, consult the ControlRegistry type
definition for more information on how to integrate your own control with the
registry.

Breaking Changes

⌛ One Frame of Delay

Return values of controls are now delayed by one frame.

For instance, this manifests as a button returning true one frame after it
was clicked, and not immediately.

If you are experiencing state diffing issues (e.g. change detection based on
control return values failing because of the delay) due to this change, consult
the "Meta" section of the changelog.

✏️ Styler Overrides

Overriding a specific control's rendering by overwriting a method in the
standard_styler is no longer possible.

To achieve this, utilize styler mixins instead. For more info, see the
documentation for Control.styler_mixin.
```
- local prev_font_name = ugui.standard_styler.params.font_name
- ugui.standard_styler.params.font_name = "Comic Sans"
- ugui.button(...)
- ugui.standard_styler.params.font_name =  prev_font_name

+ugui.button({
+  ...
+  styler_mixin = {
+      font_name = "Comic Sans"
+  }
+)
```
📦 Control UID Sharing

Controls of different types may not share UIDs anymore.

Placing a button with uid 5 means you are no longer allowed to place any
non-button control with uid 5. This scenario will cause an error, so check the
error message to find out what went wrong.

⬆️ Control UID Requirements Changing

The spinner control now requires 4 UID slots instead of 3.

👁️ Stricter Control Validation

Controls are now validated more strictly, meaning that your script might error
out when placing a control.

The errors are pretty descriptive, so check that the data you pass into the
controls matches what they want - you can check the respective control type for
that.

❌ Layout System Removal

The layout system has been removed - ugui.push, ugui.pop, ugui.stackpanel
are no longer available.

There is currently no alternative to the layout system, but it might be added
back in future releases.
Downloads
- Source code (ZIP)
  0 downloads
- Source code (TAR.GZ)
  0 downloads

2.0.0 7406a7364f

2.0.0 Stable
abart27 released this 2025-03-11 05:47:05 +00:00 | 69 commits to main since this release
Summary

The 2.0.0 release of ugui is here, with major structural changes and new features.

Breaking Changes

Standard Package

BreitbandGraphcis, ugui, and ugui-ext are now a standard Lua packages. They don't automatically insert themselves into the global scope when executed.

To import the full ugui suite:
```
-    dofile("mupen-lua-ugui.lua")
-    dofile("mupen-lua-ugui-ext.lua")
+    BreitbandGraphics = dofile("BreitbandGraphics.lua")
+    ugui = dofile("mupen-lua-ugui.lua")
+    ugui_ext = dofile("mupen-lua-ugui-ext.lua")
```
Features
- BreitbandGraphics: Add RawColor
- BreitbandGraphics: Add default values for source_rectangle and color to draw_image
- BreitbandGraphics: Implement draw_text2
- BreitbandGraphics: Implicit color conversion
- CombBox: Window overflow avoidance for dropdown
- Core: Add unbalanced begin/end_frame detection
- Demo: Add ColorSource demo
- Josytick: Snap parameters
- Layout: Initial implementation of layout sections
- RichText: Allow specifying icon colors manually
- RichText: Implement rich text rendering
- Styler: Structured styler parameters
- Tests: Add test summary
- Tests: Add various BreitbandGraphics tests
- Textbox|Numberbox: Allow changing selection color
- Tooltip: Implement tooltips
- ugui-ext: Icon draw override
Changes
- BreitbandGraphics: (BREAKING) Refactor to standard module
- BreitbandGraphics: Remove 1.1.5-1.1.6 shim
- ComboBox: Allow providing nil selected_index
- Nineslice: Improve draw_icon error resilience
- RichText: Provide visual_state to draw_rich_text and pass it on to draw_icon
- ToggleButton: Allow providing nil is_checked, fix tooltip flickering when clicking
- ugui-ext: (BREAKING) Refactor to standard module, move controls to ugui
- ugui-ext: Remove 1.1.5-1.1.6 shim
- ugui: (BREAKING) Refactor to standard module
- ugui: (BREAKING) Require BreitbandGraphics to be present in global scope
- ugui: Ignore hittest outside of window bounds
Bugfixes
- BreitbandGraphics: Define API surface for get_image_info
- BreitbandGraphics: Incorrect empty table handling
- ComboBox: nil_params_no_error test
- Demo: Scripts failing to run when paths are too long
- ListBox: Incorrect layout
- ListBox: Use proper parameter name for control
- Listbox: Error when pressing up/down while hovering over listbox with no selection
- Listbox: Item height not being respected
- Menu: Broken icon drawing
- Menu: Invalid overlap size being read from styler
- Menu: align_x = start not being specified in draw_menu_item
- Nineslice: Incorrect draw_list_item implementation
- NumberBox: Uninitialized control data being consumed
- Numberbox: Text measuring accuracy issues
- RichText: Handle nil text in compute_rich_text
- RichText: draw_text2 being called for text segments with too low of a height, causing clipping
- RichText: draw_text2 being called with too high y coordinate
- TabControl: Incorrect text measurement when items contain rich text
- ugui-ext: Broken custom icon rendering
- ugui-ext: Cached rendering params still being applied
- ugui-ext: Placeholder icon being drawn instead of falling back to default implementation
- ugui-ext: control_data initialization crashes
- ugui-ext: draw_list_item nineslice implementation using wrong text alignment
- ugui: control_data initialization crashes
Dev
- BreitbandGraphics: Document internals
- BreitbandGraphics: Improve BreitbandGraphics docs
- Chore: Bump version to 2.0.0
- Core: Better docs for environments
- Core: Remove nil check for clamp( )
- Doc: Improve documentation of extended controls
- Docs: Improve documentation
- Layout: Limit layout stack depth to 1
- ListBox: Add FIXME about listbox parameter
- ListBox: Fix click_sets_correct_selected_index tests
- Listbox: Add regression test for d42656853c
- Menu: Fix incorrect field being read for color
- Numberbox: Add tests
- StackPanel: Fix StackPanel tests
- Styler: Add monospace_font_name param
- ugui-ext: Add Spinner and TabControl tests
- ugui-ext: Add more documentation, improve a warning message
- ugui-ext: Add ugui-ext demo
- ugui-ext: Bump version to 2.0.0
- ugui-ext: Fix demos and tests
- ugui-ext: Fix various bugs, port controls to new styler structure, remove treeview control
- ugui: Add back commented out tests
- ugui: Fix module inclusion typing in demos and tests
- ugui: Make standard styler use draw_text2
Full Changelog: https://github.com/Aurumaker72/mupen-lua-ugui/compare/1.0.4...2.0.0
Downloads
- Source code (ZIP)
  0 downloads
- Source code (TAR.GZ)
  0 downloads

1.0.4 b5599c8ade

1.0.4 Stable
abart27 released this 2023-08-14 09:54:35 +00:00 | 278 commits to main since this release

ℹ️ Compatibility with 1.1.4

Full Changelog: https://github.com/Aurumaker72/mupen-lua-ugui/compare/1.0.2...1.0.4
Downloads
- Source code (ZIP)
  0 downloads
- Source code (TAR.GZ)
  0 downloads
- mupen-lua-ugui.lua
  33 downloads · 2023-08-14 09:55:08 +00:00 · 68 KiB

1.0.2 67e09e52f3

1.0.2 Stable
abart27 released this 2023-06-30 18:04:44 +00:00 | 296 commits to main since this release
Downloads
- Source code (ZIP)
  0 downloads
- Source code (TAR.GZ)
  0 downloads
- mupen-lua-ugui.lua
  14 downloads · 2023-07-01 10:01:56 +00:00 · 71 KiB

1 2

3.1.2 Stable

Summary

🐞 Bugfixes

3.1.1 Stable

Summary

🐞 Bugfixes

3.1.0 Stable

Summary

Adoption

Clipboard support

Breaking Changes

Removed Environment::held_keys

✨ Features

🐞 Bugfixes

3.0.3 Stable

Summary

⚡ Performance

🐞 Bugfixes

3.0.2 Stable

Summary

🐞 Bugfixes

3.0.1 Stable

Summary

🐞 Bugfixes

3.0.0 Stable

Summary

New Stuff

💡 Control metadata

⚛️ ugui.control()

📋 Control Registry

Breaking Changes

⌛ One Frame of Delay

✏️ Styler Overrides

📦 Control UID Sharing

⬆️ Control UID Requirements Changing

👁️ Stricter Control Validation

❌ Layout System Removal

2.0.0 Stable

Summary

Breaking Changes

Standard Package

Features

Changes

Bugfixes

Dev

1.0.4 Stable

1.0.2 Stable

Removed `Environment::held_keys`