Go to: Synopsis. Return value. Related.
Flags. Python
examples.
symmetricModelling([about=string], [axis=string], [preserveSeam=int], [seamFalloffCurve=string],
[seamTolerance=float],
[symmetry=int], [tolerance=float])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
symmetricModelling is undoable, queryable, and editable.
This command allows you to change the symmetric modelling options.
Symmetric modelling is an option that allows for reflection of
basic manipulator actions such as move, rotate, and scale.
None
In query mode, return type is based on queried flag.
displayAffected, displayColor, displayCull, displayLevelOfDetail, displayPref, displayRGBColor, displaySmoothness, displayStats, displaySurface, hide, refresh, showHidden, toggle
about, axis,
preserveSeam, seamFalloffCurve, seamTolerance, symmetry, tolerance
| Long name (short name) |
Argument types |
Properties |
symmetry(s) |
int |
   |
|
Set the symmetry option on or off When queried, returns an int
for the option |
|
axis(ax) |
string |
|
|
Set the current axis to be reflected over. When queried,
returns a string which is the current axis |
|
about(a) |
string |
|
|
Set the space in which symmetry should be calculated (object or
world). When queried, returns a string which is the current space
being used. |
|
tolerance(t) |
float |
|
|
Set the tolerance of reflection. When queried, returns a float
of the tolerance |
|
preserveSeam(ps) |
int |
|
|
Controls whether selection or symmetry should take priority on
the plane of symmetry. When queried, returns an int for the
option |
|
seamTolerance(st) |
float |
|
|
Set the seam tolerance used for reflection. When preserveSeam
is enabled, this tolerance controls the width of the enforced seam.
When queried, returns a float of the seamTolerance |
|
seamFalloffCurve(sf) |
string |
|
|
Set the seam's falloff curve, used to control the seam strength
within the seam tolerance. The string is a comma separated list of
sets of 3 values for each curve point. When queried, returns a
string which is the current space being used. |
|
| 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
# What is the current reflection setting
cmds.symmetricModelling(query=True, symmetry=True)
# What is the current reflection axis
cmds.symmetricModelling(query=True, axis=True)
# Change the space to apply reflection to (object or world)
cmds.symmetricModelling(about='world')
# Change the current tolerance to 0.34
cmds.symmetricModelling(tolerance=0.34)