video/image.h

Go to the documentation of this file.

#pragma once
 
#ifdef _WIN32
#pragma pack(push, 1)
#endif
 
#include <stdio.h>
#include <stdlib.h>
#include <stdint.h>
 
#include "../platform/abstraction.h"
#include "../common.h"
 
/* ============================================================================
 * Data Structures
 * ============================================================================
 */
 
typedef struct {
  uint8_t r; 
  uint8_t g; 
  uint8_t b; 
} PACKED_ATTR rgb_pixel_t;
 
typedef struct {
  uint8_t r;       
  uint8_t g;       
  uint8_t b;       
  uint8_t padding; 
} ALIGNED_ATTR(16) rgb_pixel_simd_t;
 
typedef enum {
  IMAGE_ALLOC_SIMD = 0, 
  IMAGE_ALLOC_POOL = 1  
} image_alloc_method_t;
 
typedef struct {
  int w;                
  int h;                
  rgb_pixel_t *pixels;  
  uint8_t alloc_method; 
} image_t;
 
/* ============================================================================
 * Image Size Constants
 * ============================================================================
 */
 
#define IMAGE_MAX_WIDTH 3840
 
#define IMAGE_MAX_HEIGHT 2160
 
#define IMAGE_MAX_PIXELS_SIZE (IMAGE_MAX_WIDTH * IMAGE_MAX_HEIGHT * sizeof(rgb_pixel_t))
 
/* ============================================================================
 * Image Allocation and Management Functions
 * @{
 */
 
image_t *image_new(size_t width, size_t height);
 
void image_destroy(image_t *p);
 
image_t *image_new_from_pool(size_t width, size_t height);
 
void image_destroy_to_pool(image_t *image);
 
void image_clear(image_t *p);
 
/* ============================================================================
 * ASCII Conversion Functions
 * @{
 */
 
char *image_print(const image_t *p, const char *palette);
 
char *image_print_color(const image_t *p, const char *palette);
 
/* ============================================================================
 * Capability-Aware ASCII Conversion Functions
 * @{
 */
 
// Capability-aware image printing functions
#include "../platform/terminal.h"
 
char *image_print_with_capabilities(const image_t *image, const terminal_capabilities_t *caps, const char *palette,
                                    const char luminance_palette[256]);
 
char *image_print_256color(const image_t *image, const char *palette);
 
char *image_print_16color(const image_t *image, const char *palette);
 
char *image_print_16color_dithered(const image_t *image, const char *palette);
 
char *image_print_16color_dithered_with_background(const image_t *image, bool use_background, const char *palette);
 
/* ============================================================================
 * Color Processing Functions
 * @{
 */
 
void quantize_color(int *r, int *g, int *b, int levels);
 
void precalc_rgb_palettes(const float red, const float green, const float blue);
 
/* ============================================================================
 * Image Resizing Functions
 * @{
 */
 
void image_resize(const image_t *source, image_t *dest);
 
void image_resize_interpolation(const image_t *source, image_t *dest);
 
/* ============================================================================
 * ANSI Color Code Generation Functions
 * @{
 */
 
char *rgb_to_ansi_fg(int r, int g, int b);
 
char *rgb_to_ansi_bg(int r, int g, int b);
 
void rgb_to_ansi_8bit(int r, int g, int b, int *fg_code, int *bg_code);
 
#ifdef _WIN32
#pragma pack(pop)
#endif