Vytvoření vozidla

Vytvoří managed draft vozidla nad platným Dynamic chassis a vrátí JoltVehicle nebo undefined.

Při vytvoření se vybírá collision tester a globální limity orientace. Kola a pohon se konfigurují na vráceném draftu před build().

Syntaxe#

jolt_vehicle(chassis, options=undefined)

Argumenty#

Volby vozidla#

Návratová hodnota#

Při úspěchu vrací draft JoltVehicle. Neplatné chassis nebo nastavení vrátí undefined a nastaví high-level chybu.

Kontrakt build()#

• Před build() přidejte 2 až 32 kol.
• Označte alespoň jedno kolo jako driven nebo přidejte explicitní diferenciál.
• Diferenciály a stabilizátory přidávejte před build().
• Managed build() je idempotentní: další volání po úspěchu vrátí true.
• Runtime ovládání a gettery vyžadují úspěšně sestavené vozidlo.

var car = jolt_vehicle(chassis, {
    collision: JOLT_VEHICLE_COLLISION_SPHERE,
    collision_radius: 0.08,
    maximum_slope_angle: 55,
    maximum_pitch_roll_angle: 75
});

if (is_undefined(car)) {
    var error = jolt_get_error();
    show_debug_message(error.context + ": " + error.message);
}

Konfigurační objekt a settery#

var settings = jolt_vehicle_settings();
settings.set_collision(JOLT_VEHICLE_COLLISION_SPHERE);
settings.set_collision_radius(0.08);
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.