Go to: Synopsis. Return value. Related.
Flags. Python
examples.
connectDynamic( [objects] , [collisions=string], [delete=boolean], [emitters=string], [fields=string])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
connectDynamic is undoable, NOT queryable, and NOT
editable.
Dynamic connection specifies that the force fields, emitters, or
collisions of an object affect another dynamic object. The dynamic
object that is connected to a field, emitter, or collision object
is influenced by those fields, emitters and collision objects.
Connections are made to individual fields, emitters, collisions.
So, if an object owns several fields, if the user wants some of the
fields to affect an object, s/he can specify each field with a "-f"
flag; but if the user wants to connect all the fields owned by an
object, s/he can specify the object name with the "-f" flag. The
same is true for emitters and collisions. Different connection
types (i.e., for fields vs. emitters) between the same pair of
objects are logically independent. In other words, an object can be
influenced by another object's fields without being influenced by
its emitters or collisions. Each connected object must be a dynamic
object. The object connected to can be any object that owns fields,
emitters, etc.; it need not be dynamic. Objects that can own
influences are particles, geometry objects (nurbs and polys) and
lattices. You can specify either the shape name or the transform
name of the object to be influenced.
air, drag, emitter, gravity,
newton, particle, radial
collisions, delete, emitters,
fields
| Long name (short name) |
Argument types |
Properties |
fields(f) |
string |
  |
|
Connects each object to the fields of the given object. |
|
emitters(em) |
string |
|
|
Connects each object to the emitters of the given object. |
|
collisions(c) |
string |
|
|
Connects each object to the collision models of the given
object. |
|
delete(d) |
boolean |
|
|
Deletes existing connections. |
|
| 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 have multiple arguments, passed
either as a tuple or a list. |
import maya.cmds as cmds
cmds.connectDynamic( 'Book', c='Floor' )
# Connects the dynamic object "Book" to the collision model of the
# "Floor". This means that the book will collide with and bounce off of
# the floor.
cmds.connectDynamic( 'Moon', 'Spaceship', f='Moon' )
# Connects dynamic object "Spaceship" to the all fields and emitters
# owned by "Moon".
cmds.connectDynamic( 'Spaceship', f='newtonField1' )
# Connects dynamic object "Spaceship" to "newtonField1" owned by "Moon".
cmds.connectDynamic( 'Moon', f='newtonField1' )
# If the selection list consists of "Spaceship", connects dynamic object
# "Spaceship" to "newtonField1" and all emitters owned by "Moon".
cmds.connectDynamic( 'Spaceship', d=True, f='Moon' )
# Deletes the field connection between all the fields owned by "Moon" and
# "Spaceship". Note that the command establishing the connection need not
# be in the undo queue.
cmds.connectDynamic( 'Spaceship', d=True, f='newtonField1' )
# Deletes the field connection between "newtonField1" owned by "Moon" and
# "Spaceship".