plomlompom.com Git - plomrogue/blob - src/client/windows.c

   1 /* src/client/windows.c */
   2
   3 #define _POSIX_C_SOURCE 200809L /* strnlen() */
   4 #include "windows.h"
   5 #include <ncurses.h> /* chtype, getmaxx(), getmaxy(), erase(), werase(),
   6                       * endwin(), delwin(), wnoutrefresh(), pnoutrefresh(),
   7                       * doupdate(), refresh(), delwin(), newpad(), mvwaddch(),
   8                       * mvwaddstr()
   9                       */
  10 #include <stddef.h> /* NULL */
  11 #include <stdint.h> /* uint8_t, uint16_t, uint32_t, UINT16_MAX */
  12 #include <stdio.h> /* sprintf() */
  13 #include <stdlib.h> /* free() */
  14 #include <string.h> /* memcpy(), strlen(), strnlen(), memset() */
  15 #include "../common/rexit.h" /* exit_trouble(), exit_err() */
  16 #include "../common/try_malloc.h" /* try_malloc() */
  17 #include "draw_wins.h" /* draw_winconf_geometry(), draw_winconf_keybindings(),
  18                         * draw_win_inventory(), draw_win_info(), draw_win_log(),
  19                         * draw_win_available_keybindings(), draw_win_map(),
  20                         * draw_win_keybindings_winconf_keybindings(),
  21                         * draw_win_keybindings_winconf_geometry(),
  22                         * draw_win_keybindings_global()
  23                         */
  24 #include "wincontrol.h" /* toggle_window() */
  25 #include "world.h" /* world */
  26
  27
  28
  29 /* Calculate "id"'s window's size from v_screen size and .target_(height/width).
  30  * A .target_width == 0 makes the window as wide as .t_screen. .target_height ==
  31  * 0 sets the maximum allowed height: one cell smaller than that of .v_screen.
  32  * Negative values make width/height so many cells smaller than what 0 would
  33  * set. Values that would reduce the window height or width to less than 1 cell
  34  * according to the aforementioned rules set the height/width as if they were 0.
  35  */
  36 static void init_win_size_from_winconf_and_v_screen_size(char id);
  37
  38 /* Get (Win->draw) function identified by "c"; NULL if c not mapped to one.
  39  * match_func() is just a little helper to it.
  40  */
  41 static uint8_t match_func(char c, void (** f) (), char c_m, void (* f_m) ());
  42 static void (* get_drawfunc_by_char(char c)) ();
  43
  44 /* Iterate over chars of world.winDB.ids array / string. Restart after \0.*/
  45 static char get_next_win_id();
  46
  47 /* Draw scroll hint (a line saying that there are "dist" more elements of "unit"
  48  * further into the direction symbolized by "dir") into .v_screen, onto an
  49  * appropriate edge of a window or .v_screen; the left/right edge if "dir" is
  50  * "<"/">", or the top/bottom edge if it is "^"/"v". Use "start" as the start
  51  * coordinate of the frame that is to contain the scroll hints. winscroll_hint()
  52  * is a wrapper that uses the border of window "w" as this frame.
  53  */
  54 static void scroll_hint(struct yx_uint16 fsize, char dir, uint16_t dist,
  55                         char * unit, struct yx_uint16 start);
  56 static void winscroll_hint(struct Win * w, char dir, uint16_t dist);
  57
  58 /* draw_win_borderlines() draws vertical/horizontal borders of window "w" sans
  59  * corners into .v_screen. It draws the top border line as the windows' title
  60  * bar (highlighted if the window is selected as active). It is called
  61  * recursively by draw_wins_borderlines() on all windows from "w" on.
  62  * draw_wins_bordercorners() draws the border corners of "w" and its successors.
  63  */
  64 static void draw_win_borderlines(struct Win * w);
  65 static void draw_wins_borderlines(struct Win * w);
  66 static void draw_wins_bordercorners(struct Win * w);
  67
  68 /* Draw contents of all windows in window chain from window "w" onwards. */
  69 static void draw_wins(struct Win * w);
  70
  71
  72
  73 static void init_win_size_from_winconf_and_v_screen_size(char id)
  74 {
  75     struct Win * w = get_win_by_id(id);
  76     w->frame_size.y  = world.winDB.v_screen_size.y - 1;
  77     if      (   0 < w->target_height
  78              && w->target_height <= world.winDB.v_screen_size.y - 1)
  79     {
  80         w->frame_size.y = w->target_height;
  81     }
  82     else if (   0 > w->target_height
  83              && world.winDB.v_screen_size.y + (w->target_height - 1) > 0)
  84     {
  85         w->frame_size.y = world.winDB.v_screen_size.y + (w->target_height - 1);
  86     }
  87     w->frame_size.x  = world.winDB.v_screen_size.x;
  88     if      (0 < w->target_width)
  89     {
  90         w->frame_size.x = w->target_width;
  91     }
  92     else if (   0 > w->target_width
  93              && world.winDB.v_screen_size.x + w->target_width > 0)
  94     {
  95         w->frame_size.x = world.winDB.v_screen_size.x + w->target_width;
  96     }
  97 }
  98
  99
 100
 101 static uint8_t match_func(char c, void (** f) (), char c_m, void (* f_m) ())
 102 {
 103     if (c == c_m)
 104     {
 105         * f = f_m;
 106         return 1;
 107     }
 108     return 0;
 109 }
 110
 111
 112
 113 static void (* get_drawfunc_by_char(char c)) ()
 114 {
 115     void (* f) (struct Win *) = NULL;
 116     if (   match_func(c, &f, 'c', draw_win_inventory)
 117         || match_func(c, &f, 'i', draw_win_info)
 118         || match_func(c, &f, 'l', draw_win_log)
 119         || match_func(c, &f, 'k', draw_win_available_keybindings)
 120         || match_func(c, &f, 'm', draw_win_map)
 121         || match_func(c, &f, '0', draw_win_keybindings_global)
 122         || match_func(c, &f, '1', draw_win_keybindings_winconf_geometry)
 123         || match_func(c, &f, '2', draw_win_keybindings_winconf_keybindings))
 124     {
 125         ;
 126     }
 127     return f;
 128 }
 129
 130
 131
 132 static char get_next_win_id()
 133 {
 134     static uint8_t i = 0;
 135     char c = world.winDB.ids[i];
 136     if (0 == c)
 137     {
 138         i = 0;
 139         return c;
 140     }
 141     i++;
 142     return c;
 143 }
 144
 145
 146
 147 static void scroll_hint(struct yx_uint16 fsize, char dir, uint16_t dist,
 148                         char * unit, struct yx_uint16 start)
 149 {
 150     /* Decide on alignment (vertical/horizontal?), thereby hint text space. */
 151     char * more = "more";
 152     uint16_t dsc_space = fsize.x;
 153     if ('<' == dir || '>' == dir)
 154     {
 155         dsc_space = fsize.y;
 156     }                                  /* vv-- 10 = max strlen for uint16_t */
 157     uint16_t size = 1 + strlen(more) + 1 + 10 + 1 + strlen(unit) + 1 + 1;
 158     char * scrolldsc = try_malloc(size, __func__);
 159     int test = sprintf(scrolldsc, " %d %s %s ", dist, more, unit);
 160     exit_trouble(test < 0, __func__, "sprintf");
 161
 162     /* Decide on offset of the description text inside the scroll hint line. */
 163     uint16_t dsc_offset = 1;
 164     if (dsc_space > strlen(scrolldsc) + 1)
 165     {
 166         dsc_offset = (dsc_space - strlen(scrolldsc)) / 2;
 167     }
 168
 169     /* Draw scroll hint line as dir symbols bracketing description text. */
 170     uint16_t draw_offset = 0;
 171     if      ('>' == dir)
 172     {
 173         draw_offset = fsize.x - 1;
 174     }
 175     else if ('v' == dir)
 176     {
 177         draw_offset = fsize.y - 1;
 178     }
 179     uint16_t q = 0;
 180     for (; q < dsc_space; q++)
 181     {
 182         chtype c = dir | A_REVERSE;
 183         if (q >= dsc_offset && q < strlen(scrolldsc) + dsc_offset)
 184         {
 185             c = scrolldsc[q - dsc_offset] | A_REVERSE;
 186         }
 187         if ('<' == dir || '>' == dir)
 188         {
 189             mvwaddch(world.winDB.v_screen, start.y+q, start.x+draw_offset, c);
 190             continue;
 191         }
 192         mvwaddch(world.winDB.v_screen, start.y + draw_offset, start.x + q, c);
 193     }
 194     free(scrolldsc);
 195 }
 196
 197
 198
 199 static void winscroll_hint(struct Win * w, char dir, uint16_t dist)
 200 {
 201     char * unit = "lines";
 202     if ('<' == dir || '>' == dir)
 203     {
 204         unit = "columns";
 205     }
 206     struct yx_uint16 start = w->start;
 207     scroll_hint(w->frame_size, dir, dist, unit, start);
 208 }
 209
 210
 211
 212 static void draw_win_borderlines(struct Win * w)
 213 {
 214     /* Draw vertical and horizontal border lines. */
 215     uint16_t y, x;
 216     for (y = w->start.y; y <= w->start.y + w->frame_size.y; y++)
 217     {
 218         mvwaddch(world.winDB.v_screen, y, w->start.x - 1,              '|');
 219         mvwaddch(world.winDB.v_screen, y, w->start.x + w->frame_size.x, '|');
 220     }
 221     for (x = w->start.x; x <= w->start.x + w->frame_size.x; x++)
 222     {
 223         mvwaddch(world.winDB.v_screen, w->start.y - 1,              x, '-');
 224         mvwaddch(world.winDB.v_screen, w->start.y + w->frame_size.y, x, '-');
 225     }
 226
 227     /* Draw as much as possible of the title into center of top border line. */
 228     uint8_t min_title_length_visible = 3;/* min. 1 char +2 padding/decoration*/
 229     if (w->frame_size.x >= min_title_length_visible)
 230     {
 231         uint16_t offset = 0;
 232         if (w->frame_size.x > strlen(w->title) + 2)
 233         {
 234             offset = (w->frame_size.x - (strlen(w->title) + 2)) / 2;
 235         }                                    /* +2 is for padding/decoration */
 236         uint16_t length_visible = strnlen(w->title, w->frame_size.x - 2);
 237         char * title = try_malloc(length_visible + 3, "draw_win_borderlines");
 238         char decoration = ' ';
 239         if (w->id == world.winDB.active)
 240         {
 241             decoration = '$';
 242         }
 243         memcpy(title + 1, w->title, length_visible);
 244         title[0] = title[length_visible + 1] = decoration;
 245         title[length_visible + 2] = '\0';
 246         mvwaddstr(world.winDB.v_screen, w->start.y-1, w->start.x+offset, title);
 247         free(title);
 248     }
 249 }
 250
 251
 252
 253 static void draw_wins_borderlines(struct Win * w)
 254 {
 255     draw_win_borderlines(w);
 256     struct Win * next = get_win_after(w->id);
 257     if (next)
 258     {
 259         draw_wins_borderlines(next);
 260     }
 261 }
 262
 263
 264
 265 static void draw_wins_bordercorners(struct Win * w)
 266 {
 267     mvwaddch(world.winDB.v_screen,
 268              w->start.y - 1, w->start.x - 1,              '+');
 269     mvwaddch(world.winDB.v_screen,
 270              w->start.y - 1, w->start.x + w->frame_size.x, '+');
 271     mvwaddch(world.winDB.v_screen,
 272              w->start.y + w->frame_size.y, w->start.x - 1, '+');
 273     mvwaddch(world.winDB.v_screen, w->start.y + w->frame_size.y,
 274              w->start.x + w->frame_size.x,                 '+');
 275     struct Win * next = get_win_after(w->id);
 276     if (next)
 277     {
 278         draw_wins_bordercorners(next);
 279     }
 280 }
 281
 282
 283
 284 static void draw_wins(struct Win * w)
 285 {
 286     void (* drawfunc) (struct Win *) = get_drawfunc_by_char(w->id);
 287     if      (1 == w->view)
 288     {
 289         drawfunc = draw_winconf_geometry;
 290     }
 291     else if (2 == w->view)
 292     {
 293         drawfunc = draw_winconf_keybindings;
 294     }
 295     drawfunc(w);
 296     uint16_t size_y = w->winmap_size.y;
 297     uint16_t size_x = w->winmap_size.x;
 298     uint16_t offset_y = center_offset(w->center.y, size_y, w->frame_size.y);
 299     uint16_t offset_x = center_offset(w->center.x, size_x, w->frame_size.x);
 300     uint16_t y, x;
 301     for (y = offset_y; y < w->frame_size.y + offset_y && y < size_y; y++)
 302     {
 303         for (x = offset_x; x < w->frame_size.x + offset_x && x < size_x; x++)
 304         {
 305             chtype ch = w->winmap[(y * w->winmap_size.x) + x];
 306             mvwaddch(world.winDB.v_screen, w->start.y + (y - offset_y),
 307                                       w->start.x + (x - offset_x), ch);
 308         }
 309     }
 310     free(w->winmap); /* NULL so draw_wins.c's try_resize_winmap() may always  */
 311     w->winmap = NULL;/* free() it before (re-)allocation, even the first time.*/
 312     memset(&w->winmap_size, 0, sizeof(struct yx_uint16));
 313     if (offset_y > 0)
 314     {
 315         winscroll_hint(w, '^', offset_y + 1);
 316     }
 317     if (size_y > offset_y + w->frame_size.y)
 318     {
 319         winscroll_hint(w, 'v', size_y - ((offset_y + w->frame_size.y) - 1));
 320     }
 321     if (offset_x > 0)
 322     {
 323         winscroll_hint(w, '<', offset_x + 1);
 324     }
 325     if (size_x > offset_x + w->frame_size.x)
 326     {
 327         winscroll_hint(w, '>', size_x - ((offset_x + w->frame_size.x) - 1));
 328     }
 329     struct Win * next = get_win_after(w->id);
 330     if (next)
 331     {
 332         draw_wins(next);
 333     }
 334 }
 335
 336
 337
 338 extern uint8_t get_win_pos_in_order(char c)
 339 {
 340     uint8_t i;
 341     for (i = 0; c != world.winDB.order[i]; i++);
 342     return i;
 343 }
 344
 345
 346
 347 extern struct Win * get_win_after(char c)
 348 {
 349     return get_win_by_id(world.winDB.order[get_win_pos_in_order(c) + 1]);
 350 }
 351
 352
 353
 354 extern uint16_t center_offset(uint16_t position, uint32_t mapsize,
 355                               uint32_t frame_size)
 356 {
 357     uint16_t offset = 0;
 358     if (mapsize > frame_size)
 359     {
 360         if (position > frame_size / 2)
 361         {
 362             if (position < mapsize - (frame_size / 2))
 363             {
 364                 offset = position - (frame_size / 2);
 365             }
 366             else
 367             {
 368                 offset = mapsize - frame_size;
 369             }
 370         }
 371     }
 372     return offset;
 373 }
 374
 375
 376
 377 extern struct Win * get_win_by_id(char id)
 378 {
 379     uint8_t i = 0;
 380     while ('\0' != world.winDB.ids[i])
 381     {
 382         if (id == world.winDB.ids[i])
 383         {
 384             return &world.winDB.wins[i];
 385         }
 386         i++;
 387     }
 388     return NULL;
 389 }
 390
 391
 392
 393 extern void make_v_screen_and_init_win_sizes()
 394 {
 395     char * err_s = "creating an illegaly large virtual screen";
 396     char * err_m = "triggering a memory allocation error via newpad";
 397     uint32_t maxy_test = getmaxy(world.winDB.t_screen);
 398     uint32_t maxx_test = getmaxx(world.winDB.t_screen);
 399     exit_trouble(maxy_test>UINT16_MAX || maxx_test>UINT16_MAX, __func__, err_s);
 400     world.winDB.v_screen_size.y = maxy_test;
 401     world.winDB.v_screen_size.x = maxx_test;
 402     world.winDB.v_screen = newpad(world.winDB.v_screen_size.y, 1);
 403     exit_trouble(!world.winDB.v_screen, __func__, err_m);
 404     char id;
 405     while (0 != (id = get_next_win_id()))
 406     {
 407         init_win_size_from_winconf_and_v_screen_size(id);
 408     }
 409 }
 410
 411
 412
 413 extern void free_winDB()
 414 {
 415     char id;
 416     while (0 != (id = get_next_win_id()))
 417     {
 418         struct Win * wc = get_win_by_id(id);
 419         free(wc->title);
 420         free(wc->kb.kbs);
 421     }
 422     free(world.winDB.ids);
 423     free(world.winDB.wins);
 424     free(world.winDB.order);
 425 }
 426
 427
 428
 429 extern void winch_called()
 430 {
 431     world.winch = 1;
 432 }
 433
 434
 435
 436 extern void reset_windows_on_winch()
 437 {
 438     endwin();  /* "[S]tandard way" to recalibrate ncurses post SIGWINCH, says */
 439     refresh(); /* <http://invisible-island.net/ncurses/ncurses-intro.html>.   */
 440     char * tmp_order = try_malloc(strlen(world.winDB.order) + 1, __func__);
 441     int test = sprintf(tmp_order, "%s", world.winDB.order);
 442     exit_trouble(test < 0, __func__, "sprintf");
 443     uint8_t i;
 444     char tmp_active = world.winDB.active;
 445     for (i = 0; i < strlen(tmp_order); toggle_window(tmp_order[i]), i++);
 446     delwin(world.winDB.v_screen);
 447     make_v_screen_and_init_win_sizes();
 448     for (i = 0; i < strlen(tmp_order); toggle_window(tmp_order[i]), i++);
 449     free(tmp_order);
 450     world.winDB.active = tmp_active;
 451 }
 452
 453
 454
 455 extern void draw_all_wins()
 456 {
 457     /* Empty everything before filling it a-new. */
 458     erase();
 459     wnoutrefresh(world.winDB.t_screen);
 460     werase(world.winDB.v_screen);
 461     if (world.winDB.active)
 462     {
 463
 464         /* Draw borders, wins. Order matters: corners should overwrite lines. */
 465         draw_wins_borderlines(get_win_by_id(world.winDB.order[0]));
 466         draw_wins_bordercorners(get_win_by_id(world.winDB.order[0]));
 467         draw_wins(get_win_by_id(world.winDB.order[0]));
 468
 469         /* Draw .v_screen scroll hints. */
 470         struct yx_uint16 start;
 471         start.y = 0;
 472         start.x = world.winDB.v_screen_offset;
 473         char * cols_string = "columns";
 474         if (world.winDB.v_screen_offset > 0)
 475         {
 476             scroll_hint(world.winDB.v_screen_size, '<',
 477                         world.winDB.v_screen_offset + 1, cols_string, start);
 478         }
 479         uint16_t size_x = getmaxx(world.winDB.v_screen);
 480         uint16_t right_edge =   world.winDB.v_screen_offset
 481                               + world.winDB.v_screen_size.x;
 482         if (right_edge < size_x - 1)
 483         {
 484             scroll_hint(world.winDB.v_screen_size, '>',
 485                         size_x - right_edge, cols_string, start);
 486         }
 487
 488         /* Put .v_screen segment to be shown on .t_screen to .t_screen buffer.*/
 489         pnoutrefresh(world.winDB.v_screen, 0, world.winDB.v_screen_offset, 0, 0,
 490                      world.winDB.v_screen_size.y,
 491                      world.winDB.v_screen_size.x - 1);
 492     }
 493
 494     /* Only at the end write accumulated changes to .t_screen. */
 495     doupdate();
 496 }