Merge from trunk and apply standard C changes.
[emacs.git] / src / xfns.c
blobfb2ed9bb66a550ade4b278f8e5f5164f9f046cbf
1 /* Functions for the X window system.
2 Copyright (C) 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
3 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
4 Free Software Foundation, Inc.
6 This file is part of GNU Emacs.
8 GNU Emacs is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or
11 (at your option) any later version.
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
21 #include <config.h>
22 #include <stdio.h>
23 #include <math.h>
24 #include <setjmp.h>
25 #include <ctype.h>
27 #ifdef HAVE_UNISTD_H
28 #include <unistd.h>
29 #endif
31 /* This makes the fields of a Display accessible, in Xlib header files. */
33 #define XLIB_ILLEGAL_ACCESS
35 #include "lisp.h"
36 #include "xterm.h"
37 #include "frame.h"
38 #include "window.h"
39 #include "buffer.h"
40 #include "intervals.h"
41 #include "dispextern.h"
42 #include "keyboard.h"
43 #include "blockinput.h"
44 #include <epaths.h>
45 #include "character.h"
46 #include "charset.h"
47 #include "coding.h"
48 #include "fontset.h"
49 #include "systime.h"
50 #include "termhooks.h"
51 #include "atimer.h"
52 #include "termchar.h"
53 #include "font.h"
55 #ifdef HAVE_X_WINDOWS
57 #include <ctype.h>
58 #include <sys/types.h>
59 #include <sys/stat.h>
61 #if 1 /* Used to be #ifdef EMACS_BITMAP_FILES, but this should always work. */
62 #include "bitmaps/gray.xbm"
63 #else
64 #include <X11/bitmaps/gray>
65 #endif
67 #include "xsettings.h"
69 #ifdef USE_GTK
70 #include "gtkutil.h"
71 #endif
73 #ifdef USE_X_TOOLKIT
74 #include <X11/Shell.h>
76 #ifndef USE_MOTIF
77 #ifdef HAVE_XAW3D
78 #include <X11/Xaw3d/Paned.h>
79 #include <X11/Xaw3d/Label.h>
80 #else /* !HAVE_XAW3D */
81 #include <X11/Xaw/Paned.h>
82 #include <X11/Xaw/Label.h>
83 #endif /* HAVE_XAW3D */
84 #endif /* USE_MOTIF */
86 #ifdef USG
87 #undef USG /* ####KLUDGE for Solaris 2.2 and up */
88 #include <X11/Xos.h>
89 #define USG
90 #else
91 #include <X11/Xos.h>
92 #endif
94 #include "widget.h"
96 #include "../lwlib/lwlib.h"
98 #ifdef USE_MOTIF
99 #include <Xm/Xm.h>
100 #include <Xm/DialogS.h>
101 #include <Xm/FileSB.h>
102 #endif
104 #ifdef USE_LUCID
105 #include "../lwlib/xlwmenu.h"
106 #endif
108 #if !defined(NO_EDITRES)
109 #define HACK_EDITRES
110 extern void _XEditResCheckMessages ();
111 #endif /* not defined NO_EDITRES */
113 /* Unique id counter for widgets created by the Lucid Widget Library. */
115 extern LWLIB_ID widget_id_tick;
117 extern void free_frame_menubar ();
118 extern double atof ();
120 #ifdef USE_MOTIF
122 /* LessTif/Motif version info. */
124 static Lisp_Object Vmotif_version_string;
126 #endif /* USE_MOTIF */
128 #endif /* USE_X_TOOLKIT */
130 #ifdef USE_GTK
132 /* GTK+ version info */
134 static Lisp_Object Vgtk_version_string;
136 #endif /* USE_GTK */
138 #define MAXREQUEST(dpy) (XMaxRequestSize (dpy))
140 /* The gray bitmap `bitmaps/gray'. This is done because xterm.c uses
141 it, and including `bitmaps/gray' more than once is a problem when
142 config.h defines `static' as an empty replacement string. */
144 int gray_bitmap_width = gray_width;
145 int gray_bitmap_height = gray_height;
146 char *gray_bitmap_bits = gray_bits;
148 /* Non-zero means prompt with the old GTK file selection dialog. */
150 int x_gtk_use_old_file_dialog;
152 /* If non-zero, by default show hidden files in the GTK file chooser. */
154 int x_gtk_show_hidden_files;
156 /* If non-zero, don't show additional help text in the GTK file chooser. */
158 int x_gtk_file_dialog_help_text;
160 /* If non-zero, don't collapse to tool bar when it is detached. */
162 int x_gtk_whole_detached_tool_bar;
164 /* The background and shape of the mouse pointer, and shape when not
165 over text or in the modeline. */
167 Lisp_Object Vx_pointer_shape, Vx_nontext_pointer_shape, Vx_mode_pointer_shape;
168 Lisp_Object Vx_hourglass_pointer_shape;
170 /* The shape when over mouse-sensitive text. */
172 Lisp_Object Vx_sensitive_text_pointer_shape;
174 /* If non-nil, the pointer shape to indicate that windows can be
175 dragged horizontally. */
177 Lisp_Object Vx_window_horizontal_drag_shape;
179 /* Color of chars displayed in cursor box. */
181 Lisp_Object Vx_cursor_fore_pixel;
183 /* Nonzero if using X. */
185 static int x_in_use;
187 /* Non nil if no window manager is in use. */
189 Lisp_Object Vx_no_window_manager;
191 /* Regexp matching a font name whose width is the same as `PIXEL_SIZE'. */
193 Lisp_Object Vx_pixel_size_width_font_regexp;
195 Lisp_Object Qnone;
196 Lisp_Object Qsuppress_icon;
197 Lisp_Object Qundefined_color;
198 Lisp_Object Qcompound_text, Qcancel_timer;
199 Lisp_Object Qfont_param;
201 /* In dispnew.c */
203 extern Lisp_Object Vwindow_system_version;
205 /* In editfns.c */
207 extern Lisp_Object Vsystem_name;
209 /* The below are defined in frame.c. */
211 extern Lisp_Object Vmenu_bar_mode, Vtool_bar_mode;
212 extern Lisp_Object Qtooltip;
214 #if GLYPH_DEBUG
215 int image_cache_refcount, dpyinfo_refcount;
216 #endif
218 #if defined (USE_GTK) && defined (HAVE_FREETYPE)
219 char *x_last_font_name;
220 #endif
223 /* Error if we are not connected to X. */
225 void
226 check_x (void)
228 if (! x_in_use)
229 error ("X windows are not in use or not initialized");
232 /* Nonzero if we can use mouse menus.
233 You should not call this unless HAVE_MENUS is defined. */
236 have_menus_p (void)
238 return x_in_use;
241 /* Extract a frame as a FRAME_PTR, defaulting to the selected frame
242 and checking validity for X. */
244 FRAME_PTR
245 check_x_frame (Lisp_Object frame)
247 FRAME_PTR f;
249 if (NILP (frame))
250 frame = selected_frame;
251 CHECK_LIVE_FRAME (frame);
252 f = XFRAME (frame);
253 if (! FRAME_X_P (f))
254 error ("Non-X frame used");
255 return f;
258 /* Let the user specify an X display with a Lisp object.
259 OBJECT may be nil, a frame or a terminal object.
260 nil stands for the selected frame--or, if that is not an X frame,
261 the first X display on the list. */
263 struct x_display_info *
264 check_x_display_info (Lisp_Object object)
266 struct x_display_info *dpyinfo = NULL;
268 if (NILP (object))
270 struct frame *sf = XFRAME (selected_frame);
272 if (FRAME_X_P (sf) && FRAME_LIVE_P (sf))
273 dpyinfo = FRAME_X_DISPLAY_INFO (sf);
274 else if (x_display_list != 0)
275 dpyinfo = x_display_list;
276 else
277 error ("X windows are not in use or not initialized");
279 else if (TERMINALP (object))
281 struct terminal *t = get_terminal (object, 1);
283 if (t->type != output_x_window)
284 error ("Terminal %d is not an X display", XINT (object));
286 dpyinfo = t->display_info.x;
288 else if (STRINGP (object))
289 dpyinfo = x_display_info_for_name (object);
290 else
292 FRAME_PTR f = check_x_frame (object);
293 dpyinfo = FRAME_X_DISPLAY_INFO (f);
296 return dpyinfo;
300 /* Return the Emacs frame-object corresponding to an X window.
301 It could be the frame's main window or an icon window. */
303 /* This function can be called during GC, so use GC_xxx type test macros. */
305 struct frame *
306 x_window_to_frame (struct x_display_info *dpyinfo, int wdesc)
308 Lisp_Object tail, frame;
309 struct frame *f;
311 if (wdesc == None) return 0;
313 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
315 frame = XCAR (tail);
316 if (!FRAMEP (frame))
317 continue;
318 f = XFRAME (frame);
319 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
320 continue;
321 if (f->output_data.x->hourglass_window == wdesc)
322 return f;
323 #ifdef USE_X_TOOLKIT
324 if ((f->output_data.x->edit_widget
325 && XtWindow (f->output_data.x->edit_widget) == wdesc)
326 /* A tooltip frame? */
327 || (!f->output_data.x->edit_widget
328 && FRAME_X_WINDOW (f) == wdesc)
329 || f->output_data.x->icon_desc == wdesc)
330 return f;
331 #else /* not USE_X_TOOLKIT */
332 #ifdef USE_GTK
333 if (f->output_data.x->edit_widget)
335 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
336 struct x_output *x = f->output_data.x;
337 if (gwdesc != 0 && gwdesc == x->edit_widget)
338 return f;
340 #endif /* USE_GTK */
341 if (FRAME_X_WINDOW (f) == wdesc
342 || f->output_data.x->icon_desc == wdesc)
343 return f;
344 #endif /* not USE_X_TOOLKIT */
346 return 0;
349 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
350 /* Like x_window_to_frame but also compares the window with the widget's
351 windows. */
353 struct frame *
354 x_any_window_to_frame (struct x_display_info *dpyinfo, int wdesc)
356 Lisp_Object tail, frame;
357 struct frame *f, *found;
358 struct x_output *x;
360 if (wdesc == None) return NULL;
362 found = NULL;
363 for (tail = Vframe_list; CONSP (tail) && !found; tail = XCDR (tail))
365 frame = XCAR (tail);
366 if (!FRAMEP (frame))
367 continue;
369 f = XFRAME (frame);
370 if (FRAME_X_P (f) && FRAME_X_DISPLAY_INFO (f) == dpyinfo)
372 /* This frame matches if the window is any of its widgets. */
373 x = f->output_data.x;
374 if (x->hourglass_window == wdesc)
375 found = f;
376 else if (x->widget)
378 #ifdef USE_GTK
379 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
380 if (gwdesc != 0
381 && gtk_widget_get_toplevel (gwdesc) == x->widget)
382 found = f;
383 #else
384 if (wdesc == XtWindow (x->widget)
385 || wdesc == XtWindow (x->column_widget)
386 || wdesc == XtWindow (x->edit_widget))
387 found = f;
388 /* Match if the window is this frame's menubar. */
389 else if (lw_window_is_in_menubar (wdesc, x->menubar_widget))
390 found = f;
391 #endif
393 else if (FRAME_X_WINDOW (f) == wdesc)
394 /* A tooltip frame. */
395 found = f;
399 return found;
402 /* Likewise, but consider only the menu bar widget. */
404 struct frame *
405 x_menubar_window_to_frame (struct x_display_info *dpyinfo, XEvent *event)
407 Window wdesc = event->xany.window;
408 Lisp_Object tail, frame;
409 struct frame *f;
410 struct x_output *x;
412 if (wdesc == None) return 0;
414 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
416 frame = XCAR (tail);
417 if (!FRAMEP (frame))
418 continue;
419 f = XFRAME (frame);
420 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
421 continue;
422 x = f->output_data.x;
423 #ifdef USE_GTK
424 if (x->menubar_widget && xg_event_is_for_menubar (f, event))
425 return f;
426 #else
427 /* Match if the window is this frame's menubar. */
428 if (x->menubar_widget
429 && lw_window_is_in_menubar (wdesc, x->menubar_widget))
430 return f;
431 #endif
433 return 0;
436 /* Return the frame whose principal (outermost) window is WDESC.
437 If WDESC is some other (smaller) window, we return 0. */
439 struct frame *
440 x_top_window_to_frame (struct x_display_info *dpyinfo, int wdesc)
442 Lisp_Object tail, frame;
443 struct frame *f;
444 struct x_output *x;
446 if (wdesc == None) return 0;
448 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
450 frame = XCAR (tail);
451 if (!FRAMEP (frame))
452 continue;
453 f = XFRAME (frame);
454 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
455 continue;
456 x = f->output_data.x;
458 if (x->widget)
460 /* This frame matches if the window is its topmost widget. */
461 #ifdef USE_GTK
462 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
463 if (gwdesc == x->widget)
464 return f;
465 #else
466 if (wdesc == XtWindow (x->widget))
467 return f;
468 #if 0 /* I don't know why it did this,
469 but it seems logically wrong,
470 and it causes trouble for MapNotify events. */
471 /* Match if the window is this frame's menubar. */
472 if (x->menubar_widget
473 && wdesc == XtWindow (x->menubar_widget))
474 return f;
475 #endif
476 #endif
478 else if (FRAME_X_WINDOW (f) == wdesc)
479 /* Tooltip frame. */
480 return f;
482 return 0;
484 #endif /* USE_X_TOOLKIT || USE_GTK */
488 static void x_default_font_parameter (struct frame *, Lisp_Object);
490 static Lisp_Object unwind_create_frame (Lisp_Object);
491 static Lisp_Object unwind_create_tip_frame (Lisp_Object);
493 void x_set_foreground_color (struct frame *, Lisp_Object, Lisp_Object);
494 static void x_set_wait_for_wm (struct frame *, Lisp_Object, Lisp_Object);
495 void x_set_background_color (struct frame *, Lisp_Object, Lisp_Object);
496 void x_set_mouse_color (struct frame *, Lisp_Object, Lisp_Object);
497 void x_set_cursor_color (struct frame *, Lisp_Object, Lisp_Object);
498 void x_set_border_color (struct frame *, Lisp_Object, Lisp_Object);
499 void x_set_cursor_type (struct frame *, Lisp_Object, Lisp_Object);
500 void x_set_icon_type (struct frame *, Lisp_Object, Lisp_Object);
501 void x_set_icon_name (struct frame *, Lisp_Object, Lisp_Object);
502 void x_explicitly_set_name (struct frame *, Lisp_Object, Lisp_Object);
503 void x_set_menu_bar_lines (struct frame *, Lisp_Object, Lisp_Object);
504 void x_set_title (struct frame *, Lisp_Object, Lisp_Object);
505 void x_set_tool_bar_lines (struct frame *, Lisp_Object, Lisp_Object);
506 void x_set_scroll_bar_foreground (struct frame *, Lisp_Object,
507 Lisp_Object);
508 void x_set_scroll_bar_background (struct frame *, Lisp_Object,
509 Lisp_Object);
510 static Lisp_Object x_default_scroll_bar_color_parameter (struct frame *,
511 Lisp_Object,
512 Lisp_Object,
513 char *, char *,
514 int);
517 /* Store the screen positions of frame F into XPTR and YPTR.
518 These are the positions of the containing window manager window,
519 not Emacs's own window. */
521 void
522 x_real_positions (FRAME_PTR f, int *xptr, int *yptr)
524 int win_x, win_y, outer_x, outer_y;
525 int real_x = 0, real_y = 0;
526 int had_errors = 0;
527 Window win = f->output_data.x->parent_desc;
529 BLOCK_INPUT;
531 x_catch_errors (FRAME_X_DISPLAY (f));
533 if (win == FRAME_X_DISPLAY_INFO (f)->root_window)
534 win = FRAME_OUTER_WINDOW (f);
536 /* This loop traverses up the containment tree until we hit the root
537 window. Window managers may intersect many windows between our window
538 and the root window. The window we find just before the root window
539 should be the outer WM window. */
540 for (;;)
542 Window wm_window, rootw;
543 Window *tmp_children;
544 unsigned int tmp_nchildren;
545 int success;
547 success = XQueryTree (FRAME_X_DISPLAY (f), win, &rootw,
548 &wm_window, &tmp_children, &tmp_nchildren);
550 had_errors = x_had_errors_p (FRAME_X_DISPLAY (f));
552 /* Don't free tmp_children if XQueryTree failed. */
553 if (! success)
554 break;
556 XFree ((char *) tmp_children);
558 if (wm_window == rootw || had_errors)
559 break;
561 win = wm_window;
564 if (! had_errors)
566 unsigned int ign;
567 Window child, rootw;
569 /* Get the real coordinates for the WM window upper left corner */
570 XGetGeometry (FRAME_X_DISPLAY (f), win,
571 &rootw, &real_x, &real_y, &ign, &ign, &ign, &ign);
573 /* Translate real coordinates to coordinates relative to our
574 window. For our window, the upper left corner is 0, 0.
575 Since the upper left corner of the WM window is outside
576 our window, win_x and win_y will be negative:
578 ------------------ ---> x
579 | title |
580 | ----------------- v y
581 | | our window
583 XTranslateCoordinates (FRAME_X_DISPLAY (f),
585 /* From-window, to-window. */
586 FRAME_X_DISPLAY_INFO (f)->root_window,
587 FRAME_X_WINDOW (f),
589 /* From-position, to-position. */
590 real_x, real_y, &win_x, &win_y,
592 /* Child of win. */
593 &child);
595 if (FRAME_X_WINDOW (f) == FRAME_OUTER_WINDOW (f))
597 outer_x = win_x;
598 outer_y = win_y;
600 else
602 XTranslateCoordinates (FRAME_X_DISPLAY (f),
604 /* From-window, to-window. */
605 FRAME_X_DISPLAY_INFO (f)->root_window,
606 FRAME_OUTER_WINDOW (f),
608 /* From-position, to-position. */
609 real_x, real_y, &outer_x, &outer_y,
611 /* Child of win. */
612 &child);
615 had_errors = x_had_errors_p (FRAME_X_DISPLAY (f));
618 x_uncatch_errors ();
620 UNBLOCK_INPUT;
622 if (had_errors) return;
624 f->x_pixels_diff = -win_x;
625 f->y_pixels_diff = -win_y;
627 FRAME_X_OUTPUT (f)->x_pixels_outer_diff = -outer_x;
628 FRAME_X_OUTPUT (f)->y_pixels_outer_diff = -outer_y;
630 *xptr = real_x;
631 *yptr = real_y;
637 /* Gamma-correct COLOR on frame F. */
639 void
640 gamma_correct (struct frame *f, XColor *color)
642 if (f->gamma)
644 color->red = pow (color->red / 65535.0, f->gamma) * 65535.0 + 0.5;
645 color->green = pow (color->green / 65535.0, f->gamma) * 65535.0 + 0.5;
646 color->blue = pow (color->blue / 65535.0, f->gamma) * 65535.0 + 0.5;
651 /* Decide if color named COLOR_NAME is valid for use on frame F. If
652 so, return the RGB values in COLOR. If ALLOC_P is non-zero,
653 allocate the color. Value is zero if COLOR_NAME is invalid, or
654 no color could be allocated. */
657 x_defined_color (struct frame *f, const char *color_name,
658 XColor *color, int alloc_p)
660 int success_p;
661 Display *dpy = FRAME_X_DISPLAY (f);
662 Colormap cmap = FRAME_X_COLORMAP (f);
664 BLOCK_INPUT;
665 success_p = XParseColor (dpy, cmap, color_name, color);
666 if (success_p && alloc_p)
667 success_p = x_alloc_nearest_color (f, cmap, color);
668 UNBLOCK_INPUT;
670 return success_p;
674 /* Return the pixel color value for color COLOR_NAME on frame F. If F
675 is a monochrome frame, return MONO_COLOR regardless of what ARG says.
676 Signal an error if color can't be allocated. */
679 x_decode_color (FRAME_PTR f, Lisp_Object color_name, int mono_color)
681 XColor cdef;
683 CHECK_STRING (color_name);
685 #if 0 /* Don't do this. It's wrong when we're not using the default
686 colormap, it makes freeing difficult, and it's probably not
687 an important optimization. */
688 if (strcmp (SDATA (color_name), "black") == 0)
689 return BLACK_PIX_DEFAULT (f);
690 else if (strcmp (SDATA (color_name), "white") == 0)
691 return WHITE_PIX_DEFAULT (f);
692 #endif
694 /* Return MONO_COLOR for monochrome frames. */
695 if (FRAME_X_DISPLAY_INFO (f)->n_planes == 1)
696 return mono_color;
698 /* x_defined_color is responsible for coping with failures
699 by looking for a near-miss. */
700 if (x_defined_color (f, SDATA (color_name), &cdef, 1))
701 return cdef.pixel;
703 signal_error ("Undefined color", color_name);
708 /* Change the `wait-for-wm' frame parameter of frame F. OLD_VALUE is
709 the previous value of that parameter, NEW_VALUE is the new value.
710 See also the comment of wait_for_wm in struct x_output. */
712 static void
713 x_set_wait_for_wm (struct frame *f, Lisp_Object new_value, Lisp_Object old_value)
715 f->output_data.x->wait_for_wm = !NILP (new_value);
718 #ifdef USE_GTK
720 /* Set icon from FILE for frame F. By using GTK functions the icon
721 may be any format that GdkPixbuf knows about, i.e. not just bitmaps. */
724 xg_set_icon (FRAME_PTR f, Lisp_Object file)
726 int result = 0;
727 Lisp_Object found;
729 found = x_find_image_file (file);
731 if (! NILP (found))
733 GdkPixbuf *pixbuf;
734 GError *err = NULL;
735 char *filename = (char *) SDATA (found);
736 BLOCK_INPUT;
738 pixbuf = gdk_pixbuf_new_from_file (filename, &err);
740 if (pixbuf)
742 gtk_window_set_icon (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)),
743 pixbuf);
744 g_object_unref (pixbuf);
746 result = 1;
748 else
749 g_error_free (err);
751 UNBLOCK_INPUT;
754 return result;
758 xg_set_icon_from_xpm_data (FRAME_PTR f, char **data)
760 int result = 0;
761 GdkPixbuf *pixbuf = gdk_pixbuf_new_from_xpm_data ((const char **) data);
763 if (!pixbuf)
764 return 0;
766 gtk_window_set_icon (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)), pixbuf);
767 g_object_unref (pixbuf);
768 return 1;
770 #endif /* USE_GTK */
773 /* Functions called only from `x_set_frame_param'
774 to set individual parameters.
776 If FRAME_X_WINDOW (f) is 0,
777 the frame is being created and its X-window does not exist yet.
778 In that case, just record the parameter's new value
779 in the standard place; do not attempt to change the window. */
781 void
782 x_set_foreground_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
784 struct x_output *x = f->output_data.x;
785 unsigned long fg, old_fg;
787 fg = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
788 old_fg = FRAME_FOREGROUND_PIXEL (f);
789 FRAME_FOREGROUND_PIXEL (f) = fg;
791 if (FRAME_X_WINDOW (f) != 0)
793 Display *dpy = FRAME_X_DISPLAY (f);
795 BLOCK_INPUT;
796 XSetForeground (dpy, x->normal_gc, fg);
797 XSetBackground (dpy, x->reverse_gc, fg);
799 if (x->cursor_pixel == old_fg)
801 unload_color (f, x->cursor_pixel);
802 x->cursor_pixel = x_copy_color (f, fg);
803 XSetBackground (dpy, x->cursor_gc, x->cursor_pixel);
806 UNBLOCK_INPUT;
808 update_face_from_frame_parameter (f, Qforeground_color, arg);
810 if (FRAME_VISIBLE_P (f))
811 redraw_frame (f);
814 unload_color (f, old_fg);
817 void
818 x_set_background_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
820 struct x_output *x = f->output_data.x;
821 unsigned long bg;
823 bg = x_decode_color (f, arg, WHITE_PIX_DEFAULT (f));
824 unload_color (f, FRAME_BACKGROUND_PIXEL (f));
825 FRAME_BACKGROUND_PIXEL (f) = bg;
827 if (FRAME_X_WINDOW (f) != 0)
829 Display *dpy = FRAME_X_DISPLAY (f);
831 BLOCK_INPUT;
832 XSetBackground (dpy, x->normal_gc, bg);
833 XSetForeground (dpy, x->reverse_gc, bg);
834 XSetWindowBackground (dpy, FRAME_X_WINDOW (f), bg);
835 XSetForeground (dpy, x->cursor_gc, bg);
837 #ifdef USE_GTK
838 xg_set_background_color (f, bg);
839 #endif
841 #ifndef USE_TOOLKIT_SCROLL_BARS /* Turns out to be annoying with
842 toolkit scroll bars. */
844 Lisp_Object bar;
845 for (bar = FRAME_SCROLL_BARS (f);
846 !NILP (bar);
847 bar = XSCROLL_BAR (bar)->next)
849 Window window = XSCROLL_BAR (bar)->x_window;
850 XSetWindowBackground (dpy, window, bg);
853 #endif /* USE_TOOLKIT_SCROLL_BARS */
855 UNBLOCK_INPUT;
856 update_face_from_frame_parameter (f, Qbackground_color, arg);
858 if (FRAME_VISIBLE_P (f))
859 redraw_frame (f);
863 static Cursor
864 make_invisible_cursor (struct frame *f)
866 Display *dpy = FRAME_X_DISPLAY (f);
867 static char const no_data[] = { 0 };
868 Pixmap pix;
869 XColor col;
870 Cursor c;
872 x_catch_errors (dpy);
873 pix = XCreateBitmapFromData (dpy, FRAME_X_DISPLAY_INFO (f)->root_window,
874 no_data, 1, 1);
875 if (! x_had_errors_p (dpy) && pix != None)
877 col.pixel = 0;
878 col.red = col.green = col.blue = 0;
879 col.flags = DoRed | DoGreen | DoBlue;
880 c = XCreatePixmapCursor (dpy, pix, pix, &col, &col, 0, 0);
881 if (x_had_errors_p (dpy) || c == None)
882 c = 0;
883 XFreePixmap (dpy, pix);
886 x_uncatch_errors ();
888 return c;
891 void
892 x_set_mouse_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
894 struct x_output *x = f->output_data.x;
895 Display *dpy = FRAME_X_DISPLAY (f);
896 Cursor cursor, nontext_cursor, mode_cursor, hand_cursor;
897 Cursor hourglass_cursor, horizontal_drag_cursor;
898 unsigned long pixel = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
899 unsigned long mask_color = FRAME_BACKGROUND_PIXEL (f);
901 /* Don't let pointers be invisible. */
902 if (mask_color == pixel)
904 x_free_colors (f, &pixel, 1);
905 pixel = x_copy_color (f, FRAME_FOREGROUND_PIXEL (f));
908 unload_color (f, x->mouse_pixel);
909 x->mouse_pixel = pixel;
911 BLOCK_INPUT;
913 /* It's not okay to crash if the user selects a screwy cursor. */
914 x_catch_errors (dpy);
916 if (!NILP (Vx_pointer_shape))
918 CHECK_NUMBER (Vx_pointer_shape);
919 cursor = XCreateFontCursor (dpy, XINT (Vx_pointer_shape));
921 else
922 cursor = XCreateFontCursor (dpy, XC_xterm);
923 x_check_errors (dpy, "bad text pointer cursor: %s");
925 if (!NILP (Vx_nontext_pointer_shape))
927 CHECK_NUMBER (Vx_nontext_pointer_shape);
928 nontext_cursor
929 = XCreateFontCursor (dpy, XINT (Vx_nontext_pointer_shape));
931 else
932 nontext_cursor = XCreateFontCursor (dpy, XC_left_ptr);
933 x_check_errors (dpy, "bad nontext pointer cursor: %s");
935 if (!NILP (Vx_hourglass_pointer_shape))
937 CHECK_NUMBER (Vx_hourglass_pointer_shape);
938 hourglass_cursor
939 = XCreateFontCursor (dpy, XINT (Vx_hourglass_pointer_shape));
941 else
942 hourglass_cursor = XCreateFontCursor (dpy, XC_watch);
943 x_check_errors (dpy, "bad hourglass pointer cursor: %s");
945 if (!NILP (Vx_mode_pointer_shape))
947 CHECK_NUMBER (Vx_mode_pointer_shape);
948 mode_cursor = XCreateFontCursor (dpy, XINT (Vx_mode_pointer_shape));
950 else
951 mode_cursor = XCreateFontCursor (dpy, XC_xterm);
952 x_check_errors (dpy, "bad modeline pointer cursor: %s");
954 if (!NILP (Vx_sensitive_text_pointer_shape))
956 CHECK_NUMBER (Vx_sensitive_text_pointer_shape);
957 hand_cursor
958 = XCreateFontCursor (dpy, XINT (Vx_sensitive_text_pointer_shape));
960 else
961 hand_cursor = XCreateFontCursor (dpy, XC_hand2);
963 if (!NILP (Vx_window_horizontal_drag_shape))
965 CHECK_NUMBER (Vx_window_horizontal_drag_shape);
966 horizontal_drag_cursor
967 = XCreateFontCursor (dpy, XINT (Vx_window_horizontal_drag_shape));
969 else
970 horizontal_drag_cursor
971 = XCreateFontCursor (dpy, XC_sb_h_double_arrow);
973 /* Check and report errors with the above calls. */
974 x_check_errors (dpy, "can't set cursor shape: %s");
975 x_uncatch_errors ();
978 XColor fore_color, back_color;
980 fore_color.pixel = x->mouse_pixel;
981 x_query_color (f, &fore_color);
982 back_color.pixel = mask_color;
983 x_query_color (f, &back_color);
985 XRecolorCursor (dpy, cursor, &fore_color, &back_color);
986 XRecolorCursor (dpy, nontext_cursor, &fore_color, &back_color);
987 XRecolorCursor (dpy, mode_cursor, &fore_color, &back_color);
988 XRecolorCursor (dpy, hand_cursor, &fore_color, &back_color);
989 XRecolorCursor (dpy, hourglass_cursor, &fore_color, &back_color);
990 XRecolorCursor (dpy, horizontal_drag_cursor, &fore_color, &back_color);
993 if (FRAME_X_WINDOW (f) != 0)
994 XDefineCursor (dpy, FRAME_X_WINDOW (f),
995 f->output_data.x->current_cursor = cursor);
997 if (FRAME_X_DISPLAY_INFO (f)->invisible_cursor == 0)
998 FRAME_X_DISPLAY_INFO (f)->invisible_cursor = make_invisible_cursor (f);
1000 if (cursor != x->text_cursor
1001 && x->text_cursor != 0)
1002 XFreeCursor (dpy, x->text_cursor);
1003 x->text_cursor = cursor;
1005 if (nontext_cursor != x->nontext_cursor
1006 && x->nontext_cursor != 0)
1007 XFreeCursor (dpy, x->nontext_cursor);
1008 x->nontext_cursor = nontext_cursor;
1010 if (hourglass_cursor != x->hourglass_cursor
1011 && x->hourglass_cursor != 0)
1012 XFreeCursor (dpy, x->hourglass_cursor);
1013 x->hourglass_cursor = hourglass_cursor;
1015 if (mode_cursor != x->modeline_cursor
1016 && x->modeline_cursor != 0)
1017 XFreeCursor (dpy, f->output_data.x->modeline_cursor);
1018 x->modeline_cursor = mode_cursor;
1020 if (hand_cursor != x->hand_cursor
1021 && x->hand_cursor != 0)
1022 XFreeCursor (dpy, x->hand_cursor);
1023 x->hand_cursor = hand_cursor;
1025 if (horizontal_drag_cursor != x->horizontal_drag_cursor
1026 && x->horizontal_drag_cursor != 0)
1027 XFreeCursor (dpy, x->horizontal_drag_cursor);
1028 x->horizontal_drag_cursor = horizontal_drag_cursor;
1030 XFlush (dpy);
1031 UNBLOCK_INPUT;
1033 update_face_from_frame_parameter (f, Qmouse_color, arg);
1036 void
1037 x_set_cursor_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
1039 unsigned long fore_pixel, pixel;
1040 int fore_pixel_allocated_p = 0, pixel_allocated_p = 0;
1041 struct x_output *x = f->output_data.x;
1043 if (!NILP (Vx_cursor_fore_pixel))
1045 fore_pixel = x_decode_color (f, Vx_cursor_fore_pixel,
1046 WHITE_PIX_DEFAULT (f));
1047 fore_pixel_allocated_p = 1;
1049 else
1050 fore_pixel = FRAME_BACKGROUND_PIXEL (f);
1052 pixel = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
1053 pixel_allocated_p = 1;
1055 /* Make sure that the cursor color differs from the background color. */
1056 if (pixel == FRAME_BACKGROUND_PIXEL (f))
1058 if (pixel_allocated_p)
1060 x_free_colors (f, &pixel, 1);
1061 pixel_allocated_p = 0;
1064 pixel = x->mouse_pixel;
1065 if (pixel == fore_pixel)
1067 if (fore_pixel_allocated_p)
1069 x_free_colors (f, &fore_pixel, 1);
1070 fore_pixel_allocated_p = 0;
1072 fore_pixel = FRAME_BACKGROUND_PIXEL (f);
1076 unload_color (f, x->cursor_foreground_pixel);
1077 if (!fore_pixel_allocated_p)
1078 fore_pixel = x_copy_color (f, fore_pixel);
1079 x->cursor_foreground_pixel = fore_pixel;
1081 unload_color (f, x->cursor_pixel);
1082 if (!pixel_allocated_p)
1083 pixel = x_copy_color (f, pixel);
1084 x->cursor_pixel = pixel;
1086 if (FRAME_X_WINDOW (f) != 0)
1088 BLOCK_INPUT;
1089 XSetBackground (FRAME_X_DISPLAY (f), x->cursor_gc, x->cursor_pixel);
1090 XSetForeground (FRAME_X_DISPLAY (f), x->cursor_gc, fore_pixel);
1091 UNBLOCK_INPUT;
1093 if (FRAME_VISIBLE_P (f))
1095 x_update_cursor (f, 0);
1096 x_update_cursor (f, 1);
1100 update_face_from_frame_parameter (f, Qcursor_color, arg);
1103 /* Set the border-color of frame F to pixel value PIX.
1104 Note that this does not fully take effect if done before
1105 F has an x-window. */
1107 void
1108 x_set_border_pixel (struct frame *f, int pix)
1110 unload_color (f, f->output_data.x->border_pixel);
1111 f->output_data.x->border_pixel = pix;
1113 if (FRAME_X_WINDOW (f) != 0 && f->border_width > 0)
1115 BLOCK_INPUT;
1116 XSetWindowBorder (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1117 (unsigned long)pix);
1118 UNBLOCK_INPUT;
1120 if (FRAME_VISIBLE_P (f))
1121 redraw_frame (f);
1125 /* Set the border-color of frame F to value described by ARG.
1126 ARG can be a string naming a color.
1127 The border-color is used for the border that is drawn by the X server.
1128 Note that this does not fully take effect if done before
1129 F has an x-window; it must be redone when the window is created.
1131 Note: this is done in two routines because of the way X10 works.
1133 Note: under X11, this is normally the province of the window manager,
1134 and so emacs' border colors may be overridden. */
1136 void
1137 x_set_border_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
1139 int pix;
1141 CHECK_STRING (arg);
1142 pix = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
1143 x_set_border_pixel (f, pix);
1144 update_face_from_frame_parameter (f, Qborder_color, arg);
1148 void
1149 x_set_cursor_type (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
1151 set_frame_cursor_types (f, arg);
1153 /* Make sure the cursor gets redrawn. */
1154 cursor_type_changed = 1;
1157 void
1158 x_set_icon_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
1160 int result;
1162 if (STRINGP (arg))
1164 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
1165 return;
1167 else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
1168 return;
1170 BLOCK_INPUT;
1171 if (NILP (arg))
1172 result = x_text_icon (f,
1173 (char *) SDATA ((!NILP (f->icon_name)
1174 ? f->icon_name
1175 : f->name)));
1176 else
1177 result = x_bitmap_icon (f, arg);
1179 if (result)
1181 UNBLOCK_INPUT;
1182 error ("No icon window available");
1185 XFlush (FRAME_X_DISPLAY (f));
1186 UNBLOCK_INPUT;
1189 void
1190 x_set_icon_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
1192 int result;
1194 if (STRINGP (arg))
1196 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
1197 return;
1199 else if (!NILP (arg) || NILP (oldval))
1200 return;
1202 f->icon_name = arg;
1204 if (f->output_data.x->icon_bitmap != 0)
1205 return;
1207 BLOCK_INPUT;
1209 result = x_text_icon (f,
1210 (char *) SDATA ((!NILP (f->icon_name)
1211 ? f->icon_name
1212 : !NILP (f->title)
1213 ? f->title
1214 : f->name)));
1216 if (result)
1218 UNBLOCK_INPUT;
1219 error ("No icon window available");
1222 XFlush (FRAME_X_DISPLAY (f));
1223 UNBLOCK_INPUT;
1227 void
1228 x_set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
1230 int nlines;
1231 #if ! defined (USE_X_TOOLKIT) && ! defined (USE_GTK)
1232 int olines = FRAME_MENU_BAR_LINES (f);
1233 #endif
1235 /* Right now, menu bars don't work properly in minibuf-only frames;
1236 most of the commands try to apply themselves to the minibuffer
1237 frame itself, and get an error because you can't switch buffers
1238 in or split the minibuffer window. */
1239 if (FRAME_MINIBUF_ONLY_P (f))
1240 return;
1242 if (INTEGERP (value))
1243 nlines = XINT (value);
1244 else
1245 nlines = 0;
1247 /* Make sure we redisplay all windows in this frame. */
1248 windows_or_buffers_changed++;
1250 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
1251 FRAME_MENU_BAR_LINES (f) = 0;
1252 if (nlines)
1254 FRAME_EXTERNAL_MENU_BAR (f) = 1;
1255 if (FRAME_X_P (f) && f->output_data.x->menubar_widget == 0)
1256 /* Make sure next redisplay shows the menu bar. */
1257 XWINDOW (FRAME_SELECTED_WINDOW (f))->update_mode_line = Qt;
1259 else
1261 if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
1262 free_frame_menubar (f);
1263 FRAME_EXTERNAL_MENU_BAR (f) = 0;
1264 if (FRAME_X_P (f))
1265 f->output_data.x->menubar_widget = 0;
1267 #else /* not USE_X_TOOLKIT && not USE_GTK */
1268 FRAME_MENU_BAR_LINES (f) = nlines;
1269 resize_frame_windows (f, FRAME_LINES (f), 0);
1271 /* If the menu bar height gets changed, the internal border below
1272 the top margin has to be cleared. Also, if the menu bar gets
1273 larger, the area for the added lines has to be cleared except for
1274 the first menu bar line that is to be drawn later. */
1275 if (nlines != olines)
1277 int height = FRAME_INTERNAL_BORDER_WIDTH (f);
1278 int width = FRAME_PIXEL_WIDTH (f);
1279 int y;
1281 /* height can be zero here. */
1282 if (height > 0 && width > 0)
1284 y = FRAME_TOP_MARGIN_HEIGHT (f);
1286 BLOCK_INPUT;
1287 x_clear_area (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1288 0, y, width, height, False);
1289 UNBLOCK_INPUT;
1292 if (nlines > 1 && nlines > olines)
1294 y = (olines == 0 ? 1 : olines) * FRAME_LINE_HEIGHT (f);
1295 height = nlines * FRAME_LINE_HEIGHT (f) - y;
1297 BLOCK_INPUT;
1298 x_clear_area (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1299 0, y, width, height, False);
1300 UNBLOCK_INPUT;
1303 if (nlines == 0 && WINDOWP (f->menu_bar_window))
1304 clear_glyph_matrix (XWINDOW (f->menu_bar_window)->current_matrix);
1306 #endif /* not USE_X_TOOLKIT && not USE_GTK */
1307 adjust_glyphs (f);
1308 run_window_configuration_change_hook (f);
1312 /* Set the number of lines used for the tool bar of frame F to VALUE.
1313 VALUE not an integer, or < 0 means set the lines to zero. OLDVAL
1314 is the old number of tool bar lines. This function changes the
1315 height of all windows on frame F to match the new tool bar height.
1316 The frame's height doesn't change. */
1318 void
1319 x_set_tool_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
1321 int delta, nlines, root_height;
1322 Lisp_Object root_window;
1324 /* Treat tool bars like menu bars. */
1325 if (FRAME_MINIBUF_ONLY_P (f))
1326 return;
1328 /* Use VALUE only if an integer >= 0. */
1329 if (INTEGERP (value) && XINT (value) >= 0)
1330 nlines = XFASTINT (value);
1331 else
1332 nlines = 0;
1334 #ifdef USE_GTK
1335 FRAME_TOOL_BAR_LINES (f) = 0;
1336 if (nlines)
1338 FRAME_EXTERNAL_TOOL_BAR (f) = 1;
1339 if (FRAME_X_P (f) && f->output_data.x->toolbar_widget == 0)
1340 /* Make sure next redisplay shows the tool bar. */
1341 XWINDOW (FRAME_SELECTED_WINDOW (f))->update_mode_line = Qt;
1342 update_frame_tool_bar (f);
1344 else
1346 if (FRAME_EXTERNAL_TOOL_BAR (f))
1347 free_frame_tool_bar (f);
1348 FRAME_EXTERNAL_TOOL_BAR (f) = 0;
1351 return;
1352 #endif
1354 /* Make sure we redisplay all windows in this frame. */
1355 ++windows_or_buffers_changed;
1357 delta = nlines - FRAME_TOOL_BAR_LINES (f);
1359 /* Don't resize the tool-bar to more than we have room for. */
1360 root_window = FRAME_ROOT_WINDOW (f);
1361 root_height = WINDOW_TOTAL_LINES (XWINDOW (root_window));
1362 if (root_height - delta < 1)
1364 delta = root_height - 1;
1365 nlines = FRAME_TOOL_BAR_LINES (f) + delta;
1368 FRAME_TOOL_BAR_LINES (f) = nlines;
1369 resize_frame_windows (f, FRAME_LINES (f), 0);
1370 adjust_glyphs (f);
1372 /* We also have to make sure that the internal border at the top of
1373 the frame, below the menu bar or tool bar, is redrawn when the
1374 tool bar disappears. This is so because the internal border is
1375 below the tool bar if one is displayed, but is below the menu bar
1376 if there isn't a tool bar. The tool bar draws into the area
1377 below the menu bar. */
1378 if (FRAME_X_WINDOW (f) && FRAME_TOOL_BAR_LINES (f) == 0)
1380 clear_frame (f);
1381 clear_current_matrices (f);
1384 /* If the tool bar gets smaller, the internal border below it
1385 has to be cleared. It was formerly part of the display
1386 of the larger tool bar, and updating windows won't clear it. */
1387 if (delta < 0)
1389 int height = FRAME_INTERNAL_BORDER_WIDTH (f);
1390 int width = FRAME_PIXEL_WIDTH (f);
1391 int y = (FRAME_MENU_BAR_LINES (f) + nlines) * FRAME_LINE_HEIGHT (f);
1393 /* height can be zero here. */
1394 if (height > 0 && width > 0)
1396 BLOCK_INPUT;
1397 x_clear_area (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1398 0, y, width, height, False);
1399 UNBLOCK_INPUT;
1402 if (WINDOWP (f->tool_bar_window))
1403 clear_glyph_matrix (XWINDOW (f->tool_bar_window)->current_matrix);
1406 run_window_configuration_change_hook (f);
1411 /* Set the foreground color for scroll bars on frame F to VALUE.
1412 VALUE should be a string, a color name. If it isn't a string or
1413 isn't a valid color name, do nothing. OLDVAL is the old value of
1414 the frame parameter. */
1416 void
1417 x_set_scroll_bar_foreground (struct frame *f, Lisp_Object value, Lisp_Object oldval)
1419 unsigned long pixel;
1421 if (STRINGP (value))
1422 pixel = x_decode_color (f, value, BLACK_PIX_DEFAULT (f));
1423 else
1424 pixel = -1;
1426 if (f->output_data.x->scroll_bar_foreground_pixel != -1)
1427 unload_color (f, f->output_data.x->scroll_bar_foreground_pixel);
1429 f->output_data.x->scroll_bar_foreground_pixel = pixel;
1430 if (FRAME_X_WINDOW (f) && FRAME_VISIBLE_P (f))
1432 /* Remove all scroll bars because they have wrong colors. */
1433 if (FRAME_TERMINAL (f)->condemn_scroll_bars_hook)
1434 (*FRAME_TERMINAL (f)->condemn_scroll_bars_hook) (f);
1435 if (FRAME_TERMINAL (f)->judge_scroll_bars_hook)
1436 (*FRAME_TERMINAL (f)->judge_scroll_bars_hook) (f);
1438 update_face_from_frame_parameter (f, Qscroll_bar_foreground, value);
1439 redraw_frame (f);
1444 /* Set the background color for scroll bars on frame F to VALUE VALUE
1445 should be a string, a color name. If it isn't a string or isn't a
1446 valid color name, do nothing. OLDVAL is the old value of the frame
1447 parameter. */
1449 void
1450 x_set_scroll_bar_background (struct frame *f, Lisp_Object value, Lisp_Object oldval)
1452 unsigned long pixel;
1454 if (STRINGP (value))
1455 pixel = x_decode_color (f, value, WHITE_PIX_DEFAULT (f));
1456 else
1457 pixel = -1;
1459 if (f->output_data.x->scroll_bar_background_pixel != -1)
1460 unload_color (f, f->output_data.x->scroll_bar_background_pixel);
1462 #ifdef USE_TOOLKIT_SCROLL_BARS
1463 /* Scrollbar shadow colors. */
1464 if (f->output_data.x->scroll_bar_top_shadow_pixel != -1)
1466 unload_color (f, f->output_data.x->scroll_bar_top_shadow_pixel);
1467 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
1469 if (f->output_data.x->scroll_bar_bottom_shadow_pixel != -1)
1471 unload_color (f, f->output_data.x->scroll_bar_bottom_shadow_pixel);
1472 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
1474 #endif /* USE_TOOLKIT_SCROLL_BARS */
1476 f->output_data.x->scroll_bar_background_pixel = pixel;
1477 if (FRAME_X_WINDOW (f) && FRAME_VISIBLE_P (f))
1479 /* Remove all scroll bars because they have wrong colors. */
1480 if (FRAME_TERMINAL (f)->condemn_scroll_bars_hook)
1481 (*FRAME_TERMINAL (f)->condemn_scroll_bars_hook) (f);
1482 if (FRAME_TERMINAL (f)->judge_scroll_bars_hook)
1483 (*FRAME_TERMINAL (f)->judge_scroll_bars_hook) (f);
1485 update_face_from_frame_parameter (f, Qscroll_bar_background, value);
1486 redraw_frame (f);
1491 /* Encode Lisp string STRING as a text in a format appropriate for
1492 XICCC (X Inter Client Communication Conventions).
1494 This can call Lisp code, so callers must GCPRO.
1496 If STRING contains only ASCII characters, do no conversion and
1497 return the string data of STRING. Otherwise, encode the text by
1498 CODING_SYSTEM, and return a newly allocated memory area which
1499 should be freed by `xfree' by a caller.
1501 SELECTIONP non-zero means the string is being encoded for an X
1502 selection, so it is safe to run pre-write conversions (which
1503 may run Lisp code).
1505 Store the byte length of resulting text in *TEXT_BYTES.
1507 If the text contains only ASCII and Latin-1, store 1 in *STRING_P,
1508 which means that the `encoding' of the result can be `STRING'.
1509 Otherwise store 0 in *STRINGP, which means that the `encoding' of
1510 the result should be `COMPOUND_TEXT'. */
1512 static unsigned char *
1513 x_encode_text (Lisp_Object string, Lisp_Object coding_system, int selectionp, int *text_bytes, int *stringp, int *freep)
1515 int result = string_xstring_p (string);
1516 struct coding_system coding;
1518 if (result == 0)
1520 /* No multibyte character in OBJ. We need not encode it. */
1521 *text_bytes = SBYTES (string);
1522 *stringp = 1;
1523 *freep = 0;
1524 return SDATA (string);
1527 setup_coding_system (coding_system, &coding);
1528 coding.mode |= (CODING_MODE_SAFE_ENCODING | CODING_MODE_LAST_BLOCK);
1529 /* We suppress producing escape sequences for composition. */
1530 coding.common_flags &= ~CODING_ANNOTATION_MASK;
1531 coding.dst_bytes = SCHARS (string) * 2;
1532 coding.destination = (unsigned char *) xmalloc (coding.dst_bytes);
1533 encode_coding_object (&coding, string, 0, 0,
1534 SCHARS (string), SBYTES (string), Qnil);
1535 *text_bytes = coding.produced;
1536 *stringp = (result == 1 || !EQ (coding_system, Qcompound_text));
1537 *freep = 1;
1538 return coding.destination;
1542 /* Set the WM name to NAME for frame F. Also set the icon name.
1543 If the frame already has an icon name, use that, otherwise set the
1544 icon name to NAME. */
1546 static void
1547 x_set_name_internal (FRAME_PTR f, Lisp_Object name)
1549 if (FRAME_X_WINDOW (f))
1551 BLOCK_INPUT;
1553 XTextProperty text, icon;
1554 int bytes, stringp;
1555 int do_free_icon_value = 0, do_free_text_value = 0;
1556 Lisp_Object coding_system;
1557 Lisp_Object encoded_name;
1558 Lisp_Object encoded_icon_name;
1559 struct gcpro gcpro1;
1561 /* As ENCODE_UTF_8 may cause GC and relocation of string data,
1562 we use it before x_encode_text that may return string data. */
1563 GCPRO1 (name);
1564 encoded_name = ENCODE_UTF_8 (name);
1565 UNGCPRO;
1567 coding_system = Qcompound_text;
1568 /* Note: Encoding strategy
1570 We encode NAME by compound-text and use "COMPOUND-TEXT" in
1571 text.encoding. But, there are non-internationalized window
1572 managers which don't support that encoding. So, if NAME
1573 contains only ASCII and 8859-1 characters, encode it by
1574 iso-latin-1, and use "STRING" in text.encoding hoping that
1575 such window managers at least analyze this format correctly,
1576 i.e. treat 8-bit bytes as 8859-1 characters.
1578 We may also be able to use "UTF8_STRING" in text.encoding
1579 in the future which can encode all Unicode characters.
1580 But, for the moment, there's no way to know that the
1581 current window manager supports it or not.
1583 Either way, we also set the _NET_WM_NAME and _NET_WM_ICON_NAME
1584 properties. Per the EWMH specification, those two properties
1585 are always UTF8_STRING. This matches what gtk_window_set_title()
1586 does in the USE_GTK case. */
1587 text.value = x_encode_text (name, coding_system, 0, &bytes, &stringp,
1588 &do_free_text_value);
1589 text.encoding = (stringp ? XA_STRING
1590 : FRAME_X_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
1591 text.format = 8;
1592 text.nitems = bytes;
1594 if (!STRINGP (f->icon_name))
1596 icon = text;
1597 encoded_icon_name = encoded_name;
1599 else
1601 /* See the above comment "Note: Encoding strategy". */
1602 icon.value = x_encode_text (f->icon_name, coding_system, 0,
1603 &bytes, &stringp, &do_free_icon_value);
1604 icon.encoding = (stringp ? XA_STRING
1605 : FRAME_X_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
1606 icon.format = 8;
1607 icon.nitems = bytes;
1609 encoded_icon_name = ENCODE_UTF_8 (f->icon_name);
1612 #ifdef USE_GTK
1613 gtk_window_set_title (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)),
1614 (char *) SDATA (encoded_name));
1615 #else /* not USE_GTK */
1616 XSetWMName (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &text);
1617 XChangeProperty (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f),
1618 FRAME_X_DISPLAY_INFO (f)->Xatom_net_wm_name,
1619 FRAME_X_DISPLAY_INFO (f)->Xatom_UTF8_STRING,
1620 8, PropModeReplace,
1621 (char *) SDATA (encoded_name),
1622 SBYTES (encoded_name));
1623 #endif /* not USE_GTK */
1625 XSetWMIconName (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &icon);
1626 XChangeProperty (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f),
1627 FRAME_X_DISPLAY_INFO (f)->Xatom_net_wm_icon_name,
1628 FRAME_X_DISPLAY_INFO (f)->Xatom_UTF8_STRING,
1629 8, PropModeReplace,
1630 (char *) SDATA (encoded_icon_name),
1631 SBYTES (encoded_icon_name));
1633 if (do_free_icon_value)
1634 xfree (icon.value);
1635 if (do_free_text_value)
1636 xfree (text.value);
1638 UNBLOCK_INPUT;
1642 /* Change the name of frame F to NAME. If NAME is nil, set F's name to
1643 x_id_name.
1645 If EXPLICIT is non-zero, that indicates that lisp code is setting the
1646 name; if NAME is a string, set F's name to NAME and set
1647 F->explicit_name; if NAME is Qnil, then clear F->explicit_name.
1649 If EXPLICIT is zero, that indicates that Emacs redisplay code is
1650 suggesting a new name, which lisp code should override; if
1651 F->explicit_name is set, ignore the new name; otherwise, set it. */
1653 void
1654 x_set_name (struct frame *f, Lisp_Object name, int explicit)
1656 /* Make sure that requests from lisp code override requests from
1657 Emacs redisplay code. */
1658 if (explicit)
1660 /* If we're switching from explicit to implicit, we had better
1661 update the mode lines and thereby update the title. */
1662 if (f->explicit_name && NILP (name))
1663 update_mode_lines = 1;
1665 f->explicit_name = ! NILP (name);
1667 else if (f->explicit_name)
1668 return;
1670 /* If NAME is nil, set the name to the x_id_name. */
1671 if (NILP (name))
1673 /* Check for no change needed in this very common case
1674 before we do any consing. */
1675 if (!strcmp (FRAME_X_DISPLAY_INFO (f)->x_id_name,
1676 SDATA (f->name)))
1677 return;
1678 name = build_string (FRAME_X_DISPLAY_INFO (f)->x_id_name);
1680 else
1681 CHECK_STRING (name);
1683 /* Don't change the name if it's already NAME. */
1684 if (! NILP (Fstring_equal (name, f->name)))
1685 return;
1687 f->name = name;
1689 /* For setting the frame title, the title parameter should override
1690 the name parameter. */
1691 if (! NILP (f->title))
1692 name = f->title;
1694 x_set_name_internal (f, name);
1697 /* This function should be called when the user's lisp code has
1698 specified a name for the frame; the name will override any set by the
1699 redisplay code. */
1700 void
1701 x_explicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
1703 x_set_name (f, arg, 1);
1706 /* This function should be called by Emacs redisplay code to set the
1707 name; names set this way will never override names set by the user's
1708 lisp code. */
1709 void
1710 x_implicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
1712 x_set_name (f, arg, 0);
1715 /* Change the title of frame F to NAME.
1716 If NAME is nil, use the frame name as the title. */
1718 void
1719 x_set_title (struct frame *f, Lisp_Object name, Lisp_Object old_name)
1721 /* Don't change the title if it's already NAME. */
1722 if (EQ (name, f->title))
1723 return;
1725 update_mode_lines = 1;
1727 f->title = name;
1729 if (NILP (name))
1730 name = f->name;
1731 else
1732 CHECK_STRING (name);
1734 x_set_name_internal (f, name);
1737 void
1738 x_set_scroll_bar_default_width (struct frame *f)
1740 int wid = FRAME_COLUMN_WIDTH (f);
1742 #ifdef USE_TOOLKIT_SCROLL_BARS
1743 /* A minimum width of 14 doesn't look good for toolkit scroll bars. */
1744 int width = 16 + 2 * VERTICAL_SCROLL_BAR_WIDTH_TRIM;
1745 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (width + wid - 1) / wid;
1746 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = width;
1747 #else
1748 /* Make the actual width at least 14 pixels and a multiple of a
1749 character width. */
1750 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (14 + wid - 1) / wid;
1752 /* Use all of that space (aside from required margins) for the
1753 scroll bar. */
1754 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = 0;
1755 #endif
1759 /* Record in frame F the specified or default value according to ALIST
1760 of the parameter named PROP (a Lisp symbol). If no value is
1761 specified for PROP, look for an X default for XPROP on the frame
1762 named NAME. If that is not found either, use the value DEFLT. */
1764 static Lisp_Object
1765 x_default_scroll_bar_color_parameter (struct frame *f,
1766 Lisp_Object alist, Lisp_Object prop,
1767 char *xprop, char *xclass,
1768 int foreground_p)
1770 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
1771 Lisp_Object tem;
1773 tem = x_get_arg (dpyinfo, alist, prop, xprop, xclass, RES_TYPE_STRING);
1774 if (EQ (tem, Qunbound))
1776 #ifdef USE_TOOLKIT_SCROLL_BARS
1778 /* See if an X resource for the scroll bar color has been
1779 specified. */
1780 tem = display_x_get_resource (dpyinfo,
1781 build_string (foreground_p
1782 ? "foreground"
1783 : "background"),
1784 empty_unibyte_string,
1785 build_string ("verticalScrollBar"),
1786 empty_unibyte_string);
1787 if (!STRINGP (tem))
1789 /* If nothing has been specified, scroll bars will use a
1790 toolkit-dependent default. Because these defaults are
1791 difficult to get at without actually creating a scroll
1792 bar, use nil to indicate that no color has been
1793 specified. */
1794 tem = Qnil;
1797 #else /* not USE_TOOLKIT_SCROLL_BARS */
1799 tem = Qnil;
1801 #endif /* not USE_TOOLKIT_SCROLL_BARS */
1804 x_set_frame_parameters (f, Fcons (Fcons (prop, tem), Qnil));
1805 return tem;
1811 #ifdef USE_X_TOOLKIT
1813 /* If the WM_PROTOCOLS property does not already contain WM_TAKE_FOCUS,
1814 WM_DELETE_WINDOW, and WM_SAVE_YOURSELF, then add them. (They may
1815 already be present because of the toolkit (Motif adds some of them,
1816 for example, but Xt doesn't). */
1818 static void
1819 hack_wm_protocols (FRAME_PTR f, Widget widget)
1821 Display *dpy = XtDisplay (widget);
1822 Window w = XtWindow (widget);
1823 int need_delete = 1;
1824 int need_focus = 1;
1825 int need_save = 1;
1827 BLOCK_INPUT;
1829 Atom type;
1830 unsigned char *catoms;
1831 int format = 0;
1832 unsigned long nitems = 0;
1833 unsigned long bytes_after;
1835 if ((XGetWindowProperty (dpy, w,
1836 FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
1837 (long)0, (long)100, False, XA_ATOM,
1838 &type, &format, &nitems, &bytes_after,
1839 &catoms)
1840 == Success)
1841 && format == 32 && type == XA_ATOM)
1843 Atom *atoms = (Atom *) catoms;
1844 while (nitems > 0)
1846 nitems--;
1847 if (atoms[nitems]
1848 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window)
1849 need_delete = 0;
1850 else if (atoms[nitems]
1851 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_take_focus)
1852 need_focus = 0;
1853 else if (atoms[nitems]
1854 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself)
1855 need_save = 0;
1858 if (catoms)
1859 XFree (catoms);
1862 Atom props [10];
1863 int count = 0;
1864 if (need_delete)
1865 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window;
1866 if (need_focus)
1867 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_take_focus;
1868 if (need_save)
1869 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself;
1870 if (count)
1871 XChangeProperty (dpy, w, FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
1872 XA_ATOM, 32, PropModeAppend,
1873 (unsigned char *) props, count);
1875 UNBLOCK_INPUT;
1877 #endif
1881 /* Support routines for XIC (X Input Context). */
1883 #ifdef HAVE_X_I18N
1885 static XFontSet xic_create_xfontset (struct frame *);
1886 static XIMStyle best_xim_style (XIMStyles *, XIMStyles *);
1889 /* Supported XIM styles, ordered by preference. */
1891 static XIMStyle supported_xim_styles[] =
1893 XIMPreeditPosition | XIMStatusArea,
1894 XIMPreeditPosition | XIMStatusNothing,
1895 XIMPreeditPosition | XIMStatusNone,
1896 XIMPreeditNothing | XIMStatusArea,
1897 XIMPreeditNothing | XIMStatusNothing,
1898 XIMPreeditNothing | XIMStatusNone,
1899 XIMPreeditNone | XIMStatusArea,
1900 XIMPreeditNone | XIMStatusNothing,
1901 XIMPreeditNone | XIMStatusNone,
1906 /* Create an X fontset on frame F with base font name BASE_FONTNAME. */
1908 char xic_defaut_fontset[] = "-*-*-*-r-normal--14-*-*-*-*-*-*-*";
1910 /* Create an Xt fontset spec from the name of a base font.
1911 If `motif' is True use the Motif syntax. */
1912 char *
1913 xic_create_fontsetname (char *base_fontname, int motif)
1915 const char *sep = motif ? ";" : ",";
1916 char *fontsetname;
1918 /* Make a fontset name from the base font name. */
1919 if (xic_defaut_fontset == base_fontname)
1920 { /* There is no base font name, use the default. */
1921 int len = strlen (base_fontname) + 2;
1922 fontsetname = xmalloc (len);
1923 memset (fontsetname, 0, len);
1924 strcpy (fontsetname, base_fontname);
1926 else
1928 /* Make a fontset name from the base font name.
1929 The font set will be made of the following elements:
1930 - the base font.
1931 - the base font where the charset spec is replaced by -*-*.
1932 - the same but with the family also replaced with -*-*-. */
1933 char *p = base_fontname;
1934 int i;
1936 for (i = 0; *p; p++)
1937 if (*p == '-') i++;
1938 if (i != 14)
1939 { /* As the font name doesn't conform to XLFD, we can't
1940 modify it to generalize it to allcs and allfamilies.
1941 Use the specified font plus the default. */
1942 int len = strlen (base_fontname) + strlen (xic_defaut_fontset) + 3;
1943 fontsetname = xmalloc (len);
1944 memset (fontsetname, 0, len);
1945 strcpy (fontsetname, base_fontname);
1946 strcat (fontsetname, sep);
1947 strcat (fontsetname, xic_defaut_fontset);
1949 else
1951 int len;
1952 char *p1 = NULL, *p2 = NULL, *p3 = NULL;
1953 char *font_allcs = NULL;
1954 char *font_allfamilies = NULL;
1955 char *font_all = NULL;
1956 char *allcs = "*-*-*-*-*-*-*";
1957 char *allfamilies = "-*-*-";
1958 char *all = "*-*-*-*-";
1959 char *base;
1961 for (i = 0, p = base_fontname; i < 8; p++)
1963 if (*p == '-')
1965 i++;
1966 if (i == 3)
1967 p1 = p + 1;
1968 else if (i == 7)
1969 p2 = p + 1;
1970 else if (i == 6)
1971 p3 = p + 1;
1974 /* If base_fontname specifies ADSTYLE, make it a
1975 wildcard. */
1976 if (*p3 != '*')
1978 int diff = (p2 - p3) - 2;
1980 base = alloca (strlen (base_fontname) + 1);
1981 memcpy (base, base_fontname, p3 - base_fontname);
1982 base[p3 - base_fontname] = '*';
1983 base[(p3 - base_fontname) + 1] = '-';
1984 strcpy (base + (p3 - base_fontname) + 2, p2);
1985 p = base + (p - base_fontname) - diff;
1986 p1 = base + (p1 - base_fontname);
1987 p2 = base + (p2 - base_fontname) - diff;
1988 base_fontname = base;
1991 /* Build the font spec that matches all charsets. */
1992 len = p - base_fontname + strlen (allcs) + 1;
1993 font_allcs = (char *) alloca (len);
1994 memset (font_allcs, 0, len);
1995 memcpy (font_allcs, base_fontname, p - base_fontname);
1996 strcat (font_allcs, allcs);
1998 /* Build the font spec that matches all families and
1999 add-styles. */
2000 len = p - p1 + strlen (allcs) + strlen (allfamilies) + 1;
2001 font_allfamilies = (char *) alloca (len);
2002 memset (font_allfamilies, 0, len);
2003 strcpy (font_allfamilies, allfamilies);
2004 memcpy (font_allfamilies + strlen (allfamilies), p1, p - p1);
2005 strcat (font_allfamilies, allcs);
2007 /* Build the font spec that matches all. */
2008 len = p - p2 + strlen (allcs) + strlen (all) + strlen (allfamilies) + 1;
2009 font_all = (char *) alloca (len);
2010 memset (font_all, 0, len);
2011 strcpy (font_all, allfamilies);
2012 strcat (font_all, all);
2013 memcpy (font_all + strlen (all) + strlen (allfamilies), p2, p - p2);
2014 strcat (font_all, allcs);
2016 /* Build the actual font set name. */
2017 len = strlen (base_fontname) + strlen (font_allcs)
2018 + strlen (font_allfamilies) + strlen (font_all) + 5;
2019 fontsetname = xmalloc (len);
2020 memset (fontsetname, 0, len);
2021 strcpy (fontsetname, base_fontname);
2022 strcat (fontsetname, sep);
2023 strcat (fontsetname, font_allcs);
2024 strcat (fontsetname, sep);
2025 strcat (fontsetname, font_allfamilies);
2026 strcat (fontsetname, sep);
2027 strcat (fontsetname, font_all);
2030 if (motif)
2031 strcat (fontsetname, ":");
2032 return fontsetname;
2035 #ifdef DEBUG_XIC_FONTSET
2036 static void
2037 print_fontset_result (xfs, name, missing_list, missing_count)
2038 XFontSet xfs;
2039 char *name;
2040 char **missing_list;
2041 int missing_count;
2043 if (xfs)
2044 fprintf (stderr, "XIC Fontset created: %s\n", name);
2045 else
2047 fprintf (stderr, "XIC Fontset failed: %s\n", name);
2048 while (missing_count-- > 0)
2050 fprintf (stderr, " missing: %s\n", *missing_list);
2051 missing_list++;
2056 #endif
2058 static XFontSet
2059 xic_create_xfontset (struct frame *f)
2061 XFontSet xfs = NULL;
2062 struct font *font = FRAME_FONT (f);
2063 int pixel_size = font->pixel_size;
2064 Lisp_Object rest, frame;
2066 /* See if there is another frame already using same fontset. */
2067 FOR_EACH_FRAME (rest, frame)
2069 struct frame *cf = XFRAME (frame);
2071 if (cf != f && FRAME_LIVE_P (f) && FRAME_X_P (cf)
2072 && FRAME_X_DISPLAY_INFO (cf) == FRAME_X_DISPLAY_INFO (f)
2073 && FRAME_FONT (f)
2074 && FRAME_FONT (f)->pixel_size == pixel_size)
2076 xfs = FRAME_XIC_FONTSET (cf);
2077 break;
2081 if (! xfs)
2083 char buf[256];
2084 char **missing_list;
2085 int missing_count;
2086 char *def_string;
2087 char *xlfd_format = "-*-*-medium-r-normal--%d-*-*-*-*-*";
2089 sprintf (buf, xlfd_format, pixel_size);
2090 missing_list = NULL;
2091 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), buf,
2092 &missing_list, &missing_count, &def_string);
2093 #ifdef DEBUG_XIC_FONTSET
2094 print_fontset_result (xfs, buf, missing_list, missing_count);
2095 #endif
2096 if (missing_list)
2097 XFreeStringList (missing_list);
2098 if (! xfs)
2100 /* List of pixel sizes most likely available. Find one that
2101 is closest to pixel_size. */
2102 int sizes[] = {0, 8, 10, 11, 12, 14, 17, 18, 20, 24, 26, 34, 0};
2103 int *smaller, *larger;
2105 for (smaller = sizes; smaller[1]; smaller++)
2106 if (smaller[1] >= pixel_size)
2107 break;
2108 larger = smaller + 1;
2109 if (*larger == pixel_size)
2110 larger++;
2111 while (*smaller || *larger)
2113 int this_size;
2115 if (! *larger)
2116 this_size = *smaller--;
2117 else if (! *smaller)
2118 this_size = *larger++;
2119 else if (pixel_size - *smaller < *larger - pixel_size)
2120 this_size = *smaller--;
2121 else
2122 this_size = *larger++;
2123 sprintf (buf, xlfd_format, this_size);
2124 missing_list = NULL;
2125 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), buf,
2126 &missing_list, &missing_count, &def_string);
2127 #ifdef DEBUG_XIC_FONTSET
2128 print_fontset_result (xfs, buf, missing_list, missing_count);
2129 #endif
2130 if (missing_list)
2131 XFreeStringList (missing_list);
2132 if (xfs)
2133 break;
2136 if (! xfs)
2138 char *last_resort = "-*-*-*-r-normal--*-*-*-*-*-*";
2140 missing_list = NULL;
2141 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), last_resort,
2142 &missing_list, &missing_count, &def_string);
2143 #ifdef DEBUG_XIC_FONTSET
2144 print_fontset_result (xfs, last_resort, missing_list, missing_count);
2145 #endif
2146 if (missing_list)
2147 XFreeStringList (missing_list);
2152 return xfs;
2155 /* Free the X fontset of frame F if it is the last frame using it. */
2157 void
2158 xic_free_xfontset (struct frame *f)
2160 Lisp_Object rest, frame;
2161 int shared_p = 0;
2163 if (!FRAME_XIC_FONTSET (f))
2164 return;
2166 /* See if there is another frame sharing the same fontset. */
2167 FOR_EACH_FRAME (rest, frame)
2169 struct frame *cf = XFRAME (frame);
2170 if (cf != f && FRAME_LIVE_P (f) && FRAME_X_P (cf)
2171 && FRAME_X_DISPLAY_INFO (cf) == FRAME_X_DISPLAY_INFO (f)
2172 && FRAME_XIC_FONTSET (cf) == FRAME_XIC_FONTSET (f))
2174 shared_p = 1;
2175 break;
2179 if (!shared_p)
2180 /* The fontset is not used anymore. It is safe to free it. */
2181 XFreeFontSet (FRAME_X_DISPLAY (f), FRAME_XIC_FONTSET (f));
2183 if (FRAME_XIC_BASE_FONTNAME (f))
2184 xfree (FRAME_XIC_BASE_FONTNAME (f));
2185 FRAME_XIC_BASE_FONTNAME (f) = NULL;
2186 FRAME_XIC_FONTSET (f) = NULL;
2190 /* Value is the best input style, given user preferences USER (already
2191 checked to be supported by Emacs), and styles supported by the
2192 input method XIM. */
2194 static XIMStyle
2195 best_xim_style (XIMStyles *user, XIMStyles *xim)
2197 int i, j;
2199 for (i = 0; i < user->count_styles; ++i)
2200 for (j = 0; j < xim->count_styles; ++j)
2201 if (user->supported_styles[i] == xim->supported_styles[j])
2202 return user->supported_styles[i];
2204 /* Return the default style. */
2205 return XIMPreeditNothing | XIMStatusNothing;
2208 /* Create XIC for frame F. */
2210 static XIMStyle xic_style;
2212 void
2213 create_frame_xic (struct frame *f)
2215 XIM xim;
2216 XIC xic = NULL;
2217 XFontSet xfs = NULL;
2219 if (FRAME_XIC (f))
2220 return;
2222 /* Create X fontset. */
2223 xfs = xic_create_xfontset (f);
2224 xim = FRAME_X_XIM (f);
2225 if (xim)
2227 XRectangle s_area;
2228 XPoint spot;
2229 XVaNestedList preedit_attr;
2230 XVaNestedList status_attr;
2232 s_area.x = 0; s_area.y = 0; s_area.width = 1; s_area.height = 1;
2233 spot.x = 0; spot.y = 1;
2235 /* Determine XIC style. */
2236 if (xic_style == 0)
2238 XIMStyles supported_list;
2239 supported_list.count_styles = (sizeof supported_xim_styles
2240 / sizeof supported_xim_styles[0]);
2241 supported_list.supported_styles = supported_xim_styles;
2242 xic_style = best_xim_style (&supported_list,
2243 FRAME_X_XIM_STYLES (f));
2246 preedit_attr = XVaCreateNestedList (0,
2247 XNFontSet, xfs,
2248 XNForeground,
2249 FRAME_FOREGROUND_PIXEL (f),
2250 XNBackground,
2251 FRAME_BACKGROUND_PIXEL (f),
2252 (xic_style & XIMPreeditPosition
2253 ? XNSpotLocation
2254 : NULL),
2255 &spot,
2256 NULL);
2257 status_attr = XVaCreateNestedList (0,
2258 XNArea,
2259 &s_area,
2260 XNFontSet,
2261 xfs,
2262 XNForeground,
2263 FRAME_FOREGROUND_PIXEL (f),
2264 XNBackground,
2265 FRAME_BACKGROUND_PIXEL (f),
2266 NULL);
2268 xic = XCreateIC (xim,
2269 XNInputStyle, xic_style,
2270 XNClientWindow, FRAME_X_WINDOW (f),
2271 XNFocusWindow, FRAME_X_WINDOW (f),
2272 XNStatusAttributes, status_attr,
2273 XNPreeditAttributes, preedit_attr,
2274 NULL);
2275 XFree (preedit_attr);
2276 XFree (status_attr);
2279 FRAME_XIC (f) = xic;
2280 FRAME_XIC_STYLE (f) = xic_style;
2281 FRAME_XIC_FONTSET (f) = xfs;
2285 /* Destroy XIC and free XIC fontset of frame F, if any. */
2287 void
2288 free_frame_xic (struct frame *f)
2290 if (FRAME_XIC (f) == NULL)
2291 return;
2293 XDestroyIC (FRAME_XIC (f));
2294 xic_free_xfontset (f);
2296 FRAME_XIC (f) = NULL;
2300 /* Place preedit area for XIC of window W's frame to specified
2301 pixel position X/Y. X and Y are relative to window W. */
2303 void
2304 xic_set_preeditarea (struct window *w, int x, int y)
2306 struct frame *f = XFRAME (w->frame);
2307 XVaNestedList attr;
2308 XPoint spot;
2310 spot.x = WINDOW_TO_FRAME_PIXEL_X (w, x) + WINDOW_LEFT_FRINGE_WIDTH (w);
2311 spot.y = WINDOW_TO_FRAME_PIXEL_Y (w, y) + FONT_BASE (FRAME_FONT (f));
2312 attr = XVaCreateNestedList (0, XNSpotLocation, &spot, NULL);
2313 XSetICValues (FRAME_XIC (f), XNPreeditAttributes, attr, NULL);
2314 XFree (attr);
2318 /* Place status area for XIC in bottom right corner of frame F.. */
2320 void
2321 xic_set_statusarea (struct frame *f)
2323 XIC xic = FRAME_XIC (f);
2324 XVaNestedList attr;
2325 XRectangle area;
2326 XRectangle *needed;
2328 /* Negotiate geometry of status area. If input method has existing
2329 status area, use its current size. */
2330 area.x = area.y = area.width = area.height = 0;
2331 attr = XVaCreateNestedList (0, XNAreaNeeded, &area, NULL);
2332 XSetICValues (xic, XNStatusAttributes, attr, NULL);
2333 XFree (attr);
2335 attr = XVaCreateNestedList (0, XNAreaNeeded, &needed, NULL);
2336 XGetICValues (xic, XNStatusAttributes, attr, NULL);
2337 XFree (attr);
2339 if (needed->width == 0) /* Use XNArea instead of XNAreaNeeded */
2341 attr = XVaCreateNestedList (0, XNArea, &needed, NULL);
2342 XGetICValues (xic, XNStatusAttributes, attr, NULL);
2343 XFree (attr);
2346 area.width = needed->width;
2347 area.height = needed->height;
2348 area.x = FRAME_PIXEL_WIDTH (f) - area.width - FRAME_INTERNAL_BORDER_WIDTH (f);
2349 area.y = (FRAME_PIXEL_HEIGHT (f) - area.height
2350 - FRAME_MENUBAR_HEIGHT (f)
2351 - FRAME_TOOLBAR_HEIGHT (f)
2352 - FRAME_INTERNAL_BORDER_WIDTH (f));
2353 XFree (needed);
2355 attr = XVaCreateNestedList (0, XNArea, &area, NULL);
2356 XSetICValues (xic, XNStatusAttributes, attr, NULL);
2357 XFree (attr);
2361 /* Set X fontset for XIC of frame F, using base font name
2362 BASE_FONTNAME. Called when a new Emacs fontset is chosen. */
2364 void
2365 xic_set_xfontset (struct frame *f, const char *base_fontname)
2367 XVaNestedList attr;
2368 XFontSet xfs;
2370 xic_free_xfontset (f);
2372 xfs = xic_create_xfontset (f);
2374 attr = XVaCreateNestedList (0, XNFontSet, xfs, NULL);
2375 if (FRAME_XIC_STYLE (f) & XIMPreeditPosition)
2376 XSetICValues (FRAME_XIC (f), XNPreeditAttributes, attr, NULL);
2377 if (FRAME_XIC_STYLE (f) & XIMStatusArea)
2378 XSetICValues (FRAME_XIC (f), XNStatusAttributes, attr, NULL);
2379 XFree (attr);
2381 FRAME_XIC_FONTSET (f) = xfs;
2384 #endif /* HAVE_X_I18N */
2388 #ifdef USE_X_TOOLKIT
2390 /* Create and set up the X widget for frame F. */
2392 static void
2393 x_window (struct frame *f, long window_prompting, int minibuffer_only)
2395 XClassHint class_hints;
2396 XSetWindowAttributes attributes;
2397 unsigned long attribute_mask;
2398 Widget shell_widget;
2399 Widget pane_widget;
2400 Widget frame_widget;
2401 Arg al [25];
2402 int ac;
2404 BLOCK_INPUT;
2406 /* Use the resource name as the top-level widget name
2407 for looking up resources. Make a non-Lisp copy
2408 for the window manager, so GC relocation won't bother it.
2410 Elsewhere we specify the window name for the window manager. */
2413 char *str = (char *) SDATA (Vx_resource_name);
2414 f->namebuf = (char *) xmalloc (strlen (str) + 1);
2415 strcpy (f->namebuf, str);
2418 ac = 0;
2419 XtSetArg (al[ac], XtNallowShellResize, 1); ac++;
2420 XtSetArg (al[ac], XtNinput, 1); ac++;
2421 XtSetArg (al[ac], XtNmappedWhenManaged, 0); ac++;
2422 XtSetArg (al[ac], XtNborderWidth, f->border_width); ac++;
2423 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2424 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2425 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2426 shell_widget = XtAppCreateShell (f->namebuf, EMACS_CLASS,
2427 applicationShellWidgetClass,
2428 FRAME_X_DISPLAY (f), al, ac);
2430 f->output_data.x->widget = shell_widget;
2431 /* maybe_set_screen_title_format (shell_widget); */
2433 pane_widget = lw_create_widget ("main", "pane", widget_id_tick++,
2434 (widget_value *) NULL,
2435 shell_widget, False,
2436 (lw_callback) NULL,
2437 (lw_callback) NULL,
2438 (lw_callback) NULL,
2439 (lw_callback) NULL);
2441 ac = 0;
2442 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2443 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2444 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2445 XtSetArg (al[ac], XtNborderWidth, 0); ac++;
2446 XtSetValues (pane_widget, al, ac);
2447 f->output_data.x->column_widget = pane_widget;
2449 /* mappedWhenManaged to false tells to the paned window to not map/unmap
2450 the emacs screen when changing menubar. This reduces flickering. */
2452 ac = 0;
2453 XtSetArg (al[ac], XtNmappedWhenManaged, 0); ac++;
2454 XtSetArg (al[ac], XtNshowGrip, 0); ac++;
2455 XtSetArg (al[ac], XtNallowResize, 1); ac++;
2456 XtSetArg (al[ac], XtNresizeToPreferred, 1); ac++;
2457 XtSetArg (al[ac], XtNemacsFrame, f); ac++;
2458 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2459 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2460 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2461 XtSetArg (al[ac], XtNborderWidth, 0); ac++;
2462 frame_widget = XtCreateWidget (f->namebuf, emacsFrameClass, pane_widget,
2463 al, ac);
2465 f->output_data.x->edit_widget = frame_widget;
2467 XtManageChild (frame_widget);
2469 /* Do some needed geometry management. */
2471 int len;
2472 char *tem, shell_position[32];
2473 Arg al[10];
2474 int ac = 0;
2475 int extra_borders = 0;
2476 int menubar_size
2477 = (f->output_data.x->menubar_widget
2478 ? (f->output_data.x->menubar_widget->core.height
2479 + f->output_data.x->menubar_widget->core.border_width)
2480 : 0);
2482 #if 0 /* Experimentally, we now get the right results
2483 for -geometry -0-0 without this. 24 Aug 96, rms. */
2484 if (FRAME_EXTERNAL_MENU_BAR (f))
2486 Dimension ibw = 0;
2487 XtVaGetValues (pane_widget, XtNinternalBorderWidth, &ibw, NULL);
2488 menubar_size += ibw;
2490 #endif
2492 f->output_data.x->menubar_height = menubar_size;
2494 #ifndef USE_LUCID
2495 /* Motif seems to need this amount added to the sizes
2496 specified for the shell widget. The Athena/Lucid widgets don't.
2497 Both conclusions reached experimentally. -- rms. */
2498 XtVaGetValues (f->output_data.x->edit_widget, XtNinternalBorderWidth,
2499 &extra_borders, NULL);
2500 extra_borders *= 2;
2501 #endif
2503 /* Convert our geometry parameters into a geometry string
2504 and specify it.
2505 Note that we do not specify here whether the position
2506 is a user-specified or program-specified one.
2507 We pass that information later, in x_wm_set_size_hints. */
2509 int left = f->left_pos;
2510 int xneg = window_prompting & XNegative;
2511 int top = f->top_pos;
2512 int yneg = window_prompting & YNegative;
2513 if (xneg)
2514 left = -left;
2515 if (yneg)
2516 top = -top;
2518 if (window_prompting & USPosition)
2519 sprintf (shell_position, "=%dx%d%c%d%c%d",
2520 FRAME_PIXEL_WIDTH (f) + extra_borders,
2521 FRAME_PIXEL_HEIGHT (f) + menubar_size + extra_borders,
2522 (xneg ? '-' : '+'), left,
2523 (yneg ? '-' : '+'), top);
2524 else
2526 sprintf (shell_position, "=%dx%d",
2527 FRAME_PIXEL_WIDTH (f) + extra_borders,
2528 FRAME_PIXEL_HEIGHT (f) + menubar_size + extra_borders);
2530 /* Setting x and y when the position is not specified in
2531 the geometry string will set program position in the WM hints.
2532 If Emacs had just one program position, we could set it in
2533 fallback resources, but since each make-frame call can specify
2534 different program positions, this is easier. */
2535 XtSetArg (al[ac], XtNx, left); ac++;
2536 XtSetArg (al[ac], XtNy, top); ac++;
2540 len = strlen (shell_position) + 1;
2541 /* We don't free this because we don't know whether
2542 it is safe to free it while the frame exists.
2543 It isn't worth the trouble of arranging to free it
2544 when the frame is deleted. */
2545 tem = (char *) xmalloc (len);
2546 strncpy (tem, shell_position, len);
2547 XtSetArg (al[ac], XtNgeometry, tem); ac++;
2548 XtSetValues (shell_widget, al, ac);
2551 XtManageChild (pane_widget);
2552 XtRealizeWidget (shell_widget);
2554 if (FRAME_X_EMBEDDED_P (f))
2555 XReparentWindow (FRAME_X_DISPLAY (f), XtWindow (shell_widget),
2556 f->output_data.x->parent_desc, 0, 0);
2558 FRAME_X_WINDOW (f) = XtWindow (frame_widget);
2560 validate_x_resource_name ();
2562 class_hints.res_name = (char *) SDATA (Vx_resource_name);
2563 class_hints.res_class = (char *) SDATA (Vx_resource_class);
2564 XSetClassHint (FRAME_X_DISPLAY (f), XtWindow (shell_widget), &class_hints);
2566 #ifdef HAVE_X_I18N
2567 FRAME_XIC (f) = NULL;
2568 if (use_xim)
2569 create_frame_xic (f);
2570 #endif
2572 f->output_data.x->wm_hints.input = True;
2573 f->output_data.x->wm_hints.flags |= InputHint;
2574 XSetWMHints (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2575 &f->output_data.x->wm_hints);
2577 hack_wm_protocols (f, shell_widget);
2579 #ifdef HACK_EDITRES
2580 XtAddEventHandler (shell_widget, 0, True, _XEditResCheckMessages, 0);
2581 #endif
2583 /* Do a stupid property change to force the server to generate a
2584 PropertyNotify event so that the event_stream server timestamp will
2585 be initialized to something relevant to the time we created the window.
2587 XChangeProperty (XtDisplay (frame_widget), XtWindow (frame_widget),
2588 FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
2589 XA_ATOM, 32, PropModeAppend,
2590 (unsigned char*) NULL, 0);
2592 /* Make all the standard events reach the Emacs frame. */
2593 attributes.event_mask = STANDARD_EVENT_SET;
2595 #ifdef HAVE_X_I18N
2596 if (FRAME_XIC (f))
2598 /* XIM server might require some X events. */
2599 unsigned long fevent = NoEventMask;
2600 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2601 attributes.event_mask |= fevent;
2603 #endif /* HAVE_X_I18N */
2605 attribute_mask = CWEventMask;
2606 XChangeWindowAttributes (XtDisplay (shell_widget), XtWindow (shell_widget),
2607 attribute_mask, &attributes);
2609 XtMapWidget (frame_widget);
2611 /* x_set_name normally ignores requests to set the name if the
2612 requested name is the same as the current name. This is the one
2613 place where that assumption isn't correct; f->name is set, but
2614 the X server hasn't been told. */
2616 Lisp_Object name;
2617 int explicit = f->explicit_name;
2619 f->explicit_name = 0;
2620 name = f->name;
2621 f->name = Qnil;
2622 x_set_name (f, name, explicit);
2625 XDefineCursor (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2626 f->output_data.x->current_cursor
2627 = f->output_data.x->text_cursor);
2629 UNBLOCK_INPUT;
2631 /* This is a no-op, except under Motif. Make sure main areas are
2632 set to something reasonable, in case we get an error later. */
2633 lw_set_main_areas (pane_widget, 0, frame_widget);
2636 #else /* not USE_X_TOOLKIT */
2637 #ifdef USE_GTK
2638 void
2639 x_window (FRAME_PTR f)
2641 if (! xg_create_frame_widgets (f))
2642 error ("Unable to create window");
2644 #ifdef HAVE_X_I18N
2645 FRAME_XIC (f) = NULL;
2646 if (use_xim)
2648 BLOCK_INPUT;
2649 create_frame_xic (f);
2650 if (FRAME_XIC (f))
2652 /* XIM server might require some X events. */
2653 unsigned long fevent = NoEventMask;
2654 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2656 if (fevent != NoEventMask)
2658 XSetWindowAttributes attributes;
2659 XWindowAttributes wattr;
2660 unsigned long attribute_mask;
2662 XGetWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2663 &wattr);
2664 attributes.event_mask = wattr.your_event_mask | fevent;
2665 attribute_mask = CWEventMask;
2666 XChangeWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2667 attribute_mask, &attributes);
2670 UNBLOCK_INPUT;
2672 #endif
2675 #else /*! USE_GTK */
2676 /* Create and set up the X window for frame F. */
2678 void
2679 x_window (struct frame *f)
2681 XClassHint class_hints;
2682 XSetWindowAttributes attributes;
2683 unsigned long attribute_mask;
2685 attributes.background_pixel = FRAME_BACKGROUND_PIXEL (f);
2686 attributes.border_pixel = f->output_data.x->border_pixel;
2687 attributes.bit_gravity = StaticGravity;
2688 attributes.backing_store = NotUseful;
2689 attributes.save_under = True;
2690 attributes.event_mask = STANDARD_EVENT_SET;
2691 attributes.colormap = FRAME_X_COLORMAP (f);
2692 attribute_mask = (CWBackPixel | CWBorderPixel | CWBitGravity | CWEventMask
2693 | CWColormap);
2695 BLOCK_INPUT;
2696 FRAME_X_WINDOW (f)
2697 = XCreateWindow (FRAME_X_DISPLAY (f),
2698 f->output_data.x->parent_desc,
2699 f->left_pos,
2700 f->top_pos,
2701 FRAME_PIXEL_WIDTH (f), FRAME_PIXEL_HEIGHT (f),
2702 f->border_width,
2703 CopyFromParent, /* depth */
2704 InputOutput, /* class */
2705 FRAME_X_VISUAL (f),
2706 attribute_mask, &attributes);
2708 #ifdef HAVE_X_I18N
2709 if (use_xim)
2711 create_frame_xic (f);
2712 if (FRAME_XIC (f))
2714 /* XIM server might require some X events. */
2715 unsigned long fevent = NoEventMask;
2716 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2717 attributes.event_mask |= fevent;
2718 attribute_mask = CWEventMask;
2719 XChangeWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2720 attribute_mask, &attributes);
2723 #endif /* HAVE_X_I18N */
2725 validate_x_resource_name ();
2727 class_hints.res_name = (char *) SDATA (Vx_resource_name);
2728 class_hints.res_class = (char *) SDATA (Vx_resource_class);
2729 XSetClassHint (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), &class_hints);
2731 /* The menubar is part of the ordinary display;
2732 it does not count in addition to the height of the window. */
2733 f->output_data.x->menubar_height = 0;
2735 /* This indicates that we use the "Passive Input" input model.
2736 Unless we do this, we don't get the Focus{In,Out} events that we
2737 need to draw the cursor correctly. Accursed bureaucrats.
2738 XWhipsAndChains (FRAME_X_DISPLAY (f), IronMaiden, &TheRack); */
2740 f->output_data.x->wm_hints.input = True;
2741 f->output_data.x->wm_hints.flags |= InputHint;
2742 XSetWMHints (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2743 &f->output_data.x->wm_hints);
2744 f->output_data.x->wm_hints.icon_pixmap = None;
2746 /* Request "save yourself" and "delete window" commands from wm. */
2748 Atom protocols[2];
2749 protocols[0] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window;
2750 protocols[1] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself;
2751 XSetWMProtocols (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), protocols, 2);
2754 /* x_set_name normally ignores requests to set the name if the
2755 requested name is the same as the current name. This is the one
2756 place where that assumption isn't correct; f->name is set, but
2757 the X server hasn't been told. */
2759 Lisp_Object name;
2760 int explicit = f->explicit_name;
2762 f->explicit_name = 0;
2763 name = f->name;
2764 f->name = Qnil;
2765 x_set_name (f, name, explicit);
2768 XDefineCursor (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2769 f->output_data.x->current_cursor
2770 = f->output_data.x->text_cursor);
2772 UNBLOCK_INPUT;
2774 if (FRAME_X_WINDOW (f) == 0)
2775 error ("Unable to create window");
2778 #endif /* not USE_GTK */
2779 #endif /* not USE_X_TOOLKIT */
2781 /* Verify that the icon position args for this window are valid. */
2783 static void
2784 x_icon_verify (struct frame *f, Lisp_Object parms)
2786 Lisp_Object icon_x, icon_y;
2788 /* Set the position of the icon. Note that twm groups all
2789 icons in an icon window. */
2790 icon_x = x_frame_get_and_record_arg (f, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
2791 icon_y = x_frame_get_and_record_arg (f, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
2792 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
2794 CHECK_NUMBER (icon_x);
2795 CHECK_NUMBER (icon_y);
2797 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
2798 error ("Both left and top icon corners of icon must be specified");
2801 /* Handle the icon stuff for this window. Perhaps later we might
2802 want an x_set_icon_position which can be called interactively as
2803 well. */
2805 static void
2806 x_icon (struct frame *f, Lisp_Object parms)
2808 Lisp_Object icon_x, icon_y;
2809 #if 0
2810 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
2811 #endif
2813 /* Set the position of the icon. Note that twm groups all
2814 icons in an icon window. */
2815 icon_x = x_frame_get_and_record_arg (f, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
2816 icon_y = x_frame_get_and_record_arg (f, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
2817 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
2819 CHECK_NUMBER (icon_x);
2820 CHECK_NUMBER (icon_y);
2822 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
2823 error ("Both left and top icon corners of icon must be specified");
2825 BLOCK_INPUT;
2827 if (! EQ (icon_x, Qunbound))
2828 x_wm_set_icon_position (f, XINT (icon_x), XINT (icon_y));
2830 #if 0 /* x_get_arg removes the visibility parameter as a side effect,
2831 but x_create_frame still needs it. */
2832 /* Start up iconic or window? */
2833 x_wm_set_window_state
2834 (f, (EQ (x_get_arg (dpyinfo, parms, Qvisibility, 0, 0, RES_TYPE_SYMBOL),
2835 Qicon)
2836 ? IconicState
2837 : NormalState));
2838 #endif
2840 x_text_icon (f, (char *) SDATA ((!NILP (f->icon_name)
2841 ? f->icon_name
2842 : f->name)));
2844 UNBLOCK_INPUT;
2847 /* Make the GCs needed for this window, setting the
2848 background, border and mouse colors; also create the
2849 mouse cursor and the gray border tile. */
2851 static void
2852 x_make_gc (struct frame *f)
2854 XGCValues gc_values;
2856 BLOCK_INPUT;
2858 /* Create the GCs of this frame.
2859 Note that many default values are used. */
2861 gc_values.foreground = FRAME_FOREGROUND_PIXEL (f);
2862 gc_values.background = FRAME_BACKGROUND_PIXEL (f);
2863 gc_values.line_width = 0; /* Means 1 using fast algorithm. */
2864 f->output_data.x->normal_gc
2865 = XCreateGC (FRAME_X_DISPLAY (f),
2866 FRAME_X_WINDOW (f),
2867 GCLineWidth | GCForeground | GCBackground,
2868 &gc_values);
2870 /* Reverse video style. */
2871 gc_values.foreground = FRAME_BACKGROUND_PIXEL (f);
2872 gc_values.background = FRAME_FOREGROUND_PIXEL (f);
2873 f->output_data.x->reverse_gc
2874 = XCreateGC (FRAME_X_DISPLAY (f),
2875 FRAME_X_WINDOW (f),
2876 GCForeground | GCBackground | GCLineWidth,
2877 &gc_values);
2879 /* Cursor has cursor-color background, background-color foreground. */
2880 gc_values.foreground = FRAME_BACKGROUND_PIXEL (f);
2881 gc_values.background = f->output_data.x->cursor_pixel;
2882 gc_values.fill_style = FillOpaqueStippled;
2883 f->output_data.x->cursor_gc
2884 = XCreateGC (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2885 (GCForeground | GCBackground
2886 | GCFillStyle | GCLineWidth),
2887 &gc_values);
2889 /* Reliefs. */
2890 f->output_data.x->white_relief.gc = 0;
2891 f->output_data.x->black_relief.gc = 0;
2893 /* Create the gray border tile used when the pointer is not in
2894 the frame. Since this depends on the frame's pixel values,
2895 this must be done on a per-frame basis. */
2896 f->output_data.x->border_tile
2897 = (XCreatePixmapFromBitmapData
2898 (FRAME_X_DISPLAY (f), FRAME_X_DISPLAY_INFO (f)->root_window,
2899 gray_bits, gray_width, gray_height,
2900 FRAME_FOREGROUND_PIXEL (f),
2901 FRAME_BACKGROUND_PIXEL (f),
2902 DefaultDepth (FRAME_X_DISPLAY (f), FRAME_X_SCREEN_NUMBER (f))));
2904 UNBLOCK_INPUT;
2908 /* Free what was allocated in x_make_gc. */
2910 void
2911 x_free_gcs (struct frame *f)
2913 Display *dpy = FRAME_X_DISPLAY (f);
2915 BLOCK_INPUT;
2917 if (f->output_data.x->normal_gc)
2919 XFreeGC (dpy, f->output_data.x->normal_gc);
2920 f->output_data.x->normal_gc = 0;
2923 if (f->output_data.x->reverse_gc)
2925 XFreeGC (dpy, f->output_data.x->reverse_gc);
2926 f->output_data.x->reverse_gc = 0;
2929 if (f->output_data.x->cursor_gc)
2931 XFreeGC (dpy, f->output_data.x->cursor_gc);
2932 f->output_data.x->cursor_gc = 0;
2935 if (f->output_data.x->border_tile)
2937 XFreePixmap (dpy, f->output_data.x->border_tile);
2938 f->output_data.x->border_tile = 0;
2941 UNBLOCK_INPUT;
2945 /* Handler for signals raised during x_create_frame and
2946 x_create_top_frame. FRAME is the frame which is partially
2947 constructed. */
2949 static Lisp_Object
2950 unwind_create_frame (Lisp_Object frame)
2952 struct frame *f = XFRAME (frame);
2954 /* If frame is already dead, nothing to do. This can happen if the
2955 display is disconnected after the frame has become official, but
2956 before x_create_frame removes the unwind protect. */
2957 if (!FRAME_LIVE_P (f))
2958 return Qnil;
2960 /* If frame is ``official'', nothing to do. */
2961 if (!CONSP (Vframe_list) || !EQ (XCAR (Vframe_list), frame))
2963 #if GLYPH_DEBUG
2964 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
2965 #endif
2967 x_free_frame_resources (f);
2969 #if GLYPH_DEBUG
2970 /* Check that reference counts are indeed correct. */
2971 xassert (dpyinfo->reference_count == dpyinfo_refcount);
2972 xassert (dpyinfo->image_cache->refcount == image_cache_refcount);
2973 #endif
2974 return Qt;
2977 return Qnil;
2981 static void
2982 x_default_font_parameter (struct frame *f, Lisp_Object parms)
2984 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
2985 Lisp_Object font_param = x_get_arg (dpyinfo, parms, Qfont, NULL, NULL,
2986 RES_TYPE_STRING);
2987 Lisp_Object font = Qnil;
2988 if (EQ (font_param, Qunbound))
2989 font_param = Qnil;
2991 if (NILP (font_param))
2993 /* System font should take precedendce over X resources. We suggest this
2994 regardless of font-use-system-font because .emacs may not have been
2995 read yet. */
2996 const char *system_font = xsettings_get_system_font ();
2997 if (system_font)
2999 char *name = xstrdup (system_font);
3000 font = font_open_by_name (f, name);
3001 free (name);
3005 if (NILP (font))
3006 font = !NILP (font_param) ? font_param
3007 : x_get_arg (dpyinfo, parms, Qfont, "font", "Font", RES_TYPE_STRING);
3009 if (! FONTP (font) && ! STRINGP (font))
3011 char *names[]
3013 #ifdef HAVE_XFT
3014 /* This will find the normal Xft font. */
3015 "monospace-10",
3016 #endif
3017 "-adobe-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-1",
3018 "-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-1",
3019 "-*-*-medium-r-normal-*-*-140-*-*-c-*-iso8859-1",
3020 /* This was formerly the first thing tried, but it finds
3021 too many fonts and takes too long. */
3022 "-*-*-medium-r-*-*-*-*-*-*-c-*-iso8859-1",
3023 /* If those didn't work, look for something which will
3024 at least work. */
3025 "-*-fixed-*-*-*-*-*-140-*-*-c-*-iso8859-1",
3026 "fixed",
3027 NULL };
3028 int i;
3030 for (i = 0; names[i]; i++)
3032 font = font_open_by_name (f, names[i]);
3033 if (! NILP (font))
3034 break;
3036 if (NILP (font))
3037 error ("No suitable font was found");
3039 else if (!NILP (font_param))
3041 /* Remember the explicit font parameter, so we can re-apply it after
3042 we've applied the `default' face settings. */
3043 x_set_frame_parameters (f, Fcons (Fcons (Qfont_param, font_param), Qnil));
3046 /* This call will make X resources override any system font setting. */
3047 x_default_parameter (f, parms, Qfont, font, "font", "Font", RES_TYPE_STRING);
3051 DEFUN ("x-wm-set-size-hint", Fx_wm_set_size_hint, Sx_wm_set_size_hint,
3052 0, 1, 0,
3053 doc: /* Send the size hints for frame FRAME to the window manager.
3054 If FRAME is nil, use the selected frame. */)
3055 (Lisp_Object frame)
3057 struct frame *f;
3058 if (NILP (frame))
3059 frame = selected_frame;
3060 f = XFRAME (frame);
3061 BLOCK_INPUT;
3062 if (FRAME_X_P (f))
3063 x_wm_set_size_hint (f, 0, 0);
3064 UNBLOCK_INPUT;
3065 return Qnil;
3068 static void
3069 set_machine_and_pid_properties (struct frame *f)
3071 /* See the above comment "Note: Encoding strategy". */
3072 XTextProperty text;
3073 int bytes, stringp;
3074 int do_free_text_value = 0;
3075 long pid = (long) getpid ();
3077 text.value = x_encode_text (Vsystem_name,
3078 Qcompound_text, 0, &bytes, &stringp,
3079 &do_free_text_value);
3080 text.encoding = (stringp ? XA_STRING
3081 : FRAME_X_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
3082 text.format = 8;
3083 text.nitems = bytes;
3084 XSetWMClientMachine (FRAME_X_DISPLAY (f),
3085 FRAME_OUTER_WINDOW (f),
3086 &text);
3087 if (do_free_text_value)
3088 xfree (text.value);
3090 XChangeProperty (FRAME_X_DISPLAY (f),
3091 FRAME_OUTER_WINDOW (f),
3092 XInternAtom (FRAME_X_DISPLAY (f),
3093 "_NET_WM_PID",
3094 False),
3095 XA_CARDINAL, 32, PropModeReplace,
3096 (unsigned char *) &pid, 1);
3099 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
3100 1, 1, 0,
3101 doc: /* Make a new X window, which is called a "frame" in Emacs terms.
3102 Return an Emacs frame object.
3103 PARMS is an alist of frame parameters.
3104 If the parameters specify that the frame should not have a minibuffer,
3105 and do not specify a specific minibuffer window to use,
3106 then `default-minibuffer-frame' must be a frame whose minibuffer can
3107 be shared by the new frame.
3109 This function is an internal primitive--use `make-frame' instead. */)
3110 (Lisp_Object parms)
3112 struct frame *f;
3113 Lisp_Object frame, tem;
3114 Lisp_Object name;
3115 int minibuffer_only = 0;
3116 long window_prompting = 0;
3117 int width, height;
3118 int count = SPECPDL_INDEX ();
3119 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
3120 Lisp_Object display;
3121 struct x_display_info *dpyinfo = NULL;
3122 Lisp_Object parent;
3123 struct kboard *kb;
3125 parms = Fcopy_alist (parms);
3127 /* Use this general default value to start with
3128 until we know if this frame has a specified name. */
3129 Vx_resource_name = Vinvocation_name;
3131 display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_NUMBER);
3132 if (EQ (display, Qunbound))
3133 display = x_get_arg (dpyinfo, parms, Qdisplay, 0, 0, RES_TYPE_STRING);
3134 if (EQ (display, Qunbound))
3135 display = Qnil;
3136 dpyinfo = check_x_display_info (display);
3137 kb = dpyinfo->terminal->kboard;
3139 if (!dpyinfo->terminal->name)
3140 error ("Terminal is not live, can't create new frames on it");
3142 name = x_get_arg (dpyinfo, parms, Qname, "name", "Name", RES_TYPE_STRING);
3143 if (!STRINGP (name)
3144 && ! EQ (name, Qunbound)
3145 && ! NILP (name))
3146 error ("Invalid frame name--not a string or nil");
3148 if (STRINGP (name))
3149 Vx_resource_name = name;
3151 /* See if parent window is specified. */
3152 parent = x_get_arg (dpyinfo, parms, Qparent_id, NULL, NULL, RES_TYPE_NUMBER);
3153 if (EQ (parent, Qunbound))
3154 parent = Qnil;
3155 if (! NILP (parent))
3156 CHECK_NUMBER (parent);
3158 /* make_frame_without_minibuffer can run Lisp code and garbage collect. */
3159 /* No need to protect DISPLAY because that's not used after passing
3160 it to make_frame_without_minibuffer. */
3161 frame = Qnil;
3162 GCPRO4 (parms, parent, name, frame);
3163 tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
3164 RES_TYPE_SYMBOL);
3165 if (EQ (tem, Qnone) || NILP (tem))
3166 f = make_frame_without_minibuffer (Qnil, kb, display);
3167 else if (EQ (tem, Qonly))
3169 f = make_minibuffer_frame ();
3170 minibuffer_only = 1;
3172 else if (WINDOWP (tem))
3173 f = make_frame_without_minibuffer (tem, kb, display);
3174 else
3175 f = make_frame (1);
3177 XSETFRAME (frame, f);
3179 /* Note that X Windows does support scroll bars. */
3180 FRAME_CAN_HAVE_SCROLL_BARS (f) = 1;
3182 f->terminal = dpyinfo->terminal;
3183 f->terminal->reference_count++;
3185 f->output_method = output_x_window;
3186 f->output_data.x = (struct x_output *) xmalloc (sizeof (struct x_output));
3187 memset (f->output_data.x, 0, sizeof (struct x_output));
3188 f->output_data.x->icon_bitmap = -1;
3189 FRAME_FONTSET (f) = -1;
3190 f->output_data.x->scroll_bar_foreground_pixel = -1;
3191 f->output_data.x->scroll_bar_background_pixel = -1;
3192 #ifdef USE_TOOLKIT_SCROLL_BARS
3193 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
3194 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
3195 #endif /* USE_TOOLKIT_SCROLL_BARS */
3197 f->icon_name
3198 = x_get_arg (dpyinfo, parms, Qicon_name, "iconName", "Title",
3199 RES_TYPE_STRING);
3200 if (! STRINGP (f->icon_name))
3201 f->icon_name = Qnil;
3203 FRAME_X_DISPLAY_INFO (f) = dpyinfo;
3205 /* With FRAME_X_DISPLAY_INFO set up, this unwind-protect is safe. */
3206 record_unwind_protect (unwind_create_frame, frame);
3207 #if GLYPH_DEBUG
3208 image_cache_refcount = FRAME_IMAGE_CACHE (f)->refcount;
3209 dpyinfo_refcount = dpyinfo->reference_count;
3210 #endif /* GLYPH_DEBUG */
3212 /* These colors will be set anyway later, but it's important
3213 to get the color reference counts right, so initialize them! */
3215 Lisp_Object black;
3216 struct gcpro gcpro1;
3218 /* Function x_decode_color can signal an error. Make
3219 sure to initialize color slots so that we won't try
3220 to free colors we haven't allocated. */
3221 FRAME_FOREGROUND_PIXEL (f) = -1;
3222 FRAME_BACKGROUND_PIXEL (f) = -1;
3223 f->output_data.x->cursor_pixel = -1;
3224 f->output_data.x->cursor_foreground_pixel = -1;
3225 f->output_data.x->border_pixel = -1;
3226 f->output_data.x->mouse_pixel = -1;
3228 black = build_string ("black");
3229 GCPRO1 (black);
3230 FRAME_FOREGROUND_PIXEL (f)
3231 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3232 FRAME_BACKGROUND_PIXEL (f)
3233 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3234 f->output_data.x->cursor_pixel
3235 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3236 f->output_data.x->cursor_foreground_pixel
3237 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3238 f->output_data.x->border_pixel
3239 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3240 f->output_data.x->mouse_pixel
3241 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3242 UNGCPRO;
3245 /* Specify the parent under which to make this X window. */
3247 if (!NILP (parent))
3249 f->output_data.x->parent_desc = (Window) XFASTINT (parent);
3250 f->output_data.x->explicit_parent = 1;
3252 else
3254 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
3255 f->output_data.x->explicit_parent = 0;
3258 /* Set the name; the functions to which we pass f expect the name to
3259 be set. */
3260 if (EQ (name, Qunbound) || NILP (name))
3262 f->name = build_string (dpyinfo->x_id_name);
3263 f->explicit_name = 0;
3265 else
3267 f->name = name;
3268 f->explicit_name = 1;
3269 /* use the frame's title when getting resources for this frame. */
3270 specbind (Qx_resource_name, name);
3273 f->resx = dpyinfo->resx;
3274 f->resy = dpyinfo->resy;
3276 #ifdef HAVE_FREETYPE
3277 #ifdef HAVE_XFT
3278 register_font_driver (&xftfont_driver, f);
3279 #else /* not HAVE_XFT */
3280 register_font_driver (&ftxfont_driver, f);
3281 #endif /* not HAVE_XFT */
3282 #endif /* HAVE_FREETYPE */
3283 register_font_driver (&xfont_driver, f);
3285 x_default_parameter (f, parms, Qfont_backend, Qnil,
3286 "fontBackend", "FontBackend", RES_TYPE_STRING);
3288 /* Extract the window parameters from the supplied values
3289 that are needed to determine window geometry. */
3290 x_default_font_parameter (f, parms);
3291 if (!FRAME_FONT (f))
3293 delete_frame (frame, Qnoelisp);
3294 error ("Invalid frame font");
3297 /* Frame contents get displaced if an embedded X window has a border. */
3298 if (! FRAME_X_EMBEDDED_P (f))
3299 x_default_parameter (f, parms, Qborder_width, make_number (0),
3300 "borderWidth", "BorderWidth", RES_TYPE_NUMBER);
3302 /* This defaults to 1 in order to match xterm. We recognize either
3303 internalBorderWidth or internalBorder (which is what xterm calls
3304 it). */
3305 if (NILP (Fassq (Qinternal_border_width, parms)))
3307 Lisp_Object value;
3309 value = x_get_arg (dpyinfo, parms, Qinternal_border_width,
3310 "internalBorder", "internalBorder", RES_TYPE_NUMBER);
3311 if (! EQ (value, Qunbound))
3312 parms = Fcons (Fcons (Qinternal_border_width, value),
3313 parms);
3315 x_default_parameter (f, parms, Qinternal_border_width,
3316 #ifdef USE_GTK /* We used to impose 0 in xg_create_frame_widgets. */
3317 make_number (0),
3318 #else
3319 make_number (1),
3320 #endif
3321 "internalBorderWidth", "internalBorderWidth",
3322 RES_TYPE_NUMBER);
3323 x_default_parameter (f, parms, Qvertical_scroll_bars,
3324 #if defined(USE_GTK) && defined(USE_TOOLKIT_SCROLL_BARS)
3325 Qright,
3326 #else
3327 Qleft,
3328 #endif
3329 "verticalScrollBars", "ScrollBars",
3330 RES_TYPE_SYMBOL);
3332 /* Also do the stuff which must be set before the window exists. */
3333 x_default_parameter (f, parms, Qforeground_color, build_string ("black"),
3334 "foreground", "Foreground", RES_TYPE_STRING);
3335 x_default_parameter (f, parms, Qbackground_color, build_string ("white"),
3336 "background", "Background", RES_TYPE_STRING);
3337 x_default_parameter (f, parms, Qmouse_color, build_string ("black"),
3338 "pointerColor", "Foreground", RES_TYPE_STRING);
3339 x_default_parameter (f, parms, Qcursor_color, build_string ("black"),
3340 "cursorColor", "Foreground", RES_TYPE_STRING);
3341 x_default_parameter (f, parms, Qborder_color, build_string ("black"),
3342 "borderColor", "BorderColor", RES_TYPE_STRING);
3343 x_default_parameter (f, parms, Qscreen_gamma, Qnil,
3344 "screenGamma", "ScreenGamma", RES_TYPE_FLOAT);
3345 x_default_parameter (f, parms, Qline_spacing, Qnil,
3346 "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
3347 x_default_parameter (f, parms, Qleft_fringe, Qnil,
3348 "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
3349 x_default_parameter (f, parms, Qright_fringe, Qnil,
3350 "rightFringe", "RightFringe", RES_TYPE_NUMBER);
3352 x_default_scroll_bar_color_parameter (f, parms, Qscroll_bar_foreground,
3353 "scrollBarForeground",
3354 "ScrollBarForeground", 1);
3355 x_default_scroll_bar_color_parameter (f, parms, Qscroll_bar_background,
3356 "scrollBarBackground",
3357 "ScrollBarBackground", 0);
3359 /* Init faces before x_default_parameter is called for scroll-bar
3360 parameters because that function calls x_set_scroll_bar_width,
3361 which calls change_frame_size, which calls Fset_window_buffer,
3362 which runs hooks, which call Fvertical_motion. At the end, we
3363 end up in init_iterator with a null face cache, which should not
3364 happen. */
3365 init_frame_faces (f);
3367 /* The X resources controlling the menu-bar and tool-bar are
3368 processed specially at startup, and reflected in the mode
3369 variables; ignore them here. */
3370 x_default_parameter (f, parms, Qmenu_bar_lines,
3371 NILP (Vmenu_bar_mode)
3372 ? make_number (0) : make_number (1),
3373 NULL, NULL, RES_TYPE_NUMBER);
3374 x_default_parameter (f, parms, Qtool_bar_lines,
3375 NILP (Vtool_bar_mode)
3376 ? make_number (0) : make_number (1),
3377 NULL, NULL, RES_TYPE_NUMBER);
3379 x_default_parameter (f, parms, Qbuffer_predicate, Qnil,
3380 "bufferPredicate", "BufferPredicate",
3381 RES_TYPE_SYMBOL);
3382 x_default_parameter (f, parms, Qtitle, Qnil,
3383 "title", "Title", RES_TYPE_STRING);
3384 x_default_parameter (f, parms, Qwait_for_wm, Qt,
3385 "waitForWM", "WaitForWM", RES_TYPE_BOOLEAN);
3386 x_default_parameter (f, parms, Qfullscreen, Qnil,
3387 "fullscreen", "Fullscreen", RES_TYPE_SYMBOL);
3389 /* Compute the size of the X window. */
3390 window_prompting = x_figure_window_size (f, parms, 1);
3392 tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
3393 f->no_split = minibuffer_only || EQ (tem, Qt);
3395 x_icon_verify (f, parms);
3397 /* Create the X widget or window. */
3398 #ifdef USE_X_TOOLKIT
3399 x_window (f, window_prompting, minibuffer_only);
3400 #else
3401 x_window (f);
3402 #endif
3404 x_icon (f, parms);
3405 x_make_gc (f);
3407 /* Now consider the frame official. */
3408 FRAME_X_DISPLAY_INFO (f)->reference_count++;
3409 Vframe_list = Fcons (frame, Vframe_list);
3411 /* We need to do this after creating the X window, so that the
3412 icon-creation functions can say whose icon they're describing. */
3413 x_default_parameter (f, parms, Qicon_type, Qt,
3414 "bitmapIcon", "BitmapIcon", RES_TYPE_SYMBOL);
3416 x_default_parameter (f, parms, Qauto_raise, Qnil,
3417 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
3418 x_default_parameter (f, parms, Qauto_lower, Qnil,
3419 "autoLower", "AutoRaiseLower", RES_TYPE_BOOLEAN);
3420 x_default_parameter (f, parms, Qcursor_type, Qbox,
3421 "cursorType", "CursorType", RES_TYPE_SYMBOL);
3422 x_default_parameter (f, parms, Qscroll_bar_width, Qnil,
3423 "scrollBarWidth", "ScrollBarWidth",
3424 RES_TYPE_NUMBER);
3425 x_default_parameter (f, parms, Qalpha, Qnil,
3426 "alpha", "Alpha", RES_TYPE_NUMBER);
3428 /* Dimensions, especially FRAME_LINES (f), must be done via change_frame_size.
3429 Change will not be effected unless different from the current
3430 FRAME_LINES (f). */
3431 width = FRAME_COLS (f);
3432 height = FRAME_LINES (f);
3434 SET_FRAME_COLS (f, 0);
3435 FRAME_LINES (f) = 0;
3436 change_frame_size (f, height, width, 1, 0, 0);
3438 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
3439 /* Create the menu bar. */
3440 if (!minibuffer_only && FRAME_EXTERNAL_MENU_BAR (f))
3442 /* If this signals an error, we haven't set size hints for the
3443 frame and we didn't make it visible. */
3444 initialize_frame_menubar (f);
3446 #ifndef USE_GTK
3447 /* This is a no-op, except under Motif where it arranges the
3448 main window for the widgets on it. */
3449 lw_set_main_areas (f->output_data.x->column_widget,
3450 f->output_data.x->menubar_widget,
3451 f->output_data.x->edit_widget);
3452 #endif /* not USE_GTK */
3454 #endif /* USE_X_TOOLKIT || USE_GTK */
3456 /* Tell the server what size and position, etc, we want, and how
3457 badly we want them. This should be done after we have the menu
3458 bar so that its size can be taken into account. */
3459 BLOCK_INPUT;
3460 x_wm_set_size_hint (f, window_prompting, 0);
3461 UNBLOCK_INPUT;
3463 /* Make the window appear on the frame and enable display, unless
3464 the caller says not to. However, with explicit parent, Emacs
3465 cannot control visibility, so don't try. */
3466 if (! f->output_data.x->explicit_parent)
3468 Lisp_Object visibility;
3470 visibility = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0,
3471 RES_TYPE_SYMBOL);
3472 if (EQ (visibility, Qunbound))
3473 visibility = Qt;
3475 if (EQ (visibility, Qicon))
3476 x_iconify_frame (f);
3477 else if (! NILP (visibility))
3478 x_make_frame_visible (f);
3479 else
3480 /* Must have been Qnil. */
3484 BLOCK_INPUT;
3486 /* Set machine name and pid for the purpose of window managers. */
3487 set_machine_and_pid_properties(f);
3489 /* Set the WM leader property. GTK does this itself, so this is not
3490 needed when using GTK. */
3491 if (dpyinfo->client_leader_window != 0)
3493 XChangeProperty (FRAME_X_DISPLAY (f),
3494 FRAME_OUTER_WINDOW (f),
3495 dpyinfo->Xatom_wm_client_leader,
3496 XA_WINDOW, 32, PropModeReplace,
3497 (unsigned char *) &dpyinfo->client_leader_window, 1);
3500 UNBLOCK_INPUT;
3502 /* Initialize `default-minibuffer-frame' in case this is the first
3503 frame on this terminal. */
3504 if (FRAME_HAS_MINIBUF_P (f)
3505 && (!FRAMEP (kb->Vdefault_minibuffer_frame)
3506 || !FRAME_LIVE_P (XFRAME (kb->Vdefault_minibuffer_frame))))
3507 kb->Vdefault_minibuffer_frame = frame;
3509 /* All remaining specified parameters, which have not been "used"
3510 by x_get_arg and friends, now go in the misc. alist of the frame. */
3511 for (tem = parms; CONSP (tem); tem = XCDR (tem))
3512 if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
3513 f->param_alist = Fcons (XCAR (tem), f->param_alist);
3515 UNGCPRO;
3517 /* Make sure windows on this frame appear in calls to next-window
3518 and similar functions. */
3519 Vwindow_list = Qnil;
3521 return unbind_to (count, frame);
3525 /* FRAME is used only to get a handle on the X display. We don't pass the
3526 display info directly because we're called from frame.c, which doesn't
3527 know about that structure. */
3529 Lisp_Object
3530 x_get_focus_frame (struct frame *frame)
3532 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (frame);
3533 Lisp_Object xfocus;
3534 if (! dpyinfo->x_focus_frame)
3535 return Qnil;
3537 XSETFRAME (xfocus, dpyinfo->x_focus_frame);
3538 return xfocus;
3542 /* In certain situations, when the window manager follows a
3543 click-to-focus policy, there seems to be no way around calling
3544 XSetInputFocus to give another frame the input focus .
3546 In an ideal world, XSetInputFocus should generally be avoided so
3547 that applications don't interfere with the window manager's focus
3548 policy. But I think it's okay to use when it's clearly done
3549 following a user-command. */
3551 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
3552 doc: /* Set the input focus to FRAME.
3553 FRAME nil means use the selected frame. */)
3554 (Lisp_Object frame)
3556 struct frame *f = check_x_frame (frame);
3557 Display *dpy = FRAME_X_DISPLAY (f);
3559 BLOCK_INPUT;
3560 x_catch_errors (dpy);
3561 XSetInputFocus (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
3562 RevertToParent, CurrentTime);
3563 x_ewmh_activate_frame (f);
3564 x_uncatch_errors ();
3565 UNBLOCK_INPUT;
3567 return Qnil;
3571 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
3572 doc: /* Internal function called by `color-defined-p', which see. */)
3573 (Lisp_Object color, Lisp_Object frame)
3575 XColor foo;
3576 FRAME_PTR f = check_x_frame (frame);
3578 CHECK_STRING (color);
3580 if (x_defined_color (f, SDATA (color), &foo, 0))
3581 return Qt;
3582 else
3583 return Qnil;
3586 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
3587 doc: /* Internal function called by `color-values', which see. */)
3588 (Lisp_Object color, Lisp_Object frame)
3590 XColor foo;
3591 FRAME_PTR f = check_x_frame (frame);
3593 CHECK_STRING (color);
3595 if (x_defined_color (f, SDATA (color), &foo, 0))
3596 return list3 (make_number (foo.red),
3597 make_number (foo.green),
3598 make_number (foo.blue));
3599 else
3600 return Qnil;
3603 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
3604 doc: /* Internal function called by `display-color-p', which see. */)
3605 (Lisp_Object terminal)
3607 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3609 if (dpyinfo->n_planes <= 2)
3610 return Qnil;
3612 switch (dpyinfo->visual->class)
3614 case StaticColor:
3615 case PseudoColor:
3616 case TrueColor:
3617 case DirectColor:
3618 return Qt;
3620 default:
3621 return Qnil;
3625 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p, Sx_display_grayscale_p,
3626 0, 1, 0,
3627 doc: /* Return t if the X display supports shades of gray.
3628 Note that color displays do support shades of gray.
3629 The optional argument TERMINAL specifies which display to ask about.
3630 TERMINAL should be a terminal object, a frame or a display name (a string).
3631 If omitted or nil, that stands for the selected frame's display. */)
3632 (Lisp_Object terminal)
3634 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3636 if (dpyinfo->n_planes <= 1)
3637 return Qnil;
3639 switch (dpyinfo->visual->class)
3641 case StaticColor:
3642 case PseudoColor:
3643 case TrueColor:
3644 case DirectColor:
3645 case StaticGray:
3646 case GrayScale:
3647 return Qt;
3649 default:
3650 return Qnil;
3654 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
3655 0, 1, 0,
3656 doc: /* Return the width in pixels of the X display TERMINAL.
3657 The optional argument TERMINAL specifies which display to ask about.
3658 TERMINAL should be a terminal object, a frame or a display name (a string).
3659 If omitted or nil, that stands for the selected frame's display. */)
3660 (Lisp_Object terminal)
3662 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3664 return make_number (x_display_pixel_width (dpyinfo));
3667 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
3668 Sx_display_pixel_height, 0, 1, 0,
3669 doc: /* Return the height in pixels of the X display TERMINAL.
3670 The optional argument TERMINAL specifies which display to ask about.
3671 TERMINAL should be a terminal object, a frame or a display name (a string).
3672 If omitted or nil, that stands for the selected frame's display. */)
3673 (Lisp_Object terminal)
3675 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3677 return make_number (x_display_pixel_height (dpyinfo));
3680 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
3681 0, 1, 0,
3682 doc: /* Return the number of bitplanes of the X display TERMINAL.
3683 The optional argument TERMINAL specifies which display to ask about.
3684 TERMINAL should be a terminal object, a frame or a display name (a string).
3685 If omitted or nil, that stands for the selected frame's display. */)
3686 (Lisp_Object terminal)
3688 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3690 return make_number (dpyinfo->n_planes);
3693 DEFUN ("x-display-color-cells", Fx_display_color_cells, Sx_display_color_cells,
3694 0, 1, 0,
3695 doc: /* Return the number of color cells of the X display TERMINAL.
3696 The optional argument TERMINAL specifies which display to ask about.
3697 TERMINAL should be a terminal object, a frame or a display name (a string).
3698 If omitted or nil, that stands for the selected frame's display. */)
3699 (Lisp_Object terminal)
3701 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3703 int nr_planes = DisplayPlanes (dpyinfo->display,
3704 XScreenNumberOfScreen (dpyinfo->screen));
3706 /* Truncate nr_planes to 24 to avoid integer overflow.
3707 Some displays says 32, but only 24 bits are actually significant.
3708 There are only very few and rare video cards that have more than
3709 24 significant bits. Also 24 bits is more than 16 million colors,
3710 it "should be enough for everyone". */
3711 if (nr_planes > 24) nr_planes = 24;
3713 return make_number (1 << nr_planes);
3716 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
3717 Sx_server_max_request_size,
3718 0, 1, 0,
3719 doc: /* Return the maximum request size of the X server of display TERMINAL.
3720 The optional argument TERMINAL specifies which display to ask about.
3721 TERMINAL should be a terminal object, a frame or a display name (a string).
3722 If omitted or nil, that stands for the selected frame's display. */)
3723 (Lisp_Object terminal)
3725 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3727 return make_number (MAXREQUEST (dpyinfo->display));
3730 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
3731 doc: /* Return the "vendor ID" string of the X server of display TERMINAL.
3732 \(Labelling every distributor as a "vendor" embodies the false assumption
3733 that operating systems cannot be developed and distributed noncommercially.)
3734 The optional argument TERMINAL specifies which display to ask about.
3735 TERMINAL should be a terminal object, a frame or a display name (a string).
3736 If omitted or nil, that stands for the selected frame's display. */)
3737 (Lisp_Object terminal)
3739 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3740 char *vendor = ServerVendor (dpyinfo->display);
3742 if (! vendor) vendor = "";
3743 return build_string (vendor);
3746 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
3747 doc: /* Return the version numbers of the X server of display TERMINAL.
3748 The value is a list of three integers: the major and minor
3749 version numbers of the X Protocol in use, and the distributor-specific release
3750 number. See also the function `x-server-vendor'.
3752 The optional argument TERMINAL specifies which display to ask about.
3753 TERMINAL should be a terminal object, a frame or a display name (a string).
3754 If omitted or nil, that stands for the selected frame's display. */)
3755 (Lisp_Object terminal)
3757 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3758 Display *dpy = dpyinfo->display;
3760 return Fcons (make_number (ProtocolVersion (dpy)),
3761 Fcons (make_number (ProtocolRevision (dpy)),
3762 Fcons (make_number (VendorRelease (dpy)), Qnil)));
3765 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
3766 doc: /* Return the number of screens on the X server of display TERMINAL.
3767 The optional argument TERMINAL specifies which display to ask about.
3768 TERMINAL should be a terminal object, a frame or a display name (a string).
3769 If omitted or nil, that stands for the selected frame's display. */)
3770 (Lisp_Object terminal)
3772 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3774 return make_number (ScreenCount (dpyinfo->display));
3777 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height, 0, 1, 0,
3778 doc: /* Return the height in millimeters of the X display TERMINAL.
3779 The optional argument TERMINAL specifies which display to ask about.
3780 TERMINAL should be a terminal object, a frame or a display name (a string).
3781 If omitted or nil, that stands for the selected frame's display. */)
3782 (Lisp_Object terminal)
3784 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3786 return make_number (HeightMMOfScreen (dpyinfo->screen));
3789 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width, 0, 1, 0,
3790 doc: /* Return the width in millimeters of the X display TERMINAL.
3791 The optional argument TERMINAL specifies which display to ask about.
3792 TERMINAL should be a terminal object, a frame or a display name (a string).
3793 If omitted or nil, that stands for the selected frame's display. */)
3794 (Lisp_Object terminal)
3796 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3798 return make_number (WidthMMOfScreen (dpyinfo->screen));
3801 DEFUN ("x-display-backing-store", Fx_display_backing_store,
3802 Sx_display_backing_store, 0, 1, 0,
3803 doc: /* Return an indication of whether X display TERMINAL does backing store.
3804 The value may be `always', `when-mapped', or `not-useful'.
3805 The optional argument TERMINAL specifies which display to ask about.
3806 TERMINAL should be a terminal object, a frame or a display name (a string).
3807 If omitted or nil, that stands for the selected frame's display. */)
3808 (Lisp_Object terminal)
3810 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3811 Lisp_Object result;
3813 switch (DoesBackingStore (dpyinfo->screen))
3815 case Always:
3816 result = intern ("always");
3817 break;
3819 case WhenMapped:
3820 result = intern ("when-mapped");
3821 break;
3823 case NotUseful:
3824 result = intern ("not-useful");
3825 break;
3827 default:
3828 error ("Strange value for BackingStore parameter of screen");
3829 result = Qnil;
3832 return result;
3835 DEFUN ("x-display-visual-class", Fx_display_visual_class,
3836 Sx_display_visual_class, 0, 1, 0,
3837 doc: /* Return the visual class of the X display TERMINAL.
3838 The value is one of the symbols `static-gray', `gray-scale',
3839 `static-color', `pseudo-color', `true-color', or `direct-color'.
3841 The optional argument TERMINAL specifies which display to ask about.
3842 TERMINAL should a terminal object, a frame or a display name (a string).
3843 If omitted or nil, that stands for the selected frame's display. */)
3844 (Lisp_Object terminal)
3846 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3847 Lisp_Object result;
3849 switch (dpyinfo->visual->class)
3851 case StaticGray:
3852 result = intern ("static-gray");
3853 break;
3854 case GrayScale:
3855 result = intern ("gray-scale");
3856 break;
3857 case StaticColor:
3858 result = intern ("static-color");
3859 break;
3860 case PseudoColor:
3861 result = intern ("pseudo-color");
3862 break;
3863 case TrueColor:
3864 result = intern ("true-color");
3865 break;
3866 case DirectColor:
3867 result = intern ("direct-color");
3868 break;
3869 default:
3870 error ("Display has an unknown visual class");
3871 result = Qnil;
3874 return result;
3877 DEFUN ("x-display-save-under", Fx_display_save_under,
3878 Sx_display_save_under, 0, 1, 0,
3879 doc: /* Return t if the X display TERMINAL supports the save-under feature.
3880 The optional argument TERMINAL specifies which display to ask about.
3881 TERMINAL should be a terminal object, a frame or a display name (a string).
3882 If omitted or nil, that stands for the selected frame's display. */)
3883 (Lisp_Object terminal)
3885 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3887 if (DoesSaveUnders (dpyinfo->screen) == True)
3888 return Qt;
3889 else
3890 return Qnil;
3894 x_pixel_width (register struct frame *f)
3896 return FRAME_PIXEL_WIDTH (f);
3900 x_pixel_height (register struct frame *f)
3902 return FRAME_PIXEL_HEIGHT (f);
3906 x_char_width (register struct frame *f)
3908 return FRAME_COLUMN_WIDTH (f);
3912 x_char_height (register struct frame *f)
3914 return FRAME_LINE_HEIGHT (f);
3918 x_screen_planes (register struct frame *f)
3920 return FRAME_X_DISPLAY_INFO (f)->n_planes;
3925 /************************************************************************
3926 X Displays
3927 ************************************************************************/
3930 /* Mapping visual names to visuals. */
3932 static struct visual_class
3934 char *name;
3935 int class;
3937 visual_classes[] =
3939 {"StaticGray", StaticGray},
3940 {"GrayScale", GrayScale},
3941 {"StaticColor", StaticColor},
3942 {"PseudoColor", PseudoColor},
3943 {"TrueColor", TrueColor},
3944 {"DirectColor", DirectColor},
3945 {NULL, 0}
3949 #ifndef HAVE_XSCREENNUMBEROFSCREEN
3951 /* Value is the screen number of screen SCR. This is a substitute for
3952 the X function with the same name when that doesn't exist. */
3955 XScreenNumberOfScreen (scr)
3956 register Screen *scr;
3958 Display *dpy = scr->display;
3959 int i;
3961 for (i = 0; i < dpy->nscreens; ++i)
3962 if (scr == dpy->screens + i)
3963 break;
3965 return i;
3968 #endif /* not HAVE_XSCREENNUMBEROFSCREEN */
3971 /* Select the visual that should be used on display DPYINFO. Set
3972 members of DPYINFO appropriately. Called from x_term_init. */
3974 void
3975 select_visual (struct x_display_info *dpyinfo)
3977 Display *dpy = dpyinfo->display;
3978 Screen *screen = dpyinfo->screen;
3979 Lisp_Object value;
3981 /* See if a visual is specified. */
3982 value = display_x_get_resource (dpyinfo,
3983 build_string ("visualClass"),
3984 build_string ("VisualClass"),
3985 Qnil, Qnil);
3986 if (STRINGP (value))
3988 /* VALUE should be of the form CLASS-DEPTH, where CLASS is one
3989 of `PseudoColor', `TrueColor' etc. and DEPTH is the color
3990 depth, a decimal number. NAME is compared with case ignored. */
3991 char *s = (char *) alloca (SBYTES (value) + 1);
3992 char *dash;
3993 int i, class = -1;
3994 XVisualInfo vinfo;
3996 strcpy (s, SDATA (value));
3997 dash = strchr (s, '-');
3998 if (dash)
4000 dpyinfo->n_planes = atoi (dash + 1);
4001 *dash = '\0';
4003 else
4004 /* We won't find a matching visual with depth 0, so that
4005 an error will be printed below. */
4006 dpyinfo->n_planes = 0;
4008 /* Determine the visual class. */
4009 for (i = 0; visual_classes[i].name; ++i)
4010 if (xstrcasecmp (s, visual_classes[i].name) == 0)
4012 class = visual_classes[i].class;
4013 break;
4016 /* Look up a matching visual for the specified class. */
4017 if (class == -1
4018 || !XMatchVisualInfo (dpy, XScreenNumberOfScreen (screen),
4019 dpyinfo->n_planes, class, &vinfo))
4020 fatal ("Invalid visual specification `%s'", SDATA (value));
4022 dpyinfo->visual = vinfo.visual;
4024 else
4026 int n_visuals;
4027 XVisualInfo *vinfo, vinfo_template;
4029 dpyinfo->visual = DefaultVisualOfScreen (screen);
4031 vinfo_template.visualid = XVisualIDFromVisual (dpyinfo->visual);
4032 vinfo_template.screen = XScreenNumberOfScreen (screen);
4033 vinfo = XGetVisualInfo (dpy, VisualIDMask | VisualScreenMask,
4034 &vinfo_template, &n_visuals);
4035 if (n_visuals <= 0)
4036 fatal ("Can't get proper X visual info");
4038 dpyinfo->n_planes = vinfo->depth;
4039 XFree ((char *) vinfo);
4044 /* Return the X display structure for the display named NAME.
4045 Open a new connection if necessary. */
4047 struct x_display_info *
4048 x_display_info_for_name (Lisp_Object name)
4050 Lisp_Object names;
4051 struct x_display_info *dpyinfo;
4053 CHECK_STRING (name);
4055 #if 0
4056 if (! EQ (Vinitial_window_system, intern ("x")))
4057 error ("Not using X Windows"); /* That doesn't stop us anymore. */
4058 #endif
4060 for (dpyinfo = x_display_list, names = x_display_name_list;
4061 dpyinfo;
4062 dpyinfo = dpyinfo->next, names = XCDR (names))
4064 Lisp_Object tem;
4065 tem = Fstring_equal (XCAR (XCAR (names)), name);
4066 if (!NILP (tem))
4067 return dpyinfo;
4070 /* Use this general default value to start with. */
4071 Vx_resource_name = Vinvocation_name;
4073 validate_x_resource_name ();
4075 dpyinfo = x_term_init (name, (char *)0,
4076 (char *) SDATA (Vx_resource_name));
4078 if (dpyinfo == 0)
4079 error ("Cannot connect to X server %s", SDATA (name));
4081 x_in_use = 1;
4082 XSETFASTINT (Vwindow_system_version, 11);
4084 return dpyinfo;
4088 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
4089 1, 3, 0,
4090 doc: /* Open a connection to an X server.
4091 DISPLAY is the name of the display to connect to.
4092 Optional second arg XRM-STRING is a string of resources in xrdb format.
4093 If the optional third arg MUST-SUCCEED is non-nil,
4094 terminate Emacs if we can't open the connection. */)
4095 (Lisp_Object display, Lisp_Object xrm_string, Lisp_Object must_succeed)
4097 unsigned char *xrm_option;
4098 struct x_display_info *dpyinfo;
4100 CHECK_STRING (display);
4101 if (! NILP (xrm_string))
4102 CHECK_STRING (xrm_string);
4104 #if 0
4105 if (! EQ (Vinitial_window_system, intern ("x")))
4106 error ("Not using X Windows"); /* That doesn't stop us anymore. */
4107 #endif
4109 if (! NILP (xrm_string))
4110 xrm_option = (unsigned char *) SDATA (xrm_string);
4111 else
4112 xrm_option = (unsigned char *) 0;
4114 validate_x_resource_name ();
4116 /* This is what opens the connection and sets x_current_display.
4117 This also initializes many symbols, such as those used for input. */
4118 dpyinfo = x_term_init (display, xrm_option,
4119 (char *) SDATA (Vx_resource_name));
4121 if (dpyinfo == 0)
4123 if (!NILP (must_succeed))
4124 fatal ("Cannot connect to X server %s.\n\
4125 Check the DISPLAY environment variable or use `-d'.\n\
4126 Also use the `xauth' program to verify that you have the proper\n\
4127 authorization information needed to connect the X server.\n\
4128 An insecure way to solve the problem may be to use `xhost'.\n",
4129 SDATA (display));
4130 else
4131 error ("Cannot connect to X server %s", SDATA (display));
4134 x_in_use = 1;
4136 XSETFASTINT (Vwindow_system_version, 11);
4137 return Qnil;
4140 DEFUN ("x-close-connection", Fx_close_connection,
4141 Sx_close_connection, 1, 1, 0,
4142 doc: /* Close the connection to TERMINAL's X server.
4143 For TERMINAL, specify a terminal object, a frame or a display name (a
4144 string). If TERMINAL is nil, that stands for the selected frame's
4145 terminal. */)
4146 (Lisp_Object terminal)
4148 struct x_display_info *dpyinfo = check_x_display_info (terminal);
4150 if (dpyinfo->reference_count > 0)
4151 error ("Display still has frames on it");
4153 x_delete_terminal (dpyinfo->terminal);
4155 return Qnil;
4158 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
4159 doc: /* Return the list of display names that Emacs has connections to. */)
4160 (void)
4162 Lisp_Object tail, result;
4164 result = Qnil;
4165 for (tail = x_display_name_list; CONSP (tail); tail = XCDR (tail))
4166 result = Fcons (XCAR (XCAR (tail)), result);
4168 return result;
4171 DEFUN ("x-synchronize", Fx_synchronize, Sx_synchronize, 1, 2, 0,
4172 doc: /* If ON is non-nil, report X errors as soon as the erring request is made.
4173 If ON is nil, allow buffering of requests.
4174 Turning on synchronization prohibits the Xlib routines from buffering
4175 requests and seriously degrades performance, but makes debugging much
4176 easier.
4177 The optional second argument TERMINAL specifies which display to act on.
4178 TERMINAL should be a terminal object, a frame or a display name (a string).
4179 If TERMINAL is omitted or nil, that stands for the selected frame's display. */)
4180 (Lisp_Object on, Lisp_Object terminal)
4182 struct x_display_info *dpyinfo = check_x_display_info (terminal);
4184 XSynchronize (dpyinfo->display, !EQ (on, Qnil));
4186 return Qnil;
4189 /* Wait for responses to all X commands issued so far for frame F. */
4191 void
4192 x_sync (FRAME_PTR f)
4194 BLOCK_INPUT;
4195 XSync (FRAME_X_DISPLAY (f), False);
4196 UNBLOCK_INPUT;
4200 /***********************************************************************
4201 Window properties
4202 ***********************************************************************/
4204 DEFUN ("x-change-window-property", Fx_change_window_property,
4205 Sx_change_window_property, 2, 6, 0,
4206 doc: /* Change window property PROP to VALUE on the X window of FRAME.
4207 PROP must be a string.
4208 VALUE may be a string or a list of conses, numbers and/or strings.
4209 If an element in the list is a string, it is converted to
4210 an Atom and the value of the Atom is used. If an element is a cons,
4211 it is converted to a 32 bit number where the car is the 16 top bits and the
4212 cdr is the lower 16 bits.
4213 FRAME nil or omitted means use the selected frame.
4214 If TYPE is given and non-nil, it is the name of the type of VALUE.
4215 If TYPE is not given or nil, the type is STRING.
4216 FORMAT gives the size in bits of each element if VALUE is a list.
4217 It must be one of 8, 16 or 32.
4218 If VALUE is a string or FORMAT is nil or not given, FORMAT defaults to 8.
4219 If OUTER_P is non-nil, the property is changed for the outer X window of
4220 FRAME. Default is to change on the edit X window.
4222 Value is VALUE. */)
4223 (Lisp_Object prop, Lisp_Object value, Lisp_Object frame, Lisp_Object type, Lisp_Object format, Lisp_Object outer_p)
4225 struct frame *f = check_x_frame (frame);
4226 Atom prop_atom;
4227 Atom target_type = XA_STRING;
4228 int element_format = 8;
4229 unsigned char *data;
4230 int nelements;
4231 Window w;
4233 CHECK_STRING (prop);
4235 if (! NILP (format))
4237 CHECK_NUMBER (format);
4238 element_format = XFASTINT (format);
4240 if (element_format != 8 && element_format != 16
4241 && element_format != 32)
4242 error ("FORMAT must be one of 8, 16 or 32");
4245 if (CONSP (value))
4247 nelements = x_check_property_data (value);
4248 if (nelements == -1)
4249 error ("Bad data in VALUE, must be number, string or cons");
4251 if (element_format == 8)
4252 data = (unsigned char *) xmalloc (nelements);
4253 else if (element_format == 16)
4254 data = (unsigned char *) xmalloc (nelements*2);
4255 else /* format == 32 */
4256 /* The man page for XChangeProperty:
4257 "If the specified format is 32, the property data must be a
4258 long array."
4259 This applies even if long is more than 64 bits. The X library
4260 converts to 32 bits before sending to the X server. */
4261 data = (unsigned char *) xmalloc (nelements * sizeof(long));
4263 x_fill_property_data (FRAME_X_DISPLAY (f), value, data, element_format);
4265 else
4267 CHECK_STRING (value);
4268 data = SDATA (value);
4269 nelements = SCHARS (value);
4272 BLOCK_INPUT;
4273 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SDATA (prop), False);
4274 if (! NILP (type))
4276 CHECK_STRING (type);
4277 target_type = XInternAtom (FRAME_X_DISPLAY (f), SDATA (type), False);
4280 if (! NILP (outer_p)) w = FRAME_OUTER_WINDOW (f);
4281 else w = FRAME_X_WINDOW (f);
4283 XChangeProperty (FRAME_X_DISPLAY (f), w,
4284 prop_atom, target_type, element_format, PropModeReplace,
4285 data, nelements);
4287 if (CONSP (value)) xfree (data);
4289 /* Make sure the property is set when we return. */
4290 XFlush (FRAME_X_DISPLAY (f));
4291 UNBLOCK_INPUT;
4293 return value;
4297 DEFUN ("x-delete-window-property", Fx_delete_window_property,
4298 Sx_delete_window_property, 1, 2, 0,
4299 doc: /* Remove window property PROP from X window of FRAME.
4300 FRAME nil or omitted means use the selected frame. Value is PROP. */)
4301 (Lisp_Object prop, Lisp_Object frame)
4303 struct frame *f = check_x_frame (frame);
4304 Atom prop_atom;
4306 CHECK_STRING (prop);
4307 BLOCK_INPUT;
4308 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SDATA (prop), False);
4309 XDeleteProperty (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), prop_atom);
4311 /* Make sure the property is removed when we return. */
4312 XFlush (FRAME_X_DISPLAY (f));
4313 UNBLOCK_INPUT;
4315 return prop;
4319 DEFUN ("x-window-property", Fx_window_property, Sx_window_property,
4320 1, 6, 0,
4321 doc: /* Value is the value of window property PROP on FRAME.
4322 If FRAME is nil or omitted, use the selected frame.
4323 If TYPE is nil or omitted, get the property as a string. Otherwise TYPE
4324 is the name of the Atom that denotes the type expected.
4325 If SOURCE is non-nil, get the property on that window instead of from
4326 FRAME. The number 0 denotes the root window.
4327 If DELETE_P is non-nil, delete the property after retreiving it.
4328 If VECTOR_RET_P is non-nil, don't return a string but a vector of values.
4330 Value is nil if FRAME hasn't a property with name PROP or if PROP has
4331 no value of TYPE. */)
4332 (Lisp_Object prop, Lisp_Object frame, Lisp_Object type, Lisp_Object source, Lisp_Object delete_p, Lisp_Object vector_ret_p)
4334 struct frame *f = check_x_frame (frame);
4335 Atom prop_atom;
4336 int rc;
4337 Lisp_Object prop_value = Qnil;
4338 unsigned char *tmp_data = NULL;
4339 Atom actual_type;
4340 Atom target_type = XA_STRING;
4341 int actual_format;
4342 unsigned long actual_size, bytes_remaining;
4343 Window target_window = FRAME_X_WINDOW (f);
4344 struct gcpro gcpro1;
4346 GCPRO1 (prop_value);
4347 CHECK_STRING (prop);
4349 if (! NILP (source))
4351 if (NUMBERP (source))
4353 if (FLOATP (source))
4354 target_window = (Window) XFLOAT (source);
4355 else
4356 target_window = XFASTINT (source);
4358 if (target_window == 0)
4359 target_window = FRAME_X_DISPLAY_INFO (f)->root_window;
4361 else if (CONSP (source))
4362 target_window = cons_to_long (source);
4365 BLOCK_INPUT;
4366 if (STRINGP (type))
4368 if (strcmp ("AnyPropertyType", SDATA (type)) == 0)
4369 target_type = AnyPropertyType;
4370 else
4371 target_type = XInternAtom (FRAME_X_DISPLAY (f), SDATA (type), False);
4374 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SDATA (prop), False);
4375 rc = XGetWindowProperty (FRAME_X_DISPLAY (f), target_window,
4376 prop_atom, 0, 0, False, target_type,
4377 &actual_type, &actual_format, &actual_size,
4378 &bytes_remaining, &tmp_data);
4379 if (rc == Success)
4381 int size = bytes_remaining;
4383 XFree (tmp_data);
4384 tmp_data = NULL;
4386 rc = XGetWindowProperty (FRAME_X_DISPLAY (f), target_window,
4387 prop_atom, 0, bytes_remaining,
4388 ! NILP (delete_p), target_type,
4389 &actual_type, &actual_format,
4390 &actual_size, &bytes_remaining,
4391 &tmp_data);
4392 if (rc == Success && tmp_data)
4394 /* The man page for XGetWindowProperty says:
4395 "If the returned format is 32, the returned data is represented
4396 as a long array and should be cast to that type to obtain the
4397 elements."
4398 This applies even if long is more than 32 bits, the X library
4399 converts from 32 bit elements received from the X server to long
4400 and passes the long array to us. Thus, for that case memcpy can not
4401 be used. We convert to a 32 bit type here, because so much code
4402 assume on that.
4404 The bytes and offsets passed to XGetWindowProperty refers to the
4405 property and those are indeed in 32 bit quantities if format is
4406 32. */
4408 if (actual_format == 32 && actual_format < BITS_PER_LONG)
4410 unsigned long i;
4411 int *idata = (int *) tmp_data;
4412 long *ldata = (long *) tmp_data;
4414 for (i = 0; i < actual_size; ++i)
4415 idata[i] = (int) ldata[i];
4418 if (NILP (vector_ret_p))
4419 prop_value = make_string (tmp_data, size);
4420 else
4421 prop_value = x_property_data_to_lisp (f,
4422 tmp_data,
4423 actual_type,
4424 actual_format,
4425 actual_size);
4428 if (tmp_data) XFree (tmp_data);
4431 UNBLOCK_INPUT;
4432 UNGCPRO;
4433 return prop_value;
4438 /***********************************************************************
4439 Busy cursor
4440 ***********************************************************************/
4442 /* Timer function of hourglass_atimer. TIMER is equal to
4443 hourglass_atimer.
4445 Display an hourglass pointer on all frames by mapping the frames'
4446 hourglass_window. Set the hourglass_p flag in the frames'
4447 output_data.x structure to indicate that an hourglass cursor is
4448 shown on the frames. */
4450 void
4451 show_hourglass (struct atimer *timer)
4453 /* The timer implementation will cancel this timer automatically
4454 after this function has run. Set hourglass_atimer to null
4455 so that we know the timer doesn't have to be canceled. */
4456 hourglass_atimer = NULL;
4458 if (!hourglass_shown_p)
4460 Lisp_Object rest, frame;
4462 BLOCK_INPUT;
4464 FOR_EACH_FRAME (rest, frame)
4466 struct frame *f = XFRAME (frame);
4468 if (FRAME_LIVE_P (f) && FRAME_X_P (f) && FRAME_X_DISPLAY (f))
4470 Display *dpy = FRAME_X_DISPLAY (f);
4472 #ifdef USE_X_TOOLKIT
4473 if (f->output_data.x->widget)
4474 #else
4475 if (FRAME_OUTER_WINDOW (f))
4476 #endif
4478 f->output_data.x->hourglass_p = 1;
4480 if (!f->output_data.x->hourglass_window)
4482 unsigned long mask = CWCursor;
4483 XSetWindowAttributes attrs;
4484 #ifdef USE_GTK
4485 Window parent = FRAME_X_WINDOW (f);
4486 #else
4487 Window parent = FRAME_OUTER_WINDOW (f);
4488 #endif
4489 attrs.cursor = f->output_data.x->hourglass_cursor;
4491 f->output_data.x->hourglass_window
4492 = XCreateWindow (dpy, parent,
4493 0, 0, 32000, 32000, 0, 0,
4494 InputOnly,
4495 CopyFromParent,
4496 mask, &attrs);
4499 XMapRaised (dpy, f->output_data.x->hourglass_window);
4500 XFlush (dpy);
4505 hourglass_shown_p = 1;
4506 UNBLOCK_INPUT;
4511 /* Hide the hourglass pointer on all frames, if it is currently
4512 shown. */
4514 void
4515 hide_hourglass (void)
4517 if (hourglass_shown_p)
4519 Lisp_Object rest, frame;
4521 BLOCK_INPUT;
4522 FOR_EACH_FRAME (rest, frame)
4524 struct frame *f = XFRAME (frame);
4526 if (FRAME_X_P (f)
4527 /* Watch out for newly created frames. */
4528 && f->output_data.x->hourglass_window)
4530 XUnmapWindow (FRAME_X_DISPLAY (f),
4531 f->output_data.x->hourglass_window);
4532 /* Sync here because XTread_socket looks at the
4533 hourglass_p flag that is reset to zero below. */
4534 XSync (FRAME_X_DISPLAY (f), False);
4535 f->output_data.x->hourglass_p = 0;
4539 hourglass_shown_p = 0;
4540 UNBLOCK_INPUT;
4546 /***********************************************************************
4547 Tool tips
4548 ***********************************************************************/
4550 static Lisp_Object x_create_tip_frame (struct x_display_info *,
4551 Lisp_Object, Lisp_Object);
4552 static void compute_tip_xy (struct frame *, Lisp_Object, Lisp_Object,
4553 Lisp_Object, int, int, int *, int *);
4555 /* The frame of a currently visible tooltip. */
4557 Lisp_Object tip_frame;
4559 /* If non-nil, a timer started that hides the last tooltip when it
4560 fires. */
4562 Lisp_Object tip_timer;
4563 Window tip_window;
4565 /* If non-nil, a vector of 3 elements containing the last args
4566 with which x-show-tip was called. See there. */
4568 Lisp_Object last_show_tip_args;
4570 /* Maximum size for tooltips; a cons (COLUMNS . ROWS). */
4572 Lisp_Object Vx_max_tooltip_size;
4575 static Lisp_Object
4576 unwind_create_tip_frame (Lisp_Object frame)
4578 Lisp_Object deleted;
4580 deleted = unwind_create_frame (frame);
4581 if (EQ (deleted, Qt))
4583 tip_window = None;
4584 tip_frame = Qnil;
4587 return deleted;
4591 /* Create a frame for a tooltip on the display described by DPYINFO.
4592 PARMS is a list of frame parameters. TEXT is the string to
4593 display in the tip frame. Value is the frame.
4595 Note that functions called here, esp. x_default_parameter can
4596 signal errors, for instance when a specified color name is
4597 undefined. We have to make sure that we're in a consistent state
4598 when this happens. */
4600 static Lisp_Object
4601 x_create_tip_frame (struct x_display_info *dpyinfo, Lisp_Object parms, Lisp_Object text)
4603 struct frame *f;
4604 Lisp_Object frame, tem;
4605 Lisp_Object name;
4606 long window_prompting = 0;
4607 int width, height;
4608 int count = SPECPDL_INDEX ();
4609 struct gcpro gcpro1, gcpro2, gcpro3;
4610 int face_change_count_before = face_change_count;
4611 Lisp_Object buffer;
4612 struct buffer *old_buffer;
4614 check_x ();
4616 if (!dpyinfo->terminal->name)
4617 error ("Terminal is not live, can't create new frames on it");
4619 parms = Fcopy_alist (parms);
4621 /* Get the name of the frame to use for resource lookup. */
4622 name = x_get_arg (dpyinfo, parms, Qname, "name", "Name", RES_TYPE_STRING);
4623 if (!STRINGP (name)
4624 && !EQ (name, Qunbound)
4625 && !NILP (name))
4626 error ("Invalid frame name--not a string or nil");
4628 frame = Qnil;
4629 GCPRO3 (parms, name, frame);
4630 f = make_frame (1);
4631 XSETFRAME (frame, f);
4633 buffer = Fget_buffer_create (build_string (" *tip*"));
4634 Fset_window_buffer (FRAME_ROOT_WINDOW (f), buffer, Qnil);
4635 old_buffer = current_buffer;
4636 set_buffer_internal_1 (XBUFFER (buffer));
4637 current_buffer->truncate_lines = Qnil;
4638 specbind (Qinhibit_read_only, Qt);
4639 specbind (Qinhibit_modification_hooks, Qt);
4640 Ferase_buffer ();
4641 Finsert (1, &text);
4642 set_buffer_internal_1 (old_buffer);
4644 FRAME_CAN_HAVE_SCROLL_BARS (f) = 0;
4645 record_unwind_protect (unwind_create_tip_frame, frame);
4647 f->terminal = dpyinfo->terminal;
4648 f->terminal->reference_count++;
4650 /* By setting the output method, we're essentially saying that
4651 the frame is live, as per FRAME_LIVE_P. If we get a signal
4652 from this point on, x_destroy_window might screw up reference
4653 counts etc. */
4654 f->output_method = output_x_window;
4655 f->output_data.x = (struct x_output *) xmalloc (sizeof (struct x_output));
4656 memset (f->output_data.x, 0, sizeof (struct x_output));
4657 f->output_data.x->icon_bitmap = -1;
4658 FRAME_FONTSET (f) = -1;
4659 f->output_data.x->scroll_bar_foreground_pixel = -1;
4660 f->output_data.x->scroll_bar_background_pixel = -1;
4661 #ifdef USE_TOOLKIT_SCROLL_BARS
4662 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
4663 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
4664 #endif /* USE_TOOLKIT_SCROLL_BARS */
4665 f->icon_name = Qnil;
4666 FRAME_X_DISPLAY_INFO (f) = dpyinfo;
4667 #if GLYPH_DEBUG
4668 image_cache_refcount = FRAME_IMAGE_CACHE (f)->refcount;
4669 dpyinfo_refcount = dpyinfo->reference_count;
4670 #endif /* GLYPH_DEBUG */
4671 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
4672 f->output_data.x->explicit_parent = 0;
4674 /* These colors will be set anyway later, but it's important
4675 to get the color reference counts right, so initialize them! */
4677 Lisp_Object black;
4678 struct gcpro gcpro1;
4680 /* Function x_decode_color can signal an error. Make
4681 sure to initialize color slots so that we won't try
4682 to free colors we haven't allocated. */
4683 FRAME_FOREGROUND_PIXEL (f) = -1;
4684 FRAME_BACKGROUND_PIXEL (f) = -1;
4685 f->output_data.x->cursor_pixel = -1;
4686 f->output_data.x->cursor_foreground_pixel = -1;
4687 f->output_data.x->border_pixel = -1;
4688 f->output_data.x->mouse_pixel = -1;
4690 black = build_string ("black");
4691 GCPRO1 (black);
4692 FRAME_FOREGROUND_PIXEL (f)
4693 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4694 FRAME_BACKGROUND_PIXEL (f)
4695 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4696 f->output_data.x->cursor_pixel
4697 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4698 f->output_data.x->cursor_foreground_pixel
4699 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4700 f->output_data.x->border_pixel
4701 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4702 f->output_data.x->mouse_pixel
4703 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4704 UNGCPRO;
4707 /* Set the name; the functions to which we pass f expect the name to
4708 be set. */
4709 if (EQ (name, Qunbound) || NILP (name))
4711 f->name = build_string (dpyinfo->x_id_name);
4712 f->explicit_name = 0;
4714 else
4716 f->name = name;
4717 f->explicit_name = 1;
4718 /* use the frame's title when getting resources for this frame. */
4719 specbind (Qx_resource_name, name);
4722 f->resx = dpyinfo->resx;
4723 f->resy = dpyinfo->resy;
4725 register_font_driver (&xfont_driver, f);
4726 #ifdef HAVE_FREETYPE
4727 #ifdef HAVE_XFT
4728 register_font_driver (&xftfont_driver, f);
4729 #else /* not HAVE_XFT */
4730 register_font_driver (&ftxfont_driver, f);
4731 #endif /* not HAVE_XFT */
4732 #endif /* HAVE_FREETYPE */
4734 x_default_parameter (f, parms, Qfont_backend, Qnil,
4735 "fontBackend", "FontBackend", RES_TYPE_STRING);
4737 /* Extract the window parameters from the supplied values that are
4738 needed to determine window geometry. */
4739 x_default_font_parameter (f, parms);
4741 x_default_parameter (f, parms, Qborder_width, make_number (0),
4742 "borderWidth", "BorderWidth", RES_TYPE_NUMBER);
4744 /* This defaults to 2 in order to match xterm. We recognize either
4745 internalBorderWidth or internalBorder (which is what xterm calls
4746 it). */
4747 if (NILP (Fassq (Qinternal_border_width, parms)))
4749 Lisp_Object value;
4751 value = x_get_arg (dpyinfo, parms, Qinternal_border_width,
4752 "internalBorder", "internalBorder", RES_TYPE_NUMBER);
4753 if (! EQ (value, Qunbound))
4754 parms = Fcons (Fcons (Qinternal_border_width, value),
4755 parms);
4758 x_default_parameter (f, parms, Qinternal_border_width, make_number (1),
4759 "internalBorderWidth", "internalBorderWidth",
4760 RES_TYPE_NUMBER);
4762 /* Also do the stuff which must be set before the window exists. */
4763 x_default_parameter (f, parms, Qforeground_color, build_string ("black"),
4764 "foreground", "Foreground", RES_TYPE_STRING);
4765 x_default_parameter (f, parms, Qbackground_color, build_string ("white"),
4766 "background", "Background", RES_TYPE_STRING);
4767 x_default_parameter (f, parms, Qmouse_color, build_string ("black"),
4768 "pointerColor", "Foreground", RES_TYPE_STRING);
4769 x_default_parameter (f, parms, Qcursor_color, build_string ("black"),
4770 "cursorColor", "Foreground", RES_TYPE_STRING);
4771 x_default_parameter (f, parms, Qborder_color, build_string ("black"),
4772 "borderColor", "BorderColor", RES_TYPE_STRING);
4774 /* Init faces before x_default_parameter is called for scroll-bar
4775 parameters because that function calls x_set_scroll_bar_width,
4776 which calls change_frame_size, which calls Fset_window_buffer,
4777 which runs hooks, which call Fvertical_motion. At the end, we
4778 end up in init_iterator with a null face cache, which should not
4779 happen. */
4780 init_frame_faces (f);
4782 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
4784 window_prompting = x_figure_window_size (f, parms, 0);
4787 XSetWindowAttributes attrs;
4788 unsigned long mask;
4789 Atom type = FRAME_X_DISPLAY_INFO (f)->Xatom_net_window_type_tooltip;
4791 BLOCK_INPUT;
4792 mask = CWBackPixel | CWOverrideRedirect | CWEventMask;
4793 if (DoesSaveUnders (dpyinfo->screen))
4794 mask |= CWSaveUnder;
4796 /* Window managers look at the override-redirect flag to determine
4797 whether or net to give windows a decoration (Xlib spec, chapter
4798 3.2.8). */
4799 attrs.override_redirect = True;
4800 attrs.save_under = True;
4801 attrs.background_pixel = FRAME_BACKGROUND_PIXEL (f);
4802 /* Arrange for getting MapNotify and UnmapNotify events. */
4803 attrs.event_mask = StructureNotifyMask;
4804 tip_window
4805 = FRAME_X_WINDOW (f)
4806 = XCreateWindow (FRAME_X_DISPLAY (f),
4807 FRAME_X_DISPLAY_INFO (f)->root_window,
4808 /* x, y, width, height */
4809 0, 0, 1, 1,
4810 /* Border. */
4811 f->border_width,
4812 CopyFromParent, InputOutput, CopyFromParent,
4813 mask, &attrs);
4814 XChangeProperty (FRAME_X_DISPLAY (f), tip_window,
4815 FRAME_X_DISPLAY_INFO (f)->Xatom_net_window_type,
4816 XA_ATOM, 32, PropModeReplace,
4817 (unsigned char *)&type, 1);
4818 UNBLOCK_INPUT;
4821 x_make_gc (f);
4823 x_default_parameter (f, parms, Qauto_raise, Qnil,
4824 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
4825 x_default_parameter (f, parms, Qauto_lower, Qnil,
4826 "autoLower", "AutoRaiseLower", RES_TYPE_BOOLEAN);
4827 x_default_parameter (f, parms, Qcursor_type, Qbox,
4828 "cursorType", "CursorType", RES_TYPE_SYMBOL);
4830 /* Dimensions, especially FRAME_LINES (f), must be done via change_frame_size.
4831 Change will not be effected unless different from the current
4832 FRAME_LINES (f). */
4833 width = FRAME_COLS (f);
4834 height = FRAME_LINES (f);
4835 SET_FRAME_COLS (f, 0);
4836 FRAME_LINES (f) = 0;
4837 change_frame_size (f, height, width, 1, 0, 0);
4839 /* Add `tooltip' frame parameter's default value. */
4840 if (NILP (Fframe_parameter (frame, Qtooltip)))
4841 Fmodify_frame_parameters (frame, Fcons (Fcons (Qtooltip, Qt), Qnil));
4843 /* FIXME - can this be done in a similar way to normal frames?
4844 http://lists.gnu.org/archive/html/emacs-devel/2007-10/msg00641.html */
4846 /* Set the `display-type' frame parameter before setting up faces. */
4848 Lisp_Object disptype;
4850 if (FRAME_X_DISPLAY_INFO (f)->n_planes == 1)
4851 disptype = intern ("mono");
4852 else if (FRAME_X_DISPLAY_INFO (f)->visual->class == GrayScale
4853 || FRAME_X_DISPLAY_INFO (f)->visual->class == StaticGray)
4854 disptype = intern ("grayscale");
4855 else
4856 disptype = intern ("color");
4858 if (NILP (Fframe_parameter (frame, Qdisplay_type)))
4859 Fmodify_frame_parameters (frame, Fcons (Fcons (Qdisplay_type, disptype),
4860 Qnil));
4863 /* Set up faces after all frame parameters are known. This call
4864 also merges in face attributes specified for new frames.
4866 Frame parameters may be changed if .Xdefaults contains
4867 specifications for the default font. For example, if there is an
4868 `Emacs.default.attributeBackground: pink', the `background-color'
4869 attribute of the frame get's set, which let's the internal border
4870 of the tooltip frame appear in pink. Prevent this. */
4872 Lisp_Object bg = Fframe_parameter (frame, Qbackground_color);
4874 /* Set tip_frame here, so that */
4875 tip_frame = frame;
4876 call2 (Qface_set_after_frame_default, frame, Qnil);
4878 if (!EQ (bg, Fframe_parameter (frame, Qbackground_color)))
4879 Fmodify_frame_parameters (frame, Fcons (Fcons (Qbackground_color, bg),
4880 Qnil));
4883 f->no_split = 1;
4885 UNGCPRO;
4887 /* It is now ok to make the frame official even if we get an error
4888 below. And the frame needs to be on Vframe_list or making it
4889 visible won't work. */
4890 Vframe_list = Fcons (frame, Vframe_list);
4892 /* Now that the frame is official, it counts as a reference to
4893 its display. */
4894 FRAME_X_DISPLAY_INFO (f)->reference_count++;
4896 /* Setting attributes of faces of the tooltip frame from resources
4897 and similar will increment face_change_count, which leads to the
4898 clearing of all current matrices. Since this isn't necessary
4899 here, avoid it by resetting face_change_count to the value it
4900 had before we created the tip frame. */
4901 face_change_count = face_change_count_before;
4903 /* Discard the unwind_protect. */
4904 return unbind_to (count, frame);
4908 /* Compute where to display tip frame F. PARMS is the list of frame
4909 parameters for F. DX and DY are specified offsets from the current
4910 location of the mouse. WIDTH and HEIGHT are the width and height
4911 of the tooltip. Return coordinates relative to the root window of
4912 the display in *ROOT_X, and *ROOT_Y. */
4914 static void
4915 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)
4917 Lisp_Object left, top;
4918 int win_x, win_y;
4919 Window root, child;
4920 unsigned pmask;
4922 /* User-specified position? */
4923 left = Fcdr (Fassq (Qleft, parms));
4924 top = Fcdr (Fassq (Qtop, parms));
4926 /* Move the tooltip window where the mouse pointer is. Resize and
4927 show it. */
4928 if (!INTEGERP (left) || !INTEGERP (top))
4930 BLOCK_INPUT;
4931 XQueryPointer (FRAME_X_DISPLAY (f), FRAME_X_DISPLAY_INFO (f)->root_window,
4932 &root, &child, root_x, root_y, &win_x, &win_y, &pmask);
4933 UNBLOCK_INPUT;
4936 if (INTEGERP (top))
4937 *root_y = XINT (top);
4938 else if (*root_y + XINT (dy) <= 0)
4939 *root_y = 0; /* Can happen for negative dy */
4940 else if (*root_y + XINT (dy) + height
4941 <= x_display_pixel_height (FRAME_X_DISPLAY_INFO (f)))
4942 /* It fits below the pointer */
4943 *root_y += XINT (dy);
4944 else if (height + XINT (dy) <= *root_y)
4945 /* It fits above the pointer. */
4946 *root_y -= height + XINT (dy);
4947 else
4948 /* Put it on the top. */
4949 *root_y = 0;
4951 if (INTEGERP (left))
4952 *root_x = XINT (left);
4953 else if (*root_x + XINT (dx) <= 0)
4954 *root_x = 0; /* Can happen for negative dx */
4955 else if (*root_x + XINT (dx) + width
4956 <= x_display_pixel_width (FRAME_X_DISPLAY_INFO (f)))
4957 /* It fits to the right of the pointer. */
4958 *root_x += XINT (dx);
4959 else if (width + XINT (dx) <= *root_x)
4960 /* It fits to the left of the pointer. */
4961 *root_x -= width + XINT (dx);
4962 else
4963 /* Put it left-justified on the screen--it ought to fit that way. */
4964 *root_x = 0;
4968 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
4969 doc: /* Show STRING in a "tooltip" window on frame FRAME.
4970 A tooltip window is a small X window displaying a string.
4972 This is an internal function; Lisp code should call `tooltip-show'.
4974 FRAME nil or omitted means use the selected frame.
4976 PARMS is an optional list of frame parameters which can be used to
4977 change the tooltip's appearance.
4979 Automatically hide the tooltip after TIMEOUT seconds. TIMEOUT nil
4980 means use the default timeout of 5 seconds.
4982 If the list of frame parameters PARAMS contains a `left' parameters,
4983 the tooltip is displayed at that x-position. Otherwise it is
4984 displayed at the mouse position, with offset DX added (default is 5 if
4985 DX isn't specified). Likewise for the y-position; if a `top' frame
4986 parameter is specified, it determines the y-position of the tooltip
4987 window, otherwise it is displayed at the mouse position, with offset
4988 DY added (default is -10).
4990 A tooltip's maximum size is specified by `x-max-tooltip-size'.
4991 Text larger than the specified size is clipped. */)
4992 (Lisp_Object string, Lisp_Object frame, Lisp_Object parms, Lisp_Object timeout, Lisp_Object dx, Lisp_Object dy)
4994 struct frame *f;
4995 struct window *w;
4996 int root_x, root_y;
4997 struct buffer *old_buffer;
4998 struct text_pos pos;
4999 int i, width, height;
5000 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
5001 int old_windows_or_buffers_changed = windows_or_buffers_changed;
5002 int count = SPECPDL_INDEX ();
5004 specbind (Qinhibit_redisplay, Qt);
5006 GCPRO4 (string, parms, frame, timeout);
5008 CHECK_STRING (string);
5009 if (SCHARS (string) == 0)
5010 string = make_unibyte_string (" ", 1);
5012 f = check_x_frame (frame);
5013 if (NILP (timeout))
5014 timeout = make_number (5);
5015 else
5016 CHECK_NATNUM (timeout);
5018 if (NILP (dx))
5019 dx = make_number (5);
5020 else
5021 CHECK_NUMBER (dx);
5023 if (NILP (dy))
5024 dy = make_number (-10);
5025 else
5026 CHECK_NUMBER (dy);
5028 if (NILP (last_show_tip_args))
5029 last_show_tip_args = Fmake_vector (make_number (3), Qnil);
5031 if (!NILP (tip_frame))
5033 Lisp_Object last_string = AREF (last_show_tip_args, 0);
5034 Lisp_Object last_frame = AREF (last_show_tip_args, 1);
5035 Lisp_Object last_parms = AREF (last_show_tip_args, 2);
5037 if (EQ (frame, last_frame)
5038 && !NILP (Fequal (last_string, string))
5039 && !NILP (Fequal (last_parms, parms)))
5041 struct frame *f = XFRAME (tip_frame);
5043 /* Only DX and DY have changed. */
5044 if (!NILP (tip_timer))
5046 Lisp_Object timer = tip_timer;
5047 tip_timer = Qnil;
5048 call1 (Qcancel_timer, timer);
5051 BLOCK_INPUT;
5052 compute_tip_xy (f, parms, dx, dy, FRAME_PIXEL_WIDTH (f),
5053 FRAME_PIXEL_HEIGHT (f), &root_x, &root_y);
5054 XMoveWindow (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
5055 root_x, root_y);
5056 UNBLOCK_INPUT;
5057 goto start_timer;
5061 /* Hide a previous tip, if any. */
5062 Fx_hide_tip ();
5064 ASET (last_show_tip_args, 0, string);
5065 ASET (last_show_tip_args, 1, frame);
5066 ASET (last_show_tip_args, 2, parms);
5068 /* Add default values to frame parameters. */
5069 if (NILP (Fassq (Qname, parms)))
5070 parms = Fcons (Fcons (Qname, build_string ("tooltip")), parms);
5071 if (NILP (Fassq (Qinternal_border_width, parms)))
5072 parms = Fcons (Fcons (Qinternal_border_width, make_number (3)), parms);
5073 if (NILP (Fassq (Qborder_width, parms)))
5074 parms = Fcons (Fcons (Qborder_width, make_number (1)), parms);
5075 if (NILP (Fassq (Qborder_color, parms)))
5076 parms = Fcons (Fcons (Qborder_color, build_string ("lightyellow")), parms);
5077 if (NILP (Fassq (Qbackground_color, parms)))
5078 parms = Fcons (Fcons (Qbackground_color, build_string ("lightyellow")),
5079 parms);
5081 /* Create a frame for the tooltip, and record it in the global
5082 variable tip_frame. */
5083 frame = x_create_tip_frame (FRAME_X_DISPLAY_INFO (f), parms, string);
5084 f = XFRAME (frame);
5086 /* Set up the frame's root window. */
5087 w = XWINDOW (FRAME_ROOT_WINDOW (f));
5088 w->left_col = w->top_line = make_number (0);
5090 if (CONSP (Vx_max_tooltip_size)
5091 && INTEGERP (XCAR (Vx_max_tooltip_size))
5092 && XINT (XCAR (Vx_max_tooltip_size)) > 0
5093 && INTEGERP (XCDR (Vx_max_tooltip_size))
5094 && XINT (XCDR (Vx_max_tooltip_size)) > 0)
5096 w->total_cols = XCAR (Vx_max_tooltip_size);
5097 w->total_lines = XCDR (Vx_max_tooltip_size);
5099 else
5101 w->total_cols = make_number (80);
5102 w->total_lines = make_number (40);
5105 FRAME_TOTAL_COLS (f) = XINT (w->total_cols);
5106 adjust_glyphs (f);
5107 w->pseudo_window_p = 1;
5109 /* Display the tooltip text in a temporary buffer. */
5110 old_buffer = current_buffer;
5111 set_buffer_internal_1 (XBUFFER (XWINDOW (FRAME_ROOT_WINDOW (f))->buffer));
5112 current_buffer->truncate_lines = Qnil;
5113 clear_glyph_matrix (w->desired_matrix);
5114 clear_glyph_matrix (w->current_matrix);
5115 SET_TEXT_POS (pos, BEGV, BEGV_BYTE);
5116 try_window (FRAME_ROOT_WINDOW (f), pos, TRY_WINDOW_IGNORE_FONTS_CHANGE);
5118 /* Compute width and height of the tooltip. */
5119 width = height = 0;
5120 for (i = 0; i < w->desired_matrix->nrows; ++i)
5122 struct glyph_row *row = &w->desired_matrix->rows[i];
5123 struct glyph *last;
5124 int row_width;
5126 /* Stop at the first empty row at the end. */
5127 if (!row->enabled_p || !row->displays_text_p)
5128 break;
5130 /* Let the row go over the full width of the frame. */
5131 row->full_width_p = 1;
5133 row_width = row->pixel_width;
5134 /* There's a glyph at the end of rows that is used to place
5135 the cursor there. Don't include the width of this glyph. */
5136 if (row->used[TEXT_AREA])
5138 last = &row->glyphs[TEXT_AREA][row->used[TEXT_AREA] - 1];
5139 if (INTEGERP (last->object))
5140 row_width -= last->pixel_width;
5143 height += row->height;
5144 width = max (width, row_width);
5147 /* Add the frame's internal border to the width and height the X
5148 window should have. */
5149 height += 2 * FRAME_INTERNAL_BORDER_WIDTH (f);
5150 width += 2 * FRAME_INTERNAL_BORDER_WIDTH (f);
5152 /* Move the tooltip window where the mouse pointer is. Resize and
5153 show it. */
5154 compute_tip_xy (f, parms, dx, dy, width, height, &root_x, &root_y);
5156 BLOCK_INPUT;
5157 XMoveResizeWindow (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
5158 root_x, root_y, width, height);
5159 XMapRaised (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f));
5160 UNBLOCK_INPUT;
5162 /* Draw into the window. */
5163 w->must_be_updated_p = 1;
5164 update_single_window (w, 1);
5166 /* Restore original current buffer. */
5167 set_buffer_internal_1 (old_buffer);
5168 windows_or_buffers_changed = old_windows_or_buffers_changed;
5170 start_timer:
5171 /* Let the tip disappear after timeout seconds. */
5172 tip_timer = call3 (intern ("run-at-time"), timeout, Qnil,
5173 intern ("x-hide-tip"));
5175 UNGCPRO;
5176 return unbind_to (count, Qnil);
5180 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
5181 doc: /* Hide the current tooltip window, if there is any.
5182 Value is t if tooltip was open, nil otherwise. */)
5183 (void)
5185 int count;
5186 Lisp_Object deleted, frame, timer;
5187 struct gcpro gcpro1, gcpro2;
5189 /* Return quickly if nothing to do. */
5190 if (NILP (tip_timer) && NILP (tip_frame))
5191 return Qnil;
5193 frame = tip_frame;
5194 timer = tip_timer;
5195 GCPRO2 (frame, timer);
5196 tip_frame = tip_timer = deleted = Qnil;
5198 count = SPECPDL_INDEX ();
5199 specbind (Qinhibit_redisplay, Qt);
5200 specbind (Qinhibit_quit, Qt);
5202 if (!NILP (timer))
5203 call1 (Qcancel_timer, timer);
5205 if (FRAMEP (frame))
5207 delete_frame (frame, Qnil);
5208 deleted = Qt;
5210 #ifdef USE_LUCID
5211 /* Bloodcurdling hack alert: The Lucid menu bar widget's
5212 redisplay procedure is not called when a tip frame over menu
5213 items is unmapped. Redisplay the menu manually... */
5215 struct frame *f = SELECTED_FRAME ();
5216 Widget w = f->output_data.x->menubar_widget;
5218 if (!DoesSaveUnders (FRAME_X_DISPLAY_INFO (f)->screen)
5219 && w != NULL)
5221 BLOCK_INPUT;
5222 xlwmenu_redisplay (w);
5223 UNBLOCK_INPUT;
5226 #endif /* USE_LUCID */
5229 UNGCPRO;
5230 return unbind_to (count, deleted);
5235 /***********************************************************************
5236 File selection dialog
5237 ***********************************************************************/
5239 DEFUN ("x-uses-old-gtk-dialog", Fx_uses_old_gtk_dialog,
5240 Sx_uses_old_gtk_dialog,
5241 0, 0, 0,
5242 doc: /* Return t if the old Gtk+ file selection dialog is used. */)
5243 (void)
5245 #ifdef USE_GTK
5246 extern int use_dialog_box;
5247 extern int use_file_dialog;
5249 if (use_dialog_box
5250 && use_file_dialog
5251 && have_menus_p ()
5252 && xg_uses_old_file_dialog ())
5253 return Qt;
5254 #endif
5255 return Qnil;
5259 #ifdef USE_MOTIF
5260 /* Callback for "OK" and "Cancel" on file selection dialog. */
5262 static void
5263 file_dialog_cb (widget, client_data, call_data)
5264 Widget widget;
5265 XtPointer call_data, client_data;
5267 int *result = (int *) client_data;
5268 XmAnyCallbackStruct *cb = (XmAnyCallbackStruct *) call_data;
5269 *result = cb->reason;
5273 /* Callback for unmapping a file selection dialog. This is used to
5274 capture the case where a dialog is closed via a window manager's
5275 closer button, for example. Using a XmNdestroyCallback didn't work
5276 in this case. */
5278 static void
5279 file_dialog_unmap_cb (widget, client_data, call_data)
5280 Widget widget;
5281 XtPointer call_data, client_data;
5283 int *result = (int *) client_data;
5284 *result = XmCR_CANCEL;
5287 static Lisp_Object
5288 clean_up_file_dialog (arg)
5289 Lisp_Object arg;
5291 struct Lisp_Save_Value *p = XSAVE_VALUE (arg);
5292 Widget dialog = (Widget) p->pointer;
5294 /* Clean up. */
5295 BLOCK_INPUT;
5296 XtUnmanageChild (dialog);
5297 XtDestroyWidget (dialog);
5298 x_menu_set_in_use (0);
5299 UNBLOCK_INPUT;
5301 return Qnil;
5305 DEFUN ("x-file-dialog", Fx_file_dialog, Sx_file_dialog, 2, 5, 0,
5306 doc: /* Read file name, prompting with PROMPT in directory DIR.
5307 Use a file selection dialog. Select DEFAULT-FILENAME in the dialog's file
5308 selection box, if specified. If MUSTMATCH is non-nil, the returned file
5309 or directory must exist. ONLY-DIR-P is ignored." */)
5310 (Lisp_Object prompt, Lisp_Object dir, Lisp_Object default_filename, Lisp_Object mustmatch, Lisp_Object only_dir_p)
5312 int result;
5313 struct frame *f = SELECTED_FRAME ();
5314 Lisp_Object file = Qnil;
5315 Lisp_Object decoded_file;
5316 Widget dialog, text, help;
5317 Arg al[10];
5318 int ac = 0;
5319 extern XtAppContext Xt_app_con;
5320 XmString dir_xmstring, pattern_xmstring;
5321 int count = SPECPDL_INDEX ();
5322 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
5324 check_x ();
5326 GCPRO6 (prompt, dir, default_filename, mustmatch, only_dir_p, file);
5328 if (popup_activated ())
5329 error ("Trying to use a menu from within a menu-entry");
5331 CHECK_STRING (prompt);
5332 CHECK_STRING (dir);
5334 /* Prevent redisplay. */
5335 specbind (Qinhibit_redisplay, Qt);
5337 BLOCK_INPUT;
5339 /* Create the dialog with PROMPT as title, using DIR as initial
5340 directory and using "*" as pattern. */
5341 dir = Fexpand_file_name (dir, Qnil);
5342 dir_xmstring = XmStringCreateLocalized (SDATA (dir));
5343 pattern_xmstring = XmStringCreateLocalized ("*");
5345 XtSetArg (al[ac], XmNtitle, SDATA (prompt)); ++ac;
5346 XtSetArg (al[ac], XmNdirectory, dir_xmstring); ++ac;
5347 XtSetArg (al[ac], XmNpattern, pattern_xmstring); ++ac;
5348 XtSetArg (al[ac], XmNresizePolicy, XmRESIZE_GROW); ++ac;
5349 XtSetArg (al[ac], XmNdialogStyle, XmDIALOG_APPLICATION_MODAL); ++ac;
5350 dialog = XmCreateFileSelectionDialog (f->output_data.x->widget,
5351 "fsb", al, ac);
5352 XmStringFree (dir_xmstring);
5353 XmStringFree (pattern_xmstring);
5355 /* Add callbacks for OK and Cancel. */
5356 XtAddCallback (dialog, XmNokCallback, file_dialog_cb,
5357 (XtPointer) &result);
5358 XtAddCallback (dialog, XmNcancelCallback, file_dialog_cb,
5359 (XtPointer) &result);
5360 XtAddCallback (dialog, XmNunmapCallback, file_dialog_unmap_cb,
5361 (XtPointer) &result);
5363 /* Remove the help button since we can't display help. */
5364 help = XmFileSelectionBoxGetChild (dialog, XmDIALOG_HELP_BUTTON);
5365 XtUnmanageChild (help);
5367 /* Mark OK button as default. */
5368 XtVaSetValues (XmFileSelectionBoxGetChild (dialog, XmDIALOG_OK_BUTTON),
5369 XmNshowAsDefault, True, NULL);
5371 /* If MUSTMATCH is non-nil, disable the file entry field of the
5372 dialog, so that the user must select a file from the files list
5373 box. We can't remove it because we wouldn't have a way to get at
5374 the result file name, then. */
5375 text = XmFileSelectionBoxGetChild (dialog, XmDIALOG_TEXT);
5376 if (!NILP (mustmatch))
5378 Widget label;
5379 label = XmFileSelectionBoxGetChild (dialog, XmDIALOG_SELECTION_LABEL);
5380 XtSetSensitive (text, False);
5381 XtSetSensitive (label, False);
5384 /* Manage the dialog, so that list boxes get filled. */
5385 XtManageChild (dialog);
5387 if (STRINGP (default_filename))
5389 XmString default_xmstring;
5390 Widget wtext = XmFileSelectionBoxGetChild (dialog, XmDIALOG_TEXT);
5391 Widget list = XmFileSelectionBoxGetChild (dialog, XmDIALOG_LIST);
5393 XmTextPosition last_pos = XmTextFieldGetLastPosition (wtext);
5394 XmTextFieldReplace (wtext, 0, last_pos,
5395 (SDATA (Ffile_name_nondirectory (default_filename))));
5397 /* Select DEFAULT_FILENAME in the files list box. DEFAULT_FILENAME
5398 must include the path for this to work. */
5400 default_xmstring = XmStringCreateLocalized (SDATA (default_filename));
5402 if (XmListItemExists (list, default_xmstring))
5404 int item_pos = XmListItemPos (list, default_xmstring);
5405 /* Select the item and scroll it into view. */
5406 XmListSelectPos (list, item_pos, True);
5407 XmListSetPos (list, item_pos);
5410 XmStringFree (default_xmstring);
5413 record_unwind_protect (clean_up_file_dialog, make_save_value (dialog, 0));
5415 /* Process events until the user presses Cancel or OK. */
5416 x_menu_set_in_use (1);
5417 result = 0;
5418 while (result == 0)
5420 XEvent event;
5421 x_menu_wait_for_event (0);
5422 XtAppNextEvent (Xt_app_con, &event);
5423 if (event.type == KeyPress
5424 && FRAME_X_DISPLAY (f) == event.xkey.display)
5426 KeySym keysym = XLookupKeysym (&event.xkey, 0);
5428 /* Pop down on C-g. */
5429 if (keysym == XK_g && (event.xkey.state & ControlMask) != 0)
5430 XtUnmanageChild (dialog);
5433 (void) x_dispatch_event (&event, FRAME_X_DISPLAY (f));
5436 /* Get the result. */
5437 if (result == XmCR_OK)
5439 XmString text;
5440 String data;
5442 XtVaGetValues (dialog, XmNtextString, &text, NULL);
5443 XmStringGetLtoR (text, XmFONTLIST_DEFAULT_TAG, &data);
5444 XmStringFree (text);
5445 file = build_string (data);
5446 XtFree (data);
5448 else
5449 file = Qnil;
5451 UNBLOCK_INPUT;
5452 UNGCPRO;
5454 /* Make "Cancel" equivalent to C-g. */
5455 if (NILP (file))
5456 Fsignal (Qquit, Qnil);
5458 decoded_file = DECODE_FILE (file);
5460 return unbind_to (count, decoded_file);
5463 #endif /* USE_MOTIF */
5465 #ifdef USE_GTK
5467 static Lisp_Object
5468 clean_up_dialog (Lisp_Object arg)
5470 x_menu_set_in_use (0);
5472 return Qnil;
5475 DEFUN ("x-file-dialog", Fx_file_dialog, Sx_file_dialog, 2, 5, 0,
5476 doc: /* Read file name, prompting with PROMPT in directory DIR.
5477 Use a file selection dialog. Select DEFAULT-FILENAME in the dialog's file
5478 selection box, if specified. If MUSTMATCH is non-nil, the returned file
5479 or directory must exist. If ONLY-DIR-P is non-nil, the user can only select
5480 directories. */)
5481 (Lisp_Object prompt, Lisp_Object dir, Lisp_Object default_filename, Lisp_Object mustmatch, Lisp_Object only_dir_p)
5483 FRAME_PTR f = SELECTED_FRAME ();
5484 char *fn;
5485 Lisp_Object file = Qnil;
5486 Lisp_Object decoded_file;
5487 int count = SPECPDL_INDEX ();
5488 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
5489 char *cdef_file;
5491 check_x ();
5493 GCPRO6 (prompt, dir, default_filename, mustmatch, only_dir_p, file);
5495 if (popup_activated ())
5496 error ("Trying to use a menu from within a menu-entry");
5498 CHECK_STRING (prompt);
5499 CHECK_STRING (dir);
5501 /* Prevent redisplay. */
5502 specbind (Qinhibit_redisplay, Qt);
5503 record_unwind_protect (clean_up_dialog, Qnil);
5505 BLOCK_INPUT;
5507 if (STRINGP (default_filename))
5508 cdef_file = SDATA (default_filename);
5509 else
5510 cdef_file = SDATA (dir);
5512 fn = xg_get_file_name (f, SDATA (prompt), cdef_file,
5513 ! NILP (mustmatch),
5514 ! NILP (only_dir_p));
5516 if (fn)
5518 file = build_string (fn);
5519 xfree (fn);
5522 UNBLOCK_INPUT;
5523 UNGCPRO;
5525 /* Make "Cancel" equivalent to C-g. */
5526 if (NILP (file))
5527 Fsignal (Qquit, Qnil);
5529 decoded_file = DECODE_FILE (file);
5531 return unbind_to (count, decoded_file);
5535 #ifdef HAVE_FREETYPE
5537 DEFUN ("x-select-font", Fx_select_font, Sx_select_font, 0, 2, 0,
5538 doc: /* Read a font name using a GTK font selection dialog.
5539 Return a GTK-style font string corresponding to the selection.
5541 If FRAME is omitted or nil, it defaults to the selected frame. */)
5542 (Lisp_Object frame, Lisp_Object ignored)
5544 FRAME_PTR f = check_x_frame (frame);
5545 char *name;
5546 Lisp_Object font;
5547 Lisp_Object font_param;
5548 char *default_name = NULL;
5549 struct gcpro gcpro1, gcpro2;
5550 int count = SPECPDL_INDEX ();
5552 check_x ();
5554 if (popup_activated ())
5555 error ("Trying to use a menu from within a menu-entry");
5557 /* Prevent redisplay. */
5558 specbind (Qinhibit_redisplay, Qt);
5559 record_unwind_protect (clean_up_dialog, Qnil);
5561 BLOCK_INPUT;
5563 GCPRO2(font_param, font);
5565 XSETFONT (font, FRAME_FONT (f));
5566 font_param = Ffont_get (font, intern (":name"));
5567 if (STRINGP (font_param))
5568 default_name = xstrdup (SDATA (font_param));
5569 else
5571 font_param = Fframe_parameter (frame, Qfont_param);
5572 if (STRINGP (font_param))
5573 default_name = xstrdup (SDATA (font_param));
5576 if (default_name == NULL && x_last_font_name != NULL)
5577 default_name = xstrdup (x_last_font_name);
5579 /* Convert fontconfig names to Gtk names, i.e. remove - before number */
5580 if (default_name)
5582 char *p = strrchr (default_name, '-');
5583 if (p)
5585 char *ep = p+1;
5586 while (isdigit (*ep))
5587 ++ep;
5588 if (*ep == '\0') *p = ' ';
5592 name = xg_get_font_name (f, default_name);
5593 xfree (default_name);
5595 if (name)
5597 font = build_string (name);
5598 g_free (x_last_font_name);
5599 x_last_font_name = name;
5602 UNBLOCK_INPUT;
5604 if (NILP (font))
5605 Fsignal (Qquit, Qnil);
5607 return unbind_to (count, font);
5609 #endif /* HAVE_FREETYPE */
5611 #endif /* USE_GTK */
5614 /***********************************************************************
5615 Keyboard
5616 ***********************************************************************/
5618 #ifdef HAVE_XKBGETKEYBOARD
5619 #include <X11/XKBlib.h>
5620 #include <X11/keysym.h>
5621 #endif
5623 DEFUN ("x-backspace-delete-keys-p", Fx_backspace_delete_keys_p,
5624 Sx_backspace_delete_keys_p, 0, 1, 0,
5625 doc: /* Check if both Backspace and Delete keys are on the keyboard of FRAME.
5626 FRAME nil means use the selected frame.
5627 Value is t if we know that both keys are present, and are mapped to the
5628 usual X keysyms. Value is `lambda' if we cannot determine if both keys are
5629 present and mapped to the usual X keysyms. */)
5630 (Lisp_Object frame)
5632 #ifdef HAVE_XKBGETKEYBOARD
5633 XkbDescPtr kb;
5634 struct frame *f = check_x_frame (frame);
5635 Display *dpy = FRAME_X_DISPLAY (f);
5636 Lisp_Object have_keys;
5637 int major, minor, op, event, error;
5639 BLOCK_INPUT;
5641 /* Check library version in case we're dynamically linked. */
5642 major = XkbMajorVersion;
5643 minor = XkbMinorVersion;
5644 if (!XkbLibraryVersion (&major, &minor))
5646 UNBLOCK_INPUT;
5647 return Qlambda;
5650 /* Check that the server supports XKB. */
5651 major = XkbMajorVersion;
5652 minor = XkbMinorVersion;
5653 if (!XkbQueryExtension (dpy, &op, &event, &error, &major, &minor))
5655 UNBLOCK_INPUT;
5656 return Qlambda;
5659 /* In this code we check that the keyboard has physical keys with names
5660 that start with BKSP (Backspace) and DELE (Delete), and that they
5661 generate keysym XK_BackSpace and XK_Delete respectively.
5662 This function is used to test if normal-erase-is-backspace should be
5663 turned on.
5664 An alternative approach would be to just check if XK_BackSpace and
5665 XK_Delete are mapped to any key. But if any of those are mapped to
5666 some non-intuitive key combination (Meta-Shift-Ctrl-whatever) and the
5667 user doesn't know about it, it is better to return false here.
5668 It is more obvious to the user what to do if she/he has two keys
5669 clearly marked with names/symbols and one key does something not
5670 expected (i.e. she/he then tries the other).
5671 The cases where Backspace/Delete is mapped to some other key combination
5672 are rare, and in those cases, normal-erase-is-backspace can be turned on
5673 manually. */
5675 have_keys = Qnil;
5676 kb = XkbGetMap (dpy, XkbAllMapComponentsMask, XkbUseCoreKbd);
5677 if (kb)
5679 int delete_keycode = 0, backspace_keycode = 0, i;
5681 if (XkbGetNames (dpy, XkbAllNamesMask, kb) == Success)
5683 for (i = kb->min_key_code;
5684 (i < kb->max_key_code
5685 && (delete_keycode == 0 || backspace_keycode == 0));
5686 ++i)
5688 /* The XKB symbolic key names can be seen most easily in
5689 the PS file generated by `xkbprint -label name
5690 $DISPLAY'. */
5691 if (memcmp ("DELE", kb->names->keys[i].name, 4) == 0)
5692 delete_keycode = i;
5693 else if (memcmp ("BKSP", kb->names->keys[i].name, 4) == 0)
5694 backspace_keycode = i;
5697 XkbFreeNames (kb, 0, True);
5700 XkbFreeClientMap (kb, 0, True);
5702 if (delete_keycode
5703 && backspace_keycode
5704 && XKeysymToKeycode (dpy, XK_Delete) == delete_keycode
5705 && XKeysymToKeycode (dpy, XK_BackSpace) == backspace_keycode)
5706 have_keys = Qt;
5708 UNBLOCK_INPUT;
5709 return have_keys;
5710 #else /* not HAVE_XKBGETKEYBOARD */
5711 return Qlambda;
5712 #endif /* not HAVE_XKBGETKEYBOARD */
5717 /***********************************************************************
5718 Initialization
5719 ***********************************************************************/
5721 /* Keep this list in the same order as frame_parms in frame.c.
5722 Use 0 for unsupported frame parameters. */
5724 frame_parm_handler x_frame_parm_handlers[] =
5726 x_set_autoraise,
5727 x_set_autolower,
5728 x_set_background_color,
5729 x_set_border_color,
5730 x_set_border_width,
5731 x_set_cursor_color,
5732 x_set_cursor_type,
5733 x_set_font,
5734 x_set_foreground_color,
5735 x_set_icon_name,
5736 x_set_icon_type,
5737 x_set_internal_border_width,
5738 x_set_menu_bar_lines,
5739 x_set_mouse_color,
5740 x_explicitly_set_name,
5741 x_set_scroll_bar_width,
5742 x_set_title,
5743 x_set_unsplittable,
5744 x_set_vertical_scroll_bars,
5745 x_set_visibility,
5746 x_set_tool_bar_lines,
5747 x_set_scroll_bar_foreground,
5748 x_set_scroll_bar_background,
5749 x_set_screen_gamma,
5750 x_set_line_spacing,
5751 x_set_fringe_width,
5752 x_set_fringe_width,
5753 x_set_wait_for_wm,
5754 x_set_fullscreen,
5755 x_set_font_backend,
5756 x_set_alpha,
5757 x_set_sticky,
5760 void
5761 syms_of_xfns (void)
5763 /* This is zero if not using X windows. */
5764 x_in_use = 0;
5766 /* The section below is built by the lisp expression at the top of the file,
5767 just above where these variables are declared. */
5768 /*&&& init symbols here &&&*/
5769 Qnone = intern_c_string ("none");
5770 staticpro (&Qnone);
5771 Qsuppress_icon = intern_c_string ("suppress-icon");
5772 staticpro (&Qsuppress_icon);
5773 Qundefined_color = intern_c_string ("undefined-color");
5774 staticpro (&Qundefined_color);
5775 Qcompound_text = intern_c_string ("compound-text");
5776 staticpro (&Qcompound_text);
5777 Qcancel_timer = intern_c_string ("cancel-timer");
5778 staticpro (&Qcancel_timer);
5779 Qfont_param = intern_c_string ("font-parameter");
5780 staticpro (&Qfont_param);
5781 /* This is the end of symbol initialization. */
5783 /* Text property `display' should be nonsticky by default. */
5784 Vtext_property_default_nonsticky
5785 = Fcons (Fcons (Qdisplay, Qt), Vtext_property_default_nonsticky);
5788 Fput (Qundefined_color, Qerror_conditions,
5789 pure_cons (Qundefined_color, pure_cons (Qerror, Qnil)));
5790 Fput (Qundefined_color, Qerror_message,
5791 make_pure_c_string ("Undefined color"));
5793 DEFVAR_LISP ("x-pointer-shape", &Vx_pointer_shape,
5794 doc: /* The shape of the pointer when over text.
5795 Changing the value does not affect existing frames
5796 unless you set the mouse color. */);
5797 Vx_pointer_shape = Qnil;
5799 #if 0 /* This doesn't really do anything. */
5800 DEFVAR_LISP ("x-nontext-pointer-shape", &Vx_nontext_pointer_shape,
5801 doc: /* The shape of the pointer when not over text.
5802 This variable takes effect when you create a new frame
5803 or when you set the mouse color. */);
5804 #endif
5805 Vx_nontext_pointer_shape = Qnil;
5807 DEFVAR_LISP ("x-hourglass-pointer-shape", &Vx_hourglass_pointer_shape,
5808 doc: /* The shape of the pointer when Emacs is busy.
5809 This variable takes effect when you create a new frame
5810 or when you set the mouse color. */);
5811 Vx_hourglass_pointer_shape = Qnil;
5813 #if 0 /* This doesn't really do anything. */
5814 DEFVAR_LISP ("x-mode-pointer-shape", &Vx_mode_pointer_shape,
5815 doc: /* The shape of the pointer when over the mode line.
5816 This variable takes effect when you create a new frame
5817 or when you set the mouse color. */);
5818 #endif
5819 Vx_mode_pointer_shape = Qnil;
5821 DEFVAR_LISP ("x-sensitive-text-pointer-shape",
5822 &Vx_sensitive_text_pointer_shape,
5823 doc: /* The shape of the pointer when over mouse-sensitive text.
5824 This variable takes effect when you create a new frame
5825 or when you set the mouse color. */);
5826 Vx_sensitive_text_pointer_shape = Qnil;
5828 DEFVAR_LISP ("x-window-horizontal-drag-cursor",
5829 &Vx_window_horizontal_drag_shape,
5830 doc: /* Pointer shape to use for indicating a window can be dragged horizontally.
5831 This variable takes effect when you create a new frame
5832 or when you set the mouse color. */);
5833 Vx_window_horizontal_drag_shape = Qnil;
5835 DEFVAR_LISP ("x-cursor-fore-pixel", &Vx_cursor_fore_pixel,
5836 doc: /* A string indicating the foreground color of the cursor box. */);
5837 Vx_cursor_fore_pixel = Qnil;
5839 DEFVAR_LISP ("x-max-tooltip-size", &Vx_max_tooltip_size,
5840 doc: /* Maximum size for tooltips. Value is a pair (COLUMNS . ROWS).
5841 Text larger than this is clipped. */);
5842 Vx_max_tooltip_size = Fcons (make_number (80), make_number (40));
5844 DEFVAR_LISP ("x-no-window-manager", &Vx_no_window_manager,
5845 doc: /* Non-nil if no X window manager is in use.
5846 Emacs doesn't try to figure this out; this is always nil
5847 unless you set it to something else. */);
5848 /* We don't have any way to find this out, so set it to nil
5849 and maybe the user would like to set it to t. */
5850 Vx_no_window_manager = Qnil;
5852 DEFVAR_LISP ("x-pixel-size-width-font-regexp",
5853 &Vx_pixel_size_width_font_regexp,
5854 doc: /* Regexp matching a font name whose width is the same as `PIXEL_SIZE'.
5856 Since Emacs gets width of a font matching with this regexp from
5857 PIXEL_SIZE field of the name, font finding mechanism gets faster for
5858 such a font. This is especially effective for such large fonts as
5859 Chinese, Japanese, and Korean. */);
5860 Vx_pixel_size_width_font_regexp = Qnil;
5862 /* This is not ifdef:ed, so other builds than GTK can customize it. */
5863 DEFVAR_BOOL ("x-gtk-use-old-file-dialog", &x_gtk_use_old_file_dialog,
5864 doc: /* *Non-nil means prompt with the old GTK file selection dialog.
5865 If nil or if the file selection dialog is not available, the new GTK file
5866 chooser is used instead. To turn off all file dialogs set the
5867 variable `use-file-dialog'. */);
5868 x_gtk_use_old_file_dialog = 0;
5870 DEFVAR_BOOL ("x-gtk-show-hidden-files", &x_gtk_show_hidden_files,
5871 doc: /* *If non-nil, the GTK file chooser will by default show hidden files.
5872 Note that this is just the default, there is a toggle button on the file
5873 chooser to show or not show hidden files on a case by case basis. */);
5874 x_gtk_show_hidden_files = 0;
5876 DEFVAR_BOOL ("x-gtk-file-dialog-help-text", &x_gtk_file_dialog_help_text,
5877 doc: /* *If non-nil, the GTK file chooser will show additional help text.
5878 If more space for files in the file chooser dialog is wanted, set this to nil
5879 to turn the additional text off. */);
5880 x_gtk_file_dialog_help_text = 1;
5882 DEFVAR_BOOL ("x-gtk-whole-detached-tool-bar", &x_gtk_whole_detached_tool_bar,
5883 doc: /* *If non-nil, a detached tool bar is shown in full.
5884 The default is to just show an arrow and pressing on that arrow shows
5885 the tool bar buttons. */);
5886 x_gtk_whole_detached_tool_bar = 0;
5888 Fprovide (intern_c_string ("x"), Qnil);
5890 #ifdef USE_X_TOOLKIT
5891 Fprovide (intern_c_string ("x-toolkit"), Qnil);
5892 #ifdef USE_MOTIF
5893 Fprovide (intern_c_string ("motif"), Qnil);
5895 DEFVAR_LISP ("motif-version-string", &Vmotif_version_string,
5896 doc: /* Version info for LessTif/Motif. */);
5897 Vmotif_version_string = build_string (XmVERSION_STRING);
5898 #endif /* USE_MOTIF */
5899 #endif /* USE_X_TOOLKIT */
5901 #ifdef USE_GTK
5902 /* Provide x-toolkit also for GTK. Internally GTK does not use Xt so it
5903 is not an X toolkit in that sense (USE_X_TOOLKIT is not defined).
5904 But for a user it is a toolkit for X, and indeed, configure
5905 accepts --with-x-toolkit=gtk. */
5906 Fprovide (intern_c_string ("x-toolkit"), Qnil);
5907 Fprovide (intern_c_string ("gtk"), Qnil);
5909 DEFVAR_LISP ("gtk-version-string", &Vgtk_version_string,
5910 doc: /* Version info for GTK+. */);
5912 char gtk_version[40];
5913 g_snprintf (gtk_version, sizeof (gtk_version), "%u.%u.%u",
5914 GTK_MAJOR_VERSION, GTK_MINOR_VERSION, GTK_MICRO_VERSION);
5915 Vgtk_version_string = make_pure_string (gtk_version, strlen (gtk_version), strlen (gtk_version), 0);
5917 #endif /* USE_GTK */
5919 /* X window properties. */
5920 defsubr (&Sx_change_window_property);
5921 defsubr (&Sx_delete_window_property);
5922 defsubr (&Sx_window_property);
5924 defsubr (&Sxw_display_color_p);
5925 defsubr (&Sx_display_grayscale_p);
5926 defsubr (&Sxw_color_defined_p);
5927 defsubr (&Sxw_color_values);
5928 defsubr (&Sx_server_max_request_size);
5929 defsubr (&Sx_server_vendor);
5930 defsubr (&Sx_server_version);
5931 defsubr (&Sx_display_pixel_width);
5932 defsubr (&Sx_display_pixel_height);
5933 defsubr (&Sx_display_mm_width);
5934 defsubr (&Sx_display_mm_height);
5935 defsubr (&Sx_display_screens);
5936 defsubr (&Sx_display_planes);
5937 defsubr (&Sx_display_color_cells);
5938 defsubr (&Sx_display_visual_class);
5939 defsubr (&Sx_display_backing_store);
5940 defsubr (&Sx_display_save_under);
5941 defsubr (&Sx_wm_set_size_hint);
5942 defsubr (&Sx_create_frame);
5943 defsubr (&Sx_open_connection);
5944 defsubr (&Sx_close_connection);
5945 defsubr (&Sx_display_list);
5946 defsubr (&Sx_synchronize);
5947 defsubr (&Sx_focus_frame);
5948 defsubr (&Sx_backspace_delete_keys_p);
5950 /* Setting callback functions for fontset handler. */
5951 check_window_system_func = check_x;
5953 defsubr (&Sx_show_tip);
5954 defsubr (&Sx_hide_tip);
5955 tip_timer = Qnil;
5956 staticpro (&tip_timer);
5957 tip_frame = Qnil;
5958 staticpro (&tip_frame);
5960 last_show_tip_args = Qnil;
5961 staticpro (&last_show_tip_args);
5963 defsubr (&Sx_uses_old_gtk_dialog);
5964 #if defined (USE_MOTIF) || defined (USE_GTK)
5965 defsubr (&Sx_file_dialog);
5966 #endif
5968 #if defined (USE_GTK) && defined (HAVE_FREETYPE)
5969 defsubr (&Sx_select_font);
5970 x_last_font_name = NULL;
5971 #endif
5974 #endif /* HAVE_X_WINDOWS */
5976 /* arch-tag: 55040d02-5485-4d58-8b22-95a7a05f3288
5977 (do not change this comment) */