
 ******************************************************************************
 * splineIK.ms - Creates a splineIK chain similar to Mayas using a spline Line 
 *		path, and multiple new IK bone chains path constrained to the path at 
 *		increasing percentages.
 *
 ******************************************************************************
 * Copyright 2001 Michael B. Comet  All Rights Reserved.
 ******************************************************************************
 *
 * Version 1.00 - July 7, 2001 - Michael B. Comet - www.comet-cartoons.com
 * Version 1.01 - July 18, 2001 - Michael B. Comet - www.comet-cartoons.com
 *		- Got a release version ready, with offset functionality.
 *
 ******************************************************************************
 * 
 * Notes:
 *   Pick Path:  Choose a spline LINE...must be a line and not a circle etc...
 *		Editable Spline is OK, so you can take an NGon or Circle and 
 *		convert it.
 *
 *   Num Bones:	This is the number of bones chains that will be created along 
 *		the path.  Typically you want at least 3 times as many bones as 
 *		there are control point curves on your path/spline.
 *
 *   Allow Bone Separation: 
 *	ON: Each bone chain keeps is general position along	the path, even 
 *		when the path shortens or lengthens.  This method is much much 
 *		more *stable* when the joint chain is animated, even if it 
 *		becomes a little shorter than its original length.  This is the 
 *		Preferred default.
 * 	OFF: Each bone chain is point constrained to the previous bone 
 *		before it.  This means your chain will never accidentally 
 *		stretch or lengthen, but odd  things can happen such as 
 *		"jitter", or it may appear offset from path, if the	path length 
 *		does not match the original size and bone chain length.
 *
 *   Pick Control Object:  This object if chosen will receive the custom 
 *	"roll",	"twist"	and "offset" attributes on it's base level.  If
 *	not chosen, then the line curve itself receives these attributes 
 *	(which could be	wired to a different control later on).
 *
 *   Path Length: This is just a little display to show how long the chain 
 *	will be.
 *
 *   Create Spline IK: Once a path has been chosen, this button actually does 
 *	the work of creating a splineIK bone system, that can be used for 
 *			skinning.
 *
 ******************************************************************************
 *
 *   AFTER SplineIK Creation:
 *
 *		As mentioned above, after creating the bone chain, three attributes 
 *		are added to the specified "Control Object", or to the "Spline Path" 
 *		itself if no control object	was specified.
 *
 *		These attributes are called and function as follows:
 *
 *		roll	=	This attribute control the overall spin of each bone in the
 *					chain.  If the bone system is used say as a tail for a 
 *					character, you will need to animate this if the character
 *					rolls or pitches to keep things correct.
 *
 *		twist 	=	This also adjusts the spin of each bone, but as an 
 *					increasing twist along the length of the chain, with very
 *					little spin towards the base, and more and more towards 
 *					the end.  Useful say, if used for a neck type control, and
 *					you want the end with the head to spin, but not the base
 *					where the chain would attach to the characters body.
 *
 *		offset	=	Mostly applicable only when the path is a closed loop like
 *					a circle.  This allows you to effectively "slide" the 
 *					entire chain, along the length 100% forward or back.  For
 *					example on a circle type path, this value could be 
 *					animated to get the chain to move along the path like a 
 *					tire or tank tread.
 *
 ******************************************************************************
 *
 *   Advice: You will probably want to use the "Linked XForm" modifier to
 *			get easy control/animation grabbable objects to be used to 
 *			actually deform the spline path, as shown in the example file.
 *
 ******************************************************************************
