Merged from emacs@sv.gnu.org
[bpt/emacs.git] / 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 Fsignal (Qerror, Fcons (build_string ("Undefined color"),
774 Fcons (color_name, Qnil)));
775 return 0;
776 }
777
778
779 \f
780 /* Change the `wait-for-wm' frame parameter of frame F. OLD_VALUE is
781 the previous value of that parameter, NEW_VALUE is the new value.
782 See also the comment of wait_for_wm in struct x_output. */
783
784 static void
785 x_set_wait_for_wm (f, new_value, old_value)
786 struct frame *f;
787 Lisp_Object new_value, old_value;
788 {
789 f->output_data.x->wait_for_wm = !NILP (new_value);
790 }
791
792 #ifdef USE_GTK
793
794 /* Set icon from FILE for frame F. By using GTK functions the icon
795 may be any format that GdkPixbuf knows about, i.e. not just bitmaps. */
796
797 int
798 xg_set_icon (f, file)
799 FRAME_PTR f;
800 Lisp_Object file;
801 {
802 int result = 0;
803 Lisp_Object found;
804
805 found = x_find_image_file (file);
806
807 if (! NILP (found))
808 {
809 GdkPixbuf *pixbuf;
810 GError *err = NULL;
811 char *filename = (char *) SDATA (found);
812 BLOCK_INPUT;
813
814 pixbuf = gdk_pixbuf_new_from_file (filename, &err);
815
816 if (pixbuf)
817 {
818 gtk_window_set_icon (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)),
819 pixbuf);
820 g_object_unref (pixbuf);
821
822 result = 1;
823 }
824 else
825 g_error_free (err);
826
827 UNBLOCK_INPUT;
828 }
829
830 return result;
831 }
832
833 int
834 xg_set_icon_from_xpm_data (f, data)
835 FRAME_PTR f;
836 char **data;
837 {
838 int result = 0;
839 GdkPixbuf *pixbuf = gdk_pixbuf_new_from_xpm_data ((const char **) data);
840
841 if (!pixbuf)
842 return 0;
843
844 gtk_window_set_icon (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)), pixbuf);
845 g_object_unref (pixbuf);
846 return 1;
847 }
848 #endif /* USE_GTK */
849
850
851 /* Functions called only from `x_set_frame_param'
852 to set individual parameters.
853
854 If FRAME_X_WINDOW (f) is 0,
855 the frame is being created and its X-window does not exist yet.
856 In that case, just record the parameter's new value
857 in the standard place; do not attempt to change the window. */
858
859 void
860 x_set_foreground_color (f, arg, oldval)
861 struct frame *f;
862 Lisp_Object arg, oldval;
863 {
864 struct x_output *x = f->output_data.x;
865 unsigned long fg, old_fg;
866
867 fg = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
868 old_fg = FRAME_FOREGROUND_PIXEL (f);
869 FRAME_FOREGROUND_PIXEL (f) = fg;
870
871 if (FRAME_X_WINDOW (f) != 0)
872 {
873 Display *dpy = FRAME_X_DISPLAY (f);
874
875 BLOCK_INPUT;
876 XSetForeground (dpy, x->normal_gc, fg);
877 XSetBackground (dpy, x->reverse_gc, fg);
878
879 if (x->cursor_pixel == old_fg)
880 {
881 unload_color (f, x->cursor_pixel);
882 x->cursor_pixel = x_copy_color (f, fg);
883 XSetBackground (dpy, x->cursor_gc, x->cursor_pixel);
884 }
885
886 UNBLOCK_INPUT;
887
888 update_face_from_frame_parameter (f, Qforeground_color, arg);
889
890 if (FRAME_VISIBLE_P (f))
891 redraw_frame (f);
892 }
893
894 unload_color (f, old_fg);
895 }
896
897 void
898 x_set_background_color (f, arg, oldval)
899 struct frame *f;
900 Lisp_Object arg, oldval;
901 {
902 struct x_output *x = f->output_data.x;
903 unsigned long bg;
904
905 bg = x_decode_color (f, arg, WHITE_PIX_DEFAULT (f));
906 unload_color (f, FRAME_BACKGROUND_PIXEL (f));
907 FRAME_BACKGROUND_PIXEL (f) = bg;
908
909 if (FRAME_X_WINDOW (f) != 0)
910 {
911 Display *dpy = FRAME_X_DISPLAY (f);
912
913 BLOCK_INPUT;
914 XSetBackground (dpy, x->normal_gc, bg);
915 XSetForeground (dpy, x->reverse_gc, bg);
916 XSetWindowBackground (dpy, FRAME_X_WINDOW (f), bg);
917 XSetForeground (dpy, x->cursor_gc, bg);
918
919 #ifdef USE_GTK
920 xg_set_background_color (f, bg);
921 #endif
922
923 #ifndef USE_TOOLKIT_SCROLL_BARS /* Turns out to be annoying with
924 toolkit scroll bars. */
925 {
926 Lisp_Object bar;
927 for (bar = FRAME_SCROLL_BARS (f);
928 !NILP (bar);
929 bar = XSCROLL_BAR (bar)->next)
930 {
931 Window window = SCROLL_BAR_X_WINDOW (XSCROLL_BAR (bar));
932 XSetWindowBackground (dpy, window, bg);
933 }
934 }
935 #endif /* USE_TOOLKIT_SCROLL_BARS */
936
937 UNBLOCK_INPUT;
938 update_face_from_frame_parameter (f, Qbackground_color, arg);
939
940 if (FRAME_VISIBLE_P (f))
941 redraw_frame (f);
942 }
943 }
944
945 void
946 x_set_mouse_color (f, arg, oldval)
947 struct frame *f;
948 Lisp_Object arg, oldval;
949 {
950 struct x_output *x = f->output_data.x;
951 Display *dpy = FRAME_X_DISPLAY (f);
952 Cursor cursor, nontext_cursor, mode_cursor, hand_cursor;
953 Cursor hourglass_cursor, horizontal_drag_cursor;
954 unsigned long pixel = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
955 unsigned long mask_color = FRAME_BACKGROUND_PIXEL (f);
956
957 /* Don't let pointers be invisible. */
958 if (mask_color == pixel)
959 {
960 x_free_colors (f, &pixel, 1);
961 pixel = x_copy_color (f, FRAME_FOREGROUND_PIXEL (f));
962 }
963
964 unload_color (f, x->mouse_pixel);
965 x->mouse_pixel = pixel;
966
967 BLOCK_INPUT;
968
969 /* It's not okay to crash if the user selects a screwy cursor. */
970 x_catch_errors (dpy);
971
972 if (!NILP (Vx_pointer_shape))
973 {
974 CHECK_NUMBER (Vx_pointer_shape);
975 cursor = XCreateFontCursor (dpy, XINT (Vx_pointer_shape));
976 }
977 else
978 cursor = XCreateFontCursor (dpy, XC_xterm);
979 x_check_errors (dpy, "bad text pointer cursor: %s");
980
981 if (!NILP (Vx_nontext_pointer_shape))
982 {
983 CHECK_NUMBER (Vx_nontext_pointer_shape);
984 nontext_cursor
985 = XCreateFontCursor (dpy, XINT (Vx_nontext_pointer_shape));
986 }
987 else
988 nontext_cursor = XCreateFontCursor (dpy, XC_left_ptr);
989 x_check_errors (dpy, "bad nontext pointer cursor: %s");
990
991 if (!NILP (Vx_hourglass_pointer_shape))
992 {
993 CHECK_NUMBER (Vx_hourglass_pointer_shape);
994 hourglass_cursor
995 = XCreateFontCursor (dpy, XINT (Vx_hourglass_pointer_shape));
996 }
997 else
998 hourglass_cursor = XCreateFontCursor (dpy, XC_watch);
999 x_check_errors (dpy, "bad hourglass pointer cursor: %s");
1000
1001 if (!NILP (Vx_mode_pointer_shape))
1002 {
1003 CHECK_NUMBER (Vx_mode_pointer_shape);
1004 mode_cursor = XCreateFontCursor (dpy, XINT (Vx_mode_pointer_shape));
1005 }
1006 else
1007 mode_cursor = XCreateFontCursor (dpy, XC_xterm);
1008 x_check_errors (dpy, "bad modeline pointer cursor: %s");
1009
1010 if (!NILP (Vx_sensitive_text_pointer_shape))
1011 {
1012 CHECK_NUMBER (Vx_sensitive_text_pointer_shape);
1013 hand_cursor
1014 = XCreateFontCursor (dpy, XINT (Vx_sensitive_text_pointer_shape));
1015 }
1016 else
1017 hand_cursor = XCreateFontCursor (dpy, XC_hand2);
1018
1019 if (!NILP (Vx_window_horizontal_drag_shape))
1020 {
1021 CHECK_NUMBER (Vx_window_horizontal_drag_shape);
1022 horizontal_drag_cursor
1023 = XCreateFontCursor (dpy, XINT (Vx_window_horizontal_drag_shape));
1024 }
1025 else
1026 horizontal_drag_cursor
1027 = XCreateFontCursor (dpy, XC_sb_h_double_arrow);
1028
1029 /* Check and report errors with the above calls. */
1030 x_check_errors (dpy, "can't set cursor shape: %s");
1031 x_uncatch_errors ();
1032
1033 {
1034 XColor fore_color, back_color;
1035
1036 fore_color.pixel = x->mouse_pixel;
1037 x_query_color (f, &fore_color);
1038 back_color.pixel = mask_color;
1039 x_query_color (f, &back_color);
1040
1041 XRecolorCursor (dpy, cursor, &fore_color, &back_color);
1042 XRecolorCursor (dpy, nontext_cursor, &fore_color, &back_color);
1043 XRecolorCursor (dpy, mode_cursor, &fore_color, &back_color);
1044 XRecolorCursor (dpy, hand_cursor, &fore_color, &back_color);
1045 XRecolorCursor (dpy, hourglass_cursor, &fore_color, &back_color);
1046 XRecolorCursor (dpy, horizontal_drag_cursor, &fore_color, &back_color);
1047 }
1048
1049 if (FRAME_X_WINDOW (f) != 0)
1050 XDefineCursor (dpy, FRAME_X_WINDOW (f), cursor);
1051
1052 if (cursor != x->text_cursor
1053 && x->text_cursor != 0)
1054 XFreeCursor (dpy, x->text_cursor);
1055 x->text_cursor = cursor;
1056
1057 if (nontext_cursor != x->nontext_cursor
1058 && x->nontext_cursor != 0)
1059 XFreeCursor (dpy, x->nontext_cursor);
1060 x->nontext_cursor = nontext_cursor;
1061
1062 if (hourglass_cursor != x->hourglass_cursor
1063 && x->hourglass_cursor != 0)
1064 XFreeCursor (dpy, x->hourglass_cursor);
1065 x->hourglass_cursor = hourglass_cursor;
1066
1067 if (mode_cursor != x->modeline_cursor
1068 && x->modeline_cursor != 0)
1069 XFreeCursor (dpy, f->output_data.x->modeline_cursor);
1070 x->modeline_cursor = mode_cursor;
1071
1072 if (hand_cursor != x->hand_cursor
1073 && x->hand_cursor != 0)
1074 XFreeCursor (dpy, x->hand_cursor);
1075 x->hand_cursor = hand_cursor;
1076
1077 if (horizontal_drag_cursor != x->horizontal_drag_cursor
1078 && x->horizontal_drag_cursor != 0)
1079 XFreeCursor (dpy, x->horizontal_drag_cursor);
1080 x->horizontal_drag_cursor = horizontal_drag_cursor;
1081
1082 XFlush (dpy);
1083 UNBLOCK_INPUT;
1084
1085 update_face_from_frame_parameter (f, Qmouse_color, arg);
1086 }
1087
1088 void
1089 x_set_cursor_color (f, arg, oldval)
1090 struct frame *f;
1091 Lisp_Object arg, oldval;
1092 {
1093 unsigned long fore_pixel, pixel;
1094 int fore_pixel_allocated_p = 0, pixel_allocated_p = 0;
1095 struct x_output *x = f->output_data.x;
1096
1097 if (!NILP (Vx_cursor_fore_pixel))
1098 {
1099 fore_pixel = x_decode_color (f, Vx_cursor_fore_pixel,
1100 WHITE_PIX_DEFAULT (f));
1101 fore_pixel_allocated_p = 1;
1102 }
1103 else
1104 fore_pixel = FRAME_BACKGROUND_PIXEL (f);
1105
1106 pixel = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
1107 pixel_allocated_p = 1;
1108
1109 /* Make sure that the cursor color differs from the background color. */
1110 if (pixel == FRAME_BACKGROUND_PIXEL (f))
1111 {
1112 if (pixel_allocated_p)
1113 {
1114 x_free_colors (f, &pixel, 1);
1115 pixel_allocated_p = 0;
1116 }
1117
1118 pixel = x->mouse_pixel;
1119 if (pixel == fore_pixel)
1120 {
1121 if (fore_pixel_allocated_p)
1122 {
1123 x_free_colors (f, &fore_pixel, 1);
1124 fore_pixel_allocated_p = 0;
1125 }
1126 fore_pixel = FRAME_BACKGROUND_PIXEL (f);
1127 }
1128 }
1129
1130 unload_color (f, x->cursor_foreground_pixel);
1131 if (!fore_pixel_allocated_p)
1132 fore_pixel = x_copy_color (f, fore_pixel);
1133 x->cursor_foreground_pixel = fore_pixel;
1134
1135 unload_color (f, x->cursor_pixel);
1136 if (!pixel_allocated_p)
1137 pixel = x_copy_color (f, pixel);
1138 x->cursor_pixel = pixel;
1139
1140 if (FRAME_X_WINDOW (f) != 0)
1141 {
1142 BLOCK_INPUT;
1143 XSetBackground (FRAME_X_DISPLAY (f), x->cursor_gc, x->cursor_pixel);
1144 XSetForeground (FRAME_X_DISPLAY (f), x->cursor_gc, fore_pixel);
1145 UNBLOCK_INPUT;
1146
1147 if (FRAME_VISIBLE_P (f))
1148 {
1149 x_update_cursor (f, 0);
1150 x_update_cursor (f, 1);
1151 }
1152 }
1153
1154 update_face_from_frame_parameter (f, Qcursor_color, arg);
1155 }
1156 \f
1157 /* Set the border-color of frame F to pixel value PIX.
1158 Note that this does not fully take effect if done before
1159 F has an x-window. */
1160
1161 void
1162 x_set_border_pixel (f, pix)
1163 struct frame *f;
1164 int pix;
1165 {
1166 unload_color (f, f->output_data.x->border_pixel);
1167 f->output_data.x->border_pixel = pix;
1168
1169 if (FRAME_X_WINDOW (f) != 0 && f->border_width > 0)
1170 {
1171 BLOCK_INPUT;
1172 XSetWindowBorder (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1173 (unsigned long)pix);
1174 UNBLOCK_INPUT;
1175
1176 if (FRAME_VISIBLE_P (f))
1177 redraw_frame (f);
1178 }
1179 }
1180
1181 /* Set the border-color of frame F to value described by ARG.
1182 ARG can be a string naming a color.
1183 The border-color is used for the border that is drawn by the X server.
1184 Note that this does not fully take effect if done before
1185 F has an x-window; it must be redone when the window is created.
1186
1187 Note: this is done in two routines because of the way X10 works.
1188
1189 Note: under X11, this is normally the province of the window manager,
1190 and so emacs' border colors may be overridden. */
1191
1192 void
1193 x_set_border_color (f, arg, oldval)
1194 struct frame *f;
1195 Lisp_Object arg, oldval;
1196 {
1197 int pix;
1198
1199 CHECK_STRING (arg);
1200 pix = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
1201 x_set_border_pixel (f, pix);
1202 update_face_from_frame_parameter (f, Qborder_color, arg);
1203 }
1204
1205
1206 void
1207 x_set_cursor_type (f, arg, oldval)
1208 FRAME_PTR f;
1209 Lisp_Object arg, oldval;
1210 {
1211 set_frame_cursor_types (f, arg);
1212
1213 /* Make sure the cursor gets redrawn. */
1214 cursor_type_changed = 1;
1215 }
1216 \f
1217 void
1218 x_set_icon_type (f, arg, oldval)
1219 struct frame *f;
1220 Lisp_Object arg, oldval;
1221 {
1222 int result;
1223
1224 if (STRINGP (arg))
1225 {
1226 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
1227 return;
1228 }
1229 else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
1230 return;
1231
1232 BLOCK_INPUT;
1233 if (NILP (arg))
1234 result = x_text_icon (f,
1235 (char *) SDATA ((!NILP (f->icon_name)
1236 ? f->icon_name
1237 : f->name)));
1238 else
1239 result = x_bitmap_icon (f, arg);
1240
1241 if (result)
1242 {
1243 UNBLOCK_INPUT;
1244 error ("No icon window available");
1245 }
1246
1247 XFlush (FRAME_X_DISPLAY (f));
1248 UNBLOCK_INPUT;
1249 }
1250
1251 void
1252 x_set_icon_name (f, arg, oldval)
1253 struct frame *f;
1254 Lisp_Object arg, oldval;
1255 {
1256 int result;
1257
1258 if (STRINGP (arg))
1259 {
1260 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
1261 return;
1262 }
1263 else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
1264 return;
1265
1266 f->icon_name = arg;
1267
1268 if (f->output_data.x->icon_bitmap != 0)
1269 return;
1270
1271 BLOCK_INPUT;
1272
1273 result = x_text_icon (f,
1274 (char *) SDATA ((!NILP (f->icon_name)
1275 ? f->icon_name
1276 : !NILP (f->title)
1277 ? f->title
1278 : f->name)));
1279
1280 if (result)
1281 {
1282 UNBLOCK_INPUT;
1283 error ("No icon window available");
1284 }
1285
1286 XFlush (FRAME_X_DISPLAY (f));
1287 UNBLOCK_INPUT;
1288 }
1289
1290 \f
1291 void
1292 x_set_menu_bar_lines (f, value, oldval)
1293 struct frame *f;
1294 Lisp_Object value, oldval;
1295 {
1296 int nlines;
1297 #if ! defined (USE_X_TOOLKIT) && ! defined (USE_GTK)
1298 int olines = FRAME_MENU_BAR_LINES (f);
1299 #endif
1300
1301 /* Right now, menu bars don't work properly in minibuf-only frames;
1302 most of the commands try to apply themselves to the minibuffer
1303 frame itself, and get an error because you can't switch buffers
1304 in or split the minibuffer window. */
1305 if (FRAME_MINIBUF_ONLY_P (f))
1306 return;
1307
1308 if (INTEGERP (value))
1309 nlines = XINT (value);
1310 else
1311 nlines = 0;
1312
1313 /* Make sure we redisplay all windows in this frame. */
1314 windows_or_buffers_changed++;
1315
1316 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
1317 FRAME_MENU_BAR_LINES (f) = 0;
1318 if (nlines)
1319 {
1320 FRAME_EXTERNAL_MENU_BAR (f) = 1;
1321 if (FRAME_X_P (f) && f->output_data.x->menubar_widget == 0)
1322 /* Make sure next redisplay shows the menu bar. */
1323 XWINDOW (FRAME_SELECTED_WINDOW (f))->update_mode_line = Qt;
1324 }
1325 else
1326 {
1327 if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
1328 free_frame_menubar (f);
1329 FRAME_EXTERNAL_MENU_BAR (f) = 0;
1330 if (FRAME_X_P (f))
1331 f->output_data.x->menubar_widget = 0;
1332 }
1333 #else /* not USE_X_TOOLKIT && not USE_GTK */
1334 FRAME_MENU_BAR_LINES (f) = nlines;
1335 change_window_heights (f->root_window, nlines - olines);
1336 #endif /* not USE_X_TOOLKIT */
1337 adjust_glyphs (f);
1338 }
1339
1340
1341 /* Set the number of lines used for the tool bar of frame F to VALUE.
1342 VALUE not an integer, or < 0 means set the lines to zero. OLDVAL
1343 is the old number of tool bar lines. This function changes the
1344 height of all windows on frame F to match the new tool bar height.
1345 The frame's height doesn't change. */
1346
1347 void
1348 x_set_tool_bar_lines (f, value, oldval)
1349 struct frame *f;
1350 Lisp_Object value, oldval;
1351 {
1352 int delta, nlines, root_height;
1353 Lisp_Object root_window;
1354
1355 /* Treat tool bars like menu bars. */
1356 if (FRAME_MINIBUF_ONLY_P (f))
1357 return;
1358
1359 /* Use VALUE only if an integer >= 0. */
1360 if (INTEGERP (value) && XINT (value) >= 0)
1361 nlines = XFASTINT (value);
1362 else
1363 nlines = 0;
1364
1365 #ifdef USE_GTK
1366 FRAME_TOOL_BAR_LINES (f) = 0;
1367 if (nlines)
1368 {
1369 FRAME_EXTERNAL_TOOL_BAR (f) = 1;
1370 if (FRAME_X_P (f) && f->output_data.x->toolbar_widget == 0)
1371 /* Make sure next redisplay shows the tool bar. */
1372 XWINDOW (FRAME_SELECTED_WINDOW (f))->update_mode_line = Qt;
1373 update_frame_tool_bar (f);
1374 }
1375 else
1376 {
1377 if (FRAME_EXTERNAL_TOOL_BAR (f))
1378 free_frame_tool_bar (f);
1379 FRAME_EXTERNAL_TOOL_BAR (f) = 0;
1380 }
1381
1382 return;
1383 #endif
1384
1385 /* Make sure we redisplay all windows in this frame. */
1386 ++windows_or_buffers_changed;
1387
1388 delta = nlines - FRAME_TOOL_BAR_LINES (f);
1389
1390 /* Don't resize the tool-bar to more than we have room for. */
1391 root_window = FRAME_ROOT_WINDOW (f);
1392 root_height = WINDOW_TOTAL_LINES (XWINDOW (root_window));
1393 if (root_height - delta < 1)
1394 {
1395 delta = root_height - 1;
1396 nlines = FRAME_TOOL_BAR_LINES (f) + delta;
1397 }
1398
1399 FRAME_TOOL_BAR_LINES (f) = nlines;
1400 change_window_heights (root_window, delta);
1401 adjust_glyphs (f);
1402
1403 /* We also have to make sure that the internal border at the top of
1404 the frame, below the menu bar or tool bar, is redrawn when the
1405 tool bar disappears. This is so because the internal border is
1406 below the tool bar if one is displayed, but is below the menu bar
1407 if there isn't a tool bar. The tool bar draws into the area
1408 below the menu bar. */
1409 if (FRAME_X_WINDOW (f) && FRAME_TOOL_BAR_LINES (f) == 0)
1410 {
1411 clear_frame (f);
1412 clear_current_matrices (f);
1413 }
1414
1415 /* If the tool bar gets smaller, the internal border below it
1416 has to be cleared. It was formerly part of the display
1417 of the larger tool bar, and updating windows won't clear it. */
1418 if (delta < 0)
1419 {
1420 int height = FRAME_INTERNAL_BORDER_WIDTH (f);
1421 int width = FRAME_PIXEL_WIDTH (f);
1422 int y = nlines * FRAME_LINE_HEIGHT (f);
1423
1424 /* height can be zero here. */
1425 if (height > 0 && width > 0)
1426 {
1427 BLOCK_INPUT;
1428 x_clear_area (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1429 0, y, width, height, False);
1430 UNBLOCK_INPUT;
1431 }
1432
1433 if (WINDOWP (f->tool_bar_window))
1434 clear_glyph_matrix (XWINDOW (f->tool_bar_window)->current_matrix);
1435 }
1436 }
1437
1438
1439 /* Set the foreground color for scroll bars on frame F to VALUE.
1440 VALUE should be a string, a color name. If it isn't a string or
1441 isn't a valid color name, do nothing. OLDVAL is the old value of
1442 the frame parameter. */
1443
1444 void
1445 x_set_scroll_bar_foreground (f, value, oldval)
1446 struct frame *f;
1447 Lisp_Object value, oldval;
1448 {
1449 unsigned long pixel;
1450
1451 if (STRINGP (value))
1452 pixel = x_decode_color (f, value, BLACK_PIX_DEFAULT (f));
1453 else
1454 pixel = -1;
1455
1456 if (f->output_data.x->scroll_bar_foreground_pixel != -1)
1457 unload_color (f, f->output_data.x->scroll_bar_foreground_pixel);
1458
1459 f->output_data.x->scroll_bar_foreground_pixel = pixel;
1460 if (FRAME_X_WINDOW (f) && FRAME_VISIBLE_P (f))
1461 {
1462 /* Remove all scroll bars because they have wrong colors. */
1463 if (FRAME_TERMINAL (f)->condemn_scroll_bars_hook)
1464 (*FRAME_TERMINAL (f)->condemn_scroll_bars_hook) (f);
1465 if (FRAME_TERMINAL (f)->judge_scroll_bars_hook)
1466 (*FRAME_TERMINAL (f)->judge_scroll_bars_hook) (f);
1467
1468 update_face_from_frame_parameter (f, Qscroll_bar_foreground, value);
1469 redraw_frame (f);
1470 }
1471 }
1472
1473
1474 /* Set the background color for scroll bars on frame F to VALUE VALUE
1475 should be a string, a color name. If it isn't a string or isn't a
1476 valid color name, do nothing. OLDVAL is the old value of the frame
1477 parameter. */
1478
1479 void
1480 x_set_scroll_bar_background (f, value, oldval)
1481 struct frame *f;
1482 Lisp_Object value, oldval;
1483 {
1484 unsigned long pixel;
1485
1486 if (STRINGP (value))
1487 pixel = x_decode_color (f, value, WHITE_PIX_DEFAULT (f));
1488 else
1489 pixel = -1;
1490
1491 if (f->output_data.x->scroll_bar_background_pixel != -1)
1492 unload_color (f, f->output_data.x->scroll_bar_background_pixel);
1493
1494 #ifdef USE_TOOLKIT_SCROLL_BARS
1495 /* Scrollbar shadow colors. */
1496 if (f->output_data.x->scroll_bar_top_shadow_pixel != -1)
1497 {
1498 unload_color (f, f->output_data.x->scroll_bar_top_shadow_pixel);
1499 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
1500 }
1501 if (f->output_data.x->scroll_bar_bottom_shadow_pixel != -1)
1502 {
1503 unload_color (f, f->output_data.x->scroll_bar_bottom_shadow_pixel);
1504 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
1505 }
1506 #endif /* USE_TOOLKIT_SCROLL_BARS */
1507
1508 f->output_data.x->scroll_bar_background_pixel = pixel;
1509 if (FRAME_X_WINDOW (f) && FRAME_VISIBLE_P (f))
1510 {
1511 /* Remove all scroll bars because they have wrong colors. */
1512 if (FRAME_TERMINAL (f)->condemn_scroll_bars_hook)
1513 (*FRAME_TERMINAL (f)->condemn_scroll_bars_hook) (f);
1514 if (FRAME_TERMINAL (f)->judge_scroll_bars_hook)
1515 (*FRAME_TERMINAL (f)->judge_scroll_bars_hook) (f);
1516
1517 update_face_from_frame_parameter (f, Qscroll_bar_background, value);
1518 redraw_frame (f);
1519 }
1520 }
1521
1522 \f
1523 /* Encode Lisp string STRING as a text in a format appropriate for
1524 XICCC (X Inter Client Communication Conventions).
1525
1526 If STRING contains only ASCII characters, do no conversion and
1527 return the string data of STRING. Otherwise, encode the text by
1528 CODING_SYSTEM, and return a newly allocated memory area which
1529 should be freed by `xfree' by a caller.
1530
1531 SELECTIONP non-zero means the string is being encoded for an X
1532 selection, so it is safe to run pre-write conversions (which
1533 may run Lisp code).
1534
1535 Store the byte length of resulting text in *TEXT_BYTES.
1536
1537 If the text contains only ASCII and Latin-1, store 1 in *STRING_P,
1538 which means that the `encoding' of the result can be `STRING'.
1539 Otherwise store 0 in *STRINGP, which means that the `encoding' of
1540 the result should be `COMPOUND_TEXT'. */
1541
1542 static unsigned char *
1543 x_encode_text (string, coding_system, selectionp, text_bytes, stringp, freep)
1544 Lisp_Object string, coding_system;
1545 int *text_bytes, *stringp;
1546 int selectionp;
1547 int *freep;
1548 {
1549 unsigned char *str = SDATA (string);
1550 int chars = SCHARS (string);
1551 int bytes = SBYTES (string);
1552 int charset_info;
1553 int bufsize;
1554 unsigned char *buf;
1555 struct coding_system coding;
1556 extern Lisp_Object Qcompound_text_with_extensions;
1557
1558 charset_info = find_charset_in_text (str, chars, bytes, NULL, Qnil);
1559 if (charset_info == 0)
1560 {
1561 /* No multibyte character in OBJ. We need not encode it. */
1562 *text_bytes = bytes;
1563 *stringp = 1;
1564 *freep = 0;
1565 return str;
1566 }
1567
1568 setup_coding_system (coding_system, &coding);
1569 if (selectionp
1570 && SYMBOLP (coding.pre_write_conversion)
1571 && !NILP (Ffboundp (coding.pre_write_conversion)))
1572 {
1573 string = run_pre_post_conversion_on_str (string, &coding, 1);
1574 str = SDATA (string);
1575 chars = SCHARS (string);
1576 bytes = SBYTES (string);
1577 }
1578 coding.src_multibyte = 1;
1579 coding.dst_multibyte = 0;
1580 coding.mode |= CODING_MODE_LAST_BLOCK;
1581 if (coding.type == coding_type_iso2022)
1582 coding.flags |= CODING_FLAG_ISO_SAFE;
1583 /* We suppress producing escape sequences for composition. */
1584 coding.composing = COMPOSITION_DISABLED;
1585 bufsize = encoding_buffer_size (&coding, bytes);
1586 buf = (unsigned char *) xmalloc (bufsize);
1587 encode_coding (&coding, str, buf, bytes, bufsize);
1588 *text_bytes = coding.produced;
1589 *stringp = (charset_info == 1
1590 || (!EQ (coding_system, Qcompound_text)
1591 && !EQ (coding_system, Qcompound_text_with_extensions)));
1592 *freep = 1;
1593 return buf;
1594 }
1595
1596 \f
1597 /* Set the WM name to NAME for frame F. Also set the icon name.
1598 If the frame already has an icon name, use that, otherwise set the
1599 icon name to NAME. */
1600
1601 static void
1602 x_set_name_internal (f, name)
1603 FRAME_PTR f;
1604 Lisp_Object name;
1605 {
1606 if (FRAME_X_WINDOW (f))
1607 {
1608 BLOCK_INPUT;
1609 #ifdef HAVE_X11R4
1610 {
1611 XTextProperty text, icon;
1612 int bytes, stringp;
1613 int do_free_icon_value = 0, do_free_text_value = 0;
1614 Lisp_Object coding_system;
1615
1616 coding_system = Qcompound_text;
1617 /* Note: Encoding strategy
1618
1619 We encode NAME by compound-text and use "COMPOUND-TEXT" in
1620 text.encoding. But, there are non-internationalized window
1621 managers which don't support that encoding. So, if NAME
1622 contains only ASCII and 8859-1 characters, encode it by
1623 iso-latin-1, and use "STRING" in text.encoding hoping that
1624 such window managers at least analyze this format correctly,
1625 i.e. treat 8-bit bytes as 8859-1 characters.
1626
1627 We may also be able to use "UTF8_STRING" in text.encoding
1628 in the future which can encode all Unicode characters.
1629 But, for the moment, there's no way to know that the
1630 current window manager supports it or not. */
1631 text.value = x_encode_text (name, coding_system, 0, &bytes, &stringp,
1632 &do_free_text_value);
1633 text.encoding = (stringp ? XA_STRING
1634 : FRAME_X_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
1635 text.format = 8;
1636 text.nitems = bytes;
1637
1638 if (NILP (f->icon_name))
1639 {
1640 icon = text;
1641 }
1642 else
1643 {
1644 /* See the above comment "Note: Encoding strategy". */
1645 icon.value = x_encode_text (f->icon_name, coding_system, 0,
1646 &bytes, &stringp, &do_free_icon_value);
1647 icon.encoding = (stringp ? XA_STRING
1648 : FRAME_X_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
1649 icon.format = 8;
1650 icon.nitems = bytes;
1651 }
1652
1653 #ifdef USE_GTK
1654 gtk_window_set_title (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)),
1655 (char *) SDATA (ENCODE_UTF_8 (name)));
1656 #else /* not USE_GTK */
1657 XSetWMName (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &text);
1658 #endif /* not USE_GTK */
1659
1660 XSetWMIconName (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &icon);
1661
1662 if (do_free_icon_value)
1663 xfree (icon.value);
1664 if (do_free_text_value)
1665 xfree (text.value);
1666 }
1667 #else /* not HAVE_X11R4 */
1668 XSetIconName (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1669 SDATA (name));
1670 XStoreName (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1671 SDATA (name));
1672 #endif /* not HAVE_X11R4 */
1673 UNBLOCK_INPUT;
1674 }
1675 }
1676
1677 /* Change the name of frame F to NAME. If NAME is nil, set F's name to
1678 x_id_name.
1679
1680 If EXPLICIT is non-zero, that indicates that lisp code is setting the
1681 name; if NAME is a string, set F's name to NAME and set
1682 F->explicit_name; if NAME is Qnil, then clear F->explicit_name.
1683
1684 If EXPLICIT is zero, that indicates that Emacs redisplay code is
1685 suggesting a new name, which lisp code should override; if
1686 F->explicit_name is set, ignore the new name; otherwise, set it. */
1687
1688 void
1689 x_set_name (f, name, explicit)
1690 struct frame *f;
1691 Lisp_Object name;
1692 int explicit;
1693 {
1694 /* Make sure that requests from lisp code override requests from
1695 Emacs redisplay code. */
1696 if (explicit)
1697 {
1698 /* If we're switching from explicit to implicit, we had better
1699 update the mode lines and thereby update the title. */
1700 if (f->explicit_name && NILP (name))
1701 update_mode_lines = 1;
1702
1703 f->explicit_name = ! NILP (name);
1704 }
1705 else if (f->explicit_name)
1706 return;
1707
1708 /* If NAME is nil, set the name to the x_id_name. */
1709 if (NILP (name))
1710 {
1711 /* Check for no change needed in this very common case
1712 before we do any consing. */
1713 if (!strcmp (FRAME_X_DISPLAY_INFO (f)->x_id_name,
1714 SDATA (f->name)))
1715 return;
1716 name = build_string (FRAME_X_DISPLAY_INFO (f)->x_id_name);
1717 }
1718 else
1719 CHECK_STRING (name);
1720
1721 /* Don't change the name if it's already NAME. */
1722 if (! NILP (Fstring_equal (name, f->name)))
1723 return;
1724
1725 f->name = name;
1726
1727 /* For setting the frame title, the title parameter should override
1728 the name parameter. */
1729 if (! NILP (f->title))
1730 name = f->title;
1731
1732 x_set_name_internal (f, name);
1733 }
1734
1735 /* This function should be called when the user's lisp code has
1736 specified a name for the frame; the name will override any set by the
1737 redisplay code. */
1738 void
1739 x_explicitly_set_name (f, arg, oldval)
1740 FRAME_PTR f;
1741 Lisp_Object arg, oldval;
1742 {
1743 x_set_name (f, arg, 1);
1744 }
1745
1746 /* This function should be called by Emacs redisplay code to set the
1747 name; names set this way will never override names set by the user's
1748 lisp code. */
1749 void
1750 x_implicitly_set_name (f, arg, oldval)
1751 FRAME_PTR f;
1752 Lisp_Object arg, oldval;
1753 {
1754 x_set_name (f, arg, 0);
1755 }
1756 \f
1757 /* Change the title of frame F to NAME.
1758 If NAME is nil, use the frame name as the title.
1759
1760 If EXPLICIT is non-zero, that indicates that lisp code is setting the
1761 name; if NAME is a string, set F's name to NAME and set
1762 F->explicit_name; if NAME is Qnil, then clear F->explicit_name.
1763
1764 If EXPLICIT is zero, that indicates that Emacs redisplay code is
1765 suggesting a new name, which lisp code should override; if
1766 F->explicit_name is set, ignore the new name; otherwise, set it. */
1767
1768 void
1769 x_set_title (f, name, old_name)
1770 struct frame *f;
1771 Lisp_Object name, old_name;
1772 {
1773 /* Don't change the title if it's already NAME. */
1774 if (EQ (name, f->title))
1775 return;
1776
1777 update_mode_lines = 1;
1778
1779 f->title = name;
1780
1781 if (NILP (name))
1782 name = f->name;
1783 else
1784 CHECK_STRING (name);
1785
1786 x_set_name_internal (f, name);
1787 }
1788
1789 void
1790 x_set_scroll_bar_default_width (f)
1791 struct frame *f;
1792 {
1793 int wid = FRAME_COLUMN_WIDTH (f);
1794
1795 #ifdef USE_TOOLKIT_SCROLL_BARS
1796 /* A minimum width of 14 doesn't look good for toolkit scroll bars. */
1797 int width = 16 + 2 * VERTICAL_SCROLL_BAR_WIDTH_TRIM;
1798 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (width + wid - 1) / wid;
1799 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = width;
1800 #else
1801 /* Make the actual width at least 14 pixels and a multiple of a
1802 character width. */
1803 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (14 + wid - 1) / wid;
1804
1805 /* Use all of that space (aside from required margins) for the
1806 scroll bar. */
1807 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = 0;
1808 #endif
1809 }
1810
1811 \f
1812 /* Record in frame F the specified or default value according to ALIST
1813 of the parameter named PROP (a Lisp symbol). If no value is
1814 specified for PROP, look for an X default for XPROP on the frame
1815 named NAME. If that is not found either, use the value DEFLT. */
1816
1817 static Lisp_Object
1818 x_default_scroll_bar_color_parameter (f, alist, prop, xprop, xclass,
1819 foreground_p)
1820 struct frame *f;
1821 Lisp_Object alist;
1822 Lisp_Object prop;
1823 char *xprop;
1824 char *xclass;
1825 int foreground_p;
1826 {
1827 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
1828 Lisp_Object tem;
1829
1830 tem = x_get_arg (dpyinfo, alist, prop, xprop, xclass, RES_TYPE_STRING);
1831 if (EQ (tem, Qunbound))
1832 {
1833 #ifdef USE_TOOLKIT_SCROLL_BARS
1834
1835 /* See if an X resource for the scroll bar color has been
1836 specified. */
1837 tem = display_x_get_resource (dpyinfo,
1838 build_string (foreground_p
1839 ? "foreground"
1840 : "background"),
1841 empty_string,
1842 build_string ("verticalScrollBar"),
1843 empty_string);
1844 if (!STRINGP (tem))
1845 {
1846 /* If nothing has been specified, scroll bars will use a
1847 toolkit-dependent default. Because these defaults are
1848 difficult to get at without actually creating a scroll
1849 bar, use nil to indicate that no color has been
1850 specified. */
1851 tem = Qnil;
1852 }
1853
1854 #else /* not USE_TOOLKIT_SCROLL_BARS */
1855
1856 tem = Qnil;
1857
1858 #endif /* not USE_TOOLKIT_SCROLL_BARS */
1859 }
1860
1861 x_set_frame_parameters (f, Fcons (Fcons (prop, tem), Qnil));
1862 return tem;
1863 }
1864
1865
1866
1867 #if !defined (HAVE_X11R4) && !defined (HAVE_XSETWMPROTOCOLS)
1868
1869 Status
1870 XSetWMProtocols (dpy, w, protocols, count)
1871 Display *dpy;
1872 Window w;
1873 Atom *protocols;
1874 int count;
1875 {
1876 Atom prop;
1877 prop = XInternAtom (dpy, "WM_PROTOCOLS", False);
1878 if (prop == None) return False;
1879 XChangeProperty (dpy, w, prop, XA_ATOM, 32, PropModeReplace,
1880 (unsigned char *) protocols, count);
1881 return True;
1882 }
1883 #endif /* not HAVE_X11R4 && not HAVE_XSETWMPROTOCOLS */
1884 \f
1885 #ifdef USE_X_TOOLKIT
1886
1887 /* If the WM_PROTOCOLS property does not already contain WM_TAKE_FOCUS,
1888 WM_DELETE_WINDOW, and WM_SAVE_YOURSELF, then add them. (They may
1889 already be present because of the toolkit (Motif adds some of them,
1890 for example, but Xt doesn't). */
1891
1892 static void
1893 hack_wm_protocols (f, widget)
1894 FRAME_PTR f;
1895 Widget widget;
1896 {
1897 Display *dpy = XtDisplay (widget);
1898 Window w = XtWindow (widget);
1899 int need_delete = 1;
1900 int need_focus = 1;
1901 int need_save = 1;
1902
1903 BLOCK_INPUT;
1904 {
1905 Atom type;
1906 unsigned char *catoms;
1907 int format = 0;
1908 unsigned long nitems = 0;
1909 unsigned long bytes_after;
1910
1911 if ((XGetWindowProperty (dpy, w,
1912 FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
1913 (long)0, (long)100, False, XA_ATOM,
1914 &type, &format, &nitems, &bytes_after,
1915 &catoms)
1916 == Success)
1917 && format == 32 && type == XA_ATOM)
1918 {
1919 Atom *atoms = (Atom *) catoms;
1920 while (nitems > 0)
1921 {
1922 nitems--;
1923 if (atoms[nitems]
1924 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window)
1925 need_delete = 0;
1926 else if (atoms[nitems]
1927 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_take_focus)
1928 need_focus = 0;
1929 else if (atoms[nitems]
1930 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself)
1931 need_save = 0;
1932 }
1933 }
1934 if (catoms)
1935 XFree (catoms);
1936 }
1937 {
1938 Atom props [10];
1939 int count = 0;
1940 if (need_delete)
1941 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window;
1942 if (need_focus)
1943 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_take_focus;
1944 if (need_save)
1945 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself;
1946 if (count)
1947 XChangeProperty (dpy, w, FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
1948 XA_ATOM, 32, PropModeAppend,
1949 (unsigned char *) props, count);
1950 }
1951 UNBLOCK_INPUT;
1952 }
1953 #endif
1954
1955
1956 \f
1957 /* Support routines for XIC (X Input Context). */
1958
1959 #ifdef HAVE_X_I18N
1960
1961 static XFontSet xic_create_xfontset P_ ((struct frame *, char *));
1962 static XIMStyle best_xim_style P_ ((XIMStyles *, XIMStyles *));
1963
1964
1965 /* Supported XIM styles, ordered by preference. */
1966
1967 static XIMStyle supported_xim_styles[] =
1968 {
1969 XIMPreeditPosition | XIMStatusArea,
1970 XIMPreeditPosition | XIMStatusNothing,
1971 XIMPreeditPosition | XIMStatusNone,
1972 XIMPreeditNothing | XIMStatusArea,
1973 XIMPreeditNothing | XIMStatusNothing,
1974 XIMPreeditNothing | XIMStatusNone,
1975 XIMPreeditNone | XIMStatusArea,
1976 XIMPreeditNone | XIMStatusNothing,
1977 XIMPreeditNone | XIMStatusNone,
1978 0,
1979 };
1980
1981
1982 /* Create an X fontset on frame F with base font name BASE_FONTNAME. */
1983
1984 char xic_defaut_fontset[] = "-*-*-*-r-normal--14-*-*-*-*-*-*-*";
1985
1986 /* Create an Xt fontset spec from the name of a base font.
1987 If `motif' is True use the Motif syntax. */
1988 char *
1989 xic_create_fontsetname (base_fontname, motif)
1990 char *base_fontname;
1991 Bool motif;
1992 {
1993 const char *sep = motif ? ";" : ",";
1994 char *fontsetname;
1995
1996 /* Make a fontset name from the base font name. */
1997 if (xic_defaut_fontset == base_fontname)
1998 { /* There is no base font name, use the default. */
1999 int len = strlen (base_fontname) + 2;
2000 fontsetname = xmalloc (len);
2001 bzero (fontsetname, len);
2002 strcpy (fontsetname, base_fontname);
2003 }
2004 else
2005 {
2006 /* Make a fontset name from the base font name.
2007 The font set will be made of the following elements:
2008 - the base font.
2009 - the base font where the charset spec is replaced by -*-*.
2010 - the same but with the family also replaced with -*-*-. */
2011 char *p = base_fontname;
2012 int i;
2013
2014 for (i = 0; *p; p++)
2015 if (*p == '-') i++;
2016 if (i != 14)
2017 { /* As the font name doesn't conform to XLFD, we can't
2018 modify it to generalize it to allcs and allfamilies.
2019 Use the specified font plus the default. */
2020 int len = strlen (base_fontname) + strlen (xic_defaut_fontset) + 3;
2021 fontsetname = xmalloc (len);
2022 bzero (fontsetname, len);
2023 strcpy (fontsetname, base_fontname);
2024 strcat (fontsetname, sep);
2025 strcat (fontsetname, xic_defaut_fontset);
2026 }
2027 else
2028 {
2029 int len;
2030 char *p1 = NULL, *p2 = NULL;
2031 char *font_allcs = NULL;
2032 char *font_allfamilies = NULL;
2033 char *font_all = NULL;
2034 char *allcs = "*-*-*-*-*-*-*";
2035 char *allfamilies = "-*-*-";
2036 char *all = "*-*-*-*-";
2037
2038 for (i = 0, p = base_fontname; i < 8; p++)
2039 {
2040 if (*p == '-')
2041 {
2042 i++;
2043 if (i == 3)
2044 p1 = p + 1;
2045 else if (i == 7)
2046 p2 = p + 1;
2047 }
2048 }
2049 /* Build the font spec that matches all charsets. */
2050 len = p - base_fontname + strlen (allcs) + 1;
2051 font_allcs = (char *) alloca (len);
2052 bzero (font_allcs, len);
2053 bcopy (base_fontname, font_allcs, p - base_fontname);
2054 strcat (font_allcs, allcs);
2055
2056 /* Build the font spec that matches all families. */
2057 len = p - p1 + strlen (allcs) + strlen (allfamilies) + 1;
2058 font_allfamilies = (char *) alloca (len);
2059 bzero (font_allfamilies, len);
2060 strcpy (font_allfamilies, allfamilies);
2061 bcopy (p1, font_allfamilies + strlen (allfamilies), p - p1);
2062 strcat (font_allfamilies, allcs);
2063
2064 /* Build the font spec that matches all. */
2065 len = p - p2 + strlen (allcs) + strlen (all) + strlen (allfamilies) + 1;
2066 font_all = (char *) alloca (len);
2067 bzero (font_all, len);
2068 strcpy (font_all, allfamilies);
2069 strcat (font_all, all);
2070 bcopy (p2, font_all + strlen (all) + strlen (allfamilies), p - p2);
2071 strcat (font_all, allcs);
2072
2073 /* Build the actual font set name. */
2074 len = strlen (base_fontname) + strlen (font_allcs)
2075 + strlen (font_allfamilies) + strlen (font_all) + 5;
2076 fontsetname = xmalloc (len);
2077 bzero (fontsetname, len);
2078 strcpy (fontsetname, base_fontname);
2079 strcat (fontsetname, sep);
2080 strcat (fontsetname, font_allcs);
2081 strcat (fontsetname, sep);
2082 strcat (fontsetname, font_allfamilies);
2083 strcat (fontsetname, sep);
2084 strcat (fontsetname, font_all);
2085 }
2086 }
2087 if (motif)
2088 strcat (fontsetname, ":");
2089 return fontsetname;
2090 }
2091
2092 static XFontSet
2093 xic_create_xfontset (f, base_fontname)
2094 struct frame *f;
2095 char *base_fontname;
2096 {
2097 XFontSet xfs = NULL;
2098 char **missing_list = NULL;
2099 int missing_count;
2100 char *def_string;
2101 Lisp_Object rest, frame;
2102
2103 if (!base_fontname)
2104 base_fontname = xic_defaut_fontset;
2105
2106 /* See if there is another frame already using same fontset. */
2107 FOR_EACH_FRAME (rest, frame)
2108 {
2109 struct frame *cf = XFRAME (frame);
2110 if (cf != f && FRAME_LIVE_P (f) && FRAME_X_P (cf)
2111 && FRAME_X_DISPLAY_INFO (cf) == FRAME_X_DISPLAY_INFO (f)
2112 && FRAME_XIC_BASE_FONTNAME (cf)
2113 && !strcmp (FRAME_XIC_BASE_FONTNAME (cf), base_fontname))
2114 {
2115 xfs = FRAME_XIC_FONTSET (cf);
2116 break;
2117 }
2118 }
2119
2120 if (!xfs)
2121 {
2122 char *fontsetname = xic_create_fontsetname (base_fontname, False);
2123
2124 /* New fontset. */
2125 xfs = XCreateFontSet (FRAME_X_DISPLAY (f),
2126 fontsetname, &missing_list,
2127 &missing_count, &def_string);
2128 if (missing_list)
2129 XFreeStringList (missing_list);
2130 xfree (fontsetname);
2131 }
2132
2133 if (FRAME_XIC_BASE_FONTNAME (f))
2134 xfree (FRAME_XIC_BASE_FONTNAME (f));
2135 FRAME_XIC_BASE_FONTNAME (f) = xstrdup (base_fontname);
2136
2137 /* No need to free def_string. */
2138 return xfs;
2139 }
2140
2141 /* Free the X fontset of frame F if it is the last frame using it. */
2142
2143 void
2144 xic_free_xfontset (f)
2145 struct frame *f;
2146 {
2147 Lisp_Object rest, frame;
2148 int shared_p = 0;
2149
2150 if (!FRAME_XIC_FONTSET (f))
2151 return;
2152
2153 /* See if there is another frame sharing the same fontset. */
2154 FOR_EACH_FRAME (rest, frame)
2155 {
2156 struct frame *cf = XFRAME (frame);
2157 if (cf != f && FRAME_LIVE_P (f) && FRAME_X_P (cf)
2158 && FRAME_X_DISPLAY_INFO (cf) == FRAME_X_DISPLAY_INFO (f)
2159 && FRAME_XIC_FONTSET (cf) == FRAME_XIC_FONTSET (f))
2160 {
2161 shared_p = 1;
2162 break;
2163 }
2164 }
2165
2166 if (!shared_p)
2167 /* The fontset is not used anymore. It is safe to free it. */
2168 XFreeFontSet (FRAME_X_DISPLAY (f), FRAME_XIC_FONTSET (f));
2169
2170 if (FRAME_XIC_BASE_FONTNAME (f))
2171 xfree (FRAME_XIC_BASE_FONTNAME (f));
2172 FRAME_XIC_BASE_FONTNAME (f) = NULL;
2173 FRAME_XIC_FONTSET (f) = NULL;
2174 }
2175
2176
2177 /* Value is the best input style, given user preferences USER (already
2178 checked to be supported by Emacs), and styles supported by the
2179 input method XIM. */
2180
2181 static XIMStyle
2182 best_xim_style (user, xim)
2183 XIMStyles *user;
2184 XIMStyles *xim;
2185 {
2186 int i, j;
2187
2188 for (i = 0; i < user->count_styles; ++i)
2189 for (j = 0; j < xim->count_styles; ++j)
2190 if (user->supported_styles[i] == xim->supported_styles[j])
2191 return user->supported_styles[i];
2192
2193 /* Return the default style. */
2194 return XIMPreeditNothing | XIMStatusNothing;
2195 }
2196
2197 /* Create XIC for frame F. */
2198
2199 static XIMStyle xic_style;
2200
2201 void
2202 create_frame_xic (f)
2203 struct frame *f;
2204 {
2205 XIM xim;
2206 XIC xic = NULL;
2207 XFontSet xfs = NULL;
2208
2209 if (FRAME_XIC (f))
2210 return;
2211
2212 /* Create X fontset. */
2213 xfs = xic_create_xfontset
2214 (f, (FRAME_FONTSET (f) < 0) ? NULL
2215 : (char *) SDATA (fontset_ascii (FRAME_FONTSET (f))));
2216
2217 xim = FRAME_X_XIM (f);
2218 if (xim)
2219 {
2220 XRectangle s_area;
2221 XPoint spot;
2222 XVaNestedList preedit_attr;
2223 XVaNestedList status_attr;
2224
2225 s_area.x = 0; s_area.y = 0; s_area.width = 1; s_area.height = 1;
2226 spot.x = 0; spot.y = 1;
2227
2228 /* Determine XIC style. */
2229 if (xic_style == 0)
2230 {
2231 XIMStyles supported_list;
2232 supported_list.count_styles = (sizeof supported_xim_styles
2233 / sizeof supported_xim_styles[0]);
2234 supported_list.supported_styles = supported_xim_styles;
2235 xic_style = best_xim_style (&supported_list,
2236 FRAME_X_XIM_STYLES (f));
2237 }
2238
2239 preedit_attr = XVaCreateNestedList (0,
2240 XNFontSet, xfs,
2241 XNForeground,
2242 FRAME_FOREGROUND_PIXEL (f),
2243 XNBackground,
2244 FRAME_BACKGROUND_PIXEL (f),
2245 (xic_style & XIMPreeditPosition
2246 ? XNSpotLocation
2247 : NULL),
2248 &spot,
2249 NULL);
2250 status_attr = XVaCreateNestedList (0,
2251 XNArea,
2252 &s_area,
2253 XNFontSet,
2254 xfs,
2255 XNForeground,
2256 FRAME_FOREGROUND_PIXEL (f),
2257 XNBackground,
2258 FRAME_BACKGROUND_PIXEL (f),
2259 NULL);
2260
2261 xic = XCreateIC (xim,
2262 XNInputStyle, xic_style,
2263 XNClientWindow, FRAME_X_WINDOW (f),
2264 XNFocusWindow, FRAME_X_WINDOW (f),
2265 XNStatusAttributes, status_attr,
2266 XNPreeditAttributes, preedit_attr,
2267 NULL);
2268 XFree (preedit_attr);
2269 XFree (status_attr);
2270 }
2271
2272 FRAME_XIC (f) = xic;
2273 FRAME_XIC_STYLE (f) = xic_style;
2274 FRAME_XIC_FONTSET (f) = xfs;
2275 }
2276
2277
2278 /* Destroy XIC and free XIC fontset of frame F, if any. */
2279
2280 void
2281 free_frame_xic (f)
2282 struct frame *f;
2283 {
2284 if (FRAME_XIC (f) == NULL)
2285 return;
2286
2287 XDestroyIC (FRAME_XIC (f));
2288 xic_free_xfontset (f);
2289
2290 FRAME_XIC (f) = NULL;
2291 }
2292
2293
2294 /* Place preedit area for XIC of window W's frame to specified
2295 pixel position X/Y. X and Y are relative to window W. */
2296
2297 void
2298 xic_set_preeditarea (w, x, y)
2299 struct window *w;
2300 int x, y;
2301 {
2302 struct frame *f = XFRAME (w->frame);
2303 XVaNestedList attr;
2304 XPoint spot;
2305
2306 spot.x = WINDOW_TO_FRAME_PIXEL_X (w, x) + WINDOW_LEFT_FRINGE_WIDTH (w);
2307 spot.y = WINDOW_TO_FRAME_PIXEL_Y (w, y) + FONT_BASE (FRAME_FONT (f));
2308 attr = XVaCreateNestedList (0, XNSpotLocation, &spot, NULL);
2309 XSetICValues (FRAME_XIC (f), XNPreeditAttributes, attr, NULL);
2310 XFree (attr);
2311 }
2312
2313
2314 /* Place status area for XIC in bottom right corner of frame F.. */
2315
2316 void
2317 xic_set_statusarea (f)
2318 struct frame *f;
2319 {
2320 XIC xic = FRAME_XIC (f);
2321 XVaNestedList attr;
2322 XRectangle area;
2323 XRectangle *needed;
2324
2325 /* Negotiate geometry of status area. If input method has existing
2326 status area, use its current size. */
2327 area.x = area.y = area.width = area.height = 0;
2328 attr = XVaCreateNestedList (0, XNAreaNeeded, &area, NULL);
2329 XSetICValues (xic, XNStatusAttributes, attr, NULL);
2330 XFree (attr);
2331
2332 attr = XVaCreateNestedList (0, XNAreaNeeded, &needed, NULL);
2333 XGetICValues (xic, XNStatusAttributes, attr, NULL);
2334 XFree (attr);
2335
2336 if (needed->width == 0) /* Use XNArea instead of XNAreaNeeded */
2337 {
2338 attr = XVaCreateNestedList (0, XNArea, &needed, NULL);
2339 XGetICValues (xic, XNStatusAttributes, attr, NULL);
2340 XFree (attr);
2341 }
2342
2343 area.width = needed->width;
2344 area.height = needed->height;
2345 area.x = FRAME_PIXEL_WIDTH (f) - area.width - FRAME_INTERNAL_BORDER_WIDTH (f);
2346 area.y = (FRAME_PIXEL_HEIGHT (f) - area.height
2347 - FRAME_MENUBAR_HEIGHT (f)
2348 - FRAME_TOOLBAR_HEIGHT (f)
2349 - FRAME_INTERNAL_BORDER_WIDTH (f));
2350 XFree (needed);
2351
2352 attr = XVaCreateNestedList (0, XNArea, &area, NULL);
2353 XSetICValues (xic, XNStatusAttributes, attr, NULL);
2354 XFree (attr);
2355 }
2356
2357
2358 /* Set X fontset for XIC of frame F, using base font name
2359 BASE_FONTNAME. Called when a new Emacs fontset is chosen. */
2360
2361 void
2362 xic_set_xfontset (f, base_fontname)
2363 struct frame *f;
2364 char *base_fontname;
2365 {
2366 XVaNestedList attr;
2367 XFontSet xfs;
2368
2369 xic_free_xfontset (f);
2370
2371 xfs = xic_create_xfontset (f, base_fontname);
2372
2373 attr = XVaCreateNestedList (0, XNFontSet, xfs, NULL);
2374 if (FRAME_XIC_STYLE (f) & XIMPreeditPosition)
2375 XSetICValues (FRAME_XIC (f), XNPreeditAttributes, attr, NULL);
2376 if (FRAME_XIC_STYLE (f) & XIMStatusArea)
2377 XSetICValues (FRAME_XIC (f), XNStatusAttributes, attr, NULL);
2378 XFree (attr);
2379
2380 FRAME_XIC_FONTSET (f) = xfs;
2381 }
2382
2383 #endif /* HAVE_X_I18N */
2384
2385
2386 \f
2387 #ifdef USE_X_TOOLKIT
2388
2389 /* Create and set up the X widget for frame F. */
2390
2391 static void
2392 x_window (f, window_prompting, minibuffer_only)
2393 struct frame *f;
2394 long window_prompting;
2395 int minibuffer_only;
2396 {
2397 XClassHint class_hints;
2398 XSetWindowAttributes attributes;
2399 unsigned long attribute_mask;
2400 Widget shell_widget;
2401 Widget pane_widget;
2402 Widget frame_widget;
2403 Arg al [25];
2404 int ac;
2405
2406 BLOCK_INPUT;
2407
2408 /* Use the resource name as the top-level widget name
2409 for looking up resources. Make a non-Lisp copy
2410 for the window manager, so GC relocation won't bother it.
2411
2412 Elsewhere we specify the window name for the window manager. */
2413
2414 {
2415 char *str = (char *) SDATA (Vx_resource_name);
2416 f->namebuf = (char *) xmalloc (strlen (str) + 1);
2417 strcpy (f->namebuf, str);
2418 }
2419
2420 ac = 0;
2421 XtSetArg (al[ac], XtNallowShellResize, 1); ac++;
2422 XtSetArg (al[ac], XtNinput, 1); ac++;
2423 XtSetArg (al[ac], XtNmappedWhenManaged, 0); ac++;
2424 XtSetArg (al[ac], XtNborderWidth, f->border_width); ac++;
2425 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2426 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2427 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2428 shell_widget = XtAppCreateShell (f->namebuf, EMACS_CLASS,
2429 applicationShellWidgetClass,
2430 FRAME_X_DISPLAY (f), al, ac);
2431
2432 f->output_data.x->widget = shell_widget;
2433 /* maybe_set_screen_title_format (shell_widget); */
2434
2435 pane_widget = lw_create_widget ("main", "pane", widget_id_tick++,
2436 (widget_value *) NULL,
2437 shell_widget, False,
2438 (lw_callback) NULL,
2439 (lw_callback) NULL,
2440 (lw_callback) NULL,
2441 (lw_callback) NULL);
2442
2443 ac = 0;
2444 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2445 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2446 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2447 XtSetValues (pane_widget, al, ac);
2448 f->output_data.x->column_widget = pane_widget;
2449
2450 /* mappedWhenManaged to false tells to the paned window to not map/unmap
2451 the emacs screen when changing menubar. This reduces flickering. */
2452
2453 ac = 0;
2454 XtSetArg (al[ac], XtNmappedWhenManaged, 0); ac++;
2455 XtSetArg (al[ac], XtNshowGrip, 0); ac++;
2456 XtSetArg (al[ac], XtNallowResize, 1); ac++;
2457 XtSetArg (al[ac], XtNresizeToPreferred, 1); ac++;
2458 XtSetArg (al[ac], XtNemacsFrame, f); ac++;
2459 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2460 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2461 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2462 frame_widget = XtCreateWidget (f->namebuf, emacsFrameClass, pane_widget,
2463 al, ac);
2464
2465 f->output_data.x->edit_widget = frame_widget;
2466
2467 XtManageChild (frame_widget);
2468
2469 /* Do some needed geometry management. */
2470 {
2471 int len;
2472 char *tem, shell_position[32];
2473 Arg al[10];
2474 int ac = 0;
2475 int extra_borders = 0;
2476 int menubar_size
2477 = (f->output_data.x->menubar_widget
2478 ? (f->output_data.x->menubar_widget->core.height
2479 + f->output_data.x->menubar_widget->core.border_width)
2480 : 0);
2481
2482 #if 0 /* Experimentally, we now get the right results
2483 for -geometry -0-0 without this. 24 Aug 96, rms. */
2484 if (FRAME_EXTERNAL_MENU_BAR (f))
2485 {
2486 Dimension ibw = 0;
2487 XtVaGetValues (pane_widget, XtNinternalBorderWidth, &ibw, NULL);
2488 menubar_size += ibw;
2489 }
2490 #endif
2491
2492 f->output_data.x->menubar_height = menubar_size;
2493
2494 #ifndef USE_LUCID
2495 /* Motif seems to need this amount added to the sizes
2496 specified for the shell widget. The Athena/Lucid widgets don't.
2497 Both conclusions reached experimentally. -- rms. */
2498 XtVaGetValues (f->output_data.x->edit_widget, XtNinternalBorderWidth,
2499 &extra_borders, NULL);
2500 extra_borders *= 2;
2501 #endif
2502
2503 /* Convert our geometry parameters into a geometry string
2504 and specify it.
2505 Note that we do not specify here whether the position
2506 is a user-specified or program-specified one.
2507 We pass that information later, in x_wm_set_size_hints. */
2508 {
2509 int left = f->left_pos;
2510 int xneg = window_prompting & XNegative;
2511 int top = f->top_pos;
2512 int yneg = window_prompting & YNegative;
2513 if (xneg)
2514 left = -left;
2515 if (yneg)
2516 top = -top;
2517
2518 if (window_prompting & USPosition)
2519 sprintf (shell_position, "=%dx%d%c%d%c%d",
2520 FRAME_PIXEL_WIDTH (f) + extra_borders,
2521 FRAME_PIXEL_HEIGHT (f) + menubar_size + extra_borders,
2522 (xneg ? '-' : '+'), left,
2523 (yneg ? '-' : '+'), top);
2524 else
2525 {
2526 sprintf (shell_position, "=%dx%d",
2527 FRAME_PIXEL_WIDTH (f) + extra_borders,
2528 FRAME_PIXEL_HEIGHT (f) + menubar_size + extra_borders);
2529
2530 /* Setting x and y when the position is not specified in
2531 the geometry string will set program position in the WM hints.
2532 If Emacs had just one program position, we could set it in
2533 fallback resources, but since each make-frame call can specify
2534 different program positions, this is easier. */
2535 XtSetArg (al[ac], XtNx, left); ac++;
2536 XtSetArg (al[ac], XtNy, top); ac++;
2537 }
2538 }
2539
2540 len = strlen (shell_position) + 1;
2541 /* We don't free this because we don't know whether
2542 it is safe to free it while the frame exists.
2543 It isn't worth the trouble of arranging to free it
2544 when the frame is deleted. */
2545 tem = (char *) xmalloc (len);
2546 strncpy (tem, shell_position, len);
2547 XtSetArg (al[ac], XtNgeometry, tem); ac++;
2548 XtSetValues (shell_widget, al, ac);
2549 }
2550
2551 XtManageChild (pane_widget);
2552 XtRealizeWidget (shell_widget);
2553
2554 FRAME_X_WINDOW (f) = XtWindow (frame_widget);
2555
2556 validate_x_resource_name ();
2557
2558 class_hints.res_name = (char *) SDATA (Vx_resource_name);
2559 class_hints.res_class = (char *) SDATA (Vx_resource_class);
2560 XSetClassHint (FRAME_X_DISPLAY (f), XtWindow (shell_widget), &class_hints);
2561
2562 #ifdef HAVE_X_I18N
2563 FRAME_XIC (f) = NULL;
2564 if (use_xim)
2565 create_frame_xic (f);
2566 #endif
2567
2568 f->output_data.x->wm_hints.input = True;
2569 f->output_data.x->wm_hints.flags |= InputHint;
2570 XSetWMHints (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2571 &f->output_data.x->wm_hints);
2572
2573 hack_wm_protocols (f, shell_widget);
2574
2575 #ifdef HACK_EDITRES
2576 XtAddEventHandler (shell_widget, 0, True, _XEditResCheckMessages, 0);
2577 #endif
2578
2579 /* Do a stupid property change to force the server to generate a
2580 PropertyNotify event so that the event_stream server timestamp will
2581 be initialized to something relevant to the time we created the window.
2582 */
2583 XChangeProperty (XtDisplay (frame_widget), XtWindow (frame_widget),
2584 FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
2585 XA_ATOM, 32, PropModeAppend,
2586 (unsigned char*) NULL, 0);
2587
2588 /* Make all the standard events reach the Emacs frame. */
2589 attributes.event_mask = STANDARD_EVENT_SET;
2590
2591 #ifdef HAVE_X_I18N
2592 if (FRAME_XIC (f))
2593 {
2594 /* XIM server might require some X events. */
2595 unsigned long fevent = NoEventMask;
2596 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2597 attributes.event_mask |= fevent;
2598 }
2599 #endif /* HAVE_X_I18N */
2600
2601 attribute_mask = CWEventMask;
2602 XChangeWindowAttributes (XtDisplay (shell_widget), XtWindow (shell_widget),
2603 attribute_mask, &attributes);
2604
2605 XtMapWidget (frame_widget);
2606
2607 /* x_set_name normally ignores requests to set the name if the
2608 requested name is the same as the current name. This is the one
2609 place where that assumption isn't correct; f->name is set, but
2610 the X server hasn't been told. */
2611 {
2612 Lisp_Object name;
2613 int explicit = f->explicit_name;
2614
2615 f->explicit_name = 0;
2616 name = f->name;
2617 f->name = Qnil;
2618 x_set_name (f, name, explicit);
2619 }
2620
2621 XDefineCursor (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2622 f->output_data.x->text_cursor);
2623
2624 UNBLOCK_INPUT;
2625
2626 /* This is a no-op, except under Motif. Make sure main areas are
2627 set to something reasonable, in case we get an error later. */
2628 lw_set_main_areas (pane_widget, 0, frame_widget);
2629 }
2630
2631 #else /* not USE_X_TOOLKIT */
2632 #ifdef USE_GTK
2633 void
2634 x_window (f)
2635 FRAME_PTR f;
2636 {
2637 if (! xg_create_frame_widgets (f))
2638 error ("Unable to create window");
2639
2640 #ifdef HAVE_X_I18N
2641 FRAME_XIC (f) = NULL;
2642 if (use_xim)
2643 {
2644 BLOCK_INPUT;
2645 create_frame_xic (f);
2646 if (FRAME_XIC (f))
2647 {
2648 /* XIM server might require some X events. */
2649 unsigned long fevent = NoEventMask;
2650 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2651
2652 if (fevent != NoEventMask)
2653 {
2654 XSetWindowAttributes attributes;
2655 XWindowAttributes wattr;
2656 unsigned long attribute_mask;
2657
2658 XGetWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2659 &wattr);
2660 attributes.event_mask = wattr.your_event_mask | fevent;
2661 attribute_mask = CWEventMask;
2662 XChangeWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2663 attribute_mask, &attributes);
2664 }
2665 }
2666 UNBLOCK_INPUT;
2667 }
2668 #endif
2669 }
2670
2671 #else /*! USE_GTK */
2672 /* Create and set up the X window for frame F. */
2673
2674 void
2675 x_window (f)
2676 struct frame *f;
2677
2678 {
2679 XClassHint class_hints;
2680 XSetWindowAttributes attributes;
2681 unsigned long attribute_mask;
2682
2683 attributes.background_pixel = FRAME_BACKGROUND_PIXEL (f);
2684 attributes.border_pixel = f->output_data.x->border_pixel;
2685 attributes.bit_gravity = StaticGravity;
2686 attributes.backing_store = NotUseful;
2687 attributes.save_under = True;
2688 attributes.event_mask = STANDARD_EVENT_SET;
2689 attributes.colormap = FRAME_X_COLORMAP (f);
2690 attribute_mask = (CWBackPixel | CWBorderPixel | CWBitGravity | CWEventMask
2691 | CWColormap);
2692
2693 BLOCK_INPUT;
2694 FRAME_X_WINDOW (f)
2695 = XCreateWindow (FRAME_X_DISPLAY (f),
2696 f->output_data.x->parent_desc,
2697 f->left_pos,
2698 f->top_pos,
2699 FRAME_PIXEL_WIDTH (f), FRAME_PIXEL_HEIGHT (f),
2700 f->border_width,
2701 CopyFromParent, /* depth */
2702 InputOutput, /* class */
2703 FRAME_X_VISUAL (f),
2704 attribute_mask, &attributes);
2705
2706 #ifdef HAVE_X_I18N
2707 if (use_xim)
2708 {
2709 create_frame_xic (f);
2710 if (FRAME_XIC (f))
2711 {
2712 /* XIM server might require some X events. */
2713 unsigned long fevent = NoEventMask;
2714 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2715 attributes.event_mask |= fevent;
2716 attribute_mask = CWEventMask;
2717 XChangeWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2718 attribute_mask, &attributes);
2719 }
2720 }
2721 #endif /* HAVE_X_I18N */
2722
2723 validate_x_resource_name ();
2724
2725 class_hints.res_name = (char *) SDATA (Vx_resource_name);
2726 class_hints.res_class = (char *) SDATA (Vx_resource_class);
2727 XSetClassHint (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), &class_hints);
2728
2729 /* The menubar is part of the ordinary display;
2730 it does not count in addition to the height of the window. */
2731 f->output_data.x->menubar_height = 0;
2732
2733 /* This indicates that we use the "Passive Input" input model.
2734 Unless we do this, we don't get the Focus{In,Out} events that we
2735 need to draw the cursor correctly. Accursed bureaucrats.
2736 XWhipsAndChains (FRAME_X_DISPLAY (f), IronMaiden, &TheRack); */
2737
2738 f->output_data.x->wm_hints.input = True;
2739 f->output_data.x->wm_hints.flags |= InputHint;
2740 XSetWMHints (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2741 &f->output_data.x->wm_hints);
2742 f->output_data.x->wm_hints.icon_pixmap = None;
2743
2744 /* Request "save yourself" and "delete window" commands from wm. */
2745 {
2746 Atom protocols[2];
2747 protocols[0] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window;
2748 protocols[1] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself;
2749 XSetWMProtocols (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), protocols, 2);
2750 }
2751
2752 /* x_set_name normally ignores requests to set the name if the
2753 requested name is the same as the current name. This is the one
2754 place where that assumption isn't correct; f->name is set, but
2755 the X server hasn't been told. */
2756 {
2757 Lisp_Object name;
2758 int explicit = f->explicit_name;
2759
2760 f->explicit_name = 0;
2761 name = f->name;
2762 f->name = Qnil;
2763 x_set_name (f, name, explicit);
2764 }
2765
2766 XDefineCursor (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2767 f->output_data.x->text_cursor);
2768
2769 UNBLOCK_INPUT;
2770
2771 if (FRAME_X_WINDOW (f) == 0)
2772 error ("Unable to create window");
2773 }
2774
2775 #endif /* not USE_GTK */
2776 #endif /* not USE_X_TOOLKIT */
2777
2778 /* Verify that the icon position args for this window are valid. */
2779
2780 static void
2781 x_icon_verify (f, parms)
2782 struct frame *f;
2783 Lisp_Object parms;
2784 {
2785 Lisp_Object icon_x, icon_y;
2786
2787 /* Set the position of the icon. Note that twm groups all
2788 icons in an icon window. */
2789 icon_x = x_frame_get_and_record_arg (f, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
2790 icon_y = x_frame_get_and_record_arg (f, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
2791 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
2792 {
2793 CHECK_NUMBER (icon_x);
2794 CHECK_NUMBER (icon_y);
2795 }
2796 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
2797 error ("Both left and top icon corners of icon must be specified");
2798 }
2799
2800 /* Handle the icon stuff for this window. Perhaps later we might
2801 want an x_set_icon_position which can be called interactively as
2802 well. */
2803
2804 static void
2805 x_icon (f, parms)
2806 struct frame *f;
2807 Lisp_Object parms;
2808 {
2809 Lisp_Object icon_x, icon_y;
2810 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
2811
2812 /* Set the position of the icon. Note that twm groups all
2813 icons in an icon window. */
2814 icon_x = x_frame_get_and_record_arg (f, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
2815 icon_y = x_frame_get_and_record_arg (f, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
2816 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
2817 {
2818 CHECK_NUMBER (icon_x);
2819 CHECK_NUMBER (icon_y);
2820 }
2821 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
2822 error ("Both left and top icon corners of icon must be specified");
2823
2824 BLOCK_INPUT;
2825
2826 if (! EQ (icon_x, Qunbound))
2827 x_wm_set_icon_position (f, XINT (icon_x), XINT (icon_y));
2828
2829 #if 0 /* x_get_arg removes the visibility parameter as a side effect,
2830 but x_create_frame still needs it. */
2831 /* Start up iconic or window? */
2832 x_wm_set_window_state
2833 (f, (EQ (x_get_arg (dpyinfo, parms, Qvisibility, 0, 0, RES_TYPE_SYMBOL),
2834 Qicon)
2835 ? IconicState
2836 : NormalState));
2837 #endif
2838
2839 x_text_icon (f, (char *) SDATA ((!NILP (f->icon_name)
2840 ? f->icon_name
2841 : f->name)));
2842
2843 UNBLOCK_INPUT;
2844 }
2845
2846 /* Make the GCs needed for this window, setting the
2847 background, border and mouse colors; also create the
2848 mouse cursor and the gray border tile. */
2849
2850 static char cursor_bits[] =
2851 {
2852 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
2853 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
2854 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
2855 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00
2856 };
2857
2858 static void
2859 x_make_gc (f)
2860 struct frame *f;
2861 {
2862 XGCValues gc_values;
2863
2864 BLOCK_INPUT;
2865
2866 /* Create the GCs of this frame.
2867 Note that many default values are used. */
2868
2869 /* Normal video */
2870 gc_values.font = FRAME_FONT (f)->fid;
2871 gc_values.foreground = FRAME_FOREGROUND_PIXEL (f);
2872 gc_values.background = FRAME_BACKGROUND_PIXEL (f);
2873 gc_values.line_width = 0; /* Means 1 using fast algorithm. */
2874 f->output_data.x->normal_gc
2875 = XCreateGC (FRAME_X_DISPLAY (f),
2876 FRAME_X_WINDOW (f),
2877 GCLineWidth | GCFont | GCForeground | GCBackground,
2878 &gc_values);
2879
2880 /* Reverse video style. */
2881 gc_values.foreground = FRAME_BACKGROUND_PIXEL (f);
2882 gc_values.background = FRAME_FOREGROUND_PIXEL (f);
2883 f->output_data.x->reverse_gc
2884 = XCreateGC (FRAME_X_DISPLAY (f),
2885 FRAME_X_WINDOW (f),
2886 GCFont | GCForeground | GCBackground | GCLineWidth,
2887 &gc_values);
2888
2889 /* Cursor has cursor-color background, background-color foreground. */
2890 gc_values.foreground = FRAME_BACKGROUND_PIXEL (f);
2891 gc_values.background = f->output_data.x->cursor_pixel;
2892 gc_values.fill_style = FillOpaqueStippled;
2893 gc_values.stipple
2894 = XCreateBitmapFromData (FRAME_X_DISPLAY (f),
2895 FRAME_X_DISPLAY_INFO (f)->root_window,
2896 cursor_bits, 16, 16);
2897 f->output_data.x->cursor_gc
2898 = XCreateGC (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2899 (GCFont | GCForeground | GCBackground
2900 | GCFillStyle /* | GCStipple */ | GCLineWidth),
2901 &gc_values);
2902
2903 /* Reliefs. */
2904 f->output_data.x->white_relief.gc = 0;
2905 f->output_data.x->black_relief.gc = 0;
2906
2907 /* Create the gray border tile used when the pointer is not in
2908 the frame. Since this depends on the frame's pixel values,
2909 this must be done on a per-frame basis. */
2910 f->output_data.x->border_tile
2911 = (XCreatePixmapFromBitmapData
2912 (FRAME_X_DISPLAY (f), FRAME_X_DISPLAY_INFO (f)->root_window,
2913 gray_bits, gray_width, gray_height,
2914 FRAME_FOREGROUND_PIXEL (f),
2915 FRAME_BACKGROUND_PIXEL (f),
2916 DefaultDepth (FRAME_X_DISPLAY (f), FRAME_X_SCREEN_NUMBER (f))));
2917
2918 UNBLOCK_INPUT;
2919 }
2920
2921
2922 /* Free what was was allocated in x_make_gc. */
2923
2924 void
2925 x_free_gcs (f)
2926 struct frame *f;
2927 {
2928 Display *dpy = FRAME_X_DISPLAY (f);
2929
2930 BLOCK_INPUT;
2931
2932 if (f->output_data.x->normal_gc)
2933 {
2934 XFreeGC (dpy, f->output_data.x->normal_gc);
2935 f->output_data.x->normal_gc = 0;
2936 }
2937
2938 if (f->output_data.x->reverse_gc)
2939 {
2940 XFreeGC (dpy, f->output_data.x->reverse_gc);
2941 f->output_data.x->reverse_gc = 0;
2942 }
2943
2944 if (f->output_data.x->cursor_gc)
2945 {
2946 XFreeGC (dpy, f->output_data.x->cursor_gc);
2947 f->output_data.x->cursor_gc = 0;
2948 }
2949
2950 if (f->output_data.x->border_tile)
2951 {
2952 XFreePixmap (dpy, f->output_data.x->border_tile);
2953 f->output_data.x->border_tile = 0;
2954 }
2955
2956 UNBLOCK_INPUT;
2957 }
2958
2959
2960 /* Handler for signals raised during x_create_frame and
2961 x_create_top_frame. FRAME is the frame which is partially
2962 constructed. */
2963
2964 static Lisp_Object
2965 unwind_create_frame (frame)
2966 Lisp_Object frame;
2967 {
2968 struct frame *f = XFRAME (frame);
2969
2970 /* If frame is already dead, nothing to do. This can happen if the
2971 display is disconnected after the frame has become official, but
2972 before x_create_frame removes the unwind protect. */
2973 if (!FRAME_LIVE_P (f))
2974 return Qnil;
2975
2976 /* If frame is ``official'', nothing to do. */
2977 if (!CONSP (Vframe_list) || !EQ (XCAR (Vframe_list), frame))
2978 {
2979 #if GLYPH_DEBUG
2980 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
2981 #endif
2982
2983 x_free_frame_resources (f);
2984
2985 #if GLYPH_DEBUG
2986 /* Check that reference counts are indeed correct. */
2987 xassert (dpyinfo->reference_count == dpyinfo_refcount);
2988 xassert (dpyinfo->image_cache->refcount == image_cache_refcount);
2989 #endif
2990 return Qt;
2991 }
2992
2993 return Qnil;
2994 }
2995
2996
2997 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
2998 1, 1, 0,
2999 doc: /* Make a new X window, which is called a "frame" in Emacs terms.
3000 Returns an Emacs frame object.
3001 ALIST is an alist of frame parameters.
3002 If the parameters specify that the frame should not have a minibuffer,
3003 and do not specify a specific minibuffer window to use,
3004 then `default-minibuffer-frame' must be a frame whose minibuffer can
3005 be shared by the new frame.
3006
3007 This function is an internal primitive--use `make-frame' instead. */)
3008 (parms)
3009 Lisp_Object parms;
3010 {
3011 struct frame *f;
3012 Lisp_Object frame, tem;
3013 Lisp_Object name;
3014 int minibuffer_only = 0;
3015 long window_prompting = 0;
3016 int width, height;
3017 int count = SPECPDL_INDEX ();
3018 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
3019 Lisp_Object display;
3020 struct x_display_info *dpyinfo = NULL;
3021 Lisp_Object parent;
3022 struct kboard *kb;
3023
3024 parms = Fcopy_alist (parms);
3025
3026 /* Use this general default value to start with
3027 until we know if this frame has a specified name. */
3028 Vx_resource_name = Vinvocation_name;
3029
3030 display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_NUMBER);
3031 if (EQ (display, Qunbound))
3032 display = x_get_arg (dpyinfo, parms, Qdisplay, 0, 0, RES_TYPE_STRING);
3033 if (EQ (display, Qunbound))
3034 display = Qnil;
3035 dpyinfo = check_x_display_info (display);
3036 #ifdef MULTI_KBOARD
3037 kb = dpyinfo->terminal->kboard;
3038 #else
3039 kb = &the_only_kboard;
3040 #endif
3041
3042 name = x_get_arg (dpyinfo, parms, Qname, "name", "Name", RES_TYPE_STRING);
3043 if (!STRINGP (name)
3044 && ! EQ (name, Qunbound)
3045 && ! NILP (name))
3046 error ("Invalid frame name--not a string or nil");
3047
3048 if (STRINGP (name))
3049 Vx_resource_name = name;
3050
3051 /* See if parent window is specified. */
3052 parent = x_get_arg (dpyinfo, parms, Qparent_id, NULL, NULL, RES_TYPE_NUMBER);
3053 if (EQ (parent, Qunbound))
3054 parent = Qnil;
3055 if (! NILP (parent))
3056 CHECK_NUMBER (parent);
3057
3058 /* make_frame_without_minibuffer can run Lisp code and garbage collect. */
3059 /* No need to protect DISPLAY because that's not used after passing
3060 it to make_frame_without_minibuffer. */
3061 frame = Qnil;
3062 GCPRO4 (parms, parent, name, frame);
3063 tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
3064 RES_TYPE_SYMBOL);
3065 if (EQ (tem, Qnone) || NILP (tem))
3066 f = make_frame_without_minibuffer (Qnil, kb, display);
3067 else if (EQ (tem, Qonly))
3068 {
3069 f = make_minibuffer_frame ();
3070 minibuffer_only = 1;
3071 }
3072 else if (WINDOWP (tem))
3073 f = make_frame_without_minibuffer (tem, kb, display);
3074 else
3075 f = make_frame (1);
3076
3077 XSETFRAME (frame, f);
3078
3079 /* Note that X Windows does support scroll bars. */
3080 FRAME_CAN_HAVE_SCROLL_BARS (f) = 1;
3081
3082 f->terminal = dpyinfo->terminal;
3083 f->terminal->reference_count++;
3084
3085 f->output_method = output_x_window;
3086 f->output_data.x = (struct x_output *) xmalloc (sizeof (struct x_output));
3087 bzero (f->output_data.x, sizeof (struct x_output));
3088 f->output_data.x->icon_bitmap = -1;
3089 FRAME_FONTSET (f) = -1;
3090 f->output_data.x->scroll_bar_foreground_pixel = -1;
3091 f->output_data.x->scroll_bar_background_pixel = -1;
3092 #ifdef USE_TOOLKIT_SCROLL_BARS
3093 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
3094 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
3095 #endif /* USE_TOOLKIT_SCROLL_BARS */
3096 record_unwind_protect (unwind_create_frame, frame);
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 #if GLYPH_DEBUG
3106 image_cache_refcount = FRAME_X_IMAGE_CACHE (f)->refcount;
3107 dpyinfo_refcount = dpyinfo->reference_count;
3108 #endif /* GLYPH_DEBUG */
3109
3110 /* These colors will be set anyway later, but it's important
3111 to get the color reference counts right, so initialize them! */
3112 {
3113 Lisp_Object black;
3114 struct gcpro gcpro1;
3115
3116 /* Function x_decode_color can signal an error. Make
3117 sure to initialize color slots so that we won't try
3118 to free colors we haven't allocated. */
3119 FRAME_FOREGROUND_PIXEL (f) = -1;
3120 FRAME_BACKGROUND_PIXEL (f) = -1;
3121 f->output_data.x->cursor_pixel = -1;
3122 f->output_data.x->cursor_foreground_pixel = -1;
3123 f->output_data.x->border_pixel = -1;
3124 f->output_data.x->mouse_pixel = -1;
3125
3126 black = build_string ("black");
3127 GCPRO1 (black);
3128 FRAME_FOREGROUND_PIXEL (f)
3129 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3130 FRAME_BACKGROUND_PIXEL (f)
3131 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3132 f->output_data.x->cursor_pixel
3133 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3134 f->output_data.x->cursor_foreground_pixel
3135 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3136 f->output_data.x->border_pixel
3137 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3138 f->output_data.x->mouse_pixel
3139 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3140 UNGCPRO;
3141 }
3142
3143 /* Specify the parent under which to make this X window. */
3144
3145 if (!NILP (parent))
3146 {
3147 f->output_data.x->parent_desc = (Window) XFASTINT (parent);
3148 f->output_data.x->explicit_parent = 1;
3149 }
3150 else
3151 {
3152 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
3153 f->output_data.x->explicit_parent = 0;
3154 }
3155
3156 /* Set the name; the functions to which we pass f expect the name to
3157 be set. */
3158 if (EQ (name, Qunbound) || NILP (name))
3159 {
3160 f->name = build_string (dpyinfo->x_id_name);
3161 f->explicit_name = 0;
3162 }
3163 else
3164 {
3165 f->name = name;
3166 f->explicit_name = 1;
3167 /* use the frame's title when getting resources for this frame. */
3168 specbind (Qx_resource_name, name);
3169 }
3170
3171 /* Extract the window parameters from the supplied values
3172 that are needed to determine window geometry. */
3173 {
3174 Lisp_Object font;
3175
3176 font = x_get_arg (dpyinfo, parms, Qfont, "font", "Font", RES_TYPE_STRING);
3177
3178 BLOCK_INPUT;
3179 /* First, try whatever font the caller has specified. */
3180 if (STRINGP (font))
3181 {
3182 tem = Fquery_fontset (font, Qnil);
3183 if (STRINGP (tem))
3184 font = x_new_fontset (f, SDATA (tem));
3185 else
3186 font = x_new_font (f, SDATA (font));
3187 }
3188
3189 /* Try out a font which we hope has bold and italic variations. */
3190 if (!STRINGP (font))
3191 font = x_new_font (f, "-adobe-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-1");
3192 if (!STRINGP (font))
3193 font = x_new_font (f, "-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-1");
3194 if (! STRINGP (font))
3195 font = x_new_font (f, "-*-*-medium-r-normal-*-*-140-*-*-c-*-iso8859-1");
3196 if (! STRINGP (font))
3197 /* This was formerly the first thing tried, but it finds too many fonts
3198 and takes too long. */
3199 font = x_new_font (f, "-*-*-medium-r-*-*-*-*-*-*-c-*-iso8859-1");
3200 /* If those didn't work, look for something which will at least work. */
3201 if (! STRINGP (font))
3202 font = x_new_font (f, "-*-fixed-*-*-*-*-*-140-*-*-c-*-iso8859-1");
3203 UNBLOCK_INPUT;
3204 if (! STRINGP (font))
3205 font = build_string ("fixed");
3206
3207 x_default_parameter (f, parms, Qfont, font,
3208 "font", "Font", RES_TYPE_STRING);
3209 }
3210
3211 #ifdef USE_LUCID
3212 /* Prevent lwlib/xlwmenu.c from crashing because of a bug
3213 whereby it fails to get any font. */
3214 xlwmenu_default_font = FRAME_FONT (f);
3215 #endif
3216
3217 x_default_parameter (f, parms, Qborder_width, make_number (2),
3218 "borderWidth", "BorderWidth", RES_TYPE_NUMBER);
3219
3220 /* This defaults to 1 in order to match xterm. We recognize either
3221 internalBorderWidth or internalBorder (which is what xterm calls
3222 it). */
3223 if (NILP (Fassq (Qinternal_border_width, parms)))
3224 {
3225 Lisp_Object value;
3226
3227 value = x_get_arg (dpyinfo, parms, Qinternal_border_width,
3228 "internalBorder", "internalBorder", RES_TYPE_NUMBER);
3229 if (! EQ (value, Qunbound))
3230 parms = Fcons (Fcons (Qinternal_border_width, value),
3231 parms);
3232 }
3233 x_default_parameter (f, parms, Qinternal_border_width, make_number (1),
3234 "internalBorderWidth", "internalBorderWidth",
3235 RES_TYPE_NUMBER);
3236 x_default_parameter (f, parms, Qvertical_scroll_bars, Qleft,
3237 "verticalScrollBars", "ScrollBars",
3238 RES_TYPE_SYMBOL);
3239
3240 /* Also do the stuff which must be set before the window exists. */
3241 x_default_parameter (f, parms, Qforeground_color, build_string ("black"),
3242 "foreground", "Foreground", RES_TYPE_STRING);
3243 x_default_parameter (f, parms, Qbackground_color, build_string ("white"),
3244 "background", "Background", RES_TYPE_STRING);
3245 x_default_parameter (f, parms, Qmouse_color, build_string ("black"),
3246 "pointerColor", "Foreground", RES_TYPE_STRING);
3247 x_default_parameter (f, parms, Qcursor_color, build_string ("black"),
3248 "cursorColor", "Foreground", RES_TYPE_STRING);
3249 x_default_parameter (f, parms, Qborder_color, build_string ("black"),
3250 "borderColor", "BorderColor", RES_TYPE_STRING);
3251 x_default_parameter (f, parms, Qscreen_gamma, Qnil,
3252 "screenGamma", "ScreenGamma", RES_TYPE_FLOAT);
3253 x_default_parameter (f, parms, Qline_spacing, Qnil,
3254 "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
3255 x_default_parameter (f, parms, Qleft_fringe, Qnil,
3256 "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
3257 x_default_parameter (f, parms, Qright_fringe, Qnil,
3258 "rightFringe", "RightFringe", RES_TYPE_NUMBER);
3259
3260 x_default_scroll_bar_color_parameter (f, parms, Qscroll_bar_foreground,
3261 "scrollBarForeground",
3262 "ScrollBarForeground", 1);
3263 x_default_scroll_bar_color_parameter (f, parms, Qscroll_bar_background,
3264 "scrollBarBackground",
3265 "ScrollBarBackground", 0);
3266
3267 /* Init faces before x_default_parameter is called for scroll-bar
3268 parameters because that function calls x_set_scroll_bar_width,
3269 which calls change_frame_size, which calls Fset_window_buffer,
3270 which runs hooks, which call Fvertical_motion. At the end, we
3271 end up in init_iterator with a null face cache, which should not
3272 happen. */
3273 init_frame_faces (f);
3274
3275 x_default_parameter (f, parms, Qmenu_bar_lines, make_number (1),
3276 "menuBar", "MenuBar", RES_TYPE_NUMBER);
3277 x_default_parameter (f, parms, Qtool_bar_lines, make_number (1),
3278 "toolBar", "ToolBar", RES_TYPE_NUMBER);
3279 x_default_parameter (f, parms, Qbuffer_predicate, Qnil,
3280 "bufferPredicate", "BufferPredicate",
3281 RES_TYPE_SYMBOL);
3282 x_default_parameter (f, parms, Qtitle, Qnil,
3283 "title", "Title", RES_TYPE_STRING);
3284 x_default_parameter (f, parms, Qwait_for_wm, Qt,
3285 "waitForWM", "WaitForWM", RES_TYPE_BOOLEAN);
3286 x_default_parameter (f, parms, Qfullscreen, Qnil,
3287 "fullscreen", "Fullscreen", RES_TYPE_SYMBOL);
3288
3289 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
3290
3291 /* Compute the size of the X window. */
3292 window_prompting = x_figure_window_size (f, parms, 1);
3293
3294 tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
3295 f->no_split = minibuffer_only || EQ (tem, Qt);
3296
3297 x_icon_verify (f, parms);
3298
3299 /* Create the X widget or window. */
3300 #ifdef USE_X_TOOLKIT
3301 x_window (f, window_prompting, minibuffer_only);
3302 #else
3303 x_window (f);
3304 #endif
3305
3306 x_icon (f, parms);
3307 x_make_gc (f);
3308
3309 /* Now consider the frame official. */
3310 FRAME_X_DISPLAY_INFO (f)->reference_count++;
3311 Vframe_list = Fcons (frame, Vframe_list);
3312
3313 /* We need to do this after creating the X window, so that the
3314 icon-creation functions can say whose icon they're describing. */
3315 x_default_parameter (f, parms, Qicon_type, Qt,
3316 "bitmapIcon", "BitmapIcon", RES_TYPE_SYMBOL);
3317
3318 x_default_parameter (f, parms, Qauto_raise, Qnil,
3319 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
3320 x_default_parameter (f, parms, Qauto_lower, Qnil,
3321 "autoLower", "AutoRaiseLower", RES_TYPE_BOOLEAN);
3322 x_default_parameter (f, parms, Qcursor_type, Qbox,
3323 "cursorType", "CursorType", RES_TYPE_SYMBOL);
3324 x_default_parameter (f, parms, Qscroll_bar_width, Qnil,
3325 "scrollBarWidth", "ScrollBarWidth",
3326 RES_TYPE_NUMBER);
3327
3328 /* Dimensions, especially FRAME_LINES (f), must be done via change_frame_size.
3329 Change will not be effected unless different from the current
3330 FRAME_LINES (f). */
3331 width = FRAME_COLS (f);
3332 height = FRAME_LINES (f);
3333
3334 SET_FRAME_COLS (f, 0);
3335 FRAME_LINES (f) = 0;
3336 change_frame_size (f, height, width, 1, 0, 0);
3337
3338 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
3339 /* Create the menu bar. */
3340 if (!minibuffer_only && FRAME_EXTERNAL_MENU_BAR (f))
3341 {
3342 /* If this signals an error, we haven't set size hints for the
3343 frame and we didn't make it visible. */
3344 initialize_frame_menubar (f);
3345
3346 #ifndef USE_GTK
3347 /* This is a no-op, except under Motif where it arranges the
3348 main window for the widgets on it. */
3349 lw_set_main_areas (f->output_data.x->column_widget,
3350 f->output_data.x->menubar_widget,
3351 f->output_data.x->edit_widget);
3352 #endif /* not USE_GTK */
3353 }
3354 #endif /* USE_X_TOOLKIT || USE_GTK */
3355
3356 /* Tell the server what size and position, etc, we want, and how
3357 badly we want them. This should be done after we have the menu
3358 bar so that its size can be taken into account. */
3359 BLOCK_INPUT;
3360 x_wm_set_size_hint (f, window_prompting, 0);
3361 UNBLOCK_INPUT;
3362
3363 /* Make the window appear on the frame and enable display, unless
3364 the caller says not to. However, with explicit parent, Emacs
3365 cannot control visibility, so don't try. */
3366 if (! f->output_data.x->explicit_parent)
3367 {
3368 Lisp_Object visibility;
3369
3370 visibility = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0,
3371 RES_TYPE_SYMBOL);
3372 if (EQ (visibility, Qunbound))
3373 visibility = Qt;
3374
3375 if (EQ (visibility, Qicon))
3376 x_iconify_frame (f);
3377 else if (! NILP (visibility))
3378 x_make_frame_visible (f);
3379 else
3380 /* Must have been Qnil. */
3381 ;
3382 }
3383
3384 /* Set the WM leader property. GTK does this itself, so this is not
3385 needed when using GTK. */
3386 if (dpyinfo->client_leader_window != 0)
3387 {
3388 BLOCK_INPUT;
3389 XChangeProperty (FRAME_X_DISPLAY (f),
3390 FRAME_OUTER_WINDOW (f),
3391 dpyinfo->Xatom_wm_client_leader,
3392 XA_WINDOW, 32, PropModeReplace,
3393 (unsigned char *) &dpyinfo->client_leader_window, 1);
3394 UNBLOCK_INPUT;
3395 }
3396
3397 /* Initialize `default-minibuffer-frame' in case this is the first
3398 frame on this terminal. */
3399 if (FRAME_HAS_MINIBUF_P (f)
3400 && (!FRAMEP (kb->Vdefault_minibuffer_frame)
3401 || !FRAME_LIVE_P (XFRAME (kb->Vdefault_minibuffer_frame))))
3402 kb->Vdefault_minibuffer_frame = frame;
3403
3404 /* All remaining specified parameters, which have not been "used"
3405 by x_get_arg and friends, now go in the misc. alist of the frame. */
3406 for (tem = parms; !NILP (tem); tem = XCDR (tem))
3407 if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
3408 f->param_alist = Fcons (XCAR (tem), f->param_alist);
3409
3410 store_frame_param (f, Qwindow_system, Qx);
3411
3412 UNGCPRO;
3413
3414 /* Make sure windows on this frame appear in calls to next-window
3415 and similar functions. */
3416 Vwindow_list = Qnil;
3417
3418 return unbind_to (count, frame);
3419 }
3420
3421
3422 /* FRAME is used only to get a handle on the X display. We don't pass the
3423 display info directly because we're called from frame.c, which doesn't
3424 know about that structure. */
3425
3426 Lisp_Object
3427 x_get_focus_frame (frame)
3428 struct frame *frame;
3429 {
3430 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (frame);
3431 Lisp_Object xfocus;
3432 if (! dpyinfo->x_focus_frame)
3433 return Qnil;
3434
3435 XSETFRAME (xfocus, dpyinfo->x_focus_frame);
3436 return xfocus;
3437 }
3438
3439
3440 /* In certain situations, when the window manager follows a
3441 click-to-focus policy, there seems to be no way around calling
3442 XSetInputFocus to give another frame the input focus .
3443
3444 In an ideal world, XSetInputFocus should generally be avoided so
3445 that applications don't interfere with the window manager's focus
3446 policy. But I think it's okay to use when it's clearly done
3447 following a user-command. */
3448
3449 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
3450 doc: /* Set the input focus to FRAME.
3451 FRAME nil means use the selected frame. */)
3452 (frame)
3453 Lisp_Object frame;
3454 {
3455 struct frame *f = check_x_frame (frame);
3456 Display *dpy = FRAME_X_DISPLAY (f);
3457
3458 BLOCK_INPUT;
3459 x_catch_errors (dpy);
3460 XSetInputFocus (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
3461 RevertToParent, CurrentTime);
3462 x_uncatch_errors ();
3463 UNBLOCK_INPUT;
3464
3465 return Qnil;
3466 }
3467
3468 \f
3469 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
3470 doc: /* Internal function called by `color-defined-p', which see. */)
3471 (color, frame)
3472 Lisp_Object color, frame;
3473 {
3474 XColor foo;
3475 FRAME_PTR f = check_x_frame (frame);
3476
3477 CHECK_STRING (color);
3478
3479 if (x_defined_color (f, SDATA (color), &foo, 0))
3480 return Qt;
3481 else
3482 return Qnil;
3483 }
3484
3485 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
3486 doc: /* Internal function called by `color-values', which see. */)
3487 (color, frame)
3488 Lisp_Object color, frame;
3489 {
3490 XColor foo;
3491 FRAME_PTR f = check_x_frame (frame);
3492
3493 CHECK_STRING (color);
3494
3495 if (x_defined_color (f, SDATA (color), &foo, 0))
3496 {
3497 Lisp_Object rgb[3];
3498
3499 rgb[0] = make_number (foo.red);
3500 rgb[1] = make_number (foo.green);
3501 rgb[2] = make_number (foo.blue);
3502 return Flist (3, rgb);
3503 }
3504 else
3505 return Qnil;
3506 }
3507
3508 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
3509 doc: /* Internal function called by `display-color-p', which see. */)
3510 (terminal)
3511 Lisp_Object terminal;
3512 {
3513 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3514
3515 if (dpyinfo->n_planes <= 2)
3516 return Qnil;
3517
3518 switch (dpyinfo->visual->class)
3519 {
3520 case StaticColor:
3521 case PseudoColor:
3522 case TrueColor:
3523 case DirectColor:
3524 return Qt;
3525
3526 default:
3527 return Qnil;
3528 }
3529 }
3530
3531 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p, Sx_display_grayscale_p,
3532 0, 1, 0,
3533 doc: /* Return t if the X display supports shades of gray.
3534 Note that color displays do support shades of gray.
3535 The optional argument TERMINAL specifies which display to ask about.
3536 TERMINAL should be a terminal id, a frame or a display name (a string).
3537 If omitted or nil, that stands for the selected frame's display. */)
3538 (terminal)
3539 Lisp_Object terminal;
3540 {
3541 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3542
3543 if (dpyinfo->n_planes <= 1)
3544 return Qnil;
3545
3546 switch (dpyinfo->visual->class)
3547 {
3548 case StaticColor:
3549 case PseudoColor:
3550 case TrueColor:
3551 case DirectColor:
3552 case StaticGray:
3553 case GrayScale:
3554 return Qt;
3555
3556 default:
3557 return Qnil;
3558 }
3559 }
3560
3561 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
3562 0, 1, 0,
3563 doc: /* Returns the width in pixels of the X display TERMINAL.
3564 The optional argument TERMINAL specifies which display to ask about.
3565 TERMINAL should be a terminal id, a frame or a display name (a string).
3566 If omitted or nil, that stands for the selected frame's display. */)
3567 (terminal)
3568 Lisp_Object terminal;
3569 {
3570 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3571
3572 return make_number (dpyinfo->width);
3573 }
3574
3575 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
3576 Sx_display_pixel_height, 0, 1, 0,
3577 doc: /* Returns the height in pixels of the X display TERMINAL.
3578 The optional argument TERMINAL specifies which display to ask about.
3579 TERMINAL should be a terminal id, a frame or a display name (a string).
3580 If omitted or nil, that stands for the selected frame's display. */)
3581 (terminal)
3582 Lisp_Object terminal;
3583 {
3584 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3585
3586 return make_number (dpyinfo->height);
3587 }
3588
3589 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
3590 0, 1, 0,
3591 doc: /* Returns the number of bitplanes of the X display TERMINAL.
3592 The optional argument TERMINAL specifies which display to ask about.
3593 TERMINAL should be a terminal id, a frame or a display name (a string).
3594 If omitted or nil, that stands for the selected frame's display. */)
3595 (terminal)
3596 Lisp_Object terminal;
3597 {
3598 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3599
3600 return make_number (dpyinfo->n_planes);
3601 }
3602
3603 DEFUN ("x-display-color-cells", Fx_display_color_cells, Sx_display_color_cells,
3604 0, 1, 0,
3605 doc: /* Returns the number of color cells of the X display TERMINAL.
3606 The optional argument TERMINAL specifies which display to ask about.
3607 TERMINAL should be a terminal id, a frame or a display name (a string).
3608 If omitted or nil, that stands for the selected frame's display. */)
3609 (terminal)
3610 Lisp_Object terminal;
3611 {
3612 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3613
3614 int nr_planes = DisplayPlanes (dpyinfo->display,
3615 XScreenNumberOfScreen (dpyinfo->screen));
3616
3617 /* Truncate nr_planes to 24 to avoid integer overflow.
3618 Some displays says 32, but only 24 bits are actually significant.
3619 There are only very few and rare video cards that have more than
3620 24 significant bits. Also 24 bits is more than 16 million colors,
3621 it "should be enough for everyone". */
3622 if (nr_planes > 24) nr_planes = 24;
3623
3624 return make_number (1 << nr_planes);
3625 }
3626
3627 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
3628 Sx_server_max_request_size,
3629 0, 1, 0,
3630 doc: /* Returns the maximum request size of the X server of display TERMINAL.
3631 The optional argument TERMINAL specifies which display to ask about.
3632 TERMINAL should be a terminal id, a frame or a display name (a string).
3633 If omitted or nil, that stands for the selected frame's display. */)
3634 (terminal)
3635 Lisp_Object terminal;
3636 {
3637 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3638
3639 return make_number (MAXREQUEST (dpyinfo->display));
3640 }
3641
3642 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
3643 doc: /* Returns the "vendor ID" string of the X server of display TERMINAL.
3644 \(Labelling every distributor as a "vendor" embodies the false assumption
3645 that operating systems cannot be developed and distributed noncommercially.)
3646 The optional argument TERMINAL specifies which display to ask about.
3647 TERMINAL should be a terminal id, a frame or a display name (a string).
3648 If omitted or nil, that stands for the selected frame's display. */)
3649 (terminal)
3650 Lisp_Object terminal;
3651 {
3652 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3653 char *vendor = ServerVendor (dpyinfo->display);
3654
3655 if (! vendor) vendor = "";
3656 return build_string (vendor);
3657 }
3658
3659 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
3660 doc: /* Returns the version numbers of the X server of display TERMINAL.
3661 The value is a list of three integers: the major and minor
3662 version numbers of the X Protocol in use, and the distributor-specific release
3663 number. See also the function `x-server-vendor'.
3664
3665 The optional argument TERMINAL specifies which display to ask about.
3666 TERMINAL should be a terminal id, a frame or a display name (a string).
3667 If omitted or nil, that stands for the selected frame's display. */)
3668 (terminal)
3669 Lisp_Object terminal;
3670 {
3671 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3672 Display *dpy = dpyinfo->display;
3673
3674 return Fcons (make_number (ProtocolVersion (dpy)),
3675 Fcons (make_number (ProtocolRevision (dpy)),
3676 Fcons (make_number (VendorRelease (dpy)), Qnil)));
3677 }
3678
3679 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
3680 doc: /* Return the number of screens on the X server of display TERMINAL.
3681 The optional argument TERMINAL specifies which display to ask about.
3682 TERMINAL should be a terminal id, a frame or a display name (a string).
3683 If omitted or nil, that stands for the selected frame's display. */)
3684 (terminal)
3685 Lisp_Object terminal;
3686 {
3687 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3688
3689 return make_number (ScreenCount (dpyinfo->display));
3690 }
3691
3692 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height, 0, 1, 0,
3693 doc: /* Return the height in millimeters of the X display TERMINAL.
3694 The optional argument TERMINAL specifies which display to ask about.
3695 TERMINAL should be a terminal id, a frame or a display name (a string).
3696 If omitted or nil, that stands for the selected frame's display. */)
3697 (terminal)
3698 Lisp_Object terminal;
3699 {
3700 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3701
3702 return make_number (HeightMMOfScreen (dpyinfo->screen));
3703 }
3704
3705 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width, 0, 1, 0,
3706 doc: /* Return the width in millimeters of the X display TERMINAL.
3707 The optional argument TERMINAL specifies which display to ask about.
3708 TERMINAL should be a terminal id, a frame or a display name (a string).
3709 If omitted or nil, that stands for the selected frame's display. */)
3710 (terminal)
3711 Lisp_Object terminal;
3712 {
3713 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3714
3715 return make_number (WidthMMOfScreen (dpyinfo->screen));
3716 }
3717
3718 DEFUN ("x-display-backing-store", Fx_display_backing_store,
3719 Sx_display_backing_store, 0, 1, 0,
3720 doc: /* Returns an indication of whether X display TERMINAL does backing store.
3721 The value may be `always', `when-mapped', or `not-useful'.
3722 The optional argument TERMINAL specifies which display to ask about.
3723 TERMINAL should be a terminal id, a frame or a display name (a string).
3724 If omitted or nil, that stands for the selected frame's display. */)
3725 (terminal)
3726 Lisp_Object terminal;
3727 {
3728 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3729 Lisp_Object result;
3730
3731 switch (DoesBackingStore (dpyinfo->screen))
3732 {
3733 case Always:
3734 result = intern ("always");
3735 break;
3736
3737 case WhenMapped:
3738 result = intern ("when-mapped");
3739 break;
3740
3741 case NotUseful:
3742 result = intern ("not-useful");
3743 break;
3744
3745 default:
3746 error ("Strange value for BackingStore parameter of screen");
3747 result = Qnil;
3748 }
3749
3750 return result;
3751 }
3752
3753 DEFUN ("x-display-visual-class", Fx_display_visual_class,
3754 Sx_display_visual_class, 0, 1, 0,
3755 doc: /* Return the visual class of the X display TERMINAL.
3756 The value is one of the symbols `static-gray', `gray-scale',
3757 `static-color', `pseudo-color', `true-color', or `direct-color'.
3758
3759 The optional argument TERMINAL specifies which display to ask about.
3760 TERMINAL should a terminal id, a frame or a display name (a string).
3761 If omitted or nil, that stands for the selected frame's display. */)
3762 (terminal)
3763 Lisp_Object terminal;
3764 {
3765 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3766 Lisp_Object result;
3767
3768 switch (dpyinfo->visual->class)
3769 {
3770 case StaticGray:
3771 result = intern ("static-gray");
3772 break;
3773 case GrayScale:
3774 result = intern ("gray-scale");
3775 break;
3776 case StaticColor:
3777 result = intern ("static-color");
3778 break;
3779 case PseudoColor:
3780 result = intern ("pseudo-color");
3781 break;
3782 case TrueColor:
3783 result = intern ("true-color");
3784 break;
3785 case DirectColor:
3786 result = intern ("direct-color");
3787 break;
3788 default:
3789 error ("Display has an unknown visual class");
3790 result = Qnil;
3791 }
3792
3793 return result;
3794 }
3795
3796 DEFUN ("x-display-save-under", Fx_display_save_under,
3797 Sx_display_save_under, 0, 1, 0,
3798 doc: /* Returns t if the X display TERMINAL supports the save-under feature.
3799 The optional argument TERMINAL specifies which display to ask about.
3800 TERMINAL should be a terminal id, a frame or a display name (a string).
3801 If omitted or nil, that stands for the selected frame's display. */)
3802 (terminal)
3803 Lisp_Object terminal;
3804 {
3805 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3806
3807 if (DoesSaveUnders (dpyinfo->screen) == True)
3808 return Qt;
3809 else
3810 return Qnil;
3811 }
3812 \f
3813 int
3814 x_pixel_width (f)
3815 register struct frame *f;
3816 {
3817 return FRAME_PIXEL_WIDTH (f);
3818 }
3819
3820 int
3821 x_pixel_height (f)
3822 register struct frame *f;
3823 {
3824 return FRAME_PIXEL_HEIGHT (f);
3825 }
3826
3827 int
3828 x_char_width (f)
3829 register struct frame *f;
3830 {
3831 return FRAME_COLUMN_WIDTH (f);
3832 }
3833
3834 int
3835 x_char_height (f)
3836 register struct frame *f;
3837 {
3838 return FRAME_LINE_HEIGHT (f);
3839 }
3840
3841 int
3842 x_screen_planes (f)
3843 register struct frame *f;
3844 {
3845 return FRAME_X_DISPLAY_INFO (f)->n_planes;
3846 }
3847
3848
3849 \f
3850 /************************************************************************
3851 X Displays
3852 ************************************************************************/
3853
3854 \f
3855 /* Mapping visual names to visuals. */
3856
3857 static struct visual_class
3858 {
3859 char *name;
3860 int class;
3861 }
3862 visual_classes[] =
3863 {
3864 {"StaticGray", StaticGray},
3865 {"GrayScale", GrayScale},
3866 {"StaticColor", StaticColor},
3867 {"PseudoColor", PseudoColor},
3868 {"TrueColor", TrueColor},
3869 {"DirectColor", DirectColor},
3870 {NULL, 0}
3871 };
3872
3873
3874 #ifndef HAVE_XSCREENNUMBEROFSCREEN
3875
3876 /* Value is the screen number of screen SCR. This is a substitute for
3877 the X function with the same name when that doesn't exist. */
3878
3879 int
3880 XScreenNumberOfScreen (scr)
3881 register Screen *scr;
3882 {
3883 Display *dpy = scr->display;
3884 int i;
3885
3886 for (i = 0; i < dpy->nscreens; ++i)
3887 if (scr == dpy->screens + i)
3888 break;
3889
3890 return i;
3891 }
3892
3893 #endif /* not HAVE_XSCREENNUMBEROFSCREEN */
3894
3895
3896 /* Select the visual that should be used on display DPYINFO. Set
3897 members of DPYINFO appropriately. Called from x_term_init. */
3898
3899 void
3900 select_visual (dpyinfo)
3901 struct x_display_info *dpyinfo;
3902 {
3903 Display *dpy = dpyinfo->display;
3904 Screen *screen = dpyinfo->screen;
3905 Lisp_Object value;
3906
3907 /* See if a visual is specified. */
3908 value = display_x_get_resource (dpyinfo,
3909 build_string ("visualClass"),
3910 build_string ("VisualClass"),
3911 Qnil, Qnil);
3912 if (STRINGP (value))
3913 {
3914 /* VALUE should be of the form CLASS-DEPTH, where CLASS is one
3915 of `PseudoColor', `TrueColor' etc. and DEPTH is the color
3916 depth, a decimal number. NAME is compared with case ignored. */
3917 char *s = (char *) alloca (SBYTES (value) + 1);
3918 char *dash;
3919 int i, class = -1;
3920 XVisualInfo vinfo;
3921
3922 strcpy (s, SDATA (value));
3923 dash = index (s, '-');
3924 if (dash)
3925 {
3926 dpyinfo->n_planes = atoi (dash + 1);
3927 *dash = '\0';
3928 }
3929 else
3930 /* We won't find a matching visual with depth 0, so that
3931 an error will be printed below. */
3932 dpyinfo->n_planes = 0;
3933
3934 /* Determine the visual class. */
3935 for (i = 0; visual_classes[i].name; ++i)
3936 if (xstricmp (s, visual_classes[i].name) == 0)
3937 {
3938 class = visual_classes[i].class;
3939 break;
3940 }
3941
3942 /* Look up a matching visual for the specified class. */
3943 if (class == -1
3944 || !XMatchVisualInfo (dpy, XScreenNumberOfScreen (screen),
3945 dpyinfo->n_planes, class, &vinfo))
3946 fatal ("Invalid visual specification `%s'", SDATA (value));
3947
3948 dpyinfo->visual = vinfo.visual;
3949 }
3950 else
3951 {
3952 int n_visuals;
3953 XVisualInfo *vinfo, vinfo_template;
3954
3955 dpyinfo->visual = DefaultVisualOfScreen (screen);
3956
3957 #ifdef HAVE_X11R4
3958 vinfo_template.visualid = XVisualIDFromVisual (dpyinfo->visual);
3959 #else
3960 vinfo_template.visualid = dpyinfo->visual->visualid;
3961 #endif
3962 vinfo_template.screen = XScreenNumberOfScreen (screen);
3963 vinfo = XGetVisualInfo (dpy, VisualIDMask | VisualScreenMask,
3964 &vinfo_template, &n_visuals);
3965 if (n_visuals != 1)
3966 fatal ("Can't get proper X visual info");
3967
3968 dpyinfo->n_planes = vinfo->depth;
3969 XFree ((char *) vinfo);
3970 }
3971 }
3972
3973
3974 /* Return the X display structure for the display named NAME.
3975 Open a new connection if necessary. */
3976
3977 struct x_display_info *
3978 x_display_info_for_name (name)
3979 Lisp_Object name;
3980 {
3981 Lisp_Object names;
3982 struct x_display_info *dpyinfo;
3983
3984 CHECK_STRING (name);
3985
3986 #if 0
3987 if (! EQ (Vinitial_window_system, intern ("x")))
3988 error ("Not using X Windows"); /* That doesn't stop us anymore. */
3989 #endif
3990
3991 for (dpyinfo = x_display_list, names = x_display_name_list;
3992 dpyinfo;
3993 dpyinfo = dpyinfo->next, names = XCDR (names))
3994 {
3995 Lisp_Object tem;
3996 tem = Fstring_equal (XCAR (XCAR (names)), name);
3997 if (!NILP (tem))
3998 return dpyinfo;
3999 }
4000
4001 /* Use this general default value to start with. */
4002 Vx_resource_name = Vinvocation_name;
4003
4004 validate_x_resource_name ();
4005
4006 dpyinfo = x_term_init (name, (char *)0,
4007 (char *) SDATA (Vx_resource_name));
4008
4009 if (dpyinfo == 0)
4010 error ("Cannot connect to X server %s", SDATA (name));
4011
4012 x_in_use = 1;
4013 XSETFASTINT (Vwindow_system_version, 11);
4014
4015 return dpyinfo;
4016 }
4017
4018
4019 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
4020 1, 3, 0,
4021 doc: /* Open a connection to an X server.
4022 DISPLAY is the name of the display to connect to.
4023 Optional second arg XRM-STRING is a string of resources in xrdb format.
4024 If the optional third arg MUST-SUCCEED is non-nil,
4025 terminate Emacs if we can't open the connection. */)
4026 (display, xrm_string, must_succeed)
4027 Lisp_Object display, xrm_string, must_succeed;
4028 {
4029 unsigned char *xrm_option;
4030 struct x_display_info *dpyinfo;
4031
4032 CHECK_STRING (display);
4033 if (! NILP (xrm_string))
4034 CHECK_STRING (xrm_string);
4035
4036 #if 0
4037 if (! EQ (Vinitial_window_system, intern ("x")))
4038 error ("Not using X Windows"); /* That doesn't stop us anymore. */
4039 #endif
4040
4041 if (! NILP (xrm_string))
4042 xrm_option = (unsigned char *) SDATA (xrm_string);
4043 else
4044 xrm_option = (unsigned char *) 0;
4045
4046 validate_x_resource_name ();
4047
4048 /* This is what opens the connection and sets x_current_display.
4049 This also initializes many symbols, such as those used for input. */
4050 dpyinfo = x_term_init (display, xrm_option,
4051 (char *) SDATA (Vx_resource_name));
4052
4053 if (dpyinfo == 0)
4054 {
4055 if (!NILP (must_succeed))
4056 fatal ("Cannot connect to X server %s.\n\
4057 Check the DISPLAY environment variable or use `-d'.\n\
4058 Also use the `xauth' program to verify that you have the proper\n\
4059 authorization information needed to connect the X server.\n\
4060 An insecure way to solve the problem may be to use `xhost'.\n",
4061 SDATA (display));
4062 else
4063 error ("Cannot connect to X server %s", SDATA (display));
4064 }
4065
4066 x_in_use = 1;
4067
4068 XSETFASTINT (Vwindow_system_version, 11);
4069 return Qnil;
4070 }
4071
4072 DEFUN ("x-close-connection", Fx_close_connection,
4073 Sx_close_connection, 1, 1, 0,
4074 doc: /* Close the connection to TERMINAL's X server.
4075 For TERMINAL, specify a terminal id, a frame or a display name (a
4076 string). If TERMINAL is nil, that stands for the selected frame's
4077 terminal. */)
4078 (terminal)
4079 Lisp_Object terminal;
4080 {
4081 struct x_display_info *dpyinfo = check_x_display_info (terminal);
4082
4083 if (dpyinfo->reference_count > 0)
4084 error ("Display still has frames on it");
4085
4086 x_delete_terminal (dpyinfo->terminal);
4087
4088 return Qnil;
4089 }
4090
4091 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
4092 doc: /* Return the list of display names that Emacs has connections to. */)
4093 ()
4094 {
4095 Lisp_Object tail, result;
4096
4097 result = Qnil;
4098 for (tail = x_display_name_list; ! NILP (tail); tail = XCDR (tail))
4099 result = Fcons (XCAR (XCAR (tail)), result);
4100
4101 return result;
4102 }
4103
4104 DEFUN ("x-synchronize", Fx_synchronize, Sx_synchronize, 1, 2, 0,
4105 doc: /* If ON is non-nil, report X errors as soon as the erring request is made.
4106 If ON is nil, allow buffering of requests.
4107 Turning on synchronization prohibits the Xlib routines from buffering
4108 requests and seriously degrades performance, but makes debugging much
4109 easier.
4110 The optional second argument TERMINAL specifies which display to act on.
4111 TERMINAL should be a terminal id, a frame or a display name (a string).
4112 If TERMINAL is omitted or nil, that stands for the selected frame's display. */)
4113 (on, terminal)
4114 Lisp_Object terminal, on;
4115 {
4116 struct x_display_info *dpyinfo = check_x_display_info (terminal);
4117
4118 XSynchronize (dpyinfo->display, !EQ (on, Qnil));
4119
4120 return Qnil;
4121 }
4122
4123 /* Wait for responses to all X commands issued so far for frame F. */
4124
4125 void
4126 x_sync (f)
4127 FRAME_PTR f;
4128 {
4129 BLOCK_INPUT;
4130 XSync (FRAME_X_DISPLAY (f), False);
4131 UNBLOCK_INPUT;
4132 }
4133
4134 \f
4135 /***********************************************************************
4136 Window properties
4137 ***********************************************************************/
4138
4139 DEFUN ("x-change-window-property", Fx_change_window_property,
4140 Sx_change_window_property, 2, 6, 0,
4141 doc: /* Change window property PROP to VALUE on the X window of FRAME.
4142 PROP must be a string.
4143 VALUE may be a string or a list of conses, numbers and/or strings.
4144 If an element in the list is a string, it is converted to
4145 an Atom and the value of the Atom is used. If an element is a cons,
4146 it is converted to a 32 bit number where the car is the 16 top bits and the
4147 cdr is the lower 16 bits.
4148 FRAME nil or omitted means use the selected frame.
4149 If TYPE is given and non-nil, it is the name of the type of VALUE.
4150 If TYPE is not given or nil, the type is STRING.
4151 FORMAT gives the size in bits of each element if VALUE is a list.
4152 It must be one of 8, 16 or 32.
4153 If VALUE is a string or FORMAT is nil or not given, FORMAT defaults to 8.
4154 If OUTER_P is non-nil, the property is changed for the outer X window of
4155 FRAME. Default is to change on the edit X window.
4156
4157 Value is VALUE. */)
4158 (prop, value, frame, type, format, outer_p)
4159 Lisp_Object prop, value, frame, type, format, outer_p;
4160 {
4161 struct frame *f = check_x_frame (frame);
4162 Atom prop_atom;
4163 Atom target_type = XA_STRING;
4164 int element_format = 8;
4165 unsigned char *data;
4166 int nelements;
4167 Window w;
4168
4169 CHECK_STRING (prop);
4170
4171 if (! NILP (format))
4172 {
4173 CHECK_NUMBER (format);
4174 element_format = XFASTINT (format);
4175
4176 if (element_format != 8 && element_format != 16
4177 && element_format != 32)
4178 error ("FORMAT must be one of 8, 16 or 32");
4179 }
4180
4181 if (CONSP (value))
4182 {
4183 nelements = x_check_property_data (value);
4184 if (nelements == -1)
4185 error ("Bad data in VALUE, must be number, string or cons");
4186
4187 if (element_format == 8)
4188 data = (unsigned char *) xmalloc (nelements);
4189 else if (element_format == 16)
4190 data = (unsigned char *) xmalloc (nelements*2);
4191 else /* format == 32 */
4192 /* The man page for XChangeProperty:
4193 "If the specified format is 32, the property data must be a
4194 long array."
4195 This applies even if long is more than 64 bits. The X library
4196 converts to 32 bits before sending to the X server. */
4197 data = (unsigned char *) xmalloc (nelements * sizeof(long));
4198
4199 x_fill_property_data (FRAME_X_DISPLAY (f), value, data, element_format);
4200 }
4201 else
4202 {
4203 CHECK_STRING (value);
4204 data = SDATA (value);
4205 nelements = SCHARS (value);
4206 }
4207
4208 BLOCK_INPUT;
4209 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SDATA (prop), False);
4210 if (! NILP (type))
4211 {
4212 CHECK_STRING (type);
4213 target_type = XInternAtom (FRAME_X_DISPLAY (f), SDATA (type), False);
4214 }
4215
4216 if (! NILP (outer_p)) w = FRAME_OUTER_WINDOW (f);
4217 else w = FRAME_X_WINDOW (f);
4218
4219 XChangeProperty (FRAME_X_DISPLAY (f), w,
4220 prop_atom, target_type, element_format, PropModeReplace,
4221 data, nelements);
4222
4223 if (CONSP (value)) xfree (data);
4224
4225 /* Make sure the property is set when we return. */
4226 XFlush (FRAME_X_DISPLAY (f));
4227 UNBLOCK_INPUT;
4228
4229 return value;
4230 }
4231
4232
4233 DEFUN ("x-delete-window-property", Fx_delete_window_property,
4234 Sx_delete_window_property, 1, 2, 0,
4235 doc: /* Remove window property PROP from X window of FRAME.
4236 FRAME nil or omitted means use the selected frame. Value is PROP. */)
4237 (prop, frame)
4238 Lisp_Object prop, frame;
4239 {
4240 struct frame *f = check_x_frame (frame);
4241 Atom prop_atom;
4242
4243 CHECK_STRING (prop);
4244 BLOCK_INPUT;
4245 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SDATA (prop), False);
4246 XDeleteProperty (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), prop_atom);
4247
4248 /* Make sure the property is removed when we return. */
4249 XFlush (FRAME_X_DISPLAY (f));
4250 UNBLOCK_INPUT;
4251
4252 return prop;
4253 }
4254
4255
4256 DEFUN ("x-window-property", Fx_window_property, Sx_window_property,
4257 1, 6, 0,
4258 doc: /* Value is the value of window property PROP on FRAME.
4259 If FRAME is nil or omitted, use the selected frame.
4260 If TYPE is nil or omitted, get the property as a string. Otherwise TYPE
4261 is the name of the Atom that denotes the type expected.
4262 If SOURCE is non-nil, get the property on that window instead of from
4263 FRAME. The number 0 denotes the root window.
4264 If DELETE_P is non-nil, delete the property after retreiving it.
4265 If VECTOR_RET_P is non-nil, don't return a string but a vector of values.
4266
4267 Value is nil if FRAME hasn't a property with name PROP or if PROP has
4268 no value of TYPE. */)
4269 (prop, frame, type, source, delete_p, vector_ret_p)
4270 Lisp_Object prop, frame, type, source, delete_p, vector_ret_p;
4271 {
4272 struct frame *f = check_x_frame (frame);
4273 Atom prop_atom;
4274 int rc;
4275 Lisp_Object prop_value = Qnil;
4276 unsigned char *tmp_data = NULL;
4277 Atom actual_type;
4278 Atom target_type = XA_STRING;
4279 int actual_format;
4280 unsigned long actual_size, bytes_remaining;
4281 Window target_window = FRAME_X_WINDOW (f);
4282 struct gcpro gcpro1;
4283
4284 GCPRO1 (prop_value);
4285 CHECK_STRING (prop);
4286
4287 if (! NILP (source))
4288 {
4289 if (NUMBERP (source))
4290 {
4291 if (FLOATP (source))
4292 target_window = (Window) XFLOAT (source);
4293 else
4294 target_window = XFASTINT (source);
4295
4296 if (target_window == 0)
4297 target_window = FRAME_X_DISPLAY_INFO (f)->root_window;
4298 }
4299 else if (CONSP (source))
4300 target_window = cons_to_long (source);
4301 }
4302
4303 BLOCK_INPUT;
4304 if (STRINGP (type))
4305 {
4306 if (strcmp ("AnyPropertyType", SDATA (type)) == 0)
4307 target_type = AnyPropertyType;
4308 else
4309 target_type = XInternAtom (FRAME_X_DISPLAY (f), SDATA (type), False);
4310 }
4311
4312 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SDATA (prop), False);
4313 rc = XGetWindowProperty (FRAME_X_DISPLAY (f), target_window,
4314 prop_atom, 0, 0, False, target_type,
4315 &actual_type, &actual_format, &actual_size,
4316 &bytes_remaining, &tmp_data);
4317 if (rc == Success)
4318 {
4319 int size = bytes_remaining;
4320
4321 XFree (tmp_data);
4322 tmp_data = NULL;
4323
4324 rc = XGetWindowProperty (FRAME_X_DISPLAY (f), target_window,
4325 prop_atom, 0, bytes_remaining,
4326 ! NILP (delete_p), target_type,
4327 &actual_type, &actual_format,
4328 &actual_size, &bytes_remaining,
4329 &tmp_data);
4330 if (rc == Success && tmp_data)
4331 {
4332 /* The man page for XGetWindowProperty says:
4333 "If the returned format is 32, the returned data is represented
4334 as a long array and should be cast to that type to obtain the
4335 elements."
4336 This applies even if long is more than 32 bits, the X library
4337 converts from 32 bit elements received from the X server to long
4338 and passes the long array to us. Thus, for that case bcopy can not
4339 be used. We convert to a 32 bit type here, because so much code
4340 assume on that.
4341
4342 The bytes and offsets passed to XGetWindowProperty refers to the
4343 property and those are indeed in 32 bit quantities if format is
4344 32. */
4345
4346 if (actual_format == 32 && actual_format < BITS_PER_LONG)
4347 {
4348 unsigned long i;
4349 int *idata = (int *) tmp_data;
4350 long *ldata = (long *) tmp_data;
4351
4352 for (i = 0; i < actual_size; ++i)
4353 idata[i] = (int) ldata[i];
4354 }
4355
4356 if (NILP (vector_ret_p))
4357 prop_value = make_string (tmp_data, size);
4358 else
4359 prop_value = x_property_data_to_lisp (f,
4360 tmp_data,
4361 actual_type,
4362 actual_format,
4363 actual_size);
4364 }
4365
4366 if (tmp_data) XFree (tmp_data);
4367 }
4368
4369 UNBLOCK_INPUT;
4370 UNGCPRO;
4371 return prop_value;
4372 }
4373
4374
4375 \f
4376 /***********************************************************************
4377 Busy cursor
4378 ***********************************************************************/
4379
4380 /* If non-null, an asynchronous timer that, when it expires, displays
4381 an hourglass cursor on all frames. */
4382
4383 static struct atimer *hourglass_atimer;
4384
4385 /* Non-zero means an hourglass cursor is currently shown. */
4386
4387 static int hourglass_shown_p;
4388
4389 /* Number of seconds to wait before displaying an hourglass cursor. */
4390
4391 static Lisp_Object Vhourglass_delay;
4392
4393 /* Default number of seconds to wait before displaying an hourglass
4394 cursor. */
4395
4396 #define DEFAULT_HOURGLASS_DELAY 1
4397
4398 /* Function prototypes. */
4399
4400 static void show_hourglass P_ ((struct atimer *));
4401 static void hide_hourglass P_ ((void));
4402
4403 /* Return non-zero if houglass timer has been started or hourglass is shown. */
4404
4405 int
4406 hourglass_started ()
4407 {
4408 return hourglass_shown_p || hourglass_atimer != NULL;
4409 }
4410
4411
4412 /* Cancel a currently active hourglass timer, and start a new one. */
4413
4414 void
4415 start_hourglass ()
4416 {
4417 EMACS_TIME delay;
4418 int secs, usecs = 0;
4419
4420 cancel_hourglass ();
4421
4422 if (INTEGERP (Vhourglass_delay)
4423 && XINT (Vhourglass_delay) > 0)
4424 secs = XFASTINT (Vhourglass_delay);
4425 else if (FLOATP (Vhourglass_delay)
4426 && XFLOAT_DATA (Vhourglass_delay) > 0)
4427 {
4428 Lisp_Object tem;
4429 tem = Ftruncate (Vhourglass_delay, Qnil);
4430 secs = XFASTINT (tem);
4431 usecs = (XFLOAT_DATA (Vhourglass_delay) - secs) * 1000000;
4432 }
4433 else
4434 secs = DEFAULT_HOURGLASS_DELAY;
4435
4436 EMACS_SET_SECS_USECS (delay, secs, usecs);
4437 hourglass_atimer = start_atimer (ATIMER_RELATIVE, delay,
4438 show_hourglass, NULL);
4439 }
4440
4441
4442 /* Cancel the hourglass cursor timer if active, hide a busy cursor if
4443 shown. */
4444
4445 void
4446 cancel_hourglass ()
4447 {
4448 if (hourglass_atimer)
4449 {
4450 cancel_atimer (hourglass_atimer);
4451 hourglass_atimer = NULL;
4452 }
4453
4454 if (hourglass_shown_p)
4455 hide_hourglass ();
4456 }
4457
4458
4459 /* Timer function of hourglass_atimer. TIMER is equal to
4460 hourglass_atimer.
4461
4462 Display an hourglass pointer on all frames by mapping the frames'
4463 hourglass_window. Set the hourglass_p flag in the frames'
4464 output_data.x structure to indicate that an hourglass cursor is
4465 shown on the frames. */
4466
4467 static void
4468 show_hourglass (timer)
4469 struct atimer *timer;
4470 {
4471 /* The timer implementation will cancel this timer automatically
4472 after this function has run. Set hourglass_atimer to null
4473 so that we know the timer doesn't have to be canceled. */
4474 hourglass_atimer = NULL;
4475
4476 if (!hourglass_shown_p)
4477 {
4478 Lisp_Object rest, frame;
4479
4480 BLOCK_INPUT;
4481
4482 FOR_EACH_FRAME (rest, frame)
4483 {
4484 struct frame *f = XFRAME (frame);
4485
4486 if (FRAME_LIVE_P (f) && FRAME_X_P (f) && FRAME_X_DISPLAY (f))
4487 {
4488 Display *dpy = FRAME_X_DISPLAY (f);
4489
4490 #ifdef USE_X_TOOLKIT
4491 if (f->output_data.x->widget)
4492 #else
4493 if (FRAME_OUTER_WINDOW (f))
4494 #endif
4495 {
4496 f->output_data.x->hourglass_p = 1;
4497
4498 if (!f->output_data.x->hourglass_window)
4499 {
4500 unsigned long mask = CWCursor;
4501 XSetWindowAttributes attrs;
4502 #ifdef USE_GTK
4503 Window parent = FRAME_X_WINDOW (f);
4504 #else
4505 Window parent = FRAME_OUTER_WINDOW (f);
4506 #endif
4507 attrs.cursor = f->output_data.x->hourglass_cursor;
4508
4509 f->output_data.x->hourglass_window
4510 = XCreateWindow (dpy, parent,
4511 0, 0, 32000, 32000, 0, 0,
4512 InputOnly,
4513 CopyFromParent,
4514 mask, &attrs);
4515 }
4516
4517 XMapRaised (dpy, f->output_data.x->hourglass_window);
4518 XFlush (dpy);
4519 }
4520 }
4521 }
4522
4523 hourglass_shown_p = 1;
4524 UNBLOCK_INPUT;
4525 }
4526 }
4527
4528
4529 /* Hide the hourglass pointer on all frames, if it is currently
4530 shown. */
4531
4532 static void
4533 hide_hourglass ()
4534 {
4535 if (hourglass_shown_p)
4536 {
4537 Lisp_Object rest, frame;
4538
4539 BLOCK_INPUT;
4540 FOR_EACH_FRAME (rest, frame)
4541 {
4542 struct frame *f = XFRAME (frame);
4543
4544 if (FRAME_X_P (f)
4545 /* Watch out for newly created frames. */
4546 && f->output_data.x->hourglass_window)
4547 {
4548 XUnmapWindow (FRAME_X_DISPLAY (f),
4549 f->output_data.x->hourglass_window);
4550 /* Sync here because XTread_socket looks at the
4551 hourglass_p flag that is reset to zero below. */
4552 XSync (FRAME_X_DISPLAY (f), False);
4553 f->output_data.x->hourglass_p = 0;
4554 }
4555 }
4556
4557 hourglass_shown_p = 0;
4558 UNBLOCK_INPUT;
4559 }
4560 }
4561
4562
4563 \f
4564 /***********************************************************************
4565 Tool tips
4566 ***********************************************************************/
4567
4568 static Lisp_Object x_create_tip_frame P_ ((struct x_display_info *,
4569 Lisp_Object, Lisp_Object));
4570 static void compute_tip_xy P_ ((struct frame *, Lisp_Object, Lisp_Object,
4571 Lisp_Object, int, int, int *, int *));
4572
4573 /* The frame of a currently visible tooltip. */
4574
4575 Lisp_Object tip_frame;
4576
4577 /* If non-nil, a timer started that hides the last tooltip when it
4578 fires. */
4579
4580 Lisp_Object tip_timer;
4581 Window tip_window;
4582
4583 /* If non-nil, a vector of 3 elements containing the last args
4584 with which x-show-tip was called. See there. */
4585
4586 Lisp_Object last_show_tip_args;
4587
4588 /* Maximum size for tooltips; a cons (COLUMNS . ROWS). */
4589
4590 Lisp_Object Vx_max_tooltip_size;
4591
4592
4593 static Lisp_Object
4594 unwind_create_tip_frame (frame)
4595 Lisp_Object frame;
4596 {
4597 Lisp_Object deleted;
4598
4599 deleted = unwind_create_frame (frame);
4600 if (EQ (deleted, Qt))
4601 {
4602 tip_window = None;
4603 tip_frame = Qnil;
4604 }
4605
4606 return deleted;
4607 }
4608
4609
4610 /* Create a frame for a tooltip on the display described by DPYINFO.
4611 PARMS is a list of frame parameters. TEXT is the string to
4612 display in the tip frame. Value is the frame.
4613
4614 Note that functions called here, esp. x_default_parameter can
4615 signal errors, for instance when a specified color name is
4616 undefined. We have to make sure that we're in a consistent state
4617 when this happens. */
4618
4619 static Lisp_Object
4620 x_create_tip_frame (dpyinfo, parms, text)
4621 struct x_display_info *dpyinfo;
4622 Lisp_Object parms, text;
4623 {
4624 struct frame *f;
4625 Lisp_Object frame, tem;
4626 Lisp_Object name;
4627 long window_prompting = 0;
4628 int width, height;
4629 int count = SPECPDL_INDEX ();
4630 struct gcpro gcpro1, gcpro2, gcpro3;
4631 int face_change_count_before = face_change_count;
4632 Lisp_Object buffer;
4633 struct buffer *old_buffer;
4634
4635 check_x ();
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) */