X-Git-Url: https://de.git.xonotic.org/?a=blobdiff_plain;f=matrixlib.h;h=505f7f91d41c31850439f9385b59a66c6345f20a;hb=e08e13fc3d6a529b276d72a6143ba2942822f05c;hp=90e816270a4b7cc5346058673f9feadba872c1a8;hpb=2fe9d8457697fb9d9846e1464829bd976da30cfc;p=xonotic%2Fdarkplaces.git diff --git a/matrixlib.h b/matrixlib.h index 90e81627..505f7f91 100644 --- a/matrixlib.h +++ b/matrixlib.h @@ -6,6 +6,8 @@ #define M_PI 3.14159265358979323846 // matches value in gcc v2 math.h #endif +//#define MATRIX4x4_OPENGLORIENTATION + typedef struct matrix4x4_s { float m[4][4]; @@ -28,15 +30,35 @@ void Matrix4x4_Concat (matrix4x4_t *out, const matrix4x4_t *in1, const matrix4x4 // swaps the rows and columns of the matrix // (is this useful for anything?) void Matrix4x4_Transpose (matrix4x4_t *out, const matrix4x4_t *in1); -// swaps the rows and columns of the rotation matrix -// (inverting the rotation, but leaving everything else the same) -void Matrix4x4_Transpose3x3 (matrix4x4_t *out, const matrix4x4_t *in1); +// creates a matrix that does the opposite of the matrix provided +// this is a full matrix inverter, it should be able to invert any matrix that +// is possible to invert +// (non-uniform scaling, rotation, shearing, and translation, possibly others) +// warning: this function is SLOW +int Matrix4x4_Invert_Full (matrix4x4_t *out, const matrix4x4_t *in1); // creates a matrix that does the opposite of the matrix provided // only supports translate, rotate, scale (not scale3) matrices void Matrix4x4_Invert_Simple (matrix4x4_t *out, const matrix4x4_t *in1); +// blends between two matrices, used primarily for animation interpolation +// (note: it is recommended to follow this with Matrix4x4_Normalize, a method +// known as nlerp rotation, often better for animation purposes than slerp) +void Matrix4x4_Interpolate (matrix4x4_t *out, matrix4x4_t *in1, matrix4x4_t *in2, double frac); +// zeros all matrix components, used with Matrix4x4_Accumulate +void Matrix4x4_Clear (matrix4x4_t *out); +// adds a weighted contribution from the supplied matrix, used to blend 3 or +// more matrices with weighting, it is recommended that Matrix4x4_Normalize be +// called afterward (a method known as nlerp rotation, often better for +// animation purposes than slerp) +void Matrix4x4_Accumulate (matrix4x4_t *out, matrix4x4_t *in, double weight); // creates a matrix that does the same rotation and translation as the matrix // provided, but no uniform scaling, does not support scale3 matrices void Matrix4x4_Normalize (matrix4x4_t *out, matrix4x4_t *in1); +// creates a matrix with vectors normalized individually (use after +// Matrix4x4_Accumulate) +void Matrix4x4_Normalize3 (matrix4x4_t *out, matrix4x4_t *in1); +// modifies a matrix to have all vectors and origin reflected across the plane +// to the opposite side (at least if axisscale is -2) +void Matrix4x4_Reflect (matrix4x4_t *out, double normalx, double normaly, double normalz, double dist, double axisscale); // creates an identity matrix // (a matrix which does nothing) @@ -102,6 +124,10 @@ void Matrix4x4_Transform4 (const matrix4x4_t *in, const float v[4], float out[4] //void Matrix4x4_SimpleUntransform (const matrix4x4_t *in, const float v[3], float out[3]); // transforms a direction vector through the rotation part of a matrix void Matrix4x4_Transform3x3 (const matrix4x4_t *in, const float v[3], float out[3]); +// transforms a positive distance plane (A*x+B*y+C*z-D=0) through a rotation or translation matrix +void Matrix4x4_TransformPositivePlane (const matrix4x4_t *in, float x, float y, float z, float d, float *o); +// transforms a standard plane (A*x+B*y+C*z+D=0) through a rotation or translation matrix +void Matrix4x4_TransformStandardPlane (const matrix4x4_t *in, float x, float y, float z, float d, float *o); // ease of use functions // immediately applies a Translate to the matrix