template_callbacks.c

Loop-based program structure using Banjo's application API.

Loop-based program structure using Banjo's application API.This is the canonical Banjo program shape: a struct bj_app populated with setup, step, and teardown function pointers, passed to bj_run_app which drives the lifecycle. The same source compiles and runs the same way on Linux, macOS, Windows, and Emscripten.

 
#include <banjo/app.h>
#include <banjo/main.h>
#include <banjo/log.h>
#include <banjo/system.h>
 
// Called once at program startup. Initialize your resources here.
static void* setup(struct bj_app* app, void* init_data) {
    (void)init_data;
 
    // Initialize Banjo subsystems. Same as in template.c.
    if (!bj_begin(BJ_VIDEO_SYSTEM | BJ_AUDIO_SYSTEM, 0)) {
        bj_quit_app(app, 1);
        return 0;
    }
    return 0;
}
 
// Called repeatedly in a loop. Your main logic goes here. Call bj_quit_app
// to exit the loop and proceed to teardown.
static void step(struct bj_app* app, struct bj_tick_info tick, void* user_data) {
    (void)tick;
    (void)user_data;
 
    bj_info("Hello Banjo!");
 
    // Exit after one iteration for this simple example. In a real program,
    // you'd keep iterating until the user closes the window or some exit
    // condition is met.
    bj_quit_app(app, 0);
}
 
// Called once after the loop ends. Cleanup your resources here.
static void teardown(struct bj_app* app, void* user_data) {
    (void)user_data;
 
    // Shutdown Banjo and release resources.
    bj_end();
}
 
int main(int argc, char* argv[]) {
    (void)argc; (void)argv;
    return bj_run_app(setup, step, 0, teardown, 0);
}