Go to: Synopsis. Return value. Related. Flags. MEL examples.
skinPercent [-ignoreBelow float] [-normalize boolean] [-pruneWeights float] [-relative boolean] [-resetToDefault] [-transform string] [-transformValue string float] [-value]
[object] [selectionList]
skinPercent is undoable, queryable, and NOT editable.
This command edits and queries the weight values on members of a
skinCluster node, given as the first argument. If no object components
are explicitly mentioned in the command line, the current selection
list is used.
Note that setting multiple weights in a single invocation of this
command is far more efficient than calling it once per weighted
vertex.
None
In query mode, return type is based on queried flag.
copySkinWeights, skinCluster
ignoreBelow, normalize, pruneWeights, relative, resetToDefault, transform, transformValue, 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.
|
// Create a joint chain and a polygonal plane and bind the plane as skin
//
select -d;
joint -p -3 0 -12;
joint -p -3 0 -5;
joint -p 1 0 5.5;
joint -p 6 0 10;
polyPlane -w 20.0 -h 20.0 -sx 25 -sy 25;
skinCluster joint1 pPlane1;
// For cv[100], set the weight wrt joint1 to 0.2, the weight
// wrt joint3 to 0.8 and adjust the remaining weights to keep
// the overall weight normalized (i.e. set all other joints to zero,
// since the weights we are setting sum to 1.0)
//
skinPercent -transformValue joint1 0.2 -transformValue
joint3 0.8 skinCluster1 pPlane1.cv[100];
// Get the weight values of all the influences for this point
//
skinPercent -query -value skinCluster1 pPlane1.cv[100];
// Get the weight values that are above 0.5
//
skinPercent -ignoreBelow 0.5 -query -value skinCluster1 pPlane1.cv[100];
// Get the weight values that are above 0.5
//
skinPercent -ignoreBelow 0.5 -query -value skinCluster1 pPlane1.cv[100];
// Get the weight of cv[100] corresponding to joint3
//
skinPercent -transform joint3 -query skinCluster1 pPlane1.cv[100];
// Normalize the existing weights for cv[100]
//
skinPercent -normalize on skinCluster1 pPlane1.cv[100];
// Reset the weights for cv[100] to their default values
//
skinPercent -resetToDefault skinCluster1 pPlane1.cv[100];
// Zero all the weights that are below 0.1
//
skinPercent -pruneWeights 0.1 pPlane1 skinCluster1;
// Zero all the weights
//
skinPercent -pruneWeights 100 -normalize off pPlane1 skinCluster1;
// Assign weights to a large number of vertices, several at a time to
// reduce the number of calls to the skinPercent command.
//
for ( $i = 0; $i <= 675; $i +=10 ) {
skinPercent -transformValue joint1 0.5
-transformValue joint2 0.5 skinCluster1 pPlane1.vtx[$i] pPlane1.vtx[$i+1] pPlane1.vtx[$i+2]
pPlane1.vtx[$i+3] pPlane1.vtx[$i+4] pPlane1.vtx[$i+5]
pPlane1.vtx[$i+6] pPlane1.vtx[$i+7] pPlane1.vtx[$i+8]
pPlane1.vtx[$i+9];
}