Skip to content

Tutorial Inspect A Gltf

Marko Koljancic edited this page May 25, 2026 · 5 revisions

Home

Tutorial: Inspect a glTF for delivery

A QA walkthrough for an artist shipping a glTF asset - cycle every inspection mode, run the wireframe weights, isolate meshes from the Outliner, then surface validation findings in the Analyze TUI before re-exporting.

Phase 1 scaffold. The full tutorial lands in Phase 2. See Inspection for the feature reference.


Goal

Phase 2: a one-sentence outcome - "review every dimension of a glTF before delivery."


Setup

Phase 2: a .glb to inspect; the GUI launched.


Steps

Phase 2:

  1. Load the GLB.
  2. Cycle inspection modes: 1 Shaded → 2 Material ID → 3 UV Map → 4 Texel Density → 5 Depth → 6 Overdraw → 7 AO Preview.
  3. Toggle wireframe overlay (W), step line weight (Shift+W).
  4. Use the Outliner to isolate a single mesh; confirm UVs.
  5. Run the Analyze TUI: solarxy-cli --mode analyze -m model.glb.
  6. Fix and re-export.

Screenshots to capture:

  • img/inspection-modes-mosaic.png - six-up grid of the inspection modes.
  • img/inspection-wireframe-weights.png - three-up Light / Medium / Bold.
  • img/inspection-uv-map.png - UV Map mode with checker background.
  • img/inspection-texel-density.png - texel density heatmap.
  • img/tutorial-outliner-isolate.png - Outliner with one mesh isolated.

Verify

Phase 2: the post-fix Analyze TUI shows zero validation errors and the texel density heatmap reads green.


What you learned

Phase 2: when to reach for each inspection mode, the wireframe-weight trade-off, and how Outliner isolation interacts with the validation overlay.


Where to go next

Phase 2: pointers to Inspection, Validation Reference, and the CI tutorial.


See also: Inspection · Quickstart · Validation Reference · Tutorial: Validate in CI

Clone this wiki locally