softSelect

Show frames

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

Synopsis

softSelect [-compressUndo int] [-enableFalseColor int] [-softSelectColorCurve string] [-softSelectCurve string] [-softSelectDistance float] [-softSelectEnabled int] [-softSelectFalloff int] [-softSelectReset] [-softSelectUVDistance float]

softSelect is undoable, queryable, and editable.

Soft modelling is an option that allows for reflection of basic manipulator actions such as move, rotate, and scale.

Return value

None

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

Related

Flags

Long name (short name)	Argument types	Properties
-softSelectEnabled(-sse)	int
Sets soft selection based modeling on or off. When queried, returns an int indicating the current state of the option.
-softSelectDistance(-ssd)	float
Sets the falloff distance (radius) used for world and object space soft selection. When queried, returns an float indicating the current falloff distance.
-softSelectUVDistance(-sud)	float
Sets the falloff distance (radius) used for UV space soft selection. When queried, returns an float indicating the current falloff distance.
-softSelectCurve(-ssc)	string
Sets the falloff curve used to calculate selection weights for components within the falloff distance. The curve is encoded as a string of comma separated floating point values representing the falloff curve CVs. Each CV is represented by 3 successive values: an output value (the selection weight at this point), an input value (the normalised falloff distance) and a curve interpolation type. When queried, returns a string containing the encoded CVs of the current falloff curve.
-softSelectColorCurve(-scc)	string
Sets the color ramp used to display false color feedback for soft selected components in the viewport. The color curve is encoded as a string of comma separated floating point values representing the falloff curve CVs. Each CV is represented by 5 successive values: 3 RGB values (the color to use), an input value (the selection weight), and a curve interpolation type. When queried, returns a string containing the encoded CVs of the current color feedback curve.
-softSelectFalloff(-ssf)	int
Sets the falloff mode: 0 for volume based falloff; 1 for surface based falloff, and 2 for global falloff. When queried, returns an int indicating the falloff mode.
-enableFalseColor(-efc)	int
Set soft select color feedback on or off. When queried, returns an int indicating whether color feedback is currently enabled.
-compressUndo(-cu)	int
Controls how soft selection settings behave in undo: 0 means all changes undo individually; 1 means all consecutive changes undo as a group; 2 means only interactive changes undo as a group When queried, returns an int indicating the current undo behaviour.
-softSelectReset(-ssr)
Resets soft selection to its default settings.

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

// Enable soft selection
softSelect -sse 1;

// Setup global soft select with radius and curve
softSelect -sse 1 -ssd 2.0 -ssc "0,1,2,1,0,2" -ssf 2;