source: window.c @ 46e2e56

release-1.10release-1.7release-1.8release-1.9
Last change on this file since 46e2e56 was 46e2e56, checked in by David Benjamin <davidben@mit.edu>, 14 years ago
Rename map_internal to realize
  • Property mode set to 100644
File size: 11.9 KB
Line 
1#include "owl.h"
2
3#include <assert.h>
4
5struct _owl_window { /*noproto*/
6  /* hierarchy information */
7  owl_window *parent;
8  owl_window *child;
9  owl_window *next, *prev;
10  /* flags */
11  int dirty : 1;
12  int dirty_subtree : 1;
13  int mapped : 1;
14  int is_screen : 1;
15  /* window information */
16  WINDOW *win;
17  PANEL *pan;
18  int nlines, ncols;
19  int begin_y, begin_x;
20  /* hooks */
21  void (*redraw_cb)(owl_window *, WINDOW *, void *);
22  void  *redraw_cbdata;
23  void (*redraw_cbdata_destroy)(void *);
24
25  void (*size_cb)(owl_window *, void *);
26  void  *size_cbdata;
27  void (*size_cbdata_destroy)(void *);
28
29  void (*destroy_cb)(owl_window *, void *);
30  void  *destroy_cbdata;
31  void (*destroy_cbdata_destroy)(void *);
32};
33
34static owl_window *_owl_window_new(owl_window *parent, int nlines, int ncols, int begin_y, int begin_x);
35
36static void _owl_window_unlink(owl_window *w);
37static void _owl_window_link(owl_window *w, owl_window *parent);
38
39static void _owl_window_create_curses(owl_window *w);
40static void _owl_window_destroy_curses(owl_window *w);
41
42static void _owl_window_realize(owl_window *w);
43static void _owl_window_unrealize(owl_window *w);
44
45/** singletons **/
46
47static WINDOW *_dummy_window(void)
48{
49  static WINDOW *dummy = NULL;
50  if (!dummy) {
51    dummy = newwin(1, 1, 0, 0);
52  }
53  return dummy;
54}
55
56static void _screen_calculate_size(owl_window *screen, void *user_data)
57{
58  owl_global *g = user_data;
59  int lines, cols;
60  owl_global_get_terminal_size(&lines, &cols);
61  if (!g->lines) g->lines = lines;
62  if (!g->cols) g->cols = cols;
63  owl_window_resize(screen, g->lines, g->cols);
64}
65
66owl_window *owl_window_get_screen(void)
67{
68  static owl_window *screen = NULL;
69  if (!screen) {
70    /* The screen is magical. It's 'mapped', but the only mean of it going
71     * invisible is if we're tore down curses (i.e. screen resize) */
72    screen = _owl_window_new(NULL, g.lines, g.cols, 0, 0);
73    screen->is_screen = 1;
74    owl_window_set_size_cb(screen, _screen_calculate_size, &g, 0);
75    owl_window_map(screen, 0);
76  }
77  return screen;
78}
79
80/** Creation and Destruction **/
81
82owl_window *owl_window_new(owl_window *parent)
83{
84  if (!parent)
85    parent = owl_window_get_screen();
86  return _owl_window_new(parent, 0, 0, 0, 0);
87}
88
89static owl_window *_owl_window_new(owl_window *parent, int nlines, int ncols, int begin_y, int begin_x)
90{
91  owl_window *w;
92
93  w = owl_malloc(sizeof(owl_window));
94  memset(w, 0, sizeof(*w));
95
96  w->nlines = nlines;
97  w->ncols = ncols;
98  w->begin_y = begin_y;
99  w->begin_x = begin_x;
100
101  _owl_window_link(w, parent);
102  if (parent && parent->is_screen) {
103    w->pan = new_panel(_dummy_window());
104    set_panel_userptr(w->pan, w);
105  }
106
107  return w;
108}
109
110void owl_window_delete(owl_window *w)
111{
112  /* destroy all children */
113  owl_window_children_foreach_onearg(w, owl_window_delete);
114
115  /* notify everyone of your imminent demise */
116  if (w->destroy_cb)
117    w->destroy_cb(w, w->destroy_cbdata);
118
119  /* clear all cbs */
120  owl_window_set_redraw_cb(w, 0, 0, 0);
121  owl_window_set_size_cb(w, 0, 0, 0);
122  owl_window_set_destroy_cb(w, 0, 0, 0);
123
124  /* destroy curses structures */
125  owl_window_unmap(w);
126  if (w->pan) {
127    del_panel(w->pan);
128  }
129
130  /* remove from hierarchy */
131  _owl_window_unlink(w);
132  owl_free(w);
133}
134
135/** Callbacks **/
136
137void owl_window_set_redraw_cb(owl_window *w, void (*cb)(owl_window*, WINDOW*, void*), void *cbdata, void (*cbdata_destroy)(void*))
138{
139  if (w->redraw_cbdata_destroy) {
140    w->redraw_cbdata_destroy(w->redraw_cbdata);
141    w->redraw_cbdata = 0;
142    w->redraw_cbdata_destroy = 0;
143  }
144
145  w->redraw_cb = cb;
146  w->redraw_cbdata = cbdata;
147  w->redraw_cbdata_destroy = cbdata_destroy;
148
149  /* mark the window as dirty, to take new cb in account */
150  owl_window_dirty(w);
151}
152
153void owl_window_set_size_cb(owl_window *w, void (*cb)(owl_window*, void*), void *cbdata, void (*cbdata_destroy)(void*))
154{
155  if (w->size_cbdata_destroy) {
156    w->size_cbdata_destroy(w->size_cbdata);
157    w->size_cbdata = 0;
158    w->size_cbdata_destroy = 0;
159  }
160
161  w->size_cb = cb;
162  w->size_cbdata = cbdata;
163  w->size_cbdata_destroy = cbdata_destroy;
164
165  owl_window_recompute_position(w);
166}
167
168void owl_window_set_destroy_cb(owl_window *w, void (*cb)(owl_window*, void*), void *cbdata, void (*cbdata_destroy)(void*))
169{
170  if (w->destroy_cbdata_destroy) {
171    w->destroy_cbdata_destroy(w->destroy_cbdata);
172    w->destroy_cbdata = 0;
173    w->destroy_cbdata_destroy = 0;
174  }
175
176  w->destroy_cb = cb;
177  w->destroy_cbdata = cbdata;
178  w->destroy_cbdata_destroy = cbdata_destroy;
179}
180
181/** Hierarchy **/
182
183static void _owl_window_unlink(owl_window *w)
184{
185  /* make sure the window is unmapped first */
186  _owl_window_unrealize(w);
187  /* unlink parent/child information */
188  if (w->parent) {
189    if (w->prev)
190      w->prev->next = w->next;
191    if (w->next)
192      w->next->prev = w->prev;
193    if (w->parent->child == w)
194      w->parent->child = w->next;
195  }
196  w->parent = NULL;
197}
198
199static void _owl_window_link(owl_window *w, owl_window *parent)
200{
201  if (w->parent == parent)
202    return;
203  if (w->parent)
204    _owl_window_unlink(w);
205
206  w->parent = parent;
207  if (parent) {
208    w->next = parent->child;
209    parent->child = w;
210  }
211}
212
213/* mimic g_list_foreach for consistency */
214void owl_window_children_foreach(owl_window *parent, GFunc func, gpointer user_data)
215{
216  owl_window *w;
217  for (w = parent->child;
218       w != NULL;
219       w = w->next) {
220    func(w, user_data);
221  }
222}
223
224void owl_window_children_foreach_onearg(owl_window *parent, void (*func)(owl_window*))
225{
226  owl_window *w;
227  for (w = parent->child;
228       w != NULL;
229       w = w->next) {
230    func(w);
231  }
232}
233
234owl_window *owl_window_get_parent(owl_window *w)
235{
236  return w->parent;
237}
238
239/** Internal window management **/
240
241static void _owl_window_create_curses(owl_window *w)
242{
243  if (w->is_screen) {
244    resizeterm(w->nlines, w->ncols);
245    w->win = stdscr;
246  } else if (w->pan) {
247    w->win = newwin(w->nlines, w->ncols, w->begin_y, w->begin_x);
248    replace_panel(w->pan, w->win);
249  } else {
250    w->win = derwin(w->parent->win, w->nlines, w->ncols, w->begin_y, w->begin_x);
251  }
252}
253
254static void _owl_window_destroy_curses(owl_window *w)
255{
256  if (w->is_screen) {
257    /* don't deallocate the dummy */
258    w->win = NULL;
259  } else {
260    if (w->pan) {
261      /* panels assume their windows always exist, so we put in a fake one */
262      replace_panel(w->pan, _dummy_window());
263    }
264    if (w->win) {
265      /* and destroy our own window */
266      delwin(w->win);
267      w->win = NULL;
268    }
269  }
270}
271
272static void _map_recurse_curry(owl_window *w)
273{
274  owl_window_map(w, 1);
275}
276
277void owl_window_map(owl_window *w, int recurse)
278{
279  w->mapped = 1;
280  _owl_window_realize(w);
281  if (w->pan)
282    show_panel(w->pan);
283  if (recurse)
284    owl_window_children_foreach_onearg(w, _map_recurse_curry);
285}
286
287void owl_window_unmap(owl_window *w)
288{
289  /* you can't unmap the screen */
290  if (w->is_screen)
291    return;
292  w->mapped = 0;
293  if (w->pan)
294    hide_panel(w->pan);
295  _owl_window_unrealize(w);
296}
297
298int owl_window_is_mapped(owl_window *w)
299{
300  return w->mapped;
301}
302
303int owl_window_is_realized(owl_window *w)
304{
305  return w->win != NULL;
306}
307
308int owl_window_is_toplevel(owl_window *w)
309{
310  return w->pan != NULL;
311}
312
313static void _owl_window_realize(owl_window *w)
314{
315  /* check if we can create a window */
316  if ((w->parent && w->parent->win == NULL)
317      || !w->mapped
318      || w->win != NULL)
319    return;
320  _owl_window_create_curses(w);
321  /* schedule a repaint */
322  owl_window_dirty(w);
323  /* map the children, unless we failed */
324  if (w->win)
325    owl_window_children_foreach_onearg(w, _owl_window_realize);
326}
327
328static void _owl_window_unrealize(owl_window *w)
329{
330  if (w->win == NULL)
331    return;
332  /* unmap all the children */
333  owl_window_children_foreach_onearg(w, _owl_window_unrealize);
334  _owl_window_destroy_curses(w);
335  /* subwins leave a mess in the parent; dirty it */
336  if (w->parent)
337    owl_window_dirty(w->parent);
338}
339
340/** Painting and book-keeping **/
341
342void owl_window_dirty(owl_window *w)
343{
344  /* don't put the screen on this list; pointless */
345  if (w->is_screen)
346    return;
347  if (!owl_window_is_realized(w))
348    return;
349  if (!w->dirty) {
350    w->dirty = 1;
351    while (w && !w->dirty_subtree) {
352      w->dirty_subtree = 1;
353      w = w->parent;
354    }
355    owl_global_set_needrefresh(&g);
356  }
357}
358
359void owl_window_dirty_children(owl_window *w)
360{
361  owl_window_children_foreach_onearg(w, owl_window_dirty);
362}
363
364static void _owl_window_redraw(owl_window *w)
365{
366  if (!w->dirty) return;
367  if (w->win && w->redraw_cb) {
368    w->redraw_cb(w, w->win, w->redraw_cbdata);
369    wsyncup(w->win);
370  }
371  w->dirty = 0;
372}
373
374static void _owl_window_redraw_subtree(owl_window *w)
375{
376  if (!w->dirty_subtree)
377    return;
378  _owl_window_redraw(w);
379  owl_window_children_foreach_onearg(w, _owl_window_redraw_subtree);
380}
381
382/*
383Redraw all the windows with scheduled redraws.
384NOTE: This function shouldn't be called outside the event loop
385*/
386void owl_window_redraw_scheduled(void)
387{
388  _owl_window_redraw_subtree(owl_window_get_screen());
389}
390
391void owl_window_erase_cb(owl_window *w, WINDOW *win, void *user_data)
392{
393  werase(win);
394  owl_window_dirty_children(w);
395}
396
397/** Window position **/
398
399void owl_window_get_position(owl_window *w, int *nlines, int *ncols, int *begin_y, int *begin_x)
400{
401  if (nlines)  *nlines  = w->nlines;
402  if (ncols)   *ncols   = w->ncols;
403  if (begin_y) *begin_y = w->begin_y;
404  if (begin_x) *begin_x = w->begin_x;
405}
406
407void owl_window_move(owl_window *w, int begin_y, int begin_x)
408{
409  if (w->is_screen) return; /* can't move the screen */
410  if (w->begin_y == begin_y && w->begin_x == begin_x) return;
411
412  w->begin_y = begin_y;
413  w->begin_x = begin_x;
414  if (w->mapped) {
415    /* Window is mapped, we must try to have a window at the end */
416    if (w->win) {
417      /* We actually do have a window; let's move it */
418      if (w->pan) {
419        if (move_panel(w->pan, begin_y, begin_x) == OK)
420          return;
421      } else {
422        if (mvderwin(w->win, begin_y, begin_x) == OK) {
423          /* now both we and the parent are dirty */
424          owl_window_dirty(w->parent);
425          owl_window_dirty(w);
426          return;
427        }
428      }
429    }
430    /* We don't have a window or failed to move it. Fine. Brute force. */
431    _owl_window_unrealize(w);
432    _owl_window_realize(w);
433  }
434}
435
436void owl_window_set_position(owl_window *w, int nlines, int ncols, int begin_y, int begin_x)
437{
438  /* can't move the screen */
439  if (w->is_screen) {
440    begin_y = begin_x = 0;
441  }
442
443  if (w->nlines == nlines && w->ncols == ncols) {
444    /* moving is easier */
445    owl_window_move(w, begin_y, begin_x);
446    return;
447  }
448
449  w->begin_y = begin_y;
450  w->begin_x = begin_x;
451  w->nlines = nlines;
452  w->ncols = ncols;
453  /* window is mapped, we must try to have a window at the end */
454  if (w->mapped) {
455    /* resizing in ncurses is hard: give up do a unrealize/realize */
456    _owl_window_unrealize(w);
457  }
458  /* recalculate children sizes BEFORE remapping, so that everything can resize */
459  owl_window_children_foreach_onearg(w, owl_window_recompute_position);
460  if (w->mapped) {
461    _owl_window_realize(w);
462  }
463}
464
465void owl_window_resize(owl_window *w, int nlines, int ncols)
466{
467  owl_window_set_position(w, nlines, ncols, w->begin_y, w->begin_x);
468}
469
470void owl_window_recompute_position(owl_window *w)
471{
472  if (w->size_cb) {
473    /* TODO: size_cb probably wants to actually take four int*s */
474    w->size_cb(w, w->size_cbdata);
475  }
476}
477
478
479/** Stacking order **/
480
481void owl_window_top(owl_window *w) {
482  if (!w->pan) {
483    owl_function_debugmsg("Warning: owl_window_top only makes sense on top-level window");
484    return;
485  }
486  top_panel(w->pan);
487}
488
489owl_window *owl_window_above(owl_window *w) {
490  PANEL *pan;
491
492  if (!w->pan) {
493    owl_function_debugmsg("Warning: owl_window_above only makes sense on top-level window");
494    return NULL;
495  }
496  pan = panel_above(w->pan);
497  /* cast because panel_userptr pointlessly returns a const void * */
498  return pan ? (void*) panel_userptr(pan) : NULL;
499}
500
501owl_window *owl_window_below(owl_window *w) {
502  PANEL *pan;
503
504  if (!w->pan) {
505    owl_function_debugmsg("Warning: owl_window_above only makes sense on top-level window");
506    return NULL;
507  }
508  pan = panel_below(w->pan);
509  /* cast because panel_userptr pointlessly returns a const void * */
510  return pan ? (void*) panel_userptr(pan) : NULL;
511}
Note: See TracBrowser for help on using the repository browser.