/** One timed full-frame title card (the text is pre-positioned inside the PNG). */ export interface TitleCard { /** Full-frame transparent PNG (same WxH as the base video). */ pngPath: string; /** When the card becomes visible, seconds. */ startSec: number; /** When it disappears, seconds. */ endSec: number; /** Alpha fade-in duration (default 0.6). */ fadeInSec?: number; /** Alpha fade-out duration (default 0.6). 0 = no fade-out (e.g. an end card that holds to EOF). */ fadeOutSec?: number; } export interface BuildTitleCompositeInput { baseVideo: string; cards: TitleCard[]; outputPath: string; /** Image input framerate for the looped PNGs (default 24). */ fps?: number; /** H.264 CRF (default 16 — preserve text edges). */ crf?: number; preset?: string; } /** * Build the FFmpeg args to composite N timed title cards onto `baseVideo`. PURE. * Each PNG is a looped input (`-loop 1 -framerate fps`) so alpha fades on a * delayed start actually animate; cards chain via successive `overlay=0:0` * filters gated with `enable='between(t,start,end)'`. `-shortest` bounds the * infinite looped images to the base video. */ export declare function buildTitleCompositeArgs(input: BuildTitleCompositeInput): string[]; /** One line in a card. `font` is an alias (see FONT_ALIASES) or an absolute font path. */ export interface TextCardLine { text: string; font: string; size: number; /** Hex like "#f5f0e6". */ color: string; /** Extra px between glyphs (Didot/caps look). Default 0. */ tracking?: number; } export interface TextCardSpec { width: number; height: number; outputPath: string; /** Where the stack sits. 'bottom-left' = lower-third; 'center' = end card. */ anchor: 'bottom-left' | 'center'; /** Explicit top Y for the text block. For a 'center' anchor this keeps the * horizontal centering but overrides the default vertical centering — used to * drop an end card into the lower third so it clears a centered subject. */ y?: number; lines: TextCardLine[]; /** Base vertical gap added below each line's measured ink bottom. Default 28. */ gap?: number; /** Soft drop shadow for legibility over footage. Default true. */ shadow?: boolean; /** Optional ember accent rule to the left of a bottom-left stack. */ accentRule?: { color: string; width?: number; }; } /** Font aliases → macOS system font files (override by passing an absolute path as `font`). */ export declare const FONT_ALIASES: Record; export interface RenderTextCardOptions { /** python3 binary (default 'python3'). */ python?: string; env?: NodeJS.ProcessEnv; } /** True iff python3 + Pillow + RAQM (Devanagari/complex-script shaping) are available. */ export declare function pillowAvailable(options?: RenderTextCardOptions): Promise; /** * Render a {@link TextCardSpec} to a transparent PNG at `spec.outputPath` (Pillow * + RAQM, measure-and-stack). Spawns python3. Call {@link pillowAvailable} first * to fail clearly on a host without the dep. Returns the output path. */ export declare function renderTextCard(spec: TextCardSpec, options?: RenderTextCardOptions): Promise; //# sourceMappingURL=text-card.d.ts.map