Dopravní pásy

Změní horní plochu existujícího tělesa na pohybující se fyzikální kontaktní povrch.

jolt_conveyor připojí managed native helper k jednomu non-sensor Static nebo Kinematic JoltBody. Dynamic náklad se přepravuje prostřednictvím Jolt contact solveru a tření: pozice, rotace ani rychlost se neteleportují a běžné kolize zůstávají aktivní.

Syntaxe#

jolt_conveyor(body, options=undefined)

Argumenty#

Options#

Veřejné metody#

Pravidla kontaktu a pohybu#

• Přepravují se pouze Dynamic non-sensor rigid bodies ve skutečném kontaktu s horní plochou. Tělesa ve vzduchu, na boku nebo zespodu jsou ignorována.
• Test horní plochy používá local +Z normal hostitele a přijímá kontaktní normals uvnitř 60stupňového horního kužele.
• Speed je cílová relativní surface velocity, nikoli impulz přičítaný každý Step. Skutečnou odezvu určuje friction, normal force, hmotnost a podmínky kontaktu.
• Boxy se posouvají, zatímco Sphere a Cylinder mohou přirozeně rolovat. Kolize mezi nákladem i běžná contact response zůstávají aktivní.
• LOCAL směr sleduje otočený nebo nakloněný host. WORLD zůstává absolutní, ale stále se promítá do horní tangent plane a nemůže vytvářet vztlak.
• Změna speed, direction, layers nebo smart pomocníků probudí vhodná tělesa dotýkající se skutečného tvaru hostitele.

Centrování a zarovnání rotace#

• Centrování aplikuje omezenou boční PD sílu směrem k přímce vedené veřejným originem hostitele ve směru pásu. Nemá dopřednou složku a neteleportuje.
• Rotation alignment aplikuje omezený torque kolem surface normal směrem k nejbližšímu násobku rotation_step relativně k orientaci hostitele.
• Zarovnání řídí pouze projektovaný yaw; nejde o úplnou 3D upright stabilizaci.
• Oba smart pomocníci působí jen během horního kontaktu a může jim odporovat hmotnost, tření nebo jiné colliders.

Příklad#

var conveyor_body = jolt_box_create_static(0, 0, 0, 3, 20, 0.5, {
    friction: 0.8
});

var belt = jolt_conveyor(conveyor_body, {
    direction: {x:0, y:1, z:0},
    speed: 2,
    center_objects: true,
    center_strength: 100,
    align_rotation: true,
    rotation_step: 90,
    rotation_strength: 50
});

Řízení za běhu#

belt.set_speed(-2); // Obrácení směru
belt.set_speed(0);  // Zastavení fyzického pohybu plochy

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.