app_callbacks.h

Go to the documentation of this file.

 
#ifndef APP_CALLBACKS_H
#define APP_CALLBACKS_H
 
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
 
typedef void (*app_debug_write_fn)(const char *text, void *context);
 
typedef struct {
  // Exit signals
  bool (*should_exit)(void);
  void (*signal_exit)(void);
 
  // Platform timing / wait helpers
  uint64_t (*platform_get_monotonic_time_us)(void);
  void (*platform_sleep_ms)(unsigned int ms);
  void (*platform_pump_events)(void);
 
  // Audio
  void (*audio_stop_thread)(void);
 
  app_debug_write_fn write_sync_state;
  app_debug_write_fn write_memory_report;
  app_debug_write_fn write_backtrace;
  void *debug_context;
} app_callbacks_t;

void app_callbacks_register(const app_callbacks_t *callbacks);

const app_callbacks_t *app_callbacks_get(void);
 
/* ============================================================================
 * Convenience Macros for Safe Callback Invocation
 * ============================================================================ */

#define APP_CALLBACK_VOID(callback_name)                                                                               \
  do {                                                                                                                 \
    const app_callbacks_t *__cb = app_callbacks_get();                                                                 \
    if (__cb && __cb->callback_name) {                                                                                 \
      __cb->callback_name();                                                                                           \
    }                                                                                                                  \
  } while (0)

#define APP_CALLBACK_BOOL(callback_name)                                                                               \
  ({                                                                                                                   \
    const app_callbacks_t *__cb = app_callbacks_get();                                                                 \
    (__cb && __cb->callback_name) ? __cb->callback_name() : false;                                                     \
  })

#define APP_CALLBACK_UINT64(callback_name)                                                                             \
  ({                                                                                                                   \
    const app_callbacks_t *__cb = app_callbacks_get();                                                                 \
    (__cb && __cb->callback_name) ? __cb->callback_name() : 0ULL;                                                      \
  })

#define APP_CALLBACK_VOID_UINT(callback_name, value)                                                                   \
  do {                                                                                                                 \
    const app_callbacks_t *__cb = app_callbacks_get();                                                                 \
    if (__cb && __cb->callback_name) {                                                                                 \
      __cb->callback_name(value);                                                                                      \
    }                                                                                                                  \
  } while (0)
 
#endif