AddControl (X3DObject)

Description

Creates a new control primitive given a preset name/object and a name, the input object(s) are connected to the new control object. A Control object is a non-renderable object that can affect other objects, for example by creating a wave deformation or defining a physical force.

Scripting Syntax

X3DObject.AddControl( Preset, [Items], [Name] )

C# Syntax

X3DObject X3DObject.AddControl( Object in_ctrlPreset, Object in_inputObjects, String in_name );

Parameters

Parameter	Type	Description
Preset	Control Object Primitive Preset	Preset for type of Control Possible Values: • Attractor: Attractor control object • Drag: Drag control object • Eddy: Eddy control object • Fan: Fan control object • Gravity: Gravity control object • SphereVolume: Volume deform control object • ToricForce: Toric force control object • Turbulence: Turbulence control object • Vortex: Vortex control object • Wave: Wave control object • Wind: Wind control object
Items	XSICollection or X3DObject	A collection of X3DObject or a single X3DObject
Name	String	Name of the new control

Return Value

X3DObject

Examples

VBScript Example

NewScene , false
set oRoot = Application.ActiveProject.ActiveScene.Root
set oCube = oRoot.AddGeometry( "Cube", "NurbsSurface" )
set oCone = oRoot.AddGeometry( "Cone", "NurbsSurface" )
set oList = CreateObject("XSI.Collection")
oList.Add oCone
oList.Add oCube
set oControl = oRoot.AddControl( "Wave", oList, "MyWave" )

Autodesk Softimage v7.5