ktsu.ImGuiApp

A comprehensive collection of .NET libraries for building modern, feature-rich desktop applications with Dear ImGui.

Introduction

ktsu.ImGuiApp is a suite of .NET libraries that provides everything you need to build desktop applications with Dear ImGui. The suite includes application scaffolding, custom widgets, modal dialogs, a theming system, and a node graph editor framework. Built on Hexa.NET.ImGui bindings and Silk.NET for cross-platform windowing, it supports .NET 10, 9, and 8.

Features

Application Foundation: Complete application scaffolding with windowing, OpenGL rendering, font management, texture caching, and DPI awareness via ktsu.ImGuiApp
PID Frame Limiting: High-precision PID-controlled frame rate limiting with auto-tuning and adaptive throttling for focused, unfocused, idle, and minimized states
Custom Widgets: Rich collection of UI components including TabPanel, Knob, SearchBox with fuzzy matching, RadialProgressBar with countdown/count-up timers, Grid layouts, DividerContainer with resizable sections, Combo, Tree, and Icons via ktsu.ImGuiWidgets
Modal Dialogs: Professional popup system with MessageOK, Prompt, InputString/Int/Float, FilesystemBrowser, and SearchableList via ktsu.ImGuiPopups
Theming System: 50+ built-in themes (Catppuccin, Tokyo Night, Gruvbox, Dracula, and more) with scoped styling, semantic text colors, button alignment, color palettes, and an interactive theme browser via ktsu.ImGuiStyler
Node Graph Framework: Attribute-based node declaration system with UI-agnostic ktsu.NodeGraph metadata library and ImNodes-based visual editor ktsu.ImGuiNodeEditor with physics-based layout
Font Management: Unicode, emoji, and Nerd Font support with GPU memory management via FontMemoryGuard and dynamic font scaling
Scoped Styling: RAII-pattern disposable wrappers for colors, styles, fonts, themes, disable states, and UI scaling
Color Utilities: HSL/HSLA color creation, accessibility-focused contrast calculations, color manipulation extensions, and semantic color palettes

Libraries

ImGui.App - Application Foundation

Complete application scaffolding for Dear ImGui applications with windowing, rendering, font/texture management, and performance tuning.

ImGui.Widgets - Custom UI Components

Rich collection of custom widgets: TabPanel, Knob, SearchBox, RadialProgressBar, Grid, DividerContainer, Combo, Tree, Icons, ColorIndicator, Text, Image, ScopedDisable, and ScopedId.

ImGui.Popups - Modal Dialogs

Professional modal dialogs: MessageOK, Prompt, InputString/Int/Float with validation, FilesystemBrowser with glob filtering, and SearchableList with type-safe generics.

ImGui.Styler - Themes and Styling

Advanced theming system with 50+ built-in themes, scoped styling, semantic text colors, button alignment, color palettes, and an interactive theme browser.

NodeGraph - Node Metadata (UI-Agnostic)

Generic attribute-based system for declaring node graphs. Decorate classes, structs, and methods with node metadata (pins, execution modes, visibility, deprecation) without coupling to a specific editor implementation.

ImGuiNodeEditor - Visual Node Editor

Attribute-driven visual node editor built on ImNodes. Includes NodeEditorEngine for business logic, AttributeBasedNodeFactory for node creation from decorated types, physics-based layout simulation, and NodeEditorRenderer/NodeEditorInputHandler for rendering and interaction.

Installation

Package Manager Console

Install-Package ktsu.ImGuiApp
Install-Package ktsu.ImGuiWidgets
Install-Package ktsu.ImGuiPopups
Install-Package ktsu.ImGuiStyler
Install-Package ktsu.NodeGraph

.NET CLI

dotnet add package ktsu.ImGuiApp
dotnet add package ktsu.ImGuiWidgets
dotnet add package ktsu.ImGuiPopups
dotnet add package ktsu.ImGuiStyler
dotnet add package ktsu.NodeGraph

Package Reference

<PackageReference Include="ktsu.ImGuiApp" Version="x.y.z" />
<PackageReference Include="ktsu.ImGuiWidgets" Version="x.y.z" />
<PackageReference Include="ktsu.ImGuiPopups" Version="x.y.z" />
<PackageReference Include="ktsu.ImGuiStyler" Version="x.y.z" />
<PackageReference Include="ktsu.NodeGraph" Version="x.y.z" />

Usage Examples

Basic Application

using ktsu.ImGui.App;
using Hexa.NET.ImGui;

ImGuiApp.Start(new ImGuiAppConfig
{
    Title = "My Application",
    OnRender = delta =>
    {
        ImGui.Text("Hello, ImGui!");
    }
});

Application with Menu and Performance Settings

using ktsu.ImGui.App;
using ktsu.ImGui.Styler;
using Hexa.NET.ImGui;

ImGuiApp.Start(new ImGuiAppConfig
{
    Title = "Full Application",
    OnStart = () =>
    {
        Theme.Apply("Tokyo Night");
    },
    OnRender = delta =>
    {
        ImGui.Text("Content goes here");
    },
    OnAppMenu = () =>
    {
        if (ImGui.BeginMenu("File"))
        {
            if (ImGui.MenuItem("Exit"))
            {
                ImGuiApp.Stop();
            }
            ImGui.EndMenu();
        }
    },
    PerformanceSettings = new ImGuiAppPerformanceSettings
    {
        FocusedFps = 60.0,
        UnfocusedFps = 10.0,
        IdleTimeoutSeconds = 30.0
    }
});

Widgets

using ktsu.ImGui.Widgets;
using Hexa.NET.ImGui;

// Tabbed interface
TabPanel tabPanel = new("MyTabs", closable: true, reorderable: true);
tabPanel.AddTab("tab1", "First Tab", () => ImGui.Text("Content 1"));
tabPanel.Draw();

// Search box with filtering
string searchTerm = "";
TextFilterType filterType = TextFilterType.Glob;
TextFilterMatchOptions matchOptions = TextFilterMatchOptions.ByWholeString;
ImGuiWidgets.SearchBox("##Search", ref searchTerm, ref filterType, ref matchOptions);

// Radial countdown timer
float timeRemaining = 300.0f;
ImGuiWidgets.RadialCountdown(timeRemaining, 300.0f);

// Resizable divider layout
DividerContainer divider = new("MySplit", DividerLayout.Columns);
divider.Add("left", 200f, true, dt => ImGui.Text("Left pane"));
divider.Add("right", 400f, true, dt => ImGui.Text("Right pane"));
divider.Tick(deltaTime);

Popups and Dialogs

using ktsu.ImGui.Popups;

// Message dialog
ImGuiPopups.MessageOK messageOK = new();
messageOK.Open("Hello!", "This is a message.");
messageOK.ShowIfOpen();

// String input dialog
ImGuiPopups.InputString inputString = new();
inputString.Open("Enter Name", "Name:", "Default", result => ProcessName(result));
inputString.ShowIfOpen();

// File browser
ImGuiPopups.FilesystemBrowser browser = new();
browser.FileOpen("Open File", path => LoadFile(path), "*.txt");
browser.ShowIfOpen();

// Searchable list
ImGuiPopups.SearchableList<string> list = new();
list.Open("Select Item", "Choose:", items, item => OnSelected(item));
list.ShowIfOpen();

Theming and Styling

using ktsu.ImGui.Styler;
using Hexa.NET.ImGui;

// Apply a built-in theme
Theme.Apply("Catppuccin.Mocha");

// Show interactive theme browser
Theme.ShowThemeSelector("Select Theme");

// Scoped color styling (auto-restored after block)
using (new ScopedColor(ImGuiCol.Text, Color.FromHex("#ff6b6b")))
{
    ImGui.Text("This text is red!");
}

// Semantic text colors
using (Text.Color.Error())
{
    ImGui.Text("Error message");
}

using (Text.Color.Success())
{
    ImGui.Text("Success message");
}

// Center content
using (new Alignment.Center(ImGui.CalcTextSize("Centered!")))
{
    ImGui.Text("Centered!");
}

// Button text alignment
using (Button.Alignment.Center())
{
    ImGui.Button("Centered text", new Vector2(200, 30));
}

// Scoped theme for a section
using (new ScopedTheme(myTheme))
{
    ImGui.Text("This section uses a different theme");
}

Node Graph (Attribute-Based Declaration)

using ktsu.NodeGraph;

[Node("Math Add")]
[NodeBehavior(NodeExecutionMode.OnInputChange, IsDeterministic = true)]
public class AddNode
{
    [InputPin("A")]
    public float A { get; set; }

    [InputPin("B")]
    public float B { get; set; }

    [OutputPin("Result")]
    public float Result { get; set; }

    [NodeExecute]
    public void Execute()
    {
        Result = A + B;
    }
}

Visual Node Editor

using ktsu.ImGuiNodeEditor;

// Create engine and factory
NodeEditorEngine engine = new();
AttributeBasedNodeFactory factory = new(engine);

// Register node types
factory.RegisterNodeType<AddNode>();
factory.RegisterNodeTypesFromAssembly(typeof(AddNode).Assembly);

// Create nodes
Node nodeA = factory.CreateNode<AddNode>(new Vector2(100, 100));

// Render in ImGui loop
NodeEditorRenderer renderer = new();
NodeEditorInputHandler inputHandler = new();
renderer.Render(engine, editorSize);

API Reference

`ImGuiApp` (Static)

Application lifecycle and utilities.

Methods

Name	Return Type	Description
`Start(ImGuiAppConfig)`	`void`	Initialize and run the application
`Stop()`	`void`	Close the application window
`SetGlobalScale(float)`	`void`	Set accessibility UI scale (0.5-3.0)
`SetWindowIcon(string)`	`void`	Set window icon from image file
`GetOrLoadTexture(AbsoluteFilePath)`	`ImGuiAppTextureInfo`	Load or retrieve cached GPU texture
`DeleteTexture(uint)`	`void`	Remove texture from GPU
`EmsToPx(float)`	`float`	Convert EMs to pixels
`PtsToPx(int)`	`float`	Convert points to pixels

Properties

Name	Type	Description
`IsFocused`	`bool`	Whether the window has focus
`IsVisible`	`bool`	Whether the window is visible
`IsIdle`	`bool`	Whether the app is idle
`ScaleFactor`	`float`	DPI-based scale factor
`GlobalScale`	`float`	User-adjustable UI scale
`Invoker`	`Invoker`	Delegate invocation for window thread

`ImGuiAppConfig`

Configuration for ImGuiApp.Start().

Configuration Properties

Name	Type	Description
`Title`	`string`	Window title (default: "ImGuiApp")
`IconPath`	`string`	Path to window icon
`OnStart`	`Action`	Initialization callback
`OnUpdate`	`Action<float>`	Per-frame update callback
`OnRender`	`Action<float>`	Per-frame render callback
`OnAppMenu`	`Action`	Menu bar rendering callback
`OnMoveOrResize`	`Action`	Window moved/resized callback
`OnGlobalScaleChanged`	`Action<float>`	Scale changed callback
`Fonts`	`Dictionary<string, byte[]>`	Custom fonts to load
`EnableUnicodeSupport`	`bool`	Include extended Unicode ranges (default: true)
`PerformanceSettings`	`ImGuiAppPerformanceSettings`	Throttling configuration
`FontMemoryConfig`	`FontMemoryGuard.FontMemoryConfig`	Font memory limits
`InitialWindowState`	`ImGuiAppWindowState`	Initial window size/position

`ImGuiAppPerformanceSettings`

Frame rate throttling configuration.

Name	Type	Description
`EnableThrottledRendering`	`bool`	Enable adaptive frame limiting (default: true)
`FocusedFps`	`double`	Target FPS when focused (default: 30)
`UnfocusedFps`	`double`	Target FPS when unfocused (default: 5)
`IdleFps`	`double`	Target FPS when idle (default: 10)
`NotVisibleFps`	`double`	Target FPS when minimized (default: 2)
`IdleTimeoutSeconds`	`double`	Seconds before idle state (default: 30)

`ImGuiWidgets` (Static)

Custom UI components.

Name	Return Type	Description
`SearchBox(...)`	`bool`	Search box with Glob/Regex/Fuzzy filtering
`SearchBox<T>(...)`	`IEnumerable<T>`	Filtered item selection
`SearchBoxRanked<T>(...)`	`IEnumerable<T>`	Fuzzy-ranked item selection
`Knob(...)`	`bool`	Rotary knob control (float or int)
`RadialProgressBar(...)`	`void`	Radial progress indicator
`RadialCountdown(...)`	`void`	Countdown timer display
`RadialCountUp(...)`	`void`	Count-up timer display
`Combo<TEnum>(...)`	`bool`	Enum selection combo
`Combo<TString>(...)`	`bool`	String selection combo
`Icon(...)`	`bool`	Icon with label and events
`Image(...)`	`bool`	Clickable image display
`ColorIndicator(...)`	`void`	Colored square indicator
`RowMajorGrid<T>(...)`	`void`	Row-major grid layout
`ColumnMajorGrid<T>(...)`	`void`	Column-major grid layout

Widget Instance Classes

Class	Description
`TabPanel`	Tabbed interface with closable, reorderable tabs
`DividerContainer`	Resizable split pane layout (columns or rows)
`ScopedDisable`	RAII wrapper to disable UI elements
`ScopedId`	RAII wrapper to push ImGui IDs
`Tree`	Tree view with nested children

`ImGuiPopups` Classes

Class	Description
`Modal`	Generic modal dialog
`MessageOK`	Simple message with OK button
`Prompt`	Multi-button prompt dialog
`InputString`	String input with confirmation
`InputInt`	Integer input with confirmation
`InputFloat`	Float input with confirmation
`FilesystemBrowser`	File/directory browser with glob filtering
`SearchableList<T>`	Searchable item selection list

`Theme` (Static)

Theme management from ImGui.Styler.

Name	Return Type	Description
`Apply(string)`	`bool`	Apply a named theme
`Apply(ISemanticTheme)`	`void`	Apply a theme instance
`ResetToDefault()`	`void`	Reset to default ImGui theme
`ShowThemeSelector(...)`	`void`	Show interactive theme browser
`RenderMenu(...)`	`bool`	Render theme selection menu
`FindTheme(string)`	`ThemeInfo?`	Look up theme by name
`AllThemes`	`IReadOnlyList<ThemeInfo>`	All available themes
`DarkThemes`	`IReadOnlyList<ThemeInfo>`	Dark themes only
`LightThemes`	`IReadOnlyList<ThemeInfo>`	Light themes only
`Families`	`IReadOnlyList<string>`	Theme family names

Styling Utilities

Class	Description
`ScopedColor`	RAII scoped ImGui color override
`ScopedTextColor`	RAII scoped text color
`ScopedStyleVar`	RAII scoped style variable
`ScopedThemeColor`	RAII scoped theme-aware color
`ScopedTheme`	RAII scoped full theme
`FontAppearance`	RAII scoped font styling
`UIScaler`	RAII scoped UI scaling
`Alignment.Center`	RAII scoped content centering
`Button.Alignment`	RAII scoped button text alignment
`Text.Color`	Semantic text colors (Error, Warning, Info, Success)
`Indent`	Scoped indentation utilities
`Color`	Color creation (Hex, RGB, HSL) with palettes

Color Extensions (on `ImColor`)

Name	Description
`DesaturateBy(float)`	Reduce saturation
`SaturateBy(float)`	Increase saturation
`LightenBy(float)`	Increase luminance
`DarkenBy(float)`	Decrease luminance
`WithAlpha(float)`	Set alpha channel
`ToGrayscale()`	Convert to grayscale
`CalculateOptimalContrastingColor()`	Get best contrast text color
`GetContrastRatioOver(ImColor)`	WCAG contrast ratio

`NodeEditorEngine`

Core node graph business logic.

Name	Return Type	Description
`CreateNode(...)`	`Node`	Create a node with pins
`RemoveNode(int)`	`bool`	Remove a node
`TryCreateLink(int, int)`	`LinkCreationResult`	Create a link between pins
`RemoveLink(int)`	`bool`	Remove a link
`UpdatePhysics(float)`	`void`	Run physics simulation step
`Clear()`	`void`	Remove all nodes and links
`Nodes`	`IReadOnlyList<Node>`	All nodes
`Links`	`IReadOnlyList<Link>`	All links
`IsStable`	`bool`	Whether physics is stable

Node Graph Attributes

Attribute	Target	Description
`[Node]`	Class/Struct/Method	Marks type as a node
`[NodeBehavior]`	Class/Struct	Specifies execution mode
`[NodeExecute]`	Method	Marks execution method
`[InputPin]`	Property/Field/Parameter	Declares an input pin
`[OutputPin]`	Property/Field/Method	Declares an output pin
`[ExecutionInput]`	Property/Field	Declares execution input flow
`[ExecutionOutput]`	Property/Field	Declares execution output flow
`[NodeDeprecated]`	Class/Struct	Marks node as deprecated
`[NodeVisibility]`	Class/Struct	Controls menu visibility
`[WildcardPin]`	Property/Field	Accepts wildcard connections

Demo Applications

The repository includes demo applications showcasing all features:

# Run the main demo
dotnet run --project examples/ImGuiAppDemo

# Run individual library demos
dotnet run --project examples/ImGuiWidgetsDemo
dotnet run --project examples/ImGuiPopupsDemo
dotnet run --project examples/ImGuiStylerDemo

Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.

License

This project is licensed under the MIT License. See the LICENSE.md file for details.

Name		Name	Last commit message	Last commit date
Latest commit History 1,022 Commits
.github		.github
.serena		.serena
.vscode		.vscode
ImGui.App		ImGui.App
ImGui.Popups		ImGui.Popups
ImGui.Styler		ImGui.Styler
ImGui.Widgets		ImGui.Widgets
ImGuiNodeEditor		ImGuiNodeEditor
NodeGraph		NodeGraph
docs/plans		docs/plans
examples		examples
tests		tests
.editorconfig		.editorconfig
.gitattributes		.gitattributes
.gitignore		.gitignore
.mailmap		.mailmap
.runsettings		.runsettings
AUTHORS.md		AUTHORS.md
AUTHORS.url		AUTHORS.url
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
COPYRIGHT.md		COPYRIGHT.md
DESCRIPTION.md		DESCRIPTION.md
Directory.Packages.props		Directory.Packages.props
ImGui.sln		ImGui.sln
LATEST_CHANGELOG.md		LATEST_CHANGELOG.md
LICENSE.md		LICENSE.md
PROJECT_URL.url		PROJECT_URL.url
README.md		README.md
TAGS.md		TAGS.md
VERSION.md		VERSION.md
global.json		global.json
icon.png		icon.png

License

ktsu-dev/ImGuiApp

Folders and files

Latest commit

History

Repository files navigation

ktsu.ImGuiApp

Introduction

Features

Libraries

ImGui.App - Application Foundation

ImGui.Widgets - Custom UI Components

ImGui.Popups - Modal Dialogs

ImGui.Styler - Themes and Styling

NodeGraph - Node Metadata (UI-Agnostic)

ImGuiNodeEditor - Visual Node Editor

Installation

Package Manager Console

.NET CLI

Package Reference

Usage Examples

Basic Application

Application with Menu and Performance Settings

Widgets

Popups and Dialogs

Theming and Styling

Node Graph (Attribute-Based Declaration)

Visual Node Editor

API Reference

ImGuiApp (Static)

Methods

Properties

ImGuiAppConfig

Configuration Properties

ImGuiAppPerformanceSettings

ImGuiWidgets (Static)

Widget Instance Classes

ImGuiPopups Classes

Theme (Static)

Styling Utilities

Color Extensions (on ImColor)

NodeEditorEngine

Node Graph Attributes

Demo Applications

Contributing

License

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 195

Packages 0

Uh oh!

Uh oh!

Contributors 9

Uh oh!

Languages

`ImGuiApp` (Static)

`ImGuiAppConfig`

`ImGuiAppPerformanceSettings`

`ImGuiWidgets` (Static)

`ImGuiPopups` Classes

`Theme` (Static)

Color Extensions (on `ImColor`)

`NodeEditorEngine`

Packages