ansi.h

Go to the documentation of this file.

 
#ifndef ASCIICHAT_VIDEO_TERMINAL_ANSI_H
#define ASCIICHAT_VIDEO_TERMINAL_ANSI_H
 
#include <ascii-chat/common.h>
#include <ascii-chat/util/lifecycle.h>
#include <ascii-chat/video/ascii/common.h>
#include <ascii-chat/util/math.h>
#include <ascii-chat/platform/init.h>
#include <ascii-chat/options/options.h>
#include <stddef.h>
#include <stdint.h>
#include <stdbool.h>
 
#define ANSI_RESET "\033[0m"
 
#ifdef __cplusplus
extern "C" {
#endif
 
/* ===== ANSI Mode Enumeration ===== */
typedef enum {
  ANSI_MODE_FOREGROUND = 0,
  ANSI_MODE_BACKGROUND,
  ANSI_MODE_FOREGROUND_BACKGROUND,
} ansi_color_mode_t;
 
/* ===== Run-Length Encoding Context ===== */
typedef struct {
  char *buffer;
  size_t capacity;
  size_t length;
  ansi_color_mode_t mode;
  bool first_pixel;
  uint8_t last_r;
  uint8_t last_g;
  uint8_t last_b;
} ansi_rle_context_t;
 
/* ===== ANSI Timing ===== */
typedef struct {
  uint64_t start_ns;
  uint64_t end_ns;
} ansi_timing_t;
 
/* ===== RGB Error for Dithering ===== */
typedef struct {
  int r;
  int g;
  int b;
} rgb_error_t;
 
/* ===== Basic ANSI Utilities ===== */
 
char *ansi_strip_escapes(const char *input, size_t input_len);
 
const char *ansi_skip_escape(const char *ptr, const char *end);
 
bool ansi_is_already_colorized(const char *message, size_t pos);
 
/* ===== Truecolor Functions ===== */
 
char *append_truecolor_fg(char *dst, uint8_t r, uint8_t g, uint8_t b);
 
char *append_truecolor_bg(char *dst, uint8_t r, uint8_t g, uint8_t b);
 
char *append_truecolor_fg_bg(char *dst, uint8_t fg_r, uint8_t fg_g, uint8_t fg_b, uint8_t bg_r, uint8_t bg_g,
                             uint8_t bg_b);
 
/* ===== Run-Length Encoding Functions ===== */
 
void ansi_rle_init(ansi_rle_context_t *ctx, char *buffer, size_t capacity, ansi_color_mode_t mode);
 
void ansi_rle_add_pixel(ansi_rle_context_t *ctx, uint8_t r, uint8_t g, uint8_t b, char ascii_char);
 
void ansi_rle_finish(ansi_rle_context_t *ctx);
 
/* ===== Initialization Functions ===== */
 
void ansi_fast_init(void);
 
void ansi_fast_init_256color(void);
 
void ansi_fast_init_16color(void);
 
/* ===== 256-Color Functions ===== */
 
char *append_256color_fg(char *dst, uint8_t color_index);
 
char *append_256color_bg(char *dst, uint8_t color_index);
 
uint8_t rgb_to_256color(uint8_t r, uint8_t g, uint8_t b);
 
/* ===== 16-Color Functions ===== */
 
char *append_16color_fg(char *dst, uint8_t color_index);
 
char *append_16color_bg(char *dst, uint8_t color_index);
 
uint8_t rgb_to_16color(uint8_t r, uint8_t g, uint8_t b);
 
void get_16color_rgb(uint8_t color_index, uint8_t *r, uint8_t *g, uint8_t *b);
 
uint8_t rgb_to_16color_dithered(int r, int g, int b, int x, int y, int width, int height, rgb_error_t *error_buffer);
 
/* ===== Mode-Aware Color Functions ===== */
 
char *append_color_fg_for_mode(char *dst, uint8_t r, uint8_t g, uint8_t b, terminal_color_mode_t mode);
 
#ifdef __cplusplus
}
#endif
 
#endif // ASCIICHAT_VIDEO_TERMINAL_ANSI_H