convertDynamicProp

Tira um pedaço do mapa estático do mundo e põe no lugar um objeto programável — apenas nesta máquina.

Sintaxe

object convertDynamicProp ( number modelo, number x, number y, number z [, number rx = 0, number ry = 0, number rz = 0, number interior = 0 ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
modelo	number	—	ID do modelo do pedaço do mapa, de 1 a 65535.
x, y, z	number	—	Posição do pedaço, ou um Vector3 no lugar dos três números.
rx, ry, rz	number	0	Rotação da cópia, em graus — ou um Vector3 no lugar dos três números.
interior	number	0	O interior de onde o pedaço do mapa é tirado. 0 é o mundo exterior.

Retorno

O novo objeto, e quantos objetos do mapa a chamada tirou do mundo naquela posição — 0 quando nada daquele modelo foi encontrado lá. As falhas dão aviso no console de debug e devolvem apenas um false: um modelo inválido, uma posição inválida, objetos indisponíveis nesta máquina, ou o elemento que não pôde ser criado.

Se o mundo do jogo ainda estiver carregando, o objeto ainda é criado e devolvido com 0 removidos, e um aviso pede que você espere o onClientPlayerReady.

Observações

A cópia é um objeto comum do cliente: existe apenas nesta máquina, é destruída junto com o resource e fica no lugar até você fazer algo com ela — mova-a com as funções compartilhadas, ou entregue-a à física com setElementDynamicPhysics.

Esta é a versão de cliente do createDynamicProp do servidor: a função do servidor cria um prop vivo para todos de uma vez, esta troca um pedaço do mapa por uma cópia programável em uma máquina só.

Exemplo

-- tira a cerca do mapa e põe no lugar uma cópia programável
local cerca, removidos = convertDynamicProp(3260, 1714.0, -1910.0, 13.2)

if removidos > 0 then
    -- o pedaço do mapa sumiu; agora derruba a cópia
    setElementDynamicPhysics(cerca, true)
end

Veja também

• setObjectStatic — Trava um objeto no lugar ou devolve ele à física.
• isObjectStatic — Diz se um objeto está travado no lugar.
• setElementDynamicPhysics — Liga ou desliga a física dinâmica de um objeto.
• createDynamicProp — A versão do servidor: um prop vivo para todos de uma vez.