Cone Constraint

Drží shared anchor pohromadě, omezuje swing na kruhový kužel a nechává twist kolem osy volný.

Cone je vhodný pro závěsy, jednoduché ball joints a články, které se mohou vychýlit maximálním úhlem, ale nepotřebují twist limits. Pro eliptický swing, twist limits nebo angular motory použijte SwingTwist.

Syntaxe#

jolt_cone(body_a, body_b, anchor_x, anchor_y, anchor_z, axis_x, axis_y, axis_z, max_angle, options=undefined)
jolt_cone_world(body, anchor_x, anchor_y, anchor_z, axis_x, axis_y, axis_z, max_angle, options=undefined)

Argumenty a options#

Úhlové chování#

• Aktuální osa se může od referenční osy vychýlit nejvýše o max_angle.
• Relativní twist kolem této osy zůstává neomezený.
• Limit 0 stupňů uzamkne swing; 180 stupňů znamená prakticky volný swing.
• Public API používá stupně a interně je převádí na Jolt radiány.

Metody#

Příklad: zavěšená lampa#

var lamp = jolt_box_create_dynamic(0, 0, 3.5, 0.7, 0.7, 1, { mass: 3 });
var joint = jolt_cone_world(
    lamp,
    0, 0, 4,
    0, 0, -1,
    35
);

Body-to-body příklad#

var joint = jolt_cone(upper, lower, 0, 0, 4.5, 0, 0, -1, 45, {
    collision: false
});
joint.set_limit(30);
var swing = joint.get_angle();

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.
• max_angle a runtime limit musí zůstat mezi 0 a 180 stupni.
• Cone nemá motor ani pružinu. Pro poháněné angular řízení použijte SwingTwist nebo SixDOF.

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.