Go to: Synopsis. Return value. Related. Flags. MEL 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]

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 how many vertices to remove during reduction as a percentage of the original mesh. This flag only applies if the termination flag is set to its default of 0.
C: Default is 0. 100 will remove every possible vertex, 0 will remove none.
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, reduction will try to retain geometric borders and the border of the selection. Note that a UV border is also a geometric border.
C: Default is false.
Q: When queried, this flag returns a boolean.
-keepMapBorder(-kmb) boolean createqueryedit
If true, reduction will try to retain UV borders. A UV border is present if the faces on either side of the edge do not share UV Ids. Note that a UV border is also a geometric border.
C: Default is false.
Q: When queried, this flag returns a boolean.
-keepHardEdge(-khe) boolean createqueryedit
If true, reduction will try to retain hard edges.
C: Default is false.
Q: When queried, this flag returns a boolean.
-keepOriginalVertices(-kev) boolean createqueryedit
If true, vertices will try to retain their original positions and will not be repositioned for optimal shape. This flag is not currently used in the Softimage algorithm: vertices always retain their exact original positions (though the Ids will change).
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 createqueryedit
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 be used more than once in a command.

MEL examples

polySphere -n plg;
polyReduce -p 35 plg.f[0:399];