X3DObject.Add3DChain

Description

Adds a 3D chain and parents the new chain under this object. A 3D chain has joint properties that can rotate on any axis.

C# Syntax

ChainRoot X3DObject.Add3DChain( Object in_rootPos, Object in_effPos, Object in_normalPlane, String in_bstrName );

Scripting Syntax

oReturn = X3DObject.Add3DChain( [RootPos], [EffectorPos], [ChainNormalPlane], [Name] );

Return Value

ChainRoot

Parameters

Parameter Type Description
RootPos Either an SIVector3 or an Array The root position of the new chain, in global coordinates.

Default Value: (0,0,0)

EffectorPos Either an SIVector3 or an Array The effector position of the new chain, in global coordinates.

Default Value: (1,0,0)

ChainNormalPlane Either an SIVector3 or an Array The chain's normal to the plane, in global coordinates.

Default Value: (0,0,1)

Name String name of new chain

Examples

VBScript Example

NewScene , false
set oRoot = Application.ActiveProject.ActiveScene.Root
set oChain = oRoot.Add3DChain
oRootPos = Array(0,10,0)
oEffPos = Array(10,10,0)
set oChain = oRoot.Add3DChain( oRootPos, oEffPos )

See Also

ChainRoot