From 0f8bb6d9da303adb819d50820bd9f0ea6ad8eec7 Mon Sep 17 00:00:00 2001 From: Meta Vens Date: Fri, 16 Oct 2026 22:48:11 +0200 Subject: [PATCH] Release map: map presenter (owner audit, 2D icons, instanced belts, the asteroid setting's cost) Co-Authored-By: Claude Opus 5.5 --- docs/aetheria-release-map.md | 73 ++++++++++++++++++++++++++++++++++++ 1 file changed, 73 insertions(+) diff --git a/docs/aetheria-release-map.md b/docs/aetheria-release-map.md index de248b081..a29c8f909 100644 --- a/docs/aetheria-release-map.md +++ b/docs/aetheria-release-map.md @@ -10316,3 +10316,76 @@ Merge checklist for faction-play-1: take master's Aetheria.cc, re-run `doctrine- eureka/aetheria-release-maker-only-faction-r2, depends_on faction-play-1) and the resolution superseding r1. context-pack: 6 anchors SAME at 6b6e7c7c. - No question raised. + +## Map presenter (imagination-ag4-map-presenter, 2026-10-16) + +Spec `aetheria-release:cut_spec:cut-map-presenter.r1`, question +`aetheria-release:question:contact-icon-heading`. Source reads at da6fe033; +no Unity probe was run. + +### Body facts + +- Map cameras (ARPG.unity): every Minimap*/Map* camera is orthographic, near + 0.3, far 1000, looking straight down. The minimap set sits at y 10 and + copies the target's x and z only (CopyTransform). The map screen moves its + cameras to `Position.Flatland(1)`, which puts them at y 1 (MapRenderer.cs:120). + Masks: Map Overlays 49152 (layers 14 Minimap, 15 Asteroids), Map Gravity 512 + (9), Map Tint 8192 (13), Map Influence 262144 (18). +- Planet icons: the `Minimap Icon` child of Planet, Gas Giant and Sun sits at + the planet's root. ZoneRenderer.Update (:610) moves it to the field height, + `y = DrawAhead.Height`. Once a well is deeper than about 990 below the + camera, the icon is past the far plane, which is the operator's missing + planets. +- Ship, station and turret icons: an `Icon` / `Minimap Icon` / `SHIP.MapIcon` + child of the entity on layer 14. It inherits the entity transform, which is + set to `DrawAhead.Position` (ride height, so field height plus layer) and to + `DrawAhead.Rotation` (ShipInstance.cs:105, the full 3D pose). That is why the + icon tilts with the hull, and why it also clips in deep wells. Mod ships + build the same child from the package's `map-icon` node (ShipModShips.cs:97). + The child's material joins the hull's fade instances (EntityInstance Awake). +- Belt asteroids: AsteroidBeltUI, one MeshFilter on layer 14 per belt, drawn + at the field height. Every frame it rotates 4 vertices per asteroid on the + CPU and reassigns `Mesh.vertices`, which uploads the whole vertex array. It + runs only while `ShowAsteroidUI` is on, which follows + `PlayerGraphicsSettings.ShowAsteroidsInMinimap` (key 1, menu field + MainMenu.cs:299) and is forced on in the map screen. This is the cost the + operator added the setting for. The 3D belt already fills `_beltTransforms` + (float4 per asteroid) every frame. +- Already 2D: GravityField.shader writes `-gravityHeight` as a colour into an + RFloat texture from a flat quad. The tint, influence and patch passes are + flat quads at the root height. None of them clips on depth. The contour's + `_DepthRange` is a per-frame normalisation over the drawn planets' depths, + not a camera bound. +- Still 3D through a map camera: the sensor ping tint (EntityInstance.cs:190), + placed at the entity's 3D ride height on the Tint layer. The spec moves it + to the map plane. +- Dead: MapView.cs. Its guid is referenced by no scene or prefab, and its + `_input` is never bound. +- Partly in place: no owner exists. ZoneRenderer, EntityInstance, MapRenderer + and AsteroidBeltUI each write part of the map. + +### Rationale + +- Placing icons in 2D was ruled by the operator ("depth bound doesn't matter + if the dedicated owner places them in 2D as it should"). It also removes any + need for a depth bound from WellTree, so the cut does not depend on well-law + r3 and runs now. +- Icons are drawn, not parented. The presenter reads each icon's mesh, + material and authored local rotation once and destroys the child, so no + world transform can carry an icon. The authoring contract (the `map-icon` + anchor) and the prefab smokes are unchanged. +- Belts: one instanced procedural draw per belt from the buffer the 3D path + already fills. The CPU work drops from per-vertex rotation plus a mesh + upload to one `SetData` of 16 bytes per asteroid. This is the standard GPU + instancing route (Unity `Graphics.RenderMeshPrimitives` / + `DrawMeshInstancedProcedural`). RTS minimaps draw the same way: a cached or + cheap terrain layer, plus unit markers drawn as sprites. No Eyes pass was + run, so the confidence is moderate; the measurement in the spec decides. +- No low-spec question is raised. Once the belt sprites cost about one buffer + upload per belt, a toggle protects nothing. If Hands measures 0.1 ms or more + per frame at head, that comes back as a fork. + +### Cut sequence + +- Contact icons gated on perception (yaw-when-tracked): waits on + `contact-icon-heading` and the visibility chain.