ra8_jpeg_sw.h

Go to the documentation of this file.

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

typedef enum : uint8_t {
  k_ra8_jpeg_sw_pixfmt_rgb888 = 0U, 
} ra8_jpeg_sw_pixfmt_t;

typedef enum : uint8_t {
  k_ra8_jpeg_sw_quality_min     = 1U,   
  k_ra8_jpeg_sw_quality_low     = 50U,  
  k_ra8_jpeg_sw_quality_default = 75U,  
  k_ra8_jpeg_sw_quality_high    = 90U,  
  k_ra8_jpeg_sw_quality_max     = 100U, 
} ra8_jpeg_sw_quality_t;

[[nodiscard]] ra8_err_t ra8_jpeg_sw_get_dimensions(const uint8_t* jpeg_buf,
                                                   uint32_t       jpeg_len,
                                                   uint16_t*      out_w,
                                                   uint16_t*      out_h);

[[nodiscard]] ra8_err_t ra8_jpeg_sw_decode(const uint8_t* jpeg_buf,
                                           uint32_t       jpeg_len,
                                           uint8_t*       out_buf,
                                           uint32_t       out_buf_len,
                                           uint16_t*      out_w,
                                           uint16_t*      out_h);

[[nodiscard]] ra8_err_t ra8_jpeg_sw_encode(const uint8_t* rgb_buf,
                                           uint16_t       width,
                                           uint16_t       height,
                                           uint8_t        quality,
                                           uint8_t*       out_buf,
                                           uint32_t       out_buf_len,
                                           uint32_t*      out_len);
 
/* ------------------------------------------------------------------ */
/* Streaming stripe decode (#231): bounded-RAM MCU-row decoding */
/* ------------------------------------------------------------------ */

typedef enum : uint32_t {
  k_ra8_jpeg_sw_stream_min_window  = 131072U, 
  k_ra8_jpeg_sw_stream_scan_margin = 32768U,  
} ra8_jpeg_sw_stream_limits_t;

typedef ra8_err_t (*ra8_jpeg_sw_pull_fn)(void* ctx, uint8_t* buf, size_t cap, size_t* got);

typedef ra8_err_t (*ra8_jpeg_sw_geom_fn)(void*     ctx,
                                         uint16_t  width,
                                         uint16_t  height,
                                         uint8_t   channels,
                                         uint16_t  stripe_rows,
                                         uint8_t** out_stripe,
                                         uint32_t* out_stripe_cap);

typedef ra8_err_t (*ra8_jpeg_sw_rows_fn)(void*          ctx,
                                         const uint8_t* px,
                                         uint16_t       width,
                                         uint16_t       y0,
                                         uint16_t       nrows,
                                         uint8_t        channels);

typedef enum : uint8_t {
  k_ra8_jpeg_sw_stream_mcu_rows_max = 16U, 
} ra8_jpeg_sw_stream_geom_t;

[[nodiscard]] ra8_err_t ra8_jpeg_sw_decode_stripes(ra8_jpeg_sw_pull_fn pull,
                                                   void*               pull_ctx,
                                                   uint8_t*            window,
                                                   uint32_t            window_cap,
                                                   ra8_jpeg_sw_geom_fn on_geom,
                                                   ra8_jpeg_sw_rows_fn on_rows,
                                                   void*               cb_ctx);
 
#ifdef __cplusplus
}
#endif