cloneElement

Cria uma cópia de um elemento existente.

Sintaxe

element cloneElement ( element oElemento
                       [, number x, number y, number z, bool clonarFilhos = false ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
oElemento	element	—	Elemento de origem.
x, y, z	number	posição da origem	Onde colocar a cópia.
clonarFilhos	bool	false	Clonar também os filhos diretos da origem.

Retorno

O clone, ou false se o elemento não puder ser clonado.

A cópia leva junto todos os dados de elemento, o interior e a dimensão da origem; um veículo clonado também mantém as variantes e a cor. O elemento raiz, jogadores e outros elementos controlados pela engine não podem ser clonados.

Cuidado

Com clonarFilhos ativado o comportamento muda em dois pontos: as cópias dos filhos viram irmãs das originais (cada uma é pendurada no pai da sua própria origem, e não no clone devolvido), e x, y, z deixam de ser uma posição absoluta e passam a ser um deslocamento somado à posição de cada elemento. Como o padrão de x, y, z é a própria posição da origem, chamar cloneElement(el, nil, nil, nil, true) acaba dobrando as coordenadas.

Exemplo

local original = createVehicle(411, 0, 0, 5)
local copia = cloneElement(original, 10, 0, 5)