Functions
char *	image_print (const image_t p, const char palette)
	Print image as ASCII art (monochrome)

void	quantize_color (int r, int g, int *b, int levels)
	Quantize color to specified number of levels.

char *	image_print_color (const image_t p, const char palette)
	Print image as ASCII art with color.

char *	image_print_color_utf8 (const image_t p, const char palette)

char *	rgb_to_ansi_fg (int r, int g, int b)
	Convert RGB to ANSI foreground color code.

char *	rgb_to_ansi_bg (int r, int g, int b)
	Convert RGB to ANSI background color code.

void	rgb_to_ansi_8bit (int r, int g, int b, int fg_code, int bg_code)
	Convert RGB to 8-bit ANSI color codes.

char *	image_print_256color (const image_t image, const char palette)
	Print image using 256-color ANSI mode.

char *	image_print_16color (const image_t image, const char palette)
	Print image using 16-color ANSI mode.

char *	image_print_16color_dithered (const image_t image, const char palette)
	Print image using 16-color ANSI mode with dithering.

char *	image_print_16color_dithered_with_background (const image_t image, bool use_background, const char palette)
	Print image using 16-color ANSI mode with dithering and background colors.

Function Documentation

◆ image_print_color_utf8()

char * image_print_color_utf8	(	const image_t *	p,
		const char *	palette
	)

Definition at line 310 of file foreground.c.

                                                                    {
  if (!p || !palette || !p->pixels) {
    return NULL;
  }
 
  utf8_palette_cache_t *utf8_cache = get_utf8_palette_cache(palette);
  if (!utf8_cache) {
    return NULL;
  }
 
  const int h = p->h;
  const int w = p->w;
  const size_t h_sz = (size_t)h;
  const size_t w_sz = (size_t)w;
 
  if (h_sz > 0 && w_sz > SIZE_MAX / h_sz) {
    return NULL;
  }
 
  const size_t bytes_per_pixel = 30; // fg sequence (~19) + char (up to 4) + margin
  const size_t total_pixels = h_sz * w_sz;
  const size_t lines_size = total_pixels * bytes_per_pixel + h_sz + 16;
 
  char *lines;
  lines = SAFE_MALLOC(lines_size, char *);
 
  char *ptr = lines;
  const rgb_pixel_t *pix = p->pixels;
 
  for (int y = 0; y < h; y++) {
    const int row_offset = y * w;
 
    for (int x = 0; x < w; x++) {
      const rgb_pixel_t pixel = pix[row_offset + x];
 
      ptr += SAFE_SNPRINTF(ptr, 20, "\033[38;2;%d;%d;%dm", pixel.r, pixel.g, pixel.b);
 
      int luminance = (77 * pixel.r + 150 * pixel.g + 29 * pixel.b + 128) >> 8;
      uint8_t safe_luminance = clamp_rgb(luminance);
      const utf8_char_t *char_info = &utf8_cache->cache[safe_luminance];
      for (int i = 0; i < char_info->byte_len; i++) {
        *ptr++ = char_info->utf8_bytes[i];
      }
    }
 
    *ptr++ = '\033';
    *ptr++ = '[';
    *ptr++ = '0';
    *ptr++ = 'm';
    if (y < h - 1) {
      *ptr++ = '\n';
    }
  }
 
  *ptr = '\0';
  return lines;
}

References rgb_pixel_t::b, utf8_char_t::byte_len, utf8_palette_cache::cache, rgb_pixel_t::g, get_utf8_palette_cache(), image_t::h, image_t::pixels, rgb_pixel_t::r, SAFE_MALLOC, SAFE_SNPRINTF, utf8_char_t::utf8_bytes, and image_t::w.

Referenced by ascii_convert(), and image_print_with_capabilities().

Functions

Function Documentation

◆ image_print_color_utf8()