Go to: Synopsis. Flags. Return value. Python examples.
polyCompare(
[poly1 poly2]
, [colorSetIndices=boolean], [colorSets=boolean], [edges=boolean], [faceDesc=boolean], [userNormals=boolean], [uvSetIndices=boolean], [uvSets=boolean], [vertices=boolean])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
polyCompare is undoable, queryable, and editable.
Compares two Polygonal Geometry objects with a fine control on what to compare.
If no objects are specified in the command line, then the
objects from the active list are used.
Default behaviour is to compare all flags.
Use MEL script polyCompareTwoObjects.mel to get formatted output from this command.
colorSetIndices, colorSets, edges, faceDesc, userNormals, uvSetIndices, uvSets, vertices
| Long name (short name) |
[argument types] |
Properties |
vertices(v)
|
boolean
|
|
|
Compare poly1, poly2 for matching Vertices.
|
|
edges(e)
|
boolean
|
|
|
Compare poly1, poly2 for matching Edges.
|
|
faceDesc(fd)
|
boolean
|
|
|
Compare poly1, poly2 for matching Face Descriptions. Face descriptions describe the topology of a face, for example number and orientation of edges, number of topology of any holes in the face etc.
|
|
uvSets(uv)
|
boolean
|
|
|
Compare poly1, poly2 for matching UV Sets.
|
|
uvSetIndices(iuv)
|
boolean
|
|
|
Compare poly1, poly2 for matching UV Indices.
|
|
colorSets(c)
|
boolean
|
|
|
Compare poly1, poly2 for matching Color Sets.
|
|
colorSetIndices(ic)
|
boolean
|
|
|
Compare poly1, poly2 for matching Color Indices.
|
|
userNormals(un)
|
boolean
|
|
|
Compare poly1, poly2 for matching User Normals.
|
|
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.
|
0 if successful, non-zero if poly1 and poly2 are not determined to be equal based on requested flags.
The non-zero value depends on which attributes are different:
Vertices = 1
Edges = 2
Face Descriptions = 4
UV Sets = 8
UV Indices = 16
Color Sets = 32
Color Indices = 64
User Normals = 128
So a return value of 3, for example, indicates both vertices and edges are different.
import maya.cmds as cmds
cmds.polySphere()
cmds.polySphere()
cmds.select( cl=True )
cmds.select( 'pSphere1', 'pSphere2', r=True )
cmds.polyCompare()
Return to Autodesk Index