pymel.core.general.softSelect

softSelect(*args, **kwargs)

This command allows you to change the soft modelling options. Soft modelling is an option that allows for reflection of basic manipulator actions such as move, rotate, and scale. In query mode, return type is based on queried flag.

Flags:

Long Name / Short Name Argument Types Properties
compressUndo / cu int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Controls how soft selection settings behave in undo: 0 means all changes undo individually1 means all consecutive changes undo as a group2 means only interactive changes undo as a groupWhen queried, returns an int indicating the current undo behaviour.
enableFalseColor / efc int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Set soft select color feedback on or off. When queried, returns an int indicating whether color feedback is currently enabled.
softSelectColorCurve / scc unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  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.
softSelectCurve / ssc unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  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.
softSelectDistance / ssd float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Sets the falloff distance (radius) used for world and object space soft selection. When queried, returns a float indicating the current falloff distance.
softSelectEnabled / sse int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Sets soft selection based modeling on or off. When queried, returns an int indicating the current state of the option.
softSelectFalloff / ssf int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Sets the falloff mode: 0 for volume based falloff1 for surface based falloff2 for global falloffWhen queried, returns an int indicating the falloff mode.
softSelectReset / ssr bool ../../../_images/create.gif ../../../_images/edit.gif
  Resets soft selection to its default settings.
softSelectUVDistance / sud float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Sets the falloff distance (radius) used for UV space soft selection. When queried, returns a float indicating the current falloff distance. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.softSelect

Example:

import pymel.core as pm

# Enable soft selection
pm.softSelect(sse=1)

# Setup global soft select with radius and curve
pm.softSelect(sse=1,ssd=2.0,ssc='0,1,2,1,0,2',ssf=2)