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