Description

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

It's currently available only on the Windows platform with macOS and 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 ]

Get this extension and others with the $1 Patron Tier! - [ Become a Patron! ]

[ rou.sr ]

End User Licence Agreement (EULA).

Changes in 1.80.2

  • v1.80.2
    • Updated extRousrDs
    • Added more options to imguigml_config for overriding the cursor and reporting errors without aborting.
  • v1.80.1
    • Fixed up the required / not required
  • v1.80.0
    • Adds show_error calls when ImGui asserts due to a misuse of imgui functions.

Version 1.80.2. Published January 20, 2018

Age Rating: 4+

Average Rating

Your review

You can only review assets you've bought.


Gravatar

Anonymous 11 February 2018


Gravatar

Anonymous 26 January 2018


Gravatar

Victor L 24 January 2018


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 06 December 2017

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


Gravatar

Anonymous 06 December 2017

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

Package contents

Total size 391 KB

assetpackage.yy 9.59 KB datafiles datafiles_yy extensions fonts objects rooms scripts shaders sprites

What is the issue?

Back to Top