Go to: Synopsis. Return value. Related. Flags. Python examples.
symmetricModelling([about=string], [allowPartial=boolean], [axis=string], [preserveSeam=int], [seamFalloffCurve=string], [seamTolerance=float], [symmetry=int], [tolerance=float], [topoSymmetry=boolean])
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, allowPartial, axis, preserveSeam, seamFalloffCurve, seamTolerance, symmetry, tolerance, topoSymmetry
| Long name (short name) |
Argument types |
Properties |
|
about(a)
|
string
|
  
|
|
Set the space in which symmetry should be calculated (object or world or topo).
When queried, returns a string which is the current space being used.
|
|
allowPartial(ap)
|
boolean
|
|
|
Specifies whether partial symmetry should be allowed when enabling topological symmetry.
|
|
axis(ax)
|
string
|
|
|
Set the current axis to be reflected over.
When queried, returns a string which is the current axis.
|
|
preserveSeam(ps)
|
int
|
|
|
Controls whether selection or symmetry should take priority on the plane
of symmetry.
When queried, returns an int for the option.
|
|
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.
|
|
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.
|
|
symmetry(s)
|
int
|
|
|
Set the symmetry option on or off.
When queried, returns an int for the option.
|
|
tolerance(t)
|
float
|
|
|
Set the tolerance of reflection.
When queried, returns a float of the tolerance.
|
|
topoSymmetry(ts)
|
boolean
|
|
|
Enable/disable topological symmetry.
When enabled, the supplied component/active list will be used to define the topological symmetry seam.
When queried, returns the name of the active topological symmetry object.
|
|
|
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)