displaySmoothness

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

Synopsis

displaySmoothness [-boundary] [-defaultCreation] [-divisionsU int] [-divisionsV int] [-full] [-hull] [-pointsShaded int] [-pointsWire int] [-polygonObject int] [-query] [-renderTessellation] [-simplifyU int] [-simplifyV int] [objects]

displaySmoothness is undoable, queryable, and editable.

Flags

Long name (short name)	[argument types]	Properties
-query(-q)
Query smoothness of selected surfaces (and curves). -all Change smoothness for all curves and surfaces
-full(-f)
Display surface at full resolution - the default. In query mode, this flag needs a value.
-hull(-hl)
Display surface using the hull (control points are drawn rather than surface knot points). This mode is a useful display performance improvement when modifying a surface since it doesn't require evaluating points on the surface. In query mode, this flag needs a value.
-boundary(-bn)
Display wireframe surfaces using only the boundaries of the surface Not fully implemented yet In query mode, this flag needs a value.
-defaultCreation(-dc)
The default values at creation (applies only -du, -dv, -pw, -ps) In query mode, this flag needs a value.
-pointsWire(-pw)	int
Number of points per surface isoparm span or the number of points per curve span in wireframe mode. The valid range of values is [1,128]. Note: This is the only flag that also applies to nurbs curves. In query mode, this flag needs a value.
-pointsShaded(-ps)	int
Number of points per surface span in shaded mode. The valid range of values is [1,64]. In query mode, this flag needs a value.
-divisionsU(-du)	int
Number of isoparm divisions per span in the U direction. The valid range of values is [0,64]. In query mode, this flag needs a value.
-divisionsV(-dv)	int
Number of isoparm divisions per span in the V direction. The valid range of values is [0,64]. In query mode, this flag needs a value.
-simplifyU(-su)	int
Number of spans to skip in the U direction when in hull display mode. In query mode, this flag needs a value.
-simplifyV(-sv)	int
Number of spans to skip in the V direction when in hull display mode. In query mode, this flag needs a value.
-renderTessellation(-rt)
Display using render tesselation parameters when in shaded mode. In query mode, this flag needs a value.
-polygonObject(-po)	int
Display the polygon objects with the given resolution In query mode, this flag needs a value.

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

Return value

Related

MEL examples

// create a surface
sphere;

// set rough smoothness settings
displaySmoothness -du 0 -dv 0 -pw 4 -ps 1;

// set medium smoothness settings
displaySmoothness -du 1 -dv 1 -pw 8 -ps 2;

// set fine smoothness settings
displaySmoothness -du 2 -dv 2 -pw 16 -ps 4;

// Display surface as a hull
displaySmoothness -hull;

// Display with reduced number of points
displaySmoothness -hull -su 2 -sv 2;

// Display rendering tesselation
displaySmoothness -rt 1;

// Set default value for pointsShaded.
// Subsequent surfaces created will have pointsShaded as 2.
displaySmoothness -dc -ps 2;

// displaySmoothness queries
displaySmoothness -q -hull;        // query hull display, returns boolean
displaySmoothness -q -dc -ps;    // query default pointsShaded value
displaySmoothness -q -du;        // query surface divisionsU value

// Only the -pointsWire flag works on curves.
circle;

// change the number of points displayed per curve span.
displaySmoothness -pw 3;
// query default pointsWire value for curves.
displaySmoothness -q -dc -pw;

polyCube;

// Query the display resolution
displaySmoothness -q -polygonObject;
// Result: 0

// Change the display resolution
displaySmoothness -polygonObject 2;