home · contact · privacy
Merged world.wmeta and world.winconf_db into world.wins.
[plomrogue] / src / client / wincontrol.h
index e025cced8705030596745efbb974131fa5e2e7b0..9e7de869a71f8f39ba0db92b7737add6f40bef0f 100644 (file)
@@ -7,38 +7,43 @@
 #ifndef WINCONTROL_H
 #define WINCONTROL_H
 
-#include <stdint.h> /* for uint8_t, int16_t */
-#include "keybindings.h" /* for KeyBindingDB struct */
-#include "../common/yx_uint16.h" /* for yx_uint16 struct */
+#include <stdint.h> /* uint8_t, int16_t */
+#include "keybindings.h" /* struct KeyBindingDB */
+#include "../common/yx_uint16.h" /* yx_uint16 struct */
 struct Win;
 
+#include <ncurses.h>
 
 
 struct WinConfDB
 {
+    WINDOW * screen;           /* ncurses' pointer to the terminal screen */
+    WINDOW * pad;              /* ncurses pad of virtual screen */
     struct WinConf * winconfs;
-    char * winconf_ids;
+    struct Win * chain_start; /* first Win in chain; its .prev == 0 */
+    struct Win * chain_end;   /* last Win in chain; its .next == 0 */
+    struct Win * win_active;  /* Win highlighted / selected for manipulation */
+    struct yx_uint16 padsize; /* virtual screen size */
+    char * ids;               /* all windows' ids */
+    char * order;             /* order of visible windows (identified by IDs) */
+    uint16_t pad_offset;      /* number of cells view is moved to the right */
+    char id_active;           /* id of window selected as active */
 };
 
-/* Stores a window's configuration (like geometry, keybindings) and a pointer to
- * the respective Win struct itself.
- */
+/* Window's configuration (like geometry, keybindings) and the Win itself. */
 struct WinConf
 {
-    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 KeyBindingDB kb; /* Window-specific keybindings. */
-    uint8_t view; /* 0: use .draw as Win.draw; 1/2: use draw_winconf()_(1/2). */
+    struct yx_uint16 center; /* Designated Win.center. */
     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.  */
+    uint8_t view; /* 0: use .draw as Win.draw; 1/2: use draw_winconf()_(1/2). */
+    char id; /* Identifier of WinConf, also identifies Win.draw function. */
     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(). */
+};
 
 
 
@@ -46,26 +51,29 @@ struct WinConf
 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 world.winconfs and their Wins. */
-extern void init_winconfs();
+/* Free all WinConf DB data. */
 extern void free_winconfs();
+
+/* Initialize  Win structs for WinConfs in WinConf database. */
 extern void init_wins();
 
-/* Toggle windows in the order desribed by 1st line of toggle_order_and_active
- * file in client config windows directory, 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).
+/* Toggle windows in order set by world.win_order. Point active window selection
+ * to window identified by world.wins.win_active.
  */
-extern void sorted_wintoggle_and_activate();
+extern void sorted_win_toggle_and_activate();
+
+/* Read/write world.win_order and world.wins.win_active from/to "file". */
+extern void read_order_wins_visible_active(char * line, uint32_t linemax,
+                                           FILE * file);
+extern void write_order_wins_visible_active(FILE * file, char * delim);
 
-/* Iterate over chars of world.winconf_db.winconf_ids array. Restart after \0.*/
+/* Iterate over chars of world.wins.winconf_ids array. Restart after \0.*/
 extern char get_next_winconf_id();
 
-/* Save world.winconfs, visible window chain and active window selection to the
- * respective configuration files in client config windows directory.
- */
-extern void save_win_configs();
+/* Read/write individual WinConf (identified by "c") from/to file. */
+extern uint8_t read_winconf_from_file(char * line, uint32_t linemax,
+                                      FILE * file);
+extern void write_winconf_of_id_to_file(FILE * file, char c, char * delim);
 
 /* Toggle "window configuration" view for active window. Sets sensible
  * Win.center values for the various configuration views (for winconf_geometry:
@@ -75,7 +83,7 @@ extern void toggle_winconfig();
 
 /* Toggle WinConf.(height/width)_type ("axis" = "y": height; else: width). Avoid
  * positive diff to screen width (value would be wrongly read as a non-diff),
- * width_type toggles to 1 only if world.wmeta->screen's width >= WinConf.width.
+ * width_type toggles to 1 only if world.wins.screen's width >= WinConf.width.
  */
 extern void toggle_win_size_type(char axis);