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);