Výbuchy

Jednorázový impulz pro Dynamic rigid bodies, volitelně Character a lokální body Soft Body.

Jednorázové jolt_explosion provede účinek ihned. Konfigurovaný emitter jej provede až při explode().

Syntaxe#

jolt_explosion(x, y, z, options=undefined)

Argumenty#

Options#

Chování a pravidla cílů#

• Rigid: Vzdálenost se měří k native těžišti a impulz se aplikuje právě v něm. Spící těleso se probudí a nevznikne umělý off-centre torque.
• Rigid: Při vypnutém falloff dostane každé těleso uvnitř radius plný impulz. Strength je impulz, nikoli rychlost, takže těžší tělesa zrychlí méně.
• Rigid: Direction zapíná filtrování kuželem. Těleso přesně ve středu používá jako stabilní radiální směr veřejnou osu +Z.
• Rigid: Occlusion provádí jeden synchronní raycast pro každý vhodný cíl. Sensory neblokují; pevná Static nebo Kinematic geometrie může cíl zakrýt, i když není v layers.
• Rigid: Zásahy child tvarů Compoundu se deduplikují podle native body handle vlastníka.

Návratová hodnota#

Příklad#

var result = jolt_explosion(x, y, z, {
    radius: 8,
    strength: 1200,
    falloff: true,
    occlusion: true,
    layers: [layer_dynamic],
    ignore: grenade_body
});

show_debug_message("Affected bodies: " + string(result.affected_count));

Integrace s aktuálním projektem#

• Explosions›

Cíle a lokální reakce#

Rigid větev působí pouze na živá nesenzorová Dynamic tělesa a aplikuje impulz v těžišti. Character a Soft Body jsou opt-in, default false. U Soft Body se účinek vyhodnocuje pro volné vertices uvnitř radiusu; pinned vertices zůstávají přichycené. Occlusion se testuje pro ovlivněné vertices, nikoli jedním paprskem pro celou látku. Platí stejné falloff, cone a filtry.

Konfigurovaný emitter#

explosion = jolt_explosion_create(0, 0, 0, grenade_body);
explosion.set_radius(5);
explosion.set_strength(800);
explosion.set_include_characters(true);
explosion.set_include_soft_bodies(true);
explosion.set_max_delta_velocity(10);
explosion.set_ignore(grenade_body);
var result = explosion.explode();
explosion.destroy();

S owner Body je pozice/rotace lokální; bez owner je světová. Emitter vrací Booleany ze setterů, get_transform vrací transform nebo undefined a explode vrací výsledkový struct i při chybě (prázdný). destroy, zničení vlastníka nebo jolt_stop ukončí platnost. Znovu lze volat explode, dokud je emitter platný. set_layers přijímá živou vrstvu nebo pole vrstev; jednorázové options.layers navíc podporují číselnou masku.

Asset workflow#

explosion = jolt_asset_create_explosion(asset, "explosion", grenade_body);
if (!is_undefined(explosion)) {
    explosion.set_include_characters(true);
    explosion.set_include_soft_bodies(true);
    explosion.explode();
}

Poslední argument je vytvořený živý Body, nikoli načtený asset. Samotné vytvoření body automaticky explozi nespustí. Parametry se předávají stejné centrální funkci. Veřejné názvy jsou include_characters/include_soft_bodies; affect_* nejsou současný zápis.

Emitter API#

Settery vrací true při přijetí hodnoty a false při chybném vstupu; chybu čti ihned přes jolt_get_error(). Nastavení samo neaplikuje sílu. Samotné přijetí setteru není test platnosti emitteru: pro použití musí projít is_valid/get_transform.

Úplný seznam deklarací API#

Deklarace odpovídají produkčním GML zdrojům. Hodnota za = označuje volitelný argument. Toto je seznam signatur; význam, jednotky a omezení popisují příslušné části návodu. Název typu před tečkou označuje vlastníka metody, nikoli globální funkci.