zwcloud / ImGui

Immediate Mode GUI for C#
https://zwcloud.net/#project/imgui
GNU Affero General Public License v3.0
197 stars 21 forks source link
gui imgui

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 .NET7 console project and reference ImGui.

    mkdir MyImGuiApp

    Create MyImGuiApp.csproj with following content:

    <Project Sdk="Microsoft.NET.Sdk">
    <PropertyGroup>
    <OutputType>exe</OutputType>
    <TargetFramework>net7.0</TargetFramework>
    </PropertyGroup>
    <ItemGroup>
    <ProjectReference Include=".\ImGui\src\ImGui\ImGui.csproj" />
    </ItemGroup>
    </Project>
  2. Add Program.cs to your project,

    using ImGui;
    var demo = new Demo();
    Application.Run(new Form(new Rect(320, 180, 1280, 720)), () =>
    {
        demo.OnGUI();
        ImGui.GUILayout.Label("Hello, ImGui!");
    });
  3. Build your project

  4. Run

    • run with Visual Studio 2022: Press F5
    • run on Windows/Linux:
      cd MyImGuiApp
      dotnet MyApp.dll
  5. 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

Credits

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

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

License

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