Momentum-Apps/game_engine.h

#pragma once
#include <stdbool.h>
#include <gui/canvas.h>

#ifdef __cplusplus
extern "C" {
#endif

typedef enum {
    GameKeyUp = 1 << 0,
    GameKeyDown = 1 << 1,
    GameKeyRight = 1 << 2,
    GameKeyLeft = 1 << 3,
    GameKeyOk = 1 << 4,
    GameKeyBack = 1 << 5,
} GameKey;

typedef struct {
    uint32_t held; // mask of GameKey held in current frame
    uint32_t pressed; // mask of GameKey pressed in current frame
    uint32_t released; // mask of GameKey released in current frame
} InputState;

typedef struct GameEngine GameEngine;

typedef void (*GameEngineCallback)(
    GameEngine* engine,
    Canvas* canvas,
    InputState input,
    float delta_time,
    void* context);

typedef struct {
    float fps; // target fps
    bool show_fps; // show fps counter
    GameEngineCallback callback; // game logic and rendering callback, called at target fps
    void* context; // user context passed to callback
} GameEngineSettings;

/** Default settings initializer */
GameEngineSettings game_engine_settings_init(void);

/** Game Engine allocator
 * @param settings engine settings
 * @return GameEngine*  engine instance
 */
GameEngine* game_engine_alloc(GameEngineSettings settings);

/** Run the Game Engine. Blocks until game_engine_stop() is called.
 * @param engine engine instance
 */
void game_engine_run(GameEngine* engine);

/** Stop the Game Engine. Will not block execution.
 * @param engine engine instance
 */
void game_engine_stop(GameEngine* engine);

/** Free the Game Engine
 * @param engine engine instance
 */
void game_engine_free(GameEngine* engine);

#ifdef __cplusplus
}
#endif