--- lbbs/include/screen.h 2025/04/30 09:19:42 1.1 +++ lbbs/include/screen.h 2025/06/08 09:25:24 1.14 @@ -1,8 +1,7 @@ /*************************************************************************** screen.h - description ------------------- - begin : Mon Oct 18 2004 - copyright : (C) 2004 by Leaflet + copyright : (C) 2004-2025 by Leaflet email : leaflet@leafok.com ***************************************************************************/ @@ -10,7 +9,7 @@ * * * This program is free software; you can redistribute it and/or modify * * it under the terms of the GNU General Public License as published by * - * the Free Software Foundation; either version 2 of the License, or * + * the Free Software Foundation; either version 3 of the License, or * * (at your option) any later version. * * * ***************************************************************************/ @@ -18,14 +17,27 @@ #ifndef _SCREEN_H_ #define _SCREEN_H_ -extern void moveto(int row, int col); +#include -extern void clrtoeol(); +#define CTRL_SEQ_CLR_LINE "\033[K" +#define MSG_EXT_MAX_LEN 200 -extern void clrline(int line_begin, int line_end); +struct display_ctx_t +{ + int reach_begin; // of data + int reach_end; // of data + long line_top; // current screen + long line_bottom; // current screen + char msg[MSG_EXT_MAX_LEN]; +}; +typedef struct display_ctx_t DISPLAY_CTX; -extern void clrtobot(int line_begin); +typedef int (*display_data_key_handler)(int *p_key, DISPLAY_CTX *p_ctx); +extern void moveto(int row, int col); +extern void clrtoeol(); +extern void clrline(int line_begin, int line_end); +extern void clrtobot(int line_begin); extern void clearscr(); extern int press_any_key(); @@ -33,16 +45,17 @@ extern int press_any_key(); extern void set_input_echo(int echo); extern int str_input(char *buffer, int buffer_length, int echo_mode); - extern int get_data(int row, int col, char *prompt, char *buffer, int buffer_length, int echo_mode); -extern int display_file(const char *filename); - -extern int display_file_ex(const char *filename, int begin_line, int wait); - -extern int show_top(char *status); +// eof_exit = 0 : Do not exit at EOF +// 1 : Prompt for any key at EOF, then exit +// 2 : Exit at EOF without prompt +extern int display_data(const void *p_data, long display_line_total, const long *p_line_offsets, int eof_exit, + display_data_key_handler key_handler, const char *help_filename); +extern int display_file(const char *filename, int eof_exit); -extern int show_bottom(char *msg); +extern int show_top(const char *str_left, const char *str_center, const char *str_right); +extern int show_bottom(const char *msg); extern int show_active_board();