video/rgba/image.h

Go to the documentation of this file.

#pragma once

 
#include <stdio.h>
#include <stdlib.h>
#include <stdint.h>
 
#include <libplatform/compiler.h>
#include <ascii-chat/common.h>
#include <libplatform/terminal.h>
 
// Keep dependency structures at their normal alignment; only image types are packed.
#ifdef _WIN32
#pragma pack(push, 1)
#endif
 
/* ============================================================================
 * 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 struct {
  int w;               
  int h;               
  rgb_pixel_t *pixels; 
} 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);

void image_clear(image_t *p);

image_t *image_new_copy(const image_t *source);

 
/* ============================================================================
 * 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
 * @{
 */

char *image_print_with_capabilities(const image_t *image, const terminal_capabilities_t *caps, const char *palette);

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