vmupro_display.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdint.h>
#include <stdbool.h>
 
#ifdef __cplusplus
extern "C"
{
#endif
 
  typedef enum
  {
    VMUPRO_COLOR_RED = 0x00f8,         
    VMUPRO_COLOR_ORANGE = 0xa0fb,      
    VMUPRO_COLOR_YELLOW = 0x80ff,      
    VMUPRO_COLOR_YELLOWGREEN = 0x807f, 
    VMUPRO_COLOR_GREEN = 0x0005,       
    VMUPRO_COLOR_BLUE = 0x5f04,        
    VMUPRO_COLOR_NAVY = 0x0c00,        
    VMUPRO_COLOR_VIOLET = 0x1f78,      
    VMUPRO_COLOR_MAGENTA = 0x0d78,     
    VMUPRO_COLOR_GREY = 0xb6b5,        
    VMUPRO_COLOR_BLACK = 0x0000,       
    VMUPRO_COLOR_WHITE = 0xffff,       
    VMUPRO_COLOR_VMUGREEN = 0xd26c,    
    VMUPRO_COLOR_VMUINK = 0x8a28,      
  } vmupro_color_t;
 
  typedef enum {
    VMUPRO_DRAWFLAGS_NORMAL = 0x00,
    VMUPRO_DRAWFLAGS_FLIP_H = 0x01,
    VMUPRO_DRAWFLAGS_FLIP_V = 0x02
  } vmupro_drawflags_t;
 
  void vmupro_display_clear(vmupro_color_t color);
 
  void vmupro_display_refresh();
 
  uint8_t vmupro_get_global_brightness(void);
 
  void vmupro_set_global_brightness(uint8_t brightness);
 
  uint8_t *vmupro_get_front_fb();
 
  uint8_t *vmupro_get_back_fb();
 
  uint8_t *vmupro_get_back_buffer();
 
  void vmupro_start_double_buffer_renderer();
 
  void vmupro_stop_double_buffer_renderer();
 
  void vmupro_pause_double_buffer_renderer();
 
  void vmupro_resume_double_buffer_renderer();
 
  void vmupro_push_double_buffer_frame();
 
  void vmupro_draw_rect(int x1, int y1, int x2, int y2, vmupro_color_t color);
 
  void vmupro_draw_fill_rect(int x1, int y1, int x2, int y2, vmupro_color_t color);
 
  void vmupro_blit_buffer_at(uint8_t *buffer, int x, int y, int width, int height);
 
  void vmupro_blit_buffer_with_palette(uint8_t *buffer, int16_t *palette);
 
  void vmupro_blit_buffer_transparent(uint8_t *buffer, int x, int y, int width, int height, vmupro_color_t transparent_color, vmupro_drawflags_t flags);
 
  void vmupro_blit_buffer_blended(uint8_t *buffer, int x, int y, int width, int height, uint8_t alpha_level);
 
  void vmupro_blit_buffer_dithered(uint8_t *buffer, int x, int y, int width, int height, int dither_strength);
 
  void vmupro_blit_buffer_flip_h(uint8_t *buffer, int x, int y, int width, int height);
 
  void vmupro_blit_buffer_flipped(uint8_t *buffer, int x, int y, int width, int height, vmupro_drawflags_t flags);
 
  void vmupro_blit_buffer_scaled(uint8_t* buffer, int buffer_width, int src_x, int src_y, int src_width, int src_height, 
                                 int dest_x, int dest_y, int dest_width, int dest_height);
 
  void vmupro_blit_buffer_rotated_90(uint8_t* buffer, int x, int y, int width, int height, int rotation);
 
  void vmupro_blit_buffer_rotated_precise(uint8_t* buffer, int x, int y, int width, int height, int rotation_degrees);
 
  void vmupro_blit_tile_pattern(uint8_t *tile_buffer, int tile_width, int tile_height,
                                int dest_x, int dest_y, int dest_width, int dest_height);
 
  void vmupro_blit_buffer_advanced(uint8_t *buffer, int buffer_width, int src_x, int src_y, int src_width, int src_height,
                                   int dest_x, int dest_y, int dest_width, int dest_height,
                                   int flip_h, int flip_v, int transparent_color);
 
  void vmupro_draw_line(int x1, int y1, int x2, int y2, vmupro_color_t color);
 
  void vmupro_draw_circle(int cx, int cy, int radius, vmupro_color_t color);
 
  void vmupro_draw_circle_filled(int cx, int cy, int radius, vmupro_color_t color);
 
  void vmupro_draw_ellipse(int cx, int cy, int rx, int ry, vmupro_color_t color);
 
  void vmupro_draw_ellipse_filled(int cx, int cy, int rx, int ry, vmupro_color_t color);
 
  void vmupro_draw_polygon(int *points, int num_points, vmupro_color_t color);
 
  void vmupro_draw_polygon_filled(int *points, int num_points, vmupro_color_t color);
 
  void vmupro_flood_fill(int x, int y, vmupro_color_t fill_color, vmupro_color_t boundary_color);
 
  void vmupro_flood_fill_tolerance(int x, int y, vmupro_color_t fill_color, int tolerance);
 
  // Background Scrolling Functions
  void vmupro_blit_scrolling_background(uint8_t *bg_buffer, int bg_width, int bg_height, 
                                        int scroll_x, int scroll_y, int dest_width, int dest_height);
 
  void vmupro_blit_infinite_scrolling_background(uint8_t *tile_buffer, int tile_width, int tile_height,
                                                 int scroll_x, int scroll_y, int dest_width, int dest_height);
 
  void vmupro_blit_parallax_background(uint8_t *bg_buffer, int bg_width, int bg_height,
                                       int scroll_x, int scroll_y, int parallax_factor_x, int parallax_factor_y);
 
  void vmupro_blit_multi_parallax(uint8_t **bg_layers, int *layer_widths, int *layer_heights, int num_layers,
                                  int *parallax_factors_x, int *parallax_factors_y, int scroll_x, int scroll_y);
 
  void vmupro_blit_line_scroll_background(uint8_t *bg_buffer, int bg_width, int bg_height,
                                          int *scroll_x_per_line, int *scroll_y_per_line);
 
  void vmupro_blit_column_scroll_background(uint8_t *bg_buffer, int bg_width, int bg_height,
                                            int *scroll_x_per_column, int *scroll_y_per_column);
 
  // Visual Effects Functions
  void vmupro_blit_buffer_mosaic(uint8_t *buffer, int x, int y, int width, int height, int mosaic_size);
 
  void vmupro_blit_buffer_blurred(uint8_t *buffer, int x, int y, int width, int height, int blur_radius);
 
  void vmupro_apply_mosaic_to_screen(int x, int y, int width, int height, int mosaic_size);
 
  void vmupro_blit_buffer_shadow_highlight(uint8_t *buffer, int x, int y, int width, int height, int mode);
 
  void vmupro_blit_buffer_color_multiply(uint8_t *buffer, int x, int y, int width, int height, vmupro_color_t color_filter);
 
  void vmupro_blit_buffer_color_add(uint8_t *buffer, int x, int y, int width, int height, vmupro_color_t color_offset);
 
  // Collision Detection Functions
  int vmupro_sprite_collision_check(int sprite1_x, int sprite1_y, int sprite1_w, int sprite1_h,
                                    int sprite2_x, int sprite2_y, int sprite2_w, int sprite2_h);
 
  int vmupro_sprite_pixel_collision(uint8_t *sprite1, uint8_t *sprite2, int x1, int y1, int x2, int y2,
                                    int width1, int height1, int width2, int height2);
 
  // Enhanced Blending Functions
  void vmupro_blit_buffer_fixed_alpha(uint8_t *buffer, int x, int y, int width, int height, int alpha_mode);
 
  void vmupro_blend_layers_additive(uint8_t *layer1, uint8_t *layer2, int width, int height);
 
  void vmupro_blend_layers_multiply(uint8_t *layer1, uint8_t *layer2, int width, int height);
 
  void vmupro_blend_layers_screen(uint8_t *layer1, uint8_t *layer2, int width, int height);
 
  // Windowing & Masking Functions
  void vmupro_set_color_window(int x1, int y1, int x2, int y2, vmupro_color_t mask_color);
 
  void vmupro_blit_buffer_masked(uint8_t *buffer, uint8_t *mask, int x, int y, int width, int height, vmupro_drawflags_t flags);
 
  void vmupro_clear_color_window(void);
 
  // Palette Operations
  void vmupro_blit_buffer_palette_swap(uint8_t *buffer, int x, int y, int width, int height,
                                       uint16_t *old_palette, uint16_t *new_palette, int palette_size);
 
  void vmupro_animate_palette_range(uint16_t *palette, int start_index, int end_index, int shift_amount);
 
  void vmupro_interpolate_palette(uint16_t *palette1, uint16_t *palette2, uint16_t *result, int size, int factor_256);
 
  // Sprite System
  typedef struct {
    uint8_t *buffer;           
    int x, y;                  
    int width, height;         
    int flip_h, flip_v;        
    uint8_t alpha;             
    vmupro_color_t transparent_color; 
    int priority;              
  } vmupro_sprite_t;
 
  void vmupro_sprite_batch_render(vmupro_sprite_t *sprites, int num_sprites);
 
  // Multi-Layer System
  #define VMUPRO_MAX_LAYERS 8
 
  typedef struct {
    bool active;               
    uint8_t *buffer;          
    int width, height;        
    int scroll_x, scroll_y;   
    int priority;             
    uint8_t alpha;            
  } vmupro_layer_t;
 
  void vmupro_layer_create(int layer_id, int width, int height);
 
  void vmupro_layer_destroy(int layer_id);
 
  void vmupro_layer_set_scroll(int layer_id, int scroll_x, int scroll_y);
 
  void vmupro_layer_set_priority(int layer_id, int priority);
 
  void vmupro_layer_set_alpha(int layer_id, uint8_t alpha);
 
  void vmupro_layer_blit_background(int layer_id, uint8_t *bg_buffer, int bg_width, int bg_height);
 
  void vmupro_render_all_layers(void);
 
  void vmupro_blit_tile(uint8_t *buffer, int x, int y, int src_x, int src_y, int width, int height, int tilemap_width);
 
  // todo: add description from firmware
  void vmupro_blit_tile_advanced(uint8_t* buffer, int x, int y, int atlas_src_x, int atlas_src_y, int width, int height, int tilemap_width, vmupro_color_t transparent_color, vmupro_drawflags_t flags);
 
  // return whether the last buffer sent to the GPU was
  // fb_side == 0, or fb_side == 1
  // so we don't throw new frames at it before it finishes
  uint8_t vmupro_get_last_blitted_fb_side();
 
#ifdef __cplusplus
}
#endif