These pages are auto-generated from self-documenting comments embedded in class files.
For more information on breve and steve, refer to the breve homepage.

Joint : UniversalJoint

Class description:

This subclass of Joint is used to link two Link objects together using a universal joint.

A universal joint has two degrees of freedom. It can rotate "up-and-down" and "side-to-side", but cannot "twist". Your wrist is basically a universal joint--your hand cannot rotate without the rest of your arm.

Methods:

  • getJointAngles
  • link
  • setJointLimits
    getJointAngles( self )

    Returns a vector indicating how the angle of this joint is from its natural position (which corresponds to a values of 0 on both axes). Only the X- and Y- components of the vector are valid for UniversalJoints.

    link( self, normal, parentPoint, childPoint, childLink, parentLink, currentRotation )

    Creates a universal (rotation on two axes) joint between parentLink and childLink. The joint will be lcoated at parentPoint on the parent's body, and at childPoint on the child's body.

    Universal joints have two rotation axes, both of which are perpendicular to the parentPoint. Think about the forearm linking to the hand at the wrist--the axes of rotation of the wrist are both perpendicular to the line from the center of the forearm (which represents the parentPoint). The normalVector specifies one of the rotation axes, while the other is calculated automatically (perpendicular to both parentPoint and normalVector).

    If parentLink is the value 0, then the joint will be attached to a fixed point in the world, specified with parentPoint.

    setJointLimits( self, min1, max1, min2, max2 )

    Sets the minimum and maximum allowed rotations (in radians) for this joint on both of the joint's axes.