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

Synopsis

polyOutput( poly poly... , [allValues=boolean], [color=boolean], [colorDesc=boolean], [edge=boolean], [edgeFace=boolean], [face=boolean], [faceNorm=boolean], [force=boolean], [group=boolean], [noOutput=boolean], [normDesc=boolean], [triangle=boolean], [uvDesc=boolean], [uvValue=boolean], [vert=boolean], [vertEdge=boolean], [vertNorm=boolean])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

polyOutput is undoable, NOT queryable, and NOT editable.

Dumps a description of internal memory representation of poly objects. If no objects are specified in the command line, then the objects from the active list are used. If information on the geometry in the history of a poly shape is desired, then the plug of interest needs to be specified in the command line. Default behaviour is to print only a summary. Use the flags above to get more details on a specific part of the object.

Return value

None

Flags

allValues, color, colorDesc, edge, edgeFace, face, faceNorm, force, group, noOutput, normDesc, triangle, uvDesc, uvValue, vert, vertEdge, vertNorm
Long name (short name) Argument types Properties
force(fo) boolean create
Force evaluation of missing pieces before printing.
vert(v) boolean create
Prints the vertex positions.
edge(e) boolean create
Print the edge description.
edgeFace(ef) boolean create
Prints the edge to face adjascency list. Only available if the information is already computed on the object.
vertEdge(ve) boolean create
Prints the vertex to edge adjascency list. Only available if the information is already computed on the object.
face(f) boolean create
Print the faces description
triangle(t) boolean create
Prints the triangles per face. Only available if the information is already computed on the object.
faceNorm(fn) boolean create
Prints the normals per face. Only available if the information is already computed on the object.
vertNorm(vn) boolean create
Prints the normals per vertex. Only available if the information is already computed on the object.
normDesc(nd) boolean create
Prints the normals per vertex description. Each integer is an entry in the vertNorm array. Only available if the information is already computed on the object.
group(g) boolean create
Print the groups of the object.
uvValue(uv) boolean create
Prints the UV positions. In case of multiple UV sets, all sets are printed.
uvDesc(uvd) boolean create
Print the UV description. Each integer is an entry in the uvValue array.
color(c) boolean create
Prints the color per vertex. In case of multiple sets, all sets are printed.
colorDesc(cd) boolean create
Print the color per vertex description. Each integer is an entry in the color array.
allValues(a) boolean create
Shortcut for setting all the flags above
noOutput(no) boolean create
Dont output any data. Would be useful if you want to just evaluate the data, for testing purposes.

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.

Python examples

import maya.cmds as cmds

cmds.polyPlane()
cmds.polyOutput( a=True )

# If a polygon operation is performed such as Add Divisions:
cmds.polySubdivideFacet('pPlane1', dv=1, m=0, ch=1)

# then the command can get information on geometry data feeding into the polySubdFace1 node.
cmds.polyOutput( 'polySubdFace1.inputPolymesh' )

# The command can also get information on geometry data coming out of the
# polySubdFace1 node.
cmds.polyOutput( 'polySubdFace1.output' )