diff --git a/references/effort-tiers.md b/references/effort-tiers.md new file mode 100644 index 0000000..27218e3 --- /dev/null +++ b/references/effort-tiers.md @@ -0,0 +1,88 @@ +# Render effort tiers + +**Status: newly adopted (October 2026) and on trial.** The scheme below was agreed for the next major town batch and +is being evaluated there. Everything in it is a proposal with reasons, not a law. Use it, measure it, and adjust the +numbers to your own table, budget and renderer. + +## The one test + +**Tier = the probability that the place comes into focus at the table.** + +Not its size, not its importance in the world, not how pretty it would be. A third-rate pub that the storyline sends +the party to is tier 1. A master weaponsmith in a town the party only passes through is tier 3. The categories below +are examples of where places usually land, never rules. + +| Tier | Meaning | Typically | Render deliverables | Budget (one hosted edit model, 2026 prices) | +|---|---|---|---|---| +| **1** | Guaranteed to come into focus | town overviews and approaches; the party's base, inn or hall; the storyline's buildings; the guild's tavern | block model + aerial and approach plates; the full time x weather matrix; every room the party will stand in; scene beats; named staff as reusable anchor characters | ~100-200 renders, ~$10-20 | +| **2** | Likely | adventuring shops (gold, gems, weapons, armor, alchemist, healer); civic and sacred landmarks (temple, moot hall, gates, market, docks) | exterior A/B day + night + one snow; one counter interior; the proprietor as a scene character; goods at the wealth tier; a price list | ~20-40 renders, ~$2-4 | +| **3** | Possible | third-rate pubs, mundane townsfolk shops | one exterior day, one interior, a keeper from the pool | ~5-10 renders, under $1 | +| **4** | Unlikely / background | everything else on the map | a name, a tagline, one line of text, maybe a sign emblem | no renders | + +Special-case venues may warrant their own budget regardless of tier; decide that per campaign. + +## Deliverables per tier, spelled out + +### Tier 1 +- **Geometry:** block model of the site in its town context; template plates for every camera (approach, aerial, + entrance, interior rooms). +- **Exterior matrix:** Day / Sunset / Night x Dry / Rain / Snow (light) for the A and B cameras (18 frames), plus + whatever storm and deep-snow cells your calendar needs (references/matrices.md). +- **Interiors:** every room the party will stand in, as an empty master (people-free, so it stays reusable as a plate). +- **Population x time matrix (venues with people):** 4 x 3, Morning / Afternoon / Evening / Late Night x Quiet / + Moderate / Packed, from one "reveal from the door" camera (12 frames). A 4 x 4 with an **Empty** column only for + storyline hubs where an empty room is itself a scene (16 frames). +- **Scenes:** the beats the story needs, on the canon rooms with the canon faces. +- **Named staff** as reusable characters with locked faces. + +### Tier 2 +- Exterior A and B: Day Dry, Night Dry, one Snow (light). +- One counter interior, empty master. +- The proprietor as a scene character (a face that recurs, not a full anchor pack). +- Goods rendered at the wealth tier; a price list in text. +- **Population matrix 2 x 3:** Day / Sunset x Quiet / Moderate / Packed (6 frames), for any venue with a counter or + benches. + +### Tier 3 +- One exterior, Day Dry. One interior. A keeper drawn from the generic pool. +- **Population matrix 1 x 2:** its peak hour x Quiet / Packed (2 frames). + +### Tier 4 +- Text only: name, tagline, one line. A sign emblem if it is cheap. No renders. + +## Model-cost tiering (which agent does what) + +Image QA is the real token cost, not the renders. So the agent that executes a tier is sized to the tier: + +| Tier | Planning | Execution | Review | +|---|---|---|---| +| 1 | the most capable model writes the brief and reads the report | a mid-sized model runs the lane | a short review by the capable model | +| 2 | brief from a template | mid-sized model | none beyond the lane's own gates | +| 3 | template | a small model | none | +| 4 | — | a local or text-only model (it never has to see an image) | none | + +**Canon guard for lanes run by smaller models:** every brief says "anything not in this brief is marked PROPOSED". +A lane invents less when it knows invention is allowed but must be labeled. (The "no glass anywhere" rule that +haunted one campaign for a week was a lane's invention; see references/prompting.md on glass.) + +## Rules + +- **Play promotes, never demote.** A place the players actually enter moves up a tier for the next session. Nothing + rendered is ever deleted; superseded files are moved aside. +- **Per-tier ceiling.** A lane may not exceed its tier's budget without the GM's say-so. Cap retakes and the number of + images reviewed, not just renders. +- **Attention is the scarcest resource,** then tokens, then wattage. Tier budgets cap tokens and renders, but never by + pushing review load onto the human: spend more on self-gating so fewer, better frames reach them. +- **Canon-direct delivery.** Work that passes its own gates goes straight into the campaign's canon folder with a + one-line note. A human review entry is reserved for: the face of a story-critical character; a human gate before + something permanent (a model fine-tune, a bake); something the GM asked to see. Reviewed means done: review remarks + are records, not new work orders. +- **Renderer policy is unchanged by tier.** Cut spend by volume (fewer takes, re-roll caps, tighter candidate sets), + never by switching to a weaker renderer for the cheap tiers. A weaker renderer costs more in retakes and review. + +## What to evaluate after the trial + +- Did the smaller-model lanes invent canon? How often? +- Retake rate per tier compared with capable-model lanes. +- Actual tokens and renders per tier against the budget. +- Did the tiering match what the table actually visited? (That is the only question that matters.) diff --git a/references/failure-modes.md b/references/failure-modes.md new file mode 100644 index 0000000..c816ae9 --- /dev/null +++ b/references/failure-modes.md @@ -0,0 +1,80 @@ +# Failure modes and the fix that worked + +Quick index. Each line: the symptom, the measured cause, the fix. Longer versions live in prompting.md, gates.md and +matrices.md. + +## Geometry + +| symptom | cause | fix | +|---|---|---| +| overview invents halls, towers, a church | at town scale each house is a few px; the plate barely constrains the renderer | invented-structure gate; closer camera; name the absent big things in the town block | +| wide view zoomed in 4-10 % | the renderer frames for legibility | FRAMING LOCK with band positions in % of frame | +| small town moved up toward the mountains behind a wide foreground | same | the explicit FOREGROUND sentence ("the town is SMALL and sits LOW, houses from 71 % to 96 %") | +| facade cropped by the plate restored to full height, with the tower | the renderer steps back to show the building | "every edge cuts the scene where image 1's edges cut it; the set-back story and tower are hidden from here" (0/3 -> 4/4) | +| castle redrawn as a palace at 3 km | prior for "castle" | landmark region correlation (0.16 vs 0.4-0.7) + "the castle stays small, not enlarged into a palace; no new towers, spires or domes" | +| mountain shrunk to fit its summit in frame | the plate's wall runs out the top edge | SKY_FIT column gate + "rises out of the top edge, no sky above them there" | +| snow on a low flank through a telephoto | prior for "alpine" | one edit-with-itself replacing white patches with rock; gate on snow-colored px below the snow line | +| verticals tilted 1-2.6 degrees, frame shrunk | a pitched-up plate | render level with a vertical lens shift | +| a feature on the wrong face | named in a shared feature list while occluded from this camera | per-camera visibility list; disown occluded features positively | +| a river or castle appears in a view facing away from it | the prompt's global landmark text | "there is NO river, NO lake, NO castle; they are behind the camera" | +| eleven gables where the map has four houses | touching quads in the massing | 4-7 px gaps, stepped fronts | +| ruins in the plate | footprint slivers | open with a 2 m disc, drop pieces under 40 m2 | +| a stone post with a ball finial by the road | a mannequin cut by the frame edge | proxies 10 m or more from the camera, off the edge | +| battlements across a roof | convex split of an L-wing with merlons on the internal seam | fix the edge list; check the untextured plate | +| a quay or wall runs to the frame edge | the model never said where it ends | model the far side as a different surface | +| a false lake beside the town | river class from a blurred floor level | take the river from the terrain's own water mask | +| the road in a trench | the road layer cut below grade | a broad shelf on a 1 m layer | +| a gate hidden in its own wall's shadow | the hour chosen for the plate | move the sun (16:00 instead of 16:30) and name the hour in the prompt | + +## People + +| symptom | cause | fix | +|---|---|---| +| aerial figures 2.4-5 m tall | nobody set their size; the renderer sizes for legibility | proxies in the plate; the figure-bracket gate; shrink-in-place for legacy sets | +| near walkers +25-28 % | eye-level camera with no horizon relation | the EYELINE clause (eyes on the horizon line) | +| giants at a gate | no nearest-object relation | SIZES BY THE NEAREST OBJECT (adults reach half the palisade, a third of the posts) | +| a 1 m character at 1.4 m | a stated size is ignored | a contact relation the renderer has to draw (a hand flat on his hood, arm straight down) | +| extra lantern-carriers at night | the noun "lantern" | HEADCOUNT lock, lanterns carried by the same people | +| ghosts on quays and stair posts | "steam vents" | drop the steam clause | +| guests on the shut terrace | "2-3 guests on the balcony"; the noun beats the negation | state where everyone is as a positive fact; repeat the untrodden snow | +| a busy room with backs to the lens | packed density fills the foreground | NEAR-FOREGROUND and LOWER-RIGHT locks | +| a referenced man drawn twice | face reference + "lying" | exact headcount; "appears exactly ONCE ... the corner is EMPTY" | +| an outfit sheet's cowl on the wrong woman | a sheet attached without its wearer's face | describe the garment in prose; "she has NO brow ornament" | +| modern waistcoats, derbies, riveted aprons | "prosperous" + a plain garment noun | the period cut as construction facts; forbid the modern modes by name; a women's clause with no trousers | +| hip flips on side gear | "on the viewer's right" | "on HER own right hip" + "the back view is the same person turned round" (0 flips) | +| bloomers under a shift | the men's trouser clause reused on a woman | a women's clause: "hangs straight from the belt; lower legs bare" | +| a V sign | "two fingers raised" | drop the gesture; "no hand sign" | +| field sheds become people in deep snow | "tiny dark upright marks = townspeople" | a lock naming the sheds; eye-check open fields at 2x | + +## Surfaces and weather + +| symptom | cause | fix | +|---|---|---| +| snow cell fails the gate 18/18 | a snow cap raises every surface ~4 px | thin fall "no deeper than a finger" for the calm cell; wall-band gate for storms | +| storm cells show a dusting | the thin-fall clause reused | storm prompt names snow in the air, loads, cornices, drifts; legibility clause outranks the storm | +| night heavy blizzard reads as a dark soft frame | wording cannot push a clear plate to a whiteout; contrast metrics misrank | veil-before-edit (deterministic veil from the depth plate), then "IMAGE 1 ALREADY SHOWS THE STORM AT FULL STRENGTH; keep visibility as low or lower"; silhouette gate | +| summer edit of a winter keeper adds ponds, drains channels, adds bridges | snowy low ground and snow-banked water look alike | pixel or guide lock; or build summer keepers from a summer plate; review water at 1-2x | +| a bright sunset glow in the east | the sky in frame is east; the sun is behind the camera | "THE SKY IN THIS PICTURE IS THE EASTERN SKY ... NO glow" | +| a sun disc in frame | the prompt named the sun without its position | "the sun is behind the camera; no sun disc" | +| a smoke plume from a building with no hearth | "chimney smoke rises" | a no-smoke clause for that building | +| the bar counter survives the "shut" state | "no counter" | "under the roof there is NOTHING: no counter, no shelves, no casks" | +| seven map-true houses look like seven barns | footprint + tier say nothing about function | the character pass (one emblem sign, the trade visible) | +| false glass "defects" | a blanket no-glass rule | glass by wealth tier | +| pseudo-script on books, signs, ledgers | anything flat invites writing | "every book is CLOSED"; signs are emblems only; corner and sign sweep | +| arch-shaped doors | "filling the recess" | "a rectangular door under the tympanum, which stays stone" | +| a sky sliver above a facade | the prompt named the sky | "no sky in view" | +| a window in an internal partition | the prompt read it as exterior | "that wall has no window" | +| a people-free view with people | nothing said so | the explicit people-free clause | +| a cleared wilderness trail in deep snow | prompt alone cannot bury a walled path | pre-bury the route pixels in IMAGE 1; class D gate | +| a hut becomes a horse and sledge | "sledge-packed" | name the hut in a lock; eye-check at 4x | + +## Process + +| symptom | cause | fix | +|---|---|---| +| a lane's conclusion lost in the hand-off | completion messages truncate | write REPORT.md first; hand back the path; anything load-bearing in the first line | +| the same brief dispatched twice, rendered twice | no check for a live sibling | check the lane folder for a fresh REPORT first; re-verify, never re-render | +| a gate that rewards the wrong frame | it measures persistence, not correctness | name the absence in the prompt; crop the background by eye; do not let the gate pick | +| a number right, the story wrong | the lane's interpretation unchecked | verify the lane's interpretation, not just its numbers; run a known-bad control | +| spend out of control | volume: 54-cell matrices x takes x re-rolls | a Cost line per run; cut by volume, never by renderer | +| the GM's attention spent on review folders | every gated set went to review | canon-direct delivery; review only story-critical faces and permanent bakes | diff --git a/references/gates.md b/references/gates.md new file mode 100644 index 0000000..6978a04 --- /dev/null +++ b/references/gates.md @@ -0,0 +1,112 @@ +# Gates: what each one measures, what it catches, what it is blind to + +Every gate here was built because a specific failure slipped through the one before it. Run them in this order and +report which gate each pick passed. **Verify your verifier first:** score the plate against itself (must be ~perfect) +and against the plate shifted 3 px and scaled 1.01 (must fail) before you trust a threshold. `scripts/smoke_test.py` +does exactly that on a synthetic town. + +## 0. Plate gate (before any renderer call) + +Overlay the map's checkable facts on the plate seen through the same camera. For a square: elongation, the closing +range, the saw-tooth of gables, the ways in, the tracks, open ground clear of buildings. **Any miss found here costs one +re-run of massing. Found after re-surfacing it costs everything downstream, because the renderer photographs the +plate's mistakes as faithfully as its truths.** Also eyeball the untextured plate for: merged house blocks (split +them), footprint slivers (they become ruins), a mannequin cut by the frame edge near the camera (it becomes a stone +post), and built features that run off the frame with no end (the renderer extends them forever; model where a quay +or wall STOPS). + +## 1. Geometry drift (frame vs plate), `gate.py` + +| metric | what | measured bands | +|---|---|---| +| `grad_corr` | Pearson correlation of gradient magnitude at 896x504 | textured facade at 20 m: 0.5-0.7; town from 3 km: 0.4-0.55; smooth landscape: 0.15-0.3 (low by nature, judge layout by eye) | +| `edge_rec` | share of plate edges that have a frame edge within 4 px | reported | +| `ecc_cc`, `scale`, `rot_deg`, `tx_px`, `ty_px` | affine ECC frame -> plate | a faithful take: scale 0.995-1.01, shift under ~10 px; a reframed take: scale 0.92-0.98 or 1.04-1.10 | +| `landmark_grad_corr` | `grad_corr` inside the landmark solids' mask | castle at 3 km kept: 0.4-0.7; redrawn as a palace: 0.16 | + +Calibrate per view. The plate vs itself scores 1.0 / scale 1.0; +3 px and x1.01 must fail on every instrument. + +**Blind to:** water becoming land (a surface change, not a shift), an invented building in a low-texture far band, +a feature relocated to a face the camera cannot see, extra people. Those need the gates below and the eye. + +## 2. Skyline and invented structures (wide views), `gate.py` + +The sky/ground boundary per column, fitted plate -> frame by scale + shift (`sky_s`, `sky_tx`, `sky_ty`, `sky_res` +in px). Then `invented_structures`: runs of columns where the frame's skyline rises more than `--bump` px (default 18) +above the plate's, outside the dilated landmark columns. **This is the gate for the one failure the block method still +has: in a city-wide frame each house is a few pixels, the plate barely constrains the renderer, and it "improves" the +skyline with halls, towers and churches.** Reject any frame with a run; prefer a closer camera or stronger plate +conditioning over more retakes. + +Related measured failures on mountains: the renderer shrinks a massif to fit its summit in frame when the plate's wall +runs out of the top edge (gate per column: sky in the frame where the plate has none, under 10 % of columns), and it +paints snow on a low flank through a telephoto lens (fix: one edit-with-itself "replace every white patch with rock, +scree, grass; change nothing else"). Color classifiers are haze-confounded beyond ~6 km. + +## 3. Figure scale brackets, `gate.py` + +Every proxy person the plate can see (from `_people.json`, visibility from the oid buffer) is drawn on the frame as +a bracket: foot line, true-height head line, and a +-25 % band (orange). Registered to the frame through the ECC warp +when the warp is credible (ecc_cc >= 0.55, scale within 8 %). **Pass = the dressed figure stands on its bracket with +its head inside the band.** `qc/_figzoom.jpg` crops the 16 largest. + +What the numbers looked like: street-level figures with proxies and the eye-line clause land at +5-13 % (heads on the +horizon line); without the clause the nearest walkers came out +25-28 %; without proxies at all, aerial figures were +2.4 m at the far edge and 4-5 m at the near edge. Indoors with a face reference attached, close figures bias +8-22 % +even with proxies. At ~20 px (aerial) scale holds but figures are not 1:1 with the proxies (a few move or drop). + +**Blind to:** people the renderer ADDED that no proxy owns (a wide view added six tiny travelers at true size for where +they stood; disclosed, not rejected). Count heads against the proxy count by eye. + +## 4. Corner and edge sweep, `gate.py` + +Four corners and the top/bottom bands of every frame, contrast-boosted (CLAHE + unsharp), on one sheet per position. +Looking for: text, runes, numbers, watermarks, logos, captions, borders, a sun disc in frame. Read the sheet at 1:1. + +## 5. Sign and emblem lock across angles (eye check) + +Every sign is an emblem only, never lettering (a renderer "writes" pseudo-script on anything flat). Crop each sign at +4x from every camera and compare: same emblem, same board, same position on the building. A coin plaque with ring +marks in one take and clean in another: pick the clean one and say so. + +## 6. Occlusion check (eye, per camera) + +For every named feature in the frame ask: which face is it on, and can this camera see that face? A balcony that is +really on the far side but appears on the near face passed every element-by-element check and was still impossible. +The fix is upstream: prompts per camera from a visibility list, with occluded features disowned as a positive +instruction ("the balcony is on the far side and is NOT visible from here"). + +## 7. Storm intensity and snow depth, matrix cells + +- **Storm cells:** a snow-loaded roof hides the texture and lifts the eaves, so the full-frame gate fails by design. + Ladder: full frame -> building band (ground to ridge) -> **wall band** (the same thresholds measured only on the + walls, roofs masked out). Report which rung passed. Controls: keeper vs itself 0.0; a thin-snow take passes; a real + whole-frame shift fails on every rung. +- **Night whiteout:** brightness-normalized contrast metrics score a dark, soft frame as "heavy" when the eye does not. + The instrument is a **silhouette gate** on the building band against the already-gated plate (sigma-2 flake + smoothing), with the side-by-side sheet as the decisive check. A visible veil of lit, snow-filled air is the + requirement, not low contrast. +- **Deep snow (medium/heavy):** gate structure ABOVE the snow line (walls higher than depth + lee drift, eaves, + ridges, parapets) and exempt the buried ground band. Measure depth and walkways against the site's Snow (light) cell + of the same camera and light, not against the sunny plate (sun and shadow bias the snow line by 0.3-0.5 m). Count + NEW dark lines only for walkways; the shared line network scores the same in every cell. Walkways on class C/D + routes are a FAIL (references/matrices.md). At overview scale (1-2 px/m) depth reads but walkways and drifts do not; + expect them only at street scale. Small field sheds turn into oversized people under a "tiny dark upright marks = + townspeople" clause; eye-check open fields at 2x. +- **Seasonal edit of a winter keeper moves water:** snowy low ground becomes a pond, frozen channels drain into grass. + The geometry gate is blind to it. Review the water at 1-2x against the plate's water class outlined on the frame, or + build summer keepers from a summer plate. + +## 8. Same-tier recognizability (contact sheet) + +Thumbnail every batch of exteriors on one wealth rung before calling it done. Seven map-true houses on one rung came +out as seven identical timber barns; each passed its gate. Fix: a **character pass**, a one-change edit per pick that +adds the house's tell at the frontage (one emblem sign, its trade visible: casks and trestles, boots on a rail, a +smelter stack and slag heap, herb-drying racks), gated with ECC against its own source frame plus the corner sweep. + +## Reviewer sub-agents + +Automatic gates catch shifts, zooms and scale. Independent reviewer passes, one per view, sweeping 1:1 quadrants, +catch what they cannot: extra people, see-through ghosts, lost window columns, sky slivers, arch-shaped doors, a river +that appeared in a view facing away from it. They take 15-50 minutes each. Brief them with the bracket rule and the +density rule relationally (tight numeric ranges over-flag), and have them produce a fix list with boxes. diff --git a/references/matrices.md b/references/matrices.md new file mode 100644 index 0000000..cd98673 --- /dev/null +++ b/references/matrices.md @@ -0,0 +1,113 @@ +# Matrices: time x weather, population x time, snow levels, seasons + +A matrix is what lets the GM show the place as it really is at the hour and in the weather the party walks in. +Every cell is an **edit of an accepted keeper of the same camera**, never a fresh re-surface, so geometry carries. + +## The exterior 9-square + +`Day | Sunset | Night` x `Dry | Rain | Snow (light)` = 9 cells, rendered for the A and B cameras (18 frames) when +feasible. The fixed set keeps every establishment comparable; ad-hoc condition sets ("golden hour", "deep winter") +break that. Label lock: Dry = no rain, wet or snow effects; Rain = wet sheen, no snow; Snow = snow load, no rain. + +Build order per camera: +1. Day Dry = the accepted re-surface pick (the keeper). +2. Day Rain and Day Snow (light) = weather edits of the keeper. +3. Sunset and Night of each weather = **relights of that weather's Day pick** (a light-only edit). Relights hold + geometry (ECC scale within 0.15 %, shift under 2 px against the Day pick) and carry the snow over; fresh edits do + not. No approved Night keeper? Make Night Dry as a light-only relight of Day Dry with the dusk wording. +4. Storm cells, if your calendar has them: Blizzard, Heavy Blizzard, Ice Fog. A heavy storm that drifts under a relight + should be **intensified** from the gate-passing same-time Blizzard pick, not relit from Day. + +## Snow has three levels + +| level | depth | must show | file token | +|---|---|---|---| +| Snow (light) | a thin lying fall, "no deeper than a finger" | shapes and heights unchanged (it keeps the geometry gate honest) | `Snow` / `Snow (light)` | +| Snow (medium) | at least knee-deep, ~0.5 m | visible wind drifts on the lee side of walls | `Snow (medium)` | +| Snow (heavy) | 1-1.5 m | drifts and **hand-shoveled walkways** with banks along the major streets and to each door | `Snow (heavy)` | + +Display fallback chain when a place lacks a level: heavy -> medium -> light. Roof loads match the depth. One prevailing +wind per site across every camera and cell. The thin-fall clause is for the calm Snow (light) cell ONLY: storm cells +want roofs loaded, and they use the wall-band gate instead of a thinner storm. + +### Route clearance classes (medium and heavy only) + +| class | routes | treatment | +|---|---|---| +| **A kept** | main streets, market, gate and bridge approaches, the main work road | hand-shoveled walkways with banks (heavy) or trampled, sledge-packed snow (medium). **Never "plowed"**: there are no plows in the setting; packed snow stays on the surface | +| **B trodden** | side lanes, yards | one narrow foot-trodden path to each door, nothing wider | +| **C unkept** | roads between settlements and to outlying farms | NOT cleared: at most a ski or sledge track, snow poles or cairns mark the line, can drift shut. This is the isolation | +| **D untouched** | wilderness trails | pristine, no tracks at all; markers buried or just showing | + +Deep snow has to feel like winter isolation. A cleared trail kills the menace of a dangerous path and flattens the +geography. Store the class per route in the site's data; the prompt states it per route; a walkway on C/D fails the +cell. The prompt alone cannot bury a walled path: pre-bury it in IMAGE 1 (inpaint the route pixels from the texture +beside them) before the edit. Table consequence worth telling the GM: horses founder in medium and deeper; travel off +class-A routes is by ski, snowshoe or sledge. + +## Foliage follows the season, no new axis + +Read the season off the existing cells: a terrace bar open in Dry and furnished in Rain implies summer (deciduous +trees in full leaf); shut in Snow implies winter (bare). Put "whether the deciduous trees are in leaf or bare, and the +color of the grass" in the edit's CHANGE ONLY list, keep "DO NOT add or remove a tree", and say the leaves fill the +tree's own crown outline "and no bigger". Conifers unchanged. Leafing out cost no gate passes. If a matrix carries no +season information, default to summer and file it as an open question. + +## Population by weather (exteriors) + +- **Dry:** people out at plausible density, in period clothing. +- **Rain and snow:** considerably fewer but never empty: a hurried figure, someone under the eaves, a lit window. +- **Night:** fewer people, lit windows; lanterns carried by the SAME people (the noun "lantern" spawns a new person, + so use a headcount lock). +- **Storms:** a hooded pair with a lantern against the warm, populated interior glowing behind the windows. That + contrast is the look. +- Judge density relationally against the same hour's Dry cell; the GM's words define it, not exact counts. +- **Which people a cell keeps is decided BEFORE the edit** by which proxies the plate carries (the renderer removes + people cleanly but cannot be told which to keep). Never keep a proxy mostly hidden behind another without its + occluder; it comes back as a bust or a ghost. + +## Population x time-of-day matrix (venues with people in them) + +For every pub, tavern, inn, dining hall, taproom, and any shop with a counter, sized by tier +(references/effort-tiers.md): + +| tier | hours x densities | frames per camera | +|---|---|---| +| 1 | Morning, Afternoon, Evening, Late Night x Quiet, Moderate, Packed; add Empty only for storyline hubs | 12 (16) | +| 2 | Day, Sunset x Quiet, Moderate, Packed | 6 | +| 3 | its peak hour x Quiet, Packed | 2 | +| 4 | none | 0 | + +Camera: one "reveal from the door" view of the room. Recipe: IMAGE 1 = the canon empty master as "the set, same +tripod at another sitting; ADD ONLY PEOPLE"; name the tables by frame position and put every party on one; give each +density a number (~5 / ~15 / ~35 / ~70 for a big hall) but brief reviewers relationally. Locks that held: +**NEAR-FOREGROUND** (the bottom third shows only the empty near end of the foreground table; the crowd begins halfway +down it; nobody cut off by the bottom edge) fixes guests sitting with their backs to the lens; **LOWER-RIGHT** (the +empty floor before the edge post) stops the packed crowd piling against the frame edge. About 1 take in 6 comes back +reframed; a **structure-band gate** (the thresholds measured on the top ~44 % of the frame, rafters and windows, which +people never touch) catches it. **Zoom-check the master's props before the population wave:** people inherit the +master's defects, and fixing the master (one region composited from a clean sibling) is cheaper than fixing 12 cells. + +A winter version of the population matrix is a later problem; build the summer one first. + +## Matrix traps measured in use + +- **Landmark creep:** a view facing AWAY from the river or the castle grew them back in 3 of 8 cells; the gate is blind + to distant low-texture tiles. Lock by naming the absence: "the view looks WEST, away from the river: there is NO + river, NO lake, NO water of any kind, NO castle; they are behind the camera." 5/5 after. +- **Furniture persistence in a "shut" state:** the bar counter survived in every take because the prompt only said + it was gone. Say what stands there instead: "under the roof there is NOTHING: no counter, no shelves, no casks; only + the bare snowy deck and the balustrade beyond." A take that keeps the counter can pass the geometry gate precisely + because it kept it; do not let the gate pick. +- **Guests on the shut terrace:** "2-3 guests on the balcony" in a winter cell put them on the terrace above it. The + noun beats the negation. State WHERE everyone is as a positive fact (on the street, the quay, the balcony "one full + story below the terrace") and repeat the terrace's untrodden snow. +- **"Steam vents along the river front"** become pale ghost figures. A recurring see-through figure is usually the + steam clause. +- **"Several people"** came back as 15-27. Use a HEADCOUNT lock ("no more than about N out of doors"). +- **Dry cells carry the most defects** (fused pairs, ghosts, half-bodies on newel posts). Budget re-rolls or a local + fix for them. +- **Local fix** when a take passes every gate but carries one small defect: inpaint a guide, run edit-with-itself on + the guide (4 variants), register and color-match each locally, composite through your own feathered radial mask so + every pixel outside it stays byte-identical, re-gate, eye-check at 4-6x. One or two of four come back clean. Always + disclose fixed cells. diff --git a/references/naming.md b/references/naming.md new file mode 100644 index 0000000..0648e33 --- /dev/null +++ b/references/naming.md @@ -0,0 +1,47 @@ +# Naming conventions + +Names are differentiator-first so a folder sorts into its matrix and a display tool can key on the tokens. + +## Canon frames (table-facing) + +``` +