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

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.

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.

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

The source project defines the selected host declarations. Script projection and platform execution require their separate evidence.

Types and exact member contracts preserve captured declarations and source XML.

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.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.