* lisp/vc/vc-bzr.el (vc-bzr-state-heuristic): Save match-data around sha1.
[emacs.git] / src / xfns.c
blob510a66d634922660e911e07d8ef441726c68dbb1
1 /* Functions for the X window system.
3 Copyright (C) 1989, 1992-2012 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software: you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation, either version 3 of the License, or
10 (at your option) any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
20 #include <config.h>
21 #include <stdio.h>
22 #include <math.h>
23 #include <setjmp.h>
24 #include <ctype.h>
25 #include <unistd.h>
27 /* This makes the fields of a Display accessible, in Xlib header files. */
29 #define XLIB_ILLEGAL_ACCESS
31 #include "lisp.h"
32 #include "xterm.h"
33 #include "frame.h"
34 #include "window.h"
35 #include "buffer.h"
36 #include "intervals.h"
37 #include "dispextern.h"
38 #include "keyboard.h"
39 #include "blockinput.h"
40 #include <epaths.h>
41 #include "character.h"
42 #include "charset.h"
43 #include "coding.h"
44 #include "fontset.h"
45 #include "systime.h"
46 #include "termhooks.h"
47 #include "atimer.h"
48 #include "termchar.h"
49 #include "font.h"
51 #ifdef HAVE_X_WINDOWS
53 #include <ctype.h>
54 #include <sys/types.h>
55 #include <sys/stat.h>
57 #if 1 /* Used to be #ifdef EMACS_BITMAP_FILES, but this should always work. */
58 #include "bitmaps/gray.xbm"
59 #else
60 #include <X11/bitmaps/gray>
61 #endif
63 #include "xsettings.h"
65 #ifdef USE_GTK
66 #include "gtkutil.h"
67 #endif
69 #ifdef USE_X_TOOLKIT
70 #include <X11/Shell.h>
72 #ifndef USE_MOTIF
73 #ifdef HAVE_XAW3D
74 #include <X11/Xaw3d/Paned.h>
75 #include <X11/Xaw3d/Label.h>
76 #else /* !HAVE_XAW3D */
77 #include <X11/Xaw/Paned.h>
78 #include <X11/Xaw/Label.h>
79 #endif /* HAVE_XAW3D */
80 #endif /* USE_MOTIF */
82 #ifdef USG
83 #undef USG /* ####KLUDGE for Solaris 2.2 and up */
84 #include <X11/Xos.h>
85 #define USG
86 #ifdef USG /* Pacify gcc -Wunused-macros. */
87 #endif
88 #else
89 #include <X11/Xos.h>
90 #endif
92 #include "widget.h"
94 #include "../lwlib/lwlib.h"
96 #ifdef USE_MOTIF
97 #include <Xm/Xm.h>
98 #include <Xm/DialogS.h>
99 #include <Xm/FileSB.h>
100 #include <Xm/List.h>
101 #include <Xm/TextF.h>
102 #endif
104 #ifdef USE_LUCID
105 #include "../lwlib/xlwmenu.h"
106 #endif
108 #if !defined (NO_EDITRES)
109 #define HACK_EDITRES
110 extern void _XEditResCheckMessages (Widget, XtPointer, XEvent *, Boolean *);
111 #endif /* not defined NO_EDITRES */
113 /* Unique id counter for widgets created by the Lucid Widget Library. */
115 extern LWLIB_ID widget_id_tick;
117 #ifdef USE_MOTIF
119 #endif /* USE_MOTIF */
121 #endif /* USE_X_TOOLKIT */
123 #ifdef USE_GTK
125 #endif /* USE_GTK */
127 #define MAXREQUEST(dpy) (XMaxRequestSize (dpy))
129 /* The gray bitmap `bitmaps/gray'. This is done because xterm.c uses
130 it, and including `bitmaps/gray' more than once is a problem when
131 config.h defines `static' as an empty replacement string. */
133 int gray_bitmap_width = gray_width;
134 int gray_bitmap_height = gray_height;
135 char *gray_bitmap_bits = gray_bits;
137 /* Nonzero if using X. */
139 static int x_in_use;
141 static Lisp_Object Qnone;
142 static Lisp_Object Qsuppress_icon;
143 static Lisp_Object Qundefined_color;
144 static Lisp_Object Qcompound_text, Qcancel_timer;
145 Lisp_Object Qfont_param;
147 #if GLYPH_DEBUG
148 static ptrdiff_t image_cache_refcount;
149 static int dpyinfo_refcount;
150 #endif
152 #if defined (USE_GTK) && defined (HAVE_FREETYPE)
153 static char *x_last_font_name;
154 #endif
156 static struct x_display_info *x_display_info_for_name (Lisp_Object);
159 /* Error if we are not connected to X. */
161 void
162 check_x (void)
164 if (! x_in_use)
165 error ("X windows are not in use or not initialized");
168 /* Nonzero if we can use mouse menus.
169 You should not call this unless HAVE_MENUS is defined. */
172 have_menus_p (void)
174 return x_in_use;
177 /* Extract a frame as a FRAME_PTR, defaulting to the selected frame
178 and checking validity for X. */
180 FRAME_PTR
181 check_x_frame (Lisp_Object frame)
183 FRAME_PTR f;
185 if (NILP (frame))
186 frame = selected_frame;
187 CHECK_LIVE_FRAME (frame);
188 f = XFRAME (frame);
189 if (! FRAME_X_P (f))
190 error ("Non-X frame used");
191 return f;
194 /* Let the user specify an X display with a Lisp object.
195 OBJECT may be nil, a frame or a terminal object.
196 nil stands for the selected frame--or, if that is not an X frame,
197 the first X display on the list. */
199 struct x_display_info *
200 check_x_display_info (Lisp_Object object)
202 struct x_display_info *dpyinfo = NULL;
204 if (NILP (object))
206 struct frame *sf = XFRAME (selected_frame);
208 if (FRAME_X_P (sf) && FRAME_LIVE_P (sf))
209 dpyinfo = FRAME_X_DISPLAY_INFO (sf);
210 else if (x_display_list != 0)
211 dpyinfo = x_display_list;
212 else
213 error ("X windows are not in use or not initialized");
215 else if (TERMINALP (object))
217 struct terminal *t = get_terminal (object, 1);
219 if (t->type != output_x_window)
220 error ("Terminal %"pI"d is not an X display", XINT (object));
222 dpyinfo = t->display_info.x;
224 else if (STRINGP (object))
225 dpyinfo = x_display_info_for_name (object);
226 else
228 FRAME_PTR f = check_x_frame (object);
229 dpyinfo = FRAME_X_DISPLAY_INFO (f);
232 return dpyinfo;
236 /* Return the Emacs frame-object corresponding to an X window.
237 It could be the frame's main window or an icon window. */
239 /* This function can be called during GC, so use GC_xxx type test macros. */
241 struct frame *
242 x_window_to_frame (struct x_display_info *dpyinfo, int wdesc)
244 Lisp_Object tail, frame;
245 struct frame *f;
247 if (wdesc == None) return 0;
249 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
251 frame = XCAR (tail);
252 if (!FRAMEP (frame))
253 continue;
254 f = XFRAME (frame);
255 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
256 continue;
257 if (f->output_data.x->hourglass_window == wdesc)
258 return f;
259 #ifdef USE_X_TOOLKIT
260 if ((f->output_data.x->edit_widget
261 && XtWindow (f->output_data.x->edit_widget) == wdesc)
262 /* A tooltip frame? */
263 || (!f->output_data.x->edit_widget
264 && FRAME_X_WINDOW (f) == wdesc)
265 || f->output_data.x->icon_desc == wdesc)
266 return f;
267 #else /* not USE_X_TOOLKIT */
268 #ifdef USE_GTK
269 if (f->output_data.x->edit_widget)
271 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
272 struct x_output *x = f->output_data.x;
273 if (gwdesc != 0 && gwdesc == x->edit_widget)
274 return f;
276 #endif /* USE_GTK */
277 if (FRAME_X_WINDOW (f) == wdesc
278 || f->output_data.x->icon_desc == wdesc)
279 return f;
280 #endif /* not USE_X_TOOLKIT */
282 return 0;
285 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
286 /* Like x_window_to_frame but also compares the window with the widget's
287 windows. */
289 struct frame *
290 x_any_window_to_frame (struct x_display_info *dpyinfo, int wdesc)
292 Lisp_Object tail, frame;
293 struct frame *f, *found;
294 struct x_output *x;
296 if (wdesc == None) return NULL;
298 found = NULL;
299 for (tail = Vframe_list; CONSP (tail) && !found; tail = XCDR (tail))
301 frame = XCAR (tail);
302 if (!FRAMEP (frame))
303 continue;
305 f = XFRAME (frame);
306 if (FRAME_X_P (f) && FRAME_X_DISPLAY_INFO (f) == dpyinfo)
308 /* This frame matches if the window is any of its widgets. */
309 x = f->output_data.x;
310 if (x->hourglass_window == wdesc)
311 found = f;
312 else if (x->widget)
314 #ifdef USE_GTK
315 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
316 if (gwdesc != 0
317 && gtk_widget_get_toplevel (gwdesc) == x->widget)
318 found = f;
319 #else
320 if (wdesc == XtWindow (x->widget)
321 || wdesc == XtWindow (x->column_widget)
322 || wdesc == XtWindow (x->edit_widget))
323 found = f;
324 /* Match if the window is this frame's menubar. */
325 else if (lw_window_is_in_menubar (wdesc, x->menubar_widget))
326 found = f;
327 #endif
329 else if (FRAME_X_WINDOW (f) == wdesc)
330 /* A tooltip frame. */
331 found = f;
335 return found;
338 /* Likewise, but consider only the menu bar widget. */
340 struct frame *
341 x_menubar_window_to_frame (struct x_display_info *dpyinfo, XEvent *event)
343 Window wdesc = event->xany.window;
344 Lisp_Object tail, frame;
345 struct frame *f;
346 struct x_output *x;
348 if (wdesc == None) return 0;
350 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
352 frame = XCAR (tail);
353 if (!FRAMEP (frame))
354 continue;
355 f = XFRAME (frame);
356 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
357 continue;
358 x = f->output_data.x;
359 #ifdef USE_GTK
360 if (x->menubar_widget && xg_event_is_for_menubar (f, event))
361 return f;
362 #else
363 /* Match if the window is this frame's menubar. */
364 if (x->menubar_widget
365 && lw_window_is_in_menubar (wdesc, x->menubar_widget))
366 return f;
367 #endif
369 return 0;
372 /* Return the frame whose principal (outermost) window is WDESC.
373 If WDESC is some other (smaller) window, we return 0. */
375 struct frame *
376 x_top_window_to_frame (struct x_display_info *dpyinfo, int wdesc)
378 Lisp_Object tail, frame;
379 struct frame *f;
380 struct x_output *x;
382 if (wdesc == None) return 0;
384 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
386 frame = XCAR (tail);
387 if (!FRAMEP (frame))
388 continue;
389 f = XFRAME (frame);
390 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
391 continue;
392 x = f->output_data.x;
394 if (x->widget)
396 /* This frame matches if the window is its topmost widget. */
397 #ifdef USE_GTK
398 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
399 if (gwdesc == x->widget)
400 return f;
401 #else
402 if (wdesc == XtWindow (x->widget))
403 return f;
404 #if 0 /* I don't know why it did this,
405 but it seems logically wrong,
406 and it causes trouble for MapNotify events. */
407 /* Match if the window is this frame's menubar. */
408 if (x->menubar_widget
409 && wdesc == XtWindow (x->menubar_widget))
410 return f;
411 #endif
412 #endif
414 else if (FRAME_X_WINDOW (f) == wdesc)
415 /* Tooltip frame. */
416 return f;
418 return 0;
420 #endif /* USE_X_TOOLKIT || USE_GTK */
424 /* Store the screen positions of frame F into XPTR and YPTR.
425 These are the positions of the containing window manager window,
426 not Emacs's own window. */
428 void
429 x_real_positions (FRAME_PTR f, int *xptr, int *yptr)
431 int win_x, win_y, outer_x IF_LINT (= 0), outer_y IF_LINT (= 0);
432 int real_x = 0, real_y = 0;
433 int had_errors = 0;
434 Window win = f->output_data.x->parent_desc;
435 Atom actual_type;
436 unsigned long actual_size, bytes_remaining;
437 int rc, actual_format;
438 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
439 long max_len = 400;
440 Display *dpy = FRAME_X_DISPLAY (f);
441 unsigned char *tmp_data = NULL;
442 Atom target_type = XA_CARDINAL;
444 BLOCK_INPUT;
446 x_catch_errors (dpy);
448 if (win == dpyinfo->root_window)
449 win = FRAME_OUTER_WINDOW (f);
451 /* This loop traverses up the containment tree until we hit the root
452 window. Window managers may intersect many windows between our window
453 and the root window. The window we find just before the root window
454 should be the outer WM window. */
455 for (;;)
457 Window wm_window, rootw;
458 Window *tmp_children;
459 unsigned int tmp_nchildren;
460 int success;
462 success = XQueryTree (FRAME_X_DISPLAY (f), win, &rootw,
463 &wm_window, &tmp_children, &tmp_nchildren);
465 had_errors = x_had_errors_p (FRAME_X_DISPLAY (f));
467 /* Don't free tmp_children if XQueryTree failed. */
468 if (! success)
469 break;
471 XFree ((char *) tmp_children);
473 if (wm_window == rootw || had_errors)
474 break;
476 win = wm_window;
479 if (! had_errors)
481 unsigned int ign;
482 Window child, rootw;
484 /* Get the real coordinates for the WM window upper left corner */
485 XGetGeometry (FRAME_X_DISPLAY (f), win,
486 &rootw, &real_x, &real_y, &ign, &ign, &ign, &ign);
488 /* Translate real coordinates to coordinates relative to our
489 window. For our window, the upper left corner is 0, 0.
490 Since the upper left corner of the WM window is outside
491 our window, win_x and win_y will be negative:
493 ------------------ ---> x
494 | title |
495 | ----------------- v y
496 | | our window
498 XTranslateCoordinates (FRAME_X_DISPLAY (f),
500 /* From-window, to-window. */
501 FRAME_X_DISPLAY_INFO (f)->root_window,
502 FRAME_X_WINDOW (f),
504 /* From-position, to-position. */
505 real_x, real_y, &win_x, &win_y,
507 /* Child of win. */
508 &child);
510 if (FRAME_X_WINDOW (f) == FRAME_OUTER_WINDOW (f))
512 outer_x = win_x;
513 outer_y = win_y;
515 else
517 XTranslateCoordinates (FRAME_X_DISPLAY (f),
519 /* From-window, to-window. */
520 FRAME_X_DISPLAY_INFO (f)->root_window,
521 FRAME_OUTER_WINDOW (f),
523 /* From-position, to-position. */
524 real_x, real_y, &outer_x, &outer_y,
526 /* Child of win. */
527 &child);
530 had_errors = x_had_errors_p (FRAME_X_DISPLAY (f));
534 if (dpyinfo->root_window == f->output_data.x->parent_desc)
536 /* Try _NET_FRAME_EXTENTS if our parent is the root window. */
537 rc = XGetWindowProperty (dpy, win, dpyinfo->Xatom_net_frame_extents,
538 0, max_len, False, target_type,
539 &actual_type, &actual_format, &actual_size,
540 &bytes_remaining, &tmp_data);
542 if (rc == Success && actual_type == target_type && !x_had_errors_p (dpy)
543 && actual_size == 4 && actual_format == 32)
545 unsigned int ign;
546 Window rootw;
547 long *fe = (long *)tmp_data;
549 XGetGeometry (FRAME_X_DISPLAY (f), win,
550 &rootw, &real_x, &real_y, &ign, &ign, &ign, &ign);
551 outer_x = -fe[0];
552 outer_y = -fe[2];
553 real_x -= fe[0];
554 real_y -= fe[2];
558 if (tmp_data) XFree (tmp_data);
560 x_uncatch_errors ();
562 UNBLOCK_INPUT;
564 if (had_errors) return;
566 f->x_pixels_diff = -win_x;
567 f->y_pixels_diff = -win_y;
569 FRAME_X_OUTPUT (f)->x_pixels_outer_diff = -outer_x;
570 FRAME_X_OUTPUT (f)->y_pixels_outer_diff = -outer_y;
572 *xptr = real_x;
573 *yptr = real_y;
579 /* Gamma-correct COLOR on frame F. */
581 void
582 gamma_correct (struct frame *f, XColor *color)
584 if (f->gamma)
586 color->red = pow (color->red / 65535.0, f->gamma) * 65535.0 + 0.5;
587 color->green = pow (color->green / 65535.0, f->gamma) * 65535.0 + 0.5;
588 color->blue = pow (color->blue / 65535.0, f->gamma) * 65535.0 + 0.5;
593 /* Decide if color named COLOR_NAME is valid for use on frame F. If
594 so, return the RGB values in COLOR. If ALLOC_P is non-zero,
595 allocate the color. Value is zero if COLOR_NAME is invalid, or
596 no color could be allocated. */
599 x_defined_color (struct frame *f, const char *color_name,
600 XColor *color, int alloc_p)
602 int success_p = 0;
603 Display *dpy = FRAME_X_DISPLAY (f);
604 Colormap cmap = FRAME_X_COLORMAP (f);
606 BLOCK_INPUT;
607 #ifdef USE_GTK
608 success_p = xg_check_special_colors (f, color_name, color);
609 #endif
610 if (!success_p)
611 success_p = XParseColor (dpy, cmap, color_name, color);
612 if (success_p && alloc_p)
613 success_p = x_alloc_nearest_color (f, cmap, color);
614 UNBLOCK_INPUT;
616 return success_p;
620 /* Return the pixel color value for color COLOR_NAME on frame F. If F
621 is a monochrome frame, return MONO_COLOR regardless of what ARG says.
622 Signal an error if color can't be allocated. */
624 static int
625 x_decode_color (FRAME_PTR f, Lisp_Object color_name, int mono_color)
627 XColor cdef;
629 CHECK_STRING (color_name);
631 #if 0 /* Don't do this. It's wrong when we're not using the default
632 colormap, it makes freeing difficult, and it's probably not
633 an important optimization. */
634 if (strcmp (SDATA (color_name), "black") == 0)
635 return BLACK_PIX_DEFAULT (f);
636 else if (strcmp (SDATA (color_name), "white") == 0)
637 return WHITE_PIX_DEFAULT (f);
638 #endif
640 /* Return MONO_COLOR for monochrome frames. */
641 if (FRAME_X_DISPLAY_INFO (f)->n_planes == 1)
642 return mono_color;
644 /* x_defined_color is responsible for coping with failures
645 by looking for a near-miss. */
646 if (x_defined_color (f, SSDATA (color_name), &cdef, 1))
647 return cdef.pixel;
649 signal_error ("Undefined color", color_name);
654 /* Change the `wait-for-wm' frame parameter of frame F. OLD_VALUE is
655 the previous value of that parameter, NEW_VALUE is the new value.
656 See also the comment of wait_for_wm in struct x_output. */
658 static void
659 x_set_wait_for_wm (struct frame *f, Lisp_Object new_value, Lisp_Object old_value)
661 f->output_data.x->wait_for_wm = !NILP (new_value);
664 static void
665 x_set_tool_bar_position (struct frame *f,
666 Lisp_Object new_value,
667 Lisp_Object old_value)
669 if (! EQ (new_value, Qleft) && ! EQ (new_value, Qright)
670 && ! EQ (new_value, Qbottom) && ! EQ (new_value, Qtop))
671 return;
672 if (EQ (new_value, old_value)) return;
674 #ifdef USE_GTK
675 if (xg_change_toolbar_position (f, new_value))
676 f->tool_bar_position = new_value;
677 #endif
680 #ifdef USE_GTK
682 /* Set icon from FILE for frame F. By using GTK functions the icon
683 may be any format that GdkPixbuf knows about, i.e. not just bitmaps. */
686 xg_set_icon (FRAME_PTR f, Lisp_Object file)
688 int result = 0;
689 Lisp_Object found;
691 found = x_find_image_file (file);
693 if (! NILP (found))
695 GdkPixbuf *pixbuf;
696 GError *err = NULL;
697 char *filename = SSDATA (found);
698 BLOCK_INPUT;
700 pixbuf = gdk_pixbuf_new_from_file (filename, &err);
702 if (pixbuf)
704 gtk_window_set_icon (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)),
705 pixbuf);
706 g_object_unref (pixbuf);
708 result = 1;
710 else
711 g_error_free (err);
713 UNBLOCK_INPUT;
716 return result;
720 xg_set_icon_from_xpm_data (FRAME_PTR f, const char **data)
722 GdkPixbuf *pixbuf = gdk_pixbuf_new_from_xpm_data (data);
724 if (!pixbuf)
725 return 0;
727 gtk_window_set_icon (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)), pixbuf);
728 g_object_unref (pixbuf);
729 return 1;
731 #endif /* USE_GTK */
734 /* Functions called only from `x_set_frame_param'
735 to set individual parameters.
737 If FRAME_X_WINDOW (f) is 0,
738 the frame is being created and its X-window does not exist yet.
739 In that case, just record the parameter's new value
740 in the standard place; do not attempt to change the window. */
742 static void
743 x_set_foreground_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
745 struct x_output *x = f->output_data.x;
746 unsigned long fg, old_fg;
748 fg = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
749 old_fg = FRAME_FOREGROUND_PIXEL (f);
750 FRAME_FOREGROUND_PIXEL (f) = fg;
752 if (FRAME_X_WINDOW (f) != 0)
754 Display *dpy = FRAME_X_DISPLAY (f);
756 BLOCK_INPUT;
757 XSetForeground (dpy, x->normal_gc, fg);
758 XSetBackground (dpy, x->reverse_gc, fg);
760 if (x->cursor_pixel == old_fg)
762 unload_color (f, x->cursor_pixel);
763 x->cursor_pixel = x_copy_color (f, fg);
764 XSetBackground (dpy, x->cursor_gc, x->cursor_pixel);
767 UNBLOCK_INPUT;
769 update_face_from_frame_parameter (f, Qforeground_color, arg);
771 if (FRAME_VISIBLE_P (f))
772 redraw_frame (f);
775 unload_color (f, old_fg);
778 static void
779 x_set_background_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
781 struct x_output *x = f->output_data.x;
782 unsigned long bg;
784 bg = x_decode_color (f, arg, WHITE_PIX_DEFAULT (f));
785 unload_color (f, FRAME_BACKGROUND_PIXEL (f));
786 FRAME_BACKGROUND_PIXEL (f) = bg;
788 if (FRAME_X_WINDOW (f) != 0)
790 Display *dpy = FRAME_X_DISPLAY (f);
792 BLOCK_INPUT;
793 XSetBackground (dpy, x->normal_gc, bg);
794 XSetForeground (dpy, x->reverse_gc, bg);
795 XSetWindowBackground (dpy, FRAME_X_WINDOW (f), bg);
796 XSetForeground (dpy, x->cursor_gc, bg);
798 #ifdef USE_GTK
799 xg_set_background_color (f, bg);
800 #endif
802 #ifndef USE_TOOLKIT_SCROLL_BARS /* Turns out to be annoying with
803 toolkit scroll bars. */
805 Lisp_Object bar;
806 for (bar = FRAME_SCROLL_BARS (f);
807 !NILP (bar);
808 bar = XSCROLL_BAR (bar)->next)
810 Window window = XSCROLL_BAR (bar)->x_window;
811 XSetWindowBackground (dpy, window, bg);
814 #endif /* USE_TOOLKIT_SCROLL_BARS */
816 UNBLOCK_INPUT;
817 update_face_from_frame_parameter (f, Qbackground_color, arg);
819 if (FRAME_VISIBLE_P (f))
820 redraw_frame (f);
824 static Cursor
825 make_invisible_cursor (struct frame *f)
827 Display *dpy = FRAME_X_DISPLAY (f);
828 static char const no_data[] = { 0 };
829 Pixmap pix;
830 XColor col;
831 Cursor c = 0;
833 x_catch_errors (dpy);
834 pix = XCreateBitmapFromData (dpy, FRAME_X_DISPLAY_INFO (f)->root_window,
835 no_data, 1, 1);
836 if (! x_had_errors_p (dpy) && pix != None)
838 Cursor pixc;
839 col.pixel = 0;
840 col.red = col.green = col.blue = 0;
841 col.flags = DoRed | DoGreen | DoBlue;
842 pixc = XCreatePixmapCursor (dpy, pix, pix, &col, &col, 0, 0);
843 if (! x_had_errors_p (dpy) && pixc != None)
844 c = pixc;
845 XFreePixmap (dpy, pix);
848 x_uncatch_errors ();
850 return c;
853 static void
854 x_set_mouse_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
856 struct x_output *x = f->output_data.x;
857 Display *dpy = FRAME_X_DISPLAY (f);
858 Cursor cursor, nontext_cursor, mode_cursor, hand_cursor;
859 Cursor hourglass_cursor, horizontal_drag_cursor;
860 unsigned long pixel = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
861 unsigned long mask_color = FRAME_BACKGROUND_PIXEL (f);
863 /* Don't let pointers be invisible. */
864 if (mask_color == pixel)
866 x_free_colors (f, &pixel, 1);
867 pixel = x_copy_color (f, FRAME_FOREGROUND_PIXEL (f));
870 unload_color (f, x->mouse_pixel);
871 x->mouse_pixel = pixel;
873 BLOCK_INPUT;
875 /* It's not okay to crash if the user selects a screwy cursor. */
876 x_catch_errors (dpy);
878 if (!NILP (Vx_pointer_shape))
880 CHECK_NUMBER (Vx_pointer_shape);
881 cursor = XCreateFontCursor (dpy, XINT (Vx_pointer_shape));
883 else
884 cursor = XCreateFontCursor (dpy, XC_xterm);
885 x_check_errors (dpy, "bad text pointer cursor: %s");
887 if (!NILP (Vx_nontext_pointer_shape))
889 CHECK_NUMBER (Vx_nontext_pointer_shape);
890 nontext_cursor
891 = XCreateFontCursor (dpy, XINT (Vx_nontext_pointer_shape));
893 else
894 nontext_cursor = XCreateFontCursor (dpy, XC_left_ptr);
895 x_check_errors (dpy, "bad nontext pointer cursor: %s");
897 if (!NILP (Vx_hourglass_pointer_shape))
899 CHECK_NUMBER (Vx_hourglass_pointer_shape);
900 hourglass_cursor
901 = XCreateFontCursor (dpy, XINT (Vx_hourglass_pointer_shape));
903 else
904 hourglass_cursor = XCreateFontCursor (dpy, XC_watch);
905 x_check_errors (dpy, "bad hourglass pointer cursor: %s");
907 if (!NILP (Vx_mode_pointer_shape))
909 CHECK_NUMBER (Vx_mode_pointer_shape);
910 mode_cursor = XCreateFontCursor (dpy, XINT (Vx_mode_pointer_shape));
912 else
913 mode_cursor = XCreateFontCursor (dpy, XC_xterm);
914 x_check_errors (dpy, "bad modeline pointer cursor: %s");
916 if (!NILP (Vx_sensitive_text_pointer_shape))
918 CHECK_NUMBER (Vx_sensitive_text_pointer_shape);
919 hand_cursor
920 = XCreateFontCursor (dpy, XINT (Vx_sensitive_text_pointer_shape));
922 else
923 hand_cursor = XCreateFontCursor (dpy, XC_hand2);
925 if (!NILP (Vx_window_horizontal_drag_shape))
927 CHECK_NUMBER (Vx_window_horizontal_drag_shape);
928 horizontal_drag_cursor
929 = XCreateFontCursor (dpy, XINT (Vx_window_horizontal_drag_shape));
931 else
932 horizontal_drag_cursor
933 = XCreateFontCursor (dpy, XC_sb_h_double_arrow);
935 /* Check and report errors with the above calls. */
936 x_check_errors (dpy, "can't set cursor shape: %s");
937 x_uncatch_errors ();
940 XColor fore_color, back_color;
942 fore_color.pixel = x->mouse_pixel;
943 x_query_color (f, &fore_color);
944 back_color.pixel = mask_color;
945 x_query_color (f, &back_color);
947 XRecolorCursor (dpy, cursor, &fore_color, &back_color);
948 XRecolorCursor (dpy, nontext_cursor, &fore_color, &back_color);
949 XRecolorCursor (dpy, mode_cursor, &fore_color, &back_color);
950 XRecolorCursor (dpy, hand_cursor, &fore_color, &back_color);
951 XRecolorCursor (dpy, hourglass_cursor, &fore_color, &back_color);
952 XRecolorCursor (dpy, horizontal_drag_cursor, &fore_color, &back_color);
955 if (FRAME_X_WINDOW (f) != 0)
956 XDefineCursor (dpy, FRAME_X_WINDOW (f),
957 f->output_data.x->current_cursor = cursor);
959 if (FRAME_X_DISPLAY_INFO (f)->invisible_cursor == 0)
960 FRAME_X_DISPLAY_INFO (f)->invisible_cursor = make_invisible_cursor (f);
962 if (cursor != x->text_cursor
963 && x->text_cursor != 0)
964 XFreeCursor (dpy, x->text_cursor);
965 x->text_cursor = cursor;
967 if (nontext_cursor != x->nontext_cursor
968 && x->nontext_cursor != 0)
969 XFreeCursor (dpy, x->nontext_cursor);
970 x->nontext_cursor = nontext_cursor;
972 if (hourglass_cursor != x->hourglass_cursor
973 && x->hourglass_cursor != 0)
974 XFreeCursor (dpy, x->hourglass_cursor);
975 x->hourglass_cursor = hourglass_cursor;
977 if (mode_cursor != x->modeline_cursor
978 && x->modeline_cursor != 0)
979 XFreeCursor (dpy, f->output_data.x->modeline_cursor);
980 x->modeline_cursor = mode_cursor;
982 if (hand_cursor != x->hand_cursor
983 && x->hand_cursor != 0)
984 XFreeCursor (dpy, x->hand_cursor);
985 x->hand_cursor = hand_cursor;
987 if (horizontal_drag_cursor != x->horizontal_drag_cursor
988 && x->horizontal_drag_cursor != 0)
989 XFreeCursor (dpy, x->horizontal_drag_cursor);
990 x->horizontal_drag_cursor = horizontal_drag_cursor;
992 XFlush (dpy);
993 UNBLOCK_INPUT;
995 update_face_from_frame_parameter (f, Qmouse_color, arg);
998 static void
999 x_set_cursor_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
1001 unsigned long fore_pixel, pixel;
1002 int fore_pixel_allocated_p = 0, pixel_allocated_p = 0;
1003 struct x_output *x = f->output_data.x;
1005 if (!NILP (Vx_cursor_fore_pixel))
1007 fore_pixel = x_decode_color (f, Vx_cursor_fore_pixel,
1008 WHITE_PIX_DEFAULT (f));
1009 fore_pixel_allocated_p = 1;
1011 else
1012 fore_pixel = FRAME_BACKGROUND_PIXEL (f);
1014 pixel = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
1015 pixel_allocated_p = 1;
1017 /* Make sure that the cursor color differs from the background color. */
1018 if (pixel == FRAME_BACKGROUND_PIXEL (f))
1020 if (pixel_allocated_p)
1022 x_free_colors (f, &pixel, 1);
1023 pixel_allocated_p = 0;
1026 pixel = x->mouse_pixel;
1027 if (pixel == fore_pixel)
1029 if (fore_pixel_allocated_p)
1031 x_free_colors (f, &fore_pixel, 1);
1032 fore_pixel_allocated_p = 0;
1034 fore_pixel = FRAME_BACKGROUND_PIXEL (f);
1038 unload_color (f, x->cursor_foreground_pixel);
1039 if (!fore_pixel_allocated_p)
1040 fore_pixel = x_copy_color (f, fore_pixel);
1041 x->cursor_foreground_pixel = fore_pixel;
1043 unload_color (f, x->cursor_pixel);
1044 if (!pixel_allocated_p)
1045 pixel = x_copy_color (f, pixel);
1046 x->cursor_pixel = pixel;
1048 if (FRAME_X_WINDOW (f) != 0)
1050 BLOCK_INPUT;
1051 XSetBackground (FRAME_X_DISPLAY (f), x->cursor_gc, x->cursor_pixel);
1052 XSetForeground (FRAME_X_DISPLAY (f), x->cursor_gc, fore_pixel);
1053 UNBLOCK_INPUT;
1055 if (FRAME_VISIBLE_P (f))
1057 x_update_cursor (f, 0);
1058 x_update_cursor (f, 1);
1062 update_face_from_frame_parameter (f, Qcursor_color, arg);
1065 /* Set the border-color of frame F to pixel value PIX.
1066 Note that this does not fully take effect if done before
1067 F has an x-window. */
1069 static void
1070 x_set_border_pixel (struct frame *f, int pix)
1072 unload_color (f, f->output_data.x->border_pixel);
1073 f->output_data.x->border_pixel = pix;
1075 if (FRAME_X_WINDOW (f) != 0 && f->border_width > 0)
1077 BLOCK_INPUT;
1078 XSetWindowBorder (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), pix);
1079 UNBLOCK_INPUT;
1081 if (FRAME_VISIBLE_P (f))
1082 redraw_frame (f);
1086 /* Set the border-color of frame F to value described by ARG.
1087 ARG can be a string naming a color.
1088 The border-color is used for the border that is drawn by the X server.
1089 Note that this does not fully take effect if done before
1090 F has an x-window; it must be redone when the window is created.
1092 Note: this is done in two routines because of the way X10 works.
1094 Note: under X11, this is normally the province of the window manager,
1095 and so emacs' border colors may be overridden. */
1097 static void
1098 x_set_border_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
1100 int pix;
1102 CHECK_STRING (arg);
1103 pix = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
1104 x_set_border_pixel (f, pix);
1105 update_face_from_frame_parameter (f, Qborder_color, arg);
1109 static void
1110 x_set_cursor_type (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
1112 set_frame_cursor_types (f, arg);
1114 /* Make sure the cursor gets redrawn. */
1115 cursor_type_changed = 1;
1118 static void
1119 x_set_icon_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
1121 int result;
1123 if (STRINGP (arg))
1125 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
1126 return;
1128 else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
1129 return;
1131 BLOCK_INPUT;
1132 if (NILP (arg))
1133 result = x_text_icon (f,
1134 SSDATA ((!NILP (f->icon_name)
1135 ? f->icon_name
1136 : f->name)));
1137 else
1138 result = x_bitmap_icon (f, arg);
1140 if (result)
1142 UNBLOCK_INPUT;
1143 error ("No icon window available");
1146 XFlush (FRAME_X_DISPLAY (f));
1147 UNBLOCK_INPUT;
1150 static void
1151 x_set_icon_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
1153 int result;
1155 if (STRINGP (arg))
1157 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
1158 return;
1160 else if (!NILP (arg) || NILP (oldval))
1161 return;
1163 f->icon_name = arg;
1165 if (f->output_data.x->icon_bitmap != 0)
1166 return;
1168 BLOCK_INPUT;
1170 result = x_text_icon (f,
1171 SSDATA ((!NILP (f->icon_name)
1172 ? f->icon_name
1173 : !NILP (f->title)
1174 ? f->title
1175 : f->name)));
1177 if (result)
1179 UNBLOCK_INPUT;
1180 error ("No icon window available");
1183 XFlush (FRAME_X_DISPLAY (f));
1184 UNBLOCK_INPUT;
1188 void
1189 x_set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
1191 int nlines;
1192 #if ! defined (USE_X_TOOLKIT) && ! defined (USE_GTK)
1193 int olines = FRAME_MENU_BAR_LINES (f);
1194 #endif
1196 /* Right now, menu bars don't work properly in minibuf-only frames;
1197 most of the commands try to apply themselves to the minibuffer
1198 frame itself, and get an error because you can't switch buffers
1199 in or split the minibuffer window. */
1200 if (FRAME_MINIBUF_ONLY_P (f))
1201 return;
1203 if (INTEGERP (value))
1204 nlines = XINT (value);
1205 else
1206 nlines = 0;
1208 /* Make sure we redisplay all windows in this frame. */
1209 windows_or_buffers_changed++;
1211 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
1212 FRAME_MENU_BAR_LINES (f) = 0;
1213 if (nlines)
1215 FRAME_EXTERNAL_MENU_BAR (f) = 1;
1216 if (FRAME_X_P (f) && f->output_data.x->menubar_widget == 0)
1217 /* Make sure next redisplay shows the menu bar. */
1218 XWINDOW (FRAME_SELECTED_WINDOW (f))->update_mode_line = Qt;
1220 else
1222 if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
1223 free_frame_menubar (f);
1224 FRAME_EXTERNAL_MENU_BAR (f) = 0;
1225 if (FRAME_X_P (f))
1226 f->output_data.x->menubar_widget = 0;
1228 #else /* not USE_X_TOOLKIT && not USE_GTK */
1229 FRAME_MENU_BAR_LINES (f) = nlines;
1230 resize_frame_windows (f, FRAME_LINES (f), 0);
1232 /* If the menu bar height gets changed, the internal border below
1233 the top margin has to be cleared. Also, if the menu bar gets
1234 larger, the area for the added lines has to be cleared except for
1235 the first menu bar line that is to be drawn later. */
1236 if (nlines != olines)
1238 int height = FRAME_INTERNAL_BORDER_WIDTH (f);
1239 int width = FRAME_PIXEL_WIDTH (f);
1240 int y;
1242 /* height can be zero here. */
1243 if (height > 0 && width > 0)
1245 y = FRAME_TOP_MARGIN_HEIGHT (f);
1247 BLOCK_INPUT;
1248 x_clear_area (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1249 0, y, width, height, False);
1250 UNBLOCK_INPUT;
1253 if (nlines > 1 && nlines > olines)
1255 y = (olines == 0 ? 1 : olines) * FRAME_LINE_HEIGHT (f);
1256 height = nlines * FRAME_LINE_HEIGHT (f) - y;
1258 BLOCK_INPUT;
1259 x_clear_area (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1260 0, y, width, height, False);
1261 UNBLOCK_INPUT;
1264 if (nlines == 0 && WINDOWP (f->menu_bar_window))
1265 clear_glyph_matrix (XWINDOW (f->menu_bar_window)->current_matrix);
1267 #endif /* not USE_X_TOOLKIT && not USE_GTK */
1268 adjust_glyphs (f);
1269 run_window_configuration_change_hook (f);
1273 /* Set the number of lines used for the tool bar of frame F to VALUE.
1274 VALUE not an integer, or < 0 means set the lines to zero. OLDVAL
1275 is the old number of tool bar lines. This function changes the
1276 height of all windows on frame F to match the new tool bar height.
1277 The frame's height doesn't change. */
1279 void
1280 x_set_tool_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
1282 int delta, nlines, root_height;
1283 Lisp_Object root_window;
1285 /* Treat tool bars like menu bars. */
1286 if (FRAME_MINIBUF_ONLY_P (f))
1287 return;
1289 /* Use VALUE only if an integer >= 0. */
1290 if (INTEGERP (value) && XINT (value) >= 0)
1291 nlines = XFASTINT (value);
1292 else
1293 nlines = 0;
1295 #ifdef USE_GTK
1296 FRAME_TOOL_BAR_LINES (f) = 0;
1297 if (nlines)
1299 FRAME_EXTERNAL_TOOL_BAR (f) = 1;
1300 if (FRAME_X_P (f) && f->output_data.x->toolbar_widget == 0)
1301 /* Make sure next redisplay shows the tool bar. */
1302 XWINDOW (FRAME_SELECTED_WINDOW (f))->update_mode_line = Qt;
1303 update_frame_tool_bar (f);
1305 else
1307 if (FRAME_EXTERNAL_TOOL_BAR (f))
1308 free_frame_tool_bar (f);
1309 FRAME_EXTERNAL_TOOL_BAR (f) = 0;
1312 return;
1313 #endif
1315 /* Make sure we redisplay all windows in this frame. */
1316 ++windows_or_buffers_changed;
1318 delta = nlines - FRAME_TOOL_BAR_LINES (f);
1320 /* Don't resize the tool-bar to more than we have room for. */
1321 root_window = FRAME_ROOT_WINDOW (f);
1322 root_height = WINDOW_TOTAL_LINES (XWINDOW (root_window));
1323 if (root_height - delta < 1)
1325 delta = root_height - 1;
1326 nlines = FRAME_TOOL_BAR_LINES (f) + delta;
1329 FRAME_TOOL_BAR_LINES (f) = nlines;
1330 resize_frame_windows (f, FRAME_LINES (f), 0);
1331 adjust_glyphs (f);
1333 /* We also have to make sure that the internal border at the top of
1334 the frame, below the menu bar or tool bar, is redrawn when the
1335 tool bar disappears. This is so because the internal border is
1336 below the tool bar if one is displayed, but is below the menu bar
1337 if there isn't a tool bar. The tool bar draws into the area
1338 below the menu bar. */
1339 if (FRAME_X_WINDOW (f) && FRAME_TOOL_BAR_LINES (f) == 0)
1341 clear_frame (f);
1342 clear_current_matrices (f);
1345 /* If the tool bar gets smaller, the internal border below it
1346 has to be cleared. It was formerly part of the display
1347 of the larger tool bar, and updating windows won't clear it. */
1348 if (delta < 0)
1350 int height = FRAME_INTERNAL_BORDER_WIDTH (f);
1351 int width = FRAME_PIXEL_WIDTH (f);
1352 int y = (FRAME_MENU_BAR_LINES (f) + nlines) * FRAME_LINE_HEIGHT (f);
1354 /* height can be zero here. */
1355 if (height > 0 && width > 0)
1357 BLOCK_INPUT;
1358 x_clear_area (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1359 0, y, width, height, False);
1360 UNBLOCK_INPUT;
1363 if (WINDOWP (f->tool_bar_window))
1364 clear_glyph_matrix (XWINDOW (f->tool_bar_window)->current_matrix);
1367 run_window_configuration_change_hook (f);
1372 /* Set the foreground color for scroll bars on frame F to VALUE.
1373 VALUE should be a string, a color name. If it isn't a string or
1374 isn't a valid color name, do nothing. OLDVAL is the old value of
1375 the frame parameter. */
1377 static void
1378 x_set_scroll_bar_foreground (struct frame *f, Lisp_Object value, Lisp_Object oldval)
1380 unsigned long pixel;
1382 if (STRINGP (value))
1383 pixel = x_decode_color (f, value, BLACK_PIX_DEFAULT (f));
1384 else
1385 pixel = -1;
1387 if (f->output_data.x->scroll_bar_foreground_pixel != -1)
1388 unload_color (f, f->output_data.x->scroll_bar_foreground_pixel);
1390 f->output_data.x->scroll_bar_foreground_pixel = pixel;
1391 if (FRAME_X_WINDOW (f) && FRAME_VISIBLE_P (f))
1393 /* Remove all scroll bars because they have wrong colors. */
1394 if (FRAME_TERMINAL (f)->condemn_scroll_bars_hook)
1395 (*FRAME_TERMINAL (f)->condemn_scroll_bars_hook) (f);
1396 if (FRAME_TERMINAL (f)->judge_scroll_bars_hook)
1397 (*FRAME_TERMINAL (f)->judge_scroll_bars_hook) (f);
1399 update_face_from_frame_parameter (f, Qscroll_bar_foreground, value);
1400 redraw_frame (f);
1405 /* Set the background color for scroll bars on frame F to VALUE VALUE
1406 should be a string, a color name. If it isn't a string or isn't a
1407 valid color name, do nothing. OLDVAL is the old value of the frame
1408 parameter. */
1410 static void
1411 x_set_scroll_bar_background (struct frame *f, Lisp_Object value, Lisp_Object oldval)
1413 unsigned long pixel;
1415 if (STRINGP (value))
1416 pixel = x_decode_color (f, value, WHITE_PIX_DEFAULT (f));
1417 else
1418 pixel = -1;
1420 if (f->output_data.x->scroll_bar_background_pixel != -1)
1421 unload_color (f, f->output_data.x->scroll_bar_background_pixel);
1423 #ifdef USE_TOOLKIT_SCROLL_BARS
1424 /* Scrollbar shadow colors. */
1425 if (f->output_data.x->scroll_bar_top_shadow_pixel != -1)
1427 unload_color (f, f->output_data.x->scroll_bar_top_shadow_pixel);
1428 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
1430 if (f->output_data.x->scroll_bar_bottom_shadow_pixel != -1)
1432 unload_color (f, f->output_data.x->scroll_bar_bottom_shadow_pixel);
1433 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
1435 #endif /* USE_TOOLKIT_SCROLL_BARS */
1437 f->output_data.x->scroll_bar_background_pixel = pixel;
1438 if (FRAME_X_WINDOW (f) && FRAME_VISIBLE_P (f))
1440 /* Remove all scroll bars because they have wrong colors. */
1441 if (FRAME_TERMINAL (f)->condemn_scroll_bars_hook)
1442 (*FRAME_TERMINAL (f)->condemn_scroll_bars_hook) (f);
1443 if (FRAME_TERMINAL (f)->judge_scroll_bars_hook)
1444 (*FRAME_TERMINAL (f)->judge_scroll_bars_hook) (f);
1446 update_face_from_frame_parameter (f, Qscroll_bar_background, value);
1447 redraw_frame (f);
1452 /* Encode Lisp string STRING as a text in a format appropriate for
1453 XICCC (X Inter Client Communication Conventions).
1455 This can call Lisp code, so callers must GCPRO.
1457 If STRING contains only ASCII characters, do no conversion and
1458 return the string data of STRING. Otherwise, encode the text by
1459 CODING_SYSTEM, and return a newly allocated memory area which
1460 should be freed by `xfree' by a caller.
1462 SELECTIONP non-zero means the string is being encoded for an X
1463 selection, so it is safe to run pre-write conversions (which
1464 may run Lisp code).
1466 Store the byte length of resulting text in *TEXT_BYTES.
1468 If the text contains only ASCII and Latin-1, store 1 in *STRING_P,
1469 which means that the `encoding' of the result can be `STRING'.
1470 Otherwise store 0 in *STRINGP, which means that the `encoding' of
1471 the result should be `COMPOUND_TEXT'. */
1473 static unsigned char *
1474 x_encode_text (Lisp_Object string, Lisp_Object coding_system, int selectionp,
1475 ptrdiff_t *text_bytes, int *stringp, int *freep)
1477 int result = string_xstring_p (string);
1478 struct coding_system coding;
1480 if (result == 0)
1482 /* No multibyte character in OBJ. We need not encode it. */
1483 *text_bytes = SBYTES (string);
1484 *stringp = 1;
1485 *freep = 0;
1486 return SDATA (string);
1489 setup_coding_system (coding_system, &coding);
1490 coding.mode |= (CODING_MODE_SAFE_ENCODING | CODING_MODE_LAST_BLOCK);
1491 /* We suppress producing escape sequences for composition. */
1492 coding.common_flags &= ~CODING_ANNOTATION_MASK;
1493 coding.destination = xnmalloc (SCHARS (string), 2);
1494 coding.dst_bytes = SCHARS (string) * 2;
1495 encode_coding_object (&coding, string, 0, 0,
1496 SCHARS (string), SBYTES (string), Qnil);
1497 *text_bytes = coding.produced;
1498 *stringp = (result == 1 || !EQ (coding_system, Qcompound_text));
1499 *freep = 1;
1500 return coding.destination;
1504 /* Set the WM name to NAME for frame F. Also set the icon name.
1505 If the frame already has an icon name, use that, otherwise set the
1506 icon name to NAME. */
1508 static void
1509 x_set_name_internal (FRAME_PTR f, Lisp_Object name)
1511 if (FRAME_X_WINDOW (f))
1513 BLOCK_INPUT;
1515 XTextProperty text, icon;
1516 ptrdiff_t bytes;
1517 int stringp;
1518 int do_free_icon_value = 0, do_free_text_value = 0;
1519 Lisp_Object coding_system;
1520 Lisp_Object encoded_name;
1521 Lisp_Object encoded_icon_name;
1522 struct gcpro gcpro1;
1524 /* As ENCODE_UTF_8 may cause GC and relocation of string data,
1525 we use it before x_encode_text that may return string data. */
1526 GCPRO1 (name);
1527 encoded_name = ENCODE_UTF_8 (name);
1528 UNGCPRO;
1530 coding_system = Qcompound_text;
1531 /* Note: Encoding strategy
1533 We encode NAME by compound-text and use "COMPOUND-TEXT" in
1534 text.encoding. But, there are non-internationalized window
1535 managers which don't support that encoding. So, if NAME
1536 contains only ASCII and 8859-1 characters, encode it by
1537 iso-latin-1, and use "STRING" in text.encoding hoping that
1538 such window managers at least analyze this format correctly,
1539 i.e. treat 8-bit bytes as 8859-1 characters.
1541 We may also be able to use "UTF8_STRING" in text.encoding
1542 in the future which can encode all Unicode characters.
1543 But, for the moment, there's no way to know that the
1544 current window manager supports it or not.
1546 Either way, we also set the _NET_WM_NAME and _NET_WM_ICON_NAME
1547 properties. Per the EWMH specification, those two properties
1548 are always UTF8_STRING. This matches what gtk_window_set_title()
1549 does in the USE_GTK case. */
1550 text.value = x_encode_text (name, coding_system, 0, &bytes, &stringp,
1551 &do_free_text_value);
1552 text.encoding = (stringp ? XA_STRING
1553 : FRAME_X_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
1554 text.format = 8;
1555 text.nitems = bytes;
1556 if (text.nitems != bytes)
1557 error ("Window name too large");
1559 if (!STRINGP (f->icon_name))
1561 icon = text;
1562 encoded_icon_name = encoded_name;
1564 else
1566 /* See the above comment "Note: Encoding strategy". */
1567 icon.value = x_encode_text (f->icon_name, coding_system, 0,
1568 &bytes, &stringp, &do_free_icon_value);
1569 icon.encoding = (stringp ? XA_STRING
1570 : FRAME_X_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
1571 icon.format = 8;
1572 icon.nitems = bytes;
1573 if (icon.nitems != bytes)
1574 error ("Icon name too large");
1576 encoded_icon_name = ENCODE_UTF_8 (f->icon_name);
1579 #ifdef USE_GTK
1580 gtk_window_set_title (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)),
1581 SSDATA (encoded_name));
1582 #else /* not USE_GTK */
1583 XSetWMName (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &text);
1584 XChangeProperty (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f),
1585 FRAME_X_DISPLAY_INFO (f)->Xatom_net_wm_name,
1586 FRAME_X_DISPLAY_INFO (f)->Xatom_UTF8_STRING,
1587 8, PropModeReplace,
1588 SDATA (encoded_name),
1589 SBYTES (encoded_name));
1590 #endif /* not USE_GTK */
1592 XSetWMIconName (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &icon);
1593 XChangeProperty (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f),
1594 FRAME_X_DISPLAY_INFO (f)->Xatom_net_wm_icon_name,
1595 FRAME_X_DISPLAY_INFO (f)->Xatom_UTF8_STRING,
1596 8, PropModeReplace,
1597 SDATA (encoded_icon_name),
1598 SBYTES (encoded_icon_name));
1600 if (do_free_icon_value)
1601 xfree (icon.value);
1602 if (do_free_text_value)
1603 xfree (text.value);
1605 UNBLOCK_INPUT;
1609 /* Change the name of frame F to NAME. If NAME is nil, set F's name to
1610 x_id_name.
1612 If EXPLICIT is non-zero, that indicates that lisp code is setting the
1613 name; if NAME is a string, set F's name to NAME and set
1614 F->explicit_name; if NAME is Qnil, then clear F->explicit_name.
1616 If EXPLICIT is zero, that indicates that Emacs redisplay code is
1617 suggesting a new name, which lisp code should override; if
1618 F->explicit_name is set, ignore the new name; otherwise, set it. */
1620 static void
1621 x_set_name (struct frame *f, Lisp_Object name, int explicit)
1623 /* Make sure that requests from lisp code override requests from
1624 Emacs redisplay code. */
1625 if (explicit)
1627 /* If we're switching from explicit to implicit, we had better
1628 update the mode lines and thereby update the title. */
1629 if (f->explicit_name && NILP (name))
1630 update_mode_lines = 1;
1632 f->explicit_name = ! NILP (name);
1634 else if (f->explicit_name)
1635 return;
1637 /* If NAME is nil, set the name to the x_id_name. */
1638 if (NILP (name))
1640 /* Check for no change needed in this very common case
1641 before we do any consing. */
1642 if (!strcmp (FRAME_X_DISPLAY_INFO (f)->x_id_name,
1643 SSDATA (f->name)))
1644 return;
1645 name = build_string (FRAME_X_DISPLAY_INFO (f)->x_id_name);
1647 else
1648 CHECK_STRING (name);
1650 /* Don't change the name if it's already NAME. */
1651 if (! NILP (Fstring_equal (name, f->name)))
1652 return;
1654 f->name = name;
1656 /* For setting the frame title, the title parameter should override
1657 the name parameter. */
1658 if (! NILP (f->title))
1659 name = f->title;
1661 x_set_name_internal (f, name);
1664 /* This function should be called when the user's lisp code has
1665 specified a name for the frame; the name will override any set by the
1666 redisplay code. */
1667 static void
1668 x_explicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
1670 x_set_name (f, arg, 1);
1673 /* This function should be called by Emacs redisplay code to set the
1674 name; names set this way will never override names set by the user's
1675 lisp code. */
1676 void
1677 x_implicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
1679 x_set_name (f, arg, 0);
1682 /* Change the title of frame F to NAME.
1683 If NAME is nil, use the frame name as the title. */
1685 static void
1686 x_set_title (struct frame *f, Lisp_Object name, Lisp_Object old_name)
1688 /* Don't change the title if it's already NAME. */
1689 if (EQ (name, f->title))
1690 return;
1692 update_mode_lines = 1;
1694 f->title = name;
1696 if (NILP (name))
1697 name = f->name;
1698 else
1699 CHECK_STRING (name);
1701 x_set_name_internal (f, name);
1704 void
1705 x_set_scroll_bar_default_width (struct frame *f)
1707 int wid = FRAME_COLUMN_WIDTH (f);
1708 #ifdef USE_TOOLKIT_SCROLL_BARS
1709 #ifdef USE_GTK
1710 int minw = xg_get_default_scrollbar_width ();
1711 #else
1712 int minw = 16;
1713 #endif
1714 /* A minimum width of 14 doesn't look good for toolkit scroll bars. */
1715 int width = minw + 2 * VERTICAL_SCROLL_BAR_WIDTH_TRIM;
1716 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (width + wid - 1) / wid;
1717 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = width;
1718 #else
1719 /* Make the actual width at least 14 pixels and a multiple of a
1720 character width. */
1721 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (14 + wid - 1) / wid;
1723 /* Use all of that space (aside from required margins) for the
1724 scroll bar. */
1725 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = 0;
1726 #endif
1730 /* Record in frame F the specified or default value according to ALIST
1731 of the parameter named PROP (a Lisp symbol). If no value is
1732 specified for PROP, look for an X default for XPROP on the frame
1733 named NAME. If that is not found either, use the value DEFLT. */
1735 static Lisp_Object
1736 x_default_scroll_bar_color_parameter (struct frame *f,
1737 Lisp_Object alist, Lisp_Object prop,
1738 const char *xprop, const char *xclass,
1739 int foreground_p)
1741 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
1742 Lisp_Object tem;
1744 tem = x_get_arg (dpyinfo, alist, prop, xprop, xclass, RES_TYPE_STRING);
1745 if (EQ (tem, Qunbound))
1747 #ifdef USE_TOOLKIT_SCROLL_BARS
1749 /* See if an X resource for the scroll bar color has been
1750 specified. */
1751 tem = display_x_get_resource (dpyinfo,
1752 build_string (foreground_p
1753 ? "foreground"
1754 : "background"),
1755 empty_unibyte_string,
1756 build_string ("verticalScrollBar"),
1757 empty_unibyte_string);
1758 if (!STRINGP (tem))
1760 /* If nothing has been specified, scroll bars will use a
1761 toolkit-dependent default. Because these defaults are
1762 difficult to get at without actually creating a scroll
1763 bar, use nil to indicate that no color has been
1764 specified. */
1765 tem = Qnil;
1768 #else /* not USE_TOOLKIT_SCROLL_BARS */
1770 tem = Qnil;
1772 #endif /* not USE_TOOLKIT_SCROLL_BARS */
1775 x_set_frame_parameters (f, Fcons (Fcons (prop, tem), Qnil));
1776 return tem;
1782 #ifdef USE_X_TOOLKIT
1784 /* If the WM_PROTOCOLS property does not already contain WM_TAKE_FOCUS,
1785 WM_DELETE_WINDOW, and WM_SAVE_YOURSELF, then add them. (They may
1786 already be present because of the toolkit (Motif adds some of them,
1787 for example, but Xt doesn't). */
1789 static void
1790 hack_wm_protocols (FRAME_PTR f, Widget widget)
1792 Display *dpy = XtDisplay (widget);
1793 Window w = XtWindow (widget);
1794 int need_delete = 1;
1795 int need_focus = 1;
1796 int need_save = 1;
1798 BLOCK_INPUT;
1800 Atom type;
1801 unsigned char *catoms;
1802 int format = 0;
1803 unsigned long nitems = 0;
1804 unsigned long bytes_after;
1806 if ((XGetWindowProperty (dpy, w,
1807 FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
1808 (long)0, (long)100, False, XA_ATOM,
1809 &type, &format, &nitems, &bytes_after,
1810 &catoms)
1811 == Success)
1812 && format == 32 && type == XA_ATOM)
1814 Atom *atoms = (Atom *) catoms;
1815 while (nitems > 0)
1817 nitems--;
1818 if (atoms[nitems]
1819 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window)
1820 need_delete = 0;
1821 else if (atoms[nitems]
1822 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_take_focus)
1823 need_focus = 0;
1824 else if (atoms[nitems]
1825 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself)
1826 need_save = 0;
1829 if (catoms)
1830 XFree (catoms);
1833 Atom props [10];
1834 int count = 0;
1835 if (need_delete)
1836 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window;
1837 if (need_focus)
1838 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_take_focus;
1839 if (need_save)
1840 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself;
1841 if (count)
1842 XChangeProperty (dpy, w, FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
1843 XA_ATOM, 32, PropModeAppend,
1844 (unsigned char *) props, count);
1846 UNBLOCK_INPUT;
1848 #endif
1852 /* Support routines for XIC (X Input Context). */
1854 #ifdef HAVE_X_I18N
1856 static XFontSet xic_create_xfontset (struct frame *);
1857 static XIMStyle best_xim_style (XIMStyles *, XIMStyles *);
1860 /* Supported XIM styles, ordered by preference. */
1862 static XIMStyle supported_xim_styles[] =
1864 XIMPreeditPosition | XIMStatusArea,
1865 XIMPreeditPosition | XIMStatusNothing,
1866 XIMPreeditPosition | XIMStatusNone,
1867 XIMPreeditNothing | XIMStatusArea,
1868 XIMPreeditNothing | XIMStatusNothing,
1869 XIMPreeditNothing | XIMStatusNone,
1870 XIMPreeditNone | XIMStatusArea,
1871 XIMPreeditNone | XIMStatusNothing,
1872 XIMPreeditNone | XIMStatusNone,
1877 #if defined HAVE_X_WINDOWS && defined USE_X_TOOLKIT
1878 /* Create an X fontset on frame F with base font name BASE_FONTNAME. */
1880 static const char xic_default_fontset[] = "-*-*-*-r-normal--14-*-*-*-*-*-*-*";
1882 /* Create an Xt fontset spec from the name of a base font.
1883 If `motif' is True use the Motif syntax. */
1884 char *
1885 xic_create_fontsetname (const char *base_fontname, int motif)
1887 const char *sep = motif ? ";" : ",";
1888 char *fontsetname;
1890 /* Make a fontset name from the base font name. */
1891 if (xic_default_fontset == base_fontname)
1892 { /* There is no base font name, use the default. */
1893 ptrdiff_t len = strlen (base_fontname) + 2;
1894 fontsetname = xmalloc (len);
1895 memset (fontsetname, 0, len);
1896 strcpy (fontsetname, base_fontname);
1898 else
1900 /* Make a fontset name from the base font name.
1901 The font set will be made of the following elements:
1902 - the base font.
1903 - the base font where the charset spec is replaced by -*-*.
1904 - the same but with the family also replaced with -*-*-. */
1905 const char *p = base_fontname;
1906 ptrdiff_t i;
1908 for (i = 0; *p; p++)
1909 if (*p == '-') i++;
1910 if (i != 14)
1911 { /* As the font name doesn't conform to XLFD, we can't
1912 modify it to generalize it to allcs and allfamilies.
1913 Use the specified font plus the default. */
1914 ptrdiff_t len =
1915 strlen (base_fontname) + strlen (xic_default_fontset) + 3;
1916 fontsetname = xmalloc (len);
1917 memset (fontsetname, 0, len);
1918 strcpy (fontsetname, base_fontname);
1919 strcat (fontsetname, sep);
1920 strcat (fontsetname, xic_default_fontset);
1922 else
1924 ptrdiff_t len;
1925 const char *p1 = NULL, *p2 = NULL, *p3 = NULL;
1926 char *font_allcs = NULL;
1927 char *font_allfamilies = NULL;
1928 char *font_all = NULL;
1929 const char *allcs = "*-*-*-*-*-*-*";
1930 const char *allfamilies = "-*-*-";
1931 const char *all = "*-*-*-*-";
1932 char *base;
1934 for (i = 0, p = base_fontname; i < 8; p++)
1936 if (*p == '-')
1938 i++;
1939 if (i == 3)
1940 p1 = p + 1;
1941 else if (i == 7)
1942 p2 = p + 1;
1943 else if (i == 6)
1944 p3 = p + 1;
1947 /* If base_fontname specifies ADSTYLE, make it a
1948 wildcard. */
1949 if (*p3 != '*')
1951 ptrdiff_t diff = (p2 - p3) - 2;
1953 base = alloca (strlen (base_fontname) + 1);
1954 memcpy (base, base_fontname, p3 - base_fontname);
1955 base[p3 - base_fontname] = '*';
1956 base[(p3 - base_fontname) + 1] = '-';
1957 strcpy (base + (p3 - base_fontname) + 2, p2);
1958 p = base + (p - base_fontname) - diff;
1959 p1 = base + (p1 - base_fontname);
1960 p2 = base + (p2 - base_fontname) - diff;
1961 base_fontname = base;
1964 /* Build the font spec that matches all charsets. */
1965 len = p - base_fontname + strlen (allcs) + 1;
1966 font_allcs = (char *) alloca (len);
1967 memset (font_allcs, 0, len);
1968 memcpy (font_allcs, base_fontname, p - base_fontname);
1969 strcat (font_allcs, allcs);
1971 /* Build the font spec that matches all families and
1972 add-styles. */
1973 len = p - p1 + strlen (allcs) + strlen (allfamilies) + 1;
1974 font_allfamilies = (char *) alloca (len);
1975 memset (font_allfamilies, 0, len);
1976 strcpy (font_allfamilies, allfamilies);
1977 memcpy (font_allfamilies + strlen (allfamilies), p1, p - p1);
1978 strcat (font_allfamilies, allcs);
1980 /* Build the font spec that matches all. */
1981 len = p - p2 + strlen (allcs) + strlen (all) + strlen (allfamilies) + 1;
1982 font_all = (char *) alloca (len);
1983 memset (font_all, 0, len);
1984 strcpy (font_all, allfamilies);
1985 strcat (font_all, all);
1986 memcpy (font_all + strlen (all) + strlen (allfamilies), p2, p - p2);
1987 strcat (font_all, allcs);
1989 /* Build the actual font set name. */
1990 len = strlen (base_fontname) + strlen (font_allcs)
1991 + strlen (font_allfamilies) + strlen (font_all) + 5;
1992 fontsetname = xmalloc (len);
1993 memset (fontsetname, 0, len);
1994 strcpy (fontsetname, base_fontname);
1995 strcat (fontsetname, sep);
1996 strcat (fontsetname, font_allcs);
1997 strcat (fontsetname, sep);
1998 strcat (fontsetname, font_allfamilies);
1999 strcat (fontsetname, sep);
2000 strcat (fontsetname, font_all);
2003 if (motif)
2004 strcat (fontsetname, ":");
2005 return fontsetname;
2007 #endif /* HAVE_X_WINDOWS && USE_X_TOOLKIT */
2009 #ifdef DEBUG_XIC_FONTSET
2010 static void
2011 print_fontset_result (XFontSet xfs, char *name, char **missing_list,
2012 int missing_count)
2014 if (xfs)
2015 fprintf (stderr, "XIC Fontset created: %s\n", name);
2016 else
2018 fprintf (stderr, "XIC Fontset failed: %s\n", name);
2019 while (missing_count-- > 0)
2021 fprintf (stderr, " missing: %s\n", *missing_list);
2022 missing_list++;
2027 #endif
2029 static XFontSet
2030 xic_create_xfontset (struct frame *f)
2032 XFontSet xfs = NULL;
2033 struct font *font = FRAME_FONT (f);
2034 int pixel_size = font->pixel_size;
2035 Lisp_Object rest, frame;
2037 /* See if there is another frame already using same fontset. */
2038 FOR_EACH_FRAME (rest, frame)
2040 struct frame *cf = XFRAME (frame);
2042 if (cf != f && FRAME_LIVE_P (f) && FRAME_X_P (cf)
2043 && FRAME_X_DISPLAY_INFO (cf) == FRAME_X_DISPLAY_INFO (f)
2044 && FRAME_FONT (f)
2045 && FRAME_FONT (f)->pixel_size == pixel_size)
2047 xfs = FRAME_XIC_FONTSET (cf);
2048 break;
2052 if (! xfs)
2054 char buf[256];
2055 char **missing_list;
2056 int missing_count;
2057 char *def_string;
2058 const char *xlfd_format = "-*-*-medium-r-normal--%d-*-*-*-*-*";
2060 sprintf (buf, xlfd_format, pixel_size);
2061 missing_list = NULL;
2062 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), buf,
2063 &missing_list, &missing_count, &def_string);
2064 #ifdef DEBUG_XIC_FONTSET
2065 print_fontset_result (xfs, buf, missing_list, missing_count);
2066 #endif
2067 if (missing_list)
2068 XFreeStringList (missing_list);
2069 if (! xfs)
2071 /* List of pixel sizes most likely available. Find one that
2072 is closest to pixel_size. */
2073 int sizes[] = {0, 8, 10, 11, 12, 14, 17, 18, 20, 24, 26, 34, 0};
2074 int *smaller, *larger;
2076 for (smaller = sizes; smaller[1]; smaller++)
2077 if (smaller[1] >= pixel_size)
2078 break;
2079 larger = smaller + 1;
2080 if (*larger == pixel_size)
2081 larger++;
2082 while (*smaller || *larger)
2084 int this_size;
2086 if (! *larger)
2087 this_size = *smaller--;
2088 else if (! *smaller)
2089 this_size = *larger++;
2090 else if (pixel_size - *smaller < *larger - pixel_size)
2091 this_size = *smaller--;
2092 else
2093 this_size = *larger++;
2094 sprintf (buf, xlfd_format, this_size);
2095 missing_list = NULL;
2096 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), buf,
2097 &missing_list, &missing_count, &def_string);
2098 #ifdef DEBUG_XIC_FONTSET
2099 print_fontset_result (xfs, buf, missing_list, missing_count);
2100 #endif
2101 if (missing_list)
2102 XFreeStringList (missing_list);
2103 if (xfs)
2104 break;
2107 if (! xfs)
2109 const char *last_resort = "-*-*-*-r-normal--*-*-*-*-*-*";
2111 missing_list = NULL;
2112 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), last_resort,
2113 &missing_list, &missing_count, &def_string);
2114 #ifdef DEBUG_XIC_FONTSET
2115 print_fontset_result (xfs, last_resort, missing_list, missing_count);
2116 #endif
2117 if (missing_list)
2118 XFreeStringList (missing_list);
2123 return xfs;
2126 /* Free the X fontset of frame F if it is the last frame using it. */
2128 void
2129 xic_free_xfontset (struct frame *f)
2131 Lisp_Object rest, frame;
2132 int shared_p = 0;
2134 if (!FRAME_XIC_FONTSET (f))
2135 return;
2137 /* See if there is another frame sharing the same fontset. */
2138 FOR_EACH_FRAME (rest, frame)
2140 struct frame *cf = XFRAME (frame);
2141 if (cf != f && FRAME_LIVE_P (f) && FRAME_X_P (cf)
2142 && FRAME_X_DISPLAY_INFO (cf) == FRAME_X_DISPLAY_INFO (f)
2143 && FRAME_XIC_FONTSET (cf) == FRAME_XIC_FONTSET (f))
2145 shared_p = 1;
2146 break;
2150 if (!shared_p)
2151 /* The fontset is not used anymore. It is safe to free it. */
2152 XFreeFontSet (FRAME_X_DISPLAY (f), FRAME_XIC_FONTSET (f));
2154 if (FRAME_XIC_BASE_FONTNAME (f))
2155 xfree (FRAME_XIC_BASE_FONTNAME (f));
2156 FRAME_XIC_BASE_FONTNAME (f) = NULL;
2157 FRAME_XIC_FONTSET (f) = NULL;
2161 /* Value is the best input style, given user preferences USER (already
2162 checked to be supported by Emacs), and styles supported by the
2163 input method XIM. */
2165 static XIMStyle
2166 best_xim_style (XIMStyles *user, XIMStyles *xim)
2168 int i, j;
2170 for (i = 0; i < user->count_styles; ++i)
2171 for (j = 0; j < xim->count_styles; ++j)
2172 if (user->supported_styles[i] == xim->supported_styles[j])
2173 return user->supported_styles[i];
2175 /* Return the default style. */
2176 return XIMPreeditNothing | XIMStatusNothing;
2179 /* Create XIC for frame F. */
2181 static XIMStyle xic_style;
2183 void
2184 create_frame_xic (struct frame *f)
2186 XIM xim;
2187 XIC xic = NULL;
2188 XFontSet xfs = NULL;
2190 if (FRAME_XIC (f))
2191 return;
2193 /* Create X fontset. */
2194 xfs = xic_create_xfontset (f);
2195 xim = FRAME_X_XIM (f);
2196 if (xim)
2198 XRectangle s_area;
2199 XPoint spot;
2200 XVaNestedList preedit_attr;
2201 XVaNestedList status_attr;
2203 s_area.x = 0; s_area.y = 0; s_area.width = 1; s_area.height = 1;
2204 spot.x = 0; spot.y = 1;
2206 /* Determine XIC style. */
2207 if (xic_style == 0)
2209 XIMStyles supported_list;
2210 supported_list.count_styles = (sizeof supported_xim_styles
2211 / sizeof supported_xim_styles[0]);
2212 supported_list.supported_styles = supported_xim_styles;
2213 xic_style = best_xim_style (&supported_list,
2214 FRAME_X_XIM_STYLES (f));
2217 preedit_attr = XVaCreateNestedList (0,
2218 XNFontSet, xfs,
2219 XNForeground,
2220 FRAME_FOREGROUND_PIXEL (f),
2221 XNBackground,
2222 FRAME_BACKGROUND_PIXEL (f),
2223 (xic_style & XIMPreeditPosition
2224 ? XNSpotLocation
2225 : NULL),
2226 &spot,
2227 NULL);
2228 status_attr = XVaCreateNestedList (0,
2229 XNArea,
2230 &s_area,
2231 XNFontSet,
2232 xfs,
2233 XNForeground,
2234 FRAME_FOREGROUND_PIXEL (f),
2235 XNBackground,
2236 FRAME_BACKGROUND_PIXEL (f),
2237 NULL);
2239 xic = XCreateIC (xim,
2240 XNInputStyle, xic_style,
2241 XNClientWindow, FRAME_X_WINDOW (f),
2242 XNFocusWindow, FRAME_X_WINDOW (f),
2243 XNStatusAttributes, status_attr,
2244 XNPreeditAttributes, preedit_attr,
2245 NULL);
2246 XFree (preedit_attr);
2247 XFree (status_attr);
2250 FRAME_XIC (f) = xic;
2251 FRAME_XIC_STYLE (f) = xic_style;
2252 FRAME_XIC_FONTSET (f) = xfs;
2256 /* Destroy XIC and free XIC fontset of frame F, if any. */
2258 void
2259 free_frame_xic (struct frame *f)
2261 if (FRAME_XIC (f) == NULL)
2262 return;
2264 XDestroyIC (FRAME_XIC (f));
2265 xic_free_xfontset (f);
2267 FRAME_XIC (f) = NULL;
2271 /* Place preedit area for XIC of window W's frame to specified
2272 pixel position X/Y. X and Y are relative to window W. */
2274 void
2275 xic_set_preeditarea (struct window *w, int x, int y)
2277 struct frame *f = XFRAME (w->frame);
2278 XVaNestedList attr;
2279 XPoint spot;
2281 spot.x = WINDOW_TO_FRAME_PIXEL_X (w, x) + WINDOW_LEFT_FRINGE_WIDTH (w);
2282 spot.y = WINDOW_TO_FRAME_PIXEL_Y (w, y) + FONT_BASE (FRAME_FONT (f));
2283 attr = XVaCreateNestedList (0, XNSpotLocation, &spot, NULL);
2284 XSetICValues (FRAME_XIC (f), XNPreeditAttributes, attr, NULL);
2285 XFree (attr);
2289 /* Place status area for XIC in bottom right corner of frame F.. */
2291 void
2292 xic_set_statusarea (struct frame *f)
2294 XIC xic = FRAME_XIC (f);
2295 XVaNestedList attr;
2296 XRectangle area;
2297 XRectangle *needed;
2299 /* Negotiate geometry of status area. If input method has existing
2300 status area, use its current size. */
2301 area.x = area.y = area.width = area.height = 0;
2302 attr = XVaCreateNestedList (0, XNAreaNeeded, &area, NULL);
2303 XSetICValues (xic, XNStatusAttributes, attr, NULL);
2304 XFree (attr);
2306 attr = XVaCreateNestedList (0, XNAreaNeeded, &needed, NULL);
2307 XGetICValues (xic, XNStatusAttributes, attr, NULL);
2308 XFree (attr);
2310 if (needed->width == 0) /* Use XNArea instead of XNAreaNeeded */
2312 attr = XVaCreateNestedList (0, XNArea, &needed, NULL);
2313 XGetICValues (xic, XNStatusAttributes, attr, NULL);
2314 XFree (attr);
2317 area.width = needed->width;
2318 area.height = needed->height;
2319 area.x = FRAME_PIXEL_WIDTH (f) - area.width - FRAME_INTERNAL_BORDER_WIDTH (f);
2320 area.y = (FRAME_PIXEL_HEIGHT (f) - area.height
2321 - FRAME_MENUBAR_HEIGHT (f)
2322 - FRAME_TOOLBAR_TOP_HEIGHT (f)
2323 - FRAME_INTERNAL_BORDER_WIDTH (f));
2324 XFree (needed);
2326 attr = XVaCreateNestedList (0, XNArea, &area, NULL);
2327 XSetICValues (xic, XNStatusAttributes, attr, NULL);
2328 XFree (attr);
2332 /* Set X fontset for XIC of frame F, using base font name
2333 BASE_FONTNAME. Called when a new Emacs fontset is chosen. */
2335 void
2336 xic_set_xfontset (struct frame *f, const char *base_fontname)
2338 XVaNestedList attr;
2339 XFontSet xfs;
2341 xic_free_xfontset (f);
2343 xfs = xic_create_xfontset (f);
2345 attr = XVaCreateNestedList (0, XNFontSet, xfs, NULL);
2346 if (FRAME_XIC_STYLE (f) & XIMPreeditPosition)
2347 XSetICValues (FRAME_XIC (f), XNPreeditAttributes, attr, NULL);
2348 if (FRAME_XIC_STYLE (f) & XIMStatusArea)
2349 XSetICValues (FRAME_XIC (f), XNStatusAttributes, attr, NULL);
2350 XFree (attr);
2352 FRAME_XIC_FONTSET (f) = xfs;
2355 #endif /* HAVE_X_I18N */
2359 #ifdef USE_X_TOOLKIT
2361 /* Create and set up the X widget for frame F. */
2363 static void
2364 x_window (struct frame *f, long window_prompting, int minibuffer_only)
2366 XClassHint class_hints;
2367 XSetWindowAttributes attributes;
2368 unsigned long attribute_mask;
2369 Widget shell_widget;
2370 Widget pane_widget;
2371 Widget frame_widget;
2372 Arg al [25];
2373 int ac;
2375 BLOCK_INPUT;
2377 /* Use the resource name as the top-level widget name
2378 for looking up resources. Make a non-Lisp copy
2379 for the window manager, so GC relocation won't bother it.
2381 Elsewhere we specify the window name for the window manager. */
2384 char *str = SSDATA (Vx_resource_name);
2385 f->namebuf = (char *) xmalloc (strlen (str) + 1);
2386 strcpy (f->namebuf, str);
2389 ac = 0;
2390 XtSetArg (al[ac], XtNallowShellResize, 1); ac++;
2391 XtSetArg (al[ac], XtNinput, 1); ac++;
2392 XtSetArg (al[ac], XtNmappedWhenManaged, 0); ac++;
2393 XtSetArg (al[ac], XtNborderWidth, f->border_width); ac++;
2394 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2395 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2396 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2397 shell_widget = XtAppCreateShell (f->namebuf, EMACS_CLASS,
2398 applicationShellWidgetClass,
2399 FRAME_X_DISPLAY (f), al, ac);
2401 f->output_data.x->widget = shell_widget;
2402 /* maybe_set_screen_title_format (shell_widget); */
2404 pane_widget = lw_create_widget ("main", "pane", widget_id_tick++,
2405 (widget_value *) NULL,
2406 shell_widget, False,
2407 (lw_callback) NULL,
2408 (lw_callback) NULL,
2409 (lw_callback) NULL,
2410 (lw_callback) NULL);
2412 ac = 0;
2413 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2414 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2415 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2416 XtSetArg (al[ac], XtNborderWidth, 0); ac++;
2417 XtSetValues (pane_widget, al, ac);
2418 f->output_data.x->column_widget = pane_widget;
2420 /* mappedWhenManaged to false tells to the paned window to not map/unmap
2421 the emacs screen when changing menubar. This reduces flickering. */
2423 ac = 0;
2424 XtSetArg (al[ac], XtNmappedWhenManaged, 0); ac++;
2425 XtSetArg (al[ac], XtNshowGrip, 0); ac++;
2426 XtSetArg (al[ac], XtNallowResize, 1); ac++;
2427 XtSetArg (al[ac], XtNresizeToPreferred, 1); ac++;
2428 XtSetArg (al[ac], XtNemacsFrame, f); ac++;
2429 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2430 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2431 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2432 XtSetArg (al[ac], XtNborderWidth, 0); ac++;
2433 frame_widget = XtCreateWidget (f->namebuf, emacsFrameClass, pane_widget,
2434 al, ac);
2436 f->output_data.x->edit_widget = frame_widget;
2438 XtManageChild (frame_widget);
2440 /* Do some needed geometry management. */
2442 char *tem, shell_position[sizeof "=x++" + 4 * INT_STRLEN_BOUND (int)];
2443 Arg gal[10];
2444 int gac = 0;
2445 int extra_borders = 0;
2446 int menubar_size
2447 = (f->output_data.x->menubar_widget
2448 ? (f->output_data.x->menubar_widget->core.height
2449 + f->output_data.x->menubar_widget->core.border_width)
2450 : 0);
2452 #if 0 /* Experimentally, we now get the right results
2453 for -geometry -0-0 without this. 24 Aug 96, rms. */
2454 if (FRAME_EXTERNAL_MENU_BAR (f))
2456 Dimension ibw = 0;
2457 XtVaGetValues (pane_widget, XtNinternalBorderWidth, &ibw, NULL);
2458 menubar_size += ibw;
2460 #endif
2462 f->output_data.x->menubar_height = menubar_size;
2464 #ifndef USE_LUCID
2465 /* Motif seems to need this amount added to the sizes
2466 specified for the shell widget. The Athena/Lucid widgets don't.
2467 Both conclusions reached experimentally. -- rms. */
2468 XtVaGetValues (f->output_data.x->edit_widget, XtNinternalBorderWidth,
2469 &extra_borders, NULL);
2470 extra_borders *= 2;
2471 #endif
2473 /* Convert our geometry parameters into a geometry string
2474 and specify it.
2475 Note that we do not specify here whether the position
2476 is a user-specified or program-specified one.
2477 We pass that information later, in x_wm_set_size_hints. */
2479 int left = f->left_pos;
2480 int xneg = window_prompting & XNegative;
2481 int top = f->top_pos;
2482 int yneg = window_prompting & YNegative;
2483 if (xneg)
2484 left = -left;
2485 if (yneg)
2486 top = -top;
2488 if (window_prompting & USPosition)
2489 sprintf (shell_position, "=%dx%d%c%d%c%d",
2490 FRAME_PIXEL_WIDTH (f) + extra_borders,
2491 FRAME_PIXEL_HEIGHT (f) + menubar_size + extra_borders,
2492 (xneg ? '-' : '+'), left,
2493 (yneg ? '-' : '+'), top);
2494 else
2496 sprintf (shell_position, "=%dx%d",
2497 FRAME_PIXEL_WIDTH (f) + extra_borders,
2498 FRAME_PIXEL_HEIGHT (f) + menubar_size + extra_borders);
2500 /* Setting x and y when the position is not specified in
2501 the geometry string will set program position in the WM hints.
2502 If Emacs had just one program position, we could set it in
2503 fallback resources, but since each make-frame call can specify
2504 different program positions, this is easier. */
2505 XtSetArg (gal[gac], XtNx, left); gac++;
2506 XtSetArg (gal[gac], XtNy, top); gac++;
2510 /* We don't free this because we don't know whether
2511 it is safe to free it while the frame exists.
2512 It isn't worth the trouble of arranging to free it
2513 when the frame is deleted. */
2514 tem = (char *) xstrdup (shell_position);
2515 XtSetArg (gal[gac], XtNgeometry, tem); gac++;
2516 XtSetValues (shell_widget, gal, gac);
2519 XtManageChild (pane_widget);
2520 XtRealizeWidget (shell_widget);
2522 if (FRAME_X_EMBEDDED_P (f))
2523 XReparentWindow (FRAME_X_DISPLAY (f), XtWindow (shell_widget),
2524 f->output_data.x->parent_desc, 0, 0);
2526 FRAME_X_WINDOW (f) = XtWindow (frame_widget);
2528 validate_x_resource_name ();
2530 class_hints.res_name = SSDATA (Vx_resource_name);
2531 class_hints.res_class = SSDATA (Vx_resource_class);
2532 XSetClassHint (FRAME_X_DISPLAY (f), XtWindow (shell_widget), &class_hints);
2534 #ifdef HAVE_X_I18N
2535 FRAME_XIC (f) = NULL;
2536 if (use_xim)
2537 create_frame_xic (f);
2538 #endif
2540 f->output_data.x->wm_hints.input = True;
2541 f->output_data.x->wm_hints.flags |= InputHint;
2542 XSetWMHints (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2543 &f->output_data.x->wm_hints);
2545 hack_wm_protocols (f, shell_widget);
2547 #ifdef HACK_EDITRES
2548 XtAddEventHandler (shell_widget, 0, True, _XEditResCheckMessages, 0);
2549 #endif
2551 /* Do a stupid property change to force the server to generate a
2552 PropertyNotify event so that the event_stream server timestamp will
2553 be initialized to something relevant to the time we created the window.
2555 XChangeProperty (XtDisplay (frame_widget), XtWindow (frame_widget),
2556 FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
2557 XA_ATOM, 32, PropModeAppend,
2558 (unsigned char*) NULL, 0);
2560 /* Make all the standard events reach the Emacs frame. */
2561 attributes.event_mask = STANDARD_EVENT_SET;
2563 #ifdef HAVE_X_I18N
2564 if (FRAME_XIC (f))
2566 /* XIM server might require some X events. */
2567 unsigned long fevent = NoEventMask;
2568 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2569 attributes.event_mask |= fevent;
2571 #endif /* HAVE_X_I18N */
2573 attribute_mask = CWEventMask;
2574 XChangeWindowAttributes (XtDisplay (shell_widget), XtWindow (shell_widget),
2575 attribute_mask, &attributes);
2577 XtMapWidget (frame_widget);
2579 /* x_set_name normally ignores requests to set the name if the
2580 requested name is the same as the current name. This is the one
2581 place where that assumption isn't correct; f->name is set, but
2582 the X server hasn't been told. */
2584 Lisp_Object name;
2585 int explicit = f->explicit_name;
2587 f->explicit_name = 0;
2588 name = f->name;
2589 f->name = Qnil;
2590 x_set_name (f, name, explicit);
2593 XDefineCursor (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2594 f->output_data.x->current_cursor
2595 = f->output_data.x->text_cursor);
2597 UNBLOCK_INPUT;
2599 /* This is a no-op, except under Motif. Make sure main areas are
2600 set to something reasonable, in case we get an error later. */
2601 lw_set_main_areas (pane_widget, 0, frame_widget);
2604 #else /* not USE_X_TOOLKIT */
2605 #ifdef USE_GTK
2606 static void
2607 x_window (FRAME_PTR f)
2609 if (! xg_create_frame_widgets (f))
2610 error ("Unable to create window");
2612 #ifdef HAVE_X_I18N
2613 FRAME_XIC (f) = NULL;
2614 if (use_xim)
2616 BLOCK_INPUT;
2617 create_frame_xic (f);
2618 if (FRAME_XIC (f))
2620 /* XIM server might require some X events. */
2621 unsigned long fevent = NoEventMask;
2622 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2624 if (fevent != NoEventMask)
2626 XSetWindowAttributes attributes;
2627 XWindowAttributes wattr;
2628 unsigned long attribute_mask;
2630 XGetWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2631 &wattr);
2632 attributes.event_mask = wattr.your_event_mask | fevent;
2633 attribute_mask = CWEventMask;
2634 XChangeWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2635 attribute_mask, &attributes);
2638 UNBLOCK_INPUT;
2640 #endif
2643 #else /*! USE_GTK */
2644 /* Create and set up the X window for frame F. */
2646 static void
2647 x_window (struct frame *f)
2649 XClassHint class_hints;
2650 XSetWindowAttributes attributes;
2651 unsigned long attribute_mask;
2653 attributes.background_pixel = FRAME_BACKGROUND_PIXEL (f);
2654 attributes.border_pixel = f->output_data.x->border_pixel;
2655 attributes.bit_gravity = StaticGravity;
2656 attributes.backing_store = NotUseful;
2657 attributes.save_under = True;
2658 attributes.event_mask = STANDARD_EVENT_SET;
2659 attributes.colormap = FRAME_X_COLORMAP (f);
2660 attribute_mask = (CWBackPixel | CWBorderPixel | CWBitGravity | CWEventMask
2661 | CWColormap);
2663 BLOCK_INPUT;
2664 FRAME_X_WINDOW (f)
2665 = XCreateWindow (FRAME_X_DISPLAY (f),
2666 f->output_data.x->parent_desc,
2667 f->left_pos,
2668 f->top_pos,
2669 FRAME_PIXEL_WIDTH (f), FRAME_PIXEL_HEIGHT (f),
2670 f->border_width,
2671 CopyFromParent, /* depth */
2672 InputOutput, /* class */
2673 FRAME_X_VISUAL (f),
2674 attribute_mask, &attributes);
2676 #ifdef HAVE_X_I18N
2677 if (use_xim)
2679 create_frame_xic (f);
2680 if (FRAME_XIC (f))
2682 /* XIM server might require some X events. */
2683 unsigned long fevent = NoEventMask;
2684 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2685 attributes.event_mask |= fevent;
2686 attribute_mask = CWEventMask;
2687 XChangeWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2688 attribute_mask, &attributes);
2691 #endif /* HAVE_X_I18N */
2693 validate_x_resource_name ();
2695 class_hints.res_name = SSDATA (Vx_resource_name);
2696 class_hints.res_class = SSDATA (Vx_resource_class);
2697 XSetClassHint (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), &class_hints);
2699 /* The menubar is part of the ordinary display;
2700 it does not count in addition to the height of the window. */
2701 f->output_data.x->menubar_height = 0;
2703 /* This indicates that we use the "Passive Input" input model.
2704 Unless we do this, we don't get the Focus{In,Out} events that we
2705 need to draw the cursor correctly. Accursed bureaucrats.
2706 XWhipsAndChains (FRAME_X_DISPLAY (f), IronMaiden, &TheRack); */
2708 f->output_data.x->wm_hints.input = True;
2709 f->output_data.x->wm_hints.flags |= InputHint;
2710 XSetWMHints (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2711 &f->output_data.x->wm_hints);
2712 f->output_data.x->wm_hints.icon_pixmap = None;
2714 /* Request "save yourself" and "delete window" commands from wm. */
2716 Atom protocols[2];
2717 protocols[0] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window;
2718 protocols[1] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself;
2719 XSetWMProtocols (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), protocols, 2);
2722 /* x_set_name normally ignores requests to set the name if the
2723 requested name is the same as the current name. This is the one
2724 place where that assumption isn't correct; f->name is set, but
2725 the X server hasn't been told. */
2727 Lisp_Object name;
2728 int explicit = f->explicit_name;
2730 f->explicit_name = 0;
2731 name = f->name;
2732 f->name = Qnil;
2733 x_set_name (f, name, explicit);
2736 XDefineCursor (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2737 f->output_data.x->current_cursor
2738 = f->output_data.x->text_cursor);
2740 UNBLOCK_INPUT;
2742 if (FRAME_X_WINDOW (f) == 0)
2743 error ("Unable to create window");
2746 #endif /* not USE_GTK */
2747 #endif /* not USE_X_TOOLKIT */
2749 /* Verify that the icon position args for this window are valid. */
2751 static void
2752 x_icon_verify (struct frame *f, Lisp_Object parms)
2754 Lisp_Object icon_x, icon_y;
2756 /* Set the position of the icon. Note that twm groups all
2757 icons in an icon window. */
2758 icon_x = x_frame_get_and_record_arg (f, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
2759 icon_y = x_frame_get_and_record_arg (f, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
2760 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
2762 CHECK_NUMBER (icon_x);
2763 CHECK_NUMBER (icon_y);
2765 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
2766 error ("Both left and top icon corners of icon must be specified");
2769 /* Handle the icon stuff for this window. Perhaps later we might
2770 want an x_set_icon_position which can be called interactively as
2771 well. */
2773 static void
2774 x_icon (struct frame *f, Lisp_Object parms)
2776 Lisp_Object icon_x, icon_y;
2777 #if 0
2778 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
2779 #endif
2781 /* Set the position of the icon. Note that twm groups all
2782 icons in an icon window. */
2783 icon_x = x_frame_get_and_record_arg (f, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
2784 icon_y = x_frame_get_and_record_arg (f, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
2785 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
2787 CHECK_NUMBER (icon_x);
2788 CHECK_NUMBER (icon_y);
2790 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
2791 error ("Both left and top icon corners of icon must be specified");
2793 BLOCK_INPUT;
2795 if (! EQ (icon_x, Qunbound))
2796 x_wm_set_icon_position (f, XINT (icon_x), XINT (icon_y));
2798 #if 0 /* x_get_arg removes the visibility parameter as a side effect,
2799 but x_create_frame still needs it. */
2800 /* Start up iconic or window? */
2801 x_wm_set_window_state
2802 (f, (EQ (x_get_arg (dpyinfo, parms, Qvisibility, 0, 0, RES_TYPE_SYMBOL),
2803 Qicon)
2804 ? IconicState
2805 : NormalState));
2806 #endif
2808 x_text_icon (f, SSDATA ((!NILP (f->icon_name)
2809 ? f->icon_name
2810 : f->name)));
2812 UNBLOCK_INPUT;
2815 /* Make the GCs needed for this window, setting the
2816 background, border and mouse colors; also create the
2817 mouse cursor and the gray border tile. */
2819 static void
2820 x_make_gc (struct frame *f)
2822 XGCValues gc_values;
2824 BLOCK_INPUT;
2826 /* Create the GCs of this frame.
2827 Note that many default values are used. */
2829 gc_values.foreground = FRAME_FOREGROUND_PIXEL (f);
2830 gc_values.background = FRAME_BACKGROUND_PIXEL (f);
2831 gc_values.line_width = 0; /* Means 1 using fast algorithm. */
2832 f->output_data.x->normal_gc
2833 = XCreateGC (FRAME_X_DISPLAY (f),
2834 FRAME_X_WINDOW (f),
2835 GCLineWidth | GCForeground | GCBackground,
2836 &gc_values);
2838 /* Reverse video style. */
2839 gc_values.foreground = FRAME_BACKGROUND_PIXEL (f);
2840 gc_values.background = FRAME_FOREGROUND_PIXEL (f);
2841 f->output_data.x->reverse_gc
2842 = XCreateGC (FRAME_X_DISPLAY (f),
2843 FRAME_X_WINDOW (f),
2844 GCForeground | GCBackground | GCLineWidth,
2845 &gc_values);
2847 /* Cursor has cursor-color background, background-color foreground. */
2848 gc_values.foreground = FRAME_BACKGROUND_PIXEL (f);
2849 gc_values.background = f->output_data.x->cursor_pixel;
2850 gc_values.fill_style = FillOpaqueStippled;
2851 f->output_data.x->cursor_gc
2852 = XCreateGC (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2853 (GCForeground | GCBackground
2854 | GCFillStyle | GCLineWidth),
2855 &gc_values);
2857 /* Reliefs. */
2858 f->output_data.x->white_relief.gc = 0;
2859 f->output_data.x->black_relief.gc = 0;
2861 /* Create the gray border tile used when the pointer is not in
2862 the frame. Since this depends on the frame's pixel values,
2863 this must be done on a per-frame basis. */
2864 f->output_data.x->border_tile
2865 = (XCreatePixmapFromBitmapData
2866 (FRAME_X_DISPLAY (f), FRAME_X_DISPLAY_INFO (f)->root_window,
2867 gray_bits, gray_width, gray_height,
2868 FRAME_FOREGROUND_PIXEL (f),
2869 FRAME_BACKGROUND_PIXEL (f),
2870 DefaultDepth (FRAME_X_DISPLAY (f), FRAME_X_SCREEN_NUMBER (f))));
2872 UNBLOCK_INPUT;
2876 /* Free what was allocated in x_make_gc. */
2878 void
2879 x_free_gcs (struct frame *f)
2881 Display *dpy = FRAME_X_DISPLAY (f);
2883 BLOCK_INPUT;
2885 if (f->output_data.x->normal_gc)
2887 XFreeGC (dpy, f->output_data.x->normal_gc);
2888 f->output_data.x->normal_gc = 0;
2891 if (f->output_data.x->reverse_gc)
2893 XFreeGC (dpy, f->output_data.x->reverse_gc);
2894 f->output_data.x->reverse_gc = 0;
2897 if (f->output_data.x->cursor_gc)
2899 XFreeGC (dpy, f->output_data.x->cursor_gc);
2900 f->output_data.x->cursor_gc = 0;
2903 if (f->output_data.x->border_tile)
2905 XFreePixmap (dpy, f->output_data.x->border_tile);
2906 f->output_data.x->border_tile = 0;
2909 UNBLOCK_INPUT;
2913 /* Handler for signals raised during x_create_frame and
2914 x_create_tip_frame. FRAME is the frame which is partially
2915 constructed. */
2917 static Lisp_Object
2918 unwind_create_frame (Lisp_Object frame)
2920 struct frame *f = XFRAME (frame);
2922 /* If frame is already dead, nothing to do. This can happen if the
2923 display is disconnected after the frame has become official, but
2924 before x_create_frame removes the unwind protect. */
2925 if (!FRAME_LIVE_P (f))
2926 return Qnil;
2928 /* If frame is ``official'', nothing to do. */
2929 if (NILP (Fmemq (frame, Vframe_list)))
2931 #if GLYPH_DEBUG && XASSERTS
2932 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
2933 #endif
2935 x_free_frame_resources (f);
2936 free_glyphs (f);
2938 #if GLYPH_DEBUG
2939 /* Check that reference counts are indeed correct. */
2940 xassert (dpyinfo->reference_count == dpyinfo_refcount);
2941 xassert (dpyinfo->terminal->image_cache->refcount == image_cache_refcount);
2942 #endif
2943 return Qt;
2946 return Qnil;
2949 static Lisp_Object
2950 unwind_create_frame_1 (Lisp_Object val)
2952 inhibit_lisp_code = val;
2953 return Qnil;
2956 static void
2957 x_default_font_parameter (struct frame *f, Lisp_Object parms)
2959 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
2960 Lisp_Object font_param = x_get_arg (dpyinfo, parms, Qfont, NULL, NULL,
2961 RES_TYPE_STRING);
2962 Lisp_Object font = Qnil;
2963 if (EQ (font_param, Qunbound))
2964 font_param = Qnil;
2966 if (NILP (font_param))
2968 /* System font should take precedence over X resources. We suggest this
2969 regardless of font-use-system-font because .emacs may not have been
2970 read yet. */
2971 const char *system_font = xsettings_get_system_font ();
2972 if (system_font)
2974 char *name = xstrdup (system_font);
2975 font = font_open_by_name (f, name);
2976 xfree (name);
2980 if (NILP (font))
2981 font = !NILP (font_param) ? font_param
2982 : x_get_arg (dpyinfo, parms, Qfont, "font", "Font", RES_TYPE_STRING);
2984 if (! FONTP (font) && ! STRINGP (font))
2986 const char *names[]
2988 #ifdef HAVE_XFT
2989 /* This will find the normal Xft font. */
2990 "monospace-10",
2991 #endif
2992 "-adobe-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-1",
2993 "-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-1",
2994 "-*-*-medium-r-normal-*-*-140-*-*-c-*-iso8859-1",
2995 /* This was formerly the first thing tried, but it finds
2996 too many fonts and takes too long. */
2997 "-*-*-medium-r-*-*-*-*-*-*-c-*-iso8859-1",
2998 /* If those didn't work, look for something which will
2999 at least work. */
3000 "-*-fixed-*-*-*-*-*-140-*-*-c-*-iso8859-1",
3001 "fixed",
3002 NULL };
3003 int i;
3005 for (i = 0; names[i]; i++)
3007 font = font_open_by_name (f, names[i]);
3008 if (! NILP (font))
3009 break;
3011 if (NILP (font))
3012 error ("No suitable font was found");
3014 else if (!NILP (font_param))
3016 /* Remember the explicit font parameter, so we can re-apply it after
3017 we've applied the `default' face settings. */
3018 x_set_frame_parameters (f, Fcons (Fcons (Qfont_param, font_param), Qnil));
3021 /* This call will make X resources override any system font setting. */
3022 x_default_parameter (f, parms, Qfont, font, "font", "Font", RES_TYPE_STRING);
3026 DEFUN ("x-wm-set-size-hint", Fx_wm_set_size_hint, Sx_wm_set_size_hint,
3027 0, 1, 0,
3028 doc: /* Send the size hints for frame FRAME to the window manager.
3029 If FRAME is nil, use the selected frame. */)
3030 (Lisp_Object frame)
3032 struct frame *f;
3033 if (NILP (frame))
3034 frame = selected_frame;
3035 f = XFRAME (frame);
3036 BLOCK_INPUT;
3037 if (FRAME_X_P (f))
3038 x_wm_set_size_hint (f, 0, 0);
3039 UNBLOCK_INPUT;
3040 return Qnil;
3043 static void
3044 set_machine_and_pid_properties (struct frame *f)
3046 long pid = (long) getpid ();
3048 /* This will set WM_CLIENT_MACHINE and WM_LOCALE_NAME. */
3049 XSetWMProperties (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), NULL, NULL,
3050 NULL, 0, NULL, NULL, NULL);
3051 XChangeProperty (FRAME_X_DISPLAY (f),
3052 FRAME_OUTER_WINDOW (f),
3053 XInternAtom (FRAME_X_DISPLAY (f),
3054 "_NET_WM_PID",
3055 False),
3056 XA_CARDINAL, 32, PropModeReplace,
3057 (unsigned char *) &pid, 1);
3060 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
3061 1, 1, 0,
3062 doc: /* Make a new X window, which is called a "frame" in Emacs terms.
3063 Return an Emacs frame object.
3064 PARMS is an alist of frame parameters.
3065 If the parameters specify that the frame should not have a minibuffer,
3066 and do not specify a specific minibuffer window to use,
3067 then `default-minibuffer-frame' must be a frame whose minibuffer can
3068 be shared by the new frame.
3070 This function is an internal primitive--use `make-frame' instead. */)
3071 (Lisp_Object parms)
3073 struct frame *f;
3074 Lisp_Object frame, tem;
3075 Lisp_Object name;
3076 int minibuffer_only = 0;
3077 long window_prompting = 0;
3078 int width, height;
3079 int count = SPECPDL_INDEX ();
3080 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
3081 Lisp_Object display;
3082 struct x_display_info *dpyinfo = NULL;
3083 Lisp_Object parent;
3084 struct kboard *kb;
3086 parms = Fcopy_alist (parms);
3088 /* Use this general default value to start with
3089 until we know if this frame has a specified name. */
3090 Vx_resource_name = Vinvocation_name;
3092 display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_NUMBER);
3093 if (EQ (display, Qunbound))
3094 display = x_get_arg (dpyinfo, parms, Qdisplay, 0, 0, RES_TYPE_STRING);
3095 if (EQ (display, Qunbound))
3096 display = Qnil;
3097 dpyinfo = check_x_display_info (display);
3098 kb = dpyinfo->terminal->kboard;
3100 if (!dpyinfo->terminal->name)
3101 error ("Terminal is not live, can't create new frames on it");
3103 name = x_get_arg (dpyinfo, parms, Qname, "name", "Name", RES_TYPE_STRING);
3104 if (!STRINGP (name)
3105 && ! EQ (name, Qunbound)
3106 && ! NILP (name))
3107 error ("Invalid frame name--not a string or nil");
3109 if (STRINGP (name))
3110 Vx_resource_name = name;
3112 /* See if parent window is specified. */
3113 parent = x_get_arg (dpyinfo, parms, Qparent_id, NULL, NULL, RES_TYPE_NUMBER);
3114 if (EQ (parent, Qunbound))
3115 parent = Qnil;
3116 if (! NILP (parent))
3117 CHECK_NUMBER (parent);
3119 /* make_frame_without_minibuffer can run Lisp code and garbage collect. */
3120 /* No need to protect DISPLAY because that's not used after passing
3121 it to make_frame_without_minibuffer. */
3122 frame = Qnil;
3123 GCPRO4 (parms, parent, name, frame);
3124 tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
3125 RES_TYPE_SYMBOL);
3126 if (EQ (tem, Qnone) || NILP (tem))
3127 f = make_frame_without_minibuffer (Qnil, kb, display);
3128 else if (EQ (tem, Qonly))
3130 f = make_minibuffer_frame ();
3131 minibuffer_only = 1;
3133 else if (WINDOWP (tem))
3134 f = make_frame_without_minibuffer (tem, kb, display);
3135 else
3136 f = make_frame (1);
3138 XSETFRAME (frame, f);
3140 /* Note that X Windows does support scroll bars. */
3141 FRAME_CAN_HAVE_SCROLL_BARS (f) = 1;
3143 f->terminal = dpyinfo->terminal;
3145 f->output_method = output_x_window;
3146 f->output_data.x = (struct x_output *) xmalloc (sizeof (struct x_output));
3147 memset (f->output_data.x, 0, sizeof (struct x_output));
3148 f->output_data.x->icon_bitmap = -1;
3149 FRAME_FONTSET (f) = -1;
3150 f->output_data.x->scroll_bar_foreground_pixel = -1;
3151 f->output_data.x->scroll_bar_background_pixel = -1;
3152 #ifdef USE_TOOLKIT_SCROLL_BARS
3153 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
3154 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
3155 #endif /* USE_TOOLKIT_SCROLL_BARS */
3157 f->icon_name
3158 = x_get_arg (dpyinfo, parms, Qicon_name, "iconName", "Title",
3159 RES_TYPE_STRING);
3160 if (! STRINGP (f->icon_name))
3161 f->icon_name = Qnil;
3163 FRAME_X_DISPLAY_INFO (f) = dpyinfo;
3165 /* With FRAME_X_DISPLAY_INFO set up, this unwind-protect is safe. */
3166 record_unwind_protect (unwind_create_frame, frame);
3168 /* These colors will be set anyway later, but it's important
3169 to get the color reference counts right, so initialize them! */
3171 Lisp_Object black;
3172 struct gcpro gcpro1;
3174 /* Function x_decode_color can signal an error. Make
3175 sure to initialize color slots so that we won't try
3176 to free colors we haven't allocated. */
3177 FRAME_FOREGROUND_PIXEL (f) = -1;
3178 FRAME_BACKGROUND_PIXEL (f) = -1;
3179 f->output_data.x->cursor_pixel = -1;
3180 f->output_data.x->cursor_foreground_pixel = -1;
3181 f->output_data.x->border_pixel = -1;
3182 f->output_data.x->mouse_pixel = -1;
3184 black = build_string ("black");
3185 GCPRO1 (black);
3186 FRAME_FOREGROUND_PIXEL (f)
3187 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3188 FRAME_BACKGROUND_PIXEL (f)
3189 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3190 f->output_data.x->cursor_pixel
3191 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3192 f->output_data.x->cursor_foreground_pixel
3193 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3194 f->output_data.x->border_pixel
3195 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3196 f->output_data.x->mouse_pixel
3197 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3198 UNGCPRO;
3201 /* Specify the parent under which to make this X window. */
3203 if (!NILP (parent))
3205 f->output_data.x->parent_desc = (Window) XFASTINT (parent);
3206 f->output_data.x->explicit_parent = 1;
3208 else
3210 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
3211 f->output_data.x->explicit_parent = 0;
3214 /* Set the name; the functions to which we pass f expect the name to
3215 be set. */
3216 if (EQ (name, Qunbound) || NILP (name))
3218 f->name = build_string (dpyinfo->x_id_name);
3219 f->explicit_name = 0;
3221 else
3223 f->name = name;
3224 f->explicit_name = 1;
3225 /* use the frame's title when getting resources for this frame. */
3226 specbind (Qx_resource_name, name);
3229 f->resx = dpyinfo->resx;
3230 f->resy = dpyinfo->resy;
3232 #ifdef HAVE_FREETYPE
3233 #ifdef HAVE_XFT
3234 register_font_driver (&xftfont_driver, f);
3235 #else /* not HAVE_XFT */
3236 register_font_driver (&ftxfont_driver, f);
3237 #endif /* not HAVE_XFT */
3238 #endif /* HAVE_FREETYPE */
3239 register_font_driver (&xfont_driver, f);
3241 x_default_parameter (f, parms, Qfont_backend, Qnil,
3242 "fontBackend", "FontBackend", RES_TYPE_STRING);
3244 /* Extract the window parameters from the supplied values
3245 that are needed to determine window geometry. */
3246 x_default_font_parameter (f, parms);
3247 if (!FRAME_FONT (f))
3249 delete_frame (frame, Qnoelisp);
3250 error ("Invalid frame font");
3253 /* Frame contents get displaced if an embedded X window has a border. */
3254 if (! FRAME_X_EMBEDDED_P (f))
3255 x_default_parameter (f, parms, Qborder_width, make_number (0),
3256 "borderWidth", "BorderWidth", RES_TYPE_NUMBER);
3258 /* This defaults to 1 in order to match xterm. We recognize either
3259 internalBorderWidth or internalBorder (which is what xterm calls
3260 it). */
3261 if (NILP (Fassq (Qinternal_border_width, parms)))
3263 Lisp_Object value;
3265 value = x_get_arg (dpyinfo, parms, Qinternal_border_width,
3266 "internalBorder", "internalBorder", RES_TYPE_NUMBER);
3267 if (! EQ (value, Qunbound))
3268 parms = Fcons (Fcons (Qinternal_border_width, value),
3269 parms);
3271 x_default_parameter (f, parms, Qinternal_border_width,
3272 #ifdef USE_GTK /* We used to impose 0 in xg_create_frame_widgets. */
3273 make_number (0),
3274 #else
3275 make_number (1),
3276 #endif
3277 "internalBorderWidth", "internalBorderWidth",
3278 RES_TYPE_NUMBER);
3279 x_default_parameter (f, parms, Qvertical_scroll_bars,
3280 #if defined (USE_GTK) && defined (USE_TOOLKIT_SCROLL_BARS)
3281 Qright,
3282 #else
3283 Qleft,
3284 #endif
3285 "verticalScrollBars", "ScrollBars",
3286 RES_TYPE_SYMBOL);
3288 /* Also do the stuff which must be set before the window exists. */
3289 x_default_parameter (f, parms, Qforeground_color, build_string ("black"),
3290 "foreground", "Foreground", RES_TYPE_STRING);
3291 x_default_parameter (f, parms, Qbackground_color, build_string ("white"),
3292 "background", "Background", RES_TYPE_STRING);
3293 x_default_parameter (f, parms, Qmouse_color, build_string ("black"),
3294 "pointerColor", "Foreground", RES_TYPE_STRING);
3295 x_default_parameter (f, parms, Qborder_color, build_string ("black"),
3296 "borderColor", "BorderColor", RES_TYPE_STRING);
3297 x_default_parameter (f, parms, Qscreen_gamma, Qnil,
3298 "screenGamma", "ScreenGamma", RES_TYPE_FLOAT);
3299 x_default_parameter (f, parms, Qline_spacing, Qnil,
3300 "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
3301 x_default_parameter (f, parms, Qleft_fringe, Qnil,
3302 "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
3303 x_default_parameter (f, parms, Qright_fringe, Qnil,
3304 "rightFringe", "RightFringe", RES_TYPE_NUMBER);
3306 x_default_scroll_bar_color_parameter (f, parms, Qscroll_bar_foreground,
3307 "scrollBarForeground",
3308 "ScrollBarForeground", 1);
3309 x_default_scroll_bar_color_parameter (f, parms, Qscroll_bar_background,
3310 "scrollBarBackground",
3311 "ScrollBarBackground", 0);
3313 #if GLYPH_DEBUG
3314 image_cache_refcount =
3315 FRAME_IMAGE_CACHE (f) ? FRAME_IMAGE_CACHE (f)->refcount : 0;
3316 dpyinfo_refcount = dpyinfo->reference_count;
3317 #endif /* GLYPH_DEBUG */
3319 /* Init faces before x_default_parameter is called for scroll-bar
3320 parameters because that function calls x_set_scroll_bar_width,
3321 which calls change_frame_size, which calls Fset_window_buffer,
3322 which runs hooks, which call Fvertical_motion. At the end, we
3323 end up in init_iterator with a null face cache, which should not
3324 happen. */
3325 init_frame_faces (f);
3327 /* Set the menu-bar-lines and tool-bar-lines parameters. We don't
3328 look up the X resources controlling the menu-bar and tool-bar
3329 here; they are processed specially at startup, and reflected in
3330 the values of the mode variables.
3332 Avoid calling window-configuration-change-hook; otherwise we
3333 could get an infloop in next_frame since the frame is not yet in
3334 Vframe_list. */
3336 int count2 = SPECPDL_INDEX ();
3337 record_unwind_protect (unwind_create_frame_1, inhibit_lisp_code);
3338 inhibit_lisp_code = Qt;
3340 x_default_parameter (f, parms, Qmenu_bar_lines,
3341 NILP (Vmenu_bar_mode)
3342 ? make_number (0) : make_number (1),
3343 NULL, NULL, RES_TYPE_NUMBER);
3344 x_default_parameter (f, parms, Qtool_bar_lines,
3345 NILP (Vtool_bar_mode)
3346 ? make_number (0) : make_number (1),
3347 NULL, NULL, RES_TYPE_NUMBER);
3349 unbind_to (count2, Qnil);
3352 x_default_parameter (f, parms, Qbuffer_predicate, Qnil,
3353 "bufferPredicate", "BufferPredicate",
3354 RES_TYPE_SYMBOL);
3355 x_default_parameter (f, parms, Qtitle, Qnil,
3356 "title", "Title", RES_TYPE_STRING);
3357 x_default_parameter (f, parms, Qwait_for_wm, Qt,
3358 "waitForWM", "WaitForWM", RES_TYPE_BOOLEAN);
3359 x_default_parameter (f, parms, Qfullscreen, Qnil,
3360 "fullscreen", "Fullscreen", RES_TYPE_SYMBOL);
3361 x_default_parameter (f, parms, Qtool_bar_position,
3362 f->tool_bar_position, 0, 0, RES_TYPE_SYMBOL);
3364 /* Compute the size of the X window. */
3365 window_prompting = x_figure_window_size (f, parms, 1);
3367 tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
3368 f->no_split = minibuffer_only || EQ (tem, Qt);
3370 x_icon_verify (f, parms);
3372 /* Create the X widget or window. */
3373 #ifdef USE_X_TOOLKIT
3374 x_window (f, window_prompting, minibuffer_only);
3375 #else
3376 x_window (f);
3377 #endif
3379 x_icon (f, parms);
3380 x_make_gc (f);
3382 /* Now consider the frame official. */
3383 f->terminal->reference_count++;
3384 FRAME_X_DISPLAY_INFO (f)->reference_count++;
3385 Vframe_list = Fcons (frame, Vframe_list);
3387 /* We need to do this after creating the X window, so that the
3388 icon-creation functions can say whose icon they're describing. */
3389 x_default_parameter (f, parms, Qicon_type, Qt,
3390 "bitmapIcon", "BitmapIcon", RES_TYPE_BOOLEAN);
3392 x_default_parameter (f, parms, Qauto_raise, Qnil,
3393 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
3394 x_default_parameter (f, parms, Qauto_lower, Qnil,
3395 "autoLower", "AutoRaiseLower", RES_TYPE_BOOLEAN);
3396 x_default_parameter (f, parms, Qcursor_type, Qbox,
3397 "cursorType", "CursorType", RES_TYPE_SYMBOL);
3398 x_default_parameter (f, parms, Qscroll_bar_width, Qnil,
3399 "scrollBarWidth", "ScrollBarWidth",
3400 RES_TYPE_NUMBER);
3401 x_default_parameter (f, parms, Qalpha, Qnil,
3402 "alpha", "Alpha", RES_TYPE_NUMBER);
3404 /* Dimensions, especially FRAME_LINES (f), must be done via change_frame_size.
3405 Change will not be effected unless different from the current
3406 FRAME_LINES (f). */
3407 width = FRAME_COLS (f);
3408 height = FRAME_LINES (f);
3410 SET_FRAME_COLS (f, 0);
3411 FRAME_LINES (f) = 0;
3412 change_frame_size (f, height, width, 1, 0, 0);
3414 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
3415 /* Create the menu bar. */
3416 if (!minibuffer_only && FRAME_EXTERNAL_MENU_BAR (f))
3418 /* If this signals an error, we haven't set size hints for the
3419 frame and we didn't make it visible. */
3420 initialize_frame_menubar (f);
3422 #ifndef USE_GTK
3423 /* This is a no-op, except under Motif where it arranges the
3424 main window for the widgets on it. */
3425 lw_set_main_areas (f->output_data.x->column_widget,
3426 f->output_data.x->menubar_widget,
3427 f->output_data.x->edit_widget);
3428 #endif /* not USE_GTK */
3430 #endif /* USE_X_TOOLKIT || USE_GTK */
3432 /* Tell the server what size and position, etc, we want, and how
3433 badly we want them. This should be done after we have the menu
3434 bar so that its size can be taken into account. */
3435 BLOCK_INPUT;
3436 x_wm_set_size_hint (f, window_prompting, 0);
3437 UNBLOCK_INPUT;
3439 /* Make the window appear on the frame and enable display, unless
3440 the caller says not to. However, with explicit parent, Emacs
3441 cannot control visibility, so don't try. */
3442 if (! f->output_data.x->explicit_parent)
3444 Lisp_Object visibility;
3446 visibility = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0,
3447 RES_TYPE_SYMBOL);
3448 if (EQ (visibility, Qunbound))
3449 visibility = Qt;
3451 if (EQ (visibility, Qicon))
3452 x_iconify_frame (f);
3453 else if (! NILP (visibility))
3454 x_make_frame_visible (f);
3455 else
3457 /* Must have been Qnil. */
3461 BLOCK_INPUT;
3463 /* Set machine name and pid for the purpose of window managers. */
3464 set_machine_and_pid_properties (f);
3466 /* Set the WM leader property. GTK does this itself, so this is not
3467 needed when using GTK. */
3468 if (dpyinfo->client_leader_window != 0)
3470 XChangeProperty (FRAME_X_DISPLAY (f),
3471 FRAME_OUTER_WINDOW (f),
3472 dpyinfo->Xatom_wm_client_leader,
3473 XA_WINDOW, 32, PropModeReplace,
3474 (unsigned char *) &dpyinfo->client_leader_window, 1);
3477 UNBLOCK_INPUT;
3479 /* Initialize `default-minibuffer-frame' in case this is the first
3480 frame on this terminal. */
3481 if (FRAME_HAS_MINIBUF_P (f)
3482 && (!FRAMEP (KVAR (kb, Vdefault_minibuffer_frame))
3483 || !FRAME_LIVE_P (XFRAME (KVAR (kb, Vdefault_minibuffer_frame)))))
3484 KVAR (kb, Vdefault_minibuffer_frame) = frame;
3486 /* All remaining specified parameters, which have not been "used"
3487 by x_get_arg and friends, now go in the misc. alist of the frame. */
3488 for (tem = parms; CONSP (tem); tem = XCDR (tem))
3489 if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
3490 f->param_alist = Fcons (XCAR (tem), f->param_alist);
3492 UNGCPRO;
3494 /* Make sure windows on this frame appear in calls to next-window
3495 and similar functions. */
3496 Vwindow_list = Qnil;
3498 return unbind_to (count, frame);
3502 /* FRAME is used only to get a handle on the X display. We don't pass the
3503 display info directly because we're called from frame.c, which doesn't
3504 know about that structure. */
3506 Lisp_Object
3507 x_get_focus_frame (struct frame *frame)
3509 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (frame);
3510 Lisp_Object xfocus;
3511 if (! dpyinfo->x_focus_frame)
3512 return Qnil;
3514 XSETFRAME (xfocus, dpyinfo->x_focus_frame);
3515 return xfocus;
3519 /* In certain situations, when the window manager follows a
3520 click-to-focus policy, there seems to be no way around calling
3521 XSetInputFocus to give another frame the input focus .
3523 In an ideal world, XSetInputFocus should generally be avoided so
3524 that applications don't interfere with the window manager's focus
3525 policy. But I think it's okay to use when it's clearly done
3526 following a user-command. */
3528 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
3529 doc: /* Set the input focus to FRAME.
3530 FRAME nil means use the selected frame. */)
3531 (Lisp_Object frame)
3533 struct frame *f = check_x_frame (frame);
3534 Display *dpy = FRAME_X_DISPLAY (f);
3536 BLOCK_INPUT;
3537 x_catch_errors (dpy);
3539 if (FRAME_X_EMBEDDED_P (f))
3541 /* For Xembedded frames, normally the embedder forwards key
3542 events. See XEmbed Protocol Specification at
3543 http://freedesktop.org/wiki/Specifications/xembed-spec */
3544 xembed_request_focus (f);
3546 else
3548 XSetInputFocus (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
3549 RevertToParent, CurrentTime);
3550 x_ewmh_activate_frame (f);
3553 x_uncatch_errors ();
3554 UNBLOCK_INPUT;
3556 return Qnil;
3560 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
3561 doc: /* Internal function called by `color-defined-p', which see
3562 .\(Note that the Nextstep version of this function ignores FRAME.) */)
3563 (Lisp_Object color, Lisp_Object frame)
3565 XColor foo;
3566 FRAME_PTR f = check_x_frame (frame);
3568 CHECK_STRING (color);
3570 if (x_defined_color (f, SSDATA (color), &foo, 0))
3571 return Qt;
3572 else
3573 return Qnil;
3576 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
3577 doc: /* Internal function called by `color-values', which see. */)
3578 (Lisp_Object color, Lisp_Object frame)
3580 XColor foo;
3581 FRAME_PTR f = check_x_frame (frame);
3583 CHECK_STRING (color);
3585 if (x_defined_color (f, SSDATA (color), &foo, 0))
3586 return list3 (make_number (foo.red),
3587 make_number (foo.green),
3588 make_number (foo.blue));
3589 else
3590 return Qnil;
3593 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
3594 doc: /* Internal function called by `display-color-p', which see. */)
3595 (Lisp_Object terminal)
3597 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3599 if (dpyinfo->n_planes <= 2)
3600 return Qnil;
3602 switch (dpyinfo->visual->class)
3604 case StaticColor:
3605 case PseudoColor:
3606 case TrueColor:
3607 case DirectColor:
3608 return Qt;
3610 default:
3611 return Qnil;
3615 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p, Sx_display_grayscale_p,
3616 0, 1, 0,
3617 doc: /* Return t if the X display supports shades of gray.
3618 Note that color displays do support shades of gray.
3619 The optional argument TERMINAL specifies which display to ask about.
3620 TERMINAL should be a terminal object, a frame or a display name (a string).
3621 If omitted or nil, that stands for the selected frame's display. */)
3622 (Lisp_Object terminal)
3624 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3626 if (dpyinfo->n_planes <= 1)
3627 return Qnil;
3629 switch (dpyinfo->visual->class)
3631 case StaticColor:
3632 case PseudoColor:
3633 case TrueColor:
3634 case DirectColor:
3635 case StaticGray:
3636 case GrayScale:
3637 return Qt;
3639 default:
3640 return Qnil;
3644 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
3645 0, 1, 0,
3646 doc: /* Return the width in pixels of the X display TERMINAL.
3647 The optional argument TERMINAL specifies which display to ask about.
3648 TERMINAL should be a terminal object, a frame or a display name (a string).
3649 If omitted or nil, that stands for the selected frame's display. */)
3650 (Lisp_Object terminal)
3652 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3654 return make_number (x_display_pixel_width (dpyinfo));
3657 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
3658 Sx_display_pixel_height, 0, 1, 0,
3659 doc: /* Return the height in pixels of the X display TERMINAL.
3660 The optional argument TERMINAL specifies which display to ask about.
3661 TERMINAL should be a terminal object, a frame or a display name (a string).
3662 If omitted or nil, that stands for the selected frame's display. */)
3663 (Lisp_Object terminal)
3665 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3667 return make_number (x_display_pixel_height (dpyinfo));
3670 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
3671 0, 1, 0,
3672 doc: /* Return the number of bitplanes of the X display TERMINAL.
3673 The optional argument TERMINAL specifies which display to ask about.
3674 TERMINAL should be a terminal object, a frame or a display name (a string).
3675 If omitted or nil, that stands for the selected frame's display. */)
3676 (Lisp_Object terminal)
3678 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3680 return make_number (dpyinfo->n_planes);
3683 DEFUN ("x-display-color-cells", Fx_display_color_cells, Sx_display_color_cells,
3684 0, 1, 0,
3685 doc: /* Return the number of color cells of the X display TERMINAL.
3686 The optional argument TERMINAL specifies which display to ask about.
3687 TERMINAL should be a terminal object, a frame or a display name (a string).
3688 If omitted or nil, that stands for the selected frame's display. */)
3689 (Lisp_Object terminal)
3691 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3693 int nr_planes = DisplayPlanes (dpyinfo->display,
3694 XScreenNumberOfScreen (dpyinfo->screen));
3696 /* Truncate nr_planes to 24 to avoid integer overflow.
3697 Some displays says 32, but only 24 bits are actually significant.
3698 There are only very few and rare video cards that have more than
3699 24 significant bits. Also 24 bits is more than 16 million colors,
3700 it "should be enough for everyone". */
3701 if (nr_planes > 24) nr_planes = 24;
3703 return make_number (1 << nr_planes);
3706 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
3707 Sx_server_max_request_size,
3708 0, 1, 0,
3709 doc: /* Return the maximum request size of the X server of display TERMINAL.
3710 The optional argument TERMINAL specifies which display to ask about.
3711 TERMINAL should be a terminal object, a frame or a display name (a string).
3712 If omitted or nil, that stands for the selected frame's display. */)
3713 (Lisp_Object terminal)
3715 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3717 return make_number (MAXREQUEST (dpyinfo->display));
3720 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
3721 doc: /* Return the "vendor ID" string of the X server of display TERMINAL.
3722 \(Labeling every distributor as a "vendor" embodies the false assumption
3723 that operating systems cannot be developed and distributed noncommercially.)
3724 The optional argument TERMINAL specifies which display to ask about.
3725 TERMINAL should be a terminal object, a frame or a display name (a string).
3726 If omitted or nil, that stands for the selected frame's display. */)
3727 (Lisp_Object terminal)
3729 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3730 const char *vendor = ServerVendor (dpyinfo->display);
3732 if (! vendor) vendor = "";
3733 return build_string (vendor);
3736 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
3737 doc: /* Return the version numbers of the X server of display TERMINAL.
3738 The value is a list of three integers: the major and minor
3739 version numbers of the X Protocol in use, and the distributor-specific release
3740 number. See also the function `x-server-vendor'.
3742 The optional argument TERMINAL specifies which display to ask about.
3743 TERMINAL should be a terminal object, a frame or a display name (a string).
3744 If omitted or nil, that stands for the selected frame's display. */)
3745 (Lisp_Object terminal)
3747 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3748 Display *dpy = dpyinfo->display;
3750 return Fcons (make_number (ProtocolVersion (dpy)),
3751 Fcons (make_number (ProtocolRevision (dpy)),
3752 Fcons (make_number (VendorRelease (dpy)), Qnil)));
3755 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
3756 doc: /* Return the number of screens on the X server of display TERMINAL.
3757 The optional argument TERMINAL specifies which display to ask about.
3758 TERMINAL should be a terminal object, a frame or a display name (a string).
3759 If omitted or nil, that stands for the selected frame's display. */)
3760 (Lisp_Object terminal)
3762 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3764 return make_number (ScreenCount (dpyinfo->display));
3767 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height, 0, 1, 0,
3768 doc: /* Return the height in millimeters of the X display TERMINAL.
3769 The optional argument TERMINAL specifies which display to ask about.
3770 TERMINAL should be a terminal object, a frame or a display name (a string).
3771 If omitted or nil, that stands for the selected frame's display. */)
3772 (Lisp_Object terminal)
3774 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3776 return make_number (HeightMMOfScreen (dpyinfo->screen));
3779 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width, 0, 1, 0,
3780 doc: /* Return the width in millimeters of the X display TERMINAL.
3781 The optional argument TERMINAL specifies which display to ask about.
3782 TERMINAL should be a terminal object, a frame or a display name (a string).
3783 If omitted or nil, that stands for the selected frame's display. */)
3784 (Lisp_Object terminal)
3786 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3788 return make_number (WidthMMOfScreen (dpyinfo->screen));
3791 DEFUN ("x-display-backing-store", Fx_display_backing_store,
3792 Sx_display_backing_store, 0, 1, 0,
3793 doc: /* Return an indication of whether X display TERMINAL does backing store.
3794 The value may be `always', `when-mapped', or `not-useful'.
3795 The optional argument TERMINAL specifies which display to ask about.
3796 TERMINAL should be a terminal object, a frame or a display name (a string).
3797 If omitted or nil, that stands for the selected frame's display. */)
3798 (Lisp_Object terminal)
3800 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3801 Lisp_Object result;
3803 switch (DoesBackingStore (dpyinfo->screen))
3805 case Always:
3806 result = intern ("always");
3807 break;
3809 case WhenMapped:
3810 result = intern ("when-mapped");
3811 break;
3813 case NotUseful:
3814 result = intern ("not-useful");
3815 break;
3817 default:
3818 error ("Strange value for BackingStore parameter of screen");
3819 result = Qnil;
3822 return result;
3825 DEFUN ("x-display-visual-class", Fx_display_visual_class,
3826 Sx_display_visual_class, 0, 1, 0,
3827 doc: /* Return the visual class of the X display TERMINAL.
3828 The value is one of the symbols `static-gray', `gray-scale',
3829 `static-color', `pseudo-color', `true-color', or `direct-color'.
3831 The optional argument TERMINAL specifies which display to ask about.
3832 TERMINAL should a terminal object, a frame or a display name (a string).
3833 If omitted or nil, that stands for the selected frame's display. */)
3834 (Lisp_Object terminal)
3836 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3837 Lisp_Object result;
3839 switch (dpyinfo->visual->class)
3841 case StaticGray:
3842 result = intern ("static-gray");
3843 break;
3844 case GrayScale:
3845 result = intern ("gray-scale");
3846 break;
3847 case StaticColor:
3848 result = intern ("static-color");
3849 break;
3850 case PseudoColor:
3851 result = intern ("pseudo-color");
3852 break;
3853 case TrueColor:
3854 result = intern ("true-color");
3855 break;
3856 case DirectColor:
3857 result = intern ("direct-color");
3858 break;
3859 default:
3860 error ("Display has an unknown visual class");
3861 result = Qnil;
3864 return result;
3867 DEFUN ("x-display-save-under", Fx_display_save_under,
3868 Sx_display_save_under, 0, 1, 0,
3869 doc: /* Return t if the X display TERMINAL supports the save-under feature.
3870 The optional argument TERMINAL specifies which display to ask about.
3871 TERMINAL should be a terminal object, a frame or a display name (a string).
3872 If omitted or nil, that stands for the selected frame's display. */)
3873 (Lisp_Object terminal)
3875 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3877 if (DoesSaveUnders (dpyinfo->screen) == True)
3878 return Qt;
3879 else
3880 return Qnil;
3884 x_pixel_width (register struct frame *f)
3886 return FRAME_PIXEL_WIDTH (f);
3890 x_pixel_height (register struct frame *f)
3892 return FRAME_PIXEL_HEIGHT (f);
3896 x_char_width (register struct frame *f)
3898 return FRAME_COLUMN_WIDTH (f);
3902 x_char_height (register struct frame *f)
3904 return FRAME_LINE_HEIGHT (f);
3909 /************************************************************************
3910 X Displays
3911 ************************************************************************/
3914 /* Mapping visual names to visuals. */
3916 static struct visual_class
3918 const char *name;
3919 int class;
3921 visual_classes[] =
3923 {"StaticGray", StaticGray},
3924 {"GrayScale", GrayScale},
3925 {"StaticColor", StaticColor},
3926 {"PseudoColor", PseudoColor},
3927 {"TrueColor", TrueColor},
3928 {"DirectColor", DirectColor},
3929 {NULL, 0}
3933 #ifndef HAVE_XSCREENNUMBEROFSCREEN
3935 /* Value is the screen number of screen SCR. This is a substitute for
3936 the X function with the same name when that doesn't exist. */
3939 XScreenNumberOfScreen (scr)
3940 register Screen *scr;
3942 Display *dpy = scr->display;
3943 int i;
3945 for (i = 0; i < dpy->nscreens; ++i)
3946 if (scr == dpy->screens + i)
3947 break;
3949 return i;
3952 #endif /* not HAVE_XSCREENNUMBEROFSCREEN */
3955 /* Select the visual that should be used on display DPYINFO. Set
3956 members of DPYINFO appropriately. Called from x_term_init. */
3958 void
3959 select_visual (struct x_display_info *dpyinfo)
3961 Display *dpy = dpyinfo->display;
3962 Screen *screen = dpyinfo->screen;
3963 Lisp_Object value;
3965 /* See if a visual is specified. */
3966 value = display_x_get_resource (dpyinfo,
3967 build_string ("visualClass"),
3968 build_string ("VisualClass"),
3969 Qnil, Qnil);
3970 if (STRINGP (value))
3972 /* VALUE should be of the form CLASS-DEPTH, where CLASS is one
3973 of `PseudoColor', `TrueColor' etc. and DEPTH is the color
3974 depth, a decimal number. NAME is compared with case ignored. */
3975 char *s = (char *) alloca (SBYTES (value) + 1);
3976 char *dash;
3977 int i, class = -1;
3978 XVisualInfo vinfo;
3980 strcpy (s, SSDATA (value));
3981 dash = strchr (s, '-');
3982 if (dash)
3984 dpyinfo->n_planes = atoi (dash + 1);
3985 *dash = '\0';
3987 else
3988 /* We won't find a matching visual with depth 0, so that
3989 an error will be printed below. */
3990 dpyinfo->n_planes = 0;
3992 /* Determine the visual class. */
3993 for (i = 0; visual_classes[i].name; ++i)
3994 if (xstrcasecmp (s, visual_classes[i].name) == 0)
3996 class = visual_classes[i].class;
3997 break;
4000 /* Look up a matching visual for the specified class. */
4001 if (class == -1
4002 || !XMatchVisualInfo (dpy, XScreenNumberOfScreen (screen),
4003 dpyinfo->n_planes, class, &vinfo))
4004 fatal ("Invalid visual specification `%s'", SDATA (value));
4006 dpyinfo->visual = vinfo.visual;
4008 else
4010 int n_visuals;
4011 XVisualInfo *vinfo, vinfo_template;
4013 dpyinfo->visual = DefaultVisualOfScreen (screen);
4015 vinfo_template.visualid = XVisualIDFromVisual (dpyinfo->visual);
4016 vinfo_template.screen = XScreenNumberOfScreen (screen);
4017 vinfo = XGetVisualInfo (dpy, VisualIDMask | VisualScreenMask,
4018 &vinfo_template, &n_visuals);
4019 if (n_visuals <= 0)
4020 fatal ("Can't get proper X visual info");
4022 dpyinfo->n_planes = vinfo->depth;
4023 XFree ((char *) vinfo);
4028 /* Return the X display structure for the display named NAME.
4029 Open a new connection if necessary. */
4031 static struct x_display_info *
4032 x_display_info_for_name (Lisp_Object name)
4034 Lisp_Object names;
4035 struct x_display_info *dpyinfo;
4037 CHECK_STRING (name);
4039 #if 0
4040 if (! EQ (Vinitial_window_system, intern ("x")))
4041 error ("Not using X Windows"); /* That doesn't stop us anymore. */
4042 #endif
4044 for (dpyinfo = x_display_list, names = x_display_name_list;
4045 dpyinfo;
4046 dpyinfo = dpyinfo->next, names = XCDR (names))
4048 Lisp_Object tem;
4049 tem = Fstring_equal (XCAR (XCAR (names)), name);
4050 if (!NILP (tem))
4051 return dpyinfo;
4054 /* Use this general default value to start with. */
4055 Vx_resource_name = Vinvocation_name;
4057 validate_x_resource_name ();
4059 dpyinfo = x_term_init (name, (char *)0,
4060 SSDATA (Vx_resource_name));
4062 if (dpyinfo == 0)
4063 error ("Cannot connect to X server %s", SDATA (name));
4065 x_in_use = 1;
4066 XSETFASTINT (Vwindow_system_version, 11);
4068 return dpyinfo;
4072 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
4073 1, 3, 0,
4074 doc: /* Open a connection to a display server.
4075 DISPLAY is the name of the display to connect to.
4076 Optional second arg XRM-STRING is a string of resources in xrdb format.
4077 If the optional third arg MUST-SUCCEED is non-nil,
4078 terminate Emacs if we can't open the connection.
4079 \(In the Nextstep version, the last two arguments are currently ignored.) */)
4080 (Lisp_Object display, Lisp_Object xrm_string, Lisp_Object must_succeed)
4082 char *xrm_option;
4083 struct x_display_info *dpyinfo;
4085 CHECK_STRING (display);
4086 if (! NILP (xrm_string))
4087 CHECK_STRING (xrm_string);
4089 #if 0
4090 if (! EQ (Vinitial_window_system, intern ("x")))
4091 error ("Not using X Windows"); /* That doesn't stop us anymore. */
4092 #endif
4094 if (! NILP (xrm_string))
4095 xrm_option = SSDATA (xrm_string);
4096 else
4097 xrm_option = (char *) 0;
4099 validate_x_resource_name ();
4101 /* This is what opens the connection and sets x_current_display.
4102 This also initializes many symbols, such as those used for input. */
4103 dpyinfo = x_term_init (display, xrm_option,
4104 SSDATA (Vx_resource_name));
4106 if (dpyinfo == 0)
4108 if (!NILP (must_succeed))
4109 fatal ("Cannot connect to X server %s.\n\
4110 Check the DISPLAY environment variable or use `-d'.\n\
4111 Also use the `xauth' program to verify that you have the proper\n\
4112 authorization information needed to connect the X server.\n\
4113 An insecure way to solve the problem may be to use `xhost'.\n",
4114 SDATA (display));
4115 else
4116 error ("Cannot connect to X server %s", SDATA (display));
4119 x_in_use = 1;
4121 XSETFASTINT (Vwindow_system_version, 11);
4122 return Qnil;
4125 DEFUN ("x-close-connection", Fx_close_connection,
4126 Sx_close_connection, 1, 1, 0,
4127 doc: /* Close the connection to TERMINAL's X server.
4128 For TERMINAL, specify a terminal object, a frame or a display name (a
4129 string). If TERMINAL is nil, that stands for the selected frame's
4130 terminal. */)
4131 (Lisp_Object terminal)
4133 struct x_display_info *dpyinfo = check_x_display_info (terminal);
4135 if (dpyinfo->reference_count > 0)
4136 error ("Display still has frames on it");
4138 x_delete_terminal (dpyinfo->terminal);
4140 return Qnil;
4143 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
4144 doc: /* Return the list of display names that Emacs has connections to. */)
4145 (void)
4147 Lisp_Object tail, result;
4149 result = Qnil;
4150 for (tail = x_display_name_list; CONSP (tail); tail = XCDR (tail))
4151 result = Fcons (XCAR (XCAR (tail)), result);
4153 return result;
4156 DEFUN ("x-synchronize", Fx_synchronize, Sx_synchronize, 1, 2, 0,
4157 doc: /* If ON is non-nil, report X errors as soon as the erring request is made.
4158 This function only has an effect on X Windows. With MS Windows, it is
4159 defined but does nothing.
4161 If ON is nil, allow buffering of requests.
4162 Turning on synchronization prohibits the Xlib routines from buffering
4163 requests and seriously degrades performance, but makes debugging much
4164 easier.
4165 The optional second argument TERMINAL specifies which display to act on.
4166 TERMINAL should be a terminal object, a frame or a display name (a string).
4167 If TERMINAL is omitted or nil, that stands for the selected frame's display. */)
4168 (Lisp_Object on, Lisp_Object terminal)
4170 struct x_display_info *dpyinfo = check_x_display_info (terminal);
4172 XSynchronize (dpyinfo->display, !EQ (on, Qnil));
4174 return Qnil;
4177 /* Wait for responses to all X commands issued so far for frame F. */
4179 void
4180 x_sync (FRAME_PTR f)
4182 BLOCK_INPUT;
4183 XSync (FRAME_X_DISPLAY (f), False);
4184 UNBLOCK_INPUT;
4188 /***********************************************************************
4189 Window properties
4190 ***********************************************************************/
4192 DEFUN ("x-change-window-property", Fx_change_window_property,
4193 Sx_change_window_property, 2, 6, 0,
4194 doc: /* Change window property PROP to VALUE on the X window of FRAME.
4195 PROP must be a string. VALUE may be a string or a list of conses,
4196 numbers and/or strings. If an element in the list is a string, it is
4197 converted to an atom and the value of the atom is used. If an element
4198 is a cons, it is converted to a 32 bit number where the car is the 16
4199 top bits and the cdr is the lower 16 bits.
4201 FRAME nil or omitted means use the selected frame.
4202 If TYPE is given and non-nil, it is the name of the type of VALUE.
4203 If TYPE is not given or nil, the type is STRING.
4204 FORMAT gives the size in bits of each element if VALUE is a list.
4205 It must be one of 8, 16 or 32.
4206 If VALUE is a string or FORMAT is nil or not given, FORMAT defaults to 8.
4207 If OUTER_P is non-nil, the property is changed for the outer X window of
4208 FRAME. Default is to change on the edit X window. */)
4209 (Lisp_Object prop, Lisp_Object value, Lisp_Object frame, Lisp_Object type, Lisp_Object format, Lisp_Object outer_p)
4211 struct frame *f = check_x_frame (frame);
4212 Atom prop_atom;
4213 Atom target_type = XA_STRING;
4214 int element_format = 8;
4215 unsigned char *data;
4216 int nelements;
4217 Window w;
4219 CHECK_STRING (prop);
4221 if (! NILP (format))
4223 CHECK_NUMBER (format);
4224 element_format = XFASTINT (format);
4226 if (element_format != 8 && element_format != 16
4227 && element_format != 32)
4228 error ("FORMAT must be one of 8, 16 or 32");
4231 if (CONSP (value))
4233 ptrdiff_t elsize;
4235 nelements = x_check_property_data (value);
4236 if (nelements == -1)
4237 error ("Bad data in VALUE, must be number, string or cons");
4239 /* The man page for XChangeProperty:
4240 "If the specified format is 32, the property data must be a
4241 long array."
4242 This applies even if long is more than 32 bits. The X library
4243 converts to 32 bits before sending to the X server. */
4244 elsize = element_format == 32 ? sizeof (long) : element_format >> 3;
4245 data = xnmalloc (nelements, elsize);
4247 x_fill_property_data (FRAME_X_DISPLAY (f), value, data, element_format);
4249 else
4251 CHECK_STRING (value);
4252 data = SDATA (value);
4253 if (INT_MAX < SBYTES (value))
4254 error ("VALUE too long");
4255 nelements = SBYTES (value);
4258 BLOCK_INPUT;
4259 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SSDATA (prop), False);
4260 if (! NILP (type))
4262 CHECK_STRING (type);
4263 target_type = XInternAtom (FRAME_X_DISPLAY (f), SSDATA (type), False);
4266 if (! NILP (outer_p)) w = FRAME_OUTER_WINDOW (f);
4267 else w = FRAME_X_WINDOW (f);
4269 XChangeProperty (FRAME_X_DISPLAY (f), w,
4270 prop_atom, target_type, element_format, PropModeReplace,
4271 data, nelements);
4273 if (CONSP (value)) xfree (data);
4275 /* Make sure the property is set when we return. */
4276 XFlush (FRAME_X_DISPLAY (f));
4277 UNBLOCK_INPUT;
4279 return value;
4283 DEFUN ("x-delete-window-property", Fx_delete_window_property,
4284 Sx_delete_window_property, 1, 2, 0,
4285 doc: /* Remove window property PROP from X window of FRAME.
4286 FRAME nil or omitted means use the selected frame. Value is PROP. */)
4287 (Lisp_Object prop, Lisp_Object frame)
4289 struct frame *f = check_x_frame (frame);
4290 Atom prop_atom;
4292 CHECK_STRING (prop);
4293 BLOCK_INPUT;
4294 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SSDATA (prop), False);
4295 XDeleteProperty (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), prop_atom);
4297 /* Make sure the property is removed when we return. */
4298 XFlush (FRAME_X_DISPLAY (f));
4299 UNBLOCK_INPUT;
4301 return prop;
4305 DEFUN ("x-window-property", Fx_window_property, Sx_window_property,
4306 1, 6, 0,
4307 doc: /* Value is the value of window property PROP on FRAME.
4308 If FRAME is nil or omitted, use the selected frame.
4310 On MS Windows, this function only accepts the PROP and FRAME arguments.
4312 On X Windows, the following optional arguments are also accepted:
4313 If TYPE is nil or omitted, get the property as a string.
4314 Otherwise TYPE is the name of the atom that denotes the type expected.
4315 If SOURCE is non-nil, get the property on that window instead of from
4316 FRAME. The number 0 denotes the root window.
4317 If DELETE_P is non-nil, delete the property after retrieving it.
4318 If VECTOR_RET_P is non-nil, don't return a string but a vector of values.
4320 Value is nil if FRAME hasn't a property with name PROP or if PROP has
4321 no value of TYPE (always string in the MS Windows case). */)
4322 (Lisp_Object prop, Lisp_Object frame, Lisp_Object type, Lisp_Object source, Lisp_Object delete_p, Lisp_Object vector_ret_p)
4324 struct frame *f = check_x_frame (frame);
4325 Atom prop_atom;
4326 int rc;
4327 Lisp_Object prop_value = Qnil;
4328 unsigned char *tmp_data = NULL;
4329 Atom actual_type;
4330 Atom target_type = XA_STRING;
4331 int actual_format;
4332 unsigned long actual_size, bytes_remaining;
4333 Window target_window = FRAME_X_WINDOW (f);
4334 struct gcpro gcpro1;
4336 GCPRO1 (prop_value);
4337 CHECK_STRING (prop);
4339 if (! NILP (source))
4341 CONS_TO_INTEGER (source, Window, target_window);
4342 if (! target_window)
4343 target_window = FRAME_X_DISPLAY_INFO (f)->root_window;
4346 BLOCK_INPUT;
4347 if (STRINGP (type))
4349 if (strcmp ("AnyPropertyType", SSDATA (type)) == 0)
4350 target_type = AnyPropertyType;
4351 else
4352 target_type = XInternAtom (FRAME_X_DISPLAY (f), SSDATA (type), False);
4355 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SSDATA (prop), False);
4356 rc = XGetWindowProperty (FRAME_X_DISPLAY (f), target_window,
4357 prop_atom, 0, 0, False, target_type,
4358 &actual_type, &actual_format, &actual_size,
4359 &bytes_remaining, &tmp_data);
4360 if (rc == Success)
4362 int size = bytes_remaining;
4364 XFree (tmp_data);
4365 tmp_data = NULL;
4367 rc = XGetWindowProperty (FRAME_X_DISPLAY (f), target_window,
4368 prop_atom, 0, bytes_remaining,
4369 ! NILP (delete_p), target_type,
4370 &actual_type, &actual_format,
4371 &actual_size, &bytes_remaining,
4372 &tmp_data);
4373 if (rc == Success && tmp_data)
4375 /* The man page for XGetWindowProperty says:
4376 "If the returned format is 32, the returned data is represented
4377 as a long array and should be cast to that type to obtain the
4378 elements."
4379 This applies even if long is more than 32 bits, the X library
4380 converts from 32 bit elements received from the X server to long
4381 and passes the long array to us. Thus, for that case memcpy can not
4382 be used. We convert to a 32 bit type here, because so much code
4383 assume on that.
4385 The bytes and offsets passed to XGetWindowProperty refers to the
4386 property and those are indeed in 32 bit quantities if format is
4387 32. */
4389 if (32 < BITS_PER_LONG && actual_format == 32)
4391 unsigned long i;
4392 int *idata = (int *) tmp_data;
4393 long *ldata = (long *) tmp_data;
4395 for (i = 0; i < actual_size; ++i)
4396 idata[i] = (int) ldata[i];
4399 if (NILP (vector_ret_p))
4400 prop_value = make_string ((char *) tmp_data, size);
4401 else
4402 prop_value = x_property_data_to_lisp (f,
4403 tmp_data,
4404 actual_type,
4405 actual_format,
4406 actual_size);
4409 if (tmp_data) XFree (tmp_data);
4412 UNBLOCK_INPUT;
4413 UNGCPRO;
4414 return prop_value;
4419 /***********************************************************************
4420 Busy cursor
4421 ***********************************************************************/
4423 /* Timer function of hourglass_atimer. TIMER is equal to
4424 hourglass_atimer.
4426 Display an hourglass pointer on all frames by mapping the frames'
4427 hourglass_window. Set the hourglass_p flag in the frames'
4428 output_data.x structure to indicate that an hourglass cursor is
4429 shown on the frames. */
4431 void
4432 show_hourglass (struct atimer *timer)
4434 /* The timer implementation will cancel this timer automatically
4435 after this function has run. Set hourglass_atimer to null
4436 so that we know the timer doesn't have to be canceled. */
4437 hourglass_atimer = NULL;
4439 if (!hourglass_shown_p)
4441 Lisp_Object rest, frame;
4443 BLOCK_INPUT;
4445 FOR_EACH_FRAME (rest, frame)
4447 struct frame *f = XFRAME (frame);
4449 if (FRAME_LIVE_P (f) && FRAME_X_P (f) && FRAME_X_DISPLAY (f))
4451 Display *dpy = FRAME_X_DISPLAY (f);
4453 #ifdef USE_X_TOOLKIT
4454 if (f->output_data.x->widget)
4455 #else
4456 if (FRAME_OUTER_WINDOW (f))
4457 #endif
4459 f->output_data.x->hourglass_p = 1;
4461 if (!f->output_data.x->hourglass_window)
4463 unsigned long mask = CWCursor;
4464 XSetWindowAttributes attrs;
4465 #ifdef USE_GTK
4466 Window parent = FRAME_X_WINDOW (f);
4467 #else
4468 Window parent = FRAME_OUTER_WINDOW (f);
4469 #endif
4470 attrs.cursor = f->output_data.x->hourglass_cursor;
4472 f->output_data.x->hourglass_window
4473 = XCreateWindow (dpy, parent,
4474 0, 0, 32000, 32000, 0, 0,
4475 InputOnly,
4476 CopyFromParent,
4477 mask, &attrs);
4480 XMapRaised (dpy, f->output_data.x->hourglass_window);
4481 XFlush (dpy);
4486 hourglass_shown_p = 1;
4487 UNBLOCK_INPUT;
4492 /* Hide the hourglass pointer on all frames, if it is currently
4493 shown. */
4495 void
4496 hide_hourglass (void)
4498 if (hourglass_shown_p)
4500 Lisp_Object rest, frame;
4502 BLOCK_INPUT;
4503 FOR_EACH_FRAME (rest, frame)
4505 struct frame *f = XFRAME (frame);
4507 if (FRAME_X_P (f)
4508 /* Watch out for newly created frames. */
4509 && f->output_data.x->hourglass_window)
4511 XUnmapWindow (FRAME_X_DISPLAY (f),
4512 f->output_data.x->hourglass_window);
4513 /* Sync here because XTread_socket looks at the
4514 hourglass_p flag that is reset to zero below. */
4515 XSync (FRAME_X_DISPLAY (f), False);
4516 f->output_data.x->hourglass_p = 0;
4520 hourglass_shown_p = 0;
4521 UNBLOCK_INPUT;
4527 /***********************************************************************
4528 Tool tips
4529 ***********************************************************************/
4531 static Lisp_Object x_create_tip_frame (struct x_display_info *,
4532 Lisp_Object, Lisp_Object);
4533 static void compute_tip_xy (struct frame *, Lisp_Object, Lisp_Object,
4534 Lisp_Object, int, int, int *, int *);
4536 /* The frame of a currently visible tooltip. */
4538 Lisp_Object tip_frame;
4540 /* If non-nil, a timer started that hides the last tooltip when it
4541 fires. */
4543 static Lisp_Object tip_timer;
4544 Window tip_window;
4546 /* If non-nil, a vector of 3 elements containing the last args
4547 with which x-show-tip was called. See there. */
4549 static Lisp_Object last_show_tip_args;
4552 static Lisp_Object
4553 unwind_create_tip_frame (Lisp_Object frame)
4555 Lisp_Object deleted;
4557 deleted = unwind_create_frame (frame);
4558 if (EQ (deleted, Qt))
4560 tip_window = None;
4561 tip_frame = Qnil;
4564 return deleted;
4568 /* Create a frame for a tooltip on the display described by DPYINFO.
4569 PARMS is a list of frame parameters. TEXT is the string to
4570 display in the tip frame. Value is the frame.
4572 Note that functions called here, esp. x_default_parameter can
4573 signal errors, for instance when a specified color name is
4574 undefined. We have to make sure that we're in a consistent state
4575 when this happens. */
4577 static Lisp_Object
4578 x_create_tip_frame (struct x_display_info *dpyinfo,
4579 Lisp_Object parms,
4580 Lisp_Object text)
4582 struct frame *f;
4583 Lisp_Object frame;
4584 Lisp_Object name;
4585 int width, height;
4586 int count = SPECPDL_INDEX ();
4587 struct gcpro gcpro1, gcpro2, gcpro3;
4588 int face_change_count_before = face_change_count;
4589 Lisp_Object buffer;
4590 struct buffer *old_buffer;
4592 check_x ();
4594 if (!dpyinfo->terminal->name)
4595 error ("Terminal is not live, can't create new frames on it");
4597 parms = Fcopy_alist (parms);
4599 /* Get the name of the frame to use for resource lookup. */
4600 name = x_get_arg (dpyinfo, parms, Qname, "name", "Name", RES_TYPE_STRING);
4601 if (!STRINGP (name)
4602 && !EQ (name, Qunbound)
4603 && !NILP (name))
4604 error ("Invalid frame name--not a string or nil");
4606 frame = Qnil;
4607 GCPRO3 (parms, name, frame);
4608 f = make_frame (1);
4609 XSETFRAME (frame, f);
4611 buffer = Fget_buffer_create (build_string (" *tip*"));
4612 Fset_window_buffer (FRAME_ROOT_WINDOW (f), buffer, Qnil);
4613 old_buffer = current_buffer;
4614 set_buffer_internal_1 (XBUFFER (buffer));
4615 BVAR (current_buffer, truncate_lines) = Qnil;
4616 specbind (Qinhibit_read_only, Qt);
4617 specbind (Qinhibit_modification_hooks, Qt);
4618 Ferase_buffer ();
4619 Finsert (1, &text);
4620 set_buffer_internal_1 (old_buffer);
4622 FRAME_CAN_HAVE_SCROLL_BARS (f) = 0;
4623 record_unwind_protect (unwind_create_tip_frame, frame);
4625 f->terminal = dpyinfo->terminal;
4627 /* By setting the output method, we're essentially saying that
4628 the frame is live, as per FRAME_LIVE_P. If we get a signal
4629 from this point on, x_destroy_window might screw up reference
4630 counts etc. */
4631 f->output_method = output_x_window;
4632 f->output_data.x = (struct x_output *) xmalloc (sizeof (struct x_output));
4633 memset (f->output_data.x, 0, sizeof (struct x_output));
4634 f->output_data.x->icon_bitmap = -1;
4635 FRAME_FONTSET (f) = -1;
4636 f->output_data.x->scroll_bar_foreground_pixel = -1;
4637 f->output_data.x->scroll_bar_background_pixel = -1;
4638 #ifdef USE_TOOLKIT_SCROLL_BARS
4639 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
4640 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
4641 #endif /* USE_TOOLKIT_SCROLL_BARS */
4642 f->icon_name = Qnil;
4643 FRAME_X_DISPLAY_INFO (f) = dpyinfo;
4644 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
4645 f->output_data.x->explicit_parent = 0;
4647 /* These colors will be set anyway later, but it's important
4648 to get the color reference counts right, so initialize them! */
4650 Lisp_Object black;
4651 struct gcpro gcpro1;
4653 /* Function x_decode_color can signal an error. Make
4654 sure to initialize color slots so that we won't try
4655 to free colors we haven't allocated. */
4656 FRAME_FOREGROUND_PIXEL (f) = -1;
4657 FRAME_BACKGROUND_PIXEL (f) = -1;
4658 f->output_data.x->cursor_pixel = -1;
4659 f->output_data.x->cursor_foreground_pixel = -1;
4660 f->output_data.x->border_pixel = -1;
4661 f->output_data.x->mouse_pixel = -1;
4663 black = build_string ("black");
4664 GCPRO1 (black);
4665 FRAME_FOREGROUND_PIXEL (f)
4666 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4667 FRAME_BACKGROUND_PIXEL (f)
4668 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4669 f->output_data.x->cursor_pixel
4670 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4671 f->output_data.x->cursor_foreground_pixel
4672 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4673 f->output_data.x->border_pixel
4674 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4675 f->output_data.x->mouse_pixel
4676 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4677 UNGCPRO;
4680 /* Set the name; the functions to which we pass f expect the name to
4681 be set. */
4682 if (EQ (name, Qunbound) || NILP (name))
4684 f->name = build_string (dpyinfo->x_id_name);
4685 f->explicit_name = 0;
4687 else
4689 f->name = name;
4690 f->explicit_name = 1;
4691 /* use the frame's title when getting resources for this frame. */
4692 specbind (Qx_resource_name, name);
4695 f->resx = dpyinfo->resx;
4696 f->resy = dpyinfo->resy;
4698 register_font_driver (&xfont_driver, f);
4699 #ifdef HAVE_FREETYPE
4700 #ifdef HAVE_XFT
4701 register_font_driver (&xftfont_driver, f);
4702 #else /* not HAVE_XFT */
4703 register_font_driver (&ftxfont_driver, f);
4704 #endif /* not HAVE_XFT */
4705 #endif /* HAVE_FREETYPE */
4707 x_default_parameter (f, parms, Qfont_backend, Qnil,
4708 "fontBackend", "FontBackend", RES_TYPE_STRING);
4710 /* Extract the window parameters from the supplied values that are
4711 needed to determine window geometry. */
4712 x_default_font_parameter (f, parms);
4714 x_default_parameter (f, parms, Qborder_width, make_number (0),
4715 "borderWidth", "BorderWidth", RES_TYPE_NUMBER);
4717 /* This defaults to 2 in order to match xterm. We recognize either
4718 internalBorderWidth or internalBorder (which is what xterm calls
4719 it). */
4720 if (NILP (Fassq (Qinternal_border_width, parms)))
4722 Lisp_Object value;
4724 value = x_get_arg (dpyinfo, parms, Qinternal_border_width,
4725 "internalBorder", "internalBorder", RES_TYPE_NUMBER);
4726 if (! EQ (value, Qunbound))
4727 parms = Fcons (Fcons (Qinternal_border_width, value),
4728 parms);
4731 x_default_parameter (f, parms, Qinternal_border_width, make_number (1),
4732 "internalBorderWidth", "internalBorderWidth",
4733 RES_TYPE_NUMBER);
4735 /* Also do the stuff which must be set before the window exists. */
4736 x_default_parameter (f, parms, Qforeground_color, build_string ("black"),
4737 "foreground", "Foreground", RES_TYPE_STRING);
4738 x_default_parameter (f, parms, Qbackground_color, build_string ("white"),
4739 "background", "Background", RES_TYPE_STRING);
4740 x_default_parameter (f, parms, Qmouse_color, build_string ("black"),
4741 "pointerColor", "Foreground", RES_TYPE_STRING);
4742 x_default_parameter (f, parms, Qcursor_color, build_string ("black"),
4743 "cursorColor", "Foreground", RES_TYPE_STRING);
4744 x_default_parameter (f, parms, Qborder_color, build_string ("black"),
4745 "borderColor", "BorderColor", RES_TYPE_STRING);
4747 #if GLYPH_DEBUG
4748 image_cache_refcount =
4749 FRAME_IMAGE_CACHE (f) ? FRAME_IMAGE_CACHE (f)->refcount : 0;
4750 dpyinfo_refcount = dpyinfo->reference_count;
4751 #endif /* GLYPH_DEBUG */
4753 /* Init faces before x_default_parameter is called for scroll-bar
4754 parameters because that function calls x_set_scroll_bar_width,
4755 which calls change_frame_size, which calls Fset_window_buffer,
4756 which runs hooks, which call Fvertical_motion. At the end, we
4757 end up in init_iterator with a null face cache, which should not
4758 happen. */
4759 init_frame_faces (f);
4761 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
4763 x_figure_window_size (f, parms, 0);
4766 XSetWindowAttributes attrs;
4767 unsigned long mask;
4768 Atom type = FRAME_X_DISPLAY_INFO (f)->Xatom_net_window_type_tooltip;
4770 BLOCK_INPUT;
4771 mask = CWBackPixel | CWOverrideRedirect | CWEventMask;
4772 if (DoesSaveUnders (dpyinfo->screen))
4773 mask |= CWSaveUnder;
4775 /* Window managers look at the override-redirect flag to determine
4776 whether or net to give windows a decoration (Xlib spec, chapter
4777 3.2.8). */
4778 attrs.override_redirect = True;
4779 attrs.save_under = True;
4780 attrs.background_pixel = FRAME_BACKGROUND_PIXEL (f);
4781 /* Arrange for getting MapNotify and UnmapNotify events. */
4782 attrs.event_mask = StructureNotifyMask;
4783 tip_window
4784 = FRAME_X_WINDOW (f)
4785 = XCreateWindow (FRAME_X_DISPLAY (f),
4786 FRAME_X_DISPLAY_INFO (f)->root_window,
4787 /* x, y, width, height */
4788 0, 0, 1, 1,
4789 /* Border. */
4790 f->border_width,
4791 CopyFromParent, InputOutput, CopyFromParent,
4792 mask, &attrs);
4793 XChangeProperty (FRAME_X_DISPLAY (f), tip_window,
4794 FRAME_X_DISPLAY_INFO (f)->Xatom_net_window_type,
4795 XA_ATOM, 32, PropModeReplace,
4796 (unsigned char *)&type, 1);
4797 UNBLOCK_INPUT;
4800 x_make_gc (f);
4802 x_default_parameter (f, parms, Qauto_raise, Qnil,
4803 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
4804 x_default_parameter (f, parms, Qauto_lower, Qnil,
4805 "autoLower", "AutoRaiseLower", RES_TYPE_BOOLEAN);
4806 x_default_parameter (f, parms, Qcursor_type, Qbox,
4807 "cursorType", "CursorType", RES_TYPE_SYMBOL);
4809 /* Dimensions, especially FRAME_LINES (f), must be done via change_frame_size.
4810 Change will not be effected unless different from the current
4811 FRAME_LINES (f). */
4812 width = FRAME_COLS (f);
4813 height = FRAME_LINES (f);
4814 SET_FRAME_COLS (f, 0);
4815 FRAME_LINES (f) = 0;
4816 change_frame_size (f, height, width, 1, 0, 0);
4818 /* Add `tooltip' frame parameter's default value. */
4819 if (NILP (Fframe_parameter (frame, Qtooltip)))
4820 Fmodify_frame_parameters (frame, Fcons (Fcons (Qtooltip, Qt), Qnil));
4822 /* FIXME - can this be done in a similar way to normal frames?
4823 http://lists.gnu.org/archive/html/emacs-devel/2007-10/msg00641.html */
4825 /* Set the `display-type' frame parameter before setting up faces. */
4827 Lisp_Object disptype;
4829 if (FRAME_X_DISPLAY_INFO (f)->n_planes == 1)
4830 disptype = intern ("mono");
4831 else if (FRAME_X_DISPLAY_INFO (f)->visual->class == GrayScale
4832 || FRAME_X_DISPLAY_INFO (f)->visual->class == StaticGray)
4833 disptype = intern ("grayscale");
4834 else
4835 disptype = intern ("color");
4837 if (NILP (Fframe_parameter (frame, Qdisplay_type)))
4838 Fmodify_frame_parameters (frame, Fcons (Fcons (Qdisplay_type, disptype),
4839 Qnil));
4842 /* Set up faces after all frame parameters are known. This call
4843 also merges in face attributes specified for new frames.
4845 Frame parameters may be changed if .Xdefaults contains
4846 specifications for the default font. For example, if there is an
4847 `Emacs.default.attributeBackground: pink', the `background-color'
4848 attribute of the frame get's set, which let's the internal border
4849 of the tooltip frame appear in pink. Prevent this. */
4851 Lisp_Object bg = Fframe_parameter (frame, Qbackground_color);
4853 /* Set tip_frame here, so that */
4854 tip_frame = frame;
4855 call2 (Qface_set_after_frame_default, frame, Qnil);
4857 if (!EQ (bg, Fframe_parameter (frame, Qbackground_color)))
4858 Fmodify_frame_parameters (frame, Fcons (Fcons (Qbackground_color, bg),
4859 Qnil));
4862 f->no_split = 1;
4864 UNGCPRO;
4866 /* Now that the frame will be official, it counts as a reference to
4867 its display and terminal. */
4868 FRAME_X_DISPLAY_INFO (f)->reference_count++;
4869 f->terminal->reference_count++;
4871 /* It is now ok to make the frame official even if we get an error
4872 below. And the frame needs to be on Vframe_list or making it
4873 visible won't work. */
4874 Vframe_list = Fcons (frame, Vframe_list);
4877 /* Setting attributes of faces of the tooltip frame from resources
4878 and similar will increment face_change_count, which leads to the
4879 clearing of all current matrices. Since this isn't necessary
4880 here, avoid it by resetting face_change_count to the value it
4881 had before we created the tip frame. */
4882 face_change_count = face_change_count_before;
4884 /* Discard the unwind_protect. */
4885 return unbind_to (count, frame);
4889 /* Compute where to display tip frame F. PARMS is the list of frame
4890 parameters for F. DX and DY are specified offsets from the current
4891 location of the mouse. WIDTH and HEIGHT are the width and height
4892 of the tooltip. Return coordinates relative to the root window of
4893 the display in *ROOT_X, and *ROOT_Y. */
4895 static void
4896 compute_tip_xy (struct frame *f, Lisp_Object parms, Lisp_Object dx, Lisp_Object dy, int width, int height, int *root_x, int *root_y)
4898 Lisp_Object left, top;
4899 int win_x, win_y;
4900 Window root, child;
4901 unsigned pmask;
4903 /* User-specified position? */
4904 left = Fcdr (Fassq (Qleft, parms));
4905 top = Fcdr (Fassq (Qtop, parms));
4907 /* Move the tooltip window where the mouse pointer is. Resize and
4908 show it. */
4909 if (!INTEGERP (left) || !INTEGERP (top))
4911 BLOCK_INPUT;
4912 XQueryPointer (FRAME_X_DISPLAY (f), FRAME_X_DISPLAY_INFO (f)->root_window,
4913 &root, &child, root_x, root_y, &win_x, &win_y, &pmask);
4914 UNBLOCK_INPUT;
4917 if (INTEGERP (top))
4918 *root_y = XINT (top);
4919 else if (*root_y + XINT (dy) <= 0)
4920 *root_y = 0; /* Can happen for negative dy */
4921 else if (*root_y + XINT (dy) + height
4922 <= x_display_pixel_height (FRAME_X_DISPLAY_INFO (f)))
4923 /* It fits below the pointer */
4924 *root_y += XINT (dy);
4925 else if (height + XINT (dy) <= *root_y)
4926 /* It fits above the pointer. */
4927 *root_y -= height + XINT (dy);
4928 else
4929 /* Put it on the top. */
4930 *root_y = 0;
4932 if (INTEGERP (left))
4933 *root_x = XINT (left);
4934 else if (*root_x + XINT (dx) <= 0)
4935 *root_x = 0; /* Can happen for negative dx */
4936 else if (*root_x + XINT (dx) + width
4937 <= x_display_pixel_width (FRAME_X_DISPLAY_INFO (f)))
4938 /* It fits to the right of the pointer. */
4939 *root_x += XINT (dx);
4940 else if (width + XINT (dx) <= *root_x)
4941 /* It fits to the left of the pointer. */
4942 *root_x -= width + XINT (dx);
4943 else
4944 /* Put it left-justified on the screen--it ought to fit that way. */
4945 *root_x = 0;
4949 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
4950 doc: /* Show STRING in a "tooltip" window on frame FRAME.
4951 A tooltip window is a small X window displaying a string.
4953 This is an internal function; Lisp code should call `tooltip-show'.
4955 FRAME nil or omitted means use the selected frame.
4957 PARMS is an optional list of frame parameters which can be used to
4958 change the tooltip's appearance.
4960 Automatically hide the tooltip after TIMEOUT seconds. TIMEOUT nil
4961 means use the default timeout of 5 seconds.
4963 If the list of frame parameters PARMS contains a `left' parameters,
4964 the tooltip is displayed at that x-position. Otherwise it is
4965 displayed at the mouse position, with offset DX added (default is 5 if
4966 DX isn't specified). Likewise for the y-position; if a `top' frame
4967 parameter is specified, it determines the y-position of the tooltip
4968 window, otherwise it is displayed at the mouse position, with offset
4969 DY added (default is -10).
4971 A tooltip's maximum size is specified by `x-max-tooltip-size'.
4972 Text larger than the specified size is clipped. */)
4973 (Lisp_Object string, Lisp_Object frame, Lisp_Object parms, Lisp_Object timeout, Lisp_Object dx, Lisp_Object dy)
4975 struct frame *f;
4976 struct window *w;
4977 int root_x, root_y;
4978 struct buffer *old_buffer;
4979 struct text_pos pos;
4980 int i, width, height, seen_reversed_p;
4981 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
4982 int old_windows_or_buffers_changed = windows_or_buffers_changed;
4983 int count = SPECPDL_INDEX ();
4985 specbind (Qinhibit_redisplay, Qt);
4987 GCPRO4 (string, parms, frame, timeout);
4989 CHECK_STRING (string);
4990 if (SCHARS (string) == 0)
4991 string = make_unibyte_string (" ", 1);
4993 f = check_x_frame (frame);
4994 if (NILP (timeout))
4995 timeout = make_number (5);
4996 else
4997 CHECK_NATNUM (timeout);
4999 if (NILP (dx))
5000 dx = make_number (5);
5001 else
5002 CHECK_NUMBER (dx);
5004 if (NILP (dy))
5005 dy = make_number (-10);
5006 else
5007 CHECK_NUMBER (dy);
5009 #ifdef USE_GTK
5010 if (x_gtk_use_system_tooltips)
5012 int ok;
5014 /* Hide a previous tip, if any. */
5015 Fx_hide_tip ();
5017 BLOCK_INPUT;
5018 if ((ok = xg_prepare_tooltip (f, string, &width, &height)) != 0)
5020 compute_tip_xy (f, parms, dx, dy, width, height, &root_x, &root_y);
5021 xg_show_tooltip (f, root_x, root_y);
5022 /* This is used in Fx_hide_tip. */
5023 XSETFRAME (tip_frame, f);
5025 UNBLOCK_INPUT;
5026 if (ok) goto start_timer;
5028 #endif /* USE_GTK */
5030 if (NILP (last_show_tip_args))
5031 last_show_tip_args = Fmake_vector (make_number (3), Qnil);
5033 if (!NILP (tip_frame))
5035 Lisp_Object last_string = AREF (last_show_tip_args, 0);
5036 Lisp_Object last_frame = AREF (last_show_tip_args, 1);
5037 Lisp_Object last_parms = AREF (last_show_tip_args, 2);
5039 if (EQ (frame, last_frame)
5040 && !NILP (Fequal (last_string, string))
5041 && !NILP (Fequal (last_parms, parms)))
5043 struct frame *tip_f = XFRAME (tip_frame);
5045 /* Only DX and DY have changed. */
5046 if (!NILP (tip_timer))
5048 Lisp_Object timer = tip_timer;
5049 tip_timer = Qnil;
5050 call1 (Qcancel_timer, timer);
5053 BLOCK_INPUT;
5054 compute_tip_xy (tip_f, parms, dx, dy, FRAME_PIXEL_WIDTH (tip_f),
5055 FRAME_PIXEL_HEIGHT (tip_f), &root_x, &root_y);
5056 XMoveWindow (FRAME_X_DISPLAY (tip_f), FRAME_X_WINDOW (tip_f),
5057 root_x, root_y);
5058 UNBLOCK_INPUT;
5059 goto start_timer;
5063 /* Hide a previous tip, if any. */
5064 Fx_hide_tip ();
5066 ASET (last_show_tip_args, 0, string);
5067 ASET (last_show_tip_args, 1, frame);
5068 ASET (last_show_tip_args, 2, parms);
5070 /* Add default values to frame parameters. */
5071 if (NILP (Fassq (Qname, parms)))
5072 parms = Fcons (Fcons (Qname, build_string ("tooltip")), parms);
5073 if (NILP (Fassq (Qinternal_border_width, parms)))
5074 parms = Fcons (Fcons (Qinternal_border_width, make_number (3)), parms);
5075 if (NILP (Fassq (Qborder_width, parms)))
5076 parms = Fcons (Fcons (Qborder_width, make_number (1)), parms);
5077 if (NILP (Fassq (Qborder_color, parms)))
5078 parms = Fcons (Fcons (Qborder_color, build_string ("lightyellow")), parms);
5079 if (NILP (Fassq (Qbackground_color, parms)))
5080 parms = Fcons (Fcons (Qbackground_color, build_string ("lightyellow")),
5081 parms);
5083 /* Create a frame for the tooltip, and record it in the global
5084 variable tip_frame. */
5085 frame = x_create_tip_frame (FRAME_X_DISPLAY_INFO (f), parms, string);
5086 f = XFRAME (frame);
5088 /* Set up the frame's root window. */
5089 w = XWINDOW (FRAME_ROOT_WINDOW (f));
5090 w->left_col = w->top_line = make_number (0);
5092 if (CONSP (Vx_max_tooltip_size)
5093 && INTEGERP (XCAR (Vx_max_tooltip_size))
5094 && XINT (XCAR (Vx_max_tooltip_size)) > 0
5095 && INTEGERP (XCDR (Vx_max_tooltip_size))
5096 && XINT (XCDR (Vx_max_tooltip_size)) > 0)
5098 w->total_cols = XCAR (Vx_max_tooltip_size);
5099 w->total_lines = XCDR (Vx_max_tooltip_size);
5101 else
5103 w->total_cols = make_number (80);
5104 w->total_lines = make_number (40);
5107 FRAME_TOTAL_COLS (f) = XINT (w->total_cols);
5108 adjust_glyphs (f);
5109 w->pseudo_window_p = 1;
5111 /* Display the tooltip text in a temporary buffer. */
5112 old_buffer = current_buffer;
5113 set_buffer_internal_1 (XBUFFER (XWINDOW (FRAME_ROOT_WINDOW (f))->buffer));
5114 BVAR (current_buffer, truncate_lines) = Qnil;
5115 clear_glyph_matrix (w->desired_matrix);
5116 clear_glyph_matrix (w->current_matrix);
5117 SET_TEXT_POS (pos, BEGV, BEGV_BYTE);
5118 try_window (FRAME_ROOT_WINDOW (f), pos, TRY_WINDOW_IGNORE_FONTS_CHANGE);
5120 /* Compute width and height of the tooltip. */
5121 width = height = seen_reversed_p = 0;
5122 for (i = 0; i < w->desired_matrix->nrows; ++i)
5124 struct glyph_row *row = &w->desired_matrix->rows[i];
5125 struct glyph *last;
5126 int row_width;
5128 /* Stop at the first empty row at the end. */
5129 if (!row->enabled_p || !row->displays_text_p)
5130 break;
5132 /* Let the row go over the full width of the frame. */
5133 row->full_width_p = 1;
5135 row_width = row->pixel_width;
5136 if (row->used[TEXT_AREA])
5138 /* There's a glyph at the end of rows that is used to place
5139 the cursor there. Don't include the width of this glyph. */
5140 if (!row->reversed_p)
5142 last = &row->glyphs[TEXT_AREA][row->used[TEXT_AREA] - 1];
5143 if (INTEGERP (last->object))
5144 row_width -= last->pixel_width;
5146 else
5148 /* There could be a stretch glyph at the beginning of R2L
5149 rows that is produced by extend_face_to_end_of_line.
5150 Don't count that glyph. */
5151 struct glyph *g = row->glyphs[TEXT_AREA];
5153 if (g->type == STRETCH_GLYPH && INTEGERP (g->object))
5155 row_width -= g->pixel_width;
5156 seen_reversed_p = 1;
5161 height += row->height;
5162 width = max (width, row_width);
5165 /* If we've seen partial-length R2L rows, we need to re-adjust the
5166 tool-tip frame width and redisplay it again, to avoid over-wide
5167 tips due to the stretch glyph that extends R2L lines to full
5168 width of the frame. */
5169 if (seen_reversed_p)
5171 /* w->total_cols and FRAME_TOTAL_COLS want the width in columns,
5172 not in pixels. */
5173 width /= WINDOW_FRAME_COLUMN_WIDTH (w);
5174 w->total_cols = make_number (width);
5175 FRAME_TOTAL_COLS (f) = width;
5176 adjust_glyphs (f);
5177 clear_glyph_matrix (w->desired_matrix);
5178 clear_glyph_matrix (w->current_matrix);
5179 try_window (FRAME_ROOT_WINDOW (f), pos, 0);
5180 width = height = 0;
5181 /* Recompute width and height of the tooltip. */
5182 for (i = 0; i < w->desired_matrix->nrows; ++i)
5184 struct glyph_row *row = &w->desired_matrix->rows[i];
5185 struct glyph *last;
5186 int row_width;
5188 if (!row->enabled_p || !row->displays_text_p)
5189 break;
5190 row->full_width_p = 1;
5191 row_width = row->pixel_width;
5192 if (row->used[TEXT_AREA] && !row->reversed_p)
5194 last = &row->glyphs[TEXT_AREA][row->used[TEXT_AREA] - 1];
5195 if (INTEGERP (last->object))
5196 row_width -= last->pixel_width;
5199 height += row->height;
5200 width = max (width, row_width);
5204 /* Add the frame's internal border to the width and height the X
5205 window should have. */
5206 height += 2 * FRAME_INTERNAL_BORDER_WIDTH (f);
5207 width += 2 * FRAME_INTERNAL_BORDER_WIDTH (f);
5209 /* Move the tooltip window where the mouse pointer is. Resize and
5210 show it. */
5211 compute_tip_xy (f, parms, dx, dy, width, height, &root_x, &root_y);
5213 BLOCK_INPUT;
5214 XMoveResizeWindow (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
5215 root_x, root_y, width, height);
5216 XMapRaised (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f));
5217 UNBLOCK_INPUT;
5219 /* Draw into the window. */
5220 w->must_be_updated_p = 1;
5221 update_single_window (w, 1);
5223 /* Restore original current buffer. */
5224 set_buffer_internal_1 (old_buffer);
5225 windows_or_buffers_changed = old_windows_or_buffers_changed;
5227 start_timer:
5228 /* Let the tip disappear after timeout seconds. */
5229 tip_timer = call3 (intern ("run-at-time"), timeout, Qnil,
5230 intern ("x-hide-tip"));
5232 UNGCPRO;
5233 return unbind_to (count, Qnil);
5237 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
5238 doc: /* Hide the current tooltip window, if there is any.
5239 Value is t if tooltip was open, nil otherwise. */)
5240 (void)
5242 int count;
5243 Lisp_Object deleted, frame, timer;
5244 struct gcpro gcpro1, gcpro2;
5246 /* Return quickly if nothing to do. */
5247 if (NILP (tip_timer) && NILP (tip_frame))
5248 return Qnil;
5250 frame = tip_frame;
5251 timer = tip_timer;
5252 GCPRO2 (frame, timer);
5253 tip_frame = tip_timer = deleted = Qnil;
5255 count = SPECPDL_INDEX ();
5256 specbind (Qinhibit_redisplay, Qt);
5257 specbind (Qinhibit_quit, Qt);
5259 if (!NILP (timer))
5260 call1 (Qcancel_timer, timer);
5262 #ifdef USE_GTK
5264 /* When using system tooltip, tip_frame is the Emacs frame on which
5265 the tip is shown. */
5266 struct frame *f = XFRAME (frame);
5267 if (FRAME_LIVE_P (f) && xg_hide_tooltip (f))
5268 frame = Qnil;
5270 #endif
5272 if (FRAMEP (frame))
5274 delete_frame (frame, Qnil);
5275 deleted = Qt;
5277 #ifdef USE_LUCID
5278 /* Bloodcurdling hack alert: The Lucid menu bar widget's
5279 redisplay procedure is not called when a tip frame over menu
5280 items is unmapped. Redisplay the menu manually... */
5282 Widget w;
5283 struct frame *f = SELECTED_FRAME ();
5284 w = f->output_data.x->menubar_widget;
5286 if (!DoesSaveUnders (FRAME_X_DISPLAY_INFO (f)->screen)
5287 && w != NULL)
5289 BLOCK_INPUT;
5290 xlwmenu_redisplay (w);
5291 UNBLOCK_INPUT;
5294 #endif /* USE_LUCID */
5297 UNGCPRO;
5298 return unbind_to (count, deleted);
5303 /***********************************************************************
5304 File selection dialog
5305 ***********************************************************************/
5307 DEFUN ("x-uses-old-gtk-dialog", Fx_uses_old_gtk_dialog,
5308 Sx_uses_old_gtk_dialog,
5309 0, 0, 0,
5310 doc: /* Return t if the old Gtk+ file selection dialog is used. */)
5311 (void)
5313 #ifdef USE_GTK
5314 if (use_dialog_box
5315 && use_file_dialog
5316 && have_menus_p ()
5317 && xg_uses_old_file_dialog ())
5318 return Qt;
5319 #endif
5320 return Qnil;
5324 #ifdef USE_MOTIF
5325 /* Callback for "OK" and "Cancel" on file selection dialog. */
5327 static void
5328 file_dialog_cb (Widget widget, XtPointer client_data, XtPointer call_data)
5330 int *result = (int *) client_data;
5331 XmAnyCallbackStruct *cb = (XmAnyCallbackStruct *) call_data;
5332 *result = cb->reason;
5336 /* Callback for unmapping a file selection dialog. This is used to
5337 capture the case where a dialog is closed via a window manager's
5338 closer button, for example. Using a XmNdestroyCallback didn't work
5339 in this case. */
5341 static void
5342 file_dialog_unmap_cb (Widget widget, XtPointer client_data, XtPointer call_data)
5344 int *result = (int *) client_data;
5345 *result = XmCR_CANCEL;
5348 static Lisp_Object
5349 clean_up_file_dialog (Lisp_Object arg)
5351 struct Lisp_Save_Value *p = XSAVE_VALUE (arg);
5352 Widget dialog = (Widget) p->pointer;
5354 /* Clean up. */
5355 BLOCK_INPUT;
5356 XtUnmanageChild (dialog);
5357 XtDestroyWidget (dialog);
5358 x_menu_set_in_use (0);
5359 UNBLOCK_INPUT;
5361 return Qnil;
5365 DEFUN ("x-file-dialog", Fx_file_dialog, Sx_file_dialog, 2, 5, 0,
5366 doc: /* Read file name, prompting with PROMPT in directory DIR.
5367 Use a file selection dialog. Select DEFAULT-FILENAME in the dialog's file
5368 selection box, if specified. If MUSTMATCH is non-nil, the returned file
5369 or directory must exist.
5371 This function is only defined on MS Windows, and X Windows with the
5372 Motif or Gtk toolkits. With the Motif toolkit, ONLY-DIR-P is ignored.
5373 Otherwise, if ONLY-DIR-P is non-nil, the user can only select directories. */)
5374 (Lisp_Object prompt, Lisp_Object dir, Lisp_Object default_filename, Lisp_Object mustmatch, Lisp_Object only_dir_p)
5376 int result;
5377 struct frame *f = SELECTED_FRAME ();
5378 Lisp_Object file = Qnil;
5379 Lisp_Object decoded_file;
5380 Widget dialog, text, help;
5381 Arg al[10];
5382 int ac = 0;
5383 XmString dir_xmstring, pattern_xmstring;
5384 int count = SPECPDL_INDEX ();
5385 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
5387 check_x ();
5389 GCPRO6 (prompt, dir, default_filename, mustmatch, only_dir_p, file);
5391 if (popup_activated ())
5392 error ("Trying to use a menu from within a menu-entry");
5394 CHECK_STRING (prompt);
5395 CHECK_STRING (dir);
5397 /* Prevent redisplay. */
5398 specbind (Qinhibit_redisplay, Qt);
5400 BLOCK_INPUT;
5402 /* Create the dialog with PROMPT as title, using DIR as initial
5403 directory and using "*" as pattern. */
5404 dir = Fexpand_file_name (dir, Qnil);
5405 dir_xmstring = XmStringCreateLocalized (SDATA (dir));
5406 pattern_xmstring = XmStringCreateLocalized ("*");
5408 XtSetArg (al[ac], XmNtitle, SDATA (prompt)); ++ac;
5409 XtSetArg (al[ac], XmNdirectory, dir_xmstring); ++ac;
5410 XtSetArg (al[ac], XmNpattern, pattern_xmstring); ++ac;
5411 XtSetArg (al[ac], XmNresizePolicy, XmRESIZE_GROW); ++ac;
5412 XtSetArg (al[ac], XmNdialogStyle, XmDIALOG_APPLICATION_MODAL); ++ac;
5413 dialog = XmCreateFileSelectionDialog (f->output_data.x->widget,
5414 "fsb", al, ac);
5415 XmStringFree (dir_xmstring);
5416 XmStringFree (pattern_xmstring);
5418 /* Add callbacks for OK and Cancel. */
5419 XtAddCallback (dialog, XmNokCallback, file_dialog_cb,
5420 (XtPointer) &result);
5421 XtAddCallback (dialog, XmNcancelCallback, file_dialog_cb,
5422 (XtPointer) &result);
5423 XtAddCallback (dialog, XmNunmapCallback, file_dialog_unmap_cb,
5424 (XtPointer) &result);
5426 /* Remove the help button since we can't display help. */
5427 help = XmFileSelectionBoxGetChild (dialog, XmDIALOG_HELP_BUTTON);
5428 XtUnmanageChild (help);
5430 /* Mark OK button as default. */
5431 XtVaSetValues (XmFileSelectionBoxGetChild (dialog, XmDIALOG_OK_BUTTON),
5432 XmNshowAsDefault, True, NULL);
5434 /* If MUSTMATCH is non-nil, disable the file entry field of the
5435 dialog, so that the user must select a file from the files list
5436 box. We can't remove it because we wouldn't have a way to get at
5437 the result file name, then. */
5438 text = XmFileSelectionBoxGetChild (dialog, XmDIALOG_TEXT);
5439 if (!NILP (mustmatch))
5441 Widget label;
5442 label = XmFileSelectionBoxGetChild (dialog, XmDIALOG_SELECTION_LABEL);
5443 XtSetSensitive (text, False);
5444 XtSetSensitive (label, False);
5447 /* Manage the dialog, so that list boxes get filled. */
5448 XtManageChild (dialog);
5450 if (STRINGP (default_filename))
5452 XmString default_xmstring;
5453 Widget wtext = XmFileSelectionBoxGetChild (dialog, XmDIALOG_TEXT);
5454 Widget list = XmFileSelectionBoxGetChild (dialog, XmDIALOG_LIST);
5456 XmTextPosition last_pos = XmTextFieldGetLastPosition (wtext);
5457 XmTextFieldReplace (wtext, 0, last_pos,
5458 (SDATA (Ffile_name_nondirectory (default_filename))));
5460 /* Select DEFAULT_FILENAME in the files list box. DEFAULT_FILENAME
5461 must include the path for this to work. */
5463 default_xmstring = XmStringCreateLocalized (SDATA (default_filename));
5465 if (XmListItemExists (list, default_xmstring))
5467 int item_pos = XmListItemPos (list, default_xmstring);
5468 /* Select the item and scroll it into view. */
5469 XmListSelectPos (list, item_pos, True);
5470 XmListSetPos (list, item_pos);
5473 XmStringFree (default_xmstring);
5476 record_unwind_protect (clean_up_file_dialog, make_save_value (dialog, 0));
5478 /* Process events until the user presses Cancel or OK. */
5479 x_menu_set_in_use (1);
5480 result = 0;
5481 while (result == 0)
5483 XEvent event;
5484 x_menu_wait_for_event (0);
5485 XtAppNextEvent (Xt_app_con, &event);
5486 if (event.type == KeyPress
5487 && FRAME_X_DISPLAY (f) == event.xkey.display)
5489 KeySym keysym = XLookupKeysym (&event.xkey, 0);
5491 /* Pop down on C-g. */
5492 if (keysym == XK_g && (event.xkey.state & ControlMask) != 0)
5493 XtUnmanageChild (dialog);
5496 (void) x_dispatch_event (&event, FRAME_X_DISPLAY (f));
5499 /* Get the result. */
5500 if (result == XmCR_OK)
5502 XmString text_string;
5503 String data;
5505 XtVaGetValues (dialog, XmNtextString, &text_string, NULL);
5506 XmStringGetLtoR (text_string, XmFONTLIST_DEFAULT_TAG, &data);
5507 XmStringFree (text_string);
5508 file = build_string (data);
5509 XtFree (data);
5511 else
5512 file = Qnil;
5514 UNBLOCK_INPUT;
5515 UNGCPRO;
5517 /* Make "Cancel" equivalent to C-g. */
5518 if (NILP (file))
5519 Fsignal (Qquit, Qnil);
5521 decoded_file = DECODE_FILE (file);
5523 return unbind_to (count, decoded_file);
5526 #endif /* USE_MOTIF */
5528 #ifdef USE_GTK
5530 static Lisp_Object
5531 clean_up_dialog (Lisp_Object arg)
5533 x_menu_set_in_use (0);
5535 return Qnil;
5538 DEFUN ("x-file-dialog", Fx_file_dialog, Sx_file_dialog, 2, 5, 0,
5539 doc: /* Read file name, prompting with PROMPT in directory DIR.
5540 Use a file selection dialog. Select DEFAULT-FILENAME in the dialog's file
5541 selection box, if specified. If MUSTMATCH is non-nil, the returned file
5542 or directory must exist.
5544 This function is only defined on MS Windows, and X Windows with the
5545 Motif or Gtk toolkits. With the Motif toolkit, ONLY-DIR-P is ignored.
5546 Otherwise, if ONLY-DIR-P is non-nil, the user can only select directories. */)
5547 (Lisp_Object prompt, Lisp_Object dir, Lisp_Object default_filename, Lisp_Object mustmatch, Lisp_Object only_dir_p)
5549 FRAME_PTR f = SELECTED_FRAME ();
5550 char *fn;
5551 Lisp_Object file = Qnil;
5552 Lisp_Object decoded_file;
5553 int count = SPECPDL_INDEX ();
5554 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
5555 char *cdef_file;
5557 check_x ();
5559 GCPRO6 (prompt, dir, default_filename, mustmatch, only_dir_p, file);
5561 if (popup_activated ())
5562 error ("Trying to use a menu from within a menu-entry");
5564 CHECK_STRING (prompt);
5565 CHECK_STRING (dir);
5567 /* Prevent redisplay. */
5568 specbind (Qinhibit_redisplay, Qt);
5569 record_unwind_protect (clean_up_dialog, Qnil);
5571 BLOCK_INPUT;
5573 if (STRINGP (default_filename))
5574 cdef_file = SSDATA (default_filename);
5575 else
5576 cdef_file = SSDATA (dir);
5578 fn = xg_get_file_name (f, SSDATA (prompt), cdef_file,
5579 ! NILP (mustmatch),
5580 ! NILP (only_dir_p));
5582 if (fn)
5584 file = build_string (fn);
5585 xfree (fn);
5588 UNBLOCK_INPUT;
5589 UNGCPRO;
5591 /* Make "Cancel" equivalent to C-g. */
5592 if (NILP (file))
5593 Fsignal (Qquit, Qnil);
5595 decoded_file = DECODE_FILE (file);
5597 return unbind_to (count, decoded_file);
5601 #ifdef HAVE_FREETYPE
5603 DEFUN ("x-select-font", Fx_select_font, Sx_select_font, 0, 2, 0,
5604 doc: /* Read a font name using a GTK font selection dialog.
5605 Return a GTK-style font string corresponding to the selection.
5607 If FRAME is omitted or nil, it defaults to the selected frame. */)
5608 (Lisp_Object frame, Lisp_Object ignored)
5610 FRAME_PTR f = check_x_frame (frame);
5611 char *name;
5612 Lisp_Object font;
5613 Lisp_Object font_param;
5614 char *default_name = NULL;
5615 struct gcpro gcpro1, gcpro2;
5616 int count = SPECPDL_INDEX ();
5618 check_x ();
5620 if (popup_activated ())
5621 error ("Trying to use a menu from within a menu-entry");
5623 /* Prevent redisplay. */
5624 specbind (Qinhibit_redisplay, Qt);
5625 record_unwind_protect (clean_up_dialog, Qnil);
5627 BLOCK_INPUT;
5629 GCPRO2 (font_param, font);
5631 XSETFONT (font, FRAME_FONT (f));
5632 font_param = Ffont_get (font, intern (":name"));
5633 if (STRINGP (font_param))
5634 default_name = xstrdup (SSDATA (font_param));
5635 else
5637 font_param = Fframe_parameter (frame, Qfont_param);
5638 if (STRINGP (font_param))
5639 default_name = xstrdup (SSDATA (font_param));
5642 if (default_name == NULL && x_last_font_name != NULL)
5643 default_name = xstrdup (x_last_font_name);
5645 /* Convert fontconfig names to Gtk names, i.e. remove - before number */
5646 if (default_name)
5648 char *p = strrchr (default_name, '-');
5649 if (p)
5651 char *ep = p+1;
5652 while (isdigit (*ep))
5653 ++ep;
5654 if (*ep == '\0') *p = ' ';
5658 name = xg_get_font_name (f, default_name);
5659 xfree (default_name);
5661 if (name)
5663 font = build_string (name);
5664 g_free (x_last_font_name);
5665 x_last_font_name = name;
5668 UNBLOCK_INPUT;
5670 if (NILP (font))
5671 Fsignal (Qquit, Qnil);
5673 return unbind_to (count, font);
5675 #endif /* HAVE_FREETYPE */
5677 #endif /* USE_GTK */
5680 /***********************************************************************
5681 Keyboard
5682 ***********************************************************************/
5684 #ifdef HAVE_XKBGETKEYBOARD
5685 #include <X11/XKBlib.h>
5686 #include <X11/keysym.h>
5687 #endif
5689 DEFUN ("x-backspace-delete-keys-p", Fx_backspace_delete_keys_p,
5690 Sx_backspace_delete_keys_p, 0, 1, 0,
5691 doc: /* Check if both Backspace and Delete keys are on the keyboard of FRAME.
5692 FRAME nil means use the selected frame.
5693 Value is t if we know that both keys are present, and are mapped to the
5694 usual X keysyms. Value is `lambda' if we cannot determine if both keys are
5695 present and mapped to the usual X keysyms. */)
5696 (Lisp_Object frame)
5698 #ifdef HAVE_XKBGETKEYBOARD
5699 XkbDescPtr kb;
5700 struct frame *f = check_x_frame (frame);
5701 Display *dpy = FRAME_X_DISPLAY (f);
5702 Lisp_Object have_keys;
5703 int major, minor, op, event, error_code;
5705 BLOCK_INPUT;
5707 /* Check library version in case we're dynamically linked. */
5708 major = XkbMajorVersion;
5709 minor = XkbMinorVersion;
5710 if (!XkbLibraryVersion (&major, &minor))
5712 UNBLOCK_INPUT;
5713 return Qlambda;
5716 /* Check that the server supports XKB. */
5717 major = XkbMajorVersion;
5718 minor = XkbMinorVersion;
5719 if (!XkbQueryExtension (dpy, &op, &event, &error_code, &major, &minor))
5721 UNBLOCK_INPUT;
5722 return Qlambda;
5725 /* In this code we check that the keyboard has physical keys with names
5726 that start with BKSP (Backspace) and DELE (Delete), and that they
5727 generate keysym XK_BackSpace and XK_Delete respectively.
5728 This function is used to test if normal-erase-is-backspace should be
5729 turned on.
5730 An alternative approach would be to just check if XK_BackSpace and
5731 XK_Delete are mapped to any key. But if any of those are mapped to
5732 some non-intuitive key combination (Meta-Shift-Ctrl-whatever) and the
5733 user doesn't know about it, it is better to return false here.
5734 It is more obvious to the user what to do if she/he has two keys
5735 clearly marked with names/symbols and one key does something not
5736 expected (i.e. she/he then tries the other).
5737 The cases where Backspace/Delete is mapped to some other key combination
5738 are rare, and in those cases, normal-erase-is-backspace can be turned on
5739 manually. */
5741 have_keys = Qnil;
5742 kb = XkbGetMap (dpy, XkbAllMapComponentsMask, XkbUseCoreKbd);
5743 if (kb)
5745 int delete_keycode = 0, backspace_keycode = 0, i;
5747 if (XkbGetNames (dpy, XkbAllNamesMask, kb) == Success)
5749 for (i = kb->min_key_code;
5750 (i < kb->max_key_code
5751 && (delete_keycode == 0 || backspace_keycode == 0));
5752 ++i)
5754 /* The XKB symbolic key names can be seen most easily in
5755 the PS file generated by `xkbprint -label name
5756 $DISPLAY'. */
5757 if (memcmp ("DELE", kb->names->keys[i].name, 4) == 0)
5758 delete_keycode = i;
5759 else if (memcmp ("BKSP", kb->names->keys[i].name, 4) == 0)
5760 backspace_keycode = i;
5763 XkbFreeNames (kb, 0, True);
5766 XkbFreeClientMap (kb, 0, True);
5768 if (delete_keycode
5769 && backspace_keycode
5770 && XKeysymToKeycode (dpy, XK_Delete) == delete_keycode
5771 && XKeysymToKeycode (dpy, XK_BackSpace) == backspace_keycode)
5772 have_keys = Qt;
5774 UNBLOCK_INPUT;
5775 return have_keys;
5776 #else /* not HAVE_XKBGETKEYBOARD */
5777 return Qlambda;
5778 #endif /* not HAVE_XKBGETKEYBOARD */
5783 /***********************************************************************
5784 Initialization
5785 ***********************************************************************/
5787 /* Keep this list in the same order as frame_parms in frame.c.
5788 Use 0 for unsupported frame parameters. */
5790 frame_parm_handler x_frame_parm_handlers[] =
5792 x_set_autoraise,
5793 x_set_autolower,
5794 x_set_background_color,
5795 x_set_border_color,
5796 x_set_border_width,
5797 x_set_cursor_color,
5798 x_set_cursor_type,
5799 x_set_font,
5800 x_set_foreground_color,
5801 x_set_icon_name,
5802 x_set_icon_type,
5803 x_set_internal_border_width,
5804 x_set_menu_bar_lines,
5805 x_set_mouse_color,
5806 x_explicitly_set_name,
5807 x_set_scroll_bar_width,
5808 x_set_title,
5809 x_set_unsplittable,
5810 x_set_vertical_scroll_bars,
5811 x_set_visibility,
5812 x_set_tool_bar_lines,
5813 x_set_scroll_bar_foreground,
5814 x_set_scroll_bar_background,
5815 x_set_screen_gamma,
5816 x_set_line_spacing,
5817 x_set_fringe_width,
5818 x_set_fringe_width,
5819 x_set_wait_for_wm,
5820 x_set_fullscreen,
5821 x_set_font_backend,
5822 x_set_alpha,
5823 x_set_sticky,
5824 x_set_tool_bar_position,
5827 void
5828 syms_of_xfns (void)
5830 /* This is zero if not using X windows. */
5831 x_in_use = 0;
5833 /* The section below is built by the lisp expression at the top of the file,
5834 just above where these variables are declared. */
5835 /*&&& init symbols here &&&*/
5836 DEFSYM (Qnone, "none");
5837 DEFSYM (Qsuppress_icon, "suppress-icon");
5838 DEFSYM (Qundefined_color, "undefined-color");
5839 DEFSYM (Qcompound_text, "compound-text");
5840 DEFSYM (Qcancel_timer, "cancel-timer");
5841 DEFSYM (Qfont_param, "font-parameter");
5842 /* This is the end of symbol initialization. */
5844 Fput (Qundefined_color, Qerror_conditions,
5845 pure_cons (Qundefined_color, pure_cons (Qerror, Qnil)));
5846 Fput (Qundefined_color, Qerror_message,
5847 make_pure_c_string ("Undefined color"));
5849 DEFVAR_LISP ("x-pointer-shape", Vx_pointer_shape,
5850 doc: /* The shape of the pointer when over text.
5851 Changing the value does not affect existing frames
5852 unless you set the mouse color. */);
5853 Vx_pointer_shape = Qnil;
5855 #if 0 /* This doesn't really do anything. */
5856 DEFVAR_LISP ("x-nontext-pointer-shape", Vx_nontext_pointer_shape,
5857 doc: /* The shape of the pointer when not over text.
5858 This variable takes effect when you create a new frame
5859 or when you set the mouse color. */);
5860 #endif
5861 Vx_nontext_pointer_shape = Qnil;
5863 DEFVAR_LISP ("x-hourglass-pointer-shape", Vx_hourglass_pointer_shape,
5864 doc: /* The shape of the pointer when Emacs is busy.
5865 This variable takes effect when you create a new frame
5866 or when you set the mouse color. */);
5867 Vx_hourglass_pointer_shape = Qnil;
5869 #if 0 /* This doesn't really do anything. */
5870 DEFVAR_LISP ("x-mode-pointer-shape", Vx_mode_pointer_shape,
5871 doc: /* The shape of the pointer when over the mode line.
5872 This variable takes effect when you create a new frame
5873 or when you set the mouse color. */);
5874 #endif
5875 Vx_mode_pointer_shape = Qnil;
5877 DEFVAR_LISP ("x-sensitive-text-pointer-shape",
5878 Vx_sensitive_text_pointer_shape,
5879 doc: /* The shape of the pointer when over mouse-sensitive text.
5880 This variable takes effect when you create a new frame
5881 or when you set the mouse color. */);
5882 Vx_sensitive_text_pointer_shape = Qnil;
5884 DEFVAR_LISP ("x-window-horizontal-drag-cursor",
5885 Vx_window_horizontal_drag_shape,
5886 doc: /* Pointer shape to use for indicating a window can be dragged horizontally.
5887 This variable takes effect when you create a new frame
5888 or when you set the mouse color. */);
5889 Vx_window_horizontal_drag_shape = Qnil;
5891 DEFVAR_LISP ("x-cursor-fore-pixel", Vx_cursor_fore_pixel,
5892 doc: /* A string indicating the foreground color of the cursor box. */);
5893 Vx_cursor_fore_pixel = Qnil;
5895 DEFVAR_LISP ("x-max-tooltip-size", Vx_max_tooltip_size,
5896 doc: /* Maximum size for tooltips.
5897 Value is a pair (COLUMNS . ROWS). Text larger than this is clipped. */);
5898 Vx_max_tooltip_size = Fcons (make_number (80), make_number (40));
5900 DEFVAR_LISP ("x-no-window-manager", Vx_no_window_manager,
5901 doc: /* Non-nil if no X window manager is in use.
5902 Emacs doesn't try to figure this out; this is always nil
5903 unless you set it to something else. */);
5904 /* We don't have any way to find this out, so set it to nil
5905 and maybe the user would like to set it to t. */
5906 Vx_no_window_manager = Qnil;
5908 DEFVAR_LISP ("x-pixel-size-width-font-regexp",
5909 Vx_pixel_size_width_font_regexp,
5910 doc: /* Regexp matching a font name whose width is the same as `PIXEL_SIZE'.
5912 Since Emacs gets width of a font matching with this regexp from
5913 PIXEL_SIZE field of the name, font finding mechanism gets faster for
5914 such a font. This is especially effective for such large fonts as
5915 Chinese, Japanese, and Korean. */);
5916 Vx_pixel_size_width_font_regexp = Qnil;
5918 /* This is not ifdef:ed, so other builds than GTK can customize it. */
5919 DEFVAR_BOOL ("x-gtk-use-old-file-dialog", x_gtk_use_old_file_dialog,
5920 doc: /* Non-nil means prompt with the old GTK file selection dialog.
5921 If nil or if the file selection dialog is not available, the new GTK file
5922 chooser is used instead. To turn off all file dialogs set the
5923 variable `use-file-dialog'. */);
5924 x_gtk_use_old_file_dialog = 0;
5926 DEFVAR_BOOL ("x-gtk-show-hidden-files", x_gtk_show_hidden_files,
5927 doc: /* If non-nil, the GTK file chooser will by default show hidden files.
5928 Note that this is just the default, there is a toggle button on the file
5929 chooser to show or not show hidden files on a case by case basis. */);
5930 x_gtk_show_hidden_files = 0;
5932 DEFVAR_BOOL ("x-gtk-file-dialog-help-text", x_gtk_file_dialog_help_text,
5933 doc: /* If non-nil, the GTK file chooser will show additional help text.
5934 If more space for files in the file chooser dialog is wanted, set this to nil
5935 to turn the additional text off. */);
5936 x_gtk_file_dialog_help_text = 1;
5938 DEFVAR_BOOL ("x-gtk-whole-detached-tool-bar", x_gtk_whole_detached_tool_bar,
5939 doc: /* If non-nil, a detached tool bar is shown in full.
5940 The default is to just show an arrow and pressing on that arrow shows
5941 the tool bar buttons. */);
5942 x_gtk_whole_detached_tool_bar = 0;
5944 DEFVAR_BOOL ("x-gtk-use-system-tooltips", x_gtk_use_system_tooltips,
5945 doc: /* If non-nil with a Gtk+ built Emacs, the Gtk+ tooltip is used.
5946 Otherwise use Emacs own tooltip implementation.
5947 When using Gtk+ tooltips, the tooltip face is not used. */);
5948 x_gtk_use_system_tooltips = 1;
5950 Fprovide (intern_c_string ("x"), Qnil);
5952 #ifdef USE_X_TOOLKIT
5953 Fprovide (intern_c_string ("x-toolkit"), Qnil);
5954 #ifdef USE_MOTIF
5955 Fprovide (intern_c_string ("motif"), Qnil);
5957 DEFVAR_LISP ("motif-version-string", Vmotif_version_string,
5958 doc: /* Version info for LessTif/Motif. */);
5959 Vmotif_version_string = build_string (XmVERSION_STRING);
5960 #endif /* USE_MOTIF */
5961 #endif /* USE_X_TOOLKIT */
5963 #ifdef USE_GTK
5964 /* Provide x-toolkit also for GTK. Internally GTK does not use Xt so it
5965 is not an X toolkit in that sense (USE_X_TOOLKIT is not defined).
5966 But for a user it is a toolkit for X, and indeed, configure
5967 accepts --with-x-toolkit=gtk. */
5968 Fprovide (intern_c_string ("x-toolkit"), Qnil);
5969 Fprovide (intern_c_string ("gtk"), Qnil);
5970 Fprovide (intern_c_string ("move-toolbar"), Qnil);
5972 DEFVAR_LISP ("gtk-version-string", Vgtk_version_string,
5973 doc: /* Version info for GTK+. */);
5975 char gtk_version[40];
5976 g_snprintf (gtk_version, sizeof (gtk_version), "%u.%u.%u",
5977 GTK_MAJOR_VERSION, GTK_MINOR_VERSION, GTK_MICRO_VERSION);
5978 Vgtk_version_string = make_pure_string (gtk_version, strlen (gtk_version), strlen (gtk_version), 0);
5980 #endif /* USE_GTK */
5982 /* X window properties. */
5983 defsubr (&Sx_change_window_property);
5984 defsubr (&Sx_delete_window_property);
5985 defsubr (&Sx_window_property);
5987 defsubr (&Sxw_display_color_p);
5988 defsubr (&Sx_display_grayscale_p);
5989 defsubr (&Sxw_color_defined_p);
5990 defsubr (&Sxw_color_values);
5991 defsubr (&Sx_server_max_request_size);
5992 defsubr (&Sx_server_vendor);
5993 defsubr (&Sx_server_version);
5994 defsubr (&Sx_display_pixel_width);
5995 defsubr (&Sx_display_pixel_height);
5996 defsubr (&Sx_display_mm_width);
5997 defsubr (&Sx_display_mm_height);
5998 defsubr (&Sx_display_screens);
5999 defsubr (&Sx_display_planes);
6000 defsubr (&Sx_display_color_cells);
6001 defsubr (&Sx_display_visual_class);
6002 defsubr (&Sx_display_backing_store);
6003 defsubr (&Sx_display_save_under);
6004 defsubr (&Sx_wm_set_size_hint);
6005 defsubr (&Sx_create_frame);
6006 defsubr (&Sx_open_connection);
6007 defsubr (&Sx_close_connection);
6008 defsubr (&Sx_display_list);
6009 defsubr (&Sx_synchronize);
6010 defsubr (&Sx_focus_frame);
6011 defsubr (&Sx_backspace_delete_keys_p);
6013 /* Setting callback functions for fontset handler. */
6014 check_window_system_func = check_x;
6016 defsubr (&Sx_show_tip);
6017 defsubr (&Sx_hide_tip);
6018 tip_timer = Qnil;
6019 staticpro (&tip_timer);
6020 tip_frame = Qnil;
6021 staticpro (&tip_frame);
6023 last_show_tip_args = Qnil;
6024 staticpro (&last_show_tip_args);
6026 defsubr (&Sx_uses_old_gtk_dialog);
6027 #if defined (USE_MOTIF) || defined (USE_GTK)
6028 defsubr (&Sx_file_dialog);
6029 #endif
6031 #if defined (USE_GTK) && defined (HAVE_FREETYPE)
6032 defsubr (&Sx_select_font);
6033 x_last_font_name = NULL;
6034 #endif
6037 #endif /* HAVE_X_WINDOWS */