JoltPhysics

3. Ovládaný hráč

Přidejte CharacterVirtual, pohled z první osoby, pohyb WASD a skákání.

Postup#

Nahraďte stejných šest událostí. Zachovejte jediný controller a jediný fyzikální update; místnost stále nepoužívá vestavěnou fyziku GameMakeru.
Tab zachytí myš, potom funguje WASD a mezerník. Tab kurzor uvolní; ztráta fokusu okna ho také odemkne a zastaví vstup pohybu. Ukázka začíná úmyslně odemčená.
Pozice Characteru je u chodidel. Celková výška je 1.8 m, poloměr 0.4 m; výška očí je v této lekci pro stojícího hráče jednoduchý offset 1.6 m. Není to kamera pro crouch/attachment.
Kamera je malý datový struct, nikoliv GameMaker camera handle. Draw nastavuje a obnovuje view/projection matice. Tento struct nepředávejte do view_camera ani camera_apply.
Vyzkoušejte chůzi, skok a puštění všech kláves. Postava stojí na podlaze a po skoku se vrátí. Podlaha nemá obvodové stěny: za jejím okrajem lze úmyslně spadnout.

Pořadí událostí#

Create vytvoří zdroje. Step načte vstup a připraví kameru. End Step aktualizuje Grabber, zavolá jediný jolt_update a obnoví kameru po simulaci. Draw kreslí 3D debug; Draw GUI kreslí text. Clean Up uvolní pomocníky, Character, tělesa a nakonec svět.

o_tutorial — Create#

game_set_speed(60, gamespeed_fps);
floor_body = undefined;
crate = undefined;
player = undefined;
carry = undefined;
frame_seconds = 1 / 60;
mouse_locked = false;
carry_mouse_input = false;
yaw = 90;
pitch = -17;
sensitivity = 0.12;

if (!jolt_start()) {
    show_error(jolt_get_error_message(), true);
    exit;
}
jolt_debug_enable(true);
jolt_debug_set(0);
jolt_debug_set(JOLT_DEBUG_SHAPES, true);

floor_body = jolt_box_create_static(0, 0, -0.25, 12, 12, 0.5);
crate = jolt_box_create_dynamic(0, 2, 3, 1, 1, 1);
if (is_undefined(floor_body) || is_undefined(crate)) {
    show_error(jolt_get_error_message(), true);
    exit;
}
crate.set_mass(2);
crate.set_friction(0.6);
crate.set_restitution(0.1);

player = jolt_character();
if (is_undefined(player)) {
    show_error(jolt_get_error_message(), true);
    exit;
}
player.set_radius(0.4);
player.set_height(1.8);
player.set_position(0, -2, 0.1);
player.set_speed(4);
player.set_jump_speed(5);
jolt_debug_set(JOLT_DEBUG_CHARACTERS, true);

camera = {
    Position: {X:8, Y:-10, Z:7},
    Target: {X:0, Y:0, Z:1},
    Up: {X:0, Y:0, Z:1}
};
refresh_camera = function() {
    if (is_undefined(player)) return;
    var _feet = player.get_position();
    camera.Position = {X:_feet.x, Y:_feet.y, Z:_feet.z + 1.6};
    camera.Target = {
        X:camera.Position.X + dcos(yaw) * dcos(pitch),
        Y:camera.Position.Y + dsin(yaw) * dcos(pitch),
        Z:camera.Position.Z + dsin(pitch)
    };
};
refresh_camera();

o_tutorial — Step#

frame_seconds = clamp(delta_time / 1000000, 0, 0.05);

if (keyboard_check_pressed(vk_tab)) {
    mouse_locked = !mouse_locked;
    window_mouse_set_locked(mouse_locked);
}
if (!window_has_focus()) {
    mouse_locked = false;
    window_mouse_set_locked(false);
}
window_set_cursor(mouse_locked ? cr_none : cr_default);
carry_mouse_input = !is_undefined(carry) && carry.controls_use_mouse(id);
if (mouse_locked && !carry_mouse_input) {
    yaw += window_mouse_get_delta_x() * sensitivity;
    pitch = clamp(pitch - window_mouse_get_delta_y() * sensitivity, -85, 85);
}

var _forward = 0;
var _side = 0;
if (mouse_locked) {
    _forward = keyboard_check(ord("W")) - keyboard_check(ord("S"));
    _side = keyboard_check(ord("D")) - keyboard_check(ord("A"));
    if (keyboard_check_pressed(vk_space)) player.jump();
}
var _mx = _forward * dcos(yaw) + _side * dcos(yaw - 90);
var _my = _forward * dsin(yaw) + _side * dsin(yaw - 90);
var _length = point_distance(0, 0, _mx, _my);
if (_length > 1) { _mx /= _length; _my /= _length; }
player.set_move(_mx, _my);
refresh_camera();

o_tutorial — Step → End Step#

if (!is_undefined(carry)) carry.update_controls();
if (jolt_update(frame_seconds) < 0) {
    show_error(jolt_get_error_message(), true);
    exit;
}
refresh_camera();

o_tutorial — Draw#

var _world = matrix_get(matrix_world);
var _view = matrix_get(matrix_view);
var _projection = matrix_get(matrix_projection);
var _p = camera.Position;
var _t = camera.Target;
matrix_set(matrix_world, matrix_build_identity());
matrix_set(matrix_view, matrix_build_lookat(
    _p.X, _p.Y, _p.Z, _t.X, _t.Y, _t.Z, 0, 0, 1));
matrix_set(matrix_projection, matrix_build_projection_perspective_fov(
    70, room_width / room_height, 0.05, 100));
jolt_debug_draw();
matrix_set(matrix_world, _world);
matrix_set(matrix_view, _view);
matrix_set(matrix_projection, _projection);

o_tutorial — Draw → Draw GUI#

draw_set_colour(c_white);
draw_text(16, 16, "World: " + string(jolt_is_started()));
if (!is_undefined(crate)) {
    draw_text(16, 40, "Crate Z: " + string_format(crate.get_position().z, 1, 2));
}
if (!is_undefined(player)) {
    draw_text(16, 64, "Tab: mouse | WASD: move | Space: jump");
    var _cx = display_get_gui_width() * 0.5;
    var _cy = display_get_gui_height() * 0.5;
    draw_line(_cx - 5, _cy, _cx + 5, _cy);
    draw_line(_cx, _cy - 5, _cx, _cy + 5);
}
if (!is_undefined(carry)) {
    draw_text(16, 88, "LMB: grab/release | RMB: rotate | R: realign | F: throw");
    draw_text(16, 112, "Holding: " + string(carry.is_holding()));
    draw_text(16, 136, "Grab reason: " + carry.get_last_reason());
}

o_tutorial — Clean Up#

window_mouse_set_locked(false);
window_set_cursor(cr_default);
if (is_struct(carry)) carry.destroy();
if (is_struct(player)) player.destroy();
if (is_struct(crate)) crate.destroy();
if (is_struct(floor_body)) floor_body.destroy();
jolt_stop();

Vyzkoušejte krok za krokem#

Akce v okně hry	Očekávaný výsledek
Klikněte do okna hry, pak jednou stiskněte Tab.	Kurzor zmizí a myš začne řídit pohled. Každý nový běh začíná s uvolněnou myší.
Pohybujte myší; pak držte W a pusťte ho. Vyzkoušejte A, S, D.	Mění se pohled, W jde dopředu podle kamery a A/D do stran. Po puštění kláves se hráč zastaví.
Na podlaze krátce stiskněte mezerník.	Hráč vyskočí a dopadne. Bez kontaktu s podlahou není další stisk ověřením běžného skoku.
Stiskněte Tab; potom znovu Tab. Přepněte do jiného okna a vraťte se.	Tab uvolní/zachytí kurzor. Po ztrátě fokusu se ovládání vypne; po návratu jej zapněte znovu Tabem.

Jde o kontrolní postup pro čtenáře, nikoliv o tvrzení, že byly všechny ruční kroky úspěšně odzkoušeny. Skutečný rozsah ověření je uveden na stránce Ověření příkladů.

Ověření výsledku#

V GUI musí být World: 1. Bedna dopadne a její střed zůstane blízko Z=0.5. Hráč chodí a po skoku znovu dopadne. Při ukončení nesmí vzniknout chyba neplatného handle.

Když to nefunguje#

Neznámá jolt_* funkce nebo BBMOD typ: chybí součást importu, nikoliv další nastavení objektu.
World: 0 nebo chyba DLL: ověřte cílovou platformu x64 a odpovídající DLL podle Instalace.
World: 1, ale nic nevidíte: ověřte Draw událost, oba debug shadery, viditelnost objektu a vypnuté viewport kamery. Fyzikální těleso samo nevytváří herní model.
Příliš rychlý pohyb: v místnosti nesmí běžet druhý controller s jolt_update; delta_time se převádí z mikrosekund na sekundy.
Chyba při odchodu z místnosti: uvolňujte Grabber před Characterem a svět jako poslední. Nepoužívejte zde persistent controller.

Soubory příkladu#

Rozsah ověření#

Tyto stejné soubory používá oddělený testovací projekt. Stav kompilace a runtime kontrol je uveden na stránce Ověření praktických příkladů. Automatický test nenahrazuje ruční posouzení pocitu z myši a vzhledu scény.