pymel.core.general.symmetricModelling

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
	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
	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
reset (r)		bool
seamFalloffCurve (sf)		unicode
	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 commandFlag can have multiple arguments, passed either as a tuple or a list.
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

Derived from mel command maya.cmds.symmetricModelling

Example:

import pymel.core as pm

import maya.cmds as cmds

# 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)