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