In query mode, return type is based on queried flag.
Long name (short name) |
Argument types |
Properties |
-value(-v) |
|
|
|
Returns an array of doubles corresponding to the joint weights
for the selected object component. |
|
-transform(-t) |
string |
|
|
If used after the -query flag (without an argument) the command
returns an array of strings corresponding to the names of the
transforms influencing the selected object components. If used
before the -query flag (with a transform name), the command returns
the weight of the selected object component corresponding to the
given transform. The command will return an average weight if
several components have been selected.
In query mode, this flag can accept a value.
|
|
-transformValue(-tv) |
string float |
|
|
Accepts a pair consisting of a transform name and a value and
assigns that value as the weight of the selected object components
corresponding to the given transform. |
|
-relative(-r) |
boolean |
|
|
Used with -transformValue to specify a relative setting of
values. If -relative is true, the value passed to -tv is added to
the previous value. Otherwise, it replaces the previous value. |
|
-ignoreBelow(-ib) |
float |
|
|
Limits the output of the -value and -transform queries to the
entries whose weight values are over the specified limit. This flag
has to be used before the -query flag.
In query mode, this flag needs a value.
|
|
-normalize(-nrm) |
boolean |
|
|
If set, the weights not assigned by the -transformValue flag
are normalized so that the sum of the all weights for the selected
object component add up to 1. The default is on. NOTE: The
skinCluster has a normalizeWeights attribute which when set to OFF
overrides this attribute! If the skinCluster.normalizeWeights
attribute is OFF, you must set it to Interactive in order to
normalize weights using the skinPercent command. |
|
-zeroRemainingInfluences(
-zri) |
boolean |
|
|
If set, the weights not assigned by the -transformValue flag
are set to 0. The default is off. |
|
-resetToDefault(-rtd) |
|
|
|
Sets the weights of the selected components to their default
values, overwriting any custom weights. |
|
-pruneWeights(-prw) |
float |
|
|
Sets to zero any weight smaller than the given value for all
the selected components. To use this command to set all the weights
to zero, you must turn the -normalize flag "off" or the skinCluster
node will normalize the weights to sum to one after pruning them.
Weights for influences with a true value on their "Hold Weights"
attribute will not be pruned. |
|