Go to: Synopsis. Return value. Keywords. Flags. MEL examples.

Synopsis

combinationShape [-addDriver] [-allDrivers] [-blendShape string] [-combinationTargetIndex int] [-combinationTargetName string] [-combineMethod int] [-driverTargetIndex int] [-driverTargetName string] [-exist] [-removeDriver]

combinationShape is undoable, queryable, and editable.

Command to create or edit drive relationship of blend shape targets

Return value

IntIn edit mode, return the newly created combination shape node name.

In query mode, return type is based on queried flag.

Keywords

combination, target

Flags

addDriver, allDrivers, blendShape, combinationTargetIndex, combinationTargetName, combineMethod, driverTargetIndex, driverTargetName, exist, removeDriver
Long name (short name) Argument types Properties
-addDriver(-add)
Add drivers to the combination shape
-allDrivers(-ald) query
All drivers of the combination shape
-blendShape(-bs) string create
Associated blend shape node of the combination shape

In query mode, this flag can accept a value.
-combinationTargetIndex(-cti) int create
Driven blend shape target index of the combination shape

In query mode, this flag can accept a value.
-combinationTargetName(-ctn) string create
Driven blend shape target name of the combination shape

In query mode, this flag can accept a value.
-combineMethod(-cm) int createqueryedit
Combine method of the combination shape:
  • 0 : Multiplication
  • 1 : Lowest Weighting
  • 2 : Lowest Weighting (Smooth)
-driverTargetIndex(-dti) int createmultiuse
Driver blend shape target index of the combination shape
-driverTargetName(-dtn) string createmultiuse
Driver blend shape target name of the combination shape
-exist(-ex) query
If the combination shape exist
-removeDriver(-rmd)
Remove drivers from the combination shape
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.

MEL examples

// Set a blend shape target as combination target, and another two blend shape targets as drivers, using target indexes.
//
combinationShape -blendShape "blendShape1" -combinationTargetIndex 1 -driverTargetIndex 2 -driverTargetIndex 3;

// Add two blend shape targets as drivers to a blend shape combination target, using target names.
//
combinationShape -edit -blendShape "blendShape1" -combinationTargetName "TargetA" -addDriver -driverTargetName "TargetB" -driverTargetName "TargetC";

// Remove two blend shape targets from drivers of a blend shape combination target.
//
combinationShape -edit -blendShape "blendShape1" -combinationTargetIndex 1 -removeDriver -driverTargetName "TargetB" -driverTargetIndex 2;

// Change combine method of a blend shape combination target
//
combinationShape -edit -blendShape "blendShape1" -combinationTargetIndex 1 -combineMethod 2;

// Remove all drivers of a blend shape combination target.
//
combinationShape -edit -blendShape "blendShape1" -combinationTargetIndex 1 -removeDriver -allDrivers;

// Query all drivers of a blend shape combination target.
//
combinationShape -query -blendShape "blendShape1" -combinationTargetIndex 1 -allDrivers;