webcam.h

Go to the documentation of this file.

#pragma once
 
#include <stdint.h>
#include "video/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;
 
asciichat_error_t webcam_init(unsigned short int webcam_index);
 
image_t *webcam_read(void);
 
void webcam_cleanup(void);
 
void webcam_flush(void);
 
/* ============================================================================
 * 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);
 
asciichat_error_t webcam_get_dimensions(webcam_context_t *ctx, int *width, int *height);