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 |
|
distance(d)
|
linear
|
|
|
The distance to extend
Used only for extendMethod is byDistance.
Default: 1
|
|
extendMethod(em)
|
int
|
|
|
The method with which to extend:
0 - based on distance,
2 - to a 3D point
Default: 0
|
|
extensionType(et)
|
int
|
|
|
The type of extension:
0 - linear,
1 - circular,
2 - extrapolate
Default: 0
|
|
inputPoint(ip)
|
[linear, linear, linear]
|
|
|
The point to extend to (optional)
|
|
join(jn)
|
boolean
|
|
|
If true, join the extension to original curve
Default: true
|
|
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
|
|
removeMultipleKnots(rmk)
|
boolean
|
|
|
If true remove multiple knots at join
Used only if join is true.
Default: false
|
|
start(s)
|
int
|
|
|
Which end of the curve to extend.
0 - end,
1 - start,
2 - both
Default: 1
|
|
Common flags |
constructionHistory(ch)
|
boolean
|
|
|
Turn the construction history on or off.
|
|
curveOnSurface(cos)
|
boolean
|
|
|
If possible, create 2D curve as a result.
|
|
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.
|
|
object(o)
|
boolean
|
|
|
Create the result, or just the dependency node.
|
|
range(rn)
|
boolean
|
|
|
Force a curve range on complete input curve.
|
|
replaceOriginal(rpo)
|
boolean
|
|
|
Create "in place" (i.e., replace).
|
|
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.
|
|
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) )