frame.c 158 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-2015 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
#include "character.h"
30 31 32 33 34

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

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

58 59 60 61 62 63 64 65 66
/* 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;

67
/* False means there are no visible garbaged frames.  */
68 69
bool frame_garbaged;

70 71 72 73
#ifdef HAVE_WINDOW_SYSTEM
static void x_report_frame_params (struct frame *, Lisp_Object *);
#endif

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

86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103
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);
}

104 105
#ifdef HAVE_WINDOW_SYSTEM

106 107 108
bool
window_system_available (struct frame *f)
{
109
  return f ? FRAME_WINDOW_P (f) || FRAME_MSDOS_P (f) : x_display_list != NULL;
110 111
}

112 113
#endif /* HAVE_WINDOW_SYSTEM */

114 115 116 117
struct frame *
decode_window_system_frame (Lisp_Object frame)
{
  struct frame *f = decode_live_frame (frame);
118

119 120 121 122 123 124 125 126 127 128 129 130 131
  if (!window_system_available (f))
    error ("Window system frame should be used");
  return f;
}

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");
}

132
/* Return the value of frame parameter PROP in frame FRAME.  */
133

134 135 136 137 138 139 140 141 142 143 144 145 146
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);
}

/* Return 1 if `frame-inhibit-implied-resize' is non-nil or fullscreen
   state of frame F would be affected by a vertical (horizontal if
147 148
   HORIZONTAL is true) resize.  PARAMETER is the symbol of the frame
   parameter that is changed.  */
149
bool
150
frame_inhibit_resize (struct frame *f, bool horizontal, Lisp_Object parameter)
151
{
152 153 154
  return (EQ (frame_inhibit_implied_resize, Qt)
	  || (CONSP (frame_inhibit_implied_resize)
	      && !NILP (Fmemq (parameter, frame_inhibit_implied_resize)))
155 156
	  || !NILP (get_frame_param (f, Qfullscreen))
	  || FRAME_TERMCAP_P (f) || FRAME_MSDOS_P (f));
157 158
}

159
static void
160
set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
161 162 163 164 165 166
{
  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
167
     frame itself, and get an error because you can't switch buffers
168 169 170 171
     in or split the minibuffer window.  */
  if (FRAME_MINIBUF_ONLY_P (f))
    return;

172
  if (TYPE_RANGED_INTEGERP (int, value))
173 174 175 176
    nlines = XINT (value);
  else
    nlines = 0;

177 178
  if (nlines != olines)
    {
179
      windows_or_buffers_changed = 14;
180
      FRAME_MENU_BAR_LINES (f) = nlines;
181
      FRAME_MENU_BAR_HEIGHT (f) = nlines * FRAME_LINE_HEIGHT (f);
182 183 184
      change_frame_size (f, FRAME_COLS (f),
			 FRAME_LINES (f) + olines - nlines,
			 0, 1, 0, 0);
185
    }
186 187 188 189
}

Lisp_Object Vframe_list;

Jim Blandy's avatar
Jim Blandy committed
190

Jim Blandy's avatar
Jim Blandy committed
191
DEFUN ("framep", Fframep, Sframep, 1, 1, 0,
192
       doc: /* Return non-nil if OBJECT is a frame.
193 194 195 196 197 198
Value is:
  t for a termcap frame (a character-only terminal),
 '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.
199
See also `frame-live-p'.  */)
Dan Nicolaescu's avatar
Dan Nicolaescu committed
200
  (Lisp_Object object)
Jim Blandy's avatar
Jim Blandy committed
201
{
202
  if (!FRAMEP (object))
Jim Blandy's avatar
Jim Blandy committed
203
    return Qnil;
Jim Blandy's avatar
Jim Blandy committed
204
  switch (XFRAME (object)->output_method)
Jim Blandy's avatar
Jim Blandy committed
205
    {
206
    case output_initial: /* The initial frame is like a termcap frame. */
Jim Blandy's avatar
Jim Blandy committed
207 208 209
    case output_termcap:
      return Qt;
    case output_x_window:
210
      return Qx;
211 212
    case output_w32:
      return Qw32;
213 214
    case output_msdos_raw:
      return Qpc;
215 216
    case output_ns:
      return Qns;
Jim Blandy's avatar
Jim Blandy committed
217
    default:
218
      emacs_abort ();
Jim Blandy's avatar
Jim Blandy committed
219 220 221
    }
}

Jim Blandy's avatar
Jim Blandy committed
222
DEFUN ("frame-live-p", Fframe_live_p, Sframe_live_p, 1, 1, 0,
223 224
       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
225
frame, the return value indicates what sort of terminal device it is
Pavel Janík's avatar
Pavel Janík committed
226
displayed on.  See the documentation of `framep' for possible
Pavel Janík's avatar
Pavel Janík committed
227
return values.  */)
Dan Nicolaescu's avatar
Dan Nicolaescu committed
228
  (Lisp_Object object)
Jim Blandy's avatar
Jim Blandy committed
229
{
Jim Blandy's avatar
Jim Blandy committed
230 231 232
  return ((FRAMEP (object)
	   && FRAME_LIVE_P (XFRAME (object)))
	  ? Fframep (object)
Jim Blandy's avatar
Jim Blandy committed
233 234 235
	  : Qnil);
}

Paul Eggert's avatar
Paul Eggert committed
236
DEFUN ("window-system", Fwindow_system, Swindow_system, 0, 1, 0,
237
       doc: /* The name of the window system that FRAME is displaying through.
238 239 240 241 242 243 244 245 246 247 248 249
The value is a symbol:
 nil for a termcap frame (a character-only terminal),
 '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.

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
250
  (Lisp_Object frame)
251 252 253 254 255 256 257 258 259 260 261 262 263 264
{
  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;
265
}
266

267 268 269 270 271 272 273 274 275 276
/* 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,
       doc: /* */)
     (Lisp_Object frame, Lisp_Object horizontal,
      Lisp_Object ignore, Lisp_Object pixelwise)
{
  return make_number (0);
}

277
static int
278 279
frame_windows_min_size (Lisp_Object frame, Lisp_Object horizontal,
			Lisp_Object ignore, Lisp_Object pixelwise)
280
{
281 282
  return XINT (call4 (Qframe_windows_min_size, frame, horizontal,
		      ignore, pixelwise));
283 284 285 286 287
}


/* 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
288
   size (but the frame may still have to be resized to accommodate
289 290 291
   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.
292 293 294 295

   The argument INHIBIT can assume the following values:

   0 means to unconditionally call x_set_window_size even if sizes
296 297
     apparently do not change.  Fx_create_frame uses this to pass the
     initial size to the window manager.
298

299 300
   1 means to call x_set_window_size if the outer frame size really
     changes.  Fset_frame_size, Fset_frame_height, ... use this.
301

302 303 304 305
   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).
306

307 308 309
   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.
310

311 312 313
   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.
314 315

   5 means to never call x_set_window_size.  change_frame_size uses
316
     this.
317

318 319 320
   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.
321

322 323 324 325
   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.  */
326
void
327 328
adjust_frame_size (struct frame *f, int new_width, int new_height, int inhibit,
		   bool pretend, Lisp_Object parameter)
329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363
{
  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);
  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)
       + (FRAME_HAS_MINIBUF_P (f)
	  ? 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);
  /* 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).  */
364 365 366 367
  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);
368 369 370 371 372 373 374

  if (inhibit >= 2 && inhibit <= 4)
    /* If INHIBIT is in [2..4] inhibit if the "old" window sizes stay
       within the limits and either frame_inhibit_resize tells us to do
       so or INHIBIT equals 4.  */
    {
      inhibit_horizontal = ((windows_width >= min_windows_width
375 376
			     && (inhibit == 4
				 || frame_inhibit_resize (f, true, parameter)))
377 378
			    ? true : false);
      inhibit_vertical = ((windows_height >= min_windows_height
379 380
			   && (inhibit == 4
			       || frame_inhibit_resize (f, false, parameter)))
381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408
			  ? true : false);
    }
  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
409
  if (FRAME_WINDOW_P (f)
410
      && f->can_x_set_window_size
411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 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 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487
      && ((!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;

      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
      && new_pixel_height == old_pixel_height)
    /* No change.  Sanitize window sizes and return.  */
    {
      sanitize_window_sizes (frame, Qt);
      sanitize_window_sizes (frame, Qnil);

      return;
    }

  block_input ();

#ifdef MSDOS
  /* 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.  */
  dos_set_window_size (&new_lines, &new_cols);
#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
    }

  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))
488
	FrameRows (FRAME_TTY (f)) = new_lines + FRAME_TOP_MARGIN (f);
489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529
    }

  /* 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 ();

  run_window_configuration_change_hook (f);
}


Jim Blandy's avatar
Jim Blandy committed
530
struct frame *
531
make_frame (bool mini_p)
Jim Blandy's avatar
Jim Blandy committed
532
{
Jim Blandy's avatar
Jim Blandy committed
533 534
  Lisp_Object frame;
  register struct frame *f;
535
  register struct window *rw, *mw;
Jim Blandy's avatar
Jim Blandy committed
536 537
  register Lisp_Object root_window;
  register Lisp_Object mini_window;
538 539

  f = allocate_frame ();
540
  XSETFRAME (frame, f);
Jim Blandy's avatar
Jim Blandy committed
541

542
#ifdef USE_GTK
543 544
  /* Initialize Lisp data.  Note that allocate_frame initializes all
     Lisp data to nil, so do it only for slots which should not be nil.  */
545
  fset_tool_bar_position (f, Qtop);
546
#endif
547 548 549 550 551

  /* 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.  */
552 553 554
  f->wants_modeline = true;
  f->redisplay = true;
  f->garbaged = true;
555 556
  f->can_x_set_window_size = false;
  f->can_run_window_configuration_change_hook = false;
557 558
  f->column_width = 1;  /* !FRAME_WINDOW_P value.  */
  f->line_height = 1;  /* !FRAME_WINDOW_P value.  */
559
#ifdef HAVE_WINDOW_SYSTEM
560
  f->vertical_scroll_bar_type = vertical_scroll_bar_none;
561
  f->horizontal_scroll_bars = false;
562
  f->want_fullscreen = FULLSCREEN_NONE;
563 564 565
#if ! defined (USE_GTK) && ! defined (HAVE_NS)
  f->last_tool_bar_item = -1;
#endif
566
#endif
Jim Blandy's avatar
Jim Blandy committed
567

568
  root_window = make_window ();
569
  rw = XWINDOW (root_window);
Jim Blandy's avatar
Jim Blandy committed
570 571
  if (mini_p)
    {
572
      mini_window = make_window ();
573 574 575 576 577
      mw = XWINDOW (mini_window);
      wset_next (rw, mini_window);
      wset_prev (mw, root_window);
      mw->mini = 1;
      wset_frame (mw, frame);
578
      fset_minibuffer_window (f, mini_window);
Jim Blandy's avatar
Jim Blandy committed
579 580 581 582
    }
  else
    {
      mini_window = Qnil;
583
      wset_next (rw, Qnil);
584
      fset_minibuffer_window (f, Qnil);
Jim Blandy's avatar
Jim Blandy committed
585 586
    }

587
  wset_frame (rw, frame);
Jim Blandy's avatar
Jim Blandy committed
588 589 590

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

593
  SET_FRAME_COLS (f, 10);
594
  SET_FRAME_LINES (f, 10);
595 596
  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
597

598 599 600 601
  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
602 603 604

  if (mini_p)
    {
605 606 607 608 609 610
      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
611 612
    }

Jim Blandy's avatar
Jim Blandy committed
613
  /* Choose a buffer for the frame's root window.  */
Jim Blandy's avatar
Jim Blandy committed
614
  {
615
    Lisp_Object buf = Fcurrent_buffer ();
Jim Blandy's avatar
Jim Blandy committed
616

617 618
    /* If current buffer is hidden, try to find another one.  */
    if (BUFFER_HIDDEN_P (XBUFFER (buf)))
619
      buf = other_buffer_safely (buf);
620

621 622
    /* 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
623
       arrangement is not yet fully initialized at this point.  Windows
624 625 626
       don't have the right size, glyph matrices aren't initialized
       etc.  Running Lisp functions at this point surely ends in a
       SEGV.  */
627
    set_window_buffer (root_window, buf, 0, 0);
628
    fset_buffer_list (f, list1 (buf));
Jim Blandy's avatar
Jim Blandy committed
629 630
  }

Jim Blandy's avatar
Jim Blandy committed
631
  if (mini_p)
632 633 634 635 636 637 638 639 640
    {
      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
641

642 643
  fset_root_window (f, root_window);
  fset_selected_window (f, root_window);
Jim Blandy's avatar
Jim Blandy committed
644 645
  /* Make sure this window seems more recently used than
     a newly-created, never-selected window.  */
646
  XWINDOW (f->selected_window)->use_time = ++window_select_count;
Jim Blandy's avatar
Jim Blandy committed
647

Jim Blandy's avatar
Jim Blandy committed
648
  return f;
Jim Blandy's avatar
Jim Blandy committed
649 650
}

651
#ifdef HAVE_WINDOW_SYSTEM
Jim Blandy's avatar
Jim Blandy committed
652
/* Make a frame using a separate minibuffer window on another frame.
Jim Blandy's avatar
Jim Blandy committed
653 654 655
   MINI_WINDOW is the minibuffer window to use.  nil means use the
   default (the global minibuffer).  */

Jim Blandy's avatar
Jim Blandy committed
656
struct frame *
657
make_frame_without_minibuffer (register Lisp_Object mini_window, KBOARD *kb, Lisp_Object display)
Jim Blandy's avatar
Jim Blandy committed
658
{
Jim Blandy's avatar
Jim Blandy committed
659
  register struct frame *f;
660
  struct gcpro gcpro1;
Jim Blandy's avatar
Jim Blandy committed
661

662
  if (!NILP (mini_window))
663
    CHECK_LIVE_WINDOW (mini_window);
Jim Blandy's avatar
Jim Blandy committed
664

665
  if (!NILP (mini_window)
666
      && FRAME_KBOARD (XFRAME (XWINDOW (mini_window)->frame)) != kb)
667
    error ("Frame and minibuffer must be on the same terminal");
668

Jim Blandy's avatar
Jim Blandy committed
669 670
  /* Make a frame containing just a root window.  */
  f = make_frame (0);
Jim Blandy's avatar
Jim Blandy committed
671

672 673 674
  if (NILP (mini_window))
    {
      /* Use default-minibuffer-frame if possible.  */
675 676
      if (!FRAMEP (KVAR (kb, Vdefault_minibuffer_frame))
	  || ! FRAME_LIVE_P (XFRAME (KVAR (kb, Vdefault_minibuffer_frame))))
677
	{
678 679 680 681
          Lisp_Object frame_dummy;

          XSETFRAME (frame_dummy, f);
          GCPRO1 (frame_dummy);
682
	  /* If there's no minibuffer frame to use, create one.  */
Paul Eggert's avatar
Paul Eggert committed
683 684
	  kset_default_minibuffer_frame
	    (kb, call1 (intern ("make-initial-minibuffer-frame"), display));
685
          UNGCPRO;
686
	}
687

688 689
      mini_window
	= XFRAME (KVAR (kb, Vdefault_minibuffer_frame))->minibuffer_window;
690
    }
691

692
  fset_minibuffer_window (f, mini_window);
693 694 695

  /* Make the chosen minibuffer window display the proper minibuffer,
     unless it is already showing a minibuffer.  */
696
  if (NILP (Fmemq (XWINDOW (mini_window)->contents, Vminibuffer_list)))
697 698 699 700 701 702
    /* 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
703
  return f;
Jim Blandy's avatar
Jim Blandy committed
704 705
}

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

Jim Blandy's avatar
Jim Blandy committed
708
struct frame *
709
make_minibuffer_frame (void)
Jim Blandy's avatar
Jim Blandy committed
710
{
Jim Blandy's avatar
Jim Blandy committed
711
  /* First make a frame containing just a root window, no minibuffer.  */
Jim Blandy's avatar
Jim Blandy committed
712

Jim Blandy's avatar
Jim Blandy committed
713
  register struct frame *f = make_frame (0);
Jim Blandy's avatar
Jim Blandy committed
714
  register Lisp_Object mini_window;
Jim Blandy's avatar
Jim Blandy committed
715
  register Lisp_Object frame;
Jim Blandy's avatar
Jim Blandy committed
716

717
  XSETFRAME (frame, f);
Jim Blandy's avatar
Jim Blandy committed
718

719
  f->auto_raise = 0;
Jim Blandy's avatar
Jim Blandy committed
720 721 722
  f->auto_lower = 0;
  f->no_split = 1;
  f->wants_modeline = 0;
Jim Blandy's avatar
Jim Blandy committed
723 724 725 726 727

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

728 729
  mini_window = f->root_window;
  fset_minibuffer_window (f, mini_window);
730
  XWINDOW (mini_window)->mini = 1;
Paul Eggert's avatar
Paul Eggert committed
731 732 733
  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
734 735 736

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

737 738 739 740 741 742
  /* 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
743
  return f;
Jim Blandy's avatar
Jim Blandy committed
744
}
745
#endif /* HAVE_WINDOW_SYSTEM */
Jim Blandy's avatar
Jim Blandy committed
746

747
/* Construct a frame that refers to a terminal.  */
Jim Blandy's avatar
Jim Blandy committed
748

749
static printmax_t tty_frame_count;
750

Jim Blandy's avatar
Jim Blandy committed
751
struct frame *
752
make_initial_frame (void)
Jim Blandy's avatar
Jim Blandy committed
753
{
754
  struct frame *f;
755
  struct terminal *terminal;
756
  Lisp_Object frame;
757

758
  eassert (initial_kboard);
759

760 761 762
  /* The first call must initialize Vframe_list.  */
  if (! (NILP (Vframe_list) || CONSP (Vframe_list)))
    Vframe_list = Qnil;
Jim Blandy's avatar
Jim Blandy committed
763

764
  terminal = init_initial_terminal ();
765 766 767 768 769 770

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

  Vframe_list = Fcons (frame, Vframe_list);

771
  tty_frame_count = 1;
772
  fset_name (f, build_pure_c_string ("F1"));
773

774
  SET_FRAME_VISIBLE (f, 1);
775

776 777 778
  f->output_method = terminal->type;
  f->terminal = terminal;
  f->terminal->reference_count++;
779
  f->output_data.nothing = 0;
780

781 782
  FRAME_FOREGROUND_PIXEL (f) = FACE_TTY_DEFAULT_FG_COLOR;
  FRAME_BACKGROUND_PIXEL (f) = FACE_TTY_DEFAULT_BG_COLOR;
783

784 785
#ifdef HAVE_WINDOW_SYSTEM
  f->vertical_scroll_bar_type = vertical_scroll_bar_none;
786
  f->horizontal_scroll_bars = false;
787
#endif
788 789 790

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

792 793 794
  if (!noninteractive)
    init_frame_faces (f);

795 796
  last_nonminibuf_frame = f;

797 798 799 800
  return f;
}


801
static struct frame *
802
make_terminal_frame (struct terminal *terminal)
803 804 805
{
  register struct frame *f;
  Lisp_Object frame;
806
  char name[sizeof "F" + INT_STRLEN_BOUND (printmax_t)];
807

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

Jim Blandy's avatar
Jim Blandy committed
811
  f = make_frame (1);
812

813
  XSETFRAME (frame, f);
814 815
  Vframe_list = Fcons (frame, Vframe_list);

816
  fset_name (f, make_formatted_string (name, "F%"pMd, ++tty_frame_count));
817

818 819
  SET_FRAME_VISIBLE (f, 1);

820 821
  f->terminal = terminal;
  f->terminal->reference_count++;
822
#ifdef MSDOS
823
  f->output_data.tty->display_info = &the_only_display_info;
824 825 826
  if (!inhibit_window_system
      && (!FRAMEP (selected_frame) || !FRAME_LIVE_P (XFRAME (selected_frame))
	  || XFRAME (selected_frame)->output_method == output_msdos_raw))
827
    f->output_method = output_msdos_raw;
828 829
  else
    f->output_method = output_termcap;
830 831 832 833 834 835
#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 */
836

837
#ifdef HAVE_WINDOW_SYSTEM
838
  f->vertical_scroll_bar_type = vertical_scroll_bar_none;
839
  f->horizontal_scroll_bars = false;
840
#endif
841

842
  FRAME_MENU_BAR_LINES (f) = NILP (Vmenu_bar_mode) ? 0 : 1;
843
  FRAME_LINES (f) = FRAME_LINES (f) - FRAME_MENU_BAR_LINES (f);
844
  FRAME_MENU_BAR_HEIGHT (f) = FRAME_MENU_BAR_LINES (f) * FRAME_LINE_HEIGHT (f);
845
  FRAME_TEXT_HEIGHT (f) = FRAME_TEXT_HEIGHT (f) - FRAME_MENU_BAR_HEIGHT (f);
846

847
  /* Set the top frame to the newly created frame.  */
848 849
  if (FRAMEP (FRAME_TTY (f)->top_frame)
      && FRAME_LIVE_P (XFRAME (FRAME_TTY (f)->top_frame)))
850
    SET_FRAME_VISIBLE (XFRAME (FRAME_TTY (f)->top_frame), 2); /* obscured */
851 852 853

  FRAME_TTY (f)->top_frame = frame;

854 855
  if (!noninteractive)
    init_frame_faces (f);
856

Jim Blandy's avatar
Jim Blandy committed
857
  return f;
Jim Blandy's avatar
Jim Blandy committed
858
}
859

860 861
/* Get a suitable value for frame parameter PARAMETER for a newly
   created frame, based on (1) the user-supplied frame parameter
862
   alist SUPPLIED_PARMS, and (2) CURRENT_VALUE.  */
863 864 865 866 867 868 869 870 871 872

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))
873
    result = Fassq (parameter, XFRAME (selected_frame)->param_alist);
874 875 876 877 878 879 880 881 882 883
  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;
}

884
DEFUN ("make-terminal-frame", Fmake_terminal_frame, Smake_terminal_frame,
885
       1, 1, 0,
886
       doc: /* Create an additional terminal frame, possibly on another terminal.
887
This function takes one argument, an alist specifying frame parameters.
888

889 890
You can create multiple frames on a single text terminal, but only one
of them (the selected terminal frame) is actually displayed.
891 892 893 894 895 896 897 898

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:

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

899 900
Note that changing the size of one terminal frame automatically
affects all frames on the same terminal device.  */)
Dan Nicolaescu's avatar
Dan Nicolaescu committed
901
  (Lisp_Object parms)
902 903
{
  struct frame *f;
904
  struct terminal *t = NULL;
905
  Lisp_Object frame, tem;
906
  struct frame *sf = SELECTED_FRAME ();
907

908
#ifdef MSDOS
909 910
  if (sf->output_method != output_msdos_raw
      && sf->output_method != output_termcap)
911
    emacs_abort ();
912 913
#else /* not MSDOS */

914
#ifdef WINDOWSNT                           /* This should work now! */
915
  if (sf->output_method != output_termcap)
916
    error ("Not using an ASCII terminal now; cannot make a new ASCII frame");
917
#endif
918
#endif /* not MSDOS */
919

920
  {
921
    Lisp_Object terminal;
922

923
    terminal = Fassq (Qterminal, parms);
924
    if (CONSP (terminal))
925
      {
926
        terminal = XCDR (terminal);
927
        t = decode_live_terminal (terminal);
928
      }
929 930 931 932 933 934 935
#ifdef MSDOS
    if (t && t != the_only_display_info.terminal)
      /* msdos.c assumes a single tty_display_info object.  */
      error ("Multiple terminals are not supported on this platform");
    if (!t)
      t = the_only_display_info.terminal;
#endif
936
  }
937

938
  if (!t)
939
    {
940
      char *name = 0, *type = 0;
941
      Lisp_Object tty, tty_type;
942
      USE_SAFE_ALLOCA;
943

944 945 946 947 948
      tty = get_future_frame_param
        (Qtty, parms, (FRAME_TERMCAP_P (XFRAME (selected_frame))
                       ? FRAME_TTY (XFRAME (selected_frame))->name
                       : NULL));
      if (!NILP (tty))
949
	SAFE_ALLOCA_STRING (name, tty);
950

951 952 953 954 955
      tty_type = get_future_frame_param
        (Qtty_type, parms, (FRAME_TERMCAP_P (XFRAME (selected_frame))
                            ? FRAME_TTY (XFRAME (selected_frame))->type
                            : NULL));
      if (!NILP (tty_type))
956
	SAFE_ALLOCA_STRING (type, tty_type);
957

958
      t = init_tty (name, type, 0); /* Errors are not fatal.  */
959
      SAFE_FREE ();
960
    }
961

962
  f = make_terminal_frame (t);
963

964 965
  {
    int width, height;
966
    get_tty_size (fileno (FRAME_TTY (f)->input), &width, &height);
967
    adjust_frame_size (f, width, height - FRAME_MENU_BAR_LINES (f), 5, 0, Qnil);
968
  }
969

970
  adjust_frame_glyphs (f);
971 972
  calculate_costs (f);
  XSETFRAME (frame, f);
973 974