Walking a shape's pixels without drawing them, and why a line is not a ray.
Walking a shape's pixels without drawing them, and why a line is not a ray.The drawing functions answer "paint this shape". The enumeration functions answer "which pixels does this shape touch" — and hand you the coordinates instead of writing anything. That is what an edge walker, a ray caster or a line-of-sight test needs.
Watch the gaps appear on the left as the ray turns. Each gap is a corner a projectile would fly through.
#define CELLS 15
#define CELL_PX 20
#define GRID_PX (CELLS * CELL_PX)
#define LEFT_X 20
#define RIGHT_X (LEFT_X + GRID_PX + 40)
#define GRID_Y 40
};
if (cx < 0 || cy < 0 || cx >=
CELLS || cy >=
CELLS) {
return;
}
};
}
}
(void)t;
}
for (
int i = 0; i <=
CELLS; ++i) {
}
}
}
void* user_data
) {
(void)w; (void)dirty; (void)user_data;
}
static void*
setup(
struct bj_app* app,
void* init_data) {
(void)init_data;
return 0;
}
0, 0);
return 0;
}
static void step(
struct bj_app* app,
struct bj_tick_info tick,
void* user_data) {
(void)tick; (void)user_data;
}
}
}
static void teardown(
struct bj_app* app,
void* user_data) {
(void)app; (void)user_data;
}
int main(
int argc,
char* argv[]) {
(void)argc; (void)argv;
}
Application lifecycle: callback-driven setup, step, and teardown.
static void step(struct bj_app *app, struct bj_tick_info tick, void *user_data)
static void teardown(struct bj_app *app, void *user_data)
static void * setup(struct bj_app *app, void *init_data)
Header file for Bitmap type.
static void on_draw(struct bj_window *w, struct bj_render_target *target, const struct bj_rect *dirty, void *user_data)
Header file for Bitmap drawing functions.
void draw(bj_bitmap *bmp)
Sytem event management API.
int bj_run_app(bj_app_setup_fn setup, bj_app_step_fn step, bj_app_fixed_step_fn fixed_step, bj_app_teardown_fn teardown, void *init_data)
Drive the application lifecycle.
void bj_quit_app(struct bj_app *app, int exit_code)
Signal the given application to exit on the next iteration.
Timing snapshot handed to the step and fixed-step callbacks.
void bj_clear_bitmap(struct bj_bitmap *bitmap)
Fills the entire bitmap with the clear colour.
uint32_t bj_pack_bitmap_rgb(struct bj_bitmap *bitmap, uint8_t red, uint8_t green, uint8_t blue)
Pack an (R, G, B) triple into the bitmap's native pixel format.
struct bj_render_target bj_render_target
uint32_t bj_bool
Boolean type used throughout the Banjo API.
struct bj_bitmap bj_bitmap
struct bj_window bj_window
#define BJ_TRUE
Boolean true value (1).
void bj_enumerate_line_pixels(int x0, int y0, int x1, int y1, bj_pixel_fn callback, void *user_data)
Reports every pixel a line touches, without drawing anything.
void bj_draw_filled_rectangle(struct bj_bitmap *bitmap, const struct bj_rect *area, uint32_t pixel)
Draws a filled rectangle in the given bitmap.
void bj_draw_line(struct bj_bitmap *bitmap, int x0, int y0, int x1, int y1, uint32_t pixel)
Draws a line of pixels in the given bitmap.
void bj_enumerate_grid_ray_cells(bj_real x0, bj_real y0, bj_real x1, bj_real y1, bj_cell_fn callback, void *user_data)
Reports every grid cell a ray passes through.
void bj_dispatch_events(void)
Poll and dispatch all pending events.
void bj_close_on_escape(struct bj_window *window, const struct bj_key_event *event, void *user_data)
Handle the ESC key to close a window.
bj_key_callback_fn bj_set_key_callback(bj_key_callback_fn callback, void *user_data)
Set the global callback for keyboard key events.
int16_t y
Y coordinate of the top-left corner (pixels, can be negative).
int16_t x
X coordinate of the top-left corner (pixels, can be negative).
#define BJ_TAU
TAU in the selected bj_real precision.
#define BJ_FZERO
Zero constant in bj_real.
#define BJ_F(x)
Literal suffix helper for bj_real when float is selected.
float bj_real
Selected real type for float configuration.
Axis-aligned rectangle: a top-left corner plus a width and height.
bj_bool bj_begin(int systems, struct bj_error **error)
Initialises the system.
void bj_end(void)
De-initialises the system.
static void bj_invalidate_window(struct bj_window *window)
Mark the whole window as needing a repaint.
bj_bool bj_window_should_close(struct bj_window *window)
Report whether a window's close flag is set.
struct bj_window * bj_create_window(const char *title, uint16_t x, uint16_t y, uint16_t width, uint16_t height, uint8_t flags, struct bj_error **error)
Create a window with the given attributes.
void bj_set_window_draw_callback(struct bj_window *window, bj_window_draw_fn fn, void *user_data)
Register the redraw callback for window.
struct bj_bitmap * bj_render_target_bitmap(struct bj_render_target *target)
Reach the software framebuffer behind a render target.
void bj_destroy_window(struct bj_window *window)
Destroy a window and release its resources.
Portable main() replacement with platform-aware entry shim.
C99 math shim with bj_real precision type and scalar utilities.
static bj_bool paint_pixel(void *user_data, int x, int y)
static void fill_cell(struct grid_paint *g, int cx, int cy)
static void draw_grid_lines(struct bj_bitmap *bmp, int origin_x, uint32_t color)
static bj_bool paint_cell(void *user_data, int x, int y, bj_real t)
Header file for system interactions.
Header file for bj_window type.