SDL3CPlusPlus/README.md

SDL3CPlusPlus

A minimal SDL3 + Vulkan spinning cube demo.

Build

1. Install SDL3 development headers for your platform (e.g., libsdl3-dev on Debian/Ubuntu or the SDK from libsdl.org).
2. Install or update Conan 2.x and run

   conan install . --install-folder build --build=missing
   

   so that Conan brings in lua and the Vulkan loader + headers.
3. Configure the project with CMake using the generated Conan toolchain:

   cmake -B build -S .
   

4. Build the demo:

   cmake --build build
   

Vendor SDL3/Vulkan from source

If you cannot install the SDL3/Vulkan headers via the distro packages, run the helper to download and build them into vendor/install:

python3 scripts/setup_vendor_dependencies.py
cmake -S . -B build -DBUILD_SDL3_APP=ON -DCMAKE_BUILD_TYPE=Release
cmake --build build

Shaders are copied into build/shaders during configuration, so the demo can load the precompiled cube.{vert,frag}.spv.

Run

cmake --build build --target spinning_cube
./build/spinning_cube

If you need the Conan runtime environment (e.g., because dependencies set env vars), source build/conanrun.sh before launching the binary on Linux/macOS or run build\\conanrun.bat on Windows.