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 or topo). When queried, returns a string which is the current space being used.
allowPartial / ap		bool
	Specifies whether partial symmetry should be allowed when enabling topological symmetry.
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.
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		bool
	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 have multiple arguments, passed either as a tuple or a list.

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)