pymel.core.animation.flow

static animation.flow(*args, **kwargs)

The flow command creates a deformation lattice to `bend’ the object that is animated along a curve of a motion path animation. The motion path animation has to have the follow option set to be on.

Flags:
Long name (short name) Argument Types Properties
divisions (dv) int, int, int ../../../_images/query.gif
 
This flag specifies the number of lattice slices in x,y,z.The default values are 2 5 2.When queried, it returns the TuInt32 TuInt32 TuInt32
localCompute (lc) bool ../../../_images/query.gif
 

This flag specifies whether or not to have local control over the object deformation.Default value: is on when the lattice is around the curve, and is off when the lattice is around the object. When queried, it returns a boolean

localDivisions (ld) int, int, int ../../../_images/query.gif
 
This flag specifies the extent of the region of effect.Default values are 2 2 2.When queried, it returns the TuInt32 TuInt32 TuInt32
objectCentered (oc) bool ../../../_images/query.gif
 

This flag specifies whether to create the lattice around the selected object at its center, or to create the lattice around the curve.Default value is true.When queried, it returns a booleanFlag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.flow

Example:

import pymel.core as pm

# Create a simple motion path animation

# create a path, e,g, a curve
path = pm.curve(d=3,p=[(-10, 0, 0),(-6, 0, 10),(-3, 0, -10),(10, 0, 0)],k=[0, 0, 0, 1, 1, 1])

# create an object, e.g. a sphere
object = pm.sphere()
pm.scale( 0.5, 2.0, 0.2 )

# animate the object using a motion path with follow on for 30 frames
pm.pathAnimation( object[0], f=1, stu=0, etu=30, c=path )
# Result: u'motionPath1' #

# select only the animated object
pm.select( object[0], r=True )

# Create flow deformation on the selected object with default values:
pm.flow()
# Result: [nt.Flow(u'flow1'), nt.Ffd(u'ffd1'), nt.Transform(u'ffd1Lattice'), nt.Transform(u'ffd1Base')] #

# Create flow deformation on the selected object with
# the lattice around the path, and lattice division of 3,20,2:
pm.flow( oc=False, dv=(3, 20, 2) )

# Create flow deformation on the selected object with
# lattice subdivisions 4, 7, and 3:

pm.flow( dv=(4, 7, 3) )

# When the object is not currently selected, the name of the object
# has to be specified in the command line (note: $object[0] has to
# have a motion path animation):

pm.flow( object[0], dv=(4, 7, 3) )

Previous topic

pymel.core.animation.flexor

Next topic

pymel.core.animation.geometryConstraint

Core

Core Modules

Other Modules

This Page