48 lines
1.8 KiB
Markdown
48 lines
1.8 KiB
Markdown
# How to Build
|
|
|
|
## Windows with Visual Studio's IDE
|
|
|
|
Use the provided project file (`example_sdl2_cpu.vcxproj`) or open `imgui_examples.sln`.
|
|
|
|
## Windows with Visual Studio's CLI
|
|
|
|
Use `build_win32.bat` or directly:
|
|
```
|
|
set SDL2_DIR=path_to_your_sdl2_folder
|
|
cl /Zi /MD /utf-8 /I.. /I..\.. /I%SDL2_DIR%\include main.cpp ..\..\backends\imgui_impl_sdl2.cpp ..\..\backends\imgui_impl_cpu.cpp ..\..\imgui*.cpp /FeDebug/example_sdl2_cpu.exe /FoDebug/ /link /libpath:%SDL2_DIR%\lib\x86 SDL2.lib SDL2main.lib /subsystem:console
|
|
# ^^ include paths ^^ source files ^^ output exe ^^ output dir ^^ libraries
|
|
# or for 64-bit:
|
|
cl /Zi /MD /utf-8 /I.. /I..\.. /I%SDL2_DIR%\include main.cpp ..\..\backends\imgui_impl_sdl2.cpp ..\..\backends\imgui_impl_cpu.cpp ..\..\imgui*.cpp /FeDebug/example_sdl2_cpu.exe /FoDebug/ /link /libpath:%SDL2_DIR%\lib\x64 SDL2.lib SDL2main.lib /subsystem:console
|
|
```
|
|
|
|
## Linux and similar Unixes
|
|
|
|
Use the provided `Makefile` or directly:
|
|
```
|
|
c++ `sdl2-config --cflags` -I .. -I ../.. -I ../../backends \
|
|
main.cpp ../../backends/imgui_impl_sdl2.cpp ../../backends/imgui_impl_cpu.cpp ../../imgui*.cpp \
|
|
`sdl2-config --libs`
|
|
```
|
|
|
|
## macOS
|
|
|
|
Use the provided `Makefile` or directly:
|
|
```
|
|
brew install sdl2
|
|
c++ `sdl2-config --cflags` -I .. -I ../.. -I ../../backends \
|
|
main.cpp ../../backends/imgui_impl_sdl2.cpp ../../backends/imgui_impl_cpu.cpp ../../imgui*.cpp \
|
|
`sdl2-config --libs`
|
|
```
|
|
|
|
## Emscripten
|
|
|
|
Use `Makefile.emscripten`:
|
|
```sh
|
|
source /path/to/emsdk/emsdk_env.sh
|
|
make -f Makefile.emscripten
|
|
```
|
|
|
|
This makes `web/index.html`, `web/index.js`, and `web/index.wasm`.
|
|
|
|
This example keeps Dear ImGui on the CPU and allocates its framebuffer in the active SDL window surface format, rather than forcing a fixed RGBA32 output format.
|