Kola

Přidá virtuální kolo do draftu vozidla a vrátí jeho index od nuly nebo false při selhání.

Pozice je suspension hard point v lokálním prostoru chassis. Radius, šířka, odpružení, trakce, řízení, pohon a brzdy se nastavují před build().

Syntaxe#

vehicle.add_wheel(local_x, local_y, local_z, options=undefined)

Geometrie a odpružení#

Ovládání a pneumatika#

var front_left = car.add_wheel(-0.8, 1.4, -0.2, {
    radius: 0.35,
    width: 0.2,
    steering: true,
    driven: true,
    suspension_frequency: 1.8,
    suspension_damping: 0.65
});

Integrace s aktuálním projektem#

• Nastavení a orientace kol›

Konfigurační objekt a settery#

var wheel = jolt_vehicle_wheel(-0.8, 1.4, -0.2);
wheel.set_radius(0.35);
wheel.set_driven(true);
wheel.set_steering(true);
var wheel_index = car.add_wheel(wheel);

Konfigurační factories vracejí GML objekt nastavení; samy nevytvářejí fyziku. Jejich settery vracejí self, tedy tento objekt, a nejsou potvrzením platnosti hodnoty. Pole se spotřebují a ověří při jolt_vehicle, add_wheel nebo add_differential. Vynechané pole zachová default odpovídajícího options zápisu uvedený výše. Změna nastavení po jeho použití nemění existující vozidlo, kolo ani diferenciál. Nastavení nepotřebuje destroy.

Vozidlo při chybě vytvoření vrací undefined. add_differential vrací Boolean; add_wheel vrací číselný index začínající nulou, nebo Boolean false při chybě. Index 0 je úspěch: nepoužívej pouze if (!wheel_index). Konfiguraci kol a diferenciálů dokonči před build().

set_orientation(fx,fy,fz,ux=0,uy=0,uz=1) používá směry v lokálním prostoru chassis. Forward/up musí být konečné, nenulové a kolmé; validace proběhne v add_wheel. set_forward(x,y,z=0) nastaví současně výchozí up +Z. Případné chybné přidání po zahájení nativní konfigurace není atomické; po chybě oprav data a vytvoř draft znovu.

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.