Go to: Synopsis. Return value. Related. Flags. MEL examples.

Synopsis

symmetricModelling [-about string] [-allowPartial boolean] [-axis string] [-preserveSeam int] [-seamFalloffCurve string] [-seamTolerance float] [-symmetry int] [-tolerance float] [-topoSymmetry boolean]

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.

Return value

None

In query mode, return type is based on queried flag.

Related

displayAffected, displayColor, displayCull, displayLevelOfDetail, displayPref, displayRGBColor, displaySmoothness, displayStats, displaySurface, hide, refresh, showHidden, toggle

Flags

about, allowPartial, axis, preserveSeam, seamFalloffCurve, seamTolerance, symmetry, tolerance, topoSymmetry
Long name (short name) Argument types Properties
-about(-a) string createqueryedit
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 createqueryedit
Specifies whether partial symmetry should be allowed when enabling topological symmetry.
-axis(-ax) string createqueryedit
Set the current axis to be reflected over. When queried, returns a string which is the current axis.
-preserveSeam(-ps) int createqueryedit
Controls whether selection or symmetry should take priority on the plane of symmetry. When queried, returns an int for the option.
-seamFalloffCurve(-sf) string createqueryedit
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 createqueryedit
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 createqueryedit
Set the symmetry option on or off. When queried, returns an int for the option.
-tolerance(-t) float createqueryedit
Set the tolerance of reflection. When queried, returns a float of the tolerance.
-topoSymmetry(-ts) boolean createqueryedit
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 be used more than once in a command.

MEL examples

// What is the current reflection setting
symmetricModelling -query -symmetry;

// What is the current reflection axis
symmetricModelling -query -axis;

// Change the space to apply reflection to (object or world)
symmetricModelling -about "world";

// Change the current tolerance to 0.34
symmetricModelling -tolerance 0.34;