From 64eb5b1a7aac612b350828efffa4925c8781ec8d Mon Sep 17 00:00:00 2001 From: Alexey Karnachev Date: Sat, 30 Dec 2023 15:06:54 +0400 Subject: [PATCH] Add others/gizmo example --- examples/Makefile | 3 +- examples/Makefile.Web | 6 +- examples/README.md | 1 + examples/others/gizmo.c | 113 +++++++ examples/others/gizmo.h | 656 ++++++++++++++++++++++++++++++++++++++ examples/others/gizmo.png | Bin 0 -> 35811 bytes 6 files changed, 777 insertions(+), 2 deletions(-) create mode 100644 examples/others/gizmo.c create mode 100644 examples/others/gizmo.h create mode 100644 examples/others/gizmo.png diff --git a/examples/Makefile b/examples/Makefile index 235deda28..01458c6bc 100644 --- a/examples/Makefile +++ b/examples/Makefile @@ -585,7 +585,8 @@ OTHERS = \ others/raylib_opengl_interop \ others/raymath_vector_angle \ others/rlgl_compute_shader \ - others/rlgl_standalone + others/rlgl_standalone \ + others/gizmo CURRENT_MAKEFILE = $(lastword $(MAKEFILE_LIST)) diff --git a/examples/Makefile.Web b/examples/Makefile.Web index 8bec06452..d7dbffcb5 100644 --- a/examples/Makefile.Web +++ b/examples/Makefile.Web @@ -491,7 +491,8 @@ OTHERS = \ others/raylib_opengl_interop \ others/raymath_vector_angle \ others/rlgl_compute_shader \ - others/rlgl_standalone + others/rlgl_standalone \ + others/gizmo CURRENT_MAKEFILE = $(lastword $(MAKEFILE_LIST)) @@ -1099,6 +1100,9 @@ others/rlgl_compute_shader: others/rlgl_standalone: $(info Skipping_others_rlgl_standalone) +others/gizmo: others/gizmo.c + $(CC) -o $@$(EXT) $< $(CFLAGS) $(INCLUDE_PATHS) $(LDFLAGS) $(LDLIBS) -D$(PLATFORM) + # Clean everything clean: ifeq ($(PLATFORM),PLATFORM_DESKTOP) diff --git a/examples/README.md b/examples/README.md index 0fed8acd0..dcbdd6e8a 100644 --- a/examples/README.md +++ b/examples/README.md @@ -200,6 +200,7 @@ Examples showing raylib misc functionality that does not fit in other categories | 124 | [easings_testbed](others/easings_testbed.c) | easings_testbed | ⭐️⭐️⭐️☆ | 3.0 | 3.0 | [Juan Miguel López](https://github.com/flashback-fx) | | 125 | [raylib_opengl_interop](others/raylib_opengl_interop.c) | raylib_opengl_interop | ⭐️⭐️⭐️⭐️ | **4.0** | **4.0** | [Stephan Soller](https://github.com/arkanis) | | 126 | [embedded_files_loading](others/embedded_files_loading.c) | embedded_files_loading | ⭐️⭐️☆☆ | 3.5 | 3.5 | [Kristian Holmgren](https://github.com/defutura) | +| 127 | [gizmo](others/gizmo.c) | gizmo | ⭐️⭐️☆☆ | 5.0 | 5.0 | [Alexey Karnachev](https://github.com/alexeykarnachev) | As always contributions are welcome, feel free to send new examples! Here it is an [examples template](examples_template.c) to start with! diff --git a/examples/others/gizmo.c b/examples/others/gizmo.c new file mode 100644 index 000000000..13729b6b0 --- /dev/null +++ b/examples/others/gizmo.c @@ -0,0 +1,113 @@ +#include "raylib.h" +#include "rcamera.h" + +#define RAYGIZMO_IMPLEMENTATION +#include "gizmo.h" +#undef RAYGIZMO_IMPLEMENTATION + +void updateCamera(Camera3D* camera) { + float rot_speed = 0.003f; + float move_speed = 0.01f; + float zoom_speed = 1.0f; + + bool is_middle = IsMouseButtonDown(2); + bool is_shift = IsKeyDown(KEY_LEFT_SHIFT); + Vector2 mouse_delta = GetMouseDelta(); + + if (is_middle && is_shift) { + CameraMoveRight(camera, -move_speed * mouse_delta.x, true); + + Vector3 right = GetCameraRight(camera); + Vector3 up = Vector3CrossProduct( + Vector3Subtract(camera->position, camera->target), right + ); + up = Vector3Scale(Vector3Normalize(up), move_speed * mouse_delta.y); + camera->position = Vector3Add(camera->position, up); + camera->target = Vector3Add(camera->target, up); + } else if (is_middle) { + CameraYaw(camera, -rot_speed * mouse_delta.x, true); + CameraPitch(camera, rot_speed * mouse_delta.y, true, true, false); + } + + CameraMoveToTarget(camera, -GetMouseWheelMove() * zoom_speed); +} + +int main(void) { + const int screen_width = 800; + const int screen_height = 450; + InitWindow(screen_width, screen_height, "Gizmo"); + SetTargetFPS(60); + + Camera3D camera; + camera.fovy = 45.0f; + camera.target = (Vector3){0.0f, 0.0f, 0.0f}; + camera.position = (Vector3){5.0f, 5.0f, 5.0f}; + camera.up = (Vector3){0.0f, 1.0f, 0.0f}; + camera.projection = CAMERA_PERSPECTIVE; + + Model model = LoadModelFromMesh(GenMeshTorus(0.3, 1.5, 16.0, 16.0)); + + LoadGizmo(); + + while (!WindowShouldClose()) { + updateCamera(&camera); + + BeginDrawing(); + { + ClearBackground(DARKGRAY); + rlEnableDepthTest(); + + BeginMode3D(camera); + { + // Draw main model + DrawModel(model, (Vector3){0.0, 0.0, 0.0}, 1.0, PURPLE); + + // Draw coordinates grid + rlSetLineWidth(1.0); + DrawGrid(100.0, 1.0); + + // Draw coordinate x, y and z axis + rlSetLineWidth(2.0); + DrawLine3D( + (Vector3){-50.0f, 0.0f, 0.0f}, + (Vector3){50.0f, 0.0f, 0.0f}, + RED + ); + DrawLine3D( + (Vector3){0.0f, -50.0f, 0.0f}, + (Vector3){0.0f, 50.0f, 0.0f}, + GREEN + ); + DrawLine3D( + (Vector3){0.0f, 0.0f, -50.0f}, + (Vector3){0.0f, 0.0f, 50.0f}, + DARKBLUE + ); + } + EndMode3D(); + + // Immediately update and draw gizmo + Vector3 position = { + model.transform.m12, model.transform.m13, model.transform.m14}; + Matrix transform = UpdateGizmo(camera, position); + + // Apply gizmo-produced transformation to the model + model.transform = MatrixMultiply(model.transform, transform); + + // Draw camera controll keys + DrawRectangle(0, 0, 280, 90, RAYWHITE); + DrawText("CAMERA:", 5, 5, 20, RED); + DrawText(" zoom: wheel", 5, 25, 20, RED); + DrawText(" rotate: mmb", 5, 45, 20, RED); + DrawText(" translate: shift + mmb", 5, 65, 20, RED); + } + EndDrawing(); + } + + UnloadGizmo(); + UnloadModel(model); + CloseWindow(); + + return 0; +} + diff --git a/examples/others/gizmo.h b/examples/others/gizmo.h new file mode 100644 index 000000000..c7348f67b --- /dev/null +++ b/examples/others/gizmo.h @@ -0,0 +1,656 @@ +#include +#include + +void LoadGizmo(); +void UnloadGizmo(); +Matrix UpdateGizmo(Camera3D camera, Vector3 position); + +#ifdef RAYGIZMO_IMPLEMENTATION + +#include "raymath.h" +#include +#include +#include +#include + +// This will be multiplied by the distance from the camera to the gizmo, +// Which keeps the screen-space gizmo size constant. +#define GIZMO_SIZE 0.12f + +// Line drawing thicknesses +#define GIZMO_HANDLE_DRAW_THICKNESS 5.0f +#define GIZMO_ACTIVE_AXIS_DRAW_THICKNESS 2.0f + +// These sizes are relative to the gizmo radius +#define GIZMO_AXIS_HANDLE_LENGTH 1.2; +#define GIZMO_AXIS_HANDLE_TIP_LENGTH 0.3; +#define GIZMO_AXIS_HANDLE_TIP_RADIUS 0.1; +#define GIZMO_PLANE_HANDLE_OFFSET 0.4; +#define GIZMO_PLANE_HANDLE_SIZE 0.2; + +#define X_AXIS \ + (Vector3) { 1.0, 0.0, 0.0 } +#define Y_AXIS \ + (Vector3) { 0.0, 1.0, 0.0 } +#define Z_AXIS \ + (Vector3) { 0.0, 0.0, 1.0 } + +#define MASK_FRAMEBUFFER_WIDTH 500.0 +#define MASK_FRAMEBUFFER_HEIGHT 500.0 + +#define swap(x, y) \ + do { \ + unsigned char \ + swap_temp[sizeof(x) == sizeof(y) ? (signed)sizeof(x) : -1]; \ + memcpy(swap_temp, &y, sizeof(x)); \ + memcpy(&y, &x, sizeof(x)); \ + memcpy(&x, swap_temp, sizeof(x)); \ + } while (0) + +#define id_to_red_color(id) \ + (Color) { id, 0, 0, 0 } + +static const char* SHADER_COLOR_VERT = "\ +#version 330\n\ +in vec3 vertexPosition; \ +in vec4 vertexColor; \ +out vec4 fragColor; \ +out vec3 fragPosition; \ +uniform mat4 mvp; \ +void main() { \ + fragColor = vertexColor; \ + fragPosition = vertexPosition; \ + gl_Position = mvp * vec4(vertexPosition, 1.0); \ +} \ +"; + +static const char* SHADER_ROT_HANDLE_COLOR_FRAG = "\ +#version 330\n\ +in vec4 fragColor; \ +in vec3 fragPosition; \ +uniform vec3 cameraPosition; \ +uniform vec3 gizmoPosition; \ +out vec4 finalColor; \ +void main() { \ + vec3 r = normalize(fragPosition - gizmoPosition); \ + vec3 c = normalize(fragPosition - cameraPosition); \ + if (dot(r, c) > 0.1) discard; \ + finalColor = fragColor; \ +} \ +"; + +static Shader SHADER_ROT_HANDLE_COLOR; +static int SHADER_ROT_HANDLE_CAMERA_POS_LOC; +static int SHADER_ROT_HANDLE_GIZMO_POS_LOC; + +static unsigned int MASK_FRAMEBUFFER; +static unsigned int MASK_TEXTURE; + +static bool IS_GIZMO_LOADED; +static Vector3 GIZMO_CURRENT_AXIS; + +typedef enum HandleId { + HANDLE_X, + + ROT_HANDLE_X, + AXIS_HANDLE_X, + PLANE_HANDLE_X, + + HANDLE_Y, + + ROT_HANDLE_Y, + AXIS_HANDLE_Y, + PLANE_HANDLE_Y, + + HANDLE_Z, + + ROT_HANDLE_Z, + AXIS_HANDLE_Z, + PLANE_HANDLE_Z +} HandleId; + +typedef enum GizmoState { + GIZMO_COLD, + + GIZMO_HOT, + + GIZMO_HOT_ROT, + GIZMO_HOT_AXIS, + GIZMO_HOT_PLANE, + + GIZMO_ACTIVE, + + GIZMO_ACTIVE_ROT, + GIZMO_ACTIVE_AXIS, + GIZMO_ACTIVE_PLANE, +} GizmoState; + +typedef struct Handle { + Vector3 position; + Vector3 axis; + Color color; + float dist_to_cam; +} Handle; + +typedef struct HandleColors { + Color x; + Color y; + Color z; +} HandleColors; + +typedef struct Handles { + Handle arr[3]; +} Handles; + +static GizmoState GIZMO_STATE; + +bool check_if_mouse_moved() { + Vector2 mouse_delta = GetMouseDelta(); + return (fabs(mouse_delta.x) + fabs(mouse_delta.y)) > EPSILON; +} + +static float vector2_get_angle(Vector2 v1, Vector2 v2) { + Vector2 v1_norm = Vector2Normalize(v1); + Vector2 v2_norm = Vector2Normalize(v2); + float dot = Vector2DotProduct(v1_norm, v2_norm); + if (1.0 - fabs(dot) < EPSILON) return 0.0; + + float angle = acos(dot); + float z = v1.x * v2.y - v1.y * v2.x; + + if (fabs(z) < EPSILON) return 0.0; + else if (z > 0) return angle; + else return -angle; +} + +static int isect_line_plane( + Vector3* out_p, + Vector3 line_p0, + Vector3 line_p1, + Vector3 plane_p, + Vector3 plane_normal +) { + Vector3 u = Vector3Subtract(line_p1, line_p0); + float dot = Vector3DotProduct(plane_normal, u); + if (fabs(dot) <= EPSILON) { + return 0; + } + + Vector3 w = Vector3Subtract(line_p0, plane_p); + float k = -Vector3DotProduct(plane_normal, w) / dot; + u = Vector3Scale(u, k); + *out_p = Vector3Add(line_p0, u); + return 1; +} + +static int get_two_vecs_nearest_point( + Vector3* vec0_out_nearest_point, + Vector3 vec0_p0, + Vector3 vec0_p1, + Vector3 vec1_p0, + Vector3 vec1_p1 +) { + Vector3 vec0 = Vector3Subtract(vec0_p1, vec0_p0); + Vector3 vec1 = Vector3Subtract(vec1_p1, vec1_p0); + Vector3 plane_vec = Vector3CrossProduct(vec0, vec1); + plane_vec = Vector3Normalize(plane_vec); + Vector3 plane_normal = Vector3CrossProduct(vec0, plane_vec); + plane_normal = Vector3Normalize(plane_normal); + + int is_isect = isect_line_plane( + vec0_out_nearest_point, vec1_p0, vec1_p1, vec0_p0, plane_normal + ); + + return is_isect; +} + +static RayCollision get_ray_plane_collision( + Ray ray, Vector3 plane_point, Vector3 plane_normal +) { + RayCollision collision = {0}; + + // Calculate the parameter t + float denominator = ray.direction.x * plane_normal.x + + ray.direction.y * plane_normal.y + + ray.direction.z * plane_normal.z; + + if (denominator == 0) { + // Ray is parallel to the plane, no collision + return collision; + } + + float t = ((plane_point.x - ray.position.x) * plane_normal.x + + (plane_point.y - ray.position.y) * plane_normal.y + + (plane_point.z - ray.position.z) * plane_normal.z) + / denominator; + + if (t < 0) { + // Intersection point is behind the ray's starting point, no collision + return collision; + } + + // Calculate the collision point + collision.point.x = ray.position.x + t * ray.direction.x; + collision.point.y = ray.position.y + t * ray.direction.y; + collision.point.z = ray.position.z + t * ray.direction.z; + collision.hit = true; + + return collision; +} + +static Handles get_sorted_handles(Handle h0, Handle h1, Handle h2) { + if (h0.dist_to_cam < h1.dist_to_cam) swap(h0, h1); + if (h1.dist_to_cam < h2.dist_to_cam) swap(h1, h2); + if (h0.dist_to_cam < h1.dist_to_cam) swap(h0, h1); + + Handles handles = {.arr = {h0, h1, h2}}; + return handles; +} + +static HandleColors get_handle_colors(GizmoState hot_state) { + bool is_hot = GIZMO_STATE == hot_state || GIZMO_STATE == hot_state + 4; + Color x = is_hot && GIZMO_CURRENT_AXIS.x == 1.0 ? WHITE : RED; + Color y = is_hot && GIZMO_CURRENT_AXIS.y == 1.0 ? WHITE : GREEN; + Color z = is_hot && GIZMO_CURRENT_AXIS.z == 1.0 ? WHITE : BLUE; + HandleColors colors = {x, y, z}; + return colors; +} + +static void draw_axis_handles( + Camera3D camera, + Vector3 position, + float gizmo_radius, + Color color_x, + Color color_y, + Color color_z +) { + float length = gizmo_radius * GIZMO_AXIS_HANDLE_LENGTH; + float tip_length = gizmo_radius * GIZMO_AXIS_HANDLE_TIP_LENGTH; + float tip_radius = gizmo_radius * GIZMO_AXIS_HANDLE_TIP_RADIUS; + + Vector3 px = Vector3Add(position, Vector3Scale(X_AXIS, length)); + Vector3 py = Vector3Add(position, Vector3Scale(Y_AXIS, length)); + Vector3 pz = Vector3Add(position, Vector3Scale(Z_AXIS, length)); + + Handle hx = {px, X_AXIS, color_x, Vector3DistanceSqr(px, camera.position)}; + Handle hy = {py, Y_AXIS, color_y, Vector3DistanceSqr(py, camera.position)}; + Handle hz = {pz, Z_AXIS, color_z, Vector3DistanceSqr(pz, camera.position)}; + + Handles handles = get_sorted_handles(hx, hy, hz); + + for (int i = 0; i < 3; ++i) { + Handle* h = &handles.arr[i]; + Vector3 tip_end = Vector3Add( + h->position, Vector3Scale(h->axis, tip_length) + ); + DrawLine3D(position, h->position, h->color); + DrawCylinderEx(h->position, tip_end, tip_radius, 0.0, 16, h->color); + } +} + +static void draw_plane_handles( + Camera3D camera, + Vector3 position, + float gizmo_radius, + Color color_x, + Color color_y, + Color color_z +) { + float offset = gizmo_radius * GIZMO_PLANE_HANDLE_OFFSET; + float size = gizmo_radius * GIZMO_PLANE_HANDLE_SIZE; + + Vector3 px = Vector3Add(position, (Vector3){0.0, offset, offset}); + Vector3 py = Vector3Add(position, (Vector3){offset, 0.0, offset}); + Vector3 pz = Vector3Add(position, (Vector3){offset, offset, 0.0}); + + Handle hx = {px, Z_AXIS, color_x, Vector3DistanceSqr(px, camera.position)}; + Handle hy = {py, Y_AXIS, color_y, Vector3DistanceSqr(py, camera.position)}; + Handle hz = {pz, X_AXIS, color_z, Vector3DistanceSqr(pz, camera.position)}; + + Handles handles = get_sorted_handles(hx, hy, hz); + + rlDisableBackfaceCulling(); + for (int i = 0; i < 3; ++i) { + Handle* h = &handles.arr[i]; + rlPushMatrix(); + { + rlTranslatef(h->position.x, h->position.y, h->position.z); + rlRotatef(90.0, h->axis.x, h->axis.y, h->axis.z); + DrawPlane( + Vector3Zero(), Vector2Scale(Vector2One(), size), h->color + ); + } + rlPopMatrix(); + } +} + +static void draw_rot_handles( + Camera3D camera, + Vector3 position, + float gizmo_radius, + Color color_x, + Color color_y, + Color color_z +) { + BeginShaderMode(SHADER_ROT_HANDLE_COLOR); + { + SetShaderValue( + SHADER_ROT_HANDLE_COLOR, + SHADER_ROT_HANDLE_CAMERA_POS_LOC, + &camera.position, + SHADER_UNIFORM_VEC3 + ); + SetShaderValue( + SHADER_ROT_HANDLE_COLOR, + SHADER_ROT_HANDLE_GIZMO_POS_LOC, + &position, + SHADER_UNIFORM_VEC3 + ); + DrawCircle3D(position, gizmo_radius, Y_AXIS, 90.0, color_x); + DrawCircle3D(position, gizmo_radius, X_AXIS, 90.0, color_y); + DrawCircle3D(position, gizmo_radius, X_AXIS, 0.0, color_z); + } + EndShaderMode(); +} + +static void draw_gizmo( + Camera3D camera, + Vector3 position, + Color rot_handle_color_x, + Color rot_handle_color_y, + Color rot_handle_color_z, + Color axis_handle_color_x, + Color axis_handle_color_y, + Color axis_handle_color_z, + Color plane_handle_color_x, + Color plane_handle_color_y, + Color plane_handle_color_z +) { + float radius = GIZMO_SIZE * Vector3Distance(camera.position, position); + + // Draw gizmo's handle elements + BeginMode3D(camera); + { + rlSetLineWidth(GIZMO_HANDLE_DRAW_THICKNESS); + rlDisableDepthTest(); + + draw_plane_handles( + camera, + position, + radius, + plane_handle_color_x, + plane_handle_color_y, + plane_handle_color_z + ); + + draw_rot_handles( + camera, + position, + radius, + rot_handle_color_x, + rot_handle_color_y, + rot_handle_color_z + ); + + draw_axis_handles( + camera, + position, + radius, + axis_handle_color_x, + axis_handle_color_y, + axis_handle_color_z + ); + } + EndMode3D(); + + // Draw long white line which represents current active axis + if (GIZMO_STATE == GIZMO_ACTIVE_ROT || GIZMO_STATE == GIZMO_ACTIVE_AXIS) { + BeginMode3D(camera); + { + rlSetLineWidth(GIZMO_ACTIVE_AXIS_DRAW_THICKNESS); + Vector3 half_axis_line = Vector3Scale(GIZMO_CURRENT_AXIS, 1000.0); + DrawLine3D( + Vector3Subtract(position, half_axis_line), + Vector3Add(position, half_axis_line), + WHITE + ); + } + EndMode3D(); + } + + // Draw white line from the gizmo's center to the mouse cursor when rotating + if (GIZMO_STATE == GIZMO_ACTIVE_ROT) { + rlSetLineWidth(GIZMO_ACTIVE_AXIS_DRAW_THICKNESS); + DrawLineV( + GetWorldToScreen(position, camera), GetMousePosition(), WHITE + ); + } +} + +static unsigned char get_gizmo_mask_pixel(Camera3D camera, Vector3 position) { + // ------------------------------------------------------------------- + // Draw gizmo into a separate framebuffer for the mouse pixel-picking + rlEnableFramebuffer(MASK_FRAMEBUFFER); + rlViewport(0, 0, MASK_FRAMEBUFFER_WIDTH, MASK_FRAMEBUFFER_HEIGHT); + rlClearScreenBuffers(); + rlDisableColorBlend(); + + draw_gizmo( + camera, + position, + id_to_red_color(ROT_HANDLE_X), + id_to_red_color(ROT_HANDLE_Y), + id_to_red_color(ROT_HANDLE_Z), + id_to_red_color(AXIS_HANDLE_X), + id_to_red_color(AXIS_HANDLE_Y), + id_to_red_color(AXIS_HANDLE_Z), + id_to_red_color(PLANE_HANDLE_X), + id_to_red_color(PLANE_HANDLE_Y), + id_to_red_color(PLANE_HANDLE_Z) + ); + + rlDisableFramebuffer(); + rlEnableColorBlend(); + rlViewport(0, 0, GetScreenWidth(), GetScreenHeight()); + + // ------------------------------------------------------------------- + // Pick the pixel under the mouse cursor + Vector2 mouse_position = GetMousePosition(); + unsigned char* pixels = (unsigned char*)rlReadTexturePixels( + MASK_TEXTURE, + MASK_FRAMEBUFFER_WIDTH, + MASK_FRAMEBUFFER_HEIGHT, + RL_PIXELFORMAT_UNCOMPRESSED_R8G8B8A8 + ); + + float x_ratio = Clamp(mouse_position.x / (float)GetScreenWidth(), 0.0, 1.0); + float y_ratio = Clamp( + 1.0 - (mouse_position.y / (float)GetScreenHeight()), 0.0, 1.0 + ); + int x = (int)(MASK_FRAMEBUFFER_WIDTH * x_ratio); + int y = (int)(MASK_FRAMEBUFFER_HEIGHT * y_ratio); + int idx = 4 * (y * MASK_FRAMEBUFFER_WIDTH + x); + unsigned char mask_val = pixels[idx]; + + free(pixels); + return mask_val; +} + +Matrix update_gizmo_rot(Camera3D camera, Vector3 position) { + if (!check_if_mouse_moved()) return MatrixIdentity(); + + Vector2 rot_center = GetWorldToScreen(position, camera); + Vector2 p1 = Vector2Subtract(GetMousePosition(), rot_center); + Vector2 p0 = Vector2Subtract(p1, GetMouseDelta()); + float angle = vector2_get_angle(p1, p0); + + // If we look at gizmo from behind, we should flip the rotation + if (Vector3DotProduct(GIZMO_CURRENT_AXIS, position) + > Vector3DotProduct(GIZMO_CURRENT_AXIS, camera.position)) { + angle *= -1; + } + + // We rotate gizmo relative to it's own center, so we first translate it to + // the center of world coordinates, then rotate and then translate back + Matrix transform = MatrixMultiply( + MatrixMultiply( + MatrixTranslate(-position.x, -position.y, -position.z), + MatrixRotate(GIZMO_CURRENT_AXIS, angle) + ), + MatrixTranslate(position.x, position.y, position.z) + ); + + return transform; +} + +Matrix update_gizmo_axis(Camera3D camera, Vector3 position) { + if (!check_if_mouse_moved()) return MatrixIdentity(); + + Vector2 p = Vector2Add(GetWorldToScreen(position, camera), GetMouseDelta()); + Ray r = GetMouseRay(p, camera); + Vector3 isect_p = Vector3Zero(); + bool is_isect = get_two_vecs_nearest_point( + &isect_p, + camera.position, + Vector3Add(camera.position, r.direction), + position, + Vector3Add(position, GIZMO_CURRENT_AXIS) + ); + + if (!is_isect) + { + return MatrixIdentity(); + } + + Vector3 offset = Vector3Subtract(isect_p, position); + offset = Vector3Multiply(offset, GIZMO_CURRENT_AXIS); + Matrix transform = MatrixTranslate(offset.x, offset.y, offset.z); + + return transform; +} + +Matrix update_gizmo_plane(Camera3D camera, Vector3 position) { + if (!check_if_mouse_moved()) return MatrixIdentity(); + Vector2 p = Vector2Add(GetWorldToScreen(position, camera), GetMouseDelta()); + Ray r = GetMouseRay(p, camera); + RayCollision c = get_ray_plane_collision(r, position, GIZMO_CURRENT_AXIS); + Vector3 offset = Vector3Subtract(c.point, position); + Matrix transform = MatrixTranslate(offset.x, offset.y, offset.z); + + return transform; +} + +Matrix update_gizmo(Camera3D camera, Vector3 position, unsigned char mask_val) { + bool is_lmb_down = IsMouseButtonDown(0); + + if (!is_lmb_down) GIZMO_STATE = GIZMO_COLD; + + if (GIZMO_STATE < GIZMO_ACTIVE) { + if (mask_val < HANDLE_Y) GIZMO_CURRENT_AXIS = X_AXIS; + else if (mask_val < HANDLE_Z) GIZMO_CURRENT_AXIS = Y_AXIS; + else GIZMO_CURRENT_AXIS = Z_AXIS; + + if (mask_val % 4 == 1) + GIZMO_STATE = is_lmb_down ? GIZMO_ACTIVE_ROT : GIZMO_HOT_ROT; + else if (mask_val % 4 == 2) + GIZMO_STATE = is_lmb_down ? GIZMO_ACTIVE_AXIS : GIZMO_HOT_AXIS; + else if (mask_val % 4 == 3) + GIZMO_STATE = is_lmb_down ? GIZMO_ACTIVE_PLANE : GIZMO_HOT_PLANE; + } + + switch (GIZMO_STATE) { + case GIZMO_ACTIVE_ROT: return update_gizmo_rot(camera, position); + case GIZMO_ACTIVE_AXIS: return update_gizmo_axis(camera, position); + case GIZMO_ACTIVE_PLANE: return update_gizmo_plane(camera, position); + default: return MatrixIdentity(); + } +} + +void LoadGizmo() { + if (IS_GIZMO_LOADED) return; + + SHADER_ROT_HANDLE_COLOR = LoadShaderFromMemory( + SHADER_COLOR_VERT, SHADER_ROT_HANDLE_COLOR_FRAG + ); + SHADER_ROT_HANDLE_CAMERA_POS_LOC = GetShaderLocation( + SHADER_ROT_HANDLE_COLOR, "cameraPosition" + ); + SHADER_ROT_HANDLE_GIZMO_POS_LOC = GetShaderLocation( + SHADER_ROT_HANDLE_COLOR, "gizmoPosition" + ); + + MASK_FRAMEBUFFER = rlLoadFramebuffer( + MASK_FRAMEBUFFER_WIDTH, MASK_FRAMEBUFFER_HEIGHT + ); + if (!MASK_FRAMEBUFFER) { + TraceLog(LOG_ERROR, "Failed to create gizmo's mask framebuffer"); + exit(1); + } + rlEnableFramebuffer(MASK_FRAMEBUFFER); + + MASK_TEXTURE = rlLoadTexture( + NULL, + MASK_FRAMEBUFFER_WIDTH, + MASK_FRAMEBUFFER_HEIGHT, + RL_PIXELFORMAT_UNCOMPRESSED_R32G32B32A32, + 1 + ); + rlActiveDrawBuffers(1); + rlFramebufferAttach( + MASK_FRAMEBUFFER, + MASK_TEXTURE, + RL_ATTACHMENT_COLOR_CHANNEL0, + RL_ATTACHMENT_TEXTURE2D, + 0 + ); + if (!rlFramebufferComplete(MASK_FRAMEBUFFER)) { + TraceLog(LOG_ERROR, "Gizmo's framebuffer is not complete"); + exit(1); + } + + IS_GIZMO_LOADED = true; +} + +void UnloadGizmo() { + if (!IS_GIZMO_LOADED) return; + + UnloadShader(SHADER_ROT_HANDLE_COLOR); + rlUnloadFramebuffer(MASK_FRAMEBUFFER); + rlUnloadTexture(MASK_TEXTURE); + IS_GIZMO_LOADED = false; +} + +Matrix UpdateGizmo(Camera3D camera, Vector3 position) { + if (!IS_GIZMO_LOADED) { + TraceLog(LOG_ERROR, "Gizmo must be loaded before the update"); + exit(1); + } + + unsigned char mask_val = get_gizmo_mask_pixel(camera, position); + Matrix transform = update_gizmo(camera, position, mask_val); + + // ------------------------------------------------------------------- + // Draw gizmo + HandleColors rot_handle_colors = get_handle_colors(GIZMO_HOT_ROT); + HandleColors axis_handle_colors = get_handle_colors(GIZMO_HOT_AXIS); + HandleColors plane_handle_colors = get_handle_colors(GIZMO_HOT_PLANE); + + draw_gizmo( + camera, + position, + rot_handle_colors.x, + rot_handle_colors.y, + rot_handle_colors.z, + axis_handle_colors.x, + axis_handle_colors.y, + axis_handle_colors.z, + plane_handle_colors.x, + plane_handle_colors.y, + plane_handle_colors.z + ); + + return transform; +} + +#endif + diff --git a/examples/others/gizmo.png b/examples/others/gizmo.png new file mode 100644 index 0000000000000000000000000000000000000000..b2346d4ef24c52fc9337c491c33d0081cd46c449 GIT binary patch literal 35811 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 M)78&qol`;+0G|08-~a#s literal 0 HcmV?d00001