=====DuplicateObject=====
====Summary====

This function allows you to create a duplicate of an already existing asset. You may also rename the new duplicate, change its position or parent it to another asset.

====Parameters====

===Target===

//Type: Text
Default: None//

Specifies the //name// or ARDI ID of another asset to duplicate. If using an asset ID, begin the target with the '#' character.

===Name===

//Type: Text
Default: None//

This parameter allows you to specify a name for the new asset created after duplication.

===Position===

//Type: [[XYZ Coordinates]]
Default: 0,0,0//

The co-ordinates in which to place the asset within the 3D world. Co-ordinates are defined as "x,y,z", separated by a ',' and no spaces.

===AttachTo===

//Type: Text
Default: None//

Specifies the //name// or ARDI ID of another asset for which this asset is to be parented to. If using an asset ID, begin the target with the '#' character. //This parameter is optional//

If defined, this asset will be parented to the specified asset and it's //position// will be converted to local co-ordinates around the parent asset.

====See Also====

[[addshape]] [[addmesh]] [[addbeacon]] [[addparticle]] [[remove]]

====Examples====

<code>
<duplicateobject Target="SomeObject"  Position="10,0,10" Name="NewObject" />
</code>

> This function will find an asset called **SomeObject** and create a duplicate. It will place the duplicate at the respective x,y,z coordinates 10,0,10 and give it the new name **NewObject**.

<code>
<duplicateobject Target="SomeObject"  Position="10,10,10" Name="ChildObject" AttachTo="NewObject" />
</code>

> This function will find an asset called **SomeObject** and create a duplicate. It will place the duplicate at the respective x,y,z coordinates 10,10,10 and give it the new name **ChildObject**. It will then find the asset called **NewObject** and parent itself to it.