xterm.c 160 KB
Newer Older
Jim Blandy's avatar
Jim Blandy committed
1
/* X Communication module for terminals which understand the X protocol.
2
   Copyright (C) 1989, 1993, 1994 Free Software Foundation, Inc.
Jim Blandy's avatar
Jim Blandy committed
3 4 5 6 7

This file is part of GNU Emacs.

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

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
along with GNU Emacs; see the file COPYING.  If not, write to
the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.  */

20 21
/* Xt features made by Fred Pierresteguy.  */

22 23 24 25 26
/* On 4.3 these lose if they come after xterm.h.  */
/* On HP-UX 8.0 signal.h loses if it comes after config.h.  */
/* Putting these at the beginning seems to be standard for other .c files.  */
#include <signal.h>

27
#include <config.h>
Jim Blandy's avatar
Jim Blandy committed
28

29 30
#include <stdio.h>

31
/* Need syssignal.h for various externs and definitions that may be required
32
   by some configurations for calls to signal later in this source file.  */
33 34
#include "syssignal.h"

Jim Blandy's avatar
Jim Blandy committed
35 36 37
#ifdef HAVE_X_WINDOWS

#include "lisp.h"
38
#include "blockinput.h"
Jim Blandy's avatar
Jim Blandy committed
39 40 41 42

/* This may include sys/types.h, and that somehow loses
   if this is not done before the other system files.  */
#include "xterm.h"
43
#include <X11/cursorfont.h>
Jim Blandy's avatar
Jim Blandy committed
44

45
#ifndef USG
Jim Blandy's avatar
Jim Blandy committed
46 47 48 49
/* Load sys/types.h if not already loaded.
   In some systems loading it twice is suicidal.  */
#ifndef makedev
#include <sys/types.h>
50 51
#endif /* makedev */
#endif /* USG */
Jim Blandy's avatar
Jim Blandy committed
52 53 54

#ifdef BSD
#include <sys/ioctl.h>
55
#endif /* ! defined (BSD) */
Jim Blandy's avatar
Jim Blandy committed
56

57
#include "systty.h"
Jim Blandy's avatar
Jim Blandy committed
58
#include "systime.h"
Jim Blandy's avatar
Jim Blandy committed
59

60
#ifndef INCLUDED_FCNTL
Jim Blandy's avatar
Jim Blandy committed
61
#include <fcntl.h>
62
#endif
Jim Blandy's avatar
Jim Blandy committed
63 64 65 66 67 68
#include <ctype.h>
#include <errno.h>
#include <setjmp.h>
#include <sys/stat.h>
#include <sys/param.h>

69
#include "frame.h"
Jim Blandy's avatar
Jim Blandy committed
70 71 72 73 74 75 76
#include "dispextern.h"
#include "termhooks.h"
#include "termopts.h"
#include "termchar.h"
#if 0
#include "sink.h"
#include "sinkmask.h"
77
#endif /* ! 0 */
Jim Blandy's avatar
Jim Blandy committed
78 79 80
#include "gnu.h"
#include "disptab.h"
#include "buffer.h"
81
#include "window.h"
Richard M. Stallman's avatar
Richard M. Stallman committed
82
#include "keyboard.h"
Karl Heuer's avatar
Karl Heuer committed
83
#include "intervals.h"
Jim Blandy's avatar
Jim Blandy committed
84

85
#ifdef USE_X_TOOLKIT
86
extern void free_frame_menubar ();
87
extern void _XEditResCheckMessages ();
88 89
#endif /* USE_X_TOOLKIT */

90 91
#ifndef USE_X_TOOLKIT
#define x_any_window_to_frame x_window_to_frame
92
#define x_top_window_to_frame x_window_to_frame
93 94
#endif

95 96 97 98 99 100
#ifdef USE_X_TOOLKIT
#ifndef XtNinitialState
#define XtNinitialState "initialState"
#endif
#endif

Jim Blandy's avatar
Jim Blandy committed
101 102
#define min(a,b) ((a)<(b) ? (a) : (b))
#define max(a,b) ((a)>(b) ? (a) : (b))
103

104 105
/* This is a chain of structures for all the X displays currently in use.  */
struct x_display_info *x_display_list;
Jim Blandy's avatar
Jim Blandy committed
106

107 108 109 110 111
/* This is a list of cons cells, each of the form (NAME . FONT-LIST-CACHE),
   one for each element of x_display_list and in the same order.
   NAME is the name of the frame.
   FONT-LIST-CACHE records previous values returned by x-list-fonts.  */
Lisp_Object x_display_name_list;
112

113
/* Frame being updated by update_frame.  This is declared in term.c.
114
   This is set by update_begin and looked at by all the
Jim Blandy's avatar
Jim Blandy committed
115
   XT functions.  It is zero while not inside an update.
Jim Blandy's avatar
Jim Blandy committed
116 117
   In that case, the XT functions assume that `selected_frame'
   is the frame to apply to.  */
118
extern struct frame *updating_frame;
Jim Blandy's avatar
Jim Blandy committed
119

Jim Blandy's avatar
Jim Blandy committed
120
/* The frame (if any) which has the X window that has keyboard focus.
121 122 123 124
   Zero if none.  This is examined by Ffocus_frame in frame.c.  Note
   that a mere EnterNotify event can set this; if you need to know the
   last frame specified in a FocusIn or FocusOut event, use
   x_focus_event_frame.  */
Jim Blandy's avatar
Jim Blandy committed
125
struct frame *x_focus_frame;
Jim Blandy's avatar
Jim Blandy committed
126

127 128 129
/* This is a frame waiting to be autoraised, within XTread_socket.  */
struct frame *pending_autoraise_frame;

130 131 132 133 134 135
/* The last frame mentioned in a FocusIn or FocusOut event.  This is
   separate from x_focus_frame, because whether or not LeaveNotify
   events cause us to lose focus depends on whether or not we have
   received a FocusIn event for it.  */
struct frame *x_focus_event_frame;

Jim Blandy's avatar
Jim Blandy committed
136 137 138 139
/* The frame which currently has the visual highlight, and should get
   keyboard input (other sorts of input have the frame encoded in the
   event).  It points to the X focus frame's selected window's
   frame.  It differs from x_focus_frame when we're using a global
Jim Blandy's avatar
Jim Blandy committed
140
   minibuffer.  */
Jim Blandy's avatar
Jim Blandy committed
141
static struct frame *x_highlight_frame;
Jim Blandy's avatar
Jim Blandy committed
142

143 144 145 146 147
#ifdef USE_X_TOOLKIT
/* The application context for Xt use.  */
XtAppContext Xt_app_con;
#endif

Jim Blandy's avatar
Jim Blandy committed
148 149 150 151 152 153 154 155 156 157 158 159 160 161
/* During an update, maximum vpos for ins/del line operations to affect.  */

static int flexlines;

/* During an update, nonzero if chars output now should be highlighted.  */

static int highlight;

/* Nominal cursor position -- where to draw output.
   During an update, these are different from the cursor-box position.  */

static int curs_x;
static int curs_y;

162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202
/* Mouse movement.

   In order to avoid asking for motion events and then throwing most
   of them away or busy-polling the server for mouse positions, we ask
   the server for pointer motion hints.  This means that we get only
   one event per group of mouse movements.  "Groups" are delimited by
   other kinds of events (focus changes and button clicks, for
   example), or by XQueryPointer calls; when one of these happens, we
   get another MotionNotify event the next time the mouse moves.  This
   is at least as efficient as getting motion events when mouse
   tracking is on, and I suspect only negligibly worse when tracking
   is off.

   The silly O'Reilly & Associates Nutshell guides barely document
   pointer motion hints at all (I think you have to infer how they
   work from an example), and the description of XQueryPointer doesn't
   mention that calling it causes you to get another motion hint from
   the server, which is very important.  */

/* Where the mouse was last time we reported a mouse event.  */
static FRAME_PTR last_mouse_frame;
static XRectangle last_mouse_glyph;

/* The scroll bar in which the last X motion event occurred.

   If the last X motion event occurred in a scroll bar, we set this
   so XTmouse_position can know whether to report a scroll bar motion or
   an ordinary motion.

   If the last X motion event didn't occur in a scroll bar, we set this
   to Qnil, to tell XTmouse_position to return an ordinary motion event.  */
static Lisp_Object last_mouse_scroll_bar;

/* This is a hack.  We would really prefer that XTmouse_position would
   return the time associated with the position it returns, but there
   doesn't seem to be any way to wrest the timestamp from the server
   along with the position query.  So, we just keep track of the time
   of the last movement we received, and return that in hopes that
   it's somewhat accurate.  */
static Time last_mouse_movement_time;

203 204 205 206 207 208 209
/* Incremented by XTread_socket whenever it really tries to read events.  */
#ifdef __STDC__
static int volatile input_signal_count;
#else
static int input_signal_count;
#endif

210 211
/* Used locally within XTread_socket.  */
static int x_noop_count;
Jim Blandy's avatar
Jim Blandy committed
212

213 214 215
/* Initial values of argv and argc.  */
extern char **initial_argv;
extern int initial_argc;
Jim Blandy's avatar
Jim Blandy committed
216

217
extern Lisp_Object Vcommand_line_args, Vsystem_name;
Jim Blandy's avatar
Jim Blandy committed
218

219 220 221
/* Tells if a window manager is present or not. */

extern Lisp_Object Vx_no_window_manager;
Jim Blandy's avatar
Jim Blandy committed
222 223 224 225

/* Nonzero enables some debugging for the X interface code. */
extern int _Xdebug;

226
extern Lisp_Object Qface, Qmouse_face;
227

Jim Blandy's avatar
Jim Blandy committed
228 229
extern int errno;

230
/* A mask of extra modifier bits to put into every keyboard char.  */
231 232
extern int extra_keyboard_modifiers;

233
extern XrmDatabase x_load_resources ();
Jim Blandy's avatar
Jim Blandy committed
234

235 236
void x_delete_display ();

Jim Blandy's avatar
Jim Blandy committed
237
static void flashback ();
238
static void redraw_previous_char ();
239
static void redraw_following_char ();
240
static unsigned int x_x_to_emacs_modifiers ();
Jim Blandy's avatar
Jim Blandy committed
241

242
static int fast_find_position ();
243 244 245
static void note_mouse_highlight ();
static void clear_mouse_face ();
static void show_mouse_face ();
246
static void do_line_dance ();
247

Jim Blandy's avatar
Jim Blandy committed
248 249
static int XTcursor_to ();
static int XTclear_end_of_line ();
250
static int x_io_error_quitter ();
251 252 253 254 255 256 257 258 259 260 261 262

/* Return the struct x_display_info corresponding to DPY.  */

struct x_display_info *
x_display_info_for_display (dpy)
     Display *dpy;
{
  struct x_display_info *dpyinfo;

  for (dpyinfo = x_display_list; dpyinfo; dpyinfo = dpyinfo->next)
    if (dpyinfo->display == dpy)
      return dpyinfo;
263

264 265
  return 0;
}
Jim Blandy's avatar
Jim Blandy committed
266

267
/* Starting and ending updates.
268 269

   These hooks are called by update_frame at the beginning and end
Jim Blandy's avatar
Jim Blandy committed
270 271 272
   of a frame update.  We record in `updating_frame' the identity
   of the frame being updated, so that the XT... functions do not
   need to take a frame as argument.  Most of the XT... functions
Jim Blandy's avatar
Jim Blandy committed
273
   should never be called except during an update, the only exceptions
274
   being XTcursor_to, XTwrite_glyphs and XTreassert_line_highlight.  */
Jim Blandy's avatar
Jim Blandy committed
275 276

static
Jim Blandy's avatar
Jim Blandy committed
277 278
XTupdate_begin (f)
     struct frame *f;
279
{
Jim Blandy's avatar
Jim Blandy committed
280 281
  int mask;

Jim Blandy's avatar
Jim Blandy committed
282
  if (f == 0)
Jim Blandy's avatar
Jim Blandy committed
283 284
    abort ();

Jim Blandy's avatar
Jim Blandy committed
285
  flexlines = f->height;
Jim Blandy's avatar
Jim Blandy committed
286 287 288
  highlight = 0;

  BLOCK_INPUT;
289

290
  if (f == FRAME_X_DISPLAY_INFO (f)->mouse_face_mouse_frame)
291
    {
292
      /* Don't do highlighting for mouse motion during the update.  */
293 294
      FRAME_X_DISPLAY_INFO (f)->mouse_face_defer = 1;
      if (!NILP (FRAME_X_DISPLAY_INFO (f)->mouse_face_window))
295 296
	{
	  int firstline, lastline, i;
297
	  struct window *w = XWINDOW (FRAME_X_DISPLAY_INFO (f)->mouse_face_window);
298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317

	  /* Find the first, and the last+1, lines affected by redisplay.  */
	  for (firstline = 0; firstline < f->height; firstline++)
	    if (FRAME_DESIRED_GLYPHS (f)->enable[firstline])
	      break;

	  lastline = f->height;
	  for (i = f->height - 1; i >= 0; i--)
	    {
	      if (FRAME_DESIRED_GLYPHS (f)->enable[i])
		break;
	      else
		lastline = i;
	    }

	  /* Can we tell that this update does not affect the window
	     where the mouse highlight is?  If so, no need to turn off.  */
	  if (! (firstline > (XFASTINT (w->top) + window_internal_height (w))
		 || lastline < XFASTINT (w->top)))
	    /* Otherwise turn off the mouse highlight now.  */
318
	    clear_mouse_face (FRAME_X_DISPLAY_INFO (f));
319
	}
320
    }
Richard M. Stallman's avatar
Richard M. Stallman committed
321

Jim Blandy's avatar
Jim Blandy committed
322 323 324 325
  UNBLOCK_INPUT;
}

static
Jim Blandy's avatar
Jim Blandy committed
326 327
XTupdate_end (f)
     struct frame *f;
328
{
Jim Blandy's avatar
Jim Blandy committed
329 330 331 332
  int mask;

  BLOCK_INPUT;

333
  do_line_dance ();
Jim Blandy's avatar
Jim Blandy committed
334
  x_display_cursor (f, 1);
Jim Blandy's avatar
Jim Blandy committed
335

336 337
  if (f == FRAME_X_DISPLAY_INFO (f)->mouse_face_mouse_frame)
    FRAME_X_DISPLAY_INFO (f)->mouse_face_defer = 0;
338 339 340 341 342 343 344
#if 0
  /* This fails in the case of having updated only the echo area
     if we have switched buffers.  In that case, FRAME_CURRENT_GLYPHS
     has no relation to the current contents, and its charstarts
     have no relation to the contents of the window-buffer.
  I don't know a clean way to check
     for that case.  window_end_valid isn't set up yet.  */
345 346 347
  if (f == FRAME_X_DISPLAY_INFO (f)->mouse_face_mouse_frame)
    note_mouse_highlight (f, FRAME_X_DISPLAY_INFO (f)->mouse_face_mouse_x,
			  FRAME_X_DISPLAY_INFO (f)->mouse_face_mouse_y);
348 349
#endif

350
  XFlush (FRAME_X_DISPLAY (f));
Jim Blandy's avatar
Jim Blandy committed
351 352
  UNBLOCK_INPUT;
}
353

354
/* This is called after a redisplay on frame F.  */
355 356 357 358 359

static
XTframe_up_to_date (f)
     FRAME_PTR f;
{
360 361
  if (FRAME_X_DISPLAY_INFO (f)->mouse_face_deferred_gc
      || f == FRAME_X_DISPLAY_INFO (f)->mouse_face_mouse_frame)
362
    {
363 364 365 366
      note_mouse_highlight (FRAME_X_DISPLAY_INFO (f)->mouse_face_mouse_frame,
			    FRAME_X_DISPLAY_INFO (f)->mouse_face_mouse_x,
			    FRAME_X_DISPLAY_INFO (f)->mouse_face_mouse_y);
      FRAME_X_DISPLAY_INFO (f)->mouse_face_deferred_gc = 0;
367
    }
368
}
Jim Blandy's avatar
Jim Blandy committed
369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388

/* External interface to control of standout mode.
   Call this when about to modify line at position VPOS
   and not change whether it is highlighted.  */

XTreassert_line_highlight (new, vpos)
     int new, vpos;
{
  highlight = new;
}

/* Call this when about to modify line at position VPOS
   and change whether it is highlighted.  */

static
XTchange_line_highlight (new_highlight, vpos, first_unused_hpos)
     int new_highlight, vpos, first_unused_hpos;
{
  highlight = new_highlight;
  XTcursor_to (vpos, 0);
Jim Blandy's avatar
Jim Blandy committed
389
  XTclear_end_of_line (updating_frame->width);
Jim Blandy's avatar
Jim Blandy committed
390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407
}

/* This is used when starting Emacs and when restarting after suspend.
   When starting Emacs, no X window is mapped.  And nothing must be done
   to Emacs's own window if it is suspended (though that rarely happens).  */

static
XTset_terminal_modes ()
{
}

/* This is called when exiting or suspending Emacs.
   Exiting will make the X-windows go away, and suspending
   requires no action.  */

static
XTreset_terminal_modes ()
{
Jim Blandy's avatar
Jim Blandy committed
408
/*  XTclear_frame ();  */
Jim Blandy's avatar
Jim Blandy committed
409 410
}

411 412
/* Set the nominal cursor position of the frame.
   This is where display update commands will take effect.
Jim Blandy's avatar
Jim Blandy committed
413 414
   This does not affect the place where the cursor-box is displayed.  */

Jim Blandy's avatar
Jim Blandy committed
415
static int
Jim Blandy's avatar
Jim Blandy committed
416 417 418 419 420 421 422 423 424
XTcursor_to (row, col)
     register int row, col;
{
  int mask;
  int orow = row;

  curs_x = col;
  curs_y = row;

Jim Blandy's avatar
Jim Blandy committed
425
  if (updating_frame == 0)
Jim Blandy's avatar
Jim Blandy committed
426 427
    {
      BLOCK_INPUT;
Jim Blandy's avatar
Jim Blandy committed
428
      x_display_cursor (selected_frame, 1);
429
      XFlush (FRAME_X_DISPLAY (selected_frame));
Jim Blandy's avatar
Jim Blandy committed
430 431 432 433 434 435
      UNBLOCK_INPUT;
    }
}

/* Display a sequence of N glyphs found at GP.
   WINDOW is the x-window to output to.  LEFT and TOP are starting coords.
436 437
   HL is 1 if this text is highlighted, 2 if the cursor is on it,
   3 if should appear in its mouse-face.
438 439
   JUST_FOREGROUND if 1 means draw only the foreground;
   don't alter the background.
Jim Blandy's avatar
Jim Blandy committed
440

441
   FONT is the default font to use (for glyphs whose font-code is 0).
Jim Blandy's avatar
Jim Blandy committed
442

443 444 445
   Since the display generation code is responsible for calling
   compute_char_face and compute_glyph_face on everything it puts in
   the display structure, we can assume that the face code on each
446
   glyph is a valid index into FRAME_COMPUTED_FACES (f), and the one
447 448
   to which we can actually apply intern_face.
   Call this function with input blocked.  */
Jim Blandy's avatar
Jim Blandy committed
449

450 451
#if 1
/* This is the multi-face code.  */
Jim Blandy's avatar
Jim Blandy committed
452 453

static void
454
dumpglyphs (f, left, top, gp, n, hl, just_foreground)
Jim Blandy's avatar
Jim Blandy committed
455
     struct frame *f;
Jim Blandy's avatar
Jim Blandy committed
456 457 458 459
     int left, top;
     register GLYPH *gp; /* Points to first GLYPH. */
     register int n;  /* Number of glyphs to display. */
     int hl;
460
     int just_foreground;
Jim Blandy's avatar
Jim Blandy committed
461
{
462 463
  /* Holds characters to be displayed. */
  char *buf = (char *) alloca (f->width * sizeof (*buf));
Jim Blandy's avatar
Jim Blandy committed
464 465 466
  register char *cp;		/* Steps through buf[]. */
  register int tlen = GLYPH_TABLE_LENGTH;
  register Lisp_Object *tbase = GLYPH_TABLE_BASE;
467
  Window window = FRAME_X_WINDOW (f);
468
  int orig_left = left;
Jim Blandy's avatar
Jim Blandy committed
469

470
  while (n > 0)
Jim Blandy's avatar
Jim Blandy committed
471 472 473 474 475
    {
      /* Get the face-code of the next GLYPH.  */
      int cf, len;
      int g = *gp;

476
      GLYPH_FOLLOW_ALIASES (tbase, tlen, g);
477
      cf = FAST_GLYPH_FACE (g);
Jim Blandy's avatar
Jim Blandy committed
478 479 480 481 482 483 484

      /* Find the run of consecutive glyphs with the same face-code.
	 Extract their character codes into BUF.  */
      cp = buf;
      while (n > 0)
	{
	  g = *gp;
485
	  GLYPH_FOLLOW_ALIASES (tbase, tlen, g);
486
	  if (FAST_GLYPH_FACE (g) != cf)
Jim Blandy's avatar
Jim Blandy committed
487 488
	    break;

489
	  *cp++ = FAST_GLYPH_CHAR (g);
Jim Blandy's avatar
Jim Blandy committed
490 491 492 493 494 495 496 497 498
	  --n;
	  ++gp;
	}

      /* LEN gets the length of the run.  */
      len = cp - buf;

      /* Now output this run of chars, with the font and pixel values
	 determined by the face code CF.  */
499 500
      {
	struct face *face = FRAME_DEFAULT_FACE (f);
501
	XFontStruct *font = FACE_FONT (face);
502
	GC gc = FACE_GC (face);
503
	int stippled = 0;
504

505 506
	/* HL = 3 means use a mouse face previously chosen.  */
	if (hl == 3)
507
	  cf = FRAME_X_DISPLAY_INFO (f)->mouse_face_face_id;
508

509 510
	/* First look at the face of the text itself.  */
	if (cf != 0)
511
	  {
512 513
	    /* It's possible for the display table to specify
	       a face code that is out of range.  Use 0 in that case.  */
514 515
	    if (cf < 0 || cf >= FRAME_N_COMPUTED_FACES (f)
		|| FRAME_COMPUTED_FACES (f) [cf] == 0)
516
	      cf = 0;
517 518 519 520

	    if (cf == 1)
	      face = FRAME_MODE_LINE_FACE (f);
	    else
521
	      face = intern_face (f, FRAME_COMPUTED_FACES (f) [cf]);
522 523
	    font = FACE_FONT (face);
	    gc = FACE_GC (face);
524 525
	    if (FACE_STIPPLE (face))
	      stippled = 1;
526
	  }
527 528

	/* Then comes the distinction between modeline and normal text.  */
529 530 531 532 533 534 535
	else if (hl == 0)
	  ;
	else if (hl == 1)
	  {
	    face = FRAME_MODE_LINE_FACE (f);
	    font = FACE_FONT (face);
	    gc   = FACE_GC   (face);
536 537
	    if (FACE_STIPPLE (face))
	      stippled = 1;
538 539 540 541 542
	  }

#define FACE_DEFAULT (~0)

	/* Now override that if the cursor's on this character.  */
543
	if (hl == 2)
544
	  {
545 546 547
	    /* The cursor overrides stippling.  */
	    stippled = 0;

548 549 550 551 552
	    if ((!face->font
		 || (int) face->font == FACE_DEFAULT
		 || face->font == f->display.x->font)
		&& face->background == f->display.x->background_pixel
		&& face->foreground == f->display.x->foreground_pixel)
553 554 555 556 557 558 559 560 561 562
	      {
		gc = f->display.x->cursor_gc;
	      }
	    /* Cursor on non-default face: must merge.  */
	    else
	      {
		XGCValues xgcv;
		unsigned long mask;

		xgcv.background = f->display.x->cursor_pixel;
563
		xgcv.foreground = face->background;
564 565 566
		/* If the glyph would be invisible,
		   try a different foreground.  */
		if (xgcv.foreground == xgcv.background)
567
		  xgcv.foreground = face->foreground;
568 569 570 571 572 573 574 575 576 577 578
		if (xgcv.foreground == xgcv.background)
		  xgcv.foreground = f->display.x->cursor_foreground_pixel;
		if (xgcv.foreground == xgcv.background)
		  xgcv.foreground = face->foreground;
		/* Make sure the cursor is distinct from text in this face.  */
		if (xgcv.background == face->background
		    && xgcv.foreground == face->foreground)
		  {
		    xgcv.background = face->foreground;
		    xgcv.foreground = face->background;
		  }
579 580 581
		xgcv.font = face->font->fid;
		xgcv.graphics_exposures = 0;
		mask = GCForeground | GCBackground | GCFont | GCGraphicsExposures;
582 583 584 585
		if (FRAME_X_DISPLAY_INFO (f)->scratch_cursor_gc)
		  XChangeGC (FRAME_X_DISPLAY (f),
			     FRAME_X_DISPLAY_INFO (f)->scratch_cursor_gc,
			     mask, &xgcv);
586
		else
587
		  FRAME_X_DISPLAY_INFO (f)->scratch_cursor_gc
588
		    = XCreateGC (FRAME_X_DISPLAY (f), window, mask, &xgcv);
589
		gc = FRAME_X_DISPLAY_INFO (f)->scratch_cursor_gc;
590
#if 0
591 592
/* If this code is restored, it must also reset to the default stipple
   if necessary. */
593
		if (face->stipple && face->stipple != FACE_DEFAULT)
594
		  XSetStipple (FRAME_X_DISPLAY (f), gc, face->stipple);
595
#endif
596
	      }
597 598
	  }

599 600 601
	if ((int) font == FACE_DEFAULT)
	  font = f->display.x->font;

602
	if (just_foreground)
603
	  XDrawString (FRAME_X_DISPLAY (f), window, gc,
604 605 606
		       left, top + FONT_BASE (font), buf, len);
	else
	  {
607 608 609 610 611 612
	    if (stippled)
	      {
		/* Turn stipple on.  */
		XSetFillStyle (FRAME_X_DISPLAY (f), gc, FillOpaqueStippled);

		/* Draw stipple on background.  */
613
		XFillRectangle (FRAME_X_DISPLAY (f), window, gc,
614 615 616 617 618 619 620 621
				left, top,
				FONT_WIDTH (font) * len,
				FONT_HEIGHT (font));

		/* Turn stipple off.  */
		XSetFillStyle (FRAME_X_DISPLAY (f), gc, FillSolid);

		/* Draw the text, solidly, onto the stipple pattern.  */
622
		XDrawString (FRAME_X_DISPLAY (f), window, gc,
623 624 625
			     left, top + FONT_BASE (font), buf, len);
	      }
	    else
626
	      XDrawImageString (FRAME_X_DISPLAY (f), window, gc,
627 628
				left, top + FONT_BASE (font), buf, len);

629 630
	    /* Clear the rest of the line's height.  */
	    if (f->display.x->line_height != FONT_HEIGHT (font))
631
	      XClearArea (FRAME_X_DISPLAY (f), window, left,
632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651
			  top + FONT_HEIGHT (font),
			  FONT_WIDTH (font) * len,
			  /* This is how many pixels of height
			     we have to clear.  */
			  f->display.x->line_height - FONT_HEIGHT (font),
			  False);
	  }

#if 0 /* Doesn't work, because it uses FRAME_CURRENT_GLYPHS,
	 which often is not up to date yet.  */
	if (!just_foreground)
	  {
	    if (left == orig_left)
	      redraw_previous_char (f, PIXEL_TO_CHAR_COL (f, left),
				    PIXEL_TO_CHAR_ROW (f, top), hl == 1);
	    if (n == 0)
	      redraw_following_char (f, PIXEL_TO_CHAR_COL (f, left + len * FONT_WIDTH (font)),
				     PIXEL_TO_CHAR_ROW (f, top), hl == 1);
	  }
#endif
652 653 654 655

	/* We should probably check for XA_UNDERLINE_POSITION and
	   XA_UNDERLINE_THICKNESS properties on the font, but let's
	   just get the thing working, and come back to that.  */
Jim Blandy's avatar
Jim Blandy committed
656
	{
657
	  int underline_position = 1;
658

659 660
	  if (font->descent <= underline_position)
	    underline_position = font->descent - 1;
661 662

	  if (face->underline)
663
	    XFillRectangle (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
664 665 666 667 668
			    FACE_GC (face),
			    left, (top
				   + FONT_BASE (font)
				   + underline_position),
			    len * FONT_WIDTH (font), 1);
Jim Blandy's avatar
Jim Blandy committed
669
	}
670 671 672

	left += len * FONT_WIDTH (font);
      }
Jim Blandy's avatar
Jim Blandy committed
673 674
    }
}
675 676 677 678 679 680 681 682 683 684 685 686
#endif /* 1 */

#if 0
/* This is the old single-face code.  */

static void
dumpglyphs (f, left, top, gp, n, hl, font)
     struct frame *f;
     int left, top;
     register GLYPH *gp; /* Points to first GLYPH. */
     register int n;  /* Number of glyphs to display. */
     int hl;
687
     XFontStruct *font;
688 689 690 691 692 693 694 695
{
  register int len;
  Window window = FRAME_X_WINDOW (f);
  GC drawing_gc =   (hl == 2 ? f->display.x->cursor_gc
		             : (hl ? f->display.x->reverse_gc
				   : f->display.x->normal_gc));

  if (sizeof (GLYPH) == sizeof (XChar2b))
696
    XDrawImageString16 (FRAME_X_DISPLAY (f), window, drawing_gc,
697 698
			left, top + FONT_BASE (font), (XChar2b *) gp, n);
  else if (sizeof (GLYPH) == sizeof (unsigned char))
699
    XDrawImageString (FRAME_X_DISPLAY (f), window, drawing_gc,
700 701 702 703 704 705 706
		      left, top + FONT_BASE (font), (char *) gp, n);
  else
    /* What size of glyph ARE you using?  And does X have a function to
       draw them?  */
    abort ();
}
#endif
Jim Blandy's avatar
Jim Blandy committed
707

708 709
/* Output some text at the nominal frame cursor position.
   Advance the cursor over the text.
Jim Blandy's avatar
Jim Blandy committed
710 711 712 713 714 715 716 717 718 719 720 721
   Output LEN glyphs at START.

   `highlight', set up by XTreassert_line_highlight or XTchange_line_highlight,
   controls the pixel values used for foreground and background.  */

static
XTwrite_glyphs (start, len)
     register GLYPH *start;
     int len;
{
  register int temp_length;
  int mask;
Jim Blandy's avatar
Jim Blandy committed
722
  struct frame *f;
Jim Blandy's avatar
Jim Blandy committed
723 724 725

  BLOCK_INPUT;

726
  do_line_dance ();
Jim Blandy's avatar
Jim Blandy committed
727 728
  f = updating_frame;
  if (f == 0)
Jim Blandy's avatar
Jim Blandy committed
729
    {
Jim Blandy's avatar
Jim Blandy committed
730
      f = selected_frame;
Jim Blandy's avatar
Jim Blandy committed
731
      /* If not within an update,
Jim Blandy's avatar
Jim Blandy committed
732 733 734
	 output at the frame's visible cursor.  */
      curs_x = f->cursor_x;
      curs_y = f->cursor_y;
Jim Blandy's avatar
Jim Blandy committed
735 736
    }

Jim Blandy's avatar
Jim Blandy committed
737
  dumpglyphs (f,
738 739
	      CHAR_TO_PIXEL_COL (f, curs_x),
	      CHAR_TO_PIXEL_ROW (f, curs_y),
740
	      start, len, highlight, 0);
Jim Blandy's avatar
Jim Blandy committed
741 742

  /* If we drew on top of the cursor, note that it is turned off.  */
Jim Blandy's avatar
Jim Blandy committed
743 744 745 746
  if (curs_y == f->phys_cursor_y
      && curs_x <= f->phys_cursor_x
      && curs_x + len > f->phys_cursor_x)
    f->phys_cursor_x = -1;
747

Jim Blandy's avatar
Jim Blandy committed
748
  if (updating_frame == 0)
Jim Blandy's avatar
Jim Blandy committed
749
    {
Jim Blandy's avatar
Jim Blandy committed
750 751 752
      f->cursor_x += len;
      x_display_cursor (f, 1);
      f->cursor_x -= len;
Jim Blandy's avatar
Jim Blandy committed
753 754 755 756 757 758 759
    }
  else
    curs_x += len;

  UNBLOCK_INPUT;
}

760 761
/* Clear to the end of the line.
   Erase the current text line from the nominal cursor position (inclusive)
Jim Blandy's avatar
Jim Blandy committed
762 763
   to column FIRST_UNUSED (exclusive).  The idea is that everything
   from FIRST_UNUSED onward is already erased.  */
764

Jim Blandy's avatar
Jim Blandy committed
765
static int
Jim Blandy's avatar
Jim Blandy committed
766 767 768
XTclear_end_of_line (first_unused)
     register int first_unused;
{
Jim Blandy's avatar
Jim Blandy committed
769
  struct frame *f = updating_frame;
Jim Blandy's avatar
Jim Blandy committed
770 771
  int mask;

Jim Blandy's avatar
Jim Blandy committed
772
  if (f == 0)
Jim Blandy's avatar
Jim Blandy committed
773 774
    abort ();

Jim Blandy's avatar
Jim Blandy committed
775
  if (curs_y < 0 || curs_y >= f->height)
Jim Blandy's avatar
Jim Blandy committed
776 777 778 779
    return;
  if (first_unused <= 0)
    return;

Jim Blandy's avatar
Jim Blandy committed
780 781
  if (first_unused >= f->width)
    first_unused = f->width;
Jim Blandy's avatar
Jim Blandy committed
782 783 784

  BLOCK_INPUT;

Jim Blandy's avatar
Jim Blandy committed
785
  /* Notice if the cursor will be cleared by this operation.  */
Jim Blandy's avatar
Jim Blandy committed
786 787 788 789
  if (curs_y == f->phys_cursor_y
      && curs_x <= f->phys_cursor_x
      && f->phys_cursor_x < first_unused)
    f->phys_cursor_x = -1;
Jim Blandy's avatar
Jim Blandy committed
790

791
  XClearArea (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
792 793
	      CHAR_TO_PIXEL_COL (f, curs_x),
	      CHAR_TO_PIXEL_ROW (f, curs_y),
Jim Blandy's avatar
Jim Blandy committed
794
	      FONT_WIDTH (f->display.x->font) * (first_unused - curs_x),
795
	      f->display.x->line_height, False);
796
#if 0
797
  redraw_previous_char (f, curs_x, curs_y, highlight);
798
#endif
Jim Blandy's avatar
Jim Blandy committed
799 800 801 802

  UNBLOCK_INPUT;
}

803 804 805 806 807 808 809 810 811 812 813 814
static
XTclear_frame ()
{
  int mask;
  struct frame *f = updating_frame;

  if (f == 0)
    f = selected_frame;

  f->phys_cursor_x = -1;	/* Cursor not visible.  */
  curs_x = 0;			/* Nominal cursor position is top left.  */
  curs_y = 0;
815

816 817
  BLOCK_INPUT;

818
  XClearWindow (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f));
819 820 821 822 823

  /* We have to clear the scroll bars, too.  If we have changed
     colors or something like that, then they should be notified.  */
  x_scroll_bar_clear (f);

824
  XFlush (FRAME_X_DISPLAY (f));
825 826 827 828 829 830 831 832 833 834 835 836
  UNBLOCK_INPUT;
}

#if 0
/* This currently does not work because FRAME_CURRENT_GLYPHS doesn't
   always contain the right glyphs to use.

   It also needs to be changed to look at the details of the font and
   see whether there is really overlap, and do nothing when there is
   not.  This can use font_char_overlap_left and font_char_overlap_right,
   but just how to use them is not clear.  */

837 838 839
/* Erase the character (if any) at the position just before X, Y in frame F,
   then redraw it and the character before it.
   This is necessary when we erase starting at X,
840 841
   in case the character after X overlaps into the one before X.
   Call this function with input blocked.  */
842 843

static void
844
redraw_previous_char (f, x, y, highlight_flag)
845 846
     FRAME_PTR f;
     int x, y;
847
     int highlight_flag;
848 849 850 851 852 853 854 855 856 857
{
  /* Erase the character before the new ones, in case
     what was here before overlaps it.
     Reoutput that character, and the previous character
     (in case the previous character overlaps it).  */
  if (x > 0)
    {
      int start_x = x - 2;
      if (start_x < 0)
	start_x = 0;
858
      XClearArea (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
859 860 861
		  CHAR_TO_PIXEL_COL (f, x - 1),
		  CHAR_TO_PIXEL_ROW (f, y),
		  FONT_WIDTH (f->display.x->font),
862
		  f->display.x->line_height, False);
863 864 865 866

      dumpglyphs (f, CHAR_TO_PIXEL_COL (f, start_x),
		  CHAR_TO_PIXEL_ROW (f, y),
		  &FRAME_CURRENT_GLYPHS (f)->glyphs[y][start_x],
867
		  x - start_x, highlight_flag, 1);
868 869 870
    }
}

871 872 873 874 875 876 877 878 879 880 881
/* Erase the character (if any) at the position X, Y in frame F,
   then redraw it and the character after it.
   This is necessary when we erase endng at X,
   in case the character after X overlaps into the one before X.
   Call this function with input blocked.  */

static void
redraw_following_char (f, x, y, highlight_flag)
     FRAME_PTR f;
     int x, y;
     int highlight_flag;
Jim Blandy's avatar
Jim Blandy committed
882
{
883 884 885 886 887 888 889 890 891 892 893
  int limit = FRAME_CURRENT_GLYPHS (f)->used[y];
  /* Erase the character after the new ones, in case
     what was here before overlaps it.
     Reoutput that character, and the following character
     (in case the following character overlaps it).  */
  if (x < limit
      && FRAME_CURRENT_GLYPHS (f)->glyphs[y][x] != SPACEGLYPH)
    {
      int end_x = x + 2;
      if (end_x > limit)
	end_x = limit;
894
      XClearArea (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
895 896 897 898
		  CHAR_TO_PIXEL_COL (f, x),
		  CHAR_TO_PIXEL_ROW (f, y),
		  FONT_WIDTH (f->display.x->font),
		  f->display.x->line_height, False);
Jim Blandy's avatar
Jim Blandy committed
899

900 901 902 903 904 905 906 907 908
      dumpglyphs (f, CHAR_TO_PIXEL_COL (f, x),
		  CHAR_TO_PIXEL_ROW (f, y),
		  &FRAME_CURRENT_GLYPHS (f)->glyphs[y][x],
		  end_x - x, highlight_flag, 1);
    }
}
#endif /* 0 */

#if 0 /* Not in use yet */
Jim Blandy's avatar
Jim Blandy committed
909

910
/* Return 1 if character C in font F extends past its left edge.  */
Jim Blandy's avatar
Jim Blandy committed
911

912 913 914 915 916 917
static int
font_char_overlap_left (font, c)
     XFontStruct *font;
     int c;
{
  XCharStruct *s;
Jim Blandy's avatar
Jim Blandy committed
918

919 920 921 922 923 924 925
  /* Find the bounding-box info for C.  */
  if (font->per_char == 0)
    s = &font->max_bounds;
  else
    {
      int rowlen = font->max_char_or_byte2 - font->min_char_or_byte2 + 1;
      int row, within;
926

927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950
      /* Decode char into row number (byte 1) and code within row (byte 2).  */
      row = c >> 8;
      within = c & 0177;
      if (!(within >= font->min_char_or_byte2
	    && within <= font->max_char_or_byte2
	    && row >= font->min_byte1
	    && row <= font->max_byte1))
	{
	  /* If char is out of range, try the font's default char instead.  */
	  c = font->default_char;
	  row = c >> (INTBITS - 8);
	  within = c & 0177;
	}
      if (!(within >= font->min_char_or_byte2
	    && within <= font->max_char_or_byte2
	    && row >= font->min_byte1
	    && row <= font->max_byte1))
	/* Still out of range means this char does not overlap.  */
	return 0;
      else
	/* We found the info for this char.  */
	s = (font->per_char + (within - font->min_char_or_byte2)
	     + row * rowlen);
    }
Jim Blandy's avatar
Jim Blandy committed
951

952 953
  return (s && s->lbearing < 0);
}
Jim Blandy's avatar
Jim Blandy committed
954

955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970
/* Return 1 if character C in font F extends past its right edge.  */

static int
font_char_overlap_right (font, c)
     XFontStruct *font;
     int c;
{
  XCharStruct *s;

  /* Find the bounding-box info for C.  */
  if (font->per_char == 0)
    s = &font->max_bounds;
  else
    {
      int rowlen = font->max_char_or_byte2 - font->min_char_or_byte2 + 1;
      int row, within;
971

972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997
      /* Decode char into row number (byte 1) and code within row (byte 2).  */
      row = c >> 8;
      within = c & 0177;
      if (!(within >= font->min_char_or_byte2
	    && within <= font->max_char_or_byte2
	    && row >= font->min_byte1
	    && row <= font->max_byte1))
	{
	  /* If char is out of range, try the font's default char instead.  */
	  c = font->default_char;
	  row = c >> (INTBITS - 8);
	  within = c & 0177;
	}
      if (!(within >= font->min_char_or_byte2
	    && within <= font->max_char_or_byte2
	    && row >= font->min_byte1
	    && row <= font->max_byte1))
	/* Still out of range means this char does not overlap.  */
	return 0;
      else
	/* We found the info for this char.  */
	s = (font->per_char + (within - font->min_char_or_byte2)
	     + row * rowlen);
    }

  return (s && s->rbearing >= s->width);
Jim Blandy's avatar
Jim Blandy committed
998
}
999
#endif /* 0 */
Jim Blandy's avatar
Jim Blandy committed
1000

Jim Blandy's avatar
Jim Blandy committed
1001 1002 1003
/* Invert the middle quarter of the frame for .15 sec.  */

/* We use the select system call to do the waiting, so we have to make sure
1004
   it's available.  If it isn't, we just won't do visual bells.  */
Jim Blandy's avatar
Jim Blandy committed
1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037
#if defined (HAVE_TIMEVAL) && defined (HAVE_SELECT)

/* Subtract the `struct timeval' values X and Y,
   storing the result in RESULT.
   Return 1 if the difference is negative, otherwise 0.  */

static int
timeval_subtract (result, x, y)
     struct timeval *result, x, y;
{
  /* Perform the carry for the later subtraction by updating y.
     This is safer because on some systems
     the tv_sec member is unsigned.  */
  if (x.tv_usec < y.tv_usec)
    {
      int nsec = (y.tv_usec - x.tv_usec) / 1000000 + 1;
      y.tv_usec -= 1000000 * nsec;
      y.tv_sec += nsec;
    }
  if (x.tv_usec - y.tv_usec > 1000000)
    {
      int nsec = (y.tv_usec - x.tv_usec) / 1000000;
      y.tv_usec += 1000000 * nsec;
      y.tv_sec -= nsec;
    }

  /* Compute the time remaining to wait.  tv_usec is certainly positive.  */
  result->tv_sec = x.tv_sec - y.tv_sec;
  result->tv_usec = x.tv_usec - y.tv_usec;

  /* Return indication of whether the result should be considered negative.  */
  return x.tv_sec < y.tv_sec;
}
Jim Blandy's avatar
Jim Blandy committed
1038

Jim Blandy's avatar
Jim Blandy committed
1039 1040
XTflash (f)
     struct frame *f;
Jim Blandy's avatar
Jim Blandy committed
1041
{
Jim Blandy's avatar
Jim Blandy committed
1042
  BLOCK_INPUT;
Jim Blandy's avatar
Jim Blandy committed
1043

Jim Blandy's avatar
Jim Blandy committed
1044 1045
  {
    GC gc;
Jim Blandy's avatar
Jim Blandy committed
1046

Jim Blandy's avatar
Jim Blandy committed
1047 1048 1049 1050
    /* Create a GC that will use the GXxor function to flip foreground pixels
       into background pixels.  */
    {
      XGCValues values;
Jim Blandy's avatar
Jim Blandy committed
1051

Jim Blandy's avatar
Jim Blandy committed
1052 1053 1054
      values.function = GXxor;
      values.foreground = (f->display.x->foreground_pixel
			   ^ f->display.x->background_pixel);
1055

1056
      gc = XCreateGC (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
Jim Blandy's avatar
Jim Blandy committed
1057 1058
		      GCFunction | GCForeground, &values);
    }
Jim Blandy's avatar
Jim Blandy committed
1059

Jim Blandy's avatar
Jim Blandy committed
1060 1061 1062
    {
      int width  = PIXEL_WIDTH  (f);
      int height = PIXEL_HEIGHT (f);
Jim Blandy's avatar
Jim Blandy committed
1063

1064
      XFillRectangle (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), gc,
Jim Blandy's avatar
Jim Blandy committed
1065
		      width/4, height/4, width/2, height/2);
1066
      XFlush (FRAME_X_DISPLAY (f));
Jim Blandy's avatar
Jim Blandy committed
1067

Jim Blandy's avatar
Jim Blandy committed
1068 1069
      {
	struct timeval wakeup, now;
Jim Blandy's avatar
Jim Blandy committed
1070

1071
	EMACS_GET_TIME (wakeup);
Jim Blandy's avatar
Jim Blandy committed
1072

Jim Blandy's avatar
Jim Blandy committed
1073 1074 1075 1076 1077 1078 1079 1080 1081 1082
	/* Compute time to wait until, propagating carry from usecs.  */
	wakeup.tv_usec += 150000;
	wakeup.tv_sec += (wakeup.tv_usec / 1000000);
	wakeup.tv_usec %= 1000000;

	/* Keep waiting until past the time wakeup.  */
	while (1)
	  {
	    struct timeval timeout;

1083
	    EMACS_GET_TIME (timeout);
Jim Blandy's avatar
Jim Blandy committed
1084 1085 1086 1087 1088 1089 1090 1091 1092 1093

	    /* In effect, timeout = wakeup - timeout.
	       Break if result would be negative.  */
	    if (timeval_subtract (&timeout, wakeup, timeout))
	      break;

	    /* Try to wait that long--but we might wake up sooner.  */
	    select (0, 0, 0, 0, &timeout);
	  }
      }
1094

1095
      XFillRectangle (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), gc,
Jim Blandy's avatar
Jim Blandy committed
1096
		      width/4, height/4, width/2, height/2);
1097 1098
      XFreeGC (FRAME_X_DISPLAY (f), gc);
      XFlush (FRAME_X_DISPLAY (f));
Jim Blandy's avatar
Jim Blandy committed
1099
    }
Jim Blandy's avatar
Jim Blandy committed
1100 1101 1102
  }

  UNBLOCK_INPUT;
Jim Blandy's avatar
Jim Blandy committed
1103 1104
}

Jim Blandy's avatar
Jim Blandy committed
1105 1106 1107
#endif


Jim Blandy's avatar
Jim Blandy committed
1108 1109
/* Make audible bell.  */

1110
#define XRINGBELL XBell (FRAME_X_DISPLAY (selected_frame), 0)
Jim Blandy's avatar
Jim Blandy committed
1111 1112 1113

XTring_bell ()
{
1114
  if (FRAME_X_DISPLAY (selected_frame) == 0)
1115 1116
    return;

Jim Blandy's avatar
Jim Blandy committed
1117
#if defined (HAVE_TIMEVAL) && defined (HAVE_SELECT)
Jim Blandy's avatar
Jim Blandy committed
1118
  if (visible_bell)
Jim Blandy's avatar
Jim Blandy committed
1119
    XTflash (selected_frame);