(bug-reference-map): Bind down-mouse-1 rather than mouse-1.
[emacs.git] / src / xfns.c
blob2bf4afa392c6b73513ce3b1d90444a05285508f1
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, 2007, 2008
4 Free Software Foundation, Inc.
6 This file is part of GNU Emacs.
8 GNU Emacs is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or
11 (at your option) any later version.
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
21 #include <config.h>
22 #include <stdio.h>
23 #include <math.h>
25 #ifdef HAVE_UNISTD_H
26 #include <unistd.h>
27 #endif
29 /* This makes the fields of a Display accessible, in Xlib header files. */
31 #define XLIB_ILLEGAL_ACCESS
33 #include "lisp.h"
34 #include "xterm.h"
35 #include "frame.h"
36 #include "window.h"
37 #include "buffer.h"
38 #include "intervals.h"
39 #include "dispextern.h"
40 #include "keyboard.h"
41 #include "blockinput.h"
42 #include <epaths.h>
43 #include "character.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 #include "font.h"
53 #ifdef HAVE_X_WINDOWS
55 #include <ctype.h>
56 #include <sys/types.h>
57 #include <sys/stat.h>
59 #ifndef VMS
60 #if 1 /* Used to be #ifdef EMACS_BITMAP_FILES, but this should always work. */
61 #include "bitmaps/gray.xbm"
62 #else
63 #include <X11/bitmaps/gray>
64 #endif
65 #else
66 #include "[.bitmaps]gray.xbm"
67 #endif
69 #ifdef USE_GTK
70 #include "gtkutil.h"
71 #endif
73 #ifdef USE_X_TOOLKIT
74 #include <X11/Shell.h>
76 #ifndef USE_MOTIF
77 #ifdef HAVE_XAW3D
78 #include <X11/Xaw3d/Paned.h>
79 #include <X11/Xaw3d/Label.h>
80 #else /* !HAVE_XAW3D */
81 #include <X11/Xaw/Paned.h>
82 #include <X11/Xaw/Label.h>
83 #endif /* HAVE_XAW3D */
84 #endif /* USE_MOTIF */
86 #ifdef USG
87 #undef USG /* ####KLUDGE for Solaris 2.2 and up */
88 #include <X11/Xos.h>
89 #define USG
90 #else
91 #include <X11/Xos.h>
92 #endif
94 #include "widget.h"
96 #include "../lwlib/lwlib.h"
98 #ifdef USE_MOTIF
99 #include <Xm/Xm.h>
100 #include <Xm/DialogS.h>
101 #include <Xm/FileSB.h>
102 #endif
104 /* Do the EDITRES protocol if running X11R5
105 Exception: HP-UX (at least version A.09.05) has X11R5 without EditRes */
107 #if (XtSpecificationRelease >= 5) && !defined(NO_EDITRES)
108 #define HACK_EDITRES
109 extern void _XEditResCheckMessages ();
110 #endif /* R5 + Athena */
112 /* Unique id counter for widgets created by the Lucid Widget Library. */
114 extern LWLIB_ID widget_id_tick;
116 #ifdef USE_LUCID
117 /* This is part of a kludge--see lwlib/xlwmenu.c. */
118 extern XFontStruct *xlwmenu_default_font;
119 #endif
121 extern void free_frame_menubar ();
122 extern double atof ();
124 #ifdef USE_MOTIF
126 /* LessTif/Motif version info. */
128 static Lisp_Object Vmotif_version_string;
130 #endif /* USE_MOTIF */
132 #endif /* USE_X_TOOLKIT */
134 #ifdef USE_GTK
136 /* GTK+ version info */
138 static Lisp_Object Vgtk_version_string;
140 #endif /* USE_GTK */
142 #define MAXREQUEST(dpy) (XMaxRequestSize (dpy))
144 /* The gray bitmap `bitmaps/gray'. This is done because xterm.c uses
145 it, and including `bitmaps/gray' more than once is a problem when
146 config.h defines `static' as an empty replacement string. */
148 int gray_bitmap_width = gray_width;
149 int gray_bitmap_height = gray_height;
150 char *gray_bitmap_bits = gray_bits;
152 /* Non-zero means we're allowed to display an hourglass cursor. */
154 int display_hourglass_p;
156 /* Non-zero means prompt with the old GTK file selection dialog. */
158 int x_gtk_use_old_file_dialog;
160 /* If non-zero, by default show hidden files in the GTK file chooser. */
162 int x_gtk_show_hidden_files;
164 /* If non-zero, don't show additional help text in the GTK file chooser. */
166 int x_gtk_file_dialog_help_text;
168 /* If non-zero, don't collapse to tool bar when it is detached. */
170 int x_gtk_whole_detached_tool_bar;
172 /* The background and shape of the mouse pointer, and shape when not
173 over text or in the modeline. */
175 Lisp_Object Vx_pointer_shape, Vx_nontext_pointer_shape, Vx_mode_pointer_shape;
176 Lisp_Object Vx_hourglass_pointer_shape;
178 /* The shape when over mouse-sensitive text. */
180 Lisp_Object Vx_sensitive_text_pointer_shape;
182 /* If non-nil, the pointer shape to indicate that windows can be
183 dragged horizontally. */
185 Lisp_Object Vx_window_horizontal_drag_shape;
187 /* Color of chars displayed in cursor box. */
189 Lisp_Object Vx_cursor_fore_pixel;
191 /* Nonzero if using X. */
193 static int x_in_use;
195 /* Non nil if no window manager is in use. */
197 Lisp_Object Vx_no_window_manager;
199 /* Regexp matching a font name whose width is the same as `PIXEL_SIZE'. */
201 Lisp_Object Vx_pixel_size_width_font_regexp;
203 Lisp_Object Qnone;
204 Lisp_Object Qsuppress_icon;
205 Lisp_Object Qundefined_color;
206 Lisp_Object Qcompound_text, Qcancel_timer;
207 static Lisp_Object Qfont_param;
209 /* In dispnew.c */
211 extern Lisp_Object Vwindow_system_version;
213 /* The below are defined in frame.c. */
215 #if GLYPH_DEBUG
216 int image_cache_refcount, dpyinfo_refcount;
217 #endif
221 /* Error if we are not connected to X. */
223 void
224 check_x ()
226 if (! x_in_use)
227 error ("X windows are not in use or not initialized");
230 /* Nonzero if we can use mouse menus.
231 You should not call this unless HAVE_MENUS is defined. */
234 have_menus_p ()
236 return x_in_use;
239 /* Extract a frame as a FRAME_PTR, defaulting to the selected frame
240 and checking validity for X. */
242 FRAME_PTR
243 check_x_frame (frame)
244 Lisp_Object frame;
246 FRAME_PTR f;
248 if (NILP (frame))
249 frame = selected_frame;
250 CHECK_LIVE_FRAME (frame);
251 f = XFRAME (frame);
252 if (! FRAME_X_P (f))
253 error ("Non-X frame used");
254 return f;
257 /* Let the user specify an X display with a Lisp object.
258 OBJECT may be nil, a frame or a terminal id.
259 nil stands for the selected frame--or, if that is not an X frame,
260 the first X display on the list. */
262 struct x_display_info *
263 check_x_display_info (object)
264 Lisp_Object object;
266 struct x_display_info *dpyinfo = NULL;
268 if (NILP (object))
270 struct frame *sf = XFRAME (selected_frame);
272 if (FRAME_X_P (sf) && FRAME_LIVE_P (sf))
273 dpyinfo = FRAME_X_DISPLAY_INFO (sf);
274 else if (x_display_list != 0)
275 dpyinfo = x_display_list;
276 else
277 error ("X windows are not in use or not initialized");
279 else if (INTEGERP (object))
281 struct terminal *t = get_terminal (object, 1);
283 if (t->type != output_x_window)
284 error ("Terminal %d is not an X display", XINT (object));
286 dpyinfo = t->display_info.x;
288 else if (STRINGP (object))
289 dpyinfo = x_display_info_for_name (object);
290 else
292 FRAME_PTR f = check_x_frame (object);
293 dpyinfo = FRAME_X_DISPLAY_INFO (f);
296 return dpyinfo;
300 /* Return the Emacs frame-object corresponding to an X window.
301 It could be the frame's main window or an icon window. */
303 /* This function can be called during GC, so use GC_xxx type test macros. */
305 struct frame *
306 x_window_to_frame (dpyinfo, wdesc)
307 struct x_display_info *dpyinfo;
308 int wdesc;
310 Lisp_Object tail, frame;
311 struct frame *f;
313 if (wdesc == None) return 0;
315 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
317 frame = XCAR (tail);
318 if (!FRAMEP (frame))
319 continue;
320 f = XFRAME (frame);
321 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
322 continue;
323 if (f->output_data.x->hourglass_window == wdesc)
324 return f;
325 #ifdef USE_X_TOOLKIT
326 if ((f->output_data.x->edit_widget
327 && XtWindow (f->output_data.x->edit_widget) == wdesc)
328 /* A tooltip frame? */
329 || (!f->output_data.x->edit_widget
330 && FRAME_X_WINDOW (f) == wdesc)
331 || f->output_data.x->icon_desc == wdesc)
332 return f;
333 #else /* not USE_X_TOOLKIT */
334 #ifdef USE_GTK
335 if (f->output_data.x->edit_widget)
337 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
338 struct x_output *x = f->output_data.x;
339 if (gwdesc != 0 && gwdesc == x->edit_widget)
340 return f;
342 #endif /* USE_GTK */
343 if (FRAME_X_WINDOW (f) == wdesc
344 || f->output_data.x->icon_desc == wdesc)
345 return f;
346 #endif /* not USE_X_TOOLKIT */
348 return 0;
351 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
352 /* Like x_window_to_frame but also compares the window with the widget's
353 windows. */
355 struct frame *
356 x_any_window_to_frame (dpyinfo, wdesc)
357 struct x_display_info *dpyinfo;
358 int wdesc;
360 Lisp_Object tail, frame;
361 struct frame *f, *found;
362 struct x_output *x;
364 if (wdesc == None) return NULL;
366 found = NULL;
367 for (tail = Vframe_list; CONSP (tail) && !found; tail = XCDR (tail))
369 frame = XCAR (tail);
370 if (!FRAMEP (frame))
371 continue;
373 f = XFRAME (frame);
374 if (FRAME_X_P (f) && FRAME_X_DISPLAY_INFO (f) == dpyinfo)
376 /* This frame matches if the window is any of its widgets. */
377 x = f->output_data.x;
378 if (x->hourglass_window == wdesc)
379 found = f;
380 else if (x->widget)
382 #ifdef USE_GTK
383 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
384 if (gwdesc != 0
385 && (gwdesc == x->widget
386 || gwdesc == x->edit_widget
387 || gwdesc == x->vbox_widget
388 || gwdesc == x->menubar_widget))
389 found = f;
390 #else
391 if (wdesc == XtWindow (x->widget)
392 || wdesc == XtWindow (x->column_widget)
393 || wdesc == XtWindow (x->edit_widget))
394 found = f;
395 /* Match if the window is this frame's menubar. */
396 else if (lw_window_is_in_menubar (wdesc, x->menubar_widget))
397 found = f;
398 #endif
400 else if (FRAME_X_WINDOW (f) == wdesc)
401 /* A tooltip frame. */
402 found = f;
406 return found;
409 /* Likewise, but exclude the menu bar widget. */
411 struct frame *
412 x_non_menubar_window_to_frame (dpyinfo, wdesc)
413 struct x_display_info *dpyinfo;
414 int wdesc;
416 Lisp_Object tail, frame;
417 struct frame *f;
418 struct x_output *x;
420 if (wdesc == None) return 0;
422 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
424 frame = XCAR (tail);
425 if (!FRAMEP (frame))
426 continue;
427 f = XFRAME (frame);
428 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
429 continue;
430 x = f->output_data.x;
431 /* This frame matches if the window is any of its widgets. */
432 if (x->hourglass_window == wdesc)
433 return f;
434 else if (x->widget)
436 #ifdef USE_GTK
437 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
438 if (gwdesc != 0
439 && (gwdesc == x->widget
440 || gwdesc == x->edit_widget
441 || gwdesc == x->vbox_widget))
442 return f;
443 #else
444 if (wdesc == XtWindow (x->widget)
445 || wdesc == XtWindow (x->column_widget)
446 || wdesc == XtWindow (x->edit_widget))
447 return f;
448 #endif
450 else if (FRAME_X_WINDOW (f) == wdesc)
451 /* A tooltip frame. */
452 return f;
454 return 0;
457 /* Likewise, but consider only the menu bar widget. */
459 struct frame *
460 x_menubar_window_to_frame (dpyinfo, wdesc)
461 struct x_display_info *dpyinfo;
462 int wdesc;
464 Lisp_Object tail, frame;
465 struct frame *f;
466 struct x_output *x;
468 if (wdesc == None) return 0;
470 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
472 frame = XCAR (tail);
473 if (!FRAMEP (frame))
474 continue;
475 f = XFRAME (frame);
476 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
477 continue;
478 x = f->output_data.x;
479 /* Match if the window is this frame's menubar. */
480 #ifdef USE_GTK
481 if (x->menubar_widget)
483 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
484 int found = 0;
486 BLOCK_INPUT;
487 if (gwdesc != 0
488 && (gwdesc == x->menubar_widget
489 || gtk_widget_get_parent (gwdesc) == x->menubar_widget))
490 found = 1;
491 UNBLOCK_INPUT;
492 if (found) return f;
494 #else
495 if (x->menubar_widget
496 && lw_window_is_in_menubar (wdesc, x->menubar_widget))
497 return f;
498 #endif
500 return 0;
503 /* Return the frame whose principal (outermost) window is WDESC.
504 If WDESC is some other (smaller) window, we return 0. */
506 struct frame *
507 x_top_window_to_frame (dpyinfo, wdesc)
508 struct x_display_info *dpyinfo;
509 int wdesc;
511 Lisp_Object tail, frame;
512 struct frame *f;
513 struct x_output *x;
515 if (wdesc == None) return 0;
517 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
519 frame = XCAR (tail);
520 if (!FRAMEP (frame))
521 continue;
522 f = XFRAME (frame);
523 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
524 continue;
525 x = f->output_data.x;
527 if (x->widget)
529 /* This frame matches if the window is its topmost widget. */
530 #ifdef USE_GTK
531 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
532 if (gwdesc == x->widget)
533 return f;
534 #else
535 if (wdesc == XtWindow (x->widget))
536 return f;
537 #if 0 /* I don't know why it did this,
538 but it seems logically wrong,
539 and it causes trouble for MapNotify events. */
540 /* Match if the window is this frame's menubar. */
541 if (x->menubar_widget
542 && wdesc == XtWindow (x->menubar_widget))
543 return f;
544 #endif
545 #endif
547 else if (FRAME_X_WINDOW (f) == wdesc)
548 /* Tooltip frame. */
549 return f;
551 return 0;
553 #endif /* USE_X_TOOLKIT || USE_GTK */
557 static void x_default_font_parameter P_ ((struct frame *, Lisp_Object));
559 static Lisp_Object unwind_create_frame P_ ((Lisp_Object));
560 static Lisp_Object unwind_create_tip_frame P_ ((Lisp_Object));
562 void x_set_foreground_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
563 static void x_set_wait_for_wm P_ ((struct frame *, Lisp_Object, Lisp_Object));
564 void x_set_background_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
565 void x_set_mouse_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
566 void x_set_cursor_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
567 void x_set_border_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
568 void x_set_cursor_type P_ ((struct frame *, Lisp_Object, Lisp_Object));
569 void x_set_icon_type P_ ((struct frame *, Lisp_Object, Lisp_Object));
570 void x_set_icon_name P_ ((struct frame *, Lisp_Object, Lisp_Object));
571 void x_explicitly_set_name P_ ((struct frame *, Lisp_Object, Lisp_Object));
572 void x_set_menu_bar_lines P_ ((struct frame *, Lisp_Object, Lisp_Object));
573 void x_set_title P_ ((struct frame *, Lisp_Object, Lisp_Object));
574 void x_set_tool_bar_lines P_ ((struct frame *, Lisp_Object, Lisp_Object));
575 void x_set_scroll_bar_foreground P_ ((struct frame *, Lisp_Object,
576 Lisp_Object));
577 void x_set_scroll_bar_background P_ ((struct frame *, Lisp_Object,
578 Lisp_Object));
579 static Lisp_Object x_default_scroll_bar_color_parameter P_ ((struct frame *,
580 Lisp_Object,
581 Lisp_Object,
582 char *, char *,
583 int));
586 /* Store the screen positions of frame F into XPTR and YPTR.
587 These are the positions of the containing window manager window,
588 not Emacs's own window. */
590 void
591 x_real_positions (f, xptr, yptr)
592 FRAME_PTR f;
593 int *xptr, *yptr;
595 int win_x, win_y, outer_x, outer_y;
596 int real_x = 0, real_y = 0;
597 int had_errors = 0;
598 Window win = f->output_data.x->parent_desc;
600 BLOCK_INPUT;
602 x_catch_errors (FRAME_X_DISPLAY (f));
604 if (win == FRAME_X_DISPLAY_INFO (f)->root_window)
605 win = FRAME_OUTER_WINDOW (f);
607 /* This loop traverses up the containment tree until we hit the root
608 window. Window managers may intersect many windows between our window
609 and the root window. The window we find just before the root window
610 should be the outer WM window. */
611 for (;;)
613 Window wm_window, rootw;
614 Window *tmp_children;
615 unsigned int tmp_nchildren;
616 int success;
618 success = XQueryTree (FRAME_X_DISPLAY (f), win, &rootw,
619 &wm_window, &tmp_children, &tmp_nchildren);
621 had_errors = x_had_errors_p (FRAME_X_DISPLAY (f));
623 /* Don't free tmp_children if XQueryTree failed. */
624 if (! success)
625 break;
627 XFree ((char *) tmp_children);
629 if (wm_window == rootw || had_errors)
630 break;
632 win = wm_window;
635 if (! had_errors)
637 unsigned int ign;
638 Window child, rootw;
640 /* Get the real coordinates for the WM window upper left corner */
641 XGetGeometry (FRAME_X_DISPLAY (f), win,
642 &rootw, &real_x, &real_y, &ign, &ign, &ign, &ign);
644 /* Translate real coordinates to coordinates relative to our
645 window. For our window, the upper left corner is 0, 0.
646 Since the upper left corner of the WM window is outside
647 our window, win_x and win_y will be negative:
649 ------------------ ---> x
650 | title |
651 | ----------------- v y
652 | | our window
654 XTranslateCoordinates (FRAME_X_DISPLAY (f),
656 /* From-window, to-window. */
657 FRAME_X_DISPLAY_INFO (f)->root_window,
658 FRAME_X_WINDOW (f),
660 /* From-position, to-position. */
661 real_x, real_y, &win_x, &win_y,
663 /* Child of win. */
664 &child);
666 if (FRAME_X_WINDOW (f) == FRAME_OUTER_WINDOW (f))
668 outer_x = win_x;
669 outer_y = win_y;
671 else
673 XTranslateCoordinates (FRAME_X_DISPLAY (f),
675 /* From-window, to-window. */
676 FRAME_X_DISPLAY_INFO (f)->root_window,
677 FRAME_OUTER_WINDOW (f),
679 /* From-position, to-position. */
680 real_x, real_y, &outer_x, &outer_y,
682 /* Child of win. */
683 &child);
686 had_errors = x_had_errors_p (FRAME_X_DISPLAY (f));
689 x_uncatch_errors ();
691 UNBLOCK_INPUT;
693 if (had_errors) return;
695 f->x_pixels_diff = -win_x;
696 f->y_pixels_diff = -win_y;
698 FRAME_X_OUTPUT (f)->x_pixels_outer_diff = -outer_x;
699 FRAME_X_OUTPUT (f)->y_pixels_outer_diff = -outer_y;
701 *xptr = real_x;
702 *yptr = real_y;
708 /* Gamma-correct COLOR on frame F. */
710 void
711 gamma_correct (f, color)
712 struct frame *f;
713 XColor *color;
715 if (f->gamma)
717 color->red = pow (color->red / 65535.0, f->gamma) * 65535.0 + 0.5;
718 color->green = pow (color->green / 65535.0, f->gamma) * 65535.0 + 0.5;
719 color->blue = pow (color->blue / 65535.0, f->gamma) * 65535.0 + 0.5;
724 /* Decide if color named COLOR_NAME is valid for use on frame F. If
725 so, return the RGB values in COLOR. If ALLOC_P is non-zero,
726 allocate the color. Value is zero if COLOR_NAME is invalid, or
727 no color could be allocated. */
730 x_defined_color (f, color_name, color, alloc_p)
731 struct frame *f;
732 char *color_name;
733 XColor *color;
734 int alloc_p;
736 int success_p;
737 Display *dpy = FRAME_X_DISPLAY (f);
738 Colormap cmap = FRAME_X_COLORMAP (f);
740 BLOCK_INPUT;
741 success_p = XParseColor (dpy, cmap, color_name, color);
742 if (success_p && alloc_p)
743 success_p = x_alloc_nearest_color (f, cmap, color);
744 UNBLOCK_INPUT;
746 return success_p;
750 /* Return the pixel color value for color COLOR_NAME on frame F. If F
751 is a monochrome frame, return MONO_COLOR regardless of what ARG says.
752 Signal an error if color can't be allocated. */
755 x_decode_color (f, color_name, mono_color)
756 FRAME_PTR f;
757 Lisp_Object color_name;
758 int mono_color;
760 XColor cdef;
762 CHECK_STRING (color_name);
764 #if 0 /* Don't do this. It's wrong when we're not using the default
765 colormap, it makes freeing difficult, and it's probably not
766 an important optimization. */
767 if (strcmp (SDATA (color_name), "black") == 0)
768 return BLACK_PIX_DEFAULT (f);
769 else if (strcmp (SDATA (color_name), "white") == 0)
770 return WHITE_PIX_DEFAULT (f);
771 #endif
773 /* Return MONO_COLOR for monochrome frames. */
774 if (FRAME_X_DISPLAY_INFO (f)->n_planes == 1)
775 return mono_color;
777 /* x_defined_color is responsible for coping with failures
778 by looking for a near-miss. */
779 if (x_defined_color (f, SDATA (color_name), &cdef, 1))
780 return cdef.pixel;
782 signal_error ("Undefined color", color_name);
787 /* Change the `wait-for-wm' frame parameter of frame F. OLD_VALUE is
788 the previous value of that parameter, NEW_VALUE is the new value.
789 See also the comment of wait_for_wm in struct x_output. */
791 static void
792 x_set_wait_for_wm (f, new_value, old_value)
793 struct frame *f;
794 Lisp_Object new_value, old_value;
796 f->output_data.x->wait_for_wm = !NILP (new_value);
799 #ifdef USE_GTK
801 /* Set icon from FILE for frame F. By using GTK functions the icon
802 may be any format that GdkPixbuf knows about, i.e. not just bitmaps. */
805 xg_set_icon (f, file)
806 FRAME_PTR f;
807 Lisp_Object file;
809 int result = 0;
810 Lisp_Object found;
812 found = x_find_image_file (file);
814 if (! NILP (found))
816 GdkPixbuf *pixbuf;
817 GError *err = NULL;
818 char *filename = (char *) SDATA (found);
819 BLOCK_INPUT;
821 pixbuf = gdk_pixbuf_new_from_file (filename, &err);
823 if (pixbuf)
825 gtk_window_set_icon (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)),
826 pixbuf);
827 g_object_unref (pixbuf);
829 result = 1;
831 else
832 g_error_free (err);
834 UNBLOCK_INPUT;
837 return result;
841 xg_set_icon_from_xpm_data (f, data)
842 FRAME_PTR f;
843 char **data;
845 int result = 0;
846 GdkPixbuf *pixbuf = gdk_pixbuf_new_from_xpm_data ((const char **) data);
848 if (!pixbuf)
849 return 0;
851 gtk_window_set_icon (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)), pixbuf);
852 g_object_unref (pixbuf);
853 return 1;
855 #endif /* USE_GTK */
858 /* Functions called only from `x_set_frame_param'
859 to set individual parameters.
861 If FRAME_X_WINDOW (f) is 0,
862 the frame is being created and its X-window does not exist yet.
863 In that case, just record the parameter's new value
864 in the standard place; do not attempt to change the window. */
866 void
867 x_set_foreground_color (f, arg, oldval)
868 struct frame *f;
869 Lisp_Object arg, oldval;
871 struct x_output *x = f->output_data.x;
872 unsigned long fg, old_fg;
874 fg = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
875 old_fg = FRAME_FOREGROUND_PIXEL (f);
876 FRAME_FOREGROUND_PIXEL (f) = fg;
878 if (FRAME_X_WINDOW (f) != 0)
880 Display *dpy = FRAME_X_DISPLAY (f);
882 BLOCK_INPUT;
883 XSetForeground (dpy, x->normal_gc, fg);
884 XSetBackground (dpy, x->reverse_gc, fg);
886 if (x->cursor_pixel == old_fg)
888 unload_color (f, x->cursor_pixel);
889 x->cursor_pixel = x_copy_color (f, fg);
890 XSetBackground (dpy, x->cursor_gc, x->cursor_pixel);
893 UNBLOCK_INPUT;
895 update_face_from_frame_parameter (f, Qforeground_color, arg);
897 if (FRAME_VISIBLE_P (f))
898 redraw_frame (f);
901 unload_color (f, old_fg);
904 void
905 x_set_background_color (f, arg, oldval)
906 struct frame *f;
907 Lisp_Object arg, oldval;
909 struct x_output *x = f->output_data.x;
910 unsigned long bg;
912 bg = x_decode_color (f, arg, WHITE_PIX_DEFAULT (f));
913 unload_color (f, FRAME_BACKGROUND_PIXEL (f));
914 FRAME_BACKGROUND_PIXEL (f) = bg;
916 if (FRAME_X_WINDOW (f) != 0)
918 Display *dpy = FRAME_X_DISPLAY (f);
920 BLOCK_INPUT;
921 XSetBackground (dpy, x->normal_gc, bg);
922 XSetForeground (dpy, x->reverse_gc, bg);
923 XSetWindowBackground (dpy, FRAME_X_WINDOW (f), bg);
924 XSetForeground (dpy, x->cursor_gc, bg);
926 #ifdef USE_GTK
927 xg_set_background_color (f, bg);
928 #endif
930 #ifndef USE_TOOLKIT_SCROLL_BARS /* Turns out to be annoying with
931 toolkit scroll bars. */
933 Lisp_Object bar;
934 for (bar = FRAME_SCROLL_BARS (f);
935 !NILP (bar);
936 bar = XSCROLL_BAR (bar)->next)
938 Window window = XSCROLL_BAR (bar)->x_window;
939 XSetWindowBackground (dpy, window, bg);
942 #endif /* USE_TOOLKIT_SCROLL_BARS */
944 UNBLOCK_INPUT;
945 update_face_from_frame_parameter (f, Qbackground_color, arg);
947 if (FRAME_VISIBLE_P (f))
948 redraw_frame (f);
952 void
953 x_set_mouse_color (f, arg, oldval)
954 struct frame *f;
955 Lisp_Object arg, oldval;
957 struct x_output *x = f->output_data.x;
958 Display *dpy = FRAME_X_DISPLAY (f);
959 Cursor cursor, nontext_cursor, mode_cursor, hand_cursor;
960 Cursor hourglass_cursor, horizontal_drag_cursor;
961 unsigned long pixel = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
962 unsigned long mask_color = FRAME_BACKGROUND_PIXEL (f);
964 /* Don't let pointers be invisible. */
965 if (mask_color == pixel)
967 x_free_colors (f, &pixel, 1);
968 pixel = x_copy_color (f, FRAME_FOREGROUND_PIXEL (f));
971 unload_color (f, x->mouse_pixel);
972 x->mouse_pixel = pixel;
974 BLOCK_INPUT;
976 /* It's not okay to crash if the user selects a screwy cursor. */
977 x_catch_errors (dpy);
979 if (!NILP (Vx_pointer_shape))
981 CHECK_NUMBER (Vx_pointer_shape);
982 cursor = XCreateFontCursor (dpy, XINT (Vx_pointer_shape));
984 else
985 cursor = XCreateFontCursor (dpy, XC_xterm);
986 x_check_errors (dpy, "bad text pointer cursor: %s");
988 if (!NILP (Vx_nontext_pointer_shape))
990 CHECK_NUMBER (Vx_nontext_pointer_shape);
991 nontext_cursor
992 = XCreateFontCursor (dpy, XINT (Vx_nontext_pointer_shape));
994 else
995 nontext_cursor = XCreateFontCursor (dpy, XC_left_ptr);
996 x_check_errors (dpy, "bad nontext pointer cursor: %s");
998 if (!NILP (Vx_hourglass_pointer_shape))
1000 CHECK_NUMBER (Vx_hourglass_pointer_shape);
1001 hourglass_cursor
1002 = XCreateFontCursor (dpy, XINT (Vx_hourglass_pointer_shape));
1004 else
1005 hourglass_cursor = XCreateFontCursor (dpy, XC_watch);
1006 x_check_errors (dpy, "bad hourglass pointer cursor: %s");
1008 if (!NILP (Vx_mode_pointer_shape))
1010 CHECK_NUMBER (Vx_mode_pointer_shape);
1011 mode_cursor = XCreateFontCursor (dpy, XINT (Vx_mode_pointer_shape));
1013 else
1014 mode_cursor = XCreateFontCursor (dpy, XC_xterm);
1015 x_check_errors (dpy, "bad modeline pointer cursor: %s");
1017 if (!NILP (Vx_sensitive_text_pointer_shape))
1019 CHECK_NUMBER (Vx_sensitive_text_pointer_shape);
1020 hand_cursor
1021 = XCreateFontCursor (dpy, XINT (Vx_sensitive_text_pointer_shape));
1023 else
1024 hand_cursor = XCreateFontCursor (dpy, XC_hand2);
1026 if (!NILP (Vx_window_horizontal_drag_shape))
1028 CHECK_NUMBER (Vx_window_horizontal_drag_shape);
1029 horizontal_drag_cursor
1030 = XCreateFontCursor (dpy, XINT (Vx_window_horizontal_drag_shape));
1032 else
1033 horizontal_drag_cursor
1034 = XCreateFontCursor (dpy, XC_sb_h_double_arrow);
1036 /* Check and report errors with the above calls. */
1037 x_check_errors (dpy, "can't set cursor shape: %s");
1038 x_uncatch_errors ();
1041 XColor fore_color, back_color;
1043 fore_color.pixel = x->mouse_pixel;
1044 x_query_color (f, &fore_color);
1045 back_color.pixel = mask_color;
1046 x_query_color (f, &back_color);
1048 XRecolorCursor (dpy, cursor, &fore_color, &back_color);
1049 XRecolorCursor (dpy, nontext_cursor, &fore_color, &back_color);
1050 XRecolorCursor (dpy, mode_cursor, &fore_color, &back_color);
1051 XRecolorCursor (dpy, hand_cursor, &fore_color, &back_color);
1052 XRecolorCursor (dpy, hourglass_cursor, &fore_color, &back_color);
1053 XRecolorCursor (dpy, horizontal_drag_cursor, &fore_color, &back_color);
1056 if (FRAME_X_WINDOW (f) != 0)
1057 XDefineCursor (dpy, FRAME_X_WINDOW (f), cursor);
1059 if (cursor != x->text_cursor
1060 && x->text_cursor != 0)
1061 XFreeCursor (dpy, x->text_cursor);
1062 x->text_cursor = cursor;
1064 if (nontext_cursor != x->nontext_cursor
1065 && x->nontext_cursor != 0)
1066 XFreeCursor (dpy, x->nontext_cursor);
1067 x->nontext_cursor = nontext_cursor;
1069 if (hourglass_cursor != x->hourglass_cursor
1070 && x->hourglass_cursor != 0)
1071 XFreeCursor (dpy, x->hourglass_cursor);
1072 x->hourglass_cursor = hourglass_cursor;
1074 if (mode_cursor != x->modeline_cursor
1075 && x->modeline_cursor != 0)
1076 XFreeCursor (dpy, f->output_data.x->modeline_cursor);
1077 x->modeline_cursor = mode_cursor;
1079 if (hand_cursor != x->hand_cursor
1080 && x->hand_cursor != 0)
1081 XFreeCursor (dpy, x->hand_cursor);
1082 x->hand_cursor = hand_cursor;
1084 if (horizontal_drag_cursor != x->horizontal_drag_cursor
1085 && x->horizontal_drag_cursor != 0)
1086 XFreeCursor (dpy, x->horizontal_drag_cursor);
1087 x->horizontal_drag_cursor = horizontal_drag_cursor;
1089 XFlush (dpy);
1090 UNBLOCK_INPUT;
1092 update_face_from_frame_parameter (f, Qmouse_color, arg);
1095 void
1096 x_set_cursor_color (f, arg, oldval)
1097 struct frame *f;
1098 Lisp_Object arg, oldval;
1100 unsigned long fore_pixel, pixel;
1101 int fore_pixel_allocated_p = 0, pixel_allocated_p = 0;
1102 struct x_output *x = f->output_data.x;
1104 if (!NILP (Vx_cursor_fore_pixel))
1106 fore_pixel = x_decode_color (f, Vx_cursor_fore_pixel,
1107 WHITE_PIX_DEFAULT (f));
1108 fore_pixel_allocated_p = 1;
1110 else
1111 fore_pixel = FRAME_BACKGROUND_PIXEL (f);
1113 pixel = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
1114 pixel_allocated_p = 1;
1116 /* Make sure that the cursor color differs from the background color. */
1117 if (pixel == FRAME_BACKGROUND_PIXEL (f))
1119 if (pixel_allocated_p)
1121 x_free_colors (f, &pixel, 1);
1122 pixel_allocated_p = 0;
1125 pixel = x->mouse_pixel;
1126 if (pixel == fore_pixel)
1128 if (fore_pixel_allocated_p)
1130 x_free_colors (f, &fore_pixel, 1);
1131 fore_pixel_allocated_p = 0;
1133 fore_pixel = FRAME_BACKGROUND_PIXEL (f);
1137 unload_color (f, x->cursor_foreground_pixel);
1138 if (!fore_pixel_allocated_p)
1139 fore_pixel = x_copy_color (f, fore_pixel);
1140 x->cursor_foreground_pixel = fore_pixel;
1142 unload_color (f, x->cursor_pixel);
1143 if (!pixel_allocated_p)
1144 pixel = x_copy_color (f, pixel);
1145 x->cursor_pixel = pixel;
1147 if (FRAME_X_WINDOW (f) != 0)
1149 BLOCK_INPUT;
1150 XSetBackground (FRAME_X_DISPLAY (f), x->cursor_gc, x->cursor_pixel);
1151 XSetForeground (FRAME_X_DISPLAY (f), x->cursor_gc, fore_pixel);
1152 UNBLOCK_INPUT;
1154 if (FRAME_VISIBLE_P (f))
1156 x_update_cursor (f, 0);
1157 x_update_cursor (f, 1);
1161 update_face_from_frame_parameter (f, Qcursor_color, arg);
1164 /* Set the border-color of frame F to pixel value PIX.
1165 Note that this does not fully take effect if done before
1166 F has an x-window. */
1168 void
1169 x_set_border_pixel (f, pix)
1170 struct frame *f;
1171 int pix;
1173 unload_color (f, f->output_data.x->border_pixel);
1174 f->output_data.x->border_pixel = pix;
1176 if (FRAME_X_WINDOW (f) != 0 && f->border_width > 0)
1178 BLOCK_INPUT;
1179 XSetWindowBorder (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1180 (unsigned long)pix);
1181 UNBLOCK_INPUT;
1183 if (FRAME_VISIBLE_P (f))
1184 redraw_frame (f);
1188 /* Set the border-color of frame F to value described by ARG.
1189 ARG can be a string naming a color.
1190 The border-color is used for the border that is drawn by the X server.
1191 Note that this does not fully take effect if done before
1192 F has an x-window; it must be redone when the window is created.
1194 Note: this is done in two routines because of the way X10 works.
1196 Note: under X11, this is normally the province of the window manager,
1197 and so emacs' border colors may be overridden. */
1199 void
1200 x_set_border_color (f, arg, oldval)
1201 struct frame *f;
1202 Lisp_Object arg, oldval;
1204 int pix;
1206 CHECK_STRING (arg);
1207 pix = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
1208 x_set_border_pixel (f, pix);
1209 update_face_from_frame_parameter (f, Qborder_color, arg);
1213 void
1214 x_set_cursor_type (f, arg, oldval)
1215 FRAME_PTR f;
1216 Lisp_Object arg, oldval;
1218 set_frame_cursor_types (f, arg);
1220 /* Make sure the cursor gets redrawn. */
1221 cursor_type_changed = 1;
1224 void
1225 x_set_icon_type (f, arg, oldval)
1226 struct frame *f;
1227 Lisp_Object arg, oldval;
1229 int result;
1231 if (STRINGP (arg))
1233 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
1234 return;
1236 else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
1237 return;
1239 BLOCK_INPUT;
1240 if (NILP (arg))
1241 result = x_text_icon (f,
1242 (char *) SDATA ((!NILP (f->icon_name)
1243 ? f->icon_name
1244 : f->name)));
1245 else
1246 result = x_bitmap_icon (f, arg);
1248 if (result)
1250 UNBLOCK_INPUT;
1251 error ("No icon window available");
1254 XFlush (FRAME_X_DISPLAY (f));
1255 UNBLOCK_INPUT;
1258 void
1259 x_set_icon_name (f, arg, oldval)
1260 struct frame *f;
1261 Lisp_Object arg, oldval;
1263 int result;
1265 if (STRINGP (arg))
1267 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
1268 return;
1270 else if (!NILP (arg) || NILP (oldval))
1271 return;
1273 f->icon_name = arg;
1275 if (f->output_data.x->icon_bitmap != 0)
1276 return;
1278 BLOCK_INPUT;
1280 result = x_text_icon (f,
1281 (char *) SDATA ((!NILP (f->icon_name)
1282 ? f->icon_name
1283 : !NILP (f->title)
1284 ? f->title
1285 : f->name)));
1287 if (result)
1289 UNBLOCK_INPUT;
1290 error ("No icon window available");
1293 XFlush (FRAME_X_DISPLAY (f));
1294 UNBLOCK_INPUT;
1298 void
1299 x_set_menu_bar_lines (f, value, oldval)
1300 struct frame *f;
1301 Lisp_Object value, oldval;
1303 int nlines;
1304 #if ! defined (USE_X_TOOLKIT) && ! defined (USE_GTK)
1305 int olines = FRAME_MENU_BAR_LINES (f);
1306 #endif
1308 /* Right now, menu bars don't work properly in minibuf-only frames;
1309 most of the commands try to apply themselves to the minibuffer
1310 frame itself, and get an error because you can't switch buffers
1311 in or split the minibuffer window. */
1312 if (FRAME_MINIBUF_ONLY_P (f))
1313 return;
1315 if (INTEGERP (value))
1316 nlines = XINT (value);
1317 else
1318 nlines = 0;
1320 /* Make sure we redisplay all windows in this frame. */
1321 windows_or_buffers_changed++;
1323 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
1324 FRAME_MENU_BAR_LINES (f) = 0;
1325 if (nlines)
1327 FRAME_EXTERNAL_MENU_BAR (f) = 1;
1328 if (FRAME_X_P (f) && f->output_data.x->menubar_widget == 0)
1329 /* Make sure next redisplay shows the menu bar. */
1330 XWINDOW (FRAME_SELECTED_WINDOW (f))->update_mode_line = Qt;
1332 else
1334 if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
1335 free_frame_menubar (f);
1336 FRAME_EXTERNAL_MENU_BAR (f) = 0;
1337 if (FRAME_X_P (f))
1338 f->output_data.x->menubar_widget = 0;
1340 #else /* not USE_X_TOOLKIT && not USE_GTK */
1341 FRAME_MENU_BAR_LINES (f) = nlines;
1342 change_window_heights (f->root_window, nlines - olines);
1343 #endif /* not USE_X_TOOLKIT */
1344 adjust_glyphs (f);
1348 /* Set the number of lines used for the tool bar of frame F to VALUE.
1349 VALUE not an integer, or < 0 means set the lines to zero. OLDVAL
1350 is the old number of tool bar lines. This function changes the
1351 height of all windows on frame F to match the new tool bar height.
1352 The frame's height doesn't change. */
1354 void
1355 x_set_tool_bar_lines (f, value, oldval)
1356 struct frame *f;
1357 Lisp_Object value, oldval;
1359 int delta, nlines, root_height;
1360 Lisp_Object root_window;
1362 /* Treat tool bars like menu bars. */
1363 if (FRAME_MINIBUF_ONLY_P (f))
1364 return;
1366 /* Use VALUE only if an integer >= 0. */
1367 if (INTEGERP (value) && XINT (value) >= 0)
1368 nlines = XFASTINT (value);
1369 else
1370 nlines = 0;
1372 #ifdef USE_GTK
1373 FRAME_TOOL_BAR_LINES (f) = 0;
1374 if (nlines)
1376 FRAME_EXTERNAL_TOOL_BAR (f) = 1;
1377 if (FRAME_X_P (f) && f->output_data.x->toolbar_widget == 0)
1378 /* Make sure next redisplay shows the tool bar. */
1379 XWINDOW (FRAME_SELECTED_WINDOW (f))->update_mode_line = Qt;
1380 update_frame_tool_bar (f);
1382 else
1384 if (FRAME_EXTERNAL_TOOL_BAR (f))
1385 free_frame_tool_bar (f);
1386 FRAME_EXTERNAL_TOOL_BAR (f) = 0;
1389 return;
1390 #endif
1392 /* Make sure we redisplay all windows in this frame. */
1393 ++windows_or_buffers_changed;
1395 delta = nlines - FRAME_TOOL_BAR_LINES (f);
1397 /* Don't resize the tool-bar to more than we have room for. */
1398 root_window = FRAME_ROOT_WINDOW (f);
1399 root_height = WINDOW_TOTAL_LINES (XWINDOW (root_window));
1400 if (root_height - delta < 1)
1402 delta = root_height - 1;
1403 nlines = FRAME_TOOL_BAR_LINES (f) + delta;
1406 FRAME_TOOL_BAR_LINES (f) = nlines;
1407 change_window_heights (root_window, delta);
1408 adjust_glyphs (f);
1410 /* We also have to make sure that the internal border at the top of
1411 the frame, below the menu bar or tool bar, is redrawn when the
1412 tool bar disappears. This is so because the internal border is
1413 below the tool bar if one is displayed, but is below the menu bar
1414 if there isn't a tool bar. The tool bar draws into the area
1415 below the menu bar. */
1416 if (FRAME_X_WINDOW (f) && FRAME_TOOL_BAR_LINES (f) == 0)
1418 clear_frame (f);
1419 clear_current_matrices (f);
1422 /* If the tool bar gets smaller, the internal border below it
1423 has to be cleared. It was formerly part of the display
1424 of the larger tool bar, and updating windows won't clear it. */
1425 if (delta < 0)
1427 int height = FRAME_INTERNAL_BORDER_WIDTH (f);
1428 int width = FRAME_PIXEL_WIDTH (f);
1429 int y = nlines * FRAME_LINE_HEIGHT (f);
1431 /* height can be zero here. */
1432 if (height > 0 && width > 0)
1434 BLOCK_INPUT;
1435 x_clear_area (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1436 0, y, width, height, False);
1437 UNBLOCK_INPUT;
1440 if (WINDOWP (f->tool_bar_window))
1441 clear_glyph_matrix (XWINDOW (f->tool_bar_window)->current_matrix);
1446 /* Set the foreground color for scroll bars on frame F to VALUE.
1447 VALUE should be a string, a color name. If it isn't a string or
1448 isn't a valid color name, do nothing. OLDVAL is the old value of
1449 the frame parameter. */
1451 void
1452 x_set_scroll_bar_foreground (f, value, oldval)
1453 struct frame *f;
1454 Lisp_Object value, oldval;
1456 unsigned long pixel;
1458 if (STRINGP (value))
1459 pixel = x_decode_color (f, value, BLACK_PIX_DEFAULT (f));
1460 else
1461 pixel = -1;
1463 if (f->output_data.x->scroll_bar_foreground_pixel != -1)
1464 unload_color (f, f->output_data.x->scroll_bar_foreground_pixel);
1466 f->output_data.x->scroll_bar_foreground_pixel = pixel;
1467 if (FRAME_X_WINDOW (f) && FRAME_VISIBLE_P (f))
1469 /* Remove all scroll bars because they have wrong colors. */
1470 if (FRAME_TERMINAL (f)->condemn_scroll_bars_hook)
1471 (*FRAME_TERMINAL (f)->condemn_scroll_bars_hook) (f);
1472 if (FRAME_TERMINAL (f)->judge_scroll_bars_hook)
1473 (*FRAME_TERMINAL (f)->judge_scroll_bars_hook) (f);
1475 update_face_from_frame_parameter (f, Qscroll_bar_foreground, value);
1476 redraw_frame (f);
1481 /* Set the background color for scroll bars on frame F to VALUE VALUE
1482 should be a string, a color name. If it isn't a string or isn't a
1483 valid color name, do nothing. OLDVAL is the old value of the frame
1484 parameter. */
1486 void
1487 x_set_scroll_bar_background (f, value, oldval)
1488 struct frame *f;
1489 Lisp_Object value, oldval;
1491 unsigned long pixel;
1493 if (STRINGP (value))
1494 pixel = x_decode_color (f, value, WHITE_PIX_DEFAULT (f));
1495 else
1496 pixel = -1;
1498 if (f->output_data.x->scroll_bar_background_pixel != -1)
1499 unload_color (f, f->output_data.x->scroll_bar_background_pixel);
1501 #ifdef USE_TOOLKIT_SCROLL_BARS
1502 /* Scrollbar shadow colors. */
1503 if (f->output_data.x->scroll_bar_top_shadow_pixel != -1)
1505 unload_color (f, f->output_data.x->scroll_bar_top_shadow_pixel);
1506 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
1508 if (f->output_data.x->scroll_bar_bottom_shadow_pixel != -1)
1510 unload_color (f, f->output_data.x->scroll_bar_bottom_shadow_pixel);
1511 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
1513 #endif /* USE_TOOLKIT_SCROLL_BARS */
1515 f->output_data.x->scroll_bar_background_pixel = pixel;
1516 if (FRAME_X_WINDOW (f) && FRAME_VISIBLE_P (f))
1518 /* Remove all scroll bars because they have wrong colors. */
1519 if (FRAME_TERMINAL (f)->condemn_scroll_bars_hook)
1520 (*FRAME_TERMINAL (f)->condemn_scroll_bars_hook) (f);
1521 if (FRAME_TERMINAL (f)->judge_scroll_bars_hook)
1522 (*FRAME_TERMINAL (f)->judge_scroll_bars_hook) (f);
1524 update_face_from_frame_parameter (f, Qscroll_bar_background, value);
1525 redraw_frame (f);
1530 /* Encode Lisp string STRING as a text in a format appropriate for
1531 XICCC (X Inter Client Communication Conventions).
1533 This can call Lisp code, so callers must GCPRO.
1535 If STRING contains only ASCII characters, do no conversion and
1536 return the string data of STRING. Otherwise, encode the text by
1537 CODING_SYSTEM, and return a newly allocated memory area which
1538 should be freed by `xfree' by a caller.
1540 SELECTIONP non-zero means the string is being encoded for an X
1541 selection, so it is safe to run pre-write conversions (which
1542 may run Lisp code).
1544 Store the byte length of resulting text in *TEXT_BYTES.
1546 If the text contains only ASCII and Latin-1, store 1 in *STRING_P,
1547 which means that the `encoding' of the result can be `STRING'.
1548 Otherwise store 0 in *STRINGP, which means that the `encoding' of
1549 the result should be `COMPOUND_TEXT'. */
1551 static unsigned char *
1552 x_encode_text (string, coding_system, selectionp, text_bytes, stringp, freep)
1553 Lisp_Object string, coding_system;
1554 int *text_bytes, *stringp;
1555 int selectionp;
1556 int *freep;
1558 int result = string_xstring_p (string);
1559 struct coding_system coding;
1561 if (result == 0)
1563 /* No multibyte character in OBJ. We need not encode it. */
1564 *text_bytes = SBYTES (string);
1565 *stringp = 1;
1566 *freep = 0;
1567 return SDATA (string);
1570 setup_coding_system (coding_system, &coding);
1571 coding.mode |= (CODING_MODE_SAFE_ENCODING | CODING_MODE_LAST_BLOCK);
1572 /* We suppress producing escape sequences for composition. */
1573 coding.common_flags &= ~CODING_ANNOTATION_MASK;
1574 coding.dst_bytes = SCHARS (string) * 2;
1575 coding.destination = (unsigned char *) xmalloc (coding.dst_bytes);
1576 encode_coding_object (&coding, string, 0, 0,
1577 SCHARS (string), SBYTES (string), Qnil);
1578 *text_bytes = coding.produced;
1579 *stringp = (result == 1 || !EQ (coding_system, Qcompound_text));
1580 *freep = 1;
1581 return coding.destination;
1585 /* Set the WM name to NAME for frame F. Also set the icon name.
1586 If the frame already has an icon name, use that, otherwise set the
1587 icon name to NAME. */
1589 static void
1590 x_set_name_internal (f, name)
1591 FRAME_PTR f;
1592 Lisp_Object name;
1594 if (FRAME_X_WINDOW (f))
1596 BLOCK_INPUT;
1598 XTextProperty text, icon;
1599 int bytes, stringp;
1600 int do_free_icon_value = 0, do_free_text_value = 0;
1601 Lisp_Object coding_system;
1602 #ifdef USE_GTK
1603 Lisp_Object encoded_name;
1604 struct gcpro gcpro1;
1606 /* As ENCODE_UTF_8 may cause GC and relocation of string data,
1607 we use it before x_encode_text that may return string data. */
1608 GCPRO1 (name);
1609 encoded_name = ENCODE_UTF_8 (name);
1610 UNGCPRO;
1611 #endif
1613 coding_system = Qcompound_text;
1614 /* Note: Encoding strategy
1616 We encode NAME by compound-text and use "COMPOUND-TEXT" in
1617 text.encoding. But, there are non-internationalized window
1618 managers which don't support that encoding. So, if NAME
1619 contains only ASCII and 8859-1 characters, encode it by
1620 iso-latin-1, and use "STRING" in text.encoding hoping that
1621 such window managers at least analyze this format correctly,
1622 i.e. treat 8-bit bytes as 8859-1 characters.
1624 We may also be able to use "UTF8_STRING" in text.encoding
1625 in the future which can encode all Unicode characters.
1626 But, for the moment, there's no way to know that the
1627 current window manager supports it or not. */
1628 text.value = x_encode_text (name, coding_system, 0, &bytes, &stringp,
1629 &do_free_text_value);
1630 text.encoding = (stringp ? XA_STRING
1631 : FRAME_X_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
1632 text.format = 8;
1633 text.nitems = bytes;
1635 if (!STRINGP (f->icon_name))
1637 icon = text;
1639 else
1641 /* See the above comment "Note: Encoding strategy". */
1642 icon.value = x_encode_text (f->icon_name, coding_system, 0,
1643 &bytes, &stringp, &do_free_icon_value);
1644 icon.encoding = (stringp ? XA_STRING
1645 : FRAME_X_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
1646 icon.format = 8;
1647 icon.nitems = bytes;
1650 #ifdef USE_GTK
1651 gtk_window_set_title (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)),
1652 (char *) SDATA (encoded_name));
1653 #else /* not USE_GTK */
1654 XSetWMName (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &text);
1655 #endif /* not USE_GTK */
1657 XSetWMIconName (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &icon);
1659 if (do_free_icon_value)
1660 xfree (icon.value);
1661 if (do_free_text_value)
1662 xfree (text.value);
1664 UNBLOCK_INPUT;
1668 /* Change the name of frame F to NAME. If NAME is nil, set F's name to
1669 x_id_name.
1671 If EXPLICIT is non-zero, that indicates that lisp code is setting the
1672 name; if NAME is a string, set F's name to NAME and set
1673 F->explicit_name; if NAME is Qnil, then clear F->explicit_name.
1675 If EXPLICIT is zero, that indicates that Emacs redisplay code is
1676 suggesting a new name, which lisp code should override; if
1677 F->explicit_name is set, ignore the new name; otherwise, set it. */
1679 void
1680 x_set_name (f, name, explicit)
1681 struct frame *f;
1682 Lisp_Object name;
1683 int explicit;
1685 /* Make sure that requests from lisp code override requests from
1686 Emacs redisplay code. */
1687 if (explicit)
1689 /* If we're switching from explicit to implicit, we had better
1690 update the mode lines and thereby update the title. */
1691 if (f->explicit_name && NILP (name))
1692 update_mode_lines = 1;
1694 f->explicit_name = ! NILP (name);
1696 else if (f->explicit_name)
1697 return;
1699 /* If NAME is nil, set the name to the x_id_name. */
1700 if (NILP (name))
1702 /* Check for no change needed in this very common case
1703 before we do any consing. */
1704 if (!strcmp (FRAME_X_DISPLAY_INFO (f)->x_id_name,
1705 SDATA (f->name)))
1706 return;
1707 name = build_string (FRAME_X_DISPLAY_INFO (f)->x_id_name);
1709 else
1710 CHECK_STRING (name);
1712 /* Don't change the name if it's already NAME. */
1713 if (! NILP (Fstring_equal (name, f->name)))
1714 return;
1716 f->name = name;
1718 /* For setting the frame title, the title parameter should override
1719 the name parameter. */
1720 if (! NILP (f->title))
1721 name = f->title;
1723 x_set_name_internal (f, name);
1726 /* This function should be called when the user's lisp code has
1727 specified a name for the frame; the name will override any set by the
1728 redisplay code. */
1729 void
1730 x_explicitly_set_name (f, arg, oldval)
1731 FRAME_PTR f;
1732 Lisp_Object arg, oldval;
1734 x_set_name (f, arg, 1);
1737 /* This function should be called by Emacs redisplay code to set the
1738 name; names set this way will never override names set by the user's
1739 lisp code. */
1740 void
1741 x_implicitly_set_name (f, arg, oldval)
1742 FRAME_PTR f;
1743 Lisp_Object arg, oldval;
1745 x_set_name (f, arg, 0);
1748 /* Change the title of frame F to NAME.
1749 If NAME is nil, use the frame name as the title. */
1751 void
1752 x_set_title (f, name, old_name)
1753 struct frame *f;
1754 Lisp_Object name, old_name;
1756 /* Don't change the title if it's already NAME. */
1757 if (EQ (name, f->title))
1758 return;
1760 update_mode_lines = 1;
1762 f->title = name;
1764 if (NILP (name))
1765 name = f->name;
1766 else
1767 CHECK_STRING (name);
1769 x_set_name_internal (f, name);
1772 void
1773 x_set_scroll_bar_default_width (f)
1774 struct frame *f;
1776 int wid = FRAME_COLUMN_WIDTH (f);
1778 #ifdef USE_TOOLKIT_SCROLL_BARS
1779 /* A minimum width of 14 doesn't look good for toolkit scroll bars. */
1780 int width = 16 + 2 * VERTICAL_SCROLL_BAR_WIDTH_TRIM;
1781 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (width + wid - 1) / wid;
1782 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = width;
1783 #else
1784 /* Make the actual width at least 14 pixels and a multiple of a
1785 character width. */
1786 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (14 + wid - 1) / wid;
1788 /* Use all of that space (aside from required margins) for the
1789 scroll bar. */
1790 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = 0;
1791 #endif
1795 /* Record in frame F the specified or default value according to ALIST
1796 of the parameter named PROP (a Lisp symbol). If no value is
1797 specified for PROP, look for an X default for XPROP on the frame
1798 named NAME. If that is not found either, use the value DEFLT. */
1800 static Lisp_Object
1801 x_default_scroll_bar_color_parameter (f, alist, prop, xprop, xclass,
1802 foreground_p)
1803 struct frame *f;
1804 Lisp_Object alist;
1805 Lisp_Object prop;
1806 char *xprop;
1807 char *xclass;
1808 int foreground_p;
1810 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
1811 Lisp_Object tem;
1813 tem = x_get_arg (dpyinfo, alist, prop, xprop, xclass, RES_TYPE_STRING);
1814 if (EQ (tem, Qunbound))
1816 #ifdef USE_TOOLKIT_SCROLL_BARS
1818 /* See if an X resource for the scroll bar color has been
1819 specified. */
1820 tem = display_x_get_resource (dpyinfo,
1821 build_string (foreground_p
1822 ? "foreground"
1823 : "background"),
1824 empty_unibyte_string,
1825 build_string ("verticalScrollBar"),
1826 empty_unibyte_string);
1827 if (!STRINGP (tem))
1829 /* If nothing has been specified, scroll bars will use a
1830 toolkit-dependent default. Because these defaults are
1831 difficult to get at without actually creating a scroll
1832 bar, use nil to indicate that no color has been
1833 specified. */
1834 tem = Qnil;
1837 #else /* not USE_TOOLKIT_SCROLL_BARS */
1839 tem = Qnil;
1841 #endif /* not USE_TOOLKIT_SCROLL_BARS */
1844 x_set_frame_parameters (f, Fcons (Fcons (prop, tem), Qnil));
1845 return tem;
1851 #ifdef USE_X_TOOLKIT
1853 /* If the WM_PROTOCOLS property does not already contain WM_TAKE_FOCUS,
1854 WM_DELETE_WINDOW, and WM_SAVE_YOURSELF, then add them. (They may
1855 already be present because of the toolkit (Motif adds some of them,
1856 for example, but Xt doesn't). */
1858 static void
1859 hack_wm_protocols (f, widget)
1860 FRAME_PTR f;
1861 Widget widget;
1863 Display *dpy = XtDisplay (widget);
1864 Window w = XtWindow (widget);
1865 int need_delete = 1;
1866 int need_focus = 1;
1867 int need_save = 1;
1869 BLOCK_INPUT;
1871 Atom type;
1872 unsigned char *catoms;
1873 int format = 0;
1874 unsigned long nitems = 0;
1875 unsigned long bytes_after;
1877 if ((XGetWindowProperty (dpy, w,
1878 FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
1879 (long)0, (long)100, False, XA_ATOM,
1880 &type, &format, &nitems, &bytes_after,
1881 &catoms)
1882 == Success)
1883 && format == 32 && type == XA_ATOM)
1885 Atom *atoms = (Atom *) catoms;
1886 while (nitems > 0)
1888 nitems--;
1889 if (atoms[nitems]
1890 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window)
1891 need_delete = 0;
1892 else if (atoms[nitems]
1893 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_take_focus)
1894 need_focus = 0;
1895 else if (atoms[nitems]
1896 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself)
1897 need_save = 0;
1900 if (catoms)
1901 XFree (catoms);
1904 Atom props [10];
1905 int count = 0;
1906 if (need_delete)
1907 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window;
1908 if (need_focus)
1909 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_take_focus;
1910 if (need_save)
1911 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself;
1912 if (count)
1913 XChangeProperty (dpy, w, FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
1914 XA_ATOM, 32, PropModeAppend,
1915 (unsigned char *) props, count);
1917 UNBLOCK_INPUT;
1919 #endif
1923 /* Support routines for XIC (X Input Context). */
1925 #ifdef HAVE_X_I18N
1927 static XFontSet xic_create_xfontset P_ ((struct frame *));
1928 static XIMStyle best_xim_style P_ ((XIMStyles *, XIMStyles *));
1931 /* Supported XIM styles, ordered by preference. */
1933 static XIMStyle supported_xim_styles[] =
1935 XIMPreeditPosition | XIMStatusArea,
1936 XIMPreeditPosition | XIMStatusNothing,
1937 XIMPreeditPosition | XIMStatusNone,
1938 XIMPreeditNothing | XIMStatusArea,
1939 XIMPreeditNothing | XIMStatusNothing,
1940 XIMPreeditNothing | XIMStatusNone,
1941 XIMPreeditNone | XIMStatusArea,
1942 XIMPreeditNone | XIMStatusNothing,
1943 XIMPreeditNone | XIMStatusNone,
1948 /* Create an X fontset on frame F with base font name BASE_FONTNAME. */
1950 char xic_defaut_fontset[] = "-*-*-*-r-normal--14-*-*-*-*-*-*-*";
1952 /* Create an Xt fontset spec from the name of a base font.
1953 If `motif' is True use the Motif syntax. */
1954 char *
1955 xic_create_fontsetname (base_fontname, motif)
1956 char *base_fontname;
1957 Bool motif;
1959 const char *sep = motif ? ";" : ",";
1960 char *fontsetname;
1962 /* Make a fontset name from the base font name. */
1963 if (xic_defaut_fontset == base_fontname)
1964 { /* There is no base font name, use the default. */
1965 int len = strlen (base_fontname) + 2;
1966 fontsetname = xmalloc (len);
1967 bzero (fontsetname, len);
1968 strcpy (fontsetname, base_fontname);
1970 else
1972 /* Make a fontset name from the base font name.
1973 The font set will be made of the following elements:
1974 - the base font.
1975 - the base font where the charset spec is replaced by -*-*.
1976 - the same but with the family also replaced with -*-*-. */
1977 char *p = base_fontname;
1978 int i;
1980 for (i = 0; *p; p++)
1981 if (*p == '-') i++;
1982 if (i != 14)
1983 { /* As the font name doesn't conform to XLFD, we can't
1984 modify it to generalize it to allcs and allfamilies.
1985 Use the specified font plus the default. */
1986 int len = strlen (base_fontname) + strlen (xic_defaut_fontset) + 3;
1987 fontsetname = xmalloc (len);
1988 bzero (fontsetname, len);
1989 strcpy (fontsetname, base_fontname);
1990 strcat (fontsetname, sep);
1991 strcat (fontsetname, xic_defaut_fontset);
1993 else
1995 int len;
1996 char *p1 = NULL, *p2 = NULL, *p3 = NULL;
1997 char *font_allcs = NULL;
1998 char *font_allfamilies = NULL;
1999 char *font_all = NULL;
2000 char *allcs = "*-*-*-*-*-*-*";
2001 char *allfamilies = "-*-*-";
2002 char *all = "*-*-*-*-";
2003 char *base;
2005 for (i = 0, p = base_fontname; i < 8; p++)
2007 if (*p == '-')
2009 i++;
2010 if (i == 3)
2011 p1 = p + 1;
2012 else if (i == 7)
2013 p2 = p + 1;
2014 else if (i == 6)
2015 p3 = p + 1;
2018 /* If base_fontname specifies ADSTYLE, make it a
2019 wildcard. */
2020 if (*p3 != '*')
2022 int diff = (p2 - p3) - 2;
2024 base = alloca (strlen (base_fontname) + 1);
2025 bcopy (base_fontname, base, p3 - base_fontname);
2026 base[p3 - base_fontname] = '*';
2027 base[(p3 - base_fontname) + 1] = '-';
2028 strcpy (base + (p3 - base_fontname) + 2, p2);
2029 p = base + (p - base_fontname) - diff;
2030 p1 = base + (p1 - base_fontname);
2031 p2 = base + (p2 - base_fontname) - diff;
2032 base_fontname = base;
2035 /* Build the font spec that matches all charsets. */
2036 len = p - base_fontname + strlen (allcs) + 1;
2037 font_allcs = (char *) alloca (len);
2038 bzero (font_allcs, len);
2039 bcopy (base_fontname, font_allcs, p - base_fontname);
2040 strcat (font_allcs, allcs);
2042 /* Build the font spec that matches all families and
2043 add-styles. */
2044 len = p - p1 + strlen (allcs) + strlen (allfamilies) + 1;
2045 font_allfamilies = (char *) alloca (len);
2046 bzero (font_allfamilies, len);
2047 strcpy (font_allfamilies, allfamilies);
2048 bcopy (p1, font_allfamilies + strlen (allfamilies), p - p1);
2049 strcat (font_allfamilies, allcs);
2051 /* Build the font spec that matches all. */
2052 len = p - p2 + strlen (allcs) + strlen (all) + strlen (allfamilies) + 1;
2053 font_all = (char *) alloca (len);
2054 bzero (font_all, len);
2055 strcpy (font_all, allfamilies);
2056 strcat (font_all, all);
2057 bcopy (p2, font_all + strlen (all) + strlen (allfamilies), p - p2);
2058 strcat (font_all, allcs);
2060 /* Build the actual font set name. */
2061 len = strlen (base_fontname) + strlen (font_allcs)
2062 + strlen (font_allfamilies) + strlen (font_all) + 5;
2063 fontsetname = xmalloc (len);
2064 bzero (fontsetname, len);
2065 strcpy (fontsetname, base_fontname);
2066 strcat (fontsetname, sep);
2067 strcat (fontsetname, font_allcs);
2068 strcat (fontsetname, sep);
2069 strcat (fontsetname, font_allfamilies);
2070 strcat (fontsetname, sep);
2071 strcat (fontsetname, font_all);
2074 if (motif)
2075 strcat (fontsetname, ":");
2076 return fontsetname;
2079 #ifdef DEBUG_XIC_FONTSET
2080 static void
2081 print_fontset_result (xfs, name, missing_list, missing_count)
2082 XFontSet xfs;
2083 char *name;
2084 char **missing_list;
2085 int missing_count;
2087 if (xfs)
2088 fprintf (stderr, "XIC Fontset created: %s\n", name);
2089 else
2091 fprintf (stderr, "XIC Fontset failed: %s\n", name);
2092 while (missing_count-- > 0)
2094 fprintf (stderr, " missing: %s\n", *missing_list);
2095 missing_list++;
2100 #endif
2102 static XFontSet
2103 xic_create_xfontset (f)
2104 struct frame *f;
2106 XFontSet xfs = NULL;
2107 struct font *font = FRAME_FONT (f);
2108 int pixel_size = font->pixel_size;
2109 Lisp_Object rest, frame;
2111 /* See if there is another frame already using same fontset. */
2112 FOR_EACH_FRAME (rest, frame)
2114 struct frame *cf = XFRAME (frame);
2116 if (cf != f && FRAME_LIVE_P (f) && FRAME_X_P (cf)
2117 && FRAME_X_DISPLAY_INFO (cf) == FRAME_X_DISPLAY_INFO (f)
2118 && FRAME_FONT (f)
2119 && FRAME_FONT (f)->pixel_size == pixel_size)
2121 xfs = FRAME_XIC_FONTSET (cf);
2122 break;
2126 if (! xfs)
2128 char buf[256];
2129 char **missing_list;
2130 int missing_count;
2131 char *def_string;
2132 char *xlfd_format = "-*-*-medium-r-normal--%d-*-*-*-*-*";
2134 sprintf (buf, xlfd_format, pixel_size);
2135 missing_list = NULL;
2136 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), buf,
2137 &missing_list, &missing_count, &def_string);
2138 #ifdef DEBUG_XIC_FONTSET
2139 print_fontset_result (xfs, buf, missing_list, missing_count);
2140 #endif
2141 if (missing_list)
2142 XFreeStringList (missing_list);
2143 if (! xfs)
2145 /* List of pixel sizes most likely available. Find one that
2146 is closest to pixel_size. */
2147 int sizes[] = {0, 8, 10, 11, 12, 14, 17, 18, 20, 24, 26, 34, 0};
2148 int *smaller, *larger;
2150 for (smaller = sizes; smaller[1]; smaller++)
2151 if (smaller[1] >= pixel_size)
2152 break;
2153 larger = smaller + 1;
2154 if (*larger == pixel_size)
2155 larger++;
2156 while (*smaller || *larger)
2158 int this_size;
2160 if (! *larger)
2161 this_size = *smaller--;
2162 else if (! *smaller)
2163 this_size = *larger++;
2164 else if (pixel_size - *smaller < *larger - pixel_size)
2165 this_size = *smaller--;
2166 else
2167 this_size = *larger++;
2168 sprintf (buf, xlfd_format, this_size);
2169 missing_list = NULL;
2170 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), buf,
2171 &missing_list, &missing_count, &def_string);
2172 #ifdef DEBUG_XIC_FONTSET
2173 print_fontset_result (xfs, buf, missing_list, missing_count);
2174 #endif
2175 if (missing_list)
2176 XFreeStringList (missing_list);
2177 if (xfs)
2178 break;
2181 if (! xfs)
2183 char *last_resort = "-*-*-*-r-normal--*-*-*-*-*-*";
2185 missing_list = NULL;
2186 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), last_resort,
2187 &missing_list, &missing_count, &def_string);
2188 #ifdef DEBUG_XIC_FONTSET
2189 print_fontset_result (xfs, last_resort, missing_list, missing_count);
2190 #endif
2191 if (missing_list)
2192 XFreeStringList (missing_list);
2197 return xfs;
2200 /* Free the X fontset of frame F if it is the last frame using it. */
2202 void
2203 xic_free_xfontset (f)
2204 struct frame *f;
2206 Lisp_Object rest, frame;
2207 int shared_p = 0;
2209 if (!FRAME_XIC_FONTSET (f))
2210 return;
2212 /* See if there is another frame sharing the same fontset. */
2213 FOR_EACH_FRAME (rest, frame)
2215 struct frame *cf = XFRAME (frame);
2216 if (cf != f && FRAME_LIVE_P (f) && FRAME_X_P (cf)
2217 && FRAME_X_DISPLAY_INFO (cf) == FRAME_X_DISPLAY_INFO (f)
2218 && FRAME_XIC_FONTSET (cf) == FRAME_XIC_FONTSET (f))
2220 shared_p = 1;
2221 break;
2225 if (!shared_p)
2226 /* The fontset is not used anymore. It is safe to free it. */
2227 XFreeFontSet (FRAME_X_DISPLAY (f), FRAME_XIC_FONTSET (f));
2229 if (FRAME_XIC_BASE_FONTNAME (f))
2230 xfree (FRAME_XIC_BASE_FONTNAME (f));
2231 FRAME_XIC_BASE_FONTNAME (f) = NULL;
2232 FRAME_XIC_FONTSET (f) = NULL;
2236 /* Value is the best input style, given user preferences USER (already
2237 checked to be supported by Emacs), and styles supported by the
2238 input method XIM. */
2240 static XIMStyle
2241 best_xim_style (user, xim)
2242 XIMStyles *user;
2243 XIMStyles *xim;
2245 int i, j;
2247 for (i = 0; i < user->count_styles; ++i)
2248 for (j = 0; j < xim->count_styles; ++j)
2249 if (user->supported_styles[i] == xim->supported_styles[j])
2250 return user->supported_styles[i];
2252 /* Return the default style. */
2253 return XIMPreeditNothing | XIMStatusNothing;
2256 /* Create XIC for frame F. */
2258 static XIMStyle xic_style;
2260 void
2261 create_frame_xic (f)
2262 struct frame *f;
2264 XIM xim;
2265 XIC xic = NULL;
2266 XFontSet xfs = NULL;
2268 if (FRAME_XIC (f))
2269 return;
2271 /* Create X fontset. */
2272 xfs = xic_create_xfontset (f);
2273 xim = FRAME_X_XIM (f);
2274 if (xim)
2276 XRectangle s_area;
2277 XPoint spot;
2278 XVaNestedList preedit_attr;
2279 XVaNestedList status_attr;
2281 s_area.x = 0; s_area.y = 0; s_area.width = 1; s_area.height = 1;
2282 spot.x = 0; spot.y = 1;
2284 /* Determine XIC style. */
2285 if (xic_style == 0)
2287 XIMStyles supported_list;
2288 supported_list.count_styles = (sizeof supported_xim_styles
2289 / sizeof supported_xim_styles[0]);
2290 supported_list.supported_styles = supported_xim_styles;
2291 xic_style = best_xim_style (&supported_list,
2292 FRAME_X_XIM_STYLES (f));
2295 preedit_attr = XVaCreateNestedList (0,
2296 XNFontSet, xfs,
2297 XNForeground,
2298 FRAME_FOREGROUND_PIXEL (f),
2299 XNBackground,
2300 FRAME_BACKGROUND_PIXEL (f),
2301 (xic_style & XIMPreeditPosition
2302 ? XNSpotLocation
2303 : NULL),
2304 &spot,
2305 NULL);
2306 status_attr = XVaCreateNestedList (0,
2307 XNArea,
2308 &s_area,
2309 XNFontSet,
2310 xfs,
2311 XNForeground,
2312 FRAME_FOREGROUND_PIXEL (f),
2313 XNBackground,
2314 FRAME_BACKGROUND_PIXEL (f),
2315 NULL);
2317 xic = XCreateIC (xim,
2318 XNInputStyle, xic_style,
2319 XNClientWindow, FRAME_X_WINDOW (f),
2320 XNFocusWindow, FRAME_X_WINDOW (f),
2321 XNStatusAttributes, status_attr,
2322 XNPreeditAttributes, preedit_attr,
2323 NULL);
2324 XFree (preedit_attr);
2325 XFree (status_attr);
2328 FRAME_XIC (f) = xic;
2329 FRAME_XIC_STYLE (f) = xic_style;
2330 FRAME_XIC_FONTSET (f) = xfs;
2334 /* Destroy XIC and free XIC fontset of frame F, if any. */
2336 void
2337 free_frame_xic (f)
2338 struct frame *f;
2340 if (FRAME_XIC (f) == NULL)
2341 return;
2343 XDestroyIC (FRAME_XIC (f));
2344 xic_free_xfontset (f);
2346 FRAME_XIC (f) = NULL;
2350 /* Place preedit area for XIC of window W's frame to specified
2351 pixel position X/Y. X and Y are relative to window W. */
2353 void
2354 xic_set_preeditarea (w, x, y)
2355 struct window *w;
2356 int x, y;
2358 struct frame *f = XFRAME (w->frame);
2359 XVaNestedList attr;
2360 XPoint spot;
2362 spot.x = WINDOW_TO_FRAME_PIXEL_X (w, x) + WINDOW_LEFT_FRINGE_WIDTH (w);
2363 spot.y = WINDOW_TO_FRAME_PIXEL_Y (w, y) + FONT_BASE (FRAME_FONT (f));
2364 attr = XVaCreateNestedList (0, XNSpotLocation, &spot, NULL);
2365 XSetICValues (FRAME_XIC (f), XNPreeditAttributes, attr, NULL);
2366 XFree (attr);
2370 /* Place status area for XIC in bottom right corner of frame F.. */
2372 void
2373 xic_set_statusarea (f)
2374 struct frame *f;
2376 XIC xic = FRAME_XIC (f);
2377 XVaNestedList attr;
2378 XRectangle area;
2379 XRectangle *needed;
2381 /* Negotiate geometry of status area. If input method has existing
2382 status area, use its current size. */
2383 area.x = area.y = area.width = area.height = 0;
2384 attr = XVaCreateNestedList (0, XNAreaNeeded, &area, NULL);
2385 XSetICValues (xic, XNStatusAttributes, attr, NULL);
2386 XFree (attr);
2388 attr = XVaCreateNestedList (0, XNAreaNeeded, &needed, NULL);
2389 XGetICValues (xic, XNStatusAttributes, attr, NULL);
2390 XFree (attr);
2392 if (needed->width == 0) /* Use XNArea instead of XNAreaNeeded */
2394 attr = XVaCreateNestedList (0, XNArea, &needed, NULL);
2395 XGetICValues (xic, XNStatusAttributes, attr, NULL);
2396 XFree (attr);
2399 area.width = needed->width;
2400 area.height = needed->height;
2401 area.x = FRAME_PIXEL_WIDTH (f) - area.width - FRAME_INTERNAL_BORDER_WIDTH (f);
2402 area.y = (FRAME_PIXEL_HEIGHT (f) - area.height
2403 - FRAME_MENUBAR_HEIGHT (f)
2404 - FRAME_TOOLBAR_HEIGHT (f)
2405 - FRAME_INTERNAL_BORDER_WIDTH (f));
2406 XFree (needed);
2408 attr = XVaCreateNestedList (0, XNArea, &area, NULL);
2409 XSetICValues (xic, XNStatusAttributes, attr, NULL);
2410 XFree (attr);
2414 /* Set X fontset for XIC of frame F, using base font name
2415 BASE_FONTNAME. Called when a new Emacs fontset is chosen. */
2417 void
2418 xic_set_xfontset (f, base_fontname)
2419 struct frame *f;
2420 char *base_fontname;
2422 XVaNestedList attr;
2423 XFontSet xfs;
2425 xic_free_xfontset (f);
2427 xfs = xic_create_xfontset (f);
2429 attr = XVaCreateNestedList (0, XNFontSet, xfs, NULL);
2430 if (FRAME_XIC_STYLE (f) & XIMPreeditPosition)
2431 XSetICValues (FRAME_XIC (f), XNPreeditAttributes, attr, NULL);
2432 if (FRAME_XIC_STYLE (f) & XIMStatusArea)
2433 XSetICValues (FRAME_XIC (f), XNStatusAttributes, attr, NULL);
2434 XFree (attr);
2436 FRAME_XIC_FONTSET (f) = xfs;
2439 #endif /* HAVE_X_I18N */
2443 #ifdef USE_X_TOOLKIT
2445 /* Create and set up the X widget for frame F. */
2447 static void
2448 x_window (f, window_prompting, minibuffer_only)
2449 struct frame *f;
2450 long window_prompting;
2451 int minibuffer_only;
2453 XClassHint class_hints;
2454 XSetWindowAttributes attributes;
2455 unsigned long attribute_mask;
2456 Widget shell_widget;
2457 Widget pane_widget;
2458 Widget frame_widget;
2459 Arg al [25];
2460 int ac;
2462 BLOCK_INPUT;
2464 /* Use the resource name as the top-level widget name
2465 for looking up resources. Make a non-Lisp copy
2466 for the window manager, so GC relocation won't bother it.
2468 Elsewhere we specify the window name for the window manager. */
2471 char *str = (char *) SDATA (Vx_resource_name);
2472 f->namebuf = (char *) xmalloc (strlen (str) + 1);
2473 strcpy (f->namebuf, str);
2476 ac = 0;
2477 XtSetArg (al[ac], XtNallowShellResize, 1); ac++;
2478 XtSetArg (al[ac], XtNinput, 1); ac++;
2479 XtSetArg (al[ac], XtNmappedWhenManaged, 0); ac++;
2480 XtSetArg (al[ac], XtNborderWidth, f->border_width); ac++;
2481 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2482 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2483 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2484 shell_widget = XtAppCreateShell (f->namebuf, EMACS_CLASS,
2485 applicationShellWidgetClass,
2486 FRAME_X_DISPLAY (f), al, ac);
2488 f->output_data.x->widget = shell_widget;
2489 /* maybe_set_screen_title_format (shell_widget); */
2491 pane_widget = lw_create_widget ("main", "pane", widget_id_tick++,
2492 (widget_value *) NULL,
2493 shell_widget, False,
2494 (lw_callback) NULL,
2495 (lw_callback) NULL,
2496 (lw_callback) NULL,
2497 (lw_callback) NULL);
2499 ac = 0;
2500 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2501 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2502 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2503 XtSetValues (pane_widget, al, ac);
2504 f->output_data.x->column_widget = pane_widget;
2506 /* mappedWhenManaged to false tells to the paned window to not map/unmap
2507 the emacs screen when changing menubar. This reduces flickering. */
2509 ac = 0;
2510 XtSetArg (al[ac], XtNmappedWhenManaged, 0); ac++;
2511 XtSetArg (al[ac], XtNshowGrip, 0); ac++;
2512 XtSetArg (al[ac], XtNallowResize, 1); ac++;
2513 XtSetArg (al[ac], XtNresizeToPreferred, 1); ac++;
2514 XtSetArg (al[ac], XtNemacsFrame, f); ac++;
2515 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2516 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2517 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2518 frame_widget = XtCreateWidget (f->namebuf, emacsFrameClass, pane_widget,
2519 al, ac);
2521 f->output_data.x->edit_widget = frame_widget;
2523 XtManageChild (frame_widget);
2525 /* Do some needed geometry management. */
2527 int len;
2528 char *tem, shell_position[32];
2529 Arg al[10];
2530 int ac = 0;
2531 int extra_borders = 0;
2532 int menubar_size
2533 = (f->output_data.x->menubar_widget
2534 ? (f->output_data.x->menubar_widget->core.height
2535 + f->output_data.x->menubar_widget->core.border_width)
2536 : 0);
2538 #if 0 /* Experimentally, we now get the right results
2539 for -geometry -0-0 without this. 24 Aug 96, rms. */
2540 if (FRAME_EXTERNAL_MENU_BAR (f))
2542 Dimension ibw = 0;
2543 XtVaGetValues (pane_widget, XtNinternalBorderWidth, &ibw, NULL);
2544 menubar_size += ibw;
2546 #endif
2548 f->output_data.x->menubar_height = menubar_size;
2550 #ifndef USE_LUCID
2551 /* Motif seems to need this amount added to the sizes
2552 specified for the shell widget. The Athena/Lucid widgets don't.
2553 Both conclusions reached experimentally. -- rms. */
2554 XtVaGetValues (f->output_data.x->edit_widget, XtNinternalBorderWidth,
2555 &extra_borders, NULL);
2556 extra_borders *= 2;
2557 #endif
2559 /* Convert our geometry parameters into a geometry string
2560 and specify it.
2561 Note that we do not specify here whether the position
2562 is a user-specified or program-specified one.
2563 We pass that information later, in x_wm_set_size_hints. */
2565 int left = f->left_pos;
2566 int xneg = window_prompting & XNegative;
2567 int top = f->top_pos;
2568 int yneg = window_prompting & YNegative;
2569 if (xneg)
2570 left = -left;
2571 if (yneg)
2572 top = -top;
2574 if (window_prompting & USPosition)
2575 sprintf (shell_position, "=%dx%d%c%d%c%d",
2576 FRAME_PIXEL_WIDTH (f) + extra_borders,
2577 FRAME_PIXEL_HEIGHT (f) + menubar_size + extra_borders,
2578 (xneg ? '-' : '+'), left,
2579 (yneg ? '-' : '+'), top);
2580 else
2582 sprintf (shell_position, "=%dx%d",
2583 FRAME_PIXEL_WIDTH (f) + extra_borders,
2584 FRAME_PIXEL_HEIGHT (f) + menubar_size + extra_borders);
2586 /* Setting x and y when the position is not specified in
2587 the geometry string will set program position in the WM hints.
2588 If Emacs had just one program position, we could set it in
2589 fallback resources, but since each make-frame call can specify
2590 different program positions, this is easier. */
2591 XtSetArg (al[ac], XtNx, left); ac++;
2592 XtSetArg (al[ac], XtNy, top); ac++;
2596 len = strlen (shell_position) + 1;
2597 /* We don't free this because we don't know whether
2598 it is safe to free it while the frame exists.
2599 It isn't worth the trouble of arranging to free it
2600 when the frame is deleted. */
2601 tem = (char *) xmalloc (len);
2602 strncpy (tem, shell_position, len);
2603 XtSetArg (al[ac], XtNgeometry, tem); ac++;
2604 XtSetValues (shell_widget, al, ac);
2607 XtManageChild (pane_widget);
2608 XtRealizeWidget (shell_widget);
2610 if (FRAME_X_EMBEDDED_P (f))
2611 XReparentWindow (FRAME_X_DISPLAY (f), XtWindow (shell_widget),
2612 f->output_data.x->parent_desc, 0, 0);
2614 FRAME_X_WINDOW (f) = XtWindow (frame_widget);
2616 validate_x_resource_name ();
2618 class_hints.res_name = (char *) SDATA (Vx_resource_name);
2619 class_hints.res_class = (char *) SDATA (Vx_resource_class);
2620 XSetClassHint (FRAME_X_DISPLAY (f), XtWindow (shell_widget), &class_hints);
2622 #ifdef HAVE_X_I18N
2623 FRAME_XIC (f) = NULL;
2624 if (use_xim)
2625 create_frame_xic (f);
2626 #endif
2628 f->output_data.x->wm_hints.input = True;
2629 f->output_data.x->wm_hints.flags |= InputHint;
2630 XSetWMHints (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2631 &f->output_data.x->wm_hints);
2633 hack_wm_protocols (f, shell_widget);
2635 #ifdef HACK_EDITRES
2636 XtAddEventHandler (shell_widget, 0, True, _XEditResCheckMessages, 0);
2637 #endif
2639 /* Do a stupid property change to force the server to generate a
2640 PropertyNotify event so that the event_stream server timestamp will
2641 be initialized to something relevant to the time we created the window.
2643 XChangeProperty (XtDisplay (frame_widget), XtWindow (frame_widget),
2644 FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
2645 XA_ATOM, 32, PropModeAppend,
2646 (unsigned char*) NULL, 0);
2648 /* Make all the standard events reach the Emacs frame. */
2649 attributes.event_mask = STANDARD_EVENT_SET;
2651 #ifdef HAVE_X_I18N
2652 if (FRAME_XIC (f))
2654 /* XIM server might require some X events. */
2655 unsigned long fevent = NoEventMask;
2656 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2657 attributes.event_mask |= fevent;
2659 #endif /* HAVE_X_I18N */
2661 attribute_mask = CWEventMask;
2662 XChangeWindowAttributes (XtDisplay (shell_widget), XtWindow (shell_widget),
2663 attribute_mask, &attributes);
2665 XtMapWidget (frame_widget);
2667 /* x_set_name normally ignores requests to set the name if the
2668 requested name is the same as the current name. This is the one
2669 place where that assumption isn't correct; f->name is set, but
2670 the X server hasn't been told. */
2672 Lisp_Object name;
2673 int explicit = f->explicit_name;
2675 f->explicit_name = 0;
2676 name = f->name;
2677 f->name = Qnil;
2678 x_set_name (f, name, explicit);
2681 XDefineCursor (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2682 f->output_data.x->text_cursor);
2684 UNBLOCK_INPUT;
2686 /* This is a no-op, except under Motif. Make sure main areas are
2687 set to something reasonable, in case we get an error later. */
2688 lw_set_main_areas (pane_widget, 0, frame_widget);
2691 #else /* not USE_X_TOOLKIT */
2692 #ifdef USE_GTK
2693 void
2694 x_window (f)
2695 FRAME_PTR f;
2697 if (! xg_create_frame_widgets (f))
2698 error ("Unable to create window");
2700 #ifdef HAVE_X_I18N
2701 FRAME_XIC (f) = NULL;
2702 if (use_xim)
2704 BLOCK_INPUT;
2705 create_frame_xic (f);
2706 if (FRAME_XIC (f))
2708 /* XIM server might require some X events. */
2709 unsigned long fevent = NoEventMask;
2710 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2712 if (fevent != NoEventMask)
2714 XSetWindowAttributes attributes;
2715 XWindowAttributes wattr;
2716 unsigned long attribute_mask;
2718 XGetWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2719 &wattr);
2720 attributes.event_mask = wattr.your_event_mask | fevent;
2721 attribute_mask = CWEventMask;
2722 XChangeWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2723 attribute_mask, &attributes);
2726 UNBLOCK_INPUT;
2728 #endif
2731 #else /*! USE_GTK */
2732 /* Create and set up the X window for frame F. */
2734 void
2735 x_window (f)
2736 struct frame *f;
2739 XClassHint class_hints;
2740 XSetWindowAttributes attributes;
2741 unsigned long attribute_mask;
2743 attributes.background_pixel = FRAME_BACKGROUND_PIXEL (f);
2744 attributes.border_pixel = f->output_data.x->border_pixel;
2745 attributes.bit_gravity = StaticGravity;
2746 attributes.backing_store = NotUseful;
2747 attributes.save_under = True;
2748 attributes.event_mask = STANDARD_EVENT_SET;
2749 attributes.colormap = FRAME_X_COLORMAP (f);
2750 attribute_mask = (CWBackPixel | CWBorderPixel | CWBitGravity | CWEventMask
2751 | CWColormap);
2753 BLOCK_INPUT;
2754 FRAME_X_WINDOW (f)
2755 = XCreateWindow (FRAME_X_DISPLAY (f),
2756 f->output_data.x->parent_desc,
2757 f->left_pos,
2758 f->top_pos,
2759 FRAME_PIXEL_WIDTH (f), FRAME_PIXEL_HEIGHT (f),
2760 f->border_width,
2761 CopyFromParent, /* depth */
2762 InputOutput, /* class */
2763 FRAME_X_VISUAL (f),
2764 attribute_mask, &attributes);
2766 #ifdef HAVE_X_I18N
2767 if (use_xim)
2769 create_frame_xic (f);
2770 if (FRAME_XIC (f))
2772 /* XIM server might require some X events. */
2773 unsigned long fevent = NoEventMask;
2774 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2775 attributes.event_mask |= fevent;
2776 attribute_mask = CWEventMask;
2777 XChangeWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2778 attribute_mask, &attributes);
2781 #endif /* HAVE_X_I18N */
2783 validate_x_resource_name ();
2785 class_hints.res_name = (char *) SDATA (Vx_resource_name);
2786 class_hints.res_class = (char *) SDATA (Vx_resource_class);
2787 XSetClassHint (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), &class_hints);
2789 /* The menubar is part of the ordinary display;
2790 it does not count in addition to the height of the window. */
2791 f->output_data.x->menubar_height = 0;
2793 /* This indicates that we use the "Passive Input" input model.
2794 Unless we do this, we don't get the Focus{In,Out} events that we
2795 need to draw the cursor correctly. Accursed bureaucrats.
2796 XWhipsAndChains (FRAME_X_DISPLAY (f), IronMaiden, &TheRack); */
2798 f->output_data.x->wm_hints.input = True;
2799 f->output_data.x->wm_hints.flags |= InputHint;
2800 XSetWMHints (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2801 &f->output_data.x->wm_hints);
2802 f->output_data.x->wm_hints.icon_pixmap = None;
2804 /* Request "save yourself" and "delete window" commands from wm. */
2806 Atom protocols[2];
2807 protocols[0] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window;
2808 protocols[1] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself;
2809 XSetWMProtocols (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), protocols, 2);
2812 /* x_set_name normally ignores requests to set the name if the
2813 requested name is the same as the current name. This is the one
2814 place where that assumption isn't correct; f->name is set, but
2815 the X server hasn't been told. */
2817 Lisp_Object name;
2818 int explicit = f->explicit_name;
2820 f->explicit_name = 0;
2821 name = f->name;
2822 f->name = Qnil;
2823 x_set_name (f, name, explicit);
2826 XDefineCursor (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2827 f->output_data.x->text_cursor);
2829 UNBLOCK_INPUT;
2831 if (FRAME_X_WINDOW (f) == 0)
2832 error ("Unable to create window");
2835 #endif /* not USE_GTK */
2836 #endif /* not USE_X_TOOLKIT */
2838 /* Verify that the icon position args for this window are valid. */
2840 static void
2841 x_icon_verify (f, parms)
2842 struct frame *f;
2843 Lisp_Object parms;
2845 Lisp_Object icon_x, icon_y;
2847 /* Set the position of the icon. Note that twm groups all
2848 icons in an icon window. */
2849 icon_x = x_frame_get_and_record_arg (f, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
2850 icon_y = x_frame_get_and_record_arg (f, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
2851 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
2853 CHECK_NUMBER (icon_x);
2854 CHECK_NUMBER (icon_y);
2856 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
2857 error ("Both left and top icon corners of icon must be specified");
2860 /* Handle the icon stuff for this window. Perhaps later we might
2861 want an x_set_icon_position which can be called interactively as
2862 well. */
2864 static void
2865 x_icon (f, parms)
2866 struct frame *f;
2867 Lisp_Object parms;
2869 Lisp_Object icon_x, icon_y;
2870 #if 0
2871 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
2872 #endif
2874 /* Set the position of the icon. Note that twm groups all
2875 icons in an icon window. */
2876 icon_x = x_frame_get_and_record_arg (f, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
2877 icon_y = x_frame_get_and_record_arg (f, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
2878 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
2880 CHECK_NUMBER (icon_x);
2881 CHECK_NUMBER (icon_y);
2883 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
2884 error ("Both left and top icon corners of icon must be specified");
2886 BLOCK_INPUT;
2888 if (! EQ (icon_x, Qunbound))
2889 x_wm_set_icon_position (f, XINT (icon_x), XINT (icon_y));
2891 #if 0 /* x_get_arg removes the visibility parameter as a side effect,
2892 but x_create_frame still needs it. */
2893 /* Start up iconic or window? */
2894 x_wm_set_window_state
2895 (f, (EQ (x_get_arg (dpyinfo, parms, Qvisibility, 0, 0, RES_TYPE_SYMBOL),
2896 Qicon)
2897 ? IconicState
2898 : NormalState));
2899 #endif
2901 x_text_icon (f, (char *) SDATA ((!NILP (f->icon_name)
2902 ? f->icon_name
2903 : f->name)));
2905 UNBLOCK_INPUT;
2908 /* Make the GCs needed for this window, setting the
2909 background, border and mouse colors; also create the
2910 mouse cursor and the gray border tile. */
2912 static char cursor_bits[] =
2914 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
2915 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
2916 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
2917 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00
2920 static void
2921 x_make_gc (f)
2922 struct frame *f;
2924 XGCValues gc_values;
2926 BLOCK_INPUT;
2928 /* Create the GCs of this frame.
2929 Note that many default values are used. */
2931 gc_values.foreground = FRAME_FOREGROUND_PIXEL (f);
2932 gc_values.background = FRAME_BACKGROUND_PIXEL (f);
2933 gc_values.line_width = 0; /* Means 1 using fast algorithm. */
2934 f->output_data.x->normal_gc
2935 = XCreateGC (FRAME_X_DISPLAY (f),
2936 FRAME_X_WINDOW (f),
2937 GCLineWidth | GCForeground | GCBackground,
2938 &gc_values);
2940 /* Reverse video style. */
2941 gc_values.foreground = FRAME_BACKGROUND_PIXEL (f);
2942 gc_values.background = FRAME_FOREGROUND_PIXEL (f);
2943 f->output_data.x->reverse_gc
2944 = XCreateGC (FRAME_X_DISPLAY (f),
2945 FRAME_X_WINDOW (f),
2946 GCForeground | GCBackground | GCLineWidth,
2947 &gc_values);
2949 /* Cursor has cursor-color background, background-color foreground. */
2950 gc_values.foreground = FRAME_BACKGROUND_PIXEL (f);
2951 gc_values.background = f->output_data.x->cursor_pixel;
2952 gc_values.fill_style = FillOpaqueStippled;
2953 gc_values.stipple
2954 = XCreateBitmapFromData (FRAME_X_DISPLAY (f),
2955 FRAME_X_DISPLAY_INFO (f)->root_window,
2956 cursor_bits, 16, 16);
2957 f->output_data.x->cursor_gc
2958 = XCreateGC (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2959 (GCForeground | GCBackground
2960 | GCFillStyle /* | GCStipple */ | GCLineWidth),
2961 &gc_values);
2963 /* Reliefs. */
2964 f->output_data.x->white_relief.gc = 0;
2965 f->output_data.x->black_relief.gc = 0;
2967 /* Create the gray border tile used when the pointer is not in
2968 the frame. Since this depends on the frame's pixel values,
2969 this must be done on a per-frame basis. */
2970 f->output_data.x->border_tile
2971 = (XCreatePixmapFromBitmapData
2972 (FRAME_X_DISPLAY (f), FRAME_X_DISPLAY_INFO (f)->root_window,
2973 gray_bits, gray_width, gray_height,
2974 FRAME_FOREGROUND_PIXEL (f),
2975 FRAME_BACKGROUND_PIXEL (f),
2976 DefaultDepth (FRAME_X_DISPLAY (f), FRAME_X_SCREEN_NUMBER (f))));
2978 UNBLOCK_INPUT;
2982 /* Free what was was allocated in x_make_gc. */
2984 void
2985 x_free_gcs (f)
2986 struct frame *f;
2988 Display *dpy = FRAME_X_DISPLAY (f);
2990 BLOCK_INPUT;
2992 if (f->output_data.x->normal_gc)
2994 XFreeGC (dpy, f->output_data.x->normal_gc);
2995 f->output_data.x->normal_gc = 0;
2998 if (f->output_data.x->reverse_gc)
3000 XFreeGC (dpy, f->output_data.x->reverse_gc);
3001 f->output_data.x->reverse_gc = 0;
3004 if (f->output_data.x->cursor_gc)
3006 XFreeGC (dpy, f->output_data.x->cursor_gc);
3007 f->output_data.x->cursor_gc = 0;
3010 if (f->output_data.x->border_tile)
3012 XFreePixmap (dpy, f->output_data.x->border_tile);
3013 f->output_data.x->border_tile = 0;
3016 UNBLOCK_INPUT;
3020 /* Handler for signals raised during x_create_frame and
3021 x_create_top_frame. FRAME is the frame which is partially
3022 constructed. */
3024 static Lisp_Object
3025 unwind_create_frame (frame)
3026 Lisp_Object frame;
3028 struct frame *f = XFRAME (frame);
3030 /* If frame is already dead, nothing to do. This can happen if the
3031 display is disconnected after the frame has become official, but
3032 before x_create_frame removes the unwind protect. */
3033 if (!FRAME_LIVE_P (f))
3034 return Qnil;
3036 /* If frame is ``official'', nothing to do. */
3037 if (!CONSP (Vframe_list) || !EQ (XCAR (Vframe_list), frame))
3039 #if GLYPH_DEBUG
3040 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
3041 #endif
3043 x_free_frame_resources (f);
3045 #if GLYPH_DEBUG
3046 /* Check that reference counts are indeed correct. */
3047 xassert (dpyinfo->reference_count == dpyinfo_refcount);
3048 xassert (dpyinfo->image_cache->refcount == image_cache_refcount);
3049 #endif
3050 return Qt;
3053 return Qnil;
3057 static void
3058 x_default_font_parameter (f, parms)
3059 struct frame *f;
3060 Lisp_Object parms;
3062 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
3063 Lisp_Object font_param = x_get_arg (dpyinfo, parms, Qfont, NULL, NULL,
3064 RES_TYPE_STRING);
3065 Lisp_Object font;
3066 if (EQ (font_param, Qunbound))
3067 font_param = Qnil;
3068 font = !NILP (font_param) ? font_param
3069 : x_get_arg (dpyinfo, parms, Qfont, "font", "Font", RES_TYPE_STRING);
3071 if (! STRINGP (font))
3073 char *names[]
3074 = { "-adobe-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-1",
3075 "-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-1",
3076 /* This will find the normal Xft font. */
3077 "monospace-12",
3078 "-*-*-medium-r-normal-*-*-140-*-*-c-*-iso8859-1",
3079 /* This was formerly the first thing tried, but it finds
3080 too many fonts and takes too long. */
3081 "-*-*-medium-r-*-*-*-*-*-*-c-*-iso8859-1",
3082 /* If those didn't work, look for something which will
3083 at least work. */
3084 "-*-fixed-*-*-*-*-*-140-*-*-c-*-iso8859-1",
3085 "fixed",
3086 NULL };
3087 int i;
3089 for (i = 0; names[i]; i++)
3091 font = font_open_by_name (f, names[i]);
3092 if (! NILP (font))
3093 break;
3095 if (NILP (font))
3096 error ("No suitable font was found");
3098 else if (!NILP (font_param))
3100 /* Remember the explicit font parameter, so we can re-apply it after
3101 we've applied the `default' face settings. */
3102 x_set_frame_parameters (f, Fcons (Fcons (Qfont_param, font_param), Qnil));
3104 x_default_parameter (f, parms, Qfont, font, "font", "Font", RES_TYPE_STRING);
3108 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
3109 1, 1, 0,
3110 doc: /* Make a new X window, which is called a "frame" in Emacs terms.
3111 Return an Emacs frame object.
3112 ALIST is an alist of frame parameters.
3113 If the parameters specify that the frame should not have a minibuffer,
3114 and do not specify a specific minibuffer window to use,
3115 then `default-minibuffer-frame' must be a frame whose minibuffer can
3116 be shared by the new frame.
3118 This function is an internal primitive--use `make-frame' instead. */)
3119 (parms)
3120 Lisp_Object parms;
3122 struct frame *f;
3123 Lisp_Object frame, tem;
3124 Lisp_Object name;
3125 int minibuffer_only = 0;
3126 long window_prompting = 0;
3127 int width, height;
3128 int count = SPECPDL_INDEX ();
3129 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
3130 Lisp_Object display;
3131 struct x_display_info *dpyinfo = NULL;
3132 Lisp_Object parent;
3133 struct kboard *kb;
3135 parms = Fcopy_alist (parms);
3137 /* Use this general default value to start with
3138 until we know if this frame has a specified name. */
3139 Vx_resource_name = Vinvocation_name;
3141 display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_NUMBER);
3142 if (EQ (display, Qunbound))
3143 display = x_get_arg (dpyinfo, parms, Qdisplay, 0, 0, RES_TYPE_STRING);
3144 if (EQ (display, Qunbound))
3145 display = Qnil;
3146 dpyinfo = check_x_display_info (display);
3147 #ifdef MULTI_KBOARD
3148 kb = dpyinfo->terminal->kboard;
3149 #else
3150 kb = &the_only_kboard;
3151 #endif
3153 if (!dpyinfo->terminal->name)
3154 error ("Terminal is not live, can't create new frames on it");
3156 name = x_get_arg (dpyinfo, parms, Qname, "name", "Name", RES_TYPE_STRING);
3157 if (!STRINGP (name)
3158 && ! EQ (name, Qunbound)
3159 && ! NILP (name))
3160 error ("Invalid frame name--not a string or nil");
3162 if (STRINGP (name))
3163 Vx_resource_name = name;
3165 /* See if parent window is specified. */
3166 parent = x_get_arg (dpyinfo, parms, Qparent_id, NULL, NULL, RES_TYPE_NUMBER);
3167 if (EQ (parent, Qunbound))
3168 parent = Qnil;
3169 if (! NILP (parent))
3170 CHECK_NUMBER (parent);
3172 /* make_frame_without_minibuffer can run Lisp code and garbage collect. */
3173 /* No need to protect DISPLAY because that's not used after passing
3174 it to make_frame_without_minibuffer. */
3175 frame = Qnil;
3176 GCPRO4 (parms, parent, name, frame);
3177 tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
3178 RES_TYPE_SYMBOL);
3179 if (EQ (tem, Qnone) || NILP (tem))
3180 f = make_frame_without_minibuffer (Qnil, kb, display);
3181 else if (EQ (tem, Qonly))
3183 f = make_minibuffer_frame ();
3184 minibuffer_only = 1;
3186 else if (WINDOWP (tem))
3187 f = make_frame_without_minibuffer (tem, kb, display);
3188 else
3189 f = make_frame (1);
3191 XSETFRAME (frame, f);
3193 /* Note that X Windows does support scroll bars. */
3194 FRAME_CAN_HAVE_SCROLL_BARS (f) = 1;
3196 f->terminal = dpyinfo->terminal;
3197 f->terminal->reference_count++;
3199 f->output_method = output_x_window;
3200 f->output_data.x = (struct x_output *) xmalloc (sizeof (struct x_output));
3201 bzero (f->output_data.x, sizeof (struct x_output));
3202 f->output_data.x->icon_bitmap = -1;
3203 FRAME_FONTSET (f) = -1;
3204 f->output_data.x->scroll_bar_foreground_pixel = -1;
3205 f->output_data.x->scroll_bar_background_pixel = -1;
3206 #ifdef USE_TOOLKIT_SCROLL_BARS
3207 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
3208 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
3209 #endif /* USE_TOOLKIT_SCROLL_BARS */
3211 f->icon_name
3212 = x_get_arg (dpyinfo, parms, Qicon_name, "iconName", "Title",
3213 RES_TYPE_STRING);
3214 if (! STRINGP (f->icon_name))
3215 f->icon_name = Qnil;
3217 FRAME_X_DISPLAY_INFO (f) = dpyinfo;
3219 /* With FRAME_X_DISPLAY_INFO set up, this unwind-protect is safe. */
3220 record_unwind_protect (unwind_create_frame, frame);
3221 #if GLYPH_DEBUG
3222 image_cache_refcount = FRAME_IMAGE_CACHE (f)->refcount;
3223 dpyinfo_refcount = dpyinfo->reference_count;
3224 #endif /* GLYPH_DEBUG */
3226 /* These colors will be set anyway later, but it's important
3227 to get the color reference counts right, so initialize them! */
3229 Lisp_Object black;
3230 struct gcpro gcpro1;
3232 /* Function x_decode_color can signal an error. Make
3233 sure to initialize color slots so that we won't try
3234 to free colors we haven't allocated. */
3235 FRAME_FOREGROUND_PIXEL (f) = -1;
3236 FRAME_BACKGROUND_PIXEL (f) = -1;
3237 f->output_data.x->cursor_pixel = -1;
3238 f->output_data.x->cursor_foreground_pixel = -1;
3239 f->output_data.x->border_pixel = -1;
3240 f->output_data.x->mouse_pixel = -1;
3242 black = build_string ("black");
3243 GCPRO1 (black);
3244 FRAME_FOREGROUND_PIXEL (f)
3245 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3246 FRAME_BACKGROUND_PIXEL (f)
3247 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3248 f->output_data.x->cursor_pixel
3249 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3250 f->output_data.x->cursor_foreground_pixel
3251 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3252 f->output_data.x->border_pixel
3253 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3254 f->output_data.x->mouse_pixel
3255 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3256 UNGCPRO;
3259 /* Specify the parent under which to make this X window. */
3261 if (!NILP (parent))
3263 f->output_data.x->parent_desc = (Window) XFASTINT (parent);
3264 f->output_data.x->explicit_parent = 1;
3266 else
3268 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
3269 f->output_data.x->explicit_parent = 0;
3272 /* Set the name; the functions to which we pass f expect the name to
3273 be set. */
3274 if (EQ (name, Qunbound) || NILP (name))
3276 f->name = build_string (dpyinfo->x_id_name);
3277 f->explicit_name = 0;
3279 else
3281 f->name = name;
3282 f->explicit_name = 1;
3283 /* use the frame's title when getting resources for this frame. */
3284 specbind (Qx_resource_name, name);
3287 f->resx = dpyinfo->resx;
3288 f->resy = dpyinfo->resy;
3290 register_font_driver (&xfont_driver, f);
3291 #ifdef HAVE_FREETYPE
3292 #ifdef HAVE_XFT
3293 register_font_driver (&xftfont_driver, f);
3294 #else /* not HAVE_XFT */
3295 register_font_driver (&ftxfont_driver, f);
3296 #endif /* not HAVE_XFT */
3297 #endif /* HAVE_FREETYPE */
3299 x_default_parameter (f, parms, Qfont_backend, Qnil,
3300 "fontBackend", "FontBackend", RES_TYPE_STRING);
3302 /* Extract the window parameters from the supplied values
3303 that are needed to determine window geometry. */
3304 x_default_font_parameter (f, parms);
3306 #ifdef USE_LUCID
3307 /* Prevent lwlib/xlwmenu.c from crashing because of a bug
3308 whereby it fails to get any font. */
3309 xlwmenu_default_font = XLoadQueryFont (FRAME_X_DISPLAY (f), "fixed");
3310 #endif
3312 /* Frame contents get displaced if an embedded X window has a border. */
3313 if (! FRAME_X_EMBEDDED_P (f))
3314 x_default_parameter (f, parms, Qborder_width, make_number (2),
3315 "borderWidth", "BorderWidth", RES_TYPE_NUMBER);
3317 /* This defaults to 1 in order to match xterm. We recognize either
3318 internalBorderWidth or internalBorder (which is what xterm calls
3319 it). */
3320 if (NILP (Fassq (Qinternal_border_width, parms)))
3322 Lisp_Object value;
3324 value = x_get_arg (dpyinfo, parms, Qinternal_border_width,
3325 "internalBorder", "internalBorder", RES_TYPE_NUMBER);
3326 if (! EQ (value, Qunbound))
3327 parms = Fcons (Fcons (Qinternal_border_width, value),
3328 parms);
3330 x_default_parameter (f, parms, Qinternal_border_width,
3331 #ifdef USE_GTK /* We used to impose 0 in xg_create_frame_widgets. */
3332 make_number (0),
3333 #else
3334 make_number (1),
3335 #endif
3336 "internalBorderWidth", "internalBorderWidth",
3337 RES_TYPE_NUMBER);
3338 x_default_parameter (f, parms, Qvertical_scroll_bars, Qleft,
3339 "verticalScrollBars", "ScrollBars",
3340 RES_TYPE_SYMBOL);
3342 /* Also do the stuff which must be set before the window exists. */
3343 x_default_parameter (f, parms, Qforeground_color, build_string ("black"),
3344 "foreground", "Foreground", RES_TYPE_STRING);
3345 x_default_parameter (f, parms, Qbackground_color, build_string ("white"),
3346 "background", "Background", RES_TYPE_STRING);
3347 x_default_parameter (f, parms, Qmouse_color, build_string ("black"),
3348 "pointerColor", "Foreground", RES_TYPE_STRING);
3349 x_default_parameter (f, parms, Qcursor_color, build_string ("black"),
3350 "cursorColor", "Foreground", RES_TYPE_STRING);
3351 x_default_parameter (f, parms, Qborder_color, build_string ("black"),
3352 "borderColor", "BorderColor", RES_TYPE_STRING);
3353 x_default_parameter (f, parms, Qscreen_gamma, Qnil,
3354 "screenGamma", "ScreenGamma", RES_TYPE_FLOAT);
3355 x_default_parameter (f, parms, Qline_spacing, Qnil,
3356 "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
3357 x_default_parameter (f, parms, Qleft_fringe, Qnil,
3358 "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
3359 x_default_parameter (f, parms, Qright_fringe, Qnil,
3360 "rightFringe", "RightFringe", RES_TYPE_NUMBER);
3362 x_default_scroll_bar_color_parameter (f, parms, Qscroll_bar_foreground,
3363 "scrollBarForeground",
3364 "ScrollBarForeground", 1);
3365 x_default_scroll_bar_color_parameter (f, parms, Qscroll_bar_background,
3366 "scrollBarBackground",
3367 "ScrollBarBackground", 0);
3369 /* Init faces before x_default_parameter is called for scroll-bar
3370 parameters because that function calls x_set_scroll_bar_width,
3371 which calls change_frame_size, which calls Fset_window_buffer,
3372 which runs hooks, which call Fvertical_motion. At the end, we
3373 end up in init_iterator with a null face cache, which should not
3374 happen. */
3375 init_frame_faces (f);
3377 x_default_parameter (f, parms, Qmenu_bar_lines, make_number (1),
3378 "menuBar", "MenuBar", RES_TYPE_NUMBER);
3379 x_default_parameter (f, parms, Qtool_bar_lines, make_number (1),
3380 "toolBar", "ToolBar", RES_TYPE_NUMBER);
3381 x_default_parameter (f, parms, Qbuffer_predicate, Qnil,
3382 "bufferPredicate", "BufferPredicate",
3383 RES_TYPE_SYMBOL);
3384 x_default_parameter (f, parms, Qtitle, Qnil,
3385 "title", "Title", RES_TYPE_STRING);
3386 x_default_parameter (f, parms, Qwait_for_wm, Qt,
3387 "waitForWM", "WaitForWM", RES_TYPE_BOOLEAN);
3388 x_default_parameter (f, parms, Qfullscreen, Qnil,
3389 "fullscreen", "Fullscreen", RES_TYPE_SYMBOL);
3391 /* Compute the size of the X window. */
3392 window_prompting = x_figure_window_size (f, parms, 1);
3394 tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
3395 f->no_split = minibuffer_only || EQ (tem, Qt);
3397 x_icon_verify (f, parms);
3399 /* Create the X widget or window. */
3400 #ifdef USE_X_TOOLKIT
3401 x_window (f, window_prompting, minibuffer_only);
3402 #else
3403 x_window (f);
3404 #endif
3406 x_icon (f, parms);
3407 x_make_gc (f);
3409 /* Now consider the frame official. */
3410 FRAME_X_DISPLAY_INFO (f)->reference_count++;
3411 Vframe_list = Fcons (frame, Vframe_list);
3413 /* We need to do this after creating the X window, so that the
3414 icon-creation functions can say whose icon they're describing. */
3415 x_default_parameter (f, parms, Qicon_type, Qt,
3416 "bitmapIcon", "BitmapIcon", RES_TYPE_SYMBOL);
3418 x_default_parameter (f, parms, Qauto_raise, Qnil,
3419 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
3420 x_default_parameter (f, parms, Qauto_lower, Qnil,
3421 "autoLower", "AutoRaiseLower", RES_TYPE_BOOLEAN);
3422 x_default_parameter (f, parms, Qcursor_type, Qbox,
3423 "cursorType", "CursorType", RES_TYPE_SYMBOL);
3424 x_default_parameter (f, parms, Qscroll_bar_width, Qnil,
3425 "scrollBarWidth", "ScrollBarWidth",
3426 RES_TYPE_NUMBER);
3427 x_default_parameter (f, parms, Qalpha, Qnil,
3428 "alpha", "Alpha", RES_TYPE_NUMBER);
3430 /* Dimensions, especially FRAME_LINES (f), must be done via change_frame_size.
3431 Change will not be effected unless different from the current
3432 FRAME_LINES (f). */
3433 width = FRAME_COLS (f);
3434 height = FRAME_LINES (f);
3436 SET_FRAME_COLS (f, 0);
3437 FRAME_LINES (f) = 0;
3438 change_frame_size (f, height, width, 1, 0, 0);
3440 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
3441 /* Create the menu bar. */
3442 if (!minibuffer_only && FRAME_EXTERNAL_MENU_BAR (f))
3444 /* If this signals an error, we haven't set size hints for the
3445 frame and we didn't make it visible. */
3446 initialize_frame_menubar (f);
3448 #ifndef USE_GTK
3449 /* This is a no-op, except under Motif where it arranges the
3450 main window for the widgets on it. */
3451 lw_set_main_areas (f->output_data.x->column_widget,
3452 f->output_data.x->menubar_widget,
3453 f->output_data.x->edit_widget);
3454 #endif /* not USE_GTK */
3456 #endif /* USE_X_TOOLKIT || USE_GTK */
3458 /* Tell the server what size and position, etc, we want, and how
3459 badly we want them. This should be done after we have the menu
3460 bar so that its size can be taken into account. */
3461 BLOCK_INPUT;
3462 x_wm_set_size_hint (f, window_prompting, 0);
3463 UNBLOCK_INPUT;
3465 /* Make the window appear on the frame and enable display, unless
3466 the caller says not to. However, with explicit parent, Emacs
3467 cannot control visibility, so don't try. */
3468 if (! f->output_data.x->explicit_parent)
3470 Lisp_Object visibility;
3472 visibility = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0,
3473 RES_TYPE_SYMBOL);
3474 if (EQ (visibility, Qunbound))
3475 visibility = Qt;
3477 if (EQ (visibility, Qicon))
3478 x_iconify_frame (f);
3479 else if (! NILP (visibility))
3480 x_make_frame_visible (f);
3481 else
3482 /* Must have been Qnil. */
3486 /* Set the WM leader property. GTK does this itself, so this is not
3487 needed when using GTK. */
3488 if (dpyinfo->client_leader_window != 0)
3490 BLOCK_INPUT;
3491 XChangeProperty (FRAME_X_DISPLAY (f),
3492 FRAME_OUTER_WINDOW (f),
3493 dpyinfo->Xatom_wm_client_leader,
3494 XA_WINDOW, 32, PropModeReplace,
3495 (unsigned char *) &dpyinfo->client_leader_window, 1);
3496 UNBLOCK_INPUT;
3499 /* Initialize `default-minibuffer-frame' in case this is the first
3500 frame on this terminal. */
3501 if (FRAME_HAS_MINIBUF_P (f)
3502 && (!FRAMEP (kb->Vdefault_minibuffer_frame)
3503 || !FRAME_LIVE_P (XFRAME (kb->Vdefault_minibuffer_frame))))
3504 kb->Vdefault_minibuffer_frame = frame;
3506 /* All remaining specified parameters, which have not been "used"
3507 by x_get_arg and friends, now go in the misc. alist of the frame. */
3508 for (tem = parms; CONSP (tem); tem = XCDR (tem))
3509 if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
3510 f->param_alist = Fcons (XCAR (tem), f->param_alist);
3512 UNGCPRO;
3514 /* Make sure windows on this frame appear in calls to next-window
3515 and similar functions. */
3516 Vwindow_list = Qnil;
3518 return unbind_to (count, frame);
3522 /* FRAME is used only to get a handle on the X display. We don't pass the
3523 display info directly because we're called from frame.c, which doesn't
3524 know about that structure. */
3526 Lisp_Object
3527 x_get_focus_frame (frame)
3528 struct frame *frame;
3530 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (frame);
3531 Lisp_Object xfocus;
3532 if (! dpyinfo->x_focus_frame)
3533 return Qnil;
3535 XSETFRAME (xfocus, dpyinfo->x_focus_frame);
3536 return xfocus;
3540 /* In certain situations, when the window manager follows a
3541 click-to-focus policy, there seems to be no way around calling
3542 XSetInputFocus to give another frame the input focus .
3544 In an ideal world, XSetInputFocus should generally be avoided so
3545 that applications don't interfere with the window manager's focus
3546 policy. But I think it's okay to use when it's clearly done
3547 following a user-command. */
3549 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
3550 doc: /* Set the input focus to FRAME.
3551 FRAME nil means use the selected frame. */)
3552 (frame)
3553 Lisp_Object frame;
3555 struct frame *f = check_x_frame (frame);
3556 Display *dpy = FRAME_X_DISPLAY (f);
3558 BLOCK_INPUT;
3559 x_catch_errors (dpy);
3560 XSetInputFocus (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
3561 RevertToParent, CurrentTime);
3562 x_ewmh_activate_frame (f);
3563 x_uncatch_errors ();
3564 UNBLOCK_INPUT;
3566 return Qnil;
3570 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
3571 doc: /* Internal function called by `color-defined-p', which see. */)
3572 (color, frame)
3573 Lisp_Object color, frame;
3575 XColor foo;
3576 FRAME_PTR f = check_x_frame (frame);
3578 CHECK_STRING (color);
3580 if (x_defined_color (f, SDATA (color), &foo, 0))
3581 return Qt;
3582 else
3583 return Qnil;
3586 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
3587 doc: /* Internal function called by `color-values', which see. */)
3588 (color, frame)
3589 Lisp_Object color, frame;
3591 XColor foo;
3592 FRAME_PTR f = check_x_frame (frame);
3594 CHECK_STRING (color);
3596 if (x_defined_color (f, SDATA (color), &foo, 0))
3597 return list3 (make_number (foo.red),
3598 make_number (foo.green),
3599 make_number (foo.blue));
3600 else
3601 return Qnil;
3604 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
3605 doc: /* Internal function called by `display-color-p', which see. */)
3606 (terminal)
3607 Lisp_Object terminal;
3609 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3611 if (dpyinfo->n_planes <= 2)
3612 return Qnil;
3614 switch (dpyinfo->visual->class)
3616 case StaticColor:
3617 case PseudoColor:
3618 case TrueColor:
3619 case DirectColor:
3620 return Qt;
3622 default:
3623 return Qnil;
3627 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p, Sx_display_grayscale_p,
3628 0, 1, 0,
3629 doc: /* Return t if the X display supports shades of gray.
3630 Note that color displays do support shades of gray.
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;
3637 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3639 if (dpyinfo->n_planes <= 1)
3640 return Qnil;
3642 switch (dpyinfo->visual->class)
3644 case StaticColor:
3645 case PseudoColor:
3646 case TrueColor:
3647 case DirectColor:
3648 case StaticGray:
3649 case GrayScale:
3650 return Qt;
3652 default:
3653 return Qnil;
3657 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
3658 0, 1, 0,
3659 doc: /* Return the width in pixels of the X display TERMINAL.
3660 The optional argument TERMINAL specifies which display to ask about.
3661 TERMINAL should be a terminal id, a frame or a display name (a string).
3662 If omitted or nil, that stands for the selected frame's display. */)
3663 (terminal)
3664 Lisp_Object terminal;
3666 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3668 return make_number (dpyinfo->width);
3671 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
3672 Sx_display_pixel_height, 0, 1, 0,
3673 doc: /* Return the height in pixels of the X display TERMINAL.
3674 The optional argument TERMINAL specifies which display to ask about.
3675 TERMINAL should be a terminal id, a frame or a display name (a string).
3676 If omitted or nil, that stands for the selected frame's display. */)
3677 (terminal)
3678 Lisp_Object terminal;
3680 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3682 return make_number (dpyinfo->height);
3685 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
3686 0, 1, 0,
3687 doc: /* Return the number of bitplanes of the X display TERMINAL.
3688 The optional argument TERMINAL specifies which display to ask about.
3689 TERMINAL should be a terminal id, a frame or a display name (a string).
3690 If omitted or nil, that stands for the selected frame's display. */)
3691 (terminal)
3692 Lisp_Object terminal;
3694 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3696 return make_number (dpyinfo->n_planes);
3699 DEFUN ("x-display-color-cells", Fx_display_color_cells, Sx_display_color_cells,
3700 0, 1, 0,
3701 doc: /* Return the number of color cells of the X display TERMINAL.
3702 The optional argument TERMINAL specifies which display to ask about.
3703 TERMINAL should be a terminal id, a frame or a display name (a string).
3704 If omitted or nil, that stands for the selected frame's display. */)
3705 (terminal)
3706 Lisp_Object terminal;
3708 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3710 int nr_planes = DisplayPlanes (dpyinfo->display,
3711 XScreenNumberOfScreen (dpyinfo->screen));
3713 /* Truncate nr_planes to 24 to avoid integer overflow.
3714 Some displays says 32, but only 24 bits are actually significant.
3715 There are only very few and rare video cards that have more than
3716 24 significant bits. Also 24 bits is more than 16 million colors,
3717 it "should be enough for everyone". */
3718 if (nr_planes > 24) nr_planes = 24;
3720 return make_number (1 << nr_planes);
3723 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
3724 Sx_server_max_request_size,
3725 0, 1, 0,
3726 doc: /* Return the maximum request size of the X server of display TERMINAL.
3727 The optional argument TERMINAL specifies which display to ask about.
3728 TERMINAL should be a terminal id, a frame or a display name (a string).
3729 If omitted or nil, that stands for the selected frame's display. */)
3730 (terminal)
3731 Lisp_Object terminal;
3733 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3735 return make_number (MAXREQUEST (dpyinfo->display));
3738 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
3739 doc: /* Return the "vendor ID" string of the X server of display TERMINAL.
3740 \(Labelling every distributor as a "vendor" embodies the false assumption
3741 that operating systems cannot be developed and distributed noncommercially.)
3742 The optional argument TERMINAL specifies which display to ask about.
3743 TERMINAL should be a terminal id, a frame or a display name (a string).
3744 If omitted or nil, that stands for the selected frame's display. */)
3745 (terminal)
3746 Lisp_Object terminal;
3748 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3749 char *vendor = ServerVendor (dpyinfo->display);
3751 if (! vendor) vendor = "";
3752 return build_string (vendor);
3755 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
3756 doc: /* Return the version numbers of the X server of display TERMINAL.
3757 The value is a list of three integers: the major and minor
3758 version numbers of the X Protocol in use, and the distributor-specific release
3759 number. See also the function `x-server-vendor'.
3761 The optional argument TERMINAL specifies which display to ask about.
3762 TERMINAL should be a terminal id, a frame or a display name (a string).
3763 If omitted or nil, that stands for the selected frame's display. */)
3764 (terminal)
3765 Lisp_Object terminal;
3767 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3768 Display *dpy = dpyinfo->display;
3770 return Fcons (make_number (ProtocolVersion (dpy)),
3771 Fcons (make_number (ProtocolRevision (dpy)),
3772 Fcons (make_number (VendorRelease (dpy)), Qnil)));
3775 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
3776 doc: /* Return the number of screens on the X server of display TERMINAL.
3777 The optional argument TERMINAL specifies which display to ask about.
3778 TERMINAL should be a terminal id, a frame or a display name (a string).
3779 If omitted or nil, that stands for the selected frame's display. */)
3780 (terminal)
3781 Lisp_Object terminal;
3783 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3785 return make_number (ScreenCount (dpyinfo->display));
3788 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height, 0, 1, 0,
3789 doc: /* Return the height in millimeters of the X display TERMINAL.
3790 The optional argument TERMINAL specifies which display to ask about.
3791 TERMINAL should be a terminal id, a frame or a display name (a string).
3792 If omitted or nil, that stands for the selected frame's display. */)
3793 (terminal)
3794 Lisp_Object terminal;
3796 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3798 return make_number (HeightMMOfScreen (dpyinfo->screen));
3801 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width, 0, 1, 0,
3802 doc: /* Return the width in millimeters of the X display TERMINAL.
3803 The optional argument TERMINAL specifies which display to ask about.
3804 TERMINAL should be a terminal id, a frame or a display name (a string).
3805 If omitted or nil, that stands for the selected frame's display. */)
3806 (terminal)
3807 Lisp_Object terminal;
3809 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3811 return make_number (WidthMMOfScreen (dpyinfo->screen));
3814 DEFUN ("x-display-backing-store", Fx_display_backing_store,
3815 Sx_display_backing_store, 0, 1, 0,
3816 doc: /* Return an indication of whether X display TERMINAL does backing store.
3817 The value may be `always', `when-mapped', or `not-useful'.
3818 The optional argument TERMINAL specifies which display to ask about.
3819 TERMINAL should be a terminal id, a frame or a display name (a string).
3820 If omitted or nil, that stands for the selected frame's display. */)
3821 (terminal)
3822 Lisp_Object terminal;
3824 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3825 Lisp_Object result;
3827 switch (DoesBackingStore (dpyinfo->screen))
3829 case Always:
3830 result = intern ("always");
3831 break;
3833 case WhenMapped:
3834 result = intern ("when-mapped");
3835 break;
3837 case NotUseful:
3838 result = intern ("not-useful");
3839 break;
3841 default:
3842 error ("Strange value for BackingStore parameter of screen");
3843 result = Qnil;
3846 return result;
3849 DEFUN ("x-display-visual-class", Fx_display_visual_class,
3850 Sx_display_visual_class, 0, 1, 0,
3851 doc: /* Return the visual class of the X display TERMINAL.
3852 The value is one of the symbols `static-gray', `gray-scale',
3853 `static-color', `pseudo-color', `true-color', or `direct-color'.
3855 The optional argument TERMINAL specifies which display to ask about.
3856 TERMINAL should a terminal id, a frame or a display name (a string).
3857 If omitted or nil, that stands for the selected frame's display. */)
3858 (terminal)
3859 Lisp_Object terminal;
3861 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3862 Lisp_Object result;
3864 switch (dpyinfo->visual->class)
3866 case StaticGray:
3867 result = intern ("static-gray");
3868 break;
3869 case GrayScale:
3870 result = intern ("gray-scale");
3871 break;
3872 case StaticColor:
3873 result = intern ("static-color");
3874 break;
3875 case PseudoColor:
3876 result = intern ("pseudo-color");
3877 break;
3878 case TrueColor:
3879 result = intern ("true-color");
3880 break;
3881 case DirectColor:
3882 result = intern ("direct-color");
3883 break;
3884 default:
3885 error ("Display has an unknown visual class");
3886 result = Qnil;
3889 return result;
3892 DEFUN ("x-display-save-under", Fx_display_save_under,
3893 Sx_display_save_under, 0, 1, 0,
3894 doc: /* Return t if the X display TERMINAL supports the save-under feature.
3895 The optional argument TERMINAL specifies which display to ask about.
3896 TERMINAL should be a terminal id, a frame or a display name (a string).
3897 If omitted or nil, that stands for the selected frame's display. */)
3898 (terminal)
3899 Lisp_Object terminal;
3901 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3903 if (DoesSaveUnders (dpyinfo->screen) == True)
3904 return Qt;
3905 else
3906 return Qnil;
3910 x_pixel_width (f)
3911 register struct frame *f;
3913 return FRAME_PIXEL_WIDTH (f);
3917 x_pixel_height (f)
3918 register struct frame *f;
3920 return FRAME_PIXEL_HEIGHT (f);
3924 x_char_width (f)
3925 register struct frame *f;
3927 return FRAME_COLUMN_WIDTH (f);
3931 x_char_height (f)
3932 register struct frame *f;
3934 return FRAME_LINE_HEIGHT (f);
3938 x_screen_planes (f)
3939 register struct frame *f;
3941 return FRAME_X_DISPLAY_INFO (f)->n_planes;
3946 /************************************************************************
3947 X Displays
3948 ************************************************************************/
3951 /* Mapping visual names to visuals. */
3953 static struct visual_class
3955 char *name;
3956 int class;
3958 visual_classes[] =
3960 {"StaticGray", StaticGray},
3961 {"GrayScale", GrayScale},
3962 {"StaticColor", StaticColor},
3963 {"PseudoColor", PseudoColor},
3964 {"TrueColor", TrueColor},
3965 {"DirectColor", DirectColor},
3966 {NULL, 0}
3970 #ifndef HAVE_XSCREENNUMBEROFSCREEN
3972 /* Value is the screen number of screen SCR. This is a substitute for
3973 the X function with the same name when that doesn't exist. */
3976 XScreenNumberOfScreen (scr)
3977 register Screen *scr;
3979 Display *dpy = scr->display;
3980 int i;
3982 for (i = 0; i < dpy->nscreens; ++i)
3983 if (scr == dpy->screens + i)
3984 break;
3986 return i;
3989 #endif /* not HAVE_XSCREENNUMBEROFSCREEN */
3992 /* Select the visual that should be used on display DPYINFO. Set
3993 members of DPYINFO appropriately. Called from x_term_init. */
3995 void
3996 select_visual (dpyinfo)
3997 struct x_display_info *dpyinfo;
3999 Display *dpy = dpyinfo->display;
4000 Screen *screen = dpyinfo->screen;
4001 Lisp_Object value;
4003 /* See if a visual is specified. */
4004 value = display_x_get_resource (dpyinfo,
4005 build_string ("visualClass"),
4006 build_string ("VisualClass"),
4007 Qnil, Qnil);
4008 if (STRINGP (value))
4010 /* VALUE should be of the form CLASS-DEPTH, where CLASS is one
4011 of `PseudoColor', `TrueColor' etc. and DEPTH is the color
4012 depth, a decimal number. NAME is compared with case ignored. */
4013 char *s = (char *) alloca (SBYTES (value) + 1);
4014 char *dash;
4015 int i, class = -1;
4016 XVisualInfo vinfo;
4018 strcpy (s, SDATA (value));
4019 dash = index (s, '-');
4020 if (dash)
4022 dpyinfo->n_planes = atoi (dash + 1);
4023 *dash = '\0';
4025 else
4026 /* We won't find a matching visual with depth 0, so that
4027 an error will be printed below. */
4028 dpyinfo->n_planes = 0;
4030 /* Determine the visual class. */
4031 for (i = 0; visual_classes[i].name; ++i)
4032 if (xstrcasecmp (s, visual_classes[i].name) == 0)
4034 class = visual_classes[i].class;
4035 break;
4038 /* Look up a matching visual for the specified class. */
4039 if (class == -1
4040 || !XMatchVisualInfo (dpy, XScreenNumberOfScreen (screen),
4041 dpyinfo->n_planes, class, &vinfo))
4042 fatal ("Invalid visual specification `%s'", SDATA (value));
4044 dpyinfo->visual = vinfo.visual;
4046 else
4048 int n_visuals;
4049 XVisualInfo *vinfo, vinfo_template;
4051 dpyinfo->visual = DefaultVisualOfScreen (screen);
4053 vinfo_template.visualid = XVisualIDFromVisual (dpyinfo->visual);
4054 vinfo_template.screen = XScreenNumberOfScreen (screen);
4055 vinfo = XGetVisualInfo (dpy, VisualIDMask | VisualScreenMask,
4056 &vinfo_template, &n_visuals);
4057 if (n_visuals != 1)
4058 fatal ("Can't get proper X visual info");
4060 dpyinfo->n_planes = vinfo->depth;
4061 XFree ((char *) vinfo);
4066 /* Return the X display structure for the display named NAME.
4067 Open a new connection if necessary. */
4069 struct x_display_info *
4070 x_display_info_for_name (name)
4071 Lisp_Object name;
4073 Lisp_Object names;
4074 struct x_display_info *dpyinfo;
4076 CHECK_STRING (name);
4078 #if 0
4079 if (! EQ (Vinitial_window_system, intern ("x")))
4080 error ("Not using X Windows"); /* That doesn't stop us anymore. */
4081 #endif
4083 for (dpyinfo = x_display_list, names = x_display_name_list;
4084 dpyinfo;
4085 dpyinfo = dpyinfo->next, names = XCDR (names))
4087 Lisp_Object tem;
4088 tem = Fstring_equal (XCAR (XCAR (names)), name);
4089 if (!NILP (tem))
4090 return dpyinfo;
4093 /* Use this general default value to start with. */
4094 Vx_resource_name = Vinvocation_name;
4096 validate_x_resource_name ();
4098 dpyinfo = x_term_init (name, (char *)0,
4099 (char *) SDATA (Vx_resource_name));
4101 if (dpyinfo == 0)
4102 error ("Cannot connect to X server %s", SDATA (name));
4104 x_in_use = 1;
4105 XSETFASTINT (Vwindow_system_version, 11);
4107 return dpyinfo;
4111 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
4112 1, 3, 0,
4113 doc: /* Open a connection to an X server.
4114 DISPLAY is the name of the display to connect to.
4115 Optional second arg XRM-STRING is a string of resources in xrdb format.
4116 If the optional third arg MUST-SUCCEED is non-nil,
4117 terminate Emacs if we can't open the connection. */)
4118 (display, xrm_string, must_succeed)
4119 Lisp_Object display, xrm_string, must_succeed;
4121 unsigned char *xrm_option;
4122 struct x_display_info *dpyinfo;
4124 CHECK_STRING (display);
4125 if (! NILP (xrm_string))
4126 CHECK_STRING (xrm_string);
4128 #if 0
4129 if (! EQ (Vinitial_window_system, intern ("x")))
4130 error ("Not using X Windows"); /* That doesn't stop us anymore. */
4131 #endif
4133 if (! NILP (xrm_string))
4134 xrm_option = (unsigned char *) SDATA (xrm_string);
4135 else
4136 xrm_option = (unsigned char *) 0;
4138 validate_x_resource_name ();
4140 /* This is what opens the connection and sets x_current_display.
4141 This also initializes many symbols, such as those used for input. */
4142 dpyinfo = x_term_init (display, xrm_option,
4143 (char *) SDATA (Vx_resource_name));
4145 if (dpyinfo == 0)
4147 if (!NILP (must_succeed))
4148 fatal ("Cannot connect to X server %s.\n\
4149 Check the DISPLAY environment variable or use `-d'.\n\
4150 Also use the `xauth' program to verify that you have the proper\n\
4151 authorization information needed to connect the X server.\n\
4152 An insecure way to solve the problem may be to use `xhost'.\n",
4153 SDATA (display));
4154 else
4155 error ("Cannot connect to X server %s", SDATA (display));
4158 x_in_use = 1;
4160 XSETFASTINT (Vwindow_system_version, 11);
4161 return Qnil;
4164 DEFUN ("x-close-connection", Fx_close_connection,
4165 Sx_close_connection, 1, 1, 0,
4166 doc: /* Close the connection to TERMINAL's X server.
4167 For TERMINAL, specify a terminal id, a frame or a display name (a
4168 string). If TERMINAL is nil, that stands for the selected frame's
4169 terminal. */)
4170 (terminal)
4171 Lisp_Object terminal;
4173 struct x_display_info *dpyinfo = check_x_display_info (terminal);
4175 if (dpyinfo->reference_count > 0)
4176 error ("Display still has frames on it");
4178 x_delete_terminal (dpyinfo->terminal);
4180 return Qnil;
4183 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
4184 doc: /* Return the list of display names that Emacs has connections to. */)
4187 Lisp_Object tail, result;
4189 result = Qnil;
4190 for (tail = x_display_name_list; CONSP (tail); tail = XCDR (tail))
4191 result = Fcons (XCAR (XCAR (tail)), result);
4193 return result;
4196 DEFUN ("x-synchronize", Fx_synchronize, Sx_synchronize, 1, 2, 0,
4197 doc: /* If ON is non-nil, report X errors as soon as the erring request is made.
4198 If ON is nil, allow buffering of requests.
4199 Turning on synchronization prohibits the Xlib routines from buffering
4200 requests and seriously degrades performance, but makes debugging much
4201 easier.
4202 The optional second argument TERMINAL specifies which display to act on.
4203 TERMINAL should be a terminal id, a frame or a display name (a string).
4204 If TERMINAL is omitted or nil, that stands for the selected frame's display. */)
4205 (on, terminal)
4206 Lisp_Object terminal, on;
4208 struct x_display_info *dpyinfo = check_x_display_info (terminal);
4210 XSynchronize (dpyinfo->display, !EQ (on, Qnil));
4212 return Qnil;
4215 /* Wait for responses to all X commands issued so far for frame F. */
4217 void
4218 x_sync (f)
4219 FRAME_PTR f;
4221 BLOCK_INPUT;
4222 XSync (FRAME_X_DISPLAY (f), False);
4223 UNBLOCK_INPUT;
4227 /***********************************************************************
4228 Window properties
4229 ***********************************************************************/
4231 DEFUN ("x-change-window-property", Fx_change_window_property,
4232 Sx_change_window_property, 2, 6, 0,
4233 doc: /* Change window property PROP to VALUE on the X window of FRAME.
4234 PROP must be a string.
4235 VALUE may be a string or a list of conses, numbers and/or strings.
4236 If an element in the list is a string, it is converted to
4237 an Atom and the value of the Atom is used. If an element is a cons,
4238 it is converted to a 32 bit number where the car is the 16 top bits and the
4239 cdr is the lower 16 bits.
4240 FRAME nil or omitted means use the selected frame.
4241 If TYPE is given and non-nil, it is the name of the type of VALUE.
4242 If TYPE is not given or nil, the type is STRING.
4243 FORMAT gives the size in bits of each element if VALUE is a list.
4244 It must be one of 8, 16 or 32.
4245 If VALUE is a string or FORMAT is nil or not given, FORMAT defaults to 8.
4246 If OUTER_P is non-nil, the property is changed for the outer X window of
4247 FRAME. Default is to change on the edit X window.
4249 Value is VALUE. */)
4250 (prop, value, frame, type, format, outer_p)
4251 Lisp_Object prop, value, frame, type, format, outer_p;
4253 struct frame *f = check_x_frame (frame);
4254 Atom prop_atom;
4255 Atom target_type = XA_STRING;
4256 int element_format = 8;
4257 unsigned char *data;
4258 int nelements;
4259 Window w;
4261 CHECK_STRING (prop);
4263 if (! NILP (format))
4265 CHECK_NUMBER (format);
4266 element_format = XFASTINT (format);
4268 if (element_format != 8 && element_format != 16
4269 && element_format != 32)
4270 error ("FORMAT must be one of 8, 16 or 32");
4273 if (CONSP (value))
4275 nelements = x_check_property_data (value);
4276 if (nelements == -1)
4277 error ("Bad data in VALUE, must be number, string or cons");
4279 if (element_format == 8)
4280 data = (unsigned char *) xmalloc (nelements);
4281 else if (element_format == 16)
4282 data = (unsigned char *) xmalloc (nelements*2);
4283 else /* format == 32 */
4284 /* The man page for XChangeProperty:
4285 "If the specified format is 32, the property data must be a
4286 long array."
4287 This applies even if long is more than 64 bits. The X library
4288 converts to 32 bits before sending to the X server. */
4289 data = (unsigned char *) xmalloc (nelements * sizeof(long));
4291 x_fill_property_data (FRAME_X_DISPLAY (f), value, data, element_format);
4293 else
4295 CHECK_STRING (value);
4296 data = SDATA (value);
4297 nelements = SCHARS (value);
4300 BLOCK_INPUT;
4301 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SDATA (prop), False);
4302 if (! NILP (type))
4304 CHECK_STRING (type);
4305 target_type = XInternAtom (FRAME_X_DISPLAY (f), SDATA (type), False);
4308 if (! NILP (outer_p)) w = FRAME_OUTER_WINDOW (f);
4309 else w = FRAME_X_WINDOW (f);
4311 XChangeProperty (FRAME_X_DISPLAY (f), w,
4312 prop_atom, target_type, element_format, PropModeReplace,
4313 data, nelements);
4315 if (CONSP (value)) xfree (data);
4317 /* Make sure the property is set when we return. */
4318 XFlush (FRAME_X_DISPLAY (f));
4319 UNBLOCK_INPUT;
4321 return value;
4325 DEFUN ("x-delete-window-property", Fx_delete_window_property,
4326 Sx_delete_window_property, 1, 2, 0,
4327 doc: /* Remove window property PROP from X window of FRAME.
4328 FRAME nil or omitted means use the selected frame. Value is PROP. */)
4329 (prop, frame)
4330 Lisp_Object prop, frame;
4332 struct frame *f = check_x_frame (frame);
4333 Atom prop_atom;
4335 CHECK_STRING (prop);
4336 BLOCK_INPUT;
4337 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SDATA (prop), False);
4338 XDeleteProperty (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), prop_atom);
4340 /* Make sure the property is removed when we return. */
4341 XFlush (FRAME_X_DISPLAY (f));
4342 UNBLOCK_INPUT;
4344 return prop;
4348 DEFUN ("x-window-property", Fx_window_property, Sx_window_property,
4349 1, 6, 0,
4350 doc: /* Value is the value of window property PROP on FRAME.
4351 If FRAME is nil or omitted, use the selected frame.
4352 If TYPE is nil or omitted, get the property as a string. Otherwise TYPE
4353 is the name of the Atom that denotes the type expected.
4354 If SOURCE is non-nil, get the property on that window instead of from
4355 FRAME. The number 0 denotes the root window.
4356 If DELETE_P is non-nil, delete the property after retreiving it.
4357 If VECTOR_RET_P is non-nil, don't return a string but a vector of values.
4359 Value is nil if FRAME hasn't a property with name PROP or if PROP has
4360 no value of TYPE. */)
4361 (prop, frame, type, source, delete_p, vector_ret_p)
4362 Lisp_Object prop, frame, type, source, delete_p, vector_ret_p;
4364 struct frame *f = check_x_frame (frame);
4365 Atom prop_atom;
4366 int rc;
4367 Lisp_Object prop_value = Qnil;
4368 unsigned char *tmp_data = NULL;
4369 Atom actual_type;
4370 Atom target_type = XA_STRING;
4371 int actual_format;
4372 unsigned long actual_size, bytes_remaining;
4373 Window target_window = FRAME_X_WINDOW (f);
4374 struct gcpro gcpro1;
4376 GCPRO1 (prop_value);
4377 CHECK_STRING (prop);
4379 if (! NILP (source))
4381 if (NUMBERP (source))
4383 if (FLOATP (source))
4384 target_window = (Window) XFLOAT (source);
4385 else
4386 target_window = XFASTINT (source);
4388 if (target_window == 0)
4389 target_window = FRAME_X_DISPLAY_INFO (f)->root_window;
4391 else if (CONSP (source))
4392 target_window = cons_to_long (source);
4395 BLOCK_INPUT;
4396 if (STRINGP (type))
4398 if (strcmp ("AnyPropertyType", SDATA (type)) == 0)
4399 target_type = AnyPropertyType;
4400 else
4401 target_type = XInternAtom (FRAME_X_DISPLAY (f), SDATA (type), False);
4404 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SDATA (prop), False);
4405 rc = XGetWindowProperty (FRAME_X_DISPLAY (f), target_window,
4406 prop_atom, 0, 0, False, target_type,
4407 &actual_type, &actual_format, &actual_size,
4408 &bytes_remaining, &tmp_data);
4409 if (rc == Success)
4411 int size = bytes_remaining;
4413 XFree (tmp_data);
4414 tmp_data = NULL;
4416 rc = XGetWindowProperty (FRAME_X_DISPLAY (f), target_window,
4417 prop_atom, 0, bytes_remaining,
4418 ! NILP (delete_p), target_type,
4419 &actual_type, &actual_format,
4420 &actual_size, &bytes_remaining,
4421 &tmp_data);
4422 if (rc == Success && tmp_data)
4424 /* The man page for XGetWindowProperty says:
4425 "If the returned format is 32, the returned data is represented
4426 as a long array and should be cast to that type to obtain the
4427 elements."
4428 This applies even if long is more than 32 bits, the X library
4429 converts from 32 bit elements received from the X server to long
4430 and passes the long array to us. Thus, for that case bcopy can not
4431 be used. We convert to a 32 bit type here, because so much code
4432 assume on that.
4434 The bytes and offsets passed to XGetWindowProperty refers to the
4435 property and those are indeed in 32 bit quantities if format is
4436 32. */
4438 if (actual_format == 32 && actual_format < BITS_PER_LONG)
4440 unsigned long i;
4441 int *idata = (int *) tmp_data;
4442 long *ldata = (long *) tmp_data;
4444 for (i = 0; i < actual_size; ++i)
4445 idata[i] = (int) ldata[i];
4448 if (NILP (vector_ret_p))
4449 prop_value = make_string (tmp_data, size);
4450 else
4451 prop_value = x_property_data_to_lisp (f,
4452 tmp_data,
4453 actual_type,
4454 actual_format,
4455 actual_size);
4458 if (tmp_data) XFree (tmp_data);
4461 UNBLOCK_INPUT;
4462 UNGCPRO;
4463 return prop_value;
4468 /***********************************************************************
4469 Busy cursor
4470 ***********************************************************************/
4472 /* If non-null, an asynchronous timer that, when it expires, displays
4473 an hourglass cursor on all frames. */
4475 static struct atimer *hourglass_atimer;
4477 /* Non-zero means an hourglass cursor is currently shown. */
4479 static int hourglass_shown_p;
4481 /* Number of seconds to wait before displaying an hourglass cursor. */
4483 static Lisp_Object Vhourglass_delay;
4485 /* Default number of seconds to wait before displaying an hourglass
4486 cursor. */
4488 #define DEFAULT_HOURGLASS_DELAY 1
4490 /* Function prototypes. */
4492 static void show_hourglass P_ ((struct atimer *));
4493 static void hide_hourglass P_ ((void));
4495 /* Return non-zero if houglass timer has been started or hourglass is shown. */
4498 hourglass_started ()
4500 return hourglass_shown_p || hourglass_atimer != NULL;
4504 /* Cancel a currently active hourglass timer, and start a new one. */
4506 void
4507 start_hourglass ()
4509 EMACS_TIME delay;
4510 int secs, usecs = 0;
4512 cancel_hourglass ();
4514 if (INTEGERP (Vhourglass_delay)
4515 && XINT (Vhourglass_delay) > 0)
4516 secs = XFASTINT (Vhourglass_delay);
4517 else if (FLOATP (Vhourglass_delay)
4518 && XFLOAT_DATA (Vhourglass_delay) > 0)
4520 Lisp_Object tem;
4521 tem = Ftruncate (Vhourglass_delay, Qnil);
4522 secs = XFASTINT (tem);
4523 usecs = (XFLOAT_DATA (Vhourglass_delay) - secs) * 1000000;
4525 else
4526 secs = DEFAULT_HOURGLASS_DELAY;
4528 EMACS_SET_SECS_USECS (delay, secs, usecs);
4529 hourglass_atimer = start_atimer (ATIMER_RELATIVE, delay,
4530 show_hourglass, NULL);
4534 /* Cancel the hourglass cursor timer if active, hide a busy cursor if
4535 shown. */
4537 void
4538 cancel_hourglass ()
4540 if (hourglass_atimer)
4542 cancel_atimer (hourglass_atimer);
4543 hourglass_atimer = NULL;
4546 if (hourglass_shown_p)
4547 hide_hourglass ();
4551 /* Timer function of hourglass_atimer. TIMER is equal to
4552 hourglass_atimer.
4554 Display an hourglass pointer on all frames by mapping the frames'
4555 hourglass_window. Set the hourglass_p flag in the frames'
4556 output_data.x structure to indicate that an hourglass cursor is
4557 shown on the frames. */
4559 static void
4560 show_hourglass (timer)
4561 struct atimer *timer;
4563 /* The timer implementation will cancel this timer automatically
4564 after this function has run. Set hourglass_atimer to null
4565 so that we know the timer doesn't have to be canceled. */
4566 hourglass_atimer = NULL;
4568 if (!hourglass_shown_p)
4570 Lisp_Object rest, frame;
4572 BLOCK_INPUT;
4574 FOR_EACH_FRAME (rest, frame)
4576 struct frame *f = XFRAME (frame);
4578 if (FRAME_LIVE_P (f) && FRAME_X_P (f) && FRAME_X_DISPLAY (f))
4580 Display *dpy = FRAME_X_DISPLAY (f);
4582 #ifdef USE_X_TOOLKIT
4583 if (f->output_data.x->widget)
4584 #else
4585 if (FRAME_OUTER_WINDOW (f))
4586 #endif
4588 f->output_data.x->hourglass_p = 1;
4590 if (!f->output_data.x->hourglass_window)
4592 unsigned long mask = CWCursor;
4593 XSetWindowAttributes attrs;
4594 #ifdef USE_GTK
4595 Window parent = FRAME_X_WINDOW (f);
4596 #else
4597 Window parent = FRAME_OUTER_WINDOW (f);
4598 #endif
4599 attrs.cursor = f->output_data.x->hourglass_cursor;
4601 f->output_data.x->hourglass_window
4602 = XCreateWindow (dpy, parent,
4603 0, 0, 32000, 32000, 0, 0,
4604 InputOnly,
4605 CopyFromParent,
4606 mask, &attrs);
4609 XMapRaised (dpy, f->output_data.x->hourglass_window);
4610 XFlush (dpy);
4615 hourglass_shown_p = 1;
4616 UNBLOCK_INPUT;
4621 /* Hide the hourglass pointer on all frames, if it is currently
4622 shown. */
4624 static void
4625 hide_hourglass ()
4627 if (hourglass_shown_p)
4629 Lisp_Object rest, frame;
4631 BLOCK_INPUT;
4632 FOR_EACH_FRAME (rest, frame)
4634 struct frame *f = XFRAME (frame);
4636 if (FRAME_X_P (f)
4637 /* Watch out for newly created frames. */
4638 && f->output_data.x->hourglass_window)
4640 XUnmapWindow (FRAME_X_DISPLAY (f),
4641 f->output_data.x->hourglass_window);
4642 /* Sync here because XTread_socket looks at the
4643 hourglass_p flag that is reset to zero below. */
4644 XSync (FRAME_X_DISPLAY (f), False);
4645 f->output_data.x->hourglass_p = 0;
4649 hourglass_shown_p = 0;
4650 UNBLOCK_INPUT;
4656 /***********************************************************************
4657 Tool tips
4658 ***********************************************************************/
4660 static Lisp_Object x_create_tip_frame P_ ((struct x_display_info *,
4661 Lisp_Object, Lisp_Object));
4662 static void compute_tip_xy P_ ((struct frame *, Lisp_Object, Lisp_Object,
4663 Lisp_Object, int, int, int *, int *));
4665 /* The frame of a currently visible tooltip. */
4667 Lisp_Object tip_frame;
4669 /* If non-nil, a timer started that hides the last tooltip when it
4670 fires. */
4672 Lisp_Object tip_timer;
4673 Window tip_window;
4675 /* If non-nil, a vector of 3 elements containing the last args
4676 with which x-show-tip was called. See there. */
4678 Lisp_Object last_show_tip_args;
4680 /* Maximum size for tooltips; a cons (COLUMNS . ROWS). */
4682 Lisp_Object Vx_max_tooltip_size;
4685 static Lisp_Object
4686 unwind_create_tip_frame (frame)
4687 Lisp_Object frame;
4689 Lisp_Object deleted;
4691 deleted = unwind_create_frame (frame);
4692 if (EQ (deleted, Qt))
4694 tip_window = None;
4695 tip_frame = Qnil;
4698 return deleted;
4702 /* Create a frame for a tooltip on the display described by DPYINFO.
4703 PARMS is a list of frame parameters. TEXT is the string to
4704 display in the tip frame. Value is the frame.
4706 Note that functions called here, esp. x_default_parameter can
4707 signal errors, for instance when a specified color name is
4708 undefined. We have to make sure that we're in a consistent state
4709 when this happens. */
4711 static Lisp_Object
4712 x_create_tip_frame (dpyinfo, parms, text)
4713 struct x_display_info *dpyinfo;
4714 Lisp_Object parms, text;
4716 struct frame *f;
4717 Lisp_Object frame, tem;
4718 Lisp_Object name;
4719 long window_prompting = 0;
4720 int width, height;
4721 int count = SPECPDL_INDEX ();
4722 struct gcpro gcpro1, gcpro2, gcpro3;
4723 int face_change_count_before = face_change_count;
4724 Lisp_Object buffer;
4725 struct buffer *old_buffer;
4727 check_x ();
4729 if (!dpyinfo->terminal->name)
4730 error ("Terminal is not live, can't create new frames on it");
4732 parms = Fcopy_alist (parms);
4734 /* Get the name of the frame to use for resource lookup. */
4735 name = x_get_arg (dpyinfo, parms, Qname, "name", "Name", RES_TYPE_STRING);
4736 if (!STRINGP (name)
4737 && !EQ (name, Qunbound)
4738 && !NILP (name))
4739 error ("Invalid frame name--not a string or nil");
4741 frame = Qnil;
4742 GCPRO3 (parms, name, frame);
4743 f = make_frame (1);
4744 XSETFRAME (frame, f);
4746 buffer = Fget_buffer_create (build_string (" *tip*"));
4747 Fset_window_buffer (FRAME_ROOT_WINDOW (f), buffer, Qnil);
4748 old_buffer = current_buffer;
4749 set_buffer_internal_1 (XBUFFER (buffer));
4750 current_buffer->truncate_lines = Qnil;
4751 specbind (Qinhibit_read_only, Qt);
4752 specbind (Qinhibit_modification_hooks, Qt);
4753 Ferase_buffer ();
4754 Finsert (1, &text);
4755 set_buffer_internal_1 (old_buffer);
4757 FRAME_CAN_HAVE_SCROLL_BARS (f) = 0;
4758 record_unwind_protect (unwind_create_tip_frame, frame);
4760 f->terminal = dpyinfo->terminal;
4761 f->terminal->reference_count++;
4763 /* By setting the output method, we're essentially saying that
4764 the frame is live, as per FRAME_LIVE_P. If we get a signal
4765 from this point on, x_destroy_window might screw up reference
4766 counts etc. */
4767 f->output_method = output_x_window;
4768 f->output_data.x = (struct x_output *) xmalloc (sizeof (struct x_output));
4769 bzero (f->output_data.x, sizeof (struct x_output));
4770 f->output_data.x->icon_bitmap = -1;
4771 FRAME_FONTSET (f) = -1;
4772 f->output_data.x->scroll_bar_foreground_pixel = -1;
4773 f->output_data.x->scroll_bar_background_pixel = -1;
4774 #ifdef USE_TOOLKIT_SCROLL_BARS
4775 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
4776 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
4777 #endif /* USE_TOOLKIT_SCROLL_BARS */
4778 f->icon_name = Qnil;
4779 FRAME_X_DISPLAY_INFO (f) = dpyinfo;
4780 #if GLYPH_DEBUG
4781 image_cache_refcount = FRAME_IMAGE_CACHE (f)->refcount;
4782 dpyinfo_refcount = dpyinfo->reference_count;
4783 #endif /* GLYPH_DEBUG */
4784 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
4785 f->output_data.x->explicit_parent = 0;
4787 /* These colors will be set anyway later, but it's important
4788 to get the color reference counts right, so initialize them! */
4790 Lisp_Object black;
4791 struct gcpro gcpro1;
4793 /* Function x_decode_color can signal an error. Make
4794 sure to initialize color slots so that we won't try
4795 to free colors we haven't allocated. */
4796 FRAME_FOREGROUND_PIXEL (f) = -1;
4797 FRAME_BACKGROUND_PIXEL (f) = -1;
4798 f->output_data.x->cursor_pixel = -1;
4799 f->output_data.x->cursor_foreground_pixel = -1;
4800 f->output_data.x->border_pixel = -1;
4801 f->output_data.x->mouse_pixel = -1;
4803 black = build_string ("black");
4804 GCPRO1 (black);
4805 FRAME_FOREGROUND_PIXEL (f)
4806 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4807 FRAME_BACKGROUND_PIXEL (f)
4808 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4809 f->output_data.x->cursor_pixel
4810 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4811 f->output_data.x->cursor_foreground_pixel
4812 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4813 f->output_data.x->border_pixel
4814 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4815 f->output_data.x->mouse_pixel
4816 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4817 UNGCPRO;
4820 /* Set the name; the functions to which we pass f expect the name to
4821 be set. */
4822 if (EQ (name, Qunbound) || NILP (name))
4824 f->name = build_string (dpyinfo->x_id_name);
4825 f->explicit_name = 0;
4827 else
4829 f->name = name;
4830 f->explicit_name = 1;
4831 /* use the frame's title when getting resources for this frame. */
4832 specbind (Qx_resource_name, name);
4835 f->resx = dpyinfo->resx;
4836 f->resy = dpyinfo->resy;
4838 register_font_driver (&xfont_driver, f);
4839 #ifdef HAVE_FREETYPE
4840 #ifdef HAVE_XFT
4841 register_font_driver (&xftfont_driver, f);
4842 #else /* not HAVE_XFT */
4843 register_font_driver (&ftxfont_driver, f);
4844 #endif /* not HAVE_XFT */
4845 #endif /* HAVE_FREETYPE */
4847 x_default_parameter (f, parms, Qfont_backend, Qnil,
4848 "fontBackend", "FontBackend", RES_TYPE_STRING);
4850 /* Extract the window parameters from the supplied values that are
4851 needed to determine window geometry. */
4852 x_default_font_parameter (f, parms);
4854 x_default_parameter (f, parms, Qborder_width, make_number (2),
4855 "borderWidth", "BorderWidth", RES_TYPE_NUMBER);
4857 /* This defaults to 2 in order to match xterm. We recognize either
4858 internalBorderWidth or internalBorder (which is what xterm calls
4859 it). */
4860 if (NILP (Fassq (Qinternal_border_width, parms)))
4862 Lisp_Object value;
4864 value = x_get_arg (dpyinfo, parms, Qinternal_border_width,
4865 "internalBorder", "internalBorder", RES_TYPE_NUMBER);
4866 if (! EQ (value, Qunbound))
4867 parms = Fcons (Fcons (Qinternal_border_width, value),
4868 parms);
4871 x_default_parameter (f, parms, Qinternal_border_width, make_number (1),
4872 "internalBorderWidth", "internalBorderWidth",
4873 RES_TYPE_NUMBER);
4875 /* Also do the stuff which must be set before the window exists. */
4876 x_default_parameter (f, parms, Qforeground_color, build_string ("black"),
4877 "foreground", "Foreground", RES_TYPE_STRING);
4878 x_default_parameter (f, parms, Qbackground_color, build_string ("white"),
4879 "background", "Background", RES_TYPE_STRING);
4880 x_default_parameter (f, parms, Qmouse_color, build_string ("black"),
4881 "pointerColor", "Foreground", RES_TYPE_STRING);
4882 x_default_parameter (f, parms, Qcursor_color, build_string ("black"),
4883 "cursorColor", "Foreground", RES_TYPE_STRING);
4884 x_default_parameter (f, parms, Qborder_color, build_string ("black"),
4885 "borderColor", "BorderColor", RES_TYPE_STRING);
4887 /* Init faces before x_default_parameter is called for scroll-bar
4888 parameters because that function calls x_set_scroll_bar_width,
4889 which calls change_frame_size, which calls Fset_window_buffer,
4890 which runs hooks, which call Fvertical_motion. At the end, we
4891 end up in init_iterator with a null face cache, which should not
4892 happen. */
4893 init_frame_faces (f);
4895 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
4897 window_prompting = x_figure_window_size (f, parms, 0);
4900 XSetWindowAttributes attrs;
4901 unsigned long mask;
4903 BLOCK_INPUT;
4904 mask = CWBackPixel | CWOverrideRedirect | CWEventMask;
4905 if (DoesSaveUnders (dpyinfo->screen))
4906 mask |= CWSaveUnder;
4908 /* Window managers look at the override-redirect flag to determine
4909 whether or net to give windows a decoration (Xlib spec, chapter
4910 3.2.8). */
4911 attrs.override_redirect = True;
4912 attrs.save_under = True;
4913 attrs.background_pixel = FRAME_BACKGROUND_PIXEL (f);
4914 /* Arrange for getting MapNotify and UnmapNotify events. */
4915 attrs.event_mask = StructureNotifyMask;
4916 tip_window
4917 = FRAME_X_WINDOW (f)
4918 = XCreateWindow (FRAME_X_DISPLAY (f),
4919 FRAME_X_DISPLAY_INFO (f)->root_window,
4920 /* x, y, width, height */
4921 0, 0, 1, 1,
4922 /* Border. */
4924 CopyFromParent, InputOutput, CopyFromParent,
4925 mask, &attrs);
4926 UNBLOCK_INPUT;
4929 x_make_gc (f);
4931 x_default_parameter (f, parms, Qauto_raise, Qnil,
4932 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
4933 x_default_parameter (f, parms, Qauto_lower, Qnil,
4934 "autoLower", "AutoRaiseLower", RES_TYPE_BOOLEAN);
4935 x_default_parameter (f, parms, Qcursor_type, Qbox,
4936 "cursorType", "CursorType", RES_TYPE_SYMBOL);
4938 /* Dimensions, especially FRAME_LINES (f), must be done via change_frame_size.
4939 Change will not be effected unless different from the current
4940 FRAME_LINES (f). */
4941 width = FRAME_COLS (f);
4942 height = FRAME_LINES (f);
4943 SET_FRAME_COLS (f, 0);
4944 FRAME_LINES (f) = 0;
4945 change_frame_size (f, height, width, 1, 0, 0);
4947 /* Add `tooltip' frame parameter's default value. */
4948 if (NILP (Fframe_parameter (frame, intern ("tooltip"))))
4949 Fmodify_frame_parameters (frame, Fcons (Fcons (intern ("tooltip"), Qt),
4950 Qnil));
4952 /* FIXME - can this be done in a similar way to normal frames?
4953 http://lists.gnu.org/archive/html/emacs-devel/2007-10/msg00641.html */
4955 /* Set the `display-type' frame parameter before setting up faces. */
4957 Lisp_Object disptype;
4959 if (FRAME_X_DISPLAY_INFO (f)->n_planes == 1)
4960 disptype = intern ("mono");
4961 else if (FRAME_X_DISPLAY_INFO (f)->visual->class == GrayScale
4962 || FRAME_X_DISPLAY_INFO (f)->visual->class == StaticGray)
4963 disptype = intern ("grayscale");
4964 else
4965 disptype = intern ("color");
4967 if (NILP (Fframe_parameter (frame, Qdisplay_type)))
4968 Fmodify_frame_parameters (frame, Fcons (Fcons (Qdisplay_type, disptype),
4969 Qnil));
4972 /* Set up faces after all frame parameters are known. This call
4973 also merges in face attributes specified for new frames.
4975 Frame parameters may be changed if .Xdefaults contains
4976 specifications for the default font. For example, if there is an
4977 `Emacs.default.attributeBackground: pink', the `background-color'
4978 attribute of the frame get's set, which let's the internal border
4979 of the tooltip frame appear in pink. Prevent this. */
4981 Lisp_Object bg = Fframe_parameter (frame, Qbackground_color);
4983 /* Set tip_frame here, so that */
4984 tip_frame = frame;
4985 call1 (Qface_set_after_frame_default, frame);
4987 if (!EQ (bg, Fframe_parameter (frame, Qbackground_color)))
4988 Fmodify_frame_parameters (frame, Fcons (Fcons (Qbackground_color, bg),
4989 Qnil));
4992 f->no_split = 1;
4994 UNGCPRO;
4996 /* It is now ok to make the frame official even if we get an error
4997 below. And the frame needs to be on Vframe_list or making it
4998 visible won't work. */
4999 Vframe_list = Fcons (frame, Vframe_list);
5001 /* Now that the frame is official, it counts as a reference to
5002 its display. */
5003 FRAME_X_DISPLAY_INFO (f)->reference_count++;
5005 /* Setting attributes of faces of the tooltip frame from resources
5006 and similar will increment face_change_count, which leads to the
5007 clearing of all current matrices. Since this isn't necessary
5008 here, avoid it by resetting face_change_count to the value it
5009 had before we created the tip frame. */
5010 face_change_count = face_change_count_before;
5012 /* Discard the unwind_protect. */
5013 return unbind_to (count, frame);
5017 /* Compute where to display tip frame F. PARMS is the list of frame
5018 parameters for F. DX and DY are specified offsets from the current
5019 location of the mouse. WIDTH and HEIGHT are the width and height
5020 of the tooltip. Return coordinates relative to the root window of
5021 the display in *ROOT_X, and *ROOT_Y. */
5023 static void
5024 compute_tip_xy (f, parms, dx, dy, width, height, root_x, root_y)
5025 struct frame *f;
5026 Lisp_Object parms, dx, dy;
5027 int width, height;
5028 int *root_x, *root_y;
5030 Lisp_Object left, top;
5031 int win_x, win_y;
5032 Window root, child;
5033 unsigned pmask;
5035 /* User-specified position? */
5036 left = Fcdr (Fassq (Qleft, parms));
5037 top = Fcdr (Fassq (Qtop, parms));
5039 /* Move the tooltip window where the mouse pointer is. Resize and
5040 show it. */
5041 if (!INTEGERP (left) || !INTEGERP (top))
5043 BLOCK_INPUT;
5044 XQueryPointer (FRAME_X_DISPLAY (f), FRAME_X_DISPLAY_INFO (f)->root_window,
5045 &root, &child, root_x, root_y, &win_x, &win_y, &pmask);
5046 UNBLOCK_INPUT;
5049 if (INTEGERP (top))
5050 *root_y = XINT (top);
5051 else if (*root_y + XINT (dy) <= 0)
5052 *root_y = 0; /* Can happen for negative dy */
5053 else if (*root_y + XINT (dy) + height <= FRAME_X_DISPLAY_INFO (f)->height)
5054 /* It fits below the pointer */
5055 *root_y += XINT (dy);
5056 else if (height + XINT (dy) <= *root_y)
5057 /* It fits above the pointer. */
5058 *root_y -= height + XINT (dy);
5059 else
5060 /* Put it on the top. */
5061 *root_y = 0;
5063 if (INTEGERP (left))
5064 *root_x = XINT (left);
5065 else if (*root_x + XINT (dx) <= 0)
5066 *root_x = 0; /* Can happen for negative dx */
5067 else if (*root_x + XINT (dx) + width <= FRAME_X_DISPLAY_INFO (f)->width)
5068 /* It fits to the right of the pointer. */
5069 *root_x += XINT (dx);
5070 else if (width + XINT (dx) <= *root_x)
5071 /* It fits to the left of the pointer. */
5072 *root_x -= width + XINT (dx);
5073 else
5074 /* Put it left-justified on the screen--it ought to fit that way. */
5075 *root_x = 0;
5079 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
5080 doc: /* Show STRING in a "tooltip" window on frame FRAME.
5081 A tooltip window is a small X window displaying a string.
5083 This is an internal function; Lisp code should call `tooltip-show'.
5085 FRAME nil or omitted means use the selected frame.
5087 PARMS is an optional list of frame parameters which can be used to
5088 change the tooltip's appearance.
5090 Automatically hide the tooltip after TIMEOUT seconds. TIMEOUT nil
5091 means use the default timeout of 5 seconds.
5093 If the list of frame parameters PARAMS contains a `left' parameters,
5094 the tooltip is displayed at that x-position. Otherwise it is
5095 displayed at the mouse position, with offset DX added (default is 5 if
5096 DX isn't specified). Likewise for the y-position; if a `top' frame
5097 parameter is specified, it determines the y-position of the tooltip
5098 window, otherwise it is displayed at the mouse position, with offset
5099 DY added (default is -10).
5101 A tooltip's maximum size is specified by `x-max-tooltip-size'.
5102 Text larger than the specified size is clipped. */)
5103 (string, frame, parms, timeout, dx, dy)
5104 Lisp_Object string, frame, parms, timeout, dx, dy;
5106 struct frame *f;
5107 struct window *w;
5108 int root_x, root_y;
5109 struct buffer *old_buffer;
5110 struct text_pos pos;
5111 int i, width, height;
5112 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
5113 int old_windows_or_buffers_changed = windows_or_buffers_changed;
5114 int count = SPECPDL_INDEX ();
5116 specbind (Qinhibit_redisplay, Qt);
5118 GCPRO4 (string, parms, frame, timeout);
5120 CHECK_STRING (string);
5121 if (SCHARS (string) == 0)
5122 string = make_unibyte_string (" ", 1);
5124 f = check_x_frame (frame);
5125 if (NILP (timeout))
5126 timeout = make_number (5);
5127 else
5128 CHECK_NATNUM (timeout);
5130 if (NILP (dx))
5131 dx = make_number (5);
5132 else
5133 CHECK_NUMBER (dx);
5135 if (NILP (dy))
5136 dy = make_number (-10);
5137 else
5138 CHECK_NUMBER (dy);
5140 if (NILP (last_show_tip_args))
5141 last_show_tip_args = Fmake_vector (make_number (3), Qnil);
5143 if (!NILP (tip_frame))
5145 Lisp_Object last_string = AREF (last_show_tip_args, 0);
5146 Lisp_Object last_frame = AREF (last_show_tip_args, 1);
5147 Lisp_Object last_parms = AREF (last_show_tip_args, 2);
5149 if (EQ (frame, last_frame)
5150 && !NILP (Fequal (last_string, string))
5151 && !NILP (Fequal (last_parms, parms)))
5153 struct frame *f = XFRAME (tip_frame);
5155 /* Only DX and DY have changed. */
5156 if (!NILP (tip_timer))
5158 Lisp_Object timer = tip_timer;
5159 tip_timer = Qnil;
5160 call1 (Qcancel_timer, timer);
5163 BLOCK_INPUT;
5164 compute_tip_xy (f, parms, dx, dy, FRAME_PIXEL_WIDTH (f),
5165 FRAME_PIXEL_HEIGHT (f), &root_x, &root_y);
5166 XMoveWindow (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
5167 root_x, root_y);
5168 UNBLOCK_INPUT;
5169 goto start_timer;
5173 /* Hide a previous tip, if any. */
5174 Fx_hide_tip ();
5176 ASET (last_show_tip_args, 0, string);
5177 ASET (last_show_tip_args, 1, frame);
5178 ASET (last_show_tip_args, 2, parms);
5180 /* Add default values to frame parameters. */
5181 if (NILP (Fassq (Qname, parms)))
5182 parms = Fcons (Fcons (Qname, build_string ("tooltip")), parms);
5183 if (NILP (Fassq (Qinternal_border_width, parms)))
5184 parms = Fcons (Fcons (Qinternal_border_width, make_number (3)), parms);
5185 if (NILP (Fassq (Qborder_width, parms)))
5186 parms = Fcons (Fcons (Qborder_width, make_number (1)), parms);
5187 if (NILP (Fassq (Qborder_color, parms)))
5188 parms = Fcons (Fcons (Qborder_color, build_string ("lightyellow")), parms);
5189 if (NILP (Fassq (Qbackground_color, parms)))
5190 parms = Fcons (Fcons (Qbackground_color, build_string ("lightyellow")),
5191 parms);
5193 /* Create a frame for the tooltip, and record it in the global
5194 variable tip_frame. */
5195 frame = x_create_tip_frame (FRAME_X_DISPLAY_INFO (f), parms, string);
5196 f = XFRAME (frame);
5198 /* Set up the frame's root window. */
5199 w = XWINDOW (FRAME_ROOT_WINDOW (f));
5200 w->left_col = w->top_line = make_number (0);
5202 if (CONSP (Vx_max_tooltip_size)
5203 && INTEGERP (XCAR (Vx_max_tooltip_size))
5204 && XINT (XCAR (Vx_max_tooltip_size)) > 0
5205 && INTEGERP (XCDR (Vx_max_tooltip_size))
5206 && XINT (XCDR (Vx_max_tooltip_size)) > 0)
5208 w->total_cols = XCAR (Vx_max_tooltip_size);
5209 w->total_lines = XCDR (Vx_max_tooltip_size);
5211 else
5213 w->total_cols = make_number (80);
5214 w->total_lines = make_number (40);
5217 FRAME_TOTAL_COLS (f) = XINT (w->total_cols);
5218 adjust_glyphs (f);
5219 w->pseudo_window_p = 1;
5221 /* Display the tooltip text in a temporary buffer. */
5222 old_buffer = current_buffer;
5223 set_buffer_internal_1 (XBUFFER (XWINDOW (FRAME_ROOT_WINDOW (f))->buffer));
5224 current_buffer->truncate_lines = Qnil;
5225 clear_glyph_matrix (w->desired_matrix);
5226 clear_glyph_matrix (w->current_matrix);
5227 SET_TEXT_POS (pos, BEGV, BEGV_BYTE);
5228 try_window (FRAME_ROOT_WINDOW (f), pos, 0);
5230 /* Compute width and height of the tooltip. */
5231 width = height = 0;
5232 for (i = 0; i < w->desired_matrix->nrows; ++i)
5234 struct glyph_row *row = &w->desired_matrix->rows[i];
5235 struct glyph *last;
5236 int row_width;
5238 /* Stop at the first empty row at the end. */
5239 if (!row->enabled_p || !row->displays_text_p)
5240 break;
5242 /* Let the row go over the full width of the frame. */
5243 row->full_width_p = 1;
5245 /* There's a glyph at the end of rows that is used to place
5246 the cursor there. Don't include the width of this glyph. */
5247 if (row->used[TEXT_AREA])
5249 last = &row->glyphs[TEXT_AREA][row->used[TEXT_AREA] - 1];
5250 row_width = row->pixel_width - last->pixel_width;
5252 else
5253 row_width = row->pixel_width;
5255 height += row->height;
5256 width = max (width, row_width);
5259 /* Add the frame's internal border to the width and height the X
5260 window should have. */
5261 height += 2 * FRAME_INTERNAL_BORDER_WIDTH (f);
5262 width += 2 * FRAME_INTERNAL_BORDER_WIDTH (f);
5264 /* Move the tooltip window where the mouse pointer is. Resize and
5265 show it. */
5266 compute_tip_xy (f, parms, dx, dy, width, height, &root_x, &root_y);
5268 BLOCK_INPUT;
5269 XMoveResizeWindow (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
5270 root_x, root_y, width, height);
5271 XMapRaised (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f));
5272 UNBLOCK_INPUT;
5274 /* Draw into the window. */
5275 w->must_be_updated_p = 1;
5276 update_single_window (w, 1);
5278 /* Restore original current buffer. */
5279 set_buffer_internal_1 (old_buffer);
5280 windows_or_buffers_changed = old_windows_or_buffers_changed;
5282 start_timer:
5283 /* Let the tip disappear after timeout seconds. */
5284 tip_timer = call3 (intern ("run-at-time"), timeout, Qnil,
5285 intern ("x-hide-tip"));
5287 UNGCPRO;
5288 return unbind_to (count, Qnil);
5292 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
5293 doc: /* Hide the current tooltip window, if there is any.
5294 Value is t if tooltip was open, nil otherwise. */)
5297 int count;
5298 Lisp_Object deleted, frame, timer;
5299 struct gcpro gcpro1, gcpro2;
5301 /* Return quickly if nothing to do. */
5302 if (NILP (tip_timer) && NILP (tip_frame))
5303 return Qnil;
5305 frame = tip_frame;
5306 timer = tip_timer;
5307 GCPRO2 (frame, timer);
5308 tip_frame = tip_timer = deleted = Qnil;
5310 count = SPECPDL_INDEX ();
5311 specbind (Qinhibit_redisplay, Qt);
5312 specbind (Qinhibit_quit, Qt);
5314 if (!NILP (timer))
5315 call1 (Qcancel_timer, timer);
5317 if (FRAMEP (frame))
5319 Fdelete_frame (frame, Qnil);
5320 deleted = Qt;
5322 #ifdef USE_LUCID
5323 /* Bloodcurdling hack alert: The Lucid menu bar widget's
5324 redisplay procedure is not called when a tip frame over menu
5325 items is unmapped. Redisplay the menu manually... */
5327 struct frame *f = SELECTED_FRAME ();
5328 Widget w = f->output_data.x->menubar_widget;
5329 extern void xlwmenu_redisplay P_ ((Widget));
5331 if (!DoesSaveUnders (FRAME_X_DISPLAY_INFO (f)->screen)
5332 && w != NULL)
5334 BLOCK_INPUT;
5335 xlwmenu_redisplay (w);
5336 UNBLOCK_INPUT;
5339 #endif /* USE_LUCID */
5342 UNGCPRO;
5343 return unbind_to (count, deleted);
5348 /***********************************************************************
5349 File selection dialog
5350 ***********************************************************************/
5352 DEFUN ("x-uses-old-gtk-dialog", Fx_uses_old_gtk_dialog,
5353 Sx_uses_old_gtk_dialog,
5354 0, 0, 0,
5355 doc: /* Return t if the old Gtk+ file selection dialog is used. */)
5358 #ifdef USE_GTK
5359 extern int use_dialog_box;
5360 extern int use_file_dialog;
5362 if (use_dialog_box
5363 && use_file_dialog
5364 && have_menus_p ()
5365 && xg_uses_old_file_dialog ())
5366 return Qt;
5367 #endif
5368 return Qnil;
5372 #ifdef USE_MOTIF
5373 /* Callback for "OK" and "Cancel" on file selection dialog. */
5375 static void
5376 file_dialog_cb (widget, client_data, call_data)
5377 Widget widget;
5378 XtPointer call_data, client_data;
5380 int *result = (int *) client_data;
5381 XmAnyCallbackStruct *cb = (XmAnyCallbackStruct *) call_data;
5382 *result = cb->reason;
5386 /* Callback for unmapping a file selection dialog. This is used to
5387 capture the case where a dialog is closed via a window manager's
5388 closer button, for example. Using a XmNdestroyCallback didn't work
5389 in this case. */
5391 static void
5392 file_dialog_unmap_cb (widget, client_data, call_data)
5393 Widget widget;
5394 XtPointer call_data, client_data;
5396 int *result = (int *) client_data;
5397 *result = XmCR_CANCEL;
5400 static Lisp_Object
5401 clean_up_file_dialog (arg)
5402 Lisp_Object arg;
5404 struct Lisp_Save_Value *p = XSAVE_VALUE (arg);
5405 Widget dialog = (Widget) p->pointer;
5407 /* Clean up. */
5408 BLOCK_INPUT;
5409 XtUnmanageChild (dialog);
5410 XtDestroyWidget (dialog);
5411 x_menu_set_in_use (0);
5412 UNBLOCK_INPUT;
5414 return Qnil;
5418 DEFUN ("x-file-dialog", Fx_file_dialog, Sx_file_dialog, 2, 5, 0,
5419 doc: /* Read file name, prompting with PROMPT in directory DIR.
5420 Use a file selection dialog. Select DEFAULT-FILENAME in the dialog's file
5421 selection box, if specified. If MUSTMATCH is non-nil, the returned file
5422 or directory must exist. ONLY-DIR-P is ignored." */)
5423 (prompt, dir, default_filename, mustmatch, only_dir_p)
5424 Lisp_Object prompt, dir, default_filename, mustmatch, only_dir_p;
5426 int result;
5427 struct frame *f = SELECTED_FRAME ();
5428 Lisp_Object file = Qnil;
5429 Lisp_Object decoded_file;
5430 Widget dialog, text, help;
5431 Arg al[10];
5432 int ac = 0;
5433 extern XtAppContext Xt_app_con;
5434 XmString dir_xmstring, pattern_xmstring;
5435 int count = SPECPDL_INDEX ();
5436 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
5438 check_x ();
5440 GCPRO6 (prompt, dir, default_filename, mustmatch, only_dir_p, file);
5442 if (popup_activated ())
5443 error ("Trying to use a menu from within a menu-entry");
5445 CHECK_STRING (prompt);
5446 CHECK_STRING (dir);
5448 /* Prevent redisplay. */
5449 specbind (Qinhibit_redisplay, Qt);
5451 BLOCK_INPUT;
5453 /* Create the dialog with PROMPT as title, using DIR as initial
5454 directory and using "*" as pattern. */
5455 dir = Fexpand_file_name (dir, Qnil);
5456 dir_xmstring = XmStringCreateLocalized (SDATA (dir));
5457 pattern_xmstring = XmStringCreateLocalized ("*");
5459 XtSetArg (al[ac], XmNtitle, SDATA (prompt)); ++ac;
5460 XtSetArg (al[ac], XmNdirectory, dir_xmstring); ++ac;
5461 XtSetArg (al[ac], XmNpattern, pattern_xmstring); ++ac;
5462 XtSetArg (al[ac], XmNresizePolicy, XmRESIZE_GROW); ++ac;
5463 XtSetArg (al[ac], XmNdialogStyle, XmDIALOG_APPLICATION_MODAL); ++ac;
5464 dialog = XmCreateFileSelectionDialog (f->output_data.x->widget,
5465 "fsb", al, ac);
5466 XmStringFree (dir_xmstring);
5467 XmStringFree (pattern_xmstring);
5469 /* Add callbacks for OK and Cancel. */
5470 XtAddCallback (dialog, XmNokCallback, file_dialog_cb,
5471 (XtPointer) &result);
5472 XtAddCallback (dialog, XmNcancelCallback, file_dialog_cb,
5473 (XtPointer) &result);
5474 XtAddCallback (dialog, XmNunmapCallback, file_dialog_unmap_cb,
5475 (XtPointer) &result);
5477 /* Remove the help button since we can't display help. */
5478 help = XmFileSelectionBoxGetChild (dialog, XmDIALOG_HELP_BUTTON);
5479 XtUnmanageChild (help);
5481 /* Mark OK button as default. */
5482 XtVaSetValues (XmFileSelectionBoxGetChild (dialog, XmDIALOG_OK_BUTTON),
5483 XmNshowAsDefault, True, NULL);
5485 /* If MUSTMATCH is non-nil, disable the file entry field of the
5486 dialog, so that the user must select a file from the files list
5487 box. We can't remove it because we wouldn't have a way to get at
5488 the result file name, then. */
5489 text = XmFileSelectionBoxGetChild (dialog, XmDIALOG_TEXT);
5490 if (!NILP (mustmatch))
5492 Widget label;
5493 label = XmFileSelectionBoxGetChild (dialog, XmDIALOG_SELECTION_LABEL);
5494 XtSetSensitive (text, False);
5495 XtSetSensitive (label, False);
5498 /* Manage the dialog, so that list boxes get filled. */
5499 XtManageChild (dialog);
5501 if (STRINGP (default_filename))
5503 XmString default_xmstring;
5504 Widget wtext = XmFileSelectionBoxGetChild (dialog, XmDIALOG_TEXT);
5505 Widget list = XmFileSelectionBoxGetChild (dialog, XmDIALOG_LIST);
5507 XmTextPosition last_pos = XmTextFieldGetLastPosition (wtext);
5508 XmTextFieldReplace (wtext, 0, last_pos,
5509 (SDATA (Ffile_name_nondirectory (default_filename))));
5511 /* Select DEFAULT_FILENAME in the files list box. DEFAULT_FILENAME
5512 must include the path for this to work. */
5514 default_xmstring = XmStringCreateLocalized (SDATA (default_filename));
5516 if (XmListItemExists (list, default_xmstring))
5518 int item_pos = XmListItemPos (list, default_xmstring);
5519 /* Select the item and scroll it into view. */
5520 XmListSelectPos (list, item_pos, True);
5521 XmListSetPos (list, item_pos);
5524 XmStringFree (default_xmstring);
5527 record_unwind_protect (clean_up_file_dialog, make_save_value (dialog, 0));
5529 /* Process events until the user presses Cancel or OK. */
5530 x_menu_set_in_use (1);
5531 result = 0;
5532 while (result == 0)
5534 XEvent event;
5535 x_menu_wait_for_event (0);
5536 XtAppNextEvent (Xt_app_con, &event);
5537 if (event.type == KeyPress
5538 && FRAME_X_DISPLAY (f) == event.xkey.display)
5540 KeySym keysym = XLookupKeysym (&event.xkey, 0);
5542 /* Pop down on C-g. */
5543 if (keysym == XK_g && (event.xkey.state & ControlMask) != 0)
5544 XtUnmanageChild (dialog);
5547 (void) x_dispatch_event (&event, FRAME_X_DISPLAY (f));
5550 /* Get the result. */
5551 if (result == XmCR_OK)
5553 XmString text;
5554 String data;
5556 XtVaGetValues (dialog, XmNtextString, &text, NULL);
5557 XmStringGetLtoR (text, XmFONTLIST_DEFAULT_TAG, &data);
5558 XmStringFree (text);
5559 file = build_string (data);
5560 XtFree (data);
5562 else
5563 file = Qnil;
5565 UNBLOCK_INPUT;
5566 UNGCPRO;
5568 /* Make "Cancel" equivalent to C-g. */
5569 if (NILP (file))
5570 Fsignal (Qquit, Qnil);
5572 decoded_file = DECODE_FILE (file);
5574 return unbind_to (count, decoded_file);
5577 #endif /* USE_MOTIF */
5579 #ifdef USE_GTK
5581 static Lisp_Object
5582 clean_up_dialog (arg)
5583 Lisp_Object arg;
5585 x_menu_set_in_use (0);
5587 return Qnil;
5590 DEFUN ("x-file-dialog", Fx_file_dialog, Sx_file_dialog, 2, 5, 0,
5591 doc: /* Read file name, prompting with PROMPT in directory DIR.
5592 Use a file selection dialog. Select DEFAULT-FILENAME in the dialog's file
5593 selection box, if specified. If MUSTMATCH is non-nil, the returned file
5594 or directory must exist. If ONLY-DIR-P is non-nil, the user can only select
5595 directories. */)
5596 (prompt, dir, default_filename, mustmatch, only_dir_p)
5597 Lisp_Object prompt, dir, default_filename, mustmatch, only_dir_p;
5599 FRAME_PTR f = SELECTED_FRAME ();
5600 char *fn;
5601 Lisp_Object file = Qnil;
5602 Lisp_Object decoded_file;
5603 int count = SPECPDL_INDEX ();
5604 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
5605 char *cdef_file;
5607 check_x ();
5609 GCPRO6 (prompt, dir, default_filename, mustmatch, only_dir_p, file);
5611 if (popup_activated ())
5612 error ("Trying to use a menu from within a menu-entry");
5614 CHECK_STRING (prompt);
5615 CHECK_STRING (dir);
5617 /* Prevent redisplay. */
5618 specbind (Qinhibit_redisplay, Qt);
5619 record_unwind_protect (clean_up_dialog, Qnil);
5621 BLOCK_INPUT;
5623 if (STRINGP (default_filename))
5624 cdef_file = SDATA (default_filename);
5625 else
5626 cdef_file = SDATA (dir);
5628 fn = xg_get_file_name (f, SDATA (prompt), cdef_file,
5629 ! NILP (mustmatch),
5630 ! NILP (only_dir_p));
5632 if (fn)
5634 file = build_string (fn);
5635 xfree (fn);
5638 UNBLOCK_INPUT;
5639 UNGCPRO;
5641 /* Make "Cancel" equivalent to C-g. */
5642 if (NILP (file))
5643 Fsignal (Qquit, Qnil);
5645 decoded_file = DECODE_FILE (file);
5647 return unbind_to (count, decoded_file);
5651 #ifdef HAVE_FREETYPE
5653 DEFUN ("x-select-font", Fx_select_font, Sx_select_font, 0, 2, 0,
5654 doc: /* Read a font name using a GTK font selection dialog.
5655 Return a GTK-style font string corresponding to the selection.
5657 If FRAME is omitted or nil, it defaults to the selected frame. */)
5658 (frame, ignored)
5659 Lisp_Object frame, ignored;
5661 FRAME_PTR f = check_x_frame (frame);
5662 char *name;
5663 Lisp_Object default_font, font = Qnil;
5664 int count = SPECPDL_INDEX ();
5666 check_x ();
5668 if (popup_activated ())
5669 error ("Trying to use a menu from within a menu-entry");
5671 /* Prevent redisplay. */
5672 specbind (Qinhibit_redisplay, Qt);
5673 record_unwind_protect (clean_up_dialog, Qnil);
5675 BLOCK_INPUT;
5677 XSETFONT (default_font, FRAME_FONT (f));
5678 if (FONTP (default_font))
5680 char *default_name = alloca (256);
5681 if (font_unparse_gtkname (default_font, f, default_name, 256) < 0)
5682 default_name = NULL;
5683 name = xg_get_font_name (f, default_name);
5685 else
5686 name = xg_get_font_name (f, NULL);
5688 if (name)
5690 font = build_string (name);
5691 xfree (name);
5694 UNBLOCK_INPUT;
5696 if (NILP (font))
5697 Fsignal (Qquit, Qnil);
5699 return unbind_to (count, font);
5701 #endif /* HAVE_FREETYPE */
5703 #endif /* USE_GTK */
5706 /***********************************************************************
5707 Keyboard
5708 ***********************************************************************/
5710 #ifdef HAVE_XKBGETKEYBOARD
5711 #include <X11/XKBlib.h>
5712 #include <X11/keysym.h>
5713 #endif
5715 DEFUN ("x-backspace-delete-keys-p", Fx_backspace_delete_keys_p,
5716 Sx_backspace_delete_keys_p, 0, 1, 0,
5717 doc: /* Check if both Backspace and Delete keys are on the keyboard of FRAME.
5718 FRAME nil means use the selected frame.
5719 Value is t if we know that both keys are present, and are mapped to the
5720 usual X keysyms. Value is `lambda' if we cannot determine if both keys are
5721 present and mapped to the usual X keysyms. */)
5722 (frame)
5723 Lisp_Object frame;
5725 #ifdef HAVE_XKBGETKEYBOARD
5726 XkbDescPtr kb;
5727 struct frame *f = check_x_frame (frame);
5728 Display *dpy = FRAME_X_DISPLAY (f);
5729 Lisp_Object have_keys;
5730 int major, minor, op, event, error;
5732 BLOCK_INPUT;
5734 /* Check library version in case we're dynamically linked. */
5735 major = XkbMajorVersion;
5736 minor = XkbMinorVersion;
5737 if (!XkbLibraryVersion (&major, &minor))
5739 UNBLOCK_INPUT;
5740 return Qlambda;
5743 /* Check that the server supports XKB. */
5744 major = XkbMajorVersion;
5745 minor = XkbMinorVersion;
5746 if (!XkbQueryExtension (dpy, &op, &event, &error, &major, &minor))
5748 UNBLOCK_INPUT;
5749 return Qlambda;
5752 /* In this code we check that the keyboard has physical keys with names
5753 that start with BKSP (Backspace) and DELE (Delete), and that they
5754 generate keysym XK_BackSpace and XK_Delete respectively.
5755 This function is used to test if normal-erase-is-backspace should be
5756 turned on.
5757 An alternative approach would be to just check if XK_BackSpace and
5758 XK_Delete are mapped to any key. But if any of those are mapped to
5759 some non-intuitive key combination (Meta-Shift-Ctrl-whatever) and the
5760 user doesn't know about it, it is better to return false here.
5761 It is more obvious to the user what to do if she/he has two keys
5762 clearly marked with names/symbols and one key does something not
5763 expected (i.e. she/he then tries the other).
5764 The cases where Backspace/Delete is mapped to some other key combination
5765 are rare, and in those cases, normal-erase-is-backspace can be turned on
5766 manually. */
5768 have_keys = Qnil;
5769 kb = XkbGetMap (dpy, XkbAllMapComponentsMask, XkbUseCoreKbd);
5770 if (kb)
5772 int delete_keycode = 0, backspace_keycode = 0, i;
5774 if (XkbGetNames (dpy, XkbAllNamesMask, kb) == Success)
5776 for (i = kb->min_key_code;
5777 (i < kb->max_key_code
5778 && (delete_keycode == 0 || backspace_keycode == 0));
5779 ++i)
5781 /* The XKB symbolic key names can be seen most easily in
5782 the PS file generated by `xkbprint -label name
5783 $DISPLAY'. */
5784 if (bcmp ("DELE", kb->names->keys[i].name, 4) == 0)
5785 delete_keycode = i;
5786 else if (bcmp ("BKSP", kb->names->keys[i].name, 4) == 0)
5787 backspace_keycode = i;
5790 XkbFreeNames (kb, 0, True);
5793 XkbFreeClientMap (kb, 0, True);
5795 if (delete_keycode
5796 && backspace_keycode
5797 && XKeysymToKeycode (dpy, XK_Delete) == delete_keycode
5798 && XKeysymToKeycode (dpy, XK_BackSpace) == backspace_keycode)
5799 have_keys = Qt;
5801 UNBLOCK_INPUT;
5802 return have_keys;
5803 #else /* not HAVE_XKBGETKEYBOARD */
5804 return Qlambda;
5805 #endif /* not HAVE_XKBGETKEYBOARD */
5810 /***********************************************************************
5811 Initialization
5812 ***********************************************************************/
5814 /* Keep this list in the same order as frame_parms in frame.c.
5815 Use 0 for unsupported frame parameters. */
5817 frame_parm_handler x_frame_parm_handlers[] =
5819 x_set_autoraise,
5820 x_set_autolower,
5821 x_set_background_color,
5822 x_set_border_color,
5823 x_set_border_width,
5824 x_set_cursor_color,
5825 x_set_cursor_type,
5826 x_set_font,
5827 x_set_foreground_color,
5828 x_set_icon_name,
5829 x_set_icon_type,
5830 x_set_internal_border_width,
5831 x_set_menu_bar_lines,
5832 x_set_mouse_color,
5833 x_explicitly_set_name,
5834 x_set_scroll_bar_width,
5835 x_set_title,
5836 x_set_unsplittable,
5837 x_set_vertical_scroll_bars,
5838 x_set_visibility,
5839 x_set_tool_bar_lines,
5840 x_set_scroll_bar_foreground,
5841 x_set_scroll_bar_background,
5842 x_set_screen_gamma,
5843 x_set_line_spacing,
5844 x_set_fringe_width,
5845 x_set_fringe_width,
5846 x_set_wait_for_wm,
5847 x_set_fullscreen,
5848 x_set_font_backend,
5849 x_set_alpha
5852 void
5853 syms_of_xfns ()
5855 /* This is zero if not using X windows. */
5856 x_in_use = 0;
5858 /* The section below is built by the lisp expression at the top of the file,
5859 just above where these variables are declared. */
5860 /*&&& init symbols here &&&*/
5861 Qnone = intern ("none");
5862 staticpro (&Qnone);
5863 Qsuppress_icon = intern ("suppress-icon");
5864 staticpro (&Qsuppress_icon);
5865 Qundefined_color = intern ("undefined-color");
5866 staticpro (&Qundefined_color);
5867 Qcompound_text = intern ("compound-text");
5868 staticpro (&Qcompound_text);
5869 Qcancel_timer = intern ("cancel-timer");
5870 staticpro (&Qcancel_timer);
5871 Qfont_param = intern ("font-parameter");
5872 staticpro (&Qfont_param);
5873 /* This is the end of symbol initialization. */
5875 /* Text property `display' should be nonsticky by default. */
5876 Vtext_property_default_nonsticky
5877 = Fcons (Fcons (Qdisplay, Qt), Vtext_property_default_nonsticky);
5880 Fput (Qundefined_color, Qerror_conditions,
5881 Fcons (Qundefined_color, Fcons (Qerror, Qnil)));
5882 Fput (Qundefined_color, Qerror_message,
5883 build_string ("Undefined color"));
5885 DEFVAR_LISP ("x-pointer-shape", &Vx_pointer_shape,
5886 doc: /* The shape of the pointer when over text.
5887 Changing the value does not affect existing frames
5888 unless you set the mouse color. */);
5889 Vx_pointer_shape = Qnil;
5891 #if 0 /* This doesn't really do anything. */
5892 DEFVAR_LISP ("x-nontext-pointer-shape", &Vx_nontext_pointer_shape,
5893 doc: /* The shape of the pointer when not over text.
5894 This variable takes effect when you create a new frame
5895 or when you set the mouse color. */);
5896 #endif
5897 Vx_nontext_pointer_shape = Qnil;
5899 DEFVAR_LISP ("x-hourglass-pointer-shape", &Vx_hourglass_pointer_shape,
5900 doc: /* The shape of the pointer when Emacs is busy.
5901 This variable takes effect when you create a new frame
5902 or when you set the mouse color. */);
5903 Vx_hourglass_pointer_shape = Qnil;
5905 DEFVAR_BOOL ("display-hourglass", &display_hourglass_p,
5906 doc: /* Non-zero means Emacs displays an hourglass pointer on window systems. */);
5907 display_hourglass_p = 1;
5909 DEFVAR_LISP ("hourglass-delay", &Vhourglass_delay,
5910 doc: /* *Seconds to wait before displaying an hourglass pointer.
5911 Value must be an integer or float. */);
5912 Vhourglass_delay = make_number (DEFAULT_HOURGLASS_DELAY);
5914 #if 0 /* This doesn't really do anything. */
5915 DEFVAR_LISP ("x-mode-pointer-shape", &Vx_mode_pointer_shape,
5916 doc: /* The shape of the pointer when over the mode line.
5917 This variable takes effect when you create a new frame
5918 or when you set the mouse color. */);
5919 #endif
5920 Vx_mode_pointer_shape = Qnil;
5922 DEFVAR_LISP ("x-sensitive-text-pointer-shape",
5923 &Vx_sensitive_text_pointer_shape,
5924 doc: /* The shape of the pointer when over mouse-sensitive text.
5925 This variable takes effect when you create a new frame
5926 or when you set the mouse color. */);
5927 Vx_sensitive_text_pointer_shape = Qnil;
5929 DEFVAR_LISP ("x-window-horizontal-drag-cursor",
5930 &Vx_window_horizontal_drag_shape,
5931 doc: /* Pointer shape to use for indicating a window can be dragged horizontally.
5932 This variable takes effect when you create a new frame
5933 or when you set the mouse color. */);
5934 Vx_window_horizontal_drag_shape = Qnil;
5936 DEFVAR_LISP ("x-cursor-fore-pixel", &Vx_cursor_fore_pixel,
5937 doc: /* A string indicating the foreground color of the cursor box. */);
5938 Vx_cursor_fore_pixel = Qnil;
5940 DEFVAR_LISP ("x-max-tooltip-size", &Vx_max_tooltip_size,
5941 doc: /* Maximum size for tooltips. Value is a pair (COLUMNS . ROWS).
5942 Text larger than this is clipped. */);
5943 Vx_max_tooltip_size = Fcons (make_number (80), make_number (40));
5945 DEFVAR_LISP ("x-no-window-manager", &Vx_no_window_manager,
5946 doc: /* Non-nil if no X window manager is in use.
5947 Emacs doesn't try to figure this out; this is always nil
5948 unless you set it to something else. */);
5949 /* We don't have any way to find this out, so set it to nil
5950 and maybe the user would like to set it to t. */
5951 Vx_no_window_manager = Qnil;
5953 DEFVAR_LISP ("x-pixel-size-width-font-regexp",
5954 &Vx_pixel_size_width_font_regexp,
5955 doc: /* Regexp matching a font name whose width is the same as `PIXEL_SIZE'.
5957 Since Emacs gets width of a font matching with this regexp from
5958 PIXEL_SIZE field of the name, font finding mechanism gets faster for
5959 such a font. This is especially effective for such large fonts as
5960 Chinese, Japanese, and Korean. */);
5961 Vx_pixel_size_width_font_regexp = Qnil;
5963 /* This is not ifdef:ed, so other builds than GTK can customize it. */
5964 DEFVAR_BOOL ("x-gtk-use-old-file-dialog", &x_gtk_use_old_file_dialog,
5965 doc: /* *Non-nil means prompt with the old GTK file selection dialog.
5966 If nil or if the file selection dialog is not available, the new GTK file
5967 chooser is used instead. To turn off all file dialogs set the
5968 variable `use-file-dialog'. */);
5969 x_gtk_use_old_file_dialog = 0;
5971 DEFVAR_BOOL ("x-gtk-show-hidden-files", &x_gtk_show_hidden_files,
5972 doc: /* *If non-nil, the GTK file chooser will by default show hidden files.
5973 Note that this is just the default, there is a toggle button on the file
5974 chooser to show or not show hidden files on a case by case basis. */);
5975 x_gtk_show_hidden_files = 0;
5977 DEFVAR_BOOL ("x-gtk-file-dialog-help-text", &x_gtk_file_dialog_help_text,
5978 doc: /* *If non-nil, the GTK file chooser will show additional help text.
5979 If more space for files in the file chooser dialog is wanted, set this to nil
5980 to turn the additional text off. */);
5981 x_gtk_file_dialog_help_text = 1;
5983 DEFVAR_BOOL ("x-gtk-whole-detached-tool-bar", &x_gtk_whole_detached_tool_bar,
5984 doc: /* *If non-nil, a detached tool bar is shown in full.
5985 The default is to just show an arrow and pressing on that arrow shows
5986 the tool bar buttons. */);
5987 x_gtk_whole_detached_tool_bar = 0;
5989 Fprovide (intern ("x"), Qnil);
5991 #ifdef USE_X_TOOLKIT
5992 Fprovide (intern ("x-toolkit"), Qnil);
5993 #ifdef USE_MOTIF
5994 Fprovide (intern ("motif"), Qnil);
5996 DEFVAR_LISP ("motif-version-string", &Vmotif_version_string,
5997 doc: /* Version info for LessTif/Motif. */);
5998 Vmotif_version_string = build_string (XmVERSION_STRING);
5999 #endif /* USE_MOTIF */
6000 #endif /* USE_X_TOOLKIT */
6002 #ifdef USE_GTK
6003 /* Provide x-toolkit also for GTK. Internally GTK does not use Xt so it
6004 is not an X toolkit in that sense (USE_X_TOOLKIT is not defined).
6005 But for a user it is a toolkit for X, and indeed, configure
6006 accepts --with-x-toolkit=gtk. */
6007 Fprovide (intern ("x-toolkit"), Qnil);
6008 Fprovide (intern ("gtk"), Qnil);
6010 DEFVAR_LISP ("gtk-version-string", &Vgtk_version_string,
6011 doc: /* Version info for GTK+. */);
6013 char gtk_version[40];
6014 g_snprintf (gtk_version, sizeof (gtk_version), "%u.%u.%u",
6015 GTK_MAJOR_VERSION, GTK_MINOR_VERSION, GTK_MICRO_VERSION);
6016 Vgtk_version_string = build_string (gtk_version);
6018 #endif /* USE_GTK */
6020 /* X window properties. */
6021 defsubr (&Sx_change_window_property);
6022 defsubr (&Sx_delete_window_property);
6023 defsubr (&Sx_window_property);
6025 defsubr (&Sxw_display_color_p);
6026 defsubr (&Sx_display_grayscale_p);
6027 defsubr (&Sxw_color_defined_p);
6028 defsubr (&Sxw_color_values);
6029 defsubr (&Sx_server_max_request_size);
6030 defsubr (&Sx_server_vendor);
6031 defsubr (&Sx_server_version);
6032 defsubr (&Sx_display_pixel_width);
6033 defsubr (&Sx_display_pixel_height);
6034 defsubr (&Sx_display_mm_width);
6035 defsubr (&Sx_display_mm_height);
6036 defsubr (&Sx_display_screens);
6037 defsubr (&Sx_display_planes);
6038 defsubr (&Sx_display_color_cells);
6039 defsubr (&Sx_display_visual_class);
6040 defsubr (&Sx_display_backing_store);
6041 defsubr (&Sx_display_save_under);
6042 defsubr (&Sx_create_frame);
6043 defsubr (&Sx_open_connection);
6044 defsubr (&Sx_close_connection);
6045 defsubr (&Sx_display_list);
6046 defsubr (&Sx_synchronize);
6047 defsubr (&Sx_focus_frame);
6048 defsubr (&Sx_backspace_delete_keys_p);
6050 /* Setting callback functions for fontset handler. */
6051 check_window_system_func = check_x;
6053 hourglass_atimer = NULL;
6054 hourglass_shown_p = 0;
6056 defsubr (&Sx_show_tip);
6057 defsubr (&Sx_hide_tip);
6058 tip_timer = Qnil;
6059 staticpro (&tip_timer);
6060 tip_frame = Qnil;
6061 staticpro (&tip_frame);
6063 last_show_tip_args = Qnil;
6064 staticpro (&last_show_tip_args);
6066 defsubr (&Sx_uses_old_gtk_dialog);
6067 #if defined (USE_MOTIF) || defined (USE_GTK)
6068 defsubr (&Sx_file_dialog);
6069 #endif
6071 #ifdef USE_GTK
6072 defsubr (&Sx_select_font);
6073 #endif
6076 #endif /* HAVE_X_WINDOWS */
6078 /* arch-tag: 55040d02-5485-4d58-8b22-95a7a05f3288
6079 (do not change this comment) */