setObjectGravity

Desliga a gravidade de um objeto ou liga de novo.

Sintaxe

bool setObjectGravity ( element oElemento, bool ligada )

Parâmetros

Nome	Tipo	Padrão	Descrição
oElemento	element	—	O objeto a alterar.
ligada	bool	—	true para o objeto cair de novo, false para deixá-lo parado no ar.

Retorno

true quando a flag foi guardada, false caso contrário. No servidor, um argumento que não é um objeto dá aviso no console de debug; no cliente, só algo que não é elemento nenhum dá aviso.

No servidor a flag vai para todos os jogadores, e quem entrar depois também é avisado. No cliente a mudança vale apenas nesta máquina, e só nos objetos que ela possui — objetos criados pelo servidor devolvem false em silêncio.

A flag importa enquanto o objeto está sendo simulado — um prop dinâmico destravado ou um objeto em física dinâmica. Com a gravidade desligada, um empurrão faz o objeto deslizar em vez de cair. Ligar a física dinâmica retorna a flag para ligada.

Exemplo

-- caixa sem gravidade: fica parada no ar em vez de cair
setObjectGravity(caixa, false)

Veja também

• isObjectGravityEnabled — Verifica se a gravidade de um objeto está ligada.
• isElementDynamicPhysics — Verifica se um objeto está em física dinâmica.
• setElementDynamicPhysics — Liga ou desliga a física dinâmica de um objeto.