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

Synopsis

constrain [-barrier] [-damping float] [-directionalHinge] [-hinge] [-interpenetrate boolean] [-nail] [-name string] [-orientation float float float] [-pinConstraint] [-position float float float] [-restLength float] [-spring] [-stiffness float]

constrain is undoable, queryable, and editable.

This command constrains rigid bodies to the world or other rigid bodies.

Return value

None

In query mode, return type is based on queried flag.

Related

rigidBody, rigidSolver

Flags

barrier, damping, directionalHinge, hinge, interpenetrate, nail, name, orientation, pinConstraint, position, restLength, spring, stiffness
Long name (short name) Argument types Properties
-barrier(-br) createquery
Creates a barrier constraint. This command requires one rigid bodies.
-damping(-d) float createqueryedit
Sets the damping constant. Default value: 0.1 Range: -1000.0 to 1000.0
-directionalHinge(-dhi) createquery
Creates a directional hinge constraint. This command requires two rigid bodies. The directional hinge always maintains the initial direction of its axis.
-hinge(-hi) createquery
Creates a hinge constraint. This command requires one or two rigid bodies.
-interpenetrate(-i) boolean createqueryedit
Allows (or disallows) the rigid bodies defined in the constrain to ipenetrate.
-nail(-na) createquery
Creates a nail constraint. This command requires one rigid body.
-name(-n) string createqueryedit
Names the rigid constraint.
-orientation(-o) float float float createqueryedit
Set initial orientation of the constraint in world space. This command is only valid with hinge and barrier constraints Default value: 0.0 0.0 0.0
-pinConstraint(-pin) createquery
Creates a pin constraint. This command requires two rigid bodies.
-position(-p) float float float createqueryedit
Set initial position of the constraint in world space. Default value: 0.0 0.0 0.0 for uni-constraints, midpoint of bodies for deul constraint.
-restLength(-rl) float createqueryedit
Sets the rest length. Default value: 1.0
-spring(-s) createquery
Creates a spring constraint. This command requires one or two rigidies.
-stiffness(-st) float createqueryedit
Sets the springs stiffness constant. Default value: 5.0
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.

MEL examples

  // "Nail" a rigid body at position <<0.0, 2.5, 0.0>>
  //
  constrain -nail -p 0 2.5 0 rigidBody1;

  // "Pin" two rigid bodies together at the position <<0.0, 2.5, 0.0>>.
  //
  constrain -pin -n pin -p 0 2.5 0 rigidBody1 rigidBody2;

  // "Hinge" a rigid body at the position <<0.0, 2.5, 0.0>>.
  //
  constrain -hinge -p 0 2.5 0 rigidBody1;

  // Create a barrier for a rigid body which will not allow the rigid body
// to fall below (in y by default) the plane defined by the
// barrier point <<0.0, 2.5, 0.0>>.
  //
  constrain -barrier -p 0 2.5 0 rigidBody1;

  // Add a "Spring" to a rigid body at the position <<0.0, 2.5, 0.0>>
  // connected on the rigid body at point <<0, 0, 0>>
  //
  constrain -spring -name spring -p 0 2.5 0 -rl 1.0 rigidBody1;