Go to: Synopsis. Return value. Flags. Python examples.
extendCurve( object , [caching=boolean], [constructionHistory=boolean],
[curveOnSurface=boolean],
[distance=linear], [extendMethod=int], [extensionType=int], [inputPoint=[linear, linear, linear]],
[join=boolean], [name=string], [nodeState=int], [object=boolean], [pointX=linear], [pointY=linear], [pointZ=linear], [range=boolean], [removeMultipleKnots=boolean],
[replaceOriginal=boolean],
[start=int])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
extendCurve is undoable, queryable, and editable.
This command extends a curve or creates a new curve as an extension
| string[] |
Object name and node name |
In query mode, return type is based on queried flag.
caching, constructionHistory, curveOnSurface, distance, extendMethod, extensionType, inputPoint, join,
name, nodeState, object,
pointX, pointY,
pointZ, range,
removeMultipleKnots,
replaceOriginal, start
| Long name (short name) |
Argument types |
Properties |
inputPoint(ip) |
[linear, linear, linear] |
   |
|
The point to extend to (optional) |
|
pointX(px) |
linear |
|
|
X of the point to extend to
Default: 0 |
|
pointY(py) |
linear |
|
|
Y of the point to extend to
Default: 0 |
|
pointZ(pz) |
linear |
|
|
Z of the point to extend to
Default: 0 |
|
extensionType(et) |
int |
|
|
The type of extension: 0 - linear, 1 - circular, 2 -
extrapolate
Default: 0 |
|
extendMethod(em) |
int |
|
|
The method with which to extend: 0 - based on distance, 2 - to
a 3D point
Default: 0 |
|
start(s) |
int |
|
|
Which end of the curve to extend. 0 - end, 1 - start, 2 -
both
Default: 1 |
|
join(jn) |
boolean |
|
|
If true, join the extension to original curve
Default: true |
|
distance(d) |
linear |
|
|
The distance to extend Used only for extendMethod is
byDistance.
Default: 1 |
|
removeMultipleKnots(rmk) |
boolean |
|
|
If true remove multiple knots at join Used only if join is
true.
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 |
|
replaceOriginal(rpo) |
boolean |
|
|
Create "in place" (i.e., replace) |
|
curveOnSurface(cos) |
boolean |
|
|
If possible, create 2D curve as a result |
|
range(rn) |
boolean |
|
|
Force a curve range on complete input curve |
|
| 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
# to extend the start of a curve with a line of distance 3
cmds.extendCurve( em=0, et=0, s=True, d=3.0 )
# to extend the end of a curve to a point
cmds.extendCurve( em=2, s=False, ip=(1, 2, 3) )