ShaderLab

ShaderLab is a Windows-only Vulkan 1.4 shader authoring tool. The implementation follows the staged plan in doc/implementation_plan.md; M1 is currently in progress.

Prerequisites

• Windows 10/11 x64
• Visual Studio 2022 with the MSVC x64 C++ workload
• CMake 3.25+
• Vulkan SDK 1.4+
• A local vcpkg checkout

Set VCPKG_ROOT to the vcpkg checkout, then configure, build, and test:

$env:VCPKG_ROOT = 'C:\path\to\vcpkg'
cmake --preset windows-msvc
cmake --build --preset debug
ctest --preset debug

For a non-interactive Vulkan initialization check (hidden window, exits after device creation):

$env:SHADERLAB_SMOKE_TEST = '1'
.\build\Debug\shaderlab.exe
Remove-Item Env:SHADERLAB_SMOKE_TEST

Pass a .gltf or .glb file as the first argument to load it. With no argument, ShaderLab looks for assets/models/DamagedHelmet/DamagedHelmet.gltf and otherwise uses a built-in cube:

.\build\Debug\shaderlab.exe 'C:\models\DamagedHelmet\DamagedHelmet.gltf'

M1 camera controls: hold the left mouse button to orbit; use W/S to dolly in/out.

Dependencies are pinned through the builtin-baseline in vcpkg.json. Build outputs and the manifest-mode installed tree remain local and are ignored by Git.

SHADERLAB_ASAN=ON is available as a CMake cache option for MSVC AddressSanitizer diagnostics.

Documentation

• doc/implementation_plan.md: milestone scope and commit policy
• doc/progress.md: verified progress and evidence
• doc/handover.md: continuation notes and invariants