Slider Constraint

Omezí relativní pohyb na jedinou přímou world-space osu a uzamkne ostatní translace i veškerou relativní rotaci.

jolt_slider() propojí dvě různá managed tělesa; jolt_slider_world() připojí jedno managed těleso přímo k pevnému world body Jolt. Obě varianty vracejí stejné managed rozhraní JoltConstraint.

Syntaxe#

jolt_slider(body_a, body_b, anchor_x, anchor_y, anchor_z, axis_x, axis_y, axis_z, options=undefined)
jolt_slider_world(body, anchor_x, anchor_y, anchor_z, axis_x, axis_y, axis_z, options=undefined)

Argumenty#

Options#

Metody#

Souřadnice a pravidla motoru#

• Kladná position sleduje zadanou osu; její obrácení obrátí position i směr motoru.
• Dvě kolmé translace a celá relativní rotace jsou uzamčené.
• Velocity a position setters vyberou a zapnou svůj režim. Pružina působí pouze v position režimu.
• Jsou-li přítomny oba creation targets, motor_position se použije poslední a bude aktivní.

Příklad: zásuvka#

var cabinet = jolt_box_create_static(4, 3.5, 2, 3.6, 3.8, 0.5);
var drawer  = jolt_box_create_dynamic(4, 3.5, 2.75, 3, 2.6, 0.7, { mass: 4 });
var slider = jolt_slider(cabinet, drawer, 4, 3.5, 2.75, 0, -1, 0, {
    limits_min: 0,
    limits_max: 2,
    collision: false
});

Příklad: poháněný píst#

var slider = jolt_slider(frame, piston, 0, 0, 2, 1, 0, 0, {
    limits_min: -1.5, limits_max: 1.5,
    motor_max_force: 80,
    spring_frequency: 3, spring_damping: 0.7,
    motor_position: 1
});
slider.set_motor_velocity(-2);
slider.set_motor_position(1);
var position = slider.get_position();

World varianta#

var drawer = jolt_box_create_dynamic(0, 0, 1, 1.8, 2.5, 0.5, { mass: 3 });
var rail = jolt_slider_world(drawer, 0, 0, 1, 0, 1, 0, {
    limits_min: -0.5,
    limits_max: 0.5
});

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 nesmí mít nulovou délku.
• Limity musí být konečné a splnit minimum <= 0 <= maximum.
• Motor targets musí být konečné; force, frequency a damping konečné a nezáporné.

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.