Skip to content

fix: restage three earlier heroes as designed objects#95

Merged
TMHSDigital merged 1 commit into
mainfrom
fix/earlier-examples-object-staging
Jul 22, 2026
Merged

fix: restage three earlier heroes as designed objects#95
TMHSDigital merged 1 commit into
mainfrom
fix/earlier-examples-object-staging

Conversation

@TMHSDigital

Copy link
Copy Markdown
Owner

Summary

Gallery audit follow-up to #93/#94: three earlier heroes were below the bar the newest cards now set. All changes are render-path/docs; check logic untouched. Also fixes a latent generator defect affecting eight detail pages.

image-pixels-testcard — root cause: the staged scene never set a view transform — the exact AgX murk docs/VISUAL-STYLE.md exists to prevent. Now Standard; the monitor is a designed object (beveled polymer case, machined stand with specular sweep, power LED); lights aimed at explicit targets; the grazing rim that drew a grey wedge at frame right is gone. Screen content pixel-exact.

png-exr-alpha — dim tilted easel cards become two framed verification displays on a shared plinth: pure-emission faces with the exact witness data, machined nameplates (FLOAT → PNG / FLOAT → EXR), grazing wall band eliminated, floor no longer a black hole.

uv-layer-grid — bare leaning planes become framed lightboxes on floor trays with kick legs and status LEDs. The render-coupled self-witness (the script re-reads its still and asserts flat-teal vs checker) survives: sampling follows the panel object origins, which stayed at the face centers, so no assertion changed. Failure property re-proven with a mutated copy (hazard panel secretly given UVs → exit 11).

Generator list fix — eight example READMEs used ordered witness lists that build_gallery.py flattens into run-on paragraphs (it only renders - bullets). All eight converted with content preserved; regenerated pages verified to render real <li> items with no flattened numbering: uv-layer-grid, png-exr-alpha, vse-cut-list, lod-decimate-chain, gltf-export-roundtrip, vertex-weight-limit, triangulate-tangents, gltf-skin-roundtrip.

Contact-sheet gate (measured; new sheets committed)

Criterion image-pixels-testcard png-exr-alpha uv-layer-grid Calibration band
Mean luminance 130.2 127.2 123.8 100.1–143.4
Wall pool R−B +11 +13.0 +38 +8…+58
Subject fill 76.5% height 70.3% width ~80% width 70–90%
Clipped regions 2 sparkle px witness cells only (the data) 0

Test plan and evidence labels

Proven by live run (local headless binaries):

  • .scratch/blender-5.1.2-windows-x64/blender.exe (self-reports Blender 5.1.2, hash ec6e62d40fa9) and .scratch/blender-4.5.11-windows-x64/blender.exe (self-reports Blender 4.5.11 LTS, hash 4db51e9d1e1e)
  • All three examples check-only, exit 0 on both versions, measured values unchanged from baseline (testcard byte round-trip err 0.0019608; png-exr closed-form worst 0.98 / EXR 2.97e-08; uv hazard 0 UV layers, assign err 0.0)
  • uv-layer-grid full --output self-witness on both versions: hazard spread 0.0078 (≤0.02), repair spread 0.7412 (≥0.25); mutated-copy failure probe exits 11
  • png-exr-alpha and testcard render paths also exercised on 4.5, visually identical to 5.1

Established by inspection only:

  • Generated HTML re-read after regeneration: all nine affected detail pages render witness <li> bullets, zero flattened numbered lists
  • blender-smoke.yml steps unchanged

CI: the two blender-smoke legs (4.5 LTS, 5.1) on this PR remain the authoritative cross-version evidence.

A gallery audit after the newest examples' restage found three earlier
heroes below the current bar, plus a latent generator defect.

image-pixels-testcard: the staged scene never set a view transform -
the AgX murk the style guide exists to prevent. Now Standard, the
monitor is a designed object (beveled polymer case, machined stand
with a specular sweep, power LED), lights aimed at explicit targets,
and the grazing rim that drew a grey wedge at frame right is gone.

png-exr-alpha: dim easel cards become two framed verification
displays on a shared plinth, pure-emission faces with the exact
witness data, machined nameplates (FLOAT -> PNG / FLOAT -> EXR),
grazing wall band eliminated, floor legible.

uv-layer-grid: bare leaning planes become framed lightboxes on floor
trays with kick legs and status LEDs. The render-coupled self-witness
was preserved by keeping the panel object origins at the face centers
(sampling follows the origins, so no assertion change); a mutated
copy that secretly gives the hazard panel UVs still fails with
exit 11. Repair spread moved 0.7294 -> 0.7412 (larger projected
cells, same wide margin); hazard flat-spread unchanged at 0.0078.

Also: eight example READMEs used ordered witness lists that
scripts/build_gallery.py flattens into run-on paragraphs (it only
renders dash bullets). Converted all eight (uv-layer-grid,
png-exr-alpha, vse-cut-list, lod-decimate-chain,
gltf-export-roundtrip, vertex-weight-limit, triangulate-tangents,
gltf-skin-roundtrip), content preserved; regenerated pages verified
to render real <li> items with no flattened numbering.

All three restaged examples pass check-only on Blender 4.5.11 LTS and
5.1.2 (exit 0, measured values unchanged); render paths exercised on
both versions. Contact sheets committed with measured evidence:
candidate mean luminance 130.2 / 127.2 / 123.8 against the 100-143
calibration band; wall pools +11 / +13 / +38 R-B; fills 76.5% / 70.3%
/ ~80%; no blown regions.

Signed-off-by: fOuttaMyPaint <TMhospitalitystrategies@gmail.com>
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Jul 22, 2026
@TMHSDigital
TMHSDigital merged commit 9f30674 into main Jul 22, 2026
9 checks passed
@TMHSDigital
TMHSDigital deleted the fix/earlier-examples-object-staging branch July 22, 2026 12:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant