Split graphics host contract

This commit is contained in:
gamer147
2026-08-03 10:50:18 -04:00
parent 06b152274d
commit bf670cf1e0
4 changed files with 64 additions and 38 deletions

View File

@@ -167,8 +167,11 @@ timed-deadline waiting, frame yield, and scene reset. `engine/Age.Engine/Hosting
SFX, fade, volume, and route-control contracts, including the compatibility overload/default chains used by
simple hosts. `engine/Age.Engine/Hosting/IMovieHost.cs` owns ordinary, positioned, mask-transition, activity-query,
and modal movie playback contracts. `IHost` inherits all four focused contracts; their required and default
behavior is unchanged. The neutral `engine/Age.Engine/Model/MovieMaskTransitionRequest.cs` record carries movie
mask work between the VM, host, and retained graphics without making `Model` depend on `Hosting`.
behavior is unchanged. `engine/Age.Engine/Hosting/IGraphicsHost.cs` owns mutable surfaces, retained-range/frame
presentation, transitions, texture lifecycle, pixel capture/replace, draw, and size contracts; `IHost` also
inherits this focused surface without changing existing hosts. The neutral
`engine/Age.Engine/Model/MovieMaskTransitionRequest.cs` record carries movie mask work between the VM, host, and
retained graphics without making `Model` depend on `Hosting`.
`engine/Age.Engine/Model/RgbaImage.cs` owns the format-independent packed RGBA image transported between SYS4
decoders, host surfaces, renderers, persistence, and tests; consumers do not depend on `Sys4` merely to exchange
decoded pixels.

View File

@@ -786,6 +786,13 @@ do not mix mechanical moves with semantic changes.
the neutral image contract; image-only format imports were removed while genuine SYS4 consumers retained
theirs. Decoder and image behavior remain unchanged, and runtime validation remains green.
The sixth bounded contract slice introduced `IGraphicsHost` for mutable surface fill/copy, retained-range and
frame presentation, transition waits/fades, texture lifecycle, pixel capture/replace, drawing, and size
queries. `IHost` inherits the focused contract; all seventeen members, required implementations, default
fallbacks, and existing host classes remain behaviorally unchanged. Surface request records and the fade
direction remain in their prior locations pending a separate transport cleanup. Runtime validation remains
green.
4. **Make the build graph express source ownership.** Stop linking production `.cs` files from `godot/` and
`tools/movie-corpus-gate/` into `Age.Engine.Tests`. Extract the platform-neutral frontend/movie/diagnostic
code into a small production project referenced by Godot, tests, and the corpus gate. Retain both existing
@@ -1146,8 +1153,8 @@ layer's rendering diverges from ADV; save layout.
## 8. Immediate next step
Continue step 3 of the **codebase consolidation** maintenance slice: clarify runtime contracts without changing
behavior or the aggregate host accepted by the VM. With diagnostic, lifecycle, audio, and movie contracts
established beneath `IHost` and shared movie/image transport now neutral, introduce the graphics host contract
next. Preserve its surface, retained-range presentation, transition, texture, capture/replace, and headless-default
behavior while leaving the remaining surface request records in place for a separate transport cleanup.
established beneath `IHost`, shared movie/image transport neutral, and the graphics contract now separated, move
the unchanged `SurfaceRectFill`, `SurfaceRectCopy`, and `SurfaceBlackFadeDirection` contracts from `Hosting` to
`Model` next. Preserve all consumers and graphics behavior before separating the remaining ADV/input domains.
Concrete playthrough blockers may still preempt this bounded maintenance work; the consolidation effort does
not replace Phase B gameplay validation or the open cross-platform gates.