frame.c 166 KB
Newer Older
Jim Blandy's avatar
Jim Blandy committed
1
/* Generic frame functions.
Glenn Morris's avatar
Glenn Morris committed
2

Paul Eggert's avatar
Paul Eggert committed
3
Copyright (C) 1993-1995, 1997, 1999-2016 Free Software Foundation, Inc.
Jim Blandy's avatar
Jim Blandy committed
4 5 6

This file is part of GNU Emacs.

7
GNU Emacs is free software: you can redistribute it and/or modify
Jim Blandy's avatar
Jim Blandy committed
8
it under the terms of the GNU General Public License as published by
9 10
the Free Software Foundation, either version 3 of the License, or (at
your option) any later version.
Jim Blandy's avatar
Jim Blandy committed
11 12 13 14 15 16 17

GNU Emacs is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
18
along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.  */
Jim Blandy's avatar
Jim Blandy committed
19

20
#include <config.h>
21 22

#include <stdio.h>
23 24
#include <errno.h>
#include <limits.h>
25 26 27

#include <c-ctype.h>

28
#include "lisp.h"
29 30 31 32 33

#ifdef HAVE_WINDOW_SYSTEM
#include TERM_HEADER
#endif /* HAVE_WINDOW_SYSTEM */

34 35 36
#include "buffer.h"
/* These help us bind and responding to switch-frame events.  */
#include "keyboard.h"
37
#include "frame.h"
Kim F. Storm's avatar
Kim F. Storm committed
38
#include "blockinput.h"
39
#include "termchar.h"
40
#include "termhooks.h"
Andreas Schwab's avatar
Andreas Schwab committed
41
#include "dispextern.h"
42
#include "window.h"
Andreas Schwab's avatar
Andreas Schwab committed
43
#ifdef HAVE_WINDOW_SYSTEM
44 45
#include "fontset.h"
#endif
46
#include "cm.h"
Morten Welinder's avatar
Morten Welinder committed
47 48
#ifdef MSDOS
#include "msdos.h"
49
#include "dosfns.h"
Morten Welinder's avatar
Morten Welinder committed
50
#endif
Paul Eggert's avatar
Paul Eggert committed
51 52 53
#ifdef USE_X_TOOLKIT
#include "widget.h"
#endif
Jim Blandy's avatar
Jim Blandy committed
54

55 56 57 58 59 60 61 62 63
/* The currently selected frame.  */

Lisp_Object selected_frame;

/* A frame which is not just a mini-buffer, or NULL if there are no such
   frames.  This is usually the most recent such frame that was selected.  */

static struct frame *last_nonminibuf_frame;

64
/* False means there are no visible garbaged frames.  */
65 66
bool frame_garbaged;

67
/* The default tool bar height for future frames.  */
68 69 70
#if defined USE_GTK || defined HAVE_NS
enum { frame_default_tool_bar_height = 0 };
#else
71
int frame_default_tool_bar_height;
72
#endif
73

74 75 76 77
#ifdef HAVE_WINDOW_SYSTEM
static void x_report_frame_params (struct frame *, Lisp_Object *);
#endif

78
/* These setters are used only in this file, so they can be private.  */
79
static void
80 81 82 83
fset_buffer_predicate (struct frame *f, Lisp_Object val)
{
  f->buffer_predicate = val;
}
84
static void
85 86 87 88 89
fset_minibuffer_window (struct frame *f, Lisp_Object val)
{
  f->minibuffer_window = val;
}

90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107
struct frame *
decode_live_frame (register Lisp_Object frame)
{
  if (NILP (frame))
    frame = selected_frame;
  CHECK_LIVE_FRAME (frame);
  return XFRAME (frame);
}

struct frame *
decode_any_frame (register Lisp_Object frame)
{
  if (NILP (frame))
    frame = selected_frame;
  CHECK_FRAME (frame);
  return XFRAME (frame);
}

108 109
#ifdef HAVE_WINDOW_SYSTEM

110 111 112
bool
window_system_available (struct frame *f)
{
113
  return f ? FRAME_WINDOW_P (f) || FRAME_MSDOS_P (f) : x_display_list != NULL;
114 115 116 117 118 119
}

struct frame *
decode_window_system_frame (Lisp_Object frame)
{
  struct frame *f = decode_live_frame (frame);
120

121 122 123 124 125
  if (!window_system_available (f))
    error ("Window system frame should be used");
  return f;
}

126 127 128 129 130 131 132 133 134 135
#else  /* not HAVE_WINDOW_SYSTEM */

_Noreturn void
decode_window_system_frame (Lisp_Object frame)
{
  error ("Window system is not in use");
}

_Noreturn
#endif	/* not HAVE_WINDOW_SYSTEM */
136 137 138 139 140 141 142 143
void
check_window_system (struct frame *f)
{
  if (!window_system_available (f))
    error (f ? "Window system frame should be used"
	   : "Window system is not in use or not initialized");
}

144
/* Return the value of frame parameter PROP in frame FRAME.  */
145

146 147 148 149 150 151 152 153 154 155 156
Lisp_Object
get_frame_param (register struct frame *frame, Lisp_Object prop)
{
  register Lisp_Object tem;

  tem = Fassq (prop, frame->param_alist);
  if (EQ (tem, Qnil))
    return tem;
  return Fcdr (tem);
}

157 158 159 160 161 162 163 164 165

void
frame_size_history_add (struct frame *f, Lisp_Object fun_symbol,
			int width, int height, Lisp_Object rest)
{
  Lisp_Object frame;

  XSETFRAME (frame, f);
  if (CONSP (frame_size_history)
166 167
      && INTEGERP (XCAR (frame_size_history))
      && 0 < XINT (XCAR (frame_size_history)))
168
    frame_size_history =
169
      Fcons (make_number (XINT (XCAR (frame_size_history)) - 1),
170 171 172 173 174 175 176 177 178
	     Fcons (list4
		    (frame, fun_symbol,
		     ((width > 0)
		      ? list4 (make_number (FRAME_TEXT_WIDTH (f)),
			       make_number (FRAME_TEXT_HEIGHT (f)),
			       make_number (width),
			       make_number (height))
		      : Qnil),
		     rest),
179
		    XCDR (frame_size_history)));
180 181 182
}


183 184
/* Return 1 if `frame-inhibit-implied-resize' is non-nil or fullscreen
   state of frame F would be affected by a vertical (horizontal if
185 186
   HORIZONTAL is true) resize.  PARAMETER is the symbol of the frame
   parameter that is changed.  */
187
bool
188
frame_inhibit_resize (struct frame *f, bool horizontal, Lisp_Object parameter)
189
{
190 191
  Lisp_Object fullscreen = get_frame_param (f, Qfullscreen);
  bool inhibit
192 193 194 195 196 197 198 199 200 201 202
    = (f->after_make_frame
       ? (EQ (frame_inhibit_implied_resize, Qt)
	  || (CONSP (frame_inhibit_implied_resize)
	      && !NILP (Fmemq (parameter, frame_inhibit_implied_resize)))
	  || (horizontal
	      && !EQ (fullscreen, Qnil) && !EQ (fullscreen, Qfullheight))
	  || (!horizontal
	      && !EQ (fullscreen, Qnil) && !EQ (fullscreen, Qfullwidth))
	  || FRAME_TERMCAP_P (f) || FRAME_MSDOS_P (f))
       : ((horizontal && f->inhibit_horizontal_resize)
	  || (!horizontal && f->inhibit_vertical_resize)));
203 204 205 206 207 208 209 210 211
  if (inhibit && !FRAME_TERMCAP_P (f) && !FRAME_MSDOS_P (f))
    frame_size_history_add
      (f, Qframe_inhibit_resize, 0, 0,
       list5 (horizontal ? Qt : Qnil, parameter,
	      f->after_make_frame ? Qt : Qnil,
	      frame_inhibit_implied_resize,
	      fullscreen));

  return inhibit;
212 213
}

214
static void
215
set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
216 217 218 219 220 221
{
  int nlines;
  int olines = FRAME_MENU_BAR_LINES (f);

  /* Right now, menu bars don't work properly in minibuf-only frames;
     most of the commands try to apply themselves to the minibuffer
Karl Heuer's avatar
Karl Heuer committed
222
     frame itself, and get an error because you can't switch buffers
223 224 225 226
     in or split the minibuffer window.  */
  if (FRAME_MINIBUF_ONLY_P (f))
    return;

227
  if (TYPE_RANGED_INTEGERP (int, value))
228 229 230 231
    nlines = XINT (value);
  else
    nlines = 0;

232 233
  if (nlines != olines)
    {
234
      windows_or_buffers_changed = 14;
235
      FRAME_MENU_BAR_LINES (f) = nlines;
236
      FRAME_MENU_BAR_HEIGHT (f) = nlines * FRAME_LINE_HEIGHT (f);
237 238 239
      change_frame_size (f, FRAME_COLS (f),
			 FRAME_LINES (f) + olines - nlines,
			 0, 1, 0, 0);
240
    }
241 242 243 244
}

Lisp_Object Vframe_list;

Jim Blandy's avatar
Jim Blandy committed
245

Jim Blandy's avatar
Jim Blandy committed
246
DEFUN ("framep", Fframep, Sframep, 1, 1, 0,
247
       doc: /* Return non-nil if OBJECT is a frame.
248 249
Value is:
  t for a termcap frame (a character-only terminal),
250 251 252 253
 `x' for an Emacs frame that is really an X window,
 `w32' for an Emacs frame that is a window on MS-Windows display,
 `ns' for an Emacs frame on a GNUstep or Macintosh Cocoa display,
 `pc' for a direct-write MS-DOS frame.
254
See also `frame-live-p'.  */)
Dan Nicolaescu's avatar
Dan Nicolaescu committed
255
  (Lisp_Object object)
Jim Blandy's avatar
Jim Blandy committed
256
{
257
  if (!FRAMEP (object))
Jim Blandy's avatar
Jim Blandy committed
258
    return Qnil;
Jim Blandy's avatar
Jim Blandy committed
259
  switch (XFRAME (object)->output_method)
Jim Blandy's avatar
Jim Blandy committed
260
    {
261
    case output_initial: /* The initial frame is like a termcap frame. */
Jim Blandy's avatar
Jim Blandy committed
262 263 264
    case output_termcap:
      return Qt;
    case output_x_window:
265
      return Qx;
266 267
    case output_w32:
      return Qw32;
268 269
    case output_msdos_raw:
      return Qpc;
270 271
    case output_ns:
      return Qns;
Jim Blandy's avatar
Jim Blandy committed
272
    default:
273
      emacs_abort ();
Jim Blandy's avatar
Jim Blandy committed
274 275 276
    }
}

Jim Blandy's avatar
Jim Blandy committed
277
DEFUN ("frame-live-p", Fframe_live_p, Sframe_live_p, 1, 1, 0,
278 279
       doc: /* Return non-nil if OBJECT is a frame which has not been deleted.
Value is nil if OBJECT is not a live frame.  If object is a live
280
frame, the return value indicates what sort of terminal device it is
Pavel Janík's avatar
Pavel Janík committed
281
displayed on.  See the documentation of `framep' for possible
Pavel Janík's avatar
Pavel Janík committed
282
return values.  */)
Dan Nicolaescu's avatar
Dan Nicolaescu committed
283
  (Lisp_Object object)
Jim Blandy's avatar
Jim Blandy committed
284
{
Jim Blandy's avatar
Jim Blandy committed
285 286 287
  return ((FRAMEP (object)
	   && FRAME_LIVE_P (XFRAME (object)))
	  ? Fframep (object)
Jim Blandy's avatar
Jim Blandy committed
288 289 290
	  : Qnil);
}

Paul Eggert's avatar
Paul Eggert committed
291
DEFUN ("window-system", Fwindow_system, Swindow_system, 0, 1, 0,
292
       doc: /* The name of the window system that FRAME is displaying through.
293 294
The value is a symbol:
 nil for a termcap frame (a character-only terminal),
295 296 297 298
 `x' for an Emacs frame that is really an X window,
 `w32' for an Emacs frame that is a window on MS-Windows display,
 `ns' for an Emacs frame on a GNUstep or Macintosh Cocoa display,
 `pc' for a direct-write MS-DOS frame.
299 300 301 302 303 304

FRAME defaults to the currently selected frame.

Use of this function as a predicate is deprecated.  Instead,
use `display-graphic-p' or any of the other `display-*-p'
predicates which report frame's specific UI-related capabilities.  */)
Dan Nicolaescu's avatar
Dan Nicolaescu committed
305
  (Lisp_Object frame)
306 307 308 309 310 311 312 313 314 315 316 317 318 319
{
  Lisp_Object type;
  if (NILP (frame))
    frame = selected_frame;

  type = Fframep (frame);

  if (NILP (type))
    wrong_type_argument (Qframep, frame);

  if (EQ (type, Qt))
    return Qnil;
  else
    return type;
320
}
321

322 323 324
/* Placeholder used by temacs -nw before window.el is loaded.  */
DEFUN ("frame-windows-min-size", Fframe_windows_min_size,
       Sframe_windows_min_size, 4, 4, 0,
325 326
       doc: /* */
       attributes: const)
327 328 329 330 331 332
     (Lisp_Object frame, Lisp_Object horizontal,
      Lisp_Object ignore, Lisp_Object pixelwise)
{
  return make_number (0);
}

333
static int
334 335
frame_windows_min_size (Lisp_Object frame, Lisp_Object horizontal,
			Lisp_Object ignore, Lisp_Object pixelwise)
336
{
337 338
  return XINT (call4 (Qframe_windows_min_size, frame, horizontal,
		      ignore, pixelwise));
339 340 341 342 343
}


/* Make sure windows sizes of frame F are OK.  new_width and new_height
   are in pixels.  A value of -1 means no change is requested for that
Paul Eggert's avatar
Paul Eggert committed
344
   size (but the frame may still have to be resized to accommodate
345 346 347
   windows with their minimum sizes).  This can either issue a request
   to resize the frame externally (via x_set_window_size), to resize the
   frame internally (via resize_frame_windows) or do nothing at all.
348 349 350 351

   The argument INHIBIT can assume the following values:

   0 means to unconditionally call x_set_window_size even if sizes
352 353
     apparently do not change.  Fx_create_frame uses this to pass the
     initial size to the window manager.
354

355 356
   1 means to call x_set_window_size if the outer frame size really
     changes.  Fset_frame_size, Fset_frame_height, ... use this.
357

358 359 360 361
   2 means to call x_set_window_size provided frame_inhibit_resize
     allows it.  The menu and tool bar code use this ("3" won't work
     here in general because menu and tool bar are often not counted in
     the frame's text height).
362

363 364 365
   3 means call x_set_window_size if window minimum sizes must be
     preserved or frame_inhibit_resize allows it.  x_set_left_fringe,
     x_set_scroll_bar_width, x_new_font ... use (or should use) this.
366

367 368 369
   4 means call x_set_window_size only if window minimum sizes must be
     preserved.  x_set_right_divider_width, x_set_border_width and the
     code responsible for wrapping the tool bar use this.
370 371

   5 means to never call x_set_window_size.  change_frame_size uses
372
     this.
373

374 375 376
   Note that even when x_set_window_size is not called, individual
   windows may have to be resized (via `window--sanitize-window-sizes')
   in order to support minimum size constraints.
377

378 379 380 381
   PRETEND is as for change_frame_size.  PARAMETER, if non-nil, is the
   symbol of the parameter changed (like `menu-bar-lines', `font', ...).
   This is passed on to frame_inhibit_resize to let the latter decide on
   a case-by-case basis whether the frame may be resized externally.  */
382
void
383 384
adjust_frame_size (struct frame *f, int new_width, int new_height, int inhibit,
		   bool pretend, Lisp_Object parameter)
385 386 387 388 389
{
  int unit_width = FRAME_COLUMN_WIDTH (f);
  int unit_height = FRAME_LINE_HEIGHT (f);
  int old_pixel_width = FRAME_PIXEL_WIDTH (f);
  int old_pixel_height = FRAME_PIXEL_HEIGHT (f);
390 391
  int old_cols = FRAME_COLS (f);
  int old_lines = FRAME_LINES (f);
392 393 394 395 396 397 398 399 400 401 402 403 404
  int new_pixel_width, new_pixel_height;
  /* The following two values are calculated from the old frame pixel
     sizes and any "new" settings for tool bar, menu bar and internal
     borders.  We do it this way to detect whether we have to call
     x_set_window_size as consequence of the new settings.  */
  int windows_width = FRAME_WINDOWS_WIDTH (f);
  int windows_height = FRAME_WINDOWS_HEIGHT (f);
  int min_windows_width, min_windows_height;
  /* These are a bit tedious, maybe we should use a macro.  */
  struct window *r = XWINDOW (FRAME_ROOT_WINDOW (f));
  int old_windows_width = WINDOW_PIXEL_WIDTH (r);
  int old_windows_height
    = (WINDOW_PIXEL_HEIGHT (r)
405
       + ((FRAME_HAS_MINIBUF_P (f) && !FRAME_MINIBUF_ONLY_P (f))
406 407 408 409 410 411 412 413 414 415 416 417 418
	  ? WINDOW_PIXEL_HEIGHT (XWINDOW (FRAME_MINIBUF_WINDOW (f)))
	  : 0));
  int new_windows_width, new_windows_height;
  int old_text_width = FRAME_TEXT_WIDTH (f);
  int old_text_height = FRAME_TEXT_HEIGHT (f);
  /* If a size is < 0 use the old value.  */
  int new_text_width = (new_width >= 0) ? new_width : old_text_width;
  int new_text_height = (new_height >= 0) ? new_height : old_text_height;
  int new_cols, new_lines;
  bool inhibit_horizontal, inhibit_vertical;
  Lisp_Object frame;

  XSETFRAME (frame, f);
419

420 421 422
  frame_size_history_add
    (f, Qadjust_frame_size_1, new_text_width, new_text_height,
     list2 (parameter, make_number (inhibit)));
423

424 425 426
  /* The following two values are calculated from the old window body
     sizes and any "new" settings for scroll bars, dividers, fringes and
     margins (though the latter should have been processed already).  */
427 428 429 430
  min_windows_width
    = frame_windows_min_size (frame, Qt, (inhibit == 5) ? Qt : Qnil, Qt);
  min_windows_height
    = frame_windows_min_size (frame, Qnil, (inhibit == 5) ? Qt : Qnil, Qt);
431 432

  if (inhibit >= 2 && inhibit <= 4)
433
    /* When INHIBIT is in [2..4] inhibit if the "old" window sizes stay
434 435
       within the limits and either resizing is inhibited or INHIBIT
       equals 4.  */
436
    {
437 438 439 440 441 442
      inhibit_horizontal = (windows_width >= min_windows_width
                            && (inhibit == 4
                                || frame_inhibit_resize (f, true, parameter)));
      inhibit_vertical = (windows_height >= min_windows_height
                          && (inhibit == 4
                              || frame_inhibit_resize (f, false, parameter)));
443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469
    }
  else
    /* Otherwise inhibit if INHIBIT equals 5.  */
    inhibit_horizontal = inhibit_vertical = inhibit == 5;

  new_pixel_width = ((inhibit_horizontal && (inhibit < 5))
		     ? old_pixel_width
		     : max (FRAME_TEXT_TO_PIXEL_WIDTH (f, new_text_width),
			    min_windows_width
			    + 2 * FRAME_INTERNAL_BORDER_WIDTH (f)));
  new_windows_width = new_pixel_width - 2 * FRAME_INTERNAL_BORDER_WIDTH (f);
  new_text_width = FRAME_PIXEL_TO_TEXT_WIDTH (f, new_pixel_width);
  new_cols = new_text_width / unit_width;

  new_pixel_height = ((inhibit_vertical && (inhibit < 5))
		      ? old_pixel_height
		      : max (FRAME_TEXT_TO_PIXEL_HEIGHT (f, new_text_height),
			     min_windows_height
			     + FRAME_TOP_MARGIN_HEIGHT (f)
			     + 2 * FRAME_INTERNAL_BORDER_WIDTH (f)));
  new_windows_height = (new_pixel_height
			- FRAME_TOP_MARGIN_HEIGHT (f)
			- 2 * FRAME_INTERNAL_BORDER_WIDTH (f));
  new_text_height = FRAME_PIXEL_TO_TEXT_HEIGHT (f, new_pixel_height);
  new_lines = new_text_height / unit_height;

#ifdef HAVE_WINDOW_SYSTEM
470
  if (FRAME_WINDOW_P (f)
471
      && f->can_x_set_window_size
472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488
      && ((!inhibit_horizontal
	   && (new_pixel_width != old_pixel_width
	       || inhibit == 0 || inhibit == 2))
	  || (!inhibit_vertical
	      && (new_pixel_height != old_pixel_height
		  || inhibit == 0 || inhibit == 2))))
    /* We are either allowed to change the frame size or the minimum
       sizes request such a change.  Do not care for fixing minimum
       sizes here, we do that eventually when we're called from
       change_frame_size.  */
    {
      /* Make sure we respect fullheight and fullwidth.  */
      if (inhibit_horizontal)
	new_text_width = old_text_width;
      else if (inhibit_vertical)
	new_text_height = old_text_height;

489 490 491 492
      frame_size_history_add
	(f, Qadjust_frame_size_2, new_text_width, new_text_height,
	 list2 (inhibit_horizontal ? Qt : Qnil,
		inhibit_vertical ? Qt : Qnil));
493

494 495 496 497 498 499 500 501 502 503 504 505
      x_set_window_size (f, 0, new_text_width, new_text_height, 1);
      f->resized_p = true;

      return;
    }
#endif

  if (new_text_width == old_text_width
      && new_text_height == old_text_height
      && new_windows_width == old_windows_width
      && new_windows_height == old_windows_height
      && new_pixel_width == old_pixel_width
506 507 508
      && new_pixel_height == old_pixel_height
      && new_cols == old_cols
      && new_lines == old_lines)
509 510 511 512 513 514 515 516 517 518 519
    /* No change.  Sanitize window sizes and return.  */
    {
      sanitize_window_sizes (frame, Qt);
      sanitize_window_sizes (frame, Qnil);

      return;
    }

  block_input ();

#ifdef MSDOS
Eli Zaretskii's avatar
Eli Zaretskii committed
520 521 522 523 524 525 526
  /* We only can set screen dimensions to certain values supported by
     our video hardware.  Try to find the smallest size greater or
     equal to the requested dimensions, while accounting for the fact
     that the menu-bar lines are not counted in the frame height.  */
  int dos_new_lines = new_lines + FRAME_TOP_MARGIN (f);
  dos_set_window_size (&dos_new_lines, &new_cols);
  new_lines = dos_new_lines - FRAME_TOP_MARGIN (f);
527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546
#endif

  if (new_windows_width != old_windows_width)
    {
      resize_frame_windows (f, new_windows_width, 1, 1);

      /* MSDOS frames cannot PRETEND, as they change frame size by
	 manipulating video hardware.  */
      if ((FRAME_TERMCAP_P (f) && !pretend) || FRAME_MSDOS_P (f))
	FrameCols (FRAME_TTY (f)) = new_cols;

#if defined (HAVE_WINDOW_SYSTEM) && ! defined (USE_GTK) && ! defined (HAVE_NS)
      if (WINDOWP (f->tool_bar_window))
	{
	  XWINDOW (f->tool_bar_window)->pixel_width = new_windows_width;
	  XWINDOW (f->tool_bar_window)->total_cols
	    = new_windows_width / unit_width;
	}
#endif
    }
547
  else if (new_cols != old_cols)
548
    call2 (Qwindow__pixel_to_total, frame, Qt);
549 550 551 552 553 554 555 556 557 558 559 560

  if (new_windows_height != old_windows_height
      /* When the top margin has changed we have to recalculate the top
	 edges of all windows.  No such calculation is necessary for the
	 left edges.  */
      || WINDOW_TOP_PIXEL_EDGE (r) != FRAME_TOP_MARGIN_HEIGHT (f))
    {
      resize_frame_windows (f, new_windows_height, 0, 1);

      /* MSDOS frames cannot PRETEND, as they change frame size by
	 manipulating video hardware.  */
      if ((FRAME_TERMCAP_P (f) && !pretend) || FRAME_MSDOS_P (f))
561
	FrameRows (FRAME_TTY (f)) = new_lines + FRAME_TOP_MARGIN (f);
562
    }
563
  else if (new_lines != old_lines)
564
    call2 (Qwindow__pixel_to_total, frame, Qnil);
565

566 567 568 569 570
  frame_size_history_add
    (f, Qadjust_frame_size_3, new_text_width, new_text_height,
     list4 (make_number (old_pixel_width), make_number (old_pixel_height),
	    make_number (new_pixel_width), make_number (new_pixel_height)));

571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606
  /* Assign new sizes.  */
  FRAME_TEXT_WIDTH (f) = new_text_width;
  FRAME_TEXT_HEIGHT (f) = new_text_height;
  FRAME_PIXEL_WIDTH (f) = new_pixel_width;
  FRAME_PIXEL_HEIGHT (f) = new_pixel_height;
  SET_FRAME_COLS (f, new_cols);
  SET_FRAME_LINES (f, new_lines);

  {
    struct window *w = XWINDOW (FRAME_SELECTED_WINDOW (f));
    int text_area_x, text_area_y, text_area_width, text_area_height;

    window_box (w, TEXT_AREA, &text_area_x, &text_area_y, &text_area_width,
		&text_area_height);
    if (w->cursor.x >= text_area_x + text_area_width)
      w->cursor.hpos = w->cursor.x = 0;
    if (w->cursor.y >= text_area_y + text_area_height)
      w->cursor.vpos = w->cursor.y = 0;
  }

  /* Sanitize window sizes.  */
  sanitize_window_sizes (frame, Qt);
  sanitize_window_sizes (frame, Qnil);

  adjust_frame_glyphs (f);
  calculate_costs (f);
  SET_FRAME_GARBAGED (f);

  /* A frame was "resized" if one of its pixelsizes changed, even if its
     X window wasn't resized at all.  */
  f->resized_p = (new_pixel_width != old_pixel_width
		  || new_pixel_height != old_pixel_height);

  unblock_input ();
}

607 608 609 610 611 612 613
/* Allocate basically initialized frame.  */

static struct frame *
allocate_frame (void)
{
  return ALLOCATE_ZEROED_PSEUDOVECTOR (struct frame, face_cache, PVEC_FRAME);
}
614

Jim Blandy's avatar
Jim Blandy committed
615
struct frame *
616
make_frame (bool mini_p)
Jim Blandy's avatar
Jim Blandy committed
617
{
Jim Blandy's avatar
Jim Blandy committed
618
  Lisp_Object frame;
619
  struct frame *f;
620
  struct window *rw, *mw;
621 622
  Lisp_Object root_window;
  Lisp_Object mini_window;
623 624

  f = allocate_frame ();
625
  XSETFRAME (frame, f);
Jim Blandy's avatar
Jim Blandy committed
626

627
#ifdef USE_GTK
628 629
  /* Initialize Lisp data.  Note that allocate_frame initializes all
     Lisp data to nil, so do it only for slots which should not be nil.  */
630
  fset_tool_bar_position (f, Qtop);
631
#endif
632 633 634 635 636

  /* Initialize non-Lisp data.  Note that allocate_frame zeroes out all
     non-Lisp data, so do it only for slots which should not be zero.
     To avoid subtle bugs and for the sake of readability, it's better to
     initialize enum members explicitly even if their values are zero.  */
637 638 639
  f->wants_modeline = true;
  f->redisplay = true;
  f->garbaged = true;
640
  f->can_x_set_window_size = false;
641
  f->after_make_frame = false;
642 643 644 645
  f->inhibit_horizontal_resize = false;
  f->inhibit_vertical_resize = false;
  f->tool_bar_redisplayed = false;
  f->tool_bar_resized = false;
646 647
  f->column_width = 1;  /* !FRAME_WINDOW_P value.  */
  f->line_height = 1;  /* !FRAME_WINDOW_P value.  */
648
#ifdef HAVE_WINDOW_SYSTEM
649
  f->vertical_scroll_bar_type = vertical_scroll_bar_none;
650
  f->horizontal_scroll_bars = false;
651
  f->want_fullscreen = FULLSCREEN_NONE;
652 653 654
#if ! defined (USE_GTK) && ! defined (HAVE_NS)
  f->last_tool_bar_item = -1;
#endif
655
#endif
Jim Blandy's avatar
Jim Blandy committed
656

657
  root_window = make_window ();
658
  rw = XWINDOW (root_window);
Jim Blandy's avatar
Jim Blandy committed
659 660
  if (mini_p)
    {
661
      mini_window = make_window ();
662 663 664 665 666
      mw = XWINDOW (mini_window);
      wset_next (rw, mini_window);
      wset_prev (mw, root_window);
      mw->mini = 1;
      wset_frame (mw, frame);
667
      fset_minibuffer_window (f, mini_window);
Jim Blandy's avatar
Jim Blandy committed
668 669 670 671
    }
  else
    {
      mini_window = Qnil;
672
      wset_next (rw, Qnil);
673
      fset_minibuffer_window (f, Qnil);
Jim Blandy's avatar
Jim Blandy committed
674 675
    }

676
  wset_frame (rw, frame);
Jim Blandy's avatar
Jim Blandy committed
677 678 679

  /* 10 is arbitrary,
     just so that there is "something there."
680
     Correct size will be set up later with adjust_frame_size.  */
Jim Blandy's avatar
Jim Blandy committed
681

682
  SET_FRAME_COLS (f, 10);
683
  SET_FRAME_LINES (f, 10);
684 685
  SET_FRAME_WIDTH (f, FRAME_COLS (f) * FRAME_COLUMN_WIDTH (f));
  SET_FRAME_HEIGHT (f, FRAME_LINES (f) * FRAME_LINE_HEIGHT (f));
Jim Blandy's avatar
Jim Blandy committed
686

687 688 689 690
  rw->total_cols = 10;
  rw->pixel_width = rw->total_cols * FRAME_COLUMN_WIDTH (f);
  rw->total_lines = mini_p ? 9 : 10;
  rw->pixel_height = rw->total_lines * FRAME_LINE_HEIGHT (f);
Jim Blandy's avatar
Jim Blandy committed
691 692 693

  if (mini_p)
    {
694 695 696 697 698 699
      mw->top_line = rw->total_lines;
      mw->pixel_top = rw->pixel_height;
      mw->total_cols = rw->total_cols;
      mw->pixel_width = rw->pixel_width;
      mw->total_lines = 1;
      mw->pixel_height = FRAME_LINE_HEIGHT (f);
Jim Blandy's avatar
Jim Blandy committed
700 701
    }

Jim Blandy's avatar
Jim Blandy committed
702
  /* Choose a buffer for the frame's root window.  */
Jim Blandy's avatar
Jim Blandy committed
703
  {
704
    Lisp_Object buf = Fcurrent_buffer ();
Jim Blandy's avatar
Jim Blandy committed
705

706 707
    /* If current buffer is hidden, try to find another one.  */
    if (BUFFER_HIDDEN_P (XBUFFER (buf)))
708
      buf = other_buffer_safely (buf);
709

710 711
    /* Use set_window_buffer, not Fset_window_buffer, and don't let
       hooks be run by it.  The reason is that the whole frame/window
Juanma Barranquero's avatar
Juanma Barranquero committed
712
       arrangement is not yet fully initialized at this point.  Windows
713 714 715
       don't have the right size, glyph matrices aren't initialized
       etc.  Running Lisp functions at this point surely ends in a
       SEGV.  */
716
    set_window_buffer (root_window, buf, 0, 0);
717
    fset_buffer_list (f, list1 (buf));
Jim Blandy's avatar
Jim Blandy committed
718 719
  }

Jim Blandy's avatar
Jim Blandy committed
720
  if (mini_p)
721 722 723 724 725 726 727 728 729
    {
      set_window_buffer (mini_window,
			 (NILP (Vminibuffer_list)
			  ? get_minibuffer (0)
			  : Fcar (Vminibuffer_list)),
			 0, 0);
      /* No horizontal scroll bars in minibuffers.  */
      wset_horizontal_scroll_bar (mw, Qnil);
    }
Jim Blandy's avatar
Jim Blandy committed
730

731 732
  fset_root_window (f, root_window);
  fset_selected_window (f, root_window);
Jim Blandy's avatar
Jim Blandy committed
733 734
  /* Make sure this window seems more recently used than
     a newly-created, never-selected window.  */
735
  XWINDOW (f->selected_window)->use_time = ++window_select_count;
Jim Blandy's avatar
Jim Blandy committed
736

Jim Blandy's avatar
Jim Blandy committed
737
  return f;
Jim Blandy's avatar
Jim Blandy committed
738 739
}

740
#ifdef HAVE_WINDOW_SYSTEM
Jim Blandy's avatar
Jim Blandy committed
741
/* Make a frame using a separate minibuffer window on another frame.
Jim Blandy's avatar
Jim Blandy committed
742 743 744
   MINI_WINDOW is the minibuffer window to use.  nil means use the
   default (the global minibuffer).  */

Jim Blandy's avatar
Jim Blandy committed
745
struct frame *
746 747
make_frame_without_minibuffer (Lisp_Object mini_window, KBOARD *kb,
			       Lisp_Object display)
Jim Blandy's avatar
Jim Blandy committed
748
{
749
  struct frame *f;
Jim Blandy's avatar
Jim Blandy committed
750

751
  if (!NILP (mini_window))
752
    CHECK_LIVE_WINDOW (mini_window);
Jim Blandy's avatar
Jim Blandy committed
753

754
  if (!NILP (mini_window)
755
      && FRAME_KBOARD (XFRAME (XWINDOW (mini_window)->frame)) != kb)
756
    error ("Frame and minibuffer must be on the same terminal");
757

Jim Blandy's avatar
Jim Blandy committed
758 759
  /* Make a frame containing just a root window.  */
  f = make_frame (0);
Jim Blandy's avatar
Jim Blandy committed
760

761 762 763
  if (NILP (mini_window))
    {
      /* Use default-minibuffer-frame if possible.  */
764 765
      if (!FRAMEP (KVAR (kb, Vdefault_minibuffer_frame))
	  || ! FRAME_LIVE_P (XFRAME (KVAR (kb, Vdefault_minibuffer_frame))))
766
	{
767 768 769
          Lisp_Object frame_dummy;

          XSETFRAME (frame_dummy, f);
770
	  /* If there's no minibuffer frame to use, create one.  */
Paul Eggert's avatar
Paul Eggert committed
771 772
	  kset_default_minibuffer_frame
	    (kb, call1 (intern ("make-initial-minibuffer-frame"), display));
773
	}
774

775 776
      mini_window
	= XFRAME (KVAR (kb, Vdefault_minibuffer_frame))->minibuffer_window;
777
    }
778

779
  fset_minibuffer_window (f, mini_window);
780 781 782

  /* Make the chosen minibuffer window display the proper minibuffer,
     unless it is already showing a minibuffer.  */
783
  if (NILP (Fmemq (XWINDOW (mini_window)->contents, Vminibuffer_list)))
784 785 786 787 788 789
    /* Use set_window_buffer instead of Fset_window_buffer (see
       discussion of bug#11984, bug#12025, bug#12026).  */
    set_window_buffer (mini_window,
		       (NILP (Vminibuffer_list)
			? get_minibuffer (0)
			: Fcar (Vminibuffer_list)), 0, 0);
Jim Blandy's avatar
Jim Blandy committed
790
  return f;
Jim Blandy's avatar
Jim Blandy committed
791 792
}

Jim Blandy's avatar
Jim Blandy committed
793
/* Make a frame containing only a minibuffer window.  */
Jim Blandy's avatar
Jim Blandy committed
794

Jim Blandy's avatar
Jim Blandy committed
795
struct frame *
796
make_minibuffer_frame (void)
Jim Blandy's avatar
Jim Blandy committed
797
{
Jim Blandy's avatar
Jim Blandy committed
798
  /* First make a frame containing just a root window, no minibuffer.  */
Jim Blandy's avatar
Jim Blandy committed
799

Jim Blandy's avatar
Jim Blandy committed
800
  register struct frame *f = make_frame (0);
Jim Blandy's avatar
Jim Blandy committed
801
  register Lisp_Object mini_window;
Jim Blandy's avatar
Jim Blandy committed
802
  register Lisp_Object frame;
Jim Blandy's avatar
Jim Blandy committed
803

804
  XSETFRAME (frame, f);
Jim Blandy's avatar
Jim Blandy committed
805

806
  f->auto_raise = 0;
Jim Blandy's avatar
Jim Blandy committed
807 808 809
  f->auto_lower = 0;
  f->no_split = 1;
  f->wants_modeline = 0;
Jim Blandy's avatar
Jim Blandy committed
810 811 812 813 814

  /* Now label the root window as also being the minibuffer.
     Avoid infinite looping on the window chain by marking next pointer
     as nil. */

815 816
  mini_window = f->root_window;
  fset_minibuffer_window (f, mini_window);
817
  XWINDOW (mini_window)->mini = 1;
Paul Eggert's avatar
Paul Eggert committed
818 819 820
  wset_next (XWINDOW (mini_window), Qnil);
  wset_prev (XWINDOW (mini_window), Qnil);
  wset_frame (XWINDOW (mini_window), frame);
Jim Blandy's avatar
Jim Blandy committed
821 822 823

  /* Put the proper buffer in that window.  */

824 825 826 827 828 829
  /* Use set_window_buffer instead of Fset_window_buffer (see
     discussion of bug#11984, bug#12025, bug#12026).  */
  set_window_buffer (mini_window,
		     (NILP (Vminibuffer_list)
		      ? get_minibuffer (0)
		      : Fcar (Vminibuffer_list)), 0, 0);
Jim Blandy's avatar
Jim Blandy committed
830
  return f;
Jim Blandy's avatar
Jim Blandy committed
831
}
832
#endif /* HAVE_WINDOW_SYSTEM */
Jim Blandy's avatar
Jim Blandy committed
833

834
/* Construct a frame that refers to a terminal.  */
Jim Blandy's avatar
Jim Blandy committed
835

836
static printmax_t tty_frame_count;
837

Jim Blandy's avatar
Jim Blandy committed
838
struct frame *
839
make_initial_frame (void)
Jim Blandy's avatar
Jim Blandy committed
840
{
841
  struct frame *f;
842
  struct terminal *terminal;
843
  Lisp_Object frame;
844

845
  eassert (initial_kboard);
846

847 848 849
  /* The first call must initialize Vframe_list.  */
  if (! (NILP (Vframe_list) || CONSP (Vframe_list)))
    Vframe_list = Qnil;
Jim Blandy's avatar
Jim Blandy committed
850

851
  terminal = init_initial_terminal ();
852 853 854 855 856 857

  f = make_frame (1);
  XSETFRAME (frame, f);

  Vframe_list = Fcons (frame, Vframe_list);

858
  tty_frame_count = 1;
859
  fset_name (f, build_pure_c_string ("F1"));
860

861
  SET_FRAME_VISIBLE (f, 1);
862

863 864 865
  f->output_method = terminal->type;
  f->terminal = terminal;
  f->terminal->reference_count++;
866
  f->output_data.nothing = 0;
867

868 869
  FRAME_FOREGROUND_PIXEL (f) = FACE_TTY_DEFAULT_FG_COLOR;
  FRAME_BACKGROUND_PIXEL (f) = FACE_TTY_DEFAULT_BG_COLOR;
870

871 872
#ifdef HAVE_WINDOW_SYSTEM
  f->vertical_scroll_bar_type = vertical_scroll_bar_none;
873
  f->horizontal_scroll_bars = false;
874
#endif
875 876 877

  /* The default value of menu-bar-mode is t.  */
  set_menu_bar_lines (f, make_number (1), Qnil);
878

879 880 881
  /* Allocate glyph matrices.  */
  adjust_frame_glyphs (f);

882 883 884
  if (!noninteractive)
    init_frame_faces (f);

885 886
  last_nonminibuf_frame = f;

887 888 889
  f->can_x_set_window_size = true;
  f->after_make_frame = true;

890 891 892 893
  return f;
}


894
static struct frame *
895
make_terminal_frame (struct terminal *terminal)
896 897 898
{
  register struct frame *f;
  Lisp_Object frame;
899
  char name[sizeof "F" + INT_STRLEN_BOUND (printmax_t)];
900

901 902
  if (!terminal->name)
    error ("Terminal is not live, can't create new frames on it");
903

Jim Blandy's avatar
Jim Blandy committed
904
  f = make_frame (1);
905

906
  XSETFRAME (frame, f);
907 908
  Vframe_list = Fcons (frame, Vframe_list);

909
  fset_name (f, make_formatted_string (name, "F%"pMd, ++tty_frame_count));
910

911 912
  SET_FRAME_VISIBLE (f, 1);

913 914
  f->terminal = terminal;
  f->terminal->reference_count++;
915
#ifdef MSDOS
916
  f->output_data.tty->display_info = &the_only_display_info;
917 918 919
  if (!inhibit_window_system
      && (!FRAMEP (selected_frame) || !FRAME_LIVE_P (XFRAME (selected_frame))
	  || XFRAME (selected_frame)->output_method == output_msdos_raw))
920
    f->output_method = output_msdos_raw;
921 922
  else
    f->output_method = output_termcap;
923 924 925 926 927 928
#else /* not MSDOS */
  f->output_method = output_termcap;
  create_tty_output (f);
  FRAME_FOREGROUND_PIXEL (f) = FACE_TTY_DEFAULT_FG_COLOR;
  FRAME_BACKGROUND_PIXEL (f) = FACE_TTY_DEFAULT_BG_COLOR;
#endif /* not MSDOS */
929

930
#ifdef HAVE_WINDOW_SYSTEM
931
  f->vertical_scroll_bar_type = vertical_scroll_bar_none;
932
  f->horizontal_scroll_bars = false;
933
#endif
934

935
  FRAME_MENU_BAR_LINES (f) = NILP (Vmenu_bar_mode) ? 0 : 1;
936
  FRAME_LINES (f) = FRAME_LINES (f) - FRAME_MENU_BAR_LINES (f);
937
  FRAME_MENU_BAR_HEIGHT (f) = FRAME_MENU_BAR_LINES (f) * FRAME_LINE_HEIGHT (f);
938
  FRAME_TEXT_HEIGHT (f) = FRAME_TEXT_HEIGHT (f) - FRAME_MENU_BAR_HEIGHT (f);
939

940
  /* Set the top frame to the newly created frame.  */
941 942
  if (FRAMEP (FRAME_TTY (f)->top_frame)
      && FRAME_LIVE_P (XFRAME (FRAME_TTY (f)->top_frame)))
943
    SET_FRAME_VISIBLE (XFRAME (FRAME_TTY (f)->top_frame), 2); /* obscured */
944 945 946

  FRAME_TTY (f)->top_frame = frame;

947 948
  if (!noninteractive)
    init_frame_faces (f);
949

Jim Blandy's avatar
Jim Blandy committed
950
  return f;
Jim Blandy's avatar
Jim Blandy committed
951
}
952

953 954
/* Get a suitable value for frame parameter PARAMETER for a newly
   created frame, based on (1) the user-supplied frame parameter
955
   alist SUPPLIED_PARMS, and (2) CURRENT_VALUE.  */
956 957 958 959 960 961 962 963 964 965

static Lisp_Object
get_future_frame_param (Lisp_Object parameter,
                        Lisp_Object supplied_parms,
                        char *current_value)
{
  Lisp_Object result;

  result = Fassq (parameter, supplied_parms);
  if (NILP (result))
966
    result = Fassq (parameter, XFRAME (selected_frame)->param_alist);
967 968 969 970 971 972 973 974 975 976
  if (NILP (result) && current_value != NULL)
    result = build_string (current_value);
  if (!NILP (result) && !STRINGP (result))
    result = XCDR (result);
  if (NILP (result) || !STRINGP (result))
    result = Qnil;

  return result;
}

977
DEFUN ("make-terminal-frame", Fmake_terminal_frame, Smake_terminal_frame,
978
       1, 1, 0,
979
       doc: /* Create an additional terminal frame, possibly on another terminal.
980
This function takes one argument, an alist specifying frame parameters.
981

982 983
You can create multiple frames on a single text terminal, but only one
of them (the selected terminal frame) is actually displayed.
984 985 986 987 988 989

In practice, generally you don't need to specify any parameters,
except when you want to create a new frame on another terminal.
In that case, the `tty' parameter specifies the device file to open,
and the `tty-type' parameter specifies the terminal type.  Example:

990
   (make-terminal-frame \\='((tty . "/dev/pts/5") (tty-type . "xterm")))
991

992 993
Note that changing the size of one terminal frame automatically
affects all frames on the same terminal device.  */)