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

Synopsis

polyReduce([border=float], [caching=boolean], [constructionHistory=boolean], [detail=float], [keepBorder=boolean], [keepHardEdge=boolean], [keepMapBorder=boolean], [keepOriginalVertices=boolean], [line=float], [name=string], [nodeState=int], [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.

Return value

stringThe node name.

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

Related

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

Flags

border, caching, constructionHistory, detail, keepBorder, keepHardEdge, keepMapBorder, keepOriginalVertices, line, name, nodeState, 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.
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.
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.
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.
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.
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.
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.
keepOriginalVertices(kev) boolean createqueryedit
If true, vertices will retain their original positions and will not be repositioned for optimal shape
C: Default is false.
Q: When queried, this flag returns a boolean.
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.
Common flags
name(n) string create
Give a name to the resulting node.
constructionHistory(ch) boolean createquery
Turn the construction history on or off (where applicable). If construction history is on then the corresponding node will be inserted into the history chain for the mesh. If construction history is off then the operation will be performed directly on the object.
Note: If the object already has construction history then this flag is ignored and the node will always be inserted into the history chain.
caching(cch) boolean createedit
Toggle caching for all attributes so that no recomputation is needed
nodeState(nds) int
Defines how to evaluate the node.
  • 0: Normal
  • 1: PassThrough
  • 2: Blocking
  • 3: Internally disabled. Will return to Normal state when enabled
  • 4: Internally disabled. Will return to PassThrough state when enabled
  • 5: Internally disabled. Will return to Blocking state when enabled
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.

Python examples

import maya.cmds as cmds

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