bindSkin is undoable, queryable, and editable.
This command binds the currently selected objects to the
currently selected skeletons. Shapes which can be bound are:
meshes, nurbs curves, nurbs surfaces, lattices, subdivision
surfaces, and API shapes. Multiple shapes and multiple skeletons can be
bound at once by selecting them or specifying them on the command
line. Selection order is not important.In query mode, return type is based on queried flag.
Long name (short name) |
Argument types |
Properties |
-toSkeleton(-ts)
|
|
|
|
objects will be bound to the selected skeletons. The toSkeleton, toAll
and toSelectedBones flags are mutually exclusive. The toSkeleton flag is the default.
|
|
-toSelectedBones(-tsb)
|
|
|
|
objects will be bound to the selected bones only.
|
|
-toAll(-ta)
|
|
|
|
objects will be bound to the entire selected skeletons. Even bones with zero influence
will be bound, whereas the toSkeleton will only bind non-zero influences.
|
|
-byClosestPoint(-bcp)
|
|
|
|
bind each point in the object to the segment closest to the point.
The byClosestPoint and byPartition flags are mutually
exclusive. The byClosestPoint flag is the default.
|
|
-byPartition(-bp)
|
|
|
|
bind each group in the partition to the segment
closest to the group's centroid. A partition must be specified
with the -p/-partition flag
|
|
-partition(-p)
|
string
|
|
|
Specify a partition to bind by. This is only valid when
used with the -bp/-byPartition flag.
|
|
-unbind(-ub)
|
|
|
|
unbind the selected objects. They will no longer move with
the skeleton. Any bindSkin history that is no longer used
will be deleted.
|
|
-unbindKeepHistory(-ubk)
|
|
|
|
unbind the selected objects. They will no longer move with
the skeleton. However, existing weights on the skin
will be kept for use the next time the skin is bound. This option
is appropriate if you want to modify the skeleton without losing
the weighting information on the skin.
|
|
-unlock(-ul)
|
|
|
|
unlock the selected objects. Since bindSkin will no longer give
normal results if bound objects are moved away from the skeleton,
bindSkin locks translate, rotate and scale. This command unlocks
the selected objects translate, rotate and scale.
|
|
-delete(-d)
|
|
|
|
Detach the skin on the selected skeletons and remove all bind-
related construction history.
|
|
-enable(-en)
|
boolean
|
|
|
Enable or disable a bind that has been disabled on the selected
skeletons.
To enable the bind on selected bones only, select the bones and
use the -tsb flag with the -en flag. This flag is used when you
want to temporarily disable the bind without losing the set
information or the weight information of the skinning, for example
if you want to modify the bindPose.
|
|
-doNotDescend(-dnd)
|
|
|
|
Do not descend to shapes that are parented below the selected
object(s).
Bind only the selected objects.
|
|
-colorJoints(-cj)
|
|
|
|
In bind mode, this flag assigns colors to the joints based
on the colors assigned to the joint's skin set.
In delete and unlock mode, this flag removes the colors from
joints that are no longer bound as skin.
In disable and unbindKeepHistory mode, this flag does nothing.
|
|
-name(-n)
|
string
|
|
|