NeoMutt  2021-02-05-329-g9e03b7
Teaching an old dog new tricks
DOXYGEN
mutt_window.c File Reference

Window management. More...

#include "config.h"
#include <stdarg.h>
#include <string.h>
#include "mutt/lib.h"
#include "config/lib.h"
#include "core/lib.h"
#include "mutt_window.h"
#include "helpbar/lib.h"
#include "keymap.h"
#include "mutt_curses.h"
#include "opcodes.h"
#include "options.h"
#include "reflow.h"
+ Include dependency graph for mutt_window.c:

Go to the source code of this file.

Functions

static bool window_was_visible (struct MuttWindow *win)
 Was the Window visible? More...
 
static void window_notify (struct MuttWindow *win)
 Notify observers of changes to a Window. More...
 
void window_notify_all (struct MuttWindow *win)
 Notify observers of changes to a Window and its children. More...
 
void window_set_visible (struct MuttWindow *win, bool visible)
 Set a Window visible or hidden. More...
 
struct MuttWindowmutt_window_new (enum WindowType type, enum MuttWindowOrientation orient, enum MuttWindowSize size, int cols, int rows)
 Create a new Window. More...
 
void mutt_window_free (struct MuttWindow **ptr)
 Free a Window and its children. More...
 
void mutt_window_clearline (struct MuttWindow *win, int row)
 Clear a row of a Window. More...
 
void mutt_window_clrtoeol (struct MuttWindow *win)
 Clear to the end of the line. More...
 
static int mutt_dlg_rootwin_observer (struct NotifyCallback *nc)
 Listen for config changes affecting the Root Window - Implements observer_t. More...
 
void mutt_window_free_all (void)
 Free all the default Windows. More...
 
void mutt_window_get_coords (struct MuttWindow *win, int *col, int *row)
 Get the cursor position in the Window. More...
 
void mutt_window_init (void)
 Create the default Windows. More...
 
int mutt_window_move (struct MuttWindow *win, int col, int row)
 Move the cursor in a Window. More...
 
int mutt_window_mvaddstr (struct MuttWindow *win, int col, int row, const char *str)
 Move the cursor and write a fixed string to a Window. More...
 
int mutt_window_mvprintw (struct MuttWindow *win, int col, int row, const char *fmt,...)
 Move the cursor and write a formatted string to a Window. More...
 
void mutt_window_reflow (struct MuttWindow *win)
 Resize a Window and its children. More...
 
void mutt_window_reflow_message_rows (int mw_rows)
 Resize the Message Window. More...
 
int mutt_window_wrap_cols (int width, short wrap)
 Calculate the wrap column for a given screen width. More...
 
int mutt_window_addch (int ch)
 Write one character to a Window. More...
 
int mutt_window_addnstr (const char *str, int num)
 Write a partial string to a Window. More...
 
int mutt_window_addstr (const char *str)
 Write a string to a Window. More...
 
void mutt_window_move_abs (int col, int row)
 Move the cursor to an absolute screen position. More...
 
int mutt_window_printf (const char *fmt,...)
 Write a formatted string to a Window. More...
 
void mutt_window_add_child (struct MuttWindow *parent, struct MuttWindow *child)
 Add a child to Window. More...
 
struct MuttWindowmutt_window_remove_child (struct MuttWindow *parent, struct MuttWindow *child)
 Remove a child from a Window. More...
 
void mutt_winlist_free (struct MuttWindowList *head)
 Free a tree of Windows. More...
 
void mutt_window_set_root (int cols, int rows)
 Set the dimensions of the Root Window. More...
 
bool mutt_window_is_visible (struct MuttWindow *win)
 Is the Window visible? More...
 
struct MuttWindowmutt_window_find (struct MuttWindow *root, enum WindowType type)
 Find a Window of a given type. More...
 
static void window_recalc (struct MuttWindow *win)
 Recalculate a tree of Windows. More...
 
static void window_repaint (struct MuttWindow *win, bool force)
 Repaint a tree of Windows. More...
 
void window_redraw (struct MuttWindow *win, bool force)
 Reflow, recalc and repaint a tree of Windows. More...
 
void window_set_focus (struct MuttWindow *win)
 Set the Window focus. More...
 
struct MuttWindowwindow_get_focus (void)
 Get the currently focussed Window. More...
 
struct MuttWindowwindow_get_dialog (void)
 Get the currently active Dialog. More...
 
void mutt_window_clear (struct MuttWindow *win)
 Clear a Window. More...
 

Variables

struct MuttWindowRootWindow = NULL
 Parent of all Windows. More...
 
struct MuttWindowAllDialogsWindow = NULL
 Parent of all Dialogs. More...
 
struct MuttWindowMessageWindow = NULL
 Message Window, ":set", etc. More...
 
static const struct Mapping EditorHelp []
 Help Bar for the Command Line Editor. More...
 

Detailed Description

Window management.

Authors
  • Richard Russon

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Definition in file mutt_window.c.

Function Documentation

◆ window_was_visible()

static bool window_was_visible ( struct MuttWindow win)
static

Was the Window visible?

Parameters
winWindow
Return values
trueThe Window was visible

Using the WindowState old, check if a Window used to be visible. For a Window to be visible, it must have been visible and it's parent and grandparent, etc.

Definition at line 71 of file mutt_window.c.

72 {
73  if (!win)
74  return false;
75 
76  for (; win; win = win->parent)
77  {
78  if (!win->old.visible)
79  return false;
80  }
81 
82  return true;
83 }
bool visible
Window is visible.
Definition: mutt_window.h:57
struct WindowState old
Previous state of the Window.
Definition: mutt_window.h:123
struct MuttWindow * parent
Parent Window.
Definition: mutt_window.h:130
+ Here is the caller graph for this function:

◆ window_notify()

static void window_notify ( struct MuttWindow win)
static

Notify observers of changes to a Window.

Parameters
winWindow

Definition at line 89 of file mutt_window.c.

90 {
91  if (!win->notify)
92  return;
93 
94  const struct WindowState *old = &win->old;
95  const struct WindowState *state = &win->state;
97 
98  const bool was_visible = window_was_visible(win);
99  const bool is_visible = mutt_window_is_visible(win);
100  if (was_visible != is_visible)
101  flags |= is_visible ? WN_VISIBLE : WN_HIDDEN;
102 
103  if ((state->row_offset != old->row_offset) || (state->col_offset != old->col_offset))
104  flags |= WN_MOVED;
105 
106  if (state->rows > old->rows)
107  flags |= WN_TALLER;
108  else if (state->rows < old->rows)
109  flags |= WN_SHORTER;
110 
111  if (state->cols > old->cols)
112  flags |= WN_WIDER;
113  else if (state->cols < old->cols)
114  flags |= WN_NARROWER;
115 
116  if (flags == WN_NO_FLAGS)
117  return;
118 
119  struct EventWindow ev_w = { win, flags };
121 }
#define WN_NARROWER
Window became narrower.
Definition: mutt_window.h:171
struct MuttWindow * win
Window that changed.
Definition: mutt_window.h:195
An Event that happened to a Window.
Definition: mutt_window.h:193
static bool is_visible(struct Email *e)
Is the message visible?
Definition: mutt_thread.c:62
static bool window_was_visible(struct MuttWindow *win)
Was the Window visible?
Definition: mutt_window.c:71
#define WN_NO_FLAGS
No flags are set.
Definition: mutt_window.h:167
#define WN_WIDER
Window became wider.
Definition: mutt_window.h:170
#define WN_HIDDEN
Window became hidden.
Definition: mutt_window.h:174
short col_offset
Absolute on-screen column.
Definition: mutt_window.h:60
MuttWindow has changed, NotifyWindow, EventWindow.
Definition: notify_type.h:51
struct Notify * notify
Notifications: NotifyWindow, EventWindow.
Definition: mutt_window.h:133
Window state has changed, e.g. WN_VISIBLE.
Definition: mutt_window.h:185
short cols
Number of columns, can be MUTT_WIN_SIZE_UNLIMITED.
Definition: mutt_window.h:58
struct WindowState state
Current state of the Window.
Definition: mutt_window.h:122
#define WN_TALLER
Window became taller.
Definition: mutt_window.h:168
bool mutt_window_is_visible(struct MuttWindow *win)
Is the Window visible?
Definition: mutt_window.c:654
short row_offset
Absolute on-screen row.
Definition: mutt_window.h:61
short rows
Number of rows, can be MUTT_WIN_SIZE_UNLIMITED.
Definition: mutt_window.h:59
uint8_t WindowNotifyFlags
Changes to a MuttWindow.
Definition: mutt_window.h:166
#define WN_SHORTER
Window became shorter.
Definition: mutt_window.h:169
struct WindowState old
Previous state of the Window.
Definition: mutt_window.h:123
The current, or old, state of a Window.
Definition: mutt_window.h:55
#define WN_VISIBLE
Window became visible.
Definition: mutt_window.h:173
#define WN_MOVED
Window moved.
Definition: mutt_window.h:172
bool notify_send(struct Notify *notify, enum NotifyType event_type, int event_subtype, void *event_data)
Send out a notification message.
Definition: notify.c:156
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ window_notify_all()

void window_notify_all ( struct MuttWindow win)

Notify observers of changes to a Window and its children.

Parameters
winWindow

Definition at line 127 of file mutt_window.c.

128 {
129  if (!win)
130  win = RootWindow;
131 
132  window_notify(win);
133 
134  struct MuttWindow *np = NULL;
135  TAILQ_FOREACH(np, &win->children, entries)
136  {
137  window_notify_all(np);
138  }
139  win->old = win->state;
140 }
#define TAILQ_FOREACH(var, head, field)
Definition: queue.h:718
A division of the screen.
Definition: mutt_window.h:117
struct WindowState state
Current state of the Window.
Definition: mutt_window.h:122
struct MuttWindow * RootWindow
Parent of all Windows.
Definition: mutt_window.c:43
static void window_notify(struct MuttWindow *win)
Notify observers of changes to a Window.
Definition: mutt_window.c:89
struct WindowState old
Previous state of the Window.
Definition: mutt_window.h:123
void window_notify_all(struct MuttWindow *win)
Notify observers of changes to a Window and its children.
Definition: mutt_window.c:127
struct MuttWindowList children
Children Windows.
Definition: mutt_window.h:131
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ window_set_visible()

void window_set_visible ( struct MuttWindow win,
bool  visible 
)

Set a Window visible or hidden.

Parameters
winWindow
visibleIf true, make Window visible, otherwise hidden

Definition at line 147 of file mutt_window.c.

148 {
149  if (!win)
150  win = RootWindow;
151 
152  win->state.visible = visible;
153 }
struct WindowState state
Current state of the Window.
Definition: mutt_window.h:122
struct MuttWindow * RootWindow
Parent of all Windows.
Definition: mutt_window.c:43
bool visible
Window is visible.
Definition: mutt_window.h:57
+ Here is the caller graph for this function:

◆ mutt_window_new()

struct MuttWindow* mutt_window_new ( enum WindowType  type,
enum MuttWindowOrientation  orient,
enum MuttWindowSize  size,
int  cols,
int  rows 
)

Create a new Window.

Parameters
typeWindow type, e.g. WT_ROOT
orientWindow orientation, e.g. MUTT_WIN_ORIENT_VERTICAL
sizeWindow size, e.g. MUTT_WIN_SIZE_MAXIMISE
colsInitial number of columns to allocate, can be MUTT_WIN_SIZE_UNLIMITED
rowsInitial number of rows to allocate, can be MUTT_WIN_SIZE_UNLIMITED
Return values
ptrNew Window

Definition at line 164 of file mutt_window.c.

166 {
167  struct MuttWindow *win = mutt_mem_calloc(1, sizeof(struct MuttWindow));
168 
169  win->type = type;
170  win->orient = orient;
171  win->size = size;
172  win->req_rows = rows;
173  win->req_cols = cols;
174  win->state.visible = true;
175  win->notify = notify_new();
176  TAILQ_INIT(&win->children);
177  return win;
178 }
void * mutt_mem_calloc(size_t nmemb, size_t size)
Allocate zeroed memory on the heap.
Definition: memory.c:50
enum MuttWindowOrientation orient
Which direction the Window will expand.
Definition: mutt_window.h:125
A division of the screen.
Definition: mutt_window.h:117
struct Notify * notify
Notifications: NotifyWindow, EventWindow.
Definition: mutt_window.h:133
#define TAILQ_INIT(head)
Definition: queue.h:758
struct Notify * notify_new(void)
Create a new notifications handler.
Definition: notify.c:49
struct WindowState state
Current state of the Window.
Definition: mutt_window.h:122
bool visible
Window is visible.
Definition: mutt_window.h:57
enum MuttWindowSize size
Type of Window, e.g. MUTT_WIN_SIZE_FIXED.
Definition: mutt_window.h:126
struct MuttWindowList children
Children Windows.
Definition: mutt_window.h:131
short req_rows
Number of rows required.
Definition: mutt_window.h:120
enum WindowType type
Window type, e.g. WT_SIDEBAR.
Definition: mutt_window.h:139
short req_cols
Number of columns required.
Definition: mutt_window.h:119
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ mutt_window_free()

void mutt_window_free ( struct MuttWindow **  ptr)

Free a Window and its children.

Parameters
ptrWindow to free

Definition at line 184 of file mutt_window.c.

185 {
186  if (!ptr || !*ptr)
187  return;
188 
189  struct MuttWindow *win = *ptr;
190 
191  if (win->parent && (win->parent->focus == win))
192  win->parent->focus = NULL;
193 
194  struct EventWindow ev_w = { win, WN_NO_FLAGS };
196 
198 
199  if (win->wdata && win->wdata_free)
200  win->wdata_free(win, &win->wdata); // Custom function to free private data
201 
202  notify_free(&win->notify);
203 
204  FREE(ptr);
205 }
void(* wdata_free)(struct MuttWindow *win, void **ptr)
Free the private data attached to the MuttWindow.
Definition: mutt_window.h:147
struct MuttWindow * win
Window that changed.
Definition: mutt_window.h:195
An Event that happened to a Window.
Definition: mutt_window.h:193
void notify_free(struct Notify **ptr)
Free a notification handler.
Definition: notify.c:62
#define WN_NO_FLAGS
No flags are set.
Definition: mutt_window.h:167
Window is about to be deleted.
Definition: mutt_window.h:184
A division of the screen.
Definition: mutt_window.h:117
MuttWindow has changed, NotifyWindow, EventWindow.
Definition: notify_type.h:51
struct MuttWindow * focus
Focussed Window.
Definition: mutt_window.h:135
struct Notify * notify
Notifications: NotifyWindow, EventWindow.
Definition: mutt_window.h:133
void mutt_winlist_free(struct MuttWindowList *head)
Free a tree of Windows.
Definition: mutt_window.c:601
struct MuttWindow * parent
Parent Window.
Definition: mutt_window.h:130
#define FREE(x)
Definition: memory.h:40
struct MuttWindowList children
Children Windows.
Definition: mutt_window.h:131
void * wdata
Private data.
Definition: mutt_window.h:140
bool notify_send(struct Notify *notify, enum NotifyType event_type, int event_subtype, void *event_data)
Send out a notification message.
Definition: notify.c:156
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ mutt_window_clearline()

void mutt_window_clearline ( struct MuttWindow win,
int  row 
)

Clear a row of a Window.

Parameters
winWindow
rowRow to clear

Definition at line 230 of file mutt_window.c.

231 {
232  mutt_window_move(win, 0, row);
234 }
void mutt_window_clrtoeol(struct MuttWindow *win)
Clear to the end of the line.
Definition: mutt_window.c:242
int mutt_window_move(struct MuttWindow *win, int col, int row)
Move the cursor in a Window.
Definition: mutt_window.c:382
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ mutt_window_clrtoeol()

void mutt_window_clrtoeol ( struct MuttWindow win)

Clear to the end of the line.

Parameters
winWindow
Note
Assumes the cursor has already been positioned within the window.

Definition at line 242 of file mutt_window.c.

243 {
244  if (!win || !stdscr)
245  return;
246 
247  if (win->state.col_offset + win->state.cols == COLS)
248  clrtoeol();
249  else
250  {
251  int row = 0;
252  int col = 0;
253  getyx(stdscr, row, col);
254  int curcol = col;
255  while (curcol < (win->state.col_offset + win->state.cols))
256  {
257  addch(' ');
258  curcol++;
259  }
260  move(row, col);
261  }
262 }
short col_offset
Absolute on-screen column.
Definition: mutt_window.h:60
short cols
Number of columns, can be MUTT_WIN_SIZE_UNLIMITED.
Definition: mutt_window.h:58
struct WindowState state
Current state of the Window.
Definition: mutt_window.h:122
+ Here is the caller graph for this function:

◆ mutt_dlg_rootwin_observer()

static int mutt_dlg_rootwin_observer ( struct NotifyCallback nc)
static

Listen for config changes affecting the Root Window - Implements observer_t.

Definition at line 267 of file mutt_window.c.

268 {
269  if (!nc->event_data || !nc->global_data)
270  return -1;
271  if (nc->event_type != NT_CONFIG)
272  return 0;
273 
274  struct EventConfig *ec = nc->event_data;
275  struct MuttWindow *root_win = nc->global_data;
276 
277  if (mutt_str_equal(ec->name, "status_on_top"))
278  {
279  struct MuttWindow *first = TAILQ_FIRST(&root_win->children);
280  if (!first)
281  return -1;
282 
283  const bool c_status_on_top = cs_subset_bool(NeoMutt->sub, "status_on_top");
284  if ((c_status_on_top && (first->type == WT_HELP_BAR)) ||
285  (!c_status_on_top && (first->type != WT_HELP_BAR)))
286  {
287  // Swap the HelpLine and the Dialogs Container
288  struct MuttWindow *next = TAILQ_NEXT(first, entries);
289  if (!next)
290  return -1;
291  TAILQ_REMOVE(&root_win->children, next, entries);
292  TAILQ_INSERT_HEAD(&root_win->children, next, entries);
293  }
294  }
295 
296  mutt_window_reflow(root_win);
297  return 0;
298 }
bool mutt_str_equal(const char *a, const char *b)
Compare two strings.
Definition: string.c:871
bool cs_subset_bool(const struct ConfigSubset *sub, const char *name)
Get a boolean config item by name.
Definition: helpers.c:71
#define TAILQ_FIRST(head)
Definition: queue.h:716
A config-change event.
Definition: subset.h:70
A division of the screen.
Definition: mutt_window.h:117
Container for Accounts, Notifications.
Definition: neomutt.h:36
enum NotifyType event_type
Send: Event type, e.g. NT_ACCOUNT.
Definition: observer.h:42
void * global_data
Data from notify_observer_add()
Definition: observer.h:45
#define TAILQ_REMOVE(head, elm, field)
Definition: queue.h:834
Help Bar containing list of useful key bindings.
Definition: mutt_window.h:94
void * event_data
Data from notify_send()
Definition: observer.h:44
Config has changed, NotifyConfig, EventConfig.
Definition: notify_type.h:41
#define TAILQ_INSERT_HEAD(head, elm, field)
Definition: queue.h:789
void mutt_window_reflow(struct MuttWindow *win)
Resize a Window and its children.
Definition: mutt_window.c:433
struct MuttWindowList children
Children Windows.
Definition: mutt_window.h:131
#define TAILQ_NEXT(elm, field)
Definition: queue.h:825
struct ConfigSubset * sub
Inherited config items.
Definition: neomutt.h:39
enum WindowType type
Window type, e.g. WT_SIDEBAR.
Definition: mutt_window.h:139
const char * name
Name of config item that changed.
Definition: subset.h:73
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ mutt_window_free_all()

void mutt_window_free_all ( void  )

Free all the default Windows.

Definition at line 303 of file mutt_window.c.

304 {
305  if (NeoMutt)
307  AllDialogsWindow = NULL;
308  MessageWindow = NULL;
310 }
static int mutt_dlg_rootwin_observer(struct NotifyCallback *nc)
Listen for config changes affecting the Root Window - Implements observer_t.
Definition: mutt_window.c:267
Container for Accounts, Notifications.
Definition: neomutt.h:36
void mutt_window_free(struct MuttWindow **ptr)
Free a Window and its children.
Definition: mutt_window.c:184
struct MuttWindow * MessageWindow
Message Window, ":set", etc.
Definition: mutt_window.c:45
struct MuttWindow * RootWindow
Parent of all Windows.
Definition: mutt_window.c:43
struct Notify * notify
Notifications handler.
Definition: neomutt.h:38
struct MuttWindow * AllDialogsWindow
Parent of all Dialogs.
Definition: mutt_window.c:44
bool notify_observer_remove(struct Notify *notify, observer_t callback, void *global_data)
Remove an observer from an object.
Definition: notify.c:212
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ mutt_window_get_coords()

void mutt_window_get_coords ( struct MuttWindow win,
int *  col,
int *  row 
)

Get the cursor position in the Window.

Parameters
[in]winWindow
[out]colColumn in Window
[out]rowRow in Window

Assumes the current position is inside the window. Otherwise it will happily return negative or values outside the window boundaries

Definition at line 321 of file mutt_window.c.

322 {
323  int x = 0;
324  int y = 0;
325 
326  getyx(stdscr, y, x);
327  if (col)
328  *col = x - win->state.col_offset;
329  if (row)
330  *row = y - win->state.row_offset;
331 }
short col_offset
Absolute on-screen column.
Definition: mutt_window.h:60
struct WindowState state
Current state of the Window.
Definition: mutt_window.h:122
short row_offset
Absolute on-screen row.
Definition: mutt_window.h:61
+ Here is the caller graph for this function:

◆ mutt_window_init()

void mutt_window_init ( void  )

Create the default Windows.

Create the Help, Index, Status, Message and Sidebar Windows.

Definition at line 338 of file mutt_window.c.

339 {
340  if (RootWindow)
341  return;
342 
343  RootWindow =
346 
347  struct MuttWindow *win_helpbar = helpbar_create();
348 
352 
357 
358  const bool c_status_on_top = cs_subset_bool(NeoMutt->sub, "status_on_top");
359  if (c_status_on_top)
360  {
362  mutt_window_add_child(RootWindow, win_helpbar);
363  }
364  else
365  {
366  mutt_window_add_child(RootWindow, win_helpbar);
368  }
369 
372 }
static int mutt_dlg_rootwin_observer(struct NotifyCallback *nc)
Listen for config changes affecting the Root Window - Implements observer_t.
Definition: mutt_window.c:267
bool cs_subset_bool(const struct ConfigSubset *sub, const char *name)
Get a boolean config item by name.
Definition: helpers.c:71
Window for messages/errors and command entry.
Definition: mutt_window.h:98
int help_menu
Menu for key bindings, e.g. MENU_PAGER.
Definition: mutt_window.h:136
Window uses all available vertical space.
Definition: mutt_window.h:36
Parent of All Windows.
Definition: mutt_window.h:70
static const struct Mapping EditorHelp[]
Help Bar for the Command Line Editor.
Definition: mutt_window.c:48
A division of the screen.
Definition: mutt_window.h:117
Container for Accounts, Notifications.
Definition: neomutt.h:36
struct Notify * notify
Notifications: NotifyWindow, EventWindow.
Definition: mutt_window.h:133
struct MuttWindow * helpbar_create(void)
Create the Help Bar Window.
Definition: helpbar.c:263
bool notify_observer_add(struct Notify *notify, enum NotifyType type, observer_t callback, void *global_data)
Add an observer to an object.
Definition: notify.c:173
Window has a fixed size.
Definition: mutt_window.h:45
struct MuttWindow * MessageWindow
Message Window, ":set", etc.
Definition: mutt_window.c:45
struct MuttWindow * RootWindow
Parent of all Windows.
Definition: mutt_window.c:43
#define MUTT_WIN_SIZE_UNLIMITED
Use as much space as possible.
Definition: mutt_window.h:50
const struct Mapping * help_data
Data for the Help Bar.
Definition: mutt_window.h:137
struct Notify * notify
Notifications handler.
Definition: neomutt.h:38
Container for All Dialogs (nested Windows)
Definition: mutt_window.h:72
struct MuttWindow * AllDialogsWindow
Parent of all Dialogs.
Definition: mutt_window.c:44
void mutt_window_add_child(struct MuttWindow *parent, struct MuttWindow *child)
Add a child to Window.
Definition: mutt_window.c:562
Config has changed, NotifyConfig, EventConfig.
Definition: notify_type.h:41
Text entry area.
Definition: keymap.h:77
void notify_set_parent(struct Notify *notify, struct Notify *parent)
Set the parent notification handler.
Definition: notify.c:82
struct ConfigSubset * sub
Inherited config items.
Definition: neomutt.h:39
struct MuttWindow * mutt_window_new(enum WindowType type, enum MuttWindowOrientation orient, enum MuttWindowSize size, int cols, int rows)
Create a new Window.
Definition: mutt_window.c:164
Window wants as much space as possible.
Definition: mutt_window.h:46
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ mutt_window_move()

int mutt_window_move ( struct MuttWindow win,
int  col,
int  row 
)

Move the cursor in a Window.

Parameters
winWindow
colColumn to move to
rowRow to move to
Return values
OKSuccess
ERRError

Definition at line 382 of file mutt_window.c.

383 {
384  return move(win->state.row_offset + row, win->state.col_offset + col);
385 }
short col_offset
Absolute on-screen column.
Definition: mutt_window.h:60
struct WindowState state
Current state of the Window.
Definition: mutt_window.h:122
short row_offset
Absolute on-screen row.
Definition: mutt_window.h:61
+ Here is the caller graph for this function:

◆ mutt_window_mvaddstr()

int mutt_window_mvaddstr ( struct MuttWindow win,
int  col,
int  row,
const char *  str 
)

Move the cursor and write a fixed string to a Window.

Parameters
winWindow to write to
colColumn to move to
rowRow to move to
strString to write
Return values
OKSuccess
ERRError

Definition at line 396 of file mutt_window.c.

397 {
398 #ifdef USE_SLANG_CURSES
399  return mvaddstr(win->state.row_offset + row, win->state.col_offset + col, (char *) str);
400 #else
401  return mvaddstr(win->state.row_offset + row, win->state.col_offset + col, str);
402 #endif
403 }
short col_offset
Absolute on-screen column.
Definition: mutt_window.h:60
struct WindowState state
Current state of the Window.
Definition: mutt_window.h:122
short row_offset
Absolute on-screen row.
Definition: mutt_window.h:61
+ Here is the caller graph for this function:

◆ mutt_window_mvprintw()

int mutt_window_mvprintw ( struct MuttWindow win,
int  col,
int  row,
const char *  fmt,
  ... 
)

Move the cursor and write a formatted string to a Window.

Parameters
winWindow to write to
colColumn to move to
rowRow to move to
fmtprintf format string
...printf arguments
Return values
numSuccess, characters written
ERRError, move failed

Definition at line 415 of file mutt_window.c.

416 {
417  int rc = mutt_window_move(win, col, row);
418  if (rc == ERR)
419  return rc;
420 
421  va_list ap;
422  va_start(ap, fmt);
423  rc = vw_printw(stdscr, fmt, ap);
424  va_end(ap);
425 
426  return rc;
427 }
int mutt_window_move(struct MuttWindow *win, int col, int row)
Move the cursor in a Window.
Definition: mutt_window.c:382
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ mutt_window_reflow()

void mutt_window_reflow ( struct MuttWindow win)

Resize a Window and its children.

Parameters
winWindow to resize

Definition at line 433 of file mutt_window.c.

434 {
435  if (OptNoCurses)
436  return;
437 
438  if (!win)
439  win = RootWindow;
440 
441  mutt_debug(LL_DEBUG2, "entering\n");
442  window_reflow(win);
443  window_notify_all(win);
444 
445 #ifdef USE_DEBUG_WINDOW
446  debug_win_dump();
447 #endif
448 }
WHERE bool OptNoCurses
(pseudo) when sending in batch mode
Definition: options.h:48
Log at debug level 2.
Definition: logging.h:41
void window_reflow(struct MuttWindow *win)
Reflow Windows.
Definition: reflow.c:222
struct MuttWindow * RootWindow
Parent of all Windows.
Definition: mutt_window.c:43
void window_notify_all(struct MuttWindow *win)
Notify observers of changes to a Window and its children.
Definition: mutt_window.c:127
void debug_win_dump(void)
Definition: window.c:90
#define mutt_debug(LEVEL,...)
Definition: logging.h:81
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ mutt_window_reflow_message_rows()

void mutt_window_reflow_message_rows ( int  mw_rows)

Resize the Message Window.

Parameters
mw_rowsNumber of rows required

Resize the other Windows to allow a multi-line message to be displayed.

Definition at line 456 of file mutt_window.c.

457 {
458  MessageWindow->req_rows = mw_rows;
460 
461  /* We don't also set REDRAW_FLOW because this function only
462  * changes rows and is a temporary adjustment. */
463  window_redraw(RootWindow, true);
464 }
struct MuttWindow * MessageWindow
Message Window, ":set", etc.
Definition: mutt_window.c:45
struct MuttWindow * RootWindow
Parent of all Windows.
Definition: mutt_window.c:43
void mutt_window_reflow(struct MuttWindow *win)
Resize a Window and its children.
Definition: mutt_window.c:433
struct MuttWindow * parent
Parent Window.
Definition: mutt_window.h:130
short req_rows
Number of rows required.
Definition: mutt_window.h:120
void window_redraw(struct MuttWindow *win, bool force)
Reflow, recalc and repaint a tree of Windows.
Definition: mutt_window.c:744
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ mutt_window_wrap_cols()

int mutt_window_wrap_cols ( int  width,
short  wrap 
)

Calculate the wrap column for a given screen width.

Parameters
widthScreen width
wrapWrap config
Return values
numColumn that text should be wrapped at

The wrap variable can be negative, meaning there should be a right margin.

Definition at line 474 of file mutt_window.c.

475 {
476  if (wrap < 0)
477  return (width > -wrap) ? (width + wrap) : width;
478  if (wrap)
479  return (wrap < width) ? wrap : width;
480  return width;
481 }
+ Here is the caller graph for this function:

◆ mutt_window_addch()

int mutt_window_addch ( int  ch)

Write one character to a Window.

Parameters
chCharacter to write
Return values
0Success
-1Error

Definition at line 489 of file mutt_window.c.

490 {
491  return addch(ch);
492 }
+ Here is the caller graph for this function:

◆ mutt_window_addnstr()

int mutt_window_addnstr ( const char *  str,
int  num 
)

Write a partial string to a Window.

Parameters
strString
numMaximum number of characters to write
Return values
0Success
-1Error

Definition at line 501 of file mutt_window.c.

502 {
503  if (!str)
504  return -1;
505 
506 #ifdef USE_SLANG_CURSES
507  return addnstr((char *) str, num);
508 #else
509  return addnstr(str, num);
510 #endif
511 }
+ Here is the caller graph for this function:

◆ mutt_window_addstr()

int mutt_window_addstr ( const char *  str)

Write a string to a Window.

Parameters
strString
Return values
0Success
-1Error

Definition at line 519 of file mutt_window.c.

520 {
521  if (!str)
522  return -1;
523 
524 #ifdef USE_SLANG_CURSES
525  return addstr((char *) str);
526 #else
527  return addstr(str);
528 #endif
529 }
+ Here is the caller graph for this function:

◆ mutt_window_move_abs()

void mutt_window_move_abs ( int  col,
int  row 
)

Move the cursor to an absolute screen position.

Parameters
colScreen column (0-based)
rowScreen row (0-based)

Definition at line 536 of file mutt_window.c.

537 {
538  move(row, col);
539 }
+ Here is the caller graph for this function:

◆ mutt_window_printf()

int mutt_window_printf ( const char *  fmt,
  ... 
)

Write a formatted string to a Window.

Parameters
fmtFormat string
...Arguments
Return values
numNumber of characters written

Definition at line 547 of file mutt_window.c.

548 {
549  va_list ap;
550  va_start(ap, fmt);
551  int rc = vw_printw(stdscr, fmt, ap);
552  va_end(ap);
553 
554  return rc;
555 }
+ Here is the caller graph for this function:

◆ mutt_window_add_child()

void mutt_window_add_child ( struct MuttWindow parent,
struct MuttWindow child 
)

Add a child to Window.

Parameters
parentWindow to add to
childWindow to add

Definition at line 562 of file mutt_window.c.

563 {
564  if (!parent || !child)
565  return;
566 
567  TAILQ_INSERT_TAIL(&parent->children, child, entries);
568  child->parent = parent;
569 
570  notify_set_parent(child->notify, parent->notify);
571 
572  struct EventWindow ev_w = { child, WN_NO_FLAGS };
573  notify_send(child->notify, NT_WINDOW, NT_WINDOW_NEW, &ev_w);
574 }
An Event that happened to a Window.
Definition: mutt_window.h:193
#define WN_NO_FLAGS
No flags are set.
Definition: mutt_window.h:167
MuttWindow has changed, NotifyWindow, EventWindow.
Definition: notify_type.h:51
struct Notify * notify
Notifications: NotifyWindow, EventWindow.
Definition: mutt_window.h:133
New Window has been added.
Definition: mutt_window.h:183
#define TAILQ_INSERT_TAIL(head, elm, field)
Definition: queue.h:802
struct MuttWindow * parent
Parent Window.
Definition: mutt_window.h:130
struct MuttWindowList children
Children Windows.
Definition: mutt_window.h:131
void notify_set_parent(struct Notify *notify, struct Notify *parent)
Set the parent notification handler.
Definition: notify.c:82
bool notify_send(struct Notify *notify, enum NotifyType event_type, int event_subtype, void *event_data)
Send out a notification message.
Definition: notify.c:156
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ mutt_window_remove_child()

struct MuttWindow* mutt_window_remove_child ( struct MuttWindow parent,
struct MuttWindow child 
)

Remove a child from a Window.

Parameters
parentWindow to remove from
childWindow to remove

Definition at line 581 of file mutt_window.c.

582 {
583  if (!parent || !child)
584  return NULL;
585 
586  struct EventWindow ev_w = { child, WN_NO_FLAGS };
587  notify_send(child->notify, NT_WINDOW, NT_WINDOW_DELETE, &ev_w);
588 
589  TAILQ_REMOVE(&parent->children, child, entries);
590  child->parent = NULL;
591 
592  notify_set_parent(child->notify, NULL);
593 
594  return child;
595 }
An Event that happened to a Window.
Definition: mutt_window.h:193
#define WN_NO_FLAGS
No flags are set.
Definition: mutt_window.h:167
Window is about to be deleted.
Definition: mutt_window.h:184
MuttWindow has changed, NotifyWindow, EventWindow.
Definition: notify_type.h:51
struct Notify * notify
Notifications: NotifyWindow, EventWindow.
Definition: mutt_window.h:133
#define TAILQ_REMOVE(head, elm, field)
Definition: queue.h:834
struct MuttWindow * parent
Parent Window.
Definition: mutt_window.h:130
struct MuttWindowList children
Children Windows.
Definition: mutt_window.h:131
void notify_set_parent(struct Notify *notify, struct Notify *parent)
Set the parent notification handler.
Definition: notify.c:82
bool notify_send(struct Notify *notify, enum NotifyType event_type, int event_subtype, void *event_data)
Send out a notification message.
Definition: notify.c:156
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ mutt_winlist_free()

void mutt_winlist_free ( struct MuttWindowList *  head)

Free a tree of Windows.

Parameters
headWindowList to free

Definition at line 601 of file mutt_window.c.

602 {
603  if (!head)
604  return;
605 
606  struct MuttWindow *np = NULL;
607  struct MuttWindow *tmp = NULL;
608  TAILQ_FOREACH_SAFE(np, head, entries, tmp)
609  {
610  TAILQ_REMOVE(head, np, entries);
612  mutt_window_free(&np);
613  }
614 }
#define TAILQ_FOREACH_SAFE(var, head, field, tvar)
Definition: queue.h:728
A division of the screen.
Definition: mutt_window.h:117
void mutt_window_free(struct MuttWindow **ptr)
Free a Window and its children.
Definition: mutt_window.c:184
void mutt_winlist_free(struct MuttWindowList *head)
Free a tree of Windows.
Definition: mutt_window.c:601
#define TAILQ_REMOVE(head, elm, field)
Definition: queue.h:834
struct MuttWindowList children
Children Windows.
Definition: mutt_window.h:131
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ mutt_window_set_root()

void mutt_window_set_root ( int  cols,
int  rows 
)

Set the dimensions of the Root Window.

Parameters
rows
cols

Definition at line 621 of file mutt_window.c.

622 {
623  if (!RootWindow)
624  return;
625 
626  bool changed = false;
627 
628  if (RootWindow->state.rows != rows)
629  {
630  RootWindow->state.rows = rows;
631  changed = true;
632  }
633 
634  if (RootWindow->state.cols != cols)
635  {
636  RootWindow->state.cols = cols;
637  changed = true;
638  }
639 
640  if (changed)
641  {
643  }
644 }
short cols
Number of columns, can be MUTT_WIN_SIZE_UNLIMITED.
Definition: mutt_window.h:58
struct WindowState state
Current state of the Window.
Definition: mutt_window.h:122
struct MuttWindow * RootWindow
Parent of all Windows.
Definition: mutt_window.c:43
short rows
Number of rows, can be MUTT_WIN_SIZE_UNLIMITED.
Definition: mutt_window.h:59
void mutt_window_reflow(struct MuttWindow *win)
Resize a Window and its children.
Definition: mutt_window.c:433
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ mutt_window_is_visible()

bool mutt_window_is_visible ( struct MuttWindow win)

Is the Window visible?

Parameters
winWindow
Return values
trueThe Window is visible

For a Window to be visible, it must be visible and it's parent and grandparent, etc.

Definition at line 654 of file mutt_window.c.

655 {
656  if (!win)
657  return false;
658 
659  for (; win; win = win->parent)
660  {
661  if (!win->state.visible)
662  return false;
663  }
664 
665  return true;
666 }
struct WindowState state
Current state of the Window.
Definition: mutt_window.h:122
bool visible
Window is visible.
Definition: mutt_window.h:57
struct MuttWindow * parent
Parent Window.
Definition: mutt_window.h:130
+ Here is the caller graph for this function:

◆ mutt_window_find()

struct MuttWindow* mutt_window_find ( struct MuttWindow root,
enum WindowType  type 
)

Find a Window of a given type.

Parameters
rootWindow to start searching
typeWindow type to find, e.g. WT_INDEX_BAR
Return values
ptrMatching Window
NULLNo match

Definition at line 675 of file mutt_window.c.

676 {
677  if (!root)
678  return NULL;
679  if (root->type == type)
680  return root;
681 
682  struct MuttWindow *np = NULL;
683  struct MuttWindow *match = NULL;
684  TAILQ_FOREACH(np, &root->children, entries)
685  {
686  match = mutt_window_find(np, type);
687  if (match)
688  return match;
689  }
690 
691  return NULL;
692 }
#define TAILQ_FOREACH(var, head, field)
Definition: queue.h:718
struct MuttWindow * mutt_window_find(struct MuttWindow *root, enum WindowType type)
Find a Window of a given type.
Definition: mutt_window.c:675
A division of the screen.
Definition: mutt_window.h:117
struct MuttWindowList children
Children Windows.
Definition: mutt_window.h:131
enum WindowType type
Window type, e.g. WT_SIDEBAR.
Definition: mutt_window.h:139
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ window_recalc()

static void window_recalc ( struct MuttWindow win)
static

Recalculate a tree of Windows.

Parameters
winWindow to start at

Definition at line 698 of file mutt_window.c.

699 {
700  if (!win)
701  return;
702 
703  if (win->recalc)
704  {
705  win->recalc(win);
706  win->actions &= ~WA_RECALC;
707  }
708 
709  struct MuttWindow *np = NULL;
710  TAILQ_FOREACH(np, &win->children, entries)
711  {
712  window_recalc(np);
713  }
714 }
#define TAILQ_FOREACH(var, head, field)
Definition: queue.h:718
A division of the screen.
Definition: mutt_window.h:117
WindowActionFlags actions
Actions to be performed, e.g. WA_RECALC.
Definition: mutt_window.h:127
static void window_recalc(struct MuttWindow *win)
Recalculate a tree of Windows.
Definition: mutt_window.c:698
struct MuttWindowList children
Children Windows.
Definition: mutt_window.h:131
int(* recalc)(struct MuttWindow *win)
Recalculate the Window data.
Definition: mutt_window.h:155
#define WA_RECALC
Recalculate the contents of the Window.
Definition: mutt_window.h:109
+ Here is the caller graph for this function:

◆ window_repaint()

static void window_repaint ( struct MuttWindow win,
bool  force 
)
static

Repaint a tree of Windows.

Parameters
winWindow to start at
forceRepaint everything

Definition at line 721 of file mutt_window.c.

722 {
723  if (!win)
724  return;
725 
726  if (win->repaint && (force || (win->actions & WA_REPAINT)))
727  {
728  win->repaint(win);
729  win->actions &= ~WA_REPAINT;
730  }
731 
732  struct MuttWindow *np = NULL;
733  TAILQ_FOREACH(np, &win->children, entries)
734  {
735  window_repaint(np, force);
736  }
737 }
#define WA_REPAINT
Redraw the contents of the Window.
Definition: mutt_window.h:110
#define TAILQ_FOREACH(var, head, field)
Definition: queue.h:718
A division of the screen.
Definition: mutt_window.h:117
WindowActionFlags actions
Actions to be performed, e.g. WA_RECALC.
Definition: mutt_window.h:127
static void window_repaint(struct MuttWindow *win, bool force)
Repaint a tree of Windows.
Definition: mutt_window.c:721
int(* repaint)(struct MuttWindow *win)
Repaint the Window.
Definition: mutt_window.h:163
struct MuttWindowList children
Children Windows.
Definition: mutt_window.h:131
+ Here is the caller graph for this function:

◆ window_redraw()

void window_redraw ( struct MuttWindow win,
bool  force 
)

Reflow, recalc and repaint a tree of Windows.

Parameters
winWindow to start at
forceRepaint everything

Definition at line 744 of file mutt_window.c.

745 {
746  if (!win)
747  return;
748 
749  window_reflow(win);
750  window_notify_all(win);
751 
752  window_recalc(win);
753  window_repaint(win, force);
754 }
static void window_repaint(struct MuttWindow *win, bool force)
Repaint a tree of Windows.
Definition: mutt_window.c:721
void window_reflow(struct MuttWindow *win)
Reflow Windows.
Definition: reflow.c:222
static void window_recalc(struct MuttWindow *win)
Recalculate a tree of Windows.
Definition: mutt_window.c:698
void window_notify_all(struct MuttWindow *win)
Notify observers of changes to a Window and its children.
Definition: mutt_window.c:127
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ window_set_focus()

void window_set_focus ( struct MuttWindow win)

Set the Window focus.

Parameters
winWindow to focus

Definition at line 760 of file mutt_window.c.

761 {
762  if (!win)
763  return;
764 
765  struct MuttWindow *parent = win->parent;
766  struct MuttWindow *child = win;
767 
768  // Set the chain of focus, all the way to the root
769  for (; parent; child = parent, parent = parent->parent)
770  parent->focus = child;
771 
772  // Find the most focussed Window
773  while (win && win->focus)
774  win = win->focus;
775 
776  struct EventWindow ev_w = { win, WN_NO_FLAGS };
778 #ifdef USE_DEBUG_WINDOW
779  debug_win_dump();
780 #endif
781 }
struct MuttWindow * win
Window that changed.
Definition: mutt_window.h:195
An Event that happened to a Window.
Definition: mutt_window.h:193
#define WN_NO_FLAGS
No flags are set.
Definition: mutt_window.h:167
Window focus has changed.
Definition: mutt_window.h:187
A division of the screen.
Definition: mutt_window.h:117
MuttWindow has changed, NotifyWindow, EventWindow.
Definition: notify_type.h:51
struct MuttWindow * focus
Focussed Window.
Definition: mutt_window.h:135
struct Notify * notify
Notifications: NotifyWindow, EventWindow.
Definition: mutt_window.h:133
struct MuttWindow * parent
Parent Window.
Definition: mutt_window.h:130
void debug_win_dump(void)
Definition: window.c:90
bool notify_send(struct Notify *notify, enum NotifyType event_type, int event_subtype, void *event_data)
Send out a notification message.
Definition: notify.c:156
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ window_get_focus()

struct MuttWindow* window_get_focus ( void  )

Get the currently focussed Window.

Return values
ptrWindow with focus

Definition at line 787 of file mutt_window.c.

788 {
789  struct MuttWindow *win = RootWindow;
790 
791  while (win && win->focus)
792  win = win->focus;
793 
794  return win;
795 }
A division of the screen.
Definition: mutt_window.h:117
struct MuttWindow * focus
Focussed Window.
Definition: mutt_window.h:135
struct MuttWindow * RootWindow
Parent of all Windows.
Definition: mutt_window.c:43
+ Here is the caller graph for this function:

◆ window_get_dialog()

struct MuttWindow* window_get_dialog ( void  )

Get the currently active Dialog.

Return values
ptrActive Dialog

Definition at line 801 of file mutt_window.c.

802 {
803  if (!AllDialogsWindow)
804  return NULL;
805 
806  struct MuttWindow *np = NULL;
807  TAILQ_FOREACH(np, &AllDialogsWindow->children, entries)
808  {
809  if (mutt_window_is_visible(np))
810  return np;
811  }
812 
813  return NULL;
814 }
#define TAILQ_FOREACH(var, head, field)
Definition: queue.h:718
A division of the screen.
Definition: mutt_window.h:117
bool mutt_window_is_visible(struct MuttWindow *win)
Is the Window visible?
Definition: mutt_window.c:654
struct MuttWindow * AllDialogsWindow
Parent of all Dialogs.
Definition: mutt_window.c:44
struct MuttWindowList children
Children Windows.
Definition: mutt_window.h:131
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ mutt_window_clear()

void mutt_window_clear ( struct MuttWindow win)

Clear a Window.

Parameters
winWindow

If the Window isn't visible, it won't be cleared.

Definition at line 822 of file mutt_window.c.

823 {
824  if (!mutt_window_is_visible(win))
825  return;
826 
827  for (int i = 0; i < win->state.rows; i++)
828  mutt_window_clearline(win, i);
829 }
void mutt_window_clearline(struct MuttWindow *win, int row)
Clear a row of a Window.
Definition: mutt_window.c:230
struct WindowState state
Current state of the Window.
Definition: mutt_window.h:122
bool mutt_window_is_visible(struct MuttWindow *win)
Is the Window visible?
Definition: mutt_window.c:654
short rows
Number of rows, can be MUTT_WIN_SIZE_UNLIMITED.
Definition: mutt_window.h:59
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

Variable Documentation

◆ RootWindow

struct MuttWindow* RootWindow = NULL

Parent of all Windows.

Definition at line 43 of file mutt_window.c.

◆ AllDialogsWindow

struct MuttWindow* AllDialogsWindow = NULL

Parent of all Dialogs.

Definition at line 44 of file mutt_window.c.

◆ MessageWindow

struct MuttWindow* MessageWindow = NULL

Message Window, ":set", etc.

Definition at line 45 of file mutt_window.c.

◆ EditorHelp

const struct Mapping EditorHelp[]
static
Initial value:
= {
{ N_("Complete"), OP_EDITOR_COMPLETE },
{ N_("Hist Up"), OP_EDITOR_HISTORY_UP },
{ N_("Hist Down"), OP_EDITOR_HISTORY_DOWN },
{ N_("Hist Search"), OP_EDITOR_HISTORY_SEARCH },
{ N_("Begin Line"), OP_EDITOR_BOL },
{ N_("End Line"), OP_EDITOR_EOL },
{ N_("Kill Line"), OP_EDITOR_KILL_LINE },
{ N_("Kill Word"), OP_EDITOR_KILL_WORD },
{ NULL, 0 },
}
#define N_(a)
Definition: message.h:32

Help Bar for the Command Line Editor.

Definition at line 48 of file mutt_window.c.