Převodovka a rychlosti

Před build() nastavuje automatický nebo manuální režim, časování, shift thresholds, clutch strength a převodové poměry.

Výchozí je automat. Manuální převodovka podporuje runtime set_gear(); jeho volání v automatickém režimu selže.

Volby převodovky#

var car = jolt_vehicle(chassis, {
    transmission: {
        mode: JOLT_VEHICLE_TRANSMISSION_MANUAL,
        forward_gears: [3.2, 2.1, 1.4, 1.0, 0.82],
        reverse_gears: [3.0],
        clutch_strength: 10
    }
});

Manuální řazení#

car.set_gear(1, 1);   // první převod vpřed, plně sepnutá spojka
car.set_gear(0, 0);   // neutrál
car.set_gear(-1, 1);  // zpátečka

Konfigurační objekt a settery#

var transmission = jolt_vehicle_transmission();
transmission.set_automatic(true);
transmission.set_forward_gears([3.0, 2.0, 1.2]);
transmission.set_reverse_gears([3.0]);
var settings = jolt_vehicle_settings();
settings.set_transmission(transmission);
var car = jolt_vehicle(chassis, settings);

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().

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.