Go to: Synopsis. Return value. Flags. MEL examples.

Synopsis

polyCompare [-colorSetIndices] [-colorSets] [-edges] [-faceDesc] [-userNormals] [-uvSetIndices] [-uvSets] [-vertices] poly poly

polyCompare is undoable, NOT queryable, and NOT 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.

Return value

int0 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.

Flags

colorSetIndices, colorSets, edges, faceDesc, userNormals, uvSetIndices, uvSets, vertices
Long name (short name) Argument types Properties
-vertices(-v) create
Compare poly1, poly2 for matching Vertices.
-edges(-e) create
Compare poly1, poly2 for matching Edges.
-faceDesc(-fd) create
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) create
Compare poly1, poly2 for matching UV Sets.
-uvSetIndices(-iuv) create
Compare poly1, poly2 for matching UV Indices.
-colorSets(-c) create
Compare poly1, poly2 for matching Color Sets.
-colorSetIndices(-ic) create
Compare poly1, poly2 for matching Color Indices.
-userNormals(-un) create
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 be used more than once in a command.

MEL examples

polySphere;
  polySphere;
  select -cl  ;
  select -r pSphere1 pSphere2 ;
  polyCompare;