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)