pymel.core.nodetypes.PolyReduce

digraph inheritance172a3c1e0d { rankdir=TB; ranksep=0.15; nodesep=0.15; size="8.0, 12.0"; "DependNode" [fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",URL="pymel.core.nodetypes.DependNode.html#pymel.core.nodetypes.DependNode",style="setlinewidth(0.5)",height=0.25,shape=box,fontsize=8]; "PyNode" -> "DependNode" [arrowsize=0.5,style="setlinewidth(0.5)"]; "PolyBase" [fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",URL="pymel.core.nodetypes.PolyBase.html#pymel.core.nodetypes.PolyBase",style="setlinewidth(0.5)",height=0.25,shape=box,fontsize=8]; "DependNode" -> "PolyBase" [arrowsize=0.5,style="setlinewidth(0.5)"]; "PolyModifier" [fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",URL="pymel.core.nodetypes.PolyModifier.html#pymel.core.nodetypes.PolyModifier",style="setlinewidth(0.5)",height=0.25,shape=box,fontsize=8]; "PolyBase" -> "PolyModifier" [arrowsize=0.5,style="setlinewidth(0.5)"]; "PolyReduce" [fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",URL="#pymel.core.nodetypes.PolyReduce",style="setlinewidth(0.5)",tooltip="class counterpart of mel function `polyReduce`",height=0.25,shape=box,fontsize=8]; "PolyModifier" -> "PolyReduce" [arrowsize=0.5,style="setlinewidth(0.5)"]; "ProxyUnicode" [fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",URL="../pymel.util.utilitytypes/pymel.util.utilitytypes.ProxyUnicode.html#pymel.util.utilitytypes.ProxyUnicode",style="setlinewidth(0.5)",height=0.25,shape=box,fontsize=8]; "PyNode" [fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",URL="../pymel.core.general/pymel.core.general.PyNode.html#pymel.core.general.PyNode",style="setlinewidth(0.5)",tooltip="Abstract class that is base for all pymel nodes classes.",height=0.25,shape=box,fontsize=8]; "ProxyUnicode" -> "PyNode" [arrowsize=0.5,style="setlinewidth(0.5)"]; }

class PolyReduce(*args, **kwargs)

class counterpart of mel function polyReduce

Simplify a polygonal object by reducing geometry while preserving the overall shape of the mesh. The algorithm for polyReduce was changed in 2014 to use a new algorithm derived from Softimage. However, the command still defaults to using the old algorithm for backwards compatibility. Therefore, we recommend setting the version flag to 1 for best results as the new algorithm is better at preserving geometry features. Additionally, some flags only apply to a specific algorithm and this is documented for each flag.

MAttrClass = Enum( EnumValue('MAttrClass', 1, 'localDynamicAttr'), EnumValue('MAttrClass', 2, 'normalAttr'), EnumValue('MAttrClass', 3, 'extensionAttr'), EnumValue('MAttrClass', 4, 'invalidAttr'))
MdgTimerMetric = Enum( EnumValue('MdgTimerMetric', 0, 'metric_callback'), EnumValue('MdgTimerMetric', 1, 'metric_compute'), EnumValue('MdgTimerMetric', 2, 'metric_dirty'), EnumValue('MdgTimerMetric', 3, 'metric_draw'), EnumValue('MdgTimerMetric', 4, 'metric_fetch'), EnumValue('MdgTimerMetric', 5, 'metric_callbackViaAPI'), EnumValue('MdgTimerMetric', 6, 'metric_callbackNotViaAPI'), EnumValue('MdgTimerMetric', 7, 'metric_computeDuringCallback'), EnumValue('MdgTimerMetric', 8, 'metric_computeNotDuringCallback'), EnumValue('MdgTimerMetric', 9, 'metrics'))
MdgTimerState = Enum( EnumValue('MdgTimerState', 0, 'off'), EnumValue('MdgTimerState', 1, 'on'), EnumValue('MdgTimerState', 2, 'uninitialized'), EnumValue('MdgTimerState', 3, 'invalidState'))
MdgTimerType = Enum( EnumValue('MdgTimerType', 0, 'type_self'), EnumValue('MdgTimerType', 1, 'type_inclusive'), EnumValue('MdgTimerType', 2, 'type_count'), EnumValue('MdgTimerType', 3, 'types'))
getCaching(**kwargs)

Toggle caching for all attributes so that no recomputation is needed

Derived from mel command maya.cmds.polyReduce

getCachingReduce(**kwargs)

Cache intermediate reductions for speed at the expense of memory. It is recommended that caching be enabled when using the new algorithm. (-version 1) However, caching is not recommended when using then old algorithm because it can cause stability issues. C: Default is false. Q: When queried, this flag returns a boolean.

Derived from mel command maya.cmds.polyReduce

getColorWeights(**kwargs)

This flag only applies when using the old algorithm and is provided for backwards compatibility. How much consideration vertex color is given in the reduction algorithm. A higher weight means the reduction will try harder to preserve vertex coloring. C: Default is 0. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

getCompactness(**kwargs)

This flag only applies when using the old algorithm and is provided for backwards compatibility. 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 Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

getConstructionHistory(**kwargs)

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.

Derived from mel command maya.cmds.polyReduce

getGeomWeights(**kwargs)

This flag only applies when using the old algorithm and is provided for backwards compatibility. How much consideration vertex positions are given in the reduction algorithm. A higher weight means the reduction will try harder to preserve geometry. C: Default is 1. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

getInvertVertexWeights(**kwargs)

This flag controls how weight map values are interpreted. If true, a vertex weight of 1.0 means a vertex is unlikely to be reduced. If false, a vertex weight of 0.0 means a vertex is unlikely to be reduced. This flag only applies when using the new algorithm. (-version 1) C: Default is true. Q: When queried, this flag returns a boolean.

Derived from mel command maya.cmds.polyReduce

getKeepBorder(**kwargs)

If true, reduction will try to retain geometric borders and the border of the selection. C: Default is true. Q: When queried, this flag returns a boolean.

Derived from mel command maya.cmds.polyReduce

getKeepBorderWeight(**kwargs)

If keepBorder is on, this flag specifies the weight to assign to borders. Setting this value to 0 will disable border preservation and a value of 1 will exactly preserve all border vertices which is useful for matching adjacent meshes. This flag only applies when using the new algorithm. (-version 1) C: Default is 0.5. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

getKeepColorBorder(**kwargs)

If true, reduction will try to retain color borders. These are determined according to color Ids. This flag only applies when using the new algorithm. (-version 1) C: Default is true. Q: When queried, this flag returns a boolean.

Derived from mel command maya.cmds.polyReduce

getKeepColorBorderWeight(**kwargs)

If keepColorBorder is on, this flag specifies the weight to assign to color borders. Setting this value to 0 will disable color border preservation and a value of 1 will exactly preserve all color borders. This flag only applies when using the new algorithm. (-version 1) C: Default is 0.5. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

getKeepCreaseEdge(**kwargs)

If true, reduction will try to retain crease edges. C: Default is true. This flag only applies when using the new algorithm. (-version 1) C: Default is true. Q: When queried, this flag returns a boolean.

Derived from mel command maya.cmds.polyReduce

getKeepCreaseEdgeWeight(**kwargs)

If keepCreaseEdge is on, this flag specifies the weight to assign to crease edges. Setting this value to 0 will disable crease edge preservation and a value of 1 will exactly preserve all crease edges. This flag only applies when using the new algorithm. (-version 1) C: Default is 0.5. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

getKeepFaceGroupBorder(**kwargs)

If true, reduction will try to retain borders of face groups, which are mostly used to define material assignments. This flag only applies when using the new algorithm. (-version 1) C: Default is true. Q: When queried, this flag returns a boolean.

Derived from mel command maya.cmds.polyReduce

getKeepFaceGroupBorderWeight(**kwargs)

If keepFaceGroupBorder is on, this flag specifies the weight to assign to material borders. Setting this value to 0 will disable group border preservation and a value of 1 will exactly preserve all group borders. This flag only applies when using the new algorithm. (-version 1) C: Default is 0.5. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

getKeepHardEdge(**kwargs)

If true, reduction will try to retain hard edges. C: Default is true. Q: When queried, this flag returns a boolean.

Derived from mel command maya.cmds.polyReduce

getKeepHardEdgeWeight(**kwargs)

If keepHardEdge is on, this flag specifies the weight to assign to hard edges. Setting this value to 0 will disable hard edge preservation and a value of 1 will exactly preserve all hard edges. This flag only applies when using the new algorithm. (-version 1) C: Default is 0.5. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

getKeepMapBorder(**kwargs)

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. C: Default is true. Q: When queried, this flag returns a boolean.

Derived from mel command maya.cmds.polyReduce

getKeepMapBorderWeight(**kwargs)

If keepMapBorder is on, this flag specifies the weight to assign to UV map borders. Setting this value to 0 will disable UV map border preservation and a value of 1 will exactly preserve all UV borders. This flag only applies when using the new algorithm. (-version 1) C: Default is 0.5. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

getKeepOriginalVertices(**kwargs)

This flag only applies when using the old algorithm and is provided for backwards compatibility. If true, vertices will try to retain their original positions and will not be repositioned for optimal shape. NOTE: In the newer 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.

Derived from mel command maya.cmds.polyReduce

getKeepQuadsWeight(**kwargs)

This flag controls how much consideration is given to oreserving quad faces during reduction. A higher weight means the reduction will try harder to keep quad faces and avoid creation of triangles. If the version flag is set to 1 (-version 1) and the keepQuadsWeight flag is set to 1.0 then a special quad reduction algorithm is used that does a better job of preserving quads. Howver, this special quad reduction algorithm does not support symmetry so those flags will be ignored when the keepQuadsWeight flag is set to 1.0. C: Default is 0. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

getNodeState(**kwargs)

Maya dependency nodes have 6 possible states. The Normal (0), HasNoEffect (1), and Blocking (2)states can be used to alter how the graph is evaluated. The Waiting-Normal (3), Waiting-HasNoEffect (4), Waiting-Blocking (5)are for internal use only. They temporarily shut off parts of the graph during interaction (e.g., manipulation). The understanding is that once the operation is done, the state will be reset appropriately, e.g. Waiting-Blockingwill reset back to Blocking. The Normaland Blockingcases apply to all nodes, while HasNoEffectis node specific; many nodes do not support this option. Plug-ins store state in the MPxNode::stateattribute. Anyone can set it or check this attribute. Additional details about each of these 3 states follow. StateDescriptionNormalThe normal node state. This is the default.HasNoEffectThe HasNoEffectoption (a.k.a. pass-through), is used in cases where there is an operation on an input producing an output of the same data type. Nearly all deformers support this state, as do a few other nodes. As stated earlier, it is not supported by all nodes. Its typical to implement support for the HasNoEffectstate in the nodes compute method and to perform appropriate operations. Plug-ins can also support HasNoEffect. The usual implementation of this state is to copy the input directly to the matching output without applying the algorithm in the node. For deformers, applying this state leaves the input geometry undeformed on the output. BlockingThis is implemented in the depend node base class and applies to all nodes. Blockingis applied during the evaluation phase to connections. An evaluation request to a blocked connection will return as failures, causing the destination plug to retain its current value. Dirty propagation is indirectly affected by this state since blocked connections are never cleaned. When a node is set to Blockingthe behavior is supposed to be the same as if all outgoing connections were broken. As long as nobody requests evaluation of the blocked node directly it wont evaluate after that. Note that a blocked node will still respond to getAttrrequests but a getAttron a downstream node will not reevaluate the blocked node. Setting the root transform of a hierarchy to Blockingwont automatically influence child transforms in the hierarchy. To do this, youd need to explicitly set all child nodes to the Blockingstate. For example, to set all child transforms to Blocking, you could use the following script. import maya.cmds as cmds def blockTree(root): nodesToBlock = [] for node in {child:1 for child in cmds.listRelatives( root, path=True, allDescendents=True )}.keys(): nodesToBlock += cmds.listConnections(node, source=True, destination=True ) for node in {source:1 for source in nodesToBlock}.keys(): cmds.setAttr( ‘%s.nodeState’ % node, 2 ) Applying this script would continue to draw objects but things would not be animated. Default:kdnNormal

Derived from mel command maya.cmds.polyReduce

getPercentage(**kwargs)

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 0 or when using the old algorithm. C: Default is 0. 100 will remove every possible vertex, 0 will remove none. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

getPreserveTopology(**kwargs)

this flag guarantees that the topological type will be preserved during reduction. In particular, if the input is manifold then the output will be manifold. This option also prevents holes in the mesh from being closed off. This flag only applies when using the new algorithm. (-version 1) C: Default is true. Q: When queried, this flag returns a boolean.

Derived from mel command maya.cmds.polyReduce

getSharpness(**kwargs)

Sharpness controls the balance between preserving small, sharp details versus larger shapes. At low values, details that are small relative to the general shape of the object are more likely to be collapsed. At high values, they are more likely to be kept. This flag only applies when using the new algorithm. (-version 1) C: Default is 0. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

getSymmetryPlaneW(**kwargs)

W value of the symmetry plane. This flag only applies when using the new algorithm (-version 1) and the useVirtualSymmetry flag is set to 2. C: Default is 0. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

getSymmetryPlaneX(**kwargs)

X value of the symmetry plane. This flag only applies when using the new algorithm (-version 1) and the useVirtualSymmetry flag is set to 2. C: Default is 0. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

getSymmetryPlaneY(**kwargs)

Y value of the symmetry plane. This flag only applies when using the new algorithm (-version 1) and the useVirtualSymmetry flag is set to 2. C: Default is 0. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

getSymmetryPlaneZ(**kwargs)

Z value of the symmetry plane. This flag only applies when using the new algorithm (-version 1) and the useVirtualSymmetry flag is set to 2. C: Default is 0. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

getSymmetryTolerance(**kwargs)

Tolerance to use when applying symmetry. For each vertex of the mesh, we find its exact symmetric point, then we look for the closest vertex to the exact symmetry up to the tolerance distance. Higher values risk finding more spurious symmetries, lower values might miss symmetries. The value is distance in object space. This flag only applies when using the new algorithm (-version 1) and the useVirtualSymmetry flag is not set to 0. C: Default is 0. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

getTermination(**kwargs)

This flag specifies the termination condition to use when reducing the mesh. This flag only applies to the new algorithm. (-version 1) 0 Percentage 1 Vertex count 2 Triangle count C: Default is 0. Q: When queried, this flag returns an integer.

Derived from mel command maya.cmds.polyReduce

getTriangleCount(**kwargs)

This flag specifies a target number of triangles to retain after reduction. Note that other factors such as quad and feature preservation may take precendence and cause the actual number of triangles to be different. This flag only applies when using the new algorithm (-version 1) and the termination flag is set to 2. C: Default is 0. Q: When queried, this flag returns an integer.

Derived from mel command maya.cmds.polyReduce

getTriangulate(**kwargs)

This flag only applies when using the old algorithm and is provided for backwards compatibility. This attribute specifies if the geometry or the selected faces has to be triangulated, before performing reduction. C: Default is true. Q: When queried, this flag returns a boolean.

Derived from mel command maya.cmds.polyReduce

getUseVirtualSymmetry(**kwargs)

This flag controls whether symmetry is preserved during the reduction. This flag only applies when using the new algorithm (-version 1) and the keepQuadsWeight flag is less than 1.0. 0 No symmetry preservation 1 Automatic. Try to find suitable symmetry during reduction. 2 Plane. Specify a symmetry plane to use during reduction. C: Default is 0. Q: When queried, this flag returns an integer.

Derived from mel command maya.cmds.polyReduce

getUvWeights(**kwargs)

This flag only applies when using the old algorithm and is provided for backwards compatibility. How much consideration uv positions are given in the reduction algorithm. A higher weight means the reduction will try harder to preserve uv positions. C: Default is 0. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

getVersion(**kwargs)

Version of the poly reduce algorithm to use. 0 Old algorithm used in Maya 2013 and prior for backwards compatibility 1 New algorithm derived from Softimage and used in Maya 2014 and later The default is 0 for backwards compatibility but for best results it is recommended that the new algorithm is used as it is better at preserving mesh details. Some flags only apply to a specific algorithm and this is documented for each flag. C: Default is 0 for backwards compatibility. Q: When queried, this flag returns an integer.

Derived from mel command maya.cmds.polyReduce

getVertexCount(**kwargs)

This flag specifies a target number of vertices to retain after reduction. Note that other factors such as quad and feature preservation may take precendence and cause the actual number of vertices to be different. This flag only applies when using the new algorithm (-version 1) and the termination flag is set to 1. C: Default is 0. Q: When queried, this flag returns an integer.

Derived from mel command maya.cmds.polyReduce

getVertexMapName(**kwargs)

Name of a color set to be added to the output mesh that stores a mapping from vertices in the output mesh to vertices in the input mesh. The color set is RGB. The original vertex Id that maps to an output vertex is of a vertex is 65536*r + g where r and g are the red and green channel at a vertex. The blue channel is always zero. Each vertex in the output mesh has a shared color. This flag only applies when using the new algorithm. (-version 1) Q: When queried, this flag returns a string.

Derived from mel command maya.cmds.polyReduce

getVertexWeightCoefficient(**kwargs)

This flag specifies a constant value to multiply to each weight map value. A value of zero turns off the weight map. This flag only applies when using the new algorithm. (-version 1) C: Default is 1. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

getWeightCoefficient(**kwargs)

This flag only applies when using the old algorithm and is provided for backwards compatibility. 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. This attribute is replaced by vertexWeightCoefficient in the new algorithm when the version flag is set to 1. C: Default is 10000. Q: When queried, this flag returns a float. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.polyReduce

setCaching(val=True, **kwargs)

Toggle caching for all attributes so that no recomputation is needed

Derived from mel command maya.cmds.polyReduce

setCachingReduce(val=True, **kwargs)

Cache intermediate reductions for speed at the expense of memory. It is recommended that caching be enabled when using the new algorithm. (-version 1) However, caching is not recommended when using then old algorithm because it can cause stability issues. C: Default is false. Q: When queried, this flag returns a boolean.

Derived from mel command maya.cmds.polyReduce

setColorWeights(val=True, **kwargs)

This flag only applies when using the old algorithm and is provided for backwards compatibility. How much consideration vertex color is given in the reduction algorithm. A higher weight means the reduction will try harder to preserve vertex coloring. C: Default is 0. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

setCompactness(val=True, **kwargs)

This flag only applies when using the old algorithm and is provided for backwards compatibility. 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 Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

setGeomWeights(val=True, **kwargs)

This flag only applies when using the old algorithm and is provided for backwards compatibility. How much consideration vertex positions are given in the reduction algorithm. A higher weight means the reduction will try harder to preserve geometry. C: Default is 1. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

setInvertVertexWeights(val=True, **kwargs)

This flag controls how weight map values are interpreted. If true, a vertex weight of 1.0 means a vertex is unlikely to be reduced. If false, a vertex weight of 0.0 means a vertex is unlikely to be reduced. This flag only applies when using the new algorithm. (-version 1) C: Default is true. Q: When queried, this flag returns a boolean.

Derived from mel command maya.cmds.polyReduce

setKeepBorder(val=True, **kwargs)

If true, reduction will try to retain geometric borders and the border of the selection. C: Default is true. Q: When queried, this flag returns a boolean.

Derived from mel command maya.cmds.polyReduce

setKeepBorderWeight(val=True, **kwargs)

If keepBorder is on, this flag specifies the weight to assign to borders. Setting this value to 0 will disable border preservation and a value of 1 will exactly preserve all border vertices which is useful for matching adjacent meshes. This flag only applies when using the new algorithm. (-version 1) C: Default is 0.5. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

setKeepColorBorder(val=True, **kwargs)

If true, reduction will try to retain color borders. These are determined according to color Ids. This flag only applies when using the new algorithm. (-version 1) C: Default is true. Q: When queried, this flag returns a boolean.

Derived from mel command maya.cmds.polyReduce

setKeepColorBorderWeight(val=True, **kwargs)

If keepColorBorder is on, this flag specifies the weight to assign to color borders. Setting this value to 0 will disable color border preservation and a value of 1 will exactly preserve all color borders. This flag only applies when using the new algorithm. (-version 1) C: Default is 0.5. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

setKeepCreaseEdge(val=True, **kwargs)

If true, reduction will try to retain crease edges. C: Default is true. This flag only applies when using the new algorithm. (-version 1) C: Default is true. Q: When queried, this flag returns a boolean.

Derived from mel command maya.cmds.polyReduce

setKeepCreaseEdgeWeight(val=True, **kwargs)

If keepCreaseEdge is on, this flag specifies the weight to assign to crease edges. Setting this value to 0 will disable crease edge preservation and a value of 1 will exactly preserve all crease edges. This flag only applies when using the new algorithm. (-version 1) C: Default is 0.5. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

setKeepFaceGroupBorder(val=True, **kwargs)

If true, reduction will try to retain borders of face groups, which are mostly used to define material assignments. This flag only applies when using the new algorithm. (-version 1) C: Default is true. Q: When queried, this flag returns a boolean.

Derived from mel command maya.cmds.polyReduce

setKeepFaceGroupBorderWeight(val=True, **kwargs)

If keepFaceGroupBorder is on, this flag specifies the weight to assign to material borders. Setting this value to 0 will disable group border preservation and a value of 1 will exactly preserve all group borders. This flag only applies when using the new algorithm. (-version 1) C: Default is 0.5. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

setKeepHardEdge(val=True, **kwargs)

If true, reduction will try to retain hard edges. C: Default is true. Q: When queried, this flag returns a boolean.

Derived from mel command maya.cmds.polyReduce

setKeepHardEdgeWeight(val=True, **kwargs)

If keepHardEdge is on, this flag specifies the weight to assign to hard edges. Setting this value to 0 will disable hard edge preservation and a value of 1 will exactly preserve all hard edges. This flag only applies when using the new algorithm. (-version 1) C: Default is 0.5. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

setKeepMapBorder(val=True, **kwargs)

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. C: Default is true. Q: When queried, this flag returns a boolean.

Derived from mel command maya.cmds.polyReduce

setKeepMapBorderWeight(val=True, **kwargs)

If keepMapBorder is on, this flag specifies the weight to assign to UV map borders. Setting this value to 0 will disable UV map border preservation and a value of 1 will exactly preserve all UV borders. This flag only applies when using the new algorithm. (-version 1) C: Default is 0.5. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

setKeepOriginalVertices(val=True, **kwargs)

This flag only applies when using the old algorithm and is provided for backwards compatibility. If true, vertices will try to retain their original positions and will not be repositioned for optimal shape. NOTE: In the newer 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.

Derived from mel command maya.cmds.polyReduce

setKeepQuadsWeight(val=True, **kwargs)

This flag controls how much consideration is given to oreserving quad faces during reduction. A higher weight means the reduction will try harder to keep quad faces and avoid creation of triangles. If the version flag is set to 1 (-version 1) and the keepQuadsWeight flag is set to 1.0 then a special quad reduction algorithm is used that does a better job of preserving quads. Howver, this special quad reduction algorithm does not support symmetry so those flags will be ignored when the keepQuadsWeight flag is set to 1.0. C: Default is 0. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

setNodeState(val=True, **kwargs)

Maya dependency nodes have 6 possible states. The Normal (0), HasNoEffect (1), and Blocking (2)states can be used to alter how the graph is evaluated. The Waiting-Normal (3), Waiting-HasNoEffect (4), Waiting-Blocking (5)are for internal use only. They temporarily shut off parts of the graph during interaction (e.g., manipulation). The understanding is that once the operation is done, the state will be reset appropriately, e.g. Waiting-Blockingwill reset back to Blocking. The Normaland Blockingcases apply to all nodes, while HasNoEffectis node specific; many nodes do not support this option. Plug-ins store state in the MPxNode::stateattribute. Anyone can set it or check this attribute. Additional details about each of these 3 states follow. StateDescriptionNormalThe normal node state. This is the default.HasNoEffectThe HasNoEffectoption (a.k.a. pass-through), is used in cases where there is an operation on an input producing an output of the same data type. Nearly all deformers support this state, as do a few other nodes. As stated earlier, it is not supported by all nodes. Its typical to implement support for the HasNoEffectstate in the nodes compute method and to perform appropriate operations. Plug-ins can also support HasNoEffect. The usual implementation of this state is to copy the input directly to the matching output without applying the algorithm in the node. For deformers, applying this state leaves the input geometry undeformed on the output. BlockingThis is implemented in the depend node base class and applies to all nodes. Blockingis applied during the evaluation phase to connections. An evaluation request to a blocked connection will return as failures, causing the destination plug to retain its current value. Dirty propagation is indirectly affected by this state since blocked connections are never cleaned. When a node is set to Blockingthe behavior is supposed to be the same as if all outgoing connections were broken. As long as nobody requests evaluation of the blocked node directly it wont evaluate after that. Note that a blocked node will still respond to getAttrrequests but a getAttron a downstream node will not reevaluate the blocked node. Setting the root transform of a hierarchy to Blockingwont automatically influence child transforms in the hierarchy. To do this, youd need to explicitly set all child nodes to the Blockingstate. For example, to set all child transforms to Blocking, you could use the following script. import maya.cmds as cmds def blockTree(root): nodesToBlock = [] for node in {child:1 for child in cmds.listRelatives( root, path=True, allDescendents=True )}.keys(): nodesToBlock += cmds.listConnections(node, source=True, destination=True ) for node in {source:1 for source in nodesToBlock}.keys(): cmds.setAttr( ‘%s.nodeState’ % node, 2 ) Applying this script would continue to draw objects but things would not be animated. Default:kdnNormal

Derived from mel command maya.cmds.polyReduce

setPercentage(val=True, **kwargs)

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 0 or when using the old algorithm. C: Default is 0. 100 will remove every possible vertex, 0 will remove none. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

setPreserveTopology(val=True, **kwargs)

this flag guarantees that the topological type will be preserved during reduction. In particular, if the input is manifold then the output will be manifold. This option also prevents holes in the mesh from being closed off. This flag only applies when using the new algorithm. (-version 1) C: Default is true. Q: When queried, this flag returns a boolean.

Derived from mel command maya.cmds.polyReduce

setSharpness(val=True, **kwargs)

Sharpness controls the balance between preserving small, sharp details versus larger shapes. At low values, details that are small relative to the general shape of the object are more likely to be collapsed. At high values, they are more likely to be kept. This flag only applies when using the new algorithm. (-version 1) C: Default is 0. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

setSymmetryPlaneW(val=True, **kwargs)

W value of the symmetry plane. This flag only applies when using the new algorithm (-version 1) and the useVirtualSymmetry flag is set to 2. C: Default is 0. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

setSymmetryPlaneX(val=True, **kwargs)

X value of the symmetry plane. This flag only applies when using the new algorithm (-version 1) and the useVirtualSymmetry flag is set to 2. C: Default is 0. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

setSymmetryPlaneY(val=True, **kwargs)

Y value of the symmetry plane. This flag only applies when using the new algorithm (-version 1) and the useVirtualSymmetry flag is set to 2. C: Default is 0. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

setSymmetryPlaneZ(val=True, **kwargs)

Z value of the symmetry plane. This flag only applies when using the new algorithm (-version 1) and the useVirtualSymmetry flag is set to 2. C: Default is 0. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

setSymmetryTolerance(val=True, **kwargs)

Tolerance to use when applying symmetry. For each vertex of the mesh, we find its exact symmetric point, then we look for the closest vertex to the exact symmetry up to the tolerance distance. Higher values risk finding more spurious symmetries, lower values might miss symmetries. The value is distance in object space. This flag only applies when using the new algorithm (-version 1) and the useVirtualSymmetry flag is not set to 0. C: Default is 0. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

setTermination(val=True, **kwargs)

This flag specifies the termination condition to use when reducing the mesh. This flag only applies to the new algorithm. (-version 1) 0 Percentage 1 Vertex count 2 Triangle count C: Default is 0. Q: When queried, this flag returns an integer.

Derived from mel command maya.cmds.polyReduce

setTriangleCount(val=True, **kwargs)

This flag specifies a target number of triangles to retain after reduction. Note that other factors such as quad and feature preservation may take precendence and cause the actual number of triangles to be different. This flag only applies when using the new algorithm (-version 1) and the termination flag is set to 2. C: Default is 0. Q: When queried, this flag returns an integer.

Derived from mel command maya.cmds.polyReduce

setTriangulate(val=True, **kwargs)

This flag only applies when using the old algorithm and is provided for backwards compatibility. This attribute specifies if the geometry or the selected faces has to be triangulated, before performing reduction. C: Default is true. Q: When queried, this flag returns a boolean.

Derived from mel command maya.cmds.polyReduce

setUseVirtualSymmetry(val=True, **kwargs)

This flag controls whether symmetry is preserved during the reduction. This flag only applies when using the new algorithm (-version 1) and the keepQuadsWeight flag is less than 1.0. 0 No symmetry preservation 1 Automatic. Try to find suitable symmetry during reduction. 2 Plane. Specify a symmetry plane to use during reduction. C: Default is 0. Q: When queried, this flag returns an integer.

Derived from mel command maya.cmds.polyReduce

setUvWeights(val=True, **kwargs)

This flag only applies when using the old algorithm and is provided for backwards compatibility. How much consideration uv positions are given in the reduction algorithm. A higher weight means the reduction will try harder to preserve uv positions. C: Default is 0. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

setVersion(val=True, **kwargs)

Version of the poly reduce algorithm to use. 0 Old algorithm used in Maya 2013 and prior for backwards compatibility 1 New algorithm derived from Softimage and used in Maya 2014 and later The default is 0 for backwards compatibility but for best results it is recommended that the new algorithm is used as it is better at preserving mesh details. Some flags only apply to a specific algorithm and this is documented for each flag. C: Default is 0 for backwards compatibility. Q: When queried, this flag returns an integer.

Derived from mel command maya.cmds.polyReduce

setVertexCount(val=True, **kwargs)

This flag specifies a target number of vertices to retain after reduction. Note that other factors such as quad and feature preservation may take precendence and cause the actual number of vertices to be different. This flag only applies when using the new algorithm (-version 1) and the termination flag is set to 1. C: Default is 0. Q: When queried, this flag returns an integer.

Derived from mel command maya.cmds.polyReduce

setVertexWeightCoefficient(val=True, **kwargs)

This flag specifies a constant value to multiply to each weight map value. A value of zero turns off the weight map. This flag only applies when using the new algorithm. (-version 1) C: Default is 1. Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.polyReduce

setWeightCoefficient(val=True, **kwargs)

This flag only applies when using the old algorithm and is provided for backwards compatibility. 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. This attribute is replaced by vertexWeightCoefficient in the new algorithm when the version flag is set to 1. C: Default is 10000. Q: When queried, this flag returns a float. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.polyReduce