From eee9dd8c944331dd804752383692076ab4d2790e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Agnis=20Aldi=C5=86=C5=A1=20=22NeZv=C4=93rs?= Date: Mon, 23 Jun 2025 13:03:35 +0300 Subject: [PATCH] Example: core_3d_fps_controller Quake like camera animations and strafe jump movement --- examples/Makefile | 1 + examples/Makefile.Web | 4 + examples/core/core_3d_fps_controller.c | 360 +++++++++++++++++++++++++ examples/core/resources/huh_jump.wav | Bin 0 -> 19050 bytes 4 files changed, 365 insertions(+) create mode 100644 examples/core/core_3d_fps_controller.c create mode 100644 examples/core/resources/huh_jump.wav diff --git a/examples/Makefile b/examples/Makefile index 32a3a75ab..edd2eb399 100644 --- a/examples/Makefile +++ b/examples/Makefile @@ -500,6 +500,7 @@ CORE = \ core/core_3d_camera_free \ core/core_3d_camera_mode \ core/core_3d_camera_split_screen \ + core/core_3d_fps_controller \ core/core_3d_picking \ core/core_automation_events \ core/core_basic_screen_manager \ diff --git a/examples/Makefile.Web b/examples/Makefile.Web index 35ae70a18..5ba550eb0 100644 --- a/examples/Makefile.Web +++ b/examples/Makefile.Web @@ -382,6 +382,7 @@ CORE = \ core/core_3d_camera_free \ core/core_3d_camera_mode \ core/core_3d_camera_split_screen \ + core/core_3d_fps_controller \ core/core_3d_picking \ core/core_automation_events \ core/core_basic_screen_manager \ @@ -587,6 +588,9 @@ core/core_3d_camera_mode: core/core_3d_camera_mode.c core/core_3d_camera_split_screen: core/core_3d_camera_split_screen.c $(CC) -o $@$(EXT) $< $(CFLAGS) $(INCLUDE_PATHS) $(LDFLAGS) $(LDLIBS) -D$(PLATFORM) +core/core_3d_fps_controller: core/core_3d_fps_controller.c + $(CC) -o $@$(EXT) $< $(CFLAGS) $(INCLUDE_PATHS) $(LDFLAGS) $(LDLIBS) -D$(PLATFORM) + core/core_3d_picking: core/core_3d_picking.c $(CC) -o $@$(EXT) $< $(CFLAGS) $(INCLUDE_PATHS) $(LDFLAGS) $(LDLIBS) -D$(PLATFORM) diff --git a/examples/core/core_3d_fps_controller.c b/examples/core/core_3d_fps_controller.c new file mode 100644 index 000000000..56d8c4543 --- /dev/null +++ b/examples/core/core_3d_fps_controller.c @@ -0,0 +1,360 @@ +/******************************************************************************************* +* +* raylib [core] example - Input Gestures for Web +* +* Example complexity rating: [★★★☆] 3/4 +* +* Example originally created with raylib 5.5 +* +* Example contributed by Agnis Aldins (@nezvers) and reviewed by Ramon Santamaria (@raysan5) +* +* Example licensed under an unmodified zlib/libpng license, which is an OSI-certified, +* BSD-like license that allows static linking with closed source software +* +* Copyright (c) 2025-2025 Agnis Aldins (@nezvers) +* +********************************************************************************************/ + +#include "raylib.h" +#include "raymath.h" +#include "rcamera.h" + +//#define PLATFORM_WEB + +#if defined(PLATFORM_WEB) +#include +#endif + +#if defined(PLATFORM_DESKTOP) +#define GLSL_VERSION 330 +#else // PLATFORM_ANDROID, PLATFORM_WEB +#define GLSL_VERSION 100 +#endif + + +/* Movement constants */ +#define GRAVITY 32.f +#define MAX_SPEED 20.f +#define CROUCH_SPEED 5.f +#define JUMP_FORCE 12.f +#define MAX_ACCEL 150.f +/* Grounded drag */ +#define FRICTION 0.86f +/* Increasing air drag, increases strafing speed */ +#define AIR_DRAG 0.98f +/* Responsiveness for turning movement direction to looked direction */ +#define CONTROL 15.f +#define CROUCH_HEIGHT 0.f +#define STAND_HEIGHT 1.f +#define BOTTOM_HEIGHT 0.5f + +#define NORMALIZE_INPUT 0 + +typedef struct { + Vector3 position; + Vector3 velocity; + Vector3 dir; + bool isGrounded; + Sound soundJump; +}Body; + +const int screenWidth = 1280; +const int screenHeight = 720; +Vector2 sensitivity = { 0.001f, 0.001f }; + +Body player; +Camera camera; +Vector2 lookRotation = { 0 }; +float headTimer; +float walkLerp; +float headLerp; +Vector2 lean; + +void UpdateDrawFrame(void); // Update and Draw one frame + +void DrawLevel(); + +void UpdateCameraAngle(Camera* camera, Vector2* rot, float headTimer, float walkLerp, Vector2 lean); + +void UpdateBody(Body* body, float rot, char side, char forward, bool jumpPressed, bool crouchHold); + +//------------------------------------------------------------------------------------ +// Program main entry point +//------------------------------------------------------------------------------------ +int main(void) +{ + // Initialization + //-------------------------------------------------------------------------------------- + InitWindow(screenWidth, screenHeight, "Raylib Quake-like controller"); + InitAudioDevice(); + + player = (Body){ Vector3Zero(), Vector3Zero(), Vector3Zero(), false, LoadSound("resources/huh_jump.wav")}; + camera = (Camera){ 0 }; + camera.fovy = 60.f; // Camera field-of-view Y + camera.projection = CAMERA_PERSPECTIVE; // Camera projection type + + lookRotation = Vector2Zero(); + headTimer = 0.f; + walkLerp = 0.f; + headLerp = STAND_HEIGHT; + lean = Vector2Zero(); + + camera.position = (Vector3){ + player.position.x, + player.position.y + (BOTTOM_HEIGHT + headLerp), + player.position.z, + }; + UpdateCameraAngle(&camera, &lookRotation, headTimer, walkLerp, lean); + + DisableCursor(); // Limit cursor to relative movement inside the window + +#if defined(PLATFORM_WEB) + emscripten_set_main_loop(UpdateDrawFrame, 0, 1); +#else + + SetTargetFPS(60); // Set our game to run at 60 frames-per-second + //-------------------------------------------------------------------------------------- + + // Main game loop + while (!WindowShouldClose()) // Detect window close button or ESC key + { + UpdateDrawFrame(); + } +#endif + + // De-Initialization + //-------------------------------------------------------------------------------------- + UnloadSound(player.soundJump); + CloseAudioDevice(); + CloseWindow(); // Close window and OpenGL context + //-------------------------------------------------------------------------------------- + + return 0; +} + +void UpdateDrawFrame(void) +{ + // Update + //---------------------------------------------------------------------------------- + + Vector2 mouse_delta = GetMouseDelta(); + lookRotation.x -= mouse_delta.x * sensitivity.x; + lookRotation.y += mouse_delta.y * sensitivity.y; + + char sideway = (IsKeyDown(KEY_D) - IsKeyDown(KEY_A)); + char forward = (IsKeyDown(KEY_W) - IsKeyDown(KEY_S)); + bool crouching = IsKeyDown(KEY_LEFT_CONTROL); + UpdateBody(&player, lookRotation.x, sideway, forward, IsKeyPressed(KEY_SPACE), crouching); + + float delta = GetFrameTime(); + headLerp = Lerp(headLerp, (crouching ? CROUCH_HEIGHT : STAND_HEIGHT), 20.f * delta); + camera.position = (Vector3){ + player.position.x, + player.position.y + (BOTTOM_HEIGHT + headLerp), + player.position.z, + }; + + if (player.isGrounded && (forward != 0 || sideway != 0)) { + headTimer += delta * 3.f; + walkLerp = Lerp(walkLerp, 1.f, 10.f * delta); + camera.fovy = Lerp(camera.fovy, 55.f, 5.f * delta); + } + else { + walkLerp = Lerp(walkLerp, 0.f, 10.f * delta); + camera.fovy = Lerp(camera.fovy, 60.f, 5.f * delta); + } + + lean.x = Lerp(lean.x, sideway * 0.02f, 10.f * delta); + lean.y = Lerp(lean.y, forward * 0.015f, 10.f * delta); + + UpdateCameraAngle(&camera, &lookRotation, headTimer, walkLerp, lean); + + // Draw + //---------------------------------------------------------------------------------- + BeginDrawing(); + + ClearBackground(RAYWHITE); + + BeginMode3D(camera); + + DrawLevel(); + + EndMode3D(); + + // Draw info box + DrawRectangle(5, 5, 330, 100, Fade(SKYBLUE, 0.5f)); + DrawRectangleLines(5, 5, 330, 100, BLUE); + + DrawText("Camera controls:", 15, 15, 10, BLACK); + DrawText("- Move keys: W, A, S, D, Space, Left-Ctrl", 15, 30, 10, BLACK); + DrawText("- Look around: arrow keys or mouse", 15, 45, 10, BLACK); + DrawText(TextFormat("- Velocity Len: (%06.3f)", Vector2Length((Vector2) { player.velocity.x, player.velocity.z })), 15, 60, 10, BLACK); + + + EndDrawing(); + //---------------------------------------------------------------------------------- +} + +void UpdateBody(Body* body, float rot, char side, char forward, bool jumpPressed, bool crouchHold) +{ + Vector2 input = (Vector2){ (float)side, (float)-forward }; +#if defined(NORMALIZE_INPUT) + // Slow down diagonal movement + if (side != 0 & forward != 0) + { + input = Vector2Normalize(input); + } +#endif + + float delta = GetFrameTime(); + + if (!body->isGrounded) + { + body->velocity.y -= GRAVITY * delta; + } + if (body->isGrounded && jumpPressed) + { + body->velocity.y = JUMP_FORCE; + body->isGrounded = false; + SetSoundPitch(body->soundJump, 1.f + (GetRandomValue(-100, 100) * 0.001)); + PlaySound(body->soundJump); + } + + Vector3 front_vec = (Vector3){ sin(rot), 0.f, cos(rot) }; + Vector3 right_vec = (Vector3){ cos(-rot), 0.f, sin(-rot) }; + + Vector3 desired_dir = (Vector3){ + input.x * right_vec.x + input.y * front_vec.x, + 0.f, + input.x * right_vec.z + input.y * front_vec.z, + }; + + body->dir = Vector3Lerp(body->dir, desired_dir, CONTROL * delta); + + float decel = body->isGrounded ? FRICTION : AIR_DRAG; + Vector3 hvel = (Vector3){ + body->velocity.x * decel, + 0.f, + body->velocity.z * decel + }; + + float hvel_length = Vector3Length(hvel); // a.k.a. magnitude + if (hvel_length < MAX_SPEED * 0.01f) { + hvel = (Vector3){ 0 }; + } + + /* This is what creates strafing */ + float speed = Vector3DotProduct(hvel, body->dir); + + /* + Whenever the amount of acceleration to add is clamped by the maximum acceleration constant, + a Player can make the speed faster by bringing the direction closer to horizontal velocity angle + More info here: https://youtu.be/v3zT3Z5apaM?t=165 + */ + float max_speed = crouchHold ? CROUCH_SPEED : MAX_SPEED; + float accel = Clamp(max_speed - speed, 0.f, MAX_ACCEL * delta); + hvel.x += body->dir.x * accel; + hvel.z += body->dir.z * accel; + + body->velocity.x = hvel.x; + body->velocity.z = hvel.z; + + body->position.x += body->velocity.x * delta; + body->position.y += body->velocity.y * delta; + body->position.z += body->velocity.z * delta; + + /* Fancy collision system against "THE FLOOR" */ + if (body->position.y <= 0.f) + { + body->position.y = 0.f; + body->velocity.y = 0.f; + body->isGrounded = true; // <= enables jumping + } +} + +void UpdateCameraAngle(Camera* camera, Vector2* rot, float headTimer, float walkLerp, Vector2 lean) +{ + const Vector3 up = (Vector3){ 0.f, 1.f, 0.f }; + const Vector3 targetOffset = (Vector3){ 0.f, 0.f, -1.f }; + + /* Left & Right */ + Vector3 yaw = Vector3RotateByAxisAngle(targetOffset, up, rot->x); + + // Clamp view up + float maxAngleUp = Vector3Angle(up, yaw); + maxAngleUp -= 0.001f; // avoid numerical errors + if ( -(rot->y) > maxAngleUp) { rot->y = -maxAngleUp; } + + // Clamp view down + float maxAngleDown = Vector3Angle(Vector3Negate(up), yaw); + maxAngleDown *= -1.0f; // downwards angle is negative + maxAngleDown += 0.001f; // avoid numerical errors + if ( -(rot->y) < maxAngleDown) { rot->y = -maxAngleDown; } + + /* Up & Down */ + Vector3 right = Vector3Normalize(Vector3CrossProduct(yaw, up)); + + // Rotate view vector around right axis + Vector3 pitch = Vector3RotateByAxisAngle(yaw, right, -rot->y - lean.y); + + // Head animation + // Rotate up direction around forward axis + float _sin = sin(headTimer * PI); + float _cos = cos(headTimer * PI); + const float stepRotation = 0.01f; + camera->up = Vector3RotateByAxisAngle(up, pitch, _sin * stepRotation + lean.x); + + /* BOB */ + const float bobSide = 0.1f; + const float bobUp = 0.15f; + Vector3 bobbing = Vector3Scale(right, _sin * bobSide); + bobbing.y = fabsf(_cos * bobUp); + camera->position = Vector3Add(camera->position, Vector3Scale(bobbing, walkLerp)); + + camera->target = Vector3Add(camera->position, pitch); +} + + +void DrawLevel() +{ + const int floorExtent = 25; + const float tileSize = 5.f; + const Color tileColor1 = (Color){ 150, 200, 200, 255 }; + // Floor tiles + for (int y = -floorExtent; y < floorExtent; y++) + { + for (int x = -floorExtent; x < floorExtent; x++) + { + if ((y & 1) && (x & 1)) + { + DrawPlane((Vector3) { x * tileSize, 0.f, y * tileSize}, + (Vector2) {tileSize, tileSize}, tileColor1); + } + else if(!(y & 1) && !(x & 1)) + { + DrawPlane((Vector3) { x * tileSize, 0.f, y * tileSize}, + (Vector2) {tileSize, tileSize}, LIGHTGRAY); + } + } + } + + const Vector3 towerSize = (Vector3){ 16.f, 32.f, 16.f }; + const Color towerColor = (Color){ 150, 200, 200, 255 }; + + Vector3 towerPos = (Vector3){ 16.f, 16.f, 16.f }; + DrawCubeV(towerPos, towerSize, towerColor); + DrawCubeWiresV(towerPos, towerSize, DARKBLUE); + + towerPos.x *= -1; + DrawCubeV(towerPos, towerSize, towerColor); + DrawCubeWiresV(towerPos, towerSize, DARKBLUE); + + towerPos.z *= -1; + DrawCubeV(towerPos, towerSize, towerColor); + DrawCubeWiresV(towerPos, towerSize, DARKBLUE); + + towerPos.x *= -1; + DrawCubeV(towerPos, towerSize, towerColor); + DrawCubeWiresV(towerPos, towerSize, DARKBLUE); +} + diff --git a/examples/core/resources/huh_jump.wav b/examples/core/resources/huh_jump.wav new file mode 100644 index 0000000000000000000000000000000000000000..9ca8a2e683ef87d19f594be54d04a40dd0bade10 GIT binary patch literal 19050 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 Gd;ABC^mEGq literal 0 HcmV?d00001