bitmap.h

Go to the documentation of this file.

#ifndef BJ_BITMAP_H
#define BJ_BITMAP_H
#include <banjo/api.h>
#include <banjo/error.h>
#include <banjo/pixel.h>
#include <banjo/rect.h>
#include <banjo/stream.h>

enum bj_blit_op {
    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,   
};
#ifndef BJ_NO_TYPEDEF
typedef enum bj_blit_op bj_blit_op;
#endif

enum bj_bitmap_color_role {
    BJ_BITMAP_CLEAR_COLOR = (1 << 0),  
    BJ_BITMAP_COLORKEY    = (1 << 1)   
};
 
 

struct bj_bitmap;

BANJO_EXPORT struct bj_bitmap* bj_allocate_bitmap(
    void
);

BANJO_EXPORT struct bj_bitmap* bj_create_bitmap(
    size_t           width,
    size_t           height,
    enum bj_pixel_mode    mode,
    size_t           stride
);

BANJO_EXPORT void bj_destroy_bitmap(
    struct bj_bitmap*     bitmap
);

BANJO_EXPORT struct bj_bitmap* bj_create_bitmap_from_file(
    const char*       path,
    struct bj_error**        error
);
 

BANJO_EXPORT struct bj_bitmap* bj_create_bitmap_from_pixels(
    void*            pixels,
    size_t           width,
    size_t           height,
    enum bj_pixel_mode    mode,
    size_t           stride
);

BANJO_EXPORT struct bj_bitmap* bj_copy_bitmap(
    const struct bj_bitmap* bitmap
);

BANJO_EXPORT struct bj_bitmap* bj_convert_bitmap(
    const struct bj_bitmap* bitmap,
    enum bj_pixel_mode    mode
);

BANJO_EXPORT struct bj_bitmap* bj_init_bitmap(
    struct bj_bitmap* bitmap,
    void* pixels,
    size_t width,
    size_t height,
    enum bj_pixel_mode mode,
    size_t stride
);
 
BANJO_EXPORT void bj_assign_bitmap(
    struct bj_bitmap*  bitmap,
    void*              pixels,
    size_t             width,
    size_t             height,
    enum bj_pixel_mode mode,
    size_t             stride
);
 

BANJO_EXPORT void bj_reset_bitmap(
    struct bj_bitmap* bitmap
);

BANJO_EXPORT void* bj_bitmap_pixels(
    struct bj_bitmap*     bitmap
);

BANJO_EXPORT size_t bj_bitmap_width(
    const struct bj_bitmap*     bitmap
);

BANJO_EXPORT size_t bj_bitmap_height(
    const struct bj_bitmap*     bitmap
);

BANJO_EXPORT int bj_bitmap_mode( 
    struct bj_bitmap* bitmap
);

BANJO_EXPORT size_t bj_bitmap_stride( 
    struct bj_bitmap* bitmap
);

BANJO_EXPORT void bj_make_bitmap_rgb(
    const struct bj_bitmap* bitmap,
    size_t           x,
    size_t           y,
    uint8_t*         red,
    uint8_t*         green,
    uint8_t*         blue
);

BANJO_EXPORT uint32_t bj_make_bitmap_pixel(
    struct bj_bitmap* bitmap,
    uint8_t    red,
    uint8_t    green,
    uint8_t    blue
);

BANJO_EXPORT void bj_put_pixel(
    struct bj_bitmap* bitmap,
    size_t     x,
    size_t     y,
    uint32_t   value
);

BANJO_EXPORT void bj_clear_bitmap(
    struct bj_bitmap* bitmap
);

BANJO_EXPORT void bj_set_bitmap_color(
    struct bj_bitmap*  bitmap,
    uint32_t    color,
    uint8_t     roles
);

BANJO_EXPORT void bj_enable_colorkey(
    struct bj_bitmap*  bitmap,
    bj_bool     enabled
);

BANJO_EXPORT uint32_t bj_bitmap_pixel(
    const struct bj_bitmap* bitmap,
    size_t           x,
    size_t           y
);
 

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

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

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

typedef enum {
    BJ_TEXT_HALIGN_LEFT,          
    BJ_TEXT_HALIGN_CENTER,        
    BJ_TEXT_HALIGN_RIGHT          
} bj_text_halign;

typedef enum {
    BJ_TEXT_VALIGN_TOP,           
    BJ_TEXT_VALIGN_CENTER,        
    BJ_TEXT_VALIGN_BOTTOM         
} bj_text_valign;

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

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

BANJO_EXPORT unsigned bj_measure_text(
    const char*     text,
    unsigned        height
);

BANJO_EXPORT void bj_draw_text(
    struct bj_bitmap* dst,
    unsigned          height,
    struct bj_rect    area,
    bj_text_halign    halign,
    bj_text_valign    valign,
    uint32_t          fg_native,
    const char*       text
);

BANJO_EXPORT void bj_draw_textf(
    struct bj_bitmap* dst,
    unsigned          height,
    struct bj_rect    area,
    bj_text_halign    halign,
    bj_text_valign    valign,
    uint32_t          fg_native,
    const char*       fmt,
    ...
);

BANJO_EXPORT void bj_blit_text(
    struct bj_bitmap* dst,
    unsigned          height,
    struct bj_rect    area,
    bj_text_halign    halign,
    bj_text_valign    valign,
    uint32_t          fg_native,
    uint32_t          bg_native,
    bj_mask_bg_mode   mode,
    const char*       text
);
 
#endif