Inno.Rendering.Assets.Authoring
Section titled “Inno.Rendering.Assets.Authoring”
- Frozen rendering imports, graph editing, target compilation and last-good publication.
Frozen rendering imports, graph editing, target compilation and last-good publication.
Start with rendering tasks and frame ownership.
Import a complete candidate
Section titled “Import a complete candidate”This authoring assembly handles Texture, Shader, Material, Geometry and Pipeline source import, graph editing, target compilation and last-good storage. It depends on runtime asset contracts, Shader mechanisms and AssetPipeline, and does not enter the Player. Actual language parsing and native compilation remain with the selected providers/toolchains.
An importer receives the complete serialization/reference context from AssetPipeline and freezes source, dependencies and graph definition. A target compiler accepts immutable input and returns structured diagnostics with a complete candidate. Validate it before publication; failure retains the last-good artifact for the same logical asset.
ShaderSourceBundle and ShaderGraphArtifact freeze dependency bytes. Runtime consumers never reread the authoring directory. A toolchain that needs files materializes short-lived inputs under its own owner; those temporary paths do not become runtime asset protocol fields.
Separate source, cache and GPU owners
Section titled “Separate source, cache and GPU owners”ShaderGraphSourceStore owns authored source saving. ShaderLastGoodStore owns rebuildable authoring cache. Neither creates GPU ownership. Texture and shader target compilers remain replaceable boundaries.
Authoring composition registers the appropriate importer/provider. This project’s script manifest exports Editor authoring APIs only. Generation, Missing recovery and publication follow the existing Asset/TypeRegistry coordinator rather than a target compiler’s independent transaction.
Host usage
Section titled “Host usage”Supply live, explicitly owned dependencies as described above. These examples compile against the host contract; they do not initialize a complete product or verify a device.
using System.Collections.Generic;using Inno.Core.Graphs;using Inno.Core.Serialization;using Inno.Rendering.Assets.Authoring;
static byte[] FreezeGraph( GraphDocument graph, IReadOnlyDictionary<GraphNodeId, byte[]> functions, SerializationRegistry serialization) { return ShaderGraphArtifact.Encode(graph, functions, serialization);}Source boundary
Section titled “Source boundary”The source project defines the host declarations. Source API extraction does not establish script visibility, native behavior or completed generation retirement.
API reference
Section titled “API reference”Logical script references
Section titled “Logical script references”The compiler-selected script declarations are separate from this project’s host CLR surface. Read the script calling guide and the associated module contracts before using a projected member.
Source project facts
Section titled “Source project facts”Project: Inno.Rendering.Assets.Authoring
Source: src/services/rendering/Inno.Rendering.Assets.Authoring/Inno.Rendering.Assets.Authoring.csproj
| Type | API | Description |
|---|---|---|
| CompiledShaderArtifact | engine | Contains an immutable target shader artifact and expected reflected interface. |
| CompiledShaderPass | engine | Stores all compiled stages and state for one shader pass. |
| IShaderCompilerToolchain | engine | Defines a backend-owned target compiler used by the common Shader IR pipeline. |
| ITextureTargetCompiler | engine | Converts supported artist texture sources into a validated portable runtime container. |
| ShaderArtifactSelection | engine | Describes the artifact selected after evaluating a candidate compilation. |
| ShaderCompilationResult | engine | Returns a candidate artifact and structured diagnostics without mutating active state. |
| ShaderCompileTarget | engine | Selects one renderer profile and compilation policy. |
| ShaderCompiler | engine | Compiles validated Shader IR through one target toolchain. Carries validated inputs and outputs for one shader compilation stage. Carries validated inputs and outputs for one shader compilation stage. |
| ShaderFunctionAsset | engine | Represents an authoring-only source-function library; it is never a complete GPU stage or runtime dependency. |
| ShaderGraphArtifact | engine | Persists graph and frozen function inputs as an authoring artifact; Player export removes this payload. |
| ShaderGraphSourceSnapshot | engine | Contains detached graph source state, not a compiled or live runtime asset. |
| ShaderGraphSourceStore | engine | Reads and atomically saves the sole shader graph source format without requiring successful compilation. |
| ShaderLastGoodStore | engine | Atomically preserves last-good CPU shader artifacts by asset, target and variant. |
| ShaderSourceBundle | engine | Persists only frozen function compilation inputs, never a parser, live asset, resolver or generated main function. |
| ShaderSourceImportSettings | engine | Configures one source-function library through the standard asset import-settings sidecar. |
| ShaderStageArtifact | engine | Stores one immutable target stage binary. |
| ShaderStageBinding | engine | Maps one logical binding to the adapter-generated native name, without exposing a GPU handle. |
| ShaderStageToolRequest | engine | Supplies typed stage semantics and frozen source modules to a target compiler. |
| ShaderStageToolResult | engine | Returns a frozen typed-stage compilation candidate; failure never carries a usable artifact. |
| ShaderFunctionAsset | Editor | Represents an authoring-only source-function library; it is never a complete GPU stage or runtime dependency. |
| ShaderSourceImportSettings | Editor | Configures one source-function library through the standard asset import-settings sidecar. |