io_handler.h File Reference

Exposes functions for the IO-Handler. More...

#include "../common.h"
#include "input/input_handler.h"
#include "input/input_types.h"
#include "output/common/output_handler.h"
#include "output/media/media_output.h"
#include <notcurses/notcurses.h>
#include <stdbool.h>

Go to the source code of this file.

Functions
int	init_io_handler (void)
	Initialize the IO handler.
bool	run_background_task (void(*callback)(void))
	Execute a function in a background thread.
void	shutdown_io_handler (void)
	Shutdown the IO handler.

Variables
volatile int	init_done
struct notcurses *	nc
struct ncplane *	stdplane

Detailed Description

Exposes functions for the IO-Handler.

Definition in file io_handler.h.

Function Documentation

init_io_handler()

int init_io_handler

(

void

)

Initialize the IO handler.

Sets up all input and output subsystems.

Returns

COMMON_SUCCESS on success, non-zero value on failure

Definition at line 29 of file io_handler.c.

                          {
    //initialize the Notcurses instance and standard plane
    notcurses_options ncopt;
    memset(&ncopt, 0, sizeof(ncopt));
 
    nc = notcurses_init(&ncopt, stdout);
    if (nc == NULL) {
        log_msg(ERROR, "io_handler", "Failed to initialize notcurses");
        return 1;// Error code
    }
 
    stdplane = notcurses_stdplane(nc);
    if (!stdplane) {
        log_msg(ERROR, "io_handler", "Failed to get standard plane");
        notcurses_stop(nc);
        nc = NULL;
        return 2;// Error code
    }
 
    ncplane_set_bg_rgb(stdplane, 0x281D10);
 
    // Initialize input handler (which starts its own thread)
    if (!init_input_handler(nc)) {
        log_msg(ERROR, "io_handler", "Failed to initialize input handler");
        return 3;// Error code
    }
 
    // Initialize common output handler
    if (!init_output_handler()) {
        log_msg(ERROR, "io_handler", "Failed to initialize output handler");
        shutdown_input_handler();
        return 4;// Error code
    }
 
    // Initialize media output handler
    if (!init_media_output()) {
        log_msg(ERROR, "io_handler", "Failed to initialize media output handler");
        // Continue without media support, not a fatal error
    }
 
    return COMMON_SUCCESS;// 0
}

run_background_task()

bool run_background_task

(

void(*

callback )(void)

)

Execute a function in a background thread.

This function executes the provided callback in a background thread.

Parameters

callback

Function to execute in the background

Returns

true if the thread started successfully, false otherwise

Definition at line 73 of file io_handler.c.

                                                 {
    if (!callback) {
        log_msg(ERROR, "io_handler", "Invalid callback for background task");
        return false;
    }
 
    // Start a thread to execute the callback
    start_simple_thread(callback);
    return true;
}

shutdown_io_handler()

void shutdown_io_handler

(

void

)

Shutdown the IO handler.

Cleans up all input and output subsystems.

Definition at line 84 of file io_handler.c.

                               {
    // Shutdown subsystems in reverse order of initialization
    shutdown_output_handler();
    shutdown_input_handler();
 
    // Shutdown notcurses
    if (nc) {
        notcurses_stop(nc);
        nc = NULL;
        stdplane = NULL;
    }
}

Variable Documentation

init_done

volatile int init_done

extern

Definition at line 31 of file main.c.

nc

struct notcurses* nc

extern

Definition at line 26 of file io_handler.c.

stdplane

struct ncplane* stdplane

extern

Definition at line 27 of file io_handler.c.