pymel.core.modeling.nurbsToPoly

static modeling.nurbsToPoly(*args, **kwargs)

This command tesselates a NURBS surface and produces a polygonal surface. The name of the new polygonal surface is returned. If construction history is ON, then the name of the new dependency node is returned as well.

Flags:
Long name (short name) Argument Types Properties
caching (cch) bool  
   
chordHeight (cht) float ../../../_images/query.gif ../../../_images/edit.gif
 

Chord height is the absolute distance in OBJECT space which the center of a polygon edge can deviate from the actual center of the surface span. Only used if Format is General and if useChordHeight is true. Default:0.1

chordHeightRatio (chr) float ../../../_images/query.gif ../../../_images/edit.gif
 

Chord height ratio is the ratio of the chord length of a surface span to the chord height. (This is a length to height ratio). 0 is a very loose fit. 1 is a very tight fit. (See also description of chord height.) Always used if Format is Standard Fit. Otherwise, only used if Format is General and useChordHeightRatio is true. Default:0.9

constructionHistory (ch) bool ../../../_images/create.gif
 
Turn the construction history on or off
curvatureTolerance (cvt) int  
   
delta (d) float ../../../_images/query.gif ../../../_images/edit.gif
 
3D delta. Only used if Format is Standard Fit. Default:0.1
edgeSwap (es) bool ../../../_images/query.gif ../../../_images/edit.gif
 

Edge swap. This attribute enables an algorithm which determines the optimal method with which to tessellate a quadrilateral into triangles. Only used if Format is General. Default:false

explicitTessellationAttributes (eta) bool  
   
format (f) int ../../../_images/query.gif ../../../_images/edit.gif
 
Format: 0 - Triangle Count, 1 - Standard Fit, 2 - General, 3 - CVs Default:1
fractionalTolerance (ft) float ../../../_images/query.gif ../../../_images/edit.gif
 
Fractional tolerance. Only used if Format is Standard Fit. Default:0.01
matchNormalDir (mnd) bool ../../../_images/query.gif ../../../_images/edit.gif
 
Only used when the format is CVs. Order the cvs so that the normal matches the direction of the original surface if set to true. Default:false
matchRenderTessellation (mrt) bool  
   
minEdgeLength (mel) float ../../../_images/query.gif ../../../_images/edit.gif
 
Minimal edge length. Only used if Format is Standard Fit. Default:0.001
name (n) unicode ../../../_images/create.gif
 
Name the resulting object
nodeState (nds) int  
   
normalizeTrimmedUVRange (ntr) bool ../../../_images/query.gif ../../../_images/edit.gif
 

This attribute is only applicable when a trimmed NURBS surface is used as the input surface. When true, the UV texture coordinates on the trimmed input surface are normalized and applied to the output surface as they are for the untrimmed version of the input surface. (The texture coordinates on the entire untrimmed surface are mapped to the entire output surface.) When false, the UV texture coordinates on the trimmed input surface are applied to the output surface as they are for the trimmed input surface. (Only the texture coordinates visible on the trimmed input surface are mapped to the output surface.) Default:true Common flags

object (o) bool ../../../_images/create.gif
 
Create the result, or just the dependency node Flag can have multiple arguments, passed either as a tuple or a list.
polygonCount (pc) int ../../../_images/query.gif ../../../_images/edit.gif
 
The number of polygons to produce. Only used if Format is Triangle Count. Default:200
polygonType (pt) int ../../../_images/query.gif ../../../_images/edit.gif
 
Polygon type: 0 - Triangles, 1 - Quads Default:0
smoothEdge (ues) bool  
   
smoothEdgeRatio (esr) float  
   
uDivisionsFactor (nuf) float  
   
uNumber (un) int ../../../_images/query.gif ../../../_images/edit.gif
 
Initial number of isoparms in U. Used in conjunction with the uType attribute. Only used if Format is General. Default:3
uType (ut) int ../../../_images/query.gif ../../../_images/edit.gif
 

Initial U type tessellation criteria (3 types). Type 0 - Per surface # of isoparms in 3D. This type places a specific number of iso-parametric subdivision lines across the surface, equally spaced in 3D space. Type 1 - Per surface # of isoparms. This type places a specific number of iso-parametric subdivision lines across the surface, equally spaced in parameter space. Type 2 - Per span # of isoparms. This type places a specific number of iso-parametric subdivision lines across each surface span, equally spaced in parameter space. (This is the closest option to the Alias Studio tessellation parameters.) This attribute is only used if Format is General. Default:3

useChordHeight (uch) bool ../../../_images/query.gif ../../../_images/edit.gif
 
True means use chord height. Only used if Format is General. Default:false
useChordHeightRatio (ucr) bool ../../../_images/query.gif ../../../_images/edit.gif
 
True means use chord height ratio. Default:true
useSurfaceShader (uss) bool  
   
vDivisionsFactor (nvf) float  
   
vNumber (vn) int ../../../_images/query.gif ../../../_images/edit.gif
 
Initial number of isoparms in V. Used in conjunction with the vType attribute. Only used if Format is General. Default:3
vType (vt) int ../../../_images/query.gif ../../../_images/edit.gif
 
Initial V type tessellation criteria (3 types). See description for the uType attribute. Only used if Format is General. Default:3

Derived from mel command maya.cmds.nurbsToPoly

Example:

import pymel.core as pm

# To create a new polygonal surface from a NURBS surface:
pm.nurbsToPoly( 'nurbsSphere1' )

# To create a new polygonal surface from a NURBS surface with
# history so that the tesselation can be edited afterwards:
pm.nurbsToPoly( 'nurbsSphere1', ch=True )

Previous topic

pymel.core.modeling.nurbsSquare

Next topic

pymel.core.modeling.nurbsToPolygonsPref

Core

Core Modules

Other Modules

This Page