attachElements

Anexa um elemento a outro, para que ele passe a acompanhá-lo.

Sintaxe

bool attachElements ( element oElemento, element alvo
                      [, number xOff = 0, number yOff = 0, number zOff = 0,
                         number xRot = 0, number yRot = 0, number zRot = 0 ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
oElemento	element	—	Elemento que será carregado.
alvo	element	—	Elemento que carrega.
xOff, yOff, zOff	number	0	Deslocamento de posição em relação ao alvo.
xRot, yRot, zRot	number	0	Deslocamento de rotação, em graus.

Retorno

true em caso de sucesso, false caso contrário.

Os tipos aceitos dependem do lado. No servidor podem ser anexados jogadores, peds, veículos, objetos, blips, colshapes, marcadores e pickups, a qualquer um desses mesmos tipos. No cliente podem ser anexados jogadores, peds, veículos, objetos, armas, blips, colshapes, marcadores, pickups, sons, luzes e a câmera, a jogadores, peds, veículos, objetos, armas, blips, colshapes, marcadores, pickups, sons e luzes. Os dois elementos precisam estar na mesma dimensão. Anexar um elemento a si mesmo, ou fechar um ciclo de anexos, é recusado.

No cliente os filhos do elemento também são anexados ao mesmo alvo, e o onClientElementAttach dispara antes de cada anexo: cancelá-lo deixa aquele elemento sem anexo, e a chamada devolve false quando era o elemento que você passou.

Exemplo

local luz = createObject(1215, 0, 0, 0)
attachElements(luz, veiculo, 0, 2, 0.5)

Veja também

• detachElements — Desfaz o anexo de um elemento.
• isElementAttached — Verifica se um elemento está anexado a outro.
• getElementAttachedTo — Devolve a quem o elemento está anexado.
• getAttachedElements — Lista o que está anexado a um elemento.
• setElementAttachedOffsets — Ajusta os deslocamentos de um anexo já existente.
• getElementAttachedOffsets — Devolve os deslocamentos de anexo de um elemento.