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