summaryrefslogtreecommitdiffstats
path: root/lib/imgui-1.90.7/examples/example_allegro5/README.md
diff options
context:
space:
mode:
authorgramanas <anastasis.gramm2@gmail.com>2024-06-05 19:04:25 +0300
committergramanas <anastasis.gramm2@gmail.com>2024-06-05 19:04:25 +0300
commita6501b5d7ad204c3b998c843c7ed68ef7be323ba (patch)
tree1a442e6095abf160e36baa31a319858774cd1178 /lib/imgui-1.90.7/examples/example_allegro5/README.md
parent6af7e785890a322f60c21a51e3d41cd9015e6773 (diff)
downloadcgame-a6501b5d7ad204c3b998c843c7ed68ef7be323ba.tar.gz
cgame-a6501b5d7ad204c3b998c843c7ed68ef7be323ba.tar.bz2
cgame-a6501b5d7ad204c3b998c843c7ed68ef7be323ba.zip
more vks, stupid mutlistep build, and imgui
Diffstat (limited to 'lib/imgui-1.90.7/examples/example_allegro5/README.md')
-rw-r--r--lib/imgui-1.90.7/examples/example_allegro5/README.md36
1 files changed, 36 insertions, 0 deletions
diff --git a/lib/imgui-1.90.7/examples/example_allegro5/README.md b/lib/imgui-1.90.7/examples/example_allegro5/README.md
new file mode 100644
index 0000000..4af31f6
--- /dev/null
+++ b/lib/imgui-1.90.7/examples/example_allegro5/README.md
@@ -0,0 +1,36 @@
+
+# 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
+
+```bash
+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
+```
+
+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 /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
+```