bitmap.h

Go to the documentation of this file.

#pragma once
#include <banjo/api.h>
#include <banjo/error.h>
#include <banjo/pixel.h>
#include <banjo/rect.h>
#include <banjo/stream.h>

typedef enum {
    BJ_BLIT_OP_COPY = 0,  
    BJ_BLIT_OP_XOR,       
    BJ_BLIT_OP_OR,        
    BJ_BLIT_OP_AND,       
    BJ_BLIT_OP_ADD_SAT,   
    BJ_BLIT_OP_SUB_SAT,   
} bj_blit_op;
 
 

typedef struct bj_bitmap_t bj_bitmap;

BANJO_EXPORT bj_bitmap* bj_bitmap_alloc(
    void
);

BANJO_EXPORT bj_bitmap* bj_bitmap_new(
    size_t           width,
    size_t           height,
    bj_pixel_mode    mode,
    size_t           stride
);

BANJO_EXPORT void bj_bitmap_del(
    bj_bitmap*     p_bitmap
);

BANJO_EXPORT bj_bitmap* bj_bitmap_new_from_file(
    const char*       p_path,
    bj_error**        p_error
);

BANJO_EXPORT bj_bitmap* bj_bitmap_new_from_pixels(
    void*            p_pixels,
    size_t           width,
    size_t           height,
    bj_pixel_mode    mode,
    size_t           stride
);

BANJO_EXPORT bj_bitmap* bj_bitmap_copy(
    const bj_bitmap* p_bitmap
);

BANJO_EXPORT bj_bitmap* bj_bitmap_convert(
    const bj_bitmap* p_bitmap,
    bj_pixel_mode    mode
);

BANJO_EXPORT bj_bitmap* bj_bitmap_init(
    bj_bitmap* p_bitmap,
    void* p_pixels,
    size_t width,
    size_t height,
    bj_pixel_mode mode,
    size_t stride
);

BANJO_EXPORT void bj_bitmap_reset(
    bj_bitmap* p_bitmap
);

BANJO_EXPORT void* bj_bitmap_pixels(
    bj_bitmap*     p_bitmap
);

BANJO_EXPORT size_t bj_bitmap_width(
    const bj_bitmap*     p_bitmap
);

BANJO_EXPORT size_t bj_bitmap_height(
    const bj_bitmap*     p_bitmap
);

BANJO_EXPORT int bj_bitmap_mode( 
    bj_bitmap* p_bitmap
);

BANJO_EXPORT size_t bj_bitmap_stride( 
    bj_bitmap* p_bitmap
);

BANJO_EXPORT void bj_bitmap_rgb(
    const bj_bitmap* p_bitmap,
    size_t           x,
    size_t           y,
    uint8_t*         p_red,
    uint8_t*         p_green,
    uint8_t*         p_blue
);

BANJO_EXPORT uint32_t bj_bitmap_pixel_value(
    bj_bitmap* p_bitmap,
    uint8_t    red,
    uint8_t    green,
    uint8_t    blue
);

BANJO_EXPORT void bj_bitmap_put_pixel(
    bj_bitmap* p_bitmap,
    size_t     x,
    size_t     y,
    uint32_t   value
);

BANJO_EXPORT void bj_bitmap_clear(
    bj_bitmap* p_bitmap
);

BANJO_EXPORT void bj_bitmap_set_colorkey(
    bj_bitmap*  p_bitmap,
    bj_bool     enabled,
    uint32_t    key_value
);

BANJO_EXPORT uint32_t bj_bitmap_get(
    const bj_bitmap* p_bitmap,
    size_t           x,
    size_t           y
);

BANJO_EXPORT void bj_bitmap_set_clear_color(
    bj_bitmap* p_bitmap,
    uint32_t clear_color
);

BANJO_EXPORT bj_bool bj_bitmap_blit(
    const bj_bitmap* src, const bj_rect* src_area,
    bj_bitmap* dst, const bj_rect* dst_area,
    bj_blit_op op);

BANJO_EXPORT bj_bool bj_bitmap_blit_stretched(
    const bj_bitmap* src, const bj_rect* src_area,
    bj_bitmap* dst, const bj_rect* dst_area,
    bj_blit_op op);

typedef enum {
    BJ_MASK_BG_TRANSPARENT = 0,   
    BJ_MASK_BG_OPAQUE,            
    BJ_MASK_BG_REV_TRANSPARENT    
} bj_mask_bg_mode;

BANJO_EXPORT bj_bool bj_bitmap_blit_mask(
    const bj_bitmap* mask,
    const bj_rect*   mask_area,     /* NULL = full mask */
    bj_bitmap*       dst,
    const bj_rect*   dst_area,      /* NULL = place at {0,0} w/ mask_area size */
    uint32_t         fg_native,     /* dst-native packed color */
    uint32_t         bg_native,     /* dst-native packed color */
    bj_mask_bg_mode  mode
);

BANJO_EXPORT bj_bool bj_bitmap_blit_mask_stretched(
    const bj_bitmap* mask,
    const bj_rect*   mask_area,     /* NULL = full mask */
    bj_bitmap*       dst,
    const bj_rect*   dst_area,      /* NULL = fill entire dst */
    uint32_t         fg_native,
    uint32_t         bg_native,
    bj_mask_bg_mode  mode
);

BANJO_EXPORT void bj_bitmap_print(
    bj_bitmap*      dst,
    int             x,
    int             y,
    unsigned        height,
    uint32_t        fg_native,
    const char*     text
);

BANJO_EXPORT void bj_bitmap_printf(
    bj_bitmap*     p_bitmap,
    int            x,
    int            y,
    unsigned       height,
    uint32_t       fg_native,
    const char*    fmt,
    ...
);

BANJO_EXPORT void bj_bitmap_blit_text(
    bj_bitmap*      dst,
    int             x,
    int             y,
    unsigned        height,
    uint32_t        fg_native,
    uint32_t        bg_native,
    bj_mask_bg_mode mode,            /* TRANSPARENT / OPAQUE / REV_TRANSPARENT */
    const char*     text
);