-#include <stdint.h> /* for uint8_t */
+#include <stdint.h> /* for uint8_t, int16_t */
+#include "keybindings.h" /* for KeyBiData struct */
struct Win;
struct WinMeta;
struct World;
-/* Puts an identifier on each window, interfaces to its config file data. */
+/* Stores a window's configuration (like geometry, keybindings) and a pointer to
+ * the respective Win struct itself.
+ */
struct WinConf
{
- char id;
- struct Win * win;
- char * title;
- int16_t height;
- int16_t width;
- void (* draw) (struct Win *);
+ 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 */
+ struct KeyBiData kb; /* the window's specific keybindings */
};
-/* Create/initialize (from config files)/free Winconf / Win structs. */
-extern void create_winconfs(struct World * world);
+/* 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 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/toggle_order_and_active, wherein each character should
+ * correspond to one window whose ID is found in world->winconf_ids. Unknown
+ * characters are silently ignored. The first character of the second line of
+ * the file is also read to determine which window to focus as active (but only
+ * if it fits the ID of a window thus toggled visible).
+ */
+extern void sorted_wintoggle_and_activate(struct World * world);
+
/* Reload windows in order and sizes defined in win config. */
extern void reload_win_config(struct World * world);
+/* Save all window's configurations to their configuration files. */
+extern void save_win_configs(struct World * world);
-/* Get WinConf identified by winconf->id == "id", or that winconf's ->win. */
-extern struct WinConf * get_winconf_by_id(struct World * world, char id);
-extern struct Win * get_win_by_id(struct World * world, char id);
-
+/* Toggle "window configuration" view for "win". */
+extern void toggle_winconfig(struct World * world, struct Win * win);
-/* Toggle windows in world->wins in the order desribed by the first line of
- * config/windows/toggled_win_order, wherein each character may correspond to
- * one hardcoded window.
+/* 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.
*/
-extern void sorted_wintoggle(struct World * world);
+extern void toggle_win_height_type(struct World * world, struct Win * win);
+extern void toggle_win_width_type(struct World * world, struct Win * win);
* 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.
*/
-extern uint8_t growshrink_active_window(struct WinMeta * win_meta, char change);
+extern uint8_t growshrink_active_window(struct World * world, char change);