TYPE: Object
TITLE: Bone Object

A Bone Object is an object that can be used in a kinematic chain

Bones are primarily used in conjunction with CaptureRegion SOPs 
for deforming geometry during animation of skeletal figures. CaptureRegion
is a volume used for deciding which geometry points are affected by 
a bone and how much they are affected by it. The points within the capture
region volume are assigned weights. The position of the capture regions 
are defined by the capture pose parameters, which represent a transformation
that positions bones and capture regions in the capturing arrangement.


Parameters:
Transform
    Overview - This is identical to the Atmosphere object's Transform Tab
               except that certain parameters have been suppressed. 
Bone
    Display Link  - Toggles the displaying of the link geometry	/displaylink
    Rest Angles   - Defines the relative weighting of rotations      /R[xyz]
                    about the bone's x,y,z axis for the Inverse Kinematics
		    solver. These values are relative to the bone's
		    pre-transform.
		    These are zero by default when created from the 
		    object viewer's Bones tool with the pre-transform rotation
		    values defining the rest angles.
    Bone Length   - Changes the length of the bone	/length
    Kinematic Solver - Specifies the CHOP node from which this bone /solver
		       should obtain its cooking rotations from. This requires
		       that the specified CHOP have 3 tracks that are named as:
		       path:rx, path:ry, and path:rz where path is the full
		       path of this bone without the /obj prefix. This path
		       can be obtained using the opsubpath() expression
		       function.

		       If this parameter is non-empty on a bone without custom
		       geometry, then the display geometry of the bone will
		       be different to indicate this.
		       
    Remaining     - The remaining parameters on this page only affect the
                    solutions generated by InverseKin CHOPs using one of the
                    solvers with constraints:
    Dampening     - Affects how quickly this bone's angles can be     /ikdamp
                    changed.
    Angle Range   - Specifies the minimum and maximum  /begin[xyz]range
		    rotation angles that this bone can     /end[xyz]range
		    have in each axis. (Only used by IK w/Constraints solver)
    Damping Angle - Applies damping to the rotation of the bone    /[xyz]damp
                    when the rotation in each axis falls within the specified
                    angle of its minimum or maximum value. The damping occurs
		    when the solved angle is within this angle value from the
		    angle range.
		    (Only used by IK w/Constraints solver)
    Damping Rolloff - Specifies the rate at which damping    /[xyz]rolloff
                    increases as the rotation varies within the damping angle
                    of the minimum or maximum angles. This can also be thought
		    of as the linear slope value at the damping angle region.
		    (Only used by IK w/Constraints solver)
Capture
    Capture Region
        Display Capture Region - Toggles the display of the	/displaycapture
			     capture region
	Capture Region Center   - Position of the center of the bone's  
							    /ccrcenter[xyz]
		      capture region.  Note that this co-ordinate in
		      object-space. Also the z component uses a bone length
		      as a multiplier, thus 0.5 equals half way along the bone.
	Capture Region Rotates - rotation of the capture region /ccrrotate[xyz]
	Capture Region Scales   - Scaling factors.
		     Scaling is performed about the bone local
		      origin in the directions of the local reference frame
		      axes.				    /ccrscale[xyz]
	Capture Top Height    - Height of the capture region from the 
							    /crtopheight
		      center to the top cap.
	Capture Top Cap - X,Y,Z radii of the top hemisphere /ccrtopcap[xyz]
	Capture Bottom Height   - Height of the region from the center 
							    /ccrbotheight
		      to the bottom cap
	Capture Bottom Cap - X,Y,Z radii of the bottom hemisphere
							    /ccrbotcap[xyz]
    Deform Region
		    This tab contains similar parameters as capture regions,
		    but they are used for animation and deformation of captured
		    geometry. Notably, the scaling factors can be used to 
		    squash and stretch the capture regions during animation.
	    
    Capture Bone Length    - the length of a bone in the capture mode. This is
		      the bone length when a bone is used for capturing
		      geometry. Note that the capture mode can be
		      turned on by selecting "Settings > Objects > 
		      Kinematic Override: capture" from the main menu.	
								/captposelen
    Capture Bone Translate - the translation of the bone in the capture mode.
    Capture Bone Rotate    - the rotation angles of the bone in the capture
		      mode. Note that the bone rotation axis order is ZYX. 
		      Rotation together with Translate and Scale parameters
		      form a transformation that positions a bone in the 
		      capture position and orientation with respect to the
		      world space. The transform order for this 
		      transformation is Scale, Rotate, Translate.
							   /captposer[xyz]
    Capture Bone Scale  - the scaling of the bone in the capture mode 
							   /captposes[xyz]

Shading
    Overview          - Please refer to the Geometry object Shading Tab.
Render
    Overview          - Please refer to the Ambient object Render Tab.
Misc
    Overview          - Please refer to the the Camera object Misc Tab.

See also: InverseKin CHOP(../chop/inversekin)
