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