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#
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#
| Argument | Typ | Popis |
|---|---|---|
| x, y, z | Real | World-space střed. |
| radius | Real | Poloměr; konečný a > 0. Průměr je 2*radius. |
| options | Struct | Společ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#
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#
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ík | Signatura | Kontrakt operace |
|---|---|---|
| jolt_sphere_create_dynamic | jolt_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_kinematic | jolt_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_static | jolt_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. |