ascii.h

Go to the documentation of this file.

#pragma once
 
#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
#include <ascii-chat/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[256]);
 
/* ============================================================================
 * Capability-Aware Conversion Functions
 * @{
 */
 
// Capability-aware ASCII conversion using terminal detection
#include <ascii-chat/platform/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 *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;
 
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)