Skip to content

Commit 1f3aa20

Browse files
TMHSDigitalclaude
andcommitted
docs: ngon-triangulate re-verified, the UV-map error that masks the abort
Re-verified on 4.5.11, 5.1.2 and 5.2.1: the abort text, the glTF 12-tri claim and all exits hold. Documents the UV-map error that calc_tangents raises first and that differs by version, states nothing is version-gated, and corrects the exit-1 wrapper description. No code change. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com>
1 parent 350751c commit 1f3aa20

1 file changed

Lines changed: 34 additions & 1 deletion

File tree

‎examples/ngon-triangulate/README.md‎

Lines changed: 34 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,39 @@ Error: Tangent space can only be computed for tris/quads, aborting
3636
survives a reword of the surrounding sentence but still fails if the
3737
abort stops happening at all.
3838

39+
**Affected versions:** all three targeted series. Nothing here is
40+
version-gated: the abort, the counts and both falsifier exits are the
41+
same on 4.5.11 LTS, 5.1.2 and 5.2.1 LTS, so neither falsifier is
42+
expected to exit 0 anywhere.
43+
44+
**The UV map comes first.** `calc_tangents` checks for a UV map before
45+
it looks at face sizes. On a mesh with no UV layer it fails with a
46+
different message, and the n-gon abort is never reached:
47+
48+
```
49+
Error: Tangent space computation needs a UV Map, "(null)" not found, aborting # 4.5.11 LTS
50+
Error: Tangent space computation needs a UV Map, "" not found, aborting # 5.1.2, 5.2.1 LTS
51+
```
52+
53+
So a mesh that has both problems shows only the UV error; add a UV map
54+
and the `tris/quads` abort appears next. `build()` adds `UVMap` so the
55+
check witnesses the n-gon abort, and because the match is on
56+
`tris/quads`, a missing UV map would fail the check (exit 4) rather than
57+
pass it.
58+
59+
### Re-verified
60+
61+
Run on 4.5.11 LTS, 5.1.2 and 5.2.1 LTS with a scratch probe that
62+
repeats the construction:
63+
64+
| Claim | 4.5.11 | 5.1.2 | 5.2.1 |
65+
| --- | --- | --- | --- |
66+
| n-gon + UV map: `tris/quads` abort, byte-identical text | yes | yes | yes |
67+
| n-gon, no UV map: UV-map error instead | `"(null)"` | `""` | `""` |
68+
| glTF index count / 3, dissolved mesh | 12 | 12 | 12 |
69+
| glTF index count / 3, plain cube | 12 | 12 | 12 |
70+
| default / `--no-dissolve` / `--skip-triangulate` exit | 0 / 3 / 4 | 0 / 3 / 4 | 0 / 3 / 4 |
71+
3972
## Falsifiers
4073

4174
Each flag breaks one stage and lands on the assertion that stage feeds.
@@ -70,7 +103,7 @@ against it.
70103
| Code | Meaning |
71104
| --- | --- |
72105
| 0 | Success |
73-
| 1 | Uncaught exception (FATAL wrapper) |
106+
| 1 | Uncaught exception (the `__main__` wrapper prints `ERROR: <type>: <message>`) |
74107
| 2 | argparse / usage |
75108
| 3 | Pathology missing: n-gon count, loops, or face count (`--no-dissolve` lands here) |
76109
| 4 | `calc_tangents` / triangulate handling (`--skip-triangulate` lands here, via the real handling assertion) |

0 commit comments

Comments
 (0)