Add arch tagline
[emacs.git] / src / frame.c
bloba8efa11f728c2a203da4b1b6cf43a5b33544d49b
1 /* Generic frame functions.
2 Copyright (C) 1993, 1994, 1995, 1997, 1999, 2000, 2001, 2002, 2003,
3 2004, 2005, 2006, 2007 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, or (at your option)
10 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; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
20 Boston, MA 02110-1301, USA. */
22 #include <config.h>
24 #include <stdio.h>
25 #include "lisp.h"
26 #include "charset.h"
27 #ifdef HAVE_X_WINDOWS
28 #include "xterm.h"
29 #endif
30 #ifdef WINDOWSNT
31 #include "w32term.h"
32 #endif
33 #ifdef MAC_OS
34 #include "macterm.h"
35 #endif
36 #include "buffer.h"
37 /* These help us bind and responding to switch-frame events. */
38 #include "commands.h"
39 #include "keyboard.h"
40 #include "frame.h"
41 #ifdef HAVE_WINDOW_SYSTEM
42 #include "fontset.h"
43 #endif
44 #include "blockinput.h"
45 #include "termchar.h"
46 #include "termhooks.h"
47 #include "dispextern.h"
48 #include "window.h"
49 #ifdef MSDOS
50 #include "msdos.h"
51 #include "dosfns.h"
52 #endif
55 #ifdef HAVE_WINDOW_SYSTEM
57 /* The name we're using in resource queries. Most often "emacs". */
59 Lisp_Object Vx_resource_name;
61 /* The application class we're using in resource queries.
62 Normally "Emacs". */
64 Lisp_Object Vx_resource_class;
66 #endif
68 Lisp_Object Qframep, Qframe_live_p;
69 Lisp_Object Qicon, Qmodeline;
70 Lisp_Object Qonly;
71 Lisp_Object Qx, Qw32, Qmac, Qpc;
72 Lisp_Object Qvisible;
73 Lisp_Object Qdisplay_type;
74 Lisp_Object Qbackground_mode;
76 Lisp_Object Qx_frame_parameter;
77 Lisp_Object Qx_resource_name;
78 Lisp_Object Qterminal;
79 Lisp_Object Qterminal_live_p;
81 /* Frame parameters (set or reported). */
83 Lisp_Object Qauto_raise, Qauto_lower;
84 Lisp_Object Qborder_color, Qborder_width;
85 Lisp_Object Qcursor_color, Qcursor_type;
86 Lisp_Object Qgeometry; /* Not used */
87 Lisp_Object Qheight, Qwidth;
88 Lisp_Object Qleft, Qright;
89 Lisp_Object Qicon_left, Qicon_top, Qicon_type, Qicon_name;
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 Lisp_Object Quser_position, Quser_size;
99 Lisp_Object Qwait_for_wm;
100 Lisp_Object Qwindow_id;
101 #ifdef HAVE_X_WINDOWS
102 Lisp_Object Qouter_window_id;
103 #endif
104 Lisp_Object Qparent_id;
105 Lisp_Object Qtitle, Qname;
106 Lisp_Object Qexplicit_name;
107 Lisp_Object Qunsplittable;
108 Lisp_Object Qmenu_bar_lines, Qtool_bar_lines;
109 Lisp_Object Qleft_fringe, Qright_fringe;
110 Lisp_Object Qbuffer_predicate, Qbuffer_list, Qburied_buffer_list;
111 Lisp_Object Qtty_color_mode;
112 Lisp_Object Qtty, Qtty_type;
114 Lisp_Object Qfullscreen, Qfullwidth, Qfullheight, Qfullboth;
116 Lisp_Object Qinhibit_face_set_after_frame_default;
117 Lisp_Object Qface_set_after_frame_default;
119 Lisp_Object Vterminal_frame;
120 Lisp_Object Vdefault_frame_alist;
121 Lisp_Object Vdefault_frame_scroll_bars;
122 Lisp_Object Vmouse_position_function;
123 Lisp_Object Vmouse_highlight;
124 Lisp_Object Vdelete_frame_functions;
126 int focus_follows_mouse;
128 static void
129 set_menu_bar_lines_1 (window, n)
130 Lisp_Object window;
131 int n;
133 struct window *w = XWINDOW (window);
135 XSETFASTINT (w->last_modified, 0);
136 XSETFASTINT (w->top_line, XFASTINT (w->top_line) + n);
137 XSETFASTINT (w->total_lines, XFASTINT (w->total_lines) - n);
139 if (INTEGERP (w->orig_top_line))
140 XSETFASTINT (w->orig_top_line, XFASTINT (w->orig_top_line) + n);
141 if (INTEGERP (w->orig_total_lines))
142 XSETFASTINT (w->orig_total_lines, XFASTINT (w->orig_total_lines) - n);
144 /* Handle just the top child in a vertical split. */
145 if (!NILP (w->vchild))
146 set_menu_bar_lines_1 (w->vchild, n);
148 /* Adjust all children in a horizontal split. */
149 for (window = w->hchild; !NILP (window); window = w->next)
151 w = XWINDOW (window);
152 set_menu_bar_lines_1 (window, n);
156 void
157 set_menu_bar_lines (f, value, oldval)
158 struct frame *f;
159 Lisp_Object value, oldval;
161 int nlines;
162 int olines = FRAME_MENU_BAR_LINES (f);
164 /* Right now, menu bars don't work properly in minibuf-only frames;
165 most of the commands try to apply themselves to the minibuffer
166 frame itself, and get an error because you can't switch buffers
167 in or split the minibuffer window. */
168 if (FRAME_MINIBUF_ONLY_P (f))
169 return;
171 if (INTEGERP (value))
172 nlines = XINT (value);
173 else
174 nlines = 0;
176 if (nlines != olines)
178 windows_or_buffers_changed++;
179 FRAME_WINDOW_SIZES_CHANGED (f) = 1;
180 FRAME_MENU_BAR_LINES (f) = nlines;
181 set_menu_bar_lines_1 (f->root_window, nlines - olines);
182 adjust_glyphs (f);
186 Lisp_Object Vemacs_iconified;
187 Lisp_Object Vframe_list;
189 extern Lisp_Object Vminibuffer_list;
190 extern Lisp_Object get_minibuffer ();
191 extern Lisp_Object Fhandle_switch_frame ();
192 extern Lisp_Object Fredirect_frame_focus ();
193 extern Lisp_Object x_get_focus_frame ();
195 DEFUN ("framep", Fframep, Sframep, 1, 1, 0,
196 doc: /* Return non-nil if OBJECT is a frame.
197 Value is t for a termcap frame (a character-only terminal),
198 `x' for an Emacs frame that is really an X window,
199 `w32' for an Emacs frame that is a window on MS-Windows display,
200 `mac' for an Emacs frame on a Macintosh display,
201 `pc' for a direct-write MS-DOS frame.
202 See also `frame-live-p'. */)
203 (object)
204 Lisp_Object object;
206 if (!FRAMEP (object))
207 return Qnil;
208 switch (XFRAME (object)->output_method)
210 case output_initial: /* The initial frame is like a termcap frame. */
211 case output_termcap:
212 return Qt;
213 case output_x_window:
214 return Qx;
215 case output_w32:
216 return Qw32;
217 case output_msdos_raw:
218 return Qpc;
219 case output_mac:
220 return Qmac;
221 default:
222 abort ();
226 DEFUN ("frame-live-p", Fframe_live_p, Sframe_live_p, 1, 1, 0,
227 doc: /* Return non-nil if OBJECT is a frame which has not been deleted.
228 Value is nil if OBJECT is not a live frame. If object is a live
229 frame, the return value indicates what sort of terminal device it is
230 displayed on. See the documentation of `framep' for possible
231 return values. */)
232 (object)
233 Lisp_Object object;
235 return ((FRAMEP (object)
236 && FRAME_LIVE_P (XFRAME (object)))
237 ? Fframep (object)
238 : Qnil);
241 DEFUN ("window-system", Fwindow_system, Swindow_system, 0, 1, 0,
242 doc: /* The name of the window system that FRAME is displaying through.
243 The value is a symbol---for instance, 'x' for X windows.
244 The value is nil if Emacs is using a text-only terminal.
246 FRAME defaults to the currently selected frame. */)
247 (frame)
248 Lisp_Object frame;
250 Lisp_Object type;
251 if (NILP (frame))
252 frame = selected_frame;
254 type = Fframep (frame);
256 if (NILP (type))
257 wrong_type_argument (Qframep, frame);
259 if (EQ (type, Qt))
260 return Qnil;
261 else
262 return type;
265 struct frame *
266 make_frame (mini_p)
267 int mini_p;
269 Lisp_Object frame;
270 register struct frame *f;
271 register Lisp_Object root_window;
272 register Lisp_Object mini_window;
274 f = allocate_frame ();
275 XSETFRAME (frame, f);
277 f->desired_matrix = 0;
278 f->current_matrix = 0;
279 f->desired_pool = 0;
280 f->current_pool = 0;
281 f->glyphs_initialized_p = 0;
282 f->decode_mode_spec_buffer = 0;
283 f->visible = 0;
284 f->async_visible = 0;
285 f->output_data.nothing = 0;
286 f->iconified = 0;
287 f->async_iconified = 0;
288 f->wants_modeline = 1;
289 f->auto_raise = 0;
290 f->auto_lower = 0;
291 f->no_split = 0;
292 f->garbaged = 1;
293 f->has_minibuffer = mini_p;
294 f->focus_frame = Qnil;
295 f->explicit_name = 0;
296 f->can_have_scroll_bars = 0;
297 f->vertical_scroll_bar_type = vertical_scroll_bar_none;
298 f->param_alist = Qnil;
299 f->scroll_bars = Qnil;
300 f->condemned_scroll_bars = Qnil;
301 f->face_alist = Qnil;
302 f->face_cache = NULL;
303 f->menu_bar_items = Qnil;
304 f->menu_bar_vector = Qnil;
305 f->menu_bar_items_used = 0;
306 f->buffer_predicate = Qnil;
307 f->buffer_list = Qnil;
308 f->buried_buffer_list = Qnil;
309 f->namebuf = 0;
310 f->title = Qnil;
311 f->menu_bar_window = Qnil;
312 f->tool_bar_window = Qnil;
313 f->tool_bar_items = Qnil;
314 f->desired_tool_bar_string = f->current_tool_bar_string = Qnil;
315 f->n_tool_bar_items = 0;
316 f->left_fringe_width = f->right_fringe_width = 0;
317 f->fringe_cols = 0;
318 f->scroll_bar_actual_width = 0;
319 f->border_width = 0;
320 f->internal_border_width = 0;
321 f->column_width = 1; /* !FRAME_WINDOW_P value */
322 f->line_height = 1; /* !FRAME_WINDOW_P value */
323 f->x_pixels_diff = f->y_pixels_diff = 0;
324 #ifdef HAVE_WINDOW_SYSTEM
325 f->want_fullscreen = FULLSCREEN_NONE;
326 #endif
327 f->size_hint_flags = 0;
328 f->win_gravity = 0;
330 root_window = make_window ();
331 if (mini_p)
333 mini_window = make_window ();
334 XWINDOW (root_window)->next = mini_window;
335 XWINDOW (mini_window)->prev = root_window;
336 XWINDOW (mini_window)->mini_p = Qt;
337 XWINDOW (mini_window)->frame = frame;
338 f->minibuffer_window = mini_window;
340 else
342 mini_window = Qnil;
343 XWINDOW (root_window)->next = Qnil;
344 f->minibuffer_window = Qnil;
347 XWINDOW (root_window)->frame = frame;
349 /* 10 is arbitrary,
350 just so that there is "something there."
351 Correct size will be set up later with change_frame_size. */
353 SET_FRAME_COLS (f, 10);
354 FRAME_LINES (f) = 10;
356 XSETFASTINT (XWINDOW (root_window)->total_cols, 10);
357 XSETFASTINT (XWINDOW (root_window)->total_lines, (mini_p ? 9 : 10));
359 if (mini_p)
361 XSETFASTINT (XWINDOW (mini_window)->total_cols, 10);
362 XSETFASTINT (XWINDOW (mini_window)->top_line, 9);
363 XSETFASTINT (XWINDOW (mini_window)->total_lines, 1);
366 /* Choose a buffer for the frame's root window. */
368 Lisp_Object buf;
370 XWINDOW (root_window)->buffer = Qt;
371 buf = Fcurrent_buffer ();
372 /* If buf is a 'hidden' buffer (i.e. one whose name starts with
373 a space), try to find another one. */
374 if (SREF (Fbuffer_name (buf), 0) == ' ')
375 buf = Fother_buffer (buf, Qnil, Qnil);
377 /* Use set_window_buffer, not Fset_window_buffer, and don't let
378 hooks be run by it. The reason is that the whole frame/window
379 arrangement is not yet fully intialized at this point. Windows
380 don't have the right size, glyph matrices aren't initialized
381 etc. Running Lisp functions at this point surely ends in a
382 SEGV. */
383 set_window_buffer (root_window, buf, 0, 0);
384 f->buffer_list = Fcons (buf, Qnil);
387 if (mini_p)
389 XWINDOW (mini_window)->buffer = Qt;
390 set_window_buffer (mini_window,
391 (NILP (Vminibuffer_list)
392 ? get_minibuffer (0)
393 : Fcar (Vminibuffer_list)),
394 0, 0);
397 f->root_window = root_window;
398 f->selected_window = root_window;
399 /* Make sure this window seems more recently used than
400 a newly-created, never-selected window. */
401 ++window_select_count;
402 XSETFASTINT (XWINDOW (f->selected_window)->use_time, window_select_count);
404 f->default_face_done_p = 0;
406 return f;
409 #ifdef HAVE_WINDOW_SYSTEM
410 /* Make a frame using a separate minibuffer window on another frame.
411 MINI_WINDOW is the minibuffer window to use. nil means use the
412 default (the global minibuffer). */
414 struct frame *
415 make_frame_without_minibuffer (mini_window, kb, display)
416 register Lisp_Object mini_window;
417 KBOARD *kb;
418 Lisp_Object display;
420 register struct frame *f;
421 struct gcpro gcpro1;
423 if (!NILP (mini_window))
424 CHECK_LIVE_WINDOW (mini_window);
426 #ifdef MULTI_KBOARD
427 if (!NILP (mini_window)
428 && FRAME_KBOARD (XFRAME (XWINDOW (mini_window)->frame)) != kb)
429 error ("Frame and minibuffer must be on the same terminal");
430 #endif
432 /* Make a frame containing just a root window. */
433 f = make_frame (0);
435 if (NILP (mini_window))
437 /* Use default-minibuffer-frame if possible. */
438 if (!FRAMEP (kb->Vdefault_minibuffer_frame)
439 || ! FRAME_LIVE_P (XFRAME (kb->Vdefault_minibuffer_frame)))
441 Lisp_Object frame_dummy;
443 XSETFRAME (frame_dummy, f);
444 GCPRO1 (frame_dummy);
445 /* If there's no minibuffer frame to use, create one. */
446 kb->Vdefault_minibuffer_frame =
447 call1 (intern ("make-initial-minibuffer-frame"), display);
448 UNGCPRO;
451 mini_window = XFRAME (kb->Vdefault_minibuffer_frame)->minibuffer_window;
454 f->minibuffer_window = mini_window;
456 /* Make the chosen minibuffer window display the proper minibuffer,
457 unless it is already showing a minibuffer. */
458 if (NILP (Fmemq (XWINDOW (mini_window)->buffer, Vminibuffer_list)))
459 Fset_window_buffer (mini_window,
460 (NILP (Vminibuffer_list)
461 ? get_minibuffer (0)
462 : Fcar (Vminibuffer_list)), Qnil);
463 return f;
466 /* Make a frame containing only a minibuffer window. */
468 struct frame *
469 make_minibuffer_frame ()
471 /* First make a frame containing just a root window, no minibuffer. */
473 register struct frame *f = make_frame (0);
474 register Lisp_Object mini_window;
475 register Lisp_Object frame;
477 XSETFRAME (frame, f);
479 f->auto_raise = 0;
480 f->auto_lower = 0;
481 f->no_split = 1;
482 f->wants_modeline = 0;
483 f->has_minibuffer = 1;
485 /* Now label the root window as also being the minibuffer.
486 Avoid infinite looping on the window chain by marking next pointer
487 as nil. */
489 mini_window = f->minibuffer_window = f->root_window;
490 XWINDOW (mini_window)->mini_p = Qt;
491 XWINDOW (mini_window)->next = Qnil;
492 XWINDOW (mini_window)->prev = Qnil;
493 XWINDOW (mini_window)->frame = frame;
495 /* Put the proper buffer in that window. */
497 Fset_window_buffer (mini_window,
498 (NILP (Vminibuffer_list)
499 ? get_minibuffer (0)
500 : Fcar (Vminibuffer_list)), Qnil);
501 return f;
503 #endif /* HAVE_WINDOW_SYSTEM */
505 /* Construct a frame that refers to a terminal. */
507 static int tty_frame_count;
509 struct frame *
510 make_initial_frame (void)
512 struct frame *f;
513 struct terminal *terminal;
514 Lisp_Object frame;
516 #ifdef MULTI_KBOARD
517 /* Create the initial keyboard. */
518 if (!initial_kboard)
520 initial_kboard = (KBOARD *) xmalloc (sizeof (KBOARD));
521 init_kboard (initial_kboard);
522 /* Leave Vwindow_system at its `t' default for now. */
523 initial_kboard->next_kboard = all_kboards;
524 all_kboards = initial_kboard;
526 #endif
528 /* The first call must initialize Vframe_list. */
529 if (! (NILP (Vframe_list) || CONSP (Vframe_list)))
530 Vframe_list = Qnil;
532 terminal = init_initial_terminal ();
534 f = make_frame (1);
535 XSETFRAME (frame, f);
537 Vframe_list = Fcons (frame, Vframe_list);
539 tty_frame_count = 1;
540 f->name = build_string ("F1");
542 f->visible = 1;
543 f->async_visible = 1;
545 f->output_method = terminal->type;
546 f->terminal = terminal;
547 f->terminal->reference_count++;
548 f->output_data.nothing = 0;
550 FRAME_FOREGROUND_PIXEL (f) = FACE_TTY_DEFAULT_FG_COLOR;
551 FRAME_BACKGROUND_PIXEL (f) = FACE_TTY_DEFAULT_BG_COLOR;
553 FRAME_CAN_HAVE_SCROLL_BARS (f) = 0;
554 FRAME_VERTICAL_SCROLL_BAR_TYPE (f) = vertical_scroll_bar_none;
556 return f;
560 struct frame *
561 make_terminal_frame (struct terminal *terminal)
563 register struct frame *f;
564 Lisp_Object frame;
565 char name[20];
567 if (!terminal->name)
568 error ("Terminal is not live, can't create new frames on it");
570 f = make_frame (1);
572 XSETFRAME (frame, f);
573 Vframe_list = Fcons (frame, Vframe_list);
575 tty_frame_count++;
576 sprintf (name, "F%d", tty_frame_count);
577 f->name = build_string (name);
579 f->visible = 1; /* FRAME_SET_VISIBLE wd set frame_garbaged. */
580 f->async_visible = 1; /* Don't let visible be cleared later. */
581 #ifdef MSDOS
582 f->output_data.x = &the_only_x_display;
583 if (!inhibit_window_system
584 && (!FRAMEP (selected_frame) || !FRAME_LIVE_P (XFRAME (selected_frame))
585 || XFRAME (selected_frame)->output_method == output_msdos_raw))
587 f->output_method = output_msdos_raw;
588 /* This initialization of foreground and background pixels is
589 only important for the initial frame created in temacs. If
590 we don't do that, we get black background and foreground in
591 the dumped Emacs because the_only_x_display is a static
592 variable, hence it is born all-zeroes, and zero is the code
593 for the black color. Other frames all inherit their pixels
594 from what's already in the_only_x_display. */
595 if ((!FRAMEP (selected_frame) || !FRAME_LIVE_P (XFRAME (selected_frame)))
596 && FRAME_BACKGROUND_PIXEL (f) == 0
597 && FRAME_FOREGROUND_PIXEL (f) == 0)
599 FRAME_BACKGROUND_PIXEL (f) = FACE_TTY_DEFAULT_BG_COLOR;
600 FRAME_FOREGROUND_PIXEL (f) = FACE_TTY_DEFAULT_FG_COLOR;
603 else
604 f->output_method = output_termcap;
605 #else
606 #ifdef MAC_OS8
607 make_mac_terminal_frame (f);
608 #else
610 f->output_method = output_termcap;
611 f->terminal = terminal;
612 f->terminal->reference_count++;
613 create_tty_output (f);
615 FRAME_FOREGROUND_PIXEL (f) = FACE_TTY_DEFAULT_FG_COLOR;
616 FRAME_BACKGROUND_PIXEL (f) = FACE_TTY_DEFAULT_BG_COLOR;
618 FRAME_CAN_HAVE_SCROLL_BARS (f) = 0;
619 FRAME_VERTICAL_SCROLL_BAR_TYPE (f) = vertical_scroll_bar_none;
621 /* Set the top frame to the newly created frame. */
622 if (FRAMEP (FRAME_TTY (f)->top_frame)
623 && FRAME_LIVE_P (XFRAME (FRAME_TTY (f)->top_frame)))
624 XFRAME (FRAME_TTY (f)->top_frame)->async_visible = 2; /* obscured */
626 FRAME_TTY (f)->top_frame = frame;
629 #ifdef CANNOT_DUMP
630 FRAME_FOREGROUND_PIXEL(f) = FACE_TTY_DEFAULT_FG_COLOR;
631 FRAME_BACKGROUND_PIXEL(f) = FACE_TTY_DEFAULT_BG_COLOR;
632 #endif
633 #endif /* MAC_OS8 */
634 #endif /* MSDOS */
636 if (!noninteractive)
637 init_frame_faces (f);
639 return f;
642 /* Get a suitable value for frame parameter PARAMETER for a newly
643 created frame, based on (1) the user-supplied frame parameter
644 alist SUPPLIED_PARMS, (2) CURRENT_VALUE, and finally, if all else
645 fails, (3) Vdefault_frame_alist. */
647 static Lisp_Object
648 get_future_frame_param (Lisp_Object parameter,
649 Lisp_Object supplied_parms,
650 char *current_value)
652 Lisp_Object result;
654 result = Fassq (parameter, supplied_parms);
655 if (NILP (result))
656 result = Fassq (parameter, XFRAME (selected_frame)->param_alist);
657 if (NILP (result) && current_value != NULL)
658 result = build_string (current_value);
659 if (NILP (result))
660 result = Fassq (parameter, Vdefault_frame_alist);
661 if (!NILP (result) && !STRINGP (result))
662 result = XCDR (result);
663 if (NILP (result) || !STRINGP (result))
664 result = Qnil;
666 return result;
669 DEFUN ("make-terminal-frame", Fmake_terminal_frame, Smake_terminal_frame,
670 1, 1, 0,
671 doc: /* Create an additional terminal frame, possibly on another terminal.
672 This function takes one argument, an alist specifying frame parameters.
674 You can create multiple frames on a single text-only terminal, but
675 only one of them (the selected terminal frame) is actually displayed.
677 In practice, generally you don't need to specify any parameters,
678 except when you want to create a new frame on another terminal.
679 In that case, the `tty' parameter specifies the device file to open,
680 and the `tty-type' parameter specifies the terminal type. Example:
682 (make-terminal-frame '((tty . "/dev/pts/5") (tty-type . "xterm")))
684 Note that changing the size of one terminal frame automatically
685 affects all frames on the same terminal device. */)
686 (parms)
687 Lisp_Object parms;
689 struct frame *f;
690 struct terminal *t = NULL;
691 Lisp_Object frame, tem;
692 struct frame *sf = SELECTED_FRAME ();
694 #ifdef MSDOS
695 if (sf->output_method != output_msdos_raw
696 && sf->output_method != output_termcap)
697 abort ();
698 #else /* not MSDOS */
700 #if 0 /* #ifdef MAC_OS */
701 /* This can happen for multi-tty when using both terminal frames and
702 Carbon frames. */
703 if (sf->output_method != output_mac)
704 error ("Not running on a Macintosh screen; cannot make a new Macintosh frame");
705 #else
706 #if 0 /* This should work now! */
707 if (sf->output_method != output_termcap)
708 error ("Not using an ASCII terminal now; cannot make a new ASCII frame");
709 #endif
710 #endif
711 #endif /* not MSDOS */
714 Lisp_Object terminal;
716 terminal = Fassq (Qterminal, parms);
717 if (!NILP (terminal))
719 terminal = XCDR (terminal);
720 t = get_terminal (terminal, 1);
724 if (!t)
726 char *name = 0, *type = 0;
727 Lisp_Object tty, tty_type;
729 tty = get_future_frame_param
730 (Qtty, parms, (FRAME_TERMCAP_P (XFRAME (selected_frame))
731 ? FRAME_TTY (XFRAME (selected_frame))->name
732 : NULL));
733 if (!NILP (tty))
735 name = (char *) alloca (SBYTES (tty) + 1);
736 strncpy (name, SDATA (tty), SBYTES (tty));
737 name[SBYTES (tty)] = 0;
740 tty_type = get_future_frame_param
741 (Qtty_type, parms, (FRAME_TERMCAP_P (XFRAME (selected_frame))
742 ? FRAME_TTY (XFRAME (selected_frame))->type
743 : NULL));
744 if (!NILP (tty_type))
746 type = (char *) alloca (SBYTES (tty_type) + 1);
747 strncpy (type, SDATA (tty_type), SBYTES (tty_type));
748 type[SBYTES (tty_type)] = 0;
751 t = init_tty (name, type, 0); /* Errors are not fatal. */
754 f = make_terminal_frame (t);
757 int width, height;
758 get_tty_size (fileno (FRAME_TTY (f)->input), &width, &height);
759 change_frame_size (f, height, width, 0, 0, 0);
762 adjust_glyphs (f);
763 calculate_costs (f);
764 XSETFRAME (frame, f);
765 Fmodify_frame_parameters (frame, Vdefault_frame_alist);
766 Fmodify_frame_parameters (frame, parms);
767 Fmodify_frame_parameters (frame, Fcons (Fcons (Qtty_type,
768 build_string (t->display_info.tty->type)),
769 Qnil));
770 if (t->display_info.tty->name != NULL)
771 Fmodify_frame_parameters (frame, Fcons (Fcons (Qtty,
772 build_string (t->display_info.tty->name)),
773 Qnil));
774 else
775 Fmodify_frame_parameters (frame, Fcons (Fcons (Qtty, Qnil), Qnil));
777 /* Make the frame face alist be frame-specific, so that each
778 frame could change its face definitions independently. */
779 f->face_alist = Fcopy_alist (sf->face_alist);
780 /* Simple Fcopy_alist isn't enough, because we need the contents of
781 the vectors which are the CDRs of associations in face_alist to
782 be copied as well. */
783 for (tem = f->face_alist; CONSP (tem); tem = XCDR (tem))
784 XSETCDR (XCAR (tem), Fcopy_sequence (XCDR (XCAR (tem))));
785 return frame;
789 /* Perform the switch to frame FRAME.
791 If FRAME is a switch-frame event `(switch-frame FRAME1)', use
792 FRAME1 as frame.
794 If TRACK is non-zero and the frame that currently has the focus
795 redirects its focus to the selected frame, redirect that focused
796 frame's focus to FRAME instead.
798 FOR_DELETION non-zero means that the selected frame is being
799 deleted, which includes the possibility that the frame's terminal
800 is dead. */
802 Lisp_Object
803 do_switch_frame (frame, track, for_deletion)
804 Lisp_Object frame;
805 int track, for_deletion;
807 struct frame *sf = SELECTED_FRAME ();
809 /* If FRAME is a switch-frame event, extract the frame we should
810 switch to. */
811 if (CONSP (frame)
812 && EQ (XCAR (frame), Qswitch_frame)
813 && CONSP (XCDR (frame)))
814 frame = XCAR (XCDR (frame));
816 /* This used to say CHECK_LIVE_FRAME, but apparently it's possible for
817 a switch-frame event to arrive after a frame is no longer live,
818 especially when deleting the initial frame during startup. */
819 CHECK_FRAME (frame);
820 if (! FRAME_LIVE_P (XFRAME (frame)))
821 return Qnil;
823 if (sf == XFRAME (frame))
824 return frame;
826 /* This is too greedy; it causes inappropriate focus redirection
827 that's hard to get rid of. */
828 #if 0
829 /* If a frame's focus has been redirected toward the currently
830 selected frame, we should change the redirection to point to the
831 newly selected frame. This means that if the focus is redirected
832 from a minibufferless frame to a surrogate minibuffer frame, we
833 can use `other-window' to switch between all the frames using
834 that minibuffer frame, and the focus redirection will follow us
835 around. */
836 if (track)
838 Lisp_Object tail;
840 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
842 Lisp_Object focus;
844 if (!FRAMEP (XCAR (tail)))
845 abort ();
847 focus = FRAME_FOCUS_FRAME (XFRAME (XCAR (tail)));
849 if (FRAMEP (focus) && XFRAME (focus) == SELECTED_FRAME ())
850 Fredirect_frame_focus (XCAR (tail), frame);
853 #else /* ! 0 */
854 /* Instead, apply it only to the frame we're pointing to. */
855 #ifdef HAVE_WINDOW_SYSTEM
856 if (track && FRAME_WINDOW_P (XFRAME (frame)))
858 Lisp_Object focus, xfocus;
860 xfocus = x_get_focus_frame (XFRAME (frame));
861 if (FRAMEP (xfocus))
863 focus = FRAME_FOCUS_FRAME (XFRAME (xfocus));
864 if (FRAMEP (focus) && XFRAME (focus) == SELECTED_FRAME ())
865 Fredirect_frame_focus (xfocus, frame);
868 #endif /* HAVE_X_WINDOWS */
869 #endif /* ! 0 */
871 if (!for_deletion && FRAME_HAS_MINIBUF_P (sf))
872 resize_mini_window (XWINDOW (FRAME_MINIBUF_WINDOW (sf)), 1);
874 if (FRAME_TERMCAP_P (XFRAME (selected_frame))
875 && FRAME_TERMCAP_P (XFRAME (frame))
876 && FRAME_TTY (XFRAME (selected_frame)) == FRAME_TTY (XFRAME (frame)))
878 XFRAME (selected_frame)->async_visible = 2; /* obscured */
879 XFRAME (frame)->async_visible = 1;
880 FRAME_TTY (XFRAME (frame))->top_frame = frame;
883 selected_frame = frame;
884 if (! FRAME_MINIBUF_ONLY_P (XFRAME (selected_frame)))
885 last_nonminibuf_frame = XFRAME (selected_frame);
887 Fselect_window (XFRAME (frame)->selected_window, Qnil);
889 #ifndef WINDOWSNT
890 /* Make sure to switch the tty color mode to that of the newly
891 selected frame. */
892 sf = SELECTED_FRAME ();
893 if (FRAME_TERMCAP_P (sf))
895 Lisp_Object color_mode_spec, color_mode;
897 color_mode_spec = assq_no_quit (Qtty_color_mode, sf->param_alist);
898 if (CONSP (color_mode_spec))
899 color_mode = XCDR (color_mode_spec);
900 else
901 color_mode = make_number (0);
902 set_tty_color_mode (sf, color_mode);
904 #endif /* !WINDOWSNT */
906 /* We want to make sure that the next event generates a frame-switch
907 event to the appropriate frame. This seems kludgy to me, but
908 before you take it out, make sure that evaluating something like
909 (select-window (frame-root-window (new-frame))) doesn't end up
910 with your typing being interpreted in the new frame instead of
911 the one you're actually typing in. */
912 internal_last_event_frame = Qnil;
914 return frame;
917 DEFUN ("select-frame", Fselect_frame, Sselect_frame, 1, 1, "e",
918 doc: /* Select the frame FRAME.
919 Subsequent editing commands apply to its selected window.
920 The selection of FRAME lasts until the next time the user does
921 something to select a different frame, or until the next time this
922 function is called. If you are using a window system, the previously
923 selected frame may be restored as the selected frame after return to
924 the command loop, because it still may have the window system's input
925 focus. On a text-only terminal, the next redisplay will display FRAME.
927 This function returns FRAME, or nil if FRAME has been deleted. */)
928 (frame)
929 Lisp_Object frame;
931 return do_switch_frame (frame, 1, 0);
935 DEFUN ("handle-switch-frame", Fhandle_switch_frame, Shandle_switch_frame, 1, 1, "e",
936 doc: /* Handle a switch-frame event EVENT.
937 Switch-frame events are usually bound to this function.
938 A switch-frame event tells Emacs that the window manager has requested
939 that the user's events be directed to the frame mentioned in the event.
940 This function selects the selected window of the frame of EVENT.
942 If EVENT is frame object, handle it as if it were a switch-frame event
943 to that frame. */)
944 (event)
945 Lisp_Object event;
947 /* Preserve prefix arg that the command loop just cleared. */
948 current_kboard->Vprefix_arg = Vcurrent_prefix_arg;
949 call1 (Vrun_hooks, Qmouse_leave_buffer_hook);
950 return do_switch_frame (event, 0, 0);
953 DEFUN ("selected-frame", Fselected_frame, Sselected_frame, 0, 0, 0,
954 doc: /* Return the frame that is now selected. */)
957 return selected_frame;
960 DEFUN ("window-frame", Fwindow_frame, Swindow_frame, 1, 1, 0,
961 doc: /* Return the frame object that window WINDOW is on. */)
962 (window)
963 Lisp_Object window;
965 CHECK_LIVE_WINDOW (window);
966 return XWINDOW (window)->frame;
969 DEFUN ("frame-first-window", Fframe_first_window, Sframe_first_window, 0, 1, 0,
970 doc: /* Returns the topmost, leftmost window of FRAME.
971 If omitted, FRAME defaults to the currently selected frame. */)
972 (frame)
973 Lisp_Object frame;
975 Lisp_Object w;
977 if (NILP (frame))
978 w = SELECTED_FRAME ()->root_window;
979 else
981 CHECK_LIVE_FRAME (frame);
982 w = XFRAME (frame)->root_window;
984 while (NILP (XWINDOW (w)->buffer))
986 if (! NILP (XWINDOW (w)->hchild))
987 w = XWINDOW (w)->hchild;
988 else if (! NILP (XWINDOW (w)->vchild))
989 w = XWINDOW (w)->vchild;
990 else
991 abort ();
993 return w;
996 DEFUN ("active-minibuffer-window", Factive_minibuffer_window,
997 Sactive_minibuffer_window, 0, 0, 0,
998 doc: /* Return the currently active minibuffer window, or nil if none. */)
1001 return minibuf_level ? minibuf_window : Qnil;
1004 DEFUN ("frame-root-window", Fframe_root_window, Sframe_root_window, 0, 1, 0,
1005 doc: /* Returns the root-window of FRAME.
1006 If omitted, FRAME defaults to the currently selected frame. */)
1007 (frame)
1008 Lisp_Object frame;
1010 Lisp_Object window;
1012 if (NILP (frame))
1013 window = SELECTED_FRAME ()->root_window;
1014 else
1016 CHECK_LIVE_FRAME (frame);
1017 window = XFRAME (frame)->root_window;
1020 return window;
1023 DEFUN ("frame-selected-window", Fframe_selected_window,
1024 Sframe_selected_window, 0, 1, 0,
1025 doc: /* Return the selected window of frame object FRAME.
1026 If omitted, FRAME defaults to the currently selected frame. */)
1027 (frame)
1028 Lisp_Object frame;
1030 Lisp_Object window;
1032 if (NILP (frame))
1033 window = SELECTED_FRAME ()->selected_window;
1034 else
1036 CHECK_LIVE_FRAME (frame);
1037 window = XFRAME (frame)->selected_window;
1040 return window;
1043 DEFUN ("set-frame-selected-window", Fset_frame_selected_window,
1044 Sset_frame_selected_window, 2, 2, 0,
1045 doc: /* Set the selected window of frame object FRAME to WINDOW.
1046 Return WINDOW.
1047 If FRAME is nil, the selected frame is used.
1048 If FRAME is the selected frame, this makes WINDOW the selected window. */)
1049 (frame, window)
1050 Lisp_Object frame, window;
1052 if (NILP (frame))
1053 frame = selected_frame;
1055 CHECK_LIVE_FRAME (frame);
1056 CHECK_LIVE_WINDOW (window);
1058 if (! EQ (frame, WINDOW_FRAME (XWINDOW (window))))
1059 error ("In `set-frame-selected-window', WINDOW is not on FRAME");
1061 if (EQ (frame, selected_frame))
1062 return Fselect_window (window, Qnil);
1064 return XFRAME (frame)->selected_window = window;
1068 DEFUN ("frame-list", Fframe_list, Sframe_list,
1069 0, 0, 0,
1070 doc: /* Return a list of all frames. */)
1073 Lisp_Object frames;
1074 frames = Fcopy_sequence (Vframe_list);
1075 #ifdef HAVE_WINDOW_SYSTEM
1076 if (FRAMEP (tip_frame))
1077 frames = Fdelq (tip_frame, frames);
1078 #endif
1079 return frames;
1082 /* Return the next frame in the frame list after FRAME.
1083 If MINIBUF is nil, exclude minibuffer-only frames.
1084 If MINIBUF is a window, include only its own frame
1085 and any frame now using that window as the minibuffer.
1086 If MINIBUF is `visible', include all visible frames.
1087 If MINIBUF is 0, include all visible and iconified frames.
1088 Otherwise, include all frames. */
1090 static Lisp_Object
1091 next_frame (frame, minibuf)
1092 Lisp_Object frame;
1093 Lisp_Object minibuf;
1095 Lisp_Object tail;
1096 int passed = 0;
1098 /* There must always be at least one frame in Vframe_list. */
1099 if (! CONSP (Vframe_list))
1100 abort ();
1102 /* If this frame is dead, it won't be in Vframe_list, and we'll loop
1103 forever. Forestall that. */
1104 CHECK_LIVE_FRAME (frame);
1106 while (1)
1107 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
1109 Lisp_Object f;
1111 f = XCAR (tail);
1113 if (passed
1114 && ((!FRAME_TERMCAP_P (XFRAME (f)) && !FRAME_TERMCAP_P (XFRAME (frame))
1115 && FRAME_KBOARD (XFRAME (f)) == FRAME_KBOARD (XFRAME (frame)))
1116 || (FRAME_TERMCAP_P (XFRAME (f)) && FRAME_TERMCAP_P (XFRAME (frame))
1117 && FRAME_TTY (XFRAME (f)) == FRAME_TTY (XFRAME (frame)))))
1119 /* Decide whether this frame is eligible to be returned. */
1121 /* If we've looped all the way around without finding any
1122 eligible frames, return the original frame. */
1123 if (EQ (f, frame))
1124 return f;
1126 /* Let minibuf decide if this frame is acceptable. */
1127 if (NILP (minibuf))
1129 if (! FRAME_MINIBUF_ONLY_P (XFRAME (f)))
1130 return f;
1132 else if (EQ (minibuf, Qvisible))
1134 FRAME_SAMPLE_VISIBILITY (XFRAME (f));
1135 if (FRAME_VISIBLE_P (XFRAME (f)))
1136 return f;
1138 else if (INTEGERP (minibuf) && XINT (minibuf) == 0)
1140 FRAME_SAMPLE_VISIBILITY (XFRAME (f));
1141 if (FRAME_VISIBLE_P (XFRAME (f))
1142 || FRAME_ICONIFIED_P (XFRAME (f)))
1143 return f;
1145 else if (WINDOWP (minibuf))
1147 if (EQ (FRAME_MINIBUF_WINDOW (XFRAME (f)), minibuf)
1148 || EQ (WINDOW_FRAME (XWINDOW (minibuf)), f)
1149 || EQ (WINDOW_FRAME (XWINDOW (minibuf)),
1150 FRAME_FOCUS_FRAME (XFRAME (f))))
1151 return f;
1153 else
1154 return f;
1157 if (EQ (frame, f))
1158 passed++;
1162 /* Return the previous frame in the frame list before FRAME.
1163 If MINIBUF is nil, exclude minibuffer-only frames.
1164 If MINIBUF is a window, include only its own frame
1165 and any frame now using that window as the minibuffer.
1166 If MINIBUF is `visible', include all visible frames.
1167 If MINIBUF is 0, include all visible and iconified frames.
1168 Otherwise, include all frames. */
1170 static Lisp_Object
1171 prev_frame (frame, minibuf)
1172 Lisp_Object frame;
1173 Lisp_Object minibuf;
1175 Lisp_Object tail;
1176 Lisp_Object prev;
1178 /* There must always be at least one frame in Vframe_list. */
1179 if (! CONSP (Vframe_list))
1180 abort ();
1182 prev = Qnil;
1183 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
1185 Lisp_Object f;
1187 f = XCAR (tail);
1188 if (!FRAMEP (f))
1189 abort ();
1191 if (EQ (frame, f) && !NILP (prev))
1192 return prev;
1194 if ((!FRAME_TERMCAP_P (XFRAME (f)) && !FRAME_TERMCAP_P (XFRAME (frame))
1195 && FRAME_KBOARD (XFRAME (f)) == FRAME_KBOARD (XFRAME (frame)))
1196 || (FRAME_TERMCAP_P (XFRAME (f)) && FRAME_TERMCAP_P (XFRAME (frame))
1197 && FRAME_TTY (XFRAME (f)) == FRAME_TTY (XFRAME (frame))))
1199 /* Decide whether this frame is eligible to be returned,
1200 according to minibuf. */
1201 if (NILP (minibuf))
1203 if (! FRAME_MINIBUF_ONLY_P (XFRAME (f)))
1204 prev = f;
1206 else if (WINDOWP (minibuf))
1208 if (EQ (FRAME_MINIBUF_WINDOW (XFRAME (f)), minibuf)
1209 || EQ (WINDOW_FRAME (XWINDOW (minibuf)), f)
1210 || EQ (WINDOW_FRAME (XWINDOW (minibuf)),
1211 FRAME_FOCUS_FRAME (XFRAME (f))))
1212 prev = f;
1214 else if (EQ (minibuf, Qvisible))
1216 FRAME_SAMPLE_VISIBILITY (XFRAME (f));
1217 if (FRAME_VISIBLE_P (XFRAME (f)))
1218 prev = f;
1220 else if (XFASTINT (minibuf) == 0)
1222 FRAME_SAMPLE_VISIBILITY (XFRAME (f));
1223 if (FRAME_VISIBLE_P (XFRAME (f))
1224 || FRAME_ICONIFIED_P (XFRAME (f)))
1225 prev = f;
1227 else
1228 prev = f;
1232 /* We've scanned the entire list. */
1233 if (NILP (prev))
1234 /* We went through the whole frame list without finding a single
1235 acceptable frame. Return the original frame. */
1236 return frame;
1237 else
1238 /* There were no acceptable frames in the list before FRAME; otherwise,
1239 we would have returned directly from the loop. Since PREV is the last
1240 acceptable frame in the list, return it. */
1241 return prev;
1245 DEFUN ("next-frame", Fnext_frame, Snext_frame, 0, 2, 0,
1246 doc: /* Return the next frame in the frame list after FRAME.
1247 It considers only frames on the same terminal as FRAME.
1248 By default, skip minibuffer-only frames.
1249 If omitted, FRAME defaults to the selected frame.
1250 If optional argument MINIFRAME is nil, exclude minibuffer-only frames.
1251 If MINIFRAME is a window, include only its own frame
1252 and any frame now using that window as the minibuffer.
1253 If MINIFRAME is `visible', include all visible frames.
1254 If MINIFRAME is 0, include all visible and iconified frames.
1255 Otherwise, include all frames. */)
1256 (frame, miniframe)
1257 Lisp_Object frame, miniframe;
1259 if (NILP (frame))
1260 frame = selected_frame;
1262 CHECK_LIVE_FRAME (frame);
1263 return next_frame (frame, miniframe);
1266 DEFUN ("previous-frame", Fprevious_frame, Sprevious_frame, 0, 2, 0,
1267 doc: /* Return the previous frame in the frame list before FRAME.
1268 It considers only frames on the same terminal as FRAME.
1269 By default, skip minibuffer-only frames.
1270 If omitted, FRAME defaults to the selected frame.
1271 If optional argument MINIFRAME is nil, exclude minibuffer-only frames.
1272 If MINIFRAME is a window, include only its own frame
1273 and any frame now using that window as the minibuffer.
1274 If MINIFRAME is `visible', include all visible frames.
1275 If MINIFRAME is 0, include all visible and iconified frames.
1276 Otherwise, include all frames. */)
1277 (frame, miniframe)
1278 Lisp_Object frame, miniframe;
1280 if (NILP (frame))
1281 frame = selected_frame;
1282 CHECK_LIVE_FRAME (frame);
1283 return prev_frame (frame, miniframe);
1286 /* Return 1 if it is ok to delete frame F;
1287 0 if all frames aside from F are invisible.
1288 (Exception: if F is the terminal frame, and we are using X, return 1.) */
1291 other_visible_frames (f)
1292 FRAME_PTR f;
1294 /* We know the selected frame is visible,
1295 so if F is some other frame, it can't be the sole visible one. */
1296 if (f == SELECTED_FRAME ())
1298 Lisp_Object frames;
1299 int count = 0;
1301 for (frames = Vframe_list;
1302 CONSP (frames);
1303 frames = XCDR (frames))
1305 Lisp_Object this;
1307 this = XCAR (frames);
1308 /* Verify that the frame's window still exists
1309 and we can still talk to it. And note any recent change
1310 in visibility. */
1311 #ifdef HAVE_WINDOW_SYSTEM
1312 if (FRAME_WINDOW_P (XFRAME (this)))
1314 x_sync (XFRAME (this));
1315 FRAME_SAMPLE_VISIBILITY (XFRAME (this));
1317 #endif
1319 if (FRAME_VISIBLE_P (XFRAME (this))
1320 || FRAME_ICONIFIED_P (XFRAME (this))
1321 /* Allow deleting the terminal frame when at least
1322 one X frame exists! */
1323 || (FRAME_WINDOW_P (XFRAME (this)) && !FRAME_WINDOW_P (f)))
1324 count++;
1326 return count > 1;
1328 return 1;
1331 /* Error handler for `delete-frame-functions'. */
1332 static Lisp_Object
1333 delete_frame_handler (Lisp_Object arg)
1335 add_to_log ("Error during `delete-frame': %s", arg, Qnil);
1336 return Qnil;
1339 DEFUN ("delete-frame", Fdelete_frame, Sdelete_frame, 0, 2, "",
1340 doc: /* Delete FRAME, permanently eliminating it from use.
1341 If omitted, FRAME defaults to the selected frame.
1342 A frame may not be deleted if its minibuffer is used by other frames.
1343 Normally, you may not delete a frame if all other frames are invisible,
1344 but if the second optional argument FORCE is non-nil, you may do so.
1346 This function runs `delete-frame-functions' before actually deleting the
1347 frame, unless the frame is a tooltip.
1348 The functions are run with one arg, the frame to be deleted. */)
1349 (frame, force)
1350 Lisp_Object frame, force;
1352 struct frame *f;
1353 struct frame *sf = SELECTED_FRAME ();
1354 struct kboard *kb;
1356 int minibuffer_selected;
1358 if (EQ (frame, Qnil))
1360 f = sf;
1361 XSETFRAME (frame, f);
1363 else
1365 CHECK_FRAME (frame);
1366 f = XFRAME (frame);
1369 if (! FRAME_LIVE_P (f))
1370 return Qnil;
1372 if (NILP (force) && !other_visible_frames (f)
1373 #ifdef MAC_OS8
1374 /* Terminal frame deleted before any other visible frames are
1375 created. */
1376 && strcmp (SDATA (f->name), "F1") != 0
1377 #endif
1379 error ("Attempt to delete the sole visible or iconified frame");
1381 #if 0
1382 /* This is a nice idea, but x_connection_closed needs to be able
1383 to delete the last frame, if it is gone. */
1384 if (NILP (XCDR (Vframe_list)))
1385 error ("Attempt to delete the only frame");
1386 #endif
1388 /* Does this frame have a minibuffer, and is it the surrogate
1389 minibuffer for any other frame? */
1390 if (FRAME_HAS_MINIBUF_P (XFRAME (frame)))
1392 Lisp_Object frames;
1394 for (frames = Vframe_list;
1395 CONSP (frames);
1396 frames = XCDR (frames))
1398 Lisp_Object this;
1399 this = XCAR (frames);
1401 if (! EQ (this, frame)
1402 && EQ (frame,
1403 WINDOW_FRAME (XWINDOW
1404 (FRAME_MINIBUF_WINDOW (XFRAME (this))))))
1405 error ("Attempt to delete a surrogate minibuffer frame");
1409 /* Run `delete-frame-functions' unless frame is a tooltip. */
1410 if (!NILP (Vrun_hooks)
1411 && NILP (Fframe_parameter (frame, intern ("tooltip"))))
1413 Lisp_Object args[2];
1414 struct gcpro gcpro1, gcpro2;
1416 /* Don't let a rogue function in `delete-frame-functions'
1417 prevent the frame deletion. */
1418 GCPRO2 (args[0], args[1]);
1419 args[0] = intern ("delete-frame-functions");
1420 args[1] = frame;
1421 internal_condition_case_2 (Frun_hook_with_args, 2, args,
1422 Qt, delete_frame_handler);
1423 UNGCPRO;
1426 /* The hook may sometimes (indirectly) cause the frame to be deleted. */
1427 if (! FRAME_LIVE_P (f))
1428 return Qnil;
1430 minibuffer_selected = EQ (minibuf_window, selected_window);
1432 /* Don't let the frame remain selected. */
1433 if (f == sf)
1435 Lisp_Object tail, frame1;
1437 /* Look for another visible frame on the same terminal. */
1438 frame1 = next_frame (frame, Qvisible);
1440 /* If there is none, find *some* other frame. */
1441 if (NILP (frame1) || EQ (frame1, frame))
1443 FOR_EACH_FRAME (tail, frame1)
1445 if (! EQ (frame, frame1) && FRAME_LIVE_P (XFRAME (frame1)))
1446 break;
1450 do_switch_frame (frame1, 0, 1);
1451 sf = SELECTED_FRAME ();
1454 /* Don't allow minibuf_window to remain on a deleted frame. */
1455 if (EQ (f->minibuffer_window, minibuf_window))
1457 Fset_window_buffer (sf->minibuffer_window,
1458 XWINDOW (minibuf_window)->buffer, Qnil);
1459 minibuf_window = sf->minibuffer_window;
1461 /* If the dying minibuffer window was selected,
1462 select the new one. */
1463 if (minibuffer_selected)
1464 Fselect_window (minibuf_window, Qnil);
1467 /* Don't let echo_area_window to remain on a deleted frame. */
1468 if (EQ (f->minibuffer_window, echo_area_window))
1469 echo_area_window = sf->minibuffer_window;
1471 /* Clear any X selections for this frame. */
1472 #ifdef HAVE_X_WINDOWS
1473 if (FRAME_X_P (f))
1474 x_clear_frame_selections (f);
1475 #endif
1476 #ifdef MAC_OS
1477 if (FRAME_MAC_P (f))
1478 x_clear_frame_selections (f);
1479 #endif
1481 /* Free glyphs.
1482 This function must be called before the window tree of the
1483 frame is deleted because windows contain dynamically allocated
1484 memory. */
1485 free_glyphs (f);
1487 /* Mark all the windows that used to be on FRAME as deleted, and then
1488 remove the reference to them. */
1489 delete_all_subwindows (XWINDOW (f->root_window));
1490 f->root_window = Qnil;
1492 Vframe_list = Fdelq (frame, Vframe_list);
1493 FRAME_SET_VISIBLE (f, 0);
1495 if (f->namebuf)
1496 xfree (f->namebuf);
1497 if (f->decode_mode_spec_buffer)
1498 xfree (f->decode_mode_spec_buffer);
1499 if (FRAME_INSERT_COST (f))
1500 xfree (FRAME_INSERT_COST (f));
1501 if (FRAME_DELETEN_COST (f))
1502 xfree (FRAME_DELETEN_COST (f));
1503 if (FRAME_INSERTN_COST (f))
1504 xfree (FRAME_INSERTN_COST (f));
1505 if (FRAME_DELETE_COST (f))
1506 xfree (FRAME_DELETE_COST (f));
1507 if (FRAME_MESSAGE_BUF (f))
1508 xfree (FRAME_MESSAGE_BUF (f));
1510 /* Since some events are handled at the interrupt level, we may get
1511 an event for f at any time; if we zero out the frame's terminal
1512 now, then we may trip up the event-handling code. Instead, we'll
1513 promise that the terminal of the frame must be valid until we
1514 have called the window-system-dependent frame destruction
1515 routine. */
1517 if (FRAME_TERMINAL (f)->delete_frame_hook)
1518 (*FRAME_TERMINAL (f)->delete_frame_hook) (f);
1521 struct terminal *terminal = FRAME_TERMINAL (f);
1522 f->output_data.nothing = 0;
1523 f->terminal = 0; /* Now the frame is dead. */
1525 /* If needed, delete the terminal that this frame was on.
1526 (This must be done after the frame is killed.) */
1527 terminal->reference_count--;
1528 if (terminal->reference_count == 0)
1530 kb = NULL;
1531 if (terminal->delete_terminal_hook)
1532 (*terminal->delete_terminal_hook) (terminal);
1533 else
1534 delete_terminal (terminal);
1536 #ifdef MULTI_KBOARD
1537 else
1538 kb = terminal->kboard;
1539 #endif
1542 /* If we've deleted the last_nonminibuf_frame, then try to find
1543 another one. */
1544 if (f == last_nonminibuf_frame)
1546 Lisp_Object frames;
1548 last_nonminibuf_frame = 0;
1550 for (frames = Vframe_list;
1551 CONSP (frames);
1552 frames = XCDR (frames))
1554 f = XFRAME (XCAR (frames));
1555 if (!FRAME_MINIBUF_ONLY_P (f))
1557 last_nonminibuf_frame = f;
1558 break;
1563 /* If there's no other frame on the same kboard, get out of
1564 single-kboard state if we're in it for this kboard. */
1565 if (kb != NULL)
1567 Lisp_Object frames;
1568 /* Some frame we found on the same kboard, or nil if there are none. */
1569 Lisp_Object frame_on_same_kboard;
1571 frame_on_same_kboard = Qnil;
1573 for (frames = Vframe_list;
1574 CONSP (frames);
1575 frames = XCDR (frames))
1577 Lisp_Object this;
1578 struct frame *f1;
1580 this = XCAR (frames);
1581 if (!FRAMEP (this))
1582 abort ();
1583 f1 = XFRAME (this);
1585 if (kb == FRAME_KBOARD (f1))
1586 frame_on_same_kboard = this;
1589 if (NILP (frame_on_same_kboard))
1590 not_single_kboard_state (kb);
1594 /* If we've deleted this keyboard's default_minibuffer_frame, try to
1595 find another one. Prefer minibuffer-only frames, but also notice
1596 frames with other windows. */
1597 if (kb != NULL && EQ (frame, kb->Vdefault_minibuffer_frame))
1599 Lisp_Object frames;
1601 /* The last frame we saw with a minibuffer, minibuffer-only or not. */
1602 Lisp_Object frame_with_minibuf;
1603 /* Some frame we found on the same kboard, or nil if there are none. */
1604 Lisp_Object frame_on_same_kboard;
1606 frame_on_same_kboard = Qnil;
1607 frame_with_minibuf = Qnil;
1609 for (frames = Vframe_list;
1610 CONSP (frames);
1611 frames = XCDR (frames))
1613 Lisp_Object this;
1614 struct frame *f1;
1616 this = XCAR (frames);
1617 if (!FRAMEP (this))
1618 abort ();
1619 f1 = XFRAME (this);
1621 /* Consider only frames on the same kboard
1622 and only those with minibuffers. */
1623 if (kb == FRAME_KBOARD (f1)
1624 && FRAME_HAS_MINIBUF_P (f1))
1626 frame_with_minibuf = this;
1627 if (FRAME_MINIBUF_ONLY_P (f1))
1628 break;
1631 if (kb == FRAME_KBOARD (f1))
1632 frame_on_same_kboard = this;
1635 if (!NILP (frame_on_same_kboard))
1637 /* We know that there must be some frame with a minibuffer out
1638 there. If this were not true, all of the frames present
1639 would have to be minibufferless, which implies that at some
1640 point their minibuffer frames must have been deleted, but
1641 that is prohibited at the top; you can't delete surrogate
1642 minibuffer frames. */
1643 if (NILP (frame_with_minibuf))
1644 abort ();
1646 kb->Vdefault_minibuffer_frame = frame_with_minibuf;
1648 else
1649 /* No frames left on this kboard--say no minibuffer either. */
1650 kb->Vdefault_minibuffer_frame = Qnil;
1653 /* Cause frame titles to update--necessary if we now have just one frame. */
1654 update_mode_lines = 1;
1656 return Qnil;
1659 /* Return mouse position in character cell units. */
1661 DEFUN ("mouse-position", Fmouse_position, Smouse_position, 0, 0, 0,
1662 doc: /* Return a list (FRAME X . Y) giving the current mouse frame and position.
1663 The position is given in character cells, where (0, 0) is the
1664 upper-left corner of the frame, X is the horizontal offset, and Y is
1665 the vertical offset.
1666 If Emacs is running on a mouseless terminal or hasn't been programmed
1667 to read the mouse position, it returns the selected frame for FRAME
1668 and nil for X and Y.
1669 If `mouse-position-function' is non-nil, `mouse-position' calls it,
1670 passing the normal return value to that function as an argument,
1671 and returns whatever that function returns. */)
1674 FRAME_PTR f;
1675 Lisp_Object lispy_dummy;
1676 enum scroll_bar_part party_dummy;
1677 Lisp_Object x, y, retval;
1678 int col, row;
1679 unsigned long long_dummy;
1680 struct gcpro gcpro1;
1682 f = SELECTED_FRAME ();
1683 x = y = Qnil;
1685 #if defined (HAVE_MOUSE) || defined (HAVE_GPM)
1686 /* It's okay for the hook to refrain from storing anything. */
1687 if (FRAME_TERMINAL (f)->mouse_position_hook)
1688 (*FRAME_TERMINAL (f)->mouse_position_hook) (&f, -1,
1689 &lispy_dummy, &party_dummy,
1690 &x, &y,
1691 &long_dummy);
1692 if (! NILP (x))
1694 col = XINT (x);
1695 row = XINT (y);
1696 pixel_to_glyph_coords (f, col, row, &col, &row, NULL, 1);
1697 XSETINT (x, col);
1698 XSETINT (y, row);
1700 #endif
1701 XSETFRAME (lispy_dummy, f);
1702 retval = Fcons (lispy_dummy, Fcons (x, y));
1703 GCPRO1 (retval);
1704 if (!NILP (Vmouse_position_function))
1705 retval = call1 (Vmouse_position_function, retval);
1706 RETURN_UNGCPRO (retval);
1709 DEFUN ("mouse-pixel-position", Fmouse_pixel_position,
1710 Smouse_pixel_position, 0, 0, 0,
1711 doc: /* Return a list (FRAME X . Y) giving the current mouse frame and position.
1712 The position is given in pixel units, where (0, 0) is the
1713 upper-left corner of the frame, X is the horizontal offset, and Y is
1714 the vertical offset.
1715 If Emacs is running on a mouseless terminal or hasn't been programmed
1716 to read the mouse position, it returns the selected frame for FRAME
1717 and nil for X and Y. */)
1720 FRAME_PTR f;
1721 Lisp_Object lispy_dummy;
1722 enum scroll_bar_part party_dummy;
1723 Lisp_Object x, y;
1724 unsigned long long_dummy;
1726 f = SELECTED_FRAME ();
1727 x = y = Qnil;
1729 #if defined (HAVE_MOUSE) || defined (HAVE_GPM)
1730 /* It's okay for the hook to refrain from storing anything. */
1731 if (FRAME_TERMINAL (f)->mouse_position_hook)
1732 (*FRAME_TERMINAL (f)->mouse_position_hook) (&f, -1,
1733 &lispy_dummy, &party_dummy,
1734 &x, &y,
1735 &long_dummy);
1736 #endif
1737 XSETFRAME (lispy_dummy, f);
1738 return Fcons (lispy_dummy, Fcons (x, y));
1741 DEFUN ("set-mouse-position", Fset_mouse_position, Sset_mouse_position, 3, 3, 0,
1742 doc: /* Move the mouse pointer to the center of character cell (X,Y) in FRAME.
1743 Coordinates are relative to the frame, not a window,
1744 so the coordinates of the top left character in the frame
1745 may be nonzero due to left-hand scroll bars or the menu bar.
1747 The position is given in character cells, where (0, 0) is the
1748 upper-left corner of the frame, X is the horizontal offset, and Y is
1749 the vertical offset.
1751 This function is a no-op for an X frame that is not visible.
1752 If you have just created a frame, you must wait for it to become visible
1753 before calling this function on it, like this.
1754 (while (not (frame-visible-p frame)) (sleep-for .5)) */)
1755 (frame, x, y)
1756 Lisp_Object frame, x, y;
1758 CHECK_LIVE_FRAME (frame);
1759 CHECK_NUMBER (x);
1760 CHECK_NUMBER (y);
1762 /* I think this should be done with a hook. */
1763 #ifdef HAVE_WINDOW_SYSTEM
1764 if (FRAME_WINDOW_P (XFRAME (frame)))
1765 /* Warping the mouse will cause enternotify and focus events. */
1766 x_set_mouse_position (XFRAME (frame), XINT (x), XINT (y));
1767 #else
1768 #if defined (MSDOS) && defined (HAVE_MOUSE)
1769 if (FRAME_MSDOS_P (XFRAME (frame)))
1771 Fselect_frame (frame);
1772 mouse_moveto (XINT (x), XINT (y));
1774 #else
1775 #ifdef HAVE_GPM
1777 Fselect_frame (frame);
1778 term_mouse_moveto (XINT (x), XINT (y));
1780 #endif
1781 #endif
1782 #endif
1784 return Qnil;
1787 DEFUN ("set-mouse-pixel-position", Fset_mouse_pixel_position,
1788 Sset_mouse_pixel_position, 3, 3, 0,
1789 doc: /* Move the mouse pointer to pixel position (X,Y) in FRAME.
1790 The position is given in pixels, where (0, 0) is the upper-left corner
1791 of the frame, X is the horizontal offset, and Y is the vertical offset.
1793 Note, this is a no-op for an X frame that is not visible.
1794 If you have just created a frame, you must wait for it to become visible
1795 before calling this function on it, like this.
1796 (while (not (frame-visible-p frame)) (sleep-for .5)) */)
1797 (frame, x, y)
1798 Lisp_Object frame, x, y;
1800 CHECK_LIVE_FRAME (frame);
1801 CHECK_NUMBER (x);
1802 CHECK_NUMBER (y);
1804 /* I think this should be done with a hook. */
1805 #ifdef HAVE_WINDOW_SYSTEM
1806 if (FRAME_WINDOW_P (XFRAME (frame)))
1807 /* Warping the mouse will cause enternotify and focus events. */
1808 x_set_mouse_pixel_position (XFRAME (frame), XINT (x), XINT (y));
1809 #else
1810 #if defined (MSDOS) && defined (HAVE_MOUSE)
1811 if (FRAME_MSDOS_P (XFRAME (frame)))
1813 Fselect_frame (frame);
1814 mouse_moveto (XINT (x), XINT (y));
1816 #else
1817 #ifdef HAVE_GPM
1819 Fselect_frame (frame);
1820 term_mouse_moveto (XINT (x), XINT (y));
1822 #endif
1823 #endif
1824 #endif
1826 return Qnil;
1829 static void make_frame_visible_1 P_ ((Lisp_Object));
1831 DEFUN ("make-frame-visible", Fmake_frame_visible, Smake_frame_visible,
1832 0, 1, "",
1833 doc: /* Make the frame FRAME visible (assuming it is an X window).
1834 If omitted, FRAME defaults to the currently selected frame. */)
1835 (frame)
1836 Lisp_Object frame;
1838 if (NILP (frame))
1839 frame = selected_frame;
1841 CHECK_LIVE_FRAME (frame);
1843 /* I think this should be done with a hook. */
1844 #ifdef HAVE_WINDOW_SYSTEM
1845 if (FRAME_WINDOW_P (XFRAME (frame)))
1847 FRAME_SAMPLE_VISIBILITY (XFRAME (frame));
1848 x_make_frame_visible (XFRAME (frame));
1850 #endif
1852 make_frame_visible_1 (XFRAME (frame)->root_window);
1854 /* Make menu bar update for the Buffers and Frames menus. */
1855 windows_or_buffers_changed++;
1857 return frame;
1860 /* Update the display_time slot of the buffers shown in WINDOW
1861 and all its descendents. */
1863 static void
1864 make_frame_visible_1 (window)
1865 Lisp_Object window;
1867 struct window *w;
1869 for (;!NILP (window); window = w->next)
1871 w = XWINDOW (window);
1873 if (!NILP (w->buffer))
1874 XBUFFER (w->buffer)->display_time = Fcurrent_time ();
1876 if (!NILP (w->vchild))
1877 make_frame_visible_1 (w->vchild);
1878 if (!NILP (w->hchild))
1879 make_frame_visible_1 (w->hchild);
1883 DEFUN ("make-frame-invisible", Fmake_frame_invisible, Smake_frame_invisible,
1884 0, 2, "",
1885 doc: /* Make the frame FRAME invisible (assuming it is an X window).
1886 If omitted, FRAME defaults to the currently selected frame.
1887 Normally you may not make FRAME invisible if all other frames are invisible,
1888 but if the second optional argument FORCE is non-nil, you may do so. */)
1889 (frame, force)
1890 Lisp_Object frame, force;
1892 if (NILP (frame))
1893 frame = selected_frame;
1895 CHECK_LIVE_FRAME (frame);
1897 if (NILP (force) && !other_visible_frames (XFRAME (frame)))
1898 error ("Attempt to make invisible the sole visible or iconified frame");
1900 #if 0 /* This isn't logically necessary, and it can do GC. */
1901 /* Don't let the frame remain selected. */
1902 if (EQ (frame, selected_frame))
1903 do_switch_frame (next_frame (frame, Qt), 0, 0)
1904 #endif
1906 /* Don't allow minibuf_window to remain on a deleted frame. */
1907 if (EQ (XFRAME (frame)->minibuffer_window, minibuf_window))
1909 struct frame *sf = XFRAME (selected_frame);
1910 Fset_window_buffer (sf->minibuffer_window,
1911 XWINDOW (minibuf_window)->buffer, Qnil);
1912 minibuf_window = sf->minibuffer_window;
1915 /* I think this should be done with a hook. */
1916 #ifdef HAVE_WINDOW_SYSTEM
1917 if (FRAME_WINDOW_P (XFRAME (frame)))
1918 x_make_frame_invisible (XFRAME (frame));
1919 #endif
1921 /* Make menu bar update for the Buffers and Frames menus. */
1922 windows_or_buffers_changed++;
1924 return Qnil;
1927 DEFUN ("iconify-frame", Ficonify_frame, Siconify_frame,
1928 0, 1, "",
1929 doc: /* Make the frame FRAME into an icon.
1930 If omitted, FRAME defaults to the currently selected frame. */)
1931 (frame)
1932 Lisp_Object frame;
1934 if (NILP (frame))
1935 frame = selected_frame;
1937 CHECK_LIVE_FRAME (frame);
1939 #if 0 /* This isn't logically necessary, and it can do GC. */
1940 /* Don't let the frame remain selected. */
1941 if (EQ (frame, selected_frame))
1942 Fhandle_switch_frame (next_frame (frame, Qt));
1943 #endif
1945 /* Don't allow minibuf_window to remain on a deleted frame. */
1946 if (EQ (XFRAME (frame)->minibuffer_window, minibuf_window))
1948 struct frame *sf = XFRAME (selected_frame);
1949 Fset_window_buffer (sf->minibuffer_window,
1950 XWINDOW (minibuf_window)->buffer, Qnil);
1951 minibuf_window = sf->minibuffer_window;
1954 /* I think this should be done with a hook. */
1955 #ifdef HAVE_WINDOW_SYSTEM
1956 if (FRAME_WINDOW_P (XFRAME (frame)))
1957 x_iconify_frame (XFRAME (frame));
1958 #endif
1960 /* Make menu bar update for the Buffers and Frames menus. */
1961 windows_or_buffers_changed++;
1963 return Qnil;
1966 DEFUN ("frame-visible-p", Fframe_visible_p, Sframe_visible_p,
1967 1, 1, 0,
1968 doc: /* Return t if FRAME is now \"visible\" (actually in use for display).
1969 A frame that is not \"visible\" is not updated and, if it works through
1970 a window system, it may not show at all.
1971 Return the symbol `icon' if frame is visible only as an icon.
1973 On a text-only terminal, all frames are considered visible, whether
1974 they are currently being displayed or not, and this function returns t
1975 for all frames. */)
1976 (frame)
1977 Lisp_Object frame;
1979 CHECK_LIVE_FRAME (frame);
1981 FRAME_SAMPLE_VISIBILITY (XFRAME (frame));
1983 if (FRAME_VISIBLE_P (XFRAME (frame)))
1984 return Qt;
1985 if (FRAME_ICONIFIED_P (XFRAME (frame)))
1986 return Qicon;
1987 return Qnil;
1990 DEFUN ("visible-frame-list", Fvisible_frame_list, Svisible_frame_list,
1991 0, 0, 0,
1992 doc: /* Return a list of all frames now \"visible\" (being updated). */)
1995 Lisp_Object tail, frame;
1996 struct frame *f;
1997 Lisp_Object value;
1999 value = Qnil;
2000 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
2002 frame = XCAR (tail);
2003 if (!FRAMEP (frame))
2004 continue;
2005 f = XFRAME (frame);
2006 if (FRAME_VISIBLE_P (f))
2007 value = Fcons (frame, value);
2009 return value;
2013 DEFUN ("raise-frame", Fraise_frame, Sraise_frame, 0, 1, "",
2014 doc: /* Bring FRAME to the front, so it occludes any frames it overlaps.
2015 If FRAME is invisible or iconified, make it visible.
2016 If you don't specify a frame, the selected frame is used.
2017 If Emacs is displaying on an ordinary terminal or some other device which
2018 doesn't support multiple overlapping frames, this function does nothing. */)
2019 (frame)
2020 Lisp_Object frame;
2022 struct frame *f;
2023 if (NILP (frame))
2024 frame = selected_frame;
2026 CHECK_LIVE_FRAME (frame);
2028 f = XFRAME (frame);
2030 /* Do like the documentation says. */
2031 Fmake_frame_visible (frame);
2033 if (FRAME_TERMINAL (f)->frame_raise_lower_hook)
2034 (*FRAME_TERMINAL (f)->frame_raise_lower_hook) (f, 1);
2036 return Qnil;
2039 /* Should we have a corresponding function called Flower_Power? */
2040 DEFUN ("lower-frame", Flower_frame, Slower_frame, 0, 1, "",
2041 doc: /* Send FRAME to the back, so it is occluded by any frames that overlap it.
2042 If you don't specify a frame, the selected frame is used.
2043 If Emacs is displaying on an ordinary terminal or some other device which
2044 doesn't support multiple overlapping frames, this function does nothing. */)
2045 (frame)
2046 Lisp_Object frame;
2048 struct frame *f;
2050 if (NILP (frame))
2051 frame = selected_frame;
2053 CHECK_LIVE_FRAME (frame);
2055 f = XFRAME (frame);
2057 if (FRAME_TERMINAL (f)->frame_raise_lower_hook)
2058 (*FRAME_TERMINAL (f)->frame_raise_lower_hook) (f, 0);
2060 return Qnil;
2064 DEFUN ("redirect-frame-focus", Fredirect_frame_focus, Sredirect_frame_focus,
2065 1, 2, 0,
2066 doc: /* Arrange for keystrokes typed at FRAME to be sent to FOCUS-FRAME.
2067 In other words, switch-frame events caused by events in FRAME will
2068 request a switch to FOCUS-FRAME, and `last-event-frame' will be
2069 FOCUS-FRAME after reading an event typed at FRAME.
2071 If FOCUS-FRAME is omitted or nil, any existing redirection is
2072 cancelled, and the frame again receives its own keystrokes.
2074 Focus redirection is useful for temporarily redirecting keystrokes to
2075 a surrogate minibuffer frame when a frame doesn't have its own
2076 minibuffer window.
2078 A frame's focus redirection can be changed by `select-frame'. If frame
2079 FOO is selected, and then a different frame BAR is selected, any
2080 frames redirecting their focus to FOO are shifted to redirect their
2081 focus to BAR. This allows focus redirection to work properly when the
2082 user switches from one frame to another using `select-window'.
2084 This means that a frame whose focus is redirected to itself is treated
2085 differently from a frame whose focus is redirected to nil; the former
2086 is affected by `select-frame', while the latter is not.
2088 The redirection lasts until `redirect-frame-focus' is called to change it. */)
2089 (frame, focus_frame)
2090 Lisp_Object frame, focus_frame;
2092 struct frame *f;
2094 /* Note that we don't check for a live frame here. It's reasonable
2095 to redirect the focus of a frame you're about to delete, if you
2096 know what other frame should receive those keystrokes. */
2097 CHECK_FRAME (frame);
2099 if (! NILP (focus_frame))
2100 CHECK_LIVE_FRAME (focus_frame);
2102 f = XFRAME (frame);
2104 f->focus_frame = focus_frame;
2106 if (FRAME_TERMINAL (f)->frame_rehighlight_hook)
2107 (*FRAME_TERMINAL (f)->frame_rehighlight_hook) (f);
2109 return Qnil;
2113 DEFUN ("frame-focus", Fframe_focus, Sframe_focus, 1, 1, 0,
2114 doc: /* Return the frame to which FRAME's keystrokes are currently being sent.
2115 This returns nil if FRAME's focus is not redirected.
2116 See `redirect-frame-focus'. */)
2117 (frame)
2118 Lisp_Object frame;
2120 CHECK_LIVE_FRAME (frame);
2122 return FRAME_FOCUS_FRAME (XFRAME (frame));
2127 /* Return the value of frame parameter PROP in frame FRAME. */
2129 Lisp_Object
2130 get_frame_param (frame, prop)
2131 register struct frame *frame;
2132 Lisp_Object prop;
2134 register Lisp_Object tem;
2136 tem = Fassq (prop, frame->param_alist);
2137 if (EQ (tem, Qnil))
2138 return tem;
2139 return Fcdr (tem);
2142 /* Return the buffer-predicate of the selected frame. */
2144 Lisp_Object
2145 frame_buffer_predicate (frame)
2146 Lisp_Object frame;
2148 return XFRAME (frame)->buffer_predicate;
2151 /* Return the buffer-list of the selected frame. */
2153 Lisp_Object
2154 frame_buffer_list (frame)
2155 Lisp_Object frame;
2157 return XFRAME (frame)->buffer_list;
2160 /* Set the buffer-list of the selected frame. */
2162 void
2163 set_frame_buffer_list (frame, list)
2164 Lisp_Object frame, list;
2166 XFRAME (frame)->buffer_list = list;
2169 /* Discard BUFFER from the buffer-list and buried-buffer-list of each frame. */
2171 void
2172 frames_discard_buffer (buffer)
2173 Lisp_Object buffer;
2175 Lisp_Object frame, tail;
2177 FOR_EACH_FRAME (tail, frame)
2179 XFRAME (frame)->buffer_list
2180 = Fdelq (buffer, XFRAME (frame)->buffer_list);
2181 XFRAME (frame)->buried_buffer_list
2182 = Fdelq (buffer, XFRAME (frame)->buried_buffer_list);
2186 /* Modify the alist in *ALISTPTR to associate PROP with VAL.
2187 If the alist already has an element for PROP, we change it. */
2189 void
2190 store_in_alist (alistptr, prop, val)
2191 Lisp_Object *alistptr, val;
2192 Lisp_Object prop;
2194 register Lisp_Object tem;
2196 tem = Fassq (prop, *alistptr);
2197 if (EQ (tem, Qnil))
2198 *alistptr = Fcons (Fcons (prop, val), *alistptr);
2199 else
2200 Fsetcdr (tem, val);
2203 static int
2204 frame_name_fnn_p (str, len)
2205 char *str;
2206 int len;
2208 if (len > 1 && str[0] == 'F')
2210 char *end_ptr;
2212 strtol (str + 1, &end_ptr, 10);
2214 if (end_ptr == str + len)
2215 return 1;
2217 return 0;
2220 /* Set the name of the terminal frame. Also used by MSDOS frames.
2221 Modeled after x_set_name which is used for WINDOW frames. */
2223 static void
2224 set_term_frame_name (f, name)
2225 struct frame *f;
2226 Lisp_Object name;
2228 f->explicit_name = ! NILP (name);
2230 /* If NAME is nil, set the name to F<num>. */
2231 if (NILP (name))
2233 char namebuf[20];
2235 /* Check for no change needed in this very common case
2236 before we do any consing. */
2237 if (frame_name_fnn_p (SDATA (f->name),
2238 SBYTES (f->name)))
2239 return;
2241 tty_frame_count++;
2242 sprintf (namebuf, "F%d", tty_frame_count);
2243 name = build_string (namebuf);
2245 else
2247 CHECK_STRING (name);
2249 /* Don't change the name if it's already NAME. */
2250 if (! NILP (Fstring_equal (name, f->name)))
2251 return;
2253 /* Don't allow the user to set the frame name to F<num>, so it
2254 doesn't clash with the names we generate for terminal frames. */
2255 if (frame_name_fnn_p (SDATA (name), SBYTES (name)))
2256 error ("Frame names of the form F<num> are usurped by Emacs");
2259 f->name = name;
2260 update_mode_lines = 1;
2263 void
2264 store_frame_param (f, prop, val)
2265 struct frame *f;
2266 Lisp_Object prop, val;
2268 register Lisp_Object old_alist_elt;
2270 /* The buffer-list parameters are stored in a special place and not
2271 in the alist. */
2272 if (EQ (prop, Qbuffer_list))
2274 f->buffer_list = val;
2275 return;
2277 if (EQ (prop, Qburied_buffer_list))
2279 f->buried_buffer_list = val;
2280 return;
2283 /* If PROP is a symbol which is supposed to have frame-local values,
2284 and it is set up based on this frame, switch to the global
2285 binding. That way, we can create or alter the frame-local binding
2286 without messing up the symbol's status. */
2287 if (SYMBOLP (prop))
2289 Lisp_Object valcontents;
2290 valcontents = SYMBOL_VALUE (prop);
2291 if ((BUFFER_LOCAL_VALUEP (valcontents))
2292 && XBUFFER_LOCAL_VALUE (valcontents)->check_frame
2293 && XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame
2294 && XFRAME (XBUFFER_LOCAL_VALUE (valcontents)->frame) == f)
2295 swap_in_global_binding (prop);
2298 #ifndef WINDOWSNT
2299 /* The tty color mode needs to be set before the frame's parameter
2300 alist is updated with the new value, because set_tty_color_mode
2301 wants to look at the old mode. */
2302 if (FRAME_TERMCAP_P (f) && EQ (prop, Qtty_color_mode))
2303 set_tty_color_mode (f, val);
2304 #endif
2306 /* Update the frame parameter alist. */
2307 old_alist_elt = Fassq (prop, f->param_alist);
2308 if (EQ (old_alist_elt, Qnil))
2309 f->param_alist = Fcons (Fcons (prop, val), f->param_alist);
2310 else
2311 Fsetcdr (old_alist_elt, val);
2313 /* Update some other special parameters in their special places
2314 in addition to the alist. */
2316 if (EQ (prop, Qbuffer_predicate))
2317 f->buffer_predicate = val;
2319 if (! FRAME_WINDOW_P (f))
2321 if (EQ (prop, Qmenu_bar_lines))
2322 set_menu_bar_lines (f, val, make_number (FRAME_MENU_BAR_LINES (f)));
2323 else if (EQ (prop, Qname))
2324 set_term_frame_name (f, val);
2327 if (EQ (prop, Qminibuffer) && WINDOWP (val))
2329 if (! MINI_WINDOW_P (XWINDOW (val)))
2330 error ("Surrogate minibuffer windows must be minibuffer windows");
2332 if ((FRAME_HAS_MINIBUF_P (f) || FRAME_MINIBUF_ONLY_P (f))
2333 && !EQ (val, f->minibuffer_window))
2334 error ("Can't change the surrogate minibuffer of a frame with its own minibuffer");
2336 /* Install the chosen minibuffer window, with proper buffer. */
2337 f->minibuffer_window = val;
2341 DEFUN ("frame-parameters", Fframe_parameters, Sframe_parameters, 0, 1, 0,
2342 doc: /* Return the parameters-alist of frame FRAME.
2343 It is a list of elements of the form (PARM . VALUE), where PARM is a symbol.
2344 The meaningful PARMs depend on the kind of frame.
2345 If FRAME is omitted, return information on the currently selected frame. */)
2346 (frame)
2347 Lisp_Object frame;
2349 Lisp_Object alist;
2350 FRAME_PTR f;
2351 int height, width;
2352 struct gcpro gcpro1;
2354 if (NILP (frame))
2355 frame = selected_frame;
2357 CHECK_FRAME (frame);
2358 f = XFRAME (frame);
2360 if (!FRAME_LIVE_P (f))
2361 return Qnil;
2363 alist = Fcopy_alist (f->param_alist);
2364 GCPRO1 (alist);
2366 if (!FRAME_WINDOW_P (f))
2368 int fg = FRAME_FOREGROUND_PIXEL (f);
2369 int bg = FRAME_BACKGROUND_PIXEL (f);
2370 Lisp_Object elt;
2372 /* If the frame's parameter alist says the colors are
2373 unspecified and reversed, take the frame's background pixel
2374 for foreground and vice versa. */
2375 elt = Fassq (Qforeground_color, alist);
2376 if (CONSP (elt) && STRINGP (XCDR (elt)))
2378 if (strncmp (SDATA (XCDR (elt)),
2379 unspecified_bg,
2380 SCHARS (XCDR (elt))) == 0)
2381 store_in_alist (&alist, Qforeground_color, tty_color_name (f, bg));
2382 else if (strncmp (SDATA (XCDR (elt)),
2383 unspecified_fg,
2384 SCHARS (XCDR (elt))) == 0)
2385 store_in_alist (&alist, Qforeground_color, tty_color_name (f, fg));
2387 else
2388 store_in_alist (&alist, Qforeground_color, tty_color_name (f, fg));
2389 elt = Fassq (Qbackground_color, alist);
2390 if (CONSP (elt) && STRINGP (XCDR (elt)))
2392 if (strncmp (SDATA (XCDR (elt)),
2393 unspecified_fg,
2394 SCHARS (XCDR (elt))) == 0)
2395 store_in_alist (&alist, Qbackground_color, tty_color_name (f, fg));
2396 else if (strncmp (SDATA (XCDR (elt)),
2397 unspecified_bg,
2398 SCHARS (XCDR (elt))) == 0)
2399 store_in_alist (&alist, Qbackground_color, tty_color_name (f, bg));
2401 else
2402 store_in_alist (&alist, Qbackground_color, tty_color_name (f, bg));
2403 store_in_alist (&alist, intern ("font"),
2404 build_string (FRAME_MSDOS_P (f)
2405 ? "ms-dos"
2406 : FRAME_W32_P (f) ? "w32term"
2407 :"tty"));
2409 store_in_alist (&alist, Qname, f->name);
2410 height = (f->new_text_lines ? f->new_text_lines : FRAME_LINES (f));
2411 store_in_alist (&alist, Qheight, make_number (height));
2412 width = (f->new_text_cols ? f->new_text_cols : FRAME_COLS (f));
2413 store_in_alist (&alist, Qwidth, make_number (width));
2414 store_in_alist (&alist, Qmodeline, (FRAME_WANTS_MODELINE_P (f) ? Qt : Qnil));
2415 store_in_alist (&alist, Qminibuffer,
2416 (! FRAME_HAS_MINIBUF_P (f) ? Qnil
2417 : FRAME_MINIBUF_ONLY_P (f) ? Qonly
2418 : FRAME_MINIBUF_WINDOW (f)));
2419 store_in_alist (&alist, Qunsplittable, (FRAME_NO_SPLIT_P (f) ? Qt : Qnil));
2420 store_in_alist (&alist, Qbuffer_list, frame_buffer_list (frame));
2421 store_in_alist (&alist, Qburied_buffer_list, XFRAME (frame)->buried_buffer_list);
2423 /* I think this should be done with a hook. */
2424 #ifdef HAVE_WINDOW_SYSTEM
2425 if (FRAME_WINDOW_P (f))
2426 x_report_frame_params (f, &alist);
2427 else
2428 #endif
2430 /* This ought to be correct in f->param_alist for an X frame. */
2431 Lisp_Object lines;
2432 XSETFASTINT (lines, FRAME_MENU_BAR_LINES (f));
2433 store_in_alist (&alist, Qmenu_bar_lines, lines);
2436 UNGCPRO;
2437 return alist;
2441 DEFUN ("frame-parameter", Fframe_parameter, Sframe_parameter, 2, 2, 0,
2442 doc: /* Return FRAME's value for parameter PARAMETER.
2443 If FRAME is nil, describe the currently selected frame. */)
2444 (frame, parameter)
2445 Lisp_Object frame, parameter;
2447 struct frame *f;
2448 Lisp_Object value;
2450 if (NILP (frame))
2451 frame = selected_frame;
2452 else
2453 CHECK_FRAME (frame);
2454 CHECK_SYMBOL (parameter);
2456 f = XFRAME (frame);
2457 value = Qnil;
2459 if (FRAME_LIVE_P (f))
2461 /* Avoid consing in frequent cases. */
2462 if (EQ (parameter, Qname))
2463 value = f->name;
2464 #ifdef HAVE_X_WINDOWS
2465 else if (EQ (parameter, Qdisplay) && FRAME_X_P (f))
2466 value = XCAR (FRAME_X_DISPLAY_INFO (f)->name_list_element);
2467 #endif /* HAVE_X_WINDOWS */
2468 else if (EQ (parameter, Qbackground_color)
2469 || EQ (parameter, Qforeground_color))
2471 value = Fassq (parameter, f->param_alist);
2472 if (CONSP (value))
2474 value = XCDR (value);
2475 /* Fframe_parameters puts the actual fg/bg color names,
2476 even if f->param_alist says otherwise. This is
2477 important when param_alist's notion of colors is
2478 "unspecified". We need to do the same here. */
2479 if (STRINGP (value) && !FRAME_WINDOW_P (f))
2481 const char *color_name;
2482 EMACS_INT csz;
2484 if (EQ (parameter, Qbackground_color))
2486 color_name = SDATA (value);
2487 csz = SCHARS (value);
2488 if (strncmp (color_name, unspecified_bg, csz) == 0)
2489 value = tty_color_name (f, FRAME_BACKGROUND_PIXEL (f));
2490 else if (strncmp (color_name, unspecified_fg, csz) == 0)
2491 value = tty_color_name (f, FRAME_FOREGROUND_PIXEL (f));
2493 else if (EQ (parameter, Qforeground_color))
2495 color_name = SDATA (value);
2496 csz = SCHARS (value);
2497 if (strncmp (color_name, unspecified_fg, csz) == 0)
2498 value = tty_color_name (f, FRAME_FOREGROUND_PIXEL (f));
2499 else if (strncmp (color_name, unspecified_bg, csz) == 0)
2500 value = tty_color_name (f, FRAME_BACKGROUND_PIXEL (f));
2504 else
2505 value = Fcdr (Fassq (parameter, Fframe_parameters (frame)));
2507 else if (EQ (parameter, Qdisplay_type)
2508 || EQ (parameter, Qbackground_mode))
2509 value = Fcdr (Fassq (parameter, f->param_alist));
2510 else
2511 value = Fcdr (Fassq (parameter, Fframe_parameters (frame)));
2514 return value;
2518 DEFUN ("modify-frame-parameters", Fmodify_frame_parameters,
2519 Smodify_frame_parameters, 2, 2, 0,
2520 doc: /* Modify the parameters of frame FRAME according to ALIST.
2521 If FRAME is nil, it defaults to the selected frame.
2522 ALIST is an alist of parameters to change and their new values.
2523 Each element of ALIST has the form (PARM . VALUE), where PARM is a symbol.
2524 The meaningful PARMs depend on the kind of frame.
2525 Undefined PARMs are ignored, but stored in the frame's parameter list
2526 so that `frame-parameters' will return them.
2528 The value of frame parameter FOO can also be accessed
2529 as a frame-local binding for the variable FOO, if you have
2530 enabled such bindings for that variable with `make-variable-frame-local'. */)
2531 (frame, alist)
2532 Lisp_Object frame, alist;
2534 FRAME_PTR f;
2535 register Lisp_Object tail, prop, val;
2537 if (EQ (frame, Qnil))
2538 frame = selected_frame;
2539 CHECK_LIVE_FRAME (frame);
2540 f = XFRAME (frame);
2542 /* I think this should be done with a hook. */
2543 #ifdef HAVE_WINDOW_SYSTEM
2544 if (FRAME_WINDOW_P (f))
2545 x_set_frame_parameters (f, alist);
2546 else
2547 #endif
2548 #ifdef MSDOS
2549 if (FRAME_MSDOS_P (f))
2550 IT_set_frame_parameters (f, alist);
2551 else
2552 #endif
2555 int length = XINT (Flength (alist));
2556 int i;
2557 Lisp_Object *parms
2558 = (Lisp_Object *) alloca (length * sizeof (Lisp_Object));
2559 Lisp_Object *values
2560 = (Lisp_Object *) alloca (length * sizeof (Lisp_Object));
2562 /* Extract parm names and values into those vectors. */
2564 i = 0;
2565 for (tail = alist; CONSP (tail); tail = Fcdr (tail))
2567 Lisp_Object elt;
2569 elt = Fcar (tail);
2570 parms[i] = Fcar (elt);
2571 values[i] = Fcdr (elt);
2572 i++;
2575 /* Now process them in reverse of specified order. */
2576 for (i--; i >= 0; i--)
2578 prop = parms[i];
2579 val = values[i];
2580 store_frame_param (f, prop, val);
2582 /* Changing the background color might change the background
2583 mode, so that we have to load new defface specs.
2584 Call frame-set-background-mode to do that. */
2585 if (EQ (prop, Qbackground_color))
2586 call1 (Qframe_set_background_mode, frame);
2589 return Qnil;
2592 DEFUN ("frame-char-height", Fframe_char_height, Sframe_char_height,
2593 0, 1, 0,
2594 doc: /* Height in pixels of a line in the font in frame FRAME.
2595 If FRAME is omitted, the selected frame is used.
2596 For a terminal frame, the value is always 1. */)
2597 (frame)
2598 Lisp_Object frame;
2600 struct frame *f;
2602 if (NILP (frame))
2603 frame = selected_frame;
2604 CHECK_FRAME (frame);
2605 f = XFRAME (frame);
2607 #ifdef HAVE_WINDOW_SYSTEM
2608 if (FRAME_WINDOW_P (f))
2609 return make_number (x_char_height (f));
2610 else
2611 #endif
2612 return make_number (1);
2616 DEFUN ("frame-char-width", Fframe_char_width, Sframe_char_width,
2617 0, 1, 0,
2618 doc: /* Width in pixels of characters in the font in frame FRAME.
2619 If FRAME is omitted, the selected frame is used.
2620 On a graphical screen, the width is the standard width of the default font.
2621 For a terminal screen, the value is always 1. */)
2622 (frame)
2623 Lisp_Object frame;
2625 struct frame *f;
2627 if (NILP (frame))
2628 frame = selected_frame;
2629 CHECK_FRAME (frame);
2630 f = XFRAME (frame);
2632 #ifdef HAVE_WINDOW_SYSTEM
2633 if (FRAME_WINDOW_P (f))
2634 return make_number (x_char_width (f));
2635 else
2636 #endif
2637 return make_number (1);
2640 DEFUN ("frame-pixel-height", Fframe_pixel_height,
2641 Sframe_pixel_height, 0, 1, 0,
2642 doc: /* Return a FRAME's height in pixels.
2643 This counts only the height available for text lines,
2644 not menu bars on window-system Emacs frames.
2645 For a terminal frame, the result really gives the height in characters.
2646 If FRAME is omitted, the selected frame is used. */)
2647 (frame)
2648 Lisp_Object frame;
2650 struct frame *f;
2652 if (NILP (frame))
2653 frame = selected_frame;
2654 CHECK_FRAME (frame);
2655 f = XFRAME (frame);
2657 #ifdef HAVE_WINDOW_SYSTEM
2658 if (FRAME_WINDOW_P (f))
2659 return make_number (x_pixel_height (f));
2660 else
2661 #endif
2662 return make_number (FRAME_LINES (f));
2665 DEFUN ("frame-pixel-width", Fframe_pixel_width,
2666 Sframe_pixel_width, 0, 1, 0,
2667 doc: /* Return FRAME's width in pixels.
2668 For a terminal frame, the result really gives the width in characters.
2669 If FRAME is omitted, the selected frame is used. */)
2670 (frame)
2671 Lisp_Object frame;
2673 struct frame *f;
2675 if (NILP (frame))
2676 frame = selected_frame;
2677 CHECK_FRAME (frame);
2678 f = XFRAME (frame);
2680 #ifdef HAVE_WINDOW_SYSTEM
2681 if (FRAME_WINDOW_P (f))
2682 return make_number (x_pixel_width (f));
2683 else
2684 #endif
2685 return make_number (FRAME_COLS (f));
2688 DEFUN ("set-frame-height", Fset_frame_height, Sset_frame_height, 2, 3, 0,
2689 doc: /* Specify that the frame FRAME has LINES lines.
2690 Optional third arg non-nil means that redisplay should use LINES lines
2691 but that the idea of the actual height of the frame should not be changed. */)
2692 (frame, lines, pretend)
2693 Lisp_Object frame, lines, pretend;
2695 register struct frame *f;
2697 CHECK_NUMBER (lines);
2698 if (NILP (frame))
2699 frame = selected_frame;
2700 CHECK_LIVE_FRAME (frame);
2701 f = XFRAME (frame);
2703 /* I think this should be done with a hook. */
2704 #ifdef HAVE_WINDOW_SYSTEM
2705 if (FRAME_WINDOW_P (f))
2707 if (XINT (lines) != FRAME_LINES (f))
2708 x_set_window_size (f, 1, FRAME_COLS (f), XINT (lines));
2709 do_pending_window_change (0);
2711 else
2712 #endif
2713 change_frame_size (f, XINT (lines), 0, !NILP (pretend), 0, 0);
2714 return Qnil;
2717 DEFUN ("set-frame-width", Fset_frame_width, Sset_frame_width, 2, 3, 0,
2718 doc: /* Specify that the frame FRAME has COLS columns.
2719 Optional third arg non-nil means that redisplay should use COLS columns
2720 but that the idea of the actual width of the frame should not be changed. */)
2721 (frame, cols, pretend)
2722 Lisp_Object frame, cols, pretend;
2724 register struct frame *f;
2725 CHECK_NUMBER (cols);
2726 if (NILP (frame))
2727 frame = selected_frame;
2728 CHECK_LIVE_FRAME (frame);
2729 f = XFRAME (frame);
2731 /* I think this should be done with a hook. */
2732 #ifdef HAVE_WINDOW_SYSTEM
2733 if (FRAME_WINDOW_P (f))
2735 if (XINT (cols) != FRAME_COLS (f))
2736 x_set_window_size (f, 1, XINT (cols), FRAME_LINES (f));
2737 do_pending_window_change (0);
2739 else
2740 #endif
2741 change_frame_size (f, 0, XINT (cols), !NILP (pretend), 0, 0);
2742 return Qnil;
2745 DEFUN ("set-frame-size", Fset_frame_size, Sset_frame_size, 3, 3, 0,
2746 doc: /* Sets size of FRAME to COLS by ROWS, measured in characters. */)
2747 (frame, cols, rows)
2748 Lisp_Object frame, cols, rows;
2750 register struct frame *f;
2752 CHECK_LIVE_FRAME (frame);
2753 CHECK_NUMBER (cols);
2754 CHECK_NUMBER (rows);
2755 f = XFRAME (frame);
2757 /* I think this should be done with a hook. */
2758 #ifdef HAVE_WINDOW_SYSTEM
2759 if (FRAME_WINDOW_P (f))
2761 if (XINT (rows) != FRAME_LINES (f)
2762 || XINT (cols) != FRAME_COLS (f)
2763 || f->new_text_lines || f->new_text_cols)
2764 x_set_window_size (f, 1, XINT (cols), XINT (rows));
2765 do_pending_window_change (0);
2767 else
2768 #endif
2769 change_frame_size (f, XINT (rows), XINT (cols), 0, 0, 0);
2771 return Qnil;
2774 DEFUN ("set-frame-position", Fset_frame_position,
2775 Sset_frame_position, 3, 3, 0,
2776 doc: /* Sets position of FRAME in pixels to XOFFSET by YOFFSET.
2777 This is actually the position of the upper left corner of the frame.
2778 Negative values for XOFFSET or YOFFSET are interpreted relative to
2779 the rightmost or bottommost possible position (that stays within the screen). */)
2780 (frame, xoffset, yoffset)
2781 Lisp_Object frame, xoffset, yoffset;
2783 register struct frame *f;
2785 CHECK_LIVE_FRAME (frame);
2786 CHECK_NUMBER (xoffset);
2787 CHECK_NUMBER (yoffset);
2788 f = XFRAME (frame);
2790 /* I think this should be done with a hook. */
2791 #ifdef HAVE_WINDOW_SYSTEM
2792 if (FRAME_WINDOW_P (f))
2793 x_set_offset (f, XINT (xoffset), XINT (yoffset), 1);
2794 #endif
2796 return Qt;
2800 /***********************************************************************
2801 Frame Parameters
2802 ***********************************************************************/
2804 /* Connect the frame-parameter names for X frames
2805 to the ways of passing the parameter values to the window system.
2807 The name of a parameter, as a Lisp symbol,
2808 has an `x-frame-parameter' property which is an integer in Lisp
2809 that is an index in this table. */
2811 struct frame_parm_table {
2812 char *name;
2813 Lisp_Object *variable;
2816 static struct frame_parm_table frame_parms[] =
2818 {"auto-raise", &Qauto_raise},
2819 {"auto-lower", &Qauto_lower},
2820 {"background-color", 0},
2821 {"border-color", &Qborder_color},
2822 {"border-width", &Qborder_width},
2823 {"cursor-color", &Qcursor_color},
2824 {"cursor-type", &Qcursor_type},
2825 {"font", 0},
2826 {"foreground-color", 0},
2827 {"icon-name", &Qicon_name},
2828 {"icon-type", &Qicon_type},
2829 {"internal-border-width", &Qinternal_border_width},
2830 {"menu-bar-lines", &Qmenu_bar_lines},
2831 {"mouse-color", &Qmouse_color},
2832 {"name", &Qname},
2833 {"scroll-bar-width", &Qscroll_bar_width},
2834 {"title", &Qtitle},
2835 {"unsplittable", &Qunsplittable},
2836 {"vertical-scroll-bars", &Qvertical_scroll_bars},
2837 {"visibility", &Qvisibility},
2838 {"tool-bar-lines", &Qtool_bar_lines},
2839 {"scroll-bar-foreground", &Qscroll_bar_foreground},
2840 {"scroll-bar-background", &Qscroll_bar_background},
2841 {"screen-gamma", &Qscreen_gamma},
2842 {"line-spacing", &Qline_spacing},
2843 {"left-fringe", &Qleft_fringe},
2844 {"right-fringe", &Qright_fringe},
2845 {"wait-for-wm", &Qwait_for_wm},
2846 {"fullscreen", &Qfullscreen},
2849 #ifdef HAVE_WINDOW_SYSTEM
2851 extern Lisp_Object Qbox;
2852 extern Lisp_Object Qtop;
2854 /* Calculate fullscreen size. Return in *TOP_POS and *LEFT_POS the
2855 wanted positions of the WM window (not Emacs window).
2856 Return in *WIDTH and *HEIGHT the wanted width and height of Emacs
2857 window (FRAME_X_WINDOW).
2860 void
2861 x_fullscreen_adjust (f, width, height, top_pos, left_pos)
2862 struct frame *f;
2863 int *width;
2864 int *height;
2865 int *top_pos;
2866 int *left_pos;
2868 int newwidth = FRAME_COLS (f);
2869 int newheight = FRAME_LINES (f);
2871 *top_pos = f->top_pos;
2872 *left_pos = f->left_pos;
2874 if (f->want_fullscreen & FULLSCREEN_HEIGHT)
2876 int ph;
2878 ph = FRAME_X_DISPLAY_INFO (f)->height;
2879 newheight = FRAME_PIXEL_HEIGHT_TO_TEXT_LINES (f, ph);
2880 ph = FRAME_TEXT_LINES_TO_PIXEL_HEIGHT (f, newheight) - f->y_pixels_diff;
2881 newheight = FRAME_PIXEL_HEIGHT_TO_TEXT_LINES (f, ph);
2882 *top_pos = 0;
2885 if (f->want_fullscreen & FULLSCREEN_WIDTH)
2887 int pw;
2889 pw = FRAME_X_DISPLAY_INFO (f)->width;
2890 newwidth = FRAME_PIXEL_WIDTH_TO_TEXT_COLS (f, pw);
2891 pw = FRAME_TEXT_COLS_TO_PIXEL_WIDTH (f, newwidth) - f->x_pixels_diff;
2892 newwidth = FRAME_PIXEL_WIDTH_TO_TEXT_COLS (f, pw);
2893 *left_pos = 0;
2896 *width = newwidth;
2897 *height = newheight;
2901 /* Change the parameters of frame F as specified by ALIST.
2902 If a parameter is not specially recognized, do nothing special;
2903 otherwise call the `x_set_...' function for that parameter.
2904 Except for certain geometry properties, always call store_frame_param
2905 to store the new value in the parameter alist. */
2907 void
2908 x_set_frame_parameters (f, alist)
2909 FRAME_PTR f;
2910 Lisp_Object alist;
2912 Lisp_Object tail;
2914 /* If both of these parameters are present, it's more efficient to
2915 set them both at once. So we wait until we've looked at the
2916 entire list before we set them. */
2917 int width, height;
2919 /* Same here. */
2920 Lisp_Object left, top;
2922 /* Same with these. */
2923 Lisp_Object icon_left, icon_top;
2925 /* Record in these vectors all the parms specified. */
2926 Lisp_Object *parms;
2927 Lisp_Object *values;
2928 int i, p;
2929 int left_no_change = 0, top_no_change = 0;
2930 int icon_left_no_change = 0, icon_top_no_change = 0;
2931 int fullscreen_is_being_set = 0;
2933 struct gcpro gcpro1, gcpro2;
2935 i = 0;
2936 for (tail = alist; CONSP (tail); tail = Fcdr (tail))
2937 i++;
2939 parms = (Lisp_Object *) alloca (i * sizeof (Lisp_Object));
2940 values = (Lisp_Object *) alloca (i * sizeof (Lisp_Object));
2942 /* Extract parm names and values into those vectors. */
2944 i = 0;
2945 for (tail = alist; CONSP (tail); tail = Fcdr (tail))
2947 Lisp_Object elt;
2949 elt = Fcar (tail);
2950 parms[i] = Fcar (elt);
2951 values[i] = Fcdr (elt);
2952 i++;
2954 /* TAIL and ALIST are not used again below here. */
2955 alist = tail = Qnil;
2957 GCPRO2 (*parms, *values);
2958 gcpro1.nvars = i;
2959 gcpro2.nvars = i;
2961 /* There is no need to gcpro LEFT, TOP, ICON_LEFT, or ICON_TOP,
2962 because their values appear in VALUES and strings are not valid. */
2963 top = left = Qunbound;
2964 icon_left = icon_top = Qunbound;
2966 /* Provide default values for HEIGHT and WIDTH. */
2967 width = (f->new_text_cols ? f->new_text_cols : FRAME_COLS (f));
2968 height = (f->new_text_lines ? f->new_text_lines : FRAME_LINES (f));
2970 /* Process foreground_color and background_color before anything else.
2971 They are independent of other properties, but other properties (e.g.,
2972 cursor_color) are dependent upon them. */
2973 /* Process default font as well, since fringe widths depends on it. */
2974 /* Also, process fullscreen, width and height depend upon that */
2975 for (p = 0; p < i; p++)
2977 Lisp_Object prop, val;
2979 prop = parms[p];
2980 val = values[p];
2981 if (EQ (prop, Qforeground_color)
2982 || EQ (prop, Qbackground_color)
2983 || EQ (prop, Qfont)
2984 || EQ (prop, Qfullscreen))
2986 register Lisp_Object param_index, old_value;
2987 int count = SPECPDL_INDEX ();
2989 old_value = get_frame_param (f, prop);
2990 fullscreen_is_being_set |= EQ (prop, Qfullscreen);
2992 if (NILP (Fequal (val, old_value)))
2994 /* For :font attributes, the frame_parm_handler
2995 x_set_font calls `face-set-after-frame-default'.
2996 Unless we bind inhibit-face-set-after-frame-default
2997 here, this would reset the :font attribute that we
2998 just applied to the default value for new faces. */
2999 specbind (Qinhibit_face_set_after_frame_default, Qt);
3001 store_frame_param (f, prop, val);
3003 param_index = Fget (prop, Qx_frame_parameter);
3004 if (NATNUMP (param_index)
3005 && (XFASTINT (param_index)
3006 < sizeof (frame_parms)/sizeof (frame_parms[0]))
3007 && FRAME_RIF (f)->frame_parm_handlers[XINT (param_index)])
3008 (*(FRAME_RIF (f)->frame_parm_handlers[XINT (param_index)])) (f, val, old_value);
3009 unbind_to (count, Qnil);
3014 /* Now process them in reverse of specified order. */
3015 for (i--; i >= 0; i--)
3017 Lisp_Object prop, val;
3019 prop = parms[i];
3020 val = values[i];
3022 if (EQ (prop, Qwidth) && NATNUMP (val))
3023 width = XFASTINT (val);
3024 else if (EQ (prop, Qheight) && NATNUMP (val))
3025 height = XFASTINT (val);
3026 else if (EQ (prop, Qtop))
3027 top = val;
3028 else if (EQ (prop, Qleft))
3029 left = val;
3030 else if (EQ (prop, Qicon_top))
3031 icon_top = val;
3032 else if (EQ (prop, Qicon_left))
3033 icon_left = val;
3034 else if (EQ (prop, Qforeground_color)
3035 || EQ (prop, Qbackground_color)
3036 || EQ (prop, Qfont)
3037 || EQ (prop, Qfullscreen))
3038 /* Processed above. */
3039 continue;
3040 else
3042 register Lisp_Object param_index, old_value;
3044 old_value = get_frame_param (f, prop);
3046 store_frame_param (f, prop, val);
3048 param_index = Fget (prop, Qx_frame_parameter);
3049 if (NATNUMP (param_index)
3050 && (XFASTINT (param_index)
3051 < sizeof (frame_parms)/sizeof (frame_parms[0]))
3052 && FRAME_RIF (f)->frame_parm_handlers[XINT (param_index)])
3053 (*(FRAME_RIF (f)->frame_parm_handlers[XINT (param_index)])) (f, val, old_value);
3057 /* Don't die if just one of these was set. */
3058 if (EQ (left, Qunbound))
3060 left_no_change = 1;
3061 if (f->left_pos < 0)
3062 left = Fcons (Qplus, Fcons (make_number (f->left_pos), Qnil));
3063 else
3064 XSETINT (left, f->left_pos);
3066 if (EQ (top, Qunbound))
3068 top_no_change = 1;
3069 if (f->top_pos < 0)
3070 top = Fcons (Qplus, Fcons (make_number (f->top_pos), Qnil));
3071 else
3072 XSETINT (top, f->top_pos);
3075 /* If one of the icon positions was not set, preserve or default it. */
3076 if (EQ (icon_left, Qunbound) || ! INTEGERP (icon_left))
3078 icon_left_no_change = 1;
3079 icon_left = Fcdr (Fassq (Qicon_left, f->param_alist));
3080 if (NILP (icon_left))
3081 XSETINT (icon_left, 0);
3083 if (EQ (icon_top, Qunbound) || ! INTEGERP (icon_top))
3085 icon_top_no_change = 1;
3086 icon_top = Fcdr (Fassq (Qicon_top, f->param_alist));
3087 if (NILP (icon_top))
3088 XSETINT (icon_top, 0);
3091 if (FRAME_VISIBLE_P (f) && fullscreen_is_being_set)
3093 /* If the frame is visible already and the fullscreen parameter is
3094 being set, it is too late to set WM manager hints to specify
3095 size and position.
3096 Here we first get the width, height and position that applies to
3097 fullscreen. We then move the frame to the appropriate
3098 position. Resize of the frame is taken care of in the code after
3099 this if-statement. */
3100 int new_left, new_top;
3102 x_fullscreen_adjust (f, &width, &height, &new_top, &new_left);
3103 if (new_top != f->top_pos || new_left != f->left_pos)
3104 x_set_offset (f, new_left, new_top, 1);
3107 /* Don't set these parameters unless they've been explicitly
3108 specified. The window might be mapped or resized while we're in
3109 this function, and we don't want to override that unless the lisp
3110 code has asked for it.
3112 Don't set these parameters unless they actually differ from the
3113 window's current parameters; the window may not actually exist
3114 yet. */
3116 Lisp_Object frame;
3118 check_frame_size (f, &height, &width);
3120 XSETFRAME (frame, f);
3122 if (width != FRAME_COLS (f)
3123 || height != FRAME_LINES (f)
3124 || f->new_text_lines || f->new_text_cols)
3125 Fset_frame_size (frame, make_number (width), make_number (height));
3127 if ((!NILP (left) || !NILP (top))
3128 && ! (left_no_change && top_no_change)
3129 && ! (NUMBERP (left) && XINT (left) == f->left_pos
3130 && NUMBERP (top) && XINT (top) == f->top_pos))
3132 int leftpos = 0;
3133 int toppos = 0;
3135 /* Record the signs. */
3136 f->size_hint_flags &= ~ (XNegative | YNegative);
3137 if (EQ (left, Qminus))
3138 f->size_hint_flags |= XNegative;
3139 else if (INTEGERP (left))
3141 leftpos = XINT (left);
3142 if (leftpos < 0)
3143 f->size_hint_flags |= XNegative;
3145 else if (CONSP (left) && EQ (XCAR (left), Qminus)
3146 && CONSP (XCDR (left))
3147 && INTEGERP (XCAR (XCDR (left))))
3149 leftpos = - XINT (XCAR (XCDR (left)));
3150 f->size_hint_flags |= XNegative;
3152 else if (CONSP (left) && EQ (XCAR (left), Qplus)
3153 && CONSP (XCDR (left))
3154 && INTEGERP (XCAR (XCDR (left))))
3156 leftpos = XINT (XCAR (XCDR (left)));
3159 if (EQ (top, Qminus))
3160 f->size_hint_flags |= YNegative;
3161 else if (INTEGERP (top))
3163 toppos = XINT (top);
3164 if (toppos < 0)
3165 f->size_hint_flags |= YNegative;
3167 else if (CONSP (top) && EQ (XCAR (top), Qminus)
3168 && CONSP (XCDR (top))
3169 && INTEGERP (XCAR (XCDR (top))))
3171 toppos = - XINT (XCAR (XCDR (top)));
3172 f->size_hint_flags |= YNegative;
3174 else if (CONSP (top) && EQ (XCAR (top), Qplus)
3175 && CONSP (XCDR (top))
3176 && INTEGERP (XCAR (XCDR (top))))
3178 toppos = XINT (XCAR (XCDR (top)));
3182 /* Store the numeric value of the position. */
3183 f->top_pos = toppos;
3184 f->left_pos = leftpos;
3186 f->win_gravity = NorthWestGravity;
3188 /* Actually set that position, and convert to absolute. */
3189 x_set_offset (f, leftpos, toppos, -1);
3192 if ((!NILP (icon_left) || !NILP (icon_top))
3193 && ! (icon_left_no_change && icon_top_no_change))
3194 x_wm_set_icon_position (f, XINT (icon_left), XINT (icon_top));
3197 UNGCPRO;
3201 /* Insert a description of internally-recorded parameters of frame X
3202 into the parameter alist *ALISTPTR that is to be given to the user.
3203 Only parameters that are specific to the X window system
3204 and whose values are not correctly recorded in the frame's
3205 param_alist need to be considered here. */
3207 void
3208 x_report_frame_params (f, alistptr)
3209 struct frame *f;
3210 Lisp_Object *alistptr;
3212 char buf[16];
3213 Lisp_Object tem;
3215 /* Represent negative positions (off the top or left screen edge)
3216 in a way that Fmodify_frame_parameters will understand correctly. */
3217 XSETINT (tem, f->left_pos);
3218 if (f->left_pos >= 0)
3219 store_in_alist (alistptr, Qleft, tem);
3220 else
3221 store_in_alist (alistptr, Qleft, Fcons (Qplus, Fcons (tem, Qnil)));
3223 XSETINT (tem, f->top_pos);
3224 if (f->top_pos >= 0)
3225 store_in_alist (alistptr, Qtop, tem);
3226 else
3227 store_in_alist (alistptr, Qtop, Fcons (Qplus, Fcons (tem, Qnil)));
3229 store_in_alist (alistptr, Qborder_width,
3230 make_number (f->border_width));
3231 store_in_alist (alistptr, Qinternal_border_width,
3232 make_number (FRAME_INTERNAL_BORDER_WIDTH (f)));
3233 store_in_alist (alistptr, Qleft_fringe,
3234 make_number (FRAME_LEFT_FRINGE_WIDTH (f)));
3235 store_in_alist (alistptr, Qright_fringe,
3236 make_number (FRAME_RIGHT_FRINGE_WIDTH (f)));
3237 store_in_alist (alistptr, Qscroll_bar_width,
3238 (! FRAME_HAS_VERTICAL_SCROLL_BARS (f)
3239 ? make_number (0)
3240 : FRAME_CONFIG_SCROLL_BAR_WIDTH (f) > 0
3241 ? make_number (FRAME_CONFIG_SCROLL_BAR_WIDTH (f))
3242 /* nil means "use default width"
3243 for non-toolkit scroll bar.
3244 ruler-mode.el depends on this. */
3245 : Qnil));
3246 sprintf (buf, "%ld", (long) FRAME_X_WINDOW (f));
3247 store_in_alist (alistptr, Qwindow_id,
3248 build_string (buf));
3249 #ifdef HAVE_X_WINDOWS
3250 #ifdef USE_X_TOOLKIT
3251 /* Tooltip frame may not have this widget. */
3252 if (FRAME_X_OUTPUT (f)->widget)
3253 #endif
3254 sprintf (buf, "%ld", (long) FRAME_OUTER_WINDOW (f));
3255 store_in_alist (alistptr, Qouter_window_id,
3256 build_string (buf));
3257 #endif
3258 store_in_alist (alistptr, Qicon_name, f->icon_name);
3259 FRAME_SAMPLE_VISIBILITY (f);
3260 store_in_alist (alistptr, Qvisibility,
3261 (FRAME_VISIBLE_P (f) ? Qt
3262 : FRAME_ICONIFIED_P (f) ? Qicon : Qnil));
3263 store_in_alist (alistptr, Qdisplay,
3264 XCAR (FRAME_X_DISPLAY_INFO (f)->name_list_element));
3266 if (FRAME_X_OUTPUT (f)->parent_desc == FRAME_X_DISPLAY_INFO (f)->root_window)
3267 tem = Qnil;
3268 else
3269 XSETFASTINT (tem, FRAME_X_OUTPUT (f)->parent_desc);
3270 store_in_alist (alistptr, Qexplicit_name, (f->explicit_name ? Qt : Qnil));
3271 store_in_alist (alistptr, Qparent_id, tem);
3275 /* Change the `fullscreen' frame parameter of frame F. OLD_VALUE is
3276 the previous value of that parameter, NEW_VALUE is the new value. */
3278 void
3279 x_set_fullscreen (f, new_value, old_value)
3280 struct frame *f;
3281 Lisp_Object new_value, old_value;
3283 if (NILP (new_value))
3284 f->want_fullscreen = FULLSCREEN_NONE;
3285 else if (EQ (new_value, Qfullboth))
3286 f->want_fullscreen = FULLSCREEN_BOTH;
3287 else if (EQ (new_value, Qfullwidth))
3288 f->want_fullscreen = FULLSCREEN_WIDTH;
3289 else if (EQ (new_value, Qfullheight))
3290 f->want_fullscreen = FULLSCREEN_HEIGHT;
3292 if (FRAME_TERMINAL (f)->fullscreen_hook != NULL)
3293 FRAME_TERMINAL (f)->fullscreen_hook (f);
3297 /* Change the `line-spacing' frame parameter of frame F. OLD_VALUE is
3298 the previous value of that parameter, NEW_VALUE is the new value. */
3300 void
3301 x_set_line_spacing (f, new_value, old_value)
3302 struct frame *f;
3303 Lisp_Object new_value, old_value;
3305 if (NILP (new_value))
3306 f->extra_line_spacing = 0;
3307 else if (NATNUMP (new_value))
3308 f->extra_line_spacing = XFASTINT (new_value);
3309 else
3310 signal_error ("Invalid line-spacing", new_value);
3311 if (FRAME_VISIBLE_P (f))
3312 redraw_frame (f);
3316 /* Change the `screen-gamma' frame parameter of frame F. OLD_VALUE is
3317 the previous value of that parameter, NEW_VALUE is the new value. */
3319 void
3320 x_set_screen_gamma (f, new_value, old_value)
3321 struct frame *f;
3322 Lisp_Object new_value, old_value;
3324 Lisp_Object bgcolor;
3326 if (NILP (new_value))
3327 f->gamma = 0;
3328 else if (NUMBERP (new_value) && XFLOATINT (new_value) > 0)
3329 /* The value 0.4545 is the normal viewing gamma. */
3330 f->gamma = 1.0 / (0.4545 * XFLOATINT (new_value));
3331 else
3332 signal_error ("Invalid screen-gamma", new_value);
3334 /* Apply the new gamma value to the frame background. */
3335 bgcolor = Fassq (Qbackground_color, f->param_alist);
3336 if (CONSP (bgcolor) && (bgcolor = XCDR (bgcolor), STRINGP (bgcolor)))
3338 Lisp_Object index = Fget (Qbackground_color, Qx_frame_parameter);
3339 if (NATNUMP (index)
3340 && (XFASTINT (index)
3341 < sizeof (frame_parms)/sizeof (frame_parms[0]))
3342 && FRAME_RIF (f)->frame_parm_handlers[XFASTINT (index)])
3343 (*FRAME_RIF (f)->frame_parm_handlers[XFASTINT (index)])
3344 (f, bgcolor, Qnil);
3347 Fclear_face_cache (Qnil);
3351 void
3352 x_set_font (f, arg, oldval)
3353 struct frame *f;
3354 Lisp_Object arg, oldval;
3356 Lisp_Object result;
3357 Lisp_Object fontset_name;
3358 Lisp_Object frame;
3359 int old_fontset = FRAME_FONTSET(f);
3361 CHECK_STRING (arg);
3363 fontset_name = Fquery_fontset (arg, Qnil);
3365 BLOCK_INPUT;
3366 result = (STRINGP (fontset_name)
3367 ? x_new_fontset (f, SDATA (fontset_name))
3368 : x_new_font (f, SDATA (arg)));
3369 UNBLOCK_INPUT;
3371 if (EQ (result, Qnil))
3372 error ("Font `%s' is not defined", SDATA (arg));
3373 else if (EQ (result, Qt))
3374 error ("The characters of the given font have varying widths");
3375 else if (STRINGP (result))
3377 set_default_ascii_font (result);
3378 if (STRINGP (fontset_name))
3380 /* Fontset names are built from ASCII font names, so the
3381 names may be equal despite there was a change. */
3382 if (old_fontset == FRAME_FONTSET (f))
3383 return;
3385 else if (!NILP (Fequal (result, oldval)))
3386 return;
3388 /* Recalculate toolbar height. */
3389 f->n_tool_bar_rows = 0;
3390 /* Ensure we redraw it. */
3391 clear_current_matrices (f);
3393 store_frame_param (f, Qfont, result);
3394 recompute_basic_faces (f);
3396 else
3397 abort ();
3399 do_pending_window_change (0);
3401 /* Don't call `face-set-after-frame-default' when faces haven't been
3402 initialized yet. This is the case when called from
3403 Fx_create_frame. In that case, the X widget or window doesn't
3404 exist either, and we can end up in x_report_frame_params with a
3405 null widget which gives a segfault. */
3406 if (FRAME_FACE_CACHE (f))
3408 XSETFRAME (frame, f);
3409 call1 (Qface_set_after_frame_default, frame);
3414 void
3415 x_set_fringe_width (f, new_value, old_value)
3416 struct frame *f;
3417 Lisp_Object new_value, old_value;
3419 compute_fringe_widths (f, 1);
3422 void
3423 x_set_border_width (f, arg, oldval)
3424 struct frame *f;
3425 Lisp_Object arg, oldval;
3427 CHECK_NUMBER (arg);
3429 if (XINT (arg) == f->border_width)
3430 return;
3432 if (FRAME_X_WINDOW (f) != 0)
3433 error ("Cannot change the border width of a frame");
3435 f->border_width = XINT (arg);
3438 void
3439 x_set_internal_border_width (f, arg, oldval)
3440 struct frame *f;
3441 Lisp_Object arg, oldval;
3443 int old = FRAME_INTERNAL_BORDER_WIDTH (f);
3445 CHECK_NUMBER (arg);
3446 FRAME_INTERNAL_BORDER_WIDTH (f) = XINT (arg);
3447 if (FRAME_INTERNAL_BORDER_WIDTH (f) < 0)
3448 FRAME_INTERNAL_BORDER_WIDTH (f) = 0;
3450 #ifdef USE_X_TOOLKIT
3451 if (FRAME_X_OUTPUT (f)->edit_widget)
3452 widget_store_internal_border (FRAME_X_OUTPUT (f)->edit_widget);
3453 #endif
3455 if (FRAME_INTERNAL_BORDER_WIDTH (f) == old)
3456 return;
3458 if (FRAME_X_WINDOW (f) != 0)
3460 x_set_window_size (f, 0, FRAME_COLS (f), FRAME_LINES (f));
3461 SET_FRAME_GARBAGED (f);
3462 do_pending_window_change (0);
3464 else
3465 SET_FRAME_GARBAGED (f);
3468 void
3469 x_set_visibility (f, value, oldval)
3470 struct frame *f;
3471 Lisp_Object value, oldval;
3473 Lisp_Object frame;
3474 XSETFRAME (frame, f);
3476 if (NILP (value))
3477 Fmake_frame_invisible (frame, Qt);
3478 else if (EQ (value, Qicon))
3479 Ficonify_frame (frame);
3480 else
3481 Fmake_frame_visible (frame);
3484 void
3485 x_set_autoraise (f, arg, oldval)
3486 struct frame *f;
3487 Lisp_Object arg, oldval;
3489 f->auto_raise = !EQ (Qnil, arg);
3492 void
3493 x_set_autolower (f, arg, oldval)
3494 struct frame *f;
3495 Lisp_Object arg, oldval;
3497 f->auto_lower = !EQ (Qnil, arg);
3500 void
3501 x_set_unsplittable (f, arg, oldval)
3502 struct frame *f;
3503 Lisp_Object arg, oldval;
3505 f->no_split = !NILP (arg);
3508 void
3509 x_set_vertical_scroll_bars (f, arg, oldval)
3510 struct frame *f;
3511 Lisp_Object arg, oldval;
3513 if ((EQ (arg, Qleft) && FRAME_HAS_VERTICAL_SCROLL_BARS_ON_RIGHT (f))
3514 || (EQ (arg, Qright) && FRAME_HAS_VERTICAL_SCROLL_BARS_ON_LEFT (f))
3515 || (NILP (arg) && FRAME_HAS_VERTICAL_SCROLL_BARS (f))
3516 || (!NILP (arg) && ! FRAME_HAS_VERTICAL_SCROLL_BARS (f)))
3518 FRAME_VERTICAL_SCROLL_BAR_TYPE (f)
3519 = (NILP (arg)
3520 ? vertical_scroll_bar_none
3521 : EQ (Qleft, arg)
3522 ? vertical_scroll_bar_left
3523 : EQ (Qright, arg)
3524 ? vertical_scroll_bar_right
3525 : EQ (Qleft, Vdefault_frame_scroll_bars)
3526 ? vertical_scroll_bar_left
3527 : EQ (Qright, Vdefault_frame_scroll_bars)
3528 ? vertical_scroll_bar_right
3529 : vertical_scroll_bar_none);
3531 /* We set this parameter before creating the X window for the
3532 frame, so we can get the geometry right from the start.
3533 However, if the window hasn't been created yet, we shouldn't
3534 call x_set_window_size. */
3535 if (FRAME_X_WINDOW (f))
3536 x_set_window_size (f, 0, FRAME_COLS (f), FRAME_LINES (f));
3537 do_pending_window_change (0);
3541 void
3542 x_set_scroll_bar_width (f, arg, oldval)
3543 struct frame *f;
3544 Lisp_Object arg, oldval;
3546 int wid = FRAME_COLUMN_WIDTH (f);
3548 if (NILP (arg))
3550 x_set_scroll_bar_default_width (f);
3552 if (FRAME_X_WINDOW (f))
3553 x_set_window_size (f, 0, FRAME_COLS (f), FRAME_LINES (f));
3554 do_pending_window_change (0);
3556 else if (INTEGERP (arg) && XINT (arg) > 0
3557 && XFASTINT (arg) != FRAME_CONFIG_SCROLL_BAR_WIDTH (f))
3559 if (XFASTINT (arg) <= 2 * VERTICAL_SCROLL_BAR_WIDTH_TRIM)
3560 XSETINT (arg, 2 * VERTICAL_SCROLL_BAR_WIDTH_TRIM + 1);
3562 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = XFASTINT (arg);
3563 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (XFASTINT (arg) + wid-1) / wid;
3564 if (FRAME_X_WINDOW (f))
3565 x_set_window_size (f, 0, FRAME_COLS (f), FRAME_LINES (f));
3566 do_pending_window_change (0);
3569 change_frame_size (f, 0, FRAME_COLS (f), 0, 0, 0);
3570 XWINDOW (FRAME_SELECTED_WINDOW (f))->cursor.hpos = 0;
3571 XWINDOW (FRAME_SELECTED_WINDOW (f))->cursor.x = 0;
3576 /* Return non-nil if frame F wants a bitmap icon. */
3578 Lisp_Object
3579 x_icon_type (f)
3580 FRAME_PTR f;
3582 Lisp_Object tem;
3584 tem = assq_no_quit (Qicon_type, f->param_alist);
3585 if (CONSP (tem))
3586 return XCDR (tem);
3587 else
3588 return Qnil;
3592 /* Subroutines of creating an X frame. */
3594 /* Make sure that Vx_resource_name is set to a reasonable value.
3595 Fix it up, or set it to `emacs' if it is too hopeless. */
3597 void
3598 validate_x_resource_name ()
3600 int len = 0;
3601 /* Number of valid characters in the resource name. */
3602 int good_count = 0;
3603 /* Number of invalid characters in the resource name. */
3604 int bad_count = 0;
3605 Lisp_Object new;
3606 int i;
3608 if (!STRINGP (Vx_resource_class))
3609 Vx_resource_class = build_string (EMACS_CLASS);
3611 if (STRINGP (Vx_resource_name))
3613 unsigned char *p = SDATA (Vx_resource_name);
3614 int i;
3616 len = SBYTES (Vx_resource_name);
3618 /* Only letters, digits, - and _ are valid in resource names.
3619 Count the valid characters and count the invalid ones. */
3620 for (i = 0; i < len; i++)
3622 int c = p[i];
3623 if (! ((c >= 'a' && c <= 'z')
3624 || (c >= 'A' && c <= 'Z')
3625 || (c >= '0' && c <= '9')
3626 || c == '-' || c == '_'))
3627 bad_count++;
3628 else
3629 good_count++;
3632 else
3633 /* Not a string => completely invalid. */
3634 bad_count = 5, good_count = 0;
3636 /* If name is valid already, return. */
3637 if (bad_count == 0)
3638 return;
3640 /* If name is entirely invalid, or nearly so, use `emacs'. */
3641 if (good_count == 0
3642 || (good_count == 1 && bad_count > 0))
3644 Vx_resource_name = build_string ("emacs");
3645 return;
3648 /* Name is partly valid. Copy it and replace the invalid characters
3649 with underscores. */
3651 Vx_resource_name = new = Fcopy_sequence (Vx_resource_name);
3653 for (i = 0; i < len; i++)
3655 int c = SREF (new, i);
3656 if (! ((c >= 'a' && c <= 'z')
3657 || (c >= 'A' && c <= 'Z')
3658 || (c >= '0' && c <= '9')
3659 || c == '-' || c == '_'))
3660 SSET (new, i, '_');
3665 extern char *x_get_string_resource P_ ((XrmDatabase, char *, char *));
3666 extern Display_Info *check_x_display_info P_ ((Lisp_Object));
3669 /* Get specified attribute from resource database RDB.
3670 See Fx_get_resource below for other parameters. */
3672 static Lisp_Object
3673 xrdb_get_resource (rdb, attribute, class, component, subclass)
3674 XrmDatabase rdb;
3675 Lisp_Object attribute, class, component, subclass;
3677 register char *value;
3678 char *name_key;
3679 char *class_key;
3681 CHECK_STRING (attribute);
3682 CHECK_STRING (class);
3684 if (!NILP (component))
3685 CHECK_STRING (component);
3686 if (!NILP (subclass))
3687 CHECK_STRING (subclass);
3688 if (NILP (component) != NILP (subclass))
3689 error ("x-get-resource: must specify both COMPONENT and SUBCLASS or neither");
3691 validate_x_resource_name ();
3693 /* Allocate space for the components, the dots which separate them,
3694 and the final '\0'. Make them big enough for the worst case. */
3695 name_key = (char *) alloca (SBYTES (Vx_resource_name)
3696 + (STRINGP (component)
3697 ? SBYTES (component) : 0)
3698 + SBYTES (attribute)
3699 + 3);
3701 class_key = (char *) alloca (SBYTES (Vx_resource_class)
3702 + SBYTES (class)
3703 + (STRINGP (subclass)
3704 ? SBYTES (subclass) : 0)
3705 + 3);
3707 /* Start with emacs.FRAMENAME for the name (the specific one)
3708 and with `Emacs' for the class key (the general one). */
3709 strcpy (name_key, SDATA (Vx_resource_name));
3710 strcpy (class_key, SDATA (Vx_resource_class));
3712 strcat (class_key, ".");
3713 strcat (class_key, SDATA (class));
3715 if (!NILP (component))
3717 strcat (class_key, ".");
3718 strcat (class_key, SDATA (subclass));
3720 strcat (name_key, ".");
3721 strcat (name_key, SDATA (component));
3724 strcat (name_key, ".");
3725 strcat (name_key, SDATA (attribute));
3727 value = x_get_string_resource (rdb, name_key, class_key);
3729 if (value != (char *) 0)
3730 return build_string (value);
3731 else
3732 return Qnil;
3736 DEFUN ("x-get-resource", Fx_get_resource, Sx_get_resource, 2, 4, 0,
3737 doc: /* Return the value of ATTRIBUTE, of class CLASS, from the X defaults database.
3738 This uses `INSTANCE.ATTRIBUTE' as the key and `Emacs.CLASS' as the
3739 class, where INSTANCE is the name under which Emacs was invoked, or
3740 the name specified by the `-name' or `-rn' command-line arguments.
3742 The optional arguments COMPONENT and SUBCLASS add to the key and the
3743 class, respectively. You must specify both of them or neither.
3744 If you specify them, the key is `INSTANCE.COMPONENT.ATTRIBUTE'
3745 and the class is `Emacs.CLASS.SUBCLASS'. */)
3746 (attribute, class, component, subclass)
3747 Lisp_Object attribute, class, component, subclass;
3749 #ifdef HAVE_X_WINDOWS
3750 check_x ();
3751 #endif
3753 return xrdb_get_resource (check_x_display_info (Qnil)->xrdb,
3754 attribute, class, component, subclass);
3757 /* Get an X resource, like Fx_get_resource, but for display DPYINFO. */
3759 Lisp_Object
3760 display_x_get_resource (dpyinfo, attribute, class, component, subclass)
3761 Display_Info *dpyinfo;
3762 Lisp_Object attribute, class, component, subclass;
3764 return xrdb_get_resource (dpyinfo->xrdb,
3765 attribute, class, component, subclass);
3768 /* Used when C code wants a resource value. */
3770 char *
3771 x_get_resource_string (attribute, class)
3772 char *attribute, *class;
3774 char *name_key;
3775 char *class_key;
3776 struct frame *sf = SELECTED_FRAME ();
3778 /* Allocate space for the components, the dots which separate them,
3779 and the final '\0'. */
3780 name_key = (char *) alloca (SBYTES (Vinvocation_name)
3781 + strlen (attribute) + 2);
3782 class_key = (char *) alloca ((sizeof (EMACS_CLASS) - 1)
3783 + strlen (class) + 2);
3785 sprintf (name_key, "%s.%s", SDATA (Vinvocation_name), attribute);
3786 sprintf (class_key, "%s.%s", EMACS_CLASS, class);
3788 return x_get_string_resource (FRAME_X_DISPLAY_INFO (sf)->xrdb,
3789 name_key, class_key);
3793 /* Return the value of parameter PARAM.
3795 First search ALIST, then Vdefault_frame_alist, then the X defaults
3796 database, using ATTRIBUTE as the attribute name and CLASS as its class.
3798 Convert the resource to the type specified by desired_type.
3800 If no default is specified, return Qunbound. If you call
3801 x_get_arg, make sure you deal with Qunbound in a reasonable way,
3802 and don't let it get stored in any Lisp-visible variables! */
3804 Lisp_Object
3805 x_get_arg (dpyinfo, alist, param, attribute, class, type)
3806 Display_Info *dpyinfo;
3807 Lisp_Object alist, param;
3808 char *attribute;
3809 char *class;
3810 enum resource_types type;
3812 register Lisp_Object tem;
3814 tem = Fassq (param, alist);
3816 if (!NILP (tem))
3818 /* If we find this parm in ALIST, clear it out
3819 so that it won't be "left over" at the end. */
3820 #ifndef WINDOWSNT /* w32fns.c has not yet been changed to cope with this. */
3821 Lisp_Object tail;
3822 XSETCAR (tem, Qnil);
3823 /* In case the parameter appears more than once in the alist,
3824 clear it out. */
3825 for (tail = alist; CONSP (tail); tail = XCDR (tail))
3826 if (CONSP (XCAR (tail))
3827 && EQ (XCAR (XCAR (tail)), param))
3828 XSETCAR (XCAR (tail), Qnil);
3829 #endif
3831 else
3832 tem = Fassq (param, Vdefault_frame_alist);
3834 /* If it wasn't specified in ALIST or the Lisp-level defaults,
3835 look in the X resources. */
3836 if (EQ (tem, Qnil))
3838 if (attribute)
3840 tem = display_x_get_resource (dpyinfo,
3841 build_string (attribute),
3842 build_string (class),
3843 Qnil, Qnil);
3845 if (NILP (tem))
3846 return Qunbound;
3848 switch (type)
3850 case RES_TYPE_NUMBER:
3851 return make_number (atoi (SDATA (tem)));
3853 case RES_TYPE_FLOAT:
3854 return make_float (atof (SDATA (tem)));
3856 case RES_TYPE_BOOLEAN:
3857 tem = Fdowncase (tem);
3858 if (!strcmp (SDATA (tem), "on")
3859 || !strcmp (SDATA (tem), "true"))
3860 return Qt;
3861 else
3862 return Qnil;
3864 case RES_TYPE_STRING:
3865 return tem;
3867 case RES_TYPE_SYMBOL:
3868 /* As a special case, we map the values `true' and `on'
3869 to Qt, and `false' and `off' to Qnil. */
3871 Lisp_Object lower;
3872 lower = Fdowncase (tem);
3873 if (!strcmp (SDATA (lower), "on")
3874 || !strcmp (SDATA (lower), "true"))
3875 return Qt;
3876 else if (!strcmp (SDATA (lower), "off")
3877 || !strcmp (SDATA (lower), "false"))
3878 return Qnil;
3879 else
3880 return Fintern (tem, Qnil);
3883 default:
3884 abort ();
3887 else
3888 return Qunbound;
3890 return Fcdr (tem);
3893 Lisp_Object
3894 x_frame_get_arg (f, alist, param, attribute, class, type)
3895 struct frame *f;
3896 Lisp_Object alist, param;
3897 char *attribute;
3898 char *class;
3899 enum resource_types type;
3901 return x_get_arg (FRAME_X_DISPLAY_INFO (f),
3902 alist, param, attribute, class, type);
3905 /* Like x_frame_get_arg, but also record the value in f->param_alist. */
3907 Lisp_Object
3908 x_frame_get_and_record_arg (f, alist, param, attribute, class, type)
3909 struct frame *f;
3910 Lisp_Object alist, param;
3911 char *attribute;
3912 char *class;
3913 enum resource_types type;
3915 Lisp_Object value;
3917 value = x_get_arg (FRAME_X_DISPLAY_INFO (f), alist, param,
3918 attribute, class, type);
3919 if (! NILP (value) && ! EQ (value, Qunbound))
3920 store_frame_param (f, param, value);
3922 return value;
3926 /* Record in frame F the specified or default value according to ALIST
3927 of the parameter named PROP (a Lisp symbol).
3928 If no value is specified for PROP, look for an X default for XPROP
3929 on the frame named NAME.
3930 If that is not found either, use the value DEFLT. */
3932 Lisp_Object
3933 x_default_parameter (f, alist, prop, deflt, xprop, xclass, type)
3934 struct frame *f;
3935 Lisp_Object alist;
3936 Lisp_Object prop;
3937 Lisp_Object deflt;
3938 char *xprop;
3939 char *xclass;
3940 enum resource_types type;
3942 Lisp_Object tem;
3944 tem = x_frame_get_arg (f, alist, prop, xprop, xclass, type);
3945 if (EQ (tem, Qunbound))
3946 tem = deflt;
3947 x_set_frame_parameters (f, Fcons (Fcons (prop, tem), Qnil));
3948 return tem;
3954 DEFUN ("x-parse-geometry", Fx_parse_geometry, Sx_parse_geometry, 1, 1, 0,
3955 doc: /* Parse an X-style geometry string STRING.
3956 Returns an alist of the form ((top . TOP), (left . LEFT) ... ).
3957 The properties returned may include `top', `left', `height', and `width'.
3958 The value of `left' or `top' may be an integer,
3959 or a list (+ N) meaning N pixels relative to top/left corner,
3960 or a list (- N) meaning -N pixels relative to bottom/right corner. */)
3961 (string)
3962 Lisp_Object string;
3964 int geometry, x, y;
3965 unsigned int width, height;
3966 Lisp_Object result;
3968 CHECK_STRING (string);
3970 geometry = XParseGeometry ((char *) SDATA (string),
3971 &x, &y, &width, &height);
3973 #if 0
3974 if (!!(geometry & XValue) != !!(geometry & YValue))
3975 error ("Must specify both x and y position, or neither");
3976 #endif
3978 result = Qnil;
3979 if (geometry & XValue)
3981 Lisp_Object element;
3983 if (x >= 0 && (geometry & XNegative))
3984 element = Fcons (Qleft, Fcons (Qminus, Fcons (make_number (-x), Qnil)));
3985 else if (x < 0 && ! (geometry & XNegative))
3986 element = Fcons (Qleft, Fcons (Qplus, Fcons (make_number (x), Qnil)));
3987 else
3988 element = Fcons (Qleft, make_number (x));
3989 result = Fcons (element, result);
3992 if (geometry & YValue)
3994 Lisp_Object element;
3996 if (y >= 0 && (geometry & YNegative))
3997 element = Fcons (Qtop, Fcons (Qminus, Fcons (make_number (-y), Qnil)));
3998 else if (y < 0 && ! (geometry & YNegative))
3999 element = Fcons (Qtop, Fcons (Qplus, Fcons (make_number (y), Qnil)));
4000 else
4001 element = Fcons (Qtop, make_number (y));
4002 result = Fcons (element, result);
4005 if (geometry & WidthValue)
4006 result = Fcons (Fcons (Qwidth, make_number (width)), result);
4007 if (geometry & HeightValue)
4008 result = Fcons (Fcons (Qheight, make_number (height)), result);
4010 return result;
4013 /* Calculate the desired size and position of frame F.
4014 Return the flags saying which aspects were specified.
4016 Also set the win_gravity and size_hint_flags of F.
4018 Adjust height for toolbar if TOOLBAR_P is 1.
4020 This function does not make the coordinates positive. */
4022 #define DEFAULT_ROWS 40
4023 #define DEFAULT_COLS 80
4026 x_figure_window_size (f, parms, toolbar_p)
4027 struct frame *f;
4028 Lisp_Object parms;
4029 int toolbar_p;
4031 register Lisp_Object tem0, tem1, tem2;
4032 long window_prompting = 0;
4033 Display_Info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
4035 /* Default values if we fall through.
4036 Actually, if that happens we should get
4037 window manager prompting. */
4038 SET_FRAME_COLS (f, DEFAULT_COLS);
4039 FRAME_LINES (f) = DEFAULT_ROWS;
4040 /* Window managers expect that if program-specified
4041 positions are not (0,0), they're intentional, not defaults. */
4042 f->top_pos = 0;
4043 f->left_pos = 0;
4045 /* Ensure that old new_text_cols and new_text_lines will not override the
4046 values set here. */
4047 /* ++KFS: This was specific to W32, but seems ok for all platforms */
4048 f->new_text_cols = f->new_text_lines = 0;
4050 tem0 = x_get_arg (dpyinfo, parms, Qheight, 0, 0, RES_TYPE_NUMBER);
4051 tem1 = x_get_arg (dpyinfo, parms, Qwidth, 0, 0, RES_TYPE_NUMBER);
4052 tem2 = x_get_arg (dpyinfo, parms, Quser_size, 0, 0, RES_TYPE_NUMBER);
4053 if (! EQ (tem0, Qunbound) || ! EQ (tem1, Qunbound))
4055 if (!EQ (tem0, Qunbound))
4057 CHECK_NUMBER (tem0);
4058 FRAME_LINES (f) = XINT (tem0);
4060 if (!EQ (tem1, Qunbound))
4062 CHECK_NUMBER (tem1);
4063 SET_FRAME_COLS (f, XINT (tem1));
4065 if (!NILP (tem2) && !EQ (tem2, Qunbound))
4066 window_prompting |= USSize;
4067 else
4068 window_prompting |= PSize;
4071 f->scroll_bar_actual_width
4072 = FRAME_SCROLL_BAR_COLS (f) * FRAME_COLUMN_WIDTH (f);
4074 /* This used to be done _before_ calling x_figure_window_size, but
4075 since the height is reset here, this was really a no-op. I
4076 assume that moving it here does what Gerd intended (although he
4077 no longer can remember what that was... ++KFS, 2003-03-25. */
4079 /* Add the tool-bar height to the initial frame height so that the
4080 user gets a text display area of the size he specified with -g or
4081 via .Xdefaults. Later changes of the tool-bar height don't
4082 change the frame size. This is done so that users can create
4083 tall Emacs frames without having to guess how tall the tool-bar
4084 will get. */
4085 if (toolbar_p && FRAME_TOOL_BAR_LINES (f))
4087 int margin, relief, bar_height;
4089 relief = (tool_bar_button_relief >= 0
4090 ? tool_bar_button_relief
4091 : DEFAULT_TOOL_BAR_BUTTON_RELIEF);
4093 if (INTEGERP (Vtool_bar_button_margin)
4094 && XINT (Vtool_bar_button_margin) > 0)
4095 margin = XFASTINT (Vtool_bar_button_margin);
4096 else if (CONSP (Vtool_bar_button_margin)
4097 && INTEGERP (XCDR (Vtool_bar_button_margin))
4098 && XINT (XCDR (Vtool_bar_button_margin)) > 0)
4099 margin = XFASTINT (XCDR (Vtool_bar_button_margin));
4100 else
4101 margin = 0;
4103 bar_height = DEFAULT_TOOL_BAR_IMAGE_HEIGHT + 2 * margin + 2 * relief;
4104 FRAME_LINES (f) += (bar_height + FRAME_LINE_HEIGHT (f) - 1) / FRAME_LINE_HEIGHT (f);
4107 compute_fringe_widths (f, 0);
4109 FRAME_PIXEL_WIDTH (f) = FRAME_TEXT_COLS_TO_PIXEL_WIDTH (f, FRAME_COLS (f));
4110 FRAME_PIXEL_HEIGHT (f) = FRAME_TEXT_LINES_TO_PIXEL_HEIGHT (f, FRAME_LINES (f));
4112 tem0 = x_get_arg (dpyinfo, parms, Qtop, 0, 0, RES_TYPE_NUMBER);
4113 tem1 = x_get_arg (dpyinfo, parms, Qleft, 0, 0, RES_TYPE_NUMBER);
4114 tem2 = x_get_arg (dpyinfo, parms, Quser_position, 0, 0, RES_TYPE_NUMBER);
4115 if (! EQ (tem0, Qunbound) || ! EQ (tem1, Qunbound))
4117 if (EQ (tem0, Qminus))
4119 f->top_pos = 0;
4120 window_prompting |= YNegative;
4122 else if (CONSP (tem0) && EQ (XCAR (tem0), Qminus)
4123 && CONSP (XCDR (tem0))
4124 && INTEGERP (XCAR (XCDR (tem0))))
4126 f->top_pos = - XINT (XCAR (XCDR (tem0)));
4127 window_prompting |= YNegative;
4129 else if (CONSP (tem0) && EQ (XCAR (tem0), Qplus)
4130 && CONSP (XCDR (tem0))
4131 && INTEGERP (XCAR (XCDR (tem0))))
4133 f->top_pos = XINT (XCAR (XCDR (tem0)));
4135 else if (EQ (tem0, Qunbound))
4136 f->top_pos = 0;
4137 else
4139 CHECK_NUMBER (tem0);
4140 f->top_pos = XINT (tem0);
4141 if (f->top_pos < 0)
4142 window_prompting |= YNegative;
4145 if (EQ (tem1, Qminus))
4147 f->left_pos = 0;
4148 window_prompting |= XNegative;
4150 else if (CONSP (tem1) && EQ (XCAR (tem1), Qminus)
4151 && CONSP (XCDR (tem1))
4152 && INTEGERP (XCAR (XCDR (tem1))))
4154 f->left_pos = - XINT (XCAR (XCDR (tem1)));
4155 window_prompting |= XNegative;
4157 else if (CONSP (tem1) && EQ (XCAR (tem1), Qplus)
4158 && CONSP (XCDR (tem1))
4159 && INTEGERP (XCAR (XCDR (tem1))))
4161 f->left_pos = XINT (XCAR (XCDR (tem1)));
4163 else if (EQ (tem1, Qunbound))
4164 f->left_pos = 0;
4165 else
4167 CHECK_NUMBER (tem1);
4168 f->left_pos = XINT (tem1);
4169 if (f->left_pos < 0)
4170 window_prompting |= XNegative;
4173 if (!NILP (tem2) && ! EQ (tem2, Qunbound))
4174 window_prompting |= USPosition;
4175 else
4176 window_prompting |= PPosition;
4179 if (f->want_fullscreen != FULLSCREEN_NONE)
4181 int left, top;
4182 int width, height;
4184 /* It takes both for some WM:s to place it where we want */
4185 window_prompting |= USPosition | PPosition;
4186 x_fullscreen_adjust (f, &width, &height, &top, &left);
4187 FRAME_COLS (f) = width;
4188 FRAME_LINES (f) = height;
4189 FRAME_PIXEL_WIDTH (f) = FRAME_TEXT_COLS_TO_PIXEL_WIDTH (f, width);
4190 FRAME_PIXEL_HEIGHT (f) = FRAME_TEXT_LINES_TO_PIXEL_HEIGHT (f, height);
4191 f->left_pos = left;
4192 f->top_pos = top;
4195 if (window_prompting & XNegative)
4197 if (window_prompting & YNegative)
4198 f->win_gravity = SouthEastGravity;
4199 else
4200 f->win_gravity = NorthEastGravity;
4202 else
4204 if (window_prompting & YNegative)
4205 f->win_gravity = SouthWestGravity;
4206 else
4207 f->win_gravity = NorthWestGravity;
4210 f->size_hint_flags = window_prompting;
4212 return window_prompting;
4217 #endif /* HAVE_WINDOW_SYSTEM */
4221 /***********************************************************************
4222 Initialization
4223 ***********************************************************************/
4225 void
4226 syms_of_frame ()
4228 Qframep = intern ("framep");
4229 staticpro (&Qframep);
4230 Qframe_live_p = intern ("frame-live-p");
4231 staticpro (&Qframe_live_p);
4232 Qexplicit_name = intern ("explicit-name");
4233 staticpro (&Qexplicit_name);
4234 Qheight = intern ("height");
4235 staticpro (&Qheight);
4236 Qicon = intern ("icon");
4237 staticpro (&Qicon);
4238 Qminibuffer = intern ("minibuffer");
4239 staticpro (&Qminibuffer);
4240 Qmodeline = intern ("modeline");
4241 staticpro (&Qmodeline);
4242 Qonly = intern ("only");
4243 staticpro (&Qonly);
4244 Qwidth = intern ("width");
4245 staticpro (&Qwidth);
4246 Qgeometry = intern ("geometry");
4247 staticpro (&Qgeometry);
4248 Qicon_left = intern ("icon-left");
4249 staticpro (&Qicon_left);
4250 Qicon_top = intern ("icon-top");
4251 staticpro (&Qicon_top);
4252 Qleft = intern ("left");
4253 staticpro (&Qleft);
4254 Qright = intern ("right");
4255 staticpro (&Qright);
4256 Quser_position = intern ("user-position");
4257 staticpro (&Quser_position);
4258 Quser_size = intern ("user-size");
4259 staticpro (&Quser_size);
4260 Qwindow_id = intern ("window-id");
4261 staticpro (&Qwindow_id);
4262 #ifdef HAVE_X_WINDOWS
4263 Qouter_window_id = intern ("outer-window-id");
4264 staticpro (&Qouter_window_id);
4265 #endif
4266 Qparent_id = intern ("parent-id");
4267 staticpro (&Qparent_id);
4268 Qx = intern ("x");
4269 staticpro (&Qx);
4270 Qw32 = intern ("w32");
4271 staticpro (&Qw32);
4272 Qpc = intern ("pc");
4273 staticpro (&Qpc);
4274 Qmac = intern ("mac");
4275 staticpro (&Qmac);
4276 Qvisible = intern ("visible");
4277 staticpro (&Qvisible);
4278 Qbuffer_predicate = intern ("buffer-predicate");
4279 staticpro (&Qbuffer_predicate);
4280 Qbuffer_list = intern ("buffer-list");
4281 staticpro (&Qbuffer_list);
4282 Qburied_buffer_list = intern ("buried-buffer-list");
4283 staticpro (&Qburied_buffer_list);
4284 Qdisplay_type = intern ("display-type");
4285 staticpro (&Qdisplay_type);
4286 Qbackground_mode = intern ("background-mode");
4287 staticpro (&Qbackground_mode);
4288 Qtty_color_mode = intern ("tty-color-mode");
4289 staticpro (&Qtty_color_mode);
4290 Qtty = intern ("tty");
4291 staticpro (&Qtty);
4292 Qtty_type = intern ("tty-type");
4293 staticpro (&Qtty_type);
4295 Qface_set_after_frame_default = intern ("face-set-after-frame-default");
4296 staticpro (&Qface_set_after_frame_default);
4298 Qinhibit_face_set_after_frame_default
4299 = intern ("inhibit-face-set-after-frame-default");
4300 staticpro (&Qinhibit_face_set_after_frame_default);
4302 Qfullwidth = intern ("fullwidth");
4303 staticpro (&Qfullwidth);
4304 Qfullheight = intern ("fullheight");
4305 staticpro (&Qfullheight);
4306 Qfullboth = intern ("fullboth");
4307 staticpro (&Qfullboth);
4308 Qx_resource_name = intern ("x-resource-name");
4309 staticpro (&Qx_resource_name);
4311 Qx_frame_parameter = intern ("x-frame-parameter");
4312 staticpro (&Qx_frame_parameter);
4314 Qterminal = intern ("terminal");
4315 staticpro (&Qterminal);
4316 Qterminal_live_p = intern ("terminal-live-p");
4317 staticpro (&Qterminal_live_p);
4320 int i;
4322 for (i = 0; i < sizeof (frame_parms) / sizeof (frame_parms[0]); i++)
4324 Lisp_Object v = intern (frame_parms[i].name);
4325 if (frame_parms[i].variable)
4327 *frame_parms[i].variable = v;
4328 staticpro (frame_parms[i].variable);
4330 Fput (v, Qx_frame_parameter, make_number (i));
4334 #ifdef HAVE_WINDOW_SYSTEM
4335 DEFVAR_LISP ("x-resource-name", &Vx_resource_name,
4336 doc: /* The name Emacs uses to look up X resources.
4337 `x-get-resource' uses this as the first component of the instance name
4338 when requesting resource values.
4339 Emacs initially sets `x-resource-name' to the name under which Emacs
4340 was invoked, or to the value specified with the `-name' or `-rn'
4341 switches, if present.
4343 It may be useful to bind this variable locally around a call
4344 to `x-get-resource'. See also the variable `x-resource-class'. */);
4345 Vx_resource_name = Qnil;
4347 DEFVAR_LISP ("x-resource-class", &Vx_resource_class,
4348 doc: /* The class Emacs uses to look up X resources.
4349 `x-get-resource' uses this as the first component of the instance class
4350 when requesting resource values.
4352 Emacs initially sets `x-resource-class' to "Emacs".
4354 Setting this variable permanently is not a reasonable thing to do,
4355 but binding this variable locally around a call to `x-get-resource'
4356 is a reasonable practice. See also the variable `x-resource-name'. */);
4357 Vx_resource_class = build_string (EMACS_CLASS);
4358 #endif
4360 DEFVAR_LISP ("default-frame-alist", &Vdefault_frame_alist,
4361 doc: /* Alist of default values for frame creation.
4362 These may be set in your init file, like this:
4363 (setq default-frame-alist '((width . 80) (height . 55) (menu-bar-lines . 1)))
4364 These override values given in window system configuration data,
4365 including X Windows' defaults database.
4366 For values specific to the first Emacs frame, see `initial-frame-alist'.
4367 For window-system specific values, see `window-system-default-frame-alist'.
4368 For values specific to the separate minibuffer frame, see
4369 `minibuffer-frame-alist'.
4370 The `menu-bar-lines' element of the list controls whether new frames
4371 have menu bars; `menu-bar-mode' works by altering this element.
4372 Setting this variable does not affect existing frames, only new ones. */);
4373 Vdefault_frame_alist = Qnil;
4375 DEFVAR_LISP ("default-frame-scroll-bars", &Vdefault_frame_scroll_bars,
4376 doc: /* Default position of scroll bars on this window-system. */);
4377 #ifdef HAVE_WINDOW_SYSTEM
4378 #if defined(HAVE_NTGUI) || defined(MAC_OS)
4379 /* MS-Windows has scroll bars on the right by default. */
4380 Vdefault_frame_scroll_bars = Qright;
4381 #else
4382 Vdefault_frame_scroll_bars = Qleft;
4383 #endif
4384 #else
4385 Vdefault_frame_scroll_bars = Qnil;
4386 #endif
4388 DEFVAR_LISP ("terminal-frame", &Vterminal_frame,
4389 doc: /* The initial frame-object, which represents Emacs's stdout. */);
4391 DEFVAR_LISP ("emacs-iconified", &Vemacs_iconified,
4392 doc: /* Non-nil if all of Emacs is iconified and frame updates are not needed. */);
4393 Vemacs_iconified = Qnil;
4395 DEFVAR_LISP ("mouse-position-function", &Vmouse_position_function,
4396 doc: /* If non-nil, function to transform normal value of `mouse-position'.
4397 `mouse-position' calls this function, passing its usual return value as
4398 argument, and returns whatever this function returns.
4399 This abnormal hook exists for the benefit of packages like `xt-mouse.el'
4400 which need to do mouse handling at the Lisp level. */);
4401 Vmouse_position_function = Qnil;
4403 DEFVAR_LISP ("mouse-highlight", &Vmouse_highlight,
4404 doc: /* If non-nil, clickable text is highlighted when mouse is over it.
4405 If the value is an integer, highlighting is only shown after moving the
4406 mouse, while keyboard input turns off the highlight even when the mouse
4407 is over the clickable text. However, the mouse shape still indicates
4408 when the mouse is over clickable text. */);
4409 Vmouse_highlight = Qt;
4411 DEFVAR_LISP ("delete-frame-functions", &Vdelete_frame_functions,
4412 doc: /* Functions to be run before deleting a frame.
4413 The functions are run with one arg, the frame to be deleted.
4414 See `delete-frame'.
4416 Note that functions in this list may be called twice on the same
4417 frame. In the second invocation, the frame is already deleted, and
4418 the function should do nothing. (You can use `frame-live-p' to check
4419 for this.) This wrinkle happens when an earlier function in
4420 `delete-frame-functions' (indirectly) calls `delete-frame'
4421 recursively. */);
4422 Vdelete_frame_functions = Qnil;
4424 DEFVAR_KBOARD ("default-minibuffer-frame", Vdefault_minibuffer_frame,
4425 doc: /* Minibufferless frames use this frame's minibuffer.
4427 Emacs cannot create minibufferless frames unless this is set to an
4428 appropriate surrogate.
4430 Emacs consults this variable only when creating minibufferless
4431 frames; once the frame is created, it sticks with its assigned
4432 minibuffer, no matter what this variable is set to. This means that
4433 this variable doesn't necessarily say anything meaningful about the
4434 current set of frames, or where the minibuffer is currently being
4435 displayed.
4437 This variable is local to the current terminal and cannot be buffer-local. */);
4439 DEFVAR_BOOL ("focus-follows-mouse", &focus_follows_mouse,
4440 doc: /* Non-nil if window system changes focus when you move the mouse.
4441 You should set this variable to tell Emacs how your window manager
4442 handles focus, since there is no way in general for Emacs to find out
4443 automatically. */);
4444 #ifdef HAVE_WINDOW_SYSTEM
4445 #if defined(HAVE_NTGUI) || defined(MAC_OS)
4446 focus_follows_mouse = 0;
4447 #else
4448 focus_follows_mouse = 1;
4449 #endif
4450 #else
4451 focus_follows_mouse = 0;
4452 #endif
4454 staticpro (&Vframe_list);
4456 defsubr (&Sactive_minibuffer_window);
4457 defsubr (&Sframep);
4458 defsubr (&Sframe_live_p);
4459 defsubr (&Swindow_system);
4460 defsubr (&Smake_terminal_frame);
4461 defsubr (&Shandle_switch_frame);
4462 defsubr (&Sselect_frame);
4463 defsubr (&Sselected_frame);
4464 defsubr (&Swindow_frame);
4465 defsubr (&Sframe_root_window);
4466 defsubr (&Sframe_first_window);
4467 defsubr (&Sframe_selected_window);
4468 defsubr (&Sset_frame_selected_window);
4469 defsubr (&Sframe_list);
4470 defsubr (&Snext_frame);
4471 defsubr (&Sprevious_frame);
4472 defsubr (&Sdelete_frame);
4473 defsubr (&Smouse_position);
4474 defsubr (&Smouse_pixel_position);
4475 defsubr (&Sset_mouse_position);
4476 defsubr (&Sset_mouse_pixel_position);
4477 #if 0
4478 defsubr (&Sframe_configuration);
4479 defsubr (&Srestore_frame_configuration);
4480 #endif
4481 defsubr (&Smake_frame_visible);
4482 defsubr (&Smake_frame_invisible);
4483 defsubr (&Siconify_frame);
4484 defsubr (&Sframe_visible_p);
4485 defsubr (&Svisible_frame_list);
4486 defsubr (&Sraise_frame);
4487 defsubr (&Slower_frame);
4488 defsubr (&Sredirect_frame_focus);
4489 defsubr (&Sframe_focus);
4490 defsubr (&Sframe_parameters);
4491 defsubr (&Sframe_parameter);
4492 defsubr (&Smodify_frame_parameters);
4493 defsubr (&Sframe_char_height);
4494 defsubr (&Sframe_char_width);
4495 defsubr (&Sframe_pixel_height);
4496 defsubr (&Sframe_pixel_width);
4497 defsubr (&Sset_frame_height);
4498 defsubr (&Sset_frame_width);
4499 defsubr (&Sset_frame_size);
4500 defsubr (&Sset_frame_position);
4502 #ifdef HAVE_WINDOW_SYSTEM
4503 defsubr (&Sx_get_resource);
4504 defsubr (&Sx_parse_geometry);
4505 #endif
4509 /* arch-tag: 7dbf2c69-9aad-45f8-8296-db893d6dd039
4510 (do not change this comment) */