xterm.c 319 KB
Newer Older
Jim Blandy's avatar
Jim Blandy committed
1
/* X Communication module for terminals which understand the X protocol.
2 3 4 5

Copyright (C) 1989, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
  2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
  Free Software Foundation, Inc.
Jim Blandy's avatar
Jim Blandy committed
6 7 8

This file is part of GNU Emacs.

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

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
20
along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.  */
Jim Blandy's avatar
Jim Blandy committed
21

22
/* New display code by Gerd Moellmann <gerd@gnu.org>.  */
23 24
/* Xt features made by Fred Pierresteguy.  */

25
#include <config.h>
26
#include <signal.h>
27
#include <stdio.h>
28
#include <setjmp.h>
29

Jim Blandy's avatar
Jim Blandy committed
30 31 32
#ifdef HAVE_X_WINDOWS

#include "lisp.h"
33
#include "blockinput.h"
Jim Blandy's avatar
Jim Blandy committed
34

35 36 37 38
/* Need syssignal.h for various externs and definitions that may be required
   by some configurations for calls to signal later in this source file.  */
#include "syssignal.h"

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

/* Load sys/types.h if not already loaded.
   In some systems loading it twice is suicidal.  */
#ifndef makedev
#include <sys/types.h>
48
#endif /* makedev */
Jim Blandy's avatar
Jim Blandy committed
49

Dan Nicolaescu's avatar
Dan Nicolaescu committed
50
#ifdef HAVE_SYS_IOCTL_H
Jim Blandy's avatar
Jim Blandy committed
51
#include <sys/ioctl.h>
Dan Nicolaescu's avatar
Dan Nicolaescu committed
52
#endif /* ! defined (HAVE_SYS_IOCTL_H) */
Jim Blandy's avatar
Jim Blandy committed
53

Jim Blandy's avatar
Jim Blandy committed
54
#include "systime.h"
Jim Blandy's avatar
Jim Blandy committed
55 56 57 58 59 60

#include <fcntl.h>
#include <ctype.h>
#include <errno.h>
#include <setjmp.h>
#include <sys/stat.h>
Richard M. Stallman's avatar
Richard M. Stallman committed
61 62
/* Caused redefinition of DBL_DIG on Netbsd; seems not to be needed.  */
/* #include <sys/param.h>  */
Jim Blandy's avatar
Jim Blandy committed
63

64
#include "charset.h"
Kenichi Handa's avatar
Kenichi Handa committed
65
#include "character.h"
Kenichi Handa's avatar
Kenichi Handa committed
66
#include "coding.h"
67
#include "frame.h"
Jim Blandy's avatar
Jim Blandy committed
68
#include "dispextern.h"
69
#include "fontset.h"
Jim Blandy's avatar
Jim Blandy committed
70 71 72
#include "termhooks.h"
#include "termopts.h"
#include "termchar.h"
73
#include "emacs-icon.h"
Jim Blandy's avatar
Jim Blandy committed
74 75
#include "disptab.h"
#include "buffer.h"
76
#include "window.h"
Richard M. Stallman's avatar
Richard M. Stallman committed
77
#include "keyboard.h"
Karl Heuer's avatar
Karl Heuer committed
78
#include "intervals.h"
Andreas Schwab's avatar
Andreas Schwab committed
79
#include "process.h"
Gerd Moellmann's avatar
Gerd Moellmann committed
80
#include "atimer.h"
Stefan Monnier's avatar
Stefan Monnier committed
81
#include "keymap.h"
82
#include "font.h"
83
#include "fontset.h"
84
#include "xsettings.h"
85
#include "xgselect.h"
86
#include "sysselect.h"
Jim Blandy's avatar
Jim Blandy committed
87

88 89 90 91
#ifdef USE_X_TOOLKIT
#include <X11/Shell.h>
#endif

92 93 94 95 96 97 98
#ifdef HAVE_SYS_TIME_H
#include <sys/time.h>
#endif
#ifdef HAVE_UNISTD_H
#include <unistd.h>
#endif

Jan Djärv's avatar
Jan Djärv committed
99 100 101 102
#ifdef USE_GTK
#include "gtkutil.h"
#endif

103
#ifdef USE_LUCID
104
#include "../lwlib/xlwmenu.h"
105 106
#endif

Jan Djärv's avatar
Jan Djärv committed
107
#ifdef USE_X_TOOLKIT
Dan Nicolaescu's avatar
Dan Nicolaescu committed
108
#if !defined(NO_EDITRES)
109 110 111
#define HACK_EDITRES
extern void _XEditResCheckMessages ();
#endif /* not NO_EDITRES */
112 113 114 115 116 117 118

/* Include toolkit specific headers for the scroll bar widget.  */

#ifdef USE_TOOLKIT_SCROLL_BARS
#if defined USE_MOTIF
#include <Xm/Xm.h>		/* for LESSTIF_VERSION */
#include <Xm/ScrollBar.h>
119 120 121
#else /* !USE_MOTIF i.e. use Xaw */

#ifdef HAVE_XAW3D
122 123
#include <X11/Xaw3d/Simple.h>
#include <X11/Xaw3d/Scrollbar.h>
124
#include <X11/Xaw3d/ThreeD.h>
125 126 127 128 129 130 131 132
#else /* !HAVE_XAW3D */
#include <X11/Xaw/Simple.h>
#include <X11/Xaw/Scrollbar.h>
#endif /* !HAVE_XAW3D */
#ifndef XtNpickTop
#define XtNpickTop "pickTop"
#endif /* !XtNpickTop */
#endif /* !USE_MOTIF */
133 134
#endif /* USE_TOOLKIT_SCROLL_BARS */

135 136
#endif /* USE_X_TOOLKIT */

137
#ifdef USE_X_TOOLKIT
Karl Heuer's avatar
Karl Heuer committed
138
#include "widget.h"
139 140 141 142 143
#ifndef XtNinitialState
#define XtNinitialState "initialState"
#endif
#endif

Dave Love's avatar
Dave Love committed
144
/* Default to using XIM if available.  */
145
#ifdef USE_XIM
Dave Love's avatar
Dave Love committed
146
int use_xim = 1;
147 148 149 150
#else
int use_xim = 0;  /* configure --without-xim */
#endif

151 152


153
/* Non-nil means Emacs uses toolkit scroll bars.  */
154

155
Lisp_Object Vx_toolkit_scroll_bars;
156 157 158 159 160 161

/* Non-zero means that a HELP_EVENT has been generated since Emacs
   start.  */

static int any_help_event_p;

162
/* Last window where we saw the mouse.  Used by mouse-autoselect-window.  */
163
static Lisp_Object last_window;
164

165 166 167 168
/* Non-zero means make use of UNDERLINE_POSITION font properties.  */

int x_use_underline_position_properties;

169 170 171 172
/* Non-zero means to draw the underline at the same place as the descent line.  */

int x_underline_at_descent_line;

173 174 175
/* This is a chain of structures for all the X displays currently in
   use.  */

176
struct x_display_info *x_display_list;
Jim Blandy's avatar
Jim Blandy committed
177

178 179 180 181 182
/* 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.  */

183
Lisp_Object x_display_name_list;
184

185
/* Frame being updated by update_frame.  This is declared in term.c.
186 187 188 189
   This is set by update_begin and looked at by all the XT functions.
   It is zero while not inside an update.  In that case, the XT
   functions assume that `selected_frame' is the frame to apply to.  */

190
extern struct frame *updating_frame;
Jim Blandy's avatar
Jim Blandy committed
191

192 193
/* This is a frame waiting to be auto-raised, within XTread_socket.  */

194 195 196 197 198 199 200 201
static struct frame *pending_autoraise_frame;

/* This is a frame waiting for an event matching mask, within XTread_socket.  */

static struct {
  struct frame *f;
  int eventtype;
} pending_event_wait;
202

203 204 205
#ifdef USE_X_TOOLKIT
/* The application context for Xt use.  */
XtAppContext Xt_app_con;
206 207
static String Xt_default_resources[] = {0};
#endif /* USE_X_TOOLKIT */
208

Gerd Moellmann's avatar
Gerd Moellmann committed
209 210 211
/* Non-zero means user is interacting with a toolkit scroll bar.  */

static int toolkit_scroll_bar_interaction;
Jim Blandy's avatar
Jim Blandy committed
212

Kenichi Handa's avatar
Kenichi Handa committed
213 214 215 216 217 218 219 220 221 222 223
/* Non-zero means to not move point as a result of clicking on a
   frame to focus it (when focus-follows-mouse is nil).  */

int x_mouse_click_focus_ignore_position;

/* Non-zero timeout value means ignore next mouse click if it arrives
   before that timeout elapses (i.e. as part of the same sequence of
   events resulting from clicking on a frame to select it).  */

static unsigned long ignore_next_mouse_click_timeout;

224 225
/* Mouse movement.

226
   Formerly, we used PointerMotionHintMask (in standard_event_mask)
227 228 229 230 231 232
   so that we would have to call XQueryPointer after each MotionNotify
   event to ask for another such event.  However, this made mouse tracking
   slow, and there was a bug that made it eventually stop.

   Simply asking for MotionNotify all the time seems to work better.

233 234 235 236 237 238 239 240 241
   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
242
   is off.  */
243 244 245

/* Where the mouse was last time we reported a mouse event.  */

246
static XRectangle last_mouse_glyph;
Kim F. Storm's avatar
Kim F. Storm committed
247
static FRAME_PTR last_mouse_glyph_frame;
248 249
static Lisp_Object last_mouse_press_frame;

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

252 253
   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
254 255
   an ordinary motion.

256 257 258 259
   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.  */

260 261 262 263
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
264
   doesn't seem to be any way to wrest the time-stamp from the server
265 266 267
   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.  */
268

269 270
static Time last_mouse_movement_time;

Jan Djärv's avatar
Jan Djärv committed
271 272 273 274
/* Time for last user interaction as returned in X events.  */

static Time last_user_time;

275 276 277
/* Incremented by XTread_socket whenever it really tries to read
   events.  */

278 279 280 281 282 283
#ifdef __STDC__
static int volatile input_signal_count;
#else
static int input_signal_count;
#endif

284
/* Used locally within XTread_socket.  */
285

286
static int x_noop_count;
Jim Blandy's avatar
Jim Blandy committed
287

288 289 290
/* The keysyms to use for the various modifiers.  */

Lisp_Object Vx_alt_keysym, Vx_hyper_keysym, Vx_meta_keysym, Vx_super_keysym;
Dave Love's avatar
Dave Love committed
291
Lisp_Object Vx_keysym_table;
292 293
static Lisp_Object Qalt, Qhyper, Qmeta, Qsuper, Qmodifier_value;

294
static Lisp_Object Qvendor_specific_keysyms;
Dave Love's avatar
Dave Love committed
295
static Lisp_Object Qlatin_1;
296

297 298 299
#ifdef USE_GTK
/* The name of the Emacs icon file.  */
static Lisp_Object xg_default_icon_file;
300 301 302

/* Used in gtkutil.c.  */
Lisp_Object Qx_gtk_map_stock;
303 304
#endif

305 306 307
/* Some functions take this as char *, not const char *.  */
static char emacs_class[] = EMACS_CLASS;

308 309
/* Used in x_flush.  */

310 311
extern XrmDatabase x_load_resources (Display *, const char *, const char *,
				     const char *);
312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 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
extern int x_bitmap_mask (FRAME_PTR, int);

static int x_alloc_nearest_color_1 (Display *, Colormap, XColor *);
static void x_set_window_size_1 (struct frame *, int, int, int);
static const XColor *x_color_cells (Display *, int *);
static void x_update_window_end (struct window *, int, int);

static int x_io_error_quitter (Display *);
static struct terminal *x_create_terminal (struct x_display_info *);
void x_delete_terminal (struct terminal *);
static void x_update_end (struct frame *);
static void XTframe_up_to_date (struct frame *);
static void XTset_terminal_modes (struct terminal *);
static void XTreset_terminal_modes (struct terminal *);
static void x_clear_frame (struct frame *);
static void frame_highlight (struct frame *);
static void frame_unhighlight (struct frame *);
static void x_new_focus_frame (struct x_display_info *, struct frame *);
static void  x_focus_changed (int, int, struct x_display_info *,
                              struct frame *, struct input_event *);
static void x_detect_focus_change (struct x_display_info *,
                                   XEvent *, struct input_event *);
static void XTframe_rehighlight (struct frame *);
static void x_frame_rehighlight (struct x_display_info *);
static void x_draw_hollow_cursor (struct window *, struct glyph_row *);
static void x_draw_bar_cursor (struct window *, struct glyph_row *, int,
                               enum text_cursor_kinds);

static void x_clip_to_row (struct window *, struct glyph_row *, int, GC);
static void x_flush (struct frame *f);
static void x_update_begin (struct frame *);
static void x_update_window_begin (struct window *);
static void x_after_update_window_line (struct glyph_row *);
static struct scroll_bar *x_window_to_scroll_bar (Display *, Window);
static void x_scroll_bar_report_motion (struct frame **, Lisp_Object *,
                                        enum scroll_bar_part *,
                                        Lisp_Object *, Lisp_Object *,
                                        unsigned long *);
static void x_handle_net_wm_state (struct frame *, XPropertyEvent *);
static void x_check_fullscreen (struct frame *);
static void x_check_expected_move (struct frame *, int, int);
static void x_sync_with_move (struct frame *, int, int, int);
static int handle_one_xevent (struct x_display_info *, XEvent *,
                              int *, struct input_event *);
356 357
/* Don't declare this NO_RETURN because we want no
   interference with debugging failing X calls.  */
358
static SIGTYPE x_connection_closed (Display *, const char *);
Jan Djärv's avatar
Jan Djärv committed
359

360 361 362 363

/* Flush display of frame F, or of all frames if F is null.  */

static void
364
x_flush (struct frame *f)
365
{
366 367 368 369 370
  /* Don't call XFlush when it is not safe to redisplay; the X
     connection may be broken.  */
  if (!NILP (Vinhibit_redisplay))
    return;

371 372 373 374 375
  BLOCK_INPUT;
  if (f == NULL)
    {
      Lisp_Object rest, frame;
      FOR_EACH_FRAME (rest, frame)
376 377
        if (FRAME_X_P (XFRAME (frame)))
          x_flush (XFRAME (frame));
378 379 380 381 382 383
    }
  else if (FRAME_X_P (f))
    XFlush (FRAME_X_DISPLAY (f));
  UNBLOCK_INPUT;
}

Jim Blandy's avatar
Jim Blandy committed
384

385 386 387 388 389 390 391
/* Remove calls to XFlush by defining XFlush to an empty replacement.
   Calls to XFlush should be unnecessary because the X output buffer
   is flushed automatically as needed by calls to XPending,
   XNextEvent, or XWindowEvent according to the XFlush man page.
   XTread_socket calls XPending.  Removing XFlush improves
   performance.  */

Juanma Barranquero's avatar
Juanma Barranquero committed
392
#define XFlush(DISPLAY)	(void) 0
393

394

395 396 397 398
/***********************************************************************
			      Debugging
 ***********************************************************************/

399
#if 0
400 401 402

/* This is a function useful for recording debugging information about
   the sequence of occurrences in this file.  */
403

Juanma Barranquero's avatar
Juanma Barranquero committed
404
struct record
405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426
{
  char *locus;
  int type;
};

struct record event_record[100];

int event_record_index;

record_event (locus, type)
     char *locus;
     int type;
{
  if (event_record_index == sizeof (event_record) / sizeof (struct record))
    event_record_index = 0;

  event_record[event_record_index].locus = locus;
  event_record[event_record_index].type = type;
  event_record_index++;
}

#endif /* 0 */
427 428


429

430 431 432
/* Return the struct x_display_info corresponding to DPY.  */

struct x_display_info *
433
x_display_info_for_display (Display *dpy)
434 435 436 437 438 439
{
  struct x_display_info *dpyinfo;

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

441 442
  return 0;
}
443

444 445 446 447
#define OPAQUE  0xffffffff
#define OPACITY "_NET_WM_WINDOW_OPACITY"

void
448
x_set_frame_alpha (struct frame *f)
449 450 451 452
{
  struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
  Display *dpy = FRAME_X_DISPLAY (f);
  Window win = FRAME_OUTER_WINDOW (f);
453 454
  double alpha = 1.0;
  double alpha_min = 1.0;
455 456
  unsigned long opac;

457 458 459
  if (FRAME_X_DISPLAY_INFO (f)->root_window != FRAME_X_OUTPUT (f)->parent_desc)
    /* Since the WM decoration lies under the FRAME_OUTER_WINDOW,
       we must treat the former instead of the latter. */
460
    win = FRAME_X_OUTPUT (f)->parent_desc;
461 462 463 464 465 466 467 468 469 470 471

  if (dpyinfo->x_highlight_frame == f)
    alpha = f->alpha[0];
  else
    alpha = f->alpha[1];

  if (FLOATP (Vframe_alpha_lower_limit))
    alpha_min = XFLOAT_DATA (Vframe_alpha_lower_limit);
  else if (INTEGERP (Vframe_alpha_lower_limit))
    alpha_min = (XINT (Vframe_alpha_lower_limit)) / 100.0;

472 473 474
  if (alpha < 0.0)
    return;
  else if (alpha > 1.0)
475 476 477 478
    alpha = 1.0;
  else if (0.0 <= alpha && alpha < alpha_min && alpha_min <= 1.0)
    alpha = alpha_min;

479
  opac = alpha * OPAQUE;
480 481 482 483 484

  /* return unless necessary */
  {
    unsigned char *data;
    Atom actual;
485
    int rc, format;
486 487
    unsigned long n, left;

488
    x_catch_errors (dpy);
489 490 491 492
    rc = XGetWindowProperty (dpy, win, XInternAtom(dpy, OPACITY, False),
			     0L, 1L, False, XA_CARDINAL,
			     &actual, &format, &n, &left,
			     &data);
493 494

    if (rc == Success && actual != None)
495
      if (*(unsigned long *)data == opac)
496 497
	{
	  XFree ((void *) data);
498
	  x_uncatch_errors ();
499 500 501
	  return;
	}
      else
502
	XFree ((void *) data);
503
    x_uncatch_errors ();
504 505
  }

506
  x_catch_errors (dpy);
507 508 509
  XChangeProperty (dpy, win, XInternAtom (dpy, OPACITY, False),
		   XA_CARDINAL, 32, PropModeReplace,
		   (unsigned char *) &opac, 1L);
510
  x_uncatch_errors ();
511
}
512

513
int
514
x_display_pixel_height (struct x_display_info *dpyinfo)
515 516 517 518 519
{
  return HeightOfScreen (dpyinfo->screen);
}

int
520
x_display_pixel_width (struct x_display_info *dpyinfo)
521 522 523 524
{
  return WidthOfScreen (dpyinfo->screen);
}

525 526 527 528

/***********************************************************************
		    Starting and ending an update
 ***********************************************************************/
Juanma Barranquero's avatar
Juanma Barranquero committed
529

530 531 532 533 534
/* Start an update of frame F.  This function is installed as a hook
   for update_begin, i.e. it is called when update_begin is called.
   This function is called prior to calls to x_update_window_begin for
   each window being updated.  Currently, there is nothing to do here
   because all interesting stuff is done on a window basis.  */
Jim Blandy's avatar
Jim Blandy committed
535

Andreas Schwab's avatar
Andreas Schwab committed
536
static void
537
x_update_begin (struct frame *f)
538
{
539 540
  /* Nothing to do.  */
}
Jim Blandy's avatar
Jim Blandy committed
541 542


543 544 545
/* Start update of window W.  Set the global variable updated_window
   to the window being updated and set output_cursor to the cursor
   position of W.  */
Jim Blandy's avatar
Jim Blandy committed
546

547
static void
548
x_update_window_begin (struct window *w)
549 550
{
  struct frame *f = XFRAME (WINDOW_FRAME (w));
551
  Mouse_HLInfo *hlinfo = MOUSE_HL_INFO (f);
Juanma Barranquero's avatar
Juanma Barranquero committed
552

553 554
  updated_window = w;
  set_output_cursor (&w->cursor);
555

556
  BLOCK_INPUT;
557

558
  if (f == hlinfo->mouse_face_mouse_frame)
559
    {
560
      /* Don't do highlighting for mouse motion during the update.  */
561
      hlinfo->mouse_face_defer = 1;
562

563 564
      /* If F needs to be redrawn, simply forget about any prior mouse
	 highlighting.  */
565
      if (FRAME_GARBAGED_P (f))
566
	hlinfo->mouse_face_window = Qnil;
567
    }
Richard M. Stallman's avatar
Richard M. Stallman committed
568

Jim Blandy's avatar
Jim Blandy committed
569 570 571
  UNBLOCK_INPUT;
}

572

573
/* Draw a vertical window border from (x,y0) to (x,y1)  */
574

Andreas Schwab's avatar
Andreas Schwab committed
575
static void
576
x_draw_vertical_window_border (struct window *w, int x, int y0, int y1)
577
{
578
  struct frame *f = XFRAME (WINDOW_FRAME (w));
579 580 581 582 583 584
  struct face *face;

  face = FACE_FROM_ID (f, VERTICAL_BORDER_FACE_ID);
  if (face)
    XSetForeground (FRAME_X_DISPLAY (f), f->output_data.x->normal_gc,
		    face->foreground);
585

586 587
  XDrawLine (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
	     f->output_data.x->normal_gc, x, y0, x, y1);
588
}
Juanma Barranquero's avatar
Juanma Barranquero committed
589

590 591 592 593 594 595 596 597 598 599 600 601
/* End update of window W (which is equal to updated_window).

   Draw vertical borders between horizontally adjacent windows, and
   display W's cursor if CURSOR_ON_P is non-zero.

   MOUSE_FACE_OVERWRITTEN_P non-zero means that some row containing
   glyphs in mouse-face were overwritten.  In that case we have to
   make sure that the mouse-highlight is properly redrawn.

   W may be a menu bar pseudo-window in case we don't have X toolkit
   support.  Such windows don't have a cursor, so don't display it
   here.  */
602 603

static void
604
x_update_window_end (struct window *w, int cursor_on_p, int mouse_face_overwritten_p)
605
{
606
  Mouse_HLInfo *hlinfo = MOUSE_HL_INFO (XFRAME (w->frame));
Juanma Barranquero's avatar
Juanma Barranquero committed
607

608 609 610
  if (!w->pseudo_window_p)
    {
      BLOCK_INPUT;
611

612
      if (cursor_on_p)
613 614 615
	display_and_set_cursor (w, 1, output_cursor.hpos,
				output_cursor.vpos,
				output_cursor.x, output_cursor.y);
Juanma Barranquero's avatar
Juanma Barranquero committed
616

617 618
      if (draw_window_fringes (w, 1))
	x_draw_vertical_border (w);
Kenichi Handa's avatar
Kenichi Handa committed
619

620 621
      UNBLOCK_INPUT;
    }
Juanma Barranquero's avatar
Juanma Barranquero committed
622

623 624 625 626
  /* If a row with mouse-face was overwritten, arrange for
     XTframe_up_to_date to redisplay the mouse highlight.  */
  if (mouse_face_overwritten_p)
    {
627 628 629
      hlinfo->mouse_face_beg_row = hlinfo->mouse_face_beg_col = -1;
      hlinfo->mouse_face_end_row = hlinfo->mouse_face_end_col = -1;
      hlinfo->mouse_face_window = Qnil;
630
    }
Juanma Barranquero's avatar
Juanma Barranquero committed
631

632 633
  updated_window = NULL;
}
Jim Blandy's avatar
Jim Blandy committed
634 635


636 637 638 639
/* End update of frame F.  This function is installed as a hook in
   update_end.  */

static void
640
x_update_end (struct frame *f)
641 642
{
  /* Mouse highlight may be displayed again.  */
643
  MOUSE_HL_INFO (f)->mouse_face_defer = 0;
644

645
#ifndef XFlush
646
  BLOCK_INPUT;
647
  XFlush (FRAME_X_DISPLAY (f));
Jim Blandy's avatar
Jim Blandy committed
648
  UNBLOCK_INPUT;
649
#endif
Jim Blandy's avatar
Jim Blandy committed
650
}
651

652 653 654 655

/* This function is called from various places in xdisp.c whenever a
   complete update has been performed.  The global variable
   updated_window is not available here.  */
656

Andreas Schwab's avatar
Andreas Schwab committed
657
static void
658
XTframe_up_to_date (struct frame *f)
659
{
660
  if (FRAME_X_P (f))
661
    {
662
      Mouse_HLInfo *hlinfo = MOUSE_HL_INFO (f);
663

664 665
      if (hlinfo->mouse_face_deferred_gc
	  || f == hlinfo->mouse_face_mouse_frame)
666 667
	{
	  BLOCK_INPUT;
668 669 670 671 672
	  if (hlinfo->mouse_face_mouse_frame)
	    note_mouse_highlight (hlinfo->mouse_face_mouse_frame,
				  hlinfo->mouse_face_mouse_x,
				  hlinfo->mouse_face_mouse_y);
	  hlinfo->mouse_face_deferred_gc = 0;
673 674
	  UNBLOCK_INPUT;
	}
675
    }
676
}
677 678 679


/* Draw truncation mark bitmaps, continuation mark bitmaps, overlay
Kim F. Storm's avatar
Kim F. Storm committed
680
   arrow bitmaps, or clear the fringes if no bitmaps are required
681 682 683 684 685 686
   before DESIRED_ROW is made current.  The window being updated is
   found in updated_window.  This function It is called from
   update_window_line only if it is known that there are differences
   between bitmaps to be drawn between current row and DESIRED_ROW.  */

static void
687
x_after_update_window_line (struct glyph_row *desired_row)
688 689
{
  struct window *w = updated_window;
690
  struct frame *f;
691
  int width, height;
Juanma Barranquero's avatar
Juanma Barranquero committed
692

693
  xassert (w);
Juanma Barranquero's avatar
Juanma Barranquero committed
694

695
  if (!desired_row->mode_line_p && !w->pseudo_window_p)
Kenichi Handa's avatar
Kenichi Handa committed
696
    desired_row->redraw_fringe_bitmaps_p = 1;
Juanma Barranquero's avatar
Juanma Barranquero committed
697

698 699 700 701 702 703 704 705 706 707
  /* When a window has disappeared, make sure that no rest of
     full-width rows stays visible in the internal border.  Could
     check here if updated_window is the leftmost/rightmost window,
     but I guess it's not worth doing since vertically split windows
     are almost never used, internal border is rarely set, and the
     overhead is very small.  */
  if (windows_or_buffers_changed
      && desired_row->full_width_p
      && (f = XFRAME (w->frame),
	  width = FRAME_INTERNAL_BORDER_WIDTH (f),
708 709 710
	  width != 0)
      && (height = desired_row->visible_height,
	  height > 0))
711 712
    {
      int y = WINDOW_TO_FRAME_PIXEL_Y (w, max (0, desired_row->y));
713

714 715 716 717
      BLOCK_INPUT;
      x_clear_area (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
		    0, y, width, height, False);
      x_clear_area (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
718
		    FRAME_PIXEL_WIDTH (f) - width,
719
		    y, width, height, False);
720 721 722 723 724
      UNBLOCK_INPUT;
    }
}

static void
725
x_draw_fringe_bitmap (struct window *w, struct glyph_row *row, struct draw_fringe_bitmap_params *p)
726 727 728 729 730
{
  struct frame *f = XFRAME (WINDOW_FRAME (w));
  Display *display = FRAME_X_DISPLAY (f);
  Window window = FRAME_X_WINDOW (f);
  GC gc = f->output_data.x->normal_gc;
Kim F. Storm's avatar
Kim F. Storm committed
731
  struct face *face = p->face;
732 733

  /* Must clip because of partially visible lines.  */
734
  x_clip_to_row (w, row, -1, gc);
735

736
  if (!p->overlay_p)
737
    {
738 739
      int bx = p->bx, by = p->by, nx = p->nx, ny = p->ny;

740 741 742 743 744 745 746 747
      /* In case the same realized face is used for fringes and
	 for something displayed in the text (e.g. face `region' on
	 mono-displays, the fill style may have been changed to
	 FillSolid in x_draw_glyph_string_background.  */
      if (face->stipple)
	XSetFillStyle (display, face->gc, FillOpaqueStippled);
      else
	XSetForeground (display, face->gc, face->background);
Juanma Barranquero's avatar
Juanma Barranquero committed
748

749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797
#ifdef USE_TOOLKIT_SCROLL_BARS
      /* If the fringe is adjacent to the left (right) scroll bar of a
	 leftmost (rightmost, respectively) window, then extend its
	 background to the gap between the fringe and the bar.  */
      if ((WINDOW_LEFTMOST_P (w)
	   && WINDOW_HAS_VERTICAL_SCROLL_BAR_ON_LEFT (w))
	  || (WINDOW_RIGHTMOST_P (w)
	      && WINDOW_HAS_VERTICAL_SCROLL_BAR_ON_RIGHT (w)))
	{
	  int sb_width = WINDOW_CONFIG_SCROLL_BAR_WIDTH (w);

	  if (sb_width > 0)
	    {
	      int left = WINDOW_SCROLL_BAR_AREA_X (w);
	      int width = (WINDOW_CONFIG_SCROLL_BAR_COLS (w)
			   * FRAME_COLUMN_WIDTH (f));

	      if (bx < 0)
		{
		  /* Bitmap fills the fringe.  */
		  if (left + width == p->x)
		    bx = left + sb_width;
		  else if (p->x + p->wd == left)
		    bx = left;
		  if (bx >= 0)
		    {
		      int header_line_height = WINDOW_HEADER_LINE_HEIGHT (w);

		      nx = width - sb_width;
		      by = WINDOW_TO_FRAME_PIXEL_Y (w, max (header_line_height,
							    row->y));
		      ny = row->visible_height;
		    }
		}
	      else
		{
		  if (left + width == bx)
		    {
		      bx = left + sb_width;
		      nx += width - sb_width;
		    }
		  else if (bx + nx == left)
		    nx += width - sb_width;
		}
	    }
	}
#endif
      if (bx >= 0 && nx > 0)
	XFillRectangle (display, window, face->gc, bx, by, nx, ny);
Kim F. Storm's avatar
Kim F. Storm committed
798

799 800 801 802
      if (!face->stipple)
	XSetForeground (display, face->gc, face->foreground);
    }

Kenichi Handa's avatar
Kenichi Handa committed
803
  if (p->which)
804
    {
Kenichi Handa's avatar
Kenichi Handa committed
805 806
      unsigned char *bits;
      Pixmap pixmap, clipmask = (Pixmap) 0;
Kim F. Storm's avatar
Kim F. Storm committed
807
      int depth = DefaultDepthOfScreen (FRAME_X_SCREEN (f));
Kenichi Handa's avatar
Kenichi Handa committed
808 809 810 811 812 813
      XGCValues gcv;

      if (p->wd > 8)
	bits = (unsigned char *)(p->bits + p->dh);
      else
	bits = (unsigned char *)p->bits + p->dh;
Kim F. Storm's avatar
Kim F. Storm committed
814

815 816
      /* Draw the bitmap.  I believe these small pixmaps can be cached
	 by the server.  */
Kim F. Storm's avatar
Kim F. Storm committed
817
      pixmap = XCreatePixmapFromBitmapData (display, window, bits, p->wd, p->h,
Kenichi Handa's avatar
Kenichi Handa committed
818 819 820 821
					    (p->cursor_p
					     ? (p->overlay_p ? face->background
						: f->output_data.x->cursor_pixel)
					     : face->foreground),
822
					    face->background, depth);
Kenichi Handa's avatar
Kenichi Handa committed
823 824 825 826 827 828 829 830 831 832 833 834 835

      if (p->overlay_p)
	{
	  clipmask = XCreatePixmapFromBitmapData (display,
						  FRAME_X_DISPLAY_INFO (f)->root_window,
						  bits, p->wd, p->h,
						  1, 0, 1);
	  gcv.clip_mask = clipmask;
	  gcv.clip_x_origin = p->x;
	  gcv.clip_y_origin = p->y;
	  XChangeGC (display, gc, GCClipMask | GCClipXOrigin | GCClipYOrigin, &gcv);
	}

Kim F. Storm's avatar
Kim F. Storm committed
836 837
      XCopyArea (display, pixmap, window, gc, 0, 0,
		 p->wd, p->h, p->x, p->y);
838
      XFreePixmap (display, pixmap);
Kenichi Handa's avatar
Kenichi Handa committed
839 840 841 842 843 844 845

      if (p->overlay_p)
	{
	  gcv.clip_mask = (Pixmap) 0;
	  XChangeGC (display, gc, GCClipMask, &gcv);
	  XFreePixmap (display, clipmask);
	}
846
    }
Juanma Barranquero's avatar
Juanma Barranquero committed
847

848 849 850
  XSetClipMask (display, gc, None);
}

Jim Blandy's avatar
Jim Blandy committed
851

852 853 854 855 856

/* This is called 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).  */
Jim Blandy's avatar
Jim Blandy committed
857

Andreas Schwab's avatar
Andreas Schwab committed
858
static void
859
XTset_terminal_modes (struct terminal *terminal)
Jim Blandy's avatar
Jim Blandy committed
860 861 862
{
}

863 864
/* This is called when exiting or suspending Emacs.  Exiting will make
   the X-windows go away, and suspending requires no action.  */
Jim Blandy's avatar
Jim Blandy committed
865

Andreas Schwab's avatar
Andreas Schwab committed
866
static void
867
XTreset_terminal_modes (struct terminal *terminal)
Jim Blandy's avatar
Jim Blandy committed
868 869
{
}
870 871 872 873 874 875 876 877


/***********************************************************************
			    Glyph display
 ***********************************************************************/



878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905
static void x_set_glyph_string_clipping (struct glyph_string *);
static void x_set_glyph_string_gc (struct glyph_string *);
static void x_draw_glyph_string_background (struct glyph_string *,
                                            int);
static void x_draw_glyph_string_foreground (struct glyph_string *);
static void x_draw_composite_glyph_string_foreground (struct glyph_string *);
static void x_draw_glyph_string_box (struct glyph_string *);
static void x_draw_glyph_string  (struct glyph_string *);
static void x_compute_glyph_string_overhangs (struct glyph_string *);
static void x_set_cursor_gc (struct glyph_string *);
static void x_set_mode_line_face_gc (struct glyph_string *);
static void x_set_mouse_face_gc (struct glyph_string *);
static int x_alloc_lighter_color (struct frame *, Display *, Colormap,
                                  unsigned long *, double, int);
static void x_setup_relief_color (struct frame *, struct relief *,
                                  double, int, unsigned long);
static void x_setup_relief_colors (struct glyph_string *);
static void x_draw_image_glyph_string (struct glyph_string *);
static void x_draw_image_relief (struct glyph_string *);
static void x_draw_image_foreground (struct glyph_string *);
static void x_draw_image_foreground_1 (struct glyph_string *, Pixmap);
static void x_clear_glyph_string_rect (struct glyph_string *, int,
                                       int, int, int);
static void x_draw_relief_rect (struct frame *, int, int, int, int,
                                int, int, int, int, int, int,
                                XRectangle *);
static void x_draw_box_rect (struct glyph_string *, int, int, int, int,
                             int, int, int, XRectangle *);
906 907

#if GLYPH_DEBUG
908
static void x_check_font (struct frame *, struct font *);
909
#endif
910 911 912 913 914 915


/* Set S->gc to a suitable GC for drawing glyph string S in cursor
   face.  */

static void
916
x_set_cursor_gc (struct glyph_string *s)
917 918 919 920
{
  if (s->font == FRAME_FONT (s->f)
      && s->face->background == FRAME_BACKGROUND_PIXEL (s->f)
      && s->face->foreground == FRAME_FOREGROUND_PIXEL (s->f)
921
      && !s->cmp)
922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949
    s->gc = s->f->output_data.x->cursor_gc;
  else
    {
      /* Cursor on non-default face: must merge.  */
      XGCValues xgcv;
      unsigned long mask;

      xgcv.background = s->f->output_data.x->cursor_pixel;
      xgcv.foreground = s->face->background;

      /* If the glyph would be invisible, try a different foreground.  */
      if (xgcv.foreground == xgcv.background)
	xgcv.foreground = s->face->foreground;
      if (xgcv.foreground == xgcv.background)
	xgcv.foreground = s->f->output_data.x->cursor_foreground_pixel;
      if (xgcv.foreground == xgcv.background)
	xgcv.foreground = s->face->foreground;

      /* Make sure the cursor is distinct from text in this face.  */
      if (xgcv.background == s->face->background
	  && xgcv.foreground == s->face->foreground)
	{
	  xgcv.background = s->face->foreground;
	  xgcv.foreground = s->face->background;
	}

      IF_DEBUG (x_check_font (s->f, s->font));
      xgcv.graphics_exposures = False;
950
      mask = GCForeground | GCBackground | GCGraphicsExposures;
951 952 953 954 955 956 957 958 959 960 961 962 963 964

      if (FRAME_X_DISPLAY_INFO (s->f)->scratch_cursor_gc)
	XChangeGC (s->display, FRAME_X_DISPLAY_INFO (s->f)->scratch_cursor_gc,
		   mask, &xgcv);
      else
	FRAME_X_DISPLAY_INFO (s->f)->scratch_cursor_gc
	  = XCreateGC (s->display, s->window, mask, &xgcv);

      s->gc = FRAME_X_DISPLAY_INFO (s->f)->scratch_cursor_gc;
    }
}


/* Set up S->gc of glyph string S for drawing text in mouse face.  */
Juanma Barranquero's avatar
Juanma Barranquero committed
965

966
static void
967
x_set_mouse_face_gc (struct glyph_string *s)
Juanma Barranquero's avatar
Juanma Barranquero committed
968
{
969
  int face_id;
970
  struct face *face;
971

972
  /* What face has to be used last for the mouse face?  */
973
  face_id = MOUSE_HL_INFO (s->f)->mouse_face_face_id;
974
  face = FACE_FROM_ID (s->f, face_id);
975 976
  if (face == NULL)
    face = FACE_FROM_ID (s->f, MOUSE_FACE_ID);
Juanma Barranquero's avatar
Juanma Barranquero committed
977

978
  if (s->first_glyph->type == CHAR_GLYPH)
979
    face_id = FACE_FOR_CHAR (s->f, face, s->first_glyph->u.ch, -1, Qnil);
980
  else
981
    face_id = FACE_FOR_CHAR (s->f, face, 0, -1, Qnil);
982 983 984 985 986 987 988 989
  s->face = FACE_FROM_ID (s->f, face_id);
  PREPARE_FACE_FOR_DISPLAY (s->f, s->face);

  if (s->font == s->face->font)
    s->gc = s->face->gc;
  else
    {
      /* Otherwise construct scratch_cursor_gc with values from FACE
990
	 except for FONT.  */
991 992
      XGCValues xgcv;
      unsigned long mask;
Juanma Barranquero's avatar
Juanma Barranquero committed
993

994 995 996
      xgcv.background = s->face->background;
      xgcv.foreground = s->face->foreground;
      xgcv.graphics_exposures = False;
997
      mask = GCForeground | GCBackground | GCGraphicsExposures;
Juanma Barranquero's avatar
Juanma Barranquero committed
998

999 1000 1001 1002 1003 1004
      if (FRAME_X_DISPLAY_INFO (s->f)->scratch_cursor_gc)
	XChangeGC (s->display, FRAME_X_DISPLAY_INFO (s->f)->scratch_cursor_gc,
		   mask, &xgcv);
      else
	FRAME_X_DISPLAY_INFO (s->f)->scratch_cursor_gc
	  = XCreateGC (s->display, s->window, mask, &xgcv);
Juanma Barranquero's avatar
Juanma Barranquero committed
1005

1006 1007
      s->gc = FRAME_X_DISPLAY_INFO (s->f)->scratch_cursor_gc;

1008
    }
1009 1010 1011 1012 1013 1014 1015 1016 1017
  xassert (s->gc != 0);
}


/* Set S->gc of glyph string S to a GC suitable for drawing a mode line.
   Faces to use in the mode line have already been computed when the
   matrix was built, so there isn't much to do, here.  */

static INLINE void
1018
x_set_mode_line_face_gc (struct glyph_string *s)
Juanma Barranquero's avatar
Juanma Barranquero committed
1019
{
1020 1021 1022 1023 1024 1025 1026 1027 1028
  s->gc = s->face->gc;
}


/* Set S->gc of glyph string S for drawing that glyph string.  Set
   S->stippled_p to a non-zero value if the face of S has a stipple
   pattern.  */

static INLINE void
1029
x_set_glyph_string_gc (struct glyph_string *s)
1030
{
1031
  PREPARE_FACE_FOR_DISPLAY (s->f, s->face);
Juanma Barranquero's avatar
Juanma Barranquero committed
1032

1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073
  if (s->hl == DRAW_NORMAL_TEXT)
    {
      s->gc = s->face->gc;
      s->stippled_p = s->face->stipple != 0;
    }
  else if (s->hl == DRAW_INVERSE_VIDEO)
    {
      x_set_mode_line_face_gc (s);
      s->stippled_p = s->face->stipple != 0;
    }
  else if (s->hl == DRAW_CURSOR)
    {
      x_set_cursor_gc (s);
      s->stippled_p = 0;
    }
  else if (s->hl == DRAW_MOUSE_FACE)
    {
      x_set_mouse_face_gc (s);
      s->stippled_p = s->face->stipple != 0;
    }
  else if (s->hl == DRAW_IMAGE_RAISED
	   || s->hl == DRAW_IMAGE_SUNKEN)
    {
      s->gc = s->face->gc;
      s->stippled_p = s->face->stipple != 0;
    }
  else
    {
      s->gc = s->face->gc;
      s->stippled_p = s->face->stipple != 0;
    }

  /* GC must have been set.  */
  xassert (s->gc != 0);
}


/* Set clipping for output of glyph string S.  S may be part of a mode
   line or menu if we don't have X toolkit support.  */

static INLINE void
1074
x_set_glyph_string_clipping (struct glyph_string *s)
1075
{
1076 1077 1078 1079 1080 1081
  XRectangle *r = s->clip;
  int n = get_glyph_string_clip_rects (s, r, 2);

  if (n > 0)
    XSetClipRectangles (s->display, s->gc, 0, 0, r, n, Unsorted);
  s->num_clips = n;
1082 1083 1084
}


1085 1086 1087 1088 1089
/* Set SRC's clipping for output of glyph string DST.  This is called
   when we are drawing DST's left_overhang or right_overhang only in
   the area of SRC.  */

static void
1090
x_set_glyph_string_clipping_exactly (struct glyph_string *src, struct glyph_string *dst)
1091 1092
{
  XRectangle r;
Kenichi Handa's avatar
Kenichi Handa committed
1093

1094 1095 1096 1097 1098 1099
  r.x = src->x;
  r.width = src->width;
  r.y = src->y;
  r.height = src->height;
  dst->clip[0] = r;
  dst->num_clips = 1;
1100 1101 1102 1103
  XSetClipRectangles (dst->display, dst->gc, 0, 0, &r, 1, Unsorted);
}


1104
/* RIF:
1105
   Compute left and right overhang of glyph string S.  */
1106

1107
static void
1108
x_compute_glyph_string_overhangs (struct glyph_string *s)
1109
{
1110
  if (s->cmp == NULL
1111 1112
      && (s->first_glyph->type == CHAR_GLYPH
	  || s->first_glyph->type == COMPOSITE_GLYPH))
1113
    {
1114
      struct font_metrics metrics;
Kenichi Handa's avatar
Kenichi Handa committed
1115

1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131
      if (s->first_glyph->type == CHAR_GLYPH)
	{
	  unsigned *code = alloca (sizeof (unsigned) * s->nchars);
	  struct font *font = s->font;
	  int i;

	  for (i = 0; i < s->nchars; i++)
	    code[i] = (s->char2b[i].byte1 << 8) | s->char2b[i].byte2;
	  font->driver->text_extents (font, code, s->nchars, &metrics);
	}
      else
	{
	  Lisp_Object gstring = composition_gstring_from_id (s->cmp_id);

	  composition_gstring_width (gstring, s->cmp_from, s->cmp_to, &metrics);
	}
1132 1133 1134
      s->right_overhang = (metrics.rbearing > metrics.width
			   ? metrics.rbearing - metrics.width : 0);
      s->left_overhang = metrics.lbearing < 0 ? - metrics.lbearing : 0;
1135
    }
1136 1137 1138 1139 1140
  else if (s->cmp)
    {
      s->right_overhang = s->cmp->rbearing - s->cmp->pixel_width;
      s->left_overhang = - s->cmp->lbearing;
    }
1141 1142 1143 1144 1145 1146
}


/* Fill rectangle X, Y, W, H with background color of glyph string S.  */

static INLINE void
1147
x_clear_glyph_string_rect (struct glyph_string *s, int x, int y, int w, int h)
1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159
{
  XGCValues xgcv;
  XGetGCValues (s->display, s->gc, GCForeground | GCBackground, &xgcv);
  XSetForeground (s->display, s->gc, xgcv.background);
  XFillRectangle (s->display, s->window, s->gc, x, y, w, h);
  XSetForeground (s->display, s->gc, xgcv.foreground);
}


/* Draw the background of glyph_string S.  If S->background_filled_p
   is non-zero don't draw it.  FORCE_P non-zero means draw the
   background even if it wouldn't be drawn normally.  This is used
1160 1161
   when a string preceding S draws into the background of S, or S
   contains the first component of a composition.  */
1162