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.

Real : Mobile

Class description:

Mobile objects are objects in the simulated world which move around and interact with other objects. This is in contrast to Stationary objects which can collide and interact with other objects but which never move.

When a Mobile object is created, it will be by default a simple sphere. You can change the appearence of this sphere by using methods in this class, or its parent class Real. Or you can change the shape altogether with the method set-shape.

Methods:

  • checkForPenetrations
  • checkForSelfPenetrations
  • disablePhysics
  • enablePhysics
  • getAcceleration
  • getBoundMaximum
  • getBoundMinimum
  • getCollidingObjects
  • getDistance
  • getForce
  • getLinkPointer
  • getMass
  • getRotationalVelocity
  • getTorque
  • getVelocity
  • offset
  • register
  • relativeRotate
  • removeLabel
  • resumePhysics
  • rotate
  • set
  • setAcceleration
  • setForce
  • setLabel
  • setRotationalAcceleration
  • setRotationalVelocity
  • setTorque
  • setVelocity
  • suspendPhysics
  • transform
    checkForPenetrations( self )

    Depricated.


    checkForSelfPenetrations( self )

    Determines whether this link is currently penetrating with other links in the same multibody. This is not meant as a general purpose collision detection tool -- it is meant to detect potentially troublesome configurations of links when they are created.


    disablePhysics( self )

    Disables the physical simulation for a Mobile object.


    enablePhysics( self )

    Enables physical simulation for a Mobile object. This must be used in conjunction with a PhysicalControl object which sets up physical simulation for the entire world.

    When physics is enabled for an object, the acceleration can no longer be assigned manually--it will be computed from the forces applied to the object.


    getAcceleration( self )

    Returns the vector acceleration of this object.


    getBoundMaximum( self )

    Returns the vector representing the maximum X, Y and Z locations of points on this link.


    getBoundMinimum( self )

    Returns the vector representing the minimum X, Y and Z locations of points on this link.


    getCollidingObjects( self )

    Returns a list of objects currently colliding with this object. This is not meant as a general purpose collision detection tool -- it is meant to detect potentially troublesome configurations of links when they are created.


    getDistance( self, otherObject )

    Returns the scalar distance from this object's center to otherObject.


    getForce( self )

    Returns the force acting on the object, which was previously set using set-force.


    getLinkPointer( self )

    For internal use only.


    getMass( self )

    Returns the mass of the object.


    getRotationalVelocity( self )

    Returns the vector angular velocity of this object.


    getTorque( self )

    Returns the torque acting on the object, which was previously set using set-torque.


    getVelocity( self )

    Returns the vector velocity of this object.


    offset( self, amount )

    Moves this object by amount, relative to its current position.


    register( self, theShape )

    Deprecated. Don't use.


    relativeRotate( self, thisAxis, amount )

    Sets the rotation of this object around vector axis thisAxis by scalar amount (in radians). This is a rotation relative to the current position.


    removeLabel( self )

    Removes the label that would be drawn next to an object.


    resumePhysics( self )


    rotate( self, thisAxis, amount )

    Deprecated. Renamed to set-rotation.


    set( self, theShape )

    Deprecated. Don't use.


    setAcceleration( self, newAcceleration )

    Sets the acceleration of this object to newAcceleration. This method has no effect if physical simulation is turned on for the object, in which case the physical simulation engine computes acceleration.


    setForce( self, newForce )

    Sets the velocity acting on the object to newForce. This force will remain in effect until it is disabled with a new call to set-force.


    setLabel( self, theLabel )

    Sets the label to be drawn along side the object.


    setRotationalAcceleration( self, newAcceleration )

    Sets the rotational acceleration of this object to newAcceleration. This method has no effect if physical simulation is turned on for the object, in which case the physical simulation engine computes acceleration.


    setRotationalVelocity( self, angularVelocity )

    Sets the rotational velocity of this object to angularVelocity.


    setTorque( self, newTorque )

    Sets the torque acting on the object to newTorque. This torque will remain in effect until it is disabled with a new call to set-torque.


    setVelocity( self, newVelocity )

    Sets the velocity of this object to newVelocity.


    suspendPhysics( self )


    transform( self, theVector )

    Transforms theVector in the world coordinate frame to a vector in the frame of this object.