Use xstrdup and build_unibyte_string where applicable.
[emacs.git] / src / xfns.c
blob92a7964eb75ae70b112314e333df0f889a457725
1 /* Functions for the X window system.
3 Copyright (C) 1989, 1992-2013 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 <unistd.h>
25 /* This makes the fields of a Display accessible, in Xlib header files. */
27 #define XLIB_ILLEGAL_ACCESS
29 #include "lisp.h"
30 #include "xterm.h"
31 #include "frame.h"
32 #include "window.h"
33 #include "character.h"
34 #include "buffer.h"
35 #include "intervals.h"
36 #include "dispextern.h"
37 #include "keyboard.h"
38 #include "blockinput.h"
39 #include <epaths.h>
40 #include "charset.h"
41 #include "coding.h"
42 #include "fontset.h"
43 #include "systime.h"
44 #include "termhooks.h"
45 #include "atimer.h"
46 #include "termchar.h"
47 #include "font.h"
49 #ifdef HAVE_X_WINDOWS
51 #include <sys/types.h>
52 #include <sys/stat.h>
54 #if 1 /* Used to be #ifdef EMACS_BITMAP_FILES, but this should always work. */
55 #include "bitmaps/gray.xbm"
56 #else
57 #include <X11/bitmaps/gray>
58 #endif
60 #include "xsettings.h"
62 #ifdef HAVE_XRANDR
63 #include <X11/extensions/Xrandr.h>
64 #endif
65 #ifdef HAVE_XINERAMA
66 #include <X11/extensions/Xinerama.h>
67 #endif
69 #ifdef USE_GTK
70 #include "gtkutil.h"
71 #endif
73 #ifdef USE_X_TOOLKIT
74 #include <X11/Shell.h>
76 #ifndef USE_MOTIF
77 #ifdef HAVE_XAW3D
78 #include <X11/Xaw3d/Paned.h>
79 #include <X11/Xaw3d/Label.h>
80 #else /* !HAVE_XAW3D */
81 #include <X11/Xaw/Paned.h>
82 #include <X11/Xaw/Label.h>
83 #endif /* HAVE_XAW3D */
84 #endif /* USE_MOTIF */
86 #ifdef USG
87 #undef USG /* ####KLUDGE for Solaris 2.2 and up */
88 #include <X11/Xos.h>
89 #define USG
90 #ifdef USG /* Pacify gcc -Wunused-macros. */
91 #endif
92 #else
93 #include <X11/Xos.h>
94 #endif
96 #include "widget.h"
98 #include "../lwlib/lwlib.h"
100 #ifdef USE_MOTIF
101 #include <Xm/Xm.h>
102 #include <Xm/DialogS.h>
103 #include <Xm/FileSB.h>
104 #include <Xm/List.h>
105 #include <Xm/TextF.h>
106 #endif
108 #ifdef USE_LUCID
109 #include "../lwlib/xlwmenu.h"
110 #endif
112 #if !defined (NO_EDITRES)
113 #define HACK_EDITRES
114 extern void _XEditResCheckMessages (Widget, XtPointer, XEvent *, Boolean *);
115 #endif /* not defined NO_EDITRES */
117 /* Unique id counter for widgets created by the Lucid Widget Library. */
119 extern LWLIB_ID widget_id_tick;
121 #ifdef USE_MOTIF
123 #endif /* USE_MOTIF */
125 #endif /* USE_X_TOOLKIT */
127 #ifdef USE_GTK
129 #endif /* USE_GTK */
131 #define MAXREQUEST(dpy) (XMaxRequestSize (dpy))
133 static Lisp_Object Qsuppress_icon;
134 static Lisp_Object Qundefined_color;
135 static Lisp_Object Qcompound_text, Qcancel_timer;
136 Lisp_Object Qfont_param;
138 #ifdef GLYPH_DEBUG
139 static ptrdiff_t image_cache_refcount;
140 static int dpyinfo_refcount;
141 #endif
143 static struct x_display_info *x_display_info_for_name (Lisp_Object);
145 /* Let the user specify an X display with a Lisp object.
146 OBJECT may be nil, a frame or a terminal object.
147 nil stands for the selected frame--or, if that is not an X frame,
148 the first X display on the list. */
150 struct x_display_info *
151 check_x_display_info (Lisp_Object object)
153 struct x_display_info *dpyinfo = NULL;
155 if (NILP (object))
157 struct frame *sf = XFRAME (selected_frame);
159 if (FRAME_X_P (sf) && FRAME_LIVE_P (sf))
160 dpyinfo = FRAME_X_DISPLAY_INFO (sf);
161 else if (x_display_list != 0)
162 dpyinfo = x_display_list;
163 else
164 error ("X windows are not in use or not initialized");
166 else if (TERMINALP (object))
168 struct terminal *t = get_terminal (object, 1);
170 if (t->type != output_x_window)
171 error ("Terminal %d is not an X display", t->id);
173 dpyinfo = t->display_info.x;
175 else if (STRINGP (object))
176 dpyinfo = x_display_info_for_name (object);
177 else
179 struct frame *f = decode_window_system_frame (object);
180 dpyinfo = FRAME_X_DISPLAY_INFO (f);
183 return dpyinfo;
187 /* Return the Emacs frame-object corresponding to an X window.
188 It could be the frame's main window or an icon window. */
190 /* This function can be called during GC, so use GC_xxx type test macros. */
192 struct frame *
193 x_window_to_frame (struct x_display_info *dpyinfo, int wdesc)
195 Lisp_Object tail, frame;
196 struct frame *f;
198 if (wdesc == None)
199 return NULL;
201 FOR_EACH_FRAME (tail, frame)
203 f = XFRAME (frame);
204 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
205 continue;
206 if (f->output_data.x->hourglass_window == wdesc)
207 return f;
208 #ifdef USE_X_TOOLKIT
209 if ((f->output_data.x->edit_widget
210 && XtWindow (f->output_data.x->edit_widget) == wdesc)
211 /* A tooltip frame? */
212 || (!f->output_data.x->edit_widget
213 && FRAME_X_WINDOW (f) == wdesc)
214 || f->output_data.x->icon_desc == wdesc)
215 return f;
216 #else /* not USE_X_TOOLKIT */
217 #ifdef USE_GTK
218 if (f->output_data.x->edit_widget)
220 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
221 struct x_output *x = f->output_data.x;
222 if (gwdesc != 0 && gwdesc == x->edit_widget)
223 return f;
225 #endif /* USE_GTK */
226 if (FRAME_X_WINDOW (f) == wdesc
227 || f->output_data.x->icon_desc == wdesc)
228 return f;
229 #endif /* not USE_X_TOOLKIT */
231 return 0;
234 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
235 /* Like x_window_to_frame but also compares the window with the widget's
236 windows. */
238 struct frame *
239 x_any_window_to_frame (struct x_display_info *dpyinfo, int wdesc)
241 Lisp_Object tail, frame;
242 struct frame *f, *found = NULL;
243 struct x_output *x;
245 if (wdesc == None)
246 return NULL;
248 FOR_EACH_FRAME (tail, frame)
250 if (found)
251 break;
252 f = XFRAME (frame);
253 if (FRAME_X_P (f) && FRAME_X_DISPLAY_INFO (f) == dpyinfo)
255 /* This frame matches if the window is any of its widgets. */
256 x = f->output_data.x;
257 if (x->hourglass_window == wdesc)
258 found = f;
259 else if (x->widget)
261 #ifdef USE_GTK
262 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
263 if (gwdesc != 0
264 && gtk_widget_get_toplevel (gwdesc) == x->widget)
265 found = f;
266 #else
267 if (wdesc == XtWindow (x->widget)
268 || wdesc == XtWindow (x->column_widget)
269 || wdesc == XtWindow (x->edit_widget))
270 found = f;
271 /* Match if the window is this frame's menubar. */
272 else if (lw_window_is_in_menubar (wdesc, x->menubar_widget))
273 found = f;
274 #endif
276 else if (FRAME_X_WINDOW (f) == wdesc)
277 /* A tooltip frame. */
278 found = f;
282 return found;
285 /* Likewise, but consider only the menu bar widget. */
287 struct frame *
288 x_menubar_window_to_frame (struct x_display_info *dpyinfo, XEvent *event)
290 Window wdesc = event->xany.window;
291 Lisp_Object tail, frame;
292 struct frame *f;
293 struct x_output *x;
295 if (wdesc == None)
296 return NULL;
298 FOR_EACH_FRAME (tail, frame)
300 f = XFRAME (frame);
301 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
302 continue;
303 x = f->output_data.x;
304 #ifdef USE_GTK
305 if (x->menubar_widget && xg_event_is_for_menubar (f, event))
306 return f;
307 #else
308 /* Match if the window is this frame's menubar. */
309 if (x->menubar_widget
310 && lw_window_is_in_menubar (wdesc, x->menubar_widget))
311 return f;
312 #endif
314 return 0;
317 /* Return the frame whose principal (outermost) window is WDESC.
318 If WDESC is some other (smaller) window, we return 0. */
320 struct frame *
321 x_top_window_to_frame (struct x_display_info *dpyinfo, int wdesc)
323 Lisp_Object tail, frame;
324 struct frame *f;
325 struct x_output *x;
327 if (wdesc == None)
328 return NULL;
330 FOR_EACH_FRAME (tail, frame)
332 f = XFRAME (frame);
333 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
334 continue;
335 x = f->output_data.x;
337 if (x->widget)
339 /* This frame matches if the window is its topmost widget. */
340 #ifdef USE_GTK
341 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
342 if (gwdesc == x->widget)
343 return f;
344 #else
345 if (wdesc == XtWindow (x->widget))
346 return f;
347 #if 0 /* I don't know why it did this,
348 but it seems logically wrong,
349 and it causes trouble for MapNotify events. */
350 /* Match if the window is this frame's menubar. */
351 if (x->menubar_widget
352 && wdesc == XtWindow (x->menubar_widget))
353 return f;
354 #endif
355 #endif
357 else if (FRAME_X_WINDOW (f) == wdesc)
358 /* Tooltip frame. */
359 return f;
361 return 0;
363 #endif /* USE_X_TOOLKIT || USE_GTK */
367 /* Store the screen positions of frame F into XPTR and YPTR.
368 These are the positions of the containing window manager window,
369 not Emacs's own window. */
371 void
372 x_real_positions (struct frame *f, int *xptr, int *yptr)
374 int win_x, win_y, outer_x IF_LINT (= 0), outer_y IF_LINT (= 0);
375 int real_x = 0, real_y = 0;
376 int had_errors = 0;
377 Window win = f->output_data.x->parent_desc;
378 Atom actual_type;
379 unsigned long actual_size, bytes_remaining;
380 int rc, actual_format;
381 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
382 long max_len = 400;
383 Display *dpy = FRAME_X_DISPLAY (f);
384 unsigned char *tmp_data = NULL;
385 Atom target_type = XA_CARDINAL;
387 block_input ();
389 x_catch_errors (dpy);
391 if (win == dpyinfo->root_window)
392 win = FRAME_OUTER_WINDOW (f);
394 /* This loop traverses up the containment tree until we hit the root
395 window. Window managers may intersect many windows between our window
396 and the root window. The window we find just before the root window
397 should be the outer WM window. */
398 for (;;)
400 Window wm_window, rootw;
401 Window *tmp_children;
402 unsigned int tmp_nchildren;
403 int success;
405 success = XQueryTree (FRAME_X_DISPLAY (f), win, &rootw,
406 &wm_window, &tmp_children, &tmp_nchildren);
408 had_errors = x_had_errors_p (FRAME_X_DISPLAY (f));
410 /* Don't free tmp_children if XQueryTree failed. */
411 if (! success)
412 break;
414 XFree (tmp_children);
416 if (wm_window == rootw || had_errors)
417 break;
419 win = wm_window;
422 if (! had_errors)
424 unsigned int ign;
425 Window child, rootw;
427 /* Get the real coordinates for the WM window upper left corner */
428 XGetGeometry (FRAME_X_DISPLAY (f), win,
429 &rootw, &real_x, &real_y, &ign, &ign, &ign, &ign);
431 /* Translate real coordinates to coordinates relative to our
432 window. For our window, the upper left corner is 0, 0.
433 Since the upper left corner of the WM window is outside
434 our window, win_x and win_y will be negative:
436 ------------------ ---> x
437 | title |
438 | ----------------- v y
439 | | our window
441 XTranslateCoordinates (FRAME_X_DISPLAY (f),
443 /* From-window, to-window. */
444 FRAME_X_DISPLAY_INFO (f)->root_window,
445 FRAME_X_WINDOW (f),
447 /* From-position, to-position. */
448 real_x, real_y, &win_x, &win_y,
450 /* Child of win. */
451 &child);
453 if (FRAME_X_WINDOW (f) == FRAME_OUTER_WINDOW (f))
455 outer_x = win_x;
456 outer_y = win_y;
458 else
460 XTranslateCoordinates (FRAME_X_DISPLAY (f),
462 /* From-window, to-window. */
463 FRAME_X_DISPLAY_INFO (f)->root_window,
464 FRAME_OUTER_WINDOW (f),
466 /* From-position, to-position. */
467 real_x, real_y, &outer_x, &outer_y,
469 /* Child of win. */
470 &child);
473 had_errors = x_had_errors_p (FRAME_X_DISPLAY (f));
477 if (dpyinfo->root_window == f->output_data.x->parent_desc)
479 /* Try _NET_FRAME_EXTENTS if our parent is the root window. */
480 rc = XGetWindowProperty (dpy, win, dpyinfo->Xatom_net_frame_extents,
481 0, max_len, False, target_type,
482 &actual_type, &actual_format, &actual_size,
483 &bytes_remaining, &tmp_data);
485 if (rc == Success && actual_type == target_type && !x_had_errors_p (dpy)
486 && actual_size == 4 && actual_format == 32)
488 unsigned int ign;
489 Window rootw;
490 long *fe = (long *)tmp_data;
492 XGetGeometry (FRAME_X_DISPLAY (f), win,
493 &rootw, &real_x, &real_y, &ign, &ign, &ign, &ign);
494 outer_x = -fe[0];
495 outer_y = -fe[2];
496 real_x -= fe[0];
497 real_y -= fe[2];
501 if (tmp_data) XFree (tmp_data);
503 x_uncatch_errors ();
505 unblock_input ();
507 if (had_errors) return;
509 f->x_pixels_diff = -win_x;
510 f->y_pixels_diff = -win_y;
512 FRAME_X_OUTPUT (f)->x_pixels_outer_diff = -outer_x;
513 FRAME_X_OUTPUT (f)->y_pixels_outer_diff = -outer_y;
515 *xptr = real_x;
516 *yptr = real_y;
522 /* Gamma-correct COLOR on frame F. */
524 void
525 gamma_correct (struct frame *f, XColor *color)
527 if (f->gamma)
529 color->red = pow (color->red / 65535.0, f->gamma) * 65535.0 + 0.5;
530 color->green = pow (color->green / 65535.0, f->gamma) * 65535.0 + 0.5;
531 color->blue = pow (color->blue / 65535.0, f->gamma) * 65535.0 + 0.5;
536 /* Decide if color named COLOR_NAME is valid for use on frame F. If
537 so, return the RGB values in COLOR. If ALLOC_P,
538 allocate the color. Value is false if COLOR_NAME is invalid, or
539 no color could be allocated. */
541 bool
542 x_defined_color (struct frame *f, const char *color_name,
543 XColor *color, bool alloc_p)
545 bool success_p = 0;
546 Display *dpy = FRAME_X_DISPLAY (f);
547 Colormap cmap = FRAME_X_COLORMAP (f);
549 block_input ();
550 #ifdef USE_GTK
551 success_p = xg_check_special_colors (f, color_name, color);
552 #endif
553 if (!success_p)
554 success_p = XParseColor (dpy, cmap, color_name, color) != 0;
555 if (success_p && alloc_p)
556 success_p = x_alloc_nearest_color (f, cmap, color);
557 unblock_input ();
559 return success_p;
563 /* Return the pixel color value for color COLOR_NAME on frame F. If F
564 is a monochrome frame, return MONO_COLOR regardless of what ARG says.
565 Signal an error if color can't be allocated. */
567 static int
568 x_decode_color (struct frame *f, Lisp_Object color_name, int mono_color)
570 XColor cdef;
572 CHECK_STRING (color_name);
574 #if 0 /* Don't do this. It's wrong when we're not using the default
575 colormap, it makes freeing difficult, and it's probably not
576 an important optimization. */
577 if (strcmp (SDATA (color_name), "black") == 0)
578 return BLACK_PIX_DEFAULT (f);
579 else if (strcmp (SDATA (color_name), "white") == 0)
580 return WHITE_PIX_DEFAULT (f);
581 #endif
583 /* Return MONO_COLOR for monochrome frames. */
584 if (FRAME_X_DISPLAY_INFO (f)->n_planes == 1)
585 return mono_color;
587 /* x_defined_color is responsible for coping with failures
588 by looking for a near-miss. */
589 if (x_defined_color (f, SSDATA (color_name), &cdef, 1))
590 return cdef.pixel;
592 signal_error ("Undefined color", color_name);
597 /* Change the `wait-for-wm' frame parameter of frame F. OLD_VALUE is
598 the previous value of that parameter, NEW_VALUE is the new value.
599 See also the comment of wait_for_wm in struct x_output. */
601 static void
602 x_set_wait_for_wm (struct frame *f, Lisp_Object new_value, Lisp_Object old_value)
604 f->output_data.x->wait_for_wm = !NILP (new_value);
607 static void
608 x_set_tool_bar_position (struct frame *f,
609 Lisp_Object new_value,
610 Lisp_Object old_value)
612 if (! EQ (new_value, Qleft) && ! EQ (new_value, Qright)
613 && ! EQ (new_value, Qbottom) && ! EQ (new_value, Qtop))
614 return;
615 if (EQ (new_value, old_value)) return;
617 #ifdef USE_GTK
618 xg_change_toolbar_position (f, new_value);
619 fset_tool_bar_position (f, new_value);
620 #endif
623 #ifdef USE_GTK
625 /* Set icon from FILE for frame F. By using GTK functions the icon
626 may be any format that GdkPixbuf knows about, i.e. not just bitmaps. */
629 xg_set_icon (struct frame *f, Lisp_Object file)
631 int result = 0;
632 Lisp_Object found;
634 found = x_find_image_file (file);
636 if (! NILP (found))
638 GdkPixbuf *pixbuf;
639 GError *err = NULL;
640 char *filename = SSDATA (found);
641 block_input ();
643 pixbuf = gdk_pixbuf_new_from_file (filename, &err);
645 if (pixbuf)
647 gtk_window_set_icon (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)),
648 pixbuf);
649 g_object_unref (pixbuf);
651 result = 1;
653 else
654 g_error_free (err);
656 unblock_input ();
659 return result;
663 xg_set_icon_from_xpm_data (struct frame *f, const char **data)
665 GdkPixbuf *pixbuf = gdk_pixbuf_new_from_xpm_data (data);
667 if (!pixbuf)
668 return 0;
670 gtk_window_set_icon (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)), pixbuf);
671 g_object_unref (pixbuf);
672 return 1;
674 #endif /* USE_GTK */
677 /* Functions called only from `x_set_frame_param'
678 to set individual parameters.
680 If FRAME_X_WINDOW (f) is 0,
681 the frame is being created and its X-window does not exist yet.
682 In that case, just record the parameter's new value
683 in the standard place; do not attempt to change the window. */
685 static void
686 x_set_foreground_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
688 struct x_output *x = f->output_data.x;
689 unsigned long fg, old_fg;
691 fg = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
692 old_fg = FRAME_FOREGROUND_PIXEL (f);
693 FRAME_FOREGROUND_PIXEL (f) = fg;
695 if (FRAME_X_WINDOW (f) != 0)
697 Display *dpy = FRAME_X_DISPLAY (f);
699 block_input ();
700 XSetForeground (dpy, x->normal_gc, fg);
701 XSetBackground (dpy, x->reverse_gc, fg);
703 if (x->cursor_pixel == old_fg)
705 unload_color (f, x->cursor_pixel);
706 x->cursor_pixel = x_copy_color (f, fg);
707 XSetBackground (dpy, x->cursor_gc, x->cursor_pixel);
710 unblock_input ();
712 update_face_from_frame_parameter (f, Qforeground_color, arg);
714 if (FRAME_VISIBLE_P (f))
715 redraw_frame (f);
718 unload_color (f, old_fg);
721 static void
722 x_set_background_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
724 struct x_output *x = f->output_data.x;
725 unsigned long bg;
727 bg = x_decode_color (f, arg, WHITE_PIX_DEFAULT (f));
728 unload_color (f, FRAME_BACKGROUND_PIXEL (f));
729 FRAME_BACKGROUND_PIXEL (f) = bg;
731 if (FRAME_X_WINDOW (f) != 0)
733 Display *dpy = FRAME_X_DISPLAY (f);
735 block_input ();
736 XSetBackground (dpy, x->normal_gc, bg);
737 XSetForeground (dpy, x->reverse_gc, bg);
738 XSetWindowBackground (dpy, FRAME_X_WINDOW (f), bg);
739 XSetForeground (dpy, x->cursor_gc, bg);
741 #ifdef USE_GTK
742 xg_set_background_color (f, bg);
743 #endif
745 #ifndef USE_TOOLKIT_SCROLL_BARS /* Turns out to be annoying with
746 toolkit scroll bars. */
748 Lisp_Object bar;
749 for (bar = FRAME_SCROLL_BARS (f);
750 !NILP (bar);
751 bar = XSCROLL_BAR (bar)->next)
753 Window window = XSCROLL_BAR (bar)->x_window;
754 XSetWindowBackground (dpy, window, bg);
757 #endif /* USE_TOOLKIT_SCROLL_BARS */
759 unblock_input ();
760 update_face_from_frame_parameter (f, Qbackground_color, arg);
762 if (FRAME_VISIBLE_P (f))
763 redraw_frame (f);
767 static Cursor
768 make_invisible_cursor (struct frame *f)
770 Display *dpy = FRAME_X_DISPLAY (f);
771 static char const no_data[] = { 0 };
772 Pixmap pix;
773 XColor col;
774 Cursor c = 0;
776 x_catch_errors (dpy);
777 pix = XCreateBitmapFromData (dpy, FRAME_X_DISPLAY_INFO (f)->root_window,
778 no_data, 1, 1);
779 if (! x_had_errors_p (dpy) && pix != None)
781 Cursor pixc;
782 col.pixel = 0;
783 col.red = col.green = col.blue = 0;
784 col.flags = DoRed | DoGreen | DoBlue;
785 pixc = XCreatePixmapCursor (dpy, pix, pix, &col, &col, 0, 0);
786 if (! x_had_errors_p (dpy) && pixc != None)
787 c = pixc;
788 XFreePixmap (dpy, pix);
791 x_uncatch_errors ();
793 return c;
796 static void
797 x_set_mouse_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
799 struct x_output *x = f->output_data.x;
800 Display *dpy = FRAME_X_DISPLAY (f);
801 Cursor cursor, nontext_cursor, mode_cursor, hand_cursor;
802 Cursor hourglass_cursor, horizontal_drag_cursor;
803 unsigned long pixel = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
804 unsigned long mask_color = FRAME_BACKGROUND_PIXEL (f);
806 /* Don't let pointers be invisible. */
807 if (mask_color == pixel)
809 x_free_colors (f, &pixel, 1);
810 pixel = x_copy_color (f, FRAME_FOREGROUND_PIXEL (f));
813 unload_color (f, x->mouse_pixel);
814 x->mouse_pixel = pixel;
816 block_input ();
818 /* It's not okay to crash if the user selects a screwy cursor. */
819 x_catch_errors (dpy);
821 if (!NILP (Vx_pointer_shape))
823 CHECK_NUMBER (Vx_pointer_shape);
824 cursor = XCreateFontCursor (dpy, XINT (Vx_pointer_shape));
826 else
827 cursor = XCreateFontCursor (dpy, XC_xterm);
828 x_check_errors (dpy, "bad text pointer cursor: %s");
830 if (!NILP (Vx_nontext_pointer_shape))
832 CHECK_NUMBER (Vx_nontext_pointer_shape);
833 nontext_cursor
834 = XCreateFontCursor (dpy, XINT (Vx_nontext_pointer_shape));
836 else
837 nontext_cursor = XCreateFontCursor (dpy, XC_left_ptr);
838 x_check_errors (dpy, "bad nontext pointer cursor: %s");
840 if (!NILP (Vx_hourglass_pointer_shape))
842 CHECK_NUMBER (Vx_hourglass_pointer_shape);
843 hourglass_cursor
844 = XCreateFontCursor (dpy, XINT (Vx_hourglass_pointer_shape));
846 else
847 hourglass_cursor = XCreateFontCursor (dpy, XC_watch);
848 x_check_errors (dpy, "bad hourglass pointer cursor: %s");
850 if (!NILP (Vx_mode_pointer_shape))
852 CHECK_NUMBER (Vx_mode_pointer_shape);
853 mode_cursor = XCreateFontCursor (dpy, XINT (Vx_mode_pointer_shape));
855 else
856 mode_cursor = XCreateFontCursor (dpy, XC_xterm);
857 x_check_errors (dpy, "bad modeline pointer cursor: %s");
859 if (!NILP (Vx_sensitive_text_pointer_shape))
861 CHECK_NUMBER (Vx_sensitive_text_pointer_shape);
862 hand_cursor
863 = XCreateFontCursor (dpy, XINT (Vx_sensitive_text_pointer_shape));
865 else
866 hand_cursor = XCreateFontCursor (dpy, XC_hand2);
868 if (!NILP (Vx_window_horizontal_drag_shape))
870 CHECK_NUMBER (Vx_window_horizontal_drag_shape);
871 horizontal_drag_cursor
872 = XCreateFontCursor (dpy, XINT (Vx_window_horizontal_drag_shape));
874 else
875 horizontal_drag_cursor
876 = XCreateFontCursor (dpy, XC_sb_h_double_arrow);
878 /* Check and report errors with the above calls. */
879 x_check_errors (dpy, "can't set cursor shape: %s");
880 x_uncatch_errors ();
883 XColor fore_color, back_color;
885 fore_color.pixel = x->mouse_pixel;
886 x_query_color (f, &fore_color);
887 back_color.pixel = mask_color;
888 x_query_color (f, &back_color);
890 XRecolorCursor (dpy, cursor, &fore_color, &back_color);
891 XRecolorCursor (dpy, nontext_cursor, &fore_color, &back_color);
892 XRecolorCursor (dpy, mode_cursor, &fore_color, &back_color);
893 XRecolorCursor (dpy, hand_cursor, &fore_color, &back_color);
894 XRecolorCursor (dpy, hourglass_cursor, &fore_color, &back_color);
895 XRecolorCursor (dpy, horizontal_drag_cursor, &fore_color, &back_color);
898 if (FRAME_X_WINDOW (f) != 0)
899 XDefineCursor (dpy, FRAME_X_WINDOW (f),
900 f->output_data.x->current_cursor = cursor);
902 if (FRAME_X_DISPLAY_INFO (f)->invisible_cursor == 0)
903 FRAME_X_DISPLAY_INFO (f)->invisible_cursor = make_invisible_cursor (f);
905 if (cursor != x->text_cursor
906 && x->text_cursor != 0)
907 XFreeCursor (dpy, x->text_cursor);
908 x->text_cursor = cursor;
910 if (nontext_cursor != x->nontext_cursor
911 && x->nontext_cursor != 0)
912 XFreeCursor (dpy, x->nontext_cursor);
913 x->nontext_cursor = nontext_cursor;
915 if (hourglass_cursor != x->hourglass_cursor
916 && x->hourglass_cursor != 0)
917 XFreeCursor (dpy, x->hourglass_cursor);
918 x->hourglass_cursor = hourglass_cursor;
920 if (mode_cursor != x->modeline_cursor
921 && x->modeline_cursor != 0)
922 XFreeCursor (dpy, f->output_data.x->modeline_cursor);
923 x->modeline_cursor = mode_cursor;
925 if (hand_cursor != x->hand_cursor
926 && x->hand_cursor != 0)
927 XFreeCursor (dpy, x->hand_cursor);
928 x->hand_cursor = hand_cursor;
930 if (horizontal_drag_cursor != x->horizontal_drag_cursor
931 && x->horizontal_drag_cursor != 0)
932 XFreeCursor (dpy, x->horizontal_drag_cursor);
933 x->horizontal_drag_cursor = horizontal_drag_cursor;
935 XFlush (dpy);
936 unblock_input ();
938 update_face_from_frame_parameter (f, Qmouse_color, arg);
941 static void
942 x_set_cursor_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
944 unsigned long fore_pixel, pixel;
945 bool fore_pixel_allocated_p = 0, pixel_allocated_p = 0;
946 struct x_output *x = f->output_data.x;
948 if (!NILP (Vx_cursor_fore_pixel))
950 fore_pixel = x_decode_color (f, Vx_cursor_fore_pixel,
951 WHITE_PIX_DEFAULT (f));
952 fore_pixel_allocated_p = 1;
954 else
955 fore_pixel = FRAME_BACKGROUND_PIXEL (f);
957 pixel = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
958 pixel_allocated_p = 1;
960 /* Make sure that the cursor color differs from the background color. */
961 if (pixel == FRAME_BACKGROUND_PIXEL (f))
963 if (pixel_allocated_p)
965 x_free_colors (f, &pixel, 1);
966 pixel_allocated_p = 0;
969 pixel = x->mouse_pixel;
970 if (pixel == fore_pixel)
972 if (fore_pixel_allocated_p)
974 x_free_colors (f, &fore_pixel, 1);
975 fore_pixel_allocated_p = 0;
977 fore_pixel = FRAME_BACKGROUND_PIXEL (f);
981 unload_color (f, x->cursor_foreground_pixel);
982 if (!fore_pixel_allocated_p)
983 fore_pixel = x_copy_color (f, fore_pixel);
984 x->cursor_foreground_pixel = fore_pixel;
986 unload_color (f, x->cursor_pixel);
987 if (!pixel_allocated_p)
988 pixel = x_copy_color (f, pixel);
989 x->cursor_pixel = pixel;
991 if (FRAME_X_WINDOW (f) != 0)
993 block_input ();
994 XSetBackground (FRAME_X_DISPLAY (f), x->cursor_gc, x->cursor_pixel);
995 XSetForeground (FRAME_X_DISPLAY (f), x->cursor_gc, fore_pixel);
996 unblock_input ();
998 if (FRAME_VISIBLE_P (f))
1000 x_update_cursor (f, 0);
1001 x_update_cursor (f, 1);
1005 update_face_from_frame_parameter (f, Qcursor_color, arg);
1008 /* Set the border-color of frame F to pixel value PIX.
1009 Note that this does not fully take effect if done before
1010 F has an x-window. */
1012 static void
1013 x_set_border_pixel (struct frame *f, int pix)
1015 unload_color (f, f->output_data.x->border_pixel);
1016 f->output_data.x->border_pixel = pix;
1018 if (FRAME_X_WINDOW (f) != 0 && f->border_width > 0)
1020 block_input ();
1021 XSetWindowBorder (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), pix);
1022 unblock_input ();
1024 if (FRAME_VISIBLE_P (f))
1025 redraw_frame (f);
1029 /* Set the border-color of frame F to value described by ARG.
1030 ARG can be a string naming a color.
1031 The border-color is used for the border that is drawn by the X server.
1032 Note that this does not fully take effect if done before
1033 F has an x-window; it must be redone when the window is created.
1035 Note: this is done in two routines because of the way X10 works.
1037 Note: under X11, this is normally the province of the window manager,
1038 and so emacs' border colors may be overridden. */
1040 static void
1041 x_set_border_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
1043 int pix;
1045 CHECK_STRING (arg);
1046 pix = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
1047 x_set_border_pixel (f, pix);
1048 update_face_from_frame_parameter (f, Qborder_color, arg);
1052 static void
1053 x_set_cursor_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
1055 set_frame_cursor_types (f, arg);
1057 /* Make sure the cursor gets redrawn. */
1058 cursor_type_changed = 1;
1061 static void
1062 x_set_icon_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
1064 int result;
1066 if (STRINGP (arg))
1068 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
1069 return;
1071 else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
1072 return;
1074 block_input ();
1075 if (NILP (arg))
1076 result = x_text_icon (f,
1077 SSDATA ((!NILP (f->icon_name)
1078 ? f->icon_name
1079 : f->name)));
1080 else
1081 result = x_bitmap_icon (f, arg);
1083 if (result)
1085 unblock_input ();
1086 error ("No icon window available");
1089 XFlush (FRAME_X_DISPLAY (f));
1090 unblock_input ();
1093 static void
1094 x_set_icon_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
1096 int result;
1098 if (STRINGP (arg))
1100 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
1101 return;
1103 else if (!NILP (arg) || NILP (oldval))
1104 return;
1106 fset_icon_name (f, arg);
1108 if (f->output_data.x->icon_bitmap != 0)
1109 return;
1111 block_input ();
1113 result = x_text_icon (f,
1114 SSDATA ((!NILP (f->icon_name)
1115 ? f->icon_name
1116 : !NILP (f->title)
1117 ? f->title
1118 : f->name)));
1120 if (result)
1122 unblock_input ();
1123 error ("No icon window available");
1126 XFlush (FRAME_X_DISPLAY (f));
1127 unblock_input ();
1131 void
1132 x_set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
1134 int nlines;
1135 #if ! defined (USE_X_TOOLKIT) && ! defined (USE_GTK)
1136 int olines = FRAME_MENU_BAR_LINES (f);
1137 #endif
1139 /* Right now, menu bars don't work properly in minibuf-only frames;
1140 most of the commands try to apply themselves to the minibuffer
1141 frame itself, and get an error because you can't switch buffers
1142 in or split the minibuffer window. */
1143 if (FRAME_MINIBUF_ONLY_P (f))
1144 return;
1146 if (TYPE_RANGED_INTEGERP (int, value))
1147 nlines = XINT (value);
1148 else
1149 nlines = 0;
1151 /* Make sure we redisplay all windows in this frame. */
1152 windows_or_buffers_changed++;
1154 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
1155 FRAME_MENU_BAR_LINES (f) = 0;
1156 if (nlines)
1158 FRAME_EXTERNAL_MENU_BAR (f) = 1;
1159 if (FRAME_X_P (f) && f->output_data.x->menubar_widget == 0)
1160 /* Make sure next redisplay shows the menu bar. */
1161 XWINDOW (FRAME_SELECTED_WINDOW (f))->update_mode_line = 1;
1163 else
1165 if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
1166 free_frame_menubar (f);
1167 FRAME_EXTERNAL_MENU_BAR (f) = 0;
1168 if (FRAME_X_P (f))
1169 f->output_data.x->menubar_widget = 0;
1171 #else /* not USE_X_TOOLKIT && not USE_GTK */
1172 FRAME_MENU_BAR_LINES (f) = nlines;
1173 resize_frame_windows (f, FRAME_LINES (f), 0);
1175 /* If the menu bar height gets changed, the internal border below
1176 the top margin has to be cleared. Also, if the menu bar gets
1177 larger, the area for the added lines has to be cleared except for
1178 the first menu bar line that is to be drawn later. */
1179 if (nlines != olines)
1181 int height = FRAME_INTERNAL_BORDER_WIDTH (f);
1182 int width = FRAME_PIXEL_WIDTH (f);
1183 int y;
1185 /* height can be zero here. */
1186 if (height > 0 && width > 0)
1188 y = FRAME_TOP_MARGIN_HEIGHT (f);
1190 block_input ();
1191 x_clear_area (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1192 0, y, width, height, False);
1193 unblock_input ();
1196 if (nlines > 1 && nlines > olines)
1198 y = (olines == 0 ? 1 : olines) * FRAME_LINE_HEIGHT (f);
1199 height = nlines * FRAME_LINE_HEIGHT (f) - y;
1201 block_input ();
1202 x_clear_area (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1203 0, y, width, height, False);
1204 unblock_input ();
1207 if (nlines == 0 && WINDOWP (f->menu_bar_window))
1208 clear_glyph_matrix (XWINDOW (f->menu_bar_window)->current_matrix);
1210 #endif /* not USE_X_TOOLKIT && not USE_GTK */
1211 adjust_glyphs (f);
1212 run_window_configuration_change_hook (f);
1216 /* Set the number of lines used for the tool bar of frame F to VALUE.
1217 VALUE not an integer, or < 0 means set the lines to zero. OLDVAL
1218 is the old number of tool bar lines. This function changes the
1219 height of all windows on frame F to match the new tool bar height.
1220 The frame's height doesn't change. */
1222 void
1223 x_set_tool_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
1225 int delta, nlines, root_height;
1226 Lisp_Object root_window;
1228 /* Treat tool bars like menu bars. */
1229 if (FRAME_MINIBUF_ONLY_P (f))
1230 return;
1232 /* Use VALUE only if an int >= 0. */
1233 if (RANGED_INTEGERP (0, value, INT_MAX))
1234 nlines = XFASTINT (value);
1235 else
1236 nlines = 0;
1238 #ifdef USE_GTK
1239 FRAME_TOOL_BAR_LINES (f) = 0;
1240 if (nlines)
1242 FRAME_EXTERNAL_TOOL_BAR (f) = 1;
1243 if (FRAME_X_P (f) && f->output_data.x->toolbar_widget == 0)
1244 /* Make sure next redisplay shows the tool bar. */
1245 XWINDOW (FRAME_SELECTED_WINDOW (f))->update_mode_line = 1;
1246 update_frame_tool_bar (f);
1248 else
1250 if (FRAME_EXTERNAL_TOOL_BAR (f))
1251 free_frame_tool_bar (f);
1252 FRAME_EXTERNAL_TOOL_BAR (f) = 0;
1255 return;
1256 #endif
1258 /* Make sure we redisplay all windows in this frame. */
1259 ++windows_or_buffers_changed;
1261 delta = nlines - FRAME_TOOL_BAR_LINES (f);
1263 /* Don't resize the tool-bar to more than we have room for. */
1264 root_window = FRAME_ROOT_WINDOW (f);
1265 root_height = WINDOW_TOTAL_LINES (XWINDOW (root_window));
1266 if (root_height - delta < 1)
1268 delta = root_height - 1;
1269 nlines = FRAME_TOOL_BAR_LINES (f) + delta;
1272 FRAME_TOOL_BAR_LINES (f) = nlines;
1273 resize_frame_windows (f, FRAME_LINES (f), 0);
1274 adjust_glyphs (f);
1276 /* We also have to make sure that the internal border at the top of
1277 the frame, below the menu bar or tool bar, is redrawn when the
1278 tool bar disappears. This is so because the internal border is
1279 below the tool bar if one is displayed, but is below the menu bar
1280 if there isn't a tool bar. The tool bar draws into the area
1281 below the menu bar. */
1282 if (FRAME_X_WINDOW (f) && FRAME_TOOL_BAR_LINES (f) == 0)
1284 clear_frame (f);
1285 clear_current_matrices (f);
1288 /* If the tool bar gets smaller, the internal border below it
1289 has to be cleared. It was formerly part of the display
1290 of the larger tool bar, and updating windows won't clear it. */
1291 if (delta < 0)
1293 int height = FRAME_INTERNAL_BORDER_WIDTH (f);
1294 int width = FRAME_PIXEL_WIDTH (f);
1295 int y = (FRAME_MENU_BAR_LINES (f) + nlines) * FRAME_LINE_HEIGHT (f);
1297 /* height can be zero here. */
1298 if (height > 0 && width > 0)
1300 block_input ();
1301 x_clear_area (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1302 0, y, width, height, False);
1303 unblock_input ();
1306 if (WINDOWP (f->tool_bar_window))
1307 clear_glyph_matrix (XWINDOW (f->tool_bar_window)->current_matrix);
1310 run_window_configuration_change_hook (f);
1315 /* Set the foreground color for scroll bars on frame F to VALUE.
1316 VALUE should be a string, a color name. If it isn't a string or
1317 isn't a valid color name, do nothing. OLDVAL is the old value of
1318 the frame parameter. */
1320 static void
1321 x_set_scroll_bar_foreground (struct frame *f, Lisp_Object value, Lisp_Object oldval)
1323 unsigned long pixel;
1325 if (STRINGP (value))
1326 pixel = x_decode_color (f, value, BLACK_PIX_DEFAULT (f));
1327 else
1328 pixel = -1;
1330 if (f->output_data.x->scroll_bar_foreground_pixel != -1)
1331 unload_color (f, f->output_data.x->scroll_bar_foreground_pixel);
1333 f->output_data.x->scroll_bar_foreground_pixel = pixel;
1334 if (FRAME_X_WINDOW (f) && FRAME_VISIBLE_P (f))
1336 /* Remove all scroll bars because they have wrong colors. */
1337 if (FRAME_TERMINAL (f)->condemn_scroll_bars_hook)
1338 (*FRAME_TERMINAL (f)->condemn_scroll_bars_hook) (f);
1339 if (FRAME_TERMINAL (f)->judge_scroll_bars_hook)
1340 (*FRAME_TERMINAL (f)->judge_scroll_bars_hook) (f);
1342 update_face_from_frame_parameter (f, Qscroll_bar_foreground, value);
1343 redraw_frame (f);
1348 /* Set the background color for scroll bars on frame F to VALUE VALUE
1349 should be a string, a color name. If it isn't a string or isn't a
1350 valid color name, do nothing. OLDVAL is the old value of the frame
1351 parameter. */
1353 static void
1354 x_set_scroll_bar_background (struct frame *f, Lisp_Object value, Lisp_Object oldval)
1356 unsigned long pixel;
1358 if (STRINGP (value))
1359 pixel = x_decode_color (f, value, WHITE_PIX_DEFAULT (f));
1360 else
1361 pixel = -1;
1363 if (f->output_data.x->scroll_bar_background_pixel != -1)
1364 unload_color (f, f->output_data.x->scroll_bar_background_pixel);
1366 #ifdef USE_TOOLKIT_SCROLL_BARS
1367 /* Scrollbar shadow colors. */
1368 if (f->output_data.x->scroll_bar_top_shadow_pixel != -1)
1370 unload_color (f, f->output_data.x->scroll_bar_top_shadow_pixel);
1371 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
1373 if (f->output_data.x->scroll_bar_bottom_shadow_pixel != -1)
1375 unload_color (f, f->output_data.x->scroll_bar_bottom_shadow_pixel);
1376 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
1378 #endif /* USE_TOOLKIT_SCROLL_BARS */
1380 f->output_data.x->scroll_bar_background_pixel = pixel;
1381 if (FRAME_X_WINDOW (f) && FRAME_VISIBLE_P (f))
1383 /* Remove all scroll bars because they have wrong colors. */
1384 if (FRAME_TERMINAL (f)->condemn_scroll_bars_hook)
1385 (*FRAME_TERMINAL (f)->condemn_scroll_bars_hook) (f);
1386 if (FRAME_TERMINAL (f)->judge_scroll_bars_hook)
1387 (*FRAME_TERMINAL (f)->judge_scroll_bars_hook) (f);
1389 update_face_from_frame_parameter (f, Qscroll_bar_background, value);
1390 redraw_frame (f);
1395 /* Encode Lisp string STRING as a text in a format appropriate for
1396 XICCC (X Inter Client Communication Conventions).
1398 This can call Lisp code, so callers must GCPRO.
1400 If STRING contains only ASCII characters, do no conversion and
1401 return the string data of STRING. Otherwise, encode the text by
1402 CODING_SYSTEM, and return a newly allocated memory area which
1403 should be freed by `xfree' by a caller.
1405 SELECTIONP non-zero means the string is being encoded for an X
1406 selection, so it is safe to run pre-write conversions (which
1407 may run Lisp code).
1409 Store the byte length of resulting text in *TEXT_BYTES.
1411 If the text contains only ASCII and Latin-1, store 1 in *STRING_P,
1412 which means that the `encoding' of the result can be `STRING'.
1413 Otherwise store 0 in *STRINGP, which means that the `encoding' of
1414 the result should be `COMPOUND_TEXT'. */
1416 static unsigned char *
1417 x_encode_text (Lisp_Object string, Lisp_Object coding_system, int selectionp,
1418 ptrdiff_t *text_bytes, int *stringp, int *freep)
1420 int result = string_xstring_p (string);
1421 struct coding_system coding;
1423 if (result == 0)
1425 /* No multibyte character in OBJ. We need not encode it. */
1426 *text_bytes = SBYTES (string);
1427 *stringp = 1;
1428 *freep = 0;
1429 return SDATA (string);
1432 setup_coding_system (coding_system, &coding);
1433 coding.mode |= (CODING_MODE_SAFE_ENCODING | CODING_MODE_LAST_BLOCK);
1434 /* We suppress producing escape sequences for composition. */
1435 coding.common_flags &= ~CODING_ANNOTATION_MASK;
1436 coding.destination = xnmalloc (SCHARS (string), 2);
1437 coding.dst_bytes = SCHARS (string) * 2;
1438 encode_coding_object (&coding, string, 0, 0,
1439 SCHARS (string), SBYTES (string), Qnil);
1440 *text_bytes = coding.produced;
1441 *stringp = (result == 1 || !EQ (coding_system, Qcompound_text));
1442 *freep = 1;
1443 return coding.destination;
1447 /* Set the WM name to NAME for frame F. Also set the icon name.
1448 If the frame already has an icon name, use that, otherwise set the
1449 icon name to NAME. */
1451 static void
1452 x_set_name_internal (struct frame *f, Lisp_Object name)
1454 if (FRAME_X_WINDOW (f))
1456 block_input ();
1458 XTextProperty text, icon;
1459 ptrdiff_t bytes;
1460 int stringp;
1461 int do_free_icon_value = 0, do_free_text_value = 0;
1462 Lisp_Object coding_system;
1463 Lisp_Object encoded_name;
1464 Lisp_Object encoded_icon_name;
1465 struct gcpro gcpro1;
1467 /* As ENCODE_UTF_8 may cause GC and relocation of string data,
1468 we use it before x_encode_text that may return string data. */
1469 GCPRO1 (name);
1470 encoded_name = ENCODE_UTF_8 (name);
1471 UNGCPRO;
1473 coding_system = Qcompound_text;
1474 /* Note: Encoding strategy
1476 We encode NAME by compound-text and use "COMPOUND-TEXT" in
1477 text.encoding. But, there are non-internationalized window
1478 managers which don't support that encoding. So, if NAME
1479 contains only ASCII and 8859-1 characters, encode it by
1480 iso-latin-1, and use "STRING" in text.encoding hoping that
1481 such window managers at least analyze this format correctly,
1482 i.e. treat 8-bit bytes as 8859-1 characters.
1484 We may also be able to use "UTF8_STRING" in text.encoding
1485 in the future which can encode all Unicode characters.
1486 But, for the moment, there's no way to know that the
1487 current window manager supports it or not.
1489 Either way, we also set the _NET_WM_NAME and _NET_WM_ICON_NAME
1490 properties. Per the EWMH specification, those two properties
1491 are always UTF8_STRING. This matches what gtk_window_set_title()
1492 does in the USE_GTK case. */
1493 text.value = x_encode_text (name, coding_system, 0, &bytes, &stringp,
1494 &do_free_text_value);
1495 text.encoding = (stringp ? XA_STRING
1496 : FRAME_X_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
1497 text.format = 8;
1498 text.nitems = bytes;
1499 if (text.nitems != bytes)
1500 error ("Window name too large");
1502 if (!STRINGP (f->icon_name))
1504 icon = text;
1505 encoded_icon_name = encoded_name;
1507 else
1509 /* See the above comment "Note: Encoding strategy". */
1510 icon.value = x_encode_text (f->icon_name, coding_system, 0,
1511 &bytes, &stringp, &do_free_icon_value);
1512 icon.encoding = (stringp ? XA_STRING
1513 : FRAME_X_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
1514 icon.format = 8;
1515 icon.nitems = bytes;
1516 if (icon.nitems != bytes)
1517 error ("Icon name too large");
1519 encoded_icon_name = ENCODE_UTF_8 (f->icon_name);
1522 #ifdef USE_GTK
1523 gtk_window_set_title (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)),
1524 SSDATA (encoded_name));
1525 #else /* not USE_GTK */
1526 XSetWMName (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &text);
1527 XChangeProperty (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f),
1528 FRAME_X_DISPLAY_INFO (f)->Xatom_net_wm_name,
1529 FRAME_X_DISPLAY_INFO (f)->Xatom_UTF8_STRING,
1530 8, PropModeReplace,
1531 SDATA (encoded_name),
1532 SBYTES (encoded_name));
1533 #endif /* not USE_GTK */
1535 XSetWMIconName (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &icon);
1536 XChangeProperty (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f),
1537 FRAME_X_DISPLAY_INFO (f)->Xatom_net_wm_icon_name,
1538 FRAME_X_DISPLAY_INFO (f)->Xatom_UTF8_STRING,
1539 8, PropModeReplace,
1540 SDATA (encoded_icon_name),
1541 SBYTES (encoded_icon_name));
1543 if (do_free_icon_value)
1544 xfree (icon.value);
1545 if (do_free_text_value)
1546 xfree (text.value);
1548 unblock_input ();
1552 /* Change the name of frame F to NAME. If NAME is nil, set F's name to
1553 x_id_name.
1555 If EXPLICIT is non-zero, that indicates that lisp code is setting the
1556 name; if NAME is a string, set F's name to NAME and set
1557 F->explicit_name; if NAME is Qnil, then clear F->explicit_name.
1559 If EXPLICIT is zero, that indicates that Emacs redisplay code is
1560 suggesting a new name, which lisp code should override; if
1561 F->explicit_name is set, ignore the new name; otherwise, set it. */
1563 static void
1564 x_set_name (struct frame *f, Lisp_Object name, int explicit)
1566 /* Make sure that requests from lisp code override requests from
1567 Emacs redisplay code. */
1568 if (explicit)
1570 /* If we're switching from explicit to implicit, we had better
1571 update the mode lines and thereby update the title. */
1572 if (f->explicit_name && NILP (name))
1573 update_mode_lines = 1;
1575 f->explicit_name = ! NILP (name);
1577 else if (f->explicit_name)
1578 return;
1580 /* If NAME is nil, set the name to the x_id_name. */
1581 if (NILP (name))
1583 /* Check for no change needed in this very common case
1584 before we do any consing. */
1585 if (!strcmp (FRAME_X_DISPLAY_INFO (f)->x_id_name,
1586 SSDATA (f->name)))
1587 return;
1588 name = build_string (FRAME_X_DISPLAY_INFO (f)->x_id_name);
1590 else
1591 CHECK_STRING (name);
1593 /* Don't change the name if it's already NAME. */
1594 if (! NILP (Fstring_equal (name, f->name)))
1595 return;
1597 fset_name (f, name);
1599 /* For setting the frame title, the title parameter should override
1600 the name parameter. */
1601 if (! NILP (f->title))
1602 name = f->title;
1604 x_set_name_internal (f, name);
1607 /* This function should be called when the user's lisp code has
1608 specified a name for the frame; the name will override any set by the
1609 redisplay code. */
1610 static void
1611 x_explicitly_set_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
1613 x_set_name (f, arg, 1);
1616 /* This function should be called by Emacs redisplay code to set the
1617 name; names set this way will never override names set by the user's
1618 lisp code. */
1619 void
1620 x_implicitly_set_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
1622 x_set_name (f, arg, 0);
1625 /* Change the title of frame F to NAME.
1626 If NAME is nil, use the frame name as the title. */
1628 static void
1629 x_set_title (struct frame *f, Lisp_Object name, Lisp_Object old_name)
1631 /* Don't change the title if it's already NAME. */
1632 if (EQ (name, f->title))
1633 return;
1635 update_mode_lines = 1;
1637 fset_title (f, name);
1639 if (NILP (name))
1640 name = f->name;
1641 else
1642 CHECK_STRING (name);
1644 x_set_name_internal (f, name);
1647 void
1648 x_set_scroll_bar_default_width (struct frame *f)
1650 int wid = FRAME_COLUMN_WIDTH (f);
1651 #ifdef USE_TOOLKIT_SCROLL_BARS
1652 #ifdef USE_GTK
1653 int minw = xg_get_default_scrollbar_width ();
1654 #else
1655 int minw = 16;
1656 #endif
1657 /* A minimum width of 14 doesn't look good for toolkit scroll bars. */
1658 int width = minw + 2 * VERTICAL_SCROLL_BAR_WIDTH_TRIM;
1659 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (width + wid - 1) / wid;
1660 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = width;
1661 #else
1662 /* Make the actual width at least 14 pixels and a multiple of a
1663 character width. */
1664 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (14 + wid - 1) / wid;
1666 /* Use all of that space (aside from required margins) for the
1667 scroll bar. */
1668 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = 0;
1669 #endif
1673 /* Record in frame F the specified or default value according to ALIST
1674 of the parameter named PROP (a Lisp symbol). If no value is
1675 specified for PROP, look for an X default for XPROP on the frame
1676 named NAME. If that is not found either, use the value DEFLT. */
1678 static Lisp_Object
1679 x_default_scroll_bar_color_parameter (struct frame *f,
1680 Lisp_Object alist, Lisp_Object prop,
1681 const char *xprop, const char *xclass,
1682 int foreground_p)
1684 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
1685 Lisp_Object tem;
1687 tem = x_get_arg (dpyinfo, alist, prop, xprop, xclass, RES_TYPE_STRING);
1688 if (EQ (tem, Qunbound))
1690 #ifdef USE_TOOLKIT_SCROLL_BARS
1692 /* See if an X resource for the scroll bar color has been
1693 specified. */
1694 tem = display_x_get_resource (dpyinfo,
1695 build_string (foreground_p
1696 ? "foreground"
1697 : "background"),
1698 empty_unibyte_string,
1699 build_string ("verticalScrollBar"),
1700 empty_unibyte_string);
1701 if (!STRINGP (tem))
1703 /* If nothing has been specified, scroll bars will use a
1704 toolkit-dependent default. Because these defaults are
1705 difficult to get at without actually creating a scroll
1706 bar, use nil to indicate that no color has been
1707 specified. */
1708 tem = Qnil;
1711 #else /* not USE_TOOLKIT_SCROLL_BARS */
1713 tem = Qnil;
1715 #endif /* not USE_TOOLKIT_SCROLL_BARS */
1718 x_set_frame_parameters (f, list1 (Fcons (prop, tem)));
1719 return tem;
1725 #ifdef USE_X_TOOLKIT
1727 /* If the WM_PROTOCOLS property does not already contain WM_TAKE_FOCUS,
1728 WM_DELETE_WINDOW, and WM_SAVE_YOURSELF, then add them. (They may
1729 already be present because of the toolkit (Motif adds some of them,
1730 for example, but Xt doesn't). */
1732 static void
1733 hack_wm_protocols (struct frame *f, Widget widget)
1735 Display *dpy = XtDisplay (widget);
1736 Window w = XtWindow (widget);
1737 int need_delete = 1;
1738 int need_focus = 1;
1739 int need_save = 1;
1741 block_input ();
1743 Atom type;
1744 unsigned char *catoms;
1745 int format = 0;
1746 unsigned long nitems = 0;
1747 unsigned long bytes_after;
1749 if ((XGetWindowProperty (dpy, w,
1750 FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
1751 (long)0, (long)100, False, XA_ATOM,
1752 &type, &format, &nitems, &bytes_after,
1753 &catoms)
1754 == Success)
1755 && format == 32 && type == XA_ATOM)
1757 Atom *atoms = (Atom *) catoms;
1758 while (nitems > 0)
1760 nitems--;
1761 if (atoms[nitems]
1762 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window)
1763 need_delete = 0;
1764 else if (atoms[nitems]
1765 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_take_focus)
1766 need_focus = 0;
1767 else if (atoms[nitems]
1768 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself)
1769 need_save = 0;
1772 if (catoms)
1773 XFree (catoms);
1776 Atom props [10];
1777 int count = 0;
1778 if (need_delete)
1779 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window;
1780 if (need_focus)
1781 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_take_focus;
1782 if (need_save)
1783 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself;
1784 if (count)
1785 XChangeProperty (dpy, w, FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
1786 XA_ATOM, 32, PropModeAppend,
1787 (unsigned char *) props, count);
1789 unblock_input ();
1791 #endif
1795 /* Support routines for XIC (X Input Context). */
1797 #ifdef HAVE_X_I18N
1799 static XFontSet xic_create_xfontset (struct frame *);
1800 static XIMStyle best_xim_style (XIMStyles *, XIMStyles *);
1803 /* Supported XIM styles, ordered by preference. */
1805 static XIMStyle supported_xim_styles[] =
1807 XIMPreeditPosition | XIMStatusArea,
1808 XIMPreeditPosition | XIMStatusNothing,
1809 XIMPreeditPosition | XIMStatusNone,
1810 XIMPreeditNothing | XIMStatusArea,
1811 XIMPreeditNothing | XIMStatusNothing,
1812 XIMPreeditNothing | XIMStatusNone,
1813 XIMPreeditNone | XIMStatusArea,
1814 XIMPreeditNone | XIMStatusNothing,
1815 XIMPreeditNone | XIMStatusNone,
1820 #if defined HAVE_X_WINDOWS && defined USE_X_TOOLKIT
1821 /* Create an X fontset on frame F with base font name BASE_FONTNAME. */
1823 static const char xic_default_fontset[] = "-*-*-*-r-normal--14-*-*-*-*-*-*-*";
1825 /* Create an Xt fontset spec from the name of a base font.
1826 If `motif' is True use the Motif syntax. */
1827 char *
1828 xic_create_fontsetname (const char *base_fontname, int motif)
1830 const char *sep = motif ? ";" : ",";
1831 char *fontsetname;
1833 /* Make a fontset name from the base font name. */
1834 if (xic_default_fontset == base_fontname)
1836 /* There is no base font name, use the default. */
1837 fontsetname = xmalloc (strlen (base_fontname) + 2);
1838 strcpy (fontsetname, base_fontname);
1840 else
1842 /* Make a fontset name from the base font name.
1843 The font set will be made of the following elements:
1844 - the base font.
1845 - the base font where the charset spec is replaced by -*-*.
1846 - the same but with the family also replaced with -*-*-. */
1847 const char *p = base_fontname;
1848 ptrdiff_t i;
1850 for (i = 0; *p; p++)
1851 if (*p == '-') i++;
1852 if (i != 14)
1854 /* As the font name doesn't conform to XLFD, we can't
1855 modify it to generalize it to allcs and allfamilies.
1856 Use the specified font plus the default. */
1857 fontsetname = xmalloc (strlen (base_fontname)
1858 + strlen (xic_default_fontset) + 3);
1859 strcpy (fontsetname, base_fontname);
1860 strcat (fontsetname, sep);
1861 strcat (fontsetname, xic_default_fontset);
1863 else
1865 ptrdiff_t len;
1866 const char *p1 = NULL, *p2 = NULL, *p3 = NULL;
1867 char *font_allcs = NULL;
1868 char *font_allfamilies = NULL;
1869 char *font_all = NULL;
1870 const char *allcs = "*-*-*-*-*-*-*";
1871 const char *allfamilies = "-*-*-";
1872 const char *all = "*-*-*-*-";
1873 char *base;
1875 for (i = 0, p = base_fontname; i < 8; p++)
1877 if (*p == '-')
1879 i++;
1880 if (i == 3)
1881 p1 = p + 1;
1882 else if (i == 7)
1883 p2 = p + 1;
1884 else if (i == 6)
1885 p3 = p + 1;
1888 /* If base_fontname specifies ADSTYLE, make it a
1889 wildcard. */
1890 if (*p3 != '*')
1892 ptrdiff_t diff = (p2 - p3) - 2;
1894 base = alloca (strlen (base_fontname) + 1);
1895 memcpy (base, base_fontname, p3 - base_fontname);
1896 base[p3 - base_fontname] = '*';
1897 base[(p3 - base_fontname) + 1] = '-';
1898 strcpy (base + (p3 - base_fontname) + 2, p2);
1899 p = base + (p - base_fontname) - diff;
1900 p1 = base + (p1 - base_fontname);
1901 p2 = base + (p2 - base_fontname) - diff;
1902 base_fontname = base;
1905 /* Build the font spec that matches all charsets. */
1906 len = p - base_fontname + strlen (allcs) + 1;
1907 font_allcs = alloca (len);
1908 memcpy (font_allcs, base_fontname, p - base_fontname);
1909 strcat (font_allcs, allcs);
1911 /* Build the font spec that matches all families and
1912 add-styles. */
1913 len = p - p1 + strlen (allcs) + strlen (allfamilies) + 1;
1914 font_allfamilies = alloca (len);
1915 strcpy (font_allfamilies, allfamilies);
1916 memcpy (font_allfamilies + strlen (allfamilies), p1, p - p1);
1917 strcat (font_allfamilies, allcs);
1919 /* Build the font spec that matches all. */
1920 len = p - p2 + strlen (allcs) + strlen (all) + strlen (allfamilies) + 1;
1921 font_all = alloca (len);
1922 strcpy (font_all, allfamilies);
1923 strcat (font_all, all);
1924 memcpy (font_all + strlen (all) + strlen (allfamilies), p2, p - p2);
1925 strcat (font_all, allcs);
1927 /* Build the actual font set name. */
1928 len = strlen (base_fontname) + strlen (font_allcs)
1929 + strlen (font_allfamilies) + strlen (font_all) + 5;
1930 fontsetname = xmalloc (len);
1931 strcpy (fontsetname, base_fontname);
1932 strcat (fontsetname, sep);
1933 strcat (fontsetname, font_allcs);
1934 strcat (fontsetname, sep);
1935 strcat (fontsetname, font_allfamilies);
1936 strcat (fontsetname, sep);
1937 strcat (fontsetname, font_all);
1940 if (motif)
1941 strcat (fontsetname, ":");
1942 return fontsetname;
1944 #endif /* HAVE_X_WINDOWS && USE_X_TOOLKIT */
1946 #ifdef DEBUG_XIC_FONTSET
1947 static void
1948 print_fontset_result (XFontSet xfs, char *name, char **missing_list,
1949 int missing_count)
1951 if (xfs)
1952 fprintf (stderr, "XIC Fontset created: %s\n", name);
1953 else
1955 fprintf (stderr, "XIC Fontset failed: %s\n", name);
1956 while (missing_count-- > 0)
1958 fprintf (stderr, " missing: %s\n", *missing_list);
1959 missing_list++;
1964 #endif
1966 static XFontSet
1967 xic_create_xfontset (struct frame *f)
1969 XFontSet xfs = NULL;
1970 struct font *font = FRAME_FONT (f);
1971 int pixel_size = font->pixel_size;
1972 Lisp_Object rest, frame;
1974 /* See if there is another frame already using same fontset. */
1975 FOR_EACH_FRAME (rest, frame)
1977 struct frame *cf = XFRAME (frame);
1979 if (cf != f && FRAME_LIVE_P (f) && FRAME_X_P (cf)
1980 && FRAME_X_DISPLAY_INFO (cf) == FRAME_X_DISPLAY_INFO (f)
1981 && FRAME_FONT (f)
1982 && FRAME_FONT (f)->pixel_size == pixel_size)
1984 xfs = FRAME_XIC_FONTSET (cf);
1985 break;
1989 if (! xfs)
1991 char buf[256];
1992 char **missing_list;
1993 int missing_count;
1994 char *def_string;
1995 const char *xlfd_format = "-*-*-medium-r-normal--%d-*-*-*-*-*";
1997 sprintf (buf, xlfd_format, pixel_size);
1998 missing_list = NULL;
1999 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), buf,
2000 &missing_list, &missing_count, &def_string);
2001 #ifdef DEBUG_XIC_FONTSET
2002 print_fontset_result (xfs, buf, missing_list, missing_count);
2003 #endif
2004 if (missing_list)
2005 XFreeStringList (missing_list);
2006 if (! xfs)
2008 /* List of pixel sizes most likely available. Find one that
2009 is closest to pixel_size. */
2010 int sizes[] = {0, 8, 10, 11, 12, 14, 17, 18, 20, 24, 26, 34, 0};
2011 int *smaller, *larger;
2013 for (smaller = sizes; smaller[1]; smaller++)
2014 if (smaller[1] >= pixel_size)
2015 break;
2016 larger = smaller + 1;
2017 if (*larger == pixel_size)
2018 larger++;
2019 while (*smaller || *larger)
2021 int this_size;
2023 if (! *larger)
2024 this_size = *smaller--;
2025 else if (! *smaller)
2026 this_size = *larger++;
2027 else if (pixel_size - *smaller < *larger - pixel_size)
2028 this_size = *smaller--;
2029 else
2030 this_size = *larger++;
2031 sprintf (buf, xlfd_format, this_size);
2032 missing_list = NULL;
2033 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), buf,
2034 &missing_list, &missing_count, &def_string);
2035 #ifdef DEBUG_XIC_FONTSET
2036 print_fontset_result (xfs, buf, missing_list, missing_count);
2037 #endif
2038 if (missing_list)
2039 XFreeStringList (missing_list);
2040 if (xfs)
2041 break;
2044 if (! xfs)
2046 const char *last_resort = "-*-*-*-r-normal--*-*-*-*-*-*";
2048 missing_list = NULL;
2049 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), last_resort,
2050 &missing_list, &missing_count, &def_string);
2051 #ifdef DEBUG_XIC_FONTSET
2052 print_fontset_result (xfs, last_resort, missing_list, missing_count);
2053 #endif
2054 if (missing_list)
2055 XFreeStringList (missing_list);
2060 return xfs;
2063 /* Free the X fontset of frame F if it is the last frame using it. */
2065 void
2066 xic_free_xfontset (struct frame *f)
2068 Lisp_Object rest, frame;
2069 bool shared_p = 0;
2071 if (!FRAME_XIC_FONTSET (f))
2072 return;
2074 /* See if there is another frame sharing the same fontset. */
2075 FOR_EACH_FRAME (rest, frame)
2077 struct frame *cf = XFRAME (frame);
2078 if (cf != f && FRAME_LIVE_P (f) && FRAME_X_P (cf)
2079 && FRAME_X_DISPLAY_INFO (cf) == FRAME_X_DISPLAY_INFO (f)
2080 && FRAME_XIC_FONTSET (cf) == FRAME_XIC_FONTSET (f))
2082 shared_p = 1;
2083 break;
2087 if (!shared_p)
2088 /* The fontset is not used anymore. It is safe to free it. */
2089 XFreeFontSet (FRAME_X_DISPLAY (f), FRAME_XIC_FONTSET (f));
2091 FRAME_XIC_FONTSET (f) = NULL;
2095 /* Value is the best input style, given user preferences USER (already
2096 checked to be supported by Emacs), and styles supported by the
2097 input method XIM. */
2099 static XIMStyle
2100 best_xim_style (XIMStyles *user, XIMStyles *xim)
2102 int i, j;
2104 for (i = 0; i < user->count_styles; ++i)
2105 for (j = 0; j < xim->count_styles; ++j)
2106 if (user->supported_styles[i] == xim->supported_styles[j])
2107 return user->supported_styles[i];
2109 /* Return the default style. */
2110 return XIMPreeditNothing | XIMStatusNothing;
2113 /* Create XIC for frame F. */
2115 static XIMStyle xic_style;
2117 void
2118 create_frame_xic (struct frame *f)
2120 XIM xim;
2121 XIC xic = NULL;
2122 XFontSet xfs = NULL;
2124 if (FRAME_XIC (f))
2125 return;
2127 /* Create X fontset. */
2128 xfs = xic_create_xfontset (f);
2129 xim = FRAME_X_XIM (f);
2130 if (xim)
2132 XRectangle s_area;
2133 XPoint spot;
2134 XVaNestedList preedit_attr;
2135 XVaNestedList status_attr;
2137 s_area.x = 0; s_area.y = 0; s_area.width = 1; s_area.height = 1;
2138 spot.x = 0; spot.y = 1;
2140 /* Determine XIC style. */
2141 if (xic_style == 0)
2143 XIMStyles supported_list;
2144 supported_list.count_styles = (sizeof supported_xim_styles
2145 / sizeof supported_xim_styles[0]);
2146 supported_list.supported_styles = supported_xim_styles;
2147 xic_style = best_xim_style (&supported_list,
2148 FRAME_X_XIM_STYLES (f));
2151 preedit_attr = XVaCreateNestedList (0,
2152 XNFontSet, xfs,
2153 XNForeground,
2154 FRAME_FOREGROUND_PIXEL (f),
2155 XNBackground,
2156 FRAME_BACKGROUND_PIXEL (f),
2157 (xic_style & XIMPreeditPosition
2158 ? XNSpotLocation
2159 : NULL),
2160 &spot,
2161 NULL);
2162 status_attr = XVaCreateNestedList (0,
2163 XNArea,
2164 &s_area,
2165 XNFontSet,
2166 xfs,
2167 XNForeground,
2168 FRAME_FOREGROUND_PIXEL (f),
2169 XNBackground,
2170 FRAME_BACKGROUND_PIXEL (f),
2171 NULL);
2173 xic = XCreateIC (xim,
2174 XNInputStyle, xic_style,
2175 XNClientWindow, FRAME_X_WINDOW (f),
2176 XNFocusWindow, FRAME_X_WINDOW (f),
2177 XNStatusAttributes, status_attr,
2178 XNPreeditAttributes, preedit_attr,
2179 NULL);
2180 XFree (preedit_attr);
2181 XFree (status_attr);
2184 FRAME_XIC (f) = xic;
2185 FRAME_XIC_STYLE (f) = xic_style;
2186 FRAME_XIC_FONTSET (f) = xfs;
2190 /* Destroy XIC and free XIC fontset of frame F, if any. */
2192 void
2193 free_frame_xic (struct frame *f)
2195 if (FRAME_XIC (f) == NULL)
2196 return;
2198 XDestroyIC (FRAME_XIC (f));
2199 xic_free_xfontset (f);
2201 FRAME_XIC (f) = NULL;
2205 /* Place preedit area for XIC of window W's frame to specified
2206 pixel position X/Y. X and Y are relative to window W. */
2208 void
2209 xic_set_preeditarea (struct window *w, int x, int y)
2211 struct frame *f = XFRAME (w->frame);
2212 XVaNestedList attr;
2213 XPoint spot;
2215 spot.x = WINDOW_TO_FRAME_PIXEL_X (w, x) + WINDOW_LEFT_FRINGE_WIDTH (w);
2216 spot.y = WINDOW_TO_FRAME_PIXEL_Y (w, y) + FONT_BASE (FRAME_FONT (f));
2217 attr = XVaCreateNestedList (0, XNSpotLocation, &spot, NULL);
2218 XSetICValues (FRAME_XIC (f), XNPreeditAttributes, attr, NULL);
2219 XFree (attr);
2223 /* Place status area for XIC in bottom right corner of frame F.. */
2225 void
2226 xic_set_statusarea (struct frame *f)
2228 XIC xic = FRAME_XIC (f);
2229 XVaNestedList attr;
2230 XRectangle area;
2231 XRectangle *needed;
2233 /* Negotiate geometry of status area. If input method has existing
2234 status area, use its current size. */
2235 area.x = area.y = area.width = area.height = 0;
2236 attr = XVaCreateNestedList (0, XNAreaNeeded, &area, NULL);
2237 XSetICValues (xic, XNStatusAttributes, attr, NULL);
2238 XFree (attr);
2240 attr = XVaCreateNestedList (0, XNAreaNeeded, &needed, NULL);
2241 XGetICValues (xic, XNStatusAttributes, attr, NULL);
2242 XFree (attr);
2244 if (needed->width == 0) /* Use XNArea instead of XNAreaNeeded */
2246 attr = XVaCreateNestedList (0, XNArea, &needed, NULL);
2247 XGetICValues (xic, XNStatusAttributes, attr, NULL);
2248 XFree (attr);
2251 area.width = needed->width;
2252 area.height = needed->height;
2253 area.x = FRAME_PIXEL_WIDTH (f) - area.width - FRAME_INTERNAL_BORDER_WIDTH (f);
2254 area.y = (FRAME_PIXEL_HEIGHT (f) - area.height
2255 - FRAME_MENUBAR_HEIGHT (f)
2256 - FRAME_TOOLBAR_TOP_HEIGHT (f)
2257 - FRAME_INTERNAL_BORDER_WIDTH (f));
2258 XFree (needed);
2260 attr = XVaCreateNestedList (0, XNArea, &area, NULL);
2261 XSetICValues (xic, XNStatusAttributes, attr, NULL);
2262 XFree (attr);
2266 /* Set X fontset for XIC of frame F, using base font name
2267 BASE_FONTNAME. Called when a new Emacs fontset is chosen. */
2269 void
2270 xic_set_xfontset (struct frame *f, const char *base_fontname)
2272 XVaNestedList attr;
2273 XFontSet xfs;
2275 xic_free_xfontset (f);
2277 xfs = xic_create_xfontset (f);
2279 attr = XVaCreateNestedList (0, XNFontSet, xfs, NULL);
2280 if (FRAME_XIC_STYLE (f) & XIMPreeditPosition)
2281 XSetICValues (FRAME_XIC (f), XNPreeditAttributes, attr, NULL);
2282 if (FRAME_XIC_STYLE (f) & XIMStatusArea)
2283 XSetICValues (FRAME_XIC (f), XNStatusAttributes, attr, NULL);
2284 XFree (attr);
2286 FRAME_XIC_FONTSET (f) = xfs;
2289 #endif /* HAVE_X_I18N */
2293 #ifdef USE_X_TOOLKIT
2295 /* Create and set up the X widget for frame F. */
2297 static void
2298 x_window (struct frame *f, long window_prompting, int minibuffer_only)
2300 XClassHint class_hints;
2301 XSetWindowAttributes attributes;
2302 unsigned long attribute_mask;
2303 Widget shell_widget;
2304 Widget pane_widget;
2305 Widget frame_widget;
2306 Arg al [25];
2307 int ac;
2309 block_input ();
2311 /* Use the resource name as the top-level widget name
2312 for looking up resources. Make a non-Lisp copy
2313 for the window manager, so GC relocation won't bother it.
2315 Elsewhere we specify the window name for the window manager. */
2316 f->namebuf = xstrdup (SSDATA (Vx_resource_name));
2318 ac = 0;
2319 XtSetArg (al[ac], XtNallowShellResize, 1); ac++;
2320 XtSetArg (al[ac], XtNinput, 1); ac++;
2321 XtSetArg (al[ac], XtNmappedWhenManaged, 0); ac++;
2322 XtSetArg (al[ac], XtNborderWidth, f->border_width); ac++;
2323 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2324 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2325 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2326 shell_widget = XtAppCreateShell (f->namebuf, EMACS_CLASS,
2327 applicationShellWidgetClass,
2328 FRAME_X_DISPLAY (f), al, ac);
2330 f->output_data.x->widget = shell_widget;
2331 /* maybe_set_screen_title_format (shell_widget); */
2333 pane_widget = lw_create_widget ("main", "pane", widget_id_tick++,
2334 (widget_value *) NULL,
2335 shell_widget, False,
2336 (lw_callback) NULL,
2337 (lw_callback) NULL,
2338 (lw_callback) NULL,
2339 (lw_callback) NULL);
2341 ac = 0;
2342 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2343 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2344 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2345 XtSetArg (al[ac], XtNborderWidth, 0); ac++;
2346 XtSetValues (pane_widget, al, ac);
2347 f->output_data.x->column_widget = pane_widget;
2349 /* mappedWhenManaged to false tells to the paned window to not map/unmap
2350 the emacs screen when changing menubar. This reduces flickering. */
2352 ac = 0;
2353 XtSetArg (al[ac], XtNmappedWhenManaged, 0); ac++;
2354 XtSetArg (al[ac], XtNshowGrip, 0); ac++;
2355 XtSetArg (al[ac], XtNallowResize, 1); ac++;
2356 XtSetArg (al[ac], XtNresizeToPreferred, 1); ac++;
2357 XtSetArg (al[ac], XtNemacsFrame, f); ac++;
2358 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2359 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2360 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2361 XtSetArg (al[ac], XtNborderWidth, 0); ac++;
2362 frame_widget = XtCreateWidget (f->namebuf, emacsFrameClass, pane_widget,
2363 al, ac);
2365 f->output_data.x->edit_widget = frame_widget;
2367 XtManageChild (frame_widget);
2369 /* Do some needed geometry management. */
2371 char *tem, shell_position[sizeof "=x++" + 4 * INT_STRLEN_BOUND (int)];
2372 Arg gal[10];
2373 int gac = 0;
2374 int extra_borders = 0;
2375 int menubar_size
2376 = (f->output_data.x->menubar_widget
2377 ? (f->output_data.x->menubar_widget->core.height
2378 + f->output_data.x->menubar_widget->core.border_width)
2379 : 0);
2381 #if 0 /* Experimentally, we now get the right results
2382 for -geometry -0-0 without this. 24 Aug 96, rms. */
2383 if (FRAME_EXTERNAL_MENU_BAR (f))
2385 Dimension ibw = 0;
2386 XtVaGetValues (pane_widget, XtNinternalBorderWidth, &ibw, NULL);
2387 menubar_size += ibw;
2389 #endif
2391 f->output_data.x->menubar_height = menubar_size;
2393 #ifndef USE_LUCID
2394 /* Motif seems to need this amount added to the sizes
2395 specified for the shell widget. The Athena/Lucid widgets don't.
2396 Both conclusions reached experimentally. -- rms. */
2397 XtVaGetValues (f->output_data.x->edit_widget, XtNinternalBorderWidth,
2398 &extra_borders, NULL);
2399 extra_borders *= 2;
2400 #endif
2402 /* Convert our geometry parameters into a geometry string
2403 and specify it.
2404 Note that we do not specify here whether the position
2405 is a user-specified or program-specified one.
2406 We pass that information later, in x_wm_set_size_hints. */
2408 int left = f->left_pos;
2409 int xneg = window_prompting & XNegative;
2410 int top = f->top_pos;
2411 int yneg = window_prompting & YNegative;
2412 if (xneg)
2413 left = -left;
2414 if (yneg)
2415 top = -top;
2417 if (window_prompting & USPosition)
2418 sprintf (shell_position, "=%dx%d%c%d%c%d",
2419 FRAME_PIXEL_WIDTH (f) + extra_borders,
2420 FRAME_PIXEL_HEIGHT (f) + menubar_size + extra_borders,
2421 (xneg ? '-' : '+'), left,
2422 (yneg ? '-' : '+'), top);
2423 else
2425 sprintf (shell_position, "=%dx%d",
2426 FRAME_PIXEL_WIDTH (f) + extra_borders,
2427 FRAME_PIXEL_HEIGHT (f) + menubar_size + extra_borders);
2429 /* Setting x and y when the position is not specified in
2430 the geometry string will set program position in the WM hints.
2431 If Emacs had just one program position, we could set it in
2432 fallback resources, but since each make-frame call can specify
2433 different program positions, this is easier. */
2434 XtSetArg (gal[gac], XtNx, left); gac++;
2435 XtSetArg (gal[gac], XtNy, top); gac++;
2439 /* We don't free this because we don't know whether
2440 it is safe to free it while the frame exists.
2441 It isn't worth the trouble of arranging to free it
2442 when the frame is deleted. */
2443 tem = xstrdup (shell_position);
2444 XtSetArg (gal[gac], XtNgeometry, tem); gac++;
2445 XtSetValues (shell_widget, gal, gac);
2448 XtManageChild (pane_widget);
2449 XtRealizeWidget (shell_widget);
2451 if (FRAME_X_EMBEDDED_P (f))
2452 XReparentWindow (FRAME_X_DISPLAY (f), XtWindow (shell_widget),
2453 f->output_data.x->parent_desc, 0, 0);
2455 FRAME_X_WINDOW (f) = XtWindow (frame_widget);
2457 validate_x_resource_name ();
2459 class_hints.res_name = SSDATA (Vx_resource_name);
2460 class_hints.res_class = SSDATA (Vx_resource_class);
2461 XSetClassHint (FRAME_X_DISPLAY (f), XtWindow (shell_widget), &class_hints);
2463 #ifdef HAVE_X_I18N
2464 FRAME_XIC (f) = NULL;
2465 if (use_xim)
2466 create_frame_xic (f);
2467 #endif
2469 f->output_data.x->wm_hints.input = True;
2470 f->output_data.x->wm_hints.flags |= InputHint;
2471 XSetWMHints (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2472 &f->output_data.x->wm_hints);
2474 hack_wm_protocols (f, shell_widget);
2476 #ifdef HACK_EDITRES
2477 XtAddEventHandler (shell_widget, 0, True, _XEditResCheckMessages, 0);
2478 #endif
2480 /* Do a stupid property change to force the server to generate a
2481 PropertyNotify event so that the event_stream server timestamp will
2482 be initialized to something relevant to the time we created the window.
2484 XChangeProperty (XtDisplay (frame_widget), XtWindow (frame_widget),
2485 FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
2486 XA_ATOM, 32, PropModeAppend,
2487 (unsigned char*) NULL, 0);
2489 /* Make all the standard events reach the Emacs frame. */
2490 attributes.event_mask = STANDARD_EVENT_SET;
2492 #ifdef HAVE_X_I18N
2493 if (FRAME_XIC (f))
2495 /* XIM server might require some X events. */
2496 unsigned long fevent = NoEventMask;
2497 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2498 attributes.event_mask |= fevent;
2500 #endif /* HAVE_X_I18N */
2502 attribute_mask = CWEventMask;
2503 XChangeWindowAttributes (XtDisplay (shell_widget), XtWindow (shell_widget),
2504 attribute_mask, &attributes);
2506 XtMapWidget (frame_widget);
2508 /* x_set_name normally ignores requests to set the name if the
2509 requested name is the same as the current name. This is the one
2510 place where that assumption isn't correct; f->name is set, but
2511 the X server hasn't been told. */
2513 Lisp_Object name;
2514 int explicit = f->explicit_name;
2516 f->explicit_name = 0;
2517 name = f->name;
2518 fset_name (f, Qnil);
2519 x_set_name (f, name, explicit);
2522 XDefineCursor (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2523 f->output_data.x->current_cursor
2524 = f->output_data.x->text_cursor);
2526 unblock_input ();
2528 /* This is a no-op, except under Motif. Make sure main areas are
2529 set to something reasonable, in case we get an error later. */
2530 lw_set_main_areas (pane_widget, 0, frame_widget);
2533 #else /* not USE_X_TOOLKIT */
2534 #ifdef USE_GTK
2535 static void
2536 x_window (struct frame *f)
2538 if (! xg_create_frame_widgets (f))
2539 error ("Unable to create window");
2541 #ifdef HAVE_X_I18N
2542 FRAME_XIC (f) = NULL;
2543 if (use_xim)
2545 block_input ();
2546 create_frame_xic (f);
2547 if (FRAME_XIC (f))
2549 /* XIM server might require some X events. */
2550 unsigned long fevent = NoEventMask;
2551 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2553 if (fevent != NoEventMask)
2555 XSetWindowAttributes attributes;
2556 XWindowAttributes wattr;
2557 unsigned long attribute_mask;
2559 XGetWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2560 &wattr);
2561 attributes.event_mask = wattr.your_event_mask | fevent;
2562 attribute_mask = CWEventMask;
2563 XChangeWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2564 attribute_mask, &attributes);
2567 unblock_input ();
2569 #endif
2572 #else /*! USE_GTK */
2573 /* Create and set up the X window for frame F. */
2575 static void
2576 x_window (struct frame *f)
2578 XClassHint class_hints;
2579 XSetWindowAttributes attributes;
2580 unsigned long attribute_mask;
2582 attributes.background_pixel = FRAME_BACKGROUND_PIXEL (f);
2583 attributes.border_pixel = f->output_data.x->border_pixel;
2584 attributes.bit_gravity = StaticGravity;
2585 attributes.backing_store = NotUseful;
2586 attributes.save_under = True;
2587 attributes.event_mask = STANDARD_EVENT_SET;
2588 attributes.colormap = FRAME_X_COLORMAP (f);
2589 attribute_mask = (CWBackPixel | CWBorderPixel | CWBitGravity | CWEventMask
2590 | CWColormap);
2592 block_input ();
2593 FRAME_X_WINDOW (f)
2594 = XCreateWindow (FRAME_X_DISPLAY (f),
2595 f->output_data.x->parent_desc,
2596 f->left_pos,
2597 f->top_pos,
2598 FRAME_PIXEL_WIDTH (f), FRAME_PIXEL_HEIGHT (f),
2599 f->border_width,
2600 CopyFromParent, /* depth */
2601 InputOutput, /* class */
2602 FRAME_X_VISUAL (f),
2603 attribute_mask, &attributes);
2605 #ifdef HAVE_X_I18N
2606 if (use_xim)
2608 create_frame_xic (f);
2609 if (FRAME_XIC (f))
2611 /* XIM server might require some X events. */
2612 unsigned long fevent = NoEventMask;
2613 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2614 attributes.event_mask |= fevent;
2615 attribute_mask = CWEventMask;
2616 XChangeWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2617 attribute_mask, &attributes);
2620 #endif /* HAVE_X_I18N */
2622 validate_x_resource_name ();
2624 class_hints.res_name = SSDATA (Vx_resource_name);
2625 class_hints.res_class = SSDATA (Vx_resource_class);
2626 XSetClassHint (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), &class_hints);
2628 /* The menubar is part of the ordinary display;
2629 it does not count in addition to the height of the window. */
2630 f->output_data.x->menubar_height = 0;
2632 /* This indicates that we use the "Passive Input" input model.
2633 Unless we do this, we don't get the Focus{In,Out} events that we
2634 need to draw the cursor correctly. Accursed bureaucrats.
2635 XWhipsAndChains (FRAME_X_DISPLAY (f), IronMaiden, &TheRack); */
2637 f->output_data.x->wm_hints.input = True;
2638 f->output_data.x->wm_hints.flags |= InputHint;
2639 XSetWMHints (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2640 &f->output_data.x->wm_hints);
2641 f->output_data.x->wm_hints.icon_pixmap = None;
2643 /* Request "save yourself" and "delete window" commands from wm. */
2645 Atom protocols[2];
2646 protocols[0] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window;
2647 protocols[1] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself;
2648 XSetWMProtocols (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), protocols, 2);
2651 /* x_set_name normally ignores requests to set the name if the
2652 requested name is the same as the current name. This is the one
2653 place where that assumption isn't correct; f->name is set, but
2654 the X server hasn't been told. */
2656 Lisp_Object name;
2657 int explicit = f->explicit_name;
2659 f->explicit_name = 0;
2660 name = f->name;
2661 fset_name (f, Qnil);
2662 x_set_name (f, name, explicit);
2665 XDefineCursor (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2666 f->output_data.x->current_cursor
2667 = f->output_data.x->text_cursor);
2669 unblock_input ();
2671 if (FRAME_X_WINDOW (f) == 0)
2672 error ("Unable to create window");
2675 #endif /* not USE_GTK */
2676 #endif /* not USE_X_TOOLKIT */
2678 /* Verify that the icon position args for this window are valid. */
2680 static void
2681 x_icon_verify (struct frame *f, Lisp_Object parms)
2683 Lisp_Object icon_x, icon_y;
2685 /* Set the position of the icon. Note that twm groups all
2686 icons in an icon window. */
2687 icon_x = x_frame_get_and_record_arg (f, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
2688 icon_y = x_frame_get_and_record_arg (f, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
2689 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
2691 CHECK_NUMBER (icon_x);
2692 CHECK_NUMBER (icon_y);
2694 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
2695 error ("Both left and top icon corners of icon must be specified");
2698 /* Handle the icon stuff for this window. Perhaps later we might
2699 want an x_set_icon_position which can be called interactively as
2700 well. */
2702 static void
2703 x_icon (struct frame *f, Lisp_Object parms)
2705 Lisp_Object icon_x, icon_y;
2706 #if 0
2707 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
2708 #endif
2710 /* Set the position of the icon. Note that twm groups all
2711 icons in an icon window. */
2712 icon_x = x_frame_get_and_record_arg (f, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
2713 icon_y = x_frame_get_and_record_arg (f, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
2714 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
2716 CHECK_TYPE_RANGED_INTEGER (int, icon_x);
2717 CHECK_TYPE_RANGED_INTEGER (int, icon_y);
2719 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
2720 error ("Both left and top icon corners of icon must be specified");
2722 block_input ();
2724 if (! EQ (icon_x, Qunbound))
2725 x_wm_set_icon_position (f, XINT (icon_x), XINT (icon_y));
2727 #if 0 /* x_get_arg removes the visibility parameter as a side effect,
2728 but x_create_frame still needs it. */
2729 /* Start up iconic or window? */
2730 x_wm_set_window_state
2731 (f, (EQ (x_get_arg (dpyinfo, parms, Qvisibility, 0, 0, RES_TYPE_SYMBOL),
2732 Qicon)
2733 ? IconicState
2734 : NormalState));
2735 #endif
2737 x_text_icon (f, SSDATA ((!NILP (f->icon_name)
2738 ? f->icon_name
2739 : f->name)));
2741 unblock_input ();
2744 /* Make the GCs needed for this window, setting the
2745 background, border and mouse colors; also create the
2746 mouse cursor and the gray border tile. */
2748 static void
2749 x_make_gc (struct frame *f)
2751 XGCValues gc_values;
2753 block_input ();
2755 /* Create the GCs of this frame.
2756 Note that many default values are used. */
2758 gc_values.foreground = FRAME_FOREGROUND_PIXEL (f);
2759 gc_values.background = FRAME_BACKGROUND_PIXEL (f);
2760 gc_values.line_width = 0; /* Means 1 using fast algorithm. */
2761 f->output_data.x->normal_gc
2762 = XCreateGC (FRAME_X_DISPLAY (f),
2763 FRAME_X_WINDOW (f),
2764 GCLineWidth | GCForeground | GCBackground,
2765 &gc_values);
2767 /* Reverse video style. */
2768 gc_values.foreground = FRAME_BACKGROUND_PIXEL (f);
2769 gc_values.background = FRAME_FOREGROUND_PIXEL (f);
2770 f->output_data.x->reverse_gc
2771 = XCreateGC (FRAME_X_DISPLAY (f),
2772 FRAME_X_WINDOW (f),
2773 GCForeground | GCBackground | GCLineWidth,
2774 &gc_values);
2776 /* Cursor has cursor-color background, background-color foreground. */
2777 gc_values.foreground = FRAME_BACKGROUND_PIXEL (f);
2778 gc_values.background = f->output_data.x->cursor_pixel;
2779 gc_values.fill_style = FillOpaqueStippled;
2780 f->output_data.x->cursor_gc
2781 = XCreateGC (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2782 (GCForeground | GCBackground
2783 | GCFillStyle | GCLineWidth),
2784 &gc_values);
2786 /* Create the gray border tile used when the pointer is not in
2787 the frame. Since this depends on the frame's pixel values,
2788 this must be done on a per-frame basis. */
2789 f->output_data.x->border_tile
2790 = (XCreatePixmapFromBitmapData
2791 (FRAME_X_DISPLAY (f), FRAME_X_DISPLAY_INFO (f)->root_window,
2792 gray_bits, gray_width, gray_height,
2793 FRAME_FOREGROUND_PIXEL (f),
2794 FRAME_BACKGROUND_PIXEL (f),
2795 DefaultDepth (FRAME_X_DISPLAY (f), FRAME_X_SCREEN_NUMBER (f))));
2797 unblock_input ();
2801 /* Free what was allocated in x_make_gc. */
2803 void
2804 x_free_gcs (struct frame *f)
2806 Display *dpy = FRAME_X_DISPLAY (f);
2808 block_input ();
2810 if (f->output_data.x->normal_gc)
2812 XFreeGC (dpy, f->output_data.x->normal_gc);
2813 f->output_data.x->normal_gc = 0;
2816 if (f->output_data.x->reverse_gc)
2818 XFreeGC (dpy, f->output_data.x->reverse_gc);
2819 f->output_data.x->reverse_gc = 0;
2822 if (f->output_data.x->cursor_gc)
2824 XFreeGC (dpy, f->output_data.x->cursor_gc);
2825 f->output_data.x->cursor_gc = 0;
2828 if (f->output_data.x->border_tile)
2830 XFreePixmap (dpy, f->output_data.x->border_tile);
2831 f->output_data.x->border_tile = 0;
2834 unblock_input ();
2838 /* Handler for signals raised during x_create_frame and
2839 x_create_tip_frame. FRAME is the frame which is partially
2840 constructed. */
2842 static Lisp_Object
2843 unwind_create_frame (Lisp_Object frame)
2845 struct frame *f = XFRAME (frame);
2847 /* If frame is already dead, nothing to do. This can happen if the
2848 display is disconnected after the frame has become official, but
2849 before x_create_frame removes the unwind protect. */
2850 if (!FRAME_LIVE_P (f))
2851 return Qnil;
2853 /* If frame is ``official'', nothing to do. */
2854 if (NILP (Fmemq (frame, Vframe_list)))
2856 #if defined GLYPH_DEBUG && defined ENABLE_CHECKING
2857 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
2858 #endif
2860 x_free_frame_resources (f);
2861 free_glyphs (f);
2863 #if defined GLYPH_DEBUG && defined ENABLE_CHECKING
2864 /* Check that reference counts are indeed correct. */
2865 eassert (dpyinfo->reference_count == dpyinfo_refcount);
2866 eassert (dpyinfo->terminal->image_cache->refcount == image_cache_refcount);
2867 #endif
2868 return Qt;
2871 return Qnil;
2874 static void
2875 do_unwind_create_frame (Lisp_Object frame)
2877 unwind_create_frame (frame);
2880 static void
2881 unwind_create_frame_1 (Lisp_Object val)
2883 inhibit_lisp_code = val;
2886 static void
2887 x_default_font_parameter (struct frame *f, Lisp_Object parms)
2889 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
2890 Lisp_Object font_param = x_get_arg (dpyinfo, parms, Qfont, NULL, NULL,
2891 RES_TYPE_STRING);
2892 Lisp_Object font = Qnil;
2893 if (EQ (font_param, Qunbound))
2894 font_param = Qnil;
2896 if (NILP (font_param))
2898 /* System font should take precedence over X resources. We suggest this
2899 regardless of font-use-system-font because .emacs may not have been
2900 read yet. */
2901 const char *system_font = xsettings_get_system_font ();
2902 if (system_font)
2903 font = font_open_by_name (f, build_unibyte_string (system_font));
2906 if (NILP (font))
2907 font = !NILP (font_param) ? font_param
2908 : x_get_arg (dpyinfo, parms, Qfont, "font", "Font", RES_TYPE_STRING);
2910 if (! FONTP (font) && ! STRINGP (font))
2912 const char *names[]
2914 #ifdef HAVE_XFT
2915 /* This will find the normal Xft font. */
2916 "monospace-10",
2917 #endif
2918 "-adobe-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-1",
2919 "-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-1",
2920 "-*-*-medium-r-normal-*-*-140-*-*-c-*-iso8859-1",
2921 /* This was formerly the first thing tried, but it finds
2922 too many fonts and takes too long. */
2923 "-*-*-medium-r-*-*-*-*-*-*-c-*-iso8859-1",
2924 /* If those didn't work, look for something which will
2925 at least work. */
2926 "-*-fixed-*-*-*-*-*-140-*-*-c-*-iso8859-1",
2927 "fixed",
2928 NULL };
2929 int i;
2931 for (i = 0; names[i]; i++)
2933 font = font_open_by_name (f, build_unibyte_string (names[i]));
2934 if (! NILP (font))
2935 break;
2937 if (NILP (font))
2938 error ("No suitable font was found");
2940 else if (!NILP (font_param))
2942 /* Remember the explicit font parameter, so we can re-apply it after
2943 we've applied the `default' face settings. */
2944 x_set_frame_parameters (f, list1 (Fcons (Qfont_param, font_param)));
2947 /* This call will make X resources override any system font setting. */
2948 x_default_parameter (f, parms, Qfont, font, "font", "Font", RES_TYPE_STRING);
2952 DEFUN ("x-wm-set-size-hint", Fx_wm_set_size_hint, Sx_wm_set_size_hint,
2953 0, 1, 0,
2954 doc: /* Send the size hints for frame FRAME to the window manager.
2955 If FRAME is omitted or nil, use the selected frame.
2956 Signal error if FRAME is not an X frame. */)
2957 (Lisp_Object frame)
2959 struct frame *f = decode_window_system_frame (frame);
2961 block_input ();
2962 x_wm_set_size_hint (f, 0, 0);
2963 unblock_input ();
2964 return Qnil;
2967 static void
2968 set_machine_and_pid_properties (struct frame *f)
2970 long pid = (long) getpid ();
2972 /* This will set WM_CLIENT_MACHINE and WM_LOCALE_NAME. */
2973 XSetWMProperties (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), NULL, NULL,
2974 NULL, 0, NULL, NULL, NULL);
2975 XChangeProperty (FRAME_X_DISPLAY (f),
2976 FRAME_OUTER_WINDOW (f),
2977 XInternAtom (FRAME_X_DISPLAY (f),
2978 "_NET_WM_PID",
2979 False),
2980 XA_CARDINAL, 32, PropModeReplace,
2981 (unsigned char *) &pid, 1);
2984 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
2985 1, 1, 0,
2986 doc: /* Make a new X window, which is called a "frame" in Emacs terms.
2987 Return an Emacs frame object.
2988 PARMS is an alist of frame parameters.
2989 If the parameters specify that the frame should not have a minibuffer,
2990 and do not specify a specific minibuffer window to use,
2991 then `default-minibuffer-frame' must be a frame whose minibuffer can
2992 be shared by the new frame.
2994 This function is an internal primitive--use `make-frame' instead. */)
2995 (Lisp_Object parms)
2997 struct frame *f;
2998 Lisp_Object frame, tem;
2999 Lisp_Object name;
3000 int minibuffer_only = 0;
3001 long window_prompting = 0;
3002 int width, height;
3003 ptrdiff_t count = SPECPDL_INDEX ();
3004 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
3005 Lisp_Object display;
3006 struct x_display_info *dpyinfo = NULL;
3007 Lisp_Object parent;
3008 struct kboard *kb;
3010 parms = Fcopy_alist (parms);
3012 /* Use this general default value to start with
3013 until we know if this frame has a specified name. */
3014 Vx_resource_name = Vinvocation_name;
3016 display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_NUMBER);
3017 if (EQ (display, Qunbound))
3018 display = x_get_arg (dpyinfo, parms, Qdisplay, 0, 0, RES_TYPE_STRING);
3019 if (EQ (display, Qunbound))
3020 display = Qnil;
3021 dpyinfo = check_x_display_info (display);
3022 kb = dpyinfo->terminal->kboard;
3024 if (!dpyinfo->terminal->name)
3025 error ("Terminal is not live, can't create new frames on it");
3027 name = x_get_arg (dpyinfo, parms, Qname, "name", "Name", RES_TYPE_STRING);
3028 if (!STRINGP (name)
3029 && ! EQ (name, Qunbound)
3030 && ! NILP (name))
3031 error ("Invalid frame name--not a string or nil");
3033 if (STRINGP (name))
3034 Vx_resource_name = name;
3036 /* See if parent window is specified. */
3037 parent = x_get_arg (dpyinfo, parms, Qparent_id, NULL, NULL, RES_TYPE_NUMBER);
3038 if (EQ (parent, Qunbound))
3039 parent = Qnil;
3040 if (! NILP (parent))
3041 CHECK_NUMBER (parent);
3043 /* make_frame_without_minibuffer can run Lisp code and garbage collect. */
3044 /* No need to protect DISPLAY because that's not used after passing
3045 it to make_frame_without_minibuffer. */
3046 frame = Qnil;
3047 GCPRO4 (parms, parent, name, frame);
3048 tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
3049 RES_TYPE_SYMBOL);
3050 if (EQ (tem, Qnone) || NILP (tem))
3051 f = make_frame_without_minibuffer (Qnil, kb, display);
3052 else if (EQ (tem, Qonly))
3054 f = make_minibuffer_frame ();
3055 minibuffer_only = 1;
3057 else if (WINDOWP (tem))
3058 f = make_frame_without_minibuffer (tem, kb, display);
3059 else
3060 f = make_frame (1);
3062 XSETFRAME (frame, f);
3064 f->terminal = dpyinfo->terminal;
3066 f->output_method = output_x_window;
3067 f->output_data.x = xzalloc (sizeof *f->output_data.x);
3068 f->output_data.x->icon_bitmap = -1;
3069 FRAME_FONTSET (f) = -1;
3070 f->output_data.x->scroll_bar_foreground_pixel = -1;
3071 f->output_data.x->scroll_bar_background_pixel = -1;
3072 #ifdef USE_TOOLKIT_SCROLL_BARS
3073 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
3074 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
3075 #endif /* USE_TOOLKIT_SCROLL_BARS */
3077 fset_icon_name (f,
3078 x_get_arg (dpyinfo, parms, Qicon_name, "iconName", "Title",
3079 RES_TYPE_STRING));
3080 if (! STRINGP (f->icon_name))
3081 fset_icon_name (f, Qnil);
3083 FRAME_X_DISPLAY_INFO (f) = dpyinfo;
3085 /* With FRAME_X_DISPLAY_INFO set up, this unwind-protect is safe. */
3086 record_unwind_protect (do_unwind_create_frame, frame);
3088 /* These colors will be set anyway later, but it's important
3089 to get the color reference counts right, so initialize them! */
3091 Lisp_Object black;
3092 struct gcpro gcpro1;
3094 /* Function x_decode_color can signal an error. Make
3095 sure to initialize color slots so that we won't try
3096 to free colors we haven't allocated. */
3097 FRAME_FOREGROUND_PIXEL (f) = -1;
3098 FRAME_BACKGROUND_PIXEL (f) = -1;
3099 f->output_data.x->cursor_pixel = -1;
3100 f->output_data.x->cursor_foreground_pixel = -1;
3101 f->output_data.x->border_pixel = -1;
3102 f->output_data.x->mouse_pixel = -1;
3104 black = build_string ("black");
3105 GCPRO1 (black);
3106 FRAME_FOREGROUND_PIXEL (f)
3107 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3108 FRAME_BACKGROUND_PIXEL (f)
3109 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3110 f->output_data.x->cursor_pixel
3111 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3112 f->output_data.x->cursor_foreground_pixel
3113 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3114 f->output_data.x->border_pixel
3115 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3116 f->output_data.x->mouse_pixel
3117 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3118 UNGCPRO;
3121 /* Specify the parent under which to make this X window. */
3123 if (!NILP (parent))
3125 f->output_data.x->parent_desc = (Window) XFASTINT (parent);
3126 f->output_data.x->explicit_parent = 1;
3128 else
3130 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
3131 f->output_data.x->explicit_parent = 0;
3134 /* Set the name; the functions to which we pass f expect the name to
3135 be set. */
3136 if (EQ (name, Qunbound) || NILP (name))
3138 fset_name (f, build_string (dpyinfo->x_id_name));
3139 f->explicit_name = 0;
3141 else
3143 fset_name (f, name);
3144 f->explicit_name = 1;
3145 /* use the frame's title when getting resources for this frame. */
3146 specbind (Qx_resource_name, name);
3149 #ifdef HAVE_FREETYPE
3150 #ifdef HAVE_XFT
3151 register_font_driver (&xftfont_driver, f);
3152 #else /* not HAVE_XFT */
3153 register_font_driver (&ftxfont_driver, f);
3154 #endif /* not HAVE_XFT */
3155 #endif /* HAVE_FREETYPE */
3156 register_font_driver (&xfont_driver, f);
3158 x_default_parameter (f, parms, Qfont_backend, Qnil,
3159 "fontBackend", "FontBackend", RES_TYPE_STRING);
3161 /* Extract the window parameters from the supplied values
3162 that are needed to determine window geometry. */
3163 x_default_font_parameter (f, parms);
3164 if (!FRAME_FONT (f))
3166 delete_frame (frame, Qnoelisp);
3167 error ("Invalid frame font");
3170 /* Frame contents get displaced if an embedded X window has a border. */
3171 if (! FRAME_X_EMBEDDED_P (f))
3172 x_default_parameter (f, parms, Qborder_width, make_number (0),
3173 "borderWidth", "BorderWidth", RES_TYPE_NUMBER);
3175 /* This defaults to 1 in order to match xterm. We recognize either
3176 internalBorderWidth or internalBorder (which is what xterm calls
3177 it). */
3178 if (NILP (Fassq (Qinternal_border_width, parms)))
3180 Lisp_Object value;
3182 value = x_get_arg (dpyinfo, parms, Qinternal_border_width,
3183 "internalBorder", "internalBorder", RES_TYPE_NUMBER);
3184 if (! EQ (value, Qunbound))
3185 parms = Fcons (Fcons (Qinternal_border_width, value),
3186 parms);
3188 x_default_parameter (f, parms, Qinternal_border_width,
3189 #ifdef USE_GTK /* We used to impose 0 in xg_create_frame_widgets. */
3190 make_number (0),
3191 #else
3192 make_number (1),
3193 #endif
3194 "internalBorderWidth", "internalBorderWidth",
3195 RES_TYPE_NUMBER);
3196 x_default_parameter (f, parms, Qvertical_scroll_bars,
3197 #if defined (USE_GTK) && defined (USE_TOOLKIT_SCROLL_BARS)
3198 Qright,
3199 #else
3200 Qleft,
3201 #endif
3202 "verticalScrollBars", "ScrollBars",
3203 RES_TYPE_SYMBOL);
3205 /* Also do the stuff which must be set before the window exists. */
3206 x_default_parameter (f, parms, Qforeground_color, build_string ("black"),
3207 "foreground", "Foreground", RES_TYPE_STRING);
3208 x_default_parameter (f, parms, Qbackground_color, build_string ("white"),
3209 "background", "Background", RES_TYPE_STRING);
3210 x_default_parameter (f, parms, Qmouse_color, build_string ("black"),
3211 "pointerColor", "Foreground", RES_TYPE_STRING);
3212 x_default_parameter (f, parms, Qborder_color, build_string ("black"),
3213 "borderColor", "BorderColor", RES_TYPE_STRING);
3214 x_default_parameter (f, parms, Qscreen_gamma, Qnil,
3215 "screenGamma", "ScreenGamma", RES_TYPE_FLOAT);
3216 x_default_parameter (f, parms, Qline_spacing, Qnil,
3217 "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
3218 x_default_parameter (f, parms, Qleft_fringe, Qnil,
3219 "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
3220 x_default_parameter (f, parms, Qright_fringe, Qnil,
3221 "rightFringe", "RightFringe", RES_TYPE_NUMBER);
3223 x_default_scroll_bar_color_parameter (f, parms, Qscroll_bar_foreground,
3224 "scrollBarForeground",
3225 "ScrollBarForeground", 1);
3226 x_default_scroll_bar_color_parameter (f, parms, Qscroll_bar_background,
3227 "scrollBarBackground",
3228 "ScrollBarBackground", 0);
3230 #ifdef GLYPH_DEBUG
3231 image_cache_refcount =
3232 FRAME_IMAGE_CACHE (f) ? FRAME_IMAGE_CACHE (f)->refcount : 0;
3233 dpyinfo_refcount = dpyinfo->reference_count;
3234 #endif /* GLYPH_DEBUG */
3236 /* Init faces before x_default_parameter is called for scroll-bar
3237 parameters because that function calls x_set_scroll_bar_width,
3238 which calls change_frame_size, which calls Fset_window_buffer,
3239 which runs hooks, which call Fvertical_motion. At the end, we
3240 end up in init_iterator with a null face cache, which should not
3241 happen. */
3242 init_frame_faces (f);
3244 /* Set the menu-bar-lines and tool-bar-lines parameters. We don't
3245 look up the X resources controlling the menu-bar and tool-bar
3246 here; they are processed specially at startup, and reflected in
3247 the values of the mode variables.
3249 Avoid calling window-configuration-change-hook; otherwise we
3250 could get an infloop in next_frame since the frame is not yet in
3251 Vframe_list. */
3253 ptrdiff_t count2 = SPECPDL_INDEX ();
3254 record_unwind_protect (unwind_create_frame_1, inhibit_lisp_code);
3255 inhibit_lisp_code = Qt;
3257 x_default_parameter (f, parms, Qmenu_bar_lines,
3258 NILP (Vmenu_bar_mode)
3259 ? make_number (0) : make_number (1),
3260 NULL, NULL, RES_TYPE_NUMBER);
3261 x_default_parameter (f, parms, Qtool_bar_lines,
3262 NILP (Vtool_bar_mode)
3263 ? make_number (0) : make_number (1),
3264 NULL, NULL, RES_TYPE_NUMBER);
3266 unbind_to (count2, Qnil);
3269 x_default_parameter (f, parms, Qbuffer_predicate, Qnil,
3270 "bufferPredicate", "BufferPredicate",
3271 RES_TYPE_SYMBOL);
3272 x_default_parameter (f, parms, Qtitle, Qnil,
3273 "title", "Title", RES_TYPE_STRING);
3274 x_default_parameter (f, parms, Qwait_for_wm, Qt,
3275 "waitForWM", "WaitForWM", RES_TYPE_BOOLEAN);
3276 x_default_parameter (f, parms, Qfullscreen, Qnil,
3277 "fullscreen", "Fullscreen", RES_TYPE_SYMBOL);
3278 x_default_parameter (f, parms, Qtool_bar_position,
3279 f->tool_bar_position, 0, 0, RES_TYPE_SYMBOL);
3281 /* Compute the size of the X window. */
3282 window_prompting = x_figure_window_size (f, parms, 1);
3284 tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
3285 f->no_split = minibuffer_only || EQ (tem, Qt);
3287 x_icon_verify (f, parms);
3289 /* Create the X widget or window. */
3290 #ifdef USE_X_TOOLKIT
3291 x_window (f, window_prompting, minibuffer_only);
3292 #else
3293 x_window (f);
3294 #endif
3296 x_icon (f, parms);
3297 x_make_gc (f);
3299 /* Now consider the frame official. */
3300 f->terminal->reference_count++;
3301 FRAME_X_DISPLAY_INFO (f)->reference_count++;
3302 Vframe_list = Fcons (frame, Vframe_list);
3304 /* We need to do this after creating the X window, so that the
3305 icon-creation functions can say whose icon they're describing. */
3306 x_default_parameter (f, parms, Qicon_type, Qt,
3307 "bitmapIcon", "BitmapIcon", RES_TYPE_BOOLEAN);
3309 x_default_parameter (f, parms, Qauto_raise, Qnil,
3310 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
3311 x_default_parameter (f, parms, Qauto_lower, Qnil,
3312 "autoLower", "AutoRaiseLower", RES_TYPE_BOOLEAN);
3313 x_default_parameter (f, parms, Qcursor_type, Qbox,
3314 "cursorType", "CursorType", RES_TYPE_SYMBOL);
3315 x_default_parameter (f, parms, Qscroll_bar_width, Qnil,
3316 "scrollBarWidth", "ScrollBarWidth",
3317 RES_TYPE_NUMBER);
3318 x_default_parameter (f, parms, Qalpha, Qnil,
3319 "alpha", "Alpha", RES_TYPE_NUMBER);
3321 /* Dimensions, especially FRAME_LINES (f), must be done via change_frame_size.
3322 Change will not be effected unless different from the current
3323 FRAME_LINES (f). */
3324 width = FRAME_COLS (f);
3325 height = FRAME_LINES (f);
3327 SET_FRAME_COLS (f, 0);
3328 FRAME_LINES (f) = 0;
3329 change_frame_size (f, height, width, 1, 0, 0);
3331 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
3332 /* Create the menu bar. */
3333 if (!minibuffer_only && FRAME_EXTERNAL_MENU_BAR (f))
3335 /* If this signals an error, we haven't set size hints for the
3336 frame and we didn't make it visible. */
3337 initialize_frame_menubar (f);
3339 #ifndef USE_GTK
3340 /* This is a no-op, except under Motif where it arranges the
3341 main window for the widgets on it. */
3342 lw_set_main_areas (f->output_data.x->column_widget,
3343 f->output_data.x->menubar_widget,
3344 f->output_data.x->edit_widget);
3345 #endif /* not USE_GTK */
3347 #endif /* USE_X_TOOLKIT || USE_GTK */
3349 /* Tell the server what size and position, etc, we want, and how
3350 badly we want them. This should be done after we have the menu
3351 bar so that its size can be taken into account. */
3352 block_input ();
3353 x_wm_set_size_hint (f, window_prompting, 0);
3354 unblock_input ();
3356 /* Make the window appear on the frame and enable display, unless
3357 the caller says not to. However, with explicit parent, Emacs
3358 cannot control visibility, so don't try. */
3359 if (! f->output_data.x->explicit_parent)
3361 Lisp_Object visibility;
3363 visibility = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0,
3364 RES_TYPE_SYMBOL);
3365 if (EQ (visibility, Qunbound))
3366 visibility = Qt;
3368 if (EQ (visibility, Qicon))
3369 x_iconify_frame (f);
3370 else if (! NILP (visibility))
3371 x_make_frame_visible (f);
3372 else
3374 /* Must have been Qnil. */
3378 block_input ();
3380 /* Set machine name and pid for the purpose of window managers. */
3381 set_machine_and_pid_properties (f);
3383 /* Set the WM leader property. GTK does this itself, so this is not
3384 needed when using GTK. */
3385 if (dpyinfo->client_leader_window != 0)
3387 XChangeProperty (FRAME_X_DISPLAY (f),
3388 FRAME_OUTER_WINDOW (f),
3389 dpyinfo->Xatom_wm_client_leader,
3390 XA_WINDOW, 32, PropModeReplace,
3391 (unsigned char *) &dpyinfo->client_leader_window, 1);
3394 unblock_input ();
3396 /* Initialize `default-minibuffer-frame' in case this is the first
3397 frame on this terminal. */
3398 if (FRAME_HAS_MINIBUF_P (f)
3399 && (!FRAMEP (KVAR (kb, Vdefault_minibuffer_frame))
3400 || !FRAME_LIVE_P (XFRAME (KVAR (kb, Vdefault_minibuffer_frame)))))
3401 kset_default_minibuffer_frame (kb, frame);
3403 /* All remaining specified parameters, which have not been "used"
3404 by x_get_arg and friends, now go in the misc. alist of the frame. */
3405 for (tem = parms; CONSP (tem); tem = XCDR (tem))
3406 if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
3407 fset_param_alist (f, Fcons (XCAR (tem), f->param_alist));
3409 UNGCPRO;
3411 /* Make sure windows on this frame appear in calls to next-window
3412 and similar functions. */
3413 Vwindow_list = Qnil;
3415 return unbind_to (count, frame);
3419 /* FRAME is used only to get a handle on the X display. We don't pass the
3420 display info directly because we're called from frame.c, which doesn't
3421 know about that structure. */
3423 Lisp_Object
3424 x_get_focus_frame (struct frame *frame)
3426 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (frame);
3427 Lisp_Object xfocus;
3428 if (! dpyinfo->x_focus_frame)
3429 return Qnil;
3431 XSETFRAME (xfocus, dpyinfo->x_focus_frame);
3432 return xfocus;
3436 /* In certain situations, when the window manager follows a
3437 click-to-focus policy, there seems to be no way around calling
3438 XSetInputFocus to give another frame the input focus .
3440 In an ideal world, XSetInputFocus should generally be avoided so
3441 that applications don't interfere with the window manager's focus
3442 policy. But I think it's okay to use when it's clearly done
3443 following a user-command. */
3445 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
3446 doc: /* Set the input focus to FRAME.
3447 FRAME nil means use the selected frame. */)
3448 (Lisp_Object frame)
3450 struct frame *f = decode_window_system_frame (frame);
3451 Display *dpy = FRAME_X_DISPLAY (f);
3453 block_input ();
3454 x_catch_errors (dpy);
3456 if (FRAME_X_EMBEDDED_P (f))
3458 /* For Xembedded frames, normally the embedder forwards key
3459 events. See XEmbed Protocol Specification at
3460 http://freedesktop.org/wiki/Specifications/xembed-spec */
3461 xembed_request_focus (f);
3463 else
3465 XSetInputFocus (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
3466 RevertToParent, CurrentTime);
3467 x_ewmh_activate_frame (f);
3470 x_uncatch_errors ();
3471 unblock_input ();
3473 return Qnil;
3477 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
3478 doc: /* Internal function called by `color-defined-p', which see
3479 .\(Note that the Nextstep version of this function ignores FRAME.) */)
3480 (Lisp_Object color, Lisp_Object frame)
3482 XColor foo;
3483 struct frame *f = decode_window_system_frame (frame);
3485 CHECK_STRING (color);
3487 if (x_defined_color (f, SSDATA (color), &foo, 0))
3488 return Qt;
3489 else
3490 return Qnil;
3493 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
3494 doc: /* Internal function called by `color-values', which see. */)
3495 (Lisp_Object color, Lisp_Object frame)
3497 XColor foo;
3498 struct frame *f = decode_window_system_frame (frame);
3500 CHECK_STRING (color);
3502 if (x_defined_color (f, SSDATA (color), &foo, 0))
3503 return list3i (foo.red, foo.green, foo.blue);
3504 else
3505 return Qnil;
3508 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
3509 doc: /* Internal function called by `display-color-p', which see. */)
3510 (Lisp_Object terminal)
3512 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3514 if (dpyinfo->n_planes <= 2)
3515 return Qnil;
3517 switch (dpyinfo->visual->class)
3519 case StaticColor:
3520 case PseudoColor:
3521 case TrueColor:
3522 case DirectColor:
3523 return Qt;
3525 default:
3526 return Qnil;
3530 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p, Sx_display_grayscale_p,
3531 0, 1, 0,
3532 doc: /* Return t if the X display supports shades of gray.
3533 Note that color displays do support shades of gray.
3534 The optional argument TERMINAL specifies which display to ask about.
3535 TERMINAL should be a terminal object, a frame or a display name (a string).
3536 If omitted or nil, that stands for the selected frame's display. */)
3537 (Lisp_Object terminal)
3539 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3541 if (dpyinfo->n_planes <= 1)
3542 return Qnil;
3544 switch (dpyinfo->visual->class)
3546 case StaticColor:
3547 case PseudoColor:
3548 case TrueColor:
3549 case DirectColor:
3550 case StaticGray:
3551 case GrayScale:
3552 return Qt;
3554 default:
3555 return Qnil;
3559 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
3560 0, 1, 0,
3561 doc: /* Return the width in pixels of the X display TERMINAL.
3562 The optional argument TERMINAL specifies which display to ask about.
3563 TERMINAL should be a terminal object, a frame or a display name (a string).
3564 If omitted or nil, that stands for the selected frame's display.
3566 On \"multi-monitor\" setups this refers to the pixel width for all
3567 physical monitors associated with TERMINAL. To get information for
3568 each physical monitor, use `display-monitor-attributes-list'. */)
3569 (Lisp_Object terminal)
3571 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3573 return make_number (x_display_pixel_width (dpyinfo));
3576 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
3577 Sx_display_pixel_height, 0, 1, 0,
3578 doc: /* Return the height in pixels of the X display TERMINAL.
3579 The optional argument TERMINAL specifies which display to ask about.
3580 TERMINAL should be a terminal object, a frame or a display name (a string).
3581 If omitted or nil, that stands for the selected frame's display.
3583 On \"multi-monitor\" setups this refers to the pixel height for all
3584 physical monitors associated with TERMINAL. To get information for
3585 each physical monitor, use `display-monitor-attributes-list'. */)
3586 (Lisp_Object terminal)
3588 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3590 return make_number (x_display_pixel_height (dpyinfo));
3593 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
3594 0, 1, 0,
3595 doc: /* Return the number of bitplanes of the X display TERMINAL.
3596 The optional argument TERMINAL specifies which display to ask about.
3597 TERMINAL should be a terminal object, a frame or a display name (a string).
3598 If omitted or nil, that stands for the selected frame's display. */)
3599 (Lisp_Object terminal)
3601 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3603 return make_number (dpyinfo->n_planes);
3606 DEFUN ("x-display-color-cells", Fx_display_color_cells, Sx_display_color_cells,
3607 0, 1, 0,
3608 doc: /* Return the number of color cells of the X display TERMINAL.
3609 The optional argument TERMINAL specifies which display to ask about.
3610 TERMINAL should be a terminal object, a frame or a display name (a string).
3611 If omitted or nil, that stands for the selected frame's display. */)
3612 (Lisp_Object terminal)
3614 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3616 int nr_planes = DisplayPlanes (dpyinfo->display,
3617 XScreenNumberOfScreen (dpyinfo->screen));
3619 /* Truncate nr_planes to 24 to avoid integer overflow.
3620 Some displays says 32, but only 24 bits are actually significant.
3621 There are only very few and rare video cards that have more than
3622 24 significant bits. Also 24 bits is more than 16 million colors,
3623 it "should be enough for everyone". */
3624 if (nr_planes > 24) nr_planes = 24;
3626 return make_number (1 << nr_planes);
3629 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
3630 Sx_server_max_request_size,
3631 0, 1, 0,
3632 doc: /* Return the maximum request size of the X server of display TERMINAL.
3633 The optional argument TERMINAL specifies which display to ask about.
3634 TERMINAL should be a terminal object, a frame or a display name (a string).
3635 If omitted or nil, that stands for the selected frame's display. */)
3636 (Lisp_Object terminal)
3638 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3640 return make_number (MAXREQUEST (dpyinfo->display));
3643 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
3644 doc: /* Return the "vendor ID" string of the X server of display TERMINAL.
3645 \(Labeling every distributor as a "vendor" embodies the false assumption
3646 that operating systems cannot be developed and distributed noncommercially.)
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);
3653 const char *vendor = ServerVendor (dpyinfo->display);
3655 if (! vendor) vendor = "";
3656 return build_string (vendor);
3659 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
3660 doc: /* Return the version numbers of the X server of display TERMINAL.
3661 The value is a list of three integers: the major and minor
3662 version numbers of the X Protocol in use, and the distributor-specific release
3663 number. See also the function `x-server-vendor'.
3665 The optional argument TERMINAL specifies which display to ask about.
3666 TERMINAL should be a terminal object, a frame or a display name (a string).
3667 If omitted or nil, that stands for the selected frame's display. */)
3668 (Lisp_Object terminal)
3670 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3671 Display *dpy = dpyinfo->display;
3673 return list3i (ProtocolVersion (dpy), ProtocolRevision (dpy),
3674 VendorRelease (dpy));
3677 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
3678 doc: /* Return the number of screens on the X server of display TERMINAL.
3679 The optional argument TERMINAL specifies which display to ask about.
3680 TERMINAL should be a terminal object, a frame or a display name (a string).
3681 If omitted or nil, that stands for the selected frame's display. */)
3682 (Lisp_Object terminal)
3684 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3686 return make_number (ScreenCount (dpyinfo->display));
3689 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height, 0, 1, 0,
3690 doc: /* Return the height in millimeters of the X display TERMINAL.
3691 The optional argument TERMINAL specifies which display to ask about.
3692 TERMINAL should be a terminal object, a frame or a display name (a string).
3693 If omitted or nil, that stands for the selected frame's display.
3695 On \"multi-monitor\" setups this refers to the height in millimeters for
3696 all physical monitors associated with TERMINAL. To get information
3697 for each physical monitor, use `display-monitor-attributes-list'. */)
3698 (Lisp_Object terminal)
3700 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3702 return make_number (HeightMMOfScreen (dpyinfo->screen));
3705 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width, 0, 1, 0,
3706 doc: /* Return the width in millimeters of the X display TERMINAL.
3707 The optional argument TERMINAL specifies which display to ask about.
3708 TERMINAL should be a terminal object, a frame or a display name (a string).
3709 If omitted or nil, that stands for the selected frame's display.
3711 On \"multi-monitor\" setups this refers to the width in millimeters for
3712 all physical monitors associated with TERMINAL. To get information
3713 for each physical monitor, use `display-monitor-attributes-list'. */)
3714 (Lisp_Object terminal)
3716 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3718 return make_number (WidthMMOfScreen (dpyinfo->screen));
3721 DEFUN ("x-display-backing-store", Fx_display_backing_store,
3722 Sx_display_backing_store, 0, 1, 0,
3723 doc: /* Return an indication of whether X display TERMINAL does backing store.
3724 The value may be `always', `when-mapped', or `not-useful'.
3725 The optional argument TERMINAL specifies which display to ask about.
3726 TERMINAL should be a terminal object, a frame or a display name (a string).
3727 If omitted or nil, that stands for the selected frame's display. */)
3728 (Lisp_Object terminal)
3730 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3731 Lisp_Object result;
3733 switch (DoesBackingStore (dpyinfo->screen))
3735 case Always:
3736 result = intern ("always");
3737 break;
3739 case WhenMapped:
3740 result = intern ("when-mapped");
3741 break;
3743 case NotUseful:
3744 result = intern ("not-useful");
3745 break;
3747 default:
3748 error ("Strange value for BackingStore parameter of screen");
3751 return result;
3754 DEFUN ("x-display-visual-class", Fx_display_visual_class,
3755 Sx_display_visual_class, 0, 1, 0,
3756 doc: /* Return the visual class of the X display TERMINAL.
3757 The value is one of the symbols `static-gray', `gray-scale',
3758 `static-color', `pseudo-color', `true-color', or `direct-color'.
3760 The optional argument TERMINAL specifies which display to ask about.
3761 TERMINAL should a terminal object, a frame or a display name (a string).
3762 If omitted or nil, that stands for the selected frame's display. */)
3763 (Lisp_Object terminal)
3765 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3766 Lisp_Object result;
3768 switch (dpyinfo->visual->class)
3770 case StaticGray:
3771 result = intern ("static-gray");
3772 break;
3773 case GrayScale:
3774 result = intern ("gray-scale");
3775 break;
3776 case StaticColor:
3777 result = intern ("static-color");
3778 break;
3779 case PseudoColor:
3780 result = intern ("pseudo-color");
3781 break;
3782 case TrueColor:
3783 result = intern ("true-color");
3784 break;
3785 case DirectColor:
3786 result = intern ("direct-color");
3787 break;
3788 default:
3789 error ("Display has an unknown visual class");
3792 return result;
3795 DEFUN ("x-display-save-under", Fx_display_save_under,
3796 Sx_display_save_under, 0, 1, 0,
3797 doc: /* Return t if the X display TERMINAL supports the save-under feature.
3798 The optional argument TERMINAL specifies which display to ask about.
3799 TERMINAL should be a terminal object, a frame or a display name (a string).
3800 If omitted or nil, that stands for the selected frame's display. */)
3801 (Lisp_Object terminal)
3803 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3805 if (DoesSaveUnders (dpyinfo->screen) == True)
3806 return Qt;
3807 else
3808 return Qnil;
3811 /* Store the geometry of the workarea on display DPYINFO into *RECT.
3812 Return false if and only if the workarea information cannot be
3813 obtained via the _NET_WORKAREA root window property. */
3815 #if ! GTK_CHECK_VERSION (3, 4, 0)
3816 static bool
3817 x_get_net_workarea (struct x_display_info *dpyinfo, XRectangle *rect)
3819 Display *dpy = dpyinfo->display;
3820 long offset, max_len;
3821 Atom target_type, actual_type;
3822 unsigned long actual_size, bytes_remaining;
3823 int rc, actual_format;
3824 unsigned char *tmp_data = NULL;
3825 bool result = false;
3827 x_catch_errors (dpy);
3828 offset = 0;
3829 max_len = 1;
3830 target_type = XA_CARDINAL;
3831 rc = XGetWindowProperty (dpy, dpyinfo->root_window,
3832 dpyinfo->Xatom_net_current_desktop,
3833 offset, max_len, False, target_type,
3834 &actual_type, &actual_format, &actual_size,
3835 &bytes_remaining, &tmp_data);
3836 if (rc == Success && actual_type == target_type && !x_had_errors_p (dpy)
3837 && actual_format == 32 && actual_size == max_len)
3839 long current_desktop = ((long *) tmp_data)[0];
3841 XFree (tmp_data);
3842 tmp_data = NULL;
3844 offset = 4 * current_desktop;
3845 max_len = 4;
3846 rc = XGetWindowProperty (dpy, dpyinfo->root_window,
3847 dpyinfo->Xatom_net_workarea,
3848 offset, max_len, False, target_type,
3849 &actual_type, &actual_format, &actual_size,
3850 &bytes_remaining, &tmp_data);
3851 if (rc == Success && actual_type == target_type && !x_had_errors_p (dpy)
3852 && actual_format == 32 && actual_size == max_len)
3854 long *values = (long *) tmp_data;
3856 rect->x = values[0];
3857 rect->y = values[1];
3858 rect->width = values[2];
3859 rect->height = values[3];
3861 XFree (tmp_data);
3862 tmp_data = NULL;
3864 result = true;
3867 if (tmp_data)
3868 XFree (tmp_data);
3869 x_uncatch_errors ();
3871 return result;
3873 #endif
3875 #ifndef USE_GTK
3877 /* Return monitor number where F is "most" or closest to. */
3878 static int
3879 x_get_monitor_for_frame (struct frame *f,
3880 struct MonitorInfo *monitors,
3881 int n_monitors)
3883 XRectangle frect;
3884 int area = 0, dist = -1;
3885 int best_area = -1, best_dist = -1;
3886 int i;
3888 if (n_monitors == 1) return 0;
3889 frect.x = f->left_pos;
3890 frect.y = f->top_pos;
3891 frect.width = FRAME_PIXEL_WIDTH (f);
3892 frect.height = FRAME_PIXEL_HEIGHT (f);
3894 for (i = 0; i < n_monitors; ++i)
3896 struct MonitorInfo *mi = &monitors[i];
3897 XRectangle res;
3898 int a = 0;
3900 if (mi->geom.width == 0) continue;
3902 if (x_intersect_rectangles (&mi->geom, &frect, &res))
3904 a = res.width * res.height;
3905 if (a > area)
3907 area = a;
3908 best_area = i;
3912 if (a == 0 && area == 0)
3914 int dx, dy, d;
3915 if (frect.x + frect.width < mi->geom.x)
3916 dx = mi->geom.x - frect.x + frect.width;
3917 else if (frect.x > mi->geom.x + mi->geom.width)
3918 dx = frect.x - mi->geom.x + mi->geom.width;
3919 else
3920 dx = 0;
3921 if (frect.y + frect.height < mi->geom.y)
3922 dy = mi->geom.y - frect.y + frect.height;
3923 else if (frect.y > mi->geom.y + mi->geom.height)
3924 dy = frect.y - mi->geom.y + mi->geom.height;
3925 else
3926 dy = 0;
3928 d = dx*dx + dy*dy;
3929 if (dist == -1 || dist > d)
3931 dist = d;
3932 best_dist = i;
3937 return best_area != -1 ? best_area : (best_dist != -1 ? best_dist : 0);
3940 static Lisp_Object
3941 x_make_monitor_attribute_list (struct MonitorInfo *monitors,
3942 int n_monitors,
3943 int primary_monitor,
3944 struct x_display_info *dpyinfo,
3945 const char *source)
3947 Lisp_Object monitor_frames = Fmake_vector (make_number (n_monitors), Qnil);
3948 Lisp_Object frame, rest;
3950 FOR_EACH_FRAME (rest, frame)
3952 struct frame *f = XFRAME (frame);
3954 if (FRAME_X_P (f) && FRAME_X_DISPLAY_INFO (f) == dpyinfo
3955 && !EQ (frame, tip_frame))
3957 int i = x_get_monitor_for_frame (f, monitors, n_monitors);
3958 ASET (monitor_frames, i, Fcons (frame, AREF (monitor_frames, i)));
3962 return make_monitor_attribute_list (monitors, n_monitors, primary_monitor,
3963 monitor_frames, source);
3966 static Lisp_Object
3967 x_get_monitor_attributes_fallback (struct x_display_info *dpyinfo)
3969 struct MonitorInfo monitor;
3970 XRectangle workarea_r;
3972 /* Fallback: treat (possibly) multiple physical monitors as if they
3973 formed a single monitor as a whole. This should provide a
3974 consistent result at least on single monitor environments. */
3975 monitor.geom.x = monitor.geom.y = 0;
3976 monitor.geom.width = x_display_pixel_width (dpyinfo);
3977 monitor.geom.height = x_display_pixel_height (dpyinfo);
3978 monitor.mm_width = WidthMMOfScreen (dpyinfo->screen);
3979 monitor.mm_height = HeightMMOfScreen (dpyinfo->screen);
3980 monitor.name = xstrdup ("combined screen");
3982 if (x_get_net_workarea (dpyinfo, &workarea_r))
3983 monitor.work = workarea_r;
3984 else
3985 monitor.work = monitor.geom;
3986 return x_make_monitor_attribute_list (&monitor, 1, 0, dpyinfo, "fallback");
3990 #ifdef HAVE_XINERAMA
3991 static Lisp_Object
3992 x_get_monitor_attributes_xinerama (struct x_display_info *dpyinfo)
3994 int n_monitors, i;
3995 Lisp_Object attributes_list = Qnil;
3996 Display *dpy = dpyinfo->display;
3997 XineramaScreenInfo *info = XineramaQueryScreens (dpy, &n_monitors);
3998 struct MonitorInfo *monitors;
3999 double mm_width_per_pixel, mm_height_per_pixel;
4001 if (! info || n_monitors == 0)
4003 if (info)
4004 XFree (info);
4005 return attributes_list;
4008 mm_width_per_pixel = ((double) WidthMMOfScreen (dpyinfo->screen)
4009 / x_display_pixel_width (dpyinfo));
4010 mm_height_per_pixel = ((double) HeightMMOfScreen (dpyinfo->screen)
4011 / x_display_pixel_height (dpyinfo));
4012 monitors = (struct MonitorInfo *) xzalloc (n_monitors * sizeof (*monitors));
4013 for (i = 0; i < n_monitors; ++i)
4015 struct MonitorInfo *mi = &monitors[i];
4016 XRectangle workarea_r;
4018 mi->geom.x = info[i].x_org;
4019 mi->geom.y = info[i].y_org;
4020 mi->geom.width = info[i].width;
4021 mi->geom.height = info[i].height;
4022 mi->mm_width = mi->geom.width * mm_width_per_pixel + 0.5;
4023 mi->mm_height = mi->geom.height * mm_height_per_pixel + 0.5;
4024 mi->name = 0;
4026 /* Xinerama usually have primary monitor first, just use that. */
4027 if (i == 0 && x_get_net_workarea (dpyinfo, &workarea_r))
4029 mi->work = workarea_r;
4030 if (! x_intersect_rectangles (&mi->geom, &mi->work, &mi->work))
4031 mi->work = mi->geom;
4033 else
4034 mi->work = mi->geom;
4036 XFree (info);
4038 attributes_list = x_make_monitor_attribute_list (monitors,
4039 n_monitors,
4041 dpyinfo,
4042 "Xinerama");
4043 free_monitors (monitors, n_monitors);
4044 return attributes_list;
4046 #endif /* HAVE_XINERAMA */
4049 #ifdef HAVE_XRANDR
4050 static Lisp_Object
4051 x_get_monitor_attributes_xrandr (struct x_display_info *dpyinfo)
4053 Lisp_Object attributes_list = Qnil;
4054 XRRScreenResources *resources;
4055 Display *dpy = dpyinfo->display;
4056 int i, n_monitors, primary = -1;
4057 RROutput pxid = None;
4058 struct MonitorInfo *monitors;
4060 #ifdef HAVE_XRRGETSCREENRESOURCESCURRENT
4061 resources = XRRGetScreenResourcesCurrent (dpy, dpyinfo->root_window);
4062 #else
4063 resources = XRRGetScreenResources (dpy, dpyinfo->root_window);
4064 #endif
4065 if (! resources || resources->noutput == 0)
4067 if (resources)
4068 XRRFreeScreenResources (resources);
4069 return Qnil;
4071 n_monitors = resources->noutput;
4072 monitors = (struct MonitorInfo *) xzalloc (n_monitors * sizeof (*monitors));
4074 #ifdef HAVE_XRRGETOUTPUTPRIMARY
4075 pxid = XRRGetOutputPrimary (dpy, dpyinfo->root_window);
4076 #endif
4078 for (i = 0; i < n_monitors; ++i)
4080 XRROutputInfo *info = XRRGetOutputInfo (dpy, resources,
4081 resources->outputs[i]);
4082 Connection conn = info ? info->connection : RR_Disconnected;
4083 RRCrtc id = info ? info->crtc : None;
4085 if (strcmp (info->name, "default") == 0)
4087 /* Non XRandr 1.2 driver, does not give useful data. */
4088 XRRFreeOutputInfo (info);
4089 XRRFreeScreenResources (resources);
4090 free_monitors (monitors, n_monitors);
4091 return Qnil;
4094 if (conn != RR_Disconnected && id != None)
4096 XRRCrtcInfo *crtc = XRRGetCrtcInfo (dpy, resources, id);
4097 struct MonitorInfo *mi = &monitors[i];
4098 XRectangle workarea_r;
4100 if (! crtc)
4102 XRRFreeOutputInfo (info);
4103 continue;
4106 mi->geom.x = crtc->x;
4107 mi->geom.y = crtc->y;
4108 mi->geom.width = crtc->width;
4109 mi->geom.height = crtc->height;
4110 mi->mm_width = info->mm_width;
4111 mi->mm_height = info->mm_height;
4112 mi->name = xstrdup (info->name);
4114 if (pxid != None && pxid == resources->outputs[i])
4115 primary = i;
4116 else if (primary == -1 && strcmp (info->name, "LVDS") == 0)
4117 primary = i;
4119 if (i == primary && x_get_net_workarea (dpyinfo, &workarea_r))
4121 mi->work= workarea_r;
4122 if (! x_intersect_rectangles (&mi->geom, &mi->work, &mi->work))
4123 mi->work = mi->geom;
4125 else
4126 mi->work = mi->geom;
4128 XRRFreeCrtcInfo (crtc);
4130 XRRFreeOutputInfo (info);
4132 XRRFreeScreenResources (resources);
4134 attributes_list = x_make_monitor_attribute_list (monitors,
4135 n_monitors,
4136 primary,
4137 dpyinfo,
4138 "XRandr");
4139 free_monitors (monitors, n_monitors);
4140 return attributes_list;
4142 #endif /* HAVE_XRANDR */
4144 static Lisp_Object
4145 x_get_monitor_attributes (struct x_display_info *dpyinfo)
4147 Lisp_Object attributes_list = Qnil;
4148 Display *dpy = dpyinfo->display;
4150 #ifdef HAVE_XRANDR
4151 int xrr_event_base, xrr_error_base;
4152 bool xrr_ok = false;
4153 xrr_ok = XRRQueryExtension (dpy, &xrr_event_base, &xrr_error_base);
4154 if (xrr_ok)
4156 int xrr_major, xrr_minor;
4157 XRRQueryVersion (dpy, &xrr_major, &xrr_minor);
4158 xrr_ok = (xrr_major == 1 && xrr_minor >= 2) || xrr_major > 1;
4161 if (xrr_ok)
4162 attributes_list = x_get_monitor_attributes_xrandr (dpyinfo);
4163 #endif /* HAVE_XRANDR */
4165 #ifdef HAVE_XINERAMA
4166 if (NILP (attributes_list))
4168 int xin_event_base, xin_error_base;
4169 bool xin_ok = false;
4170 xin_ok = XineramaQueryExtension (dpy, &xin_event_base, &xin_error_base);
4171 if (xin_ok && XineramaIsActive (dpy))
4172 attributes_list = x_get_monitor_attributes_xinerama (dpyinfo);
4174 #endif /* HAVE_XINERAMA */
4176 if (NILP (attributes_list))
4177 attributes_list = x_get_monitor_attributes_fallback (dpyinfo);
4179 return attributes_list;
4182 #endif /* !USE_GTK */
4184 DEFUN ("x-display-monitor-attributes-list", Fx_display_monitor_attributes_list,
4185 Sx_display_monitor_attributes_list,
4186 0, 1, 0,
4187 doc: /* Return a list of physical monitor attributes on the X display TERMINAL.
4189 The optional argument TERMINAL specifies which display to ask about.
4190 TERMINAL should be a terminal object, a frame or a display name (a string).
4191 If omitted or nil, that stands for the selected frame's display.
4193 In addition to the standard attribute keys listed in
4194 `display-monitor-attributes-list', the following keys are contained in
4195 the attributes:
4197 source -- String describing the source from which multi-monitor
4198 information is obtained, one of \"Gdk\", \"XRandr\",
4199 \"Xinerama\", or \"fallback\"
4201 Internal use only, use `display-monitor-attributes-list' instead. */)
4202 (Lisp_Object terminal)
4204 struct x_display_info *dpyinfo = check_x_display_info (terminal);
4205 Lisp_Object attributes_list = Qnil;
4207 #ifdef USE_GTK
4208 double mm_width_per_pixel, mm_height_per_pixel;
4209 GdkDisplay *gdpy;
4210 GdkScreen *gscreen;
4211 gint primary_monitor = 0, n_monitors, i;
4212 Lisp_Object monitor_frames, rest, frame;
4213 static const char *source = "Gdk";
4214 struct MonitorInfo *monitors;
4216 block_input ();
4217 mm_width_per_pixel = ((double) WidthMMOfScreen (dpyinfo->screen)
4218 / x_display_pixel_width (dpyinfo));
4219 mm_height_per_pixel = ((double) HeightMMOfScreen (dpyinfo->screen)
4220 / x_display_pixel_height (dpyinfo));
4221 gdpy = gdk_x11_lookup_xdisplay (dpyinfo->display);
4222 gscreen = gdk_display_get_default_screen (gdpy);
4223 #if GTK_CHECK_VERSION (2, 20, 0)
4224 primary_monitor = gdk_screen_get_primary_monitor (gscreen);
4225 #endif
4226 n_monitors = gdk_screen_get_n_monitors (gscreen);
4227 monitor_frames = Fmake_vector (make_number (n_monitors), Qnil);
4228 monitors = (struct MonitorInfo *) xzalloc (n_monitors * sizeof (*monitors));
4230 FOR_EACH_FRAME (rest, frame)
4232 struct frame *f = XFRAME (frame);
4234 if (FRAME_X_P (f) && FRAME_X_DISPLAY_INFO (f) == dpyinfo
4235 && !EQ (frame, tip_frame))
4237 GdkWindow *gwin = gtk_widget_get_window (FRAME_GTK_WIDGET (f));
4239 i = gdk_screen_get_monitor_at_window (gscreen, gwin);
4240 ASET (monitor_frames, i, Fcons (frame, AREF (monitor_frames, i)));
4244 for (i = 0; i < n_monitors; ++i)
4246 gint width_mm = -1, height_mm = -1;
4247 GdkRectangle rec, work;
4248 struct MonitorInfo *mi = &monitors[i];
4250 gdk_screen_get_monitor_geometry (gscreen, i, &rec);
4252 #if GTK_CHECK_VERSION (2, 14, 0)
4253 width_mm = gdk_screen_get_monitor_width_mm (gscreen, i);
4254 height_mm = gdk_screen_get_monitor_height_mm (gscreen, i);
4255 #endif
4256 if (width_mm < 0)
4257 width_mm = rec.width * mm_width_per_pixel + 0.5;
4258 if (height_mm < 0)
4259 height_mm = rec.height * mm_height_per_pixel + 0.5;
4261 #if GTK_CHECK_VERSION (3, 4, 0)
4262 gdk_screen_get_monitor_workarea (gscreen, i, &work);
4263 #else
4264 /* Emulate the behavior of GTK+ 3.4. */
4266 XRectangle workarea_r;
4268 if (i == primary_monitor && x_get_net_workarea (dpyinfo, &workarea_r))
4270 work.x = workarea_r.x;
4271 work.y = workarea_r.y;
4272 work.width = workarea_r.width;
4273 work.height = workarea_r.height;
4274 if (! gdk_rectangle_intersect (&rec, &work, &work))
4275 work = rec;
4277 else
4278 work = rec;
4280 #endif
4283 mi->geom.x = rec.x;
4284 mi->geom.y = rec.y;
4285 mi->geom.width = rec.width;
4286 mi->geom.height = rec.height;
4287 mi->work.x = work.x;
4288 mi->work.y = work.y;
4289 mi->work.width = work.width;
4290 mi->work.height = work.height;
4291 mi->mm_width = width_mm;
4292 mi->mm_height = height_mm;
4294 #if GTK_CHECK_VERSION (2, 14, 0)
4295 mi->name = gdk_screen_get_monitor_plug_name (gscreen, i);
4296 #endif
4299 attributes_list = make_monitor_attribute_list (monitors,
4300 n_monitors,
4301 primary_monitor,
4302 monitor_frames,
4303 source);
4304 unblock_input ();
4305 #else /* not USE_GTK */
4307 block_input ();
4308 attributes_list = x_get_monitor_attributes (dpyinfo);
4309 unblock_input ();
4311 #endif /* not USE_GTK */
4313 return attributes_list;
4316 /************************************************************************
4317 X Displays
4318 ************************************************************************/
4321 /* Mapping visual names to visuals. */
4323 static struct visual_class
4325 const char *name;
4326 int class;
4328 visual_classes[] =
4330 {"StaticGray", StaticGray},
4331 {"GrayScale", GrayScale},
4332 {"StaticColor", StaticColor},
4333 {"PseudoColor", PseudoColor},
4334 {"TrueColor", TrueColor},
4335 {"DirectColor", DirectColor},
4336 {NULL, 0}
4340 #ifndef HAVE_XSCREENNUMBEROFSCREEN
4342 /* Value is the screen number of screen SCR. This is a substitute for
4343 the X function with the same name when that doesn't exist. */
4346 XScreenNumberOfScreen (scr)
4347 register Screen *scr;
4349 Display *dpy = scr->display;
4350 int i;
4352 for (i = 0; i < dpy->nscreens; ++i)
4353 if (scr == dpy->screens + i)
4354 break;
4356 return i;
4359 #endif /* not HAVE_XSCREENNUMBEROFSCREEN */
4362 /* Select the visual that should be used on display DPYINFO. Set
4363 members of DPYINFO appropriately. Called from x_term_init. */
4365 void
4366 select_visual (struct x_display_info *dpyinfo)
4368 Display *dpy = dpyinfo->display;
4369 Screen *screen = dpyinfo->screen;
4370 Lisp_Object value;
4372 /* See if a visual is specified. */
4373 value = display_x_get_resource (dpyinfo,
4374 build_string ("visualClass"),
4375 build_string ("VisualClass"),
4376 Qnil, Qnil);
4377 if (STRINGP (value))
4379 /* VALUE should be of the form CLASS-DEPTH, where CLASS is one
4380 of `PseudoColor', `TrueColor' etc. and DEPTH is the color
4381 depth, a decimal number. NAME is compared with case ignored. */
4382 char *s = alloca (SBYTES (value) + 1);
4383 char *dash;
4384 int i, class = -1;
4385 XVisualInfo vinfo;
4387 strcpy (s, SSDATA (value));
4388 dash = strchr (s, '-');
4389 if (dash)
4391 dpyinfo->n_planes = atoi (dash + 1);
4392 *dash = '\0';
4394 else
4395 /* We won't find a matching visual with depth 0, so that
4396 an error will be printed below. */
4397 dpyinfo->n_planes = 0;
4399 /* Determine the visual class. */
4400 for (i = 0; visual_classes[i].name; ++i)
4401 if (xstrcasecmp (s, visual_classes[i].name) == 0)
4403 class = visual_classes[i].class;
4404 break;
4407 /* Look up a matching visual for the specified class. */
4408 if (class == -1
4409 || !XMatchVisualInfo (dpy, XScreenNumberOfScreen (screen),
4410 dpyinfo->n_planes, class, &vinfo))
4411 fatal ("Invalid visual specification `%s'", SDATA (value));
4413 dpyinfo->visual = vinfo.visual;
4415 else
4417 int n_visuals;
4418 XVisualInfo *vinfo, vinfo_template;
4420 dpyinfo->visual = DefaultVisualOfScreen (screen);
4422 vinfo_template.visualid = XVisualIDFromVisual (dpyinfo->visual);
4423 vinfo_template.screen = XScreenNumberOfScreen (screen);
4424 vinfo = XGetVisualInfo (dpy, VisualIDMask | VisualScreenMask,
4425 &vinfo_template, &n_visuals);
4426 if (n_visuals <= 0)
4427 fatal ("Can't get proper X visual info");
4429 dpyinfo->n_planes = vinfo->depth;
4430 XFree (vinfo);
4435 /* Return the X display structure for the display named NAME.
4436 Open a new connection if necessary. */
4438 static struct x_display_info *
4439 x_display_info_for_name (Lisp_Object name)
4441 Lisp_Object names;
4442 struct x_display_info *dpyinfo;
4444 CHECK_STRING (name);
4446 #if 0
4447 if (! EQ (Vinitial_window_system, intern ("x")))
4448 error ("Not using X Windows"); /* That doesn't stop us anymore. */
4449 #endif
4451 for (dpyinfo = x_display_list, names = x_display_name_list;
4452 dpyinfo;
4453 dpyinfo = dpyinfo->next, names = XCDR (names))
4455 Lisp_Object tem;
4456 tem = Fstring_equal (XCAR (XCAR (names)), name);
4457 if (!NILP (tem))
4458 return dpyinfo;
4461 /* Use this general default value to start with. */
4462 Vx_resource_name = Vinvocation_name;
4464 validate_x_resource_name ();
4466 dpyinfo = x_term_init (name, (char *)0,
4467 SSDATA (Vx_resource_name));
4469 if (dpyinfo == 0)
4470 error ("Cannot connect to X server %s", SDATA (name));
4472 XSETFASTINT (Vwindow_system_version, 11);
4474 return dpyinfo;
4478 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
4479 1, 3, 0,
4480 doc: /* Open a connection to a display server.
4481 DISPLAY is the name of the display to connect to.
4482 Optional second arg XRM-STRING is a string of resources in xrdb format.
4483 If the optional third arg MUST-SUCCEED is non-nil,
4484 terminate Emacs if we can't open the connection.
4485 \(In the Nextstep version, the last two arguments are currently ignored.) */)
4486 (Lisp_Object display, Lisp_Object xrm_string, Lisp_Object must_succeed)
4488 char *xrm_option;
4489 struct x_display_info *dpyinfo;
4491 CHECK_STRING (display);
4492 if (! NILP (xrm_string))
4493 CHECK_STRING (xrm_string);
4495 #if 0
4496 if (! EQ (Vinitial_window_system, intern ("x")))
4497 error ("Not using X Windows"); /* That doesn't stop us anymore. */
4498 #endif
4500 if (! NILP (xrm_string))
4501 xrm_option = SSDATA (xrm_string);
4502 else
4503 xrm_option = (char *) 0;
4505 validate_x_resource_name ();
4507 /* This is what opens the connection and sets x_current_display.
4508 This also initializes many symbols, such as those used for input. */
4509 dpyinfo = x_term_init (display, xrm_option,
4510 SSDATA (Vx_resource_name));
4512 if (dpyinfo == 0)
4514 if (!NILP (must_succeed))
4515 fatal ("Cannot connect to X server %s.\n\
4516 Check the DISPLAY environment variable or use `-d'.\n\
4517 Also use the `xauth' program to verify that you have the proper\n\
4518 authorization information needed to connect the X server.\n\
4519 An insecure way to solve the problem may be to use `xhost'.\n",
4520 SDATA (display));
4521 else
4522 error ("Cannot connect to X server %s", SDATA (display));
4525 XSETFASTINT (Vwindow_system_version, 11);
4526 return Qnil;
4529 DEFUN ("x-close-connection", Fx_close_connection,
4530 Sx_close_connection, 1, 1, 0,
4531 doc: /* Close the connection to TERMINAL's X server.
4532 For TERMINAL, specify a terminal object, a frame or a display name (a
4533 string). If TERMINAL is nil, that stands for the selected frame's
4534 terminal. */)
4535 (Lisp_Object terminal)
4537 struct x_display_info *dpyinfo = check_x_display_info (terminal);
4539 if (dpyinfo->reference_count > 0)
4540 error ("Display still has frames on it");
4542 x_delete_terminal (dpyinfo->terminal);
4544 return Qnil;
4547 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
4548 doc: /* Return the list of display names that Emacs has connections to. */)
4549 (void)
4551 Lisp_Object tail, result;
4553 result = Qnil;
4554 for (tail = x_display_name_list; CONSP (tail); tail = XCDR (tail))
4555 result = Fcons (XCAR (XCAR (tail)), result);
4557 return result;
4560 DEFUN ("x-synchronize", Fx_synchronize, Sx_synchronize, 1, 2, 0,
4561 doc: /* If ON is non-nil, report X errors as soon as the erring request is made.
4562 This function only has an effect on X Windows. With MS Windows, it is
4563 defined but does nothing.
4565 If ON is nil, allow buffering of requests.
4566 Turning on synchronization prohibits the Xlib routines from buffering
4567 requests and seriously degrades performance, but makes debugging much
4568 easier.
4569 The optional second argument TERMINAL specifies which display to act on.
4570 TERMINAL should be a terminal object, a frame or a display name (a string).
4571 If TERMINAL is omitted or nil, that stands for the selected frame's display. */)
4572 (Lisp_Object on, Lisp_Object terminal)
4574 struct x_display_info *dpyinfo = check_x_display_info (terminal);
4576 XSynchronize (dpyinfo->display, !EQ (on, Qnil));
4578 return Qnil;
4581 /* Wait for responses to all X commands issued so far for frame F. */
4583 void
4584 x_sync (struct frame *f)
4586 block_input ();
4587 XSync (FRAME_X_DISPLAY (f), False);
4588 unblock_input ();
4592 /***********************************************************************
4593 Window properties
4594 ***********************************************************************/
4596 DEFUN ("x-change-window-property", Fx_change_window_property,
4597 Sx_change_window_property, 2, 6, 0,
4598 doc: /* Change window property PROP to VALUE on the X window of FRAME.
4599 PROP must be a string. VALUE may be a string or a list of conses,
4600 numbers and/or strings. If an element in the list is a string, it is
4601 converted to an atom and the value of the atom is used. If an element
4602 is a cons, it is converted to a 32 bit number where the car is the 16
4603 top bits and the cdr is the lower 16 bits.
4605 FRAME nil or omitted means use the selected frame.
4606 If TYPE is given and non-nil, it is the name of the type of VALUE.
4607 If TYPE is not given or nil, the type is STRING.
4608 FORMAT gives the size in bits of each element if VALUE is a list.
4609 It must be one of 8, 16 or 32.
4610 If VALUE is a string or FORMAT is nil or not given, FORMAT defaults to 8.
4611 If OUTER-P is non-nil, the property is changed for the outer X window of
4612 FRAME. Default is to change on the edit X window. */)
4613 (Lisp_Object prop, Lisp_Object value, Lisp_Object frame,
4614 Lisp_Object type, Lisp_Object format, Lisp_Object outer_p)
4616 struct frame *f = decode_window_system_frame (frame);
4617 Atom prop_atom;
4618 Atom target_type = XA_STRING;
4619 int element_format = 8;
4620 unsigned char *data;
4621 int nelements;
4622 Window w;
4624 CHECK_STRING (prop);
4626 if (! NILP (format))
4628 CHECK_NUMBER (format);
4630 if (XINT (format) != 8 && XINT (format) != 16
4631 && XINT (format) != 32)
4632 error ("FORMAT must be one of 8, 16 or 32");
4633 element_format = XINT (format);
4636 if (CONSP (value))
4638 ptrdiff_t elsize;
4640 nelements = x_check_property_data (value);
4641 if (nelements == -1)
4642 error ("Bad data in VALUE, must be number, string or cons");
4644 /* The man page for XChangeProperty:
4645 "If the specified format is 32, the property data must be a
4646 long array."
4647 This applies even if long is more than 32 bits. The X library
4648 converts to 32 bits before sending to the X server. */
4649 elsize = element_format == 32 ? sizeof (long) : element_format >> 3;
4650 data = xnmalloc (nelements, elsize);
4652 x_fill_property_data (FRAME_X_DISPLAY (f), value, data, element_format);
4654 else
4656 CHECK_STRING (value);
4657 data = SDATA (value);
4658 if (INT_MAX < SBYTES (value))
4659 error ("VALUE too long");
4660 nelements = SBYTES (value);
4663 block_input ();
4664 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SSDATA (prop), False);
4665 if (! NILP (type))
4667 CHECK_STRING (type);
4668 target_type = XInternAtom (FRAME_X_DISPLAY (f), SSDATA (type), False);
4671 if (! NILP (outer_p)) w = FRAME_OUTER_WINDOW (f);
4672 else w = FRAME_X_WINDOW (f);
4674 XChangeProperty (FRAME_X_DISPLAY (f), w,
4675 prop_atom, target_type, element_format, PropModeReplace,
4676 data, nelements);
4678 if (CONSP (value)) xfree (data);
4680 /* Make sure the property is set when we return. */
4681 XFlush (FRAME_X_DISPLAY (f));
4682 unblock_input ();
4684 return value;
4688 DEFUN ("x-delete-window-property", Fx_delete_window_property,
4689 Sx_delete_window_property, 1, 2, 0,
4690 doc: /* Remove window property PROP from X window of FRAME.
4691 FRAME nil or omitted means use the selected frame. Value is PROP. */)
4692 (Lisp_Object prop, Lisp_Object frame)
4694 struct frame *f = decode_window_system_frame (frame);
4695 Atom prop_atom;
4697 CHECK_STRING (prop);
4698 block_input ();
4699 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SSDATA (prop), False);
4700 XDeleteProperty (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), prop_atom);
4702 /* Make sure the property is removed when we return. */
4703 XFlush (FRAME_X_DISPLAY (f));
4704 unblock_input ();
4706 return prop;
4710 DEFUN ("x-window-property", Fx_window_property, Sx_window_property,
4711 1, 6, 0,
4712 doc: /* Value is the value of window property PROP on FRAME.
4713 If FRAME is nil or omitted, use the selected frame.
4715 On X Windows, the following optional arguments are also accepted:
4716 If TYPE is nil or omitted, get the property as a string.
4717 Otherwise TYPE is the name of the atom that denotes the type expected.
4718 If SOURCE is non-nil, get the property on that window instead of from
4719 FRAME. The number 0 denotes the root window.
4720 If DELETE-P is non-nil, delete the property after retrieving it.
4721 If VECTOR-RET-P is non-nil, don't return a string but a vector of values.
4723 On MS Windows, this function accepts but ignores those optional arguments.
4725 Value is nil if FRAME hasn't a property with name PROP or if PROP has
4726 no value of TYPE (always string in the MS Windows case). */)
4727 (Lisp_Object prop, Lisp_Object frame, Lisp_Object type,
4728 Lisp_Object source, Lisp_Object delete_p, Lisp_Object vector_ret_p)
4730 struct frame *f = decode_window_system_frame (frame);
4731 Atom prop_atom;
4732 int rc;
4733 Lisp_Object prop_value = Qnil;
4734 unsigned char *tmp_data = NULL;
4735 Atom actual_type;
4736 Atom target_type = XA_STRING;
4737 int actual_format;
4738 unsigned long actual_size, bytes_remaining;
4739 Window target_window = FRAME_X_WINDOW (f);
4740 struct gcpro gcpro1;
4742 GCPRO1 (prop_value);
4743 CHECK_STRING (prop);
4745 if (! NILP (source))
4747 CONS_TO_INTEGER (source, Window, target_window);
4748 if (! target_window)
4749 target_window = FRAME_X_DISPLAY_INFO (f)->root_window;
4752 block_input ();
4753 if (STRINGP (type))
4755 if (strcmp ("AnyPropertyType", SSDATA (type)) == 0)
4756 target_type = AnyPropertyType;
4757 else
4758 target_type = XInternAtom (FRAME_X_DISPLAY (f), SSDATA (type), False);
4761 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SSDATA (prop), False);
4762 rc = XGetWindowProperty (FRAME_X_DISPLAY (f), target_window,
4763 prop_atom, 0, 0, False, target_type,
4764 &actual_type, &actual_format, &actual_size,
4765 &bytes_remaining, &tmp_data);
4766 if (rc == Success)
4768 int size = bytes_remaining;
4770 XFree (tmp_data);
4771 tmp_data = NULL;
4773 rc = XGetWindowProperty (FRAME_X_DISPLAY (f), target_window,
4774 prop_atom, 0, bytes_remaining,
4775 ! NILP (delete_p), target_type,
4776 &actual_type, &actual_format,
4777 &actual_size, &bytes_remaining,
4778 &tmp_data);
4779 if (rc == Success && tmp_data)
4781 /* The man page for XGetWindowProperty says:
4782 "If the returned format is 32, the returned data is represented
4783 as a long array and should be cast to that type to obtain the
4784 elements."
4785 This applies even if long is more than 32 bits, the X library
4786 converts from 32 bit elements received from the X server to long
4787 and passes the long array to us. Thus, for that case memcpy can not
4788 be used. We convert to a 32 bit type here, because so much code
4789 assume on that.
4791 The bytes and offsets passed to XGetWindowProperty refers to the
4792 property and those are indeed in 32 bit quantities if format is
4793 32. */
4795 if (BITS_PER_LONG > 32 && actual_format == 32)
4797 unsigned long i;
4798 int *idata = (int *) tmp_data;
4799 long *ldata = (long *) tmp_data;
4801 for (i = 0; i < actual_size; ++i)
4802 idata[i] = (int) ldata[i];
4805 if (NILP (vector_ret_p))
4806 prop_value = make_string ((char *) tmp_data, size);
4807 else
4808 prop_value = x_property_data_to_lisp (f,
4809 tmp_data,
4810 actual_type,
4811 actual_format,
4812 actual_size);
4815 if (tmp_data) XFree (tmp_data);
4818 unblock_input ();
4819 UNGCPRO;
4820 return prop_value;
4825 /***********************************************************************
4826 Busy cursor
4827 ***********************************************************************/
4829 /* Timer function of hourglass_atimer. TIMER is equal to
4830 hourglass_atimer.
4832 Display an hourglass pointer on all frames by mapping the frames'
4833 hourglass_window. Set the hourglass_p flag in the frames'
4834 output_data.x structure to indicate that an hourglass cursor is
4835 shown on the frames. */
4837 void
4838 show_hourglass (struct atimer *timer)
4840 /* The timer implementation will cancel this timer automatically
4841 after this function has run. Set hourglass_atimer to null
4842 so that we know the timer doesn't have to be canceled. */
4843 hourglass_atimer = NULL;
4845 if (!hourglass_shown_p)
4847 Lisp_Object rest, frame;
4849 block_input ();
4851 FOR_EACH_FRAME (rest, frame)
4853 struct frame *f = XFRAME (frame);
4855 if (FRAME_LIVE_P (f) && FRAME_X_P (f) && FRAME_X_DISPLAY (f))
4857 Display *dpy = FRAME_X_DISPLAY (f);
4859 #ifdef USE_X_TOOLKIT
4860 if (f->output_data.x->widget)
4861 #else
4862 if (FRAME_OUTER_WINDOW (f))
4863 #endif
4865 f->output_data.x->hourglass_p = 1;
4867 if (!f->output_data.x->hourglass_window)
4869 unsigned long mask = CWCursor;
4870 XSetWindowAttributes attrs;
4871 #ifdef USE_GTK
4872 Window parent = FRAME_X_WINDOW (f);
4873 #else
4874 Window parent = FRAME_OUTER_WINDOW (f);
4875 #endif
4876 attrs.cursor = f->output_data.x->hourglass_cursor;
4878 f->output_data.x->hourglass_window
4879 = XCreateWindow (dpy, parent,
4880 0, 0, 32000, 32000, 0, 0,
4881 InputOnly,
4882 CopyFromParent,
4883 mask, &attrs);
4886 XMapRaised (dpy, f->output_data.x->hourglass_window);
4887 XFlush (dpy);
4892 hourglass_shown_p = 1;
4893 unblock_input ();
4898 /* Hide the hourglass pointer on all frames, if it is currently
4899 shown. */
4901 void
4902 hide_hourglass (void)
4904 if (hourglass_shown_p)
4906 Lisp_Object rest, frame;
4908 block_input ();
4909 FOR_EACH_FRAME (rest, frame)
4911 struct frame *f = XFRAME (frame);
4913 if (FRAME_X_P (f)
4914 /* Watch out for newly created frames. */
4915 && f->output_data.x->hourglass_window)
4917 XUnmapWindow (FRAME_X_DISPLAY (f),
4918 f->output_data.x->hourglass_window);
4919 /* Sync here because XTread_socket looks at the
4920 hourglass_p flag that is reset to zero below. */
4921 XSync (FRAME_X_DISPLAY (f), False);
4922 f->output_data.x->hourglass_p = 0;
4926 hourglass_shown_p = 0;
4927 unblock_input ();
4933 /***********************************************************************
4934 Tool tips
4935 ***********************************************************************/
4937 static Lisp_Object x_create_tip_frame (struct x_display_info *,
4938 Lisp_Object, Lisp_Object);
4939 static void compute_tip_xy (struct frame *, Lisp_Object, Lisp_Object,
4940 Lisp_Object, int, int, int *, int *);
4942 /* The frame of a currently visible tooltip. */
4944 Lisp_Object tip_frame;
4946 /* If non-nil, a timer started that hides the last tooltip when it
4947 fires. */
4949 static Lisp_Object tip_timer;
4950 Window tip_window;
4952 /* If non-nil, a vector of 3 elements containing the last args
4953 with which x-show-tip was called. See there. */
4955 static Lisp_Object last_show_tip_args;
4958 static void
4959 unwind_create_tip_frame (Lisp_Object frame)
4961 Lisp_Object deleted;
4963 deleted = unwind_create_frame (frame);
4964 if (EQ (deleted, Qt))
4966 tip_window = None;
4967 tip_frame = Qnil;
4972 /* Create a frame for a tooltip on the display described by DPYINFO.
4973 PARMS is a list of frame parameters. TEXT is the string to
4974 display in the tip frame. Value is the frame.
4976 Note that functions called here, esp. x_default_parameter can
4977 signal errors, for instance when a specified color name is
4978 undefined. We have to make sure that we're in a consistent state
4979 when this happens. */
4981 static Lisp_Object
4982 x_create_tip_frame (struct x_display_info *dpyinfo,
4983 Lisp_Object parms,
4984 Lisp_Object text)
4986 struct frame *f;
4987 Lisp_Object frame;
4988 Lisp_Object name;
4989 int width, height;
4990 ptrdiff_t count = SPECPDL_INDEX ();
4991 struct gcpro gcpro1, gcpro2, gcpro3;
4992 int face_change_count_before = face_change_count;
4993 Lisp_Object buffer;
4994 struct buffer *old_buffer;
4996 if (!dpyinfo->terminal->name)
4997 error ("Terminal is not live, can't create new frames on it");
4999 parms = Fcopy_alist (parms);
5001 /* Get the name of the frame to use for resource lookup. */
5002 name = x_get_arg (dpyinfo, parms, Qname, "name", "Name", RES_TYPE_STRING);
5003 if (!STRINGP (name)
5004 && !EQ (name, Qunbound)
5005 && !NILP (name))
5006 error ("Invalid frame name--not a string or nil");
5008 frame = Qnil;
5009 GCPRO3 (parms, name, frame);
5010 f = make_frame (1);
5011 XSETFRAME (frame, f);
5013 buffer = Fget_buffer_create (build_string (" *tip*"));
5014 /* Use set_window_buffer instead of Fset_window_buffer (see
5015 discussion of bug#11984, bug#12025, bug#12026). */
5016 set_window_buffer (FRAME_ROOT_WINDOW (f), buffer, 0, 0);
5017 old_buffer = current_buffer;
5018 set_buffer_internal_1 (XBUFFER (buffer));
5019 bset_truncate_lines (current_buffer, Qnil);
5020 specbind (Qinhibit_read_only, Qt);
5021 specbind (Qinhibit_modification_hooks, Qt);
5022 Ferase_buffer ();
5023 Finsert (1, &text);
5024 set_buffer_internal_1 (old_buffer);
5026 record_unwind_protect (unwind_create_tip_frame, frame);
5028 f->terminal = dpyinfo->terminal;
5030 /* By setting the output method, we're essentially saying that
5031 the frame is live, as per FRAME_LIVE_P. If we get a signal
5032 from this point on, x_destroy_window might screw up reference
5033 counts etc. */
5034 f->output_method = output_x_window;
5035 f->output_data.x = xzalloc (sizeof *f->output_data.x);
5036 f->output_data.x->icon_bitmap = -1;
5037 FRAME_FONTSET (f) = -1;
5038 f->output_data.x->scroll_bar_foreground_pixel = -1;
5039 f->output_data.x->scroll_bar_background_pixel = -1;
5040 #ifdef USE_TOOLKIT_SCROLL_BARS
5041 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
5042 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
5043 #endif /* USE_TOOLKIT_SCROLL_BARS */
5044 fset_icon_name (f, Qnil);
5045 FRAME_X_DISPLAY_INFO (f) = dpyinfo;
5046 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
5047 f->output_data.x->explicit_parent = 0;
5049 /* These colors will be set anyway later, but it's important
5050 to get the color reference counts right, so initialize them! */
5052 Lisp_Object black;
5053 struct gcpro gcpro1;
5055 /* Function x_decode_color can signal an error. Make
5056 sure to initialize color slots so that we won't try
5057 to free colors we haven't allocated. */
5058 FRAME_FOREGROUND_PIXEL (f) = -1;
5059 FRAME_BACKGROUND_PIXEL (f) = -1;
5060 f->output_data.x->cursor_pixel = -1;
5061 f->output_data.x->cursor_foreground_pixel = -1;
5062 f->output_data.x->border_pixel = -1;
5063 f->output_data.x->mouse_pixel = -1;
5065 black = build_string ("black");
5066 GCPRO1 (black);
5067 FRAME_FOREGROUND_PIXEL (f)
5068 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
5069 FRAME_BACKGROUND_PIXEL (f)
5070 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
5071 f->output_data.x->cursor_pixel
5072 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
5073 f->output_data.x->cursor_foreground_pixel
5074 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
5075 f->output_data.x->border_pixel
5076 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
5077 f->output_data.x->mouse_pixel
5078 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
5079 UNGCPRO;
5082 /* Set the name; the functions to which we pass f expect the name to
5083 be set. */
5084 if (EQ (name, Qunbound) || NILP (name))
5086 fset_name (f, build_string (dpyinfo->x_id_name));
5087 f->explicit_name = 0;
5089 else
5091 fset_name (f, name);
5092 f->explicit_name = 1;
5093 /* use the frame's title when getting resources for this frame. */
5094 specbind (Qx_resource_name, name);
5097 register_font_driver (&xfont_driver, f);
5098 #ifdef HAVE_FREETYPE
5099 #ifdef HAVE_XFT
5100 register_font_driver (&xftfont_driver, f);
5101 #else /* not HAVE_XFT */
5102 register_font_driver (&ftxfont_driver, f);
5103 #endif /* not HAVE_XFT */
5104 #endif /* HAVE_FREETYPE */
5106 x_default_parameter (f, parms, Qfont_backend, Qnil,
5107 "fontBackend", "FontBackend", RES_TYPE_STRING);
5109 /* Extract the window parameters from the supplied values that are
5110 needed to determine window geometry. */
5111 x_default_font_parameter (f, parms);
5113 x_default_parameter (f, parms, Qborder_width, make_number (0),
5114 "borderWidth", "BorderWidth", RES_TYPE_NUMBER);
5116 /* This defaults to 2 in order to match xterm. We recognize either
5117 internalBorderWidth or internalBorder (which is what xterm calls
5118 it). */
5119 if (NILP (Fassq (Qinternal_border_width, parms)))
5121 Lisp_Object value;
5123 value = x_get_arg (dpyinfo, parms, Qinternal_border_width,
5124 "internalBorder", "internalBorder", RES_TYPE_NUMBER);
5125 if (! EQ (value, Qunbound))
5126 parms = Fcons (Fcons (Qinternal_border_width, value),
5127 parms);
5130 x_default_parameter (f, parms, Qinternal_border_width, make_number (1),
5131 "internalBorderWidth", "internalBorderWidth",
5132 RES_TYPE_NUMBER);
5134 /* Also do the stuff which must be set before the window exists. */
5135 x_default_parameter (f, parms, Qforeground_color, build_string ("black"),
5136 "foreground", "Foreground", RES_TYPE_STRING);
5137 x_default_parameter (f, parms, Qbackground_color, build_string ("white"),
5138 "background", "Background", RES_TYPE_STRING);
5139 x_default_parameter (f, parms, Qmouse_color, build_string ("black"),
5140 "pointerColor", "Foreground", RES_TYPE_STRING);
5141 x_default_parameter (f, parms, Qcursor_color, build_string ("black"),
5142 "cursorColor", "Foreground", RES_TYPE_STRING);
5143 x_default_parameter (f, parms, Qborder_color, build_string ("black"),
5144 "borderColor", "BorderColor", RES_TYPE_STRING);
5146 #ifdef GLYPH_DEBUG
5147 image_cache_refcount =
5148 FRAME_IMAGE_CACHE (f) ? FRAME_IMAGE_CACHE (f)->refcount : 0;
5149 dpyinfo_refcount = dpyinfo->reference_count;
5150 #endif /* GLYPH_DEBUG */
5152 /* Init faces before x_default_parameter is called for scroll-bar
5153 parameters because that function calls x_set_scroll_bar_width,
5154 which calls change_frame_size, which calls Fset_window_buffer,
5155 which runs hooks, which call Fvertical_motion. At the end, we
5156 end up in init_iterator with a null face cache, which should not
5157 happen. */
5158 init_frame_faces (f);
5160 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
5162 x_figure_window_size (f, parms, 0);
5165 XSetWindowAttributes attrs;
5166 unsigned long mask;
5167 Atom type = FRAME_X_DISPLAY_INFO (f)->Xatom_net_window_type_tooltip;
5169 block_input ();
5170 mask = CWBackPixel | CWOverrideRedirect | CWEventMask;
5171 if (DoesSaveUnders (dpyinfo->screen))
5172 mask |= CWSaveUnder;
5174 /* Window managers look at the override-redirect flag to determine
5175 whether or net to give windows a decoration (Xlib spec, chapter
5176 3.2.8). */
5177 attrs.override_redirect = True;
5178 attrs.save_under = True;
5179 attrs.background_pixel = FRAME_BACKGROUND_PIXEL (f);
5180 /* Arrange for getting MapNotify and UnmapNotify events. */
5181 attrs.event_mask = StructureNotifyMask;
5182 tip_window
5183 = FRAME_X_WINDOW (f)
5184 = XCreateWindow (FRAME_X_DISPLAY (f),
5185 FRAME_X_DISPLAY_INFO (f)->root_window,
5186 /* x, y, width, height */
5187 0, 0, 1, 1,
5188 /* Border. */
5189 f->border_width,
5190 CopyFromParent, InputOutput, CopyFromParent,
5191 mask, &attrs);
5192 XChangeProperty (FRAME_X_DISPLAY (f), tip_window,
5193 FRAME_X_DISPLAY_INFO (f)->Xatom_net_window_type,
5194 XA_ATOM, 32, PropModeReplace,
5195 (unsigned char *)&type, 1);
5196 unblock_input ();
5199 x_make_gc (f);
5201 x_default_parameter (f, parms, Qauto_raise, Qnil,
5202 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
5203 x_default_parameter (f, parms, Qauto_lower, Qnil,
5204 "autoLower", "AutoRaiseLower", RES_TYPE_BOOLEAN);
5205 x_default_parameter (f, parms, Qcursor_type, Qbox,
5206 "cursorType", "CursorType", RES_TYPE_SYMBOL);
5208 /* Dimensions, especially FRAME_LINES (f), must be done via change_frame_size.
5209 Change will not be effected unless different from the current
5210 FRAME_LINES (f). */
5211 width = FRAME_COLS (f);
5212 height = FRAME_LINES (f);
5213 SET_FRAME_COLS (f, 0);
5214 FRAME_LINES (f) = 0;
5215 change_frame_size (f, height, width, 1, 0, 0);
5217 /* Add `tooltip' frame parameter's default value. */
5218 if (NILP (Fframe_parameter (frame, Qtooltip)))
5219 Fmodify_frame_parameters (frame, list1 (Fcons (Qtooltip, Qt)));
5221 /* FIXME - can this be done in a similar way to normal frames?
5222 http://lists.gnu.org/archive/html/emacs-devel/2007-10/msg00641.html */
5224 /* Set the `display-type' frame parameter before setting up faces. */
5226 Lisp_Object disptype;
5228 if (FRAME_X_DISPLAY_INFO (f)->n_planes == 1)
5229 disptype = intern ("mono");
5230 else if (FRAME_X_DISPLAY_INFO (f)->visual->class == GrayScale
5231 || FRAME_X_DISPLAY_INFO (f)->visual->class == StaticGray)
5232 disptype = intern ("grayscale");
5233 else
5234 disptype = intern ("color");
5236 if (NILP (Fframe_parameter (frame, Qdisplay_type)))
5237 Fmodify_frame_parameters (frame, list1 (Fcons (Qdisplay_type, disptype)));
5240 /* Set up faces after all frame parameters are known. This call
5241 also merges in face attributes specified for new frames.
5243 Frame parameters may be changed if .Xdefaults contains
5244 specifications for the default font. For example, if there is an
5245 `Emacs.default.attributeBackground: pink', the `background-color'
5246 attribute of the frame get's set, which let's the internal border
5247 of the tooltip frame appear in pink. Prevent this. */
5249 Lisp_Object bg = Fframe_parameter (frame, Qbackground_color);
5251 /* Set tip_frame here, so that */
5252 tip_frame = frame;
5253 call2 (Qface_set_after_frame_default, frame, Qnil);
5255 if (!EQ (bg, Fframe_parameter (frame, Qbackground_color)))
5256 Fmodify_frame_parameters (frame, list1 (Fcons (Qbackground_color, bg)));
5259 f->no_split = 1;
5261 UNGCPRO;
5263 /* Now that the frame will be official, it counts as a reference to
5264 its display and terminal. */
5265 FRAME_X_DISPLAY_INFO (f)->reference_count++;
5266 f->terminal->reference_count++;
5268 /* It is now ok to make the frame official even if we get an error
5269 below. And the frame needs to be on Vframe_list or making it
5270 visible won't work. */
5271 Vframe_list = Fcons (frame, Vframe_list);
5274 /* Setting attributes of faces of the tooltip frame from resources
5275 and similar will increment face_change_count, which leads to the
5276 clearing of all current matrices. Since this isn't necessary
5277 here, avoid it by resetting face_change_count to the value it
5278 had before we created the tip frame. */
5279 face_change_count = face_change_count_before;
5281 /* Discard the unwind_protect. */
5282 return unbind_to (count, frame);
5286 /* Compute where to display tip frame F. PARMS is the list of frame
5287 parameters for F. DX and DY are specified offsets from the current
5288 location of the mouse. WIDTH and HEIGHT are the width and height
5289 of the tooltip. Return coordinates relative to the root window of
5290 the display in *ROOT_X, and *ROOT_Y. */
5292 static void
5293 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)
5295 Lisp_Object left, top;
5296 int win_x, win_y;
5297 Window root, child;
5298 unsigned pmask;
5300 /* User-specified position? */
5301 left = Fcdr (Fassq (Qleft, parms));
5302 top = Fcdr (Fassq (Qtop, parms));
5304 /* Move the tooltip window where the mouse pointer is. Resize and
5305 show it. */
5306 if (!INTEGERP (left) || !INTEGERP (top))
5308 block_input ();
5309 XQueryPointer (FRAME_X_DISPLAY (f), FRAME_X_DISPLAY_INFO (f)->root_window,
5310 &root, &child, root_x, root_y, &win_x, &win_y, &pmask);
5311 unblock_input ();
5314 if (INTEGERP (top))
5315 *root_y = XINT (top);
5316 else if (*root_y + XINT (dy) <= 0)
5317 *root_y = 0; /* Can happen for negative dy */
5318 else if (*root_y + XINT (dy) + height
5319 <= x_display_pixel_height (FRAME_X_DISPLAY_INFO (f)))
5320 /* It fits below the pointer */
5321 *root_y += XINT (dy);
5322 else if (height + XINT (dy) <= *root_y)
5323 /* It fits above the pointer. */
5324 *root_y -= height + XINT (dy);
5325 else
5326 /* Put it on the top. */
5327 *root_y = 0;
5329 if (INTEGERP (left))
5330 *root_x = XINT (left);
5331 else if (*root_x + XINT (dx) <= 0)
5332 *root_x = 0; /* Can happen for negative dx */
5333 else if (*root_x + XINT (dx) + width
5334 <= x_display_pixel_width (FRAME_X_DISPLAY_INFO (f)))
5335 /* It fits to the right of the pointer. */
5336 *root_x += XINT (dx);
5337 else if (width + XINT (dx) <= *root_x)
5338 /* It fits to the left of the pointer. */
5339 *root_x -= width + XINT (dx);
5340 else
5341 /* Put it left-justified on the screen--it ought to fit that way. */
5342 *root_x = 0;
5346 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
5347 doc: /* Show STRING in a "tooltip" window on frame FRAME.
5348 A tooltip window is a small X window displaying a string.
5350 This is an internal function; Lisp code should call `tooltip-show'.
5352 FRAME nil or omitted means use the selected frame.
5354 PARMS is an optional list of frame parameters which can be used to
5355 change the tooltip's appearance.
5357 Automatically hide the tooltip after TIMEOUT seconds. TIMEOUT nil
5358 means use the default timeout of 5 seconds.
5360 If the list of frame parameters PARMS contains a `left' parameters,
5361 the tooltip is displayed at that x-position. Otherwise it is
5362 displayed at the mouse position, with offset DX added (default is 5 if
5363 DX isn't specified). Likewise for the y-position; if a `top' frame
5364 parameter is specified, it determines the y-position of the tooltip
5365 window, otherwise it is displayed at the mouse position, with offset
5366 DY added (default is -10).
5368 A tooltip's maximum size is specified by `x-max-tooltip-size'.
5369 Text larger than the specified size is clipped. */)
5370 (Lisp_Object string, Lisp_Object frame, Lisp_Object parms, Lisp_Object timeout, Lisp_Object dx, Lisp_Object dy)
5372 struct frame *f;
5373 struct window *w;
5374 int root_x, root_y;
5375 struct buffer *old_buffer;
5376 struct text_pos pos;
5377 int i, width, height, seen_reversed_p;
5378 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
5379 int old_windows_or_buffers_changed = windows_or_buffers_changed;
5380 ptrdiff_t count = SPECPDL_INDEX ();
5382 specbind (Qinhibit_redisplay, Qt);
5384 GCPRO4 (string, parms, frame, timeout);
5386 CHECK_STRING (string);
5387 if (SCHARS (string) == 0)
5388 string = make_unibyte_string (" ", 1);
5390 f = decode_window_system_frame (frame);
5391 if (NILP (timeout))
5392 timeout = make_number (5);
5393 else
5394 CHECK_NATNUM (timeout);
5396 if (NILP (dx))
5397 dx = make_number (5);
5398 else
5399 CHECK_NUMBER (dx);
5401 if (NILP (dy))
5402 dy = make_number (-10);
5403 else
5404 CHECK_NUMBER (dy);
5406 #ifdef USE_GTK
5407 if (x_gtk_use_system_tooltips)
5409 bool ok;
5411 /* Hide a previous tip, if any. */
5412 Fx_hide_tip ();
5414 block_input ();
5415 ok = xg_prepare_tooltip (f, string, &width, &height);
5416 if (ok)
5418 compute_tip_xy (f, parms, dx, dy, width, height, &root_x, &root_y);
5419 xg_show_tooltip (f, root_x, root_y);
5420 /* This is used in Fx_hide_tip. */
5421 XSETFRAME (tip_frame, f);
5423 unblock_input ();
5424 if (ok) goto start_timer;
5426 #endif /* USE_GTK */
5428 if (NILP (last_show_tip_args))
5429 last_show_tip_args = Fmake_vector (make_number (3), Qnil);
5431 if (!NILP (tip_frame))
5433 Lisp_Object last_string = AREF (last_show_tip_args, 0);
5434 Lisp_Object last_frame = AREF (last_show_tip_args, 1);
5435 Lisp_Object last_parms = AREF (last_show_tip_args, 2);
5437 if (EQ (frame, last_frame)
5438 && !NILP (Fequal (last_string, string))
5439 && !NILP (Fequal (last_parms, parms)))
5441 struct frame *tip_f = XFRAME (tip_frame);
5443 /* Only DX and DY have changed. */
5444 if (!NILP (tip_timer))
5446 Lisp_Object timer = tip_timer;
5447 tip_timer = Qnil;
5448 call1 (Qcancel_timer, timer);
5451 block_input ();
5452 compute_tip_xy (tip_f, parms, dx, dy, FRAME_PIXEL_WIDTH (tip_f),
5453 FRAME_PIXEL_HEIGHT (tip_f), &root_x, &root_y);
5454 XMoveWindow (FRAME_X_DISPLAY (tip_f), FRAME_X_WINDOW (tip_f),
5455 root_x, root_y);
5456 unblock_input ();
5457 goto start_timer;
5461 /* Hide a previous tip, if any. */
5462 Fx_hide_tip ();
5464 ASET (last_show_tip_args, 0, string);
5465 ASET (last_show_tip_args, 1, frame);
5466 ASET (last_show_tip_args, 2, parms);
5468 /* Add default values to frame parameters. */
5469 if (NILP (Fassq (Qname, parms)))
5470 parms = Fcons (Fcons (Qname, build_string ("tooltip")), parms);
5471 if (NILP (Fassq (Qinternal_border_width, parms)))
5472 parms = Fcons (Fcons (Qinternal_border_width, make_number (3)), parms);
5473 if (NILP (Fassq (Qborder_width, parms)))
5474 parms = Fcons (Fcons (Qborder_width, make_number (1)), parms);
5475 if (NILP (Fassq (Qborder_color, parms)))
5476 parms = Fcons (Fcons (Qborder_color, build_string ("lightyellow")), parms);
5477 if (NILP (Fassq (Qbackground_color, parms)))
5478 parms = Fcons (Fcons (Qbackground_color, build_string ("lightyellow")),
5479 parms);
5481 /* Create a frame for the tooltip, and record it in the global
5482 variable tip_frame. */
5483 frame = x_create_tip_frame (FRAME_X_DISPLAY_INFO (f), parms, string);
5484 f = XFRAME (frame);
5486 /* Set up the frame's root window. */
5487 w = XWINDOW (FRAME_ROOT_WINDOW (f));
5488 w->left_col = 0;
5489 w->top_line = 0;
5491 if (CONSP (Vx_max_tooltip_size)
5492 && RANGED_INTEGERP (1, XCAR (Vx_max_tooltip_size), INT_MAX)
5493 && RANGED_INTEGERP (1, XCDR (Vx_max_tooltip_size), INT_MAX))
5495 w->total_cols = XFASTINT (XCAR (Vx_max_tooltip_size));
5496 w->total_lines = XFASTINT (XCDR (Vx_max_tooltip_size));
5498 else
5500 w->total_cols = 80;
5501 w->total_lines = 40;
5504 FRAME_TOTAL_COLS (f) = w->total_cols;
5505 adjust_glyphs (f);
5506 w->pseudo_window_p = 1;
5508 /* Display the tooltip text in a temporary buffer. */
5509 old_buffer = current_buffer;
5510 set_buffer_internal_1 (XBUFFER (XWINDOW (FRAME_ROOT_WINDOW (f))->contents));
5511 bset_truncate_lines (current_buffer, Qnil);
5512 clear_glyph_matrix (w->desired_matrix);
5513 clear_glyph_matrix (w->current_matrix);
5514 SET_TEXT_POS (pos, BEGV, BEGV_BYTE);
5515 try_window (FRAME_ROOT_WINDOW (f), pos, TRY_WINDOW_IGNORE_FONTS_CHANGE);
5517 /* Compute width and height of the tooltip. */
5518 width = height = seen_reversed_p = 0;
5519 for (i = 0; i < w->desired_matrix->nrows; ++i)
5521 struct glyph_row *row = &w->desired_matrix->rows[i];
5522 struct glyph *last;
5523 int row_width;
5525 /* Stop at the first empty row at the end. */
5526 if (!row->enabled_p || !MATRIX_ROW_DISPLAYS_TEXT_P (row))
5527 break;
5529 /* Let the row go over the full width of the frame. */
5530 row->full_width_p = 1;
5532 row_width = row->pixel_width;
5533 if (row->used[TEXT_AREA])
5535 /* There's a glyph at the end of rows that is used to place
5536 the cursor there. Don't include the width of this glyph. */
5537 if (!row->reversed_p)
5539 last = &row->glyphs[TEXT_AREA][row->used[TEXT_AREA] - 1];
5540 if (INTEGERP (last->object))
5541 row_width -= last->pixel_width;
5543 else
5545 /* There could be a stretch glyph at the beginning of R2L
5546 rows that is produced by extend_face_to_end_of_line.
5547 Don't count that glyph. */
5548 struct glyph *g = row->glyphs[TEXT_AREA];
5550 if (g->type == STRETCH_GLYPH && INTEGERP (g->object))
5552 row_width -= g->pixel_width;
5553 seen_reversed_p = 1;
5558 height += row->height;
5559 width = max (width, row_width);
5562 /* If we've seen partial-length R2L rows, we need to re-adjust the
5563 tool-tip frame width and redisplay it again, to avoid over-wide
5564 tips due to the stretch glyph that extends R2L lines to full
5565 width of the frame. */
5566 if (seen_reversed_p)
5568 /* w->total_cols and FRAME_TOTAL_COLS want the width in columns,
5569 not in pixels. */
5570 width /= WINDOW_FRAME_COLUMN_WIDTH (w);
5571 w->total_cols = width;
5572 FRAME_TOTAL_COLS (f) = width;
5573 adjust_glyphs (f);
5574 clear_glyph_matrix (w->desired_matrix);
5575 clear_glyph_matrix (w->current_matrix);
5576 try_window (FRAME_ROOT_WINDOW (f), pos, 0);
5577 width = height = 0;
5578 /* Recompute width and height of the tooltip. */
5579 for (i = 0; i < w->desired_matrix->nrows; ++i)
5581 struct glyph_row *row = &w->desired_matrix->rows[i];
5582 struct glyph *last;
5583 int row_width;
5585 if (!row->enabled_p || !MATRIX_ROW_DISPLAYS_TEXT_P (row))
5586 break;
5587 row->full_width_p = 1;
5588 row_width = row->pixel_width;
5589 if (row->used[TEXT_AREA] && !row->reversed_p)
5591 last = &row->glyphs[TEXT_AREA][row->used[TEXT_AREA] - 1];
5592 if (INTEGERP (last->object))
5593 row_width -= last->pixel_width;
5596 height += row->height;
5597 width = max (width, row_width);
5601 /* Add the frame's internal border to the width and height the X
5602 window should have. */
5603 height += 2 * FRAME_INTERNAL_BORDER_WIDTH (f);
5604 width += 2 * FRAME_INTERNAL_BORDER_WIDTH (f);
5606 /* Move the tooltip window where the mouse pointer is. Resize and
5607 show it. */
5608 compute_tip_xy (f, parms, dx, dy, width, height, &root_x, &root_y);
5610 block_input ();
5611 XMoveResizeWindow (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
5612 root_x, root_y, width, height);
5613 XMapRaised (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f));
5614 unblock_input ();
5616 /* Draw into the window. */
5617 w->must_be_updated_p = 1;
5618 update_single_window (w, 1);
5620 /* Restore original current buffer. */
5621 set_buffer_internal_1 (old_buffer);
5622 windows_or_buffers_changed = old_windows_or_buffers_changed;
5624 start_timer:
5625 /* Let the tip disappear after timeout seconds. */
5626 tip_timer = call3 (intern ("run-at-time"), timeout, Qnil,
5627 intern ("x-hide-tip"));
5629 UNGCPRO;
5630 return unbind_to (count, Qnil);
5634 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
5635 doc: /* Hide the current tooltip window, if there is any.
5636 Value is t if tooltip was open, nil otherwise. */)
5637 (void)
5639 ptrdiff_t count;
5640 Lisp_Object deleted, frame, timer;
5641 struct gcpro gcpro1, gcpro2;
5643 /* Return quickly if nothing to do. */
5644 if (NILP (tip_timer) && NILP (tip_frame))
5645 return Qnil;
5647 frame = tip_frame;
5648 timer = tip_timer;
5649 GCPRO2 (frame, timer);
5650 tip_frame = tip_timer = deleted = Qnil;
5652 count = SPECPDL_INDEX ();
5653 specbind (Qinhibit_redisplay, Qt);
5654 specbind (Qinhibit_quit, Qt);
5656 if (!NILP (timer))
5657 call1 (Qcancel_timer, timer);
5659 #ifdef USE_GTK
5661 /* When using system tooltip, tip_frame is the Emacs frame on which
5662 the tip is shown. */
5663 struct frame *f = XFRAME (frame);
5664 if (FRAME_LIVE_P (f) && xg_hide_tooltip (f))
5665 frame = Qnil;
5667 #endif
5669 if (FRAMEP (frame))
5671 delete_frame (frame, Qnil);
5672 deleted = Qt;
5674 #ifdef USE_LUCID
5675 /* Bloodcurdling hack alert: The Lucid menu bar widget's
5676 redisplay procedure is not called when a tip frame over menu
5677 items is unmapped. Redisplay the menu manually... */
5679 Widget w;
5680 struct frame *f = SELECTED_FRAME ();
5681 w = f->output_data.x->menubar_widget;
5683 if (!DoesSaveUnders (FRAME_X_DISPLAY_INFO (f)->screen)
5684 && w != NULL)
5686 block_input ();
5687 xlwmenu_redisplay (w);
5688 unblock_input ();
5691 #endif /* USE_LUCID */
5694 UNGCPRO;
5695 return unbind_to (count, deleted);
5700 /***********************************************************************
5701 File selection dialog
5702 ***********************************************************************/
5704 DEFUN ("x-uses-old-gtk-dialog", Fx_uses_old_gtk_dialog,
5705 Sx_uses_old_gtk_dialog,
5706 0, 0, 0,
5707 doc: /* Return t if the old Gtk+ file selection dialog is used. */)
5708 (void)
5710 #ifdef USE_GTK
5711 if (use_dialog_box
5712 && use_file_dialog
5713 && window_system_available (SELECTED_FRAME ())
5714 && xg_uses_old_file_dialog ())
5715 return Qt;
5716 #endif
5717 return Qnil;
5721 #ifdef USE_MOTIF
5722 /* Callback for "OK" and "Cancel" on file selection dialog. */
5724 static void
5725 file_dialog_cb (Widget widget, XtPointer client_data, XtPointer call_data)
5727 int *result = (int *) client_data;
5728 XmAnyCallbackStruct *cb = (XmAnyCallbackStruct *) call_data;
5729 *result = cb->reason;
5733 /* Callback for unmapping a file selection dialog. This is used to
5734 capture the case where a dialog is closed via a window manager's
5735 closer button, for example. Using a XmNdestroyCallback didn't work
5736 in this case. */
5738 static void
5739 file_dialog_unmap_cb (Widget widget, XtPointer client_data, XtPointer call_data)
5741 int *result = (int *) client_data;
5742 *result = XmCR_CANCEL;
5745 static void
5746 clean_up_file_dialog (void *arg)
5748 Widget dialog = arg;
5750 /* Clean up. */
5751 block_input ();
5752 XtUnmanageChild (dialog);
5753 XtDestroyWidget (dialog);
5754 x_menu_set_in_use (0);
5755 unblock_input ();
5759 DEFUN ("x-file-dialog", Fx_file_dialog, Sx_file_dialog, 2, 5, 0,
5760 doc: /* Read file name, prompting with PROMPT in directory DIR.
5761 Use a file selection dialog. Select DEFAULT-FILENAME in the dialog's file
5762 selection box, if specified. If MUSTMATCH is non-nil, the returned file
5763 or directory must exist.
5765 This function is only defined on NS, MS Windows, and X Windows with the
5766 Motif or Gtk toolkits. With the Motif toolkit, ONLY-DIR-P is ignored.
5767 Otherwise, if ONLY-DIR-P is non-nil, the user can only select directories. */)
5768 (Lisp_Object prompt, Lisp_Object dir, Lisp_Object default_filename,
5769 Lisp_Object mustmatch, Lisp_Object only_dir_p)
5771 int result;
5772 struct frame *f = SELECTED_FRAME ();
5773 Lisp_Object file = Qnil;
5774 Lisp_Object decoded_file;
5775 Widget dialog, text, help;
5776 Arg al[10];
5777 int ac = 0;
5778 XmString dir_xmstring, pattern_xmstring;
5779 ptrdiff_t count = SPECPDL_INDEX ();
5780 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
5782 check_window_system (f);
5784 GCPRO6 (prompt, dir, default_filename, mustmatch, only_dir_p, file);
5786 if (popup_activated ())
5787 error ("Trying to use a menu from within a menu-entry");
5789 CHECK_STRING (prompt);
5790 CHECK_STRING (dir);
5792 /* Prevent redisplay. */
5793 specbind (Qinhibit_redisplay, Qt);
5795 block_input ();
5797 /* Create the dialog with PROMPT as title, using DIR as initial
5798 directory and using "*" as pattern. */
5799 dir = Fexpand_file_name (dir, Qnil);
5800 dir_xmstring = XmStringCreateLocalized (SSDATA (dir));
5801 pattern_xmstring = XmStringCreateLocalized ("*");
5803 XtSetArg (al[ac], XmNtitle, SDATA (prompt)); ++ac;
5804 XtSetArg (al[ac], XmNdirectory, dir_xmstring); ++ac;
5805 XtSetArg (al[ac], XmNpattern, pattern_xmstring); ++ac;
5806 XtSetArg (al[ac], XmNresizePolicy, XmRESIZE_GROW); ++ac;
5807 XtSetArg (al[ac], XmNdialogStyle, XmDIALOG_APPLICATION_MODAL); ++ac;
5808 dialog = XmCreateFileSelectionDialog (f->output_data.x->widget,
5809 "fsb", al, ac);
5810 XmStringFree (dir_xmstring);
5811 XmStringFree (pattern_xmstring);
5813 /* Add callbacks for OK and Cancel. */
5814 XtAddCallback (dialog, XmNokCallback, file_dialog_cb,
5815 (XtPointer) &result);
5816 XtAddCallback (dialog, XmNcancelCallback, file_dialog_cb,
5817 (XtPointer) &result);
5818 XtAddCallback (dialog, XmNunmapCallback, file_dialog_unmap_cb,
5819 (XtPointer) &result);
5821 /* Remove the help button since we can't display help. */
5822 help = XmFileSelectionBoxGetChild (dialog, XmDIALOG_HELP_BUTTON);
5823 XtUnmanageChild (help);
5825 /* Mark OK button as default. */
5826 XtVaSetValues (XmFileSelectionBoxGetChild (dialog, XmDIALOG_OK_BUTTON),
5827 XmNshowAsDefault, True, NULL);
5829 /* If MUSTMATCH is non-nil, disable the file entry field of the
5830 dialog, so that the user must select a file from the files list
5831 box. We can't remove it because we wouldn't have a way to get at
5832 the result file name, then. */
5833 text = XmFileSelectionBoxGetChild (dialog, XmDIALOG_TEXT);
5834 if (!NILP (mustmatch))
5836 Widget label;
5837 label = XmFileSelectionBoxGetChild (dialog, XmDIALOG_SELECTION_LABEL);
5838 XtSetSensitive (text, False);
5839 XtSetSensitive (label, False);
5842 /* Manage the dialog, so that list boxes get filled. */
5843 XtManageChild (dialog);
5845 if (STRINGP (default_filename))
5847 XmString default_xmstring;
5848 Widget wtext = XmFileSelectionBoxGetChild (dialog, XmDIALOG_TEXT);
5849 Widget list = XmFileSelectionBoxGetChild (dialog, XmDIALOG_LIST);
5851 XmTextPosition last_pos = XmTextFieldGetLastPosition (wtext);
5852 XmTextFieldReplace (wtext, 0, last_pos,
5853 (SSDATA (Ffile_name_nondirectory (default_filename))));
5855 /* Select DEFAULT_FILENAME in the files list box. DEFAULT_FILENAME
5856 must include the path for this to work. */
5858 default_xmstring = XmStringCreateLocalized (SSDATA (default_filename));
5860 if (XmListItemExists (list, default_xmstring))
5862 int item_pos = XmListItemPos (list, default_xmstring);
5863 /* Select the item and scroll it into view. */
5864 XmListSelectPos (list, item_pos, True);
5865 XmListSetPos (list, item_pos);
5868 XmStringFree (default_xmstring);
5871 record_unwind_protect_ptr (clean_up_file_dialog, dialog);
5873 /* Process events until the user presses Cancel or OK. */
5874 x_menu_set_in_use (1);
5875 result = 0;
5876 while (result == 0)
5878 XEvent event;
5879 x_menu_wait_for_event (0);
5880 XtAppNextEvent (Xt_app_con, &event);
5881 if (event.type == KeyPress
5882 && FRAME_X_DISPLAY (f) == event.xkey.display)
5884 KeySym keysym = XLookupKeysym (&event.xkey, 0);
5886 /* Pop down on C-g. */
5887 if (keysym == XK_g && (event.xkey.state & ControlMask) != 0)
5888 XtUnmanageChild (dialog);
5891 (void) x_dispatch_event (&event, FRAME_X_DISPLAY (f));
5894 /* Get the result. */
5895 if (result == XmCR_OK)
5897 XmString text_string;
5898 String data;
5900 XtVaGetValues (dialog, XmNtextString, &text_string, NULL);
5901 XmStringGetLtoR (text_string, XmFONTLIST_DEFAULT_TAG, &data);
5902 XmStringFree (text_string);
5903 file = build_string (data);
5904 XtFree (data);
5906 else
5907 file = Qnil;
5909 unblock_input ();
5910 UNGCPRO;
5912 /* Make "Cancel" equivalent to C-g. */
5913 if (NILP (file))
5914 Fsignal (Qquit, Qnil);
5916 decoded_file = DECODE_FILE (file);
5918 return unbind_to (count, decoded_file);
5921 #endif /* USE_MOTIF */
5923 #ifdef USE_GTK
5925 static void
5926 clean_up_dialog (void)
5928 x_menu_set_in_use (0);
5931 DEFUN ("x-file-dialog", Fx_file_dialog, Sx_file_dialog, 2, 5, 0,
5932 doc: /* Read file name, prompting with PROMPT in directory DIR.
5933 Use a file selection dialog. Select DEFAULT-FILENAME in the dialog's file
5934 selection box, if specified. If MUSTMATCH is non-nil, the returned file
5935 or directory must exist.
5937 This function is only defined on NS, MS Windows, and X Windows with the
5938 Motif or Gtk toolkits. With the Motif toolkit, ONLY-DIR-P is ignored.
5939 Otherwise, if ONLY-DIR-P is non-nil, the user can only select directories. */)
5940 (Lisp_Object prompt, Lisp_Object dir, Lisp_Object default_filename, Lisp_Object mustmatch, Lisp_Object only_dir_p)
5942 struct frame *f = SELECTED_FRAME ();
5943 char *fn;
5944 Lisp_Object file = Qnil;
5945 Lisp_Object decoded_file;
5946 ptrdiff_t count = SPECPDL_INDEX ();
5947 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
5948 char *cdef_file;
5950 check_window_system (f);
5952 GCPRO6 (prompt, dir, default_filename, mustmatch, only_dir_p, file);
5954 if (popup_activated ())
5955 error ("Trying to use a menu from within a menu-entry");
5957 CHECK_STRING (prompt);
5958 CHECK_STRING (dir);
5960 /* Prevent redisplay. */
5961 specbind (Qinhibit_redisplay, Qt);
5962 record_unwind_protect_void (clean_up_dialog);
5964 block_input ();
5966 if (STRINGP (default_filename))
5967 cdef_file = SSDATA (default_filename);
5968 else
5969 cdef_file = SSDATA (dir);
5971 fn = xg_get_file_name (f, SSDATA (prompt), cdef_file,
5972 ! NILP (mustmatch),
5973 ! NILP (only_dir_p));
5975 if (fn)
5977 file = build_string (fn);
5978 xfree (fn);
5981 unblock_input ();
5982 UNGCPRO;
5984 /* Make "Cancel" equivalent to C-g. */
5985 if (NILP (file))
5986 Fsignal (Qquit, Qnil);
5988 decoded_file = DECODE_FILE (file);
5990 return unbind_to (count, decoded_file);
5994 #ifdef HAVE_FREETYPE
5996 DEFUN ("x-select-font", Fx_select_font, Sx_select_font, 0, 2, 0,
5997 doc: /* Read a font using a GTK dialog.
5998 Return either a font spec (for GTK versions >= 3.2) or a string
5999 containing a GTK-style font name.
6001 FRAME is the frame on which to pop up the font chooser. If omitted or
6002 nil, it defaults to the selected frame. */)
6003 (Lisp_Object frame, Lisp_Object ignored)
6005 struct frame *f = decode_window_system_frame (frame);
6006 Lisp_Object font;
6007 Lisp_Object font_param;
6008 char *default_name = NULL;
6009 struct gcpro gcpro1, gcpro2;
6010 ptrdiff_t count = SPECPDL_INDEX ();
6012 if (popup_activated ())
6013 error ("Trying to use a menu from within a menu-entry");
6015 /* Prevent redisplay. */
6016 specbind (Qinhibit_redisplay, Qt);
6017 record_unwind_protect_void (clean_up_dialog);
6019 block_input ();
6021 GCPRO2 (font_param, font);
6023 XSETFONT (font, FRAME_FONT (f));
6024 font_param = Ffont_get (font, intern (":name"));
6025 if (STRINGP (font_param))
6026 default_name = xstrdup (SSDATA (font_param));
6027 else
6029 font_param = Fframe_parameter (frame, Qfont_param);
6030 if (STRINGP (font_param))
6031 default_name = xstrdup (SSDATA (font_param));
6034 font = xg_get_font (f, default_name);
6035 xfree (default_name);
6037 unblock_input ();
6039 if (NILP (font))
6040 Fsignal (Qquit, Qnil);
6042 return unbind_to (count, font);
6044 #endif /* HAVE_FREETYPE */
6046 #endif /* USE_GTK */
6049 /***********************************************************************
6050 Keyboard
6051 ***********************************************************************/
6053 #ifdef HAVE_XKB
6054 #include <X11/XKBlib.h>
6055 #include <X11/keysym.h>
6056 #endif
6058 DEFUN ("x-backspace-delete-keys-p", Fx_backspace_delete_keys_p,
6059 Sx_backspace_delete_keys_p, 0, 1, 0,
6060 doc: /* Check if both Backspace and Delete keys are on the keyboard of FRAME.
6061 FRAME nil means use the selected frame.
6062 Value is t if we know that both keys are present, and are mapped to the
6063 usual X keysyms. Value is `lambda' if we cannot determine if both keys are
6064 present and mapped to the usual X keysyms. */)
6065 (Lisp_Object frame)
6067 #ifndef HAVE_XKB
6068 return Qlambda;
6069 #else
6070 XkbDescPtr kb;
6071 struct frame *f = decode_window_system_frame (frame);
6072 Display *dpy = FRAME_X_DISPLAY (f);
6073 Lisp_Object have_keys;
6074 int major, minor, op, event, error_code;
6076 block_input ();
6078 /* Check library version in case we're dynamically linked. */
6079 major = XkbMajorVersion;
6080 minor = XkbMinorVersion;
6081 if (!XkbLibraryVersion (&major, &minor))
6083 unblock_input ();
6084 return Qlambda;
6087 /* Check that the server supports XKB. */
6088 major = XkbMajorVersion;
6089 minor = XkbMinorVersion;
6090 if (!XkbQueryExtension (dpy, &op, &event, &error_code, &major, &minor))
6092 unblock_input ();
6093 return Qlambda;
6096 /* In this code we check that the keyboard has physical keys with names
6097 that start with BKSP (Backspace) and DELE (Delete), and that they
6098 generate keysym XK_BackSpace and XK_Delete respectively.
6099 This function is used to test if normal-erase-is-backspace should be
6100 turned on.
6101 An alternative approach would be to just check if XK_BackSpace and
6102 XK_Delete are mapped to any key. But if any of those are mapped to
6103 some non-intuitive key combination (Meta-Shift-Ctrl-whatever) and the
6104 user doesn't know about it, it is better to return false here.
6105 It is more obvious to the user what to do if she/he has two keys
6106 clearly marked with names/symbols and one key does something not
6107 expected (i.e. she/he then tries the other).
6108 The cases where Backspace/Delete is mapped to some other key combination
6109 are rare, and in those cases, normal-erase-is-backspace can be turned on
6110 manually. */
6112 have_keys = Qnil;
6113 kb = XkbGetMap (dpy, XkbAllMapComponentsMask, XkbUseCoreKbd);
6114 if (kb)
6116 int delete_keycode = 0, backspace_keycode = 0, i;
6118 if (XkbGetNames (dpy, XkbAllNamesMask, kb) == Success)
6120 for (i = kb->min_key_code;
6121 (i < kb->max_key_code
6122 && (delete_keycode == 0 || backspace_keycode == 0));
6123 ++i)
6125 /* The XKB symbolic key names can be seen most easily in
6126 the PS file generated by `xkbprint -label name
6127 $DISPLAY'. */
6128 if (memcmp ("DELE", kb->names->keys[i].name, 4) == 0)
6129 delete_keycode = i;
6130 else if (memcmp ("BKSP", kb->names->keys[i].name, 4) == 0)
6131 backspace_keycode = i;
6134 XkbFreeNames (kb, 0, True);
6137 XkbFreeClientMap (kb, 0, True);
6139 if (delete_keycode
6140 && backspace_keycode
6141 && XKeysymToKeycode (dpy, XK_Delete) == delete_keycode
6142 && XKeysymToKeycode (dpy, XK_BackSpace) == backspace_keycode)
6143 have_keys = Qt;
6145 unblock_input ();
6146 return have_keys;
6147 #endif
6152 /***********************************************************************
6153 Initialization
6154 ***********************************************************************/
6156 /* Keep this list in the same order as frame_parms in frame.c.
6157 Use 0 for unsupported frame parameters. */
6159 frame_parm_handler x_frame_parm_handlers[] =
6161 x_set_autoraise,
6162 x_set_autolower,
6163 x_set_background_color,
6164 x_set_border_color,
6165 x_set_border_width,
6166 x_set_cursor_color,
6167 x_set_cursor_type,
6168 x_set_font,
6169 x_set_foreground_color,
6170 x_set_icon_name,
6171 x_set_icon_type,
6172 x_set_internal_border_width,
6173 x_set_menu_bar_lines,
6174 x_set_mouse_color,
6175 x_explicitly_set_name,
6176 x_set_scroll_bar_width,
6177 x_set_title,
6178 x_set_unsplittable,
6179 x_set_vertical_scroll_bars,
6180 x_set_visibility,
6181 x_set_tool_bar_lines,
6182 x_set_scroll_bar_foreground,
6183 x_set_scroll_bar_background,
6184 x_set_screen_gamma,
6185 x_set_line_spacing,
6186 x_set_fringe_width,
6187 x_set_fringe_width,
6188 x_set_wait_for_wm,
6189 x_set_fullscreen,
6190 x_set_font_backend,
6191 x_set_alpha,
6192 x_set_sticky,
6193 x_set_tool_bar_position,
6196 void
6197 syms_of_xfns (void)
6199 /* The section below is built by the lisp expression at the top of the file,
6200 just above where these variables are declared. */
6201 /*&&& init symbols here &&&*/
6202 DEFSYM (Qsuppress_icon, "suppress-icon");
6203 DEFSYM (Qundefined_color, "undefined-color");
6204 DEFSYM (Qcompound_text, "compound-text");
6205 DEFSYM (Qcancel_timer, "cancel-timer");
6206 DEFSYM (Qfont_param, "font-parameter");
6207 /* This is the end of symbol initialization. */
6209 Fput (Qundefined_color, Qerror_conditions,
6210 listn (CONSTYPE_PURE, 2, Qundefined_color, Qerror));
6211 Fput (Qundefined_color, Qerror_message,
6212 build_pure_c_string ("Undefined color"));
6214 DEFVAR_LISP ("x-pointer-shape", Vx_pointer_shape,
6215 doc: /* The shape of the pointer when over text.
6216 Changing the value does not affect existing frames
6217 unless you set the mouse color. */);
6218 Vx_pointer_shape = Qnil;
6220 #if 0 /* This doesn't really do anything. */
6221 DEFVAR_LISP ("x-nontext-pointer-shape", Vx_nontext_pointer_shape,
6222 doc: /* The shape of the pointer when not over text.
6223 This variable takes effect when you create a new frame
6224 or when you set the mouse color. */);
6225 #endif
6226 Vx_nontext_pointer_shape = Qnil;
6228 DEFVAR_LISP ("x-hourglass-pointer-shape", Vx_hourglass_pointer_shape,
6229 doc: /* The shape of the pointer when Emacs is busy.
6230 This variable takes effect when you create a new frame
6231 or when you set the mouse color. */);
6232 Vx_hourglass_pointer_shape = Qnil;
6234 #if 0 /* This doesn't really do anything. */
6235 DEFVAR_LISP ("x-mode-pointer-shape", Vx_mode_pointer_shape,
6236 doc: /* The shape of the pointer when over the mode line.
6237 This variable takes effect when you create a new frame
6238 or when you set the mouse color. */);
6239 #endif
6240 Vx_mode_pointer_shape = Qnil;
6242 DEFVAR_LISP ("x-sensitive-text-pointer-shape",
6243 Vx_sensitive_text_pointer_shape,
6244 doc: /* The shape of the pointer when over mouse-sensitive text.
6245 This variable takes effect when you create a new frame
6246 or when you set the mouse color. */);
6247 Vx_sensitive_text_pointer_shape = Qnil;
6249 DEFVAR_LISP ("x-window-horizontal-drag-cursor",
6250 Vx_window_horizontal_drag_shape,
6251 doc: /* Pointer shape to use for indicating a window can be dragged horizontally.
6252 This variable takes effect when you create a new frame
6253 or when you set the mouse color. */);
6254 Vx_window_horizontal_drag_shape = Qnil;
6256 DEFVAR_LISP ("x-cursor-fore-pixel", Vx_cursor_fore_pixel,
6257 doc: /* A string indicating the foreground color of the cursor box. */);
6258 Vx_cursor_fore_pixel = Qnil;
6260 DEFVAR_LISP ("x-max-tooltip-size", Vx_max_tooltip_size,
6261 doc: /* Maximum size for tooltips.
6262 Value is a pair (COLUMNS . ROWS). Text larger than this is clipped. */);
6263 Vx_max_tooltip_size = Fcons (make_number (80), make_number (40));
6265 DEFVAR_LISP ("x-no-window-manager", Vx_no_window_manager,
6266 doc: /* Non-nil if no X window manager is in use.
6267 Emacs doesn't try to figure this out; this is always nil
6268 unless you set it to something else. */);
6269 /* We don't have any way to find this out, so set it to nil
6270 and maybe the user would like to set it to t. */
6271 Vx_no_window_manager = Qnil;
6273 DEFVAR_LISP ("x-pixel-size-width-font-regexp",
6274 Vx_pixel_size_width_font_regexp,
6275 doc: /* Regexp matching a font name whose width is the same as `PIXEL_SIZE'.
6277 Since Emacs gets width of a font matching with this regexp from
6278 PIXEL_SIZE field of the name, font finding mechanism gets faster for
6279 such a font. This is especially effective for such large fonts as
6280 Chinese, Japanese, and Korean. */);
6281 Vx_pixel_size_width_font_regexp = Qnil;
6283 /* This is not ifdef:ed, so other builds than GTK can customize it. */
6284 DEFVAR_BOOL ("x-gtk-use-old-file-dialog", x_gtk_use_old_file_dialog,
6285 doc: /* Non-nil means prompt with the old GTK file selection dialog.
6286 If nil or if the file selection dialog is not available, the new GTK file
6287 chooser is used instead. To turn off all file dialogs set the
6288 variable `use-file-dialog'. */);
6289 x_gtk_use_old_file_dialog = 0;
6291 DEFVAR_BOOL ("x-gtk-show-hidden-files", x_gtk_show_hidden_files,
6292 doc: /* If non-nil, the GTK file chooser will by default show hidden files.
6293 Note that this is just the default, there is a toggle button on the file
6294 chooser to show or not show hidden files on a case by case basis. */);
6295 x_gtk_show_hidden_files = 0;
6297 DEFVAR_BOOL ("x-gtk-file-dialog-help-text", x_gtk_file_dialog_help_text,
6298 doc: /* If non-nil, the GTK file chooser will show additional help text.
6299 If more space for files in the file chooser dialog is wanted, set this to nil
6300 to turn the additional text off. */);
6301 x_gtk_file_dialog_help_text = 1;
6303 DEFVAR_BOOL ("x-gtk-whole-detached-tool-bar", x_gtk_whole_detached_tool_bar,
6304 doc: /* If non-nil, a detached tool bar is shown in full.
6305 The default is to just show an arrow and pressing on that arrow shows
6306 the tool bar buttons. */);
6307 x_gtk_whole_detached_tool_bar = 0;
6309 DEFVAR_BOOL ("x-gtk-use-system-tooltips", x_gtk_use_system_tooltips,
6310 doc: /* If non-nil with a Gtk+ built Emacs, the Gtk+ tooltip is used.
6311 Otherwise use Emacs own tooltip implementation.
6312 When using Gtk+ tooltips, the tooltip face is not used. */);
6313 x_gtk_use_system_tooltips = 1;
6315 Fprovide (intern_c_string ("x"), Qnil);
6317 #ifdef USE_X_TOOLKIT
6318 Fprovide (intern_c_string ("x-toolkit"), Qnil);
6319 #ifdef USE_MOTIF
6320 Fprovide (intern_c_string ("motif"), Qnil);
6322 DEFVAR_LISP ("motif-version-string", Vmotif_version_string,
6323 doc: /* Version info for LessTif/Motif. */);
6324 Vmotif_version_string = build_string (XmVERSION_STRING);
6325 #endif /* USE_MOTIF */
6326 #endif /* USE_X_TOOLKIT */
6328 #ifdef USE_GTK
6329 /* Provide x-toolkit also for GTK. Internally GTK does not use Xt so it
6330 is not an X toolkit in that sense (USE_X_TOOLKIT is not defined).
6331 But for a user it is a toolkit for X, and indeed, configure
6332 accepts --with-x-toolkit=gtk. */
6333 Fprovide (intern_c_string ("x-toolkit"), Qnil);
6334 Fprovide (intern_c_string ("gtk"), Qnil);
6335 Fprovide (intern_c_string ("move-toolbar"), Qnil);
6337 DEFVAR_LISP ("gtk-version-string", Vgtk_version_string,
6338 doc: /* Version info for GTK+. */);
6340 char gtk_version[sizeof ".." + 3 * INT_STRLEN_BOUND (int)];
6341 int len = sprintf (gtk_version, "%d.%d.%d",
6342 GTK_MAJOR_VERSION, GTK_MINOR_VERSION, GTK_MICRO_VERSION);
6343 Vgtk_version_string = make_pure_string (gtk_version, len, len, 0);
6345 #endif /* USE_GTK */
6347 /* X window properties. */
6348 defsubr (&Sx_change_window_property);
6349 defsubr (&Sx_delete_window_property);
6350 defsubr (&Sx_window_property);
6352 defsubr (&Sxw_display_color_p);
6353 defsubr (&Sx_display_grayscale_p);
6354 defsubr (&Sxw_color_defined_p);
6355 defsubr (&Sxw_color_values);
6356 defsubr (&Sx_server_max_request_size);
6357 defsubr (&Sx_server_vendor);
6358 defsubr (&Sx_server_version);
6359 defsubr (&Sx_display_pixel_width);
6360 defsubr (&Sx_display_pixel_height);
6361 defsubr (&Sx_display_mm_width);
6362 defsubr (&Sx_display_mm_height);
6363 defsubr (&Sx_display_screens);
6364 defsubr (&Sx_display_planes);
6365 defsubr (&Sx_display_color_cells);
6366 defsubr (&Sx_display_visual_class);
6367 defsubr (&Sx_display_backing_store);
6368 defsubr (&Sx_display_save_under);
6369 defsubr (&Sx_display_monitor_attributes_list);
6370 defsubr (&Sx_wm_set_size_hint);
6371 defsubr (&Sx_create_frame);
6372 defsubr (&Sx_open_connection);
6373 defsubr (&Sx_close_connection);
6374 defsubr (&Sx_display_list);
6375 defsubr (&Sx_synchronize);
6376 defsubr (&Sx_focus_frame);
6377 defsubr (&Sx_backspace_delete_keys_p);
6379 defsubr (&Sx_show_tip);
6380 defsubr (&Sx_hide_tip);
6381 tip_timer = Qnil;
6382 staticpro (&tip_timer);
6383 tip_frame = Qnil;
6384 staticpro (&tip_frame);
6386 last_show_tip_args = Qnil;
6387 staticpro (&last_show_tip_args);
6389 defsubr (&Sx_uses_old_gtk_dialog);
6390 #if defined (USE_MOTIF) || defined (USE_GTK)
6391 defsubr (&Sx_file_dialog);
6392 #endif
6394 #if defined (USE_GTK) && defined (HAVE_FREETYPE)
6395 defsubr (&Sx_select_font);
6396 #endif
6399 #endif /* HAVE_X_WINDOWS */