Grip: přichycení postavy

Dvě pomyslné ruce přichytí Character ke statickému nebo kinematickému povrchu.

První použití#

Grip pohybuje postavou podle kotev rukou; Grabber / Carry naopak drží předmět před postavou. Jeden Character může mít jeden Grip controller. Připojený Dynamic Body současný Grip nepodporuje.

wall.set_grip_enabled(true);
grip = jolt_grip(player);
grip.set_camera(o_control_bbmod_camera);
grip.set_distances(0.65, 1.5, 2);
// End Step, po aktualizaci kamery:
grip.update_controls();
// Clean Up:
// grip.destroy();

player musí být platný JoltCharacter. Kamera poskytuje camera.Position, camera.Target a mouse_locked. Výchozí levé/pravé tlačítko myši ovládá levou/pravou ruku. Pro vlastní vstup použij acquire nebo update_hand; nespracovávej tentýž vstup zároveň automaticky.

Vzdálenosti a pohyb#

Ruce a aktuální cíl#

JOLT_GRIP_LEFT = 0, JOLT_GRIP_RIGHT = 1; BOTH = −1 je jen pro operace podporující obě ruce. get_attached(hand) vrací Boolean. get_position, get_rotation, get_world_normal a ostatní údaje úchopu vracejí undefined, pokud ruka není přichycená. Pozice je {x,y,z} ve světě, rotace quaternion {x,y,z,w}. +Z rotace odpovídá normále povrchu; +X vychází z kamery při uchopení.

var hand = grip.get_hand(JOLT_GRIP_LEFT);
if (is_struct(hand) && hand.attached) {
    hand_model.Matrix = model_matrix_from_transform(
        hand.world_position, hand.world_rotation);
}
var target = grip.get_target();
if (!is_undefined(target)) {
    preview.Matrix = model_matrix_from_transform(target.position, target.rotation);
}

get_target(hand=JOLT_GRIP_LEFT) provede jeden aktuální kamerový raycast a vrátí {position,world_normal,rotation}, nebo undefined. can_grip je pouze zjištění způsobilosti, nezískává úchop. Pro více údajů čti get_hand nebo get_target jednou; jednotlivé gettery pořizují vlastní snapshot/raycast. Zobrazení modelu zapínej a vypínej ve svém rendereru.

Pohyblivé kotvy a omezení#

Static povrch se nesmí po uchopení přemístit. Kinematic kotva se aktualizuje z lokální pozice, normály a rotace a přenáší rychlost bodu. Teleport, změna tvaru/pohybu, vypnutí grip_enabled, zničení tělesa, filtr kolizí nebo překročení break mohou ruku uvolnit. Dynamic Grip, reakční síly rukou, stamina a IK nejsou implementované.

Diagnostika a životnost#

get_status vrací obě ruce a důvody; get_reason(hand) vysvětluje odmítnutí nebo puštění. Po odmítnutí update_hand je nutné pustit ovládání před novým pokusem. release() pustí obě ruce, destroy() ukončí controller. Zničení Characteru jej uvolní. set_debug, set_debug_xray, set_debug_limits a set_debug_labels řídí diagnostiku; draw_debug_gui není veřejné API.

• Grabber / Carry›
• Vytvoření Characteru›

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.

Úplný seznam deklarací API#

Deklarace odpovídají produkčním GML zdrojům. Hodnota za = označuje volitelný argument. Toto je seznam signatur; význam, jednotky a omezení popisují příslušné části návodu. Název typu před tečkou označuje vlastníka metody, nikoli globální funkci.