renderer.h

Go to the documentation of this file.

#pragma once
 
#include <stdint.h>
#include <stddef.h>
#include <ascii-chat/asciichat_errno.h>
#include <libplatform/filesystem.h>
 
// ── Platform renderer ─────────────────────────────────────────────────────
 
typedef struct terminal_renderer_s terminal_renderer_t;

typedef enum {
  TERM_RENDERER_THEME_DARK = 0,  
  TERM_RENDERER_THEME_LIGHT = 1, 
  TERM_RENDERER_THEME_AUTO = 2,  
} term_renderer_theme_t;
 
typedef struct {
  int cols;
  int rows;
  double font_size_pt; // point size, default 12.0 (fractional sizes supported)
  term_renderer_theme_t theme;
  char font_spec[PLATFORM_MAX_PATH_LENGTH]; // resolved by platform_font_resolve()
  bool font_is_path;                        // true = file path, false = name or bundled data
  const uint8_t *font_data;                 // non-NULL → load from memory
  size_t font_data_size;
} term_renderer_config_t;
 
// Implemented in lib/media/render/terminal.c using FreeType on all platforms.
asciichat_error_t term_renderer_create(const term_renderer_config_t *cfg, terminal_renderer_t **out);
asciichat_error_t term_renderer_set_zalgo(terminal_renderer_t *r, int level);
 
asciichat_error_t term_renderer_feed(terminal_renderer_t *r, const char *ansi_frame, size_t len);
const uint8_t *term_renderer_pixels(terminal_renderer_t *r);
int term_renderer_width_px(terminal_renderer_t *r);
int term_renderer_height_px(terminal_renderer_t *r);
int term_renderer_pitch(terminal_renderer_t *r);
int term_renderer_get_cols(terminal_renderer_t *r);
int term_renderer_get_rows(terminal_renderer_t *r);
void term_renderer_destroy(terminal_renderer_t *r);
 
// ── Render-file orchestrator ──────────────────────────────────────────────
 
typedef struct render_file_ctx_s render_file_ctx_t;
 
// Create: allocates renderer + FFmpeg encoder.
// cols/rows from terminal size; fps/theme from GET_OPTION().
asciichat_error_t render_file_create(const char *output_path, int cols, int rows, int fps, int theme,
                                     render_file_ctx_t **out);
 
// Feed one ANSI frame string — renders pixels then writes to encoder, synced with audio.
// captured_ns is the wall-clock timestamp (in nanoseconds) when the frame was captured
// for proper frame timing in the output video.
asciichat_error_t render_file_write_frame(render_file_ctx_t *ctx, const char *ansi_frame, uint64_t captured_ns);
 
/* Live sessions use capture timestamps; file conversion retains constant-frame-rate timing. */
void render_file_set_live_timing(render_file_ctx_t *ctx);
 
// Set actual wall-clock duration for snapshot mode (passes through to encoder).
void render_file_set_snapshot_actual_duration(render_file_ctx_t *ctx, double actual_duration_sec);
 
// Show terminal progress while accepted frames drain. Safe alongside frame writes.
void render_file_begin_drain(render_file_ctx_t *ctx, uint64_t total, bool total_known);
 
// Flush encoder and close file.  Always frees *ctx regardless of error.
asciichat_error_t render_file_destroy(render_file_ctx_t *ctx);