pymel.core.modeling.hardenPointCurve

hardenPointCurve(*args, **kwargs)

The hardenPointCurve command changes the knots of a curve given a list of control point indices so that the knot corresponding to that control point gets the specified multiplicity. Multiplicity of -1 is the universal value used for multiplicity equal to the degree of the curve.limitationsThe CV whose multiplicity is being raised needs to have its neighbouring CVs of multiplicity 1. How many neighbours depends on the degree of the curve and the difference in CV multiplicities before and after this operation. For example, if you’re changing a CV of multiplicity 1 into a CV of multiplicity 3, you will need the 4 neighbouring CVs (2 on each side) to be of multiplicity 1. The CVs that do not satisfy that requirement will be ignored.

Flags:

Long name (short name)		Argument Types	Properties
caching (cch)		bool
	Modifies the node caching mode. See the node documentation for more information.Note:For advanced users only.
constructionHistory (ch)		bool
	Turn the construction history on or off
multiplicity (m)		int
	the required multiplicity of the curve knotDefault:-1Advanced flags
name (n)		unicode
	Name the resulting object
nodeState (nds)		int
	Modifies the node state. See the node documentation for more information.Note:For advanced users only.Common flags
object (o)		bool
	Create the result, or just the dependency node
replaceOriginal (rpo)		bool
	Create “in place” (i.e., replace)Flag can appear in Create mode of commandFlag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.hardenPointCurve

Example:

import pymel.core as pm

import maya.cmds as cmds

# Make the example curve.
pm.curve( d=3, p=((-7.253894, 0, 10.835724), (-7.423939, 0, 6.977646), (-7.400778, 0, 2.798971), (-7.458196, 0, -1.524959), (-2.411453, 0, -1.07677), (1.44791, 0, -0.8977448), (5.526346, 0, -0.8610371), (5.740407, 0, 3.780402), (6.293634, 0, 7.571941), (5.957847, 0, 10.72273), (2.753946, 0, 10.894312), (-0.6375988, 0, 11.062571), (-5.889847, 0, 10.940658)), k=(0, 0, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 10, 10) )
# Result: nt.Transform(u'curve1') #

# Raise the ones that you want to have "sharp" corners
pm.hardenPointCurve( 'curve1.cv[3]', 'curve1.cv[6]', 'curve1.cv[9]', ch=True, rpo=True, m=-1 )
# Result: [u'curve1'] #

# Same result, as the in-between CVs are ignored:
pm.undo()
pm.hardenPointCurve( 'curve1.cv[0:12]', ch=1, rpo=1, m=-1 )
# Result: [u'curve1'] #