UnrealImGui/README.md

62 lines
3.0 KiB
Markdown
Raw Normal View History

2017-10-10 22:16:51 +00:00
Unreal ImGui
============
[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE.md)
Unreal ImGui is an Unreal Engine 4 plug-in that integrates [Dear ImGui](https://github.com/ocornut/imgui) developed by Omar Cornut.
2017-10-10 22:16:51 +00:00
Dear ImGui is an immediate-mode graphical user interface library that is very lightweight and easy to use. It can be very useful when creating debugging tools.
2017-10-10 22:16:51 +00:00
:stop_button: Read Me First
---------------------------
2022-02-25 21:53:34 +00:00
Please note that this is a forked project from [https://github.com/segross/UnrealImGui](https://github.com/segross/UnrealImGui). I do not take credit for the work he's put into making Dear ImGui work in Unreal Engine. The work I've done to this fork is listed below.
2018-09-12 18:21:36 +00:00
I've removed large portions of this readme.md to keep redundant information between the base project and this fork to a minimum. If you wish to read the original readme.md, please see this link: [UnrealImGui ReadMe.md](https://github.com/segross/UnrealImGui/blob/master/README.md).
Also note that the NetImGui branch is not up to date with any of this fork's changes.
2022-02-25 21:53:34 +00:00
Fork Additions/Fixes
--------------------
- Updated core source files for Unreal Engine 5, new ImGui and ImPlot
2022-02-25 21:53:34 +00:00
- Updated Dear ImGui to 1.87
- Added ImPlot v0.13 WIP
2022-02-25 21:53:34 +00:00
- `ImGui::IsKey*` now functional with all known ImGui keys.
- Updated input handling flow to be [standard compliant](https://github.com/ocornut/imgui/issues/4921) with Dear ImGui 1.87 which makes ImGui react better at low FPS. Will add `IMGUI_DISABLE_OBSOLETE_KEYIO` preprocessor once I've ripped out old style input.
Status
------
UnrealImGui Version: 1.22
ImGui version: 1.87
ImPlot version: v0.13 WIP
2017-10-10 22:16:51 +00:00
Supported Unreal Engine version: 5.0*
2017-10-10 22:16:51 +00:00
\* *The original repository has support for later versions of UE4. I've not tested this fork on UE4 variants, I only know it works for UE5 currently.*
2017-10-10 22:16:51 +00:00
How to Set up
-------------
On top of reading the base repository's [How to Set up](https://github.com/segross/UnrealImGui/blob/master/README.md#how-to-set-up) segment, you'll need to add the following line to your `[GameName].Build.cs` file otherwise you'll get linking errors:
2017-10-10 22:16:51 +00:00
```cpp
// Tell the compiler we want to import the ImPlot symbols when linking against ImGui plugin
PrivateDefinitions.Add(string.Format("IMPLOT_API=DLLIMPORT"));
```
Using ImPlot
------------
It's pretty easy to use ImPlot, it's pretty much the same drill as using Dear ImGui with the UnrealImGui plugin. You can see documentation on how to use ImPlot here: [ImPlot](https://github.com/epezent/implot).
The only thing you won't need to do is call the `ImPlot::CreateContext()` and `ImPlot::DestroyContext` routines as they're already called when ImGui's context is created within UnrealImGui's guts.
2017-10-10 22:16:51 +00:00
See also
--------
- [Original Project by segross](https://github.com/segross/UnrealImGui)
2017-10-10 22:16:51 +00:00
- [Dear ImGui](https://github.com/ocornut/imgui)
- [ImPlot](https://github.com/epezent/implot)
2017-10-10 22:16:51 +00:00
License
-------
Unreal ImGui (and this fork) is licensed under the MIT License, see LICENSE for more information.