longstrip.h

Go to the documentation of this file.

 
#pragma once
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <stdint.h>
 
#include "jof.h"
#include "ra8_err.h"
#include "ra8_tile_cache.h"

typedef enum : uint16_t {
  k_longstrip_max_visible_bands = 4096U, 
  k_longstrip_max_prefetch      = 8U,    
} longstrip_limits_t;

typedef ra8_err_t (*longstrip_blit_fn)(void*          ctx,
                                       const uint8_t* pixels,
                                       uint16_t       src_w,
                                       uint16_t       src_h,
                                       uint8_t        bpp,
                                       int32_t        dst_x,
                                       int32_t        dst_y);

typedef struct {
  jof_pread_fn pread;       
  void*        pread_ctx;   
  jof_info_t   info;        
  uint8_t*     scratch;     
  uint32_t     scratch_cap; 
} longstrip_decode_ctx_t;

typedef struct {
  jof_pread_fn      pread;      
  void*             pread_ctx;  
  uint64_t          atlas_size; 
  ra8_tile_cache_t* cache;      
  uint32_t          image_id;   
  uint16_t          viewport_w; 
  uint16_t          viewport_h; 
  longstrip_blit_fn blit;       
  void*             blit_ctx;   
} longstrip_cfg_t;

typedef struct {
  jof_info_t        info;       
  uint32_t          canvas_w;   
  uint32_t          canvas_h;   
  uint16_t          band_h;     
  uint16_t          band_count; 
  uint16_t          viewport_w; 
  uint16_t          viewport_h; 
  int32_t           scroll_y;   
  int32_t           max_scroll; 
  int32_t           velocity;   
  ra8_tile_cache_t* cache;      
  uint32_t          image_id;   
  longstrip_blit_fn blit;       
  void*             blit_ctx;   
} longstrip_t;

typedef struct {
  uint16_t bands_drawn;  
  uint16_t skipped;      
  uint32_t covered_rows; 
} longstrip_render_stats_t;

[[nodiscard]] ra8_err_t longstrip_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_err_t longstrip_open(longstrip_t* wt, const longstrip_cfg_t* cfg);

[[nodiscard]] ra8_err_t
longstrip_set_viewport(longstrip_t* wt, uint16_t viewport_w, uint16_t viewport_h);

[[nodiscard]] int32_t longstrip_clamp_scroll(const longstrip_t* wt, int32_t y);

[[nodiscard]] ra8_err_t longstrip_band_at_y(const longstrip_t* wt, uint32_t y, uint16_t* out_band);

[[nodiscard]] ra8_err_t longstrip_visible_bands(const longstrip_t* wt,
                                                int32_t            scroll_y,
                                                uint16_t*          out_first,
                                                uint16_t*          out_last);

[[nodiscard]] ra8_err_t longstrip_scroll_by(longstrip_t* wt, int32_t delta);

[[nodiscard]] ra8_err_t longstrip_fling(longstrip_t* wt, int32_t v0);

bool longstrip_tick(longstrip_t* wt);

[[nodiscard]] ra8_err_t longstrip_prefetch(longstrip_t* wt, uint16_t depth);

[[nodiscard]] ra8_err_t longstrip_render(longstrip_t* wt, longstrip_render_stats_t* stats);
 
#ifdef __cplusplus
}
#endif