Skip to content
Project referenceDevelopmentEngine ccf7d03f
Authored
  • 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.

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.

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.

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);
}

The source project defines the host declarations. Source API extraction does not establish script visibility, native behavior or completed generation retirement.

Browse types and members.

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.

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.