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
degree / d int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  The degree of the resulting surface Default:3
frozen / fzn bool  
   
name / n unicode ../../../_images/create.gif
  Sets the name of the newly-created node. If it contains namespace path, the new node will be created under the specified namespace; if the namespace does not exist, it will be created.
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. Flag can have multiple arguments, passed either as a tuple or a list.
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. Advanced flags
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 Common flags

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')] #