ez_scene.h

Go to the documentation of this file.

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

typedef enum : uint32_t {
  k_ez_page_w    = 4096U, 
  k_ez_page_h    = 3072U, 
  k_ez_tile_edge = 256U,  
  k_ez_image_id  = 1U,    
} ez_page_t;

typedef enum : uint16_t {
  k_ez_status_h    = 48U,  
  k_ez_lens_edge   = 320U, 
  k_ez_lens_border = 3U,   
  k_ez_edge_band   = 176U, 
  k_ez_ind_block   = 20U,  
  k_ez_ind_gap     = 8U,   
} ez_layout_t;

typedef enum : uint8_t {
  k_ez_page_scale_max = 4U, 
  k_ez_lens_scale_min = 4U, 
  k_ez_lens_scale_max = 8U, 
} ez_scale_t;

typedef enum : uint8_t {
  k_ez_zone_none      = 0U, 
  k_ez_zone_pan_left  = 1U, 
  k_ez_zone_pan_right = 2U, 
  k_ez_zone_pan_up    = 3U, 
  k_ez_zone_pan_down  = 4U, 
  k_ez_zone_zoom      = 5U, 
  k_ez_zone_lens      = 6U, 
  k_ez_zone_toggle    = 7U, 
} ez_zone_t;

typedef enum : uint32_t {
  k_ez_cell_bytes = k_ez_tile_edge * k_ez_tile_edge,
  k_ez_view_cols  = 6U, 
  k_ez_view_rows  = 4U, 
  k_ez_cells             = (k_ez_view_cols + 1U) * (k_ez_view_rows + 1U),
  k_ez_buckets           = 64U,                
  k_ez_cell_budget_bytes = 4U * 1024U * 1024U, 
  k_ez_prefetch_max      = 6U,                 
} ez_cache_t;

typedef enum : uint32_t {
  k_ez_row_bytes    = 1024U,              
  k_ez_strip_bytes  = 1024U * 16U,        
  k_ez_packed_bytes = (1024U * 16U) / 2U, 
} ez_scratch_t;

typedef struct {
  ra8_tile_cache_t cache;    
  zoom_tile_src_t  tiles;    
  zoom_source_t    src;      
  zoom_view_t      page;     
  zoom_view_t      lens;     
  ra8_ui_rect_t    content;  
  const void*      fb;       
  uint32_t         fb_bytes; 
  int32_t          fb_w;     
  int32_t          fb_h;     
  bool             lens_on;  
} ez_scene_t;

typedef struct {
  void*                fb;       
  uint32_t             fb_bytes; 
  int32_t              fb_w;     
  int32_t              fb_h;     
  uint8_t*             cell_mem; 
  ra8_keycache_cell_t* meta;     
  ra8_tile_key_t*      keys;     
  ra8_tile_dims_t*     dims;     
  int32_t*             buckets;  
  uint8_t*             row;      
  uint8_t*             strip;    
  uint8_t*             packed;   
} ez_scene_cfg_t;

typedef struct {
  ra8_ui_rect_t rect;    
  bool          quality; 
  bool          present; 
} ez_present_t;

typedef struct {
  uint32_t crc_1x;    
  uint32_t crc_pan;   
  uint32_t crc_2x;    
  uint32_t crc_lens;  
  uint32_t hits;      
  uint32_t misses;    
  uint32_t evictions; 
  uint16_t warmed;    
} ez_selftest_t;

[[nodiscard]] uint8_t ez_page_sample(uint32_t x, uint32_t y);

[[nodiscard]] ra8_err_t ez_tile_decode(void*                 ctx,
                                       const ra8_tile_key_t* key,
                                       uint8_t*              cell,
                                       uint32_t              cell_bytes,
                                       uint16_t*             out_w,
                                       uint16_t*             out_h);

[[nodiscard]] ra8_ui_rect_t ez_content_rect(int32_t fb_w, int32_t fb_h);

[[nodiscard]] ra8_err_t ez_scene_init(ez_scene_t* s, const ez_scene_cfg_t* cfg);

[[nodiscard]] ez_zone_t ez_zone_hit(const ez_scene_t* s, int32_t x, int32_t y);

[[nodiscard]] bool ez_scene_tap(ez_scene_t* s, int32_t x, int32_t y, uint32_t now_ms);

[[nodiscard]] ra8_err_t ez_scene_render(ez_scene_t* s);

[[nodiscard]] ra8_err_t ez_scene_present(ez_scene_t* s, ez_present_t* out);

bool ez_scene_tick(ez_scene_t* s, uint32_t now_ms);

[[nodiscard]] ra8_err_t ez_scene_prefetch(ez_scene_t* s, zoom_pan_t dir, uint16_t* out_warmed);

[[nodiscard]] ra8_err_t ez_scene_selftest(ez_scene_t* s, ez_selftest_t* out);

[[nodiscard]] uint32_t ez_fnv1a(const void* buf, uint32_t len);