imgui/examples/README.txt

51 lines
2.2 KiB
Plaintext
Raw Normal View History

2015-04-07 12:59:49 +03:00
Those are standalone ready-to-build applications to demonstrate ImGui.
2015-07-09 17:39:44 +03:00
Binaries of those demos are available from the main GitHub page.
2015-07-16 23:27:35 +03:00
TL;DR;
Refer to 'opengl_example' (not 'opengl3_example') to understand how the library is setup.
2015-07-16 23:28:16 +03:00
Copy the imgui_impl_xxx.cpp/.h file you need if you are using one of the rendering backend used in an example.
If you are using a different or your own backend, copy opengl_example/imgui_impl_opengl.cpp/.h to get started.
2015-07-16 23:27:35 +03:00
2015-07-09 17:39:44 +03:00
ImGui is highly portable and only requires a few things to run:
- Providing mouse/keyboard inputs
- Load the font atlas texture into GPU memory
2015-08-06 06:59:07 +03:00
- Providing a render function to render indexed textured triangles
- Optional: clipboard support, mouse cursor supports, Windows IME support, etc.
2015-07-09 17:39:44 +03:00
So this is essentially what those examples are doing + the obligatory cruft for portability.
Unfortunately in 2015 it is still a massive pain to create and maintain portable build files using
2015-08-06 06:59:07 +03:00
external library like the ones we're using here to provide 3D rendering.
For most examples here I choose to provide Visual Studio 10 .sln files and Makefile for Linux/OSX.
2015-04-07 12:59:49 +03:00
Please let me know if they don't work with your setup!
2015-07-09 17:39:44 +03: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 12:59:49 +03:00
2015-02-24 12:59:56 +03:00
opengl_example/
2015-03-09 16:49:52 +03:00
OpenGL example, using GLFW + fixed pipeline.
2015-02-24 12:59:56 +03:00
This is simple and should work for all OpenGL enabled applications.
2015-07-09 17:39:44 +03:00
Prefer following this example to learn how ImGui works!
2015-02-24 12:59:56 +03:00
opengl3_example/
OpenGL example, using GLFW/GL3W + programmable pipeline.
2015-07-09 17:39:44 +03:00
This uses more modern OpenGL calls and custom shaders.
2015-07-16 23:27:35 +03:00
Even if your application is using modern OpenGL you are better off copying the code from the fixed pipeline version!
2015-03-09 16:49:52 +03:00
I don't think there is an advantage using this over the simpler example, but it is provided for reference.
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 17:39:44 +03:00
iOS example.
Using Synergy to access keyboard/mouse data from server computer. Synergy keyboard integration is rather hacky.
sdl_opengl_example/
2015-07-09 17:39:44 +03:00
SDL2 + OpenGL example.
allegro5_example/
2015-07-09 17:39:44 +03:00
Allegro 5 example.