Merged from emacs@sv.gnu.org
[emacs.git] / src / xfns.c
blob3cadc8504f44e15961d95628bd3aa449d83b6d4c
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 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
10 any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
20 Boston, MA 02110-1301, USA. */
22 #include <config.h>
23 #include <stdio.h>
24 #include <math.h>
26 #ifdef HAVE_UNISTD_H
27 #include <unistd.h>
28 #endif
30 /* This makes the fields of a Display accessible, in Xlib header files. */
32 #define XLIB_ILLEGAL_ACCESS
34 #include "lisp.h"
35 #include "xterm.h"
36 #include "frame.h"
37 #include "window.h"
38 #include "buffer.h"
39 #include "intervals.h"
40 #include "dispextern.h"
41 #include "keyboard.h"
42 #include "blockinput.h"
43 #include <epaths.h>
44 #include "charset.h"
45 #include "coding.h"
46 #include "fontset.h"
47 #include "systime.h"
48 #include "termhooks.h"
49 #include "atimer.h"
50 #include "termchar.h"
52 #ifdef HAVE_X_WINDOWS
54 #include <ctype.h>
55 #include <sys/types.h>
56 #include <sys/stat.h>
58 #ifndef VMS
59 #if 1 /* Used to be #ifdef EMACS_BITMAP_FILES, but this should always work. */
60 #include "bitmaps/gray.xbm"
61 #else
62 #include <X11/bitmaps/gray>
63 #endif
64 #else
65 #include "[.bitmaps]gray.xbm"
66 #endif
68 #ifdef USE_GTK
69 #include "gtkutil.h"
70 #endif
72 #ifdef USE_X_TOOLKIT
73 #include <X11/Shell.h>
75 #ifndef USE_MOTIF
76 #include <X11/Xaw/Paned.h>
77 #include <X11/Xaw/Label.h>
78 #endif /* USE_MOTIF */
80 #ifdef USG
81 #undef USG /* ####KLUDGE for Solaris 2.2 and up */
82 #include <X11/Xos.h>
83 #define USG
84 #else
85 #include <X11/Xos.h>
86 #endif
88 #include "widget.h"
90 #include "../lwlib/lwlib.h"
92 #ifdef USE_MOTIF
93 #include <Xm/Xm.h>
94 #include <Xm/DialogS.h>
95 #include <Xm/FileSB.h>
96 #endif
98 /* Do the EDITRES protocol if running X11R5
99 Exception: HP-UX (at least version A.09.05) has X11R5 without EditRes */
101 #if (XtSpecificationRelease >= 5) && !defined(NO_EDITRES)
102 #define HACK_EDITRES
103 extern void _XEditResCheckMessages ();
104 #endif /* R5 + Athena */
106 /* Unique id counter for widgets created by the Lucid Widget Library. */
108 extern LWLIB_ID widget_id_tick;
110 #ifdef USE_LUCID
111 /* This is part of a kludge--see lwlib/xlwmenu.c. */
112 extern XFontStruct *xlwmenu_default_font;
113 #endif
115 extern void free_frame_menubar ();
116 extern double atof ();
118 #ifdef USE_MOTIF
120 /* LessTif/Motif version info. */
122 static Lisp_Object Vmotif_version_string;
124 #endif /* USE_MOTIF */
126 #endif /* USE_X_TOOLKIT */
128 #ifdef USE_GTK
130 /* GTK+ version info */
132 static Lisp_Object Vgtk_version_string;
134 #endif /* USE_GTK */
136 #ifdef HAVE_X11R4
137 #define MAXREQUEST(dpy) (XMaxRequestSize (dpy))
138 #else
139 #define MAXREQUEST(dpy) ((dpy)->max_request_size)
140 #endif
142 /* The gray bitmap `bitmaps/gray'. This is done because xterm.c uses
143 it, and including `bitmaps/gray' more than once is a problem when
144 config.h defines `static' as an empty replacement string. */
146 int gray_bitmap_width = gray_width;
147 int gray_bitmap_height = gray_height;
148 char *gray_bitmap_bits = gray_bits;
150 /* Non-zero means we're allowed to display an hourglass cursor. */
152 int display_hourglass_p;
154 /* Non-zero means prompt with the old GTK file selection dialog. */
156 int x_use_old_gtk_file_dialog;
158 /* If non-zero, by default show hidden files in the GTK file chooser. */
160 int x_gtk_show_hidden_files;
162 /* If non-zero, don't collapse to tool bar when it is detached. */
164 int x_gtk_whole_detached_tool_bar;
166 /* The background and shape of the mouse pointer, and shape when not
167 over text or in the modeline. */
169 Lisp_Object Vx_pointer_shape, Vx_nontext_pointer_shape, Vx_mode_pointer_shape;
170 Lisp_Object Vx_hourglass_pointer_shape;
172 /* The shape when over mouse-sensitive text. */
174 Lisp_Object Vx_sensitive_text_pointer_shape;
176 /* If non-nil, the pointer shape to indicate that windows can be
177 dragged horizontally. */
179 Lisp_Object Vx_window_horizontal_drag_shape;
181 /* Color of chars displayed in cursor box. */
183 Lisp_Object Vx_cursor_fore_pixel;
185 /* Nonzero if using X. */
187 static int x_in_use;
189 /* Non nil if no window manager is in use. */
191 Lisp_Object Vx_no_window_manager;
193 /* Regexp matching a font name whose width is the same as `PIXEL_SIZE'. */
195 Lisp_Object Vx_pixel_size_width_font_regexp;
197 Lisp_Object Qnone;
198 Lisp_Object Qsuppress_icon;
199 Lisp_Object Qundefined_color;
200 Lisp_Object Qcompound_text, Qcancel_timer;
202 /* In dispnew.c */
204 extern Lisp_Object Vwindow_system_version;
206 /* The below are defined in frame.c. */
208 #if GLYPH_DEBUG
209 int image_cache_refcount, dpyinfo_refcount;
210 #endif
214 /* Error if we are not connected to X. */
216 void
217 check_x ()
219 if (! x_in_use)
220 error ("X windows are not in use or not initialized");
223 /* Nonzero if we can use mouse menus.
224 You should not call this unless HAVE_MENUS is defined. */
227 have_menus_p ()
229 return x_in_use;
232 /* Extract a frame as a FRAME_PTR, defaulting to the selected frame
233 and checking validity for X. */
235 FRAME_PTR
236 check_x_frame (frame)
237 Lisp_Object frame;
239 FRAME_PTR f;
241 if (NILP (frame))
242 frame = selected_frame;
243 CHECK_LIVE_FRAME (frame);
244 f = XFRAME (frame);
245 if (! FRAME_X_P (f))
246 error ("Non-X frame used");
247 return f;
250 /* Let the user specify an X display with a Lisp object.
251 OBJECT may be nil, a frame or a terminal id.
252 nil stands for the selected frame--or, if that is not an X frame,
253 the first X display on the list. */
255 struct x_display_info *
256 check_x_display_info (object)
257 Lisp_Object object;
259 struct x_display_info *dpyinfo = NULL;
261 if (NILP (object))
263 struct frame *sf = XFRAME (selected_frame);
265 if (FRAME_X_P (sf) && FRAME_LIVE_P (sf))
266 dpyinfo = FRAME_X_DISPLAY_INFO (sf);
267 else if (x_display_list != 0)
268 dpyinfo = x_display_list;
269 else
270 error ("X windows are not in use or not initialized");
272 else if (INTEGERP (object))
274 struct terminal *t = get_terminal (XINT (object), 1);
276 if (t->type != output_x_window)
277 error ("Terminal %d is not an X display", XINT (object));
279 dpyinfo = t->display_info.x;
281 else if (STRINGP (object))
282 dpyinfo = x_display_info_for_name (object);
283 else
285 FRAME_PTR f = check_x_frame (object);
286 dpyinfo = FRAME_X_DISPLAY_INFO (f);
289 return dpyinfo;
293 /* Return the Emacs frame-object corresponding to an X window.
294 It could be the frame's main window or an icon window. */
296 /* This function can be called during GC, so use GC_xxx type test macros. */
298 struct frame *
299 x_window_to_frame (dpyinfo, wdesc)
300 struct x_display_info *dpyinfo;
301 int wdesc;
303 Lisp_Object tail, frame;
304 struct frame *f;
306 if (wdesc == None) return 0;
308 for (tail = Vframe_list; GC_CONSP (tail); tail = XCDR (tail))
310 frame = XCAR (tail);
311 if (!GC_FRAMEP (frame))
312 continue;
313 f = XFRAME (frame);
314 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
315 continue;
316 if (f->output_data.x->hourglass_window == wdesc)
317 return f;
318 #ifdef USE_X_TOOLKIT
319 if ((f->output_data.x->edit_widget
320 && XtWindow (f->output_data.x->edit_widget) == wdesc)
321 /* A tooltip frame? */
322 || (!f->output_data.x->edit_widget
323 && FRAME_X_WINDOW (f) == wdesc)
324 || f->output_data.x->icon_desc == wdesc)
325 return f;
326 #else /* not USE_X_TOOLKIT */
327 #ifdef USE_GTK
328 if (f->output_data.x->edit_widget)
330 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
331 struct x_output *x = f->output_data.x;
332 if (gwdesc != 0 && gwdesc == x->edit_widget)
333 return f;
335 #endif /* USE_GTK */
336 if (FRAME_X_WINDOW (f) == wdesc
337 || f->output_data.x->icon_desc == wdesc)
338 return f;
339 #endif /* not USE_X_TOOLKIT */
341 return 0;
344 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
345 /* Like x_window_to_frame but also compares the window with the widget's
346 windows. */
348 struct frame *
349 x_any_window_to_frame (dpyinfo, wdesc)
350 struct x_display_info *dpyinfo;
351 int wdesc;
353 Lisp_Object tail, frame;
354 struct frame *f, *found;
355 struct x_output *x;
357 if (wdesc == None) return NULL;
359 found = NULL;
360 for (tail = Vframe_list; GC_CONSP (tail) && !found; tail = XCDR (tail))
362 frame = XCAR (tail);
363 if (!GC_FRAMEP (frame))
364 continue;
366 f = XFRAME (frame);
367 if (FRAME_X_P (f) && FRAME_X_DISPLAY_INFO (f) == dpyinfo)
369 /* This frame matches if the window is any of its widgets. */
370 x = f->output_data.x;
371 if (x->hourglass_window == wdesc)
372 found = f;
373 else if (x->widget)
375 #ifdef USE_GTK
376 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
377 if (gwdesc != 0
378 && (gwdesc == x->widget
379 || gwdesc == x->edit_widget
380 || gwdesc == x->vbox_widget
381 || gwdesc == x->menubar_widget))
382 found = f;
383 #else
384 if (wdesc == XtWindow (x->widget)
385 || wdesc == XtWindow (x->column_widget)
386 || wdesc == XtWindow (x->edit_widget))
387 found = f;
388 /* Match if the window is this frame's menubar. */
389 else if (lw_window_is_in_menubar (wdesc, x->menubar_widget))
390 found = f;
391 #endif
393 else if (FRAME_X_WINDOW (f) == wdesc)
394 /* A tooltip frame. */
395 found = f;
399 return found;
402 /* Likewise, but exclude the menu bar widget. */
404 struct frame *
405 x_non_menubar_window_to_frame (dpyinfo, wdesc)
406 struct x_display_info *dpyinfo;
407 int wdesc;
409 Lisp_Object tail, frame;
410 struct frame *f;
411 struct x_output *x;
413 if (wdesc == None) return 0;
415 for (tail = Vframe_list; GC_CONSP (tail); tail = XCDR (tail))
417 frame = XCAR (tail);
418 if (!GC_FRAMEP (frame))
419 continue;
420 f = XFRAME (frame);
421 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
422 continue;
423 x = f->output_data.x;
424 /* This frame matches if the window is any of its widgets. */
425 if (x->hourglass_window == wdesc)
426 return f;
427 else if (x->widget)
429 #ifdef USE_GTK
430 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
431 if (gwdesc != 0
432 && (gwdesc == x->widget
433 || gwdesc == x->edit_widget
434 || gwdesc == x->vbox_widget))
435 return f;
436 #else
437 if (wdesc == XtWindow (x->widget)
438 || wdesc == XtWindow (x->column_widget)
439 || wdesc == XtWindow (x->edit_widget))
440 return f;
441 #endif
443 else if (FRAME_X_WINDOW (f) == wdesc)
444 /* A tooltip frame. */
445 return f;
447 return 0;
450 /* Likewise, but consider only the menu bar widget. */
452 struct frame *
453 x_menubar_window_to_frame (dpyinfo, wdesc)
454 struct x_display_info *dpyinfo;
455 int wdesc;
457 Lisp_Object tail, frame;
458 struct frame *f;
459 struct x_output *x;
461 if (wdesc == None) return 0;
463 for (tail = Vframe_list; GC_CONSP (tail); tail = XCDR (tail))
465 frame = XCAR (tail);
466 if (!GC_FRAMEP (frame))
467 continue;
468 f = XFRAME (frame);
469 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
470 continue;
471 x = f->output_data.x;
472 /* Match if the window is this frame's menubar. */
473 #ifdef USE_GTK
474 if (x->menubar_widget)
476 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
477 int found = 0;
479 BLOCK_INPUT;
480 if (gwdesc != 0
481 && (gwdesc == x->menubar_widget
482 || gtk_widget_get_parent (gwdesc) == x->menubar_widget))
483 found = 1;
484 UNBLOCK_INPUT;
485 if (found) return f;
487 #else
488 if (x->menubar_widget
489 && lw_window_is_in_menubar (wdesc, x->menubar_widget))
490 return f;
491 #endif
493 return 0;
496 /* Return the frame whose principal (outermost) window is WDESC.
497 If WDESC is some other (smaller) window, we return 0. */
499 struct frame *
500 x_top_window_to_frame (dpyinfo, wdesc)
501 struct x_display_info *dpyinfo;
502 int wdesc;
504 Lisp_Object tail, frame;
505 struct frame *f;
506 struct x_output *x;
508 if (wdesc == None) return 0;
510 for (tail = Vframe_list; GC_CONSP (tail); tail = XCDR (tail))
512 frame = XCAR (tail);
513 if (!GC_FRAMEP (frame))
514 continue;
515 f = XFRAME (frame);
516 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
517 continue;
518 x = f->output_data.x;
520 if (x->widget)
522 /* This frame matches if the window is its topmost widget. */
523 #ifdef USE_GTK
524 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
525 if (gwdesc == x->widget)
526 return f;
527 #else
528 if (wdesc == XtWindow (x->widget))
529 return f;
530 #if 0 /* I don't know why it did this,
531 but it seems logically wrong,
532 and it causes trouble for MapNotify events. */
533 /* Match if the window is this frame's menubar. */
534 if (x->menubar_widget
535 && wdesc == XtWindow (x->menubar_widget))
536 return f;
537 #endif
538 #endif
540 else if (FRAME_X_WINDOW (f) == wdesc)
541 /* Tooltip frame. */
542 return f;
544 return 0;
546 #endif /* USE_X_TOOLKIT || USE_GTK */
550 static Lisp_Object unwind_create_frame P_ ((Lisp_Object));
551 static Lisp_Object unwind_create_tip_frame P_ ((Lisp_Object));
553 void x_set_foreground_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
554 static void x_set_wait_for_wm P_ ((struct frame *, Lisp_Object, Lisp_Object));
555 void x_set_background_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
556 void x_set_mouse_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
557 void x_set_cursor_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
558 void x_set_border_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
559 void x_set_cursor_type P_ ((struct frame *, Lisp_Object, Lisp_Object));
560 void x_set_icon_type P_ ((struct frame *, Lisp_Object, Lisp_Object));
561 void x_set_icon_name P_ ((struct frame *, Lisp_Object, Lisp_Object));
562 void x_explicitly_set_name P_ ((struct frame *, Lisp_Object, Lisp_Object));
563 void x_set_menu_bar_lines P_ ((struct frame *, Lisp_Object, Lisp_Object));
564 void x_set_title P_ ((struct frame *, Lisp_Object, Lisp_Object));
565 void x_set_tool_bar_lines P_ ((struct frame *, Lisp_Object, Lisp_Object));
566 void x_set_scroll_bar_foreground P_ ((struct frame *, Lisp_Object,
567 Lisp_Object));
568 void x_set_scroll_bar_background P_ ((struct frame *, Lisp_Object,
569 Lisp_Object));
570 static Lisp_Object x_default_scroll_bar_color_parameter P_ ((struct frame *,
571 Lisp_Object,
572 Lisp_Object,
573 char *, char *,
574 int));
577 /* Store the screen positions of frame F into XPTR and YPTR.
578 These are the positions of the containing window manager window,
579 not Emacs's own window. */
581 void
582 x_real_positions (f, xptr, yptr)
583 FRAME_PTR f;
584 int *xptr, *yptr;
586 int win_x, win_y, outer_x, outer_y;
587 int real_x = 0, real_y = 0;
588 int had_errors = 0;
589 Window win = f->output_data.x->parent_desc;
591 BLOCK_INPUT;
593 x_catch_errors (FRAME_X_DISPLAY (f));
595 if (win == FRAME_X_DISPLAY_INFO (f)->root_window)
596 win = FRAME_OUTER_WINDOW (f);
598 /* This loop traverses up the containment tree until we hit the root
599 window. Window managers may intersect many windows between our window
600 and the root window. The window we find just before the root window
601 should be the outer WM window. */
602 for (;;)
604 Window wm_window, rootw;
605 Window *tmp_children;
606 unsigned int tmp_nchildren;
607 int success;
609 success = XQueryTree (FRAME_X_DISPLAY (f), win, &rootw,
610 &wm_window, &tmp_children, &tmp_nchildren);
612 had_errors = x_had_errors_p (FRAME_X_DISPLAY (f));
614 /* Don't free tmp_children if XQueryTree failed. */
615 if (! success)
616 break;
618 XFree ((char *) tmp_children);
620 if (wm_window == rootw || had_errors)
621 break;
623 win = wm_window;
626 if (! had_errors)
628 unsigned int ign;
629 Window child, rootw;
631 /* Get the real coordinates for the WM window upper left corner */
632 XGetGeometry (FRAME_X_DISPLAY (f), win,
633 &rootw, &real_x, &real_y, &ign, &ign, &ign, &ign);
635 /* Translate real coordinates to coordinates relative to our
636 window. For our window, the upper left corner is 0, 0.
637 Since the upper left corner of the WM window is outside
638 our window, win_x and win_y will be negative:
640 ------------------ ---> x
641 | title |
642 | ----------------- v y
643 | | our window
645 XTranslateCoordinates (FRAME_X_DISPLAY (f),
647 /* From-window, to-window. */
648 FRAME_X_DISPLAY_INFO (f)->root_window,
649 FRAME_X_WINDOW (f),
651 /* From-position, to-position. */
652 real_x, real_y, &win_x, &win_y,
654 /* Child of win. */
655 &child);
657 if (FRAME_X_WINDOW (f) == FRAME_OUTER_WINDOW (f))
659 outer_x = win_x;
660 outer_y = win_y;
662 else
664 XTranslateCoordinates (FRAME_X_DISPLAY (f),
666 /* From-window, to-window. */
667 FRAME_X_DISPLAY_INFO (f)->root_window,
668 FRAME_OUTER_WINDOW (f),
670 /* From-position, to-position. */
671 real_x, real_y, &outer_x, &outer_y,
673 /* Child of win. */
674 &child);
677 had_errors = x_had_errors_p (FRAME_X_DISPLAY (f));
680 x_uncatch_errors ();
682 UNBLOCK_INPUT;
684 if (had_errors) return;
686 f->x_pixels_diff = -win_x;
687 f->y_pixels_diff = -win_y;
689 FRAME_X_OUTPUT (f)->x_pixels_outer_diff = -outer_x;
690 FRAME_X_OUTPUT (f)->y_pixels_outer_diff = -outer_y;
692 *xptr = real_x;
693 *yptr = real_y;
699 /* Gamma-correct COLOR on frame F. */
701 void
702 gamma_correct (f, color)
703 struct frame *f;
704 XColor *color;
706 if (f->gamma)
708 color->red = pow (color->red / 65535.0, f->gamma) * 65535.0 + 0.5;
709 color->green = pow (color->green / 65535.0, f->gamma) * 65535.0 + 0.5;
710 color->blue = pow (color->blue / 65535.0, f->gamma) * 65535.0 + 0.5;
715 /* Decide if color named COLOR_NAME is valid for use on frame F. If
716 so, return the RGB values in COLOR. If ALLOC_P is non-zero,
717 allocate the color. Value is zero if COLOR_NAME is invalid, or
718 no color could be allocated. */
721 x_defined_color (f, color_name, color, alloc_p)
722 struct frame *f;
723 char *color_name;
724 XColor *color;
725 int alloc_p;
727 int success_p;
728 Display *dpy = FRAME_X_DISPLAY (f);
729 Colormap cmap = FRAME_X_COLORMAP (f);
731 BLOCK_INPUT;
732 success_p = XParseColor (dpy, cmap, color_name, color);
733 if (success_p && alloc_p)
734 success_p = x_alloc_nearest_color (f, cmap, color);
735 UNBLOCK_INPUT;
737 return success_p;
741 /* Return the pixel color value for color COLOR_NAME on frame F. If F
742 is a monochrome frame, return MONO_COLOR regardless of what ARG says.
743 Signal an error if color can't be allocated. */
746 x_decode_color (f, color_name, mono_color)
747 FRAME_PTR f;
748 Lisp_Object color_name;
749 int mono_color;
751 XColor cdef;
753 CHECK_STRING (color_name);
755 #if 0 /* Don't do this. It's wrong when we're not using the default
756 colormap, it makes freeing difficult, and it's probably not
757 an important optimization. */
758 if (strcmp (SDATA (color_name), "black") == 0)
759 return BLACK_PIX_DEFAULT (f);
760 else if (strcmp (SDATA (color_name), "white") == 0)
761 return WHITE_PIX_DEFAULT (f);
762 #endif
764 /* Return MONO_COLOR for monochrome frames. */
765 if (FRAME_X_DISPLAY_INFO (f)->n_planes == 1)
766 return mono_color;
768 /* x_defined_color is responsible for coping with failures
769 by looking for a near-miss. */
770 if (x_defined_color (f, SDATA (color_name), &cdef, 1))
771 return cdef.pixel;
773 signal_error ("Undefined color", color_name);
778 /* Change the `wait-for-wm' frame parameter of frame F. OLD_VALUE is
779 the previous value of that parameter, NEW_VALUE is the new value.
780 See also the comment of wait_for_wm in struct x_output. */
782 static void
783 x_set_wait_for_wm (f, new_value, old_value)
784 struct frame *f;
785 Lisp_Object new_value, old_value;
787 f->output_data.x->wait_for_wm = !NILP (new_value);
790 #ifdef USE_GTK
792 /* Set icon from FILE for frame F. By using GTK functions the icon
793 may be any format that GdkPixbuf knows about, i.e. not just bitmaps. */
796 xg_set_icon (f, file)
797 FRAME_PTR f;
798 Lisp_Object file;
800 int result = 0;
801 Lisp_Object found;
803 found = x_find_image_file (file);
805 if (! NILP (found))
807 GdkPixbuf *pixbuf;
808 GError *err = NULL;
809 char *filename = (char *) SDATA (found);
810 BLOCK_INPUT;
812 pixbuf = gdk_pixbuf_new_from_file (filename, &err);
814 if (pixbuf)
816 gtk_window_set_icon (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)),
817 pixbuf);
818 g_object_unref (pixbuf);
820 result = 1;
822 else
823 g_error_free (err);
825 UNBLOCK_INPUT;
828 return result;
832 xg_set_icon_from_xpm_data (f, data)
833 FRAME_PTR f;
834 char **data;
836 int result = 0;
837 GdkPixbuf *pixbuf = gdk_pixbuf_new_from_xpm_data ((const char **) data);
839 if (!pixbuf)
840 return 0;
842 gtk_window_set_icon (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)), pixbuf);
843 g_object_unref (pixbuf);
844 return 1;
846 #endif /* USE_GTK */
849 /* Functions called only from `x_set_frame_param'
850 to set individual parameters.
852 If FRAME_X_WINDOW (f) is 0,
853 the frame is being created and its X-window does not exist yet.
854 In that case, just record the parameter's new value
855 in the standard place; do not attempt to change the window. */
857 void
858 x_set_foreground_color (f, arg, oldval)
859 struct frame *f;
860 Lisp_Object arg, oldval;
862 struct x_output *x = f->output_data.x;
863 unsigned long fg, old_fg;
865 fg = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
866 old_fg = FRAME_FOREGROUND_PIXEL (f);
867 FRAME_FOREGROUND_PIXEL (f) = fg;
869 if (FRAME_X_WINDOW (f) != 0)
871 Display *dpy = FRAME_X_DISPLAY (f);
873 BLOCK_INPUT;
874 XSetForeground (dpy, x->normal_gc, fg);
875 XSetBackground (dpy, x->reverse_gc, fg);
877 if (x->cursor_pixel == old_fg)
879 unload_color (f, x->cursor_pixel);
880 x->cursor_pixel = x_copy_color (f, fg);
881 XSetBackground (dpy, x->cursor_gc, x->cursor_pixel);
884 UNBLOCK_INPUT;
886 update_face_from_frame_parameter (f, Qforeground_color, arg);
888 if (FRAME_VISIBLE_P (f))
889 redraw_frame (f);
892 unload_color (f, old_fg);
895 void
896 x_set_background_color (f, arg, oldval)
897 struct frame *f;
898 Lisp_Object arg, oldval;
900 struct x_output *x = f->output_data.x;
901 unsigned long bg;
903 bg = x_decode_color (f, arg, WHITE_PIX_DEFAULT (f));
904 unload_color (f, FRAME_BACKGROUND_PIXEL (f));
905 FRAME_BACKGROUND_PIXEL (f) = bg;
907 if (FRAME_X_WINDOW (f) != 0)
909 Display *dpy = FRAME_X_DISPLAY (f);
911 BLOCK_INPUT;
912 XSetBackground (dpy, x->normal_gc, bg);
913 XSetForeground (dpy, x->reverse_gc, bg);
914 XSetWindowBackground (dpy, FRAME_X_WINDOW (f), bg);
915 XSetForeground (dpy, x->cursor_gc, bg);
917 #ifdef USE_GTK
918 xg_set_background_color (f, bg);
919 #endif
921 #ifndef USE_TOOLKIT_SCROLL_BARS /* Turns out to be annoying with
922 toolkit scroll bars. */
924 Lisp_Object bar;
925 for (bar = FRAME_SCROLL_BARS (f);
926 !NILP (bar);
927 bar = XSCROLL_BAR (bar)->next)
929 Window window = SCROLL_BAR_X_WINDOW (XSCROLL_BAR (bar));
930 XSetWindowBackground (dpy, window, bg);
933 #endif /* USE_TOOLKIT_SCROLL_BARS */
935 UNBLOCK_INPUT;
936 update_face_from_frame_parameter (f, Qbackground_color, arg);
938 if (FRAME_VISIBLE_P (f))
939 redraw_frame (f);
943 void
944 x_set_mouse_color (f, arg, oldval)
945 struct frame *f;
946 Lisp_Object arg, oldval;
948 struct x_output *x = f->output_data.x;
949 Display *dpy = FRAME_X_DISPLAY (f);
950 Cursor cursor, nontext_cursor, mode_cursor, hand_cursor;
951 Cursor hourglass_cursor, horizontal_drag_cursor;
952 unsigned long pixel = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
953 unsigned long mask_color = FRAME_BACKGROUND_PIXEL (f);
955 /* Don't let pointers be invisible. */
956 if (mask_color == pixel)
958 x_free_colors (f, &pixel, 1);
959 pixel = x_copy_color (f, FRAME_FOREGROUND_PIXEL (f));
962 unload_color (f, x->mouse_pixel);
963 x->mouse_pixel = pixel;
965 BLOCK_INPUT;
967 /* It's not okay to crash if the user selects a screwy cursor. */
968 x_catch_errors (dpy);
970 if (!NILP (Vx_pointer_shape))
972 CHECK_NUMBER (Vx_pointer_shape);
973 cursor = XCreateFontCursor (dpy, XINT (Vx_pointer_shape));
975 else
976 cursor = XCreateFontCursor (dpy, XC_xterm);
977 x_check_errors (dpy, "bad text pointer cursor: %s");
979 if (!NILP (Vx_nontext_pointer_shape))
981 CHECK_NUMBER (Vx_nontext_pointer_shape);
982 nontext_cursor
983 = XCreateFontCursor (dpy, XINT (Vx_nontext_pointer_shape));
985 else
986 nontext_cursor = XCreateFontCursor (dpy, XC_left_ptr);
987 x_check_errors (dpy, "bad nontext pointer cursor: %s");
989 if (!NILP (Vx_hourglass_pointer_shape))
991 CHECK_NUMBER (Vx_hourglass_pointer_shape);
992 hourglass_cursor
993 = XCreateFontCursor (dpy, XINT (Vx_hourglass_pointer_shape));
995 else
996 hourglass_cursor = XCreateFontCursor (dpy, XC_watch);
997 x_check_errors (dpy, "bad hourglass pointer cursor: %s");
999 if (!NILP (Vx_mode_pointer_shape))
1001 CHECK_NUMBER (Vx_mode_pointer_shape);
1002 mode_cursor = XCreateFontCursor (dpy, XINT (Vx_mode_pointer_shape));
1004 else
1005 mode_cursor = XCreateFontCursor (dpy, XC_xterm);
1006 x_check_errors (dpy, "bad modeline pointer cursor: %s");
1008 if (!NILP (Vx_sensitive_text_pointer_shape))
1010 CHECK_NUMBER (Vx_sensitive_text_pointer_shape);
1011 hand_cursor
1012 = XCreateFontCursor (dpy, XINT (Vx_sensitive_text_pointer_shape));
1014 else
1015 hand_cursor = XCreateFontCursor (dpy, XC_hand2);
1017 if (!NILP (Vx_window_horizontal_drag_shape))
1019 CHECK_NUMBER (Vx_window_horizontal_drag_shape);
1020 horizontal_drag_cursor
1021 = XCreateFontCursor (dpy, XINT (Vx_window_horizontal_drag_shape));
1023 else
1024 horizontal_drag_cursor
1025 = XCreateFontCursor (dpy, XC_sb_h_double_arrow);
1027 /* Check and report errors with the above calls. */
1028 x_check_errors (dpy, "can't set cursor shape: %s");
1029 x_uncatch_errors ();
1032 XColor fore_color, back_color;
1034 fore_color.pixel = x->mouse_pixel;
1035 x_query_color (f, &fore_color);
1036 back_color.pixel = mask_color;
1037 x_query_color (f, &back_color);
1039 XRecolorCursor (dpy, cursor, &fore_color, &back_color);
1040 XRecolorCursor (dpy, nontext_cursor, &fore_color, &back_color);
1041 XRecolorCursor (dpy, mode_cursor, &fore_color, &back_color);
1042 XRecolorCursor (dpy, hand_cursor, &fore_color, &back_color);
1043 XRecolorCursor (dpy, hourglass_cursor, &fore_color, &back_color);
1044 XRecolorCursor (dpy, horizontal_drag_cursor, &fore_color, &back_color);
1047 if (FRAME_X_WINDOW (f) != 0)
1048 XDefineCursor (dpy, FRAME_X_WINDOW (f), cursor);
1050 if (cursor != x->text_cursor
1051 && x->text_cursor != 0)
1052 XFreeCursor (dpy, x->text_cursor);
1053 x->text_cursor = cursor;
1055 if (nontext_cursor != x->nontext_cursor
1056 && x->nontext_cursor != 0)
1057 XFreeCursor (dpy, x->nontext_cursor);
1058 x->nontext_cursor = nontext_cursor;
1060 if (hourglass_cursor != x->hourglass_cursor
1061 && x->hourglass_cursor != 0)
1062 XFreeCursor (dpy, x->hourglass_cursor);
1063 x->hourglass_cursor = hourglass_cursor;
1065 if (mode_cursor != x->modeline_cursor
1066 && x->modeline_cursor != 0)
1067 XFreeCursor (dpy, f->output_data.x->modeline_cursor);
1068 x->modeline_cursor = mode_cursor;
1070 if (hand_cursor != x->hand_cursor
1071 && x->hand_cursor != 0)
1072 XFreeCursor (dpy, x->hand_cursor);
1073 x->hand_cursor = hand_cursor;
1075 if (horizontal_drag_cursor != x->horizontal_drag_cursor
1076 && x->horizontal_drag_cursor != 0)
1077 XFreeCursor (dpy, x->horizontal_drag_cursor);
1078 x->horizontal_drag_cursor = horizontal_drag_cursor;
1080 XFlush (dpy);
1081 UNBLOCK_INPUT;
1083 update_face_from_frame_parameter (f, Qmouse_color, arg);
1086 void
1087 x_set_cursor_color (f, arg, oldval)
1088 struct frame *f;
1089 Lisp_Object arg, oldval;
1091 unsigned long fore_pixel, pixel;
1092 int fore_pixel_allocated_p = 0, pixel_allocated_p = 0;
1093 struct x_output *x = f->output_data.x;
1095 if (!NILP (Vx_cursor_fore_pixel))
1097 fore_pixel = x_decode_color (f, Vx_cursor_fore_pixel,
1098 WHITE_PIX_DEFAULT (f));
1099 fore_pixel_allocated_p = 1;
1101 else
1102 fore_pixel = FRAME_BACKGROUND_PIXEL (f);
1104 pixel = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
1105 pixel_allocated_p = 1;
1107 /* Make sure that the cursor color differs from the background color. */
1108 if (pixel == FRAME_BACKGROUND_PIXEL (f))
1110 if (pixel_allocated_p)
1112 x_free_colors (f, &pixel, 1);
1113 pixel_allocated_p = 0;
1116 pixel = x->mouse_pixel;
1117 if (pixel == fore_pixel)
1119 if (fore_pixel_allocated_p)
1121 x_free_colors (f, &fore_pixel, 1);
1122 fore_pixel_allocated_p = 0;
1124 fore_pixel = FRAME_BACKGROUND_PIXEL (f);
1128 unload_color (f, x->cursor_foreground_pixel);
1129 if (!fore_pixel_allocated_p)
1130 fore_pixel = x_copy_color (f, fore_pixel);
1131 x->cursor_foreground_pixel = fore_pixel;
1133 unload_color (f, x->cursor_pixel);
1134 if (!pixel_allocated_p)
1135 pixel = x_copy_color (f, pixel);
1136 x->cursor_pixel = pixel;
1138 if (FRAME_X_WINDOW (f) != 0)
1140 BLOCK_INPUT;
1141 XSetBackground (FRAME_X_DISPLAY (f), x->cursor_gc, x->cursor_pixel);
1142 XSetForeground (FRAME_X_DISPLAY (f), x->cursor_gc, fore_pixel);
1143 UNBLOCK_INPUT;
1145 if (FRAME_VISIBLE_P (f))
1147 x_update_cursor (f, 0);
1148 x_update_cursor (f, 1);
1152 update_face_from_frame_parameter (f, Qcursor_color, arg);
1155 /* Set the border-color of frame F to pixel value PIX.
1156 Note that this does not fully take effect if done before
1157 F has an x-window. */
1159 void
1160 x_set_border_pixel (f, pix)
1161 struct frame *f;
1162 int pix;
1164 unload_color (f, f->output_data.x->border_pixel);
1165 f->output_data.x->border_pixel = pix;
1167 if (FRAME_X_WINDOW (f) != 0 && f->border_width > 0)
1169 BLOCK_INPUT;
1170 XSetWindowBorder (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1171 (unsigned long)pix);
1172 UNBLOCK_INPUT;
1174 if (FRAME_VISIBLE_P (f))
1175 redraw_frame (f);
1179 /* Set the border-color of frame F to value described by ARG.
1180 ARG can be a string naming a color.
1181 The border-color is used for the border that is drawn by the X server.
1182 Note that this does not fully take effect if done before
1183 F has an x-window; it must be redone when the window is created.
1185 Note: this is done in two routines because of the way X10 works.
1187 Note: under X11, this is normally the province of the window manager,
1188 and so emacs' border colors may be overridden. */
1190 void
1191 x_set_border_color (f, arg, oldval)
1192 struct frame *f;
1193 Lisp_Object arg, oldval;
1195 int pix;
1197 CHECK_STRING (arg);
1198 pix = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
1199 x_set_border_pixel (f, pix);
1200 update_face_from_frame_parameter (f, Qborder_color, arg);
1204 void
1205 x_set_cursor_type (f, arg, oldval)
1206 FRAME_PTR f;
1207 Lisp_Object arg, oldval;
1209 set_frame_cursor_types (f, arg);
1211 /* Make sure the cursor gets redrawn. */
1212 cursor_type_changed = 1;
1215 void
1216 x_set_icon_type (f, arg, oldval)
1217 struct frame *f;
1218 Lisp_Object arg, oldval;
1220 int result;
1222 if (STRINGP (arg))
1224 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
1225 return;
1227 else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
1228 return;
1230 BLOCK_INPUT;
1231 if (NILP (arg))
1232 result = x_text_icon (f,
1233 (char *) SDATA ((!NILP (f->icon_name)
1234 ? f->icon_name
1235 : f->name)));
1236 else
1237 result = x_bitmap_icon (f, arg);
1239 if (result)
1241 UNBLOCK_INPUT;
1242 error ("No icon window available");
1245 XFlush (FRAME_X_DISPLAY (f));
1246 UNBLOCK_INPUT;
1249 void
1250 x_set_icon_name (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 (!NILP (arg) || NILP (oldval))
1262 return;
1264 f->icon_name = arg;
1266 if (f->output_data.x->icon_bitmap != 0)
1267 return;
1269 BLOCK_INPUT;
1271 result = x_text_icon (f,
1272 (char *) SDATA ((!NILP (f->icon_name)
1273 ? f->icon_name
1274 : !NILP (f->title)
1275 ? f->title
1276 : f->name)));
1278 if (result)
1280 UNBLOCK_INPUT;
1281 error ("No icon window available");
1284 XFlush (FRAME_X_DISPLAY (f));
1285 UNBLOCK_INPUT;
1289 void
1290 x_set_menu_bar_lines (f, value, oldval)
1291 struct frame *f;
1292 Lisp_Object value, oldval;
1294 int nlines;
1295 #if ! defined (USE_X_TOOLKIT) && ! defined (USE_GTK)
1296 int olines = FRAME_MENU_BAR_LINES (f);
1297 #endif
1299 /* Right now, menu bars don't work properly in minibuf-only frames;
1300 most of the commands try to apply themselves to the minibuffer
1301 frame itself, and get an error because you can't switch buffers
1302 in or split the minibuffer window. */
1303 if (FRAME_MINIBUF_ONLY_P (f))
1304 return;
1306 if (INTEGERP (value))
1307 nlines = XINT (value);
1308 else
1309 nlines = 0;
1311 /* Make sure we redisplay all windows in this frame. */
1312 windows_or_buffers_changed++;
1314 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
1315 FRAME_MENU_BAR_LINES (f) = 0;
1316 if (nlines)
1318 FRAME_EXTERNAL_MENU_BAR (f) = 1;
1319 if (FRAME_X_P (f) && f->output_data.x->menubar_widget == 0)
1320 /* Make sure next redisplay shows the menu bar. */
1321 XWINDOW (FRAME_SELECTED_WINDOW (f))->update_mode_line = Qt;
1323 else
1325 if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
1326 free_frame_menubar (f);
1327 FRAME_EXTERNAL_MENU_BAR (f) = 0;
1328 if (FRAME_X_P (f))
1329 f->output_data.x->menubar_widget = 0;
1331 #else /* not USE_X_TOOLKIT && not USE_GTK */
1332 FRAME_MENU_BAR_LINES (f) = nlines;
1333 change_window_heights (f->root_window, nlines - olines);
1334 #endif /* not USE_X_TOOLKIT */
1335 adjust_glyphs (f);
1339 /* Set the number of lines used for the tool bar of frame F to VALUE.
1340 VALUE not an integer, or < 0 means set the lines to zero. OLDVAL
1341 is the old number of tool bar lines. This function changes the
1342 height of all windows on frame F to match the new tool bar height.
1343 The frame's height doesn't change. */
1345 void
1346 x_set_tool_bar_lines (f, value, oldval)
1347 struct frame *f;
1348 Lisp_Object value, oldval;
1350 int delta, nlines, root_height;
1351 Lisp_Object root_window;
1353 /* Treat tool bars like menu bars. */
1354 if (FRAME_MINIBUF_ONLY_P (f))
1355 return;
1357 /* Use VALUE only if an integer >= 0. */
1358 if (INTEGERP (value) && XINT (value) >= 0)
1359 nlines = XFASTINT (value);
1360 else
1361 nlines = 0;
1363 #ifdef USE_GTK
1364 FRAME_TOOL_BAR_LINES (f) = 0;
1365 if (nlines)
1367 FRAME_EXTERNAL_TOOL_BAR (f) = 1;
1368 if (FRAME_X_P (f) && f->output_data.x->toolbar_widget == 0)
1369 /* Make sure next redisplay shows the tool bar. */
1370 XWINDOW (FRAME_SELECTED_WINDOW (f))->update_mode_line = Qt;
1371 update_frame_tool_bar (f);
1373 else
1375 if (FRAME_EXTERNAL_TOOL_BAR (f))
1376 free_frame_tool_bar (f);
1377 FRAME_EXTERNAL_TOOL_BAR (f) = 0;
1380 return;
1381 #endif
1383 /* Make sure we redisplay all windows in this frame. */
1384 ++windows_or_buffers_changed;
1386 delta = nlines - FRAME_TOOL_BAR_LINES (f);
1388 /* Don't resize the tool-bar to more than we have room for. */
1389 root_window = FRAME_ROOT_WINDOW (f);
1390 root_height = WINDOW_TOTAL_LINES (XWINDOW (root_window));
1391 if (root_height - delta < 1)
1393 delta = root_height - 1;
1394 nlines = FRAME_TOOL_BAR_LINES (f) + delta;
1397 FRAME_TOOL_BAR_LINES (f) = nlines;
1398 change_window_heights (root_window, delta);
1399 adjust_glyphs (f);
1401 /* We also have to make sure that the internal border at the top of
1402 the frame, below the menu bar or tool bar, is redrawn when the
1403 tool bar disappears. This is so because the internal border is
1404 below the tool bar if one is displayed, but is below the menu bar
1405 if there isn't a tool bar. The tool bar draws into the area
1406 below the menu bar. */
1407 if (FRAME_X_WINDOW (f) && FRAME_TOOL_BAR_LINES (f) == 0)
1409 clear_frame (f);
1410 clear_current_matrices (f);
1413 /* If the tool bar gets smaller, the internal border below it
1414 has to be cleared. It was formerly part of the display
1415 of the larger tool bar, and updating windows won't clear it. */
1416 if (delta < 0)
1418 int height = FRAME_INTERNAL_BORDER_WIDTH (f);
1419 int width = FRAME_PIXEL_WIDTH (f);
1420 int y = nlines * FRAME_LINE_HEIGHT (f);
1422 /* height can be zero here. */
1423 if (height > 0 && width > 0)
1425 BLOCK_INPUT;
1426 x_clear_area (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1427 0, y, width, height, False);
1428 UNBLOCK_INPUT;
1431 if (WINDOWP (f->tool_bar_window))
1432 clear_glyph_matrix (XWINDOW (f->tool_bar_window)->current_matrix);
1437 /* Set the foreground color for scroll bars on frame F to VALUE.
1438 VALUE should be a string, a color name. If it isn't a string or
1439 isn't a valid color name, do nothing. OLDVAL is the old value of
1440 the frame parameter. */
1442 void
1443 x_set_scroll_bar_foreground (f, value, oldval)
1444 struct frame *f;
1445 Lisp_Object value, oldval;
1447 unsigned long pixel;
1449 if (STRINGP (value))
1450 pixel = x_decode_color (f, value, BLACK_PIX_DEFAULT (f));
1451 else
1452 pixel = -1;
1454 if (f->output_data.x->scroll_bar_foreground_pixel != -1)
1455 unload_color (f, f->output_data.x->scroll_bar_foreground_pixel);
1457 f->output_data.x->scroll_bar_foreground_pixel = pixel;
1458 if (FRAME_X_WINDOW (f) && FRAME_VISIBLE_P (f))
1460 /* Remove all scroll bars because they have wrong colors. */
1461 if (FRAME_TERMINAL (f)->condemn_scroll_bars_hook)
1462 (*FRAME_TERMINAL (f)->condemn_scroll_bars_hook) (f);
1463 if (FRAME_TERMINAL (f)->judge_scroll_bars_hook)
1464 (*FRAME_TERMINAL (f)->judge_scroll_bars_hook) (f);
1466 update_face_from_frame_parameter (f, Qscroll_bar_foreground, value);
1467 redraw_frame (f);
1472 /* Set the background color for scroll bars on frame F to VALUE VALUE
1473 should be a string, a color name. If it isn't a string or isn't a
1474 valid color name, do nothing. OLDVAL is the old value of the frame
1475 parameter. */
1477 void
1478 x_set_scroll_bar_background (f, value, oldval)
1479 struct frame *f;
1480 Lisp_Object value, oldval;
1482 unsigned long pixel;
1484 if (STRINGP (value))
1485 pixel = x_decode_color (f, value, WHITE_PIX_DEFAULT (f));
1486 else
1487 pixel = -1;
1489 if (f->output_data.x->scroll_bar_background_pixel != -1)
1490 unload_color (f, f->output_data.x->scroll_bar_background_pixel);
1492 #ifdef USE_TOOLKIT_SCROLL_BARS
1493 /* Scrollbar shadow colors. */
1494 if (f->output_data.x->scroll_bar_top_shadow_pixel != -1)
1496 unload_color (f, f->output_data.x->scroll_bar_top_shadow_pixel);
1497 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
1499 if (f->output_data.x->scroll_bar_bottom_shadow_pixel != -1)
1501 unload_color (f, f->output_data.x->scroll_bar_bottom_shadow_pixel);
1502 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
1504 #endif /* USE_TOOLKIT_SCROLL_BARS */
1506 f->output_data.x->scroll_bar_background_pixel = pixel;
1507 if (FRAME_X_WINDOW (f) && FRAME_VISIBLE_P (f))
1509 /* Remove all scroll bars because they have wrong colors. */
1510 if (FRAME_TERMINAL (f)->condemn_scroll_bars_hook)
1511 (*FRAME_TERMINAL (f)->condemn_scroll_bars_hook) (f);
1512 if (FRAME_TERMINAL (f)->judge_scroll_bars_hook)
1513 (*FRAME_TERMINAL (f)->judge_scroll_bars_hook) (f);
1515 update_face_from_frame_parameter (f, Qscroll_bar_background, value);
1516 redraw_frame (f);
1521 /* Encode Lisp string STRING as a text in a format appropriate for
1522 XICCC (X Inter Client Communication Conventions).
1524 If STRING contains only ASCII characters, do no conversion and
1525 return the string data of STRING. Otherwise, encode the text by
1526 CODING_SYSTEM, and return a newly allocated memory area which
1527 should be freed by `xfree' by a caller.
1529 SELECTIONP non-zero means the string is being encoded for an X
1530 selection, so it is safe to run pre-write conversions (which
1531 may run Lisp code).
1533 Store the byte length of resulting text in *TEXT_BYTES.
1535 If the text contains only ASCII and Latin-1, store 1 in *STRING_P,
1536 which means that the `encoding' of the result can be `STRING'.
1537 Otherwise store 0 in *STRINGP, which means that the `encoding' of
1538 the result should be `COMPOUND_TEXT'. */
1540 static unsigned char *
1541 x_encode_text (string, coding_system, selectionp, text_bytes, stringp, freep)
1542 Lisp_Object string, coding_system;
1543 int *text_bytes, *stringp;
1544 int selectionp;
1545 int *freep;
1547 unsigned char *str = SDATA (string);
1548 int chars = SCHARS (string);
1549 int bytes = SBYTES (string);
1550 int charset_info;
1551 int bufsize;
1552 unsigned char *buf;
1553 struct coding_system coding;
1554 extern Lisp_Object Qcompound_text_with_extensions;
1556 charset_info = find_charset_in_text (str, chars, bytes, NULL, Qnil);
1557 if (charset_info == 0)
1559 /* No multibyte character in OBJ. We need not encode it. */
1560 *text_bytes = bytes;
1561 *stringp = 1;
1562 *freep = 0;
1563 return str;
1566 setup_coding_system (coding_system, &coding);
1567 if (selectionp
1568 && SYMBOLP (coding.pre_write_conversion)
1569 && !NILP (Ffboundp (coding.pre_write_conversion)))
1571 string = run_pre_post_conversion_on_str (string, &coding, 1);
1572 str = SDATA (string);
1573 chars = SCHARS (string);
1574 bytes = SBYTES (string);
1576 coding.src_multibyte = 1;
1577 coding.dst_multibyte = 0;
1578 coding.mode |= CODING_MODE_LAST_BLOCK;
1579 if (coding.type == coding_type_iso2022)
1580 coding.flags |= CODING_FLAG_ISO_SAFE;
1581 /* We suppress producing escape sequences for composition. */
1582 coding.composing = COMPOSITION_DISABLED;
1583 bufsize = encoding_buffer_size (&coding, bytes);
1584 buf = (unsigned char *) xmalloc (bufsize);
1585 encode_coding (&coding, str, buf, bytes, bufsize);
1586 *text_bytes = coding.produced;
1587 *stringp = (charset_info == 1
1588 || (!EQ (coding_system, Qcompound_text)
1589 && !EQ (coding_system, Qcompound_text_with_extensions)));
1590 *freep = 1;
1591 return buf;
1595 /* Set the WM name to NAME for frame F. Also set the icon name.
1596 If the frame already has an icon name, use that, otherwise set the
1597 icon name to NAME. */
1599 static void
1600 x_set_name_internal (f, name)
1601 FRAME_PTR f;
1602 Lisp_Object name;
1604 if (FRAME_X_WINDOW (f))
1606 BLOCK_INPUT;
1607 #ifdef HAVE_X11R4
1609 XTextProperty text, icon;
1610 int bytes, stringp;
1611 int do_free_icon_value = 0, do_free_text_value = 0;
1612 Lisp_Object coding_system;
1614 coding_system = Qcompound_text;
1615 /* Note: Encoding strategy
1617 We encode NAME by compound-text and use "COMPOUND-TEXT" in
1618 text.encoding. But, there are non-internationalized window
1619 managers which don't support that encoding. So, if NAME
1620 contains only ASCII and 8859-1 characters, encode it by
1621 iso-latin-1, and use "STRING" in text.encoding hoping that
1622 such window managers at least analyze this format correctly,
1623 i.e. treat 8-bit bytes as 8859-1 characters.
1625 We may also be able to use "UTF8_STRING" in text.encoding
1626 in the future which can encode all Unicode characters.
1627 But, for the moment, there's no way to know that the
1628 current window manager supports it or not. */
1629 text.value = x_encode_text (name, coding_system, 0, &bytes, &stringp,
1630 &do_free_text_value);
1631 text.encoding = (stringp ? XA_STRING
1632 : FRAME_X_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
1633 text.format = 8;
1634 text.nitems = bytes;
1636 if (!STRINGP (f->icon_name))
1638 icon = text;
1640 else
1642 /* See the above comment "Note: Encoding strategy". */
1643 icon.value = x_encode_text (f->icon_name, coding_system, 0,
1644 &bytes, &stringp, &do_free_icon_value);
1645 icon.encoding = (stringp ? XA_STRING
1646 : FRAME_X_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
1647 icon.format = 8;
1648 icon.nitems = bytes;
1651 #ifdef USE_GTK
1652 gtk_window_set_title (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)),
1653 (char *) SDATA (ENCODE_UTF_8 (name)));
1654 #else /* not USE_GTK */
1655 XSetWMName (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &text);
1656 #endif /* not USE_GTK */
1658 XSetWMIconName (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &icon);
1660 if (do_free_icon_value)
1661 xfree (icon.value);
1662 if (do_free_text_value)
1663 xfree (text.value);
1665 #else /* not HAVE_X11R4 */
1666 XSetIconName (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1667 SDATA (name));
1668 XStoreName (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1669 SDATA (name));
1670 #endif /* not HAVE_X11R4 */
1671 UNBLOCK_INPUT;
1675 /* Change the name of frame F to NAME. If NAME is nil, set F's name to
1676 x_id_name.
1678 If EXPLICIT is non-zero, that indicates that lisp code is setting the
1679 name; if NAME is a string, set F's name to NAME and set
1680 F->explicit_name; if NAME is Qnil, then clear F->explicit_name.
1682 If EXPLICIT is zero, that indicates that Emacs redisplay code is
1683 suggesting a new name, which lisp code should override; if
1684 F->explicit_name is set, ignore the new name; otherwise, set it. */
1686 void
1687 x_set_name (f, name, explicit)
1688 struct frame *f;
1689 Lisp_Object name;
1690 int explicit;
1692 /* Make sure that requests from lisp code override requests from
1693 Emacs redisplay code. */
1694 if (explicit)
1696 /* If we're switching from explicit to implicit, we had better
1697 update the mode lines and thereby update the title. */
1698 if (f->explicit_name && NILP (name))
1699 update_mode_lines = 1;
1701 f->explicit_name = ! NILP (name);
1703 else if (f->explicit_name)
1704 return;
1706 /* If NAME is nil, set the name to the x_id_name. */
1707 if (NILP (name))
1709 /* Check for no change needed in this very common case
1710 before we do any consing. */
1711 if (!strcmp (FRAME_X_DISPLAY_INFO (f)->x_id_name,
1712 SDATA (f->name)))
1713 return;
1714 name = build_string (FRAME_X_DISPLAY_INFO (f)->x_id_name);
1716 else
1717 CHECK_STRING (name);
1719 /* Don't change the name if it's already NAME. */
1720 if (! NILP (Fstring_equal (name, f->name)))
1721 return;
1723 f->name = name;
1725 /* For setting the frame title, the title parameter should override
1726 the name parameter. */
1727 if (! NILP (f->title))
1728 name = f->title;
1730 x_set_name_internal (f, name);
1733 /* This function should be called when the user's lisp code has
1734 specified a name for the frame; the name will override any set by the
1735 redisplay code. */
1736 void
1737 x_explicitly_set_name (f, arg, oldval)
1738 FRAME_PTR f;
1739 Lisp_Object arg, oldval;
1741 x_set_name (f, arg, 1);
1744 /* This function should be called by Emacs redisplay code to set the
1745 name; names set this way will never override names set by the user's
1746 lisp code. */
1747 void
1748 x_implicitly_set_name (f, arg, oldval)
1749 FRAME_PTR f;
1750 Lisp_Object arg, oldval;
1752 x_set_name (f, arg, 0);
1755 /* Change the title of frame F to NAME.
1756 If NAME is nil, use the frame name as the title.
1758 If EXPLICIT is non-zero, that indicates that lisp code is setting the
1759 name; if NAME is a string, set F's name to NAME and set
1760 F->explicit_name; if NAME is Qnil, then clear F->explicit_name.
1762 If EXPLICIT is zero, that indicates that Emacs redisplay code is
1763 suggesting a new name, which lisp code should override; if
1764 F->explicit_name is set, ignore the new name; otherwise, set it. */
1766 void
1767 x_set_title (f, name, old_name)
1768 struct frame *f;
1769 Lisp_Object name, old_name;
1771 /* Don't change the title if it's already NAME. */
1772 if (EQ (name, f->title))
1773 return;
1775 update_mode_lines = 1;
1777 f->title = name;
1779 if (NILP (name))
1780 name = f->name;
1781 else
1782 CHECK_STRING (name);
1784 x_set_name_internal (f, name);
1787 void
1788 x_set_scroll_bar_default_width (f)
1789 struct frame *f;
1791 int wid = FRAME_COLUMN_WIDTH (f);
1793 #ifdef USE_TOOLKIT_SCROLL_BARS
1794 /* A minimum width of 14 doesn't look good for toolkit scroll bars. */
1795 int width = 16 + 2 * VERTICAL_SCROLL_BAR_WIDTH_TRIM;
1796 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (width + wid - 1) / wid;
1797 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = width;
1798 #else
1799 /* Make the actual width at least 14 pixels and a multiple of a
1800 character width. */
1801 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (14 + wid - 1) / wid;
1803 /* Use all of that space (aside from required margins) for the
1804 scroll bar. */
1805 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = 0;
1806 #endif
1810 /* Record in frame F the specified or default value according to ALIST
1811 of the parameter named PROP (a Lisp symbol). If no value is
1812 specified for PROP, look for an X default for XPROP on the frame
1813 named NAME. If that is not found either, use the value DEFLT. */
1815 static Lisp_Object
1816 x_default_scroll_bar_color_parameter (f, alist, prop, xprop, xclass,
1817 foreground_p)
1818 struct frame *f;
1819 Lisp_Object alist;
1820 Lisp_Object prop;
1821 char *xprop;
1822 char *xclass;
1823 int foreground_p;
1825 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
1826 Lisp_Object tem;
1828 tem = x_get_arg (dpyinfo, alist, prop, xprop, xclass, RES_TYPE_STRING);
1829 if (EQ (tem, Qunbound))
1831 #ifdef USE_TOOLKIT_SCROLL_BARS
1833 /* See if an X resource for the scroll bar color has been
1834 specified. */
1835 tem = display_x_get_resource (dpyinfo,
1836 build_string (foreground_p
1837 ? "foreground"
1838 : "background"),
1839 empty_string,
1840 build_string ("verticalScrollBar"),
1841 empty_string);
1842 if (!STRINGP (tem))
1844 /* If nothing has been specified, scroll bars will use a
1845 toolkit-dependent default. Because these defaults are
1846 difficult to get at without actually creating a scroll
1847 bar, use nil to indicate that no color has been
1848 specified. */
1849 tem = Qnil;
1852 #else /* not USE_TOOLKIT_SCROLL_BARS */
1854 tem = Qnil;
1856 #endif /* not USE_TOOLKIT_SCROLL_BARS */
1859 x_set_frame_parameters (f, Fcons (Fcons (prop, tem), Qnil));
1860 return tem;
1865 #if !defined (HAVE_X11R4) && !defined (HAVE_XSETWMPROTOCOLS)
1867 Status
1868 XSetWMProtocols (dpy, w, protocols, count)
1869 Display *dpy;
1870 Window w;
1871 Atom *protocols;
1872 int count;
1874 Atom prop;
1875 prop = XInternAtom (dpy, "WM_PROTOCOLS", False);
1876 if (prop == None) return False;
1877 XChangeProperty (dpy, w, prop, XA_ATOM, 32, PropModeReplace,
1878 (unsigned char *) protocols, count);
1879 return True;
1881 #endif /* not HAVE_X11R4 && not HAVE_XSETWMPROTOCOLS */
1883 #ifdef USE_X_TOOLKIT
1885 /* If the WM_PROTOCOLS property does not already contain WM_TAKE_FOCUS,
1886 WM_DELETE_WINDOW, and WM_SAVE_YOURSELF, then add them. (They may
1887 already be present because of the toolkit (Motif adds some of them,
1888 for example, but Xt doesn't). */
1890 static void
1891 hack_wm_protocols (f, widget)
1892 FRAME_PTR f;
1893 Widget widget;
1895 Display *dpy = XtDisplay (widget);
1896 Window w = XtWindow (widget);
1897 int need_delete = 1;
1898 int need_focus = 1;
1899 int need_save = 1;
1901 BLOCK_INPUT;
1903 Atom type;
1904 unsigned char *catoms;
1905 int format = 0;
1906 unsigned long nitems = 0;
1907 unsigned long bytes_after;
1909 if ((XGetWindowProperty (dpy, w,
1910 FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
1911 (long)0, (long)100, False, XA_ATOM,
1912 &type, &format, &nitems, &bytes_after,
1913 &catoms)
1914 == Success)
1915 && format == 32 && type == XA_ATOM)
1917 Atom *atoms = (Atom *) catoms;
1918 while (nitems > 0)
1920 nitems--;
1921 if (atoms[nitems]
1922 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window)
1923 need_delete = 0;
1924 else if (atoms[nitems]
1925 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_take_focus)
1926 need_focus = 0;
1927 else if (atoms[nitems]
1928 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself)
1929 need_save = 0;
1932 if (catoms)
1933 XFree (catoms);
1936 Atom props [10];
1937 int count = 0;
1938 if (need_delete)
1939 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window;
1940 if (need_focus)
1941 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_take_focus;
1942 if (need_save)
1943 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself;
1944 if (count)
1945 XChangeProperty (dpy, w, FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
1946 XA_ATOM, 32, PropModeAppend,
1947 (unsigned char *) props, count);
1949 UNBLOCK_INPUT;
1951 #endif
1955 /* Support routines for XIC (X Input Context). */
1957 #ifdef HAVE_X_I18N
1959 static XFontSet xic_create_xfontset P_ ((struct frame *, char *));
1960 static XIMStyle best_xim_style P_ ((XIMStyles *, XIMStyles *));
1963 /* Supported XIM styles, ordered by preference. */
1965 static XIMStyle supported_xim_styles[] =
1967 XIMPreeditPosition | XIMStatusArea,
1968 XIMPreeditPosition | XIMStatusNothing,
1969 XIMPreeditPosition | XIMStatusNone,
1970 XIMPreeditNothing | XIMStatusArea,
1971 XIMPreeditNothing | XIMStatusNothing,
1972 XIMPreeditNothing | XIMStatusNone,
1973 XIMPreeditNone | XIMStatusArea,
1974 XIMPreeditNone | XIMStatusNothing,
1975 XIMPreeditNone | XIMStatusNone,
1980 /* Create an X fontset on frame F with base font name BASE_FONTNAME. */
1982 char xic_defaut_fontset[] = "-*-*-*-r-normal--14-*-*-*-*-*-*-*";
1984 /* Create an Xt fontset spec from the name of a base font.
1985 If `motif' is True use the Motif syntax. */
1986 char *
1987 xic_create_fontsetname (base_fontname, motif)
1988 char *base_fontname;
1989 Bool motif;
1991 const char *sep = motif ? ";" : ",";
1992 char *fontsetname;
1994 /* Make a fontset name from the base font name. */
1995 if (xic_defaut_fontset == base_fontname)
1996 { /* There is no base font name, use the default. */
1997 int len = strlen (base_fontname) + 2;
1998 fontsetname = xmalloc (len);
1999 bzero (fontsetname, len);
2000 strcpy (fontsetname, base_fontname);
2002 else
2004 /* Make a fontset name from the base font name.
2005 The font set will be made of the following elements:
2006 - the base font.
2007 - the base font where the charset spec is replaced by -*-*.
2008 - the same but with the family also replaced with -*-*-. */
2009 char *p = base_fontname;
2010 int i;
2012 for (i = 0; *p; p++)
2013 if (*p == '-') i++;
2014 if (i != 14)
2015 { /* As the font name doesn't conform to XLFD, we can't
2016 modify it to generalize it to allcs and allfamilies.
2017 Use the specified font plus the default. */
2018 int len = strlen (base_fontname) + strlen (xic_defaut_fontset) + 3;
2019 fontsetname = xmalloc (len);
2020 bzero (fontsetname, len);
2021 strcpy (fontsetname, base_fontname);
2022 strcat (fontsetname, sep);
2023 strcat (fontsetname, xic_defaut_fontset);
2025 else
2027 int len;
2028 char *p1 = NULL, *p2 = NULL;
2029 char *font_allcs = NULL;
2030 char *font_allfamilies = NULL;
2031 char *font_all = NULL;
2032 char *allcs = "*-*-*-*-*-*-*";
2033 char *allfamilies = "-*-*-";
2034 char *all = "*-*-*-*-";
2036 for (i = 0, p = base_fontname; i < 8; p++)
2038 if (*p == '-')
2040 i++;
2041 if (i == 3)
2042 p1 = p + 1;
2043 else if (i == 7)
2044 p2 = p + 1;
2047 /* Build the font spec that matches all charsets. */
2048 len = p - base_fontname + strlen (allcs) + 1;
2049 font_allcs = (char *) alloca (len);
2050 bzero (font_allcs, len);
2051 bcopy (base_fontname, font_allcs, p - base_fontname);
2052 strcat (font_allcs, allcs);
2054 /* Build the font spec that matches all families. */
2055 len = p - p1 + strlen (allcs) + strlen (allfamilies) + 1;
2056 font_allfamilies = (char *) alloca (len);
2057 bzero (font_allfamilies, len);
2058 strcpy (font_allfamilies, allfamilies);
2059 bcopy (p1, font_allfamilies + strlen (allfamilies), p - p1);
2060 strcat (font_allfamilies, allcs);
2062 /* Build the font spec that matches all. */
2063 len = p - p2 + strlen (allcs) + strlen (all) + strlen (allfamilies) + 1;
2064 font_all = (char *) alloca (len);
2065 bzero (font_all, len);
2066 strcpy (font_all, allfamilies);
2067 strcat (font_all, all);
2068 bcopy (p2, font_all + strlen (all) + strlen (allfamilies), p - p2);
2069 strcat (font_all, allcs);
2071 /* Build the actual font set name. */
2072 len = strlen (base_fontname) + strlen (font_allcs)
2073 + strlen (font_allfamilies) + strlen (font_all) + 5;
2074 fontsetname = xmalloc (len);
2075 bzero (fontsetname, len);
2076 strcpy (fontsetname, base_fontname);
2077 strcat (fontsetname, sep);
2078 strcat (fontsetname, font_allcs);
2079 strcat (fontsetname, sep);
2080 strcat (fontsetname, font_allfamilies);
2081 strcat (fontsetname, sep);
2082 strcat (fontsetname, font_all);
2085 if (motif)
2086 strcat (fontsetname, ":");
2087 return fontsetname;
2090 static XFontSet
2091 xic_create_xfontset (f, base_fontname)
2092 struct frame *f;
2093 char *base_fontname;
2095 XFontSet xfs = NULL;
2096 char **missing_list = NULL;
2097 int missing_count;
2098 char *def_string;
2099 Lisp_Object rest, frame;
2101 if (!base_fontname)
2102 base_fontname = xic_defaut_fontset;
2104 /* See if there is another frame already using same fontset. */
2105 FOR_EACH_FRAME (rest, frame)
2107 struct frame *cf = XFRAME (frame);
2108 if (cf != f && FRAME_LIVE_P (f) && FRAME_X_P (cf)
2109 && FRAME_X_DISPLAY_INFO (cf) == FRAME_X_DISPLAY_INFO (f)
2110 && FRAME_XIC_BASE_FONTNAME (cf)
2111 && !strcmp (FRAME_XIC_BASE_FONTNAME (cf), base_fontname))
2113 xfs = FRAME_XIC_FONTSET (cf);
2114 break;
2118 if (!xfs)
2120 char *fontsetname = xic_create_fontsetname (base_fontname, False);
2122 /* New fontset. */
2123 xfs = XCreateFontSet (FRAME_X_DISPLAY (f),
2124 fontsetname, &missing_list,
2125 &missing_count, &def_string);
2126 if (missing_list)
2127 XFreeStringList (missing_list);
2128 xfree (fontsetname);
2131 if (FRAME_XIC_BASE_FONTNAME (f))
2132 xfree (FRAME_XIC_BASE_FONTNAME (f));
2133 FRAME_XIC_BASE_FONTNAME (f) = xstrdup (base_fontname);
2135 /* No need to free def_string. */
2136 return xfs;
2139 /* Free the X fontset of frame F if it is the last frame using it. */
2141 void
2142 xic_free_xfontset (f)
2143 struct frame *f;
2145 Lisp_Object rest, frame;
2146 int shared_p = 0;
2148 if (!FRAME_XIC_FONTSET (f))
2149 return;
2151 /* See if there is another frame sharing the same fontset. */
2152 FOR_EACH_FRAME (rest, frame)
2154 struct frame *cf = XFRAME (frame);
2155 if (cf != f && FRAME_LIVE_P (f) && FRAME_X_P (cf)
2156 && FRAME_X_DISPLAY_INFO (cf) == FRAME_X_DISPLAY_INFO (f)
2157 && FRAME_XIC_FONTSET (cf) == FRAME_XIC_FONTSET (f))
2159 shared_p = 1;
2160 break;
2164 if (!shared_p)
2165 /* The fontset is not used anymore. It is safe to free it. */
2166 XFreeFontSet (FRAME_X_DISPLAY (f), FRAME_XIC_FONTSET (f));
2168 if (FRAME_XIC_BASE_FONTNAME (f))
2169 xfree (FRAME_XIC_BASE_FONTNAME (f));
2170 FRAME_XIC_BASE_FONTNAME (f) = NULL;
2171 FRAME_XIC_FONTSET (f) = NULL;
2175 /* Value is the best input style, given user preferences USER (already
2176 checked to be supported by Emacs), and styles supported by the
2177 input method XIM. */
2179 static XIMStyle
2180 best_xim_style (user, xim)
2181 XIMStyles *user;
2182 XIMStyles *xim;
2184 int i, j;
2186 for (i = 0; i < user->count_styles; ++i)
2187 for (j = 0; j < xim->count_styles; ++j)
2188 if (user->supported_styles[i] == xim->supported_styles[j])
2189 return user->supported_styles[i];
2191 /* Return the default style. */
2192 return XIMPreeditNothing | XIMStatusNothing;
2195 /* Create XIC for frame F. */
2197 static XIMStyle xic_style;
2199 void
2200 create_frame_xic (f)
2201 struct frame *f;
2203 XIM xim;
2204 XIC xic = NULL;
2205 XFontSet xfs = NULL;
2207 if (FRAME_XIC (f))
2208 return;
2210 /* Create X fontset. */
2211 xfs = xic_create_xfontset
2212 (f, (FRAME_FONTSET (f) < 0) ? NULL
2213 : (char *) SDATA (fontset_ascii (FRAME_FONTSET (f))));
2215 xim = FRAME_X_XIM (f);
2216 if (xim)
2218 XRectangle s_area;
2219 XPoint spot;
2220 XVaNestedList preedit_attr;
2221 XVaNestedList status_attr;
2223 s_area.x = 0; s_area.y = 0; s_area.width = 1; s_area.height = 1;
2224 spot.x = 0; spot.y = 1;
2226 /* Determine XIC style. */
2227 if (xic_style == 0)
2229 XIMStyles supported_list;
2230 supported_list.count_styles = (sizeof supported_xim_styles
2231 / sizeof supported_xim_styles[0]);
2232 supported_list.supported_styles = supported_xim_styles;
2233 xic_style = best_xim_style (&supported_list,
2234 FRAME_X_XIM_STYLES (f));
2237 preedit_attr = XVaCreateNestedList (0,
2238 XNFontSet, xfs,
2239 XNForeground,
2240 FRAME_FOREGROUND_PIXEL (f),
2241 XNBackground,
2242 FRAME_BACKGROUND_PIXEL (f),
2243 (xic_style & XIMPreeditPosition
2244 ? XNSpotLocation
2245 : NULL),
2246 &spot,
2247 NULL);
2248 status_attr = XVaCreateNestedList (0,
2249 XNArea,
2250 &s_area,
2251 XNFontSet,
2252 xfs,
2253 XNForeground,
2254 FRAME_FOREGROUND_PIXEL (f),
2255 XNBackground,
2256 FRAME_BACKGROUND_PIXEL (f),
2257 NULL);
2259 xic = XCreateIC (xim,
2260 XNInputStyle, xic_style,
2261 XNClientWindow, FRAME_X_WINDOW (f),
2262 XNFocusWindow, FRAME_X_WINDOW (f),
2263 XNStatusAttributes, status_attr,
2264 XNPreeditAttributes, preedit_attr,
2265 NULL);
2266 XFree (preedit_attr);
2267 XFree (status_attr);
2270 FRAME_XIC (f) = xic;
2271 FRAME_XIC_STYLE (f) = xic_style;
2272 FRAME_XIC_FONTSET (f) = xfs;
2276 /* Destroy XIC and free XIC fontset of frame F, if any. */
2278 void
2279 free_frame_xic (f)
2280 struct frame *f;
2282 if (FRAME_XIC (f) == NULL)
2283 return;
2285 XDestroyIC (FRAME_XIC (f));
2286 xic_free_xfontset (f);
2288 FRAME_XIC (f) = NULL;
2292 /* Place preedit area for XIC of window W's frame to specified
2293 pixel position X/Y. X and Y are relative to window W. */
2295 void
2296 xic_set_preeditarea (w, x, y)
2297 struct window *w;
2298 int x, y;
2300 struct frame *f = XFRAME (w->frame);
2301 XVaNestedList attr;
2302 XPoint spot;
2304 spot.x = WINDOW_TO_FRAME_PIXEL_X (w, x) + WINDOW_LEFT_FRINGE_WIDTH (w);
2305 spot.y = WINDOW_TO_FRAME_PIXEL_Y (w, y) + FONT_BASE (FRAME_FONT (f));
2306 attr = XVaCreateNestedList (0, XNSpotLocation, &spot, NULL);
2307 XSetICValues (FRAME_XIC (f), XNPreeditAttributes, attr, NULL);
2308 XFree (attr);
2312 /* Place status area for XIC in bottom right corner of frame F.. */
2314 void
2315 xic_set_statusarea (f)
2316 struct frame *f;
2318 XIC xic = FRAME_XIC (f);
2319 XVaNestedList attr;
2320 XRectangle area;
2321 XRectangle *needed;
2323 /* Negotiate geometry of status area. If input method has existing
2324 status area, use its current size. */
2325 area.x = area.y = area.width = area.height = 0;
2326 attr = XVaCreateNestedList (0, XNAreaNeeded, &area, NULL);
2327 XSetICValues (xic, XNStatusAttributes, attr, NULL);
2328 XFree (attr);
2330 attr = XVaCreateNestedList (0, XNAreaNeeded, &needed, NULL);
2331 XGetICValues (xic, XNStatusAttributes, attr, NULL);
2332 XFree (attr);
2334 if (needed->width == 0) /* Use XNArea instead of XNAreaNeeded */
2336 attr = XVaCreateNestedList (0, XNArea, &needed, NULL);
2337 XGetICValues (xic, XNStatusAttributes, attr, NULL);
2338 XFree (attr);
2341 area.width = needed->width;
2342 area.height = needed->height;
2343 area.x = FRAME_PIXEL_WIDTH (f) - area.width - FRAME_INTERNAL_BORDER_WIDTH (f);
2344 area.y = (FRAME_PIXEL_HEIGHT (f) - area.height
2345 - FRAME_MENUBAR_HEIGHT (f)
2346 - FRAME_TOOLBAR_HEIGHT (f)
2347 - FRAME_INTERNAL_BORDER_WIDTH (f));
2348 XFree (needed);
2350 attr = XVaCreateNestedList (0, XNArea, &area, NULL);
2351 XSetICValues (xic, XNStatusAttributes, attr, NULL);
2352 XFree (attr);
2356 /* Set X fontset for XIC of frame F, using base font name
2357 BASE_FONTNAME. Called when a new Emacs fontset is chosen. */
2359 void
2360 xic_set_xfontset (f, base_fontname)
2361 struct frame *f;
2362 char *base_fontname;
2364 XVaNestedList attr;
2365 XFontSet xfs;
2367 xic_free_xfontset (f);
2369 xfs = xic_create_xfontset (f, base_fontname);
2371 attr = XVaCreateNestedList (0, XNFontSet, xfs, NULL);
2372 if (FRAME_XIC_STYLE (f) & XIMPreeditPosition)
2373 XSetICValues (FRAME_XIC (f), XNPreeditAttributes, attr, NULL);
2374 if (FRAME_XIC_STYLE (f) & XIMStatusArea)
2375 XSetICValues (FRAME_XIC (f), XNStatusAttributes, attr, NULL);
2376 XFree (attr);
2378 FRAME_XIC_FONTSET (f) = xfs;
2381 #endif /* HAVE_X_I18N */
2385 #ifdef USE_X_TOOLKIT
2387 /* Create and set up the X widget for frame F. */
2389 static void
2390 x_window (f, window_prompting, minibuffer_only)
2391 struct frame *f;
2392 long window_prompting;
2393 int minibuffer_only;
2395 XClassHint class_hints;
2396 XSetWindowAttributes attributes;
2397 unsigned long attribute_mask;
2398 Widget shell_widget;
2399 Widget pane_widget;
2400 Widget frame_widget;
2401 Arg al [25];
2402 int ac;
2404 BLOCK_INPUT;
2406 /* Use the resource name as the top-level widget name
2407 for looking up resources. Make a non-Lisp copy
2408 for the window manager, so GC relocation won't bother it.
2410 Elsewhere we specify the window name for the window manager. */
2413 char *str = (char *) SDATA (Vx_resource_name);
2414 f->namebuf = (char *) xmalloc (strlen (str) + 1);
2415 strcpy (f->namebuf, str);
2418 ac = 0;
2419 XtSetArg (al[ac], XtNallowShellResize, 1); ac++;
2420 XtSetArg (al[ac], XtNinput, 1); ac++;
2421 XtSetArg (al[ac], XtNmappedWhenManaged, 0); ac++;
2422 XtSetArg (al[ac], XtNborderWidth, f->border_width); ac++;
2423 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2424 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2425 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2426 shell_widget = XtAppCreateShell (f->namebuf, EMACS_CLASS,
2427 applicationShellWidgetClass,
2428 FRAME_X_DISPLAY (f), al, ac);
2430 f->output_data.x->widget = shell_widget;
2431 /* maybe_set_screen_title_format (shell_widget); */
2433 pane_widget = lw_create_widget ("main", "pane", widget_id_tick++,
2434 (widget_value *) NULL,
2435 shell_widget, False,
2436 (lw_callback) NULL,
2437 (lw_callback) NULL,
2438 (lw_callback) NULL,
2439 (lw_callback) NULL);
2441 ac = 0;
2442 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2443 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2444 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2445 XtSetValues (pane_widget, al, ac);
2446 f->output_data.x->column_widget = pane_widget;
2448 /* mappedWhenManaged to false tells to the paned window to not map/unmap
2449 the emacs screen when changing menubar. This reduces flickering. */
2451 ac = 0;
2452 XtSetArg (al[ac], XtNmappedWhenManaged, 0); ac++;
2453 XtSetArg (al[ac], XtNshowGrip, 0); ac++;
2454 XtSetArg (al[ac], XtNallowResize, 1); ac++;
2455 XtSetArg (al[ac], XtNresizeToPreferred, 1); ac++;
2456 XtSetArg (al[ac], XtNemacsFrame, f); ac++;
2457 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2458 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2459 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2460 frame_widget = XtCreateWidget (f->namebuf, emacsFrameClass, pane_widget,
2461 al, ac);
2463 f->output_data.x->edit_widget = frame_widget;
2465 XtManageChild (frame_widget);
2467 /* Do some needed geometry management. */
2469 int len;
2470 char *tem, shell_position[32];
2471 Arg al[10];
2472 int ac = 0;
2473 int extra_borders = 0;
2474 int menubar_size
2475 = (f->output_data.x->menubar_widget
2476 ? (f->output_data.x->menubar_widget->core.height
2477 + f->output_data.x->menubar_widget->core.border_width)
2478 : 0);
2480 #if 0 /* Experimentally, we now get the right results
2481 for -geometry -0-0 without this. 24 Aug 96, rms. */
2482 if (FRAME_EXTERNAL_MENU_BAR (f))
2484 Dimension ibw = 0;
2485 XtVaGetValues (pane_widget, XtNinternalBorderWidth, &ibw, NULL);
2486 menubar_size += ibw;
2488 #endif
2490 f->output_data.x->menubar_height = menubar_size;
2492 #ifndef USE_LUCID
2493 /* Motif seems to need this amount added to the sizes
2494 specified for the shell widget. The Athena/Lucid widgets don't.
2495 Both conclusions reached experimentally. -- rms. */
2496 XtVaGetValues (f->output_data.x->edit_widget, XtNinternalBorderWidth,
2497 &extra_borders, NULL);
2498 extra_borders *= 2;
2499 #endif
2501 /* Convert our geometry parameters into a geometry string
2502 and specify it.
2503 Note that we do not specify here whether the position
2504 is a user-specified or program-specified one.
2505 We pass that information later, in x_wm_set_size_hints. */
2507 int left = f->left_pos;
2508 int xneg = window_prompting & XNegative;
2509 int top = f->top_pos;
2510 int yneg = window_prompting & YNegative;
2511 if (xneg)
2512 left = -left;
2513 if (yneg)
2514 top = -top;
2516 if (window_prompting & USPosition)
2517 sprintf (shell_position, "=%dx%d%c%d%c%d",
2518 FRAME_PIXEL_WIDTH (f) + extra_borders,
2519 FRAME_PIXEL_HEIGHT (f) + menubar_size + extra_borders,
2520 (xneg ? '-' : '+'), left,
2521 (yneg ? '-' : '+'), top);
2522 else
2524 sprintf (shell_position, "=%dx%d",
2525 FRAME_PIXEL_WIDTH (f) + extra_borders,
2526 FRAME_PIXEL_HEIGHT (f) + menubar_size + extra_borders);
2528 /* Setting x and y when the position is not specified in
2529 the geometry string will set program position in the WM hints.
2530 If Emacs had just one program position, we could set it in
2531 fallback resources, but since each make-frame call can specify
2532 different program positions, this is easier. */
2533 XtSetArg (al[ac], XtNx, left); ac++;
2534 XtSetArg (al[ac], XtNy, top); ac++;
2538 len = strlen (shell_position) + 1;
2539 /* We don't free this because we don't know whether
2540 it is safe to free it while the frame exists.
2541 It isn't worth the trouble of arranging to free it
2542 when the frame is deleted. */
2543 tem = (char *) xmalloc (len);
2544 strncpy (tem, shell_position, len);
2545 XtSetArg (al[ac], XtNgeometry, tem); ac++;
2546 XtSetValues (shell_widget, al, ac);
2549 XtManageChild (pane_widget);
2550 XtRealizeWidget (shell_widget);
2552 FRAME_X_WINDOW (f) = XtWindow (frame_widget);
2554 validate_x_resource_name ();
2556 class_hints.res_name = (char *) SDATA (Vx_resource_name);
2557 class_hints.res_class = (char *) SDATA (Vx_resource_class);
2558 XSetClassHint (FRAME_X_DISPLAY (f), XtWindow (shell_widget), &class_hints);
2560 #ifdef HAVE_X_I18N
2561 FRAME_XIC (f) = NULL;
2562 if (use_xim)
2563 create_frame_xic (f);
2564 #endif
2566 f->output_data.x->wm_hints.input = True;
2567 f->output_data.x->wm_hints.flags |= InputHint;
2568 XSetWMHints (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2569 &f->output_data.x->wm_hints);
2571 hack_wm_protocols (f, shell_widget);
2573 #ifdef HACK_EDITRES
2574 XtAddEventHandler (shell_widget, 0, True, _XEditResCheckMessages, 0);
2575 #endif
2577 /* Do a stupid property change to force the server to generate a
2578 PropertyNotify event so that the event_stream server timestamp will
2579 be initialized to something relevant to the time we created the window.
2581 XChangeProperty (XtDisplay (frame_widget), XtWindow (frame_widget),
2582 FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
2583 XA_ATOM, 32, PropModeAppend,
2584 (unsigned char*) NULL, 0);
2586 /* Make all the standard events reach the Emacs frame. */
2587 attributes.event_mask = STANDARD_EVENT_SET;
2589 #ifdef HAVE_X_I18N
2590 if (FRAME_XIC (f))
2592 /* XIM server might require some X events. */
2593 unsigned long fevent = NoEventMask;
2594 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2595 attributes.event_mask |= fevent;
2597 #endif /* HAVE_X_I18N */
2599 attribute_mask = CWEventMask;
2600 XChangeWindowAttributes (XtDisplay (shell_widget), XtWindow (shell_widget),
2601 attribute_mask, &attributes);
2603 XtMapWidget (frame_widget);
2605 /* x_set_name normally ignores requests to set the name if the
2606 requested name is the same as the current name. This is the one
2607 place where that assumption isn't correct; f->name is set, but
2608 the X server hasn't been told. */
2610 Lisp_Object name;
2611 int explicit = f->explicit_name;
2613 f->explicit_name = 0;
2614 name = f->name;
2615 f->name = Qnil;
2616 x_set_name (f, name, explicit);
2619 XDefineCursor (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2620 f->output_data.x->text_cursor);
2622 UNBLOCK_INPUT;
2624 /* This is a no-op, except under Motif. Make sure main areas are
2625 set to something reasonable, in case we get an error later. */
2626 lw_set_main_areas (pane_widget, 0, frame_widget);
2629 #else /* not USE_X_TOOLKIT */
2630 #ifdef USE_GTK
2631 void
2632 x_window (f)
2633 FRAME_PTR f;
2635 if (! xg_create_frame_widgets (f))
2636 error ("Unable to create window");
2638 #ifdef HAVE_X_I18N
2639 FRAME_XIC (f) = NULL;
2640 if (use_xim)
2642 BLOCK_INPUT;
2643 create_frame_xic (f);
2644 if (FRAME_XIC (f))
2646 /* XIM server might require some X events. */
2647 unsigned long fevent = NoEventMask;
2648 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2650 if (fevent != NoEventMask)
2652 XSetWindowAttributes attributes;
2653 XWindowAttributes wattr;
2654 unsigned long attribute_mask;
2656 XGetWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2657 &wattr);
2658 attributes.event_mask = wattr.your_event_mask | fevent;
2659 attribute_mask = CWEventMask;
2660 XChangeWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2661 attribute_mask, &attributes);
2664 UNBLOCK_INPUT;
2666 #endif
2669 #else /*! USE_GTK */
2670 /* Create and set up the X window for frame F. */
2672 void
2673 x_window (f)
2674 struct frame *f;
2677 XClassHint class_hints;
2678 XSetWindowAttributes attributes;
2679 unsigned long attribute_mask;
2681 attributes.background_pixel = FRAME_BACKGROUND_PIXEL (f);
2682 attributes.border_pixel = f->output_data.x->border_pixel;
2683 attributes.bit_gravity = StaticGravity;
2684 attributes.backing_store = NotUseful;
2685 attributes.save_under = True;
2686 attributes.event_mask = STANDARD_EVENT_SET;
2687 attributes.colormap = FRAME_X_COLORMAP (f);
2688 attribute_mask = (CWBackPixel | CWBorderPixel | CWBitGravity | CWEventMask
2689 | CWColormap);
2691 BLOCK_INPUT;
2692 FRAME_X_WINDOW (f)
2693 = XCreateWindow (FRAME_X_DISPLAY (f),
2694 f->output_data.x->parent_desc,
2695 f->left_pos,
2696 f->top_pos,
2697 FRAME_PIXEL_WIDTH (f), FRAME_PIXEL_HEIGHT (f),
2698 f->border_width,
2699 CopyFromParent, /* depth */
2700 InputOutput, /* class */
2701 FRAME_X_VISUAL (f),
2702 attribute_mask, &attributes);
2704 #ifdef HAVE_X_I18N
2705 if (use_xim)
2707 create_frame_xic (f);
2708 if (FRAME_XIC (f))
2710 /* XIM server might require some X events. */
2711 unsigned long fevent = NoEventMask;
2712 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2713 attributes.event_mask |= fevent;
2714 attribute_mask = CWEventMask;
2715 XChangeWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2716 attribute_mask, &attributes);
2719 #endif /* HAVE_X_I18N */
2721 validate_x_resource_name ();
2723 class_hints.res_name = (char *) SDATA (Vx_resource_name);
2724 class_hints.res_class = (char *) SDATA (Vx_resource_class);
2725 XSetClassHint (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), &class_hints);
2727 /* The menubar is part of the ordinary display;
2728 it does not count in addition to the height of the window. */
2729 f->output_data.x->menubar_height = 0;
2731 /* This indicates that we use the "Passive Input" input model.
2732 Unless we do this, we don't get the Focus{In,Out} events that we
2733 need to draw the cursor correctly. Accursed bureaucrats.
2734 XWhipsAndChains (FRAME_X_DISPLAY (f), IronMaiden, &TheRack); */
2736 f->output_data.x->wm_hints.input = True;
2737 f->output_data.x->wm_hints.flags |= InputHint;
2738 XSetWMHints (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2739 &f->output_data.x->wm_hints);
2740 f->output_data.x->wm_hints.icon_pixmap = None;
2742 /* Request "save yourself" and "delete window" commands from wm. */
2744 Atom protocols[2];
2745 protocols[0] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window;
2746 protocols[1] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself;
2747 XSetWMProtocols (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), protocols, 2);
2750 /* x_set_name normally ignores requests to set the name if the
2751 requested name is the same as the current name. This is the one
2752 place where that assumption isn't correct; f->name is set, but
2753 the X server hasn't been told. */
2755 Lisp_Object name;
2756 int explicit = f->explicit_name;
2758 f->explicit_name = 0;
2759 name = f->name;
2760 f->name = Qnil;
2761 x_set_name (f, name, explicit);
2764 XDefineCursor (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2765 f->output_data.x->text_cursor);
2767 UNBLOCK_INPUT;
2769 if (FRAME_X_WINDOW (f) == 0)
2770 error ("Unable to create window");
2773 #endif /* not USE_GTK */
2774 #endif /* not USE_X_TOOLKIT */
2776 /* Verify that the icon position args for this window are valid. */
2778 static void
2779 x_icon_verify (f, parms)
2780 struct frame *f;
2781 Lisp_Object parms;
2783 Lisp_Object icon_x, icon_y;
2785 /* Set the position of the icon. Note that twm groups all
2786 icons in an icon window. */
2787 icon_x = x_frame_get_and_record_arg (f, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
2788 icon_y = x_frame_get_and_record_arg (f, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
2789 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
2791 CHECK_NUMBER (icon_x);
2792 CHECK_NUMBER (icon_y);
2794 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
2795 error ("Both left and top icon corners of icon must be specified");
2798 /* Handle the icon stuff for this window. Perhaps later we might
2799 want an x_set_icon_position which can be called interactively as
2800 well. */
2802 static void
2803 x_icon (f, parms)
2804 struct frame *f;
2805 Lisp_Object parms;
2807 Lisp_Object icon_x, icon_y;
2808 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
2810 /* Set the position of the icon. Note that twm groups all
2811 icons in an icon window. */
2812 icon_x = x_frame_get_and_record_arg (f, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
2813 icon_y = x_frame_get_and_record_arg (f, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
2814 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
2816 CHECK_NUMBER (icon_x);
2817 CHECK_NUMBER (icon_y);
2819 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
2820 error ("Both left and top icon corners of icon must be specified");
2822 BLOCK_INPUT;
2824 if (! EQ (icon_x, Qunbound))
2825 x_wm_set_icon_position (f, XINT (icon_x), XINT (icon_y));
2827 #if 0 /* x_get_arg removes the visibility parameter as a side effect,
2828 but x_create_frame still needs it. */
2829 /* Start up iconic or window? */
2830 x_wm_set_window_state
2831 (f, (EQ (x_get_arg (dpyinfo, parms, Qvisibility, 0, 0, RES_TYPE_SYMBOL),
2832 Qicon)
2833 ? IconicState
2834 : NormalState));
2835 #endif
2837 x_text_icon (f, (char *) SDATA ((!NILP (f->icon_name)
2838 ? f->icon_name
2839 : f->name)));
2841 UNBLOCK_INPUT;
2844 /* Make the GCs needed for this window, setting the
2845 background, border and mouse colors; also create the
2846 mouse cursor and the gray border tile. */
2848 static char cursor_bits[] =
2850 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
2851 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
2852 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
2853 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00
2856 static void
2857 x_make_gc (f)
2858 struct frame *f;
2860 XGCValues gc_values;
2862 BLOCK_INPUT;
2864 /* Create the GCs of this frame.
2865 Note that many default values are used. */
2867 /* Normal video */
2868 gc_values.font = FRAME_FONT (f)->fid;
2869 gc_values.foreground = FRAME_FOREGROUND_PIXEL (f);
2870 gc_values.background = FRAME_BACKGROUND_PIXEL (f);
2871 gc_values.line_width = 0; /* Means 1 using fast algorithm. */
2872 f->output_data.x->normal_gc
2873 = XCreateGC (FRAME_X_DISPLAY (f),
2874 FRAME_X_WINDOW (f),
2875 GCLineWidth | GCFont | GCForeground | GCBackground,
2876 &gc_values);
2878 /* Reverse video style. */
2879 gc_values.foreground = FRAME_BACKGROUND_PIXEL (f);
2880 gc_values.background = FRAME_FOREGROUND_PIXEL (f);
2881 f->output_data.x->reverse_gc
2882 = XCreateGC (FRAME_X_DISPLAY (f),
2883 FRAME_X_WINDOW (f),
2884 GCFont | GCForeground | GCBackground | GCLineWidth,
2885 &gc_values);
2887 /* Cursor has cursor-color background, background-color foreground. */
2888 gc_values.foreground = FRAME_BACKGROUND_PIXEL (f);
2889 gc_values.background = f->output_data.x->cursor_pixel;
2890 gc_values.fill_style = FillOpaqueStippled;
2891 gc_values.stipple
2892 = XCreateBitmapFromData (FRAME_X_DISPLAY (f),
2893 FRAME_X_DISPLAY_INFO (f)->root_window,
2894 cursor_bits, 16, 16);
2895 f->output_data.x->cursor_gc
2896 = XCreateGC (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2897 (GCFont | GCForeground | GCBackground
2898 | GCFillStyle /* | GCStipple */ | GCLineWidth),
2899 &gc_values);
2901 /* Reliefs. */
2902 f->output_data.x->white_relief.gc = 0;
2903 f->output_data.x->black_relief.gc = 0;
2905 /* Create the gray border tile used when the pointer is not in
2906 the frame. Since this depends on the frame's pixel values,
2907 this must be done on a per-frame basis. */
2908 f->output_data.x->border_tile
2909 = (XCreatePixmapFromBitmapData
2910 (FRAME_X_DISPLAY (f), FRAME_X_DISPLAY_INFO (f)->root_window,
2911 gray_bits, gray_width, gray_height,
2912 FRAME_FOREGROUND_PIXEL (f),
2913 FRAME_BACKGROUND_PIXEL (f),
2914 DefaultDepth (FRAME_X_DISPLAY (f), FRAME_X_SCREEN_NUMBER (f))));
2916 UNBLOCK_INPUT;
2920 /* Free what was was allocated in x_make_gc. */
2922 void
2923 x_free_gcs (f)
2924 struct frame *f;
2926 Display *dpy = FRAME_X_DISPLAY (f);
2928 BLOCK_INPUT;
2930 if (f->output_data.x->normal_gc)
2932 XFreeGC (dpy, f->output_data.x->normal_gc);
2933 f->output_data.x->normal_gc = 0;
2936 if (f->output_data.x->reverse_gc)
2938 XFreeGC (dpy, f->output_data.x->reverse_gc);
2939 f->output_data.x->reverse_gc = 0;
2942 if (f->output_data.x->cursor_gc)
2944 XFreeGC (dpy, f->output_data.x->cursor_gc);
2945 f->output_data.x->cursor_gc = 0;
2948 if (f->output_data.x->border_tile)
2950 XFreePixmap (dpy, f->output_data.x->border_tile);
2951 f->output_data.x->border_tile = 0;
2954 UNBLOCK_INPUT;
2958 /* Handler for signals raised during x_create_frame and
2959 x_create_top_frame. FRAME is the frame which is partially
2960 constructed. */
2962 static Lisp_Object
2963 unwind_create_frame (frame)
2964 Lisp_Object frame;
2966 struct frame *f = XFRAME (frame);
2968 /* If frame is already dead, nothing to do. This can happen if the
2969 display is disconnected after the frame has become official, but
2970 before x_create_frame removes the unwind protect. */
2971 if (!FRAME_LIVE_P (f))
2972 return Qnil;
2974 /* If frame is ``official'', nothing to do. */
2975 if (!CONSP (Vframe_list) || !EQ (XCAR (Vframe_list), frame))
2977 #if GLYPH_DEBUG
2978 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
2979 #endif
2981 x_free_frame_resources (f);
2983 #if GLYPH_DEBUG
2984 /* Check that reference counts are indeed correct. */
2985 xassert (dpyinfo->reference_count == dpyinfo_refcount);
2986 xassert (dpyinfo->image_cache->refcount == image_cache_refcount);
2987 #endif
2988 return Qt;
2991 return Qnil;
2995 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
2996 1, 1, 0,
2997 doc: /* Make a new X window, which is called a "frame" in Emacs terms.
2998 Returns an Emacs frame object.
2999 ALIST is an alist of frame parameters.
3000 If the parameters specify that the frame should not have a minibuffer,
3001 and do not specify a specific minibuffer window to use,
3002 then `default-minibuffer-frame' must be a frame whose minibuffer can
3003 be shared by the new frame.
3005 This function is an internal primitive--use `make-frame' instead. */)
3006 (parms)
3007 Lisp_Object parms;
3009 struct frame *f;
3010 Lisp_Object frame, tem;
3011 Lisp_Object name;
3012 int minibuffer_only = 0;
3013 long window_prompting = 0;
3014 int width, height;
3015 int count = SPECPDL_INDEX ();
3016 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
3017 Lisp_Object display;
3018 struct x_display_info *dpyinfo = NULL;
3019 Lisp_Object parent;
3020 struct kboard *kb;
3022 parms = Fcopy_alist (parms);
3024 /* Use this general default value to start with
3025 until we know if this frame has a specified name. */
3026 Vx_resource_name = Vinvocation_name;
3028 display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_NUMBER);
3029 if (EQ (display, Qunbound))
3030 display = x_get_arg (dpyinfo, parms, Qdisplay, 0, 0, RES_TYPE_STRING);
3031 if (EQ (display, Qunbound))
3032 display = Qnil;
3033 dpyinfo = check_x_display_info (display);
3034 #ifdef MULTI_KBOARD
3035 kb = dpyinfo->terminal->kboard;
3036 #else
3037 kb = &the_only_kboard;
3038 #endif
3040 if (dpyinfo->terminal->deleted)
3041 error ("Terminal is being deleted, can't create new frames on it");
3043 name = x_get_arg (dpyinfo, parms, Qname, "name", "Name", RES_TYPE_STRING);
3044 if (!STRINGP (name)
3045 && ! EQ (name, Qunbound)
3046 && ! NILP (name))
3047 error ("Invalid frame name--not a string or nil");
3049 if (STRINGP (name))
3050 Vx_resource_name = name;
3052 /* See if parent window is specified. */
3053 parent = x_get_arg (dpyinfo, parms, Qparent_id, NULL, NULL, RES_TYPE_NUMBER);
3054 if (EQ (parent, Qunbound))
3055 parent = Qnil;
3056 if (! NILP (parent))
3057 CHECK_NUMBER (parent);
3059 /* make_frame_without_minibuffer can run Lisp code and garbage collect. */
3060 /* No need to protect DISPLAY because that's not used after passing
3061 it to make_frame_without_minibuffer. */
3062 frame = Qnil;
3063 GCPRO4 (parms, parent, name, frame);
3064 tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
3065 RES_TYPE_SYMBOL);
3066 if (EQ (tem, Qnone) || NILP (tem))
3067 f = make_frame_without_minibuffer (Qnil, kb, display);
3068 else if (EQ (tem, Qonly))
3070 f = make_minibuffer_frame ();
3071 minibuffer_only = 1;
3073 else if (WINDOWP (tem))
3074 f = make_frame_without_minibuffer (tem, kb, display);
3075 else
3076 f = make_frame (1);
3078 XSETFRAME (frame, f);
3080 /* Note that X Windows does support scroll bars. */
3081 FRAME_CAN_HAVE_SCROLL_BARS (f) = 1;
3083 f->terminal = dpyinfo->terminal;
3084 f->terminal->reference_count++;
3086 f->output_method = output_x_window;
3087 f->output_data.x = (struct x_output *) xmalloc (sizeof (struct x_output));
3088 bzero (f->output_data.x, sizeof (struct x_output));
3089 f->output_data.x->icon_bitmap = -1;
3090 FRAME_FONTSET (f) = -1;
3091 f->output_data.x->scroll_bar_foreground_pixel = -1;
3092 f->output_data.x->scroll_bar_background_pixel = -1;
3093 #ifdef USE_TOOLKIT_SCROLL_BARS
3094 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
3095 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
3096 #endif /* USE_TOOLKIT_SCROLL_BARS */
3098 f->icon_name
3099 = x_get_arg (dpyinfo, parms, Qicon_name, "iconName", "Title",
3100 RES_TYPE_STRING);
3101 if (! STRINGP (f->icon_name))
3102 f->icon_name = Qnil;
3104 FRAME_X_DISPLAY_INFO (f) = dpyinfo;
3106 /* With FRAME_X_DISPLAY_INFO set up, this unwind-protect is safe. */
3107 record_unwind_protect (unwind_create_frame, frame);
3108 #if GLYPH_DEBUG
3109 image_cache_refcount = FRAME_X_IMAGE_CACHE (f)->refcount;
3110 dpyinfo_refcount = dpyinfo->reference_count;
3111 #endif /* GLYPH_DEBUG */
3113 /* These colors will be set anyway later, but it's important
3114 to get the color reference counts right, so initialize them! */
3116 Lisp_Object black;
3117 struct gcpro gcpro1;
3119 /* Function x_decode_color can signal an error. Make
3120 sure to initialize color slots so that we won't try
3121 to free colors we haven't allocated. */
3122 FRAME_FOREGROUND_PIXEL (f) = -1;
3123 FRAME_BACKGROUND_PIXEL (f) = -1;
3124 f->output_data.x->cursor_pixel = -1;
3125 f->output_data.x->cursor_foreground_pixel = -1;
3126 f->output_data.x->border_pixel = -1;
3127 f->output_data.x->mouse_pixel = -1;
3129 black = build_string ("black");
3130 GCPRO1 (black);
3131 FRAME_FOREGROUND_PIXEL (f)
3132 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3133 FRAME_BACKGROUND_PIXEL (f)
3134 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3135 f->output_data.x->cursor_pixel
3136 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3137 f->output_data.x->cursor_foreground_pixel
3138 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3139 f->output_data.x->border_pixel
3140 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3141 f->output_data.x->mouse_pixel
3142 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3143 UNGCPRO;
3146 /* Specify the parent under which to make this X window. */
3148 if (!NILP (parent))
3150 f->output_data.x->parent_desc = (Window) XFASTINT (parent);
3151 f->output_data.x->explicit_parent = 1;
3153 else
3155 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
3156 f->output_data.x->explicit_parent = 0;
3159 /* Set the name; the functions to which we pass f expect the name to
3160 be set. */
3161 if (EQ (name, Qunbound) || NILP (name))
3163 f->name = build_string (dpyinfo->x_id_name);
3164 f->explicit_name = 0;
3166 else
3168 f->name = name;
3169 f->explicit_name = 1;
3170 /* use the frame's title when getting resources for this frame. */
3171 specbind (Qx_resource_name, name);
3174 /* Extract the window parameters from the supplied values
3175 that are needed to determine window geometry. */
3177 Lisp_Object font;
3179 font = x_get_arg (dpyinfo, parms, Qfont, "font", "Font", RES_TYPE_STRING);
3181 BLOCK_INPUT;
3182 /* First, try whatever font the caller has specified. */
3183 if (STRINGP (font))
3185 tem = Fquery_fontset (font, Qnil);
3186 if (STRINGP (tem))
3187 font = x_new_fontset (f, SDATA (tem));
3188 else
3189 font = x_new_font (f, SDATA (font));
3192 /* Try out a font which we hope has bold and italic variations. */
3193 if (!STRINGP (font))
3194 font = x_new_font (f, "-adobe-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-1");
3195 if (!STRINGP (font))
3196 font = x_new_font (f, "-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-1");
3197 if (! STRINGP (font))
3198 font = x_new_font (f, "-*-*-medium-r-normal-*-*-140-*-*-c-*-iso8859-1");
3199 if (! STRINGP (font))
3200 /* This was formerly the first thing tried, but it finds too many fonts
3201 and takes too long. */
3202 font = x_new_font (f, "-*-*-medium-r-*-*-*-*-*-*-c-*-iso8859-1");
3203 /* If those didn't work, look for something which will at least work. */
3204 if (! STRINGP (font))
3205 font = x_new_font (f, "-*-fixed-*-*-*-*-*-140-*-*-c-*-iso8859-1");
3206 UNBLOCK_INPUT;
3207 if (! STRINGP (font))
3208 font = build_string ("fixed");
3210 x_set_frame_parameters (f, Fcons (Fcons (Qfont, font), Qnil));
3213 #ifdef USE_LUCID
3214 /* Prevent lwlib/xlwmenu.c from crashing because of a bug
3215 whereby it fails to get any font. */
3216 xlwmenu_default_font = FRAME_FONT (f);
3217 #endif
3219 x_default_parameter (f, parms, Qborder_width, make_number (2),
3220 "borderWidth", "BorderWidth", RES_TYPE_NUMBER);
3222 /* This defaults to 1 in order to match xterm. We recognize either
3223 internalBorderWidth or internalBorder (which is what xterm calls
3224 it). */
3225 if (NILP (Fassq (Qinternal_border_width, parms)))
3227 Lisp_Object value;
3229 value = x_get_arg (dpyinfo, parms, Qinternal_border_width,
3230 "internalBorder", "internalBorder", RES_TYPE_NUMBER);
3231 if (! EQ (value, Qunbound))
3232 parms = Fcons (Fcons (Qinternal_border_width, value),
3233 parms);
3235 x_default_parameter (f, parms, Qinternal_border_width, make_number (1),
3236 "internalBorderWidth", "internalBorderWidth",
3237 RES_TYPE_NUMBER);
3238 x_default_parameter (f, parms, Qvertical_scroll_bars, Qleft,
3239 "verticalScrollBars", "ScrollBars",
3240 RES_TYPE_SYMBOL);
3242 /* Also do the stuff which must be set before the window exists. */
3243 x_default_parameter (f, parms, Qforeground_color, build_string ("black"),
3244 "foreground", "Foreground", RES_TYPE_STRING);
3245 x_default_parameter (f, parms, Qbackground_color, build_string ("white"),
3246 "background", "Background", RES_TYPE_STRING);
3247 x_default_parameter (f, parms, Qmouse_color, build_string ("black"),
3248 "pointerColor", "Foreground", RES_TYPE_STRING);
3249 x_default_parameter (f, parms, Qcursor_color, build_string ("black"),
3250 "cursorColor", "Foreground", RES_TYPE_STRING);
3251 x_default_parameter (f, parms, Qborder_color, build_string ("black"),
3252 "borderColor", "BorderColor", RES_TYPE_STRING);
3253 x_default_parameter (f, parms, Qscreen_gamma, Qnil,
3254 "screenGamma", "ScreenGamma", RES_TYPE_FLOAT);
3255 x_default_parameter (f, parms, Qline_spacing, Qnil,
3256 "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
3257 x_default_parameter (f, parms, Qleft_fringe, Qnil,
3258 "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
3259 x_default_parameter (f, parms, Qright_fringe, Qnil,
3260 "rightFringe", "RightFringe", RES_TYPE_NUMBER);
3262 x_default_scroll_bar_color_parameter (f, parms, Qscroll_bar_foreground,
3263 "scrollBarForeground",
3264 "ScrollBarForeground", 1);
3265 x_default_scroll_bar_color_parameter (f, parms, Qscroll_bar_background,
3266 "scrollBarBackground",
3267 "ScrollBarBackground", 0);
3269 /* Init faces before x_default_parameter is called for scroll-bar
3270 parameters because that function calls x_set_scroll_bar_width,
3271 which calls change_frame_size, which calls Fset_window_buffer,
3272 which runs hooks, which call Fvertical_motion. At the end, we
3273 end up in init_iterator with a null face cache, which should not
3274 happen. */
3275 init_frame_faces (f);
3277 x_default_parameter (f, parms, Qmenu_bar_lines, make_number (1),
3278 "menuBar", "MenuBar", RES_TYPE_NUMBER);
3279 x_default_parameter (f, parms, Qtool_bar_lines, make_number (1),
3280 "toolBar", "ToolBar", RES_TYPE_NUMBER);
3281 x_default_parameter (f, parms, Qbuffer_predicate, Qnil,
3282 "bufferPredicate", "BufferPredicate",
3283 RES_TYPE_SYMBOL);
3284 x_default_parameter (f, parms, Qtitle, Qnil,
3285 "title", "Title", RES_TYPE_STRING);
3286 x_default_parameter (f, parms, Qwait_for_wm, Qt,
3287 "waitForWM", "WaitForWM", RES_TYPE_BOOLEAN);
3288 x_default_parameter (f, parms, Qfullscreen, Qnil,
3289 "fullscreen", "Fullscreen", RES_TYPE_SYMBOL);
3291 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
3293 /* Compute the size of the X window. */
3294 window_prompting = x_figure_window_size (f, parms, 1);
3296 tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
3297 f->no_split = minibuffer_only || EQ (tem, Qt);
3299 x_icon_verify (f, parms);
3301 /* Create the X widget or window. */
3302 #ifdef USE_X_TOOLKIT
3303 x_window (f, window_prompting, minibuffer_only);
3304 #else
3305 x_window (f);
3306 #endif
3308 x_icon (f, parms);
3309 x_make_gc (f);
3311 /* Now consider the frame official. */
3312 FRAME_X_DISPLAY_INFO (f)->reference_count++;
3313 Vframe_list = Fcons (frame, Vframe_list);
3315 /* We need to do this after creating the X window, so that the
3316 icon-creation functions can say whose icon they're describing. */
3317 x_default_parameter (f, parms, Qicon_type, Qt,
3318 "bitmapIcon", "BitmapIcon", RES_TYPE_SYMBOL);
3320 x_default_parameter (f, parms, Qauto_raise, Qnil,
3321 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
3322 x_default_parameter (f, parms, Qauto_lower, Qnil,
3323 "autoLower", "AutoRaiseLower", RES_TYPE_BOOLEAN);
3324 x_default_parameter (f, parms, Qcursor_type, Qbox,
3325 "cursorType", "CursorType", RES_TYPE_SYMBOL);
3326 x_default_parameter (f, parms, Qscroll_bar_width, Qnil,
3327 "scrollBarWidth", "ScrollBarWidth",
3328 RES_TYPE_NUMBER);
3330 /* Dimensions, especially FRAME_LINES (f), must be done via change_frame_size.
3331 Change will not be effected unless different from the current
3332 FRAME_LINES (f). */
3333 width = FRAME_COLS (f);
3334 height = FRAME_LINES (f);
3336 SET_FRAME_COLS (f, 0);
3337 FRAME_LINES (f) = 0;
3338 change_frame_size (f, height, width, 1, 0, 0);
3340 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
3341 /* Create the menu bar. */
3342 if (!minibuffer_only && FRAME_EXTERNAL_MENU_BAR (f))
3344 /* If this signals an error, we haven't set size hints for the
3345 frame and we didn't make it visible. */
3346 initialize_frame_menubar (f);
3348 #ifndef USE_GTK
3349 /* This is a no-op, except under Motif where it arranges the
3350 main window for the widgets on it. */
3351 lw_set_main_areas (f->output_data.x->column_widget,
3352 f->output_data.x->menubar_widget,
3353 f->output_data.x->edit_widget);
3354 #endif /* not USE_GTK */
3356 #endif /* USE_X_TOOLKIT || USE_GTK */
3358 /* Tell the server what size and position, etc, we want, and how
3359 badly we want them. This should be done after we have the menu
3360 bar so that its size can be taken into account. */
3361 BLOCK_INPUT;
3362 x_wm_set_size_hint (f, window_prompting, 0);
3363 UNBLOCK_INPUT;
3365 /* Make the window appear on the frame and enable display, unless
3366 the caller says not to. However, with explicit parent, Emacs
3367 cannot control visibility, so don't try. */
3368 if (! f->output_data.x->explicit_parent)
3370 Lisp_Object visibility;
3372 visibility = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0,
3373 RES_TYPE_SYMBOL);
3374 if (EQ (visibility, Qunbound))
3375 visibility = Qt;
3377 if (EQ (visibility, Qicon))
3378 x_iconify_frame (f);
3379 else if (! NILP (visibility))
3380 x_make_frame_visible (f);
3381 else
3382 /* Must have been Qnil. */
3386 /* Set the WM leader property. GTK does this itself, so this is not
3387 needed when using GTK. */
3388 if (dpyinfo->client_leader_window != 0)
3390 BLOCK_INPUT;
3391 XChangeProperty (FRAME_X_DISPLAY (f),
3392 FRAME_OUTER_WINDOW (f),
3393 dpyinfo->Xatom_wm_client_leader,
3394 XA_WINDOW, 32, PropModeReplace,
3395 (unsigned char *) &dpyinfo->client_leader_window, 1);
3396 UNBLOCK_INPUT;
3399 /* Initialize `default-minibuffer-frame' in case this is the first
3400 frame on this terminal. */
3401 if (FRAME_HAS_MINIBUF_P (f)
3402 && (!FRAMEP (kb->Vdefault_minibuffer_frame)
3403 || !FRAME_LIVE_P (XFRAME (kb->Vdefault_minibuffer_frame))))
3404 kb->Vdefault_minibuffer_frame = frame;
3406 /* All remaining specified parameters, which have not been "used"
3407 by x_get_arg and friends, now go in the misc. alist of the frame. */
3408 for (tem = parms; !NILP (tem); tem = XCDR (tem))
3409 if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
3410 f->param_alist = Fcons (XCAR (tem), f->param_alist);
3412 store_frame_param (f, Qwindow_system, Qx);
3414 UNGCPRO;
3416 /* Make sure windows on this frame appear in calls to next-window
3417 and similar functions. */
3418 Vwindow_list = Qnil;
3420 return unbind_to (count, frame);
3424 /* FRAME is used only to get a handle on the X display. We don't pass the
3425 display info directly because we're called from frame.c, which doesn't
3426 know about that structure. */
3428 Lisp_Object
3429 x_get_focus_frame (frame)
3430 struct frame *frame;
3432 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (frame);
3433 Lisp_Object xfocus;
3434 if (! dpyinfo->x_focus_frame)
3435 return Qnil;
3437 XSETFRAME (xfocus, dpyinfo->x_focus_frame);
3438 return xfocus;
3442 /* In certain situations, when the window manager follows a
3443 click-to-focus policy, there seems to be no way around calling
3444 XSetInputFocus to give another frame the input focus .
3446 In an ideal world, XSetInputFocus should generally be avoided so
3447 that applications don't interfere with the window manager's focus
3448 policy. But I think it's okay to use when it's clearly done
3449 following a user-command. */
3451 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
3452 doc: /* Set the input focus to FRAME.
3453 FRAME nil means use the selected frame. */)
3454 (frame)
3455 Lisp_Object frame;
3457 struct frame *f = check_x_frame (frame);
3458 Display *dpy = FRAME_X_DISPLAY (f);
3460 BLOCK_INPUT;
3461 x_catch_errors (dpy);
3462 XSetInputFocus (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
3463 RevertToParent, CurrentTime);
3464 x_uncatch_errors ();
3465 UNBLOCK_INPUT;
3467 return Qnil;
3471 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
3472 doc: /* Internal function called by `color-defined-p', which see. */)
3473 (color, frame)
3474 Lisp_Object color, frame;
3476 XColor foo;
3477 FRAME_PTR f = check_x_frame (frame);
3479 CHECK_STRING (color);
3481 if (x_defined_color (f, SDATA (color), &foo, 0))
3482 return Qt;
3483 else
3484 return Qnil;
3487 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
3488 doc: /* Internal function called by `color-values', which see. */)
3489 (color, frame)
3490 Lisp_Object color, frame;
3492 XColor foo;
3493 FRAME_PTR f = check_x_frame (frame);
3495 CHECK_STRING (color);
3497 if (x_defined_color (f, SDATA (color), &foo, 0))
3499 Lisp_Object rgb[3];
3501 rgb[0] = make_number (foo.red);
3502 rgb[1] = make_number (foo.green);
3503 rgb[2] = make_number (foo.blue);
3504 return Flist (3, rgb);
3506 else
3507 return Qnil;
3510 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
3511 doc: /* Internal function called by `display-color-p', which see. */)
3512 (terminal)
3513 Lisp_Object terminal;
3515 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3517 if (dpyinfo->n_planes <= 2)
3518 return Qnil;
3520 switch (dpyinfo->visual->class)
3522 case StaticColor:
3523 case PseudoColor:
3524 case TrueColor:
3525 case DirectColor:
3526 return Qt;
3528 default:
3529 return Qnil;
3533 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p, Sx_display_grayscale_p,
3534 0, 1, 0,
3535 doc: /* Return t if the X display supports shades of gray.
3536 Note that color displays do support shades of gray.
3537 The optional argument TERMINAL specifies which display to ask about.
3538 TERMINAL should be a terminal id, a frame or a display name (a string).
3539 If omitted or nil, that stands for the selected frame's display. */)
3540 (terminal)
3541 Lisp_Object terminal;
3543 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3545 if (dpyinfo->n_planes <= 1)
3546 return Qnil;
3548 switch (dpyinfo->visual->class)
3550 case StaticColor:
3551 case PseudoColor:
3552 case TrueColor:
3553 case DirectColor:
3554 case StaticGray:
3555 case GrayScale:
3556 return Qt;
3558 default:
3559 return Qnil;
3563 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
3564 0, 1, 0,
3565 doc: /* Returns the width in pixels of the X display TERMINAL.
3566 The optional argument TERMINAL specifies which display to ask about.
3567 TERMINAL should be a terminal id, a frame or a display name (a string).
3568 If omitted or nil, that stands for the selected frame's display. */)
3569 (terminal)
3570 Lisp_Object terminal;
3572 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3574 return make_number (dpyinfo->width);
3577 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
3578 Sx_display_pixel_height, 0, 1, 0,
3579 doc: /* Returns the height in pixels of the X display TERMINAL.
3580 The optional argument TERMINAL specifies which display to ask about.
3581 TERMINAL should be a terminal id, a frame or a display name (a string).
3582 If omitted or nil, that stands for the selected frame's display. */)
3583 (terminal)
3584 Lisp_Object terminal;
3586 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3588 return make_number (dpyinfo->height);
3591 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
3592 0, 1, 0,
3593 doc: /* Returns the number of bitplanes of the X display TERMINAL.
3594 The optional argument TERMINAL specifies which display to ask about.
3595 TERMINAL should be a terminal id, a frame or a display name (a string).
3596 If omitted or nil, that stands for the selected frame's display. */)
3597 (terminal)
3598 Lisp_Object terminal;
3600 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3602 return make_number (dpyinfo->n_planes);
3605 DEFUN ("x-display-color-cells", Fx_display_color_cells, Sx_display_color_cells,
3606 0, 1, 0,
3607 doc: /* Returns the number of color cells of the X display TERMINAL.
3608 The optional argument TERMINAL specifies which display to ask about.
3609 TERMINAL should be a terminal id, a frame or a display name (a string).
3610 If omitted or nil, that stands for the selected frame's display. */)
3611 (terminal)
3612 Lisp_Object terminal;
3614 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3616 int nr_planes = DisplayPlanes (dpyinfo->display,
3617 XScreenNumberOfScreen (dpyinfo->screen));
3619 /* Truncate nr_planes to 24 to avoid integer overflow.
3620 Some displays says 32, but only 24 bits are actually significant.
3621 There are only very few and rare video cards that have more than
3622 24 significant bits. Also 24 bits is more than 16 million colors,
3623 it "should be enough for everyone". */
3624 if (nr_planes > 24) nr_planes = 24;
3626 return make_number (1 << nr_planes);
3629 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
3630 Sx_server_max_request_size,
3631 0, 1, 0,
3632 doc: /* Returns the maximum request size of the X server of display TERMINAL.
3633 The optional argument TERMINAL specifies which display to ask about.
3634 TERMINAL should be a terminal id, a frame or a display name (a string).
3635 If omitted or nil, that stands for the selected frame's display. */)
3636 (terminal)
3637 Lisp_Object terminal;
3639 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3641 return make_number (MAXREQUEST (dpyinfo->display));
3644 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
3645 doc: /* Returns the "vendor ID" string of the X server of display TERMINAL.
3646 \(Labelling every distributor as a "vendor" embodies the false assumption
3647 that operating systems cannot be developed and distributed noncommercially.)
3648 The optional argument TERMINAL specifies which display to ask about.
3649 TERMINAL should be a terminal id, a frame or a display name (a string).
3650 If omitted or nil, that stands for the selected frame's display. */)
3651 (terminal)
3652 Lisp_Object terminal;
3654 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3655 char *vendor = ServerVendor (dpyinfo->display);
3657 if (! vendor) vendor = "";
3658 return build_string (vendor);
3661 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
3662 doc: /* Returns the version numbers of the X server of display TERMINAL.
3663 The value is a list of three integers: the major and minor
3664 version numbers of the X Protocol in use, and the distributor-specific release
3665 number. See also the function `x-server-vendor'.
3667 The optional argument TERMINAL specifies which display to ask about.
3668 TERMINAL should be a terminal id, a frame or a display name (a string).
3669 If omitted or nil, that stands for the selected frame's display. */)
3670 (terminal)
3671 Lisp_Object terminal;
3673 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3674 Display *dpy = dpyinfo->display;
3676 return Fcons (make_number (ProtocolVersion (dpy)),
3677 Fcons (make_number (ProtocolRevision (dpy)),
3678 Fcons (make_number (VendorRelease (dpy)), Qnil)));
3681 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
3682 doc: /* Return the number of screens on the X server of display TERMINAL.
3683 The optional argument TERMINAL specifies which display to ask about.
3684 TERMINAL should be a terminal id, a frame or a display name (a string).
3685 If omitted or nil, that stands for the selected frame's display. */)
3686 (terminal)
3687 Lisp_Object terminal;
3689 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3691 return make_number (ScreenCount (dpyinfo->display));
3694 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height, 0, 1, 0,
3695 doc: /* Return the height in millimeters of the X display TERMINAL.
3696 The optional argument TERMINAL specifies which display to ask about.
3697 TERMINAL should be a terminal id, a frame or a display name (a string).
3698 If omitted or nil, that stands for the selected frame's display. */)
3699 (terminal)
3700 Lisp_Object terminal;
3702 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3704 return make_number (HeightMMOfScreen (dpyinfo->screen));
3707 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width, 0, 1, 0,
3708 doc: /* Return the width in millimeters of the X display TERMINAL.
3709 The optional argument TERMINAL specifies which display to ask about.
3710 TERMINAL should be a terminal id, a frame or a display name (a string).
3711 If omitted or nil, that stands for the selected frame's display. */)
3712 (terminal)
3713 Lisp_Object terminal;
3715 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3717 return make_number (WidthMMOfScreen (dpyinfo->screen));
3720 DEFUN ("x-display-backing-store", Fx_display_backing_store,
3721 Sx_display_backing_store, 0, 1, 0,
3722 doc: /* Returns an indication of whether X display TERMINAL does backing store.
3723 The value may be `always', `when-mapped', or `not-useful'.
3724 The optional argument TERMINAL specifies which display to ask about.
3725 TERMINAL should be a terminal id, a frame or a display name (a string).
3726 If omitted or nil, that stands for the selected frame's display. */)
3727 (terminal)
3728 Lisp_Object terminal;
3730 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3731 Lisp_Object result;
3733 switch (DoesBackingStore (dpyinfo->screen))
3735 case Always:
3736 result = intern ("always");
3737 break;
3739 case WhenMapped:
3740 result = intern ("when-mapped");
3741 break;
3743 case NotUseful:
3744 result = intern ("not-useful");
3745 break;
3747 default:
3748 error ("Strange value for BackingStore parameter of screen");
3749 result = Qnil;
3752 return result;
3755 DEFUN ("x-display-visual-class", Fx_display_visual_class,
3756 Sx_display_visual_class, 0, 1, 0,
3757 doc: /* Return the visual class of the X display TERMINAL.
3758 The value is one of the symbols `static-gray', `gray-scale',
3759 `static-color', `pseudo-color', `true-color', or `direct-color'.
3761 The optional argument TERMINAL specifies which display to ask about.
3762 TERMINAL should a terminal id, a frame or a display name (a string).
3763 If omitted or nil, that stands for the selected frame's display. */)
3764 (terminal)
3765 Lisp_Object terminal;
3767 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3768 Lisp_Object result;
3770 switch (dpyinfo->visual->class)
3772 case StaticGray:
3773 result = intern ("static-gray");
3774 break;
3775 case GrayScale:
3776 result = intern ("gray-scale");
3777 break;
3778 case StaticColor:
3779 result = intern ("static-color");
3780 break;
3781 case PseudoColor:
3782 result = intern ("pseudo-color");
3783 break;
3784 case TrueColor:
3785 result = intern ("true-color");
3786 break;
3787 case DirectColor:
3788 result = intern ("direct-color");
3789 break;
3790 default:
3791 error ("Display has an unknown visual class");
3792 result = Qnil;
3795 return result;
3798 DEFUN ("x-display-save-under", Fx_display_save_under,
3799 Sx_display_save_under, 0, 1, 0,
3800 doc: /* Returns t if the X display TERMINAL supports the save-under feature.
3801 The optional argument TERMINAL specifies which display to ask about.
3802 TERMINAL should be a terminal id, a frame or a display name (a string).
3803 If omitted or nil, that stands for the selected frame's display. */)
3804 (terminal)
3805 Lisp_Object terminal;
3807 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3809 if (DoesSaveUnders (dpyinfo->screen) == True)
3810 return Qt;
3811 else
3812 return Qnil;
3816 x_pixel_width (f)
3817 register struct frame *f;
3819 return FRAME_PIXEL_WIDTH (f);
3823 x_pixel_height (f)
3824 register struct frame *f;
3826 return FRAME_PIXEL_HEIGHT (f);
3830 x_char_width (f)
3831 register struct frame *f;
3833 return FRAME_COLUMN_WIDTH (f);
3837 x_char_height (f)
3838 register struct frame *f;
3840 return FRAME_LINE_HEIGHT (f);
3844 x_screen_planes (f)
3845 register struct frame *f;
3847 return FRAME_X_DISPLAY_INFO (f)->n_planes;
3852 /************************************************************************
3853 X Displays
3854 ************************************************************************/
3857 /* Mapping visual names to visuals. */
3859 static struct visual_class
3861 char *name;
3862 int class;
3864 visual_classes[] =
3866 {"StaticGray", StaticGray},
3867 {"GrayScale", GrayScale},
3868 {"StaticColor", StaticColor},
3869 {"PseudoColor", PseudoColor},
3870 {"TrueColor", TrueColor},
3871 {"DirectColor", DirectColor},
3872 {NULL, 0}
3876 #ifndef HAVE_XSCREENNUMBEROFSCREEN
3878 /* Value is the screen number of screen SCR. This is a substitute for
3879 the X function with the same name when that doesn't exist. */
3882 XScreenNumberOfScreen (scr)
3883 register Screen *scr;
3885 Display *dpy = scr->display;
3886 int i;
3888 for (i = 0; i < dpy->nscreens; ++i)
3889 if (scr == dpy->screens + i)
3890 break;
3892 return i;
3895 #endif /* not HAVE_XSCREENNUMBEROFSCREEN */
3898 /* Select the visual that should be used on display DPYINFO. Set
3899 members of DPYINFO appropriately. Called from x_term_init. */
3901 void
3902 select_visual (dpyinfo)
3903 struct x_display_info *dpyinfo;
3905 Display *dpy = dpyinfo->display;
3906 Screen *screen = dpyinfo->screen;
3907 Lisp_Object value;
3909 /* See if a visual is specified. */
3910 value = display_x_get_resource (dpyinfo,
3911 build_string ("visualClass"),
3912 build_string ("VisualClass"),
3913 Qnil, Qnil);
3914 if (STRINGP (value))
3916 /* VALUE should be of the form CLASS-DEPTH, where CLASS is one
3917 of `PseudoColor', `TrueColor' etc. and DEPTH is the color
3918 depth, a decimal number. NAME is compared with case ignored. */
3919 char *s = (char *) alloca (SBYTES (value) + 1);
3920 char *dash;
3921 int i, class = -1;
3922 XVisualInfo vinfo;
3924 strcpy (s, SDATA (value));
3925 dash = index (s, '-');
3926 if (dash)
3928 dpyinfo->n_planes = atoi (dash + 1);
3929 *dash = '\0';
3931 else
3932 /* We won't find a matching visual with depth 0, so that
3933 an error will be printed below. */
3934 dpyinfo->n_planes = 0;
3936 /* Determine the visual class. */
3937 for (i = 0; visual_classes[i].name; ++i)
3938 if (xstricmp (s, visual_classes[i].name) == 0)
3940 class = visual_classes[i].class;
3941 break;
3944 /* Look up a matching visual for the specified class. */
3945 if (class == -1
3946 || !XMatchVisualInfo (dpy, XScreenNumberOfScreen (screen),
3947 dpyinfo->n_planes, class, &vinfo))
3948 fatal ("Invalid visual specification `%s'", SDATA (value));
3950 dpyinfo->visual = vinfo.visual;
3952 else
3954 int n_visuals;
3955 XVisualInfo *vinfo, vinfo_template;
3957 dpyinfo->visual = DefaultVisualOfScreen (screen);
3959 #ifdef HAVE_X11R4
3960 vinfo_template.visualid = XVisualIDFromVisual (dpyinfo->visual);
3961 #else
3962 vinfo_template.visualid = dpyinfo->visual->visualid;
3963 #endif
3964 vinfo_template.screen = XScreenNumberOfScreen (screen);
3965 vinfo = XGetVisualInfo (dpy, VisualIDMask | VisualScreenMask,
3966 &vinfo_template, &n_visuals);
3967 if (n_visuals != 1)
3968 fatal ("Can't get proper X visual info");
3970 dpyinfo->n_planes = vinfo->depth;
3971 XFree ((char *) vinfo);
3976 /* Return the X display structure for the display named NAME.
3977 Open a new connection if necessary. */
3979 struct x_display_info *
3980 x_display_info_for_name (name)
3981 Lisp_Object name;
3983 Lisp_Object names;
3984 struct x_display_info *dpyinfo;
3986 CHECK_STRING (name);
3988 #if 0
3989 if (! EQ (Vinitial_window_system, intern ("x")))
3990 error ("Not using X Windows"); /* That doesn't stop us anymore. */
3991 #endif
3993 for (dpyinfo = x_display_list, names = x_display_name_list;
3994 dpyinfo;
3995 dpyinfo = dpyinfo->next, names = XCDR (names))
3997 Lisp_Object tem;
3998 tem = Fstring_equal (XCAR (XCAR (names)), name);
3999 if (!NILP (tem))
4000 return dpyinfo;
4003 /* Use this general default value to start with. */
4004 Vx_resource_name = Vinvocation_name;
4006 validate_x_resource_name ();
4008 dpyinfo = x_term_init (name, (char *)0,
4009 (char *) SDATA (Vx_resource_name));
4011 if (dpyinfo == 0)
4012 error ("Cannot connect to X server %s", SDATA (name));
4014 x_in_use = 1;
4015 XSETFASTINT (Vwindow_system_version, 11);
4017 return dpyinfo;
4021 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
4022 1, 3, 0,
4023 doc: /* Open a connection to an X server.
4024 DISPLAY is the name of the display to connect to.
4025 Optional second arg XRM-STRING is a string of resources in xrdb format.
4026 If the optional third arg MUST-SUCCEED is non-nil,
4027 terminate Emacs if we can't open the connection. */)
4028 (display, xrm_string, must_succeed)
4029 Lisp_Object display, xrm_string, must_succeed;
4031 unsigned char *xrm_option;
4032 struct x_display_info *dpyinfo;
4034 CHECK_STRING (display);
4035 if (! NILP (xrm_string))
4036 CHECK_STRING (xrm_string);
4038 #if 0
4039 if (! EQ (Vinitial_window_system, intern ("x")))
4040 error ("Not using X Windows"); /* That doesn't stop us anymore. */
4041 #endif
4043 if (! NILP (xrm_string))
4044 xrm_option = (unsigned char *) SDATA (xrm_string);
4045 else
4046 xrm_option = (unsigned char *) 0;
4048 validate_x_resource_name ();
4050 /* This is what opens the connection and sets x_current_display.
4051 This also initializes many symbols, such as those used for input. */
4052 dpyinfo = x_term_init (display, xrm_option,
4053 (char *) SDATA (Vx_resource_name));
4055 if (dpyinfo == 0)
4057 if (!NILP (must_succeed))
4058 fatal ("Cannot connect to X server %s.\n\
4059 Check the DISPLAY environment variable or use `-d'.\n\
4060 Also use the `xauth' program to verify that you have the proper\n\
4061 authorization information needed to connect the X server.\n\
4062 An insecure way to solve the problem may be to use `xhost'.\n",
4063 SDATA (display));
4064 else
4065 error ("Cannot connect to X server %s", SDATA (display));
4068 x_in_use = 1;
4070 XSETFASTINT (Vwindow_system_version, 11);
4071 return Qnil;
4074 DEFUN ("x-close-connection", Fx_close_connection,
4075 Sx_close_connection, 1, 1, 0,
4076 doc: /* Close the connection to TERMINAL's X server.
4077 For TERMINAL, specify a terminal id, a frame or a display name (a
4078 string). If TERMINAL is nil, that stands for the selected frame's
4079 terminal. */)
4080 (terminal)
4081 Lisp_Object terminal;
4083 struct x_display_info *dpyinfo = check_x_display_info (terminal);
4085 if (dpyinfo->reference_count > 0)
4086 error ("Display still has frames on it");
4088 x_delete_terminal (dpyinfo->terminal);
4090 return Qnil;
4093 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
4094 doc: /* Return the list of display names that Emacs has connections to. */)
4097 Lisp_Object tail, result;
4099 result = Qnil;
4100 for (tail = x_display_name_list; ! NILP (tail); tail = XCDR (tail))
4101 result = Fcons (XCAR (XCAR (tail)), result);
4103 return result;
4106 DEFUN ("x-synchronize", Fx_synchronize, Sx_synchronize, 1, 2, 0,
4107 doc: /* If ON is non-nil, report X errors as soon as the erring request is made.
4108 If ON is nil, allow buffering of requests.
4109 Turning on synchronization prohibits the Xlib routines from buffering
4110 requests and seriously degrades performance, but makes debugging much
4111 easier.
4112 The optional second argument TERMINAL specifies which display to act on.
4113 TERMINAL should be a terminal id, a frame or a display name (a string).
4114 If TERMINAL is omitted or nil, that stands for the selected frame's display. */)
4115 (on, terminal)
4116 Lisp_Object terminal, on;
4118 struct x_display_info *dpyinfo = check_x_display_info (terminal);
4120 XSynchronize (dpyinfo->display, !EQ (on, Qnil));
4122 return Qnil;
4125 /* Wait for responses to all X commands issued so far for frame F. */
4127 void
4128 x_sync (f)
4129 FRAME_PTR f;
4131 BLOCK_INPUT;
4132 XSync (FRAME_X_DISPLAY (f), False);
4133 UNBLOCK_INPUT;
4137 /***********************************************************************
4138 Window properties
4139 ***********************************************************************/
4141 DEFUN ("x-change-window-property", Fx_change_window_property,
4142 Sx_change_window_property, 2, 6, 0,
4143 doc: /* Change window property PROP to VALUE on the X window of FRAME.
4144 PROP must be a string.
4145 VALUE may be a string or a list of conses, numbers and/or strings.
4146 If an element in the list is a string, it is converted to
4147 an Atom and the value of the Atom is used. If an element is a cons,
4148 it is converted to a 32 bit number where the car is the 16 top bits and the
4149 cdr is the lower 16 bits.
4150 FRAME nil or omitted means use the selected frame.
4151 If TYPE is given and non-nil, it is the name of the type of VALUE.
4152 If TYPE is not given or nil, the type is STRING.
4153 FORMAT gives the size in bits of each element if VALUE is a list.
4154 It must be one of 8, 16 or 32.
4155 If VALUE is a string or FORMAT is nil or not given, FORMAT defaults to 8.
4156 If OUTER_P is non-nil, the property is changed for the outer X window of
4157 FRAME. Default is to change on the edit X window.
4159 Value is VALUE. */)
4160 (prop, value, frame, type, format, outer_p)
4161 Lisp_Object prop, value, frame, type, format, outer_p;
4163 struct frame *f = check_x_frame (frame);
4164 Atom prop_atom;
4165 Atom target_type = XA_STRING;
4166 int element_format = 8;
4167 unsigned char *data;
4168 int nelements;
4169 Window w;
4171 CHECK_STRING (prop);
4173 if (! NILP (format))
4175 CHECK_NUMBER (format);
4176 element_format = XFASTINT (format);
4178 if (element_format != 8 && element_format != 16
4179 && element_format != 32)
4180 error ("FORMAT must be one of 8, 16 or 32");
4183 if (CONSP (value))
4185 nelements = x_check_property_data (value);
4186 if (nelements == -1)
4187 error ("Bad data in VALUE, must be number, string or cons");
4189 if (element_format == 8)
4190 data = (unsigned char *) xmalloc (nelements);
4191 else if (element_format == 16)
4192 data = (unsigned char *) xmalloc (nelements*2);
4193 else /* format == 32 */
4194 /* The man page for XChangeProperty:
4195 "If the specified format is 32, the property data must be a
4196 long array."
4197 This applies even if long is more than 64 bits. The X library
4198 converts to 32 bits before sending to the X server. */
4199 data = (unsigned char *) xmalloc (nelements * sizeof(long));
4201 x_fill_property_data (FRAME_X_DISPLAY (f), value, data, element_format);
4203 else
4205 CHECK_STRING (value);
4206 data = SDATA (value);
4207 nelements = SCHARS (value);
4210 BLOCK_INPUT;
4211 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SDATA (prop), False);
4212 if (! NILP (type))
4214 CHECK_STRING (type);
4215 target_type = XInternAtom (FRAME_X_DISPLAY (f), SDATA (type), False);
4218 if (! NILP (outer_p)) w = FRAME_OUTER_WINDOW (f);
4219 else w = FRAME_X_WINDOW (f);
4221 XChangeProperty (FRAME_X_DISPLAY (f), w,
4222 prop_atom, target_type, element_format, PropModeReplace,
4223 data, nelements);
4225 if (CONSP (value)) xfree (data);
4227 /* Make sure the property is set when we return. */
4228 XFlush (FRAME_X_DISPLAY (f));
4229 UNBLOCK_INPUT;
4231 return value;
4235 DEFUN ("x-delete-window-property", Fx_delete_window_property,
4236 Sx_delete_window_property, 1, 2, 0,
4237 doc: /* Remove window property PROP from X window of FRAME.
4238 FRAME nil or omitted means use the selected frame. Value is PROP. */)
4239 (prop, frame)
4240 Lisp_Object prop, frame;
4242 struct frame *f = check_x_frame (frame);
4243 Atom prop_atom;
4245 CHECK_STRING (prop);
4246 BLOCK_INPUT;
4247 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SDATA (prop), False);
4248 XDeleteProperty (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), prop_atom);
4250 /* Make sure the property is removed when we return. */
4251 XFlush (FRAME_X_DISPLAY (f));
4252 UNBLOCK_INPUT;
4254 return prop;
4258 DEFUN ("x-window-property", Fx_window_property, Sx_window_property,
4259 1, 6, 0,
4260 doc: /* Value is the value of window property PROP on FRAME.
4261 If FRAME is nil or omitted, use the selected frame.
4262 If TYPE is nil or omitted, get the property as a string. Otherwise TYPE
4263 is the name of the Atom that denotes the type expected.
4264 If SOURCE is non-nil, get the property on that window instead of from
4265 FRAME. The number 0 denotes the root window.
4266 If DELETE_P is non-nil, delete the property after retreiving it.
4267 If VECTOR_RET_P is non-nil, don't return a string but a vector of values.
4269 Value is nil if FRAME hasn't a property with name PROP or if PROP has
4270 no value of TYPE. */)
4271 (prop, frame, type, source, delete_p, vector_ret_p)
4272 Lisp_Object prop, frame, type, source, delete_p, vector_ret_p;
4274 struct frame *f = check_x_frame (frame);
4275 Atom prop_atom;
4276 int rc;
4277 Lisp_Object prop_value = Qnil;
4278 unsigned char *tmp_data = NULL;
4279 Atom actual_type;
4280 Atom target_type = XA_STRING;
4281 int actual_format;
4282 unsigned long actual_size, bytes_remaining;
4283 Window target_window = FRAME_X_WINDOW (f);
4284 struct gcpro gcpro1;
4286 GCPRO1 (prop_value);
4287 CHECK_STRING (prop);
4289 if (! NILP (source))
4291 if (NUMBERP (source))
4293 if (FLOATP (source))
4294 target_window = (Window) XFLOAT (source);
4295 else
4296 target_window = XFASTINT (source);
4298 if (target_window == 0)
4299 target_window = FRAME_X_DISPLAY_INFO (f)->root_window;
4301 else if (CONSP (source))
4302 target_window = cons_to_long (source);
4305 BLOCK_INPUT;
4306 if (STRINGP (type))
4308 if (strcmp ("AnyPropertyType", SDATA (type)) == 0)
4309 target_type = AnyPropertyType;
4310 else
4311 target_type = XInternAtom (FRAME_X_DISPLAY (f), SDATA (type), False);
4314 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SDATA (prop), False);
4315 rc = XGetWindowProperty (FRAME_X_DISPLAY (f), target_window,
4316 prop_atom, 0, 0, False, target_type,
4317 &actual_type, &actual_format, &actual_size,
4318 &bytes_remaining, &tmp_data);
4319 if (rc == Success)
4321 int size = bytes_remaining;
4323 XFree (tmp_data);
4324 tmp_data = NULL;
4326 rc = XGetWindowProperty (FRAME_X_DISPLAY (f), target_window,
4327 prop_atom, 0, bytes_remaining,
4328 ! NILP (delete_p), target_type,
4329 &actual_type, &actual_format,
4330 &actual_size, &bytes_remaining,
4331 &tmp_data);
4332 if (rc == Success && tmp_data)
4334 /* The man page for XGetWindowProperty says:
4335 "If the returned format is 32, the returned data is represented
4336 as a long array and should be cast to that type to obtain the
4337 elements."
4338 This applies even if long is more than 32 bits, the X library
4339 converts from 32 bit elements received from the X server to long
4340 and passes the long array to us. Thus, for that case bcopy can not
4341 be used. We convert to a 32 bit type here, because so much code
4342 assume on that.
4344 The bytes and offsets passed to XGetWindowProperty refers to the
4345 property and those are indeed in 32 bit quantities if format is
4346 32. */
4348 if (actual_format == 32 && actual_format < BITS_PER_LONG)
4350 unsigned long i;
4351 int *idata = (int *) tmp_data;
4352 long *ldata = (long *) tmp_data;
4354 for (i = 0; i < actual_size; ++i)
4355 idata[i] = (int) ldata[i];
4358 if (NILP (vector_ret_p))
4359 prop_value = make_string (tmp_data, size);
4360 else
4361 prop_value = x_property_data_to_lisp (f,
4362 tmp_data,
4363 actual_type,
4364 actual_format,
4365 actual_size);
4368 if (tmp_data) XFree (tmp_data);
4371 UNBLOCK_INPUT;
4372 UNGCPRO;
4373 return prop_value;
4378 /***********************************************************************
4379 Busy cursor
4380 ***********************************************************************/
4382 /* If non-null, an asynchronous timer that, when it expires, displays
4383 an hourglass cursor on all frames. */
4385 static struct atimer *hourglass_atimer;
4387 /* Non-zero means an hourglass cursor is currently shown. */
4389 static int hourglass_shown_p;
4391 /* Number of seconds to wait before displaying an hourglass cursor. */
4393 static Lisp_Object Vhourglass_delay;
4395 /* Default number of seconds to wait before displaying an hourglass
4396 cursor. */
4398 #define DEFAULT_HOURGLASS_DELAY 1
4400 /* Function prototypes. */
4402 static void show_hourglass P_ ((struct atimer *));
4403 static void hide_hourglass P_ ((void));
4405 /* Return non-zero if houglass timer has been started or hourglass is shown. */
4408 hourglass_started ()
4410 return hourglass_shown_p || hourglass_atimer != NULL;
4414 /* Cancel a currently active hourglass timer, and start a new one. */
4416 void
4417 start_hourglass ()
4419 EMACS_TIME delay;
4420 int secs, usecs = 0;
4422 cancel_hourglass ();
4424 if (INTEGERP (Vhourglass_delay)
4425 && XINT (Vhourglass_delay) > 0)
4426 secs = XFASTINT (Vhourglass_delay);
4427 else if (FLOATP (Vhourglass_delay)
4428 && XFLOAT_DATA (Vhourglass_delay) > 0)
4430 Lisp_Object tem;
4431 tem = Ftruncate (Vhourglass_delay, Qnil);
4432 secs = XFASTINT (tem);
4433 usecs = (XFLOAT_DATA (Vhourglass_delay) - secs) * 1000000;
4435 else
4436 secs = DEFAULT_HOURGLASS_DELAY;
4438 EMACS_SET_SECS_USECS (delay, secs, usecs);
4439 hourglass_atimer = start_atimer (ATIMER_RELATIVE, delay,
4440 show_hourglass, NULL);
4444 /* Cancel the hourglass cursor timer if active, hide a busy cursor if
4445 shown. */
4447 void
4448 cancel_hourglass ()
4450 if (hourglass_atimer)
4452 cancel_atimer (hourglass_atimer);
4453 hourglass_atimer = NULL;
4456 if (hourglass_shown_p)
4457 hide_hourglass ();
4461 /* Timer function of hourglass_atimer. TIMER is equal to
4462 hourglass_atimer.
4464 Display an hourglass pointer on all frames by mapping the frames'
4465 hourglass_window. Set the hourglass_p flag in the frames'
4466 output_data.x structure to indicate that an hourglass cursor is
4467 shown on the frames. */
4469 static void
4470 show_hourglass (timer)
4471 struct atimer *timer;
4473 /* The timer implementation will cancel this timer automatically
4474 after this function has run. Set hourglass_atimer to null
4475 so that we know the timer doesn't have to be canceled. */
4476 hourglass_atimer = NULL;
4478 if (!hourglass_shown_p)
4480 Lisp_Object rest, frame;
4482 BLOCK_INPUT;
4484 FOR_EACH_FRAME (rest, frame)
4486 struct frame *f = XFRAME (frame);
4488 if (FRAME_LIVE_P (f) && FRAME_X_P (f) && FRAME_X_DISPLAY (f))
4490 Display *dpy = FRAME_X_DISPLAY (f);
4492 #ifdef USE_X_TOOLKIT
4493 if (f->output_data.x->widget)
4494 #else
4495 if (FRAME_OUTER_WINDOW (f))
4496 #endif
4498 f->output_data.x->hourglass_p = 1;
4500 if (!f->output_data.x->hourglass_window)
4502 unsigned long mask = CWCursor;
4503 XSetWindowAttributes attrs;
4504 #ifdef USE_GTK
4505 Window parent = FRAME_X_WINDOW (f);
4506 #else
4507 Window parent = FRAME_OUTER_WINDOW (f);
4508 #endif
4509 attrs.cursor = f->output_data.x->hourglass_cursor;
4511 f->output_data.x->hourglass_window
4512 = XCreateWindow (dpy, parent,
4513 0, 0, 32000, 32000, 0, 0,
4514 InputOnly,
4515 CopyFromParent,
4516 mask, &attrs);
4519 XMapRaised (dpy, f->output_data.x->hourglass_window);
4520 XFlush (dpy);
4525 hourglass_shown_p = 1;
4526 UNBLOCK_INPUT;
4531 /* Hide the hourglass pointer on all frames, if it is currently
4532 shown. */
4534 static void
4535 hide_hourglass ()
4537 if (hourglass_shown_p)
4539 Lisp_Object rest, frame;
4541 BLOCK_INPUT;
4542 FOR_EACH_FRAME (rest, frame)
4544 struct frame *f = XFRAME (frame);
4546 if (FRAME_X_P (f)
4547 /* Watch out for newly created frames. */
4548 && f->output_data.x->hourglass_window)
4550 XUnmapWindow (FRAME_X_DISPLAY (f),
4551 f->output_data.x->hourglass_window);
4552 /* Sync here because XTread_socket looks at the
4553 hourglass_p flag that is reset to zero below. */
4554 XSync (FRAME_X_DISPLAY (f), False);
4555 f->output_data.x->hourglass_p = 0;
4559 hourglass_shown_p = 0;
4560 UNBLOCK_INPUT;
4566 /***********************************************************************
4567 Tool tips
4568 ***********************************************************************/
4570 static Lisp_Object x_create_tip_frame P_ ((struct x_display_info *,
4571 Lisp_Object, Lisp_Object));
4572 static void compute_tip_xy P_ ((struct frame *, Lisp_Object, Lisp_Object,
4573 Lisp_Object, int, int, int *, int *));
4575 /* The frame of a currently visible tooltip. */
4577 Lisp_Object tip_frame;
4579 /* If non-nil, a timer started that hides the last tooltip when it
4580 fires. */
4582 Lisp_Object tip_timer;
4583 Window tip_window;
4585 /* If non-nil, a vector of 3 elements containing the last args
4586 with which x-show-tip was called. See there. */
4588 Lisp_Object last_show_tip_args;
4590 /* Maximum size for tooltips; a cons (COLUMNS . ROWS). */
4592 Lisp_Object Vx_max_tooltip_size;
4595 static Lisp_Object
4596 unwind_create_tip_frame (frame)
4597 Lisp_Object frame;
4599 Lisp_Object deleted;
4601 deleted = unwind_create_frame (frame);
4602 if (EQ (deleted, Qt))
4604 tip_window = None;
4605 tip_frame = Qnil;
4608 return deleted;
4612 /* Create a frame for a tooltip on the display described by DPYINFO.
4613 PARMS is a list of frame parameters. TEXT is the string to
4614 display in the tip frame. Value is the frame.
4616 Note that functions called here, esp. x_default_parameter can
4617 signal errors, for instance when a specified color name is
4618 undefined. We have to make sure that we're in a consistent state
4619 when this happens. */
4621 static Lisp_Object
4622 x_create_tip_frame (dpyinfo, parms, text)
4623 struct x_display_info *dpyinfo;
4624 Lisp_Object parms, text;
4626 struct frame *f;
4627 Lisp_Object frame, tem;
4628 Lisp_Object name;
4629 long window_prompting = 0;
4630 int width, height;
4631 int count = SPECPDL_INDEX ();
4632 struct gcpro gcpro1, gcpro2, gcpro3;
4633 int face_change_count_before = face_change_count;
4634 Lisp_Object buffer;
4635 struct buffer *old_buffer;
4637 check_x ();
4639 if (dpyinfo->terminal->deleted)
4640 error ("Terminal is being deleted, can't create new frames on it");
4642 parms = Fcopy_alist (parms);
4644 /* Get the name of the frame to use for resource lookup. */
4645 name = x_get_arg (dpyinfo, parms, Qname, "name", "Name", RES_TYPE_STRING);
4646 if (!STRINGP (name)
4647 && !EQ (name, Qunbound)
4648 && !NILP (name))
4649 error ("Invalid frame name--not a string or nil");
4651 frame = Qnil;
4652 GCPRO3 (parms, name, frame);
4653 f = make_frame (1);
4654 XSETFRAME (frame, f);
4656 buffer = Fget_buffer_create (build_string (" *tip*"));
4657 Fset_window_buffer (FRAME_ROOT_WINDOW (f), buffer, Qnil);
4658 old_buffer = current_buffer;
4659 set_buffer_internal_1 (XBUFFER (buffer));
4660 current_buffer->truncate_lines = Qnil;
4661 specbind (Qinhibit_read_only, Qt);
4662 specbind (Qinhibit_modification_hooks, Qt);
4663 Ferase_buffer ();
4664 Finsert (1, &text);
4665 set_buffer_internal_1 (old_buffer);
4667 FRAME_CAN_HAVE_SCROLL_BARS (f) = 0;
4668 record_unwind_protect (unwind_create_tip_frame, frame);
4670 f->terminal = dpyinfo->terminal;
4671 f->terminal->reference_count++;
4673 /* By setting the output method, we're essentially saying that
4674 the frame is live, as per FRAME_LIVE_P. If we get a signal
4675 from this point on, x_destroy_window might screw up reference
4676 counts etc. */
4677 f->output_method = output_x_window;
4678 f->output_data.x = (struct x_output *) xmalloc (sizeof (struct x_output));
4679 bzero (f->output_data.x, sizeof (struct x_output));
4680 f->output_data.x->icon_bitmap = -1;
4681 FRAME_FONTSET (f) = -1;
4682 f->output_data.x->scroll_bar_foreground_pixel = -1;
4683 f->output_data.x->scroll_bar_background_pixel = -1;
4684 #ifdef USE_TOOLKIT_SCROLL_BARS
4685 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
4686 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
4687 #endif /* USE_TOOLKIT_SCROLL_BARS */
4688 f->icon_name = Qnil;
4689 FRAME_X_DISPLAY_INFO (f) = dpyinfo;
4690 #if GLYPH_DEBUG
4691 image_cache_refcount = FRAME_X_IMAGE_CACHE (f)->refcount;
4692 dpyinfo_refcount = dpyinfo->reference_count;
4693 #endif /* GLYPH_DEBUG */
4694 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
4695 f->output_data.x->explicit_parent = 0;
4697 /* These colors will be set anyway later, but it's important
4698 to get the color reference counts right, so initialize them! */
4700 Lisp_Object black;
4701 struct gcpro gcpro1;
4703 /* Function x_decode_color can signal an error. Make
4704 sure to initialize color slots so that we won't try
4705 to free colors we haven't allocated. */
4706 FRAME_FOREGROUND_PIXEL (f) = -1;
4707 FRAME_BACKGROUND_PIXEL (f) = -1;
4708 f->output_data.x->cursor_pixel = -1;
4709 f->output_data.x->cursor_foreground_pixel = -1;
4710 f->output_data.x->border_pixel = -1;
4711 f->output_data.x->mouse_pixel = -1;
4713 black = build_string ("black");
4714 GCPRO1 (black);
4715 FRAME_FOREGROUND_PIXEL (f)
4716 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4717 FRAME_BACKGROUND_PIXEL (f)
4718 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4719 f->output_data.x->cursor_pixel
4720 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4721 f->output_data.x->cursor_foreground_pixel
4722 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4723 f->output_data.x->border_pixel
4724 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4725 f->output_data.x->mouse_pixel
4726 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4727 UNGCPRO;
4730 /* Set the name; the functions to which we pass f expect the name to
4731 be set. */
4732 if (EQ (name, Qunbound) || NILP (name))
4734 f->name = build_string (dpyinfo->x_id_name);
4735 f->explicit_name = 0;
4737 else
4739 f->name = name;
4740 f->explicit_name = 1;
4741 /* use the frame's title when getting resources for this frame. */
4742 specbind (Qx_resource_name, name);
4745 /* Extract the window parameters from the supplied values that are
4746 needed to determine window geometry. */
4748 Lisp_Object font;
4750 font = x_get_arg (dpyinfo, parms, Qfont, "font", "Font", RES_TYPE_STRING);
4752 BLOCK_INPUT;
4753 /* First, try whatever font the caller has specified. */
4754 if (STRINGP (font))
4756 tem = Fquery_fontset (font, Qnil);
4757 if (STRINGP (tem))
4758 font = x_new_fontset (f, SDATA (tem));
4759 else
4760 font = x_new_font (f, SDATA (font));
4763 /* Try out a font which we hope has bold and italic variations. */
4764 if (!STRINGP (font))
4765 font = x_new_font (f, "-adobe-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-1");
4766 if (!STRINGP (font))
4767 font = x_new_font (f, "-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-1");
4768 if (! STRINGP (font))
4769 font = x_new_font (f, "-*-*-medium-r-normal-*-*-140-*-*-c-*-iso8859-1");
4770 if (! STRINGP (font))
4771 /* This was formerly the first thing tried, but it finds too many fonts
4772 and takes too long. */
4773 font = x_new_font (f, "-*-*-medium-r-*-*-*-*-*-*-c-*-iso8859-1");
4774 /* If those didn't work, look for something which will at least work. */
4775 if (! STRINGP (font))
4776 font = x_new_font (f, "-*-fixed-*-*-*-*-*-140-*-*-c-*-iso8859-1");
4777 UNBLOCK_INPUT;
4778 if (! STRINGP (font))
4779 font = build_string ("fixed");
4781 x_default_parameter (f, parms, Qfont, font,
4782 "font", "Font", RES_TYPE_STRING);
4785 x_default_parameter (f, parms, Qborder_width, make_number (2),
4786 "borderWidth", "BorderWidth", RES_TYPE_NUMBER);
4788 /* This defaults to 2 in order to match xterm. We recognize either
4789 internalBorderWidth or internalBorder (which is what xterm calls
4790 it). */
4791 if (NILP (Fassq (Qinternal_border_width, parms)))
4793 Lisp_Object value;
4795 value = x_get_arg (dpyinfo, parms, Qinternal_border_width,
4796 "internalBorder", "internalBorder", RES_TYPE_NUMBER);
4797 if (! EQ (value, Qunbound))
4798 parms = Fcons (Fcons (Qinternal_border_width, value),
4799 parms);
4802 x_default_parameter (f, parms, Qinternal_border_width, make_number (1),
4803 "internalBorderWidth", "internalBorderWidth",
4804 RES_TYPE_NUMBER);
4806 /* Also do the stuff which must be set before the window exists. */
4807 x_default_parameter (f, parms, Qforeground_color, build_string ("black"),
4808 "foreground", "Foreground", RES_TYPE_STRING);
4809 x_default_parameter (f, parms, Qbackground_color, build_string ("white"),
4810 "background", "Background", RES_TYPE_STRING);
4811 x_default_parameter (f, parms, Qmouse_color, build_string ("black"),
4812 "pointerColor", "Foreground", RES_TYPE_STRING);
4813 x_default_parameter (f, parms, Qcursor_color, build_string ("black"),
4814 "cursorColor", "Foreground", RES_TYPE_STRING);
4815 x_default_parameter (f, parms, Qborder_color, build_string ("black"),
4816 "borderColor", "BorderColor", RES_TYPE_STRING);
4818 /* Init faces before x_default_parameter is called for scroll-bar
4819 parameters because that function calls x_set_scroll_bar_width,
4820 which calls change_frame_size, which calls Fset_window_buffer,
4821 which runs hooks, which call Fvertical_motion. At the end, we
4822 end up in init_iterator with a null face cache, which should not
4823 happen. */
4824 init_frame_faces (f);
4826 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
4828 window_prompting = x_figure_window_size (f, parms, 0);
4831 XSetWindowAttributes attrs;
4832 unsigned long mask;
4834 BLOCK_INPUT;
4835 mask = CWBackPixel | CWOverrideRedirect | CWEventMask;
4836 if (DoesSaveUnders (dpyinfo->screen))
4837 mask |= CWSaveUnder;
4839 /* Window managers look at the override-redirect flag to determine
4840 whether or net to give windows a decoration (Xlib spec, chapter
4841 3.2.8). */
4842 attrs.override_redirect = True;
4843 attrs.save_under = True;
4844 attrs.background_pixel = FRAME_BACKGROUND_PIXEL (f);
4845 /* Arrange for getting MapNotify and UnmapNotify events. */
4846 attrs.event_mask = StructureNotifyMask;
4847 tip_window
4848 = FRAME_X_WINDOW (f)
4849 = XCreateWindow (FRAME_X_DISPLAY (f),
4850 FRAME_X_DISPLAY_INFO (f)->root_window,
4851 /* x, y, width, height */
4852 0, 0, 1, 1,
4853 /* Border. */
4855 CopyFromParent, InputOutput, CopyFromParent,
4856 mask, &attrs);
4857 UNBLOCK_INPUT;
4860 x_make_gc (f);
4862 x_default_parameter (f, parms, Qauto_raise, Qnil,
4863 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
4864 x_default_parameter (f, parms, Qauto_lower, Qnil,
4865 "autoLower", "AutoRaiseLower", RES_TYPE_BOOLEAN);
4866 x_default_parameter (f, parms, Qcursor_type, Qbox,
4867 "cursorType", "CursorType", RES_TYPE_SYMBOL);
4869 /* Dimensions, especially FRAME_LINES (f), must be done via change_frame_size.
4870 Change will not be effected unless different from the current
4871 FRAME_LINES (f). */
4872 width = FRAME_COLS (f);
4873 height = FRAME_LINES (f);
4874 SET_FRAME_COLS (f, 0);
4875 FRAME_LINES (f) = 0;
4876 change_frame_size (f, height, width, 1, 0, 0);
4878 /* Add `tooltip' frame parameter's default value. */
4879 if (NILP (Fframe_parameter (frame, intern ("tooltip"))))
4880 Fmodify_frame_parameters (frame, Fcons (Fcons (intern ("tooltip"), Qt),
4881 Qnil));
4883 /* Set up faces after all frame parameters are known. This call
4884 also merges in face attributes specified for new frames.
4886 Frame parameters may be changed if .Xdefaults contains
4887 specifications for the default font. For example, if there is an
4888 `Emacs.default.attributeBackground: pink', the `background-color'
4889 attribute of the frame get's set, which let's the internal border
4890 of the tooltip frame appear in pink. Prevent this. */
4892 Lisp_Object bg = Fframe_parameter (frame, Qbackground_color);
4894 /* Set tip_frame here, so that */
4895 tip_frame = frame;
4896 call1 (Qface_set_after_frame_default, frame);
4898 if (!EQ (bg, Fframe_parameter (frame, Qbackground_color)))
4899 Fmodify_frame_parameters (frame, Fcons (Fcons (Qbackground_color, bg),
4900 Qnil));
4903 Fmodify_frame_parameters (frame, Fcons (Fcons (Qwindow_system, Qx), Qnil));
4905 f->no_split = 1;
4907 UNGCPRO;
4909 /* It is now ok to make the frame official even if we get an error
4910 below. And the frame needs to be on Vframe_list or making it
4911 visible won't work. */
4912 Vframe_list = Fcons (frame, Vframe_list);
4914 /* Now that the frame is official, it counts as a reference to
4915 its display. */
4916 FRAME_X_DISPLAY_INFO (f)->reference_count++;
4918 /* Setting attributes of faces of the tooltip frame from resources
4919 and similar will increment face_change_count, which leads to the
4920 clearing of all current matrices. Since this isn't necessary
4921 here, avoid it by resetting face_change_count to the value it
4922 had before we created the tip frame. */
4923 face_change_count = face_change_count_before;
4925 /* Discard the unwind_protect. */
4926 return unbind_to (count, frame);
4930 /* Compute where to display tip frame F. PARMS is the list of frame
4931 parameters for F. DX and DY are specified offsets from the current
4932 location of the mouse. WIDTH and HEIGHT are the width and height
4933 of the tooltip. Return coordinates relative to the root window of
4934 the display in *ROOT_X, and *ROOT_Y. */
4936 static void
4937 compute_tip_xy (f, parms, dx, dy, width, height, root_x, root_y)
4938 struct frame *f;
4939 Lisp_Object parms, dx, dy;
4940 int width, height;
4941 int *root_x, *root_y;
4943 Lisp_Object left, top;
4944 int win_x, win_y;
4945 Window root, child;
4946 unsigned pmask;
4948 /* User-specified position? */
4949 left = Fcdr (Fassq (Qleft, parms));
4950 top = Fcdr (Fassq (Qtop, parms));
4952 /* Move the tooltip window where the mouse pointer is. Resize and
4953 show it. */
4954 if (!INTEGERP (left) || !INTEGERP (top))
4956 BLOCK_INPUT;
4957 XQueryPointer (FRAME_X_DISPLAY (f), FRAME_X_DISPLAY_INFO (f)->root_window,
4958 &root, &child, root_x, root_y, &win_x, &win_y, &pmask);
4959 UNBLOCK_INPUT;
4962 if (INTEGERP (top))
4963 *root_y = XINT (top);
4964 else if (*root_y + XINT (dy) <= 0)
4965 *root_y = 0; /* Can happen for negative dy */
4966 else if (*root_y + XINT (dy) + height <= FRAME_X_DISPLAY_INFO (f)->height)
4967 /* It fits below the pointer */
4968 *root_y += XINT (dy);
4969 else if (height + XINT (dy) <= *root_y)
4970 /* It fits above the pointer. */
4971 *root_y -= height + XINT (dy);
4972 else
4973 /* Put it on the top. */
4974 *root_y = 0;
4976 if (INTEGERP (left))
4977 *root_x = XINT (left);
4978 else if (*root_x + XINT (dx) <= 0)
4979 *root_x = 0; /* Can happen for negative dx */
4980 else if (*root_x + XINT (dx) + width <= FRAME_X_DISPLAY_INFO (f)->width)
4981 /* It fits to the right of the pointer. */
4982 *root_x += XINT (dx);
4983 else if (width + XINT (dx) <= *root_x)
4984 /* It fits to the left of the pointer. */
4985 *root_x -= width + XINT (dx);
4986 else
4987 /* Put it left-justified on the screen--it ought to fit that way. */
4988 *root_x = 0;
4992 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
4993 doc: /* Show STRING in a "tooltip" window on frame FRAME.
4994 A tooltip window is a small X window displaying a string.
4996 FRAME nil or omitted means use the selected frame.
4998 PARMS is an optional list of frame parameters which can be used to
4999 change the tooltip's appearance.
5001 Automatically hide the tooltip after TIMEOUT seconds. TIMEOUT nil
5002 means use the default timeout of 5 seconds.
5004 If the list of frame parameters PARAMS contains a `left' parameters,
5005 the tooltip is displayed at that x-position. Otherwise it is
5006 displayed at the mouse position, with offset DX added (default is 5 if
5007 DX isn't specified). Likewise for the y-position; if a `top' frame
5008 parameter is specified, it determines the y-position of the tooltip
5009 window, otherwise it is displayed at the mouse position, with offset
5010 DY added (default is -10).
5012 A tooltip's maximum size is specified by `x-max-tooltip-size'.
5013 Text larger than the specified size is clipped. */)
5014 (string, frame, parms, timeout, dx, dy)
5015 Lisp_Object string, frame, parms, timeout, dx, dy;
5017 struct frame *f;
5018 struct window *w;
5019 int root_x, root_y;
5020 struct buffer *old_buffer;
5021 struct text_pos pos;
5022 int i, width, height;
5023 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
5024 int old_windows_or_buffers_changed = windows_or_buffers_changed;
5025 int count = SPECPDL_INDEX ();
5027 specbind (Qinhibit_redisplay, Qt);
5029 GCPRO4 (string, parms, frame, timeout);
5031 CHECK_STRING (string);
5032 f = check_x_frame (frame);
5033 if (NILP (timeout))
5034 timeout = make_number (5);
5035 else
5036 CHECK_NATNUM (timeout);
5038 if (NILP (dx))
5039 dx = make_number (5);
5040 else
5041 CHECK_NUMBER (dx);
5043 if (NILP (dy))
5044 dy = make_number (-10);
5045 else
5046 CHECK_NUMBER (dy);
5048 if (NILP (last_show_tip_args))
5049 last_show_tip_args = Fmake_vector (make_number (3), Qnil);
5051 if (!NILP (tip_frame))
5053 Lisp_Object last_string = AREF (last_show_tip_args, 0);
5054 Lisp_Object last_frame = AREF (last_show_tip_args, 1);
5055 Lisp_Object last_parms = AREF (last_show_tip_args, 2);
5057 if (EQ (frame, last_frame)
5058 && !NILP (Fequal (last_string, string))
5059 && !NILP (Fequal (last_parms, parms)))
5061 struct frame *f = XFRAME (tip_frame);
5063 /* Only DX and DY have changed. */
5064 if (!NILP (tip_timer))
5066 Lisp_Object timer = tip_timer;
5067 tip_timer = Qnil;
5068 call1 (Qcancel_timer, timer);
5071 BLOCK_INPUT;
5072 compute_tip_xy (f, parms, dx, dy, FRAME_PIXEL_WIDTH (f),
5073 FRAME_PIXEL_HEIGHT (f), &root_x, &root_y);
5074 XMoveWindow (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
5075 root_x, root_y);
5076 UNBLOCK_INPUT;
5077 goto start_timer;
5081 /* Hide a previous tip, if any. */
5082 Fx_hide_tip ();
5084 ASET (last_show_tip_args, 0, string);
5085 ASET (last_show_tip_args, 1, frame);
5086 ASET (last_show_tip_args, 2, parms);
5088 /* Add default values to frame parameters. */
5089 if (NILP (Fassq (Qname, parms)))
5090 parms = Fcons (Fcons (Qname, build_string ("tooltip")), parms);
5091 if (NILP (Fassq (Qinternal_border_width, parms)))
5092 parms = Fcons (Fcons (Qinternal_border_width, make_number (3)), parms);
5093 if (NILP (Fassq (Qborder_width, parms)))
5094 parms = Fcons (Fcons (Qborder_width, make_number (1)), parms);
5095 if (NILP (Fassq (Qborder_color, parms)))
5096 parms = Fcons (Fcons (Qborder_color, build_string ("lightyellow")), parms);
5097 if (NILP (Fassq (Qbackground_color, parms)))
5098 parms = Fcons (Fcons (Qbackground_color, build_string ("lightyellow")),
5099 parms);
5101 /* Create a frame for the tooltip, and record it in the global
5102 variable tip_frame. */
5103 frame = x_create_tip_frame (FRAME_X_DISPLAY_INFO (f), parms, string);
5104 f = XFRAME (frame);
5106 /* Set up the frame's root window. */
5107 w = XWINDOW (FRAME_ROOT_WINDOW (f));
5108 w->left_col = w->top_line = make_number (0);
5110 if (CONSP (Vx_max_tooltip_size)
5111 && INTEGERP (XCAR (Vx_max_tooltip_size))
5112 && XINT (XCAR (Vx_max_tooltip_size)) > 0
5113 && INTEGERP (XCDR (Vx_max_tooltip_size))
5114 && XINT (XCDR (Vx_max_tooltip_size)) > 0)
5116 w->total_cols = XCAR (Vx_max_tooltip_size);
5117 w->total_lines = XCDR (Vx_max_tooltip_size);
5119 else
5121 w->total_cols = make_number (80);
5122 w->total_lines = make_number (40);
5125 FRAME_TOTAL_COLS (f) = XINT (w->total_cols);
5126 adjust_glyphs (f);
5127 w->pseudo_window_p = 1;
5129 /* Display the tooltip text in a temporary buffer. */
5130 old_buffer = current_buffer;
5131 set_buffer_internal_1 (XBUFFER (XWINDOW (FRAME_ROOT_WINDOW (f))->buffer));
5132 current_buffer->truncate_lines = Qnil;
5133 clear_glyph_matrix (w->desired_matrix);
5134 clear_glyph_matrix (w->current_matrix);
5135 SET_TEXT_POS (pos, BEGV, BEGV_BYTE);
5136 try_window (FRAME_ROOT_WINDOW (f), pos, 0);
5138 /* Compute width and height of the tooltip. */
5139 width = height = 0;
5140 for (i = 0; i < w->desired_matrix->nrows; ++i)
5142 struct glyph_row *row = &w->desired_matrix->rows[i];
5143 struct glyph *last;
5144 int row_width;
5146 /* Stop at the first empty row at the end. */
5147 if (!row->enabled_p || !row->displays_text_p)
5148 break;
5150 /* Let the row go over the full width of the frame. */
5151 row->full_width_p = 1;
5153 /* There's a glyph at the end of rows that is used to place
5154 the cursor there. Don't include the width of this glyph. */
5155 if (row->used[TEXT_AREA])
5157 last = &row->glyphs[TEXT_AREA][row->used[TEXT_AREA] - 1];
5158 row_width = row->pixel_width - last->pixel_width;
5160 else
5161 row_width = row->pixel_width;
5163 height += row->height;
5164 width = max (width, row_width);
5167 /* Add the frame's internal border to the width and height the X
5168 window should have. */
5169 height += 2 * FRAME_INTERNAL_BORDER_WIDTH (f);
5170 width += 2 * FRAME_INTERNAL_BORDER_WIDTH (f);
5172 /* Move the tooltip window where the mouse pointer is. Resize and
5173 show it. */
5174 compute_tip_xy (f, parms, dx, dy, width, height, &root_x, &root_y);
5176 BLOCK_INPUT;
5177 XMoveResizeWindow (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
5178 root_x, root_y, width, height);
5179 XMapRaised (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f));
5180 UNBLOCK_INPUT;
5182 /* Draw into the window. */
5183 w->must_be_updated_p = 1;
5184 update_single_window (w, 1);
5186 /* Restore original current buffer. */
5187 set_buffer_internal_1 (old_buffer);
5188 windows_or_buffers_changed = old_windows_or_buffers_changed;
5190 start_timer:
5191 /* Let the tip disappear after timeout seconds. */
5192 tip_timer = call3 (intern ("run-at-time"), timeout, Qnil,
5193 intern ("x-hide-tip"));
5195 UNGCPRO;
5196 return unbind_to (count, Qnil);
5200 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
5201 doc: /* Hide the current tooltip window, if there is any.
5202 Value is t if tooltip was open, nil otherwise. */)
5205 int count;
5206 Lisp_Object deleted, frame, timer;
5207 struct gcpro gcpro1, gcpro2;
5209 /* Return quickly if nothing to do. */
5210 if (NILP (tip_timer) && NILP (tip_frame))
5211 return Qnil;
5213 frame = tip_frame;
5214 timer = tip_timer;
5215 GCPRO2 (frame, timer);
5216 tip_frame = tip_timer = deleted = Qnil;
5218 count = SPECPDL_INDEX ();
5219 specbind (Qinhibit_redisplay, Qt);
5220 specbind (Qinhibit_quit, Qt);
5222 if (!NILP (timer))
5223 call1 (Qcancel_timer, timer);
5225 if (FRAMEP (frame))
5227 Fdelete_frame (frame, Qnil);
5228 deleted = Qt;
5230 #ifdef USE_LUCID
5231 /* Bloodcurdling hack alert: The Lucid menu bar widget's
5232 redisplay procedure is not called when a tip frame over menu
5233 items is unmapped. Redisplay the menu manually... */
5235 struct frame *f = SELECTED_FRAME ();
5236 Widget w = f->output_data.x->menubar_widget;
5237 extern void xlwmenu_redisplay P_ ((Widget));
5239 if (!DoesSaveUnders (FRAME_X_DISPLAY_INFO (f)->screen)
5240 && w != NULL)
5242 BLOCK_INPUT;
5243 xlwmenu_redisplay (w);
5244 UNBLOCK_INPUT;
5247 #endif /* USE_LUCID */
5250 UNGCPRO;
5251 return unbind_to (count, deleted);
5256 /***********************************************************************
5257 File selection dialog
5258 ***********************************************************************/
5260 DEFUN ("x-uses-old-gtk-dialog", Fx_uses_old_gtk_dialog,
5261 Sx_uses_old_gtk_dialog,
5262 0, 0, 0,
5263 doc: /* Return t if the old Gtk+ file selection dialog is used. */)
5266 #ifdef USE_GTK
5267 extern int use_dialog_box;
5268 extern int use_file_dialog;
5270 if (use_dialog_box
5271 && use_file_dialog
5272 && have_menus_p ()
5273 && xg_uses_old_file_dialog ())
5274 return Qt;
5275 #endif
5276 return Qnil;
5280 #ifdef USE_MOTIF
5281 /* Callback for "OK" and "Cancel" on file selection dialog. */
5283 static void
5284 file_dialog_cb (widget, client_data, call_data)
5285 Widget widget;
5286 XtPointer call_data, client_data;
5288 int *result = (int *) client_data;
5289 XmAnyCallbackStruct *cb = (XmAnyCallbackStruct *) call_data;
5290 *result = cb->reason;
5294 /* Callback for unmapping a file selection dialog. This is used to
5295 capture the case where a dialog is closed via a window manager's
5296 closer button, for example. Using a XmNdestroyCallback didn't work
5297 in this case. */
5299 static void
5300 file_dialog_unmap_cb (widget, client_data, call_data)
5301 Widget widget;
5302 XtPointer call_data, client_data;
5304 int *result = (int *) client_data;
5305 *result = XmCR_CANCEL;
5308 static Lisp_Object
5309 clean_up_file_dialog (arg)
5310 Lisp_Object arg;
5312 struct Lisp_Save_Value *p = XSAVE_VALUE (arg);
5313 Widget dialog = (Widget) p->pointer;
5315 /* Clean up. */
5316 BLOCK_INPUT;
5317 XtUnmanageChild (dialog);
5318 XtDestroyWidget (dialog);
5319 x_menu_set_in_use (0);
5320 UNBLOCK_INPUT;
5322 return Qnil;
5326 DEFUN ("x-file-dialog", Fx_file_dialog, Sx_file_dialog, 2, 5, 0,
5327 doc: /* Read file name, prompting with PROMPT in directory DIR.
5328 Use a file selection dialog. Select DEFAULT-FILENAME in the dialog's file
5329 selection box, if specified. If MUSTMATCH is non-nil, the returned file
5330 or directory must exist. ONLY-DIR-P is ignored." */)
5331 (prompt, dir, default_filename, mustmatch, only_dir_p)
5332 Lisp_Object prompt, dir, default_filename, mustmatch, only_dir_p;
5334 int result;
5335 struct frame *f = SELECTED_FRAME ();
5336 Lisp_Object file = Qnil;
5337 Lisp_Object decoded_file;
5338 Widget dialog, text, help;
5339 Arg al[10];
5340 int ac = 0;
5341 extern XtAppContext Xt_app_con;
5342 XmString dir_xmstring, pattern_xmstring;
5343 int count = SPECPDL_INDEX ();
5344 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
5346 GCPRO6 (prompt, dir, default_filename, mustmatch, only_dir_p, file);
5348 if (popup_activated ())
5349 error ("Trying to use a menu from within a menu-entry");
5351 CHECK_STRING (prompt);
5352 CHECK_STRING (dir);
5354 /* Prevent redisplay. */
5355 specbind (Qinhibit_redisplay, Qt);
5357 BLOCK_INPUT;
5359 /* Create the dialog with PROMPT as title, using DIR as initial
5360 directory and using "*" as pattern. */
5361 dir = Fexpand_file_name (dir, Qnil);
5362 dir_xmstring = XmStringCreateLocalized (SDATA (dir));
5363 pattern_xmstring = XmStringCreateLocalized ("*");
5365 XtSetArg (al[ac], XmNtitle, SDATA (prompt)); ++ac;
5366 XtSetArg (al[ac], XmNdirectory, dir_xmstring); ++ac;
5367 XtSetArg (al[ac], XmNpattern, pattern_xmstring); ++ac;
5368 XtSetArg (al[ac], XmNresizePolicy, XmRESIZE_GROW); ++ac;
5369 XtSetArg (al[ac], XmNdialogStyle, XmDIALOG_APPLICATION_MODAL); ++ac;
5370 dialog = XmCreateFileSelectionDialog (f->output_data.x->widget,
5371 "fsb", al, ac);
5372 XmStringFree (dir_xmstring);
5373 XmStringFree (pattern_xmstring);
5375 /* Add callbacks for OK and Cancel. */
5376 XtAddCallback (dialog, XmNokCallback, file_dialog_cb,
5377 (XtPointer) &result);
5378 XtAddCallback (dialog, XmNcancelCallback, file_dialog_cb,
5379 (XtPointer) &result);
5380 XtAddCallback (dialog, XmNunmapCallback, file_dialog_unmap_cb,
5381 (XtPointer) &result);
5383 /* Remove the help button since we can't display help. */
5384 help = XmFileSelectionBoxGetChild (dialog, XmDIALOG_HELP_BUTTON);
5385 XtUnmanageChild (help);
5387 /* Mark OK button as default. */
5388 XtVaSetValues (XmFileSelectionBoxGetChild (dialog, XmDIALOG_OK_BUTTON),
5389 XmNshowAsDefault, True, NULL);
5391 /* If MUSTMATCH is non-nil, disable the file entry field of the
5392 dialog, so that the user must select a file from the files list
5393 box. We can't remove it because we wouldn't have a way to get at
5394 the result file name, then. */
5395 text = XmFileSelectionBoxGetChild (dialog, XmDIALOG_TEXT);
5396 if (!NILP (mustmatch))
5398 Widget label;
5399 label = XmFileSelectionBoxGetChild (dialog, XmDIALOG_SELECTION_LABEL);
5400 XtSetSensitive (text, False);
5401 XtSetSensitive (label, False);
5404 /* Manage the dialog, so that list boxes get filled. */
5405 XtManageChild (dialog);
5407 if (STRINGP (default_filename))
5409 XmString default_xmstring;
5410 Widget wtext = XmFileSelectionBoxGetChild (dialog, XmDIALOG_TEXT);
5411 Widget list = XmFileSelectionBoxGetChild (dialog, XmDIALOG_LIST);
5413 XmTextPosition last_pos = XmTextFieldGetLastPosition (wtext);
5414 XmTextFieldReplace (wtext, 0, last_pos,
5415 (SDATA (Ffile_name_nondirectory (default_filename))));
5417 /* Select DEFAULT_FILENAME in the files list box. DEFAULT_FILENAME
5418 must include the path for this to work. */
5420 default_xmstring = XmStringCreateLocalized (SDATA (default_filename));
5422 if (XmListItemExists (list, default_xmstring))
5424 int item_pos = XmListItemPos (list, default_xmstring);
5425 /* Select the item and scroll it into view. */
5426 XmListSelectPos (list, item_pos, True);
5427 XmListSetPos (list, item_pos);
5430 XmStringFree (default_xmstring);
5433 record_unwind_protect (clean_up_file_dialog, make_save_value (dialog, 0));
5435 /* Process events until the user presses Cancel or OK. */
5436 x_menu_set_in_use (1);
5437 result = 0;
5438 while (result == 0)
5440 XEvent event;
5441 x_menu_wait_for_event (0);
5442 XtAppNextEvent (Xt_app_con, &event);
5443 if (event.type == KeyPress
5444 && FRAME_X_DISPLAY (f) == event.xkey.display)
5446 KeySym keysym = XLookupKeysym (&event.xkey, 0);
5448 /* Pop down on C-g. */
5449 if (keysym == XK_g && (event.xkey.state & ControlMask) != 0)
5450 XtUnmanageChild (dialog);
5453 (void) x_dispatch_event (&event, FRAME_X_DISPLAY (f));
5456 /* Get the result. */
5457 if (result == XmCR_OK)
5459 XmString text;
5460 String data;
5462 XtVaGetValues (dialog, XmNtextString, &text, NULL);
5463 XmStringGetLtoR (text, XmFONTLIST_DEFAULT_TAG, &data);
5464 XmStringFree (text);
5465 file = build_string (data);
5466 XtFree (data);
5468 else
5469 file = Qnil;
5471 UNBLOCK_INPUT;
5472 UNGCPRO;
5474 /* Make "Cancel" equivalent to C-g. */
5475 if (NILP (file))
5476 Fsignal (Qquit, Qnil);
5478 decoded_file = DECODE_FILE (file);
5480 return unbind_to (count, decoded_file);
5483 #endif /* USE_MOTIF */
5485 #ifdef USE_GTK
5487 static Lisp_Object
5488 clean_up_dialog (arg)
5489 Lisp_Object arg;
5491 x_menu_set_in_use (0);
5493 return Qnil;
5496 DEFUN ("x-file-dialog", Fx_file_dialog, Sx_file_dialog, 2, 5, 0,
5497 doc: /* Read file name, prompting with PROMPT in directory DIR.
5498 Use a file selection dialog. Select DEFAULT-FILENAME in the dialog's file
5499 selection box, if specified. If MUSTMATCH is non-nil, the returned file
5500 or directory must exist. If ONLY-DIR-P is non-nil, the user can only select
5501 directories. */)
5502 (prompt, dir, default_filename, mustmatch, only_dir_p)
5503 Lisp_Object prompt, dir, default_filename, mustmatch, only_dir_p;
5505 FRAME_PTR f = SELECTED_FRAME ();
5506 char *fn;
5507 Lisp_Object file = Qnil;
5508 Lisp_Object decoded_file;
5509 int count = SPECPDL_INDEX ();
5510 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
5511 char *cdef_file;
5513 GCPRO6 (prompt, dir, default_filename, mustmatch, only_dir_p, file);
5515 if (popup_activated ())
5516 error ("Trying to use a menu from within a menu-entry");
5518 CHECK_STRING (prompt);
5519 CHECK_STRING (dir);
5521 /* Prevent redisplay. */
5522 specbind (Qinhibit_redisplay, Qt);
5523 record_unwind_protect (clean_up_dialog, Qnil);
5525 BLOCK_INPUT;
5527 if (STRINGP (default_filename))
5528 cdef_file = SDATA (default_filename);
5529 else
5530 cdef_file = SDATA (dir);
5532 fn = xg_get_file_name (f, SDATA (prompt), cdef_file,
5533 ! NILP (mustmatch),
5534 ! NILP (only_dir_p));
5536 if (fn)
5538 file = build_string (fn);
5539 xfree (fn);
5542 UNBLOCK_INPUT;
5543 UNGCPRO;
5545 /* Make "Cancel" equivalent to C-g. */
5546 if (NILP (file))
5547 Fsignal (Qquit, Qnil);
5549 decoded_file = DECODE_FILE (file);
5551 return unbind_to (count, decoded_file);
5554 #endif /* USE_GTK */
5557 /***********************************************************************
5558 Keyboard
5559 ***********************************************************************/
5561 #ifdef HAVE_XKBGETKEYBOARD
5562 #include <X11/XKBlib.h>
5563 #include <X11/keysym.h>
5564 #endif
5566 DEFUN ("x-backspace-delete-keys-p", Fx_backspace_delete_keys_p,
5567 Sx_backspace_delete_keys_p, 0, 1, 0,
5568 doc: /* Check if both Backspace and Delete keys are on the keyboard of FRAME.
5569 FRAME nil means use the selected frame.
5570 Value is t if we know that both keys are present, and are mapped to the
5571 usual X keysyms. Value is `lambda' if we cannot determine if both keys are
5572 present and mapped to the usual X keysyms. */)
5573 (frame)
5574 Lisp_Object frame;
5576 #ifdef HAVE_XKBGETKEYBOARD
5577 XkbDescPtr kb;
5578 struct frame *f = check_x_frame (frame);
5579 Display *dpy = FRAME_X_DISPLAY (f);
5580 Lisp_Object have_keys;
5581 int major, minor, op, event, error;
5583 BLOCK_INPUT;
5585 /* Check library version in case we're dynamically linked. */
5586 major = XkbMajorVersion;
5587 minor = XkbMinorVersion;
5588 if (!XkbLibraryVersion (&major, &minor))
5590 UNBLOCK_INPUT;
5591 return Qlambda;
5594 /* Check that the server supports XKB. */
5595 major = XkbMajorVersion;
5596 minor = XkbMinorVersion;
5597 if (!XkbQueryExtension (dpy, &op, &event, &error, &major, &minor))
5599 UNBLOCK_INPUT;
5600 return Qlambda;
5603 /* In this code we check that the keyboard has physical keys with names
5604 that start with BKSP (Backspace) and DELE (Delete), and that they
5605 generate keysym XK_BackSpace and XK_Delete respectively.
5606 This function is used to test if normal-erase-is-backspace should be
5607 turned on.
5608 An alternative approach would be to just check if XK_BackSpace and
5609 XK_Delete are mapped to any key. But if any of those are mapped to
5610 some non-intuitive key combination (Meta-Shift-Ctrl-whatever) and the
5611 user doesn't know about it, it is better to return false here.
5612 It is more obvious to the user what to do if she/he has two keys
5613 clearly marked with names/symbols and one key does something not
5614 expected (i.e. she/he then tries the other).
5615 The cases where Backspace/Delete is mapped to some other key combination
5616 are rare, and in those cases, normal-erase-is-backspace can be turned on
5617 manually. */
5619 have_keys = Qnil;
5620 kb = XkbGetMap (dpy, XkbAllMapComponentsMask, XkbUseCoreKbd);
5621 if (kb)
5623 int delete_keycode = 0, backspace_keycode = 0, i;
5625 if (XkbGetNames (dpy, XkbAllNamesMask, kb) == Success)
5627 for (i = kb->min_key_code;
5628 (i < kb->max_key_code
5629 && (delete_keycode == 0 || backspace_keycode == 0));
5630 ++i)
5632 /* The XKB symbolic key names can be seen most easily in
5633 the PS file generated by `xkbprint -label name
5634 $DISPLAY'. */
5635 if (bcmp ("DELE", kb->names->keys[i].name, 4) == 0)
5636 delete_keycode = i;
5637 else if (bcmp ("BKSP", kb->names->keys[i].name, 4) == 0)
5638 backspace_keycode = i;
5641 XkbFreeNames (kb, 0, True);
5644 XkbFreeClientMap (kb, 0, True);
5646 if (delete_keycode
5647 && backspace_keycode
5648 && XKeysymToKeycode (dpy, XK_Delete) == delete_keycode
5649 && XKeysymToKeycode (dpy, XK_BackSpace) == backspace_keycode)
5650 have_keys = Qt;
5652 UNBLOCK_INPUT;
5653 return have_keys;
5654 #else /* not HAVE_XKBGETKEYBOARD */
5655 return Qlambda;
5656 #endif /* not HAVE_XKBGETKEYBOARD */
5661 /***********************************************************************
5662 Initialization
5663 ***********************************************************************/
5665 /* Keep this list in the same order as frame_parms in frame.c.
5666 Use 0 for unsupported frame parameters. */
5668 frame_parm_handler x_frame_parm_handlers[] =
5670 x_set_autoraise,
5671 x_set_autolower,
5672 x_set_background_color,
5673 x_set_border_color,
5674 x_set_border_width,
5675 x_set_cursor_color,
5676 x_set_cursor_type,
5677 x_set_font,
5678 x_set_foreground_color,
5679 x_set_icon_name,
5680 x_set_icon_type,
5681 x_set_internal_border_width,
5682 x_set_menu_bar_lines,
5683 x_set_mouse_color,
5684 x_explicitly_set_name,
5685 x_set_scroll_bar_width,
5686 x_set_title,
5687 x_set_unsplittable,
5688 x_set_vertical_scroll_bars,
5689 x_set_visibility,
5690 x_set_tool_bar_lines,
5691 x_set_scroll_bar_foreground,
5692 x_set_scroll_bar_background,
5693 x_set_screen_gamma,
5694 x_set_line_spacing,
5695 x_set_fringe_width,
5696 x_set_fringe_width,
5697 x_set_wait_for_wm,
5698 x_set_fullscreen,
5701 void
5702 syms_of_xfns ()
5704 /* This is zero if not using X windows. */
5705 x_in_use = 0;
5707 /* The section below is built by the lisp expression at the top of the file,
5708 just above where these variables are declared. */
5709 /*&&& init symbols here &&&*/
5710 Qnone = intern ("none");
5711 staticpro (&Qnone);
5712 Qsuppress_icon = intern ("suppress-icon");
5713 staticpro (&Qsuppress_icon);
5714 Qundefined_color = intern ("undefined-color");
5715 staticpro (&Qundefined_color);
5716 Qcompound_text = intern ("compound-text");
5717 staticpro (&Qcompound_text);
5718 Qcancel_timer = intern ("cancel-timer");
5719 staticpro (&Qcancel_timer);
5720 /* This is the end of symbol initialization. */
5722 /* Text property `display' should be nonsticky by default. */
5723 Vtext_property_default_nonsticky
5724 = Fcons (Fcons (Qdisplay, Qt), Vtext_property_default_nonsticky);
5727 Fput (Qundefined_color, Qerror_conditions,
5728 Fcons (Qundefined_color, Fcons (Qerror, Qnil)));
5729 Fput (Qundefined_color, Qerror_message,
5730 build_string ("Undefined color"));
5732 DEFVAR_LISP ("x-pointer-shape", &Vx_pointer_shape,
5733 doc: /* The shape of the pointer when over text.
5734 Changing the value does not affect existing frames
5735 unless you set the mouse color. */);
5736 Vx_pointer_shape = Qnil;
5738 #if 0 /* This doesn't really do anything. */
5739 DEFVAR_LISP ("x-nontext-pointer-shape", &Vx_nontext_pointer_shape,
5740 doc: /* The shape of the pointer when not over text.
5741 This variable takes effect when you create a new frame
5742 or when you set the mouse color. */);
5743 #endif
5744 Vx_nontext_pointer_shape = Qnil;
5746 DEFVAR_LISP ("x-hourglass-pointer-shape", &Vx_hourglass_pointer_shape,
5747 doc: /* The shape of the pointer when Emacs is busy.
5748 This variable takes effect when you create a new frame
5749 or when you set the mouse color. */);
5750 Vx_hourglass_pointer_shape = Qnil;
5752 DEFVAR_BOOL ("display-hourglass", &display_hourglass_p,
5753 doc: /* Non-zero means Emacs displays an hourglass pointer on window systems. */);
5754 display_hourglass_p = 1;
5756 DEFVAR_LISP ("hourglass-delay", &Vhourglass_delay,
5757 doc: /* *Seconds to wait before displaying an hourglass pointer.
5758 Value must be an integer or float. */);
5759 Vhourglass_delay = make_number (DEFAULT_HOURGLASS_DELAY);
5761 #if 0 /* This doesn't really do anything. */
5762 DEFVAR_LISP ("x-mode-pointer-shape", &Vx_mode_pointer_shape,
5763 doc: /* The shape of the pointer when over the mode line.
5764 This variable takes effect when you create a new frame
5765 or when you set the mouse color. */);
5766 #endif
5767 Vx_mode_pointer_shape = Qnil;
5769 DEFVAR_LISP ("x-sensitive-text-pointer-shape",
5770 &Vx_sensitive_text_pointer_shape,
5771 doc: /* The shape of the pointer when over mouse-sensitive text.
5772 This variable takes effect when you create a new frame
5773 or when you set the mouse color. */);
5774 Vx_sensitive_text_pointer_shape = Qnil;
5776 DEFVAR_LISP ("x-window-horizontal-drag-cursor",
5777 &Vx_window_horizontal_drag_shape,
5778 doc: /* Pointer shape to use for indicating a window can be dragged horizontally.
5779 This variable takes effect when you create a new frame
5780 or when you set the mouse color. */);
5781 Vx_window_horizontal_drag_shape = Qnil;
5783 DEFVAR_LISP ("x-cursor-fore-pixel", &Vx_cursor_fore_pixel,
5784 doc: /* A string indicating the foreground color of the cursor box. */);
5785 Vx_cursor_fore_pixel = Qnil;
5787 DEFVAR_LISP ("x-max-tooltip-size", &Vx_max_tooltip_size,
5788 doc: /* Maximum size for tooltips. Value is a pair (COLUMNS . ROWS).
5789 Text larger than this is clipped. */);
5790 Vx_max_tooltip_size = Fcons (make_number (80), make_number (40));
5792 DEFVAR_LISP ("x-no-window-manager", &Vx_no_window_manager,
5793 doc: /* Non-nil if no X window manager is in use.
5794 Emacs doesn't try to figure this out; this is always nil
5795 unless you set it to something else. */);
5796 /* We don't have any way to find this out, so set it to nil
5797 and maybe the user would like to set it to t. */
5798 Vx_no_window_manager = Qnil;
5800 DEFVAR_LISP ("x-pixel-size-width-font-regexp",
5801 &Vx_pixel_size_width_font_regexp,
5802 doc: /* Regexp matching a font name whose width is the same as `PIXEL_SIZE'.
5804 Since Emacs gets width of a font matching with this regexp from
5805 PIXEL_SIZE field of the name, font finding mechanism gets faster for
5806 such a font. This is especially effective for such large fonts as
5807 Chinese, Japanese, and Korean. */);
5808 Vx_pixel_size_width_font_regexp = Qnil;
5810 /* This is not ifdef:ed, so other builds than GTK can customize it. */
5811 DEFVAR_BOOL ("x-use-old-gtk-file-dialog", &x_use_old_gtk_file_dialog,
5812 doc: /* *Non-nil means prompt with the old GTK file selection dialog.
5813 If nil or if the file selection dialog is not available, the new GTK file
5814 chooser is used instead. To turn off all file dialogs set the
5815 variable `use-file-dialog'. */);
5816 x_use_old_gtk_file_dialog = 0;
5818 DEFVAR_BOOL ("x-gtk-show-hidden-files", &x_gtk_show_hidden_files,
5819 doc: /* *If non-nil, the GTK file chooser will by default show hidden files.
5820 Note that this is just the default, there is a toggle button on the file
5821 chooser to show or not show hidden files on a case by case basis. */);
5822 x_gtk_show_hidden_files = 0;
5824 DEFVAR_BOOL ("x-gtk-whole-detached-tool-bar", &x_gtk_whole_detached_tool_bar,
5825 doc: /* *If non-nil, a detached tool bar is shown in full.
5826 The default is to just show an arrow and pressing on that arrow shows
5827 the tool bar buttons. */);
5828 x_gtk_whole_detached_tool_bar = 0;
5830 Fprovide (intern ("x"), Qnil);
5832 #ifdef USE_X_TOOLKIT
5833 Fprovide (intern ("x-toolkit"), Qnil);
5834 #ifdef USE_MOTIF
5835 Fprovide (intern ("motif"), Qnil);
5837 DEFVAR_LISP ("motif-version-string", &Vmotif_version_string,
5838 doc: /* Version info for LessTif/Motif. */);
5839 Vmotif_version_string = build_string (XmVERSION_STRING);
5840 #endif /* USE_MOTIF */
5841 #endif /* USE_X_TOOLKIT */
5843 #ifdef USE_GTK
5844 /* Provide x-toolkit also for GTK. Internally GTK does not use Xt so it
5845 is not an X toolkit in that sense (USE_X_TOOLKIT is not defined).
5846 But for a user it is a toolkit for X, and indeed, configure
5847 accepts --with-x-toolkit=gtk. */
5848 Fprovide (intern ("x-toolkit"), Qnil);
5849 Fprovide (intern ("gtk"), Qnil);
5851 DEFVAR_LISP ("gtk-version-string", &Vgtk_version_string,
5852 doc: /* Version info for GTK+. */);
5854 char gtk_version[40];
5855 g_snprintf (gtk_version, sizeof (gtk_version), "%u.%u.%u",
5856 GTK_MAJOR_VERSION, GTK_MINOR_VERSION, GTK_MICRO_VERSION);
5857 Vgtk_version_string = build_string (gtk_version);
5859 #endif /* USE_GTK */
5861 /* X window properties. */
5862 defsubr (&Sx_change_window_property);
5863 defsubr (&Sx_delete_window_property);
5864 defsubr (&Sx_window_property);
5866 defsubr (&Sxw_display_color_p);
5867 defsubr (&Sx_display_grayscale_p);
5868 defsubr (&Sxw_color_defined_p);
5869 defsubr (&Sxw_color_values);
5870 defsubr (&Sx_server_max_request_size);
5871 defsubr (&Sx_server_vendor);
5872 defsubr (&Sx_server_version);
5873 defsubr (&Sx_display_pixel_width);
5874 defsubr (&Sx_display_pixel_height);
5875 defsubr (&Sx_display_mm_width);
5876 defsubr (&Sx_display_mm_height);
5877 defsubr (&Sx_display_screens);
5878 defsubr (&Sx_display_planes);
5879 defsubr (&Sx_display_color_cells);
5880 defsubr (&Sx_display_visual_class);
5881 defsubr (&Sx_display_backing_store);
5882 defsubr (&Sx_display_save_under);
5883 defsubr (&Sx_create_frame);
5884 defsubr (&Sx_open_connection);
5885 defsubr (&Sx_close_connection);
5886 defsubr (&Sx_display_list);
5887 defsubr (&Sx_synchronize);
5888 defsubr (&Sx_focus_frame);
5889 defsubr (&Sx_backspace_delete_keys_p);
5891 /* Setting callback functions for fontset handler. */
5892 get_font_info_func = x_get_font_info;
5894 #if 0 /* This function pointer doesn't seem to be used anywhere.
5895 And the pointer assigned has the wrong type, anyway. */
5896 list_fonts_func = x_list_fonts;
5897 #endif
5899 load_font_func = x_load_font;
5900 find_ccl_program_func = x_find_ccl_program;
5901 query_font_func = x_query_font;
5902 set_frame_fontset_func = x_set_font;
5903 check_window_system_func = check_x;
5905 hourglass_atimer = NULL;
5906 hourglass_shown_p = 0;
5908 defsubr (&Sx_show_tip);
5909 defsubr (&Sx_hide_tip);
5910 tip_timer = Qnil;
5911 staticpro (&tip_timer);
5912 tip_frame = Qnil;
5913 staticpro (&tip_frame);
5915 last_show_tip_args = Qnil;
5916 staticpro (&last_show_tip_args);
5918 defsubr (&Sx_uses_old_gtk_dialog);
5919 #if defined (USE_MOTIF) || defined (USE_GTK)
5920 defsubr (&Sx_file_dialog);
5921 #endif
5924 #endif /* HAVE_X_WINDOWS */
5926 /* arch-tag: 55040d02-5485-4d58-8b22-95a7a05f3288
5927 (do not change this comment) */