Hello ImGui,

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

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

Clone ImGui

git clone https://github.com/zwcloud/ImGui.git

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>

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!");
        }
    }
}

Build your project
Run
- run with Visual Studio 2022: Press F5
- run on Windows/Linux:
```
cd MyImGuiApp
dotnet MyApp.dll
```
Exit

Press Esc or click the close button of the window.

Android

Copy Android Templates project. Referenced shared project Demo can be removed if not needed.
Add your GUI code in MainForm.OnGUI.
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.

GodZza/ImGui