(syms_of_ntproc) <w32-get-true-file-attributes>: Doc fix.
[bpt/emacs.git] / src / frame.c
CommitLineData
ff11dfa1 1/* Generic frame functions.
0b5538bd 2 Copyright (C) 1993, 1994, 1995, 1997, 1999, 2000, 2001, 2002, 2003,
8cabe764 3 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
dc6f92b8
JB
4
5This file is part of GNU Emacs.
6
7GNU Emacs is free software; you can redistribute it and/or modify
8it under the terms of the GNU General Public License as published by
684d6f5b 9the Free Software Foundation; either version 3, or (at your option)
dc6f92b8
JB
10any later version.
11
12GNU Emacs is distributed in the hope that it will be useful,
13but WITHOUT ANY WARRANTY; without even the implied warranty of
14MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15GNU General Public License for more details.
16
17You should have received a copy of the GNU General Public License
18along with GNU Emacs; see the file COPYING. If not, write to
4fc5845f
LK
19the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
20Boston, MA 02110-1301, USA. */
dc6f92b8 21
18160b98 22#include <config.h>
565620a5
RS
23
24#include <stdio.h>
cc38027b 25#include "lisp.h"
83be827a 26#include "character.h"
6d55d620 27#ifdef HAVE_X_WINDOWS
dfcf069d 28#include "xterm.h"
71025e5e 29#endif
8f23f280
AI
30#ifdef WINDOWSNT
31#include "w32term.h"
32#endif
e0f712ba 33#ifdef MAC_OS
1a578e9b
AC
34#include "macterm.h"
35#endif
2538fae4
AI
36#include "buffer.h"
37/* These help us bind and responding to switch-frame events. */
38#include "commands.h"
39#include "keyboard.h"
cc38027b 40#include "frame.h"
a1dfb88a
KH
41#ifdef HAVE_WINDOW_SYSTEM
42#include "fontset.h"
43#endif
972f4259 44#include "blockinput.h"
28d440ab 45#include "termchar.h"
bc1ed486 46#include "termhooks.h"
dfcf069d 47#include "dispextern.h"
f769f1b2 48#include "window.h"
87485d6f
MW
49#ifdef MSDOS
50#include "msdos.h"
4aec4b29 51#include "dosfns.h"
87485d6f 52#endif
e5d77022 53
972f4259 54
2731a0ad
KS
55#ifdef HAVE_WINDOW_SYSTEM
56
698ca23e
KH
57#ifdef USE_FONT_BACKEND
58#include "font.h"
59#endif /* USE_FONT_BACKEND */
60
972f4259
KS
61/* The name we're using in resource queries. Most often "emacs". */
62
63Lisp_Object Vx_resource_name;
64
65/* The application class we're using in resource queries.
66 Normally "Emacs". */
67
68Lisp_Object Vx_resource_class;
69
2731a0ad 70#endif
972f4259
KS
71
72Lisp_Object Qframep, Qframe_live_p;
73Lisp_Object Qicon, Qmodeline;
fd0c2bd1 74Lisp_Object Qonly;
972f4259 75Lisp_Object Qx, Qw32, Qmac, Qpc;
f7af3f7b 76Lisp_Object Qvisible;
8b60f7bc 77Lisp_Object Qdisplay_type;
6345f6aa 78Lisp_Object Qbackground_mode;
c53956fe 79Lisp_Object Qnoelisp;
972f4259
KS
80
81Lisp_Object Qx_frame_parameter;
82Lisp_Object Qx_resource_name;
6ed8eeff
KL
83Lisp_Object Qterminal;
84Lisp_Object Qterminal_live_p;
972f4259
KS
85
86/* Frame parameters (set or reported). */
87
88Lisp_Object Qauto_raise, Qauto_lower;
89Lisp_Object Qborder_color, Qborder_width;
90Lisp_Object Qcursor_color, Qcursor_type;
91Lisp_Object Qgeometry; /* Not used */
92Lisp_Object Qheight, Qwidth;
93Lisp_Object Qleft, Qright;
94Lisp_Object Qicon_left, Qicon_top, Qicon_type, Qicon_name;
95Lisp_Object Qinternal_border_width;
96Lisp_Object Qmouse_color;
97Lisp_Object Qminibuffer;
98Lisp_Object Qscroll_bar_width, Qvertical_scroll_bars;
99Lisp_Object Qvisibility;
100Lisp_Object Qscroll_bar_foreground, Qscroll_bar_background;
101Lisp_Object Qscreen_gamma;
102Lisp_Object Qline_spacing;
103Lisp_Object Quser_position, Quser_size;
104Lisp_Object Qwait_for_wm;
105Lisp_Object Qwindow_id;
106#ifdef HAVE_X_WINDOWS
107Lisp_Object Qouter_window_id;
108#endif
109Lisp_Object Qparent_id;
110Lisp_Object Qtitle, Qname;
5839d7e8 111Lisp_Object Qexplicit_name;
972f4259
KS
112Lisp_Object Qunsplittable;
113Lisp_Object Qmenu_bar_lines, Qtool_bar_lines;
114Lisp_Object Qleft_fringe, Qright_fringe;
a18b8cb5 115Lisp_Object Qbuffer_predicate, Qbuffer_list, Qburied_buffer_list;
94674d18 116Lisp_Object Qtty_color_mode;
28d440ab 117Lisp_Object Qtty, Qtty_type;
dc6f92b8 118
972f4259 119Lisp_Object Qfullscreen, Qfullwidth, Qfullheight, Qfullboth;
1a356571
KH
120#ifdef USE_FONT_BACKEND
121Lisp_Object Qfont_backend;
122#endif /* USE_FONT_BACKEND */
972f4259 123
26c34ec2 124Lisp_Object Qinhibit_face_set_after_frame_default;
972f4259
KS
125Lisp_Object Qface_set_after_frame_default;
126
a249de79 127Lisp_Object Vterminal_frame;
a1aaa23f 128Lisp_Object Vdefault_frame_alist;
6b61353c 129Lisp_Object Vdefault_frame_scroll_bars;
beb0bc36 130Lisp_Object Vmouse_position_function;
6018080f 131Lisp_Object Vmouse_highlight;
58555d81 132static Lisp_Object Vdelete_frame_functions, Qdelete_frame_functions;
da1da002
MR
133
134int focus_follows_mouse;
a249de79
RS
135\f
136static void
137set_menu_bar_lines_1 (window, n)
daf01701
KL
138 Lisp_Object window;
139 int n;
a249de79
RS
140{
141 struct window *w = XWINDOW (window);
142
57aeea1e 143 XSETFASTINT (w->last_modified, 0);
5af5757b
KS
144 XSETFASTINT (w->top_line, XFASTINT (w->top_line) + n);
145 XSETFASTINT (w->total_lines, XFASTINT (w->total_lines) - n);
177c0ea7 146
5af5757b
KS
147 if (INTEGERP (w->orig_top_line))
148 XSETFASTINT (w->orig_top_line, XFASTINT (w->orig_top_line) + n);
149 if (INTEGERP (w->orig_total_lines))
150 XSETFASTINT (w->orig_total_lines, XFASTINT (w->orig_total_lines) - n);
a249de79
RS
151
152 /* Handle just the top child in a vertical split. */
153 if (!NILP (w->vchild))
154 set_menu_bar_lines_1 (w->vchild, n);
155
156 /* Adjust all children in a horizontal split. */
157 for (window = w->hchild; !NILP (window); window = w->next)
158 {
159 w = XWINDOW (window);
160 set_menu_bar_lines_1 (window, n);
161 }
162}
163
e48f782c 164void
a249de79
RS
165set_menu_bar_lines (f, value, oldval)
166 struct frame *f;
167 Lisp_Object value, oldval;
168{
169 int nlines;
170 int olines = FRAME_MENU_BAR_LINES (f);
171
172 /* Right now, menu bars don't work properly in minibuf-only frames;
173 most of the commands try to apply themselves to the minibuffer
e3678b64 174 frame itself, and get an error because you can't switch buffers
a249de79
RS
175 in or split the minibuffer window. */
176 if (FRAME_MINIBUF_ONLY_P (f))
177 return;
178
179 if (INTEGERP (value))
180 nlines = XINT (value);
181 else
182 nlines = 0;
183
57aeea1e
RS
184 if (nlines != olines)
185 {
186 windows_or_buffers_changed++;
187 FRAME_WINDOW_SIZES_CHANGED (f) = 1;
188 FRAME_MENU_BAR_LINES (f) = nlines;
189 set_menu_bar_lines_1 (f->root_window, nlines - olines);
18082e2d 190 adjust_glyphs (f);
57aeea1e 191 }
a249de79
RS
192}
193\f
a249de79
RS
194Lisp_Object Vemacs_iconified;
195Lisp_Object Vframe_list;
a249de79 196
dc6f92b8
JB
197extern Lisp_Object Vminibuffer_list;
198extern Lisp_Object get_minibuffer ();
84386599
RS
199extern Lisp_Object Fhandle_switch_frame ();
200extern Lisp_Object Fredirect_frame_focus ();
a54d3a73 201extern Lisp_Object x_get_focus_frame ();
dc6f92b8 202\f
ff11dfa1 203DEFUN ("framep", Fframep, Sframep, 1, 1, 0,
14ff1ee0
PJ
204 doc: /* Return non-nil if OBJECT is a frame.
205Value is t for a termcap frame (a character-only terminal),
206`x' for an Emacs frame that is really an X window,
207`w32' for an Emacs frame that is a window on MS-Windows display,
208`mac' for an Emacs frame on a Macintosh display,
209`pc' for a direct-write MS-DOS frame.
210See also `frame-live-p'. */)
211 (object)
f9898cc6 212 Lisp_Object object;
dc6f92b8 213{
e35d291d 214 if (!FRAMEP (object))
dc6f92b8 215 return Qnil;
ff11dfa1 216 switch (XFRAME (object)->output_method)
dc6f92b8 217 {
3224dac1 218 case output_initial: /* The initial frame is like a termcap frame. */
dc6f92b8
JB
219 case output_termcap:
220 return Qt;
221 case output_x_window:
fd0c2bd1 222 return Qx;
fbd6baed
GV
223 case output_w32:
224 return Qw32;
bb221971
RS
225 case output_msdos_raw:
226 return Qpc;
574a1a90
RS
227 case output_mac:
228 return Qmac;
dc6f92b8
JB
229 default:
230 abort ();
231 }
232}
233
dbc4e1c1 234DEFUN ("frame-live-p", Fframe_live_p, Sframe_live_p, 1, 1, 0,
14ff1ee0
PJ
235 doc: /* Return non-nil if OBJECT is a frame which has not been deleted.
236Value is nil if OBJECT is not a live frame. If object is a live
6ed8eeff 237frame, the return value indicates what sort of terminal device it is
f6fa0866 238displayed on. See the documentation of `framep' for possible
4e10df59 239return values. */)
14ff1ee0 240 (object)
f9898cc6
JB
241 Lisp_Object object;
242{
ff11dfa1
JB
243 return ((FRAMEP (object)
244 && FRAME_LIVE_P (XFRAME (object)))
245 ? Fframep (object)
f9898cc6
JB
246 : Qnil);
247}
248
428a555e
KL
249DEFUN ("window-system", Fwindow_system, Swindow_system, 0, 1, 0,
250 doc: /* The name of the window system that FRAME is displaying through.
251The value is a symbol---for instance, 'x' for X windows.
252The value is nil if Emacs is using a text-only terminal.
253
254FRAME defaults to the currently selected frame. */)
255 (frame)
256 Lisp_Object frame;
257{
258 Lisp_Object type;
259 if (NILP (frame))
260 frame = selected_frame;
261
262 type = Fframep (frame);
263
264 if (NILP (type))
265 wrong_type_argument (Qframep, frame);
266
267 if (EQ (type, Qt))
268 return Qnil;
269 else
270 return type;
a3547743 271}
428a555e 272
ff11dfa1
JB
273struct frame *
274make_frame (mini_p)
dc6f92b8
JB
275 int mini_p;
276{
ff11dfa1
JB
277 Lisp_Object frame;
278 register struct frame *f;
dc6f92b8
JB
279 register Lisp_Object root_window;
280 register Lisp_Object mini_window;
e9c96c62
GM
281
282 f = allocate_frame ();
36af7d69 283 XSETFRAME (frame, f);
ff11dfa1 284
18082e2d
GM
285 f->desired_matrix = 0;
286 f->current_matrix = 0;
287 f->desired_pool = 0;
288 f->current_pool = 0;
289 f->glyphs_initialized_p = 0;
290 f->decode_mode_spec_buffer = 0;
ff11dfa1 291 f->visible = 0;
323405de 292 f->async_visible = 0;
7556890b 293 f->output_data.nothing = 0;
ff11dfa1 294 f->iconified = 0;
323405de 295 f->async_iconified = 0;
ff11dfa1
JB
296 f->wants_modeline = 1;
297 f->auto_raise = 0;
298 f->auto_lower = 0;
299 f->no_split = 0;
10689a01 300 f->garbaged = 1;
ff11dfa1 301 f->has_minibuffer = mini_p;
a42e9724 302 f->focus_frame = Qnil;
804518aa 303 f->explicit_name = 0;
fd2777e0 304 f->can_have_scroll_bars = 0;
3a43d2dd 305 f->vertical_scroll_bar_type = vertical_scroll_bar_none;
ff11dfa1 306 f->param_alist = Qnil;
fd2777e0
JB
307 f->scroll_bars = Qnil;
308 f->condemned_scroll_bars = Qnil;
306cc902 309 f->face_alist = Qnil;
18082e2d 310 f->face_cache = NULL;
9dd935ee 311 f->menu_bar_items = Qnil;
c8b8e7e3
RS
312 f->menu_bar_vector = Qnil;
313 f->menu_bar_items_used = 0;
329ca574 314 f->buffer_predicate = Qnil;
fa54c6ae 315 f->buffer_list = Qnil;
a18b8cb5 316 f->buried_buffer_list = Qnil;
aec6e486 317 f->namebuf = 0;
2b1c9cfb 318 f->title = Qnil;
18082e2d 319 f->menu_bar_window = Qnil;
9ea173e8 320 f->tool_bar_window = Qnil;
61752261 321 f->tool_bar_items = Qnil;
9ea173e8 322 f->desired_tool_bar_string = f->current_tool_bar_string = Qnil;
61752261 323 f->n_tool_bar_items = 0;
5af5757b
KS
324 f->left_fringe_width = f->right_fringe_width = 0;
325 f->fringe_cols = 0;
326 f->scroll_bar_actual_width = 0;
327 f->border_width = 0;
328 f->internal_border_width = 0;
329 f->column_width = 1; /* !FRAME_WINDOW_P value */
330 f->line_height = 1; /* !FRAME_WINDOW_P value */
331 f->x_pixels_diff = f->y_pixels_diff = 0;
93421a1f 332#ifdef HAVE_WINDOW_SYSTEM
5af5757b 333 f->want_fullscreen = FULLSCREEN_NONE;
93421a1f 334#endif
5af5757b
KS
335 f->size_hint_flags = 0;
336 f->win_gravity = 0;
698ca23e
KH
337#ifdef USE_FONT_BACKEND
338 f->font_driver_list = NULL;
50e3873c 339 f->font_data_list = NULL;
698ca23e 340#endif /* USE_FONT_BACKEND */
dc6f92b8 341
cc38027b 342 root_window = make_window ();
dc6f92b8
JB
343 if (mini_p)
344 {
cc38027b 345 mini_window = make_window ();
dc6f92b8
JB
346 XWINDOW (root_window)->next = mini_window;
347 XWINDOW (mini_window)->prev = root_window;
348 XWINDOW (mini_window)->mini_p = Qt;
ff11dfa1
JB
349 XWINDOW (mini_window)->frame = frame;
350 f->minibuffer_window = mini_window;
dc6f92b8
JB
351 }
352 else
353 {
354 mini_window = Qnil;
355 XWINDOW (root_window)->next = Qnil;
ff11dfa1 356 f->minibuffer_window = Qnil;
dc6f92b8
JB
357 }
358
ff11dfa1 359 XWINDOW (root_window)->frame = frame;
dc6f92b8
JB
360
361 /* 10 is arbitrary,
362 just so that there is "something there."
ff11dfa1 363 Correct size will be set up later with change_frame_size. */
dc6f92b8 364
5af5757b
KS
365 SET_FRAME_COLS (f, 10);
366 FRAME_LINES (f) = 10;
dc6f92b8 367
5af5757b
KS
368 XSETFASTINT (XWINDOW (root_window)->total_cols, 10);
369 XSETFASTINT (XWINDOW (root_window)->total_lines, (mini_p ? 9 : 10));
dc6f92b8
JB
370
371 if (mini_p)
372 {
5af5757b
KS
373 XSETFASTINT (XWINDOW (mini_window)->total_cols, 10);
374 XSETFASTINT (XWINDOW (mini_window)->top_line, 9);
375 XSETFASTINT (XWINDOW (mini_window)->total_lines, 1);
dc6f92b8
JB
376 }
377
ff11dfa1 378 /* Choose a buffer for the frame's root window. */
5bce042c
JB
379 {
380 Lisp_Object buf;
381
382 XWINDOW (root_window)->buffer = Qt;
383 buf = Fcurrent_buffer ();
384 /* If buf is a 'hidden' buffer (i.e. one whose name starts with
385 a space), try to find another one. */
d5db4077 386 if (SREF (Fbuffer_name (buf), 0) == ' ')
98ce1622 387 buf = Fother_buffer (buf, Qnil, Qnil);
fa54c6ae 388
18082e2d
GM
389 /* Use set_window_buffer, not Fset_window_buffer, and don't let
390 hooks be run by it. The reason is that the whole frame/window
391 arrangement is not yet fully intialized at this point. Windows
392 don't have the right size, glyph matrices aren't initialized
393 etc. Running Lisp functions at this point surely ends in a
394 SEGV. */
5af5757b 395 set_window_buffer (root_window, buf, 0, 0);
fa54c6ae 396 f->buffer_list = Fcons (buf, Qnil);
5bce042c
JB
397 }
398
dc6f92b8
JB
399 if (mini_p)
400 {
401 XWINDOW (mini_window)->buffer = Qt;
18082e2d
GM
402 set_window_buffer (mini_window,
403 (NILP (Vminibuffer_list)
404 ? get_minibuffer (0)
405 : Fcar (Vminibuffer_list)),
5af5757b 406 0, 0);
dc6f92b8
JB
407 }
408
ff11dfa1
JB
409 f->root_window = root_window;
410 f->selected_window = root_window;
d5e7c279
JB
411 /* Make sure this window seems more recently used than
412 a newly-created, never-selected window. */
2a1893f4
SM
413 ++window_select_count;
414 XSETFASTINT (XWINDOW (f->selected_window)->use_time, window_select_count);
dc6f92b8 415
a5f696ac
JD
416 f->default_face_done_p = 0;
417
ff11dfa1 418 return f;
dc6f92b8
JB
419}
420\f
bba88bb1 421#ifdef HAVE_WINDOW_SYSTEM
ff11dfa1 422/* Make a frame using a separate minibuffer window on another frame.
dc6f92b8
JB
423 MINI_WINDOW is the minibuffer window to use. nil means use the
424 default (the global minibuffer). */
425
ff11dfa1 426struct frame *
b0660239 427make_frame_without_minibuffer (mini_window, kb, display)
dc6f92b8 428 register Lisp_Object mini_window;
662ac59a 429 KBOARD *kb;
b0660239 430 Lisp_Object display;
dc6f92b8 431{
ff11dfa1 432 register struct frame *f;
363b873b 433 struct gcpro gcpro1;
dc6f92b8 434
b0660239 435 if (!NILP (mini_window))
b7826503 436 CHECK_LIVE_WINDOW (mini_window);
dc6f92b8 437
662ac59a 438#ifdef MULTI_KBOARD
b0660239 439 if (!NILP (mini_window)
6ed8eeff
KL
440 && FRAME_KBOARD (XFRAME (XWINDOW (mini_window)->frame)) != kb)
441 error ("Frame and minibuffer must be on the same terminal");
662ac59a
KH
442#endif
443
ff11dfa1
JB
444 /* Make a frame containing just a root window. */
445 f = make_frame (0);
dc6f92b8 446
b0660239
KH
447 if (NILP (mini_window))
448 {
449 /* Use default-minibuffer-frame if possible. */
450 if (!FRAMEP (kb->Vdefault_minibuffer_frame)
451 || ! FRAME_LIVE_P (XFRAME (kb->Vdefault_minibuffer_frame)))
452 {
363b873b
RS
453 Lisp_Object frame_dummy;
454
455 XSETFRAME (frame_dummy, f);
456 GCPRO1 (frame_dummy);
b0660239 457 /* If there's no minibuffer frame to use, create one. */
363b873b
RS
458 kb->Vdefault_minibuffer_frame =
459 call1 (intern ("make-initial-minibuffer-frame"), display);
460 UNGCPRO;
b0660239 461 }
177c0ea7 462
b0660239
KH
463 mini_window = XFRAME (kb->Vdefault_minibuffer_frame)->minibuffer_window;
464 }
a2812a26 465
ff11dfa1 466 f->minibuffer_window = mini_window;
a2812a26
RS
467
468 /* Make the chosen minibuffer window display the proper minibuffer,
469 unless it is already showing a minibuffer. */
470 if (NILP (Fmemq (XWINDOW (mini_window)->buffer, Vminibuffer_list)))
471 Fset_window_buffer (mini_window,
472 (NILP (Vminibuffer_list)
473 ? get_minibuffer (0)
5af5757b 474 : Fcar (Vminibuffer_list)), Qnil);
ff11dfa1 475 return f;
dc6f92b8
JB
476}
477
ff11dfa1 478/* Make a frame containing only a minibuffer window. */
dc6f92b8 479
ff11dfa1
JB
480struct frame *
481make_minibuffer_frame ()
dc6f92b8 482{
ff11dfa1 483 /* First make a frame containing just a root window, no minibuffer. */
dc6f92b8 484
ff11dfa1 485 register struct frame *f = make_frame (0);
dc6f92b8 486 register Lisp_Object mini_window;
ff11dfa1 487 register Lisp_Object frame;
dc6f92b8 488
2d80a27a 489 XSETFRAME (frame, f);
dc6f92b8 490
804518aa 491 f->auto_raise = 0;
ff11dfa1
JB
492 f->auto_lower = 0;
493 f->no_split = 1;
494 f->wants_modeline = 0;
495 f->has_minibuffer = 1;
dc6f92b8
JB
496
497 /* Now label the root window as also being the minibuffer.
498 Avoid infinite looping on the window chain by marking next pointer
499 as nil. */
500
ff11dfa1 501 mini_window = f->minibuffer_window = f->root_window;
dc6f92b8
JB
502 XWINDOW (mini_window)->mini_p = Qt;
503 XWINDOW (mini_window)->next = Qnil;
804518aa 504 XWINDOW (mini_window)->prev = Qnil;
ff11dfa1 505 XWINDOW (mini_window)->frame = frame;
dc6f92b8
JB
506
507 /* Put the proper buffer in that window. */
508
509 Fset_window_buffer (mini_window,
265a9e55 510 (NILP (Vminibuffer_list)
dc6f92b8 511 ? get_minibuffer (0)
5af5757b 512 : Fcar (Vminibuffer_list)), Qnil);
ff11dfa1 513 return f;
dc6f92b8 514}
bba88bb1 515#endif /* HAVE_WINDOW_SYSTEM */
dc6f92b8 516\f
28d440ab 517/* Construct a frame that refers to a terminal. */
dc6f92b8 518
6ed8eeff 519static int tty_frame_count;
bb1513c9 520
ff11dfa1 521struct frame *
3224dac1 522make_initial_frame (void)
dc6f92b8 523{
3224dac1 524 struct frame *f;
6ed8eeff 525 struct terminal *terminal;
d063751a 526 Lisp_Object frame;
bb1513c9 527
1bc973c2 528 eassert (initial_kboard);
b4f0ee5d 529
bb1513c9
RS
530 /* The first call must initialize Vframe_list. */
531 if (! (NILP (Vframe_list) || CONSP (Vframe_list)))
532 Vframe_list = Qnil;
ff11dfa1 533
6ed8eeff 534 terminal = init_initial_terminal ();
3224dac1
KL
535
536 f = make_frame (1);
537 XSETFRAME (frame, f);
538
539 Vframe_list = Fcons (frame, Vframe_list);
540
6ed8eeff 541 tty_frame_count = 1;
3224dac1
KL
542 f->name = build_string ("F1");
543
544 f->visible = 1;
545 f->async_visible = 1;
546
6ed8eeff
KL
547 f->output_method = terminal->type;
548 f->terminal = terminal;
549 f->terminal->reference_count++;
3224dac1 550 f->output_data.nothing = 0;
a3547743 551
3224dac1
KL
552 FRAME_FOREGROUND_PIXEL (f) = FACE_TTY_DEFAULT_FG_COLOR;
553 FRAME_BACKGROUND_PIXEL (f) = FACE_TTY_DEFAULT_BG_COLOR;
a3547743 554
3224dac1
KL
555 FRAME_CAN_HAVE_SCROLL_BARS (f) = 0;
556 FRAME_VERTICAL_SCROLL_BAR_TYPE (f) = vertical_scroll_bar_none;
557
3224dac1
KL
558 return f;
559}
560
561
562struct frame *
6ed8eeff 563make_terminal_frame (struct terminal *terminal)
3224dac1
KL
564{
565 register struct frame *f;
3224dac1
KL
566 Lisp_Object frame;
567 char name[20];
ab797f65 568
4e213843
SM
569 if (!terminal->name)
570 error ("Terminal is not live, can't create new frames on it");
ab797f65 571
ff11dfa1 572 f = make_frame (1);
d063751a 573
2d80a27a 574 XSETFRAME (frame, f);
d063751a
RS
575 Vframe_list = Fcons (frame, Vframe_list);
576
6ed8eeff
KL
577 tty_frame_count++;
578 sprintf (name, "F%d", tty_frame_count);
0303e8da 579 f->name = build_string (name);
bb1513c9 580
bb1513c9
RS
581 f->visible = 1; /* FRAME_SET_VISIBLE wd set frame_garbaged. */
582 f->async_visible = 1; /* Don't let visible be cleared later. */
bb221971
RS
583#ifdef MSDOS
584 f->output_data.x = &the_only_x_display;
2d764c78
EZ
585 if (!inhibit_window_system
586 && (!FRAMEP (selected_frame) || !FRAME_LIVE_P (XFRAME (selected_frame))
587 || XFRAME (selected_frame)->output_method == output_msdos_raw))
65606f5e
EZ
588 {
589 f->output_method = output_msdos_raw;
590 /* This initialization of foreground and background pixels is
591 only important for the initial frame created in temacs. If
592 we don't do that, we get black background and foreground in
593 the dumped Emacs because the_only_x_display is a static
594 variable, hence it is born all-zeroes, and zero is the code
595 for the black color. Other frames all inherit their pixels
596 from what's already in the_only_x_display. */
597 if ((!FRAMEP (selected_frame) || !FRAME_LIVE_P (XFRAME (selected_frame)))
5bcee7ef
KL
598 && FRAME_BACKGROUND_PIXEL (f) == 0
599 && FRAME_FOREGROUND_PIXEL (f) == 0)
65606f5e 600 {
5bcee7ef
KL
601 FRAME_BACKGROUND_PIXEL (f) = FACE_TTY_DEFAULT_BG_COLOR;
602 FRAME_FOREGROUND_PIXEL (f) = FACE_TTY_DEFAULT_FG_COLOR;
65606f5e
EZ
603 }
604 }
2d764c78
EZ
605 else
606 f->output_method = output_termcap;
1a578e9b 607#else
0a125897 608 {
0a125897 609 f->output_method = output_termcap;
6ed8eeff
KL
610 f->terminal = terminal;
611 f->terminal->reference_count++;
428a555e 612 create_tty_output (f);
a3547743 613
28d7d09f
KL
614 FRAME_FOREGROUND_PIXEL (f) = FACE_TTY_DEFAULT_FG_COLOR;
615 FRAME_BACKGROUND_PIXEL (f) = FACE_TTY_DEFAULT_BG_COLOR;
a3547743 616
428a555e
KL
617 FRAME_CAN_HAVE_SCROLL_BARS (f) = 0;
618 FRAME_VERTICAL_SCROLL_BAR_TYPE (f) = vertical_scroll_bar_none;
619
428a555e 620 /* Set the top frame to the newly created frame. */
b1cb6b20 621 if (FRAMEP (FRAME_TTY (f)->top_frame)
114a8b8c
KL
622 && FRAME_LIVE_P (XFRAME (FRAME_TTY (f)->top_frame)))
623 XFRAME (FRAME_TTY (f)->top_frame)->async_visible = 2; /* obscured */
a3547743 624
428a555e 625 FRAME_TTY (f)->top_frame = frame;
0a125897 626 }
a3547743 627
58bd8318
KS
628#ifdef CANNOT_DUMP
629 FRAME_FOREGROUND_PIXEL(f) = FACE_TTY_DEFAULT_FG_COLOR;
630 FRAME_BACKGROUND_PIXEL(f) = FACE_TTY_DEFAULT_BG_COLOR;
631#endif
2d764c78 632#endif /* MSDOS */
574a1a90 633
1a6d3623
EZ
634 if (!noninteractive)
635 init_frame_faces (f);
1a578e9b 636
ff11dfa1 637 return f;
dc6f92b8 638}
bb1513c9 639
ed8dad6b
KL
640/* Get a suitable value for frame parameter PARAMETER for a newly
641 created frame, based on (1) the user-supplied frame parameter
642 alist SUPPLIED_PARMS, (2) CURRENT_VALUE, and finally, if all else
643 fails, (3) Vdefault_frame_alist. */
644
645static Lisp_Object
646get_future_frame_param (Lisp_Object parameter,
647 Lisp_Object supplied_parms,
648 char *current_value)
649{
650 Lisp_Object result;
651
652 result = Fassq (parameter, supplied_parms);
653 if (NILP (result))
654 result = Fassq (parameter, XFRAME (selected_frame)->param_alist);
655 if (NILP (result) && current_value != NULL)
656 result = build_string (current_value);
657 if (NILP (result))
658 result = Fassq (parameter, Vdefault_frame_alist);
659 if (!NILP (result) && !STRINGP (result))
660 result = XCDR (result);
661 if (NILP (result) || !STRINGP (result))
662 result = Qnil;
663
664 return result;
665}
666
bb1513c9 667DEFUN ("make-terminal-frame", Fmake_terminal_frame, Smake_terminal_frame,
14ff1ee0 668 1, 1, 0,
28d440ab 669 doc: /* Create an additional terminal frame, possibly on another terminal.
14ff1ee0 670This function takes one argument, an alist specifying frame parameters.
28d440ab
KL
671
672You can create multiple frames on a single text-only terminal, but
673only one of them (the selected terminal frame) is actually displayed.
674
675In practice, generally you don't need to specify any parameters,
676except when you want to create a new frame on another terminal.
677In that case, the `tty' parameter specifies the device file to open,
678and the `tty-type' parameter specifies the terminal type. Example:
679
680 (make-terminal-frame '((tty . "/dev/pts/5") (tty-type . "xterm")))
681
0b0d3e0b
KL
682Note that changing the size of one terminal frame automatically
683affects all frames on the same terminal device. */)
14ff1ee0 684 (parms)
bb1513c9
RS
685 Lisp_Object parms;
686{
687 struct frame *f;
6ed8eeff 688 struct terminal *t = NULL;
574a1a90 689 Lisp_Object frame, tem;
8d2666fe 690 struct frame *sf = SELECTED_FRAME ();
bb1513c9 691
541580aa 692#ifdef MSDOS
2d764c78
EZ
693 if (sf->output_method != output_msdos_raw
694 && sf->output_method != output_termcap)
bb221971 695 abort ();
574a1a90
RS
696#else /* not MSDOS */
697
e39a993c 698#if 0
caf49fb0
DN
699 /* This can happen for multi-tty when using both terminal frames and
700 Carbon frames. */
8d2666fe 701 if (sf->output_method != output_mac)
574a1a90 702 error ("Not running on a Macintosh screen; cannot make a new Macintosh frame");
bb221971 703#else
daf01701 704#if 0 /* This should work now! */
8d2666fe 705 if (sf->output_method != output_termcap)
bb1513c9 706 error ("Not using an ASCII terminal now; cannot make a new ASCII frame");
bb221971 707#endif
daf01701 708#endif
574a1a90 709#endif /* not MSDOS */
a3547743 710
b6660415 711 {
6ed8eeff 712 Lisp_Object terminal;
bb1513c9 713
6ed8eeff
KL
714 terminal = Fassq (Qterminal, parms);
715 if (!NILP (terminal))
28d440ab 716 {
6ed8eeff
KL
717 terminal = XCDR (terminal);
718 t = get_terminal (terminal, 1);
28d440ab 719 }
28d440ab 720 }
a3547743 721
6ed8eeff 722 if (!t)
a3547743 723 {
b6660415 724 char *name = 0, *type = 0;
ed8dad6b 725 Lisp_Object tty, tty_type;
b6660415 726
ed8dad6b
KL
727 tty = get_future_frame_param
728 (Qtty, parms, (FRAME_TERMCAP_P (XFRAME (selected_frame))
729 ? FRAME_TTY (XFRAME (selected_frame))->name
730 : NULL));
731 if (!NILP (tty))
b6660415
KL
732 {
733 name = (char *) alloca (SBYTES (tty) + 1);
734 strncpy (name, SDATA (tty), SBYTES (tty));
735 name[SBYTES (tty)] = 0;
736 }
a3547743 737
ed8dad6b
KL
738 tty_type = get_future_frame_param
739 (Qtty_type, parms, (FRAME_TERMCAP_P (XFRAME (selected_frame))
740 ? FRAME_TTY (XFRAME (selected_frame))->type
741 : NULL));
742 if (!NILP (tty_type))
b6660415
KL
743 {
744 type = (char *) alloca (SBYTES (tty_type) + 1);
745 strncpy (type, SDATA (tty_type), SBYTES (tty_type));
746 type[SBYTES (tty_type)] = 0;
747 }
748
6ed8eeff 749 t = init_tty (name, type, 0); /* Errors are not fatal. */
b6660415 750 }
bb1513c9 751
6ed8eeff 752 f = make_terminal_frame (t);
574a1a90 753
9628b887
KL
754 {
755 int width, height;
0b0d3e0b 756 get_tty_size (fileno (FRAME_TTY (f)->input), &width, &height);
9628b887
KL
757 change_frame_size (f, height, width, 0, 0, 0);
758 }
a3547743 759
18082e2d 760 adjust_glyphs (f);
bb1513c9
RS
761 calculate_costs (f);
762 XSETFRAME (frame, f);
8adfc1ec 763 Fmodify_frame_parameters (frame, Vdefault_frame_alist);
bb1513c9 764 Fmodify_frame_parameters (frame, parms);
ed8dad6b 765 Fmodify_frame_parameters (frame, Fcons (Fcons (Qtty_type,
6ed8eeff 766 build_string (t->display_info.tty->type)),
ed8dad6b 767 Qnil));
db9d7d9a
KL
768 if (t->display_info.tty->name != NULL)
769 Fmodify_frame_parameters (frame, Fcons (Fcons (Qtty,
770 build_string (t->display_info.tty->name)),
771 Qnil));
772 else
773 Fmodify_frame_parameters (frame, Fcons (Fcons (Qtty, Qnil), Qnil));
a3547743 774
87f1940e
EZ
775 /* Make the frame face alist be frame-specific, so that each
776 frame could change its face definitions independently. */
8d2666fe 777 f->face_alist = Fcopy_alist (sf->face_alist);
87f1940e
EZ
778 /* Simple Fcopy_alist isn't enough, because we need the contents of
779 the vectors which are the CDRs of associations in face_alist to
780 be copied as well. */
781 for (tem = f->face_alist; CONSP (tem); tem = XCDR (tem))
f3fbd155 782 XSETCDR (XCAR (tem), Fcopy_sequence (XCDR (XCAR (tem))));
bb1513c9
RS
783 return frame;
784}
1e8324d9 785
dc6f92b8 786\f
1e8324d9
GM
787/* Perform the switch to frame FRAME.
788
789 If FRAME is a switch-frame event `(switch-frame FRAME1)', use
790 FRAME1 as frame.
791
792 If TRACK is non-zero and the frame that currently has the focus
793 redirects its focus to the selected frame, redirect that focused
794 frame's focus to FRAME instead.
795
796 FOR_DELETION non-zero means that the selected frame is being
6ed8eeff 797 deleted, which includes the possibility that the frame's terminal
1e8324d9
GM
798 is dead. */
799
61f94483 800Lisp_Object
1e8324d9
GM
801do_switch_frame (frame, track, for_deletion)
802 Lisp_Object frame;
803 int track, for_deletion;
dc6f92b8 804{
8d2666fe 805 struct frame *sf = SELECTED_FRAME ();
177c0ea7 806
2f0b07e0
JB
807 /* If FRAME is a switch-frame event, extract the frame we should
808 switch to. */
809 if (CONSP (frame)
7539e11f
KR
810 && EQ (XCAR (frame), Qswitch_frame)
811 && CONSP (XCDR (frame)))
812 frame = XCAR (XCDR (frame));
2f0b07e0 813
09907c3a
KH
814 /* This used to say CHECK_LIVE_FRAME, but apparently it's possible for
815 a switch-frame event to arrive after a frame is no longer live,
816 especially when deleting the initial frame during startup. */
b7826503 817 CHECK_FRAME (frame);
09907c3a
KH
818 if (! FRAME_LIVE_P (XFRAME (frame)))
819 return Qnil;
dc6f92b8 820
8d2666fe 821 if (sf == XFRAME (frame))
ff11dfa1 822 return frame;
dc6f92b8 823
0aed85f4
KH
824 /* This is too greedy; it causes inappropriate focus redirection
825 that's hard to get rid of. */
826#if 0
a42e9724
JB
827 /* If a frame's focus has been redirected toward the currently
828 selected frame, we should change the redirection to point to the
829 newly selected frame. This means that if the focus is redirected
830 from a minibufferless frame to a surrogate minibuffer frame, we
831 can use `other-window' to switch between all the frames using
832 that minibuffer frame, and the focus redirection will follow us
833 around. */
0aed85f4
KH
834 if (track)
835 {
836 Lisp_Object tail;
a42e9724 837
7539e11f 838 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
0aed85f4
KH
839 {
840 Lisp_Object focus;
a42e9724 841
7539e11f 842 if (!FRAMEP (XCAR (tail)))
0aed85f4 843 abort ();
a42e9724 844
7539e11f 845 focus = FRAME_FOCUS_FRAME (XFRAME (XCAR (tail)));
a42e9724 846
8d2666fe 847 if (FRAMEP (focus) && XFRAME (focus) == SELECTED_FRAME ())
7539e11f 848 Fredirect_frame_focus (XCAR (tail), frame);
0aed85f4
KH
849 }
850 }
851#else /* ! 0 */
852 /* Instead, apply it only to the frame we're pointing to. */
032d78fe 853#ifdef HAVE_WINDOW_SYSTEM
1e8324d9 854 if (track && FRAME_WINDOW_P (XFRAME (frame)))
0aed85f4
KH
855 {
856 Lisp_Object focus, xfocus;
857
d7266360 858 xfocus = x_get_focus_frame (XFRAME (frame));
0aed85f4
KH
859 if (FRAMEP (xfocus))
860 {
861 focus = FRAME_FOCUS_FRAME (XFRAME (xfocus));
8d2666fe 862 if (FRAMEP (focus) && XFRAME (focus) == SELECTED_FRAME ())
0aed85f4
KH
863 Fredirect_frame_focus (xfocus, frame);
864 }
865 }
866#endif /* HAVE_X_WINDOWS */
867#endif /* ! 0 */
a42e9724 868
1e8324d9 869 if (!for_deletion && FRAME_HAS_MINIBUF_P (sf))
550f0e6a
GM
870 resize_mini_window (XWINDOW (FRAME_MINIBUF_WINDOW (sf)), 1);
871
9b2cd403 872 if (FRAME_TERMCAP_P (XFRAME (frame)))
9628b887 873 {
9b2cd403
SM
874 if (FRAMEP (FRAME_TTY (XFRAME (frame))->top_frame))
875 /* Mark previously displayed frame as now obscured. */
876 XFRAME (FRAME_TTY (XFRAME (frame))->top_frame)->async_visible = 2;
9628b887
KL
877 XFRAME (frame)->async_visible = 1;
878 FRAME_TTY (XFRAME (frame))->top_frame = frame;
879 }
880
8d2666fe
GM
881 selected_frame = frame;
882 if (! FRAME_MINIBUF_ONLY_P (XFRAME (selected_frame)))
883 last_nonminibuf_frame = XFRAME (selected_frame);
d5e7c279 884
f1321dc3 885 Fselect_window (XFRAME (frame)->selected_window, Qnil);
dc6f92b8 886
074577b8 887 /* We want to make sure that the next event generates a frame-switch
eb8c3be9 888 event to the appropriate frame. This seems kludgy to me, but
074577b8
JB
889 before you take it out, make sure that evaluating something like
890 (select-window (frame-root-window (new-frame))) doesn't end up
891 with your typing being interpreted in the new frame instead of
892 the one you're actually typing in. */
ef352596 893 internal_last_event_frame = Qnil;
074577b8 894
ff11dfa1 895 return frame;
dc6f92b8
JB
896}
897
20dc6fbb 898DEFUN ("select-frame", Fselect_frame, Sselect_frame, 1, 1, "e",
14ff1ee0
PJ
899 doc: /* Select the frame FRAME.
900Subsequent editing commands apply to its selected window.
901The selection of FRAME lasts until the next time the user does
902something to select a different frame, or until the next time this
e4ed805e
LT
903function is called. If you are using a window system, the previously
904selected frame may be restored as the selected frame after return to
905the command loop, because it still may have the window system's input
906focus. On a text-only terminal, the next redisplay will display FRAME.
907
908This function returns FRAME, or nil if FRAME has been deleted. */)
20dc6fbb
LT
909 (frame)
910 Lisp_Object frame;
0aed85f4 911{
1e8324d9 912 return do_switch_frame (frame, 1, 0);
0aed85f4
KH
913}
914
915
20dc6fbb 916DEFUN ("handle-switch-frame", Fhandle_switch_frame, Shandle_switch_frame, 1, 1, "e",
14ff1ee0
PJ
917 doc: /* Handle a switch-frame event EVENT.
918Switch-frame events are usually bound to this function.
919A switch-frame event tells Emacs that the window manager has requested
920that the user's events be directed to the frame mentioned in the event.
921This function selects the selected window of the frame of EVENT.
922
923If EVENT is frame object, handle it as if it were a switch-frame event
924to that frame. */)
20dc6fbb
LT
925 (event)
926 Lisp_Object event;
0aed85f4 927{
6951cd71
KH
928 /* Preserve prefix arg that the command loop just cleared. */
929 current_kboard->Vprefix_arg = Vcurrent_prefix_arg;
e05169e2 930 call1 (Vrun_hooks, Qmouse_leave_buffer_hook);
1e8324d9 931 return do_switch_frame (event, 0, 0);
0aed85f4
KH
932}
933
ff11dfa1 934DEFUN ("selected-frame", Fselected_frame, Sselected_frame, 0, 0, 0,
14ff1ee0
PJ
935 doc: /* Return the frame that is now selected. */)
936 ()
dc6f92b8 937{
8d2666fe 938 return selected_frame;
dc6f92b8 939}
4a7cfafc 940\f
ff11dfa1 941DEFUN ("window-frame", Fwindow_frame, Swindow_frame, 1, 1, 0,
14ff1ee0
PJ
942 doc: /* Return the frame object that window WINDOW is on. */)
943 (window)
dc6f92b8
JB
944 Lisp_Object window;
945{
b7826503 946 CHECK_LIVE_WINDOW (window);
ff11dfa1 947 return XWINDOW (window)->frame;
dc6f92b8
JB
948}
949
ba32f2db 950DEFUN ("frame-first-window", Fframe_first_window, Sframe_first_window, 0, 1, 0,
14ff1ee0
PJ
951 doc: /* Returns the topmost, leftmost window of FRAME.
952If omitted, FRAME defaults to the currently selected frame. */)
953 (frame)
ba32f2db
KH
954 Lisp_Object frame;
955{
956 Lisp_Object w;
957
958 if (NILP (frame))
8d2666fe 959 w = SELECTED_FRAME ()->root_window;
ba32f2db
KH
960 else
961 {
b7826503 962 CHECK_LIVE_FRAME (frame);
ba32f2db
KH
963 w = XFRAME (frame)->root_window;
964 }
965 while (NILP (XWINDOW (w)->buffer))
966 {
967 if (! NILP (XWINDOW (w)->hchild))
968 w = XWINDOW (w)->hchild;
969 else if (! NILP (XWINDOW (w)->vchild))
970 w = XWINDOW (w)->vchild;
971 else
972 abort ();
973 }
974 return w;
975}
976
5add3885
RS
977DEFUN ("active-minibuffer-window", Factive_minibuffer_window,
978 Sactive_minibuffer_window, 0, 0, 0,
14ff1ee0
PJ
979 doc: /* Return the currently active minibuffer window, or nil if none. */)
980 ()
5add3885
RS
981{
982 return minibuf_level ? minibuf_window : Qnil;
983}
984
ff11dfa1 985DEFUN ("frame-root-window", Fframe_root_window, Sframe_root_window, 0, 1, 0,
14ff1ee0
PJ
986 doc: /* Returns the root-window of FRAME.
987If omitted, FRAME defaults to the currently selected frame. */)
988 (frame)
ff11dfa1 989 Lisp_Object frame;
dc6f92b8 990{
8d2666fe 991 Lisp_Object window;
177c0ea7 992
ff11dfa1 993 if (NILP (frame))
8d2666fe 994 window = SELECTED_FRAME ()->root_window;
f9898cc6 995 else
8d2666fe 996 {
b7826503 997 CHECK_LIVE_FRAME (frame);
8d2666fe
GM
998 window = XFRAME (frame)->root_window;
999 }
177c0ea7 1000
8d2666fe 1001 return window;
dc6f92b8
JB
1002}
1003
ff11dfa1
JB
1004DEFUN ("frame-selected-window", Fframe_selected_window,
1005 Sframe_selected_window, 0, 1, 0,
14ff1ee0
PJ
1006 doc: /* Return the selected window of frame object FRAME.
1007If omitted, FRAME defaults to the currently selected frame. */)
1008 (frame)
ff11dfa1 1009 Lisp_Object frame;
dc6f92b8 1010{
8d2666fe 1011 Lisp_Object window;
177c0ea7 1012
ff11dfa1 1013 if (NILP (frame))
8d2666fe 1014 window = SELECTED_FRAME ()->selected_window;
f9898cc6 1015 else
8d2666fe 1016 {
b7826503 1017 CHECK_LIVE_FRAME (frame);
8d2666fe
GM
1018 window = XFRAME (frame)->selected_window;
1019 }
dc6f92b8 1020
8d2666fe 1021 return window;
dc6f92b8
JB
1022}
1023
4a7cfafc
RS
1024DEFUN ("set-frame-selected-window", Fset_frame_selected_window,
1025 Sset_frame_selected_window, 2, 2, 0,
14ff1ee0 1026 doc: /* Set the selected window of frame object FRAME to WINDOW.
e4ed805e 1027Return WINDOW.
14ff1ee0
PJ
1028If FRAME is nil, the selected frame is used.
1029If FRAME is the selected frame, this makes WINDOW the selected window. */)
1030 (frame, window)
4a7cfafc
RS
1031 Lisp_Object frame, window;
1032{
1033 if (NILP (frame))
8d2666fe 1034 frame = selected_frame;
177c0ea7 1035
b7826503
PJ
1036 CHECK_LIVE_FRAME (frame);
1037 CHECK_LIVE_WINDOW (window);
4a7cfafc
RS
1038
1039 if (! EQ (frame, WINDOW_FRAME (XWINDOW (window))))
1040 error ("In `set-frame-selected-window', WINDOW is not on FRAME");
1041
8d2666fe 1042 if (EQ (frame, selected_frame))
f1321dc3 1043 return Fselect_window (window, Qnil);
4a7cfafc
RS
1044
1045 return XFRAME (frame)->selected_window = window;
1046}
b6660415 1047
4a7cfafc 1048\f
ff11dfa1 1049DEFUN ("frame-list", Fframe_list, Sframe_list,
dc6f92b8 1050 0, 0, 0,
14ff1ee0
PJ
1051 doc: /* Return a list of all frames. */)
1052 ()
dc6f92b8 1053{
d74c1900
GM
1054 Lisp_Object frames;
1055 frames = Fcopy_sequence (Vframe_list);
6a65b1b5 1056#ifdef HAVE_WINDOW_SYSTEM
d74c1900
GM
1057 if (FRAMEP (tip_frame))
1058 frames = Fdelq (tip_frame, frames);
6a65b1b5 1059#endif
d74c1900 1060 return frames;
dc6f92b8
JB
1061}
1062
ff11dfa1 1063/* Return the next frame in the frame list after FRAME.
ff11dfa1 1064 If MINIBUF is nil, exclude minibuffer-only frames.
a9986780
RS
1065 If MINIBUF is a window, include only its own frame
1066 and any frame now using that window as the minibuffer.
f7af3f7b 1067 If MINIBUF is `visible', include all visible frames.
a9986780 1068 If MINIBUF is 0, include all visible and iconified frames.
f7af3f7b
RS
1069 Otherwise, include all frames. */
1070
66a9dbbe 1071static Lisp_Object
ff11dfa1
JB
1072next_frame (frame, minibuf)
1073 Lisp_Object frame;
f9898cc6 1074 Lisp_Object minibuf;
dc6f92b8
JB
1075{
1076 Lisp_Object tail;
1077 int passed = 0;
1078
ff11dfa1
JB
1079 /* There must always be at least one frame in Vframe_list. */
1080 if (! CONSP (Vframe_list))
f9898cc6
JB
1081 abort ();
1082
dbc4e1c1
JB
1083 /* If this frame is dead, it won't be in Vframe_list, and we'll loop
1084 forever. Forestall that. */
b7826503 1085 CHECK_LIVE_FRAME (frame);
dbc4e1c1 1086
dc6f92b8 1087 while (1)
7539e11f 1088 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
dc6f92b8 1089 {
ab9f008d 1090 Lisp_Object f;
d06a8a56 1091
7539e11f 1092 f = XCAR (tail);
06537cc8
RS
1093
1094 if (passed
9628b887
KL
1095 && ((!FRAME_TERMCAP_P (XFRAME (f)) && !FRAME_TERMCAP_P (XFRAME (frame))
1096 && FRAME_KBOARD (XFRAME (f)) == FRAME_KBOARD (XFRAME (frame)))
1097 || (FRAME_TERMCAP_P (XFRAME (f)) && FRAME_TERMCAP_P (XFRAME (frame))
1098 && FRAME_TTY (XFRAME (f)) == FRAME_TTY (XFRAME (frame)))))
d5e7c279 1099 {
d06a8a56
JB
1100 /* Decide whether this frame is eligible to be returned. */
1101
1102 /* If we've looped all the way around without finding any
1103 eligible frames, return the original frame. */
1104 if (EQ (f, frame))
1105 return f;
1106
1107 /* Let minibuf decide if this frame is acceptable. */
1108 if (NILP (minibuf))
1109 {
1110 if (! FRAME_MINIBUF_ONLY_P (XFRAME (f)))
1111 return f;
1112 }
f7af3f7b
RS
1113 else if (EQ (minibuf, Qvisible))
1114 {
1115 FRAME_SAMPLE_VISIBILITY (XFRAME (f));
1116 if (FRAME_VISIBLE_P (XFRAME (f)))
1117 return f;
1118 }
3780bc22 1119 else if (INTEGERP (minibuf) && XINT (minibuf) == 0)
a9986780
RS
1120 {
1121 FRAME_SAMPLE_VISIBILITY (XFRAME (f));
1122 if (FRAME_VISIBLE_P (XFRAME (f))
1123 || FRAME_ICONIFIED_P (XFRAME (f)))
1124 return f;
1125 }
f7af3f7b 1126 else if (WINDOWP (minibuf))
d06a8a56 1127 {
a9986780 1128 if (EQ (FRAME_MINIBUF_WINDOW (XFRAME (f)), minibuf)
551645f8
GM
1129 || EQ (WINDOW_FRAME (XWINDOW (minibuf)), f)
1130 || EQ (WINDOW_FRAME (XWINDOW (minibuf)),
1131 FRAME_FOCUS_FRAME (XFRAME (f))))
d06a8a56
JB
1132 return f;
1133 }
1134 else
ff11dfa1 1135 return f;
d5e7c279 1136 }
dc6f92b8 1137
d06a8a56 1138 if (EQ (frame, f))
dc6f92b8
JB
1139 passed++;
1140 }
1141}
1142
ff11dfa1 1143/* Return the previous frame in the frame list before FRAME.
ff11dfa1 1144 If MINIBUF is nil, exclude minibuffer-only frames.
a9986780
RS
1145 If MINIBUF is a window, include only its own frame
1146 and any frame now using that window as the minibuffer.
f7af3f7b 1147 If MINIBUF is `visible', include all visible frames.
a9986780 1148 If MINIBUF is 0, include all visible and iconified frames.
f7af3f7b
RS
1149 Otherwise, include all frames. */
1150
66a9dbbe 1151static Lisp_Object
ff11dfa1
JB
1152prev_frame (frame, minibuf)
1153 Lisp_Object frame;
f9898cc6 1154 Lisp_Object minibuf;
dc6f92b8
JB
1155{
1156 Lisp_Object tail;
1157 Lisp_Object prev;
1158
ff11dfa1
JB
1159 /* There must always be at least one frame in Vframe_list. */
1160 if (! CONSP (Vframe_list))
f9898cc6
JB
1161 abort ();
1162
dc6f92b8 1163 prev = Qnil;
7539e11f 1164 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
f9898cc6 1165 {
ab9f008d 1166 Lisp_Object f;
f9898cc6 1167
7539e11f 1168 f = XCAR (tail);
e35d291d 1169 if (!FRAMEP (f))
d06a8a56 1170 abort ();
f9898cc6 1171
d06a8a56
JB
1172 if (EQ (frame, f) && !NILP (prev))
1173 return prev;
f9898cc6 1174
9628b887
KL
1175 if ((!FRAME_TERMCAP_P (XFRAME (f)) && !FRAME_TERMCAP_P (XFRAME (frame))
1176 && FRAME_KBOARD (XFRAME (f)) == FRAME_KBOARD (XFRAME (frame)))
1177 || (FRAME_TERMCAP_P (XFRAME (f)) && FRAME_TERMCAP_P (XFRAME (frame))
1178 && FRAME_TTY (XFRAME (f)) == FRAME_TTY (XFRAME (frame))))
f7af3f7b 1179 {
06537cc8
RS
1180 /* Decide whether this frame is eligible to be returned,
1181 according to minibuf. */
1182 if (NILP (minibuf))
1183 {
1184 if (! FRAME_MINIBUF_ONLY_P (XFRAME (f)))
1185 prev = f;
1186 }
1187 else if (WINDOWP (minibuf))
1188 {
1189 if (EQ (FRAME_MINIBUF_WINDOW (XFRAME (f)), minibuf)
551645f8
GM
1190 || EQ (WINDOW_FRAME (XWINDOW (minibuf)), f)
1191 || EQ (WINDOW_FRAME (XWINDOW (minibuf)),
1192 FRAME_FOCUS_FRAME (XFRAME (f))))
06537cc8
RS
1193 prev = f;
1194 }
1195 else if (EQ (minibuf, Qvisible))
1196 {
1197 FRAME_SAMPLE_VISIBILITY (XFRAME (f));
1198 if (FRAME_VISIBLE_P (XFRAME (f)))
1199 prev = f;
1200 }
1201 else if (XFASTINT (minibuf) == 0)
1202 {
1203 FRAME_SAMPLE_VISIBILITY (XFRAME (f));
1204 if (FRAME_VISIBLE_P (XFRAME (f))
1205 || FRAME_ICONIFIED_P (XFRAME (f)))
1206 prev = f;
1207 }
1208 else
a9986780
RS
1209 prev = f;
1210 }
f9898cc6 1211 }
d06a8a56
JB
1212
1213 /* We've scanned the entire list. */
1214 if (NILP (prev))
1215 /* We went through the whole frame list without finding a single
1216 acceptable frame. Return the original frame. */
1217 return frame;
1218 else
1219 /* There were no acceptable frames in the list before FRAME; otherwise,
1220 we would have returned directly from the loop. Since PREV is the last
1221 acceptable frame in the list, return it. */
1222 return prev;
dc6f92b8
JB
1223}
1224
ef2c57ac 1225
ff11dfa1 1226DEFUN ("next-frame", Fnext_frame, Snext_frame, 0, 2, 0,
14ff1ee0
PJ
1227 doc: /* Return the next frame in the frame list after FRAME.
1228It considers only frames on the same terminal as FRAME.
1229By default, skip minibuffer-only frames.
1230If omitted, FRAME defaults to the selected frame.
1231If optional argument MINIFRAME is nil, exclude minibuffer-only frames.
1232If MINIFRAME is a window, include only its own frame
1233and any frame now using that window as the minibuffer.
1234If MINIFRAME is `visible', include all visible frames.
1235If MINIFRAME is 0, include all visible and iconified frames.
1236Otherwise, include all frames. */)
1237 (frame, miniframe)
8693ca83 1238 Lisp_Object frame, miniframe;
dc6f92b8 1239{
ff11dfa1 1240 if (NILP (frame))
8d2666fe 1241 frame = selected_frame;
177c0ea7 1242
b7826503 1243 CHECK_LIVE_FRAME (frame);
ff11dfa1 1244 return next_frame (frame, miniframe);
dc6f92b8 1245}
dbc4e1c1 1246
ef2c57ac 1247DEFUN ("previous-frame", Fprevious_frame, Sprevious_frame, 0, 2, 0,
14ff1ee0
PJ
1248 doc: /* Return the previous frame in the frame list before FRAME.
1249It considers only frames on the same terminal as FRAME.
1250By default, skip minibuffer-only frames.
1251If omitted, FRAME defaults to the selected frame.
1252If optional argument MINIFRAME is nil, exclude minibuffer-only frames.
1253If MINIFRAME is a window, include only its own frame
1254and any frame now using that window as the minibuffer.
1255If MINIFRAME is `visible', include all visible frames.
1256If MINIFRAME is 0, include all visible and iconified frames.
1257Otherwise, include all frames. */)
1258 (frame, miniframe)
ef2c57ac
RM
1259 Lisp_Object frame, miniframe;
1260{
ef2c57ac 1261 if (NILP (frame))
8d2666fe 1262 frame = selected_frame;
b7826503 1263 CHECK_LIVE_FRAME (frame);
ef2c57ac
RM
1264 return prev_frame (frame, miniframe);
1265}
dc6f92b8 1266\f
808c0f20
RS
1267/* Return 1 if it is ok to delete frame F;
1268 0 if all frames aside from F are invisible.
1269 (Exception: if F is the terminal frame, and we are using X, return 1.) */
dc6f92b8 1270
d56b45eb 1271int
808c0f20
RS
1272other_visible_frames (f)
1273 FRAME_PTR f;
1274{
1275 /* We know the selected frame is visible,
1276 so if F is some other frame, it can't be the sole visible one. */
8d2666fe 1277 if (f == SELECTED_FRAME ())
c08c95c7
RS
1278 {
1279 Lisp_Object frames;
1280 int count = 0;
1281
1282 for (frames = Vframe_list;
1283 CONSP (frames);
7539e11f 1284 frames = XCDR (frames))
c08c95c7 1285 {
ab9f008d 1286 Lisp_Object this;
c08c95c7 1287
7539e11f 1288 this = XCAR (frames);
808c0f20
RS
1289 /* Verify that the frame's window still exists
1290 and we can still talk to it. And note any recent change
1291 in visibility. */
032d78fe
GV
1292#ifdef HAVE_WINDOW_SYSTEM
1293 if (FRAME_WINDOW_P (XFRAME (this)))
5e7b7c5b 1294 {
b0509a40 1295 x_sync (XFRAME (this));
5e7b7c5b
RS
1296 FRAME_SAMPLE_VISIBILITY (XFRAME (this));
1297 }
1298#endif
1299
c08c95c7
RS
1300 if (FRAME_VISIBLE_P (XFRAME (this))
1301 || FRAME_ICONIFIED_P (XFRAME (this))
1302 /* Allow deleting the terminal frame when at least
1303 one X frame exists! */
032d78fe 1304 || (FRAME_WINDOW_P (XFRAME (this)) && !FRAME_WINDOW_P (f)))
c08c95c7
RS
1305 count++;
1306 }
808c0f20 1307 return count > 1;
c08c95c7 1308 }
808c0f20
RS
1309 return 1;
1310}
1311
ea161626
KL
1312/* Error handler for `delete-frame-functions'. */
1313static Lisp_Object
1314delete_frame_handler (Lisp_Object arg)
1315{
1316 add_to_log ("Error during `delete-frame': %s", arg, Qnil);
1317 return Qnil;
1318}
1319
58555d81
SM
1320extern Lisp_Object Qrun_hook_with_args;
1321
808c0f20 1322DEFUN ("delete-frame", Fdelete_frame, Sdelete_frame, 0, 2, "",
14ff1ee0
PJ
1323 doc: /* Delete FRAME, permanently eliminating it from use.
1324If omitted, FRAME defaults to the selected frame.
1325A frame may not be deleted if its minibuffer is used by other frames.
1326Normally, you may not delete a frame if all other frames are invisible,
1327but if the second optional argument FORCE is non-nil, you may do so.
1328
cd1d850f
JPW
1329This function runs `delete-frame-functions' before actually deleting the
1330frame, unless the frame is a tooltip.
a31787b1
RS
1331The functions are run with one arg, the frame to be deleted.
1332But FORCE inhibits this too. */)
1333/* FORCE is non-nil when handling a disconnected terminal. */
14ff1ee0 1334 (frame, force)
808c0f20
RS
1335 Lisp_Object frame, force;
1336{
1337 struct frame *f;
8d2666fe 1338 struct frame *sf = SELECTED_FRAME ();
bedb9c0e
KL
1339 struct kboard *kb;
1340
99b92e64 1341 int minibuffer_selected;
808c0f20
RS
1342
1343 if (EQ (frame, Qnil))
1344 {
8d2666fe 1345 f = sf;
2d80a27a 1346 XSETFRAME (frame, f);
808c0f20
RS
1347 }
1348 else
1349 {
b7826503 1350 CHECK_FRAME (frame);
808c0f20
RS
1351 f = XFRAME (frame);
1352 }
1353
1354 if (! FRAME_LIVE_P (f))
1355 return Qnil;
1356
e39a993c 1357 if (NILP (force) && !other_visible_frames (f))
808c0f20 1358 error ("Attempt to delete the sole visible or iconified frame");
d5e7c279 1359
00c5fd51
RS
1360#if 0
1361 /* This is a nice idea, but x_connection_closed needs to be able
1362 to delete the last frame, if it is gone. */
7539e11f 1363 if (NILP (XCDR (Vframe_list)))
e9687ee8 1364 error ("Attempt to delete the only frame");
00c5fd51 1365#endif
e9687ee8 1366
ff11dfa1
JB
1367 /* Does this frame have a minibuffer, and is it the surrogate
1368 minibuffer for any other frame? */
fd0c2bd1 1369 if (FRAME_HAS_MINIBUF_P (XFRAME (frame)))
dc6f92b8 1370 {
ff11dfa1 1371 Lisp_Object frames;
1113d9db 1372
ff11dfa1
JB
1373 for (frames = Vframe_list;
1374 CONSP (frames);
7539e11f 1375 frames = XCDR (frames))
1113d9db 1376 {
7a8cc307 1377 Lisp_Object this;
7539e11f 1378 this = XCAR (frames);
1113d9db 1379
ff11dfa1
JB
1380 if (! EQ (this, frame)
1381 && EQ (frame,
7a8cc307
RS
1382 WINDOW_FRAME (XWINDOW
1383 (FRAME_MINIBUF_WINDOW (XFRAME (this))))))
a31787b1
RS
1384 {
1385 /* If we MUST delete this frame, delete the other first. */
1386 if (!NILP (force))
1387 Fdelete_frame (this, force);
1388 else
1389 error ("Attempt to delete a surrogate minibuffer frame");
1390 }
1113d9db 1391 }
dc6f92b8
JB
1392 }
1393
a31787b1 1394 /* Run `delete-frame-functions'
c53956fe
SM
1395 unless FORCE is `noelisp' or frame is a tooltip.
1396 FORCE is set to `noelisp' when handling a disconnect from the terminal,
a31787b1 1397 so we don't dare call Lisp code. */
58555d81
SM
1398 if (NILP (Vrun_hooks) || !NILP (Fframe_parameter (frame, intern ("tooltip"))))
1399 ;
1400 if (EQ (force, Qnoelisp))
1401 pending_funcalls
1402 = Fcons (list3 (Qrun_hook_with_args, Qdelete_frame_functions, frame),
1403 pending_funcalls);
1404 else
1405 safe_call2 (Qrun_hook_with_args, Qdelete_frame_functions, frame);
0e662342 1406
b6660415
KL
1407 /* The hook may sometimes (indirectly) cause the frame to be deleted. */
1408 if (! FRAME_LIVE_P (f))
1409 return Qnil;
1410
a31787b1
RS
1411 /* At this point, we are committed to deleting the frame.
1412 There is no more chance for errors to prevent it. */
1413
99b92e64
RS
1414 minibuffer_selected = EQ (minibuf_window, selected_window);
1415
ff11dfa1 1416 /* Don't let the frame remain selected. */
8d2666fe 1417 if (f == sf)
06537cc8
RS
1418 {
1419 Lisp_Object tail, frame1;
1420
1421 /* Look for another visible frame on the same terminal. */
1422 frame1 = next_frame (frame, Qvisible);
1423
1424 /* If there is none, find *some* other frame. */
1425 if (NILP (frame1) || EQ (frame1, frame))
1426 {
1427 FOR_EACH_FRAME (tail, frame1)
1428 {
fca177d4 1429 if (! EQ (frame, frame1) && FRAME_LIVE_P (XFRAME (frame1)))
06537cc8
RS
1430 break;
1431 }
1432 }
1433
1e8324d9 1434 do_switch_frame (frame1, 0, 1);
79a65b7f 1435 sf = SELECTED_FRAME ();
06537cc8 1436 }
dc6f92b8 1437
ff11dfa1
JB
1438 /* Don't allow minibuf_window to remain on a deleted frame. */
1439 if (EQ (f->minibuffer_window, minibuf_window))
dc6f92b8 1440 {
8d2666fe 1441 Fset_window_buffer (sf->minibuffer_window,
5af5757b 1442 XWINDOW (minibuf_window)->buffer, Qnil);
8d2666fe 1443 minibuf_window = sf->minibuffer_window;
99b92e64
RS
1444
1445 /* If the dying minibuffer window was selected,
1446 select the new one. */
1447 if (minibuffer_selected)
f1321dc3 1448 Fselect_window (minibuf_window, Qnil);
dc6f92b8
JB
1449 }
1450
130adcb7
EZ
1451 /* Don't let echo_area_window to remain on a deleted frame. */
1452 if (EQ (f->minibuffer_window, echo_area_window))
1453 echo_area_window = sf->minibuffer_window;
1454
bb2a0a65
RS
1455 /* Clear any X selections for this frame. */
1456#ifdef HAVE_X_WINDOWS
1457 if (FRAME_X_P (f))
1458 x_clear_frame_selections (f);
1459#endif
f706a7b2
YM
1460#ifdef MAC_OS
1461 if (FRAME_MAC_P (f))
1462 x_clear_frame_selections (f);
1463#endif
bb2a0a65 1464
177c0ea7
JB
1465 /* Free glyphs.
1466 This function must be called before the window tree of the
18082e2d
GM
1467 frame is deleted because windows contain dynamically allocated
1468 memory. */
1469 free_glyphs (f);
1470
d0167372 1471#ifdef USE_FONT_BACKEND
50e3873c
KH
1472 /* Give chance to each font driver to free a frame specific data. */
1473 font_update_drivers (f, Qnil);
d0167372 1474#endif /* USE_FONT_BACKEND */
50e3873c 1475
4a88b3b0
JB
1476 /* Mark all the windows that used to be on FRAME as deleted, and then
1477 remove the reference to them. */
1478 delete_all_subwindows (XWINDOW (f->root_window));
1479 f->root_window = Qnil;
1480
ff11dfa1 1481 Vframe_list = Fdelq (frame, Vframe_list);
a42e9724 1482 FRAME_SET_VISIBLE (f, 0);
dc6f92b8 1483
60a8823e 1484 if (f->namebuf)
18082e2d 1485 xfree (f->namebuf);
6b61353c
KH
1486 if (f->decode_mode_spec_buffer)
1487 xfree (f->decode_mode_spec_buffer);
d2bee99e 1488 if (FRAME_INSERT_COST (f))
18082e2d 1489 xfree (FRAME_INSERT_COST (f));
d2bee99e 1490 if (FRAME_DELETEN_COST (f))
18082e2d 1491 xfree (FRAME_DELETEN_COST (f));
d2bee99e 1492 if (FRAME_INSERTN_COST (f))
18082e2d 1493 xfree (FRAME_INSERTN_COST (f));
d2bee99e 1494 if (FRAME_DELETE_COST (f))
18082e2d 1495 xfree (FRAME_DELETE_COST (f));
25734faf 1496 if (FRAME_MESSAGE_BUF (f))
18082e2d 1497 xfree (FRAME_MESSAGE_BUF (f));
d2bee99e 1498
8678b9cc 1499 /* Since some events are handled at the interrupt level, we may get
6ed8eeff 1500 an event for f at any time; if we zero out the frame's terminal
8678b9cc 1501 now, then we may trip up the event-handling code. Instead, we'll
6ed8eeff
KL
1502 promise that the terminal of the frame must be valid until we
1503 have called the window-system-dependent frame destruction
1504 routine. */
dbc4e1c1 1505
6ed8eeff
KL
1506 if (FRAME_TERMINAL (f)->delete_frame_hook)
1507 (*FRAME_TERMINAL (f)->delete_frame_hook) (f);
d5e7c279 1508
428a555e 1509 {
6ed8eeff 1510 struct terminal *terminal = FRAME_TERMINAL (f);
a3547743 1511 f->output_data.nothing = 0;
6ed8eeff 1512 f->terminal = 0; /* Now the frame is dead. */
428a555e 1513
6ed8eeff 1514 /* If needed, delete the terminal that this frame was on.
bedb9c0e 1515 (This must be done after the frame is killed.) */
6ed8eeff
KL
1516 terminal->reference_count--;
1517 if (terminal->reference_count == 0)
bedb9c0e 1518 {
174105f7
SM
1519 Lisp_Object tmp;
1520 XSETTERMINAL (tmp, terminal);
1521
bedb9c0e 1522 kb = NULL;
174105f7 1523 Fdelete_terminal (tmp, NILP (force) ? Qt : force);
bedb9c0e 1524 }
7e166218 1525#ifdef MULTI_KBOARD
bedb9c0e 1526 else
6ed8eeff 1527 kb = terminal->kboard;
7e166218 1528#endif
428a555e 1529 }
8678b9cc 1530
ff11dfa1 1531 /* If we've deleted the last_nonminibuf_frame, then try to find
d5e7c279 1532 another one. */
ff11dfa1 1533 if (f == last_nonminibuf_frame)
d5e7c279 1534 {
ff11dfa1 1535 Lisp_Object frames;
1113d9db 1536
ff11dfa1 1537 last_nonminibuf_frame = 0;
d5e7c279 1538
ff11dfa1
JB
1539 for (frames = Vframe_list;
1540 CONSP (frames);
7539e11f 1541 frames = XCDR (frames))
d5e7c279 1542 {
7539e11f 1543 f = XFRAME (XCAR (frames));
ff11dfa1 1544 if (!FRAME_MINIBUF_ONLY_P (f))
d5e7c279 1545 {
ff11dfa1 1546 last_nonminibuf_frame = f;
d5e7c279
JB
1547 break;
1548 }
1549 }
1550 }
dc6f92b8 1551
8ceb7434
RS
1552 /* If there's no other frame on the same kboard, get out of
1553 single-kboard state if we're in it for this kboard. */
bedb9c0e
KL
1554 if (kb != NULL)
1555 {
1556 Lisp_Object frames;
1557 /* Some frame we found on the same kboard, or nil if there are none. */
1558 Lisp_Object frame_on_same_kboard;
8ceb7434 1559
bedb9c0e 1560 frame_on_same_kboard = Qnil;
8ceb7434 1561
bedb9c0e
KL
1562 for (frames = Vframe_list;
1563 CONSP (frames);
1564 frames = XCDR (frames))
1565 {
1566 Lisp_Object this;
1567 struct frame *f1;
8ceb7434 1568
bedb9c0e
KL
1569 this = XCAR (frames);
1570 if (!FRAMEP (this))
1571 abort ();
1572 f1 = XFRAME (this);
8ceb7434 1573
bedb9c0e
KL
1574 if (kb == FRAME_KBOARD (f1))
1575 frame_on_same_kboard = this;
1576 }
8ceb7434 1577
bedb9c0e
KL
1578 if (NILP (frame_on_same_kboard))
1579 not_single_kboard_state (kb);
1580 }
8ceb7434
RS
1581
1582
c4c6d073
KH
1583 /* If we've deleted this keyboard's default_minibuffer_frame, try to
1584 find another one. Prefer minibuffer-only frames, but also notice
1585 frames with other windows. */
bedb9c0e 1586 if (kb != NULL && EQ (frame, kb->Vdefault_minibuffer_frame))
1113d9db 1587 {
ff11dfa1 1588 Lisp_Object frames;
1113d9db 1589
ff11dfa1 1590 /* The last frame we saw with a minibuffer, minibuffer-only or not. */
ab9f008d 1591 Lisp_Object frame_with_minibuf;
32fda9ba
RS
1592 /* Some frame we found on the same kboard, or nil if there are none. */
1593 Lisp_Object frame_on_same_kboard;
1113d9db 1594
32fda9ba 1595 frame_on_same_kboard = Qnil;
ab9f008d 1596 frame_with_minibuf = Qnil;
32fda9ba 1597
ff11dfa1
JB
1598 for (frames = Vframe_list;
1599 CONSP (frames);
7539e11f 1600 frames = XCDR (frames))
1113d9db 1601 {
ab9f008d 1602 Lisp_Object this;
c4c6d073 1603 struct frame *f1;
1113d9db 1604
7539e11f 1605 this = XCAR (frames);
e35d291d 1606 if (!FRAMEP (this))
1113d9db 1607 abort ();
c4c6d073 1608 f1 = XFRAME (this);
1113d9db 1609
c4c6d073
KH
1610 /* Consider only frames on the same kboard
1611 and only those with minibuffers. */
bedb9c0e 1612 if (kb == FRAME_KBOARD (f1)
c4c6d073 1613 && FRAME_HAS_MINIBUF_P (f1))
1113d9db 1614 {
ff11dfa1 1615 frame_with_minibuf = this;
c4c6d073 1616 if (FRAME_MINIBUF_ONLY_P (f1))
1113d9db
JB
1617 break;
1618 }
32fda9ba 1619
bedb9c0e 1620 if (kb == FRAME_KBOARD (f1))
32fda9ba 1621 frame_on_same_kboard = this;
1113d9db
JB
1622 }
1623
32fda9ba
RS
1624 if (!NILP (frame_on_same_kboard))
1625 {
1626 /* We know that there must be some frame with a minibuffer out
1627 there. If this were not true, all of the frames present
1628 would have to be minibufferless, which implies that at some
1629 point their minibuffer frames must have been deleted, but
1630 that is prohibited at the top; you can't delete surrogate
1631 minibuffer frames. */
1632 if (NILP (frame_with_minibuf))
1633 abort ();
1113d9db 1634
bedb9c0e 1635 kb->Vdefault_minibuffer_frame = frame_with_minibuf;
32fda9ba
RS
1636 }
1637 else
1638 /* No frames left on this kboard--say no minibuffer either. */
bedb9c0e 1639 kb->Vdefault_minibuffer_frame = Qnil;
1113d9db
JB
1640 }
1641
e681c92a
RS
1642 /* Cause frame titles to update--necessary if we now have just one frame. */
1643 update_mode_lines = 1;
1644
dc6f92b8
JB
1645 return Qnil;
1646}
1647\f
1648/* Return mouse position in character cell units. */
1649
f9898cc6 1650DEFUN ("mouse-position", Fmouse_position, Smouse_position, 0, 0, 0,
14ff1ee0
PJ
1651 doc: /* Return a list (FRAME X . Y) giving the current mouse frame and position.
1652The position is given in character cells, where (0, 0) is the
d0cd961e
EZ
1653upper-left corner of the frame, X is the horizontal offset, and Y is
1654the vertical offset.
14ff1ee0
PJ
1655If Emacs is running on a mouseless terminal or hasn't been programmed
1656to read the mouse position, it returns the selected frame for FRAME
1657and nil for X and Y.
1658If `mouse-position-function' is non-nil, `mouse-position' calls it,
1659passing the normal return value to that function as an argument,
1660and returns whatever that function returns. */)
1661 ()
dc6f92b8 1662{
ff11dfa1 1663 FRAME_PTR f;
dbc4e1c1 1664 Lisp_Object lispy_dummy;
fd2777e0 1665 enum scroll_bar_part party_dummy;
beb0bc36 1666 Lisp_Object x, y, retval;
5384466a 1667 int col, row;
dbc4e1c1 1668 unsigned long long_dummy;
cb2255b3 1669 struct gcpro gcpro1;
dc6f92b8 1670
8d2666fe 1671 f = SELECTED_FRAME ();
c5074d8c
RS
1672 x = y = Qnil;
1673
67f6e31c 1674#if defined (HAVE_MOUSE) || defined (HAVE_GPM)
c5074d8c 1675 /* It's okay for the hook to refrain from storing anything. */
6ed8eeff
KL
1676 if (FRAME_TERMINAL (f)->mouse_position_hook)
1677 (*FRAME_TERMINAL (f)->mouse_position_hook) (&f, -1,
1678 &lispy_dummy, &party_dummy,
1679 &x, &y,
1680 &long_dummy);
76db7eb4
KH
1681 if (! NILP (x))
1682 {
1683 col = XINT (x);
1684 row = XINT (y);
8126c3b4 1685 pixel_to_glyph_coords (f, col, row, &col, &row, NULL, 1);
76db7eb4
KH
1686 XSETINT (x, col);
1687 XSETINT (y, row);
1688 }
f443c170 1689#endif
2d80a27a 1690 XSETFRAME (lispy_dummy, f);
beb0bc36 1691 retval = Fcons (lispy_dummy, Fcons (x, y));
cb2255b3 1692 GCPRO1 (retval);
beb0bc36 1693 if (!NILP (Vmouse_position_function))
cb2255b3
GM
1694 retval = call1 (Vmouse_position_function, retval);
1695 RETURN_UNGCPRO (retval);
dc6f92b8
JB
1696}
1697
152e6c70
RS
1698DEFUN ("mouse-pixel-position", Fmouse_pixel_position,
1699 Smouse_pixel_position, 0, 0, 0,
14ff1ee0
PJ
1700 doc: /* Return a list (FRAME X . Y) giving the current mouse frame and position.
1701The position is given in pixel units, where (0, 0) is the
d0cd961e
EZ
1702upper-left corner of the frame, X is the horizontal offset, and Y is
1703the vertical offset.
14ff1ee0
PJ
1704If Emacs is running on a mouseless terminal or hasn't been programmed
1705to read the mouse position, it returns the selected frame for FRAME
1706and nil for X and Y. */)
1707 ()
152e6c70
RS
1708{
1709 FRAME_PTR f;
1710 Lisp_Object lispy_dummy;
1711 enum scroll_bar_part party_dummy;
1712 Lisp_Object x, y;
152e6c70
RS
1713 unsigned long long_dummy;
1714
8d2666fe 1715 f = SELECTED_FRAME ();
152e6c70
RS
1716 x = y = Qnil;
1717
67f6e31c 1718#if defined (HAVE_MOUSE) || defined (HAVE_GPM)
152e6c70 1719 /* It's okay for the hook to refrain from storing anything. */
6ed8eeff
KL
1720 if (FRAME_TERMINAL (f)->mouse_position_hook)
1721 (*FRAME_TERMINAL (f)->mouse_position_hook) (&f, -1,
1722 &lispy_dummy, &party_dummy,
1723 &x, &y,
1724 &long_dummy);
0c5c1cf7 1725#endif
2d80a27a 1726 XSETFRAME (lispy_dummy, f);
152e6c70
RS
1727 return Fcons (lispy_dummy, Fcons (x, y));
1728}
1729
dc6f92b8 1730DEFUN ("set-mouse-position", Fset_mouse_position, Sset_mouse_position, 3, 3, 0,
14ff1ee0
PJ
1731 doc: /* Move the mouse pointer to the center of character cell (X,Y) in FRAME.
1732Coordinates are relative to the frame, not a window,
1733so the coordinates of the top left character in the frame
1734may be nonzero due to left-hand scroll bars or the menu bar.
1735
d0cd961e
EZ
1736The position is given in character cells, where (0, 0) is the
1737upper-left corner of the frame, X is the horizontal offset, and Y is
1738the vertical offset.
1739
14ff1ee0
PJ
1740This function is a no-op for an X frame that is not visible.
1741If you have just created a frame, you must wait for it to become visible
1742before calling this function on it, like this.
1743 (while (not (frame-visible-p frame)) (sleep-for .5)) */)
ff11dfa1
JB
1744 (frame, x, y)
1745 Lisp_Object frame, x, y;
dc6f92b8 1746{
b7826503
PJ
1747 CHECK_LIVE_FRAME (frame);
1748 CHECK_NUMBER (x);
1749 CHECK_NUMBER (y);
dc6f92b8 1750
dbc4e1c1 1751 /* I think this should be done with a hook. */
032d78fe
GV
1752#ifdef HAVE_WINDOW_SYSTEM
1753 if (FRAME_WINDOW_P (XFRAME (frame)))
d19be8a9 1754 /* Warping the mouse will cause enternotify and focus events. */
d4d76014 1755 x_set_mouse_position (XFRAME (frame), XINT (x), XINT (y));
bb221971 1756#else
be625e00 1757#if defined (MSDOS) && defined (HAVE_MOUSE)
bb221971
RS
1758 if (FRAME_MSDOS_P (XFRAME (frame)))
1759 {
20dc6fbb 1760 Fselect_frame (frame);
bb221971
RS
1761 mouse_moveto (XINT (x), XINT (y));
1762 }
4d1d51d2
NR
1763#else
1764#ifdef HAVE_GPM
1765 {
1766 Fselect_frame (frame);
1767 term_mouse_moveto (XINT (x), XINT (y));
1768 }
1769#endif
bb221971 1770#endif
dc6f92b8
JB
1771#endif
1772
1773 return Qnil;
1774}
152e6c70
RS
1775
1776DEFUN ("set-mouse-pixel-position", Fset_mouse_pixel_position,
1777 Sset_mouse_pixel_position, 3, 3, 0,
14ff1ee0 1778 doc: /* Move the mouse pointer to pixel position (X,Y) in FRAME.
d0cd961e
EZ
1779The position is given in pixels, where (0, 0) is the upper-left corner
1780of the frame, X is the horizontal offset, and Y is the vertical offset.
1781
14ff1ee0
PJ
1782Note, this is a no-op for an X frame that is not visible.
1783If you have just created a frame, you must wait for it to become visible
1784before calling this function on it, like this.
1785 (while (not (frame-visible-p frame)) (sleep-for .5)) */)
152e6c70
RS
1786 (frame, x, y)
1787 Lisp_Object frame, x, y;
1788{
b7826503
PJ
1789 CHECK_LIVE_FRAME (frame);
1790 CHECK_NUMBER (x);
1791 CHECK_NUMBER (y);
152e6c70
RS
1792
1793 /* I think this should be done with a hook. */
032d78fe
GV
1794#ifdef HAVE_WINDOW_SYSTEM
1795 if (FRAME_WINDOW_P (XFRAME (frame)))
d19be8a9 1796 /* Warping the mouse will cause enternotify and focus events. */
d4d76014 1797 x_set_mouse_pixel_position (XFRAME (frame), XINT (x), XINT (y));
bb221971 1798#else
be625e00 1799#if defined (MSDOS) && defined (HAVE_MOUSE)
bb221971
RS
1800 if (FRAME_MSDOS_P (XFRAME (frame)))
1801 {
20dc6fbb 1802 Fselect_frame (frame);
bb221971
RS
1803 mouse_moveto (XINT (x), XINT (y));
1804 }
67f6e31c
NR
1805#else
1806#ifdef HAVE_GPM
1807 {
1808 Fselect_frame (frame);
1809 term_mouse_moveto (XINT (x), XINT (y));
1810 }
1811#endif
bb221971 1812#endif
152e6c70
RS
1813#endif
1814
1815 return Qnil;
1816}
dc6f92b8 1817\f
98ce1622
RS
1818static void make_frame_visible_1 P_ ((Lisp_Object));
1819
ff11dfa1 1820DEFUN ("make-frame-visible", Fmake_frame_visible, Smake_frame_visible,
fc25d15d 1821 0, 1, "",
14ff1ee0
PJ
1822 doc: /* Make the frame FRAME visible (assuming it is an X window).
1823If omitted, FRAME defaults to the currently selected frame. */)
1824 (frame)
ff11dfa1 1825 Lisp_Object frame;
dc6f92b8 1826{
1aa66088 1827 if (NILP (frame))
8d2666fe 1828 frame = selected_frame;
1aa66088 1829
b7826503 1830 CHECK_LIVE_FRAME (frame);
dc6f92b8 1831
dbc4e1c1 1832 /* I think this should be done with a hook. */
032d78fe
GV
1833#ifdef HAVE_WINDOW_SYSTEM
1834 if (FRAME_WINDOW_P (XFRAME (frame)))
02ff9dd5
RS
1835 {
1836 FRAME_SAMPLE_VISIBILITY (XFRAME (frame));
1837 x_make_frame_visible (XFRAME (frame));
1838 }
fd0c2bd1 1839#endif
dc6f92b8 1840
98ce1622
RS
1841 make_frame_visible_1 (XFRAME (frame)->root_window);
1842
d19be8a9 1843 /* Make menu bar update for the Buffers and Frames menus. */
565620a5
RS
1844 windows_or_buffers_changed++;
1845
ff11dfa1 1846 return frame;
dc6f92b8
JB
1847}
1848
98ce1622
RS
1849/* Update the display_time slot of the buffers shown in WINDOW
1850 and all its descendents. */
1851
1852static void
1853make_frame_visible_1 (window)
1854 Lisp_Object window;
1855{
1856 struct window *w;
1857
1858 for (;!NILP (window); window = w->next)
1859 {
1860 w = XWINDOW (window);
1861
1862 if (!NILP (w->buffer))
1863 XBUFFER (w->buffer)->display_time = Fcurrent_time ();
1864
1865 if (!NILP (w->vchild))
1866 make_frame_visible_1 (w->vchild);
1867 if (!NILP (w->hchild))
1868 make_frame_visible_1 (w->hchild);
1869 }
1870}
1871
ff11dfa1 1872DEFUN ("make-frame-invisible", Fmake_frame_invisible, Smake_frame_invisible,
808c0f20 1873 0, 2, "",
14ff1ee0
PJ
1874 doc: /* Make the frame FRAME invisible (assuming it is an X window).
1875If omitted, FRAME defaults to the currently selected frame.
1876Normally you may not make FRAME invisible if all other frames are invisible,
1877but if the second optional argument FORCE is non-nil, you may do so. */)
808c0f20
RS
1878 (frame, force)
1879 Lisp_Object frame, force;
dc6f92b8 1880{
1aa66088 1881 if (NILP (frame))
8d2666fe 1882 frame = selected_frame;
1aa66088 1883
b7826503 1884 CHECK_LIVE_FRAME (frame);
dc6f92b8 1885
808c0f20
RS
1886 if (NILP (force) && !other_visible_frames (XFRAME (frame)))
1887 error ("Attempt to make invisible the sole visible or iconified frame");
1888
3d378fdf 1889#if 0 /* This isn't logically necessary, and it can do GC. */
9c394f17 1890 /* Don't let the frame remain selected. */
8d2666fe 1891 if (EQ (frame, selected_frame))
1e8324d9 1892 do_switch_frame (next_frame (frame, Qt), 0, 0)
3d378fdf 1893#endif
9c394f17
RS
1894
1895 /* Don't allow minibuf_window to remain on a deleted frame. */
1896 if (EQ (XFRAME (frame)->minibuffer_window, minibuf_window))
1897 {
8d2666fe
GM
1898 struct frame *sf = XFRAME (selected_frame);
1899 Fset_window_buffer (sf->minibuffer_window,
5af5757b 1900 XWINDOW (minibuf_window)->buffer, Qnil);
8d2666fe 1901 minibuf_window = sf->minibuffer_window;
9c394f17
RS
1902 }
1903
dbc4e1c1 1904 /* I think this should be done with a hook. */
032d78fe
GV
1905#ifdef HAVE_WINDOW_SYSTEM
1906 if (FRAME_WINDOW_P (XFRAME (frame)))
ff11dfa1 1907 x_make_frame_invisible (XFRAME (frame));
fd0c2bd1 1908#endif
dc6f92b8 1909
d19be8a9 1910 /* Make menu bar update for the Buffers and Frames menus. */
565620a5
RS
1911 windows_or_buffers_changed++;
1912
dc6f92b8
JB
1913 return Qnil;
1914}
1915
ff11dfa1 1916DEFUN ("iconify-frame", Ficonify_frame, Siconify_frame,
1aa66088 1917 0, 1, "",
14ff1ee0
PJ
1918 doc: /* Make the frame FRAME into an icon.
1919If omitted, FRAME defaults to the currently selected frame. */)
ff11dfa1
JB
1920 (frame)
1921 Lisp_Object frame;
dc6f92b8 1922{
1aa66088 1923 if (NILP (frame))
8d2666fe 1924 frame = selected_frame;
177c0ea7 1925
b7826503 1926 CHECK_LIVE_FRAME (frame);
dc6f92b8 1927
3d378fdf 1928#if 0 /* This isn't logically necessary, and it can do GC. */
9c394f17 1929 /* Don't let the frame remain selected. */
8d2666fe 1930 if (EQ (frame, selected_frame))
20dc6fbb 1931 Fhandle_switch_frame (next_frame (frame, Qt));
3d378fdf 1932#endif
9c394f17
RS
1933
1934 /* Don't allow minibuf_window to remain on a deleted frame. */
1935 if (EQ (XFRAME (frame)->minibuffer_window, minibuf_window))
1936 {
8d2666fe
GM
1937 struct frame *sf = XFRAME (selected_frame);
1938 Fset_window_buffer (sf->minibuffer_window,
5af5757b 1939 XWINDOW (minibuf_window)->buffer, Qnil);
8d2666fe 1940 minibuf_window = sf->minibuffer_window;
9c394f17
RS
1941 }
1942
dbc4e1c1 1943 /* I think this should be done with a hook. */
032d78fe
GV
1944#ifdef HAVE_WINDOW_SYSTEM
1945 if (FRAME_WINDOW_P (XFRAME (frame)))
ff11dfa1 1946 x_iconify_frame (XFRAME (frame));
fd0c2bd1 1947#endif
dc6f92b8 1948
d19be8a9 1949 /* Make menu bar update for the Buffers and Frames menus. */
565620a5
RS
1950 windows_or_buffers_changed++;
1951
dc6f92b8
JB
1952 return Qnil;
1953}
1954
ff11dfa1 1955DEFUN ("frame-visible-p", Fframe_visible_p, Sframe_visible_p,
dc6f92b8 1956 1, 1, 0,
14ff1ee0
PJ
1957 doc: /* Return t if FRAME is now \"visible\" (actually in use for display).
1958A frame that is not \"visible\" is not updated and, if it works through
1959a window system, it may not show at all.
e4ed805e
LT
1960Return the symbol `icon' if frame is visible only as an icon.
1961
1962On a text-only terminal, all frames are considered visible, whether
1963they are currently being displayed or not, and this function returns t
1964for all frames. */)
14ff1ee0 1965 (frame)
ff11dfa1 1966 Lisp_Object frame;
dc6f92b8 1967{
b7826503 1968 CHECK_LIVE_FRAME (frame);
dc6f92b8 1969
5c044f55
RS
1970 FRAME_SAMPLE_VISIBILITY (XFRAME (frame));
1971
a42e9724 1972 if (FRAME_VISIBLE_P (XFRAME (frame)))
dc6f92b8 1973 return Qt;
a42e9724 1974 if (FRAME_ICONIFIED_P (XFRAME (frame)))
fd0c2bd1 1975 return Qicon;
dc6f92b8
JB
1976 return Qnil;
1977}
1978
ff11dfa1 1979DEFUN ("visible-frame-list", Fvisible_frame_list, Svisible_frame_list,
dc6f92b8 1980 0, 0, 0,
14ff1ee0 1981 doc: /* Return a list of all frames now \"visible\" (being updated). */)
dc6f92b8
JB
1982 ()
1983{
ff11dfa1
JB
1984 Lisp_Object tail, frame;
1985 struct frame *f;
dc6f92b8
JB
1986 Lisp_Object value;
1987
1988 value = Qnil;
7539e11f 1989 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
dc6f92b8 1990 {
7539e11f 1991 frame = XCAR (tail);
e35d291d 1992 if (!FRAMEP (frame))
dc6f92b8 1993 continue;
ff11dfa1 1994 f = XFRAME (frame);
a42e9724 1995 if (FRAME_VISIBLE_P (f))
ff11dfa1 1996 value = Fcons (frame, value);
dc6f92b8
JB
1997 }
1998 return value;
1999}
d5e7c279
JB
2000
2001
e518d5e1 2002DEFUN ("raise-frame", Fraise_frame, Sraise_frame, 0, 1, "",
14ff1ee0 2003 doc: /* Bring FRAME to the front, so it occludes any frames it overlaps.
e4ed805e 2004If FRAME is invisible or iconified, make it visible.
14ff1ee0
PJ
2005If you don't specify a frame, the selected frame is used.
2006If Emacs is displaying on an ordinary terminal or some other device which
2007doesn't support multiple overlapping frames, this function does nothing. */)
2008 (frame)
dbc4e1c1
JB
2009 Lisp_Object frame;
2010{
428a555e 2011 struct frame *f;
828ac693 2012 if (NILP (frame))
8d2666fe 2013 frame = selected_frame;
828ac693 2014
b7826503 2015 CHECK_LIVE_FRAME (frame);
8a981af5 2016
428a555e 2017 f = XFRAME (frame);
a3547743 2018
8a981af5
RS
2019 /* Do like the documentation says. */
2020 Fmake_frame_visible (frame);
2021
6ed8eeff
KL
2022 if (FRAME_TERMINAL (f)->frame_raise_lower_hook)
2023 (*FRAME_TERMINAL (f)->frame_raise_lower_hook) (f, 1);
dbc4e1c1
JB
2024
2025 return Qnil;
2026}
2027
b49f5578 2028/* Should we have a corresponding function called Flower_Power? */
e518d5e1 2029DEFUN ("lower-frame", Flower_frame, Slower_frame, 0, 1, "",
14ff1ee0
PJ
2030 doc: /* Send FRAME to the back, so it is occluded by any frames that overlap it.
2031If you don't specify a frame, the selected frame is used.
2032If Emacs is displaying on an ordinary terminal or some other device which
2033doesn't support multiple overlapping frames, this function does nothing. */)
2034 (frame)
dbc4e1c1
JB
2035 Lisp_Object frame;
2036{
428a555e 2037 struct frame *f;
a3547743 2038
828ac693 2039 if (NILP (frame))
8d2666fe 2040 frame = selected_frame;
828ac693 2041
b7826503 2042 CHECK_LIVE_FRAME (frame);
177c0ea7 2043
428a555e 2044 f = XFRAME (frame);
a3547743 2045
6ed8eeff
KL
2046 if (FRAME_TERMINAL (f)->frame_raise_lower_hook)
2047 (*FRAME_TERMINAL (f)->frame_raise_lower_hook) (f, 0);
dbc4e1c1
JB
2048
2049 return Qnil;
2050}
2051
d5e7c279 2052\f
ff11dfa1 2053DEFUN ("redirect-frame-focus", Fredirect_frame_focus, Sredirect_frame_focus,
d5e7c279 2054 1, 2, 0,
14ff1ee0
PJ
2055 doc: /* Arrange for keystrokes typed at FRAME to be sent to FOCUS-FRAME.
2056In other words, switch-frame events caused by events in FRAME will
2057request a switch to FOCUS-FRAME, and `last-event-frame' will be
2058FOCUS-FRAME after reading an event typed at FRAME.
2059
2060If FOCUS-FRAME is omitted or nil, any existing redirection is
2061cancelled, and the frame again receives its own keystrokes.
2062
2063Focus redirection is useful for temporarily redirecting keystrokes to
2064a surrogate minibuffer frame when a frame doesn't have its own
2065minibuffer window.
2066
66a9dbbe 2067A frame's focus redirection can be changed by `select-frame'. If frame
14ff1ee0
PJ
2068FOO is selected, and then a different frame BAR is selected, any
2069frames redirecting their focus to FOO are shifted to redirect their
2070focus to BAR. This allows focus redirection to work properly when the
2071user switches from one frame to another using `select-window'.
2072
2073This means that a frame whose focus is redirected to itself is treated
2074differently from a frame whose focus is redirected to nil; the former
66a9dbbe 2075is affected by `select-frame', while the latter is not.
14ff1ee0
PJ
2076
2077The redirection lasts until `redirect-frame-focus' is called to change it. */)
2078 (frame, focus_frame)
2079 Lisp_Object frame, focus_frame;
d5e7c279 2080{
428a555e 2081 struct frame *f;
a3547743 2082
13144095
JB
2083 /* Note that we don't check for a live frame here. It's reasonable
2084 to redirect the focus of a frame you're about to delete, if you
2085 know what other frame should receive those keystrokes. */
b7826503 2086 CHECK_FRAME (frame);
f9898cc6 2087
a42e9724 2088 if (! NILP (focus_frame))
b7826503 2089 CHECK_LIVE_FRAME (focus_frame);
d5e7c279 2090
428a555e 2091 f = XFRAME (frame);
a3547743 2092
428a555e 2093 f->focus_frame = focus_frame;
d5e7c279 2094
6ed8eeff
KL
2095 if (FRAME_TERMINAL (f)->frame_rehighlight_hook)
2096 (*FRAME_TERMINAL (f)->frame_rehighlight_hook) (f);
177c0ea7 2097
d5e7c279
JB
2098 return Qnil;
2099}
2100
2101
ff11dfa1 2102DEFUN ("frame-focus", Fframe_focus, Sframe_focus, 1, 1, 0,
14ff1ee0
PJ
2103 doc: /* Return the frame to which FRAME's keystrokes are currently being sent.
2104This returns nil if FRAME's focus is not redirected.
2105See `redirect-frame-focus'. */)
2106 (frame)
2107 Lisp_Object frame;
d5e7c279 2108{
b7826503 2109 CHECK_LIVE_FRAME (frame);
a42e9724 2110
ff11dfa1 2111 return FRAME_FOCUS_FRAME (XFRAME (frame));
d5e7c279
JB
2112}
2113
2114
dc6f92b8 2115\f
329ca574
RS
2116/* Return the value of frame parameter PROP in frame FRAME. */
2117
dc6f92b8 2118Lisp_Object
ff11dfa1
JB
2119get_frame_param (frame, prop)
2120 register struct frame *frame;
dc6f92b8
JB
2121 Lisp_Object prop;
2122{
2123 register Lisp_Object tem;
2124
ff11dfa1 2125 tem = Fassq (prop, frame->param_alist);
dc6f92b8
JB
2126 if (EQ (tem, Qnil))
2127 return tem;
2128 return Fcdr (tem);
2129}
2130
329ca574
RS
2131/* Return the buffer-predicate of the selected frame. */
2132
2133Lisp_Object
98ce1622
RS
2134frame_buffer_predicate (frame)
2135 Lisp_Object frame;
329ca574 2136{
98ce1622 2137 return XFRAME (frame)->buffer_predicate;
329ca574
RS
2138}
2139
fa54c6ae
RS
2140/* Return the buffer-list of the selected frame. */
2141
2142Lisp_Object
98ce1622
RS
2143frame_buffer_list (frame)
2144 Lisp_Object frame;
fa54c6ae 2145{
98ce1622 2146 return XFRAME (frame)->buffer_list;
fa54c6ae
RS
2147}
2148
2149/* Set the buffer-list of the selected frame. */
2150
2151void
98ce1622
RS
2152set_frame_buffer_list (frame, list)
2153 Lisp_Object frame, list;
fa54c6ae 2154{
98ce1622 2155 XFRAME (frame)->buffer_list = list;
fa54c6ae
RS
2156}
2157
a18b8cb5 2158/* Discard BUFFER from the buffer-list and buried-buffer-list of each frame. */
fa54c6ae
RS
2159
2160void
2161frames_discard_buffer (buffer)
2162 Lisp_Object buffer;
2163{
2164 Lisp_Object frame, tail;
2165
2166 FOR_EACH_FRAME (tail, frame)
2167 {
2168 XFRAME (frame)->buffer_list
2169 = Fdelq (buffer, XFRAME (frame)->buffer_list);
a18b8cb5
KL
2170 XFRAME (frame)->buried_buffer_list
2171 = Fdelq (buffer, XFRAME (frame)->buried_buffer_list);
fa54c6ae
RS
2172 }
2173}
2174
329ca574
RS
2175/* Modify the alist in *ALISTPTR to associate PROP with VAL.
2176 If the alist already has an element for PROP, we change it. */
2177
dc6f92b8 2178void
fd0c2bd1 2179store_in_alist (alistptr, prop, val)
dc6f92b8 2180 Lisp_Object *alistptr, val;
fd0c2bd1 2181 Lisp_Object prop;
dc6f92b8
JB
2182{
2183 register Lisp_Object tem;
dc6f92b8 2184
dc6f92b8
JB
2185 tem = Fassq (prop, *alistptr);
2186 if (EQ (tem, Qnil))
2187 *alistptr = Fcons (Fcons (prop, val), *alistptr);
2188 else
2189 Fsetcdr (tem, val);
2190}
2191
e5317d61
EZ
2192static int
2193frame_name_fnn_p (str, len)
2194 char *str;
0432e6a1 2195 EMACS_INT len;
e5317d61
EZ
2196{
2197 if (len > 1 && str[0] == 'F')
2198 {
2199 char *end_ptr;
e5317d61 2200
48970f2f
EZ
2201 strtol (str + 1, &end_ptr, 10);
2202
e5317d61
EZ
2203 if (end_ptr == str + len)
2204 return 1;
2205 }
2206 return 0;
2207}
2208
2209/* Set the name of the terminal frame. Also used by MSDOS frames.
2210 Modeled after x_set_name which is used for WINDOW frames. */
2211
66a9dbbe 2212static void
e5317d61
EZ
2213set_term_frame_name (f, name)
2214 struct frame *f;
2215 Lisp_Object name;
2216{
2217 f->explicit_name = ! NILP (name);
2218
2219 /* If NAME is nil, set the name to F<num>. */
2220 if (NILP (name))
2221 {
2222 char namebuf[20];
2223
2224 /* Check for no change needed in this very common case
2225 before we do any consing. */
d5db4077
KR
2226 if (frame_name_fnn_p (SDATA (f->name),
2227 SBYTES (f->name)))
e5317d61
EZ
2228 return;
2229
6ed8eeff
KL
2230 tty_frame_count++;
2231 sprintf (namebuf, "F%d", tty_frame_count);
e5317d61
EZ
2232 name = build_string (namebuf);
2233 }
2234 else
2235 {
b7826503 2236 CHECK_STRING (name);
e5317d61
EZ
2237
2238 /* Don't change the name if it's already NAME. */
2239 if (! NILP (Fstring_equal (name, f->name)))
2240 return;
2241
2242 /* Don't allow the user to set the frame name to F<num>, so it
2243 doesn't clash with the names we generate for terminal frames. */
d5db4077 2244 if (frame_name_fnn_p (SDATA (name), SBYTES (name)))
e5317d61
EZ
2245 error ("Frame names of the form F<num> are usurped by Emacs");
2246 }
2247
2248 f->name = name;
2249 update_mode_lines = 1;
2250}
2251
dc6f92b8 2252void
ff11dfa1
JB
2253store_frame_param (f, prop, val)
2254 struct frame *f;
dc6f92b8
JB
2255 Lisp_Object prop, val;
2256{
7eb63b72 2257 register Lisp_Object old_alist_elt;
dc6f92b8 2258
a18b8cb5
KL
2259 /* The buffer-list parameters are stored in a special place and not
2260 in the alist. */
fa54c6ae
RS
2261 if (EQ (prop, Qbuffer_list))
2262 {
2263 f->buffer_list = val;
2264 return;
2265 }
a18b8cb5
KL
2266 if (EQ (prop, Qburied_buffer_list))
2267 {
2268 f->buried_buffer_list = val;
2269 return;
2270 }
fa54c6ae 2271
7eb63b72
GM
2272 /* If PROP is a symbol which is supposed to have frame-local values,
2273 and it is set up based on this frame, switch to the global
2274 binding. That way, we can create or alter the frame-local binding
2275 without messing up the symbol's status. */
2276 if (SYMBOLP (prop))
2277 {
2278 Lisp_Object valcontents;
f5c1dd0d 2279 valcontents = SYMBOL_VALUE (prop);
67ee9f6e 2280 if ((BUFFER_LOCAL_VALUEP (valcontents))
7eb63b72 2281 && XBUFFER_LOCAL_VALUE (valcontents)->check_frame
486420a9 2282 && XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame
7eb63b72
GM
2283 && XFRAME (XBUFFER_LOCAL_VALUE (valcontents)->frame) == f)
2284 swap_in_global_binding (prop);
2285 }
2286
94674d18 2287#ifndef WINDOWSNT
9b2cd403
SM
2288 /* The tty color needed to be set before the frame's parameter
2289 alist was updated with the new value. This is not true any more,
2290 but we still do this test early on. */
2291 if (FRAME_TERMCAP_P (f) && EQ (prop, Qtty_color_mode)
2292 && f == FRAME_TTY (f)->previous_frame)
2293 /* Force redisplay of this tty. */
2294 FRAME_TTY (f)->previous_frame = NULL;
94674d18
EZ
2295#endif
2296
7eb63b72
GM
2297 /* Update the frame parameter alist. */
2298 old_alist_elt = Fassq (prop, f->param_alist);
2299 if (EQ (old_alist_elt, Qnil))
ff11dfa1 2300 f->param_alist = Fcons (Fcons (prop, val), f->param_alist);
dc6f92b8 2301 else
7eb63b72 2302 Fsetcdr (old_alist_elt, val);
bc93c097 2303
7eb63b72
GM
2304 /* Update some other special parameters in their special places
2305 in addition to the alist. */
177c0ea7 2306
329ca574
RS
2307 if (EQ (prop, Qbuffer_predicate))
2308 f->buffer_predicate = val;
2309
032d78fe 2310 if (! FRAME_WINDOW_P (f))
e5317d61
EZ
2311 {
2312 if (EQ (prop, Qmenu_bar_lines))
2313 set_menu_bar_lines (f, val, make_number (FRAME_MENU_BAR_LINES (f)));
2314 else if (EQ (prop, Qname))
2315 set_term_frame_name (f, val);
2316 }
a249de79 2317
e35d291d 2318 if (EQ (prop, Qminibuffer) && WINDOWP (val))
bc93c097
JB
2319 {
2320 if (! MINI_WINDOW_P (XWINDOW (val)))
6b61353c 2321 error ("Surrogate minibuffer windows must be minibuffer windows");
bc93c097 2322
213bac8a 2323 if ((FRAME_HAS_MINIBUF_P (f) || FRAME_MINIBUF_ONLY_P (f))
7af7ef38
KH
2324 && !EQ (val, f->minibuffer_window))
2325 error ("Can't change the surrogate minibuffer of a frame with its own minibuffer");
bc93c097
JB
2326
2327 /* Install the chosen minibuffer window, with proper buffer. */
ff11dfa1 2328 f->minibuffer_window = val;
bc93c097 2329 }
dc6f92b8
JB
2330}
2331
ff11dfa1 2332DEFUN ("frame-parameters", Fframe_parameters, Sframe_parameters, 0, 1, 0,
14ff1ee0
PJ
2333 doc: /* Return the parameters-alist of frame FRAME.
2334It is a list of elements of the form (PARM . VALUE), where PARM is a symbol.
2335The meaningful PARMs depend on the kind of frame.
2336If FRAME is omitted, return information on the currently selected frame. */)
2337 (frame)
ff11dfa1 2338 Lisp_Object frame;
dc6f92b8
JB
2339{
2340 Lisp_Object alist;
f769f1b2 2341 FRAME_PTR f;
dd10ec4f 2342 int height, width;
57629833 2343 struct gcpro gcpro1;
dc6f92b8 2344
03390a72 2345 if (NILP (frame))
8d2666fe
GM
2346 frame = selected_frame;
2347
b7826503 2348 CHECK_FRAME (frame);
8d2666fe 2349 f = XFRAME (frame);
dc6f92b8 2350
f769f1b2 2351 if (!FRAME_LIVE_P (f))
dc6f92b8
JB
2352 return Qnil;
2353
ff11dfa1 2354 alist = Fcopy_alist (f->param_alist);
57629833 2355 GCPRO1 (alist);
177c0ea7 2356
2d764c78 2357 if (!FRAME_WINDOW_P (f))
bb221971 2358 {
4aec4b29
EZ
2359 int fg = FRAME_FOREGROUND_PIXEL (f);
2360 int bg = FRAME_BACKGROUND_PIXEL (f);
e1d0bbc9
EZ
2361 Lisp_Object elt;
2362
2363 /* If the frame's parameter alist says the colors are
2364 unspecified and reversed, take the frame's background pixel
2365 for foreground and vice versa. */
2366 elt = Fassq (Qforeground_color, alist);
19b5e79b 2367 if (CONSP (elt) && STRINGP (XCDR (elt)))
70de9f06 2368 {
d5db4077 2369 if (strncmp (SDATA (XCDR (elt)),
70de9f06 2370 unspecified_bg,
d5db4077 2371 SCHARS (XCDR (elt))) == 0)
70de9f06 2372 store_in_alist (&alist, Qforeground_color, tty_color_name (f, bg));
d5db4077 2373 else if (strncmp (SDATA (XCDR (elt)),
70de9f06 2374 unspecified_fg,
d5db4077 2375 SCHARS (XCDR (elt))) == 0)
70de9f06
EZ
2376 store_in_alist (&alist, Qforeground_color, tty_color_name (f, fg));
2377 }
e1d0bbc9
EZ
2378 else
2379 store_in_alist (&alist, Qforeground_color, tty_color_name (f, fg));
2380 elt = Fassq (Qbackground_color, alist);
19b5e79b 2381 if (CONSP (elt) && STRINGP (XCDR (elt)))
70de9f06 2382 {
d5db4077 2383 if (strncmp (SDATA (XCDR (elt)),
70de9f06 2384 unspecified_fg,
d5db4077 2385 SCHARS (XCDR (elt))) == 0)
70de9f06 2386 store_in_alist (&alist, Qbackground_color, tty_color_name (f, fg));
d5db4077 2387 else if (strncmp (SDATA (XCDR (elt)),
70de9f06 2388 unspecified_bg,
d5db4077 2389 SCHARS (XCDR (elt))) == 0)
70de9f06
EZ
2390 store_in_alist (&alist, Qbackground_color, tty_color_name (f, bg));
2391 }
e1d0bbc9
EZ
2392 else
2393 store_in_alist (&alist, Qbackground_color, tty_color_name (f, bg));
2d764c78
EZ
2394 store_in_alist (&alist, intern ("font"),
2395 build_string (FRAME_MSDOS_P (f)
2396 ? "ms-dos"
4ec0d3c1 2397 : FRAME_W32_P (f) ? "w32term"
4ec0d3c1 2398 :"tty"));
bb221971 2399 }
fd0c2bd1 2400 store_in_alist (&alist, Qname, f->name);
5af5757b 2401 height = (f->new_text_lines ? f->new_text_lines : FRAME_LINES (f));
dd10ec4f 2402 store_in_alist (&alist, Qheight, make_number (height));
5af5757b 2403 width = (f->new_text_cols ? f->new_text_cols : FRAME_COLS (f));
dd10ec4f 2404 store_in_alist (&alist, Qwidth, make_number (width));
f769f1b2 2405 store_in_alist (&alist, Qmodeline, (FRAME_WANTS_MODELINE_P (f) ? Qt : Qnil));
fd0c2bd1 2406 store_in_alist (&alist, Qminibuffer,
39acc701 2407 (! FRAME_HAS_MINIBUF_P (f) ? Qnil
f769f1b2
KH
2408 : FRAME_MINIBUF_ONLY_P (f) ? Qonly
2409 : FRAME_MINIBUF_WINDOW (f)));
2410 store_in_alist (&alist, Qunsplittable, (FRAME_NO_SPLIT_P (f) ? Qt : Qnil));
03390a72 2411 store_in_alist (&alist, Qbuffer_list, frame_buffer_list (frame));
a18b8cb5 2412 store_in_alist (&alist, Qburied_buffer_list, XFRAME (frame)->buried_buffer_list);
fd0c2bd1 2413
dbc4e1c1 2414 /* I think this should be done with a hook. */
032d78fe
GV
2415#ifdef HAVE_WINDOW_SYSTEM
2416 if (FRAME_WINDOW_P (f))
ff11dfa1 2417 x_report_frame_params (f, &alist);
b6dd20ed 2418 else
fd0c2bd1 2419#endif
16a3738c
KH
2420 {
2421 /* This ought to be correct in f->param_alist for an X frame. */
2422 Lisp_Object lines;
f4e93c40 2423 XSETFASTINT (lines, FRAME_MENU_BAR_LINES (f));
16a3738c
KH
2424 store_in_alist (&alist, Qmenu_bar_lines, lines);
2425 }
57629833
GM
2426
2427 UNGCPRO;
dc6f92b8
JB
2428 return alist;
2429}
2430
8b60f7bc
GM
2431
2432DEFUN ("frame-parameter", Fframe_parameter, Sframe_parameter, 2, 2, 0,
14ff1ee0
PJ
2433 doc: /* Return FRAME's value for parameter PARAMETER.
2434If FRAME is nil, describe the currently selected frame. */)
2435 (frame, parameter)
2436 Lisp_Object frame, parameter;
8b60f7bc
GM
2437{
2438 struct frame *f;
2439 Lisp_Object value;
2440
2441 if (NILP (frame))
2442 frame = selected_frame;
2443 else
b7826503
PJ
2444 CHECK_FRAME (frame);
2445 CHECK_SYMBOL (parameter);
177c0ea7 2446
8b60f7bc
GM
2447 f = XFRAME (frame);
2448 value = Qnil;
177c0ea7 2449
8b60f7bc
GM
2450 if (FRAME_LIVE_P (f))
2451 {
5cd62b8c 2452 /* Avoid consing in frequent cases. */
67d853e6
GM
2453 if (EQ (parameter, Qname))
2454 value = f->name;
6345f6aa
GM
2455#ifdef HAVE_X_WINDOWS
2456 else if (EQ (parameter, Qdisplay) && FRAME_X_P (f))
2457 value = XCAR (FRAME_X_DISPLAY_INFO (f)->name_list_element);
2458#endif /* HAVE_X_WINDOWS */
75700ff2
GM
2459 else if (EQ (parameter, Qbackground_color)
2460 || EQ (parameter, Qforeground_color))
67d853e6
GM
2461 {
2462 value = Fassq (parameter, f->param_alist);
2463 if (CONSP (value))
5f65b39d 2464 {
5f65b39d
EZ
2465 value = XCDR (value);
2466 /* Fframe_parameters puts the actual fg/bg color names,
2467 even if f->param_alist says otherwise. This is
2468 important when param_alist's notion of colors is
2469 "unspecified". We need to do the same here. */
2470 if (STRINGP (value) && !FRAME_WINDOW_P (f))
2471 {
c9b08ba8 2472 const char *color_name;
e1d0bbc9
EZ
2473 EMACS_INT csz;
2474
2475 if (EQ (parameter, Qbackground_color))
2476 {
d5db4077
KR
2477 color_name = SDATA (value);
2478 csz = SCHARS (value);
e1d0bbc9
EZ
2479 if (strncmp (color_name, unspecified_bg, csz) == 0)
2480 value = tty_color_name (f, FRAME_BACKGROUND_PIXEL (f));
2481 else if (strncmp (color_name, unspecified_fg, csz) == 0)
2482 value = tty_color_name (f, FRAME_FOREGROUND_PIXEL (f));
2483 }
2484 else if (EQ (parameter, Qforeground_color))
2485 {
d5db4077
KR
2486 color_name = SDATA (value);
2487 csz = SCHARS (value);
e1d0bbc9
EZ
2488 if (strncmp (color_name, unspecified_fg, csz) == 0)
2489 value = tty_color_name (f, FRAME_FOREGROUND_PIXEL (f));
2490 else if (strncmp (color_name, unspecified_bg, csz) == 0)
2491 value = tty_color_name (f, FRAME_BACKGROUND_PIXEL (f));
2492 }
5f65b39d
EZ
2493 }
2494 }
b23236fb
EZ
2495 else
2496 value = Fcdr (Fassq (parameter, Fframe_parameters (frame)));
67d853e6 2497 }
75700ff2
GM
2498 else if (EQ (parameter, Qdisplay_type)
2499 || EQ (parameter, Qbackground_mode))
75700ff2
GM
2500 value = Fcdr (Fassq (parameter, f->param_alist));
2501 else
2502 value = Fcdr (Fassq (parameter, Fframe_parameters (frame)));
8b60f7bc 2503 }
177c0ea7 2504
8b60f7bc
GM
2505 return value;
2506}
2507
2508
177c0ea7 2509DEFUN ("modify-frame-parameters", Fmodify_frame_parameters,
ff11dfa1 2510 Smodify_frame_parameters, 2, 2, 0,
14ff1ee0
PJ
2511 doc: /* Modify the parameters of frame FRAME according to ALIST.
2512If FRAME is nil, it defaults to the selected frame.
2513ALIST is an alist of parameters to change and their new values.
2514Each element of ALIST has the form (PARM . VALUE), where PARM is a symbol.
2515The meaningful PARMs depend on the kind of frame.
2516Undefined PARMs are ignored, but stored in the frame's parameter list
2517so that `frame-parameters' will return them.
2518
2519The value of frame parameter FOO can also be accessed
2520as a frame-local binding for the variable FOO, if you have
2521enabled such bindings for that variable with `make-variable-frame-local'. */)
2522 (frame, alist)
ff11dfa1 2523 Lisp_Object frame, alist;
dc6f92b8 2524{
fd0c2bd1 2525 FRAME_PTR f;
213bac8a 2526 register Lisp_Object tail, prop, val;
dc6f92b8 2527
ff11dfa1 2528 if (EQ (frame, Qnil))
8d2666fe 2529 frame = selected_frame;
b7826503 2530 CHECK_LIVE_FRAME (frame);
8d2666fe 2531 f = XFRAME (frame);
dc6f92b8 2532
dbc4e1c1 2533 /* I think this should be done with a hook. */
032d78fe
GV
2534#ifdef HAVE_WINDOW_SYSTEM
2535 if (FRAME_WINDOW_P (f))
fd0c2bd1 2536 x_set_frame_parameters (f, alist);
329ca574 2537 else
bb221971
RS
2538#endif
2539#ifdef MSDOS
2540 if (FRAME_MSDOS_P (f))
2541 IT_set_frame_parameters (f, alist);
2542 else
329ca574 2543#endif
574a1a90 2544
41d44f1f
RS
2545 {
2546 int length = XINT (Flength (alist));
2547 int i;
2548 Lisp_Object *parms
2549 = (Lisp_Object *) alloca (length * sizeof (Lisp_Object));
2550 Lisp_Object *values
2551 = (Lisp_Object *) alloca (length * sizeof (Lisp_Object));
2552
2553 /* Extract parm names and values into those vectors. */
2554
2555 i = 0;
d7b10f4c 2556 for (tail = alist; CONSP (tail); tail = XCDR (tail))
41d44f1f 2557 {
213bac8a 2558 Lisp_Object elt;
41d44f1f 2559
d7b10f4c 2560 elt = XCAR (tail);
41d44f1f
RS
2561 parms[i] = Fcar (elt);
2562 values[i] = Fcdr (elt);
2563 i++;
2564 }
2565
2566 /* Now process them in reverse of specified order. */
2567 for (i--; i >= 0; i--)
2568 {
2569 prop = parms[i];
2570 val = values[i];
2571 store_frame_param (f, prop, val);
33d537f0
JL
2572
2573 /* Changing the background color might change the background
2574 mode, so that we have to load new defface specs.
2575 Call frame-set-background-mode to do that. */
2576 if (EQ (prop, Qbackground_color))
2577 call1 (Qframe_set_background_mode, frame);
41d44f1f
RS
2578 }
2579 }
3b58be21 2580 return Qnil;
dc6f92b8
JB
2581}
2582\f
a26a1f95 2583DEFUN ("frame-char-height", Fframe_char_height, Sframe_char_height,
14ff1ee0
PJ
2584 0, 1, 0,
2585 doc: /* Height in pixels of a line in the font in frame FRAME.
2586If FRAME is omitted, the selected frame is used.
2587For a terminal frame, the value is always 1. */)
ff11dfa1
JB
2588 (frame)
2589 Lisp_Object frame;
dc6f92b8 2590{
a26a1f95 2591 struct frame *f;
dc6f92b8 2592
a26a1f95 2593 if (NILP (frame))
8d2666fe 2594 frame = selected_frame;
b7826503 2595 CHECK_FRAME (frame);
8d2666fe 2596 f = XFRAME (frame);
a26a1f95 2597
032d78fe
GV
2598#ifdef HAVE_WINDOW_SYSTEM
2599 if (FRAME_WINDOW_P (f))
a26a1f95
RS
2600 return make_number (x_char_height (f));
2601 else
dc6d9681 2602#endif
a26a1f95
RS
2603 return make_number (1);
2604}
dc6d9681 2605
dc6f92b8 2606
a26a1f95 2607DEFUN ("frame-char-width", Fframe_char_width, Sframe_char_width,
14ff1ee0
PJ
2608 0, 1, 0,
2609 doc: /* Width in pixels of characters in the font in frame FRAME.
2610If FRAME is omitted, the selected frame is used.
31b7cc74 2611On a graphical screen, the width is the standard width of the default font.
14ff1ee0
PJ
2612For a terminal screen, the value is always 1. */)
2613 (frame)
a26a1f95 2614 Lisp_Object frame;
dc6f92b8 2615{
a26a1f95
RS
2616 struct frame *f;
2617
2618 if (NILP (frame))
8d2666fe 2619 frame = selected_frame;
b7826503 2620 CHECK_FRAME (frame);
8d2666fe 2621 f = XFRAME (frame);
a26a1f95 2622
032d78fe
GV
2623#ifdef HAVE_WINDOW_SYSTEM
2624 if (FRAME_WINDOW_P (f))
a26a1f95
RS
2625 return make_number (x_char_width (f));
2626 else
2627#endif
2628 return make_number (1);
dc6f92b8
JB
2629}
2630
177c0ea7 2631DEFUN ("frame-pixel-height", Fframe_pixel_height,
a26a1f95 2632 Sframe_pixel_height, 0, 1, 0,
14ff1ee0
PJ
2633 doc: /* Return a FRAME's height in pixels.
2634This counts only the height available for text lines,
2635not menu bars on window-system Emacs frames.
2636For a terminal frame, the result really gives the height in characters.
2637If FRAME is omitted, the selected frame is used. */)
2638 (frame)
a26a1f95 2639 Lisp_Object frame;
dc6f92b8 2640{
a26a1f95
RS
2641 struct frame *f;
2642
2643 if (NILP (frame))
8d2666fe 2644 frame = selected_frame;
b7826503 2645 CHECK_FRAME (frame);
8d2666fe 2646 f = XFRAME (frame);
a26a1f95 2647
032d78fe
GV
2648#ifdef HAVE_WINDOW_SYSTEM
2649 if (FRAME_WINDOW_P (f))
a26a1f95
RS
2650 return make_number (x_pixel_height (f));
2651 else
dc6d9681 2652#endif
5af5757b 2653 return make_number (FRAME_LINES (f));
a26a1f95
RS
2654}
2655
177c0ea7 2656DEFUN ("frame-pixel-width", Fframe_pixel_width,
a26a1f95 2657 Sframe_pixel_width, 0, 1, 0,
14ff1ee0
PJ
2658 doc: /* Return FRAME's width in pixels.
2659For a terminal frame, the result really gives the width in characters.
2660If FRAME is omitted, the selected frame is used. */)
2661 (frame)
a26a1f95
RS
2662 Lisp_Object frame;
2663{
2664 struct frame *f;
2665
2666 if (NILP (frame))
8d2666fe 2667 frame = selected_frame;
b7826503 2668 CHECK_FRAME (frame);
8d2666fe 2669 f = XFRAME (frame);
dc6f92b8 2670
032d78fe
GV
2671#ifdef HAVE_WINDOW_SYSTEM
2672 if (FRAME_WINDOW_P (f))
a26a1f95
RS
2673 return make_number (x_pixel_width (f));
2674 else
2675#endif
5af5757b 2676 return make_number (FRAME_COLS (f));
a26a1f95
RS
2677}
2678\f
ff11dfa1 2679DEFUN ("set-frame-height", Fset_frame_height, Sset_frame_height, 2, 3, 0,
14ff1ee0
PJ
2680 doc: /* Specify that the frame FRAME has LINES lines.
2681Optional third arg non-nil means that redisplay should use LINES lines
2682but that the idea of the actual height of the frame should not be changed. */)
2683 (frame, lines, pretend)
735eeca3 2684 Lisp_Object frame, lines, pretend;
dc6f92b8 2685{
ff11dfa1 2686 register struct frame *f;
dc6f92b8 2687
b7826503 2688 CHECK_NUMBER (lines);
ff11dfa1 2689 if (NILP (frame))
8d2666fe 2690 frame = selected_frame;
b7826503 2691 CHECK_LIVE_FRAME (frame);
8d2666fe 2692 f = XFRAME (frame);
dc6f92b8 2693
dbc4e1c1 2694 /* I think this should be done with a hook. */
032d78fe
GV
2695#ifdef HAVE_WINDOW_SYSTEM
2696 if (FRAME_WINDOW_P (f))
dc6f92b8 2697 {
5af5757b
KS
2698 if (XINT (lines) != FRAME_LINES (f))
2699 x_set_window_size (f, 1, FRAME_COLS (f), XINT (lines));
32347cf4 2700 do_pending_window_change (0);
dc6f92b8
JB
2701 }
2702 else
fd0c2bd1 2703#endif
32347cf4 2704 change_frame_size (f, XINT (lines), 0, !NILP (pretend), 0, 0);
dc6f92b8
JB
2705 return Qnil;
2706}
2707
ff11dfa1 2708DEFUN ("set-frame-width", Fset_frame_width, Sset_frame_width, 2, 3, 0,
14ff1ee0
PJ
2709 doc: /* Specify that the frame FRAME has COLS columns.
2710Optional third arg non-nil means that redisplay should use COLS columns
2711but that the idea of the actual width of the frame should not be changed. */)
2712 (frame, cols, pretend)
fd0c2bd1 2713 Lisp_Object frame, cols, pretend;
dc6f92b8 2714{
ff11dfa1 2715 register struct frame *f;
b7826503 2716 CHECK_NUMBER (cols);
ff11dfa1 2717 if (NILP (frame))
8d2666fe 2718 frame = selected_frame;
b7826503 2719 CHECK_LIVE_FRAME (frame);
8d2666fe 2720 f = XFRAME (frame);
dc6f92b8 2721
dbc4e1c1 2722 /* I think this should be done with a hook. */
032d78fe
GV
2723#ifdef HAVE_WINDOW_SYSTEM
2724 if (FRAME_WINDOW_P (f))
dc6f92b8 2725 {
5af5757b
KS
2726 if (XINT (cols) != FRAME_COLS (f))
2727 x_set_window_size (f, 1, XINT (cols), FRAME_LINES (f));
32347cf4 2728 do_pending_window_change (0);
dc6f92b8
JB
2729 }
2730 else
fd0c2bd1 2731#endif
32347cf4 2732 change_frame_size (f, 0, XINT (cols), !NILP (pretend), 0, 0);
dc6f92b8
JB
2733 return Qnil;
2734}
2735
ff11dfa1 2736DEFUN ("set-frame-size", Fset_frame_size, Sset_frame_size, 3, 3, 0,
14ff1ee0
PJ
2737 doc: /* Sets size of FRAME to COLS by ROWS, measured in characters. */)
2738 (frame, cols, rows)
ff11dfa1 2739 Lisp_Object frame, cols, rows;
dc6f92b8 2740{
ff11dfa1 2741 register struct frame *f;
dc6f92b8 2742
b7826503
PJ
2743 CHECK_LIVE_FRAME (frame);
2744 CHECK_NUMBER (cols);
2745 CHECK_NUMBER (rows);
ff11dfa1 2746 f = XFRAME (frame);
dc6f92b8 2747
dbc4e1c1 2748 /* I think this should be done with a hook. */
032d78fe
GV
2749#ifdef HAVE_WINDOW_SYSTEM
2750 if (FRAME_WINDOW_P (f))
dc6f92b8 2751 {
5af5757b
KS
2752 if (XINT (rows) != FRAME_LINES (f)
2753 || XINT (cols) != FRAME_COLS (f)
2754 || f->new_text_lines || f->new_text_cols)
808c0f20 2755 x_set_window_size (f, 1, XINT (cols), XINT (rows));
32347cf4 2756 do_pending_window_change (0);
dc6f92b8
JB
2757 }
2758 else
fd0c2bd1 2759#endif
32347cf4 2760 change_frame_size (f, XINT (rows), XINT (cols), 0, 0, 0);
dc6f92b8
JB
2761
2762 return Qnil;
2763}
2764
177c0ea7 2765DEFUN ("set-frame-position", Fset_frame_position,
ff11dfa1 2766 Sset_frame_position, 3, 3, 0,
14ff1ee0
PJ
2767 doc: /* Sets position of FRAME in pixels to XOFFSET by YOFFSET.
2768This is actually the position of the upper left corner of the frame.
2769Negative values for XOFFSET or YOFFSET are interpreted relative to
2770the rightmost or bottommost possible position (that stays within the screen). */)
2771 (frame, xoffset, yoffset)
ff11dfa1 2772 Lisp_Object frame, xoffset, yoffset;
dc6f92b8 2773{
ff11dfa1 2774 register struct frame *f;
dc6f92b8 2775
b7826503
PJ
2776 CHECK_LIVE_FRAME (frame);
2777 CHECK_NUMBER (xoffset);
2778 CHECK_NUMBER (yoffset);
ff11dfa1 2779 f = XFRAME (frame);
dc6f92b8 2780
dbc4e1c1 2781 /* I think this should be done with a hook. */
032d78fe
GV
2782#ifdef HAVE_WINDOW_SYSTEM
2783 if (FRAME_WINDOW_P (f))
c7c70761 2784 x_set_offset (f, XINT (xoffset), XINT (yoffset), 1);
fd0c2bd1 2785#endif
dc6f92b8
JB
2786
2787 return Qt;
2788}
dc6d9681 2789
dc6f92b8 2790\f
972f4259
KS
2791/***********************************************************************
2792 Frame Parameters
2793 ***********************************************************************/
2794
2795/* Connect the frame-parameter names for X frames
2796 to the ways of passing the parameter values to the window system.
2797
2798 The name of a parameter, as a Lisp symbol,
2799 has an `x-frame-parameter' property which is an integer in Lisp
2800 that is an index in this table. */
2801
2802struct frame_parm_table {
2803 char *name;
2804 Lisp_Object *variable;
2805};
2806
2807static struct frame_parm_table frame_parms[] =
2808{
2809 {"auto-raise", &Qauto_raise},
2810 {"auto-lower", &Qauto_lower},
2811 {"background-color", 0},
2812 {"border-color", &Qborder_color},
2813 {"border-width", &Qborder_width},
2814 {"cursor-color", &Qcursor_color},
2815 {"cursor-type", &Qcursor_type},
2816 {"font", 0},
2817 {"foreground-color", 0},
2818 {"icon-name", &Qicon_name},
2819 {"icon-type", &Qicon_type},
2820 {"internal-border-width", &Qinternal_border_width},
2821 {"menu-bar-lines", &Qmenu_bar_lines},
2822 {"mouse-color", &Qmouse_color},
2823 {"name", &Qname},
2824 {"scroll-bar-width", &Qscroll_bar_width},
2825 {"title", &Qtitle},
2826 {"unsplittable", &Qunsplittable},
2827 {"vertical-scroll-bars", &Qvertical_scroll_bars},
2828 {"visibility", &Qvisibility},
2829 {"tool-bar-lines", &Qtool_bar_lines},
2830 {"scroll-bar-foreground", &Qscroll_bar_foreground},
2831 {"scroll-bar-background", &Qscroll_bar_background},
2832 {"screen-gamma", &Qscreen_gamma},
2833 {"line-spacing", &Qline_spacing},
2834 {"left-fringe", &Qleft_fringe},
2835 {"right-fringe", &Qright_fringe},
2836 {"wait-for-wm", &Qwait_for_wm},
2837 {"fullscreen", &Qfullscreen},
1a356571
KH
2838#ifdef USE_FONT_BACKEND
2839 {"font-backend", &Qfont_backend}
2840#endif /* USE_FONT_BACKEND */
972f4259
KS
2841};
2842
2843#ifdef HAVE_WINDOW_SYSTEM
2844
2845extern Lisp_Object Qbox;
2846extern Lisp_Object Qtop;
2847
2848/* Calculate fullscreen size. Return in *TOP_POS and *LEFT_POS the
bd45aef7 2849 wanted positions of the WM window (not Emacs window).
972f4259
KS
2850 Return in *WIDTH and *HEIGHT the wanted width and height of Emacs
2851 window (FRAME_X_WINDOW).
2852 */
2853
dfcf069d 2854void
972f4259
KS
2855x_fullscreen_adjust (f, width, height, top_pos, left_pos)
2856 struct frame *f;
2857 int *width;
2858 int *height;
2859 int *top_pos;
2860 int *left_pos;
dc6f92b8 2861{
5af5757b
KS
2862 int newwidth = FRAME_COLS (f);
2863 int newheight = FRAME_LINES (f);
dc6f92b8 2864
5af5757b
KS
2865 *top_pos = f->top_pos;
2866 *left_pos = f->left_pos;
3df1fda2 2867
5af5757b 2868 if (f->want_fullscreen & FULLSCREEN_HEIGHT)
972f4259
KS
2869 {
2870 int ph;
2871
2872 ph = FRAME_X_DISPLAY_INFO (f)->height;
5af5757b
KS
2873 newheight = FRAME_PIXEL_HEIGHT_TO_TEXT_LINES (f, ph);
2874 ph = FRAME_TEXT_LINES_TO_PIXEL_HEIGHT (f, newheight) - f->y_pixels_diff;
2875 newheight = FRAME_PIXEL_HEIGHT_TO_TEXT_LINES (f, ph);
972f4259
KS
2876 *top_pos = 0;
2877 }
dc6f92b8 2878
5af5757b 2879 if (f->want_fullscreen & FULLSCREEN_WIDTH)
972f4259
KS
2880 {
2881 int pw;
2882
2883 pw = FRAME_X_DISPLAY_INFO (f)->width;
5af5757b
KS
2884 newwidth = FRAME_PIXEL_WIDTH_TO_TEXT_COLS (f, pw);
2885 pw = FRAME_TEXT_COLS_TO_PIXEL_WIDTH (f, newwidth) - f->x_pixels_diff;
2886 newwidth = FRAME_PIXEL_WIDTH_TO_TEXT_COLS (f, pw);
972f4259
KS
2887 *left_pos = 0;
2888 }
dc6f92b8 2889
972f4259
KS
2890 *width = newwidth;
2891 *height = newheight;
2892}
dc6f92b8 2893
beb0bc36 2894
972f4259
KS
2895/* Change the parameters of frame F as specified by ALIST.
2896 If a parameter is not specially recognized, do nothing special;
2897 otherwise call the `x_set_...' function for that parameter.
2898 Except for certain geometry properties, always call store_frame_param
2899 to store the new value in the parameter alist. */
14ff1ee0 2900
972f4259
KS
2901void
2902x_set_frame_parameters (f, alist)
2903 FRAME_PTR f;
2904 Lisp_Object alist;
2905{
2906 Lisp_Object tail;
dc6f92b8 2907
972f4259
KS
2908 /* If both of these parameters are present, it's more efficient to
2909 set them both at once. So we wait until we've looked at the
2910 entire list before we set them. */
2911 int width, height;
3df1fda2 2912
972f4259
KS
2913 /* Same here. */
2914 Lisp_Object left, top;
2915
2916 /* Same with these. */
2917 Lisp_Object icon_left, icon_top;
2918
2919 /* Record in these vectors all the parms specified. */
2920 Lisp_Object *parms;
2921 Lisp_Object *values;
2922 int i, p;
2923 int left_no_change = 0, top_no_change = 0;
2924 int icon_left_no_change = 0, icon_top_no_change = 0;
2925 int fullscreen_is_being_set = 0;
2926
2927 struct gcpro gcpro1, gcpro2;
2928
2929 i = 0;
2930 for (tail = alist; CONSP (tail); tail = Fcdr (tail))
2931 i++;
2932
2933 parms = (Lisp_Object *) alloca (i * sizeof (Lisp_Object));
2934 values = (Lisp_Object *) alloca (i * sizeof (Lisp_Object));
2935
2936 /* Extract parm names and values into those vectors. */
2937
2938 i = 0;
d7b10f4c 2939 for (tail = alist; CONSP (tail); tail = XCDR (tail))
972f4259
KS
2940 {
2941 Lisp_Object elt;
2942
d7b10f4c 2943 elt = XCAR (tail);
972f4259
KS
2944 parms[i] = Fcar (elt);
2945 values[i] = Fcdr (elt);
2946 i++;
2947 }
2948 /* TAIL and ALIST are not used again below here. */
2949 alist = tail = Qnil;
2950
2951 GCPRO2 (*parms, *values);
2952 gcpro1.nvars = i;
2953 gcpro2.nvars = i;
2954
2955 /* There is no need to gcpro LEFT, TOP, ICON_LEFT, or ICON_TOP,
2956 because their values appear in VALUES and strings are not valid. */
2957 top = left = Qunbound;
2958 icon_left = icon_top = Qunbound;
2959
2960 /* Provide default values for HEIGHT and WIDTH. */
5af5757b
KS
2961 width = (f->new_text_cols ? f->new_text_cols : FRAME_COLS (f));
2962 height = (f->new_text_lines ? f->new_text_lines : FRAME_LINES (f));
972f4259
KS
2963
2964 /* Process foreground_color and background_color before anything else.
2965 They are independent of other properties, but other properties (e.g.,
2966 cursor_color) are dependent upon them. */
2967 /* Process default font as well, since fringe widths depends on it. */
2968 /* Also, process fullscreen, width and height depend upon that */
2969 for (p = 0; p < i; p++)
2970 {
2971 Lisp_Object prop, val;
2972
2973 prop = parms[p];
2974 val = values[p];
2975 if (EQ (prop, Qforeground_color)
2976 || EQ (prop, Qbackground_color)
2977 || EQ (prop, Qfont)
2978 || EQ (prop, Qfullscreen))
2979 {
2980 register Lisp_Object param_index, old_value;
26c34ec2 2981 int count = SPECPDL_INDEX ();
972f4259
KS
2982
2983 old_value = get_frame_param (f, prop);
2984 fullscreen_is_being_set |= EQ (prop, Qfullscreen);
2985
2986 if (NILP (Fequal (val, old_value)))
2987 {
26c34ec2
CY
2988 /* For :font attributes, the frame_parm_handler
2989 x_set_font calls `face-set-after-frame-default'.
2990 Unless we bind inhibit-face-set-after-frame-default
2991 here, this would reset the :font attribute that we
2992 just applied to the default value for new faces. */
2993 specbind (Qinhibit_face_set_after_frame_default, Qt);
2994
972f4259
KS
2995 store_frame_param (f, prop, val);
2996
2997 param_index = Fget (prop, Qx_frame_parameter);
2998 if (NATNUMP (param_index)
2999 && (XFASTINT (param_index)
3000 < sizeof (frame_parms)/sizeof (frame_parms[0]))
fa971ac3
KL
3001 && FRAME_RIF (f)->frame_parm_handlers[XINT (param_index)])
3002 (*(FRAME_RIF (f)->frame_parm_handlers[XINT (param_index)])) (f, val, old_value);
26c34ec2 3003 unbind_to (count, Qnil);
972f4259
KS
3004 }
3005 }
3006 }
3007
3008 /* Now process them in reverse of specified order. */
3009 for (i--; i >= 0; i--)
3010 {
3011 Lisp_Object prop, val;
3012
3013 prop = parms[i];
3014 val = values[i];
3015
629c715d 3016 if (EQ (prop, Qwidth) && NATNUMP (val))
972f4259 3017 width = XFASTINT (val);
629c715d 3018 else if (EQ (prop, Qheight) && NATNUMP (val))
972f4259
KS
3019 height = XFASTINT (val);
3020 else if (EQ (prop, Qtop))
3021 top = val;
3022 else if (EQ (prop, Qleft))
3023 left = val;
3024 else if (EQ (prop, Qicon_top))
3025 icon_top = val;
3026 else if (EQ (prop, Qicon_left))
3027 icon_left = val;
3028 else if (EQ (prop, Qforeground_color)
3029 || EQ (prop, Qbackground_color)
3030 || EQ (prop, Qfont)
3031 || EQ (prop, Qfullscreen))
3032 /* Processed above. */
3033 continue;
3034 else
3035 {
3036 register Lisp_Object param_index, old_value;
3037
3038 old_value = get_frame_param (f, prop);
3039
3040 store_frame_param (f, prop, val);
3041
3042 param_index = Fget (prop, Qx_frame_parameter);
3043 if (NATNUMP (param_index)
3044 && (XFASTINT (param_index)
3045 < sizeof (frame_parms)/sizeof (frame_parms[0]))
fa971ac3
KL
3046 && FRAME_RIF (f)->frame_parm_handlers[XINT (param_index)])
3047 (*(FRAME_RIF (f)->frame_parm_handlers[XINT (param_index)])) (f, val, old_value);
972f4259
KS
3048 }
3049 }
3050
3051 /* Don't die if just one of these was set. */
3052 if (EQ (left, Qunbound))
3053 {
3054 left_no_change = 1;
5af5757b
KS
3055 if (f->left_pos < 0)
3056 left = Fcons (Qplus, Fcons (make_number (f->left_pos), Qnil));
972f4259 3057 else
5af5757b 3058 XSETINT (left, f->left_pos);
972f4259
KS
3059 }
3060 if (EQ (top, Qunbound))
3061 {
3062 top_no_change = 1;
5af5757b
KS
3063 if (f->top_pos < 0)
3064 top = Fcons (Qplus, Fcons (make_number (f->top_pos), Qnil));
972f4259 3065 else
5af5757b 3066 XSETINT (top, f->top_pos);
972f4259
KS
3067 }
3068
3069 /* If one of the icon positions was not set, preserve or default it. */
3070 if (EQ (icon_left, Qunbound) || ! INTEGERP (icon_left))
3071 {
3072 icon_left_no_change = 1;
3073 icon_left = Fcdr (Fassq (Qicon_left, f->param_alist));
3074 if (NILP (icon_left))
3075 XSETINT (icon_left, 0);
3076 }
3077 if (EQ (icon_top, Qunbound) || ! INTEGERP (icon_top))
3078 {
3079 icon_top_no_change = 1;
3080 icon_top = Fcdr (Fassq (Qicon_top, f->param_alist));
3081 if (NILP (icon_top))
3082 XSETINT (icon_top, 0);
3083 }
3084
972f4259
KS
3085 if (FRAME_VISIBLE_P (f) && fullscreen_is_being_set)
3086 {
3087 /* If the frame is visible already and the fullscreen parameter is
3088 being set, it is too late to set WM manager hints to specify
3089 size and position.
3090 Here we first get the width, height and position that applies to
3091 fullscreen. We then move the frame to the appropriate
3092 position. Resize of the frame is taken care of in the code after
3093 this if-statement. */
3094 int new_left, new_top;
3095
3096 x_fullscreen_adjust (f, &width, &height, &new_top, &new_left);
6b61353c
KH
3097 if (new_top != f->top_pos || new_left != f->left_pos)
3098 x_set_offset (f, new_left, new_top, 1);
972f4259 3099 }
972f4259
KS
3100
3101 /* Don't set these parameters unless they've been explicitly
3102 specified. The window might be mapped or resized while we're in
3103 this function, and we don't want to override that unless the lisp
3104 code has asked for it.
3105
3106 Don't set these parameters unless they actually differ from the
3107 window's current parameters; the window may not actually exist
3108 yet. */
3109 {
3110 Lisp_Object frame;
3111
3112 check_frame_size (f, &height, &width);
3113
3114 XSETFRAME (frame, f);
3115
5af5757b
KS
3116 if (width != FRAME_COLS (f)
3117 || height != FRAME_LINES (f)
3118 || f->new_text_lines || f->new_text_cols)
972f4259
KS
3119 Fset_frame_size (frame, make_number (width), make_number (height));
3120
3121 if ((!NILP (left) || !NILP (top))
3122 && ! (left_no_change && top_no_change)
5af5757b
KS
3123 && ! (NUMBERP (left) && XINT (left) == f->left_pos
3124 && NUMBERP (top) && XINT (top) == f->top_pos))
972f4259
KS
3125 {
3126 int leftpos = 0;
3127 int toppos = 0;
3128
3129 /* Record the signs. */
5af5757b 3130 f->size_hint_flags &= ~ (XNegative | YNegative);
972f4259 3131 if (EQ (left, Qminus))
5af5757b 3132 f->size_hint_flags |= XNegative;
972f4259
KS
3133 else if (INTEGERP (left))
3134 {
3135 leftpos = XINT (left);
3136 if (leftpos < 0)
5af5757b 3137 f->size_hint_flags |= XNegative;
972f4259
KS
3138 }
3139 else if (CONSP (left) && EQ (XCAR (left), Qminus)
3140 && CONSP (XCDR (left))
3141 && INTEGERP (XCAR (XCDR (left))))
3142 {
3143 leftpos = - XINT (XCAR (XCDR (left)));
5af5757b 3144 f->size_hint_flags |= XNegative;
972f4259
KS
3145 }
3146 else if (CONSP (left) && EQ (XCAR (left), Qplus)
3147 && CONSP (XCDR (left))
3148 && INTEGERP (XCAR (XCDR (left))))
3149 {
3150 leftpos = XINT (XCAR (XCDR (left)));
3151 }
3152
3153 if (EQ (top, Qminus))
5af5757b 3154 f->size_hint_flags |= YNegative;
972f4259
KS
3155 else if (INTEGERP (top))
3156 {
3157 toppos = XINT (top);
3158 if (toppos < 0)
5af5757b 3159 f->size_hint_flags |= YNegative;
972f4259
KS
3160 }
3161 else if (CONSP (top) && EQ (XCAR (top), Qminus)
3162 && CONSP (XCDR (top))
3163 && INTEGERP (XCAR (XCDR (top))))
3164 {
3165 toppos = - XINT (XCAR (XCDR (top)));
5af5757b 3166 f->size_hint_flags |= YNegative;
972f4259
KS
3167 }
3168 else if (CONSP (top) && EQ (XCAR (top), Qplus)
3169 && CONSP (XCDR (top))
3170 && INTEGERP (XCAR (XCDR (top))))
3171 {
3172 toppos = XINT (XCAR (XCDR (top)));
3173 }
3174
3175
3176 /* Store the numeric value of the position. */
5af5757b
KS
3177 f->top_pos = toppos;
3178 f->left_pos = leftpos;
972f4259 3179
5af5757b 3180 f->win_gravity = NorthWestGravity;
972f4259
KS
3181
3182 /* Actually set that position, and convert to absolute. */
3183 x_set_offset (f, leftpos, toppos, -1);
3184 }
3185
3186 if ((!NILP (icon_left) || !NILP (icon_top))
3187 && ! (icon_left_no_change && icon_top_no_change))
3188 x_wm_set_icon_position (f, XINT (icon_left), XINT (icon_top));
3189 }
3190
3191 UNGCPRO;
3192}
3193
3194
3195/* Insert a description of internally-recorded parameters of frame X
3196 into the parameter alist *ALISTPTR that is to be given to the user.
3197 Only parameters that are specific to the X window system
3198 and whose values are not correctly recorded in the frame's
3199 param_alist need to be considered here. */
3200
3201void
3202x_report_frame_params (f, alistptr)
3203 struct frame *f;
3204 Lisp_Object *alistptr;
3205{
3206 char buf[16];
3207 Lisp_Object tem;
3208
3209 /* Represent negative positions (off the top or left screen edge)
3210 in a way that Fmodify_frame_parameters will understand correctly. */
5af5757b
KS
3211 XSETINT (tem, f->left_pos);
3212 if (f->left_pos >= 0)
972f4259
KS
3213 store_in_alist (alistptr, Qleft, tem);
3214 else
3215 store_in_alist (alistptr, Qleft, Fcons (Qplus, Fcons (tem, Qnil)));
3216
5af5757b
KS
3217 XSETINT (tem, f->top_pos);
3218 if (f->top_pos >= 0)
972f4259
KS
3219 store_in_alist (alistptr, Qtop, tem);
3220 else
3221 store_in_alist (alistptr, Qtop, Fcons (Qplus, Fcons (tem, Qnil)));
3222
3223 store_in_alist (alistptr, Qborder_width,
5af5757b 3224 make_number (f->border_width));
972f4259 3225 store_in_alist (alistptr, Qinternal_border_width,
5af5757b 3226 make_number (FRAME_INTERNAL_BORDER_WIDTH (f)));
972f4259 3227 store_in_alist (alistptr, Qleft_fringe,
5af5757b 3228 make_number (FRAME_LEFT_FRINGE_WIDTH (f)));
972f4259 3229 store_in_alist (alistptr, Qright_fringe,
5af5757b 3230 make_number (FRAME_RIGHT_FRINGE_WIDTH (f)));
972f4259
KS
3231 store_in_alist (alistptr, Qscroll_bar_width,
3232 (! FRAME_HAS_VERTICAL_SCROLL_BARS (f)
3233 ? make_number (0)
5af5757b
KS
3234 : FRAME_CONFIG_SCROLL_BAR_WIDTH (f) > 0
3235 ? make_number (FRAME_CONFIG_SCROLL_BAR_WIDTH (f))
972f4259
KS
3236 /* nil means "use default width"
3237 for non-toolkit scroll bar.
3238 ruler-mode.el depends on this. */
3239 : Qnil));
3240 sprintf (buf, "%ld", (long) FRAME_X_WINDOW (f));
3241 store_in_alist (alistptr, Qwindow_id,
3242 build_string (buf));
3243#ifdef HAVE_X_WINDOWS
3244#ifdef USE_X_TOOLKIT
3245 /* Tooltip frame may not have this widget. */
3246 if (FRAME_X_OUTPUT (f)->widget)
3247#endif
3248 sprintf (buf, "%ld", (long) FRAME_OUTER_WINDOW (f));
3249 store_in_alist (alistptr, Qouter_window_id,
3250 build_string (buf));
3251#endif
3252 store_in_alist (alistptr, Qicon_name, f->icon_name);
3253 FRAME_SAMPLE_VISIBILITY (f);
3254 store_in_alist (alistptr, Qvisibility,
3255 (FRAME_VISIBLE_P (f) ? Qt
3256 : FRAME_ICONIFIED_P (f) ? Qicon : Qnil));
3257 store_in_alist (alistptr, Qdisplay,
3258 XCAR (FRAME_X_DISPLAY_INFO (f)->name_list_element));
3259
3260 if (FRAME_X_OUTPUT (f)->parent_desc == FRAME_X_DISPLAY_INFO (f)->root_window)
3261 tem = Qnil;
3262 else
3263 XSETFASTINT (tem, FRAME_X_OUTPUT (f)->parent_desc);
5839d7e8 3264 store_in_alist (alistptr, Qexplicit_name, (f->explicit_name ? Qt : Qnil));
972f4259
KS
3265 store_in_alist (alistptr, Qparent_id, tem);
3266}
3267
3268
3269/* Change the `fullscreen' frame parameter of frame F. OLD_VALUE is
3270 the previous value of that parameter, NEW_VALUE is the new value. */
3271
3272void
3273x_set_fullscreen (f, new_value, old_value)
3274 struct frame *f;
3275 Lisp_Object new_value, old_value;
3276{
972f4259 3277 if (NILP (new_value))
5af5757b 3278 f->want_fullscreen = FULLSCREEN_NONE;
972f4259 3279 else if (EQ (new_value, Qfullboth))
5af5757b 3280 f->want_fullscreen = FULLSCREEN_BOTH;
972f4259 3281 else if (EQ (new_value, Qfullwidth))
5af5757b 3282 f->want_fullscreen = FULLSCREEN_WIDTH;
972f4259 3283 else if (EQ (new_value, Qfullheight))
5af5757b 3284 f->want_fullscreen = FULLSCREEN_HEIGHT;
d761dd42 3285
a3547743 3286 if (FRAME_TERMINAL (f)->fullscreen_hook != NULL)
974b73e8 3287 FRAME_TERMINAL (f)->fullscreen_hook (f);
972f4259
KS
3288}
3289
3290
3291/* Change the `line-spacing' frame parameter of frame F. OLD_VALUE is
3292 the previous value of that parameter, NEW_VALUE is the new value. */
3293
3294void
3295x_set_line_spacing (f, new_value, old_value)
3296 struct frame *f;
3297 Lisp_Object new_value, old_value;
3298{
3299 if (NILP (new_value))
3300 f->extra_line_spacing = 0;
3301 else if (NATNUMP (new_value))
3302 f->extra_line_spacing = XFASTINT (new_value);
3303 else
9dc95187 3304 signal_error ("Invalid line-spacing", new_value);
972f4259
KS
3305 if (FRAME_VISIBLE_P (f))
3306 redraw_frame (f);
3307}
3308
3309
3310/* Change the `screen-gamma' frame parameter of frame F. OLD_VALUE is
3311 the previous value of that parameter, NEW_VALUE is the new value. */
3312
3313void
3314x_set_screen_gamma (f, new_value, old_value)
3315 struct frame *f;
3316 Lisp_Object new_value, old_value;
3317{
05fc2ef7
CY
3318 Lisp_Object bgcolor;
3319
972f4259
KS
3320 if (NILP (new_value))
3321 f->gamma = 0;
3322 else if (NUMBERP (new_value) && XFLOATINT (new_value) > 0)
05fc2ef7
CY
3323 /* The value 0.4545 is the normal viewing gamma. */
3324 f->gamma = 1.0 / (0.4545 * XFLOATINT (new_value));
972f4259 3325 else
9dc95187 3326 signal_error ("Invalid screen-gamma", new_value);
972f4259 3327
05fc2ef7
CY
3328 /* Apply the new gamma value to the frame background. */
3329 bgcolor = Fassq (Qbackground_color, f->param_alist);
3330 if (CONSP (bgcolor) && (bgcolor = XCDR (bgcolor), STRINGP (bgcolor)))
3331 {
3332 Lisp_Object index = Fget (Qbackground_color, Qx_frame_parameter);
3333 if (NATNUMP (index)
3334 && (XFASTINT (index)
3335 < sizeof (frame_parms)/sizeof (frame_parms[0]))
6baa22c1
KL
3336 && FRAME_RIF (f)->frame_parm_handlers[XFASTINT (index)])
3337 (*FRAME_RIF (f)->frame_parm_handlers[XFASTINT (index)])
3338 (f, bgcolor, Qnil);
05fc2ef7
CY
3339 }
3340
3341 Fclear_face_cache (Qnil);
972f4259
KS
3342}
3343
3344
3345void
3346x_set_font (f, arg, oldval)
3347 struct frame *f;
3348 Lisp_Object arg, oldval;
3349{
3350 Lisp_Object result;
3351 Lisp_Object fontset_name;
3352 Lisp_Object frame;
3353 int old_fontset = FRAME_FONTSET(f);
3354
698ca23e
KH
3355#ifdef USE_FONT_BACKEND
3356 if (enable_font_backend)
0169d360
KH
3357 {
3358 int fontset = -1;
3359 Lisp_Object font_object;
3360
3361 /* ARG is a fontset name, a font name, or a font object.
3362 In the last case, this function never fail. */
3363 if (STRINGP (arg))
3364 {
66309f75 3365 fontset = fs_query_fontset (arg, 0);
0169d360
KH
3366 if (fontset < 0)
3367 font_object = font_open_by_name (f, SDATA (arg));
3368 else if (fontset > 0)
3369 {
3370 Lisp_Object ascii_font = fontset_ascii (fontset);
3371
35e7c6bc 3372 font_object = font_open_by_name (f, SDATA (ascii_font));
0169d360
KH
3373 }
3374 }
3375 else
3376 font_object = arg;
3377
3378 if (fontset < 0 && ! NILP (font_object))
3379 fontset = new_fontset_from_font (font_object);
3380
3381 if (fontset == 0)
3382 /* Refuse the default fontset. */
3383 result = Qt;
3384 else if (NILP (font_object))
3385 result = Qnil;
3386 else
3387 result = x_new_fontset2 (f, fontset, font_object);
3388 }
698ca23e
KH
3389 else
3390 {
3391#endif /* USE_FONT_BACKEND */
972f4259
KS
3392 CHECK_STRING (arg);
3393
3394 fontset_name = Fquery_fontset (arg, Qnil);
3395
3396 BLOCK_INPUT;
3397 result = (STRINGP (fontset_name)
8f924df7
KH
3398 ? x_new_fontset (f, fontset_name)
3399 : x_new_fontset (f, arg));
972f4259 3400 UNBLOCK_INPUT;
698ca23e
KH
3401#ifdef USE_FONT_BACKEND
3402 }
3403#endif
972f4259
KS
3404
3405 if (EQ (result, Qnil))
3406 error ("Font `%s' is not defined", SDATA (arg));
3407 else if (EQ (result, Qt))
8f924df7 3408 error ("The default fontset can't be used for a frame font");
972f4259
KS
3409 else if (STRINGP (result))
3410 {
ee5d57b0 3411 set_default_ascii_font (result);
972f4259
KS
3412 if (STRINGP (fontset_name))
3413 {
3414 /* Fontset names are built from ASCII font names, so the
3415 names may be equal despite there was a change. */
3416 if (old_fontset == FRAME_FONTSET (f))
3417 return;
3418 }
8f924df7 3419 store_frame_param (f, Qfont, result);
fe682fb2 3420
8f924df7 3421 if (!NILP (Fequal (result, oldval)))
972f4259
KS
3422 return;
3423
ca03f883
KS
3424 /* Recalculate toolbar height. */
3425 f->n_tool_bar_rows = 0;
3426 /* Ensure we redraw it. */
3427 clear_current_matrices (f);
3428
972f4259
KS
3429 recompute_basic_faces (f);
3430 }
3431 else
3432 abort ();
3433
3434 do_pending_window_change (0);
3435
3436 /* Don't call `face-set-after-frame-default' when faces haven't been
3437 initialized yet. This is the case when called from
3438 Fx_create_frame. In that case, the X widget or window doesn't
3439 exist either, and we can end up in x_report_frame_params with a
3440 null widget which gives a segfault. */
3441 if (FRAME_FACE_CACHE (f))
3442 {
3443 XSETFRAME (frame, f);
3444 call1 (Qface_set_after_frame_default, frame);
3445 }
3446}
3447
3448
1a356571
KH
3449#ifdef USE_FONT_BACKEND
3450void
3451x_set_font_backend (f, new_value, old_value)
3452 struct frame *f;
3453 Lisp_Object new_value, old_value;
3454{
1a356571
KH
3455 if (! NILP (new_value)
3456 && !CONSP (new_value))
3457 {
3458 char *p0, *p1;
3459
3460 CHECK_STRING (new_value);
3461 p0 = p1 = SDATA (new_value);
3462 new_value = Qnil;
3463 while (*p0)
3464 {
3465 while (*p1 && *p1 != ',') p1++;
3466 if (p0 < p1)
3467 new_value = Fcons (Fintern (make_string (p0, p1 - p0), Qnil),
3468 new_value);
3469 if (*p1)
3470 p1++;
3471 p0 = p1;
3472 }
8fb9e675
KH
3473 new_value = Fnreverse (new_value);
3474 }
3475
3476 if (! NILP (old_value) && ! NILP (Fequal (old_value, new_value)))
3477 return;
3478
3479 if (FRAME_FONT_OBJECT (f))
dfdf55c0 3480 free_all_realized_faces (Qnil);
1a356571 3481
dfdf55c0 3482 new_value = font_update_drivers (f, NILP (new_value) ? Qt : new_value);
8fb9e675 3483 if (NILP (new_value))
dfdf55c0
KH
3484 {
3485 if (NILP (old_value))
3486 error ("No font backend available");
3487 font_update_drivers (f, old_value);
3488 error ("None of specified font backends are available");
3489 }
8fb9e675
KH
3490 store_frame_param (f, Qfont_backend, new_value);
3491
3492 if (FRAME_FONT_OBJECT (f))
3493 {
3494 Lisp_Object frame;
3495
3496 XSETFRAME (frame, f);
3497 x_set_font (f, Fframe_parameter (frame, Qfont), Qnil);
3498 ++face_change_count;
3499 ++windows_or_buffers_changed;
3500 }
1a356571
KH
3501}
3502#endif /* USE_FONT_BACKEND */
3503
3504
972f4259
KS
3505void
3506x_set_fringe_width (f, new_value, old_value)
3507 struct frame *f;
3508 Lisp_Object new_value, old_value;
3509{
3510 compute_fringe_widths (f, 1);
3511}
3512
3513void
3514x_set_border_width (f, arg, oldval)
3515 struct frame *f;
3516 Lisp_Object arg, oldval;
3517{
3518 CHECK_NUMBER (arg);
3519
5af5757b 3520 if (XINT (arg) == f->border_width)
972f4259
KS
3521 return;
3522
972f4259 3523 if (FRAME_X_WINDOW (f) != 0)
dac85f4b 3524 error ("Cannot change the border width of a frame");
972f4259 3525
5af5757b 3526 f->border_width = XINT (arg);
972f4259
KS
3527}
3528
3529void
3530x_set_internal_border_width (f, arg, oldval)
3531 struct frame *f;
3532 Lisp_Object arg, oldval;
3533{
5af5757b 3534 int old = FRAME_INTERNAL_BORDER_WIDTH (f);
972f4259
KS
3535
3536 CHECK_NUMBER (arg);
5af5757b
KS
3537 FRAME_INTERNAL_BORDER_WIDTH (f) = XINT (arg);
3538 if (FRAME_INTERNAL_BORDER_WIDTH (f) < 0)
3539 FRAME_INTERNAL_BORDER_WIDTH (f) = 0;
972f4259
KS
3540
3541#ifdef USE_X_TOOLKIT
3542 if (FRAME_X_OUTPUT (f)->edit_widget)
3543 widget_store_internal_border (FRAME_X_OUTPUT (f)->edit_widget);
3544#endif
3545
5af5757b 3546 if (FRAME_INTERNAL_BORDER_WIDTH (f) == old)
972f4259
KS
3547 return;
3548
3549 if (FRAME_X_WINDOW (f) != 0)
3550 {
5af5757b 3551 x_set_window_size (f, 0, FRAME_COLS (f), FRAME_LINES (f));
972f4259
KS
3552 SET_FRAME_GARBAGED (f);
3553 do_pending_window_change (0);
3554 }
3555 else
3556 SET_FRAME_GARBAGED (f);
3557}
3558
3559void
3560x_set_visibility (f, value, oldval)
3561 struct frame *f;
3562 Lisp_Object value, oldval;
3563{
3564 Lisp_Object frame;
3565 XSETFRAME (frame, f);
3566
3567 if (NILP (value))
3568 Fmake_frame_invisible (frame, Qt);
3569 else if (EQ (value, Qicon))
3570 Ficonify_frame (frame);
3571 else
3572 Fmake_frame_visible (frame);
3573}
3574
3575void
3576x_set_autoraise (f, arg, oldval)
3577 struct frame *f;
3578 Lisp_Object arg, oldval;
3579{
3580 f->auto_raise = !EQ (Qnil, arg);
3581}
3582
3583void
3584x_set_autolower (f, arg, oldval)
3585 struct frame *f;
3586 Lisp_Object arg, oldval;
3587{
3588 f->auto_lower = !EQ (Qnil, arg);
3589}
3590
3591void
3592x_set_unsplittable (f, arg, oldval)
3593 struct frame *f;
3594 Lisp_Object arg, oldval;
3595{
3596 f->no_split = !NILP (arg);
3597}
3598
3599void
3600x_set_vertical_scroll_bars (f, arg, oldval)
3601 struct frame *f;
3602 Lisp_Object arg, oldval;
3603{
3604 if ((EQ (arg, Qleft) && FRAME_HAS_VERTICAL_SCROLL_BARS_ON_RIGHT (f))
3605 || (EQ (arg, Qright) && FRAME_HAS_VERTICAL_SCROLL_BARS_ON_LEFT (f))
3606 || (NILP (arg) && FRAME_HAS_VERTICAL_SCROLL_BARS (f))
3607 || (!NILP (arg) && ! FRAME_HAS_VERTICAL_SCROLL_BARS (f)))
3608 {
3609 FRAME_VERTICAL_SCROLL_BAR_TYPE (f)
3610 = (NILP (arg)
3611 ? vertical_scroll_bar_none
3612 : EQ (Qleft, arg)
3613 ? vertical_scroll_bar_left
3614 : EQ (Qright, arg)
3615 ? vertical_scroll_bar_right
6b61353c
KH
3616 : EQ (Qleft, Vdefault_frame_scroll_bars)
3617 ? vertical_scroll_bar_left
3618 : EQ (Qright, Vdefault_frame_scroll_bars)
3619 ? vertical_scroll_bar_right
3620 : vertical_scroll_bar_none);
972f4259
KS
3621
3622 /* We set this parameter before creating the X window for the
3623 frame, so we can get the geometry right from the start.
3624 However, if the window hasn't been created yet, we shouldn't
3625 call x_set_window_size. */
3626 if (FRAME_X_WINDOW (f))
5af5757b 3627 x_set_window_size (f, 0, FRAME_COLS (f), FRAME_LINES (f));
972f4259
KS
3628 do_pending_window_change (0);
3629 }
3630}
3631
3632void
3633x_set_scroll_bar_width (f, arg, oldval)
3634 struct frame *f;
3635 Lisp_Object arg, oldval;
3636{
5af5757b 3637 int wid = FRAME_COLUMN_WIDTH (f);
972f4259
KS
3638
3639 if (NILP (arg))
3640 {
3641 x_set_scroll_bar_default_width (f);
3642
3643 if (FRAME_X_WINDOW (f))
5af5757b 3644 x_set_window_size (f, 0, FRAME_COLS (f), FRAME_LINES (f));
972f4259
KS
3645 do_pending_window_change (0);
3646 }
3647 else if (INTEGERP (arg) && XINT (arg) > 0
5af5757b 3648 && XFASTINT (arg) != FRAME_CONFIG_SCROLL_BAR_WIDTH (f))
972f4259
KS
3649 {
3650 if (XFASTINT (arg) <= 2 * VERTICAL_SCROLL_BAR_WIDTH_TRIM)
3651 XSETINT (arg, 2 * VERTICAL_SCROLL_BAR_WIDTH_TRIM + 1);
3652
5af5757b
KS
3653 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = XFASTINT (arg);
3654 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (XFASTINT (arg) + wid-1) / wid;
972f4259 3655 if (FRAME_X_WINDOW (f))
5af5757b 3656 x_set_window_size (f, 0, FRAME_COLS (f), FRAME_LINES (f));
972f4259
KS
3657 do_pending_window_change (0);
3658 }
3659
5af5757b 3660 change_frame_size (f, 0, FRAME_COLS (f), 0, 0, 0);
972f4259
KS
3661 XWINDOW (FRAME_SELECTED_WINDOW (f))->cursor.hpos = 0;
3662 XWINDOW (FRAME_SELECTED_WINDOW (f))->cursor.x = 0;
3663}
3664
3665
3666
3667/* Return non-nil if frame F wants a bitmap icon. */
3668
3669Lisp_Object
3670x_icon_type (f)
3671 FRAME_PTR f;
3672{
3673 Lisp_Object tem;
3674
3675 tem = assq_no_quit (Qicon_type, f->param_alist);
3676 if (CONSP (tem))
3677 return XCDR (tem);
3678 else
3679 return Qnil;
3680}
3681
3682\f
3683/* Subroutines of creating an X frame. */
3684
3685/* Make sure that Vx_resource_name is set to a reasonable value.
3686 Fix it up, or set it to `emacs' if it is too hopeless. */
3687
3688void
3689validate_x_resource_name ()
3690{
3691 int len = 0;
3692 /* Number of valid characters in the resource name. */
3693 int good_count = 0;
3694 /* Number of invalid characters in the resource name. */
3695 int bad_count = 0;
3696 Lisp_Object new;
3697 int i;
3698
3699 if (!STRINGP (Vx_resource_class))
3700 Vx_resource_class = build_string (EMACS_CLASS);
3701
3702 if (STRINGP (Vx_resource_name))
3703 {
3704 unsigned char *p = SDATA (Vx_resource_name);
3705 int i;
3706
3707 len = SBYTES (Vx_resource_name);
3708
3709 /* Only letters, digits, - and _ are valid in resource names.
3710 Count the valid characters and count the invalid ones. */
3711 for (i = 0; i < len; i++)
3712 {
3713 int c = p[i];
3714 if (! ((c >= 'a' && c <= 'z')
3715 || (c >= 'A' && c <= 'Z')
3716 || (c >= '0' && c <= '9')
3717 || c == '-' || c == '_'))
3718 bad_count++;
3719 else
3720 good_count++;
3721 }
3722 }
3723 else
3724 /* Not a string => completely invalid. */
3725 bad_count = 5, good_count = 0;
3726
3727 /* If name is valid already, return. */
3728 if (bad_count == 0)
3729 return;
3730
3731 /* If name is entirely invalid, or nearly so, use `emacs'. */
3732 if (good_count == 0
3733 || (good_count == 1 && bad_count > 0))
3734 {
3735 Vx_resource_name = build_string ("emacs");
3736 return;
3737 }
3738
3739 /* Name is partly valid. Copy it and replace the invalid characters
3740 with underscores. */
3741
3742 Vx_resource_name = new = Fcopy_sequence (Vx_resource_name);
3743
3744 for (i = 0; i < len; i++)
3745 {
3746 int c = SREF (new, i);
3747 if (! ((c >= 'a' && c <= 'z')
3748 || (c >= 'A' && c <= 'Z')
3749 || (c >= '0' && c <= '9')
3750 || c == '-' || c == '_'))
3751 SSET (new, i, '_');
3752 }
3753}
3754
3755
3756extern char *x_get_string_resource P_ ((XrmDatabase, char *, char *));
3757extern Display_Info *check_x_display_info P_ ((Lisp_Object));
3758
3759
b5251fe7 3760/* Get specified attribute from resource database RDB.
972f4259
KS
3761 See Fx_get_resource below for other parameters. */
3762
3763static Lisp_Object
3764xrdb_get_resource (rdb, attribute, class, component, subclass)
3765 XrmDatabase rdb;
3766 Lisp_Object attribute, class, component, subclass;
3767{
3768 register char *value;
3769 char *name_key;
3770 char *class_key;
3771
3772 CHECK_STRING (attribute);
3773 CHECK_STRING (class);
3774
3775 if (!NILP (component))
3776 CHECK_STRING (component);
3777 if (!NILP (subclass))
3778 CHECK_STRING (subclass);
3779 if (NILP (component) != NILP (subclass))
3780 error ("x-get-resource: must specify both COMPONENT and SUBCLASS or neither");
3781
3782 validate_x_resource_name ();
3783
3784 /* Allocate space for the components, the dots which separate them,
3785 and the final '\0'. Make them big enough for the worst case. */
3786 name_key = (char *) alloca (SBYTES (Vx_resource_name)
3787 + (STRINGP (component)
3788 ? SBYTES (component) : 0)
3789 + SBYTES (attribute)
3790 + 3);
3791
3792 class_key = (char *) alloca (SBYTES (Vx_resource_class)
3793 + SBYTES (class)
3794 + (STRINGP (subclass)
3795 ? SBYTES (subclass) : 0)
3796 + 3);
3797
3798 /* Start with emacs.FRAMENAME for the name (the specific one)
3799 and with `Emacs' for the class key (the general one). */
3800 strcpy (name_key, SDATA (Vx_resource_name));
3801 strcpy (class_key, SDATA (Vx_resource_class));
3802
3803 strcat (class_key, ".");
3804 strcat (class_key, SDATA (class));
3805
3806 if (!NILP (component))
3807 {
3808 strcat (class_key, ".");
3809 strcat (class_key, SDATA (subclass));
3810
3811 strcat (name_key, ".");
3812 strcat (name_key, SDATA (component));
3813 }
3814
3815 strcat (name_key, ".");
3816 strcat (name_key, SDATA (attribute));
3817
3818 value = x_get_string_resource (rdb, name_key, class_key);
3819
3820 if (value != (char *) 0)
3821 return build_string (value);
3822 else
3823 return Qnil;
3824}
3825
3826
3827DEFUN ("x-get-resource", Fx_get_resource, Sx_get_resource, 2, 4, 0,
3828 doc: /* Return the value of ATTRIBUTE, of class CLASS, from the X defaults database.
3829This uses `INSTANCE.ATTRIBUTE' as the key and `Emacs.CLASS' as the
3830class, where INSTANCE is the name under which Emacs was invoked, or
3831the name specified by the `-name' or `-rn' command-line arguments.
3832
3833The optional arguments COMPONENT and SUBCLASS add to the key and the
3834class, respectively. You must specify both of them or neither.
3835If you specify them, the key is `INSTANCE.COMPONENT.ATTRIBUTE'
3836and the class is `Emacs.CLASS.SUBCLASS'. */)
3837 (attribute, class, component, subclass)
3838 Lisp_Object attribute, class, component, subclass;
3839{
3840#ifdef HAVE_X_WINDOWS
3841 check_x ();
3842#endif
3843
3844 return xrdb_get_resource (check_x_display_info (Qnil)->xrdb,
3845 attribute, class, component, subclass);
3846}
3847
3848/* Get an X resource, like Fx_get_resource, but for display DPYINFO. */
3849
3850Lisp_Object
3851display_x_get_resource (dpyinfo, attribute, class, component, subclass)
a1702920 3852 Display_Info *dpyinfo;
972f4259
KS
3853 Lisp_Object attribute, class, component, subclass;
3854{
3855 return xrdb_get_resource (dpyinfo->xrdb,
3856 attribute, class, component, subclass);
3857}
3858
3859/* Used when C code wants a resource value. */
3860
3861char *
3862x_get_resource_string (attribute, class)
3863 char *attribute, *class;
3864{
3865 char *name_key;
3866 char *class_key;
3867 struct frame *sf = SELECTED_FRAME ();
3868
3869 /* Allocate space for the components, the dots which separate them,
3870 and the final '\0'. */
3871 name_key = (char *) alloca (SBYTES (Vinvocation_name)
3872 + strlen (attribute) + 2);
3873 class_key = (char *) alloca ((sizeof (EMACS_CLASS) - 1)
3874 + strlen (class) + 2);
3875
3876 sprintf (name_key, "%s.%s", SDATA (Vinvocation_name), attribute);
3877 sprintf (class_key, "%s.%s", EMACS_CLASS, class);
3878
3879 return x_get_string_resource (FRAME_X_DISPLAY_INFO (sf)->xrdb,
3880 name_key, class_key);
3881}
3882
3883
3884/* Return the value of parameter PARAM.
3885
3886 First search ALIST, then Vdefault_frame_alist, then the X defaults
3887 database, using ATTRIBUTE as the attribute name and CLASS as its class.
3888
3889 Convert the resource to the type specified by desired_type.
3890
3891 If no default is specified, return Qunbound. If you call
3892 x_get_arg, make sure you deal with Qunbound in a reasonable way,
3893 and don't let it get stored in any Lisp-visible variables! */
3894
3895Lisp_Object
3896x_get_arg (dpyinfo, alist, param, attribute, class, type)
b5251fe7 3897 Display_Info *dpyinfo;
972f4259
KS
3898 Lisp_Object alist, param;
3899 char *attribute;
3900 char *class;
3901 enum resource_types type;
3902{
3903 register Lisp_Object tem;
3904
3905 tem = Fassq (param, alist);
d00368cf
RS
3906
3907 if (!NILP (tem))
3908 {
3909 /* If we find this parm in ALIST, clear it out
3910 so that it won't be "left over" at the end. */
58ec2913 3911#ifndef WINDOWSNT /* w32fns.c has not yet been changed to cope with this. */
5f694926 3912 Lisp_Object tail;
d00368cf 3913 XSETCAR (tem, Qnil);
5f694926
RS
3914 /* In case the parameter appears more than once in the alist,
3915 clear it out. */
3916 for (tail = alist; CONSP (tail); tail = XCDR (tail))
3917 if (CONSP (XCAR (tail))
3918 && EQ (XCAR (XCAR (tail)), param))
3919 XSETCAR (XCAR (tail), Qnil);
d00368cf
RS
3920#endif
3921 }
3922 else
972f4259 3923 tem = Fassq (param, Vdefault_frame_alist);
d00368cf
RS
3924
3925 /* If it wasn't specified in ALIST or the Lisp-level defaults,
3926 look in the X resources. */
972f4259
KS
3927 if (EQ (tem, Qnil))
3928 {
3929 if (attribute)
3930 {
3931 tem = display_x_get_resource (dpyinfo,
3932 build_string (attribute),
3933 build_string (class),
3934 Qnil, Qnil);
3935
3936 if (NILP (tem))
3937 return Qunbound;
3938
3939 switch (type)
3940 {
3941 case RES_TYPE_NUMBER:
3942 return make_number (atoi (SDATA (tem)));
3943
3944 case RES_TYPE_FLOAT:
3945 return make_float (atof (SDATA (tem)));
3946
3947 case RES_TYPE_BOOLEAN:
3948 tem = Fdowncase (tem);
3949 if (!strcmp (SDATA (tem), "on")
3950 || !strcmp (SDATA (tem), "true"))
3951 return Qt;
3952 else
3953 return Qnil;
3954
3955 case RES_TYPE_STRING:
3956 return tem;
3957
3958 case RES_TYPE_SYMBOL:
3959 /* As a special case, we map the values `true' and `on'
3960 to Qt, and `false' and `off' to Qnil. */
3961 {
3962 Lisp_Object lower;
3963 lower = Fdowncase (tem);
3964 if (!strcmp (SDATA (lower), "on")
3965 || !strcmp (SDATA (lower), "true"))
3966 return Qt;
3967 else if (!strcmp (SDATA (lower), "off")
3968 || !strcmp (SDATA (lower), "false"))
3969 return Qnil;
3970 else
3971 return Fintern (tem, Qnil);
3972 }
3973
3974 default:
3975 abort ();
3976 }
3977 }
3978 else
3979 return Qunbound;
3980 }
3981 return Fcdr (tem);
3982}
3983
3984Lisp_Object
3985x_frame_get_arg (f, alist, param, attribute, class, type)
3986 struct frame *f;
3987 Lisp_Object alist, param;
3988 char *attribute;
3989 char *class;
3990 enum resource_types type;
3991{
3992 return x_get_arg (FRAME_X_DISPLAY_INFO (f),
3993 alist, param, attribute, class, type);
3994}
3995
3996/* Like x_frame_get_arg, but also record the value in f->param_alist. */
3997
3998Lisp_Object
3999x_frame_get_and_record_arg (f, alist, param, attribute, class, type)
4000 struct frame *f;
4001 Lisp_Object alist, param;
4002 char *attribute;
4003 char *class;
4004 enum resource_types type;
4005{
4006 Lisp_Object value;
4007
4008 value = x_get_arg (FRAME_X_DISPLAY_INFO (f), alist, param,
4009 attribute, class, type);
edd1c685 4010 if (! NILP (value) && ! EQ (value, Qunbound))
972f4259
KS
4011 store_frame_param (f, param, value);
4012
4013 return value;
4014}
4015
4016
4017/* Record in frame F the specified or default value according to ALIST
4018 of the parameter named PROP (a Lisp symbol).
4019 If no value is specified for PROP, look for an X default for XPROP
4020 on the frame named NAME.
4021 If that is not found either, use the value DEFLT. */
4022
4023Lisp_Object
4024x_default_parameter (f, alist, prop, deflt, xprop, xclass, type)
4025 struct frame *f;
4026 Lisp_Object alist;
4027 Lisp_Object prop;
4028 Lisp_Object deflt;
4029 char *xprop;
4030 char *xclass;
4031 enum resource_types type;
4032{
4033 Lisp_Object tem;
4034
4035 tem = x_frame_get_arg (f, alist, prop, xprop, xclass, type);
4036 if (EQ (tem, Qunbound))
4037 tem = deflt;
4038 x_set_frame_parameters (f, Fcons (Fcons (prop, tem), Qnil));
4039 return tem;
4040}
4041
4042
4043
4044\f
4045DEFUN ("x-parse-geometry", Fx_parse_geometry, Sx_parse_geometry, 1, 1, 0,
4046 doc: /* Parse an X-style geometry string STRING.
4047Returns an alist of the form ((top . TOP), (left . LEFT) ... ).
4048The properties returned may include `top', `left', `height', and `width'.
4049The value of `left' or `top' may be an integer,
4050or a list (+ N) meaning N pixels relative to top/left corner,
4051or a list (- N) meaning -N pixels relative to bottom/right corner. */)
4052 (string)
4053 Lisp_Object string;
4054{
4055 int geometry, x, y;
4056 unsigned int width, height;
4057 Lisp_Object result;
4058
4059 CHECK_STRING (string);
4060
4061 geometry = XParseGeometry ((char *) SDATA (string),
4062 &x, &y, &width, &height);
4063
4064#if 0
4065 if (!!(geometry & XValue) != !!(geometry & YValue))
4066 error ("Must specify both x and y position, or neither");
4067#endif
4068
4069 result = Qnil;
4070 if (geometry & XValue)
4071 {
4072 Lisp_Object element;
4073
4074 if (x >= 0 && (geometry & XNegative))
4075 element = Fcons (Qleft, Fcons (Qminus, Fcons (make_number (-x), Qnil)));
4076 else if (x < 0 && ! (geometry & XNegative))
4077 element = Fcons (Qleft, Fcons (Qplus, Fcons (make_number (x), Qnil)));
4078 else
4079 element = Fcons (Qleft, make_number (x));
4080 result = Fcons (element, result);
4081 }
4082
4083 if (geometry & YValue)
4084 {
4085 Lisp_Object element;
4086
4087 if (y >= 0 && (geometry & YNegative))
4088 element = Fcons (Qtop, Fcons (Qminus, Fcons (make_number (-y), Qnil)));
4089 else if (y < 0 && ! (geometry & YNegative))
4090 element = Fcons (Qtop, Fcons (Qplus, Fcons (make_number (y), Qnil)));
4091 else
4092 element = Fcons (Qtop, make_number (y));
4093 result = Fcons (element, result);
4094 }
4095
4096 if (geometry & WidthValue)
4097 result = Fcons (Fcons (Qwidth, make_number (width)), result);
4098 if (geometry & HeightValue)
4099 result = Fcons (Fcons (Qheight, make_number (height)), result);
4100
4101 return result;
4102}
4103
4104/* Calculate the desired size and position of frame F.
4105 Return the flags saying which aspects were specified.
4106
4107 Also set the win_gravity and size_hint_flags of F.
4108
4109 Adjust height for toolbar if TOOLBAR_P is 1.
4110
4111 This function does not make the coordinates positive. */
4112
4113#define DEFAULT_ROWS 40
4114#define DEFAULT_COLS 80
4115
4116int
4117x_figure_window_size (f, parms, toolbar_p)
4118 struct frame *f;
4119 Lisp_Object parms;
4120 int toolbar_p;
4121{
4122 register Lisp_Object tem0, tem1, tem2;
4123 long window_prompting = 0;
4124 Display_Info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
4125
4126 /* Default values if we fall through.
4127 Actually, if that happens we should get
4128 window manager prompting. */
5af5757b
KS
4129 SET_FRAME_COLS (f, DEFAULT_COLS);
4130 FRAME_LINES (f) = DEFAULT_ROWS;
972f4259
KS
4131 /* Window managers expect that if program-specified
4132 positions are not (0,0), they're intentional, not defaults. */
5af5757b
KS
4133 f->top_pos = 0;
4134 f->left_pos = 0;
972f4259 4135
5af5757b 4136 /* Ensure that old new_text_cols and new_text_lines will not override the
972f4259
KS
4137 values set here. */
4138 /* ++KFS: This was specific to W32, but seems ok for all platforms */
5af5757b 4139 f->new_text_cols = f->new_text_lines = 0;
972f4259
KS
4140
4141 tem0 = x_get_arg (dpyinfo, parms, Qheight, 0, 0, RES_TYPE_NUMBER);
4142 tem1 = x_get_arg (dpyinfo, parms, Qwidth, 0, 0, RES_TYPE_NUMBER);
4143 tem2 = x_get_arg (dpyinfo, parms, Quser_size, 0, 0, RES_TYPE_NUMBER);
4144 if (! EQ (tem0, Qunbound) || ! EQ (tem1, Qunbound))
4145 {
4146 if (!EQ (tem0, Qunbound))
4147 {
4148 CHECK_NUMBER (tem0);
5af5757b 4149 FRAME_LINES (f) = XINT (tem0);
972f4259
KS
4150 }
4151 if (!EQ (tem1, Qunbound))
4152 {
4153 CHECK_NUMBER (tem1);
5af5757b 4154 SET_FRAME_COLS (f, XINT (tem1));
972f4259
KS
4155 }
4156 if (!NILP (tem2) && !EQ (tem2, Qunbound))
4157 window_prompting |= USSize;
4158 else
4159 window_prompting |= PSize;
4160 }
4161
5af5757b
KS
4162 f->scroll_bar_actual_width
4163 = FRAME_SCROLL_BAR_COLS (f) * FRAME_COLUMN_WIDTH (f);
972f4259
KS
4164
4165 /* This used to be done _before_ calling x_figure_window_size, but
4166 since the height is reset here, this was really a no-op. I
4167 assume that moving it here does what Gerd intended (although he
4168 no longer can remember what that was... ++KFS, 2003-03-25. */
4169
4170 /* Add the tool-bar height to the initial frame height so that the
4171 user gets a text display area of the size he specified with -g or
4172 via .Xdefaults. Later changes of the tool-bar height don't
4173 change the frame size. This is done so that users can create
4174 tall Emacs frames without having to guess how tall the tool-bar
4175 will get. */
4176 if (toolbar_p && FRAME_TOOL_BAR_LINES (f))
4177 {
4178 int margin, relief, bar_height;
4179
4180 relief = (tool_bar_button_relief >= 0
4181 ? tool_bar_button_relief
4182 : DEFAULT_TOOL_BAR_BUTTON_RELIEF);
4183
4184 if (INTEGERP (Vtool_bar_button_margin)
4185 && XINT (Vtool_bar_button_margin) > 0)
4186 margin = XFASTINT (Vtool_bar_button_margin);
4187 else if (CONSP (Vtool_bar_button_margin)
4188 && INTEGERP (XCDR (Vtool_bar_button_margin))
4189 && XINT (XCDR (Vtool_bar_button_margin)) > 0)
4190 margin = XFASTINT (XCDR (Vtool_bar_button_margin));
4191 else
4192 margin = 0;
4193
4194 bar_height = DEFAULT_TOOL_BAR_IMAGE_HEIGHT + 2 * margin + 2 * relief;
5af5757b 4195 FRAME_LINES (f) += (bar_height + FRAME_LINE_HEIGHT (f) - 1) / FRAME_LINE_HEIGHT (f);
972f4259
KS
4196 }
4197
4198 compute_fringe_widths (f, 0);
4199
5af5757b
KS
4200 FRAME_PIXEL_WIDTH (f) = FRAME_TEXT_COLS_TO_PIXEL_WIDTH (f, FRAME_COLS (f));
4201 FRAME_PIXEL_HEIGHT (f) = FRAME_TEXT_LINES_TO_PIXEL_HEIGHT (f, FRAME_LINES (f));
972f4259
KS
4202
4203 tem0 = x_get_arg (dpyinfo, parms, Qtop, 0, 0, RES_TYPE_NUMBER);
4204 tem1 = x_get_arg (dpyinfo, parms, Qleft, 0, 0, RES_TYPE_NUMBER);
4205 tem2 = x_get_arg (dpyinfo, parms, Quser_position, 0, 0, RES_TYPE_NUMBER);
4206 if (! EQ (tem0, Qunbound) || ! EQ (tem1, Qunbound))
4207 {
4208 if (EQ (tem0, Qminus))
4209 {
5af5757b 4210 f->top_pos = 0;
972f4259
KS
4211 window_prompting |= YNegative;
4212 }
4213 else if (CONSP (tem0) && EQ (XCAR (tem0), Qminus)
4214 && CONSP (XCDR (tem0))
4215 && INTEGERP (XCAR (XCDR (tem0))))
4216 {
5af5757b 4217 f->top_pos = - XINT (XCAR (XCDR (tem0)));
972f4259
KS
4218 window_prompting |= YNegative;
4219 }
4220 else if (CONSP (tem0) && EQ (XCAR (tem0), Qplus)
4221 && CONSP (XCDR (tem0))
4222 && INTEGERP (XCAR (XCDR (tem0))))
4223 {
5af5757b 4224 f->top_pos = XINT (XCAR (XCDR (tem0)));
972f4259
KS
4225 }
4226 else if (EQ (tem0, Qunbound))
5af5757b 4227 f->top_pos = 0;
972f4259
KS
4228 else
4229 {
4230 CHECK_NUMBER (tem0);
5af5757b
KS
4231 f->top_pos = XINT (tem0);
4232 if (f->top_pos < 0)
972f4259
KS
4233 window_prompting |= YNegative;
4234 }
4235
4236 if (EQ (tem1, Qminus))
4237 {
5af5757b 4238 f->left_pos = 0;
972f4259
KS
4239 window_prompting |= XNegative;
4240 }
4241 else if (CONSP (tem1) && EQ (XCAR (tem1), Qminus)
4242 && CONSP (XCDR (tem1))
4243 && INTEGERP (XCAR (XCDR (tem1))))
4244 {
5af5757b 4245 f->left_pos = - XINT (XCAR (XCDR (tem1)));
972f4259
KS
4246 window_prompting |= XNegative;
4247 }
4248 else if (CONSP (tem1) && EQ (XCAR (tem1), Qplus)
4249 && CONSP (XCDR (tem1))
4250 && INTEGERP (XCAR (XCDR (tem1))))
4251 {
5af5757b 4252 f->left_pos = XINT (XCAR (XCDR (tem1)));
972f4259
KS
4253 }
4254 else if (EQ (tem1, Qunbound))
5af5757b 4255 f->left_pos = 0;
972f4259
KS
4256 else
4257 {
4258 CHECK_NUMBER (tem1);
5af5757b
KS
4259 f->left_pos = XINT (tem1);
4260 if (f->left_pos < 0)
972f4259
KS
4261 window_prompting |= XNegative;
4262 }
4263
4264 if (!NILP (tem2) && ! EQ (tem2, Qunbound))
4265 window_prompting |= USPosition;
4266 else
4267 window_prompting |= PPosition;
4268 }
4269
5af5757b 4270 if (f->want_fullscreen != FULLSCREEN_NONE)
972f4259
KS
4271 {
4272 int left, top;
4273 int width, height;
4274
4275 /* It takes both for some WM:s to place it where we want */
7f6fd740 4276 window_prompting |= USPosition | PPosition;
972f4259 4277 x_fullscreen_adjust (f, &width, &height, &top, &left);
5af5757b
KS
4278 FRAME_COLS (f) = width;
4279 FRAME_LINES (f) = height;
4280 FRAME_PIXEL_WIDTH (f) = FRAME_TEXT_COLS_TO_PIXEL_WIDTH (f, width);
4281 FRAME_PIXEL_HEIGHT (f) = FRAME_TEXT_LINES_TO_PIXEL_HEIGHT (f, height);
4282 f->left_pos = left;
4283 f->top_pos = top;
972f4259
KS
4284 }
4285
4286 if (window_prompting & XNegative)
4287 {
4288 if (window_prompting & YNegative)
5af5757b 4289 f->win_gravity = SouthEastGravity;
972f4259 4290 else
5af5757b 4291 f->win_gravity = NorthEastGravity;
972f4259
KS
4292 }
4293 else
4294 {
4295 if (window_prompting & YNegative)
5af5757b 4296 f->win_gravity = SouthWestGravity;
972f4259 4297 else
5af5757b 4298 f->win_gravity = NorthWestGravity;
972f4259
KS
4299 }
4300
5af5757b 4301 f->size_hint_flags = window_prompting;
972f4259
KS
4302
4303 return window_prompting;
4304}
4305
4306
4307
4308#endif /* HAVE_WINDOW_SYSTEM */
4309
4310
4311\f
4312/***********************************************************************
4313 Initialization
4314 ***********************************************************************/
4315
4316void
4317syms_of_frame ()
4318{
4319 Qframep = intern ("framep");
4320 staticpro (&Qframep);
4321 Qframe_live_p = intern ("frame-live-p");
4322 staticpro (&Qframe_live_p);
5839d7e8
MR
4323 Qexplicit_name = intern ("explicit-name");
4324 staticpro (&Qexplicit_name);
972f4259
KS
4325 Qheight = intern ("height");
4326 staticpro (&Qheight);
4327 Qicon = intern ("icon");
4328 staticpro (&Qicon);
4329 Qminibuffer = intern ("minibuffer");
4330 staticpro (&Qminibuffer);
4331 Qmodeline = intern ("modeline");
4332 staticpro (&Qmodeline);
4333 Qonly = intern ("only");
4334 staticpro (&Qonly);
4335 Qwidth = intern ("width");
4336 staticpro (&Qwidth);
4337 Qgeometry = intern ("geometry");
4338 staticpro (&Qgeometry);
4339 Qicon_left = intern ("icon-left");
4340 staticpro (&Qicon_left);
4341 Qicon_top = intern ("icon-top");
4342 staticpro (&Qicon_top);
4343 Qleft = intern ("left");
4344 staticpro (&Qleft);
4345 Qright = intern ("right");
4346 staticpro (&Qright);
4347 Quser_position = intern ("user-position");
4348 staticpro (&Quser_position);
4349 Quser_size = intern ("user-size");
4350 staticpro (&Quser_size);
4351 Qwindow_id = intern ("window-id");
4352 staticpro (&Qwindow_id);
4353#ifdef HAVE_X_WINDOWS
4354 Qouter_window_id = intern ("outer-window-id");
4355 staticpro (&Qouter_window_id);
4356#endif
4357 Qparent_id = intern ("parent-id");
4358 staticpro (&Qparent_id);
4359 Qx = intern ("x");
4360 staticpro (&Qx);
4361 Qw32 = intern ("w32");
4362 staticpro (&Qw32);
4363 Qpc = intern ("pc");
4364 staticpro (&Qpc);
4365 Qmac = intern ("mac");
4366 staticpro (&Qmac);
4367 Qvisible = intern ("visible");
4368 staticpro (&Qvisible);
4369 Qbuffer_predicate = intern ("buffer-predicate");
4370 staticpro (&Qbuffer_predicate);
4371 Qbuffer_list = intern ("buffer-list");
4372 staticpro (&Qbuffer_list);
a18b8cb5
KL
4373 Qburied_buffer_list = intern ("buried-buffer-list");
4374 staticpro (&Qburied_buffer_list);
972f4259
KS
4375 Qdisplay_type = intern ("display-type");
4376 staticpro (&Qdisplay_type);
4377 Qbackground_mode = intern ("background-mode");
4378 staticpro (&Qbackground_mode);
c53956fe
SM
4379 Qnoelisp = intern ("noelisp");
4380 staticpro (&Qnoelisp);
972f4259
KS
4381 Qtty_color_mode = intern ("tty-color-mode");
4382 staticpro (&Qtty_color_mode);
28d440ab
KL
4383 Qtty = intern ("tty");
4384 staticpro (&Qtty);
4385 Qtty_type = intern ("tty-type");
4386 staticpro (&Qtty_type);
972f4259
KS
4387
4388 Qface_set_after_frame_default = intern ("face-set-after-frame-default");
4389 staticpro (&Qface_set_after_frame_default);
4390
26c34ec2
CY
4391 Qinhibit_face_set_after_frame_default
4392 = intern ("inhibit-face-set-after-frame-default");
4393 staticpro (&Qinhibit_face_set_after_frame_default);
4394
972f4259
KS
4395 Qfullwidth = intern ("fullwidth");
4396 staticpro (&Qfullwidth);
4397 Qfullheight = intern ("fullheight");
4398 staticpro (&Qfullheight);
4399 Qfullboth = intern ("fullboth");
4400 staticpro (&Qfullboth);
4401 Qx_resource_name = intern ("x-resource-name");
4402 staticpro (&Qx_resource_name);
4403
4404 Qx_frame_parameter = intern ("x-frame-parameter");
4405 staticpro (&Qx_frame_parameter);
4406
6ed8eeff
KL
4407 Qterminal = intern ("terminal");
4408 staticpro (&Qterminal);
4409 Qterminal_live_p = intern ("terminal-live-p");
4410 staticpro (&Qterminal_live_p);
a3547743 4411
972f4259
KS
4412 {
4413 int i;
4414
4415 for (i = 0; i < sizeof (frame_parms) / sizeof (frame_parms[0]); i++)
4416 {
4417 Lisp_Object v = intern (frame_parms[i].name);
4418 if (frame_parms[i].variable)
4419 {
4420 *frame_parms[i].variable = v;
4421 staticpro (frame_parms[i].variable);
4422 }
4423 Fput (v, Qx_frame_parameter, make_number (i));
4424 }
4425 }
4426
2731a0ad 4427#ifdef HAVE_WINDOW_SYSTEM
972f4259
KS
4428 DEFVAR_LISP ("x-resource-name", &Vx_resource_name,
4429 doc: /* The name Emacs uses to look up X resources.
4430`x-get-resource' uses this as the first component of the instance name
4431when requesting resource values.
4432Emacs initially sets `x-resource-name' to the name under which Emacs
4433was invoked, or to the value specified with the `-name' or `-rn'
4434switches, if present.
4435
4436It may be useful to bind this variable locally around a call
4437to `x-get-resource'. See also the variable `x-resource-class'. */);
4438 Vx_resource_name = Qnil;
4439
4440 DEFVAR_LISP ("x-resource-class", &Vx_resource_class,
4441 doc: /* The class Emacs uses to look up X resources.
4442`x-get-resource' uses this as the first component of the instance class
4443when requesting resource values.
4444
4445Emacs initially sets `x-resource-class' to "Emacs".
4446
4447Setting this variable permanently is not a reasonable thing to do,
4448but binding this variable locally around a call to `x-get-resource'
4449is a reasonable practice. See also the variable `x-resource-name'. */);
4450 Vx_resource_class = build_string (EMACS_CLASS);
2731a0ad 4451#endif
972f4259
KS
4452
4453 DEFVAR_LISP ("default-frame-alist", &Vdefault_frame_alist,
4454 doc: /* Alist of default values for frame creation.
4455These may be set in your init file, like this:
5ff00c42 4456 (setq default-frame-alist '((width . 80) (height . 55) (menu-bar-lines . 1)))
972f4259
KS
4457These override values given in window system configuration data,
4458 including X Windows' defaults database.
4459For values specific to the first Emacs frame, see `initial-frame-alist'.
095fe281 4460For window-system specific values, see `window-system-default-frame-alist'.
972f4259
KS
4461For values specific to the separate minibuffer frame, see
4462 `minibuffer-frame-alist'.
4463The `menu-bar-lines' element of the list controls whether new frames
4464 have menu bars; `menu-bar-mode' works by altering this element.
4465Setting this variable does not affect existing frames, only new ones. */);
4466 Vdefault_frame_alist = Qnil;
4467
6b61353c
KH
4468 DEFVAR_LISP ("default-frame-scroll-bars", &Vdefault_frame_scroll_bars,
4469 doc: /* Default position of scroll bars on this window-system. */);
4470#ifdef HAVE_WINDOW_SYSTEM
b15325b2 4471#if defined(HAVE_NTGUI) || defined(MAC_OS)
6b61353c
KH
4472 /* MS-Windows has scroll bars on the right by default. */
4473 Vdefault_frame_scroll_bars = Qright;
4474#else
4475 Vdefault_frame_scroll_bars = Qleft;
4476#endif
4477#else
4478 Vdefault_frame_scroll_bars = Qnil;
4479#endif
4480
972f4259 4481 DEFVAR_LISP ("terminal-frame", &Vterminal_frame,
daf01701 4482 doc: /* The initial frame-object, which represents Emacs's stdout. */);
972f4259
KS
4483
4484 DEFVAR_LISP ("emacs-iconified", &Vemacs_iconified,
bd45aef7 4485 doc: /* Non-nil if all of Emacs is iconified and frame updates are not needed. */);
972f4259
KS
4486 Vemacs_iconified = Qnil;
4487
4488 DEFVAR_LISP ("mouse-position-function", &Vmouse_position_function,
4489 doc: /* If non-nil, function to transform normal value of `mouse-position'.
4490`mouse-position' calls this function, passing its usual return value as
4491argument, and returns whatever this function returns.
4492This abnormal hook exists for the benefit of packages like `xt-mouse.el'
4493which need to do mouse handling at the Lisp level. */);
4494 Vmouse_position_function = Qnil;
4495
4496 DEFVAR_LISP ("mouse-highlight", &Vmouse_highlight,
4497 doc: /* If non-nil, clickable text is highlighted when mouse is over it.
4498If the value is an integer, highlighting is only shown after moving the
4499mouse, while keyboard input turns off the highlight even when the mouse
4500is over the clickable text. However, the mouse shape still indicates
4501when the mouse is over clickable text. */);
4502 Vmouse_highlight = Qt;
4503
4504 DEFVAR_LISP ("delete-frame-functions", &Vdelete_frame_functions,
4505 doc: /* Functions to be run before deleting a frame.
4506The functions are run with one arg, the frame to be deleted.
e519a50b
KL
4507See `delete-frame'.
4508
58555d81
SM
4509Note that functions in this list may be called just before the frame is
4510actually deleted, or some time later (or even both when an earlier function
4511in `delete-frame-functions' (indirectly) calls `delete-frame'
4512recursively). */);
972f4259 4513 Vdelete_frame_functions = Qnil;
58555d81
SM
4514 Qdelete_frame_functions = intern ("delete-frame-functions");
4515 staticpro (&Qdelete_frame_functions);
972f4259
KS
4516
4517 DEFVAR_KBOARD ("default-minibuffer-frame", Vdefault_minibuffer_frame,
4518 doc: /* Minibufferless frames use this frame's minibuffer.
4519
4520Emacs cannot create minibufferless frames unless this is set to an
4521appropriate surrogate.
4522
4523Emacs consults this variable only when creating minibufferless
4524frames; once the frame is created, it sticks with its assigned
4525minibuffer, no matter what this variable is set to. This means that
4526this variable doesn't necessarily say anything meaningful about the
4527current set of frames, or where the minibuffer is currently being
4528displayed.
4529
4530This variable is local to the current terminal and cannot be buffer-local. */);
4531
da1da002
MR
4532 DEFVAR_BOOL ("focus-follows-mouse", &focus_follows_mouse,
4533 doc: /* Non-nil if window system changes focus when you move the mouse.
4534You should set this variable to tell Emacs how your window manager
4535handles focus, since there is no way in general for Emacs to find out
4536automatically. */);
4537#ifdef HAVE_WINDOW_SYSTEM
4538#if defined(HAVE_NTGUI) || defined(MAC_OS)
4539 focus_follows_mouse = 0;
4540#else
4541 focus_follows_mouse = 1;
4542#endif
4543#else
4544 focus_follows_mouse = 0;
4545#endif
a3547743 4546
972f4259
KS
4547 staticpro (&Vframe_list);
4548
4549 defsubr (&Sactive_minibuffer_window);
4550 defsubr (&Sframep);
4551 defsubr (&Sframe_live_p);
428a555e 4552 defsubr (&Swindow_system);
972f4259
KS
4553 defsubr (&Smake_terminal_frame);
4554 defsubr (&Shandle_switch_frame);
972f4259
KS
4555 defsubr (&Sselect_frame);
4556 defsubr (&Sselected_frame);
4557 defsubr (&Swindow_frame);
4558 defsubr (&Sframe_root_window);
4559 defsubr (&Sframe_first_window);
4560 defsubr (&Sframe_selected_window);
4561 defsubr (&Sset_frame_selected_window);
4562 defsubr (&Sframe_list);
4563 defsubr (&Snext_frame);
4564 defsubr (&Sprevious_frame);
4565 defsubr (&Sdelete_frame);
4566 defsubr (&Smouse_position);
4567 defsubr (&Smouse_pixel_position);
4568 defsubr (&Sset_mouse_position);
4569 defsubr (&Sset_mouse_pixel_position);
4570#if 0
4571 defsubr (&Sframe_configuration);
4572 defsubr (&Srestore_frame_configuration);
4573#endif
4574 defsubr (&Smake_frame_visible);
4575 defsubr (&Smake_frame_invisible);
4576 defsubr (&Siconify_frame);
4577 defsubr (&Sframe_visible_p);
4578 defsubr (&Svisible_frame_list);
4579 defsubr (&Sraise_frame);
4580 defsubr (&Slower_frame);
4581 defsubr (&Sredirect_frame_focus);
4582 defsubr (&Sframe_focus);
4583 defsubr (&Sframe_parameters);
4584 defsubr (&Sframe_parameter);
4585 defsubr (&Smodify_frame_parameters);
4586 defsubr (&Sframe_char_height);
4587 defsubr (&Sframe_char_width);
4588 defsubr (&Sframe_pixel_height);
4589 defsubr (&Sframe_pixel_width);
4590 defsubr (&Sset_frame_height);
4591 defsubr (&Sset_frame_width);
4592 defsubr (&Sset_frame_size);
4593 defsubr (&Sset_frame_position);
4594
4595#ifdef HAVE_WINDOW_SYSTEM
4596 defsubr (&Sx_get_resource);
4597 defsubr (&Sx_parse_geometry);
4598#endif
4599
dc6f92b8 4600}
6b61353c
KH
4601
4602/* arch-tag: 7dbf2c69-9aad-45f8-8296-db893d6dd039
4603 (do not change this comment) */