imgui/examples/README.txt

65 lines
2.7 KiB
Text
Raw Normal View History

2015-04-07 04:59:49 -05:00
Those are standalone ready-to-build applications to demonstrate ImGui.
2015-08-25 16:14:31 -05:00
Binaries of some of those demos are available at http://www.miracleworld.net/imgui/binaries
2015-11-29 04:53:03 -06:00
2015-07-16 15:27:35 -05:00
TL;DR;
- Newcomers, read 'PROGRAMMER GUIDE' in imgui.cpp for notes on how to setup ImGui in your codebase.
- Refer to 'opengl_example' to understand how the library is setup, it is the simplest one.
The other examples requires more boilerplate and are harder to read.
- If you are using of the backend provided here, so you can copy the imgui_impl_xxx.cpp/h files
to your project and use them unmodified.
- If you have your own engine, you probably want to start from 'opengl_example' and adapt it to
your engine, but you can read the other examples as well.
2015-07-16 15:27:35 -05:00
2015-07-09 09:39:44 -05:00
ImGui is highly portable and only requires a few things to run:
- Providing mouse/keyboard inputs
- Load the font atlas texture into graphics memory
2015-08-05 22:59:07 -05:00
- Providing a render function to render indexed textured triangles
- Optional: clipboard support, mouse cursor supports, Windows IME support, etc.
2015-07-09 09:39:44 -05:00
So this is essentially what those examples are doing + the obligatory cruft for portability.
2015-09-10 15:10:01 -05:00
Unfortunately in 2015 it is still tedious to create and maintain portable build files using external
libraries (the kind we're using here to create a window and render 3D triangles) without relying on
third party software. For most examples here I choose to provide:
- Makefiles for Linux/OSX
- Batch files for Visual Studio 2008+
- A .sln project file for Visual Studio 2010+
2015-04-07 04:59:49 -05:00
Please let me know if they don't work with your setup!
2015-07-09 09:39:44 -05:00
You can probably just import the imgui_impl_xxx.cpp/.h files into your own codebase or compile those
directly with a command-line compiler.
2015-04-07 04:59:49 -05:00
2015-02-24 03:59:56 -06:00
opengl_example/
2015-03-09 08:49:52 -05:00
OpenGL example, using GLFW + fixed pipeline.
2015-02-24 03:59:56 -06:00
This is simple and should work for all OpenGL enabled applications.
2015-07-09 09:39:44 -05:00
Prefer following this example to learn how ImGui works!
(You can use this code in a GL3/GL4 context but make sure you disable the programmable pipeline
by calling "glUseProgram(0)" before ImGui::Render.)
2015-02-24 03:59:56 -06:00
opengl3_example/
OpenGL example, using GLFW/GL3W + programmable pipeline.
This uses more modern OpenGL calls and custom shaders. It's more messy.
directx9_example/
DirectX9 example, Windows only.
directx11_example/
DirectX11 example, Windows only.
This is quite long and tedious, because: DirectX11.
ios_example/
2015-07-09 09:39:44 -05:00
iOS example.
2015-08-25 16:14:31 -05:00
Using Synergy to access keyboard/mouse data from server computer.
Synergy keyboard integration is rather hacky.
sdl_opengl_example/
2015-07-09 09:39:44 -05:00
SDL2 + OpenGL example.
2015-11-16 15:17:10 -06:00
sdl_opengl_example/
SDL2 + OpenGL3 example.
allegro5_example/
2015-07-09 09:39:44 -05:00
Allegro 5 example.
marmalade_example/
Marmalade example using IwGx