source.h

Go to the documentation of this file.

#pragma once

 
#include <stdbool.h>
#include <stddef.h>
#include "../common.h"
#include <ascii-chat/video/rgba/image.h>
 
/* ============================================================================
 * Media Source Types
 * ============================================================================ */

typedef enum {
  MEDIA_SOURCE_WEBCAM, 
  MEDIA_SOURCE_FILE,   
  MEDIA_SOURCE_STDIN,  
  MEDIA_SOURCE_TEST    
} media_source_type_t;

typedef struct media_source_t media_source_t;
 
/* ============================================================================
 * Media Source Lifecycle
 * ============================================================================ */

media_source_t *media_source_create(media_source_type_t type, const char *path);

void media_source_destroy(media_source_t *source);
 
/* ============================================================================
 * Video Operations
 * ============================================================================ */

image_t *media_source_read_video(media_source_t *source);

bool media_source_has_video(media_source_t *source);
 
/* ============================================================================
 * Audio Operations
 * ============================================================================ */

size_t media_source_read_audio(media_source_t *source, float *buffer, size_t num_samples);

bool media_source_has_audio(media_source_t *source);
 
/* ============================================================================
 * Playback Control
 * ============================================================================ */

void media_source_set_loop(media_source_t *source, bool loop);

void media_source_pause(media_source_t *source);

void media_source_resume(media_source_t *source);

bool media_source_is_paused(media_source_t *source);

void media_source_toggle_pause(media_source_t *source);

bool media_source_at_end(media_source_t *source);

asciichat_error_t media_source_rewind(media_source_t *source);

asciichat_error_t media_source_seek(media_source_t *source, double timestamp_sec);

media_source_type_t media_source_get_type(media_source_t *source);

double media_source_get_duration(media_source_t *source);

double media_source_get_position(media_source_t *source);

double media_source_get_video_fps(media_source_t *source);

void media_source_set_audio_context(media_source_t *source, void *audio_ctx);

void media_source_set_exit_callback(media_source_t *source, bool (*should_exit_callback)(void *), void *user_data);

 
/* Audio-only sources retain file audio and select webcam video. Metadata probing does not open the camera. */
bool media_source_uses_webcam(media_source_t *source);
asciichat_error_t media_source_start_video(media_source_t *source);
 
media_source_t *media_source_create_interruptible(media_source_type_t type, const char *path, bool (*cancel)(void *),
                                                  void *data);