Sockety a konfigurace

Úplný kontrakt jolt_socket, lokální transform, kompatibilita a runtime stav.

jolt_socket(body, polarity, type, options=undefined) vrací JoltSocket nebo undefined a nastaví standardní high-level chybu. Všechny číselné hodnoty musí být konečné; quaternion se při vytvoření normalizuje.

Syntaxe#

jolt_socket(body, polarity, type, options=undefined)

Základní options#

Local → world transform#

World position vznikne otočením local position rotací body a přičtením world position body. World rotation je součin body quaternionu a local quaternionu socketu. Metoda get_transform() provede tento výpočet z aktuálního body transformu a vrátí {position, rotation}.

var frame = socket.get_transform();
if (!is_undefined(frame)) {
    show_debug_message(frame.position.x);
    show_debug_message(frame.rotation.w);
}

Kompatibilita a výběr kandidáta#

• Pár musí být male + female, mít přesně stejný neprázdný type, být enabled, volný a mimo cooldown.
• Sockety musí patřit různým bodies ve stejném managed world. Alespoň jedno body musí být Dynamic.
• Kandidáti se globálně řadí podle nejmenší vzdálenosti, potom úhlové chyby a nakonec stabilních socket ID.
• Endpoint se rezervuje atomicky pouze jednomu kandidátovi. Mezi stejnou dvojicí bodies nevznikne redundantní druhý socket constraint.

Veřejný stav a metody#

Integrace s aktuálním projektem#

• Sockety›

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.