X-Git-Url: https://plomlompom.com/repos/?a=blobdiff_plain;f=src%2Fwincontrol.h;h=58b99b2a8453e053cdd76c8c07aeb59a2e1ac69e;hb=93e3207a51c7ba4a31e3fb192e41b4421a906506;hp=e78316007b9098fd1364daba272af9ba44b64cd5;hpb=98b3c95a0e8208d8f60f1d87047b3766ffa16608;p=plomrogue diff --git a/src/wincontrol.h b/src/wincontrol.h index e783160..58b99b2 100644 --- a/src/wincontrol.h +++ b/src/wincontrol.h @@ -1,107 +1,89 @@ /* wincontrol.h * * Routines that build on top of the windows library to provide a simple window - * management API to the game. + * management API to the game. Also helps managing window-specific keybindings. */ #ifndef WINCONTROL_H #define WINCONTROL_H - - #include /* for uint8_t, int16_t */ +#include "keybindings.h" /* for KeyBiData struct */ +#include "yx_uint16.h" /* for yx_uint16 struct */ struct Win; -struct WinMeta; -struct World; -/* Stores designated configuration of a window pointed to in it, and data used - * to manipulate said window in the "window configuration" view of it. +/* Stores a window's configuration (like geometry, keybindings) and a pointer to + * the respective Win struct itself. */ struct WinConf { - char id; /* unique identifier of WinConf, abused as ID for ->win and */ - /* equivalent to the char following its "Win_" conffile name */ - struct Win * win; /* window configured by this WinConf */ - char * title; /* designated title as passed to init_win() */ - int16_t height; /* designated height as interpreted by init_win()*/ - int16_t width; /* designated width as interpreted by init_win() */ - char draw; /* identifier of designated Win->_draw; to be returned to */ - /* after toggling window configuration view */ - uint8_t view; /* 0: use ->draw as Win->_draw; 1: use draw_winconf()*/ - uint8_t height_type; /* both: 0: interpret ->height/->width as size in */ - uint8_t width_type; /* positive cells; 1: as negative diff to max width */ -}; - - - -/* Get WinConf fathering "win"; get Win of WinConf of "id". */ -extern struct WinConf * get_winconf_by_win(struct World * world, - struct Win * win); -extern struct Win * get_win_by_id(struct World * world, char id); - - - -/* Create/initialize (from config files)/free Winconf / Win structs. */ -extern void init_winconfs(struct World * world); -extern void free_winconfs(struct World * world); -extern void init_wins(struct World * world); -extern void free_wins(struct World * world); - - - -/* Toggle windows in world->wins in the order desribed by the first line of - * config/windows/toggled_win_order, wherein each character should correspond to - * one window the ID of which is found in world->winconf_ids. Unknown characters - * are silently ignored. + char id; /* Unique identifier of WinConf, doubles aas identifier for .win */ + /* and the char following "Win_" in the respective conffile name.*/ + struct Win * win; /* Window / Win struct configured by this WinConf. */ + struct KeyBiData kb; /* Window-specific keybindings. */ + uint8_t view; /* 0: use .draw as Win.draw; 1/2: use draw_winconf()_(1/2). */ + int16_t height; /* Designated height to pass to init_win(). */ + int16_t width; /* Designated width to pass to init_win(). */ + uint8_t height_type; /* 0: read .height/.width as size in positive cells; */ + uint8_t width_type; /* 1: as negative diff in cells to the screen size. */ + char * title; /* Designated title to pass to init_win(). */ + char draw; /* Identifier of designated Win.draw; passed to init_win() */ + /* and reset after toggling Win.draw via toggle_winconf(). */ + struct yx_uint16 center; /* Designated Win.center; to be reset after */ +}; /* toggling Win.center via toggle_winconf(). */ + + + +/* Get WinConf fathering "win" / get Win of WinConf of "id". */ +extern struct WinConf * get_winconf_by_win(struct Win * win); +extern struct Win * get_win_by_id(char id); + +/* Create/initialize (from config files)/free Winconf structs. */ +extern void init_winconfs(); +extern void free_winconfs(); +extern void init_wins(); + +/* Toggle windows in the order desribed by the 1st line of + * config/windows/toggle_order_and_active, where each char may fit a Winconf.id + * in world.winconfs. Silently ignore id chars not found there. The 1st char of + * the 2nd line of the same file determines which window (by its .id) to focus + * as active (but only if this window belongs to the ones just toggled). */ -extern void sorted_wintoggle(struct World * world); - -/* Reload windows in order and sizes defined in win config. */ -extern void reload_win_config(struct World * world); +extern void sorted_wintoggle_and_activate(); -/* Save all window's configurations to their configuration files. */ -extern void save_win_configs(struct World * world); - - - -/* Toggle "window configuration" view for "win". */ -extern void toggle_winconfig(struct World * world, struct Win * win); - -/* Toggle interpretation type for Win's width/height of Win in WinConf. Width - * only toggles to 1 if terminal window is at least as wide as WinConf->width. +/* Save world.winconfs, visible window chain and active window selection to the + * respective configuration files in config/windows/. */ -extern void toggle_win_height_type(struct World * world, struct Win * win); -extern void toggle_win_width_type(struct World * world, struct Win * win); - - +extern void save_win_configs(); -/* Toggle display of a window "win". - * - * Return 0 on success, 1 on (ncurses pad/window memory allocation) error. +/* Toggle "window configuration" view for active window. Sets sensible + * Win.center values for the various configuration views (for winconf_geometry: + * y=0, x=0; for winconf_keys: x=0, y=Winconf.kb.select). */ -extern uint8_t toggle_window(struct WinMeta * win_meta, struct Win * win); - - +extern void toggle_winconfig(); -/* Try to scroll virtual screen left ("dir" = "-") or right ("dir" = "+"), - * subject to the limitations provided by the window manager via - * reset_pad_offset(). +/* Toggle WinConf.(height/width)_type. To avoid a positive diff to screen width, + * width_type toggles to 1 only if world.wmeta->screen's width >= WinConf.width. */ -extern void scroll_pad(struct WinMeta * win_meta, char dir); +extern void toggle_win_height_type(); +extern void toggle_win_width_type(); +/* Toggle display of a window identified by "id". */ +extern void toggle_window(char id); +/* Try scrolling virtual screen left ("dir" = "-") or right ("dir" = "+") to the + * degree allowed by the window manager's reset_pad_offset(). + */ +extern void scroll_pad(char dir); /* Try to grow or shrink the active window horizontally ("change" = "*"/"_") or - * vertically ("change = "+"/"-") by one cell size, subject to the limitations - * provided by the window manager via resize_active_win(). - * - * Forces WinConf->width_type = 0 if new width surpasses that of terminal win. - * - * Return 0 on success, 1 on (ncurses pad/window memory allocation) error. + * vertically ("change = "+"/"-") by one cell size to the degree allowed by the + * window manager's resize_active_win(). If a new window width would surpass + * that of the terminal screen, set WinConf.width_type to 0. */ -extern uint8_t growshrink_active_window(struct World * world, char change); +extern void growshrink_active_window(char change);