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

Synopsis

polyReduce([border=float], [constructionHistory=boolean], [detail=float], [keepBorder=boolean], [keepHardEdge=boolean], [keepMapBorder=boolean], [line=float], [name=string], [percentage=float], [replaceOriginal=boolean])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

polyReduce is undoable, queryable, and editable.

Reduce a polygonal object.

Flags

border, constructionHistory, detail, keepBorder, keepHardEdge, keepMapBorder, line, name, percentage, replaceOriginal
Long name (short name) [argument types] Properties
percentage(p) float createqueryedit
This flag specifies what percentage of vertices have to be removed from the original object.
C: Default is 100. 0 will remove as many vertices as possible.
Q: When queried, this flag returns a float.

In query mode, this flag needs a value.
border(b) float createqueryedit
This flag specifies the degree to which vertices along the geometric border are to be preserved. It has effect only if the -keepBorder flag is set to false. A value of 1.0 results in no special effort being made to preserve any border vertices. A value of 0 results in all border vertices being preserved.
C: Default is .5, range is [0,1].
Q: When queried, this flag returns a float.

In query mode, this flag needs a value.
line(l) float createqueryedit
This flag specifies the degree to which "feature lines" (edges joining faces with sharp geometric angles between them) are to be preserved. A value of 1.0 results in no special effort being made to preserve such features. A value of 0 results in the greatest possible effort to preserve such features.
C: Default is .5, range is [0,1].
Q: When queried, this flag returns a float.

In query mode, this flag needs a value.
detail(d) float createqueryedit
This flag specifies how much of the reduced geometry should be dedicated to preserving regions of high curvature. A value of 1.0 will result in relatively equal distribution of vertices and faces regardless of curvature. A value of 0 will concentrate the detail in areas of high curvature. This value is ignored when -keepHardEdge is set to false.
C: Default is .5, range is [0,1].
Q: When queried, this flag returns a float.

In query mode, this flag needs a value.
keepBorder(kb) boolean createqueryedit
If true, vertices on border will not be modified.
C: Default is false.
Q: When queried, this flag returns a boolean.

In query mode, this flag needs a value.
keepMapBorder(kmb) boolean createqueryedit
If true, vertices on UV border will not be modified.
C: Default is false.
Q: When queried, this flag returns a boolean.

In query mode, this flag needs a value.
keepHardEdge(khe) boolean createqueryedit
If true, vertices on hard edges will not be modified.
C: Default is false.
Q: When queried, this flag returns a boolean.

In query mode, this flag needs a value.
replaceOriginal(rpo) boolean create
Create "in place" (i.e., replace) (not available in all commands). NOTE: This flag is intended for use by the "Reduce" menu item. If 'polyReduce -rpo 0' is executed from the command line, Shader information will not be copied from the original mesh to the result.
name(n) string create
Name the resulting object.
constructionHistory(ch) boolean createquery
Turn the construction history on or off (where applicable).
Q: When queried, this flag returns an int.

In query mode, this flag needs a value.
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.

Return value


string The node name.

Related

polyCloseBorder, polyCollapseEdge, polyCollapseFacet, polyDelEdge, polyDelFacet, polyDelVertex, polyMergeEdge, polyMergeFacet, polyMergeVertex, polyQuad, polySewEdge

Python examples

import maya.cmds as cmds

cmds.polySphere( n='plg' )
cmds.polyReduce( 'plg.f[0:399]', p=35 )