Fix file-attributes race on GNU hosts
[emacs.git] / src / frame.c
blob5099f75be4d9d6e1d6b7dcebe86f462f1d474820
1 /* Generic frame functions.
3 Copyright (C) 1993-1995, 1997, 1999-2017 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software: you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation, either version 3 of the License, or (at
10 your option) any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
20 #include <config.h>
22 #include <stdio.h>
23 #include <stdlib.h>
24 #include <errno.h>
25 #include <limits.h>
27 #include <c-ctype.h>
29 #include "lisp.h"
31 #ifdef HAVE_WINDOW_SYSTEM
32 #include TERM_HEADER
33 #endif /* HAVE_WINDOW_SYSTEM */
35 #include "buffer.h"
36 /* These help us bind and responding to switch-frame events. */
37 #include "keyboard.h"
38 #include "frame.h"
39 #include "blockinput.h"
40 #include "termchar.h"
41 #include "termhooks.h"
42 #include "dispextern.h"
43 #include "window.h"
44 #ifdef HAVE_WINDOW_SYSTEM
45 #include "fontset.h"
46 #endif
47 #include "cm.h"
48 #ifdef MSDOS
49 #include "msdos.h"
50 #include "dosfns.h"
51 #endif
52 #ifdef USE_X_TOOLKIT
53 #include "widget.h"
54 #endif
56 /* The currently selected frame. */
58 Lisp_Object selected_frame;
60 /* A frame which is not just a mini-buffer, or NULL if there are no such
61 frames. This is usually the most recent such frame that was selected. */
63 static struct frame *last_nonminibuf_frame;
65 /* False means there are no visible garbaged frames. */
66 bool frame_garbaged;
68 /* The default tool bar height for future frames. */
69 #if defined USE_GTK || defined HAVE_NS
70 enum { frame_default_tool_bar_height = 0 };
71 #else
72 int frame_default_tool_bar_height;
73 #endif
75 #ifdef HAVE_WINDOW_SYSTEM
76 static void x_report_frame_params (struct frame *, Lisp_Object *);
77 #endif
79 /* These setters are used only in this file, so they can be private. */
80 static void
81 fset_buffer_predicate (struct frame *f, Lisp_Object val)
83 f->buffer_predicate = val;
85 static void
86 fset_minibuffer_window (struct frame *f, Lisp_Object val)
88 f->minibuffer_window = val;
91 struct frame *
92 decode_live_frame (register Lisp_Object frame)
94 if (NILP (frame))
95 frame = selected_frame;
96 CHECK_LIVE_FRAME (frame);
97 return XFRAME (frame);
100 struct frame *
101 decode_any_frame (register Lisp_Object frame)
103 if (NILP (frame))
104 frame = selected_frame;
105 CHECK_FRAME (frame);
106 return XFRAME (frame);
109 #ifdef HAVE_WINDOW_SYSTEM
110 bool
111 display_available (void)
113 return x_display_list != NULL;
115 #endif
117 struct frame *
118 decode_window_system_frame (Lisp_Object frame)
120 struct frame *f = decode_live_frame (frame);
121 check_window_system (f);
122 #ifdef HAVE_WINDOW_SYSTEM
123 return f;
124 #endif
127 void
128 check_window_system (struct frame *f)
130 #ifdef HAVE_WINDOW_SYSTEM
131 if (window_system_available (f))
132 return;
133 #endif
134 error (f ? "Window system frame should be used"
135 : "Window system is not in use or not initialized");
138 /* Return the value of frame parameter PROP in frame FRAME. */
140 Lisp_Object
141 get_frame_param (register struct frame *frame, Lisp_Object prop)
143 register Lisp_Object tem;
145 tem = Fassq (prop, frame->param_alist);
146 if (EQ (tem, Qnil))
147 return tem;
148 return Fcdr (tem);
152 void
153 frame_size_history_add (struct frame *f, Lisp_Object fun_symbol,
154 int width, int height, Lisp_Object rest)
156 Lisp_Object frame;
158 XSETFRAME (frame, f);
159 if (CONSP (frame_size_history)
160 && INTEGERP (XCAR (frame_size_history))
161 && 0 < XINT (XCAR (frame_size_history)))
162 frame_size_history =
163 Fcons (make_number (XINT (XCAR (frame_size_history)) - 1),
164 Fcons (list4
165 (frame, fun_symbol,
166 ((width > 0)
167 ? list4 (make_number (FRAME_TEXT_WIDTH (f)),
168 make_number (FRAME_TEXT_HEIGHT (f)),
169 make_number (width),
170 make_number (height))
171 : Qnil),
172 rest),
173 XCDR (frame_size_history)));
177 /* Return 1 if `frame-inhibit-implied-resize' is non-nil or fullscreen
178 state of frame F would be affected by a vertical (horizontal if
179 HORIZONTAL is true) resize. PARAMETER is the symbol of the frame
180 parameter that is changed. */
181 bool
182 frame_inhibit_resize (struct frame *f, bool horizontal, Lisp_Object parameter)
184 Lisp_Object fullscreen = get_frame_param (f, Qfullscreen);
185 bool inhibit
186 = (f->after_make_frame
187 ? (EQ (frame_inhibit_implied_resize, Qt)
188 || (CONSP (frame_inhibit_implied_resize)
189 && !NILP (Fmemq (parameter, frame_inhibit_implied_resize)))
190 || (horizontal
191 && !EQ (fullscreen, Qnil) && !EQ (fullscreen, Qfullheight))
192 || (!horizontal
193 && !EQ (fullscreen, Qnil) && !EQ (fullscreen, Qfullwidth))
194 || FRAME_TERMCAP_P (f) || FRAME_MSDOS_P (f))
195 : ((horizontal && f->inhibit_horizontal_resize)
196 || (!horizontal && f->inhibit_vertical_resize)));
197 if (inhibit && !FRAME_TERMCAP_P (f) && !FRAME_MSDOS_P (f))
198 frame_size_history_add
199 (f, Qframe_inhibit_resize, 0, 0,
200 list5 (horizontal ? Qt : Qnil, parameter,
201 f->after_make_frame ? Qt : Qnil,
202 frame_inhibit_implied_resize,
203 fullscreen));
205 return inhibit;
208 static void
209 set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
211 int nlines;
212 int olines = FRAME_MENU_BAR_LINES (f);
214 /* Right now, menu bars don't work properly in minibuf-only frames;
215 most of the commands try to apply themselves to the minibuffer
216 frame itself, and get an error because you can't switch buffers
217 in or split the minibuffer window. */
218 if (FRAME_MINIBUF_ONLY_P (f))
219 return;
221 if (TYPE_RANGED_INTEGERP (int, value))
222 nlines = XINT (value);
223 else
224 nlines = 0;
226 if (nlines != olines)
228 windows_or_buffers_changed = 14;
229 FRAME_MENU_BAR_LINES (f) = nlines;
230 FRAME_MENU_BAR_HEIGHT (f) = nlines * FRAME_LINE_HEIGHT (f);
231 change_frame_size (f, FRAME_COLS (f),
232 FRAME_LINES (f) + olines - nlines,
233 0, 1, 0, 0);
237 Lisp_Object Vframe_list;
240 DEFUN ("framep", Fframep, Sframep, 1, 1, 0,
241 doc: /* Return non-nil if OBJECT is a frame.
242 Value is:
243 t for a termcap frame (a character-only terminal),
244 `x' for an Emacs frame that is really an X window,
245 `w32' for an Emacs frame that is a window on MS-Windows display,
246 `ns' for an Emacs frame on a GNUstep or Macintosh Cocoa display,
247 `pc' for a direct-write MS-DOS frame.
248 See also `frame-live-p'. */)
249 (Lisp_Object object)
251 if (!FRAMEP (object))
252 return Qnil;
253 switch (XFRAME (object)->output_method)
255 case output_initial: /* The initial frame is like a termcap frame. */
256 case output_termcap:
257 return Qt;
258 case output_x_window:
259 return Qx;
260 case output_w32:
261 return Qw32;
262 case output_msdos_raw:
263 return Qpc;
264 case output_ns:
265 return Qns;
266 default:
267 emacs_abort ();
271 DEFUN ("frame-live-p", Fframe_live_p, Sframe_live_p, 1, 1, 0,
272 doc: /* Return non-nil if OBJECT is a frame which has not been deleted.
273 Value is nil if OBJECT is not a live frame. If object is a live
274 frame, the return value indicates what sort of terminal device it is
275 displayed on. See the documentation of `framep' for possible
276 return values. */)
277 (Lisp_Object object)
279 return ((FRAMEP (object)
280 && FRAME_LIVE_P (XFRAME (object)))
281 ? Fframep (object)
282 : Qnil);
285 DEFUN ("window-system", Fwindow_system, Swindow_system, 0, 1, 0,
286 doc: /* The name of the window system that FRAME is displaying through.
287 The value is a symbol:
288 nil for a termcap frame (a character-only terminal),
289 `x' for an Emacs frame that is really an X window,
290 `w32' for an Emacs frame that is a window on MS-Windows display,
291 `ns' for an Emacs frame on a GNUstep or Macintosh Cocoa display,
292 `pc' for a direct-write MS-DOS frame.
294 FRAME defaults to the currently selected frame.
296 Use of this function as a predicate is deprecated. Instead,
297 use `display-graphic-p' or any of the other `display-*-p'
298 predicates which report frame's specific UI-related capabilities. */)
299 (Lisp_Object frame)
301 Lisp_Object type;
302 if (NILP (frame))
303 frame = selected_frame;
305 type = Fframep (frame);
307 if (NILP (type))
308 wrong_type_argument (Qframep, frame);
310 if (EQ (type, Qt))
311 return Qnil;
312 else
313 return type;
316 /* Placeholder used by temacs -nw before window.el is loaded. */
317 DEFUN ("frame-windows-min-size", Fframe_windows_min_size,
318 Sframe_windows_min_size, 4, 4, 0,
319 doc: /* */
320 attributes: const)
321 (Lisp_Object frame, Lisp_Object horizontal,
322 Lisp_Object ignore, Lisp_Object pixelwise)
324 return make_number (0);
328 * frame_windows_min_size:
330 * Return the minimum number of lines (columns if HORIZONTAL is non-nil)
331 * of FRAME. If PIXELWISE is non-nil, return the minimum inner height
332 * (width) of FRAME in pixels.
334 * This value is calculated by the function `frame-windows-min-size' in
335 * window.el unless the `min-height' (`min-width' if HORIZONTAL is
336 * non-nil) parameter of FRAME is non-nil thus explicitly specifying the
337 * value to be returned. In that latter case IGNORE is ignored.
339 * If `frame-windows-min-size' is called, it will make sure that the
340 * return value accommodates all windows of FRAME respecting the values
341 * of `window-min-height' (`window-min-width' if HORIZONTAL is non-nil).
342 * With IGNORE non-nil the values of these variables are ignored.
344 * In either case, never return a value less than 1.
346 static int
347 frame_windows_min_size (Lisp_Object frame, Lisp_Object horizontal,
348 Lisp_Object ignore, Lisp_Object pixelwise)
350 struct frame *f = XFRAME (frame);
351 Lisp_Object par_size;
353 if ((!NILP (horizontal)
354 && NUMBERP (par_size = get_frame_param (f, Qmin_width)))
355 || (NILP (horizontal)
356 && NUMBERP (par_size = get_frame_param (f, Qmin_height))))
358 int min_size = XINT (par_size);
360 /* Don't allow phantom frames. */
361 if (min_size < 1)
362 min_size = 1;
364 return (NILP (pixelwise)
365 ? min_size
366 : min_size * (NILP (horizontal)
367 ? FRAME_LINE_HEIGHT (f)
368 : FRAME_COLUMN_WIDTH (f)));
370 else
371 return XINT (call4 (Qframe_windows_min_size, frame, horizontal,
372 ignore, pixelwise));
376 #ifdef HAVE_WINDOW_SYSTEM
378 * keep_ratio:
380 * Preserve ratios of frame F which usually happens after its parent
381 * frame P got resized. OLD_WIDTH, OLD_HEIGHT specifies the old native
382 * size of F's parent, NEW_WIDTH and NEW_HEIGHT its new size.
384 * Adjust F's width if F's 'keep_ratio' parameter is non-nil and, if
385 * it is a cons, its car is not 'height-only'. Adjust F's height if F's
386 * 'keep_ratio' parameter is non-nil and, if it is a cons, its car
387 * is not 'width-only'.
389 * Adjust F's left position if F's 'keep_ratio' parameter is non-nil
390 * and, if its is a cons, its cdr is non-nil and not 'top-only'. Adjust
391 * F's top position if F's 'keep_ratio' parameter is non-nil and, if
392 * its is a cons, its cdr is non-nil and not 'left-only'.
394 * Note that when positional adjustment is requested but the size of F
395 * should remain unaltered in the corresponding direction, this routine
396 * tries to constrain F to its parent frame - something which usually
397 * happens when the parent frame shrinks. This means, however, that
398 * when the parent frame is re-enlarged later, the child's original
399 * position will not get restored to its pre-shrinking value.
401 * This routine is currently useful for child frames only. It might be
402 * eventually useful when moving non-child frames between monitors with
403 * different resolutions.
405 static void
406 keep_ratio (struct frame *f, struct frame *p, int old_width, int old_height,
407 int new_width, int new_height)
409 Lisp_Object keep_ratio = get_frame_param (f, Qkeep_ratio);
412 if (!NILP (keep_ratio))
414 double width_factor = (double)new_width / (double)old_width;
415 double height_factor = (double)new_height / (double)old_height;
416 int pixel_width, pixel_height, pos_x, pos_y;
418 if (!CONSP (keep_ratio) || !NILP (Fcdr (keep_ratio)))
420 if (CONSP (keep_ratio) && EQ (Fcdr (keep_ratio), Qtop_only))
421 pos_x = f->left_pos;
422 else
424 pos_x = (int)(f->left_pos * width_factor + 0.5);
426 if (CONSP (keep_ratio)
427 && (NILP (Fcar (keep_ratio))
428 || EQ (Fcar (keep_ratio), Qheight_only))
429 && p->pixel_width - f->pixel_width < pos_x)
431 int p_f_width = p->pixel_width - f->pixel_width;
433 if (p_f_width <= 0)
434 pos_x = 0;
435 else
436 pos_x = (int)(p_f_width * width_factor * 0.5 + 0.5);
439 f->left_pos = pos_x;
442 if (CONSP (keep_ratio) && EQ (Fcdr (keep_ratio), Qleft_only))
443 pos_y = f->top_pos;
444 else
446 pos_y = (int)(f->top_pos * height_factor + 0.5);
448 if (CONSP (keep_ratio)
449 && (NILP (Fcar (keep_ratio))
450 || EQ (Fcar (keep_ratio), Qwidth_only))
451 && p->pixel_height - f->pixel_height < pos_y)
452 /* When positional adjustment was requested and the
453 width of F should remain unaltered, try to constrain
454 F to its parent. This means that when the parent
455 frame is enlarged later the child's original position
456 won't get restored. */
458 int p_f_height = p->pixel_height - f->pixel_height;
460 if (p_f_height <= 0)
461 pos_y = 0;
462 else
463 pos_y = (int)(p_f_height * height_factor * 0.5 + 0.5);
466 f->top_pos = pos_y;
469 x_set_offset (f, pos_x, pos_y, -1);
472 if (!CONSP (keep_ratio) || !NILP (Fcar (keep_ratio)))
474 if (CONSP (keep_ratio) && EQ (Fcar (keep_ratio), Qheight_only))
475 pixel_width = -1;
476 else
478 pixel_width = (int)(f->pixel_width * width_factor + 0.5);
479 pixel_width = FRAME_PIXEL_TO_TEXT_WIDTH (f, pixel_width);
482 if (CONSP (keep_ratio) && EQ (Fcar (keep_ratio), Qwidth_only))
483 pixel_height = -1;
484 else
486 pixel_height = (int)(f->pixel_height * height_factor + 0.5);
487 pixel_height = FRAME_PIXEL_TO_TEXT_HEIGHT (f, pixel_height);
490 adjust_frame_size (f, pixel_width, pixel_height, 1, 0,
491 Qkeep_ratio);
495 #endif
499 * adjust_frame_size:
501 * Adjust size of frame F. NEW_WIDTH and NEW_HEIGHT specify the new
502 * text size of F in pixels. A value of -1 means no change is requested
503 * for that direction (but the frame may still have to be resized to
504 * accommodate windows with their minimum sizes). This can either issue
505 * a request to resize the frame externally (via x_set_window_size), to
506 * resize the frame internally (via resize_frame_windows) or do nothing
507 * at all.
509 * The argument INHIBIT can assume the following values:
511 * 0 means to unconditionally call x_set_window_size even if sizes
512 * apparently do not change. Fx_create_frame uses this to pass the
513 * initial size to the window manager.
515 * 1 means to call x_set_window_size if the native frame size really
516 * changes. Fset_frame_size, Fset_frame_height, ... use this.
518 * 2 means to call x_set_window_size provided frame_inhibit_resize
519 * allows it. The menu and tool bar code use this ("3" won't work
520 * here in general because menu and tool bar are often not counted in
521 * the frame's text height).
523 * 3 means call x_set_window_size if window minimum sizes must be
524 * preserved or frame_inhibit_resize allows it. x_set_left_fringe,
525 * x_set_scroll_bar_width, x_new_font ... use (or should use) this.
527 * 4 means call x_set_window_size only if window minimum sizes must be
528 * preserved. x_set_right_divider_width, x_set_border_width and the
529 * code responsible for wrapping the tool bar use this.
531 * 5 means to never call x_set_window_size. change_frame_size uses
532 * this.
534 * Note that even when x_set_window_size is not called, individual
535 * windows may have to be resized (via `window--sanitize-window-sizes')
536 * in order to support minimum size constraints.
538 * PRETEND is as for change_frame_size. PARAMETER, if non-nil, is the
539 * symbol of the parameter changed (like `menu-bar-lines', `font', ...).
540 * This is passed on to frame_inhibit_resize to let the latter decide on
541 * a case-by-case basis whether the frame may be resized externally.
543 void
544 adjust_frame_size (struct frame *f, int new_width, int new_height, int inhibit,
545 bool pretend, Lisp_Object parameter)
547 int unit_width = FRAME_COLUMN_WIDTH (f);
548 int unit_height = FRAME_LINE_HEIGHT (f);
549 int old_pixel_width = FRAME_PIXEL_WIDTH (f);
550 int old_pixel_height = FRAME_PIXEL_HEIGHT (f);
551 int old_cols = FRAME_COLS (f);
552 int old_lines = FRAME_LINES (f);
553 int new_pixel_width, new_pixel_height;
554 /* The following two values are calculated from the old frame pixel
555 sizes and any "new" settings for tool bar, menu bar and internal
556 borders. We do it this way to detect whether we have to call
557 x_set_window_size as consequence of the new settings. */
558 int windows_width = FRAME_WINDOWS_WIDTH (f);
559 int windows_height = FRAME_WINDOWS_HEIGHT (f);
560 int min_windows_width, min_windows_height;
561 /* These are a bit tedious, maybe we should use a macro. */
562 struct window *r = XWINDOW (FRAME_ROOT_WINDOW (f));
563 int old_windows_width = WINDOW_PIXEL_WIDTH (r);
564 int old_windows_height
565 = (WINDOW_PIXEL_HEIGHT (r)
566 + ((FRAME_HAS_MINIBUF_P (f) && !FRAME_MINIBUF_ONLY_P (f))
567 ? WINDOW_PIXEL_HEIGHT (XWINDOW (FRAME_MINIBUF_WINDOW (f)))
568 : 0));
569 int new_windows_width, new_windows_height;
570 int old_text_width = FRAME_TEXT_WIDTH (f);
571 int old_text_height = FRAME_TEXT_HEIGHT (f);
572 /* If a size is < 0 use the old value. */
573 int new_text_width = (new_width >= 0) ? new_width : old_text_width;
574 int new_text_height = (new_height >= 0) ? new_height : old_text_height;
575 int new_cols, new_lines;
576 bool inhibit_horizontal, inhibit_vertical;
577 Lisp_Object frame;
579 XSETFRAME (frame, f);
581 frame_size_history_add
582 (f, Qadjust_frame_size_1, new_text_width, new_text_height,
583 list2 (parameter, make_number (inhibit)));
585 /* The following two values are calculated from the old window body
586 sizes and any "new" settings for scroll bars, dividers, fringes and
587 margins (though the latter should have been processed already). */
588 min_windows_width
589 = frame_windows_min_size (frame, Qt, (inhibit == 5) ? Qt : Qnil, Qt);
590 min_windows_height
591 = frame_windows_min_size (frame, Qnil, (inhibit == 5) ? Qt : Qnil, Qt);
593 if (inhibit >= 2 && inhibit <= 4)
594 /* When INHIBIT is in [2..4] inhibit if the "old" window sizes stay
595 within the limits and either resizing is inhibited or INHIBIT
596 equals 4. */
598 inhibit_horizontal = (windows_width >= min_windows_width
599 && (inhibit == 4
600 || frame_inhibit_resize (f, true, parameter)));
601 inhibit_vertical = (windows_height >= min_windows_height
602 && (inhibit == 4
603 || frame_inhibit_resize (f, false, parameter)));
605 else
606 /* Otherwise inhibit if INHIBIT equals 5. */
607 inhibit_horizontal = inhibit_vertical = inhibit == 5;
609 new_pixel_width = ((inhibit_horizontal && (inhibit < 5))
610 ? old_pixel_width
611 : max (FRAME_TEXT_TO_PIXEL_WIDTH (f, new_text_width),
612 min_windows_width
613 + 2 * FRAME_INTERNAL_BORDER_WIDTH (f)));
614 new_windows_width = new_pixel_width - 2 * FRAME_INTERNAL_BORDER_WIDTH (f);
615 new_text_width = FRAME_PIXEL_TO_TEXT_WIDTH (f, new_pixel_width);
616 new_cols = new_text_width / unit_width;
618 new_pixel_height = ((inhibit_vertical && (inhibit < 5))
619 ? old_pixel_height
620 : max (FRAME_TEXT_TO_PIXEL_HEIGHT (f, new_text_height),
621 min_windows_height
622 + FRAME_TOP_MARGIN_HEIGHT (f)
623 + 2 * FRAME_INTERNAL_BORDER_WIDTH (f)));
624 new_windows_height = (new_pixel_height
625 - FRAME_TOP_MARGIN_HEIGHT (f)
626 - 2 * FRAME_INTERNAL_BORDER_WIDTH (f));
627 new_text_height = FRAME_PIXEL_TO_TEXT_HEIGHT (f, new_pixel_height);
628 new_lines = new_text_height / unit_height;
630 #ifdef HAVE_WINDOW_SYSTEM
631 if (FRAME_WINDOW_P (f)
632 && f->can_x_set_window_size
633 && ((!inhibit_horizontal
634 && (new_pixel_width != old_pixel_width
635 || inhibit == 0 || inhibit == 2))
636 || (!inhibit_vertical
637 && (new_pixel_height != old_pixel_height
638 || inhibit == 0 || inhibit == 2))))
639 /* We are either allowed to change the frame size or the minimum
640 sizes request such a change. Do not care for fixing minimum
641 sizes here, we do that eventually when we're called from
642 change_frame_size. */
644 /* Make sure we respect fullheight and fullwidth. */
645 if (inhibit_horizontal)
646 new_text_width = old_text_width;
647 else if (inhibit_vertical)
648 new_text_height = old_text_height;
650 frame_size_history_add
651 (f, Qadjust_frame_size_2, new_text_width, new_text_height,
652 list2 (inhibit_horizontal ? Qt : Qnil,
653 inhibit_vertical ? Qt : Qnil));
655 x_set_window_size (f, 0, new_text_width, new_text_height, 1);
656 f->resized_p = true;
658 return;
660 #endif
662 if (new_text_width == old_text_width
663 && new_text_height == old_text_height
664 && new_windows_width == old_windows_width
665 && new_windows_height == old_windows_height
666 && new_pixel_width == old_pixel_width
667 && new_pixel_height == old_pixel_height
668 && new_cols == old_cols
669 && new_lines == old_lines)
670 /* No change. Sanitize window sizes and return. */
672 sanitize_window_sizes (Qt);
673 sanitize_window_sizes (Qnil);
675 return;
678 block_input ();
680 #ifdef MSDOS
681 /* We only can set screen dimensions to certain values supported by
682 our video hardware. Try to find the smallest size greater or
683 equal to the requested dimensions, while accounting for the fact
684 that the menu-bar lines are not counted in the frame height. */
685 int dos_new_lines = new_lines + FRAME_TOP_MARGIN (f);
686 dos_set_window_size (&dos_new_lines, &new_cols);
687 new_lines = dos_new_lines - FRAME_TOP_MARGIN (f);
688 #endif
690 if (new_windows_width != old_windows_width)
692 resize_frame_windows (f, new_windows_width, 1, 1);
694 /* MSDOS frames cannot PRETEND, as they change frame size by
695 manipulating video hardware. */
696 if ((FRAME_TERMCAP_P (f) && !pretend) || FRAME_MSDOS_P (f))
697 FrameCols (FRAME_TTY (f)) = new_cols;
699 #if defined (HAVE_WINDOW_SYSTEM) && ! defined (USE_GTK) && ! defined (HAVE_NS)
700 if (WINDOWP (f->tool_bar_window))
702 XWINDOW (f->tool_bar_window)->pixel_width = new_windows_width;
703 XWINDOW (f->tool_bar_window)->total_cols
704 = new_windows_width / unit_width;
706 #endif
708 else if (new_cols != old_cols)
709 call2 (Qwindow__pixel_to_total, frame, Qt);
711 if (new_windows_height != old_windows_height
712 /* When the top margin has changed we have to recalculate the top
713 edges of all windows. No such calculation is necessary for the
714 left edges. */
715 || WINDOW_TOP_PIXEL_EDGE (r) != FRAME_TOP_MARGIN_HEIGHT (f))
717 resize_frame_windows (f, new_windows_height, 0, 1);
719 /* MSDOS frames cannot PRETEND, as they change frame size by
720 manipulating video hardware. */
721 if ((FRAME_TERMCAP_P (f) && !pretend) || FRAME_MSDOS_P (f))
722 FrameRows (FRAME_TTY (f)) = new_lines + FRAME_TOP_MARGIN (f);
724 else if (new_lines != old_lines)
725 call2 (Qwindow__pixel_to_total, frame, Qnil);
727 frame_size_history_add
728 (f, Qadjust_frame_size_3, new_text_width, new_text_height,
729 list4 (make_number (old_pixel_width), make_number (old_pixel_height),
730 make_number (new_pixel_width), make_number (new_pixel_height)));
732 /* Assign new sizes. */
733 FRAME_TEXT_WIDTH (f) = new_text_width;
734 FRAME_TEXT_HEIGHT (f) = new_text_height;
735 FRAME_PIXEL_WIDTH (f) = new_pixel_width;
736 FRAME_PIXEL_HEIGHT (f) = new_pixel_height;
737 SET_FRAME_COLS (f, new_cols);
738 SET_FRAME_LINES (f, new_lines);
741 struct window *w = XWINDOW (FRAME_SELECTED_WINDOW (f));
742 int text_area_x, text_area_y, text_area_width, text_area_height;
744 window_box (w, TEXT_AREA, &text_area_x, &text_area_y, &text_area_width,
745 &text_area_height);
746 if (w->cursor.x >= text_area_x + text_area_width)
747 w->cursor.hpos = w->cursor.x = 0;
748 if (w->cursor.y >= text_area_y + text_area_height)
749 w->cursor.vpos = w->cursor.y = 0;
752 /* Sanitize window sizes. */
753 sanitize_window_sizes (Qt);
754 sanitize_window_sizes (Qnil);
756 adjust_frame_glyphs (f);
757 calculate_costs (f);
758 SET_FRAME_GARBAGED (f);
760 /* A frame was "resized" if one of its pixelsizes changed, even if its
761 X window wasn't resized at all. */
762 f->resized_p = (new_pixel_width != old_pixel_width
763 || new_pixel_height != old_pixel_height);
765 unblock_input ();
767 #ifdef HAVE_WINDOW_SYSTEM
769 /* Adjust size of F's child frames. */
770 Lisp_Object frames, frame1;
772 FOR_EACH_FRAME (frames, frame1)
773 if (FRAME_PARENT_FRAME (XFRAME (frame1)) == f)
774 keep_ratio (XFRAME (frame1), f, old_pixel_width, old_pixel_height,
775 new_pixel_width, new_pixel_height);
777 #endif
780 /* Allocate basically initialized frame. */
782 static struct frame *
783 allocate_frame (void)
785 return ALLOCATE_ZEROED_PSEUDOVECTOR (struct frame, face_cache, PVEC_FRAME);
788 struct frame *
789 make_frame (bool mini_p)
791 Lisp_Object frame;
792 struct frame *f;
793 struct window *rw, *mw UNINIT;
794 Lisp_Object root_window;
795 Lisp_Object mini_window;
797 f = allocate_frame ();
798 XSETFRAME (frame, f);
800 #ifdef USE_GTK
801 /* Initialize Lisp data. Note that allocate_frame initializes all
802 Lisp data to nil, so do it only for slots which should not be nil. */
803 fset_tool_bar_position (f, Qtop);
804 #endif
806 /* Initialize non-Lisp data. Note that allocate_frame zeroes out all
807 non-Lisp data, so do it only for slots which should not be zero.
808 To avoid subtle bugs and for the sake of readability, it's better to
809 initialize enum members explicitly even if their values are zero. */
810 f->wants_modeline = true;
811 f->redisplay = true;
812 f->garbaged = true;
813 f->can_x_set_window_size = false;
814 f->after_make_frame = false;
815 f->inhibit_horizontal_resize = false;
816 f->inhibit_vertical_resize = false;
817 f->tool_bar_redisplayed = false;
818 f->tool_bar_resized = false;
819 f->column_width = 1; /* !FRAME_WINDOW_P value. */
820 f->line_height = 1; /* !FRAME_WINDOW_P value. */
821 #ifdef HAVE_WINDOW_SYSTEM
822 f->vertical_scroll_bar_type = vertical_scroll_bar_none;
823 f->horizontal_scroll_bars = false;
824 f->want_fullscreen = FULLSCREEN_NONE;
825 f->undecorated = false;
826 f->no_special_glyphs = false;
827 #ifndef HAVE_NTGUI
828 f->override_redirect = false;
829 #endif
830 f->skip_taskbar = false;
831 f->no_focus_on_map = false;
832 f->no_accept_focus = false;
833 f->z_group = z_group_none;
834 #if ! defined (USE_GTK) && ! defined (HAVE_NS)
835 f->last_tool_bar_item = -1;
836 #endif
837 #ifdef NS_IMPL_COCOA
838 f->ns_appearance = ns_appearance_aqua;
839 f->ns_transparent_titlebar = false;
840 #endif
841 #endif
843 root_window = make_window ();
844 rw = XWINDOW (root_window);
845 if (mini_p)
847 mini_window = make_window ();
848 mw = XWINDOW (mini_window);
849 wset_next (rw, mini_window);
850 wset_prev (mw, root_window);
851 mw->mini = 1;
852 wset_frame (mw, frame);
853 fset_minibuffer_window (f, mini_window);
854 store_frame_param (f, Qminibuffer, Qt);
856 else
858 mini_window = Qnil;
859 wset_next (rw, Qnil);
860 fset_minibuffer_window (f, Qnil);
863 wset_frame (rw, frame);
865 /* 10 is arbitrary,
866 just so that there is "something there."
867 Correct size will be set up later with adjust_frame_size. */
869 SET_FRAME_COLS (f, 10);
870 SET_FRAME_LINES (f, 10);
871 SET_FRAME_WIDTH (f, FRAME_COLS (f) * FRAME_COLUMN_WIDTH (f));
872 SET_FRAME_HEIGHT (f, FRAME_LINES (f) * FRAME_LINE_HEIGHT (f));
874 rw->total_cols = 10;
875 rw->pixel_width = rw->total_cols * FRAME_COLUMN_WIDTH (f);
876 rw->total_lines = mini_p ? 9 : 10;
877 rw->pixel_height = rw->total_lines * FRAME_LINE_HEIGHT (f);
879 if (mini_p)
881 mw->top_line = rw->total_lines;
882 mw->pixel_top = rw->pixel_height;
883 mw->total_cols = rw->total_cols;
884 mw->pixel_width = rw->pixel_width;
885 mw->total_lines = 1;
886 mw->pixel_height = FRAME_LINE_HEIGHT (f);
889 /* Choose a buffer for the frame's root window. */
891 Lisp_Object buf = Fcurrent_buffer ();
893 /* If current buffer is hidden, try to find another one. */
894 if (BUFFER_HIDDEN_P (XBUFFER (buf)))
895 buf = other_buffer_safely (buf);
897 /* Use set_window_buffer, not Fset_window_buffer, and don't let
898 hooks be run by it. The reason is that the whole frame/window
899 arrangement is not yet fully initialized at this point. Windows
900 don't have the right size, glyph matrices aren't initialized
901 etc. Running Lisp functions at this point surely ends in a
902 SEGV. */
903 set_window_buffer (root_window, buf, 0, 0);
904 fset_buffer_list (f, list1 (buf));
907 if (mini_p)
909 set_window_buffer (mini_window,
910 (NILP (Vminibuffer_list)
911 ? get_minibuffer (0)
912 : Fcar (Vminibuffer_list)),
913 0, 0);
914 /* No horizontal scroll bars in minibuffers. */
915 wset_horizontal_scroll_bar (mw, Qnil);
918 fset_root_window (f, root_window);
919 fset_selected_window (f, root_window);
920 /* Make sure this window seems more recently used than
921 a newly-created, never-selected window. */
922 XWINDOW (f->selected_window)->use_time = ++window_select_count;
924 return f;
927 #ifdef HAVE_WINDOW_SYSTEM
928 /* Make a frame using a separate minibuffer window on another frame.
929 MINI_WINDOW is the minibuffer window to use. nil means use the
930 default (the global minibuffer). */
932 struct frame *
933 make_frame_without_minibuffer (Lisp_Object mini_window, KBOARD *kb,
934 Lisp_Object display)
936 struct frame *f;
938 if (!NILP (mini_window))
939 CHECK_LIVE_WINDOW (mini_window);
941 if (!NILP (mini_window)
942 && FRAME_KBOARD (XFRAME (XWINDOW (mini_window)->frame)) != kb)
943 error ("Frame and minibuffer must be on the same terminal");
945 /* Make a frame containing just a root window. */
946 f = make_frame (0);
948 if (NILP (mini_window))
950 /* Use default-minibuffer-frame if possible. */
951 if (!FRAMEP (KVAR (kb, Vdefault_minibuffer_frame))
952 || ! FRAME_LIVE_P (XFRAME (KVAR (kb, Vdefault_minibuffer_frame))))
954 Lisp_Object frame_dummy;
956 XSETFRAME (frame_dummy, f);
957 /* If there's no minibuffer frame to use, create one. */
958 kset_default_minibuffer_frame
959 (kb, call1 (intern ("make-initial-minibuffer-frame"), display));
962 mini_window
963 = XFRAME (KVAR (kb, Vdefault_minibuffer_frame))->minibuffer_window;
966 fset_minibuffer_window (f, mini_window);
967 store_frame_param (f, Qminibuffer, mini_window);
969 /* Make the chosen minibuffer window display the proper minibuffer,
970 unless it is already showing a minibuffer. */
971 if (NILP (Fmemq (XWINDOW (mini_window)->contents, Vminibuffer_list)))
972 /* Use set_window_buffer instead of Fset_window_buffer (see
973 discussion of bug#11984, bug#12025, bug#12026). */
974 set_window_buffer (mini_window,
975 (NILP (Vminibuffer_list)
976 ? get_minibuffer (0)
977 : Fcar (Vminibuffer_list)), 0, 0);
978 return f;
981 /* Make a frame containing only a minibuffer window. */
983 struct frame *
984 make_minibuffer_frame (void)
986 /* First make a frame containing just a root window, no minibuffer. */
988 register struct frame *f = make_frame (0);
989 register Lisp_Object mini_window;
990 register Lisp_Object frame;
992 XSETFRAME (frame, f);
994 f->auto_raise = 0;
995 f->auto_lower = 0;
996 f->no_split = 1;
997 f->wants_modeline = 0;
999 /* Now label the root window as also being the minibuffer.
1000 Avoid infinite looping on the window chain by marking next pointer
1001 as nil. */
1003 mini_window = f->root_window;
1004 fset_minibuffer_window (f, mini_window);
1005 store_frame_param (f, Qminibuffer, Qonly);
1006 XWINDOW (mini_window)->mini = 1;
1007 wset_next (XWINDOW (mini_window), Qnil);
1008 wset_prev (XWINDOW (mini_window), Qnil);
1009 wset_frame (XWINDOW (mini_window), frame);
1011 /* Put the proper buffer in that window. */
1013 /* Use set_window_buffer instead of Fset_window_buffer (see
1014 discussion of bug#11984, bug#12025, bug#12026). */
1015 set_window_buffer (mini_window,
1016 (NILP (Vminibuffer_list)
1017 ? get_minibuffer (0)
1018 : Fcar (Vminibuffer_list)), 0, 0);
1019 return f;
1021 #endif /* HAVE_WINDOW_SYSTEM */
1023 /* Construct a frame that refers to a terminal. */
1025 static printmax_t tty_frame_count;
1027 struct frame *
1028 make_initial_frame (void)
1030 struct frame *f;
1031 struct terminal *terminal;
1032 Lisp_Object frame;
1034 eassert (initial_kboard);
1036 /* The first call must initialize Vframe_list. */
1037 if (! (NILP (Vframe_list) || CONSP (Vframe_list)))
1038 Vframe_list = Qnil;
1040 terminal = init_initial_terminal ();
1042 f = make_frame (1);
1043 XSETFRAME (frame, f);
1045 Vframe_list = Fcons (frame, Vframe_list);
1047 tty_frame_count = 1;
1048 fset_name (f, build_pure_c_string ("F1"));
1050 SET_FRAME_VISIBLE (f, 1);
1052 f->output_method = terminal->type;
1053 f->terminal = terminal;
1054 f->terminal->reference_count++;
1055 f->output_data.nothing = 0;
1057 FRAME_FOREGROUND_PIXEL (f) = FACE_TTY_DEFAULT_FG_COLOR;
1058 FRAME_BACKGROUND_PIXEL (f) = FACE_TTY_DEFAULT_BG_COLOR;
1060 #ifdef HAVE_WINDOW_SYSTEM
1061 f->vertical_scroll_bar_type = vertical_scroll_bar_none;
1062 f->horizontal_scroll_bars = false;
1063 #endif
1065 /* The default value of menu-bar-mode is t. */
1066 set_menu_bar_lines (f, make_number (1), Qnil);
1068 /* Allocate glyph matrices. */
1069 adjust_frame_glyphs (f);
1071 if (!noninteractive)
1072 init_frame_faces (f);
1074 last_nonminibuf_frame = f;
1076 f->can_x_set_window_size = true;
1077 f->after_make_frame = true;
1079 return f;
1083 static struct frame *
1084 make_terminal_frame (struct terminal *terminal)
1086 register struct frame *f;
1087 Lisp_Object frame;
1088 char name[sizeof "F" + INT_STRLEN_BOUND (printmax_t)];
1090 if (!terminal->name)
1091 error ("Terminal is not live, can't create new frames on it");
1093 f = make_frame (1);
1095 XSETFRAME (frame, f);
1096 Vframe_list = Fcons (frame, Vframe_list);
1098 fset_name (f, make_formatted_string (name, "F%"pMd, ++tty_frame_count));
1100 SET_FRAME_VISIBLE (f, 1);
1102 f->terminal = terminal;
1103 f->terminal->reference_count++;
1104 #ifdef MSDOS
1105 f->output_data.tty->display_info = &the_only_display_info;
1106 if (!inhibit_window_system
1107 && (!FRAMEP (selected_frame) || !FRAME_LIVE_P (XFRAME (selected_frame))
1108 || XFRAME (selected_frame)->output_method == output_msdos_raw))
1109 f->output_method = output_msdos_raw;
1110 else
1111 f->output_method = output_termcap;
1112 #else /* not MSDOS */
1113 f->output_method = output_termcap;
1114 create_tty_output (f);
1115 FRAME_FOREGROUND_PIXEL (f) = FACE_TTY_DEFAULT_FG_COLOR;
1116 FRAME_BACKGROUND_PIXEL (f) = FACE_TTY_DEFAULT_BG_COLOR;
1117 #endif /* not MSDOS */
1119 #ifdef HAVE_WINDOW_SYSTEM
1120 f->vertical_scroll_bar_type = vertical_scroll_bar_none;
1121 f->horizontal_scroll_bars = false;
1122 #endif
1124 FRAME_MENU_BAR_LINES (f) = NILP (Vmenu_bar_mode) ? 0 : 1;
1125 FRAME_LINES (f) = FRAME_LINES (f) - FRAME_MENU_BAR_LINES (f);
1126 FRAME_MENU_BAR_HEIGHT (f) = FRAME_MENU_BAR_LINES (f) * FRAME_LINE_HEIGHT (f);
1127 FRAME_TEXT_HEIGHT (f) = FRAME_TEXT_HEIGHT (f) - FRAME_MENU_BAR_HEIGHT (f);
1129 /* Set the top frame to the newly created frame. */
1130 if (FRAMEP (FRAME_TTY (f)->top_frame)
1131 && FRAME_LIVE_P (XFRAME (FRAME_TTY (f)->top_frame)))
1132 SET_FRAME_VISIBLE (XFRAME (FRAME_TTY (f)->top_frame), 2); /* obscured */
1134 FRAME_TTY (f)->top_frame = frame;
1136 if (!noninteractive)
1137 init_frame_faces (f);
1139 return f;
1142 /* Get a suitable value for frame parameter PARAMETER for a newly
1143 created frame, based on (1) the user-supplied frame parameter
1144 alist SUPPLIED_PARMS, and (2) CURRENT_VALUE. */
1146 static Lisp_Object
1147 get_future_frame_param (Lisp_Object parameter,
1148 Lisp_Object supplied_parms,
1149 char *current_value)
1151 Lisp_Object result;
1153 result = Fassq (parameter, supplied_parms);
1154 if (NILP (result))
1155 result = Fassq (parameter, XFRAME (selected_frame)->param_alist);
1156 if (NILP (result) && current_value != NULL)
1157 result = build_string (current_value);
1158 if (!NILP (result) && !STRINGP (result))
1159 result = XCDR (result);
1160 if (NILP (result) || !STRINGP (result))
1161 result = Qnil;
1163 return result;
1166 DEFUN ("make-terminal-frame", Fmake_terminal_frame, Smake_terminal_frame,
1167 1, 1, 0,
1168 doc: /* Create an additional terminal frame, possibly on another terminal.
1169 This function takes one argument, an alist specifying frame parameters.
1171 You can create multiple frames on a single text terminal, but only one
1172 of them (the selected terminal frame) is actually displayed.
1174 In practice, generally you don't need to specify any parameters,
1175 except when you want to create a new frame on another terminal.
1176 In that case, the `tty' parameter specifies the device file to open,
1177 and the `tty-type' parameter specifies the terminal type. Example:
1179 (make-terminal-frame \\='((tty . "/dev/pts/5") (tty-type . "xterm")))
1181 Note that changing the size of one terminal frame automatically
1182 affects all frames on the same terminal device. */)
1183 (Lisp_Object parms)
1185 struct frame *f;
1186 struct terminal *t = NULL;
1187 Lisp_Object frame, tem;
1188 struct frame *sf = SELECTED_FRAME ();
1190 #ifdef MSDOS
1191 if (sf->output_method != output_msdos_raw
1192 && sf->output_method != output_termcap)
1193 emacs_abort ();
1194 #else /* not MSDOS */
1196 #ifdef WINDOWSNT /* This should work now! */
1197 if (sf->output_method != output_termcap)
1198 error ("Not using an ASCII terminal now; cannot make a new ASCII frame");
1199 #endif
1200 #endif /* not MSDOS */
1203 Lisp_Object terminal;
1205 terminal = Fassq (Qterminal, parms);
1206 if (CONSP (terminal))
1208 terminal = XCDR (terminal);
1209 t = decode_live_terminal (terminal);
1211 #ifdef MSDOS
1212 if (t && t != the_only_display_info.terminal)
1213 /* msdos.c assumes a single tty_display_info object. */
1214 error ("Multiple terminals are not supported on this platform");
1215 if (!t)
1216 t = the_only_display_info.terminal;
1217 #endif
1220 if (!t)
1222 char *name = 0, *type = 0;
1223 Lisp_Object tty, tty_type;
1224 USE_SAFE_ALLOCA;
1226 tty = get_future_frame_param
1227 (Qtty, parms, (FRAME_TERMCAP_P (XFRAME (selected_frame))
1228 ? FRAME_TTY (XFRAME (selected_frame))->name
1229 : NULL));
1230 if (!NILP (tty))
1231 SAFE_ALLOCA_STRING (name, tty);
1233 tty_type = get_future_frame_param
1234 (Qtty_type, parms, (FRAME_TERMCAP_P (XFRAME (selected_frame))
1235 ? FRAME_TTY (XFRAME (selected_frame))->type
1236 : NULL));
1237 if (!NILP (tty_type))
1238 SAFE_ALLOCA_STRING (type, tty_type);
1240 t = init_tty (name, type, 0); /* Errors are not fatal. */
1241 SAFE_FREE ();
1244 f = make_terminal_frame (t);
1247 int width, height;
1248 get_tty_size (fileno (FRAME_TTY (f)->input), &width, &height);
1249 adjust_frame_size (f, width, height - FRAME_MENU_BAR_LINES (f),
1250 5, 0, Qterminal_frame);
1253 adjust_frame_glyphs (f);
1254 calculate_costs (f);
1255 XSETFRAME (frame, f);
1257 store_in_alist (&parms, Qtty_type, build_string (t->display_info.tty->type));
1258 store_in_alist (&parms, Qtty,
1259 (t->display_info.tty->name
1260 ? build_string (t->display_info.tty->name)
1261 : Qnil));
1262 /* On terminal frames the `minibuffer' frame parameter is always
1263 virtually t. Avoid that a different value in parms causes
1264 complaints, see Bug#24758. */
1265 store_in_alist (&parms, Qminibuffer, Qt);
1266 Fmodify_frame_parameters (frame, parms);
1268 /* Make the frame face alist be frame-specific, so that each
1269 frame could change its face definitions independently. */
1270 fset_face_alist (f, Fcopy_alist (sf->face_alist));
1271 /* Simple Fcopy_alist isn't enough, because we need the contents of
1272 the vectors which are the CDRs of associations in face_alist to
1273 be copied as well. */
1274 for (tem = f->face_alist; CONSP (tem); tem = XCDR (tem))
1275 XSETCDR (XCAR (tem), Fcopy_sequence (XCDR (XCAR (tem))));
1277 f->can_x_set_window_size = true;
1278 f->after_make_frame = true;
1280 return frame;
1284 /* Perform the switch to frame FRAME.
1286 If FRAME is a switch-frame event `(switch-frame FRAME1)', use
1287 FRAME1 as frame.
1289 If TRACK is non-zero and the frame that currently has the focus
1290 redirects its focus to the selected frame, redirect that focused
1291 frame's focus to FRAME instead.
1293 FOR_DELETION non-zero means that the selected frame is being
1294 deleted, which includes the possibility that the frame's terminal
1295 is dead.
1297 The value of NORECORD is passed as argument to Fselect_window. */
1299 Lisp_Object
1300 do_switch_frame (Lisp_Object frame, int track, int for_deletion, Lisp_Object norecord)
1302 struct frame *sf = SELECTED_FRAME (), *f;
1304 /* If FRAME is a switch-frame event, extract the frame we should
1305 switch to. */
1306 if (CONSP (frame)
1307 && EQ (XCAR (frame), Qswitch_frame)
1308 && CONSP (XCDR (frame)))
1309 frame = XCAR (XCDR (frame));
1311 /* This used to say CHECK_LIVE_FRAME, but apparently it's possible for
1312 a switch-frame event to arrive after a frame is no longer live,
1313 especially when deleting the initial frame during startup. */
1314 CHECK_FRAME (frame);
1315 f = XFRAME (frame);
1316 if (!FRAME_LIVE_P (f))
1317 return Qnil;
1318 else if (f == sf)
1319 return frame;
1321 /* If a frame's focus has been redirected toward the currently
1322 selected frame, we should change the redirection to point to the
1323 newly selected frame. This means that if the focus is redirected
1324 from a minibufferless frame to a surrogate minibuffer frame, we
1325 can use `other-window' to switch between all the frames using
1326 that minibuffer frame, and the focus redirection will follow us
1327 around. */
1328 #if 0
1329 /* This is too greedy; it causes inappropriate focus redirection
1330 that's hard to get rid of. */
1331 if (track)
1333 Lisp_Object tail;
1335 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
1337 Lisp_Object focus;
1339 if (!FRAMEP (XCAR (tail)))
1340 emacs_abort ();
1342 focus = FRAME_FOCUS_FRAME (XFRAME (XCAR (tail)));
1344 if (FRAMEP (focus) && XFRAME (focus) == SELECTED_FRAME ())
1345 Fredirect_frame_focus (XCAR (tail), frame);
1348 #else /* ! 0 */
1349 /* Instead, apply it only to the frame we're pointing to. */
1350 #ifdef HAVE_WINDOW_SYSTEM
1351 if (track && FRAME_WINDOW_P (f))
1353 Lisp_Object focus, xfocus;
1355 xfocus = x_get_focus_frame (f);
1356 if (FRAMEP (xfocus))
1358 focus = FRAME_FOCUS_FRAME (XFRAME (xfocus));
1359 if ((FRAMEP (focus) && XFRAME (focus) == SELECTED_FRAME ())
1360 /* Redirect frame focus also when FRAME has its minibuffer
1361 window on the selected frame (see Bug#24500). */
1362 || (NILP (focus)
1363 && EQ (FRAME_MINIBUF_WINDOW (f), sf->selected_window)))
1364 Fredirect_frame_focus (xfocus, frame);
1367 #endif /* HAVE_X_WINDOWS */
1368 #endif /* ! 0 */
1370 if (!for_deletion && FRAME_HAS_MINIBUF_P (sf))
1371 resize_mini_window (XWINDOW (FRAME_MINIBUF_WINDOW (sf)), 1);
1373 if (FRAME_TERMCAP_P (f) || FRAME_MSDOS_P (f))
1375 struct tty_display_info *tty = FRAME_TTY (f);
1376 Lisp_Object top_frame = tty->top_frame;
1378 /* Don't mark the frame garbaged and/or obscured if we are
1379 switching to the frame that is already the top frame of that
1380 TTY. */
1381 if (!EQ (frame, top_frame))
1383 if (FRAMEP (top_frame))
1384 /* Mark previously displayed frame as now obscured. */
1385 SET_FRAME_VISIBLE (XFRAME (top_frame), 2);
1386 SET_FRAME_VISIBLE (f, 1);
1387 /* If the new TTY frame changed dimensions, we need to
1388 resync term.c's idea of the frame size with the new
1389 frame's data. */
1390 if (FRAME_COLS (f) != FrameCols (tty))
1391 FrameCols (tty) = FRAME_COLS (f);
1392 if (FRAME_TOTAL_LINES (f) != FrameRows (tty))
1393 FrameRows (tty) = FRAME_TOTAL_LINES (f);
1395 tty->top_frame = frame;
1398 selected_frame = frame;
1399 if (! FRAME_MINIBUF_ONLY_P (XFRAME (selected_frame)))
1400 last_nonminibuf_frame = XFRAME (selected_frame);
1402 Fselect_window (f->selected_window, norecord);
1404 /* We want to make sure that the next event generates a frame-switch
1405 event to the appropriate frame. This seems kludgy to me, but
1406 before you take it out, make sure that evaluating something like
1407 (select-window (frame-root-window (new-frame))) doesn't end up
1408 with your typing being interpreted in the new frame instead of
1409 the one you're actually typing in. */
1410 #ifdef HAVE_WINDOW_SYSTEM
1411 if (!frame_ancestor_p (f, sf))
1412 #endif
1413 internal_last_event_frame = Qnil;
1415 return frame;
1418 DEFUN ("select-frame", Fselect_frame, Sselect_frame, 1, 2, "e",
1419 doc: /* Select FRAME.
1420 Subsequent editing commands apply to its selected window.
1421 Optional argument NORECORD means to neither change the order of
1422 recently selected windows nor the buffer list.
1424 The selection of FRAME lasts until the next time the user does
1425 something to select a different frame, or until the next time
1426 this function is called. If you are using a window system, the
1427 previously selected frame may be restored as the selected frame
1428 when returning to the command loop, because it still may have
1429 the window system's input focus. On a text terminal, the next
1430 redisplay will display FRAME.
1432 This function returns FRAME, or nil if FRAME has been deleted. */)
1433 (Lisp_Object frame, Lisp_Object norecord)
1435 return do_switch_frame (frame, 1, 0, norecord);
1438 DEFUN ("handle-switch-frame", Fhandle_switch_frame, Shandle_switch_frame, 1, 1, "^e",
1439 doc: /* Handle a switch-frame event EVENT.
1440 Switch-frame events are usually bound to this function.
1441 A switch-frame event tells Emacs that the window manager has requested
1442 that the user's events be directed to the frame mentioned in the event.
1443 This function selects the selected window of the frame of EVENT.
1445 If EVENT is frame object, handle it as if it were a switch-frame event
1446 to that frame. */)
1447 (Lisp_Object event)
1449 Lisp_Object value;
1451 /* Preserve prefix arg that the command loop just cleared. */
1452 kset_prefix_arg (current_kboard, Vcurrent_prefix_arg);
1453 run_hook (Qmouse_leave_buffer_hook);
1454 /* `switch-frame' implies a focus in. */
1455 value = do_switch_frame (event, 0, 0, Qnil);
1456 call1 (intern ("handle-focus-in"), event);
1457 return value;
1460 DEFUN ("selected-frame", Fselected_frame, Sselected_frame, 0, 0, 0,
1461 doc: /* Return the frame that is now selected. */)
1462 (void)
1464 return selected_frame;
1467 DEFUN ("frame-list", Fframe_list, Sframe_list,
1468 0, 0, 0,
1469 doc: /* Return a list of all live frames. */)
1470 (void)
1472 Lisp_Object frames;
1473 frames = Fcopy_sequence (Vframe_list);
1474 #ifdef HAVE_WINDOW_SYSTEM
1475 if (FRAMEP (tip_frame))
1476 frames = Fdelq (tip_frame, frames);
1477 #endif
1478 return frames;
1481 DEFUN ("frame-parent", Fframe_parent, Sframe_parent,
1482 0, 1, 0,
1483 doc: /* Return the parent frame of FRAME.
1484 The parent frame of FRAME is the Emacs frame whose window-system window
1485 is the parent window of FRAME's window-system window. When such a frame
1486 exists, FRAME is considered a child frame of that frame.
1488 Return nil if FRAME has no parent frame. This means that FRAME's
1489 window-system window is either a "top-level" window (a window whose
1490 parent window is the window-system's root window) or an embedded window
1491 \(a window whose parent window is owned by some other application). */)
1492 (Lisp_Object frame)
1494 struct frame *f = decode_live_frame (frame);
1495 struct frame *p = FRAME_PARENT_FRAME (f);
1496 Lisp_Object parent;
1498 /* Can't return f->parent_frame directly since it might not be defined
1499 for this platform. */
1500 if (p)
1502 XSETFRAME (parent, p);
1504 return parent;
1506 else
1507 return Qnil;
1510 #ifdef HAVE_WINDOW_SYSTEM
1511 bool
1512 frame_ancestor_p (struct frame *af, struct frame *df)
1514 struct frame *pf = FRAME_PARENT_FRAME (df);
1516 while (pf)
1518 if (pf == af)
1519 return true;
1520 else
1521 pf = FRAME_PARENT_FRAME (pf);
1524 return false;
1526 #endif
1528 DEFUN ("frame-ancestor-p", Fframe_ancestor_p, Sframe_ancestor_p,
1529 2, 2, 0,
1530 doc: /* Return non-nil if ANCESTOR is an ancestor of DESCENDANT.
1531 ANCESTOR is an ancestor of DESCENDANT when it is either DESCENDANT's
1532 parent frame or it is an ancestor of DESCENDANT's parent frame. Both,
1533 ANCESTOR and DESCENDANT must be live frames and default to the selected
1534 frame. */)
1535 (Lisp_Object ancestor, Lisp_Object descendant)
1537 #ifdef HAVE_WINDOW_SYSTEM
1538 struct frame *af = decode_live_frame (ancestor);
1539 struct frame *df = decode_live_frame (descendant);
1541 return frame_ancestor_p (af, df) ? Qt : Qnil;
1542 #else
1543 return Qnil;
1544 #endif
1547 /* Return CANDIDATE if it can be used as 'other-than-FRAME' frame on the
1548 same tty (for tty frames) or among frames which uses FRAME's keyboard.
1549 If MINIBUF is nil, do not consider minibuffer-only candidate.
1550 If MINIBUF is `visible', do not consider an invisible candidate.
1551 If MINIBUF is a window, consider only its own frame and candidate now
1552 using that window as the minibuffer.
1553 If MINIBUF is 0, consider candidate if it is visible or iconified.
1554 Otherwise consider any candidate and return nil if CANDIDATE is not
1555 acceptable. */
1557 static Lisp_Object
1558 candidate_frame (Lisp_Object candidate, Lisp_Object frame, Lisp_Object minibuf)
1560 struct frame *c = XFRAME (candidate), *f = XFRAME (frame);
1562 if ((!FRAME_TERMCAP_P (c) && !FRAME_TERMCAP_P (f)
1563 && FRAME_KBOARD (c) == FRAME_KBOARD (f))
1564 || (FRAME_TERMCAP_P (c) && FRAME_TERMCAP_P (f)
1565 && FRAME_TTY (c) == FRAME_TTY (f)))
1567 if (!NILP (get_frame_param (c, Qno_other_frame)))
1568 return Qnil;
1569 else if (NILP (minibuf))
1571 if (!FRAME_MINIBUF_ONLY_P (c))
1572 return candidate;
1574 else if (EQ (minibuf, Qvisible))
1576 if (FRAME_VISIBLE_P (c))
1577 return candidate;
1579 else if (WINDOWP (minibuf))
1581 if (EQ (FRAME_MINIBUF_WINDOW (c), minibuf)
1582 || EQ (WINDOW_FRAME (XWINDOW (minibuf)), candidate)
1583 || EQ (WINDOW_FRAME (XWINDOW (minibuf)),
1584 FRAME_FOCUS_FRAME (c)))
1585 return candidate;
1587 else if (INTEGERP (minibuf) && XINT (minibuf) == 0)
1589 if (FRAME_VISIBLE_P (c) || FRAME_ICONIFIED_P (c))
1590 return candidate;
1592 else
1593 return candidate;
1595 return Qnil;
1598 /* Return the next frame in the frame list after FRAME. */
1600 static Lisp_Object
1601 next_frame (Lisp_Object frame, Lisp_Object minibuf)
1603 Lisp_Object f, tail;
1604 int passed = 0;
1606 while (passed < 2)
1607 FOR_EACH_FRAME (tail, f)
1609 if (passed)
1611 f = candidate_frame (f, frame, minibuf);
1612 if (!NILP (f))
1613 return f;
1615 if (EQ (frame, f))
1616 passed++;
1618 return frame;
1621 /* Return the previous frame in the frame list before FRAME. */
1623 static Lisp_Object
1624 prev_frame (Lisp_Object frame, Lisp_Object minibuf)
1626 Lisp_Object f, tail, prev = Qnil;
1628 FOR_EACH_FRAME (tail, f)
1630 if (EQ (frame, f) && !NILP (prev))
1631 return prev;
1632 f = candidate_frame (f, frame, minibuf);
1633 if (!NILP (f))
1634 prev = f;
1637 /* We've scanned the entire list. */
1638 if (NILP (prev))
1639 /* We went through the whole frame list without finding a single
1640 acceptable frame. Return the original frame. */
1641 return frame;
1642 else
1643 /* There were no acceptable frames in the list before FRAME; otherwise,
1644 we would have returned directly from the loop. Since PREV is the last
1645 acceptable frame in the list, return it. */
1646 return prev;
1650 DEFUN ("next-frame", Fnext_frame, Snext_frame, 0, 2, 0,
1651 doc: /* Return the next frame in the frame list after FRAME.
1652 It considers only frames on the same terminal as FRAME.
1653 By default, skip minibuffer-only frames.
1654 If omitted, FRAME defaults to the selected frame.
1655 If optional argument MINIFRAME is nil, exclude minibuffer-only frames.
1656 If MINIFRAME is a window, include only its own frame
1657 and any frame now using that window as the minibuffer.
1658 If MINIFRAME is `visible', include all visible frames.
1659 If MINIFRAME is 0, include all visible and iconified frames.
1660 Otherwise, include all frames. */)
1661 (Lisp_Object frame, Lisp_Object miniframe)
1663 if (NILP (frame))
1664 frame = selected_frame;
1665 CHECK_LIVE_FRAME (frame);
1666 return next_frame (frame, miniframe);
1669 DEFUN ("previous-frame", Fprevious_frame, Sprevious_frame, 0, 2, 0,
1670 doc: /* Return the previous frame in the frame list before FRAME.
1671 It considers only frames on the same terminal as FRAME.
1672 By default, skip minibuffer-only frames.
1673 If omitted, FRAME defaults to the selected frame.
1674 If optional argument MINIFRAME is nil, exclude minibuffer-only frames.
1675 If MINIFRAME is a window, include only its own frame
1676 and any frame now using that window as the minibuffer.
1677 If MINIFRAME is `visible', include all visible frames.
1678 If MINIFRAME is 0, include all visible and iconified frames.
1679 Otherwise, include all frames. */)
1680 (Lisp_Object frame, Lisp_Object miniframe)
1682 if (NILP (frame))
1683 frame = selected_frame;
1684 CHECK_LIVE_FRAME (frame);
1685 return prev_frame (frame, miniframe);
1688 DEFUN ("last-nonminibuffer-frame", Flast_nonminibuf_frame,
1689 Slast_nonminibuf_frame, 0, 0, 0,
1690 doc: /* Return last non-minibuffer frame selected. */)
1691 (void)
1693 Lisp_Object frame = Qnil;
1695 if (last_nonminibuf_frame)
1696 XSETFRAME (frame, last_nonminibuf_frame);
1698 return frame;
1702 * other_frames:
1704 * Return true if there exists at least one visible or iconified frame
1705 * but F. Return false otherwise.
1707 * INVISIBLE true means we are called from make_frame_invisible where
1708 * such a frame must be visible or iconified. INVISIBLE nil means we
1709 * are called from delete_frame. In that case FORCE true means that the
1710 * visibility status of such a frame can be ignored.
1712 * If F is the terminal frame and we are using X, return true if at
1713 * least one X frame exists.
1715 static bool
1716 other_frames (struct frame *f, bool invisible, bool force)
1718 Lisp_Object frames, frame, frame1;
1719 struct frame *f1;
1720 Lisp_Object minibuffer_window = FRAME_MINIBUF_WINDOW (f);
1722 XSETFRAME (frame, f);
1723 if (WINDOWP (minibuffer_window)
1724 && !EQ (frame, WINDOW_FRAME (XWINDOW (minibuffer_window))))
1725 minibuffer_window = Qnil;
1727 FOR_EACH_FRAME (frames, frame1)
1729 f1 = XFRAME (frame1);
1730 if (f != f1)
1732 /* Verify that we can still talk to the frame's X window, and
1733 note any recent change in visibility. */
1734 #ifdef HAVE_X_WINDOWS
1735 if (FRAME_WINDOW_P (f1))
1736 x_sync (f1);
1737 #endif
1738 if (NILP (Fframe_parameter (frame1, Qtooltip))
1739 /* Tooltips and child frames count neither for
1740 invisibility nor for deletions. */
1741 && !FRAME_PARENT_FRAME (f1)
1742 /* Frames with a non-nil `delete-before' parameter don't
1743 count for deletions. */
1744 && (invisible || NILP (get_frame_param (f1, Qdelete_before)))
1745 /* For invisibility and normal deletions, at least one
1746 visible or iconified frame must remain (Bug#26682). */
1747 && (FRAME_VISIBLE_P (f1) || FRAME_ICONIFIED_P (f1)
1748 || (!invisible
1749 && (force
1750 /* Allow deleting the terminal frame when at
1751 least one X frame exists. */
1752 || (FRAME_WINDOW_P (f1) && !FRAME_WINDOW_P (f))))))
1753 return true;
1757 return false;
1760 /* Make sure that minibuf_window doesn't refer to FRAME's minibuffer
1761 window. Preferably use the selected frame's minibuffer window
1762 instead. If the selected frame doesn't have one, get some other
1763 frame's minibuffer window. SELECT non-zero means select the new
1764 minibuffer window. */
1765 static void
1766 check_minibuf_window (Lisp_Object frame, int select)
1768 struct frame *f = decode_live_frame (frame);
1770 XSETFRAME (frame, f);
1772 if (WINDOWP (minibuf_window) && EQ (f->minibuffer_window, minibuf_window))
1774 Lisp_Object frames, this, window = make_number (0);
1776 if (!EQ (frame, selected_frame)
1777 && FRAME_HAS_MINIBUF_P (XFRAME (selected_frame)))
1778 window = FRAME_MINIBUF_WINDOW (XFRAME (selected_frame));
1779 else
1780 FOR_EACH_FRAME (frames, this)
1782 if (!EQ (this, frame) && FRAME_HAS_MINIBUF_P (XFRAME (this)))
1784 window = FRAME_MINIBUF_WINDOW (XFRAME (this));
1785 break;
1789 /* Don't abort if no window was found (Bug#15247). */
1790 if (WINDOWP (window))
1792 /* Use set_window_buffer instead of Fset_window_buffer (see
1793 discussion of bug#11984, bug#12025, bug#12026). */
1794 set_window_buffer (window, XWINDOW (minibuf_window)->contents, 0, 0);
1795 minibuf_window = window;
1797 /* SELECT non-zero usually means that FRAME's minibuffer
1798 window was selected; select the new one. */
1799 if (select)
1800 Fselect_window (minibuf_window, Qnil);
1807 * delete_frame:
1809 * Delete FRAME. When FORCE equals Qnoelisp, delete FRAME
1810 * unconditionally. x_connection_closed and delete_terminal use this.
1811 * Any other value of FORCE implements the semantics described for
1812 * Fdelete_frame. */
1813 Lisp_Object
1814 delete_frame (Lisp_Object frame, Lisp_Object force)
1816 struct frame *f = decode_any_frame (frame);
1817 struct frame *sf;
1818 struct kboard *kb;
1819 Lisp_Object frames, frame1;
1820 int minibuffer_selected, is_tooltip_frame;
1821 bool nochild = !FRAME_PARENT_FRAME (f);
1823 if (!FRAME_LIVE_P (f))
1824 return Qnil;
1825 else if (!EQ (force, Qnoelisp) && !other_frames (f, false, !NILP (force)))
1827 if (NILP (force))
1828 error ("Attempt to delete the sole visible or iconified frame");
1829 else
1830 error ("Attempt to delete the only frame");
1833 XSETFRAME (frame, f);
1835 /* Softly delete all frames with this frame as their parent frame or
1836 as their `delete-before' frame parameter value. */
1837 FOR_EACH_FRAME (frames, frame1)
1838 if (FRAME_PARENT_FRAME (XFRAME (frame1)) == f
1839 /* Process `delete-before' parameter iff FRAME is not a child
1840 frame. This avoids that we enter an infinite chain of mixed
1841 dependencies. */
1842 || (nochild
1843 && EQ (get_frame_param (XFRAME (frame1), Qdelete_before), frame)))
1844 delete_frame (frame1, Qnil);
1846 /* Does this frame have a minibuffer, and is it the surrogate
1847 minibuffer for any other frame? */
1848 if (FRAME_HAS_MINIBUF_P (f))
1850 FOR_EACH_FRAME (frames, frame1)
1852 Lisp_Object fminiw;
1854 if (EQ (frame1, frame))
1855 continue;
1857 fminiw = FRAME_MINIBUF_WINDOW (XFRAME (frame1));
1859 if (WINDOWP (fminiw) && EQ (frame, WINDOW_FRAME (XWINDOW (fminiw))))
1861 /* If we MUST delete this frame, delete the other first.
1862 But do this only if FORCE equals `noelisp'. */
1863 if (EQ (force, Qnoelisp))
1864 delete_frame (frame1, Qnoelisp);
1865 else
1866 error ("Attempt to delete a surrogate minibuffer frame");
1871 is_tooltip_frame = !NILP (Fframe_parameter (frame, Qtooltip));
1873 /* Run `delete-frame-functions' unless FORCE is `noelisp' or
1874 frame is a tooltip. FORCE is set to `noelisp' when handling
1875 a disconnect from the terminal, so we don't dare call Lisp
1876 code. */
1877 if (NILP (Vrun_hooks) || is_tooltip_frame)
1879 else if (EQ (force, Qnoelisp))
1880 pending_funcalls
1881 = Fcons (list3 (Qrun_hook_with_args, Qdelete_frame_functions, frame),
1882 pending_funcalls);
1883 else
1885 #ifdef HAVE_X_WINDOWS
1886 /* Also, save clipboard to the clipboard manager. */
1887 x_clipboard_manager_save_frame (frame);
1888 #endif
1890 safe_call2 (Qrun_hook_with_args, Qdelete_frame_functions, frame);
1893 /* delete_frame_functions may have deleted any frame, including this
1894 one. */
1895 if (!FRAME_LIVE_P (f))
1896 return Qnil;
1897 else if (!EQ (force, Qnoelisp) && !other_frames (f, false, !NILP (force)))
1899 if (NILP (force))
1900 error ("Attempt to delete the sole visible or iconified frame");
1901 else
1902 error ("Attempt to delete the only frame");
1905 /* At this point, we are committed to deleting the frame.
1906 There is no more chance for errors to prevent it. */
1907 minibuffer_selected = EQ (minibuf_window, selected_window);
1908 sf = SELECTED_FRAME ();
1909 /* Don't let the frame remain selected. */
1910 if (f == sf)
1912 Lisp_Object tail;
1914 /* Look for another visible frame on the same terminal.
1915 Do not call next_frame here because it may loop forever.
1916 See http://debbugs.gnu.org/cgi/bugreport.cgi?bug=15025. */
1917 FOR_EACH_FRAME (tail, frame1)
1918 if (!EQ (frame, frame1)
1919 && (FRAME_TERMINAL (XFRAME (frame))
1920 == FRAME_TERMINAL (XFRAME (frame1)))
1921 && FRAME_VISIBLE_P (XFRAME (frame1)))
1922 break;
1924 /* If there is none, find *some* other frame. */
1925 if (NILP (frame1) || EQ (frame1, frame))
1927 FOR_EACH_FRAME (tail, frame1)
1929 if (! EQ (frame, frame1) && FRAME_LIVE_P (XFRAME (frame1)))
1931 /* Do not change a text terminal's top-frame. */
1932 struct frame *f1 = XFRAME (frame1);
1933 if (FRAME_TERMCAP_P (f1) || FRAME_MSDOS_P (f1))
1935 Lisp_Object top_frame = FRAME_TTY (f1)->top_frame;
1936 if (!EQ (top_frame, frame))
1937 frame1 = top_frame;
1939 break;
1943 #ifdef NS_IMPL_COCOA
1944 else
1945 /* Under NS, there is no system mechanism for choosing a new
1946 window to get focus -- it is left to application code.
1947 So the portion of THIS application interfacing with NS
1948 needs to know about it. We call Fraise_frame, but the
1949 purpose is really to transfer focus. */
1950 Fraise_frame (frame1);
1951 #endif
1953 do_switch_frame (frame1, 0, 1, Qnil);
1954 sf = SELECTED_FRAME ();
1957 /* Don't allow minibuf_window to remain on a deleted frame. */
1958 check_minibuf_window (frame, minibuffer_selected);
1960 /* Don't let echo_area_window to remain on a deleted frame. */
1961 if (EQ (f->minibuffer_window, echo_area_window))
1962 echo_area_window = sf->minibuffer_window;
1964 /* Clear any X selections for this frame. */
1965 #ifdef HAVE_X_WINDOWS
1966 if (FRAME_X_P (f))
1967 x_clear_frame_selections (f);
1968 #endif
1970 /* Free glyphs.
1971 This function must be called before the window tree of the
1972 frame is deleted because windows contain dynamically allocated
1973 memory. */
1974 free_glyphs (f);
1976 #ifdef HAVE_WINDOW_SYSTEM
1977 /* Give chance to each font driver to free a frame specific data. */
1978 font_update_drivers (f, Qnil);
1979 #endif
1981 /* Mark all the windows that used to be on FRAME as deleted, and then
1982 remove the reference to them. */
1983 delete_all_child_windows (f->root_window);
1984 fset_root_window (f, Qnil);
1986 Vframe_list = Fdelq (frame, Vframe_list);
1987 SET_FRAME_VISIBLE (f, 0);
1989 /* Allow the vector of menu bar contents to be freed in the next
1990 garbage collection. The frame object itself may not be garbage
1991 collected until much later, because recent_keys and other data
1992 structures can still refer to it. */
1993 fset_menu_bar_vector (f, Qnil);
1995 /* If FRAME's buffer lists contains killed
1996 buffers, this helps GC to reclaim them. */
1997 fset_buffer_list (f, Qnil);
1998 fset_buried_buffer_list (f, Qnil);
2000 free_font_driver_list (f);
2001 #if defined (USE_X_TOOLKIT) || defined (HAVE_NTGUI)
2002 xfree (f->namebuf);
2003 #endif
2004 xfree (f->decode_mode_spec_buffer);
2005 xfree (FRAME_INSERT_COST (f));
2006 xfree (FRAME_DELETEN_COST (f));
2007 xfree (FRAME_INSERTN_COST (f));
2008 xfree (FRAME_DELETE_COST (f));
2010 /* Since some events are handled at the interrupt level, we may get
2011 an event for f at any time; if we zero out the frame's terminal
2012 now, then we may trip up the event-handling code. Instead, we'll
2013 promise that the terminal of the frame must be valid until we
2014 have called the window-system-dependent frame destruction
2015 routine. */
2017 struct terminal *terminal;
2018 block_input ();
2019 if (FRAME_TERMINAL (f)->delete_frame_hook)
2020 (*FRAME_TERMINAL (f)->delete_frame_hook) (f);
2021 terminal = FRAME_TERMINAL (f);
2022 f->output_data.nothing = 0;
2023 f->terminal = 0; /* Now the frame is dead. */
2024 unblock_input ();
2026 /* If needed, delete the terminal that this frame was on.
2027 (This must be done after the frame is killed.) */
2028 terminal->reference_count--;
2029 #ifdef USE_GTK
2030 /* FIXME: Deleting the terminal crashes emacs because of a GTK
2031 bug.
2032 http://lists.gnu.org/archive/html/emacs-devel/2011-10/msg00363.html */
2033 if (terminal->reference_count == 0 && terminal->type == output_x_window)
2034 terminal->reference_count = 1;
2035 #endif /* USE_GTK */
2036 if (terminal->reference_count == 0)
2038 Lisp_Object tmp;
2039 XSETTERMINAL (tmp, terminal);
2041 kb = NULL;
2042 Fdelete_terminal (tmp, NILP (force) ? Qt : force);
2044 else
2045 kb = terminal->kboard;
2048 /* If we've deleted the last_nonminibuf_frame, then try to find
2049 another one. */
2050 if (f == last_nonminibuf_frame)
2052 last_nonminibuf_frame = 0;
2054 FOR_EACH_FRAME (frames, frame1)
2056 struct frame *f1 = XFRAME (frame1);
2058 if (!FRAME_MINIBUF_ONLY_P (f1))
2060 last_nonminibuf_frame = f1;
2061 break;
2066 /* If there's no other frame on the same kboard, get out of
2067 single-kboard state if we're in it for this kboard. */
2068 if (kb != NULL)
2070 /* Some frame we found on the same kboard, or nil if there are none. */
2071 Lisp_Object frame_on_same_kboard = Qnil;
2073 FOR_EACH_FRAME (frames, frame1)
2074 if (kb == FRAME_KBOARD (XFRAME (frame1)))
2075 frame_on_same_kboard = frame1;
2077 if (NILP (frame_on_same_kboard))
2078 not_single_kboard_state (kb);
2082 /* If we've deleted this keyboard's default_minibuffer_frame, try to
2083 find another one. Prefer minibuffer-only frames, but also notice
2084 frames with other windows. */
2085 if (kb != NULL && EQ (frame, KVAR (kb, Vdefault_minibuffer_frame)))
2087 /* The last frame we saw with a minibuffer, minibuffer-only or not. */
2088 Lisp_Object frame_with_minibuf = Qnil;
2089 /* Some frame we found on the same kboard, or nil if there are none. */
2090 Lisp_Object frame_on_same_kboard = Qnil;
2092 FOR_EACH_FRAME (frames, frame1)
2094 struct frame *f1 = XFRAME (frame1);
2096 /* Consider only frames on the same kboard
2097 and only those with minibuffers. */
2098 if (kb == FRAME_KBOARD (f1)
2099 && FRAME_HAS_MINIBUF_P (f1))
2101 frame_with_minibuf = frame1;
2102 if (FRAME_MINIBUF_ONLY_P (f1))
2103 break;
2106 if (kb == FRAME_KBOARD (f1))
2107 frame_on_same_kboard = frame1;
2110 if (!NILP (frame_on_same_kboard))
2112 /* We know that there must be some frame with a minibuffer out
2113 there. If this were not true, all of the frames present
2114 would have to be minibufferless, which implies that at some
2115 point their minibuffer frames must have been deleted, but
2116 that is prohibited at the top; you can't delete surrogate
2117 minibuffer frames. */
2118 if (NILP (frame_with_minibuf))
2119 emacs_abort ();
2121 kset_default_minibuffer_frame (kb, frame_with_minibuf);
2123 else
2124 /* No frames left on this kboard--say no minibuffer either. */
2125 kset_default_minibuffer_frame (kb, Qnil);
2128 /* Cause frame titles to update--necessary if we now have just one frame. */
2129 if (!is_tooltip_frame)
2130 update_mode_lines = 15;
2132 return Qnil;
2135 DEFUN ("delete-frame", Fdelete_frame, Sdelete_frame, 0, 2, "",
2136 doc: /* Delete FRAME, permanently eliminating it from use.
2137 FRAME must be a live frame and defaults to the selected one.
2139 A frame may not be deleted if its minibuffer serves as surrogate
2140 minibuffer for another frame. Normally, you may not delete a frame if
2141 all other frames are invisible, but if the second optional argument
2142 FORCE is non-nil, you may do so.
2144 This function runs `delete-frame-functions' before actually
2145 deleting the frame, unless the frame is a tooltip.
2146 The functions are run with one argument, the frame to be deleted. */)
2147 (Lisp_Object frame, Lisp_Object force)
2149 return delete_frame (frame, !NILP (force) ? Qt : Qnil);
2152 #ifdef HAVE_WINDOW_SYSTEM
2154 * frame_internal_border_part:
2156 * Return part of internal border the coordinates X and Y relative to
2157 * frame F are on. Return nil if the coordinates are not on the
2158 * internal border of F.
2160 * Return one of INTERNAL_BORDER_LEFT_EDGE, INTERNAL_BORDER_TOP_EDGE,
2161 * INTERNAL_BORDER_RIGHT_EDGE or INTERNAL_BORDER_BOTTOM_EDGE when the
2162 * mouse cursor is on the corresponding border with an offset of at
2163 * least one canonical character height from that border's edges.
2165 * If no border part could be found this way, return one of
2166 * INTERNAL_BORDER_TOP_LEFT_CORNER, INTERNAL_BORDER_TOP_RIGHT_CORNER,
2167 * INTERNAL_BORDER_BOTTOM_LEFT_CORNER or
2168 * INTERNAL_BORDER_BOTTOM_RIGHT_CORNER to indicate that the mouse is in
2169 * one of the corresponding corners. This means that for very small
2170 * frames an `edge' return value is preferred.
2172 enum internal_border_part
2173 frame_internal_border_part (struct frame *f, int x, int y)
2175 int border = FRAME_INTERNAL_BORDER_WIDTH (f);
2176 int offset = FRAME_LINE_HEIGHT (f);
2177 int width = FRAME_PIXEL_WIDTH (f);
2178 int height = FRAME_PIXEL_HEIGHT (f);
2179 enum internal_border_part part = INTERNAL_BORDER_NONE;
2181 if (offset < border)
2182 /* For very wide borders make offset at least as large as
2183 border. */
2184 offset = border;
2186 if (offset < x && x < width - offset)
2187 /* Top or bottom border. */
2189 if (0 <= y && y <= border)
2190 part = INTERNAL_BORDER_TOP_EDGE;
2191 else if (height - border <= y && y <= height)
2192 part = INTERNAL_BORDER_BOTTOM_EDGE;
2194 else if (offset < y && y < height - offset)
2195 /* Left or right border. */
2197 if (0 <= x && x <= border)
2198 part = INTERNAL_BORDER_LEFT_EDGE;
2199 else if (width - border <= x && x <= width)
2200 part = INTERNAL_BORDER_RIGHT_EDGE;
2202 else
2204 /* An edge. */
2205 int half_width = width / 2;
2206 int half_height = height / 2;
2208 if (0 <= x && x <= border)
2210 /* A left edge. */
2211 if (0 <= y && y <= half_height)
2212 part = INTERNAL_BORDER_TOP_LEFT_CORNER;
2213 else if (half_height < y && y <= height)
2214 part = INTERNAL_BORDER_BOTTOM_LEFT_CORNER;
2216 else if (width - border <= x && x <= width)
2218 /* A right edge. */
2219 if (0 <= y && y <= half_height)
2220 part = INTERNAL_BORDER_TOP_RIGHT_CORNER;
2221 else if (half_height < y && y <= height)
2222 part = INTERNAL_BORDER_BOTTOM_RIGHT_CORNER;
2224 else if (0 <= y && y <= border)
2226 /* A top edge. */
2227 if (0 <= x && x <= half_width)
2228 part = INTERNAL_BORDER_TOP_LEFT_CORNER;
2229 else if (half_width < x && x <= width)
2230 part = INTERNAL_BORDER_TOP_RIGHT_CORNER;
2232 else if (height - border <= y && y <= height)
2234 /* A bottom edge. */
2235 if (0 <= x && x <= half_width)
2236 part = INTERNAL_BORDER_BOTTOM_LEFT_CORNER;
2237 else if (half_width < x && x <= width)
2238 part = INTERNAL_BORDER_BOTTOM_RIGHT_CORNER;
2242 return part;
2244 #endif
2246 /* Return mouse position in character cell units. */
2248 DEFUN ("mouse-position", Fmouse_position, Smouse_position, 0, 0, 0,
2249 doc: /* Return a list (FRAME X . Y) giving the current mouse frame and position.
2250 The position is given in canonical character cells, where (0, 0) is the
2251 upper-left corner of the frame, X is the horizontal offset, and Y is the
2252 vertical offset, measured in units of the frame's default character size.
2253 If Emacs is running on a mouseless terminal or hasn't been programmed
2254 to read the mouse position, it returns the selected frame for FRAME
2255 and nil for X and Y.
2256 If `mouse-position-function' is non-nil, `mouse-position' calls it,
2257 passing the normal return value to that function as an argument,
2258 and returns whatever that function returns. */)
2259 (void)
2261 struct frame *f;
2262 Lisp_Object lispy_dummy;
2263 Lisp_Object x, y, retval;
2265 f = SELECTED_FRAME ();
2266 x = y = Qnil;
2268 /* It's okay for the hook to refrain from storing anything. */
2269 if (FRAME_TERMINAL (f)->mouse_position_hook)
2271 enum scroll_bar_part party_dummy;
2272 Time time_dummy;
2273 (*FRAME_TERMINAL (f)->mouse_position_hook) (&f, -1,
2274 &lispy_dummy, &party_dummy,
2275 &x, &y,
2276 &time_dummy);
2279 if (! NILP (x))
2281 int col = XINT (x);
2282 int row = XINT (y);
2283 pixel_to_glyph_coords (f, col, row, &col, &row, NULL, 1);
2284 XSETINT (x, col);
2285 XSETINT (y, row);
2287 XSETFRAME (lispy_dummy, f);
2288 retval = Fcons (lispy_dummy, Fcons (x, y));
2289 if (!NILP (Vmouse_position_function))
2290 retval = call1 (Vmouse_position_function, retval);
2291 return retval;
2294 DEFUN ("mouse-pixel-position", Fmouse_pixel_position,
2295 Smouse_pixel_position, 0, 0, 0,
2296 doc: /* Return a list (FRAME X . Y) giving the current mouse frame and position.
2297 The position is given in pixel units, where (0, 0) is the
2298 upper-left corner of the frame, X is the horizontal offset, and Y is
2299 the vertical offset.
2300 If Emacs is running on a mouseless terminal or hasn't been programmed
2301 to read the mouse position, it returns the selected frame for FRAME
2302 and nil for X and Y. */)
2303 (void)
2305 struct frame *f;
2306 Lisp_Object lispy_dummy;
2307 Lisp_Object x, y, retval;
2309 f = SELECTED_FRAME ();
2310 x = y = Qnil;
2312 /* It's okay for the hook to refrain from storing anything. */
2313 if (FRAME_TERMINAL (f)->mouse_position_hook)
2315 enum scroll_bar_part party_dummy;
2316 Time time_dummy;
2317 (*FRAME_TERMINAL (f)->mouse_position_hook) (&f, -1,
2318 &lispy_dummy, &party_dummy,
2319 &x, &y,
2320 &time_dummy);
2323 XSETFRAME (lispy_dummy, f);
2324 retval = Fcons (lispy_dummy, Fcons (x, y));
2325 if (!NILP (Vmouse_position_function))
2326 retval = call1 (Vmouse_position_function, retval);
2327 return retval;
2330 #ifdef HAVE_WINDOW_SYSTEM
2332 /* On frame F, convert character coordinates X and Y to pixel
2333 coordinates *PIX_X and *PIX_Y. */
2335 static void
2336 frame_char_to_pixel_position (struct frame *f, int x, int y,
2337 int *pix_x, int *pix_y)
2339 *pix_x = FRAME_COL_TO_PIXEL_X (f, x) + FRAME_COLUMN_WIDTH (f) / 2;
2340 *pix_y = FRAME_LINE_TO_PIXEL_Y (f, y) + FRAME_LINE_HEIGHT (f) / 2;
2342 if (*pix_x < 0)
2343 *pix_x = 0;
2344 if (*pix_x > FRAME_PIXEL_WIDTH (f))
2345 *pix_x = FRAME_PIXEL_WIDTH (f);
2347 if (*pix_y < 0)
2348 *pix_y = 0;
2349 if (*pix_y > FRAME_PIXEL_HEIGHT (f))
2350 *pix_y = FRAME_PIXEL_HEIGHT (f);
2353 /* On frame F, reposition mouse pointer to character coordinates X and Y. */
2355 static void
2356 frame_set_mouse_position (struct frame *f, int x, int y)
2358 int pix_x, pix_y;
2360 frame_char_to_pixel_position (f, x, y, &pix_x, &pix_y);
2361 frame_set_mouse_pixel_position (f, pix_x, pix_y);
2364 #endif /* HAVE_WINDOW_SYSTEM */
2366 DEFUN ("set-mouse-position", Fset_mouse_position, Sset_mouse_position, 3, 3, 0,
2367 doc: /* Move the mouse pointer to the center of character cell (X,Y) in FRAME.
2368 Coordinates are relative to the frame, not a window,
2369 so the coordinates of the top left character in the frame
2370 may be nonzero due to left-hand scroll bars or the menu bar.
2372 The position is given in canonical character cells, where (0, 0) is
2373 the upper-left corner of the frame, X is the horizontal offset, and
2374 Y is the vertical offset, measured in units of the frame's default
2375 character size.
2377 This function is a no-op for an X frame that is not visible.
2378 If you have just created a frame, you must wait for it to become visible
2379 before calling this function on it, like this.
2380 (while (not (frame-visible-p frame)) (sleep-for .5)) */)
2381 (Lisp_Object frame, Lisp_Object x, Lisp_Object y)
2383 CHECK_LIVE_FRAME (frame);
2384 CHECK_TYPE_RANGED_INTEGER (int, x);
2385 CHECK_TYPE_RANGED_INTEGER (int, y);
2387 /* I think this should be done with a hook. */
2388 #ifdef HAVE_WINDOW_SYSTEM
2389 if (FRAME_WINDOW_P (XFRAME (frame)))
2390 /* Warping the mouse will cause enternotify and focus events. */
2391 frame_set_mouse_position (XFRAME (frame), XINT (x), XINT (y));
2392 #else
2393 #if defined (MSDOS)
2394 if (FRAME_MSDOS_P (XFRAME (frame)))
2396 Fselect_frame (frame, Qnil);
2397 mouse_moveto (XINT (x), XINT (y));
2399 #else
2400 #ifdef HAVE_GPM
2402 Fselect_frame (frame, Qnil);
2403 term_mouse_moveto (XINT (x), XINT (y));
2405 #endif
2406 #endif
2407 #endif
2409 return Qnil;
2412 DEFUN ("set-mouse-pixel-position", Fset_mouse_pixel_position,
2413 Sset_mouse_pixel_position, 3, 3, 0,
2414 doc: /* Move the mouse pointer to pixel position (X,Y) in FRAME.
2415 The position is given in pixels, where (0, 0) is the upper-left corner
2416 of the frame, X is the horizontal offset, and Y is the vertical offset.
2418 Note, this is a no-op for an X frame that is not visible.
2419 If you have just created a frame, you must wait for it to become visible
2420 before calling this function on it, like this.
2421 (while (not (frame-visible-p frame)) (sleep-for .5)) */)
2422 (Lisp_Object frame, Lisp_Object x, Lisp_Object y)
2424 CHECK_LIVE_FRAME (frame);
2425 CHECK_TYPE_RANGED_INTEGER (int, x);
2426 CHECK_TYPE_RANGED_INTEGER (int, y);
2428 /* I think this should be done with a hook. */
2429 #ifdef HAVE_WINDOW_SYSTEM
2430 if (FRAME_WINDOW_P (XFRAME (frame)))
2431 /* Warping the mouse will cause enternotify and focus events. */
2432 frame_set_mouse_pixel_position (XFRAME (frame), XINT (x), XINT (y));
2433 #else
2434 #if defined (MSDOS)
2435 if (FRAME_MSDOS_P (XFRAME (frame)))
2437 Fselect_frame (frame, Qnil);
2438 mouse_moveto (XINT (x), XINT (y));
2440 #else
2441 #ifdef HAVE_GPM
2443 Fselect_frame (frame, Qnil);
2444 term_mouse_moveto (XINT (x), XINT (y));
2446 #endif
2447 #endif
2448 #endif
2450 return Qnil;
2453 static void make_frame_visible_1 (Lisp_Object);
2455 DEFUN ("make-frame-visible", Fmake_frame_visible, Smake_frame_visible,
2456 0, 1, "",
2457 doc: /* Make the frame FRAME visible (assuming it is an X window).
2458 If omitted, FRAME defaults to the currently selected frame. */)
2459 (Lisp_Object frame)
2461 struct frame *f = decode_live_frame (frame);
2463 /* I think this should be done with a hook. */
2464 #ifdef HAVE_WINDOW_SYSTEM
2465 if (FRAME_WINDOW_P (f))
2466 x_make_frame_visible (f);
2467 #endif
2469 make_frame_visible_1 (f->root_window);
2471 /* Make menu bar update for the Buffers and Frames menus. */
2472 /* windows_or_buffers_changed = 15; FIXME: Why? */
2474 XSETFRAME (frame, f);
2475 return frame;
2478 /* Update the display_time slot of the buffers shown in WINDOW
2479 and all its descendants. */
2481 static void
2482 make_frame_visible_1 (Lisp_Object window)
2484 struct window *w;
2486 for (; !NILP (window); window = w->next)
2488 w = XWINDOW (window);
2489 if (WINDOWP (w->contents))
2490 make_frame_visible_1 (w->contents);
2491 else
2492 bset_display_time (XBUFFER (w->contents), Fcurrent_time ());
2496 DEFUN ("make-frame-invisible", Fmake_frame_invisible, Smake_frame_invisible,
2497 0, 2, "",
2498 doc: /* Make the frame FRAME invisible.
2499 If omitted, FRAME defaults to the currently selected frame.
2500 On graphical displays, invisible frames are not updated and are
2501 usually not displayed at all, even in a window system's \"taskbar\".
2503 Normally you may not make FRAME invisible if all other frames are invisible,
2504 but if the second optional argument FORCE is non-nil, you may do so.
2506 This function has no effect on text terminal frames. Such frames are
2507 always considered visible, whether or not they are currently being
2508 displayed in the terminal. */)
2509 (Lisp_Object frame, Lisp_Object force)
2511 struct frame *f = decode_live_frame (frame);
2513 if (NILP (force) && !other_frames (f, true, false))
2514 error ("Attempt to make invisible the sole visible or iconified frame");
2516 /* Don't allow minibuf_window to remain on an invisible frame. */
2517 check_minibuf_window (frame, EQ (minibuf_window, selected_window));
2519 /* I think this should be done with a hook. */
2520 #ifdef HAVE_WINDOW_SYSTEM
2521 if (FRAME_WINDOW_P (f))
2522 x_make_frame_invisible (f);
2523 #endif
2525 /* Make menu bar update for the Buffers and Frames menus. */
2526 windows_or_buffers_changed = 16;
2528 return Qnil;
2531 DEFUN ("iconify-frame", Ficonify_frame, Siconify_frame,
2532 0, 1, "",
2533 doc: /* Make the frame FRAME into an icon.
2534 If omitted, FRAME defaults to the currently selected frame. */)
2535 (Lisp_Object frame)
2537 struct frame *f = decode_live_frame (frame);
2539 /* Don't allow minibuf_window to remain on an iconified frame. */
2540 check_minibuf_window (frame, EQ (minibuf_window, selected_window));
2542 /* I think this should be done with a hook. */
2543 if (FRAME_WINDOW_P (f))
2545 #ifdef HAVE_WINDOW_SYSTEM
2546 x_iconify_frame (f);
2547 #endif
2550 return Qnil;
2553 DEFUN ("frame-visible-p", Fframe_visible_p, Sframe_visible_p,
2554 1, 1, 0,
2555 doc: /* Return t if FRAME is \"visible\" (actually in use for display).
2556 Return the symbol `icon' if FRAME is iconified or \"minimized\".
2557 Return nil if FRAME was made invisible, via `make-frame-invisible'.
2558 On graphical displays, invisible frames are not updated and are
2559 usually not displayed at all, even in a window system's \"taskbar\".
2561 If FRAME is a text terminal frame, this always returns t.
2562 Such frames are always considered visible, whether or not they are
2563 currently being displayed on the terminal. */)
2564 (Lisp_Object frame)
2566 CHECK_LIVE_FRAME (frame);
2568 if (FRAME_VISIBLE_P (XFRAME (frame)))
2569 return Qt;
2570 if (FRAME_ICONIFIED_P (XFRAME (frame)))
2571 return Qicon;
2572 return Qnil;
2575 DEFUN ("visible-frame-list", Fvisible_frame_list, Svisible_frame_list,
2576 0, 0, 0,
2577 doc: /* Return a list of all frames now \"visible\" (being updated). */)
2578 (void)
2580 Lisp_Object tail, frame, value = Qnil;
2582 FOR_EACH_FRAME (tail, frame)
2583 if (FRAME_VISIBLE_P (XFRAME (frame)))
2584 value = Fcons (frame, value);
2586 return value;
2590 DEFUN ("raise-frame", Fraise_frame, Sraise_frame, 0, 1, "",
2591 doc: /* Bring FRAME to the front, so it occludes any frames it overlaps.
2592 If FRAME is invisible or iconified, make it visible.
2593 If you don't specify a frame, the selected frame is used.
2594 If Emacs is displaying on an ordinary terminal or some other device which
2595 doesn't support multiple overlapping frames, this function selects FRAME. */)
2596 (Lisp_Object frame)
2598 struct frame *f = decode_live_frame (frame);
2600 XSETFRAME (frame, f);
2602 if (FRAME_TERMCAP_P (f))
2603 /* On a text terminal select FRAME. */
2604 Fselect_frame (frame, Qnil);
2605 else
2606 /* Do like the documentation says. */
2607 Fmake_frame_visible (frame);
2609 if (FRAME_TERMINAL (f)->frame_raise_lower_hook)
2610 (*FRAME_TERMINAL (f)->frame_raise_lower_hook) (f, 1);
2612 return Qnil;
2615 /* Should we have a corresponding function called Flower_Power? */
2616 DEFUN ("lower-frame", Flower_frame, Slower_frame, 0, 1, "",
2617 doc: /* Send FRAME to the back, so it is occluded by any frames that overlap it.
2618 If you don't specify a frame, the selected frame is used.
2619 If Emacs is displaying on an ordinary terminal or some other device which
2620 doesn't support multiple overlapping frames, this function does nothing. */)
2621 (Lisp_Object frame)
2623 struct frame *f = decode_live_frame (frame);
2625 if (FRAME_TERMINAL (f)->frame_raise_lower_hook)
2626 (*FRAME_TERMINAL (f)->frame_raise_lower_hook) (f, 0);
2628 return Qnil;
2632 DEFUN ("redirect-frame-focus", Fredirect_frame_focus, Sredirect_frame_focus,
2633 1, 2, 0,
2634 doc: /* Arrange for keystrokes typed at FRAME to be sent to FOCUS-FRAME.
2635 In other words, switch-frame events caused by events in FRAME will
2636 request a switch to FOCUS-FRAME, and `last-event-frame' will be
2637 FOCUS-FRAME after reading an event typed at FRAME.
2639 If FOCUS-FRAME is nil, any existing redirection is canceled, and the
2640 frame again receives its own keystrokes.
2642 Focus redirection is useful for temporarily redirecting keystrokes to
2643 a surrogate minibuffer frame when a frame doesn't have its own
2644 minibuffer window.
2646 A frame's focus redirection can be changed by `select-frame'. If frame
2647 FOO is selected, and then a different frame BAR is selected, any
2648 frames redirecting their focus to FOO are shifted to redirect their
2649 focus to BAR. This allows focus redirection to work properly when the
2650 user switches from one frame to another using `select-window'.
2652 This means that a frame whose focus is redirected to itself is treated
2653 differently from a frame whose focus is redirected to nil; the former
2654 is affected by `select-frame', while the latter is not.
2656 The redirection lasts until `redirect-frame-focus' is called to change it. */)
2657 (Lisp_Object frame, Lisp_Object focus_frame)
2659 /* Note that we don't check for a live frame here. It's reasonable
2660 to redirect the focus of a frame you're about to delete, if you
2661 know what other frame should receive those keystrokes. */
2662 struct frame *f = decode_any_frame (frame);
2664 if (! NILP (focus_frame))
2665 CHECK_LIVE_FRAME (focus_frame);
2667 fset_focus_frame (f, focus_frame);
2669 if (FRAME_TERMINAL (f)->frame_rehighlight_hook)
2670 (*FRAME_TERMINAL (f)->frame_rehighlight_hook) (f);
2672 return Qnil;
2676 DEFUN ("frame-focus", Fframe_focus, Sframe_focus, 0, 1, 0,
2677 doc: /* Return the frame to which FRAME's keystrokes are currently being sent.
2678 If FRAME is omitted or nil, the selected frame is used.
2679 Return nil if FRAME's focus is not redirected.
2680 See `redirect-frame-focus'. */)
2681 (Lisp_Object frame)
2683 return FRAME_FOCUS_FRAME (decode_live_frame (frame));
2686 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 2, 0,
2687 doc: /* Set the input focus to FRAME.
2688 FRAME nil means use the selected frame. Optional argument NOACTIVATE
2689 means do not activate FRAME.
2691 If there is no window system support, this function does nothing. */)
2692 (Lisp_Object frame, Lisp_Object noactivate)
2694 #ifdef HAVE_WINDOW_SYSTEM
2695 x_focus_frame (decode_window_system_frame (frame), !NILP (noactivate));
2696 #endif
2697 return Qnil;
2700 DEFUN ("frame-after-make-frame",
2701 Fframe_after_make_frame,
2702 Sframe_after_make_frame, 2, 2, 0,
2703 doc: /* Mark FRAME as made.
2704 FRAME nil means use the selected frame. Second argument MADE non-nil
2705 means functions on `window-configuration-change-hook' are called
2706 whenever the window configuration of FRAME changes. MADE nil means
2707 these functions are not called.
2709 This function is currently called by `make-frame' only and should be
2710 otherwise used with utter care to avoid that running functions on
2711 `window-configuration-change-hook' is impeded forever. */)
2712 (Lisp_Object frame, Lisp_Object made)
2714 struct frame *f = decode_live_frame (frame);
2715 f->after_make_frame = !NILP (made);
2716 f->inhibit_horizontal_resize = false;
2717 f->inhibit_vertical_resize = false;
2718 return made;
2722 /* Discard BUFFER from the buffer-list and buried-buffer-list of each frame. */
2724 void
2725 frames_discard_buffer (Lisp_Object buffer)
2727 Lisp_Object frame, tail;
2729 FOR_EACH_FRAME (tail, frame)
2731 fset_buffer_list
2732 (XFRAME (frame), Fdelq (buffer, XFRAME (frame)->buffer_list));
2733 fset_buried_buffer_list
2734 (XFRAME (frame), Fdelq (buffer, XFRAME (frame)->buried_buffer_list));
2738 /* Modify the alist in *ALISTPTR to associate PROP with VAL.
2739 If the alist already has an element for PROP, we change it. */
2741 void
2742 store_in_alist (Lisp_Object *alistptr, Lisp_Object prop, Lisp_Object val)
2744 register Lisp_Object tem;
2746 tem = Fassq (prop, *alistptr);
2747 if (EQ (tem, Qnil))
2748 *alistptr = Fcons (Fcons (prop, val), *alistptr);
2749 else
2750 Fsetcdr (tem, val);
2753 static int
2754 frame_name_fnn_p (char *str, ptrdiff_t len)
2756 if (len > 1 && str[0] == 'F' && '0' <= str[1] && str[1] <= '9')
2758 char *p = str + 2;
2759 while ('0' <= *p && *p <= '9')
2760 p++;
2761 if (p == str + len)
2762 return 1;
2764 return 0;
2767 /* Set the name of the terminal frame. Also used by MSDOS frames.
2768 Modeled after x_set_name which is used for WINDOW frames. */
2770 static void
2771 set_term_frame_name (struct frame *f, Lisp_Object name)
2773 f->explicit_name = ! NILP (name);
2775 /* If NAME is nil, set the name to F<num>. */
2776 if (NILP (name))
2778 char namebuf[sizeof "F" + INT_STRLEN_BOUND (printmax_t)];
2780 /* Check for no change needed in this very common case
2781 before we do any consing. */
2782 if (frame_name_fnn_p (SSDATA (f->name), SBYTES (f->name)))
2783 return;
2785 name = make_formatted_string (namebuf, "F%"pMd, ++tty_frame_count);
2787 else
2789 CHECK_STRING (name);
2791 /* Don't change the name if it's already NAME. */
2792 if (! NILP (Fstring_equal (name, f->name)))
2793 return;
2795 /* Don't allow the user to set the frame name to F<num>, so it
2796 doesn't clash with the names we generate for terminal frames. */
2797 if (frame_name_fnn_p (SSDATA (name), SBYTES (name)))
2798 error ("Frame names of the form F<num> are usurped by Emacs");
2801 fset_name (f, name);
2802 update_mode_lines = 16;
2805 void
2806 store_frame_param (struct frame *f, Lisp_Object prop, Lisp_Object val)
2808 register Lisp_Object old_alist_elt;
2810 if (EQ (prop, Qminibuffer))
2812 if (WINDOWP (val))
2814 if (!MINI_WINDOW_P (XWINDOW (val)))
2815 error ("The `minibuffer' parameter does not specify a valid minibuffer window");
2816 else if (FRAME_MINIBUF_ONLY_P (f))
2818 if (EQ (val, FRAME_MINIBUF_WINDOW (f)))
2819 val = Qonly;
2820 else
2821 error ("Can't change the minibuffer window of a minibuffer-only frame");
2823 else if (FRAME_HAS_MINIBUF_P (f))
2825 if (EQ (val, FRAME_MINIBUF_WINDOW (f)))
2826 val = Qt;
2827 else
2828 error ("Can't change the minibuffer window of a frame with its own minibuffer");
2830 else
2831 /* Store the chosen minibuffer window. */
2832 fset_minibuffer_window (f, val);
2834 else
2836 Lisp_Object old_val = Fcdr (Fassq (Qminibuffer, f->param_alist));
2838 if (!NILP (old_val))
2840 if (WINDOWP (old_val) && NILP (val))
2841 /* Don't change the value for a minibuffer-less frame if
2842 only nil was specified as new value. */
2843 val = old_val;
2844 else if (!EQ (old_val, val))
2845 error ("Can't change the `minibuffer' parameter of this frame");
2850 /* Check each parent-frame and delete-before parameter for a
2851 circular dependency. Do not check between parameters, so you can
2852 still create circular dependencies with different properties, for
2853 example a chain of frames F1->F2->...Fn such that F1 is an ancestor
2854 frame of Fn and thus cannot be deleted before Fn and a second chain
2855 Fn->Fn-1->...F1 such that Fn cannot be deleted before F1. */
2856 else if (EQ (prop, Qparent_frame) || EQ (prop, Qdelete_before))
2858 Lisp_Object oldval = Fcdr (Fassq (prop, f->param_alist));
2860 if (!EQ (oldval, val) && !NILP (val))
2862 Lisp_Object frame;
2863 Lisp_Object frame1 = val;
2865 if (!FRAMEP (frame1) || !FRAME_LIVE_P (XFRAME (frame1)))
2866 error ("Invalid `%s' frame parameter",
2867 SSDATA (SYMBOL_NAME (prop)));
2869 XSETFRAME (frame, f);
2871 while (FRAMEP (frame1) && FRAME_LIVE_P (XFRAME (frame1)))
2872 if (EQ (frame1, frame))
2873 error ("Circular specification of `%s' frame parameter",
2874 SSDATA (SYMBOL_NAME (prop)));
2875 else
2876 frame1 = get_frame_param (XFRAME (frame1), prop);
2880 /* The buffer-list parameters are stored in a special place and not
2881 in the alist. All buffers must be live. */
2882 else if (EQ (prop, Qbuffer_list))
2884 Lisp_Object list = Qnil;
2885 for (; CONSP (val); val = XCDR (val))
2886 if (!NILP (Fbuffer_live_p (XCAR (val))))
2887 list = Fcons (XCAR (val), list);
2888 fset_buffer_list (f, Fnreverse (list));
2889 return;
2891 else if (EQ (prop, Qburied_buffer_list))
2893 Lisp_Object list = Qnil;
2894 for (; CONSP (val); val = XCDR (val))
2895 if (!NILP (Fbuffer_live_p (XCAR (val))))
2896 list = Fcons (XCAR (val), list);
2897 fset_buried_buffer_list (f, Fnreverse (list));
2898 return;
2901 /* The tty color needed to be set before the frame's parameter
2902 alist was updated with the new value. This is not true any more,
2903 but we still do this test early on. */
2904 if (FRAME_TERMCAP_P (f) && EQ (prop, Qtty_color_mode)
2905 && f == FRAME_TTY (f)->previous_frame)
2906 /* Force redisplay of this tty. */
2907 FRAME_TTY (f)->previous_frame = NULL;
2909 /* Update the frame parameter alist. */
2910 old_alist_elt = Fassq (prop, f->param_alist);
2911 if (EQ (old_alist_elt, Qnil))
2912 fset_param_alist (f, Fcons (Fcons (prop, val), f->param_alist));
2913 else
2914 Fsetcdr (old_alist_elt, val);
2916 /* Update some other special parameters in their special places
2917 in addition to the alist. */
2919 if (EQ (prop, Qbuffer_predicate))
2920 fset_buffer_predicate (f, val);
2922 if (! FRAME_WINDOW_P (f))
2924 if (EQ (prop, Qmenu_bar_lines))
2925 set_menu_bar_lines (f, val, make_number (FRAME_MENU_BAR_LINES (f)));
2926 else if (EQ (prop, Qname))
2927 set_term_frame_name (f, val);
2931 /* Return color matches UNSPEC on frame F or nil if UNSPEC
2932 is not an unspecified foreground or background color. */
2934 static Lisp_Object
2935 frame_unspecified_color (struct frame *f, Lisp_Object unspec)
2937 return (!strncmp (SSDATA (unspec), unspecified_bg, SBYTES (unspec))
2938 ? tty_color_name (f, FRAME_BACKGROUND_PIXEL (f))
2939 : (!strncmp (SSDATA (unspec), unspecified_fg, SBYTES (unspec))
2940 ? tty_color_name (f, FRAME_FOREGROUND_PIXEL (f)) : Qnil));
2943 DEFUN ("frame-parameters", Fframe_parameters, Sframe_parameters, 0, 1, 0,
2944 doc: /* Return the parameters-alist of frame FRAME.
2945 It is a list of elements of the form (PARM . VALUE), where PARM is a symbol.
2946 The meaningful PARMs depend on the kind of frame.
2947 If FRAME is omitted or nil, return information on the currently selected frame. */)
2948 (Lisp_Object frame)
2950 Lisp_Object alist;
2951 struct frame *f = decode_any_frame (frame);
2952 int height, width;
2954 if (!FRAME_LIVE_P (f))
2955 return Qnil;
2957 alist = Fcopy_alist (f->param_alist);
2959 if (!FRAME_WINDOW_P (f))
2961 Lisp_Object elt;
2963 /* If the frame's parameter alist says the colors are
2964 unspecified and reversed, take the frame's background pixel
2965 for foreground and vice versa. */
2966 elt = Fassq (Qforeground_color, alist);
2967 if (CONSP (elt) && STRINGP (XCDR (elt)))
2969 elt = frame_unspecified_color (f, XCDR (elt));
2970 if (!NILP (elt))
2971 store_in_alist (&alist, Qforeground_color, elt);
2973 else
2974 store_in_alist (&alist, Qforeground_color,
2975 tty_color_name (f, FRAME_FOREGROUND_PIXEL (f)));
2976 elt = Fassq (Qbackground_color, alist);
2977 if (CONSP (elt) && STRINGP (XCDR (elt)))
2979 elt = frame_unspecified_color (f, XCDR (elt));
2980 if (!NILP (elt))
2981 store_in_alist (&alist, Qbackground_color, elt);
2983 else
2984 store_in_alist (&alist, Qbackground_color,
2985 tty_color_name (f, FRAME_BACKGROUND_PIXEL (f)));
2986 store_in_alist (&alist, Qfont,
2987 build_string (FRAME_MSDOS_P (f)
2988 ? "ms-dos"
2989 : FRAME_W32_P (f) ? "w32term"
2990 :"tty"));
2992 store_in_alist (&alist, Qname, f->name);
2993 height = (f->new_height
2994 ? (f->new_pixelwise
2995 ? (f->new_height / FRAME_LINE_HEIGHT (f))
2996 : f->new_height)
2997 : FRAME_LINES (f));
2998 store_in_alist (&alist, Qheight, make_number (height));
2999 width = (f->new_width
3000 ? (f->new_pixelwise
3001 ? (f->new_width / FRAME_COLUMN_WIDTH (f))
3002 : f->new_width)
3003 : FRAME_COLS (f));
3004 store_in_alist (&alist, Qwidth, make_number (width));
3005 store_in_alist (&alist, Qmodeline, (FRAME_WANTS_MODELINE_P (f) ? Qt : Qnil));
3006 store_in_alist (&alist, Qunsplittable, (FRAME_NO_SPLIT_P (f) ? Qt : Qnil));
3007 store_in_alist (&alist, Qbuffer_list, f->buffer_list);
3008 store_in_alist (&alist, Qburied_buffer_list, f->buried_buffer_list);
3010 /* I think this should be done with a hook. */
3011 #ifdef HAVE_WINDOW_SYSTEM
3012 if (FRAME_WINDOW_P (f))
3013 x_report_frame_params (f, &alist);
3014 else
3015 #endif
3017 /* This ought to be correct in f->param_alist for an X frame. */
3018 Lisp_Object lines;
3019 XSETFASTINT (lines, FRAME_MENU_BAR_LINES (f));
3020 store_in_alist (&alist, Qmenu_bar_lines, lines);
3023 return alist;
3027 DEFUN ("frame-parameter", Fframe_parameter, Sframe_parameter, 2, 2, 0,
3028 doc: /* Return FRAME's value for parameter PARAMETER.
3029 If FRAME is nil, describe the currently selected frame. */)
3030 (Lisp_Object frame, Lisp_Object parameter)
3032 struct frame *f = decode_any_frame (frame);
3033 Lisp_Object value = Qnil;
3035 CHECK_SYMBOL (parameter);
3037 XSETFRAME (frame, f);
3039 if (FRAME_LIVE_P (f))
3041 /* Avoid consing in frequent cases. */
3042 if (EQ (parameter, Qname))
3043 value = f->name;
3044 #ifdef HAVE_WINDOW_SYSTEM
3045 /* These are used by vertical motion commands. */
3046 else if (EQ (parameter, Qvertical_scroll_bars))
3047 value = (f->vertical_scroll_bar_type == vertical_scroll_bar_none
3048 ? Qnil
3049 : (f->vertical_scroll_bar_type == vertical_scroll_bar_left
3050 ? Qleft : Qright));
3051 else if (EQ (parameter, Qhorizontal_scroll_bars))
3052 value = f->horizontal_scroll_bars ? Qt : Qnil;
3053 else if (EQ (parameter, Qline_spacing) && f->extra_line_spacing == 0)
3054 /* If this is non-zero, we can't determine whether the user specified
3055 an integer or float value without looking through 'param_alist'. */
3056 value = make_number (0);
3057 else if (EQ (parameter, Qfont) && FRAME_X_P (f))
3058 value = FRAME_FONT (f)->props[FONT_NAME_INDEX];
3059 #endif /* HAVE_WINDOW_SYSTEM */
3060 #ifdef HAVE_X_WINDOWS
3061 else if (EQ (parameter, Qdisplay) && FRAME_X_P (f))
3062 value = XCAR (FRAME_DISPLAY_INFO (f)->name_list_element);
3063 #endif /* HAVE_X_WINDOWS */
3064 else if (EQ (parameter, Qbackground_color)
3065 || EQ (parameter, Qforeground_color))
3067 value = Fassq (parameter, f->param_alist);
3068 if (CONSP (value))
3070 value = XCDR (value);
3071 /* Fframe_parameters puts the actual fg/bg color names,
3072 even if f->param_alist says otherwise. This is
3073 important when param_alist's notion of colors is
3074 "unspecified". We need to do the same here. */
3075 if (STRINGP (value) && !FRAME_WINDOW_P (f))
3077 Lisp_Object tem = frame_unspecified_color (f, value);
3079 if (!NILP (tem))
3080 value = tem;
3083 else
3084 value = Fcdr (Fassq (parameter, Fframe_parameters (frame)));
3086 else if (EQ (parameter, Qdisplay_type)
3087 || EQ (parameter, Qbackground_mode))
3088 value = Fcdr (Fassq (parameter, f->param_alist));
3089 else
3090 /* FIXME: Avoid this code path at all (as well as code duplication)
3091 by sharing more code with Fframe_parameters. */
3092 value = Fcdr (Fassq (parameter, Fframe_parameters (frame)));
3095 return value;
3099 DEFUN ("modify-frame-parameters", Fmodify_frame_parameters,
3100 Smodify_frame_parameters, 2, 2, 0,
3101 doc: /* Modify FRAME according to new values of its parameters in ALIST.
3102 If FRAME is nil, it defaults to the selected frame.
3103 ALIST is an alist of parameters to change and their new values.
3104 Each element of ALIST has the form (PARM . VALUE), where PARM is a symbol.
3105 Which PARMs are meaningful depends on the kind of frame.
3106 The meaningful parameters are acted upon, i.e. the frame is changed
3107 according to their new values, and are also stored in the frame's
3108 parameter list so that `frame-parameters' will return them.
3109 PARMs that are not meaningful are still stored in the frame's parameter
3110 list, but are otherwise ignored. */)
3111 (Lisp_Object frame, Lisp_Object alist)
3113 struct frame *f = decode_live_frame (frame);
3114 Lisp_Object prop, val;
3116 /* I think this should be done with a hook. */
3117 #ifdef HAVE_WINDOW_SYSTEM
3118 if (FRAME_WINDOW_P (f))
3119 x_set_frame_parameters (f, alist);
3120 else
3121 #endif
3122 #ifdef MSDOS
3123 if (FRAME_MSDOS_P (f))
3124 IT_set_frame_parameters (f, alist);
3125 else
3126 #endif
3129 EMACS_INT length = XFASTINT (Flength (alist));
3130 ptrdiff_t i;
3131 Lisp_Object *parms;
3132 Lisp_Object *values;
3133 USE_SAFE_ALLOCA;
3134 SAFE_ALLOCA_LISP (parms, 2 * length);
3135 values = parms + length;
3137 /* Extract parm names and values into those vectors. */
3139 for (i = 0; CONSP (alist); alist = XCDR (alist))
3141 Lisp_Object elt;
3143 elt = XCAR (alist);
3144 parms[i] = Fcar (elt);
3145 values[i] = Fcdr (elt);
3146 i++;
3149 /* Now process them in reverse of specified order. */
3150 while (--i >= 0)
3152 prop = parms[i];
3153 val = values[i];
3154 store_frame_param (f, prop, val);
3156 if (EQ (prop, Qforeground_color)
3157 || EQ (prop, Qbackground_color))
3158 update_face_from_frame_parameter (f, prop, val);
3161 SAFE_FREE ();
3163 return Qnil;
3166 DEFUN ("frame-char-height", Fframe_char_height, Sframe_char_height,
3167 0, 1, 0,
3168 doc: /* Height in pixels of a line in the font in frame FRAME.
3169 If FRAME is omitted or nil, the selected frame is used.
3170 For a terminal frame, the value is always 1. */)
3171 (Lisp_Object frame)
3173 #ifdef HAVE_WINDOW_SYSTEM
3174 struct frame *f = decode_any_frame (frame);
3176 if (FRAME_WINDOW_P (f))
3177 return make_number (FRAME_LINE_HEIGHT (f));
3178 else
3179 #endif
3180 return make_number (1);
3184 DEFUN ("frame-char-width", Fframe_char_width, Sframe_char_width,
3185 0, 1, 0,
3186 doc: /* Width in pixels of characters in the font in frame FRAME.
3187 If FRAME is omitted or nil, the selected frame is used.
3188 On a graphical screen, the width is the standard width of the default font.
3189 For a terminal screen, the value is always 1. */)
3190 (Lisp_Object frame)
3192 #ifdef HAVE_WINDOW_SYSTEM
3193 struct frame *f = decode_any_frame (frame);
3195 if (FRAME_WINDOW_P (f))
3196 return make_number (FRAME_COLUMN_WIDTH (f));
3197 else
3198 #endif
3199 return make_number (1);
3202 DEFUN ("frame-native-width", Fframe_native_width,
3203 Sframe_native_width, 0, 1, 0,
3204 doc: /* Return FRAME's native width in pixels.
3205 For a terminal frame, the result really gives the width in characters.
3206 If FRAME is omitted or nil, the selected frame is used. */)
3207 (Lisp_Object frame)
3209 struct frame *f = decode_any_frame (frame);
3211 #ifdef HAVE_WINDOW_SYSTEM
3212 if (FRAME_WINDOW_P (f))
3213 return make_number (FRAME_PIXEL_WIDTH (f));
3214 else
3215 #endif
3216 return make_number (FRAME_TOTAL_COLS (f));
3219 DEFUN ("frame-native-height", Fframe_native_height,
3220 Sframe_native_height, 0, 1, 0,
3221 doc: /* Return FRAME's native height in pixels.
3222 If FRAME is omitted or nil, the selected frame is used. The exact value
3223 of the result depends on the window-system and toolkit in use:
3225 In the Gtk+ and NS versions, it includes only any window (including the
3226 minibuffer or echo area), mode line, and header line. It does not
3227 include the tool bar or menu bar. With other graphical versions, it may
3228 also include the tool bar and the menu bar.
3230 For a text terminal, it includes the menu bar. In this case, the
3231 result is really in characters rather than pixels (i.e., is identical
3232 to `frame-height'). */)
3233 (Lisp_Object frame)
3235 struct frame *f = decode_any_frame (frame);
3237 #ifdef HAVE_WINDOW_SYSTEM
3238 if (FRAME_WINDOW_P (f))
3239 return make_number (FRAME_PIXEL_HEIGHT (f));
3240 else
3241 #endif
3242 return make_number (FRAME_TOTAL_LINES (f));
3245 DEFUN ("tool-bar-pixel-width", Ftool_bar_pixel_width,
3246 Stool_bar_pixel_width, 0, 1, 0,
3247 doc: /* Return width in pixels of FRAME's tool bar.
3248 The result is greater than zero only when the tool bar is on the left
3249 or right side of FRAME. If FRAME is omitted or nil, the selected frame
3250 is used. */)
3251 (Lisp_Object frame)
3253 #ifdef FRAME_TOOLBAR_WIDTH
3254 struct frame *f = decode_any_frame (frame);
3256 if (FRAME_WINDOW_P (f))
3257 return make_number (FRAME_TOOLBAR_WIDTH (f));
3258 #endif
3259 return make_number (0);
3262 DEFUN ("frame-text-cols", Fframe_text_cols, Sframe_text_cols, 0, 1, 0,
3263 doc: /* Return width in columns of FRAME's text area. */)
3264 (Lisp_Object frame)
3266 return make_number (FRAME_COLS (decode_any_frame (frame)));
3269 DEFUN ("frame-text-lines", Fframe_text_lines, Sframe_text_lines, 0, 1, 0,
3270 doc: /* Return height in lines of FRAME's text area. */)
3271 (Lisp_Object frame)
3273 return make_number (FRAME_LINES (decode_any_frame (frame)));
3276 DEFUN ("frame-total-cols", Fframe_total_cols, Sframe_total_cols, 0, 1, 0,
3277 doc: /* Return number of total columns of FRAME. */)
3278 (Lisp_Object frame)
3280 return make_number (FRAME_TOTAL_COLS (decode_any_frame (frame)));
3283 DEFUN ("frame-total-lines", Fframe_total_lines, Sframe_total_lines, 0, 1, 0,
3284 doc: /* Return number of total lines of FRAME. */)
3285 (Lisp_Object frame)
3287 return make_number (FRAME_TOTAL_LINES (decode_any_frame (frame)));
3290 DEFUN ("frame-text-width", Fframe_text_width, Sframe_text_width, 0, 1, 0,
3291 doc: /* Return text area width of FRAME in pixels. */)
3292 (Lisp_Object frame)
3294 return make_number (FRAME_TEXT_WIDTH (decode_any_frame (frame)));
3297 DEFUN ("frame-text-height", Fframe_text_height, Sframe_text_height, 0, 1, 0,
3298 doc: /* Return text area height of FRAME in pixels. */)
3299 (Lisp_Object frame)
3301 return make_number (FRAME_TEXT_HEIGHT (decode_any_frame (frame)));
3304 DEFUN ("frame-scroll-bar-width", Fscroll_bar_width, Sscroll_bar_width, 0, 1, 0,
3305 doc: /* Return scroll bar width of FRAME in pixels. */)
3306 (Lisp_Object frame)
3308 return make_number (FRAME_SCROLL_BAR_AREA_WIDTH (decode_any_frame (frame)));
3311 DEFUN ("frame-scroll-bar-height", Fscroll_bar_height, Sscroll_bar_height, 0, 1, 0,
3312 doc: /* Return scroll bar height of FRAME in pixels. */)
3313 (Lisp_Object frame)
3315 return make_number (FRAME_SCROLL_BAR_AREA_HEIGHT (decode_any_frame (frame)));
3318 DEFUN ("frame-fringe-width", Ffringe_width, Sfringe_width, 0, 1, 0,
3319 doc: /* Return fringe width of FRAME in pixels. */)
3320 (Lisp_Object frame)
3322 return make_number (FRAME_TOTAL_FRINGE_WIDTH (decode_any_frame (frame)));
3325 DEFUN ("frame-internal-border-width", Fframe_internal_border_width, Sframe_internal_border_width, 0, 1, 0,
3326 doc: /* Return width of FRAME's internal border in pixels. */)
3327 (Lisp_Object frame)
3329 return make_number (FRAME_INTERNAL_BORDER_WIDTH (decode_any_frame (frame)));
3332 DEFUN ("frame-right-divider-width", Fright_divider_width, Sright_divider_width, 0, 1, 0,
3333 doc: /* Return width (in pixels) of vertical window dividers on FRAME. */)
3334 (Lisp_Object frame)
3336 return make_number (FRAME_RIGHT_DIVIDER_WIDTH (decode_any_frame (frame)));
3339 DEFUN ("frame-bottom-divider-width", Fbottom_divider_width, Sbottom_divider_width, 0, 1, 0,
3340 doc: /* Return width (in pixels) of horizontal window dividers on FRAME. */)
3341 (Lisp_Object frame)
3343 return make_number (FRAME_BOTTOM_DIVIDER_WIDTH (decode_any_frame (frame)));
3346 DEFUN ("set-frame-height", Fset_frame_height, Sset_frame_height, 2, 4, 0,
3347 doc: /* Set text height of frame FRAME to HEIGHT lines.
3348 Optional third arg PRETEND non-nil means that redisplay should use
3349 HEIGHT lines but that the idea of the actual height of the frame should
3350 not be changed.
3352 Optional fourth argument PIXELWISE non-nil means that FRAME should be
3353 HEIGHT pixels high. Note: When `frame-resize-pixelwise' is nil, some
3354 window managers may refuse to honor a HEIGHT that is not an integer
3355 multiple of the default frame font height. */)
3356 (Lisp_Object frame, Lisp_Object height, Lisp_Object pretend, Lisp_Object pixelwise)
3358 struct frame *f = decode_live_frame (frame);
3359 int pixel_height;
3361 CHECK_TYPE_RANGED_INTEGER (int, height);
3363 pixel_height = (!NILP (pixelwise)
3364 ? XINT (height)
3365 : XINT (height) * FRAME_LINE_HEIGHT (f));
3366 adjust_frame_size (f, -1, pixel_height, 1, !NILP (pretend), Qheight);
3368 return Qnil;
3371 DEFUN ("set-frame-width", Fset_frame_width, Sset_frame_width, 2, 4, 0,
3372 doc: /* Set text width of frame FRAME to WIDTH columns.
3373 Optional third arg PRETEND non-nil means that redisplay should use WIDTH
3374 columns but that the idea of the actual width of the frame should not
3375 be changed.
3377 Optional fourth argument PIXELWISE non-nil means that FRAME should be
3378 WIDTH pixels wide. Note: When `frame-resize-pixelwise' is nil, some
3379 window managers may refuse to honor a WIDTH that is not an integer
3380 multiple of the default frame font width. */)
3381 (Lisp_Object frame, Lisp_Object width, Lisp_Object pretend, Lisp_Object pixelwise)
3383 struct frame *f = decode_live_frame (frame);
3384 int pixel_width;
3386 CHECK_TYPE_RANGED_INTEGER (int, width);
3388 pixel_width = (!NILP (pixelwise)
3389 ? XINT (width)
3390 : XINT (width) * FRAME_COLUMN_WIDTH (f));
3391 adjust_frame_size (f, pixel_width, -1, 1, !NILP (pretend), Qwidth);
3393 return Qnil;
3396 DEFUN ("set-frame-size", Fset_frame_size, Sset_frame_size, 3, 4, 0,
3397 doc: /* Set text size of FRAME to WIDTH by HEIGHT, measured in characters.
3398 Optional argument PIXELWISE non-nil means to measure in pixels. Note:
3399 When `frame-resize-pixelwise' is nil, some window managers may refuse to
3400 honor a WIDTH that is not an integer multiple of the default frame font
3401 width or a HEIGHT that is not an integer multiple of the default frame
3402 font height. */)
3403 (Lisp_Object frame, Lisp_Object width, Lisp_Object height, Lisp_Object pixelwise)
3405 struct frame *f = decode_live_frame (frame);
3406 int pixel_width, pixel_height;
3408 CHECK_TYPE_RANGED_INTEGER (int, width);
3409 CHECK_TYPE_RANGED_INTEGER (int, height);
3411 pixel_width = (!NILP (pixelwise)
3412 ? XINT (width)
3413 : XINT (width) * FRAME_COLUMN_WIDTH (f));
3414 pixel_height = (!NILP (pixelwise)
3415 ? XINT (height)
3416 : XINT (height) * FRAME_LINE_HEIGHT (f));
3417 adjust_frame_size (f, pixel_width, pixel_height, 1, 0, Qsize);
3419 return Qnil;
3422 DEFUN ("frame-position", Fframe_position,
3423 Sframe_position, 0, 1, 0,
3424 doc: /* Return top left corner of FRAME in pixels.
3425 FRAME must be a live frame and defaults to the selected one. The return
3426 value is a cons (x, y) of the coordinates of the top left corner of
3427 FRAME's outer frame, in pixels relative to an origin (0, 0) of FRAME's
3428 display. */)
3429 (Lisp_Object frame)
3431 register struct frame *f = decode_live_frame (frame);
3433 return Fcons (make_number (f->left_pos), make_number (f->top_pos));
3436 DEFUN ("set-frame-position", Fset_frame_position,
3437 Sset_frame_position, 3, 3, 0,
3438 doc: /* Set position of FRAME to (X, Y).
3439 FRAME must be a live frame and defaults to the selected one. X and Y,
3440 if positive, specify the coordinate of the left and top edge of FRAME's
3441 outer frame in pixels relative to an origin (0, 0) of FRAME's display.
3442 If any of X or Y is negative, it specifies the coordinates of the right
3443 or bottom edge of the outer frame of FRAME relative to the right or
3444 bottom edge of FRAME's display. */)
3445 (Lisp_Object frame, Lisp_Object x, Lisp_Object y)
3447 struct frame *f = decode_live_frame (frame);
3449 CHECK_TYPE_RANGED_INTEGER (int, x);
3450 CHECK_TYPE_RANGED_INTEGER (int, y);
3452 /* I think this should be done with a hook. */
3453 if (FRAME_WINDOW_P (f))
3455 #ifdef HAVE_WINDOW_SYSTEM
3456 x_set_offset (f, XINT (x), XINT (y), 1);
3457 #endif
3460 return Qt;
3463 /***********************************************************************
3464 Frame Parameters
3465 ***********************************************************************/
3467 /* Connect the frame-parameter names for X frames
3468 to the ways of passing the parameter values to the window system.
3470 The name of a parameter, as a Lisp symbol,
3471 has an `x-frame-parameter' property which is an integer in Lisp
3472 that is an index in this table. */
3474 struct frame_parm_table {
3475 const char *name;
3476 int sym;
3479 static const struct frame_parm_table frame_parms[] =
3481 {"auto-raise", SYMBOL_INDEX (Qauto_raise)},
3482 {"auto-lower", SYMBOL_INDEX (Qauto_lower)},
3483 {"background-color", -1},
3484 {"border-color", SYMBOL_INDEX (Qborder_color)},
3485 {"border-width", SYMBOL_INDEX (Qborder_width)},
3486 {"cursor-color", SYMBOL_INDEX (Qcursor_color)},
3487 {"cursor-type", SYMBOL_INDEX (Qcursor_type)},
3488 {"font", -1},
3489 {"foreground-color", -1},
3490 {"icon-name", SYMBOL_INDEX (Qicon_name)},
3491 {"icon-type", SYMBOL_INDEX (Qicon_type)},
3492 {"internal-border-width", SYMBOL_INDEX (Qinternal_border_width)},
3493 {"right-divider-width", SYMBOL_INDEX (Qright_divider_width)},
3494 {"bottom-divider-width", SYMBOL_INDEX (Qbottom_divider_width)},
3495 {"menu-bar-lines", SYMBOL_INDEX (Qmenu_bar_lines)},
3496 {"mouse-color", SYMBOL_INDEX (Qmouse_color)},
3497 {"name", SYMBOL_INDEX (Qname)},
3498 {"scroll-bar-width", SYMBOL_INDEX (Qscroll_bar_width)},
3499 {"scroll-bar-height", SYMBOL_INDEX (Qscroll_bar_height)},
3500 {"title", SYMBOL_INDEX (Qtitle)},
3501 {"unsplittable", SYMBOL_INDEX (Qunsplittable)},
3502 {"vertical-scroll-bars", SYMBOL_INDEX (Qvertical_scroll_bars)},
3503 {"horizontal-scroll-bars", SYMBOL_INDEX (Qhorizontal_scroll_bars)},
3504 {"visibility", SYMBOL_INDEX (Qvisibility)},
3505 {"tool-bar-lines", SYMBOL_INDEX (Qtool_bar_lines)},
3506 {"scroll-bar-foreground", SYMBOL_INDEX (Qscroll_bar_foreground)},
3507 {"scroll-bar-background", SYMBOL_INDEX (Qscroll_bar_background)},
3508 {"screen-gamma", SYMBOL_INDEX (Qscreen_gamma)},
3509 {"line-spacing", SYMBOL_INDEX (Qline_spacing)},
3510 {"left-fringe", SYMBOL_INDEX (Qleft_fringe)},
3511 {"right-fringe", SYMBOL_INDEX (Qright_fringe)},
3512 {"wait-for-wm", SYMBOL_INDEX (Qwait_for_wm)},
3513 {"fullscreen", SYMBOL_INDEX (Qfullscreen)},
3514 {"font-backend", SYMBOL_INDEX (Qfont_backend)},
3515 {"alpha", SYMBOL_INDEX (Qalpha)},
3516 {"sticky", SYMBOL_INDEX (Qsticky)},
3517 {"tool-bar-position", SYMBOL_INDEX (Qtool_bar_position)},
3518 {"inhibit-double-buffering", SYMBOL_INDEX (Qinhibit_double_buffering)},
3519 {"undecorated", SYMBOL_INDEX (Qundecorated)},
3520 {"parent-frame", SYMBOL_INDEX (Qparent_frame)},
3521 {"skip-taskbar", SYMBOL_INDEX (Qskip_taskbar)},
3522 {"no-focus-on-map", SYMBOL_INDEX (Qno_focus_on_map)},
3523 {"no-accept-focus", SYMBOL_INDEX (Qno_accept_focus)},
3524 {"z-group", SYMBOL_INDEX (Qz_group)},
3525 {"override-redirect", SYMBOL_INDEX (Qoverride_redirect)},
3526 {"no-special-glyphs", SYMBOL_INDEX (Qno_special_glyphs)},
3527 #ifdef NS_IMPL_COCOA
3528 {"ns-appearance", SYMBOL_INDEX (Qns_appearance)},
3529 {"ns-transparent-titlebar", SYMBOL_INDEX (Qns_transparent_titlebar)},
3530 #endif
3533 #ifdef HAVE_WINDOW_SYSTEM
3535 /* Enumeration type for switch in frame_float. */
3536 enum frame_float_type
3538 FRAME_FLOAT_WIDTH,
3539 FRAME_FLOAT_HEIGHT,
3540 FRAME_FLOAT_LEFT,
3541 FRAME_FLOAT_TOP
3545 * frame_float:
3547 * Process the value VAL of the float type frame parameter 'width',
3548 * 'height', 'left', or 'top' specified via a frame_float_type
3549 * enumeration type WHAT for frame F. Such parameters relate the outer
3550 * size or position of F to the size of the F's display or parent frame
3551 * which have to be both available in some way.
3553 * The return value is a size or position value in pixels. VAL must be
3554 * in the range 0.0 to 1.0 where a width/height of 0.0 means to return 0
3555 * and 1.0 means to return the full width/height of the display/parent.
3556 * For positions, 0.0 means position in the left/top corner of the
3557 * display/parent while 1.0 means to position at the right/bottom corner
3558 * of the display/parent frame.
3560 * Set PARENT_DONE and OUTER_DONE to avoid recalculation of the outer
3561 * size or parent or display attributes when more float parameters are
3562 * calculated in a row: -1 means not processed yet, 0 means processing
3563 * failed, 1 means processing succeeded.
3565 * Return DEFAULT_VALUE when processing fails for whatever reason with
3566 * one exception: When calculating F's outer edges fails (probably
3567 * because F has not been created yet) return the difference between F's
3568 * native and text size.
3570 static int
3571 frame_float (struct frame *f, Lisp_Object val, enum frame_float_type what,
3572 int *parent_done, int *outer_done, int default_value)
3574 double d_val = XFLOAT_DATA (val);
3576 if (d_val < 0.0 || d_val > 1.0)
3577 /* Invalid VAL. */
3578 return default_value;
3579 else
3581 static unsigned parent_width, parent_height;
3582 static int parent_left, parent_top;
3583 static unsigned outer_minus_text_width, outer_minus_text_height;
3584 struct frame *p = FRAME_PARENT_FRAME (f);
3586 if (*parent_done == 1)
3588 else if (p)
3590 parent_width = FRAME_PIXEL_WIDTH (p);
3591 parent_height = FRAME_PIXEL_HEIGHT (p);
3592 *parent_done = 1;
3594 else
3596 if (*parent_done == 0)
3597 /* No workarea available. */
3598 return default_value;
3599 else if (*parent_done == -1)
3601 Lisp_Object monitor_attributes;
3602 Lisp_Object workarea;
3603 Lisp_Object frame;
3605 XSETFRAME (frame, f);
3606 monitor_attributes = Fcar (call1 (Qdisplay_monitor_attributes_list, frame));
3607 if (NILP (monitor_attributes))
3609 /* No monitor attributes available. */
3610 *parent_done = 0;
3612 return default_value;
3615 workarea = Fcdr (Fassq (Qworkarea, monitor_attributes));
3616 if (NILP (workarea))
3618 /* No workarea available. */
3619 *parent_done = 0;
3621 return default_value;
3624 /* Workarea available. */
3625 parent_left = XINT (Fnth (make_number (0), workarea));
3626 parent_top = XINT (Fnth (make_number (1), workarea));
3627 parent_width = XINT (Fnth (make_number (2), workarea));
3628 parent_height = XINT (Fnth (make_number (3), workarea));
3629 *parent_done = 1;
3633 if (*outer_done == 1)
3635 else if (FRAME_UNDECORATED (f))
3637 outer_minus_text_width
3638 = FRAME_PIXEL_WIDTH (f) - FRAME_TEXT_WIDTH (f);
3639 outer_minus_text_height
3640 = FRAME_PIXEL_HEIGHT (f) - FRAME_TEXT_HEIGHT (f);
3641 *outer_done = 1;
3643 else if (*outer_done == 0)
3644 /* No outer size available. */
3645 return default_value;
3646 else if (*outer_done == -1)
3648 Lisp_Object frame, outer_edges;
3650 XSETFRAME (frame, f);
3651 outer_edges = call2 (Qframe_edges, frame, Qouter_edges);
3653 if (!NILP (outer_edges))
3655 outer_minus_text_width
3656 = (XINT (Fnth (make_number (2), outer_edges))
3657 - XINT (Fnth (make_number (0), outer_edges))
3658 - FRAME_TEXT_WIDTH (f));
3659 outer_minus_text_height
3660 = (XINT (Fnth (make_number (3), outer_edges))
3661 - XINT (Fnth (make_number (1), outer_edges))
3662 - FRAME_TEXT_HEIGHT (f));
3664 else
3666 /* If we can't get any outer edges, proceed as if the frame
3667 were undecorated. */
3668 outer_minus_text_width
3669 = FRAME_PIXEL_WIDTH (f) - FRAME_TEXT_WIDTH (f);
3670 outer_minus_text_height
3671 = FRAME_PIXEL_HEIGHT (f) - FRAME_TEXT_HEIGHT (f);
3674 *outer_done = 1;
3677 switch (what)
3679 case FRAME_FLOAT_WIDTH:
3680 return parent_width * d_val - outer_minus_text_width;
3682 case FRAME_FLOAT_HEIGHT:
3683 return parent_height * d_val - outer_minus_text_height;
3685 case FRAME_FLOAT_LEFT:
3687 int rest_width = (parent_width
3688 - FRAME_TEXT_WIDTH (f)
3689 - outer_minus_text_width);
3691 if (p)
3692 return (rest_width <= 0 ? 0 : d_val * rest_width);
3693 else
3694 return (rest_width <= 0
3695 ? parent_left
3696 : parent_left + d_val * rest_width);
3698 case FRAME_FLOAT_TOP:
3700 int rest_height = (parent_height
3701 - FRAME_TEXT_HEIGHT (f)
3702 - outer_minus_text_height);
3704 if (p)
3705 return (rest_height <= 0 ? 0 : d_val * rest_height);
3706 else
3707 return (rest_height <= 0
3708 ? parent_top
3709 : parent_top + d_val * rest_height);
3711 default:
3712 emacs_abort ();
3717 /* Change the parameters of frame F as specified by ALIST.
3718 If a parameter is not specially recognized, do nothing special;
3719 otherwise call the `x_set_...' function for that parameter.
3720 Except for certain geometry properties, always call store_frame_param
3721 to store the new value in the parameter alist. */
3723 void
3724 x_set_frame_parameters (struct frame *f, Lisp_Object alist)
3726 Lisp_Object tail, frame;
3729 /* If both of these parameters are present, it's more efficient to
3730 set them both at once. So we wait until we've looked at the
3731 entire list before we set them. */
3732 int width = -1, height = -1; /* -1 denotes they were not changed. */
3734 /* Same here. */
3735 Lisp_Object left, top;
3737 /* Same with these. */
3738 Lisp_Object icon_left, icon_top;
3740 /* And with this. */
3741 Lisp_Object fullscreen;
3742 bool fullscreen_change = false;
3744 /* Record in these vectors all the parms specified. */
3745 Lisp_Object *parms;
3746 Lisp_Object *values;
3747 ptrdiff_t i, j, size;
3748 bool left_no_change = 0, top_no_change = 0;
3749 #ifdef HAVE_X_WINDOWS
3750 bool icon_left_no_change = 0, icon_top_no_change = 0;
3751 #endif
3752 int parent_done = -1, outer_done = -1;
3754 XSETFRAME (frame, f);
3755 for (size = 0, tail = alist; CONSP (tail); tail = XCDR (tail))
3756 size++;
3757 CHECK_LIST_END (tail, alist);
3759 USE_SAFE_ALLOCA;
3760 SAFE_ALLOCA_LISP (parms, 2 * size);
3761 values = parms + size;
3763 /* Extract parm names and values into those vectors. */
3765 i = 0, j = size - 1;
3766 for (tail = alist; CONSP (tail); tail = XCDR (tail))
3768 Lisp_Object elt = XCAR (tail), prop = Fcar (elt), val = Fcdr (elt);
3770 /* Some properties are independent of other properties, but other
3771 properties are dependent upon them. These special properties
3772 are foreground_color, background_color (affects cursor_color)
3773 and font (affects fringe widths); they're recorded starting
3774 from the end of PARMS and VALUES to process them first by using
3775 reverse iteration. */
3777 if (EQ (prop, Qforeground_color)
3778 || EQ (prop, Qbackground_color)
3779 || EQ (prop, Qfont))
3781 parms[j] = prop;
3782 values[j] = val;
3783 j--;
3785 else
3787 parms[i] = prop;
3788 values[i] = val;
3789 i++;
3793 /* TAIL and ALIST are not used again below here. */
3794 alist = tail = Qnil;
3796 top = left = Qunbound;
3797 icon_left = icon_top = Qunbound;
3799 /* Reverse order is used to make sure that special
3800 properties noticed above are processed first. */
3801 for (i = size - 1; i >= 0; i--)
3803 Lisp_Object prop, val;
3805 prop = parms[i];
3806 val = values[i];
3808 if (EQ (prop, Qwidth))
3810 if (RANGED_INTEGERP (0, val, INT_MAX))
3811 width = XFASTINT (val) * FRAME_COLUMN_WIDTH (f) ;
3812 else if (CONSP (val) && EQ (XCAR (val), Qtext_pixels)
3813 && RANGED_INTEGERP (0, XCDR (val), INT_MAX))
3814 width = XFASTINT (XCDR (val));
3815 else if (FLOATP (val))
3816 width = frame_float (f, val, FRAME_FLOAT_WIDTH, &parent_done,
3817 &outer_done, -1);
3819 else if (EQ (prop, Qheight))
3821 if (RANGED_INTEGERP (0, val, INT_MAX))
3822 height = XFASTINT (val) * FRAME_LINE_HEIGHT (f);
3823 else if (CONSP (val) && EQ (XCAR (val), Qtext_pixels)
3824 && RANGED_INTEGERP (0, XCDR (val), INT_MAX))
3825 height = XFASTINT (XCDR (val));
3826 else if (FLOATP (val))
3827 height = frame_float (f, val, FRAME_FLOAT_HEIGHT, &parent_done,
3828 &outer_done, -1);
3830 else if (EQ (prop, Qtop))
3831 top = val;
3832 else if (EQ (prop, Qleft))
3833 left = val;
3834 else if (EQ (prop, Qicon_top))
3835 icon_top = val;
3836 else if (EQ (prop, Qicon_left))
3837 icon_left = val;
3838 else if (EQ (prop, Qfullscreen))
3840 fullscreen = val;
3841 fullscreen_change = true;
3843 else
3845 register Lisp_Object param_index, old_value;
3847 old_value = get_frame_param (f, prop);
3849 store_frame_param (f, prop, val);
3851 param_index = Fget (prop, Qx_frame_parameter);
3852 if (NATNUMP (param_index)
3853 && XFASTINT (param_index) < ARRAYELTS (frame_parms)
3854 && FRAME_RIF (f)->frame_parm_handlers[XINT (param_index)])
3855 (*(FRAME_RIF (f)->frame_parm_handlers[XINT (param_index)])) (f, val, old_value);
3859 /* Don't die if just one of these was set. */
3860 if (EQ (left, Qunbound))
3862 left_no_change = 1;
3863 if (f->left_pos < 0)
3864 left = list2 (Qplus, make_number (f->left_pos));
3865 else
3866 XSETINT (left, f->left_pos);
3868 if (EQ (top, Qunbound))
3870 top_no_change = 1;
3871 if (f->top_pos < 0)
3872 top = list2 (Qplus, make_number (f->top_pos));
3873 else
3874 XSETINT (top, f->top_pos);
3877 /* If one of the icon positions was not set, preserve or default it. */
3878 if (! TYPE_RANGED_INTEGERP (int, icon_left))
3880 #ifdef HAVE_X_WINDOWS
3881 icon_left_no_change = 1;
3882 #endif
3883 icon_left = Fcdr (Fassq (Qicon_left, f->param_alist));
3884 if (NILP (icon_left))
3885 XSETINT (icon_left, 0);
3887 if (! TYPE_RANGED_INTEGERP (int, icon_top))
3889 #ifdef HAVE_X_WINDOWS
3890 icon_top_no_change = 1;
3891 #endif
3892 icon_top = Fcdr (Fassq (Qicon_top, f->param_alist));
3893 if (NILP (icon_top))
3894 XSETINT (icon_top, 0);
3897 /* Don't set these parameters unless they've been explicitly
3898 specified. The window might be mapped or resized while we're in
3899 this function, and we don't want to override that unless the lisp
3900 code has asked for it.
3902 Don't set these parameters unless they actually differ from the
3903 window's current parameters; the window may not actually exist
3904 yet. */
3905 if ((width != -1 && width != FRAME_TEXT_WIDTH (f))
3906 || (height != -1 && height != FRAME_TEXT_HEIGHT (f)))
3907 /* We could consider checking f->after_make_frame here, but I
3908 don't have the faintest idea why the following is needed at
3909 all. With the old setting it can get a Heisenbug when
3910 EmacsFrameResize intermittently provokes a delayed
3911 change_frame_size in the middle of adjust_frame_size. */
3912 /** || (f->can_x_set_window_size && (f->new_height || f->new_width))) **/
3913 adjust_frame_size (f, width, height, 1, 0, Qx_set_frame_parameters);
3915 if ((!NILP (left) || !NILP (top))
3916 && ! (left_no_change && top_no_change)
3917 && ! (NUMBERP (left) && XINT (left) == f->left_pos
3918 && NUMBERP (top) && XINT (top) == f->top_pos))
3920 int leftpos = 0;
3921 int toppos = 0;
3923 /* Record the signs. */
3924 f->size_hint_flags &= ~ (XNegative | YNegative);
3925 if (EQ (left, Qminus))
3926 f->size_hint_flags |= XNegative;
3927 else if (TYPE_RANGED_INTEGERP (int, left))
3929 leftpos = XINT (left);
3930 if (leftpos < 0)
3931 f->size_hint_flags |= XNegative;
3933 else if (CONSP (left) && EQ (XCAR (left), Qminus)
3934 && CONSP (XCDR (left))
3935 && RANGED_INTEGERP (-INT_MAX, XCAR (XCDR (left)), INT_MAX))
3937 leftpos = - XINT (XCAR (XCDR (left)));
3938 f->size_hint_flags |= XNegative;
3940 else if (CONSP (left) && EQ (XCAR (left), Qplus)
3941 && CONSP (XCDR (left))
3942 && TYPE_RANGED_INTEGERP (int, XCAR (XCDR (left))))
3943 leftpos = XINT (XCAR (XCDR (left)));
3944 else if (FLOATP (left))
3945 leftpos = frame_float (f, left, FRAME_FLOAT_LEFT, &parent_done,
3946 &outer_done, 0);
3948 if (EQ (top, Qminus))
3949 f->size_hint_flags |= YNegative;
3950 else if (TYPE_RANGED_INTEGERP (int, top))
3952 toppos = XINT (top);
3953 if (toppos < 0)
3954 f->size_hint_flags |= YNegative;
3956 else if (CONSP (top) && EQ (XCAR (top), Qminus)
3957 && CONSP (XCDR (top))
3958 && RANGED_INTEGERP (-INT_MAX, XCAR (XCDR (top)), INT_MAX))
3960 toppos = - XINT (XCAR (XCDR (top)));
3961 f->size_hint_flags |= YNegative;
3963 else if (CONSP (top) && EQ (XCAR (top), Qplus)
3964 && CONSP (XCDR (top))
3965 && TYPE_RANGED_INTEGERP (int, XCAR (XCDR (top))))
3966 toppos = XINT (XCAR (XCDR (top)));
3967 else if (FLOATP (top))
3968 toppos = frame_float (f, top, FRAME_FLOAT_TOP, &parent_done,
3969 &outer_done, 0);
3971 /* Store the numeric value of the position. */
3972 f->top_pos = toppos;
3973 f->left_pos = leftpos;
3975 f->win_gravity = NorthWestGravity;
3977 /* Actually set that position, and convert to absolute. */
3978 x_set_offset (f, leftpos, toppos, -1);
3981 if (fullscreen_change)
3983 Lisp_Object old_value = get_frame_param (f, Qfullscreen);
3985 frame_size_history_add
3986 (f, Qx_set_fullscreen, 0, 0, list2 (old_value, fullscreen));
3988 store_frame_param (f, Qfullscreen, fullscreen);
3989 if (!EQ (fullscreen, old_value))
3990 x_set_fullscreen (f, fullscreen, old_value);
3994 #ifdef HAVE_X_WINDOWS
3995 if ((!NILP (icon_left) || !NILP (icon_top))
3996 && ! (icon_left_no_change && icon_top_no_change))
3997 x_wm_set_icon_position (f, XINT (icon_left), XINT (icon_top));
3998 #endif /* HAVE_X_WINDOWS */
4000 SAFE_FREE ();
4004 /* Insert a description of internally-recorded parameters of frame X
4005 into the parameter alist *ALISTPTR that is to be given to the user.
4006 Only parameters that are specific to the X window system
4007 and whose values are not correctly recorded in the frame's
4008 param_alist need to be considered here. */
4010 void
4011 x_report_frame_params (struct frame *f, Lisp_Object *alistptr)
4013 Lisp_Object tem;
4014 uprintmax_t w;
4015 char buf[INT_BUFSIZE_BOUND (w)];
4017 /* Represent negative positions (off the top or left screen edge)
4018 in a way that Fmodify_frame_parameters will understand correctly. */
4019 XSETINT (tem, f->left_pos);
4020 if (f->left_pos >= 0)
4021 store_in_alist (alistptr, Qleft, tem);
4022 else
4023 store_in_alist (alistptr, Qleft, list2 (Qplus, tem));
4025 XSETINT (tem, f->top_pos);
4026 if (f->top_pos >= 0)
4027 store_in_alist (alistptr, Qtop, tem);
4028 else
4029 store_in_alist (alistptr, Qtop, list2 (Qplus, tem));
4031 store_in_alist (alistptr, Qborder_width,
4032 make_number (f->border_width));
4033 store_in_alist (alistptr, Qinternal_border_width,
4034 make_number (FRAME_INTERNAL_BORDER_WIDTH (f)));
4035 store_in_alist (alistptr, Qright_divider_width,
4036 make_number (FRAME_RIGHT_DIVIDER_WIDTH (f)));
4037 store_in_alist (alistptr, Qbottom_divider_width,
4038 make_number (FRAME_BOTTOM_DIVIDER_WIDTH (f)));
4039 store_in_alist (alistptr, Qleft_fringe,
4040 make_number (FRAME_LEFT_FRINGE_WIDTH (f)));
4041 store_in_alist (alistptr, Qright_fringe,
4042 make_number (FRAME_RIGHT_FRINGE_WIDTH (f)));
4043 store_in_alist (alistptr, Qscroll_bar_width,
4044 (! FRAME_HAS_VERTICAL_SCROLL_BARS (f)
4045 ? make_number (0)
4046 : FRAME_CONFIG_SCROLL_BAR_WIDTH (f) > 0
4047 ? make_number (FRAME_CONFIG_SCROLL_BAR_WIDTH (f))
4048 /* nil means "use default width"
4049 for non-toolkit scroll bar.
4050 ruler-mode.el depends on this. */
4051 : Qnil));
4052 store_in_alist (alistptr, Qscroll_bar_height,
4053 (! FRAME_HAS_HORIZONTAL_SCROLL_BARS (f)
4054 ? make_number (0)
4055 : FRAME_CONFIG_SCROLL_BAR_HEIGHT (f) > 0
4056 ? make_number (FRAME_CONFIG_SCROLL_BAR_HEIGHT (f))
4057 /* nil means "use default height"
4058 for non-toolkit scroll bar. */
4059 : Qnil));
4060 /* FRAME_X_WINDOW is not guaranteed to return an integer. E.g., on
4061 MS-Windows it returns a value whose type is HANDLE, which is
4062 actually a pointer. Explicit casting avoids compiler
4063 warnings. */
4064 w = (uintptr_t) FRAME_X_WINDOW (f);
4065 store_in_alist (alistptr, Qwindow_id,
4066 make_formatted_string (buf, "%"pMu, w));
4067 #ifdef HAVE_X_WINDOWS
4068 #ifdef USE_X_TOOLKIT
4069 /* Tooltip frame may not have this widget. */
4070 if (FRAME_X_OUTPUT (f)->widget)
4071 #endif
4072 w = (uintptr_t) FRAME_OUTER_WINDOW (f);
4073 store_in_alist (alistptr, Qouter_window_id,
4074 make_formatted_string (buf, "%"pMu, w));
4075 #endif
4076 store_in_alist (alistptr, Qicon_name, f->icon_name);
4077 store_in_alist (alistptr, Qvisibility,
4078 (FRAME_VISIBLE_P (f) ? Qt
4079 : FRAME_ICONIFIED_P (f) ? Qicon : Qnil));
4080 store_in_alist (alistptr, Qdisplay,
4081 XCAR (FRAME_DISPLAY_INFO (f)->name_list_element));
4083 if (FRAME_X_OUTPUT (f)->parent_desc == FRAME_DISPLAY_INFO (f)->root_window)
4084 tem = Qnil;
4085 else
4086 tem = make_natnum ((uintptr_t) FRAME_X_OUTPUT (f)->parent_desc);
4087 store_in_alist (alistptr, Qexplicit_name, (f->explicit_name ? Qt : Qnil));
4088 store_in_alist (alistptr, Qparent_id, tem);
4089 store_in_alist (alistptr, Qtool_bar_position, FRAME_TOOL_BAR_POSITION (f));
4093 /* Change the `fullscreen' frame parameter of frame F. OLD_VALUE is
4094 the previous value of that parameter, NEW_VALUE is the new value. */
4096 void
4097 x_set_fullscreen (struct frame *f, Lisp_Object new_value, Lisp_Object old_value)
4099 if (NILP (new_value))
4100 f->want_fullscreen = FULLSCREEN_NONE;
4101 else if (EQ (new_value, Qfullboth) || EQ (new_value, Qfullscreen))
4102 f->want_fullscreen = FULLSCREEN_BOTH;
4103 else if (EQ (new_value, Qfullwidth))
4104 f->want_fullscreen = FULLSCREEN_WIDTH;
4105 else if (EQ (new_value, Qfullheight))
4106 f->want_fullscreen = FULLSCREEN_HEIGHT;
4107 else if (EQ (new_value, Qmaximized))
4108 f->want_fullscreen = FULLSCREEN_MAXIMIZED;
4110 if (FRAME_TERMINAL (f)->fullscreen_hook != NULL)
4111 FRAME_TERMINAL (f)->fullscreen_hook (f);
4115 /* Change the `line-spacing' frame parameter of frame F. OLD_VALUE is
4116 the previous value of that parameter, NEW_VALUE is the new value. */
4118 void
4119 x_set_line_spacing (struct frame *f, Lisp_Object new_value, Lisp_Object old_value)
4121 if (NILP (new_value))
4122 f->extra_line_spacing = 0;
4123 else if (RANGED_INTEGERP (0, new_value, INT_MAX))
4124 f->extra_line_spacing = XFASTINT (new_value);
4125 else if (FLOATP (new_value))
4127 int new_spacing = XFLOAT_DATA (new_value) * FRAME_LINE_HEIGHT (f) + 0.5;
4129 if (new_spacing >= 0)
4130 f->extra_line_spacing = new_spacing;
4131 else
4132 signal_error ("Invalid line-spacing", new_value);
4134 else
4135 signal_error ("Invalid line-spacing", new_value);
4136 if (FRAME_VISIBLE_P (f))
4137 redraw_frame (f);
4141 /* Change the `screen-gamma' frame parameter of frame F. OLD_VALUE is
4142 the previous value of that parameter, NEW_VALUE is the new value. */
4144 void
4145 x_set_screen_gamma (struct frame *f, Lisp_Object new_value, Lisp_Object old_value)
4147 Lisp_Object bgcolor;
4149 if (NILP (new_value))
4150 f->gamma = 0;
4151 else if (NUMBERP (new_value) && XFLOATINT (new_value) > 0)
4152 /* The value 0.4545 is the normal viewing gamma. */
4153 f->gamma = 1.0 / (0.4545 * XFLOATINT (new_value));
4154 else
4155 signal_error ("Invalid screen-gamma", new_value);
4157 /* Apply the new gamma value to the frame background. */
4158 bgcolor = Fassq (Qbackground_color, f->param_alist);
4159 if (CONSP (bgcolor) && (bgcolor = XCDR (bgcolor), STRINGP (bgcolor)))
4161 Lisp_Object parm_index = Fget (Qbackground_color, Qx_frame_parameter);
4162 if (NATNUMP (parm_index)
4163 && XFASTINT (parm_index) < ARRAYELTS (frame_parms)
4164 && FRAME_RIF (f)->frame_parm_handlers[XFASTINT (parm_index)])
4165 (*FRAME_RIF (f)->frame_parm_handlers[XFASTINT (parm_index)])
4166 (f, bgcolor, Qnil);
4169 clear_face_cache (true); /* FIXME: Why of all frames? */
4170 fset_redisplay (f);
4174 void
4175 x_set_font (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
4177 Lisp_Object font_object;
4178 int fontset = -1;
4179 #ifdef HAVE_X_WINDOWS
4180 Lisp_Object font_param = arg;
4181 #endif
4183 /* Set the frame parameter back to the old value because we may
4184 fail to use ARG as the new parameter value. */
4185 store_frame_param (f, Qfont, oldval);
4187 /* ARG is a fontset name, a font name, a cons of fontset name and a
4188 font object, or a font object. In the last case, this function
4189 never fail. */
4190 if (STRINGP (arg))
4192 fontset = fs_query_fontset (arg, 0);
4193 if (fontset < 0)
4195 font_object = font_open_by_name (f, arg);
4196 if (NILP (font_object))
4197 error ("Font `%s' is not defined", SSDATA (arg));
4198 arg = AREF (font_object, FONT_NAME_INDEX);
4200 else if (fontset > 0)
4202 font_object = font_open_by_name (f, fontset_ascii (fontset));
4203 if (NILP (font_object))
4204 error ("Font `%s' is not defined", SDATA (arg));
4205 arg = AREF (font_object, FONT_NAME_INDEX);
4207 else
4208 error ("The default fontset can't be used for a frame font");
4210 else if (CONSP (arg) && STRINGP (XCAR (arg)) && FONT_OBJECT_P (XCDR (arg)))
4212 /* This is the case that the ASCII font of F's fontset XCAR
4213 (arg) is changed to the font XCDR (arg) by
4214 `set-fontset-font'. */
4215 fontset = fs_query_fontset (XCAR (arg), 0);
4216 if (fontset < 0)
4217 error ("Unknown fontset: %s", SDATA (XCAR (arg)));
4218 font_object = XCDR (arg);
4219 arg = AREF (font_object, FONT_NAME_INDEX);
4220 #ifdef HAVE_X_WINDOWS
4221 font_param = Ffont_get (font_object, QCname);
4222 #endif
4224 else if (FONT_OBJECT_P (arg))
4226 font_object = arg;
4227 #ifdef HAVE_X_WINDOWS
4228 font_param = Ffont_get (font_object, QCname);
4229 #endif
4230 /* This is to store the XLFD font name in the frame parameter for
4231 backward compatibility. We should store the font-object
4232 itself in the future. */
4233 arg = AREF (font_object, FONT_NAME_INDEX);
4234 fontset = FRAME_FONTSET (f);
4235 /* Check if we can use the current fontset. If not, set FONTSET
4236 to -1 to generate a new fontset from FONT-OBJECT. */
4237 if (fontset >= 0)
4239 Lisp_Object ascii_font = fontset_ascii (fontset);
4240 Lisp_Object spec = font_spec_from_name (ascii_font);
4242 /* SPEC might be nil because ASCII_FONT's name doesn't parse
4243 according to stupid XLFD rules, which, for example,
4244 disallow font names that include a dash followed by a
4245 number. So in those cases we simply request x_new_font
4246 below to generate a new fontset. */
4247 if (NILP (spec) || ! font_match_p (spec, font_object))
4248 fontset = -1;
4251 else
4252 signal_error ("Invalid font", arg);
4254 if (! NILP (Fequal (font_object, oldval)))
4255 return;
4257 x_new_font (f, font_object, fontset);
4258 store_frame_param (f, Qfont, arg);
4259 #ifdef HAVE_X_WINDOWS
4260 store_frame_param (f, Qfont_parameter, font_param);
4261 #endif
4262 /* Recalculate toolbar height. */
4263 f->n_tool_bar_rows = 0;
4265 /* Ensure we redraw it. */
4266 clear_current_matrices (f);
4268 /* Attempt to hunt down bug#16028. */
4269 SET_FRAME_GARBAGED (f);
4271 /* This is important if we are called by some Lisp as part of
4272 redisplaying the frame, see redisplay_internal. */
4273 f->fonts_changed = true;
4275 recompute_basic_faces (f);
4277 do_pending_window_change (0);
4279 /* We used to call face-set-after-frame-default here, but it leads to
4280 recursive calls (since that function can set the `default' face's
4281 font which in turns changes the frame's `font' parameter).
4282 Also I don't know what this call is meant to do, but it seems the
4283 wrong way to do it anyway (it does a lot more work than what seems
4284 reasonable in response to a change to `font'). */
4288 void
4289 x_set_font_backend (struct frame *f, Lisp_Object new_value, Lisp_Object old_value)
4291 if (! NILP (new_value)
4292 && !CONSP (new_value))
4294 char *p0, *p1;
4296 CHECK_STRING (new_value);
4297 p0 = p1 = SSDATA (new_value);
4298 new_value = Qnil;
4299 while (*p0)
4301 while (*p1 && ! c_isspace (*p1) && *p1 != ',') p1++;
4302 if (p0 < p1)
4303 new_value = Fcons (Fintern (make_string (p0, p1 - p0), Qnil),
4304 new_value);
4305 if (*p1)
4307 int c;
4309 while ((c = *++p1) && c_isspace (c));
4311 p0 = p1;
4313 new_value = Fnreverse (new_value);
4316 if (! NILP (old_value) && ! NILP (Fequal (old_value, new_value)))
4317 return;
4319 if (FRAME_FONT (f))
4320 free_all_realized_faces (Qnil);
4322 new_value = font_update_drivers (f, NILP (new_value) ? Qt : new_value);
4323 if (NILP (new_value))
4325 if (NILP (old_value))
4326 error ("No font backend available");
4327 font_update_drivers (f, old_value);
4328 error ("None of specified font backends are available");
4330 store_frame_param (f, Qfont_backend, new_value);
4332 if (FRAME_FONT (f))
4334 Lisp_Object frame;
4336 XSETFRAME (frame, f);
4337 x_set_font (f, Fframe_parameter (frame, Qfont), Qnil);
4338 face_change = true;
4339 windows_or_buffers_changed = 18;
4343 void
4344 x_set_left_fringe (struct frame *f, Lisp_Object new_value, Lisp_Object old_value)
4346 int unit = FRAME_COLUMN_WIDTH (f);
4347 int old_width = FRAME_LEFT_FRINGE_WIDTH (f);
4348 int new_width;
4350 new_width = (RANGED_INTEGERP (-INT_MAX, new_value, INT_MAX)
4351 ? eabs (XINT (new_value)) : 8);
4353 if (new_width != old_width)
4355 f->left_fringe_width = new_width;
4356 f->fringe_cols /* Round up. */
4357 = (new_width + FRAME_RIGHT_FRINGE_WIDTH (f) + unit - 1) / unit;
4359 if (FRAME_X_WINDOW (f) != 0)
4360 adjust_frame_size (f, -1, -1, 3, 0, Qleft_fringe);
4362 SET_FRAME_GARBAGED (f);
4367 void
4368 x_set_right_fringe (struct frame *f, Lisp_Object new_value, Lisp_Object old_value)
4370 int unit = FRAME_COLUMN_WIDTH (f);
4371 int old_width = FRAME_RIGHT_FRINGE_WIDTH (f);
4372 int new_width;
4374 new_width = (RANGED_INTEGERP (-INT_MAX, new_value, INT_MAX)
4375 ? eabs (XINT (new_value)) : 8);
4377 if (new_width != old_width)
4379 f->right_fringe_width = new_width;
4380 f->fringe_cols /* Round up. */
4381 = (new_width + FRAME_LEFT_FRINGE_WIDTH (f) + unit - 1) / unit;
4383 if (FRAME_X_WINDOW (f) != 0)
4384 adjust_frame_size (f, -1, -1, 3, 0, Qright_fringe);
4386 SET_FRAME_GARBAGED (f);
4391 void
4392 x_set_border_width (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
4394 CHECK_TYPE_RANGED_INTEGER (int, arg);
4396 if (XINT (arg) == f->border_width)
4397 return;
4399 if (FRAME_X_WINDOW (f) != 0)
4400 error ("Cannot change the border width of a frame");
4402 f->border_width = XINT (arg);
4405 void
4406 x_set_right_divider_width (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
4408 int old = FRAME_RIGHT_DIVIDER_WIDTH (f);
4409 CHECK_TYPE_RANGED_INTEGER (int, arg);
4410 int new = max (0, XINT (arg));
4411 if (new != old)
4413 f->right_divider_width = new;
4414 adjust_frame_size (f, -1, -1, 4, 0, Qright_divider_width);
4415 adjust_frame_glyphs (f);
4416 SET_FRAME_GARBAGED (f);
4420 void
4421 x_set_bottom_divider_width (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
4423 int old = FRAME_BOTTOM_DIVIDER_WIDTH (f);
4424 CHECK_TYPE_RANGED_INTEGER (int, arg);
4425 int new = max (0, XINT (arg));
4426 if (new != old)
4428 f->bottom_divider_width = new;
4429 adjust_frame_size (f, -1, -1, 4, 0, Qbottom_divider_width);
4430 adjust_frame_glyphs (f);
4431 SET_FRAME_GARBAGED (f);
4435 void
4436 x_set_visibility (struct frame *f, Lisp_Object value, Lisp_Object oldval)
4438 Lisp_Object frame;
4439 XSETFRAME (frame, f);
4441 if (NILP (value))
4442 Fmake_frame_invisible (frame, Qt);
4443 else if (EQ (value, Qicon))
4444 Ficonify_frame (frame);
4445 else
4446 Fmake_frame_visible (frame);
4449 void
4450 x_set_autoraise (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
4452 f->auto_raise = !EQ (Qnil, arg);
4455 void
4456 x_set_autolower (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
4458 f->auto_lower = !EQ (Qnil, arg);
4461 void
4462 x_set_unsplittable (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
4464 f->no_split = !NILP (arg);
4467 void
4468 x_set_vertical_scroll_bars (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
4470 if ((EQ (arg, Qleft) && FRAME_HAS_VERTICAL_SCROLL_BARS_ON_RIGHT (f))
4471 || (EQ (arg, Qright) && FRAME_HAS_VERTICAL_SCROLL_BARS_ON_LEFT (f))
4472 || (NILP (arg) && FRAME_HAS_VERTICAL_SCROLL_BARS (f))
4473 || (!NILP (arg) && !FRAME_HAS_VERTICAL_SCROLL_BARS (f)))
4475 FRAME_VERTICAL_SCROLL_BAR_TYPE (f)
4476 = (NILP (arg)
4477 ? vertical_scroll_bar_none
4478 : EQ (Qleft, arg)
4479 ? vertical_scroll_bar_left
4480 : EQ (Qright, arg)
4481 ? vertical_scroll_bar_right
4482 : EQ (Qleft, Vdefault_frame_scroll_bars)
4483 ? vertical_scroll_bar_left
4484 : EQ (Qright, Vdefault_frame_scroll_bars)
4485 ? vertical_scroll_bar_right
4486 : vertical_scroll_bar_none);
4488 /* We set this parameter before creating the X window for the
4489 frame, so we can get the geometry right from the start.
4490 However, if the window hasn't been created yet, we shouldn't
4491 call x_set_window_size. */
4492 if (FRAME_X_WINDOW (f))
4493 adjust_frame_size (f, -1, -1, 3, 0, Qvertical_scroll_bars);
4495 SET_FRAME_GARBAGED (f);
4499 void
4500 x_set_horizontal_scroll_bars (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
4502 #if USE_HORIZONTAL_SCROLL_BARS
4503 if ((NILP (arg) && FRAME_HAS_HORIZONTAL_SCROLL_BARS (f))
4504 || (!NILP (arg) && !FRAME_HAS_HORIZONTAL_SCROLL_BARS (f)))
4506 f->horizontal_scroll_bars = NILP (arg) ? false : true;
4508 /* We set this parameter before creating the X window for the
4509 frame, so we can get the geometry right from the start.
4510 However, if the window hasn't been created yet, we shouldn't
4511 call x_set_window_size. */
4512 if (FRAME_X_WINDOW (f))
4513 adjust_frame_size (f, -1, -1, 3, 0, Qhorizontal_scroll_bars);
4515 SET_FRAME_GARBAGED (f);
4517 #endif
4520 void
4521 x_set_scroll_bar_width (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
4523 int unit = FRAME_COLUMN_WIDTH (f);
4525 if (NILP (arg))
4527 x_set_scroll_bar_default_width (f);
4529 if (FRAME_X_WINDOW (f))
4530 adjust_frame_size (f, -1, -1, 3, 0, Qscroll_bar_width);
4532 SET_FRAME_GARBAGED (f);
4534 else if (RANGED_INTEGERP (1, arg, INT_MAX)
4535 && XFASTINT (arg) != FRAME_CONFIG_SCROLL_BAR_WIDTH (f))
4537 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = XFASTINT (arg);
4538 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (XFASTINT (arg) + unit - 1) / unit;
4539 if (FRAME_X_WINDOW (f))
4540 adjust_frame_size (f, -1, -1, 3, 0, Qscroll_bar_width);
4542 SET_FRAME_GARBAGED (f);
4545 XWINDOW (FRAME_SELECTED_WINDOW (f))->cursor.hpos = 0;
4546 XWINDOW (FRAME_SELECTED_WINDOW (f))->cursor.x = 0;
4549 void
4550 x_set_scroll_bar_height (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
4552 #if USE_HORIZONTAL_SCROLL_BARS
4553 int unit = FRAME_LINE_HEIGHT (f);
4555 if (NILP (arg))
4557 x_set_scroll_bar_default_height (f);
4559 if (FRAME_X_WINDOW (f))
4560 adjust_frame_size (f, -1, -1, 3, 0, Qscroll_bar_height);
4562 SET_FRAME_GARBAGED (f);
4564 else if (RANGED_INTEGERP (1, arg, INT_MAX)
4565 && XFASTINT (arg) != FRAME_CONFIG_SCROLL_BAR_HEIGHT (f))
4567 FRAME_CONFIG_SCROLL_BAR_HEIGHT (f) = XFASTINT (arg);
4568 FRAME_CONFIG_SCROLL_BAR_LINES (f) = (XFASTINT (arg) + unit - 1) / unit;
4569 if (FRAME_X_WINDOW (f))
4570 adjust_frame_size (f, -1, -1, 3, 0, Qscroll_bar_height);
4572 SET_FRAME_GARBAGED (f);
4575 XWINDOW (FRAME_SELECTED_WINDOW (f))->cursor.vpos = 0;
4576 XWINDOW (FRAME_SELECTED_WINDOW (f))->cursor.y = 0;
4577 #endif
4580 void
4581 x_set_alpha (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
4583 double alpha = 1.0;
4584 double newval[2];
4585 int i;
4586 Lisp_Object item;
4588 for (i = 0; i < 2; i++)
4590 newval[i] = 1.0;
4591 if (CONSP (arg))
4593 item = CAR (arg);
4594 arg = CDR (arg);
4596 else
4597 item = arg;
4599 if (NILP (item))
4600 alpha = - 1.0;
4601 else if (FLOATP (item))
4603 alpha = XFLOAT_DATA (item);
4604 if (! (0 <= alpha && alpha <= 1.0))
4605 args_out_of_range (make_float (0.0), make_float (1.0));
4607 else if (INTEGERP (item))
4609 EMACS_INT ialpha = XINT (item);
4610 if (! (0 <= ialpha && ialpha <= 100))
4611 args_out_of_range (make_number (0), make_number (100));
4612 alpha = ialpha / 100.0;
4614 else
4615 wrong_type_argument (Qnumberp, item);
4616 newval[i] = alpha;
4619 for (i = 0; i < 2; i++)
4620 f->alpha[i] = newval[i];
4622 #if defined (HAVE_X_WINDOWS) || defined (HAVE_NTGUI) || defined (NS_IMPL_COCOA)
4623 block_input ();
4624 x_set_frame_alpha (f);
4625 unblock_input ();
4626 #endif
4628 return;
4633 * x_set_no_special_glyphs:
4635 * Set frame F's `no-special-glyphs' parameter which, if non-nil,
4636 * suppresses the display of truncation and continuation glyphs
4637 * outside fringes.
4639 void
4640 x_set_no_special_glyphs (struct frame *f, Lisp_Object new_value, Lisp_Object old_value)
4642 if (!EQ (new_value, old_value))
4643 FRAME_NO_SPECIAL_GLYPHS (f) = !NILP (new_value);
4647 #ifndef HAVE_NS
4649 /* Non-zero if mouse is grabbed on DPYINFO
4650 and we know the frame where it is. */
4652 bool x_mouse_grabbed (Display_Info *dpyinfo)
4654 return (dpyinfo->grabbed
4655 && dpyinfo->last_mouse_frame
4656 && FRAME_LIVE_P (dpyinfo->last_mouse_frame));
4659 /* Re-highlight something with mouse-face properties
4660 on DPYINFO using saved frame and mouse position. */
4662 void
4663 x_redo_mouse_highlight (Display_Info *dpyinfo)
4665 if (dpyinfo->last_mouse_motion_frame
4666 && FRAME_LIVE_P (dpyinfo->last_mouse_motion_frame))
4667 note_mouse_highlight (dpyinfo->last_mouse_motion_frame,
4668 dpyinfo->last_mouse_motion_x,
4669 dpyinfo->last_mouse_motion_y);
4672 #endif /* HAVE_NS */
4674 /* Subroutines of creating an X frame. */
4676 /* Make sure that Vx_resource_name is set to a reasonable value.
4677 Fix it up, or set it to `emacs' if it is too hopeless. */
4679 void
4680 validate_x_resource_name (void)
4682 ptrdiff_t len = 0;
4683 /* Number of valid characters in the resource name. */
4684 ptrdiff_t good_count = 0;
4685 /* Number of invalid characters in the resource name. */
4686 ptrdiff_t bad_count = 0;
4687 Lisp_Object new;
4688 ptrdiff_t i;
4690 if (!STRINGP (Vx_resource_class))
4691 Vx_resource_class = build_string (EMACS_CLASS);
4693 if (STRINGP (Vx_resource_name))
4695 unsigned char *p = SDATA (Vx_resource_name);
4697 len = SBYTES (Vx_resource_name);
4699 /* Only letters, digits, - and _ are valid in resource names.
4700 Count the valid characters and count the invalid ones. */
4701 for (i = 0; i < len; i++)
4703 int c = p[i];
4704 if (! ((c >= 'a' && c <= 'z')
4705 || (c >= 'A' && c <= 'Z')
4706 || (c >= '0' && c <= '9')
4707 || c == '-' || c == '_'))
4708 bad_count++;
4709 else
4710 good_count++;
4713 else
4714 /* Not a string => completely invalid. */
4715 bad_count = 5, good_count = 0;
4717 /* If name is valid already, return. */
4718 if (bad_count == 0)
4719 return;
4721 /* If name is entirely invalid, or nearly so, or is so implausibly
4722 large that alloca might not work, use `emacs'. */
4723 if (good_count < 2 || MAX_ALLOCA - sizeof ".customization" < len)
4725 Vx_resource_name = build_string ("emacs");
4726 return;
4729 /* Name is partly valid. Copy it and replace the invalid characters
4730 with underscores. */
4732 Vx_resource_name = new = Fcopy_sequence (Vx_resource_name);
4734 for (i = 0; i < len; i++)
4736 int c = SREF (new, i);
4737 if (! ((c >= 'a' && c <= 'z')
4738 || (c >= 'A' && c <= 'Z')
4739 || (c >= '0' && c <= '9')
4740 || c == '-' || c == '_'))
4741 SSET (new, i, '_');
4745 /* Get specified attribute from resource database RDB.
4746 See Fx_get_resource below for other parameters. */
4748 static Lisp_Object
4749 xrdb_get_resource (XrmDatabase rdb, Lisp_Object attribute, Lisp_Object class, Lisp_Object component, Lisp_Object subclass)
4751 CHECK_STRING (attribute);
4752 CHECK_STRING (class);
4754 if (!NILP (component))
4755 CHECK_STRING (component);
4756 if (!NILP (subclass))
4757 CHECK_STRING (subclass);
4758 if (NILP (component) != NILP (subclass))
4759 error ("x-get-resource: must specify both COMPONENT and SUBCLASS or neither");
4761 validate_x_resource_name ();
4763 /* Allocate space for the components, the dots which separate them,
4764 and the final '\0'. Make them big enough for the worst case. */
4765 ptrdiff_t name_keysize = (SBYTES (Vx_resource_name)
4766 + (STRINGP (component)
4767 ? SBYTES (component) : 0)
4768 + SBYTES (attribute)
4769 + 3);
4771 ptrdiff_t class_keysize = (SBYTES (Vx_resource_class)
4772 + SBYTES (class)
4773 + (STRINGP (subclass)
4774 ? SBYTES (subclass) : 0)
4775 + 3);
4776 USE_SAFE_ALLOCA;
4777 char *name_key = SAFE_ALLOCA (name_keysize + class_keysize);
4778 char *class_key = name_key + name_keysize;
4780 /* Start with emacs.FRAMENAME for the name (the specific one)
4781 and with `Emacs' for the class key (the general one). */
4782 char *nz = lispstpcpy (name_key, Vx_resource_name);
4783 char *cz = lispstpcpy (class_key, Vx_resource_class);
4785 *cz++ = '.';
4786 cz = lispstpcpy (cz, class);
4788 if (!NILP (component))
4790 *cz++ = '.';
4791 lispstpcpy (cz, subclass);
4793 *nz++ = '.';
4794 nz = lispstpcpy (nz, component);
4797 *nz++ = '.';
4798 lispstpcpy (nz, attribute);
4800 char *value = x_get_string_resource (rdb, name_key, class_key);
4801 SAFE_FREE();
4803 if (value && *value)
4804 return build_string (value);
4805 else
4806 return Qnil;
4810 DEFUN ("x-get-resource", Fx_get_resource, Sx_get_resource, 2, 4, 0,
4811 doc: /* Return the value of ATTRIBUTE, of class CLASS, from the X defaults database.
4812 This uses `INSTANCE.ATTRIBUTE' as the key and `Emacs.CLASS' as the
4813 class, where INSTANCE is the name under which Emacs was invoked, or
4814 the name specified by the `-name' or `-rn' command-line arguments.
4816 The optional arguments COMPONENT and SUBCLASS add to the key and the
4817 class, respectively. You must specify both of them or neither.
4818 If you specify them, the key is `INSTANCE.COMPONENT.ATTRIBUTE'
4819 and the class is `Emacs.CLASS.SUBCLASS'. */)
4820 (Lisp_Object attribute, Lisp_Object class, Lisp_Object component,
4821 Lisp_Object subclass)
4823 check_window_system (NULL);
4825 return xrdb_get_resource (check_x_display_info (Qnil)->xrdb,
4826 attribute, class, component, subclass);
4829 /* Get an X resource, like Fx_get_resource, but for display DPYINFO. */
4831 Lisp_Object
4832 display_x_get_resource (Display_Info *dpyinfo, Lisp_Object attribute,
4833 Lisp_Object class, Lisp_Object component,
4834 Lisp_Object subclass)
4836 return xrdb_get_resource (dpyinfo->xrdb,
4837 attribute, class, component, subclass);
4840 #if defined HAVE_X_WINDOWS && !defined USE_X_TOOLKIT && !defined USE_GTK
4841 /* Used when C code wants a resource value. */
4842 /* Called from oldXMenu/Create.c. */
4843 char *
4844 x_get_resource_string (const char *attribute, const char *class)
4846 char *result;
4847 struct frame *sf = SELECTED_FRAME ();
4848 ptrdiff_t invocation_namelen = SBYTES (Vinvocation_name);
4849 USE_SAFE_ALLOCA;
4851 /* Allocate space for the components, the dots which separate them,
4852 and the final '\0'. */
4853 ptrdiff_t name_keysize = invocation_namelen + strlen (attribute) + 2;
4854 ptrdiff_t class_keysize = sizeof (EMACS_CLASS) - 1 + strlen (class) + 2;
4855 char *name_key = SAFE_ALLOCA (name_keysize + class_keysize);
4856 char *class_key = name_key + name_keysize;
4858 esprintf (name_key, "%s.%s", SSDATA (Vinvocation_name), attribute);
4859 sprintf (class_key, "%s.%s", EMACS_CLASS, class);
4861 result = x_get_string_resource (FRAME_DISPLAY_INFO (sf)->xrdb,
4862 name_key, class_key);
4863 SAFE_FREE ();
4864 return result;
4866 #endif
4868 /* Return the value of parameter PARAM.
4870 First search ALIST, then Vdefault_frame_alist, then the X defaults
4871 database, using ATTRIBUTE as the attribute name and CLASS as its class.
4873 Convert the resource to the type specified by desired_type.
4875 If no default is specified, return Qunbound. If you call
4876 x_get_arg, make sure you deal with Qunbound in a reasonable way,
4877 and don't let it get stored in any Lisp-visible variables! */
4879 Lisp_Object
4880 x_get_arg (Display_Info *dpyinfo, Lisp_Object alist, Lisp_Object param,
4881 const char *attribute, const char *class, enum resource_types type)
4883 Lisp_Object tem;
4885 tem = Fassq (param, alist);
4887 if (!NILP (tem))
4889 /* If we find this parm in ALIST, clear it out
4890 so that it won't be "left over" at the end. */
4891 Lisp_Object tail;
4892 XSETCAR (tem, Qnil);
4893 /* In case the parameter appears more than once in the alist,
4894 clear it out. */
4895 for (tail = alist; CONSP (tail); tail = XCDR (tail))
4896 if (CONSP (XCAR (tail))
4897 && EQ (XCAR (XCAR (tail)), param))
4898 XSETCAR (XCAR (tail), Qnil);
4900 else
4901 tem = Fassq (param, Vdefault_frame_alist);
4903 /* If it wasn't specified in ALIST or the Lisp-level defaults,
4904 look in the X resources. */
4905 if (EQ (tem, Qnil))
4907 if (attribute && dpyinfo)
4909 AUTO_STRING (at, attribute);
4910 AUTO_STRING (cl, class);
4911 tem = display_x_get_resource (dpyinfo, at, cl, Qnil, Qnil);
4913 if (NILP (tem))
4914 return Qunbound;
4916 switch (type)
4918 case RES_TYPE_NUMBER:
4919 return make_number (atoi (SSDATA (tem)));
4921 case RES_TYPE_BOOLEAN_NUMBER:
4922 if (!strcmp (SSDATA (tem), "on")
4923 || !strcmp (SSDATA (tem), "true"))
4924 return make_number (1);
4925 return make_number (atoi (SSDATA (tem)));
4926 break;
4928 case RES_TYPE_FLOAT:
4929 return make_float (atof (SSDATA (tem)));
4931 case RES_TYPE_BOOLEAN:
4932 tem = Fdowncase (tem);
4933 if (!strcmp (SSDATA (tem), "on")
4934 #ifdef HAVE_NS
4935 || !strcmp (SSDATA (tem), "yes")
4936 #endif
4937 || !strcmp (SSDATA (tem), "true"))
4938 return Qt;
4939 else
4940 return Qnil;
4942 case RES_TYPE_STRING:
4943 return tem;
4945 case RES_TYPE_SYMBOL:
4946 /* As a special case, we map the values `true' and `on'
4947 to Qt, and `false' and `off' to Qnil. */
4949 Lisp_Object lower;
4950 lower = Fdowncase (tem);
4951 if (!strcmp (SSDATA (lower), "on")
4952 #ifdef HAVE_NS
4953 || !strcmp (SSDATA (lower), "yes")
4954 #endif
4955 || !strcmp (SSDATA (lower), "true"))
4956 return Qt;
4957 else if (!strcmp (SSDATA (lower), "off")
4958 #ifdef HAVE_NS
4959 || !strcmp (SSDATA (lower), "no")
4960 #endif
4961 || !strcmp (SSDATA (lower), "false"))
4962 return Qnil;
4963 else
4964 return Fintern (tem, Qnil);
4967 default:
4968 emacs_abort ();
4971 else
4972 return Qunbound;
4974 return Fcdr (tem);
4977 static Lisp_Object
4978 x_frame_get_arg (struct frame *f, Lisp_Object alist, Lisp_Object param,
4979 const char *attribute, const char *class,
4980 enum resource_types type)
4982 return x_get_arg (FRAME_DISPLAY_INFO (f),
4983 alist, param, attribute, class, type);
4986 /* Like x_frame_get_arg, but also record the value in f->param_alist. */
4988 Lisp_Object
4989 x_frame_get_and_record_arg (struct frame *f, Lisp_Object alist,
4990 Lisp_Object param,
4991 const char *attribute, const char *class,
4992 enum resource_types type)
4994 Lisp_Object value;
4996 value = x_get_arg (FRAME_DISPLAY_INFO (f), alist, param,
4997 attribute, class, type);
4998 if (! NILP (value) && ! EQ (value, Qunbound))
4999 store_frame_param (f, param, value);
5001 return value;
5005 /* Record in frame F the specified or default value according to ALIST
5006 of the parameter named PROP (a Lisp symbol).
5007 If no value is specified for PROP, look for an X default for XPROP
5008 on the frame named NAME.
5009 If that is not found either, use the value DEFLT. */
5011 Lisp_Object
5012 x_default_parameter (struct frame *f, Lisp_Object alist, Lisp_Object prop,
5013 Lisp_Object deflt, const char *xprop, const char *xclass,
5014 enum resource_types type)
5016 Lisp_Object tem;
5018 tem = x_frame_get_arg (f, alist, prop, xprop, xclass, type);
5019 if (EQ (tem, Qunbound))
5020 tem = deflt;
5021 AUTO_FRAME_ARG (arg, prop, tem);
5022 x_set_frame_parameters (f, arg);
5023 return tem;
5027 #if !defined (HAVE_X_WINDOWS) && defined (NoValue)
5030 * XParseGeometry parses strings of the form
5031 * "=<width>x<height>{+-}<xoffset>{+-}<yoffset>", where
5032 * width, height, xoffset, and yoffset are unsigned integers.
5033 * Example: "=80x24+300-49"
5034 * The equal sign is optional.
5035 * It returns a bitmask that indicates which of the four values
5036 * were actually found in the string. For each value found,
5037 * the corresponding argument is updated; for each value
5038 * not found, the corresponding argument is left unchanged.
5041 static int
5042 XParseGeometry (char *string,
5043 int *x, int *y,
5044 unsigned int *width, unsigned int *height)
5046 int mask = NoValue;
5047 char *strind;
5048 unsigned long tempWidth UNINIT, tempHeight UNINIT;
5049 long int tempX UNINIT, tempY UNINIT;
5050 char *nextCharacter;
5052 if (string == NULL || *string == '\0')
5053 return mask;
5054 if (*string == '=')
5055 string++; /* ignore possible '=' at beg of geometry spec */
5057 strind = string;
5058 if (*strind != '+' && *strind != '-' && *strind != 'x')
5060 tempWidth = strtoul (strind, &nextCharacter, 10);
5061 if (strind == nextCharacter)
5062 return 0;
5063 strind = nextCharacter;
5064 mask |= WidthValue;
5067 if (*strind == 'x' || *strind == 'X')
5069 strind++;
5070 tempHeight = strtoul (strind, &nextCharacter, 10);
5071 if (strind == nextCharacter)
5072 return 0;
5073 strind = nextCharacter;
5074 mask |= HeightValue;
5077 if (*strind == '+' || *strind == '-')
5079 if (*strind == '-')
5080 mask |= XNegative;
5081 tempX = strtol (strind, &nextCharacter, 10);
5082 if (strind == nextCharacter)
5083 return 0;
5084 strind = nextCharacter;
5085 mask |= XValue;
5086 if (*strind == '+' || *strind == '-')
5088 if (*strind == '-')
5089 mask |= YNegative;
5090 tempY = strtol (strind, &nextCharacter, 10);
5091 if (strind == nextCharacter)
5092 return 0;
5093 strind = nextCharacter;
5094 mask |= YValue;
5098 /* If strind isn't at the end of the string then it's an invalid
5099 geometry specification. */
5101 if (*strind != '\0')
5102 return 0;
5104 if (mask & XValue)
5105 *x = clip_to_bounds (INT_MIN, tempX, INT_MAX);
5106 if (mask & YValue)
5107 *y = clip_to_bounds (INT_MIN, tempY, INT_MAX);
5108 if (mask & WidthValue)
5109 *width = min (tempWidth, UINT_MAX);
5110 if (mask & HeightValue)
5111 *height = min (tempHeight, UINT_MAX);
5112 return mask;
5115 #endif /* !defined (HAVE_X_WINDOWS) && defined (NoValue) */
5118 /* NS used to define x-parse-geometry in ns-win.el, but that confused
5119 make-docfile: the documentation string in ns-win.el was used for
5120 x-parse-geometry even in non-NS builds.
5122 With two definitions of x-parse-geometry in this file, various
5123 things still get confused (eg M-x apropos documentation), so that
5124 it is best if the two definitions just share the same doc-string.
5126 DEFUN ("x-parse-geometry", Fx_parse_geometry, Sx_parse_geometry, 1, 1, 0,
5127 doc: /* Parse a display geometry string STRING.
5128 Returns an alist of the form ((top . TOP), (left . LEFT) ... ).
5129 The properties returned may include `top', `left', `height', and `width'.
5130 For X, the value of `left' or `top' may be an integer,
5131 or a list (+ N) meaning N pixels relative to top/left corner,
5132 or a list (- N) meaning -N pixels relative to bottom/right corner.
5133 On Nextstep, this just calls `ns-parse-geometry'. */)
5134 (Lisp_Object string)
5136 int geometry, x, y;
5137 unsigned int width, height;
5138 Lisp_Object result;
5140 CHECK_STRING (string);
5142 #ifdef HAVE_NS
5143 if (strchr (SSDATA (string), ' ') != NULL)
5144 return call1 (Qns_parse_geometry, string);
5145 #endif
5146 geometry = XParseGeometry (SSDATA (string),
5147 &x, &y, &width, &height);
5148 result = Qnil;
5149 if (geometry & XValue)
5151 Lisp_Object element;
5153 if (x >= 0 && (geometry & XNegative))
5154 element = list3 (Qleft, Qminus, make_number (-x));
5155 else if (x < 0 && ! (geometry & XNegative))
5156 element = list3 (Qleft, Qplus, make_number (x));
5157 else
5158 element = Fcons (Qleft, make_number (x));
5159 result = Fcons (element, result);
5162 if (geometry & YValue)
5164 Lisp_Object element;
5166 if (y >= 0 && (geometry & YNegative))
5167 element = list3 (Qtop, Qminus, make_number (-y));
5168 else if (y < 0 && ! (geometry & YNegative))
5169 element = list3 (Qtop, Qplus, make_number (y));
5170 else
5171 element = Fcons (Qtop, make_number (y));
5172 result = Fcons (element, result);
5175 if (geometry & WidthValue)
5176 result = Fcons (Fcons (Qwidth, make_number (width)), result);
5177 if (geometry & HeightValue)
5178 result = Fcons (Fcons (Qheight, make_number (height)), result);
5180 return result;
5184 /* Calculate the desired size and position of frame F.
5185 Return the flags saying which aspects were specified.
5187 Also set the win_gravity and size_hint_flags of F.
5189 Adjust height for toolbar if TOOLBAR_P is 1.
5191 This function does not make the coordinates positive. */
5193 #define DEFAULT_ROWS 36
5194 #define DEFAULT_COLS 80
5196 long
5197 x_figure_window_size (struct frame *f, Lisp_Object parms, bool toolbar_p, int *x_width, int *x_height)
5199 Lisp_Object height, width, user_size, top, left, user_position;
5200 long window_prompting = 0;
5201 Display_Info *dpyinfo = FRAME_DISPLAY_INFO (f);
5202 int parent_done = -1, outer_done = -1;
5204 /* Default values if we fall through.
5205 Actually, if that happens we should get
5206 window manager prompting. */
5207 SET_FRAME_WIDTH (f, DEFAULT_COLS * FRAME_COLUMN_WIDTH (f));
5208 SET_FRAME_COLS (f, DEFAULT_COLS);
5209 SET_FRAME_HEIGHT (f, DEFAULT_ROWS * FRAME_LINE_HEIGHT (f));
5210 SET_FRAME_LINES (f, DEFAULT_ROWS);
5212 /* Window managers expect that if program-specified
5213 positions are not (0,0), they're intentional, not defaults. */
5214 f->top_pos = 0;
5215 f->left_pos = 0;
5217 /* Calculate a tool bar height so that the user gets a text display
5218 area of the size he specified with -g or via .Xdefaults. Later
5219 changes of the tool bar height don't change the frame size. This
5220 is done so that users can create tall Emacs frames without having
5221 to guess how tall the tool bar will get. */
5222 if (toolbar_p && FRAME_TOOL_BAR_LINES (f))
5224 if (frame_default_tool_bar_height)
5225 FRAME_TOOL_BAR_HEIGHT (f) = frame_default_tool_bar_height;
5226 else
5228 int margin, relief;
5230 relief = (tool_bar_button_relief >= 0
5231 ? tool_bar_button_relief
5232 : DEFAULT_TOOL_BAR_BUTTON_RELIEF);
5234 if (RANGED_INTEGERP (1, Vtool_bar_button_margin, INT_MAX))
5235 margin = XFASTINT (Vtool_bar_button_margin);
5236 else if (CONSP (Vtool_bar_button_margin)
5237 && RANGED_INTEGERP (1, XCDR (Vtool_bar_button_margin), INT_MAX))
5238 margin = XFASTINT (XCDR (Vtool_bar_button_margin));
5239 else
5240 margin = 0;
5242 FRAME_TOOL_BAR_HEIGHT (f)
5243 = DEFAULT_TOOL_BAR_IMAGE_HEIGHT + 2 * margin + 2 * relief;
5247 /* Ensure that earlier new_width and new_height settings won't
5248 override what we specify below. */
5249 f->new_width = f->new_height = 0;
5251 height = x_get_arg (dpyinfo, parms, Qheight, 0, 0, RES_TYPE_NUMBER);
5252 width = x_get_arg (dpyinfo, parms, Qwidth, 0, 0, RES_TYPE_NUMBER);
5253 if (!EQ (width, Qunbound) || !EQ (height, Qunbound))
5255 if (!EQ (width, Qunbound))
5257 if (CONSP (width) && EQ (XCAR (width), Qtext_pixels))
5259 CHECK_NUMBER (XCDR (width));
5260 if ((XINT (XCDR (width)) < 0 || XINT (XCDR (width)) > INT_MAX))
5261 xsignal1 (Qargs_out_of_range, XCDR (width));
5263 SET_FRAME_WIDTH (f, XINT (XCDR (width)));
5264 f->inhibit_horizontal_resize = true;
5265 *x_width = XINT (XCDR (width));
5267 else if (FLOATP (width))
5269 double d_width = XFLOAT_DATA (width);
5271 if (d_width < 0.0 || d_width > 1.0)
5272 xsignal1 (Qargs_out_of_range, width);
5273 else
5275 int new_width = frame_float (f, width, FRAME_FLOAT_WIDTH,
5276 &parent_done, &outer_done, -1);
5278 if (new_width > -1)
5279 SET_FRAME_WIDTH (f, new_width);
5282 else
5284 CHECK_NUMBER (width);
5285 if ((XINT (width) < 0 || XINT (width) > INT_MAX))
5286 xsignal1 (Qargs_out_of_range, width);
5288 SET_FRAME_WIDTH (f, XINT (width) * FRAME_COLUMN_WIDTH (f));
5292 if (!EQ (height, Qunbound))
5294 if (CONSP (height) && EQ (XCAR (height), Qtext_pixels))
5296 CHECK_NUMBER (XCDR (height));
5297 if ((XINT (XCDR (height)) < 0 || XINT (XCDR (height)) > INT_MAX))
5298 xsignal1 (Qargs_out_of_range, XCDR (height));
5300 SET_FRAME_HEIGHT (f, XINT (XCDR (height)));
5301 f->inhibit_vertical_resize = true;
5302 *x_height = XINT (XCDR (height));
5304 else if (FLOATP (height))
5306 double d_height = XFLOAT_DATA (height);
5308 if (d_height < 0.0 || d_height > 1.0)
5309 xsignal1 (Qargs_out_of_range, height);
5310 else
5312 int new_height = frame_float (f, height, FRAME_FLOAT_HEIGHT,
5313 &parent_done, &outer_done, -1);
5315 if (new_height > -1)
5316 SET_FRAME_HEIGHT (f, new_height);
5319 else
5321 CHECK_NUMBER (height);
5322 if ((XINT (height) < 0) || (XINT (height) > INT_MAX))
5323 xsignal1 (Qargs_out_of_range, height);
5325 SET_FRAME_HEIGHT (f, XINT (height) * FRAME_LINE_HEIGHT (f));
5329 user_size = x_get_arg (dpyinfo, parms, Quser_size, 0, 0, RES_TYPE_NUMBER);
5330 if (!NILP (user_size) && !EQ (user_size, Qunbound))
5331 window_prompting |= USSize;
5332 else
5333 window_prompting |= PSize;
5336 top = x_get_arg (dpyinfo, parms, Qtop, 0, 0, RES_TYPE_NUMBER);
5337 left = x_get_arg (dpyinfo, parms, Qleft, 0, 0, RES_TYPE_NUMBER);
5338 user_position = x_get_arg (dpyinfo, parms, Quser_position, 0, 0, RES_TYPE_NUMBER);
5339 if (! EQ (top, Qunbound) || ! EQ (left, Qunbound))
5341 if (EQ (top, Qminus))
5343 f->top_pos = 0;
5344 window_prompting |= YNegative;
5346 else if (CONSP (top) && EQ (XCAR (top), Qminus)
5347 && CONSP (XCDR (top))
5348 && RANGED_INTEGERP (-INT_MAX, XCAR (XCDR (top)), INT_MAX))
5350 f->top_pos = - XINT (XCAR (XCDR (top)));
5351 window_prompting |= YNegative;
5353 else if (CONSP (top) && EQ (XCAR (top), Qplus)
5354 && CONSP (XCDR (top))
5355 && TYPE_RANGED_INTEGERP (int, XCAR (XCDR (top))))
5357 f->top_pos = XINT (XCAR (XCDR (top)));
5359 else if (FLOATP (top))
5360 f->top_pos = frame_float (f, top, FRAME_FLOAT_TOP, &parent_done,
5361 &outer_done, 0);
5362 else if (EQ (top, Qunbound))
5363 f->top_pos = 0;
5364 else
5366 CHECK_TYPE_RANGED_INTEGER (int, top);
5367 f->top_pos = XINT (top);
5368 if (f->top_pos < 0)
5369 window_prompting |= YNegative;
5372 if (EQ (left, Qminus))
5374 f->left_pos = 0;
5375 window_prompting |= XNegative;
5377 else if (CONSP (left) && EQ (XCAR (left), Qminus)
5378 && CONSP (XCDR (left))
5379 && RANGED_INTEGERP (-INT_MAX, XCAR (XCDR (left)), INT_MAX))
5381 f->left_pos = - XINT (XCAR (XCDR (left)));
5382 window_prompting |= XNegative;
5384 else if (CONSP (left) && EQ (XCAR (left), Qplus)
5385 && CONSP (XCDR (left))
5386 && TYPE_RANGED_INTEGERP (int, XCAR (XCDR (left))))
5388 f->left_pos = XINT (XCAR (XCDR (left)));
5390 else if (FLOATP (left))
5391 f->left_pos = frame_float (f, left, FRAME_FLOAT_LEFT, &parent_done,
5392 &outer_done, 0);
5393 else if (EQ (left, Qunbound))
5394 f->left_pos = 0;
5395 else
5397 CHECK_TYPE_RANGED_INTEGER (int, left);
5398 f->left_pos = XINT (left);
5399 if (f->left_pos < 0)
5400 window_prompting |= XNegative;
5403 if (!NILP (user_position) && ! EQ (user_position, Qunbound))
5404 window_prompting |= USPosition;
5405 else
5406 window_prompting |= PPosition;
5409 if (window_prompting & XNegative)
5411 if (window_prompting & YNegative)
5412 f->win_gravity = SouthEastGravity;
5413 else
5414 f->win_gravity = NorthEastGravity;
5416 else
5418 if (window_prompting & YNegative)
5419 f->win_gravity = SouthWestGravity;
5420 else
5421 f->win_gravity = NorthWestGravity;
5424 f->size_hint_flags = window_prompting;
5426 return window_prompting;
5431 #endif /* HAVE_WINDOW_SYSTEM */
5433 void
5434 frame_make_pointer_invisible (struct frame *f)
5436 if (! NILP (Vmake_pointer_invisible))
5438 if (f && FRAME_LIVE_P (f) && !f->pointer_invisible
5439 && FRAME_TERMINAL (f)->toggle_invisible_pointer_hook)
5441 f->mouse_moved = 0;
5442 FRAME_TERMINAL (f)->toggle_invisible_pointer_hook (f, 1);
5443 f->pointer_invisible = 1;
5448 void
5449 frame_make_pointer_visible (struct frame *f)
5451 /* We don't check Vmake_pointer_invisible here in case the
5452 pointer was invisible when Vmake_pointer_invisible was set to nil. */
5453 if (f && FRAME_LIVE_P (f) && f->pointer_invisible && f->mouse_moved
5454 && FRAME_TERMINAL (f)->toggle_invisible_pointer_hook)
5456 FRAME_TERMINAL (f)->toggle_invisible_pointer_hook (f, 0);
5457 f->pointer_invisible = 0;
5461 DEFUN ("frame-pointer-visible-p", Fframe_pointer_visible_p,
5462 Sframe_pointer_visible_p, 0, 1, 0,
5463 doc: /* Return t if the mouse pointer displayed on FRAME is visible.
5464 Otherwise it returns nil. FRAME omitted or nil means the
5465 selected frame. This is useful when `make-pointer-invisible' is set. */)
5466 (Lisp_Object frame)
5468 return decode_any_frame (frame)->pointer_invisible ? Qnil : Qt;
5473 /***********************************************************************
5474 Multimonitor data
5475 ***********************************************************************/
5477 #ifdef HAVE_WINDOW_SYSTEM
5479 # if (defined HAVE_NS \
5480 || (!defined USE_GTK && (defined HAVE_XINERAMA || defined HAVE_XRANDR)))
5481 void
5482 free_monitors (struct MonitorInfo *monitors, int n_monitors)
5484 int i;
5485 for (i = 0; i < n_monitors; ++i)
5486 xfree (monitors[i].name);
5487 xfree (monitors);
5489 # endif
5491 Lisp_Object
5492 make_monitor_attribute_list (struct MonitorInfo *monitors,
5493 int n_monitors,
5494 int primary_monitor,
5495 Lisp_Object monitor_frames,
5496 const char *source)
5498 Lisp_Object attributes_list = Qnil;
5499 Lisp_Object primary_monitor_attributes = Qnil;
5500 int i;
5502 for (i = 0; i < n_monitors; ++i)
5504 Lisp_Object geometry, workarea, attributes = Qnil;
5505 struct MonitorInfo *mi = &monitors[i];
5507 if (mi->geom.width == 0) continue;
5509 workarea = list4i (mi->work.x, mi->work.y,
5510 mi->work.width, mi->work.height);
5511 geometry = list4i (mi->geom.x, mi->geom.y,
5512 mi->geom.width, mi->geom.height);
5513 attributes = Fcons (Fcons (Qsource, build_string (source)),
5514 attributes);
5515 attributes = Fcons (Fcons (Qframes, AREF (monitor_frames, i)),
5516 attributes);
5517 attributes = Fcons (Fcons (Qmm_size,
5518 list2i (mi->mm_width, mi->mm_height)),
5519 attributes);
5520 attributes = Fcons (Fcons (Qworkarea, workarea), attributes);
5521 attributes = Fcons (Fcons (Qgeometry, geometry), attributes);
5522 if (mi->name)
5523 attributes = Fcons (Fcons (Qname, make_string (mi->name,
5524 strlen (mi->name))),
5525 attributes);
5527 if (i == primary_monitor)
5528 primary_monitor_attributes = attributes;
5529 else
5530 attributes_list = Fcons (attributes, attributes_list);
5533 if (!NILP (primary_monitor_attributes))
5534 attributes_list = Fcons (primary_monitor_attributes, attributes_list);
5535 return attributes_list;
5538 #endif /* HAVE_WINDOW_SYSTEM */
5541 /***********************************************************************
5542 Initialization
5543 ***********************************************************************/
5545 void
5546 syms_of_frame (void)
5548 DEFSYM (Qframep, "framep");
5549 DEFSYM (Qframe_live_p, "frame-live-p");
5550 DEFSYM (Qframe_windows_min_size, "frame-windows-min-size");
5551 DEFSYM (Qdisplay_monitor_attributes_list, "display-monitor-attributes-list");
5552 DEFSYM (Qwindow__pixel_to_total, "window--pixel-to-total");
5553 DEFSYM (Qexplicit_name, "explicit-name");
5554 DEFSYM (Qheight, "height");
5555 DEFSYM (Qicon, "icon");
5556 DEFSYM (Qminibuffer, "minibuffer");
5557 DEFSYM (Qundecorated, "undecorated");
5558 DEFSYM (Qno_special_glyphs, "no-special-glyphs");
5559 DEFSYM (Qparent_frame, "parent-frame");
5560 DEFSYM (Qskip_taskbar, "skip-taskbar");
5561 DEFSYM (Qno_focus_on_map, "no-focus-on-map");
5562 DEFSYM (Qno_accept_focus, "no-accept-focus");
5563 DEFSYM (Qz_group, "z-group");
5564 DEFSYM (Qoverride_redirect, "override-redirect");
5565 DEFSYM (Qdelete_before, "delete-before");
5566 DEFSYM (Qmodeline, "modeline");
5567 DEFSYM (Qonly, "only");
5568 DEFSYM (Qnone, "none");
5569 DEFSYM (Qwidth, "width");
5570 DEFSYM (Qtext_pixels, "text-pixels");
5571 DEFSYM (Qgeometry, "geometry");
5572 DEFSYM (Qicon_left, "icon-left");
5573 DEFSYM (Qicon_top, "icon-top");
5574 DEFSYM (Qtooltip, "tooltip");
5575 DEFSYM (Quser_position, "user-position");
5576 DEFSYM (Quser_size, "user-size");
5577 DEFSYM (Qwindow_id, "window-id");
5578 #ifdef HAVE_X_WINDOWS
5579 DEFSYM (Qouter_window_id, "outer-window-id");
5580 #endif
5581 DEFSYM (Qparent_id, "parent-id");
5582 DEFSYM (Qx, "x");
5583 DEFSYM (Qw32, "w32");
5584 DEFSYM (Qpc, "pc");
5585 DEFSYM (Qns, "ns");
5586 DEFSYM (Qvisible, "visible");
5587 DEFSYM (Qbuffer_predicate, "buffer-predicate");
5588 DEFSYM (Qbuffer_list, "buffer-list");
5589 DEFSYM (Qburied_buffer_list, "buried-buffer-list");
5590 DEFSYM (Qdisplay_type, "display-type");
5591 DEFSYM (Qbackground_mode, "background-mode");
5592 DEFSYM (Qnoelisp, "noelisp");
5593 DEFSYM (Qtty_color_mode, "tty-color-mode");
5594 DEFSYM (Qtty, "tty");
5595 DEFSYM (Qtty_type, "tty-type");
5597 DEFSYM (Qface_set_after_frame_default, "face-set-after-frame-default");
5599 DEFSYM (Qfullwidth, "fullwidth");
5600 DEFSYM (Qfullheight, "fullheight");
5601 DEFSYM (Qfullboth, "fullboth");
5602 DEFSYM (Qmaximized, "maximized");
5603 DEFSYM (Qx_resource_name, "x-resource-name");
5604 DEFSYM (Qx_frame_parameter, "x-frame-parameter");
5606 DEFSYM (Qworkarea, "workarea");
5607 DEFSYM (Qmm_size, "mm-size");
5608 DEFSYM (Qframes, "frames");
5609 DEFSYM (Qsource, "source");
5611 DEFSYM (Qframe_edges, "frame-edges");
5612 DEFSYM (Qouter_edges, "outer-edges");
5613 DEFSYM (Qouter_position, "outer-position");
5614 DEFSYM (Qouter_size, "outer-size");
5615 DEFSYM (Qnative_edges, "native-edges");
5616 DEFSYM (Qinner_edges, "inner-edges");
5617 DEFSYM (Qexternal_border_size, "external-border-size");
5618 DEFSYM (Qtitle_bar_size, "title-bar-size");
5619 DEFSYM (Qmenu_bar_external, "menu-bar-external");
5620 DEFSYM (Qmenu_bar_size, "menu-bar-size");
5621 DEFSYM (Qtool_bar_external, "tool-bar-external");
5622 DEFSYM (Qtool_bar_size, "tool-bar-size");
5623 /* The following are used for frame_size_history. */
5624 DEFSYM (Qadjust_frame_size_1, "adjust-frame-size-1");
5625 DEFSYM (Qadjust_frame_size_2, "adjust-frame-size-2");
5626 DEFSYM (Qadjust_frame_size_3, "adjust-frame-size-3");
5627 DEFSYM (Qx_set_frame_parameters, "x-set-frame-parameters");
5628 DEFSYM (QEmacsFrameResize, "EmacsFrameResize");
5629 DEFSYM (Qset_frame_size, "set-frame-size");
5630 DEFSYM (Qframe_inhibit_resize, "frame-inhibit-resize");
5631 DEFSYM (Qx_set_fullscreen, "x-set-fullscreen");
5632 DEFSYM (Qx_check_fullscreen, "x-check-fullscreen");
5633 DEFSYM (Qxg_frame_resized, "xg-frame-resized");
5634 DEFSYM (Qxg_frame_set_char_size_1, "xg-frame-set-char-size-1");
5635 DEFSYM (Qxg_frame_set_char_size_2, "xg-frame-set-char-size-2");
5636 DEFSYM (Qxg_frame_set_char_size_3, "xg-frame-set-char-size-3");
5637 DEFSYM (Qx_set_window_size_1, "x-set-window-size-1");
5638 DEFSYM (Qx_set_window_size_2, "x-set-window-size-2");
5639 DEFSYM (Qx_set_window_size_3, "x-set-window-size-3");
5640 DEFSYM (Qxg_change_toolbar_position, "xg-change-toolbar-position");
5641 DEFSYM (Qx_net_wm_state, "x-net-wm-state");
5642 DEFSYM (Qx_handle_net_wm_state, "x-handle-net-wm-state");
5643 DEFSYM (Qtb_size_cb, "tb-size-cb");
5644 DEFSYM (Qupdate_frame_tool_bar, "update-frame-tool-bar");
5645 DEFSYM (Qfree_frame_tool_bar, "free-frame-tool-bar");
5646 DEFSYM (Qx_set_menu_bar_lines, "x-set-menu-bar-lines");
5647 DEFSYM (Qchange_frame_size, "change-frame-size");
5648 DEFSYM (Qxg_frame_set_char_size, "xg-frame-set-char-size");
5649 DEFSYM (Qset_window_configuration, "set-window-configuration");
5650 DEFSYM (Qx_create_frame_1, "x-create-frame-1");
5651 DEFSYM (Qx_create_frame_2, "x-create-frame-2");
5652 DEFSYM (Qterminal_frame, "terminal-frame");
5654 #ifdef HAVE_NS
5655 DEFSYM (Qns_parse_geometry, "ns-parse-geometry");
5656 #endif
5657 #ifdef NS_IMPL_COCOA
5658 DEFSYM (Qns_appearance, "ns-appearance");
5659 DEFSYM (Qns_transparent_titlebar, "ns-transparent-titlebar");
5660 #endif
5662 DEFSYM (Qalpha, "alpha");
5663 DEFSYM (Qauto_lower, "auto-lower");
5664 DEFSYM (Qauto_raise, "auto-raise");
5665 DEFSYM (Qborder_color, "border-color");
5666 DEFSYM (Qborder_width, "border-width");
5667 DEFSYM (Qouter_border_width, "outer-border-width");
5668 DEFSYM (Qbottom_divider_width, "bottom-divider-width");
5669 DEFSYM (Qcursor_color, "cursor-color");
5670 DEFSYM (Qcursor_type, "cursor-type");
5671 DEFSYM (Qfont_backend, "font-backend");
5672 DEFSYM (Qfullscreen, "fullscreen");
5673 DEFSYM (Qhorizontal_scroll_bars, "horizontal-scroll-bars");
5674 DEFSYM (Qicon_name, "icon-name");
5675 DEFSYM (Qicon_type, "icon-type");
5676 DEFSYM (Qinternal_border_width, "internal-border-width");
5677 DEFSYM (Qleft_fringe, "left-fringe");
5678 DEFSYM (Qline_spacing, "line-spacing");
5679 DEFSYM (Qmenu_bar_lines, "menu-bar-lines");
5680 DEFSYM (Qupdate_frame_menubar, "update-frame-menubar");
5681 DEFSYM (Qfree_frame_menubar_1, "free-frame-menubar-1");
5682 DEFSYM (Qfree_frame_menubar_2, "free-frame-menubar-2");
5683 DEFSYM (Qmouse_color, "mouse-color");
5684 DEFSYM (Qname, "name");
5685 DEFSYM (Qright_divider_width, "right-divider-width");
5686 DEFSYM (Qright_fringe, "right-fringe");
5687 DEFSYM (Qscreen_gamma, "screen-gamma");
5688 DEFSYM (Qscroll_bar_background, "scroll-bar-background");
5689 DEFSYM (Qscroll_bar_foreground, "scroll-bar-foreground");
5690 DEFSYM (Qscroll_bar_height, "scroll-bar-height");
5691 DEFSYM (Qscroll_bar_width, "scroll-bar-width");
5692 DEFSYM (Qsticky, "sticky");
5693 DEFSYM (Qtitle, "title");
5694 DEFSYM (Qtool_bar_lines, "tool-bar-lines");
5695 DEFSYM (Qtool_bar_position, "tool-bar-position");
5696 DEFSYM (Qunsplittable, "unsplittable");
5697 DEFSYM (Qvertical_scroll_bars, "vertical-scroll-bars");
5698 DEFSYM (Qvisibility, "visibility");
5699 DEFSYM (Qwait_for_wm, "wait-for-wm");
5700 DEFSYM (Qinhibit_double_buffering, "inhibit-double-buffering");
5701 DEFSYM (Qno_other_frame, "no-other-frame");
5702 DEFSYM (Qbelow, "below");
5703 DEFSYM (Qabove_suspended, "above-suspended");
5704 DEFSYM (Qmin_width, "min-width");
5705 DEFSYM (Qmin_height, "min-height");
5706 DEFSYM (Qmouse_wheel_frame, "mouse-wheel-frame");
5707 DEFSYM (Qkeep_ratio, "keep-ratio");
5708 DEFSYM (Qwidth_only, "width-only");
5709 DEFSYM (Qheight_only, "height-only");
5710 DEFSYM (Qleft_only, "left-only");
5711 DEFSYM (Qtop_only, "top-only");
5714 int i;
5716 for (i = 0; i < ARRAYELTS (frame_parms); i++)
5718 Lisp_Object v = (frame_parms[i].sym < 0
5719 ? intern_c_string (frame_parms[i].name)
5720 : builtin_lisp_symbol (frame_parms[i].sym));
5721 Fput (v, Qx_frame_parameter, make_number (i));
5725 #ifdef HAVE_WINDOW_SYSTEM
5726 DEFVAR_LISP ("x-resource-name", Vx_resource_name,
5727 doc: /* The name Emacs uses to look up X resources.
5728 `x-get-resource' uses this as the first component of the instance name
5729 when requesting resource values.
5730 Emacs initially sets `x-resource-name' to the name under which Emacs
5731 was invoked, or to the value specified with the `-name' or `-rn'
5732 switches, if present.
5734 It may be useful to bind this variable locally around a call
5735 to `x-get-resource'. See also the variable `x-resource-class'. */);
5736 Vx_resource_name = Qnil;
5738 DEFVAR_LISP ("x-resource-class", Vx_resource_class,
5739 doc: /* The class Emacs uses to look up X resources.
5740 `x-get-resource' uses this as the first component of the instance class
5741 when requesting resource values.
5743 Emacs initially sets `x-resource-class' to "Emacs".
5745 Setting this variable permanently is not a reasonable thing to do,
5746 but binding this variable locally around a call to `x-get-resource'
5747 is a reasonable practice. See also the variable `x-resource-name'. */);
5748 Vx_resource_class = build_string (EMACS_CLASS);
5750 DEFVAR_LISP ("frame-alpha-lower-limit", Vframe_alpha_lower_limit,
5751 doc: /* The lower limit of the frame opacity (alpha transparency).
5752 The value should range from 0 (invisible) to 100 (completely opaque).
5753 You can also use a floating number between 0.0 and 1.0. */);
5754 Vframe_alpha_lower_limit = make_number (20);
5755 #endif
5757 DEFVAR_LISP ("default-frame-alist", Vdefault_frame_alist,
5758 doc: /* Alist of default values for frame creation.
5759 These may be set in your init file, like this:
5760 (setq default-frame-alist \\='((width . 80) (height . 55) (menu-bar-lines . 1)))
5761 These override values given in window system configuration data,
5762 including X Windows' defaults database.
5763 For values specific to the first Emacs frame, see `initial-frame-alist'.
5764 For window-system specific values, see `window-system-default-frame-alist'.
5765 For values specific to the separate minibuffer frame, see
5766 `minibuffer-frame-alist'.
5767 The `menu-bar-lines' element of the list controls whether new frames
5768 have menu bars; `menu-bar-mode' works by altering this element.
5769 Setting this variable does not affect existing frames, only new ones. */);
5770 Vdefault_frame_alist = Qnil;
5772 DEFVAR_LISP ("default-frame-scroll-bars", Vdefault_frame_scroll_bars,
5773 doc: /* Default position of vertical scroll bars on this window-system. */);
5774 #ifdef HAVE_WINDOW_SYSTEM
5775 #if defined (HAVE_NTGUI) || defined (NS_IMPL_COCOA) || (defined (USE_GTK) && defined (USE_TOOLKIT_SCROLL_BARS))
5776 /* MS-Windows, macOS, and GTK have scroll bars on the right by
5777 default. */
5778 Vdefault_frame_scroll_bars = Qright;
5779 #else
5780 Vdefault_frame_scroll_bars = Qleft;
5781 #endif
5782 #else
5783 Vdefault_frame_scroll_bars = Qnil;
5784 #endif
5786 DEFVAR_BOOL ("scroll-bar-adjust-thumb-portion",
5787 scroll_bar_adjust_thumb_portion_p,
5788 doc: /* Adjust thumb for overscrolling for Gtk+ and MOTIF.
5789 Non-nil means adjust the thumb in the scroll bar so it can be dragged downwards
5790 even if the end of the buffer is shown (i.e. overscrolling).
5791 Set to nil if you want the thumb to be at the bottom when the end of the buffer
5792 is shown. Also, the thumb fills the whole scroll bar when the entire buffer
5793 is visible. In this case you can not overscroll. */);
5794 scroll_bar_adjust_thumb_portion_p = 1;
5796 DEFVAR_LISP ("terminal-frame", Vterminal_frame,
5797 doc: /* The initial frame-object, which represents Emacs's stdout. */);
5799 DEFVAR_LISP ("mouse-position-function", Vmouse_position_function,
5800 doc: /* If non-nil, function to transform normal value of `mouse-position'.
5801 `mouse-position' and `mouse-pixel-position' call this function, passing their
5802 usual return value as argument, and return whatever this function returns.
5803 This abnormal hook exists for the benefit of packages like `xt-mouse.el'
5804 which need to do mouse handling at the Lisp level. */);
5805 Vmouse_position_function = Qnil;
5807 DEFVAR_LISP ("mouse-highlight", Vmouse_highlight,
5808 doc: /* If non-nil, clickable text is highlighted when mouse is over it.
5809 If the value is an integer, highlighting is only shown after moving the
5810 mouse, while keyboard input turns off the highlight even when the mouse
5811 is over the clickable text. However, the mouse shape still indicates
5812 when the mouse is over clickable text. */);
5813 Vmouse_highlight = Qt;
5815 DEFVAR_LISP ("make-pointer-invisible", Vmake_pointer_invisible,
5816 doc: /* If non-nil, make pointer invisible while typing.
5817 The pointer becomes visible again when the mouse is moved. */);
5818 Vmake_pointer_invisible = Qt;
5820 DEFVAR_LISP ("focus-in-hook", Vfocus_in_hook,
5821 doc: /* Normal hook run when a frame gains input focus.
5822 The frame gaining focus is selected at the time this hook is run. */);
5823 Vfocus_in_hook = Qnil;
5825 DEFVAR_LISP ("focus-out-hook", Vfocus_out_hook,
5826 doc: /* Normal hook run when all frames lost input focus. */);
5827 Vfocus_out_hook = Qnil;
5829 DEFVAR_LISP ("move-frame-functions", Vmove_frame_functions,
5830 doc: /* Functions run after a frame was moved.
5831 The functions are run with one arg, the frame that moved. */);
5832 Vmove_frame_functions = Qnil;
5834 DEFVAR_LISP ("delete-frame-functions", Vdelete_frame_functions,
5835 doc: /* Functions run before deleting a frame.
5836 The functions are run with one arg, the frame to be deleted.
5837 See `delete-frame'.
5839 Note that functions in this list may be called just before the frame is
5840 actually deleted, or some time later (or even both when an earlier function
5841 in `delete-frame-functions' (indirectly) calls `delete-frame'
5842 recursively). */);
5843 Vdelete_frame_functions = Qnil;
5844 DEFSYM (Qdelete_frame_functions, "delete-frame-functions");
5846 DEFVAR_LISP ("menu-bar-mode", Vmenu_bar_mode,
5847 doc: /* Non-nil if Menu-Bar mode is enabled.
5848 See the command `menu-bar-mode' for a description of this minor mode.
5849 Setting this variable directly does not take effect;
5850 either customize it (see the info node `Easy Customization')
5851 or call the function `menu-bar-mode'. */);
5852 Vmenu_bar_mode = Qt;
5854 DEFVAR_LISP ("tool-bar-mode", Vtool_bar_mode,
5855 doc: /* Non-nil if Tool-Bar mode is enabled.
5856 See the command `tool-bar-mode' for a description of this minor mode.
5857 Setting this variable directly does not take effect;
5858 either customize it (see the info node `Easy Customization')
5859 or call the function `tool-bar-mode'. */);
5860 #ifdef HAVE_WINDOW_SYSTEM
5861 Vtool_bar_mode = Qt;
5862 #else
5863 Vtool_bar_mode = Qnil;
5864 #endif
5866 DEFVAR_KBOARD ("default-minibuffer-frame", Vdefault_minibuffer_frame,
5867 doc: /* Minibufferless frames use this frame's minibuffer.
5868 Emacs cannot create minibufferless frames unless this is set to an
5869 appropriate surrogate.
5871 Emacs consults this variable only when creating minibufferless
5872 frames; once the frame is created, it sticks with its assigned
5873 minibuffer, no matter what this variable is set to. This means that
5874 this variable doesn't necessarily say anything meaningful about the
5875 current set of frames, or where the minibuffer is currently being
5876 displayed.
5878 This variable is local to the current terminal and cannot be buffer-local. */);
5880 DEFVAR_LISP ("focus-follows-mouse", focus_follows_mouse,
5881 doc: /* Non-nil if window system changes focus when you move the mouse.
5882 You should set this variable to tell Emacs how your window manager
5883 handles focus, since there is no way in general for Emacs to find out
5884 automatically.
5886 There are three meaningful values:
5888 - The default nil should be used when your window manager follows a
5889 "click-to-focus" policy where you have to click the mouse inside of a
5890 frame in order for that frame to get focus.
5892 - The value t should be used when your window manager has the focus
5893 automatically follow the position of the mouse pointer but a window
5894 that gains focus is not raised automatically.
5896 - The value `auto-raise' should be used when your window manager has the
5897 focus automatically follow the position of the mouse pointer and a
5898 window that gains focus is raised automatically.
5900 If this option is non-nil, Emacs moves the mouse pointer to the frame
5901 selected by `select-frame-set-input-focus'. This function is used by a
5902 number of commands like, for example, `other-frame' and `pop-to-buffer'.
5903 If this option is nil and your focus follows mouse window manager does
5904 not autonomously move the mouse pointer to the newly selected frame, the
5905 previously selected window manager window might get reselected instead
5906 immediately.
5908 The distinction between the values t and `auto-raise' is not needed for
5909 "normal" frames because the window manager takes care of raising them.
5910 Setting this to `auto-raise' will, however, override the standard
5911 behavior of a window manager that does not automatically raise the frame
5912 that gets focus. Setting this to `auto-raise' is also necessary to
5913 automatically raise child frames which are usually left alone by the
5914 window manager.
5916 Note that this option does not distinguish "sloppy" focus (where the
5917 frame that previously had focus retains focus as long as the mouse
5918 pointer does not move into another window manager window) from "strict"
5919 focus (where a frame immediately loses focus when it's left by the mouse
5920 pointer).
5922 In order to extend a "focus follows mouse" policy to individual Emacs
5923 windows, customize the variable `mouse-autoselect-window'. */);
5924 focus_follows_mouse = Qnil;
5926 DEFVAR_BOOL ("frame-resize-pixelwise", frame_resize_pixelwise,
5927 doc: /* Non-nil means resize frames pixelwise.
5928 If this option is nil, resizing a frame rounds its sizes to the frame's
5929 current values of `frame-char-height' and `frame-char-width'. If this
5930 is non-nil, no rounding occurs, hence frame sizes can increase/decrease
5931 by one pixel.
5933 With some window managers you may have to set this to non-nil in order
5934 to set the size of a frame in pixels, to maximize frames or to make them
5935 fullscreen. To resize your initial frame pixelwise, set this option to
5936 a non-nil value in your init file. */);
5937 frame_resize_pixelwise = 0;
5939 DEFVAR_LISP ("frame-inhibit-implied-resize", frame_inhibit_implied_resize,
5940 doc: /* Whether frames should be resized implicitly.
5941 If this option is nil, setting font, menu bar, tool bar, internal
5942 borders, fringes or scroll bars of a specific frame may resize the frame
5943 in order to preserve the number of columns or lines it displays. If
5944 this option is t, no such resizing is done. Note that the size of
5945 fullscreen and maximized frames, the height of fullheight frames and the
5946 width of fullwidth frames never change implicitly.
5948 The value of this option can be also be a list of frame parameters. In
5949 this case, resizing is inhibited when changing a parameter that appears
5950 in that list. The parameters currently handled by this option include
5951 `font', `font-backend', `internal-border-width', `menu-bar-lines' and
5952 `tool-bar-lines'.
5954 Changing any of the parameters `scroll-bar-width', `scroll-bar-height',
5955 `vertical-scroll-bars', `horizontal-scroll-bars', `left-fringe' and
5956 `right-fringe' is handled as if the frame contained just one live
5957 window. This means, for example, that removing vertical scroll bars on
5958 a frame containing several side by side windows will shrink the frame
5959 width by the width of one scroll bar provided this option is nil and
5960 keep it unchanged if this option is either t or a list containing
5961 `vertical-scroll-bars'.
5963 The default value is \\='(tool-bar-lines) on Lucid, Motif and Windows
5964 \(which means that adding/removing a tool bar does not change the frame
5965 height), nil on all other window systems including GTK+ (which means
5966 that changing any of the parameters listed above may change the size of
5967 the frame), and t otherwise (which means the frame size never changes
5968 implicitly when there's no window system support).
5970 Note that when a frame is not large enough to accommodate a change of
5971 any of the parameters listed above, Emacs may try to enlarge the frame
5972 even if this option is non-nil. */);
5973 #if defined (HAVE_WINDOW_SYSTEM)
5974 #if defined (USE_LUCID) || defined (USE_MOTIF) || defined (HAVE_NTGUI)
5975 frame_inhibit_implied_resize = list1 (Qtool_bar_lines);
5976 #else
5977 frame_inhibit_implied_resize = Qnil;
5978 #endif
5979 #else
5980 frame_inhibit_implied_resize = Qt;
5981 #endif
5983 DEFVAR_LISP ("frame-size-history", frame_size_history,
5984 doc: /* History of frame size adjustments.
5985 If non-nil, list recording frame size adjustment. Adjustments are
5986 recorded only if the first element of this list is a positive number.
5987 Adding an adjustment decrements that number by one.
5989 The remaining elements are the adjustments. Each adjustment is a list
5990 of four elements `frame', `function', `sizes' and `more'. `frame' is
5991 the affected frame and `function' the invoking function. `sizes' is
5992 usually a list of four elements `old-width', `old-height', `new-width'
5993 and `new-height' representing the old and new sizes recorded/requested
5994 by `function'. `more' is a list with additional information.
5996 The function `frame--size-history' displays the value of this variable
5997 in a more readable form. */);
5998 frame_size_history = Qnil;
6000 DEFVAR_BOOL ("tooltip-reuse-hidden-frame", tooltip_reuse_hidden_frame,
6001 doc: /* Non-nil means reuse hidden tooltip frames.
6002 When this is nil, delete a tooltip frame when hiding the associated
6003 tooltip. When this is non-nil, make the tooltip frame invisible only,
6004 so it can be reused when the next tooltip is shown.
6006 Setting this to non-nil may drastically reduce the consing overhead
6007 incurred by creating new tooltip frames. However, a value of non-nil
6008 means also that intermittent changes of faces or `default-frame-alist'
6009 are not applied when showing a tooltip in a reused frame.
6011 This variable is effective only with the X toolkit (and there only when
6012 Gtk+ tooltips are not used) and on Windows. */);
6013 tooltip_reuse_hidden_frame = false;
6015 staticpro (&Vframe_list);
6017 defsubr (&Sframep);
6018 defsubr (&Sframe_live_p);
6019 defsubr (&Swindow_system);
6020 defsubr (&Sframe_windows_min_size);
6021 defsubr (&Smake_terminal_frame);
6022 defsubr (&Shandle_switch_frame);
6023 defsubr (&Sselect_frame);
6024 defsubr (&Sselected_frame);
6025 defsubr (&Sframe_list);
6026 defsubr (&Sframe_parent);
6027 defsubr (&Sframe_ancestor_p);
6028 defsubr (&Snext_frame);
6029 defsubr (&Sprevious_frame);
6030 defsubr (&Slast_nonminibuf_frame);
6031 defsubr (&Sdelete_frame);
6032 defsubr (&Smouse_position);
6033 defsubr (&Smouse_pixel_position);
6034 defsubr (&Sset_mouse_position);
6035 defsubr (&Sset_mouse_pixel_position);
6036 #if 0
6037 defsubr (&Sframe_configuration);
6038 defsubr (&Srestore_frame_configuration);
6039 #endif
6040 defsubr (&Smake_frame_visible);
6041 defsubr (&Smake_frame_invisible);
6042 defsubr (&Siconify_frame);
6043 defsubr (&Sframe_visible_p);
6044 defsubr (&Svisible_frame_list);
6045 defsubr (&Sraise_frame);
6046 defsubr (&Slower_frame);
6047 defsubr (&Sx_focus_frame);
6048 defsubr (&Sframe_after_make_frame);
6049 defsubr (&Sredirect_frame_focus);
6050 defsubr (&Sframe_focus);
6051 defsubr (&Sframe_parameters);
6052 defsubr (&Sframe_parameter);
6053 defsubr (&Smodify_frame_parameters);
6054 defsubr (&Sframe_char_height);
6055 defsubr (&Sframe_char_width);
6056 defsubr (&Sframe_native_height);
6057 defsubr (&Sframe_native_width);
6058 defsubr (&Sframe_text_cols);
6059 defsubr (&Sframe_text_lines);
6060 defsubr (&Sframe_total_cols);
6061 defsubr (&Sframe_total_lines);
6062 defsubr (&Sframe_text_width);
6063 defsubr (&Sframe_text_height);
6064 defsubr (&Sscroll_bar_width);
6065 defsubr (&Sscroll_bar_height);
6066 defsubr (&Sfringe_width);
6067 defsubr (&Sframe_internal_border_width);
6068 defsubr (&Sright_divider_width);
6069 defsubr (&Sbottom_divider_width);
6070 defsubr (&Stool_bar_pixel_width);
6071 defsubr (&Sset_frame_height);
6072 defsubr (&Sset_frame_width);
6073 defsubr (&Sset_frame_size);
6074 defsubr (&Sframe_position);
6075 defsubr (&Sset_frame_position);
6076 defsubr (&Sframe_pointer_visible_p);
6078 #ifdef HAVE_WINDOW_SYSTEM
6079 defsubr (&Sx_get_resource);
6080 defsubr (&Sx_parse_geometry);
6081 #endif