Go to: Synopsis. Return value. Keywords. Related. Flags. Python examples.
geomBind([bindMethod=uint], [falloff=float], [geodesicVoxelParams=[uint, boolean]], [maxInfluences=int])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
geomBind is undoable, queryable, and editable.
This command is used to compute weights using geodesic voxel binding algorithm.
It works by setting the right weights values on an already-existing skinCluster
node.
Since this command uses GPU acceleration, it is not supported on headless
versions of Maya, i.e. batch mode.
None
In query mode, return type is based on queried flag.
skinCluster
skinCluster
bindMethod, falloff, geodesicVoxelParams, maxInfluences
| Long name (short name) |
Argument types |
Properties |
bindMethod(bm)
|
uint
|
|
|
Specifies which bind algorithm to use. By default, Geodesic Voxel will be used.
Available algorithms are:
3 - Geodesic Voxel
|
|
falloff(fo)
|
float
|
 
|
|
Falloff controlling the bind stiffness. Valid values range from [0..1].
|
|
geodesicVoxelParams(gvp)
|
[uint, boolean]
|
|
|
Specifies the geodesic voxel binding parameters. This flag is composed of three
parameters:
0 - Maximum voxel grid resolution which must be a power of two. (ie. 64, 128, 256, etc. )
1 - Performs a post voxel state validation when enabled.
Default values are 256 true.
|
|
maxInfluences(mi)
|
int
|
|
|
Specifies the maximum influences a vertex can have. By default, all influences
are used (-1).
|
|
|
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
# Compute geodesic voxel weights for skinCluster1 and skinCluster2. This
# command will create a geomBind node connected to the two skinClusters
# and their common bind pose. The geomBind node will maintain the
# geodesic voxel binding parameters used (ie: falloff, resolution, etc.)
#
cmds.select( 'skinCluster1', r=True )
cmds.select( 'skinCluster2', add=True )
cmds.geomBind( bm=3, fo=0, mi=5 )
# Create a simple scene that use geodesic voxel weights for skin binding.
cmds.file( f=True, new=True )
cmds.polyCylinder( r=1, h=10, sx=20, sy=20, sz=5 )
cmds.select( d=True )
cmds.joint( p=[0, -4, 0] )
cmds.joint( p=[0, 0, 0] )
cmds.joint( p=[0, 4, 0] )
cmds.select( 'joint1', 'joint2', 'joint3', 'pCylinder1' )
cmds.skinCluster( bindMethod=3 )
cmds.geomBind( 'skinCluster1', bindMethod=3 )