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).

Changes in 1.82.0

v1.82.0

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

Version 1.82.0. Published April 13, 2018

Age Rating: 4+

Average Rating

Your review

You can only review assets you've bought.


Gravatar

Anonymous 13 November 2018


Gravatar

Lord W 06 November 2018


Gravatar

Tristan T 01 November 2018


Gravatar

Anonymous 18 October 2018

Logo

rousr (Publisher) 18 October 2018

Thanks for the feedback! If you'd like to provide some information on what you didn't like, we'd be glad to help. We have a documentation site at https://imguigml.rou.sr/ as well as our discord where we are almost always available to help: https://discord.gg/QF9FKcb


Gravatar

Jonathan P 26 September 2018

If you need UI during development, this is it.

An amazing asset, and it's seriously bonkers that it's free.

I don't recommend using this for like... your actual game, but to get some debug UI up and running, there won't be anything faster and more featureful than this.


Gravatar

Felix O 26 September 2018


Gravatar

Felix O 26 September 2018


Gravatar

Samuel M 21 September 2018

Great port

Is it possible to get this cross platform because as a dll, it can only work on a windows machine. If you have multiple developers working on different systems (i.e Mac, Linux) they wont be able to use this

Logo

rousr (Publisher) 26 September 2018

I do believe there's also a Mac dylib included, no linux support as of yet. There's no linux IDE for GMS2 either, but I know you may want to create in-game editors with it that are 'shippable'


Gravatar

Anonymous 26 August 2018


Gravatar

Loi R 01 July 2018


Gravatar

Josh S 28 May 2018


Gravatar

Carl H 26 March 2018

This review was left for a previous version of this asset.


Gravatar

Anonymous 11 February 2018

This review was left for a previous version of this asset.


Gravatar

Anonymous 26 January 2018

This review was left for a previous version of this asset.


Gravatar

Victor L 24 January 2018

This review was left for a previous version of this asset.


Gravatar

Marcos F 31 December 2017

Nice extension

I have a suggestion, possible to work with ds_list and not array. I'm building a map editor and i need to use dynamic list. Array on gms cannot be destroyed.

This review was left for a previous version of this asset.

Logo

rousr (Publisher) 04 January 2018

That's a interesting idea. Array memory allocation is automatically handled by GMS so there is no need to worry about destroying them, GMS cleans them up for you. If you're using functions like the combo box you can just simply convert your list to an array real quick using a custom function ( list_to_array(list) ). At this time we think arrays are better suited due to inline creation and the freedom that comes with hassle free memory management. However, there may be limited support for lists in addition to arrays on certain functions in the near future.


Gravatar

Joshua A 30 December 2017

This review was left for a previous version of this asset.


Gravatar

Mattias P 15 December 2017

This review was left for a previous version of this asset.


Gravatar

Jacob G 14 December 2017

This review was left for a previous version of this asset.


Gravatar

Angelo E 11 December 2017

This review was left for a previous version of this asset.


Gravatar

Sebastian N 08 December 2017

This review was left for a previous version of this asset.


Gravatar

Brandon S 08 December 2017

GUI Troubles are Over!

There have been plenty of attempts at GUI libraries and some of them are okay but this is as complete as it gets. Free, open source and tons of functionality. Get this and learn it. Documentation isn't great because the original source code is lacking so I don't blame this developer for it but you can download the c++ source code which contains several examples that are really easy to transfer over to GM since this is a direct wrap.

This review was left for a previous version of this asset.

Logo

rousr (Publisher) 08 December 2017

Thanks for the review! I wanted to add that in the coming weeks I hope to be providing a lot more "how-to" style documentation as well as improve the reference doc detail since I don't expect everyone to be as savvy with the original C++ source, but that's a great solution in the interim :)


Gravatar

Consti C 07 December 2017

Impressed!

This review was left for a previous version of this asset.


Gravatar

Kyle A 09 May 2018


Gravatar

Anonymous 06 December 2017

This review was left for a previous version of this asset.

Package contents

Loading, please wait

What is the issue?

Back to Top