pymel.core.modeling.polyOutput¶

polyOutput(*args, **kwargs)¶

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.

Flags:

Long Name / Short Name		Argument Types	Properties
allValues / a		bool
	Shortcut for setting all the flags above
color / c		bool
	Prints the color per vertex. In case of multiple sets, all sets are printed.
colorDesc / cd		bool
	Print the color per vertex description. Each integer is an entry in the color array.
edge / e		bool
	Print the edge description.
edgeFace / ef		bool
	Prints the edge to face adjascency list. Only available if the information is already computed on the object.
face / f		bool
	Print the faces description
faceNorm / fn		bool
	Prints the normals per face. Only available if the information is already computed on the object.
force / fo		bool
	Force evaluation of missing pieces before printing.
group / g		bool
	Print the groups of the object.
noOutput / no		bool
	Dont output any data. Would be useful if you want to just evaluate the data, for testing purposes.
normDesc / nd		bool
	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.
outputFile / of		unicode
	Location of the output file.
triangle / t		bool
	Prints the triangles per face. Only available if the information is already computed on the object.
uvDesc / uvd		bool
	Print the UV description. Each integer is an entry in the uvValue array.
uvValue / uv		bool
	Prints the UV positions. In case of multiple UV sets, all sets are printed.
vert / v		bool
	Prints the vertex positions.
vertEdge / ve		bool
	Prints the vertex to edge adjascency list. Only available if the information is already computed on the object.
vertNorm / vn		bool
	Prints the normals per vertex. Only available if the information is already computed on the object. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.polyOutput

Example:

import pymel.core as pm

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

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

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

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