getObjectMass

Devolve a massa de um objeto.

Sintaxe

number getObjectMass ( element oObjeto )

Retorno

A massa, ou false (com um aviso no console de debug) se o argumento não for um objeto — no cliente, uma arma customizada (createWeapon) também é aceita.

De onde vem o número depende do lado:

• no servidor, é a massa guardada com o objeto: -1 até um script definir uma, nunca o valor próprio do jogo;
• no cliente, é a massa do objeto como esta máquina o simula — o valor vivo para um objeto carregado no mundo, a última massa que um script definiu para um que não está (ou -1 se nenhuma foi definida).

É o mesmo que getObjectProperty(oObjeto, "mass").

Exemplo

local massa = getObjectMass(caixa)

if massa then
    outputDebugString("a caixa pesa " .. massa)
end

Veja também

• setObjectMass — Define 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.