Skip to content

Commit 2690e05

Browse files
committed
docs: cross-reference the pipeline arc and commit the audit contact sheet
lod-decimate-chain's README gains the modeling/LOD - weighting - export stage references (the other two arc READMEs carry theirs in their fix commits), and the combined seven-cell audit contact sheet — four audited heroes beside the pinned calibration set — is committed per the contact-sheet gate. Signed-off-by: fOuttaMyPaint <TMhospitalitystrategies@gmail.com>
1 parent 099ac17 commit 2690e05

3 files changed

Lines changed: 5 additions & 0 deletions

File tree

55.4 KB
Loading

‎docs/gallery/lod-decimate-chain/index.html‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -184,6 +184,7 @@ <h1>lod-decimate-chain</h1>
184184
</div>
185185
<section class="detail-section md">
186186
<p>A runnable example that builds a retro toy rocket — a lathed body with an ogive nose, three swept fin plates, a porthole, every dimension a closed form — and evaluates it at LOD0/1/2 through the Decimate modifier via the depsgraph, following <a href="https://github.com/TMHSDigital/Blender-Developer-Tools/tree/main/skills/depsgraph-and-evaluated-data/SKILL.md"><code>depsgraph-and-evaluated-data</code></a> and <a href="https://github.com/TMHSDigital/Blender-Developer-Tools/tree/main/skills/mesh-editing-and-bmesh/SKILL.md"><code>mesh-editing-and-bmesh</code></a>.</p>
187+
<p><strong>Pipeline arc:</strong> modeling/LOD here, weighting in <a href="https://github.com/TMHSDigital/Blender-Developer-Tools/tree/main/examples/vertex-weight-limit"><code>vertex-weight-limit</code></a>, export in <a href="https://github.com/TMHSDigital/Blender-Developer-Tools/tree/main/examples/gltf-export-roundtrip"><code>gltf-export-roundtrip</code></a>.</p>
187188
<p><strong>What it witnesses:</strong> the modifier-based LOD contract that game asset pipelines rely on.</p>
188189
<p>1. <strong>Decimate is non-destructive and lives in the depsgraph.</strong> The evaluated mesh carries the reduction; the original datablock is byte-identical before and after evaluation. The check proves both — evaluated counts drop while <code>obj.data</code> keeps the closed-form counts (1,147 verts / 2,260 tris) — and every evaluated reference is released with <code>to_mesh_clear()</code>. An LOD chain that bakes the reduction into <code>obj.data</code> destroys the asset&#x27;s LOD0. 2. <strong>The COLLAPSE ratio is a target, not a guarantee.</strong> Each LOD&#x27;s evaluated triangle count must land within 5% of <code>ratio x base_tris</code> — measured 0.00% at ratio 0.5 (1,130 tris) and 0.44% at ratio 0.18 (405 tris). A stacked second Decimate halves the effective ratio (50% excursion, caught); a dropped modifier leaves evaluated == original (caught). 3. <strong>LODs preserve silhouette-critical dimensions.</strong> Height (3.12) and fin span are the rocket&#x27;s readability; the evaluated bbox holds the base bbox within 1e-3 at every level (measured 7.7e-6). Decimate has no vertex pinning, so this is a real risk, not a formality: at an aggressive ratio 0.02 the nose tip collapses (bbox drift 0.0206, caught).</p>
189190
<p>The Decimate modifier API (<code>decimate_type=&#x27;COLLAPSE&#x27;</code>, <code>ratio</code>) is stable between Blender 4.5 LTS and 5.1 — the example runs identically on both, which is itself the version witness (measured values match to the digit).</p>

‎examples/lod-decimate-chain/README.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,10 @@ evaluates it at LOD0/1/2 through the Decimate modifier via the depsgraph,
66
following [`depsgraph-and-evaluated-data`](../../skills/depsgraph-and-evaluated-data/SKILL.md)
77
and [`mesh-editing-and-bmesh`](../../skills/mesh-editing-and-bmesh/SKILL.md).
88

9+
**Pipeline arc:** modeling/LOD here, weighting in
10+
[`vertex-weight-limit`](../vertex-weight-limit/), export in
11+
[`gltf-export-roundtrip`](../gltf-export-roundtrip/).
12+
913
**What it witnesses:** the modifier-based LOD contract that game asset pipelines
1014
rely on.
1115

0 commit comments

Comments
 (0)