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

Synopsis

polyOptions [-activeObjects] [-allEdges] [-backCullVertex boolean] [-backCulling] [-colorMaterialChannel string] [-colorShadedDisplay boolean] [-displayAlphaAsGreyScale boolean] [-displayBorder boolean] [-displayCenter boolean] [-displayCreaseEdge boolean] [-displayCreaseVertex boolean] [-displayGeometry boolean] [-displayItemNumbers boolean boolean boolean boolean] [-displayMapBorder boolean] [-displayNormal boolean] [-displaySubdComps boolean] [-displayTriangle boolean] [-displayUVTopology boolean] [-displayUVs boolean] [-displayVertex boolean] [-displayWarp boolean] [-facet] [-fullBack] [-global] [-hardBack] [-hardEdge] [-materialBlend string] [-newPolymesh] [-point] [-pointFacet] [-relative] [-reuseTriangles boolean] [-sizeBorder float] [-sizeNormal float] [-sizeUV float] [-sizeVertex float] [-softEdge] [-wireBackCulling]

polyOptions is undoable, queryable, and NOT editable.

Changes the global display polygonal attributes.

Return value

None

In query mode, return type is based on queried flag.

Flags

activeObjects, allEdges, backCullVertex, backCulling, colorMaterialChannel, colorShadedDisplay, displayAlphaAsGreyScale, displayBorder, displayCenter, displayCreaseEdge, displayCreaseVertex, displayGeometry, displayItemNumbers, displayMapBorder, displayNormal, displaySubdComps, displayTriangle, displayUVTopology, displayUVs, displayVertex, displayWarp, facet, fullBack, global, hardBack, hardEdge, materialBlend, newPolymesh, point, pointFacet, relative, reuseTriangles, sizeBorder, sizeNormal, sizeUV, sizeVertex, softEdge, wireBackCulling
Long name (short name) Argument types Properties
-relative(-r)
When this flag is used with flags dealing with size, the value (size) is a multiplication factor : i.e for flags : -sizeNormal, -sizeBorder. When this flag is used with flags dealing with a boolean value, the boolean value is toggled : i.e for flags : displayVertex, displayCenter, displayTriangle, displayBorder, backCullVertex, displayWarp, displayItemNumbers.
-colorMaterialChannel(-cm) string
If colorShadedDisplay is true, then determines which material channel to display color per vertex in. The options are: "none" : disable material shading "ambient" : ambient material channel "ambientDiffuse" : ambient and diffuse material channel "diffuse" : diffuse material channel "specular" : specular material channel "emission" : emission material channel
-materialBlend(-mb) string
The options are: "overwrite" "add" "subtract" "multiply" "divide" "average" "modulate2x"
-colorShadedDisplay(-cs) boolean
Use color per vertex display in shaded mode.
-displayVertex(-dv) boolean
Display vertices.
-displayCenter(-dc) boolean
Display facet centers.
-displayTriangle(-dt) boolean
Display triangulation.
-displayBorder(-db) boolean
Highlight border edge.
-displayMapBorder(-dmb) boolean
Highlight map border edge.
-displayCreaseEdge(-dce) boolean
Highlight creased edges
-displayCreaseVertex(-dcv) boolean
Highlight creased vertices
-displaySubdComps(-dsc) boolean
Display subdivided components when in Smooth Mesh Preview mode.
-sizeBorder(-sb) float
Set the size of the polygonal border edges.
-sizeVertex(-sv) float
Set the size of the polygonal vertex.
-displayWarp(-dw) boolean
Highlight warped facets.
-displayItemNumbers(-din) boolean boolean boolean boolean
Displays item numbers (vertices edges facets uvs)
-displayNormal(-dn) boolean
Display normals.
-displayUVs(-duv) boolean
Display UVs.
-displayUVTopology(-uvt) boolean
Option on UV display to display UVs topologically.
-sizeUV(-suv) float
Set the size of the polygonal UV.
-point(-pt)
For use with -dn flag. Set the normal display style to vertex display.
-facet(-f)
For use with -dn flag. Set the normal display style to facet display.
-pointFacet(-pf)
For use with -dn flag. Set the normal display style to vertex and face display.
-sizeNormal(-sn) float
Set the size of the polygonal normals.
-allEdges(-ae)
Display all edges in solid line.
-softEdge(-se)
Display soft edges in dotted lines.
-hardEdge(-he)
Display only hard edges.
-displayGeometry(-dg) boolean
Display geometry.
-backCulling(-bc)
Display with no back culling.
-wireBackCulling(-wbc)
Backculled faces are in wireframe.
-hardBack(-hb)
Backculled hard edges only for backculled faces.
-fullBack(-fb)
Display with full back culling.
-backCullVertex(-bcv) boolean
BackCull vertices.
-reuseTriangles(-rt) boolean
Avoid regenerating triangles, by reusing the old triangles upstream in the construction history. The construction history is searched upstream and downstream for other mesh nodes, and the given boolean value is set on those mesh nodes. Note, that this command does not set the value on the given mesh node. That has to be done using the setAttr command. This option would affect only the interactive 3d viewport. The batch-rendering would use the properly computed triangles. This is useful only for interactive performance such as skinning playback, when the display mode is shaded (or wireframe with triangles displayed) Using this option for wireframe display mode is not recomended.
-global(-gl)
Apply user choices for all objects.
-activeObjects(-ao)
Apply user choices for all active objects.
-newPolymesh(-np)
Set component display state of new polymesh objects.
-displayAlphaAsGreyScale(-dal) boolean
Display alpha as grey scale.
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

  polyCube -n plg -sx 3 -sy 3 -sz 3 -w 5 -h 5 -d 5; delete plg.f[9:17];

  //<B>Vertices</B>
  polyOptions -displayVertex true;
  //<I>Toggle vertices</I>
  polyOptions -r -displayVertex true;
  //Toggle, whatever the value given to the flag in this command.
  //It was previously true, it is set to false : vertices are not drawn.

  //<B>Facet centers</B>
  polyOptions -displayCenter true;
  polyOptions -displayCenter false;

  //<B>Triangulation</B>
  polyOptions -displayTriangle true;
  polyOptions -displayTriangle false;

  //<B>Reusing Triangulation</B>
  polyOptions -reuseTriangles true;
  polyOptions -reuseTriangles false;

  //<B>Borders</B>
  polyOptions -displayBorder true;
  //<I>border size</I>
  polyOptions -sb 3;
  //<I>Increase border size</I>
  polyOptions -r -sb 2;
  polyOptions -displayBorder false -sb 3;
  //<B>map borders</B>
  polyOptions -displayMapBorder true;
  polyOptions -displayMapBorder false;

  //<B>Normals</B>
  //<I>normal type</I>
  polyOptions -displayNormal true;
  polyOptions -pt;    // on vertices
  polyOptions -pf;    // on vertices and facets
  polyOptions -f;        // on facets
  //<I>normal size</I>
  polyOptions -sn 2;
  //<I>Increase normal size</I>
  polyOptions -r -sn 1.5;
  polyOptions -displayNormal false;

  //<B>Edges</B>
  polyOptions -softEdge;
  polyOptions -hardEdge;
  polyOptions -allEdges;

  //<B>Geometry</B>
  polyOptions -displayGeometry false;
  polyOptions -displayGeometry true;

  //<B>Backculling</B>
  polyOptions -wireBackCulling;
  polyOptions -hardBack;
  polyOptions -fullBack;
  polyOptions -displayVertex true -backCullVertex true;
  polyOptions -backCullVertex false;
  polyOptions -displayVertex false;
  polyOptions -backCulling;

//<B>Color Shaded Display</B>
  polyOptions -colorShadedDisplay true;
  polyOptions -colorMaterialChannel "DIFFUSE";