Go to: Synopsis. Return value. Related.
Flags. Python
examples.
loft( curve curve [curve...] , [autoReverse=boolean], [caching=boolean], [close=boolean], [constructionHistory=boolean],
[createCusp=boolean],
[degree=int], [name=string], [nodeState=int], [object=boolean], [polygon=int], [range=boolean], [rebuild=boolean], [reverse=boolean], [reverseSurfaceNormals=boolean],
[sectionSpans=int],
[uniform=boolean])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
loft is undoable, queryable, and editable.
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.
| string[] |
Object name and node name |
In query mode, return type is based on queried flag.
multiProfileBirailSurface
autoReverse, caching, close,
constructionHistory,
createCusp, degree, name, nodeState, object,
polygon, range,
rebuild, reverse, reverseSurfaceNormals, sectionSpans, uniform
| Long name (short name) |
Argument types |
Properties |
uniform(u) |
boolean |
   |
|
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 |
|
close(c) |
boolean |
|
|
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 |
|
degree(d) |
int |
|
|
The degree of the resulting surface
Default: 3 |
|
autoReverse(ar) |
boolean |
|
|
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 |
|
reverse(r) |
boolean |
 |
|
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) |
boolean |
|
|
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 |
|
|
The number of surface spans between consecutive curves in the
loft.
Default: 1 |
|
createCusp(cc) |
boolean |
|
|
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 |
caching(cch) |
boolean |
|
|
Modifies the node caching mode. See the node documentation for
more information.
Note: For advanced users only. |
|
nodeState(nds) |
int |
|
|
Modifies the node state. See the node documentation for more
information.
Note: For advanced users only. |
|
| Common flags |
name(n) |
string |
|
|
Name the resulting object |
|
constructionHistory(ch) |
boolean |
|
|
Turn the construction history on or off |
|
object(o) |
boolean |
|
|
Create the result, or just the dependency node |
|
polygon(po) |
int |
|
|
The value of this argument controls the type of the object
created by this operation
- 0: nurbs surface
- 1: polygon (use nurbsToPolygonsPref to set the parameters for
the conversion)
- 2: subdivision surface (use nurbsToSubdivPref to set the
parameters for the conversion)
- 3: Bezier surface
- 4: subdivision surface solid (use nurbsToSubdivPref to set the
parameters for the conversion)
|
|
range(rn) |
boolean |
|
|
Force a curve range on complete input curve |
|
rebuild(rb) |
boolean |
|
|
Rebuild the input curve(s) before using them in the operation.
Use nurbsCurveRebuildPref to set the parameters for the
conversion. |
|
| 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
# 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.
cmds.curve( d=3, p=( (-11, 0, 0), (-13, 0, -4), (-17, 0, -15), (-4.7, 0, -10), (1, 0, -8 ) ) )
# Result: curve1 #
cmds.curve( d=3, p=( (-2, 0, 5), (-2, 0, 3), (-2, 0, -1), (4, 0, 0), (7, 0, 0 ) ) )
# Result: curve2 #
cmds.loft( 'curve1', 'curve2', ch=True, rn=True, ar=True )