* lisp/emacs-lisp/pcase.el (pcase--expand): Warn for unused pattern.
[emacs.git] / src / frame.c
blob39d26ded5a688128ea344fe4dd7e2bc088540215
1 /* Generic frame functions.
3 Copyright (C) 1993-1995, 1997, 1999-2012 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
10 (at 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 <ctype.h>
24 #include <errno.h>
25 #include <limits.h>
26 #include <setjmp.h>
27 #include "lisp.h"
28 #include "character.h"
29 #ifdef HAVE_X_WINDOWS
30 #include "xterm.h"
31 #endif
32 #ifdef WINDOWSNT
33 #include "w32term.h"
34 #endif
35 #ifdef HAVE_NS
36 #include "nsterm.h"
37 #endif
38 #include "buffer.h"
39 /* These help us bind and responding to switch-frame events. */
40 #include "commands.h"
41 #include "keyboard.h"
42 #include "frame.h"
43 #include "blockinput.h"
44 #include "termchar.h"
45 #include "termhooks.h"
46 #include "dispextern.h"
47 #include "window.h"
48 #include "font.h"
49 #ifdef HAVE_WINDOW_SYSTEM
50 #include "fontset.h"
51 #endif
52 #ifdef MSDOS
53 #include "msdos.h"
54 #include "dosfns.h"
55 #endif
58 #ifdef HAVE_WINDOW_SYSTEM
60 #endif
62 #ifdef HAVE_NS
63 Lisp_Object Qns_parse_geometry;
64 #endif
66 Lisp_Object Qframep, Qframe_live_p;
67 Lisp_Object Qicon, Qmodeline;
68 Lisp_Object Qonly;
69 Lisp_Object Qx, Qw32, Qmac, Qpc, Qns;
70 Lisp_Object Qvisible;
71 Lisp_Object Qdisplay_type;
72 static Lisp_Object Qbackground_mode;
73 Lisp_Object Qnoelisp;
75 static Lisp_Object Qx_frame_parameter;
76 Lisp_Object Qx_resource_name;
77 Lisp_Object Qterminal;
78 Lisp_Object Qterminal_live_p;
80 /* Frame parameters (set or reported). */
82 Lisp_Object Qauto_raise, Qauto_lower;
83 Lisp_Object Qborder_color, Qborder_width;
84 Lisp_Object Qcursor_color, Qcursor_type;
85 static Lisp_Object Qgeometry; /* Not used */
86 Lisp_Object Qheight, Qwidth;
87 Lisp_Object Qleft, Qright;
88 Lisp_Object Qicon_left, Qicon_top, Qicon_type, Qicon_name;
89 Lisp_Object Qtooltip;
90 Lisp_Object Qinternal_border_width;
91 Lisp_Object Qmouse_color;
92 Lisp_Object Qminibuffer;
93 Lisp_Object Qscroll_bar_width, Qvertical_scroll_bars;
94 Lisp_Object Qvisibility;
95 Lisp_Object Qscroll_bar_foreground, Qscroll_bar_background;
96 Lisp_Object Qscreen_gamma;
97 Lisp_Object Qline_spacing;
98 static Lisp_Object Quser_position, Quser_size;
99 Lisp_Object Qwait_for_wm;
100 static Lisp_Object Qwindow_id;
101 #ifdef HAVE_X_WINDOWS
102 static Lisp_Object Qouter_window_id;
103 #endif
104 Lisp_Object Qparent_id;
105 Lisp_Object Qtitle, Qname;
106 static Lisp_Object Qexplicit_name;
107 Lisp_Object Qunsplittable;
108 Lisp_Object Qmenu_bar_lines, Qtool_bar_lines, Qtool_bar_position;
109 Lisp_Object Qleft_fringe, Qright_fringe;
110 Lisp_Object Qbuffer_predicate;
111 static Lisp_Object Qbuffer_list, Qburied_buffer_list;
112 Lisp_Object Qtty_color_mode;
113 Lisp_Object Qtty, Qtty_type;
115 Lisp_Object Qfullscreen, Qfullwidth, Qfullheight, Qfullboth, Qmaximized;
116 Lisp_Object Qsticky;
117 Lisp_Object Qfont_backend;
118 Lisp_Object Qalpha;
120 Lisp_Object Qface_set_after_frame_default;
122 static Lisp_Object Qdelete_frame_functions;
124 #ifdef HAVE_WINDOW_SYSTEM
125 static void x_report_frame_params (struct frame *, Lisp_Object *);
126 #endif
129 static void
130 set_menu_bar_lines_1 (Lisp_Object window, int n)
132 struct window *w = XWINDOW (window);
134 XSETFASTINT (w->last_modified, 0);
135 XSETFASTINT (w->top_line, XFASTINT (w->top_line) + n);
136 XSETFASTINT (w->total_lines, XFASTINT (w->total_lines) - n);
138 /* Handle just the top child in a vertical split. */
139 if (!NILP (w->vchild))
140 set_menu_bar_lines_1 (w->vchild, n);
142 /* Adjust all children in a horizontal split. */
143 for (window = w->hchild; !NILP (window); window = w->next)
145 w = XWINDOW (window);
146 set_menu_bar_lines_1 (window, n);
150 void
151 set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
153 int nlines;
154 int olines = FRAME_MENU_BAR_LINES (f);
156 /* Right now, menu bars don't work properly in minibuf-only frames;
157 most of the commands try to apply themselves to the minibuffer
158 frame itself, and get an error because you can't switch buffers
159 in or split the minibuffer window. */
160 if (FRAME_MINIBUF_ONLY_P (f))
161 return;
163 if (TYPE_RANGED_INTEGERP (int, value))
164 nlines = XINT (value);
165 else
166 nlines = 0;
168 if (nlines != olines)
170 windows_or_buffers_changed++;
171 FRAME_WINDOW_SIZES_CHANGED (f) = 1;
172 FRAME_MENU_BAR_LINES (f) = nlines;
173 set_menu_bar_lines_1 (f->root_window, nlines - olines);
174 adjust_glyphs (f);
178 Lisp_Object Vframe_list;
181 DEFUN ("framep", Fframep, Sframep, 1, 1, 0,
182 doc: /* Return non-nil if OBJECT is a frame.
183 Value is:
184 t for a termcap frame (a character-only terminal),
185 'x' for an Emacs frame that is really an X window,
186 'w32' for an Emacs frame that is a window on MS-Windows display,
187 'ns' for an Emacs frame on a GNUstep or Macintosh Cocoa display,
188 'pc' for a direct-write MS-DOS frame.
189 See also `frame-live-p'. */)
190 (Lisp_Object object)
192 if (!FRAMEP (object))
193 return Qnil;
194 switch (XFRAME (object)->output_method)
196 case output_initial: /* The initial frame is like a termcap frame. */
197 case output_termcap:
198 return Qt;
199 case output_x_window:
200 return Qx;
201 case output_w32:
202 return Qw32;
203 case output_msdos_raw:
204 return Qpc;
205 case output_mac:
206 return Qmac;
207 case output_ns:
208 return Qns;
209 default:
210 abort ();
214 DEFUN ("frame-live-p", Fframe_live_p, Sframe_live_p, 1, 1, 0,
215 doc: /* Return non-nil if OBJECT is a frame which has not been deleted.
216 Value is nil if OBJECT is not a live frame. If object is a live
217 frame, the return value indicates what sort of terminal device it is
218 displayed on. See the documentation of `framep' for possible
219 return values. */)
220 (Lisp_Object object)
222 return ((FRAMEP (object)
223 && FRAME_LIVE_P (XFRAME (object)))
224 ? Fframep (object)
225 : Qnil);
228 DEFUN ("window-system", Fwindow_system, Swindow_system, 0, 1, 0,
229 doc: /* The name of the window system that FRAME is displaying through.
230 The value is a symbol:
231 nil for a termcap frame (a character-only terminal),
232 'x' for an Emacs frame that is really an X window,
233 'w32' for an Emacs frame that is a window on MS-Windows display,
234 'ns' for an Emacs frame on a GNUstep or Macintosh Cocoa display,
235 'pc' for a direct-write MS-DOS frame.
237 FRAME defaults to the currently selected frame.
239 Use of this function as a predicate is deprecated. Instead,
240 use `display-graphic-p' or any of the other `display-*-p'
241 predicates which report frame's specific UI-related capabilities. */)
242 (Lisp_Object frame)
244 Lisp_Object type;
245 if (NILP (frame))
246 frame = selected_frame;
248 type = Fframep (frame);
250 if (NILP (type))
251 wrong_type_argument (Qframep, frame);
253 if (EQ (type, Qt))
254 return Qnil;
255 else
256 return type;
259 struct frame *
260 make_frame (int mini_p)
262 Lisp_Object frame;
263 register struct frame *f;
264 register Lisp_Object root_window;
265 register Lisp_Object mini_window;
267 f = allocate_frame ();
268 XSETFRAME (frame, f);
270 f->desired_matrix = 0;
271 f->current_matrix = 0;
272 f->desired_pool = 0;
273 f->current_pool = 0;
274 f->glyphs_initialized_p = 0;
275 f->decode_mode_spec_buffer = 0;
276 f->visible = 0;
277 f->async_visible = 0;
278 f->output_data.nothing = 0;
279 f->iconified = 0;
280 f->async_iconified = 0;
281 f->wants_modeline = 1;
282 f->auto_raise = 0;
283 f->auto_lower = 0;
284 f->no_split = 0;
285 f->garbaged = 1;
286 f->has_minibuffer = mini_p;
287 f->focus_frame = Qnil;
288 f->explicit_name = 0;
289 f->can_have_scroll_bars = 0;
290 f->vertical_scroll_bar_type = vertical_scroll_bar_none;
291 f->param_alist = Qnil;
292 f->scroll_bars = Qnil;
293 f->condemned_scroll_bars = Qnil;
294 f->face_alist = Qnil;
295 f->face_cache = NULL;
296 f->menu_bar_items = Qnil;
297 f->menu_bar_vector = Qnil;
298 f->menu_bar_items_used = 0;
299 f->buffer_predicate = Qnil;
300 f->buffer_list = Qnil;
301 f->buried_buffer_list = Qnil;
302 f->namebuf = 0;
303 f->title = Qnil;
304 f->menu_bar_window = Qnil;
305 f->tool_bar_window = Qnil;
306 f->tool_bar_items = Qnil;
307 f->tool_bar_position = Qtop;
308 f->desired_tool_bar_string = f->current_tool_bar_string = Qnil;
309 f->n_tool_bar_items = 0;
310 f->left_fringe_width = f->right_fringe_width = 0;
311 f->fringe_cols = 0;
312 f->menu_bar_lines = 0;
313 f->tool_bar_lines = 0;
314 f->scroll_bar_actual_width = 0;
315 f->border_width = 0;
316 f->internal_border_width = 0;
317 f->column_width = 1; /* !FRAME_WINDOW_P value */
318 f->line_height = 1; /* !FRAME_WINDOW_P value */
319 f->x_pixels_diff = f->y_pixels_diff = 0;
320 #ifdef HAVE_WINDOW_SYSTEM
321 f->want_fullscreen = FULLSCREEN_NONE;
322 #endif
323 f->size_hint_flags = 0;
324 f->win_gravity = 0;
325 f->font_driver_list = NULL;
326 f->font_data_list = NULL;
328 root_window = make_window ();
329 if (mini_p)
331 mini_window = make_window ();
332 XWINDOW (root_window)->next = mini_window;
333 XWINDOW (mini_window)->prev = root_window;
334 XWINDOW (mini_window)->mini = 1;
335 XWINDOW (mini_window)->frame = frame;
336 f->minibuffer_window = mini_window;
338 else
340 mini_window = Qnil;
341 XWINDOW (root_window)->next = Qnil;
342 f->minibuffer_window = Qnil;
345 XWINDOW (root_window)->frame = frame;
347 /* 10 is arbitrary,
348 just so that there is "something there."
349 Correct size will be set up later with change_frame_size. */
351 SET_FRAME_COLS (f, 10);
352 FRAME_LINES (f) = 10;
354 XSETFASTINT (XWINDOW (root_window)->total_cols, 10);
355 XSETFASTINT (XWINDOW (root_window)->total_lines, (mini_p ? 9 : 10));
357 if (mini_p)
359 XSETFASTINT (XWINDOW (mini_window)->total_cols, 10);
360 XSETFASTINT (XWINDOW (mini_window)->top_line, 9);
361 XSETFASTINT (XWINDOW (mini_window)->total_lines, 1);
364 /* Choose a buffer for the frame's root window. */
366 Lisp_Object buf;
368 XWINDOW (root_window)->buffer = Qt;
369 buf = Fcurrent_buffer ();
370 /* If buf is a 'hidden' buffer (i.e. one whose name starts with
371 a space), try to find another one. */
372 if (SREF (Fbuffer_name (buf), 0) == ' ')
373 buf = other_buffer_safely (buf);
375 /* Use set_window_buffer, not Fset_window_buffer, and don't let
376 hooks be run by it. The reason is that the whole frame/window
377 arrangement is not yet fully initialized at this point. Windows
378 don't have the right size, glyph matrices aren't initialized
379 etc. Running Lisp functions at this point surely ends in a
380 SEGV. */
381 set_window_buffer (root_window, buf, 0, 0);
382 f->buffer_list = Fcons (buf, Qnil);
385 if (mini_p)
387 XWINDOW (mini_window)->buffer = Qt;
388 set_window_buffer (mini_window,
389 (NILP (Vminibuffer_list)
390 ? get_minibuffer (0)
391 : Fcar (Vminibuffer_list)),
392 0, 0);
395 f->root_window = root_window;
396 f->selected_window = root_window;
397 /* Make sure this window seems more recently used than
398 a newly-created, never-selected window. */
399 ++window_select_count;
400 XSETFASTINT (XWINDOW (f->selected_window)->use_time, window_select_count);
402 f->default_face_done_p = 0;
404 return f;
407 #ifdef HAVE_WINDOW_SYSTEM
408 /* Make a frame using a separate minibuffer window on another frame.
409 MINI_WINDOW is the minibuffer window to use. nil means use the
410 default (the global minibuffer). */
412 struct frame *
413 make_frame_without_minibuffer (register Lisp_Object mini_window, KBOARD *kb, Lisp_Object display)
415 register struct frame *f;
416 struct gcpro gcpro1;
418 if (!NILP (mini_window))
419 CHECK_LIVE_WINDOW (mini_window);
421 if (!NILP (mini_window)
422 && FRAME_KBOARD (XFRAME (XWINDOW (mini_window)->frame)) != kb)
423 error ("Frame and minibuffer must be on the same terminal");
425 /* Make a frame containing just a root window. */
426 f = make_frame (0);
428 if (NILP (mini_window))
430 /* Use default-minibuffer-frame if possible. */
431 if (!FRAMEP (KVAR (kb, Vdefault_minibuffer_frame))
432 || ! FRAME_LIVE_P (XFRAME (KVAR (kb, Vdefault_minibuffer_frame))))
434 Lisp_Object frame_dummy;
436 XSETFRAME (frame_dummy, f);
437 GCPRO1 (frame_dummy);
438 /* If there's no minibuffer frame to use, create one. */
439 KVAR (kb, Vdefault_minibuffer_frame) =
440 call1 (intern ("make-initial-minibuffer-frame"), display);
441 UNGCPRO;
444 mini_window = XFRAME (KVAR (kb, Vdefault_minibuffer_frame))->minibuffer_window;
447 f->minibuffer_window = mini_window;
449 /* Make the chosen minibuffer window display the proper minibuffer,
450 unless it is already showing a minibuffer. */
451 if (NILP (Fmemq (XWINDOW (mini_window)->buffer, Vminibuffer_list)))
452 Fset_window_buffer (mini_window,
453 (NILP (Vminibuffer_list)
454 ? get_minibuffer (0)
455 : Fcar (Vminibuffer_list)), Qnil);
456 return f;
459 /* Make a frame containing only a minibuffer window. */
461 struct frame *
462 make_minibuffer_frame (void)
464 /* First make a frame containing just a root window, no minibuffer. */
466 register struct frame *f = make_frame (0);
467 register Lisp_Object mini_window;
468 register Lisp_Object frame;
470 XSETFRAME (frame, f);
472 f->auto_raise = 0;
473 f->auto_lower = 0;
474 f->no_split = 1;
475 f->wants_modeline = 0;
476 f->has_minibuffer = 1;
478 /* Now label the root window as also being the minibuffer.
479 Avoid infinite looping on the window chain by marking next pointer
480 as nil. */
482 mini_window = f->minibuffer_window = f->root_window;
483 XWINDOW (mini_window)->mini = 1;
484 XWINDOW (mini_window)->next = Qnil;
485 XWINDOW (mini_window)->prev = Qnil;
486 XWINDOW (mini_window)->frame = frame;
488 /* Put the proper buffer in that window. */
490 Fset_window_buffer (mini_window,
491 (NILP (Vminibuffer_list)
492 ? get_minibuffer (0)
493 : Fcar (Vminibuffer_list)), Qnil);
494 return f;
496 #endif /* HAVE_WINDOW_SYSTEM */
498 /* Construct a frame that refers to a terminal. */
500 static printmax_t tty_frame_count;
502 struct frame *
503 make_initial_frame (void)
505 struct frame *f;
506 struct terminal *terminal;
507 Lisp_Object frame;
509 eassert (initial_kboard);
511 /* The first call must initialize Vframe_list. */
512 if (! (NILP (Vframe_list) || CONSP (Vframe_list)))
513 Vframe_list = Qnil;
515 terminal = init_initial_terminal ();
517 f = make_frame (1);
518 XSETFRAME (frame, f);
520 Vframe_list = Fcons (frame, Vframe_list);
522 tty_frame_count = 1;
523 f->name = make_pure_c_string ("F1");
525 f->visible = 1;
526 f->async_visible = 1;
528 f->output_method = terminal->type;
529 f->terminal = terminal;
530 f->terminal->reference_count++;
531 f->output_data.nothing = 0;
533 FRAME_FOREGROUND_PIXEL (f) = FACE_TTY_DEFAULT_FG_COLOR;
534 FRAME_BACKGROUND_PIXEL (f) = FACE_TTY_DEFAULT_BG_COLOR;
536 FRAME_CAN_HAVE_SCROLL_BARS (f) = 0;
537 FRAME_VERTICAL_SCROLL_BAR_TYPE (f) = vertical_scroll_bar_none;
539 /* The default value of menu-bar-mode is t. */
540 set_menu_bar_lines (f, make_number (1), Qnil);
542 if (!noninteractive)
543 init_frame_faces (f);
545 return f;
549 static struct frame *
550 make_terminal_frame (struct terminal *terminal)
552 register struct frame *f;
553 Lisp_Object frame;
554 char name[sizeof "F" + INT_STRLEN_BOUND (printmax_t)];
556 if (!terminal->name)
557 error ("Terminal is not live, can't create new frames on it");
559 f = make_frame (1);
561 XSETFRAME (frame, f);
562 Vframe_list = Fcons (frame, Vframe_list);
564 tty_frame_count++;
565 sprintf (name, "F%"pMd, tty_frame_count);
566 f->name = build_string (name);
568 f->visible = 1; /* FRAME_SET_VISIBLE wd set frame_garbaged. */
569 f->async_visible = 1; /* Don't let visible be cleared later. */
570 f->terminal = terminal;
571 f->terminal->reference_count++;
572 #ifdef MSDOS
573 f->output_data.tty->display_info = &the_only_display_info;
574 if (!inhibit_window_system
575 && (!FRAMEP (selected_frame) || !FRAME_LIVE_P (XFRAME (selected_frame))
576 || XFRAME (selected_frame)->output_method == output_msdos_raw))
577 f->output_method = output_msdos_raw;
578 else
579 f->output_method = output_termcap;
580 #else /* not MSDOS */
581 f->output_method = output_termcap;
582 create_tty_output (f);
583 FRAME_FOREGROUND_PIXEL (f) = FACE_TTY_DEFAULT_FG_COLOR;
584 FRAME_BACKGROUND_PIXEL (f) = FACE_TTY_DEFAULT_BG_COLOR;
585 #endif /* not MSDOS */
587 FRAME_CAN_HAVE_SCROLL_BARS (f) = 0;
588 FRAME_VERTICAL_SCROLL_BAR_TYPE (f) = vertical_scroll_bar_none;
589 FRAME_MENU_BAR_LINES(f) = NILP (Vmenu_bar_mode) ? 0 : 1;
591 /* Set the top frame to the newly created frame. */
592 if (FRAMEP (FRAME_TTY (f)->top_frame)
593 && FRAME_LIVE_P (XFRAME (FRAME_TTY (f)->top_frame)))
594 XFRAME (FRAME_TTY (f)->top_frame)->async_visible = 2; /* obscured */
596 FRAME_TTY (f)->top_frame = frame;
598 if (!noninteractive)
599 init_frame_faces (f);
601 return f;
604 /* Get a suitable value for frame parameter PARAMETER for a newly
605 created frame, based on (1) the user-supplied frame parameter
606 alist SUPPLIED_PARMS, and (2) CURRENT_VALUE. */
608 static Lisp_Object
609 get_future_frame_param (Lisp_Object parameter,
610 Lisp_Object supplied_parms,
611 char *current_value)
613 Lisp_Object result;
615 result = Fassq (parameter, supplied_parms);
616 if (NILP (result))
617 result = Fassq (parameter, XFRAME (selected_frame)->param_alist);
618 if (NILP (result) && current_value != NULL)
619 result = build_string (current_value);
620 if (!NILP (result) && !STRINGP (result))
621 result = XCDR (result);
622 if (NILP (result) || !STRINGP (result))
623 result = Qnil;
625 return result;
628 DEFUN ("make-terminal-frame", Fmake_terminal_frame, Smake_terminal_frame,
629 1, 1, 0,
630 doc: /* Create an additional terminal frame, possibly on another terminal.
631 This function takes one argument, an alist specifying frame parameters.
633 You can create multiple frames on a single text-only terminal, but
634 only one of them (the selected terminal frame) is actually displayed.
636 In practice, generally you don't need to specify any parameters,
637 except when you want to create a new frame on another terminal.
638 In that case, the `tty' parameter specifies the device file to open,
639 and the `tty-type' parameter specifies the terminal type. Example:
641 (make-terminal-frame '((tty . "/dev/pts/5") (tty-type . "xterm")))
643 Note that changing the size of one terminal frame automatically
644 affects all frames on the same terminal device. */)
645 (Lisp_Object parms)
647 struct frame *f;
648 struct terminal *t = NULL;
649 Lisp_Object frame, tem;
650 struct frame *sf = SELECTED_FRAME ();
652 #ifdef MSDOS
653 if (sf->output_method != output_msdos_raw
654 && sf->output_method != output_termcap)
655 abort ();
656 #else /* not MSDOS */
658 #ifdef WINDOWSNT /* This should work now! */
659 if (sf->output_method != output_termcap)
660 error ("Not using an ASCII terminal now; cannot make a new ASCII frame");
661 #endif
662 #endif /* not MSDOS */
665 Lisp_Object terminal;
667 terminal = Fassq (Qterminal, parms);
668 if (!NILP (terminal))
670 terminal = XCDR (terminal);
671 t = get_terminal (terminal, 1);
673 #ifdef MSDOS
674 if (t && t != the_only_display_info.terminal)
675 /* msdos.c assumes a single tty_display_info object. */
676 error ("Multiple terminals are not supported on this platform");
677 if (!t)
678 t = the_only_display_info.terminal;
679 #endif
682 if (!t)
684 char *name = 0, *type = 0;
685 Lisp_Object tty, tty_type;
687 tty = get_future_frame_param
688 (Qtty, parms, (FRAME_TERMCAP_P (XFRAME (selected_frame))
689 ? FRAME_TTY (XFRAME (selected_frame))->name
690 : NULL));
691 if (!NILP (tty))
693 name = (char *) alloca (SBYTES (tty) + 1);
694 strncpy (name, SSDATA (tty), SBYTES (tty));
695 name[SBYTES (tty)] = 0;
698 tty_type = get_future_frame_param
699 (Qtty_type, parms, (FRAME_TERMCAP_P (XFRAME (selected_frame))
700 ? FRAME_TTY (XFRAME (selected_frame))->type
701 : NULL));
702 if (!NILP (tty_type))
704 type = (char *) alloca (SBYTES (tty_type) + 1);
705 strncpy (type, SSDATA (tty_type), SBYTES (tty_type));
706 type[SBYTES (tty_type)] = 0;
709 t = init_tty (name, type, 0); /* Errors are not fatal. */
712 f = make_terminal_frame (t);
715 int width, height;
716 get_tty_size (fileno (FRAME_TTY (f)->input), &width, &height);
717 change_frame_size (f, height, width, 0, 0, 0);
720 adjust_glyphs (f);
721 calculate_costs (f);
722 XSETFRAME (frame, f);
723 Fmodify_frame_parameters (frame, parms);
724 Fmodify_frame_parameters (frame, Fcons (Fcons (Qtty_type,
725 build_string (t->display_info.tty->type)),
726 Qnil));
727 if (t->display_info.tty->name != NULL)
728 Fmodify_frame_parameters (frame, Fcons (Fcons (Qtty,
729 build_string (t->display_info.tty->name)),
730 Qnil));
731 else
732 Fmodify_frame_parameters (frame, Fcons (Fcons (Qtty, Qnil), Qnil));
734 /* Make the frame face alist be frame-specific, so that each
735 frame could change its face definitions independently. */
736 f->face_alist = Fcopy_alist (sf->face_alist);
737 /* Simple Fcopy_alist isn't enough, because we need the contents of
738 the vectors which are the CDRs of associations in face_alist to
739 be copied as well. */
740 for (tem = f->face_alist; CONSP (tem); tem = XCDR (tem))
741 XSETCDR (XCAR (tem), Fcopy_sequence (XCDR (XCAR (tem))));
742 return frame;
746 /* Perform the switch to frame FRAME.
748 If FRAME is a switch-frame event `(switch-frame FRAME1)', use
749 FRAME1 as frame.
751 If TRACK is non-zero and the frame that currently has the focus
752 redirects its focus to the selected frame, redirect that focused
753 frame's focus to FRAME instead.
755 FOR_DELETION non-zero means that the selected frame is being
756 deleted, which includes the possibility that the frame's terminal
757 is dead.
759 The value of NORECORD is passed as argument to Fselect_window. */
761 Lisp_Object
762 do_switch_frame (Lisp_Object frame, int track, int for_deletion, Lisp_Object norecord)
764 struct frame *sf = SELECTED_FRAME ();
766 /* If FRAME is a switch-frame event, extract the frame we should
767 switch to. */
768 if (CONSP (frame)
769 && EQ (XCAR (frame), Qswitch_frame)
770 && CONSP (XCDR (frame)))
771 frame = XCAR (XCDR (frame));
773 /* This used to say CHECK_LIVE_FRAME, but apparently it's possible for
774 a switch-frame event to arrive after a frame is no longer live,
775 especially when deleting the initial frame during startup. */
776 CHECK_FRAME (frame);
777 if (! FRAME_LIVE_P (XFRAME (frame)))
778 return Qnil;
780 if (sf == XFRAME (frame))
781 return frame;
783 /* This is too greedy; it causes inappropriate focus redirection
784 that's hard to get rid of. */
785 #if 0
786 /* If a frame's focus has been redirected toward the currently
787 selected frame, we should change the redirection to point to the
788 newly selected frame. This means that if the focus is redirected
789 from a minibufferless frame to a surrogate minibuffer frame, we
790 can use `other-window' to switch between all the frames using
791 that minibuffer frame, and the focus redirection will follow us
792 around. */
793 if (track)
795 Lisp_Object tail;
797 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
799 Lisp_Object focus;
801 if (!FRAMEP (XCAR (tail)))
802 abort ();
804 focus = FRAME_FOCUS_FRAME (XFRAME (XCAR (tail)));
806 if (FRAMEP (focus) && XFRAME (focus) == SELECTED_FRAME ())
807 Fredirect_frame_focus (XCAR (tail), frame);
810 #else /* ! 0 */
811 /* Instead, apply it only to the frame we're pointing to. */
812 #ifdef HAVE_WINDOW_SYSTEM
813 if (track && FRAME_WINDOW_P (XFRAME (frame)))
815 Lisp_Object focus, xfocus;
817 xfocus = x_get_focus_frame (XFRAME (frame));
818 if (FRAMEP (xfocus))
820 focus = FRAME_FOCUS_FRAME (XFRAME (xfocus));
821 if (FRAMEP (focus) && XFRAME (focus) == SELECTED_FRAME ())
822 Fredirect_frame_focus (xfocus, frame);
825 #endif /* HAVE_X_WINDOWS */
826 #endif /* ! 0 */
828 if (!for_deletion && FRAME_HAS_MINIBUF_P (sf))
829 resize_mini_window (XWINDOW (FRAME_MINIBUF_WINDOW (sf)), 1);
831 if (FRAME_TERMCAP_P (XFRAME (frame)) || FRAME_MSDOS_P (XFRAME (frame)))
833 if (FRAMEP (FRAME_TTY (XFRAME (frame))->top_frame))
834 /* Mark previously displayed frame as now obscured. */
835 XFRAME (FRAME_TTY (XFRAME (frame))->top_frame)->async_visible = 2;
836 XFRAME (frame)->async_visible = 1;
837 FRAME_TTY (XFRAME (frame))->top_frame = frame;
840 selected_frame = frame;
841 if (! FRAME_MINIBUF_ONLY_P (XFRAME (selected_frame)))
842 last_nonminibuf_frame = XFRAME (selected_frame);
844 Fselect_window (XFRAME (frame)->selected_window, norecord);
846 /* We want to make sure that the next event generates a frame-switch
847 event to the appropriate frame. This seems kludgy to me, but
848 before you take it out, make sure that evaluating something like
849 (select-window (frame-root-window (new-frame))) doesn't end up
850 with your typing being interpreted in the new frame instead of
851 the one you're actually typing in. */
852 internal_last_event_frame = Qnil;
854 return frame;
857 DEFUN ("select-frame", Fselect_frame, Sselect_frame, 1, 2, "e",
858 doc: /* Select FRAME.
859 Subsequent editing commands apply to its selected window.
860 Optional argument NORECORD means to neither change the order of
861 recently selected windows nor the buffer list.
863 The selection of FRAME lasts until the next time the user does
864 something to select a different frame, or until the next time
865 this function is called. If you are using a window system, the
866 previously selected frame may be restored as the selected frame
867 when returning to the command loop, because it still may have
868 the window system's input focus. On a text-only terminal, the
869 next redisplay will display FRAME.
871 This function returns FRAME, or nil if FRAME has been deleted. */)
872 (Lisp_Object frame, Lisp_Object norecord)
874 return do_switch_frame (frame, 1, 0, norecord);
878 DEFUN ("handle-switch-frame", Fhandle_switch_frame, Shandle_switch_frame, 1, 1, "e",
879 doc: /* Handle a switch-frame event EVENT.
880 Switch-frame events are usually bound to this function.
881 A switch-frame event tells Emacs that the window manager has requested
882 that the user's events be directed to the frame mentioned in the event.
883 This function selects the selected window of the frame of EVENT.
885 If EVENT is frame object, handle it as if it were a switch-frame event
886 to that frame. */)
887 (Lisp_Object event)
889 /* Preserve prefix arg that the command loop just cleared. */
890 KVAR (current_kboard, Vprefix_arg) = Vcurrent_prefix_arg;
891 Frun_hooks (1, &Qmouse_leave_buffer_hook);
892 return do_switch_frame (event, 0, 0, Qnil);
895 DEFUN ("selected-frame", Fselected_frame, Sselected_frame, 0, 0, 0,
896 doc: /* Return the frame that is now selected. */)
897 (void)
899 return selected_frame;
902 DEFUN ("frame-list", Fframe_list, Sframe_list,
903 0, 0, 0,
904 doc: /* Return a list of all live frames. */)
905 (void)
907 Lisp_Object frames;
908 frames = Fcopy_sequence (Vframe_list);
909 #ifdef HAVE_WINDOW_SYSTEM
910 if (FRAMEP (tip_frame))
911 frames = Fdelq (tip_frame, frames);
912 #endif
913 return frames;
916 /* Return the next frame in the frame list after FRAME.
917 If MINIBUF is nil, exclude minibuffer-only frames.
918 If MINIBUF is a window, include only its own frame
919 and any frame now using that window as the minibuffer.
920 If MINIBUF is `visible', include all visible frames.
921 If MINIBUF is 0, include all visible and iconified frames.
922 Otherwise, include all frames. */
924 static Lisp_Object
925 next_frame (Lisp_Object frame, Lisp_Object minibuf)
927 Lisp_Object tail;
928 int passed = 0;
930 /* There must always be at least one frame in Vframe_list. */
931 if (! CONSP (Vframe_list))
932 abort ();
934 /* If this frame is dead, it won't be in Vframe_list, and we'll loop
935 forever. Forestall that. */
936 CHECK_LIVE_FRAME (frame);
938 while (1)
939 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
941 Lisp_Object f;
943 f = XCAR (tail);
945 if (passed
946 && ((!FRAME_TERMCAP_P (XFRAME (f)) && !FRAME_TERMCAP_P (XFRAME (frame))
947 && FRAME_KBOARD (XFRAME (f)) == FRAME_KBOARD (XFRAME (frame)))
948 || (FRAME_TERMCAP_P (XFRAME (f)) && FRAME_TERMCAP_P (XFRAME (frame))
949 && FRAME_TTY (XFRAME (f)) == FRAME_TTY (XFRAME (frame)))))
951 /* Decide whether this frame is eligible to be returned. */
953 /* If we've looped all the way around without finding any
954 eligible frames, return the original frame. */
955 if (EQ (f, frame))
956 return f;
958 /* Let minibuf decide if this frame is acceptable. */
959 if (NILP (minibuf))
961 if (! FRAME_MINIBUF_ONLY_P (XFRAME (f)))
962 return f;
964 else if (EQ (minibuf, Qvisible))
966 FRAME_SAMPLE_VISIBILITY (XFRAME (f));
967 if (FRAME_VISIBLE_P (XFRAME (f)))
968 return f;
970 else if (INTEGERP (minibuf) && XINT (minibuf) == 0)
972 FRAME_SAMPLE_VISIBILITY (XFRAME (f));
973 if (FRAME_VISIBLE_P (XFRAME (f))
974 || FRAME_ICONIFIED_P (XFRAME (f)))
975 return f;
977 else if (WINDOWP (minibuf))
979 if (EQ (FRAME_MINIBUF_WINDOW (XFRAME (f)), minibuf)
980 || EQ (WINDOW_FRAME (XWINDOW (minibuf)), f)
981 || EQ (WINDOW_FRAME (XWINDOW (minibuf)),
982 FRAME_FOCUS_FRAME (XFRAME (f))))
983 return f;
985 else
986 return f;
989 if (EQ (frame, f))
990 passed++;
994 /* Return the previous frame in the frame list before FRAME.
995 If MINIBUF is nil, exclude minibuffer-only frames.
996 If MINIBUF is a window, include only its own frame
997 and any frame now using that window as the minibuffer.
998 If MINIBUF is `visible', include all visible frames.
999 If MINIBUF is 0, include all visible and iconified frames.
1000 Otherwise, include all frames. */
1002 static Lisp_Object
1003 prev_frame (Lisp_Object frame, Lisp_Object minibuf)
1005 Lisp_Object tail;
1006 Lisp_Object prev;
1008 /* There must always be at least one frame in Vframe_list. */
1009 if (! CONSP (Vframe_list))
1010 abort ();
1012 prev = Qnil;
1013 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
1015 Lisp_Object f;
1017 f = XCAR (tail);
1018 if (!FRAMEP (f))
1019 abort ();
1021 if (EQ (frame, f) && !NILP (prev))
1022 return prev;
1024 if ((!FRAME_TERMCAP_P (XFRAME (f)) && !FRAME_TERMCAP_P (XFRAME (frame))
1025 && FRAME_KBOARD (XFRAME (f)) == FRAME_KBOARD (XFRAME (frame)))
1026 || (FRAME_TERMCAP_P (XFRAME (f)) && FRAME_TERMCAP_P (XFRAME (frame))
1027 && FRAME_TTY (XFRAME (f)) == FRAME_TTY (XFRAME (frame))))
1029 /* Decide whether this frame is eligible to be returned,
1030 according to minibuf. */
1031 if (NILP (minibuf))
1033 if (! FRAME_MINIBUF_ONLY_P (XFRAME (f)))
1034 prev = f;
1036 else if (WINDOWP (minibuf))
1038 if (EQ (FRAME_MINIBUF_WINDOW (XFRAME (f)), minibuf)
1039 || EQ (WINDOW_FRAME (XWINDOW (minibuf)), f)
1040 || EQ (WINDOW_FRAME (XWINDOW (minibuf)),
1041 FRAME_FOCUS_FRAME (XFRAME (f))))
1042 prev = f;
1044 else if (EQ (minibuf, Qvisible))
1046 FRAME_SAMPLE_VISIBILITY (XFRAME (f));
1047 if (FRAME_VISIBLE_P (XFRAME (f)))
1048 prev = f;
1050 else if (XFASTINT (minibuf) == 0)
1052 FRAME_SAMPLE_VISIBILITY (XFRAME (f));
1053 if (FRAME_VISIBLE_P (XFRAME (f))
1054 || FRAME_ICONIFIED_P (XFRAME (f)))
1055 prev = f;
1057 else
1058 prev = f;
1062 /* We've scanned the entire list. */
1063 if (NILP (prev))
1064 /* We went through the whole frame list without finding a single
1065 acceptable frame. Return the original frame. */
1066 return frame;
1067 else
1068 /* There were no acceptable frames in the list before FRAME; otherwise,
1069 we would have returned directly from the loop. Since PREV is the last
1070 acceptable frame in the list, return it. */
1071 return prev;
1075 DEFUN ("next-frame", Fnext_frame, Snext_frame, 0, 2, 0,
1076 doc: /* Return the next frame in the frame list after FRAME.
1077 It considers only frames on the same terminal as FRAME.
1078 By default, skip minibuffer-only frames.
1079 If omitted, FRAME defaults to the selected frame.
1080 If optional argument MINIFRAME is nil, exclude minibuffer-only frames.
1081 If MINIFRAME is a window, include only its own frame
1082 and any frame now using that window as the minibuffer.
1083 If MINIFRAME is `visible', include all visible frames.
1084 If MINIFRAME is 0, include all visible and iconified frames.
1085 Otherwise, include all frames. */)
1086 (Lisp_Object frame, Lisp_Object miniframe)
1088 if (NILP (frame))
1089 frame = selected_frame;
1091 CHECK_LIVE_FRAME (frame);
1092 return next_frame (frame, miniframe);
1095 DEFUN ("previous-frame", Fprevious_frame, Sprevious_frame, 0, 2, 0,
1096 doc: /* Return the previous frame in the frame list before FRAME.
1097 It considers only frames on the same terminal as FRAME.
1098 By default, skip minibuffer-only frames.
1099 If omitted, FRAME defaults to the selected frame.
1100 If optional argument MINIFRAME is nil, exclude minibuffer-only frames.
1101 If MINIFRAME is a window, include only its own frame
1102 and any frame now using that window as the minibuffer.
1103 If MINIFRAME is `visible', include all visible frames.
1104 If MINIFRAME is 0, include all visible and iconified frames.
1105 Otherwise, include all frames. */)
1106 (Lisp_Object frame, Lisp_Object miniframe)
1108 if (NILP (frame))
1109 frame = selected_frame;
1110 CHECK_LIVE_FRAME (frame);
1111 return prev_frame (frame, miniframe);
1114 /* Return 1 if it is ok to delete frame F;
1115 0 if all frames aside from F are invisible.
1116 (Exception: if F is the terminal frame, and we are using X, return 1.) */
1118 static int
1119 other_visible_frames (FRAME_PTR f)
1121 Lisp_Object frames;
1123 for (frames = Vframe_list; CONSP (frames); frames = XCDR (frames))
1125 Lisp_Object this = XCAR (frames);
1126 if (f == XFRAME (this))
1127 continue;
1129 /* Verify that we can still talk to the frame's X window,
1130 and note any recent change in visibility. */
1131 #ifdef HAVE_WINDOW_SYSTEM
1132 if (FRAME_WINDOW_P (XFRAME (this)))
1134 x_sync (XFRAME (this));
1135 FRAME_SAMPLE_VISIBILITY (XFRAME (this));
1137 #endif
1139 if (FRAME_VISIBLE_P (XFRAME (this))
1140 || FRAME_ICONIFIED_P (XFRAME (this))
1141 /* Allow deleting the terminal frame when at least one X
1142 frame exists. */
1143 || (FRAME_WINDOW_P (XFRAME (this)) && !FRAME_WINDOW_P (f)))
1144 return 1;
1146 return 0;
1149 /* Delete FRAME. When FORCE equals Qnoelisp, delete FRAME
1150 unconditionally. x_connection_closed and delete_terminal use
1151 this. Any other value of FORCE implements the semantics
1152 described for Fdelete_frame. */
1153 Lisp_Object
1154 delete_frame (Lisp_Object frame, Lisp_Object force)
1156 struct frame *f;
1157 struct frame *sf = SELECTED_FRAME ();
1158 struct kboard *kb;
1160 int minibuffer_selected, tooltip_frame;
1162 if (EQ (frame, Qnil))
1164 f = sf;
1165 XSETFRAME (frame, f);
1167 else
1169 CHECK_FRAME (frame);
1170 f = XFRAME (frame);
1173 if (! FRAME_LIVE_P (f))
1174 return Qnil;
1176 if (NILP (force) && !other_visible_frames (f))
1177 error ("Attempt to delete the sole visible or iconified frame");
1179 /* x_connection_closed must have set FORCE to `noelisp' in order
1180 to delete the last frame, if it is gone. */
1181 if (NILP (XCDR (Vframe_list)) && !EQ (force, Qnoelisp))
1182 error ("Attempt to delete the only frame");
1184 /* Does this frame have a minibuffer, and is it the surrogate
1185 minibuffer for any other frame? */
1186 if (FRAME_HAS_MINIBUF_P (XFRAME (frame)))
1188 Lisp_Object frames;
1190 for (frames = Vframe_list;
1191 CONSP (frames);
1192 frames = XCDR (frames))
1194 Lisp_Object this;
1195 this = XCAR (frames);
1197 if (! EQ (this, frame)
1198 && EQ (frame,
1199 WINDOW_FRAME (XWINDOW
1200 (FRAME_MINIBUF_WINDOW (XFRAME (this))))))
1202 /* If we MUST delete this frame, delete the other first.
1203 But do this only if FORCE equals `noelisp'. */
1204 if (EQ (force, Qnoelisp))
1205 delete_frame (this, Qnoelisp);
1206 else
1207 error ("Attempt to delete a surrogate minibuffer frame");
1212 tooltip_frame = !NILP (Fframe_parameter (frame, intern ("tooltip")));
1214 /* Run `delete-frame-functions' unless FORCE is `noelisp' or
1215 frame is a tooltip. FORCE is set to `noelisp' when handling
1216 a disconnect from the terminal, so we don't dare call Lisp
1217 code. */
1218 if (NILP (Vrun_hooks) || tooltip_frame)
1220 else if (EQ (force, Qnoelisp))
1221 pending_funcalls
1222 = Fcons (list3 (Qrun_hook_with_args, Qdelete_frame_functions, frame),
1223 pending_funcalls);
1224 else
1226 #ifdef HAVE_X_WINDOWS
1227 /* Also, save clipboard to the clipboard manager. */
1228 x_clipboard_manager_save_frame (frame);
1229 #endif
1231 safe_call2 (Qrun_hook_with_args, Qdelete_frame_functions, frame);
1234 /* The hook may sometimes (indirectly) cause the frame to be deleted. */
1235 if (! FRAME_LIVE_P (f))
1236 return Qnil;
1238 /* At this point, we are committed to deleting the frame.
1239 There is no more chance for errors to prevent it. */
1241 minibuffer_selected = EQ (minibuf_window, selected_window);
1243 /* Don't let the frame remain selected. */
1244 if (f == sf)
1246 Lisp_Object tail, frame1;
1248 /* Look for another visible frame on the same terminal. */
1249 frame1 = next_frame (frame, Qvisible);
1251 /* If there is none, find *some* other frame. */
1252 if (NILP (frame1) || EQ (frame1, frame))
1254 FOR_EACH_FRAME (tail, frame1)
1256 if (! EQ (frame, frame1) && FRAME_LIVE_P (XFRAME (frame1)))
1257 break;
1260 #ifdef NS_IMPL_COCOA
1261 else
1262 /* Under NS, there is no system mechanism for choosing a new
1263 window to get focus -- it is left to application code.
1264 So the portion of THIS application interfacing with NS
1265 needs to know about it. We call Fraise_frame, but the
1266 purpose is really to transfer focus. */
1267 Fraise_frame (frame1);
1268 #endif
1270 do_switch_frame (frame1, 0, 1, Qnil);
1271 sf = SELECTED_FRAME ();
1274 /* Don't allow minibuf_window to remain on a deleted frame. */
1275 if (EQ (f->minibuffer_window, minibuf_window))
1277 Fset_window_buffer (sf->minibuffer_window,
1278 XWINDOW (minibuf_window)->buffer, Qnil);
1279 minibuf_window = sf->minibuffer_window;
1281 /* If the dying minibuffer window was selected,
1282 select the new one. */
1283 if (minibuffer_selected)
1284 Fselect_window (minibuf_window, Qnil);
1287 /* Don't let echo_area_window to remain on a deleted frame. */
1288 if (EQ (f->minibuffer_window, echo_area_window))
1289 echo_area_window = sf->minibuffer_window;
1291 /* Clear any X selections for this frame. */
1292 #ifdef HAVE_X_WINDOWS
1293 if (FRAME_X_P (f))
1294 x_clear_frame_selections (f);
1295 #endif
1297 /* Free glyphs.
1298 This function must be called before the window tree of the
1299 frame is deleted because windows contain dynamically allocated
1300 memory. */
1301 free_glyphs (f);
1303 #ifdef HAVE_WINDOW_SYSTEM
1304 /* Give chance to each font driver to free a frame specific data. */
1305 font_update_drivers (f, Qnil);
1306 #endif
1308 /* Mark all the windows that used to be on FRAME as deleted, and then
1309 remove the reference to them. */
1310 delete_all_child_windows (f->root_window);
1311 f->root_window = Qnil;
1313 Vframe_list = Fdelq (frame, Vframe_list);
1314 FRAME_SET_VISIBLE (f, 0);
1316 /* Allow the vector of menu bar contents to be freed in the next
1317 garbage collection. The frame object itself may not be garbage
1318 collected until much later, because recent_keys and other data
1319 structures can still refer to it. */
1320 f->menu_bar_vector = Qnil;
1322 free_font_driver_list (f);
1323 xfree (f->namebuf);
1324 xfree (f->decode_mode_spec_buffer);
1325 xfree (FRAME_INSERT_COST (f));
1326 xfree (FRAME_DELETEN_COST (f));
1327 xfree (FRAME_INSERTN_COST (f));
1328 xfree (FRAME_DELETE_COST (f));
1329 xfree (FRAME_MESSAGE_BUF (f));
1331 /* Since some events are handled at the interrupt level, we may get
1332 an event for f at any time; if we zero out the frame's terminal
1333 now, then we may trip up the event-handling code. Instead, we'll
1334 promise that the terminal of the frame must be valid until we
1335 have called the window-system-dependent frame destruction
1336 routine. */
1338 if (FRAME_TERMINAL (f)->delete_frame_hook)
1339 (*FRAME_TERMINAL (f)->delete_frame_hook) (f);
1342 struct terminal *terminal = FRAME_TERMINAL (f);
1343 f->output_data.nothing = 0;
1344 f->terminal = 0; /* Now the frame is dead. */
1346 /* If needed, delete the terminal that this frame was on.
1347 (This must be done after the frame is killed.) */
1348 terminal->reference_count--;
1349 #ifdef USE_GTK
1350 /* FIXME: Deleting the terminal crashes emacs because of a GTK
1351 bug.
1352 http://lists.gnu.org/archive/html/emacs-devel/2011-10/msg00363.html */
1353 if (terminal->reference_count == 0 && terminal->type == output_x_window)
1354 terminal->reference_count = 1;
1355 #endif /* USE_GTK */
1356 if (terminal->reference_count == 0)
1358 Lisp_Object tmp;
1359 XSETTERMINAL (tmp, terminal);
1361 kb = NULL;
1362 Fdelete_terminal (tmp, NILP (force) ? Qt : force);
1364 else
1365 kb = terminal->kboard;
1368 /* If we've deleted the last_nonminibuf_frame, then try to find
1369 another one. */
1370 if (f == last_nonminibuf_frame)
1372 Lisp_Object frames;
1374 last_nonminibuf_frame = 0;
1376 for (frames = Vframe_list;
1377 CONSP (frames);
1378 frames = XCDR (frames))
1380 f = XFRAME (XCAR (frames));
1381 if (!FRAME_MINIBUF_ONLY_P (f))
1383 last_nonminibuf_frame = f;
1384 break;
1389 /* If there's no other frame on the same kboard, get out of
1390 single-kboard state if we're in it for this kboard. */
1391 if (kb != NULL)
1393 Lisp_Object frames;
1394 /* Some frame we found on the same kboard, or nil if there are none. */
1395 Lisp_Object frame_on_same_kboard;
1397 frame_on_same_kboard = Qnil;
1399 for (frames = Vframe_list;
1400 CONSP (frames);
1401 frames = XCDR (frames))
1403 Lisp_Object this;
1404 struct frame *f1;
1406 this = XCAR (frames);
1407 if (!FRAMEP (this))
1408 abort ();
1409 f1 = XFRAME (this);
1411 if (kb == FRAME_KBOARD (f1))
1412 frame_on_same_kboard = this;
1415 if (NILP (frame_on_same_kboard))
1416 not_single_kboard_state (kb);
1420 /* If we've deleted this keyboard's default_minibuffer_frame, try to
1421 find another one. Prefer minibuffer-only frames, but also notice
1422 frames with other windows. */
1423 if (kb != NULL && EQ (frame, KVAR (kb, Vdefault_minibuffer_frame)))
1425 Lisp_Object frames;
1427 /* The last frame we saw with a minibuffer, minibuffer-only or not. */
1428 Lisp_Object frame_with_minibuf;
1429 /* Some frame we found on the same kboard, or nil if there are none. */
1430 Lisp_Object frame_on_same_kboard;
1432 frame_on_same_kboard = Qnil;
1433 frame_with_minibuf = Qnil;
1435 for (frames = Vframe_list;
1436 CONSP (frames);
1437 frames = XCDR (frames))
1439 Lisp_Object this;
1440 struct frame *f1;
1442 this = XCAR (frames);
1443 if (!FRAMEP (this))
1444 abort ();
1445 f1 = XFRAME (this);
1447 /* Consider only frames on the same kboard
1448 and only those with minibuffers. */
1449 if (kb == FRAME_KBOARD (f1)
1450 && FRAME_HAS_MINIBUF_P (f1))
1452 frame_with_minibuf = this;
1453 if (FRAME_MINIBUF_ONLY_P (f1))
1454 break;
1457 if (kb == FRAME_KBOARD (f1))
1458 frame_on_same_kboard = this;
1461 if (!NILP (frame_on_same_kboard))
1463 /* We know that there must be some frame with a minibuffer out
1464 there. If this were not true, all of the frames present
1465 would have to be minibufferless, which implies that at some
1466 point their minibuffer frames must have been deleted, but
1467 that is prohibited at the top; you can't delete surrogate
1468 minibuffer frames. */
1469 if (NILP (frame_with_minibuf))
1470 abort ();
1472 KVAR (kb, Vdefault_minibuffer_frame) = frame_with_minibuf;
1474 else
1475 /* No frames left on this kboard--say no minibuffer either. */
1476 KVAR (kb, Vdefault_minibuffer_frame) = Qnil;
1479 /* Cause frame titles to update--necessary if we now have just one frame. */
1480 if (!tooltip_frame)
1481 update_mode_lines = 1;
1483 return Qnil;
1486 DEFUN ("delete-frame", Fdelete_frame, Sdelete_frame, 0, 2, "",
1487 doc: /* Delete FRAME, permanently eliminating it from use.
1488 FRAME defaults to the selected frame.
1490 A frame may not be deleted if its minibuffer is used by other frames.
1491 Normally, you may not delete a frame if all other frames are invisible,
1492 but if the second optional argument FORCE is non-nil, you may do so.
1494 This function runs `delete-frame-functions' before actually
1495 deleting the frame, unless the frame is a tooltip.
1496 The functions are run with one argument, the frame to be deleted. */)
1497 (Lisp_Object frame, Lisp_Object force)
1499 return delete_frame (frame, !NILP (force) ? Qt : Qnil);
1503 /* Return mouse position in character cell units. */
1505 DEFUN ("mouse-position", Fmouse_position, Smouse_position, 0, 0, 0,
1506 doc: /* Return a list (FRAME X . Y) giving the current mouse frame and position.
1507 The position is given in character cells, where (0, 0) is the
1508 upper-left corner of the frame, X is the horizontal offset, and Y is
1509 the vertical offset.
1510 If Emacs is running on a mouseless terminal or hasn't been programmed
1511 to read the mouse position, it returns the selected frame for FRAME
1512 and nil for X and Y.
1513 If `mouse-position-function' is non-nil, `mouse-position' calls it,
1514 passing the normal return value to that function as an argument,
1515 and returns whatever that function returns. */)
1516 (void)
1518 FRAME_PTR f;
1519 Lisp_Object lispy_dummy;
1520 enum scroll_bar_part party_dummy;
1521 Lisp_Object x, y, retval;
1522 int col, row;
1523 Time long_dummy;
1524 struct gcpro gcpro1;
1526 f = SELECTED_FRAME ();
1527 x = y = Qnil;
1529 #if defined (HAVE_MOUSE) || defined (HAVE_GPM)
1530 /* It's okay for the hook to refrain from storing anything. */
1531 if (FRAME_TERMINAL (f)->mouse_position_hook)
1532 (*FRAME_TERMINAL (f)->mouse_position_hook) (&f, -1,
1533 &lispy_dummy, &party_dummy,
1534 &x, &y,
1535 &long_dummy);
1536 if (! NILP (x))
1538 col = XINT (x);
1539 row = XINT (y);
1540 pixel_to_glyph_coords (f, col, row, &col, &row, NULL, 1);
1541 XSETINT (x, col);
1542 XSETINT (y, row);
1544 #endif
1545 XSETFRAME (lispy_dummy, f);
1546 retval = Fcons (lispy_dummy, Fcons (x, y));
1547 GCPRO1 (retval);
1548 if (!NILP (Vmouse_position_function))
1549 retval = call1 (Vmouse_position_function, retval);
1550 RETURN_UNGCPRO (retval);
1553 DEFUN ("mouse-pixel-position", Fmouse_pixel_position,
1554 Smouse_pixel_position, 0, 0, 0,
1555 doc: /* Return a list (FRAME X . Y) giving the current mouse frame and position.
1556 The position is given in pixel units, where (0, 0) is the
1557 upper-left corner of the frame, X is the horizontal offset, and Y is
1558 the vertical offset.
1559 If Emacs is running on a mouseless terminal or hasn't been programmed
1560 to read the mouse position, it returns the selected frame for FRAME
1561 and nil for X and Y. */)
1562 (void)
1564 FRAME_PTR f;
1565 Lisp_Object lispy_dummy;
1566 enum scroll_bar_part party_dummy;
1567 Lisp_Object x, y;
1568 Time long_dummy;
1570 f = SELECTED_FRAME ();
1571 x = y = Qnil;
1573 #if defined (HAVE_MOUSE) || defined (HAVE_GPM)
1574 /* It's okay for the hook to refrain from storing anything. */
1575 if (FRAME_TERMINAL (f)->mouse_position_hook)
1576 (*FRAME_TERMINAL (f)->mouse_position_hook) (&f, -1,
1577 &lispy_dummy, &party_dummy,
1578 &x, &y,
1579 &long_dummy);
1580 #endif
1581 XSETFRAME (lispy_dummy, f);
1582 return Fcons (lispy_dummy, Fcons (x, y));
1585 DEFUN ("set-mouse-position", Fset_mouse_position, Sset_mouse_position, 3, 3, 0,
1586 doc: /* Move the mouse pointer to the center of character cell (X,Y) in FRAME.
1587 Coordinates are relative to the frame, not a window,
1588 so the coordinates of the top left character in the frame
1589 may be nonzero due to left-hand scroll bars or the menu bar.
1591 The position is given in character cells, where (0, 0) is the
1592 upper-left corner of the frame, X is the horizontal offset, and Y is
1593 the vertical offset.
1595 This function is a no-op for an X frame that is not visible.
1596 If you have just created a frame, you must wait for it to become visible
1597 before calling this function on it, like this.
1598 (while (not (frame-visible-p frame)) (sleep-for .5)) */)
1599 (Lisp_Object frame, Lisp_Object x, Lisp_Object y)
1601 CHECK_LIVE_FRAME (frame);
1602 CHECK_TYPE_RANGED_INTEGER (int, x);
1603 CHECK_TYPE_RANGED_INTEGER (int, y);
1605 /* I think this should be done with a hook. */
1606 #ifdef HAVE_WINDOW_SYSTEM
1607 if (FRAME_WINDOW_P (XFRAME (frame)))
1608 /* Warping the mouse will cause enternotify and focus events. */
1609 x_set_mouse_position (XFRAME (frame), XINT (x), XINT (y));
1610 #else
1611 #if defined (MSDOS) && defined (HAVE_MOUSE)
1612 if (FRAME_MSDOS_P (XFRAME (frame)))
1614 Fselect_frame (frame, Qnil);
1615 mouse_moveto (XINT (x), XINT (y));
1617 #else
1618 #ifdef HAVE_GPM
1620 Fselect_frame (frame, Qnil);
1621 term_mouse_moveto (XINT (x), XINT (y));
1623 #endif
1624 #endif
1625 #endif
1627 return Qnil;
1630 DEFUN ("set-mouse-pixel-position", Fset_mouse_pixel_position,
1631 Sset_mouse_pixel_position, 3, 3, 0,
1632 doc: /* Move the mouse pointer to pixel position (X,Y) in FRAME.
1633 The position is given in pixels, where (0, 0) is the upper-left corner
1634 of the frame, X is the horizontal offset, and Y is the vertical offset.
1636 Note, this is a no-op for an X frame that is not visible.
1637 If you have just created a frame, you must wait for it to become visible
1638 before calling this function on it, like this.
1639 (while (not (frame-visible-p frame)) (sleep-for .5)) */)
1640 (Lisp_Object frame, Lisp_Object x, Lisp_Object y)
1642 CHECK_LIVE_FRAME (frame);
1643 CHECK_TYPE_RANGED_INTEGER (int, x);
1644 CHECK_TYPE_RANGED_INTEGER (int, y);
1646 /* I think this should be done with a hook. */
1647 #ifdef HAVE_WINDOW_SYSTEM
1648 if (FRAME_WINDOW_P (XFRAME (frame)))
1649 /* Warping the mouse will cause enternotify and focus events. */
1650 x_set_mouse_pixel_position (XFRAME (frame), XINT (x), XINT (y));
1651 #else
1652 #if defined (MSDOS) && defined (HAVE_MOUSE)
1653 if (FRAME_MSDOS_P (XFRAME (frame)))
1655 Fselect_frame (frame, Qnil);
1656 mouse_moveto (XINT (x), XINT (y));
1658 #else
1659 #ifdef HAVE_GPM
1661 Fselect_frame (frame, Qnil);
1662 term_mouse_moveto (XINT (x), XINT (y));
1664 #endif
1665 #endif
1666 #endif
1668 return Qnil;
1671 static void make_frame_visible_1 (Lisp_Object);
1673 DEFUN ("make-frame-visible", Fmake_frame_visible, Smake_frame_visible,
1674 0, 1, "",
1675 doc: /* Make the frame FRAME visible (assuming it is an X window).
1676 If omitted, FRAME defaults to the currently selected frame. */)
1677 (Lisp_Object frame)
1679 if (NILP (frame))
1680 frame = selected_frame;
1682 CHECK_LIVE_FRAME (frame);
1684 /* I think this should be done with a hook. */
1685 #ifdef HAVE_WINDOW_SYSTEM
1686 if (FRAME_WINDOW_P (XFRAME (frame)))
1688 FRAME_SAMPLE_VISIBILITY (XFRAME (frame));
1689 x_make_frame_visible (XFRAME (frame));
1691 #endif
1693 make_frame_visible_1 (XFRAME (frame)->root_window);
1695 /* Make menu bar update for the Buffers and Frames menus. */
1696 windows_or_buffers_changed++;
1698 return frame;
1701 /* Update the display_time slot of the buffers shown in WINDOW
1702 and all its descendants. */
1704 static void
1705 make_frame_visible_1 (Lisp_Object window)
1707 struct window *w;
1709 for (;!NILP (window); window = w->next)
1711 w = XWINDOW (window);
1713 if (!NILP (w->buffer))
1714 BVAR (XBUFFER (w->buffer), display_time) = Fcurrent_time ();
1716 if (!NILP (w->vchild))
1717 make_frame_visible_1 (w->vchild);
1718 if (!NILP (w->hchild))
1719 make_frame_visible_1 (w->hchild);
1723 DEFUN ("make-frame-invisible", Fmake_frame_invisible, Smake_frame_invisible,
1724 0, 2, "",
1725 doc: /* Make the frame FRAME invisible.
1726 If omitted, FRAME defaults to the currently selected frame.
1727 On graphical displays, invisible frames are not updated and are
1728 usually not displayed at all, even in a window system's \"taskbar\".
1730 Normally you may not make FRAME invisible if all other frames are invisible,
1731 but if the second optional argument FORCE is non-nil, you may do so.
1733 This function has no effect on text-only terminal frames. Such frames
1734 are always considered visible, whether or not they are currently being
1735 displayed in the terminal. */)
1736 (Lisp_Object frame, Lisp_Object force)
1738 if (NILP (frame))
1739 frame = selected_frame;
1741 CHECK_LIVE_FRAME (frame);
1743 if (NILP (force) && !other_visible_frames (XFRAME (frame)))
1744 error ("Attempt to make invisible the sole visible or iconified frame");
1746 #if 0 /* This isn't logically necessary, and it can do GC. */
1747 /* Don't let the frame remain selected. */
1748 if (EQ (frame, selected_frame))
1749 do_switch_frame (next_frame (frame, Qt), 0, 0, Qnil)
1750 #endif
1752 /* Don't allow minibuf_window to remain on a deleted frame. */
1753 if (EQ (XFRAME (frame)->minibuffer_window, minibuf_window))
1755 struct frame *sf = XFRAME (selected_frame);
1756 Fset_window_buffer (sf->minibuffer_window,
1757 XWINDOW (minibuf_window)->buffer, Qnil);
1758 minibuf_window = sf->minibuffer_window;
1761 /* I think this should be done with a hook. */
1762 #ifdef HAVE_WINDOW_SYSTEM
1763 if (FRAME_WINDOW_P (XFRAME (frame)))
1764 x_make_frame_invisible (XFRAME (frame));
1765 #endif
1767 /* Make menu bar update for the Buffers and Frames menus. */
1768 windows_or_buffers_changed++;
1770 return Qnil;
1773 DEFUN ("iconify-frame", Ficonify_frame, Siconify_frame,
1774 0, 1, "",
1775 doc: /* Make the frame FRAME into an icon.
1776 If omitted, FRAME defaults to the currently selected frame. */)
1777 (Lisp_Object frame)
1779 if (NILP (frame))
1780 frame = selected_frame;
1782 CHECK_LIVE_FRAME (frame);
1784 #if 0 /* This isn't logically necessary, and it can do GC. */
1785 /* Don't let the frame remain selected. */
1786 if (EQ (frame, selected_frame))
1787 Fhandle_switch_frame (next_frame (frame, Qt));
1788 #endif
1790 /* Don't allow minibuf_window to remain on a deleted frame. */
1791 if (EQ (XFRAME (frame)->minibuffer_window, minibuf_window))
1793 struct frame *sf = XFRAME (selected_frame);
1794 Fset_window_buffer (sf->minibuffer_window,
1795 XWINDOW (minibuf_window)->buffer, Qnil);
1796 minibuf_window = sf->minibuffer_window;
1799 /* I think this should be done with a hook. */
1800 #ifdef HAVE_WINDOW_SYSTEM
1801 if (FRAME_WINDOW_P (XFRAME (frame)))
1802 x_iconify_frame (XFRAME (frame));
1803 #endif
1805 /* Make menu bar update for the Buffers and Frames menus. */
1806 windows_or_buffers_changed++;
1808 return Qnil;
1811 DEFUN ("frame-visible-p", Fframe_visible_p, Sframe_visible_p,
1812 1, 1, 0,
1813 doc: /* Return t if FRAME is \"visible\" (actually in use for display).
1814 Return the symbol `icon' if FRAME is iconified or \"minimized\".
1815 Return nil if FRAME was made invisible, via `make-frame-invisible'.
1816 On graphical displays, invisible frames are not updated and are
1817 usually not displayed at all, even in a window system's \"taskbar\".
1819 If FRAME is a text-only terminal frame, this always returns t.
1820 Such frames are always considered visible, whether or not they are
1821 currently being displayed on the terminal. */)
1822 (Lisp_Object frame)
1824 CHECK_LIVE_FRAME (frame);
1826 FRAME_SAMPLE_VISIBILITY (XFRAME (frame));
1828 if (FRAME_VISIBLE_P (XFRAME (frame)))
1829 return Qt;
1830 if (FRAME_ICONIFIED_P (XFRAME (frame)))
1831 return Qicon;
1832 return Qnil;
1835 DEFUN ("visible-frame-list", Fvisible_frame_list, Svisible_frame_list,
1836 0, 0, 0,
1837 doc: /* Return a list of all frames now \"visible\" (being updated). */)
1838 (void)
1840 Lisp_Object tail, frame;
1841 struct frame *f;
1842 Lisp_Object value;
1844 value = Qnil;
1845 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
1847 frame = XCAR (tail);
1848 if (!FRAMEP (frame))
1849 continue;
1850 f = XFRAME (frame);
1851 if (FRAME_VISIBLE_P (f))
1852 value = Fcons (frame, value);
1854 return value;
1858 DEFUN ("raise-frame", Fraise_frame, Sraise_frame, 0, 1, "",
1859 doc: /* Bring FRAME to the front, so it occludes any frames it overlaps.
1860 If FRAME is invisible or iconified, make it visible.
1861 If you don't specify a frame, the selected frame is used.
1862 If Emacs is displaying on an ordinary terminal or some other device which
1863 doesn't support multiple overlapping frames, this function selects FRAME. */)
1864 (Lisp_Object frame)
1866 struct frame *f;
1867 if (NILP (frame))
1868 frame = selected_frame;
1870 CHECK_LIVE_FRAME (frame);
1872 f = XFRAME (frame);
1874 if (FRAME_TERMCAP_P (f))
1875 /* On a text-only terminal select FRAME. */
1876 Fselect_frame (frame, Qnil);
1877 else
1878 /* Do like the documentation says. */
1879 Fmake_frame_visible (frame);
1881 if (FRAME_TERMINAL (f)->frame_raise_lower_hook)
1882 (*FRAME_TERMINAL (f)->frame_raise_lower_hook) (f, 1);
1884 return Qnil;
1887 /* Should we have a corresponding function called Flower_Power? */
1888 DEFUN ("lower-frame", Flower_frame, Slower_frame, 0, 1, "",
1889 doc: /* Send FRAME to the back, so it is occluded by any frames that overlap it.
1890 If you don't specify a frame, the selected frame is used.
1891 If Emacs is displaying on an ordinary terminal or some other device which
1892 doesn't support multiple overlapping frames, this function does nothing. */)
1893 (Lisp_Object frame)
1895 struct frame *f;
1897 if (NILP (frame))
1898 frame = selected_frame;
1900 CHECK_LIVE_FRAME (frame);
1902 f = XFRAME (frame);
1904 if (FRAME_TERMINAL (f)->frame_raise_lower_hook)
1905 (*FRAME_TERMINAL (f)->frame_raise_lower_hook) (f, 0);
1907 return Qnil;
1911 DEFUN ("redirect-frame-focus", Fredirect_frame_focus, Sredirect_frame_focus,
1912 1, 2, 0,
1913 doc: /* Arrange for keystrokes typed at FRAME to be sent to FOCUS-FRAME.
1914 In other words, switch-frame events caused by events in FRAME will
1915 request a switch to FOCUS-FRAME, and `last-event-frame' will be
1916 FOCUS-FRAME after reading an event typed at FRAME.
1918 If FOCUS-FRAME is omitted or nil, any existing redirection is
1919 canceled, and the frame again receives its own keystrokes.
1921 Focus redirection is useful for temporarily redirecting keystrokes to
1922 a surrogate minibuffer frame when a frame doesn't have its own
1923 minibuffer window.
1925 A frame's focus redirection can be changed by `select-frame'. If frame
1926 FOO is selected, and then a different frame BAR is selected, any
1927 frames redirecting their focus to FOO are shifted to redirect their
1928 focus to BAR. This allows focus redirection to work properly when the
1929 user switches from one frame to another using `select-window'.
1931 This means that a frame whose focus is redirected to itself is treated
1932 differently from a frame whose focus is redirected to nil; the former
1933 is affected by `select-frame', while the latter is not.
1935 The redirection lasts until `redirect-frame-focus' is called to change it. */)
1936 (Lisp_Object frame, Lisp_Object focus_frame)
1938 struct frame *f;
1940 /* Note that we don't check for a live frame here. It's reasonable
1941 to redirect the focus of a frame you're about to delete, if you
1942 know what other frame should receive those keystrokes. */
1943 CHECK_FRAME (frame);
1945 if (! NILP (focus_frame))
1946 CHECK_LIVE_FRAME (focus_frame);
1948 f = XFRAME (frame);
1950 f->focus_frame = focus_frame;
1952 if (FRAME_TERMINAL (f)->frame_rehighlight_hook)
1953 (*FRAME_TERMINAL (f)->frame_rehighlight_hook) (f);
1955 return Qnil;
1959 DEFUN ("frame-focus", Fframe_focus, Sframe_focus, 1, 1, 0,
1960 doc: /* Return the frame to which FRAME's keystrokes are currently being sent.
1961 This returns nil if FRAME's focus is not redirected.
1962 See `redirect-frame-focus'. */)
1963 (Lisp_Object frame)
1965 CHECK_LIVE_FRAME (frame);
1967 return FRAME_FOCUS_FRAME (XFRAME (frame));
1972 /* Return the value of frame parameter PROP in frame FRAME. */
1974 #if !HAVE_NS
1975 static
1976 #endif
1977 Lisp_Object
1978 get_frame_param (register struct frame *frame, Lisp_Object prop)
1980 register Lisp_Object tem;
1982 tem = Fassq (prop, frame->param_alist);
1983 if (EQ (tem, Qnil))
1984 return tem;
1985 return Fcdr (tem);
1988 /* Return the buffer-predicate of the selected frame. */
1990 Lisp_Object
1991 frame_buffer_predicate (Lisp_Object frame)
1993 return XFRAME (frame)->buffer_predicate;
1996 /* Return the buffer-list of the selected frame. */
1998 static Lisp_Object
1999 frame_buffer_list (Lisp_Object frame)
2001 return XFRAME (frame)->buffer_list;
2004 /* Discard BUFFER from the buffer-list and buried-buffer-list of each frame. */
2006 void
2007 frames_discard_buffer (Lisp_Object buffer)
2009 Lisp_Object frame, tail;
2011 FOR_EACH_FRAME (tail, frame)
2013 XFRAME (frame)->buffer_list
2014 = Fdelq (buffer, XFRAME (frame)->buffer_list);
2015 XFRAME (frame)->buried_buffer_list
2016 = Fdelq (buffer, XFRAME (frame)->buried_buffer_list);
2020 /* Modify the alist in *ALISTPTR to associate PROP with VAL.
2021 If the alist already has an element for PROP, we change it. */
2023 void
2024 store_in_alist (Lisp_Object *alistptr, Lisp_Object prop, Lisp_Object val)
2026 register Lisp_Object tem;
2028 tem = Fassq (prop, *alistptr);
2029 if (EQ (tem, Qnil))
2030 *alistptr = Fcons (Fcons (prop, val), *alistptr);
2031 else
2032 Fsetcdr (tem, val);
2035 static int
2036 frame_name_fnn_p (char *str, ptrdiff_t len)
2038 if (len > 1 && str[0] == 'F' && '0' <= str[1] && str[1] <= '9')
2040 char *p = str + 2;
2041 while ('0' <= *p && *p <= '9')
2042 p++;
2043 if (p == str + len)
2044 return 1;
2046 return 0;
2049 /* Set the name of the terminal frame. Also used by MSDOS frames.
2050 Modeled after x_set_name which is used for WINDOW frames. */
2052 static void
2053 set_term_frame_name (struct frame *f, Lisp_Object name)
2055 f->explicit_name = ! NILP (name);
2057 /* If NAME is nil, set the name to F<num>. */
2058 if (NILP (name))
2060 char namebuf[sizeof "F" + INT_STRLEN_BOUND (printmax_t)];
2062 /* Check for no change needed in this very common case
2063 before we do any consing. */
2064 if (frame_name_fnn_p (SSDATA (f->name),
2065 SBYTES (f->name)))
2066 return;
2068 tty_frame_count++;
2069 sprintf (namebuf, "F%"pMd, tty_frame_count);
2070 name = build_string (namebuf);
2072 else
2074 CHECK_STRING (name);
2076 /* Don't change the name if it's already NAME. */
2077 if (! NILP (Fstring_equal (name, f->name)))
2078 return;
2080 /* Don't allow the user to set the frame name to F<num>, so it
2081 doesn't clash with the names we generate for terminal frames. */
2082 if (frame_name_fnn_p (SSDATA (name), SBYTES (name)))
2083 error ("Frame names of the form F<num> are usurped by Emacs");
2086 f->name = name;
2087 update_mode_lines = 1;
2090 void
2091 store_frame_param (struct frame *f, Lisp_Object prop, Lisp_Object val)
2093 register Lisp_Object old_alist_elt;
2095 /* The buffer-list parameters are stored in a special place and not
2096 in the alist. All buffers must be live. */
2097 if (EQ (prop, Qbuffer_list))
2099 Lisp_Object list = Qnil;
2100 for (; CONSP (val); val = XCDR (val))
2101 if (!NILP (Fbuffer_live_p (XCAR (val))))
2102 list = Fcons (XCAR (val), list);
2103 f->buffer_list = Fnreverse (list);
2104 return;
2106 if (EQ (prop, Qburied_buffer_list))
2108 Lisp_Object list = Qnil;
2109 for (; CONSP (val); val = XCDR (val))
2110 if (!NILP (Fbuffer_live_p (XCAR (val))))
2111 list = Fcons (XCAR (val), list);
2112 f->buried_buffer_list = Fnreverse (list);
2113 return;
2116 /* If PROP is a symbol which is supposed to have frame-local values,
2117 and it is set up based on this frame, switch to the global
2118 binding. That way, we can create or alter the frame-local binding
2119 without messing up the symbol's status. */
2120 if (SYMBOLP (prop))
2122 struct Lisp_Symbol *sym = XSYMBOL (prop);
2123 start:
2124 switch (sym->redirect)
2126 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
2127 case SYMBOL_PLAINVAL: case SYMBOL_FORWARDED: break;
2128 case SYMBOL_LOCALIZED:
2129 { struct Lisp_Buffer_Local_Value *blv = sym->val.blv;
2130 if (blv->frame_local && BLV_FOUND (blv) && XFRAME (blv->where) == f)
2131 swap_in_global_binding (sym);
2132 break;
2134 default: abort ();
2138 /* The tty color needed to be set before the frame's parameter
2139 alist was updated with the new value. This is not true any more,
2140 but we still do this test early on. */
2141 if (FRAME_TERMCAP_P (f) && EQ (prop, Qtty_color_mode)
2142 && f == FRAME_TTY (f)->previous_frame)
2143 /* Force redisplay of this tty. */
2144 FRAME_TTY (f)->previous_frame = NULL;
2146 /* Update the frame parameter alist. */
2147 old_alist_elt = Fassq (prop, f->param_alist);
2148 if (EQ (old_alist_elt, Qnil))
2149 f->param_alist = Fcons (Fcons (prop, val), f->param_alist);
2150 else
2151 Fsetcdr (old_alist_elt, val);
2153 /* Update some other special parameters in their special places
2154 in addition to the alist. */
2156 if (EQ (prop, Qbuffer_predicate))
2157 f->buffer_predicate = val;
2159 if (! FRAME_WINDOW_P (f))
2161 if (EQ (prop, Qmenu_bar_lines))
2162 set_menu_bar_lines (f, val, make_number (FRAME_MENU_BAR_LINES (f)));
2163 else if (EQ (prop, Qname))
2164 set_term_frame_name (f, val);
2167 if (EQ (prop, Qminibuffer) && WINDOWP (val))
2169 if (! MINI_WINDOW_P (XWINDOW (val)))
2170 error ("Surrogate minibuffer windows must be minibuffer windows");
2172 if ((FRAME_HAS_MINIBUF_P (f) || FRAME_MINIBUF_ONLY_P (f))
2173 && !EQ (val, f->minibuffer_window))
2174 error ("Can't change the surrogate minibuffer of a frame with its own minibuffer");
2176 /* Install the chosen minibuffer window, with proper buffer. */
2177 f->minibuffer_window = val;
2181 DEFUN ("frame-parameters", Fframe_parameters, Sframe_parameters, 0, 1, 0,
2182 doc: /* Return the parameters-alist of frame FRAME.
2183 It is a list of elements of the form (PARM . VALUE), where PARM is a symbol.
2184 The meaningful PARMs depend on the kind of frame.
2185 If FRAME is omitted, return information on the currently selected frame. */)
2186 (Lisp_Object frame)
2188 Lisp_Object alist;
2189 FRAME_PTR f;
2190 int height, width;
2191 struct gcpro gcpro1;
2193 if (NILP (frame))
2194 frame = selected_frame;
2196 CHECK_FRAME (frame);
2197 f = XFRAME (frame);
2199 if (!FRAME_LIVE_P (f))
2200 return Qnil;
2202 alist = Fcopy_alist (f->param_alist);
2203 GCPRO1 (alist);
2205 if (!FRAME_WINDOW_P (f))
2207 int fg = FRAME_FOREGROUND_PIXEL (f);
2208 int bg = FRAME_BACKGROUND_PIXEL (f);
2209 Lisp_Object elt;
2211 /* If the frame's parameter alist says the colors are
2212 unspecified and reversed, take the frame's background pixel
2213 for foreground and vice versa. */
2214 elt = Fassq (Qforeground_color, alist);
2215 if (CONSP (elt) && STRINGP (XCDR (elt)))
2217 if (strncmp (SSDATA (XCDR (elt)),
2218 unspecified_bg,
2219 SCHARS (XCDR (elt))) == 0)
2220 store_in_alist (&alist, Qforeground_color, tty_color_name (f, bg));
2221 else if (strncmp (SSDATA (XCDR (elt)),
2222 unspecified_fg,
2223 SCHARS (XCDR (elt))) == 0)
2224 store_in_alist (&alist, Qforeground_color, tty_color_name (f, fg));
2226 else
2227 store_in_alist (&alist, Qforeground_color, tty_color_name (f, fg));
2228 elt = Fassq (Qbackground_color, alist);
2229 if (CONSP (elt) && STRINGP (XCDR (elt)))
2231 if (strncmp (SSDATA (XCDR (elt)),
2232 unspecified_fg,
2233 SCHARS (XCDR (elt))) == 0)
2234 store_in_alist (&alist, Qbackground_color, tty_color_name (f, fg));
2235 else if (strncmp (SSDATA (XCDR (elt)),
2236 unspecified_bg,
2237 SCHARS (XCDR (elt))) == 0)
2238 store_in_alist (&alist, Qbackground_color, tty_color_name (f, bg));
2240 else
2241 store_in_alist (&alist, Qbackground_color, tty_color_name (f, bg));
2242 store_in_alist (&alist, intern ("font"),
2243 build_string (FRAME_MSDOS_P (f)
2244 ? "ms-dos"
2245 : FRAME_W32_P (f) ? "w32term"
2246 :"tty"));
2248 store_in_alist (&alist, Qname, f->name);
2249 height = (f->new_text_lines ? f->new_text_lines : FRAME_LINES (f));
2250 store_in_alist (&alist, Qheight, make_number (height));
2251 width = (f->new_text_cols ? f->new_text_cols : FRAME_COLS (f));
2252 store_in_alist (&alist, Qwidth, make_number (width));
2253 store_in_alist (&alist, Qmodeline, (FRAME_WANTS_MODELINE_P (f) ? Qt : Qnil));
2254 store_in_alist (&alist, Qminibuffer,
2255 (! FRAME_HAS_MINIBUF_P (f) ? Qnil
2256 : FRAME_MINIBUF_ONLY_P (f) ? Qonly
2257 : FRAME_MINIBUF_WINDOW (f)));
2258 store_in_alist (&alist, Qunsplittable, (FRAME_NO_SPLIT_P (f) ? Qt : Qnil));
2259 store_in_alist (&alist, Qbuffer_list, frame_buffer_list (frame));
2260 store_in_alist (&alist, Qburied_buffer_list, XFRAME (frame)->buried_buffer_list);
2262 /* I think this should be done with a hook. */
2263 #ifdef HAVE_WINDOW_SYSTEM
2264 if (FRAME_WINDOW_P (f))
2265 x_report_frame_params (f, &alist);
2266 else
2267 #endif
2269 /* This ought to be correct in f->param_alist for an X frame. */
2270 Lisp_Object lines;
2271 XSETFASTINT (lines, FRAME_MENU_BAR_LINES (f));
2272 store_in_alist (&alist, Qmenu_bar_lines, lines);
2275 UNGCPRO;
2276 return alist;
2280 DEFUN ("frame-parameter", Fframe_parameter, Sframe_parameter, 2, 2, 0,
2281 doc: /* Return FRAME's value for parameter PARAMETER.
2282 If FRAME is nil, describe the currently selected frame. */)
2283 (Lisp_Object frame, Lisp_Object parameter)
2285 struct frame *f;
2286 Lisp_Object value;
2288 if (NILP (frame))
2289 frame = selected_frame;
2290 else
2291 CHECK_FRAME (frame);
2292 CHECK_SYMBOL (parameter);
2294 f = XFRAME (frame);
2295 value = Qnil;
2297 if (FRAME_LIVE_P (f))
2299 /* Avoid consing in frequent cases. */
2300 if (EQ (parameter, Qname))
2301 value = f->name;
2302 #ifdef HAVE_X_WINDOWS
2303 else if (EQ (parameter, Qdisplay) && FRAME_X_P (f))
2304 value = XCAR (FRAME_X_DISPLAY_INFO (f)->name_list_element);
2305 #endif /* HAVE_X_WINDOWS */
2306 else if (EQ (parameter, Qbackground_color)
2307 || EQ (parameter, Qforeground_color))
2309 value = Fassq (parameter, f->param_alist);
2310 if (CONSP (value))
2312 value = XCDR (value);
2313 /* Fframe_parameters puts the actual fg/bg color names,
2314 even if f->param_alist says otherwise. This is
2315 important when param_alist's notion of colors is
2316 "unspecified". We need to do the same here. */
2317 if (STRINGP (value) && !FRAME_WINDOW_P (f))
2319 const char *color_name;
2320 ptrdiff_t csz;
2322 if (EQ (parameter, Qbackground_color))
2324 color_name = SSDATA (value);
2325 csz = SCHARS (value);
2326 if (strncmp (color_name, unspecified_bg, csz) == 0)
2327 value = tty_color_name (f, FRAME_BACKGROUND_PIXEL (f));
2328 else if (strncmp (color_name, unspecified_fg, csz) == 0)
2329 value = tty_color_name (f, FRAME_FOREGROUND_PIXEL (f));
2331 else if (EQ (parameter, Qforeground_color))
2333 color_name = SSDATA (value);
2334 csz = SCHARS (value);
2335 if (strncmp (color_name, unspecified_fg, csz) == 0)
2336 value = tty_color_name (f, FRAME_FOREGROUND_PIXEL (f));
2337 else if (strncmp (color_name, unspecified_bg, csz) == 0)
2338 value = tty_color_name (f, FRAME_BACKGROUND_PIXEL (f));
2342 else
2343 value = Fcdr (Fassq (parameter, Fframe_parameters (frame)));
2345 else if (EQ (parameter, Qdisplay_type)
2346 || EQ (parameter, Qbackground_mode))
2347 value = Fcdr (Fassq (parameter, f->param_alist));
2348 else
2349 /* FIXME: Avoid this code path at all (as well as code duplication)
2350 by sharing more code with Fframe_parameters. */
2351 value = Fcdr (Fassq (parameter, Fframe_parameters (frame)));
2354 return value;
2358 DEFUN ("modify-frame-parameters", Fmodify_frame_parameters,
2359 Smodify_frame_parameters, 2, 2, 0,
2360 doc: /* Modify the parameters of frame FRAME according to ALIST.
2361 If FRAME is nil, it defaults to the selected frame.
2362 ALIST is an alist of parameters to change and their new values.
2363 Each element of ALIST has the form (PARM . VALUE), where PARM is a symbol.
2364 The meaningful PARMs depend on the kind of frame.
2365 Undefined PARMs are ignored, but stored in the frame's parameter list
2366 so that `frame-parameters' will return them.
2368 The value of frame parameter FOO can also be accessed
2369 as a frame-local binding for the variable FOO, if you have
2370 enabled such bindings for that variable with `make-variable-frame-local'.
2371 Note that this functionality is obsolete as of Emacs 22.2, and its
2372 use is not recommended. Explicitly check for a frame-parameter instead. */)
2373 (Lisp_Object frame, Lisp_Object alist)
2375 FRAME_PTR f;
2376 register Lisp_Object tail, prop, val;
2378 if (EQ (frame, Qnil))
2379 frame = selected_frame;
2380 CHECK_LIVE_FRAME (frame);
2381 f = XFRAME (frame);
2383 /* I think this should be done with a hook. */
2384 #ifdef HAVE_WINDOW_SYSTEM
2385 if (FRAME_WINDOW_P (f))
2386 x_set_frame_parameters (f, alist);
2387 else
2388 #endif
2389 #ifdef MSDOS
2390 if (FRAME_MSDOS_P (f))
2391 IT_set_frame_parameters (f, alist);
2392 else
2393 #endif
2396 EMACS_INT length = XFASTINT (Flength (alist));
2397 ptrdiff_t i;
2398 Lisp_Object *parms;
2399 Lisp_Object *values;
2400 USE_SAFE_ALLOCA;
2401 SAFE_ALLOCA_LISP (parms, 2 * length);
2402 values = parms + length;
2404 /* Extract parm names and values into those vectors. */
2406 i = 0;
2407 for (tail = alist; CONSP (tail); tail = XCDR (tail))
2409 Lisp_Object elt;
2411 elt = XCAR (tail);
2412 parms[i] = Fcar (elt);
2413 values[i] = Fcdr (elt);
2414 i++;
2417 /* Now process them in reverse of specified order. */
2418 while (--i >= 0)
2420 prop = parms[i];
2421 val = values[i];
2422 store_frame_param (f, prop, val);
2424 if (EQ (prop, Qforeground_color)
2425 || EQ (prop, Qbackground_color))
2426 update_face_from_frame_parameter (f, prop, val);
2429 SAFE_FREE ();
2431 return Qnil;
2434 DEFUN ("frame-char-height", Fframe_char_height, Sframe_char_height,
2435 0, 1, 0,
2436 doc: /* Height in pixels of a line in the font in frame FRAME.
2437 If FRAME is omitted, the selected frame is used.
2438 For a terminal frame, the value is always 1. */)
2439 (Lisp_Object frame)
2441 struct frame *f;
2443 if (NILP (frame))
2444 frame = selected_frame;
2445 CHECK_FRAME (frame);
2446 f = XFRAME (frame);
2448 #ifdef HAVE_WINDOW_SYSTEM
2449 if (FRAME_WINDOW_P (f))
2450 return make_number (x_char_height (f));
2451 else
2452 #endif
2453 return make_number (1);
2457 DEFUN ("frame-char-width", Fframe_char_width, Sframe_char_width,
2458 0, 1, 0,
2459 doc: /* Width in pixels of characters in the font in frame FRAME.
2460 If FRAME is omitted, the selected frame is used.
2461 On a graphical screen, the width is the standard width of the default font.
2462 For a terminal screen, the value is always 1. */)
2463 (Lisp_Object frame)
2465 struct frame *f;
2467 if (NILP (frame))
2468 frame = selected_frame;
2469 CHECK_FRAME (frame);
2470 f = XFRAME (frame);
2472 #ifdef HAVE_WINDOW_SYSTEM
2473 if (FRAME_WINDOW_P (f))
2474 return make_number (x_char_width (f));
2475 else
2476 #endif
2477 return make_number (1);
2480 DEFUN ("frame-pixel-height", Fframe_pixel_height,
2481 Sframe_pixel_height, 0, 1, 0,
2482 doc: /* Return a FRAME's height in pixels.
2483 If FRAME is omitted, the selected frame is used. The exact value
2484 of the result depends on the window-system and toolkit in use:
2486 In the Gtk+ version of Emacs, it includes only any window (including
2487 the minibuffer or echo area), mode line, and header line. It does not
2488 include the tool bar or menu bar.
2490 With the Motif or Lucid toolkits, it also includes the tool bar (but
2491 not the menu bar).
2493 In a graphical version with no toolkit, it includes both the tool bar
2494 and menu bar.
2496 For a text-only terminal, it includes the menu bar. In this case, the
2497 result is really in characters rather than pixels (i.e., is identical
2498 to `frame-height'). */)
2499 (Lisp_Object frame)
2501 struct frame *f;
2503 if (NILP (frame))
2504 frame = selected_frame;
2505 CHECK_FRAME (frame);
2506 f = XFRAME (frame);
2508 #ifdef HAVE_WINDOW_SYSTEM
2509 if (FRAME_WINDOW_P (f))
2510 return make_number (x_pixel_height (f));
2511 else
2512 #endif
2513 return make_number (FRAME_LINES (f));
2516 DEFUN ("frame-pixel-width", Fframe_pixel_width,
2517 Sframe_pixel_width, 0, 1, 0,
2518 doc: /* Return FRAME's width in pixels.
2519 For a terminal frame, the result really gives the width in characters.
2520 If FRAME is omitted, the selected frame is used. */)
2521 (Lisp_Object frame)
2523 struct frame *f;
2525 if (NILP (frame))
2526 frame = selected_frame;
2527 CHECK_FRAME (frame);
2528 f = XFRAME (frame);
2530 #ifdef HAVE_WINDOW_SYSTEM
2531 if (FRAME_WINDOW_P (f))
2532 return make_number (x_pixel_width (f));
2533 else
2534 #endif
2535 return make_number (FRAME_COLS (f));
2538 DEFUN ("tool-bar-pixel-width", Ftool_bar_pixel_width,
2539 Stool_bar_pixel_width, 0, 1, 0,
2540 doc: /* Return width in pixels of FRAME's tool bar.
2541 The result is greater than zero only when the tool bar is on the left
2542 or right side of FRAME. If FRAME is omitted, the selected frame is
2543 used. */)
2544 (Lisp_Object frame)
2546 struct frame *f;
2548 if (NILP (frame))
2549 frame = selected_frame;
2550 CHECK_FRAME (frame);
2551 f = XFRAME (frame);
2553 #ifdef FRAME_TOOLBAR_WIDTH
2554 if (FRAME_WINDOW_P (f))
2555 return make_number (FRAME_TOOLBAR_WIDTH (f));
2556 #endif
2557 return make_number (0);
2560 DEFUN ("set-frame-height", Fset_frame_height, Sset_frame_height, 2, 3, 0,
2561 doc: /* Specify that the frame FRAME has LINES lines.
2562 Optional third arg non-nil means that redisplay should use LINES lines
2563 but that the idea of the actual height of the frame should not be changed. */)
2564 (Lisp_Object frame, Lisp_Object lines, Lisp_Object pretend)
2566 register struct frame *f;
2568 CHECK_TYPE_RANGED_INTEGER (int, lines);
2569 if (NILP (frame))
2570 frame = selected_frame;
2571 CHECK_LIVE_FRAME (frame);
2572 f = XFRAME (frame);
2574 /* I think this should be done with a hook. */
2575 #ifdef HAVE_WINDOW_SYSTEM
2576 if (FRAME_WINDOW_P (f))
2578 if (XINT (lines) != FRAME_LINES (f))
2579 x_set_window_size (f, 1, FRAME_COLS (f), XINT (lines));
2580 do_pending_window_change (0);
2582 else
2583 #endif
2584 change_frame_size (f, XINT (lines), 0, !NILP (pretend), 0, 0);
2585 return Qnil;
2588 DEFUN ("set-frame-width", Fset_frame_width, Sset_frame_width, 2, 3, 0,
2589 doc: /* Specify that the frame FRAME has COLS columns.
2590 Optional third arg non-nil means that redisplay should use COLS columns
2591 but that the idea of the actual width of the frame should not be changed. */)
2592 (Lisp_Object frame, Lisp_Object cols, Lisp_Object pretend)
2594 register struct frame *f;
2595 CHECK_TYPE_RANGED_INTEGER (int, cols);
2596 if (NILP (frame))
2597 frame = selected_frame;
2598 CHECK_LIVE_FRAME (frame);
2599 f = XFRAME (frame);
2601 /* I think this should be done with a hook. */
2602 #ifdef HAVE_WINDOW_SYSTEM
2603 if (FRAME_WINDOW_P (f))
2605 if (XINT (cols) != FRAME_COLS (f))
2606 x_set_window_size (f, 1, XINT (cols), FRAME_LINES (f));
2607 do_pending_window_change (0);
2609 else
2610 #endif
2611 change_frame_size (f, 0, XINT (cols), !NILP (pretend), 0, 0);
2612 return Qnil;
2615 DEFUN ("set-frame-size", Fset_frame_size, Sset_frame_size, 3, 3, 0,
2616 doc: /* Sets size of FRAME to COLS by ROWS, measured in characters. */)
2617 (Lisp_Object frame, Lisp_Object cols, Lisp_Object rows)
2619 register struct frame *f;
2621 CHECK_LIVE_FRAME (frame);
2622 CHECK_TYPE_RANGED_INTEGER (int, cols);
2623 CHECK_TYPE_RANGED_INTEGER (int, rows);
2624 f = XFRAME (frame);
2626 /* I think this should be done with a hook. */
2627 #ifdef HAVE_WINDOW_SYSTEM
2628 if (FRAME_WINDOW_P (f))
2630 if (XINT (rows) != FRAME_LINES (f)
2631 || XINT (cols) != FRAME_COLS (f)
2632 || f->new_text_lines || f->new_text_cols)
2633 x_set_window_size (f, 1, XINT (cols), XINT (rows));
2634 do_pending_window_change (0);
2636 else
2637 #endif
2638 change_frame_size (f, XINT (rows), XINT (cols), 0, 0, 0);
2640 return Qnil;
2643 DEFUN ("set-frame-position", Fset_frame_position,
2644 Sset_frame_position, 3, 3, 0,
2645 doc: /* Sets position of FRAME in pixels to XOFFSET by YOFFSET.
2646 This is actually the position of the upper left corner of the frame.
2647 Negative values for XOFFSET or YOFFSET are interpreted relative to
2648 the rightmost or bottommost possible position (that stays within the screen). */)
2649 (Lisp_Object frame, Lisp_Object xoffset, Lisp_Object yoffset)
2651 register struct frame *f;
2653 CHECK_LIVE_FRAME (frame);
2654 CHECK_TYPE_RANGED_INTEGER (int, xoffset);
2655 CHECK_TYPE_RANGED_INTEGER (int, yoffset);
2656 f = XFRAME (frame);
2658 /* I think this should be done with a hook. */
2659 #ifdef HAVE_WINDOW_SYSTEM
2660 if (FRAME_WINDOW_P (f))
2661 x_set_offset (f, XINT (xoffset), XINT (yoffset), 1);
2662 #endif
2664 return Qt;
2668 /***********************************************************************
2669 Frame Parameters
2670 ***********************************************************************/
2672 /* Connect the frame-parameter names for X frames
2673 to the ways of passing the parameter values to the window system.
2675 The name of a parameter, as a Lisp symbol,
2676 has an `x-frame-parameter' property which is an integer in Lisp
2677 that is an index in this table. */
2679 struct frame_parm_table {
2680 const char *name;
2681 Lisp_Object *variable;
2684 static const struct frame_parm_table frame_parms[] =
2686 {"auto-raise", &Qauto_raise},
2687 {"auto-lower", &Qauto_lower},
2688 {"background-color", 0},
2689 {"border-color", &Qborder_color},
2690 {"border-width", &Qborder_width},
2691 {"cursor-color", &Qcursor_color},
2692 {"cursor-type", &Qcursor_type},
2693 {"font", 0},
2694 {"foreground-color", 0},
2695 {"icon-name", &Qicon_name},
2696 {"icon-type", &Qicon_type},
2697 {"internal-border-width", &Qinternal_border_width},
2698 {"menu-bar-lines", &Qmenu_bar_lines},
2699 {"mouse-color", &Qmouse_color},
2700 {"name", &Qname},
2701 {"scroll-bar-width", &Qscroll_bar_width},
2702 {"title", &Qtitle},
2703 {"unsplittable", &Qunsplittable},
2704 {"vertical-scroll-bars", &Qvertical_scroll_bars},
2705 {"visibility", &Qvisibility},
2706 {"tool-bar-lines", &Qtool_bar_lines},
2707 {"scroll-bar-foreground", &Qscroll_bar_foreground},
2708 {"scroll-bar-background", &Qscroll_bar_background},
2709 {"screen-gamma", &Qscreen_gamma},
2710 {"line-spacing", &Qline_spacing},
2711 {"left-fringe", &Qleft_fringe},
2712 {"right-fringe", &Qright_fringe},
2713 {"wait-for-wm", &Qwait_for_wm},
2714 {"fullscreen", &Qfullscreen},
2715 {"font-backend", &Qfont_backend},
2716 {"alpha", &Qalpha},
2717 {"sticky", &Qsticky},
2718 {"tool-bar-position", &Qtool_bar_position},
2721 #ifdef WINDOWSNT
2723 /* Calculate fullscreen size. Return in *TOP_POS and *LEFT_POS the
2724 wanted positions of the WM window (not Emacs window).
2725 Return in *WIDTH and *HEIGHT the wanted width and height of Emacs
2726 window (FRAME_X_WINDOW).
2729 void
2730 x_fullscreen_adjust (struct frame *f, int *width, int *height, int *top_pos, int *left_pos)
2732 int newwidth = FRAME_COLS (f);
2733 int newheight = FRAME_LINES (f);
2734 Display_Info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
2736 *top_pos = f->top_pos;
2737 *left_pos = f->left_pos;
2739 if (f->want_fullscreen & FULLSCREEN_HEIGHT)
2741 int ph;
2743 ph = x_display_pixel_height (dpyinfo);
2744 newheight = FRAME_PIXEL_HEIGHT_TO_TEXT_LINES (f, ph);
2745 ph = FRAME_TEXT_LINES_TO_PIXEL_HEIGHT (f, newheight) - f->y_pixels_diff;
2746 newheight = FRAME_PIXEL_HEIGHT_TO_TEXT_LINES (f, ph);
2747 *top_pos = 0;
2750 if (f->want_fullscreen & FULLSCREEN_WIDTH)
2752 int pw;
2754 pw = x_display_pixel_width (dpyinfo);
2755 newwidth = FRAME_PIXEL_WIDTH_TO_TEXT_COLS (f, pw);
2756 pw = FRAME_TEXT_COLS_TO_PIXEL_WIDTH (f, newwidth) - f->x_pixels_diff;
2757 newwidth = FRAME_PIXEL_WIDTH_TO_TEXT_COLS (f, pw);
2758 *left_pos = 0;
2761 *width = newwidth;
2762 *height = newheight;
2765 #endif /* WINDOWSNT */
2767 #ifdef HAVE_WINDOW_SYSTEM
2769 /* Change the parameters of frame F as specified by ALIST.
2770 If a parameter is not specially recognized, do nothing special;
2771 otherwise call the `x_set_...' function for that parameter.
2772 Except for certain geometry properties, always call store_frame_param
2773 to store the new value in the parameter alist. */
2775 void
2776 x_set_frame_parameters (FRAME_PTR f, Lisp_Object alist)
2778 Lisp_Object tail;
2780 /* If both of these parameters are present, it's more efficient to
2781 set them both at once. So we wait until we've looked at the
2782 entire list before we set them. */
2783 int width, height;
2785 /* Same here. */
2786 Lisp_Object left, top;
2788 /* Same with these. */
2789 Lisp_Object icon_left, icon_top;
2791 /* Record in these vectors all the parms specified. */
2792 Lisp_Object *parms;
2793 Lisp_Object *values;
2794 ptrdiff_t i, p;
2795 int left_no_change = 0, top_no_change = 0;
2796 int icon_left_no_change = 0, icon_top_no_change = 0;
2797 int size_changed = 0;
2798 struct gcpro gcpro1, gcpro2;
2800 i = 0;
2801 for (tail = alist; CONSP (tail); tail = Fcdr (tail))
2802 i++;
2804 parms = (Lisp_Object *) alloca (i * sizeof (Lisp_Object));
2805 values = (Lisp_Object *) alloca (i * sizeof (Lisp_Object));
2807 /* Extract parm names and values into those vectors. */
2809 i = 0;
2810 for (tail = alist; CONSP (tail); tail = XCDR (tail))
2812 Lisp_Object elt;
2814 elt = XCAR (tail);
2815 parms[i] = Fcar (elt);
2816 values[i] = Fcdr (elt);
2817 i++;
2819 /* TAIL and ALIST are not used again below here. */
2820 alist = tail = Qnil;
2822 GCPRO2 (*parms, *values);
2823 gcpro1.nvars = i;
2824 gcpro2.nvars = i;
2826 /* There is no need to gcpro LEFT, TOP, ICON_LEFT, or ICON_TOP,
2827 because their values appear in VALUES and strings are not valid. */
2828 top = left = Qunbound;
2829 icon_left = icon_top = Qunbound;
2831 /* Provide default values for HEIGHT and WIDTH. */
2832 width = (f->new_text_cols ? f->new_text_cols : FRAME_COLS (f));
2833 height = (f->new_text_lines ? f->new_text_lines : FRAME_LINES (f));
2835 /* Process foreground_color and background_color before anything else.
2836 They are independent of other properties, but other properties (e.g.,
2837 cursor_color) are dependent upon them. */
2838 /* Process default font as well, since fringe widths depends on it. */
2839 for (p = 0; p < i; p++)
2841 Lisp_Object prop, val;
2843 prop = parms[p];
2844 val = values[p];
2845 if (EQ (prop, Qforeground_color)
2846 || EQ (prop, Qbackground_color)
2847 || EQ (prop, Qfont))
2849 register Lisp_Object param_index, old_value;
2851 old_value = get_frame_param (f, prop);
2852 if (NILP (Fequal (val, old_value)))
2854 store_frame_param (f, prop, val);
2856 param_index = Fget (prop, Qx_frame_parameter);
2857 if (NATNUMP (param_index)
2858 && (XFASTINT (param_index)
2859 < sizeof (frame_parms)/sizeof (frame_parms[0]))
2860 && FRAME_RIF (f)->frame_parm_handlers[XINT (param_index)])
2861 (*(FRAME_RIF (f)->frame_parm_handlers[XINT (param_index)])) (f, val, old_value);
2866 /* Now process them in reverse of specified order. */
2867 while (i-- != 0)
2869 Lisp_Object prop, val;
2871 prop = parms[i];
2872 val = values[i];
2874 if (EQ (prop, Qwidth) && RANGED_INTEGERP (0, val, INT_MAX))
2876 size_changed = 1;
2877 width = XFASTINT (val);
2879 else if (EQ (prop, Qheight) && RANGED_INTEGERP (0, val, INT_MAX))
2881 size_changed = 1;
2882 height = XFASTINT (val);
2884 else if (EQ (prop, Qtop))
2885 top = val;
2886 else if (EQ (prop, Qleft))
2887 left = val;
2888 else if (EQ (prop, Qicon_top))
2889 icon_top = val;
2890 else if (EQ (prop, Qicon_left))
2891 icon_left = val;
2892 else if (EQ (prop, Qforeground_color)
2893 || EQ (prop, Qbackground_color)
2894 || EQ (prop, Qfont))
2895 /* Processed above. */
2896 continue;
2897 else
2899 register Lisp_Object param_index, old_value;
2901 old_value = get_frame_param (f, prop);
2903 store_frame_param (f, prop, val);
2905 param_index = Fget (prop, Qx_frame_parameter);
2906 if (NATNUMP (param_index)
2907 && (XFASTINT (param_index)
2908 < sizeof (frame_parms)/sizeof (frame_parms[0]))
2909 && FRAME_RIF (f)->frame_parm_handlers[XINT (param_index)])
2910 (*(FRAME_RIF (f)->frame_parm_handlers[XINT (param_index)])) (f, val, old_value);
2914 /* Don't die if just one of these was set. */
2915 if (! TYPE_RANGED_INTEGERP (int, left))
2917 left_no_change = 1;
2918 if (f->left_pos < 0)
2919 left = Fcons (Qplus, Fcons (make_number (f->left_pos), Qnil));
2920 else
2921 XSETINT (left, f->left_pos);
2923 if (! TYPE_RANGED_INTEGERP (int, top))
2925 top_no_change = 1;
2926 if (f->top_pos < 0)
2927 top = Fcons (Qplus, Fcons (make_number (f->top_pos), Qnil));
2928 else
2929 XSETINT (top, f->top_pos);
2932 /* If one of the icon positions was not set, preserve or default it. */
2933 if (! TYPE_RANGED_INTEGERP (int, icon_left))
2935 icon_left_no_change = 1;
2936 icon_left = Fcdr (Fassq (Qicon_left, f->param_alist));
2937 if (NILP (icon_left))
2938 XSETINT (icon_left, 0);
2940 if (! TYPE_RANGED_INTEGERP (int, icon_top))
2942 icon_top_no_change = 1;
2943 icon_top = Fcdr (Fassq (Qicon_top, f->param_alist));
2944 if (NILP (icon_top))
2945 XSETINT (icon_top, 0);
2948 /* Don't set these parameters unless they've been explicitly
2949 specified. The window might be mapped or resized while we're in
2950 this function, and we don't want to override that unless the lisp
2951 code has asked for it.
2953 Don't set these parameters unless they actually differ from the
2954 window's current parameters; the window may not actually exist
2955 yet. */
2957 Lisp_Object frame;
2959 check_frame_size (f, &height, &width);
2961 XSETFRAME (frame, f);
2963 if (size_changed
2964 && (width != FRAME_COLS (f)
2965 || height != FRAME_LINES (f)
2966 || f->new_text_lines || f->new_text_cols))
2967 Fset_frame_size (frame, make_number (width), make_number (height));
2969 if ((!NILP (left) || !NILP (top))
2970 && ! (left_no_change && top_no_change)
2971 && ! (NUMBERP (left) && XINT (left) == f->left_pos
2972 && NUMBERP (top) && XINT (top) == f->top_pos))
2974 int leftpos = 0;
2975 int toppos = 0;
2977 /* Record the signs. */
2978 f->size_hint_flags &= ~ (XNegative | YNegative);
2979 if (EQ (left, Qminus))
2980 f->size_hint_flags |= XNegative;
2981 else if (TYPE_RANGED_INTEGERP (int, left))
2983 leftpos = XINT (left);
2984 if (leftpos < 0)
2985 f->size_hint_flags |= XNegative;
2987 else if (CONSP (left) && EQ (XCAR (left), Qminus)
2988 && CONSP (XCDR (left))
2989 && RANGED_INTEGERP (-INT_MAX, XCAR (XCDR (left)), INT_MAX))
2991 leftpos = - XINT (XCAR (XCDR (left)));
2992 f->size_hint_flags |= XNegative;
2994 else if (CONSP (left) && EQ (XCAR (left), Qplus)
2995 && CONSP (XCDR (left))
2996 && TYPE_RANGED_INTEGERP (int, XCAR (XCDR (left))))
2998 leftpos = XINT (XCAR (XCDR (left)));
3001 if (EQ (top, Qminus))
3002 f->size_hint_flags |= YNegative;
3003 else if (TYPE_RANGED_INTEGERP (int, top))
3005 toppos = XINT (top);
3006 if (toppos < 0)
3007 f->size_hint_flags |= YNegative;
3009 else if (CONSP (top) && EQ (XCAR (top), Qminus)
3010 && CONSP (XCDR (top))
3011 && RANGED_INTEGERP (-INT_MAX, XCAR (XCDR (top)), INT_MAX))
3013 toppos = - XINT (XCAR (XCDR (top)));
3014 f->size_hint_flags |= YNegative;
3016 else if (CONSP (top) && EQ (XCAR (top), Qplus)
3017 && CONSP (XCDR (top))
3018 && TYPE_RANGED_INTEGERP (int, XCAR (XCDR (top))))
3020 toppos = XINT (XCAR (XCDR (top)));
3024 /* Store the numeric value of the position. */
3025 f->top_pos = toppos;
3026 f->left_pos = leftpos;
3028 f->win_gravity = NorthWestGravity;
3030 /* Actually set that position, and convert to absolute. */
3031 x_set_offset (f, leftpos, toppos, -1);
3034 if ((!NILP (icon_left) || !NILP (icon_top))
3035 && ! (icon_left_no_change && icon_top_no_change))
3036 x_wm_set_icon_position (f, XINT (icon_left), XINT (icon_top));
3039 UNGCPRO;
3043 /* Insert a description of internally-recorded parameters of frame X
3044 into the parameter alist *ALISTPTR that is to be given to the user.
3045 Only parameters that are specific to the X window system
3046 and whose values are not correctly recorded in the frame's
3047 param_alist need to be considered here. */
3049 void
3050 x_report_frame_params (struct frame *f, Lisp_Object *alistptr)
3052 char buf[16];
3053 Lisp_Object tem;
3054 unsigned long w;
3056 /* Represent negative positions (off the top or left screen edge)
3057 in a way that Fmodify_frame_parameters will understand correctly. */
3058 XSETINT (tem, f->left_pos);
3059 if (f->left_pos >= 0)
3060 store_in_alist (alistptr, Qleft, tem);
3061 else
3062 store_in_alist (alistptr, Qleft, Fcons (Qplus, Fcons (tem, Qnil)));
3064 XSETINT (tem, f->top_pos);
3065 if (f->top_pos >= 0)
3066 store_in_alist (alistptr, Qtop, tem);
3067 else
3068 store_in_alist (alistptr, Qtop, Fcons (Qplus, Fcons (tem, Qnil)));
3070 store_in_alist (alistptr, Qborder_width,
3071 make_number (f->border_width));
3072 store_in_alist (alistptr, Qinternal_border_width,
3073 make_number (FRAME_INTERNAL_BORDER_WIDTH (f)));
3074 store_in_alist (alistptr, Qleft_fringe,
3075 make_number (FRAME_LEFT_FRINGE_WIDTH (f)));
3076 store_in_alist (alistptr, Qright_fringe,
3077 make_number (FRAME_RIGHT_FRINGE_WIDTH (f)));
3078 store_in_alist (alistptr, Qscroll_bar_width,
3079 (! FRAME_HAS_VERTICAL_SCROLL_BARS (f)
3080 ? make_number (0)
3081 : FRAME_CONFIG_SCROLL_BAR_WIDTH (f) > 0
3082 ? make_number (FRAME_CONFIG_SCROLL_BAR_WIDTH (f))
3083 /* nil means "use default width"
3084 for non-toolkit scroll bar.
3085 ruler-mode.el depends on this. */
3086 : Qnil));
3087 /* FRAME_X_WINDOW is not guaranteed to return an integer. E.g., on
3088 MS-Windows it returns a value whose type is HANDLE, which is
3089 actually a pointer. Explicit casting avoids compiler
3090 warnings. */
3091 w = (unsigned long) FRAME_X_WINDOW (f);
3092 sprintf (buf, "%lu", w);
3093 store_in_alist (alistptr, Qwindow_id,
3094 build_string (buf));
3095 #ifdef HAVE_X_WINDOWS
3096 #ifdef USE_X_TOOLKIT
3097 /* Tooltip frame may not have this widget. */
3098 if (FRAME_X_OUTPUT (f)->widget)
3099 #endif
3101 w = (unsigned long) FRAME_OUTER_WINDOW (f);
3102 sprintf (buf, "%lu", w);
3104 store_in_alist (alistptr, Qouter_window_id,
3105 build_string (buf));
3106 #endif
3107 store_in_alist (alistptr, Qicon_name, f->icon_name);
3108 FRAME_SAMPLE_VISIBILITY (f);
3109 store_in_alist (alistptr, Qvisibility,
3110 (FRAME_VISIBLE_P (f) ? Qt
3111 : FRAME_ICONIFIED_P (f) ? Qicon : Qnil));
3112 store_in_alist (alistptr, Qdisplay,
3113 XCAR (FRAME_X_DISPLAY_INFO (f)->name_list_element));
3115 if (FRAME_X_OUTPUT (f)->parent_desc == FRAME_X_DISPLAY_INFO (f)->root_window)
3116 tem = Qnil;
3117 else
3118 XSETFASTINT (tem, FRAME_X_OUTPUT (f)->parent_desc);
3119 store_in_alist (alistptr, Qexplicit_name, (f->explicit_name ? Qt : Qnil));
3120 store_in_alist (alistptr, Qparent_id, tem);
3121 store_in_alist (alistptr, Qtool_bar_position, f->tool_bar_position);
3125 /* Change the `fullscreen' frame parameter of frame F. OLD_VALUE is
3126 the previous value of that parameter, NEW_VALUE is the new value. */
3128 void
3129 x_set_fullscreen (struct frame *f, Lisp_Object new_value, Lisp_Object old_value)
3131 if (NILP (new_value))
3132 f->want_fullscreen = FULLSCREEN_NONE;
3133 else if (EQ (new_value, Qfullboth) || EQ (new_value, Qfullscreen))
3134 f->want_fullscreen = FULLSCREEN_BOTH;
3135 else if (EQ (new_value, Qfullwidth))
3136 f->want_fullscreen = FULLSCREEN_WIDTH;
3137 else if (EQ (new_value, Qfullheight))
3138 f->want_fullscreen = FULLSCREEN_HEIGHT;
3139 else if (EQ (new_value, Qmaximized))
3140 f->want_fullscreen = FULLSCREEN_MAXIMIZED;
3142 if (FRAME_TERMINAL (f)->fullscreen_hook != NULL)
3143 FRAME_TERMINAL (f)->fullscreen_hook (f);
3147 /* Change the `line-spacing' frame parameter of frame F. OLD_VALUE is
3148 the previous value of that parameter, NEW_VALUE is the new value. */
3150 void
3151 x_set_line_spacing (struct frame *f, Lisp_Object new_value, Lisp_Object old_value)
3153 if (NILP (new_value))
3154 f->extra_line_spacing = 0;
3155 else if (RANGED_INTEGERP (0, new_value, INT_MAX))
3156 f->extra_line_spacing = XFASTINT (new_value);
3157 else
3158 signal_error ("Invalid line-spacing", new_value);
3159 if (FRAME_VISIBLE_P (f))
3160 redraw_frame (f);
3164 /* Change the `screen-gamma' frame parameter of frame F. OLD_VALUE is
3165 the previous value of that parameter, NEW_VALUE is the new value. */
3167 void
3168 x_set_screen_gamma (struct frame *f, Lisp_Object new_value, Lisp_Object old_value)
3170 Lisp_Object bgcolor;
3172 if (NILP (new_value))
3173 f->gamma = 0;
3174 else if (NUMBERP (new_value) && XFLOATINT (new_value) > 0)
3175 /* The value 0.4545 is the normal viewing gamma. */
3176 f->gamma = 1.0 / (0.4545 * XFLOATINT (new_value));
3177 else
3178 signal_error ("Invalid screen-gamma", new_value);
3180 /* Apply the new gamma value to the frame background. */
3181 bgcolor = Fassq (Qbackground_color, f->param_alist);
3182 if (CONSP (bgcolor) && (bgcolor = XCDR (bgcolor), STRINGP (bgcolor)))
3184 Lisp_Object parm_index = Fget (Qbackground_color, Qx_frame_parameter);
3185 if (NATNUMP (parm_index)
3186 && (XFASTINT (parm_index)
3187 < sizeof (frame_parms)/sizeof (frame_parms[0]))
3188 && FRAME_RIF (f)->frame_parm_handlers[XFASTINT (parm_index)])
3189 (*FRAME_RIF (f)->frame_parm_handlers[XFASTINT (parm_index)])
3190 (f, bgcolor, Qnil);
3193 Fclear_face_cache (Qnil);
3197 void
3198 x_set_font (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
3200 Lisp_Object font_object, font_param = Qnil;
3201 int fontset = -1;
3203 /* Set the frame parameter back to the old value because we may
3204 fail to use ARG as the new parameter value. */
3205 store_frame_param (f, Qfont, oldval);
3207 /* ARG is a fontset name, a font name, a cons of fontset name and a
3208 font object, or a font object. In the last case, this function
3209 never fail. */
3210 if (STRINGP (arg))
3212 font_param = arg;
3213 fontset = fs_query_fontset (arg, 0);
3214 if (fontset < 0)
3216 font_object = font_open_by_name (f, SSDATA (arg));
3217 if (NILP (font_object))
3218 error ("Font `%s' is not defined", SSDATA (arg));
3219 arg = AREF (font_object, FONT_NAME_INDEX);
3221 else if (fontset > 0)
3223 Lisp_Object ascii_font = fontset_ascii (fontset);
3225 font_object = font_open_by_name (f, SSDATA (ascii_font));
3226 if (NILP (font_object))
3227 error ("Font `%s' is not defined", SDATA (arg));
3228 arg = AREF (font_object, FONT_NAME_INDEX);
3230 else
3231 error ("The default fontset can't be used for a frame font");
3233 else if (CONSP (arg) && STRINGP (XCAR (arg)) && FONT_OBJECT_P (XCDR (arg)))
3235 /* This is the case that the ASCII font of F's fontset XCAR
3236 (arg) is changed to the font XCDR (arg) by
3237 `set-fontset-font'. */
3238 fontset = fs_query_fontset (XCAR (arg), 0);
3239 if (fontset < 0)
3240 error ("Unknown fontset: %s", SDATA (XCAR (arg)));
3241 font_object = XCDR (arg);
3242 arg = AREF (font_object, FONT_NAME_INDEX);
3243 font_param = Ffont_get (font_object, QCname);
3245 else if (FONT_OBJECT_P (arg))
3247 font_object = arg;
3248 font_param = Ffont_get (font_object, QCname);
3249 /* This is to store the XLFD font name in the frame parameter for
3250 backward compatibility. We should store the font-object
3251 itself in the future. */
3252 arg = AREF (font_object, FONT_NAME_INDEX);
3253 fontset = FRAME_FONTSET (f);
3254 /* Check if we can use the current fontset. If not, set FONTSET
3255 to -1 to generate a new fontset from FONT-OBJECT. */
3256 if (fontset >= 0)
3258 Lisp_Object ascii_font = fontset_ascii (fontset);
3259 Lisp_Object spec = font_spec_from_name (ascii_font);
3261 if (! font_match_p (spec, font_object))
3262 fontset = -1;
3265 else
3266 signal_error ("Invalid font", arg);
3268 if (! NILP (Fequal (font_object, oldval)))
3269 return;
3271 x_new_font (f, font_object, fontset);
3272 store_frame_param (f, Qfont, arg);
3273 #ifdef HAVE_X_WINDOWS
3274 store_frame_param (f, Qfont_param, font_param);
3275 #endif
3276 /* Recalculate toolbar height. */
3277 f->n_tool_bar_rows = 0;
3278 /* Ensure we redraw it. */
3279 clear_current_matrices (f);
3281 recompute_basic_faces (f);
3283 do_pending_window_change (0);
3285 /* We used to call face-set-after-frame-default here, but it leads to
3286 recursive calls (since that function can set the `default' face's
3287 font which in turns changes the frame's `font' parameter).
3288 Also I don't know what this call is meant to do, but it seems the
3289 wrong way to do it anyway (it does a lot more work than what seems
3290 reasonable in response to a change to `font'). */
3294 void
3295 x_set_font_backend (struct frame *f, Lisp_Object new_value, Lisp_Object old_value)
3297 if (! NILP (new_value)
3298 && !CONSP (new_value))
3300 char *p0, *p1;
3302 CHECK_STRING (new_value);
3303 p0 = p1 = SSDATA (new_value);
3304 new_value = Qnil;
3305 while (*p0)
3307 while (*p1 && ! isspace (*p1) && *p1 != ',') p1++;
3308 if (p0 < p1)
3309 new_value = Fcons (Fintern (make_string (p0, p1 - p0), Qnil),
3310 new_value);
3311 if (*p1)
3313 int c;
3315 while ((c = *++p1) && isspace (c));
3317 p0 = p1;
3319 new_value = Fnreverse (new_value);
3322 if (! NILP (old_value) && ! NILP (Fequal (old_value, new_value)))
3323 return;
3325 if (FRAME_FONT (f))
3326 free_all_realized_faces (Qnil);
3328 new_value = font_update_drivers (f, NILP (new_value) ? Qt : new_value);
3329 if (NILP (new_value))
3331 if (NILP (old_value))
3332 error ("No font backend available");
3333 font_update_drivers (f, old_value);
3334 error ("None of specified font backends are available");
3336 store_frame_param (f, Qfont_backend, new_value);
3338 if (FRAME_FONT (f))
3340 Lisp_Object frame;
3342 XSETFRAME (frame, f);
3343 x_set_font (f, Fframe_parameter (frame, Qfont), Qnil);
3344 ++face_change_count;
3345 ++windows_or_buffers_changed;
3350 void
3351 x_set_fringe_width (struct frame *f, Lisp_Object new_value, Lisp_Object old_value)
3353 compute_fringe_widths (f, 1);
3354 #ifdef HAVE_X_WINDOWS
3355 /* Must adjust this so window managers report correct number of columns. */
3356 if (FRAME_X_WINDOW (f) != 0)
3357 x_wm_set_size_hint (f, 0, 0);
3358 #endif
3361 void
3362 x_set_border_width (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
3364 CHECK_TYPE_RANGED_INTEGER (int, arg);
3366 if (XINT (arg) == f->border_width)
3367 return;
3369 if (FRAME_X_WINDOW (f) != 0)
3370 error ("Cannot change the border width of a frame");
3372 f->border_width = XINT (arg);
3375 void
3376 x_set_internal_border_width (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
3378 int old = FRAME_INTERNAL_BORDER_WIDTH (f);
3380 CHECK_TYPE_RANGED_INTEGER (int, arg);
3381 FRAME_INTERNAL_BORDER_WIDTH (f) = XINT (arg);
3382 if (FRAME_INTERNAL_BORDER_WIDTH (f) < 0)
3383 FRAME_INTERNAL_BORDER_WIDTH (f) = 0;
3385 #ifdef USE_X_TOOLKIT
3386 if (FRAME_X_OUTPUT (f)->edit_widget)
3387 widget_store_internal_border (FRAME_X_OUTPUT (f)->edit_widget);
3388 #endif
3390 if (FRAME_INTERNAL_BORDER_WIDTH (f) == old)
3391 return;
3393 if (FRAME_X_WINDOW (f) != 0)
3395 x_set_window_size (f, 0, FRAME_COLS (f), FRAME_LINES (f));
3396 SET_FRAME_GARBAGED (f);
3397 do_pending_window_change (0);
3399 else
3400 SET_FRAME_GARBAGED (f);
3403 void
3404 x_set_visibility (struct frame *f, Lisp_Object value, Lisp_Object oldval)
3406 Lisp_Object frame;
3407 XSETFRAME (frame, f);
3409 if (NILP (value))
3410 Fmake_frame_invisible (frame, Qt);
3411 else if (EQ (value, Qicon))
3412 Ficonify_frame (frame);
3413 else
3414 Fmake_frame_visible (frame);
3417 void
3418 x_set_autoraise (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
3420 f->auto_raise = !EQ (Qnil, arg);
3423 void
3424 x_set_autolower (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
3426 f->auto_lower = !EQ (Qnil, arg);
3429 void
3430 x_set_unsplittable (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
3432 f->no_split = !NILP (arg);
3435 void
3436 x_set_vertical_scroll_bars (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
3438 if ((EQ (arg, Qleft) && FRAME_HAS_VERTICAL_SCROLL_BARS_ON_RIGHT (f))
3439 || (EQ (arg, Qright) && FRAME_HAS_VERTICAL_SCROLL_BARS_ON_LEFT (f))
3440 || (NILP (arg) && FRAME_HAS_VERTICAL_SCROLL_BARS (f))
3441 || (!NILP (arg) && ! FRAME_HAS_VERTICAL_SCROLL_BARS (f)))
3443 FRAME_VERTICAL_SCROLL_BAR_TYPE (f)
3444 = (NILP (arg)
3445 ? vertical_scroll_bar_none
3446 : EQ (Qleft, arg)
3447 ? vertical_scroll_bar_left
3448 : EQ (Qright, arg)
3449 ? vertical_scroll_bar_right
3450 : EQ (Qleft, Vdefault_frame_scroll_bars)
3451 ? vertical_scroll_bar_left
3452 : EQ (Qright, Vdefault_frame_scroll_bars)
3453 ? vertical_scroll_bar_right
3454 : vertical_scroll_bar_none);
3456 /* We set this parameter before creating the X window for the
3457 frame, so we can get the geometry right from the start.
3458 However, if the window hasn't been created yet, we shouldn't
3459 call x_set_window_size. */
3460 if (FRAME_X_WINDOW (f))
3461 x_set_window_size (f, 0, FRAME_COLS (f), FRAME_LINES (f));
3462 do_pending_window_change (0);
3466 void
3467 x_set_scroll_bar_width (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
3469 int wid = FRAME_COLUMN_WIDTH (f);
3471 if (NILP (arg))
3473 x_set_scroll_bar_default_width (f);
3475 if (FRAME_X_WINDOW (f))
3476 x_set_window_size (f, 0, FRAME_COLS (f), FRAME_LINES (f));
3477 do_pending_window_change (0);
3479 else if (RANGED_INTEGERP (1, arg, INT_MAX)
3480 && XFASTINT (arg) != FRAME_CONFIG_SCROLL_BAR_WIDTH (f))
3482 if (XFASTINT (arg) <= 2 * VERTICAL_SCROLL_BAR_WIDTH_TRIM)
3483 XSETINT (arg, 2 * VERTICAL_SCROLL_BAR_WIDTH_TRIM + 1);
3485 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = XFASTINT (arg);
3486 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (XFASTINT (arg) + wid-1) / wid;
3487 if (FRAME_X_WINDOW (f))
3488 x_set_window_size (f, 0, FRAME_COLS (f), FRAME_LINES (f));
3489 do_pending_window_change (0);
3492 change_frame_size (f, 0, FRAME_COLS (f), 0, 0, 0);
3493 XWINDOW (FRAME_SELECTED_WINDOW (f))->cursor.hpos = 0;
3494 XWINDOW (FRAME_SELECTED_WINDOW (f))->cursor.x = 0;
3499 /* Return non-nil if frame F wants a bitmap icon. */
3501 Lisp_Object
3502 x_icon_type (FRAME_PTR f)
3504 Lisp_Object tem;
3506 tem = assq_no_quit (Qicon_type, f->param_alist);
3507 if (CONSP (tem))
3508 return XCDR (tem);
3509 else
3510 return Qnil;
3513 void
3514 x_set_alpha (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
3516 double alpha = 1.0;
3517 double newval[2];
3518 int i;
3519 Lisp_Object item;
3521 for (i = 0; i < 2; i++)
3523 newval[i] = 1.0;
3524 if (CONSP (arg))
3526 item = CAR (arg);
3527 arg = CDR (arg);
3529 else
3530 item = arg;
3532 if (NILP (item))
3533 alpha = - 1.0;
3534 else if (FLOATP (item))
3536 alpha = XFLOAT_DATA (item);
3537 if (alpha < 0.0 || 1.0 < alpha)
3538 args_out_of_range (make_float (0.0), make_float (1.0));
3540 else if (INTEGERP (item))
3542 EMACS_INT ialpha = XINT (item);
3543 if (ialpha < 0 || 100 < ialpha)
3544 args_out_of_range (make_number (0), make_number (100));
3545 else
3546 alpha = ialpha / 100.0;
3548 else
3549 wrong_type_argument (Qnumberp, item);
3550 newval[i] = alpha;
3553 for (i = 0; i < 2; i++)
3554 f->alpha[i] = newval[i];
3556 #if defined (HAVE_X_WINDOWS) || defined (HAVE_NTGUI) || defined (NS_IMPL_COCOA)
3557 BLOCK_INPUT;
3558 x_set_frame_alpha (f);
3559 UNBLOCK_INPUT;
3560 #endif
3562 return;
3566 /* Subroutines of creating an X frame. */
3568 /* Make sure that Vx_resource_name is set to a reasonable value.
3569 Fix it up, or set it to `emacs' if it is too hopeless. */
3571 void
3572 validate_x_resource_name (void)
3574 ptrdiff_t len = 0;
3575 /* Number of valid characters in the resource name. */
3576 ptrdiff_t good_count = 0;
3577 /* Number of invalid characters in the resource name. */
3578 ptrdiff_t bad_count = 0;
3579 Lisp_Object new;
3580 ptrdiff_t i;
3582 if (!STRINGP (Vx_resource_class))
3583 Vx_resource_class = build_string (EMACS_CLASS);
3585 if (STRINGP (Vx_resource_name))
3587 unsigned char *p = SDATA (Vx_resource_name);
3589 len = SBYTES (Vx_resource_name);
3591 /* Only letters, digits, - and _ are valid in resource names.
3592 Count the valid characters and count the invalid ones. */
3593 for (i = 0; i < len; i++)
3595 int c = p[i];
3596 if (! ((c >= 'a' && c <= 'z')
3597 || (c >= 'A' && c <= 'Z')
3598 || (c >= '0' && c <= '9')
3599 || c == '-' || c == '_'))
3600 bad_count++;
3601 else
3602 good_count++;
3605 else
3606 /* Not a string => completely invalid. */
3607 bad_count = 5, good_count = 0;
3609 /* If name is valid already, return. */
3610 if (bad_count == 0)
3611 return;
3613 /* If name is entirely invalid, or nearly so, or is so implausibly
3614 large that alloca might not work, use `emacs'. */
3615 if (good_count < 2 || MAX_ALLOCA - sizeof ".customization" < len)
3617 Vx_resource_name = build_string ("emacs");
3618 return;
3621 /* Name is partly valid. Copy it and replace the invalid characters
3622 with underscores. */
3624 Vx_resource_name = new = Fcopy_sequence (Vx_resource_name);
3626 for (i = 0; i < len; i++)
3628 int c = SREF (new, i);
3629 if (! ((c >= 'a' && c <= 'z')
3630 || (c >= 'A' && c <= 'Z')
3631 || (c >= '0' && c <= '9')
3632 || c == '-' || c == '_'))
3633 SSET (new, i, '_');
3638 extern char *x_get_string_resource (XrmDatabase, const char *, const char *);
3639 extern Display_Info *check_x_display_info (Lisp_Object);
3642 /* Get specified attribute from resource database RDB.
3643 See Fx_get_resource below for other parameters. */
3645 static Lisp_Object
3646 xrdb_get_resource (XrmDatabase rdb, Lisp_Object attribute, Lisp_Object class, Lisp_Object component, Lisp_Object subclass)
3648 register char *value;
3649 char *name_key;
3650 char *class_key;
3652 CHECK_STRING (attribute);
3653 CHECK_STRING (class);
3655 if (!NILP (component))
3656 CHECK_STRING (component);
3657 if (!NILP (subclass))
3658 CHECK_STRING (subclass);
3659 if (NILP (component) != NILP (subclass))
3660 error ("x-get-resource: must specify both COMPONENT and SUBCLASS or neither");
3662 validate_x_resource_name ();
3664 /* Allocate space for the components, the dots which separate them,
3665 and the final '\0'. Make them big enough for the worst case. */
3666 name_key = (char *) alloca (SBYTES (Vx_resource_name)
3667 + (STRINGP (component)
3668 ? SBYTES (component) : 0)
3669 + SBYTES (attribute)
3670 + 3);
3672 class_key = (char *) alloca (SBYTES (Vx_resource_class)
3673 + SBYTES (class)
3674 + (STRINGP (subclass)
3675 ? SBYTES (subclass) : 0)
3676 + 3);
3678 /* Start with emacs.FRAMENAME for the name (the specific one)
3679 and with `Emacs' for the class key (the general one). */
3680 strcpy (name_key, SSDATA (Vx_resource_name));
3681 strcpy (class_key, SSDATA (Vx_resource_class));
3683 strcat (class_key, ".");
3684 strcat (class_key, SSDATA (class));
3686 if (!NILP (component))
3688 strcat (class_key, ".");
3689 strcat (class_key, SSDATA (subclass));
3691 strcat (name_key, ".");
3692 strcat (name_key, SSDATA (component));
3695 strcat (name_key, ".");
3696 strcat (name_key, SSDATA (attribute));
3698 value = x_get_string_resource (rdb, name_key, class_key);
3700 if (value != (char *) 0 && *value)
3701 return build_string (value);
3702 else
3703 return Qnil;
3707 DEFUN ("x-get-resource", Fx_get_resource, Sx_get_resource, 2, 4, 0,
3708 doc: /* Return the value of ATTRIBUTE, of class CLASS, from the X defaults database.
3709 This uses `INSTANCE.ATTRIBUTE' as the key and `Emacs.CLASS' as the
3710 class, where INSTANCE is the name under which Emacs was invoked, or
3711 the name specified by the `-name' or `-rn' command-line arguments.
3713 The optional arguments COMPONENT and SUBCLASS add to the key and the
3714 class, respectively. You must specify both of them or neither.
3715 If you specify them, the key is `INSTANCE.COMPONENT.ATTRIBUTE'
3716 and the class is `Emacs.CLASS.SUBCLASS'. */)
3717 (Lisp_Object attribute, Lisp_Object class, Lisp_Object component, Lisp_Object subclass)
3719 #ifdef HAVE_X_WINDOWS
3720 check_x ();
3721 #endif
3723 return xrdb_get_resource (check_x_display_info (Qnil)->xrdb,
3724 attribute, class, component, subclass);
3727 /* Get an X resource, like Fx_get_resource, but for display DPYINFO. */
3729 Lisp_Object
3730 display_x_get_resource (Display_Info *dpyinfo, Lisp_Object attribute, Lisp_Object class, Lisp_Object component, Lisp_Object subclass)
3732 return xrdb_get_resource (dpyinfo->xrdb,
3733 attribute, class, component, subclass);
3736 #if defined HAVE_X_WINDOWS && !defined USE_X_TOOLKIT
3737 /* Used when C code wants a resource value. */
3738 /* Called from oldXMenu/Create.c. */
3739 char *
3740 x_get_resource_string (const char *attribute, const char *class)
3742 char *name_key;
3743 char *class_key;
3744 char *result;
3745 struct frame *sf = SELECTED_FRAME ();
3746 ptrdiff_t invocation_namelen = SBYTES (Vinvocation_name);
3747 USE_SAFE_ALLOCA;
3749 /* Allocate space for the components, the dots which separate them,
3750 and the final '\0'. */
3751 SAFE_ALLOCA (name_key, char *, invocation_namelen + strlen (attribute) + 2);
3752 class_key = (char *) alloca ((sizeof (EMACS_CLASS) - 1)
3753 + strlen (class) + 2);
3755 esprintf (name_key, "%s.%s", SSDATA (Vinvocation_name), attribute);
3756 sprintf (class_key, "%s.%s", EMACS_CLASS, class);
3758 result = x_get_string_resource (FRAME_X_DISPLAY_INFO (sf)->xrdb,
3759 name_key, class_key);
3760 SAFE_FREE ();
3761 return result;
3763 #endif
3765 /* Return the value of parameter PARAM.
3767 First search ALIST, then Vdefault_frame_alist, then the X defaults
3768 database, using ATTRIBUTE as the attribute name and CLASS as its class.
3770 Convert the resource to the type specified by desired_type.
3772 If no default is specified, return Qunbound. If you call
3773 x_get_arg, make sure you deal with Qunbound in a reasonable way,
3774 and don't let it get stored in any Lisp-visible variables! */
3776 Lisp_Object
3777 x_get_arg (Display_Info *dpyinfo, Lisp_Object alist, Lisp_Object param,
3778 const char *attribute, const char *class, enum resource_types type)
3780 register Lisp_Object tem;
3782 tem = Fassq (param, alist);
3784 if (!NILP (tem))
3786 /* If we find this parm in ALIST, clear it out
3787 so that it won't be "left over" at the end. */
3788 Lisp_Object tail;
3789 XSETCAR (tem, Qnil);
3790 /* In case the parameter appears more than once in the alist,
3791 clear it out. */
3792 for (tail = alist; CONSP (tail); tail = XCDR (tail))
3793 if (CONSP (XCAR (tail))
3794 && EQ (XCAR (XCAR (tail)), param))
3795 XSETCAR (XCAR (tail), Qnil);
3797 else
3798 tem = Fassq (param, Vdefault_frame_alist);
3800 /* If it wasn't specified in ALIST or the Lisp-level defaults,
3801 look in the X resources. */
3802 if (EQ (tem, Qnil))
3804 if (attribute && dpyinfo)
3806 tem = display_x_get_resource (dpyinfo,
3807 build_string (attribute),
3808 build_string (class),
3809 Qnil, Qnil);
3811 if (NILP (tem))
3812 return Qunbound;
3814 switch (type)
3816 case RES_TYPE_NUMBER:
3817 return make_number (atoi (SSDATA (tem)));
3819 case RES_TYPE_BOOLEAN_NUMBER:
3820 if (!strcmp (SSDATA (tem), "on")
3821 || !strcmp (SSDATA (tem), "true"))
3822 return make_number (1);
3823 return make_number (atoi (SSDATA (tem)));
3824 break;
3826 case RES_TYPE_FLOAT:
3827 return make_float (atof (SSDATA (tem)));
3829 case RES_TYPE_BOOLEAN:
3830 tem = Fdowncase (tem);
3831 if (!strcmp (SSDATA (tem), "on")
3832 #ifdef HAVE_NS
3833 || !strcmp (SSDATA (tem), "yes")
3834 #endif
3835 || !strcmp (SSDATA (tem), "true"))
3836 return Qt;
3837 else
3838 return Qnil;
3840 case RES_TYPE_STRING:
3841 return tem;
3843 case RES_TYPE_SYMBOL:
3844 /* As a special case, we map the values `true' and `on'
3845 to Qt, and `false' and `off' to Qnil. */
3847 Lisp_Object lower;
3848 lower = Fdowncase (tem);
3849 if (!strcmp (SSDATA (lower), "on")
3850 #ifdef HAVE_NS
3851 || !strcmp (SSDATA (lower), "yes")
3852 #endif
3853 || !strcmp (SSDATA (lower), "true"))
3854 return Qt;
3855 else if (!strcmp (SSDATA (lower), "off")
3856 #ifdef HAVE_NS
3857 || !strcmp (SSDATA (lower), "no")
3858 #endif
3859 || !strcmp (SSDATA (lower), "false"))
3860 return Qnil;
3861 else
3862 return Fintern (tem, Qnil);
3865 default:
3866 abort ();
3869 else
3870 return Qunbound;
3872 return Fcdr (tem);
3875 static Lisp_Object
3876 x_frame_get_arg (struct frame *f, Lisp_Object alist, Lisp_Object param,
3877 const char *attribute, const char *class,
3878 enum resource_types type)
3880 return x_get_arg (FRAME_X_DISPLAY_INFO (f),
3881 alist, param, attribute, class, type);
3884 /* Like x_frame_get_arg, but also record the value in f->param_alist. */
3886 Lisp_Object
3887 x_frame_get_and_record_arg (struct frame *f, Lisp_Object alist,
3888 Lisp_Object param,
3889 const char *attribute, const char *class,
3890 enum resource_types type)
3892 Lisp_Object value;
3894 value = x_get_arg (FRAME_X_DISPLAY_INFO (f), alist, param,
3895 attribute, class, type);
3896 if (! NILP (value) && ! EQ (value, Qunbound))
3897 store_frame_param (f, param, value);
3899 return value;
3903 /* Record in frame F the specified or default value according to ALIST
3904 of the parameter named PROP (a Lisp symbol).
3905 If no value is specified for PROP, look for an X default for XPROP
3906 on the frame named NAME.
3907 If that is not found either, use the value DEFLT. */
3909 Lisp_Object
3910 x_default_parameter (struct frame *f, Lisp_Object alist, Lisp_Object prop,
3911 Lisp_Object deflt, const char *xprop, const char *xclass,
3912 enum resource_types type)
3914 Lisp_Object tem;
3916 tem = x_frame_get_arg (f, alist, prop, xprop, xclass, type);
3917 if (EQ (tem, Qunbound))
3918 tem = deflt;
3919 x_set_frame_parameters (f, Fcons (Fcons (prop, tem), Qnil));
3920 return tem;
3926 /* NS used to define x-parse-geometry in ns-win.el, but that confused
3927 make-docfile: the documentation string in ns-win.el was used for
3928 x-parse-geometry even in non-NS builds.
3930 With two definitions of x-parse-geometry in this file, various
3931 things still get confused (eg M-x apropos documentation), so that
3932 it is best if the two definitions just share the same doc-string.
3934 DEFUN ("x-parse-geometry", Fx_parse_geometry, Sx_parse_geometry, 1, 1, 0,
3935 doc: /* Parse a display geometry string STRING.
3936 Returns an alist of the form ((top . TOP), (left . LEFT) ... ).
3937 The properties returned may include `top', `left', `height', and `width'.
3938 For X, the value of `left' or `top' may be an integer,
3939 or a list (+ N) meaning N pixels relative to top/left corner,
3940 or a list (- N) meaning -N pixels relative to bottom/right corner.
3941 On Nextstep, this just calls `ns-parse-geometry'. */)
3942 (Lisp_Object string)
3944 #ifdef HAVE_NS
3945 call1 (Qns_parse_geometry, string);
3946 #else
3947 int geometry, x, y;
3948 unsigned int width, height;
3949 Lisp_Object result;
3951 CHECK_STRING (string);
3953 geometry = XParseGeometry (SSDATA (string),
3954 &x, &y, &width, &height);
3955 result = Qnil;
3956 if (geometry & XValue)
3958 Lisp_Object element;
3960 if (x >= 0 && (geometry & XNegative))
3961 element = Fcons (Qleft, Fcons (Qminus, Fcons (make_number (-x), Qnil)));
3962 else if (x < 0 && ! (geometry & XNegative))
3963 element = Fcons (Qleft, Fcons (Qplus, Fcons (make_number (x), Qnil)));
3964 else
3965 element = Fcons (Qleft, make_number (x));
3966 result = Fcons (element, result);
3969 if (geometry & YValue)
3971 Lisp_Object element;
3973 if (y >= 0 && (geometry & YNegative))
3974 element = Fcons (Qtop, Fcons (Qminus, Fcons (make_number (-y), Qnil)));
3975 else if (y < 0 && ! (geometry & YNegative))
3976 element = Fcons (Qtop, Fcons (Qplus, Fcons (make_number (y), Qnil)));
3977 else
3978 element = Fcons (Qtop, make_number (y));
3979 result = Fcons (element, result);
3982 if (geometry & WidthValue)
3983 result = Fcons (Fcons (Qwidth, make_number (width)), result);
3984 if (geometry & HeightValue)
3985 result = Fcons (Fcons (Qheight, make_number (height)), result);
3987 return result;
3988 #endif /* HAVE_NS */
3992 /* Calculate the desired size and position of frame F.
3993 Return the flags saying which aspects were specified.
3995 Also set the win_gravity and size_hint_flags of F.
3997 Adjust height for toolbar if TOOLBAR_P is 1.
3999 This function does not make the coordinates positive. */
4001 #define DEFAULT_ROWS 35
4002 #define DEFAULT_COLS 80
4005 x_figure_window_size (struct frame *f, Lisp_Object parms, int toolbar_p)
4007 register Lisp_Object tem0, tem1, tem2;
4008 long window_prompting = 0;
4009 Display_Info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
4011 /* Default values if we fall through.
4012 Actually, if that happens we should get
4013 window manager prompting. */
4014 SET_FRAME_COLS (f, DEFAULT_COLS);
4015 FRAME_LINES (f) = DEFAULT_ROWS;
4016 /* Window managers expect that if program-specified
4017 positions are not (0,0), they're intentional, not defaults. */
4018 f->top_pos = 0;
4019 f->left_pos = 0;
4021 /* Ensure that old new_text_cols and new_text_lines will not override the
4022 values set here. */
4023 /* ++KFS: This was specific to W32, but seems ok for all platforms */
4024 f->new_text_cols = f->new_text_lines = 0;
4026 tem0 = x_get_arg (dpyinfo, parms, Qheight, 0, 0, RES_TYPE_NUMBER);
4027 tem1 = x_get_arg (dpyinfo, parms, Qwidth, 0, 0, RES_TYPE_NUMBER);
4028 tem2 = x_get_arg (dpyinfo, parms, Quser_size, 0, 0, RES_TYPE_NUMBER);
4029 if (! EQ (tem0, Qunbound) || ! EQ (tem1, Qunbound))
4031 if (!EQ (tem0, Qunbound))
4033 CHECK_NUMBER (tem0);
4034 if (! (0 <= XINT (tem0) && XINT (tem0) <= INT_MAX))
4035 xsignal1 (Qargs_out_of_range, tem0);
4036 FRAME_LINES (f) = XINT (tem0);
4038 if (!EQ (tem1, Qunbound))
4040 CHECK_NUMBER (tem1);
4041 if (! (0 <= XINT (tem1) && XINT (tem1) <= INT_MAX))
4042 xsignal1 (Qargs_out_of_range, tem1);
4043 SET_FRAME_COLS (f, XINT (tem1));
4045 if (!NILP (tem2) && !EQ (tem2, Qunbound))
4046 window_prompting |= USSize;
4047 else
4048 window_prompting |= PSize;
4051 f->scroll_bar_actual_width
4052 = FRAME_SCROLL_BAR_COLS (f) * FRAME_COLUMN_WIDTH (f);
4054 /* This used to be done _before_ calling x_figure_window_size, but
4055 since the height is reset here, this was really a no-op. I
4056 assume that moving it here does what Gerd intended (although he
4057 no longer can remember what that was... ++KFS, 2003-03-25. */
4059 /* Add the tool-bar height to the initial frame height so that the
4060 user gets a text display area of the size he specified with -g or
4061 via .Xdefaults. Later changes of the tool-bar height don't
4062 change the frame size. This is done so that users can create
4063 tall Emacs frames without having to guess how tall the tool-bar
4064 will get. */
4065 if (toolbar_p && FRAME_TOOL_BAR_LINES (f))
4067 int margin, relief, bar_height;
4069 relief = (tool_bar_button_relief >= 0
4070 ? tool_bar_button_relief
4071 : DEFAULT_TOOL_BAR_BUTTON_RELIEF);
4073 if (RANGED_INTEGERP (1, Vtool_bar_button_margin, INT_MAX))
4074 margin = XFASTINT (Vtool_bar_button_margin);
4075 else if (CONSP (Vtool_bar_button_margin)
4076 && RANGED_INTEGERP (1, XCDR (Vtool_bar_button_margin), INT_MAX))
4077 margin = XFASTINT (XCDR (Vtool_bar_button_margin));
4078 else
4079 margin = 0;
4081 bar_height = DEFAULT_TOOL_BAR_IMAGE_HEIGHT + 2 * margin + 2 * relief;
4082 FRAME_LINES (f) += (bar_height + FRAME_LINE_HEIGHT (f) - 1) / FRAME_LINE_HEIGHT (f);
4085 compute_fringe_widths (f, 0);
4087 FRAME_PIXEL_WIDTH (f) = FRAME_TEXT_COLS_TO_PIXEL_WIDTH (f, FRAME_COLS (f));
4088 FRAME_PIXEL_HEIGHT (f) = FRAME_TEXT_LINES_TO_PIXEL_HEIGHT (f, FRAME_LINES (f));
4090 tem0 = x_get_arg (dpyinfo, parms, Qtop, 0, 0, RES_TYPE_NUMBER);
4091 tem1 = x_get_arg (dpyinfo, parms, Qleft, 0, 0, RES_TYPE_NUMBER);
4092 tem2 = x_get_arg (dpyinfo, parms, Quser_position, 0, 0, RES_TYPE_NUMBER);
4093 if (! EQ (tem0, Qunbound) || ! EQ (tem1, Qunbound))
4095 if (EQ (tem0, Qminus))
4097 f->top_pos = 0;
4098 window_prompting |= YNegative;
4100 else if (CONSP (tem0) && EQ (XCAR (tem0), Qminus)
4101 && CONSP (XCDR (tem0))
4102 && RANGED_INTEGERP (-INT_MAX, XCAR (XCDR (tem0)), INT_MAX))
4104 f->top_pos = - XINT (XCAR (XCDR (tem0)));
4105 window_prompting |= YNegative;
4107 else if (CONSP (tem0) && EQ (XCAR (tem0), Qplus)
4108 && CONSP (XCDR (tem0))
4109 && TYPE_RANGED_INTEGERP (int, XCAR (XCDR (tem0))))
4111 f->top_pos = XINT (XCAR (XCDR (tem0)));
4113 else if (EQ (tem0, Qunbound))
4114 f->top_pos = 0;
4115 else
4117 CHECK_TYPE_RANGED_INTEGER (int, tem0);
4118 f->top_pos = XINT (tem0);
4119 if (f->top_pos < 0)
4120 window_prompting |= YNegative;
4123 if (EQ (tem1, Qminus))
4125 f->left_pos = 0;
4126 window_prompting |= XNegative;
4128 else if (CONSP (tem1) && EQ (XCAR (tem1), Qminus)
4129 && CONSP (XCDR (tem1))
4130 && RANGED_INTEGERP (-INT_MAX, XCAR (XCDR (tem1)), INT_MAX))
4132 f->left_pos = - XINT (XCAR (XCDR (tem1)));
4133 window_prompting |= XNegative;
4135 else if (CONSP (tem1) && EQ (XCAR (tem1), Qplus)
4136 && CONSP (XCDR (tem1))
4137 && TYPE_RANGED_INTEGERP (int, XCAR (XCDR (tem1))))
4139 f->left_pos = XINT (XCAR (XCDR (tem1)));
4141 else if (EQ (tem1, Qunbound))
4142 f->left_pos = 0;
4143 else
4145 CHECK_TYPE_RANGED_INTEGER (int, tem1);
4146 f->left_pos = XINT (tem1);
4147 if (f->left_pos < 0)
4148 window_prompting |= XNegative;
4151 if (!NILP (tem2) && ! EQ (tem2, Qunbound))
4152 window_prompting |= USPosition;
4153 else
4154 window_prompting |= PPosition;
4157 if (window_prompting & XNegative)
4159 if (window_prompting & YNegative)
4160 f->win_gravity = SouthEastGravity;
4161 else
4162 f->win_gravity = NorthEastGravity;
4164 else
4166 if (window_prompting & YNegative)
4167 f->win_gravity = SouthWestGravity;
4168 else
4169 f->win_gravity = NorthWestGravity;
4172 f->size_hint_flags = window_prompting;
4174 return window_prompting;
4179 #endif /* HAVE_WINDOW_SYSTEM */
4181 void
4182 frame_make_pointer_invisible (void)
4184 if (! NILP (Vmake_pointer_invisible))
4186 struct frame *f;
4187 if (!FRAMEP (selected_frame) || !FRAME_LIVE_P (XFRAME (selected_frame)))
4188 return;
4190 f = SELECTED_FRAME ();
4191 if (f && !f->pointer_invisible
4192 && FRAME_TERMINAL (f)->toggle_invisible_pointer_hook)
4194 f->mouse_moved = 0;
4195 FRAME_TERMINAL (f)->toggle_invisible_pointer_hook (f, 1);
4196 f->pointer_invisible = 1;
4201 void
4202 frame_make_pointer_visible (void)
4204 /* We don't check Vmake_pointer_invisible here in case the
4205 pointer was invisible when Vmake_pointer_invisible was set to nil. */
4206 struct frame *f;
4208 if (!FRAMEP (selected_frame) || !FRAME_LIVE_P (XFRAME (selected_frame)))
4209 return;
4211 f = SELECTED_FRAME ();
4212 if (f && f->pointer_invisible && f->mouse_moved
4213 && FRAME_TERMINAL (f)->toggle_invisible_pointer_hook)
4215 FRAME_TERMINAL (f)->toggle_invisible_pointer_hook (f, 0);
4216 f->pointer_invisible = 0;
4220 DEFUN ("frame-pointer-visible-p", Fframe_pointer_visible_p,
4221 Sframe_pointer_visible_p, 0, 1, 0,
4222 doc: /* Return t if the mouse pointer displayed on FRAME is visible.
4223 Otherwise it returns nil. FRAME omitted or nil means the
4224 selected frame. This is useful when `make-pointer-invisible' is set. */)
4225 (Lisp_Object frame)
4227 if (NILP (frame))
4228 frame = selected_frame;
4230 CHECK_FRAME (frame);
4232 return (XFRAME (frame)->pointer_invisible ? Qnil : Qt);
4236 /***********************************************************************
4237 Initialization
4238 ***********************************************************************/
4240 void
4241 syms_of_frame (void)
4243 DEFSYM (Qframep, "framep");
4244 DEFSYM (Qframe_live_p, "frame-live-p");
4245 DEFSYM (Qexplicit_name, "explicit-name");
4246 DEFSYM (Qheight, "height");
4247 DEFSYM (Qicon, "icon");
4248 DEFSYM (Qminibuffer, "minibuffer");
4249 DEFSYM (Qmodeline, "modeline");
4250 DEFSYM (Qonly, "only");
4251 DEFSYM (Qwidth, "width");
4252 DEFSYM (Qgeometry, "geometry");
4253 DEFSYM (Qicon_left, "icon-left");
4254 DEFSYM (Qicon_top, "icon-top");
4255 DEFSYM (Qtooltip, "tooltip");
4256 DEFSYM (Qleft, "left");
4257 DEFSYM (Qright, "right");
4258 DEFSYM (Quser_position, "user-position");
4259 DEFSYM (Quser_size, "user-size");
4260 DEFSYM (Qwindow_id, "window-id");
4261 #ifdef HAVE_X_WINDOWS
4262 DEFSYM (Qouter_window_id, "outer-window-id");
4263 #endif
4264 DEFSYM (Qparent_id, "parent-id");
4265 DEFSYM (Qx, "x");
4266 DEFSYM (Qw32, "w32");
4267 DEFSYM (Qpc, "pc");
4268 DEFSYM (Qmac, "mac");
4269 DEFSYM (Qns, "ns");
4270 DEFSYM (Qvisible, "visible");
4271 DEFSYM (Qbuffer_predicate, "buffer-predicate");
4272 DEFSYM (Qbuffer_list, "buffer-list");
4273 DEFSYM (Qburied_buffer_list, "buried-buffer-list");
4274 DEFSYM (Qdisplay_type, "display-type");
4275 DEFSYM (Qbackground_mode, "background-mode");
4276 DEFSYM (Qnoelisp, "noelisp");
4277 DEFSYM (Qtty_color_mode, "tty-color-mode");
4278 DEFSYM (Qtty, "tty");
4279 DEFSYM (Qtty_type, "tty-type");
4281 DEFSYM (Qface_set_after_frame_default, "face-set-after-frame-default");
4283 DEFSYM (Qfullwidth, "fullwidth");
4284 DEFSYM (Qfullheight, "fullheight");
4285 DEFSYM (Qfullboth, "fullboth");
4286 DEFSYM (Qmaximized, "maximized");
4287 DEFSYM (Qx_resource_name, "x-resource-name");
4288 DEFSYM (Qx_frame_parameter, "x-frame-parameter");
4290 DEFSYM (Qterminal, "terminal");
4291 DEFSYM (Qterminal_live_p, "terminal-live-p");
4293 #ifdef HAVE_NS
4294 DEFSYM (Qns_parse_geometry, "ns-parse-geometry");
4295 #endif
4298 int i;
4300 for (i = 0; i < sizeof (frame_parms) / sizeof (frame_parms[0]); i++)
4302 Lisp_Object v = intern_c_string (frame_parms[i].name);
4303 if (frame_parms[i].variable)
4305 *frame_parms[i].variable = v;
4306 staticpro (frame_parms[i].variable);
4308 Fput (v, Qx_frame_parameter, make_number (i));
4312 #ifdef HAVE_WINDOW_SYSTEM
4313 DEFVAR_LISP ("x-resource-name", Vx_resource_name,
4314 doc: /* The name Emacs uses to look up X resources.
4315 `x-get-resource' uses this as the first component of the instance name
4316 when requesting resource values.
4317 Emacs initially sets `x-resource-name' to the name under which Emacs
4318 was invoked, or to the value specified with the `-name' or `-rn'
4319 switches, if present.
4321 It may be useful to bind this variable locally around a call
4322 to `x-get-resource'. See also the variable `x-resource-class'. */);
4323 Vx_resource_name = Qnil;
4325 DEFVAR_LISP ("x-resource-class", Vx_resource_class,
4326 doc: /* The class Emacs uses to look up X resources.
4327 `x-get-resource' uses this as the first component of the instance class
4328 when requesting resource values.
4330 Emacs initially sets `x-resource-class' to "Emacs".
4332 Setting this variable permanently is not a reasonable thing to do,
4333 but binding this variable locally around a call to `x-get-resource'
4334 is a reasonable practice. See also the variable `x-resource-name'. */);
4335 Vx_resource_class = build_string (EMACS_CLASS);
4337 DEFVAR_LISP ("frame-alpha-lower-limit", Vframe_alpha_lower_limit,
4338 doc: /* The lower limit of the frame opacity (alpha transparency).
4339 The value should range from 0 (invisible) to 100 (completely opaque).
4340 You can also use a floating number between 0.0 and 1.0.
4341 The default is 20. */);
4342 Vframe_alpha_lower_limit = make_number (20);
4343 #endif
4345 DEFVAR_LISP ("default-frame-alist", Vdefault_frame_alist,
4346 doc: /* Alist of default values for frame creation.
4347 These may be set in your init file, like this:
4348 (setq default-frame-alist '((width . 80) (height . 55) (menu-bar-lines . 1)))
4349 These override values given in window system configuration data,
4350 including X Windows' defaults database.
4351 For values specific to the first Emacs frame, see `initial-frame-alist'.
4352 For window-system specific values, see `window-system-default-frame-alist'.
4353 For values specific to the separate minibuffer frame, see
4354 `minibuffer-frame-alist'.
4355 The `menu-bar-lines' element of the list controls whether new frames
4356 have menu bars; `menu-bar-mode' works by altering this element.
4357 Setting this variable does not affect existing frames, only new ones. */);
4358 Vdefault_frame_alist = Qnil;
4360 DEFVAR_LISP ("default-frame-scroll-bars", Vdefault_frame_scroll_bars,
4361 doc: /* Default position of scroll bars on this window-system. */);
4362 #ifdef HAVE_WINDOW_SYSTEM
4363 #if defined (HAVE_NTGUI) || defined (NS_IMPL_COCOA) || (defined (USE_GTK) && defined (USE_TOOLKIT_SCROLL_BARS))
4364 /* MS-Windows, Mac OS X, and GTK have scroll bars on the right by
4365 default. */
4366 Vdefault_frame_scroll_bars = Qright;
4367 #else
4368 Vdefault_frame_scroll_bars = Qleft;
4369 #endif
4370 #else
4371 Vdefault_frame_scroll_bars = Qnil;
4372 #endif
4374 DEFVAR_LISP ("terminal-frame", Vterminal_frame,
4375 doc: /* The initial frame-object, which represents Emacs's stdout. */);
4377 DEFVAR_LISP ("mouse-position-function", Vmouse_position_function,
4378 doc: /* If non-nil, function to transform normal value of `mouse-position'.
4379 `mouse-position' calls this function, passing its usual return value as
4380 argument, and returns whatever this function returns.
4381 This abnormal hook exists for the benefit of packages like `xt-mouse.el'
4382 which need to do mouse handling at the Lisp level. */);
4383 Vmouse_position_function = Qnil;
4385 DEFVAR_LISP ("mouse-highlight", Vmouse_highlight,
4386 doc: /* If non-nil, clickable text is highlighted when mouse is over it.
4387 If the value is an integer, highlighting is only shown after moving the
4388 mouse, while keyboard input turns off the highlight even when the mouse
4389 is over the clickable text. However, the mouse shape still indicates
4390 when the mouse is over clickable text. */);
4391 Vmouse_highlight = Qt;
4393 DEFVAR_LISP ("make-pointer-invisible", Vmake_pointer_invisible,
4394 doc: /* If non-nil, make pointer invisible while typing.
4395 The pointer becomes visible again when the mouse is moved. */);
4396 Vmake_pointer_invisible = Qt;
4398 DEFVAR_LISP ("delete-frame-functions", Vdelete_frame_functions,
4399 doc: /* Functions to be run before deleting a frame.
4400 The functions are run with one arg, the frame to be deleted.
4401 See `delete-frame'.
4403 Note that functions in this list may be called just before the frame is
4404 actually deleted, or some time later (or even both when an earlier function
4405 in `delete-frame-functions' (indirectly) calls `delete-frame'
4406 recursively). */);
4407 Vdelete_frame_functions = Qnil;
4408 DEFSYM (Qdelete_frame_functions, "delete-frame-functions");
4410 DEFVAR_LISP ("menu-bar-mode", Vmenu_bar_mode,
4411 doc: /* Non-nil if Menu-Bar mode is enabled.
4412 See the command `menu-bar-mode' for a description of this minor mode.
4413 Setting this variable directly does not take effect;
4414 either customize it (see the info node `Easy Customization')
4415 or call the function `menu-bar-mode'. */);
4416 Vmenu_bar_mode = Qt;
4418 DEFVAR_LISP ("tool-bar-mode", Vtool_bar_mode,
4419 doc: /* Non-nil if Tool-Bar mode is enabled.
4420 See the command `tool-bar-mode' for a description of this minor mode.
4421 Setting this variable directly does not take effect;
4422 either customize it (see the info node `Easy Customization')
4423 or call the function `tool-bar-mode'. */);
4424 #ifdef HAVE_WINDOW_SYSTEM
4425 Vtool_bar_mode = Qt;
4426 #else
4427 Vtool_bar_mode = Qnil;
4428 #endif
4430 DEFVAR_KBOARD ("default-minibuffer-frame", Vdefault_minibuffer_frame,
4431 doc: /* Minibufferless frames use this frame's minibuffer.
4433 Emacs cannot create minibufferless frames unless this is set to an
4434 appropriate surrogate.
4436 Emacs consults this variable only when creating minibufferless
4437 frames; once the frame is created, it sticks with its assigned
4438 minibuffer, no matter what this variable is set to. This means that
4439 this variable doesn't necessarily say anything meaningful about the
4440 current set of frames, or where the minibuffer is currently being
4441 displayed.
4443 This variable is local to the current terminal and cannot be buffer-local. */);
4445 DEFVAR_BOOL ("focus-follows-mouse", focus_follows_mouse,
4446 doc: /* Non-nil if window system changes focus when you move the mouse.
4447 You should set this variable to tell Emacs how your window manager
4448 handles focus, since there is no way in general for Emacs to find out
4449 automatically. See also `mouse-autoselect-window'. */);
4450 focus_follows_mouse = 0;
4452 staticpro (&Vframe_list);
4454 defsubr (&Sframep);
4455 defsubr (&Sframe_live_p);
4456 defsubr (&Swindow_system);
4457 defsubr (&Smake_terminal_frame);
4458 defsubr (&Shandle_switch_frame);
4459 defsubr (&Sselect_frame);
4460 defsubr (&Sselected_frame);
4461 defsubr (&Sframe_list);
4462 defsubr (&Snext_frame);
4463 defsubr (&Sprevious_frame);
4464 defsubr (&Sdelete_frame);
4465 defsubr (&Smouse_position);
4466 defsubr (&Smouse_pixel_position);
4467 defsubr (&Sset_mouse_position);
4468 defsubr (&Sset_mouse_pixel_position);
4469 #if 0
4470 defsubr (&Sframe_configuration);
4471 defsubr (&Srestore_frame_configuration);
4472 #endif
4473 defsubr (&Smake_frame_visible);
4474 defsubr (&Smake_frame_invisible);
4475 defsubr (&Siconify_frame);
4476 defsubr (&Sframe_visible_p);
4477 defsubr (&Svisible_frame_list);
4478 defsubr (&Sraise_frame);
4479 defsubr (&Slower_frame);
4480 defsubr (&Sredirect_frame_focus);
4481 defsubr (&Sframe_focus);
4482 defsubr (&Sframe_parameters);
4483 defsubr (&Sframe_parameter);
4484 defsubr (&Smodify_frame_parameters);
4485 defsubr (&Sframe_char_height);
4486 defsubr (&Sframe_char_width);
4487 defsubr (&Sframe_pixel_height);
4488 defsubr (&Sframe_pixel_width);
4489 defsubr (&Stool_bar_pixel_width);
4490 defsubr (&Sset_frame_height);
4491 defsubr (&Sset_frame_width);
4492 defsubr (&Sset_frame_size);
4493 defsubr (&Sset_frame_position);
4494 defsubr (&Sframe_pointer_visible_p);
4496 #ifdef HAVE_WINDOW_SYSTEM
4497 defsubr (&Sx_get_resource);
4498 defsubr (&Sx_parse_geometry);
4499 #endif