pymel.core.modeling.loft

loft(*args, **kwargs)

This command computes a skinned (lofted) surface passing through a number of NURBS curves. There must be at least two curves present. The NURBS curves may be surface isoparms, curve on surfaces, trimmed edges or polygon edges.

Flags:
Long name (short name) Argument Types Properties
autoReverse (ar) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

If set to true, the direction of the curves for the loft is computed automatically. If set to false, the values of the multi-use reverse flag are used instead. Default:true

caching (cch) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Modifies the node caching mode. See the node documentation for more information. Note:For advanced users only.
close (c) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

If set to true, the resulting surface will be closed (periodic) with the start (end) at the first curve. If set to false, the surface will remain open. Default:false

constructionHistory (ch) bool ../../../_images/create.gif
 
Turn the construction history on or off
createCusp (cc) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

Multi-use flag; each occurence of the flag refers to the matching curve in the loft operation; if the flag is set the particular profile will have a cusp (tangent break) in the resulting surface. Default:false Advanced flags

degree (d) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The degree of the resulting surface Default:3
name (n) unicode ../../../_images/create.gif
 
Name the resulting object
nodeState (nds) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Modifies the node state. See the node documentation for more information. Note:For advanced users only. Common flags
object (o) bool ../../../_images/create.gif
 
Create the result, or just the dependency node
polygon (po) int ../../../_images/create.gif
 

The value of this argument controls the type of the object created by this operation 0: nurbs surface1: polygon (use nurbsToPolygonsPref to set the parameters for the conversion)2: subdivision surface (use nurbsToSubdivPref to set the parameters for the conversion)3: Bezier surface4: subdivision surface solid (use nurbsToSubdivPref to set the parameters for the conversion)

range (rn) bool ../../../_images/create.gif
 
Force a curve range on complete input curve
rebuild (rb) bool ../../../_images/create.gif
 

Rebuild the input curve(s) before using them in the operation. Use nurbsCurveRebuildPref to set the parameters for the conversion. Flag can have multiple arguments, passed either as a tuple or a list.

reverse (r) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

Multi-use flag; each occurence of the flag refers to the matching curve in the loft operation; if the flag is set the particular curve will be reversed before being used in the loft operation. Default:false

reverseSurfaceNormals (rsn) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
If set, the surface normals on the output NURBS surface will be reversed. This is accomplished by swapping the U and V parametric directions. Default:false
sectionSpans (ss) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The number of surface spans between consecutive curves in the loft. Default:1
uniform (u) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

If set to true, the resulting surface will have uniform parameterization in the loft direction. If set to false, the parameterization will be chord length. Default:false

Derived from mel command maya.cmds.loft

Example:

import pymel.core as pm

# A loft across two curves: curve1, curve2. Curve ranges
# have been enabled on the curves. The curves will be reversed
# internally if needed to avoid a bowtie looking surface.
pm.curve( d=3, p=( (-11, 0, 0), (-13, 0, -4), (-17, 0, -15), (-4.7, 0, -10), (1, 0, -8 ) ) )
# Result: nt.Transform(u'curve1') #
pm.curve( d=3, p=( (-2, 0, 5), (-2, 0, 3), (-2, 0, -1), (4, 0, 0), (7, 0, 0 ) ) )
# Result: nt.Transform(u'curve2') #
pm.loft( 'curve1', 'curve2', ch=True, rn=True, ar=True )
# Result: [nt.Transform(u'loftedSurface1'), nt.Loft(u'loft1')] #

Previous topic

pymel.core.modeling.intersect

Next topic

pymel.core.modeling.makeSingleSurface

Core

Core Modules

Other Modules

This Page