pymel.core.modeling.extendCurve

extendCurve(*args, **kwargs)

This command extends a curve or creates a new curve as an extension

Flags:
Long name (short name) Argument Types Properties
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.
constructionHistory (ch) bool ../../../_images/create.gif
 
Turn the construction history on or off
curveOnSurface (cos) bool ../../../_images/create.gif
 
If possible, create 2D curve as a result
distance (d) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The distance to extend Used only for extendMethod is byDistance.Default:1
extendMethod (em) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The method with which to extend: 0 - based on distance, 2 - to a 3D pointDefault:0
extensionType (et) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The type of extension: 0 - linear, 1 - circular, 2 - extrapolateDefault:0
inputPoint (ip) float, float, float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The point to extend to (optional)
join (jn) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
If true, join the extension to original curveDefault:true
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.

noChanges (nc) bool  
   
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.Common flags
object (o) bool ../../../_images/create.gif
 
Create the result, or just the dependency node
pointX (px) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
X of the point to extend toDefault:0
pointY (py) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Y of the point to extend toDefault:0
pointZ (pz) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Z of the point to extend toDefault:0
range (rn) bool ../../../_images/create.gif
 
Force a curve range on complete input curveFlag can appear in Create mode of commandFlag can have multiple arguments, passed either as a tuple or a list.
removeMultipleKnots (rmk) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
If true remove multiple knots at join Used only if join is true.Default:falseAdvanced flags
replaceOriginal (rpo) bool ../../../_images/create.gif
 
Create “in place” (i.e., replace)
start (s) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Which end of the curve to extend. 0 - end, 1 - start, 2 - bothDefault:1

Derived from mel command maya.cmds.extendCurve

Example:

import pymel.core as pm

# to extend the start of a curve with a line of distance 3
pm.extendCurve( em=0, et=0, s=True, d=3.0 )

# to extend the end of a curve to a point
pm.extendCurve( em=2, s=False, ip=(1, 2, 3) )

Previous topic

pymel.core.modeling.editMetadata

Next topic

pymel.core.modeling.extendSurface

Core

Core Modules

Other Modules

This Page