engine: materialize live ADV glyphs

2026-07-30 19:04:22 -04:00
parent eec99c2c7c
commit e5b4db5eff
15 changed files with 758 additions and 27 deletions
--- a/engine/Age.Engine/Text/RetainedAdvTextLayoutPresentation.cs
+++ b/engine/Age.Engine/Text/RetainedAdvTextLayoutPresentation.cs
@@ -0,0 +1,86 @@
+using Age.Engine.Model;
+
+namespace Age.Engine.Text;
+
+/// <summary>
+/// Transient live-layout presentation state. History persistence owns neither this list nor its Gfx
+/// bindings; saved-frame script reconstruction rebuilds both.
+/// </summary>
+public sealed class RetainedAdvTextLayoutPresentation
+{
+    private readonly List<AdvRetainedGlyphPlacement> _glyphs = new();
+
+    public RetainedAdvTextLayoutPresentation(AdvTextLayoutPresentationBinding binding)
+    {
+        if (binding.LayoutSlot <= 0)
+            throw new ArgumentOutOfRangeException(nameof(binding));
+        if (binding.SourceSurfaceSlot < 0)
+            throw new ArgumentOutOfRangeException(nameof(binding));
+        if (binding.FirstObjectHandle < 0 || binding.ObjectCapacity <= 0)
+            throw new ArgumentException(
+                "A retained ADV layout requires a nonnegative first handle and positive capacity.",
+                nameof(binding));
+        Binding = binding;
+    }
+
+    public AdvTextLayoutPresentationBinding Binding { get; }
+    public IReadOnlyList<AdvRetainedGlyphPlacement> Glyphs => _glyphs;
+    public int PublishedGlyphCount { get; private set; }
+    public int PublishableGlyphCount
+        => (int)Math.Min(_glyphs.Count, Binding.ObjectCapacity);
+
+    public int Append(
+        IReadOnlyList<AdvRetainedGlyphRecord> records,
+        int layoutOriginX,
+        int layoutOriginY)
+    {
+        ArgumentNullException.ThrowIfNull(records);
+        int first = _glyphs.Count;
+        foreach (AdvRetainedGlyphRecord record in records)
+            _glyphs.Add(new AdvRetainedGlyphPlacement(
+                record, layoutOriginX, layoutOriginY));
+        return first;
+    }
+
+    /// <summary>Publish newly revealed glyphs through a layout-global target count.</summary>
+    public int PublishThrough(GfxState gfx, int targetGlyphCount)
+    {
+        ArgumentNullException.ThrowIfNull(gfx);
+        int target = Math.Clamp(targetGlyphCount, 0, PublishableGlyphCount);
+        for (int index = PublishedGlyphCount; index < target; index++)
+            Bind(gfx, index);
+        PublishedGlyphCount = Math.Max(PublishedGlyphCount, target);
+        return PublishedGlyphCount;
+    }
+
+    /// <summary>Recreate every currently revealed binding after op 0x20a or temporary suspension.</summary>
+    public int Republish(GfxState gfx)
+    {
+        ArgumentNullException.ThrowIfNull(gfx);
+        for (int index = 0; index < PublishedGlyphCount; index++)
+            Bind(gfx, index);
+        return PublishedGlyphCount;
+    }
+
+    public void ErasePublished(GfxState gfx)
+    {
+        ArgumentNullException.ThrowIfNull(gfx);
+        gfx.EraseRange(Binding.FirstObjectHandle, Binding.ObjectCapacity);
+    }
+
+    private void Bind(GfxState gfx, int index)
+    {
+        AdvRetainedGlyphPlacement placement = _glyphs[index];
+        AdvRetainedGlyphRecord record = placement.Record;
+        if (record.Width <= 0 || record.Height <= 0) return;
+        gfx.BindDraw(
+            checked(Binding.FirstObjectHandle + index),
+            Binding.SourceSurfaceSlot,
+            record.Left,
+            record.Top,
+            record.Width,
+            record.Height,
+            checked(placement.LayoutOriginX + record.Left),
+            checked(placement.LayoutOriginY + record.Top));
+    }
+}