v3.0

Instantiates objects, with options for multiple instances and additional transform controls.

oReturn = Instantiate( [InputObjs], [NbItems], [Hierarchy], [Grouping], [Selection], [Xfrom], [Sx], [Sy], [Sz], [Rx], [Ry], [Rz], [Tx], [Ty], [Tz], [TrackXform] );

Returns an XSICollection object that contains the list of instances.

Parameter	Type	Description
InputObjs	String	List of objects to instantiate Default Value: Current selection
NbItems	Long	Number of instances to create Default Value: 1
Hierarchy	siDupParent	How to parent instances Default Value: siNoParent
Grouping	siDupGroup	How to group instances Default Value: siNoGrouping
Selection	siDupSelection	How to select instances Default Value: siSetSelection
Xfrom	siDupTransform	How to distribute instances using transform Default Value: siGlobalXForm
Sx	Number	Scaling x value Default Value: 1.0
Sy	Number	Scaling y value Default Value: 1.0
Sz	Number	Scaling z value Default Value: 1.0
Rx	Number	Rotation x value Default Value: 0.0
Ry	Number	Rotation y value Default Value: 0.0
Rz	Number	Rotation z value Default Value: 0.0
Tx	Number	Translation x value Default Value: 0.0
Ty	Number	Translation y value Default Value: 0.0
Tz	Number	Translation z value Default Value: 0.0
TrackXform	Boolean	Track placement. Default Value: True

VBScript Example

' Create 6 instances

' Position them 3 units apart (each duplicate will be translated 3 units along the X axis from its predecessor)

' The transforms are applied relative to the previous duplicate

' For example, if the original is positioned at (0,0,0), then the duplicates are positioned at

' (3,0,0), (6,0,0), (9,0,0),..., (18,0,0)

dim object, list

set object = CreatePrim( "Sphere", "NurbsSurface" )

SetValue object & ".sphere.radius", 1.000

CreateModel "Sphere"

Instantiate "Model", 6, -1, 1, 0, 1, 1, 1, 1, 0, 0, 0, 3, 0, 0, True

SIInstantiate Clone GetMaster GetInstances