window.c

Creating and managing windows with event handling.

Creating and managing windows with event handling.This demonstrates window creation, event processing, and proper cleanup. Every graphical Banjo application needs a window and must process events to remain responsive.

 
#include <banjo/app.h>
#include <banjo/main.h>
#include <banjo/event.h>
#include <banjo/log.h>
#include <banjo/system.h>
#include <banjo/window.h>
 
bj_window* window = 0;
 
static void* setup(struct bj_app* app, void* init_data) {
    (void)init_data;
 
    if (!bj_begin(BJ_VIDEO_SYSTEM, 0)) {
        bj_quit_app(app, 1);
        return 0;
    }
 
    // Create an OS window with bj_bind_window().
    // Parameters: title, x position, y position, width, height, flags
    // The last parameter (flags) can specify fullscreen, borderless, etc.
    // Returns a window handle that must be destroyed with bj_unbind_window().
    window = bj_bind_window("Simple Banjo Window", 100, 100, 800, 600, 0, 0);
 
    // Set up a keyboard callback. bj_close_on_escape is a built-in helper that
    // requests window closure when ESC is pressed.
    bj_set_key_callback(bj_close_on_escape, 0);
    return 0;
}
 
static void step(struct bj_app* app, struct bj_tick_info tick, void* user_data) {
    (void)tick;
    (void)user_data;
 
    // Process OS events (mouse, keyboard, window resize, close button, etc).
    // This must be called every frame or the window will freeze and become
    // unresponsive. Events are either handled by callbacks or can be polled.
    bj_dispatch_events();
 
    // Check if the window should close. This is set when the user clicks the
    // X button, or when a callback (like bj_close_on_escape) requests it.
    if (bj_should_close_window(window)) {
        bj_quit_app(app, 0);
    }
}
 
static void teardown(struct bj_app* app, void* user_data) {
    (void)user_data;
 
    // Destroy the window and free OS resources. Always call this before bj_end().
    bj_unbind_window(window);
    bj_end();
}
 
int main(int argc, char* argv[]) {
    (void)argc; (void)argv;
    return bj_run_app(setup, step, 0, teardown, 0);
}