Skip to content

lineCode/netImgui

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Summary

NetImgui is a library to remotely display and control Dear ImGui menus with an associated netImgui server application. Designed to painlessly integrate into existing codebase with few changes required to the existing logic.

NetImgui

Purpose

Initially created to assist game developers in debugging their game from a PC while it runs on console. However, its use can easily be extended to other fields.

1. Input ease of use

For programs running on hardware without easy access to a keyboard and mouse, netImgui provides the comfort of your computer's inputs while controlling it remotely.

NetImgui

2. Declutter display

Dear ImGui is often used to display relevant debug information during development, but its UI elements can obscure the regular window content. NetImgui sends the debug menus to a separate window, leaving the original display clutter-free and with freedom to use the entire screen for more elaborate debug content.

Before

DearImGui

With netImgui

netImGui

Integration

  • Download the latest version of netImgui.
  • Generate solutions and compile the netImguiServer application.
  • Add the content of Code\Client to your codebase.
  • In your codebase :
    • [once] Call NetImgui::Connect(...) (starts connection to netImguiServer).
    • [once] Call NetImgui::SendDataTexture(...) (upload your font texture to netImguiServer).
    • [Every Redraw]
      • Replace ImGui::NewFrame() call, with NetImgui::NewFrame().
      • Draw your ImGui menu as usual.
      • Replace ImGui::Render() call, with NetImgui::EndFrame().

(More integration details can be found on the Wiki and netImgui_Sample project can provides insights)

Note

  • Different Dear ImGui content can be displayed locally and remotely at the same time.
  • NetImgui::IsConnected and NetImgui::IsRemoteDraw can be used during menu udpate, to make decisions on what content to draw.

Release information

Version 1.0

Changes
  • Initial Release
  • netImgui server application
  • netImgui client code (for integration into external codebase)
To do
  • Support of addional texture formats
  • Commands to assign custom backgrounds
  • Handle Linear/sRGB vertex color format
  • Add logging information in netImgui server application
  • Profile and optimize performances
  • Add copy/past support
  • Add new Dear ImGui multi windows support (docking branch)

Release Notes

Contact

Author can be reach for feedback / comments at: zenengine3d (at) gmail . com

Credits

Sincere thanks to Omar Cornut for the incredible work on Dear ImGui.

Support of image formats with stb_image.h by Sean Barrett (public domain).

About

'Dear Imgui' remote access library and application

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 89.0%
  • C# 5.7%
  • C 4.3%
  • Other 1.0%