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
|
|
|
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.
|
|
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) )