Skip to content
Project referenceDevelopmentEngine ccf7d03f

Inno.Rendering.Shaders.Tests combines public shader contracts, the BGFX authoring toolchain and ModuleHost. It tests frontend discovery and real offline native compilation without creating a GPU device. This is an engine shader-language guide to verification, not documentation for native binding APIs.

Frontend cases cover declarations, parameters, structs, arrays, macros/includes, source locations and cross-language interface agreement. Node definitions preserve stable input/output names, aggregate members and unambiguous type identities.

Registry and module cases exercise automatic discovery, candidate conflicts, provider retirement, last-good snapshots, complete dependency fingerprints and recovery from a missing frontend. A main prototype cannot substitute for a valid module entry. Actual retirement barriers remain part of the provider lifecycle.

IR tests preserve constant bit patterns, typed operations, aggregates/matrices, lexical scope and source functions with multiple outputs. Calls retain side effects and published snapshots are frozen.

Stage validation checks unique bindings, complete outputs and isolated snapshots. Resource cases cover buffer/image format, shape, permissions and instruction order. Control-flow cases reject writes to parent, sibling or closed scopes, roll back invalid construction atomically, and support named simultaneous state replacement without accidental sequential dependency.

Semantic fingerprints ignore canvas position while tracking source, nested instructions, storage permissions, slots and workgroup dimensions. Changing presentation layout is not a shader recompile requirement.

Graph tests mix independent node extensions with source functions, preserving connections across Missing recovery. They reject invalid types, cycles and aggregate conflicts, retain side effects, and release rejected type-provider candidates.

Program round trips retain missing stages/outputs, report duplicate contracts and unsupported capabilities, synchronize renamed inputs and exposed parameters, and persist unfinished native inputs. Backend registration accepts open identities and checks runtime/authoring pairs; a synthetic registration is not a second real GPU adapter.

BGFX shaderc cases compile actual Metal for operators, isolated private symbols, structs, fixed arrays, multiple outputs, uniforms, textures, instancing, MRT and Compute. They reject missing capabilities, freeze includes and preserve diagnostics pointing at original files.

Resource compilation covers reads/writes, atomic add, 2D/array/3D images, four sampling forms and discard. Control flow covers branches, loops, storage and aggregates with zero loop iterations, including nested fragment-only restrictions. Matrix compilation covers all nine shapes from 2×2 through 4×4; multiple compiles within a case are not counted as separate discovered tests.

The suite explicitly requests the shader-tools native product. The validation plan prepares its target/configuration deployment index; tools are not borrowed from another Editor output or cache.

Real Metal cases declare macOS support and use MetalShaderFactAttribute to report non-macOS execution as skipped/not applicable rather than silently returning. On macOS, a missing tool or failed compile still fails.

Fixtures release registry, type catalog and module host in dependency order and own their temporary files. Native compilation success does not certify GPU numerical/pixel results or performance, complete resource layout/barriers, GPU reflection, Shader Editor workflows or end-to-end collectible plugin unloading.

Browse the pinned shader assertions. Use Editor workflow tests for authoring interaction and the BGFX adapter suite for actual device/surface behavior.