Go to: Synopsis. Return value. Flags. Python examples.
curveEditorCtx([direction=int], [exists=boolean], [history=boolean], [image1=string], [image2=string], [image3=string], [name=string], [relativeTangentSize=float], [title=string])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
curveEditorCtx is undoable, queryable, and editable.
The curveEditorCtx command creates a new NURBS editor context, which
is used to edit a NURBS curve or surface.
| string | (name of the new context) |
In query mode, return type is based on queried flag.
direction, exists, history, image1, image2, image3, name, relativeTangentSize, title
| Long name (short name) |
Argument types |
Properties |
|
direction(dir)
|
int
|
|
|
Query the current direction of the tangent control. Always
zero for the curve case. In the surface case, its 0 for the normal
direction, 1 for U direction and 2 for V direction.
|
|
exists(ex)
|
boolean
|
|
|
Returns true or false depending upon whether the
specified object exists. Other flags are ignored.
|
|
history(ch)
|
boolean
|
|
|
If this is a tool command, turn the construction history on
for the tool in question.
|
|
image1(i1)
|
string
|
|
|
First of three possible icons representing the tool
associated with the context.
|
|
image2(i2)
|
string
|
|
|
Second of three possible icons representing the tool
associated with the context.
|
|
image3(i3)
|
string
|
|
|
Third of three possible icons representing the tool
associated with the context.
|
|
name(n)
|
string
|
|
|
If this is a tool command, name the tool appropriately.
|
|
relativeTangentSize(rts)
|
float
|
|
|
Relative size of the tangent manipulator handle. Helps
to adjust as the surface parameterization controls the size of the
tangent, even if the shape of the surface remains the same.
The default is 4.
|
|
title(t)
|
string
|
|
|
|
|
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
# Create a curve
cmds.curve(p=[(0, 0, 0), (3, 5, 6), (5, 6, 7), (9, 9, 9), (12, 10, 2)], k=[0,0,0,1,2,2,2])
# Result: curve1 #
# Create a new curve editor context to modify the curve, then switch to it
# You can modify the curve using the manipulator handle
cmds.curveEditorCtx('curveEditorCtx1')
cmds.setToolTo('curveEditorCtx1')