/ImGui

Immediate Mode GUI for C#

Primary LanguageC#GNU Affero General Public License v3.0AGPL-3.0

Hello ImGui,

Hello ImGui is an immediate mode GUI library inspired by IMGUI of Unity3D and dear imgui.

It's still a work in progress.

code sample

Now it runs on Win10, Linux(Ubuntu 16.04) and Android. See platforms. Mac and iPhone are not supported because I don't have them.

Get Started

Windows and Linux

  1. Clone ImGui
git clone https://github.com/zwcloud/ImGui.git
  1. Create a .NET6 console project and reference ImGui.
mkdir MyImGuiApp

Create MyImGuiApp.csproj with following content:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>exe</OutputType>
    <TargetFramework>net6.0</TargetFramework>
    <OutputTypeEx>exe</OutputTypeEx>
  </PropertyGroup>
  <ItemGroup>
    <ProjectReference Include=".\ImGui\src\ImGui\ImGui.csproj" />
  </ItemGroup>
</Project>
  1. Add follwing code files to your project,

    Program.cs

    namespace YourApp
    {
        class Program
        {
            [STAThread]
            static void Main()
            {
                Application.Init();
                Application.Run(new MainForm());
            }
        }
    }

    MainForm.cs

    namespace YourApp
    {
        public class MainForm : Form
        {
            public MainForm() : base(new Rect(320, 180, 1280, 720)) { }
    
            protected override void OnGUI()
            {
                //your GUI code here
                GUILayout.Label("Hello, ImGui!");
            }
        }
    }
  2. Build your project

  3. Run

    • run with Visual Studio 2022: Press F5
    • run on Windows/Linux:
      cd MyImGuiApp
      dotnet MyApp.dll
      
  4. Exit

    Press Esc or click the close button of the window.

Android

  1. Copy Android Templates project. Referenced shared project Demo can be removed if not needed.
  2. Add your GUI code in MainForm.OnGUI.
  3. Build and deploy it to your Android device.

Documentation

For now, please refer to the shared project Demo for how to use Hello ImGui.

Dependency

  • Xamarin.Android: Xamarin.Android provides open-source bindings of the Android SDK for use with .NET managed languages such as C#. It mainly provides C# runtime for ImGui.

Credits

ImGui doesn't depend on following projects, some code used by ImGui are taken from them.

  • BigGustave: Open, read and create PNG images in fully managed C#.
  • Typography: C# Font Reader (TrueType / OpenType / OpenFont) , Glyphs Layout and Rendering
  • OpenTK: low-level C# wrapper for OpenGL
  • CSharpGL: Object Oriented OpenGL in C#

Droid Sans and Terminus TTF fount, see fonts/ReadMe.

License

Hello ImGui is licensed under the AGPL License, see LICENSE for more information.