Duplicate

Introduced

v1.0

Description

Creates a copy of the specified (or selected) objects.

Scripting Syntax

oReturn = Duplicate( [InputObjs], [NbItems], [History], [Hierarchy], [Grouping], [Properties], [Animation], [Constraints], [Selection], [Xfrom], [Sx], [Sy], [Sz], [Rx], [Ry], [Rz], [Tx], [Ty], [Tz], [TrackXform], [TextureSupports] );

Return Value

Returns an XSICollection object that contains the list of duplicated objects.

Parameters

Parameter Type Description
InputObjs String List of objects to duplicate

Default Value: Current selection

NbItems Long Number of items to duplicate

Default Value: 1

History siDupHistory How to duplicate object construction history

Default Value: siDuplicateHistory

Hierarchy siDupParent How to parent duplicate

Default Value: siNoParent

Grouping siDupGroup How to group duplicated object

Default Value: siNoGrouping

Properties siDupProperty How to duplicate properties

Default Value: siDuplicateProperties

Animation siDupAnimation How to duplicate animation

Default Value: siDuplicateAnimation

Constraints siDupConstraint How to duplicate constraints

Default Value: siDuplicateConstraints

Selection siDupSelection How to select duplicated objects

Default Value: siSetSelection

Xfrom siDupTransform How to distribute duplicated objects 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

TextureSupports siDupTextureSupport How to duplicate texture supports

Default Value: siDuplicateSelectedTextureSupports

Examples

VBScript Example

' Create 6 duplicates

' 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)

CreatePrim "Sphere", "NurbsSurface"

SetValue ".sphere.radius", 1.000

Duplicate "Sphere", 6, , , , , , , , siApplyRepeatXForm, 1, 1, 1, 0, 0, 0, 3, 0, 0

See Also

Instantiate SIDuplicate