Fix last change of grow_mini_window.
[bpt/emacs.git] / src / frame.h
CommitLineData
ff11dfa1 1/* Define frame-object for GNU Emacs.
ab422c4d 2 Copyright (C) 1993-1994, 1999-2013 Free Software Foundation, Inc.
efa4ce8b
JB
3
4This file is part of GNU Emacs.
5
b9b1cc14 6GNU Emacs is free software: you can redistribute it and/or modify
efa4ce8b 7it under the terms of the GNU General Public License as published by
b9b1cc14
GM
8the Free Software Foundation, either version 3 of the License, or
9(at your option) any later version.
efa4ce8b
JB
10
11GNU Emacs is distributed in the hope that it will be useful,
12but WITHOUT ANY WARRANTY; without even the implied warranty of
13MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14GNU General Public License for more details.
15
16You should have received a copy of the GNU General Public License
b9b1cc14 17along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
efa4ce8b 18
843c9999
GM
19/* Don't multiply include: dispextern.h includes macterm.h which
20 includes frame.h some emacs source includes both dispextern.h and
b09cca6a 21 frame.h. */
843c9999 22
84e01749
GM
23#ifndef EMACS_FRAME_H
24#define EMACS_FRAME_H
1f922834 25
facfbbbd 26#include "dispextern.h"
9d7693d7 27#include "termhooks.h"
95b3d095 28#include "window.h"
facfbbbd 29
f00af5b1 30INLINE_HEADER_BEGIN
f00af5b1 31
a3211441 32enum vertical_scroll_bar_type
3b83d631
GM
33{
34 vertical_scroll_bar_none,
35 vertical_scroll_bar_left,
36 vertical_scroll_bar_right
37};
a3211441 38
2806a183
SM
39enum fullscreen_type
40{
3f1c6666
JD
41 FULLSCREEN_NONE,
42 FULLSCREEN_WIDTH = 0x001,
43 FULLSCREEN_HEIGHT = 0x002,
44 FULLSCREEN_BOTH = 0x003,
45 FULLSCREEN_MAXIMIZED = 0x013,
46 FULLSCREEN_WAIT = 0x100
2806a183
SM
47};
48
9d7693d7 49/* The structure representing a frame. */
adf494ff 50
ff11dfa1 51struct frame
efa4ce8b 52{
b102ceb1 53 struct vectorlike_header header;
efa4ce8b 54
21015f9c 55 /* All Lisp_Object components must come first.
21015f9c 56 That ensures they are all aligned normally. */
efa4ce8b 57
fa5d1baa
RS
58 /* Name of this frame: a Lisp string. It is used for looking up resources,
59 as well as for the title in some cases. */
e69b0960 60 Lisp_Object name;
efa4ce8b 61
e7f79a67
RS
62 /* The name to use for the icon, the last time
63 it was refreshed. nil means not explicitly specified. */
e69b0960 64 Lisp_Object icon_name;
e7f79a67 65
fa5d1baa
RS
66 /* This is the frame title specified explicitly, if any.
67 Usually it is nil. */
e69b0960 68 Lisp_Object title;
fa5d1baa 69
eb8c3be9 70 /* The frame which should receive keystrokes that occur in this
46a5c487
JB
71 frame, or nil if they should go to the frame itself. This is
72 usually nil, but if the frame is minibufferless, we can use this
73 to redirect keystrokes to a surrogate minibuffer frame when
74 needed.
75
76 Note that a value of nil is different than having the field point
77 to the frame itself. Whenever the Fselect_frame function is used
78 to shift from one frame to the other, any redirections to the
79 original frame are shifted to the newly selected frame; if
80 focus_frame is nil, Fselect_frame will leave it alone. */
e69b0960 81 Lisp_Object focus_frame;
0f79a4ae 82
ff11dfa1
JB
83 /* This frame's root window. Every frame has one.
84 If the frame has only a minibuffer window, this is it.
85 Otherwise, if the frame has a minibuffer window, this is its sibling. */
e69b0960 86 Lisp_Object root_window;
efa4ce8b 87
ff11dfa1
JB
88 /* This frame's selected window.
89 Each frame has its own window hierarchy
90 and one of the windows in it is selected within the frame.
91 The selected window of the selected frame is Emacs's selected window. */
e69b0960 92 Lisp_Object selected_window;
efa4ce8b 93
ff11dfa1
JB
94 /* This frame's minibuffer window.
95 Most frames have their own minibuffer windows,
96 but only the selected frame's minibuffer window
efa4ce8b 97 can actually appear to exist. */
e69b0960 98 Lisp_Object minibuffer_window;
efa4ce8b 99
ff11dfa1
JB
100 /* Parameter alist of this frame.
101 These are the parameters specified when creating the frame
102 or modified with modify-frame-parameters. */
e69b0960 103 Lisp_Object param_alist;
efa4ce8b 104
177c0ea7 105 /* List of scroll bars on this frame.
20a6c8d7 106 Actually, we don't specify exactly what is stored here at all; the
a3c87d4e 107 scroll bar implementation code can use it to store anything it likes.
20a6c8d7 108 This field is marked by the garbage collector. It is here
7e59217d 109 instead of in the `device' structure so that the garbage
20a6c8d7
JB
110 collector doesn't need to look inside the window-system-dependent
111 structure. */
e69b0960
DA
112 Lisp_Object scroll_bars;
113 Lisp_Object condemned_scroll_bars;
20a6c8d7 114
ad6cd733
RS
115 /* Vector describing the items to display in the menu bar.
116 Each item has four elements in this vector.
117 They are KEY, STRING, SUBMAP, and HPOS.
118 (HPOS is not used in when the X toolkit is in use.)
119 There are four additional elements of nil at the end, to terminate. */
e69b0960 120 Lisp_Object menu_bar_items;
6d05db81 121
fb63ba7d 122 /* Alist of elements (FACE-NAME . FACE-VECTOR-DATA). */
e69b0960 123 Lisp_Object face_alist;
fb63ba7d 124
21015f9c
RS
125 /* A vector that records the entire structure of this frame's menu bar.
126 For the format of the data, see extensive comments in xmenu.c.
127 Only the X toolkit version uses this. */
e69b0960 128 Lisp_Object menu_bar_vector;
21015f9c
RS
129
130 /* Predicate for selecting buffers for other-buffer. */
e69b0960 131 Lisp_Object buffer_predicate;
21015f9c 132
375ff4f1 133 /* List of buffers viewed in this frame, for other-buffer. */
e69b0960 134 Lisp_Object buffer_list;
375ff4f1 135
a18b8cb5
KL
136 /* List of buffers that were viewed, then buried in this frame. The
137 most recently buried buffer is first. For last-buffer. */
e69b0960 138 Lisp_Object buried_buffer_list;
63bb3d8e 139
5a49b79c 140#if defined (HAVE_X_WINDOWS) && ! defined (USE_X_TOOLKIT) && ! defined (USE_GTK)
3b83d631
GM
141 /* A dummy window used to display menu bars under X when no X
142 toolkit support is available. */
e69b0960 143 Lisp_Object menu_bar_window;
5a49b79c 144#endif
3b83d631 145
742516e0 146#if defined (HAVE_WINDOW_SYSTEM) && ! defined (USE_GTK) && ! defined (HAVE_NS)
9ea173e8 147 /* A window used to display the tool-bar of a frame. */
e69b0960 148 Lisp_Object tool_bar_window;
3b83d631 149
742516e0
DA
150 /* Desired and current contents displayed in that window. */
151 Lisp_Object desired_tool_bar_string;
152 Lisp_Object current_tool_bar_string;
153#endif
154
9ea173e8 155 /* Desired and current tool-bar items. */
e69b0960 156 Lisp_Object tool_bar_items;
3b83d631 157
bfeabdc3
JD
158 /* Where tool bar is, can be left, right, top or bottom. The native
159 tool bar only supports top. */
e69b0960 160 Lisp_Object tool_bar_position;
bfeabdc3 161
63bb3d8e 162 /* Beyond here, there should be no more Lisp_Object components. */
21015f9c 163
3b83d631
GM
164 /* Cache of realized faces. */
165 struct face_cache *face_cache;
21015f9c 166
a390930c 167 /* Number of elements in `menu_bar_vector' that have meaningful data. */
d230cb74 168 int menu_bar_items_used;
a390930c 169
3b83d631
GM
170 /* A buffer to hold the frame's name. We can't use the Lisp
171 string's pointer (`name', above) because it might get relocated. */
bd601e2a
KH
172 char *namebuf;
173
b09cca6a 174 /* Glyph pool and matrix. */
3b83d631
GM
175 struct glyph_pool *current_pool;
176 struct glyph_pool *desired_pool;
177 struct glyph_matrix *desired_matrix;
178 struct glyph_matrix *current_matrix;
179
96c06863 180 /* True means that glyphs on this frame have been initialized so it can
3b83d631 181 be used for output. */
96c06863 182 bool_bf glyphs_initialized_p : 1;
21015f9c 183
96c06863 184 /* Set to true in change_frame_size when size of frame changed
e3d7bd83 185 Clear the frame in clear_garbaged_frames if set. */
96c06863 186 bool_bf resized_p : 1;
e3d7bd83 187
96c06863 188 /* Set to true if the default face for the frame has been
e3d7bd83
DN
189 realized. Reset to zero whenever the default face changes.
190 Used to see the difference between a font change and face change. */
96c06863 191 bool_bf default_face_done_p : 1;
e3d7bd83 192
96c06863 193 /* Set to true if this frame has already been hscrolled during
e3d7bd83 194 current redisplay. */
96c06863 195 bool_bf already_hscrolled_p : 1;
e3d7bd83 196
96c06863
PE
197 /* Set to true when current redisplay has updated frame. */
198 bool_bf updated_p : 1;
e3d7bd83 199
742516e0 200#if defined (HAVE_WINDOW_SYSTEM) && ! defined (USE_GTK) && ! defined (HAVE_NS)
96c06863 201 /* Set to true to minimize tool-bar height even when
e3d7bd83 202 auto-resize-tool-bar is set to grow-only. */
96c06863 203 bool_bf minimize_tool_bar_window_p : 1;
742516e0 204#endif
e3d7bd83 205
9e2a2647 206#if defined (USE_GTK) || defined (HAVE_NS)
96c06863
PE
207 /* True means using a tool bar that comes from the toolkit. */
208 bool_bf external_tool_bar : 1;
488dd4c4
JD
209#endif
210
96c06863 211 /* True means that fonts have been loaded since the last glyph
bd0443bb 212 matrix adjustments. */
96c06863 213 bool_bf fonts_changed : 1;
bd0443bb 214
96c06863
PE
215 /* True means that cursor type has been changed. */
216 bool_bf cursor_type_changed : 1;
655ab9a3
SM
217
218 /* True if it needs to be redisplayed. */
96c06863 219 bool_bf redisplay : 1;
7f6c6450 220
9ea173e8
GM
221 /* Margin at the top of the frame. Used to display the tool-bar. */
222 int tool_bar_lines;
3b83d631 223
880e6158
MR
224 /* Pixel height of tool bar. */
225 int tool_bar_height;
226
045cff16 227 int n_tool_bar_rows;
e3303a23 228 int n_tool_bar_items;
177c0ea7 229
655ab9a3 230 /* A buffer for decode_mode_line. */
3b83d631 231 char *decode_mode_spec_buffer;
21015f9c 232
655ab9a3
SM
233 /* See do_line_insertion_deletion_costs for info on these arrays. */
234 /* Cost of inserting 1 line on this frame. */
21015f9c 235 int *insert_line_cost;
655ab9a3 236 /* Cost of deleting 1 line on this frame. */
21015f9c 237 int *delete_line_cost;
655ab9a3 238 /* Cost of inserting n lines on this frame. */
21015f9c 239 int *insert_n_lines_cost;
655ab9a3 240 /* Cost of deleting n lines on this frame. */
21015f9c
RS
241 int *delete_n_lines_cost;
242
880e6158
MR
243 /* Text width of this frame (excluding fringes, scroll bars and
244 internal border width) and text height (excluding internal border
245 width) in units of canonical characters. */
246 int text_cols, text_lines;
247
248 /* Total width of this frame (including fringes and scroll bars) in
249 units of canonical characters. */
250 int total_cols;
251
252 /* Text width of this frame (excluding fringes, scroll bars and
253 internal border width) and text height (excluding internal border
254 width) in pixels. */
255 int text_width, text_height;
b45afe99 256
880e6158 257 /* New text height and width for pending size change. 0 if no change
f224e500 258 pending. These values represent pixels or canonical character units
880e6158
MR
259 according to the value of new_pixelwise and correlate to the the
260 text width/height of the frame. */
261 int new_width, new_height;
b45afe99 262
880e6158
MR
263 /* Whether new_height and new_width shall be interpreted
264 in pixels. */
265 bool new_pixelwise;
b45afe99
KS
266
267 /* Pixel position of the frame window (x and y offsets in root window). */
268 int left_pos, top_pos;
269
880e6158
MR
270 /* Size of the frame window (including internal border widths) in
271 pixels. */
272 int pixel_width, pixel_height;
b45afe99
KS
273
274 /* These many pixels are the difference between the outer window (i.e. the
655ab9a3 275 left and top of the window manager decoration) and FRAME_X_WINDOW. */
b45afe99
KS
276 int x_pixels_diff, y_pixels_diff;
277
278 /* This is the gravity value for the specified window position. */
279 int win_gravity;
280
281 /* The geometry flags for this window. */
282 int size_hint_flags;
21015f9c 283
b45afe99
KS
284 /* Border width of the frame window as known by the (X) window system. */
285 int border_width;
286
287 /* Width of the internal border. This is a line of background color
288 just inside the window's border. When the frame is selected,
289 a highlighting is displayed inside the internal border. */
290 int internal_border_width;
291
880e6158
MR
292 /* Width of borders between this frame's windows. */
293 int right_divider_width;
294 int bottom_divider_width;
295
b45afe99
KS
296 /* Canonical X unit. Width of default font, in pixels. */
297 int column_width;
298
299 /* Canonical Y unit. Height of a line, in pixels. */
300 int line_height;
21015f9c 301
428a555e
KL
302 /* The output method says how the contents of this frame are
303 displayed. It could be using termcap, or using an X window.
6ed8eeff 304 This must be the same as the terminal->type. */
efa4ce8b
JB
305 enum output_method output_method;
306
6ed8eeff 307 /* The terminal device that this frame uses. If this is NULL, then
655ab9a3 308 the frame has been deleted. */
6ed8eeff 309 struct terminal *terminal;
63bb3d8e 310
7e59217d 311 /* Device-dependent, frame-local auxiliary data used for displaying
428a555e 312 the contents. When the frame is deleted, this data is deleted as
655ab9a3 313 well. */
3b83d631
GM
314 union output_data
315 {
655ab9a3
SM
316 struct tty_output *tty; /* From termchar.h. */
317 struct x_output *x; /* From xterm.h. */
318 struct w32_output *w32; /* From w32term.h. */
319 struct ns_output *ns; /* From nsterm.h. */
d311d28c 320 intptr_t nothing;
3b83d631
GM
321 }
322 output_data;
efa4ce8b 323
655ab9a3 324 /* List of font-drivers available on the frame. */
adf494ff 325 struct font_driver_list *font_driver_list;
6aae9c92
KH
326 /* List of data specific to font-driver and frame, but common to
327 faces. */
328 struct font_data_list *font_data_list;
adf494ff 329
b45afe99
KS
330 /* Total width of fringes reserved for drawing truncation bitmaps,
331 continuation bitmaps and alike. The width is in canonical char
332 units of the frame. This must currently be the case because window
333 sizes aren't pixel values. If it weren't the case, we wouldn't be
334 able to split windows horizontally nicely. */
335 int fringe_cols;
336
337 /* The extra width (in pixels) currently allotted for fringes. */
338 int left_fringe_width, right_fringe_width;
339
655ab9a3 340 /* See FULLSCREEN_ enum below. */
2806a183 341 enum fullscreen_type want_fullscreen;
b45afe99 342
6d05db81
RS
343 /* Number of lines of menu bar. */
344 int menu_bar_lines;
345
880e6158
MR
346 /* Pixel height of menubar. */
347 int menu_bar_height;
348
f8eb1572
DA
349#if defined (HAVE_X_WINDOWS)
350 /* Used by x_wait_for_event when watching for an X event on this frame. */
351 int wait_event_type;
352#endif
353
655ab9a3
SM
354#if defined (USE_X_TOOLKIT) || defined (HAVE_NTGUI) \
355 || defined (HAVE_NS) || defined (USE_GTK)
96c06863
PE
356 /* True means using a menu bar that comes from the X toolkit. */
357 bool_bf external_menu_bar : 1;
655ab9a3
SM
358#endif
359
edfa7fa0
DA
360 /* Next two bitfields are mutually exclusive. They might both be
361 zero if the frame has been made invisible without an icon. */
362
363 /* Nonzero if the frame is currently displayed; we check
a4659527 364 it to see if we should bother updating the frame's contents.
efa4ce8b 365
6548cf00
KL
366 On ttys and on Windows NT/9X, to avoid wasting effort updating
367 visible frames that are actually completely obscured by other
368 windows on the display, we bend the meaning of visible slightly:
edfa7fa0 369 if equal to 2, then the frame is obscured - we still consider
6548cf00 370 it to be "visible" as seen from lisp, but we don't bother
655ab9a3 371 updating it. */
4e0f6479 372 unsigned visible : 2;
a4659527 373
96c06863 374 /* True if the frame is currently iconified. Do not
edfa7fa0 375 set this directly, use SET_FRAME_ICONIFIED instead. */
96c06863 376 bool_bf iconified : 1;
efa4ce8b 377
96c06863
PE
378 /* True if this frame should be redrawn. */
379 bool_bf garbaged : 1;
efa4ce8b 380
96c06863 381 /* False means, if this frame has just one window,
efa4ce8b 382 show no modeline for that window. */
96c06863 383 bool_bf wants_modeline : 1;
efa4ce8b 384
96c06863
PE
385 /* True means raise this frame to the top of the heap when selected. */
386 bool_bf auto_raise : 1;
efa4ce8b 387
96c06863
PE
388 /* True means lower this frame to the bottom of the stack when left. */
389 bool_bf auto_lower : 1;
efa4ce8b 390
ff11dfa1 391 /* True if frame's root window can't be split. */
96c06863 392 bool_bf no_split : 1;
efa4ce8b 393
fbfed6f0
JB
394 /* If this is set, then Emacs won't change the frame name to indicate
395 the current buffer, etcetera. If the user explicitly sets the frame
396 name, this gets set. If the user sets the name to Qnil, this is
397 cleared. */
96c06863 398 bool_bf explicit_name : 1;
fbfed6f0 399
96c06863
PE
400 /* True if size of some window on this frame has changed. */
401 bool_bf window_sizes_changed : 1;
adc12f0f 402
96c06863 403 /* True if the mouse has moved on this display device
e3d7bd83 404 since the last time we checked. */
96c06863 405 bool_bf mouse_moved : 1;
e3d7bd83 406
96c06863
PE
407 /* True means that the pointer is invisible. */
408 bool_bf pointer_invisible : 1;
e044e4fc 409
96c06863 410 /* True means that all windows except mini-window and
d2e113bc 411 selected window on this frame have frozen window starts. */
96c06863 412 bool_bf frozen_window_starts : 1;
d2e113bc 413
3737fee7 414 /* Nonzero if we should actually display the scroll bars on this frame. */
e3d7bd83
DN
415 enum vertical_scroll_bar_type vertical_scroll_bar_type;
416
417 /* What kind of text cursor should we draw in the future?
418 This should always be filled_box_cursor or bar_cursor. */
419 enum text_cursor_kinds desired_cursor;
420
421 /* Width of bar cursor (if we are using that). */
422 int cursor_width;
423
424 /* What kind of text cursor should we draw when the cursor blinks off?
425 This can be filled_box_cursor or bar_cursor or no_cursor. */
426 enum text_cursor_kinds blink_off_cursor;
427
428 /* Width of bar cursor (if we are using that) for blink-off state. */
429 int blink_off_cursor_width;
430
b45afe99
KS
431 /* Configured width of the scroll bar, in pixels and in characters.
432 config_scroll_bar_cols tracks config_scroll_bar_width if the
433 latter is positive; a zero value in config_scroll_bar_width means
434 to compute the actual width on the fly, using config_scroll_bar_cols
435 and the current font width. */
436 int config_scroll_bar_width;
437 int config_scroll_bar_cols;
438
95b999aa
RS
439 /* The baud rate that was used to calculate costs for this frame. */
440 int cost_calculation_baud_rate;
6462918c 441
91a47a68
DN
442 /* frame opacity
443 alpha[0]: alpha transparency of the active frame
f2d5c00f
CY
444 alpha[1]: alpha transparency of inactive frames
445 Negative values mean not to change alpha. */
91a47a68
DN
446 double alpha[2];
447
b61cbba3
GM
448 /* Exponent for gamma correction of colors. 1/(VIEWING_GAMMA *
449 SCREEN_GAMMA) where viewing_gamma is 0.4545 and SCREEN_GAMMA is a
450 frame parameter. 0 means don't do gamma correction. */
451 double gamma;
d1738c45
GM
452
453 /* Additional space to put between text lines on this frame. */
454 int extra_line_spacing;
f1c69c61 455
28d7d09f
KL
456 /* All display backends seem to need these two pixel values. */
457 unsigned long background_pixel;
458 unsigned long foreground_pixel;
efa4ce8b
JB
459};
460
f00af5b1
PE
461/* Most code should use these functions to set Lisp fields in struct frame. */
462
00382e8b 463INLINE void
f00af5b1
PE
464fset_buffer_list (struct frame *f, Lisp_Object val)
465{
466 f->buffer_list = val;
467}
00382e8b 468INLINE void
f00af5b1
PE
469fset_buried_buffer_list (struct frame *f, Lisp_Object val)
470{
471 f->buried_buffer_list = val;
472}
00382e8b 473INLINE void
f00af5b1
PE
474fset_condemned_scroll_bars (struct frame *f, Lisp_Object val)
475{
476 f->condemned_scroll_bars = val;
477}
00382e8b 478INLINE void
f00af5b1
PE
479fset_face_alist (struct frame *f, Lisp_Object val)
480{
481 f->face_alist = val;
482}
00382e8b 483INLINE void
f00af5b1
PE
484fset_focus_frame (struct frame *f, Lisp_Object val)
485{
486 f->focus_frame = val;
487}
00382e8b 488INLINE void
f00af5b1
PE
489fset_icon_name (struct frame *f, Lisp_Object val)
490{
491 f->icon_name = val;
492}
00382e8b 493INLINE void
f00af5b1
PE
494fset_menu_bar_items (struct frame *f, Lisp_Object val)
495{
496 f->menu_bar_items = val;
497}
00382e8b 498INLINE void
f00af5b1
PE
499fset_menu_bar_vector (struct frame *f, Lisp_Object val)
500{
501 f->menu_bar_vector = val;
502}
5a49b79c 503#if defined (HAVE_X_WINDOWS) && ! defined (USE_X_TOOLKIT) && ! defined (USE_GTK)
00382e8b 504INLINE void
f00af5b1
PE
505fset_menu_bar_window (struct frame *f, Lisp_Object val)
506{
507 f->menu_bar_window = val;
508}
5a49b79c 509#endif
00382e8b 510INLINE void
f00af5b1
PE
511fset_name (struct frame *f, Lisp_Object val)
512{
513 f->name = val;
514}
00382e8b 515INLINE void
f00af5b1
PE
516fset_param_alist (struct frame *f, Lisp_Object val)
517{
518 f->param_alist = val;
519}
00382e8b 520INLINE void
f00af5b1
PE
521fset_root_window (struct frame *f, Lisp_Object val)
522{
523 f->root_window = val;
524}
00382e8b 525INLINE void
f00af5b1
PE
526fset_scroll_bars (struct frame *f, Lisp_Object val)
527{
528 f->scroll_bars = val;
529}
00382e8b 530INLINE void
f00af5b1
PE
531fset_selected_window (struct frame *f, Lisp_Object val)
532{
533 f->selected_window = val;
534}
00382e8b 535INLINE void
f00af5b1
PE
536fset_title (struct frame *f, Lisp_Object val)
537{
538 f->title = val;
539}
00382e8b 540INLINE void
f00af5b1
PE
541fset_tool_bar_items (struct frame *f, Lisp_Object val)
542{
543 f->tool_bar_items = val;
544}
00382e8b 545INLINE void
f00af5b1
PE
546fset_tool_bar_position (struct frame *f, Lisp_Object val)
547{
548 f->tool_bar_position = val;
549}
742516e0 550#if defined (HAVE_WINDOW_SYSTEM) && ! defined (USE_GTK) && ! defined (HAVE_NS)
00382e8b 551INLINE void
f00af5b1
PE
552fset_tool_bar_window (struct frame *f, Lisp_Object val)
553{
554 f->tool_bar_window = val;
555}
00382e8b 556INLINE void
742516e0
DA
557fset_current_tool_bar_string (struct frame *f, Lisp_Object val)
558{
559 f->current_tool_bar_string = val;
560}
00382e8b 561INLINE void
742516e0
DA
562fset_desired_tool_bar_string (struct frame *f, Lisp_Object val)
563{
564 f->desired_tool_bar_string = val;
565}
566#endif /* HAVE_WINDOW_SYSTEM && !USE_GTK && !HAVE_NS */
f00af5b1 567
42143acd
DA
568#define NUMVAL(X) ((INTEGERP (X) || FLOATP (X)) ? XFLOATINT (X) : -1)
569
00382e8b 570INLINE double
42143acd
DA
571default_pixels_per_inch_x (void)
572{
573 Lisp_Object v = (CONSP (Vdisplay_pixels_per_inch)
574 ? XCAR (Vdisplay_pixels_per_inch)
575 : Vdisplay_pixels_per_inch);
576 return NUMVAL (v) > 0 ? NUMVAL (v) : 72.0;
577}
578
00382e8b 579INLINE double
42143acd
DA
580default_pixels_per_inch_y (void)
581{
582 Lisp_Object v = (CONSP (Vdisplay_pixels_per_inch)
583 ? XCDR (Vdisplay_pixels_per_inch)
584 : Vdisplay_pixels_per_inch);
585 return NUMVAL (v) > 0 ? NUMVAL (v) : 72.0;
586}
587
6ed8eeff 588#define FRAME_KBOARD(f) ((f)->terminal->kboard)
37ea66e1 589
354884c4
SM
590/* Return a pointer to the image cache of frame F. */
591#define FRAME_IMAGE_CACHE(F) ((F)->terminal->image_cache)
592
b263a6b0
PE
593#define XFRAME(p) \
594 (eassert (FRAMEP (p)), (struct frame *) XUNTAG (p, Lisp_Vectorlike))
aac03cca 595#define XSETFRAME(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_FRAME))
ff11dfa1 596
cea6021b 597/* Given a window, return its frame as a Lisp_Object. */
fd16b54c 598#define WINDOW_FRAME(w) ((w)->frame)
ff11dfa1 599
cea6021b 600/* Test a frame for particular kinds of display methods. */
3224dac1 601#define FRAME_INITIAL_P(f) ((f)->output_method == output_initial)
cea6021b 602#define FRAME_TERMCAP_P(f) ((f)->output_method == output_termcap)
efa7f0f9 603#define FRAME_X_P(f) ((f)->output_method == output_x_window)
0fda9b75 604#ifndef HAVE_NTGUI
96c06863 605#define FRAME_W32_P(f) false
ff687885 606#else
fbd6baed 607#define FRAME_W32_P(f) ((f)->output_method == output_w32)
ff687885
DN
608#endif
609#ifndef MSDOS
96c06863 610#define FRAME_MSDOS_P(f) false
ff687885 611#else
6f181713 612#define FRAME_MSDOS_P(f) ((f)->output_method == output_msdos_raw)
ff687885
DN
613#endif
614#ifndef HAVE_NS
96c06863 615#define FRAME_NS_P(f) false
ff687885 616#else
edfda783 617#define FRAME_NS_P(f) ((f)->output_method == output_ns)
ff687885 618#endif
42143acd 619
efa7f0f9
GV
620/* FRAME_WINDOW_P tests whether the frame is a window, and is
621 defined to be the predicate for the window system being used. */
3b83d631 622
efa7f0f9
GV
623#ifdef HAVE_X_WINDOWS
624#define FRAME_WINDOW_P(f) FRAME_X_P (f)
625#endif
626#ifdef HAVE_NTGUI
fbd6baed 627#define FRAME_WINDOW_P(f) FRAME_W32_P (f)
efa7f0f9 628#endif
edfda783
AR
629#ifdef HAVE_NS
630#define FRAME_WINDOW_P(f) FRAME_NS_P(f)
631#endif
7651b07e 632#ifndef FRAME_WINDOW_P
96c06863 633#define FRAME_WINDOW_P(f) ((void) (f), false)
7651b07e 634#endif
efa7f0f9 635
aad3612f
DA
636/* Dots per inch of the screen the frame F is on. */
637
638#ifdef HAVE_WINDOW_SYSTEM
639
640#define FRAME_RES_X(f) \
641 (eassert (FRAME_WINDOW_P (f)), FRAME_DISPLAY_INFO (f)->resx)
642#define FRAME_RES_Y(f) \
643 (eassert (FRAME_WINDOW_P (f)), FRAME_DISPLAY_INFO (f)->resy)
644
645#else /* !HAVE_WINDOW_SYSTEM */
646
647/* Defaults when no window system available. */
648
649#define FRAME_RES_X(f) default_pixels_per_inch_x ()
650#define FRAME_RES_Y(f) default_pixels_per_inch_y ()
651
652#endif /* HAVE_WINDOW_SYSTEM */
653
7ea692f6
EZ
654/* Return a pointer to the structure holding information about the
655 region of text, if any, that is currently shown in mouse-face on
8e5ba371 656 frame F. We need to define two versions because a TTY-only build
aad3612f 657 does not have FRAME_DISPLAY_INFO. */
8e5ba371
EZ
658#ifdef HAVE_WINDOW_SYSTEM
659# define MOUSE_HL_INFO(F) \
021f2e1a 660 (FRAME_WINDOW_P(F) \
aad3612f 661 ? &FRAME_DISPLAY_INFO(F)->mouse_highlight \
021f2e1a 662 : &(F)->output_data.tty->display_info->mouse_highlight)
8e5ba371
EZ
663#else
664# define MOUSE_HL_INFO(F) \
021f2e1a 665 (&(F)->output_data.tty->display_info->mouse_highlight)
8e5ba371 666#endif
7ea692f6 667
96c06863 668/* True if frame F is still alive (not deleted). */
6ed8eeff 669#define FRAME_LIVE_P(f) ((f)->terminal != 0)
cea6021b 670
96c06863 671/* True if frame F is a minibuffer-only frame. */
ff11dfa1
JB
672#define FRAME_MINIBUF_ONLY_P(f) \
673 EQ (FRAME_ROOT_WINDOW (f), FRAME_MINIBUF_WINDOW (f))
cea6021b 674
96c06863 675/* True if frame F contains it's own minibuffer window. Frame always has
1a23cd48
DA
676 minibuffer window, but it could use minibuffer window of another frame. */
677#define FRAME_HAS_MINIBUF_P(f) \
678 (WINDOWP (f->minibuffer_window) \
679 && XFRAME (XWINDOW (f->minibuffer_window)->frame) == f)
cea6021b 680
880e6158
MR
681/* Pixel width of frame F. */
682#define FRAME_PIXEL_WIDTH(f) ((f)->pixel_width)
683
b45afe99
KS
684/* Pixel height of frame F, including non-toolkit menu bar and
685 non-toolkit tool bar lines. */
686#define FRAME_PIXEL_HEIGHT(f) ((f)->pixel_height)
687
880e6158
MR
688/* Width of frame F, measured in canonical character columns,
689 not including scroll bars if any. */
690#define FRAME_COLS(f) (f)->text_cols
b45afe99
KS
691
692/* Height of frame F, measured in canonical lines, including
693 non-toolkit menu bar and non-toolkit tool bar lines. */
694#define FRAME_LINES(f) (f)->text_lines
695
880e6158
MR
696/* Width of frame F, measured in pixels not including the width for
697 fringes, scroll bar, and internal borders. */
698#define FRAME_TEXT_WIDTH(f) (f)->text_width
699
700/* Height of frame F, measured in pixels not including the height
701 for internal borders. */
702#define FRAME_TEXT_HEIGHT(f) (f)->text_height
cea6021b
RS
703
704/* Number of lines of frame F used for menu bar.
705 This is relevant on terminal frames and on
706 X Windows when not using the X toolkit.
b45afe99 707 These lines are counted in FRAME_LINES. */
6d05db81 708#define FRAME_MENU_BAR_LINES(f) (f)->menu_bar_lines
cea6021b 709
880e6158
MR
710/* Pixel height of frame F's menu bar. */
711#define FRAME_MENU_BAR_HEIGHT(f) (f)->menu_bar_height
712
96c06863 713/* True if this frame should display a tool bar
488dd4c4 714 in a way that does not use any text lines. */
9e2a2647 715#if defined (USE_GTK) || defined (HAVE_NS)
488dd4c4
JD
716#define FRAME_EXTERNAL_TOOL_BAR(f) (f)->external_tool_bar
717#else
96c06863 718#define FRAME_EXTERNAL_TOOL_BAR(f) false
488dd4c4
JD
719#endif
720
9ea173e8 721/* Number of lines of frame F used for the tool-bar. */
9ea173e8 722#define FRAME_TOOL_BAR_LINES(f) (f)->tool_bar_lines
3b83d631 723
880e6158
MR
724/* Pixel height of frame F's tool-bar. */
725#define FRAME_TOOL_BAR_HEIGHT(f) (f)->tool_bar_height
488dd4c4 726
3b83d631 727/* Lines above the top-most window in frame F. */
3b83d631 728#define FRAME_TOP_MARGIN(F) \
021f2e1a 729 (FRAME_MENU_BAR_LINES (F) + FRAME_TOOL_BAR_LINES (F))
3b83d631 730
880e6158
MR
731/* Pixel height of frame F's top margin. */
732#define FRAME_TOP_MARGIN_HEIGHT(F) \
733 (FRAME_MENU_BAR_HEIGHT (F) + FRAME_TOOL_BAR_HEIGHT (F))
4b00d3b1 734
96c06863 735/* True if this frame should display a menu bar
cea6021b 736 in a way that does not use any text lines. */
9e2a2647 737#if defined (USE_X_TOOLKIT) || defined (HAVE_NTGUI) \
edfda783 738 || defined (HAVE_NS) || defined (USE_GTK)
9c95189b 739#define FRAME_EXTERNAL_MENU_BAR(f) (f)->external_menu_bar
4c8888a0 740#else
96c06863 741#define FRAME_EXTERNAL_MENU_BAR(f) false
4c8888a0 742#endif
edfa7fa0 743#define FRAME_VISIBLE_P(f) (f)->visible
cea6021b 744
96c06863 745/* True if frame F is currently visible but hidden. */
0969b893 746#define FRAME_OBSCURED_P(f) ((f)->visible > 1)
cea6021b 747
96c06863 748/* True if frame F is currently iconified. */
cea6021b
RS
749#define FRAME_ICONIFIED_P(f) (f)->iconified
750
edfa7fa0 751/* Mark frame F as currently garbaged. */
655ab9a3
SM
752#define SET_FRAME_GARBAGED(f) \
753 (frame_garbaged = true, fset_redisplay (f), f->garbaged = true)
edfa7fa0 754
96c06863 755/* True if frame F is currently garbaged. */
ff11dfa1 756#define FRAME_GARBAGED_P(f) (f)->garbaged
cea6021b 757
96c06863 758/* True means do not allow splitting this frame's window. */
ff11dfa1 759#define FRAME_NO_SPLIT_P(f) (f)->no_split
cea6021b
RS
760
761/* Not really implemented. */
ff11dfa1 762#define FRAME_WANTS_MODELINE_P(f) (f)->wants_modeline
cea6021b 763
96c06863 764/* True if all windows except selected window and mini window
d2e113bc
DA
765 are frozen on frame F. */
766#define FRAME_WINDOWS_FROZEN(f) (f)->frozen_window_starts
767
96c06863 768/* True if a size change has been requested for frame F
cea6021b
RS
769 but not yet really put into effect. This can be true temporarily
770 when an X event comes in at a bad time. */
adc12f0f 771#define FRAME_WINDOW_SIZES_CHANGED(f) (f)->window_sizes_changed
cea6021b
RS
772
773/* The minibuffer window of frame F, if it has one; otherwise nil. */
e69b0960 774#define FRAME_MINIBUF_WINDOW(f) f->minibuffer_window
cea6021b
RS
775
776/* The root window of the window tree of frame F. */
e69b0960 777#define FRAME_ROOT_WINDOW(f) f->root_window
cea6021b
RS
778
779/* The currently selected window of the window tree of frame F. */
e69b0960 780#define FRAME_SELECTED_WINDOW(f) f->selected_window
cea6021b 781
177c0ea7
JB
782#define FRAME_INSERT_COST(f) (f)->insert_line_cost
783#define FRAME_DELETE_COST(f) (f)->delete_line_cost
ff11dfa1
JB
784#define FRAME_INSERTN_COST(f) (f)->insert_n_lines_cost
785#define FRAME_DELETEN_COST(f) (f)->delete_n_lines_cost
e69b0960 786#define FRAME_FOCUS_FRAME(f) f->focus_frame
cea6021b 787
cea6021b
RS
788/* This frame slot says whether scroll bars are currently enabled for frame F,
789 and which side they are on. */
a3211441
RS
790#define FRAME_VERTICAL_SCROLL_BAR_TYPE(f) ((f)->vertical_scroll_bar_type)
791#define FRAME_HAS_VERTICAL_SCROLL_BARS(f) \
021f2e1a 792 ((f)->vertical_scroll_bar_type != vertical_scroll_bar_none)
a3211441 793#define FRAME_HAS_VERTICAL_SCROLL_BARS_ON_LEFT(f) \
021f2e1a 794 ((f)->vertical_scroll_bar_type == vertical_scroll_bar_left)
a3211441 795#define FRAME_HAS_VERTICAL_SCROLL_BARS_ON_RIGHT(f) \
021f2e1a 796 ((f)->vertical_scroll_bar_type == vertical_scroll_bar_right)
cea6021b
RS
797
798/* Width that a scroll bar in frame F should have, if there is one.
799 Measured in pixels.
800 If scroll bars are turned off, this is still nonzero. */
b45afe99 801#define FRAME_CONFIG_SCROLL_BAR_WIDTH(f) ((f)->config_scroll_bar_width)
cea6021b
RS
802
803/* Width that a scroll bar in frame F should have, if there is one.
804 Measured in columns (characters).
805 If scroll bars are turned off, this is still nonzero. */
b45afe99 806#define FRAME_CONFIG_SCROLL_BAR_COLS(f) ((f)->config_scroll_bar_cols)
cea6021b
RS
807
808/* Width of a scroll bar in frame F, measured in columns (characters),
7d81cf83
GM
809 but only if scroll bars are on the left. If scroll bars are on
810 the right in this frame, or there are no scroll bars, value is 0. */
811
b45afe99 812#define FRAME_LEFT_SCROLL_BAR_COLS(f) \
021f2e1a
AS
813 (FRAME_HAS_VERTICAL_SCROLL_BARS_ON_LEFT (f) \
814 ? FRAME_CONFIG_SCROLL_BAR_COLS (f) \
815 : 0)
7d81cf83 816
b45afe99
KS
817/* Width of a left scroll bar in frame F, measured in pixels */
818
021f2e1a 819#define FRAME_LEFT_SCROLL_BAR_AREA_WIDTH(f) \
b45afe99 820 (FRAME_HAS_VERTICAL_SCROLL_BARS_ON_LEFT (f) \
880e6158 821 ? FRAME_CONFIG_SCROLL_BAR_WIDTH (f) \
b45afe99
KS
822 : 0)
823
7d81cf83
GM
824/* Width of a scroll bar in frame F, measured in columns (characters),
825 but only if scroll bars are on the right. If scroll bars are on
826 the left in this frame, or there are no scroll bars, value is 0. */
827
b45afe99 828#define FRAME_RIGHT_SCROLL_BAR_COLS(f) \
021f2e1a
AS
829 (FRAME_HAS_VERTICAL_SCROLL_BARS_ON_RIGHT (f) \
830 ? FRAME_CONFIG_SCROLL_BAR_COLS (f) \
831 : 0)
cea6021b 832
b45afe99
KS
833/* Width of a right scroll bar area in frame F, measured in pixels */
834
021f2e1a 835#define FRAME_RIGHT_SCROLL_BAR_AREA_WIDTH(f) \
b45afe99 836 (FRAME_HAS_VERTICAL_SCROLL_BARS_ON_RIGHT (f) \
880e6158 837 ? FRAME_CONFIG_SCROLL_BAR_WIDTH (f) \
b45afe99
KS
838 : 0)
839
840/* Actual width of a scroll bar in frame F, measured in columns. */
841
842#define FRAME_SCROLL_BAR_COLS(f) \
021f2e1a
AS
843 (FRAME_HAS_VERTICAL_SCROLL_BARS (f) \
844 ? FRAME_CONFIG_SCROLL_BAR_COLS (f) \
845 : 0)
cea6021b 846
b45afe99
KS
847/* Actual width of a scroll bar area in frame F, measured in pixels. */
848
849#define FRAME_SCROLL_BAR_AREA_WIDTH(f) \
850 (FRAME_HAS_VERTICAL_SCROLL_BARS (f) \
880e6158 851 ? FRAME_CONFIG_SCROLL_BAR_WIDTH (f) \
b45afe99
KS
852 : 0)
853
cea6021b
RS
854/* Total width of frame F, in columns (characters),
855 including the width used by scroll bars if any. */
b45afe99 856#define FRAME_TOTAL_COLS(f) ((f)->total_cols)
cea6021b 857
880e6158
MR
858/* Set the character widths of frame F. WIDTH specifies a nominal
859 character text width. */
860#define SET_FRAME_COLS(f, width) \
861 ((f)->text_cols = (width), \
862 (f)->total_cols = ((width) \
863 + FRAME_SCROLL_BAR_COLS (f) \
864 + FRAME_FRINGE_COLS (f)))
865
866/* Set the pixel widths of frame F. WIDTH specifies a nominal pixel
867 text width. */
868#define SET_FRAME_WIDTH(f, width) \
869 ((f)->text_width = (width), \
870 (f)->pixel_width = ((width) \
871 + FRAME_SCROLL_BAR_AREA_WIDTH (f) \
872 + FRAME_TOTAL_FRINGE_WIDTH (f) \
873 + 2 * FRAME_INTERNAL_BORDER_WIDTH (f)))
874
875/* Set the pixel heights of frame F. HEIGHT specifies a nominal pixel
876 text width. */
877#define SET_FRAME_HEIGHT(f, height) \
878 ((f)->text_height = (height), \
879 (f)->pixel_height = ((height) \
880 + 2 * FRAME_INTERNAL_BORDER_WIDTH (f)))
cea6021b 881
4ff34795 882/* Maximum + 1 legitimate value for FRAME_CURSOR_X. */
b45afe99 883
4ff34795 884#define FRAME_CURSOR_X_LIMIT(f) \
021f2e1a 885 (FRAME_COLS (f) + FRAME_LEFT_SCROLL_BAR_COLS (f))
cea6021b 886
e69b0960 887#define FRAME_SCROLL_BARS(f) (f->scroll_bars)
cea6021b 888
e69b0960
DA
889#define FRAME_CONDEMNED_SCROLL_BARS(f) (f->condemned_scroll_bars)
890#define FRAME_MENU_BAR_ITEMS(f) (f->menu_bar_items)
95b999aa 891#define FRAME_COST_BAUD_RATE(f) ((f)->cost_calculation_baud_rate)
81d00831 892
4d418fcc
KS
893#define FRAME_DESIRED_CURSOR(f) ((f)->desired_cursor)
894#define FRAME_BLINK_OFF_CURSOR(f) ((f)->blink_off_cursor)
895#define FRAME_CURSOR_WIDTH(f) ((f)->cursor_width)
896#define FRAME_BLINK_OFF_CURSOR_WIDTH(f) ((f)->blink_off_cursor_width)
897
9d7693d7
DA
898#define FRAME_FOREGROUND_PIXEL(f) ((f)->foreground_pixel)
899#define FRAME_BACKGROUND_PIXEL(f) ((f)->background_pixel)
900
3b83d631
GM
901/* Return a pointer to the face cache of frame F. */
902
903#define FRAME_FACE_CACHE(F) (F)->face_cache
904
81d00831
KH
905/* Return the size of message_buf of the frame F. We multiply the
906 width of the frame by 4 because multi-byte form may require at most
907 4-byte for a character. */
177c0ea7 908
b45afe99 909#define FRAME_MESSAGE_BUF_SIZE(f) (((int) FRAME_COLS (f)) * 4)
ff11dfa1 910
915a3e00
KS
911#define CHECK_FRAME(x) \
912 CHECK_TYPE (FRAMEP (x), Qframep, x)
913
914#define CHECK_LIVE_FRAME(x) \
915 CHECK_TYPE (FRAMEP (x) && FRAME_LIVE_P (XFRAME (x)), Qframe_live_p, x)
265a9e55 916
ff11dfa1
JB
917/* FOR_EACH_FRAME (LIST_VAR, FRAME_VAR) followed by a statement is a
918 `for' loop which iterates over the elements of Vframe_list. The
35f56f96 919 loop will set FRAME_VAR, a Lisp_Object, to each frame in
ff11dfa1 920 Vframe_list in succession and execute the statement. LIST_VAR
35f56f96 921 should be a Lisp_Object too; it is used to iterate through the
177c0ea7 922 Vframe_list.
e5d77022 923
e3678b64
KH
924 This macro is a holdover from a time when multiple frames weren't always
925 supported. An alternate definition of the macro would expand to
926 something which executes the statement once. */
3b83d631 927
e69b0960
DA
928#define FOR_EACH_FRAME(list_var, frame_var) \
929 for ((list_var) = Vframe_list; \
930 (CONSP (list_var) \
96c06863 931 && (frame_var = XCAR (list_var), true)); \
ee88f64d 932 list_var = XCDR (list_var))
e5d77022 933
5c747675
DA
934/* Reflect mouse movement when a complete frame update is performed. */
935
936#define FRAME_MOUSE_UPDATE(frame) \
937 do { \
938 Mouse_HLInfo *hlinfo = MOUSE_HL_INFO (frame); \
939 if (frame == hlinfo->mouse_face_mouse_frame) \
940 { \
941 block_input (); \
f8c20208
DA
942 note_mouse_highlight (hlinfo->mouse_face_mouse_frame, \
943 hlinfo->mouse_face_mouse_x, \
944 hlinfo->mouse_face_mouse_y); \
5c747675
DA
945 unblock_input (); \
946 } \
dd1fb8cb 947 } while (false)
e5d77022 948
655ab9a3
SM
949/* Set visibility of frame F.
950 We call redisplay_other_windows to make sure the frame gets redisplayed
951 if some changes were applied to it while it wasn't visible (and hence
952 wasn't redisplayed). */
edfa7fa0 953
95b3d095
PE
954INLINE void
955SET_FRAME_VISIBLE (struct frame *f, int v)
956{
957 eassert (0 <= v && v <= 2);
958 if (v == 1 && f->visible != 1)
959 redisplay_other_windows ();
960 f->visible = v;
961}
edfa7fa0
DA
962
963/* Set iconify of frame F. */
964
965#define SET_FRAME_ICONIFIED(f, i) \
966 (f)->iconified = (eassert (0 <= (i) && (i) <= 1), (i))
967
5492865b 968extern Lisp_Object selected_frame;
5e02ce11 969extern Lisp_Object Qframep, Qframe_live_p;
2666355c 970extern Lisp_Object Qtty, Qtty_type;
8848b728 971extern Lisp_Object Qtty_color_mode;
959067a1 972extern Lisp_Object Qterminal;
c53956fe 973extern Lisp_Object Qnoelisp;
efa4ce8b 974
96c06863 975/* True means there is at least one garbaged frame. */
9d7693d7
DA
976extern bool frame_garbaged;
977
0ff162fc 978extern void set_menu_bar_lines (struct frame *, Lisp_Object, Lisp_Object);
7452b7bd 979extern struct frame *decode_window_system_frame (Lisp_Object);
d9f07150
DA
980extern struct frame *decode_live_frame (Lisp_Object);
981extern struct frame *decode_any_frame (Lisp_Object);
383e0970 982extern struct frame *make_initial_frame (void);
959067a1 983extern struct frame *make_frame (bool);
c9e5d3d1 984#ifdef HAVE_WINDOW_SYSTEM
383e0970
J
985extern struct frame *make_minibuffer_frame (void);
986extern struct frame *make_frame_without_minibuffer (Lisp_Object,
987 struct kboard *,
988 Lisp_Object);
c9e5d3d1 989#endif /* HAVE_WINDOW_SYSTEM */
7452b7bd
DA
990extern bool window_system_available (struct frame *);
991extern void check_window_system (struct frame *);
383e0970
J
992extern void frame_make_pointer_invisible (void);
993extern void frame_make_pointer_visible (void);
994extern Lisp_Object delete_frame (Lisp_Object, Lisp_Object);
efa4ce8b 995
ff11dfa1 996extern Lisp_Object Vframe_list;
650afd94
GM
997
998/* Value is a pointer to the selected frame. If the selected frame
b975254e 999 isn't live, abort. */
650afd94
GM
1000
1001#define SELECTED_FRAME() \
1002 ((FRAMEP (selected_frame) \
1003 && FRAME_LIVE_P (XFRAME (selected_frame))) \
1004 ? XFRAME (selected_frame) \
1088b922 1005 : (emacs_abort (), (struct frame *) 0))
3b83d631
GM
1006
1007\f
1008/***********************************************************************
1009 Display-related Macros
1010 ***********************************************************************/
1011
d3378f02 1012/* Canonical y-unit on frame F.
b45afe99
KS
1013 This value currently equals the line height of the frame (which is
1014 the height of the default font of F). */
1015
1016#define FRAME_LINE_HEIGHT(F) ((F)->line_height)
3b83d631 1017
d3378f02 1018/* Canonical x-unit on frame F.
0fc63cc4 1019 This value currently equals the average width of the default font of F. */
3b83d631 1020
b45afe99 1021#define FRAME_COLUMN_WIDTH(F) ((F)->column_width)
3b83d631 1022
3b83d631 1023/* Pixel width of areas used to display truncation marks, continuation
5cb26370 1024 marks, overlay arrows. This is 0 for terminal frames. */
3b83d631
GM
1025
1026#ifdef HAVE_WINDOW_SYSTEM
aa5b8e15 1027
b45afe99
KS
1028/* Total width of fringes reserved for drawing truncation bitmaps,
1029 continuation bitmaps and alike. The width is in canonical char
1030 units of the frame. This must currently be the case because window
1031 sizes aren't pixel values. If it weren't the case, we wouldn't be
1032 able to split windows horizontally nicely. */
1033
1034#define FRAME_FRINGE_COLS(F) ((F)->fringe_cols)
1035
1036/* Pixel-width of the left and right fringe. */
1037
1038#define FRAME_LEFT_FRINGE_WIDTH(F) ((F)->left_fringe_width)
1039#define FRAME_RIGHT_FRINGE_WIDTH(F) ((F)->right_fringe_width)
1040
1041/* Total width of fringes in pixels. */
1042
1043#define FRAME_TOTAL_FRINGE_WIDTH(F) \
1044 (FRAME_LEFT_FRINGE_WIDTH (F) + FRAME_RIGHT_FRINGE_WIDTH (F))
1045
b45afe99 1046/* Pixel-width of internal border lines */
b45afe99 1047#define FRAME_INTERNAL_BORDER_WIDTH(F) ((F)->internal_border_width)
177c0ea7 1048
880e6158
MR
1049/* Pixel-size of window border lines */
1050#define FRAME_RIGHT_DIVIDER_WIDTH(F) ((F)->right_divider_width)
1051#define FRAME_BOTTOM_DIVIDER_WIDTH(F) ((F)->bottom_divider_width)
1052
aa5b8e15
GM
1053#else /* not HAVE_WINDOW_SYSTEM */
1054
986f10ad 1055#define FRAME_FRINGE_COLS(F) 0
b45afe99 1056#define FRAME_TOTAL_FRINGE_WIDTH(F) 0
986f10ad 1057#define FRAME_LEFT_FRINGE_WIDTH(F) 0
8432bb78 1058#define FRAME_RIGHT_FRINGE_WIDTH(F) 0
b45afe99 1059#define FRAME_INTERNAL_BORDER_WIDTH(F) 0
880e6158
MR
1060#define FRAME_RIGHT_DIVIDER_WIDTH(F) 0
1061#define FRAME_BOTTOM_DIVIDER_WIDTH(F) 0
aa5b8e15
GM
1062
1063#endif /* not HAVE_WINDOW_SYSTEM */
3b83d631
GM
1064\f
1065/***********************************************************************
1066 Conversion between canonical units and pixels
1067 ***********************************************************************/
1068
b45afe99
KS
1069/* Canonical x-values are fractions of FRAME_COLUMN_WIDTH, canonical
1070 y-unit are fractions of FRAME_LINE_HEIGHT of a frame. Both are
1071 represented as Lisp numbers, i.e. integers or floats. */
3b83d631
GM
1072
1073/* Convert canonical value X to pixels. F is the frame whose
1074 canonical char width is to be used. X must be a Lisp integer or
1075 float. Value is a C integer. */
177c0ea7 1076
b45afe99 1077#define FRAME_PIXEL_X_FROM_CANON_X(F, X) \
021f2e1a
AS
1078 (INTEGERP (X) \
1079 ? XINT (X) * FRAME_COLUMN_WIDTH (F) \
1080 : (int) (XFLOAT_DATA (X) * FRAME_COLUMN_WIDTH (F)))
177c0ea7 1081
3b83d631
GM
1082/* Convert canonical value Y to pixels. F is the frame whose
1083 canonical character height is to be used. X must be a Lisp integer
1084 or float. Value is a C integer. */
177c0ea7 1085
b45afe99 1086#define FRAME_PIXEL_Y_FROM_CANON_Y(F, Y) \
021f2e1a
AS
1087 (INTEGERP (Y) \
1088 ? XINT (Y) * FRAME_LINE_HEIGHT (F) \
1089 : (int) (XFLOAT_DATA (Y) * FRAME_LINE_HEIGHT (F)))
3b83d631
GM
1090
1091/* Convert pixel-value X to canonical units. F is the frame whose
1092 canonical character width is to be used. X is a C integer. Result
1093 is a Lisp float if X is not a multiple of the canon width,
1094 otherwise it's a Lisp integer. */
1095
b45afe99 1096#define FRAME_CANON_X_FROM_PIXEL_X(F, X) \
021f2e1a
AS
1097 ((X) % FRAME_COLUMN_WIDTH (F) != 0 \
1098 ? make_float ((double) (X) / FRAME_COLUMN_WIDTH (F)) \
1099 : make_number ((X) / FRAME_COLUMN_WIDTH (F)))
3b83d631
GM
1100
1101/* Convert pixel-value Y to canonical units. F is the frame whose
1102 canonical character height is to be used. Y is a C integer.
1103 Result is a Lisp float if Y is not a multiple of the canon width,
1104 otherwise it's a Lisp integer. */
1105
b45afe99 1106#define FRAME_CANON_Y_FROM_PIXEL_Y(F, Y) \
021f2e1a
AS
1107 ((Y) % FRAME_LINE_HEIGHT (F) \
1108 ? make_float ((double) (Y) / FRAME_LINE_HEIGHT (F)) \
1109 : make_number ((Y) / FRAME_LINE_HEIGHT (F)))
b45afe99
KS
1110
1111
1112\f
1113/* Manipulating pixel sizes and character sizes.
1114 Knowledge of which factors affect the overall size of the window should
1115 be hidden in these macros, if that's possible.
1116
1117 Return the upper/left pixel position of the character cell on frame F
1118 at ROW/COL. */
1119
880e6158 1120#define FRAME_LINE_TO_PIXEL_Y(f, row) \
16009a0e 1121 (((row) < FRAME_TOP_MARGIN (f) ? 0 : FRAME_INTERNAL_BORDER_WIDTH (f)) \
b45afe99
KS
1122 + (row) * FRAME_LINE_HEIGHT (f))
1123
880e6158
MR
1124#define FRAME_COL_TO_PIXEL_X(f, col) \
1125 (FRAME_INTERNAL_BORDER_WIDTH (f) \
b45afe99
KS
1126 + (col) * FRAME_COLUMN_WIDTH (f))
1127
1128/* Return the pixel width/height of frame F if it has
1129 COLS columns/LINES rows. */
1130
1131#define FRAME_TEXT_COLS_TO_PIXEL_WIDTH(f, cols) \
880e6158
MR
1132 (FRAME_COL_TO_PIXEL_X (f, cols) \
1133 + FRAME_SCROLL_BAR_AREA_WIDTH (f) \
1134 + FRAME_TOTAL_FRINGE_WIDTH (f) \
b45afe99
KS
1135 + FRAME_INTERNAL_BORDER_WIDTH (f))
1136
1137#define FRAME_TEXT_LINES_TO_PIXEL_HEIGHT(f, lines) \
880e6158 1138 ((lines) * FRAME_LINE_HEIGHT (f) \
f016f225 1139 + 2 * FRAME_INTERNAL_BORDER_WIDTH (f))
b45afe99 1140
b45afe99
KS
1141/* Return the row/column (zero-based) of the character cell containing
1142 the pixel on FRAME at Y/X. */
1143
880e6158
MR
1144#define FRAME_PIXEL_Y_TO_LINE(f, y) \
1145 (((y) < FRAME_TOP_MARGIN_HEIGHT (f) \
1146 ? (y) \
4b00d3b1
YM
1147 : ((y) < FRAME_TOP_MARGIN_HEIGHT (f) + FRAME_INTERNAL_BORDER_WIDTH (f) \
1148 ? (y) - (FRAME_TOP_MARGIN_HEIGHT (f) + FRAME_INTERNAL_BORDER_WIDTH (f) \
880e6158
MR
1149 /* Arrange for the division to round down. */ \
1150 + FRAME_LINE_HEIGHT (f) - 1) \
1151 : (y) - FRAME_INTERNAL_BORDER_WIDTH (f))) \
b45afe99
KS
1152 / FRAME_LINE_HEIGHT (f))
1153
880e6158 1154#define FRAME_PIXEL_X_TO_COL(f, x) \
b45afe99
KS
1155 (((x) - FRAME_INTERNAL_BORDER_WIDTH (f)) \
1156 / FRAME_COLUMN_WIDTH (f))
1157
1158/* How many columns/rows of text can we fit in WIDTH/HEIGHT pixels on
1159 frame F? */
1160
880e6158
MR
1161#define FRAME_PIXEL_WIDTH_TO_TEXT_COLS(f, width) \
1162 (FRAME_PIXEL_X_TO_COL (f, ((width) \
1163 - FRAME_INTERNAL_BORDER_WIDTH (f) \
1164 - FRAME_TOTAL_FRINGE_WIDTH (f) \
1165 - FRAME_SCROLL_BAR_AREA_WIDTH (f)))) \
b45afe99 1166
880e6158
MR
1167#define FRAME_PIXEL_HEIGHT_TO_TEXT_LINES(f, height) \
1168 (FRAME_PIXEL_Y_TO_LINE (f, ((height) \
b45afe99 1169 - FRAME_INTERNAL_BORDER_WIDTH (f))))
177c0ea7 1170
880e6158 1171/* Return the pixel width/height of frame F with a text size of
f224e500 1172 width/height. */
880e6158
MR
1173
1174#define FRAME_TEXT_TO_PIXEL_WIDTH(f, width) \
1175 ((width) \
1176 + FRAME_SCROLL_BAR_AREA_WIDTH (f) \
1177 + FRAME_TOTAL_FRINGE_WIDTH (f) \
1178 + 2 * FRAME_INTERNAL_BORDER_WIDTH (f))
1179
1180#define FRAME_TEXT_TO_PIXEL_HEIGHT(f, height) \
1181 ((height) + 2 * FRAME_INTERNAL_BORDER_WIDTH (f))
1182
1183/* Return the text width/height of frame F with a pixel size of
f224e500 1184 width/height. */
880e6158
MR
1185
1186#define FRAME_PIXEL_TO_TEXT_WIDTH(f, width) \
1187 ((width) \
1188 - FRAME_SCROLL_BAR_AREA_WIDTH (f) \
1189 - FRAME_TOTAL_FRINGE_WIDTH (f) \
1190 - 2 * FRAME_INTERNAL_BORDER_WIDTH (f))
1191
1192#define FRAME_PIXEL_TO_TEXT_HEIGHT(f, height) \
1193 ((height) - 2 * FRAME_INTERNAL_BORDER_WIDTH (f))
1194
c7cc32f7
DA
1195/* Value is the smallest width of any character in any font on frame F. */
1196
1197#define FRAME_SMALLEST_CHAR_WIDTH(f) \
1198 FRAME_DISPLAY_INFO (f)->smallest_char_width
1199
1200/* Value is the smallest height of any font on frame F. */
1201
1202#define FRAME_SMALLEST_FONT_HEIGHT(f) \
1203 FRAME_DISPLAY_INFO (f)->smallest_font_height
5e02ce11
KS
1204
1205/***********************************************************************
1206 Frame Parameters
1207 ***********************************************************************/
1208
1209extern Lisp_Object Qauto_raise, Qauto_lower;
1210extern Lisp_Object Qborder_color, Qborder_width;
955cbe7b 1211extern Lisp_Object Qbuffer_predicate;
5e02ce11
KS
1212extern Lisp_Object Qcursor_color, Qcursor_type;
1213extern Lisp_Object Qfont;
1214extern Lisp_Object Qbackground_color, Qforeground_color;
1215extern Lisp_Object Qicon, Qicon_name, Qicon_type, Qicon_left, Qicon_top;
1216extern Lisp_Object Qinternal_border_width;
880e6158 1217extern Lisp_Object Qright_divider_width, Qbottom_divider_width;
99f3388e 1218extern Lisp_Object Qtooltip;
2b4e6277 1219extern Lisp_Object Qmenu_bar_lines, Qtool_bar_lines, Qtool_bar_position;
5e02ce11
KS
1220extern Lisp_Object Qmouse_color;
1221extern Lisp_Object Qname, Qtitle;
1222extern Lisp_Object Qparent_id;
1223extern Lisp_Object Qunsplittable, Qvisibility;
1224extern Lisp_Object Qscroll_bar_width, Qvertical_scroll_bars;
1225extern Lisp_Object Qscroll_bar_foreground, Qscroll_bar_background;
1226extern Lisp_Object Qscreen_gamma;
1227extern Lisp_Object Qline_spacing;
1228extern Lisp_Object Qwait_for_wm;
1229extern Lisp_Object Qfullscreen;
3f1c6666 1230extern Lisp_Object Qfullwidth, Qfullheight, Qfullboth, Qmaximized;
acd51077 1231extern Lisp_Object Qsticky;
1a8a83b2 1232extern Lisp_Object Qfont_backend;
50a73869 1233extern Lisp_Object Qalpha;
5e02ce11
KS
1234
1235extern Lisp_Object Qleft_fringe, Qright_fringe;
1236extern Lisp_Object Qheight, Qwidth;
1237extern Lisp_Object Qminibuffer, Qmodeline;
4b298d5a 1238extern Lisp_Object Qx, Qw32, Qpc, Qns;
5e02ce11
KS
1239extern Lisp_Object Qvisible;
1240extern Lisp_Object Qdisplay_type;
5e02ce11
KS
1241
1242extern Lisp_Object Qx_resource_name;
1243
bfeabdc3 1244extern Lisp_Object Qleft, Qright, Qtop, Qbox, Qbottom;
5e02ce11
KS
1245extern Lisp_Object Qdisplay;
1246
99f3388e
DN
1247extern Lisp_Object Qrun_hook_with_args;
1248
5e02ce11
KS
1249#ifdef HAVE_WINDOW_SYSTEM
1250
1251/* The class of this X application. */
1252#define EMACS_CLASS "Emacs"
1253
5e02ce11
KS
1254/* These are in xterm.c, w32term.c, etc. */
1255
383e0970
J
1256extern void x_set_scroll_bar_default_width (struct frame *);
1257extern void x_set_offset (struct frame *, int, int, int);
a10c8269 1258extern void x_wm_set_size_hint (struct frame *f, long flags, bool user_position);
5e02ce11 1259
383e0970 1260extern Lisp_Object x_new_font (struct frame *, Lisp_Object, int);
5e02ce11 1261
5e02ce11
KS
1262
1263extern Lisp_Object Qface_set_after_frame_default;
1264
0fda9b75 1265#ifdef HAVE_NTGUI
383e0970
J
1266extern void x_fullscreen_adjust (struct frame *f, int *, int *,
1267 int *, int *);
81626931 1268#endif
383e0970
J
1269
1270extern void x_set_frame_parameters (struct frame *, Lisp_Object);
383e0970
J
1271
1272extern void x_set_fullscreen (struct frame *, Lisp_Object, Lisp_Object);
1273extern void x_set_line_spacing (struct frame *, Lisp_Object, Lisp_Object);
1274extern void x_set_screen_gamma (struct frame *, Lisp_Object, Lisp_Object);
1275extern void x_set_font (struct frame *, Lisp_Object, Lisp_Object);
1276extern void x_set_font_backend (struct frame *, Lisp_Object, Lisp_Object);
1277extern void x_set_fringe_width (struct frame *, Lisp_Object, Lisp_Object);
1278extern void x_set_border_width (struct frame *, Lisp_Object, Lisp_Object);
1279extern void x_set_internal_border_width (struct frame *, Lisp_Object,
1280 Lisp_Object);
880e6158
MR
1281extern void x_set_right_divider_width (struct frame *, Lisp_Object,
1282 Lisp_Object);
1283extern void x_set_bottom_divider_width (struct frame *, Lisp_Object,
1284 Lisp_Object);
383e0970
J
1285extern void x_set_visibility (struct frame *, Lisp_Object, Lisp_Object);
1286extern void x_set_autoraise (struct frame *, Lisp_Object, Lisp_Object);
1287extern void x_set_autolower (struct frame *, Lisp_Object, Lisp_Object);
1288extern void x_set_unsplittable (struct frame *, Lisp_Object, Lisp_Object);
1289extern void x_set_vertical_scroll_bars (struct frame *, Lisp_Object,
1290 Lisp_Object);
1291extern void x_set_scroll_bar_width (struct frame *, Lisp_Object,
1292 Lisp_Object);
1293
959067a1 1294extern long x_figure_window_size (struct frame *, Lisp_Object, bool);
5e02ce11 1295
383e0970 1296extern void x_set_alpha (struct frame *, Lisp_Object, Lisp_Object);
5e02ce11 1297
383e0970 1298extern void validate_x_resource_name (void);
0ff162fc 1299
facfbbbd
SM
1300extern Lisp_Object display_x_get_resource (Display_Info *,
1301 Lisp_Object attribute,
1302 Lisp_Object class,
1303 Lisp_Object component,
1304 Lisp_Object subclass);
1305
18e27ea8 1306extern void set_frame_menubar (struct frame *f, bool first_time, bool deep_p);
17a2cbbd 1307extern void x_set_window_size (struct frame *f, int change_grav,
880e6158 1308 int width, int height, bool pixelwise);
17a2cbbd
DC
1309extern Lisp_Object x_get_focus_frame (struct frame *);
1310extern void x_set_mouse_position (struct frame *f, int h, int v);
1311extern void x_set_mouse_pixel_position (struct frame *f, int pix_x, int pix_y);
1312extern void x_make_frame_visible (struct frame *f);
1313extern void x_make_frame_invisible (struct frame *f);
1314extern void x_iconify_frame (struct frame *f);
17a2cbbd
DC
1315extern void x_set_frame_alpha (struct frame *f);
1316extern void x_set_menu_bar_lines (struct frame *, Lisp_Object, Lisp_Object);
880e6158 1317extern void x_set_tool_bar_lines (struct frame *, Lisp_Object, Lisp_Object);
17a2cbbd
DC
1318extern void x_activate_menubar (struct frame *);
1319extern void x_real_positions (struct frame *, int *, int *);
17a2cbbd
DC
1320extern void free_frame_menubar (struct frame *);
1321extern void x_free_frame_resources (struct frame *);
1322
52b8a085
DA
1323#if defined HAVE_X_WINDOWS
1324extern void x_wm_set_icon_position (struct frame *, int, int);
1325#if !defined USE_X_TOOLKIT
018c5e19
PE
1326extern char *x_get_resource_string (const char *, const char *);
1327#endif
83fc0554
DA
1328extern void x_sync (struct frame *);
1329#endif /* HAVE_X_WINDOWS */
018c5e19 1330
17a2cbbd 1331extern void x_query_colors (struct frame *f, XColor *, int);
0fda9b75 1332extern void x_query_color (struct frame *f, XColor *);
fcd42c11 1333extern void x_focus_frame (struct frame *);
17a2cbbd 1334
2cd98812
DA
1335#ifndef HAVE_NS
1336
1337extern int x_bitmap_icon (struct frame *, Lisp_Object);
1338
1339/* Set F's bitmap icon, if specified among F's parameters. */
1340
00382e8b 1341INLINE void
2cd98812
DA
1342x_set_bitmap_icon (struct frame *f)
1343{
1344 Lisp_Object obj = assq_no_quit (Qicon_type, f->param_alist);
1345
1346 if (CONSP (obj))
1347 x_bitmap_icon (f, XCDR (obj));
1348}
1349
1350#endif /* !HAVE_NS */
1351
5e02ce11 1352#endif /* HAVE_WINDOW_SYSTEM */
fd462129 1353
00382e8b 1354INLINE void
fd462129
DA
1355flush_frame (struct frame *f)
1356{
1357 struct redisplay_interface *rif = FRAME_RIF (f);
1358
1359 if (rif && rif->flush_display)
1360 rif->flush_display (f);
1361}
1362
6799bb26
JD
1363/***********************************************************************
1364 Multimonitor data
1365 ***********************************************************************/
1366
1367#ifdef HAVE_WINDOW_SYSTEM
1368
1369struct MonitorInfo {
1370 XRectangle geom, work;
1371 int mm_width, mm_height;
1372 char *name;
1373};
1374
1375extern void free_monitors (struct MonitorInfo *monitors, int n_monitors);
1376extern Lisp_Object make_monitor_attribute_list (struct MonitorInfo *monitors,
1377 int n_monitors,
1378 int primary_monitor,
1379 Lisp_Object monitor_frames,
1380 const char *source);
1381
1382#endif /* HAVE_WINDOW_SYSTEM */
1383
5e02ce11 1384
f00af5b1
PE
1385INLINE_HEADER_END
1386
84e01749 1387#endif /* not EMACS_FRAME_H */