Tělesa

Sphere

Vytvoří kouli definovanou poloměrem.

x, y a z jsou přesný world-space střed. Rotace nemění kolizní geometrii, quaternion body však zůstává dostupný. Podporuje Dynamic, Static a Kinematic.

Syntaxe#

Syntax
jolt_sphere_create_dynamic(x, y, z, radius, options=undefined)
jolt_sphere_create_static(x, y, z, radius, options=undefined)
jolt_sphere_create_kinematic(x, y, z, radius, options=undefined)

Argumenty a návrat#

ArgumentTypPopis
x, y, zRealWorld-space střed.
radiusRealPoloměr; konečný a > 0. Průměr je 2*radius.
optionsStructSpolečný options struct.

Vrací JoltBody nebo undefined. Podporuje běžné JoltBody vlastnosti, collision layers, sensor režim, kontakty a raycasty; omezení motion typu se uplatní na síly, mass a velocity. Debug draw kreslí drátěnou kouli kolem transformovaného středu.

Reusable JoltShape#

GML
var shape = jolt_shape_sphere(radius, cache_key=undefined);
shape.create_dynamic(x, y, z, options);
shape.create_static(x, y, z, options);
shape.create_kinematic(x, y, z, options);

Generic jolt_shape_load() podporuje Sphere .jcol.

Příklad#

GML
var ball = jolt_sphere_create_dynamic(-3, 0, 4, 0.6, {
    mass: 1,
    restitution: 0.7,
    friction: 0.3
});

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_sphere_create_dynamicjolt_sphere_create_dynamic(x = 0, y = 0, z = 0, radius = 0.5, options = undefined)Factory odpovídajícího motion type, pozice XYZ default 0 m a options. poloměr >0 m, default.5. Vrací JoltBody/undefined; chyba options uklidí nově vytvořené těleso. Konečné rozměry, změny přes set_ zachovají identitu.
jolt_sphere_create_kinematicjolt_sphere_create_kinematic(x = 0, y = 0, z = 0, radius = 0.5, options = undefined)Factory odpovídajícího motion type, pozice XYZ default 0 m a options. poloměr >0 m, default.5. Vrací JoltBody/undefined; chyba options uklidí nově vytvořené těleso. Konečné rozměry, změny přes set_ zachovají identitu.
jolt_sphere_create_staticjolt_sphere_create_static(x = 0, y = 0, z = 0, radius = 0.5, options = undefined)Factory odpovídajícího motion type, pozice XYZ default 0 m a options. poloměr >0 m, default.5. Vrací JoltBody/undefined; chyba options uklidí nově vytvořené těleso. Konečné rozměry, změny přes set_ zachovají identitu.