Function renderSessionToGif

scripts/tmux/tmux-viewer/gif-exporter.ts:195–259

(
  sessionData: SessionData,
  options: GifExportOptions
)

 * @returns Promise that resolves to the output path when complete
 */
export async function renderSessionToGif(
  sessionData: SessionData,
  options: GifExportOptions
): Promise<string> {
  const captures = sessionData.captures

  if (captures.length === 0) {
    throw new Error('No captures to export - session has no captured frames')
  }

  // Apply defaults
  const frameDelay = options.frameDelay ?? 1500
  const fontSize = options.fontSize ?? 14
  const bgColor = options.bgColor ?? '#1e1e1e'
  const fgColor = options.fgColor ?? '#d4d4d4'
  const loop = options.loop ?? 0
  const quality = options.quality ?? 10
  const showLabel = options.showLabel !== false

  // Calculate dimensions
  const { width, height, charWidth, lineHeight } = calculateDimensions(sessionData, {
    ...options,
    fontSize,
    showLabel,
  })

  // Create canvas
  const canvas = createCanvas(width, height)
  const ctx = canvas.getContext('2d')

  // Create GIF encoder
  const encoder = new GIFEncoder(width, height)

  encoder.start()
  encoder.setDelay(frameDelay)
  encoder.setRepeat(loop)
  encoder.setQuality(quality)

  // Render context for frames
  const renderCtx: RenderContext = {
    fontSize,
    lineHeight,
    charWidth,
    bgColor,
    fgColor,
    labelColor: '#888888',
    showLabel,
  }

  // Render each capture as a frame
  for (const capture of captures) {
    renderFrame(ctx, capture, width, height, renderCtx)
    encoder.addFrame(ctx)
  }

  encoder.finish()

  // Write to file