AutoMovie API
    Preparing search index...

    Interface IAutoMovieMotionHumanBody

    A performer's body as motion laws read it: the canonical VRM rig and its physical profile, with the measure, the anatomical surfaces, the rig's topology, rest joint positions, immutable FK prerequisites and bone-local mass model derived once on its first actual read.

    Any canonical humanoid serves: a Human adapted by AutoMovieHumanCanonicalBody.adapt (the polygon man), an imported VRM character with a profile, or any other rig in the canonical T-pose frame (+Y up, facing +Z, the left toward +X). Laws scale every distance from the measure, so the same law fits any stature and proportion.

    interface IAutoMovieMotionHumanBody {
        bones: ReadonlyMap<AutoMovieHumanoidBone, IAutoMovieBone>;
        chains: Readonly<
            Partial<
                Record<
                    "leftArm"
                    | "rightArm"
                    | "leftLeg"
                    | "rightLeg",
                    IAutoMoviePrepareChainConstants.IConstants,
                >,
            >,
        >;
        colliderBones: IAutoMovieSkeletonPoseResolution.IBoneDemand;
        hanging: (side: AutoMovieHumanSide) => IAutoMovieResolvedJointAngles | null;
        massModel: IAutoMovieResolveCenterOfMass.IModel;
        measure: IAutoMovieBodyMeasure;
        poseResolution: IAutoMovieSkeletonPoseResolution.IRig;
        profile: IAutoMoviePhysicalProfile;
        projection: IAutoMovieClampPose.IPrepared;
        reads: IReads;
        rest: ReadonlyMap<AutoMovieHumanoidBone, IAutoMovieVector3>;
        settled: ReadonlySet<AutoMovieHumanoidBone>;
        skeleton: IAutoMovieSkeleton;
        surfaces: ISurfaces;
        topology: IAutoMovieSkeletonTopology;
        upright: IAlignment;
    }
    Index

    The rig's bone records by name, the first record of each name in the rig's order, indexed once with the body.

    chains: Readonly<
        Partial<
            Record<
                "leftArm"
                | "rightArm"
                | "leftLeg"
                | "rightLeg",
                IAutoMoviePrepareChainConstants.IConstants,
            >,
        >,
    >

    Each limb's two-bone chain as the rig alone fixes it (prepareChainConstants), read once: a fit places the chain under a pose from these and the frame of the chain root's parent, and reads the rig through the record's fit readers (rig), built for this body's merged axes and the humanoid rest frames. A limb whose chain is not parent to child twice has none.

    The rig's bound demand of every bone a collider rides (HumanColliders.bones), made on its first read: a whole-body reader of the colliders or the mass (HumanBalance.centre) reads a pose through it.

    The shoulder's clinical angles, degrees, of the side's unloaded hanging arm (AutoMovieMotionHumanBend.hanging), the angles an elbow's strain is measured from; read once per side on its first use, null when the rig has no arm chain.

    Type Declaration

    Bone-local mass/inertia model derived on its first read, once successfully, from the unchanged rig/profile.

    The anthropometric measure, metres and kilograms.

    Immutable canonical FK prerequisites, prepared once with this body's rig.

    The physical profile on the rig's bones.

    The rig's range-of-motion projection of a whole pose (clampPose.prepare), built once on this body's rig: every joint of the given pose clamped in order into a new pose, carrying its one-joint clamp and that clamp's angle-taking form (joints, values). Every consumer of the body's ordinary ROM reads this one; like the FK prerequisites it describes the rig the body was made from.

    reads: IReads

    What each limb's fit reads of a pose (humanLimbReads), read once from the rig: per limb and per whether the other arm is placed, the bones its reduced pose keeps and the bound demand of its source read, for a goal attached to no bone.

    Rest joint positions, canonical metres.

    settled: ReadonlySet<AutoMovieHumanoidBone>

    The joints whose range clamp gives a record it issued back bit for bit and that no writer of a resolved posture sets outside a clamp (humanSettledJoints), read once from the rig: a plain displayed pose keeps their records through its final clamp.

    The canonical rig at its T-pose rest.

    surfaces: ISurfaces

    Regions and sockets as bone-local frames.

    The rig's topology, shared by every fit.

    upright: IAlignment

    The body's quiet-stance alignment (standUpright): its plumb-line trunk, neck and level head and its forward lean, a property of the body solved on its first read, once, from the unchanged rig and profile.