ffmpeg_decoder.h

Go to the documentation of this file.

#pragma once

 
#include <ascii-chat/asciichat_errno.h>
#include <stdbool.h>
#include <stddef.h>
#include "../common.h"
#include <ascii-chat/video/rgba/image.h>
 
/* ============================================================================
 * FFmpeg Decoder Handle
 * ============================================================================ */

typedef struct ffmpeg_decoder_t ffmpeg_decoder_t;
 
/* ============================================================================
 * Decoder Lifecycle
 * ============================================================================ */

ffmpeg_decoder_t *ffmpeg_decoder_create(const char *path);

ffmpeg_decoder_t *ffmpeg_decoder_create_stdin(void);

void ffmpeg_decoder_destroy(ffmpeg_decoder_t *decoder);

asciichat_error_t ffmpeg_decoder_start_prefetch(ffmpeg_decoder_t *decoder);

void ffmpeg_decoder_stop_prefetch(ffmpeg_decoder_t *decoder);

void ffmpeg_decoder_set_exit_callback(ffmpeg_decoder_t *decoder, bool (*should_exit_callback)(void *), void *user_data);

bool ffmpeg_decoder_is_prefetch_running(ffmpeg_decoder_t *decoder);
 
/* ============================================================================
 * Video Operations
 * ============================================================================ */

typedef enum { FFMPEG_FRAME_READY, FFMPEG_FRAME_WAITING, FFMPEG_FRAME_EOF, FFMPEG_FRAME_FAILED } ffmpeg_frame_status_t;
ffmpeg_frame_status_t ffmpeg_decoder_poll_video(ffmpeg_decoder_t *decoder, image_t **frame,
                                                asciichat_error_context_t *failure);
image_t *ffmpeg_decoder_read_video_frame(ffmpeg_decoder_t *decoder);

bool ffmpeg_decoder_has_video(ffmpeg_decoder_t *decoder);

asciichat_error_t ffmpeg_decoder_get_video_dimensions(ffmpeg_decoder_t *decoder, int *width, int *height);

double ffmpeg_decoder_get_video_fps(ffmpeg_decoder_t *decoder);
 
/* ============================================================================
 * Audio Operations
 * ============================================================================ */

size_t ffmpeg_decoder_read_audio_samples(ffmpeg_decoder_t *decoder, float *buffer, size_t num_samples);

bool ffmpeg_decoder_has_audio(ffmpeg_decoder_t *decoder);
 
/* ============================================================================
 * Playback Control
 * ============================================================================ */

asciichat_error_t ffmpeg_decoder_rewind(ffmpeg_decoder_t *decoder);

asciichat_error_t ffmpeg_decoder_seek_to_timestamp(ffmpeg_decoder_t *decoder, double timestamp_sec);

bool ffmpeg_decoder_at_end(ffmpeg_decoder_t *decoder);

double ffmpeg_decoder_get_duration(ffmpeg_decoder_t *decoder);

double ffmpeg_decoder_get_position(ffmpeg_decoder_t *decoder);

 
ffmpeg_decoder_t *ffmpeg_decoder_create_interruptible(const char *path, bool (*cancel)(void *), void *data);
ffmpeg_decoder_t *ffmpeg_decoder_create_with_request_options(const char *path, bool (*cancel)(void *), void *data,
                                                             const char *headers, const char *cookies,
                                                             const char *proxy);