pymel.core.general.displaySmoothness

static general.displaySmoothness(*args, **kwargs)

This command is responsible for setting the display smoothness of NURBS curves and surfaces to either predefined or custom values. It also sets display modes for smoothness such as hulls and the hull simplification factors. At present, this command is NOT un-doable. In query mode, return type is based on queried flag.

Flags:
Long name (short name) Argument Types Properties
all (all) bool ../../../_images/create.gif ../../../_images/query.gif
 
Change smoothness for all curves and surfaces
boundary (bn) bool ../../../_images/create.gif ../../../_images/query.gif
 
Display wireframe surfaces using only the boundaries of the surface Not fully implemented yet
defaultCreation (dc) bool ../../../_images/create.gif ../../../_images/query.gif
 
The default values at creation (applies only -du, -dv, -pw, -ps)
divisionsU (du) int ../../../_images/create.gif ../../../_images/query.gif
 
Number of isoparm divisions per span in the U direction. The valid range of values is [0,64].
divisionsV (dv) int ../../../_images/create.gif ../../../_images/query.gif
 
Number of isoparm divisions per span in the V direction. The valid range of values is [0,64].
full (f) bool ../../../_images/create.gif ../../../_images/query.gif
 
Display surface at full resolution - the default.
hull (hl) bool ../../../_images/create.gif ../../../_images/query.gif
 

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.

pointsShaded (ps) int ../../../_images/create.gif ../../../_images/query.gif
 
Number of points per surface span in shaded mode. The valid range of values is [1,64].
pointsWire (pw) int ../../../_images/create.gif ../../../_images/query.gif
 

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.

polygonObject (po) int ../../../_images/create.gif ../../../_images/query.gif
 
Display the polygon objects with the given resolution Flag can have multiple arguments, passed either as a tuple or a list.
renderTessellation (rt) bool ../../../_images/create.gif ../../../_images/query.gif
 
Display using render tesselation parameters when in shaded mode.
simplifyU (su) int ../../../_images/create.gif ../../../_images/query.gif
 
Number of spans to skip in the U direction when in hull display mode.
simplifyV (sv) int ../../../_images/create.gif ../../../_images/query.gif
 
Number of spans to skip in the V direction when in hull display mode.

Derived from mel command maya.cmds.displaySmoothness

Example:

import pymel.core as pm

# create a surface
pm.sphere()

# set rough smoothness settings
pm.displaySmoothness( du=0, dv=0, pw=4, ps=1 )

# set medium smoothness settings
pm.displaySmoothness( du=1, dv=1, pw=8, ps=2 )

# set fine smoothness settings
pm.displaySmoothness( du=2, dv=2, pw=16, ps=4 )

# Display surface as a hull
pm.displaySmoothness( hull=True )

# Display with reduced number of points
pm.displaySmoothness( hull=True, su=2, sv=2 )

# Display rendering tesselation
pm.displaySmoothness( rt=1 )

# Set default value for pointsShaded.
# Subsequent surfaces created will have pointsShaded as 2.
pm.displaySmoothness( dc=True, ps=2 )

# displaySmoothness queries
#
# query hull display, returns boolean
pm.displaySmoothness( q=True, hull=True )

# query default pointsShaded value
pm.displaySmoothness( q=True, dc=True, ps=True )

# query surface divisionsU value
pm.displaySmoothness( q=True, du=True )

# Only the -pointsWire flag works on curves.
pm.circle()

# change the number of points displayed per curve span.
pm.displaySmoothness( pw=3 )
# query default pointsWire value for curves.
pm.displaySmoothness( q=True, dc=True, pw=True )

pm.polyCube()

# Query the display resolution
pm.displaySmoothness( q=True, polygonObject=True )
# Result: 0

# Change the display resolution
pm.displaySmoothness( polygonObject=2 )

Previous topic

pymel.core.general.displayRGBColor

Next topic

pymel.core.general.displayStats

Core

Core Modules

Other Modules

This Page