bitmap_blit.c

Bitmap blitting - copying rectangular regions between bitmaps.

Bitmap blitting - copying rectangular regions between bitmaps.Blitting (BLock Image Transfer) is the fundamental operation for composing images. This example loads multiple images, blits them onto an off-screen bitmap to create a composite scene, then displays the result. This technique is essential for sprites, tiling, and UI composition.

#define BJ_AUTOMAIN_CALLBACKS
#include <banjo/bitmap.h>
#include <banjo/event.h>
#include <banjo/log.h>
#include <banjo/main.h>
#include <banjo/memory.h>
#include <banjo/renderer.h>
#include <banjo/system.h>
#include <banjo/time.h>
#include <banjo/window.h>
 
#define WINDOW_W 800
#define WINDOW_H 600
 
bj_window* window     = 0;
bj_renderer* renderer = 0;
 
int bj_app_begin(void** user_data, int argc, char* argv[]) {
    (void)user_data; (void)argc; (void)argv;
 
    // Create an off-screen bitmap to compose our final image. This is where
    // we'll blit all the source images before displaying the result.
    bj_bitmap* bmp_rendering = bj_create_bitmap(WINDOW_W, WINDOW_H, BJ_PIXEL_MODE_BGR24, 0);
    bj_set_bitmap_color(bmp_rendering, bj_make_bitmap_pixel(bmp_rendering, 0xFF, 0x00, 0x00), BJ_BITMAP_CLEAR_COLOR);
    bj_clear_bitmap(bmp_rendering);
 
    // Load source images that we'll composite together.
    bj_bitmap* bmp_blackbuck_512_512 = bj_create_bitmap_from_file(BANJO_ASSETS_DIR"/bmp/blackbuck.bmp", 0);
    bj_bitmap* bmp_greenland_grid_velo_762_1309 = bj_create_bitmap_from_file(BANJO_ASSETS_DIR"/bmp/greenland_grid_velo.bmp", 0);
    bj_bitmap* bmp_lena_512_512 = bj_create_bitmap_from_file(BANJO_ASSETS_DIR"/bmp/lena.bmp", 0);
    bj_bitmap* bmp_snail_256_256 = bj_create_bitmap_from_file(BANJO_ASSETS_DIR"/bmp/snail.bmp", 0);
 
    // bj_blit() copies a rectangular region from source to destination.
    // Parameters: source bitmap, source rect, dest bitmap, dest rect, operation
    //
    // Source rect defines what region to copy (x, y, width, height).
    // Dest rect only needs x, y for position (width/height from source rect).
    // BJ_BLIT_OP_COPY is a direct pixel copy with no blending.
    //
    // This is efficient for sprite rendering - load one sprite sheet and blit
    // individual frames or tiles as needed.
    bj_blit(bmp_greenland_grid_velo_762_1309, &(bj_rect){.x = 0, .y = 0, .w = 762, .h = 1309}, bmp_rendering, & (bj_rect){.x = 20, .y = 0}, BJ_BLIT_OP_COPY);
    bj_blit(bmp_blackbuck_512_512, &(bj_rect){.x = 100, .y = 100, .w = 512, .h = 512}, bmp_rendering, & (bj_rect){.x = 100, .y = 200}, BJ_BLIT_OP_COPY);
    bj_blit(bmp_snail_256_256, &(bj_rect){.x = 0, .y = 0, .w = 256, .h = 256}, bmp_rendering, & (bj_rect){.x = 500, .y = 130}, BJ_BLIT_OP_COPY);
 
    // Destroy source bitmaps after blitting. The pixels are copied, so we
    // don't need to keep the sources in memory.
    bj_destroy_bitmap(bmp_snail_256_256);
    bj_destroy_bitmap(bmp_lena_512_512);
    bj_destroy_bitmap(bmp_greenland_grid_velo_762_1309);
    bj_destroy_bitmap(bmp_blackbuck_512_512);
 
    if(!bj_begin(BJ_VIDEO_SYSTEM, 0)) {
        return bj_callback_exit_error;
    }
 
    renderer = bj_create_renderer(BJ_RENDERER_TYPE_SOFTWARE, 0);
    window = bj_bind_window("Blitmap Blit", 0, 0, WINDOW_W, WINDOW_H, 0, 0);
 
    bj_renderer_configure(renderer, window, 0);
    bj_set_key_callback(bj_close_on_escape, 0);
 
    // Blit the composed image to the framebuffer for display.
    bj_blit(bmp_rendering, 0, bj_get_framebuffer(renderer), 0, BJ_BLIT_OP_COPY);
    bj_destroy_bitmap(bmp_rendering);
 
    bj_present(renderer, window);
 
    return bj_callback_continue;
}
 
int bj_app_iterate(void* user_data) {
    (void)user_data;
    bj_dispatch_events();
 
    bj_sleep(30);
 
    return bj_should_close_window(window) 
         ? bj_callback_exit_success 
         : bj_callback_continue;
}
 
int bj_app_end(void* user_data, int status) {
    (void)user_data;
    bj_destroy_renderer(renderer);
    bj_unbind_window(window);
    bj_end();
    return status;
}