setObjectMass

Define a massa de um objeto.

Sintaxe

bool setObjectMass ( element oObjeto, number massa )

Parâmetros

Nome	Tipo	Padrão	Descrição
oObjeto	element	—	Um objeto, ou qualquer elemento com objetos abaixo dele.
massa	number	—	Nova massa. Não pode ser negativa.

Retorno

true se a massa foi aplicada. O que é conferido, e até onde vai a mudança, depende do lado:

• no servidor, uma massa ausente, não finita ou negativa dá aviso (Expected a non-negative number for mass) e devolve false. A mudança é guardada com o objeto e enviada a todos os jogadores — quem entrar depois também a recebe, enquanto o objeto estiver em física dinâmica. Só o objeto que você passou é alterado;
• no cliente, uma massa que não é número dá aviso, uma negativa devolve false sem aviso, e a mudança vale apenas nesta máquina. Com um elemento pai, os objetos abaixo dele são alterados mas a chamada devolve false — só um objeto passado diretamente dá true.

Um objeto muito leve sai voando ao menor toque; um muito pesado praticamente não se move.

Exemplo

-- deixa a caixa leve o bastante para o jogador empurrar
setObjectMass(caixa, 5)

Veja também

• getObjectMass — Devolve a massa de um objeto.
• getObjectProperty — Lê uma propriedade física de um objeto.
• setObjectProperty — Altera uma propriedade física de um objeto.
• isObjectStatic — Diz se um objeto está travado no lugar.
• setObjectStatic — Trava um objeto no lugar ou devolve ele à física.