pymel.core.general.symmetricModelling

static general.symmetricModelling(*args, **kwargs)

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. In query mode, return type is based on queried flag.

Flags:
Long name (short name) Argument Types Properties
about (a) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.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.
axis (ax) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Set the current axis to be reflected over. When queried, returns a string which is the current axis
preserveSeam (ps) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Controls whether selection or symmetry should take priority on the plane of symmetry. When queried, returns an int for the option
reset (r) bool  
   
seamFalloffCurve (sf) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.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 have multiple arguments, passed either as a tuple or a list.

seamTolerance (st) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.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

symmetry (s) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Set the symmetry option on or off When queried, returns an int for the option
tolerance (t) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Set the tolerance of reflection. When queried, returns a float of the tolerance

Derived from mel command maya.cmds.symmetricModelling

Example:

import pymel.core as pm

# What is the current reflection setting
pm.symmetricModelling(query=True, symmetry=True)
# Result: 0 #

# What is the current reflection axis
pm.symmetricModelling(query=True, axis=True)
# Result: u'x' #

# Change the space to apply reflection to (object or world)
pm.symmetricModelling(about='world')

# Change the current tolerance to 0.34
pm.symmetricModelling(tolerance=0.34)

Previous topic

pymel.core.general.stringArrayIntersector

Next topic

pymel.core.general.threadCount

Core

Core Modules

Other Modules

This Page