Shape Resources
Načítání .jcol
jolt_shape_load(path, cache_key=undefined) synchronně načte připravená kolizní data. Jde o kolizní formát, ne renderovaný OBJ nebo .gmodel. Soubor .jcol připravte projektovým collision_converter a distribuujte jako dostupný přiložený soubor.
Loader ověřuje 32bajtovou hlavičku JCOL v1, little-endian data, nulové flags a přesnou velikost payloadu. Limit souboru je 8 MiB. Nepodporovaná verze, chybná data a chybějící soubor vracejí undefined a chybu; nejde o prázdnou geometrii.
var terrain = jolt_shape_load("terrain.jcol");
if (is_undefined(terrain)) {
show_debug_message(jolt_get_error_message());
} else {
var ground = terrain.create_static(0, 0, 0);
if (is_undefined(ground)) show_debug_message(jolt_get_error_message());
terrain.destroy();
}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 |
|---|---|---|
| jolt_shape_load | jolt_shape_load(path, cache_key = undefined) | Načte validovaný binární collision asset (ne .jolt.json), JoltShape/undefined. Default cache klíč je cesta; existující cache vrátí sdílený zdroj bez nového čtení souboru. |