zoom.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdint.h>
 
#include "ra8_err.h"
#include "ra8_ui.h"

typedef enum : uint8_t {
  k_zoom_scale_min      = 1U,   
  k_zoom_scale_max      = 8U,   
  k_zoom_strip_rows_max = 32U,  
  k_zoom_bg_gray        = 255U, 
} zoom_limits_t;

typedef enum : uint32_t {
  k_zoom_dim_max = 65535U, 
} zoom_dim_t;

typedef enum : uint16_t {
  k_zoom_settle_ms_default = 350U, 
} zoom_timing_t;

typedef enum : uint8_t {
  k_zoom_refresh_fast    = 0U, 
  k_zoom_refresh_quality = 1U, 
} zoom_refresh_t;

typedef enum : uint8_t {
  k_zoom_policy_responsive = 0U, 
  k_zoom_policy_quality    = 1U, 
} zoom_policy_t;

typedef enum : uint8_t {
  k_zoom_pan_none  = 0U, 
  k_zoom_pan_left  = 1U, 
  k_zoom_pan_right = 2U, 
  k_zoom_pan_up    = 3U, 
  k_zoom_pan_down  = 4U, 
} zoom_pan_t;

typedef ra8_err_t (*zoom_read_fn)(void*    ctx,
                                  uint32_t x,
                                  uint32_t y,
                                  uint32_t w,
                                  uint32_t h,
                                  uint8_t* out,
                                  uint32_t out_stride);

typedef struct {
  zoom_read_fn read;   
  void*        ctx;    
  uint32_t     width;  
  uint32_t     height; 
} zoom_source_t;

typedef struct {
  uint8_t* row;        
  uint32_t row_cap;    
  uint8_t* strip;      
  uint32_t strip_cap;  
  uint8_t* packed;     
  uint32_t packed_cap; 
} zoom_scratch_t;

typedef struct {
  ra8_ui_rect_t  rect;    
  zoom_refresh_t refresh; 
  bool           present; 
} zoom_present_t;

typedef struct {
  zoom_source_t  src;       
  zoom_scratch_t scratch;   
  ra8_ui_rect_t  dst;       
  uint8_t        scale;     
  uint8_t        scale_max; 
  zoom_policy_t  policy;    
  uint16_t       settle_ms; 
  int32_t        focus_x;   
  int32_t        focus_y;   
} zoom_view_cfg_t;

typedef struct {
  zoom_source_t  src;           
  zoom_scratch_t scratch;       
  ra8_ui_rect_t  dst;           
  int32_t        anchor_x;      
  int32_t        anchor_y;      
  uint32_t       last_input_ms; 
  uint16_t       settle_ms;     
  uint16_t       strip_rows;    
  uint8_t        scale;         
  uint8_t        scale_max;     
  zoom_policy_t  policy;        
  zoom_refresh_t pending_kind;  
  bool           pending;       
  bool           settle_armed;  
  bool           active;        
} zoom_view_t;

[[nodiscard]] ra8_err_t
zoom_source_init(zoom_source_t* out, zoom_read_fn read, void* ctx, uint32_t width, uint32_t height);

[[nodiscard]] ra8_err_t zoom_view_open(zoom_view_t* v, const zoom_view_cfg_t* cfg);

[[nodiscard]] ra8_err_t zoom_view_rebind(zoom_view_t* v, const zoom_source_t* src, uint32_t now_ms);

[[nodiscard]] ra8_err_t zoom_view_invalidate(zoom_view_t* v, uint32_t now_ms);

[[nodiscard]] ra8_err_t zoom_view_close(zoom_view_t* v);

[[nodiscard]] bool zoom_view_active(const zoom_view_t* v);

[[nodiscard]] ra8_err_t zoom_view_set_scale(zoom_view_t* v,
                                            uint8_t      scale,
                                            int32_t      focus_x,
                                            int32_t      focus_y,
                                            uint32_t     now_ms);

[[nodiscard]] uint8_t zoom_scale_cycle(uint8_t scale, uint8_t min, uint8_t max);

[[nodiscard]] ra8_err_t zoom_view_pan(zoom_view_t* v, int32_t dx, int32_t dy, uint32_t now_ms);

[[nodiscard]] ra8_err_t zoom_view_pan_dir(zoom_view_t* v, zoom_pan_t dir, uint32_t now_ms);

[[nodiscard]] ra8_err_t zoom_view_window(const zoom_view_t* v, ra8_ui_rect_t* out);

bool zoom_view_tick(zoom_view_t* v, uint32_t now_ms);

[[nodiscard]] ra8_err_t zoom_view_present(zoom_view_t* v, zoom_present_t* out);

[[nodiscard]] ra8_err_t zoom_view_render(zoom_view_t* v);