README.md (1547B)
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 ../.. 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 28 .\vcpkg integrate install ; optional, automatically register include/libs in Visual Studio 29 ``` 30 31 Build: 32 ``` 33 set ALLEGRODIR=path_to_your_allegro5_folder 34 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 35 ```