mirror of https://github.com/Drezil/imgui.git synced 2024-12-20 23:06:36 +00:00

History

ocornut 0b06c4b2b0 Merge branch 'master' into docking (will need further for io.AddFocusEvent) # Conflicts: # backends/imgui_impl_glfw.cpp # backends/imgui_impl_opengl3.cpp # backends/imgui_impl_sdl.cpp # backends/imgui_impl_win32.cpp # imgui.cpp		2021-08-19 17:25:12 +02:00
..
example_allegro5.vcxproj	Backends: OpenGL3: Embed our own minimal GL loader (amends). (#4445 )	2021-08-19 16:24:59 +02:00
example_allegro5.vcxproj.filters	Moved 'misc/natvis/imgui.natvis' to 'misc/debuggers/imgui.natvis'	2021-03-11 16:21:46 +01:00
imconfig_allegro5.h	Examples: Renamed example folders. (#1870 )	2018-06-10 15:42:14 +02:00
main.cpp	Merge branch 'master' into docking	2021-06-08 18:38:51 +02:00
README.md	Examples: SDL2: Accomodate for vcpkg install having headers in SDL2/SDL.h vs SDL.h + vcpkg related comments.	2021-06-08 17:10:24 +02:00

README.md

Configuration

Dear ImGui outputs 16-bit vertex indices by default. Allegro doesn't support them natively, so we have two solutions: convert the indices manually in imgui_impl_allegro5.cpp, or compile dear imgui with 32-bit indices. You can either modify imconfig.h that comes with Dear ImGui (easier), or set a C++ preprocessor option IMGUI_USER_CONFIG to find to a filename. We are providing imconfig_allegro5.h that enables 32-bit indices. Note that the backend supports BOTH 16-bit and 32-bit indices, but 32-bit indices will be slightly faster as they won't require a manual conversion.

How to Build

On Ubuntu 14.04+ and macOS

g++ -DIMGUI_USER_CONFIG=\"examples/example_allegro5/imconfig_allegro5.h\" -I .. -I ../.. main.cpp ../../backends/imgui_impl_allegro5.cpp ../../imgui*.cpp -lallegro -lallegro_main -lallegro_primitives -o allegro5_example

On macOS, install Allegro with homebrew: brew install allegro.

On Windows with Visual Studio's CLI

You may install Allegro using vcpkg:

git clone https://github.com/Microsoft/vcpkg
cd vcpkg
bootstrap-vcpkg.bat
vcpkg install allegro5 --triplet=x86-windows	; for win32
vcpkg install allegro5 --triplet=x64-windows	; for win64
vcpkg integrate install						    ; register include / libs in Visual Studio

Build:

set ALLEGRODIR=path_to_your_allegro5_folder
cl /Zi /MD /I %ALLEGRODIR%\include /DIMGUI_USER_CONFIG=\"examples/example_allegro5/imconfig_allegro5.h\" /I .. /I ..\.. main.cpp ..\..\backends\imgui_impl_allegro5.cpp ..\..\imgui*.cpp /link /LIBPATH:%ALLEGRODIR%\lib allegro-5.0.10-monolith-md.lib user32.lib