Module measure 

Measurements: the raw per-clip metric map that measure emits and lint judges. Kept separate from findings so pipelines (e.g. a bake’s measured sidecar) can pin their own contracts to the numbers.

Structs

Aabb

Axis-aligned bounding box of a mesh’s positions, in scene units (metres, Y-up — the converted space every loader hands over).

ClipMeasurements

Measurements for one clip in the measure output map.

GaitMeasurement

Role-dependent gait metrics for one clip.

MeshMeasurements

Static (animation-independent) measurements of one mesh carried in SceneAssets. Emitted by measure when the input carried geometry (both the FBX and glTF loaders fill SceneAssets). Vertex data is read as authored — indexed meshes count their unique vertices, unindexed meshes count every triangle corner.

Constants

MIN_RECORDED_ROTATION_DEG

Rotation ranges below this are not recorded (matches the incubating pipeline’s convention).

Functions

measure_document

Measure every clip using shared metric pose grids. Role-dependent metrics (loop seam, gait, root-motion speed) are present only where the roles resolve; pass an empty ResolvedRoles to skip them.

measure_meshes

Measure every mesh in the document’s SceneAssets, in document order. Returns an empty vector when no geometry was loaded (the lint/inspect path and asset-less files), so callers that don’t carry assets emit nothing extra. Hostile geometry never crashes or leaks a non-finite bound: non-finite positions and weight sums are dropped from the AABB / weight-sum stats (and still flow to the nan check), so the emitted numbers are always finite.