Add arch tagline
[emacs.git] / src / xfns.c
blob4492064622ade0c354da15edc59294286530a8a0
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 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3, or (at your option)
10 any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
20 Boston, MA 02110-1301, USA. */
22 #include <config.h>
23 #include <stdio.h>
24 #include <math.h>
26 #ifdef HAVE_UNISTD_H
27 #include <unistd.h>
28 #endif
30 /* This makes the fields of a Display accessible, in Xlib header files. */
32 #define XLIB_ILLEGAL_ACCESS
34 #include "lisp.h"
35 #include "xterm.h"
36 #include "frame.h"
37 #include "window.h"
38 #include "buffer.h"
39 #include "intervals.h"
40 #include "dispextern.h"
41 #include "keyboard.h"
42 #include "blockinput.h"
43 #include <epaths.h>
44 #include "charset.h"
45 #include "coding.h"
46 #include "fontset.h"
47 #include "systime.h"
48 #include "termhooks.h"
49 #include "atimer.h"
50 #include "termchar.h"
52 #ifdef HAVE_X_WINDOWS
54 #include <ctype.h>
55 #include <sys/types.h>
56 #include <sys/stat.h>
58 #ifndef VMS
59 #if 1 /* Used to be #ifdef EMACS_BITMAP_FILES, but this should always work. */
60 #include "bitmaps/gray.xbm"
61 #else
62 #include <X11/bitmaps/gray>
63 #endif
64 #else
65 #include "[.bitmaps]gray.xbm"
66 #endif
68 #ifdef USE_GTK
69 #include "gtkutil.h"
70 #endif
72 #ifdef USE_X_TOOLKIT
73 #include <X11/Shell.h>
75 #ifndef USE_MOTIF
76 #ifdef HAVE_XAW3D
77 #include <X11/Xaw3d/Paned.h>
78 #include <X11/Xaw3d/Label.h>
79 #else /* !HAVE_XAW3D */
80 #include <X11/Xaw/Paned.h>
81 #include <X11/Xaw/Label.h>
82 #endif /* HAVE_XAW3D */
83 #endif /* USE_MOTIF */
85 #ifdef USG
86 #undef USG /* ####KLUDGE for Solaris 2.2 and up */
87 #include <X11/Xos.h>
88 #define USG
89 #else
90 #include <X11/Xos.h>
91 #endif
93 #include "widget.h"
95 #include "../lwlib/lwlib.h"
97 #ifdef USE_MOTIF
98 #include <Xm/Xm.h>
99 #include <Xm/DialogS.h>
100 #include <Xm/FileSB.h>
101 #endif
103 /* Do the EDITRES protocol if running X11R5
104 Exception: HP-UX (at least version A.09.05) has X11R5 without EditRes */
106 #if (XtSpecificationRelease >= 5) && !defined(NO_EDITRES)
107 #define HACK_EDITRES
108 extern void _XEditResCheckMessages ();
109 #endif /* R5 + Athena */
111 /* Unique id counter for widgets created by the Lucid Widget Library. */
113 extern LWLIB_ID widget_id_tick;
115 #ifdef USE_LUCID
116 /* This is part of a kludge--see lwlib/xlwmenu.c. */
117 extern XFontStruct *xlwmenu_default_font;
118 #endif
120 extern void free_frame_menubar ();
121 extern double atof ();
123 #ifdef USE_MOTIF
125 /* LessTif/Motif version info. */
127 static Lisp_Object Vmotif_version_string;
129 #endif /* USE_MOTIF */
131 #endif /* USE_X_TOOLKIT */
133 #ifdef USE_GTK
135 /* GTK+ version info */
137 static Lisp_Object Vgtk_version_string;
139 #endif /* USE_GTK */
141 #ifdef HAVE_X11R4
142 #define MAXREQUEST(dpy) (XMaxRequestSize (dpy))
143 #else
144 #define MAXREQUEST(dpy) ((dpy)->max_request_size)
145 #endif
147 /* The gray bitmap `bitmaps/gray'. This is done because xterm.c uses
148 it, and including `bitmaps/gray' more than once is a problem when
149 config.h defines `static' as an empty replacement string. */
151 int gray_bitmap_width = gray_width;
152 int gray_bitmap_height = gray_height;
153 char *gray_bitmap_bits = gray_bits;
155 /* Non-zero means we're allowed to display an hourglass cursor. */
157 int display_hourglass_p;
159 /* Non-zero means prompt with the old GTK file selection dialog. */
161 int x_gtk_use_old_file_dialog;
163 /* If non-zero, by default show hidden files in the GTK file chooser. */
165 int x_gtk_show_hidden_files;
167 /* If non-zero, don't show additional help text in the GTK file chooser. */
169 int x_gtk_file_dialog_help_text;
171 /* If non-zero, don't collapse to tool bar when it is detached. */
173 int x_gtk_whole_detached_tool_bar;
175 /* The background and shape of the mouse pointer, and shape when not
176 over text or in the modeline. */
178 Lisp_Object Vx_pointer_shape, Vx_nontext_pointer_shape, Vx_mode_pointer_shape;
179 Lisp_Object Vx_hourglass_pointer_shape;
181 /* The shape when over mouse-sensitive text. */
183 Lisp_Object Vx_sensitive_text_pointer_shape;
185 /* If non-nil, the pointer shape to indicate that windows can be
186 dragged horizontally. */
188 Lisp_Object Vx_window_horizontal_drag_shape;
190 /* Color of chars displayed in cursor box. */
192 Lisp_Object Vx_cursor_fore_pixel;
194 /* Nonzero if using X. */
196 static int x_in_use;
198 /* Non nil if no window manager is in use. */
200 Lisp_Object Vx_no_window_manager;
202 /* Regexp matching a font name whose width is the same as `PIXEL_SIZE'. */
204 Lisp_Object Vx_pixel_size_width_font_regexp;
206 Lisp_Object Qnone;
207 Lisp_Object Qsuppress_icon;
208 Lisp_Object Qundefined_color;
209 Lisp_Object Qcompound_text, Qcancel_timer;
211 /* In dispnew.c */
213 extern Lisp_Object Vwindow_system_version;
215 /* The below are defined in frame.c. */
217 #if GLYPH_DEBUG
218 int image_cache_refcount, dpyinfo_refcount;
219 #endif
223 /* Error if we are not connected to X. */
225 void
226 check_x ()
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 ()
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 (frame)
246 Lisp_Object frame;
248 FRAME_PTR f;
250 if (NILP (frame))
251 frame = selected_frame;
252 CHECK_LIVE_FRAME (frame);
253 f = XFRAME (frame);
254 if (! FRAME_X_P (f))
255 error ("Non-X frame used");
256 return f;
259 /* Let the user specify an X display with a Lisp object.
260 OBJECT may be nil, a frame or a terminal id.
261 nil stands for the selected frame--or, if that is not an X frame,
262 the first X display on the list. */
264 struct x_display_info *
265 check_x_display_info (object)
266 Lisp_Object object;
268 struct x_display_info *dpyinfo = NULL;
270 if (NILP (object))
272 struct frame *sf = XFRAME (selected_frame);
274 if (FRAME_X_P (sf) && FRAME_LIVE_P (sf))
275 dpyinfo = FRAME_X_DISPLAY_INFO (sf);
276 else if (x_display_list != 0)
277 dpyinfo = x_display_list;
278 else
279 error ("X windows are not in use or not initialized");
281 else if (INTEGERP (object))
283 struct terminal *t = get_terminal (object, 1);
285 if (t->type != output_x_window)
286 error ("Terminal %d is not an X display", XINT (object));
288 dpyinfo = t->display_info.x;
290 else if (STRINGP (object))
291 dpyinfo = x_display_info_for_name (object);
292 else
294 FRAME_PTR f = check_x_frame (object);
295 dpyinfo = FRAME_X_DISPLAY_INFO (f);
298 return dpyinfo;
302 /* Return the Emacs frame-object corresponding to an X window.
303 It could be the frame's main window or an icon window. */
305 /* This function can be called during GC, so use GC_xxx type test macros. */
307 struct frame *
308 x_window_to_frame (dpyinfo, wdesc)
309 struct x_display_info *dpyinfo;
310 int wdesc;
312 Lisp_Object tail, frame;
313 struct frame *f;
315 if (wdesc == None) return 0;
317 for (tail = Vframe_list; GC_CONSP (tail); tail = XCDR (tail))
319 frame = XCAR (tail);
320 if (!GC_FRAMEP (frame))
321 continue;
322 f = XFRAME (frame);
323 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
324 continue;
325 if (f->output_data.x->hourglass_window == wdesc)
326 return f;
327 #ifdef USE_X_TOOLKIT
328 if ((f->output_data.x->edit_widget
329 && XtWindow (f->output_data.x->edit_widget) == wdesc)
330 /* A tooltip frame? */
331 || (!f->output_data.x->edit_widget
332 && FRAME_X_WINDOW (f) == wdesc)
333 || f->output_data.x->icon_desc == wdesc)
334 return f;
335 #else /* not USE_X_TOOLKIT */
336 #ifdef USE_GTK
337 if (f->output_data.x->edit_widget)
339 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
340 struct x_output *x = f->output_data.x;
341 if (gwdesc != 0 && gwdesc == x->edit_widget)
342 return f;
344 #endif /* USE_GTK */
345 if (FRAME_X_WINDOW (f) == wdesc
346 || f->output_data.x->icon_desc == wdesc)
347 return f;
348 #endif /* not USE_X_TOOLKIT */
350 return 0;
353 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
354 /* Like x_window_to_frame but also compares the window with the widget's
355 windows. */
357 struct frame *
358 x_any_window_to_frame (dpyinfo, wdesc)
359 struct x_display_info *dpyinfo;
360 int wdesc;
362 Lisp_Object tail, frame;
363 struct frame *f, *found;
364 struct x_output *x;
366 if (wdesc == None) return NULL;
368 found = NULL;
369 for (tail = Vframe_list; GC_CONSP (tail) && !found; tail = XCDR (tail))
371 frame = XCAR (tail);
372 if (!GC_FRAMEP (frame))
373 continue;
375 f = XFRAME (frame);
376 if (FRAME_X_P (f) && FRAME_X_DISPLAY_INFO (f) == dpyinfo)
378 /* This frame matches if the window is any of its widgets. */
379 x = f->output_data.x;
380 if (x->hourglass_window == wdesc)
381 found = f;
382 else if (x->widget)
384 #ifdef USE_GTK
385 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
386 if (gwdesc != 0
387 && (gwdesc == x->widget
388 || gwdesc == x->edit_widget
389 || gwdesc == x->vbox_widget
390 || gwdesc == x->menubar_widget))
391 found = f;
392 #else
393 if (wdesc == XtWindow (x->widget)
394 || wdesc == XtWindow (x->column_widget)
395 || wdesc == XtWindow (x->edit_widget))
396 found = f;
397 /* Match if the window is this frame's menubar. */
398 else if (lw_window_is_in_menubar (wdesc, x->menubar_widget))
399 found = f;
400 #endif
402 else if (FRAME_X_WINDOW (f) == wdesc)
403 /* A tooltip frame. */
404 found = f;
408 return found;
411 /* Likewise, but exclude the menu bar widget. */
413 struct frame *
414 x_non_menubar_window_to_frame (dpyinfo, wdesc)
415 struct x_display_info *dpyinfo;
416 int wdesc;
418 Lisp_Object tail, frame;
419 struct frame *f;
420 struct x_output *x;
422 if (wdesc == None) return 0;
424 for (tail = Vframe_list; GC_CONSP (tail); tail = XCDR (tail))
426 frame = XCAR (tail);
427 if (!GC_FRAMEP (frame))
428 continue;
429 f = XFRAME (frame);
430 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
431 continue;
432 x = f->output_data.x;
433 /* This frame matches if the window is any of its widgets. */
434 if (x->hourglass_window == wdesc)
435 return f;
436 else if (x->widget)
438 #ifdef USE_GTK
439 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
440 if (gwdesc != 0
441 && (gwdesc == x->widget
442 || gwdesc == x->edit_widget
443 || gwdesc == x->vbox_widget))
444 return f;
445 #else
446 if (wdesc == XtWindow (x->widget)
447 || wdesc == XtWindow (x->column_widget)
448 || wdesc == XtWindow (x->edit_widget))
449 return f;
450 #endif
452 else if (FRAME_X_WINDOW (f) == wdesc)
453 /* A tooltip frame. */
454 return f;
456 return 0;
459 /* Likewise, but consider only the menu bar widget. */
461 struct frame *
462 x_menubar_window_to_frame (dpyinfo, wdesc)
463 struct x_display_info *dpyinfo;
464 int wdesc;
466 Lisp_Object tail, frame;
467 struct frame *f;
468 struct x_output *x;
470 if (wdesc == None) return 0;
472 for (tail = Vframe_list; GC_CONSP (tail); tail = XCDR (tail))
474 frame = XCAR (tail);
475 if (!GC_FRAMEP (frame))
476 continue;
477 f = XFRAME (frame);
478 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
479 continue;
480 x = f->output_data.x;
481 /* Match if the window is this frame's menubar. */
482 #ifdef USE_GTK
483 if (x->menubar_widget)
485 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
486 int found = 0;
488 BLOCK_INPUT;
489 if (gwdesc != 0
490 && (gwdesc == x->menubar_widget
491 || gtk_widget_get_parent (gwdesc) == x->menubar_widget))
492 found = 1;
493 UNBLOCK_INPUT;
494 if (found) return f;
496 #else
497 if (x->menubar_widget
498 && lw_window_is_in_menubar (wdesc, x->menubar_widget))
499 return f;
500 #endif
502 return 0;
505 /* Return the frame whose principal (outermost) window is WDESC.
506 If WDESC is some other (smaller) window, we return 0. */
508 struct frame *
509 x_top_window_to_frame (dpyinfo, wdesc)
510 struct x_display_info *dpyinfo;
511 int wdesc;
513 Lisp_Object tail, frame;
514 struct frame *f;
515 struct x_output *x;
517 if (wdesc == None) return 0;
519 for (tail = Vframe_list; GC_CONSP (tail); tail = XCDR (tail))
521 frame = XCAR (tail);
522 if (!GC_FRAMEP (frame))
523 continue;
524 f = XFRAME (frame);
525 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
526 continue;
527 x = f->output_data.x;
529 if (x->widget)
531 /* This frame matches if the window is its topmost widget. */
532 #ifdef USE_GTK
533 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
534 if (gwdesc == x->widget)
535 return f;
536 #else
537 if (wdesc == XtWindow (x->widget))
538 return f;
539 #if 0 /* I don't know why it did this,
540 but it seems logically wrong,
541 and it causes trouble for MapNotify events. */
542 /* Match if the window is this frame's menubar. */
543 if (x->menubar_widget
544 && wdesc == XtWindow (x->menubar_widget))
545 return f;
546 #endif
547 #endif
549 else if (FRAME_X_WINDOW (f) == wdesc)
550 /* Tooltip frame. */
551 return f;
553 return 0;
555 #endif /* USE_X_TOOLKIT || USE_GTK */
559 static Lisp_Object unwind_create_frame P_ ((Lisp_Object));
560 static Lisp_Object unwind_create_tip_frame P_ ((Lisp_Object));
562 void x_set_foreground_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
563 static void x_set_wait_for_wm P_ ((struct frame *, Lisp_Object, Lisp_Object));
564 void x_set_background_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
565 void x_set_mouse_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
566 void x_set_cursor_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
567 void x_set_border_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
568 void x_set_cursor_type P_ ((struct frame *, Lisp_Object, Lisp_Object));
569 void x_set_icon_type P_ ((struct frame *, Lisp_Object, Lisp_Object));
570 void x_set_icon_name P_ ((struct frame *, Lisp_Object, Lisp_Object));
571 void x_explicitly_set_name P_ ((struct frame *, Lisp_Object, Lisp_Object));
572 void x_set_menu_bar_lines P_ ((struct frame *, Lisp_Object, Lisp_Object));
573 void x_set_title P_ ((struct frame *, Lisp_Object, Lisp_Object));
574 void x_set_tool_bar_lines P_ ((struct frame *, Lisp_Object, Lisp_Object));
575 void x_set_scroll_bar_foreground P_ ((struct frame *, Lisp_Object,
576 Lisp_Object));
577 void x_set_scroll_bar_background P_ ((struct frame *, Lisp_Object,
578 Lisp_Object));
579 static Lisp_Object x_default_scroll_bar_color_parameter P_ ((struct frame *,
580 Lisp_Object,
581 Lisp_Object,
582 char *, char *,
583 int));
586 /* Store the screen positions of frame F into XPTR and YPTR.
587 These are the positions of the containing window manager window,
588 not Emacs's own window. */
590 void
591 x_real_positions (f, xptr, yptr)
592 FRAME_PTR f;
593 int *xptr, *yptr;
595 int win_x, win_y, outer_x, outer_y;
596 int real_x = 0, real_y = 0;
597 int had_errors = 0;
598 Window win = f->output_data.x->parent_desc;
600 BLOCK_INPUT;
602 x_catch_errors (FRAME_X_DISPLAY (f));
604 if (win == FRAME_X_DISPLAY_INFO (f)->root_window)
605 win = FRAME_OUTER_WINDOW (f);
607 /* This loop traverses up the containment tree until we hit the root
608 window. Window managers may intersect many windows between our window
609 and the root window. The window we find just before the root window
610 should be the outer WM window. */
611 for (;;)
613 Window wm_window, rootw;
614 Window *tmp_children;
615 unsigned int tmp_nchildren;
616 int success;
618 success = XQueryTree (FRAME_X_DISPLAY (f), win, &rootw,
619 &wm_window, &tmp_children, &tmp_nchildren);
621 had_errors = x_had_errors_p (FRAME_X_DISPLAY (f));
623 /* Don't free tmp_children if XQueryTree failed. */
624 if (! success)
625 break;
627 XFree ((char *) tmp_children);
629 if (wm_window == rootw || had_errors)
630 break;
632 win = wm_window;
635 if (! had_errors)
637 unsigned int ign;
638 Window child, rootw;
640 /* Get the real coordinates for the WM window upper left corner */
641 XGetGeometry (FRAME_X_DISPLAY (f), win,
642 &rootw, &real_x, &real_y, &ign, &ign, &ign, &ign);
644 /* Translate real coordinates to coordinates relative to our
645 window. For our window, the upper left corner is 0, 0.
646 Since the upper left corner of the WM window is outside
647 our window, win_x and win_y will be negative:
649 ------------------ ---> x
650 | title |
651 | ----------------- v y
652 | | our window
654 XTranslateCoordinates (FRAME_X_DISPLAY (f),
656 /* From-window, to-window. */
657 FRAME_X_DISPLAY_INFO (f)->root_window,
658 FRAME_X_WINDOW (f),
660 /* From-position, to-position. */
661 real_x, real_y, &win_x, &win_y,
663 /* Child of win. */
664 &child);
666 if (FRAME_X_WINDOW (f) == FRAME_OUTER_WINDOW (f))
668 outer_x = win_x;
669 outer_y = win_y;
671 else
673 XTranslateCoordinates (FRAME_X_DISPLAY (f),
675 /* From-window, to-window. */
676 FRAME_X_DISPLAY_INFO (f)->root_window,
677 FRAME_OUTER_WINDOW (f),
679 /* From-position, to-position. */
680 real_x, real_y, &outer_x, &outer_y,
682 /* Child of win. */
683 &child);
686 had_errors = x_had_errors_p (FRAME_X_DISPLAY (f));
689 x_uncatch_errors ();
691 UNBLOCK_INPUT;
693 if (had_errors) return;
695 f->x_pixels_diff = -win_x;
696 f->y_pixels_diff = -win_y;
698 FRAME_X_OUTPUT (f)->x_pixels_outer_diff = -outer_x;
699 FRAME_X_OUTPUT (f)->y_pixels_outer_diff = -outer_y;
701 *xptr = real_x;
702 *yptr = real_y;
708 /* Gamma-correct COLOR on frame F. */
710 void
711 gamma_correct (f, color)
712 struct frame *f;
713 XColor *color;
715 if (f->gamma)
717 color->red = pow (color->red / 65535.0, f->gamma) * 65535.0 + 0.5;
718 color->green = pow (color->green / 65535.0, f->gamma) * 65535.0 + 0.5;
719 color->blue = pow (color->blue / 65535.0, f->gamma) * 65535.0 + 0.5;
724 /* Decide if color named COLOR_NAME is valid for use on frame F. If
725 so, return the RGB values in COLOR. If ALLOC_P is non-zero,
726 allocate the color. Value is zero if COLOR_NAME is invalid, or
727 no color could be allocated. */
730 x_defined_color (f, color_name, color, alloc_p)
731 struct frame *f;
732 char *color_name;
733 XColor *color;
734 int alloc_p;
736 int success_p;
737 Display *dpy = FRAME_X_DISPLAY (f);
738 Colormap cmap = FRAME_X_COLORMAP (f);
740 BLOCK_INPUT;
741 success_p = XParseColor (dpy, cmap, color_name, color);
742 if (success_p && alloc_p)
743 success_p = x_alloc_nearest_color (f, cmap, color);
744 UNBLOCK_INPUT;
746 return success_p;
750 /* Return the pixel color value for color COLOR_NAME on frame F. If F
751 is a monochrome frame, return MONO_COLOR regardless of what ARG says.
752 Signal an error if color can't be allocated. */
755 x_decode_color (f, color_name, mono_color)
756 FRAME_PTR f;
757 Lisp_Object color_name;
758 int mono_color;
760 XColor cdef;
762 CHECK_STRING (color_name);
764 #if 0 /* Don't do this. It's wrong when we're not using the default
765 colormap, it makes freeing difficult, and it's probably not
766 an important optimization. */
767 if (strcmp (SDATA (color_name), "black") == 0)
768 return BLACK_PIX_DEFAULT (f);
769 else if (strcmp (SDATA (color_name), "white") == 0)
770 return WHITE_PIX_DEFAULT (f);
771 #endif
773 /* Return MONO_COLOR for monochrome frames. */
774 if (FRAME_X_DISPLAY_INFO (f)->n_planes == 1)
775 return mono_color;
777 /* x_defined_color is responsible for coping with failures
778 by looking for a near-miss. */
779 if (x_defined_color (f, SDATA (color_name), &cdef, 1))
780 return cdef.pixel;
782 signal_error ("Undefined color", color_name);
787 /* Change the `wait-for-wm' frame parameter of frame F. OLD_VALUE is
788 the previous value of that parameter, NEW_VALUE is the new value.
789 See also the comment of wait_for_wm in struct x_output. */
791 static void
792 x_set_wait_for_wm (f, new_value, old_value)
793 struct frame *f;
794 Lisp_Object new_value, old_value;
796 f->output_data.x->wait_for_wm = !NILP (new_value);
799 #ifdef USE_GTK
801 /* Set icon from FILE for frame F. By using GTK functions the icon
802 may be any format that GdkPixbuf knows about, i.e. not just bitmaps. */
805 xg_set_icon (f, file)
806 FRAME_PTR f;
807 Lisp_Object file;
809 int result = 0;
810 Lisp_Object found;
812 found = x_find_image_file (file);
814 if (! NILP (found))
816 GdkPixbuf *pixbuf;
817 GError *err = NULL;
818 char *filename = (char *) SDATA (found);
819 BLOCK_INPUT;
821 pixbuf = gdk_pixbuf_new_from_file (filename, &err);
823 if (pixbuf)
825 gtk_window_set_icon (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)),
826 pixbuf);
827 g_object_unref (pixbuf);
829 result = 1;
831 else
832 g_error_free (err);
834 UNBLOCK_INPUT;
837 return result;
841 xg_set_icon_from_xpm_data (f, data)
842 FRAME_PTR f;
843 char **data;
845 int result = 0;
846 GdkPixbuf *pixbuf = gdk_pixbuf_new_from_xpm_data ((const char **) data);
848 if (!pixbuf)
849 return 0;
851 gtk_window_set_icon (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)), pixbuf);
852 g_object_unref (pixbuf);
853 return 1;
855 #endif /* USE_GTK */
858 /* Functions called only from `x_set_frame_param'
859 to set individual parameters.
861 If FRAME_X_WINDOW (f) is 0,
862 the frame is being created and its X-window does not exist yet.
863 In that case, just record the parameter's new value
864 in the standard place; do not attempt to change the window. */
866 void
867 x_set_foreground_color (f, arg, oldval)
868 struct frame *f;
869 Lisp_Object arg, oldval;
871 struct x_output *x = f->output_data.x;
872 unsigned long fg, old_fg;
874 fg = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
875 old_fg = FRAME_FOREGROUND_PIXEL (f);
876 FRAME_FOREGROUND_PIXEL (f) = fg;
878 if (FRAME_X_WINDOW (f) != 0)
880 Display *dpy = FRAME_X_DISPLAY (f);
882 BLOCK_INPUT;
883 XSetForeground (dpy, x->normal_gc, fg);
884 XSetBackground (dpy, x->reverse_gc, fg);
886 if (x->cursor_pixel == old_fg)
888 unload_color (f, x->cursor_pixel);
889 x->cursor_pixel = x_copy_color (f, fg);
890 XSetBackground (dpy, x->cursor_gc, x->cursor_pixel);
893 UNBLOCK_INPUT;
895 update_face_from_frame_parameter (f, Qforeground_color, arg);
897 if (FRAME_VISIBLE_P (f))
898 redraw_frame (f);
901 unload_color (f, old_fg);
904 void
905 x_set_background_color (f, arg, oldval)
906 struct frame *f;
907 Lisp_Object arg, oldval;
909 struct x_output *x = f->output_data.x;
910 unsigned long bg;
912 bg = x_decode_color (f, arg, WHITE_PIX_DEFAULT (f));
913 unload_color (f, FRAME_BACKGROUND_PIXEL (f));
914 FRAME_BACKGROUND_PIXEL (f) = bg;
916 if (FRAME_X_WINDOW (f) != 0)
918 Display *dpy = FRAME_X_DISPLAY (f);
920 BLOCK_INPUT;
921 XSetBackground (dpy, x->normal_gc, bg);
922 XSetForeground (dpy, x->reverse_gc, bg);
923 XSetWindowBackground (dpy, FRAME_X_WINDOW (f), bg);
924 XSetForeground (dpy, x->cursor_gc, bg);
926 #ifdef USE_GTK
927 xg_set_background_color (f, bg);
928 #endif
930 #ifndef USE_TOOLKIT_SCROLL_BARS /* Turns out to be annoying with
931 toolkit scroll bars. */
933 Lisp_Object bar;
934 for (bar = FRAME_SCROLL_BARS (f);
935 !NILP (bar);
936 bar = XSCROLL_BAR (bar)->next)
938 Window window = SCROLL_BAR_X_WINDOW (XSCROLL_BAR (bar));
939 XSetWindowBackground (dpy, window, bg);
942 #endif /* USE_TOOLKIT_SCROLL_BARS */
944 UNBLOCK_INPUT;
945 update_face_from_frame_parameter (f, Qbackground_color, arg);
947 if (FRAME_VISIBLE_P (f))
948 redraw_frame (f);
952 void
953 x_set_mouse_color (f, arg, oldval)
954 struct frame *f;
955 Lisp_Object arg, oldval;
957 struct x_output *x = f->output_data.x;
958 Display *dpy = FRAME_X_DISPLAY (f);
959 Cursor cursor, nontext_cursor, mode_cursor, hand_cursor;
960 Cursor hourglass_cursor, horizontal_drag_cursor;
961 unsigned long pixel = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
962 unsigned long mask_color = FRAME_BACKGROUND_PIXEL (f);
964 /* Don't let pointers be invisible. */
965 if (mask_color == pixel)
967 x_free_colors (f, &pixel, 1);
968 pixel = x_copy_color (f, FRAME_FOREGROUND_PIXEL (f));
971 unload_color (f, x->mouse_pixel);
972 x->mouse_pixel = pixel;
974 BLOCK_INPUT;
976 /* It's not okay to crash if the user selects a screwy cursor. */
977 x_catch_errors (dpy);
979 if (!NILP (Vx_pointer_shape))
981 CHECK_NUMBER (Vx_pointer_shape);
982 cursor = XCreateFontCursor (dpy, XINT (Vx_pointer_shape));
984 else
985 cursor = XCreateFontCursor (dpy, XC_xterm);
986 x_check_errors (dpy, "bad text pointer cursor: %s");
988 if (!NILP (Vx_nontext_pointer_shape))
990 CHECK_NUMBER (Vx_nontext_pointer_shape);
991 nontext_cursor
992 = XCreateFontCursor (dpy, XINT (Vx_nontext_pointer_shape));
994 else
995 nontext_cursor = XCreateFontCursor (dpy, XC_left_ptr);
996 x_check_errors (dpy, "bad nontext pointer cursor: %s");
998 if (!NILP (Vx_hourglass_pointer_shape))
1000 CHECK_NUMBER (Vx_hourglass_pointer_shape);
1001 hourglass_cursor
1002 = XCreateFontCursor (dpy, XINT (Vx_hourglass_pointer_shape));
1004 else
1005 hourglass_cursor = XCreateFontCursor (dpy, XC_watch);
1006 x_check_errors (dpy, "bad hourglass pointer cursor: %s");
1008 if (!NILP (Vx_mode_pointer_shape))
1010 CHECK_NUMBER (Vx_mode_pointer_shape);
1011 mode_cursor = XCreateFontCursor (dpy, XINT (Vx_mode_pointer_shape));
1013 else
1014 mode_cursor = XCreateFontCursor (dpy, XC_xterm);
1015 x_check_errors (dpy, "bad modeline pointer cursor: %s");
1017 if (!NILP (Vx_sensitive_text_pointer_shape))
1019 CHECK_NUMBER (Vx_sensitive_text_pointer_shape);
1020 hand_cursor
1021 = XCreateFontCursor (dpy, XINT (Vx_sensitive_text_pointer_shape));
1023 else
1024 hand_cursor = XCreateFontCursor (dpy, XC_hand2);
1026 if (!NILP (Vx_window_horizontal_drag_shape))
1028 CHECK_NUMBER (Vx_window_horizontal_drag_shape);
1029 horizontal_drag_cursor
1030 = XCreateFontCursor (dpy, XINT (Vx_window_horizontal_drag_shape));
1032 else
1033 horizontal_drag_cursor
1034 = XCreateFontCursor (dpy, XC_sb_h_double_arrow);
1036 /* Check and report errors with the above calls. */
1037 x_check_errors (dpy, "can't set cursor shape: %s");
1038 x_uncatch_errors ();
1041 XColor fore_color, back_color;
1043 fore_color.pixel = x->mouse_pixel;
1044 x_query_color (f, &fore_color);
1045 back_color.pixel = mask_color;
1046 x_query_color (f, &back_color);
1048 XRecolorCursor (dpy, cursor, &fore_color, &back_color);
1049 XRecolorCursor (dpy, nontext_cursor, &fore_color, &back_color);
1050 XRecolorCursor (dpy, mode_cursor, &fore_color, &back_color);
1051 XRecolorCursor (dpy, hand_cursor, &fore_color, &back_color);
1052 XRecolorCursor (dpy, hourglass_cursor, &fore_color, &back_color);
1053 XRecolorCursor (dpy, horizontal_drag_cursor, &fore_color, &back_color);
1056 if (FRAME_X_WINDOW (f) != 0)
1057 XDefineCursor (dpy, FRAME_X_WINDOW (f), cursor);
1059 if (cursor != x->text_cursor
1060 && x->text_cursor != 0)
1061 XFreeCursor (dpy, x->text_cursor);
1062 x->text_cursor = cursor;
1064 if (nontext_cursor != x->nontext_cursor
1065 && x->nontext_cursor != 0)
1066 XFreeCursor (dpy, x->nontext_cursor);
1067 x->nontext_cursor = nontext_cursor;
1069 if (hourglass_cursor != x->hourglass_cursor
1070 && x->hourglass_cursor != 0)
1071 XFreeCursor (dpy, x->hourglass_cursor);
1072 x->hourglass_cursor = hourglass_cursor;
1074 if (mode_cursor != x->modeline_cursor
1075 && x->modeline_cursor != 0)
1076 XFreeCursor (dpy, f->output_data.x->modeline_cursor);
1077 x->modeline_cursor = mode_cursor;
1079 if (hand_cursor != x->hand_cursor
1080 && x->hand_cursor != 0)
1081 XFreeCursor (dpy, x->hand_cursor);
1082 x->hand_cursor = hand_cursor;
1084 if (horizontal_drag_cursor != x->horizontal_drag_cursor
1085 && x->horizontal_drag_cursor != 0)
1086 XFreeCursor (dpy, x->horizontal_drag_cursor);
1087 x->horizontal_drag_cursor = horizontal_drag_cursor;
1089 XFlush (dpy);
1090 UNBLOCK_INPUT;
1092 update_face_from_frame_parameter (f, Qmouse_color, arg);
1095 void
1096 x_set_cursor_color (f, arg, oldval)
1097 struct frame *f;
1098 Lisp_Object arg, oldval;
1100 unsigned long fore_pixel, pixel;
1101 int fore_pixel_allocated_p = 0, pixel_allocated_p = 0;
1102 struct x_output *x = f->output_data.x;
1104 if (!NILP (Vx_cursor_fore_pixel))
1106 fore_pixel = x_decode_color (f, Vx_cursor_fore_pixel,
1107 WHITE_PIX_DEFAULT (f));
1108 fore_pixel_allocated_p = 1;
1110 else
1111 fore_pixel = FRAME_BACKGROUND_PIXEL (f);
1113 pixel = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
1114 pixel_allocated_p = 1;
1116 /* Make sure that the cursor color differs from the background color. */
1117 if (pixel == FRAME_BACKGROUND_PIXEL (f))
1119 if (pixel_allocated_p)
1121 x_free_colors (f, &pixel, 1);
1122 pixel_allocated_p = 0;
1125 pixel = x->mouse_pixel;
1126 if (pixel == fore_pixel)
1128 if (fore_pixel_allocated_p)
1130 x_free_colors (f, &fore_pixel, 1);
1131 fore_pixel_allocated_p = 0;
1133 fore_pixel = FRAME_BACKGROUND_PIXEL (f);
1137 unload_color (f, x->cursor_foreground_pixel);
1138 if (!fore_pixel_allocated_p)
1139 fore_pixel = x_copy_color (f, fore_pixel);
1140 x->cursor_foreground_pixel = fore_pixel;
1142 unload_color (f, x->cursor_pixel);
1143 if (!pixel_allocated_p)
1144 pixel = x_copy_color (f, pixel);
1145 x->cursor_pixel = pixel;
1147 if (FRAME_X_WINDOW (f) != 0)
1149 BLOCK_INPUT;
1150 XSetBackground (FRAME_X_DISPLAY (f), x->cursor_gc, x->cursor_pixel);
1151 XSetForeground (FRAME_X_DISPLAY (f), x->cursor_gc, fore_pixel);
1152 UNBLOCK_INPUT;
1154 if (FRAME_VISIBLE_P (f))
1156 x_update_cursor (f, 0);
1157 x_update_cursor (f, 1);
1161 update_face_from_frame_parameter (f, Qcursor_color, arg);
1164 /* Set the border-color of frame F to pixel value PIX.
1165 Note that this does not fully take effect if done before
1166 F has an x-window. */
1168 void
1169 x_set_border_pixel (f, pix)
1170 struct frame *f;
1171 int pix;
1173 unload_color (f, f->output_data.x->border_pixel);
1174 f->output_data.x->border_pixel = pix;
1176 if (FRAME_X_WINDOW (f) != 0 && f->border_width > 0)
1178 BLOCK_INPUT;
1179 XSetWindowBorder (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1180 (unsigned long)pix);
1181 UNBLOCK_INPUT;
1183 if (FRAME_VISIBLE_P (f))
1184 redraw_frame (f);
1188 /* Set the border-color of frame F to value described by ARG.
1189 ARG can be a string naming a color.
1190 The border-color is used for the border that is drawn by the X server.
1191 Note that this does not fully take effect if done before
1192 F has an x-window; it must be redone when the window is created.
1194 Note: this is done in two routines because of the way X10 works.
1196 Note: under X11, this is normally the province of the window manager,
1197 and so emacs' border colors may be overridden. */
1199 void
1200 x_set_border_color (f, arg, oldval)
1201 struct frame *f;
1202 Lisp_Object arg, oldval;
1204 int pix;
1206 CHECK_STRING (arg);
1207 pix = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
1208 x_set_border_pixel (f, pix);
1209 update_face_from_frame_parameter (f, Qborder_color, arg);
1213 void
1214 x_set_cursor_type (f, arg, oldval)
1215 FRAME_PTR f;
1216 Lisp_Object arg, oldval;
1218 set_frame_cursor_types (f, arg);
1220 /* Make sure the cursor gets redrawn. */
1221 cursor_type_changed = 1;
1224 void
1225 x_set_icon_type (f, arg, oldval)
1226 struct frame *f;
1227 Lisp_Object arg, oldval;
1229 int result;
1231 if (STRINGP (arg))
1233 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
1234 return;
1236 else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
1237 return;
1239 BLOCK_INPUT;
1240 if (NILP (arg))
1241 result = x_text_icon (f,
1242 (char *) SDATA ((!NILP (f->icon_name)
1243 ? f->icon_name
1244 : f->name)));
1245 else
1246 result = x_bitmap_icon (f, arg);
1248 if (result)
1250 UNBLOCK_INPUT;
1251 error ("No icon window available");
1254 XFlush (FRAME_X_DISPLAY (f));
1255 UNBLOCK_INPUT;
1258 void
1259 x_set_icon_name (f, arg, oldval)
1260 struct frame *f;
1261 Lisp_Object arg, oldval;
1263 int result;
1265 if (STRINGP (arg))
1267 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
1268 return;
1270 else if (!NILP (arg) || NILP (oldval))
1271 return;
1273 f->icon_name = arg;
1275 if (f->output_data.x->icon_bitmap != 0)
1276 return;
1278 BLOCK_INPUT;
1280 result = x_text_icon (f,
1281 (char *) SDATA ((!NILP (f->icon_name)
1282 ? f->icon_name
1283 : !NILP (f->title)
1284 ? f->title
1285 : f->name)));
1287 if (result)
1289 UNBLOCK_INPUT;
1290 error ("No icon window available");
1293 XFlush (FRAME_X_DISPLAY (f));
1294 UNBLOCK_INPUT;
1298 void
1299 x_set_menu_bar_lines (f, value, oldval)
1300 struct frame *f;
1301 Lisp_Object value, oldval;
1303 int nlines;
1304 #if ! defined (USE_X_TOOLKIT) && ! defined (USE_GTK)
1305 int olines = FRAME_MENU_BAR_LINES (f);
1306 #endif
1308 /* Right now, menu bars don't work properly in minibuf-only frames;
1309 most of the commands try to apply themselves to the minibuffer
1310 frame itself, and get an error because you can't switch buffers
1311 in or split the minibuffer window. */
1312 if (FRAME_MINIBUF_ONLY_P (f))
1313 return;
1315 if (INTEGERP (value))
1316 nlines = XINT (value);
1317 else
1318 nlines = 0;
1320 /* Make sure we redisplay all windows in this frame. */
1321 windows_or_buffers_changed++;
1323 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
1324 FRAME_MENU_BAR_LINES (f) = 0;
1325 if (nlines)
1327 FRAME_EXTERNAL_MENU_BAR (f) = 1;
1328 if (FRAME_X_P (f) && f->output_data.x->menubar_widget == 0)
1329 /* Make sure next redisplay shows the menu bar. */
1330 XWINDOW (FRAME_SELECTED_WINDOW (f))->update_mode_line = Qt;
1332 else
1334 if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
1335 free_frame_menubar (f);
1336 FRAME_EXTERNAL_MENU_BAR (f) = 0;
1337 if (FRAME_X_P (f))
1338 f->output_data.x->menubar_widget = 0;
1340 #else /* not USE_X_TOOLKIT && not USE_GTK */
1341 FRAME_MENU_BAR_LINES (f) = nlines;
1342 change_window_heights (f->root_window, nlines - olines);
1343 #endif /* not USE_X_TOOLKIT */
1344 adjust_glyphs (f);
1348 /* Set the number of lines used for the tool bar of frame F to VALUE.
1349 VALUE not an integer, or < 0 means set the lines to zero. OLDVAL
1350 is the old number of tool bar lines. This function changes the
1351 height of all windows on frame F to match the new tool bar height.
1352 The frame's height doesn't change. */
1354 void
1355 x_set_tool_bar_lines (f, value, oldval)
1356 struct frame *f;
1357 Lisp_Object value, oldval;
1359 int delta, nlines, root_height;
1360 Lisp_Object root_window;
1362 /* Treat tool bars like menu bars. */
1363 if (FRAME_MINIBUF_ONLY_P (f))
1364 return;
1366 /* Use VALUE only if an integer >= 0. */
1367 if (INTEGERP (value) && XINT (value) >= 0)
1368 nlines = XFASTINT (value);
1369 else
1370 nlines = 0;
1372 #ifdef USE_GTK
1373 FRAME_TOOL_BAR_LINES (f) = 0;
1374 if (nlines)
1376 FRAME_EXTERNAL_TOOL_BAR (f) = 1;
1377 if (FRAME_X_P (f) && f->output_data.x->toolbar_widget == 0)
1378 /* Make sure next redisplay shows the tool bar. */
1379 XWINDOW (FRAME_SELECTED_WINDOW (f))->update_mode_line = Qt;
1380 update_frame_tool_bar (f);
1382 else
1384 if (FRAME_EXTERNAL_TOOL_BAR (f))
1385 free_frame_tool_bar (f);
1386 FRAME_EXTERNAL_TOOL_BAR (f) = 0;
1389 return;
1390 #endif
1392 /* Make sure we redisplay all windows in this frame. */
1393 ++windows_or_buffers_changed;
1395 delta = nlines - FRAME_TOOL_BAR_LINES (f);
1397 /* Don't resize the tool-bar to more than we have room for. */
1398 root_window = FRAME_ROOT_WINDOW (f);
1399 root_height = WINDOW_TOTAL_LINES (XWINDOW (root_window));
1400 if (root_height - delta < 1)
1402 delta = root_height - 1;
1403 nlines = FRAME_TOOL_BAR_LINES (f) + delta;
1406 FRAME_TOOL_BAR_LINES (f) = nlines;
1407 change_window_heights (root_window, delta);
1408 adjust_glyphs (f);
1410 /* We also have to make sure that the internal border at the top of
1411 the frame, below the menu bar or tool bar, is redrawn when the
1412 tool bar disappears. This is so because the internal border is
1413 below the tool bar if one is displayed, but is below the menu bar
1414 if there isn't a tool bar. The tool bar draws into the area
1415 below the menu bar. */
1416 if (FRAME_X_WINDOW (f) && FRAME_TOOL_BAR_LINES (f) == 0)
1418 clear_frame (f);
1419 clear_current_matrices (f);
1422 /* If the tool bar gets smaller, the internal border below it
1423 has to be cleared. It was formerly part of the display
1424 of the larger tool bar, and updating windows won't clear it. */
1425 if (delta < 0)
1427 int height = FRAME_INTERNAL_BORDER_WIDTH (f);
1428 int width = FRAME_PIXEL_WIDTH (f);
1429 int y = nlines * FRAME_LINE_HEIGHT (f);
1431 /* height can be zero here. */
1432 if (height > 0 && width > 0)
1434 BLOCK_INPUT;
1435 x_clear_area (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1436 0, y, width, height, False);
1437 UNBLOCK_INPUT;
1440 if (WINDOWP (f->tool_bar_window))
1441 clear_glyph_matrix (XWINDOW (f->tool_bar_window)->current_matrix);
1446 /* Set the foreground color for scroll bars on frame F to VALUE.
1447 VALUE should be a string, a color name. If it isn't a string or
1448 isn't a valid color name, do nothing. OLDVAL is the old value of
1449 the frame parameter. */
1451 void
1452 x_set_scroll_bar_foreground (f, value, oldval)
1453 struct frame *f;
1454 Lisp_Object value, oldval;
1456 unsigned long pixel;
1458 if (STRINGP (value))
1459 pixel = x_decode_color (f, value, BLACK_PIX_DEFAULT (f));
1460 else
1461 pixel = -1;
1463 if (f->output_data.x->scroll_bar_foreground_pixel != -1)
1464 unload_color (f, f->output_data.x->scroll_bar_foreground_pixel);
1466 f->output_data.x->scroll_bar_foreground_pixel = pixel;
1467 if (FRAME_X_WINDOW (f) && FRAME_VISIBLE_P (f))
1469 /* Remove all scroll bars because they have wrong colors. */
1470 if (FRAME_TERMINAL (f)->condemn_scroll_bars_hook)
1471 (*FRAME_TERMINAL (f)->condemn_scroll_bars_hook) (f);
1472 if (FRAME_TERMINAL (f)->judge_scroll_bars_hook)
1473 (*FRAME_TERMINAL (f)->judge_scroll_bars_hook) (f);
1475 update_face_from_frame_parameter (f, Qscroll_bar_foreground, value);
1476 redraw_frame (f);
1481 /* Set the background color for scroll bars on frame F to VALUE VALUE
1482 should be a string, a color name. If it isn't a string or isn't a
1483 valid color name, do nothing. OLDVAL is the old value of the frame
1484 parameter. */
1486 void
1487 x_set_scroll_bar_background (f, value, oldval)
1488 struct frame *f;
1489 Lisp_Object value, oldval;
1491 unsigned long pixel;
1493 if (STRINGP (value))
1494 pixel = x_decode_color (f, value, WHITE_PIX_DEFAULT (f));
1495 else
1496 pixel = -1;
1498 if (f->output_data.x->scroll_bar_background_pixel != -1)
1499 unload_color (f, f->output_data.x->scroll_bar_background_pixel);
1501 #ifdef USE_TOOLKIT_SCROLL_BARS
1502 /* Scrollbar shadow colors. */
1503 if (f->output_data.x->scroll_bar_top_shadow_pixel != -1)
1505 unload_color (f, f->output_data.x->scroll_bar_top_shadow_pixel);
1506 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
1508 if (f->output_data.x->scroll_bar_bottom_shadow_pixel != -1)
1510 unload_color (f, f->output_data.x->scroll_bar_bottom_shadow_pixel);
1511 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
1513 #endif /* USE_TOOLKIT_SCROLL_BARS */
1515 f->output_data.x->scroll_bar_background_pixel = pixel;
1516 if (FRAME_X_WINDOW (f) && FRAME_VISIBLE_P (f))
1518 /* Remove all scroll bars because they have wrong colors. */
1519 if (FRAME_TERMINAL (f)->condemn_scroll_bars_hook)
1520 (*FRAME_TERMINAL (f)->condemn_scroll_bars_hook) (f);
1521 if (FRAME_TERMINAL (f)->judge_scroll_bars_hook)
1522 (*FRAME_TERMINAL (f)->judge_scroll_bars_hook) (f);
1524 update_face_from_frame_parameter (f, Qscroll_bar_background, value);
1525 redraw_frame (f);
1530 /* Encode Lisp string STRING as a text in a format appropriate for
1531 XICCC (X Inter Client Communication Conventions).
1533 This can call Lisp code, so callers must GCPRO.
1535 If STRING contains only ASCII characters, do no conversion and
1536 return the string data of STRING. Otherwise, encode the text by
1537 CODING_SYSTEM, and return a newly allocated memory area which
1538 should be freed by `xfree' by a caller.
1540 SELECTIONP non-zero means the string is being encoded for an X
1541 selection, so it is safe to run pre-write conversions (which
1542 may run Lisp code).
1544 Store the byte length of resulting text in *TEXT_BYTES.
1546 If the text contains only ASCII and Latin-1, store 1 in *STRING_P,
1547 which means that the `encoding' of the result can be `STRING'.
1548 Otherwise store 0 in *STRINGP, which means that the `encoding' of
1549 the result should be `COMPOUND_TEXT'. */
1551 static unsigned char *
1552 x_encode_text (string, coding_system, selectionp, text_bytes, stringp, freep)
1553 Lisp_Object string, coding_system;
1554 int *text_bytes, *stringp;
1555 int selectionp;
1556 int *freep;
1558 unsigned char *str = SDATA (string);
1559 int chars = SCHARS (string);
1560 int bytes = SBYTES (string);
1561 int charset_info;
1562 int bufsize;
1563 unsigned char *buf;
1564 struct coding_system coding;
1565 extern Lisp_Object Qcompound_text_with_extensions;
1567 charset_info = find_charset_in_text (str, chars, bytes, NULL, Qnil);
1568 if (charset_info == 0)
1570 /* No multibyte character in OBJ. We need not encode it. */
1571 *text_bytes = bytes;
1572 *stringp = 1;
1573 *freep = 0;
1574 return str;
1577 setup_coding_system (coding_system, &coding);
1578 if (selectionp
1579 && SYMBOLP (coding.pre_write_conversion)
1580 && !NILP (Ffboundp (coding.pre_write_conversion)))
1582 struct gcpro gcpro1;
1583 /* We don't need to GCPRO string. */
1584 GCPRO1 (coding_system);
1585 string = run_pre_post_conversion_on_str (string, &coding, 1);
1586 UNGCPRO;
1587 str = SDATA (string);
1588 chars = SCHARS (string);
1589 bytes = SBYTES (string);
1591 coding.src_multibyte = 1;
1592 coding.dst_multibyte = 0;
1593 coding.mode |= CODING_MODE_LAST_BLOCK;
1594 if (coding.type == coding_type_iso2022)
1595 coding.flags |= CODING_FLAG_ISO_SAFE;
1596 /* We suppress producing escape sequences for composition. */
1597 coding.composing = COMPOSITION_DISABLED;
1598 bufsize = encoding_buffer_size (&coding, bytes);
1599 buf = (unsigned char *) xmalloc (bufsize);
1600 encode_coding (&coding, str, buf, bytes, bufsize);
1601 *text_bytes = coding.produced;
1602 *stringp = (charset_info == 1
1603 || (!EQ (coding_system, Qcompound_text)
1604 && !EQ (coding_system, Qcompound_text_with_extensions)));
1605 *freep = 1;
1606 return buf;
1610 /* Set the WM name to NAME for frame F. Also set the icon name.
1611 If the frame already has an icon name, use that, otherwise set the
1612 icon name to NAME. */
1614 static void
1615 x_set_name_internal (f, name)
1616 FRAME_PTR f;
1617 Lisp_Object name;
1619 if (FRAME_X_WINDOW (f))
1621 BLOCK_INPUT;
1622 #ifdef HAVE_X11R4
1624 XTextProperty text, icon;
1625 int bytes, stringp;
1626 int do_free_icon_value = 0, do_free_text_value = 0;
1627 Lisp_Object coding_system;
1628 #ifdef USE_GTK
1629 Lisp_Object encoded_name;
1630 struct gcpro gcpro1;
1632 /* As ENCODE_UTF_8 may cause GC and relocation of string data,
1633 we use it before x_encode_text that may return string data. */
1634 GCPRO1 (name);
1635 encoded_name = ENCODE_UTF_8 (name);
1636 UNGCPRO;
1637 #endif
1639 coding_system = Qcompound_text;
1640 /* Note: Encoding strategy
1642 We encode NAME by compound-text and use "COMPOUND-TEXT" in
1643 text.encoding. But, there are non-internationalized window
1644 managers which don't support that encoding. So, if NAME
1645 contains only ASCII and 8859-1 characters, encode it by
1646 iso-latin-1, and use "STRING" in text.encoding hoping that
1647 such window managers at least analyze this format correctly,
1648 i.e. treat 8-bit bytes as 8859-1 characters.
1650 We may also be able to use "UTF8_STRING" in text.encoding
1651 in the future which can encode all Unicode characters.
1652 But, for the moment, there's no way to know that the
1653 current window manager supports it or not. */
1654 text.value = x_encode_text (name, coding_system, 0, &bytes, &stringp,
1655 &do_free_text_value);
1656 text.encoding = (stringp ? XA_STRING
1657 : FRAME_X_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
1658 text.format = 8;
1659 text.nitems = bytes;
1661 if (!STRINGP (f->icon_name))
1663 icon = text;
1665 else
1667 /* See the above comment "Note: Encoding strategy". */
1668 icon.value = x_encode_text (f->icon_name, coding_system, 0,
1669 &bytes, &stringp, &do_free_icon_value);
1670 icon.encoding = (stringp ? XA_STRING
1671 : FRAME_X_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
1672 icon.format = 8;
1673 icon.nitems = bytes;
1676 #ifdef USE_GTK
1677 gtk_window_set_title (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)),
1678 (char *) SDATA (encoded_name));
1679 #else /* not USE_GTK */
1680 XSetWMName (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &text);
1681 #endif /* not USE_GTK */
1683 XSetWMIconName (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &icon);
1685 if (do_free_icon_value)
1686 xfree (icon.value);
1687 if (do_free_text_value)
1688 xfree (text.value);
1690 #else /* not HAVE_X11R4 */
1691 XSetIconName (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1692 SDATA (name));
1693 XStoreName (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1694 SDATA (name));
1695 #endif /* not HAVE_X11R4 */
1696 UNBLOCK_INPUT;
1700 /* Change the name of frame F to NAME. If NAME is nil, set F's name to
1701 x_id_name.
1703 If EXPLICIT is non-zero, that indicates that lisp code is setting the
1704 name; if NAME is a string, set F's name to NAME and set
1705 F->explicit_name; if NAME is Qnil, then clear F->explicit_name.
1707 If EXPLICIT is zero, that indicates that Emacs redisplay code is
1708 suggesting a new name, which lisp code should override; if
1709 F->explicit_name is set, ignore the new name; otherwise, set it. */
1711 void
1712 x_set_name (f, name, explicit)
1713 struct frame *f;
1714 Lisp_Object name;
1715 int explicit;
1717 /* Make sure that requests from lisp code override requests from
1718 Emacs redisplay code. */
1719 if (explicit)
1721 /* If we're switching from explicit to implicit, we had better
1722 update the mode lines and thereby update the title. */
1723 if (f->explicit_name && NILP (name))
1724 update_mode_lines = 1;
1726 f->explicit_name = ! NILP (name);
1728 else if (f->explicit_name)
1729 return;
1731 /* If NAME is nil, set the name to the x_id_name. */
1732 if (NILP (name))
1734 /* Check for no change needed in this very common case
1735 before we do any consing. */
1736 if (!strcmp (FRAME_X_DISPLAY_INFO (f)->x_id_name,
1737 SDATA (f->name)))
1738 return;
1739 name = build_string (FRAME_X_DISPLAY_INFO (f)->x_id_name);
1741 else
1742 CHECK_STRING (name);
1744 /* Don't change the name if it's already NAME. */
1745 if (! NILP (Fstring_equal (name, f->name)))
1746 return;
1748 f->name = name;
1750 /* For setting the frame title, the title parameter should override
1751 the name parameter. */
1752 if (! NILP (f->title))
1753 name = f->title;
1755 x_set_name_internal (f, name);
1758 /* This function should be called when the user's lisp code has
1759 specified a name for the frame; the name will override any set by the
1760 redisplay code. */
1761 void
1762 x_explicitly_set_name (f, arg, oldval)
1763 FRAME_PTR f;
1764 Lisp_Object arg, oldval;
1766 x_set_name (f, arg, 1);
1769 /* This function should be called by Emacs redisplay code to set the
1770 name; names set this way will never override names set by the user's
1771 lisp code. */
1772 void
1773 x_implicitly_set_name (f, arg, oldval)
1774 FRAME_PTR f;
1775 Lisp_Object arg, oldval;
1777 x_set_name (f, arg, 0);
1780 /* Change the title of frame F to NAME.
1781 If NAME is nil, use the frame name as the title. */
1783 void
1784 x_set_title (f, name, old_name)
1785 struct frame *f;
1786 Lisp_Object name, old_name;
1788 /* Don't change the title if it's already NAME. */
1789 if (EQ (name, f->title))
1790 return;
1792 update_mode_lines = 1;
1794 f->title = name;
1796 if (NILP (name))
1797 name = f->name;
1798 else
1799 CHECK_STRING (name);
1801 x_set_name_internal (f, name);
1804 void
1805 x_set_scroll_bar_default_width (f)
1806 struct frame *f;
1808 int wid = FRAME_COLUMN_WIDTH (f);
1810 #ifdef USE_TOOLKIT_SCROLL_BARS
1811 /* A minimum width of 14 doesn't look good for toolkit scroll bars. */
1812 int width = 16 + 2 * VERTICAL_SCROLL_BAR_WIDTH_TRIM;
1813 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (width + wid - 1) / wid;
1814 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = width;
1815 #else
1816 /* Make the actual width at least 14 pixels and a multiple of a
1817 character width. */
1818 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (14 + wid - 1) / wid;
1820 /* Use all of that space (aside from required margins) for the
1821 scroll bar. */
1822 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = 0;
1823 #endif
1827 /* Record in frame F the specified or default value according to ALIST
1828 of the parameter named PROP (a Lisp symbol). If no value is
1829 specified for PROP, look for an X default for XPROP on the frame
1830 named NAME. If that is not found either, use the value DEFLT. */
1832 static Lisp_Object
1833 x_default_scroll_bar_color_parameter (f, alist, prop, xprop, xclass,
1834 foreground_p)
1835 struct frame *f;
1836 Lisp_Object alist;
1837 Lisp_Object prop;
1838 char *xprop;
1839 char *xclass;
1840 int foreground_p;
1842 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
1843 Lisp_Object tem;
1845 tem = x_get_arg (dpyinfo, alist, prop, xprop, xclass, RES_TYPE_STRING);
1846 if (EQ (tem, Qunbound))
1848 #ifdef USE_TOOLKIT_SCROLL_BARS
1850 /* See if an X resource for the scroll bar color has been
1851 specified. */
1852 tem = display_x_get_resource (dpyinfo,
1853 build_string (foreground_p
1854 ? "foreground"
1855 : "background"),
1856 empty_unibyte_string,
1857 build_string ("verticalScrollBar"),
1858 empty_unibyte_string);
1859 if (!STRINGP (tem))
1861 /* If nothing has been specified, scroll bars will use a
1862 toolkit-dependent default. Because these defaults are
1863 difficult to get at without actually creating a scroll
1864 bar, use nil to indicate that no color has been
1865 specified. */
1866 tem = Qnil;
1869 #else /* not USE_TOOLKIT_SCROLL_BARS */
1871 tem = Qnil;
1873 #endif /* not USE_TOOLKIT_SCROLL_BARS */
1876 x_set_frame_parameters (f, Fcons (Fcons (prop, tem), Qnil));
1877 return tem;
1882 #if !defined (HAVE_X11R4) && !defined (HAVE_XSETWMPROTOCOLS)
1884 Status
1885 XSetWMProtocols (dpy, w, protocols, count)
1886 Display *dpy;
1887 Window w;
1888 Atom *protocols;
1889 int count;
1891 Atom prop;
1892 prop = XInternAtom (dpy, "WM_PROTOCOLS", False);
1893 if (prop == None) return False;
1894 XChangeProperty (dpy, w, prop, XA_ATOM, 32, PropModeReplace,
1895 (unsigned char *) protocols, count);
1896 return True;
1898 #endif /* not HAVE_X11R4 && not HAVE_XSETWMPROTOCOLS */
1900 #ifdef USE_X_TOOLKIT
1902 /* If the WM_PROTOCOLS property does not already contain WM_TAKE_FOCUS,
1903 WM_DELETE_WINDOW, and WM_SAVE_YOURSELF, then add them. (They may
1904 already be present because of the toolkit (Motif adds some of them,
1905 for example, but Xt doesn't). */
1907 static void
1908 hack_wm_protocols (f, widget)
1909 FRAME_PTR f;
1910 Widget widget;
1912 Display *dpy = XtDisplay (widget);
1913 Window w = XtWindow (widget);
1914 int need_delete = 1;
1915 int need_focus = 1;
1916 int need_save = 1;
1918 BLOCK_INPUT;
1920 Atom type;
1921 unsigned char *catoms;
1922 int format = 0;
1923 unsigned long nitems = 0;
1924 unsigned long bytes_after;
1926 if ((XGetWindowProperty (dpy, w,
1927 FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
1928 (long)0, (long)100, False, XA_ATOM,
1929 &type, &format, &nitems, &bytes_after,
1930 &catoms)
1931 == Success)
1932 && format == 32 && type == XA_ATOM)
1934 Atom *atoms = (Atom *) catoms;
1935 while (nitems > 0)
1937 nitems--;
1938 if (atoms[nitems]
1939 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window)
1940 need_delete = 0;
1941 else if (atoms[nitems]
1942 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_take_focus)
1943 need_focus = 0;
1944 else if (atoms[nitems]
1945 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself)
1946 need_save = 0;
1949 if (catoms)
1950 XFree (catoms);
1953 Atom props [10];
1954 int count = 0;
1955 if (need_delete)
1956 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window;
1957 if (need_focus)
1958 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_take_focus;
1959 if (need_save)
1960 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself;
1961 if (count)
1962 XChangeProperty (dpy, w, FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
1963 XA_ATOM, 32, PropModeAppend,
1964 (unsigned char *) props, count);
1966 UNBLOCK_INPUT;
1968 #endif
1972 /* Support routines for XIC (X Input Context). */
1974 #ifdef HAVE_X_I18N
1976 static XFontSet xic_create_xfontset P_ ((struct frame *, char *));
1977 static XIMStyle best_xim_style P_ ((XIMStyles *, XIMStyles *));
1980 /* Supported XIM styles, ordered by preference. */
1982 static XIMStyle supported_xim_styles[] =
1984 XIMPreeditPosition | XIMStatusArea,
1985 XIMPreeditPosition | XIMStatusNothing,
1986 XIMPreeditPosition | XIMStatusNone,
1987 XIMPreeditNothing | XIMStatusArea,
1988 XIMPreeditNothing | XIMStatusNothing,
1989 XIMPreeditNothing | XIMStatusNone,
1990 XIMPreeditNone | XIMStatusArea,
1991 XIMPreeditNone | XIMStatusNothing,
1992 XIMPreeditNone | XIMStatusNone,
1997 /* Create an X fontset on frame F with base font name BASE_FONTNAME. */
1999 char xic_defaut_fontset[] = "-*-*-*-r-normal--14-*-*-*-*-*-*-*";
2001 /* Create an Xt fontset spec from the name of a base font.
2002 If `motif' is True use the Motif syntax. */
2003 char *
2004 xic_create_fontsetname (base_fontname, motif)
2005 char *base_fontname;
2006 Bool motif;
2008 const char *sep = motif ? ";" : ",";
2009 char *fontsetname;
2011 /* Make a fontset name from the base font name. */
2012 if (xic_defaut_fontset == base_fontname)
2013 { /* There is no base font name, use the default. */
2014 int len = strlen (base_fontname) + 2;
2015 fontsetname = xmalloc (len);
2016 bzero (fontsetname, len);
2017 strcpy (fontsetname, base_fontname);
2019 else
2021 /* Make a fontset name from the base font name.
2022 The font set will be made of the following elements:
2023 - the base font.
2024 - the base font where the charset spec is replaced by -*-*.
2025 - the same but with the family also replaced with -*-*-. */
2026 char *p = base_fontname;
2027 int i;
2029 for (i = 0; *p; p++)
2030 if (*p == '-') i++;
2031 if (i != 14)
2032 { /* As the font name doesn't conform to XLFD, we can't
2033 modify it to generalize it to allcs and allfamilies.
2034 Use the specified font plus the default. */
2035 int len = strlen (base_fontname) + strlen (xic_defaut_fontset) + 3;
2036 fontsetname = xmalloc (len);
2037 bzero (fontsetname, len);
2038 strcpy (fontsetname, base_fontname);
2039 strcat (fontsetname, sep);
2040 strcat (fontsetname, xic_defaut_fontset);
2042 else
2044 int len;
2045 char *p1 = NULL, *p2 = NULL, *p3 = NULL;
2046 char *font_allcs = NULL;
2047 char *font_allfamilies = NULL;
2048 char *font_all = NULL;
2049 char *allcs = "*-*-*-*-*-*-*";
2050 char *allfamilies = "-*-*-";
2051 char *all = "*-*-*-*-";
2052 char *base;
2054 for (i = 0, p = base_fontname; i < 8; p++)
2056 if (*p == '-')
2058 i++;
2059 if (i == 3)
2060 p1 = p + 1;
2061 else if (i == 7)
2062 p2 = p + 1;
2063 else if (i == 6)
2064 p3 = p + 1;
2067 /* If base_fontname specifies ADSTYLE, make it a
2068 wildcard. */
2069 if (*p3 != '*')
2071 int diff = (p2 - p3) - 2;
2073 base = alloca (strlen (base_fontname) + 1);
2074 bcopy (base_fontname, base, p3 - base_fontname);
2075 base[p3 - base_fontname] = '*';
2076 base[(p3 - base_fontname) + 1] = '-';
2077 strcpy (base + (p3 - base_fontname) + 2, p2);
2078 p = base + (p - base_fontname) - diff;
2079 p1 = base + (p1 - base_fontname);
2080 p2 = base + (p2 - base_fontname) - diff;
2081 base_fontname = base;
2084 /* Build the font spec that matches all charsets. */
2085 len = p - base_fontname + strlen (allcs) + 1;
2086 font_allcs = (char *) alloca (len);
2087 bzero (font_allcs, len);
2088 bcopy (base_fontname, font_allcs, p - base_fontname);
2089 strcat (font_allcs, allcs);
2091 /* Build the font spec that matches all families and
2092 add-styles. */
2093 len = p - p1 + strlen (allcs) + strlen (allfamilies) + 1;
2094 font_allfamilies = (char *) alloca (len);
2095 bzero (font_allfamilies, len);
2096 strcpy (font_allfamilies, allfamilies);
2097 bcopy (p1, font_allfamilies + strlen (allfamilies), p - p1);
2098 strcat (font_allfamilies, allcs);
2100 /* Build the font spec that matches all. */
2101 len = p - p2 + strlen (allcs) + strlen (all) + strlen (allfamilies) + 1;
2102 font_all = (char *) alloca (len);
2103 bzero (font_all, len);
2104 strcpy (font_all, allfamilies);
2105 strcat (font_all, all);
2106 bcopy (p2, font_all + strlen (all) + strlen (allfamilies), p - p2);
2107 strcat (font_all, allcs);
2109 /* Build the actual font set name. */
2110 len = strlen (base_fontname) + strlen (font_allcs)
2111 + strlen (font_allfamilies) + strlen (font_all) + 5;
2112 fontsetname = xmalloc (len);
2113 bzero (fontsetname, len);
2114 strcpy (fontsetname, base_fontname);
2115 strcat (fontsetname, sep);
2116 strcat (fontsetname, font_allcs);
2117 strcat (fontsetname, sep);
2118 strcat (fontsetname, font_allfamilies);
2119 strcat (fontsetname, sep);
2120 strcat (fontsetname, font_all);
2123 if (motif)
2124 strcat (fontsetname, ":");
2125 return fontsetname;
2128 static XFontSet
2129 xic_create_xfontset (f, base_fontname)
2130 struct frame *f;
2131 char *base_fontname;
2133 XFontSet xfs = NULL;
2134 char **missing_list = NULL;
2135 int missing_count;
2136 char *def_string;
2137 Lisp_Object rest, frame;
2139 if (!base_fontname)
2140 base_fontname = xic_defaut_fontset;
2142 /* See if there is another frame already using same fontset. */
2143 FOR_EACH_FRAME (rest, frame)
2145 struct frame *cf = XFRAME (frame);
2146 if (cf != f && FRAME_LIVE_P (f) && FRAME_X_P (cf)
2147 && FRAME_X_DISPLAY_INFO (cf) == FRAME_X_DISPLAY_INFO (f)
2148 && FRAME_XIC_BASE_FONTNAME (cf)
2149 && !strcmp (FRAME_XIC_BASE_FONTNAME (cf), base_fontname))
2151 xfs = FRAME_XIC_FONTSET (cf);
2152 break;
2156 if (!xfs)
2158 char *fontsetname = xic_create_fontsetname (base_fontname, False);
2160 /* New fontset. */
2161 xfs = XCreateFontSet (FRAME_X_DISPLAY (f),
2162 fontsetname, &missing_list,
2163 &missing_count, &def_string);
2164 if (missing_list)
2165 XFreeStringList (missing_list);
2166 if (! xfs)
2168 /* FONTSETNAME contains a list of font names (specific fonts
2169 first, general fonts last), but giving that to
2170 XCreateFontSet at once occasionally fails (bug of X?).
2171 So, we try to call XCreateFontSet for each fontname. */
2172 char *p0 = fontsetname, *p1;
2174 while (p0)
2176 p1 = strchr (p0, ',');
2177 if (p1)
2178 *p1 = '\0';
2179 xfs = XCreateFontSet (FRAME_X_DISPLAY (f),
2180 p0, &missing_list,
2181 &missing_count, &def_string);
2182 if (missing_list)
2183 XFreeStringList (missing_list);
2184 if (xfs)
2185 break;
2186 p0 = p1 ? p1 + 1 : NULL;
2189 xfree (fontsetname);
2192 if (FRAME_XIC_BASE_FONTNAME (f))
2193 xfree (FRAME_XIC_BASE_FONTNAME (f));
2194 FRAME_XIC_BASE_FONTNAME (f) = xstrdup (base_fontname);
2196 /* No need to free def_string. */
2197 return xfs;
2200 /* Free the X fontset of frame F if it is the last frame using it. */
2202 void
2203 xic_free_xfontset (f)
2204 struct frame *f;
2206 Lisp_Object rest, frame;
2207 int shared_p = 0;
2209 if (!FRAME_XIC_FONTSET (f))
2210 return;
2212 /* See if there is another frame sharing the same fontset. */
2213 FOR_EACH_FRAME (rest, frame)
2215 struct frame *cf = XFRAME (frame);
2216 if (cf != f && FRAME_LIVE_P (f) && FRAME_X_P (cf)
2217 && FRAME_X_DISPLAY_INFO (cf) == FRAME_X_DISPLAY_INFO (f)
2218 && FRAME_XIC_FONTSET (cf) == FRAME_XIC_FONTSET (f))
2220 shared_p = 1;
2221 break;
2225 if (!shared_p)
2226 /* The fontset is not used anymore. It is safe to free it. */
2227 XFreeFontSet (FRAME_X_DISPLAY (f), FRAME_XIC_FONTSET (f));
2229 if (FRAME_XIC_BASE_FONTNAME (f))
2230 xfree (FRAME_XIC_BASE_FONTNAME (f));
2231 FRAME_XIC_BASE_FONTNAME (f) = NULL;
2232 FRAME_XIC_FONTSET (f) = NULL;
2236 /* Value is the best input style, given user preferences USER (already
2237 checked to be supported by Emacs), and styles supported by the
2238 input method XIM. */
2240 static XIMStyle
2241 best_xim_style (user, xim)
2242 XIMStyles *user;
2243 XIMStyles *xim;
2245 int i, j;
2247 for (i = 0; i < user->count_styles; ++i)
2248 for (j = 0; j < xim->count_styles; ++j)
2249 if (user->supported_styles[i] == xim->supported_styles[j])
2250 return user->supported_styles[i];
2252 /* Return the default style. */
2253 return XIMPreeditNothing | XIMStatusNothing;
2256 /* Create XIC for frame F. */
2258 static XIMStyle xic_style;
2260 void
2261 create_frame_xic (f)
2262 struct frame *f;
2264 XIM xim;
2265 XIC xic = NULL;
2266 XFontSet xfs = NULL;
2268 if (FRAME_XIC (f))
2269 return;
2271 /* Create X fontset. */
2272 xfs = xic_create_xfontset
2273 (f, (FRAME_FONTSET (f) < 0) ? NULL
2274 : (char *) SDATA (fontset_ascii (FRAME_FONTSET (f))));
2276 xim = FRAME_X_XIM (f);
2277 if (xim)
2279 XRectangle s_area;
2280 XPoint spot;
2281 XVaNestedList preedit_attr;
2282 XVaNestedList status_attr;
2284 s_area.x = 0; s_area.y = 0; s_area.width = 1; s_area.height = 1;
2285 spot.x = 0; spot.y = 1;
2287 /* Determine XIC style. */
2288 if (xic_style == 0)
2290 XIMStyles supported_list;
2291 supported_list.count_styles = (sizeof supported_xim_styles
2292 / sizeof supported_xim_styles[0]);
2293 supported_list.supported_styles = supported_xim_styles;
2294 xic_style = best_xim_style (&supported_list,
2295 FRAME_X_XIM_STYLES (f));
2298 preedit_attr = XVaCreateNestedList (0,
2299 XNFontSet, xfs,
2300 XNForeground,
2301 FRAME_FOREGROUND_PIXEL (f),
2302 XNBackground,
2303 FRAME_BACKGROUND_PIXEL (f),
2304 (xic_style & XIMPreeditPosition
2305 ? XNSpotLocation
2306 : NULL),
2307 &spot,
2308 NULL);
2309 status_attr = XVaCreateNestedList (0,
2310 XNArea,
2311 &s_area,
2312 XNFontSet,
2313 xfs,
2314 XNForeground,
2315 FRAME_FOREGROUND_PIXEL (f),
2316 XNBackground,
2317 FRAME_BACKGROUND_PIXEL (f),
2318 NULL);
2320 xic = XCreateIC (xim,
2321 XNInputStyle, xic_style,
2322 XNClientWindow, FRAME_X_WINDOW (f),
2323 XNFocusWindow, FRAME_X_WINDOW (f),
2324 XNStatusAttributes, status_attr,
2325 XNPreeditAttributes, preedit_attr,
2326 NULL);
2327 XFree (preedit_attr);
2328 XFree (status_attr);
2331 FRAME_XIC (f) = xic;
2332 FRAME_XIC_STYLE (f) = xic_style;
2333 FRAME_XIC_FONTSET (f) = xfs;
2337 /* Destroy XIC and free XIC fontset of frame F, if any. */
2339 void
2340 free_frame_xic (f)
2341 struct frame *f;
2343 if (FRAME_XIC (f) == NULL)
2344 return;
2346 XDestroyIC (FRAME_XIC (f));
2347 xic_free_xfontset (f);
2349 FRAME_XIC (f) = NULL;
2353 /* Place preedit area for XIC of window W's frame to specified
2354 pixel position X/Y. X and Y are relative to window W. */
2356 void
2357 xic_set_preeditarea (w, x, y)
2358 struct window *w;
2359 int x, y;
2361 struct frame *f = XFRAME (w->frame);
2362 XVaNestedList attr;
2363 XPoint spot;
2365 spot.x = WINDOW_TO_FRAME_PIXEL_X (w, x) + WINDOW_LEFT_FRINGE_WIDTH (w);
2366 spot.y = WINDOW_TO_FRAME_PIXEL_Y (w, y) + FONT_BASE (FRAME_FONT (f));
2367 attr = XVaCreateNestedList (0, XNSpotLocation, &spot, NULL);
2368 XSetICValues (FRAME_XIC (f), XNPreeditAttributes, attr, NULL);
2369 XFree (attr);
2373 /* Place status area for XIC in bottom right corner of frame F.. */
2375 void
2376 xic_set_statusarea (f)
2377 struct frame *f;
2379 XIC xic = FRAME_XIC (f);
2380 XVaNestedList attr;
2381 XRectangle area;
2382 XRectangle *needed;
2384 /* Negotiate geometry of status area. If input method has existing
2385 status area, use its current size. */
2386 area.x = area.y = area.width = area.height = 0;
2387 attr = XVaCreateNestedList (0, XNAreaNeeded, &area, NULL);
2388 XSetICValues (xic, XNStatusAttributes, attr, NULL);
2389 XFree (attr);
2391 attr = XVaCreateNestedList (0, XNAreaNeeded, &needed, NULL);
2392 XGetICValues (xic, XNStatusAttributes, attr, NULL);
2393 XFree (attr);
2395 if (needed->width == 0) /* Use XNArea instead of XNAreaNeeded */
2397 attr = XVaCreateNestedList (0, XNArea, &needed, NULL);
2398 XGetICValues (xic, XNStatusAttributes, attr, NULL);
2399 XFree (attr);
2402 area.width = needed->width;
2403 area.height = needed->height;
2404 area.x = FRAME_PIXEL_WIDTH (f) - area.width - FRAME_INTERNAL_BORDER_WIDTH (f);
2405 area.y = (FRAME_PIXEL_HEIGHT (f) - area.height
2406 - FRAME_MENUBAR_HEIGHT (f)
2407 - FRAME_TOOLBAR_HEIGHT (f)
2408 - FRAME_INTERNAL_BORDER_WIDTH (f));
2409 XFree (needed);
2411 attr = XVaCreateNestedList (0, XNArea, &area, NULL);
2412 XSetICValues (xic, XNStatusAttributes, attr, NULL);
2413 XFree (attr);
2417 /* Set X fontset for XIC of frame F, using base font name
2418 BASE_FONTNAME. Called when a new Emacs fontset is chosen. */
2420 void
2421 xic_set_xfontset (f, base_fontname)
2422 struct frame *f;
2423 char *base_fontname;
2425 XVaNestedList attr;
2426 XFontSet xfs;
2428 xic_free_xfontset (f);
2430 xfs = xic_create_xfontset (f, base_fontname);
2432 attr = XVaCreateNestedList (0, XNFontSet, xfs, NULL);
2433 if (FRAME_XIC_STYLE (f) & XIMPreeditPosition)
2434 XSetICValues (FRAME_XIC (f), XNPreeditAttributes, attr, NULL);
2435 if (FRAME_XIC_STYLE (f) & XIMStatusArea)
2436 XSetICValues (FRAME_XIC (f), XNStatusAttributes, attr, NULL);
2437 XFree (attr);
2439 FRAME_XIC_FONTSET (f) = xfs;
2442 #endif /* HAVE_X_I18N */
2446 #ifdef USE_X_TOOLKIT
2448 /* Create and set up the X widget for frame F. */
2450 static void
2451 x_window (f, window_prompting, minibuffer_only)
2452 struct frame *f;
2453 long window_prompting;
2454 int minibuffer_only;
2456 XClassHint class_hints;
2457 XSetWindowAttributes attributes;
2458 unsigned long attribute_mask;
2459 Widget shell_widget;
2460 Widget pane_widget;
2461 Widget frame_widget;
2462 Arg al [25];
2463 int ac;
2465 BLOCK_INPUT;
2467 /* Use the resource name as the top-level widget name
2468 for looking up resources. Make a non-Lisp copy
2469 for the window manager, so GC relocation won't bother it.
2471 Elsewhere we specify the window name for the window manager. */
2474 char *str = (char *) SDATA (Vx_resource_name);
2475 f->namebuf = (char *) xmalloc (strlen (str) + 1);
2476 strcpy (f->namebuf, str);
2479 ac = 0;
2480 XtSetArg (al[ac], XtNallowShellResize, 1); ac++;
2481 XtSetArg (al[ac], XtNinput, 1); ac++;
2482 XtSetArg (al[ac], XtNmappedWhenManaged, 0); ac++;
2483 XtSetArg (al[ac], XtNborderWidth, f->border_width); ac++;
2484 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2485 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2486 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2487 shell_widget = XtAppCreateShell (f->namebuf, EMACS_CLASS,
2488 applicationShellWidgetClass,
2489 FRAME_X_DISPLAY (f), al, ac);
2491 f->output_data.x->widget = shell_widget;
2492 /* maybe_set_screen_title_format (shell_widget); */
2494 pane_widget = lw_create_widget ("main", "pane", widget_id_tick++,
2495 (widget_value *) NULL,
2496 shell_widget, False,
2497 (lw_callback) NULL,
2498 (lw_callback) NULL,
2499 (lw_callback) NULL,
2500 (lw_callback) NULL);
2502 ac = 0;
2503 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2504 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2505 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2506 XtSetValues (pane_widget, al, ac);
2507 f->output_data.x->column_widget = pane_widget;
2509 /* mappedWhenManaged to false tells to the paned window to not map/unmap
2510 the emacs screen when changing menubar. This reduces flickering. */
2512 ac = 0;
2513 XtSetArg (al[ac], XtNmappedWhenManaged, 0); ac++;
2514 XtSetArg (al[ac], XtNshowGrip, 0); ac++;
2515 XtSetArg (al[ac], XtNallowResize, 1); ac++;
2516 XtSetArg (al[ac], XtNresizeToPreferred, 1); ac++;
2517 XtSetArg (al[ac], XtNemacsFrame, f); ac++;
2518 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2519 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2520 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2521 frame_widget = XtCreateWidget (f->namebuf, emacsFrameClass, pane_widget,
2522 al, ac);
2524 f->output_data.x->edit_widget = frame_widget;
2526 XtManageChild (frame_widget);
2528 /* Do some needed geometry management. */
2530 int len;
2531 char *tem, shell_position[32];
2532 Arg al[10];
2533 int ac = 0;
2534 int extra_borders = 0;
2535 int menubar_size
2536 = (f->output_data.x->menubar_widget
2537 ? (f->output_data.x->menubar_widget->core.height
2538 + f->output_data.x->menubar_widget->core.border_width)
2539 : 0);
2541 #if 0 /* Experimentally, we now get the right results
2542 for -geometry -0-0 without this. 24 Aug 96, rms. */
2543 if (FRAME_EXTERNAL_MENU_BAR (f))
2545 Dimension ibw = 0;
2546 XtVaGetValues (pane_widget, XtNinternalBorderWidth, &ibw, NULL);
2547 menubar_size += ibw;
2549 #endif
2551 f->output_data.x->menubar_height = menubar_size;
2553 #ifndef USE_LUCID
2554 /* Motif seems to need this amount added to the sizes
2555 specified for the shell widget. The Athena/Lucid widgets don't.
2556 Both conclusions reached experimentally. -- rms. */
2557 XtVaGetValues (f->output_data.x->edit_widget, XtNinternalBorderWidth,
2558 &extra_borders, NULL);
2559 extra_borders *= 2;
2560 #endif
2562 /* Convert our geometry parameters into a geometry string
2563 and specify it.
2564 Note that we do not specify here whether the position
2565 is a user-specified or program-specified one.
2566 We pass that information later, in x_wm_set_size_hints. */
2568 int left = f->left_pos;
2569 int xneg = window_prompting & XNegative;
2570 int top = f->top_pos;
2571 int yneg = window_prompting & YNegative;
2572 if (xneg)
2573 left = -left;
2574 if (yneg)
2575 top = -top;
2577 if (window_prompting & USPosition)
2578 sprintf (shell_position, "=%dx%d%c%d%c%d",
2579 FRAME_PIXEL_WIDTH (f) + extra_borders,
2580 FRAME_PIXEL_HEIGHT (f) + menubar_size + extra_borders,
2581 (xneg ? '-' : '+'), left,
2582 (yneg ? '-' : '+'), top);
2583 else
2585 sprintf (shell_position, "=%dx%d",
2586 FRAME_PIXEL_WIDTH (f) + extra_borders,
2587 FRAME_PIXEL_HEIGHT (f) + menubar_size + extra_borders);
2589 /* Setting x and y when the position is not specified in
2590 the geometry string will set program position in the WM hints.
2591 If Emacs had just one program position, we could set it in
2592 fallback resources, but since each make-frame call can specify
2593 different program positions, this is easier. */
2594 XtSetArg (al[ac], XtNx, left); ac++;
2595 XtSetArg (al[ac], XtNy, top); ac++;
2599 len = strlen (shell_position) + 1;
2600 /* We don't free this because we don't know whether
2601 it is safe to free it while the frame exists.
2602 It isn't worth the trouble of arranging to free it
2603 when the frame is deleted. */
2604 tem = (char *) xmalloc (len);
2605 strncpy (tem, shell_position, len);
2606 XtSetArg (al[ac], XtNgeometry, tem); ac++;
2607 XtSetValues (shell_widget, al, ac);
2610 XtManageChild (pane_widget);
2611 XtRealizeWidget (shell_widget);
2613 FRAME_X_WINDOW (f) = XtWindow (frame_widget);
2615 validate_x_resource_name ();
2617 class_hints.res_name = (char *) SDATA (Vx_resource_name);
2618 class_hints.res_class = (char *) SDATA (Vx_resource_class);
2619 XSetClassHint (FRAME_X_DISPLAY (f), XtWindow (shell_widget), &class_hints);
2621 #ifdef HAVE_X_I18N
2622 FRAME_XIC (f) = NULL;
2623 if (use_xim)
2624 create_frame_xic (f);
2625 #endif
2627 f->output_data.x->wm_hints.input = True;
2628 f->output_data.x->wm_hints.flags |= InputHint;
2629 XSetWMHints (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2630 &f->output_data.x->wm_hints);
2632 hack_wm_protocols (f, shell_widget);
2634 #ifdef HACK_EDITRES
2635 XtAddEventHandler (shell_widget, 0, True, _XEditResCheckMessages, 0);
2636 #endif
2638 /* Do a stupid property change to force the server to generate a
2639 PropertyNotify event so that the event_stream server timestamp will
2640 be initialized to something relevant to the time we created the window.
2642 XChangeProperty (XtDisplay (frame_widget), XtWindow (frame_widget),
2643 FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
2644 XA_ATOM, 32, PropModeAppend,
2645 (unsigned char*) NULL, 0);
2647 /* Make all the standard events reach the Emacs frame. */
2648 attributes.event_mask = STANDARD_EVENT_SET;
2650 #ifdef HAVE_X_I18N
2651 if (FRAME_XIC (f))
2653 /* XIM server might require some X events. */
2654 unsigned long fevent = NoEventMask;
2655 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2656 attributes.event_mask |= fevent;
2658 #endif /* HAVE_X_I18N */
2660 attribute_mask = CWEventMask;
2661 XChangeWindowAttributes (XtDisplay (shell_widget), XtWindow (shell_widget),
2662 attribute_mask, &attributes);
2664 XtMapWidget (frame_widget);
2666 /* x_set_name normally ignores requests to set the name if the
2667 requested name is the same as the current name. This is the one
2668 place where that assumption isn't correct; f->name is set, but
2669 the X server hasn't been told. */
2671 Lisp_Object name;
2672 int explicit = f->explicit_name;
2674 f->explicit_name = 0;
2675 name = f->name;
2676 f->name = Qnil;
2677 x_set_name (f, name, explicit);
2680 XDefineCursor (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2681 f->output_data.x->text_cursor);
2683 UNBLOCK_INPUT;
2685 /* This is a no-op, except under Motif. Make sure main areas are
2686 set to something reasonable, in case we get an error later. */
2687 lw_set_main_areas (pane_widget, 0, frame_widget);
2690 #else /* not USE_X_TOOLKIT */
2691 #ifdef USE_GTK
2692 void
2693 x_window (f)
2694 FRAME_PTR f;
2696 if (! xg_create_frame_widgets (f))
2697 error ("Unable to create window");
2699 #ifdef HAVE_X_I18N
2700 FRAME_XIC (f) = NULL;
2701 if (use_xim)
2703 BLOCK_INPUT;
2704 create_frame_xic (f);
2705 if (FRAME_XIC (f))
2707 /* XIM server might require some X events. */
2708 unsigned long fevent = NoEventMask;
2709 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2711 if (fevent != NoEventMask)
2713 XSetWindowAttributes attributes;
2714 XWindowAttributes wattr;
2715 unsigned long attribute_mask;
2717 XGetWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2718 &wattr);
2719 attributes.event_mask = wattr.your_event_mask | fevent;
2720 attribute_mask = CWEventMask;
2721 XChangeWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2722 attribute_mask, &attributes);
2725 UNBLOCK_INPUT;
2727 #endif
2730 #else /*! USE_GTK */
2731 /* Create and set up the X window for frame F. */
2733 void
2734 x_window (f)
2735 struct frame *f;
2738 XClassHint class_hints;
2739 XSetWindowAttributes attributes;
2740 unsigned long attribute_mask;
2742 attributes.background_pixel = FRAME_BACKGROUND_PIXEL (f);
2743 attributes.border_pixel = f->output_data.x->border_pixel;
2744 attributes.bit_gravity = StaticGravity;
2745 attributes.backing_store = NotUseful;
2746 attributes.save_under = True;
2747 attributes.event_mask = STANDARD_EVENT_SET;
2748 attributes.colormap = FRAME_X_COLORMAP (f);
2749 attribute_mask = (CWBackPixel | CWBorderPixel | CWBitGravity | CWEventMask
2750 | CWColormap);
2752 BLOCK_INPUT;
2753 FRAME_X_WINDOW (f)
2754 = XCreateWindow (FRAME_X_DISPLAY (f),
2755 f->output_data.x->parent_desc,
2756 f->left_pos,
2757 f->top_pos,
2758 FRAME_PIXEL_WIDTH (f), FRAME_PIXEL_HEIGHT (f),
2759 f->border_width,
2760 CopyFromParent, /* depth */
2761 InputOutput, /* class */
2762 FRAME_X_VISUAL (f),
2763 attribute_mask, &attributes);
2765 #ifdef HAVE_X_I18N
2766 if (use_xim)
2768 create_frame_xic (f);
2769 if (FRAME_XIC (f))
2771 /* XIM server might require some X events. */
2772 unsigned long fevent = NoEventMask;
2773 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2774 attributes.event_mask |= fevent;
2775 attribute_mask = CWEventMask;
2776 XChangeWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2777 attribute_mask, &attributes);
2780 #endif /* HAVE_X_I18N */
2782 validate_x_resource_name ();
2784 class_hints.res_name = (char *) SDATA (Vx_resource_name);
2785 class_hints.res_class = (char *) SDATA (Vx_resource_class);
2786 XSetClassHint (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), &class_hints);
2788 /* The menubar is part of the ordinary display;
2789 it does not count in addition to the height of the window. */
2790 f->output_data.x->menubar_height = 0;
2792 /* This indicates that we use the "Passive Input" input model.
2793 Unless we do this, we don't get the Focus{In,Out} events that we
2794 need to draw the cursor correctly. Accursed bureaucrats.
2795 XWhipsAndChains (FRAME_X_DISPLAY (f), IronMaiden, &TheRack); */
2797 f->output_data.x->wm_hints.input = True;
2798 f->output_data.x->wm_hints.flags |= InputHint;
2799 XSetWMHints (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2800 &f->output_data.x->wm_hints);
2801 f->output_data.x->wm_hints.icon_pixmap = None;
2803 /* Request "save yourself" and "delete window" commands from wm. */
2805 Atom protocols[2];
2806 protocols[0] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window;
2807 protocols[1] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself;
2808 XSetWMProtocols (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), protocols, 2);
2811 /* x_set_name normally ignores requests to set the name if the
2812 requested name is the same as the current name. This is the one
2813 place where that assumption isn't correct; f->name is set, but
2814 the X server hasn't been told. */
2816 Lisp_Object name;
2817 int explicit = f->explicit_name;
2819 f->explicit_name = 0;
2820 name = f->name;
2821 f->name = Qnil;
2822 x_set_name (f, name, explicit);
2825 XDefineCursor (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2826 f->output_data.x->text_cursor);
2828 UNBLOCK_INPUT;
2830 if (FRAME_X_WINDOW (f) == 0)
2831 error ("Unable to create window");
2834 #endif /* not USE_GTK */
2835 #endif /* not USE_X_TOOLKIT */
2837 /* Verify that the icon position args for this window are valid. */
2839 static void
2840 x_icon_verify (f, parms)
2841 struct frame *f;
2842 Lisp_Object parms;
2844 Lisp_Object icon_x, icon_y;
2846 /* Set the position of the icon. Note that twm groups all
2847 icons in an icon window. */
2848 icon_x = x_frame_get_and_record_arg (f, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
2849 icon_y = x_frame_get_and_record_arg (f, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
2850 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
2852 CHECK_NUMBER (icon_x);
2853 CHECK_NUMBER (icon_y);
2855 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
2856 error ("Both left and top icon corners of icon must be specified");
2859 /* Handle the icon stuff for this window. Perhaps later we might
2860 want an x_set_icon_position which can be called interactively as
2861 well. */
2863 static void
2864 x_icon (f, parms)
2865 struct frame *f;
2866 Lisp_Object parms;
2868 Lisp_Object icon_x, icon_y;
2869 #if 0
2870 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
2871 #endif
2873 /* Set the position of the icon. Note that twm groups all
2874 icons in an icon window. */
2875 icon_x = x_frame_get_and_record_arg (f, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
2876 icon_y = x_frame_get_and_record_arg (f, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
2877 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
2879 CHECK_NUMBER (icon_x);
2880 CHECK_NUMBER (icon_y);
2882 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
2883 error ("Both left and top icon corners of icon must be specified");
2885 BLOCK_INPUT;
2887 if (! EQ (icon_x, Qunbound))
2888 x_wm_set_icon_position (f, XINT (icon_x), XINT (icon_y));
2890 #if 0 /* x_get_arg removes the visibility parameter as a side effect,
2891 but x_create_frame still needs it. */
2892 /* Start up iconic or window? */
2893 x_wm_set_window_state
2894 (f, (EQ (x_get_arg (dpyinfo, parms, Qvisibility, 0, 0, RES_TYPE_SYMBOL),
2895 Qicon)
2896 ? IconicState
2897 : NormalState));
2898 #endif
2900 x_text_icon (f, (char *) SDATA ((!NILP (f->icon_name)
2901 ? f->icon_name
2902 : f->name)));
2904 UNBLOCK_INPUT;
2907 /* Make the GCs needed for this window, setting the
2908 background, border and mouse colors; also create the
2909 mouse cursor and the gray border tile. */
2911 static char cursor_bits[] =
2913 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
2914 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
2915 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
2916 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00
2919 static void
2920 x_make_gc (f)
2921 struct frame *f;
2923 XGCValues gc_values;
2925 BLOCK_INPUT;
2927 /* Create the GCs of this frame.
2928 Note that many default values are used. */
2930 /* Normal video */
2931 gc_values.font = FRAME_FONT (f)->fid;
2932 gc_values.foreground = FRAME_FOREGROUND_PIXEL (f);
2933 gc_values.background = FRAME_BACKGROUND_PIXEL (f);
2934 gc_values.line_width = 0; /* Means 1 using fast algorithm. */
2935 f->output_data.x->normal_gc
2936 = XCreateGC (FRAME_X_DISPLAY (f),
2937 FRAME_X_WINDOW (f),
2938 GCLineWidth | GCFont | GCForeground | GCBackground,
2939 &gc_values);
2941 /* Reverse video style. */
2942 gc_values.foreground = FRAME_BACKGROUND_PIXEL (f);
2943 gc_values.background = FRAME_FOREGROUND_PIXEL (f);
2944 f->output_data.x->reverse_gc
2945 = XCreateGC (FRAME_X_DISPLAY (f),
2946 FRAME_X_WINDOW (f),
2947 GCFont | GCForeground | GCBackground | GCLineWidth,
2948 &gc_values);
2950 /* Cursor has cursor-color background, background-color foreground. */
2951 gc_values.foreground = FRAME_BACKGROUND_PIXEL (f);
2952 gc_values.background = f->output_data.x->cursor_pixel;
2953 gc_values.fill_style = FillOpaqueStippled;
2954 gc_values.stipple
2955 = XCreateBitmapFromData (FRAME_X_DISPLAY (f),
2956 FRAME_X_DISPLAY_INFO (f)->root_window,
2957 cursor_bits, 16, 16);
2958 f->output_data.x->cursor_gc
2959 = XCreateGC (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2960 (GCFont | GCForeground | GCBackground
2961 | GCFillStyle /* | GCStipple */ | GCLineWidth),
2962 &gc_values);
2964 /* Reliefs. */
2965 f->output_data.x->white_relief.gc = 0;
2966 f->output_data.x->black_relief.gc = 0;
2968 /* Create the gray border tile used when the pointer is not in
2969 the frame. Since this depends on the frame's pixel values,
2970 this must be done on a per-frame basis. */
2971 f->output_data.x->border_tile
2972 = (XCreatePixmapFromBitmapData
2973 (FRAME_X_DISPLAY (f), FRAME_X_DISPLAY_INFO (f)->root_window,
2974 gray_bits, gray_width, gray_height,
2975 FRAME_FOREGROUND_PIXEL (f),
2976 FRAME_BACKGROUND_PIXEL (f),
2977 DefaultDepth (FRAME_X_DISPLAY (f), FRAME_X_SCREEN_NUMBER (f))));
2979 UNBLOCK_INPUT;
2983 /* Free what was was allocated in x_make_gc. */
2985 void
2986 x_free_gcs (f)
2987 struct frame *f;
2989 Display *dpy = FRAME_X_DISPLAY (f);
2991 BLOCK_INPUT;
2993 if (f->output_data.x->normal_gc)
2995 XFreeGC (dpy, f->output_data.x->normal_gc);
2996 f->output_data.x->normal_gc = 0;
2999 if (f->output_data.x->reverse_gc)
3001 XFreeGC (dpy, f->output_data.x->reverse_gc);
3002 f->output_data.x->reverse_gc = 0;
3005 if (f->output_data.x->cursor_gc)
3007 XFreeGC (dpy, f->output_data.x->cursor_gc);
3008 f->output_data.x->cursor_gc = 0;
3011 if (f->output_data.x->border_tile)
3013 XFreePixmap (dpy, f->output_data.x->border_tile);
3014 f->output_data.x->border_tile = 0;
3017 UNBLOCK_INPUT;
3021 /* Handler for signals raised during x_create_frame and
3022 x_create_top_frame. FRAME is the frame which is partially
3023 constructed. */
3025 static Lisp_Object
3026 unwind_create_frame (frame)
3027 Lisp_Object frame;
3029 struct frame *f = XFRAME (frame);
3031 /* If frame is already dead, nothing to do. This can happen if the
3032 display is disconnected after the frame has become official, but
3033 before x_create_frame removes the unwind protect. */
3034 if (!FRAME_LIVE_P (f))
3035 return Qnil;
3037 /* If frame is ``official'', nothing to do. */
3038 if (!CONSP (Vframe_list) || !EQ (XCAR (Vframe_list), frame))
3040 #if GLYPH_DEBUG
3041 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
3042 #endif
3044 x_free_frame_resources (f);
3046 #if GLYPH_DEBUG
3047 /* Check that reference counts are indeed correct. */
3048 xassert (dpyinfo->reference_count == dpyinfo_refcount);
3049 xassert (dpyinfo->image_cache->refcount == image_cache_refcount);
3050 #endif
3051 return Qt;
3054 return Qnil;
3058 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
3059 1, 1, 0,
3060 doc: /* Make a new X window, which is called a "frame" in Emacs terms.
3061 Returns an Emacs frame object.
3062 ALIST is an alist of frame parameters.
3063 If the parameters specify that the frame should not have a minibuffer,
3064 and do not specify a specific minibuffer window to use,
3065 then `default-minibuffer-frame' must be a frame whose minibuffer can
3066 be shared by the new frame.
3068 This function is an internal primitive--use `make-frame' instead. */)
3069 (parms)
3070 Lisp_Object parms;
3072 struct frame *f;
3073 Lisp_Object frame, tem;
3074 Lisp_Object name;
3075 int minibuffer_only = 0;
3076 long window_prompting = 0;
3077 int width, height;
3078 int count = SPECPDL_INDEX ();
3079 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
3080 Lisp_Object display;
3081 struct x_display_info *dpyinfo = NULL;
3082 Lisp_Object parent;
3083 struct kboard *kb;
3085 parms = Fcopy_alist (parms);
3087 /* Use this general default value to start with
3088 until we know if this frame has a specified name. */
3089 Vx_resource_name = Vinvocation_name;
3091 display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_NUMBER);
3092 if (EQ (display, Qunbound))
3093 display = x_get_arg (dpyinfo, parms, Qdisplay, 0, 0, RES_TYPE_STRING);
3094 if (EQ (display, Qunbound))
3095 display = Qnil;
3096 dpyinfo = check_x_display_info (display);
3097 #ifdef MULTI_KBOARD
3098 kb = dpyinfo->terminal->kboard;
3099 #else
3100 kb = &the_only_kboard;
3101 #endif
3103 if (!dpyinfo->terminal->name)
3104 error ("Terminal is not live, can't create new frames on it");
3106 name = x_get_arg (dpyinfo, parms, Qname, "name", "Name", RES_TYPE_STRING);
3107 if (!STRINGP (name)
3108 && ! EQ (name, Qunbound)
3109 && ! NILP (name))
3110 error ("Invalid frame name--not a string or nil");
3112 if (STRINGP (name))
3113 Vx_resource_name = name;
3115 /* See if parent window is specified. */
3116 parent = x_get_arg (dpyinfo, parms, Qparent_id, NULL, NULL, RES_TYPE_NUMBER);
3117 if (EQ (parent, Qunbound))
3118 parent = Qnil;
3119 if (! NILP (parent))
3120 CHECK_NUMBER (parent);
3122 /* make_frame_without_minibuffer can run Lisp code and garbage collect. */
3123 /* No need to protect DISPLAY because that's not used after passing
3124 it to make_frame_without_minibuffer. */
3125 frame = Qnil;
3126 GCPRO4 (parms, parent, name, frame);
3127 tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
3128 RES_TYPE_SYMBOL);
3129 if (EQ (tem, Qnone) || NILP (tem))
3130 f = make_frame_without_minibuffer (Qnil, kb, display);
3131 else if (EQ (tem, Qonly))
3133 f = make_minibuffer_frame ();
3134 minibuffer_only = 1;
3136 else if (WINDOWP (tem))
3137 f = make_frame_without_minibuffer (tem, kb, display);
3138 else
3139 f = make_frame (1);
3141 XSETFRAME (frame, f);
3143 /* Note that X Windows does support scroll bars. */
3144 FRAME_CAN_HAVE_SCROLL_BARS (f) = 1;
3146 f->terminal = dpyinfo->terminal;
3147 f->terminal->reference_count++;
3149 f->output_method = output_x_window;
3150 f->output_data.x = (struct x_output *) xmalloc (sizeof (struct x_output));
3151 bzero (f->output_data.x, sizeof (struct x_output));
3152 f->output_data.x->icon_bitmap = -1;
3153 FRAME_FONTSET (f) = -1;
3154 f->output_data.x->scroll_bar_foreground_pixel = -1;
3155 f->output_data.x->scroll_bar_background_pixel = -1;
3156 #ifdef USE_TOOLKIT_SCROLL_BARS
3157 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
3158 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
3159 #endif /* USE_TOOLKIT_SCROLL_BARS */
3161 f->icon_name
3162 = x_get_arg (dpyinfo, parms, Qicon_name, "iconName", "Title",
3163 RES_TYPE_STRING);
3164 if (! STRINGP (f->icon_name))
3165 f->icon_name = Qnil;
3167 FRAME_X_DISPLAY_INFO (f) = dpyinfo;
3169 /* With FRAME_X_DISPLAY_INFO set up, this unwind-protect is safe. */
3170 record_unwind_protect (unwind_create_frame, frame);
3171 #if GLYPH_DEBUG
3172 image_cache_refcount = FRAME_X_IMAGE_CACHE (f)->refcount;
3173 dpyinfo_refcount = dpyinfo->reference_count;
3174 #endif /* GLYPH_DEBUG */
3176 /* These colors will be set anyway later, but it's important
3177 to get the color reference counts right, so initialize them! */
3179 Lisp_Object black;
3180 struct gcpro gcpro1;
3182 /* Function x_decode_color can signal an error. Make
3183 sure to initialize color slots so that we won't try
3184 to free colors we haven't allocated. */
3185 FRAME_FOREGROUND_PIXEL (f) = -1;
3186 FRAME_BACKGROUND_PIXEL (f) = -1;
3187 f->output_data.x->cursor_pixel = -1;
3188 f->output_data.x->cursor_foreground_pixel = -1;
3189 f->output_data.x->border_pixel = -1;
3190 f->output_data.x->mouse_pixel = -1;
3192 black = build_string ("black");
3193 GCPRO1 (black);
3194 FRAME_FOREGROUND_PIXEL (f)
3195 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3196 FRAME_BACKGROUND_PIXEL (f)
3197 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3198 f->output_data.x->cursor_pixel
3199 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3200 f->output_data.x->cursor_foreground_pixel
3201 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3202 f->output_data.x->border_pixel
3203 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3204 f->output_data.x->mouse_pixel
3205 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3206 UNGCPRO;
3209 /* Specify the parent under which to make this X window. */
3211 if (!NILP (parent))
3213 f->output_data.x->parent_desc = (Window) XFASTINT (parent);
3214 f->output_data.x->explicit_parent = 1;
3216 else
3218 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
3219 f->output_data.x->explicit_parent = 0;
3222 /* Set the name; the functions to which we pass f expect the name to
3223 be set. */
3224 if (EQ (name, Qunbound) || NILP (name))
3226 f->name = build_string (dpyinfo->x_id_name);
3227 f->explicit_name = 0;
3229 else
3231 f->name = name;
3232 f->explicit_name = 1;
3233 /* use the frame's title when getting resources for this frame. */
3234 specbind (Qx_resource_name, name);
3237 /* Extract the window parameters from the supplied values
3238 that are needed to determine window geometry. */
3240 Lisp_Object font;
3242 font = x_get_arg (dpyinfo, parms, Qfont, "font", "Font", RES_TYPE_STRING);
3244 BLOCK_INPUT;
3245 /* First, try whatever font the caller has specified. */
3246 if (STRINGP (font))
3248 tem = Fquery_fontset (font, Qnil);
3249 if (STRINGP (tem))
3250 font = x_new_fontset (f, SDATA (tem));
3251 else
3252 font = x_new_font (f, SDATA (font));
3255 /* Try out a font which we hope has bold and italic variations. */
3256 if (!STRINGP (font))
3257 font = x_new_font (f, "-adobe-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-1");
3258 if (!STRINGP (font))
3259 font = x_new_font (f, "-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-1");
3260 if (! STRINGP (font))
3261 font = x_new_font (f, "-*-*-medium-r-normal-*-*-140-*-*-c-*-iso8859-1");
3262 if (! STRINGP (font))
3263 /* This was formerly the first thing tried, but it finds too many fonts
3264 and takes too long. */
3265 font = x_new_font (f, "-*-*-medium-r-*-*-*-*-*-*-c-*-iso8859-1");
3266 /* If those didn't work, look for something which will at least work. */
3267 if (! STRINGP (font))
3268 font = x_new_font (f, "-*-fixed-*-*-*-*-*-140-*-*-c-*-iso8859-1");
3269 UNBLOCK_INPUT;
3270 if (! STRINGP (font))
3271 font = build_string ("fixed");
3273 x_set_frame_parameters (f, Fcons (Fcons (Qfont, font), Qnil));
3276 #ifdef USE_LUCID
3277 /* Prevent lwlib/xlwmenu.c from crashing because of a bug
3278 whereby it fails to get any font. */
3279 xlwmenu_default_font = FRAME_FONT (f);
3280 #endif
3282 x_default_parameter (f, parms, Qborder_width, make_number (2),
3283 "borderWidth", "BorderWidth", RES_TYPE_NUMBER);
3285 /* This defaults to 1 in order to match xterm. We recognize either
3286 internalBorderWidth or internalBorder (which is what xterm calls
3287 it). */
3288 if (NILP (Fassq (Qinternal_border_width, parms)))
3290 Lisp_Object value;
3292 value = x_get_arg (dpyinfo, parms, Qinternal_border_width,
3293 "internalBorder", "internalBorder", RES_TYPE_NUMBER);
3294 if (! EQ (value, Qunbound))
3295 parms = Fcons (Fcons (Qinternal_border_width, value),
3296 parms);
3298 x_default_parameter (f, parms, Qinternal_border_width, make_number (1),
3299 "internalBorderWidth", "internalBorderWidth",
3300 RES_TYPE_NUMBER);
3301 x_default_parameter (f, parms, Qvertical_scroll_bars, Qleft,
3302 "verticalScrollBars", "ScrollBars",
3303 RES_TYPE_SYMBOL);
3305 /* Also do the stuff which must be set before the window exists. */
3306 x_default_parameter (f, parms, Qforeground_color, build_string ("black"),
3307 "foreground", "Foreground", RES_TYPE_STRING);
3308 x_default_parameter (f, parms, Qbackground_color, build_string ("white"),
3309 "background", "Background", RES_TYPE_STRING);
3310 x_default_parameter (f, parms, Qmouse_color, build_string ("black"),
3311 "pointerColor", "Foreground", RES_TYPE_STRING);
3312 x_default_parameter (f, parms, Qcursor_color, build_string ("black"),
3313 "cursorColor", "Foreground", RES_TYPE_STRING);
3314 x_default_parameter (f, parms, Qborder_color, build_string ("black"),
3315 "borderColor", "BorderColor", RES_TYPE_STRING);
3316 x_default_parameter (f, parms, Qscreen_gamma, Qnil,
3317 "screenGamma", "ScreenGamma", RES_TYPE_FLOAT);
3318 x_default_parameter (f, parms, Qline_spacing, Qnil,
3319 "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
3320 x_default_parameter (f, parms, Qleft_fringe, Qnil,
3321 "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
3322 x_default_parameter (f, parms, Qright_fringe, Qnil,
3323 "rightFringe", "RightFringe", RES_TYPE_NUMBER);
3325 x_default_scroll_bar_color_parameter (f, parms, Qscroll_bar_foreground,
3326 "scrollBarForeground",
3327 "ScrollBarForeground", 1);
3328 x_default_scroll_bar_color_parameter (f, parms, Qscroll_bar_background,
3329 "scrollBarBackground",
3330 "ScrollBarBackground", 0);
3332 /* Init faces before x_default_parameter is called for scroll-bar
3333 parameters because that function calls x_set_scroll_bar_width,
3334 which calls change_frame_size, which calls Fset_window_buffer,
3335 which runs hooks, which call Fvertical_motion. At the end, we
3336 end up in init_iterator with a null face cache, which should not
3337 happen. */
3338 init_frame_faces (f);
3340 x_default_parameter (f, parms, Qmenu_bar_lines, make_number (1),
3341 "menuBar", "MenuBar", RES_TYPE_NUMBER);
3342 x_default_parameter (f, parms, Qtool_bar_lines, make_number (1),
3343 "toolBar", "ToolBar", RES_TYPE_NUMBER);
3344 x_default_parameter (f, parms, Qbuffer_predicate, Qnil,
3345 "bufferPredicate", "BufferPredicate",
3346 RES_TYPE_SYMBOL);
3347 x_default_parameter (f, parms, Qtitle, Qnil,
3348 "title", "Title", RES_TYPE_STRING);
3349 x_default_parameter (f, parms, Qwait_for_wm, Qt,
3350 "waitForWM", "WaitForWM", RES_TYPE_BOOLEAN);
3351 x_default_parameter (f, parms, Qfullscreen, Qnil,
3352 "fullscreen", "Fullscreen", RES_TYPE_SYMBOL);
3354 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
3356 /* Compute the size of the X window. */
3357 window_prompting = x_figure_window_size (f, parms, 1);
3359 tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
3360 f->no_split = minibuffer_only || EQ (tem, Qt);
3362 x_icon_verify (f, parms);
3364 /* Create the X widget or window. */
3365 #ifdef USE_X_TOOLKIT
3366 x_window (f, window_prompting, minibuffer_only);
3367 #else
3368 x_window (f);
3369 #endif
3371 x_icon (f, parms);
3372 x_make_gc (f);
3374 /* Now consider the frame official. */
3375 FRAME_X_DISPLAY_INFO (f)->reference_count++;
3376 Vframe_list = Fcons (frame, Vframe_list);
3378 /* We need to do this after creating the X window, so that the
3379 icon-creation functions can say whose icon they're describing. */
3380 x_default_parameter (f, parms, Qicon_type, Qt,
3381 "bitmapIcon", "BitmapIcon", RES_TYPE_SYMBOL);
3383 x_default_parameter (f, parms, Qauto_raise, Qnil,
3384 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
3385 x_default_parameter (f, parms, Qauto_lower, Qnil,
3386 "autoLower", "AutoRaiseLower", RES_TYPE_BOOLEAN);
3387 x_default_parameter (f, parms, Qcursor_type, Qbox,
3388 "cursorType", "CursorType", RES_TYPE_SYMBOL);
3389 x_default_parameter (f, parms, Qscroll_bar_width, Qnil,
3390 "scrollBarWidth", "ScrollBarWidth",
3391 RES_TYPE_NUMBER);
3393 /* Dimensions, especially FRAME_LINES (f), must be done via change_frame_size.
3394 Change will not be effected unless different from the current
3395 FRAME_LINES (f). */
3396 width = FRAME_COLS (f);
3397 height = FRAME_LINES (f);
3399 SET_FRAME_COLS (f, 0);
3400 FRAME_LINES (f) = 0;
3401 change_frame_size (f, height, width, 1, 0, 0);
3403 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
3404 /* Create the menu bar. */
3405 if (!minibuffer_only && FRAME_EXTERNAL_MENU_BAR (f))
3407 /* If this signals an error, we haven't set size hints for the
3408 frame and we didn't make it visible. */
3409 initialize_frame_menubar (f);
3411 #ifndef USE_GTK
3412 /* This is a no-op, except under Motif where it arranges the
3413 main window for the widgets on it. */
3414 lw_set_main_areas (f->output_data.x->column_widget,
3415 f->output_data.x->menubar_widget,
3416 f->output_data.x->edit_widget);
3417 #endif /* not USE_GTK */
3419 #endif /* USE_X_TOOLKIT || USE_GTK */
3421 /* Tell the server what size and position, etc, we want, and how
3422 badly we want them. This should be done after we have the menu
3423 bar so that its size can be taken into account. */
3424 BLOCK_INPUT;
3425 x_wm_set_size_hint (f, window_prompting, 0);
3426 UNBLOCK_INPUT;
3428 /* Make the window appear on the frame and enable display, unless
3429 the caller says not to. However, with explicit parent, Emacs
3430 cannot control visibility, so don't try. */
3431 if (! f->output_data.x->explicit_parent)
3433 Lisp_Object visibility;
3435 visibility = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0,
3436 RES_TYPE_SYMBOL);
3437 if (EQ (visibility, Qunbound))
3438 visibility = Qt;
3440 if (EQ (visibility, Qicon))
3441 x_iconify_frame (f);
3442 else if (! NILP (visibility))
3443 x_make_frame_visible (f);
3444 else
3445 /* Must have been Qnil. */
3449 /* Set the WM leader property. GTK does this itself, so this is not
3450 needed when using GTK. */
3451 if (dpyinfo->client_leader_window != 0)
3453 BLOCK_INPUT;
3454 XChangeProperty (FRAME_X_DISPLAY (f),
3455 FRAME_OUTER_WINDOW (f),
3456 dpyinfo->Xatom_wm_client_leader,
3457 XA_WINDOW, 32, PropModeReplace,
3458 (unsigned char *) &dpyinfo->client_leader_window, 1);
3459 UNBLOCK_INPUT;
3462 /* Initialize `default-minibuffer-frame' in case this is the first
3463 frame on this terminal. */
3464 if (FRAME_HAS_MINIBUF_P (f)
3465 && (!FRAMEP (kb->Vdefault_minibuffer_frame)
3466 || !FRAME_LIVE_P (XFRAME (kb->Vdefault_minibuffer_frame))))
3467 kb->Vdefault_minibuffer_frame = frame;
3469 /* All remaining specified parameters, which have not been "used"
3470 by x_get_arg and friends, now go in the misc. alist of the frame. */
3471 for (tem = parms; CONSP (tem); tem = XCDR (tem))
3472 if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
3473 f->param_alist = Fcons (XCAR (tem), f->param_alist);
3475 UNGCPRO;
3477 /* Make sure windows on this frame appear in calls to next-window
3478 and similar functions. */
3479 Vwindow_list = Qnil;
3481 return unbind_to (count, frame);
3485 /* FRAME is used only to get a handle on the X display. We don't pass the
3486 display info directly because we're called from frame.c, which doesn't
3487 know about that structure. */
3489 Lisp_Object
3490 x_get_focus_frame (frame)
3491 struct frame *frame;
3493 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (frame);
3494 Lisp_Object xfocus;
3495 if (! dpyinfo->x_focus_frame)
3496 return Qnil;
3498 XSETFRAME (xfocus, dpyinfo->x_focus_frame);
3499 return xfocus;
3503 /* In certain situations, when the window manager follows a
3504 click-to-focus policy, there seems to be no way around calling
3505 XSetInputFocus to give another frame the input focus .
3507 In an ideal world, XSetInputFocus should generally be avoided so
3508 that applications don't interfere with the window manager's focus
3509 policy. But I think it's okay to use when it's clearly done
3510 following a user-command. */
3512 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
3513 doc: /* Set the input focus to FRAME.
3514 FRAME nil means use the selected frame. */)
3515 (frame)
3516 Lisp_Object frame;
3518 struct frame *f = check_x_frame (frame);
3519 Display *dpy = FRAME_X_DISPLAY (f);
3521 BLOCK_INPUT;
3522 x_catch_errors (dpy);
3523 XSetInputFocus (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
3524 RevertToParent, CurrentTime);
3525 x_ewmh_activate_frame (f);
3526 x_uncatch_errors ();
3527 UNBLOCK_INPUT;
3529 return Qnil;
3533 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
3534 doc: /* Internal function called by `color-defined-p', which see. */)
3535 (color, frame)
3536 Lisp_Object color, frame;
3538 XColor foo;
3539 FRAME_PTR f = check_x_frame (frame);
3541 CHECK_STRING (color);
3543 if (x_defined_color (f, SDATA (color), &foo, 0))
3544 return Qt;
3545 else
3546 return Qnil;
3549 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
3550 doc: /* Internal function called by `color-values', which see. */)
3551 (color, frame)
3552 Lisp_Object color, frame;
3554 XColor foo;
3555 FRAME_PTR f = check_x_frame (frame);
3557 CHECK_STRING (color);
3559 if (x_defined_color (f, SDATA (color), &foo, 0))
3560 return list3 (make_number (foo.red),
3561 make_number (foo.green),
3562 make_number (foo.blue));
3563 else
3564 return Qnil;
3567 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
3568 doc: /* Internal function called by `display-color-p', which see. */)
3569 (terminal)
3570 Lisp_Object terminal;
3572 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3574 if (dpyinfo->n_planes <= 2)
3575 return Qnil;
3577 switch (dpyinfo->visual->class)
3579 case StaticColor:
3580 case PseudoColor:
3581 case TrueColor:
3582 case DirectColor:
3583 return Qt;
3585 default:
3586 return Qnil;
3590 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p, Sx_display_grayscale_p,
3591 0, 1, 0,
3592 doc: /* Return t if the X display supports shades of gray.
3593 Note that color displays do support shades of gray.
3594 The optional argument TERMINAL specifies which display to ask about.
3595 TERMINAL should be a terminal id, a frame or a display name (a string).
3596 If omitted or nil, that stands for the selected frame's display. */)
3597 (terminal)
3598 Lisp_Object terminal;
3600 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3602 if (dpyinfo->n_planes <= 1)
3603 return Qnil;
3605 switch (dpyinfo->visual->class)
3607 case StaticColor:
3608 case PseudoColor:
3609 case TrueColor:
3610 case DirectColor:
3611 case StaticGray:
3612 case GrayScale:
3613 return Qt;
3615 default:
3616 return Qnil;
3620 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
3621 0, 1, 0,
3622 doc: /* Returns the width in pixels of the X display TERMINAL.
3623 The optional argument TERMINAL specifies which display to ask about.
3624 TERMINAL should be a terminal id, a frame or a display name (a string).
3625 If omitted or nil, that stands for the selected frame's display. */)
3626 (terminal)
3627 Lisp_Object terminal;
3629 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3631 return make_number (dpyinfo->width);
3634 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
3635 Sx_display_pixel_height, 0, 1, 0,
3636 doc: /* Returns the height in pixels of the X display TERMINAL.
3637 The optional argument TERMINAL specifies which display to ask about.
3638 TERMINAL should be a terminal id, a frame or a display name (a string).
3639 If omitted or nil, that stands for the selected frame's display. */)
3640 (terminal)
3641 Lisp_Object terminal;
3643 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3645 return make_number (dpyinfo->height);
3648 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
3649 0, 1, 0,
3650 doc: /* Returns the number of bitplanes of the X display TERMINAL.
3651 The optional argument TERMINAL specifies which display to ask about.
3652 TERMINAL should be a terminal id, a frame or a display name (a string).
3653 If omitted or nil, that stands for the selected frame's display. */)
3654 (terminal)
3655 Lisp_Object terminal;
3657 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3659 return make_number (dpyinfo->n_planes);
3662 DEFUN ("x-display-color-cells", Fx_display_color_cells, Sx_display_color_cells,
3663 0, 1, 0,
3664 doc: /* Returns the number of color cells of the X display TERMINAL.
3665 The optional argument TERMINAL specifies which display to ask about.
3666 TERMINAL should be a terminal id, a frame or a display name (a string).
3667 If omitted or nil, that stands for the selected frame's display. */)
3668 (terminal)
3669 Lisp_Object terminal;
3671 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3673 int nr_planes = DisplayPlanes (dpyinfo->display,
3674 XScreenNumberOfScreen (dpyinfo->screen));
3676 /* Truncate nr_planes to 24 to avoid integer overflow.
3677 Some displays says 32, but only 24 bits are actually significant.
3678 There are only very few and rare video cards that have more than
3679 24 significant bits. Also 24 bits is more than 16 million colors,
3680 it "should be enough for everyone". */
3681 if (nr_planes > 24) nr_planes = 24;
3683 return make_number (1 << nr_planes);
3686 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
3687 Sx_server_max_request_size,
3688 0, 1, 0,
3689 doc: /* Returns the maximum request size of the X server of display TERMINAL.
3690 The optional argument TERMINAL specifies which display to ask about.
3691 TERMINAL should be a terminal id, a frame or a display name (a string).
3692 If omitted or nil, that stands for the selected frame's display. */)
3693 (terminal)
3694 Lisp_Object terminal;
3696 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3698 return make_number (MAXREQUEST (dpyinfo->display));
3701 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
3702 doc: /* Returns the "vendor ID" string of the X server of display TERMINAL.
3703 \(Labelling every distributor as a "vendor" embodies the false assumption
3704 that operating systems cannot be developed and distributed noncommercially.)
3705 The optional argument TERMINAL specifies which display to ask about.
3706 TERMINAL should be a terminal id, a frame or a display name (a string).
3707 If omitted or nil, that stands for the selected frame's display. */)
3708 (terminal)
3709 Lisp_Object terminal;
3711 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3712 char *vendor = ServerVendor (dpyinfo->display);
3714 if (! vendor) vendor = "";
3715 return build_string (vendor);
3718 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
3719 doc: /* Returns the version numbers of the X server of display TERMINAL.
3720 The value is a list of three integers: the major and minor
3721 version numbers of the X Protocol in use, and the distributor-specific release
3722 number. See also the function `x-server-vendor'.
3724 The optional argument TERMINAL specifies which display to ask about.
3725 TERMINAL should be a terminal id, a frame or a display name (a string).
3726 If omitted or nil, that stands for the selected frame's display. */)
3727 (terminal)
3728 Lisp_Object terminal;
3730 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3731 Display *dpy = dpyinfo->display;
3733 return Fcons (make_number (ProtocolVersion (dpy)),
3734 Fcons (make_number (ProtocolRevision (dpy)),
3735 Fcons (make_number (VendorRelease (dpy)), Qnil)));
3738 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
3739 doc: /* Return the number of screens on the X server of display TERMINAL.
3740 The optional argument TERMINAL specifies which display to ask about.
3741 TERMINAL should be a terminal id, a frame or a display name (a string).
3742 If omitted or nil, that stands for the selected frame's display. */)
3743 (terminal)
3744 Lisp_Object terminal;
3746 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3748 return make_number (ScreenCount (dpyinfo->display));
3751 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height, 0, 1, 0,
3752 doc: /* Return the height in millimeters of the X display TERMINAL.
3753 The optional argument TERMINAL specifies which display to ask about.
3754 TERMINAL should be a terminal id, a frame or a display name (a string).
3755 If omitted or nil, that stands for the selected frame's display. */)
3756 (terminal)
3757 Lisp_Object terminal;
3759 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3761 return make_number (HeightMMOfScreen (dpyinfo->screen));
3764 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width, 0, 1, 0,
3765 doc: /* Return the width in millimeters of the X display TERMINAL.
3766 The optional argument TERMINAL specifies which display to ask about.
3767 TERMINAL should be a terminal id, a frame or a display name (a string).
3768 If omitted or nil, that stands for the selected frame's display. */)
3769 (terminal)
3770 Lisp_Object terminal;
3772 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3774 return make_number (WidthMMOfScreen (dpyinfo->screen));
3777 DEFUN ("x-display-backing-store", Fx_display_backing_store,
3778 Sx_display_backing_store, 0, 1, 0,
3779 doc: /* Returns an indication of whether X display TERMINAL does backing store.
3780 The value may be `always', `when-mapped', or `not-useful'.
3781 The optional argument TERMINAL specifies which display to ask about.
3782 TERMINAL should be a terminal id, a frame or a display name (a string).
3783 If omitted or nil, that stands for the selected frame's display. */)
3784 (terminal)
3785 Lisp_Object terminal;
3787 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3788 Lisp_Object result;
3790 switch (DoesBackingStore (dpyinfo->screen))
3792 case Always:
3793 result = intern ("always");
3794 break;
3796 case WhenMapped:
3797 result = intern ("when-mapped");
3798 break;
3800 case NotUseful:
3801 result = intern ("not-useful");
3802 break;
3804 default:
3805 error ("Strange value for BackingStore parameter of screen");
3806 result = Qnil;
3809 return result;
3812 DEFUN ("x-display-visual-class", Fx_display_visual_class,
3813 Sx_display_visual_class, 0, 1, 0,
3814 doc: /* Return the visual class of the X display TERMINAL.
3815 The value is one of the symbols `static-gray', `gray-scale',
3816 `static-color', `pseudo-color', `true-color', or `direct-color'.
3818 The optional argument TERMINAL specifies which display to ask about.
3819 TERMINAL should a terminal id, a frame or a display name (a string).
3820 If omitted or nil, that stands for the selected frame's display. */)
3821 (terminal)
3822 Lisp_Object terminal;
3824 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3825 Lisp_Object result;
3827 switch (dpyinfo->visual->class)
3829 case StaticGray:
3830 result = intern ("static-gray");
3831 break;
3832 case GrayScale:
3833 result = intern ("gray-scale");
3834 break;
3835 case StaticColor:
3836 result = intern ("static-color");
3837 break;
3838 case PseudoColor:
3839 result = intern ("pseudo-color");
3840 break;
3841 case TrueColor:
3842 result = intern ("true-color");
3843 break;
3844 case DirectColor:
3845 result = intern ("direct-color");
3846 break;
3847 default:
3848 error ("Display has an unknown visual class");
3849 result = Qnil;
3852 return result;
3855 DEFUN ("x-display-save-under", Fx_display_save_under,
3856 Sx_display_save_under, 0, 1, 0,
3857 doc: /* Returns t if the X display TERMINAL supports the save-under feature.
3858 The optional argument TERMINAL specifies which display to ask about.
3859 TERMINAL should be a terminal id, a frame or a display name (a string).
3860 If omitted or nil, that stands for the selected frame's display. */)
3861 (terminal)
3862 Lisp_Object terminal;
3864 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3866 if (DoesSaveUnders (dpyinfo->screen) == True)
3867 return Qt;
3868 else
3869 return Qnil;
3873 x_pixel_width (f)
3874 register struct frame *f;
3876 return FRAME_PIXEL_WIDTH (f);
3880 x_pixel_height (f)
3881 register struct frame *f;
3883 return FRAME_PIXEL_HEIGHT (f);
3887 x_char_width (f)
3888 register struct frame *f;
3890 return FRAME_COLUMN_WIDTH (f);
3894 x_char_height (f)
3895 register struct frame *f;
3897 return FRAME_LINE_HEIGHT (f);
3901 x_screen_planes (f)
3902 register struct frame *f;
3904 return FRAME_X_DISPLAY_INFO (f)->n_planes;
3909 /************************************************************************
3910 X Displays
3911 ************************************************************************/
3914 /* Mapping visual names to visuals. */
3916 static struct visual_class
3918 char *name;
3919 int class;
3921 visual_classes[] =
3923 {"StaticGray", StaticGray},
3924 {"GrayScale", GrayScale},
3925 {"StaticColor", StaticColor},
3926 {"PseudoColor", PseudoColor},
3927 {"TrueColor", TrueColor},
3928 {"DirectColor", DirectColor},
3929 {NULL, 0}
3933 #ifndef HAVE_XSCREENNUMBEROFSCREEN
3935 /* Value is the screen number of screen SCR. This is a substitute for
3936 the X function with the same name when that doesn't exist. */
3939 XScreenNumberOfScreen (scr)
3940 register Screen *scr;
3942 Display *dpy = scr->display;
3943 int i;
3945 for (i = 0; i < dpy->nscreens; ++i)
3946 if (scr == dpy->screens + i)
3947 break;
3949 return i;
3952 #endif /* not HAVE_XSCREENNUMBEROFSCREEN */
3955 /* Select the visual that should be used on display DPYINFO. Set
3956 members of DPYINFO appropriately. Called from x_term_init. */
3958 void
3959 select_visual (dpyinfo)
3960 struct x_display_info *dpyinfo;
3962 Display *dpy = dpyinfo->display;
3963 Screen *screen = dpyinfo->screen;
3964 Lisp_Object value;
3966 /* See if a visual is specified. */
3967 value = display_x_get_resource (dpyinfo,
3968 build_string ("visualClass"),
3969 build_string ("VisualClass"),
3970 Qnil, Qnil);
3971 if (STRINGP (value))
3973 /* VALUE should be of the form CLASS-DEPTH, where CLASS is one
3974 of `PseudoColor', `TrueColor' etc. and DEPTH is the color
3975 depth, a decimal number. NAME is compared with case ignored. */
3976 char *s = (char *) alloca (SBYTES (value) + 1);
3977 char *dash;
3978 int i, class = -1;
3979 XVisualInfo vinfo;
3981 strcpy (s, SDATA (value));
3982 dash = index (s, '-');
3983 if (dash)
3985 dpyinfo->n_planes = atoi (dash + 1);
3986 *dash = '\0';
3988 else
3989 /* We won't find a matching visual with depth 0, so that
3990 an error will be printed below. */
3991 dpyinfo->n_planes = 0;
3993 /* Determine the visual class. */
3994 for (i = 0; visual_classes[i].name; ++i)
3995 if (xstricmp (s, visual_classes[i].name) == 0)
3997 class = visual_classes[i].class;
3998 break;
4001 /* Look up a matching visual for the specified class. */
4002 if (class == -1
4003 || !XMatchVisualInfo (dpy, XScreenNumberOfScreen (screen),
4004 dpyinfo->n_planes, class, &vinfo))
4005 fatal ("Invalid visual specification `%s'", SDATA (value));
4007 dpyinfo->visual = vinfo.visual;
4009 else
4011 int n_visuals;
4012 XVisualInfo *vinfo, vinfo_template;
4014 dpyinfo->visual = DefaultVisualOfScreen (screen);
4016 #ifdef HAVE_X11R4
4017 vinfo_template.visualid = XVisualIDFromVisual (dpyinfo->visual);
4018 #else
4019 vinfo_template.visualid = dpyinfo->visual->visualid;
4020 #endif
4021 vinfo_template.screen = XScreenNumberOfScreen (screen);
4022 vinfo = XGetVisualInfo (dpy, VisualIDMask | VisualScreenMask,
4023 &vinfo_template, &n_visuals);
4024 if (n_visuals != 1)
4025 fatal ("Can't get proper X visual info");
4027 dpyinfo->n_planes = vinfo->depth;
4028 XFree ((char *) vinfo);
4033 /* Return the X display structure for the display named NAME.
4034 Open a new connection if necessary. */
4036 struct x_display_info *
4037 x_display_info_for_name (name)
4038 Lisp_Object name;
4040 Lisp_Object names;
4041 struct x_display_info *dpyinfo;
4043 CHECK_STRING (name);
4045 #if 0
4046 if (! EQ (Vinitial_window_system, intern ("x")))
4047 error ("Not using X Windows"); /* That doesn't stop us anymore. */
4048 #endif
4050 for (dpyinfo = x_display_list, names = x_display_name_list;
4051 dpyinfo;
4052 dpyinfo = dpyinfo->next, names = XCDR (names))
4054 Lisp_Object tem;
4055 tem = Fstring_equal (XCAR (XCAR (names)), name);
4056 if (!NILP (tem))
4057 return dpyinfo;
4060 /* Use this general default value to start with. */
4061 Vx_resource_name = Vinvocation_name;
4063 validate_x_resource_name ();
4065 dpyinfo = x_term_init (name, (char *)0,
4066 (char *) SDATA (Vx_resource_name));
4068 if (dpyinfo == 0)
4069 error ("Cannot connect to X server %s", SDATA (name));
4071 x_in_use = 1;
4072 XSETFASTINT (Vwindow_system_version, 11);
4074 return dpyinfo;
4078 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
4079 1, 3, 0,
4080 doc: /* Open a connection to an X server.
4081 DISPLAY is the name of the display to connect to.
4082 Optional second arg XRM-STRING is a string of resources in xrdb format.
4083 If the optional third arg MUST-SUCCEED is non-nil,
4084 terminate Emacs if we can't open the connection. */)
4085 (display, xrm_string, must_succeed)
4086 Lisp_Object display, xrm_string, must_succeed;
4088 unsigned char *xrm_option;
4089 struct x_display_info *dpyinfo;
4091 CHECK_STRING (display);
4092 if (! NILP (xrm_string))
4093 CHECK_STRING (xrm_string);
4095 #if 0
4096 if (! EQ (Vinitial_window_system, intern ("x")))
4097 error ("Not using X Windows"); /* That doesn't stop us anymore. */
4098 #endif
4100 if (! NILP (xrm_string))
4101 xrm_option = (unsigned char *) SDATA (xrm_string);
4102 else
4103 xrm_option = (unsigned char *) 0;
4105 validate_x_resource_name ();
4107 /* This is what opens the connection and sets x_current_display.
4108 This also initializes many symbols, such as those used for input. */
4109 dpyinfo = x_term_init (display, xrm_option,
4110 (char *) SDATA (Vx_resource_name));
4112 if (dpyinfo == 0)
4114 if (!NILP (must_succeed))
4115 fatal ("Cannot connect to X server %s.\n\
4116 Check the DISPLAY environment variable or use `-d'.\n\
4117 Also use the `xauth' program to verify that you have the proper\n\
4118 authorization information needed to connect the X server.\n\
4119 An insecure way to solve the problem may be to use `xhost'.\n",
4120 SDATA (display));
4121 else
4122 error ("Cannot connect to X server %s", SDATA (display));
4125 x_in_use = 1;
4127 XSETFASTINT (Vwindow_system_version, 11);
4128 return Qnil;
4131 DEFUN ("x-close-connection", Fx_close_connection,
4132 Sx_close_connection, 1, 1, 0,
4133 doc: /* Close the connection to TERMINAL's X server.
4134 For TERMINAL, specify a terminal id, a frame or a display name (a
4135 string). If TERMINAL is nil, that stands for the selected frame's
4136 terminal. */)
4137 (terminal)
4138 Lisp_Object terminal;
4140 struct x_display_info *dpyinfo = check_x_display_info (terminal);
4142 if (dpyinfo->reference_count > 0)
4143 error ("Display still has frames on it");
4145 x_delete_terminal (dpyinfo->terminal);
4147 return Qnil;
4150 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
4151 doc: /* Return the list of display names that Emacs has connections to. */)
4154 Lisp_Object tail, result;
4156 result = Qnil;
4157 for (tail = x_display_name_list; CONSP (tail); tail = XCDR (tail))
4158 result = Fcons (XCAR (XCAR (tail)), result);
4160 return result;
4163 DEFUN ("x-synchronize", Fx_synchronize, Sx_synchronize, 1, 2, 0,
4164 doc: /* If ON is non-nil, report X errors as soon as the erring request is made.
4165 If ON is nil, allow buffering of requests.
4166 Turning on synchronization prohibits the Xlib routines from buffering
4167 requests and seriously degrades performance, but makes debugging much
4168 easier.
4169 The optional second argument TERMINAL specifies which display to act on.
4170 TERMINAL should be a terminal id, a frame or a display name (a string).
4171 If TERMINAL is omitted or nil, that stands for the selected frame's display. */)
4172 (on, terminal)
4173 Lisp_Object terminal, on;
4175 struct x_display_info *dpyinfo = check_x_display_info (terminal);
4177 XSynchronize (dpyinfo->display, !EQ (on, Qnil));
4179 return Qnil;
4182 /* Wait for responses to all X commands issued so far for frame F. */
4184 void
4185 x_sync (f)
4186 FRAME_PTR f;
4188 BLOCK_INPUT;
4189 XSync (FRAME_X_DISPLAY (f), False);
4190 UNBLOCK_INPUT;
4194 /***********************************************************************
4195 Window properties
4196 ***********************************************************************/
4198 DEFUN ("x-change-window-property", Fx_change_window_property,
4199 Sx_change_window_property, 2, 6, 0,
4200 doc: /* Change window property PROP to VALUE on the X window of FRAME.
4201 PROP must be a string.
4202 VALUE may be a string or a list of conses, numbers and/or strings.
4203 If an element in the list is a string, it is converted to
4204 an Atom and the value of the Atom is used. If an element is a cons,
4205 it is converted to a 32 bit number where the car is the 16 top bits and the
4206 cdr is the lower 16 bits.
4207 FRAME nil or omitted means use the selected frame.
4208 If TYPE is given and non-nil, it is the name of the type of VALUE.
4209 If TYPE is not given or nil, the type is STRING.
4210 FORMAT gives the size in bits of each element if VALUE is a list.
4211 It must be one of 8, 16 or 32.
4212 If VALUE is a string or FORMAT is nil or not given, FORMAT defaults to 8.
4213 If OUTER_P is non-nil, the property is changed for the outer X window of
4214 FRAME. Default is to change on the edit X window.
4216 Value is VALUE. */)
4217 (prop, value, frame, type, format, outer_p)
4218 Lisp_Object prop, value, frame, type, format, outer_p;
4220 struct frame *f = check_x_frame (frame);
4221 Atom prop_atom;
4222 Atom target_type = XA_STRING;
4223 int element_format = 8;
4224 unsigned char *data;
4225 int nelements;
4226 Window w;
4228 CHECK_STRING (prop);
4230 if (! NILP (format))
4232 CHECK_NUMBER (format);
4233 element_format = XFASTINT (format);
4235 if (element_format != 8 && element_format != 16
4236 && element_format != 32)
4237 error ("FORMAT must be one of 8, 16 or 32");
4240 if (CONSP (value))
4242 nelements = x_check_property_data (value);
4243 if (nelements == -1)
4244 error ("Bad data in VALUE, must be number, string or cons");
4246 if (element_format == 8)
4247 data = (unsigned char *) xmalloc (nelements);
4248 else if (element_format == 16)
4249 data = (unsigned char *) xmalloc (nelements*2);
4250 else /* format == 32 */
4251 /* The man page for XChangeProperty:
4252 "If the specified format is 32, the property data must be a
4253 long array."
4254 This applies even if long is more than 64 bits. The X library
4255 converts to 32 bits before sending to the X server. */
4256 data = (unsigned char *) xmalloc (nelements * sizeof(long));
4258 x_fill_property_data (FRAME_X_DISPLAY (f), value, data, element_format);
4260 else
4262 CHECK_STRING (value);
4263 data = SDATA (value);
4264 nelements = SCHARS (value);
4267 BLOCK_INPUT;
4268 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SDATA (prop), False);
4269 if (! NILP (type))
4271 CHECK_STRING (type);
4272 target_type = XInternAtom (FRAME_X_DISPLAY (f), SDATA (type), False);
4275 if (! NILP (outer_p)) w = FRAME_OUTER_WINDOW (f);
4276 else w = FRAME_X_WINDOW (f);
4278 XChangeProperty (FRAME_X_DISPLAY (f), w,
4279 prop_atom, target_type, element_format, PropModeReplace,
4280 data, nelements);
4282 if (CONSP (value)) xfree (data);
4284 /* Make sure the property is set when we return. */
4285 XFlush (FRAME_X_DISPLAY (f));
4286 UNBLOCK_INPUT;
4288 return value;
4292 DEFUN ("x-delete-window-property", Fx_delete_window_property,
4293 Sx_delete_window_property, 1, 2, 0,
4294 doc: /* Remove window property PROP from X window of FRAME.
4295 FRAME nil or omitted means use the selected frame. Value is PROP. */)
4296 (prop, frame)
4297 Lisp_Object prop, frame;
4299 struct frame *f = check_x_frame (frame);
4300 Atom prop_atom;
4302 CHECK_STRING (prop);
4303 BLOCK_INPUT;
4304 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SDATA (prop), False);
4305 XDeleteProperty (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), prop_atom);
4307 /* Make sure the property is removed when we return. */
4308 XFlush (FRAME_X_DISPLAY (f));
4309 UNBLOCK_INPUT;
4311 return prop;
4315 DEFUN ("x-window-property", Fx_window_property, Sx_window_property,
4316 1, 6, 0,
4317 doc: /* Value is the value of window property PROP on FRAME.
4318 If FRAME is nil or omitted, use the selected frame.
4319 If TYPE is nil or omitted, get the property as a string. Otherwise TYPE
4320 is the name of the Atom that denotes the type expected.
4321 If SOURCE is non-nil, get the property on that window instead of from
4322 FRAME. The number 0 denotes the root window.
4323 If DELETE_P is non-nil, delete the property after retreiving it.
4324 If VECTOR_RET_P is non-nil, don't return a string but a vector of values.
4326 Value is nil if FRAME hasn't a property with name PROP or if PROP has
4327 no value of TYPE. */)
4328 (prop, frame, type, source, delete_p, vector_ret_p)
4329 Lisp_Object prop, frame, type, source, delete_p, vector_ret_p;
4331 struct frame *f = check_x_frame (frame);
4332 Atom prop_atom;
4333 int rc;
4334 Lisp_Object prop_value = Qnil;
4335 unsigned char *tmp_data = NULL;
4336 Atom actual_type;
4337 Atom target_type = XA_STRING;
4338 int actual_format;
4339 unsigned long actual_size, bytes_remaining;
4340 Window target_window = FRAME_X_WINDOW (f);
4341 struct gcpro gcpro1;
4343 GCPRO1 (prop_value);
4344 CHECK_STRING (prop);
4346 if (! NILP (source))
4348 if (NUMBERP (source))
4350 if (FLOATP (source))
4351 target_window = (Window) XFLOAT (source);
4352 else
4353 target_window = XFASTINT (source);
4355 if (target_window == 0)
4356 target_window = FRAME_X_DISPLAY_INFO (f)->root_window;
4358 else if (CONSP (source))
4359 target_window = cons_to_long (source);
4362 BLOCK_INPUT;
4363 if (STRINGP (type))
4365 if (strcmp ("AnyPropertyType", SDATA (type)) == 0)
4366 target_type = AnyPropertyType;
4367 else
4368 target_type = XInternAtom (FRAME_X_DISPLAY (f), SDATA (type), False);
4371 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SDATA (prop), False);
4372 rc = XGetWindowProperty (FRAME_X_DISPLAY (f), target_window,
4373 prop_atom, 0, 0, False, target_type,
4374 &actual_type, &actual_format, &actual_size,
4375 &bytes_remaining, &tmp_data);
4376 if (rc == Success)
4378 int size = bytes_remaining;
4380 XFree (tmp_data);
4381 tmp_data = NULL;
4383 rc = XGetWindowProperty (FRAME_X_DISPLAY (f), target_window,
4384 prop_atom, 0, bytes_remaining,
4385 ! NILP (delete_p), target_type,
4386 &actual_type, &actual_format,
4387 &actual_size, &bytes_remaining,
4388 &tmp_data);
4389 if (rc == Success && tmp_data)
4391 /* The man page for XGetWindowProperty says:
4392 "If the returned format is 32, the returned data is represented
4393 as a long array and should be cast to that type to obtain the
4394 elements."
4395 This applies even if long is more than 32 bits, the X library
4396 converts from 32 bit elements received from the X server to long
4397 and passes the long array to us. Thus, for that case bcopy can not
4398 be used. We convert to a 32 bit type here, because so much code
4399 assume on that.
4401 The bytes and offsets passed to XGetWindowProperty refers to the
4402 property and those are indeed in 32 bit quantities if format is
4403 32. */
4405 if (actual_format == 32 && actual_format < BITS_PER_LONG)
4407 unsigned long i;
4408 int *idata = (int *) tmp_data;
4409 long *ldata = (long *) tmp_data;
4411 for (i = 0; i < actual_size; ++i)
4412 idata[i] = (int) ldata[i];
4415 if (NILP (vector_ret_p))
4416 prop_value = make_string (tmp_data, size);
4417 else
4418 prop_value = x_property_data_to_lisp (f,
4419 tmp_data,
4420 actual_type,
4421 actual_format,
4422 actual_size);
4425 if (tmp_data) XFree (tmp_data);
4428 UNBLOCK_INPUT;
4429 UNGCPRO;
4430 return prop_value;
4435 /***********************************************************************
4436 Busy cursor
4437 ***********************************************************************/
4439 /* If non-null, an asynchronous timer that, when it expires, displays
4440 an hourglass cursor on all frames. */
4442 static struct atimer *hourglass_atimer;
4444 /* Non-zero means an hourglass cursor is currently shown. */
4446 static int hourglass_shown_p;
4448 /* Number of seconds to wait before displaying an hourglass cursor. */
4450 static Lisp_Object Vhourglass_delay;
4452 /* Default number of seconds to wait before displaying an hourglass
4453 cursor. */
4455 #define DEFAULT_HOURGLASS_DELAY 1
4457 /* Function prototypes. */
4459 static void show_hourglass P_ ((struct atimer *));
4460 static void hide_hourglass P_ ((void));
4462 /* Return non-zero if houglass timer has been started or hourglass is shown. */
4465 hourglass_started ()
4467 return hourglass_shown_p || hourglass_atimer != NULL;
4471 /* Cancel a currently active hourglass timer, and start a new one. */
4473 void
4474 start_hourglass ()
4476 EMACS_TIME delay;
4477 int secs, usecs = 0;
4479 cancel_hourglass ();
4481 if (INTEGERP (Vhourglass_delay)
4482 && XINT (Vhourglass_delay) > 0)
4483 secs = XFASTINT (Vhourglass_delay);
4484 else if (FLOATP (Vhourglass_delay)
4485 && XFLOAT_DATA (Vhourglass_delay) > 0)
4487 Lisp_Object tem;
4488 tem = Ftruncate (Vhourglass_delay, Qnil);
4489 secs = XFASTINT (tem);
4490 usecs = (XFLOAT_DATA (Vhourglass_delay) - secs) * 1000000;
4492 else
4493 secs = DEFAULT_HOURGLASS_DELAY;
4495 EMACS_SET_SECS_USECS (delay, secs, usecs);
4496 hourglass_atimer = start_atimer (ATIMER_RELATIVE, delay,
4497 show_hourglass, NULL);
4501 /* Cancel the hourglass cursor timer if active, hide a busy cursor if
4502 shown. */
4504 void
4505 cancel_hourglass ()
4507 if (hourglass_atimer)
4509 cancel_atimer (hourglass_atimer);
4510 hourglass_atimer = NULL;
4513 if (hourglass_shown_p)
4514 hide_hourglass ();
4518 /* Timer function of hourglass_atimer. TIMER is equal to
4519 hourglass_atimer.
4521 Display an hourglass pointer on all frames by mapping the frames'
4522 hourglass_window. Set the hourglass_p flag in the frames'
4523 output_data.x structure to indicate that an hourglass cursor is
4524 shown on the frames. */
4526 static void
4527 show_hourglass (timer)
4528 struct atimer *timer;
4530 /* The timer implementation will cancel this timer automatically
4531 after this function has run. Set hourglass_atimer to null
4532 so that we know the timer doesn't have to be canceled. */
4533 hourglass_atimer = NULL;
4535 if (!hourglass_shown_p)
4537 Lisp_Object rest, frame;
4539 BLOCK_INPUT;
4541 FOR_EACH_FRAME (rest, frame)
4543 struct frame *f = XFRAME (frame);
4545 if (FRAME_LIVE_P (f) && FRAME_X_P (f) && FRAME_X_DISPLAY (f))
4547 Display *dpy = FRAME_X_DISPLAY (f);
4549 #ifdef USE_X_TOOLKIT
4550 if (f->output_data.x->widget)
4551 #else
4552 if (FRAME_OUTER_WINDOW (f))
4553 #endif
4555 f->output_data.x->hourglass_p = 1;
4557 if (!f->output_data.x->hourglass_window)
4559 unsigned long mask = CWCursor;
4560 XSetWindowAttributes attrs;
4561 #ifdef USE_GTK
4562 Window parent = FRAME_X_WINDOW (f);
4563 #else
4564 Window parent = FRAME_OUTER_WINDOW (f);
4565 #endif
4566 attrs.cursor = f->output_data.x->hourglass_cursor;
4568 f->output_data.x->hourglass_window
4569 = XCreateWindow (dpy, parent,
4570 0, 0, 32000, 32000, 0, 0,
4571 InputOnly,
4572 CopyFromParent,
4573 mask, &attrs);
4576 XMapRaised (dpy, f->output_data.x->hourglass_window);
4577 XFlush (dpy);
4582 hourglass_shown_p = 1;
4583 UNBLOCK_INPUT;
4588 /* Hide the hourglass pointer on all frames, if it is currently
4589 shown. */
4591 static void
4592 hide_hourglass ()
4594 if (hourglass_shown_p)
4596 Lisp_Object rest, frame;
4598 BLOCK_INPUT;
4599 FOR_EACH_FRAME (rest, frame)
4601 struct frame *f = XFRAME (frame);
4603 if (FRAME_X_P (f)
4604 /* Watch out for newly created frames. */
4605 && f->output_data.x->hourglass_window)
4607 XUnmapWindow (FRAME_X_DISPLAY (f),
4608 f->output_data.x->hourglass_window);
4609 /* Sync here because XTread_socket looks at the
4610 hourglass_p flag that is reset to zero below. */
4611 XSync (FRAME_X_DISPLAY (f), False);
4612 f->output_data.x->hourglass_p = 0;
4616 hourglass_shown_p = 0;
4617 UNBLOCK_INPUT;
4623 /***********************************************************************
4624 Tool tips
4625 ***********************************************************************/
4627 static Lisp_Object x_create_tip_frame P_ ((struct x_display_info *,
4628 Lisp_Object, Lisp_Object));
4629 static void compute_tip_xy P_ ((struct frame *, Lisp_Object, Lisp_Object,
4630 Lisp_Object, int, int, int *, int *));
4632 /* The frame of a currently visible tooltip. */
4634 Lisp_Object tip_frame;
4636 /* If non-nil, a timer started that hides the last tooltip when it
4637 fires. */
4639 Lisp_Object tip_timer;
4640 Window tip_window;
4642 /* If non-nil, a vector of 3 elements containing the last args
4643 with which x-show-tip was called. See there. */
4645 Lisp_Object last_show_tip_args;
4647 /* Maximum size for tooltips; a cons (COLUMNS . ROWS). */
4649 Lisp_Object Vx_max_tooltip_size;
4652 static Lisp_Object
4653 unwind_create_tip_frame (frame)
4654 Lisp_Object frame;
4656 Lisp_Object deleted;
4658 deleted = unwind_create_frame (frame);
4659 if (EQ (deleted, Qt))
4661 tip_window = None;
4662 tip_frame = Qnil;
4665 return deleted;
4669 /* Create a frame for a tooltip on the display described by DPYINFO.
4670 PARMS is a list of frame parameters. TEXT is the string to
4671 display in the tip frame. Value is the frame.
4673 Note that functions called here, esp. x_default_parameter can
4674 signal errors, for instance when a specified color name is
4675 undefined. We have to make sure that we're in a consistent state
4676 when this happens. */
4678 static Lisp_Object
4679 x_create_tip_frame (dpyinfo, parms, text)
4680 struct x_display_info *dpyinfo;
4681 Lisp_Object parms, text;
4683 struct frame *f;
4684 Lisp_Object frame, tem;
4685 Lisp_Object name;
4686 long window_prompting = 0;
4687 int width, height;
4688 int count = SPECPDL_INDEX ();
4689 struct gcpro gcpro1, gcpro2, gcpro3;
4690 int face_change_count_before = face_change_count;
4691 Lisp_Object buffer;
4692 struct buffer *old_buffer;
4694 check_x ();
4696 if (!dpyinfo->terminal->name)
4697 error ("Terminal is not live, can't create new frames on it");
4699 parms = Fcopy_alist (parms);
4701 /* Get the name of the frame to use for resource lookup. */
4702 name = x_get_arg (dpyinfo, parms, Qname, "name", "Name", RES_TYPE_STRING);
4703 if (!STRINGP (name)
4704 && !EQ (name, Qunbound)
4705 && !NILP (name))
4706 error ("Invalid frame name--not a string or nil");
4708 frame = Qnil;
4709 GCPRO3 (parms, name, frame);
4710 f = make_frame (1);
4711 XSETFRAME (frame, f);
4713 buffer = Fget_buffer_create (build_string (" *tip*"));
4714 Fset_window_buffer (FRAME_ROOT_WINDOW (f), buffer, Qnil);
4715 old_buffer = current_buffer;
4716 set_buffer_internal_1 (XBUFFER (buffer));
4717 current_buffer->truncate_lines = Qnil;
4718 specbind (Qinhibit_read_only, Qt);
4719 specbind (Qinhibit_modification_hooks, Qt);
4720 Ferase_buffer ();
4721 Finsert (1, &text);
4722 set_buffer_internal_1 (old_buffer);
4724 FRAME_CAN_HAVE_SCROLL_BARS (f) = 0;
4725 record_unwind_protect (unwind_create_tip_frame, frame);
4727 f->terminal = dpyinfo->terminal;
4728 f->terminal->reference_count++;
4730 /* By setting the output method, we're essentially saying that
4731 the frame is live, as per FRAME_LIVE_P. If we get a signal
4732 from this point on, x_destroy_window might screw up reference
4733 counts etc. */
4734 f->output_method = output_x_window;
4735 f->output_data.x = (struct x_output *) xmalloc (sizeof (struct x_output));
4736 bzero (f->output_data.x, sizeof (struct x_output));
4737 f->output_data.x->icon_bitmap = -1;
4738 FRAME_FONTSET (f) = -1;
4739 f->output_data.x->scroll_bar_foreground_pixel = -1;
4740 f->output_data.x->scroll_bar_background_pixel = -1;
4741 #ifdef USE_TOOLKIT_SCROLL_BARS
4742 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
4743 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
4744 #endif /* USE_TOOLKIT_SCROLL_BARS */
4745 f->icon_name = Qnil;
4746 FRAME_X_DISPLAY_INFO (f) = dpyinfo;
4747 #if GLYPH_DEBUG
4748 image_cache_refcount = FRAME_X_IMAGE_CACHE (f)->refcount;
4749 dpyinfo_refcount = dpyinfo->reference_count;
4750 #endif /* GLYPH_DEBUG */
4751 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
4752 f->output_data.x->explicit_parent = 0;
4754 /* These colors will be set anyway later, but it's important
4755 to get the color reference counts right, so initialize them! */
4757 Lisp_Object black;
4758 struct gcpro gcpro1;
4760 /* Function x_decode_color can signal an error. Make
4761 sure to initialize color slots so that we won't try
4762 to free colors we haven't allocated. */
4763 FRAME_FOREGROUND_PIXEL (f) = -1;
4764 FRAME_BACKGROUND_PIXEL (f) = -1;
4765 f->output_data.x->cursor_pixel = -1;
4766 f->output_data.x->cursor_foreground_pixel = -1;
4767 f->output_data.x->border_pixel = -1;
4768 f->output_data.x->mouse_pixel = -1;
4770 black = build_string ("black");
4771 GCPRO1 (black);
4772 FRAME_FOREGROUND_PIXEL (f)
4773 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4774 FRAME_BACKGROUND_PIXEL (f)
4775 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4776 f->output_data.x->cursor_pixel
4777 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4778 f->output_data.x->cursor_foreground_pixel
4779 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4780 f->output_data.x->border_pixel
4781 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4782 f->output_data.x->mouse_pixel
4783 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4784 UNGCPRO;
4787 /* Set the name; the functions to which we pass f expect the name to
4788 be set. */
4789 if (EQ (name, Qunbound) || NILP (name))
4791 f->name = build_string (dpyinfo->x_id_name);
4792 f->explicit_name = 0;
4794 else
4796 f->name = name;
4797 f->explicit_name = 1;
4798 /* use the frame's title when getting resources for this frame. */
4799 specbind (Qx_resource_name, name);
4802 /* Extract the window parameters from the supplied values that are
4803 needed to determine window geometry. */
4805 Lisp_Object font;
4807 font = x_get_arg (dpyinfo, parms, Qfont, "font", "Font", RES_TYPE_STRING);
4809 BLOCK_INPUT;
4810 /* First, try whatever font the caller has specified. */
4811 if (STRINGP (font))
4813 tem = Fquery_fontset (font, Qnil);
4814 if (STRINGP (tem))
4815 font = x_new_fontset (f, SDATA (tem));
4816 else
4817 font = x_new_font (f, SDATA (font));
4820 /* Try out a font which we hope has bold and italic variations. */
4821 if (!STRINGP (font))
4822 font = x_new_font (f, "-adobe-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-1");
4823 if (!STRINGP (font))
4824 font = x_new_font (f, "-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-1");
4825 if (! STRINGP (font))
4826 font = x_new_font (f, "-*-*-medium-r-normal-*-*-140-*-*-c-*-iso8859-1");
4827 if (! STRINGP (font))
4828 /* This was formerly the first thing tried, but it finds too many fonts
4829 and takes too long. */
4830 font = x_new_font (f, "-*-*-medium-r-*-*-*-*-*-*-c-*-iso8859-1");
4831 /* If those didn't work, look for something which will at least work. */
4832 if (! STRINGP (font))
4833 font = x_new_font (f, "-*-fixed-*-*-*-*-*-140-*-*-c-*-iso8859-1");
4834 UNBLOCK_INPUT;
4835 if (! STRINGP (font))
4836 font = build_string ("fixed");
4838 x_default_parameter (f, parms, Qfont, font,
4839 "font", "Font", RES_TYPE_STRING);
4842 x_default_parameter (f, parms, Qborder_width, make_number (2),
4843 "borderWidth", "BorderWidth", RES_TYPE_NUMBER);
4845 /* This defaults to 2 in order to match xterm. We recognize either
4846 internalBorderWidth or internalBorder (which is what xterm calls
4847 it). */
4848 if (NILP (Fassq (Qinternal_border_width, parms)))
4850 Lisp_Object value;
4852 value = x_get_arg (dpyinfo, parms, Qinternal_border_width,
4853 "internalBorder", "internalBorder", RES_TYPE_NUMBER);
4854 if (! EQ (value, Qunbound))
4855 parms = Fcons (Fcons (Qinternal_border_width, value),
4856 parms);
4859 x_default_parameter (f, parms, Qinternal_border_width, make_number (1),
4860 "internalBorderWidth", "internalBorderWidth",
4861 RES_TYPE_NUMBER);
4863 /* Also do the stuff which must be set before the window exists. */
4864 x_default_parameter (f, parms, Qforeground_color, build_string ("black"),
4865 "foreground", "Foreground", RES_TYPE_STRING);
4866 x_default_parameter (f, parms, Qbackground_color, build_string ("white"),
4867 "background", "Background", RES_TYPE_STRING);
4868 x_default_parameter (f, parms, Qmouse_color, build_string ("black"),
4869 "pointerColor", "Foreground", RES_TYPE_STRING);
4870 x_default_parameter (f, parms, Qcursor_color, build_string ("black"),
4871 "cursorColor", "Foreground", RES_TYPE_STRING);
4872 x_default_parameter (f, parms, Qborder_color, build_string ("black"),
4873 "borderColor", "BorderColor", RES_TYPE_STRING);
4875 /* Init faces before x_default_parameter is called for scroll-bar
4876 parameters because that function calls x_set_scroll_bar_width,
4877 which calls change_frame_size, which calls Fset_window_buffer,
4878 which runs hooks, which call Fvertical_motion. At the end, we
4879 end up in init_iterator with a null face cache, which should not
4880 happen. */
4881 init_frame_faces (f);
4883 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
4885 window_prompting = x_figure_window_size (f, parms, 0);
4888 XSetWindowAttributes attrs;
4889 unsigned long mask;
4891 BLOCK_INPUT;
4892 mask = CWBackPixel | CWOverrideRedirect | CWEventMask;
4893 if (DoesSaveUnders (dpyinfo->screen))
4894 mask |= CWSaveUnder;
4896 /* Window managers look at the override-redirect flag to determine
4897 whether or net to give windows a decoration (Xlib spec, chapter
4898 3.2.8). */
4899 attrs.override_redirect = True;
4900 attrs.save_under = True;
4901 attrs.background_pixel = FRAME_BACKGROUND_PIXEL (f);
4902 /* Arrange for getting MapNotify and UnmapNotify events. */
4903 attrs.event_mask = StructureNotifyMask;
4904 tip_window
4905 = FRAME_X_WINDOW (f)
4906 = XCreateWindow (FRAME_X_DISPLAY (f),
4907 FRAME_X_DISPLAY_INFO (f)->root_window,
4908 /* x, y, width, height */
4909 0, 0, 1, 1,
4910 /* Border. */
4912 CopyFromParent, InputOutput, CopyFromParent,
4913 mask, &attrs);
4914 UNBLOCK_INPUT;
4917 x_make_gc (f);
4919 x_default_parameter (f, parms, Qauto_raise, Qnil,
4920 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
4921 x_default_parameter (f, parms, Qauto_lower, Qnil,
4922 "autoLower", "AutoRaiseLower", RES_TYPE_BOOLEAN);
4923 x_default_parameter (f, parms, Qcursor_type, Qbox,
4924 "cursorType", "CursorType", RES_TYPE_SYMBOL);
4926 /* Dimensions, especially FRAME_LINES (f), must be done via change_frame_size.
4927 Change will not be effected unless different from the current
4928 FRAME_LINES (f). */
4929 width = FRAME_COLS (f);
4930 height = FRAME_LINES (f);
4931 SET_FRAME_COLS (f, 0);
4932 FRAME_LINES (f) = 0;
4933 change_frame_size (f, height, width, 1, 0, 0);
4935 /* Add `tooltip' frame parameter's default value. */
4936 if (NILP (Fframe_parameter (frame, intern ("tooltip"))))
4937 Fmodify_frame_parameters (frame, Fcons (Fcons (intern ("tooltip"), Qt),
4938 Qnil));
4940 /* FIXME - can this be done in a similar way to normal frames?
4941 http://lists.gnu.org/archive/html/emacs-devel/2007-10/msg00641.html */
4943 /* Set the `display-type' frame parameter before setting up faces. */
4945 Lisp_Object disptype;
4947 if (FRAME_X_DISPLAY_INFO (f)->n_planes == 1)
4948 disptype = intern ("mono");
4949 else if (FRAME_X_DISPLAY_INFO (f)->visual->class == GrayScale
4950 || FRAME_X_DISPLAY_INFO (f)->visual->class == StaticGray)
4951 disptype = intern ("grayscale");
4952 else
4953 disptype = intern ("color");
4955 if (NILP (Fframe_parameter (frame, Qdisplay_type)))
4956 Fmodify_frame_parameters (frame, Fcons (Fcons (Qdisplay_type, disptype),
4957 Qnil));
4960 /* Set up faces after all frame parameters are known. This call
4961 also merges in face attributes specified for new frames.
4963 Frame parameters may be changed if .Xdefaults contains
4964 specifications for the default font. For example, if there is an
4965 `Emacs.default.attributeBackground: pink', the `background-color'
4966 attribute of the frame get's set, which let's the internal border
4967 of the tooltip frame appear in pink. Prevent this. */
4969 Lisp_Object bg = Fframe_parameter (frame, Qbackground_color);
4971 /* Set tip_frame here, so that */
4972 tip_frame = frame;
4973 call1 (Qface_set_after_frame_default, frame);
4975 if (!EQ (bg, Fframe_parameter (frame, Qbackground_color)))
4976 Fmodify_frame_parameters (frame, Fcons (Fcons (Qbackground_color, bg),
4977 Qnil));
4980 f->no_split = 1;
4982 UNGCPRO;
4984 /* It is now ok to make the frame official even if we get an error
4985 below. And the frame needs to be on Vframe_list or making it
4986 visible won't work. */
4987 Vframe_list = Fcons (frame, Vframe_list);
4989 /* Now that the frame is official, it counts as a reference to
4990 its display. */
4991 FRAME_X_DISPLAY_INFO (f)->reference_count++;
4993 /* Setting attributes of faces of the tooltip frame from resources
4994 and similar will increment face_change_count, which leads to the
4995 clearing of all current matrices. Since this isn't necessary
4996 here, avoid it by resetting face_change_count to the value it
4997 had before we created the tip frame. */
4998 face_change_count = face_change_count_before;
5000 /* Discard the unwind_protect. */
5001 return unbind_to (count, frame);
5005 /* Compute where to display tip frame F. PARMS is the list of frame
5006 parameters for F. DX and DY are specified offsets from the current
5007 location of the mouse. WIDTH and HEIGHT are the width and height
5008 of the tooltip. Return coordinates relative to the root window of
5009 the display in *ROOT_X, and *ROOT_Y. */
5011 static void
5012 compute_tip_xy (f, parms, dx, dy, width, height, root_x, root_y)
5013 struct frame *f;
5014 Lisp_Object parms, dx, dy;
5015 int width, height;
5016 int *root_x, *root_y;
5018 Lisp_Object left, top;
5019 int win_x, win_y;
5020 Window root, child;
5021 unsigned pmask;
5023 /* User-specified position? */
5024 left = Fcdr (Fassq (Qleft, parms));
5025 top = Fcdr (Fassq (Qtop, parms));
5027 /* Move the tooltip window where the mouse pointer is. Resize and
5028 show it. */
5029 if (!INTEGERP (left) || !INTEGERP (top))
5031 BLOCK_INPUT;
5032 XQueryPointer (FRAME_X_DISPLAY (f), FRAME_X_DISPLAY_INFO (f)->root_window,
5033 &root, &child, root_x, root_y, &win_x, &win_y, &pmask);
5034 UNBLOCK_INPUT;
5037 if (INTEGERP (top))
5038 *root_y = XINT (top);
5039 else if (*root_y + XINT (dy) <= 0)
5040 *root_y = 0; /* Can happen for negative dy */
5041 else if (*root_y + XINT (dy) + height <= FRAME_X_DISPLAY_INFO (f)->height)
5042 /* It fits below the pointer */
5043 *root_y += XINT (dy);
5044 else if (height + XINT (dy) <= *root_y)
5045 /* It fits above the pointer. */
5046 *root_y -= height + XINT (dy);
5047 else
5048 /* Put it on the top. */
5049 *root_y = 0;
5051 if (INTEGERP (left))
5052 *root_x = XINT (left);
5053 else if (*root_x + XINT (dx) <= 0)
5054 *root_x = 0; /* Can happen for negative dx */
5055 else if (*root_x + XINT (dx) + width <= FRAME_X_DISPLAY_INFO (f)->width)
5056 /* It fits to the right of the pointer. */
5057 *root_x += XINT (dx);
5058 else if (width + XINT (dx) <= *root_x)
5059 /* It fits to the left of the pointer. */
5060 *root_x -= width + XINT (dx);
5061 else
5062 /* Put it left-justified on the screen--it ought to fit that way. */
5063 *root_x = 0;
5067 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
5068 doc: /* Show STRING in a "tooltip" window on frame FRAME.
5069 A tooltip window is a small X window displaying a string.
5071 This is an internal function; Lisp code should call `tooltip-show'.
5073 FRAME nil or omitted means use the selected frame.
5075 PARMS is an optional list of frame parameters which can be used to
5076 change the tooltip's appearance.
5078 Automatically hide the tooltip after TIMEOUT seconds. TIMEOUT nil
5079 means use the default timeout of 5 seconds.
5081 If the list of frame parameters PARAMS contains a `left' parameters,
5082 the tooltip is displayed at that x-position. Otherwise it is
5083 displayed at the mouse position, with offset DX added (default is 5 if
5084 DX isn't specified). Likewise for the y-position; if a `top' frame
5085 parameter is specified, it determines the y-position of the tooltip
5086 window, otherwise it is displayed at the mouse position, with offset
5087 DY added (default is -10).
5089 A tooltip's maximum size is specified by `x-max-tooltip-size'.
5090 Text larger than the specified size is clipped. */)
5091 (string, frame, parms, timeout, dx, dy)
5092 Lisp_Object string, frame, parms, timeout, dx, dy;
5094 struct frame *f;
5095 struct window *w;
5096 int root_x, root_y;
5097 struct buffer *old_buffer;
5098 struct text_pos pos;
5099 int i, width, height;
5100 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
5101 int old_windows_or_buffers_changed = windows_or_buffers_changed;
5102 int count = SPECPDL_INDEX ();
5104 specbind (Qinhibit_redisplay, Qt);
5106 GCPRO4 (string, parms, frame, timeout);
5108 CHECK_STRING (string);
5109 f = check_x_frame (frame);
5110 if (NILP (timeout))
5111 timeout = make_number (5);
5112 else
5113 CHECK_NATNUM (timeout);
5115 if (NILP (dx))
5116 dx = make_number (5);
5117 else
5118 CHECK_NUMBER (dx);
5120 if (NILP (dy))
5121 dy = make_number (-10);
5122 else
5123 CHECK_NUMBER (dy);
5125 if (NILP (last_show_tip_args))
5126 last_show_tip_args = Fmake_vector (make_number (3), Qnil);
5128 if (!NILP (tip_frame))
5130 Lisp_Object last_string = AREF (last_show_tip_args, 0);
5131 Lisp_Object last_frame = AREF (last_show_tip_args, 1);
5132 Lisp_Object last_parms = AREF (last_show_tip_args, 2);
5134 if (EQ (frame, last_frame)
5135 && !NILP (Fequal (last_string, string))
5136 && !NILP (Fequal (last_parms, parms)))
5138 struct frame *f = XFRAME (tip_frame);
5140 /* Only DX and DY have changed. */
5141 if (!NILP (tip_timer))
5143 Lisp_Object timer = tip_timer;
5144 tip_timer = Qnil;
5145 call1 (Qcancel_timer, timer);
5148 BLOCK_INPUT;
5149 compute_tip_xy (f, parms, dx, dy, FRAME_PIXEL_WIDTH (f),
5150 FRAME_PIXEL_HEIGHT (f), &root_x, &root_y);
5151 XMoveWindow (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
5152 root_x, root_y);
5153 UNBLOCK_INPUT;
5154 goto start_timer;
5158 /* Hide a previous tip, if any. */
5159 Fx_hide_tip ();
5161 ASET (last_show_tip_args, 0, string);
5162 ASET (last_show_tip_args, 1, frame);
5163 ASET (last_show_tip_args, 2, parms);
5165 /* Add default values to frame parameters. */
5166 if (NILP (Fassq (Qname, parms)))
5167 parms = Fcons (Fcons (Qname, build_string ("tooltip")), parms);
5168 if (NILP (Fassq (Qinternal_border_width, parms)))
5169 parms = Fcons (Fcons (Qinternal_border_width, make_number (3)), parms);
5170 if (NILP (Fassq (Qborder_width, parms)))
5171 parms = Fcons (Fcons (Qborder_width, make_number (1)), parms);
5172 if (NILP (Fassq (Qborder_color, parms)))
5173 parms = Fcons (Fcons (Qborder_color, build_string ("lightyellow")), parms);
5174 if (NILP (Fassq (Qbackground_color, parms)))
5175 parms = Fcons (Fcons (Qbackground_color, build_string ("lightyellow")),
5176 parms);
5178 /* Create a frame for the tooltip, and record it in the global
5179 variable tip_frame. */
5180 frame = x_create_tip_frame (FRAME_X_DISPLAY_INFO (f), parms, string);
5181 f = XFRAME (frame);
5183 /* Set up the frame's root window. */
5184 w = XWINDOW (FRAME_ROOT_WINDOW (f));
5185 w->left_col = w->top_line = make_number (0);
5187 if (CONSP (Vx_max_tooltip_size)
5188 && INTEGERP (XCAR (Vx_max_tooltip_size))
5189 && XINT (XCAR (Vx_max_tooltip_size)) > 0
5190 && INTEGERP (XCDR (Vx_max_tooltip_size))
5191 && XINT (XCDR (Vx_max_tooltip_size)) > 0)
5193 w->total_cols = XCAR (Vx_max_tooltip_size);
5194 w->total_lines = XCDR (Vx_max_tooltip_size);
5196 else
5198 w->total_cols = make_number (80);
5199 w->total_lines = make_number (40);
5202 FRAME_TOTAL_COLS (f) = XINT (w->total_cols);
5203 adjust_glyphs (f);
5204 w->pseudo_window_p = 1;
5206 /* Display the tooltip text in a temporary buffer. */
5207 old_buffer = current_buffer;
5208 set_buffer_internal_1 (XBUFFER (XWINDOW (FRAME_ROOT_WINDOW (f))->buffer));
5209 current_buffer->truncate_lines = Qnil;
5210 clear_glyph_matrix (w->desired_matrix);
5211 clear_glyph_matrix (w->current_matrix);
5212 SET_TEXT_POS (pos, BEGV, BEGV_BYTE);
5213 try_window (FRAME_ROOT_WINDOW (f), pos, 0);
5215 /* Compute width and height of the tooltip. */
5216 width = height = 0;
5217 for (i = 0; i < w->desired_matrix->nrows; ++i)
5219 struct glyph_row *row = &w->desired_matrix->rows[i];
5220 struct glyph *last;
5221 int row_width;
5223 /* Stop at the first empty row at the end. */
5224 if (!row->enabled_p || !row->displays_text_p)
5225 break;
5227 /* Let the row go over the full width of the frame. */
5228 row->full_width_p = 1;
5230 /* There's a glyph at the end of rows that is used to place
5231 the cursor there. Don't include the width of this glyph. */
5232 if (row->used[TEXT_AREA])
5234 last = &row->glyphs[TEXT_AREA][row->used[TEXT_AREA] - 1];
5235 row_width = row->pixel_width - last->pixel_width;
5237 else
5238 row_width = row->pixel_width;
5240 height += row->height;
5241 width = max (width, row_width);
5244 /* Add the frame's internal border to the width and height the X
5245 window should have. */
5246 height += 2 * FRAME_INTERNAL_BORDER_WIDTH (f);
5247 width += 2 * FRAME_INTERNAL_BORDER_WIDTH (f);
5249 /* Move the tooltip window where the mouse pointer is. Resize and
5250 show it. */
5251 compute_tip_xy (f, parms, dx, dy, width, height, &root_x, &root_y);
5253 BLOCK_INPUT;
5254 XMoveResizeWindow (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
5255 root_x, root_y, width, height);
5256 XMapRaised (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f));
5257 UNBLOCK_INPUT;
5259 /* Draw into the window. */
5260 w->must_be_updated_p = 1;
5261 update_single_window (w, 1);
5263 /* Restore original current buffer. */
5264 set_buffer_internal_1 (old_buffer);
5265 windows_or_buffers_changed = old_windows_or_buffers_changed;
5267 start_timer:
5268 /* Let the tip disappear after timeout seconds. */
5269 tip_timer = call3 (intern ("run-at-time"), timeout, Qnil,
5270 intern ("x-hide-tip"));
5272 UNGCPRO;
5273 return unbind_to (count, Qnil);
5277 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
5278 doc: /* Hide the current tooltip window, if there is any.
5279 Value is t if tooltip was open, nil otherwise. */)
5282 int count;
5283 Lisp_Object deleted, frame, timer;
5284 struct gcpro gcpro1, gcpro2;
5286 /* Return quickly if nothing to do. */
5287 if (NILP (tip_timer) && NILP (tip_frame))
5288 return Qnil;
5290 frame = tip_frame;
5291 timer = tip_timer;
5292 GCPRO2 (frame, timer);
5293 tip_frame = tip_timer = deleted = Qnil;
5295 count = SPECPDL_INDEX ();
5296 specbind (Qinhibit_redisplay, Qt);
5297 specbind (Qinhibit_quit, Qt);
5299 if (!NILP (timer))
5300 call1 (Qcancel_timer, timer);
5302 if (FRAMEP (frame))
5304 Fdelete_frame (frame, Qnil);
5305 deleted = Qt;
5307 #ifdef USE_LUCID
5308 /* Bloodcurdling hack alert: The Lucid menu bar widget's
5309 redisplay procedure is not called when a tip frame over menu
5310 items is unmapped. Redisplay the menu manually... */
5312 struct frame *f = SELECTED_FRAME ();
5313 Widget w = f->output_data.x->menubar_widget;
5314 extern void xlwmenu_redisplay P_ ((Widget));
5316 if (!DoesSaveUnders (FRAME_X_DISPLAY_INFO (f)->screen)
5317 && w != NULL)
5319 BLOCK_INPUT;
5320 xlwmenu_redisplay (w);
5321 UNBLOCK_INPUT;
5324 #endif /* USE_LUCID */
5327 UNGCPRO;
5328 return unbind_to (count, deleted);
5333 /***********************************************************************
5334 File selection dialog
5335 ***********************************************************************/
5337 DEFUN ("x-uses-old-gtk-dialog", Fx_uses_old_gtk_dialog,
5338 Sx_uses_old_gtk_dialog,
5339 0, 0, 0,
5340 doc: /* Return t if the old Gtk+ file selection dialog is used. */)
5343 #ifdef USE_GTK
5344 extern int use_dialog_box;
5345 extern int use_file_dialog;
5347 if (use_dialog_box
5348 && use_file_dialog
5349 && have_menus_p ()
5350 && xg_uses_old_file_dialog ())
5351 return Qt;
5352 #endif
5353 return Qnil;
5357 #ifdef USE_MOTIF
5358 /* Callback for "OK" and "Cancel" on file selection dialog. */
5360 static void
5361 file_dialog_cb (widget, client_data, call_data)
5362 Widget widget;
5363 XtPointer call_data, client_data;
5365 int *result = (int *) client_data;
5366 XmAnyCallbackStruct *cb = (XmAnyCallbackStruct *) call_data;
5367 *result = cb->reason;
5371 /* Callback for unmapping a file selection dialog. This is used to
5372 capture the case where a dialog is closed via a window manager's
5373 closer button, for example. Using a XmNdestroyCallback didn't work
5374 in this case. */
5376 static void
5377 file_dialog_unmap_cb (widget, client_data, call_data)
5378 Widget widget;
5379 XtPointer call_data, client_data;
5381 int *result = (int *) client_data;
5382 *result = XmCR_CANCEL;
5385 static Lisp_Object
5386 clean_up_file_dialog (arg)
5387 Lisp_Object arg;
5389 struct Lisp_Save_Value *p = XSAVE_VALUE (arg);
5390 Widget dialog = (Widget) p->pointer;
5392 /* Clean up. */
5393 BLOCK_INPUT;
5394 XtUnmanageChild (dialog);
5395 XtDestroyWidget (dialog);
5396 x_menu_set_in_use (0);
5397 UNBLOCK_INPUT;
5399 return Qnil;
5403 DEFUN ("x-file-dialog", Fx_file_dialog, Sx_file_dialog, 2, 5, 0,
5404 doc: /* Read file name, prompting with PROMPT in directory DIR.
5405 Use a file selection dialog. Select DEFAULT-FILENAME in the dialog's file
5406 selection box, if specified. If MUSTMATCH is non-nil, the returned file
5407 or directory must exist. ONLY-DIR-P is ignored." */)
5408 (prompt, dir, default_filename, mustmatch, only_dir_p)
5409 Lisp_Object prompt, dir, default_filename, mustmatch, only_dir_p;
5411 int result;
5412 struct frame *f = SELECTED_FRAME ();
5413 Lisp_Object file = Qnil;
5414 Lisp_Object decoded_file;
5415 Widget dialog, text, help;
5416 Arg al[10];
5417 int ac = 0;
5418 extern XtAppContext Xt_app_con;
5419 XmString dir_xmstring, pattern_xmstring;
5420 int count = SPECPDL_INDEX ();
5421 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
5423 check_x ();
5425 GCPRO6 (prompt, dir, default_filename, mustmatch, only_dir_p, file);
5427 if (popup_activated ())
5428 error ("Trying to use a menu from within a menu-entry");
5430 CHECK_STRING (prompt);
5431 CHECK_STRING (dir);
5433 /* Prevent redisplay. */
5434 specbind (Qinhibit_redisplay, Qt);
5436 BLOCK_INPUT;
5438 /* Create the dialog with PROMPT as title, using DIR as initial
5439 directory and using "*" as pattern. */
5440 dir = Fexpand_file_name (dir, Qnil);
5441 dir_xmstring = XmStringCreateLocalized (SDATA (dir));
5442 pattern_xmstring = XmStringCreateLocalized ("*");
5444 XtSetArg (al[ac], XmNtitle, SDATA (prompt)); ++ac;
5445 XtSetArg (al[ac], XmNdirectory, dir_xmstring); ++ac;
5446 XtSetArg (al[ac], XmNpattern, pattern_xmstring); ++ac;
5447 XtSetArg (al[ac], XmNresizePolicy, XmRESIZE_GROW); ++ac;
5448 XtSetArg (al[ac], XmNdialogStyle, XmDIALOG_APPLICATION_MODAL); ++ac;
5449 dialog = XmCreateFileSelectionDialog (f->output_data.x->widget,
5450 "fsb", al, ac);
5451 XmStringFree (dir_xmstring);
5452 XmStringFree (pattern_xmstring);
5454 /* Add callbacks for OK and Cancel. */
5455 XtAddCallback (dialog, XmNokCallback, file_dialog_cb,
5456 (XtPointer) &result);
5457 XtAddCallback (dialog, XmNcancelCallback, file_dialog_cb,
5458 (XtPointer) &result);
5459 XtAddCallback (dialog, XmNunmapCallback, file_dialog_unmap_cb,
5460 (XtPointer) &result);
5462 /* Remove the help button since we can't display help. */
5463 help = XmFileSelectionBoxGetChild (dialog, XmDIALOG_HELP_BUTTON);
5464 XtUnmanageChild (help);
5466 /* Mark OK button as default. */
5467 XtVaSetValues (XmFileSelectionBoxGetChild (dialog, XmDIALOG_OK_BUTTON),
5468 XmNshowAsDefault, True, NULL);
5470 /* If MUSTMATCH is non-nil, disable the file entry field of the
5471 dialog, so that the user must select a file from the files list
5472 box. We can't remove it because we wouldn't have a way to get at
5473 the result file name, then. */
5474 text = XmFileSelectionBoxGetChild (dialog, XmDIALOG_TEXT);
5475 if (!NILP (mustmatch))
5477 Widget label;
5478 label = XmFileSelectionBoxGetChild (dialog, XmDIALOG_SELECTION_LABEL);
5479 XtSetSensitive (text, False);
5480 XtSetSensitive (label, False);
5483 /* Manage the dialog, so that list boxes get filled. */
5484 XtManageChild (dialog);
5486 if (STRINGP (default_filename))
5488 XmString default_xmstring;
5489 Widget wtext = XmFileSelectionBoxGetChild (dialog, XmDIALOG_TEXT);
5490 Widget list = XmFileSelectionBoxGetChild (dialog, XmDIALOG_LIST);
5492 XmTextPosition last_pos = XmTextFieldGetLastPosition (wtext);
5493 XmTextFieldReplace (wtext, 0, last_pos,
5494 (SDATA (Ffile_name_nondirectory (default_filename))));
5496 /* Select DEFAULT_FILENAME in the files list box. DEFAULT_FILENAME
5497 must include the path for this to work. */
5499 default_xmstring = XmStringCreateLocalized (SDATA (default_filename));
5501 if (XmListItemExists (list, default_xmstring))
5503 int item_pos = XmListItemPos (list, default_xmstring);
5504 /* Select the item and scroll it into view. */
5505 XmListSelectPos (list, item_pos, True);
5506 XmListSetPos (list, item_pos);
5509 XmStringFree (default_xmstring);
5512 record_unwind_protect (clean_up_file_dialog, make_save_value (dialog, 0));
5514 /* Process events until the user presses Cancel or OK. */
5515 x_menu_set_in_use (1);
5516 result = 0;
5517 while (result == 0)
5519 XEvent event;
5520 x_menu_wait_for_event (0);
5521 XtAppNextEvent (Xt_app_con, &event);
5522 if (event.type == KeyPress
5523 && FRAME_X_DISPLAY (f) == event.xkey.display)
5525 KeySym keysym = XLookupKeysym (&event.xkey, 0);
5527 /* Pop down on C-g. */
5528 if (keysym == XK_g && (event.xkey.state & ControlMask) != 0)
5529 XtUnmanageChild (dialog);
5532 (void) x_dispatch_event (&event, FRAME_X_DISPLAY (f));
5535 /* Get the result. */
5536 if (result == XmCR_OK)
5538 XmString text;
5539 String data;
5541 XtVaGetValues (dialog, XmNtextString, &text, NULL);
5542 XmStringGetLtoR (text, XmFONTLIST_DEFAULT_TAG, &data);
5543 XmStringFree (text);
5544 file = build_string (data);
5545 XtFree (data);
5547 else
5548 file = Qnil;
5550 UNBLOCK_INPUT;
5551 UNGCPRO;
5553 /* Make "Cancel" equivalent to C-g. */
5554 if (NILP (file))
5555 Fsignal (Qquit, Qnil);
5557 decoded_file = DECODE_FILE (file);
5559 return unbind_to (count, decoded_file);
5562 #endif /* USE_MOTIF */
5564 #ifdef USE_GTK
5566 static Lisp_Object
5567 clean_up_dialog (arg)
5568 Lisp_Object arg;
5570 x_menu_set_in_use (0);
5572 return Qnil;
5575 DEFUN ("x-file-dialog", Fx_file_dialog, Sx_file_dialog, 2, 5, 0,
5576 doc: /* Read file name, prompting with PROMPT in directory DIR.
5577 Use a file selection dialog. Select DEFAULT-FILENAME in the dialog's file
5578 selection box, if specified. If MUSTMATCH is non-nil, the returned file
5579 or directory must exist. If ONLY-DIR-P is non-nil, the user can only select
5580 directories. */)
5581 (prompt, dir, default_filename, mustmatch, only_dir_p)
5582 Lisp_Object prompt, dir, default_filename, mustmatch, only_dir_p;
5584 FRAME_PTR f = SELECTED_FRAME ();
5585 char *fn;
5586 Lisp_Object file = Qnil;
5587 Lisp_Object decoded_file;
5588 int count = SPECPDL_INDEX ();
5589 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
5590 char *cdef_file;
5592 check_x ();
5594 GCPRO6 (prompt, dir, default_filename, mustmatch, only_dir_p, file);
5596 if (popup_activated ())
5597 error ("Trying to use a menu from within a menu-entry");
5599 CHECK_STRING (prompt);
5600 CHECK_STRING (dir);
5602 /* Prevent redisplay. */
5603 specbind (Qinhibit_redisplay, Qt);
5604 record_unwind_protect (clean_up_dialog, Qnil);
5606 BLOCK_INPUT;
5608 if (STRINGP (default_filename))
5609 cdef_file = SDATA (default_filename);
5610 else
5611 cdef_file = SDATA (dir);
5613 fn = xg_get_file_name (f, SDATA (prompt), cdef_file,
5614 ! NILP (mustmatch),
5615 ! NILP (only_dir_p));
5617 if (fn)
5619 file = build_string (fn);
5620 xfree (fn);
5623 UNBLOCK_INPUT;
5624 UNGCPRO;
5626 /* Make "Cancel" equivalent to C-g. */
5627 if (NILP (file))
5628 Fsignal (Qquit, Qnil);
5630 decoded_file = DECODE_FILE (file);
5632 return unbind_to (count, decoded_file);
5635 #endif /* USE_GTK */
5638 /***********************************************************************
5639 Keyboard
5640 ***********************************************************************/
5642 #ifdef HAVE_XKBGETKEYBOARD
5643 #include <X11/XKBlib.h>
5644 #include <X11/keysym.h>
5645 #endif
5647 DEFUN ("x-backspace-delete-keys-p", Fx_backspace_delete_keys_p,
5648 Sx_backspace_delete_keys_p, 0, 1, 0,
5649 doc: /* Check if both Backspace and Delete keys are on the keyboard of FRAME.
5650 FRAME nil means use the selected frame.
5651 Value is t if we know that both keys are present, and are mapped to the
5652 usual X keysyms. Value is `lambda' if we cannot determine if both keys are
5653 present and mapped to the usual X keysyms. */)
5654 (frame)
5655 Lisp_Object frame;
5657 #ifdef HAVE_XKBGETKEYBOARD
5658 XkbDescPtr kb;
5659 struct frame *f = check_x_frame (frame);
5660 Display *dpy = FRAME_X_DISPLAY (f);
5661 Lisp_Object have_keys;
5662 int major, minor, op, event, error;
5664 BLOCK_INPUT;
5666 /* Check library version in case we're dynamically linked. */
5667 major = XkbMajorVersion;
5668 minor = XkbMinorVersion;
5669 if (!XkbLibraryVersion (&major, &minor))
5671 UNBLOCK_INPUT;
5672 return Qlambda;
5675 /* Check that the server supports XKB. */
5676 major = XkbMajorVersion;
5677 minor = XkbMinorVersion;
5678 if (!XkbQueryExtension (dpy, &op, &event, &error, &major, &minor))
5680 UNBLOCK_INPUT;
5681 return Qlambda;
5684 /* In this code we check that the keyboard has physical keys with names
5685 that start with BKSP (Backspace) and DELE (Delete), and that they
5686 generate keysym XK_BackSpace and XK_Delete respectively.
5687 This function is used to test if normal-erase-is-backspace should be
5688 turned on.
5689 An alternative approach would be to just check if XK_BackSpace and
5690 XK_Delete are mapped to any key. But if any of those are mapped to
5691 some non-intuitive key combination (Meta-Shift-Ctrl-whatever) and the
5692 user doesn't know about it, it is better to return false here.
5693 It is more obvious to the user what to do if she/he has two keys
5694 clearly marked with names/symbols and one key does something not
5695 expected (i.e. she/he then tries the other).
5696 The cases where Backspace/Delete is mapped to some other key combination
5697 are rare, and in those cases, normal-erase-is-backspace can be turned on
5698 manually. */
5700 have_keys = Qnil;
5701 kb = XkbGetMap (dpy, XkbAllMapComponentsMask, XkbUseCoreKbd);
5702 if (kb)
5704 int delete_keycode = 0, backspace_keycode = 0, i;
5706 if (XkbGetNames (dpy, XkbAllNamesMask, kb) == Success)
5708 for (i = kb->min_key_code;
5709 (i < kb->max_key_code
5710 && (delete_keycode == 0 || backspace_keycode == 0));
5711 ++i)
5713 /* The XKB symbolic key names can be seen most easily in
5714 the PS file generated by `xkbprint -label name
5715 $DISPLAY'. */
5716 if (bcmp ("DELE", kb->names->keys[i].name, 4) == 0)
5717 delete_keycode = i;
5718 else if (bcmp ("BKSP", kb->names->keys[i].name, 4) == 0)
5719 backspace_keycode = i;
5722 XkbFreeNames (kb, 0, True);
5725 XkbFreeClientMap (kb, 0, True);
5727 if (delete_keycode
5728 && backspace_keycode
5729 && XKeysymToKeycode (dpy, XK_Delete) == delete_keycode
5730 && XKeysymToKeycode (dpy, XK_BackSpace) == backspace_keycode)
5731 have_keys = Qt;
5733 UNBLOCK_INPUT;
5734 return have_keys;
5735 #else /* not HAVE_XKBGETKEYBOARD */
5736 return Qlambda;
5737 #endif /* not HAVE_XKBGETKEYBOARD */
5742 /***********************************************************************
5743 Initialization
5744 ***********************************************************************/
5746 /* Keep this list in the same order as frame_parms in frame.c.
5747 Use 0 for unsupported frame parameters. */
5749 frame_parm_handler x_frame_parm_handlers[] =
5751 x_set_autoraise,
5752 x_set_autolower,
5753 x_set_background_color,
5754 x_set_border_color,
5755 x_set_border_width,
5756 x_set_cursor_color,
5757 x_set_cursor_type,
5758 x_set_font,
5759 x_set_foreground_color,
5760 x_set_icon_name,
5761 x_set_icon_type,
5762 x_set_internal_border_width,
5763 x_set_menu_bar_lines,
5764 x_set_mouse_color,
5765 x_explicitly_set_name,
5766 x_set_scroll_bar_width,
5767 x_set_title,
5768 x_set_unsplittable,
5769 x_set_vertical_scroll_bars,
5770 x_set_visibility,
5771 x_set_tool_bar_lines,
5772 x_set_scroll_bar_foreground,
5773 x_set_scroll_bar_background,
5774 x_set_screen_gamma,
5775 x_set_line_spacing,
5776 x_set_fringe_width,
5777 x_set_fringe_width,
5778 x_set_wait_for_wm,
5779 x_set_fullscreen,
5782 void
5783 syms_of_xfns ()
5785 /* This is zero if not using X windows. */
5786 x_in_use = 0;
5788 /* The section below is built by the lisp expression at the top of the file,
5789 just above where these variables are declared. */
5790 /*&&& init symbols here &&&*/
5791 Qnone = intern ("none");
5792 staticpro (&Qnone);
5793 Qsuppress_icon = intern ("suppress-icon");
5794 staticpro (&Qsuppress_icon);
5795 Qundefined_color = intern ("undefined-color");
5796 staticpro (&Qundefined_color);
5797 Qcompound_text = intern ("compound-text");
5798 staticpro (&Qcompound_text);
5799 Qcancel_timer = intern ("cancel-timer");
5800 staticpro (&Qcancel_timer);
5801 /* This is the end of symbol initialization. */
5803 /* Text property `display' should be nonsticky by default. */
5804 Vtext_property_default_nonsticky
5805 = Fcons (Fcons (Qdisplay, Qt), Vtext_property_default_nonsticky);
5808 Fput (Qundefined_color, Qerror_conditions,
5809 Fcons (Qundefined_color, Fcons (Qerror, Qnil)));
5810 Fput (Qundefined_color, Qerror_message,
5811 build_string ("Undefined color"));
5813 DEFVAR_LISP ("x-pointer-shape", &Vx_pointer_shape,
5814 doc: /* The shape of the pointer when over text.
5815 Changing the value does not affect existing frames
5816 unless you set the mouse color. */);
5817 Vx_pointer_shape = Qnil;
5819 #if 0 /* This doesn't really do anything. */
5820 DEFVAR_LISP ("x-nontext-pointer-shape", &Vx_nontext_pointer_shape,
5821 doc: /* The shape of the pointer when not over text.
5822 This variable takes effect when you create a new frame
5823 or when you set the mouse color. */);
5824 #endif
5825 Vx_nontext_pointer_shape = Qnil;
5827 DEFVAR_LISP ("x-hourglass-pointer-shape", &Vx_hourglass_pointer_shape,
5828 doc: /* The shape of the pointer when Emacs is busy.
5829 This variable takes effect when you create a new frame
5830 or when you set the mouse color. */);
5831 Vx_hourglass_pointer_shape = Qnil;
5833 DEFVAR_BOOL ("display-hourglass", &display_hourglass_p,
5834 doc: /* Non-zero means Emacs displays an hourglass pointer on window systems. */);
5835 display_hourglass_p = 1;
5837 DEFVAR_LISP ("hourglass-delay", &Vhourglass_delay,
5838 doc: /* *Seconds to wait before displaying an hourglass pointer.
5839 Value must be an integer or float. */);
5840 Vhourglass_delay = make_number (DEFAULT_HOURGLASS_DELAY);
5842 #if 0 /* This doesn't really do anything. */
5843 DEFVAR_LISP ("x-mode-pointer-shape", &Vx_mode_pointer_shape,
5844 doc: /* The shape of the pointer when over the mode line.
5845 This variable takes effect when you create a new frame
5846 or when you set the mouse color. */);
5847 #endif
5848 Vx_mode_pointer_shape = Qnil;
5850 DEFVAR_LISP ("x-sensitive-text-pointer-shape",
5851 &Vx_sensitive_text_pointer_shape,
5852 doc: /* The shape of the pointer when over mouse-sensitive text.
5853 This variable takes effect when you create a new frame
5854 or when you set the mouse color. */);
5855 Vx_sensitive_text_pointer_shape = Qnil;
5857 DEFVAR_LISP ("x-window-horizontal-drag-cursor",
5858 &Vx_window_horizontal_drag_shape,
5859 doc: /* Pointer shape to use for indicating a window can be dragged horizontally.
5860 This variable takes effect when you create a new frame
5861 or when you set the mouse color. */);
5862 Vx_window_horizontal_drag_shape = Qnil;
5864 DEFVAR_LISP ("x-cursor-fore-pixel", &Vx_cursor_fore_pixel,
5865 doc: /* A string indicating the foreground color of the cursor box. */);
5866 Vx_cursor_fore_pixel = Qnil;
5868 DEFVAR_LISP ("x-max-tooltip-size", &Vx_max_tooltip_size,
5869 doc: /* Maximum size for tooltips. Value is a pair (COLUMNS . ROWS).
5870 Text larger than this is clipped. */);
5871 Vx_max_tooltip_size = Fcons (make_number (80), make_number (40));
5873 DEFVAR_LISP ("x-no-window-manager", &Vx_no_window_manager,
5874 doc: /* Non-nil if no X window manager is in use.
5875 Emacs doesn't try to figure this out; this is always nil
5876 unless you set it to something else. */);
5877 /* We don't have any way to find this out, so set it to nil
5878 and maybe the user would like to set it to t. */
5879 Vx_no_window_manager = Qnil;
5881 DEFVAR_LISP ("x-pixel-size-width-font-regexp",
5882 &Vx_pixel_size_width_font_regexp,
5883 doc: /* Regexp matching a font name whose width is the same as `PIXEL_SIZE'.
5885 Since Emacs gets width of a font matching with this regexp from
5886 PIXEL_SIZE field of the name, font finding mechanism gets faster for
5887 such a font. This is especially effective for such large fonts as
5888 Chinese, Japanese, and Korean. */);
5889 Vx_pixel_size_width_font_regexp = Qnil;
5891 /* This is not ifdef:ed, so other builds than GTK can customize it. */
5892 DEFVAR_BOOL ("x-gtk-use-old-file-dialog", &x_gtk_use_old_file_dialog,
5893 doc: /* *Non-nil means prompt with the old GTK file selection dialog.
5894 If nil or if the file selection dialog is not available, the new GTK file
5895 chooser is used instead. To turn off all file dialogs set the
5896 variable `use-file-dialog'. */);
5897 x_gtk_use_old_file_dialog = 0;
5899 DEFVAR_BOOL ("x-gtk-show-hidden-files", &x_gtk_show_hidden_files,
5900 doc: /* *If non-nil, the GTK file chooser will by default show hidden files.
5901 Note that this is just the default, there is a toggle button on the file
5902 chooser to show or not show hidden files on a case by case basis. */);
5903 x_gtk_show_hidden_files = 0;
5905 DEFVAR_BOOL ("x-gtk-file-dialog-help-text", &x_gtk_file_dialog_help_text,
5906 doc: /* *If non-nil, the GTK file chooser will show additional help text.
5907 If more space for files in the file chooser dialog is wanted, set this to nil
5908 to turn the additional text off. */);
5909 x_gtk_file_dialog_help_text = 1;
5911 DEFVAR_BOOL ("x-gtk-whole-detached-tool-bar", &x_gtk_whole_detached_tool_bar,
5912 doc: /* *If non-nil, a detached tool bar is shown in full.
5913 The default is to just show an arrow and pressing on that arrow shows
5914 the tool bar buttons. */);
5915 x_gtk_whole_detached_tool_bar = 0;
5917 Fprovide (intern ("x"), Qnil);
5919 #ifdef USE_X_TOOLKIT
5920 Fprovide (intern ("x-toolkit"), Qnil);
5921 #ifdef USE_MOTIF
5922 Fprovide (intern ("motif"), Qnil);
5924 DEFVAR_LISP ("motif-version-string", &Vmotif_version_string,
5925 doc: /* Version info for LessTif/Motif. */);
5926 Vmotif_version_string = build_string (XmVERSION_STRING);
5927 #endif /* USE_MOTIF */
5928 #endif /* USE_X_TOOLKIT */
5930 #ifdef USE_GTK
5931 /* Provide x-toolkit also for GTK. Internally GTK does not use Xt so it
5932 is not an X toolkit in that sense (USE_X_TOOLKIT is not defined).
5933 But for a user it is a toolkit for X, and indeed, configure
5934 accepts --with-x-toolkit=gtk. */
5935 Fprovide (intern ("x-toolkit"), Qnil);
5936 Fprovide (intern ("gtk"), Qnil);
5938 DEFVAR_LISP ("gtk-version-string", &Vgtk_version_string,
5939 doc: /* Version info for GTK+. */);
5941 char gtk_version[40];
5942 g_snprintf (gtk_version, sizeof (gtk_version), "%u.%u.%u",
5943 GTK_MAJOR_VERSION, GTK_MINOR_VERSION, GTK_MICRO_VERSION);
5944 Vgtk_version_string = build_string (gtk_version);
5946 #endif /* USE_GTK */
5948 /* X window properties. */
5949 defsubr (&Sx_change_window_property);
5950 defsubr (&Sx_delete_window_property);
5951 defsubr (&Sx_window_property);
5953 defsubr (&Sxw_display_color_p);
5954 defsubr (&Sx_display_grayscale_p);
5955 defsubr (&Sxw_color_defined_p);
5956 defsubr (&Sxw_color_values);
5957 defsubr (&Sx_server_max_request_size);
5958 defsubr (&Sx_server_vendor);
5959 defsubr (&Sx_server_version);
5960 defsubr (&Sx_display_pixel_width);
5961 defsubr (&Sx_display_pixel_height);
5962 defsubr (&Sx_display_mm_width);
5963 defsubr (&Sx_display_mm_height);
5964 defsubr (&Sx_display_screens);
5965 defsubr (&Sx_display_planes);
5966 defsubr (&Sx_display_color_cells);
5967 defsubr (&Sx_display_visual_class);
5968 defsubr (&Sx_display_backing_store);
5969 defsubr (&Sx_display_save_under);
5970 defsubr (&Sx_create_frame);
5971 defsubr (&Sx_open_connection);
5972 defsubr (&Sx_close_connection);
5973 defsubr (&Sx_display_list);
5974 defsubr (&Sx_synchronize);
5975 defsubr (&Sx_focus_frame);
5976 defsubr (&Sx_backspace_delete_keys_p);
5978 /* Setting callback functions for fontset handler. */
5979 get_font_info_func = x_get_font_info;
5981 #if 0 /* This function pointer doesn't seem to be used anywhere.
5982 And the pointer assigned has the wrong type, anyway. */
5983 list_fonts_func = x_list_fonts;
5984 #endif
5986 load_font_func = x_load_font;
5987 find_ccl_program_func = x_find_ccl_program;
5988 query_font_func = x_query_font;
5989 set_frame_fontset_func = x_set_font;
5990 check_window_system_func = check_x;
5992 hourglass_atimer = NULL;
5993 hourglass_shown_p = 0;
5995 defsubr (&Sx_show_tip);
5996 defsubr (&Sx_hide_tip);
5997 tip_timer = Qnil;
5998 staticpro (&tip_timer);
5999 tip_frame = Qnil;
6000 staticpro (&tip_frame);
6002 last_show_tip_args = Qnil;
6003 staticpro (&last_show_tip_args);
6005 defsubr (&Sx_uses_old_gtk_dialog);
6006 #if defined (USE_MOTIF) || defined (USE_GTK)
6007 defsubr (&Sx_file_dialog);
6008 #endif
6011 #endif /* HAVE_X_WINDOWS */
6013 /* arch-tag: 55040d02-5485-4d58-8b22-95a7a05f3288
6014 (do not change this comment) */