Go to:
Return value. Related commands. Flags. Examples.
Synopsis
polyEvaluate [flags] [poly1 poly2 ...]
Returns the required counts on the specified objects.
If no objects are specified in the command line, then the
objects from the active list are used.
The values are returned in the same order as the flags are set.
For user convenience, if no flag is set, then all values are echoed.
All flags (except -fmt/format) are in fact query-flags. For
user convenience, the -q flag may be ommitted.
Some comments for non-formatted output :
- 3d bounding boxes are returned as 3 couples of floats,
2d ones as 2 couples of floats.
-
if a bounding box is queried and cannot be computed (for example
the component bounding box when no component is selected, or 2d bounding box for
and unmapped object) 0 is returned for each array element, so that
indices in the output array remain consistent.
-
int values (queried by topological flags) cannot be
mixed with float values (queried by bounding box flags).
Thus if no flag is set, only int values are returned.
Return value
an array of values or a string, depending on the format requested.
Related commands
polyIterOnPoly, polyInfoFlags
accurateEvaluation, area, boundingBox, boundingBox2d, boundingBoxComponent, boundingBoxComponent2d, displayStats, edge, edgeComponent, face, faceComponent, format, shell, triangle, triangleComponent, uvComponent, uvSetName, uvcoord, vertex, vertexComponent, worldArea
| Long name (short name) | [argument types] | Properties |
|---|
-displayStats
(-ds)
| |   |
|
toggles the display of poly statistics for the active View.
All other flags are ignored if this flag is specified (Obsolete
- refer to the headsUpDisplay command)
|
|
-vertex
(-v)
| | |
|
returns the number of vertices as an int
|
|
-edge
(-e)
| | |
|
returns the number of edges as an int
|
|
-face
(-f)
| | |
|
returns the number of faces as an int
|
|
-uvcoord
(-uv)
| | |
|
returns the number of uv coordinates (for the current map if one is not specified) as an int
|
|
-triangle
(-t)
| | |
|
returns the number of triangles as an int
|
|
-shell
(-s)
| | |
|
returns the number of shells shells (disconnected pieces) as an int
|
|
-boundingBox
(-b)
| | |
|
returns the object's bounding box in 3d space
as 6 floats : xmin xmax ymin ymax zmin zmax
|
|
-boundingBox2d
(-b2)
| | |
|
returns the object's uv bounding box (for the current map if one is not specified) in 2d space
as 4 floats : xmin xmax ymin ymax
|
|
-vertexComponent
(-vc)
| | |
|
returns the object's number of selected vertices as an int
|
|
-edgeComponent
(-ec)
| | |
|
returns the object's number of selected edges as an int
|
|
-faceComponent
(-fc)
| | |
|
returns the object's number of selected faces as an int
|
|
-uvComponent
(-uvc)
| | |
|
returns the object's number of selected uv coordinates as an int
|
|
-triangleComponent
(-tc)
| | |
|
returns the number of triangles of selected components as an int
|
|
-boundingBoxComponent
(-bc)
| | |
|
returns the bounding box of selected components in 3d space
as 6 floats : xmin xmax ymin ymax zmin zmax
|
|
-boundingBoxComponent2d
(-bc2)
| | |
|
returns the bounding box of selected uv coordinates in 2d space
as 4 floats : xmin xmax ymin ymax
|
|
-accurateEvaluation
(-ae)
| | |
|
used to get accurate results for the bounding box computation
For objects with large vertex counts, accurate evaluation takes more time
|
|
-format
(-fmt)
| | |
|
used to display the results as an explicit sentence
|
|
-uvSetName
(-uvs)
| string | |
|
used when querying texture vertices to specify the uv set. If a uv set
is not specified then the current map for the object will be used
|
|
-area
(-a)
| | |
|
returns the surface area of the object's faces in local space as a float
|
|
-worldArea
(-wa)
| | |
|
returns the surface area of the object's faces in world space as a float
|
|
|
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
|
Examples
polyPlane -n plg -sx 4 -sy 4 -w 5 -h 5;
select plg.f[2] plg.f[4];
// query the number of faces
polyEvaluate -f;
// Result: 16
// query the number of triangles
polyEvaluate -t;
// Result: 32
// query the number of selected faces
polyEvaluate -faceComponent;
// Result: 2
// query the number of vertices and faces
polyEvaluate -v -f;
// Result: 25 16
// formatted query of the number of vertices and faces
polyEvaluate -v -f -fmt;
// Result: vertex=25 face=16
// query all
polyEvaluate;
// Result: 25 40 16 25 32 1 0 0 2 0
//formatted query of all information
polyEvaluate -fmt;
// Result: vertex=25 edge=40 face=16 uvcoord=25 triangle=32 shell=1
// vertexComponent=0 edgeComponent=0 faceComponent=2 uvComponent=0
// boundingBox= X[-2.50,2.50] Y[0.00,0.00] Z[-2.50,2.50]
// boundingBoxComponent= X[-2.50,1.25] Y[0.00,0.00] Z[0.00,2.50]
// boundingBox2d= U[0.00,1.00] V[0.00,1.00]
// boundingBoxComponent2d= U[0.00,0.75] V[0.00,0.50]
// area=25.00 worldArea=25.00
// accurate bounding box evaluation
polyCylinder -r 1 -h 2 -sx 20 -sy 1 -sz 1 -ax 0 1 0 -tx 1 -ch 1;
// Result: pCylinder1 polyCylinder1 //
rotate -r -os 38.340875 0 0 ;
rotate -r -os 0 0 -36.177835 ;
polyEvaluate -b;
// Result: -1.397482 1.397482 -1.716432 1.716432 -1.651247 1.651247 //
polyEvaluate -b -ae;
// Result: -1.397482 1.397482 -1.407107 1.407107 -1.359833 1.359833 //
// Local and World Space Area
polyCube -w 1 -h 1 -d 1 -sx 1 -sy 1 -sz 1 -ax 0 0 1 -tx 1 -ch 1;
setAttr "pCube1.scaleY" 2;
polyEvaluate -a;
// Result: 6
polyEvaluate -wa;
// Result: 10