Create a new ImGui window. Windows are containers for widgets. Supports positioning, sizing, and window flags.

Add a widget to an ImGui window. Supports 80+ widget types including buttons, text, inputs, sliders, drags, color pickers, combos, trees, tables, menus, popups, plots, containers, and tooltips.

Update an existing widget's properties. Can update value, text, checked state, label, content, color, items, selected index, enabled state, and plot data.

Remove a widget from a window

Remove a window and all its widgets

Get the current state of all windows and widgets. Returns values, checked states, text content, selected indices, and interaction flags (clicked, changed, hovered, active, focused).

Remove all windows and widgets, resetting to empty state

Set the ImGui style theme. Choose from built-in themes (dark, light, classic) or provide custom color overrides.

Push a style color override onto the style stack for a specific window or widget. Must be balanced with imgui_pop_style_color.

Pop style color overrides from the style stack for a specific window or widget.

Append draw commands to a named layer in a window. Repeated calls preserve earlier geometry by default. Supports lines, shapes, gradients, ellipses, arcs, text, polygons, and bezier curves.

Set the background clear color of the viewport

Show or hide the ImGui demo window (showcases all available widgets)

Show or hide the ImGui metrics/debug window (draw calls, vertices, etc.)

Show or hide the ImGui about window (version info, credits)

Show or hide the ImGui style editor window (edit colors and sizes interactively)

Control a window's properties: position, size, collapsed state, focus, background alpha, or scroll position.

Query input state: mouse position, mouse buttons, keyboard keys, and item interaction states.

Get or set the system clipboard text via ImGui

Check if the ImGui application is running and get its status including binary path and availability.

Drain a bounded batch of native UI events. Returns the events, remaining queue depth, and the number dropped since the previous drain.

Capture a screenshot of the current ImGui frame and save it as a BMP file.

Capture a screenshot with information about a specific widget's bounds. Returns the screenshot path and widget location data.

Capture a screenshot with widget ID overlays for debugging and inspection.

Simulate a mouse click on a widget by its ID

Type text into a widget (focuses it first, then injects characters)

Move the mouse cursor to hover over a widget

Scroll the mouse wheel over a window

Simulate a key press and release. Supports single keys and modifier combos. Examples: 'Enter', 'Tab', 'Escape', 'Ctrl+S', 'Shift+A', 'Ctrl+Shift+Z'

Set the mouse cursor position in screen coordinates

Set keyboard focus to a widget (it will receive focus on the next frame)

Animate a widget property over time using a tween/animation. Supports multiple easing functions and looping.

Stop animations for a specific widget, or all animations in a window if widget is omitted.

Stop and remove all active animations across all windows

Move a window to a new position

Resize a window to new dimensions

Move a widget by applying a cursor offset before rendering

Get the actual rendered bounding box of a widget in pixel coordinates

Get the position and size of a window

Bring a window to the front and give it focus

Set the size of a widget

Get the layout of all widgets in a window with their bounding boxes

Set a window's anchor position relative to the viewport (e.g. top_left, center, bottom_right)

Set a widget's anchor position for responsive layout within its window

Resize the application viewport (SDL window) to specific pixel dimensions

Get the current viewport (SDL window) dimensions

Resize the viewport to a common resolution preset

Set the DPI/UI scale factor for all ImGui sizes

Set safe area insets (in pixels) that anchored windows will respect

Create a named scene that controls which windows are visible together

Delete a scene by name

Switch to a named scene, showing only its windows

List all scenes and their window lists, plus the active scene

Set the render layer (z-order) of a window. Higher layers render on top.

Set conditional visibility on a widget. Conditions: 'always', 'never', 'widget_id.checked==true', 'widget_id.value>0.5'

Show or hide a window by setting its open state

Save the current layout state as a named snapshot. Snapshots can be restored later with imgui_load_snapshot.

Restore a previously saved snapshot by name. The current state is pushed to the undo stack before restoring.

List all saved snapshots with their names, frame numbers, and widget counts

Delete a saved snapshot by name

Undo the last destructive operation (add/remove/update widget, remove window, clear all). The undone state is pushed to the redo stack.

Redo the last undone operation. Re-applies the state that was reversed by imgui_undo.

Export the current UI layout as C++ ImGui code that recreates all windows and widgets with their current values.

Export the current UI layout as Lua ImGui bindings code that recreates all windows and widgets with their current values.

Export the current UI layout as structured JSON with version info, window properties, and all widget definitions.

Import a UI layout from JSON (same format as imgui_export_json). Clears the current layout and recreates all windows and widgets.

Load a texture from a BMP or PPM file. If the file doesn't exist or is unsupported, creates a 64x64 checkerboard placeholder texture.

Unload a previously loaded texture and free its GPU resources.

Load a TTF or OTF font into the live ImGui atlas under a stable ID. Use imgui_set_font to make it the global default.

Set the global default font by loaded ID. Use 'default' to restore Dear ImGui's embedded font.

List loaded fonts, their native paths and sizes, and which font is active.

Apply a theme preset to the ImGui interface. Available themes: dark, light, classic, fantasy (gold/amber accents), scifi (cyan/teal accents), retro (green terminal style), minimal (white, thin borders, no rounding).

Set a specific ImGui style color by name. Color names include: Text, WindowBg, FrameBg, Button, ButtonHovered, ButtonActive, Header, HeaderHovered, HeaderActive, Border, CheckMark, SliderGrab, etc.

Set an ImGui style variable. Float vars: FrameRounding, WindowRounding, IndentSpacing, ScrollbarSize, GrabMinSize, etc. Vec2 vars: FramePadding, ItemSpacing, WindowPadding, etc.

Add an interactive hit region to a window. Hit regions are invisible shapes that detect mouse hover, click, drag, double-click, and wheel events. Use with imgui_get_canvas_events to read interactions. Shapes: rect, circle, ellipse, polygon.

Remove a hit region by its id

Update a hit region's shape, transform, or interaction flags. Only provided fields are updated.

Drain canvas interaction events from hit regions. Returns hover, click, drag (start/move/end), wheel, and double-click events with positions and deltas. Events are consumed on read.

Update a single draw command in a named draw layer without replacing the entire layer. Specify the command index and the fields to change.

Apply a transform to an entire draw layer: translate, rotate, scale, or set opacity. Transforms persist until changed and apply to all draw commands in the layer.

Bind a widget's value to a visual property. Each frame the source widget's property is read, scaled, offset, and written to the target. Example: bind a slider's value to a draw layer's opacity.

Remove bindings. Filter by source_widget and/or target_id, or omit both to remove all.

Set a declarative callback action that fires automatically when a widget event occurs. Actions: toggle_visibility, set_visibility, set_value, switch_scene. No polling round-trip needed.

Remove declarative callbacks. Filter by trigger_widget and/or action.