Skip to content

UI and menus

This page groups UI element logic, menu loops, and transition helpers.

UI element timeline (ui_elements_update_and_render / FUN_0041a530)

Responsibilities:

  • Updates the global transition timeline ui_elements_timeline (DAT_00487248) using DAT_00480844. Direction is controlled by ui_transition_direction (DAT_0048724c) (0 = countdown, nonzero = count up).

  • When the timeline goes below zero, it calls game_state_set (FUN_004461c0) with game_state_pending (DAT_00487274) to switch state and then sets game_state_pending (DAT_00487274) = 0x19 (idle).

  • Clamps the timeline to the maximum active element value (ui_elements_max_timeline).

  • Iterates the UI element pointer table (0x0048f168 .. 0x0048f20b, 41 pointers) in reverse order (from ui_element_table_start down to ui_element_table_end), calling ui_element_update (FUN_00446900) and ui_element_render for each entry.

Helpers:

  • ui_elements_reset_state (FUN_00446170) clears element active flags and hover timers.

  • ui_elements_max_timeline (FUN_00446190) returns the max timeline value among active elements.

A common menu loop that:

1) Calls the gameplay render pass (gameplay_render_world, FUN_00405960). 2) Runs ui_elements_update_and_render. 3) Draws menu content and buttons (ui_button_update).

UI element render (ui_element_render / FUN_00446c40)

ui_element_render updates focus/click handling and draws a UI element's quads, colors, and textures. See UI elements for struct details.

The main menu is game_state_id == 0 and is built from the shared UI element system (logo sign + ui_menuItem elements with overlay label atlas).

Button helpers

High-confidence button helpers are tracked in Detangling notes under UI button helpers.