Introduced
1.0
Description
Creates a copy of the specified (or selected) objects.
Scripting Syntax
Duplicate( [InputObjs], [NbItems], [History], [Hierarchy], [Grouping], [Properties], [Animation], [Constraints], [Selection], [Xfrom], [Sx], [Sy], [Sz], [Rx], [Ry], [Rz], [Tx], [Ty], [Tz], [TrackXform], [TextureSupports] )
Parameters
|
Parameter |
Type |
Description |
|
InputObjs [in/out] |
List of objects to duplicate Default Value: Current selection |
|
|
NbItems [in/out] |
Number of items to duplicate Default Value: 1 |
|
|
History [in/out] |
How to duplicate object construction history Default Value: siDuplicateHistory |
|
|
Hierarchy [in/out] |
How to parent duplicate Default Value: siNoParent |
|
|
Grouping [in/out] |
How to group duplicated object Default Value: siNoGrouping |
|
|
Properties [in/out] |
How to duplicate properties Default Value: siDuplicateProperties |
|
|
Animation [in/out] |
How to duplicate animation Default Value: siDuplicateAnimation |
|
|
Constraints [in/out] |
How to duplicate constraints Default Value: siDuplicateConstraints |
|
|
Selection [in/out] |
How to select duplicated objects Default Value: siSetSelection |
|
|
Xfrom [in/out] |
How to distribute duplicated objects using transform Default Value: siGlobalXForm |
|
|
Sx [in/out] |
Number |
Scaling x value Default Value: 1.0 |
|
Sy [in/out] |
Number |
Scaling y value Default Value: 1.0 |
|
Sz [in/out] |
Number |
Scaling z value Default Value: 1.0 |
|
Rx [in/out] |
Number |
Rotation x value Default Value: 0.0 |
|
Ry [in/out] |
Number |
Rotation y value Default Value: 0.0 |
|
Rz [in/out] |
Number |
Rotation z value Default Value: 0.0 |
|
Tx [in/out] |
Number |
Translation x value Default Value: 0.0 |
|
Ty [in/out] |
Number |
Translation y value Default Value: 0.0 |
|
Tz [in/out] |
Number |
Translation z value Default Value: 0.0 |
|
TrackXform [in/out] |
Track placement. Default Value: True |
|
|
TextureSupports [in/out] |
How to duplicate texture supports Default Value: siDuplicateSelectedTextureSupports |
Return Value
Returns an XSICollection object that contains the list of duplicated objects.
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
Autodesk Softimage v7.5