AutoMovie API
    Preparing search index...

    Function resolveAutoMovieHumanoidSurfaces

    • Resolve every anatomical region and contact socket of a canonical humanoid onto its collision shapes, as bone-local frames that follow any pose.

      The rig must rest in the canonical VRM T-pose frame (+Y up, facing +Z, the left toward +X). A region is defined by its bone, a station on the bone's segment (a share of the way from the bone's joint toward a child joint, or the centre of the bone's colliders) and an outward direction in the rest frame; its point is where a ray from the station along the direction leaves the bone's colliders (exact ray exits of spheres, capsules and boxes; the colliders are convex and closed, so the union's exit is the largest and a station on a face counts as inside), and its normal is the outward normal of the collider it leaves there (surfaceNormal): the authored direction only finds the point, as a contact frame's normal is the collision geometry's. A normal read from the direction instead stood up to 44 degrees off the surface (the nape's 24), so a palm laid flat on it sank its heel 14.8 mm into the neck. This is how authored hit and touch locations are placed on character physics bodies in game engines (a bone plus a local offset on its collider), generalised so the offset comes from the body's own shapes and fits any size. The palm, sole, heel and seat regions share their sockets' points, and every digit's tip and pad ride its distal phalanx (AutoMovieHumanoidDigitSurfaces): the tip the exit of a ray along the phalanx, the pad that of a ray from its middle toward the palm. Sockets of the foot, seat and back are read from the exact axis bounds of their segment's colliders at rest (heel at the back of the sole, ball under the toe joint, toe at the front, sole at the middle, seat under the pelvis, back behind the thorax; when the profile gives the toes their own segment, the toe socket is the front of the toes' colliders on the sole's plane and rides the toes bone, so it bends at the ball and bears when the heel rises about the toes' joint); the palm is the ray exit below the palm's middle, the grip lies 0.025 m out from it, the radius of a 50 mm handle, the power grip's optimal handle size (Grant, Habes and Steward 1992), and the fist lies 0.012 m ahead of the middle knuckle, the metacarpal head's radius.

      A frame is bone-local: point and normal (and a socket's forward) are expressed in the bone's rest frame relative to its joint, so its world frame under any pose is the bone's world position plus its world rotation applied to them.

      The left side is the mirror of the right: a left region or socket (and the spleen, the liver's twin) is its right twin's frame mirrored in the median plane (mirrored), on the opposite bone, so a left act reads a frame that is the mirror of the right one to the bit, as the rig's own rest is.

      Parameters

      • skeleton: IAutoMovieSkeleton

        The canonical rig.

      • profile: IAutoMoviePhysicalProfile

        Its physical profile, segments keyed by rig bones.

      • Optionalneutral: IPrepared

        Optional genuine internal unchanged-profile bounds epoch, owned and released by measureAutoMovieHumanoidBody.withSurfaces.

      Returns ISurfaces

      Every region and socket.

      When a bone or segment a definition needs is missing, or a ray misses its colliders.