GetClone

getClone(object)

Clone an object.

• object : object to operate on

   object = getObject("object")
   objectClone = getClone(object)

For referencing you can store them into a table :

   object = getObject("object")
   cloneList = {}
   function onSceneUpdate()
           if onKeyDown("SPACE") then
               table.insert(cloneList, #cloneList + 1, getClone(object)) -- create a clone
           end
   end

With that method, the first clone will be cloneList[1], second clone will be cloneList[2], and so on..

To manage all these clones at once you could add to the script, for example :

   for i=1, #cloneList do 
       rotate(cloneList[i], {0, 0, 1}, 1, "local")
   end 

In this case all the clones currently on the scene and the newly created ones will rotate.

Notes:

• They keeps the base object active behavior
• They keeps physics proprieties
• They don't keep the translate/force/etc.. values of the base object from lua script (because they are new objects)

Warning: Spawning a lot of clones in a very short time may cause slow-down, because.

• memory allocation : each cloning allocate new memory, fast games (like a shoot'em'up) usually pre-allocate memory.
• when using physics, the new object need to be also allocated to the physics world
• when using sound, the source need to be also allocated to the sound context