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
|
![create create](../gfx/create.gif) ![query query](../gfx/query.gif)
|
|
Set the symmetry option on or off
When queried, returns an int for the option
|
|
axis(ax)
|
string
|
![create create](../gfx/create.gif) ![query query](../gfx/query.gif)
|
|
Set the current axis to be reflected over.
When queried, returns a string which is the current axis
|
|
about(a)
|
string
|
![create create](../gfx/create.gif) ![query query](../gfx/query.gif)
|
|
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
|
![create create](../gfx/create.gif) ![query query](../gfx/query.gif)
|
|
Set the tolerance of reflection.
When queried, returns a float of the tolerance
|
|
preserveSeam(ps)
|
int
|
![create create](../gfx/create.gif) ![query query](../gfx/query.gif)
|
|
Controls whether selection or symmetry should take priority on the plane
of symmetry.
When queried, returns an int for the option
|
|
seamTolerance(st)
|
float
|
![create create](../gfx/create.gif) ![query query](../gfx/query.gif)
|
|
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
|
![create create](../gfx/create.gif) ![query query](../gfx/query.gif)
|
|
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)