Rotace

Čte a mění orientaci body pomocí quaternionu nebo Euler helperů.

Kanonická native reprezentace je normalizovaný quaternion {x,y,z,w}. High-level helpery přijímají také Euler úhly ve stupních kolem veřejných os X, poté Y a Z.

High-Level API#

body.get_rotation()
body.get_rotation_euler()
body.set_rotation(x, y, z)
body.set_rotation(x, y, z, w)
body.set_rotation_euler(x_degrees, y_degrees, z_degrees)

Pravidla overloadu#

Skládání Euler rotací#

jolt_quaternion_from_euler() skládá q = qZ * qY * qX, takže rotace se aplikují kolem veřejné X, poté Y a nakonec Z. Euler reprezentace není jednoznačná a poblíž gimbal lock může být nestabilní; pro přesný round-trip uchovávejte quaternion.

Creation options#

var body = jolt_box_create_dynamic(0, 0, 3, 2, 1, 1, {
    rotation: {x:0, y:0, z:0, w:1}
});

var tilted = jolt_box_create_dynamic(3, 0, 3, 2, 1, 1, {
    rotation_euler: {x:15, y:30, z:90}
});

Jsou-li přítomny rotation i rotation_euler, nejprve se použije quaternion a rotation_euler jej následně nahradí. Pro jednoznačnost zadávejte pouze jednu variantu.

Chování motion typu#

• Změna rotace je okamžitá transformace, nikoli angular motion.
• Dynamic a Kinematic bodies se aktivují; Static se aktualizují bez aktivace.
• Pro časovaný Kinematic pohyb použijte move_kinematic nebo move_kinematic_euler.
• Pro simulovanou rotaci použijte angular velocity, torque nebo angular impulse.

Low-Level / Advanced API#

Settery vracejí true při úspěchu a false při neplatném vstupu, invalidním nebo stale body či nepodporovaném motion typu. Gettery vracejí požadovanou hodnotu nebo undefined při selhání. High-level chybu zjistíte přes jolt_get_error().

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.