Point Constraint

Udržuje jeden material point na každém tělese ve stejném místě a ponechává veškerou relativní rotaci volnou.

Point je nejjednodušší ball-and-socket spoj. Při vytvoření používá jeden shared world-space anchor, uloží local attachment pro každé těleso a nevynucuje angular limits ani motor.

Syntaxe#

jolt_point(body_a, body_b, anchor_x, anchor_y, anchor_z, options=undefined)
jolt_point_world(body, anchor_x, anchor_y, anchor_z, options=undefined)

Argumenty a options#

Metody#

Příklad: kyvadlo#

var support = jolt_box_create_static(0, 0, 6, 0.5, 0.5, 0.5);
var weight  = jolt_box_create_dynamic(0, 0, 3, 0.8, 0.8, 0.8, { mass: 4 });
var joint   = jolt_point(support, weight, 0, 0, 5.5, {
    collision: false
});

weight.add_impulse(4, 0, 0);

World varianta#

var ball = jolt_sphere_create_dynamic(0, 0, 3, 0.5, { mass: 2 });
var pivot = jolt_point_world(ball, 0, 0, 4);

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.
• Shared anchor musí být konečný.
• Point nemá limity, pružinu ani motor; type-incompatible metoda JoltConstraint zaznamená invalid-operation error.
• Off-centre anchor přirozeně dovolí, aby constraint force vytvářela torque na tělese.

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.