CompileRequest

Source files. They become one compilation, so they can see each other.

Where to write. A path with an extension is a file, and then the shader must produce exactly one unit; anything else is a directory.

Backend name, as TargetBackends knows it.

Values for the shader's [Permutation] keys, as Name=Value strings. Name alone means Name=true. Keys not named here take the default in the source.

Which shader fills each compose slot, as slot=Shader strings. The slot may be qualified by shader: Lit.diffuse=Lambert.

Compiled libraries to bind against, as paths to .rvnlib files.

Write a .rvnlib for this compilation instead of generating for a target.

Which shaders to write, by name. Empty writes every shader the compilation declares.

Also write the IR dump next to the generated sources.

For a binary target, also write the readable listing beside the bytes.

Print the target features the module requires, so a host can see what it will be asked to support.

Also write the reflection as JSON — the descriptor sets, member offsets and flattened parameter list the engine binds against.

Also write a .rvnfx per shader — the compiled effect the runtime loads instead of compiling: every stage's module, the reflection, the permutation key and a source hash.

Name every file as it is written.

Colour the diagnostics.