pymel.core.context.curveSketchCtx

curveSketchCtx(*args, **kwargs)

The curveSketchCtx command creates a new curve sketch context, also known as the pencil context.

Flags:

Long Name / Short Name Argument Types Properties
degree / d int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Valid values are 1 or 3
exists / ex bool ../../../_images/create.gif
  Returns true or false depending upon whether the specified object exists. Other flags are ignored.
history / ch bool ../../../_images/create.gif
  If this is a tool command, turn the construction history on for the tool in question.
image1 / i1 unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  First of three possible icons representing the tool associated with the context.
image2 / i2 unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Second of three possible icons representing the tool associated with the context.
image3 / i3 unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Third of three possible icons representing the tool associated with the context.
name / n unicode ../../../_images/create.gif
  If this is a tool command, name the tool appropriately. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.curveSketchCtx

Example:

import pymel.core as pm

# To create a new sketch context, which creates degree 3 curves:
pm.curveSketchCtx( "pencilContext", degree=3 )
# Result: u'pencilContext' #
pm.setToolTo("pencilContext")

# To query the degree of an existing context:
pm.curveSketchCtx( "pencilContext",q=True, degree=True )
# Result: 3 #

# To edit the degree of an existing context:
pm.curveSketchCtx( "pencilContext", e=True, degree=1 )
# Result: u'pencilContext' #