Inno.Editor.Scene
Section titled “Inno.Editor.Scene”
- Scene document ownership, persistent-ID edits, minimal reversible History and atomic Edit/Play presentation.
Scene document ownership, persistent-ID edits, minimal reversible History and atomic Edit/Play presentation.
Edit through the scene owner
Section titled “Edit through the scene owner”Scene document editing explains source assignment, dirty state, Missing recovery and proportional History. Panels dispatch intent to SceneEdits; they do not each own snapshot/rollback algorithms. General Scene serialization does not depend on Editor History, and Scripting does not depend on Scene types.
Preserve identity and atomicity
Section titled “Preserve identity and atomicity”Handlers resolve persistent object/Stable Type IDs in the current generation. History stores scalar/property/element/subtree/document data proportional to the change, preserves reference aliases and compensates failed recording. Missing element types can be restored as placeholders rather than losing the logical type/property state. Failed compensation reports both causes and does not move the History stack as if successful.
IEditorSceneWorkspace owns query/Open/Save workflows. IEditorGameScenePresentation returns an operation-scoped ContentReadScope; IEditorScenePlayMode materializes and publishes a complete isolated runtime world. Those latter host protocols are not script APIs. Editor scripts receive the workspace and SceneEdits. Reload registration leases strongly retain their participant while held; the coordinator’s weak index is not its lifetime owner.
Play changes are temporary, source synchronization is deferred, and persistence is rejected. Clean-source relocation and successful generation recovery do not become user edits; preexisting dirty state is never hidden.
Host examples
Section titled “Host examples”These use the actual host contracts and borrowed live dependencies. They do not initialize a product or establish lifecycle/device acceptance.
using Inno.Editor.Interactions;using Inno.Editor.Scene;using Inno.Scene;using Inno.Scene.Components;
public sealed class MarkerBehavior : GameBehavior { }
[EditorAction("example.add-marker", "scene/hierarchy")]public sealed class AddMarkerAction(SceneEdits edits) : EditorAction<GameObject>{ protected override void Execute(EditorActionContext<GameObject> context) => edits.AddComponent(context.target, typeof(MarkerBehavior), "Add Marker");}Source boundary
Section titled “Source boundary”Source project. Declarations, script selection and runtime behavior require separate matching 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.Scene
Source: src/composition/editor/features/Inno.Editor.Scene/Inno.Editor.Scene.csproj
| Type | API | Description |
|---|---|---|
| EditorSceneWorkspaceFactory | engine | Creates explicitly owned editor scene workspaces for embedded editor hosts and command-line tooling. |
| EditorSceneWorkspaceHost | engine | Owns an editor scene workspace created outside the attribute-discovered editor application. |
| IEditorGameScenePresentation | engine | Supplies the scene set that represents the game to Editor viewport consumers without exposing runtime-session ownership. |
| IEditorScenePlayMode | engine | Creates isolated runtime scene sessions from the current editable scene set. |
| IEditorSceneWorkspace | engine | Exposes the active Edit or Play scene presentation and the persistence operations available to it. |
| SceneEdits | engine | Applies scene-document mutations and records compact, reload-safe inverse data in editor history. |
| SceneHierarchyEdit | engine | Exposes world-owned hierarchy operations inside one atomic scene history mutation. |
| IEditorSceneWorkspace | Editor | Exposes the active Edit or Play scene presentation and the persistence operations available to it. |
| SceneEdits | Editor | Applies scene-document mutations and records compact, reload-safe inverse data in editor history. |
| SceneHierarchyEdit | Editor | Exposes world-owned hierarchy operations inside one atomic scene history mutation. |