Skip to content
Project referenceDevelopmentEngine ccf7d03f
Authored
  • Neutral subsystem lifecycle, finite frame phases and owned retirement protocols.

Neutral subsystem lifecycle, finite frame phases and owned retirement protocols.

Start with composing a runtime host and runtime lifetime.

This assembly defines subsystem lifecycle using Foundation Events, Diagnostics, Execution, Identity and type-catalog contracts. Domain runtime projects depend on it without acquiring Scene, Assets, Rendering, Audio, Editor or backend implementations. Inno.Runtime supplies full pipeline ordering and Session composition.

RuntimeSubsystem exposes OnStart/OnStop for domain resources and finite frame hooks: BeginFrame, FixedUpdate, Update, LateUpdate, PrepareOutput, ProduceOutput, CompleteOutput and EndFrame. OwnFrameScope records facade bindings that must leave their scope. The subsystem’s lifetime tracks its own resources, cancellation and work.

Repeated attachment, a wrong thread or a phase without BeginFrame fails. If frame entry fails, close the scopes already entered. AudioRuntime composes an audio device; inheriting a device just to reuse handle encoding would confuse ownership. Core Layer/LayerStack continues to own local application/UI ordering independently of subsystem scheduling.

The Host owns the Pipeline/Session before invoking factories or Attach. Each factory receives a separate context.resources lifetime; an optional subsystem failure cannot dispose a sibling’s resources. Register resources and Tasks not yet transferred to the returned instance in that lifetime. The engine cannot recover work secretly retained in a user static field.

Attach failure leaves full draining to the outer owner rather than attempting a partial self-disposal. Dependency ordering, missing-dependency/cycle checks and reverse phase unwinding belong to RuntimeSubsystemPipeline. Collectible generations retain the existing GenerationCoordinator; a subsystem does not create another GC barrier.

Dispose first cancels tracked work. If it has not quiesced, report RetirementPendingException without calling OnStop. Preserve the owner and its dependencies, then retry after work drains. Do not wrap Pending as an ordinary aggregate and continue destroying dependencies.

OnStop can itself report Pending and be retried. Once OnStop completes, a later lifetime Pending does not cause that completed stop callback to run again. Actual terminal cleanup errors are aggregated. This contract cannot forcibly kill arbitrary plugin threads or authorize releasing owner-thread resources on a worker.

Composition supplies capabilities already checked against the device/services; runtime code does not guess the OS or backend. Missing capabilities or dependencies prevent factory invocation. An unavailable optional dependency makes optional consumers unavailable; required consumers reject the owner.

Duplicate IDs, cycles and lifetime mismatches are always configuration errors, even for optional systems. Frame and retirement exceptions are not optional degradation: they propagate, with no automatic restart or silent skipped frame.

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 Inno.Runtime.Contracts;
public sealed class CounterRuntime : RuntimeSubsystem
{
public double elapsed { get; private set; }
protected override void OnUpdate(RuntimeFrame frame)
{
elapsed += frame.unscaledDeltaTime;
}
}
using Inno.Runtime.Contracts;
var descriptor = new RuntimeSubsystemDescriptor(
new RuntimeSubsystemId("sample.capture"),
lifetime: RuntimeSubsystemLifetime.Host,
requirement: RuntimeSubsystemRequirement.Optional,
requiredCapabilities: [new RuntimeCapabilityId("sample.frame-capture")]);

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

Browse exact types and members.

Project: Inno.Runtime.Contracts
Source: src/runtime/contracts/Inno.Runtime.Contracts/Inno.Runtime.Contracts.csproj

Type API Description
IRuntimeSubsystem engine Participates in the ordered lifecycle of one isolated runtime session.
IRuntimeSubsystemFactory engine Creates one runtime subsystem instance for each declared Host or Session owner.
RuntimeCapabilityId engine Identifies a backend-neutral capability supplied by composition, not an object or native handle.
RuntimeFixedFrame engine Provides immutable timing state to one deterministic fixed simulation step.
RuntimeFrame engine Provides immutable timing state to one variable runtime frame.
RuntimeSubsystem engine Enforces one control-thread lifecycle while derived runtimes compose their own domain services.
RuntimeSubsystemCatalogAttribute engine Requests a generated partial method that gathers subsystem declarations with the same typed composition parameter.
RuntimeSubsystemContext engine Exposes only foundation services and owner metadata, never a complete RuntimeSession or domain service locator.
RuntimeSubsystemDescriptor engine Describes stable ordering and dependency requirements for one runtime subsystem.
RuntimeSubsystemId engine Identifies one backend-neutral runtime subsystem protocol.
RuntimeSubsystemLifetime engine Identifies the exclusive owner that creates and retires a stable engine subsystem.
RuntimeSubsystemRegistrationAttribute engine Declares a strongly typed composition method for build-time subsystem catalog generation.
RuntimeSubsystemRequirement engine Selects startup failure behavior without changing runtime-frame or retirement error semantics.