1
0
mirror of https://github.com/ocornut/imgui.git synced 2024-11-13 18:50:58 +01:00
imgui/examples
2015-08-09 17:24:10 +02:00
..
allegro5_example Fixed documentation 2015-08-05 19:19:12 -06:00
directx9_example Updated projects to reference new files (#219) 2015-07-21 17:04:03 -06:00
directx11_example Merge remote-tracking branch 'origin' into 2015-07-cleanup 2015-08-05 09:32:29 -06:00
ios_example Simplified to not combine vert buffers like the opengl3 example 2015-07-08 09:01:10 -07:00
libs iOS example working based on modified OpenGL3 example + Synergy 2015-07-07 21:17:48 -06:00
opengl3_example Minor Windows adjustments 2015-08-09 17:24:10 +02:00
opengl_example Minor Windows adjustments 2015-08-09 17:24:10 +02:00
sdl_opengl_example Minor Windows adjustments 2015-08-09 17:24:10 +02:00
.gitignore Ignore lists 2015-01-20 01:04:34 +01:00
imgui_examples_msvc2010.sln Examples: Added 64-bit projects for MSVC 2015-03-14 10:09:53 +00:00
README.txt Update documentation 2015-08-05 21:59:07 -06:00

Those are standalone ready-to-build applications to demonstrate ImGui.
Binaries of those demos are available from the main GitHub page.

TL;DR; 
 Refer to 'opengl_example' (not 'opengl3_example') to understand how the library is setup.
 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.
 

ImGui is highly portable and only requires a few things to run:
 - Providing mouse/keyboard inputs
 - Load the font atlas texture into GPU memory
 - Providing a render function to render indexed textured triangles
 - Optional: clipboard support, mouse cursor supports, Windows IME support, etc.
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
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. 
Please let me know if they don't work with your setup!
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.

opengl_example/
    OpenGL example, using GLFW + fixed pipeline.
    This is simple and should work for all OpenGL enabled applications.
    Prefer following this example to learn how ImGui works!

opengl3_example/
    OpenGL example, using GLFW/GL3W + programmable pipeline.
    This uses more modern OpenGL calls and custom shaders.
    Even if your application is using modern OpenGL you are better off copying the code from the fixed pipeline version!
    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/
    iOS example.
    Using Synergy to access keyboard/mouse data from server computer. Synergy keyboard integration is rather hacky.

sdl_opengl_example/
    SDL2 + OpenGL example.

allegro5_example/
    Allegro 5 example.