Go to: Synopsis. Return value. Keywords. Flags. Python examples.
convertTessellation([allCameras=boolean], [camera=name])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
convertTessellation is undoable, NOT queryable, and NOT editable.
Command to translate the basic tessellation attributes to advanced.
If a camera flag is specified the translation will be based on the distance
the surface is from the camera. The closer the surface is to the camera the
more triangles there will be in the tessellation. If the "-allCameras" flags
is specified, the renderable camera closest to the surface will be used to
set the tessellation. The camera tessellation estimate is also dependent on
the current render resolution; a higher resolution the result in a more
finely tessellated surface.
Multiple NURB surfaces may be specified on the command line, or if no
command arguments are specified the surfaces on the active list will be
used.
This command operates by calculating the chord height such that smooth
tessellation is achieved when the surface is rendered. The advanced
tessellation setting will be enabled on each surface specified, the
primary tessellation parameters will be set, and chord height will be
used as the secondary criteria.
| boolean | Success or Failure. |
tessellation
allCameras, camera
| Long name (short name) |
Argument types |
Properties |
allCameras(acm)
|
boolean
|
|
|
Specifies that all renderable cameras should be used in calculating
the screen based tessellation.
|
|
camera(cam)
|
name
|
|
|
Specifies the camera which should be used in calculating the screen
based tessellation.
|
|
|
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 have multiple arguments, passed either as a tuple or a list.
|
import maya.cmds as cmds
# Convert the basic tessellation settings to advanced.
cmds.convertTessellation( 'nurbsSphere1' )
# Set the tessellation for nurbsSphere1 based on camera projection
# from persp.
cmds.convertTessellation( 'nurbsSphere1', camera='persp' )
# Set tessellation based on all renderable cameras.
cmds.convertTessellation( 'nurbsSphere2', allCameras='nurbsSphere1' )
# Set the tessellation for all selected objects.
cmds.convertTessellation()