Your Ad Here

Go to: Synopsis. Flags. Return value. Related. MEL examples.

Synopsis

rigidBody [-active] [-angularVelocity] [-applyForceAt string] [-bounciness float] [-cache boolean] [-centerOfMass float float float] [-collisions boolean] [-contactCount] [-contactName] [-contactPosition] [-damping float] [-deleteCache] [-dynamicFriction float] [-force] [-ignore boolean] [-impulse float float float] [-impulsePosition float float float] [-initialAngularVelocity float float float] [-initialVelocity float float float] [-layer int] [-lockCenterOfMass boolean] [-mass float] [-name string] [-orientation float float float] [-particleCollision boolean] [-passive] [-position float float float] [-solver string] [-spinImpulse float float float] [-standInObject string] [-staticFriction float] [-tesselationFactor int] [-velocity]

rigidBody is undoable, queryable, and editable.

This command creates a rigid body from a polygonal or nurbs surface.

Flags

active, angularVelocity, applyForceAt, bounciness, cache, centerOfMass, collisions, contactCount, contactName, contactPosition, damping, deleteCache, dynamicFriction, force, ignore, impulse, impulsePosition, initialAngularVelocity, initialVelocity, layer, lockCenterOfMass, mass, name, orientation, particleCollision, passive, position, solver, spinImpulse, standInObject, staticFriction, tesselationFactor, velocity
Long name (short name) [argument types] Properties
-name(-n) string createqueryedit
Assigns the rigid body the given name.

In query mode, this flag needs a value.

-position(-p) float float float createqueryedit
Sets the initial position (x,y,z) of the rigid body. Default: current position.

In query mode, this flag needs a value.

-orientation(-o) float float float createqueryedit
Sets the initial orientation (x,y,z) of the rigid body. Default: current orientation.

In query mode, this flag needs a value.

-active(-act) createqueryedit
Creates a rigid body that is active. An active rigid body accepts and causes collisions and is effected by dynamic fields. This is the default.

In query mode, this flag needs a value.

-passive(-pas) createqueryedit
Creates a rigid body that is passive. A passive rigid body does not react to collisions but active rigid bodies can collide with it. Dynamic Fields will not effect a passive rigid body. Only passive rigid bodies can be keyframed.

In query mode, this flag needs a value.

-layer(-l) int createqueryedit
Sets the collision layer of the rigid body. Only rigid bodies in the same collision layer can collide with each other. Range: >= 0 Default: 0.

In query mode, this flag needs a value.

-collisions(-cl) boolean createqueryedit
Truns collisions on/off for the rigid body. If the collisions are turned of the rigid body will not collide with any other rigid body. Default: on.

In query mode, this flag needs a value.

-tesselationFactor(-tf) int createquery
Sets the tesselation factor for a rigid body surface. Range: >= 10 Default: 200.

In query mode, this flag needs a value.

-mass(-m) float createqueryedit
Sets the mass of the rigid body. Range: > 0 Default: 1.0

In query mode, this flag needs a value.

-staticFriction(-sf) float createqueryedit
Sets the static friction for the rigid body. Range: 0.0 - 1.0 Default: 0.2

In query mode, this flag needs a value.

-dynamicFriction(-df) float createqueryedit
Sets the dynamic friction for the rigid body. Range: 0.0 - 1.0 Default: 0.2

In query mode, this flag needs a value.

-bounciness(-b) float createqueryedit
Sets the restitution (or bounciness) of the rigid body. Range: 0.0 - 2.0 Default: 0.6

In query mode, this flag needs a value.

-damping(-dp) float createqueryedit
Sets the damping value of the rigid body. Range: -2.0 - 2.0 Default: 0.0

In query mode, this flag needs a value.

-initialVelocity(-iv) float float float createqueryedit
Sets the initial velocity of the rigid body. Default: 0.0 0.0 0.0

In query mode, this flag needs a value.

-initialAngularVelocity(-iav) float float float createqueryedit
Sets the initial angular velocity of the rigid body. Default: 0.0 0.0 0.0

In query mode, this flag needs a value.

-centerOfMass(-com) float float float createqueryedit
Sets the center of mass (x,y,z) of the rigid body. Default: actual center of mass.

In query mode, this flag needs a value.

-lockCenterOfMass(-lcm) boolean createqueryedit
Locks the center of mass for the rigid body. Default: off

In query mode, this flag needs a value.

-cache(-c) boolean createqueryedit
Turns caching on (1) or off (0) for the rigid body. Default: off

In query mode, this flag needs a value.

-deleteCache(-dc) edit
Deletes the cache (if one exists) of the rigid body.
-particleCollision(-pc) boolean createqueryedit
Turns the ability for a rigid body to collide with particles on and off. The particles will exert a force on the rigid body. Default: off

In query mode, this flag needs a value.

-standInObject(-sio) string createqueryedit
Causes the simulator to use a stand in object for the simulation. The choices are none | cube | sphere. The default is none. Default: none

In query mode, this flag needs a value.

-impulse(-i) float float float createedit
Applies an impulse (instantaneous) force on a rigid body. Default: 0.0 0.0 0.0
-impulsePosition(-imp) float float float createedit
The position at which the impulse is applied. Default: the bodies center of mass.
-spinImpulse(-si) float float float createedit
Applies an spin impulse (instantaneous rotational) force on a rigid body. Default: 0.0 0.0 0.0
-solver(-slv) string createqueryedit
The name of the solver which this rigid node is to resided. If the solver does not exists then the rigid body will not be created. If the edit flag is thrown add the solver exists, the rigid body will be moved to that solver.

In query mode, this flag needs a value.

-ignore(-ig) boolean createqueryedit
Causes the rigid body to be ignored in the rigid solver. Default: off

In query mode, this flag needs a value.

-applyForceAt(-afa) string createqueryedit
Determines how forces are applied to the rigid body. The choices are centerOfMass | boundingBox | verticesOrCVs. Default: boundingBox

In query mode, this flag needs a value.

-velocity(-vel) query
Current velocity of rigid body.

In query mode, this flag needs a value.

-angularVelocity(-av) query
Current angular velocity of rigid body.

In query mode, this flag needs a value.

-force(-f) query
Current force on the rigid body.

In query mode, this flag needs a value.

-contactCount(-cc) query
returns the current contact count for the rigid body.

In query mode, this flag needs a value.

-contactPosition(-cp) query
returns all the contact position. One position for each contact will be returned.

In query mode, this flag needs a value.

-contactName(-cn) query
returns all the rigid body names which are in contact with this shape. One name for each contact will be returned.

In query mode, this flag needs a value.


Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can be used more than once in a command

Return value


new rigid body name.

Related

air, constrain, drag, gravity, newton, radial, rigidSolver

MEL examples

// Creates a rigid body with a initial velocity of 10 in the x
// direction, a bounciness of 0.5 and a static friction coefficent
// of 0.4.
//
rigidBody -n myRigidBody -active -iv 10 0 0 -b 0.5 -sf 0.4;

  

Return to Autodesk Index


Your Ad Here