common/session/capture.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
#include <ascii-chat/media/source.h>
#include <ascii-chat/video/rgba/image.h>
 
/* ============================================================================
 * Session Capture Configuration
 * ============================================================================ */

typedef bool (*session_capture_should_exit_fn)(void *user_data);

typedef struct {
  media_source_type_t type;

  const char *path;

  uint32_t target_fps;

  bool loop;

  bool resize_for_network;

  bool enable_audio;

  bool audio_fallback_to_mic;

  void *mic_audio_ctx;

  double initial_seek_timestamp;

  session_capture_should_exit_fn should_exit_callback;

  void *callback_data;
} session_capture_config_t;
 
/* ============================================================================
 * Session Capture Context
 * ============================================================================ */

typedef struct session_capture_ctx session_capture_ctx_t;
 
/* ============================================================================
 * Session Capture Lifecycle Functions
 * @{
 */

session_capture_ctx_t *session_mirror_capture_create(const session_capture_config_t *config);

session_capture_ctx_t *session_network_capture_create(uint32_t target_fps);

session_capture_ctx_t *session_capture_create(const session_capture_config_t *config);

void session_capture_destroy(session_capture_ctx_t *ctx);

 
/* ============================================================================
 * Session Capture Operations
 * @{
 */

image_t *session_capture_read_frame(session_capture_ctx_t *ctx);

image_t *session_capture_process_for_transmission(session_capture_ctx_t *ctx, image_t *frame);
asciichat_error_t session_capture_process_for_transmission_into(session_capture_ctx_t *ctx, image_t *frame,
                                                                image_t **output);

void session_capture_sleep_for_fps(session_capture_ctx_t *ctx);

bool session_capture_at_end(session_capture_ctx_t *ctx);

bool session_capture_is_valid(session_capture_ctx_t *ctx);

double session_capture_get_current_fps(session_capture_ctx_t *ctx);

uint32_t session_capture_get_target_fps(session_capture_ctx_t *ctx);

bool session_capture_has_audio(session_capture_ctx_t *ctx);

size_t session_capture_read_audio(session_capture_ctx_t *ctx, float *buffer, size_t num_samples);

bool session_capture_using_file_audio(session_capture_ctx_t *ctx);

void *session_capture_get_media_source(session_capture_ctx_t *ctx);

void *session_capture_get_audio_context(session_capture_ctx_t *ctx);

void session_capture_set_audio_context(session_capture_ctx_t *ctx, void *audio_ctx);

typedef void *(*session_capture_audio_update_fn)(media_source_t *source, void *user_data);
void session_capture_set_audio_updater(session_capture_ctx_t *ctx, session_capture_audio_update_fn update,
                                       void *user_data);



void session_capture_toggle_media(session_capture_ctx_t *ctx);
 
bool session_capture_media_active(session_capture_ctx_t *ctx);
 
void session_capture_redraw_media(session_capture_ctx_t *ctx);
 
asciichat_error_t session_capture_open_media(session_capture_ctx_t *ctx, const char *path);
bool session_capture_cancel_open(session_capture_ctx_t *ctx);
void session_capture_lock_source(session_capture_ctx_t *ctx);
void session_capture_unlock_source(session_capture_ctx_t *ctx);

uint64_t session_capture_source_epoch(session_capture_ctx_t *ctx);
uint64_t session_capture_frame_serial(session_capture_ctx_t *ctx);
void session_capture_complete_open(session_capture_ctx_t *ctx, uint64_t epoch);

asciichat_error_t session_capture_open_playlist(session_capture_ctx_t *ctx, const char *text);
void session_capture_skip_media(session_capture_ctx_t *ctx, int direction);