Hinge Constraint

Drží shared anchor pohromadě a dovoluje relativní rotaci kolem jediné world-space osy.

Hinge použijte pro dveře, páky, kola a poháněné čepy. Nabízí úhlové limity ve stupních, měnitelnou referenční rotaci, aktuální úhel a velocity nebo position motor omezený torquem.

Syntaxe#

jolt_hinge(body_a, body_b, anchor_x, anchor_y, anchor_z, axis_x, axis_y, axis_z, options=undefined)
jolt_hinge_world(body, anchor_x, anchor_y, anchor_z, axis_x, axis_y, axis_z, options=undefined)

Argumenty#

Options#

Metody#

Příklad: dveře s limitem#

var frame = jolt_box_create_static(-1.8, 0, 2, 0.3, 0.3, 4);
var door  = jolt_box_create_dynamic(0, 0, 2, 3.6, 0.25, 4, { mass: 18 });

var hinge = jolt_hinge(frame, door, -1.8, 0, 2, 0, 0, 1, {
    limits_min: 0,
    limits_max: 110,
    collision: false
});

Příklad: position a velocity motor#

hinge.set_motor_max_torque(45);
hinge.set_motor_spring(3, 0.8);
hinge.set_motor_position(90); // stupně

// Později přepněte na velocity režim.
hinge.set_motor_velocity(4);  // radiány za sekundu

var angle = hinge.get_angle();
var state = hinge.get_motor_state();

Referenční rotace#

set_rotation(angle) změní nulu Hinge a zachová handle, anchor, limity, collision state i motor settings. Existující limity se následně měří od nové reference.

World varianta#

var lever = jolt_box_create_dynamic(0, 0, 2, 4, 0.3, 0.3, { mass: 6 });
var pivot = jolt_hinge_world(lever, -2, 0, 2, 0, 1, 0, {
    limits_min: -35,
    limits_max: 35
});

Chyby a životní cyklus#

• Body-to-body creatory vyžadují dvě různá živá managed JoltBody ve stejném managed výchozím worldu.
• Alespoň jedno připojené těleso musí být pohyblivé; nepodporovaná static-static dvojice v native Jolt selže.
• Constructory při úspěchu vracejí managed JoltConstraint, při validační nebo native chybě undefined.
• Zničení kteréhokoli připojeného tělesa nejprve automaticky zničí a zneplatní jeho constrainty.
• Po selhání creatoru nebo metody čtěte jolt_get_error(), zejména u nedůvěryhodných hodnot.
• Anchor a axis komponenty musí být konečné a osa musí mít nenulovou délku.
• Limity musí být konečné a seřazené; motor torque musí být konečný a nezáporný.
• Obsahují-li options současně motor_velocity i motor_position, position se aplikuje poslední a bude aktivní.

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.