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

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.

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.

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 project. Declarations, script selection and runtime behavior require separate matching 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.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.