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