jolt_asset_load

Načte a ověří JSON asset složeného kolizního tělesa.

Načítání je synchronní a nealokuje fyzikální zdroje. Vrací běžný GML struct; ke čtení souboru není potřeba běžící svět. Podporuje authoring formát verze 1 až 5.

Syntax#

jolt_asset_load(filename);

Návratová hodnota#

Struct | undefined

Úspěch vrací ověřený struct s configuration_id a polem boxes (v1) nebo shapes (v2/v3). Chyba čtení, parsování či validace vrací undefined; ihned čtěte jolt_get_error().

Životnost#

Výsledek je běžný GML struct bez nativního handle a bez metody destroy. Jeho data lze použít pro více těles; nejde o model pro vykreslování ani o .jcol zdroj.

Příklad#

Do Included Files přidejte vlastní exportovaný asset jako props/crate.jolt.json. Příklad předpokládá tento soubor; vytváření tělesa navíc vyžaduje běžící svět.

// Include your exported authoring JSON in the game's Included Files.
var asset = jolt_asset_load("props/crate.jolt.json");
if (is_undefined(asset)) {
    var error = jolt_get_error();
    show_debug_message(error.message);
}

Ukázka uloží data assetu pro pozdější vytvoření těles a při neúspěchu vypíše diagnostiku.

Související reference#

• Blender Asset Editor›
• JSON formát a migrace›
• jolt_asset_create_body›
• Složené tvary›
• Vlastnosti těles›

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.