litruv 0894e762f9 Camera and reader rules corrected against a real file
The depth row maps the slab to the full clip range, not half of it, so the CPU sort and the GPU
depth test agree on which fragment is nearer. The screen-right axis is the unit horizontal: built
as forward x worldUp it carries a factor of cos(pitch) and compresses screen X as the camera tilts,
so the pitch clamp is the edge-on guard rather than a fix for a zero vector.

MAT4 is an accessor type and count is the number of elements, not floats, which is the shape a
skin's inverse bind matrices actually have. node.matrix is column-major while Mat4 is row-major.
A skin's joints must be resolved by node index, because CesiumMan.glb keeps its skeleton outside
the scene root.
2026-11-03 21:04:53 +11:00

3D model reference layer

Design work for Umamo's Pose Reference wish (umamo/TODO.md § Future Feature Wishes): a poseable 3D mannequin that sits in the viewport as an overlay, plus import of the user's own glTF model as the reference object.

Umamo is a 2D puppet editor. This does not make it a 3D modeler. The reference layer is a drawing aid: proportions, anatomy, foreshortening, and scale, checked against the drawing.

Contents

Path What it is
docs/spec.md The design: data model, camera, draw path, persistence, UI, non-goals
docs/seams.md The RenderDevice seam changes the feature forces, and why
docs/pr-stack.md The stack of mergeable PRs, in order
sketch/ Kotlin reference implementation of the pure parts, shaped like the umamo modules
verify/verify.py Proof harness for the three pure algorithms

Verified facts

python3 verify/verify.py runs 25 checks against the algorithms the sketch implements: GLB container rules, accessor alignment, forward kinematics invariants, and the orbit camera basis. All pass. The numbers those checks assert are the numbers the sketch's tests pin.

Two of them are findings, not assertions:

  • An accessor whose resolved byteOffset is not a multiple of its component size must be rejected, not read.
  • At pitch == ±90° the camera looks along the world up axis and the screen-right axis collapses to a zero vector. The camera must clamp pitch to the open interval.

License

GPLv3, matching Umamo.

S
Description
3D model reference layer for Umamo: poseable mannequin + glTF import overlay. Design spec and reference implementation sketch.
Readme GPL-3.0
77 KiB
Languages
Kotlin 56.1%
Python 43.9%