renderer.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdint.h>
#include <stddef.h>
#include <ascii-chat/asciichat_errno.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[512];      // resolved by platform_font_resolve()
  bool font_is_path;        // true = file path, false = family name (macOS)
  const uint8_t *font_data; // non-NULL → load from memory (Linux only)
  size_t font_data_size;
} term_renderer_config_t;
 
// Implemented in lib/platform/{linux,macos,windows}/terminal.{c,m}
asciichat_error_t term_renderer_create(const term_renderer_config_t *cfg, terminal_renderer_t **out);
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);
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);
 
// Flush encoder and close file.  Always frees *ctx regardless of error.
asciichat_error_t render_file_destroy(render_file_ctx_t *ctx);