ImGuiGML

Description

ImGuiGML is a DLL / GML wrapper of the popular Dear ImGui, library for GameMaker Studio 2

It's currently available on the Windows and macOS platforms with Linux coming soon!

ImGui is a UI library designed for fast implementation and iteration, using an 'Immediate Mode GUI' paradigm You will primarily be putting your GUI functions in step events that are called each step, rather than an event / retained based paradigm of only making updates.

Installation Notes

• ​Import Assets from the ImGuiGML groups in each Resource
• Import Assets from the "(required)" marked groups (See note below)

You do not need to re-import the imgui​ object, it simply wraps events to make updating easier.

​​Note: ImGuiGML uses functions from rousrSuite​​. When importing assets from the extension, make sure to include any rousr (required) group. If you have any other rousr​extensions, you only need to keep one copy of each of these resources. If you do import multiples, GameMaker Studio 2 will rename the duplicates with a _1 at the end. You can simply delete any of the resources after importing the asset.

Usage

• drop the imguigml object into your game, and voila. it begins activated.
• call imguigml_deactivate(); and imguigml_activate() for hiding/showing, which also stops all updates.
  • imgui is inaccessible completely when deactivated
• Note: in some cases, its necessary to make sure imguigml_ready() is true right before calling functions using it.

For most imgui functions, it's a straight wrap! Call whatever you're looking for with:
imguigml_<function> as opposed to ImGui::<function> from the C++ analog.

Now, each step that you'd like to show some ImGui, just call all of the functions that make up your UI. See the example provided for details!

• Check out the example app!
• See the full documentation: http://imguigml.rou.sr/

Extension by babyjeans (Follow babyj3ans) Special Thanks to @net8floz for additional programming and the excellent example screenshots!

Special Special Thanks to JujuAdams for supporting the project!

Looking for support for a Rousr extension? - [ Join Our Discord ]

[ Become a Patron! ]

[ rou.sr ]

End User Licence Agreement (EULA).

Age Rating: None

Version

GMS2 - Version 1.82.0. Published April 13, 2018

v1.82.0

Added support for macOS!
Support is currently in a "beta" state, so let me know if there's any issues!