‹›
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.

GML
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íkSignaturaKontrakt operace
jolt_shape_loadjolt_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.