time.h

Go to the documentation of this file.

#pragma once
 
#include <stdint.h>
#include <stdbool.h>
 
// ============================================================================
// sokol_time.h Integration
// ============================================================================
 
// Include sokol_time.h declarations (WITHOUT implementation)
// SOKOL_IMPL is defined only in time.c to avoid duplicate symbols
#include "../../deps/sokol/sokol_time.h"
#include "util/uthash.h"
 
// ============================================================================
// Timer Record Structure
// ============================================================================
 
typedef struct timer_record {
  char *name;           
  uint64_t start_ticks; 
  UT_hash_handle hh;    
} timer_record_t;
 
// ============================================================================
// Timer System API
// ============================================================================
 
bool timer_system_init(void);
 
void timer_system_cleanup(void);
 
bool timer_start(const char *name);
 
double timer_stop(const char *name);
 
bool timer_is_initialized(void);
 
// ============================================================================
// Convenience Macros
// ============================================================================
 
#define START_TIMER(name_fmt, ...)                                                                                     \
  do {                                                                                                                 \
    if (timer_is_initialized()) {                                                                                      \
      char _timer_name_buf[256];                                                                                       \
      snprintf(_timer_name_buf, sizeof(_timer_name_buf), name_fmt, ##__VA_ARGS__);                                     \
      (void)timer_start(_timer_name_buf);                                                                              \
    }                                                                                                                  \
  } while (0)
 
#define STOP_TIMER(name_fmt, ...)                                                                                      \
  ({                                                                                                                   \
    double _elapsed = -1.0;                                                                                            \
    if (timer_is_initialized()) {                                                                                      \
      char _timer_name_buf[256];                                                                                       \
      snprintf(_timer_name_buf, sizeof(_timer_name_buf), name_fmt, ##__VA_ARGS__);                                     \
      _elapsed = timer_stop(_timer_name_buf);                                                                          \
    }                                                                                                                  \
    _elapsed;                                                                                                          \
  })
 
// ============================================================================
// Time Unit Constants
// ============================================================================
 
#define NS_PER_US 1000.0
#define NS_PER_MS 1000000.0
#define NS_PER_SEC 1000000000.0
#define NS_PER_MIN (NS_PER_SEC * 60.0)
#define NS_PER_HOUR (NS_PER_MIN * 60.0)
#define NS_PER_DAY (NS_PER_HOUR * 24.0)
#define NS_PER_YEAR (NS_PER_DAY * 365.25) // Account for leap years
 
// ============================================================================
// Time Formatting API
// ============================================================================
 
int format_duration_ms(double milliseconds, char *buffer, size_t buffer_size);
 
int format_duration_ns(double nanoseconds, char *buffer, size_t buffer_size);
 
int format_duration_s(double seconds, char *buffer, size_t buffer_size);
 
#define STOP_TIMER_AND_LOG(timer_name, log_func, msg_fmt, ...)                                                         \
  do {                                                                                                                 \
    double _elapsed_ns = STOP_TIMER(timer_name, ##__VA_ARGS__);                                                        \
    if (_elapsed_ns >= 0.0) {                                                                                          \
      char _duration_str[32];                                                                                          \
      format_duration_ns(_elapsed_ns, _duration_str, sizeof(_duration_str));                                           \
      log_func(msg_fmt " in %s", ##__VA_ARGS__, _duration_str);                                                        \
    }                                                                                                                  \
  } while (0)
 
// ============================================================================
// Adaptive Sleep System
// ============================================================================
 
typedef struct {
  uint64_t baseline_sleep_ns;  
  double min_speed_multiplier; 
  double max_speed_multiplier; 
  double speedup_rate;         
  double slowdown_rate;        
} adaptive_sleep_config_t;
 
typedef struct {
  adaptive_sleep_config_t config;  
  double current_speed_multiplier; 
  uint64_t last_sleep_ns;          
} adaptive_sleep_state_t;
 
void adaptive_sleep_init(adaptive_sleep_state_t *state, const adaptive_sleep_config_t *config);
 
uint64_t adaptive_sleep_calculate(adaptive_sleep_state_t *state, size_t queue_depth, size_t target_depth);
 
void adaptive_sleep_do(adaptive_sleep_state_t *state, size_t queue_depth, size_t target_depth);