Object Model: ChainRoot.AddBone

ChainRoot.AddBone

Description

Adds a ChainBone element at the end of this chain.

C# Syntax

ChainBone ChainRoot.AddBone( Object in_pNewEffPos, siChainBoneType in_boneType, String in_bstrName );

Scripting Syntax

oReturn = ChainRoot.AddBone( NewEffectorPosition, [BoneType], [Name] );

Return Value

ChainBone

Parameters

Parameter	Type	Description
NewEffectorPosition	Either a SIVector3 or an array containing x,y,z values.	The new effector position.
BoneType	siChainBoneType	The type of bone to add. Default Value: siChainBonePin
Name	String	Name of new chain

Examples

VBScript Example

'VBScript example
'effector for first bone
set oEff1 = XSIMath.CreateVector3()
oEff1.x = 3
oEff1.y = 3
oEff1.z = 3
'effector for second bone
set oEff2 = XSIMath.CreateVector3()
oEff2.x = 6
oEff2.y = 0
oEff2.z = 0
'construct skeleton
set oRoot = ActiveProject.ActiveScene.Root
set oChain = oRoot.Add3dChain()
set oBone1 = oChain.AddBone(oEff1, siChainBonePin, "TheFirstBone")
set oBone2 = oChain.AddBone(oEff2, siChainBoneBallJoint)