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