Go to: Related nodes. Attributes.

Reduce a poly object using a vertex deletion algorithm.

Node name Parents MFn type Compatible function sets
polyReduce polyModifier kPolyReduce kBase
kNamedObject
kDependencyNode
kMidModifier
kPolyReduce

Related nodes

polyTweak, polyTweakUV, polyMapCut, polyMapDel, polyMapSew, polyNormal, polyMoveUV, polyMoveFacetUV, polyFlipEdge, polySmoothFace, polySmooth, polyDelFacet, polyDelVertex, polyMergeFace, polySplit, polyAppendVertex, polySubdFace, polyCollapseF, polyCloseBorder, polyAppend, polyCollapseEdge, polyTriangulate, polyDelEdge, polyMergeEdge, polyColorPerVertex, polyNormalPerVertex, deleteUVSet, polySeparate

Attributes (18)

border, cachingReduce, colorWeights, compactness, detail, geomWeights, keepBorder, keepHardEdge, keepMapBorder, keepOriginalVertices, keepQuadsWeight, line, percentage, triangulate, uvWeights, vertexWeights, weightCoefficient, weights

Long name (short name) Type Default Flags
percentage (p) double 0 outputinputconnectablestorablekeyable
Percentage of triangles to be removed.
compactness (com) double 0.0 outputinputconnectablestorablekeyable
Tolerance for compactness for the generated triangles A value of 0 will accept all triangles during decimation A value close to 0 will attempt to eliminate triangles that have collinear edges (zero area triangles) A value closer to 1 will attempt to eliminate triangles that are not strictly equilateral (of equal lengths) The closer to 1.0, the more expensive the computation
geomWeights (gwt) double 1 outputinputconnectablestorable
How much consideration vertex positions are given in the reduction algorithm. A higher weight means the reduction will try harder to preserve geometry.
uvWeights (uwt) double 0 outputinputconnectablestorablekeyable
How much consideration uv positions are given in the reduction algorithm. A higher weight means the reduction will try harder to preserve uv positions.
colorWeights (cwt) double 0 outputinputconnectablestorablekeyable
How much consideration vertex color is given in the reduction algorithm. A higher weight means the reduction will try harder to preserve vertex coloring.
keepQuadsWeight (kqw) double 0 outputinputconnectablestorablekeyable
How much consideration is given in the reduction algorithm to keeping quad faces. A higher weight means the reduction will try harder to keep quad faces and avoid creation of triangles.
weightCoefficient (wc) double 10000.0 outputinputconnectablestorable
The weight of each vertex is multiplied with this coefficient when the reduction is performed. This value does not have to be edited, normally. It gives finer control over the weighted reduction.
weights (wts) double 0 arrayoutputinputconnectable
This attribute was used in 6.0 or earlier versions, and is not used anymore. This is an obsolete attribute.
vertexWeights (vwt) doubleArray empty outputinputconnectablestorable
An array containing the weights of all vertices. A higher weight means that vertex is less likely to be reduced. If not specified, weights are assumed to be 0.
keepBorder (kb) bool true outputinputconnectablestorablekeyable
Keep the object borders
keepMapBorder (kmb) bool true outputinputconnectablestorablekeyable
Keep the object texture mapping borders
keepHardEdge (khe) bool true outputinputconnectablestorablekeyable
Keep the hard edges on the object
keepOriginalVertices (kev) bool false outputinputconnectablestorablekeyable
Keep original positions, UVs and colors of vertices when collapsing edges. If false, new vertices will be positioned to give optimal shape If true, the vertex closest to the optimal position will be preserved
triangulate (t) bool true outputinputconnectablestorablekeyable
Triangulate all faces, included non reduced ones (for pre 5.0 files) For version 5.0, this attribute specifies if the geometry or the selected faces has to be triangulated, before performing reduction.
cachingReduce (cr) bool false outputinputconnectablestorablekeyable
Cache intermediate reductions for speed at the expense of memory
border (b) double .5 outputinputconnectablestorable
Specifies the degree to which vertices along the geometric border are to be preserved. It has effect only if the keepBorder attribute is set to false. A value of 0 results in all border vertices being preserved. A value of 1.0 results in no special effort being made to preserve any border vertices.
line (l) double .5 outputinputconnectablestorable
Specifies the degree to which "feature lines" (edges joining faces with sharp geometric angles between them) are to be preserved. A value of 0 results in the greatest possible effort to preserve such features. A value of 1.0 results in no special effort being made to preserve such features.
detail (d) double .5 outputinputconnectablestorable
Specifies how much of the reduced geometry should be dedicated to preserving regions of high curvature. A value of 0 will concentrate the detail in areas of high curvature. A value of 1.0 will result in relatively equal distribution of vertices and faces regardless of curvature. This value is ignored when keepHardEdge is set to false.