#ifndef UTIL_H #define UTIL_H #include "twn_types.h" #include "twn_engine_api.h" #include "twn_types.h" #include #include #include /* DON'T FORGET ABOUT DOUBLE EVALUATION */ /* YOU THINK YOU WON'T, AND THEN YOU DO */ /* C23's typeof could fix it, so i will */ /* leave them as macros to be replaced. */ /* use the macro in tgmath.h for floats */ #define MAX SDL_max #define MIN SDL_min #ifndef M_PI #define M_PI 3.14159265358979323846264338327950288 /**< pi */ #endif /* multiply by these to convert degrees <---> radians */ #define DEG2RAD (M_PI / 180) #define RAD2DEG (180 / M_PI) /* */ /* GENERAL UTILITIES */ /* */ TWN_API void cry_impl(const char *file, const int line, const char *title, const char *text); #define CRY(title, text) cry_impl(__FILE__, __LINE__, title, text) #define CRY_SDL(title) cry_impl(__FILE__, __LINE__, title, SDL_GetError()) #define CRY_PHYSFS(title) \ cry_impl(__FILE__, __LINE__, title, PHYSFS_getErrorByCode(PHYSFS_getLastErrorCode())) TWN_API void log_info(const char *restrict format, ...); TWN_API void log_critical(const char *restrict format, ...); TWN_API void log_warn(const char *restrict format, ...); /* for when there's absolutely no way to continue */ TWN_API _Noreturn void die_abruptly(void); /* "critical" allocation functions which will log and abort() on failure. */ /* if it is reasonable to handle this gracefully, use the standard versions. */ /* the stb implementations will be configured to use these */ TWN_API void *cmalloc(size_t size); TWN_API void *crealloc(void *ptr, size_t size); TWN_API void *ccalloc(size_t num, size_t size); /* TODO: this is why generics were invented. sorry, i'm tired today */ TWN_API double clamp(double d, double min, double max); TWN_API float clampf(float f, float min, float max); TWN_API int clampi(int i, int min, int max); /* sets buf_out to a pointer to a byte buffer which must be freed. */ /* returns the size of this buffer. */ TWN_API int64_t file_to_bytes(const char *path, unsigned char **buf_out); /* returns a pointer to a string which must be freed */ TWN_API char *file_to_str(const char *path); /* returns true if the file exists in the filesystem */ TWN_API bool file_exists(const char *path); /* saves all texture atlases as BMP files in the write directory */ TWN_API void textures_dump_atlases(void); /* returns true if str ends with suffix */ TWN_API TWN_API bool strends(const char *str, const char *suffix); /* */ /* GAME LOGIC UTILITIES */ /* */ /* calculates the overlap of two rectangles and places it in result. */ /* result may be NULL. if this is the case, it will simply be ignored. */ /* returns true if the rectangles are indeed intersecting. */ TWN_API bool overlap_rect(const Recti *a, const Recti *b, Recti *result); TWN_API bool overlap_frect(const Rect *a, const Rect *b, Rect *result); /* returns true if two rectangles are intersecting */ TWN_API bool intersect_rect(const Recti *a, const Recti *b); TWN_API bool intersect_frect(const Rect *a, const Rect *b); /* TODO: generics and specials (see m_vec2_from() for an example)*/ TWN_API Rect to_frect(Recti rect); TWN_API Vec2 frect_center(Rect rect); /* decrements an lvalue (which should be an int), stopping at 0 */ /* meant for tick-based timers in game logic */ /* * example: * tick_timer(&player->jump_air_timer); */ TWN_API void tick_timer(int *value); /* decrements a floating point second-based timer, stopping at 0.0 */ /* meant for poll based real time logic in game logic */ /* note that it should be decremented only on the next tick after its creation */ TWN_API void tick_ftimer(float *value); /* same as `tick_ftimer` but instead of clamping it repeats */ /* returns true if value was cycled */ TWN_API bool repeat_ftimer(float *value, float at); #endif