colorscheme.h

Go to the documentation of this file.

 
#pragma once
 
/* Storage capacities in elements; text buffers include the terminating NUL. */
#define OPTIONS_COLORSCHEME_NAME_BUFFER_SIZE 64
#define OPTIONS_COLORSCHEME_DESCRIPTION_BUFFER_SIZE 256
#define OPTIONS_COLORSCHEME_FOREGROUND_16_BUFFER_SIZE 16
#define OPTIONS_COLORSCHEME_FOREGROUND_256_BUFFER_SIZE 24
#define OPTIONS_COLORSCHEME_FOREGROUND_TRUECOLOR_BUFFER_SIZE 32
 
/* Existing buffer budgets in bytes, including NUL for text storage. */
#define COLORSCHEME_LOG_COLOR_COUNT 8
#define COLORSCHEME_SGR_BUFFER_SIZE 32
 
#include "../common.h"
#include <libplatform/terminal.h>
#include <libplatform/mutex.h>
#include <ascii-chat/video/rgba/image.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
/* ============================================================================
 * Color Definitions
 * ============================================================================ */

typedef enum {
  TERM_BACKGROUND_UNKNOWN = 0, 
  TERM_BACKGROUND_LIGHT = 1,   
  TERM_BACKGROUND_DARK = 2     
} terminal_background_t;

typedef struct color_scheme_t {
  char name[OPTIONS_COLORSCHEME_NAME_BUFFER_SIZE];               
  char description[OPTIONS_COLORSCHEME_DESCRIPTION_BUFFER_SIZE]; 
 
  /* Dark mode colors (default, 8 colors for log levels) */
  rgb_pixel_t log_colors_dark[8]; 
 
  /* Light mode colors (optional) */
  bool has_light_variant;          
  rgb_pixel_t log_colors_light[8]; 
 
  /* Metadata */
  bool is_builtin;                            
  char source_file[PLATFORM_MAX_PATH_LENGTH]; 
} color_scheme_t;

typedef struct {
  const char *codes_16[COLORSCHEME_LOG_COLOR_COUNT];        
  const char *codes_256[COLORSCHEME_LOG_COLOR_COUNT];       
  const char *codes_truecolor[COLORSCHEME_LOG_COLOR_COUNT]; 
  char
      foreground_16[OPTIONS_COLORSCHEME_FOREGROUND_16_BUFFER_SIZE]; 
  char foreground_256[OPTIONS_COLORSCHEME_FOREGROUND_256_BUFFER_SIZE];
  char foreground_truecolor[OPTIONS_COLORSCHEME_FOREGROUND_TRUECOLOR_BUFFER_SIZE];
} compiled_color_scheme_t;

typedef struct {
  char codes[COLORSCHEME_LOG_COLOR_COUNT][COLORSCHEME_SGR_BUFFER_SIZE];
  char background_codes[COLORSCHEME_LOG_COLOR_COUNT]
                       [COLORSCHEME_SGR_BUFFER_SIZE]; 
  char foreground[COLORSCHEME_SGR_BUFFER_SIZE];
  terminal_background_t background;
} colorscheme_palette_t;

void colorscheme_current_palette(colorscheme_palette_t *palette, terminal_color_mode_t mode);
terminal_background_t colorscheme_current_background(void);
uint8_t colorscheme_highlight_background(void);
void colorscheme_apply(const color_scheme_t *scheme);
 
/* ============================================================================
 * Color System API
 * ============================================================================ */

asciichat_error_t colorscheme_init(void);

void colorscheme_destroy(void);

const color_scheme_t *colorscheme_get_active_scheme(void);

asciichat_error_t colorscheme_set_active_scheme(const char *name);

asciichat_error_t colorscheme_load_builtin(const char *name, color_scheme_t *scheme);

asciichat_error_t colorscheme_load_from_file(const char *path, color_scheme_t *scheme);

asciichat_error_t colorscheme_compile_scheme(const color_scheme_t *scheme, terminal_color_mode_t mode,
                                             terminal_background_t background, compiled_color_scheme_t *compiled);

void colorscheme_cleanup_compiled(compiled_color_scheme_t *compiled);

asciichat_error_t colorscheme_export_scheme(const char *scheme_name, const char *file_path);
 
/* ============================================================================
 * Color Conversion Utilities
 * ============================================================================ */

asciichat_error_t parse_hex_color(const char *hex, uint8_t *r, uint8_t *g, uint8_t *b);
 
/* Note: rgb_to_16color() and rgb_to_256color() are defined in lib/video/ansi_fast.h
 * To use them in colors.c, include ansi_fast.h */

void rgb_to_truecolor_ansi(uint8_t r, uint8_t g, uint8_t b, char *buf, size_t size);
 
/* ============================================================================
 * Terminal Background Detection
 * ============================================================================ */

terminal_background_t detect_terminal_background(void);
 
/* ============================================================================
 * Early Color Initialization (for main() before log_init)
 * ============================================================================ */

asciichat_error_t options_colorscheme_init_early(int argc, const char *const argv[]);
 
/* ============================================================================
 * Internal: Shared Mutex for Color Compilation
 * ============================================================================ */

extern mutex_t g_colorscheme_mutex;
 
#ifdef __cplusplus
}
#endif