Eve library

ISIS V2 Rig Readiness Validators

Guide

Revision 1

On this page

WS06-006 adds rig-readiness validation in @isis/3d-generation via src/processing/rig-readiness-validator.ts.

Implemented Checks#

  • naming checks
    • Duplicate name detection.
    • Convention-aware format checks (mixamo, unreal, unity, blender, maya, custom).
  • hierarchy checks
    • Root-bone cardinality checks.
    • Missing parent references.
    • Parent/child linkage consistency checks.
    • Cycle detection and disconnected-bone detection.
    • Deform-bone presence enforcement.
  • skin weight checks
    • Integrates validateSkinWeights for weight sum/index validity.
    • Enforces max influences per vertex.
    • Enforces max unweighted-vertex ratio.
  • bind pose checks
    • Requires bind-pose coverage for all bones.
    • Validates matrix shape, finiteness, and invertibility.

API#

  • createRigReadinessInputFromSkeleton(skeleton, skinWeights?)
  • validateRigReadiness(input, options?)

Default Thresholds#

  • requireSkinWeights: true
  • requireBindPose: true
  • maxSkinInfluences: 4
  • maxUnweightedVertexRatio: 0.02
  • skinWeightTolerance: 0.001