Distance Constraint

Drží dva attachment points v nastavitelném rozsahu minimální a maximální vzdálenosti.

Distance constraint vytváří pevnou tyč, lano s vůlí nebo tlumenou pružinu bez renderování lana. Body-to-body attachment points se při vytvoření zadávají ve world space a interně se uloží relativně k tělesům.

Syntaxe#

jolt_distance(body_a, body_b, options=undefined)
jolt_distance_world(body, anchor_x, anchor_y, anchor_z, min_distance, max_distance, options=undefined)

Body-to-body options#

Argumenty world varianty#

Metody#

Pevná délka, vůle a pružina#

• Stejné minimum a maximum vytvoří tyč nebo lano s pevnou délkou.
• Rozsah dovolí volný pohyb, dokud attachment point nedosáhne některé hranice.
• Pružina změkčuje korekci; vyšší frequency je tužší a damping potlačuje kmitání.
• Jde pouze o matematickou geometrii bez rope collision, ohýbání, wrappingu nebo renderování.

Příklad: tlumené lano#

var anchor = jolt_box_create_static(0, 0, 6, 0.4, 0.4, 0.4);
var load   = jolt_box_create_dynamic(0, 0, 2, 1, 1, 1, { mass: 5 });

var tether = jolt_distance(anchor, load, {
    point_a: { x: 0, y: 0, z: 6 },
    point_b: { x: 0, y: 0, z: 2 },
    min_distance: 2,
    max_distance: 4,
    spring_frequency: 3,
    spring_damping: 0.65,
    collision: false
});

Příklad: přímé připojení ke světu#

var load = jolt_box_create_dynamic(0, 0, 2, 1, 1, 1, { mass: 5 });
var tether = jolt_distance_world(load, 0, 0, 6, 2, 4, {
    spring_frequency: 2,
    spring_damping: 0.7
});

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.
• Attachment structy musí obsahovat konečné hodnoty x, y a z.
• Distance limity musí být konečné, nezáporné a seřazené minimum <= maximum.
• Frequency a damping musí být 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.