👁 Image
ktsu.ImGui.App 2.15.2

dotnet add package ktsu.ImGui.App --version 2.15.2

NuGet\Install-Package ktsu.ImGui.App -Version 2.15.2

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="ktsu.ImGui.App" Version="2.15.2" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="ktsu.ImGui.App" Version="2.15.2" />
 

 Directory.Packages.props

<PackageReference Include="ktsu.ImGui.App" />
 

 Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add ktsu.ImGui.App --version 2.15.2

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: ktsu.ImGui.App, 2.15.2"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package ktsu.ImGui.App@2.15.2

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=ktsu.ImGui.App&version=2.15.2
 

 Install as a Cake Addin

#tool nuget:?package=ktsu.ImGui.App&version=2.15.2
 

 Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

ktsu.ImGui.App

A .NET library that provides application scaffolding for Dear ImGui, using Silk.NET and Hexa.NET.ImGui.

👁 NuGet
👁 NuGet Downloads
👁 GitHub Stars

Introduction

ImGuiApp is a .NET library that provides application scaffolding for Dear ImGui, using Silk.NET for OpenGL and window management and Hexa.NET.ImGui for the ImGui bindings. It simplifies the creation of ImGui-based applications by abstracting away the complexities of window management, rendering, and input handling.

Features

Simple API: Create ImGui applications with minimal boilerplate code
Full Integration: Seamless integration with Silk.NET for OpenGL and input handling
Window Management: Automatic window state, rendering, and input handling
Performance Optimization: Sleep-based throttled rendering with lowest-selection logic when unfocused, idle, or not visible to maximize resource savings
PID Frame Limiting: Precision frame rate control using a PID controller with comprehensive auto-tuning capabilities for highly accurate target FPS achievement
DPI Awareness: Built-in support for high-DPI displays and scaling
Font Management: Flexible font loading system with customization options and dynamic scaling
Unicode & Emoji Support: Built-in support for Unicode characters and emojis (enabled by default)
Texture Support: Built-in texture management with caching and automatic cleanup for ImGui
Debug Logging: Comprehensive debug logging system for troubleshooting crashes and performance issues
Context Handling: Automatic OpenGL context change detection and texture reloading
Lifecycle Callbacks: Customizable delegate callbacks for application events
Menu System: Easy-to-use API for creating application menus
Positioning Guards: Offscreen positioning checks to keep windows visible
Modern .NET: Supports .NET 8, 9, and 10
Active Development: Open-source and actively maintained

Getting Started

Prerequisites

.NET 8.0 or later

Installation

Package Manager Console

Install-Package ktsu.ImGui.App

.NET CLI

dotnet add package ktsu.ImGui.App

Package Reference

<PackageReference Include="ktsu.ImGui.App" Version="x.y.z" />

Usage Examples

Basic Application

Create a new class and call ImGuiApp.Start() with your application config:

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

static class Program
{
 static void Main()
 {
 ImGuiApp.Start(new ImGuiAppConfig()
 {
 Title = "ImGuiApp Demo",
 OnStart = () => { /* Initialization code */ },
 OnUpdate = delta => { /* Logic updates */ },
 OnRender = delta => { ImGui.Text("Hello, ImGuiApp!"); },
 OnAppMenu = () =>
 {
 if (ImGui.BeginMenu("File"))
 {
 // Menu items
 if (ImGui.MenuItem("Exit"))
 {
 ImGuiApp.Stop();
 }
 ImGui.EndMenu();
 }
 }
 });
 }
}

Custom Font Management

Use the resource designer to add font files to your project, then load the fonts:

ImGuiApp.Start(new()
{
 Title = "ImGuiApp Demo",
 OnRender = OnRender,
 Fonts = new Dictionary<string, byte[]>
 {
 { nameof(Resources.MY_FONT), Resources.MY_FONT }
 },
});

Or load the font data manually:

var fontData = File.ReadAllBytes("path/to/font.ttf");
ImGuiApp.Start(new()
{
 Title = "ImGuiApp Demo",
 OnRender = OnRender,
 Fonts = new Dictionary<string, byte[]>
 {
 { "MyFont", fontData }
 },
});

Then apply the font to ImGui using the FontAppearance class:

private static void OnRender(float deltaTime)
{
 ImGui.Text("Hello, I am normal text!");

 using (new FontAppearance("MyFont", 24))
 {
 ImGui.Text("Hello, I am BIG fancy text!");
 }

 using (new FontAppearance(32))
 {
 ImGui.Text("Hello, I am just huge text!");
 }

 using (new FontAppearance("MyFont"))
 {
 ImGui.Text("Hello, I am somewhat fancy!");
 }
}

Unicode and Emoji Support

ImGuiApp automatically includes support for Unicode characters and emojis. This feature is enabled by default, so you can use extended characters without any configuration:

private static void OnRender(float deltaTime)
{
 ImGui.Text("Basic ASCII: Hello World!");
 ImGui.Text("Accented characters: café, naïve, résumé");
 ImGui.Text("Mathematical symbols: ∞ ≠ ≈ ≤ ≥ ± × ÷ ∂ ∑");
 ImGui.Text("Currency symbols: $ € £ ¥ ₹ ₿");
 ImGui.Text("Arrows: ← → ↑ ↓ ↔ ↕");
 ImGui.Text("Emojis (if font supports): 😀 🚀 🌟 💻 🎨 🌈");
}

Note: Character display depends on your font's Unicode support. Most modern fonts include extended Latin characters and symbols, but emojis require specialized fonts.

To disable Unicode support (ASCII only), set EnableUnicodeSupport = false:

ImGuiApp.Start(new()
{
 Title = "ASCII Only App",
 EnableUnicodeSupport = false, // Disables Unicode support
 // ... other settings
});

Texture Management

Load and manage textures with the built-in texture management system:

private static void OnRender(float deltaTime)
{
 // Load texture from file path
 var textureInfo = ImGuiApp.GetOrLoadTexture("path/to/texture.png");

 // Use the texture in ImGui (using the new TextureRef API for Hexa.NET.ImGui)
 ImGui.Image(textureInfo.TextureRef, new Vector2(128, 128));

 // Clean up when done (optional - textures are cached and managed automatically)
 ImGuiApp.DeleteTexture(textureInfo);
}

PID Frame Limiting

ImGuiApp features a sophisticated PID (Proportional-Integral-Derivative) controller for precise frame rate limiting. This system provides highly accurate target FPS control that learns and adapts to your system's characteristics.

Key Features

High-Precision Timing: Hybrid sleep system combining Thread.Sleep() for coarse delays with spin-waiting for sub-millisecond accuracy
PID Controller: Advanced control algorithm that learns from frame timing errors and dynamically adjusts sleep times
Comprehensive Auto-Tuning: Multi-phase tuning procedure that automatically finds optimal PID parameters for your system
VSync Independence: Works independently of monitor refresh rates for any target FPS
Real-Time Diagnostics: Built-in performance monitoring and tuning visualization

Optimized Defaults

ImGuiApp comes pre-configured with optimal PID parameters derived from comprehensive auto-tuning:

Kp: 1.800 - Proportional gain for current error response
Ki: 0.048 - Integral gain for accumulated error correction
Kd: 0.237 - Derivative gain for predictive adjustment

These defaults provide excellent frame timing accuracy out-of-the-box for most systems.

Configuration

Configure frame limiting through ImGuiAppPerformanceSettings:

ImGuiApp.Start(new ImGuiAppConfig
{
 Title = "PID Frame Limited App",
 OnRender = OnRender,
 PerformanceSettings = new ImGuiAppPerformanceSettings
 {
 EnableThrottledRendering = true,
 FocusedFps = 30.0, // Target 30 FPS when focused
 UnfocusedFps = 5.0, // Target 5 FPS when unfocused
 IdleFps = 10.0, // Target 10 FPS when idle
 NotVisibleFps = 2.0, // Target 2 FPS when minimized
 EnableIdleDetection = true,
 IdleTimeoutSeconds = 30.0 // Idle after 30 seconds
 }
});

Auto-Tuning Procedure

For maximum accuracy, ImGuiApp includes a comprehensive 3-phase auto-tuning system:

Coarse Phase (8s per test): Tests 24 parameter combinations to find the general optimal range
Fine Phase (12s per test): Tests 25 refined parameters around the best coarse result
Precision Phase (15s per test): Final optimization with 9 precision-focused parameters

Total tuning time: ~12-15 minutes for maximum accuracy

Access auto-tuning through the Debug > Show Performance Monitor menu, which provides:

Real-time tuning progress visualization
Performance metrics (Average Error, Max Error, Stability, Score)
Interactive tuning controls and results display
Live FPS graphs showing PID controller performance

Technical Details

The PID controller works by:

Measuring actual frame times vs. target frame times
Calculating error using smoothed measurements to reduce noise
Adjusting sleep duration using PID mathematics: output = Kp×error + Ki×∫error + Kd×Δerror
Learning from past performance to minimize future timing errors

The system automatically:

Disables VSync to prevent interference with custom frame limiting
Pauses throttling during auto-tuning for accurate measurements
Uses integral windup prevention to maintain stability
Applies high-precision sleep for sub-millisecond timing accuracy

Full Application with Multiple Windows

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

class Program
{
 private static bool _showDemoWindow = true;
 private static bool _showCustomWindow = true;

 static void Main()
 {
 ImGuiApp.Start(new ImGuiAppConfig
 {
 Title = "Advanced ImGuiApp Demo",
 InitialWindowState = new ImGuiAppWindowState
 {
 Size = new Vector2(1280, 720),
 Pos = new Vector2(100, 100)
 },
 OnStart = OnStart,
 OnUpdate = OnUpdate,
 OnRender = OnRender,
 OnAppMenu = OnAppMenu,
 });
 }

 private static void OnStart()
 {
 // Initialize your application state
 Console.WriteLine("Application started");
 }

 private static void OnUpdate(float deltaTime)
 {
 // Update your application state
 // This runs before rendering each frame
 }

 private static void OnRender(float deltaTime)
 {
 // ImGui demo window
 if (_showDemoWindow)
 ImGui.ShowDemoWindow(ref _showDemoWindow);

 // Custom window
 if (_showCustomWindow)
 {
 ImGui.Begin("Custom Window", ref _showCustomWindow);

 ImGui.Text($"Frame time: {deltaTime * 1000:F2} ms");
 ImGui.Text($"FPS: {1.0f / deltaTime:F1}");

 if (ImGui.Button("Click Me"))
 Console.WriteLine("Button clicked!");

 ImGui.ColorEdit3("Background Color", ref _backgroundColor);

 ImGui.End();
 }
 }

 private static void OnAppMenu()
 {
 if (ImGui.BeginMenu("File"))
 {
 if (ImGui.MenuItem("Exit"))
 ImGuiApp.Stop();

 ImGui.EndMenu();
 }

 if (ImGui.BeginMenu("Windows"))
 {
 ImGui.MenuItem("Demo Window", string.Empty, ref _showDemoWindow);
 ImGui.MenuItem("Custom Window", string.Empty, ref _showCustomWindow);
 ImGui.EndMenu();
 }
 }

 private static Vector3 _backgroundColor = new Vector3(0.45f, 0.55f, 0.60f);
}

API Reference

`ImGuiApp` Static Class

The main entry point for creating and managing ImGui applications.

Properties

Name	Type	Description
`WindowState`	`ImGuiAppWindowState`	Gets the current state of the application window
`Invoker`	`Invoker`	Gets an instance to delegate tasks to the window thread
`IsFocused`	`bool`	Gets whether the application window is focused
`IsVisible`	`bool`	Gets whether the application window is visible
`IsIdle`	`bool`	Gets whether the application is currently idle
`ScaleFactor`	`float`	Gets the current DPI scale factor

Methods

Name	Parameters	Return Type	Description
`Start`	`ImGuiAppConfig config`	`void`	Starts the ImGui application with the provided configuration
`Stop`	`void`	Stops the running application
`GetOrLoadTexture`	`AbsoluteFilePath path`	`ImGuiAppTextureInfo`	Loads a texture from file or returns cached texture info if already loaded
`TryGetTexture`	`AbsoluteFilePath path, out ImGuiAppTextureInfo textureInfo`	`bool`	Attempts to get a cached texture by path
`DeleteTexture`	`uint textureId`	`void`	Deletes a texture and frees its resources
`DeleteTexture`	`ImGuiAppTextureInfo textureInfo`	`void`	Deletes a texture and frees its resources (convenience overload)
`CleanupAllTextures`	`void`	Cleans up all loaded textures
`SetWindowIcon`	`string iconPath`	`void`	Sets the window icon using the specified icon file path
`EmsToPx`	`float ems`	`int`	Converts a value in ems to pixels based on current font size
`PtsToPx`	`int pts`	`int`	Converts a value in points to pixels based on current scale factor
`UseImageBytes`	`Image<Rgba32> image, Action<byte[]> action`	`void`	Executes an action with temporary access to image bytes using pooled memory

`ImGuiAppConfig` Class

Configuration for the ImGui application.

Properties

Name	Type	Default	Description
`TestMode`	`bool`	`false`	Whether the application is running in test mode
`Title`	`string`	`"ImGuiApp"`	The window title
`IconPath`	`string`	`""`	The file path to the application window icon
`InitialWindowState`	`ImGuiAppWindowState`	`new()`	The initial state of the application window
`Fonts`	`Dictionary<string, byte[]>`	`[]`	Font name to font data mapping
`EnableUnicodeSupport`	`bool`	`true`	Whether to enable Unicode and emoji support
`SaveIniSettings`	`bool`	`true`	Whether ImGui should save window settings to imgui.ini
`PerformanceSettings`	`ImGuiAppPerformanceSettings`	`new()`	Performance settings for throttled rendering
`OnStart`	`Action`	`() => { }`	Called when the application starts
`FrameWrapperFactory`	`Func<ScopedAction?>`	`() => null`	Factory for creating frame wrappers
`OnUpdate`	`Action<float>`	`(delta) => { }`	Called each frame before rendering (param: delta time)
`OnRender`	`Action<float>`	`(delta) => { }`	Called each frame for rendering (param: delta time)
`OnAppMenu`	`Action`	`() => { }`	Called each frame for rendering the application menu
`OnMoveOrResize`	`Action`	`() => { }`	Called when the application window is moved or resized

`ImGuiAppPerformanceSettings` Class

Configuration for performance optimization and throttled rendering. Uses a sophisticated PID controller with high-precision timing to achieve accurate target frame rates while maintaining system resource efficiency. The system combines Thread.Sleep for coarse delays with spin-waiting for sub-millisecond precision, and automatically disables VSync to prevent interference with custom frame limiting.

Properties

Name	Type	Default	Description
`EnableThrottledRendering`	`bool`	`true`	Enables/disables throttled rendering feature
`FocusedFps`	`double`	`30.0`	Target frame rate when the window is focused and active
`UnfocusedFps`	`double`	`5.0`	Target frame rate when the window is unfocused
`IdleFps`	`double`	`10.0`	Target frame rate when the application is idle (no user input)
`NotVisibleFps`	`double`	`2.0`	Target frame rate when the window is not visible (minimized or hidden)
`EnableIdleDetection`	`bool`	`true`	Enables/disables idle detection based on user input
`IdleTimeoutSeconds`	`double`	`30.0`	Time in seconds without user input before considering the app idle

Example Usage

ImGuiApp.Start(new ImGuiAppConfig
{
 Title = "My Application",
 OnRender = OnRender,
 PerformanceSettings = new ImGuiAppPerformanceSettings
 {
 EnableThrottledRendering = true,
 FocusedFps = 60.0, // Custom higher rate when focused
 UnfocusedFps = 15.0, // Custom rate when unfocused
 IdleFps = 2.0, // Custom very low rate when idle
 NotVisibleFps = 1.0, // Custom ultra-low rate when minimized
 EnableIdleDetection = true,
 IdleTimeoutSeconds = 10.0 // Custom idle timeout
 }
 // PID controller uses optimized defaults: Kp=1.8, Ki=0.048, Kd=0.237
 // For fine-tuning, use Debug > Show Performance Monitor > Start Auto-Tuning
});

This feature automatically:

Uses a PID controller with optimized defaults for highly accurate frame rate targeting
Combines Thread.Sleep with spin-waiting for sub-millisecond timing precision
Disables VSync automatically to prevent interference with custom frame limiting
Detects when the window loses/gains focus and visibility state (minimized/hidden)
Tracks user input (keyboard, mouse movement, clicks, scrolling) for idle detection
Evaluates all applicable throttling conditions and selects the lowest frame rate
Saves significant CPU and GPU resources without affecting user experience
Provides instant transitions between different performance states
Uses conservative defaults: 30 FPS focused, 5 FPS unfocused, 10 FPS idle, 2 FPS not visible

The PID controller learns from timing errors and adapts to your system's characteristics, providing much more accurate frame rate control than simple sleep-based methods. The throttling system uses a "lowest wins" approach - if multiple conditions apply (e.g., unfocused + idle), the lowest frame rate is automatically selected for maximum resource savings.

`FontAppearance` Class

A utility class for applying font styles using a using statement.

Constructors

Constructor	Parameters	Description
`FontAppearance`	`string fontName`	Creates a font appearance with the named font at default size
`FontAppearance`	`float fontSize`	Creates a font appearance with the default font at the specified size
`FontAppearance`	`string fontName, float fontSize`	Creates a font appearance with the named font at the specified size

`ImGuiAppWindowState` Class

Represents the state of the application window.

Properties

Name	Type	Description
`Size`	`Vector2`	The size of the window
`Pos`	`Vector2`	The position of the window
`LayoutState`	`WindowState`	The layout state of the window (Normal, Maximized, etc.)

Debug Features

ImGuiApp includes comprehensive debug logging capabilities to help troubleshoot crashes and performance issues:

Debug Logging

The application automatically creates debug logs on the desktop (ImGuiApp_Debug.log) when issues occur. These logs include:

Window initialization steps
OpenGL context creation
Font loading progress
Error conditions and exceptions

Debug Menu

When using the OnAppMenu callback, ImGuiApp automatically adds a Debug menu with options to:

Show ImGui Demo Window
Show ImGui Metrics Window
Show Performance Monitor (real-time FPS graphs and throttling visualization)

Performance Monitoring

The core library includes a built-in performance monitor accessible via the debug menu. It provides:

Real-time FPS tracking and visualization
Throttling state monitoring (focused/unfocused/idle/not visible)
Performance testing tips and interactive guidance
Historical performance data graphing

Access it through: Debug > Show Performance Monitor

Demo Application

Check out the included demo project to see a comprehensive working example:

Clone or download the repository
Open the solution in Visual Studio (or run dotnet build)
Start the ImGuiAppDemo project to see a feature-rich ImGui application
Explore the different tabs:
- Unicode & Emojis: Test character rendering with extended Unicode support
- Widgets & Layout: Comprehensive ImGui widget demonstrations
- Graphics & Plotting: Custom drawing and data visualization examples
- Nerd Font Icons: Browse and test various icon sets and glyphs
Use the debug menu to access additional features:
- Debug > Show Performance Monitor: Real-time FPS graph showing PID controller performance with comprehensive auto-tuning capabilities
- Debug > Show ImGui Demo: Official ImGui demo window
- Debug > Show ImGui Metrics: ImGui internal metrics and debugging info

The Performance Monitor includes:

Live FPS graphs that visualize frame rate changes as you focus/unfocus the window, let it go idle, or minimize it
PID Controller diagnostics showing real-time proportional, integral, and derivative values
Comprehensive Auto-Tuning with 3-phase optimization (Coarse, Fine, Precision phases)
Performance metrics including Average Error, Max Error, Stability, and composite Score
Interactive tuning controls to start/stop optimization and view detailed results

Perfect for seeing both the throttling system and PID controller work in real-time!

Contributing

Contributions are welcome! Here's how you can help:

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Please make sure to update tests as appropriate and adhere to the existing coding style.

License

This project is licensed under the MIT License - see the file for details.

Versioning

Check the for detailed release notes and version changes.

Acknowledgements

Dear ImGui - The immediate mode GUI library
Hexa.NET.ImGui - .NET bindings for Dear ImGui
Silk.NET - .NET bindings for OpenGL and windowing
All contributors and the .NET community for their support

Support

If you encounter any issues or have questions, please open an issue.

Product	Versions Compatible and additional computed target framework versions.
.NET	net8.0 net8.0 is compatible. net8.0-android net8.0-android was computed. net8.0-browser net8.0-browser was computed. net8.0-ios net8.0-ios was computed. net8.0-maccatalyst net8.0-maccatalyst was computed. net8.0-macos net8.0-macos was computed. net8.0-tvos net8.0-tvos was computed. net8.0-windows net8.0-windows was computed. net9.0 net9.0 is compatible. net9.0-android net9.0-android was computed. net9.0-browser net9.0-browser was computed. net9.0-ios net9.0-ios was computed. net9.0-maccatalyst net9.0-maccatalyst was computed. net9.0-macos net9.0-macos was computed. net9.0-tvos net9.0-tvos was computed. net9.0-windows net9.0-windows was computed. net10.0 net10.0 is compatible. net10.0-android net10.0-android was computed. net10.0-browser net10.0-browser was computed. net10.0-ios net10.0-ios was computed. net10.0-maccatalyst net10.0-maccatalyst was computed. net10.0-macos net10.0-macos was computed. net10.0-tvos net10.0-tvos was computed. net10.0-windows net10.0-windows was computed.

Product

Versions Compatible and additional computed target framework versions.

.NET

net8.0 net8.0 is compatible. net8.0-android net8.0-android was computed. net8.0-browser net8.0-browser was computed. net8.0-ios net8.0-ios was computed. net8.0-maccatalyst net8.0-maccatalyst was computed. net8.0-macos net8.0-macos was computed. net8.0-tvos net8.0-tvos was computed. net8.0-windows net8.0-windows was computed. net9.0 net9.0 is compatible. net9.0-android net9.0-android was computed. net9.0-browser net9.0-browser was computed. net9.0-ios net9.0-ios was computed. net9.0-maccatalyst net9.0-maccatalyst was computed. net9.0-macos net9.0-macos was computed. net9.0-tvos net9.0-tvos was computed. net9.0-windows net9.0-windows was computed. net10.0 net10.0 is compatible. net10.0-android net10.0-android was computed. net10.0-browser net10.0-browser was computed. net10.0-ios net10.0-ios was computed. net10.0-maccatalyst net10.0-maccatalyst was computed. net10.0-macos net10.0-macos was computed. net10.0-tvos net10.0-tvos was computed. net10.0-windows net10.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net10.0
- Hexa.NET.ImGui (>= 2.2.9)
- Hexa.NET.ImGuizmo (>= 2.2.9)
- Hexa.NET.ImNodes (>= 2.2.9)
- Hexa.NET.ImPlot (>= 2.2.9)
- ktsu.Invoker (>= 1.2.2)
- ktsu.ScopedAction (>= 1.1.11)
- ktsu.Semantics.Paths (>= 1.1.1)
- ktsu.Semantics.Strings (>= 1.1.1)
- Microsoft.SourceLink.AzureRepos.Git (>= 10.0.300)
- Microsoft.SourceLink.GitHub (>= 10.0.300)
- Polyfill (>= 10.8.1)
- Silk.NET (>= 2.23.0)
- Silk.NET.Input (>= 2.23.0)
- Silk.NET.Input.Sdl (>= 2.23.0)
- Silk.NET.OpenGL (>= 2.23.0)
- Silk.NET.Windowing (>= 2.23.0)
- Silk.NET.Windowing.Sdl (>= 2.23.0)
- SixLabors.ImageSharp (>= 4.0.0)
net8.0
- Hexa.NET.ImGui (>= 2.2.9)
- Hexa.NET.ImGuizmo (>= 2.2.9)
- Hexa.NET.ImNodes (>= 2.2.9)
- Hexa.NET.ImPlot (>= 2.2.9)
- ktsu.Invoker (>= 1.2.2)
- ktsu.ScopedAction (>= 1.1.11)
- ktsu.Semantics.Paths (>= 1.1.1)
- ktsu.Semantics.Strings (>= 1.1.1)
- Microsoft.SourceLink.AzureRepos.Git (>= 10.0.300)
- Microsoft.SourceLink.GitHub (>= 10.0.300)
- Polyfill (>= 10.8.1)
- Silk.NET (>= 2.23.0)
- Silk.NET.Input (>= 2.23.0)
- Silk.NET.Input.Sdl (>= 2.23.0)
- Silk.NET.OpenGL (>= 2.23.0)
- Silk.NET.Windowing (>= 2.23.0)
- Silk.NET.Windowing.Sdl (>= 2.23.0)
- SixLabors.ImageSharp (>= 4.0.0)
net9.0
- Hexa.NET.ImGui (>= 2.2.9)
- Hexa.NET.ImGuizmo (>= 2.2.9)
- Hexa.NET.ImNodes (>= 2.2.9)
- Hexa.NET.ImPlot (>= 2.2.9)
- ktsu.Invoker (>= 1.2.2)
- ktsu.ScopedAction (>= 1.1.11)
- ktsu.Semantics.Paths (>= 1.1.1)
- ktsu.Semantics.Strings (>= 1.1.1)
- Microsoft.SourceLink.AzureRepos.Git (>= 10.0.300)
- Microsoft.SourceLink.GitHub (>= 10.0.300)
- Polyfill (>= 10.8.1)
- Silk.NET (>= 2.23.0)
- Silk.NET.Input (>= 2.23.0)
- Silk.NET.Input.Sdl (>= 2.23.0)
- Silk.NET.OpenGL (>= 2.23.0)
- Silk.NET.Windowing (>= 2.23.0)
- Silk.NET.Windowing.Sdl (>= 2.23.0)
- SixLabors.ImageSharp (>= 4.0.0)

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
2.15.2	91	6/13/2026
2.15.1	59	6/13/2026
2.15.0	159	6/9/2026
2.14.3	127	6/8/2026
2.14.2	128	6/8/2026
2.14.1	117	6/8/2026
2.14.0	125	6/8/2026
2.13.3	126	6/7/2026
2.13.2	136	6/7/2026
2.13.1	124	6/7/2026
2.13.0	121	6/7/2026
2.12.0	121	6/7/2026
2.11.0	130	6/6/2026
2.10.0	133	6/6/2026
2.9.1	141	6/3/2026
2.9.0	232	6/2/2026
2.8.0	132	6/1/2026
2.7.0	131	6/1/2026
2.6.0	163	5/31/2026
2.5.0	153	5/29/2026

Loading failed

## v2.15.2 (patch)

Changes since v2.15.1:

- [patch] Fix FilesystemBrowser crash on open ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.15.1 (patch)

Changes since v2.15.0:

- ci: supply SixLabors.ImageSharp 4 license key via SIXLABORS_LICENSE_KEY ([@Claude](https://github.com/Claude))

## v2.15.0 (minor)

Changes since v2.14.0:

- Fix floating-point equality reliability issue in XYPad ([@Claude](https://github.com/Claude))
- Fix analyzer errors in embedded hosting and audio widgets ([@Claude](https://github.com/Claude))
- Add embedded-window hosting and audio widgets ([@Claude](https://github.com/Claude))
- feat(ios): curated ImGuiAppDemo.iOS showcase + simulator CI (Task 8, part 3) (#213) ([@matt-edmondson](https://github.com/matt-edmondson))
- fix(ios): import ktsu.Semantics.Strings for string.As<AbsoluteFilePath> ([@Claude](https://github.com/Claude))
- feat(ios): public texture loading via the Metal backend (Task 8, part 2) ([@Claude](https://github.com/Claude))

## v2.14.3 (patch)

Changes since v2.14.2:

- Bump Polyfill from 10.8.0 to 10.8.1 ([@dependabot[bot]](https://github.com/dependabot[bot]))
- Bump the ktsu group with 3 updates ([@dependabot[bot]](https://github.com/dependabot[bot]))

## v2.14.2 (patch)

Changes since v2.14.1:

- feat(ios): curated ImGuiAppDemo.iOS showcase + simulator CI (Task 8, part 3) (#213) ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.14.1 (patch)

Changes since v2.14.0:

- fix(ios): import ktsu.Semantics.Strings for string.As<AbsoluteFilePath> ([@Claude](https://github.com/Claude))
- feat(ios): public texture loading via the Metal backend (Task 8, part 2) ([@Claude](https://github.com/Claude))

## v2.14.0 (minor)

Changes since v2.13.0:

- feat(ios): AutoDiscoverExtensions flag (Task 8, part 1) (#211) ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(ios): app menu (iPad) + Stop() semantics + no-op surface (Task 7) (#210) ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(ios): font parity + imgui.ini redirect (Task 6) (#209) ([@matt-edmondson](https://github.com/matt-edmondson))
- ci: fix intermittent coverage broken-pipe flake (exit code 7) (#208) ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.13.3 (patch)

Changes since v2.13.2:

- feat(ios): app menu (iPad) + Stop() semantics + no-op surface (Task 7) (#210) ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.13.2 (patch)

Changes since v2.13.1:

- feat(ios): font parity + imgui.ini redirect (Task 6) (#209) ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.13.1 (patch)

Changes since v2.13.0:

- ci: fix intermittent coverage broken-pipe flake (exit code 7) (#208) ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.13.0 (minor)

Changes since v2.12.0:

- feat(ios): touch + keyboard input (Task 5) (#207) ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.12.0 (minor)

Changes since v2.11.0:

- docs(ios): mark Task 4 (Metal renderer) complete in the port plan ([@Claude](https://github.com/Claude))
- chore(ios): remove renderer bring-up diagnostics ([@Claude](https://github.com/Claude))
- fix(ios): use TextUnformatted to avoid the variadic igText ARM64 crash ([@Claude](https://github.com/Claude))
- diag(ios): trace OnRender draw calls + log font atlas dims ([@Claude](https://github.com/Claude))
- diag(ios): trace the frame loop to localise the render SIGSEGV ([@Claude](https://github.com/Claude))
- fix(ios): use non-normalized UChar4 for the ImGui vertex colour ([@Claude](https://github.com/Claude))
- fix(ios): write cimgui.dylib to an absolute path (root cause) ([@Claude](https://github.com/Claude))
- fix(ios): stash cimgui.dylib in RUNNER_TEMP so the embed step finds it ([@Claude](https://github.com/Claude))
- fix(ios): copy cimgui.dylib into the .app and dlopen by bundle path ([@Claude](https://github.com/Claude))
- fix(ios): ship cimgui as an embedded dynamic library, dlopen it ([@Claude](https://github.com/Claude))
- diag(ios): inspect the app binary for cimgui link/export status ([@Claude](https://github.com/Claude))
- fix(ios): export dynamic symbols so dlsym resolves static cimgui ([@Claude](https://github.com/Claude))
- diag(ios): probe cimgui symbol resolution before first ImGui call ([@Claude](https://github.com/Claude))
- fix(ios): use ImGui.GetVersionS() for the smoke version probe ([@Claude](https://github.com/Claude))
- fix(ios): pin cimgui to a consistent 1.92.3 docking commit ([@Claude](https://github.com/Claude))
- feat(ios): statically link cimgui so ImGui runs on iOS ([@Claude](https://github.com/Claude))
- fix(ios): satisfy KTSU0003/CA2000 analyzers in the Metal backend ([@Claude](https://github.com/Claude))
- feat(ios): Metal renderer backend (Task 4) - stand up ImGui frames on iOS ([@Claude](https://github.com/Claude))
- wip(ios): begin Metal renderer (Task 4) - shader + frame-loop scaffolding ([@Claude](https://github.com/Claude))

## v2.11.0 (minor)

Changes since v2.10.0:

- ci(ios): iOS-simulator smoke test for the lifecycle (#205) ([@matt-edmondson](https://github.com/matt-edmondson))
- ci: re-trigger (flaky ForceDirectedLayout test-host abort) ([@Claude](https://github.com/Claude))
- test: drop redundant (nint) casts on int literals (IDE0004) ([@Claude](https://github.com/Claude))
- [minor] Make GPU texture handles nint end-to-end for the Metal backend ([@Claude](https://github.com/Claude))

## v2.10.0 (minor)

Changes since v2.9.0:

- iOS: satisfy analyzers/nullability in the UIKit lifecycle ([@Claude](https://github.com/Claude))
- docs: record resolved iOS-port design decisions ([@Claude](https://github.com/Claude))
- iOS: native UIKit lifecycle (UIApplicationDelegate + CADisplayLink) ([@Claude](https://github.com/Claude))
- ci: re-trigger workflow (flaky unrelated tests) ([@Claude](https://github.com/Claude))
- iOS: fix net10.0-ios compile errors from the config decoupling ([@Claude](https://github.com/Claude))
- iOS: make the config surface platform-neutral and align Start signature ([@Claude](https://github.com/Claude))

## v2.9.1 (patch)

Changes since v2.9.0:

- Bump Polyfill from 10.7.0 to 10.8.0 ([@dependabot[bot]](https://github.com/dependabot[bot]))

## v2.9.0 (minor)

Changes since v2.8.0:

- Exclude ImGuiAppBlend.cs from the iOS build ([@Claude](https://github.com/Claude))
- Honor ImGui draw-command callbacks; add per-region blend modes ([@Claude](https://github.com/Claude))

## v2.8.0 (minor)

Changes since v2.7.0:

- Remap canvas and restore window on overlay enter/exit ([@Claude](https://github.com/Claude))

## v2.7.0 (minor)

Changes since v2.6.0:

- Refactor SuppressMessage attributes for static fields in ImGuiApp ([@matt-edmondson](https://github.com/matt-edmondson))
- [patch] Fix "Renderer backend is not initialized" when loading textures from OnStart ([@matt-edmondson](https://github.com/matt-edmondson))
- [minor] Fix SonarQube issues: safe fixes and justified suppressions (round 2/2) ([@matt-edmondson](https://github.com/matt-edmondson))
- [minor] Fix SonarQube issues: safe fixes and justified suppressions (round 1/2) ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.6.0 (minor)

Changes since v2.5.0:

- Exclude native C ABI shim from code coverage to fix CI test crash ([@matt-edmondson](https://github.com/matt-edmondson))
- Fix IDE0055 formatting in demo overlay settings ([@Claude](https://github.com/Claude))
- [minor] Add canonical overlay-mode window support ([@Claude](https://github.com/Claude))
- Fix typo in library name in README.md ([@matt-edmondson](https://github.com/matt-edmondson))
- docs: correct package names and audit documentation ([@Claude](https://github.com/Claude))

## v2.5.0 (minor)

Changes since v2.4.0:

- Remove version number from VERSION.md ([@matt-edmondson](https://github.com/matt-edmondson))
- style: drop unused using and use id for skeleton shimmer offset ([@Claude](https://github.com/Claude))
- [minor] Add hidden-start and hide-on-close window support ([@matt-edmondson](https://github.com/matt-edmondson))
- feat: add Card, SkeletonLoader, and PinInput mobile widgets ([@Claude](https://github.com/Claude))
- style: remove redundant parentheses in Avatar hue calc (IDE0047) ([@Claude](https://github.com/Claude))
- feat: add mobile decorator widgets (Avatar, Badge, Rating, PageIndicator) ([@Claude](https://github.com/Claude))
- ci: re-trigger after flaky code-coverage pipe-disconnect at test session end ([@Claude](https://github.com/Claude))
- ci: re-trigger after flaky NodeGraph.Tests coverage pipe disconnect ([@Claude](https://github.com/Claude))
- style: drop redundant parentheses in RangeSlider tooltip guard (IDE0047) ([@Claude](https://github.com/Claude))
- Fix knob drag value accumulation and stale indicator ([@Claude](https://github.com/Claude))
- feat: add mobile form-control widgets [minor] ([@Claude](https://github.com/Claude))
- feat: add OverlayHost z-ordered overlay manager for ImGui.Widgets ([@Claude](https://github.com/Claude))
- ci: re-trigger after flaky PidFrameLimiter sleep-timing test ([@Claude](https://github.com/Claude))
- style: drop unused System using from InertialScrollTests ([@Claude](https://github.com/Claude))
- style: split inline if-statements in InertialScrollTests for IDE2001 ([@Claude](https://github.com/Claude))
- feat: add InertialScroll helper for ImGui.Widgets ([@Claude](https://github.com/Claude))
- docs: degrade ImGuiController cref to <c> for iOS-tfm doc-build ([@Claude](https://github.com/Claude))
- ci: make the iOS stub actually compile on macos-14 ([@Claude](https://github.com/Claude))
- fix: collapse Spring construction into object initializers (IDE0017) ([@Claude](https://github.com/Claude))
- ci: also clear ktsu.Sdk's forced RuntimeIdentifiers on the macOS iOS build ([@Claude](https://github.com/Claude))
- ci: scope iOS restore/build to net10.0-ios only ([@Claude](https://github.com/Claude))
- feat: add Tween, Spring, and Easing animation primitives ([@Claude](https://github.com/Claude))
- ci: add macos-14 job that compile-checks net10.0-ios ([@Claude](https://github.com/Claude))
- feat: add gesture detection foundation for ImGui.Widgets [minor] ([@Claude](https://github.com/Claude))
- docs: plan for mobile UI widgets in ImGui.Widgets ([@Claude](https://github.com/Claude))
- refactor: introduce IRendererBackend seam for the iOS port ([@Claude](https://github.com/Claude))
- docs: design plan for iOS platform port ([@Claude](https://github.com/Claude))
- fix: downgrade SixLabors.ImageSharp to 3.1.12 to restore CI ([@Claude](https://github.com/Claude))
- feat: scaffold net10.0-ios target for ImGui.App ([@Claude](https://github.com/Claude))
- fix: resolve IDE0221 and IDE0380 warnings treated as errors ([@Claude](https://github.com/Claude))
- fix: downgrade SixLabors.ImageSharp from 4.0.0 to 3.1.12 ([@Claude](https://github.com/Claude))
- fix: exclude NativeExports.cs from all SonarCloud analysis ([@Claude](https://github.com/Claude))
- fix: add InternalsVisibleTo for test project (KTSU0002) ([@Claude](https://github.com/Claude))
- fix: suppress CA1823 for intentional ABI struct padding fields ([@Claude](https://github.com/Claude))
- fix: exclude NativeExports.cs from SonarCloud coverage analysis ([@Claude](https://github.com/Claude))
- fix: address MSTest and code analysis violations in ForceDirectedLayout.Tests ([@Claude](https://github.com/Claude))
- fix: convert array initializers to collection expressions in ForceLayoutTests ([@Claude](https://github.com/Claude))
- Fix CI exit code propagation and SonarCloud quality gate failures ([@Claude](https://github.com/Claude))
- Add C ABI surface and AOT-friendly double-precision core ([@Claude](https://github.com/Claude))
- Extract force-directed layout into ktsu.ForceDirectedLayout ([@Claude](https://github.com/Claude))
- Update base directory path ([@Damon3000s](https://github.com/Damon3000s))
- Copy ktsu.png to output directory for ImGuiWidgetsDemo ([@Damon3000s](https://github.com/Damon3000s))
- Fix ImGuiPopupsDemo csproj inclusion ([@Damon3000s](https://github.com/Damon3000s))
- Missed file from dotnet format ([@Damon3000s](https://github.com/Damon3000s))
- Results from dotnet format ([@Damon3000s](https://github.com/Damon3000s))
- Add DESCRIPTION.md and TAGS.md files; update README.md with comprehensive library details and usage examples ([@matt-edmondson](https://github.com/matt-edmondson))
- Add SonarLint configuration for connected mode ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.4.0 (minor)

Changes since v2.3.0:

- feat(timers): Add countdown and count-up timer demos with radial progress indicators ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove legacy build scripts ([@matt-edmondson](https://github.com/matt-edmondson))
- Increase MaxForce values in PhysicsSettings and demo to enhance simulation capabilities ([@matt-edmondson](https://github.com/matt-edmondson))
- Add directional bias setting and calculation for horizontal link forces ([@matt-edmondson](https://github.com/matt-edmondson))
- Update physics settings: adjust repulsion strength, origin anchor weight, damping factor, and link length for improved simulation dynamics ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance physics settings: add OriginAnchorWeight for gravity target blending and initialize world origin to centroid for improved simulation accuracy ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor gravity force calculation: simplify magnitude computation by removing distance factor ([@matt-edmondson](https://github.com/matt-edmondson))
- Update repulsion strength in physics settings for enhanced simulation performance ([@matt-edmondson](https://github.com/matt-edmondson))
- Adjust repulsion strength limits in physics settings for improved simulation accuracy ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor gravity calculations: update to use centroid for cohesion force and improve rendering of gravity center ([@matt-edmondson](https://github.com/matt-edmondson))
- Refine physics settings: adjust damping factor description and clamp minimum repulsion distance to prevent force explosions ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance physics simulation: add node pinning and stability detection features ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.3.3 (patch)

Changes since v2.3.2:

- Remove legacy build scripts ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.3.2 (patch)

Changes since v2.3.1:

- Sync .github\workflows\dotnet.yml ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync global.json ([@ktsu[bot]](https://github.com/ktsu[bot]))

## v2.3.1 (patch)

Changes since v2.3.0:

- Increase MaxForce values in PhysicsSettings and demo to enhance simulation capabilities ([@matt-edmondson](https://github.com/matt-edmondson))
- Add directional bias setting and calculation for horizontal link forces ([@matt-edmondson](https://github.com/matt-edmondson))
- Update physics settings: adjust repulsion strength, origin anchor weight, damping factor, and link length for improved simulation dynamics ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance physics settings: add OriginAnchorWeight for gravity target blending and initialize world origin to centroid for improved simulation accuracy ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor gravity force calculation: simplify magnitude computation by removing distance factor ([@matt-edmondson](https://github.com/matt-edmondson))
- Update repulsion strength in physics settings for enhanced simulation performance ([@matt-edmondson](https://github.com/matt-edmondson))
- Adjust repulsion strength limits in physics settings for improved simulation accuracy ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor gravity calculations: update to use centroid for cohesion force and improve rendering of gravity center ([@matt-edmondson](https://github.com/matt-edmondson))
- Refine physics settings: adjust damping factor description and clamp minimum repulsion distance to prevent force explosions ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance physics simulation: add node pinning and stability detection features ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.3.0 (minor)

Changes since v2.2.0:

- [patch] Guard BeginFrame against calling native extensions without ImGui context ([@matt-edmondson](https://github.com/matt-edmondson))
- [minor] Add CleanImNodesDemo with physics simulation and attribute-based node editor ([@matt-edmondson](https://github.com/matt-edmondson))
- [minor] Add ImGuiNodeEditor with physics simulation and attribute-based node factory ([@matt-edmondson](https://github.com/matt-edmondson))
- [minor] Add NodeGraph test suite with 106 tests covering attributes, pins, type system, and validation ([@matt-edmondson](https://github.com/matt-edmondson))
- [minor] Add NodeGraph library with attribute-based node definitions ([@matt-edmondson](https://github.com/matt-edmondson))
- [minor] Refactor demo app with modular tab-based architecture and extension demos ([@matt-edmondson](https://github.com/matt-edmondson))
- [minor] Add unit tests for ImGuiExtensionManager ([@matt-edmondson](https://github.com/matt-edmondson))
- [minor] Integrate ImGuiExtensionManager into ImGuiController lifecycle ([@matt-edmondson](https://github.com/matt-edmondson))
- [minor] Add ImGuiExtensionManager for optional ImGuizmo, ImNodes, and ImPlot support ([@matt-edmondson](https://github.com/matt-edmondson))
- [minor] Add Hexa.NET.ImGuizmo, ImNodes, and ImPlot package references ([@matt-edmondson](https://github.com/matt-edmondson))
- Add visibility control for tabs in TabPanel ([@matt-edmondson](https://github.com/matt-edmondson))
- Exclude test projects from packaging and publishing processes in Invoke-DotNetPack and Invoke-DotNetPublish functions ([@matt-edmondson](https://github.com/matt-edmondson))
- Add compatibility suppressions for DefaultInterpolatedStringHandler in multiple modules ([@matt-edmondson](https://github.com/matt-edmondson))
- Add compatibility suppressions for DynamicallyAccessedMemberTypes and ExperimentalAttribute in ImGui.Popups, ImGui.Styler, and ImGui.Widgets for .NET 10.0 ([@matt-edmondson](https://github.com/matt-edmondson))
- Refine glyph area calculations and atlas fitting checks for improved memory management ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor null checks to use Ensure.NotNull for improved readability and consistency ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance project name matching to handle variations in repository naming conventions ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance CalculateOptimalPixelSize to consider global accessibility scale for improved rendering ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor null argument checks to use Ensure.NotNull for improved readability ([@matt-edmondson](https://github.com/matt-edmondson))
- Improve search box hint display logic based on available width ([@matt-edmondson](https://github.com/matt-edmondson))
- Add CLAUDE.md for project guidance and architecture overview ([@matt-edmondson](https://github.com/matt-edmondson))
- migrate to dotnet 10 ([@matt-edmondson](https://github.com/matt-edmondson))
- Dont show the close button on tabs inside a non-closable tab bar ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.2.12-pre.1 (prerelease)

Changes since v2.2.11:

- Fix all formatting errors to make build green ([@copilot-swe-agent[bot]](https://github.com/copilot-swe-agent[bot]))
- Change default direction to clockwise and add StartAtBottom option ([@copilot-swe-agent[bot]](https://github.com/copilot-swe-agent[bot]))
- Update README example function name to follow conventions ([@copilot-swe-agent[bot]](https://github.com/copilot-swe-agent[bot]))
- Add input validation and optimize string allocation ([@copilot-swe-agent[bot]](https://github.com/copilot-swe-agent[bot]))
- Fix clockwise/counter-clockwise logic and remove empty if block ([@copilot-swe-agent[bot]](https://github.com/copilot-swe-agent[bot]))
- Add RadialProgressBar widget implementation and demo ([@copilot-swe-agent[bot]](https://github.com/copilot-swe-agent[bot]))
- Initial plan ([@copilot-swe-agent[bot]](https://github.com/copilot-swe-agent[bot]))

## v2.2.11 (patch)

Changes since v2.2.10:

- Add visibility control for tabs in TabPanel ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.2.11-pre.2 (prerelease)

Changes since v2.2.11-pre.1:

- Merge remote-tracking branch 'refs/remotes/origin/main' ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync scripts\update-winget-manifests.ps1 ([@ktsu[bot]](https://github.com/ktsu[bot]))

## v2.2.11-pre.1 (prerelease)

No significant changes detected since v2.2.11.

## v2.2.10 (patch)

Changes since v2.2.9:

- Exclude test projects from packaging and publishing processes in Invoke-DotNetPack and Invoke-DotNetPublish functions ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.2.10-pre.2 (prerelease)

Changes since v2.2.10-pre.1:

- Merge remote-tracking branch 'refs/remotes/origin/main' ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync global.json ([@ktsu[bot]](https://github.com/ktsu[bot]))

## v2.2.10-pre.1 (prerelease)

No significant changes detected since v2.2.10.

## v2.2.9 (patch)

Changes since v2.2.8:

- Add compatibility suppressions for DefaultInterpolatedStringHandler in multiple modules ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.2.9-pre.2 (prerelease)

Changes since v2.2.9-pre.1:

- Merge remote-tracking branch 'refs/remotes/origin/main' ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync global.json ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync COPYRIGHT.md ([@ktsu[bot]](https://github.com/ktsu[bot]))

## v2.2.9-pre.1 (prerelease)

No significant changes detected since v2.2.9.

## v2.2.8 (patch)

Changes since v2.2.7:

- Add compatibility suppressions for DynamicallyAccessedMemberTypes and ExperimentalAttribute in ImGui.Popups, ImGui.Styler, and ImGui.Widgets for .NET 10.0 ([@matt-edmondson](https://github.com/matt-edmondson))
- Refine glyph area calculations and atlas fitting checks for improved memory management ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor null checks to use Ensure.NotNull for improved readability and consistency ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.2.7 (patch)

Changes since v2.2.6:

- Remove .github\workflows\project.yml ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.2.6 (patch)

Changes since v2.2.5:

- Enhance project name matching to handle variations in repository naming conventions ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.2.5 (patch)

Changes since v2.2.4:

- Enhance CalculateOptimalPixelSize to consider global accessibility scale for improved rendering ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.2.4 (patch)

Changes since v2.2.3:

- Refactor null argument checks to use Ensure.NotNull for improved readability ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.2.3 (patch)

Changes since v2.2.2:

- Improve search box hint display logic based on available width ([@matt-edmondson](https://github.com/matt-edmondson))
- Add CLAUDE.md for project guidance and architecture overview ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.2.2 (patch)

Changes since v2.2.1:

- migrate to dotnet 10 ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.2.1 (patch)

Changes since v2.2.0:

- Dont show the close button on tabs inside a non-closable tab bar ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.2.1-pre.1 (prerelease)

No significant changes detected since v2.2.1.

## v2.2.0 (minor)

Changes since v2.1.0:

- Refactor glyph calculation for improved readability ([@matt-edmondson](https://github.com/matt-edmondson))
- [minor] Add dynamic atlas sizing and glyph limit calculation ([@matt-edmondson](https://github.com/matt-edmondson))
- Fix gpu detection priority ([@matt-edmondson](https://github.com/matt-edmondson))
- Update tests/ImGui.App.Tests/FontMemoryGuardTests.cs ([@matt-edmondson](https://github.com/matt-edmondson))
- Update ImGui.App/FontMemoryGuard.cs to improve null checking ([@matt-edmondson](https://github.com/matt-edmondson))
- Update ImGui.App/FontMemoryGuard.cs to have more specific matching criteria ([@matt-edmondson](https://github.com/matt-edmondson))
- Update variable name ImGui.App/ImGuiApp.cs ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance font initialization with memory management features ([@matt-edmondson](https://github.com/matt-edmondson))
- Fix missing package references ([@matt-edmondson](https://github.com/matt-edmondson))
- Increase timeout for build job to 20 minutes ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance project structure and testing: Added new dependencies in Directory.Packages.props, introduced a new Tests project in the solution, and updated project references. Refactored namespaces for consistency across multiple files. Updated test configurations and example projects to align with the new structure. ([@matt-edmondson](https://github.com/matt-edmondson))
- Update project structure and dependencies: Added new package versions in Directory.Packages.props, updated SDK versions in global.json, and refactored namespaces across multiple files for consistency. Removed the ImGui.Popups.Credential project and adjusted related references in the solution and project files. Enhanced test project configurations and updated example projects to reflect the new structure. ([@matt-edmondson](https://github.com/matt-edmondson))
- Initial combined commit ([@matt-edmondson](https://github.com/matt-edmondson))
- Fix NuGet package source URL in Invoke-NuGetPublish function: Updated the source URL to ensure correct package publishing to packages.ktsu.dev. ([@matt-edmondson](https://github.com/matt-edmondson))
- Add Ktsu package key support in build configuration: Updated the .NET CI workflow and PowerShell script to include an optional Ktsu package key for publishing. Enhanced documentation for the new parameter and added conditional publishing logic for Ktsu.dev. ([@matt-edmondson](https://github.com/matt-edmondson))
- Implement modern DPI awareness handling in Windows: Updated ForceDpiAware to utilize the latest DPI awareness APIs for better compatibility with windowing libraries. Added fallback mechanisms for older Windows versions and enhanced NativeMethods with new DPI awareness context functions. ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance window position validation logic: Implemented performance optimizations to skip unnecessary checks when window position and size remain unchanged. Added methods for better multi-monitor support, ensuring windows are relocated when insufficiently visible. Updated tests to verify new behavior and performance improvements. ([@matt-edmondson](https://github.com/matt-edmondson))
- Update package versions and clean up validation logic: Bump versions for Hexa.NET.ImGui, ktsu.ScopedAction, SixLabors.ImageSharp, System.Text.Json, and MSTest packages. Remove redundant validation checks from ImGuiApp configuration and corresponding tests. ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor ImGuiApp configuration handling: Introduced AdjustConfigForStartup method to automatically convert minimized window state to normal during startup, improving application reliability. Updated tests to validate this new behavior. ([@matt-edmondson](https://github.com/matt-edmondson))
- Update ImGuiApp configuration validation: Automatically convert minimized and fullscreen window states to normal during startup to prevent issues. Updated tests to reflect this change, ensuring proper state handling without exceptions. ([@matt-edmondson](https://github.com/matt-edmondson))
- Additional tests ([@matt-edmondson](https://github.com/matt-edmondson))
- Move debug logger into its own file and make it output to the appdata dir ([@matt-edmondson](https://github.com/matt-edmondson))
- Move debug logger into its own file and make it output to the appdata dir ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.1.10 (patch)

Changes since v2.1.9:

- Fix gpu detection priority ([@matt-edmondson](https://github.com/matt-edmondson))
- Update tests/ImGui.App.Tests/FontMemoryGuardTests.cs ([@matt-edmondson](https://github.com/matt-edmondson))
- Update ImGui.App/FontMemoryGuard.cs to improve null checking ([@matt-edmondson](https://github.com/matt-edmondson))
- Update ImGui.App/FontMemoryGuard.cs to have more specific matching criteria ([@matt-edmondson](https://github.com/matt-edmondson))
- Update variable name ImGui.App/ImGuiApp.cs ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance font initialization with memory management features ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.1.10-pre.2 (prerelease)

Changes since v2.1.10-pre.1:

- Sync scripts\PSBuild.psm1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync scripts\update-winget-manifests.ps1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .github\workflows\update-sdks.yml ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .github\workflows\dotnet.yml ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .github\dependabot.yml ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .editorconfig ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .gitattributes ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .runsettings ([@ktsu[bot]](https://github.com/ktsu[bot]))

## v2.1.10-pre.1 (prerelease)

No significant changes detected since v2.1.10.

## v2.1.9 (patch)

Changes since v2.1.8:

- Fix missing package references ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.1.8 (patch)

Changes since v2.1.7:

- Increase timeout for build job to 20 minutes ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance project structure and testing: Added new dependencies in Directory.Packages.props, introduced a new Tests project in the solution, and updated project references. Refactored namespaces for consistency across multiple files. Updated test configurations and example projects to align with the new structure. ([@matt-edmondson](https://github.com/matt-edmondson))
- Update project structure and dependencies: Added new package versions in Directory.Packages.props, updated SDK versions in global.json, and refactored namespaces across multiple files for consistency. Removed the ImGui.Popups.Credential project and adjusted related references in the solution and project files. Enhanced test project configurations and updated example projects to reflect the new structure. ([@matt-edmondson](https://github.com/matt-edmondson))
- Initial combined commit ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.1.7 (patch)

Changes since v2.1.6:

- Fix NuGet package source URL in Invoke-NuGetPublish function: Updated the source URL to ensure correct package publishing to packages.ktsu.dev. ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.1.6 (patch)

Changes since v2.1.5:

- Add Ktsu package key support in build configuration: Updated the .NET CI workflow and PowerShell script to include an optional Ktsu package key for publishing. Enhanced documentation for the new parameter and added conditional publishing logic for Ktsu.dev. ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.1.5 (patch)

Changes since v2.1.4:

- Implement modern DPI awareness handling in Windows: Updated ForceDpiAware to utilize the latest DPI awareness APIs for better compatibility with windowing libraries. Added fallback mechanisms for older Windows versions and enhanced NativeMethods with new DPI awareness context functions. ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.1.4 (patch)

Changes since v2.1.3:

- Enhance window position validation logic: Implemented performance optimizations to skip unnecessary checks when window position and size remain unchanged. Added methods for better multi-monitor support, ensuring windows are relocated when insufficiently visible. Updated tests to verify new behavior and performance improvements. ([@matt-edmondson](https://github.com/matt-edmondson))
- Update package versions and clean up validation logic: Bump versions for Hexa.NET.ImGui, ktsu.ScopedAction, SixLabors.ImageSharp, System.Text.Json, and MSTest packages. Remove redundant validation checks from ImGuiApp configuration and corresponding tests. ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.1.3 (patch)

Changes since v2.1.2:

- Add manual trigger support to GitHub Actions workflow: Enabled workflow_dispatch to allow manual execution of the .NET CI pipeline. ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.1.2 (patch)

Changes since v2.1.1:

- Refactor ImGuiApp configuration handling: Introduced AdjustConfigForStartup method to automatically convert minimized window state to normal during startup, improving application reliability. Updated tests to validate this new behavior. ([@matt-edmondson](https://github.com/matt-edmondson))
- Update ImGuiApp configuration validation: Automatically convert minimized and fullscreen window states to normal during startup to prevent issues. Updated tests to reflect this change, ensuring proper state handling without exceptions. ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.1.1 (patch)

Changes since v2.1.0:

- Additional tests ([@matt-edmondson](https://github.com/matt-edmondson))
- Move debug logger into its own file and make it output to the appdata dir ([@matt-edmondson](https://github.com/matt-edmondson))
- Move debug logger into its own file and make it output to the appdata dir ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.1.0 (minor)

Changes since v2.0.0:

- [minor] Implement PID-based frame limiting in ImGuiApp: Introduced a new PidFrameLimiter class for precise frame rate control, enhancing performance optimization. Updated documentation to reflect new features, including auto-tuning capabilities and real-time diagnostics. Adjusted rendering settings to disable VSync for improved frame limiting accuracy. ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance ImGuiApp documentation and features: Updated project overview, added detailed descriptions for performance optimization, debug logging, and Unicode support. Introduced performance monitoring capabilities with real-time FPS tracking and throttling visualization. Improved font management and DPI handling. Refactored configuration settings for better usability. Updated demo application to showcase new features. ([@matt-edmondson](https://github.com/matt-edmondson))
- Refact... (truncated due to NuGet length limits)

URL: https://www.nuget.org/packages/ktsu.ImGui.App/

⇱ NuGet Gallery | ktsu.ImGui.App 2.15.2

👁 Image ktsu.ImGui.App 2.15.2

ktsu.ImGui.App

Introduction

Features

Getting Started

Prerequisites

Installation

Package Manager Console

.NET CLI

Package Reference

Usage Examples

Basic Application

Custom Font Management

Unicode and Emoji Support

Texture Management

PID Frame Limiting

Key Features

Optimized Defaults

Configuration

Auto-Tuning Procedure

Technical Details

Full Application with Multiple Windows

API Reference

ImGuiApp Static Class

Properties

Methods

ImGuiAppConfig Class

Properties

ImGuiAppPerformanceSettings Class

Properties

Example Usage

FontAppearance Class

Constructors

ImGuiAppWindowState Class

Properties

Debug Features

Debug Logging

Debug Menu

Performance Monitoring

Demo Application

Contributing

License

Versioning

Acknowledgements

Support

net10.0

net8.0

net9.0

NuGet packages

GitHub repositories

👁 Image
ktsu.ImGui.App 2.15.2

`ImGuiApp` Static Class

`ImGuiAppConfig` Class

`ImGuiAppPerformanceSettings` Class

`FontAppearance` Class

`ImGuiAppWindowState` Class