Inno.Editor.Shaders
Section titled “Inno.Editor.Shaders”
- UI-free material source drafts, neutral History and Editor-only shader parameter presentation.
UI-free material source drafts, neutral History and Editor-only shader parameter presentation.
Read the linked task or ownership explanation before using the exact API below.
Edit without publishing prematurely
Section titled “Edit without publishing prematurely”Material draft editing explains detached reads, immediate History samples, atomic ReplaceMany, gesture identity and explicit Save/Revert/Close. AssetDraftDocuments supplies codecs, dirty/recovery state and neutral History. The module registry supplies dependencies; the service does not draw ImGui or own a panel.
ShaderParameterPresentation records grouping, descriptions, visibility and finite ranges with native Serialization, stable binding IDs and the owner reference context. It does not mutate runtime shader interfaces or existing parameter values.
Keep live objects with their owner
Section titled “Keep live objects with their owner”Canonical material, referenced assets and published runtime values stay with Assets. Source conflicts preserve drafts and diagnostics; missing sources/types form recovery barriers. Persistent IDs reconnect History after reopening. Shutdown clears generation caches but preserves unsaved recovery. Do not retain detached assets, types, previews or registries across callbacks.
The example below uses the projected Editor-script namespace. The exact reference section separately describes captured host declarations; script availability is not inferred from host presence.
Executable usage
Section titled “Executable usage”Supply existing live dependencies on the declared API surface. Compiling the example does not initialize a product or certify a physical device.
using System;using InnoEditor.Shaders;
static void ReadCurrentDraft( MaterialDocuments documents, Guid assetId) { _ = documents.Read(assetId);}Source boundary
Section titled “Source boundary”The source project defines the selected host declarations. Script projection and platform execution require their separate evidence.
API reference
Section titled “API reference”Types and exact member contracts preserve captured declarations and source XML.
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.Editor.Shaders
Source: src/composition/editor/features/Inno.Editor.Shaders/Inno.Editor.Shaders.csproj
| Type | API | Description |
|---|---|---|
| MaterialDocuments | engine | Owns Material authoring sessions; native source editing uses the shared asset draft lifecycle. |
| ShaderInspectionSelection | engine | Identifies a shader document and selected nodes without retaining a graph, extension object or delegate. |
| ShaderParameterPresentation | engine | Stores Editor-only parameter presentation by stable binding identity in the Shader’s authoring graph. |
| ShaderPreviewContext | engine | Carries frame-only preview inputs; persistent provider state must retain stable values rather than this object. |
| ShaderPreviewProvider | engine | Builds domain-owned preview geometry and pass inputs without changing a scene or canonical asset. |
| ShaderPreviewProviderAttribute | engine | Associates a reloadable preview implementation with one open Shader contract. |
| MaterialDocuments | Editor | Owns Material authoring sessions; native source editing uses the shared asset draft lifecycle. |
| ShaderParameterPresentation | Editor | Stores Editor-only parameter presentation by stable binding identity in the Shader’s authoring graph. |
| ShaderPreviewContext | Editor | Carries frame-only preview inputs; persistent provider state must retain stable values rather than this object. |
| ShaderPreviewProvider | Editor | Builds domain-owned preview geometry and pass inputs without changing a scene or canonical asset. |
| ShaderPreviewProviderAttribute | Editor | Associates a reloadable preview implementation with one open Shader contract. |