include/ascii-chat/tui/session.h

Go to the documentation of this file.

#pragma once
 
/* Storage capacities in elements; text buffers include the terminating NUL. */
#define TUI_SESSION_SESSION_STRING_BUFFER_SIZE 256
#define TUI_SESSION_UPDATE_NOTIFICATION_BUFFER_SIZE 1024
#define TUI_SESSION_CONNECTION_TARGET_BUFFER_SIZE 512
 
#include <ascii-chat/tui/controller.h>
#include <ascii-chat/ui/frame_buffer.h>
#include <ascii-chat/os/keyboard.h>
#include <ascii-chat/video/anim/controller.h>

typedef struct {
  bool enabled;
  bool joining;
  char session_string[TUI_SESSION_SESSION_STRING_BUFFER_SIZE];
} ui_discovery_view_t;
 
typedef struct {
  ui_discovery_view_t discovery;
  animation_sample_t animation;
  bool use_colors;
  char update_notification[TUI_SESSION_UPDATE_NOTIFICATION_BUFFER_SIZE];
  char connection_target[TUI_SESSION_CONNECTION_TARGET_BUFFER_SIZE];
} ui_splash_view_t;
 
void ui_session_splash_render(frame_buffer_t *buf, terminal_size_t size, void *view);
char *ui_session_help_render(terminal_size_t size, bool has_media, bool browser, terminal_size_t *minimum);
void ui_session_help_free(char *text);
char *ui_session_context_help_render(terminal_size_t size, ui_screen_t screen, terminal_size_t *minimum);
 
typedef enum {
  UI_ACTION_NONE,
  UI_ACTION_SETTINGS,
  UI_ACTION_HELP,
  UI_ACTION_CLOSE,
  UI_ACTION_SEEK_BACK,
  UI_ACTION_SEEK_FORWARD,
  UI_ACTION_PAUSE,
  UI_ACTION_VOLUME,
  UI_ACTION_DEBUG,
  UI_ACTION_LOGS,
  UI_ACTION_TOGGLE_MEDIA,
  UI_ACTION_QUIT,
  UI_ACTION_FORCE_QUIT
} ui_session_action_t;

ui_session_action_t ui_session_key(keyboard_key_t key, double *saved_volume);
 
typedef struct ui_session ui_session_t;
terminal_size_t ui_session_size(const ui_session_t *session);
typedef void (*ui_session_draw_fn)(frame_buffer_t *output, terminal_size_t size, const animation_sample_t *animation,
                                   void *context);
typedef struct {
  int screen;
  terminal_size_t minimum;
  bool dirty;
  bool clear;
  uint64_t refresh_ns;
  ui_session_draw_fn draw;
  void *context;
} ui_session_view_t;

int ui_session_select_screen(uint32_t visible_screens);
const char *ui_session_render(ui_session_t *session, const ui_session_view_t *view, uint64_t now_ns);
bool ui_session_is_covered(const ui_session_t *session);
size_t ui_session_frame_length(const ui_session_t *session);
uint64_t ui_session_next_frame_ns(const ui_session_t *session);
ui_session_t *ui_session_create(void);
void ui_session_destroy(ui_session_t *session);
void ui_session_resize(ui_session_t *session, int cols, int rows);
void ui_session_loading(ui_session_t *session, bool loading, const char *message);
void ui_session_log(ui_session_t *session, const char *message);
asciichat_error_t ui_session_media(ui_session_t *session, const char *data, size_t length);
ui_session_action_t ui_session_input(ui_session_t *session, keyboard_key_t key);
const char *ui_session_tick(ui_session_t *session, uint64_t now_ns);
void ui_session_clear(ui_session_t *session);
void ui_session_redraw(ui_session_t *session);
void ui_session_logs_render(frame_buffer_t *output, terminal_size_t size, ui_session_t *session);
bool ui_session_logs_key(keyboard_key_t key);
void ui_session_capture_logs(ui_session_t *session);