]> code.delx.au - gnu-emacs/blob - src/xfns.c
Merge from origin/emacs-24
[gnu-emacs] / src / xfns.c
1 /* Functions for the X window system.
2
3 Copyright (C) 1989, 1992-2015 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 #include <config.h>
21 #include <stdio.h>
22 #include <math.h>
23 #include <unistd.h>
24
25 #include "lisp.h"
26 #include "xterm.h"
27 #include "menu.h"
28 #include "frame.h"
29 #include "window.h"
30 #include "character.h"
31 #include "buffer.h"
32 #include "intervals.h"
33 #include "dispextern.h"
34 #include "keyboard.h"
35 #include "blockinput.h"
36 #include <epaths.h>
37 #include "charset.h"
38 #include "coding.h"
39 #include "fontset.h"
40 #include "systime.h"
41 #include "termhooks.h"
42 #include "atimer.h"
43 #include "termchar.h"
44 #include "font.h"
45
46 #include <sys/types.h>
47 #include <sys/stat.h>
48
49 #include "bitmaps/gray.xbm"
50 #include "xsettings.h"
51
52 #ifdef HAVE_XRANDR
53 #include <X11/extensions/Xrandr.h>
54 #endif
55 #ifdef HAVE_XINERAMA
56 #include <X11/extensions/Xinerama.h>
57 #endif
58
59 #ifdef USE_GTK
60 #include "gtkutil.h"
61 #endif
62
63 #ifdef USE_X_TOOLKIT
64 #include <X11/Shell.h>
65
66 #ifndef USE_MOTIF
67 #ifdef HAVE_XAW3D
68 #include <X11/Xaw3d/Paned.h>
69 #include <X11/Xaw3d/Label.h>
70 #else /* !HAVE_XAW3D */
71 #include <X11/Xaw/Paned.h>
72 #include <X11/Xaw/Label.h>
73 #endif /* HAVE_XAW3D */
74 #endif /* USE_MOTIF */
75
76 #ifdef USG
77 #undef USG /* ####KLUDGE for Solaris 2.2 and up */
78 #include <X11/Xos.h>
79 #define USG
80 #ifdef USG /* Pacify gcc -Wunused-macros. */
81 #endif
82 #else
83 #include <X11/Xos.h>
84 #endif
85
86 #include "widget.h"
87
88 #include "../lwlib/lwlib.h"
89
90 #ifdef USE_MOTIF
91 #include <Xm/Xm.h>
92 #include <Xm/DialogS.h>
93 #include <Xm/FileSB.h>
94 #include <Xm/List.h>
95 #include <Xm/TextF.h>
96 #endif
97
98 #ifdef USE_LUCID
99 #include "../lwlib/xlwmenu.h"
100 #endif
101
102 #if !defined (NO_EDITRES)
103 #define HACK_EDITRES
104 extern void _XEditResCheckMessages (Widget, XtPointer, XEvent *, Boolean *);
105 #endif /* not defined NO_EDITRES */
106
107 /* Unique id counter for widgets created by the Lucid Widget Library. */
108
109 extern LWLIB_ID widget_id_tick;
110
111 #ifdef USE_MOTIF
112
113 #endif /* USE_MOTIF */
114
115 #endif /* USE_X_TOOLKIT */
116
117 #ifdef USE_GTK
118
119 #endif /* USE_GTK */
120
121 #define MAXREQUEST(dpy) (XMaxRequestSize (dpy))
122
123 #ifdef GLYPH_DEBUG
124 static ptrdiff_t image_cache_refcount;
125 static int dpyinfo_refcount;
126 #endif
127
128 static struct x_display_info *x_display_info_for_name (Lisp_Object);
129
130 /* Let the user specify an X display with a Lisp object.
131 OBJECT may be nil, a frame or a terminal object.
132 nil stands for the selected frame--or, if that is not an X frame,
133 the first X display on the list. */
134
135 struct x_display_info *
136 check_x_display_info (Lisp_Object object)
137 {
138 struct x_display_info *dpyinfo = NULL;
139
140 if (NILP (object))
141 {
142 struct frame *sf = XFRAME (selected_frame);
143
144 if (FRAME_X_P (sf) && FRAME_LIVE_P (sf))
145 dpyinfo = FRAME_DISPLAY_INFO (sf);
146 else if (x_display_list != 0)
147 dpyinfo = x_display_list;
148 else
149 error ("X windows are not in use or not initialized");
150 }
151 else if (TERMINALP (object))
152 {
153 struct terminal *t = decode_live_terminal (object);
154
155 if (t->type != output_x_window)
156 error ("Terminal %d is not an X display", t->id);
157
158 dpyinfo = t->display_info.x;
159 }
160 else if (STRINGP (object))
161 dpyinfo = x_display_info_for_name (object);
162 else
163 {
164 struct frame *f = decode_window_system_frame (object);
165 dpyinfo = FRAME_DISPLAY_INFO (f);
166 }
167
168 return dpyinfo;
169 }
170
171 /* Return the screen positions and offsets of frame F.
172 Store the offsets between FRAME_OUTER_WINDOW and the containing
173 window manager window into LEFT_OFFSET_X, RIGHT_OFFSET_X,
174 TOP_OFFSET_Y and BOTTOM_OFFSET_Y.
175 Store the offsets between FRAME_X_WINDOW and the containing
176 window manager window into X_PIXELS_DIFF and Y_PIXELS_DIFF.
177 Store the screen positions of frame F into XPTR and YPTR.
178 These are the positions of the containing window manager window,
179 not Emacs's own window. */
180 void
181 x_real_pos_and_offsets (struct frame *f,
182 int *left_offset_x,
183 int *right_offset_x,
184 int *top_offset_y,
185 int *bottom_offset_y,
186 int *x_pixels_diff,
187 int *y_pixels_diff,
188 int *xptr,
189 int *yptr)
190 {
191 int win_x, win_y, outer_x IF_LINT (= 0), outer_y IF_LINT (= 0);
192 int real_x = 0, real_y = 0;
193 bool had_errors = false;
194 Window win = f->output_data.x->parent_desc;
195 Atom actual_type;
196 unsigned long actual_size, bytes_remaining;
197 int rc, actual_format;
198 struct x_display_info *dpyinfo = FRAME_DISPLAY_INFO (f);
199 long max_len = 400;
200 Display *dpy = FRAME_X_DISPLAY (f);
201 unsigned char *tmp_data = NULL;
202 Atom target_type = XA_CARDINAL;
203 unsigned int ow IF_LINT (= 0), oh IF_LINT (= 0);
204
205 block_input ();
206
207 x_catch_errors (dpy);
208
209 if (win == dpyinfo->root_window)
210 win = FRAME_OUTER_WINDOW (f);
211
212 /* This loop traverses up the containment tree until we hit the root
213 window. Window managers may intersect many windows between our window
214 and the root window. The window we find just before the root window
215 should be the outer WM window. */
216 for (;;)
217 {
218 Window wm_window, rootw;
219 Window *tmp_children;
220 unsigned int tmp_nchildren;
221 int success;
222
223 success = XQueryTree (FRAME_X_DISPLAY (f), win, &rootw,
224 &wm_window, &tmp_children, &tmp_nchildren);
225
226 had_errors = x_had_errors_p (FRAME_X_DISPLAY (f));
227
228 /* Don't free tmp_children if XQueryTree failed. */
229 if (! success)
230 break;
231
232 XFree (tmp_children);
233
234 if (wm_window == rootw || had_errors)
235 break;
236
237 win = wm_window;
238 }
239
240 if (! had_errors)
241 {
242 unsigned int ign;
243 Window child, rootw;
244
245 /* Get the real coordinates for the WM window upper left corner */
246 XGetGeometry (FRAME_X_DISPLAY (f), win,
247 &rootw, &real_x, &real_y, &ow, &oh, &ign, &ign);
248
249 /* Translate real coordinates to coordinates relative to our
250 window. For our window, the upper left corner is 0, 0.
251 Since the upper left corner of the WM window is outside
252 our window, win_x and win_y will be negative:
253
254 ------------------ ---> x
255 | title |
256 | ----------------- v y
257 | | our window
258 */
259 XTranslateCoordinates (FRAME_X_DISPLAY (f),
260
261 /* From-window, to-window. */
262 FRAME_DISPLAY_INFO (f)->root_window,
263 FRAME_X_WINDOW (f),
264
265 /* From-position, to-position. */
266 real_x, real_y, &win_x, &win_y,
267
268 /* Child of win. */
269 &child);
270
271 if (FRAME_X_WINDOW (f) == FRAME_OUTER_WINDOW (f))
272 {
273 outer_x = win_x;
274 outer_y = win_y;
275 }
276 else
277 {
278 XTranslateCoordinates (FRAME_X_DISPLAY (f),
279
280 /* From-window, to-window. */
281 FRAME_DISPLAY_INFO (f)->root_window,
282 FRAME_OUTER_WINDOW (f),
283
284 /* From-position, to-position. */
285 real_x, real_y, &outer_x, &outer_y,
286
287 /* Child of win. */
288 &child);
289 }
290
291 had_errors = x_had_errors_p (FRAME_X_DISPLAY (f));
292 }
293
294
295 if (dpyinfo->root_window == f->output_data.x->parent_desc)
296 {
297 /* Try _NET_FRAME_EXTENTS if our parent is the root window. */
298 rc = XGetWindowProperty (dpy, win, dpyinfo->Xatom_net_frame_extents,
299 0, max_len, False, target_type,
300 &actual_type, &actual_format, &actual_size,
301 &bytes_remaining, &tmp_data);
302
303 if (rc == Success && actual_type == target_type && !x_had_errors_p (dpy)
304 && actual_size == 4 && actual_format == 32)
305 {
306 unsigned int ign;
307 Window rootw;
308 long *fe = (long *)tmp_data;
309
310 XGetGeometry (FRAME_X_DISPLAY (f), win,
311 &rootw, &real_x, &real_y, &ign, &ign, &ign, &ign);
312 outer_x = -fe[0];
313 outer_y = -fe[2];
314 real_x -= fe[0];
315 real_y -= fe[2];
316 }
317 }
318
319 if (tmp_data) XFree (tmp_data);
320
321 x_uncatch_errors ();
322
323 unblock_input ();
324
325 if (had_errors) return;
326
327 if (x_pixels_diff) *x_pixels_diff = -win_x;
328 if (y_pixels_diff) *y_pixels_diff = -win_y;
329
330 if (left_offset_x) *left_offset_x = -outer_x;
331 if (top_offset_y) *top_offset_y = -outer_x;
332
333 if (xptr) *xptr = real_x;
334 if (yptr) *yptr = real_y;
335
336 if (right_offset_x || bottom_offset_y)
337 {
338 int xy_ign;
339 unsigned int ign, fw, fh;
340 Window rootw;
341
342 XGetGeometry (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f),
343 &rootw, &xy_ign, &xy_ign, &fw, &fh, &ign, &ign);
344 if (right_offset_x) *right_offset_x = ow - fw + outer_x;
345 if (bottom_offset_y) *bottom_offset_y = oh - fh + outer_y;
346 }
347 }
348
349 /* Store the screen positions of frame F into XPTR and YPTR.
350 These are the positions of the containing window manager window,
351 not Emacs's own window. */
352
353 void
354 x_real_positions (struct frame *f, int *xptr, int *yptr)
355 {
356 x_real_pos_and_offsets (f, NULL, NULL, NULL, NULL, NULL, NULL, xptr, yptr);
357 }
358
359
360 /* Get the mouse position in frame relative coordinates. */
361
362 void
363 x_relative_mouse_position (struct frame *f, int *x, int *y)
364 {
365 Window root, dummy_window;
366 int dummy;
367
368 eassert (FRAME_X_P (f));
369
370 block_input ();
371
372 XQueryPointer (FRAME_X_DISPLAY (f),
373 DefaultRootWindow (FRAME_X_DISPLAY (f)),
374
375 /* The root window which contains the pointer. */
376 &root,
377
378 /* Window pointer is on, not used */
379 &dummy_window,
380
381 /* The position on that root window. */
382 x, y,
383
384 /* x/y in dummy_window coordinates, not used. */
385 &dummy, &dummy,
386
387 /* Modifier keys and pointer buttons, about which
388 we don't care. */
389 (unsigned int *) &dummy);
390
391 XTranslateCoordinates (FRAME_X_DISPLAY (f),
392
393 /* From-window, to-window. */
394 FRAME_DISPLAY_INFO (f)->root_window,
395 FRAME_X_WINDOW (f),
396
397 /* From-position, to-position. */
398 *x, *y, x, y,
399
400 /* Child of win. */
401 &dummy_window);
402
403 unblock_input ();
404 }
405
406 /* Gamma-correct COLOR on frame F. */
407
408 void
409 gamma_correct (struct frame *f, XColor *color)
410 {
411 if (f->gamma)
412 {
413 color->red = pow (color->red / 65535.0, f->gamma) * 65535.0 + 0.5;
414 color->green = pow (color->green / 65535.0, f->gamma) * 65535.0 + 0.5;
415 color->blue = pow (color->blue / 65535.0, f->gamma) * 65535.0 + 0.5;
416 }
417 }
418
419
420 /* Decide if color named COLOR_NAME is valid for use on frame F. If
421 so, return the RGB values in COLOR. If ALLOC_P,
422 allocate the color. Value is false if COLOR_NAME is invalid, or
423 no color could be allocated. */
424
425 bool
426 x_defined_color (struct frame *f, const char *color_name,
427 XColor *color, bool alloc_p)
428 {
429 bool success_p = false;
430 Display *dpy = FRAME_X_DISPLAY (f);
431 Colormap cmap = FRAME_X_COLORMAP (f);
432
433 block_input ();
434 #ifdef USE_GTK
435 success_p = xg_check_special_colors (f, color_name, color);
436 #endif
437 if (!success_p)
438 success_p = XParseColor (dpy, cmap, color_name, color) != 0;
439 if (success_p && alloc_p)
440 success_p = x_alloc_nearest_color (f, cmap, color);
441 unblock_input ();
442
443 return success_p;
444 }
445
446
447 /* Return the pixel color value for color COLOR_NAME on frame F. If F
448 is a monochrome frame, return MONO_COLOR regardless of what ARG says.
449 Signal an error if color can't be allocated. */
450
451 static int
452 x_decode_color (struct frame *f, Lisp_Object color_name, int mono_color)
453 {
454 XColor cdef;
455
456 CHECK_STRING (color_name);
457
458 #if false /* Don't do this. It's wrong when we're not using the default
459 colormap, it makes freeing difficult, and it's probably not
460 an important optimization. */
461 if (strcmp (SDATA (color_name), "black") == 0)
462 return BLACK_PIX_DEFAULT (f);
463 else if (strcmp (SDATA (color_name), "white") == 0)
464 return WHITE_PIX_DEFAULT (f);
465 #endif
466
467 /* Return MONO_COLOR for monochrome frames. */
468 if (FRAME_DISPLAY_INFO (f)->n_planes == 1)
469 return mono_color;
470
471 /* x_defined_color is responsible for coping with failures
472 by looking for a near-miss. */
473 if (x_defined_color (f, SSDATA (color_name), &cdef, true))
474 return cdef.pixel;
475
476 signal_error ("Undefined color", color_name);
477 }
478
479
480 \f
481 /* Change the `wait-for-wm' frame parameter of frame F. OLD_VALUE is
482 the previous value of that parameter, NEW_VALUE is the new value.
483 See also the comment of wait_for_wm in struct x_output. */
484
485 static void
486 x_set_wait_for_wm (struct frame *f, Lisp_Object new_value, Lisp_Object old_value)
487 {
488 f->output_data.x->wait_for_wm = !NILP (new_value);
489 }
490
491 static void
492 x_set_tool_bar_position (struct frame *f,
493 Lisp_Object new_value,
494 Lisp_Object old_value)
495 {
496 Lisp_Object choice = list4 (Qleft, Qright, Qtop, Qbottom);
497
498 if (!NILP (Fmemq (new_value, choice)))
499 {
500 #ifdef USE_GTK
501 if (!EQ (new_value, old_value))
502 {
503 xg_change_toolbar_position (f, new_value);
504 fset_tool_bar_position (f, new_value);
505 }
506 #else
507 if (!EQ (new_value, Qtop))
508 error ("The only supported tool bar position is top");
509 #endif
510 }
511 else
512 wrong_choice (choice, new_value);
513 }
514
515 #ifdef USE_GTK
516
517 /* Set icon from FILE for frame F. By using GTK functions the icon
518 may be any format that GdkPixbuf knows about, i.e. not just bitmaps. */
519
520 bool
521 xg_set_icon (struct frame *f, Lisp_Object file)
522 {
523 bool result = false;
524 Lisp_Object found;
525
526 found = x_find_image_file (file);
527
528 if (! NILP (found))
529 {
530 GdkPixbuf *pixbuf;
531 GError *err = NULL;
532 char *filename = SSDATA (found);
533 block_input ();
534
535 pixbuf = gdk_pixbuf_new_from_file (filename, &err);
536
537 if (pixbuf)
538 {
539 gtk_window_set_icon (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)),
540 pixbuf);
541 g_object_unref (pixbuf);
542
543 result = true;
544 }
545 else
546 g_error_free (err);
547
548 unblock_input ();
549 }
550
551 return result;
552 }
553
554 bool
555 xg_set_icon_from_xpm_data (struct frame *f, const char **data)
556 {
557 GdkPixbuf *pixbuf = gdk_pixbuf_new_from_xpm_data (data);
558
559 if (!pixbuf)
560 return false;
561
562 gtk_window_set_icon (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)), pixbuf);
563 g_object_unref (pixbuf);
564 return true;
565 }
566 #endif /* USE_GTK */
567
568
569 /* Functions called only from `x_set_frame_param'
570 to set individual parameters.
571
572 If FRAME_X_WINDOW (f) is 0,
573 the frame is being created and its X-window does not exist yet.
574 In that case, just record the parameter's new value
575 in the standard place; do not attempt to change the window. */
576
577 static void
578 x_set_foreground_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
579 {
580 struct x_output *x = f->output_data.x;
581 unsigned long fg, old_fg;
582
583 fg = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
584 old_fg = FRAME_FOREGROUND_PIXEL (f);
585 FRAME_FOREGROUND_PIXEL (f) = fg;
586
587 if (FRAME_X_WINDOW (f) != 0)
588 {
589 Display *dpy = FRAME_X_DISPLAY (f);
590
591 block_input ();
592 XSetForeground (dpy, x->normal_gc, fg);
593 XSetBackground (dpy, x->reverse_gc, fg);
594
595 if (x->cursor_pixel == old_fg)
596 {
597 unload_color (f, x->cursor_pixel);
598 x->cursor_pixel = x_copy_color (f, fg);
599 XSetBackground (dpy, x->cursor_gc, x->cursor_pixel);
600 }
601
602 unblock_input ();
603
604 update_face_from_frame_parameter (f, Qforeground_color, arg);
605
606 if (FRAME_VISIBLE_P (f))
607 redraw_frame (f);
608 }
609
610 unload_color (f, old_fg);
611 }
612
613 static void
614 x_set_background_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
615 {
616 struct x_output *x = f->output_data.x;
617 unsigned long bg;
618
619 bg = x_decode_color (f, arg, WHITE_PIX_DEFAULT (f));
620 unload_color (f, FRAME_BACKGROUND_PIXEL (f));
621 FRAME_BACKGROUND_PIXEL (f) = bg;
622
623 if (FRAME_X_WINDOW (f) != 0)
624 {
625 Display *dpy = FRAME_X_DISPLAY (f);
626
627 block_input ();
628 XSetBackground (dpy, x->normal_gc, bg);
629 XSetForeground (dpy, x->reverse_gc, bg);
630 XSetWindowBackground (dpy, FRAME_X_WINDOW (f), bg);
631 XSetForeground (dpy, x->cursor_gc, bg);
632
633 #ifdef USE_GTK
634 xg_set_background_color (f, bg);
635 #endif
636
637 #ifndef USE_TOOLKIT_SCROLL_BARS /* Turns out to be annoying with
638 toolkit scroll bars. */
639 {
640 Lisp_Object bar;
641 for (bar = FRAME_SCROLL_BARS (f);
642 !NILP (bar);
643 bar = XSCROLL_BAR (bar)->next)
644 {
645 Window window = XSCROLL_BAR (bar)->x_window;
646 XSetWindowBackground (dpy, window, bg);
647 }
648 }
649 #endif /* USE_TOOLKIT_SCROLL_BARS */
650
651 unblock_input ();
652 update_face_from_frame_parameter (f, Qbackground_color, arg);
653
654 if (FRAME_VISIBLE_P (f))
655 redraw_frame (f);
656 }
657 }
658
659 static void
660 x_set_mouse_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
661 {
662 struct x_output *x = f->output_data.x;
663 Display *dpy = FRAME_X_DISPLAY (f);
664 Cursor cursor, nontext_cursor, mode_cursor, hand_cursor;
665 Cursor hourglass_cursor, horizontal_drag_cursor, vertical_drag_cursor;
666 unsigned long pixel = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
667 unsigned long mask_color = FRAME_BACKGROUND_PIXEL (f);
668
669 /* Don't let pointers be invisible. */
670 if (mask_color == pixel)
671 {
672 x_free_colors (f, &pixel, 1);
673 pixel = x_copy_color (f, FRAME_FOREGROUND_PIXEL (f));
674 }
675
676 unload_color (f, x->mouse_pixel);
677 x->mouse_pixel = pixel;
678
679 block_input ();
680
681 /* It's not okay to crash if the user selects a screwy cursor. */
682 x_catch_errors (dpy);
683
684 if (!NILP (Vx_pointer_shape))
685 {
686 CHECK_NUMBER (Vx_pointer_shape);
687 cursor = XCreateFontCursor (dpy, XINT (Vx_pointer_shape));
688 }
689 else
690 cursor = XCreateFontCursor (dpy, XC_xterm);
691 x_check_errors (dpy, "bad text pointer cursor: %s");
692
693 if (!NILP (Vx_nontext_pointer_shape))
694 {
695 CHECK_NUMBER (Vx_nontext_pointer_shape);
696 nontext_cursor
697 = XCreateFontCursor (dpy, XINT (Vx_nontext_pointer_shape));
698 }
699 else
700 nontext_cursor = XCreateFontCursor (dpy, XC_left_ptr);
701 x_check_errors (dpy, "bad nontext pointer cursor: %s");
702
703 if (!NILP (Vx_hourglass_pointer_shape))
704 {
705 CHECK_NUMBER (Vx_hourglass_pointer_shape);
706 hourglass_cursor
707 = XCreateFontCursor (dpy, XINT (Vx_hourglass_pointer_shape));
708 }
709 else
710 hourglass_cursor = XCreateFontCursor (dpy, XC_watch);
711 x_check_errors (dpy, "bad hourglass pointer cursor: %s");
712
713 if (!NILP (Vx_mode_pointer_shape))
714 {
715 CHECK_NUMBER (Vx_mode_pointer_shape);
716 mode_cursor = XCreateFontCursor (dpy, XINT (Vx_mode_pointer_shape));
717 }
718 else
719 mode_cursor = XCreateFontCursor (dpy, XC_xterm);
720 x_check_errors (dpy, "bad modeline pointer cursor: %s");
721
722 if (!NILP (Vx_sensitive_text_pointer_shape))
723 {
724 CHECK_NUMBER (Vx_sensitive_text_pointer_shape);
725 hand_cursor
726 = XCreateFontCursor (dpy, XINT (Vx_sensitive_text_pointer_shape));
727 }
728 else
729 hand_cursor = XCreateFontCursor (dpy, XC_hand2);
730
731 if (!NILP (Vx_window_horizontal_drag_shape))
732 {
733 CHECK_TYPE_RANGED_INTEGER (unsigned, Vx_window_horizontal_drag_shape);
734 horizontal_drag_cursor
735 = XCreateFontCursor (dpy, XINT (Vx_window_horizontal_drag_shape));
736 }
737 else
738 horizontal_drag_cursor
739 = XCreateFontCursor (dpy, XC_sb_h_double_arrow);
740
741 if (!NILP (Vx_window_vertical_drag_shape))
742 {
743 CHECK_NUMBER (Vx_window_vertical_drag_shape);
744 vertical_drag_cursor
745 = XCreateFontCursor (dpy, XINT (Vx_window_vertical_drag_shape));
746 }
747 else
748 vertical_drag_cursor
749 = XCreateFontCursor (dpy, XC_sb_v_double_arrow);
750
751 /* Check and report errors with the above calls. */
752 x_check_errors (dpy, "can't set cursor shape: %s");
753 x_uncatch_errors ();
754
755 {
756 XColor fore_color, back_color;
757
758 fore_color.pixel = x->mouse_pixel;
759 x_query_color (f, &fore_color);
760 back_color.pixel = mask_color;
761 x_query_color (f, &back_color);
762
763 XRecolorCursor (dpy, cursor, &fore_color, &back_color);
764 XRecolorCursor (dpy, nontext_cursor, &fore_color, &back_color);
765 XRecolorCursor (dpy, mode_cursor, &fore_color, &back_color);
766 XRecolorCursor (dpy, hand_cursor, &fore_color, &back_color);
767 XRecolorCursor (dpy, hourglass_cursor, &fore_color, &back_color);
768 XRecolorCursor (dpy, horizontal_drag_cursor, &fore_color, &back_color);
769 XRecolorCursor (dpy, vertical_drag_cursor, &fore_color, &back_color);
770 }
771
772 if (FRAME_X_WINDOW (f) != 0)
773 XDefineCursor (dpy, FRAME_X_WINDOW (f),
774 f->output_data.x->current_cursor = cursor);
775
776 if (cursor != x->text_cursor
777 && x->text_cursor != 0)
778 XFreeCursor (dpy, x->text_cursor);
779 x->text_cursor = cursor;
780
781 if (nontext_cursor != x->nontext_cursor
782 && x->nontext_cursor != 0)
783 XFreeCursor (dpy, x->nontext_cursor);
784 x->nontext_cursor = nontext_cursor;
785
786 if (hourglass_cursor != x->hourglass_cursor
787 && x->hourglass_cursor != 0)
788 XFreeCursor (dpy, x->hourglass_cursor);
789 x->hourglass_cursor = hourglass_cursor;
790
791 if (mode_cursor != x->modeline_cursor
792 && x->modeline_cursor != 0)
793 XFreeCursor (dpy, f->output_data.x->modeline_cursor);
794 x->modeline_cursor = mode_cursor;
795
796 if (hand_cursor != x->hand_cursor
797 && x->hand_cursor != 0)
798 XFreeCursor (dpy, x->hand_cursor);
799 x->hand_cursor = hand_cursor;
800
801 if (horizontal_drag_cursor != x->horizontal_drag_cursor
802 && x->horizontal_drag_cursor != 0)
803 XFreeCursor (dpy, x->horizontal_drag_cursor);
804 x->horizontal_drag_cursor = horizontal_drag_cursor;
805
806 if (vertical_drag_cursor != x->vertical_drag_cursor
807 && x->vertical_drag_cursor != 0)
808 XFreeCursor (dpy, x->vertical_drag_cursor);
809 x->vertical_drag_cursor = vertical_drag_cursor;
810
811 XFlush (dpy);
812 unblock_input ();
813
814 update_face_from_frame_parameter (f, Qmouse_color, arg);
815 }
816
817 static void
818 x_set_cursor_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
819 {
820 unsigned long fore_pixel, pixel;
821 bool fore_pixel_allocated_p = false, pixel_allocated_p = false;
822 struct x_output *x = f->output_data.x;
823
824 if (!NILP (Vx_cursor_fore_pixel))
825 {
826 fore_pixel = x_decode_color (f, Vx_cursor_fore_pixel,
827 WHITE_PIX_DEFAULT (f));
828 fore_pixel_allocated_p = true;
829 }
830 else
831 fore_pixel = FRAME_BACKGROUND_PIXEL (f);
832
833 pixel = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
834 pixel_allocated_p = true;
835
836 /* Make sure that the cursor color differs from the background color. */
837 if (pixel == FRAME_BACKGROUND_PIXEL (f))
838 {
839 if (pixel_allocated_p)
840 {
841 x_free_colors (f, &pixel, 1);
842 pixel_allocated_p = false;
843 }
844
845 pixel = x->mouse_pixel;
846 if (pixel == fore_pixel)
847 {
848 if (fore_pixel_allocated_p)
849 {
850 x_free_colors (f, &fore_pixel, 1);
851 fore_pixel_allocated_p = false;
852 }
853 fore_pixel = FRAME_BACKGROUND_PIXEL (f);
854 }
855 }
856
857 unload_color (f, x->cursor_foreground_pixel);
858 if (!fore_pixel_allocated_p)
859 fore_pixel = x_copy_color (f, fore_pixel);
860 x->cursor_foreground_pixel = fore_pixel;
861
862 unload_color (f, x->cursor_pixel);
863 if (!pixel_allocated_p)
864 pixel = x_copy_color (f, pixel);
865 x->cursor_pixel = pixel;
866
867 if (FRAME_X_WINDOW (f) != 0)
868 {
869 block_input ();
870 XSetBackground (FRAME_X_DISPLAY (f), x->cursor_gc, x->cursor_pixel);
871 XSetForeground (FRAME_X_DISPLAY (f), x->cursor_gc, fore_pixel);
872 unblock_input ();
873
874 if (FRAME_VISIBLE_P (f))
875 {
876 x_update_cursor (f, false);
877 x_update_cursor (f, true);
878 }
879 }
880
881 update_face_from_frame_parameter (f, Qcursor_color, arg);
882 }
883 \f
884 /* Set the border-color of frame F to pixel value PIX.
885 Note that this does not fully take effect if done before
886 F has an x-window. */
887
888 static void
889 x_set_border_pixel (struct frame *f, int pix)
890 {
891 unload_color (f, f->output_data.x->border_pixel);
892 f->output_data.x->border_pixel = pix;
893
894 if (FRAME_X_WINDOW (f) != 0 && f->border_width > 0)
895 {
896 block_input ();
897 XSetWindowBorder (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), pix);
898 unblock_input ();
899
900 if (FRAME_VISIBLE_P (f))
901 redraw_frame (f);
902 }
903 }
904
905 /* Set the border-color of frame F to value described by ARG.
906 ARG can be a string naming a color.
907 The border-color is used for the border that is drawn by the X server.
908 Note that this does not fully take effect if done before
909 F has an x-window; it must be redone when the window is created.
910
911 Note: this is done in two routines because of the way X10 works.
912
913 Note: under X11, this is normally the province of the window manager,
914 and so emacs's border colors may be overridden. */
915
916 static void
917 x_set_border_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
918 {
919 int pix;
920
921 CHECK_STRING (arg);
922 pix = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
923 x_set_border_pixel (f, pix);
924 update_face_from_frame_parameter (f, Qborder_color, arg);
925 }
926
927
928 static void
929 x_set_cursor_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
930 {
931 set_frame_cursor_types (f, arg);
932 }
933
934 static void
935 x_set_icon_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
936 {
937 bool result;
938
939 if (STRINGP (arg))
940 {
941 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
942 return;
943 }
944 else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
945 return;
946
947 block_input ();
948 if (NILP (arg))
949 result = x_text_icon (f,
950 SSDATA ((!NILP (f->icon_name)
951 ? f->icon_name
952 : f->name)));
953 else
954 result = x_bitmap_icon (f, arg);
955
956 if (result)
957 {
958 unblock_input ();
959 error ("No icon window available");
960 }
961
962 XFlush (FRAME_X_DISPLAY (f));
963 unblock_input ();
964 }
965
966 static void
967 x_set_icon_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
968 {
969 bool result;
970
971 if (STRINGP (arg))
972 {
973 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
974 return;
975 }
976 else if (!NILP (arg) || NILP (oldval))
977 return;
978
979 fset_icon_name (f, arg);
980
981 if (f->output_data.x->icon_bitmap != 0)
982 return;
983
984 block_input ();
985
986 result = x_text_icon (f,
987 SSDATA ((!NILP (f->icon_name)
988 ? f->icon_name
989 : !NILP (f->title)
990 ? f->title
991 : f->name)));
992
993 if (result)
994 {
995 unblock_input ();
996 error ("No icon window available");
997 }
998
999 XFlush (FRAME_X_DISPLAY (f));
1000 unblock_input ();
1001 }
1002
1003 \f
1004 static void
1005 x_set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
1006 {
1007 int nlines;
1008 #if ! defined (USE_X_TOOLKIT) && ! defined (USE_GTK)
1009 int olines = FRAME_MENU_BAR_LINES (f);
1010 #endif
1011
1012 /* Right now, menu bars don't work properly in minibuf-only frames;
1013 most of the commands try to apply themselves to the minibuffer
1014 frame itself, and get an error because you can't switch buffers
1015 in or split the minibuffer window. */
1016 if (FRAME_MINIBUF_ONLY_P (f))
1017 return;
1018
1019 if (TYPE_RANGED_INTEGERP (int, value))
1020 nlines = XINT (value);
1021 else
1022 nlines = 0;
1023
1024 /* Make sure we redisplay all windows in this frame. */
1025 windows_or_buffers_changed = 59;
1026
1027 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
1028 FRAME_MENU_BAR_LINES (f) = 0;
1029 FRAME_MENU_BAR_HEIGHT (f) = 0;
1030 if (nlines)
1031 {
1032 FRAME_EXTERNAL_MENU_BAR (f) = 1;
1033 if (FRAME_X_P (f) && f->output_data.x->menubar_widget == 0)
1034 /* Make sure next redisplay shows the menu bar. */
1035 XWINDOW (FRAME_SELECTED_WINDOW (f))->update_mode_line = true;
1036 }
1037 else
1038 {
1039 if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
1040 free_frame_menubar (f);
1041 FRAME_EXTERNAL_MENU_BAR (f) = 0;
1042 if (FRAME_X_P (f))
1043 f->output_data.x->menubar_widget = 0;
1044 }
1045 #else /* not USE_X_TOOLKIT && not USE_GTK */
1046 FRAME_MENU_BAR_LINES (f) = nlines;
1047 FRAME_MENU_BAR_HEIGHT (f) = nlines * FRAME_LINE_HEIGHT (f);
1048 adjust_frame_size (f, -1, -1, 2, true, Qmenu_bar_lines);
1049 if (FRAME_X_WINDOW (f))
1050 x_clear_under_internal_border (f);
1051
1052 /* If the menu bar height gets changed, the internal border below
1053 the top margin has to be cleared. Also, if the menu bar gets
1054 larger, the area for the added lines has to be cleared except for
1055 the first menu bar line that is to be drawn later. */
1056 if (nlines != olines)
1057 {
1058 int height = FRAME_INTERNAL_BORDER_WIDTH (f);
1059 int width = FRAME_PIXEL_WIDTH (f);
1060 int y;
1061
1062 /* height can be zero here. */
1063 if (FRAME_X_WINDOW (f) && height > 0 && width > 0)
1064 {
1065 y = FRAME_TOP_MARGIN_HEIGHT (f);
1066
1067 block_input ();
1068 x_clear_area (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1069 0, y, width, height);
1070 unblock_input ();
1071 }
1072
1073 if (nlines > 1 && nlines > olines)
1074 {
1075 y = (olines == 0 ? 1 : olines) * FRAME_LINE_HEIGHT (f);
1076 height = nlines * FRAME_LINE_HEIGHT (f) - y;
1077
1078 block_input ();
1079 x_clear_area (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1080 0, y, width, height);
1081 unblock_input ();
1082 }
1083
1084 if (nlines == 0 && WINDOWP (f->menu_bar_window))
1085 clear_glyph_matrix (XWINDOW (f->menu_bar_window)->current_matrix);
1086 }
1087 #endif /* not USE_X_TOOLKIT && not USE_GTK */
1088 adjust_frame_glyphs (f);
1089 run_window_configuration_change_hook (f);
1090 }
1091
1092
1093 /* Set the number of lines used for the tool bar of frame F to VALUE.
1094 VALUE not an integer, or < 0 means set the lines to zero. OLDVAL
1095 is the old number of tool bar lines. This function changes the
1096 height of all windows on frame F to match the new tool bar height.
1097 The frame's height doesn't change. */
1098
1099 static void
1100 x_set_tool_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
1101 {
1102 int nlines;
1103
1104 /* Treat tool bars like menu bars. */
1105 if (FRAME_MINIBUF_ONLY_P (f))
1106 return;
1107
1108 /* Use VALUE only if an int >= 0. */
1109 if (RANGED_INTEGERP (0, value, INT_MAX))
1110 nlines = XFASTINT (value);
1111 else
1112 nlines = 0;
1113
1114 x_change_tool_bar_height (f, nlines * FRAME_LINE_HEIGHT (f));
1115 }
1116
1117
1118 /* Set the pixel height of the tool bar of frame F to HEIGHT. */
1119 void
1120 x_change_tool_bar_height (struct frame *f, int height)
1121 {
1122 #ifdef USE_GTK
1123 FRAME_TOOL_BAR_LINES (f) = 0;
1124 FRAME_TOOL_BAR_HEIGHT (f) = 0;
1125 if (height)
1126 {
1127 FRAME_EXTERNAL_TOOL_BAR (f) = true;
1128 if (FRAME_X_P (f) && f->output_data.x->toolbar_widget == 0)
1129 /* Make sure next redisplay shows the tool bar. */
1130 XWINDOW (FRAME_SELECTED_WINDOW (f))->update_mode_line = true;
1131 update_frame_tool_bar (f);
1132 }
1133 else
1134 {
1135 if (FRAME_EXTERNAL_TOOL_BAR (f))
1136 free_frame_tool_bar (f);
1137 FRAME_EXTERNAL_TOOL_BAR (f) = false;
1138 }
1139 #else /* !USE_GTK */
1140 int unit = FRAME_LINE_HEIGHT (f);
1141 int old_height = FRAME_TOOL_BAR_HEIGHT (f);
1142 int lines = (height + unit - 1) / unit;
1143 Lisp_Object fullscreen;
1144
1145 /* Make sure we redisplay all windows in this frame. */
1146 windows_or_buffers_changed = 60;
1147
1148
1149 /* Recalculate tool bar and frame text sizes. */
1150 FRAME_TOOL_BAR_HEIGHT (f) = height;
1151 FRAME_TOOL_BAR_LINES (f) = lines;
1152 /* Store the `tool-bar-lines' and `height' frame parameters. */
1153 store_frame_param (f, Qtool_bar_lines, make_number (lines));
1154 store_frame_param (f, Qheight, make_number (FRAME_LINES (f)));
1155
1156 /* We also have to make sure that the internal border at the top of
1157 the frame, below the menu bar or tool bar, is redrawn when the
1158 tool bar disappears. This is so because the internal border is
1159 below the tool bar if one is displayed, but is below the menu bar
1160 if there isn't a tool bar. The tool bar draws into the area
1161 below the menu bar. */
1162 if (FRAME_X_WINDOW (f) && FRAME_TOOL_BAR_HEIGHT (f) == 0)
1163 {
1164 clear_frame (f);
1165 clear_current_matrices (f);
1166 }
1167
1168 if ((height < old_height) && WINDOWP (f->tool_bar_window))
1169 clear_glyph_matrix (XWINDOW (f->tool_bar_window)->current_matrix);
1170
1171 /* Recalculate toolbar height. */
1172 f->n_tool_bar_rows = 0;
1173
1174 adjust_frame_size (f, -1, -1,
1175 ((!f->tool_bar_redisplayed_once
1176 && (NILP (fullscreen =
1177 get_frame_param (f, Qfullscreen))
1178 || EQ (fullscreen, Qfullwidth))) ? 1
1179 : (old_height == 0 || height == 0) ? 2
1180 : 4),
1181 false, Qtool_bar_lines);
1182
1183 /* adjust_frame_size might not have done anything, garbage frame
1184 here. */
1185 adjust_frame_glyphs (f);
1186 SET_FRAME_GARBAGED (f);
1187 if (FRAME_X_WINDOW (f))
1188 x_clear_under_internal_border (f);
1189
1190 #endif /* USE_GTK */
1191 }
1192
1193
1194 static void
1195 x_set_internal_border_width (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
1196 {
1197 int border;
1198
1199 CHECK_TYPE_RANGED_INTEGER (int, arg);
1200 border = max (XINT (arg), 0);
1201
1202 if (border != FRAME_INTERNAL_BORDER_WIDTH (f))
1203 {
1204 FRAME_INTERNAL_BORDER_WIDTH (f) = border;
1205
1206 #ifdef USE_X_TOOLKIT
1207 if (FRAME_X_OUTPUT (f)->edit_widget)
1208 widget_store_internal_border (FRAME_X_OUTPUT (f)->edit_widget);
1209 #endif
1210
1211 if (FRAME_X_WINDOW (f) != 0)
1212 {
1213 adjust_frame_size (f, -1, -1, 3, false, Qinternal_border_width);
1214
1215 #ifdef USE_GTK
1216 xg_clear_under_internal_border (f);
1217 #else
1218 x_clear_under_internal_border (f);
1219 #endif
1220 }
1221 }
1222
1223 }
1224
1225
1226 /* Set the foreground color for scroll bars on frame F to VALUE.
1227 VALUE should be a string, a color name. If it isn't a string or
1228 isn't a valid color name, do nothing. OLDVAL is the old value of
1229 the frame parameter. */
1230
1231 static void
1232 x_set_scroll_bar_foreground (struct frame *f, Lisp_Object value, Lisp_Object oldval)
1233 {
1234 unsigned long pixel;
1235
1236 if (STRINGP (value))
1237 pixel = x_decode_color (f, value, BLACK_PIX_DEFAULT (f));
1238 else
1239 pixel = -1;
1240
1241 if (f->output_data.x->scroll_bar_foreground_pixel != -1)
1242 unload_color (f, f->output_data.x->scroll_bar_foreground_pixel);
1243
1244 f->output_data.x->scroll_bar_foreground_pixel = pixel;
1245 if (FRAME_X_WINDOW (f) && FRAME_VISIBLE_P (f))
1246 {
1247 /* Remove all scroll bars because they have wrong colors. */
1248 if (FRAME_TERMINAL (f)->condemn_scroll_bars_hook)
1249 (*FRAME_TERMINAL (f)->condemn_scroll_bars_hook) (f);
1250 if (FRAME_TERMINAL (f)->judge_scroll_bars_hook)
1251 (*FRAME_TERMINAL (f)->judge_scroll_bars_hook) (f);
1252
1253 update_face_from_frame_parameter (f, Qscroll_bar_foreground, value);
1254 redraw_frame (f);
1255 }
1256 }
1257
1258
1259 /* Set the background color for scroll bars on frame F to VALUE VALUE
1260 should be a string, a color name. If it isn't a string or isn't a
1261 valid color name, do nothing. OLDVAL is the old value of the frame
1262 parameter. */
1263
1264 static void
1265 x_set_scroll_bar_background (struct frame *f, Lisp_Object value, Lisp_Object oldval)
1266 {
1267 unsigned long pixel;
1268
1269 if (STRINGP (value))
1270 pixel = x_decode_color (f, value, WHITE_PIX_DEFAULT (f));
1271 else
1272 pixel = -1;
1273
1274 if (f->output_data.x->scroll_bar_background_pixel != -1)
1275 unload_color (f, f->output_data.x->scroll_bar_background_pixel);
1276
1277 #if defined (USE_LUCID) && defined (USE_TOOLKIT_SCROLL_BARS)
1278 /* Scrollbar shadow colors. */
1279 if (f->output_data.x->scroll_bar_top_shadow_pixel != -1)
1280 {
1281 unload_color (f, f->output_data.x->scroll_bar_top_shadow_pixel);
1282 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
1283 }
1284 if (f->output_data.x->scroll_bar_bottom_shadow_pixel != -1)
1285 {
1286 unload_color (f, f->output_data.x->scroll_bar_bottom_shadow_pixel);
1287 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
1288 }
1289 #endif /* USE_LUCID && USE_TOOLKIT_SCROLL_BARS */
1290
1291 f->output_data.x->scroll_bar_background_pixel = pixel;
1292 if (FRAME_X_WINDOW (f) && FRAME_VISIBLE_P (f))
1293 {
1294 /* Remove all scroll bars because they have wrong colors. */
1295 if (FRAME_TERMINAL (f)->condemn_scroll_bars_hook)
1296 (*FRAME_TERMINAL (f)->condemn_scroll_bars_hook) (f);
1297 if (FRAME_TERMINAL (f)->judge_scroll_bars_hook)
1298 (*FRAME_TERMINAL (f)->judge_scroll_bars_hook) (f);
1299
1300 update_face_from_frame_parameter (f, Qscroll_bar_background, value);
1301 redraw_frame (f);
1302 }
1303 }
1304
1305 \f
1306 /* Encode Lisp string STRING as a text in a format appropriate for
1307 XICCC (X Inter Client Communication Conventions).
1308
1309 This can call Lisp code, so callers must GCPRO.
1310
1311 If STRING contains only ASCII characters, do no conversion and
1312 return the string data of STRING. Otherwise, encode the text by
1313 CODING_SYSTEM, and return a newly allocated memory area which
1314 should be freed by `xfree' by a caller.
1315
1316 Store the byte length of resulting text in *TEXT_BYTES.
1317
1318 If the text contains only ASCII and Latin-1, store true in *STRING_P,
1319 which means that the `encoding' of the result can be `STRING'.
1320 Otherwise store false in *STRINGP, which means that the `encoding' of
1321 the result should be `COMPOUND_TEXT'. */
1322
1323 static unsigned char *
1324 x_encode_text (Lisp_Object string, Lisp_Object coding_system,
1325 ptrdiff_t *text_bytes, bool *stringp, bool *freep)
1326 {
1327 int result = string_xstring_p (string);
1328 struct coding_system coding;
1329
1330 if (result == 0)
1331 {
1332 /* No multibyte character in OBJ. We need not encode it. */
1333 *text_bytes = SBYTES (string);
1334 *stringp = true;
1335 *freep = false;
1336 return SDATA (string);
1337 }
1338
1339 setup_coding_system (coding_system, &coding);
1340 coding.mode |= (CODING_MODE_SAFE_ENCODING | CODING_MODE_LAST_BLOCK);
1341 /* We suppress producing escape sequences for composition. */
1342 coding.common_flags &= ~CODING_ANNOTATION_MASK;
1343 coding.destination = xnmalloc (SCHARS (string), 2);
1344 coding.dst_bytes = SCHARS (string) * 2;
1345 encode_coding_object (&coding, string, 0, 0,
1346 SCHARS (string), SBYTES (string), Qnil);
1347 *text_bytes = coding.produced;
1348 *stringp = (result == 1 || !EQ (coding_system, Qcompound_text));
1349 *freep = true;
1350 return coding.destination;
1351 }
1352
1353 \f
1354 /* Set the WM name to NAME for frame F. Also set the icon name.
1355 If the frame already has an icon name, use that, otherwise set the
1356 icon name to NAME. */
1357
1358 static void
1359 x_set_name_internal (struct frame *f, Lisp_Object name)
1360 {
1361 if (FRAME_X_WINDOW (f))
1362 {
1363 block_input ();
1364 {
1365 XTextProperty text, icon;
1366 ptrdiff_t bytes;
1367 bool stringp;
1368 bool do_free_icon_value = false, do_free_text_value = false;
1369 Lisp_Object coding_system;
1370 Lisp_Object encoded_name;
1371 Lisp_Object encoded_icon_name;
1372 struct gcpro gcpro1;
1373
1374 /* As ENCODE_UTF_8 may cause GC and relocation of string data,
1375 we use it before x_encode_text that may return string data. */
1376 GCPRO1 (name);
1377 encoded_name = ENCODE_UTF_8 (name);
1378 UNGCPRO;
1379
1380 coding_system = Qcompound_text;
1381 /* Note: Encoding strategy
1382
1383 We encode NAME by compound-text and use "COMPOUND-TEXT" in
1384 text.encoding. But, there are non-internationalized window
1385 managers which don't support that encoding. So, if NAME
1386 contains only ASCII and 8859-1 characters, encode it by
1387 iso-latin-1, and use "STRING" in text.encoding hoping that
1388 such window managers at least analyze this format correctly,
1389 i.e. treat 8-bit bytes as 8859-1 characters.
1390
1391 We may also be able to use "UTF8_STRING" in text.encoding
1392 in the future which can encode all Unicode characters.
1393 But, for the moment, there's no way to know that the
1394 current window manager supports it or not.
1395
1396 Either way, we also set the _NET_WM_NAME and _NET_WM_ICON_NAME
1397 properties. Per the EWMH specification, those two properties
1398 are always UTF8_STRING. This matches what gtk_window_set_title()
1399 does in the USE_GTK case. */
1400 text.value = x_encode_text (name, coding_system, &bytes,
1401 &stringp, &do_free_text_value);
1402 text.encoding = (stringp ? XA_STRING
1403 : FRAME_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
1404 text.format = 8;
1405 text.nitems = bytes;
1406
1407 if (!STRINGP (f->icon_name))
1408 {
1409 icon = text;
1410 encoded_icon_name = encoded_name;
1411 }
1412 else
1413 {
1414 /* See the above comment "Note: Encoding strategy". */
1415 icon.value = x_encode_text (f->icon_name, coding_system, &bytes,
1416 &stringp, &do_free_icon_value);
1417 icon.encoding = (stringp ? XA_STRING
1418 : FRAME_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
1419 icon.format = 8;
1420 icon.nitems = bytes;
1421
1422 encoded_icon_name = ENCODE_UTF_8 (f->icon_name);
1423 }
1424
1425 #ifdef USE_GTK
1426 gtk_window_set_title (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)),
1427 SSDATA (encoded_name));
1428 #else /* not USE_GTK */
1429 XSetWMName (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &text);
1430 XChangeProperty (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f),
1431 FRAME_DISPLAY_INFO (f)->Xatom_net_wm_name,
1432 FRAME_DISPLAY_INFO (f)->Xatom_UTF8_STRING,
1433 8, PropModeReplace,
1434 SDATA (encoded_name),
1435 SBYTES (encoded_name));
1436 #endif /* not USE_GTK */
1437
1438 XSetWMIconName (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &icon);
1439 XChangeProperty (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f),
1440 FRAME_DISPLAY_INFO (f)->Xatom_net_wm_icon_name,
1441 FRAME_DISPLAY_INFO (f)->Xatom_UTF8_STRING,
1442 8, PropModeReplace,
1443 SDATA (encoded_icon_name),
1444 SBYTES (encoded_icon_name));
1445
1446 if (do_free_icon_value)
1447 xfree (icon.value);
1448 if (do_free_text_value)
1449 xfree (text.value);
1450 }
1451 unblock_input ();
1452 }
1453 }
1454
1455 /* Change the name of frame F to NAME. If NAME is nil, set F's name to
1456 x_id_name.
1457
1458 If EXPLICIT is true, that indicates that lisp code is setting the
1459 name; if NAME is a string, set F's name to NAME and set
1460 F->explicit_name; if NAME is Qnil, then clear F->explicit_name.
1461
1462 If EXPLICIT is false, that indicates that Emacs redisplay code is
1463 suggesting a new name, which lisp code should override; if
1464 F->explicit_name is set, ignore the new name; otherwise, set it. */
1465
1466 static void
1467 x_set_name (struct frame *f, Lisp_Object name, bool explicit)
1468 {
1469 /* Make sure that requests from lisp code override requests from
1470 Emacs redisplay code. */
1471 if (explicit)
1472 {
1473 /* If we're switching from explicit to implicit, we had better
1474 update the mode lines and thereby update the title. */
1475 if (f->explicit_name && NILP (name))
1476 update_mode_lines = 37;
1477
1478 f->explicit_name = ! NILP (name);
1479 }
1480 else if (f->explicit_name)
1481 return;
1482
1483 /* If NAME is nil, set the name to the x_id_name. */
1484 if (NILP (name))
1485 {
1486 /* Check for no change needed in this very common case
1487 before we do any consing. */
1488 if (!strcmp (FRAME_DISPLAY_INFO (f)->x_id_name,
1489 SSDATA (f->name)))
1490 return;
1491 name = build_string (FRAME_DISPLAY_INFO (f)->x_id_name);
1492 }
1493 else
1494 CHECK_STRING (name);
1495
1496 /* Don't change the name if it's already NAME. */
1497 if (! NILP (Fstring_equal (name, f->name)))
1498 return;
1499
1500 fset_name (f, name);
1501
1502 /* For setting the frame title, the title parameter should override
1503 the name parameter. */
1504 if (! NILP (f->title))
1505 name = f->title;
1506
1507 x_set_name_internal (f, name);
1508 }
1509
1510 /* This function should be called when the user's lisp code has
1511 specified a name for the frame; the name will override any set by the
1512 redisplay code. */
1513 static void
1514 x_explicitly_set_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
1515 {
1516 x_set_name (f, arg, true);
1517 }
1518
1519 /* This function should be called by Emacs redisplay code to set the
1520 name; names set this way will never override names set by the user's
1521 lisp code. */
1522 void
1523 x_implicitly_set_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
1524 {
1525 x_set_name (f, arg, false);
1526 }
1527 \f
1528 /* Change the title of frame F to NAME.
1529 If NAME is nil, use the frame name as the title. */
1530
1531 static void
1532 x_set_title (struct frame *f, Lisp_Object name, Lisp_Object old_name)
1533 {
1534 /* Don't change the title if it's already NAME. */
1535 if (EQ (name, f->title))
1536 return;
1537
1538 update_mode_lines = 38;
1539
1540 fset_title (f, name);
1541
1542 if (NILP (name))
1543 name = f->name;
1544 else
1545 CHECK_STRING (name);
1546
1547 x_set_name_internal (f, name);
1548 }
1549
1550 void
1551 x_set_scroll_bar_default_width (struct frame *f)
1552 {
1553 int unit = FRAME_COLUMN_WIDTH (f);
1554 #ifdef USE_TOOLKIT_SCROLL_BARS
1555 #ifdef USE_GTK
1556 int minw = xg_get_default_scrollbar_width ();
1557 #else
1558 int minw = 16;
1559 #endif
1560 /* A minimum width of 14 doesn't look good for toolkit scroll bars. */
1561 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (minw + unit - 1) / unit;
1562 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = minw;
1563 #else
1564 /* The width of a non-toolkit scrollbar is 14 pixels. */
1565 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (14 + unit - 1) / unit;
1566 FRAME_CONFIG_SCROLL_BAR_WIDTH (f)
1567 = FRAME_CONFIG_SCROLL_BAR_COLS (f) * unit;
1568 #endif
1569 }
1570
1571 void
1572 x_set_scroll_bar_default_height (struct frame *f)
1573 {
1574 int height = FRAME_LINE_HEIGHT (f);
1575 #ifdef USE_TOOLKIT_SCROLL_BARS
1576 #ifdef USE_GTK
1577 int min_height = xg_get_default_scrollbar_height ();
1578 #else
1579 int min_height = 16;
1580 #endif
1581 /* A minimum height of 14 doesn't look good for toolkit scroll bars. */
1582 FRAME_CONFIG_SCROLL_BAR_HEIGHT (f) = min_height;
1583 FRAME_CONFIG_SCROLL_BAR_LINES (f) = (min_height + height - 1) / height;
1584 #else
1585 /* The height of a non-toolkit scrollbar is 14 pixels. */
1586 FRAME_CONFIG_SCROLL_BAR_LINES (f) = (14 + height - 1) / height;
1587
1588 /* Use all of that space (aside from required margins) for the
1589 scroll bar. */
1590 FRAME_CONFIG_SCROLL_BAR_HEIGHT (f) = 14;
1591 #endif
1592 }
1593
1594 \f
1595 /* Record in frame F the specified or default value according to ALIST
1596 of the parameter named PROP (a Lisp symbol). If no value is
1597 specified for PROP, look for an X default for XPROP on the frame
1598 named NAME. If that is not found either, use the value DEFLT. */
1599
1600 static Lisp_Object
1601 x_default_scroll_bar_color_parameter (struct frame *f,
1602 Lisp_Object alist, Lisp_Object prop,
1603 const char *xprop, const char *xclass,
1604 bool foreground_p)
1605 {
1606 struct x_display_info *dpyinfo = FRAME_DISPLAY_INFO (f);
1607 Lisp_Object tem;
1608
1609 tem = x_get_arg (dpyinfo, alist, prop, xprop, xclass, RES_TYPE_STRING);
1610 if (EQ (tem, Qunbound))
1611 {
1612 #ifdef USE_TOOLKIT_SCROLL_BARS
1613
1614 /* See if an X resource for the scroll bar color has been
1615 specified. */
1616 AUTO_STRING (foreground, "foreground");
1617 AUTO_STRING (background, "foreground");
1618 AUTO_STRING (verticalScrollBar, "verticalScrollBar");
1619 tem = (display_x_get_resource
1620 (dpyinfo, foreground_p ? foreground : background,
1621 empty_unibyte_string,
1622 verticalScrollBar,
1623 empty_unibyte_string));
1624 if (!STRINGP (tem))
1625 {
1626 /* If nothing has been specified, scroll bars will use a
1627 toolkit-dependent default. Because these defaults are
1628 difficult to get at without actually creating a scroll
1629 bar, use nil to indicate that no color has been
1630 specified. */
1631 tem = Qnil;
1632 }
1633
1634 #else /* not USE_TOOLKIT_SCROLL_BARS */
1635
1636 tem = Qnil;
1637
1638 #endif /* not USE_TOOLKIT_SCROLL_BARS */
1639 }
1640
1641 AUTO_FRAME_ARG (arg, prop, tem);
1642 x_set_frame_parameters (f, arg);
1643 return tem;
1644 }
1645
1646
1647
1648 \f
1649 #ifdef USE_X_TOOLKIT
1650
1651 /* If the WM_PROTOCOLS property does not already contain WM_TAKE_FOCUS,
1652 WM_DELETE_WINDOW, and WM_SAVE_YOURSELF, then add them. (They may
1653 already be present because of the toolkit (Motif adds some of them,
1654 for example, but Xt doesn't). */
1655
1656 static void
1657 hack_wm_protocols (struct frame *f, Widget widget)
1658 {
1659 Display *dpy = XtDisplay (widget);
1660 Window w = XtWindow (widget);
1661 bool need_delete = true;
1662 bool need_focus = true;
1663 bool need_save = true;
1664
1665 block_input ();
1666 {
1667 Atom type;
1668 unsigned char *catoms;
1669 int format = 0;
1670 unsigned long nitems = 0;
1671 unsigned long bytes_after;
1672
1673 if ((XGetWindowProperty (dpy, w,
1674 FRAME_DISPLAY_INFO (f)->Xatom_wm_protocols,
1675 0, 100, False, XA_ATOM,
1676 &type, &format, &nitems, &bytes_after,
1677 &catoms)
1678 == Success)
1679 && format == 32 && type == XA_ATOM)
1680 {
1681 Atom *atoms = (Atom *) catoms;
1682 while (nitems > 0)
1683 {
1684 nitems--;
1685 if (atoms[nitems]
1686 == FRAME_DISPLAY_INFO (f)->Xatom_wm_delete_window)
1687 need_delete = false;
1688 else if (atoms[nitems]
1689 == FRAME_DISPLAY_INFO (f)->Xatom_wm_take_focus)
1690 need_focus = false;
1691 else if (atoms[nitems]
1692 == FRAME_DISPLAY_INFO (f)->Xatom_wm_save_yourself)
1693 need_save = false;
1694 }
1695 }
1696 if (catoms)
1697 XFree (catoms);
1698 }
1699 {
1700 Atom props[10];
1701 int count = 0;
1702 if (need_delete)
1703 props[count++] = FRAME_DISPLAY_INFO (f)->Xatom_wm_delete_window;
1704 if (need_focus)
1705 props[count++] = FRAME_DISPLAY_INFO (f)->Xatom_wm_take_focus;
1706 if (need_save)
1707 props[count++] = FRAME_DISPLAY_INFO (f)->Xatom_wm_save_yourself;
1708 if (count)
1709 XChangeProperty (dpy, w, FRAME_DISPLAY_INFO (f)->Xatom_wm_protocols,
1710 XA_ATOM, 32, PropModeAppend,
1711 (unsigned char *) props, count);
1712 }
1713 unblock_input ();
1714 }
1715 #endif
1716
1717
1718 \f
1719 /* Support routines for XIC (X Input Context). */
1720
1721 #ifdef HAVE_X_I18N
1722
1723 static XFontSet xic_create_xfontset (struct frame *);
1724 static XIMStyle best_xim_style (XIMStyles *);
1725
1726
1727 /* Supported XIM styles, ordered by preference. */
1728
1729 static const XIMStyle supported_xim_styles[] =
1730 {
1731 XIMPreeditPosition | XIMStatusArea,
1732 XIMPreeditPosition | XIMStatusNothing,
1733 XIMPreeditPosition | XIMStatusNone,
1734 XIMPreeditNothing | XIMStatusArea,
1735 XIMPreeditNothing | XIMStatusNothing,
1736 XIMPreeditNothing | XIMStatusNone,
1737 XIMPreeditNone | XIMStatusArea,
1738 XIMPreeditNone | XIMStatusNothing,
1739 XIMPreeditNone | XIMStatusNone,
1740 0,
1741 };
1742
1743
1744 #if defined HAVE_X_WINDOWS && defined USE_X_TOOLKIT
1745 /* Create an X fontset on frame F with base font name BASE_FONTNAME. */
1746
1747 static const char xic_default_fontset[] = "-*-*-*-r-normal--14-*-*-*-*-*-*-*";
1748
1749 /* Create an Xt fontset spec from the name of a base font.
1750 If `motif' is True use the Motif syntax. */
1751 char *
1752 xic_create_fontsetname (const char *base_fontname, bool motif)
1753 {
1754 const char *sep = motif ? ";" : ",";
1755 char *fontsetname;
1756 char *z;
1757
1758 /* Make a fontset name from the base font name. */
1759 if (xic_default_fontset == base_fontname)
1760 {
1761 /* There is no base font name, use the default. */
1762 fontsetname = xmalloc (strlen (base_fontname) + 2);
1763 z = stpcpy (fontsetname, base_fontname);
1764 }
1765 else
1766 {
1767 /* Make a fontset name from the base font name.
1768 The font set will be made of the following elements:
1769 - the base font.
1770 - the base font where the charset spec is replaced by -*-*.
1771 - the same but with the family also replaced with -*-*-. */
1772 const char *p = base_fontname;
1773 ptrdiff_t i;
1774
1775 for (i = 0; *p; p++)
1776 if (*p == '-') i++;
1777 if (i != 14)
1778 {
1779 /* As the font name doesn't conform to XLFD, we can't
1780 modify it to generalize it to allcs and allfamilies.
1781 Use the specified font plus the default. */
1782 fontsetname = xmalloc (strlen (base_fontname)
1783 + strlen (xic_default_fontset) + 3);
1784 z = stpcpy (fontsetname, base_fontname);
1785 z = stpcpy (z, sep);
1786 z = stpcpy (z, xic_default_fontset);
1787 }
1788 else
1789 {
1790 ptrdiff_t len;
1791 const char *p1 = NULL, *p2 = NULL, *p3 = NULL;
1792 char *font_allcs = NULL;
1793 char *font_allfamilies = NULL;
1794 char *font_all = NULL;
1795 const char *allcs = "*-*-*-*-*-*-*";
1796 const char *allfamilies = "-*-*-";
1797 const char *all = "*-*-*-*-";
1798 char *base;
1799
1800 for (i = 0, p = base_fontname; i < 8; p++)
1801 {
1802 if (*p == '-')
1803 {
1804 i++;
1805 if (i == 3)
1806 p1 = p + 1;
1807 else if (i == 7)
1808 p2 = p + 1;
1809 else if (i == 6)
1810 p3 = p + 1;
1811 }
1812 }
1813 /* If base_fontname specifies ADSTYLE, make it a
1814 wildcard. */
1815 if (*p3 != '*')
1816 {
1817 ptrdiff_t diff = (p2 - p3) - 2;
1818
1819 base = alloca (strlen (base_fontname) + 1);
1820 memcpy (base, base_fontname, p3 - base_fontname);
1821 base[p3 - base_fontname] = '*';
1822 base[(p3 - base_fontname) + 1] = '-';
1823 strcpy (base + (p3 - base_fontname) + 2, p2);
1824 p = base + (p - base_fontname) - diff;
1825 p1 = base + (p1 - base_fontname);
1826 p2 = base + (p2 - base_fontname) - diff;
1827 base_fontname = base;
1828 }
1829
1830 /* Build the font spec that matches all charsets. */
1831 len = p - base_fontname + strlen (allcs) + 1;
1832 font_allcs = alloca (len);
1833 memcpy (font_allcs, base_fontname, p - base_fontname);
1834 strcpy (font_allcs + (p - base_fontname), allcs);
1835
1836 /* Build the font spec that matches all families and
1837 add-styles. */
1838 len = p - p1 + strlen (allcs) + strlen (allfamilies) + 1;
1839 font_allfamilies = alloca (len);
1840 strcpy (font_allfamilies, allfamilies);
1841 memcpy (font_allfamilies + strlen (allfamilies), p1, p - p1);
1842 strcpy (font_allfamilies + strlen (allfamilies) + (p - p1), allcs);
1843
1844 /* Build the font spec that matches all. */
1845 len = p - p2 + strlen (allcs) + strlen (all) + strlen (allfamilies) + 1;
1846 font_all = alloca (len);
1847 z = stpcpy (font_all, allfamilies);
1848 z = stpcpy (z, all);
1849 memcpy (z, p2, p - p2);
1850 strcpy (z + (p - p2), allcs);
1851
1852 /* Build the actual font set name. */
1853 len = strlen (base_fontname) + strlen (font_allcs)
1854 + strlen (font_allfamilies) + strlen (font_all) + 5;
1855 fontsetname = xmalloc (len);
1856 z = stpcpy (fontsetname, base_fontname);
1857 z = stpcpy (z, sep);
1858 z = stpcpy (z, font_allcs);
1859 z = stpcpy (z, sep);
1860 z = stpcpy (z, font_allfamilies);
1861 z = stpcpy (z, sep);
1862 z = stpcpy (z, font_all);
1863 }
1864 }
1865 if (motif)
1866 strcpy (z, ":");
1867 return fontsetname;
1868 }
1869 #endif /* HAVE_X_WINDOWS && USE_X_TOOLKIT */
1870
1871 #ifdef DEBUG_XIC_FONTSET
1872 static void
1873 print_fontset_result (XFontSet xfs, char *name, char **missing_list,
1874 int missing_count)
1875 {
1876 if (xfs)
1877 fprintf (stderr, "XIC Fontset created: %s\n", name);
1878 else
1879 {
1880 fprintf (stderr, "XIC Fontset failed: %s\n", name);
1881 while (missing_count-- > 0)
1882 {
1883 fprintf (stderr, " missing: %s\n", *missing_list);
1884 missing_list++;
1885 }
1886 }
1887
1888 }
1889 #endif
1890
1891 static XFontSet
1892 xic_create_xfontset (struct frame *f)
1893 {
1894 XFontSet xfs = NULL;
1895 struct font *font = FRAME_FONT (f);
1896 int pixel_size = font->pixel_size;
1897 Lisp_Object rest, frame;
1898
1899 /* See if there is another frame already using same fontset. */
1900 FOR_EACH_FRAME (rest, frame)
1901 {
1902 struct frame *cf = XFRAME (frame);
1903
1904 if (cf != f && FRAME_LIVE_P (f) && FRAME_X_P (cf)
1905 && FRAME_DISPLAY_INFO (cf) == FRAME_DISPLAY_INFO (f)
1906 && FRAME_FONT (f)
1907 && FRAME_FONT (f)->pixel_size == pixel_size)
1908 {
1909 xfs = FRAME_XIC_FONTSET (cf);
1910 break;
1911 }
1912 }
1913
1914 if (! xfs)
1915 {
1916 char buf[256];
1917 char **missing_list;
1918 int missing_count;
1919 char *def_string;
1920 const char *xlfd_format = "-*-*-medium-r-normal--%d-*-*-*-*-*";
1921
1922 sprintf (buf, xlfd_format, pixel_size);
1923 missing_list = NULL;
1924 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), buf,
1925 &missing_list, &missing_count, &def_string);
1926 #ifdef DEBUG_XIC_FONTSET
1927 print_fontset_result (xfs, buf, missing_list, missing_count);
1928 #endif
1929 if (missing_list)
1930 XFreeStringList (missing_list);
1931 if (! xfs)
1932 {
1933 /* List of pixel sizes most likely available. Find one that
1934 is closest to pixel_size. */
1935 int sizes[] = {0, 8, 10, 11, 12, 14, 17, 18, 20, 24, 26, 34, 0};
1936 int *smaller, *larger;
1937
1938 for (smaller = sizes; smaller[1]; smaller++)
1939 if (smaller[1] >= pixel_size)
1940 break;
1941 larger = smaller + 1;
1942 if (*larger == pixel_size)
1943 larger++;
1944 while (*smaller || *larger)
1945 {
1946 int this_size;
1947
1948 if (! *larger)
1949 this_size = *smaller--;
1950 else if (! *smaller)
1951 this_size = *larger++;
1952 else if (pixel_size - *smaller < *larger - pixel_size)
1953 this_size = *smaller--;
1954 else
1955 this_size = *larger++;
1956 sprintf (buf, xlfd_format, this_size);
1957 missing_list = NULL;
1958 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), buf,
1959 &missing_list, &missing_count, &def_string);
1960 #ifdef DEBUG_XIC_FONTSET
1961 print_fontset_result (xfs, buf, missing_list, missing_count);
1962 #endif
1963 if (missing_list)
1964 XFreeStringList (missing_list);
1965 if (xfs)
1966 break;
1967 }
1968 }
1969 if (! xfs)
1970 {
1971 const char *last_resort = "-*-*-*-r-normal--*-*-*-*-*-*";
1972
1973 missing_list = NULL;
1974 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), last_resort,
1975 &missing_list, &missing_count, &def_string);
1976 #ifdef DEBUG_XIC_FONTSET
1977 print_fontset_result (xfs, last_resort, missing_list, missing_count);
1978 #endif
1979 if (missing_list)
1980 XFreeStringList (missing_list);
1981 }
1982
1983 }
1984
1985 return xfs;
1986 }
1987
1988 /* Free the X fontset of frame F if it is the last frame using it. */
1989
1990 void
1991 xic_free_xfontset (struct frame *f)
1992 {
1993 Lisp_Object rest, frame;
1994 bool shared_p = false;
1995
1996 if (!FRAME_XIC_FONTSET (f))
1997 return;
1998
1999 /* See if there is another frame sharing the same fontset. */
2000 FOR_EACH_FRAME (rest, frame)
2001 {
2002 struct frame *cf = XFRAME (frame);
2003 if (cf != f && FRAME_LIVE_P (f) && FRAME_X_P (cf)
2004 && FRAME_DISPLAY_INFO (cf) == FRAME_DISPLAY_INFO (f)
2005 && FRAME_XIC_FONTSET (cf) == FRAME_XIC_FONTSET (f))
2006 {
2007 shared_p = true;
2008 break;
2009 }
2010 }
2011
2012 if (!shared_p)
2013 /* The fontset is not used anymore. It is safe to free it. */
2014 XFreeFontSet (FRAME_X_DISPLAY (f), FRAME_XIC_FONTSET (f));
2015
2016 FRAME_XIC_FONTSET (f) = NULL;
2017 }
2018
2019
2020 /* Value is the best input style, given user preferences USER (already
2021 checked to be supported by Emacs), and styles supported by the
2022 input method XIM. */
2023
2024 static XIMStyle
2025 best_xim_style (XIMStyles *xim)
2026 {
2027 int i, j;
2028 int nr_supported = ARRAYELTS (supported_xim_styles);
2029
2030 for (i = 0; i < nr_supported; ++i)
2031 for (j = 0; j < xim->count_styles; ++j)
2032 if (supported_xim_styles[i] == xim->supported_styles[j])
2033 return supported_xim_styles[i];
2034
2035 /* Return the default style. */
2036 return XIMPreeditNothing | XIMStatusNothing;
2037 }
2038
2039 /* Create XIC for frame F. */
2040
2041 void
2042 create_frame_xic (struct frame *f)
2043 {
2044 XIM xim;
2045 XIC xic = NULL;
2046 XFontSet xfs = NULL;
2047 XVaNestedList status_attr = NULL;
2048 XVaNestedList preedit_attr = NULL;
2049 XRectangle s_area;
2050 XPoint spot;
2051 XIMStyle xic_style;
2052
2053 if (FRAME_XIC (f))
2054 goto out;
2055
2056 xim = FRAME_X_XIM (f);
2057 if (!xim)
2058 goto out;
2059
2060 /* Determine XIC style. */
2061 xic_style = best_xim_style (FRAME_X_XIM_STYLES (f));
2062
2063 /* Create X fontset. */
2064 if (xic_style & (XIMPreeditPosition | XIMStatusArea))
2065 {
2066 xfs = xic_create_xfontset (f);
2067 if (!xfs)
2068 goto out;
2069
2070 FRAME_XIC_FONTSET (f) = xfs;
2071 }
2072
2073 if (xic_style & XIMPreeditPosition)
2074 {
2075 spot.x = 0; spot.y = 1;
2076 preedit_attr = XVaCreateNestedList (0,
2077 XNFontSet, xfs,
2078 XNForeground,
2079 FRAME_FOREGROUND_PIXEL (f),
2080 XNBackground,
2081 FRAME_BACKGROUND_PIXEL (f),
2082 (xic_style & XIMPreeditPosition
2083 ? XNSpotLocation
2084 : NULL),
2085 &spot,
2086 NULL);
2087
2088 if (!preedit_attr)
2089 goto out;
2090 }
2091
2092 if (xic_style & XIMStatusArea)
2093 {
2094 s_area.x = 0; s_area.y = 0; s_area.width = 1; s_area.height = 1;
2095 status_attr = XVaCreateNestedList (0,
2096 XNArea,
2097 &s_area,
2098 XNFontSet,
2099 xfs,
2100 XNForeground,
2101 FRAME_FOREGROUND_PIXEL (f),
2102 XNBackground,
2103 FRAME_BACKGROUND_PIXEL (f),
2104 NULL);
2105
2106 if (!status_attr)
2107 goto out;
2108 }
2109
2110 if (preedit_attr && status_attr)
2111 xic = XCreateIC (xim,
2112 XNInputStyle, xic_style,
2113 XNClientWindow, FRAME_X_WINDOW (f),
2114 XNFocusWindow, FRAME_X_WINDOW (f),
2115 XNStatusAttributes, status_attr,
2116 XNPreeditAttributes, preedit_attr,
2117 NULL);
2118 else if (preedit_attr)
2119 xic = XCreateIC (xim,
2120 XNInputStyle, xic_style,
2121 XNClientWindow, FRAME_X_WINDOW (f),
2122 XNFocusWindow, FRAME_X_WINDOW (f),
2123 XNPreeditAttributes, preedit_attr,
2124 NULL);
2125 else if (status_attr)
2126 xic = XCreateIC (xim,
2127 XNInputStyle, xic_style,
2128 XNClientWindow, FRAME_X_WINDOW (f),
2129 XNFocusWindow, FRAME_X_WINDOW (f),
2130 XNStatusAttributes, status_attr,
2131 NULL);
2132 else
2133 xic = XCreateIC (xim,
2134 XNInputStyle, xic_style,
2135 XNClientWindow, FRAME_X_WINDOW (f),
2136 XNFocusWindow, FRAME_X_WINDOW (f),
2137 NULL);
2138
2139 if (!xic)
2140 goto out;
2141
2142 FRAME_XIC (f) = xic;
2143 FRAME_XIC_STYLE (f) = xic_style;
2144 xfs = NULL; /* Don't free below. */
2145
2146 out:
2147
2148 if (xfs)
2149 free_frame_xic (f);
2150
2151 if (preedit_attr)
2152 XFree (preedit_attr);
2153
2154 if (status_attr)
2155 XFree (status_attr);
2156 }
2157
2158
2159 /* Destroy XIC and free XIC fontset of frame F, if any. */
2160
2161 void
2162 free_frame_xic (struct frame *f)
2163 {
2164 if (FRAME_XIC (f) == NULL)
2165 return;
2166
2167 XDestroyIC (FRAME_XIC (f));
2168 xic_free_xfontset (f);
2169
2170 FRAME_XIC (f) = NULL;
2171 }
2172
2173
2174 /* Place preedit area for XIC of window W's frame to specified
2175 pixel position X/Y. X and Y are relative to window W. */
2176
2177 void
2178 xic_set_preeditarea (struct window *w, int x, int y)
2179 {
2180 struct frame *f = XFRAME (w->frame);
2181 XVaNestedList attr;
2182 XPoint spot;
2183
2184 spot.x = WINDOW_TO_FRAME_PIXEL_X (w, x) + WINDOW_LEFT_FRINGE_WIDTH (w);
2185 spot.y = WINDOW_TO_FRAME_PIXEL_Y (w, y) + FONT_BASE (FRAME_FONT (f));
2186 attr = XVaCreateNestedList (0, XNSpotLocation, &spot, NULL);
2187 XSetICValues (FRAME_XIC (f), XNPreeditAttributes, attr, NULL);
2188 XFree (attr);
2189 }
2190
2191
2192 /* Place status area for XIC in bottom right corner of frame F.. */
2193
2194 void
2195 xic_set_statusarea (struct frame *f)
2196 {
2197 XIC xic = FRAME_XIC (f);
2198 XVaNestedList attr;
2199 XRectangle area;
2200 XRectangle *needed;
2201
2202 /* Negotiate geometry of status area. If input method has existing
2203 status area, use its current size. */
2204 area.x = area.y = area.width = area.height = 0;
2205 attr = XVaCreateNestedList (0, XNAreaNeeded, &area, NULL);
2206 XSetICValues (xic, XNStatusAttributes, attr, NULL);
2207 XFree (attr);
2208
2209 attr = XVaCreateNestedList (0, XNAreaNeeded, &needed, NULL);
2210 XGetICValues (xic, XNStatusAttributes, attr, NULL);
2211 XFree (attr);
2212
2213 if (needed->width == 0) /* Use XNArea instead of XNAreaNeeded */
2214 {
2215 attr = XVaCreateNestedList (0, XNArea, &needed, NULL);
2216 XGetICValues (xic, XNStatusAttributes, attr, NULL);
2217 XFree (attr);
2218 }
2219
2220 area.width = needed->width;
2221 area.height = needed->height;
2222 area.x = FRAME_PIXEL_WIDTH (f) - area.width - FRAME_INTERNAL_BORDER_WIDTH (f);
2223 area.y = (FRAME_PIXEL_HEIGHT (f) - area.height
2224 - FRAME_MENUBAR_HEIGHT (f)
2225 - FRAME_TOOLBAR_TOP_HEIGHT (f)
2226 - FRAME_INTERNAL_BORDER_WIDTH (f));
2227 XFree (needed);
2228
2229 attr = XVaCreateNestedList (0, XNArea, &area, NULL);
2230 XSetICValues (xic, XNStatusAttributes, attr, NULL);
2231 XFree (attr);
2232 }
2233
2234
2235 /* Set X fontset for XIC of frame F, using base font name
2236 BASE_FONTNAME. Called when a new Emacs fontset is chosen. */
2237
2238 void
2239 xic_set_xfontset (struct frame *f, const char *base_fontname)
2240 {
2241 XVaNestedList attr;
2242 XFontSet xfs;
2243
2244 xic_free_xfontset (f);
2245
2246 xfs = xic_create_xfontset (f);
2247
2248 attr = XVaCreateNestedList (0, XNFontSet, xfs, NULL);
2249 if (FRAME_XIC_STYLE (f) & XIMPreeditPosition)
2250 XSetICValues (FRAME_XIC (f), XNPreeditAttributes, attr, NULL);
2251 if (FRAME_XIC_STYLE (f) & XIMStatusArea)
2252 XSetICValues (FRAME_XIC (f), XNStatusAttributes, attr, NULL);
2253 XFree (attr);
2254
2255 FRAME_XIC_FONTSET (f) = xfs;
2256 }
2257
2258 #endif /* HAVE_X_I18N */
2259
2260
2261 \f
2262 #ifdef USE_X_TOOLKIT
2263
2264 /* Create and set up the X widget for frame F. */
2265
2266 static void
2267 x_window (struct frame *f, long window_prompting)
2268 {
2269 XClassHint class_hints;
2270 XSetWindowAttributes attributes;
2271 unsigned long attribute_mask;
2272 Widget shell_widget;
2273 Widget pane_widget;
2274 Widget frame_widget;
2275 Arg al[25];
2276 int ac;
2277
2278 block_input ();
2279
2280 /* Use the resource name as the top-level widget name
2281 for looking up resources. Make a non-Lisp copy
2282 for the window manager, so GC relocation won't bother it.
2283
2284 Elsewhere we specify the window name for the window manager. */
2285 f->namebuf = xlispstrdup (Vx_resource_name);
2286
2287 ac = 0;
2288 XtSetArg (al[ac], XtNallowShellResize, 1); ac++;
2289 XtSetArg (al[ac], XtNinput, 1); ac++;
2290 XtSetArg (al[ac], XtNmappedWhenManaged, 0); ac++;
2291 XtSetArg (al[ac], XtNborderWidth, f->border_width); ac++;
2292 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2293 XtSetArg (al[ac], XtNdepth, FRAME_DISPLAY_INFO (f)->n_planes); ac++;
2294 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2295 shell_widget = XtAppCreateShell (f->namebuf, EMACS_CLASS,
2296 applicationShellWidgetClass,
2297 FRAME_X_DISPLAY (f), al, ac);
2298
2299 f->output_data.x->widget = shell_widget;
2300 /* maybe_set_screen_title_format (shell_widget); */
2301
2302 pane_widget = lw_create_widget ("main", "pane", widget_id_tick++,
2303 NULL, shell_widget, False,
2304 NULL, NULL, NULL, NULL);
2305
2306 ac = 0;
2307 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2308 XtSetArg (al[ac], XtNdepth, FRAME_DISPLAY_INFO (f)->n_planes); ac++;
2309 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2310 XtSetArg (al[ac], XtNborderWidth, 0); ac++;
2311 XtSetValues (pane_widget, al, ac);
2312 f->output_data.x->column_widget = pane_widget;
2313
2314 /* mappedWhenManaged to false tells to the paned window to not map/unmap
2315 the emacs screen when changing menubar. This reduces flickering. */
2316
2317 ac = 0;
2318 XtSetArg (al[ac], XtNmappedWhenManaged, 0); ac++;
2319 XtSetArg (al[ac], XtNshowGrip, 0); ac++;
2320 XtSetArg (al[ac], XtNallowResize, 1); ac++;
2321 XtSetArg (al[ac], XtNresizeToPreferred, 1); ac++;
2322 XtSetArg (al[ac], XtNemacsFrame, f); ac++;
2323 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2324 XtSetArg (al[ac], XtNdepth, FRAME_DISPLAY_INFO (f)->n_planes); ac++;
2325 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2326 XtSetArg (al[ac], XtNborderWidth, 0); ac++;
2327 frame_widget = XtCreateWidget (f->namebuf, emacsFrameClass, pane_widget,
2328 al, ac);
2329
2330 f->output_data.x->edit_widget = frame_widget;
2331
2332 XtManageChild (frame_widget);
2333
2334 /* Do some needed geometry management. */
2335 {
2336 Arg gal[3];
2337 int gac = 0;
2338 int extra_borders = 0;
2339 int menubar_size
2340 = (f->output_data.x->menubar_widget
2341 ? (f->output_data.x->menubar_widget->core.height
2342 + f->output_data.x->menubar_widget->core.border_width)
2343 : 0);
2344
2345 #if false /* Experimentally, we now get the right results
2346 for -geometry -0-0 without this. 24 Aug 96, rms. */
2347 if (FRAME_EXTERNAL_MENU_BAR (f))
2348 {
2349 Dimension ibw = 0;
2350 XtVaGetValues (pane_widget, XtNinternalBorderWidth, &ibw, NULL);
2351 menubar_size += ibw;
2352 }
2353 #endif
2354
2355 FRAME_MENUBAR_HEIGHT (f) = menubar_size;
2356
2357 #ifndef USE_LUCID
2358 /* Motif seems to need this amount added to the sizes
2359 specified for the shell widget. The Athena/Lucid widgets don't.
2360 Both conclusions reached experimentally. -- rms. */
2361 XtVaGetValues (f->output_data.x->edit_widget, XtNinternalBorderWidth,
2362 &extra_borders, NULL);
2363 extra_borders *= 2;
2364 #endif
2365
2366 f->shell_position = xmalloc (sizeof "=x++" + 4 * INT_STRLEN_BOUND (int));
2367
2368 /* Convert our geometry parameters into a geometry string
2369 and specify it.
2370 Note that we do not specify here whether the position
2371 is a user-specified or program-specified one.
2372 We pass that information later, in x_wm_set_size_hints. */
2373 {
2374 int left = f->left_pos;
2375 bool xneg = (window_prompting & XNegative) != 0;
2376 int top = f->top_pos;
2377 bool yneg = (window_prompting & YNegative) != 0;
2378 if (xneg)
2379 left = -left;
2380 if (yneg)
2381 top = -top;
2382
2383 if (window_prompting & USPosition)
2384 sprintf (f->shell_position, "=%dx%d%c%d%c%d",
2385 FRAME_PIXEL_WIDTH (f) + extra_borders,
2386 FRAME_PIXEL_HEIGHT (f) + menubar_size + extra_borders,
2387 (xneg ? '-' : '+'), left,
2388 (yneg ? '-' : '+'), top);
2389 else
2390 {
2391 sprintf (f->shell_position, "=%dx%d",
2392 FRAME_PIXEL_WIDTH (f) + extra_borders,
2393 FRAME_PIXEL_HEIGHT (f) + menubar_size + extra_borders);
2394
2395 /* Setting x and y when the position is not specified in
2396 the geometry string will set program position in the WM hints.
2397 If Emacs had just one program position, we could set it in
2398 fallback resources, but since each make-frame call can specify
2399 different program positions, this is easier. */
2400 XtSetArg (gal[gac], XtNx, left); gac++;
2401 XtSetArg (gal[gac], XtNy, top); gac++;
2402 }
2403 }
2404
2405 XtSetArg (gal[gac], XtNgeometry, f->shell_position); gac++;
2406 XtSetValues (shell_widget, gal, gac);
2407 }
2408
2409 XtManageChild (pane_widget);
2410 XtRealizeWidget (shell_widget);
2411
2412 if (FRAME_X_EMBEDDED_P (f))
2413 XReparentWindow (FRAME_X_DISPLAY (f), XtWindow (shell_widget),
2414 f->output_data.x->parent_desc, 0, 0);
2415
2416 FRAME_X_WINDOW (f) = XtWindow (frame_widget);
2417
2418 validate_x_resource_name ();
2419
2420 class_hints.res_name = SSDATA (Vx_resource_name);
2421 class_hints.res_class = SSDATA (Vx_resource_class);
2422 XSetClassHint (FRAME_X_DISPLAY (f), XtWindow (shell_widget), &class_hints);
2423
2424 #ifdef HAVE_X_I18N
2425 FRAME_XIC (f) = NULL;
2426 if (use_xim)
2427 create_frame_xic (f);
2428 #endif
2429
2430 f->output_data.x->wm_hints.input = True;
2431 f->output_data.x->wm_hints.flags |= InputHint;
2432 XSetWMHints (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2433 &f->output_data.x->wm_hints);
2434
2435 hack_wm_protocols (f, shell_widget);
2436
2437 #ifdef HACK_EDITRES
2438 XtAddEventHandler (shell_widget, 0, True, _XEditResCheckMessages, 0);
2439 #endif
2440
2441 /* Do a stupid property change to force the server to generate a
2442 PropertyNotify event so that the event_stream server timestamp will
2443 be initialized to something relevant to the time we created the window.
2444 */
2445 XChangeProperty (XtDisplay (frame_widget), XtWindow (frame_widget),
2446 FRAME_DISPLAY_INFO (f)->Xatom_wm_protocols,
2447 XA_ATOM, 32, PropModeAppend, NULL, 0);
2448
2449 /* Make all the standard events reach the Emacs frame. */
2450 attributes.event_mask = STANDARD_EVENT_SET;
2451
2452 #ifdef HAVE_X_I18N
2453 if (FRAME_XIC (f))
2454 {
2455 /* XIM server might require some X events. */
2456 unsigned long fevent = NoEventMask;
2457 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2458 attributes.event_mask |= fevent;
2459 }
2460 #endif /* HAVE_X_I18N */
2461
2462 attribute_mask = CWEventMask;
2463 XChangeWindowAttributes (XtDisplay (shell_widget), XtWindow (shell_widget),
2464 attribute_mask, &attributes);
2465
2466 XtMapWidget (frame_widget);
2467
2468 /* x_set_name normally ignores requests to set the name if the
2469 requested name is the same as the current name. This is the one
2470 place where that assumption isn't correct; f->name is set, but
2471 the X server hasn't been told. */
2472 {
2473 Lisp_Object name;
2474 bool explicit = f->explicit_name;
2475
2476 f->explicit_name = false;
2477 name = f->name;
2478 fset_name (f, Qnil);
2479 x_set_name (f, name, explicit);
2480 }
2481
2482 XDefineCursor (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2483 f->output_data.x->current_cursor
2484 = f->output_data.x->text_cursor);
2485
2486 unblock_input ();
2487
2488 /* This is a no-op, except under Motif. Make sure main areas are
2489 set to something reasonable, in case we get an error later. */
2490 lw_set_main_areas (pane_widget, 0, frame_widget);
2491 }
2492
2493 #else /* not USE_X_TOOLKIT */
2494 #ifdef USE_GTK
2495 static void
2496 x_window (struct frame *f)
2497 {
2498 if (! xg_create_frame_widgets (f))
2499 error ("Unable to create window");
2500
2501 #ifdef HAVE_X_I18N
2502 FRAME_XIC (f) = NULL;
2503 if (use_xim)
2504 {
2505 block_input ();
2506 create_frame_xic (f);
2507 if (FRAME_XIC (f))
2508 {
2509 /* XIM server might require some X events. */
2510 unsigned long fevent = NoEventMask;
2511 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2512
2513 if (fevent != NoEventMask)
2514 {
2515 XSetWindowAttributes attributes;
2516 XWindowAttributes wattr;
2517 unsigned long attribute_mask;
2518
2519 XGetWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2520 &wattr);
2521 attributes.event_mask = wattr.your_event_mask | fevent;
2522 attribute_mask = CWEventMask;
2523 XChangeWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2524 attribute_mask, &attributes);
2525 }
2526 }
2527 unblock_input ();
2528 }
2529 #endif
2530 }
2531
2532 #else /*! USE_GTK */
2533 /* Create and set up the X window for frame F. */
2534
2535 static void
2536 x_window (struct frame *f)
2537 {
2538 XClassHint class_hints;
2539 XSetWindowAttributes attributes;
2540 unsigned long attribute_mask;
2541
2542 attributes.background_pixel = FRAME_BACKGROUND_PIXEL (f);
2543 attributes.border_pixel = f->output_data.x->border_pixel;
2544 attributes.bit_gravity = StaticGravity;
2545 attributes.backing_store = NotUseful;
2546 attributes.save_under = True;
2547 attributes.event_mask = STANDARD_EVENT_SET;
2548 attributes.colormap = FRAME_X_COLORMAP (f);
2549 attribute_mask = (CWBackPixel | CWBorderPixel | CWBitGravity | CWEventMask
2550 | CWColormap);
2551
2552 block_input ();
2553 FRAME_X_WINDOW (f)
2554 = XCreateWindow (FRAME_X_DISPLAY (f),
2555 f->output_data.x->parent_desc,
2556 f->left_pos,
2557 f->top_pos,
2558 FRAME_PIXEL_WIDTH (f), FRAME_PIXEL_HEIGHT (f),
2559 f->border_width,
2560 CopyFromParent, /* depth */
2561 InputOutput, /* class */
2562 FRAME_X_VISUAL (f),
2563 attribute_mask, &attributes);
2564
2565 #ifdef HAVE_X_I18N
2566 if (use_xim)
2567 {
2568 create_frame_xic (f);
2569 if (FRAME_XIC (f))
2570 {
2571 /* XIM server might require some X events. */
2572 unsigned long fevent = NoEventMask;
2573 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2574 attributes.event_mask |= fevent;
2575 attribute_mask = CWEventMask;
2576 XChangeWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2577 attribute_mask, &attributes);
2578 }
2579 }
2580 #endif /* HAVE_X_I18N */
2581
2582 validate_x_resource_name ();
2583
2584 class_hints.res_name = SSDATA (Vx_resource_name);
2585 class_hints.res_class = SSDATA (Vx_resource_class);
2586 XSetClassHint (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), &class_hints);
2587
2588 /* This indicates that we use the "Passive Input" input model.
2589 Unless we do this, we don't get the Focus{In,Out} events that we
2590 need to draw the cursor correctly. Accursed bureaucrats.
2591 XWhipsAndChains (FRAME_X_DISPLAY (f), IronMaiden, &TheRack); */
2592
2593 f->output_data.x->wm_hints.input = True;
2594 f->output_data.x->wm_hints.flags |= InputHint;
2595 XSetWMHints (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2596 &f->output_data.x->wm_hints);
2597 f->output_data.x->wm_hints.icon_pixmap = None;
2598
2599 /* Request "save yourself" and "delete window" commands from wm. */
2600 {
2601 Atom protocols[2];
2602 protocols[0] = FRAME_DISPLAY_INFO (f)->Xatom_wm_delete_window;
2603 protocols[1] = FRAME_DISPLAY_INFO (f)->Xatom_wm_save_yourself;
2604 XSetWMProtocols (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), protocols, 2);
2605 }
2606
2607 /* x_set_name normally ignores requests to set the name if the
2608 requested name is the same as the current name. This is the one
2609 place where that assumption isn't correct; f->name is set, but
2610 the X server hasn't been told. */
2611 {
2612 Lisp_Object name;
2613 bool explicit = f->explicit_name;
2614
2615 f->explicit_name = false;
2616 name = f->name;
2617 fset_name (f, Qnil);
2618 x_set_name (f, name, explicit);
2619 }
2620
2621 XDefineCursor (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2622 f->output_data.x->current_cursor
2623 = f->output_data.x->text_cursor);
2624
2625 unblock_input ();
2626
2627 if (FRAME_X_WINDOW (f) == 0)
2628 error ("Unable to create window");
2629 }
2630
2631 #endif /* not USE_GTK */
2632 #endif /* not USE_X_TOOLKIT */
2633
2634 /* Verify that the icon position args for this window are valid. */
2635
2636 static void
2637 x_icon_verify (struct frame *f, Lisp_Object parms)
2638 {
2639 Lisp_Object icon_x, icon_y;
2640
2641 /* Set the position of the icon. Note that twm groups all
2642 icons in an icon window. */
2643 icon_x = x_frame_get_and_record_arg (f, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
2644 icon_y = x_frame_get_and_record_arg (f, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
2645 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
2646 {
2647 CHECK_NUMBER (icon_x);
2648 CHECK_NUMBER (icon_y);
2649 }
2650 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
2651 error ("Both left and top icon corners of icon must be specified");
2652 }
2653
2654 /* Handle the icon stuff for this window. Perhaps later we might
2655 want an x_set_icon_position which can be called interactively as
2656 well. */
2657
2658 static void
2659 x_icon (struct frame *f, Lisp_Object parms)
2660 {
2661 /* Set the position of the icon. Note that twm groups all
2662 icons in an icon window. */
2663 Lisp_Object icon_x
2664 = x_frame_get_and_record_arg (f, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
2665 Lisp_Object icon_y
2666 = x_frame_get_and_record_arg (f, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
2667 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
2668 {
2669 CHECK_TYPE_RANGED_INTEGER (int, icon_x);
2670 CHECK_TYPE_RANGED_INTEGER (int, icon_y);
2671 }
2672 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
2673 error ("Both left and top icon corners of icon must be specified");
2674
2675 block_input ();
2676
2677 if (! EQ (icon_x, Qunbound))
2678 x_wm_set_icon_position (f, XINT (icon_x), XINT (icon_y));
2679
2680 #if false /* x_get_arg removes the visibility parameter as a side effect,
2681 but x_create_frame still needs it. */
2682 /* Start up iconic or window? */
2683 struct x_display_info *dpyinfo = FRAME_DISPLAY_INFO (f);
2684 x_wm_set_window_state
2685 (f, (EQ (x_get_arg (dpyinfo, parms, Qvisibility, 0, 0, RES_TYPE_SYMBOL),
2686 Qicon)
2687 ? IconicState
2688 : NormalState));
2689 #endif
2690
2691 x_text_icon (f, SSDATA ((!NILP (f->icon_name)
2692 ? f->icon_name
2693 : f->name)));
2694
2695 unblock_input ();
2696 }
2697
2698 /* Make the GCs needed for this window, setting the
2699 background, border and mouse colors; also create the
2700 mouse cursor and the gray border tile. */
2701
2702 static void
2703 x_make_gc (struct frame *f)
2704 {
2705 XGCValues gc_values;
2706
2707 block_input ();
2708
2709 /* Create the GCs of this frame.
2710 Note that many default values are used. */
2711
2712 gc_values.foreground = FRAME_FOREGROUND_PIXEL (f);
2713 gc_values.background = FRAME_BACKGROUND_PIXEL (f);
2714 gc_values.line_width = 0; /* Means 1 using fast algorithm. */
2715 f->output_data.x->normal_gc
2716 = XCreateGC (FRAME_X_DISPLAY (f),
2717 FRAME_X_WINDOW (f),
2718 GCLineWidth | GCForeground | GCBackground,
2719 &gc_values);
2720
2721 /* Reverse video style. */
2722 gc_values.foreground = FRAME_BACKGROUND_PIXEL (f);
2723 gc_values.background = FRAME_FOREGROUND_PIXEL (f);
2724 f->output_data.x->reverse_gc
2725 = XCreateGC (FRAME_X_DISPLAY (f),
2726 FRAME_X_WINDOW (f),
2727 GCForeground | GCBackground | GCLineWidth,
2728 &gc_values);
2729
2730 /* Cursor has cursor-color background, background-color foreground. */
2731 gc_values.foreground = FRAME_BACKGROUND_PIXEL (f);
2732 gc_values.background = f->output_data.x->cursor_pixel;
2733 gc_values.fill_style = FillOpaqueStippled;
2734 f->output_data.x->cursor_gc
2735 = XCreateGC (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2736 (GCForeground | GCBackground
2737 | GCFillStyle | GCLineWidth),
2738 &gc_values);
2739
2740 /* Create the gray border tile used when the pointer is not in
2741 the frame. Since this depends on the frame's pixel values,
2742 this must be done on a per-frame basis. */
2743 f->output_data.x->border_tile
2744 = (XCreatePixmapFromBitmapData
2745 (FRAME_X_DISPLAY (f), FRAME_DISPLAY_INFO (f)->root_window,
2746 gray_bits, gray_width, gray_height,
2747 FRAME_FOREGROUND_PIXEL (f),
2748 FRAME_BACKGROUND_PIXEL (f),
2749 DefaultDepth (FRAME_X_DISPLAY (f), FRAME_X_SCREEN_NUMBER (f))));
2750
2751 unblock_input ();
2752 }
2753
2754
2755 /* Free what was allocated in x_make_gc. */
2756
2757 void
2758 x_free_gcs (struct frame *f)
2759 {
2760 Display *dpy = FRAME_X_DISPLAY (f);
2761
2762 block_input ();
2763
2764 if (f->output_data.x->normal_gc)
2765 {
2766 XFreeGC (dpy, f->output_data.x->normal_gc);
2767 f->output_data.x->normal_gc = 0;
2768 }
2769
2770 if (f->output_data.x->reverse_gc)
2771 {
2772 XFreeGC (dpy, f->output_data.x->reverse_gc);
2773 f->output_data.x->reverse_gc = 0;
2774 }
2775
2776 if (f->output_data.x->cursor_gc)
2777 {
2778 XFreeGC (dpy, f->output_data.x->cursor_gc);
2779 f->output_data.x->cursor_gc = 0;
2780 }
2781
2782 if (f->output_data.x->border_tile)
2783 {
2784 XFreePixmap (dpy, f->output_data.x->border_tile);
2785 f->output_data.x->border_tile = 0;
2786 }
2787
2788 unblock_input ();
2789 }
2790
2791
2792 /* Handler for signals raised during x_create_frame and
2793 x_create_tip_frame. FRAME is the frame which is partially
2794 constructed. */
2795
2796 static Lisp_Object
2797 unwind_create_frame (Lisp_Object frame)
2798 {
2799 struct frame *f = XFRAME (frame);
2800
2801 /* If frame is already dead, nothing to do. This can happen if the
2802 display is disconnected after the frame has become official, but
2803 before x_create_frame removes the unwind protect. */
2804 if (!FRAME_LIVE_P (f))
2805 return Qnil;
2806
2807 /* If frame is ``official'', nothing to do. */
2808 if (NILP (Fmemq (frame, Vframe_list)))
2809 {
2810 #if defined GLYPH_DEBUG && defined ENABLE_CHECKING
2811 struct x_display_info *dpyinfo = FRAME_DISPLAY_INFO (f);
2812 #endif
2813
2814 x_free_frame_resources (f);
2815 free_glyphs (f);
2816
2817 #if defined GLYPH_DEBUG && defined ENABLE_CHECKING
2818 /* Check that reference counts are indeed correct. */
2819 eassert (dpyinfo->reference_count == dpyinfo_refcount);
2820 eassert (dpyinfo->terminal->image_cache->refcount == image_cache_refcount);
2821 #endif
2822 return Qt;
2823 }
2824
2825 return Qnil;
2826 }
2827
2828 static void
2829 do_unwind_create_frame (Lisp_Object frame)
2830 {
2831 unwind_create_frame (frame);
2832 }
2833
2834 static void
2835 x_default_font_parameter (struct frame *f, Lisp_Object parms)
2836 {
2837 struct x_display_info *dpyinfo = FRAME_DISPLAY_INFO (f);
2838 Lisp_Object font_param = x_get_arg (dpyinfo, parms, Qfont, NULL, NULL,
2839 RES_TYPE_STRING);
2840 Lisp_Object font = Qnil;
2841 if (EQ (font_param, Qunbound))
2842 font_param = Qnil;
2843
2844 if (NILP (font_param))
2845 {
2846 /* System font should take precedence over X resources. We suggest this
2847 regardless of font-use-system-font because .emacs may not have been
2848 read yet. */
2849 const char *system_font = xsettings_get_system_font ();
2850 if (system_font)
2851 font = font_open_by_name (f, build_unibyte_string (system_font));
2852 }
2853
2854 if (NILP (font))
2855 font = !NILP (font_param) ? font_param
2856 : x_get_arg (dpyinfo, parms, Qfont, "font", "Font", RES_TYPE_STRING);
2857
2858 if (! FONTP (font) && ! STRINGP (font))
2859 {
2860 const char *names[]
2861 = {
2862 #ifdef HAVE_XFT
2863 /* This will find the normal Xft font. */
2864 "monospace-10",
2865 #endif
2866 "-adobe-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-1",
2867 "-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-1",
2868 "-*-*-medium-r-normal-*-*-140-*-*-c-*-iso8859-1",
2869 /* This was formerly the first thing tried, but it finds
2870 too many fonts and takes too long. */
2871 "-*-*-medium-r-*-*-*-*-*-*-c-*-iso8859-1",
2872 /* If those didn't work, look for something which will
2873 at least work. */
2874 "-*-fixed-*-*-*-*-*-140-*-*-c-*-iso8859-1",
2875 "fixed",
2876 NULL };
2877 int i;
2878
2879 for (i = 0; names[i]; i++)
2880 {
2881 font = font_open_by_name (f, build_unibyte_string (names[i]));
2882 if (! NILP (font))
2883 break;
2884 }
2885 if (NILP (font))
2886 error ("No suitable font was found");
2887 }
2888 else if (!NILP (font_param))
2889 {
2890 /* Remember the explicit font parameter, so we can re-apply it after
2891 we've applied the `default' face settings. */
2892 AUTO_FRAME_ARG (arg, Qfont_param, font_param);
2893 x_set_frame_parameters (f, arg);
2894 }
2895
2896 /* This call will make X resources override any system font setting. */
2897 x_default_parameter (f, parms, Qfont, font, "font", "Font", RES_TYPE_STRING);
2898 }
2899
2900
2901 DEFUN ("x-wm-set-size-hint", Fx_wm_set_size_hint, Sx_wm_set_size_hint,
2902 0, 1, 0,
2903 doc: /* Send the size hints for frame FRAME to the window manager.
2904 If FRAME is omitted or nil, use the selected frame.
2905 Signal error if FRAME is not an X frame. */)
2906 (Lisp_Object frame)
2907 {
2908 struct frame *f = decode_window_system_frame (frame);
2909
2910 block_input ();
2911 x_wm_set_size_hint (f, 0, false);
2912 unblock_input ();
2913 return Qnil;
2914 }
2915
2916 static void
2917 set_machine_and_pid_properties (struct frame *f)
2918 {
2919 /* This will set WM_CLIENT_MACHINE and WM_LOCALE_NAME. */
2920 XSetWMProperties (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), NULL, NULL,
2921 NULL, 0, NULL, NULL, NULL);
2922 pid_t pid = getpid ();
2923 if (pid <= 0xffffffffu)
2924 {
2925 unsigned long xpid = pid;
2926 XChangeProperty (FRAME_X_DISPLAY (f),
2927 FRAME_OUTER_WINDOW (f),
2928 XInternAtom (FRAME_X_DISPLAY (f),
2929 "_NET_WM_PID",
2930 False),
2931 XA_CARDINAL, 32, PropModeReplace,
2932 (unsigned char *) &xpid, 1);
2933 }
2934 }
2935
2936 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
2937 1, 1, 0,
2938 doc: /* Make a new X window, which is called a "frame" in Emacs terms.
2939 Return an Emacs frame object. PARMS is an alist of frame parameters.
2940 If the parameters specify that the frame should not have a minibuffer,
2941 and do not specify a specific minibuffer window to use, then
2942 `default-minibuffer-frame' must be a frame whose minibuffer can be
2943 shared by the new frame.
2944
2945 This function is an internal primitive--use `make-frame' instead. */)
2946 (Lisp_Object parms)
2947 {
2948 struct frame *f;
2949 Lisp_Object frame, tem;
2950 Lisp_Object name;
2951 bool minibuffer_only = false;
2952 long window_prompting = 0;
2953 ptrdiff_t count = SPECPDL_INDEX ();
2954 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
2955 Lisp_Object display;
2956 struct x_display_info *dpyinfo = NULL;
2957 Lisp_Object parent;
2958 struct kboard *kb;
2959
2960 parms = Fcopy_alist (parms);
2961
2962 /* Use this general default value to start with
2963 until we know if this frame has a specified name. */
2964 Vx_resource_name = Vinvocation_name;
2965
2966 display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_NUMBER);
2967 if (EQ (display, Qunbound))
2968 display = x_get_arg (dpyinfo, parms, Qdisplay, 0, 0, RES_TYPE_STRING);
2969 if (EQ (display, Qunbound))
2970 display = Qnil;
2971 dpyinfo = check_x_display_info (display);
2972 kb = dpyinfo->terminal->kboard;
2973
2974 if (!dpyinfo->terminal->name)
2975 error ("Terminal is not live, can't create new frames on it");
2976
2977 name = x_get_arg (dpyinfo, parms, Qname, "name", "Name", RES_TYPE_STRING);
2978 if (!STRINGP (name)
2979 && ! EQ (name, Qunbound)
2980 && ! NILP (name))
2981 error ("Invalid frame name--not a string or nil");
2982
2983 if (STRINGP (name))
2984 Vx_resource_name = name;
2985
2986 /* See if parent window is specified. */
2987 parent = x_get_arg (dpyinfo, parms, Qparent_id, NULL, NULL, RES_TYPE_NUMBER);
2988 if (EQ (parent, Qunbound))
2989 parent = Qnil;
2990 if (! NILP (parent))
2991 CHECK_NUMBER (parent);
2992
2993 /* make_frame_without_minibuffer can run Lisp code and garbage collect. */
2994 /* No need to protect DISPLAY because that's not used after passing
2995 it to make_frame_without_minibuffer. */
2996 frame = Qnil;
2997 GCPRO4 (parms, parent, name, frame);
2998 tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
2999 RES_TYPE_SYMBOL);
3000 if (EQ (tem, Qnone) || NILP (tem))
3001 f = make_frame_without_minibuffer (Qnil, kb, display);
3002 else if (EQ (tem, Qonly))
3003 {
3004 f = make_minibuffer_frame ();
3005 minibuffer_only = true;
3006 }
3007 else if (WINDOWP (tem))
3008 f = make_frame_without_minibuffer (tem, kb, display);
3009 else
3010 f = make_frame (true);
3011
3012 XSETFRAME (frame, f);
3013
3014 f->terminal = dpyinfo->terminal;
3015
3016 f->output_method = output_x_window;
3017 f->output_data.x = xzalloc (sizeof *f->output_data.x);
3018 f->output_data.x->icon_bitmap = -1;
3019 FRAME_FONTSET (f) = -1;
3020 f->output_data.x->scroll_bar_foreground_pixel = -1;
3021 f->output_data.x->scroll_bar_background_pixel = -1;
3022 #if defined (USE_LUCID) && defined (USE_TOOLKIT_SCROLL_BARS)
3023 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
3024 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
3025 #endif /* USE_LUCID && USE_TOOLKIT_SCROLL_BARS */
3026 f->output_data.x->white_relief.pixel = -1;
3027 f->output_data.x->black_relief.pixel = -1;
3028
3029 fset_icon_name (f,
3030 x_get_arg (dpyinfo, parms, Qicon_name, "iconName", "Title",
3031 RES_TYPE_STRING));
3032 if (! STRINGP (f->icon_name))
3033 fset_icon_name (f, Qnil);
3034
3035 FRAME_DISPLAY_INFO (f) = dpyinfo;
3036
3037 /* With FRAME_DISPLAY_INFO set up, this unwind-protect is safe. */
3038 record_unwind_protect (do_unwind_create_frame, frame);
3039
3040 /* These colors will be set anyway later, but it's important
3041 to get the color reference counts right, so initialize them! */
3042 {
3043 Lisp_Object black;
3044 struct gcpro gcpro1;
3045
3046 /* Function x_decode_color can signal an error. Make
3047 sure to initialize color slots so that we won't try
3048 to free colors we haven't allocated. */
3049 FRAME_FOREGROUND_PIXEL (f) = -1;
3050 FRAME_BACKGROUND_PIXEL (f) = -1;
3051 f->output_data.x->cursor_pixel = -1;
3052 f->output_data.x->cursor_foreground_pixel = -1;
3053 f->output_data.x->border_pixel = -1;
3054 f->output_data.x->mouse_pixel = -1;
3055
3056 black = build_string ("black");
3057 GCPRO1 (black);
3058 FRAME_FOREGROUND_PIXEL (f)
3059 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3060 FRAME_BACKGROUND_PIXEL (f)
3061 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3062 f->output_data.x->cursor_pixel
3063 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3064 f->output_data.x->cursor_foreground_pixel
3065 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3066 f->output_data.x->border_pixel
3067 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3068 f->output_data.x->mouse_pixel
3069 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3070 UNGCPRO;
3071 }
3072
3073 /* Specify the parent under which to make this X window. */
3074 if (!NILP (parent))
3075 {
3076 f->output_data.x->parent_desc = (Window) XFASTINT (parent);
3077 f->output_data.x->explicit_parent = true;
3078 }
3079 else
3080 {
3081 f->output_data.x->parent_desc = FRAME_DISPLAY_INFO (f)->root_window;
3082 f->output_data.x->explicit_parent = false;
3083 }
3084
3085 /* Set the name; the functions to which we pass f expect the name to
3086 be set. */
3087 if (EQ (name, Qunbound) || NILP (name))
3088 {
3089 fset_name (f, build_string (dpyinfo->x_id_name));
3090 f->explicit_name = false;
3091 }
3092 else
3093 {
3094 fset_name (f, name);
3095 f->explicit_name = true;
3096 /* Use the frame's title when getting resources for this frame. */
3097 specbind (Qx_resource_name, name);
3098 }
3099
3100 #ifdef HAVE_FREETYPE
3101 #ifdef HAVE_XFT
3102 register_font_driver (&xftfont_driver, f);
3103 #else /* not HAVE_XFT */
3104 register_font_driver (&ftxfont_driver, f);
3105 #endif /* not HAVE_XFT */
3106 #endif /* HAVE_FREETYPE */
3107 register_font_driver (&xfont_driver, f);
3108
3109 x_default_parameter (f, parms, Qfont_backend, Qnil,
3110 "fontBackend", "FontBackend", RES_TYPE_STRING);
3111
3112 /* Extract the window parameters from the supplied values
3113 that are needed to determine window geometry. */
3114 x_default_font_parameter (f, parms);
3115 if (!FRAME_FONT (f))
3116 {
3117 delete_frame (frame, Qnoelisp);
3118 error ("Invalid frame font");
3119 }
3120
3121 /* Frame contents get displaced if an embedded X window has a border. */
3122 if (! FRAME_X_EMBEDDED_P (f))
3123 x_default_parameter (f, parms, Qborder_width, make_number (0),
3124 "borderWidth", "BorderWidth", RES_TYPE_NUMBER);
3125
3126 /* This defaults to 1 in order to match xterm. We recognize either
3127 internalBorderWidth or internalBorder (which is what xterm calls
3128 it). */
3129 if (NILP (Fassq (Qinternal_border_width, parms)))
3130 {
3131 Lisp_Object value;
3132
3133 value = x_get_arg (dpyinfo, parms, Qinternal_border_width,
3134 "internalBorder", "internalBorder", RES_TYPE_NUMBER);
3135 if (! EQ (value, Qunbound))
3136 parms = Fcons (Fcons (Qinternal_border_width, value),
3137 parms);
3138 }
3139 x_default_parameter (f, parms, Qinternal_border_width,
3140 #ifdef USE_GTK /* We used to impose 0 in xg_create_frame_widgets. */
3141 make_number (0),
3142 #else
3143 make_number (1),
3144 #endif
3145 "internalBorderWidth", "internalBorderWidth",
3146 RES_TYPE_NUMBER);
3147 x_default_parameter (f, parms, Qright_divider_width, make_number (0),
3148 NULL, NULL, RES_TYPE_NUMBER);
3149 x_default_parameter (f, parms, Qbottom_divider_width, make_number (0),
3150 NULL, NULL, RES_TYPE_NUMBER);
3151 x_default_parameter (f, parms, Qvertical_scroll_bars,
3152 #if defined (USE_GTK) && defined (USE_TOOLKIT_SCROLL_BARS)
3153 Qright,
3154 #else
3155 Qleft,
3156 #endif
3157 "verticalScrollBars", "ScrollBars",
3158 RES_TYPE_SYMBOL);
3159 x_default_parameter (f, parms, Qhorizontal_scroll_bars, Qnil,
3160 "horizontalScrollBars", "ScrollBars",
3161 RES_TYPE_SYMBOL);
3162 /* Also do the stuff which must be set before the window exists. */
3163 x_default_parameter (f, parms, Qforeground_color, build_string ("black"),
3164 "foreground", "Foreground", RES_TYPE_STRING);
3165 x_default_parameter (f, parms, Qbackground_color, build_string ("white"),
3166 "background", "Background", RES_TYPE_STRING);
3167 x_default_parameter (f, parms, Qmouse_color, build_string ("black"),
3168 "pointerColor", "Foreground", RES_TYPE_STRING);
3169 x_default_parameter (f, parms, Qborder_color, build_string ("black"),
3170 "borderColor", "BorderColor", RES_TYPE_STRING);
3171 x_default_parameter (f, parms, Qscreen_gamma, Qnil,
3172 "screenGamma", "ScreenGamma", RES_TYPE_FLOAT);
3173 x_default_parameter (f, parms, Qline_spacing, Qnil,
3174 "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
3175 x_default_parameter (f, parms, Qleft_fringe, Qnil,
3176 "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
3177 x_default_parameter (f, parms, Qright_fringe, Qnil,
3178 "rightFringe", "RightFringe", RES_TYPE_NUMBER);
3179
3180 x_default_scroll_bar_color_parameter (f, parms, Qscroll_bar_foreground,
3181 "scrollBarForeground",
3182 "ScrollBarForeground", true);
3183 x_default_scroll_bar_color_parameter (f, parms, Qscroll_bar_background,
3184 "scrollBarBackground",
3185 "ScrollBarBackground", false);
3186
3187 #ifdef GLYPH_DEBUG
3188 image_cache_refcount =
3189 FRAME_IMAGE_CACHE (f) ? FRAME_IMAGE_CACHE (f)->refcount : 0;
3190 dpyinfo_refcount = dpyinfo->reference_count;
3191 #endif /* GLYPH_DEBUG */
3192
3193 /* Init faces before x_default_parameter is called for the
3194 scroll-bar-width parameter because otherwise we end up in
3195 init_iterator with a null face cache, which should not happen. */
3196 init_frame_faces (f);
3197
3198 /* The following call of change_frame_size is needed since otherwise
3199 x_set_tool_bar_lines will already work with the character sizes
3200 installed by init_frame_faces while the frame's pixel size is
3201 still calculated from a character size of 1 and we subsequently
3202 hit the (height >= 0) assertion in window_box_height.
3203
3204 The non-pixelwise code apparently worked around this because it
3205 had one frame line vs one toolbar line which left us with a zero
3206 root window height which was obviously wrong as well ... */
3207 adjust_frame_size (f, FRAME_COLS (f) * FRAME_COLUMN_WIDTH (f),
3208 FRAME_LINES (f) * FRAME_LINE_HEIGHT (f), 5, true,
3209 Qx_create_frame_1);
3210
3211 /* Set the menu-bar-lines and tool-bar-lines parameters. We don't
3212 look up the X resources controlling the menu-bar and tool-bar
3213 here; they are processed specially at startup, and reflected in
3214 the values of the mode variables. */
3215
3216 x_default_parameter (f, parms, Qmenu_bar_lines,
3217 NILP (Vmenu_bar_mode)
3218 ? make_number (0) : make_number (1),
3219 NULL, NULL, RES_TYPE_NUMBER);
3220 x_default_parameter (f, parms, Qtool_bar_lines,
3221 NILP (Vtool_bar_mode)
3222 ? make_number (0) : make_number (1),
3223 NULL, NULL, RES_TYPE_NUMBER);
3224
3225 x_default_parameter (f, parms, Qbuffer_predicate, Qnil,
3226 "bufferPredicate", "BufferPredicate",
3227 RES_TYPE_SYMBOL);
3228 x_default_parameter (f, parms, Qtitle, Qnil,
3229 "title", "Title", RES_TYPE_STRING);
3230 x_default_parameter (f, parms, Qwait_for_wm, Qt,
3231 "waitForWM", "WaitForWM", RES_TYPE_BOOLEAN);
3232 x_default_parameter (f, parms, Qtool_bar_position,
3233 FRAME_TOOL_BAR_POSITION (f), 0, 0, RES_TYPE_SYMBOL);
3234
3235 /* Compute the size of the X window. */
3236 window_prompting = x_figure_window_size (f, parms, true);
3237
3238 tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
3239 f->no_split = minibuffer_only || EQ (tem, Qt);
3240
3241 x_icon_verify (f, parms);
3242
3243 /* Create the X widget or window. */
3244 #ifdef USE_X_TOOLKIT
3245 x_window (f, window_prompting);
3246 #else
3247 x_window (f);
3248 #endif
3249
3250 x_icon (f, parms);
3251 x_make_gc (f);
3252
3253 /* Now consider the frame official. */
3254 f->terminal->reference_count++;
3255 FRAME_DISPLAY_INFO (f)->reference_count++;
3256 Vframe_list = Fcons (frame, Vframe_list);
3257
3258 /* We need to do this after creating the X window, so that the
3259 icon-creation functions can say whose icon they're describing. */
3260 x_default_parameter (f, parms, Qicon_type, Qt,
3261 "bitmapIcon", "BitmapIcon", RES_TYPE_BOOLEAN);
3262
3263 x_default_parameter (f, parms, Qauto_raise, Qnil,
3264 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
3265 x_default_parameter (f, parms, Qauto_lower, Qnil,
3266 "autoLower", "AutoRaiseLower", RES_TYPE_BOOLEAN);
3267 x_default_parameter (f, parms, Qcursor_type, Qbox,
3268 "cursorType", "CursorType", RES_TYPE_SYMBOL);
3269 x_default_parameter (f, parms, Qscroll_bar_width, Qnil,
3270 "scrollBarWidth", "ScrollBarWidth",
3271 RES_TYPE_NUMBER);
3272 x_default_parameter (f, parms, Qscroll_bar_height, Qnil,
3273 "scrollBarHeight", "ScrollBarHeight",
3274 RES_TYPE_NUMBER);
3275 x_default_parameter (f, parms, Qalpha, Qnil,
3276 "alpha", "Alpha", RES_TYPE_NUMBER);
3277
3278 /* Consider frame official, now. */
3279 f->can_x_set_window_size = true;
3280
3281 adjust_frame_size (f, FRAME_TEXT_WIDTH (f), FRAME_TEXT_HEIGHT (f), 0, true,
3282 Qx_create_frame_2);
3283
3284 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
3285 /* Create the menu bar. */
3286 if (!minibuffer_only && FRAME_EXTERNAL_MENU_BAR (f))
3287 {
3288 /* If this signals an error, we haven't set size hints for the
3289 frame and we didn't make it visible. */
3290 initialize_frame_menubar (f);
3291
3292 #ifndef USE_GTK
3293 /* This is a no-op, except under Motif where it arranges the
3294 main window for the widgets on it. */
3295 lw_set_main_areas (f->output_data.x->column_widget,
3296 f->output_data.x->menubar_widget,
3297 f->output_data.x->edit_widget);
3298 #endif /* not USE_GTK */
3299 }
3300 #endif /* USE_X_TOOLKIT || USE_GTK */
3301
3302 /* Tell the server what size and position, etc, we want, and how
3303 badly we want them. This should be done after we have the menu
3304 bar so that its size can be taken into account. */
3305 block_input ();
3306 x_wm_set_size_hint (f, window_prompting, false);
3307 unblock_input ();
3308
3309 /* Process fullscreen parameter here in the hope that normalizing a
3310 fullheight/fullwidth frame will produce the size set by the last
3311 adjust_frame_size call. */
3312 x_default_parameter (f, parms, Qfullscreen, Qnil,
3313 "fullscreen", "Fullscreen", RES_TYPE_SYMBOL);
3314
3315 /* Make the window appear on the frame and enable display, unless
3316 the caller says not to. However, with explicit parent, Emacs
3317 cannot control visibility, so don't try. */
3318 if (! f->output_data.x->explicit_parent)
3319 {
3320 Lisp_Object visibility;
3321
3322 visibility = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0,
3323 RES_TYPE_SYMBOL);
3324 if (EQ (visibility, Qunbound))
3325 visibility = Qt;
3326
3327 if (EQ (visibility, Qicon))
3328 x_iconify_frame (f);
3329 else if (! NILP (visibility))
3330 x_make_frame_visible (f);
3331 else
3332 {
3333 /* Must have been Qnil. */
3334 }
3335 }
3336
3337 block_input ();
3338
3339 /* Set machine name and pid for the purpose of window managers. */
3340 set_machine_and_pid_properties (f);
3341
3342 /* Set the WM leader property. GTK does this itself, so this is not
3343 needed when using GTK. */
3344 if (dpyinfo->client_leader_window != 0)
3345 {
3346 XChangeProperty (FRAME_X_DISPLAY (f),
3347 FRAME_OUTER_WINDOW (f),
3348 dpyinfo->Xatom_wm_client_leader,
3349 XA_WINDOW, 32, PropModeReplace,
3350 (unsigned char *) &dpyinfo->client_leader_window, 1);
3351 }
3352
3353 unblock_input ();
3354
3355 /* Initialize `default-minibuffer-frame' in case this is the first
3356 frame on this terminal. */
3357 if (FRAME_HAS_MINIBUF_P (f)
3358 && (!FRAMEP (KVAR (kb, Vdefault_minibuffer_frame))
3359 || !FRAME_LIVE_P (XFRAME (KVAR (kb, Vdefault_minibuffer_frame)))))
3360 kset_default_minibuffer_frame (kb, frame);
3361
3362 /* All remaining specified parameters, which have not been "used"
3363 by x_get_arg and friends, now go in the misc. alist of the frame. */
3364 for (tem = parms; CONSP (tem); tem = XCDR (tem))
3365 if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
3366 fset_param_alist (f, Fcons (XCAR (tem), f->param_alist));
3367
3368 UNGCPRO;
3369
3370 /* Make sure windows on this frame appear in calls to next-window
3371 and similar functions. */
3372 Vwindow_list = Qnil;
3373
3374 return unbind_to (count, frame);
3375 }
3376
3377
3378 /* FRAME is used only to get a handle on the X display. We don't pass the
3379 display info directly because we're called from frame.c, which doesn't
3380 know about that structure. */
3381
3382 Lisp_Object
3383 x_get_focus_frame (struct frame *frame)
3384 {
3385 struct x_display_info *dpyinfo = FRAME_DISPLAY_INFO (frame);
3386 Lisp_Object xfocus;
3387 if (! dpyinfo->x_focus_frame)
3388 return Qnil;
3389
3390 XSETFRAME (xfocus, dpyinfo->x_focus_frame);
3391 return xfocus;
3392 }
3393
3394
3395 /* In certain situations, when the window manager follows a
3396 click-to-focus policy, there seems to be no way around calling
3397 XSetInputFocus to give another frame the input focus .
3398
3399 In an ideal world, XSetInputFocus should generally be avoided so
3400 that applications don't interfere with the window manager's focus
3401 policy. But I think it's okay to use when it's clearly done
3402 following a user-command. */
3403
3404 void
3405 x_focus_frame (struct frame *f)
3406 {
3407 Display *dpy = FRAME_X_DISPLAY (f);
3408
3409 block_input ();
3410 x_catch_errors (dpy);
3411
3412 if (FRAME_X_EMBEDDED_P (f))
3413 {
3414 /* For Xembedded frames, normally the embedder forwards key
3415 events. See XEmbed Protocol Specification at
3416 http://freedesktop.org/wiki/Specifications/xembed-spec */
3417 xembed_request_focus (f);
3418 }
3419 else
3420 {
3421 XSetInputFocus (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
3422 RevertToParent, CurrentTime);
3423 x_ewmh_activate_frame (f);
3424 }
3425
3426 x_uncatch_errors ();
3427 unblock_input ();
3428 }
3429
3430 \f
3431 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
3432 doc: /* Internal function called by `color-defined-p', which see
3433 .\(Note that the Nextstep version of this function ignores FRAME.) */)
3434 (Lisp_Object color, Lisp_Object frame)
3435 {
3436 XColor foo;
3437 struct frame *f = decode_window_system_frame (frame);
3438
3439 CHECK_STRING (color);
3440
3441 if (x_defined_color (f, SSDATA (color), &foo, false))
3442 return Qt;
3443 else
3444 return Qnil;
3445 }
3446
3447 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
3448 doc: /* Internal function called by `color-values', which see. */)
3449 (Lisp_Object color, Lisp_Object frame)
3450 {
3451 XColor foo;
3452 struct frame *f = decode_window_system_frame (frame);
3453
3454 CHECK_STRING (color);
3455
3456 if (x_defined_color (f, SSDATA (color), &foo, false))
3457 return list3i (foo.red, foo.green, foo.blue);
3458 else
3459 return Qnil;
3460 }
3461
3462 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
3463 doc: /* Internal function called by `display-color-p', which see. */)
3464 (Lisp_Object terminal)
3465 {
3466 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3467
3468 if (dpyinfo->n_planes <= 2)
3469 return Qnil;
3470
3471 switch (dpyinfo->visual->class)
3472 {
3473 case StaticColor:
3474 case PseudoColor:
3475 case TrueColor:
3476 case DirectColor:
3477 return Qt;
3478
3479 default:
3480 return Qnil;
3481 }
3482 }
3483
3484 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p, Sx_display_grayscale_p,
3485 0, 1, 0,
3486 doc: /* Return t if the X display supports shades of gray.
3487 Note that color displays do support shades of gray.
3488 The optional argument TERMINAL specifies which display to ask about.
3489 TERMINAL should be a terminal object, a frame or a display name (a string).
3490 If omitted or nil, that stands for the selected frame's display. */)
3491 (Lisp_Object terminal)
3492 {
3493 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3494
3495 if (dpyinfo->n_planes <= 1)
3496 return Qnil;
3497
3498 switch (dpyinfo->visual->class)
3499 {
3500 case StaticColor:
3501 case PseudoColor:
3502 case TrueColor:
3503 case DirectColor:
3504 case StaticGray:
3505 case GrayScale:
3506 return Qt;
3507
3508 default:
3509 return Qnil;
3510 }
3511 }
3512
3513 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
3514 0, 1, 0,
3515 doc: /* Return the width in pixels of the X display TERMINAL.
3516 The optional argument TERMINAL specifies which display to ask about.
3517 TERMINAL should be a terminal object, a frame or a display name (a string).
3518 If omitted or nil, that stands for the selected frame's display.
3519
3520 On \"multi-monitor\" setups this refers to the pixel width for all
3521 physical monitors associated with TERMINAL. To get information for
3522 each physical monitor, use `display-monitor-attributes-list'. */)
3523 (Lisp_Object terminal)
3524 {
3525 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3526
3527 return make_number (x_display_pixel_width (dpyinfo));
3528 }
3529
3530 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
3531 Sx_display_pixel_height, 0, 1, 0,
3532 doc: /* Return the height in pixels of the X display TERMINAL.
3533 The optional argument TERMINAL specifies which display to ask about.
3534 TERMINAL should be a terminal object, a frame or a display name (a string).
3535 If omitted or nil, that stands for the selected frame's display.
3536
3537 On \"multi-monitor\" setups this refers to the pixel height for all
3538 physical monitors associated with TERMINAL. To get information for
3539 each physical monitor, use `display-monitor-attributes-list'. */)
3540 (Lisp_Object terminal)
3541 {
3542 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3543
3544 return make_number (x_display_pixel_height (dpyinfo));
3545 }
3546
3547 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
3548 0, 1, 0,
3549 doc: /* Return the number of bitplanes of the X display TERMINAL.
3550 The optional argument TERMINAL specifies which display to ask about.
3551 TERMINAL should be a terminal object, a frame or a display name (a string).
3552 If omitted or nil, that stands for the selected frame's display. */)
3553 (Lisp_Object terminal)
3554 {
3555 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3556
3557 return make_number (dpyinfo->n_planes);
3558 }
3559
3560 DEFUN ("x-display-color-cells", Fx_display_color_cells, Sx_display_color_cells,
3561 0, 1, 0,
3562 doc: /* Return the number of color cells of the X display TERMINAL.
3563 The optional argument TERMINAL specifies which display to ask about.
3564 TERMINAL should be a terminal object, a frame or a display name (a string).
3565 If omitted or nil, that stands for the selected frame's display. */)
3566 (Lisp_Object terminal)
3567 {
3568 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3569
3570 int nr_planes = DisplayPlanes (dpyinfo->display,
3571 XScreenNumberOfScreen (dpyinfo->screen));
3572
3573 /* Truncate nr_planes to 24 to avoid integer overflow.
3574 Some displays says 32, but only 24 bits are actually significant.
3575 There are only very few and rare video cards that have more than
3576 24 significant bits. Also 24 bits is more than 16 million colors,
3577 it "should be enough for everyone". */
3578 if (nr_planes > 24) nr_planes = 24;
3579
3580 return make_number (1 << nr_planes);
3581 }
3582
3583 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
3584 Sx_server_max_request_size,
3585 0, 1, 0,
3586 doc: /* Return the maximum request size of the X server of display TERMINAL.
3587 The optional argument TERMINAL specifies which display to ask about.
3588 TERMINAL should be a terminal object, a frame or a display name (a string).
3589 If omitted or nil, that stands for the selected frame's display. */)
3590 (Lisp_Object terminal)
3591 {
3592 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3593
3594 return make_number (MAXREQUEST (dpyinfo->display));
3595 }
3596
3597 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
3598 doc: /* Return the "vendor ID" string of the GUI software on TERMINAL.
3599
3600 \(Labeling every distributor as a "vendor" embodies the false assumption
3601 that operating systems cannot be developed and distributed noncommercially.)
3602 The optional argument TERMINAL specifies which display to ask about.
3603
3604 For GNU and Unix systems, this queries the X server software; for
3605 MS-Windows, this queries the OS.
3606
3607 TERMINAL should be a terminal object, a frame or a display name (a string).
3608 If omitted or nil, that stands for the selected frame's display. */)
3609 (Lisp_Object terminal)
3610 {
3611 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3612 const char *vendor = ServerVendor (dpyinfo->display);
3613
3614 if (! vendor) vendor = "";
3615 return build_string (vendor);
3616 }
3617
3618 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
3619 doc: /* Return the version numbers of the GUI software on TERMINAL.
3620 The value is a list of three integers specifying the version of the GUI
3621 software in use.
3622
3623 For GNU and Unix system, the first 2 numbers are the version of the X
3624 Protocol used on TERMINAL and the 3rd number is the distributor-specific
3625 release number. For MS-Windows, the 3 numbers report the version and
3626 the build number of the OS.
3627
3628 See also the function `x-server-vendor'.
3629
3630 The optional argument TERMINAL specifies which display to ask about.
3631 TERMINAL should be a terminal object, a frame or a display name (a string).
3632 If omitted or nil, that stands for the selected frame's display. */)
3633 (Lisp_Object terminal)
3634 {
3635 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3636 Display *dpy = dpyinfo->display;
3637
3638 return list3i (ProtocolVersion (dpy), ProtocolRevision (dpy),
3639 VendorRelease (dpy));
3640 }
3641
3642 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
3643 doc: /* Return the number of screens on the X server of display TERMINAL.
3644 The optional argument TERMINAL specifies which display to ask about.
3645 TERMINAL should be a terminal object, a frame or a display name (a string).
3646 If omitted or nil, that stands for the selected frame's display. */)
3647 (Lisp_Object terminal)
3648 {
3649 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3650
3651 return make_number (ScreenCount (dpyinfo->display));
3652 }
3653
3654 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height, 0, 1, 0,
3655 doc: /* Return the height in millimeters of the X display TERMINAL.
3656 The optional argument TERMINAL specifies which display to ask about.
3657 TERMINAL should be a terminal object, a frame or a display name (a string).
3658 If omitted or nil, that stands for the selected frame's display.
3659
3660 On \"multi-monitor\" setups this refers to the height in millimeters for
3661 all physical monitors associated with TERMINAL. To get information
3662 for each physical monitor, use `display-monitor-attributes-list'. */)
3663 (Lisp_Object terminal)
3664 {
3665 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3666
3667 return make_number (HeightMMOfScreen (dpyinfo->screen));
3668 }
3669
3670 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width, 0, 1, 0,
3671 doc: /* Return the width in millimeters of the X display TERMINAL.
3672 The optional argument TERMINAL specifies which display to ask about.
3673 TERMINAL should be a terminal object, a frame or a display name (a string).
3674 If omitted or nil, that stands for the selected frame's display.
3675
3676 On \"multi-monitor\" setups this refers to the width in millimeters for
3677 all physical monitors associated with TERMINAL. To get information
3678 for each physical monitor, use `display-monitor-attributes-list'. */)
3679 (Lisp_Object terminal)
3680 {
3681 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3682
3683 return make_number (WidthMMOfScreen (dpyinfo->screen));
3684 }
3685
3686 DEFUN ("x-display-backing-store", Fx_display_backing_store,
3687 Sx_display_backing_store, 0, 1, 0,
3688 doc: /* Return an indication of whether X display TERMINAL does backing store.
3689 The value may be `always', `when-mapped', or `not-useful'.
3690 The optional argument TERMINAL specifies which display to ask about.
3691 TERMINAL should be a terminal object, a frame or a display name (a string).
3692 If omitted or nil, that stands for the selected frame's display. */)
3693 (Lisp_Object terminal)
3694 {
3695 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3696 Lisp_Object result;
3697
3698 switch (DoesBackingStore (dpyinfo->screen))
3699 {
3700 case Always:
3701 result = intern ("always");
3702 break;
3703
3704 case WhenMapped:
3705 result = intern ("when-mapped");
3706 break;
3707
3708 case NotUseful:
3709 result = intern ("not-useful");
3710 break;
3711
3712 default:
3713 error ("Strange value for BackingStore parameter of screen");
3714 }
3715
3716 return result;
3717 }
3718
3719 DEFUN ("x-display-visual-class", Fx_display_visual_class,
3720 Sx_display_visual_class, 0, 1, 0,
3721 doc: /* Return the visual class of the X display TERMINAL.
3722 The value is one of the symbols `static-gray', `gray-scale',
3723 `static-color', `pseudo-color', `true-color', or `direct-color'.
3724
3725 The optional argument TERMINAL specifies which display to ask about.
3726 TERMINAL should a terminal object, a frame or a display name (a string).
3727 If omitted or nil, that stands for the selected frame's display. */)
3728 (Lisp_Object terminal)
3729 {
3730 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3731 Lisp_Object result;
3732
3733 switch (dpyinfo->visual->class)
3734 {
3735 case StaticGray:
3736 result = intern ("static-gray");
3737 break;
3738 case GrayScale:
3739 result = intern ("gray-scale");
3740 break;
3741 case StaticColor:
3742 result = intern ("static-color");
3743 break;
3744 case PseudoColor:
3745 result = intern ("pseudo-color");
3746 break;
3747 case TrueColor:
3748 result = intern ("true-color");
3749 break;
3750 case DirectColor:
3751 result = intern ("direct-color");
3752 break;
3753 default:
3754 error ("Display has an unknown visual class");
3755 }
3756
3757 return result;
3758 }
3759
3760 DEFUN ("x-display-save-under", Fx_display_save_under,
3761 Sx_display_save_under, 0, 1, 0,
3762 doc: /* Return t if the X display TERMINAL supports the save-under feature.
3763 The optional argument TERMINAL specifies which display to ask about.
3764 TERMINAL should be a terminal object, a frame or a display name (a string).
3765 If omitted or nil, that stands for the selected frame's display. */)
3766 (Lisp_Object terminal)
3767 {
3768 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3769
3770 if (DoesSaveUnders (dpyinfo->screen) == True)
3771 return Qt;
3772 else
3773 return Qnil;
3774 }
3775
3776 /* Store the geometry of the workarea on display DPYINFO into *RECT.
3777 Return false if and only if the workarea information cannot be
3778 obtained via the _NET_WORKAREA root window property. */
3779
3780 #if ! GTK_CHECK_VERSION (3, 4, 0)
3781 static bool
3782 x_get_net_workarea (struct x_display_info *dpyinfo, XRectangle *rect)
3783 {
3784 Display *dpy = dpyinfo->display;
3785 long offset, max_len;
3786 Atom target_type, actual_type;
3787 unsigned long actual_size, bytes_remaining;
3788 int rc, actual_format;
3789 unsigned char *tmp_data = NULL;
3790 bool result = false;
3791
3792 x_catch_errors (dpy);
3793 offset = 0;
3794 max_len = 1;
3795 target_type = XA_CARDINAL;
3796 rc = XGetWindowProperty (dpy, dpyinfo->root_window,
3797 dpyinfo->Xatom_net_current_desktop,
3798 offset, max_len, False, target_type,
3799 &actual_type, &actual_format, &actual_size,
3800 &bytes_remaining, &tmp_data);
3801 if (rc == Success && actual_type == target_type && !x_had_errors_p (dpy)
3802 && actual_format == 32 && actual_size == max_len)
3803 {
3804 long current_desktop = ((long *) tmp_data)[0];
3805
3806 XFree (tmp_data);
3807 tmp_data = NULL;
3808
3809 offset = 4 * current_desktop;
3810 max_len = 4;
3811 rc = XGetWindowProperty (dpy, dpyinfo->root_window,
3812 dpyinfo->Xatom_net_workarea,
3813 offset, max_len, False, target_type,
3814 &actual_type, &actual_format, &actual_size,
3815 &bytes_remaining, &tmp_data);
3816 if (rc == Success && actual_type == target_type && !x_had_errors_p (dpy)
3817 && actual_format == 32 && actual_size == max_len)
3818 {
3819 long *values = (long *) tmp_data;
3820
3821 rect->x = values[0];
3822 rect->y = values[1];
3823 rect->width = values[2];
3824 rect->height = values[3];
3825
3826 XFree (tmp_data);
3827 tmp_data = NULL;
3828
3829 result = true;
3830 }
3831 }
3832 if (tmp_data)
3833 XFree (tmp_data);
3834 x_uncatch_errors ();
3835
3836 return result;
3837 }
3838 #endif
3839
3840 #ifndef USE_GTK
3841
3842 /* Return monitor number where F is "most" or closest to. */
3843 static int
3844 x_get_monitor_for_frame (struct frame *f,
3845 struct MonitorInfo *monitors,
3846 int n_monitors)
3847 {
3848 XRectangle frect;
3849 int area = 0, dist = -1;
3850 int best_area = -1, best_dist = -1;
3851 int i;
3852
3853 if (n_monitors == 1) return 0;
3854 frect.x = f->left_pos;
3855 frect.y = f->top_pos;
3856 frect.width = FRAME_PIXEL_WIDTH (f);
3857 frect.height = FRAME_PIXEL_HEIGHT (f);
3858
3859 for (i = 0; i < n_monitors; ++i)
3860 {
3861 struct MonitorInfo *mi = &monitors[i];
3862 XRectangle res;
3863 int a = 0;
3864
3865 if (mi->geom.width == 0) continue;
3866
3867 if (x_intersect_rectangles (&mi->geom, &frect, &res))
3868 {
3869 a = res.width * res.height;
3870 if (a > area)
3871 {
3872 area = a;
3873 best_area = i;
3874 }
3875 }
3876
3877 if (a == 0 && area == 0)
3878 {
3879 int dx, dy, d;
3880 if (frect.x + frect.width < mi->geom.x)
3881 dx = mi->geom.x - frect.x + frect.width;
3882 else if (frect.x > mi->geom.x + mi->geom.width)
3883 dx = frect.x - mi->geom.x + mi->geom.width;
3884 else
3885 dx = 0;
3886 if (frect.y + frect.height < mi->geom.y)
3887 dy = mi->geom.y - frect.y + frect.height;
3888 else if (frect.y > mi->geom.y + mi->geom.height)
3889 dy = frect.y - mi->geom.y + mi->geom.height;
3890 else
3891 dy = 0;
3892
3893 d = dx*dx + dy*dy;
3894 if (dist == -1 || dist > d)
3895 {
3896 dist = d;
3897 best_dist = i;
3898 }
3899 }
3900 }
3901
3902 return best_area != -1 ? best_area : (best_dist != -1 ? best_dist : 0);
3903 }
3904
3905 static Lisp_Object
3906 x_make_monitor_attribute_list (struct MonitorInfo *monitors,
3907 int n_monitors,
3908 int primary_monitor,
3909 struct x_display_info *dpyinfo,
3910 const char *source)
3911 {
3912 Lisp_Object monitor_frames = Fmake_vector (make_number (n_monitors), Qnil);
3913 Lisp_Object frame, rest;
3914
3915 FOR_EACH_FRAME (rest, frame)
3916 {
3917 struct frame *f = XFRAME (frame);
3918
3919 if (FRAME_X_P (f) && FRAME_DISPLAY_INFO (f) == dpyinfo
3920 && !EQ (frame, tip_frame))
3921 {
3922 int i = x_get_monitor_for_frame (f, monitors, n_monitors);
3923 ASET (monitor_frames, i, Fcons (frame, AREF (monitor_frames, i)));
3924 }
3925 }
3926
3927 return make_monitor_attribute_list (monitors, n_monitors, primary_monitor,
3928 monitor_frames, source);
3929 }
3930
3931 static Lisp_Object
3932 x_get_monitor_attributes_fallback (struct x_display_info *dpyinfo)
3933 {
3934 struct MonitorInfo monitor;
3935 XRectangle workarea_r;
3936
3937 /* Fallback: treat (possibly) multiple physical monitors as if they
3938 formed a single monitor as a whole. This should provide a
3939 consistent result at least on single monitor environments. */
3940 monitor.geom.x = monitor.geom.y = 0;
3941 monitor.geom.width = x_display_pixel_width (dpyinfo);
3942 monitor.geom.height = x_display_pixel_height (dpyinfo);
3943 monitor.mm_width = WidthMMOfScreen (dpyinfo->screen);
3944 monitor.mm_height = HeightMMOfScreen (dpyinfo->screen);
3945 monitor.name = xstrdup ("combined screen");
3946
3947 if (x_get_net_workarea (dpyinfo, &workarea_r))
3948 monitor.work = workarea_r;
3949 else
3950 monitor.work = monitor.geom;
3951 return x_make_monitor_attribute_list (&monitor, 1, 0, dpyinfo, "fallback");
3952 }
3953
3954
3955 #ifdef HAVE_XINERAMA
3956 static Lisp_Object
3957 x_get_monitor_attributes_xinerama (struct x_display_info *dpyinfo)
3958 {
3959 int n_monitors, i;
3960 Lisp_Object attributes_list = Qnil;
3961 Display *dpy = dpyinfo->display;
3962 XineramaScreenInfo *info = XineramaQueryScreens (dpy, &n_monitors);
3963 struct MonitorInfo *monitors;
3964 double mm_width_per_pixel, mm_height_per_pixel;
3965
3966 if (! info || n_monitors == 0)
3967 {
3968 if (info)
3969 XFree (info);
3970 return attributes_list;
3971 }
3972
3973 mm_width_per_pixel = ((double) WidthMMOfScreen (dpyinfo->screen)
3974 / x_display_pixel_width (dpyinfo));
3975 mm_height_per_pixel = ((double) HeightMMOfScreen (dpyinfo->screen)
3976 / x_display_pixel_height (dpyinfo));
3977 monitors = xzalloc (n_monitors * sizeof *monitors);
3978 for (i = 0; i < n_monitors; ++i)
3979 {
3980 struct MonitorInfo *mi = &monitors[i];
3981 XRectangle workarea_r;
3982
3983 mi->geom.x = info[i].x_org;
3984 mi->geom.y = info[i].y_org;
3985 mi->geom.width = info[i].width;
3986 mi->geom.height = info[i].height;
3987 mi->mm_width = mi->geom.width * mm_width_per_pixel + 0.5;
3988 mi->mm_height = mi->geom.height * mm_height_per_pixel + 0.5;
3989 mi->name = 0;
3990
3991 /* Xinerama usually have primary monitor first, just use that. */
3992 if (i == 0 && x_get_net_workarea (dpyinfo, &workarea_r))
3993 {
3994 mi->work = workarea_r;
3995 if (! x_intersect_rectangles (&mi->geom, &mi->work, &mi->work))
3996 mi->work = mi->geom;
3997 }
3998 else
3999 mi->work = mi->geom;
4000 }
4001 XFree (info);
4002
4003 attributes_list = x_make_monitor_attribute_list (monitors,
4004 n_monitors,
4005 0,
4006 dpyinfo,
4007 "Xinerama");
4008 free_monitors (monitors, n_monitors);
4009 return attributes_list;
4010 }
4011 #endif /* HAVE_XINERAMA */
4012
4013
4014 #ifdef HAVE_XRANDR
4015 static Lisp_Object
4016 x_get_monitor_attributes_xrandr (struct x_display_info *dpyinfo)
4017 {
4018 Lisp_Object attributes_list = Qnil;
4019 XRRScreenResources *resources;
4020 Display *dpy = dpyinfo->display;
4021 int i, n_monitors, primary = -1;
4022 RROutput pxid = None;
4023 struct MonitorInfo *monitors;
4024
4025 #ifdef HAVE_XRRGETSCREENRESOURCESCURRENT
4026 resources = XRRGetScreenResourcesCurrent (dpy, dpyinfo->root_window);
4027 #else
4028 resources = XRRGetScreenResources (dpy, dpyinfo->root_window);
4029 #endif
4030 if (! resources || resources->noutput == 0)
4031 {
4032 if (resources)
4033 XRRFreeScreenResources (resources);
4034 return Qnil;
4035 }
4036 n_monitors = resources->noutput;
4037 monitors = xzalloc (n_monitors * sizeof *monitors);
4038
4039 #ifdef HAVE_XRRGETOUTPUTPRIMARY
4040 pxid = XRRGetOutputPrimary (dpy, dpyinfo->root_window);
4041 #endif
4042
4043 for (i = 0; i < n_monitors; ++i)
4044 {
4045 XRROutputInfo *info = XRRGetOutputInfo (dpy, resources,
4046 resources->outputs[i]);
4047 Connection conn = info ? info->connection : RR_Disconnected;
4048 RRCrtc id = info ? info->crtc : None;
4049
4050 if (strcmp (info->name, "default") == 0)
4051 {
4052 /* Non XRandr 1.2 driver, does not give useful data. */
4053 XRRFreeOutputInfo (info);
4054 XRRFreeScreenResources (resources);
4055 free_monitors (monitors, n_monitors);
4056 return Qnil;
4057 }
4058
4059 if (conn != RR_Disconnected && id != None)
4060 {
4061 XRRCrtcInfo *crtc = XRRGetCrtcInfo (dpy, resources, id);
4062 struct MonitorInfo *mi = &monitors[i];
4063 XRectangle workarea_r;
4064
4065 if (! crtc)
4066 {
4067 XRRFreeOutputInfo (info);
4068 continue;
4069 }
4070
4071 mi->geom.x = crtc->x;
4072 mi->geom.y = crtc->y;
4073 mi->geom.width = crtc->width;
4074 mi->geom.height = crtc->height;
4075 mi->mm_width = info->mm_width;
4076 mi->mm_height = info->mm_height;
4077 mi->name = xstrdup (info->name);
4078
4079 if (pxid != None && pxid == resources->outputs[i])
4080 primary = i;
4081 else if (primary == -1 && strcmp (info->name, "LVDS") == 0)
4082 primary = i;
4083
4084 if (i == primary && x_get_net_workarea (dpyinfo, &workarea_r))
4085 {
4086 mi->work= workarea_r;
4087 if (! x_intersect_rectangles (&mi->geom, &mi->work, &mi->work))
4088 mi->work = mi->geom;
4089 }
4090 else
4091 mi->work = mi->geom;
4092
4093 XRRFreeCrtcInfo (crtc);
4094 }
4095 XRRFreeOutputInfo (info);
4096 }
4097 XRRFreeScreenResources (resources);
4098
4099 attributes_list = x_make_monitor_attribute_list (monitors,
4100 n_monitors,
4101 primary,
4102 dpyinfo,
4103 "XRandr");
4104 free_monitors (monitors, n_monitors);
4105 return attributes_list;
4106 }
4107 #endif /* HAVE_XRANDR */
4108
4109 static Lisp_Object
4110 x_get_monitor_attributes (struct x_display_info *dpyinfo)
4111 {
4112 Lisp_Object attributes_list = Qnil;
4113 Display *dpy = dpyinfo->display;
4114
4115 (void) dpy; /* Suppress unused variable warning. */
4116
4117 #ifdef HAVE_XRANDR
4118 int xrr_event_base, xrr_error_base;
4119 bool xrr_ok = false;
4120 xrr_ok = XRRQueryExtension (dpy, &xrr_event_base, &xrr_error_base);
4121 if (xrr_ok)
4122 {
4123 int xrr_major, xrr_minor;
4124 XRRQueryVersion (dpy, &xrr_major, &xrr_minor);
4125 xrr_ok = (xrr_major == 1 && xrr_minor >= 2) || xrr_major > 1;
4126 }
4127
4128 if (xrr_ok)
4129 attributes_list = x_get_monitor_attributes_xrandr (dpyinfo);
4130 #endif /* HAVE_XRANDR */
4131
4132 #ifdef HAVE_XINERAMA
4133 if (NILP (attributes_list))
4134 {
4135 int xin_event_base, xin_error_base;
4136 bool xin_ok = false;
4137 xin_ok = XineramaQueryExtension (dpy, &xin_event_base, &xin_error_base);
4138 if (xin_ok && XineramaIsActive (dpy))
4139 attributes_list = x_get_monitor_attributes_xinerama (dpyinfo);
4140 }
4141 #endif /* HAVE_XINERAMA */
4142
4143 if (NILP (attributes_list))
4144 attributes_list = x_get_monitor_attributes_fallback (dpyinfo);
4145
4146 return attributes_list;
4147 }
4148
4149 #endif /* !USE_GTK */
4150
4151 DEFUN ("x-display-monitor-attributes-list", Fx_display_monitor_attributes_list,
4152 Sx_display_monitor_attributes_list,
4153 0, 1, 0,
4154 doc: /* Return a list of physical monitor attributes on the X display TERMINAL.
4155
4156 The optional argument TERMINAL specifies which display to ask about.
4157 TERMINAL should be a terminal object, a frame or a display name (a string).
4158 If omitted or nil, that stands for the selected frame's display.
4159
4160 In addition to the standard attribute keys listed in
4161 `display-monitor-attributes-list', the following keys are contained in
4162 the attributes:
4163
4164 source -- String describing the source from which multi-monitor
4165 information is obtained, one of \"Gdk\", \"XRandr\",
4166 \"Xinerama\", or \"fallback\"
4167
4168 Internal use only, use `display-monitor-attributes-list' instead. */)
4169 (Lisp_Object terminal)
4170 {
4171 struct x_display_info *dpyinfo = check_x_display_info (terminal);
4172 Lisp_Object attributes_list = Qnil;
4173
4174 #ifdef USE_GTK
4175 double mm_width_per_pixel, mm_height_per_pixel;
4176 GdkDisplay *gdpy;
4177 GdkScreen *gscreen;
4178 gint primary_monitor = 0, n_monitors, i;
4179 Lisp_Object monitor_frames, rest, frame;
4180 static const char *source = "Gdk";
4181 struct MonitorInfo *monitors;
4182
4183 block_input ();
4184 mm_width_per_pixel = ((double) WidthMMOfScreen (dpyinfo->screen)
4185 / x_display_pixel_width (dpyinfo));
4186 mm_height_per_pixel = ((double) HeightMMOfScreen (dpyinfo->screen)
4187 / x_display_pixel_height (dpyinfo));
4188 gdpy = gdk_x11_lookup_xdisplay (dpyinfo->display);
4189 gscreen = gdk_display_get_default_screen (gdpy);
4190 #if GTK_CHECK_VERSION (2, 20, 0)
4191 primary_monitor = gdk_screen_get_primary_monitor (gscreen);
4192 #endif
4193 n_monitors = gdk_screen_get_n_monitors (gscreen);
4194 monitor_frames = Fmake_vector (make_number (n_monitors), Qnil);
4195 monitors = xzalloc (n_monitors * sizeof *monitors);
4196
4197 FOR_EACH_FRAME (rest, frame)
4198 {
4199 struct frame *f = XFRAME (frame);
4200
4201 if (FRAME_X_P (f) && FRAME_DISPLAY_INFO (f) == dpyinfo
4202 && !EQ (frame, tip_frame))
4203 {
4204 GdkWindow *gwin = gtk_widget_get_window (FRAME_GTK_WIDGET (f));
4205
4206 i = gdk_screen_get_monitor_at_window (gscreen, gwin);
4207 ASET (monitor_frames, i, Fcons (frame, AREF (monitor_frames, i)));
4208 }
4209 }
4210
4211 for (i = 0; i < n_monitors; ++i)
4212 {
4213 gint width_mm = -1, height_mm = -1;
4214 GdkRectangle rec, work;
4215 struct MonitorInfo *mi = &monitors[i];
4216
4217 gdk_screen_get_monitor_geometry (gscreen, i, &rec);
4218
4219 #if GTK_CHECK_VERSION (2, 14, 0)
4220 width_mm = gdk_screen_get_monitor_width_mm (gscreen, i);
4221 height_mm = gdk_screen_get_monitor_height_mm (gscreen, i);
4222 #endif
4223 if (width_mm < 0)
4224 width_mm = rec.width * mm_width_per_pixel + 0.5;
4225 if (height_mm < 0)
4226 height_mm = rec.height * mm_height_per_pixel + 0.5;
4227
4228 #if GTK_CHECK_VERSION (3, 4, 0)
4229 gdk_screen_get_monitor_workarea (gscreen, i, &work);
4230 #else
4231 /* Emulate the behavior of GTK+ 3.4. */
4232 {
4233 XRectangle workarea_r;
4234
4235 if (i == primary_monitor && x_get_net_workarea (dpyinfo, &workarea_r))
4236 {
4237 work.x = workarea_r.x;
4238 work.y = workarea_r.y;
4239 work.width = workarea_r.width;
4240 work.height = workarea_r.height;
4241 if (! gdk_rectangle_intersect (&rec, &work, &work))
4242 work = rec;
4243 }
4244 else
4245 work = rec;
4246 }
4247 #endif
4248
4249
4250 mi->geom.x = rec.x;
4251 mi->geom.y = rec.y;
4252 mi->geom.width = rec.width;
4253 mi->geom.height = rec.height;
4254 mi->work.x = work.x;
4255 mi->work.y = work.y;
4256 mi->work.width = work.width;
4257 mi->work.height = work.height;
4258 mi->mm_width = width_mm;
4259 mi->mm_height = height_mm;
4260
4261 #if GTK_CHECK_VERSION (2, 14, 0)
4262 mi->name = gdk_screen_get_monitor_plug_name (gscreen, i);
4263 #endif
4264 }
4265
4266 attributes_list = make_monitor_attribute_list (monitors,
4267 n_monitors,
4268 primary_monitor,
4269 monitor_frames,
4270 source);
4271 unblock_input ();
4272 #else /* not USE_GTK */
4273
4274 block_input ();
4275 attributes_list = x_get_monitor_attributes (dpyinfo);
4276 unblock_input ();
4277
4278 #endif /* not USE_GTK */
4279
4280 return attributes_list;
4281 }
4282
4283 DEFUN ("x-frame-geometry", Fx_frame_geometry, Sx_frame_geometry, 0, 1, 0,
4284 doc: /* Return geometric attributes of frame FRAME.
4285
4286 FRAME must be a live frame and defaults to the selected one.
4287
4288 The return value is an association list containing the following
4289 elements (all size values are in pixels).
4290
4291 - `frame-outer-size' is a cons of the outer width and height of FRAME.
4292 The outer size include the title bar and the external borders as well
4293 as any menu and/or tool bar of frame.
4294
4295 - `border' is a cons of the horizontal and vertical width of FRAME's
4296 external borders.
4297
4298 - `title-bar-height' is the height of the title bar of FRAME.
4299
4300 - `menu-bar-external' if `t' means the menu bar is external (not
4301 included in the inner edges of FRAME).
4302
4303 - `menu-bar-size' is a cons of the width and height of the menu bar of
4304 FRAME.
4305
4306 - `tool-bar-external' if `t' means the tool bar is external (not
4307 included in the inner edges of FRAME).
4308
4309 - `tool-bar-side' tells tells on which side the tool bar on FRAME is and
4310 can be one of `left', `top', `right' or `bottom'.
4311
4312 - `tool-bar-size' is a cons of the width and height of the tool bar of
4313 FRAME.
4314
4315 - `frame-inner-size' is a cons of the inner width and height of FRAME.
4316 This excludes FRAME's title bar and external border as well as any
4317 external menu and/or tool bar. */)
4318 (Lisp_Object frame)
4319 {
4320 struct frame *f = decode_live_frame (frame);
4321 int inner_width = FRAME_PIXEL_WIDTH (f);
4322 int inner_height = FRAME_PIXEL_HEIGHT (f);
4323 int outer_width, outer_height, border, title;
4324 Lisp_Object fullscreen = Fframe_parameter (frame, Qfullscreen);
4325 int menu_bar_height, menu_bar_width, tool_bar_height, tool_bar_width;
4326
4327 int left_off, right_off, top_off, bottom_off;
4328 XWindowAttributes atts;
4329
4330 block_input ();
4331
4332 XGetWindowAttributes (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &atts);
4333
4334 x_real_pos_and_offsets (f, &left_off, &right_off, &top_off, &bottom_off,
4335 NULL, NULL, NULL, NULL);
4336
4337 unblock_input ();
4338
4339 border = atts.border_width;
4340 title = top_off;
4341
4342 outer_width = FRAME_PIXEL_WIDTH (f) + 2 * border + right_off + left_off;
4343 outer_height = FRAME_PIXEL_HEIGHT (f) + 2 * border + top_off + bottom_off;
4344
4345 #if defined (USE_GTK)
4346 {
4347 bool tool_bar_left_right = (EQ (FRAME_TOOL_BAR_POSITION (f), Qleft)
4348 || EQ (FRAME_TOOL_BAR_POSITION (f), Qright));
4349
4350 tool_bar_width = (tool_bar_left_right
4351 ? FRAME_TOOLBAR_WIDTH (f)
4352 : FRAME_PIXEL_WIDTH (f));
4353 tool_bar_height = (tool_bar_left_right
4354 ? FRAME_PIXEL_HEIGHT (f)
4355 : FRAME_TOOLBAR_HEIGHT (f));
4356 }
4357 #else
4358 tool_bar_height = FRAME_TOOL_BAR_HEIGHT (f);
4359 tool_bar_width = tool_bar_height > 0 ? FRAME_PIXEL_WIDTH (f) : 0;
4360 #endif
4361
4362 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
4363 menu_bar_height = FRAME_MENUBAR_HEIGHT (f);
4364 #else
4365 menu_bar_height = FRAME_MENU_BAR_HEIGHT (f);
4366 #endif
4367
4368 menu_bar_width = menu_bar_height > 0 ? FRAME_PIXEL_WIDTH (f) : 0;
4369
4370 if (!FRAME_EXTERNAL_MENU_BAR (f))
4371 inner_height -= menu_bar_height;
4372 if (!FRAME_EXTERNAL_TOOL_BAR (f))
4373 inner_height -= tool_bar_height;
4374
4375 return
4376 listn (CONSTYPE_HEAP, 10,
4377 Fcons (Qframe_position,
4378 Fcons (make_number (f->left_pos), make_number (f->top_pos))),
4379 Fcons (Qframe_outer_size,
4380 Fcons (make_number (outer_width), make_number (outer_height))),
4381 Fcons (Qexternal_border_size,
4382 ((EQ (fullscreen, Qfullboth) || EQ (fullscreen, Qfullscreen))
4383 ? Fcons (make_number (0), make_number (0))
4384 : Fcons (make_number (border), make_number (border)))),
4385 Fcons (Qtitle_height,
4386 ((EQ (fullscreen, Qfullboth) || EQ (fullscreen, Qfullscreen))
4387 ? make_number (0)
4388 : make_number (title))),
4389 Fcons (Qmenu_bar_external, FRAME_EXTERNAL_MENU_BAR (f) ? Qt : Qnil),
4390 Fcons (Qmenu_bar_size,
4391 Fcons (make_number (menu_bar_width),
4392 make_number (menu_bar_height))),
4393 Fcons (Qtool_bar_external, FRAME_EXTERNAL_TOOL_BAR (f) ? Qt : Qnil),
4394 Fcons (Qtool_bar_position, FRAME_TOOL_BAR_POSITION (f)),
4395 Fcons (Qtool_bar_size,
4396 Fcons (make_number (tool_bar_width),
4397 make_number (tool_bar_height))),
4398 Fcons (Qframe_inner_size,
4399 Fcons (make_number (inner_width),
4400 make_number (inner_height))));
4401 }
4402
4403 /************************************************************************
4404 X Displays
4405 ************************************************************************/
4406
4407 \f
4408 /* Mapping visual names to visuals. */
4409
4410 static struct visual_class
4411 {
4412 const char *name;
4413 int class;
4414 }
4415 visual_classes[] =
4416 {
4417 {"StaticGray", StaticGray},
4418 {"GrayScale", GrayScale},
4419 {"StaticColor", StaticColor},
4420 {"PseudoColor", PseudoColor},
4421 {"TrueColor", TrueColor},
4422 {"DirectColor", DirectColor},
4423 {NULL, 0}
4424 };
4425
4426
4427 #ifndef HAVE_XSCREENNUMBEROFSCREEN
4428
4429 /* Value is the screen number of screen SCR. This is a substitute for
4430 the X function with the same name when that doesn't exist. */
4431
4432 int
4433 XScreenNumberOfScreen (scr)
4434 register Screen *scr;
4435 {
4436 Display *dpy = scr->display;
4437 int i;
4438
4439 for (i = 0; i < dpy->nscreens; ++i)
4440 if (scr == dpy->screens + i)
4441 break;
4442
4443 return i;
4444 }
4445
4446 #endif /* not HAVE_XSCREENNUMBEROFSCREEN */
4447
4448
4449 /* Select the visual that should be used on display DPYINFO. Set
4450 members of DPYINFO appropriately. Called from x_term_init. */
4451
4452 void
4453 select_visual (struct x_display_info *dpyinfo)
4454 {
4455 Display *dpy = dpyinfo->display;
4456 Screen *screen = dpyinfo->screen;
4457
4458 /* See if a visual is specified. */
4459 AUTO_STRING (visualClass, "visualClass");
4460 AUTO_STRING (VisualClass, "VisualClass");
4461 Lisp_Object value = display_x_get_resource (dpyinfo, visualClass,
4462 VisualClass, Qnil, Qnil);
4463
4464 if (STRINGP (value))
4465 {
4466 /* VALUE should be of the form CLASS-DEPTH, where CLASS is one
4467 of `PseudoColor', `TrueColor' etc. and DEPTH is the color
4468 depth, a decimal number. NAME is compared with case ignored. */
4469 char *s = alloca (SBYTES (value) + 1);
4470 char *dash;
4471 int i, class = -1;
4472 XVisualInfo vinfo;
4473
4474 lispstpcpy (s, value);
4475 dash = strchr (s, '-');
4476 if (dash)
4477 {
4478 dpyinfo->n_planes = atoi (dash + 1);
4479 *dash = '\0';
4480 }
4481 else
4482 /* We won't find a matching visual with depth 0, so that
4483 an error will be printed below. */
4484 dpyinfo->n_planes = 0;
4485
4486 /* Determine the visual class. */
4487 for (i = 0; visual_classes[i].name; ++i)
4488 if (xstrcasecmp (s, visual_classes[i].name) == 0)
4489 {
4490 class = visual_classes[i].class;
4491 break;
4492 }
4493
4494 /* Look up a matching visual for the specified class. */
4495 if (class == -1
4496 || !XMatchVisualInfo (dpy, XScreenNumberOfScreen (screen),
4497 dpyinfo->n_planes, class, &vinfo))
4498 fatal ("Invalid visual specification `%s'", SDATA (value));
4499
4500 dpyinfo->visual = vinfo.visual;
4501 }
4502 else
4503 {
4504 int n_visuals;
4505 XVisualInfo *vinfo, vinfo_template;
4506
4507 dpyinfo->visual = DefaultVisualOfScreen (screen);
4508
4509 vinfo_template.visualid = XVisualIDFromVisual (dpyinfo->visual);
4510 vinfo_template.screen = XScreenNumberOfScreen (screen);
4511 vinfo = XGetVisualInfo (dpy, VisualIDMask | VisualScreenMask,
4512 &vinfo_template, &n_visuals);
4513 if (n_visuals <= 0)
4514 fatal ("Can't get proper X visual info");
4515
4516 dpyinfo->n_planes = vinfo->depth;
4517 XFree (vinfo);
4518 }
4519 }
4520
4521
4522 /* Return the X display structure for the display named NAME.
4523 Open a new connection if necessary. */
4524
4525 static struct x_display_info *
4526 x_display_info_for_name (Lisp_Object name)
4527 {
4528 struct x_display_info *dpyinfo;
4529
4530 CHECK_STRING (name);
4531
4532 for (dpyinfo = x_display_list; dpyinfo; dpyinfo = dpyinfo->next)
4533 if (!NILP (Fstring_equal (XCAR (dpyinfo->name_list_element), name)))
4534 return dpyinfo;
4535
4536 /* Use this general default value to start with. */
4537 Vx_resource_name = Vinvocation_name;
4538
4539 validate_x_resource_name ();
4540
4541 dpyinfo = x_term_init (name, 0, SSDATA (Vx_resource_name));
4542
4543 if (dpyinfo == 0)
4544 error ("Cannot connect to X server %s", SDATA (name));
4545
4546 XSETFASTINT (Vwindow_system_version, 11);
4547
4548 return dpyinfo;
4549 }
4550
4551
4552 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
4553 1, 3, 0,
4554 doc: /* Open a connection to a display server.
4555 DISPLAY is the name of the display to connect to.
4556 Optional second arg XRM-STRING is a string of resources in xrdb format.
4557 If the optional third arg MUST-SUCCEED is non-nil,
4558 terminate Emacs if we can't open the connection.
4559 \(In the Nextstep version, the last two arguments are currently ignored.) */)
4560 (Lisp_Object display, Lisp_Object xrm_string, Lisp_Object must_succeed)
4561 {
4562 char *xrm_option;
4563 struct x_display_info *dpyinfo;
4564
4565 CHECK_STRING (display);
4566 if (! NILP (xrm_string))
4567 CHECK_STRING (xrm_string);
4568
4569 xrm_option = NILP (xrm_string) ? 0 : SSDATA (xrm_string);
4570
4571 validate_x_resource_name ();
4572
4573 /* This is what opens the connection and sets x_current_display.
4574 This also initializes many symbols, such as those used for input. */
4575 dpyinfo = x_term_init (display, xrm_option,
4576 SSDATA (Vx_resource_name));
4577
4578 if (dpyinfo == 0)
4579 {
4580 if (!NILP (must_succeed))
4581 fatal ("Cannot connect to X server %s.\n\
4582 Check the DISPLAY environment variable or use `-d'.\n\
4583 Also use the `xauth' program to verify that you have the proper\n\
4584 authorization information needed to connect the X server.\n\
4585 An insecure way to solve the problem may be to use `xhost'.\n",
4586 SDATA (display));
4587 else
4588 error ("Cannot connect to X server %s", SDATA (display));
4589 }
4590
4591 XSETFASTINT (Vwindow_system_version, 11);
4592 return Qnil;
4593 }
4594
4595 DEFUN ("x-close-connection", Fx_close_connection,
4596 Sx_close_connection, 1, 1, 0,
4597 doc: /* Close the connection to TERMINAL's X server.
4598 For TERMINAL, specify a terminal object, a frame or a display name (a
4599 string). If TERMINAL is nil, that stands for the selected frame's
4600 terminal. */)
4601 (Lisp_Object terminal)
4602 {
4603 struct x_display_info *dpyinfo = check_x_display_info (terminal);
4604
4605 if (dpyinfo->reference_count > 0)
4606 error ("Display still has frames on it");
4607
4608 x_delete_terminal (dpyinfo->terminal);
4609
4610 return Qnil;
4611 }
4612
4613 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
4614 doc: /* Return the list of display names that Emacs has connections to. */)
4615 (void)
4616 {
4617 Lisp_Object result = Qnil;
4618 struct x_display_info *xdi;
4619
4620 for (xdi = x_display_list; xdi; xdi = xdi->next)
4621 result = Fcons (XCAR (xdi->name_list_element), result);
4622
4623 return result;
4624 }
4625
4626 DEFUN ("x-synchronize", Fx_synchronize, Sx_synchronize, 1, 2, 0,
4627 doc: /* If ON is non-nil, report X errors as soon as the erring request is made.
4628 This function only has an effect on X Windows. With MS Windows, it is
4629 defined but does nothing.
4630
4631 If ON is nil, allow buffering of requests.
4632 Turning on synchronization prohibits the Xlib routines from buffering
4633 requests and seriously degrades performance, but makes debugging much
4634 easier.
4635 The optional second argument TERMINAL specifies which display to act on.
4636 TERMINAL should be a terminal object, a frame or a display name (a string).
4637 If TERMINAL is omitted or nil, that stands for the selected frame's display. */)
4638 (Lisp_Object on, Lisp_Object terminal)
4639 {
4640 struct x_display_info *dpyinfo = check_x_display_info (terminal);
4641
4642 XSynchronize (dpyinfo->display, !EQ (on, Qnil));
4643
4644 return Qnil;
4645 }
4646
4647 /* Wait for responses to all X commands issued so far for frame F. */
4648
4649 void
4650 x_sync (struct frame *f)
4651 {
4652 block_input ();
4653 XSync (FRAME_X_DISPLAY (f), False);
4654 unblock_input ();
4655 }
4656
4657 \f
4658 /***********************************************************************
4659 Window properties
4660 ***********************************************************************/
4661
4662 DEFUN ("x-change-window-property", Fx_change_window_property,
4663 Sx_change_window_property, 2, 6, 0,
4664 doc: /* Change window property PROP to VALUE on the X window of FRAME.
4665 PROP must be a string. VALUE may be a string or a list of conses,
4666 numbers and/or strings. If an element in the list is a string, it is
4667 converted to an atom and the value of the atom is used. If an element
4668 is a cons, it is converted to a 32 bit number where the car is the 16
4669 top bits and the cdr is the lower 16 bits.
4670
4671 FRAME nil or omitted means use the selected frame.
4672 If TYPE is given and non-nil, it is the name of the type of VALUE.
4673 If TYPE is not given or nil, the type is STRING.
4674 FORMAT gives the size in bits of each element if VALUE is a list.
4675 It must be one of 8, 16 or 32.
4676 If VALUE is a string or FORMAT is nil or not given, FORMAT defaults to 8.
4677 If OUTER-P is non-nil, the property is changed for the outer X window of
4678 FRAME. Default is to change on the edit X window. */)
4679 (Lisp_Object prop, Lisp_Object value, Lisp_Object frame,
4680 Lisp_Object type, Lisp_Object format, Lisp_Object outer_p)
4681 {
4682 struct frame *f = decode_window_system_frame (frame);
4683 Atom prop_atom;
4684 Atom target_type = XA_STRING;
4685 int element_format = 8;
4686 unsigned char *data;
4687 int nelements;
4688 Window w;
4689
4690 CHECK_STRING (prop);
4691
4692 if (! NILP (format))
4693 {
4694 CHECK_NUMBER (format);
4695
4696 if (XINT (format) != 8 && XINT (format) != 16
4697 && XINT (format) != 32)
4698 error ("FORMAT must be one of 8, 16 or 32");
4699 element_format = XINT (format);
4700 }
4701
4702 if (CONSP (value))
4703 {
4704 ptrdiff_t elsize;
4705
4706 nelements = x_check_property_data (value);
4707 if (nelements == -1)
4708 error ("Bad data in VALUE, must be number, string or cons");
4709
4710 /* The man page for XChangeProperty:
4711 "If the specified format is 32, the property data must be a
4712 long array."
4713 This applies even if long is more than 32 bits. The X library
4714 converts to 32 bits before sending to the X server. */
4715 elsize = element_format == 32 ? sizeof (long) : element_format >> 3;
4716 data = xnmalloc (nelements, elsize);
4717
4718 x_fill_property_data (FRAME_X_DISPLAY (f), value, data, element_format);
4719 }
4720 else
4721 {
4722 CHECK_STRING (value);
4723 data = SDATA (value);
4724 if (INT_MAX < SBYTES (value))
4725 error ("VALUE too long");
4726 nelements = SBYTES (value);
4727 }
4728
4729 block_input ();
4730 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SSDATA (prop), False);
4731 if (! NILP (type))
4732 {
4733 CHECK_STRING (type);
4734 target_type = XInternAtom (FRAME_X_DISPLAY (f), SSDATA (type), False);
4735 }
4736
4737 if (! NILP (outer_p)) w = FRAME_OUTER_WINDOW (f);
4738 else w = FRAME_X_WINDOW (f);
4739
4740 XChangeProperty (FRAME_X_DISPLAY (f), w,
4741 prop_atom, target_type, element_format, PropModeReplace,
4742 data, nelements);
4743
4744 if (CONSP (value)) xfree (data);
4745
4746 /* Make sure the property is set when we return. */
4747 XFlush (FRAME_X_DISPLAY (f));
4748 unblock_input ();
4749
4750 return value;
4751 }
4752
4753
4754 DEFUN ("x-delete-window-property", Fx_delete_window_property,
4755 Sx_delete_window_property, 1, 2, 0,
4756 doc: /* Remove window property PROP from X window of FRAME.
4757 FRAME nil or omitted means use the selected frame. Value is PROP. */)
4758 (Lisp_Object prop, Lisp_Object frame)
4759 {
4760 struct frame *f = decode_window_system_frame (frame);
4761 Atom prop_atom;
4762
4763 CHECK_STRING (prop);
4764 block_input ();
4765 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SSDATA (prop), False);
4766 XDeleteProperty (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), prop_atom);
4767
4768 /* Make sure the property is removed when we return. */
4769 XFlush (FRAME_X_DISPLAY (f));
4770 unblock_input ();
4771
4772 return prop;
4773 }
4774
4775
4776 static Lisp_Object
4777 x_window_property_intern (struct frame *f,
4778 Window target_window,
4779 Atom prop_atom,
4780 Atom target_type,
4781 Lisp_Object delete_p,
4782 Lisp_Object vector_ret_p,
4783 bool *found)
4784 {
4785 unsigned char *tmp_data = NULL;
4786 Lisp_Object prop_value = Qnil;
4787 Atom actual_type;
4788 int actual_format;
4789 unsigned long actual_size, bytes_remaining;
4790 int rc;
4791 struct gcpro gcpro1;
4792
4793 GCPRO1 (prop_value);
4794
4795 rc = XGetWindowProperty (FRAME_X_DISPLAY (f), target_window,
4796 prop_atom, 0, 0, False, target_type,
4797 &actual_type, &actual_format, &actual_size,
4798 &bytes_remaining, &tmp_data);
4799
4800 *found = actual_format != 0;
4801
4802 if (rc == Success && *found)
4803 {
4804 XFree (tmp_data);
4805 tmp_data = NULL;
4806
4807 rc = XGetWindowProperty (FRAME_X_DISPLAY (f), target_window,
4808 prop_atom, 0, bytes_remaining,
4809 ! NILP (delete_p), target_type,
4810 &actual_type, &actual_format,
4811 &actual_size, &bytes_remaining,
4812 &tmp_data);
4813 if (rc == Success && tmp_data)
4814 {
4815 /* The man page for XGetWindowProperty says:
4816 "If the returned format is 32, the returned data is represented
4817 as a long array and should be cast to that type to obtain the
4818 elements."
4819 This applies even if long is more than 32 bits, the X library
4820 converts from 32 bit elements received from the X server to long
4821 and passes the long array to us. Thus, for that case memcpy can not
4822 be used. We convert to a 32 bit type here, because so much code
4823 assume on that.
4824
4825 The bytes and offsets passed to XGetWindowProperty refers to the
4826 property and those are indeed in 32 bit quantities if format is
4827 32. */
4828
4829 if (BITS_PER_LONG > 32 && actual_format == 32)
4830 {
4831 unsigned long i;
4832 int *idata = (int *) tmp_data;
4833 long *ldata = (long *) tmp_data;
4834
4835 for (i = 0; i < actual_size; ++i)
4836 idata[i] = (int) ldata[i];
4837 }
4838
4839 if (NILP (vector_ret_p))
4840 prop_value = make_string ((char *) tmp_data, actual_size);
4841 else
4842 prop_value = x_property_data_to_lisp (f,
4843 tmp_data,
4844 actual_type,
4845 actual_format,
4846 actual_size);
4847 }
4848
4849 if (tmp_data) XFree (tmp_data);
4850 }
4851
4852 UNGCPRO;
4853 return prop_value;
4854 }
4855
4856 DEFUN ("x-window-property", Fx_window_property, Sx_window_property,
4857 1, 6, 0,
4858 doc: /* Value is the value of window property PROP on FRAME.
4859 If FRAME is nil or omitted, use the selected frame.
4860
4861 On X Windows, the following optional arguments are also accepted:
4862 If TYPE is nil or omitted, get the property as a string.
4863 Otherwise TYPE is the name of the atom that denotes the type expected.
4864 If SOURCE is non-nil, get the property on that window instead of from
4865 FRAME. The number 0 denotes the root window.
4866 If DELETE-P is non-nil, delete the property after retrieving it.
4867 If VECTOR-RET-P is non-nil, don't return a string but a vector of values.
4868
4869 On MS Windows, this function accepts but ignores those optional arguments.
4870
4871 Value is nil if FRAME hasn't a property with name PROP or if PROP has
4872 no value of TYPE (always string in the MS Windows case). */)
4873 (Lisp_Object prop, Lisp_Object frame, Lisp_Object type,
4874 Lisp_Object source, Lisp_Object delete_p, Lisp_Object vector_ret_p)
4875 {
4876 struct frame *f = decode_window_system_frame (frame);
4877 Atom prop_atom;
4878 Lisp_Object prop_value = Qnil;
4879 Atom target_type = XA_STRING;
4880 Window target_window = FRAME_X_WINDOW (f);
4881 struct gcpro gcpro1;
4882 bool found;
4883
4884 GCPRO1 (prop_value);
4885 CHECK_STRING (prop);
4886
4887 if (! NILP (source))
4888 {
4889 CONS_TO_INTEGER (source, Window, target_window);
4890 if (! target_window)
4891 target_window = FRAME_DISPLAY_INFO (f)->root_window;
4892 }
4893
4894 block_input ();
4895 if (STRINGP (type))
4896 {
4897 if (strcmp ("AnyPropertyType", SSDATA (type)) == 0)
4898 target_type = AnyPropertyType;
4899 else
4900 target_type = XInternAtom (FRAME_X_DISPLAY (f), SSDATA (type), False);
4901 }
4902
4903 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SSDATA (prop), False);
4904 prop_value = x_window_property_intern (f,
4905 target_window,
4906 prop_atom,
4907 target_type,
4908 delete_p,
4909 vector_ret_p,
4910 &found);
4911 if (NILP (prop_value)
4912 && ! found
4913 && NILP (source)
4914 && target_window != FRAME_OUTER_WINDOW (f))
4915 {
4916 prop_value = x_window_property_intern (f,
4917 FRAME_OUTER_WINDOW (f),
4918 prop_atom,
4919 target_type,
4920 delete_p,
4921 vector_ret_p,
4922 &found);
4923 }
4924
4925
4926 unblock_input ();
4927 UNGCPRO;
4928 return prop_value;
4929 }
4930
4931 /***********************************************************************
4932 Tool tips
4933 ***********************************************************************/
4934
4935 static Lisp_Object x_create_tip_frame (struct x_display_info *,
4936 Lisp_Object, Lisp_Object);
4937 static void compute_tip_xy (struct frame *, Lisp_Object, Lisp_Object,
4938 Lisp_Object, int, int, int *, int *);
4939
4940 /* The frame of a currently visible tooltip. */
4941
4942 Lisp_Object tip_frame;
4943
4944 /* If non-nil, a timer started that hides the last tooltip when it
4945 fires. */
4946
4947 static Lisp_Object tip_timer;
4948 Window tip_window;
4949
4950 /* If non-nil, a vector of 3 elements containing the last args
4951 with which x-show-tip was called. See there. */
4952
4953 static Lisp_Object last_show_tip_args;
4954
4955
4956 static void
4957 unwind_create_tip_frame (Lisp_Object frame)
4958 {
4959 Lisp_Object deleted;
4960
4961 deleted = unwind_create_frame (frame);
4962 if (EQ (deleted, Qt))
4963 {
4964 tip_window = None;
4965 tip_frame = Qnil;
4966 }
4967 }
4968
4969
4970 /* Create a frame for a tooltip on the display described by DPYINFO.
4971 PARMS is a list of frame parameters. TEXT is the string to
4972 display in the tip frame. Value is the frame.
4973
4974 Note that functions called here, esp. x_default_parameter can
4975 signal errors, for instance when a specified color name is
4976 undefined. We have to make sure that we're in a consistent state
4977 when this happens. */
4978
4979 static Lisp_Object
4980 x_create_tip_frame (struct x_display_info *dpyinfo,
4981 Lisp_Object parms,
4982 Lisp_Object text)
4983 {
4984 struct frame *f;
4985 Lisp_Object frame;
4986 Lisp_Object name;
4987 int width, height;
4988 ptrdiff_t count = SPECPDL_INDEX ();
4989 struct gcpro gcpro1, gcpro2, gcpro3;
4990 bool face_change_before = face_change;
4991 Lisp_Object buffer;
4992 struct buffer *old_buffer;
4993
4994 if (!dpyinfo->terminal->name)
4995 error ("Terminal is not live, can't create new frames on it");
4996
4997 parms = Fcopy_alist (parms);
4998
4999 /* Get the name of the frame to use for resource lookup. */
5000 name = x_get_arg (dpyinfo, parms, Qname, "name", "Name", RES_TYPE_STRING);
5001 if (!STRINGP (name)
5002 && !EQ (name, Qunbound)
5003 && !NILP (name))
5004 error ("Invalid frame name--not a string or nil");
5005
5006 frame = Qnil;
5007 GCPRO3 (parms, name, frame);
5008 f = make_frame (true);
5009 XSETFRAME (frame, f);
5010
5011 AUTO_STRING (tip, " *tip*");
5012 buffer = Fget_buffer_create (tip);
5013 /* Use set_window_buffer instead of Fset_window_buffer (see
5014 discussion of bug#11984, bug#12025, bug#12026). */
5015 set_window_buffer (FRAME_ROOT_WINDOW (f), buffer, false, false);
5016 old_buffer = current_buffer;
5017 set_buffer_internal_1 (XBUFFER (buffer));
5018 bset_truncate_lines (current_buffer, Qnil);
5019 specbind (Qinhibit_read_only, Qt);
5020 specbind (Qinhibit_modification_hooks, Qt);
5021 Ferase_buffer ();
5022 Finsert (1, &text);
5023 set_buffer_internal_1 (old_buffer);
5024
5025 record_unwind_protect (unwind_create_tip_frame, frame);
5026
5027 f->terminal = dpyinfo->terminal;
5028
5029 /* By setting the output method, we're essentially saying that
5030 the frame is live, as per FRAME_LIVE_P. If we get a signal
5031 from this point on, x_destroy_window might screw up reference
5032 counts etc. */
5033 f->output_method = output_x_window;
5034 f->output_data.x = xzalloc (sizeof *f->output_data.x);
5035 f->output_data.x->icon_bitmap = -1;
5036 FRAME_FONTSET (f) = -1;
5037 f->output_data.x->scroll_bar_foreground_pixel = -1;
5038 f->output_data.x->scroll_bar_background_pixel = -1;
5039 #if defined (USE_LUCID) && defined (USE_TOOLKIT_SCROLL_BARS)
5040 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
5041 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
5042 #endif /* USE_LUCID && USE_TOOLKIT_SCROLL_BARS */
5043 f->output_data.x->white_relief.pixel = -1;
5044 f->output_data.x->black_relief.pixel = -1;
5045
5046 fset_icon_name (f, Qnil);
5047 FRAME_DISPLAY_INFO (f) = dpyinfo;
5048 f->output_data.x->parent_desc = FRAME_DISPLAY_INFO (f)->root_window;
5049 f->output_data.x->explicit_parent = false;
5050
5051 /* These colors will be set anyway later, but it's important
5052 to get the color reference counts right, so initialize them! */
5053 {
5054 Lisp_Object black;
5055 struct gcpro gcpro1;
5056
5057 /* Function x_decode_color can signal an error. Make
5058 sure to initialize color slots so that we won't try
5059 to free colors we haven't allocated. */
5060 FRAME_FOREGROUND_PIXEL (f) = -1;
5061 FRAME_BACKGROUND_PIXEL (f) = -1;
5062 f->output_data.x->cursor_pixel = -1;
5063 f->output_data.x->cursor_foreground_pixel = -1;
5064 f->output_data.x->border_pixel = -1;
5065 f->output_data.x->mouse_pixel = -1;
5066
5067 black = build_string ("black");
5068 GCPRO1 (black);
5069 FRAME_FOREGROUND_PIXEL (f)
5070 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
5071 FRAME_BACKGROUND_PIXEL (f)
5072 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
5073 f->output_data.x->cursor_pixel
5074 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
5075 f->output_data.x->cursor_foreground_pixel
5076 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
5077 f->output_data.x->border_pixel
5078 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
5079 f->output_data.x->mouse_pixel
5080 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
5081 UNGCPRO;
5082 }
5083
5084 /* Set the name; the functions to which we pass f expect the name to
5085 be set. */
5086 if (EQ (name, Qunbound) || NILP (name))
5087 {
5088 fset_name (f, build_string (dpyinfo->x_id_name));
5089 f->explicit_name = false;
5090 }
5091 else
5092 {
5093 fset_name (f, name);
5094 f->explicit_name = true;
5095 /* use the frame's title when getting resources for this frame. */
5096 specbind (Qx_resource_name, name);
5097 }
5098
5099 register_font_driver (&xfont_driver, f);
5100 #ifdef HAVE_FREETYPE
5101 #ifdef HAVE_XFT
5102 register_font_driver (&xftfont_driver, f);
5103 #else /* not HAVE_XFT */
5104 register_font_driver (&ftxfont_driver, f);
5105 #endif /* not HAVE_XFT */
5106 #endif /* HAVE_FREETYPE */
5107
5108 x_default_parameter (f, parms, Qfont_backend, Qnil,
5109 "fontBackend", "FontBackend", RES_TYPE_STRING);
5110
5111 /* Extract the window parameters from the supplied values that are
5112 needed to determine window geometry. */
5113 x_default_font_parameter (f, parms);
5114
5115 x_default_parameter (f, parms, Qborder_width, make_number (0),
5116 "borderWidth", "BorderWidth", RES_TYPE_NUMBER);
5117
5118 /* This defaults to 2 in order to match xterm. We recognize either
5119 internalBorderWidth or internalBorder (which is what xterm calls
5120 it). */
5121 if (NILP (Fassq (Qinternal_border_width, parms)))
5122 {
5123 Lisp_Object value;
5124
5125 value = x_get_arg (dpyinfo, parms, Qinternal_border_width,
5126 "internalBorder", "internalBorder", RES_TYPE_NUMBER);
5127 if (! EQ (value, Qunbound))
5128 parms = Fcons (Fcons (Qinternal_border_width, value),
5129 parms);
5130 }
5131
5132 x_default_parameter (f, parms, Qinternal_border_width, make_number (1),
5133 "internalBorderWidth", "internalBorderWidth",
5134 RES_TYPE_NUMBER);
5135 x_default_parameter (f, parms, Qright_divider_width, make_number (0),
5136 NULL, NULL, RES_TYPE_NUMBER);
5137 x_default_parameter (f, parms, Qbottom_divider_width, make_number (0),
5138 NULL, NULL, RES_TYPE_NUMBER);
5139
5140 /* Also do the stuff which must be set before the window exists. */
5141 x_default_parameter (f, parms, Qforeground_color, build_string ("black"),
5142 "foreground", "Foreground", RES_TYPE_STRING);
5143 x_default_parameter (f, parms, Qbackground_color, build_string ("white"),
5144 "background", "Background", RES_TYPE_STRING);
5145 x_default_parameter (f, parms, Qmouse_color, build_string ("black"),
5146 "pointerColor", "Foreground", RES_TYPE_STRING);
5147 x_default_parameter (f, parms, Qcursor_color, build_string ("black"),
5148 "cursorColor", "Foreground", RES_TYPE_STRING);
5149 x_default_parameter (f, parms, Qborder_color, build_string ("black"),
5150 "borderColor", "BorderColor", RES_TYPE_STRING);
5151
5152 #ifdef GLYPH_DEBUG
5153 image_cache_refcount =
5154 FRAME_IMAGE_CACHE (f) ? FRAME_IMAGE_CACHE (f)->refcount : 0;
5155 dpyinfo_refcount = dpyinfo->reference_count;
5156 #endif /* GLYPH_DEBUG */
5157
5158 /* Init faces before x_default_parameter is called for the
5159 scroll-bar-width parameter because otherwise we end up in
5160 init_iterator with a null face cache, which should not happen. */
5161 init_frame_faces (f);
5162
5163 f->output_data.x->parent_desc = FRAME_DISPLAY_INFO (f)->root_window;
5164
5165 x_figure_window_size (f, parms, false);
5166
5167 {
5168 XSetWindowAttributes attrs;
5169 unsigned long mask;
5170 Atom type = FRAME_DISPLAY_INFO (f)->Xatom_net_window_type_tooltip;
5171
5172 block_input ();
5173 mask = CWBackPixel | CWOverrideRedirect | CWEventMask;
5174 if (DoesSaveUnders (dpyinfo->screen))
5175 mask |= CWSaveUnder;
5176
5177 /* Window managers look at the override-redirect flag to determine
5178 whether or net to give windows a decoration (Xlib spec, chapter
5179 3.2.8). */
5180 attrs.override_redirect = True;
5181 attrs.save_under = True;
5182 attrs.background_pixel = FRAME_BACKGROUND_PIXEL (f);
5183 /* Arrange for getting MapNotify and UnmapNotify events. */
5184 attrs.event_mask = StructureNotifyMask;
5185 tip_window
5186 = FRAME_X_WINDOW (f)
5187 = XCreateWindow (FRAME_X_DISPLAY (f),
5188 FRAME_DISPLAY_INFO (f)->root_window,
5189 /* x, y, width, height */
5190 0, 0, 1, 1,
5191 /* Border. */
5192 f->border_width,
5193 CopyFromParent, InputOutput, CopyFromParent,
5194 mask, &attrs);
5195 XChangeProperty (FRAME_X_DISPLAY (f), tip_window,
5196 FRAME_DISPLAY_INFO (f)->Xatom_net_window_type,
5197 XA_ATOM, 32, PropModeReplace,
5198 (unsigned char *)&type, 1);
5199 unblock_input ();
5200 }
5201
5202 x_make_gc (f);
5203
5204 x_default_parameter (f, parms, Qauto_raise, Qnil,
5205 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
5206 x_default_parameter (f, parms, Qauto_lower, Qnil,
5207 "autoLower", "AutoRaiseLower", RES_TYPE_BOOLEAN);
5208 x_default_parameter (f, parms, Qcursor_type, Qbox,
5209 "cursorType", "CursorType", RES_TYPE_SYMBOL);
5210
5211 /* Dimensions, especially FRAME_LINES (f), must be done via change_frame_size.
5212 Change will not be effected unless different from the current
5213 FRAME_LINES (f). */
5214 width = FRAME_COLS (f);
5215 height = FRAME_LINES (f);
5216 SET_FRAME_COLS (f, 0);
5217 SET_FRAME_LINES (f, 0);
5218 change_frame_size (f, width, height, true, false, false, false);
5219
5220 /* Add `tooltip' frame parameter's default value. */
5221 if (NILP (Fframe_parameter (frame, Qtooltip)))
5222 {
5223 AUTO_FRAME_ARG (arg, Qtooltip, Qt);
5224 Fmodify_frame_parameters (frame, arg);
5225 }
5226
5227 /* FIXME - can this be done in a similar way to normal frames?
5228 http://lists.gnu.org/archive/html/emacs-devel/2007-10/msg00641.html */
5229
5230 /* Set the `display-type' frame parameter before setting up faces. */
5231 {
5232 Lisp_Object disptype;
5233
5234 if (FRAME_DISPLAY_INFO (f)->n_planes == 1)
5235 disptype = Qmono;
5236 else if (FRAME_DISPLAY_INFO (f)->visual->class == GrayScale
5237 || FRAME_DISPLAY_INFO (f)->visual->class == StaticGray)
5238 disptype = intern ("grayscale");
5239 else
5240 disptype = intern ("color");
5241
5242 if (NILP (Fframe_parameter (frame, Qdisplay_type)))
5243 {
5244 AUTO_FRAME_ARG (arg, Qdisplay_type, disptype);
5245 Fmodify_frame_parameters (frame, arg);
5246 }
5247 }
5248
5249 /* Set up faces after all frame parameters are known. This call
5250 also merges in face attributes specified for new frames.
5251
5252 Frame parameters may be changed if .Xdefaults contains
5253 specifications for the default font. For example, if there is an
5254 `Emacs.default.attributeBackground: pink', the `background-color'
5255 attribute of the frame get's set, which let's the internal border
5256 of the tooltip frame appear in pink. Prevent this. */
5257 {
5258 Lisp_Object bg = Fframe_parameter (frame, Qbackground_color);
5259
5260 /* Set tip_frame here, so that */
5261 tip_frame = frame;
5262 call2 (Qface_set_after_frame_default, frame, Qnil);
5263
5264 if (!EQ (bg, Fframe_parameter (frame, Qbackground_color)))
5265 {
5266 AUTO_FRAME_ARG (arg, Qbackground_color, bg);
5267 Fmodify_frame_parameters (frame, arg);
5268 }
5269 }
5270
5271 f->no_split = true;
5272
5273 UNGCPRO;
5274
5275 /* Now that the frame will be official, it counts as a reference to
5276 its display and terminal. */
5277 FRAME_DISPLAY_INFO (f)->reference_count++;
5278 f->terminal->reference_count++;
5279
5280 /* It is now ok to make the frame official even if we get an error
5281 below. And the frame needs to be on Vframe_list or making it
5282 visible won't work. */
5283 Vframe_list = Fcons (frame, Vframe_list);
5284 f->can_x_set_window_size = true;
5285
5286 /* Setting attributes of faces of the tooltip frame from resources
5287 and similar will set face_change, which leads to the clearing of
5288 all current matrices. Since this isn't necessary here, avoid it
5289 by resetting face_change to the value it had before we created
5290 the tip frame. */
5291 face_change = face_change_before;
5292
5293 /* Discard the unwind_protect. */
5294 return unbind_to (count, frame);
5295 }
5296
5297
5298 /* Compute where to display tip frame F. PARMS is the list of frame
5299 parameters for F. DX and DY are specified offsets from the current
5300 location of the mouse. WIDTH and HEIGHT are the width and height
5301 of the tooltip. Return coordinates relative to the root window of
5302 the display in *ROOT_X, and *ROOT_Y. */
5303
5304 static void
5305 compute_tip_xy (struct frame *f, Lisp_Object parms, Lisp_Object dx, Lisp_Object dy, int width, int height, int *root_x, int *root_y)
5306 {
5307 Lisp_Object left, top;
5308 int win_x, win_y;
5309 Window root, child;
5310 unsigned pmask;
5311
5312 /* User-specified position? */
5313 left = Fcdr (Fassq (Qleft, parms));
5314 top = Fcdr (Fassq (Qtop, parms));
5315
5316 /* Move the tooltip window where the mouse pointer is. Resize and
5317 show it. */
5318 if (!INTEGERP (left) || !INTEGERP (top))
5319 {
5320 block_input ();
5321 XQueryPointer (FRAME_X_DISPLAY (f), FRAME_DISPLAY_INFO (f)->root_window,
5322 &root, &child, root_x, root_y, &win_x, &win_y, &pmask);
5323 unblock_input ();
5324 }
5325
5326 if (INTEGERP (top))
5327 *root_y = XINT (top);
5328 else if (*root_y + XINT (dy) <= 0)
5329 *root_y = 0; /* Can happen for negative dy */
5330 else if (*root_y + XINT (dy) + height
5331 <= x_display_pixel_height (FRAME_DISPLAY_INFO (f)))
5332 /* It fits below the pointer */
5333 *root_y += XINT (dy);
5334 else if (height + XINT (dy) <= *root_y)
5335 /* It fits above the pointer. */
5336 *root_y -= height + XINT (dy);
5337 else
5338 /* Put it on the top. */
5339 *root_y = 0;
5340
5341 if (INTEGERP (left))
5342 *root_x = XINT (left);
5343 else if (*root_x + XINT (dx) <= 0)
5344 *root_x = 0; /* Can happen for negative dx */
5345 else if (*root_x + XINT (dx) + width
5346 <= x_display_pixel_width (FRAME_DISPLAY_INFO (f)))
5347 /* It fits to the right of the pointer. */
5348 *root_x += XINT (dx);
5349 else if (width + XINT (dx) <= *root_x)
5350 /* It fits to the left of the pointer. */
5351 *root_x -= width + XINT (dx);
5352 else
5353 /* Put it left-justified on the screen--it ought to fit that way. */
5354 *root_x = 0;
5355 }
5356
5357
5358 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
5359 doc: /* Show STRING in a "tooltip" window on frame FRAME.
5360 A tooltip window is a small X window displaying a string.
5361
5362 This is an internal function; Lisp code should call `tooltip-show'.
5363
5364 FRAME nil or omitted means use the selected frame.
5365
5366 PARMS is an optional list of frame parameters which can be used to
5367 change the tooltip's appearance.
5368
5369 Automatically hide the tooltip after TIMEOUT seconds. TIMEOUT nil
5370 means use the default timeout of 5 seconds.
5371
5372 If the list of frame parameters PARMS contains a `left' parameters,
5373 the tooltip is displayed at that x-position. Otherwise it is
5374 displayed at the mouse position, with offset DX added (default is 5 if
5375 DX isn't specified). Likewise for the y-position; if a `top' frame
5376 parameter is specified, it determines the y-position of the tooltip
5377 window, otherwise it is displayed at the mouse position, with offset
5378 DY added (default is -10).
5379
5380 A tooltip's maximum size is specified by `x-max-tooltip-size'.
5381 Text larger than the specified size is clipped. */)
5382 (Lisp_Object string, Lisp_Object frame, Lisp_Object parms, Lisp_Object timeout, Lisp_Object dx, Lisp_Object dy)
5383 {
5384 struct frame *f;
5385 struct window *w;
5386 int root_x, root_y;
5387 struct buffer *old_buffer;
5388 struct text_pos pos;
5389 int i, width, height;
5390 bool seen_reversed_p;
5391 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
5392 int old_windows_or_buffers_changed = windows_or_buffers_changed;
5393 ptrdiff_t count = SPECPDL_INDEX ();
5394
5395 specbind (Qinhibit_redisplay, Qt);
5396
5397 GCPRO4 (string, parms, frame, timeout);
5398
5399 CHECK_STRING (string);
5400 if (SCHARS (string) == 0)
5401 string = make_unibyte_string (" ", 1);
5402
5403 f = decode_window_system_frame (frame);
5404 if (NILP (timeout))
5405 timeout = make_number (5);
5406 else
5407 CHECK_NATNUM (timeout);
5408
5409 if (NILP (dx))
5410 dx = make_number (5);
5411 else
5412 CHECK_NUMBER (dx);
5413
5414 if (NILP (dy))
5415 dy = make_number (-10);
5416 else
5417 CHECK_NUMBER (dy);
5418
5419 #ifdef USE_GTK
5420 if (x_gtk_use_system_tooltips)
5421 {
5422 bool ok;
5423
5424 /* Hide a previous tip, if any. */
5425 Fx_hide_tip ();
5426
5427 block_input ();
5428 ok = xg_prepare_tooltip (f, string, &width, &height);
5429 if (ok)
5430 {
5431 compute_tip_xy (f, parms, dx, dy, width, height, &root_x, &root_y);
5432 xg_show_tooltip (f, root_x, root_y);
5433 /* This is used in Fx_hide_tip. */
5434 XSETFRAME (tip_frame, f);
5435 }
5436 unblock_input ();
5437 if (ok) goto start_timer;
5438 }
5439 #endif /* USE_GTK */
5440
5441 if (NILP (last_show_tip_args))
5442 last_show_tip_args = Fmake_vector (make_number (3), Qnil);
5443
5444 if (!NILP (tip_frame))
5445 {
5446 Lisp_Object last_string = AREF (last_show_tip_args, 0);
5447 Lisp_Object last_frame = AREF (last_show_tip_args, 1);
5448 Lisp_Object last_parms = AREF (last_show_tip_args, 2);
5449
5450 if (EQ (frame, last_frame)
5451 && !NILP (Fequal (last_string, string))
5452 && !NILP (Fequal (last_parms, parms)))
5453 {
5454 struct frame *tip_f = XFRAME (tip_frame);
5455
5456 /* Only DX and DY have changed. */
5457 if (!NILP (tip_timer))
5458 {
5459 Lisp_Object timer = tip_timer;
5460 tip_timer = Qnil;
5461 call1 (Qcancel_timer, timer);
5462 }
5463
5464 block_input ();
5465 compute_tip_xy (tip_f, parms, dx, dy, FRAME_PIXEL_WIDTH (tip_f),
5466 FRAME_PIXEL_HEIGHT (tip_f), &root_x, &root_y);
5467 XMoveWindow (FRAME_X_DISPLAY (tip_f), FRAME_X_WINDOW (tip_f),
5468 root_x, root_y);
5469 unblock_input ();
5470 goto start_timer;
5471 }
5472 }
5473
5474 /* Hide a previous tip, if any. */
5475 Fx_hide_tip ();
5476
5477 ASET (last_show_tip_args, 0, string);
5478 ASET (last_show_tip_args, 1, frame);
5479 ASET (last_show_tip_args, 2, parms);
5480
5481 /* Add default values to frame parameters. */
5482 if (NILP (Fassq (Qname, parms)))
5483 parms = Fcons (Fcons (Qname, build_string ("tooltip")), parms);
5484 if (NILP (Fassq (Qinternal_border_width, parms)))
5485 parms = Fcons (Fcons (Qinternal_border_width, make_number (3)), parms);
5486 if (NILP (Fassq (Qborder_width, parms)))
5487 parms = Fcons (Fcons (Qborder_width, make_number (1)), parms);
5488 if (NILP (Fassq (Qbottom_divider_width, parms)))
5489 parms = Fcons (Fcons (Qbottom_divider_width, make_number (0)), parms);
5490 if (NILP (Fassq (Qright_divider_width, parms)))
5491 parms = Fcons (Fcons (Qright_divider_width, make_number (0)), parms);
5492 if (NILP (Fassq (Qborder_color, parms)))
5493 parms = Fcons (Fcons (Qborder_color, build_string ("lightyellow")), parms);
5494 if (NILP (Fassq (Qbackground_color, parms)))
5495 parms = Fcons (Fcons (Qbackground_color, build_string ("lightyellow")),
5496 parms);
5497
5498 /* Create a frame for the tooltip, and record it in the global
5499 variable tip_frame. */
5500 frame = x_create_tip_frame (FRAME_DISPLAY_INFO (f), parms, string);
5501 f = XFRAME (frame);
5502
5503 /* Set up the frame's root window. */
5504 w = XWINDOW (FRAME_ROOT_WINDOW (f));
5505 w->left_col = 0;
5506 w->top_line = 0;
5507 w->pixel_left = 0;
5508 w->pixel_top = 0;
5509
5510 if (CONSP (Vx_max_tooltip_size)
5511 && RANGED_INTEGERP (1, XCAR (Vx_max_tooltip_size), INT_MAX)
5512 && RANGED_INTEGERP (1, XCDR (Vx_max_tooltip_size), INT_MAX))
5513 {
5514 w->total_cols = XFASTINT (XCAR (Vx_max_tooltip_size));
5515 w->total_lines = XFASTINT (XCDR (Vx_max_tooltip_size));
5516 }
5517 else
5518 {
5519 w->total_cols = 80;
5520 w->total_lines = 40;
5521 }
5522
5523 w->pixel_width = w->total_cols * FRAME_COLUMN_WIDTH (f);
5524 w->pixel_height = w->total_lines * FRAME_LINE_HEIGHT (f);
5525
5526 FRAME_TOTAL_COLS (f) = w->total_cols;
5527 adjust_frame_glyphs (f);
5528 w->pseudo_window_p = true;
5529
5530 /* Display the tooltip text in a temporary buffer. */
5531 old_buffer = current_buffer;
5532 set_buffer_internal_1 (XBUFFER (XWINDOW (FRAME_ROOT_WINDOW (f))->contents));
5533 bset_truncate_lines (current_buffer, Qnil);
5534 clear_glyph_matrix (w->desired_matrix);
5535 clear_glyph_matrix (w->current_matrix);
5536 SET_TEXT_POS (pos, BEGV, BEGV_BYTE);
5537 try_window (FRAME_ROOT_WINDOW (f), pos, TRY_WINDOW_IGNORE_FONTS_CHANGE);
5538
5539 /* Compute width and height of the tooltip. */
5540 width = height = 0;
5541 seen_reversed_p = false;
5542 for (i = 0; i < w->desired_matrix->nrows; ++i)
5543 {
5544 struct glyph_row *row = &w->desired_matrix->rows[i];
5545 struct glyph *last;
5546 int row_width;
5547
5548 /* Stop at the first empty row at the end. */
5549 if (!row->enabled_p || !MATRIX_ROW_DISPLAYS_TEXT_P (row))
5550 break;
5551
5552 /* Let the row go over the full width of the frame. */
5553 row->full_width_p = true;
5554
5555 row_width = row->pixel_width;
5556 if (row->used[TEXT_AREA])
5557 {
5558 /* There's a glyph at the end of rows that is used to place
5559 the cursor there. Don't include the width of this glyph. */
5560 if (!row->reversed_p)
5561 {
5562 last = &row->glyphs[TEXT_AREA][row->used[TEXT_AREA] - 1];
5563 if (NILP (last->object))
5564 row_width -= last->pixel_width;
5565 }
5566 else
5567 {
5568 /* There could be a stretch glyph at the beginning of R2L
5569 rows that is produced by extend_face_to_end_of_line.
5570 Don't count that glyph. */
5571 struct glyph *g = row->glyphs[TEXT_AREA];
5572
5573 if (g->type == STRETCH_GLYPH && NILP (g->object))
5574 {
5575 row_width -= g->pixel_width;
5576 seen_reversed_p = true;
5577 }
5578 }
5579 }
5580
5581 height += row->height;
5582 width = max (width, row_width);
5583 }
5584
5585 /* If we've seen partial-length R2L rows, we need to re-adjust the
5586 tool-tip frame width and redisplay it again, to avoid over-wide
5587 tips due to the stretch glyph that extends R2L lines to full
5588 width of the frame. */
5589 if (seen_reversed_p)
5590 {
5591 /* w->total_cols and FRAME_TOTAL_COLS want the width in columns,
5592 not in pixels. */
5593 w->pixel_width = width;
5594 width /= WINDOW_FRAME_COLUMN_WIDTH (w);
5595 w->total_cols = width;
5596 FRAME_TOTAL_COLS (f) = width;
5597 SET_FRAME_WIDTH (f, width);
5598 adjust_frame_glyphs (f);
5599 clear_glyph_matrix (w->desired_matrix);
5600 clear_glyph_matrix (w->current_matrix);
5601 try_window (FRAME_ROOT_WINDOW (f), pos, 0);
5602 width = height = 0;
5603 /* Recompute width and height of the tooltip. */
5604 for (i = 0; i < w->desired_matrix->nrows; ++i)
5605 {
5606 struct glyph_row *row = &w->desired_matrix->rows[i];
5607 struct glyph *last;
5608 int row_width;
5609
5610 if (!row->enabled_p || !MATRIX_ROW_DISPLAYS_TEXT_P (row))
5611 break;
5612 row->full_width_p = true;
5613 row_width = row->pixel_width;
5614 if (row->used[TEXT_AREA] && !row->reversed_p)
5615 {
5616 last = &row->glyphs[TEXT_AREA][row->used[TEXT_AREA] - 1];
5617 if (NILP (last->object))
5618 row_width -= last->pixel_width;
5619 }
5620
5621 height += row->height;
5622 width = max (width, row_width);
5623 }
5624 }
5625
5626 /* Add the frame's internal border to the width and height the X
5627 window should have. */
5628 height += 2 * FRAME_INTERNAL_BORDER_WIDTH (f);
5629 width += 2 * FRAME_INTERNAL_BORDER_WIDTH (f);
5630
5631 /* Move the tooltip window where the mouse pointer is. Resize and
5632 show it. */
5633 compute_tip_xy (f, parms, dx, dy, width, height, &root_x, &root_y);
5634
5635 block_input ();
5636 XMoveResizeWindow (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
5637 root_x, root_y, width, height);
5638 XMapRaised (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f));
5639 unblock_input ();
5640
5641 /* Draw into the window. */
5642 w->must_be_updated_p = true;
5643 update_single_window (w);
5644
5645 /* Restore original current buffer. */
5646 set_buffer_internal_1 (old_buffer);
5647 windows_or_buffers_changed = old_windows_or_buffers_changed;
5648
5649 start_timer:
5650 /* Let the tip disappear after timeout seconds. */
5651 tip_timer = call3 (intern ("run-at-time"), timeout, Qnil,
5652 intern ("x-hide-tip"));
5653
5654 UNGCPRO;
5655 return unbind_to (count, Qnil);
5656 }
5657
5658
5659 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
5660 doc: /* Hide the current tooltip window, if there is any.
5661 Value is t if tooltip was open, nil otherwise. */)
5662 (void)
5663 {
5664 ptrdiff_t count;
5665 Lisp_Object deleted, frame, timer;
5666 struct gcpro gcpro1, gcpro2;
5667
5668 /* Return quickly if nothing to do. */
5669 if (NILP (tip_timer) && NILP (tip_frame))
5670 return Qnil;
5671
5672 frame = tip_frame;
5673 timer = tip_timer;
5674 GCPRO2 (frame, timer);
5675 tip_frame = tip_timer = deleted = Qnil;
5676
5677 count = SPECPDL_INDEX ();
5678 specbind (Qinhibit_redisplay, Qt);
5679 specbind (Qinhibit_quit, Qt);
5680
5681 if (!NILP (timer))
5682 call1 (Qcancel_timer, timer);
5683
5684 #ifdef USE_GTK
5685 {
5686 /* When using system tooltip, tip_frame is the Emacs frame on which
5687 the tip is shown. */
5688 struct frame *f = XFRAME (frame);
5689 if (FRAME_LIVE_P (f) && xg_hide_tooltip (f))
5690 frame = Qnil;
5691 }
5692 #endif
5693
5694 if (FRAMEP (frame))
5695 {
5696 delete_frame (frame, Qnil);
5697 deleted = Qt;
5698
5699 #ifdef USE_LUCID
5700 /* Bloodcurdling hack alert: The Lucid menu bar widget's
5701 redisplay procedure is not called when a tip frame over menu
5702 items is unmapped. Redisplay the menu manually... */
5703 {
5704 Widget w;
5705 struct frame *f = SELECTED_FRAME ();
5706 w = f->output_data.x->menubar_widget;
5707
5708 if (!DoesSaveUnders (FRAME_DISPLAY_INFO (f)->screen)
5709 && w != NULL)
5710 {
5711 block_input ();
5712 xlwmenu_redisplay (w);
5713 unblock_input ();
5714 }
5715 }
5716 #endif /* USE_LUCID */
5717 }
5718
5719 UNGCPRO;
5720 return unbind_to (count, deleted);
5721 }
5722
5723
5724 \f
5725 /***********************************************************************
5726 File selection dialog
5727 ***********************************************************************/
5728
5729 DEFUN ("x-uses-old-gtk-dialog", Fx_uses_old_gtk_dialog,
5730 Sx_uses_old_gtk_dialog,
5731 0, 0, 0,
5732 doc: /* Return t if the old Gtk+ file selection dialog is used. */)
5733 (void)
5734 {
5735 #ifdef USE_GTK
5736 if (use_dialog_box
5737 && use_file_dialog
5738 && window_system_available (SELECTED_FRAME ())
5739 && xg_uses_old_file_dialog ())
5740 return Qt;
5741 #endif
5742 return Qnil;
5743 }
5744
5745
5746 #ifdef USE_MOTIF
5747 /* Callback for "OK" and "Cancel" on file selection dialog. */
5748
5749 static void
5750 file_dialog_cb (Widget widget, XtPointer client_data, XtPointer call_data)
5751 {
5752 int *result = client_data;
5753 XmAnyCallbackStruct *cb = call_data;
5754 *result = cb->reason;
5755 }
5756
5757
5758 /* Callback for unmapping a file selection dialog. This is used to
5759 capture the case where a dialog is closed via a window manager's
5760 closer button, for example. Using a XmNdestroyCallback didn't work
5761 in this case. */
5762
5763 static void
5764 file_dialog_unmap_cb (Widget widget, XtPointer client_data, XtPointer call_data)
5765 {
5766 int *result = client_data;
5767 *result = XmCR_CANCEL;
5768 }
5769
5770 static void
5771 clean_up_file_dialog (void *arg)
5772 {
5773 Widget dialog = arg;
5774
5775 /* Clean up. */
5776 block_input ();
5777 XtUnmanageChild (dialog);
5778 XtDestroyWidget (dialog);
5779 x_menu_set_in_use (false);
5780 unblock_input ();
5781 }
5782
5783
5784 DEFUN ("x-file-dialog", Fx_file_dialog, Sx_file_dialog, 2, 5, 0,
5785 doc: /* Read file name, prompting with PROMPT in directory DIR.
5786 Use a file selection dialog. Select DEFAULT-FILENAME in the dialog's file
5787 selection box, if specified. If MUSTMATCH is non-nil, the returned file
5788 or directory must exist.
5789
5790 This function is only defined on NS, MS Windows, and X Windows with the
5791 Motif or Gtk toolkits. With the Motif toolkit, ONLY-DIR-P is ignored.
5792 Otherwise, if ONLY-DIR-P is non-nil, the user can only select directories.
5793 On Windows 7 and later, the file selection dialog "remembers" the last
5794 directory where the user selected a file, and will open that directory
5795 instead of DIR on subsequent invocations of this function with the same
5796 value of DIR as in previous invocations; this is standard Windows behavior. */)
5797 (Lisp_Object prompt, Lisp_Object dir, Lisp_Object default_filename,
5798 Lisp_Object mustmatch, Lisp_Object only_dir_p)
5799 {
5800 int result;
5801 struct frame *f = SELECTED_FRAME ();
5802 Lisp_Object file = Qnil;
5803 Lisp_Object decoded_file;
5804 Widget dialog, text, help;
5805 Arg al[10];
5806 int ac = 0;
5807 XmString dir_xmstring, pattern_xmstring;
5808 ptrdiff_t count = SPECPDL_INDEX ();
5809 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
5810
5811 check_window_system (f);
5812
5813 GCPRO6 (prompt, dir, default_filename, mustmatch, only_dir_p, file);
5814
5815 if (popup_activated ())
5816 error ("Trying to use a menu from within a menu-entry");
5817
5818 CHECK_STRING (prompt);
5819 CHECK_STRING (dir);
5820
5821 /* Prevent redisplay. */
5822 specbind (Qinhibit_redisplay, Qt);
5823
5824 block_input ();
5825
5826 /* Create the dialog with PROMPT as title, using DIR as initial
5827 directory and using "*" as pattern. */
5828 dir = Fexpand_file_name (dir, Qnil);
5829 dir_xmstring = XmStringCreateLocalized (SSDATA (dir));
5830 pattern_xmstring = XmStringCreateLocalized ("*");
5831
5832 XtSetArg (al[ac], XmNtitle, SDATA (prompt)); ++ac;
5833 XtSetArg (al[ac], XmNdirectory, dir_xmstring); ++ac;
5834 XtSetArg (al[ac], XmNpattern, pattern_xmstring); ++ac;
5835 XtSetArg (al[ac], XmNresizePolicy, XmRESIZE_GROW); ++ac;
5836 XtSetArg (al[ac], XmNdialogStyle, XmDIALOG_APPLICATION_MODAL); ++ac;
5837 dialog = XmCreateFileSelectionDialog (f->output_data.x->widget,
5838 "fsb", al, ac);
5839 XmStringFree (dir_xmstring);
5840 XmStringFree (pattern_xmstring);
5841
5842 /* Add callbacks for OK and Cancel. */
5843 XtAddCallback (dialog, XmNokCallback, file_dialog_cb,
5844 (XtPointer) &result);
5845 XtAddCallback (dialog, XmNcancelCallback, file_dialog_cb,
5846 (XtPointer) &result);
5847 XtAddCallback (dialog, XmNunmapCallback, file_dialog_unmap_cb,
5848 (XtPointer) &result);
5849
5850 /* Remove the help button since we can't display help. */
5851 help = XmFileSelectionBoxGetChild (dialog, XmDIALOG_HELP_BUTTON);
5852 XtUnmanageChild (help);
5853
5854 /* Mark OK button as default. */
5855 XtVaSetValues (XmFileSelectionBoxGetChild (dialog, XmDIALOG_OK_BUTTON),
5856 XmNshowAsDefault, True, NULL);
5857
5858 /* If MUSTMATCH is non-nil, disable the file entry field of the
5859 dialog, so that the user must select a file from the files list
5860 box. We can't remove it because we wouldn't have a way to get at
5861 the result file name, then. */
5862 text = XmFileSelectionBoxGetChild (dialog, XmDIALOG_TEXT);
5863 if (!NILP (mustmatch))
5864 {
5865 Widget label;
5866 label = XmFileSelectionBoxGetChild (dialog, XmDIALOG_SELECTION_LABEL);
5867 XtSetSensitive (text, False);
5868 XtSetSensitive (label, False);
5869 }
5870
5871 /* Manage the dialog, so that list boxes get filled. */
5872 XtManageChild (dialog);
5873
5874 if (STRINGP (default_filename))
5875 {
5876 XmString default_xmstring;
5877 Widget wtext = XmFileSelectionBoxGetChild (dialog, XmDIALOG_TEXT);
5878 Widget list = XmFileSelectionBoxGetChild (dialog, XmDIALOG_LIST);
5879
5880 XmTextPosition last_pos = XmTextFieldGetLastPosition (wtext);
5881 XmTextFieldReplace (wtext, 0, last_pos,
5882 (SSDATA (Ffile_name_nondirectory (default_filename))));
5883
5884 /* Select DEFAULT_FILENAME in the files list box. DEFAULT_FILENAME
5885 must include the path for this to work. */
5886
5887 default_xmstring = XmStringCreateLocalized (SSDATA (default_filename));
5888
5889 if (XmListItemExists (list, default_xmstring))
5890 {
5891 int item_pos = XmListItemPos (list, default_xmstring);
5892 /* Select the item and scroll it into view. */
5893 XmListSelectPos (list, item_pos, True);
5894 XmListSetPos (list, item_pos);
5895 }
5896
5897 XmStringFree (default_xmstring);
5898 }
5899
5900 record_unwind_protect_ptr (clean_up_file_dialog, dialog);
5901
5902 /* Process events until the user presses Cancel or OK. */
5903 x_menu_set_in_use (true);
5904 result = 0;
5905 while (result == 0)
5906 {
5907 XEvent event;
5908 x_menu_wait_for_event (0);
5909 XtAppNextEvent (Xt_app_con, &event);
5910 if (event.type == KeyPress
5911 && FRAME_X_DISPLAY (f) == event.xkey.display)
5912 {
5913 KeySym keysym = XLookupKeysym (&event.xkey, 0);
5914
5915 /* Pop down on C-g. */
5916 if (keysym == XK_g && (event.xkey.state & ControlMask) != 0)
5917 XtUnmanageChild (dialog);
5918 }
5919
5920 (void) x_dispatch_event (&event, FRAME_X_DISPLAY (f));
5921 }
5922
5923 /* Get the result. */
5924 if (result == XmCR_OK)
5925 {
5926 XmString text_string;
5927 String data;
5928
5929 XtVaGetValues (dialog, XmNtextString, &text_string, NULL);
5930 XmStringGetLtoR (text_string, XmFONTLIST_DEFAULT_TAG, &data);
5931 XmStringFree (text_string);
5932 file = build_string (data);
5933 XtFree (data);
5934 }
5935 else
5936 file = Qnil;
5937
5938 unblock_input ();
5939 UNGCPRO;
5940
5941 /* Make "Cancel" equivalent to C-g. */
5942 if (NILP (file))
5943 Fsignal (Qquit, Qnil);
5944
5945 decoded_file = DECODE_FILE (file);
5946
5947 return unbind_to (count, decoded_file);
5948 }
5949
5950 #endif /* USE_MOTIF */
5951
5952 #ifdef USE_GTK
5953
5954 static void
5955 clean_up_dialog (void)
5956 {
5957 x_menu_set_in_use (false);
5958 }
5959
5960 DEFUN ("x-file-dialog", Fx_file_dialog, Sx_file_dialog, 2, 5, 0,
5961 doc: /* Read file name, prompting with PROMPT in directory DIR.
5962 Use a file selection dialog. Select DEFAULT-FILENAME in the dialog's file
5963 selection box, if specified. If MUSTMATCH is non-nil, the returned file
5964 or directory must exist.
5965
5966 This function is only defined on NS, MS Windows, and X Windows with the
5967 Motif or Gtk toolkits. With the Motif toolkit, ONLY-DIR-P is ignored.
5968 Otherwise, if ONLY-DIR-P is non-nil, the user can only select directories.
5969 On Windows 7 and later, the file selection dialog "remembers" the last
5970 directory where the user selected a file, and will open that directory
5971 instead of DIR on subsequent invocations of this function with the same
5972 value of DIR as in previous invocations; this is standard Windows behavior. */)
5973 (Lisp_Object prompt, Lisp_Object dir, Lisp_Object default_filename, Lisp_Object mustmatch, Lisp_Object only_dir_p)
5974 {
5975 struct frame *f = SELECTED_FRAME ();
5976 char *fn;
5977 Lisp_Object file = Qnil;
5978 Lisp_Object decoded_file;
5979 ptrdiff_t count = SPECPDL_INDEX ();
5980 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
5981 char *cdef_file;
5982
5983 check_window_system (f);
5984
5985 GCPRO6 (prompt, dir, default_filename, mustmatch, only_dir_p, file);
5986
5987 if (popup_activated ())
5988 error ("Trying to use a menu from within a menu-entry");
5989
5990 CHECK_STRING (prompt);
5991 CHECK_STRING (dir);
5992
5993 /* Prevent redisplay. */
5994 specbind (Qinhibit_redisplay, Qt);
5995 record_unwind_protect_void (clean_up_dialog);
5996
5997 block_input ();
5998
5999 if (STRINGP (default_filename))
6000 cdef_file = SSDATA (default_filename);
6001 else
6002 cdef_file = SSDATA (dir);
6003
6004 fn = xg_get_file_name (f, SSDATA (prompt), cdef_file,
6005 ! NILP (mustmatch),
6006 ! NILP (only_dir_p));
6007
6008 if (fn)
6009 {
6010 file = build_string (fn);
6011 xfree (fn);
6012 }
6013
6014 unblock_input ();
6015 UNGCPRO;
6016
6017 /* Make "Cancel" equivalent to C-g. */
6018 if (NILP (file))
6019 Fsignal (Qquit, Qnil);
6020
6021 decoded_file = DECODE_FILE (file);
6022
6023 return unbind_to (count, decoded_file);
6024 }
6025
6026
6027 #ifdef HAVE_FREETYPE
6028
6029 DEFUN ("x-select-font", Fx_select_font, Sx_select_font, 0, 2, 0,
6030 doc: /* Read a font using a GTK dialog.
6031 Return either a font spec (for GTK versions >= 3.2) or a string
6032 containing a GTK-style font name.
6033
6034 FRAME is the frame on which to pop up the font chooser. If omitted or
6035 nil, it defaults to the selected frame. */)
6036 (Lisp_Object frame, Lisp_Object ignored)
6037 {
6038 struct frame *f = decode_window_system_frame (frame);
6039 Lisp_Object font;
6040 Lisp_Object font_param;
6041 char *default_name = NULL;
6042 struct gcpro gcpro1, gcpro2;
6043 ptrdiff_t count = SPECPDL_INDEX ();
6044
6045 if (popup_activated ())
6046 error ("Trying to use a menu from within a menu-entry");
6047
6048 /* Prevent redisplay. */
6049 specbind (Qinhibit_redisplay, Qt);
6050 record_unwind_protect_void (clean_up_dialog);
6051
6052 block_input ();
6053
6054 GCPRO2 (font_param, font);
6055
6056 XSETFONT (font, FRAME_FONT (f));
6057 font_param = Ffont_get (font, QCname);
6058 if (STRINGP (font_param))
6059 default_name = xlispstrdup (font_param);
6060 else
6061 {
6062 font_param = Fframe_parameter (frame, Qfont_param);
6063 if (STRINGP (font_param))
6064 default_name = xlispstrdup (font_param);
6065 }
6066
6067 font = xg_get_font (f, default_name);
6068 xfree (default_name);
6069
6070 unblock_input ();
6071
6072 if (NILP (font))
6073 Fsignal (Qquit, Qnil);
6074
6075 return unbind_to (count, font);
6076 }
6077 #endif /* HAVE_FREETYPE */
6078
6079 #endif /* USE_GTK */
6080
6081 \f
6082 /***********************************************************************
6083 Keyboard
6084 ***********************************************************************/
6085
6086 #ifdef HAVE_XKB
6087 #include <X11/XKBlib.h>
6088 #include <X11/keysym.h>
6089 #endif
6090
6091 DEFUN ("x-backspace-delete-keys-p", Fx_backspace_delete_keys_p,
6092 Sx_backspace_delete_keys_p, 0, 1, 0,
6093 doc: /* Check if both Backspace and Delete keys are on the keyboard of FRAME.
6094 FRAME nil means use the selected frame.
6095 Value is t if we know that both keys are present, and are mapped to the
6096 usual X keysyms. Value is `lambda' if we cannot determine if both keys are
6097 present and mapped to the usual X keysyms. */)
6098 (Lisp_Object frame)
6099 {
6100 #ifndef HAVE_XKB
6101 return Qlambda;
6102 #else
6103 XkbDescPtr kb;
6104 struct frame *f = decode_window_system_frame (frame);
6105 Display *dpy = FRAME_X_DISPLAY (f);
6106 Lisp_Object have_keys;
6107 int major, minor, op, event, error_code;
6108
6109 block_input ();
6110
6111 /* Check library version in case we're dynamically linked. */
6112 major = XkbMajorVersion;
6113 minor = XkbMinorVersion;
6114 if (!XkbLibraryVersion (&major, &minor))
6115 {
6116 unblock_input ();
6117 return Qlambda;
6118 }
6119
6120 /* Check that the server supports XKB. */
6121 major = XkbMajorVersion;
6122 minor = XkbMinorVersion;
6123 if (!XkbQueryExtension (dpy, &op, &event, &error_code, &major, &minor))
6124 {
6125 unblock_input ();
6126 return Qlambda;
6127 }
6128
6129 /* In this code we check that the keyboard has physical keys with names
6130 that start with BKSP (Backspace) and DELE (Delete), and that they
6131 generate keysym XK_BackSpace and XK_Delete respectively.
6132 This function is used to test if normal-erase-is-backspace should be
6133 turned on.
6134 An alternative approach would be to just check if XK_BackSpace and
6135 XK_Delete are mapped to any key. But if any of those are mapped to
6136 some non-intuitive key combination (Meta-Shift-Ctrl-whatever) and the
6137 user doesn't know about it, it is better to return false here.
6138 It is more obvious to the user what to do if she/he has two keys
6139 clearly marked with names/symbols and one key does something not
6140 expected (i.e. she/he then tries the other).
6141 The cases where Backspace/Delete is mapped to some other key combination
6142 are rare, and in those cases, normal-erase-is-backspace can be turned on
6143 manually. */
6144
6145 have_keys = Qnil;
6146 kb = XkbGetMap (dpy, XkbAllMapComponentsMask, XkbUseCoreKbd);
6147 if (kb)
6148 {
6149 int delete_keycode = 0, backspace_keycode = 0, i;
6150
6151 if (XkbGetNames (dpy, XkbAllNamesMask, kb) == Success)
6152 {
6153 for (i = kb->min_key_code;
6154 (i < kb->max_key_code
6155 && (delete_keycode == 0 || backspace_keycode == 0));
6156 ++i)
6157 {
6158 /* The XKB symbolic key names can be seen most easily in
6159 the PS file generated by `xkbprint -label name
6160 $DISPLAY'. */
6161 if (memcmp ("DELE", kb->names->keys[i].name, 4) == 0)
6162 delete_keycode = i;
6163 else if (memcmp ("BKSP", kb->names->keys[i].name, 4) == 0)
6164 backspace_keycode = i;
6165 }
6166
6167 XkbFreeNames (kb, 0, True);
6168 }
6169
6170 /* As of libX11-1.6.2, XkbGetMap manual says that you should use
6171 XkbFreeClientMap to free the data returned by XkbGetMap. But
6172 this function just frees the data referenced from KB and not
6173 KB itself. To free KB as well, call XkbFreeKeyboard. */
6174 XkbFreeKeyboard (kb, XkbAllMapComponentsMask, True);
6175
6176 if (delete_keycode
6177 && backspace_keycode
6178 && XKeysymToKeycode (dpy, XK_Delete) == delete_keycode
6179 && XKeysymToKeycode (dpy, XK_BackSpace) == backspace_keycode)
6180 have_keys = Qt;
6181 }
6182 unblock_input ();
6183 return have_keys;
6184 #endif
6185 }
6186
6187
6188 \f
6189 /***********************************************************************
6190 Initialization
6191 ***********************************************************************/
6192
6193 /* Keep this list in the same order as frame_parms in frame.c.
6194 Use 0 for unsupported frame parameters. */
6195
6196 frame_parm_handler x_frame_parm_handlers[] =
6197 {
6198 x_set_autoraise,
6199 x_set_autolower,
6200 x_set_background_color,
6201 x_set_border_color,
6202 x_set_border_width,
6203 x_set_cursor_color,
6204 x_set_cursor_type,
6205 x_set_font,
6206 x_set_foreground_color,
6207 x_set_icon_name,
6208 x_set_icon_type,
6209 x_set_internal_border_width,
6210 x_set_right_divider_width,
6211 x_set_bottom_divider_width,
6212 x_set_menu_bar_lines,
6213 x_set_mouse_color,
6214 x_explicitly_set_name,
6215 x_set_scroll_bar_width,
6216 x_set_scroll_bar_height,
6217 x_set_title,
6218 x_set_unsplittable,
6219 x_set_vertical_scroll_bars,
6220 x_set_horizontal_scroll_bars,
6221 x_set_visibility,
6222 x_set_tool_bar_lines,
6223 x_set_scroll_bar_foreground,
6224 x_set_scroll_bar_background,
6225 x_set_screen_gamma,
6226 x_set_line_spacing,
6227 x_set_left_fringe,
6228 x_set_right_fringe,
6229 x_set_wait_for_wm,
6230 x_set_fullscreen,
6231 x_set_font_backend,
6232 x_set_alpha,
6233 x_set_sticky,
6234 x_set_tool_bar_position,
6235 };
6236
6237 void
6238 syms_of_xfns (void)
6239 {
6240 DEFSYM (Qundefined_color, "undefined-color");
6241 DEFSYM (Qcompound_text, "compound-text");
6242 DEFSYM (Qcancel_timer, "cancel-timer");
6243 DEFSYM (Qfont_param, "font-parameter");
6244 DEFSYM (Qmono, "mono");
6245
6246 Fput (Qundefined_color, Qerror_conditions,
6247 listn (CONSTYPE_PURE, 2, Qundefined_color, Qerror));
6248 Fput (Qundefined_color, Qerror_message,
6249 build_pure_c_string ("Undefined color"));
6250
6251 DEFVAR_LISP ("x-pointer-shape", Vx_pointer_shape,
6252 doc: /* The shape of the pointer when over text.
6253 Changing the value does not affect existing frames
6254 unless you set the mouse color. */);
6255 Vx_pointer_shape = Qnil;
6256
6257 #if false /* This doesn't really do anything. */
6258 DEFVAR_LISP ("x-nontext-pointer-shape", Vx_nontext_pointer_shape,
6259 doc: /* The shape of the pointer when not over text.
6260 This variable takes effect when you create a new frame
6261 or when you set the mouse color. */);
6262 #endif
6263 Vx_nontext_pointer_shape = Qnil;
6264
6265 DEFVAR_LISP ("x-hourglass-pointer-shape", Vx_hourglass_pointer_shape,
6266 doc: /* The shape of the pointer when Emacs is busy.
6267 This variable takes effect when you create a new frame
6268 or when you set the mouse color. */);
6269 Vx_hourglass_pointer_shape = Qnil;
6270
6271 #if false /* This doesn't really do anything. */
6272 DEFVAR_LISP ("x-mode-pointer-shape", Vx_mode_pointer_shape,
6273 doc: /* The shape of the pointer when over the mode line.
6274 This variable takes effect when you create a new frame
6275 or when you set the mouse color. */);
6276 #endif
6277 Vx_mode_pointer_shape = Qnil;
6278
6279 DEFVAR_LISP ("x-sensitive-text-pointer-shape",
6280 Vx_sensitive_text_pointer_shape,
6281 doc: /* The shape of the pointer when over mouse-sensitive text.
6282 This variable takes effect when you create a new frame
6283 or when you set the mouse color. */);
6284 Vx_sensitive_text_pointer_shape = Qnil;
6285
6286 DEFVAR_LISP ("x-window-horizontal-drag-cursor",
6287 Vx_window_horizontal_drag_shape,
6288 doc: /* Pointer shape to use for indicating a window can be dragged horizontally.
6289 This variable takes effect when you create a new frame
6290 or when you set the mouse color. */);
6291 Vx_window_horizontal_drag_shape = Qnil;
6292
6293 DEFVAR_LISP ("x-window-vertical-drag-cursor",
6294 Vx_window_vertical_drag_shape,
6295 doc: /* Pointer shape to use for indicating a window can be dragged vertically.
6296 This variable takes effect when you create a new frame
6297 or when you set the mouse color. */);
6298 Vx_window_vertical_drag_shape = Qnil;
6299
6300 DEFVAR_LISP ("x-cursor-fore-pixel", Vx_cursor_fore_pixel,
6301 doc: /* A string indicating the foreground color of the cursor box. */);
6302 Vx_cursor_fore_pixel = Qnil;
6303
6304 DEFVAR_LISP ("x-max-tooltip-size", Vx_max_tooltip_size,
6305 doc: /* Maximum size for tooltips.
6306 Value is a pair (COLUMNS . ROWS). Text larger than this is clipped. */);
6307 Vx_max_tooltip_size = Fcons (make_number (80), make_number (40));
6308
6309 DEFVAR_LISP ("x-no-window-manager", Vx_no_window_manager,
6310 doc: /* Non-nil if no X window manager is in use.
6311 Emacs doesn't try to figure this out; this is always nil
6312 unless you set it to something else. */);
6313 /* We don't have any way to find this out, so set it to nil
6314 and maybe the user would like to set it to t. */
6315 Vx_no_window_manager = Qnil;
6316
6317 DEFVAR_LISP ("x-pixel-size-width-font-regexp",
6318 Vx_pixel_size_width_font_regexp,
6319 doc: /* Regexp matching a font name whose width is the same as `PIXEL_SIZE'.
6320
6321 Since Emacs gets width of a font matching with this regexp from
6322 PIXEL_SIZE field of the name, font finding mechanism gets faster for
6323 such a font. This is especially effective for such large fonts as
6324 Chinese, Japanese, and Korean. */);
6325 Vx_pixel_size_width_font_regexp = Qnil;
6326
6327 /* This is not ifdef:ed, so other builds than GTK can customize it. */
6328 DEFVAR_BOOL ("x-gtk-use-old-file-dialog", x_gtk_use_old_file_dialog,
6329 doc: /* Non-nil means prompt with the old GTK file selection dialog.
6330 If nil or if the file selection dialog is not available, the new GTK file
6331 chooser is used instead. To turn off all file dialogs set the
6332 variable `use-file-dialog'. */);
6333 x_gtk_use_old_file_dialog = false;
6334
6335 DEFVAR_BOOL ("x-gtk-show-hidden-files", x_gtk_show_hidden_files,
6336 doc: /* If non-nil, the GTK file chooser will by default show hidden files.
6337 Note that this is just the default, there is a toggle button on the file
6338 chooser to show or not show hidden files on a case by case basis. */);
6339 x_gtk_show_hidden_files = false;
6340
6341 DEFVAR_BOOL ("x-gtk-file-dialog-help-text", x_gtk_file_dialog_help_text,
6342 doc: /* If non-nil, the GTK file chooser will show additional help text.
6343 If more space for files in the file chooser dialog is wanted, set this to nil
6344 to turn the additional text off. */);
6345 x_gtk_file_dialog_help_text = true;
6346
6347 DEFVAR_BOOL ("x-gtk-use-system-tooltips", x_gtk_use_system_tooltips,
6348 doc: /* If non-nil with a Gtk+ built Emacs, the Gtk+ tooltip is used.
6349 Otherwise use Emacs own tooltip implementation.
6350 When using Gtk+ tooltips, the tooltip face is not used. */);
6351 x_gtk_use_system_tooltips = true;
6352
6353 /* Tell Emacs about this window system. */
6354 Fprovide (Qx, Qnil);
6355
6356 #ifdef USE_X_TOOLKIT
6357 Fprovide (intern_c_string ("x-toolkit"), Qnil);
6358 #ifdef USE_MOTIF
6359 Fprovide (intern_c_string ("motif"), Qnil);
6360
6361 DEFVAR_LISP ("motif-version-string", Vmotif_version_string,
6362 doc: /* Version info for LessTif/Motif. */);
6363 Vmotif_version_string = build_string (XmVERSION_STRING);
6364 #endif /* USE_MOTIF */
6365 #endif /* USE_X_TOOLKIT */
6366
6367 #ifdef USE_GTK
6368 /* Provide x-toolkit also for GTK. Internally GTK does not use Xt so it
6369 is not an X toolkit in that sense (USE_X_TOOLKIT is not defined).
6370 But for a user it is a toolkit for X, and indeed, configure
6371 accepts --with-x-toolkit=gtk. */
6372 Fprovide (intern_c_string ("x-toolkit"), Qnil);
6373 Fprovide (intern_c_string ("gtk"), Qnil);
6374 Fprovide (intern_c_string ("move-toolbar"), Qnil);
6375
6376 DEFVAR_LISP ("gtk-version-string", Vgtk_version_string,
6377 doc: /* Version info for GTK+. */);
6378 {
6379 char gtk_version[sizeof ".." + 3 * INT_STRLEN_BOUND (int)];
6380 int len = sprintf (gtk_version, "%d.%d.%d",
6381 GTK_MAJOR_VERSION, GTK_MINOR_VERSION, GTK_MICRO_VERSION);
6382 Vgtk_version_string = make_pure_string (gtk_version, len, len, false);
6383 }
6384 #endif /* USE_GTK */
6385
6386 /* X window properties. */
6387 defsubr (&Sx_change_window_property);
6388 defsubr (&Sx_delete_window_property);
6389 defsubr (&Sx_window_property);
6390
6391 defsubr (&Sxw_display_color_p);
6392 defsubr (&Sx_display_grayscale_p);
6393 defsubr (&Sxw_color_defined_p);
6394 defsubr (&Sxw_color_values);
6395 defsubr (&Sx_server_max_request_size);
6396 defsubr (&Sx_server_vendor);
6397 defsubr (&Sx_server_version);
6398 defsubr (&Sx_display_pixel_width);
6399 defsubr (&Sx_display_pixel_height);
6400 defsubr (&Sx_display_mm_width);
6401 defsubr (&Sx_display_mm_height);
6402 defsubr (&Sx_display_screens);
6403 defsubr (&Sx_display_planes);
6404 defsubr (&Sx_display_color_cells);
6405 defsubr (&Sx_display_visual_class);
6406 defsubr (&Sx_display_backing_store);
6407 defsubr (&Sx_display_save_under);
6408 defsubr (&Sx_display_monitor_attributes_list);
6409 defsubr (&Sx_frame_geometry);
6410 defsubr (&Sx_wm_set_size_hint);
6411 defsubr (&Sx_create_frame);
6412 defsubr (&Sx_open_connection);
6413 defsubr (&Sx_close_connection);
6414 defsubr (&Sx_display_list);
6415 defsubr (&Sx_synchronize);
6416 defsubr (&Sx_backspace_delete_keys_p);
6417
6418 defsubr (&Sx_show_tip);
6419 defsubr (&Sx_hide_tip);
6420 tip_timer = Qnil;
6421 staticpro (&tip_timer);
6422 tip_frame = Qnil;
6423 staticpro (&tip_frame);
6424
6425 last_show_tip_args = Qnil;
6426 staticpro (&last_show_tip_args);
6427
6428 defsubr (&Sx_uses_old_gtk_dialog);
6429 #if defined (USE_MOTIF) || defined (USE_GTK)
6430 defsubr (&Sx_file_dialog);
6431 #endif
6432
6433 #if defined (USE_GTK) && defined (HAVE_FREETYPE)
6434 defsubr (&Sx_select_font);
6435 #endif
6436 }