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