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