* xterm.h (struct x_display_info): Add invisible_cursor.
[emacs.git] / src / xfns.c
blob237b1c911eeade7312bceb0fadafcf2da046df4b
1 /* Functions for the X window system.
2 Copyright (C) 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
3 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009
4 Free Software Foundation, Inc.
6 This file is part of GNU Emacs.
8 GNU Emacs is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or
11 (at your option) any later version.
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
21 #include <config.h>
22 #include <stdio.h>
23 #include <math.h>
25 #ifdef HAVE_UNISTD_H
26 #include <unistd.h>
27 #endif
29 /* This makes the fields of a Display accessible, in Xlib header files. */
31 #define XLIB_ILLEGAL_ACCESS
33 #include "lisp.h"
34 #include "xterm.h"
35 #include "frame.h"
36 #include "window.h"
37 #include "buffer.h"
38 #include "intervals.h"
39 #include "dispextern.h"
40 #include "keyboard.h"
41 #include "blockinput.h"
42 #include <epaths.h>
43 #include "character.h"
44 #include "charset.h"
45 #include "coding.h"
46 #include "fontset.h"
47 #include "systime.h"
48 #include "termhooks.h"
49 #include "atimer.h"
50 #include "termchar.h"
51 #include "font.h"
53 #ifdef HAVE_X_WINDOWS
55 #include <ctype.h>
56 #include <sys/types.h>
57 #include <sys/stat.h>
59 #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
65 #ifdef USE_GTK
66 #include "gtkutil.h"
67 #endif
69 #ifdef USE_X_TOOLKIT
70 #include <X11/Shell.h>
72 #ifndef USE_MOTIF
73 #ifdef HAVE_XAW3D
74 #include <X11/Xaw3d/Paned.h>
75 #include <X11/Xaw3d/Label.h>
76 #else /* !HAVE_XAW3D */
77 #include <X11/Xaw/Paned.h>
78 #include <X11/Xaw/Label.h>
79 #endif /* HAVE_XAW3D */
80 #endif /* USE_MOTIF */
82 #ifdef USG
83 #undef USG /* ####KLUDGE for Solaris 2.2 and up */
84 #include <X11/Xos.h>
85 #define USG
86 #else
87 #include <X11/Xos.h>
88 #endif
90 #include "widget.h"
92 #include "../lwlib/lwlib.h"
94 #ifdef USE_MOTIF
95 #include <Xm/Xm.h>
96 #include <Xm/DialogS.h>
97 #include <Xm/FileSB.h>
98 #endif
100 /* Do the EDITRES protocol if running X11R5
101 Exception: HP-UX (at least version A.09.05) has X11R5 without EditRes */
103 #if (XtSpecificationRelease >= 5) && !defined(NO_EDITRES)
104 #define HACK_EDITRES
105 extern void _XEditResCheckMessages ();
106 #endif /* R5 + Athena */
108 /* Unique id counter for widgets created by the Lucid Widget Library. */
110 extern LWLIB_ID widget_id_tick;
112 #ifdef USE_LUCID
113 /* This is part of a kludge--see lwlib/xlwmenu.c. */
114 extern XFontStruct *xlwmenu_default_font;
115 #endif
117 extern void free_frame_menubar ();
118 extern double atof ();
120 #ifdef USE_MOTIF
122 /* LessTif/Motif version info. */
124 static Lisp_Object Vmotif_version_string;
126 #endif /* USE_MOTIF */
128 #endif /* USE_X_TOOLKIT */
130 #ifdef USE_GTK
132 /* GTK+ version info */
134 static Lisp_Object Vgtk_version_string;
136 #endif /* USE_GTK */
138 #define MAXREQUEST(dpy) (XMaxRequestSize (dpy))
140 /* The gray bitmap `bitmaps/gray'. This is done because xterm.c uses
141 it, and including `bitmaps/gray' more than once is a problem when
142 config.h defines `static' as an empty replacement string. */
144 int gray_bitmap_width = gray_width;
145 int gray_bitmap_height = gray_height;
146 char *gray_bitmap_bits = gray_bits;
148 /* Non-zero means prompt with the old GTK file selection dialog. */
150 int x_gtk_use_old_file_dialog;
152 /* If non-zero, by default show hidden files in the GTK file chooser. */
154 int x_gtk_show_hidden_files;
156 /* If non-zero, don't show additional help text in the GTK file chooser. */
158 int x_gtk_file_dialog_help_text;
160 /* If non-zero, don't collapse to tool bar when it is detached. */
162 int x_gtk_whole_detached_tool_bar;
164 /* The background and shape of the mouse pointer, and shape when not
165 over text or in the modeline. */
167 Lisp_Object Vx_pointer_shape, Vx_nontext_pointer_shape, Vx_mode_pointer_shape;
168 Lisp_Object Vx_hourglass_pointer_shape;
170 /* The shape when over mouse-sensitive text. */
172 Lisp_Object Vx_sensitive_text_pointer_shape;
174 /* If non-nil, the pointer shape to indicate that windows can be
175 dragged horizontally. */
177 Lisp_Object Vx_window_horizontal_drag_shape;
179 /* Color of chars displayed in cursor box. */
181 Lisp_Object Vx_cursor_fore_pixel;
183 /* Nonzero if using X. */
185 static int x_in_use;
187 /* Non nil if no window manager is in use. */
189 Lisp_Object Vx_no_window_manager;
191 /* Regexp matching a font name whose width is the same as `PIXEL_SIZE'. */
193 Lisp_Object Vx_pixel_size_width_font_regexp;
195 Lisp_Object Qnone;
196 Lisp_Object Qsuppress_icon;
197 Lisp_Object Qundefined_color;
198 Lisp_Object Qcompound_text, Qcancel_timer;
199 static Lisp_Object Qfont_param;
201 /* In dispnew.c */
203 extern Lisp_Object Vwindow_system_version;
205 /* The below are defined in frame.c. */
207 #if GLYPH_DEBUG
208 int image_cache_refcount, dpyinfo_refcount;
209 #endif
213 /* Error if we are not connected to X. */
215 void
216 check_x ()
218 if (! x_in_use)
219 error ("X windows are not in use or not initialized");
222 /* Nonzero if we can use mouse menus.
223 You should not call this unless HAVE_MENUS is defined. */
226 have_menus_p ()
228 return x_in_use;
231 /* Extract a frame as a FRAME_PTR, defaulting to the selected frame
232 and checking validity for X. */
234 FRAME_PTR
235 check_x_frame (frame)
236 Lisp_Object frame;
238 FRAME_PTR f;
240 if (NILP (frame))
241 frame = selected_frame;
242 CHECK_LIVE_FRAME (frame);
243 f = XFRAME (frame);
244 if (! FRAME_X_P (f))
245 error ("Non-X frame used");
246 return f;
249 /* Let the user specify an X display with a Lisp object.
250 OBJECT may be nil, a frame or a terminal object.
251 nil stands for the selected frame--or, if that is not an X frame,
252 the first X display on the list. */
254 struct x_display_info *
255 check_x_display_info (object)
256 Lisp_Object object;
258 struct x_display_info *dpyinfo = NULL;
260 if (NILP (object))
262 struct frame *sf = XFRAME (selected_frame);
264 if (FRAME_X_P (sf) && FRAME_LIVE_P (sf))
265 dpyinfo = FRAME_X_DISPLAY_INFO (sf);
266 else if (x_display_list != 0)
267 dpyinfo = x_display_list;
268 else
269 error ("X windows are not in use or not initialized");
271 else if (TERMINALP (object))
273 struct terminal *t = get_terminal (object, 1);
275 if (t->type != output_x_window)
276 error ("Terminal %d is not an X display", XINT (object));
278 dpyinfo = t->display_info.x;
280 else if (STRINGP (object))
281 dpyinfo = x_display_info_for_name (object);
282 else
284 FRAME_PTR f = check_x_frame (object);
285 dpyinfo = FRAME_X_DISPLAY_INFO (f);
288 return dpyinfo;
292 /* Return the Emacs frame-object corresponding to an X window.
293 It could be the frame's main window or an icon window. */
295 /* This function can be called during GC, so use GC_xxx type test macros. */
297 struct frame *
298 x_window_to_frame (dpyinfo, wdesc)
299 struct x_display_info *dpyinfo;
300 int wdesc;
302 Lisp_Object tail, frame;
303 struct frame *f;
305 if (wdesc == None) return 0;
307 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
309 frame = XCAR (tail);
310 if (!FRAMEP (frame))
311 continue;
312 f = XFRAME (frame);
313 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
314 continue;
315 if (f->output_data.x->hourglass_window == wdesc)
316 return f;
317 #ifdef USE_X_TOOLKIT
318 if ((f->output_data.x->edit_widget
319 && XtWindow (f->output_data.x->edit_widget) == wdesc)
320 /* A tooltip frame? */
321 || (!f->output_data.x->edit_widget
322 && FRAME_X_WINDOW (f) == wdesc)
323 || f->output_data.x->icon_desc == wdesc)
324 return f;
325 #else /* not USE_X_TOOLKIT */
326 #ifdef USE_GTK
327 if (f->output_data.x->edit_widget)
329 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
330 struct x_output *x = f->output_data.x;
331 if (gwdesc != 0 && gwdesc == x->edit_widget)
332 return f;
334 #endif /* USE_GTK */
335 if (FRAME_X_WINDOW (f) == wdesc
336 || f->output_data.x->icon_desc == wdesc)
337 return f;
338 #endif /* not USE_X_TOOLKIT */
340 return 0;
343 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
344 /* Like x_window_to_frame but also compares the window with the widget's
345 windows. */
347 struct frame *
348 x_any_window_to_frame (dpyinfo, wdesc)
349 struct x_display_info *dpyinfo;
350 int wdesc;
352 Lisp_Object tail, frame;
353 struct frame *f, *found;
354 struct x_output *x;
356 if (wdesc == None) return NULL;
358 found = NULL;
359 for (tail = Vframe_list; CONSP (tail) && !found; tail = XCDR (tail))
361 frame = XCAR (tail);
362 if (!FRAMEP (frame))
363 continue;
365 f = XFRAME (frame);
366 if (FRAME_X_P (f) && FRAME_X_DISPLAY_INFO (f) == dpyinfo)
368 /* This frame matches if the window is any of its widgets. */
369 x = f->output_data.x;
370 if (x->hourglass_window == wdesc)
371 found = f;
372 else if (x->widget)
374 #ifdef USE_GTK
375 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
376 if (gwdesc != 0
377 && (gwdesc == x->widget
378 || gwdesc == x->edit_widget
379 || gwdesc == x->vbox_widget
380 || gwdesc == x->menubar_widget))
381 found = f;
382 #else
383 if (wdesc == XtWindow (x->widget)
384 || wdesc == XtWindow (x->column_widget)
385 || wdesc == XtWindow (x->edit_widget))
386 found = f;
387 /* Match if the window is this frame's menubar. */
388 else if (lw_window_is_in_menubar (wdesc, x->menubar_widget))
389 found = f;
390 #endif
392 else if (FRAME_X_WINDOW (f) == wdesc)
393 /* A tooltip frame. */
394 found = f;
398 return found;
401 /* Likewise, but exclude the menu bar widget. */
403 struct frame *
404 x_non_menubar_window_to_frame (dpyinfo, wdesc)
405 struct x_display_info *dpyinfo;
406 int wdesc;
408 Lisp_Object tail, frame;
409 struct frame *f;
410 struct x_output *x;
412 if (wdesc == None) return 0;
414 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
416 frame = XCAR (tail);
417 if (!FRAMEP (frame))
418 continue;
419 f = XFRAME (frame);
420 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
421 continue;
422 x = f->output_data.x;
423 /* This frame matches if the window is any of its widgets. */
424 if (x->hourglass_window == wdesc)
425 return f;
426 else if (x->widget)
428 #ifdef USE_GTK
429 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
430 if (gwdesc != 0
431 && (gwdesc == x->widget
432 || gwdesc == x->edit_widget
433 || gwdesc == x->vbox_widget))
434 return f;
435 #else
436 if (wdesc == XtWindow (x->widget)
437 || wdesc == XtWindow (x->column_widget)
438 || wdesc == XtWindow (x->edit_widget))
439 return f;
440 #endif
442 else if (FRAME_X_WINDOW (f) == wdesc)
443 /* A tooltip frame. */
444 return f;
446 return 0;
449 /* Likewise, but consider only the menu bar widget. */
451 struct frame *
452 x_menubar_window_to_frame (dpyinfo, wdesc)
453 struct x_display_info *dpyinfo;
454 int wdesc;
456 Lisp_Object tail, frame;
457 struct frame *f;
458 struct x_output *x;
460 if (wdesc == None) return 0;
462 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
464 frame = XCAR (tail);
465 if (!FRAMEP (frame))
466 continue;
467 f = XFRAME (frame);
468 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
469 continue;
470 x = f->output_data.x;
471 /* Match if the window is this frame's menubar. */
472 #ifdef USE_GTK
473 if (x->menubar_widget)
475 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
476 int found = 0;
478 BLOCK_INPUT;
479 if (gwdesc != 0
480 && (gwdesc == x->menubar_widget
481 || gtk_widget_get_parent (gwdesc) == x->menubar_widget))
482 found = 1;
483 UNBLOCK_INPUT;
484 if (found) return f;
486 #else
487 if (x->menubar_widget
488 && lw_window_is_in_menubar (wdesc, x->menubar_widget))
489 return f;
490 #endif
492 return 0;
495 /* Return the frame whose principal (outermost) window is WDESC.
496 If WDESC is some other (smaller) window, we return 0. */
498 struct frame *
499 x_top_window_to_frame (dpyinfo, wdesc)
500 struct x_display_info *dpyinfo;
501 int wdesc;
503 Lisp_Object tail, frame;
504 struct frame *f;
505 struct x_output *x;
507 if (wdesc == None) return 0;
509 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
511 frame = XCAR (tail);
512 if (!FRAMEP (frame))
513 continue;
514 f = XFRAME (frame);
515 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
516 continue;
517 x = f->output_data.x;
519 if (x->widget)
521 /* This frame matches if the window is its topmost widget. */
522 #ifdef USE_GTK
523 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
524 if (gwdesc == x->widget)
525 return f;
526 #else
527 if (wdesc == XtWindow (x->widget))
528 return f;
529 #if 0 /* I don't know why it did this,
530 but it seems logically wrong,
531 and it causes trouble for MapNotify events. */
532 /* Match if the window is this frame's menubar. */
533 if (x->menubar_widget
534 && wdesc == XtWindow (x->menubar_widget))
535 return f;
536 #endif
537 #endif
539 else if (FRAME_X_WINDOW (f) == wdesc)
540 /* Tooltip frame. */
541 return f;
543 return 0;
545 #endif /* USE_X_TOOLKIT || USE_GTK */
549 static void x_default_font_parameter P_ ((struct frame *, Lisp_Object));
551 static Lisp_Object unwind_create_frame P_ ((Lisp_Object));
552 static Lisp_Object unwind_create_tip_frame P_ ((Lisp_Object));
554 void x_set_foreground_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
555 static void x_set_wait_for_wm P_ ((struct frame *, Lisp_Object, Lisp_Object));
556 void x_set_background_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
557 void x_set_mouse_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
558 void x_set_cursor_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
559 void x_set_border_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
560 void x_set_cursor_type P_ ((struct frame *, Lisp_Object, Lisp_Object));
561 void x_set_icon_type P_ ((struct frame *, Lisp_Object, Lisp_Object));
562 void x_set_icon_name P_ ((struct frame *, Lisp_Object, Lisp_Object));
563 void x_explicitly_set_name P_ ((struct frame *, Lisp_Object, Lisp_Object));
564 void x_set_menu_bar_lines P_ ((struct frame *, Lisp_Object, Lisp_Object));
565 void x_set_title P_ ((struct frame *, Lisp_Object, Lisp_Object));
566 void x_set_tool_bar_lines P_ ((struct frame *, Lisp_Object, Lisp_Object));
567 void x_set_scroll_bar_foreground P_ ((struct frame *, Lisp_Object,
568 Lisp_Object));
569 void x_set_scroll_bar_background P_ ((struct frame *, Lisp_Object,
570 Lisp_Object));
571 static Lisp_Object x_default_scroll_bar_color_parameter P_ ((struct frame *,
572 Lisp_Object,
573 Lisp_Object,
574 char *, char *,
575 int));
578 /* Store the screen positions of frame F into XPTR and YPTR.
579 These are the positions of the containing window manager window,
580 not Emacs's own window. */
582 void
583 x_real_positions (f, xptr, yptr)
584 FRAME_PTR f;
585 int *xptr, *yptr;
587 int win_x, win_y, outer_x, outer_y;
588 int real_x = 0, real_y = 0;
589 int had_errors = 0;
590 Window win = f->output_data.x->parent_desc;
592 BLOCK_INPUT;
594 x_catch_errors (FRAME_X_DISPLAY (f));
596 if (win == FRAME_X_DISPLAY_INFO (f)->root_window)
597 win = FRAME_OUTER_WINDOW (f);
599 /* This loop traverses up the containment tree until we hit the root
600 window. Window managers may intersect many windows between our window
601 and the root window. The window we find just before the root window
602 should be the outer WM window. */
603 for (;;)
605 Window wm_window, rootw;
606 Window *tmp_children;
607 unsigned int tmp_nchildren;
608 int success;
610 success = XQueryTree (FRAME_X_DISPLAY (f), win, &rootw,
611 &wm_window, &tmp_children, &tmp_nchildren);
613 had_errors = x_had_errors_p (FRAME_X_DISPLAY (f));
615 /* Don't free tmp_children if XQueryTree failed. */
616 if (! success)
617 break;
619 XFree ((char *) tmp_children);
621 if (wm_window == rootw || had_errors)
622 break;
624 win = wm_window;
627 if (! had_errors)
629 unsigned int ign;
630 Window child, rootw;
632 /* Get the real coordinates for the WM window upper left corner */
633 XGetGeometry (FRAME_X_DISPLAY (f), win,
634 &rootw, &real_x, &real_y, &ign, &ign, &ign, &ign);
636 /* Translate real coordinates to coordinates relative to our
637 window. For our window, the upper left corner is 0, 0.
638 Since the upper left corner of the WM window is outside
639 our window, win_x and win_y will be negative:
641 ------------------ ---> x
642 | title |
643 | ----------------- v y
644 | | our window
646 XTranslateCoordinates (FRAME_X_DISPLAY (f),
648 /* From-window, to-window. */
649 FRAME_X_DISPLAY_INFO (f)->root_window,
650 FRAME_X_WINDOW (f),
652 /* From-position, to-position. */
653 real_x, real_y, &win_x, &win_y,
655 /* Child of win. */
656 &child);
658 if (FRAME_X_WINDOW (f) == FRAME_OUTER_WINDOW (f))
660 outer_x = win_x;
661 outer_y = win_y;
663 else
665 XTranslateCoordinates (FRAME_X_DISPLAY (f),
667 /* From-window, to-window. */
668 FRAME_X_DISPLAY_INFO (f)->root_window,
669 FRAME_OUTER_WINDOW (f),
671 /* From-position, to-position. */
672 real_x, real_y, &outer_x, &outer_y,
674 /* Child of win. */
675 &child);
678 had_errors = x_had_errors_p (FRAME_X_DISPLAY (f));
681 x_uncatch_errors ();
683 UNBLOCK_INPUT;
685 if (had_errors) return;
687 f->x_pixels_diff = -win_x;
688 f->y_pixels_diff = -win_y;
690 FRAME_X_OUTPUT (f)->x_pixels_outer_diff = -outer_x;
691 FRAME_X_OUTPUT (f)->y_pixels_outer_diff = -outer_y;
693 *xptr = real_x;
694 *yptr = real_y;
700 /* Gamma-correct COLOR on frame F. */
702 void
703 gamma_correct (f, color)
704 struct frame *f;
705 XColor *color;
707 if (f->gamma)
709 color->red = pow (color->red / 65535.0, f->gamma) * 65535.0 + 0.5;
710 color->green = pow (color->green / 65535.0, f->gamma) * 65535.0 + 0.5;
711 color->blue = pow (color->blue / 65535.0, f->gamma) * 65535.0 + 0.5;
716 /* Decide if color named COLOR_NAME is valid for use on frame F. If
717 so, return the RGB values in COLOR. If ALLOC_P is non-zero,
718 allocate the color. Value is zero if COLOR_NAME is invalid, or
719 no color could be allocated. */
722 x_defined_color (f, color_name, color, alloc_p)
723 struct frame *f;
724 char *color_name;
725 XColor *color;
726 int alloc_p;
728 int success_p;
729 Display *dpy = FRAME_X_DISPLAY (f);
730 Colormap cmap = FRAME_X_COLORMAP (f);
732 BLOCK_INPUT;
733 success_p = XParseColor (dpy, cmap, color_name, color);
734 if (success_p && alloc_p)
735 success_p = x_alloc_nearest_color (f, cmap, color);
736 UNBLOCK_INPUT;
738 return success_p;
742 /* Return the pixel color value for color COLOR_NAME on frame F. If F
743 is a monochrome frame, return MONO_COLOR regardless of what ARG says.
744 Signal an error if color can't be allocated. */
747 x_decode_color (f, color_name, mono_color)
748 FRAME_PTR f;
749 Lisp_Object color_name;
750 int mono_color;
752 XColor cdef;
754 CHECK_STRING (color_name);
756 #if 0 /* Don't do this. It's wrong when we're not using the default
757 colormap, it makes freeing difficult, and it's probably not
758 an important optimization. */
759 if (strcmp (SDATA (color_name), "black") == 0)
760 return BLACK_PIX_DEFAULT (f);
761 else if (strcmp (SDATA (color_name), "white") == 0)
762 return WHITE_PIX_DEFAULT (f);
763 #endif
765 /* Return MONO_COLOR for monochrome frames. */
766 if (FRAME_X_DISPLAY_INFO (f)->n_planes == 1)
767 return mono_color;
769 /* x_defined_color is responsible for coping with failures
770 by looking for a near-miss. */
771 if (x_defined_color (f, SDATA (color_name), &cdef, 1))
772 return cdef.pixel;
774 signal_error ("Undefined color", color_name);
779 /* Change the `wait-for-wm' frame parameter of frame F. OLD_VALUE is
780 the previous value of that parameter, NEW_VALUE is the new value.
781 See also the comment of wait_for_wm in struct x_output. */
783 static void
784 x_set_wait_for_wm (f, new_value, old_value)
785 struct frame *f;
786 Lisp_Object new_value, old_value;
788 f->output_data.x->wait_for_wm = !NILP (new_value);
791 #ifdef USE_GTK
793 /* Set icon from FILE for frame F. By using GTK functions the icon
794 may be any format that GdkPixbuf knows about, i.e. not just bitmaps. */
797 xg_set_icon (f, file)
798 FRAME_PTR f;
799 Lisp_Object file;
801 int result = 0;
802 Lisp_Object found;
804 found = x_find_image_file (file);
806 if (! NILP (found))
808 GdkPixbuf *pixbuf;
809 GError *err = NULL;
810 char *filename = (char *) SDATA (found);
811 BLOCK_INPUT;
813 pixbuf = gdk_pixbuf_new_from_file (filename, &err);
815 if (pixbuf)
817 gtk_window_set_icon (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)),
818 pixbuf);
819 g_object_unref (pixbuf);
821 result = 1;
823 else
824 g_error_free (err);
826 UNBLOCK_INPUT;
829 return result;
833 xg_set_icon_from_xpm_data (f, data)
834 FRAME_PTR f;
835 char **data;
837 int result = 0;
838 GdkPixbuf *pixbuf = gdk_pixbuf_new_from_xpm_data ((const char **) data);
840 if (!pixbuf)
841 return 0;
843 gtk_window_set_icon (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)), pixbuf);
844 g_object_unref (pixbuf);
845 return 1;
847 #endif /* USE_GTK */
850 /* Functions called only from `x_set_frame_param'
851 to set individual parameters.
853 If FRAME_X_WINDOW (f) is 0,
854 the frame is being created and its X-window does not exist yet.
855 In that case, just record the parameter's new value
856 in the standard place; do not attempt to change the window. */
858 void
859 x_set_foreground_color (f, arg, oldval)
860 struct frame *f;
861 Lisp_Object arg, oldval;
863 struct x_output *x = f->output_data.x;
864 unsigned long fg, old_fg;
866 fg = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
867 old_fg = FRAME_FOREGROUND_PIXEL (f);
868 FRAME_FOREGROUND_PIXEL (f) = fg;
870 if (FRAME_X_WINDOW (f) != 0)
872 Display *dpy = FRAME_X_DISPLAY (f);
874 BLOCK_INPUT;
875 XSetForeground (dpy, x->normal_gc, fg);
876 XSetBackground (dpy, x->reverse_gc, fg);
878 if (x->cursor_pixel == old_fg)
880 unload_color (f, x->cursor_pixel);
881 x->cursor_pixel = x_copy_color (f, fg);
882 XSetBackground (dpy, x->cursor_gc, x->cursor_pixel);
885 UNBLOCK_INPUT;
887 update_face_from_frame_parameter (f, Qforeground_color, arg);
889 if (FRAME_VISIBLE_P (f))
890 redraw_frame (f);
893 unload_color (f, old_fg);
896 void
897 x_set_background_color (f, arg, oldval)
898 struct frame *f;
899 Lisp_Object arg, oldval;
901 struct x_output *x = f->output_data.x;
902 unsigned long bg;
904 bg = x_decode_color (f, arg, WHITE_PIX_DEFAULT (f));
905 unload_color (f, FRAME_BACKGROUND_PIXEL (f));
906 FRAME_BACKGROUND_PIXEL (f) = bg;
908 if (FRAME_X_WINDOW (f) != 0)
910 Display *dpy = FRAME_X_DISPLAY (f);
912 BLOCK_INPUT;
913 XSetBackground (dpy, x->normal_gc, bg);
914 XSetForeground (dpy, x->reverse_gc, bg);
915 XSetWindowBackground (dpy, FRAME_X_WINDOW (f), bg);
916 XSetForeground (dpy, x->cursor_gc, bg);
918 #ifdef USE_GTK
919 xg_set_background_color (f, bg);
920 #endif
922 #ifndef USE_TOOLKIT_SCROLL_BARS /* Turns out to be annoying with
923 toolkit scroll bars. */
925 Lisp_Object bar;
926 for (bar = FRAME_SCROLL_BARS (f);
927 !NILP (bar);
928 bar = XSCROLL_BAR (bar)->next)
930 Window window = XSCROLL_BAR (bar)->x_window;
931 XSetWindowBackground (dpy, window, bg);
934 #endif /* USE_TOOLKIT_SCROLL_BARS */
936 UNBLOCK_INPUT;
937 update_face_from_frame_parameter (f, Qbackground_color, arg);
939 if (FRAME_VISIBLE_P (f))
940 redraw_frame (f);
944 static Cursor
945 make_invisible_cursor (f)
946 struct frame *f;
948 Display *dpy = FRAME_X_DISPLAY (f);
949 static char const no_data[] = { 0 };
950 Pixmap pix;
951 XColor col;
952 Cursor c;
954 x_catch_errors (dpy);
955 pix = XCreateBitmapFromData (dpy, FRAME_X_DISPLAY_INFO (f)->root_window,
956 no_data, 1, 1);
957 if (! x_had_errors_p (dpy) && pix != None)
959 col.pixel = 0;
960 col.red = col.green = col.blue = 0;
961 col.flags = DoRed | DoGreen | DoBlue;
962 c = XCreatePixmapCursor (dpy, pix, pix, &col, &col, 0, 0);
963 if (x_had_errors_p (dpy) || c == None)
964 c = 0;
965 XFreePixmap (dpy, pix);
968 x_uncatch_errors ();
970 return c;
973 void
974 x_set_mouse_color (f, arg, oldval)
975 struct frame *f;
976 Lisp_Object arg, oldval;
978 struct x_output *x = f->output_data.x;
979 Display *dpy = FRAME_X_DISPLAY (f);
980 Cursor cursor, nontext_cursor, mode_cursor, hand_cursor;
981 Cursor hourglass_cursor, horizontal_drag_cursor;
982 unsigned long pixel = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
983 unsigned long mask_color = FRAME_BACKGROUND_PIXEL (f);
985 /* Don't let pointers be invisible. */
986 if (mask_color == pixel)
988 x_free_colors (f, &pixel, 1);
989 pixel = x_copy_color (f, FRAME_FOREGROUND_PIXEL (f));
992 unload_color (f, x->mouse_pixel);
993 x->mouse_pixel = pixel;
995 BLOCK_INPUT;
997 /* It's not okay to crash if the user selects a screwy cursor. */
998 x_catch_errors (dpy);
1000 if (!NILP (Vx_pointer_shape))
1002 CHECK_NUMBER (Vx_pointer_shape);
1003 cursor = XCreateFontCursor (dpy, XINT (Vx_pointer_shape));
1005 else
1006 cursor = XCreateFontCursor (dpy, XC_xterm);
1007 x_check_errors (dpy, "bad text pointer cursor: %s");
1009 if (!NILP (Vx_nontext_pointer_shape))
1011 CHECK_NUMBER (Vx_nontext_pointer_shape);
1012 nontext_cursor
1013 = XCreateFontCursor (dpy, XINT (Vx_nontext_pointer_shape));
1015 else
1016 nontext_cursor = XCreateFontCursor (dpy, XC_left_ptr);
1017 x_check_errors (dpy, "bad nontext pointer cursor: %s");
1019 if (!NILP (Vx_hourglass_pointer_shape))
1021 CHECK_NUMBER (Vx_hourglass_pointer_shape);
1022 hourglass_cursor
1023 = XCreateFontCursor (dpy, XINT (Vx_hourglass_pointer_shape));
1025 else
1026 hourglass_cursor = XCreateFontCursor (dpy, XC_watch);
1027 x_check_errors (dpy, "bad hourglass pointer cursor: %s");
1029 if (!NILP (Vx_mode_pointer_shape))
1031 CHECK_NUMBER (Vx_mode_pointer_shape);
1032 mode_cursor = XCreateFontCursor (dpy, XINT (Vx_mode_pointer_shape));
1034 else
1035 mode_cursor = XCreateFontCursor (dpy, XC_xterm);
1036 x_check_errors (dpy, "bad modeline pointer cursor: %s");
1038 if (!NILP (Vx_sensitive_text_pointer_shape))
1040 CHECK_NUMBER (Vx_sensitive_text_pointer_shape);
1041 hand_cursor
1042 = XCreateFontCursor (dpy, XINT (Vx_sensitive_text_pointer_shape));
1044 else
1045 hand_cursor = XCreateFontCursor (dpy, XC_hand2);
1047 if (!NILP (Vx_window_horizontal_drag_shape))
1049 CHECK_NUMBER (Vx_window_horizontal_drag_shape);
1050 horizontal_drag_cursor
1051 = XCreateFontCursor (dpy, XINT (Vx_window_horizontal_drag_shape));
1053 else
1054 horizontal_drag_cursor
1055 = XCreateFontCursor (dpy, XC_sb_h_double_arrow);
1057 /* Check and report errors with the above calls. */
1058 x_check_errors (dpy, "can't set cursor shape: %s");
1059 x_uncatch_errors ();
1062 XColor fore_color, back_color;
1064 fore_color.pixel = x->mouse_pixel;
1065 x_query_color (f, &fore_color);
1066 back_color.pixel = mask_color;
1067 x_query_color (f, &back_color);
1069 XRecolorCursor (dpy, cursor, &fore_color, &back_color);
1070 XRecolorCursor (dpy, nontext_cursor, &fore_color, &back_color);
1071 XRecolorCursor (dpy, mode_cursor, &fore_color, &back_color);
1072 XRecolorCursor (dpy, hand_cursor, &fore_color, &back_color);
1073 XRecolorCursor (dpy, hourglass_cursor, &fore_color, &back_color);
1074 XRecolorCursor (dpy, horizontal_drag_cursor, &fore_color, &back_color);
1077 if (FRAME_X_WINDOW (f) != 0)
1078 XDefineCursor (dpy, FRAME_X_WINDOW (f),
1079 f->output_data.x->current_cursor = cursor);
1081 if (FRAME_X_DISPLAY_INFO (f)->invisible_cursor == 0)
1082 FRAME_X_DISPLAY_INFO (f)->invisible_cursor = make_invisible_cursor (f);
1084 if (cursor != x->text_cursor
1085 && x->text_cursor != 0)
1086 XFreeCursor (dpy, x->text_cursor);
1087 x->text_cursor = cursor;
1089 if (nontext_cursor != x->nontext_cursor
1090 && x->nontext_cursor != 0)
1091 XFreeCursor (dpy, x->nontext_cursor);
1092 x->nontext_cursor = nontext_cursor;
1094 if (hourglass_cursor != x->hourglass_cursor
1095 && x->hourglass_cursor != 0)
1096 XFreeCursor (dpy, x->hourglass_cursor);
1097 x->hourglass_cursor = hourglass_cursor;
1099 if (mode_cursor != x->modeline_cursor
1100 && x->modeline_cursor != 0)
1101 XFreeCursor (dpy, f->output_data.x->modeline_cursor);
1102 x->modeline_cursor = mode_cursor;
1104 if (hand_cursor != x->hand_cursor
1105 && x->hand_cursor != 0)
1106 XFreeCursor (dpy, x->hand_cursor);
1107 x->hand_cursor = hand_cursor;
1109 if (horizontal_drag_cursor != x->horizontal_drag_cursor
1110 && x->horizontal_drag_cursor != 0)
1111 XFreeCursor (dpy, x->horizontal_drag_cursor);
1112 x->horizontal_drag_cursor = horizontal_drag_cursor;
1114 XFlush (dpy);
1115 UNBLOCK_INPUT;
1117 update_face_from_frame_parameter (f, Qmouse_color, arg);
1120 void
1121 x_set_cursor_color (f, arg, oldval)
1122 struct frame *f;
1123 Lisp_Object arg, oldval;
1125 unsigned long fore_pixel, pixel;
1126 int fore_pixel_allocated_p = 0, pixel_allocated_p = 0;
1127 struct x_output *x = f->output_data.x;
1129 if (!NILP (Vx_cursor_fore_pixel))
1131 fore_pixel = x_decode_color (f, Vx_cursor_fore_pixel,
1132 WHITE_PIX_DEFAULT (f));
1133 fore_pixel_allocated_p = 1;
1135 else
1136 fore_pixel = FRAME_BACKGROUND_PIXEL (f);
1138 pixel = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
1139 pixel_allocated_p = 1;
1141 /* Make sure that the cursor color differs from the background color. */
1142 if (pixel == FRAME_BACKGROUND_PIXEL (f))
1144 if (pixel_allocated_p)
1146 x_free_colors (f, &pixel, 1);
1147 pixel_allocated_p = 0;
1150 pixel = x->mouse_pixel;
1151 if (pixel == fore_pixel)
1153 if (fore_pixel_allocated_p)
1155 x_free_colors (f, &fore_pixel, 1);
1156 fore_pixel_allocated_p = 0;
1158 fore_pixel = FRAME_BACKGROUND_PIXEL (f);
1162 unload_color (f, x->cursor_foreground_pixel);
1163 if (!fore_pixel_allocated_p)
1164 fore_pixel = x_copy_color (f, fore_pixel);
1165 x->cursor_foreground_pixel = fore_pixel;
1167 unload_color (f, x->cursor_pixel);
1168 if (!pixel_allocated_p)
1169 pixel = x_copy_color (f, pixel);
1170 x->cursor_pixel = pixel;
1172 if (FRAME_X_WINDOW (f) != 0)
1174 BLOCK_INPUT;
1175 XSetBackground (FRAME_X_DISPLAY (f), x->cursor_gc, x->cursor_pixel);
1176 XSetForeground (FRAME_X_DISPLAY (f), x->cursor_gc, fore_pixel);
1177 UNBLOCK_INPUT;
1179 if (FRAME_VISIBLE_P (f))
1181 x_update_cursor (f, 0);
1182 x_update_cursor (f, 1);
1186 update_face_from_frame_parameter (f, Qcursor_color, arg);
1189 /* Set the border-color of frame F to pixel value PIX.
1190 Note that this does not fully take effect if done before
1191 F has an x-window. */
1193 void
1194 x_set_border_pixel (f, pix)
1195 struct frame *f;
1196 int pix;
1198 unload_color (f, f->output_data.x->border_pixel);
1199 f->output_data.x->border_pixel = pix;
1201 if (FRAME_X_WINDOW (f) != 0 && f->border_width > 0)
1203 BLOCK_INPUT;
1204 XSetWindowBorder (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1205 (unsigned long)pix);
1206 UNBLOCK_INPUT;
1208 if (FRAME_VISIBLE_P (f))
1209 redraw_frame (f);
1213 /* Set the border-color of frame F to value described by ARG.
1214 ARG can be a string naming a color.
1215 The border-color is used for the border that is drawn by the X server.
1216 Note that this does not fully take effect if done before
1217 F has an x-window; it must be redone when the window is created.
1219 Note: this is done in two routines because of the way X10 works.
1221 Note: under X11, this is normally the province of the window manager,
1222 and so emacs' border colors may be overridden. */
1224 void
1225 x_set_border_color (f, arg, oldval)
1226 struct frame *f;
1227 Lisp_Object arg, oldval;
1229 int pix;
1231 CHECK_STRING (arg);
1232 pix = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
1233 x_set_border_pixel (f, pix);
1234 update_face_from_frame_parameter (f, Qborder_color, arg);
1238 void
1239 x_set_cursor_type (f, arg, oldval)
1240 FRAME_PTR f;
1241 Lisp_Object arg, oldval;
1243 set_frame_cursor_types (f, arg);
1245 /* Make sure the cursor gets redrawn. */
1246 cursor_type_changed = 1;
1249 void
1250 x_set_icon_type (f, arg, oldval)
1251 struct frame *f;
1252 Lisp_Object arg, oldval;
1254 int result;
1256 if (STRINGP (arg))
1258 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
1259 return;
1261 else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
1262 return;
1264 BLOCK_INPUT;
1265 if (NILP (arg))
1266 result = x_text_icon (f,
1267 (char *) SDATA ((!NILP (f->icon_name)
1268 ? f->icon_name
1269 : f->name)));
1270 else
1271 result = x_bitmap_icon (f, arg);
1273 if (result)
1275 UNBLOCK_INPUT;
1276 error ("No icon window available");
1279 XFlush (FRAME_X_DISPLAY (f));
1280 UNBLOCK_INPUT;
1283 void
1284 x_set_icon_name (f, arg, oldval)
1285 struct frame *f;
1286 Lisp_Object arg, oldval;
1288 int result;
1290 if (STRINGP (arg))
1292 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
1293 return;
1295 else if (!NILP (arg) || NILP (oldval))
1296 return;
1298 f->icon_name = arg;
1300 if (f->output_data.x->icon_bitmap != 0)
1301 return;
1303 BLOCK_INPUT;
1305 result = x_text_icon (f,
1306 (char *) SDATA ((!NILP (f->icon_name)
1307 ? f->icon_name
1308 : !NILP (f->title)
1309 ? f->title
1310 : f->name)));
1312 if (result)
1314 UNBLOCK_INPUT;
1315 error ("No icon window available");
1318 XFlush (FRAME_X_DISPLAY (f));
1319 UNBLOCK_INPUT;
1323 void
1324 x_set_menu_bar_lines (f, value, oldval)
1325 struct frame *f;
1326 Lisp_Object value, oldval;
1328 int nlines;
1329 #if ! defined (USE_X_TOOLKIT) && ! defined (USE_GTK)
1330 int olines = FRAME_MENU_BAR_LINES (f);
1331 #endif
1333 /* Right now, menu bars don't work properly in minibuf-only frames;
1334 most of the commands try to apply themselves to the minibuffer
1335 frame itself, and get an error because you can't switch buffers
1336 in or split the minibuffer window. */
1337 if (FRAME_MINIBUF_ONLY_P (f))
1338 return;
1340 if (INTEGERP (value))
1341 nlines = XINT (value);
1342 else
1343 nlines = 0;
1345 /* Make sure we redisplay all windows in this frame. */
1346 windows_or_buffers_changed++;
1348 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
1349 FRAME_MENU_BAR_LINES (f) = 0;
1350 if (nlines)
1352 FRAME_EXTERNAL_MENU_BAR (f) = 1;
1353 if (FRAME_X_P (f) && f->output_data.x->menubar_widget == 0)
1354 /* Make sure next redisplay shows the menu bar. */
1355 XWINDOW (FRAME_SELECTED_WINDOW (f))->update_mode_line = Qt;
1357 else
1359 if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
1360 free_frame_menubar (f);
1361 FRAME_EXTERNAL_MENU_BAR (f) = 0;
1362 if (FRAME_X_P (f))
1363 f->output_data.x->menubar_widget = 0;
1365 #else /* not USE_X_TOOLKIT && not USE_GTK */
1366 FRAME_MENU_BAR_LINES (f) = nlines;
1367 change_window_heights (f->root_window, nlines - olines);
1368 #endif /* not USE_X_TOOLKIT */
1369 adjust_glyphs (f);
1373 /* Set the number of lines used for the tool bar of frame F to VALUE.
1374 VALUE not an integer, or < 0 means set the lines to zero. OLDVAL
1375 is the old number of tool bar lines. This function changes the
1376 height of all windows on frame F to match the new tool bar height.
1377 The frame's height doesn't change. */
1379 void
1380 x_set_tool_bar_lines (f, value, oldval)
1381 struct frame *f;
1382 Lisp_Object value, oldval;
1384 int delta, nlines, root_height;
1385 Lisp_Object root_window;
1387 /* Treat tool bars like menu bars. */
1388 if (FRAME_MINIBUF_ONLY_P (f))
1389 return;
1391 /* Use VALUE only if an integer >= 0. */
1392 if (INTEGERP (value) && XINT (value) >= 0)
1393 nlines = XFASTINT (value);
1394 else
1395 nlines = 0;
1397 #ifdef USE_GTK
1398 FRAME_TOOL_BAR_LINES (f) = 0;
1399 if (nlines)
1401 FRAME_EXTERNAL_TOOL_BAR (f) = 1;
1402 if (FRAME_X_P (f) && f->output_data.x->toolbar_widget == 0)
1403 /* Make sure next redisplay shows the tool bar. */
1404 XWINDOW (FRAME_SELECTED_WINDOW (f))->update_mode_line = Qt;
1405 update_frame_tool_bar (f);
1407 else
1409 if (FRAME_EXTERNAL_TOOL_BAR (f))
1410 free_frame_tool_bar (f);
1411 FRAME_EXTERNAL_TOOL_BAR (f) = 0;
1414 return;
1415 #endif
1417 /* Make sure we redisplay all windows in this frame. */
1418 ++windows_or_buffers_changed;
1420 delta = nlines - FRAME_TOOL_BAR_LINES (f);
1422 /* Don't resize the tool-bar to more than we have room for. */
1423 root_window = FRAME_ROOT_WINDOW (f);
1424 root_height = WINDOW_TOTAL_LINES (XWINDOW (root_window));
1425 if (root_height - delta < 1)
1427 delta = root_height - 1;
1428 nlines = FRAME_TOOL_BAR_LINES (f) + delta;
1431 FRAME_TOOL_BAR_LINES (f) = nlines;
1432 change_window_heights (root_window, delta);
1433 adjust_glyphs (f);
1435 /* We also have to make sure that the internal border at the top of
1436 the frame, below the menu bar or tool bar, is redrawn when the
1437 tool bar disappears. This is so because the internal border is
1438 below the tool bar if one is displayed, but is below the menu bar
1439 if there isn't a tool bar. The tool bar draws into the area
1440 below the menu bar. */
1441 if (FRAME_X_WINDOW (f) && FRAME_TOOL_BAR_LINES (f) == 0)
1443 clear_frame (f);
1444 clear_current_matrices (f);
1447 /* If the tool bar gets smaller, the internal border below it
1448 has to be cleared. It was formerly part of the display
1449 of the larger tool bar, and updating windows won't clear it. */
1450 if (delta < 0)
1452 int height = FRAME_INTERNAL_BORDER_WIDTH (f);
1453 int width = FRAME_PIXEL_WIDTH (f);
1454 int y = nlines * FRAME_LINE_HEIGHT (f);
1456 /* height can be zero here. */
1457 if (height > 0 && width > 0)
1459 BLOCK_INPUT;
1460 x_clear_area (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1461 0, y, width, height, False);
1462 UNBLOCK_INPUT;
1465 if (WINDOWP (f->tool_bar_window))
1466 clear_glyph_matrix (XWINDOW (f->tool_bar_window)->current_matrix);
1471 /* Set the foreground color for scroll bars on frame F to VALUE.
1472 VALUE should be a string, a color name. If it isn't a string or
1473 isn't a valid color name, do nothing. OLDVAL is the old value of
1474 the frame parameter. */
1476 void
1477 x_set_scroll_bar_foreground (f, value, oldval)
1478 struct frame *f;
1479 Lisp_Object value, oldval;
1481 unsigned long pixel;
1483 if (STRINGP (value))
1484 pixel = x_decode_color (f, value, BLACK_PIX_DEFAULT (f));
1485 else
1486 pixel = -1;
1488 if (f->output_data.x->scroll_bar_foreground_pixel != -1)
1489 unload_color (f, f->output_data.x->scroll_bar_foreground_pixel);
1491 f->output_data.x->scroll_bar_foreground_pixel = pixel;
1492 if (FRAME_X_WINDOW (f) && FRAME_VISIBLE_P (f))
1494 /* Remove all scroll bars because they have wrong colors. */
1495 if (FRAME_TERMINAL (f)->condemn_scroll_bars_hook)
1496 (*FRAME_TERMINAL (f)->condemn_scroll_bars_hook) (f);
1497 if (FRAME_TERMINAL (f)->judge_scroll_bars_hook)
1498 (*FRAME_TERMINAL (f)->judge_scroll_bars_hook) (f);
1500 update_face_from_frame_parameter (f, Qscroll_bar_foreground, value);
1501 redraw_frame (f);
1506 /* Set the background color for scroll bars on frame F to VALUE VALUE
1507 should be a string, a color name. If it isn't a string or isn't a
1508 valid color name, do nothing. OLDVAL is the old value of the frame
1509 parameter. */
1511 void
1512 x_set_scroll_bar_background (f, value, oldval)
1513 struct frame *f;
1514 Lisp_Object value, oldval;
1516 unsigned long pixel;
1518 if (STRINGP (value))
1519 pixel = x_decode_color (f, value, WHITE_PIX_DEFAULT (f));
1520 else
1521 pixel = -1;
1523 if (f->output_data.x->scroll_bar_background_pixel != -1)
1524 unload_color (f, f->output_data.x->scroll_bar_background_pixel);
1526 #ifdef USE_TOOLKIT_SCROLL_BARS
1527 /* Scrollbar shadow colors. */
1528 if (f->output_data.x->scroll_bar_top_shadow_pixel != -1)
1530 unload_color (f, f->output_data.x->scroll_bar_top_shadow_pixel);
1531 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
1533 if (f->output_data.x->scroll_bar_bottom_shadow_pixel != -1)
1535 unload_color (f, f->output_data.x->scroll_bar_bottom_shadow_pixel);
1536 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
1538 #endif /* USE_TOOLKIT_SCROLL_BARS */
1540 f->output_data.x->scroll_bar_background_pixel = pixel;
1541 if (FRAME_X_WINDOW (f) && FRAME_VISIBLE_P (f))
1543 /* Remove all scroll bars because they have wrong colors. */
1544 if (FRAME_TERMINAL (f)->condemn_scroll_bars_hook)
1545 (*FRAME_TERMINAL (f)->condemn_scroll_bars_hook) (f);
1546 if (FRAME_TERMINAL (f)->judge_scroll_bars_hook)
1547 (*FRAME_TERMINAL (f)->judge_scroll_bars_hook) (f);
1549 update_face_from_frame_parameter (f, Qscroll_bar_background, value);
1550 redraw_frame (f);
1555 /* Encode Lisp string STRING as a text in a format appropriate for
1556 XICCC (X Inter Client Communication Conventions).
1558 This can call Lisp code, so callers must GCPRO.
1560 If STRING contains only ASCII characters, do no conversion and
1561 return the string data of STRING. Otherwise, encode the text by
1562 CODING_SYSTEM, and return a newly allocated memory area which
1563 should be freed by `xfree' by a caller.
1565 SELECTIONP non-zero means the string is being encoded for an X
1566 selection, so it is safe to run pre-write conversions (which
1567 may run Lisp code).
1569 Store the byte length of resulting text in *TEXT_BYTES.
1571 If the text contains only ASCII and Latin-1, store 1 in *STRING_P,
1572 which means that the `encoding' of the result can be `STRING'.
1573 Otherwise store 0 in *STRINGP, which means that the `encoding' of
1574 the result should be `COMPOUND_TEXT'. */
1576 static unsigned char *
1577 x_encode_text (string, coding_system, selectionp, text_bytes, stringp, freep)
1578 Lisp_Object string, coding_system;
1579 int *text_bytes, *stringp;
1580 int selectionp;
1581 int *freep;
1583 int result = string_xstring_p (string);
1584 struct coding_system coding;
1586 if (result == 0)
1588 /* No multibyte character in OBJ. We need not encode it. */
1589 *text_bytes = SBYTES (string);
1590 *stringp = 1;
1591 *freep = 0;
1592 return SDATA (string);
1595 setup_coding_system (coding_system, &coding);
1596 coding.mode |= (CODING_MODE_SAFE_ENCODING | CODING_MODE_LAST_BLOCK);
1597 /* We suppress producing escape sequences for composition. */
1598 coding.common_flags &= ~CODING_ANNOTATION_MASK;
1599 coding.dst_bytes = SCHARS (string) * 2;
1600 coding.destination = (unsigned char *) xmalloc (coding.dst_bytes);
1601 encode_coding_object (&coding, string, 0, 0,
1602 SCHARS (string), SBYTES (string), Qnil);
1603 *text_bytes = coding.produced;
1604 *stringp = (result == 1 || !EQ (coding_system, Qcompound_text));
1605 *freep = 1;
1606 return coding.destination;
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;
1623 XTextProperty text, icon;
1624 int bytes, stringp;
1625 int do_free_icon_value = 0, do_free_text_value = 0;
1626 Lisp_Object coding_system;
1627 #ifdef USE_GTK
1628 Lisp_Object encoded_name;
1629 struct gcpro gcpro1;
1631 /* As ENCODE_UTF_8 may cause GC and relocation of string data,
1632 we use it before x_encode_text that may return string data. */
1633 GCPRO1 (name);
1634 encoded_name = ENCODE_UTF_8 (name);
1635 UNGCPRO;
1636 #endif
1638 coding_system = Qcompound_text;
1639 /* Note: Encoding strategy
1641 We encode NAME by compound-text and use "COMPOUND-TEXT" in
1642 text.encoding. But, there are non-internationalized window
1643 managers which don't support that encoding. So, if NAME
1644 contains only ASCII and 8859-1 characters, encode it by
1645 iso-latin-1, and use "STRING" in text.encoding hoping that
1646 such window managers at least analyze this format correctly,
1647 i.e. treat 8-bit bytes as 8859-1 characters.
1649 We may also be able to use "UTF8_STRING" in text.encoding
1650 in the future which can encode all Unicode characters.
1651 But, for the moment, there's no way to know that the
1652 current window manager supports it or not. */
1653 text.value = x_encode_text (name, coding_system, 0, &bytes, &stringp,
1654 &do_free_text_value);
1655 text.encoding = (stringp ? XA_STRING
1656 : FRAME_X_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
1657 text.format = 8;
1658 text.nitems = bytes;
1660 if (!STRINGP (f->icon_name))
1662 icon = text;
1664 else
1666 /* See the above comment "Note: Encoding strategy". */
1667 icon.value = x_encode_text (f->icon_name, coding_system, 0,
1668 &bytes, &stringp, &do_free_icon_value);
1669 icon.encoding = (stringp ? XA_STRING
1670 : FRAME_X_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
1671 icon.format = 8;
1672 icon.nitems = bytes;
1675 #ifdef USE_GTK
1676 gtk_window_set_title (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)),
1677 (char *) SDATA (encoded_name));
1678 #else /* not USE_GTK */
1679 XSetWMName (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &text);
1680 #endif /* not USE_GTK */
1682 XSetWMIconName (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &icon);
1684 if (do_free_icon_value)
1685 xfree (icon.value);
1686 if (do_free_text_value)
1687 xfree (text.value);
1689 UNBLOCK_INPUT;
1693 /* Change the name of frame F to NAME. If NAME is nil, set F's name to
1694 x_id_name.
1696 If EXPLICIT is non-zero, that indicates that lisp code is setting the
1697 name; if NAME is a string, set F's name to NAME and set
1698 F->explicit_name; if NAME is Qnil, then clear F->explicit_name.
1700 If EXPLICIT is zero, that indicates that Emacs redisplay code is
1701 suggesting a new name, which lisp code should override; if
1702 F->explicit_name is set, ignore the new name; otherwise, set it. */
1704 void
1705 x_set_name (f, name, explicit)
1706 struct frame *f;
1707 Lisp_Object name;
1708 int explicit;
1710 /* Make sure that requests from lisp code override requests from
1711 Emacs redisplay code. */
1712 if (explicit)
1714 /* If we're switching from explicit to implicit, we had better
1715 update the mode lines and thereby update the title. */
1716 if (f->explicit_name && NILP (name))
1717 update_mode_lines = 1;
1719 f->explicit_name = ! NILP (name);
1721 else if (f->explicit_name)
1722 return;
1724 /* If NAME is nil, set the name to the x_id_name. */
1725 if (NILP (name))
1727 /* Check for no change needed in this very common case
1728 before we do any consing. */
1729 if (!strcmp (FRAME_X_DISPLAY_INFO (f)->x_id_name,
1730 SDATA (f->name)))
1731 return;
1732 name = build_string (FRAME_X_DISPLAY_INFO (f)->x_id_name);
1734 else
1735 CHECK_STRING (name);
1737 /* Don't change the name if it's already NAME. */
1738 if (! NILP (Fstring_equal (name, f->name)))
1739 return;
1741 f->name = name;
1743 /* For setting the frame title, the title parameter should override
1744 the name parameter. */
1745 if (! NILP (f->title))
1746 name = f->title;
1748 x_set_name_internal (f, name);
1751 /* This function should be called when the user's lisp code has
1752 specified a name for the frame; the name will override any set by the
1753 redisplay code. */
1754 void
1755 x_explicitly_set_name (f, arg, oldval)
1756 FRAME_PTR f;
1757 Lisp_Object arg, oldval;
1759 x_set_name (f, arg, 1);
1762 /* This function should be called by Emacs redisplay code to set the
1763 name; names set this way will never override names set by the user's
1764 lisp code. */
1765 void
1766 x_implicitly_set_name (f, arg, oldval)
1767 FRAME_PTR f;
1768 Lisp_Object arg, oldval;
1770 x_set_name (f, arg, 0);
1773 /* Change the title of frame F to NAME.
1774 If NAME is nil, use the frame name as the title. */
1776 void
1777 x_set_title (f, name, old_name)
1778 struct frame *f;
1779 Lisp_Object name, old_name;
1781 /* Don't change the title if it's already NAME. */
1782 if (EQ (name, f->title))
1783 return;
1785 update_mode_lines = 1;
1787 f->title = name;
1789 if (NILP (name))
1790 name = f->name;
1791 else
1792 CHECK_STRING (name);
1794 x_set_name_internal (f, name);
1797 void
1798 x_set_scroll_bar_default_width (f)
1799 struct frame *f;
1801 int wid = FRAME_COLUMN_WIDTH (f);
1803 #ifdef USE_TOOLKIT_SCROLL_BARS
1804 /* A minimum width of 14 doesn't look good for toolkit scroll bars. */
1805 int width = 16 + 2 * VERTICAL_SCROLL_BAR_WIDTH_TRIM;
1806 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (width + wid - 1) / wid;
1807 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = width;
1808 #else
1809 /* Make the actual width at least 14 pixels and a multiple of a
1810 character width. */
1811 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (14 + wid - 1) / wid;
1813 /* Use all of that space (aside from required margins) for the
1814 scroll bar. */
1815 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = 0;
1816 #endif
1820 /* Record in frame F the specified or default value according to ALIST
1821 of the parameter named PROP (a Lisp symbol). If no value is
1822 specified for PROP, look for an X default for XPROP on the frame
1823 named NAME. If that is not found either, use the value DEFLT. */
1825 static Lisp_Object
1826 x_default_scroll_bar_color_parameter (f, alist, prop, xprop, xclass,
1827 foreground_p)
1828 struct frame *f;
1829 Lisp_Object alist;
1830 Lisp_Object prop;
1831 char *xprop;
1832 char *xclass;
1833 int foreground_p;
1835 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
1836 Lisp_Object tem;
1838 tem = x_get_arg (dpyinfo, alist, prop, xprop, xclass, RES_TYPE_STRING);
1839 if (EQ (tem, Qunbound))
1841 #ifdef USE_TOOLKIT_SCROLL_BARS
1843 /* See if an X resource for the scroll bar color has been
1844 specified. */
1845 tem = display_x_get_resource (dpyinfo,
1846 build_string (foreground_p
1847 ? "foreground"
1848 : "background"),
1849 empty_unibyte_string,
1850 build_string ("verticalScrollBar"),
1851 empty_unibyte_string);
1852 if (!STRINGP (tem))
1854 /* If nothing has been specified, scroll bars will use a
1855 toolkit-dependent default. Because these defaults are
1856 difficult to get at without actually creating a scroll
1857 bar, use nil to indicate that no color has been
1858 specified. */
1859 tem = Qnil;
1862 #else /* not USE_TOOLKIT_SCROLL_BARS */
1864 tem = Qnil;
1866 #endif /* not USE_TOOLKIT_SCROLL_BARS */
1869 x_set_frame_parameters (f, Fcons (Fcons (prop, tem), Qnil));
1870 return tem;
1876 #ifdef USE_X_TOOLKIT
1878 /* If the WM_PROTOCOLS property does not already contain WM_TAKE_FOCUS,
1879 WM_DELETE_WINDOW, and WM_SAVE_YOURSELF, then add them. (They may
1880 already be present because of the toolkit (Motif adds some of them,
1881 for example, but Xt doesn't). */
1883 static void
1884 hack_wm_protocols (f, widget)
1885 FRAME_PTR f;
1886 Widget widget;
1888 Display *dpy = XtDisplay (widget);
1889 Window w = XtWindow (widget);
1890 int need_delete = 1;
1891 int need_focus = 1;
1892 int need_save = 1;
1894 BLOCK_INPUT;
1896 Atom type;
1897 unsigned char *catoms;
1898 int format = 0;
1899 unsigned long nitems = 0;
1900 unsigned long bytes_after;
1902 if ((XGetWindowProperty (dpy, w,
1903 FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
1904 (long)0, (long)100, False, XA_ATOM,
1905 &type, &format, &nitems, &bytes_after,
1906 &catoms)
1907 == Success)
1908 && format == 32 && type == XA_ATOM)
1910 Atom *atoms = (Atom *) catoms;
1911 while (nitems > 0)
1913 nitems--;
1914 if (atoms[nitems]
1915 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window)
1916 need_delete = 0;
1917 else if (atoms[nitems]
1918 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_take_focus)
1919 need_focus = 0;
1920 else if (atoms[nitems]
1921 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself)
1922 need_save = 0;
1925 if (catoms)
1926 XFree (catoms);
1929 Atom props [10];
1930 int count = 0;
1931 if (need_delete)
1932 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window;
1933 if (need_focus)
1934 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_take_focus;
1935 if (need_save)
1936 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself;
1937 if (count)
1938 XChangeProperty (dpy, w, FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
1939 XA_ATOM, 32, PropModeAppend,
1940 (unsigned char *) props, count);
1942 UNBLOCK_INPUT;
1944 #endif
1948 /* Support routines for XIC (X Input Context). */
1950 #ifdef HAVE_X_I18N
1952 static XFontSet xic_create_xfontset P_ ((struct frame *));
1953 static XIMStyle best_xim_style P_ ((XIMStyles *, XIMStyles *));
1956 /* Supported XIM styles, ordered by preference. */
1958 static XIMStyle supported_xim_styles[] =
1960 XIMPreeditPosition | XIMStatusArea,
1961 XIMPreeditPosition | XIMStatusNothing,
1962 XIMPreeditPosition | XIMStatusNone,
1963 XIMPreeditNothing | XIMStatusArea,
1964 XIMPreeditNothing | XIMStatusNothing,
1965 XIMPreeditNothing | XIMStatusNone,
1966 XIMPreeditNone | XIMStatusArea,
1967 XIMPreeditNone | XIMStatusNothing,
1968 XIMPreeditNone | XIMStatusNone,
1973 /* Create an X fontset on frame F with base font name BASE_FONTNAME. */
1975 char xic_defaut_fontset[] = "-*-*-*-r-normal--14-*-*-*-*-*-*-*";
1977 /* Create an Xt fontset spec from the name of a base font.
1978 If `motif' is True use the Motif syntax. */
1979 char *
1980 xic_create_fontsetname (base_fontname, motif)
1981 char *base_fontname;
1982 Bool motif;
1984 const char *sep = motif ? ";" : ",";
1985 char *fontsetname;
1987 /* Make a fontset name from the base font name. */
1988 if (xic_defaut_fontset == base_fontname)
1989 { /* There is no base font name, use the default. */
1990 int len = strlen (base_fontname) + 2;
1991 fontsetname = xmalloc (len);
1992 bzero (fontsetname, len);
1993 strcpy (fontsetname, base_fontname);
1995 else
1997 /* Make a fontset name from the base font name.
1998 The font set will be made of the following elements:
1999 - the base font.
2000 - the base font where the charset spec is replaced by -*-*.
2001 - the same but with the family also replaced with -*-*-. */
2002 char *p = base_fontname;
2003 int i;
2005 for (i = 0; *p; p++)
2006 if (*p == '-') i++;
2007 if (i != 14)
2008 { /* As the font name doesn't conform to XLFD, we can't
2009 modify it to generalize it to allcs and allfamilies.
2010 Use the specified font plus the default. */
2011 int len = strlen (base_fontname) + strlen (xic_defaut_fontset) + 3;
2012 fontsetname = xmalloc (len);
2013 bzero (fontsetname, len);
2014 strcpy (fontsetname, base_fontname);
2015 strcat (fontsetname, sep);
2016 strcat (fontsetname, xic_defaut_fontset);
2018 else
2020 int len;
2021 char *p1 = NULL, *p2 = NULL, *p3 = NULL;
2022 char *font_allcs = NULL;
2023 char *font_allfamilies = NULL;
2024 char *font_all = NULL;
2025 char *allcs = "*-*-*-*-*-*-*";
2026 char *allfamilies = "-*-*-";
2027 char *all = "*-*-*-*-";
2028 char *base;
2030 for (i = 0, p = base_fontname; i < 8; p++)
2032 if (*p == '-')
2034 i++;
2035 if (i == 3)
2036 p1 = p + 1;
2037 else if (i == 7)
2038 p2 = p + 1;
2039 else if (i == 6)
2040 p3 = p + 1;
2043 /* If base_fontname specifies ADSTYLE, make it a
2044 wildcard. */
2045 if (*p3 != '*')
2047 int diff = (p2 - p3) - 2;
2049 base = alloca (strlen (base_fontname) + 1);
2050 bcopy (base_fontname, base, p3 - base_fontname);
2051 base[p3 - base_fontname] = '*';
2052 base[(p3 - base_fontname) + 1] = '-';
2053 strcpy (base + (p3 - base_fontname) + 2, p2);
2054 p = base + (p - base_fontname) - diff;
2055 p1 = base + (p1 - base_fontname);
2056 p2 = base + (p2 - base_fontname) - diff;
2057 base_fontname = base;
2060 /* Build the font spec that matches all charsets. */
2061 len = p - base_fontname + strlen (allcs) + 1;
2062 font_allcs = (char *) alloca (len);
2063 bzero (font_allcs, len);
2064 bcopy (base_fontname, font_allcs, p - base_fontname);
2065 strcat (font_allcs, allcs);
2067 /* Build the font spec that matches all families and
2068 add-styles. */
2069 len = p - p1 + strlen (allcs) + strlen (allfamilies) + 1;
2070 font_allfamilies = (char *) alloca (len);
2071 bzero (font_allfamilies, len);
2072 strcpy (font_allfamilies, allfamilies);
2073 bcopy (p1, font_allfamilies + strlen (allfamilies), p - p1);
2074 strcat (font_allfamilies, allcs);
2076 /* Build the font spec that matches all. */
2077 len = p - p2 + strlen (allcs) + strlen (all) + strlen (allfamilies) + 1;
2078 font_all = (char *) alloca (len);
2079 bzero (font_all, len);
2080 strcpy (font_all, allfamilies);
2081 strcat (font_all, all);
2082 bcopy (p2, font_all + strlen (all) + strlen (allfamilies), p - p2);
2083 strcat (font_all, allcs);
2085 /* Build the actual font set name. */
2086 len = strlen (base_fontname) + strlen (font_allcs)
2087 + strlen (font_allfamilies) + strlen (font_all) + 5;
2088 fontsetname = xmalloc (len);
2089 bzero (fontsetname, len);
2090 strcpy (fontsetname, base_fontname);
2091 strcat (fontsetname, sep);
2092 strcat (fontsetname, font_allcs);
2093 strcat (fontsetname, sep);
2094 strcat (fontsetname, font_allfamilies);
2095 strcat (fontsetname, sep);
2096 strcat (fontsetname, font_all);
2099 if (motif)
2100 strcat (fontsetname, ":");
2101 return fontsetname;
2104 #ifdef DEBUG_XIC_FONTSET
2105 static void
2106 print_fontset_result (xfs, name, missing_list, missing_count)
2107 XFontSet xfs;
2108 char *name;
2109 char **missing_list;
2110 int missing_count;
2112 if (xfs)
2113 fprintf (stderr, "XIC Fontset created: %s\n", name);
2114 else
2116 fprintf (stderr, "XIC Fontset failed: %s\n", name);
2117 while (missing_count-- > 0)
2119 fprintf (stderr, " missing: %s\n", *missing_list);
2120 missing_list++;
2125 #endif
2127 static XFontSet
2128 xic_create_xfontset (f)
2129 struct frame *f;
2131 XFontSet xfs = NULL;
2132 struct font *font = FRAME_FONT (f);
2133 int pixel_size = font->pixel_size;
2134 Lisp_Object rest, frame;
2136 /* See if there is another frame already using same fontset. */
2137 FOR_EACH_FRAME (rest, frame)
2139 struct frame *cf = XFRAME (frame);
2141 if (cf != f && FRAME_LIVE_P (f) && FRAME_X_P (cf)
2142 && FRAME_X_DISPLAY_INFO (cf) == FRAME_X_DISPLAY_INFO (f)
2143 && FRAME_FONT (f)
2144 && FRAME_FONT (f)->pixel_size == pixel_size)
2146 xfs = FRAME_XIC_FONTSET (cf);
2147 break;
2151 if (! xfs)
2153 char buf[256];
2154 char **missing_list;
2155 int missing_count;
2156 char *def_string;
2157 char *xlfd_format = "-*-*-medium-r-normal--%d-*-*-*-*-*";
2159 sprintf (buf, xlfd_format, pixel_size);
2160 missing_list = NULL;
2161 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), buf,
2162 &missing_list, &missing_count, &def_string);
2163 #ifdef DEBUG_XIC_FONTSET
2164 print_fontset_result (xfs, buf, missing_list, missing_count);
2165 #endif
2166 if (missing_list)
2167 XFreeStringList (missing_list);
2168 if (! xfs)
2170 /* List of pixel sizes most likely available. Find one that
2171 is closest to pixel_size. */
2172 int sizes[] = {0, 8, 10, 11, 12, 14, 17, 18, 20, 24, 26, 34, 0};
2173 int *smaller, *larger;
2175 for (smaller = sizes; smaller[1]; smaller++)
2176 if (smaller[1] >= pixel_size)
2177 break;
2178 larger = smaller + 1;
2179 if (*larger == pixel_size)
2180 larger++;
2181 while (*smaller || *larger)
2183 int this_size;
2185 if (! *larger)
2186 this_size = *smaller--;
2187 else if (! *smaller)
2188 this_size = *larger++;
2189 else if (pixel_size - *smaller < *larger - pixel_size)
2190 this_size = *smaller--;
2191 else
2192 this_size = *larger++;
2193 sprintf (buf, xlfd_format, this_size);
2194 missing_list = NULL;
2195 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), buf,
2196 &missing_list, &missing_count, &def_string);
2197 #ifdef DEBUG_XIC_FONTSET
2198 print_fontset_result (xfs, buf, missing_list, missing_count);
2199 #endif
2200 if (missing_list)
2201 XFreeStringList (missing_list);
2202 if (xfs)
2203 break;
2206 if (! xfs)
2208 char *last_resort = "-*-*-*-r-normal--*-*-*-*-*-*";
2210 missing_list = NULL;
2211 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), last_resort,
2212 &missing_list, &missing_count, &def_string);
2213 #ifdef DEBUG_XIC_FONTSET
2214 print_fontset_result (xfs, last_resort, missing_list, missing_count);
2215 #endif
2216 if (missing_list)
2217 XFreeStringList (missing_list);
2222 return xfs;
2225 /* Free the X fontset of frame F if it is the last frame using it. */
2227 void
2228 xic_free_xfontset (f)
2229 struct frame *f;
2231 Lisp_Object rest, frame;
2232 int shared_p = 0;
2234 if (!FRAME_XIC_FONTSET (f))
2235 return;
2237 /* See if there is another frame sharing the same fontset. */
2238 FOR_EACH_FRAME (rest, frame)
2240 struct frame *cf = XFRAME (frame);
2241 if (cf != f && FRAME_LIVE_P (f) && FRAME_X_P (cf)
2242 && FRAME_X_DISPLAY_INFO (cf) == FRAME_X_DISPLAY_INFO (f)
2243 && FRAME_XIC_FONTSET (cf) == FRAME_XIC_FONTSET (f))
2245 shared_p = 1;
2246 break;
2250 if (!shared_p)
2251 /* The fontset is not used anymore. It is safe to free it. */
2252 XFreeFontSet (FRAME_X_DISPLAY (f), FRAME_XIC_FONTSET (f));
2254 if (FRAME_XIC_BASE_FONTNAME (f))
2255 xfree (FRAME_XIC_BASE_FONTNAME (f));
2256 FRAME_XIC_BASE_FONTNAME (f) = NULL;
2257 FRAME_XIC_FONTSET (f) = NULL;
2261 /* Value is the best input style, given user preferences USER (already
2262 checked to be supported by Emacs), and styles supported by the
2263 input method XIM. */
2265 static XIMStyle
2266 best_xim_style (user, xim)
2267 XIMStyles *user;
2268 XIMStyles *xim;
2270 int i, j;
2272 for (i = 0; i < user->count_styles; ++i)
2273 for (j = 0; j < xim->count_styles; ++j)
2274 if (user->supported_styles[i] == xim->supported_styles[j])
2275 return user->supported_styles[i];
2277 /* Return the default style. */
2278 return XIMPreeditNothing | XIMStatusNothing;
2281 /* Create XIC for frame F. */
2283 static XIMStyle xic_style;
2285 void
2286 create_frame_xic (f)
2287 struct frame *f;
2289 XIM xim;
2290 XIC xic = NULL;
2291 XFontSet xfs = NULL;
2293 if (FRAME_XIC (f))
2294 return;
2296 /* Create X fontset. */
2297 xfs = xic_create_xfontset (f);
2298 xim = FRAME_X_XIM (f);
2299 if (xim)
2301 XRectangle s_area;
2302 XPoint spot;
2303 XVaNestedList preedit_attr;
2304 XVaNestedList status_attr;
2306 s_area.x = 0; s_area.y = 0; s_area.width = 1; s_area.height = 1;
2307 spot.x = 0; spot.y = 1;
2309 /* Determine XIC style. */
2310 if (xic_style == 0)
2312 XIMStyles supported_list;
2313 supported_list.count_styles = (sizeof supported_xim_styles
2314 / sizeof supported_xim_styles[0]);
2315 supported_list.supported_styles = supported_xim_styles;
2316 xic_style = best_xim_style (&supported_list,
2317 FRAME_X_XIM_STYLES (f));
2320 preedit_attr = XVaCreateNestedList (0,
2321 XNFontSet, xfs,
2322 XNForeground,
2323 FRAME_FOREGROUND_PIXEL (f),
2324 XNBackground,
2325 FRAME_BACKGROUND_PIXEL (f),
2326 (xic_style & XIMPreeditPosition
2327 ? XNSpotLocation
2328 : NULL),
2329 &spot,
2330 NULL);
2331 status_attr = XVaCreateNestedList (0,
2332 XNArea,
2333 &s_area,
2334 XNFontSet,
2335 xfs,
2336 XNForeground,
2337 FRAME_FOREGROUND_PIXEL (f),
2338 XNBackground,
2339 FRAME_BACKGROUND_PIXEL (f),
2340 NULL);
2342 xic = XCreateIC (xim,
2343 XNInputStyle, xic_style,
2344 XNClientWindow, FRAME_X_WINDOW (f),
2345 XNFocusWindow, FRAME_X_WINDOW (f),
2346 XNStatusAttributes, status_attr,
2347 XNPreeditAttributes, preedit_attr,
2348 NULL);
2349 XFree (preedit_attr);
2350 XFree (status_attr);
2353 FRAME_XIC (f) = xic;
2354 FRAME_XIC_STYLE (f) = xic_style;
2355 FRAME_XIC_FONTSET (f) = xfs;
2359 /* Destroy XIC and free XIC fontset of frame F, if any. */
2361 void
2362 free_frame_xic (f)
2363 struct frame *f;
2365 if (FRAME_XIC (f) == NULL)
2366 return;
2368 XDestroyIC (FRAME_XIC (f));
2369 xic_free_xfontset (f);
2371 FRAME_XIC (f) = NULL;
2375 /* Place preedit area for XIC of window W's frame to specified
2376 pixel position X/Y. X and Y are relative to window W. */
2378 void
2379 xic_set_preeditarea (w, x, y)
2380 struct window *w;
2381 int x, y;
2383 struct frame *f = XFRAME (w->frame);
2384 XVaNestedList attr;
2385 XPoint spot;
2387 spot.x = WINDOW_TO_FRAME_PIXEL_X (w, x) + WINDOW_LEFT_FRINGE_WIDTH (w);
2388 spot.y = WINDOW_TO_FRAME_PIXEL_Y (w, y) + FONT_BASE (FRAME_FONT (f));
2389 attr = XVaCreateNestedList (0, XNSpotLocation, &spot, NULL);
2390 XSetICValues (FRAME_XIC (f), XNPreeditAttributes, attr, NULL);
2391 XFree (attr);
2395 /* Place status area for XIC in bottom right corner of frame F.. */
2397 void
2398 xic_set_statusarea (f)
2399 struct frame *f;
2401 XIC xic = FRAME_XIC (f);
2402 XVaNestedList attr;
2403 XRectangle area;
2404 XRectangle *needed;
2406 /* Negotiate geometry of status area. If input method has existing
2407 status area, use its current size. */
2408 area.x = area.y = area.width = area.height = 0;
2409 attr = XVaCreateNestedList (0, XNAreaNeeded, &area, NULL);
2410 XSetICValues (xic, XNStatusAttributes, attr, NULL);
2411 XFree (attr);
2413 attr = XVaCreateNestedList (0, XNAreaNeeded, &needed, NULL);
2414 XGetICValues (xic, XNStatusAttributes, attr, NULL);
2415 XFree (attr);
2417 if (needed->width == 0) /* Use XNArea instead of XNAreaNeeded */
2419 attr = XVaCreateNestedList (0, XNArea, &needed, NULL);
2420 XGetICValues (xic, XNStatusAttributes, attr, NULL);
2421 XFree (attr);
2424 area.width = needed->width;
2425 area.height = needed->height;
2426 area.x = FRAME_PIXEL_WIDTH (f) - area.width - FRAME_INTERNAL_BORDER_WIDTH (f);
2427 area.y = (FRAME_PIXEL_HEIGHT (f) - area.height
2428 - FRAME_MENUBAR_HEIGHT (f)
2429 - FRAME_TOOLBAR_HEIGHT (f)
2430 - FRAME_INTERNAL_BORDER_WIDTH (f));
2431 XFree (needed);
2433 attr = XVaCreateNestedList (0, XNArea, &area, NULL);
2434 XSetICValues (xic, XNStatusAttributes, attr, NULL);
2435 XFree (attr);
2439 /* Set X fontset for XIC of frame F, using base font name
2440 BASE_FONTNAME. Called when a new Emacs fontset is chosen. */
2442 void
2443 xic_set_xfontset (f, base_fontname)
2444 struct frame *f;
2445 char *base_fontname;
2447 XVaNestedList attr;
2448 XFontSet xfs;
2450 xic_free_xfontset (f);
2452 xfs = xic_create_xfontset (f);
2454 attr = XVaCreateNestedList (0, XNFontSet, xfs, NULL);
2455 if (FRAME_XIC_STYLE (f) & XIMPreeditPosition)
2456 XSetICValues (FRAME_XIC (f), XNPreeditAttributes, attr, NULL);
2457 if (FRAME_XIC_STYLE (f) & XIMStatusArea)
2458 XSetICValues (FRAME_XIC (f), XNStatusAttributes, attr, NULL);
2459 XFree (attr);
2461 FRAME_XIC_FONTSET (f) = xfs;
2464 #endif /* HAVE_X_I18N */
2468 #ifdef USE_X_TOOLKIT
2470 /* Create and set up the X widget for frame F. */
2472 static void
2473 x_window (f, window_prompting, minibuffer_only)
2474 struct frame *f;
2475 long window_prompting;
2476 int minibuffer_only;
2478 XClassHint class_hints;
2479 XSetWindowAttributes attributes;
2480 unsigned long attribute_mask;
2481 Widget shell_widget;
2482 Widget pane_widget;
2483 Widget frame_widget;
2484 Arg al [25];
2485 int ac;
2487 BLOCK_INPUT;
2489 /* Use the resource name as the top-level widget name
2490 for looking up resources. Make a non-Lisp copy
2491 for the window manager, so GC relocation won't bother it.
2493 Elsewhere we specify the window name for the window manager. */
2496 char *str = (char *) SDATA (Vx_resource_name);
2497 f->namebuf = (char *) xmalloc (strlen (str) + 1);
2498 strcpy (f->namebuf, str);
2501 ac = 0;
2502 XtSetArg (al[ac], XtNallowShellResize, 1); ac++;
2503 XtSetArg (al[ac], XtNinput, 1); ac++;
2504 XtSetArg (al[ac], XtNmappedWhenManaged, 0); ac++;
2505 XtSetArg (al[ac], XtNborderWidth, f->border_width); ac++;
2506 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2507 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2508 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2509 shell_widget = XtAppCreateShell (f->namebuf, EMACS_CLASS,
2510 applicationShellWidgetClass,
2511 FRAME_X_DISPLAY (f), al, ac);
2513 f->output_data.x->widget = shell_widget;
2514 /* maybe_set_screen_title_format (shell_widget); */
2516 pane_widget = lw_create_widget ("main", "pane", widget_id_tick++,
2517 (widget_value *) NULL,
2518 shell_widget, False,
2519 (lw_callback) NULL,
2520 (lw_callback) NULL,
2521 (lw_callback) NULL,
2522 (lw_callback) NULL);
2524 ac = 0;
2525 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2526 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2527 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2528 XtSetValues (pane_widget, al, ac);
2529 f->output_data.x->column_widget = pane_widget;
2531 /* mappedWhenManaged to false tells to the paned window to not map/unmap
2532 the emacs screen when changing menubar. This reduces flickering. */
2534 ac = 0;
2535 XtSetArg (al[ac], XtNmappedWhenManaged, 0); ac++;
2536 XtSetArg (al[ac], XtNshowGrip, 0); ac++;
2537 XtSetArg (al[ac], XtNallowResize, 1); ac++;
2538 XtSetArg (al[ac], XtNresizeToPreferred, 1); ac++;
2539 XtSetArg (al[ac], XtNemacsFrame, f); ac++;
2540 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2541 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2542 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2543 frame_widget = XtCreateWidget (f->namebuf, emacsFrameClass, pane_widget,
2544 al, ac);
2546 f->output_data.x->edit_widget = frame_widget;
2548 XtManageChild (frame_widget);
2550 /* Do some needed geometry management. */
2552 int len;
2553 char *tem, shell_position[32];
2554 Arg al[10];
2555 int ac = 0;
2556 int extra_borders = 0;
2557 int menubar_size
2558 = (f->output_data.x->menubar_widget
2559 ? (f->output_data.x->menubar_widget->core.height
2560 + f->output_data.x->menubar_widget->core.border_width)
2561 : 0);
2563 #if 0 /* Experimentally, we now get the right results
2564 for -geometry -0-0 without this. 24 Aug 96, rms. */
2565 if (FRAME_EXTERNAL_MENU_BAR (f))
2567 Dimension ibw = 0;
2568 XtVaGetValues (pane_widget, XtNinternalBorderWidth, &ibw, NULL);
2569 menubar_size += ibw;
2571 #endif
2573 f->output_data.x->menubar_height = menubar_size;
2575 #ifndef USE_LUCID
2576 /* Motif seems to need this amount added to the sizes
2577 specified for the shell widget. The Athena/Lucid widgets don't.
2578 Both conclusions reached experimentally. -- rms. */
2579 XtVaGetValues (f->output_data.x->edit_widget, XtNinternalBorderWidth,
2580 &extra_borders, NULL);
2581 extra_borders *= 2;
2582 #endif
2584 /* Convert our geometry parameters into a geometry string
2585 and specify it.
2586 Note that we do not specify here whether the position
2587 is a user-specified or program-specified one.
2588 We pass that information later, in x_wm_set_size_hints. */
2590 int left = f->left_pos;
2591 int xneg = window_prompting & XNegative;
2592 int top = f->top_pos;
2593 int yneg = window_prompting & YNegative;
2594 if (xneg)
2595 left = -left;
2596 if (yneg)
2597 top = -top;
2599 if (window_prompting & USPosition)
2600 sprintf (shell_position, "=%dx%d%c%d%c%d",
2601 FRAME_PIXEL_WIDTH (f) + extra_borders,
2602 FRAME_PIXEL_HEIGHT (f) + menubar_size + extra_borders,
2603 (xneg ? '-' : '+'), left,
2604 (yneg ? '-' : '+'), top);
2605 else
2607 sprintf (shell_position, "=%dx%d",
2608 FRAME_PIXEL_WIDTH (f) + extra_borders,
2609 FRAME_PIXEL_HEIGHT (f) + menubar_size + extra_borders);
2611 /* Setting x and y when the position is not specified in
2612 the geometry string will set program position in the WM hints.
2613 If Emacs had just one program position, we could set it in
2614 fallback resources, but since each make-frame call can specify
2615 different program positions, this is easier. */
2616 XtSetArg (al[ac], XtNx, left); ac++;
2617 XtSetArg (al[ac], XtNy, top); ac++;
2621 len = strlen (shell_position) + 1;
2622 /* We don't free this because we don't know whether
2623 it is safe to free it while the frame exists.
2624 It isn't worth the trouble of arranging to free it
2625 when the frame is deleted. */
2626 tem = (char *) xmalloc (len);
2627 strncpy (tem, shell_position, len);
2628 XtSetArg (al[ac], XtNgeometry, tem); ac++;
2629 XtSetValues (shell_widget, al, ac);
2632 XtManageChild (pane_widget);
2633 XtRealizeWidget (shell_widget);
2635 if (FRAME_X_EMBEDDED_P (f))
2636 XReparentWindow (FRAME_X_DISPLAY (f), XtWindow (shell_widget),
2637 f->output_data.x->parent_desc, 0, 0);
2639 FRAME_X_WINDOW (f) = XtWindow (frame_widget);
2641 validate_x_resource_name ();
2643 class_hints.res_name = (char *) SDATA (Vx_resource_name);
2644 class_hints.res_class = (char *) SDATA (Vx_resource_class);
2645 XSetClassHint (FRAME_X_DISPLAY (f), XtWindow (shell_widget), &class_hints);
2647 #ifdef HAVE_X_I18N
2648 FRAME_XIC (f) = NULL;
2649 if (use_xim)
2650 create_frame_xic (f);
2651 #endif
2653 f->output_data.x->wm_hints.input = True;
2654 f->output_data.x->wm_hints.flags |= InputHint;
2655 XSetWMHints (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2656 &f->output_data.x->wm_hints);
2658 hack_wm_protocols (f, shell_widget);
2660 #ifdef HACK_EDITRES
2661 XtAddEventHandler (shell_widget, 0, True, _XEditResCheckMessages, 0);
2662 #endif
2664 /* Do a stupid property change to force the server to generate a
2665 PropertyNotify event so that the event_stream server timestamp will
2666 be initialized to something relevant to the time we created the window.
2668 XChangeProperty (XtDisplay (frame_widget), XtWindow (frame_widget),
2669 FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
2670 XA_ATOM, 32, PropModeAppend,
2671 (unsigned char*) NULL, 0);
2673 /* Make all the standard events reach the Emacs frame. */
2674 attributes.event_mask = STANDARD_EVENT_SET;
2676 #ifdef HAVE_X_I18N
2677 if (FRAME_XIC (f))
2679 /* XIM server might require some X events. */
2680 unsigned long fevent = NoEventMask;
2681 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2682 attributes.event_mask |= fevent;
2684 #endif /* HAVE_X_I18N */
2686 attribute_mask = CWEventMask;
2687 XChangeWindowAttributes (XtDisplay (shell_widget), XtWindow (shell_widget),
2688 attribute_mask, &attributes);
2690 XtMapWidget (frame_widget);
2692 /* x_set_name normally ignores requests to set the name if the
2693 requested name is the same as the current name. This is the one
2694 place where that assumption isn't correct; f->name is set, but
2695 the X server hasn't been told. */
2697 Lisp_Object name;
2698 int explicit = f->explicit_name;
2700 f->explicit_name = 0;
2701 name = f->name;
2702 f->name = Qnil;
2703 x_set_name (f, name, explicit);
2706 XDefineCursor (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2707 f->output.x->current_cursor = f->output_data.x->text_cursor);
2709 UNBLOCK_INPUT;
2711 /* This is a no-op, except under Motif. Make sure main areas are
2712 set to something reasonable, in case we get an error later. */
2713 lw_set_main_areas (pane_widget, 0, frame_widget);
2716 #else /* not USE_X_TOOLKIT */
2717 #ifdef USE_GTK
2718 void
2719 x_window (f)
2720 FRAME_PTR f;
2722 if (! xg_create_frame_widgets (f))
2723 error ("Unable to create window");
2725 #ifdef HAVE_X_I18N
2726 FRAME_XIC (f) = NULL;
2727 if (use_xim)
2729 BLOCK_INPUT;
2730 create_frame_xic (f);
2731 if (FRAME_XIC (f))
2733 /* XIM server might require some X events. */
2734 unsigned long fevent = NoEventMask;
2735 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2737 if (fevent != NoEventMask)
2739 XSetWindowAttributes attributes;
2740 XWindowAttributes wattr;
2741 unsigned long attribute_mask;
2743 XGetWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2744 &wattr);
2745 attributes.event_mask = wattr.your_event_mask | fevent;
2746 attribute_mask = CWEventMask;
2747 XChangeWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2748 attribute_mask, &attributes);
2751 UNBLOCK_INPUT;
2753 #endif
2756 #else /*! USE_GTK */
2757 /* Create and set up the X window for frame F. */
2759 void
2760 x_window (f)
2761 struct frame *f;
2764 XClassHint class_hints;
2765 XSetWindowAttributes attributes;
2766 unsigned long attribute_mask;
2768 attributes.background_pixel = FRAME_BACKGROUND_PIXEL (f);
2769 attributes.border_pixel = f->output_data.x->border_pixel;
2770 attributes.bit_gravity = StaticGravity;
2771 attributes.backing_store = NotUseful;
2772 attributes.save_under = True;
2773 attributes.event_mask = STANDARD_EVENT_SET;
2774 attributes.colormap = FRAME_X_COLORMAP (f);
2775 attribute_mask = (CWBackPixel | CWBorderPixel | CWBitGravity | CWEventMask
2776 | CWColormap);
2778 BLOCK_INPUT;
2779 FRAME_X_WINDOW (f)
2780 = XCreateWindow (FRAME_X_DISPLAY (f),
2781 f->output_data.x->parent_desc,
2782 f->left_pos,
2783 f->top_pos,
2784 FRAME_PIXEL_WIDTH (f), FRAME_PIXEL_HEIGHT (f),
2785 f->border_width,
2786 CopyFromParent, /* depth */
2787 InputOutput, /* class */
2788 FRAME_X_VISUAL (f),
2789 attribute_mask, &attributes);
2791 #ifdef HAVE_X_I18N
2792 if (use_xim)
2794 create_frame_xic (f);
2795 if (FRAME_XIC (f))
2797 /* XIM server might require some X events. */
2798 unsigned long fevent = NoEventMask;
2799 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2800 attributes.event_mask |= fevent;
2801 attribute_mask = CWEventMask;
2802 XChangeWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2803 attribute_mask, &attributes);
2806 #endif /* HAVE_X_I18N */
2808 validate_x_resource_name ();
2810 class_hints.res_name = (char *) SDATA (Vx_resource_name);
2811 class_hints.res_class = (char *) SDATA (Vx_resource_class);
2812 XSetClassHint (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), &class_hints);
2814 /* The menubar is part of the ordinary display;
2815 it does not count in addition to the height of the window. */
2816 f->output_data.x->menubar_height = 0;
2818 /* This indicates that we use the "Passive Input" input model.
2819 Unless we do this, we don't get the Focus{In,Out} events that we
2820 need to draw the cursor correctly. Accursed bureaucrats.
2821 XWhipsAndChains (FRAME_X_DISPLAY (f), IronMaiden, &TheRack); */
2823 f->output_data.x->wm_hints.input = True;
2824 f->output_data.x->wm_hints.flags |= InputHint;
2825 XSetWMHints (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2826 &f->output_data.x->wm_hints);
2827 f->output_data.x->wm_hints.icon_pixmap = None;
2829 /* Request "save yourself" and "delete window" commands from wm. */
2831 Atom protocols[2];
2832 protocols[0] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window;
2833 protocols[1] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself;
2834 XSetWMProtocols (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), protocols, 2);
2837 /* x_set_name normally ignores requests to set the name if the
2838 requested name is the same as the current name. This is the one
2839 place where that assumption isn't correct; f->name is set, but
2840 the X server hasn't been told. */
2842 Lisp_Object name;
2843 int explicit = f->explicit_name;
2845 f->explicit_name = 0;
2846 name = f->name;
2847 f->name = Qnil;
2848 x_set_name (f, name, explicit);
2851 XDefineCursor (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2852 f->output.x->current_cursor = f->output_data.x->text_cursor);
2854 UNBLOCK_INPUT;
2856 if (FRAME_X_WINDOW (f) == 0)
2857 error ("Unable to create window");
2860 #endif /* not USE_GTK */
2861 #endif /* not USE_X_TOOLKIT */
2863 /* Verify that the icon position args for this window are valid. */
2865 static void
2866 x_icon_verify (f, parms)
2867 struct frame *f;
2868 Lisp_Object parms;
2870 Lisp_Object icon_x, icon_y;
2872 /* Set the position of the icon. Note that twm groups all
2873 icons in an icon window. */
2874 icon_x = x_frame_get_and_record_arg (f, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
2875 icon_y = x_frame_get_and_record_arg (f, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
2876 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
2878 CHECK_NUMBER (icon_x);
2879 CHECK_NUMBER (icon_y);
2881 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
2882 error ("Both left and top icon corners of icon must be specified");
2885 /* Handle the icon stuff for this window. Perhaps later we might
2886 want an x_set_icon_position which can be called interactively as
2887 well. */
2889 static void
2890 x_icon (f, parms)
2891 struct frame *f;
2892 Lisp_Object parms;
2894 Lisp_Object icon_x, icon_y;
2895 #if 0
2896 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
2897 #endif
2899 /* Set the position of the icon. Note that twm groups all
2900 icons in an icon window. */
2901 icon_x = x_frame_get_and_record_arg (f, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
2902 icon_y = x_frame_get_and_record_arg (f, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
2903 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
2905 CHECK_NUMBER (icon_x);
2906 CHECK_NUMBER (icon_y);
2908 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
2909 error ("Both left and top icon corners of icon must be specified");
2911 BLOCK_INPUT;
2913 if (! EQ (icon_x, Qunbound))
2914 x_wm_set_icon_position (f, XINT (icon_x), XINT (icon_y));
2916 #if 0 /* x_get_arg removes the visibility parameter as a side effect,
2917 but x_create_frame still needs it. */
2918 /* Start up iconic or window? */
2919 x_wm_set_window_state
2920 (f, (EQ (x_get_arg (dpyinfo, parms, Qvisibility, 0, 0, RES_TYPE_SYMBOL),
2921 Qicon)
2922 ? IconicState
2923 : NormalState));
2924 #endif
2926 x_text_icon (f, (char *) SDATA ((!NILP (f->icon_name)
2927 ? f->icon_name
2928 : f->name)));
2930 UNBLOCK_INPUT;
2933 /* Make the GCs needed for this window, setting the
2934 background, border and mouse colors; also create the
2935 mouse cursor and the gray border tile. */
2937 static char cursor_bits[] =
2939 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
2940 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
2941 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
2942 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00
2945 static void
2946 x_make_gc (f)
2947 struct frame *f;
2949 XGCValues gc_values;
2951 BLOCK_INPUT;
2953 /* Create the GCs of this frame.
2954 Note that many default values are used. */
2956 gc_values.foreground = FRAME_FOREGROUND_PIXEL (f);
2957 gc_values.background = FRAME_BACKGROUND_PIXEL (f);
2958 gc_values.line_width = 0; /* Means 1 using fast algorithm. */
2959 f->output_data.x->normal_gc
2960 = XCreateGC (FRAME_X_DISPLAY (f),
2961 FRAME_X_WINDOW (f),
2962 GCLineWidth | GCForeground | GCBackground,
2963 &gc_values);
2965 /* Reverse video style. */
2966 gc_values.foreground = FRAME_BACKGROUND_PIXEL (f);
2967 gc_values.background = FRAME_FOREGROUND_PIXEL (f);
2968 f->output_data.x->reverse_gc
2969 = XCreateGC (FRAME_X_DISPLAY (f),
2970 FRAME_X_WINDOW (f),
2971 GCForeground | GCBackground | GCLineWidth,
2972 &gc_values);
2974 /* Cursor has cursor-color background, background-color foreground. */
2975 gc_values.foreground = FRAME_BACKGROUND_PIXEL (f);
2976 gc_values.background = f->output_data.x->cursor_pixel;
2977 gc_values.fill_style = FillOpaqueStippled;
2978 f->output_data.x->cursor_gc
2979 = XCreateGC (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2980 (GCForeground | GCBackground
2981 | GCFillStyle | GCLineWidth),
2982 &gc_values);
2984 /* Reliefs. */
2985 f->output_data.x->white_relief.gc = 0;
2986 f->output_data.x->black_relief.gc = 0;
2988 /* Create the gray border tile used when the pointer is not in
2989 the frame. Since this depends on the frame's pixel values,
2990 this must be done on a per-frame basis. */
2991 f->output_data.x->border_tile
2992 = (XCreatePixmapFromBitmapData
2993 (FRAME_X_DISPLAY (f), FRAME_X_DISPLAY_INFO (f)->root_window,
2994 gray_bits, gray_width, gray_height,
2995 FRAME_FOREGROUND_PIXEL (f),
2996 FRAME_BACKGROUND_PIXEL (f),
2997 DefaultDepth (FRAME_X_DISPLAY (f), FRAME_X_SCREEN_NUMBER (f))));
2999 UNBLOCK_INPUT;
3003 /* Free what was was allocated in x_make_gc. */
3005 void
3006 x_free_gcs (f)
3007 struct frame *f;
3009 Display *dpy = FRAME_X_DISPLAY (f);
3011 BLOCK_INPUT;
3013 if (f->output_data.x->normal_gc)
3015 XFreeGC (dpy, f->output_data.x->normal_gc);
3016 f->output_data.x->normal_gc = 0;
3019 if (f->output_data.x->reverse_gc)
3021 XFreeGC (dpy, f->output_data.x->reverse_gc);
3022 f->output_data.x->reverse_gc = 0;
3025 if (f->output_data.x->cursor_gc)
3027 XFreeGC (dpy, f->output_data.x->cursor_gc);
3028 f->output_data.x->cursor_gc = 0;
3031 if (f->output_data.x->border_tile)
3033 XFreePixmap (dpy, f->output_data.x->border_tile);
3034 f->output_data.x->border_tile = 0;
3037 UNBLOCK_INPUT;
3041 /* Handler for signals raised during x_create_frame and
3042 x_create_top_frame. FRAME is the frame which is partially
3043 constructed. */
3045 static Lisp_Object
3046 unwind_create_frame (frame)
3047 Lisp_Object frame;
3049 struct frame *f = XFRAME (frame);
3051 /* If frame is already dead, nothing to do. This can happen if the
3052 display is disconnected after the frame has become official, but
3053 before x_create_frame removes the unwind protect. */
3054 if (!FRAME_LIVE_P (f))
3055 return Qnil;
3057 /* If frame is ``official'', nothing to do. */
3058 if (!CONSP (Vframe_list) || !EQ (XCAR (Vframe_list), frame))
3060 #if GLYPH_DEBUG
3061 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
3062 #endif
3064 x_free_frame_resources (f);
3066 #if GLYPH_DEBUG
3067 /* Check that reference counts are indeed correct. */
3068 xassert (dpyinfo->reference_count == dpyinfo_refcount);
3069 xassert (dpyinfo->image_cache->refcount == image_cache_refcount);
3070 #endif
3071 return Qt;
3074 return Qnil;
3078 static void
3079 x_default_font_parameter (f, parms)
3080 struct frame *f;
3081 Lisp_Object parms;
3083 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
3084 Lisp_Object font_param = x_get_arg (dpyinfo, parms, Qfont, NULL, NULL,
3085 RES_TYPE_STRING);
3086 Lisp_Object font;
3087 if (EQ (font_param, Qunbound))
3088 font_param = Qnil;
3089 font = !NILP (font_param) ? font_param
3090 : x_get_arg (dpyinfo, parms, Qfont, "font", "Font", RES_TYPE_STRING);
3092 if (! STRINGP (font))
3094 char *names[]
3096 #ifdef HAVE_XFT
3097 /* This will find the normal Xft font. */
3098 "monospace-12",
3099 #endif
3100 "-adobe-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-1",
3101 "-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-1",
3102 "-*-*-medium-r-normal-*-*-140-*-*-c-*-iso8859-1",
3103 /* This was formerly the first thing tried, but it finds
3104 too many fonts and takes too long. */
3105 "-*-*-medium-r-*-*-*-*-*-*-c-*-iso8859-1",
3106 /* If those didn't work, look for something which will
3107 at least work. */
3108 "-*-fixed-*-*-*-*-*-140-*-*-c-*-iso8859-1",
3109 "fixed",
3110 NULL };
3111 int i;
3113 for (i = 0; names[i]; i++)
3115 font = font_open_by_name (f, names[i]);
3116 if (! NILP (font))
3117 break;
3119 if (NILP (font))
3120 error ("No suitable font was found");
3122 else if (!NILP (font_param))
3124 /* Remember the explicit font parameter, so we can re-apply it after
3125 we've applied the `default' face settings. */
3126 x_set_frame_parameters (f, Fcons (Fcons (Qfont_param, font_param), Qnil));
3128 x_default_parameter (f, parms, Qfont, font, "font", "Font", RES_TYPE_STRING);
3132 DEFUN ("x-wm-set-size-hint", Fx_wm_set_size_hint, Sx_wm_set_size_hint,
3133 0, 1, 0,
3134 doc: /* Send the size hints for frame FRAME to the window manager.
3135 If FRAME is nil, use the selected frame. */)
3136 (frame)
3137 Lisp_Object frame;
3139 struct frame *f;
3140 if (NILP (frame))
3141 frame = selected_frame;
3142 f = XFRAME (frame);
3143 BLOCK_INPUT;
3144 if (FRAME_X_P (f))
3145 x_wm_set_size_hint (f, 0, 0);
3146 UNBLOCK_INPUT;
3147 return Qnil;
3150 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
3151 1, 1, 0,
3152 doc: /* Make a new X window, which is called a "frame" in Emacs terms.
3153 Return an Emacs frame object.
3154 PARMS is an alist of frame parameters.
3155 If the parameters specify that the frame should not have a minibuffer,
3156 and do not specify a specific minibuffer window to use,
3157 then `default-minibuffer-frame' must be a frame whose minibuffer can
3158 be shared by the new frame.
3160 This function is an internal primitive--use `make-frame' instead. */)
3161 (parms)
3162 Lisp_Object parms;
3164 struct frame *f;
3165 Lisp_Object frame, tem;
3166 Lisp_Object name;
3167 int minibuffer_only = 0;
3168 long window_prompting = 0;
3169 int width, height;
3170 int count = SPECPDL_INDEX ();
3171 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
3172 Lisp_Object display;
3173 struct x_display_info *dpyinfo = NULL;
3174 Lisp_Object parent;
3175 struct kboard *kb;
3177 parms = Fcopy_alist (parms);
3179 /* Use this general default value to start with
3180 until we know if this frame has a specified name. */
3181 Vx_resource_name = Vinvocation_name;
3183 display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_NUMBER);
3184 if (EQ (display, Qunbound))
3185 display = x_get_arg (dpyinfo, parms, Qdisplay, 0, 0, RES_TYPE_STRING);
3186 if (EQ (display, Qunbound))
3187 display = Qnil;
3188 dpyinfo = check_x_display_info (display);
3189 kb = dpyinfo->terminal->kboard;
3191 if (!dpyinfo->terminal->name)
3192 error ("Terminal is not live, can't create new frames on it");
3194 name = x_get_arg (dpyinfo, parms, Qname, "name", "Name", RES_TYPE_STRING);
3195 if (!STRINGP (name)
3196 && ! EQ (name, Qunbound)
3197 && ! NILP (name))
3198 error ("Invalid frame name--not a string or nil");
3200 if (STRINGP (name))
3201 Vx_resource_name = name;
3203 /* See if parent window is specified. */
3204 parent = x_get_arg (dpyinfo, parms, Qparent_id, NULL, NULL, RES_TYPE_NUMBER);
3205 if (EQ (parent, Qunbound))
3206 parent = Qnil;
3207 if (! NILP (parent))
3208 CHECK_NUMBER (parent);
3210 /* make_frame_without_minibuffer can run Lisp code and garbage collect. */
3211 /* No need to protect DISPLAY because that's not used after passing
3212 it to make_frame_without_minibuffer. */
3213 frame = Qnil;
3214 GCPRO4 (parms, parent, name, frame);
3215 tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
3216 RES_TYPE_SYMBOL);
3217 if (EQ (tem, Qnone) || NILP (tem))
3218 f = make_frame_without_minibuffer (Qnil, kb, display);
3219 else if (EQ (tem, Qonly))
3221 f = make_minibuffer_frame ();
3222 minibuffer_only = 1;
3224 else if (WINDOWP (tem))
3225 f = make_frame_without_minibuffer (tem, kb, display);
3226 else
3227 f = make_frame (1);
3229 XSETFRAME (frame, f);
3231 /* Note that X Windows does support scroll bars. */
3232 FRAME_CAN_HAVE_SCROLL_BARS (f) = 1;
3234 f->terminal = dpyinfo->terminal;
3235 f->terminal->reference_count++;
3237 f->output_method = output_x_window;
3238 f->output_data.x = (struct x_output *) xmalloc (sizeof (struct x_output));
3239 bzero (f->output_data.x, sizeof (struct x_output));
3240 f->output_data.x->icon_bitmap = -1;
3241 FRAME_FONTSET (f) = -1;
3242 f->output_data.x->scroll_bar_foreground_pixel = -1;
3243 f->output_data.x->scroll_bar_background_pixel = -1;
3244 #ifdef USE_TOOLKIT_SCROLL_BARS
3245 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
3246 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
3247 #endif /* USE_TOOLKIT_SCROLL_BARS */
3249 f->icon_name
3250 = x_get_arg (dpyinfo, parms, Qicon_name, "iconName", "Title",
3251 RES_TYPE_STRING);
3252 if (! STRINGP (f->icon_name))
3253 f->icon_name = Qnil;
3255 FRAME_X_DISPLAY_INFO (f) = dpyinfo;
3257 /* With FRAME_X_DISPLAY_INFO set up, this unwind-protect is safe. */
3258 record_unwind_protect (unwind_create_frame, frame);
3259 #if GLYPH_DEBUG
3260 image_cache_refcount = FRAME_IMAGE_CACHE (f)->refcount;
3261 dpyinfo_refcount = dpyinfo->reference_count;
3262 #endif /* GLYPH_DEBUG */
3264 /* These colors will be set anyway later, but it's important
3265 to get the color reference counts right, so initialize them! */
3267 Lisp_Object black;
3268 struct gcpro gcpro1;
3270 /* Function x_decode_color can signal an error. Make
3271 sure to initialize color slots so that we won't try
3272 to free colors we haven't allocated. */
3273 FRAME_FOREGROUND_PIXEL (f) = -1;
3274 FRAME_BACKGROUND_PIXEL (f) = -1;
3275 f->output_data.x->cursor_pixel = -1;
3276 f->output_data.x->cursor_foreground_pixel = -1;
3277 f->output_data.x->border_pixel = -1;
3278 f->output_data.x->mouse_pixel = -1;
3280 black = build_string ("black");
3281 GCPRO1 (black);
3282 FRAME_FOREGROUND_PIXEL (f)
3283 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3284 FRAME_BACKGROUND_PIXEL (f)
3285 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3286 f->output_data.x->cursor_pixel
3287 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3288 f->output_data.x->cursor_foreground_pixel
3289 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3290 f->output_data.x->border_pixel
3291 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3292 f->output_data.x->mouse_pixel
3293 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3294 UNGCPRO;
3297 /* Specify the parent under which to make this X window. */
3299 if (!NILP (parent))
3301 f->output_data.x->parent_desc = (Window) XFASTINT (parent);
3302 f->output_data.x->explicit_parent = 1;
3304 else
3306 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
3307 f->output_data.x->explicit_parent = 0;
3310 /* Set the name; the functions to which we pass f expect the name to
3311 be set. */
3312 if (EQ (name, Qunbound) || NILP (name))
3314 f->name = build_string (dpyinfo->x_id_name);
3315 f->explicit_name = 0;
3317 else
3319 f->name = name;
3320 f->explicit_name = 1;
3321 /* use the frame's title when getting resources for this frame. */
3322 specbind (Qx_resource_name, name);
3325 f->resx = dpyinfo->resx;
3326 f->resy = dpyinfo->resy;
3328 #ifdef HAVE_FREETYPE
3329 #ifdef HAVE_XFT
3330 register_font_driver (&xftfont_driver, f);
3331 #else /* not HAVE_XFT */
3332 register_font_driver (&ftxfont_driver, f);
3333 #endif /* not HAVE_XFT */
3334 #endif /* HAVE_FREETYPE */
3335 register_font_driver (&xfont_driver, f);
3337 x_default_parameter (f, parms, Qfont_backend, Qnil,
3338 "fontBackend", "FontBackend", RES_TYPE_STRING);
3340 /* Extract the window parameters from the supplied values
3341 that are needed to determine window geometry. */
3342 x_default_font_parameter (f, parms);
3343 if (!FRAME_FONT (f))
3345 delete_frame (frame, Qnoelisp);
3346 error ("Invalid frame font");
3349 #ifdef USE_LUCID
3350 /* Prevent lwlib/xlwmenu.c from crashing because of a bug
3351 whereby it fails to get any font. */
3352 xlwmenu_default_font = XLoadQueryFont (FRAME_X_DISPLAY (f), "fixed");
3353 #endif
3355 /* Frame contents get displaced if an embedded X window has a border. */
3356 if (! FRAME_X_EMBEDDED_P (f))
3357 x_default_parameter (f, parms, Qborder_width, make_number (2),
3358 "borderWidth", "BorderWidth", RES_TYPE_NUMBER);
3360 /* This defaults to 1 in order to match xterm. We recognize either
3361 internalBorderWidth or internalBorder (which is what xterm calls
3362 it). */
3363 if (NILP (Fassq (Qinternal_border_width, parms)))
3365 Lisp_Object value;
3367 value = x_get_arg (dpyinfo, parms, Qinternal_border_width,
3368 "internalBorder", "internalBorder", RES_TYPE_NUMBER);
3369 if (! EQ (value, Qunbound))
3370 parms = Fcons (Fcons (Qinternal_border_width, value),
3371 parms);
3373 x_default_parameter (f, parms, Qinternal_border_width,
3374 #ifdef USE_GTK /* We used to impose 0 in xg_create_frame_widgets. */
3375 make_number (0),
3376 #else
3377 make_number (1),
3378 #endif
3379 "internalBorderWidth", "internalBorderWidth",
3380 RES_TYPE_NUMBER);
3381 x_default_parameter (f, parms, Qvertical_scroll_bars, Qleft,
3382 "verticalScrollBars", "ScrollBars",
3383 RES_TYPE_SYMBOL);
3385 /* Also do the stuff which must be set before the window exists. */
3386 x_default_parameter (f, parms, Qforeground_color, build_string ("black"),
3387 "foreground", "Foreground", RES_TYPE_STRING);
3388 x_default_parameter (f, parms, Qbackground_color, build_string ("white"),
3389 "background", "Background", RES_TYPE_STRING);
3390 x_default_parameter (f, parms, Qmouse_color, build_string ("black"),
3391 "pointerColor", "Foreground", RES_TYPE_STRING);
3392 x_default_parameter (f, parms, Qcursor_color, build_string ("black"),
3393 "cursorColor", "Foreground", RES_TYPE_STRING);
3394 x_default_parameter (f, parms, Qborder_color, build_string ("black"),
3395 "borderColor", "BorderColor", RES_TYPE_STRING);
3396 x_default_parameter (f, parms, Qscreen_gamma, Qnil,
3397 "screenGamma", "ScreenGamma", RES_TYPE_FLOAT);
3398 x_default_parameter (f, parms, Qline_spacing, Qnil,
3399 "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
3400 x_default_parameter (f, parms, Qleft_fringe, Qnil,
3401 "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
3402 x_default_parameter (f, parms, Qright_fringe, Qnil,
3403 "rightFringe", "RightFringe", RES_TYPE_NUMBER);
3405 x_default_scroll_bar_color_parameter (f, parms, Qscroll_bar_foreground,
3406 "scrollBarForeground",
3407 "ScrollBarForeground", 1);
3408 x_default_scroll_bar_color_parameter (f, parms, Qscroll_bar_background,
3409 "scrollBarBackground",
3410 "ScrollBarBackground", 0);
3412 /* Init faces before x_default_parameter is called for scroll-bar
3413 parameters because that function calls x_set_scroll_bar_width,
3414 which calls change_frame_size, which calls Fset_window_buffer,
3415 which runs hooks, which call Fvertical_motion. At the end, we
3416 end up in init_iterator with a null face cache, which should not
3417 happen. */
3418 init_frame_faces (f);
3420 x_default_parameter (f, parms, Qmenu_bar_lines, make_number (1),
3421 "menuBar", "MenuBar", RES_TYPE_NUMBER);
3422 x_default_parameter (f, parms, Qtool_bar_lines, make_number (1),
3423 "toolBar", "ToolBar", RES_TYPE_NUMBER);
3424 x_default_parameter (f, parms, Qbuffer_predicate, Qnil,
3425 "bufferPredicate", "BufferPredicate",
3426 RES_TYPE_SYMBOL);
3427 x_default_parameter (f, parms, Qtitle, Qnil,
3428 "title", "Title", RES_TYPE_STRING);
3429 x_default_parameter (f, parms, Qwait_for_wm, Qt,
3430 "waitForWM", "WaitForWM", RES_TYPE_BOOLEAN);
3431 x_default_parameter (f, parms, Qfullscreen, Qnil,
3432 "fullscreen", "Fullscreen", RES_TYPE_SYMBOL);
3434 /* Compute the size of the X window. */
3435 window_prompting = x_figure_window_size (f, parms, 1);
3437 tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
3438 f->no_split = minibuffer_only || EQ (tem, Qt);
3440 x_icon_verify (f, parms);
3442 /* Create the X widget or window. */
3443 #ifdef USE_X_TOOLKIT
3444 x_window (f, window_prompting, minibuffer_only);
3445 #else
3446 x_window (f);
3447 #endif
3449 x_icon (f, parms);
3450 x_make_gc (f);
3452 /* Now consider the frame official. */
3453 FRAME_X_DISPLAY_INFO (f)->reference_count++;
3454 Vframe_list = Fcons (frame, Vframe_list);
3456 /* We need to do this after creating the X window, so that the
3457 icon-creation functions can say whose icon they're describing. */
3458 x_default_parameter (f, parms, Qicon_type, Qt,
3459 "bitmapIcon", "BitmapIcon", RES_TYPE_SYMBOL);
3461 x_default_parameter (f, parms, Qauto_raise, Qnil,
3462 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
3463 x_default_parameter (f, parms, Qauto_lower, Qnil,
3464 "autoLower", "AutoRaiseLower", RES_TYPE_BOOLEAN);
3465 x_default_parameter (f, parms, Qcursor_type, Qbox,
3466 "cursorType", "CursorType", RES_TYPE_SYMBOL);
3467 x_default_parameter (f, parms, Qscroll_bar_width, Qnil,
3468 "scrollBarWidth", "ScrollBarWidth",
3469 RES_TYPE_NUMBER);
3470 x_default_parameter (f, parms, Qalpha, Qnil,
3471 "alpha", "Alpha", RES_TYPE_NUMBER);
3473 /* Dimensions, especially FRAME_LINES (f), must be done via change_frame_size.
3474 Change will not be effected unless different from the current
3475 FRAME_LINES (f). */
3476 width = FRAME_COLS (f);
3477 height = FRAME_LINES (f);
3479 SET_FRAME_COLS (f, 0);
3480 FRAME_LINES (f) = 0;
3481 change_frame_size (f, height, width, 1, 0, 0);
3483 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
3484 /* Create the menu bar. */
3485 if (!minibuffer_only && FRAME_EXTERNAL_MENU_BAR (f))
3487 /* If this signals an error, we haven't set size hints for the
3488 frame and we didn't make it visible. */
3489 initialize_frame_menubar (f);
3491 #ifndef USE_GTK
3492 /* This is a no-op, except under Motif where it arranges the
3493 main window for the widgets on it. */
3494 lw_set_main_areas (f->output_data.x->column_widget,
3495 f->output_data.x->menubar_widget,
3496 f->output_data.x->edit_widget);
3497 #endif /* not USE_GTK */
3499 #endif /* USE_X_TOOLKIT || USE_GTK */
3501 /* Tell the server what size and position, etc, we want, and how
3502 badly we want them. This should be done after we have the menu
3503 bar so that its size can be taken into account. */
3504 BLOCK_INPUT;
3505 x_wm_set_size_hint (f, window_prompting, 0);
3506 UNBLOCK_INPUT;
3508 /* Make the window appear on the frame and enable display, unless
3509 the caller says not to. However, with explicit parent, Emacs
3510 cannot control visibility, so don't try. */
3511 if (! f->output_data.x->explicit_parent)
3513 Lisp_Object visibility;
3515 visibility = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0,
3516 RES_TYPE_SYMBOL);
3517 if (EQ (visibility, Qunbound))
3518 visibility = Qt;
3520 if (EQ (visibility, Qicon))
3521 x_iconify_frame (f);
3522 else if (! NILP (visibility))
3523 x_make_frame_visible (f);
3524 else
3525 /* Must have been Qnil. */
3529 /* Set the WM leader property. GTK does this itself, so this is not
3530 needed when using GTK. */
3531 if (dpyinfo->client_leader_window != 0)
3533 BLOCK_INPUT;
3534 XChangeProperty (FRAME_X_DISPLAY (f),
3535 FRAME_OUTER_WINDOW (f),
3536 dpyinfo->Xatom_wm_client_leader,
3537 XA_WINDOW, 32, PropModeReplace,
3538 (unsigned char *) &dpyinfo->client_leader_window, 1);
3539 UNBLOCK_INPUT;
3542 /* Initialize `default-minibuffer-frame' in case this is the first
3543 frame on this terminal. */
3544 if (FRAME_HAS_MINIBUF_P (f)
3545 && (!FRAMEP (kb->Vdefault_minibuffer_frame)
3546 || !FRAME_LIVE_P (XFRAME (kb->Vdefault_minibuffer_frame))))
3547 kb->Vdefault_minibuffer_frame = frame;
3549 /* All remaining specified parameters, which have not been "used"
3550 by x_get_arg and friends, now go in the misc. alist of the frame. */
3551 for (tem = parms; CONSP (tem); tem = XCDR (tem))
3552 if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
3553 f->param_alist = Fcons (XCAR (tem), f->param_alist);
3555 UNGCPRO;
3557 /* Make sure windows on this frame appear in calls to next-window
3558 and similar functions. */
3559 Vwindow_list = Qnil;
3561 return unbind_to (count, frame);
3565 /* FRAME is used only to get a handle on the X display. We don't pass the
3566 display info directly because we're called from frame.c, which doesn't
3567 know about that structure. */
3569 Lisp_Object
3570 x_get_focus_frame (frame)
3571 struct frame *frame;
3573 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (frame);
3574 Lisp_Object xfocus;
3575 if (! dpyinfo->x_focus_frame)
3576 return Qnil;
3578 XSETFRAME (xfocus, dpyinfo->x_focus_frame);
3579 return xfocus;
3583 /* In certain situations, when the window manager follows a
3584 click-to-focus policy, there seems to be no way around calling
3585 XSetInputFocus to give another frame the input focus .
3587 In an ideal world, XSetInputFocus should generally be avoided so
3588 that applications don't interfere with the window manager's focus
3589 policy. But I think it's okay to use when it's clearly done
3590 following a user-command. */
3592 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
3593 doc: /* Set the input focus to FRAME.
3594 FRAME nil means use the selected frame. */)
3595 (frame)
3596 Lisp_Object frame;
3598 struct frame *f = check_x_frame (frame);
3599 Display *dpy = FRAME_X_DISPLAY (f);
3601 BLOCK_INPUT;
3602 x_catch_errors (dpy);
3603 XSetInputFocus (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
3604 RevertToParent, CurrentTime);
3605 x_ewmh_activate_frame (f);
3606 x_uncatch_errors ();
3607 UNBLOCK_INPUT;
3609 return Qnil;
3613 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
3614 doc: /* Internal function called by `color-defined-p', which see. */)
3615 (color, frame)
3616 Lisp_Object color, frame;
3618 XColor foo;
3619 FRAME_PTR f = check_x_frame (frame);
3621 CHECK_STRING (color);
3623 if (x_defined_color (f, SDATA (color), &foo, 0))
3624 return Qt;
3625 else
3626 return Qnil;
3629 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
3630 doc: /* Internal function called by `color-values', which see. */)
3631 (color, frame)
3632 Lisp_Object color, frame;
3634 XColor foo;
3635 FRAME_PTR f = check_x_frame (frame);
3637 CHECK_STRING (color);
3639 if (x_defined_color (f, SDATA (color), &foo, 0))
3640 return list3 (make_number (foo.red),
3641 make_number (foo.green),
3642 make_number (foo.blue));
3643 else
3644 return Qnil;
3647 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
3648 doc: /* Internal function called by `display-color-p', which see. */)
3649 (terminal)
3650 Lisp_Object terminal;
3652 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3654 if (dpyinfo->n_planes <= 2)
3655 return Qnil;
3657 switch (dpyinfo->visual->class)
3659 case StaticColor:
3660 case PseudoColor:
3661 case TrueColor:
3662 case DirectColor:
3663 return Qt;
3665 default:
3666 return Qnil;
3670 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p, Sx_display_grayscale_p,
3671 0, 1, 0,
3672 doc: /* Return t if the X display supports shades of gray.
3673 Note that color displays do support shades of gray.
3674 The optional argument TERMINAL specifies which display to ask about.
3675 TERMINAL should be a terminal object, a frame or a display name (a string).
3676 If omitted or nil, that stands for the selected frame's display. */)
3677 (terminal)
3678 Lisp_Object terminal;
3680 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3682 if (dpyinfo->n_planes <= 1)
3683 return Qnil;
3685 switch (dpyinfo->visual->class)
3687 case StaticColor:
3688 case PseudoColor:
3689 case TrueColor:
3690 case DirectColor:
3691 case StaticGray:
3692 case GrayScale:
3693 return Qt;
3695 default:
3696 return Qnil;
3700 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
3701 0, 1, 0,
3702 doc: /* Return the width in pixels of the X display TERMINAL.
3703 The optional argument TERMINAL specifies which display to ask about.
3704 TERMINAL should be a terminal object, a frame or a display name (a string).
3705 If omitted or nil, that stands for the selected frame's display. */)
3706 (terminal)
3707 Lisp_Object terminal;
3709 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3711 return make_number (x_display_pixel_width (dpyinfo));
3714 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
3715 Sx_display_pixel_height, 0, 1, 0,
3716 doc: /* Return the height in pixels of the X display TERMINAL.
3717 The optional argument TERMINAL specifies which display to ask about.
3718 TERMINAL should be a terminal object, a frame or a display name (a string).
3719 If omitted or nil, that stands for the selected frame's display. */)
3720 (terminal)
3721 Lisp_Object terminal;
3723 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3725 return make_number (x_display_pixel_height (dpyinfo));
3728 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
3729 0, 1, 0,
3730 doc: /* Return the number of bitplanes of the X display TERMINAL.
3731 The optional argument TERMINAL specifies which display to ask about.
3732 TERMINAL should be a terminal object, a frame or a display name (a string).
3733 If omitted or nil, that stands for the selected frame's display. */)
3734 (terminal)
3735 Lisp_Object terminal;
3737 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3739 return make_number (dpyinfo->n_planes);
3742 DEFUN ("x-display-color-cells", Fx_display_color_cells, Sx_display_color_cells,
3743 0, 1, 0,
3744 doc: /* Return the number of color cells of the X display TERMINAL.
3745 The optional argument TERMINAL specifies which display to ask about.
3746 TERMINAL should be a terminal object, a frame or a display name (a string).
3747 If omitted or nil, that stands for the selected frame's display. */)
3748 (terminal)
3749 Lisp_Object terminal;
3751 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3753 int nr_planes = DisplayPlanes (dpyinfo->display,
3754 XScreenNumberOfScreen (dpyinfo->screen));
3756 /* Truncate nr_planes to 24 to avoid integer overflow.
3757 Some displays says 32, but only 24 bits are actually significant.
3758 There are only very few and rare video cards that have more than
3759 24 significant bits. Also 24 bits is more than 16 million colors,
3760 it "should be enough for everyone". */
3761 if (nr_planes > 24) nr_planes = 24;
3763 return make_number (1 << nr_planes);
3766 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
3767 Sx_server_max_request_size,
3768 0, 1, 0,
3769 doc: /* Return the maximum request size of the X server of display TERMINAL.
3770 The optional argument TERMINAL specifies which display to ask about.
3771 TERMINAL should be a terminal object, a frame or a display name (a string).
3772 If omitted or nil, that stands for the selected frame's display. */)
3773 (terminal)
3774 Lisp_Object terminal;
3776 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3778 return make_number (MAXREQUEST (dpyinfo->display));
3781 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
3782 doc: /* Return the "vendor ID" string of the X server of display TERMINAL.
3783 \(Labelling every distributor as a "vendor" embodies the false assumption
3784 that operating systems cannot be developed and distributed noncommercially.)
3785 The optional argument TERMINAL specifies which display to ask about.
3786 TERMINAL should be a terminal object, a frame or a display name (a string).
3787 If omitted or nil, that stands for the selected frame's display. */)
3788 (terminal)
3789 Lisp_Object terminal;
3791 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3792 char *vendor = ServerVendor (dpyinfo->display);
3794 if (! vendor) vendor = "";
3795 return build_string (vendor);
3798 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
3799 doc: /* Return the version numbers of the X server of display TERMINAL.
3800 The value is a list of three integers: the major and minor
3801 version numbers of the X Protocol in use, and the distributor-specific release
3802 number. See also the function `x-server-vendor'.
3804 The optional argument TERMINAL specifies which display to ask about.
3805 TERMINAL should be a terminal object, a frame or a display name (a string).
3806 If omitted or nil, that stands for the selected frame's display. */)
3807 (terminal)
3808 Lisp_Object terminal;
3810 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3811 Display *dpy = dpyinfo->display;
3813 return Fcons (make_number (ProtocolVersion (dpy)),
3814 Fcons (make_number (ProtocolRevision (dpy)),
3815 Fcons (make_number (VendorRelease (dpy)), Qnil)));
3818 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
3819 doc: /* Return the number of screens on the X server of display TERMINAL.
3820 The optional argument TERMINAL specifies which display to ask about.
3821 TERMINAL should be a terminal object, a frame or a display name (a string).
3822 If omitted or nil, that stands for the selected frame's display. */)
3823 (terminal)
3824 Lisp_Object terminal;
3826 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3828 return make_number (ScreenCount (dpyinfo->display));
3831 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height, 0, 1, 0,
3832 doc: /* Return the height in millimeters of the X display TERMINAL.
3833 The optional argument TERMINAL specifies which display to ask about.
3834 TERMINAL should be a terminal object, a frame or a display name (a string).
3835 If omitted or nil, that stands for the selected frame's display. */)
3836 (terminal)
3837 Lisp_Object terminal;
3839 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3841 return make_number (HeightMMOfScreen (dpyinfo->screen));
3844 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width, 0, 1, 0,
3845 doc: /* Return the width in millimeters of the X display TERMINAL.
3846 The optional argument TERMINAL specifies which display to ask about.
3847 TERMINAL should be a terminal object, a frame or a display name (a string).
3848 If omitted or nil, that stands for the selected frame's display. */)
3849 (terminal)
3850 Lisp_Object terminal;
3852 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3854 return make_number (WidthMMOfScreen (dpyinfo->screen));
3857 DEFUN ("x-display-backing-store", Fx_display_backing_store,
3858 Sx_display_backing_store, 0, 1, 0,
3859 doc: /* Return an indication of whether X display TERMINAL does backing store.
3860 The value may be `always', `when-mapped', or `not-useful'.
3861 The optional argument TERMINAL specifies which display to ask about.
3862 TERMINAL should be a terminal object, a frame or a display name (a string).
3863 If omitted or nil, that stands for the selected frame's display. */)
3864 (terminal)
3865 Lisp_Object terminal;
3867 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3868 Lisp_Object result;
3870 switch (DoesBackingStore (dpyinfo->screen))
3872 case Always:
3873 result = intern ("always");
3874 break;
3876 case WhenMapped:
3877 result = intern ("when-mapped");
3878 break;
3880 case NotUseful:
3881 result = intern ("not-useful");
3882 break;
3884 default:
3885 error ("Strange value for BackingStore parameter of screen");
3886 result = Qnil;
3889 return result;
3892 DEFUN ("x-display-visual-class", Fx_display_visual_class,
3893 Sx_display_visual_class, 0, 1, 0,
3894 doc: /* Return the visual class of the X display TERMINAL.
3895 The value is one of the symbols `static-gray', `gray-scale',
3896 `static-color', `pseudo-color', `true-color', or `direct-color'.
3898 The optional argument TERMINAL specifies which display to ask about.
3899 TERMINAL should a terminal object, a frame or a display name (a string).
3900 If omitted or nil, that stands for the selected frame's display. */)
3901 (terminal)
3902 Lisp_Object terminal;
3904 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3905 Lisp_Object result;
3907 switch (dpyinfo->visual->class)
3909 case StaticGray:
3910 result = intern ("static-gray");
3911 break;
3912 case GrayScale:
3913 result = intern ("gray-scale");
3914 break;
3915 case StaticColor:
3916 result = intern ("static-color");
3917 break;
3918 case PseudoColor:
3919 result = intern ("pseudo-color");
3920 break;
3921 case TrueColor:
3922 result = intern ("true-color");
3923 break;
3924 case DirectColor:
3925 result = intern ("direct-color");
3926 break;
3927 default:
3928 error ("Display has an unknown visual class");
3929 result = Qnil;
3932 return result;
3935 DEFUN ("x-display-save-under", Fx_display_save_under,
3936 Sx_display_save_under, 0, 1, 0,
3937 doc: /* Return t if the X display TERMINAL supports the save-under feature.
3938 The optional argument TERMINAL specifies which display to ask about.
3939 TERMINAL should be a terminal object, a frame or a display name (a string).
3940 If omitted or nil, that stands for the selected frame's display. */)
3941 (terminal)
3942 Lisp_Object terminal;
3944 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3946 if (DoesSaveUnders (dpyinfo->screen) == True)
3947 return Qt;
3948 else
3949 return Qnil;
3953 x_pixel_width (f)
3954 register struct frame *f;
3956 return FRAME_PIXEL_WIDTH (f);
3960 x_pixel_height (f)
3961 register struct frame *f;
3963 return FRAME_PIXEL_HEIGHT (f);
3967 x_char_width (f)
3968 register struct frame *f;
3970 return FRAME_COLUMN_WIDTH (f);
3974 x_char_height (f)
3975 register struct frame *f;
3977 return FRAME_LINE_HEIGHT (f);
3981 x_screen_planes (f)
3982 register struct frame *f;
3984 return FRAME_X_DISPLAY_INFO (f)->n_planes;
3989 /************************************************************************
3990 X Displays
3991 ************************************************************************/
3994 /* Mapping visual names to visuals. */
3996 static struct visual_class
3998 char *name;
3999 int class;
4001 visual_classes[] =
4003 {"StaticGray", StaticGray},
4004 {"GrayScale", GrayScale},
4005 {"StaticColor", StaticColor},
4006 {"PseudoColor", PseudoColor},
4007 {"TrueColor", TrueColor},
4008 {"DirectColor", DirectColor},
4009 {NULL, 0}
4013 #ifndef HAVE_XSCREENNUMBEROFSCREEN
4015 /* Value is the screen number of screen SCR. This is a substitute for
4016 the X function with the same name when that doesn't exist. */
4019 XScreenNumberOfScreen (scr)
4020 register Screen *scr;
4022 Display *dpy = scr->display;
4023 int i;
4025 for (i = 0; i < dpy->nscreens; ++i)
4026 if (scr == dpy->screens + i)
4027 break;
4029 return i;
4032 #endif /* not HAVE_XSCREENNUMBEROFSCREEN */
4035 /* Select the visual that should be used on display DPYINFO. Set
4036 members of DPYINFO appropriately. Called from x_term_init. */
4038 void
4039 select_visual (dpyinfo)
4040 struct x_display_info *dpyinfo;
4042 Display *dpy = dpyinfo->display;
4043 Screen *screen = dpyinfo->screen;
4044 Lisp_Object value;
4046 /* See if a visual is specified. */
4047 value = display_x_get_resource (dpyinfo,
4048 build_string ("visualClass"),
4049 build_string ("VisualClass"),
4050 Qnil, Qnil);
4051 if (STRINGP (value))
4053 /* VALUE should be of the form CLASS-DEPTH, where CLASS is one
4054 of `PseudoColor', `TrueColor' etc. and DEPTH is the color
4055 depth, a decimal number. NAME is compared with case ignored. */
4056 char *s = (char *) alloca (SBYTES (value) + 1);
4057 char *dash;
4058 int i, class = -1;
4059 XVisualInfo vinfo;
4061 strcpy (s, SDATA (value));
4062 dash = index (s, '-');
4063 if (dash)
4065 dpyinfo->n_planes = atoi (dash + 1);
4066 *dash = '\0';
4068 else
4069 /* We won't find a matching visual with depth 0, so that
4070 an error will be printed below. */
4071 dpyinfo->n_planes = 0;
4073 /* Determine the visual class. */
4074 for (i = 0; visual_classes[i].name; ++i)
4075 if (xstrcasecmp (s, visual_classes[i].name) == 0)
4077 class = visual_classes[i].class;
4078 break;
4081 /* Look up a matching visual for the specified class. */
4082 if (class == -1
4083 || !XMatchVisualInfo (dpy, XScreenNumberOfScreen (screen),
4084 dpyinfo->n_planes, class, &vinfo))
4085 fatal ("Invalid visual specification `%s'", SDATA (value));
4087 dpyinfo->visual = vinfo.visual;
4089 else
4091 int n_visuals;
4092 XVisualInfo *vinfo, vinfo_template;
4094 dpyinfo->visual = DefaultVisualOfScreen (screen);
4096 vinfo_template.visualid = XVisualIDFromVisual (dpyinfo->visual);
4097 vinfo_template.screen = XScreenNumberOfScreen (screen);
4098 vinfo = XGetVisualInfo (dpy, VisualIDMask | VisualScreenMask,
4099 &vinfo_template, &n_visuals);
4100 if (n_visuals != 1)
4101 fatal ("Can't get proper X visual info");
4103 dpyinfo->n_planes = vinfo->depth;
4104 XFree ((char *) vinfo);
4109 /* Return the X display structure for the display named NAME.
4110 Open a new connection if necessary. */
4112 struct x_display_info *
4113 x_display_info_for_name (name)
4114 Lisp_Object name;
4116 Lisp_Object names;
4117 struct x_display_info *dpyinfo;
4119 CHECK_STRING (name);
4121 #if 0
4122 if (! EQ (Vinitial_window_system, intern ("x")))
4123 error ("Not using X Windows"); /* That doesn't stop us anymore. */
4124 #endif
4126 for (dpyinfo = x_display_list, names = x_display_name_list;
4127 dpyinfo;
4128 dpyinfo = dpyinfo->next, names = XCDR (names))
4130 Lisp_Object tem;
4131 tem = Fstring_equal (XCAR (XCAR (names)), name);
4132 if (!NILP (tem))
4133 return dpyinfo;
4136 /* Use this general default value to start with. */
4137 Vx_resource_name = Vinvocation_name;
4139 validate_x_resource_name ();
4141 dpyinfo = x_term_init (name, (char *)0,
4142 (char *) SDATA (Vx_resource_name));
4144 if (dpyinfo == 0)
4145 error ("Cannot connect to X server %s", SDATA (name));
4147 x_in_use = 1;
4148 XSETFASTINT (Vwindow_system_version, 11);
4150 return dpyinfo;
4154 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
4155 1, 3, 0,
4156 doc: /* Open a connection to an X server.
4157 DISPLAY is the name of the display to connect to.
4158 Optional second arg XRM-STRING is a string of resources in xrdb format.
4159 If the optional third arg MUST-SUCCEED is non-nil,
4160 terminate Emacs if we can't open the connection. */)
4161 (display, xrm_string, must_succeed)
4162 Lisp_Object display, xrm_string, must_succeed;
4164 unsigned char *xrm_option;
4165 struct x_display_info *dpyinfo;
4167 CHECK_STRING (display);
4168 if (! NILP (xrm_string))
4169 CHECK_STRING (xrm_string);
4171 #if 0
4172 if (! EQ (Vinitial_window_system, intern ("x")))
4173 error ("Not using X Windows"); /* That doesn't stop us anymore. */
4174 #endif
4176 if (! NILP (xrm_string))
4177 xrm_option = (unsigned char *) SDATA (xrm_string);
4178 else
4179 xrm_option = (unsigned char *) 0;
4181 validate_x_resource_name ();
4183 /* This is what opens the connection and sets x_current_display.
4184 This also initializes many symbols, such as those used for input. */
4185 dpyinfo = x_term_init (display, xrm_option,
4186 (char *) SDATA (Vx_resource_name));
4188 if (dpyinfo == 0)
4190 if (!NILP (must_succeed))
4191 fatal ("Cannot connect to X server %s.\n\
4192 Check the DISPLAY environment variable or use `-d'.\n\
4193 Also use the `xauth' program to verify that you have the proper\n\
4194 authorization information needed to connect the X server.\n\
4195 An insecure way to solve the problem may be to use `xhost'.\n",
4196 SDATA (display));
4197 else
4198 error ("Cannot connect to X server %s", SDATA (display));
4201 x_in_use = 1;
4203 XSETFASTINT (Vwindow_system_version, 11);
4204 return Qnil;
4207 DEFUN ("x-close-connection", Fx_close_connection,
4208 Sx_close_connection, 1, 1, 0,
4209 doc: /* Close the connection to TERMINAL's X server.
4210 For TERMINAL, specify a terminal object, a frame or a display name (a
4211 string). If TERMINAL is nil, that stands for the selected frame's
4212 terminal. */)
4213 (terminal)
4214 Lisp_Object terminal;
4216 struct x_display_info *dpyinfo = check_x_display_info (terminal);
4218 if (dpyinfo->reference_count > 0)
4219 error ("Display still has frames on it");
4221 x_delete_terminal (dpyinfo->terminal);
4223 return Qnil;
4226 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
4227 doc: /* Return the list of display names that Emacs has connections to. */)
4230 Lisp_Object tail, result;
4232 result = Qnil;
4233 for (tail = x_display_name_list; CONSP (tail); tail = XCDR (tail))
4234 result = Fcons (XCAR (XCAR (tail)), result);
4236 return result;
4239 DEFUN ("x-synchronize", Fx_synchronize, Sx_synchronize, 1, 2, 0,
4240 doc: /* If ON is non-nil, report X errors as soon as the erring request is made.
4241 If ON is nil, allow buffering of requests.
4242 Turning on synchronization prohibits the Xlib routines from buffering
4243 requests and seriously degrades performance, but makes debugging much
4244 easier.
4245 The optional second argument TERMINAL specifies which display to act on.
4246 TERMINAL should be a terminal object, a frame or a display name (a string).
4247 If TERMINAL is omitted or nil, that stands for the selected frame's display. */)
4248 (on, terminal)
4249 Lisp_Object terminal, on;
4251 struct x_display_info *dpyinfo = check_x_display_info (terminal);
4253 XSynchronize (dpyinfo->display, !EQ (on, Qnil));
4255 return Qnil;
4258 /* Wait for responses to all X commands issued so far for frame F. */
4260 void
4261 x_sync (f)
4262 FRAME_PTR f;
4264 BLOCK_INPUT;
4265 XSync (FRAME_X_DISPLAY (f), False);
4266 UNBLOCK_INPUT;
4270 /***********************************************************************
4271 Window properties
4272 ***********************************************************************/
4274 DEFUN ("x-change-window-property", Fx_change_window_property,
4275 Sx_change_window_property, 2, 6, 0,
4276 doc: /* Change window property PROP to VALUE on the X window of FRAME.
4277 PROP must be a string.
4278 VALUE may be a string or a list of conses, numbers and/or strings.
4279 If an element in the list is a string, it is converted to
4280 an Atom and the value of the Atom is used. If an element is a cons,
4281 it is converted to a 32 bit number where the car is the 16 top bits and the
4282 cdr is the lower 16 bits.
4283 FRAME nil or omitted means use the selected frame.
4284 If TYPE is given and non-nil, it is the name of the type of VALUE.
4285 If TYPE is not given or nil, the type is STRING.
4286 FORMAT gives the size in bits of each element if VALUE is a list.
4287 It must be one of 8, 16 or 32.
4288 If VALUE is a string or FORMAT is nil or not given, FORMAT defaults to 8.
4289 If OUTER_P is non-nil, the property is changed for the outer X window of
4290 FRAME. Default is to change on the edit X window.
4292 Value is VALUE. */)
4293 (prop, value, frame, type, format, outer_p)
4294 Lisp_Object prop, value, frame, type, format, outer_p;
4296 struct frame *f = check_x_frame (frame);
4297 Atom prop_atom;
4298 Atom target_type = XA_STRING;
4299 int element_format = 8;
4300 unsigned char *data;
4301 int nelements;
4302 Window w;
4304 CHECK_STRING (prop);
4306 if (! NILP (format))
4308 CHECK_NUMBER (format);
4309 element_format = XFASTINT (format);
4311 if (element_format != 8 && element_format != 16
4312 && element_format != 32)
4313 error ("FORMAT must be one of 8, 16 or 32");
4316 if (CONSP (value))
4318 nelements = x_check_property_data (value);
4319 if (nelements == -1)
4320 error ("Bad data in VALUE, must be number, string or cons");
4322 if (element_format == 8)
4323 data = (unsigned char *) xmalloc (nelements);
4324 else if (element_format == 16)
4325 data = (unsigned char *) xmalloc (nelements*2);
4326 else /* format == 32 */
4327 /* The man page for XChangeProperty:
4328 "If the specified format is 32, the property data must be a
4329 long array."
4330 This applies even if long is more than 64 bits. The X library
4331 converts to 32 bits before sending to the X server. */
4332 data = (unsigned char *) xmalloc (nelements * sizeof(long));
4334 x_fill_property_data (FRAME_X_DISPLAY (f), value, data, element_format);
4336 else
4338 CHECK_STRING (value);
4339 data = SDATA (value);
4340 nelements = SCHARS (value);
4343 BLOCK_INPUT;
4344 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SDATA (prop), False);
4345 if (! NILP (type))
4347 CHECK_STRING (type);
4348 target_type = XInternAtom (FRAME_X_DISPLAY (f), SDATA (type), False);
4351 if (! NILP (outer_p)) w = FRAME_OUTER_WINDOW (f);
4352 else w = FRAME_X_WINDOW (f);
4354 XChangeProperty (FRAME_X_DISPLAY (f), w,
4355 prop_atom, target_type, element_format, PropModeReplace,
4356 data, nelements);
4358 if (CONSP (value)) xfree (data);
4360 /* Make sure the property is set when we return. */
4361 XFlush (FRAME_X_DISPLAY (f));
4362 UNBLOCK_INPUT;
4364 return value;
4368 DEFUN ("x-delete-window-property", Fx_delete_window_property,
4369 Sx_delete_window_property, 1, 2, 0,
4370 doc: /* Remove window property PROP from X window of FRAME.
4371 FRAME nil or omitted means use the selected frame. Value is PROP. */)
4372 (prop, frame)
4373 Lisp_Object prop, frame;
4375 struct frame *f = check_x_frame (frame);
4376 Atom prop_atom;
4378 CHECK_STRING (prop);
4379 BLOCK_INPUT;
4380 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SDATA (prop), False);
4381 XDeleteProperty (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), prop_atom);
4383 /* Make sure the property is removed when we return. */
4384 XFlush (FRAME_X_DISPLAY (f));
4385 UNBLOCK_INPUT;
4387 return prop;
4391 DEFUN ("x-window-property", Fx_window_property, Sx_window_property,
4392 1, 6, 0,
4393 doc: /* Value is the value of window property PROP on FRAME.
4394 If FRAME is nil or omitted, use the selected frame.
4395 If TYPE is nil or omitted, get the property as a string. Otherwise TYPE
4396 is the name of the Atom that denotes the type expected.
4397 If SOURCE is non-nil, get the property on that window instead of from
4398 FRAME. The number 0 denotes the root window.
4399 If DELETE_P is non-nil, delete the property after retreiving it.
4400 If VECTOR_RET_P is non-nil, don't return a string but a vector of values.
4402 Value is nil if FRAME hasn't a property with name PROP or if PROP has
4403 no value of TYPE. */)
4404 (prop, frame, type, source, delete_p, vector_ret_p)
4405 Lisp_Object prop, frame, type, source, delete_p, vector_ret_p;
4407 struct frame *f = check_x_frame (frame);
4408 Atom prop_atom;
4409 int rc;
4410 Lisp_Object prop_value = Qnil;
4411 unsigned char *tmp_data = NULL;
4412 Atom actual_type;
4413 Atom target_type = XA_STRING;
4414 int actual_format;
4415 unsigned long actual_size, bytes_remaining;
4416 Window target_window = FRAME_X_WINDOW (f);
4417 struct gcpro gcpro1;
4419 GCPRO1 (prop_value);
4420 CHECK_STRING (prop);
4422 if (! NILP (source))
4424 if (NUMBERP (source))
4426 if (FLOATP (source))
4427 target_window = (Window) XFLOAT (source);
4428 else
4429 target_window = XFASTINT (source);
4431 if (target_window == 0)
4432 target_window = FRAME_X_DISPLAY_INFO (f)->root_window;
4434 else if (CONSP (source))
4435 target_window = cons_to_long (source);
4438 BLOCK_INPUT;
4439 if (STRINGP (type))
4441 if (strcmp ("AnyPropertyType", SDATA (type)) == 0)
4442 target_type = AnyPropertyType;
4443 else
4444 target_type = XInternAtom (FRAME_X_DISPLAY (f), SDATA (type), False);
4447 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SDATA (prop), False);
4448 rc = XGetWindowProperty (FRAME_X_DISPLAY (f), target_window,
4449 prop_atom, 0, 0, False, target_type,
4450 &actual_type, &actual_format, &actual_size,
4451 &bytes_remaining, &tmp_data);
4452 if (rc == Success)
4454 int size = bytes_remaining;
4456 XFree (tmp_data);
4457 tmp_data = NULL;
4459 rc = XGetWindowProperty (FRAME_X_DISPLAY (f), target_window,
4460 prop_atom, 0, bytes_remaining,
4461 ! NILP (delete_p), target_type,
4462 &actual_type, &actual_format,
4463 &actual_size, &bytes_remaining,
4464 &tmp_data);
4465 if (rc == Success && tmp_data)
4467 /* The man page for XGetWindowProperty says:
4468 "If the returned format is 32, the returned data is represented
4469 as a long array and should be cast to that type to obtain the
4470 elements."
4471 This applies even if long is more than 32 bits, the X library
4472 converts from 32 bit elements received from the X server to long
4473 and passes the long array to us. Thus, for that case bcopy can not
4474 be used. We convert to a 32 bit type here, because so much code
4475 assume on that.
4477 The bytes and offsets passed to XGetWindowProperty refers to the
4478 property and those are indeed in 32 bit quantities if format is
4479 32. */
4481 if (actual_format == 32 && actual_format < BITS_PER_LONG)
4483 unsigned long i;
4484 int *idata = (int *) tmp_data;
4485 long *ldata = (long *) tmp_data;
4487 for (i = 0; i < actual_size; ++i)
4488 idata[i] = (int) ldata[i];
4491 if (NILP (vector_ret_p))
4492 prop_value = make_string (tmp_data, size);
4493 else
4494 prop_value = x_property_data_to_lisp (f,
4495 tmp_data,
4496 actual_type,
4497 actual_format,
4498 actual_size);
4501 if (tmp_data) XFree (tmp_data);
4504 UNBLOCK_INPUT;
4505 UNGCPRO;
4506 return prop_value;
4511 /***********************************************************************
4512 Busy cursor
4513 ***********************************************************************/
4515 /* Timer function of hourglass_atimer. TIMER is equal to
4516 hourglass_atimer.
4518 Display an hourglass pointer on all frames by mapping the frames'
4519 hourglass_window. Set the hourglass_p flag in the frames'
4520 output_data.x structure to indicate that an hourglass cursor is
4521 shown on the frames. */
4523 void
4524 show_hourglass (timer)
4525 struct atimer *timer;
4527 /* The timer implementation will cancel this timer automatically
4528 after this function has run. Set hourglass_atimer to null
4529 so that we know the timer doesn't have to be canceled. */
4530 hourglass_atimer = NULL;
4532 if (!hourglass_shown_p)
4534 Lisp_Object rest, frame;
4536 BLOCK_INPUT;
4538 FOR_EACH_FRAME (rest, frame)
4540 struct frame *f = XFRAME (frame);
4542 if (FRAME_LIVE_P (f) && FRAME_X_P (f) && FRAME_X_DISPLAY (f))
4544 Display *dpy = FRAME_X_DISPLAY (f);
4546 #ifdef USE_X_TOOLKIT
4547 if (f->output_data.x->widget)
4548 #else
4549 if (FRAME_OUTER_WINDOW (f))
4550 #endif
4552 f->output_data.x->hourglass_p = 1;
4554 if (!f->output_data.x->hourglass_window)
4556 unsigned long mask = CWCursor;
4557 XSetWindowAttributes attrs;
4558 #ifdef USE_GTK
4559 Window parent = FRAME_X_WINDOW (f);
4560 #else
4561 Window parent = FRAME_OUTER_WINDOW (f);
4562 #endif
4563 attrs.cursor = f->output_data.x->hourglass_cursor;
4565 f->output_data.x->hourglass_window
4566 = XCreateWindow (dpy, parent,
4567 0, 0, 32000, 32000, 0, 0,
4568 InputOnly,
4569 CopyFromParent,
4570 mask, &attrs);
4573 XMapRaised (dpy, f->output_data.x->hourglass_window);
4574 XFlush (dpy);
4579 hourglass_shown_p = 1;
4580 UNBLOCK_INPUT;
4585 /* Hide the hourglass pointer on all frames, if it is currently
4586 shown. */
4588 void
4589 hide_hourglass ()
4591 if (hourglass_shown_p)
4593 Lisp_Object rest, frame;
4595 BLOCK_INPUT;
4596 FOR_EACH_FRAME (rest, frame)
4598 struct frame *f = XFRAME (frame);
4600 if (FRAME_X_P (f)
4601 /* Watch out for newly created frames. */
4602 && f->output_data.x->hourglass_window)
4604 XUnmapWindow (FRAME_X_DISPLAY (f),
4605 f->output_data.x->hourglass_window);
4606 /* Sync here because XTread_socket looks at the
4607 hourglass_p flag that is reset to zero below. */
4608 XSync (FRAME_X_DISPLAY (f), False);
4609 f->output_data.x->hourglass_p = 0;
4613 hourglass_shown_p = 0;
4614 UNBLOCK_INPUT;
4620 /***********************************************************************
4621 Tool tips
4622 ***********************************************************************/
4624 static Lisp_Object x_create_tip_frame P_ ((struct x_display_info *,
4625 Lisp_Object, Lisp_Object));
4626 static void compute_tip_xy P_ ((struct frame *, Lisp_Object, Lisp_Object,
4627 Lisp_Object, int, int, int *, int *));
4629 /* The frame of a currently visible tooltip. */
4631 Lisp_Object tip_frame;
4633 /* If non-nil, a timer started that hides the last tooltip when it
4634 fires. */
4636 Lisp_Object tip_timer;
4637 Window tip_window;
4639 /* If non-nil, a vector of 3 elements containing the last args
4640 with which x-show-tip was called. See there. */
4642 Lisp_Object last_show_tip_args;
4644 /* Maximum size for tooltips; a cons (COLUMNS . ROWS). */
4646 Lisp_Object Vx_max_tooltip_size;
4649 static Lisp_Object
4650 unwind_create_tip_frame (frame)
4651 Lisp_Object frame;
4653 Lisp_Object deleted;
4655 deleted = unwind_create_frame (frame);
4656 if (EQ (deleted, Qt))
4658 tip_window = None;
4659 tip_frame = Qnil;
4662 return deleted;
4666 /* Create a frame for a tooltip on the display described by DPYINFO.
4667 PARMS is a list of frame parameters. TEXT is the string to
4668 display in the tip frame. Value is the frame.
4670 Note that functions called here, esp. x_default_parameter can
4671 signal errors, for instance when a specified color name is
4672 undefined. We have to make sure that we're in a consistent state
4673 when this happens. */
4675 static Lisp_Object
4676 x_create_tip_frame (dpyinfo, parms, text)
4677 struct x_display_info *dpyinfo;
4678 Lisp_Object parms, text;
4680 struct frame *f;
4681 Lisp_Object frame, tem;
4682 Lisp_Object name;
4683 long window_prompting = 0;
4684 int width, height;
4685 int count = SPECPDL_INDEX ();
4686 struct gcpro gcpro1, gcpro2, gcpro3;
4687 int face_change_count_before = face_change_count;
4688 Lisp_Object buffer;
4689 struct buffer *old_buffer;
4691 check_x ();
4693 if (!dpyinfo->terminal->name)
4694 error ("Terminal is not live, can't create new frames on it");
4696 parms = Fcopy_alist (parms);
4698 /* Get the name of the frame to use for resource lookup. */
4699 name = x_get_arg (dpyinfo, parms, Qname, "name", "Name", RES_TYPE_STRING);
4700 if (!STRINGP (name)
4701 && !EQ (name, Qunbound)
4702 && !NILP (name))
4703 error ("Invalid frame name--not a string or nil");
4705 frame = Qnil;
4706 GCPRO3 (parms, name, frame);
4707 f = make_frame (1);
4708 XSETFRAME (frame, f);
4710 buffer = Fget_buffer_create (build_string (" *tip*"));
4711 Fset_window_buffer (FRAME_ROOT_WINDOW (f), buffer, Qnil);
4712 old_buffer = current_buffer;
4713 set_buffer_internal_1 (XBUFFER (buffer));
4714 current_buffer->truncate_lines = Qnil;
4715 specbind (Qinhibit_read_only, Qt);
4716 specbind (Qinhibit_modification_hooks, Qt);
4717 Ferase_buffer ();
4718 Finsert (1, &text);
4719 set_buffer_internal_1 (old_buffer);
4721 FRAME_CAN_HAVE_SCROLL_BARS (f) = 0;
4722 record_unwind_protect (unwind_create_tip_frame, frame);
4724 f->terminal = dpyinfo->terminal;
4725 f->terminal->reference_count++;
4727 /* By setting the output method, we're essentially saying that
4728 the frame is live, as per FRAME_LIVE_P. If we get a signal
4729 from this point on, x_destroy_window might screw up reference
4730 counts etc. */
4731 f->output_method = output_x_window;
4732 f->output_data.x = (struct x_output *) xmalloc (sizeof (struct x_output));
4733 bzero (f->output_data.x, sizeof (struct x_output));
4734 f->output_data.x->icon_bitmap = -1;
4735 FRAME_FONTSET (f) = -1;
4736 f->output_data.x->scroll_bar_foreground_pixel = -1;
4737 f->output_data.x->scroll_bar_background_pixel = -1;
4738 #ifdef USE_TOOLKIT_SCROLL_BARS
4739 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
4740 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
4741 #endif /* USE_TOOLKIT_SCROLL_BARS */
4742 f->icon_name = Qnil;
4743 FRAME_X_DISPLAY_INFO (f) = dpyinfo;
4744 #if GLYPH_DEBUG
4745 image_cache_refcount = FRAME_IMAGE_CACHE (f)->refcount;
4746 dpyinfo_refcount = dpyinfo->reference_count;
4747 #endif /* GLYPH_DEBUG */
4748 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
4749 f->output_data.x->explicit_parent = 0;
4751 /* These colors will be set anyway later, but it's important
4752 to get the color reference counts right, so initialize them! */
4754 Lisp_Object black;
4755 struct gcpro gcpro1;
4757 /* Function x_decode_color can signal an error. Make
4758 sure to initialize color slots so that we won't try
4759 to free colors we haven't allocated. */
4760 FRAME_FOREGROUND_PIXEL (f) = -1;
4761 FRAME_BACKGROUND_PIXEL (f) = -1;
4762 f->output_data.x->cursor_pixel = -1;
4763 f->output_data.x->cursor_foreground_pixel = -1;
4764 f->output_data.x->border_pixel = -1;
4765 f->output_data.x->mouse_pixel = -1;
4767 black = build_string ("black");
4768 GCPRO1 (black);
4769 FRAME_FOREGROUND_PIXEL (f)
4770 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4771 FRAME_BACKGROUND_PIXEL (f)
4772 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4773 f->output_data.x->cursor_pixel
4774 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4775 f->output_data.x->cursor_foreground_pixel
4776 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4777 f->output_data.x->border_pixel
4778 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4779 f->output_data.x->mouse_pixel
4780 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4781 UNGCPRO;
4784 /* Set the name; the functions to which we pass f expect the name to
4785 be set. */
4786 if (EQ (name, Qunbound) || NILP (name))
4788 f->name = build_string (dpyinfo->x_id_name);
4789 f->explicit_name = 0;
4791 else
4793 f->name = name;
4794 f->explicit_name = 1;
4795 /* use the frame's title when getting resources for this frame. */
4796 specbind (Qx_resource_name, name);
4799 f->resx = dpyinfo->resx;
4800 f->resy = dpyinfo->resy;
4802 register_font_driver (&xfont_driver, f);
4803 #ifdef HAVE_FREETYPE
4804 #ifdef HAVE_XFT
4805 register_font_driver (&xftfont_driver, f);
4806 #else /* not HAVE_XFT */
4807 register_font_driver (&ftxfont_driver, f);
4808 #endif /* not HAVE_XFT */
4809 #endif /* HAVE_FREETYPE */
4811 x_default_parameter (f, parms, Qfont_backend, Qnil,
4812 "fontBackend", "FontBackend", RES_TYPE_STRING);
4814 /* Extract the window parameters from the supplied values that are
4815 needed to determine window geometry. */
4816 x_default_font_parameter (f, parms);
4818 x_default_parameter (f, parms, Qborder_width, make_number (2),
4819 "borderWidth", "BorderWidth", RES_TYPE_NUMBER);
4821 /* This defaults to 2 in order to match xterm. We recognize either
4822 internalBorderWidth or internalBorder (which is what xterm calls
4823 it). */
4824 if (NILP (Fassq (Qinternal_border_width, parms)))
4826 Lisp_Object value;
4828 value = x_get_arg (dpyinfo, parms, Qinternal_border_width,
4829 "internalBorder", "internalBorder", RES_TYPE_NUMBER);
4830 if (! EQ (value, Qunbound))
4831 parms = Fcons (Fcons (Qinternal_border_width, value),
4832 parms);
4835 x_default_parameter (f, parms, Qinternal_border_width, make_number (1),
4836 "internalBorderWidth", "internalBorderWidth",
4837 RES_TYPE_NUMBER);
4839 /* Also do the stuff which must be set before the window exists. */
4840 x_default_parameter (f, parms, Qforeground_color, build_string ("black"),
4841 "foreground", "Foreground", RES_TYPE_STRING);
4842 x_default_parameter (f, parms, Qbackground_color, build_string ("white"),
4843 "background", "Background", RES_TYPE_STRING);
4844 x_default_parameter (f, parms, Qmouse_color, build_string ("black"),
4845 "pointerColor", "Foreground", RES_TYPE_STRING);
4846 x_default_parameter (f, parms, Qcursor_color, build_string ("black"),
4847 "cursorColor", "Foreground", RES_TYPE_STRING);
4848 x_default_parameter (f, parms, Qborder_color, build_string ("black"),
4849 "borderColor", "BorderColor", RES_TYPE_STRING);
4851 /* Init faces before x_default_parameter is called for scroll-bar
4852 parameters because that function calls x_set_scroll_bar_width,
4853 which calls change_frame_size, which calls Fset_window_buffer,
4854 which runs hooks, which call Fvertical_motion. At the end, we
4855 end up in init_iterator with a null face cache, which should not
4856 happen. */
4857 init_frame_faces (f);
4859 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
4861 window_prompting = x_figure_window_size (f, parms, 0);
4864 XSetWindowAttributes attrs;
4865 unsigned long mask;
4867 BLOCK_INPUT;
4868 mask = CWBackPixel | CWOverrideRedirect | CWEventMask;
4869 if (DoesSaveUnders (dpyinfo->screen))
4870 mask |= CWSaveUnder;
4872 /* Window managers look at the override-redirect flag to determine
4873 whether or net to give windows a decoration (Xlib spec, chapter
4874 3.2.8). */
4875 attrs.override_redirect = True;
4876 attrs.save_under = True;
4877 attrs.background_pixel = FRAME_BACKGROUND_PIXEL (f);
4878 /* Arrange for getting MapNotify and UnmapNotify events. */
4879 attrs.event_mask = StructureNotifyMask;
4880 tip_window
4881 = FRAME_X_WINDOW (f)
4882 = XCreateWindow (FRAME_X_DISPLAY (f),
4883 FRAME_X_DISPLAY_INFO (f)->root_window,
4884 /* x, y, width, height */
4885 0, 0, 1, 1,
4886 /* Border. */
4887 f->border_width,
4888 CopyFromParent, InputOutput, CopyFromParent,
4889 mask, &attrs);
4890 UNBLOCK_INPUT;
4893 x_make_gc (f);
4895 x_default_parameter (f, parms, Qauto_raise, Qnil,
4896 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
4897 x_default_parameter (f, parms, Qauto_lower, Qnil,
4898 "autoLower", "AutoRaiseLower", RES_TYPE_BOOLEAN);
4899 x_default_parameter (f, parms, Qcursor_type, Qbox,
4900 "cursorType", "CursorType", RES_TYPE_SYMBOL);
4902 /* Dimensions, especially FRAME_LINES (f), must be done via change_frame_size.
4903 Change will not be effected unless different from the current
4904 FRAME_LINES (f). */
4905 width = FRAME_COLS (f);
4906 height = FRAME_LINES (f);
4907 SET_FRAME_COLS (f, 0);
4908 FRAME_LINES (f) = 0;
4909 change_frame_size (f, height, width, 1, 0, 0);
4911 /* Add `tooltip' frame parameter's default value. */
4912 if (NILP (Fframe_parameter (frame, intern ("tooltip"))))
4913 Fmodify_frame_parameters (frame, Fcons (Fcons (intern ("tooltip"), Qt),
4914 Qnil));
4916 /* FIXME - can this be done in a similar way to normal frames?
4917 http://lists.gnu.org/archive/html/emacs-devel/2007-10/msg00641.html */
4919 /* Set the `display-type' frame parameter before setting up faces. */
4921 Lisp_Object disptype;
4923 if (FRAME_X_DISPLAY_INFO (f)->n_planes == 1)
4924 disptype = intern ("mono");
4925 else if (FRAME_X_DISPLAY_INFO (f)->visual->class == GrayScale
4926 || FRAME_X_DISPLAY_INFO (f)->visual->class == StaticGray)
4927 disptype = intern ("grayscale");
4928 else
4929 disptype = intern ("color");
4931 if (NILP (Fframe_parameter (frame, Qdisplay_type)))
4932 Fmodify_frame_parameters (frame, Fcons (Fcons (Qdisplay_type, disptype),
4933 Qnil));
4936 /* Set up faces after all frame parameters are known. This call
4937 also merges in face attributes specified for new frames.
4939 Frame parameters may be changed if .Xdefaults contains
4940 specifications for the default font. For example, if there is an
4941 `Emacs.default.attributeBackground: pink', the `background-color'
4942 attribute of the frame get's set, which let's the internal border
4943 of the tooltip frame appear in pink. Prevent this. */
4945 Lisp_Object bg = Fframe_parameter (frame, Qbackground_color);
4947 /* Set tip_frame here, so that */
4948 tip_frame = frame;
4949 call2 (Qface_set_after_frame_default, frame, Qnil);
4951 if (!EQ (bg, Fframe_parameter (frame, Qbackground_color)))
4952 Fmodify_frame_parameters (frame, Fcons (Fcons (Qbackground_color, bg),
4953 Qnil));
4956 f->no_split = 1;
4958 UNGCPRO;
4960 /* It is now ok to make the frame official even if we get an error
4961 below. And the frame needs to be on Vframe_list or making it
4962 visible won't work. */
4963 Vframe_list = Fcons (frame, Vframe_list);
4965 /* Now that the frame is official, it counts as a reference to
4966 its display. */
4967 FRAME_X_DISPLAY_INFO (f)->reference_count++;
4969 /* Setting attributes of faces of the tooltip frame from resources
4970 and similar will increment face_change_count, which leads to the
4971 clearing of all current matrices. Since this isn't necessary
4972 here, avoid it by resetting face_change_count to the value it
4973 had before we created the tip frame. */
4974 face_change_count = face_change_count_before;
4976 /* Discard the unwind_protect. */
4977 return unbind_to (count, frame);
4981 /* Compute where to display tip frame F. PARMS is the list of frame
4982 parameters for F. DX and DY are specified offsets from the current
4983 location of the mouse. WIDTH and HEIGHT are the width and height
4984 of the tooltip. Return coordinates relative to the root window of
4985 the display in *ROOT_X, and *ROOT_Y. */
4987 static void
4988 compute_tip_xy (f, parms, dx, dy, width, height, root_x, root_y)
4989 struct frame *f;
4990 Lisp_Object parms, dx, dy;
4991 int width, height;
4992 int *root_x, *root_y;
4994 Lisp_Object left, top;
4995 int win_x, win_y;
4996 Window root, child;
4997 unsigned pmask;
4999 /* User-specified position? */
5000 left = Fcdr (Fassq (Qleft, parms));
5001 top = Fcdr (Fassq (Qtop, parms));
5003 /* Move the tooltip window where the mouse pointer is. Resize and
5004 show it. */
5005 if (!INTEGERP (left) || !INTEGERP (top))
5007 BLOCK_INPUT;
5008 XQueryPointer (FRAME_X_DISPLAY (f), FRAME_X_DISPLAY_INFO (f)->root_window,
5009 &root, &child, root_x, root_y, &win_x, &win_y, &pmask);
5010 UNBLOCK_INPUT;
5013 if (INTEGERP (top))
5014 *root_y = XINT (top);
5015 else if (*root_y + XINT (dy) <= 0)
5016 *root_y = 0; /* Can happen for negative dy */
5017 else if (*root_y + XINT (dy) + height
5018 <= x_display_pixel_height (FRAME_X_DISPLAY_INFO (f)))
5019 /* It fits below the pointer */
5020 *root_y += XINT (dy);
5021 else if (height + XINT (dy) <= *root_y)
5022 /* It fits above the pointer. */
5023 *root_y -= height + XINT (dy);
5024 else
5025 /* Put it on the top. */
5026 *root_y = 0;
5028 if (INTEGERP (left))
5029 *root_x = XINT (left);
5030 else if (*root_x + XINT (dx) <= 0)
5031 *root_x = 0; /* Can happen for negative dx */
5032 else if (*root_x + XINT (dx) + width
5033 <= x_display_pixel_width (FRAME_X_DISPLAY_INFO (f)))
5034 /* It fits to the right of the pointer. */
5035 *root_x += XINT (dx);
5036 else if (width + XINT (dx) <= *root_x)
5037 /* It fits to the left of the pointer. */
5038 *root_x -= width + XINT (dx);
5039 else
5040 /* Put it left-justified on the screen--it ought to fit that way. */
5041 *root_x = 0;
5045 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
5046 doc: /* Show STRING in a "tooltip" window on frame FRAME.
5047 A tooltip window is a small X window displaying a string.
5049 This is an internal function; Lisp code should call `tooltip-show'.
5051 FRAME nil or omitted means use the selected frame.
5053 PARMS is an optional list of frame parameters which can be used to
5054 change the tooltip's appearance.
5056 Automatically hide the tooltip after TIMEOUT seconds. TIMEOUT nil
5057 means use the default timeout of 5 seconds.
5059 If the list of frame parameters PARAMS contains a `left' parameters,
5060 the tooltip is displayed at that x-position. Otherwise it is
5061 displayed at the mouse position, with offset DX added (default is 5 if
5062 DX isn't specified). Likewise for the y-position; if a `top' frame
5063 parameter is specified, it determines the y-position of the tooltip
5064 window, otherwise it is displayed at the mouse position, with offset
5065 DY added (default is -10).
5067 A tooltip's maximum size is specified by `x-max-tooltip-size'.
5068 Text larger than the specified size is clipped. */)
5069 (string, frame, parms, timeout, dx, dy)
5070 Lisp_Object string, frame, parms, timeout, dx, dy;
5072 struct frame *f;
5073 struct window *w;
5074 int root_x, root_y;
5075 struct buffer *old_buffer;
5076 struct text_pos pos;
5077 int i, width, height;
5078 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
5079 int old_windows_or_buffers_changed = windows_or_buffers_changed;
5080 int count = SPECPDL_INDEX ();
5082 specbind (Qinhibit_redisplay, Qt);
5084 GCPRO4 (string, parms, frame, timeout);
5086 CHECK_STRING (string);
5087 if (SCHARS (string) == 0)
5088 string = make_unibyte_string (" ", 1);
5090 f = check_x_frame (frame);
5091 if (NILP (timeout))
5092 timeout = make_number (5);
5093 else
5094 CHECK_NATNUM (timeout);
5096 if (NILP (dx))
5097 dx = make_number (5);
5098 else
5099 CHECK_NUMBER (dx);
5101 if (NILP (dy))
5102 dy = make_number (-10);
5103 else
5104 CHECK_NUMBER (dy);
5106 if (NILP (last_show_tip_args))
5107 last_show_tip_args = Fmake_vector (make_number (3), Qnil);
5109 if (!NILP (tip_frame))
5111 Lisp_Object last_string = AREF (last_show_tip_args, 0);
5112 Lisp_Object last_frame = AREF (last_show_tip_args, 1);
5113 Lisp_Object last_parms = AREF (last_show_tip_args, 2);
5115 if (EQ (frame, last_frame)
5116 && !NILP (Fequal (last_string, string))
5117 && !NILP (Fequal (last_parms, parms)))
5119 struct frame *f = XFRAME (tip_frame);
5121 /* Only DX and DY have changed. */
5122 if (!NILP (tip_timer))
5124 Lisp_Object timer = tip_timer;
5125 tip_timer = Qnil;
5126 call1 (Qcancel_timer, timer);
5129 BLOCK_INPUT;
5130 compute_tip_xy (f, parms, dx, dy, FRAME_PIXEL_WIDTH (f),
5131 FRAME_PIXEL_HEIGHT (f), &root_x, &root_y);
5132 XMoveWindow (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
5133 root_x, root_y);
5134 UNBLOCK_INPUT;
5135 goto start_timer;
5139 /* Hide a previous tip, if any. */
5140 Fx_hide_tip ();
5142 ASET (last_show_tip_args, 0, string);
5143 ASET (last_show_tip_args, 1, frame);
5144 ASET (last_show_tip_args, 2, parms);
5146 /* Add default values to frame parameters. */
5147 if (NILP (Fassq (Qname, parms)))
5148 parms = Fcons (Fcons (Qname, build_string ("tooltip")), parms);
5149 if (NILP (Fassq (Qinternal_border_width, parms)))
5150 parms = Fcons (Fcons (Qinternal_border_width, make_number (3)), parms);
5151 if (NILP (Fassq (Qborder_width, parms)))
5152 parms = Fcons (Fcons (Qborder_width, make_number (1)), parms);
5153 if (NILP (Fassq (Qborder_color, parms)))
5154 parms = Fcons (Fcons (Qborder_color, build_string ("lightyellow")), parms);
5155 if (NILP (Fassq (Qbackground_color, parms)))
5156 parms = Fcons (Fcons (Qbackground_color, build_string ("lightyellow")),
5157 parms);
5159 /* Create a frame for the tooltip, and record it in the global
5160 variable tip_frame. */
5161 frame = x_create_tip_frame (FRAME_X_DISPLAY_INFO (f), parms, string);
5162 f = XFRAME (frame);
5164 /* Set up the frame's root window. */
5165 w = XWINDOW (FRAME_ROOT_WINDOW (f));
5166 w->left_col = w->top_line = make_number (0);
5168 if (CONSP (Vx_max_tooltip_size)
5169 && INTEGERP (XCAR (Vx_max_tooltip_size))
5170 && XINT (XCAR (Vx_max_tooltip_size)) > 0
5171 && INTEGERP (XCDR (Vx_max_tooltip_size))
5172 && XINT (XCDR (Vx_max_tooltip_size)) > 0)
5174 w->total_cols = XCAR (Vx_max_tooltip_size);
5175 w->total_lines = XCDR (Vx_max_tooltip_size);
5177 else
5179 w->total_cols = make_number (80);
5180 w->total_lines = make_number (40);
5183 FRAME_TOTAL_COLS (f) = XINT (w->total_cols);
5184 adjust_glyphs (f);
5185 w->pseudo_window_p = 1;
5187 /* Display the tooltip text in a temporary buffer. */
5188 old_buffer = current_buffer;
5189 set_buffer_internal_1 (XBUFFER (XWINDOW (FRAME_ROOT_WINDOW (f))->buffer));
5190 current_buffer->truncate_lines = Qnil;
5191 clear_glyph_matrix (w->desired_matrix);
5192 clear_glyph_matrix (w->current_matrix);
5193 SET_TEXT_POS (pos, BEGV, BEGV_BYTE);
5194 try_window (FRAME_ROOT_WINDOW (f), pos, 0);
5196 /* Compute width and height of the tooltip. */
5197 width = height = 0;
5198 for (i = 0; i < w->desired_matrix->nrows; ++i)
5200 struct glyph_row *row = &w->desired_matrix->rows[i];
5201 struct glyph *last;
5202 int row_width;
5204 /* Stop at the first empty row at the end. */
5205 if (!row->enabled_p || !row->displays_text_p)
5206 break;
5208 /* Let the row go over the full width of the frame. */
5209 row->full_width_p = 1;
5211 /* There's a glyph at the end of rows that is used to place
5212 the cursor there. Don't include the width of this glyph. */
5213 if (row->used[TEXT_AREA])
5215 last = &row->glyphs[TEXT_AREA][row->used[TEXT_AREA] - 1];
5216 row_width = row->pixel_width - last->pixel_width;
5218 else
5219 row_width = row->pixel_width;
5221 height += row->height;
5222 width = max (width, row_width);
5225 /* Add the frame's internal border to the width and height the X
5226 window should have. */
5227 height += 2 * FRAME_INTERNAL_BORDER_WIDTH (f);
5228 width += 2 * FRAME_INTERNAL_BORDER_WIDTH (f);
5230 /* Move the tooltip window where the mouse pointer is. Resize and
5231 show it. */
5232 compute_tip_xy (f, parms, dx, dy, width, height, &root_x, &root_y);
5234 BLOCK_INPUT;
5235 XMoveResizeWindow (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
5236 root_x, root_y, width, height);
5237 XMapRaised (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f));
5238 UNBLOCK_INPUT;
5240 /* Draw into the window. */
5241 w->must_be_updated_p = 1;
5242 update_single_window (w, 1);
5244 /* Restore original current buffer. */
5245 set_buffer_internal_1 (old_buffer);
5246 windows_or_buffers_changed = old_windows_or_buffers_changed;
5248 start_timer:
5249 /* Let the tip disappear after timeout seconds. */
5250 tip_timer = call3 (intern ("run-at-time"), timeout, Qnil,
5251 intern ("x-hide-tip"));
5253 UNGCPRO;
5254 return unbind_to (count, Qnil);
5258 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
5259 doc: /* Hide the current tooltip window, if there is any.
5260 Value is t if tooltip was open, nil otherwise. */)
5263 int count;
5264 Lisp_Object deleted, frame, timer;
5265 struct gcpro gcpro1, gcpro2;
5267 /* Return quickly if nothing to do. */
5268 if (NILP (tip_timer) && NILP (tip_frame))
5269 return Qnil;
5271 frame = tip_frame;
5272 timer = tip_timer;
5273 GCPRO2 (frame, timer);
5274 tip_frame = tip_timer = deleted = Qnil;
5276 count = SPECPDL_INDEX ();
5277 specbind (Qinhibit_redisplay, Qt);
5278 specbind (Qinhibit_quit, Qt);
5280 if (!NILP (timer))
5281 call1 (Qcancel_timer, timer);
5283 if (FRAMEP (frame))
5285 delete_frame (frame, Qnil);
5286 deleted = Qt;
5288 #ifdef USE_LUCID
5289 /* Bloodcurdling hack alert: The Lucid menu bar widget's
5290 redisplay procedure is not called when a tip frame over menu
5291 items is unmapped. Redisplay the menu manually... */
5293 struct frame *f = SELECTED_FRAME ();
5294 Widget w = f->output_data.x->menubar_widget;
5295 extern void xlwmenu_redisplay P_ ((Widget));
5297 if (!DoesSaveUnders (FRAME_X_DISPLAY_INFO (f)->screen)
5298 && w != NULL)
5300 BLOCK_INPUT;
5301 xlwmenu_redisplay (w);
5302 UNBLOCK_INPUT;
5305 #endif /* USE_LUCID */
5308 UNGCPRO;
5309 return unbind_to (count, deleted);
5314 /***********************************************************************
5315 File selection dialog
5316 ***********************************************************************/
5318 DEFUN ("x-uses-old-gtk-dialog", Fx_uses_old_gtk_dialog,
5319 Sx_uses_old_gtk_dialog,
5320 0, 0, 0,
5321 doc: /* Return t if the old Gtk+ file selection dialog is used. */)
5324 #ifdef USE_GTK
5325 extern int use_dialog_box;
5326 extern int use_file_dialog;
5328 if (use_dialog_box
5329 && use_file_dialog
5330 && have_menus_p ()
5331 && xg_uses_old_file_dialog ())
5332 return Qt;
5333 #endif
5334 return Qnil;
5338 #ifdef USE_MOTIF
5339 /* Callback for "OK" and "Cancel" on file selection dialog. */
5341 static void
5342 file_dialog_cb (widget, client_data, call_data)
5343 Widget widget;
5344 XtPointer call_data, client_data;
5346 int *result = (int *) client_data;
5347 XmAnyCallbackStruct *cb = (XmAnyCallbackStruct *) call_data;
5348 *result = cb->reason;
5352 /* Callback for unmapping a file selection dialog. This is used to
5353 capture the case where a dialog is closed via a window manager's
5354 closer button, for example. Using a XmNdestroyCallback didn't work
5355 in this case. */
5357 static void
5358 file_dialog_unmap_cb (widget, client_data, call_data)
5359 Widget widget;
5360 XtPointer call_data, client_data;
5362 int *result = (int *) client_data;
5363 *result = XmCR_CANCEL;
5366 static Lisp_Object
5367 clean_up_file_dialog (arg)
5368 Lisp_Object arg;
5370 struct Lisp_Save_Value *p = XSAVE_VALUE (arg);
5371 Widget dialog = (Widget) p->pointer;
5373 /* Clean up. */
5374 BLOCK_INPUT;
5375 XtUnmanageChild (dialog);
5376 XtDestroyWidget (dialog);
5377 x_menu_set_in_use (0);
5378 UNBLOCK_INPUT;
5380 return Qnil;
5384 DEFUN ("x-file-dialog", Fx_file_dialog, Sx_file_dialog, 2, 5, 0,
5385 doc: /* Read file name, prompting with PROMPT in directory DIR.
5386 Use a file selection dialog. Select DEFAULT-FILENAME in the dialog's file
5387 selection box, if specified. If MUSTMATCH is non-nil, the returned file
5388 or directory must exist. ONLY-DIR-P is ignored." */)
5389 (prompt, dir, default_filename, mustmatch, only_dir_p)
5390 Lisp_Object prompt, dir, default_filename, mustmatch, only_dir_p;
5392 int result;
5393 struct frame *f = SELECTED_FRAME ();
5394 Lisp_Object file = Qnil;
5395 Lisp_Object decoded_file;
5396 Widget dialog, text, help;
5397 Arg al[10];
5398 int ac = 0;
5399 extern XtAppContext Xt_app_con;
5400 XmString dir_xmstring, pattern_xmstring;
5401 int count = SPECPDL_INDEX ();
5402 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
5404 check_x ();
5406 GCPRO6 (prompt, dir, default_filename, mustmatch, only_dir_p, file);
5408 if (popup_activated ())
5409 error ("Trying to use a menu from within a menu-entry");
5411 CHECK_STRING (prompt);
5412 CHECK_STRING (dir);
5414 /* Prevent redisplay. */
5415 specbind (Qinhibit_redisplay, Qt);
5417 BLOCK_INPUT;
5419 /* Create the dialog with PROMPT as title, using DIR as initial
5420 directory and using "*" as pattern. */
5421 dir = Fexpand_file_name (dir, Qnil);
5422 dir_xmstring = XmStringCreateLocalized (SDATA (dir));
5423 pattern_xmstring = XmStringCreateLocalized ("*");
5425 XtSetArg (al[ac], XmNtitle, SDATA (prompt)); ++ac;
5426 XtSetArg (al[ac], XmNdirectory, dir_xmstring); ++ac;
5427 XtSetArg (al[ac], XmNpattern, pattern_xmstring); ++ac;
5428 XtSetArg (al[ac], XmNresizePolicy, XmRESIZE_GROW); ++ac;
5429 XtSetArg (al[ac], XmNdialogStyle, XmDIALOG_APPLICATION_MODAL); ++ac;
5430 dialog = XmCreateFileSelectionDialog (f->output_data.x->widget,
5431 "fsb", al, ac);
5432 XmStringFree (dir_xmstring);
5433 XmStringFree (pattern_xmstring);
5435 /* Add callbacks for OK and Cancel. */
5436 XtAddCallback (dialog, XmNokCallback, file_dialog_cb,
5437 (XtPointer) &result);
5438 XtAddCallback (dialog, XmNcancelCallback, file_dialog_cb,
5439 (XtPointer) &result);
5440 XtAddCallback (dialog, XmNunmapCallback, file_dialog_unmap_cb,
5441 (XtPointer) &result);
5443 /* Remove the help button since we can't display help. */
5444 help = XmFileSelectionBoxGetChild (dialog, XmDIALOG_HELP_BUTTON);
5445 XtUnmanageChild (help);
5447 /* Mark OK button as default. */
5448 XtVaSetValues (XmFileSelectionBoxGetChild (dialog, XmDIALOG_OK_BUTTON),
5449 XmNshowAsDefault, True, NULL);
5451 /* If MUSTMATCH is non-nil, disable the file entry field of the
5452 dialog, so that the user must select a file from the files list
5453 box. We can't remove it because we wouldn't have a way to get at
5454 the result file name, then. */
5455 text = XmFileSelectionBoxGetChild (dialog, XmDIALOG_TEXT);
5456 if (!NILP (mustmatch))
5458 Widget label;
5459 label = XmFileSelectionBoxGetChild (dialog, XmDIALOG_SELECTION_LABEL);
5460 XtSetSensitive (text, False);
5461 XtSetSensitive (label, False);
5464 /* Manage the dialog, so that list boxes get filled. */
5465 XtManageChild (dialog);
5467 if (STRINGP (default_filename))
5469 XmString default_xmstring;
5470 Widget wtext = XmFileSelectionBoxGetChild (dialog, XmDIALOG_TEXT);
5471 Widget list = XmFileSelectionBoxGetChild (dialog, XmDIALOG_LIST);
5473 XmTextPosition last_pos = XmTextFieldGetLastPosition (wtext);
5474 XmTextFieldReplace (wtext, 0, last_pos,
5475 (SDATA (Ffile_name_nondirectory (default_filename))));
5477 /* Select DEFAULT_FILENAME in the files list box. DEFAULT_FILENAME
5478 must include the path for this to work. */
5480 default_xmstring = XmStringCreateLocalized (SDATA (default_filename));
5482 if (XmListItemExists (list, default_xmstring))
5484 int item_pos = XmListItemPos (list, default_xmstring);
5485 /* Select the item and scroll it into view. */
5486 XmListSelectPos (list, item_pos, True);
5487 XmListSetPos (list, item_pos);
5490 XmStringFree (default_xmstring);
5493 record_unwind_protect (clean_up_file_dialog, make_save_value (dialog, 0));
5495 /* Process events until the user presses Cancel or OK. */
5496 x_menu_set_in_use (1);
5497 result = 0;
5498 while (result == 0)
5500 XEvent event;
5501 x_menu_wait_for_event (0);
5502 XtAppNextEvent (Xt_app_con, &event);
5503 if (event.type == KeyPress
5504 && FRAME_X_DISPLAY (f) == event.xkey.display)
5506 KeySym keysym = XLookupKeysym (&event.xkey, 0);
5508 /* Pop down on C-g. */
5509 if (keysym == XK_g && (event.xkey.state & ControlMask) != 0)
5510 XtUnmanageChild (dialog);
5513 (void) x_dispatch_event (&event, FRAME_X_DISPLAY (f));
5516 /* Get the result. */
5517 if (result == XmCR_OK)
5519 XmString text;
5520 String data;
5522 XtVaGetValues (dialog, XmNtextString, &text, NULL);
5523 XmStringGetLtoR (text, XmFONTLIST_DEFAULT_TAG, &data);
5524 XmStringFree (text);
5525 file = build_string (data);
5526 XtFree (data);
5528 else
5529 file = Qnil;
5531 UNBLOCK_INPUT;
5532 UNGCPRO;
5534 /* Make "Cancel" equivalent to C-g. */
5535 if (NILP (file))
5536 Fsignal (Qquit, Qnil);
5538 decoded_file = DECODE_FILE (file);
5540 return unbind_to (count, decoded_file);
5543 #endif /* USE_MOTIF */
5545 #ifdef USE_GTK
5547 static Lisp_Object
5548 clean_up_dialog (arg)
5549 Lisp_Object arg;
5551 x_menu_set_in_use (0);
5553 return Qnil;
5556 DEFUN ("x-file-dialog", Fx_file_dialog, Sx_file_dialog, 2, 5, 0,
5557 doc: /* Read file name, prompting with PROMPT in directory DIR.
5558 Use a file selection dialog. Select DEFAULT-FILENAME in the dialog's file
5559 selection box, if specified. If MUSTMATCH is non-nil, the returned file
5560 or directory must exist. If ONLY-DIR-P is non-nil, the user can only select
5561 directories. */)
5562 (prompt, dir, default_filename, mustmatch, only_dir_p)
5563 Lisp_Object prompt, dir, default_filename, mustmatch, only_dir_p;
5565 FRAME_PTR f = SELECTED_FRAME ();
5566 char *fn;
5567 Lisp_Object file = Qnil;
5568 Lisp_Object decoded_file;
5569 int count = SPECPDL_INDEX ();
5570 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
5571 char *cdef_file;
5573 check_x ();
5575 GCPRO6 (prompt, dir, default_filename, mustmatch, only_dir_p, file);
5577 if (popup_activated ())
5578 error ("Trying to use a menu from within a menu-entry");
5580 CHECK_STRING (prompt);
5581 CHECK_STRING (dir);
5583 /* Prevent redisplay. */
5584 specbind (Qinhibit_redisplay, Qt);
5585 record_unwind_protect (clean_up_dialog, Qnil);
5587 BLOCK_INPUT;
5589 if (STRINGP (default_filename))
5590 cdef_file = SDATA (default_filename);
5591 else
5592 cdef_file = SDATA (dir);
5594 fn = xg_get_file_name (f, SDATA (prompt), cdef_file,
5595 ! NILP (mustmatch),
5596 ! NILP (only_dir_p));
5598 if (fn)
5600 file = build_string (fn);
5601 xfree (fn);
5604 UNBLOCK_INPUT;
5605 UNGCPRO;
5607 /* Make "Cancel" equivalent to C-g. */
5608 if (NILP (file))
5609 Fsignal (Qquit, Qnil);
5611 decoded_file = DECODE_FILE (file);
5613 return unbind_to (count, decoded_file);
5617 #ifdef HAVE_FREETYPE
5619 DEFUN ("x-select-font", Fx_select_font, Sx_select_font, 0, 2, 0,
5620 doc: /* Read a font name using a GTK font selection dialog.
5621 Return a GTK-style font string corresponding to the selection.
5623 If FRAME is omitted or nil, it defaults to the selected frame. */)
5624 (frame, ignored)
5625 Lisp_Object frame, ignored;
5627 FRAME_PTR f = check_x_frame (frame);
5628 char *name;
5629 Lisp_Object default_font, font = Qnil;
5630 int count = SPECPDL_INDEX ();
5632 check_x ();
5634 if (popup_activated ())
5635 error ("Trying to use a menu from within a menu-entry");
5637 /* Prevent redisplay. */
5638 specbind (Qinhibit_redisplay, Qt);
5639 record_unwind_protect (clean_up_dialog, Qnil);
5641 BLOCK_INPUT;
5643 XSETFONT (default_font, FRAME_FONT (f));
5644 if (FONTP (default_font))
5646 char *default_name = alloca (256);
5647 if (font_unparse_gtkname (default_font, f, default_name, 256) < 0)
5648 default_name = NULL;
5649 name = xg_get_font_name (f, default_name);
5651 else
5652 name = xg_get_font_name (f, NULL);
5654 if (name)
5656 font = build_string (name);
5657 xfree (name);
5660 UNBLOCK_INPUT;
5662 if (NILP (font))
5663 Fsignal (Qquit, Qnil);
5665 return unbind_to (count, font);
5667 #endif /* HAVE_FREETYPE */
5669 #endif /* USE_GTK */
5672 /***********************************************************************
5673 Keyboard
5674 ***********************************************************************/
5676 #ifdef HAVE_XKBGETKEYBOARD
5677 #include <X11/XKBlib.h>
5678 #include <X11/keysym.h>
5679 #endif
5681 DEFUN ("x-backspace-delete-keys-p", Fx_backspace_delete_keys_p,
5682 Sx_backspace_delete_keys_p, 0, 1, 0,
5683 doc: /* Check if both Backspace and Delete keys are on the keyboard of FRAME.
5684 FRAME nil means use the selected frame.
5685 Value is t if we know that both keys are present, and are mapped to the
5686 usual X keysyms. Value is `lambda' if we cannot determine if both keys are
5687 present and mapped to the usual X keysyms. */)
5688 (frame)
5689 Lisp_Object frame;
5691 #ifdef HAVE_XKBGETKEYBOARD
5692 XkbDescPtr kb;
5693 struct frame *f = check_x_frame (frame);
5694 Display *dpy = FRAME_X_DISPLAY (f);
5695 Lisp_Object have_keys;
5696 int major, minor, op, event, error;
5698 BLOCK_INPUT;
5700 /* Check library version in case we're dynamically linked. */
5701 major = XkbMajorVersion;
5702 minor = XkbMinorVersion;
5703 if (!XkbLibraryVersion (&major, &minor))
5705 UNBLOCK_INPUT;
5706 return Qlambda;
5709 /* Check that the server supports XKB. */
5710 major = XkbMajorVersion;
5711 minor = XkbMinorVersion;
5712 if (!XkbQueryExtension (dpy, &op, &event, &error, &major, &minor))
5714 UNBLOCK_INPUT;
5715 return Qlambda;
5718 /* In this code we check that the keyboard has physical keys with names
5719 that start with BKSP (Backspace) and DELE (Delete), and that they
5720 generate keysym XK_BackSpace and XK_Delete respectively.
5721 This function is used to test if normal-erase-is-backspace should be
5722 turned on.
5723 An alternative approach would be to just check if XK_BackSpace and
5724 XK_Delete are mapped to any key. But if any of those are mapped to
5725 some non-intuitive key combination (Meta-Shift-Ctrl-whatever) and the
5726 user doesn't know about it, it is better to return false here.
5727 It is more obvious to the user what to do if she/he has two keys
5728 clearly marked with names/symbols and one key does something not
5729 expected (i.e. she/he then tries the other).
5730 The cases where Backspace/Delete is mapped to some other key combination
5731 are rare, and in those cases, normal-erase-is-backspace can be turned on
5732 manually. */
5734 have_keys = Qnil;
5735 kb = XkbGetMap (dpy, XkbAllMapComponentsMask, XkbUseCoreKbd);
5736 if (kb)
5738 int delete_keycode = 0, backspace_keycode = 0, i;
5740 if (XkbGetNames (dpy, XkbAllNamesMask, kb) == Success)
5742 for (i = kb->min_key_code;
5743 (i < kb->max_key_code
5744 && (delete_keycode == 0 || backspace_keycode == 0));
5745 ++i)
5747 /* The XKB symbolic key names can be seen most easily in
5748 the PS file generated by `xkbprint -label name
5749 $DISPLAY'. */
5750 if (bcmp ("DELE", kb->names->keys[i].name, 4) == 0)
5751 delete_keycode = i;
5752 else if (bcmp ("BKSP", kb->names->keys[i].name, 4) == 0)
5753 backspace_keycode = i;
5756 XkbFreeNames (kb, 0, True);
5759 XkbFreeClientMap (kb, 0, True);
5761 if (delete_keycode
5762 && backspace_keycode
5763 && XKeysymToKeycode (dpy, XK_Delete) == delete_keycode
5764 && XKeysymToKeycode (dpy, XK_BackSpace) == backspace_keycode)
5765 have_keys = Qt;
5767 UNBLOCK_INPUT;
5768 return have_keys;
5769 #else /* not HAVE_XKBGETKEYBOARD */
5770 return Qlambda;
5771 #endif /* not HAVE_XKBGETKEYBOARD */
5776 /***********************************************************************
5777 Initialization
5778 ***********************************************************************/
5780 /* Keep this list in the same order as frame_parms in frame.c.
5781 Use 0 for unsupported frame parameters. */
5783 frame_parm_handler x_frame_parm_handlers[] =
5785 x_set_autoraise,
5786 x_set_autolower,
5787 x_set_background_color,
5788 x_set_border_color,
5789 x_set_border_width,
5790 x_set_cursor_color,
5791 x_set_cursor_type,
5792 x_set_font,
5793 x_set_foreground_color,
5794 x_set_icon_name,
5795 x_set_icon_type,
5796 x_set_internal_border_width,
5797 x_set_menu_bar_lines,
5798 x_set_mouse_color,
5799 x_explicitly_set_name,
5800 x_set_scroll_bar_width,
5801 x_set_title,
5802 x_set_unsplittable,
5803 x_set_vertical_scroll_bars,
5804 x_set_visibility,
5805 x_set_tool_bar_lines,
5806 x_set_scroll_bar_foreground,
5807 x_set_scroll_bar_background,
5808 x_set_screen_gamma,
5809 x_set_line_spacing,
5810 x_set_fringe_width,
5811 x_set_fringe_width,
5812 x_set_wait_for_wm,
5813 x_set_fullscreen,
5814 x_set_font_backend,
5815 x_set_alpha,
5816 x_set_sticky,
5819 void
5820 syms_of_xfns ()
5822 /* This is zero if not using X windows. */
5823 x_in_use = 0;
5825 /* The section below is built by the lisp expression at the top of the file,
5826 just above where these variables are declared. */
5827 /*&&& init symbols here &&&*/
5828 Qnone = intern ("none");
5829 staticpro (&Qnone);
5830 Qsuppress_icon = intern ("suppress-icon");
5831 staticpro (&Qsuppress_icon);
5832 Qundefined_color = intern ("undefined-color");
5833 staticpro (&Qundefined_color);
5834 Qcompound_text = intern ("compound-text");
5835 staticpro (&Qcompound_text);
5836 Qcancel_timer = intern ("cancel-timer");
5837 staticpro (&Qcancel_timer);
5838 Qfont_param = intern ("font-parameter");
5839 staticpro (&Qfont_param);
5840 /* This is the end of symbol initialization. */
5842 /* Text property `display' should be nonsticky by default. */
5843 Vtext_property_default_nonsticky
5844 = Fcons (Fcons (Qdisplay, Qt), Vtext_property_default_nonsticky);
5847 Fput (Qundefined_color, Qerror_conditions,
5848 Fcons (Qundefined_color, Fcons (Qerror, Qnil)));
5849 Fput (Qundefined_color, Qerror_message,
5850 build_string ("Undefined color"));
5852 DEFVAR_LISP ("x-pointer-shape", &Vx_pointer_shape,
5853 doc: /* The shape of the pointer when over text.
5854 Changing the value does not affect existing frames
5855 unless you set the mouse color. */);
5856 Vx_pointer_shape = Qnil;
5858 #if 0 /* This doesn't really do anything. */
5859 DEFVAR_LISP ("x-nontext-pointer-shape", &Vx_nontext_pointer_shape,
5860 doc: /* The shape of the pointer when not over text.
5861 This variable takes effect when you create a new frame
5862 or when you set the mouse color. */);
5863 #endif
5864 Vx_nontext_pointer_shape = Qnil;
5866 DEFVAR_LISP ("x-hourglass-pointer-shape", &Vx_hourglass_pointer_shape,
5867 doc: /* The shape of the pointer when Emacs is busy.
5868 This variable takes effect when you create a new frame
5869 or when you set the mouse color. */);
5870 Vx_hourglass_pointer_shape = Qnil;
5872 #if 0 /* This doesn't really do anything. */
5873 DEFVAR_LISP ("x-mode-pointer-shape", &Vx_mode_pointer_shape,
5874 doc: /* The shape of the pointer when over the mode line.
5875 This variable takes effect when you create a new frame
5876 or when you set the mouse color. */);
5877 #endif
5878 Vx_mode_pointer_shape = Qnil;
5880 DEFVAR_LISP ("x-sensitive-text-pointer-shape",
5881 &Vx_sensitive_text_pointer_shape,
5882 doc: /* The shape of the pointer when over mouse-sensitive text.
5883 This variable takes effect when you create a new frame
5884 or when you set the mouse color. */);
5885 Vx_sensitive_text_pointer_shape = Qnil;
5887 DEFVAR_LISP ("x-window-horizontal-drag-cursor",
5888 &Vx_window_horizontal_drag_shape,
5889 doc: /* Pointer shape to use for indicating a window can be dragged horizontally.
5890 This variable takes effect when you create a new frame
5891 or when you set the mouse color. */);
5892 Vx_window_horizontal_drag_shape = Qnil;
5894 DEFVAR_LISP ("x-cursor-fore-pixel", &Vx_cursor_fore_pixel,
5895 doc: /* A string indicating the foreground color of the cursor box. */);
5896 Vx_cursor_fore_pixel = Qnil;
5898 DEFVAR_LISP ("x-max-tooltip-size", &Vx_max_tooltip_size,
5899 doc: /* Maximum size for tooltips. Value is a pair (COLUMNS . ROWS).
5900 Text larger than this is clipped. */);
5901 Vx_max_tooltip_size = Fcons (make_number (80), make_number (40));
5903 DEFVAR_LISP ("x-no-window-manager", &Vx_no_window_manager,
5904 doc: /* Non-nil if no X window manager is in use.
5905 Emacs doesn't try to figure this out; this is always nil
5906 unless you set it to something else. */);
5907 /* We don't have any way to find this out, so set it to nil
5908 and maybe the user would like to set it to t. */
5909 Vx_no_window_manager = Qnil;
5911 DEFVAR_LISP ("x-pixel-size-width-font-regexp",
5912 &Vx_pixel_size_width_font_regexp,
5913 doc: /* Regexp matching a font name whose width is the same as `PIXEL_SIZE'.
5915 Since Emacs gets width of a font matching with this regexp from
5916 PIXEL_SIZE field of the name, font finding mechanism gets faster for
5917 such a font. This is especially effective for such large fonts as
5918 Chinese, Japanese, and Korean. */);
5919 Vx_pixel_size_width_font_regexp = Qnil;
5921 /* This is not ifdef:ed, so other builds than GTK can customize it. */
5922 DEFVAR_BOOL ("x-gtk-use-old-file-dialog", &x_gtk_use_old_file_dialog,
5923 doc: /* *Non-nil means prompt with the old GTK file selection dialog.
5924 If nil or if the file selection dialog is not available, the new GTK file
5925 chooser is used instead. To turn off all file dialogs set the
5926 variable `use-file-dialog'. */);
5927 x_gtk_use_old_file_dialog = 0;
5929 DEFVAR_BOOL ("x-gtk-show-hidden-files", &x_gtk_show_hidden_files,
5930 doc: /* *If non-nil, the GTK file chooser will by default show hidden files.
5931 Note that this is just the default, there is a toggle button on the file
5932 chooser to show or not show hidden files on a case by case basis. */);
5933 x_gtk_show_hidden_files = 0;
5935 DEFVAR_BOOL ("x-gtk-file-dialog-help-text", &x_gtk_file_dialog_help_text,
5936 doc: /* *If non-nil, the GTK file chooser will show additional help text.
5937 If more space for files in the file chooser dialog is wanted, set this to nil
5938 to turn the additional text off. */);
5939 x_gtk_file_dialog_help_text = 1;
5941 DEFVAR_BOOL ("x-gtk-whole-detached-tool-bar", &x_gtk_whole_detached_tool_bar,
5942 doc: /* *If non-nil, a detached tool bar is shown in full.
5943 The default is to just show an arrow and pressing on that arrow shows
5944 the tool bar buttons. */);
5945 x_gtk_whole_detached_tool_bar = 0;
5947 Fprovide (intern ("x"), Qnil);
5949 #ifdef USE_X_TOOLKIT
5950 Fprovide (intern ("x-toolkit"), Qnil);
5951 #ifdef USE_MOTIF
5952 Fprovide (intern ("motif"), Qnil);
5954 DEFVAR_LISP ("motif-version-string", &Vmotif_version_string,
5955 doc: /* Version info for LessTif/Motif. */);
5956 Vmotif_version_string = build_string (XmVERSION_STRING);
5957 #endif /* USE_MOTIF */
5958 #endif /* USE_X_TOOLKIT */
5960 #ifdef USE_GTK
5961 /* Provide x-toolkit also for GTK. Internally GTK does not use Xt so it
5962 is not an X toolkit in that sense (USE_X_TOOLKIT is not defined).
5963 But for a user it is a toolkit for X, and indeed, configure
5964 accepts --with-x-toolkit=gtk. */
5965 Fprovide (intern ("x-toolkit"), Qnil);
5966 Fprovide (intern ("gtk"), Qnil);
5968 DEFVAR_LISP ("gtk-version-string", &Vgtk_version_string,
5969 doc: /* Version info for GTK+. */);
5971 char gtk_version[40];
5972 g_snprintf (gtk_version, sizeof (gtk_version), "%u.%u.%u",
5973 GTK_MAJOR_VERSION, GTK_MINOR_VERSION, GTK_MICRO_VERSION);
5974 Vgtk_version_string = build_string (gtk_version);
5976 #endif /* USE_GTK */
5978 /* X window properties. */
5979 defsubr (&Sx_change_window_property);
5980 defsubr (&Sx_delete_window_property);
5981 defsubr (&Sx_window_property);
5983 defsubr (&Sxw_display_color_p);
5984 defsubr (&Sx_display_grayscale_p);
5985 defsubr (&Sxw_color_defined_p);
5986 defsubr (&Sxw_color_values);
5987 defsubr (&Sx_server_max_request_size);
5988 defsubr (&Sx_server_vendor);
5989 defsubr (&Sx_server_version);
5990 defsubr (&Sx_display_pixel_width);
5991 defsubr (&Sx_display_pixel_height);
5992 defsubr (&Sx_display_mm_width);
5993 defsubr (&Sx_display_mm_height);
5994 defsubr (&Sx_display_screens);
5995 defsubr (&Sx_display_planes);
5996 defsubr (&Sx_display_color_cells);
5997 defsubr (&Sx_display_visual_class);
5998 defsubr (&Sx_display_backing_store);
5999 defsubr (&Sx_display_save_under);
6000 defsubr (&Sx_wm_set_size_hint);
6001 defsubr (&Sx_create_frame);
6002 defsubr (&Sx_open_connection);
6003 defsubr (&Sx_close_connection);
6004 defsubr (&Sx_display_list);
6005 defsubr (&Sx_synchronize);
6006 defsubr (&Sx_focus_frame);
6007 defsubr (&Sx_backspace_delete_keys_p);
6009 /* Setting callback functions for fontset handler. */
6010 check_window_system_func = check_x;
6012 defsubr (&Sx_show_tip);
6013 defsubr (&Sx_hide_tip);
6014 tip_timer = Qnil;
6015 staticpro (&tip_timer);
6016 tip_frame = Qnil;
6017 staticpro (&tip_frame);
6019 last_show_tip_args = Qnil;
6020 staticpro (&last_show_tip_args);
6022 defsubr (&Sx_uses_old_gtk_dialog);
6023 #if defined (USE_MOTIF) || defined (USE_GTK)
6024 defsubr (&Sx_file_dialog);
6025 #endif
6027 #if defined (USE_GTK) && defined (HAVE_FREETYPE)
6028 defsubr (&Sx_select_font);
6029 #endif
6032 #endif /* HAVE_X_WINDOWS */
6034 /* arch-tag: 55040d02-5485-4d58-8b22-95a7a05f3288
6035 (do not change this comment) */