alignCurve

Show frames

Go to: Related nodes. Attributes.

Compute the aligned curve(s) given two input curves. One input curve can be aligned to another input curve or both curves can be aligned to each other. If aligning one curve to another then the parameter value (joinParameter) is used to define the position on the other curve where to align to. If aligning both curves together then an end point on each curve is used.
Alignment with positional (positionalContinuity) is always true. The types of positional continuity (positionalContinuityType) are: move first/second/both or modify first/second/both. For "move" the entire curve is moved so its end point coincides with the parameter value on the other curve. For "modify" only an end point is moved to the parameter value.
The tangent and curvature information at the parameter value is used for aligning if the tangent (tangentContinuity) or curvature (curvatureContinuity) option is true. Curvature continuity true implies tangent continuity true as well. If tangent continuity is true, then the tangent scale values (tangentScale1 and tangentScale2) are applied to the appropriate curve based on the tangent type (tangentContinuityType). If one curve is to be modified for tangent continuity then the tangent at its end point is modified to match the tangent at the parameter value of the other curve. If curvature continuity is true, then the curvature scale values (aCurvatureScale1 and aCurvatureScale2) are applied to the appropriate curve as well.

Related nodes

makeTextCurves, offsetCurve, hardenPoint, filletCurve, closeCurve, smoothCurve

Attributes (18)

attach, curvatureContinuity, curvatureScale1, curvatureScale2, inputCurve1, inputCurve2, joinParameter, keepMultipleKnots, outputCurve1, outputCurve2, positionalContinuity, positionalContinuityType, reverse1, reverse2, tangentContinuity, tangentContinuityType, tangentScale1, tangentScale2

Long name (short name)	Type	Default	Flags
attach (at)	bool	false
If true, join the aligned curves together. Otherwise, two curve results are output from the node. NOTE: setting this attribute to random values will cause unpredictable results and is not supported.
curvatureContinuity (cc)	bool	false
Curvature continuity is on if true and off otherwise.
curvatureScale1 (cs1)	double	0.0
Curvature scale applied to curvature of first curve for curvature continuity.
curvatureScale2 (cs2)	double	0.0
Curvature scale applied to curvature of second curve for curvature continuity.
inputCurve1 (ic1)	nurbsCurve	NULL
The first input curve.
inputCurve2 (ic2)	nurbsCurve	NULL
The second input curve.
joinParameter (jnp)	float	123456.0
Parameter on reference curve where modified curve is to be aligned to.
keepMultipleKnots (kmk)	bool	true
If false, remove the multiple knots from the attached curve. Otherwise, the multiple knots are kept. NOTE: setting this attribute to random values will cause unpredictable results and is not supported.
outputCurve1 (oc1)	nurbsCurve	NULL
Output aligned curve one (refers to first input curve). If attach option is true the attached result is in this output.
outputCurve2 (oc2)	nurbsCurve	NULL
Output aligned curve two (refers to second input curve). If attach option is true this output is not available.
positionalContinuity (pc)	bool	true
Positional continuity is on if true and off otherwise.
positionalContinuityType (pct)	enum	1
Positional continuity type legal values: 1 - move first curve, 2 - move second curve, 3 - move both curves, 4 - modify first curve, 5 - modify second curve, 6 - modify both curves
reverse1 (rv1)	bool	false
If true, reverse the first input curve before doing align. Otherwise, do nothing to the first input curve before aligning. NOTE: setting this attribute to random values will cause unpredictable results and is not supported.
reverse2 (rv2)	bool	false
If true, reverse the second input curve before doing align. Otherwise, do nothing to the second input curve before aligning. NOTE: setting this attribute to random values will cause unpredictable results and is not supported.
tangentContinuity (tc)	bool	true
Tangent continuity is on if true and off otherwise.
tangentContinuityType (tct)	enum	1
Tangent continuity type legal values: 1 - do tangent continuity on first curve, 2 - do tangent continuity on second curve
tangentScale1 (ts1)	double	1.0
Tangent scale applied to tangent of first curve for tangent continuity.
tangentScale2 (ts2)	double	1.0
Tangent scale applied to tangent of second curve for tangent continuity.