ascii-chat
Binary v0.16.50-198-g78f51665f
Library lib/v0.3.2-2240-g78f51665f
Video chat in your terminal
Loading...
Searching...
No Matches
mirror.c
Go to the documentation of this file.
1#include "common/font.h"
2#include "mirror.h"
7
8#include <emscripten.h>
9#include <stdlib.h>
10#include <string.h>
11
14
15#include <options/options.h>
16#include <options/rcu.h>
18#include <libplatform/terminal.h>
20#include <ascii-chat/log/log.h>
29#include <ascii-chat/common.h>
30#include <ascii-chat/buffer.h>
34
35// Global digital rain effect context
40 if (!context)
41 return;
43 if (context->digital_rain) {
45 context->digital_rain = NULL;
46 }
47 context->last_rain_update_time = 0.0;
48 context->frame_count = 0;
49 context->has_frame = false;
50}
52 if (!context)
53 return;
55 SAFE_FREE(context);
56}
57
58// ============================================================================
59// Initialization
60// ============================================================================
61
66int mirror_init(void) {
67 // The options layer expects the shared runtime (logging, timers, buffers,
68 // and platform state) to be initialized first, just like the CLI startup
69 // path. Browser modules do not enter the CLI dispatcher, so do it here.
70 asciichat_error_t err = asciichat_shared_init(NULL, false, true);
71 if (err != ASCIICHAT_OK) {
72 return -1;
73 }
74
75 char *argv[] = {"mirror", NULL};
76 err = options_init(1, argv);
77
78 if (err != ASCIICHAT_OK) {
79 return -1;
80 }
81
83 return -1;
84
85 // Honor parsed verbosity and let INFO use stdout (console.log).
86 log_init(NULL, GET_OPTION(log_level), false, false);
87 // Use debug-style format in WASM so browser console shows full log headers.
89
90 // Log option values after initialization
91 log_info("Mirror options initialized");
92
93 // Initialize ANSI color code generation (dec3 cache for RGB values)
95
96 return 0;
97}
98
105
106// ============================================================================
107// Frame Conversion API
108// ============================================================================
109
110char *mirror_convert_frame(mirror_render_context_t *context, uint8_t *rgba_data, int src_width, int src_height, int contain) {
111 if (!context) {
112 SET_ERRNO(ERROR_INVALID_STATE, "Mirror render context is closed");
113 return NULL;
114 }
115 if (!rgba_data || src_width <= 0 || src_height <= 0) {
116 SET_ERRNO(ERROR_INVALID_PARAM, "Invalid browser frame pixels or dimensions");
117 return NULL;
118 }
119
120 context->frame_count++;
121 // Derive a time value from frame count using actual target FPS from options
122 int target_fps = (int)GET_OPTION(fps);
123 if (target_fps <= 0) {
124 target_fps = 60; // Default to 60 FPS if not set
125 }
126 float time_seconds = (float)context->frame_count / (float)target_fps;
127
128 // Get current settings from options or terminal detection
129 int dst_width = (int)terminal_get_effective_width(GET_OPTION(width), 80);
130 int dst_height = (int)terminal_get_effective_height(GET_OPTION(height), 24);
131 color_filter_t filter = (color_filter_t)GET_OPTION(color_filter);
132 terminal_color_mode_t color_mode = (terminal_color_mode_t)GET_OPTION(color_mode);
133 if (context->frame_count <= 3 || context->frame_count % 120 == 0) {
134 log_debug("frame=%u color_filter=%d color_mode=%d", context->frame_count, (int)filter, (int)color_mode);
135 }
136 if (color_mode == TERM_COLOR_AUTO) {
137 color_mode = TERM_COLOR_TRUECOLOR; // xterm.js supports truecolor
138 }
139 palette_type_t palette_type = (palette_type_t)GET_OPTION(palette_type);
140 bool preserve_aspect_ratio = true; // Preserve webcam aspect ratio
141 bool stretch = false; // Don't stretch - maintain proportions
142
143 // Build terminal capabilities structure with user's color mode
144 terminal_capabilities_t caps = {0}; // Zero-initialize all fields first
145 caps.color_level = color_mode;
146 caps.capabilities = 0;
147 caps.color_count = (color_mode == TERM_COLOR_NONE) ? 0 : (color_mode == TERM_COLOR_16) ? 16 : (color_mode == TERM_COLOR_256) ? 256 : 16777216;
148 caps.utf8_support = true;
149 caps.detection_reliable = true;
150 caps.render_mode = (terminal_render_mode_t)GET_OPTION(render_mode);
151 caps.text_renderer = GET_OPTION(renderer);
152 caps.stabilize = GET_OPTION(stabilize);
153 caps.palette_explicit = GET_OPTION(palette_explicit);
154 caps.wants_background = (caps.render_mode == RENDER_MODE_BACKGROUND);
155 caps.wants_padding = true;
156 caps.palette_type = palette_type;
157 caps.desired_fps = 60;
158 caps.color_filter = filter;
159 bool flip_x = GET_OPTION(flip_x);
160 bool flip_y = GET_OPTION(flip_y);
161
162 uint64_t palette_hash = UINT64_C(14695981039346656037);
163 if (palette_type == PALETTE_CUSTOM) {
164 const unsigned char *character = (const unsigned char *)GET_OPTION(palette_custom);
165 while (*character) {
166 palette_hash ^= *character++;
167 palette_hash *= UINT64_C(1099511628211);
168 }
169 }
170
171 if (context->has_frame &&
172 (context->source_width != src_width || context->source_height != src_height || context->output_width != dst_width || context->output_height != dst_height ||
173 context->renderer_mode != (int)caps.text_renderer || context->render_mode != (int)caps.render_mode || context->palette_type != (int)palette_type || context->palette_hash != palette_hash ||
174 context->palette_explicit != caps.palette_explicit || context->color_filter != (int)filter || context->flip_x != flip_x || context->flip_y != flip_y || context->contain != contain)) {
176 }
177 context->source_width = src_width;
178 context->source_height = src_height;
179 context->output_width = dst_width;
180 context->output_height = dst_height;
181 context->renderer_mode = (int)caps.text_renderer;
182 context->render_mode = (int)caps.render_mode;
183 context->palette_type = (int)palette_type;
184 context->palette_hash = palette_hash;
185 context->palette_explicit = caps.palette_explicit;
186 context->color_filter = (int)filter;
187 context->flip_x = flip_x;
188 context->flip_y = flip_y;
189 context->contain = contain;
190 context->has_frame = true;
191
192 // Convert RGBA to RGB (strip alpha channel) and optionally flip horizontally
193 rgb_pixel_t *rgb_pixels = SAFE_MALLOC(src_width * src_height * sizeof(rgb_pixel_t), rgb_pixel_t *);
194 if (!rgb_pixels) {
195 SET_ERRNO(ERROR_MEMORY, "Cannot allocate browser frame pixels");
196 return NULL;
197 }
198
199 for (int y = 0; y < src_height; y++) {
200 for (int x = 0; x < src_width; x++) {
201 int src_x = flip_x ? (src_width - 1 - x) : x;
202 int src_y = flip_y ? (src_height - 1 - y) : y;
203 int src_idx = (src_y * src_width + src_x) * 4;
204 int dst_idx = y * src_width + x;
205
206 rgb_pixels[dst_idx].r = rgba_data[src_idx + 0];
207 rgb_pixels[dst_idx].g = rgba_data[src_idx + 1];
208 rgb_pixels[dst_idx].b = rgba_data[src_idx + 2];
209 // Alpha (rgba_data[src_idx + 3]) is discarded
210 }
211 }
212
213 // Apply color filter to pixels if needed (except rainbow - handled in ANSI stage)
214 if (filter != COLOR_FILTER_NONE && filter != COLOR_FILTER_RAINBOW) {
215 // color_filter operates on packed RGB24 format
216 uint8_t *rgb24 = (uint8_t *)rgb_pixels;
217 int stride = src_width * 3;
218 apply_color_filter(rgb24, src_width, src_height, stride, filter, time_seconds);
219 }
220
221 // Create image structure
222 image_t img = {.w = src_width, .h = src_height, .pixels = rgb_pixels};
223
224 // Get palette characters based on selected palette type
225 const char *palette_chars;
226 switch (palette_type) {
227 case PALETTE_BLOCKS:
228 palette_chars = PALETTE_CHARS_BLOCKS;
229 break;
230 case PALETTE_DIGITAL:
231 palette_chars = PALETTE_CHARS_DIGITAL;
232 break;
233 case PALETTE_MINIMAL:
234 palette_chars = PALETTE_CHARS_MINIMAL;
235 break;
236 case PALETTE_COOL:
237 palette_chars = PALETTE_CHARS_COOL;
238 break;
239 case PALETTE_CUSTOM:
240 // Custom palette uses user-provided characters from options
241 palette_chars = GET_OPTION(palette_custom);
242 if (!palette_chars || palette_chars[0] == '\0') {
243 palette_chars = PALETTE_CHARS_STANDARD; // Fallback
244 }
245 break;
246 case PALETTE_STANDARD:
247 default:
248 palette_chars = PALETTE_CHARS_STANDARD;
249 break;
250 }
251
252 // Convert to ASCII using capability-aware function
253 char *ascii_output =
254 ascii_convert_with_buffers_stabilized(&img, dst_width, dst_height, &caps, preserve_aspect_ratio, stretch, palette_chars, contain != 0, NULL, NULL, caps.stabilize ? &context->stabilizer : NULL);
255 if (!caps.stabilize)
257
258 // Clean up
259 SAFE_FREE(rgb_pixels);
260
261 if (!ascii_output) {
262 log_error("ascii_convert_with_capabilities returned NULL");
263 return NULL;
264 }
265
266 // Apply rainbow color filter to ANSI output by replacing RGB values
267 // This preserves character selection while applying rainbow colors
268 if (filter == COLOR_FILTER_RAINBOW) {
269 char *rainbow_output = rainbow_replace_ansi_colors(ascii_output, time_seconds);
270 if (rainbow_output) {
271 SAFE_FREE(ascii_output);
272 ascii_output = rainbow_output;
273 }
274 }
275
276 bool matrix_rain = GET_OPTION(matrix_rain);
277 if (matrix_rain) {
278 // Initialize digital rain context if needed or dimensions changed
279 if (!context->digital_rain || context->digital_rain->num_columns != dst_width || context->digital_rain->num_rows != dst_height) {
280 if (context->digital_rain) {
282 }
283 context->digital_rain = digital_rain_init(dst_width, dst_height);
284 if (!context->digital_rain) {
285 log_error("Failed to initialize digital rain effect");
286 goto validate_output;
287 }
288 context->last_rain_update_time = emscripten_get_now();
289 }
290
291 // Update color from active filter (allows filter changes after initialization)
293
294 // Always apply rain to the newest input. Caching an entire ANSI frame freezes
295 // both the animation and webcam while the browser keeps counting presentations.
296 double current_time = emscripten_get_now();
297 float delta_time = (float)((current_time - context->last_rain_update_time) / 1000.0);
298 context->last_rain_update_time = current_time;
299 char *rain_output = digital_rain_apply(context->digital_rain, ascii_output, delta_time);
300 if (rain_output) {
301 SAFE_FREE(ascii_output);
302 ascii_output = rain_output;
303 }
304 } else {
305 // Clean up digital rain context if it exists but effect is disabled
306 if (context->digital_rain) {
308 context->digital_rain = NULL;
309 }
310 context->last_rain_update_time = 0.0;
311 }
312
313validate_output:
314 if (ascii_output) {
315 bool glyph_match = caps.text_renderer == ASCII_RENDERER_GLYPH && caps.render_mode != RENDER_MODE_HALF_BLOCK && dst_width > 0 && dst_height > 0 && dst_width <= IMAGE_MAX_WIDTH / 8 &&
316 dst_height <= IMAGE_MAX_HEIGHT / 8 && (!caps.palette_explicit || ascii_render_palette_supported(ASCII_RENDERER_GLYPH, palette_chars));
317 if (!glyph_match && (size_t)utf8_display_width(palette_chars) != utf8_char_count(palette_chars)) {
318 ascii_frame_source_t source = {.frame_data = ascii_output, .frame_size = strlen(ascii_output)};
319 size_t normalized_size;
320 char *rectangular = ascii_create_grid(&source, 1, dst_width, dst_height, &normalized_size);
321 SAFE_FREE(ascii_output);
322 ascii_output = rectangular;
323 }
324 if (!ascii_output)
325 return NULL;
326 acip_render_settings_t rendering = {.caps = caps};
327 const char *contract_palette = glyph_match && !caps.palette_explicit ? " !\"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`abcdefghijklmnopqrstuvwxyz{|}~" : palette_chars;
328 SAFE_STRNCPY(rendering.palette, contract_palette, sizeof(rendering.palette));
329 uint32_t effects = matrix_rain ? FRAME_RENDER_CONTRACT_RAIN : 0;
330 if (session_frame_validate_contract(ascii_output, strlen(ascii_output), dst_width, dst_height, &rendering, effects) != ASCIICHAT_OK) {
331 SAFE_FREE(ascii_output);
332 return NULL;
333 }
334 }
335 return ascii_output;
336}
337
338void mirror_submit_audio_samples(mirror_render_context_t *context, const float *samples, int count, int source) {
339 if (!context)
340 return;
341 if (!samples || count <= 0 || count > 8192)
342 return;
344}
345
346char *mirror_render_audio_visualization(mirror_render_context_t *context, unsigned int width, unsigned int height, int source) {
347 if (!context)
348 return NULL;
350 return NULL;
352 char *text = GET_OPTION(fft) ? audio_visualization_render_fft(width, height, audio_source, true, AUDIO_VISUALIZATION_COLOR_BRIGHTER, GET_OPTION(flip_x), GET_OPTION(flip_y))
354 if (text && session_frame_validate(text, strlen(text), width, height) != ASCIICHAT_OK) {
355 SAFE_FREE(text);
356 return NULL;
357 }
358 return text;
359}
ANSI escape sequence utilities and fast color code generation.
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)
Definition ascii.c:282
void errno_destroy(void)
Synchronized per-thread pending error stacks and value snapshots. SET_ERRNO pushes,...
#define SET_ERRNO(code,...)
πŸ“ Aspect Ratio Calculation Functions
void buffer_system_cleanup(void)
Definition buffer.c:424
Platform initialization and static synchronization helpers.
Matrix-style digital rain effect for ASCII frames.
int color_mode
Definition fft.c:26
asciichat_error_t audio_visualization_fft_init(void)
Definition fft.c:82
audio_visualization_source_t source
Definition fft.c:25
unsigned int height
Definition fft.c:24
terminal_render_mode_t render_mode
Definition fft.c:27
unsigned int width
Definition fft.c:24
char * audio_visualization_render_fft(unsigned int width, unsigned int height, audio_visualization_source_t source, bool use_color, int color_mode, bool flip_x, bool flip_y)
Definition fft.c:128
asciichat_error_t session_frame_validate(const char *text, size_t length, uint32_t width, uint32_t height)
asciichat_error_t session_frame_validate_contract(const char *text, size_t length, uint32_t width, uint32_t height, const acip_render_settings_t *settings, uint32_t effects)
void ansi_fast_init(void)
Definition ansi.c:226
unsigned int uint32_t
#define SAFE_STRNCPY(dst, src, size)
#define SAFE_FREE(ptr)
#define SAFE_MALLOC(size, cast)
asciichat_error_t asciichat_shared_init(const char *log_file, bool is_client, bool quiet_startup)
Initialize common subsystems shared by client and server.
Definition common.c:131
#define SAFE_CALLOC(count, size, cast)
unsigned long long uint64_t
unsigned char uint8_t
asciichat_error_t
Error and exit codes - unified status values (0-255).
Definition error_codes.h:48
@ ERROR_INVALID_STATE
@ ERROR_MEMORY
Definition error_codes.h:55
@ ASCIICHAT_OK
Definition error_codes.h:50
@ ERROR_INVALID_PARAM
#define log_error(...)
Log an ERROR message.
Definition log/log.h:628
void log_init(const char *filename, log_level_t level, bool force_stderr, bool use_mmap)
Initialize the logging system.
#define log_info(...)
Log an INFO message.
Definition log/log.h:602
asciichat_error_t log_set_format(const char *format_str, bool console_only)
Set a custom log format string.
#define log_debug(...)
Log a DEBUG message.
Definition log/log.h:589
#define GET_OPTION(field)
Definition options.h:1333
asciichat_error_t options_init(int argc, char **argv)
Initialize options by parsing command-line arguments with unified mode detection.
Definition options.c:2291
#define OPT_LOG_TEMPLATE_DEFAULT_DEBUG
Default log format string - debug mode (verbose with thread name, file relative path,...
Definition options.h:373
#define PALETTE_CHARS_MINIMAL
Minimal ASCII palette character string.
Definition palette.h:206
#define PALETTE_CHARS_DIGITAL
Digital/glitch palette character string.
Definition palette.h:197
palette_type_t
Built-in palette type enumeration.
Definition palette.h:96
#define PALETTE_CHARS_STANDARD
Standard ASCII palette character string.
Definition palette.h:179
#define PALETTE_CHARS_BLOCKS
Unicode block palette character string.
Definition palette.h:188
#define PALETTE_CHARS_COOL
Cool ascending blocks palette character string.
Definition palette.h:215
@ PALETTE_BLOCKS
Unicode block characters: " β–‘β–‘β–’β–’β–“β–“β–ˆβ–ˆ".
Definition palette.h:102
@ PALETTE_CUSTOM
User-defined via –palette-chars.
Definition palette.h:110
@ PALETTE_COOL
Ascending blocks: " β–β–‚β–ƒβ–„β–…β–†β–‡β–ˆ".
Definition palette.h:108
@ PALETTE_STANDARD
Standard ASCII palette: " ...',;:clodxkO0KXNWM".
Definition palette.h:100
@ PALETTE_DIGITAL
Digital/glitch aesthetic: " -=≑≣▰▱◼".
Definition palette.h:104
@ PALETTE_MINIMAL
Simple ASCII: " .-+*#".
Definition palette.h:106
int utf8_display_width(const char *str)
Calculate terminal display width of a UTF-8 string.
Definition utf8.c:98
size_t utf8_char_count(const char *str)
Count UTF-8 characters (not bytes).
Definition utf8.c:108
char * rainbow_replace_ansi_colors(const char *ansi_string, float time_seconds)
Replace all RGB ANSI codes with rainbow color.
int apply_color_filter(uint8_t *pixels, uint32_t width, uint32_t height, uint32_t stride, color_filter_t filter, float time)
Apply color filter to entire image in-place.
void digital_rain_set_color_from_filter(digital_rain_t *rain, color_filter_t filter)
Set digital rain color from color filter.
#define IMAGE_MAX_WIDTH
An owned RGB image with dimensions and row-major pixel storage.
#define IMAGE_MAX_HEIGHT
Maximum image height (4K resolution).
void digital_rain_destroy(digital_rain_t *rain)
Destroy digital rain effect context.
char * digital_rain_apply(digital_rain_t *rain, const char *frame, float delta_time)
Apply digital rain effect to ASCII frame.
digital_rain_t * digital_rain_init(int num_columns, int num_rows)
Initialize digital rain effect context.
char * ascii_create_grid(ascii_frame_source_t *sources, int source_count, int width, int height, size_t *out_size)
Create a grid layout from multiple ASCII frames.
Definition ascii.c:708
βš™οΈ Common definitions, error codes, macros, and types shared throughout the application
void platform_destroy(void)
Definition init.c:14
bool ascii_render_palette_supported(ascii_renderer_t kind, const char *palette)
#define ascii_stabilizer_reset
πŸ“ Logging API with multiple log levels and terminal output control
mirror_render_context_t * mirror_render_context_create(void)
Definition mirror.c:36
char * mirror_convert_frame(mirror_render_context_t *context, uint8_t *rgba_data, int src_width, int src_height, int contain)
Definition mirror.c:110
void mirror_cleanup(void)
Definition mirror.c:99
char * mirror_render_audio_visualization(mirror_render_context_t *context, unsigned int width, unsigned int height, int source)
Definition mirror.c:346
void mirror_render_context_reset(mirror_render_context_t *context)
Definition mirror.c:39
void mirror_submit_audio_samples(mirror_render_context_t *context, const float *samples, int count, int source)
Definition mirror.c:338
void mirror_render_context_destroy(mirror_render_context_t *context)
Definition mirror.c:51
int mirror_init(void)
Definition mirror.c:66
struct mirror_render_context mirror_render_context_t
βš™οΈ Unified options parsing system for ascii-chat with builder pattern and lock-free access
ASCII Palette Management for Video-to-ASCII Conversion.
void options_state_destroy(void)
Shutdown RCU options system.
Definition rcu.c:465
#define FRAME_RENDER_CONTRACT_RAIN
unsigned short int terminal_get_effective_height(int height_option, unsigned short fallback_height)
unsigned short int terminal_get_effective_width(int width_option, unsigned short fallback_width)
πŸ”€ String Manipulation and Shell Escaping Utilities
acip render settings keeps the values that move through the subsystem: caps, width,...
Frame source structure for grid layout.
Definition ascii.h:350
int num_rows
Number of rows in grid.
int num_columns
Number of columns in grid.
ascii_stabilizer_t stabilizer
Definition mirror.h:17
double last_rain_update_time
Definition mirror.h:15
uint64_t palette_hash
Definition mirror.h:21
digital_rain_t * digital_rain
Definition mirror.h:14
uint32_t frame_count
Definition mirror.h:16
uint8_t b
Blue color component (0-255).
uint8_t g
Green color component (0-255).
uint8_t r
Red color component (0-255).
πŸ”€ UTF-8 Encoding and Decoding Utilities
void audio_visualization_submit(audio_visualization_source_t source, const float *samples, size_t count)
audio_visualization_source_t
@ AUDIO_VISUALIZATION_SOURCE_MEDIA
@ AUDIO_VISUALIZATION_SOURCE_MIC
#define AUDIO_VISUALIZATION_COLOR_BRIGHTER
char * audio_visualization_render_waveform(unsigned int width, unsigned int height, audio_visualization_source_t source, bool use_color, int color_mode, bool flip_x, bool flip_y)
Definition waveform.c:31