lg_misc.h

/*
 *      LibGame - Copyright (C) Emmanuel Thomas-Maurin 2011-2026
 *      All rights reserved
 */
 
#ifndef LG_MISC_H
#define LG_MISC_H
 
/*
 * Wrappers for these file ops funcs
 */
#define mkdir_2(...)    mkdir(__VA_ARGS__)
#define fopen_2(...)    fopen(__VA_ARGS__)
 
/* Testing if value is in interval */
#define IN_RANGE_i_(v, min, max)        (v >= min && v <= max ? TRUE : FALSE)           /* _i_ = inclusive */
#define IN_RANGE_e_(v, min, max)        (v > min && v < max ? TRUE : FALSE)             /* _e_ = exclusive */
#define OUT_OF_RANGE_i_(v, min, max)    (v <= min && v >= max ? TRUE : FALSE)
#define OUT_OF_RANGE_e_(v, min, max)    (v < min && v > max ? TRUE : FALSE)
 
typedef enum {LG_LITTLE_ENDIAN, LG_BIG_ENDIAN} lg_endianness;
 
/* Width in bytes */
typedef enum {
        WBY_8_BIT =     1,
        WBY_16_BIT =    2,
        WBY_32_BIT =    4,
        WBY_64_BIT =    8
} WidthInBytes;
 
/*
 * A few conversions helpers
 *
 * 1 knot (KT) = 1 nautical mile (NM) / h
 */
#define FEET_TO_METERS          0.3048
#define METERS_TO_FEET          (1 / FEET_TO_METERS)
#define MILES_TO_KM             1.852
#define KM_TO_MILES             (1 / MILES_TO_KM)
#define KNOTS_TO_KMH            MILES_TO_KM
#define KMH_TO_KNOTS            KM_TO_MILES
 
/* Only for backward compatibility */
#define UTF8_RW_ROUNDED_ARROW   RW_ROUNDED_ARROW_UTF8
 
// === Tokens, UTF-8 hex codes and drawings ===
 
#define LEFT_ARROW_LIGHT_UTF8   "\u2190"        //      ←
#define RIGHT_ARROW_LIGHT_UTF8  "\u2192"        //      →
#define UP_ARROW_LIGHT_UTF8     "\u2191"        //      ↑
#define DOWN_ARROW_LIGHT_UTF8   "\u2193"        //      ↓
#define RW_ROUNDED_ARROW_UTF8   "\u279c"        //      ➜
 
/*
        BOX_N_UTF8
 
        1--2--3-----4
        5     |     |
        6-----7-----8
        |     |     |
        9----10----11
*/
 
#define BOX_1_UTF8      "\u250c"        //      ┌
#define BOX_2_UTF8      "\u2500"        //      ─
#define BOX_3_UTF8      "\u252c"        //      ┬
#define BOX_4_UTF8      "\u2510"        //      ┐
#define BOX_5_UTF8      "\u2502"        //      │
#define BOX_6_UTF8      "\u251c"        //      ├
#define BOX_7_UTF8      "\u253c"        //      ┼
#define BOX_8_UTF8      "\u2524"        //      ┤
#define BOX_9_UTF8      "\u2514"        //      └
#define BOX_10_UTF8     "\u2534"        //      ┴
#define BOX_11_UTF8     "\u2518"        //      ┘
 
typedef struct {
        struct timeval  start_time;     /* In s and µs */
        float           elapsed_time;   /* In ms */
} LG_Stopwatch;
 
void            lg_enable_transparency();
 
void            lg_disable_transparency();
 
int             lg_check_gl_errors(uint64_t, const char *, int, const char *);
 
int             lg_check_gl_context();
 
lg_endianness   lg_get_arch_endianness();
 
float           lg_tv_diff(struct timeval *, struct timeval *, struct timeval *);
 
void            lg_stopwatch_start(LG_Stopwatch *);
 
void            lg_stopwatch_pause(LG_Stopwatch *);
 
void            lg_stopwatch_resume(LG_Stopwatch *);
 
float           lg_stopwatch_get_elapsed_time(LG_Stopwatch *);
 
int             delta_i(int);
 
float           delta_f(float);
 
zboolean        has_changed_i(int);
 
zboolean        has_changed_f(float);
 
double          clamp(double, double, double);
 
void            *lg_align_up_to_next_4_bytes_boundary(void *);
 
void            *lg_align_up_to_next_8_bytes_boundary(void *);
 
void            lg_swap_values(void *, void *, WidthInBytes);
 
void            debug_start_max_int_in_loop();
 
void            debug_max_int_in_loop(unsigned long, const char *, int);
 
void            debug_end_max_int_in_loop();
 
void            debug_start_max_float_in_loop();
 
void            debug_max_float_in_loop(float, const char *, int);
 
void            debug_end_max_float_in_loop();
 
int             lg_check_datatype_sizes();
 
void            lg_show_struct_sizes(zboolean);
 
int             lg_show_pixel_format_info_from_sdl_display_mode(SDL_DisplayMode *);
 
void            lg_show_utf8_drawings(zboolean);
 
#endif /* LG_MISC_H */