src/frame.h

   1 /* Define frame-object for GNU Emacs.
   2    Copyright (C) 1993, 1994, 1999, 2000, 2001, 2002, 2003, 2004,
   3                  2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
   4
   5 This file is part of GNU Emacs.
   6
   7 GNU Emacs is free software: you can redistribute it and/or modify
   8 it under the terms of the GNU General Public License as published by
   9 the Free Software Foundation, either version 3 of the License, or
  10 (at your option) any later version.
  11
  12 GNU Emacs is distributed in the hope that it will be useful,
  13 but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 GNU General Public License for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.  */
  19
  20 /* Don't multiply include: dispextern.h includes macterm.h which
  21    includes frame.h some emacs source includes both dispextern.h and
  22    frame.h */
  23
  24 #ifndef EMACS_FRAME_H
  25 #define EMACS_FRAME_H
  26
  27 #include "dispextern.h"
  28
  29 \f
  30 /* Miscellanea.  */
  31
  32 /* Nonzero means there is at least one garbaged frame. */
  33 extern int frame_garbaged;
  34
  35 /* Nonzero means FRAME_MESSAGE_BUF (selected_frame) is being used by
  36    print.  */
  37
  38 extern int message_buf_print;
  39
  40 /* Nonzero means window system changes focus when moving the
  41    mouse.  */
  42
  43 extern int focus_follows_mouse;
  44
  45 \f
  46 /* The structure representing a frame.  */
  47
  48 enum output_method
  49 {
  50   output_initial,
  51   output_termcap,
  52   output_x_window,
  53   output_msdos_raw,
  54   output_w32,
  55   output_mac,
  56   output_ns
  57 };
  58
  59 enum vertical_scroll_bar_type
  60 {
  61   vertical_scroll_bar_none,
  62   vertical_scroll_bar_left,
  63   vertical_scroll_bar_right
  64 };
  65
  66 enum text_cursor_kinds
  67 {
  68   DEFAULT_CURSOR = -2,
  69   NO_CURSOR = -1,
  70   FILLED_BOX_CURSOR,
  71   HOLLOW_BOX_CURSOR,
  72   BAR_CURSOR,
  73   HBAR_CURSOR
  74 };
  75
  76 enum fullscreen_type
  77 {
  78   FULLSCREEN_NONE,
  79   FULLSCREEN_WIDTH     = 0x001,
  80   FULLSCREEN_HEIGHT    = 0x002,
  81   FULLSCREEN_BOTH      = 0x003,
  82   FULLSCREEN_MAXIMIZED = 0x013,
  83   FULLSCREEN_WAIT      = 0x100
  84 };
  85
  86
  87 #define FRAME_FOREGROUND_PIXEL(f) ((f)->foreground_pixel)
  88 #define FRAME_BACKGROUND_PIXEL(f) ((f)->background_pixel)
  89
  90 struct terminal;
  91
  92 struct font_driver_list;
  93
  94 struct frame
  95 {
  96   EMACS_UINT size;
  97   struct Lisp_Vector *next;
  98
  99   /* All Lisp_Object components must come first.
 100      That ensures they are all aligned normally.  */
 101
 102   /* Name of this frame: a Lisp string.  It is used for looking up resources,
 103      as well as for the title in some cases.  */
 104   Lisp_Object name;
 105
 106   /* The name to use for the icon, the last time
 107      it was refreshed.  nil means not explicitly specified.  */
 108   Lisp_Object icon_name;
 109
 110   /* This is the frame title specified explicitly, if any.
 111      Usually it is nil.  */
 112   Lisp_Object title;
 113
 114   /* The frame which should receive keystrokes that occur in this
 115      frame, or nil if they should go to the frame itself.  This is
 116      usually nil, but if the frame is minibufferless, we can use this
 117      to redirect keystrokes to a surrogate minibuffer frame when
 118      needed.
 119
 120      Note that a value of nil is different than having the field point
 121      to the frame itself.  Whenever the Fselect_frame function is used
 122      to shift from one frame to the other, any redirections to the
 123      original frame are shifted to the newly selected frame; if
 124      focus_frame is nil, Fselect_frame will leave it alone.  */
 125   Lisp_Object focus_frame;
 126
 127   /* This frame's root window.  Every frame has one.
 128      If the frame has only a minibuffer window, this is it.
 129      Otherwise, if the frame has a minibuffer window, this is its sibling.  */
 130   Lisp_Object root_window;
 131
 132   /* This frame's selected window.
 133      Each frame has its own window hierarchy
 134      and one of the windows in it is selected within the frame.
 135      The selected window of the selected frame is Emacs's selected window.  */
 136   Lisp_Object selected_window;
 137
 138   /* This frame's minibuffer window.
 139      Most frames have their own minibuffer windows,
 140      but only the selected frame's minibuffer window
 141      can actually appear to exist.  */
 142   Lisp_Object minibuffer_window;
 143
 144   /* Parameter alist of this frame.
 145      These are the parameters specified when creating the frame
 146      or modified with modify-frame-parameters.  */
 147   Lisp_Object param_alist;
 148
 149   /* List of scroll bars on this frame.
 150      Actually, we don't specify exactly what is stored here at all; the
 151      scroll bar implementation code can use it to store anything it likes.
 152      This field is marked by the garbage collector.  It is here
 153      instead of in the `device' structure so that the garbage
 154      collector doesn't need to look inside the window-system-dependent
 155      structure.  */
 156   Lisp_Object scroll_bars;
 157   Lisp_Object condemned_scroll_bars;
 158
 159   /* Vector describing the items to display in the menu bar.
 160      Each item has four elements in this vector.
 161      They are KEY, STRING, SUBMAP, and HPOS.
 162      (HPOS is not used in when the X toolkit is in use.)
 163      There are four additional elements of nil at the end, to terminate.  */
 164   Lisp_Object menu_bar_items;
 165
 166   /* Alist of elements (FACE-NAME . FACE-VECTOR-DATA).  */
 167   Lisp_Object face_alist;
 168
 169   /* A vector that records the entire structure of this frame's menu bar.
 170      For the format of the data, see extensive comments in xmenu.c.
 171      Only the X toolkit version uses this.  */
 172   Lisp_Object menu_bar_vector;
 173
 174   /* Predicate for selecting buffers for other-buffer.  */
 175   Lisp_Object buffer_predicate;
 176
 177   /* List of buffers viewed in this frame, for other-buffer.  */
 178   Lisp_Object buffer_list;
 179
 180   /* List of buffers that were viewed, then buried in this frame.  The
 181      most recently buried buffer is first.  For last-buffer.  */
 182   Lisp_Object buried_buffer_list;
 183
 184   /* A dummy window used to display menu bars under X when no X
 185      toolkit support is available.  */
 186   Lisp_Object menu_bar_window;
 187
 188   /* A window used to display the tool-bar of a frame.  */
 189   Lisp_Object tool_bar_window;
 190
 191   /* Desired and current tool-bar items.  */
 192   Lisp_Object tool_bar_items;
 193
 194   /* Where tool bar is, can be left, right, top or bottom.  The native
 195      tool bar only supports top.  */
 196   Lisp_Object tool_bar_position;
 197
 198   /* Desired and current contents displayed in tool_bar_window.  */
 199   Lisp_Object desired_tool_bar_string, current_tool_bar_string;
 200
 201   /* Beyond here, there should be no more Lisp_Object components.  */
 202
 203   /* Cache of realized faces.  */
 204   struct face_cache *face_cache;
 205
 206   /* Number of elements in `menu_bar_vector' that have meaningful data.  */
 207   EMACS_INT menu_bar_items_used;
 208
 209   /* A buffer to hold the frame's name.  We can't use the Lisp
 210      string's pointer (`name', above) because it might get relocated.  */
 211   char *namebuf;
 212
 213   /* Glyph pool and matrix. */
 214   struct glyph_pool *current_pool;
 215   struct glyph_pool *desired_pool;
 216   struct glyph_matrix *desired_matrix;
 217   struct glyph_matrix *current_matrix;
 218
 219   /* 1 means that glyphs on this frame have been initialized so it can
 220      be used for output.  */
 221   unsigned glyphs_initialized_p : 1;
 222
 223   /* Set to non-zero in change_frame_size when size of frame changed
 224      Clear the frame in clear_garbaged_frames if set.  */
 225   unsigned resized_p : 1;
 226
 227   /* Set to non-zero in when we want for force a flush_display in
 228      update_frame, usually after resizing the frame.  */
 229   unsigned force_flush_display_p : 1;
 230
 231   /* Set to non-zero if the default face for the frame has been
 232      realized.  Reset to zero whenever the default face changes.
 233      Used to see the difference between a font change and face change.  */
 234   unsigned default_face_done_p : 1;
 235
 236   /* Set to non-zero if this frame has already been hscrolled during
 237      current redisplay.  */
 238   unsigned already_hscrolled_p : 1;
 239
 240   /* Set to non-zero when current redisplay has updated frame.  */
 241   unsigned updated_p : 1;
 242
 243   /* Set to non-zero to minimize tool-bar height even when
 244      auto-resize-tool-bar is set to grow-only.  */
 245   unsigned minimize_tool_bar_window_p : 1;
 246
 247 #if defined (USE_GTK) || defined (HAVE_NS)
 248   /* Nonzero means using a tool bar that comes from the toolkit.  */
 249   int external_tool_bar;
 250 #endif
 251
 252   /* Margin at the top of the frame.  Used to display the tool-bar.  */
 253   int tool_bar_lines;
 254
 255   int n_tool_bar_rows;
 256   int n_tool_bar_items;
 257
 258   /* A buffer for decode_mode_line. */
 259   char *decode_mode_spec_buffer;
 260
 261   /* See do_line_insertion_deletion_costs for info on these arrays. */
 262   /* Cost of inserting 1 line on this frame */
 263   int *insert_line_cost;
 264   /* Cost of deleting 1 line on this frame */
 265   int *delete_line_cost;
 266   /* Cost of inserting n lines on this frame */
 267   int *insert_n_lines_cost;
 268   /* Cost of deleting n lines on this frame */
 269   int *delete_n_lines_cost;
 270
 271   /* Size of this frame, excluding fringes, scroll bars etc.,
 272      in units of canonical characters.  */
 273   EMACS_INT text_lines, text_cols;
 274
 275   /* Total size of this frame (i.e. its native window), in units of
 276      canonical characters.  */
 277   EMACS_INT total_lines, total_cols;
 278
 279   /* New text height and width for pending size change.
 280      0 if no change pending.  */
 281   int new_text_lines, new_text_cols;
 282
 283   /* Pixel position of the frame window (x and y offsets in root window).  */
 284   int left_pos, top_pos;
 285
 286   /* Size of the frame window in pixels.  */
 287   int pixel_height, pixel_width;
 288
 289   /* Dots per inch of the screen the frame is on.  */
 290   double resx, resy;
 291
 292   /* These many pixels are the difference between the outer window (i.e. the
 293      left and top of the window manager decoration) and FRAME_X_WINDOW. */
 294   int x_pixels_diff, y_pixels_diff;
 295
 296   /* This is the gravity value for the specified window position.  */
 297   int win_gravity;
 298
 299   /* The geometry flags for this window.  */
 300   int size_hint_flags;
 301
 302   /* Border width of the frame window as known by the (X) window system.  */
 303   int border_width;
 304
 305   /* Width of the internal border.  This is a line of background color
 306      just inside the window's border.  When the frame is selected,
 307      a highlighting is displayed inside the internal border.  */
 308   int internal_border_width;
 309
 310   /* Canonical X unit.  Width of default font, in pixels.  */
 311   int column_width;
 312
 313   /* Width of space glyph of default font, in pixels.  */
 314   int space_width;
 315
 316   /* Canonical Y unit.  Height of a line, in pixels.  */
 317   int line_height;
 318
 319   /* The output method says how the contents of this frame are
 320      displayed.  It could be using termcap, or using an X window.
 321      This must be the same as the terminal->type. */
 322   enum output_method output_method;
 323
 324   /* The terminal device that this frame uses.  If this is NULL, then
 325      the frame has been deleted. */
 326   struct terminal *terminal;
 327
 328   /* Device-dependent, frame-local auxiliary data used for displaying
 329      the contents.  When the frame is deleted, this data is deleted as
 330      well. */
 331   union output_data
 332   {
 333     struct tty_output *tty;     /* termchar.h */
 334     struct x_output *x;         /* xterm.h */
 335     struct w32_output *w32;     /* w32term.h */
 336     struct ns_output *ns;       /* nsterm.h */
 337     EMACS_INT nothing;
 338   }
 339   output_data;
 340
 341   /* List of font-drivers available on the frame. */
 342   struct font_driver_list *font_driver_list;
 343   /* List of data specific to font-driver and frame, but common to
 344      faces.  */
 345   struct font_data_list *font_data_list;
 346
 347   /* Total width of fringes reserved for drawing truncation bitmaps,
 348      continuation bitmaps and alike.  The width is in canonical char
 349      units of the frame.  This must currently be the case because window
 350      sizes aren't pixel values.  If it weren't the case, we wouldn't be
 351      able to split windows horizontally nicely.  */
 352   int fringe_cols;
 353
 354   /* The extra width (in pixels) currently allotted for fringes.  */
 355   int left_fringe_width, right_fringe_width;
 356
 357   /* See FULLSCREEN_ enum below */
 358   enum fullscreen_type want_fullscreen;
 359
 360   /* Number of lines of menu bar.  */
 361   int menu_bar_lines;
 362
 363 #if defined (USE_X_TOOLKIT) || defined (HAVE_NTGUI) \
 364     || defined (HAVE_NS) || defined (USE_GTK)
 365   /* Nonzero means using a menu bar that comes from the X toolkit.  */
 366   unsigned int external_menu_bar : 1;
 367 #endif
 368
 369   /* Nonzero if last attempt at redisplay on this frame was preempted.  */
 370   unsigned char display_preempted : 1;
 371
 372   /* visible is nonzero if the frame is currently displayed; we check
 373      it to see if we should bother updating the frame's contents.
 374      DON'T SET IT DIRECTLY; instead, use FRAME_SET_VISIBLE.
 375
 376      Note that, since invisible frames aren't updated, whenever a
 377      frame becomes visible again, it must be marked as garbaged.  The
 378      FRAME_SAMPLE_VISIBILITY macro takes care of this.
 379
 380      On ttys and on Windows NT/9X, to avoid wasting effort updating
 381      visible frames that are actually completely obscured by other
 382      windows on the display, we bend the meaning of visible slightly:
 383      if greater than 1, then the frame is obscured - we still consider
 384      it to be "visible" as seen from lisp, but we don't bother
 385      updating it.  We must take care to garbage the frame when it
 386      ceaces to be obscured though.
 387
 388      iconified is nonzero if the frame is currently iconified.
 389
 390      Asynchronous input handlers should NOT change these directly;
 391      instead, they should change async_visible or async_iconified, and
 392      let the FRAME_SAMPLE_VISIBILITY macro set visible and iconified
 393      at the next redisplay.
 394
 395      These should probably be considered read-only by everyone except
 396      FRAME_SAMPLE_VISIBILITY.
 397
 398      These two are mutually exclusive.  They might both be zero, if the
 399      frame has been made invisible without an icon.  */
 400   unsigned char visible : 2;
 401   unsigned char iconified : 1;
 402
 403   /* Let's not use bitfields for volatile variables.  */
 404
 405   /* Asynchronous input handlers change these, and
 406      FRAME_SAMPLE_VISIBILITY copies them into visible and iconified.
 407      See FRAME_SAMPLE_VISIBILITY, below.  */
 408   volatile char async_visible, async_iconified;
 409
 410   /* Nonzero if this frame should be redrawn.  */
 411   volatile char garbaged;
 412
 413   /* True if frame actually has a minibuffer window on it.
 414      0 if using a minibuffer window that isn't on this frame.  */
 415   unsigned char has_minibuffer : 1;
 416
 417   /* 0 means, if this frame has just one window,
 418      show no modeline for that window.  */
 419   unsigned char wants_modeline : 1;
 420
 421   /* Non-zero if the hardware device this frame is displaying on can
 422      support scroll bars.  */
 423   char can_have_scroll_bars;
 424
 425   /* Non-0 means raise this frame to the top of the heap when selected.  */
 426   unsigned char auto_raise : 1;
 427
 428   /* Non-0 means lower this frame to the bottom of the stack when left.  */
 429   unsigned char auto_lower : 1;
 430
 431   /* True if frame's root window can't be split.  */
 432   unsigned char no_split : 1;
 433
 434   /* If this is set, then Emacs won't change the frame name to indicate
 435      the current buffer, etcetera.  If the user explicitly sets the frame
 436      name, this gets set.  If the user sets the name to Qnil, this is
 437      cleared.  */
 438   unsigned char explicit_name : 1;
 439
 440   /* Nonzero if size of some window on this frame has changed.  */
 441   unsigned char window_sizes_changed : 1;
 442
 443   /* Nonzero if the mouse has moved on this display device
 444      since the last time we checked.  */
 445   unsigned char mouse_moved :1;
 446
 447   /* Nonzero means that the pointer is invisible. */
 448   unsigned char pointer_invisible :1;
 449
 450   /* If can_have_scroll_bars is non-zero, this is non-zero if we should
 451      actually display them on this frame.  */
 452   enum vertical_scroll_bar_type vertical_scroll_bar_type;
 453
 454   /* What kind of text cursor should we draw in the future?
 455      This should always be filled_box_cursor or bar_cursor.  */
 456   enum text_cursor_kinds desired_cursor;
 457
 458   /* Width of bar cursor (if we are using that).  */
 459   int cursor_width;
 460
 461   /* What kind of text cursor should we draw when the cursor blinks off?
 462      This can be filled_box_cursor or bar_cursor or no_cursor.  */
 463   enum text_cursor_kinds blink_off_cursor;
 464
 465   /* Width of bar cursor (if we are using that) for blink-off state.  */
 466   int blink_off_cursor_width;
 467
 468   /* Storage for messages to this frame. */
 469   char *message_buf;
 470
 471   /* Nonnegative if current redisplay should not do scroll computation
 472      for lines beyond a certain vpos.  This is the vpos.  */
 473   int scroll_bottom_vpos;
 474
 475   /* Configured width of the scroll bar, in pixels and in characters.
 476      config_scroll_bar_cols tracks config_scroll_bar_width if the
 477      latter is positive; a zero value in config_scroll_bar_width means
 478      to compute the actual width on the fly, using config_scroll_bar_cols
 479      and the current font width.  */
 480   int config_scroll_bar_width;
 481   int config_scroll_bar_cols;
 482
 483   /* The size of the extra width currently allotted for vertical
 484      scroll bars in this frame, in pixels.  */
 485   int scroll_bar_actual_width;
 486
 487   /* The baud rate that was used to calculate costs for this frame.  */
 488   int cost_calculation_baud_rate;
 489
 490   /* frame opacity
 491      alpha[0]: alpha transparency of the active frame
 492      alpha[1]: alpha transparency of inactive frames
 493      Negative values mean not to change alpha.  */
 494   double alpha[2];
 495
 496   /* Exponent for gamma correction of colors.  1/(VIEWING_GAMMA *
 497      SCREEN_GAMMA) where viewing_gamma is 0.4545 and SCREEN_GAMMA is a
 498      frame parameter.  0 means don't do gamma correction.  */
 499   double gamma;
 500
 501   /* Additional space to put between text lines on this frame.  */
 502   int extra_line_spacing;
 503
 504   /* All display backends seem to need these two pixel values. */
 505   unsigned long background_pixel;
 506   unsigned long foreground_pixel;
 507 };
 508
 509 #define FRAME_KBOARD(f) ((f)->terminal->kboard)
 510
 511 /* Return a pointer to the image cache of frame F.  */
 512 #define FRAME_IMAGE_CACHE(F) ((F)->terminal->image_cache)
 513
 514 typedef struct frame *FRAME_PTR;
 515
 516 #define XFRAME(p) (eassert (FRAMEP(p)),(struct frame *) XPNTR (p))
 517 #define XSETFRAME(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_FRAME))
 518
 519 /* Given a window, return its frame as a Lisp_Object.  */
 520 #define WINDOW_FRAME(w) (w)->frame
 521
 522 /* Test a frame for particular kinds of display methods.  */
 523 #define FRAME_INITIAL_P(f) ((f)->output_method == output_initial)
 524 #define FRAME_TERMCAP_P(f) ((f)->output_method == output_termcap)
 525 #define FRAME_X_P(f) ((f)->output_method == output_x_window)
 526 #define FRAME_W32_P(f) ((f)->output_method == output_w32)
 527 #define FRAME_MSDOS_P(f) ((f)->output_method == output_msdos_raw)
 528 #define FRAME_MAC_P(f) ((f)->output_method == output_mac)
 529 #define FRAME_NS_P(f) ((f)->output_method == output_ns)
 530
 531 /* FRAME_WINDOW_P tests whether the frame is a window, and is
 532    defined to be the predicate for the window system being used.  */
 533
 534 #ifdef HAVE_X_WINDOWS
 535 #define FRAME_WINDOW_P(f) FRAME_X_P (f)
 536 #endif
 537 #ifdef HAVE_NTGUI
 538 #define FRAME_WINDOW_P(f) FRAME_W32_P (f)
 539 #endif
 540 #ifdef HAVE_NS
 541 #define FRAME_WINDOW_P(f) FRAME_NS_P(f)
 542 #endif
 543 #ifndef FRAME_WINDOW_P
 544 #define FRAME_WINDOW_P(f) (0)
 545 #endif
 546
 547 /* Nonzero if frame F is still alive (not deleted).  */
 548 #define FRAME_LIVE_P(f) ((f)->terminal != 0)
 549
 550 /* Nonzero if frame F is a minibuffer-only frame.  */
 551 #define FRAME_MINIBUF_ONLY_P(f) \
 552   EQ (FRAME_ROOT_WINDOW (f), FRAME_MINIBUF_WINDOW (f))
 553
 554 /* Nonzero if frame F contains a minibuffer window.
 555    (If this is 0, F must use some other minibuffer window.)  */
 556 #define FRAME_HAS_MINIBUF_P(f) ((f)->has_minibuffer)
 557
 558 /* Pixel height of frame F, including non-toolkit menu bar and
 559    non-toolkit tool bar lines.  */
 560 #define FRAME_PIXEL_HEIGHT(f) ((f)->pixel_height)
 561
 562 /* Pixel width of frame F.  */
 563 #define FRAME_PIXEL_WIDTH(f) ((f)->pixel_width)
 564
 565 /* Height of frame F, measured in canonical lines, including
 566    non-toolkit menu bar and non-toolkit tool bar lines.  */
 567 #define FRAME_LINES(f) (f)->text_lines
 568
 569 /* Width of frame F, measured in canonical character columns,
 570    not including scroll bars if any.  */
 571 #define FRAME_COLS(f) (f)->text_cols
 572
 573 /* Number of lines of frame F used for menu bar.
 574    This is relevant on terminal frames and on
 575    X Windows when not using the X toolkit.
 576    These lines are counted in FRAME_LINES.  */
 577 #define FRAME_MENU_BAR_LINES(f) (f)->menu_bar_lines
 578
 579 /* Nonzero if this frame should display a tool bar
 580    in a way that does not use any text lines.  */
 581 #if defined (USE_GTK) || defined (HAVE_NS)
 582 #define FRAME_EXTERNAL_TOOL_BAR(f) (f)->external_tool_bar
 583 #else
 584 #define FRAME_EXTERNAL_TOOL_BAR(f) 0
 585 #endif
 586
 587 /* Number of lines of frame F used for the tool-bar.  */
 588
 589 #define FRAME_TOOL_BAR_LINES(f) (f)->tool_bar_lines
 590
 591
 592 /* Lines above the top-most window in frame F.  */
 593
 594 #define FRAME_TOP_MARGIN(F) \
 595      (FRAME_MENU_BAR_LINES (F) + FRAME_TOOL_BAR_LINES (F))
 596
 597 /* Pixel height of the top margin above.  */
 598
 599 #define FRAME_TOP_MARGIN_HEIGHT(f) \
 600   (FRAME_TOP_MARGIN (f) * FRAME_LINE_HEIGHT (f))
 601
 602 /* Nonzero if this frame should display a menu bar
 603    in a way that does not use any text lines.  */
 604 #if defined (USE_X_TOOLKIT) || defined (HAVE_NTGUI) \
 605      || defined (HAVE_NS) || defined (USE_GTK)
 606 #define FRAME_EXTERNAL_MENU_BAR(f) (f)->external_menu_bar
 607 #else
 608 #define FRAME_EXTERNAL_MENU_BAR(f) 0
 609 #endif
 610 #define FRAME_VISIBLE_P(f) ((f)->visible != 0)
 611
 612 /* Nonzero if frame F is currently visible but hidden.  */
 613 #define FRAME_OBSCURED_P(f) ((f)->visible > 1)
 614
 615 /* Nonzero if frame F is currently iconified.  */
 616 #define FRAME_ICONIFIED_P(f) (f)->iconified
 617
 618 #define FRAME_SET_VISIBLE(f,p) \
 619   ((f)->async_visible = (p), FRAME_SAMPLE_VISIBILITY (f))
 620 #define SET_FRAME_GARBAGED(f) (frame_garbaged = 1, f->garbaged = 1)
 621 #define FRAME_GARBAGED_P(f) (f)->garbaged
 622
 623 /* Nonzero means do not allow splitting this frame's window.  */
 624 #define FRAME_NO_SPLIT_P(f) (f)->no_split
 625
 626 /* Not really implemented.  */
 627 #define FRAME_WANTS_MODELINE_P(f) (f)->wants_modeline
 628
 629 /* Nonzero if a size change has been requested for frame F
 630    but not yet really put into effect.  This can be true temporarily
 631    when an X event comes in at a bad time.  */
 632 #define FRAME_WINDOW_SIZES_CHANGED(f) (f)->window_sizes_changed
 633
 634 /* The minibuffer window of frame F, if it has one; otherwise nil.  */
 635 #define FRAME_MINIBUF_WINDOW(f) (f)->minibuffer_window
 636
 637 /* The root window of the window tree of frame F.  */
 638 #define FRAME_ROOT_WINDOW(f) (f)->root_window
 639
 640 /* The currently selected window of the window tree of frame F.  */
 641 #define FRAME_SELECTED_WINDOW(f) (f)->selected_window
 642
 643 #define FRAME_INSERT_COST(f) (f)->insert_line_cost
 644 #define FRAME_DELETE_COST(f) (f)->delete_line_cost
 645 #define FRAME_INSERTN_COST(f) (f)->insert_n_lines_cost
 646 #define FRAME_DELETEN_COST(f) (f)->delete_n_lines_cost
 647 #define FRAME_MESSAGE_BUF(f) (f)->message_buf
 648 #define FRAME_SCROLL_BOTTOM_VPOS(f) (f)->scroll_bottom_vpos
 649 #define FRAME_FOCUS_FRAME(f) (f)->focus_frame
 650
 651 /* Nonzero if frame F supports scroll bars.
 652    If this is zero, then it is impossible to enable scroll bars
 653    on frame F.  */
 654 #define FRAME_CAN_HAVE_SCROLL_BARS(f) ((f)->can_have_scroll_bars)
 655
 656 /* This frame slot says whether scroll bars are currently enabled for frame F,
 657    and which side they are on.  */
 658 #define FRAME_VERTICAL_SCROLL_BAR_TYPE(f) ((f)->vertical_scroll_bar_type)
 659 #define FRAME_HAS_VERTICAL_SCROLL_BARS(f) \
 660      ((f)->vertical_scroll_bar_type != vertical_scroll_bar_none)
 661 #define FRAME_HAS_VERTICAL_SCROLL_BARS_ON_LEFT(f) \
 662      ((f)->vertical_scroll_bar_type == vertical_scroll_bar_left)
 663 #define FRAME_HAS_VERTICAL_SCROLL_BARS_ON_RIGHT(f) \
 664      ((f)->vertical_scroll_bar_type == vertical_scroll_bar_right)
 665
 666 /* Width that a scroll bar in frame F should have, if there is one.
 667    Measured in pixels.
 668    If scroll bars are turned off, this is still nonzero.  */
 669 #define FRAME_CONFIG_SCROLL_BAR_WIDTH(f) ((f)->config_scroll_bar_width)
 670
 671 /* Width that a scroll bar in frame F should have, if there is one.
 672    Measured in columns (characters).
 673    If scroll bars are turned off, this is still nonzero.  */
 674 #define FRAME_CONFIG_SCROLL_BAR_COLS(f) ((f)->config_scroll_bar_cols)
 675
 676 /* Width of a scroll bar in frame F, measured in columns (characters),
 677    but only if scroll bars are on the left.  If scroll bars are on
 678    the right in this frame, or there are no scroll bars, value is 0.  */
 679
 680 #define FRAME_LEFT_SCROLL_BAR_COLS(f)                   \
 681      (FRAME_HAS_VERTICAL_SCROLL_BARS_ON_LEFT (f)        \
 682       ? FRAME_CONFIG_SCROLL_BAR_COLS (f)                \
 683       : 0)
 684
 685 /* Width of a left scroll bar in frame F, measured in pixels */
 686
 687 #define FRAME_LEFT_SCROLL_BAR_AREA_WIDTH(f)                                     \
 688   (FRAME_HAS_VERTICAL_SCROLL_BARS_ON_LEFT (f)                           \
 689    ? (FRAME_CONFIG_SCROLL_BAR_COLS (f) * FRAME_COLUMN_WIDTH (f))        \
 690    : 0)
 691
 692 /* Width of a scroll bar in frame F, measured in columns (characters),
 693    but only if scroll bars are on the right.  If scroll bars are on
 694    the left in this frame, or there are no scroll bars, value is 0.  */
 695
 696 #define FRAME_RIGHT_SCROLL_BAR_COLS(f)                  \
 697      (FRAME_HAS_VERTICAL_SCROLL_BARS_ON_RIGHT (f)       \
 698       ? FRAME_CONFIG_SCROLL_BAR_COLS (f)                \
 699       : 0)
 700
 701 /* Width of a right scroll bar area in frame F, measured in pixels */
 702
 703 #define FRAME_RIGHT_SCROLL_BAR_AREA_WIDTH(f)                                    \
 704   (FRAME_HAS_VERTICAL_SCROLL_BARS_ON_RIGHT (f)                          \
 705    ? (FRAME_CONFIG_SCROLL_BAR_COLS (f) * FRAME_COLUMN_WIDTH (f))        \
 706    : 0)
 707
 708 /* Actual width of a scroll bar in frame F, measured in columns.  */
 709
 710 #define FRAME_SCROLL_BAR_COLS(f)                        \
 711      (FRAME_HAS_VERTICAL_SCROLL_BARS (f)                \
 712       ? FRAME_CONFIG_SCROLL_BAR_COLS (f)                \
 713       : 0)
 714
 715 /* Actual width of a scroll bar area in frame F, measured in pixels.  */
 716
 717 #define FRAME_SCROLL_BAR_AREA_WIDTH(f)                                  \
 718   (FRAME_HAS_VERTICAL_SCROLL_BARS (f)                                   \
 719    ? (FRAME_CONFIG_SCROLL_BAR_COLS (f) * FRAME_COLUMN_WIDTH (f))        \
 720    : 0)
 721
 722 /* Total width of frame F, in columns (characters),
 723    including the width used by scroll bars if any.  */
 724
 725 #define FRAME_TOTAL_COLS(f) ((f)->total_cols)
 726
 727 /* Set the width of frame F to VAL.
 728    VAL is the width of a full-frame window,
 729    not including scroll bars and fringes.  */
 730
 731 #define SET_FRAME_COLS(f, val)                                          \
 732      (FRAME_COLS (f) = (val),                                           \
 733       (f)->total_cols = FRAME_TOTAL_COLS_ARG (f, FRAME_COLS (f)))
 734
 735 /* Given a value WIDTH for frame F's nominal width,
 736    return the value that FRAME_TOTAL_COLS should have.  */
 737
 738 #define FRAME_TOTAL_COLS_ARG(f, width)          \
 739      ((width)                                   \
 740       + FRAME_SCROLL_BAR_COLS (f)               \
 741       + FRAME_FRINGE_COLS (f))
 742
 743 /* Maximum + 1 legitimate value for FRAME_CURSOR_X.  */
 744
 745 #define FRAME_CURSOR_X_LIMIT(f) \
 746      (FRAME_COLS (f) + FRAME_LEFT_SCROLL_BAR_COLS (f))
 747
 748 /* Nonzero if frame F has scroll bars.  */
 749
 750 #define FRAME_SCROLL_BARS(f) ((f)->scroll_bars)
 751
 752 #define FRAME_CONDEMNED_SCROLL_BARS(f) ((f)->condemned_scroll_bars)
 753 #define FRAME_MENU_BAR_ITEMS(f) ((f)->menu_bar_items)
 754 #define FRAME_COST_BAUD_RATE(f) ((f)->cost_calculation_baud_rate)
 755
 756 #define FRAME_DESIRED_CURSOR(f) ((f)->desired_cursor)
 757 #define FRAME_BLINK_OFF_CURSOR(f) ((f)->blink_off_cursor)
 758 #define FRAME_CURSOR_WIDTH(f) ((f)->cursor_width)
 759 #define FRAME_BLINK_OFF_CURSOR_WIDTH(f) ((f)->blink_off_cursor_width)
 760
 761 /* Return a pointer to the face cache of frame F.  */
 762
 763 #define FRAME_FACE_CACHE(F)     (F)->face_cache
 764
 765 /* Return the size of message_buf of the frame F.  We multiply the
 766    width of the frame by 4 because multi-byte form may require at most
 767    4-byte for a character.  */
 768
 769 #define FRAME_MESSAGE_BUF_SIZE(f) (((int) FRAME_COLS (f)) * 4)
 770
 771 /* Emacs's redisplay code could become confused if a frame's
 772    visibility changes at arbitrary times.  For example, if a frame is
 773    visible while the desired glyphs are being built, but becomes
 774    invisible before they are updated, then some rows of the
 775    desired_glyphs will be left marked as enabled after redisplay is
 776    complete, which should never happen.  The next time the frame
 777    becomes visible, redisplay will probably barf.
 778
 779    Currently, there are no similar situations involving iconified, but
 780    the principle is the same.
 781
 782    So instead of having asynchronous input handlers directly set and
 783    clear the frame's visibility and iconification flags, they just set
 784    the async_visible and async_iconified flags; the redisplay code
 785    calls the FRAME_SAMPLE_VISIBILITY macro before doing any redisplay,
 786    which sets visible and iconified from their asynchronous
 787    counterparts.
 788
 789    Synchronous code must use the FRAME_SET_VISIBLE macro.
 790
 791    Also, if a frame used to be invisible, but has just become visible,
 792    it must be marked as garbaged, since redisplay hasn't been keeping
 793    up its contents.
 794
 795    Note that a tty frame is visible if and only if it is the topmost
 796    frame. */
 797
 798 #define FRAME_SAMPLE_VISIBILITY(f) \
 799   (((f)->async_visible && (f)->visible != (f)->async_visible) ? \
 800    SET_FRAME_GARBAGED (f) : 0, \
 801    (f)->visible = (f)->async_visible, \
 802    (f)->iconified = (f)->async_iconified)
 803
 804 #define CHECK_FRAME(x) \
 805   CHECK_TYPE (FRAMEP (x), Qframep, x)
 806
 807 #define CHECK_LIVE_FRAME(x) \
 808   CHECK_TYPE (FRAMEP (x) && FRAME_LIVE_P (XFRAME (x)), Qframe_live_p, x)
 809
 810 /* FOR_EACH_FRAME (LIST_VAR, FRAME_VAR) followed by a statement is a
 811    `for' loop which iterates over the elements of Vframe_list.  The
 812    loop will set FRAME_VAR, a Lisp_Object, to each frame in
 813    Vframe_list in succession and execute the statement.  LIST_VAR
 814    should be a Lisp_Object too; it is used to iterate through the
 815    Vframe_list.
 816
 817    This macro is a holdover from a time when multiple frames weren't always
 818    supported.  An alternate definition of the macro would expand to
 819    something which executes the statement once.  */
 820
 821 #define FOR_EACH_FRAME(list_var, frame_var)                     \
 822   for ((list_var) = Vframe_list;                                \
 823        (CONSP (list_var)                                        \
 824         && (frame_var = XCAR (list_var), 1));           \
 825        list_var = XCDR (list_var))
 826
 827
 828 extern Lisp_Object Qframep, Qframe_live_p;
 829 extern Lisp_Object Qtty, Qtty_type;
 830 extern Lisp_Object Qtty_color_mode;
 831 extern Lisp_Object Qterminal, Qterminal_live_p;
 832 extern Lisp_Object Qnoelisp;
 833
 834 extern struct frame *last_nonminibuf_frame;
 835
 836 extern struct frame *make_initial_frame (void);
 837 extern struct frame *make_terminal_frame (struct terminal *);
 838 extern struct frame *make_frame (int);
 839 #ifdef HAVE_WINDOW_SYSTEM
 840 extern struct frame *make_minibuffer_frame (void);
 841 extern struct frame *make_frame_without_minibuffer (Lisp_Object,
 842                                                     struct kboard *,
 843                                                     Lisp_Object);
 844 #endif /* HAVE_WINDOW_SYSTEM */
 845 extern int other_visible_frames (struct frame *);
 846 extern void frame_make_pointer_invisible (void);
 847 extern void frame_make_pointer_visible (void);
 848 extern Lisp_Object delete_frame (Lisp_Object, Lisp_Object);
 849
 850 extern Lisp_Object Vframe_list;
 851 extern Lisp_Object Vdefault_frame_alist;
 852
 853 extern Lisp_Object Vterminal_frame;
 854
 855 extern Lisp_Object Vmouse_highlight;
 856 \f
 857 /* The currently selected frame.  */
 858
 859 extern Lisp_Object selected_frame;
 860
 861 /* Value is a pointer to the selected frame.  If the selected frame
 862    isn't live, abort.  */
 863
 864 #define SELECTED_FRAME()                                \
 865      ((FRAMEP (selected_frame)                          \
 866        && FRAME_LIVE_P (XFRAME (selected_frame)))       \
 867       ? XFRAME (selected_frame)                         \
 868       : (abort (), (struct frame *) 0))
 869
 870 \f
 871 /***********************************************************************
 872                         Display-related Macros
 873  ***********************************************************************/
 874
 875 /* Canonical y-unit on frame F.
 876    This value currently equals the line height of the frame (which is
 877    the height of the default font of F).  */
 878
 879 #define FRAME_LINE_HEIGHT(F) ((F)->line_height)
 880
 881 /* Canonical x-unit on frame F.
 882    This value currently equals the average width of the default font of F.  */
 883
 884 #define FRAME_COLUMN_WIDTH(F) ((F)->column_width)
 885
 886 /* Space glyph width of the default font of frame F.  */
 887
 888 #define FRAME_SPACE_WIDTH(F) ((F)->space_width)
 889
 890
 891 /* Pixel width of areas used to display truncation marks, continuation
 892    marks, overlay arrows.  This is 0 for terminal frames.  */
 893
 894 #ifdef HAVE_WINDOW_SYSTEM
 895
 896 /* Total width of fringes reserved for drawing truncation bitmaps,
 897    continuation bitmaps and alike.  The width is in canonical char
 898    units of the frame.  This must currently be the case because window
 899    sizes aren't pixel values.  If it weren't the case, we wouldn't be
 900    able to split windows horizontally nicely.  */
 901
 902 #define FRAME_FRINGE_COLS(F) ((F)->fringe_cols)
 903
 904 /* Pixel-width of the left and right fringe.  */
 905
 906 #define FRAME_LEFT_FRINGE_WIDTH(F) ((F)->left_fringe_width)
 907 #define FRAME_RIGHT_FRINGE_WIDTH(F) ((F)->right_fringe_width)
 908
 909 /* Total width of fringes in pixels.  */
 910
 911 #define FRAME_TOTAL_FRINGE_WIDTH(F) \
 912   (FRAME_LEFT_FRINGE_WIDTH (F) + FRAME_RIGHT_FRINGE_WIDTH (F))
 913
 914
 915 /* Pixel-width of internal border lines */
 916
 917 #define FRAME_INTERNAL_BORDER_WIDTH(F) ((F)->internal_border_width)
 918
 919 #else /* not HAVE_WINDOW_SYSTEM */
 920
 921 #define FRAME_FRINGE_COLS(F)    0
 922 #define FRAME_TOTAL_FRINGE_WIDTH(F)     0
 923 #define FRAME_LEFT_FRINGE_WIDTH(F)  0
 924 #define FRAME_RIGHT_FRINGE_WIDTH(F) 0
 925 #define FRAME_INTERNAL_BORDER_WIDTH(F) 0
 926
 927 #endif /* not HAVE_WINDOW_SYSTEM */
 928
 929
 930
 931 \f
 932 /***********************************************************************
 933             Conversion between canonical units and pixels
 934  ***********************************************************************/
 935
 936 /* Canonical x-values are fractions of FRAME_COLUMN_WIDTH, canonical
 937    y-unit are fractions of FRAME_LINE_HEIGHT of a frame.  Both are
 938    represented as Lisp numbers, i.e. integers or floats.  */
 939
 940 /* Convert canonical value X to pixels.  F is the frame whose
 941    canonical char width is to be used.  X must be a Lisp integer or
 942    float.  Value is a C integer.  */
 943
 944 #define FRAME_PIXEL_X_FROM_CANON_X(F, X)                \
 945      (INTEGERP (X)                                      \
 946       ? XINT (X) * FRAME_COLUMN_WIDTH (F)               \
 947       : (int) (XFLOAT_DATA (X) * FRAME_COLUMN_WIDTH (F)))
 948
 949 /* Convert canonical value Y to pixels.  F is the frame whose
 950    canonical character height is to be used.  X must be a Lisp integer
 951    or float.  Value is a C integer.  */
 952
 953 #define FRAME_PIXEL_Y_FROM_CANON_Y(F, Y)                \
 954      (INTEGERP (Y)                                      \
 955       ? XINT (Y) * FRAME_LINE_HEIGHT (F)                \
 956       : (int) (XFLOAT_DATA (Y) * FRAME_LINE_HEIGHT (F)))
 957
 958 /* Convert pixel-value X to canonical units.  F is the frame whose
 959    canonical character width is to be used.  X is a C integer.  Result
 960    is a Lisp float if X is not a multiple of the canon width,
 961    otherwise it's a Lisp integer.  */
 962
 963 #define FRAME_CANON_X_FROM_PIXEL_X(F, X)                        \
 964      ((X) % FRAME_COLUMN_WIDTH (F) != 0                         \
 965       ? make_float ((double) (X) / FRAME_COLUMN_WIDTH (F))      \
 966       : make_number ((X) / FRAME_COLUMN_WIDTH (F)))
 967
 968 /* Convert pixel-value Y to canonical units.  F is the frame whose
 969    canonical character height is to be used.  Y is a C integer.
 970    Result is a Lisp float if Y is not a multiple of the canon width,
 971    otherwise it's a Lisp integer.  */
 972
 973 #define FRAME_CANON_Y_FROM_PIXEL_Y(F, Y)                        \
 974      ((Y) % FRAME_LINE_HEIGHT (F)                               \
 975       ? make_float ((double) (Y) / FRAME_LINE_HEIGHT (F))       \
 976       : make_number ((Y) / FRAME_LINE_HEIGHT (F)))
 977
 978
 979 \f
 980 /* Manipulating pixel sizes and character sizes.
 981    Knowledge of which factors affect the overall size of the window should
 982    be hidden in these macros, if that's possible.
 983
 984    Return the upper/left pixel position of the character cell on frame F
 985    at ROW/COL.  */
 986
 987 #define FRAME_LINE_TO_PIXEL_Y(f, row) \
 988   (((row) < FRAME_TOP_MARGIN (f) ? 0 : FRAME_INTERNAL_BORDER_WIDTH (f)) \
 989    + (row) * FRAME_LINE_HEIGHT (f))
 990
 991 #define FRAME_COL_TO_PIXEL_X(f, col) \
 992   (FRAME_INTERNAL_BORDER_WIDTH (f) \
 993    + (col) * FRAME_COLUMN_WIDTH (f))
 994
 995 /* Return the pixel width/height of frame F if it has
 996    COLS columns/LINES rows.  */
 997
 998 #define FRAME_TEXT_COLS_TO_PIXEL_WIDTH(f, cols) \
 999   (FRAME_COL_TO_PIXEL_X (f, cols) \
1000    + (f)->scroll_bar_actual_width \
1001    + FRAME_TOTAL_FRINGE_WIDTH (f)      \
1002    + FRAME_INTERNAL_BORDER_WIDTH (f))
1003
1004 #define FRAME_TEXT_LINES_TO_PIXEL_HEIGHT(f, lines) \
1005   ((lines) * FRAME_LINE_HEIGHT (f) \
1006    + 2 * FRAME_INTERNAL_BORDER_WIDTH (f))
1007
1008
1009 /* Return the row/column (zero-based) of the character cell containing
1010    the pixel on FRAME at Y/X.  */
1011
1012 #define FRAME_PIXEL_Y_TO_LINE(f, y) \
1013   (((y) < FRAME_TOP_MARGIN_HEIGHT (f)   \
1014     ? (y)       \
1015     : ((y) < FRAME_TOP_MARGIN_HEIGHT (f) + FRAME_INTERNAL_BORDER_WIDTH (f) \
1016        ? (y) - (FRAME_TOP_MARGIN_HEIGHT (f) + FRAME_INTERNAL_BORDER_WIDTH (f) \
1017                 /* Arrange for the division to round down.  */  \
1018                 + FRAME_LINE_HEIGHT (f) - 1)    \
1019        : (y) - FRAME_INTERNAL_BORDER_WIDTH (f)))        \
1020    / FRAME_LINE_HEIGHT (f))
1021
1022 #define FRAME_PIXEL_X_TO_COL(f, x) \
1023   (((x) - FRAME_INTERNAL_BORDER_WIDTH (f))      \
1024    / FRAME_COLUMN_WIDTH (f))
1025
1026 /* How many columns/rows of text can we fit in WIDTH/HEIGHT pixels on
1027    frame F?  */
1028
1029 #define FRAME_PIXEL_WIDTH_TO_TEXT_COLS(f, width)                \
1030   (FRAME_PIXEL_X_TO_COL (f, ((width)                            \
1031                              - FRAME_INTERNAL_BORDER_WIDTH (f)  \
1032                              - FRAME_TOTAL_FRINGE_WIDTH (f)     \
1033                              - (f)->scroll_bar_actual_width)))
1034
1035 #define FRAME_PIXEL_HEIGHT_TO_TEXT_LINES(f, height) \
1036   (FRAME_PIXEL_Y_TO_LINE (f, ((height) \
1037                               - FRAME_INTERNAL_BORDER_WIDTH (f))))
1038
1039
1040 /***********************************************************************
1041                                 Frame Parameters
1042  ***********************************************************************/
1043
1044 extern Lisp_Object Qauto_raise, Qauto_lower;
1045 extern Lisp_Object Qborder_color, Qborder_width;
1046 extern Lisp_Object Qbuffer_predicate, Qbuffer_list, Qburied_buffer_list;
1047 extern Lisp_Object Qcursor_color, Qcursor_type;
1048 extern Lisp_Object Qfont;
1049 extern Lisp_Object Qbackground_color, Qforeground_color;
1050 extern Lisp_Object Qicon, Qicon_name, Qicon_type, Qicon_left, Qicon_top;
1051 extern Lisp_Object Qinternal_border_width;
1052 extern Lisp_Object Qtooltip;
1053 extern Lisp_Object Qmenu_bar_lines, Qtool_bar_lines, Qtool_bar_position;
1054 extern Lisp_Object Qmouse_color;
1055 extern Lisp_Object Qname, Qtitle;
1056 extern Lisp_Object Qparent_id;
1057 extern Lisp_Object Qunsplittable, Qvisibility;
1058 extern Lisp_Object Qscroll_bar_width, Qvertical_scroll_bars;
1059 extern Lisp_Object Qscroll_bar_foreground, Qscroll_bar_background;
1060 extern Lisp_Object Qscreen_gamma;
1061 extern Lisp_Object Qline_spacing;
1062 extern Lisp_Object Qwait_for_wm;
1063 extern Lisp_Object Qfullscreen;
1064 extern Lisp_Object Qfullwidth, Qfullheight, Qfullboth, Qmaximized;
1065 extern Lisp_Object Qsticky;
1066 extern Lisp_Object Qfont_backend;
1067 extern Lisp_Object Qalpha;
1068
1069 extern Lisp_Object Qleft_fringe, Qright_fringe;
1070 extern Lisp_Object Qheight, Qwidth;
1071 extern Lisp_Object Qminibuffer, Qmodeline;
1072 extern Lisp_Object Qx, Qw32, Qmac, Qpc, Qns;
1073 extern Lisp_Object Qvisible;
1074 extern Lisp_Object Qdisplay_type;
1075 extern Lisp_Object Qbackground_mode;
1076
1077 extern Lisp_Object Qx_resource_name;
1078
1079 extern Lisp_Object Qleft, Qright, Qtop, Qbox, Qbottom;
1080 extern Lisp_Object Qdisplay;
1081
1082 extern Lisp_Object Qrun_hook_with_args;
1083
1084 #ifdef HAVE_WINDOW_SYSTEM
1085
1086 /* The class of this X application.  */
1087 #define EMACS_CLASS "Emacs"
1088
1089 /* These are in xterm.c, w32term.c, etc.  */
1090
1091 extern void x_set_scroll_bar_default_width (struct frame *);
1092 extern void x_set_offset (struct frame *, int, int, int);
1093 extern void x_wm_set_icon_position (struct frame *, int, int);
1094
1095 extern Lisp_Object x_new_font (struct frame *, Lisp_Object, int);
1096
1097 /* These are in frame.c  */
1098
1099 extern Lisp_Object Vx_resource_name;
1100 extern Lisp_Object Vx_resource_class;
1101 extern Lisp_Object Vmenu_bar_mode, Vtool_bar_mode;
1102
1103
1104 extern Lisp_Object Qface_set_after_frame_default;
1105
1106 extern void x_fullscreen_adjust (struct frame *f, int *, int *,
1107                                  int *, int *);
1108
1109 extern void x_set_frame_parameters (struct frame *, Lisp_Object);
1110 extern void x_report_frame_params (struct frame *, Lisp_Object *);
1111
1112 extern void x_set_fullscreen (struct frame *, Lisp_Object, Lisp_Object);
1113 extern void x_set_line_spacing (struct frame *, Lisp_Object, Lisp_Object);
1114 extern void x_set_screen_gamma (struct frame *, Lisp_Object, Lisp_Object);
1115 extern void x_set_font (struct frame *, Lisp_Object, Lisp_Object);
1116 extern void x_set_font_backend (struct frame *, Lisp_Object, Lisp_Object);
1117 extern void x_set_fringe_width (struct frame *, Lisp_Object, Lisp_Object);
1118 extern void x_set_border_width (struct frame *, Lisp_Object, Lisp_Object);
1119 extern void x_set_internal_border_width (struct frame *, Lisp_Object,
1120                                          Lisp_Object);
1121 extern void x_set_visibility (struct frame *, Lisp_Object, Lisp_Object);
1122 extern void x_set_autoraise (struct frame *, Lisp_Object, Lisp_Object);
1123 extern void x_set_autolower (struct frame *, Lisp_Object, Lisp_Object);
1124 extern void x_set_unsplittable (struct frame *, Lisp_Object, Lisp_Object);
1125 extern void x_set_vertical_scroll_bars (struct frame *, Lisp_Object,
1126                                         Lisp_Object);
1127 extern void x_set_scroll_bar_width (struct frame *, Lisp_Object,
1128                                     Lisp_Object);
1129
1130 extern Lisp_Object x_icon_type (struct frame *);
1131
1132 extern int x_figure_window_size (struct frame *, Lisp_Object, int);
1133
1134 extern Lisp_Object Vframe_alpha_lower_limit;
1135 extern void x_set_alpha (struct frame *, Lisp_Object, Lisp_Object);
1136
1137 extern void validate_x_resource_name (void);
1138
1139 extern Lisp_Object display_x_get_resource (Display_Info *,
1140                                            Lisp_Object attribute,
1141                                            Lisp_Object class,
1142                                            Lisp_Object component,
1143                                            Lisp_Object subclass);
1144
1145 /* In xmenu.c */
1146 extern void set_frame_menubar (FRAME_PTR, int, int);
1147
1148 #endif /* HAVE_WINDOW_SYSTEM */
1149
1150 #endif /* not EMACS_FRAME_H */
1151
1152 /* arch-tag: 0df048ee-e6bf-4f48-bd56-e3cd055dd8c4
1153    (do not change this comment) */