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