colorscheme.h

Go to the documentation of this file.

 
#pragma once
 
#include "../common.h"
#include "../platform/terminal.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[64];         
  char description[256]; 
  /* 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[8];        
  const char *codes_256[8];       
  const char *codes_truecolor[8]; 
} compiled_color_scheme_t;
 
/* ============================================================================
 * 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