webcam.h

Go to the documentation of this file.

#pragma once


 
#include <stdint.h>
#include <ascii-chat/video/rgba/image.h>
 
/* ============================================================================
 * Device Information
 * @{
 */

#define WEBCAM_DEVICE_NAME_MAX 256

typedef struct {
  unsigned int index;                
  char name[WEBCAM_DEVICE_NAME_MAX]; 
} webcam_device_info_t;

asciichat_error_t webcam_list_devices(webcam_device_info_t **devices, unsigned int *count);

void webcam_free_device_list(webcam_device_info_t *devices);

 
/* ============================================================================
 * High-Level Webcam Interface
 * @{
 */

typedef struct webcam_context_t webcam_context_t;
 
/* ============================================================================
 * Error Handling Helpers
 * @{
 */

void webcam_print_init_error_help(asciichat_error_t error_code);

 
/* ============================================================================
 * Context-Based Webcam Interface
 * @{
 */

asciichat_error_t webcam_init_context(webcam_context_t **ctx, unsigned short int device_index);

void webcam_cleanup_context(webcam_context_t *ctx);

void webcam_flush_context(webcam_context_t *ctx);

image_t *webcam_read_context(webcam_context_t *ctx);

image_t *webcam_read_async(webcam_context_t *ctx);

asciichat_error_t webcam_get_dimensions(webcam_context_t *ctx, int *width, int *height);

double webcam_get_fps(webcam_context_t *ctx);