| 1 | |
| 2 | # Configuration |
| 3 | |
| 4 | Dear ImGui outputs 16-bit vertex indices by default. |
| 5 | 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. |
| 6 | 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. |
| 7 | We are providing `imconfig_allegro5.h` that enables 32-bit indices. |
| 8 | 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. |
| 9 | |
| 10 | # How to Build |
| 11 | |
| 12 | ### On Ubuntu 14.04+ and macOS |
| 13 | |
| 14 | ```bash |
| 15 | g++ -DIMGUI_USER_CONFIG=\"examples/example_allegro5/imconfig_allegro5.h\" -I .. -I ../.. -I ../../backends main.cpp ../../backends/imgui_impl_allegro5.cpp ../../imgui*.cpp -lallegro -lallegro_main -lallegro_primitives -o allegro5_example |
| 16 | ``` |
| 17 | |
| 18 | On macOS, install Allegro with homebrew: `brew install allegro`. |
| 19 | |
| 20 | ### On Windows with Visual Studio's CLI |
| 21 | |
| 22 | You may install Allegro using vcpkg: |
| 23 | ``` |
| 24 | git clone https://github.com/Microsoft/vcpkg |
| 25 | cd vcpkg |
| 26 | bootstrap-vcpkg.bat |
| 27 | vcpkg install allegro5 --triplet=x86-windows ; for win32 |
| 28 | vcpkg install allegro5 --triplet=x64-windows ; for win64 |
| 29 | vcpkg integrate install ; register include / libs in Visual Studio |
| 30 | ``` |
| 31 | |
| 32 | Build: |
| 33 | ``` |
| 34 | set ALLEGRODIR=path_to_your_allegro5_folder |
| 35 | cl /Zi /MD /utf-8 /I %ALLEGRODIR%\include /DIMGUI_USER_CONFIG=\"examples/example_allegro5/imconfig_allegro5.h\" /I .. /I ..\.. /I ..\..\backends main.cpp ..\..\backends\imgui_impl_allegro5.cpp ..\..\imgui*.cpp /link /LIBPATH:%ALLEGRODIR%\lib allegro-5.0.10-monolith-md.lib user32.lib |
| 36 | ``` |