jolt_box_create_kinematic
Vytvoří Kinematic box ve výchozím fyzikálním světě.
Nejprve úspěšně spusťte jolt_start(). Rozměry jsou celé délky podél lokálních os tělesa; poloha je ve světových souřadnicích se Z nahoru.
Syntax#
jolt_box_create_kinematic(x=0, y=0, z=0, width=1, depth=1, height=1, options=undefined);Všechny argumenty lze vynechat: vznikne jednotkový box v počátku. Polohu a orientaci pak nastav přes set_position a set_rotation_euler; geometrický setter musí odpovídat typu tvaru.
| Argument | Typ | Popis |
|---|---|---|
| x | Real | Světová X souřadnice středu tělesa; konečná hodnota, Z nahoru. |
| y | Real | Světová Y souřadnice středu tělesa; konečná hodnota, Z nahoru. |
| z | Real | Světová Z souřadnice středu tělesa; konečná hodnota, Z nahoru. |
| width | Real | Celý rozměr podél lokální osy X; konečná kladná hodnota. |
| depth | Real | Celý rozměr podél lokální osy Y; konečná kladná hodnota. |
| height | Real | Celý rozměr podél lokální osy Z; konečná kladná hodnota. |
| options | Struct | undefined | VOLITELNÉ. Výchozí undefined. Společné nastavení tělesa, viz Bodies Overview. |
Návratová hodnota#
JoltBody | undefined. Úspěch vrací spravované těleso. Neplatné rozměry, poloha či options a chyby nativního vytvoření vrací undefined. Ihned čtěte jolt_get_error().
Životnost#
Těleso vlastní volající. Až je nepotřebujete, zavolejte body.destroy(); jolt_stop() uvolňuje celý spravovaný svět. Nevytváří se žádný objekt pro vykreslování.
Příklad#
Kód rozdělte mezi Create a Cleanup event objektu. Svět musí při vytvoření i rušení tělesa ještě existovat; aktualizujte ho jednou za snímek přes jolt_update().
// Create event, after jolt_start() has succeeded.
body = jolt_box_create_kinematic(0, 0, 3, 1, 1, 1);
if (is_undefined(body)) {
var error = jolt_get_error();
show_debug_message(error.message);
}
// Cleanup event, while the world still exists.
if (!is_undefined(body)) body.destroy();Vytvoří se jednotkový box se středem ve výšce 3. Ukázka zachytí chybu vytvoření a při úklidu uvolní těleso.