sm64

A Super Mario 64 decompilation
Log | Files | Refs | README | LICENSE

math_util.h (3022B)

      1 #ifndef MATH_UTIL_H
      2 #define MATH_UTIL_H
      3 
      4 #include <PR/ultratypes.h>
      5 
      6 #include "types.h"
      7 
      8 /*
      9  * The sine and cosine tables overlap, but "#define gCosineTable (gSineTable +
     10  * 0x400)" doesn't give expected codegen; gSineTable and gCosineTable need to
     11  * be different symbols for code to match. Most likely the tables were placed
     12  * adjacent to each other, and gSineTable cut short, such that reads overflow
     13  * into gCosineTable.
     14  *
     15  * These kinds of out of bounds reads are undefined behavior, and break on
     16  * e.g. GCC (which doesn't place the tables next to each other, and probably
     17  * exploits array sizes for range analysis-based optimizations as well).
     18  * Thus, for non-IDO compilers we use the standard-compliant version.
     19  */
     20 extern f32 gSineTable[];
     21 #ifdef AVOID_UB
     22 #define gCosineTable (gSineTable + 0x400)
     23 #else
     24 extern f32 gCosineTable[];
     25 #endif
     26 
     27 #define sins(x) gSineTable[(u16) (x) >> 4]
     28 #define coss(x) gCosineTable[(u16) (x) >> 4]
     29 
     30 #define min(a, b) ((a) <= (b) ? (a) : (b))
     31 #define max(a, b) ((a) > (b) ? (a) : (b))
     32 
     33 #define sqr(x) ((x) * (x))
     34 
     35 void *vec3f_copy(Vec3f dest, Vec3f src);
     36 void *vec3f_set(Vec3f dest, f32 x, f32 y, f32 z);
     37 void *vec3f_add(Vec3f dest, Vec3f a);
     38 void *vec3f_sum(Vec3f dest, Vec3f a, Vec3f b);
     39 void *vec3s_copy(Vec3s dest, Vec3s src);
     40 void *vec3s_set(Vec3s dest, s16 x, s16 y, s16 z);
     41 void *vec3s_add(Vec3s dest, Vec3s a);
     42 void *vec3s_sum(Vec3s dest, Vec3s a, Vec3s b);
     43 void *vec3s_sub(Vec3s dest, Vec3s a);
     44 void *vec3s_to_vec3f(Vec3f dest, Vec3s a);
     45 void *vec3f_to_vec3s(Vec3s dest, Vec3f a);
     46 void *find_vector_perpendicular_to_plane(Vec3f dest, Vec3f a, Vec3f b, Vec3f c);
     47 void *vec3f_cross(Vec3f dest, Vec3f a, Vec3f b);
     48 void *vec3f_normalize(Vec3f dest);
     49 void mtxf_copy(Mat4 dest, Mat4 src);
     50 void mtxf_identity(Mat4 mtx);
     51 void mtxf_translate(Mat4 dest, Vec3f b);
     52 void mtxf_lookat(Mat4 mtx, Vec3f from, Vec3f to, s16 roll);
     53 void mtxf_rotate_zxy_and_translate(Mat4 dest, Vec3f translate, Vec3s rotate);
     54 void mtxf_rotate_xyz_and_translate(Mat4 dest, Vec3f b, Vec3s c);
     55 void mtxf_billboard(Mat4 dest, Mat4 mtx, Vec3f position, s16 angle);
     56 void mtxf_align_terrain_normal(Mat4 dest, Vec3f upDir, Vec3f pos, s16 yaw);
     57 void mtxf_align_terrain_triangle(Mat4 mtx, Vec3f pos, s16 yaw, f32 radius);
     58 void mtxf_mul(Mat4 dest, Mat4 a, Mat4 b);
     59 void mtxf_scale_vec3f(Mat4 dest, Mat4 mtx, Vec3f s);
     60 void mtxf_mul_vec3s(Mat4 mtx, Vec3s b);
     61 void mtxf_to_mtx(Mtx *dest, Mat4 src);
     62 void mtxf_rotate_xy(Mtx *mtx, s16 angle);
     63 void get_pos_from_transform_mtx(Vec3f dest, Mat4 objMtx, Mat4 camMtx);
     64 void vec3f_get_dist_and_angle(Vec3f from, Vec3f to, f32 *dist, s16 *pitch, s16 *yaw);
     65 void vec3f_set_dist_and_angle(Vec3f from, Vec3f to, f32  dist, s16  pitch, s16  yaw);
     66 s32 approach_s32(s32 current, s32 target, s32 inc, s32 dec);
     67 f32 approach_f32(f32 current, f32 target, f32 inc, f32 dec);
     68 s16 atan2s(f32 y, f32 x);
     69 f32 atan2f(f32 a, f32 b);
     70 void spline_get_weights(Vec4f result, f32 t, UNUSED s32 c);
     71 void anim_spline_init(Vec4s *keyFrames);
     72 s32 anim_spline_poll(Vec3f result);
     73 
     74 #endif // MATH_UTIL_H