ascii.h

Go to the documentation of this file.

#pragma once
#include <ascii-chat/video/ascii/output_buffer.h>

 
#ifdef _WIN32
#ifndef _CRT_SECURE_NO_WARNINGS
#define _CRT_SECURE_NO_WARNINGS
#endif
#endif
 
#include <stdio.h>
#include <time.h>
#include <ascii-chat/video/ascii/common.h>
#include <ascii-chat/util/time.h>
 
// Include platform abstraction for write function mapping and deprecation suppression
#ifndef PLATFORM_ABSTRACTION_H
#endif
 
/* ============================================================================
 * Data Structures and Constants
 * ============================================================================
 */

extern char ascii_palette[];
 
// Include image.h for image_t type definition
#include <ascii-chat/video/rgba/image.h>
 
/* ============================================================================
 * Subsystem Initialization Functions
 * @{
 */

asciichat_error_t ascii_write_init(int fd, bool reset_terminal);

 
/* ============================================================================
 * Image-to-ASCII Conversion Functions
 * @{
 */

char *ascii_convert(image_t *original, const ssize_t width, const ssize_t height, const bool color,
                    const bool aspect_ratio, const bool stretch, const char *palette_chars,
                    const char luminance_palette[ASCII_LUMINANCE_LEVELS]);
 
/* ============================================================================
 * Capability-Aware Conversion Functions
 * @{
 */
 
// Capability-aware ASCII conversion using terminal detection
#include <libplatform/terminal.h>

char *ascii_convert_with_capabilities(image_t *original, const ssize_t width, const ssize_t height,
                                      const terminal_capabilities_t *caps, const bool use_aspect_ratio,
                                      const bool stretch, const char *palette_chars);

char *ascii_convert_with_capabilities_fit(image_t *original, const ssize_t width, const ssize_t height,
                                          const terminal_capabilities_t *caps, const bool use_aspect_ratio,
                                          const bool stretch, const char *palette_chars, const bool contain);
 
#include <ascii-chat/video/ascii/render.h>

char *ascii_convert_with_capabilities_workspace(image_t *original, const ssize_t width, const ssize_t height,
                                                const terminal_capabilities_t *caps, const bool use_aspect_ratio,
                                                const bool stretch, const char *palette_chars, const bool contain,
                                                image_t **workspace);

char *ascii_convert_with_buffers(image_t *original, const ssize_t width, const ssize_t height,
                                 const terminal_capabilities_t *caps, const bool use_aspect_ratio, const bool stretch,
                                 const char *palette_chars, const bool contain, image_t **workspace, outbuf_t *output);

char *ascii_convert_with_buffers_stabilized(image_t *original, const ssize_t width, const ssize_t height,
                                            const terminal_capabilities_t *caps, const bool use_aspect_ratio,
                                            const bool stretch, const char *palette_chars, const bool contain,
                                            image_t **workspace, outbuf_t *output, ascii_stabilizer_t *stabilizer);

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

 
/* ============================================================================
 * Frame Output Functions
 * @{
 */

asciichat_error_t ascii_write(const char *frame);

 
/* ============================================================================
 * Subsystem Cleanup Functions
 * @{
 */

void ascii_write_destroy(int fd, bool reset_terminal);

 
/* ============================================================================
 * Frame Layout and Padding Functions
 * @{
 */

char *ascii_pad_frame_width(const char *frame, size_t pad);

char *ascii_pad_frame_height(const char *frame, size_t pad_top);

typedef struct {
  const char *frame_data; 
  size_t frame_size;      
} ascii_frame_source_t;

asciichat_error_t ascii_grid_layout(int source_count, int width, int height, int *grid_cols, int *grid_rows);

char *ascii_create_grid(ascii_frame_source_t *sources, int source_count, int width, int height, size_t *out_size);

 
/* ============================================================================
 * Palette Utility Functions
 * @{
 */

char *get_lum_palette(void);

 
/* ============================================================================
 * ASCII Conversion Constants
 * ============================================================================
 */

#define ASCII_LUMINANCE_LEVELS 256

#define ASCII_SLEEP_NS 50000L
 
/* ============================================================================
 * ANSI Escape Sequence Constants
 * ============================================================================
 */

#define ANSI_FG_PREFIX "\033[38;2;"

#define ANSI_BG_PREFIX "\033[48;2;"

#define ANSI_COLOR_SUFFIX "m"
 
/* ============================================================================
 * Utility Macros
 * ============================================================================
 */

#define print(s) fwrite(s, 1, sizeof(s) / sizeof((s)[0]), stdout)
 
/* ============================================================================
 * Terminal Operation Macros
 * ============================================================================
 *
 * Convenience macros for terminal operations using platform abstraction
 * layer functions. These macros simplify common terminal operations.
 */

#define console_clear(fd) (terminal_clear_screen(), terminal_cursor_home(fd))

#define cursor_reset(fd) terminal_cursor_home(fd)

#define ascii_clear_screen(fd) terminal_clear_screen()
 
/* ============================================================================
 * Frame Rate Limiting
 * ============================================================================
 */

#define ascii_zzz() time_sleep_ns(ASCII_SLEEP_NS)