SelectConstrainedObjects
 
 
 

SelectConstrainedObjects

Introduced

v3.0

Description

Resets the Selection to contain any objects that are constrained to the specified or selected object.

Scripting Syntax

SelectConstrainedObjects( [ConstrainingObj] );

Parameters

Parameter Type Description
ConstrainingObj String or X3DObject Object which is constraining other objects

Default Value: Current selection

Examples

JScript Example

/*
        This example demonstrates the SelectConstrainingObjects and 
        SelectConstrainedObjects commands.
*/
NewScene( null, false ) ;
var oRoot0 = Create2DSkeleton( 0, -0.2, 3.0, 0, 2, 0.2, 0, 90, 0, 4 );
var oRoot1 = Create2DSkeleton( 0, -1, 2.0, 0, 4, 0.1, 0, 90, 0, 4 ) ;
var oCube = ActiveSceneRoot.AddGeometry( "Cube", "MeshSurface" ) ;
// Constrain both skeletons to the cube
ApplyCns( "Position",oRoot0.Effector, oCube ) ;
ApplyCns( "Position",oRoot1.Effector, oCube ) ;
// Give the constrained object, select its constrainer
SelectConstrainingObjects( oRoot1.Effector )
// Expect "cube"
Logmessage( Selection.GetAsText() ) ;
// Give the Constrainer select the constrained objects
SelectConstrainedObjects( oCube ) ;
// Expect "eff1,eff"
LogMessage( Selection.GetAsText() ) ;

See Also

Constraint Kinematics.Constraints ApplyCns GetConstrainedObjects SelectConstrainingObjects