AutoMovie API
    Preparing search index...

    Variable HUMANOID_JOINT_AXESConst

    HUMANOID_JOINT_AXES: Partial<Record<AutoMovieHumanoidBone, IAutoMovieJointAxes>> = ...

    Per-bone clinical axes for the canonical humanoid rest pose (VRM T-pose: arms out along ±X, legs down −Y, facing +Z), parallel to DEFAULT_HUMANOID_ROM.

    A T-pose arm points along its local X, so the default basis would make flexion roll the arm along its length instead of swinging it fore/aft. Mapping flexion→Y and twist→X (abduction stays Z) makes the clinical angles anatomically correct: flexion swings the arm sagittally (a walk's arm-swing), abduction raises it to the side (a jumping jack), twist rotates it about its length.

    The hip, ankle and toes flex about −X. A right-handed turn about +X carries what stands above a joint forward, what hangs below it backward and what lies ahead of it down: anatomical flexion for the spine, neck and head (the trunk bends forward) and the knee (the shank folds back), but extension for the hip and plantarflexion for the ankle and toes. About −X, positive hip flexion swings the thigh forward and positive ankle and toe flexion lift the toes (dorsiflexion), the senses the table's ranges give them: hip flexion to 120°, ankle dorsiflexion to 20° and toe dorsiflexion to 80°. Both sides share the axis; abduction and twist keep the default Z and Y. The knee, spine, neck, head, jaw and eyes already align with the default basis, so they are omitted (and fall back to it).

    The hand and every finger and thumb segment flex about Z, carrying the fingertips toward the −Y palm, and twist about their length. The hand, the thumb and the index and middle fingers deviate or abduct about +Y, toward the thumb on the +Z side; the ring and little fingers abduct about −Y, away from the middle finger. The thumbs, which point between ±X and +Z, take the hand's basis as an approximation.

    Both sides share every axis: HUMANOID_REST_FRAME reverses, on one side, each axis that lies in the body's mirror plane, so a clinical value means the same motion on the left and the right.

    The forearm's twist is pronation and supination, which happens beyond the elbow's hinge, so the lower arms declare a distal twist (AutoMovieJointTwistPlacement): twisting a bent forearm turns it about its own length and leaves where it points unchanged.

    The upper arms declare a distal twist too. The humerus's internal and external rotation turns it about its own length wherever the arm points, which only the distal order composes. In the proximal order the twist turns about the T-pose arm line, fixed in the shoulder girdle: for an arm in the sagittal plane (hanging, swinging, reaching forward) that line is the flexion axis carried there by the 90 degree abduction from rest, so flexion and twist turn about one axis, the chart is at its gimbal for every such pose, and the arm's rotation about its length has no coordinate of its own there. With the distal order flexion and abduction alone place the arm (its line's latitude toward the front and its longitude in the frontal plane) and twist is the humeral rotation; the only gimbal left is the arm pointing straight forward or back, where abduction and twist turn about the arm's own line. A pose with no twist is the same rotation in both orders. Every other bone keeps the proximal default.

    Opt in by passing this to resolvePose / applyPose; a bone that declares its own axes keeps them, and a bone absent from both uses DEFAULT_JOINT_AXES. The canonical rest pose itself is stated on HUMANOID_REST_FRAME.