GET_VECTOR_ROTATION_MATRIX(3alleg4)

💖 get_vector_rotation_matrix — Allegro manual, bestie edition 💖

okay so we're in the Allegro manual, and this page is literally about spinning stuff around an axis. it's giving math but make it cute. two whole functions, one for fixed girlies and one for the float girlies. no cap.

✨ NAME ✨

get_vector_rotation_matrix, get_vector_rotation_matrix_f — these two build X, Y, Z rotation matrices when you hand them an angle. they live in the Allegro game programming library, obviously. 💅

🌸 SYNOPSIS 🌸

#include <allegro.h>

void get_vector_rotation_matrix(MATRIX *m, fixed x, y, z, fixed a);

void get_vector_rotation_matrix_f(MATRIX_f *m, float x, y, z, float a);

🦋 DESCRIPTION 🦋

okay so listen. this function constructs a transformation matrix — and what that matrix does is rotate points around the vector you specify with x, y, z (that's your axis, bestie, your little arrow through space), by the angle you give it in a.

and here's the tea about that angle: it's in binary, 256 degrees to a circle format. so a full circle is 256, not 360. don't come at it with radians, it will not understand you. 🎀

one version takes fixed values, the other takes float values. pick your fighter. both slay. ✨

👑 SEE ALSO 👑

• apply_matrix(3alleg4) — actually use the matrix you just built, iconic behaviour
• get_rotation_matrix(3alleg4) — the axis-aligned sibling
• get_align_matrix(3alleg4) — for when you wanna align to a direction
• excamera(3alleg4) — camera vibes, iykyk

and that's the whole page, bestie 🫶 this was Allegro version 4.4.3, written down and everything, so go forth and rotate responsibly. mwah. 💖✨