Stav tělesa

Aktivace a uspávání

Ustálená Dynamic tělesa mohou usnout a šetřit práci simulace. Spánek není zničení: těleso zůstává ve světě a může se opět probudit. Vypínat uspávání u všech těles obvykle není potřeba.

API	Chování
body.activate() / deactivate()	Požádá o probuzení/uspání; vrací úspěšnost.
body.is_active()	Čte aktivitu, nikoliv platnost handlu.
body.set_allow_sleeping(enabled) / get_allow_sleeping()	Řídí možnost native uspávání; nepodporované motion properties mohou způsobit chybu.

if (!body.set_allow_sleeping(true)) show_debug_message(jolt_get_error_message());
if (!body.activate()) show_debug_message(jolt_get_error_message());

Ověřené kontrakty operací#

Následující kontrakty rozlišují jednotky, návratové hodnoty, chyby a životnost podle aktuální implementace. Nevynechávej kontrolu výsledku: false, 0 a undefined mohou mít u různých metod odlišný význam.

Symbol / vlastník	Signatura	Kontrakt operace
JoltBody.activate	JoltBody.activate()	Aktivace/uspání/povolení uspání: settery Boolean úspěchu, gettery Boolean stavu (false i při chybě). Spánek nezničí těleso; zákazy uspání používej vědomě kvůli výkonu.
JoltBody.deactivate	JoltBody.deactivate()	Aktivace/uspání/povolení uspání: settery Boolean úspěchu, gettery Boolean stavu (false i při chybě). Spánek nezničí těleso; zákazy uspání používej vědomě kvůli výkonu.
JoltBody.get_allow_sleeping	JoltBody.get_allow_sleeping()	Aktivace/uspání/povolení uspání: settery Boolean úspěchu, gettery Boolean stavu (false i při chybě). Spánek nezničí těleso; zákazy uspání používej vědomě kvůli výkonu.
JoltBody.is_active	JoltBody.is_active()	Aktivace/uspání/povolení uspání: settery Boolean úspěchu, gettery Boolean stavu (false i při chybě). Spánek nezničí těleso; zákazy uspání používej vědomě kvůli výkonu.
JoltBody.set_allow_sleeping	JoltBody.set_allow_sleeping(allow)	Aktivace/uspání/povolení uspání: settery Boolean úspěchu, gettery Boolean stavu (false i při chybě). Spánek nezničí těleso; zákazy uspání používej vědomě kvůli výkonu.