AutoMovie API
    Preparing search index...
    • The elbow place of least joint strain for a hand goal.

      A wrist's place leaves the elbow free on a circle about the line from the shoulder to the wrist. Every place on it is tried at one degree steps and refined between steps. A place is allowed when the shoulder and the elbow stay inside their ranges of motion and the forearm clears the trunk, the neck and the head along its length (HumanArmClearance.overshoot). Among the allowed places the one of least strain is returned. Strain is the sum, over the shoulder's flexion, abduction and twist, of the squared distance from the angle an unloaded hanging arm has, each divided by half that axis's range. A hand rotation adds the forearm's twist and the wrist's bend the rotation needs, each squared and divided by half its range. The weights are 1 and provisional. A place whose forearm twist, wrist flexion or wrist deviation would come within RESERVE of the end of its range, each read signed as its joint's clinical angle (so the same motion reads the same on either hand), is one where the hand cannot make the rotation with room to spare; it ranks behind every place that makes it, by the degrees left unmade.

      Parameters

      Returns IAutoMovieVector3

      The elbow's place, world metres, usable as a bend hint.

      When the wrist is farther from the shoulder than the arm is long, or no place on the circle is allowed, and no fallback is given.