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