Go to: Synopsis. Return value. Related. Flags. Python examples.
sculptTarget(
int
, [inbetweenWeight=float], [regenerate=boolean], [snapshot=int], [target=float])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
sculptTarget is undoable, NOT queryable, and editable.
This command is used to specify the blend shape target to be
modified by the sculpting tools and transform manipulators.
None
blendShape
inbetweenWeight, regenerate, snapshot, target
Long name (short name) |
Argument types |
Properties |
|
inbetweenWeight(ibw)
|
float
|
|
|
Specifies the in between target weight of the blend shape node that will be
made editable by the sculpting and transform tools.
|
|
regenerate(r)
|
boolean
|
|
|
When this flag is specified a new shape is created for the specified
blend shape target, if the shape does not already exist.
The name of the new shape is returned.
|
|
snapshot(s)
|
int
|
|
|
This flag should only be used internally to add in-between target.
When this flag is specified a snapshot of the shape will be
taken for the specified in-between target when it does not
exist yet.
This flag specifies the base shape index and must be used with the
-target and -inbetweenWeight flags, which specify the in-between
target.
|
|
target(t)
|
float
|
|
|
Specifies the target index of the blend shape node that will be
made editable by the sculpting and transform tools.
|
|
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
# To set the current editable target to target 3
cmds.sculptTarget( 'blendShape1', e=True, t=3 )
# To set the current editable target to none
cmds.sculptTarget( 'blendShape1', e=True, t=-1 )