* cus-start.el (all): Add native condition for font-use-system-font.
[emacs.git] / src / xfns.c
blob0ae6f95b30bef4b67ba8bbe1cbfcb1a2cd918e90
1 /* Functions for the X window system.
2 Copyright (C) 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
3 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009
4 Free Software Foundation, Inc.
6 This file is part of GNU Emacs.
8 GNU Emacs is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or
11 (at your option) any later version.
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
21 #include <config.h>
22 #include <stdio.h>
23 #include <math.h>
24 #include <setjmp.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 "character.h"
45 #include "charset.h"
46 #include "coding.h"
47 #include "fontset.h"
48 #include "systime.h"
49 #include "termhooks.h"
50 #include "atimer.h"
51 #include "termchar.h"
52 #include "font.h"
54 #ifdef HAVE_X_WINDOWS
56 #include <ctype.h>
57 #include <sys/types.h>
58 #include <sys/stat.h>
60 #if 1 /* Used to be #ifdef EMACS_BITMAP_FILES, but this should always work. */
61 #include "bitmaps/gray.xbm"
62 #else
63 #include <X11/bitmaps/gray>
64 #endif
66 #include "xsettings.h"
68 #ifdef USE_GTK
69 #include "gtkutil.h"
70 #endif
72 #ifdef USE_X_TOOLKIT
73 #include <X11/Shell.h>
75 #ifndef USE_MOTIF
76 #ifdef HAVE_XAW3D
77 #include <X11/Xaw3d/Paned.h>
78 #include <X11/Xaw3d/Label.h>
79 #else /* !HAVE_XAW3D */
80 #include <X11/Xaw/Paned.h>
81 #include <X11/Xaw/Label.h>
82 #endif /* HAVE_XAW3D */
83 #endif /* USE_MOTIF */
85 #ifdef USG
86 #undef USG /* ####KLUDGE for Solaris 2.2 and up */
87 #include <X11/Xos.h>
88 #define USG
89 #else
90 #include <X11/Xos.h>
91 #endif
93 #include "widget.h"
95 #include "../lwlib/lwlib.h"
97 #ifdef USE_MOTIF
98 #include <Xm/Xm.h>
99 #include <Xm/DialogS.h>
100 #include <Xm/FileSB.h>
101 #endif
103 #if !defined(NO_EDITRES)
104 #define HACK_EDITRES
105 extern void _XEditResCheckMessages ();
106 #endif /* not defined NO_EDITRES */
108 /* Unique id counter for widgets created by the Lucid Widget Library. */
110 extern LWLIB_ID widget_id_tick;
112 #ifdef USE_LUCID
113 /* This is part of a kludge--see lwlib/xlwmenu.c. */
114 extern XFontStruct *xlwmenu_default_font;
115 #endif
117 extern void free_frame_menubar ();
118 extern double atof ();
120 #ifdef USE_MOTIF
122 /* LessTif/Motif version info. */
124 static Lisp_Object Vmotif_version_string;
126 #endif /* USE_MOTIF */
128 #endif /* USE_X_TOOLKIT */
130 #ifdef USE_GTK
132 /* GTK+ version info */
134 static Lisp_Object Vgtk_version_string;
136 #endif /* USE_GTK */
138 #define MAXREQUEST(dpy) (XMaxRequestSize (dpy))
140 /* The gray bitmap `bitmaps/gray'. This is done because xterm.c uses
141 it, and including `bitmaps/gray' more than once is a problem when
142 config.h defines `static' as an empty replacement string. */
144 int gray_bitmap_width = gray_width;
145 int gray_bitmap_height = gray_height;
146 char *gray_bitmap_bits = gray_bits;
148 /* Non-zero means prompt with the old GTK file selection dialog. */
150 int x_gtk_use_old_file_dialog;
152 /* If non-zero, by default show hidden files in the GTK file chooser. */
154 int x_gtk_show_hidden_files;
156 /* If non-zero, don't show additional help text in the GTK file chooser. */
158 int x_gtk_file_dialog_help_text;
160 /* If non-zero, don't collapse to tool bar when it is detached. */
162 int x_gtk_whole_detached_tool_bar;
164 /* The background and shape of the mouse pointer, and shape when not
165 over text or in the modeline. */
167 Lisp_Object Vx_pointer_shape, Vx_nontext_pointer_shape, Vx_mode_pointer_shape;
168 Lisp_Object Vx_hourglass_pointer_shape;
170 /* The shape when over mouse-sensitive text. */
172 Lisp_Object Vx_sensitive_text_pointer_shape;
174 /* If non-nil, the pointer shape to indicate that windows can be
175 dragged horizontally. */
177 Lisp_Object Vx_window_horizontal_drag_shape;
179 /* Color of chars displayed in cursor box. */
181 Lisp_Object Vx_cursor_fore_pixel;
183 /* Nonzero if using X. */
185 static int x_in_use;
187 /* Non nil if no window manager is in use. */
189 Lisp_Object Vx_no_window_manager;
191 /* Regexp matching a font name whose width is the same as `PIXEL_SIZE'. */
193 Lisp_Object Vx_pixel_size_width_font_regexp;
195 Lisp_Object Qnone;
196 Lisp_Object Qsuppress_icon;
197 Lisp_Object Qundefined_color;
198 Lisp_Object Qcompound_text, Qcancel_timer;
199 static Lisp_Object Qfont_param;
201 /* In dispnew.c */
203 extern Lisp_Object Vwindow_system_version;
205 /* The below are defined in frame.c. */
207 #if GLYPH_DEBUG
208 int image_cache_refcount, dpyinfo_refcount;
209 #endif
211 #if defined (USE_GTK) && defined (HAVE_FREETYPE)
212 char *x_last_font_name;
213 #endif
216 /* Error if we are not connected to X. */
218 void
219 check_x ()
221 if (! x_in_use)
222 error ("X windows are not in use or not initialized");
225 /* Nonzero if we can use mouse menus.
226 You should not call this unless HAVE_MENUS is defined. */
229 have_menus_p ()
231 return x_in_use;
234 /* Extract a frame as a FRAME_PTR, defaulting to the selected frame
235 and checking validity for X. */
237 FRAME_PTR
238 check_x_frame (frame)
239 Lisp_Object frame;
241 FRAME_PTR f;
243 if (NILP (frame))
244 frame = selected_frame;
245 CHECK_LIVE_FRAME (frame);
246 f = XFRAME (frame);
247 if (! FRAME_X_P (f))
248 error ("Non-X frame used");
249 return f;
252 /* Let the user specify an X display with a Lisp object.
253 OBJECT may be nil, a frame or a terminal object.
254 nil stands for the selected frame--or, if that is not an X frame,
255 the first X display on the list. */
257 struct x_display_info *
258 check_x_display_info (object)
259 Lisp_Object object;
261 struct x_display_info *dpyinfo = NULL;
263 if (NILP (object))
265 struct frame *sf = XFRAME (selected_frame);
267 if (FRAME_X_P (sf) && FRAME_LIVE_P (sf))
268 dpyinfo = FRAME_X_DISPLAY_INFO (sf);
269 else if (x_display_list != 0)
270 dpyinfo = x_display_list;
271 else
272 error ("X windows are not in use or not initialized");
274 else if (TERMINALP (object))
276 struct terminal *t = get_terminal (object, 1);
278 if (t->type != output_x_window)
279 error ("Terminal %d is not an X display", XINT (object));
281 dpyinfo = t->display_info.x;
283 else if (STRINGP (object))
284 dpyinfo = x_display_info_for_name (object);
285 else
287 FRAME_PTR f = check_x_frame (object);
288 dpyinfo = FRAME_X_DISPLAY_INFO (f);
291 return dpyinfo;
295 /* Return the Emacs frame-object corresponding to an X window.
296 It could be the frame's main window or an icon window. */
298 /* This function can be called during GC, so use GC_xxx type test macros. */
300 struct frame *
301 x_window_to_frame (dpyinfo, wdesc)
302 struct x_display_info *dpyinfo;
303 int wdesc;
305 Lisp_Object tail, frame;
306 struct frame *f;
308 if (wdesc == None) return 0;
310 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
312 frame = XCAR (tail);
313 if (!FRAMEP (frame))
314 continue;
315 f = XFRAME (frame);
316 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
317 continue;
318 if (f->output_data.x->hourglass_window == wdesc)
319 return f;
320 #ifdef USE_X_TOOLKIT
321 if ((f->output_data.x->edit_widget
322 && XtWindow (f->output_data.x->edit_widget) == wdesc)
323 /* A tooltip frame? */
324 || (!f->output_data.x->edit_widget
325 && FRAME_X_WINDOW (f) == wdesc)
326 || f->output_data.x->icon_desc == wdesc)
327 return f;
328 #else /* not USE_X_TOOLKIT */
329 #ifdef USE_GTK
330 if (f->output_data.x->edit_widget)
332 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
333 struct x_output *x = f->output_data.x;
334 if (gwdesc != 0 && gwdesc == x->edit_widget)
335 return f;
337 #endif /* USE_GTK */
338 if (FRAME_X_WINDOW (f) == wdesc
339 || f->output_data.x->icon_desc == wdesc)
340 return f;
341 #endif /* not USE_X_TOOLKIT */
343 return 0;
346 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
347 /* Like x_window_to_frame but also compares the window with the widget's
348 windows. */
350 struct frame *
351 x_any_window_to_frame (dpyinfo, wdesc)
352 struct x_display_info *dpyinfo;
353 int wdesc;
355 Lisp_Object tail, frame;
356 struct frame *f, *found;
357 struct x_output *x;
359 if (wdesc == None) return NULL;
361 found = NULL;
362 for (tail = Vframe_list; CONSP (tail) && !found; tail = XCDR (tail))
364 frame = XCAR (tail);
365 if (!FRAMEP (frame))
366 continue;
368 f = XFRAME (frame);
369 if (FRAME_X_P (f) && FRAME_X_DISPLAY_INFO (f) == dpyinfo)
371 /* This frame matches if the window is any of its widgets. */
372 x = f->output_data.x;
373 if (x->hourglass_window == wdesc)
374 found = f;
375 else if (x->widget)
377 #ifdef USE_GTK
378 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
379 if (gwdesc != 0
380 && gtk_widget_get_toplevel (gwdesc) == x->widget)
381 found = f;
382 #else
383 if (wdesc == XtWindow (x->widget)
384 || wdesc == XtWindow (x->column_widget)
385 || wdesc == XtWindow (x->edit_widget))
386 found = f;
387 /* Match if the window is this frame's menubar. */
388 else if (lw_window_is_in_menubar (wdesc, x->menubar_widget))
389 found = f;
390 #endif
392 else if (FRAME_X_WINDOW (f) == wdesc)
393 /* A tooltip frame. */
394 found = f;
398 return found;
401 /* Likewise, but consider only the menu bar widget. */
403 struct frame *
404 x_menubar_window_to_frame (dpyinfo, wdesc)
405 struct x_display_info *dpyinfo;
406 int wdesc;
408 Lisp_Object tail, frame;
409 struct frame *f;
410 struct x_output *x;
412 if (wdesc == None) return 0;
414 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
416 frame = XCAR (tail);
417 if (!FRAMEP (frame))
418 continue;
419 f = XFRAME (frame);
420 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
421 continue;
422 x = f->output_data.x;
423 /* Match if the window is this frame's menubar. */
424 #ifdef USE_GTK
425 if (x->menubar_widget)
427 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
429 /* This gives false positives, but the rectangle check in xterm.c
430 where this is called takes care of that. */
431 if (gwdesc != 0
432 && (gwdesc == x->menubar_widget
433 || gtk_widget_is_ancestor (x->menubar_widget, gwdesc)
434 || gtk_widget_is_ancestor (gwdesc, x->menubar_widget)))
435 return f;
437 #else
438 if (x->menubar_widget
439 && lw_window_is_in_menubar (wdesc, x->menubar_widget))
440 return f;
441 #endif
443 return 0;
446 /* Return the frame whose principal (outermost) window is WDESC.
447 If WDESC is some other (smaller) window, we return 0. */
449 struct frame *
450 x_top_window_to_frame (dpyinfo, wdesc)
451 struct x_display_info *dpyinfo;
452 int wdesc;
454 Lisp_Object tail, frame;
455 struct frame *f;
456 struct x_output *x;
458 if (wdesc == None) return 0;
460 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
462 frame = XCAR (tail);
463 if (!FRAMEP (frame))
464 continue;
465 f = XFRAME (frame);
466 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
467 continue;
468 x = f->output_data.x;
470 if (x->widget)
472 /* This frame matches if the window is its topmost widget. */
473 #ifdef USE_GTK
474 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
475 if (gwdesc == x->widget)
476 return f;
477 #else
478 if (wdesc == XtWindow (x->widget))
479 return f;
480 #if 0 /* I don't know why it did this,
481 but it seems logically wrong,
482 and it causes trouble for MapNotify events. */
483 /* Match if the window is this frame's menubar. */
484 if (x->menubar_widget
485 && wdesc == XtWindow (x->menubar_widget))
486 return f;
487 #endif
488 #endif
490 else if (FRAME_X_WINDOW (f) == wdesc)
491 /* Tooltip frame. */
492 return f;
494 return 0;
496 #endif /* USE_X_TOOLKIT || USE_GTK */
500 static void x_default_font_parameter P_ ((struct frame *, Lisp_Object));
502 static Lisp_Object unwind_create_frame P_ ((Lisp_Object));
503 static Lisp_Object unwind_create_tip_frame P_ ((Lisp_Object));
505 void x_set_foreground_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
506 static void x_set_wait_for_wm P_ ((struct frame *, Lisp_Object, Lisp_Object));
507 void x_set_background_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
508 void x_set_mouse_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
509 void x_set_cursor_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
510 void x_set_border_color P_ ((struct frame *, Lisp_Object, Lisp_Object));
511 void x_set_cursor_type P_ ((struct frame *, Lisp_Object, Lisp_Object));
512 void x_set_icon_type P_ ((struct frame *, Lisp_Object, Lisp_Object));
513 void x_set_icon_name P_ ((struct frame *, Lisp_Object, Lisp_Object));
514 void x_explicitly_set_name P_ ((struct frame *, Lisp_Object, Lisp_Object));
515 void x_set_menu_bar_lines P_ ((struct frame *, Lisp_Object, Lisp_Object));
516 void x_set_title P_ ((struct frame *, Lisp_Object, Lisp_Object));
517 void x_set_tool_bar_lines P_ ((struct frame *, Lisp_Object, Lisp_Object));
518 void x_set_scroll_bar_foreground P_ ((struct frame *, Lisp_Object,
519 Lisp_Object));
520 void x_set_scroll_bar_background P_ ((struct frame *, Lisp_Object,
521 Lisp_Object));
522 static Lisp_Object x_default_scroll_bar_color_parameter P_ ((struct frame *,
523 Lisp_Object,
524 Lisp_Object,
525 char *, char *,
526 int));
529 /* Store the screen positions of frame F into XPTR and YPTR.
530 These are the positions of the containing window manager window,
531 not Emacs's own window. */
533 void
534 x_real_positions (f, xptr, yptr)
535 FRAME_PTR f;
536 int *xptr, *yptr;
538 int win_x, win_y, outer_x, outer_y;
539 int real_x = 0, real_y = 0;
540 int had_errors = 0;
541 Window win = f->output_data.x->parent_desc;
543 BLOCK_INPUT;
545 x_catch_errors (FRAME_X_DISPLAY (f));
547 if (win == FRAME_X_DISPLAY_INFO (f)->root_window)
548 win = FRAME_OUTER_WINDOW (f);
550 /* This loop traverses up the containment tree until we hit the root
551 window. Window managers may intersect many windows between our window
552 and the root window. The window we find just before the root window
553 should be the outer WM window. */
554 for (;;)
556 Window wm_window, rootw;
557 Window *tmp_children;
558 unsigned int tmp_nchildren;
559 int success;
561 success = XQueryTree (FRAME_X_DISPLAY (f), win, &rootw,
562 &wm_window, &tmp_children, &tmp_nchildren);
564 had_errors = x_had_errors_p (FRAME_X_DISPLAY (f));
566 /* Don't free tmp_children if XQueryTree failed. */
567 if (! success)
568 break;
570 XFree ((char *) tmp_children);
572 if (wm_window == rootw || had_errors)
573 break;
575 win = wm_window;
578 if (! had_errors)
580 unsigned int ign;
581 Window child, rootw;
583 /* Get the real coordinates for the WM window upper left corner */
584 XGetGeometry (FRAME_X_DISPLAY (f), win,
585 &rootw, &real_x, &real_y, &ign, &ign, &ign, &ign);
587 /* Translate real coordinates to coordinates relative to our
588 window. For our window, the upper left corner is 0, 0.
589 Since the upper left corner of the WM window is outside
590 our window, win_x and win_y will be negative:
592 ------------------ ---> x
593 | title |
594 | ----------------- v y
595 | | our window
597 XTranslateCoordinates (FRAME_X_DISPLAY (f),
599 /* From-window, to-window. */
600 FRAME_X_DISPLAY_INFO (f)->root_window,
601 FRAME_X_WINDOW (f),
603 /* From-position, to-position. */
604 real_x, real_y, &win_x, &win_y,
606 /* Child of win. */
607 &child);
609 if (FRAME_X_WINDOW (f) == FRAME_OUTER_WINDOW (f))
611 outer_x = win_x;
612 outer_y = win_y;
614 else
616 XTranslateCoordinates (FRAME_X_DISPLAY (f),
618 /* From-window, to-window. */
619 FRAME_X_DISPLAY_INFO (f)->root_window,
620 FRAME_OUTER_WINDOW (f),
622 /* From-position, to-position. */
623 real_x, real_y, &outer_x, &outer_y,
625 /* Child of win. */
626 &child);
629 had_errors = x_had_errors_p (FRAME_X_DISPLAY (f));
632 x_uncatch_errors ();
634 UNBLOCK_INPUT;
636 if (had_errors) return;
638 f->x_pixels_diff = -win_x;
639 f->y_pixels_diff = -win_y;
641 FRAME_X_OUTPUT (f)->x_pixels_outer_diff = -outer_x;
642 FRAME_X_OUTPUT (f)->y_pixels_outer_diff = -outer_y;
644 *xptr = real_x;
645 *yptr = real_y;
651 /* Gamma-correct COLOR on frame F. */
653 void
654 gamma_correct (f, color)
655 struct frame *f;
656 XColor *color;
658 if (f->gamma)
660 color->red = pow (color->red / 65535.0, f->gamma) * 65535.0 + 0.5;
661 color->green = pow (color->green / 65535.0, f->gamma) * 65535.0 + 0.5;
662 color->blue = pow (color->blue / 65535.0, f->gamma) * 65535.0 + 0.5;
667 /* Decide if color named COLOR_NAME is valid for use on frame F. If
668 so, return the RGB values in COLOR. If ALLOC_P is non-zero,
669 allocate the color. Value is zero if COLOR_NAME is invalid, or
670 no color could be allocated. */
673 x_defined_color (f, color_name, color, alloc_p)
674 struct frame *f;
675 char *color_name;
676 XColor *color;
677 int alloc_p;
679 int success_p;
680 Display *dpy = FRAME_X_DISPLAY (f);
681 Colormap cmap = FRAME_X_COLORMAP (f);
683 BLOCK_INPUT;
684 success_p = XParseColor (dpy, cmap, color_name, color);
685 if (success_p && alloc_p)
686 success_p = x_alloc_nearest_color (f, cmap, color);
687 UNBLOCK_INPUT;
689 return success_p;
693 /* Return the pixel color value for color COLOR_NAME on frame F. If F
694 is a monochrome frame, return MONO_COLOR regardless of what ARG says.
695 Signal an error if color can't be allocated. */
698 x_decode_color (f, color_name, mono_color)
699 FRAME_PTR f;
700 Lisp_Object color_name;
701 int mono_color;
703 XColor cdef;
705 CHECK_STRING (color_name);
707 #if 0 /* Don't do this. It's wrong when we're not using the default
708 colormap, it makes freeing difficult, and it's probably not
709 an important optimization. */
710 if (strcmp (SDATA (color_name), "black") == 0)
711 return BLACK_PIX_DEFAULT (f);
712 else if (strcmp (SDATA (color_name), "white") == 0)
713 return WHITE_PIX_DEFAULT (f);
714 #endif
716 /* Return MONO_COLOR for monochrome frames. */
717 if (FRAME_X_DISPLAY_INFO (f)->n_planes == 1)
718 return mono_color;
720 /* x_defined_color is responsible for coping with failures
721 by looking for a near-miss. */
722 if (x_defined_color (f, SDATA (color_name), &cdef, 1))
723 return cdef.pixel;
725 signal_error ("Undefined color", color_name);
730 /* Change the `wait-for-wm' frame parameter of frame F. OLD_VALUE is
731 the previous value of that parameter, NEW_VALUE is the new value.
732 See also the comment of wait_for_wm in struct x_output. */
734 static void
735 x_set_wait_for_wm (f, new_value, old_value)
736 struct frame *f;
737 Lisp_Object new_value, old_value;
739 f->output_data.x->wait_for_wm = !NILP (new_value);
742 #ifdef USE_GTK
744 /* Set icon from FILE for frame F. By using GTK functions the icon
745 may be any format that GdkPixbuf knows about, i.e. not just bitmaps. */
748 xg_set_icon (f, file)
749 FRAME_PTR f;
750 Lisp_Object file;
752 int result = 0;
753 Lisp_Object found;
755 found = x_find_image_file (file);
757 if (! NILP (found))
759 GdkPixbuf *pixbuf;
760 GError *err = NULL;
761 char *filename = (char *) SDATA (found);
762 BLOCK_INPUT;
764 pixbuf = gdk_pixbuf_new_from_file (filename, &err);
766 if (pixbuf)
768 gtk_window_set_icon (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)),
769 pixbuf);
770 g_object_unref (pixbuf);
772 result = 1;
774 else
775 g_error_free (err);
777 UNBLOCK_INPUT;
780 return result;
784 xg_set_icon_from_xpm_data (f, data)
785 FRAME_PTR f;
786 char **data;
788 int result = 0;
789 GdkPixbuf *pixbuf = gdk_pixbuf_new_from_xpm_data ((const char **) data);
791 if (!pixbuf)
792 return 0;
794 gtk_window_set_icon (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)), pixbuf);
795 g_object_unref (pixbuf);
796 return 1;
798 #endif /* USE_GTK */
801 /* Functions called only from `x_set_frame_param'
802 to set individual parameters.
804 If FRAME_X_WINDOW (f) is 0,
805 the frame is being created and its X-window does not exist yet.
806 In that case, just record the parameter's new value
807 in the standard place; do not attempt to change the window. */
809 void
810 x_set_foreground_color (f, arg, oldval)
811 struct frame *f;
812 Lisp_Object arg, oldval;
814 struct x_output *x = f->output_data.x;
815 unsigned long fg, old_fg;
817 fg = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
818 old_fg = FRAME_FOREGROUND_PIXEL (f);
819 FRAME_FOREGROUND_PIXEL (f) = fg;
821 if (FRAME_X_WINDOW (f) != 0)
823 Display *dpy = FRAME_X_DISPLAY (f);
825 BLOCK_INPUT;
826 XSetForeground (dpy, x->normal_gc, fg);
827 XSetBackground (dpy, x->reverse_gc, fg);
829 if (x->cursor_pixel == old_fg)
831 unload_color (f, x->cursor_pixel);
832 x->cursor_pixel = x_copy_color (f, fg);
833 XSetBackground (dpy, x->cursor_gc, x->cursor_pixel);
836 UNBLOCK_INPUT;
838 update_face_from_frame_parameter (f, Qforeground_color, arg);
840 if (FRAME_VISIBLE_P (f))
841 redraw_frame (f);
844 unload_color (f, old_fg);
847 void
848 x_set_background_color (f, arg, oldval)
849 struct frame *f;
850 Lisp_Object arg, oldval;
852 struct x_output *x = f->output_data.x;
853 unsigned long bg;
855 bg = x_decode_color (f, arg, WHITE_PIX_DEFAULT (f));
856 unload_color (f, FRAME_BACKGROUND_PIXEL (f));
857 FRAME_BACKGROUND_PIXEL (f) = bg;
859 if (FRAME_X_WINDOW (f) != 0)
861 Display *dpy = FRAME_X_DISPLAY (f);
863 BLOCK_INPUT;
864 XSetBackground (dpy, x->normal_gc, bg);
865 XSetForeground (dpy, x->reverse_gc, bg);
866 XSetWindowBackground (dpy, FRAME_X_WINDOW (f), bg);
867 XSetForeground (dpy, x->cursor_gc, bg);
869 #ifdef USE_GTK
870 xg_set_background_color (f, bg);
871 #endif
873 #ifndef USE_TOOLKIT_SCROLL_BARS /* Turns out to be annoying with
874 toolkit scroll bars. */
876 Lisp_Object bar;
877 for (bar = FRAME_SCROLL_BARS (f);
878 !NILP (bar);
879 bar = XSCROLL_BAR (bar)->next)
881 Window window = XSCROLL_BAR (bar)->x_window;
882 XSetWindowBackground (dpy, window, bg);
885 #endif /* USE_TOOLKIT_SCROLL_BARS */
887 UNBLOCK_INPUT;
888 update_face_from_frame_parameter (f, Qbackground_color, arg);
890 if (FRAME_VISIBLE_P (f))
891 redraw_frame (f);
895 static Cursor
896 make_invisible_cursor (f)
897 struct frame *f;
899 Display *dpy = FRAME_X_DISPLAY (f);
900 static char const no_data[] = { 0 };
901 Pixmap pix;
902 XColor col;
903 Cursor c;
905 x_catch_errors (dpy);
906 pix = XCreateBitmapFromData (dpy, FRAME_X_DISPLAY_INFO (f)->root_window,
907 no_data, 1, 1);
908 if (! x_had_errors_p (dpy) && pix != None)
910 col.pixel = 0;
911 col.red = col.green = col.blue = 0;
912 col.flags = DoRed | DoGreen | DoBlue;
913 c = XCreatePixmapCursor (dpy, pix, pix, &col, &col, 0, 0);
914 if (x_had_errors_p (dpy) || c == None)
915 c = 0;
916 XFreePixmap (dpy, pix);
919 x_uncatch_errors ();
921 return c;
924 void
925 x_set_mouse_color (f, arg, oldval)
926 struct frame *f;
927 Lisp_Object arg, oldval;
929 struct x_output *x = f->output_data.x;
930 Display *dpy = FRAME_X_DISPLAY (f);
931 Cursor cursor, nontext_cursor, mode_cursor, hand_cursor;
932 Cursor hourglass_cursor, horizontal_drag_cursor;
933 unsigned long pixel = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
934 unsigned long mask_color = FRAME_BACKGROUND_PIXEL (f);
936 /* Don't let pointers be invisible. */
937 if (mask_color == pixel)
939 x_free_colors (f, &pixel, 1);
940 pixel = x_copy_color (f, FRAME_FOREGROUND_PIXEL (f));
943 unload_color (f, x->mouse_pixel);
944 x->mouse_pixel = pixel;
946 BLOCK_INPUT;
948 /* It's not okay to crash if the user selects a screwy cursor. */
949 x_catch_errors (dpy);
951 if (!NILP (Vx_pointer_shape))
953 CHECK_NUMBER (Vx_pointer_shape);
954 cursor = XCreateFontCursor (dpy, XINT (Vx_pointer_shape));
956 else
957 cursor = XCreateFontCursor (dpy, XC_xterm);
958 x_check_errors (dpy, "bad text pointer cursor: %s");
960 if (!NILP (Vx_nontext_pointer_shape))
962 CHECK_NUMBER (Vx_nontext_pointer_shape);
963 nontext_cursor
964 = XCreateFontCursor (dpy, XINT (Vx_nontext_pointer_shape));
966 else
967 nontext_cursor = XCreateFontCursor (dpy, XC_left_ptr);
968 x_check_errors (dpy, "bad nontext pointer cursor: %s");
970 if (!NILP (Vx_hourglass_pointer_shape))
972 CHECK_NUMBER (Vx_hourglass_pointer_shape);
973 hourglass_cursor
974 = XCreateFontCursor (dpy, XINT (Vx_hourglass_pointer_shape));
976 else
977 hourglass_cursor = XCreateFontCursor (dpy, XC_watch);
978 x_check_errors (dpy, "bad hourglass pointer cursor: %s");
980 if (!NILP (Vx_mode_pointer_shape))
982 CHECK_NUMBER (Vx_mode_pointer_shape);
983 mode_cursor = XCreateFontCursor (dpy, XINT (Vx_mode_pointer_shape));
985 else
986 mode_cursor = XCreateFontCursor (dpy, XC_xterm);
987 x_check_errors (dpy, "bad modeline pointer cursor: %s");
989 if (!NILP (Vx_sensitive_text_pointer_shape))
991 CHECK_NUMBER (Vx_sensitive_text_pointer_shape);
992 hand_cursor
993 = XCreateFontCursor (dpy, XINT (Vx_sensitive_text_pointer_shape));
995 else
996 hand_cursor = XCreateFontCursor (dpy, XC_hand2);
998 if (!NILP (Vx_window_horizontal_drag_shape))
1000 CHECK_NUMBER (Vx_window_horizontal_drag_shape);
1001 horizontal_drag_cursor
1002 = XCreateFontCursor (dpy, XINT (Vx_window_horizontal_drag_shape));
1004 else
1005 horizontal_drag_cursor
1006 = XCreateFontCursor (dpy, XC_sb_h_double_arrow);
1008 /* Check and report errors with the above calls. */
1009 x_check_errors (dpy, "can't set cursor shape: %s");
1010 x_uncatch_errors ();
1013 XColor fore_color, back_color;
1015 fore_color.pixel = x->mouse_pixel;
1016 x_query_color (f, &fore_color);
1017 back_color.pixel = mask_color;
1018 x_query_color (f, &back_color);
1020 XRecolorCursor (dpy, cursor, &fore_color, &back_color);
1021 XRecolorCursor (dpy, nontext_cursor, &fore_color, &back_color);
1022 XRecolorCursor (dpy, mode_cursor, &fore_color, &back_color);
1023 XRecolorCursor (dpy, hand_cursor, &fore_color, &back_color);
1024 XRecolorCursor (dpy, hourglass_cursor, &fore_color, &back_color);
1025 XRecolorCursor (dpy, horizontal_drag_cursor, &fore_color, &back_color);
1028 if (FRAME_X_WINDOW (f) != 0)
1029 XDefineCursor (dpy, FRAME_X_WINDOW (f),
1030 f->output_data.x->current_cursor = cursor);
1032 if (FRAME_X_DISPLAY_INFO (f)->invisible_cursor == 0)
1033 FRAME_X_DISPLAY_INFO (f)->invisible_cursor = make_invisible_cursor (f);
1035 if (cursor != x->text_cursor
1036 && x->text_cursor != 0)
1037 XFreeCursor (dpy, x->text_cursor);
1038 x->text_cursor = cursor;
1040 if (nontext_cursor != x->nontext_cursor
1041 && x->nontext_cursor != 0)
1042 XFreeCursor (dpy, x->nontext_cursor);
1043 x->nontext_cursor = nontext_cursor;
1045 if (hourglass_cursor != x->hourglass_cursor
1046 && x->hourglass_cursor != 0)
1047 XFreeCursor (dpy, x->hourglass_cursor);
1048 x->hourglass_cursor = hourglass_cursor;
1050 if (mode_cursor != x->modeline_cursor
1051 && x->modeline_cursor != 0)
1052 XFreeCursor (dpy, f->output_data.x->modeline_cursor);
1053 x->modeline_cursor = mode_cursor;
1055 if (hand_cursor != x->hand_cursor
1056 && x->hand_cursor != 0)
1057 XFreeCursor (dpy, x->hand_cursor);
1058 x->hand_cursor = hand_cursor;
1060 if (horizontal_drag_cursor != x->horizontal_drag_cursor
1061 && x->horizontal_drag_cursor != 0)
1062 XFreeCursor (dpy, x->horizontal_drag_cursor);
1063 x->horizontal_drag_cursor = horizontal_drag_cursor;
1065 XFlush (dpy);
1066 UNBLOCK_INPUT;
1068 update_face_from_frame_parameter (f, Qmouse_color, arg);
1071 void
1072 x_set_cursor_color (f, arg, oldval)
1073 struct frame *f;
1074 Lisp_Object arg, oldval;
1076 unsigned long fore_pixel, pixel;
1077 int fore_pixel_allocated_p = 0, pixel_allocated_p = 0;
1078 struct x_output *x = f->output_data.x;
1080 if (!NILP (Vx_cursor_fore_pixel))
1082 fore_pixel = x_decode_color (f, Vx_cursor_fore_pixel,
1083 WHITE_PIX_DEFAULT (f));
1084 fore_pixel_allocated_p = 1;
1086 else
1087 fore_pixel = FRAME_BACKGROUND_PIXEL (f);
1089 pixel = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
1090 pixel_allocated_p = 1;
1092 /* Make sure that the cursor color differs from the background color. */
1093 if (pixel == FRAME_BACKGROUND_PIXEL (f))
1095 if (pixel_allocated_p)
1097 x_free_colors (f, &pixel, 1);
1098 pixel_allocated_p = 0;
1101 pixel = x->mouse_pixel;
1102 if (pixel == fore_pixel)
1104 if (fore_pixel_allocated_p)
1106 x_free_colors (f, &fore_pixel, 1);
1107 fore_pixel_allocated_p = 0;
1109 fore_pixel = FRAME_BACKGROUND_PIXEL (f);
1113 unload_color (f, x->cursor_foreground_pixel);
1114 if (!fore_pixel_allocated_p)
1115 fore_pixel = x_copy_color (f, fore_pixel);
1116 x->cursor_foreground_pixel = fore_pixel;
1118 unload_color (f, x->cursor_pixel);
1119 if (!pixel_allocated_p)
1120 pixel = x_copy_color (f, pixel);
1121 x->cursor_pixel = pixel;
1123 if (FRAME_X_WINDOW (f) != 0)
1125 BLOCK_INPUT;
1126 XSetBackground (FRAME_X_DISPLAY (f), x->cursor_gc, x->cursor_pixel);
1127 XSetForeground (FRAME_X_DISPLAY (f), x->cursor_gc, fore_pixel);
1128 UNBLOCK_INPUT;
1130 if (FRAME_VISIBLE_P (f))
1132 x_update_cursor (f, 0);
1133 x_update_cursor (f, 1);
1137 update_face_from_frame_parameter (f, Qcursor_color, arg);
1140 /* Set the border-color of frame F to pixel value PIX.
1141 Note that this does not fully take effect if done before
1142 F has an x-window. */
1144 void
1145 x_set_border_pixel (f, pix)
1146 struct frame *f;
1147 int pix;
1149 unload_color (f, f->output_data.x->border_pixel);
1150 f->output_data.x->border_pixel = pix;
1152 if (FRAME_X_WINDOW (f) != 0 && f->border_width > 0)
1154 BLOCK_INPUT;
1155 XSetWindowBorder (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1156 (unsigned long)pix);
1157 UNBLOCK_INPUT;
1159 if (FRAME_VISIBLE_P (f))
1160 redraw_frame (f);
1164 /* Set the border-color of frame F to value described by ARG.
1165 ARG can be a string naming a color.
1166 The border-color is used for the border that is drawn by the X server.
1167 Note that this does not fully take effect if done before
1168 F has an x-window; it must be redone when the window is created.
1170 Note: this is done in two routines because of the way X10 works.
1172 Note: under X11, this is normally the province of the window manager,
1173 and so emacs' border colors may be overridden. */
1175 void
1176 x_set_border_color (f, arg, oldval)
1177 struct frame *f;
1178 Lisp_Object arg, oldval;
1180 int pix;
1182 CHECK_STRING (arg);
1183 pix = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
1184 x_set_border_pixel (f, pix);
1185 update_face_from_frame_parameter (f, Qborder_color, arg);
1189 void
1190 x_set_cursor_type (f, arg, oldval)
1191 FRAME_PTR f;
1192 Lisp_Object arg, oldval;
1194 set_frame_cursor_types (f, arg);
1196 /* Make sure the cursor gets redrawn. */
1197 cursor_type_changed = 1;
1200 void
1201 x_set_icon_type (f, arg, oldval)
1202 struct frame *f;
1203 Lisp_Object arg, oldval;
1205 int result;
1207 if (STRINGP (arg))
1209 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
1210 return;
1212 else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
1213 return;
1215 BLOCK_INPUT;
1216 if (NILP (arg))
1217 result = x_text_icon (f,
1218 (char *) SDATA ((!NILP (f->icon_name)
1219 ? f->icon_name
1220 : f->name)));
1221 else
1222 result = x_bitmap_icon (f, arg);
1224 if (result)
1226 UNBLOCK_INPUT;
1227 error ("No icon window available");
1230 XFlush (FRAME_X_DISPLAY (f));
1231 UNBLOCK_INPUT;
1234 void
1235 x_set_icon_name (f, arg, oldval)
1236 struct frame *f;
1237 Lisp_Object arg, oldval;
1239 int result;
1241 if (STRINGP (arg))
1243 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
1244 return;
1246 else if (!NILP (arg) || NILP (oldval))
1247 return;
1249 f->icon_name = arg;
1251 if (f->output_data.x->icon_bitmap != 0)
1252 return;
1254 BLOCK_INPUT;
1256 result = x_text_icon (f,
1257 (char *) SDATA ((!NILP (f->icon_name)
1258 ? f->icon_name
1259 : !NILP (f->title)
1260 ? f->title
1261 : f->name)));
1263 if (result)
1265 UNBLOCK_INPUT;
1266 error ("No icon window available");
1269 XFlush (FRAME_X_DISPLAY (f));
1270 UNBLOCK_INPUT;
1274 void
1275 x_set_menu_bar_lines (f, value, oldval)
1276 struct frame *f;
1277 Lisp_Object value, oldval;
1279 int nlines;
1280 #if ! defined (USE_X_TOOLKIT) && ! defined (USE_GTK)
1281 int olines = FRAME_MENU_BAR_LINES (f);
1282 #endif
1284 /* Right now, menu bars don't work properly in minibuf-only frames;
1285 most of the commands try to apply themselves to the minibuffer
1286 frame itself, and get an error because you can't switch buffers
1287 in or split the minibuffer window. */
1288 if (FRAME_MINIBUF_ONLY_P (f))
1289 return;
1291 if (INTEGERP (value))
1292 nlines = XINT (value);
1293 else
1294 nlines = 0;
1296 /* Make sure we redisplay all windows in this frame. */
1297 windows_or_buffers_changed++;
1299 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
1300 FRAME_MENU_BAR_LINES (f) = 0;
1301 if (nlines)
1303 FRAME_EXTERNAL_MENU_BAR (f) = 1;
1304 if (FRAME_X_P (f) && f->output_data.x->menubar_widget == 0)
1305 /* Make sure next redisplay shows the menu bar. */
1306 XWINDOW (FRAME_SELECTED_WINDOW (f))->update_mode_line = Qt;
1308 else
1310 if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
1311 free_frame_menubar (f);
1312 FRAME_EXTERNAL_MENU_BAR (f) = 0;
1313 if (FRAME_X_P (f))
1314 f->output_data.x->menubar_widget = 0;
1316 #else /* not USE_X_TOOLKIT && not USE_GTK */
1317 FRAME_MENU_BAR_LINES (f) = nlines;
1318 change_window_heights (f->root_window, nlines - olines);
1319 #endif /* not USE_X_TOOLKIT */
1320 adjust_glyphs (f);
1324 /* Set the number of lines used for the tool bar of frame F to VALUE.
1325 VALUE not an integer, or < 0 means set the lines to zero. OLDVAL
1326 is the old number of tool bar lines. This function changes the
1327 height of all windows on frame F to match the new tool bar height.
1328 The frame's height doesn't change. */
1330 void
1331 x_set_tool_bar_lines (f, value, oldval)
1332 struct frame *f;
1333 Lisp_Object value, oldval;
1335 int delta, nlines, root_height;
1336 Lisp_Object root_window;
1338 /* Treat tool bars like menu bars. */
1339 if (FRAME_MINIBUF_ONLY_P (f))
1340 return;
1342 /* Use VALUE only if an integer >= 0. */
1343 if (INTEGERP (value) && XINT (value) >= 0)
1344 nlines = XFASTINT (value);
1345 else
1346 nlines = 0;
1348 #ifdef USE_GTK
1349 FRAME_TOOL_BAR_LINES (f) = 0;
1350 if (nlines)
1352 FRAME_EXTERNAL_TOOL_BAR (f) = 1;
1353 if (FRAME_X_P (f) && f->output_data.x->toolbar_widget == 0)
1354 /* Make sure next redisplay shows the tool bar. */
1355 XWINDOW (FRAME_SELECTED_WINDOW (f))->update_mode_line = Qt;
1356 update_frame_tool_bar (f);
1358 else
1360 if (FRAME_EXTERNAL_TOOL_BAR (f))
1361 free_frame_tool_bar (f);
1362 FRAME_EXTERNAL_TOOL_BAR (f) = 0;
1365 return;
1366 #endif
1368 /* Make sure we redisplay all windows in this frame. */
1369 ++windows_or_buffers_changed;
1371 delta = nlines - FRAME_TOOL_BAR_LINES (f);
1373 /* Don't resize the tool-bar to more than we have room for. */
1374 root_window = FRAME_ROOT_WINDOW (f);
1375 root_height = WINDOW_TOTAL_LINES (XWINDOW (root_window));
1376 if (root_height - delta < 1)
1378 delta = root_height - 1;
1379 nlines = FRAME_TOOL_BAR_LINES (f) + delta;
1382 FRAME_TOOL_BAR_LINES (f) = nlines;
1383 change_window_heights (root_window, delta);
1384 adjust_glyphs (f);
1386 /* We also have to make sure that the internal border at the top of
1387 the frame, below the menu bar or tool bar, is redrawn when the
1388 tool bar disappears. This is so because the internal border is
1389 below the tool bar if one is displayed, but is below the menu bar
1390 if there isn't a tool bar. The tool bar draws into the area
1391 below the menu bar. */
1392 if (FRAME_X_WINDOW (f) && FRAME_TOOL_BAR_LINES (f) == 0)
1394 clear_frame (f);
1395 clear_current_matrices (f);
1398 /* If the tool bar gets smaller, the internal border below it
1399 has to be cleared. It was formerly part of the display
1400 of the larger tool bar, and updating windows won't clear it. */
1401 if (delta < 0)
1403 int height = FRAME_INTERNAL_BORDER_WIDTH (f);
1404 int width = FRAME_PIXEL_WIDTH (f);
1405 int y = nlines * FRAME_LINE_HEIGHT (f);
1407 /* height can be zero here. */
1408 if (height > 0 && width > 0)
1410 BLOCK_INPUT;
1411 x_clear_area (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1412 0, y, width, height, False);
1413 UNBLOCK_INPUT;
1416 if (WINDOWP (f->tool_bar_window))
1417 clear_glyph_matrix (XWINDOW (f->tool_bar_window)->current_matrix);
1422 /* Set the foreground color for scroll bars on frame F to VALUE.
1423 VALUE should be a string, a color name. If it isn't a string or
1424 isn't a valid color name, do nothing. OLDVAL is the old value of
1425 the frame parameter. */
1427 void
1428 x_set_scroll_bar_foreground (f, value, oldval)
1429 struct frame *f;
1430 Lisp_Object value, oldval;
1432 unsigned long pixel;
1434 if (STRINGP (value))
1435 pixel = x_decode_color (f, value, BLACK_PIX_DEFAULT (f));
1436 else
1437 pixel = -1;
1439 if (f->output_data.x->scroll_bar_foreground_pixel != -1)
1440 unload_color (f, f->output_data.x->scroll_bar_foreground_pixel);
1442 f->output_data.x->scroll_bar_foreground_pixel = pixel;
1443 if (FRAME_X_WINDOW (f) && FRAME_VISIBLE_P (f))
1445 /* Remove all scroll bars because they have wrong colors. */
1446 if (FRAME_TERMINAL (f)->condemn_scroll_bars_hook)
1447 (*FRAME_TERMINAL (f)->condemn_scroll_bars_hook) (f);
1448 if (FRAME_TERMINAL (f)->judge_scroll_bars_hook)
1449 (*FRAME_TERMINAL (f)->judge_scroll_bars_hook) (f);
1451 update_face_from_frame_parameter (f, Qscroll_bar_foreground, value);
1452 redraw_frame (f);
1457 /* Set the background color for scroll bars on frame F to VALUE VALUE
1458 should be a string, a color name. If it isn't a string or isn't a
1459 valid color name, do nothing. OLDVAL is the old value of the frame
1460 parameter. */
1462 void
1463 x_set_scroll_bar_background (f, value, oldval)
1464 struct frame *f;
1465 Lisp_Object value, oldval;
1467 unsigned long pixel;
1469 if (STRINGP (value))
1470 pixel = x_decode_color (f, value, WHITE_PIX_DEFAULT (f));
1471 else
1472 pixel = -1;
1474 if (f->output_data.x->scroll_bar_background_pixel != -1)
1475 unload_color (f, f->output_data.x->scroll_bar_background_pixel);
1477 #ifdef USE_TOOLKIT_SCROLL_BARS
1478 /* Scrollbar shadow colors. */
1479 if (f->output_data.x->scroll_bar_top_shadow_pixel != -1)
1481 unload_color (f, f->output_data.x->scroll_bar_top_shadow_pixel);
1482 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
1484 if (f->output_data.x->scroll_bar_bottom_shadow_pixel != -1)
1486 unload_color (f, f->output_data.x->scroll_bar_bottom_shadow_pixel);
1487 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
1489 #endif /* USE_TOOLKIT_SCROLL_BARS */
1491 f->output_data.x->scroll_bar_background_pixel = pixel;
1492 if (FRAME_X_WINDOW (f) && FRAME_VISIBLE_P (f))
1494 /* Remove all scroll bars because they have wrong colors. */
1495 if (FRAME_TERMINAL (f)->condemn_scroll_bars_hook)
1496 (*FRAME_TERMINAL (f)->condemn_scroll_bars_hook) (f);
1497 if (FRAME_TERMINAL (f)->judge_scroll_bars_hook)
1498 (*FRAME_TERMINAL (f)->judge_scroll_bars_hook) (f);
1500 update_face_from_frame_parameter (f, Qscroll_bar_background, value);
1501 redraw_frame (f);
1506 /* Encode Lisp string STRING as a text in a format appropriate for
1507 XICCC (X Inter Client Communication Conventions).
1509 This can call Lisp code, so callers must GCPRO.
1511 If STRING contains only ASCII characters, do no conversion and
1512 return the string data of STRING. Otherwise, encode the text by
1513 CODING_SYSTEM, and return a newly allocated memory area which
1514 should be freed by `xfree' by a caller.
1516 SELECTIONP non-zero means the string is being encoded for an X
1517 selection, so it is safe to run pre-write conversions (which
1518 may run Lisp code).
1520 Store the byte length of resulting text in *TEXT_BYTES.
1522 If the text contains only ASCII and Latin-1, store 1 in *STRING_P,
1523 which means that the `encoding' of the result can be `STRING'.
1524 Otherwise store 0 in *STRINGP, which means that the `encoding' of
1525 the result should be `COMPOUND_TEXT'. */
1527 static unsigned char *
1528 x_encode_text (string, coding_system, selectionp, text_bytes, stringp, freep)
1529 Lisp_Object string, coding_system;
1530 int *text_bytes, *stringp;
1531 int selectionp;
1532 int *freep;
1534 int result = string_xstring_p (string);
1535 struct coding_system coding;
1537 if (result == 0)
1539 /* No multibyte character in OBJ. We need not encode it. */
1540 *text_bytes = SBYTES (string);
1541 *stringp = 1;
1542 *freep = 0;
1543 return SDATA (string);
1546 setup_coding_system (coding_system, &coding);
1547 coding.mode |= (CODING_MODE_SAFE_ENCODING | CODING_MODE_LAST_BLOCK);
1548 /* We suppress producing escape sequences for composition. */
1549 coding.common_flags &= ~CODING_ANNOTATION_MASK;
1550 coding.dst_bytes = SCHARS (string) * 2;
1551 coding.destination = (unsigned char *) xmalloc (coding.dst_bytes);
1552 encode_coding_object (&coding, string, 0, 0,
1553 SCHARS (string), SBYTES (string), Qnil);
1554 *text_bytes = coding.produced;
1555 *stringp = (result == 1 || !EQ (coding_system, Qcompound_text));
1556 *freep = 1;
1557 return coding.destination;
1561 /* Set the WM name to NAME for frame F. Also set the icon name.
1562 If the frame already has an icon name, use that, otherwise set the
1563 icon name to NAME. */
1565 static void
1566 x_set_name_internal (f, name)
1567 FRAME_PTR f;
1568 Lisp_Object name;
1570 if (FRAME_X_WINDOW (f))
1572 BLOCK_INPUT;
1574 XTextProperty text, icon;
1575 int bytes, stringp;
1576 int do_free_icon_value = 0, do_free_text_value = 0;
1577 Lisp_Object coding_system;
1578 #ifdef USE_GTK
1579 Lisp_Object encoded_name;
1580 struct gcpro gcpro1;
1582 /* As ENCODE_UTF_8 may cause GC and relocation of string data,
1583 we use it before x_encode_text that may return string data. */
1584 GCPRO1 (name);
1585 encoded_name = ENCODE_UTF_8 (name);
1586 UNGCPRO;
1587 #endif
1589 coding_system = Qcompound_text;
1590 /* Note: Encoding strategy
1592 We encode NAME by compound-text and use "COMPOUND-TEXT" in
1593 text.encoding. But, there are non-internationalized window
1594 managers which don't support that encoding. So, if NAME
1595 contains only ASCII and 8859-1 characters, encode it by
1596 iso-latin-1, and use "STRING" in text.encoding hoping that
1597 such window managers at least analyze this format correctly,
1598 i.e. treat 8-bit bytes as 8859-1 characters.
1600 We may also be able to use "UTF8_STRING" in text.encoding
1601 in the future which can encode all Unicode characters.
1602 But, for the moment, there's no way to know that the
1603 current window manager supports it or not. */
1604 text.value = x_encode_text (name, coding_system, 0, &bytes, &stringp,
1605 &do_free_text_value);
1606 text.encoding = (stringp ? XA_STRING
1607 : FRAME_X_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
1608 text.format = 8;
1609 text.nitems = bytes;
1611 if (!STRINGP (f->icon_name))
1613 icon = text;
1615 else
1617 /* See the above comment "Note: Encoding strategy". */
1618 icon.value = x_encode_text (f->icon_name, coding_system, 0,
1619 &bytes, &stringp, &do_free_icon_value);
1620 icon.encoding = (stringp ? XA_STRING
1621 : FRAME_X_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
1622 icon.format = 8;
1623 icon.nitems = bytes;
1626 #ifdef USE_GTK
1627 gtk_window_set_title (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)),
1628 (char *) SDATA (encoded_name));
1629 #else /* not USE_GTK */
1630 XSetWMName (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &text);
1631 #endif /* not USE_GTK */
1633 XSetWMIconName (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &icon);
1635 if (do_free_icon_value)
1636 xfree (icon.value);
1637 if (do_free_text_value)
1638 xfree (text.value);
1640 UNBLOCK_INPUT;
1644 /* Change the name of frame F to NAME. If NAME is nil, set F's name to
1645 x_id_name.
1647 If EXPLICIT is non-zero, that indicates that lisp code is setting the
1648 name; if NAME is a string, set F's name to NAME and set
1649 F->explicit_name; if NAME is Qnil, then clear F->explicit_name.
1651 If EXPLICIT is zero, that indicates that Emacs redisplay code is
1652 suggesting a new name, which lisp code should override; if
1653 F->explicit_name is set, ignore the new name; otherwise, set it. */
1655 void
1656 x_set_name (f, name, explicit)
1657 struct frame *f;
1658 Lisp_Object name;
1659 int explicit;
1661 /* Make sure that requests from lisp code override requests from
1662 Emacs redisplay code. */
1663 if (explicit)
1665 /* If we're switching from explicit to implicit, we had better
1666 update the mode lines and thereby update the title. */
1667 if (f->explicit_name && NILP (name))
1668 update_mode_lines = 1;
1670 f->explicit_name = ! NILP (name);
1672 else if (f->explicit_name)
1673 return;
1675 /* If NAME is nil, set the name to the x_id_name. */
1676 if (NILP (name))
1678 /* Check for no change needed in this very common case
1679 before we do any consing. */
1680 if (!strcmp (FRAME_X_DISPLAY_INFO (f)->x_id_name,
1681 SDATA (f->name)))
1682 return;
1683 name = build_string (FRAME_X_DISPLAY_INFO (f)->x_id_name);
1685 else
1686 CHECK_STRING (name);
1688 /* Don't change the name if it's already NAME. */
1689 if (! NILP (Fstring_equal (name, f->name)))
1690 return;
1692 f->name = name;
1694 /* For setting the frame title, the title parameter should override
1695 the name parameter. */
1696 if (! NILP (f->title))
1697 name = f->title;
1699 x_set_name_internal (f, name);
1702 /* This function should be called when the user's lisp code has
1703 specified a name for the frame; the name will override any set by the
1704 redisplay code. */
1705 void
1706 x_explicitly_set_name (f, arg, oldval)
1707 FRAME_PTR f;
1708 Lisp_Object arg, oldval;
1710 x_set_name (f, arg, 1);
1713 /* This function should be called by Emacs redisplay code to set the
1714 name; names set this way will never override names set by the user's
1715 lisp code. */
1716 void
1717 x_implicitly_set_name (f, arg, oldval)
1718 FRAME_PTR f;
1719 Lisp_Object arg, oldval;
1721 x_set_name (f, arg, 0);
1724 /* Change the title of frame F to NAME.
1725 If NAME is nil, use the frame name as the title. */
1727 void
1728 x_set_title (f, name, old_name)
1729 struct frame *f;
1730 Lisp_Object name, old_name;
1732 /* Don't change the title if it's already NAME. */
1733 if (EQ (name, f->title))
1734 return;
1736 update_mode_lines = 1;
1738 f->title = name;
1740 if (NILP (name))
1741 name = f->name;
1742 else
1743 CHECK_STRING (name);
1745 x_set_name_internal (f, name);
1748 void
1749 x_set_scroll_bar_default_width (f)
1750 struct frame *f;
1752 int wid = FRAME_COLUMN_WIDTH (f);
1754 #ifdef USE_TOOLKIT_SCROLL_BARS
1755 /* A minimum width of 14 doesn't look good for toolkit scroll bars. */
1756 int width = 16 + 2 * VERTICAL_SCROLL_BAR_WIDTH_TRIM;
1757 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (width + wid - 1) / wid;
1758 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = width;
1759 #else
1760 /* Make the actual width at least 14 pixels and a multiple of a
1761 character width. */
1762 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (14 + wid - 1) / wid;
1764 /* Use all of that space (aside from required margins) for the
1765 scroll bar. */
1766 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = 0;
1767 #endif
1771 /* Record in frame F the specified or default value according to ALIST
1772 of the parameter named PROP (a Lisp symbol). If no value is
1773 specified for PROP, look for an X default for XPROP on the frame
1774 named NAME. If that is not found either, use the value DEFLT. */
1776 static Lisp_Object
1777 x_default_scroll_bar_color_parameter (f, alist, prop, xprop, xclass,
1778 foreground_p)
1779 struct frame *f;
1780 Lisp_Object alist;
1781 Lisp_Object prop;
1782 char *xprop;
1783 char *xclass;
1784 int foreground_p;
1786 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
1787 Lisp_Object tem;
1789 tem = x_get_arg (dpyinfo, alist, prop, xprop, xclass, RES_TYPE_STRING);
1790 if (EQ (tem, Qunbound))
1792 #ifdef USE_TOOLKIT_SCROLL_BARS
1794 /* See if an X resource for the scroll bar color has been
1795 specified. */
1796 tem = display_x_get_resource (dpyinfo,
1797 build_string (foreground_p
1798 ? "foreground"
1799 : "background"),
1800 empty_unibyte_string,
1801 build_string ("verticalScrollBar"),
1802 empty_unibyte_string);
1803 if (!STRINGP (tem))
1805 /* If nothing has been specified, scroll bars will use a
1806 toolkit-dependent default. Because these defaults are
1807 difficult to get at without actually creating a scroll
1808 bar, use nil to indicate that no color has been
1809 specified. */
1810 tem = Qnil;
1813 #else /* not USE_TOOLKIT_SCROLL_BARS */
1815 tem = Qnil;
1817 #endif /* not USE_TOOLKIT_SCROLL_BARS */
1820 x_set_frame_parameters (f, Fcons (Fcons (prop, tem), Qnil));
1821 return tem;
1827 #ifdef USE_X_TOOLKIT
1829 /* If the WM_PROTOCOLS property does not already contain WM_TAKE_FOCUS,
1830 WM_DELETE_WINDOW, and WM_SAVE_YOURSELF, then add them. (They may
1831 already be present because of the toolkit (Motif adds some of them,
1832 for example, but Xt doesn't). */
1834 static void
1835 hack_wm_protocols (f, widget)
1836 FRAME_PTR f;
1837 Widget widget;
1839 Display *dpy = XtDisplay (widget);
1840 Window w = XtWindow (widget);
1841 int need_delete = 1;
1842 int need_focus = 1;
1843 int need_save = 1;
1845 BLOCK_INPUT;
1847 Atom type;
1848 unsigned char *catoms;
1849 int format = 0;
1850 unsigned long nitems = 0;
1851 unsigned long bytes_after;
1853 if ((XGetWindowProperty (dpy, w,
1854 FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
1855 (long)0, (long)100, False, XA_ATOM,
1856 &type, &format, &nitems, &bytes_after,
1857 &catoms)
1858 == Success)
1859 && format == 32 && type == XA_ATOM)
1861 Atom *atoms = (Atom *) catoms;
1862 while (nitems > 0)
1864 nitems--;
1865 if (atoms[nitems]
1866 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window)
1867 need_delete = 0;
1868 else if (atoms[nitems]
1869 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_take_focus)
1870 need_focus = 0;
1871 else if (atoms[nitems]
1872 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself)
1873 need_save = 0;
1876 if (catoms)
1877 XFree (catoms);
1880 Atom props [10];
1881 int count = 0;
1882 if (need_delete)
1883 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window;
1884 if (need_focus)
1885 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_take_focus;
1886 if (need_save)
1887 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself;
1888 if (count)
1889 XChangeProperty (dpy, w, FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
1890 XA_ATOM, 32, PropModeAppend,
1891 (unsigned char *) props, count);
1893 UNBLOCK_INPUT;
1895 #endif
1899 /* Support routines for XIC (X Input Context). */
1901 #ifdef HAVE_X_I18N
1903 static XFontSet xic_create_xfontset P_ ((struct frame *));
1904 static XIMStyle best_xim_style P_ ((XIMStyles *, XIMStyles *));
1907 /* Supported XIM styles, ordered by preference. */
1909 static XIMStyle supported_xim_styles[] =
1911 XIMPreeditPosition | XIMStatusArea,
1912 XIMPreeditPosition | XIMStatusNothing,
1913 XIMPreeditPosition | XIMStatusNone,
1914 XIMPreeditNothing | XIMStatusArea,
1915 XIMPreeditNothing | XIMStatusNothing,
1916 XIMPreeditNothing | XIMStatusNone,
1917 XIMPreeditNone | XIMStatusArea,
1918 XIMPreeditNone | XIMStatusNothing,
1919 XIMPreeditNone | XIMStatusNone,
1924 /* Create an X fontset on frame F with base font name BASE_FONTNAME. */
1926 char xic_defaut_fontset[] = "-*-*-*-r-normal--14-*-*-*-*-*-*-*";
1928 /* Create an Xt fontset spec from the name of a base font.
1929 If `motif' is True use the Motif syntax. */
1930 char *
1931 xic_create_fontsetname (base_fontname, motif)
1932 char *base_fontname;
1933 Bool motif;
1935 const char *sep = motif ? ";" : ",";
1936 char *fontsetname;
1938 /* Make a fontset name from the base font name. */
1939 if (xic_defaut_fontset == base_fontname)
1940 { /* There is no base font name, use the default. */
1941 int len = strlen (base_fontname) + 2;
1942 fontsetname = xmalloc (len);
1943 bzero (fontsetname, len);
1944 strcpy (fontsetname, base_fontname);
1946 else
1948 /* Make a fontset name from the base font name.
1949 The font set will be made of the following elements:
1950 - the base font.
1951 - the base font where the charset spec is replaced by -*-*.
1952 - the same but with the family also replaced with -*-*-. */
1953 char *p = base_fontname;
1954 int i;
1956 for (i = 0; *p; p++)
1957 if (*p == '-') i++;
1958 if (i != 14)
1959 { /* As the font name doesn't conform to XLFD, we can't
1960 modify it to generalize it to allcs and allfamilies.
1961 Use the specified font plus the default. */
1962 int len = strlen (base_fontname) + strlen (xic_defaut_fontset) + 3;
1963 fontsetname = xmalloc (len);
1964 bzero (fontsetname, len);
1965 strcpy (fontsetname, base_fontname);
1966 strcat (fontsetname, sep);
1967 strcat (fontsetname, xic_defaut_fontset);
1969 else
1971 int len;
1972 char *p1 = NULL, *p2 = NULL, *p3 = NULL;
1973 char *font_allcs = NULL;
1974 char *font_allfamilies = NULL;
1975 char *font_all = NULL;
1976 char *allcs = "*-*-*-*-*-*-*";
1977 char *allfamilies = "-*-*-";
1978 char *all = "*-*-*-*-";
1979 char *base;
1981 for (i = 0, p = base_fontname; i < 8; p++)
1983 if (*p == '-')
1985 i++;
1986 if (i == 3)
1987 p1 = p + 1;
1988 else if (i == 7)
1989 p2 = p + 1;
1990 else if (i == 6)
1991 p3 = p + 1;
1994 /* If base_fontname specifies ADSTYLE, make it a
1995 wildcard. */
1996 if (*p3 != '*')
1998 int diff = (p2 - p3) - 2;
2000 base = alloca (strlen (base_fontname) + 1);
2001 bcopy (base_fontname, base, p3 - base_fontname);
2002 base[p3 - base_fontname] = '*';
2003 base[(p3 - base_fontname) + 1] = '-';
2004 strcpy (base + (p3 - base_fontname) + 2, p2);
2005 p = base + (p - base_fontname) - diff;
2006 p1 = base + (p1 - base_fontname);
2007 p2 = base + (p2 - base_fontname) - diff;
2008 base_fontname = base;
2011 /* Build the font spec that matches all charsets. */
2012 len = p - base_fontname + strlen (allcs) + 1;
2013 font_allcs = (char *) alloca (len);
2014 bzero (font_allcs, len);
2015 bcopy (base_fontname, font_allcs, p - base_fontname);
2016 strcat (font_allcs, allcs);
2018 /* Build the font spec that matches all families and
2019 add-styles. */
2020 len = p - p1 + strlen (allcs) + strlen (allfamilies) + 1;
2021 font_allfamilies = (char *) alloca (len);
2022 bzero (font_allfamilies, len);
2023 strcpy (font_allfamilies, allfamilies);
2024 bcopy (p1, font_allfamilies + strlen (allfamilies), p - p1);
2025 strcat (font_allfamilies, allcs);
2027 /* Build the font spec that matches all. */
2028 len = p - p2 + strlen (allcs) + strlen (all) + strlen (allfamilies) + 1;
2029 font_all = (char *) alloca (len);
2030 bzero (font_all, len);
2031 strcpy (font_all, allfamilies);
2032 strcat (font_all, all);
2033 bcopy (p2, font_all + strlen (all) + strlen (allfamilies), p - p2);
2034 strcat (font_all, allcs);
2036 /* Build the actual font set name. */
2037 len = strlen (base_fontname) + strlen (font_allcs)
2038 + strlen (font_allfamilies) + strlen (font_all) + 5;
2039 fontsetname = xmalloc (len);
2040 bzero (fontsetname, len);
2041 strcpy (fontsetname, base_fontname);
2042 strcat (fontsetname, sep);
2043 strcat (fontsetname, font_allcs);
2044 strcat (fontsetname, sep);
2045 strcat (fontsetname, font_allfamilies);
2046 strcat (fontsetname, sep);
2047 strcat (fontsetname, font_all);
2050 if (motif)
2051 strcat (fontsetname, ":");
2052 return fontsetname;
2055 #ifdef DEBUG_XIC_FONTSET
2056 static void
2057 print_fontset_result (xfs, name, missing_list, missing_count)
2058 XFontSet xfs;
2059 char *name;
2060 char **missing_list;
2061 int missing_count;
2063 if (xfs)
2064 fprintf (stderr, "XIC Fontset created: %s\n", name);
2065 else
2067 fprintf (stderr, "XIC Fontset failed: %s\n", name);
2068 while (missing_count-- > 0)
2070 fprintf (stderr, " missing: %s\n", *missing_list);
2071 missing_list++;
2076 #endif
2078 static XFontSet
2079 xic_create_xfontset (f)
2080 struct frame *f;
2082 XFontSet xfs = NULL;
2083 struct font *font = FRAME_FONT (f);
2084 int pixel_size = font->pixel_size;
2085 Lisp_Object rest, frame;
2087 /* See if there is another frame already using same fontset. */
2088 FOR_EACH_FRAME (rest, frame)
2090 struct frame *cf = XFRAME (frame);
2092 if (cf != f && FRAME_LIVE_P (f) && FRAME_X_P (cf)
2093 && FRAME_X_DISPLAY_INFO (cf) == FRAME_X_DISPLAY_INFO (f)
2094 && FRAME_FONT (f)
2095 && FRAME_FONT (f)->pixel_size == pixel_size)
2097 xfs = FRAME_XIC_FONTSET (cf);
2098 break;
2102 if (! xfs)
2104 char buf[256];
2105 char **missing_list;
2106 int missing_count;
2107 char *def_string;
2108 char *xlfd_format = "-*-*-medium-r-normal--%d-*-*-*-*-*";
2110 sprintf (buf, xlfd_format, pixel_size);
2111 missing_list = NULL;
2112 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), buf,
2113 &missing_list, &missing_count, &def_string);
2114 #ifdef DEBUG_XIC_FONTSET
2115 print_fontset_result (xfs, buf, missing_list, missing_count);
2116 #endif
2117 if (missing_list)
2118 XFreeStringList (missing_list);
2119 if (! xfs)
2121 /* List of pixel sizes most likely available. Find one that
2122 is closest to pixel_size. */
2123 int sizes[] = {0, 8, 10, 11, 12, 14, 17, 18, 20, 24, 26, 34, 0};
2124 int *smaller, *larger;
2126 for (smaller = sizes; smaller[1]; smaller++)
2127 if (smaller[1] >= pixel_size)
2128 break;
2129 larger = smaller + 1;
2130 if (*larger == pixel_size)
2131 larger++;
2132 while (*smaller || *larger)
2134 int this_size;
2136 if (! *larger)
2137 this_size = *smaller--;
2138 else if (! *smaller)
2139 this_size = *larger++;
2140 else if (pixel_size - *smaller < *larger - pixel_size)
2141 this_size = *smaller--;
2142 else
2143 this_size = *larger++;
2144 sprintf (buf, xlfd_format, this_size);
2145 missing_list = NULL;
2146 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), buf,
2147 &missing_list, &missing_count, &def_string);
2148 #ifdef DEBUG_XIC_FONTSET
2149 print_fontset_result (xfs, buf, missing_list, missing_count);
2150 #endif
2151 if (missing_list)
2152 XFreeStringList (missing_list);
2153 if (xfs)
2154 break;
2157 if (! xfs)
2159 char *last_resort = "-*-*-*-r-normal--*-*-*-*-*-*";
2161 missing_list = NULL;
2162 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), last_resort,
2163 &missing_list, &missing_count, &def_string);
2164 #ifdef DEBUG_XIC_FONTSET
2165 print_fontset_result (xfs, last_resort, missing_list, missing_count);
2166 #endif
2167 if (missing_list)
2168 XFreeStringList (missing_list);
2173 return xfs;
2176 /* Free the X fontset of frame F if it is the last frame using it. */
2178 void
2179 xic_free_xfontset (f)
2180 struct frame *f;
2182 Lisp_Object rest, frame;
2183 int shared_p = 0;
2185 if (!FRAME_XIC_FONTSET (f))
2186 return;
2188 /* See if there is another frame sharing the same fontset. */
2189 FOR_EACH_FRAME (rest, frame)
2191 struct frame *cf = XFRAME (frame);
2192 if (cf != f && FRAME_LIVE_P (f) && FRAME_X_P (cf)
2193 && FRAME_X_DISPLAY_INFO (cf) == FRAME_X_DISPLAY_INFO (f)
2194 && FRAME_XIC_FONTSET (cf) == FRAME_XIC_FONTSET (f))
2196 shared_p = 1;
2197 break;
2201 if (!shared_p)
2202 /* The fontset is not used anymore. It is safe to free it. */
2203 XFreeFontSet (FRAME_X_DISPLAY (f), FRAME_XIC_FONTSET (f));
2205 if (FRAME_XIC_BASE_FONTNAME (f))
2206 xfree (FRAME_XIC_BASE_FONTNAME (f));
2207 FRAME_XIC_BASE_FONTNAME (f) = NULL;
2208 FRAME_XIC_FONTSET (f) = NULL;
2212 /* Value is the best input style, given user preferences USER (already
2213 checked to be supported by Emacs), and styles supported by the
2214 input method XIM. */
2216 static XIMStyle
2217 best_xim_style (user, xim)
2218 XIMStyles *user;
2219 XIMStyles *xim;
2221 int i, j;
2223 for (i = 0; i < user->count_styles; ++i)
2224 for (j = 0; j < xim->count_styles; ++j)
2225 if (user->supported_styles[i] == xim->supported_styles[j])
2226 return user->supported_styles[i];
2228 /* Return the default style. */
2229 return XIMPreeditNothing | XIMStatusNothing;
2232 /* Create XIC for frame F. */
2234 static XIMStyle xic_style;
2236 void
2237 create_frame_xic (f)
2238 struct frame *f;
2240 XIM xim;
2241 XIC xic = NULL;
2242 XFontSet xfs = NULL;
2244 if (FRAME_XIC (f))
2245 return;
2247 /* Create X fontset. */
2248 xfs = xic_create_xfontset (f);
2249 xim = FRAME_X_XIM (f);
2250 if (xim)
2252 XRectangle s_area;
2253 XPoint spot;
2254 XVaNestedList preedit_attr;
2255 XVaNestedList status_attr;
2257 s_area.x = 0; s_area.y = 0; s_area.width = 1; s_area.height = 1;
2258 spot.x = 0; spot.y = 1;
2260 /* Determine XIC style. */
2261 if (xic_style == 0)
2263 XIMStyles supported_list;
2264 supported_list.count_styles = (sizeof supported_xim_styles
2265 / sizeof supported_xim_styles[0]);
2266 supported_list.supported_styles = supported_xim_styles;
2267 xic_style = best_xim_style (&supported_list,
2268 FRAME_X_XIM_STYLES (f));
2271 preedit_attr = XVaCreateNestedList (0,
2272 XNFontSet, xfs,
2273 XNForeground,
2274 FRAME_FOREGROUND_PIXEL (f),
2275 XNBackground,
2276 FRAME_BACKGROUND_PIXEL (f),
2277 (xic_style & XIMPreeditPosition
2278 ? XNSpotLocation
2279 : NULL),
2280 &spot,
2281 NULL);
2282 status_attr = XVaCreateNestedList (0,
2283 XNArea,
2284 &s_area,
2285 XNFontSet,
2286 xfs,
2287 XNForeground,
2288 FRAME_FOREGROUND_PIXEL (f),
2289 XNBackground,
2290 FRAME_BACKGROUND_PIXEL (f),
2291 NULL);
2293 xic = XCreateIC (xim,
2294 XNInputStyle, xic_style,
2295 XNClientWindow, FRAME_X_WINDOW (f),
2296 XNFocusWindow, FRAME_X_WINDOW (f),
2297 XNStatusAttributes, status_attr,
2298 XNPreeditAttributes, preedit_attr,
2299 NULL);
2300 XFree (preedit_attr);
2301 XFree (status_attr);
2304 FRAME_XIC (f) = xic;
2305 FRAME_XIC_STYLE (f) = xic_style;
2306 FRAME_XIC_FONTSET (f) = xfs;
2310 /* Destroy XIC and free XIC fontset of frame F, if any. */
2312 void
2313 free_frame_xic (f)
2314 struct frame *f;
2316 if (FRAME_XIC (f) == NULL)
2317 return;
2319 XDestroyIC (FRAME_XIC (f));
2320 xic_free_xfontset (f);
2322 FRAME_XIC (f) = NULL;
2326 /* Place preedit area for XIC of window W's frame to specified
2327 pixel position X/Y. X and Y are relative to window W. */
2329 void
2330 xic_set_preeditarea (w, x, y)
2331 struct window *w;
2332 int x, y;
2334 struct frame *f = XFRAME (w->frame);
2335 XVaNestedList attr;
2336 XPoint spot;
2338 spot.x = WINDOW_TO_FRAME_PIXEL_X (w, x) + WINDOW_LEFT_FRINGE_WIDTH (w);
2339 spot.y = WINDOW_TO_FRAME_PIXEL_Y (w, y) + FONT_BASE (FRAME_FONT (f));
2340 attr = XVaCreateNestedList (0, XNSpotLocation, &spot, NULL);
2341 XSetICValues (FRAME_XIC (f), XNPreeditAttributes, attr, NULL);
2342 XFree (attr);
2346 /* Place status area for XIC in bottom right corner of frame F.. */
2348 void
2349 xic_set_statusarea (f)
2350 struct frame *f;
2352 XIC xic = FRAME_XIC (f);
2353 XVaNestedList attr;
2354 XRectangle area;
2355 XRectangle *needed;
2357 /* Negotiate geometry of status area. If input method has existing
2358 status area, use its current size. */
2359 area.x = area.y = area.width = area.height = 0;
2360 attr = XVaCreateNestedList (0, XNAreaNeeded, &area, NULL);
2361 XSetICValues (xic, XNStatusAttributes, attr, NULL);
2362 XFree (attr);
2364 attr = XVaCreateNestedList (0, XNAreaNeeded, &needed, NULL);
2365 XGetICValues (xic, XNStatusAttributes, attr, NULL);
2366 XFree (attr);
2368 if (needed->width == 0) /* Use XNArea instead of XNAreaNeeded */
2370 attr = XVaCreateNestedList (0, XNArea, &needed, NULL);
2371 XGetICValues (xic, XNStatusAttributes, attr, NULL);
2372 XFree (attr);
2375 area.width = needed->width;
2376 area.height = needed->height;
2377 area.x = FRAME_PIXEL_WIDTH (f) - area.width - FRAME_INTERNAL_BORDER_WIDTH (f);
2378 area.y = (FRAME_PIXEL_HEIGHT (f) - area.height
2379 - FRAME_MENUBAR_HEIGHT (f)
2380 - FRAME_TOOLBAR_HEIGHT (f)
2381 - FRAME_INTERNAL_BORDER_WIDTH (f));
2382 XFree (needed);
2384 attr = XVaCreateNestedList (0, XNArea, &area, NULL);
2385 XSetICValues (xic, XNStatusAttributes, attr, NULL);
2386 XFree (attr);
2390 /* Set X fontset for XIC of frame F, using base font name
2391 BASE_FONTNAME. Called when a new Emacs fontset is chosen. */
2393 void
2394 xic_set_xfontset (f, base_fontname)
2395 struct frame *f;
2396 char *base_fontname;
2398 XVaNestedList attr;
2399 XFontSet xfs;
2401 xic_free_xfontset (f);
2403 xfs = xic_create_xfontset (f);
2405 attr = XVaCreateNestedList (0, XNFontSet, xfs, NULL);
2406 if (FRAME_XIC_STYLE (f) & XIMPreeditPosition)
2407 XSetICValues (FRAME_XIC (f), XNPreeditAttributes, attr, NULL);
2408 if (FRAME_XIC_STYLE (f) & XIMStatusArea)
2409 XSetICValues (FRAME_XIC (f), XNStatusAttributes, attr, NULL);
2410 XFree (attr);
2412 FRAME_XIC_FONTSET (f) = xfs;
2415 #endif /* HAVE_X_I18N */
2419 #ifdef USE_X_TOOLKIT
2421 /* Create and set up the X widget for frame F. */
2423 static void
2424 x_window (f, window_prompting, minibuffer_only)
2425 struct frame *f;
2426 long window_prompting;
2427 int minibuffer_only;
2429 XClassHint class_hints;
2430 XSetWindowAttributes attributes;
2431 unsigned long attribute_mask;
2432 Widget shell_widget;
2433 Widget pane_widget;
2434 Widget frame_widget;
2435 Arg al [25];
2436 int ac;
2438 BLOCK_INPUT;
2440 /* Use the resource name as the top-level widget name
2441 for looking up resources. Make a non-Lisp copy
2442 for the window manager, so GC relocation won't bother it.
2444 Elsewhere we specify the window name for the window manager. */
2447 char *str = (char *) SDATA (Vx_resource_name);
2448 f->namebuf = (char *) xmalloc (strlen (str) + 1);
2449 strcpy (f->namebuf, str);
2452 ac = 0;
2453 XtSetArg (al[ac], XtNallowShellResize, 1); ac++;
2454 XtSetArg (al[ac], XtNinput, 1); ac++;
2455 XtSetArg (al[ac], XtNmappedWhenManaged, 0); ac++;
2456 XtSetArg (al[ac], XtNborderWidth, f->border_width); 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 shell_widget = XtAppCreateShell (f->namebuf, EMACS_CLASS,
2461 applicationShellWidgetClass,
2462 FRAME_X_DISPLAY (f), al, ac);
2464 f->output_data.x->widget = shell_widget;
2465 /* maybe_set_screen_title_format (shell_widget); */
2467 pane_widget = lw_create_widget ("main", "pane", widget_id_tick++,
2468 (widget_value *) NULL,
2469 shell_widget, False,
2470 (lw_callback) NULL,
2471 (lw_callback) NULL,
2472 (lw_callback) NULL,
2473 (lw_callback) NULL);
2475 ac = 0;
2476 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2477 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2478 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2479 XtSetValues (pane_widget, al, ac);
2480 f->output_data.x->column_widget = pane_widget;
2482 /* mappedWhenManaged to false tells to the paned window to not map/unmap
2483 the emacs screen when changing menubar. This reduces flickering. */
2485 ac = 0;
2486 XtSetArg (al[ac], XtNmappedWhenManaged, 0); ac++;
2487 XtSetArg (al[ac], XtNshowGrip, 0); ac++;
2488 XtSetArg (al[ac], XtNallowResize, 1); ac++;
2489 XtSetArg (al[ac], XtNresizeToPreferred, 1); ac++;
2490 XtSetArg (al[ac], XtNemacsFrame, f); ac++;
2491 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2492 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2493 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
2494 frame_widget = XtCreateWidget (f->namebuf, emacsFrameClass, pane_widget,
2495 al, ac);
2497 f->output_data.x->edit_widget = frame_widget;
2499 XtManageChild (frame_widget);
2501 /* Do some needed geometry management. */
2503 int len;
2504 char *tem, shell_position[32];
2505 Arg al[10];
2506 int ac = 0;
2507 int extra_borders = 0;
2508 int menubar_size
2509 = (f->output_data.x->menubar_widget
2510 ? (f->output_data.x->menubar_widget->core.height
2511 + f->output_data.x->menubar_widget->core.border_width)
2512 : 0);
2514 #if 0 /* Experimentally, we now get the right results
2515 for -geometry -0-0 without this. 24 Aug 96, rms. */
2516 if (FRAME_EXTERNAL_MENU_BAR (f))
2518 Dimension ibw = 0;
2519 XtVaGetValues (pane_widget, XtNinternalBorderWidth, &ibw, NULL);
2520 menubar_size += ibw;
2522 #endif
2524 f->output_data.x->menubar_height = menubar_size;
2526 #ifndef USE_LUCID
2527 /* Motif seems to need this amount added to the sizes
2528 specified for the shell widget. The Athena/Lucid widgets don't.
2529 Both conclusions reached experimentally. -- rms. */
2530 XtVaGetValues (f->output_data.x->edit_widget, XtNinternalBorderWidth,
2531 &extra_borders, NULL);
2532 extra_borders *= 2;
2533 #endif
2535 /* Convert our geometry parameters into a geometry string
2536 and specify it.
2537 Note that we do not specify here whether the position
2538 is a user-specified or program-specified one.
2539 We pass that information later, in x_wm_set_size_hints. */
2541 int left = f->left_pos;
2542 int xneg = window_prompting & XNegative;
2543 int top = f->top_pos;
2544 int yneg = window_prompting & YNegative;
2545 if (xneg)
2546 left = -left;
2547 if (yneg)
2548 top = -top;
2550 if (window_prompting & USPosition)
2551 sprintf (shell_position, "=%dx%d%c%d%c%d",
2552 FRAME_PIXEL_WIDTH (f) + extra_borders,
2553 FRAME_PIXEL_HEIGHT (f) + menubar_size + extra_borders,
2554 (xneg ? '-' : '+'), left,
2555 (yneg ? '-' : '+'), top);
2556 else
2558 sprintf (shell_position, "=%dx%d",
2559 FRAME_PIXEL_WIDTH (f) + extra_borders,
2560 FRAME_PIXEL_HEIGHT (f) + menubar_size + extra_borders);
2562 /* Setting x and y when the position is not specified in
2563 the geometry string will set program position in the WM hints.
2564 If Emacs had just one program position, we could set it in
2565 fallback resources, but since each make-frame call can specify
2566 different program positions, this is easier. */
2567 XtSetArg (al[ac], XtNx, left); ac++;
2568 XtSetArg (al[ac], XtNy, top); ac++;
2572 len = strlen (shell_position) + 1;
2573 /* We don't free this because we don't know whether
2574 it is safe to free it while the frame exists.
2575 It isn't worth the trouble of arranging to free it
2576 when the frame is deleted. */
2577 tem = (char *) xmalloc (len);
2578 strncpy (tem, shell_position, len);
2579 XtSetArg (al[ac], XtNgeometry, tem); ac++;
2580 XtSetValues (shell_widget, al, ac);
2583 XtManageChild (pane_widget);
2584 XtRealizeWidget (shell_widget);
2586 if (FRAME_X_EMBEDDED_P (f))
2587 XReparentWindow (FRAME_X_DISPLAY (f), XtWindow (shell_widget),
2588 f->output_data.x->parent_desc, 0, 0);
2590 FRAME_X_WINDOW (f) = XtWindow (frame_widget);
2592 validate_x_resource_name ();
2594 class_hints.res_name = (char *) SDATA (Vx_resource_name);
2595 class_hints.res_class = (char *) SDATA (Vx_resource_class);
2596 XSetClassHint (FRAME_X_DISPLAY (f), XtWindow (shell_widget), &class_hints);
2598 #ifdef HAVE_X_I18N
2599 FRAME_XIC (f) = NULL;
2600 if (use_xim)
2601 create_frame_xic (f);
2602 #endif
2604 f->output_data.x->wm_hints.input = True;
2605 f->output_data.x->wm_hints.flags |= InputHint;
2606 XSetWMHints (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2607 &f->output_data.x->wm_hints);
2609 hack_wm_protocols (f, shell_widget);
2611 #ifdef HACK_EDITRES
2612 XtAddEventHandler (shell_widget, 0, True, _XEditResCheckMessages, 0);
2613 #endif
2615 /* Do a stupid property change to force the server to generate a
2616 PropertyNotify event so that the event_stream server timestamp will
2617 be initialized to something relevant to the time we created the window.
2619 XChangeProperty (XtDisplay (frame_widget), XtWindow (frame_widget),
2620 FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
2621 XA_ATOM, 32, PropModeAppend,
2622 (unsigned char*) NULL, 0);
2624 /* Make all the standard events reach the Emacs frame. */
2625 attributes.event_mask = STANDARD_EVENT_SET;
2627 #ifdef HAVE_X_I18N
2628 if (FRAME_XIC (f))
2630 /* XIM server might require some X events. */
2631 unsigned long fevent = NoEventMask;
2632 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2633 attributes.event_mask |= fevent;
2635 #endif /* HAVE_X_I18N */
2637 attribute_mask = CWEventMask;
2638 XChangeWindowAttributes (XtDisplay (shell_widget), XtWindow (shell_widget),
2639 attribute_mask, &attributes);
2641 XtMapWidget (frame_widget);
2643 /* x_set_name normally ignores requests to set the name if the
2644 requested name is the same as the current name. This is the one
2645 place where that assumption isn't correct; f->name is set, but
2646 the X server hasn't been told. */
2648 Lisp_Object name;
2649 int explicit = f->explicit_name;
2651 f->explicit_name = 0;
2652 name = f->name;
2653 f->name = Qnil;
2654 x_set_name (f, name, explicit);
2657 XDefineCursor (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2658 f->output_data.x->current_cursor
2659 = f->output_data.x->text_cursor);
2661 UNBLOCK_INPUT;
2663 /* This is a no-op, except under Motif. Make sure main areas are
2664 set to something reasonable, in case we get an error later. */
2665 lw_set_main_areas (pane_widget, 0, frame_widget);
2668 #else /* not USE_X_TOOLKIT */
2669 #ifdef USE_GTK
2670 void
2671 x_window (f)
2672 FRAME_PTR f;
2674 if (! xg_create_frame_widgets (f))
2675 error ("Unable to create window");
2677 #ifdef HAVE_X_I18N
2678 FRAME_XIC (f) = NULL;
2679 if (use_xim)
2681 BLOCK_INPUT;
2682 create_frame_xic (f);
2683 if (FRAME_XIC (f))
2685 /* XIM server might require some X events. */
2686 unsigned long fevent = NoEventMask;
2687 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2689 if (fevent != NoEventMask)
2691 XSetWindowAttributes attributes;
2692 XWindowAttributes wattr;
2693 unsigned long attribute_mask;
2695 XGetWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2696 &wattr);
2697 attributes.event_mask = wattr.your_event_mask | fevent;
2698 attribute_mask = CWEventMask;
2699 XChangeWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2700 attribute_mask, &attributes);
2703 UNBLOCK_INPUT;
2705 #endif
2708 #else /*! USE_GTK */
2709 /* Create and set up the X window for frame F. */
2711 void
2712 x_window (f)
2713 struct frame *f;
2716 XClassHint class_hints;
2717 XSetWindowAttributes attributes;
2718 unsigned long attribute_mask;
2720 attributes.background_pixel = FRAME_BACKGROUND_PIXEL (f);
2721 attributes.border_pixel = f->output_data.x->border_pixel;
2722 attributes.bit_gravity = StaticGravity;
2723 attributes.backing_store = NotUseful;
2724 attributes.save_under = True;
2725 attributes.event_mask = STANDARD_EVENT_SET;
2726 attributes.colormap = FRAME_X_COLORMAP (f);
2727 attribute_mask = (CWBackPixel | CWBorderPixel | CWBitGravity | CWEventMask
2728 | CWColormap);
2730 BLOCK_INPUT;
2731 FRAME_X_WINDOW (f)
2732 = XCreateWindow (FRAME_X_DISPLAY (f),
2733 f->output_data.x->parent_desc,
2734 f->left_pos,
2735 f->top_pos,
2736 FRAME_PIXEL_WIDTH (f), FRAME_PIXEL_HEIGHT (f),
2737 f->border_width,
2738 CopyFromParent, /* depth */
2739 InputOutput, /* class */
2740 FRAME_X_VISUAL (f),
2741 attribute_mask, &attributes);
2743 #ifdef HAVE_X_I18N
2744 if (use_xim)
2746 create_frame_xic (f);
2747 if (FRAME_XIC (f))
2749 /* XIM server might require some X events. */
2750 unsigned long fevent = NoEventMask;
2751 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
2752 attributes.event_mask |= fevent;
2753 attribute_mask = CWEventMask;
2754 XChangeWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2755 attribute_mask, &attributes);
2758 #endif /* HAVE_X_I18N */
2760 validate_x_resource_name ();
2762 class_hints.res_name = (char *) SDATA (Vx_resource_name);
2763 class_hints.res_class = (char *) SDATA (Vx_resource_class);
2764 XSetClassHint (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), &class_hints);
2766 /* The menubar is part of the ordinary display;
2767 it does not count in addition to the height of the window. */
2768 f->output_data.x->menubar_height = 0;
2770 /* This indicates that we use the "Passive Input" input model.
2771 Unless we do this, we don't get the Focus{In,Out} events that we
2772 need to draw the cursor correctly. Accursed bureaucrats.
2773 XWhipsAndChains (FRAME_X_DISPLAY (f), IronMaiden, &TheRack); */
2775 f->output_data.x->wm_hints.input = True;
2776 f->output_data.x->wm_hints.flags |= InputHint;
2777 XSetWMHints (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2778 &f->output_data.x->wm_hints);
2779 f->output_data.x->wm_hints.icon_pixmap = None;
2781 /* Request "save yourself" and "delete window" commands from wm. */
2783 Atom protocols[2];
2784 protocols[0] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window;
2785 protocols[1] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself;
2786 XSetWMProtocols (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), protocols, 2);
2789 /* x_set_name normally ignores requests to set the name if the
2790 requested name is the same as the current name. This is the one
2791 place where that assumption isn't correct; f->name is set, but
2792 the X server hasn't been told. */
2794 Lisp_Object name;
2795 int explicit = f->explicit_name;
2797 f->explicit_name = 0;
2798 name = f->name;
2799 f->name = Qnil;
2800 x_set_name (f, name, explicit);
2803 XDefineCursor (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2804 f->output_data.x->current_cursor
2805 = f->output_data.x->text_cursor);
2807 UNBLOCK_INPUT;
2809 if (FRAME_X_WINDOW (f) == 0)
2810 error ("Unable to create window");
2813 #endif /* not USE_GTK */
2814 #endif /* not USE_X_TOOLKIT */
2816 /* Verify that the icon position args for this window are valid. */
2818 static void
2819 x_icon_verify (f, parms)
2820 struct frame *f;
2821 Lisp_Object parms;
2823 Lisp_Object icon_x, icon_y;
2825 /* Set the position of the icon. Note that twm groups all
2826 icons in an icon window. */
2827 icon_x = x_frame_get_and_record_arg (f, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
2828 icon_y = x_frame_get_and_record_arg (f, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
2829 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
2831 CHECK_NUMBER (icon_x);
2832 CHECK_NUMBER (icon_y);
2834 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
2835 error ("Both left and top icon corners of icon must be specified");
2838 /* Handle the icon stuff for this window. Perhaps later we might
2839 want an x_set_icon_position which can be called interactively as
2840 well. */
2842 static void
2843 x_icon (f, parms)
2844 struct frame *f;
2845 Lisp_Object parms;
2847 Lisp_Object icon_x, icon_y;
2848 #if 0
2849 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
2850 #endif
2852 /* Set the position of the icon. Note that twm groups all
2853 icons in an icon window. */
2854 icon_x = x_frame_get_and_record_arg (f, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
2855 icon_y = x_frame_get_and_record_arg (f, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
2856 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
2858 CHECK_NUMBER (icon_x);
2859 CHECK_NUMBER (icon_y);
2861 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
2862 error ("Both left and top icon corners of icon must be specified");
2864 BLOCK_INPUT;
2866 if (! EQ (icon_x, Qunbound))
2867 x_wm_set_icon_position (f, XINT (icon_x), XINT (icon_y));
2869 #if 0 /* x_get_arg removes the visibility parameter as a side effect,
2870 but x_create_frame still needs it. */
2871 /* Start up iconic or window? */
2872 x_wm_set_window_state
2873 (f, (EQ (x_get_arg (dpyinfo, parms, Qvisibility, 0, 0, RES_TYPE_SYMBOL),
2874 Qicon)
2875 ? IconicState
2876 : NormalState));
2877 #endif
2879 x_text_icon (f, (char *) SDATA ((!NILP (f->icon_name)
2880 ? f->icon_name
2881 : f->name)));
2883 UNBLOCK_INPUT;
2886 /* Make the GCs needed for this window, setting the
2887 background, border and mouse colors; also create the
2888 mouse cursor and the gray border tile. */
2890 static void
2891 x_make_gc (f)
2892 struct frame *f;
2894 XGCValues gc_values;
2896 BLOCK_INPUT;
2898 /* Create the GCs of this frame.
2899 Note that many default values are used. */
2901 gc_values.foreground = FRAME_FOREGROUND_PIXEL (f);
2902 gc_values.background = FRAME_BACKGROUND_PIXEL (f);
2903 gc_values.line_width = 0; /* Means 1 using fast algorithm. */
2904 f->output_data.x->normal_gc
2905 = XCreateGC (FRAME_X_DISPLAY (f),
2906 FRAME_X_WINDOW (f),
2907 GCLineWidth | GCForeground | GCBackground,
2908 &gc_values);
2910 /* Reverse video style. */
2911 gc_values.foreground = FRAME_BACKGROUND_PIXEL (f);
2912 gc_values.background = FRAME_FOREGROUND_PIXEL (f);
2913 f->output_data.x->reverse_gc
2914 = XCreateGC (FRAME_X_DISPLAY (f),
2915 FRAME_X_WINDOW (f),
2916 GCForeground | GCBackground | GCLineWidth,
2917 &gc_values);
2919 /* Cursor has cursor-color background, background-color foreground. */
2920 gc_values.foreground = FRAME_BACKGROUND_PIXEL (f);
2921 gc_values.background = f->output_data.x->cursor_pixel;
2922 gc_values.fill_style = FillOpaqueStippled;
2923 f->output_data.x->cursor_gc
2924 = XCreateGC (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2925 (GCForeground | GCBackground
2926 | GCFillStyle | GCLineWidth),
2927 &gc_values);
2929 /* Reliefs. */
2930 f->output_data.x->white_relief.gc = 0;
2931 f->output_data.x->black_relief.gc = 0;
2933 /* Create the gray border tile used when the pointer is not in
2934 the frame. Since this depends on the frame's pixel values,
2935 this must be done on a per-frame basis. */
2936 f->output_data.x->border_tile
2937 = (XCreatePixmapFromBitmapData
2938 (FRAME_X_DISPLAY (f), FRAME_X_DISPLAY_INFO (f)->root_window,
2939 gray_bits, gray_width, gray_height,
2940 FRAME_FOREGROUND_PIXEL (f),
2941 FRAME_BACKGROUND_PIXEL (f),
2942 DefaultDepth (FRAME_X_DISPLAY (f), FRAME_X_SCREEN_NUMBER (f))));
2944 UNBLOCK_INPUT;
2948 /* Free what was allocated in x_make_gc. */
2950 void
2951 x_free_gcs (f)
2952 struct frame *f;
2954 Display *dpy = FRAME_X_DISPLAY (f);
2956 BLOCK_INPUT;
2958 if (f->output_data.x->normal_gc)
2960 XFreeGC (dpy, f->output_data.x->normal_gc);
2961 f->output_data.x->normal_gc = 0;
2964 if (f->output_data.x->reverse_gc)
2966 XFreeGC (dpy, f->output_data.x->reverse_gc);
2967 f->output_data.x->reverse_gc = 0;
2970 if (f->output_data.x->cursor_gc)
2972 XFreeGC (dpy, f->output_data.x->cursor_gc);
2973 f->output_data.x->cursor_gc = 0;
2976 if (f->output_data.x->border_tile)
2978 XFreePixmap (dpy, f->output_data.x->border_tile);
2979 f->output_data.x->border_tile = 0;
2982 UNBLOCK_INPUT;
2986 /* Handler for signals raised during x_create_frame and
2987 x_create_top_frame. FRAME is the frame which is partially
2988 constructed. */
2990 static Lisp_Object
2991 unwind_create_frame (frame)
2992 Lisp_Object frame;
2994 struct frame *f = XFRAME (frame);
2996 /* If frame is already dead, nothing to do. This can happen if the
2997 display is disconnected after the frame has become official, but
2998 before x_create_frame removes the unwind protect. */
2999 if (!FRAME_LIVE_P (f))
3000 return Qnil;
3002 /* If frame is ``official'', nothing to do. */
3003 if (!CONSP (Vframe_list) || !EQ (XCAR (Vframe_list), frame))
3005 #if GLYPH_DEBUG
3006 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
3007 #endif
3009 x_free_frame_resources (f);
3011 #if GLYPH_DEBUG
3012 /* Check that reference counts are indeed correct. */
3013 xassert (dpyinfo->reference_count == dpyinfo_refcount);
3014 xassert (dpyinfo->image_cache->refcount == image_cache_refcount);
3015 #endif
3016 return Qt;
3019 return Qnil;
3023 static void
3024 x_default_font_parameter (f, parms)
3025 struct frame *f;
3026 Lisp_Object parms;
3028 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
3029 Lisp_Object font_param = x_get_arg (dpyinfo, parms, Qfont, NULL, NULL,
3030 RES_TYPE_STRING);
3031 Lisp_Object font;
3032 int got_from_gconf = 0;
3033 if (EQ (font_param, Qunbound))
3034 font_param = Qnil;
3036 if (NILP (font_param))
3038 /* System font takes precedendce over X resources. We must suggest this
3039 regardless of font-use-system-font because .emacs may not have been
3040 read yet. */
3041 const char *system_font = xsettings_get_system_font ();
3042 if (system_font) font_param = make_string (system_font,
3043 strlen (system_font));
3046 font = !NILP (font_param) ? font_param
3047 : x_get_arg (dpyinfo, parms, Qfont, "font", "Font", RES_TYPE_STRING);
3049 if (! STRINGP (font))
3051 char *names[]
3053 #ifdef HAVE_XFT
3054 /* This will find the normal Xft font. */
3055 "monospace-12",
3056 #endif
3057 "-adobe-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-1",
3058 "-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-1",
3059 "-*-*-medium-r-normal-*-*-140-*-*-c-*-iso8859-1",
3060 /* This was formerly the first thing tried, but it finds
3061 too many fonts and takes too long. */
3062 "-*-*-medium-r-*-*-*-*-*-*-c-*-iso8859-1",
3063 /* If those didn't work, look for something which will
3064 at least work. */
3065 "-*-fixed-*-*-*-*-*-140-*-*-c-*-iso8859-1",
3066 "fixed",
3067 NULL };
3068 int i;
3070 for (i = 0; names[i]; i++)
3072 font = font_open_by_name (f, names[i]);
3073 if (! NILP (font))
3074 break;
3076 if (NILP (font))
3077 error ("No suitable font was found");
3079 else if (!NILP (font_param))
3081 /* Remember the explicit font parameter, so we can re-apply it after
3082 we've applied the `default' face settings. */
3083 x_set_frame_parameters (f, Fcons (Fcons (Qfont_param, font_param), Qnil));
3086 x_default_parameter (f, parms, Qfont, font,
3087 got_from_gconf ? NULL : "font",
3088 got_from_gconf ? NULL : "Font",
3089 RES_TYPE_STRING);
3093 DEFUN ("x-wm-set-size-hint", Fx_wm_set_size_hint, Sx_wm_set_size_hint,
3094 0, 1, 0,
3095 doc: /* Send the size hints for frame FRAME to the window manager.
3096 If FRAME is nil, use the selected frame. */)
3097 (frame)
3098 Lisp_Object frame;
3100 struct frame *f;
3101 if (NILP (frame))
3102 frame = selected_frame;
3103 f = XFRAME (frame);
3104 BLOCK_INPUT;
3105 if (FRAME_X_P (f))
3106 x_wm_set_size_hint (f, 0, 0);
3107 UNBLOCK_INPUT;
3108 return Qnil;
3111 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
3112 1, 1, 0,
3113 doc: /* Make a new X window, which is called a "frame" in Emacs terms.
3114 Return an Emacs frame object.
3115 PARMS is an alist of frame parameters.
3116 If the parameters specify that the frame should not have a minibuffer,
3117 and do not specify a specific minibuffer window to use,
3118 then `default-minibuffer-frame' must be a frame whose minibuffer can
3119 be shared by the new frame.
3121 This function is an internal primitive--use `make-frame' instead. */)
3122 (parms)
3123 Lisp_Object parms;
3125 struct frame *f;
3126 Lisp_Object frame, tem;
3127 Lisp_Object name;
3128 int minibuffer_only = 0;
3129 long window_prompting = 0;
3130 int width, height;
3131 int count = SPECPDL_INDEX ();
3132 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
3133 Lisp_Object display;
3134 struct x_display_info *dpyinfo = NULL;
3135 Lisp_Object parent;
3136 struct kboard *kb;
3138 parms = Fcopy_alist (parms);
3140 /* Use this general default value to start with
3141 until we know if this frame has a specified name. */
3142 Vx_resource_name = Vinvocation_name;
3144 display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_NUMBER);
3145 if (EQ (display, Qunbound))
3146 display = x_get_arg (dpyinfo, parms, Qdisplay, 0, 0, RES_TYPE_STRING);
3147 if (EQ (display, Qunbound))
3148 display = Qnil;
3149 dpyinfo = check_x_display_info (display);
3150 kb = dpyinfo->terminal->kboard;
3152 if (!dpyinfo->terminal->name)
3153 error ("Terminal is not live, can't create new frames on it");
3155 name = x_get_arg (dpyinfo, parms, Qname, "name", "Name", RES_TYPE_STRING);
3156 if (!STRINGP (name)
3157 && ! EQ (name, Qunbound)
3158 && ! NILP (name))
3159 error ("Invalid frame name--not a string or nil");
3161 if (STRINGP (name))
3162 Vx_resource_name = name;
3164 /* See if parent window is specified. */
3165 parent = x_get_arg (dpyinfo, parms, Qparent_id, NULL, NULL, RES_TYPE_NUMBER);
3166 if (EQ (parent, Qunbound))
3167 parent = Qnil;
3168 if (! NILP (parent))
3169 CHECK_NUMBER (parent);
3171 /* make_frame_without_minibuffer can run Lisp code and garbage collect. */
3172 /* No need to protect DISPLAY because that's not used after passing
3173 it to make_frame_without_minibuffer. */
3174 frame = Qnil;
3175 GCPRO4 (parms, parent, name, frame);
3176 tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
3177 RES_TYPE_SYMBOL);
3178 if (EQ (tem, Qnone) || NILP (tem))
3179 f = make_frame_without_minibuffer (Qnil, kb, display);
3180 else if (EQ (tem, Qonly))
3182 f = make_minibuffer_frame ();
3183 minibuffer_only = 1;
3185 else if (WINDOWP (tem))
3186 f = make_frame_without_minibuffer (tem, kb, display);
3187 else
3188 f = make_frame (1);
3190 XSETFRAME (frame, f);
3192 /* Note that X Windows does support scroll bars. */
3193 FRAME_CAN_HAVE_SCROLL_BARS (f) = 1;
3195 f->terminal = dpyinfo->terminal;
3196 f->terminal->reference_count++;
3198 f->output_method = output_x_window;
3199 f->output_data.x = (struct x_output *) xmalloc (sizeof (struct x_output));
3200 bzero (f->output_data.x, sizeof (struct x_output));
3201 f->output_data.x->icon_bitmap = -1;
3202 FRAME_FONTSET (f) = -1;
3203 f->output_data.x->scroll_bar_foreground_pixel = -1;
3204 f->output_data.x->scroll_bar_background_pixel = -1;
3205 #ifdef USE_TOOLKIT_SCROLL_BARS
3206 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
3207 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
3208 #endif /* USE_TOOLKIT_SCROLL_BARS */
3210 f->icon_name
3211 = x_get_arg (dpyinfo, parms, Qicon_name, "iconName", "Title",
3212 RES_TYPE_STRING);
3213 if (! STRINGP (f->icon_name))
3214 f->icon_name = Qnil;
3216 FRAME_X_DISPLAY_INFO (f) = dpyinfo;
3218 /* With FRAME_X_DISPLAY_INFO set up, this unwind-protect is safe. */
3219 record_unwind_protect (unwind_create_frame, frame);
3220 #if GLYPH_DEBUG
3221 image_cache_refcount = FRAME_IMAGE_CACHE (f)->refcount;
3222 dpyinfo_refcount = dpyinfo->reference_count;
3223 #endif /* GLYPH_DEBUG */
3225 /* These colors will be set anyway later, but it's important
3226 to get the color reference counts right, so initialize them! */
3228 Lisp_Object black;
3229 struct gcpro gcpro1;
3231 /* Function x_decode_color can signal an error. Make
3232 sure to initialize color slots so that we won't try
3233 to free colors we haven't allocated. */
3234 FRAME_FOREGROUND_PIXEL (f) = -1;
3235 FRAME_BACKGROUND_PIXEL (f) = -1;
3236 f->output_data.x->cursor_pixel = -1;
3237 f->output_data.x->cursor_foreground_pixel = -1;
3238 f->output_data.x->border_pixel = -1;
3239 f->output_data.x->mouse_pixel = -1;
3241 black = build_string ("black");
3242 GCPRO1 (black);
3243 FRAME_FOREGROUND_PIXEL (f)
3244 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3245 FRAME_BACKGROUND_PIXEL (f)
3246 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3247 f->output_data.x->cursor_pixel
3248 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3249 f->output_data.x->cursor_foreground_pixel
3250 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3251 f->output_data.x->border_pixel
3252 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3253 f->output_data.x->mouse_pixel
3254 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3255 UNGCPRO;
3258 /* Specify the parent under which to make this X window. */
3260 if (!NILP (parent))
3262 f->output_data.x->parent_desc = (Window) XFASTINT (parent);
3263 f->output_data.x->explicit_parent = 1;
3265 else
3267 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
3268 f->output_data.x->explicit_parent = 0;
3271 /* Set the name; the functions to which we pass f expect the name to
3272 be set. */
3273 if (EQ (name, Qunbound) || NILP (name))
3275 f->name = build_string (dpyinfo->x_id_name);
3276 f->explicit_name = 0;
3278 else
3280 f->name = name;
3281 f->explicit_name = 1;
3282 /* use the frame's title when getting resources for this frame. */
3283 specbind (Qx_resource_name, name);
3286 f->resx = dpyinfo->resx;
3287 f->resy = dpyinfo->resy;
3289 #ifdef HAVE_FREETYPE
3290 #ifdef HAVE_XFT
3291 register_font_driver (&xftfont_driver, f);
3292 #else /* not HAVE_XFT */
3293 register_font_driver (&ftxfont_driver, f);
3294 #endif /* not HAVE_XFT */
3295 #endif /* HAVE_FREETYPE */
3296 register_font_driver (&xfont_driver, f);
3298 x_default_parameter (f, parms, Qfont_backend, Qnil,
3299 "fontBackend", "FontBackend", RES_TYPE_STRING);
3301 /* Extract the window parameters from the supplied values
3302 that are needed to determine window geometry. */
3303 x_default_font_parameter (f, parms);
3304 if (!FRAME_FONT (f))
3306 delete_frame (frame, Qnoelisp);
3307 error ("Invalid frame font");
3310 #ifdef USE_LUCID
3311 /* Prevent lwlib/xlwmenu.c from crashing because of a bug
3312 whereby it fails to get any font. */
3313 xlwmenu_default_font = XLoadQueryFont (FRAME_X_DISPLAY (f), "fixed");
3314 #endif
3316 /* Frame contents get displaced if an embedded X window has a border. */
3317 if (! FRAME_X_EMBEDDED_P (f))
3318 x_default_parameter (f, parms, Qborder_width, make_number (2),
3319 "borderWidth", "BorderWidth", RES_TYPE_NUMBER);
3321 /* This defaults to 1 in order to match xterm. We recognize either
3322 internalBorderWidth or internalBorder (which is what xterm calls
3323 it). */
3324 if (NILP (Fassq (Qinternal_border_width, parms)))
3326 Lisp_Object value;
3328 value = x_get_arg (dpyinfo, parms, Qinternal_border_width,
3329 "internalBorder", "internalBorder", RES_TYPE_NUMBER);
3330 if (! EQ (value, Qunbound))
3331 parms = Fcons (Fcons (Qinternal_border_width, value),
3332 parms);
3334 x_default_parameter (f, parms, Qinternal_border_width,
3335 #ifdef USE_GTK /* We used to impose 0 in xg_create_frame_widgets. */
3336 make_number (0),
3337 #else
3338 make_number (1),
3339 #endif
3340 "internalBorderWidth", "internalBorderWidth",
3341 RES_TYPE_NUMBER);
3342 x_default_parameter (f, parms, Qvertical_scroll_bars, Qleft,
3343 "verticalScrollBars", "ScrollBars",
3344 RES_TYPE_SYMBOL);
3346 /* Also do the stuff which must be set before the window exists. */
3347 x_default_parameter (f, parms, Qforeground_color, build_string ("black"),
3348 "foreground", "Foreground", RES_TYPE_STRING);
3349 x_default_parameter (f, parms, Qbackground_color, build_string ("white"),
3350 "background", "Background", RES_TYPE_STRING);
3351 x_default_parameter (f, parms, Qmouse_color, build_string ("black"),
3352 "pointerColor", "Foreground", RES_TYPE_STRING);
3353 x_default_parameter (f, parms, Qcursor_color, build_string ("black"),
3354 "cursorColor", "Foreground", RES_TYPE_STRING);
3355 x_default_parameter (f, parms, Qborder_color, build_string ("black"),
3356 "borderColor", "BorderColor", RES_TYPE_STRING);
3357 x_default_parameter (f, parms, Qscreen_gamma, Qnil,
3358 "screenGamma", "ScreenGamma", RES_TYPE_FLOAT);
3359 x_default_parameter (f, parms, Qline_spacing, Qnil,
3360 "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
3361 x_default_parameter (f, parms, Qleft_fringe, Qnil,
3362 "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
3363 x_default_parameter (f, parms, Qright_fringe, Qnil,
3364 "rightFringe", "RightFringe", RES_TYPE_NUMBER);
3366 x_default_scroll_bar_color_parameter (f, parms, Qscroll_bar_foreground,
3367 "scrollBarForeground",
3368 "ScrollBarForeground", 1);
3369 x_default_scroll_bar_color_parameter (f, parms, Qscroll_bar_background,
3370 "scrollBarBackground",
3371 "ScrollBarBackground", 0);
3373 /* Init faces before x_default_parameter is called for scroll-bar
3374 parameters because that function calls x_set_scroll_bar_width,
3375 which calls change_frame_size, which calls Fset_window_buffer,
3376 which runs hooks, which call Fvertical_motion. At the end, we
3377 end up in init_iterator with a null face cache, which should not
3378 happen. */
3379 init_frame_faces (f);
3381 x_default_parameter (f, parms, Qmenu_bar_lines, make_number (1),
3382 "menuBar", "MenuBar", RES_TYPE_NUMBER);
3383 x_default_parameter (f, parms, Qtool_bar_lines, make_number (1),
3384 "toolBar", "ToolBar", RES_TYPE_NUMBER);
3385 x_default_parameter (f, parms, Qbuffer_predicate, Qnil,
3386 "bufferPredicate", "BufferPredicate",
3387 RES_TYPE_SYMBOL);
3388 x_default_parameter (f, parms, Qtitle, Qnil,
3389 "title", "Title", RES_TYPE_STRING);
3390 x_default_parameter (f, parms, Qwait_for_wm, Qt,
3391 "waitForWM", "WaitForWM", RES_TYPE_BOOLEAN);
3392 x_default_parameter (f, parms, Qfullscreen, Qnil,
3393 "fullscreen", "Fullscreen", RES_TYPE_SYMBOL);
3395 /* Compute the size of the X window. */
3396 window_prompting = x_figure_window_size (f, parms, 1);
3398 tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
3399 f->no_split = minibuffer_only || EQ (tem, Qt);
3401 x_icon_verify (f, parms);
3403 /* Create the X widget or window. */
3404 #ifdef USE_X_TOOLKIT
3405 x_window (f, window_prompting, minibuffer_only);
3406 #else
3407 x_window (f);
3408 #endif
3410 x_icon (f, parms);
3411 x_make_gc (f);
3413 /* Now consider the frame official. */
3414 FRAME_X_DISPLAY_INFO (f)->reference_count++;
3415 Vframe_list = Fcons (frame, Vframe_list);
3417 /* We need to do this after creating the X window, so that the
3418 icon-creation functions can say whose icon they're describing. */
3419 x_default_parameter (f, parms, Qicon_type, Qt,
3420 "bitmapIcon", "BitmapIcon", RES_TYPE_SYMBOL);
3422 x_default_parameter (f, parms, Qauto_raise, Qnil,
3423 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
3424 x_default_parameter (f, parms, Qauto_lower, Qnil,
3425 "autoLower", "AutoRaiseLower", RES_TYPE_BOOLEAN);
3426 x_default_parameter (f, parms, Qcursor_type, Qbox,
3427 "cursorType", "CursorType", RES_TYPE_SYMBOL);
3428 x_default_parameter (f, parms, Qscroll_bar_width, Qnil,
3429 "scrollBarWidth", "ScrollBarWidth",
3430 RES_TYPE_NUMBER);
3431 x_default_parameter (f, parms, Qalpha, Qnil,
3432 "alpha", "Alpha", RES_TYPE_NUMBER);
3434 /* Dimensions, especially FRAME_LINES (f), must be done via change_frame_size.
3435 Change will not be effected unless different from the current
3436 FRAME_LINES (f). */
3437 width = FRAME_COLS (f);
3438 height = FRAME_LINES (f);
3440 SET_FRAME_COLS (f, 0);
3441 FRAME_LINES (f) = 0;
3442 change_frame_size (f, height, width, 1, 0, 0);
3444 #if defined (USE_X_TOOLKIT) || defined (USE_GTK)
3445 /* Create the menu bar. */
3446 if (!minibuffer_only && FRAME_EXTERNAL_MENU_BAR (f))
3448 /* If this signals an error, we haven't set size hints for the
3449 frame and we didn't make it visible. */
3450 initialize_frame_menubar (f);
3452 #ifndef USE_GTK
3453 /* This is a no-op, except under Motif where it arranges the
3454 main window for the widgets on it. */
3455 lw_set_main_areas (f->output_data.x->column_widget,
3456 f->output_data.x->menubar_widget,
3457 f->output_data.x->edit_widget);
3458 #endif /* not USE_GTK */
3460 #endif /* USE_X_TOOLKIT || USE_GTK */
3462 /* Tell the server what size and position, etc, we want, and how
3463 badly we want them. This should be done after we have the menu
3464 bar so that its size can be taken into account. */
3465 BLOCK_INPUT;
3466 x_wm_set_size_hint (f, window_prompting, 0);
3467 UNBLOCK_INPUT;
3469 /* Make the window appear on the frame and enable display, unless
3470 the caller says not to. However, with explicit parent, Emacs
3471 cannot control visibility, so don't try. */
3472 if (! f->output_data.x->explicit_parent)
3474 Lisp_Object visibility;
3476 visibility = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0,
3477 RES_TYPE_SYMBOL);
3478 if (EQ (visibility, Qunbound))
3479 visibility = Qt;
3481 if (EQ (visibility, Qicon))
3482 x_iconify_frame (f);
3483 else if (! NILP (visibility))
3484 x_make_frame_visible (f);
3485 else
3486 /* Must have been Qnil. */
3490 /* Set the WM leader property. GTK does this itself, so this is not
3491 needed when using GTK. */
3492 if (dpyinfo->client_leader_window != 0)
3494 BLOCK_INPUT;
3495 XChangeProperty (FRAME_X_DISPLAY (f),
3496 FRAME_OUTER_WINDOW (f),
3497 dpyinfo->Xatom_wm_client_leader,
3498 XA_WINDOW, 32, PropModeReplace,
3499 (unsigned char *) &dpyinfo->client_leader_window, 1);
3500 UNBLOCK_INPUT;
3503 /* Initialize `default-minibuffer-frame' in case this is the first
3504 frame on this terminal. */
3505 if (FRAME_HAS_MINIBUF_P (f)
3506 && (!FRAMEP (kb->Vdefault_minibuffer_frame)
3507 || !FRAME_LIVE_P (XFRAME (kb->Vdefault_minibuffer_frame))))
3508 kb->Vdefault_minibuffer_frame = frame;
3510 /* All remaining specified parameters, which have not been "used"
3511 by x_get_arg and friends, now go in the misc. alist of the frame. */
3512 for (tem = parms; CONSP (tem); tem = XCDR (tem))
3513 if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
3514 f->param_alist = Fcons (XCAR (tem), f->param_alist);
3516 UNGCPRO;
3518 /* Make sure windows on this frame appear in calls to next-window
3519 and similar functions. */
3520 Vwindow_list = Qnil;
3522 return unbind_to (count, frame);
3526 /* FRAME is used only to get a handle on the X display. We don't pass the
3527 display info directly because we're called from frame.c, which doesn't
3528 know about that structure. */
3530 Lisp_Object
3531 x_get_focus_frame (frame)
3532 struct frame *frame;
3534 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (frame);
3535 Lisp_Object xfocus;
3536 if (! dpyinfo->x_focus_frame)
3537 return Qnil;
3539 XSETFRAME (xfocus, dpyinfo->x_focus_frame);
3540 return xfocus;
3544 /* In certain situations, when the window manager follows a
3545 click-to-focus policy, there seems to be no way around calling
3546 XSetInputFocus to give another frame the input focus .
3548 In an ideal world, XSetInputFocus should generally be avoided so
3549 that applications don't interfere with the window manager's focus
3550 policy. But I think it's okay to use when it's clearly done
3551 following a user-command. */
3553 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
3554 doc: /* Set the input focus to FRAME.
3555 FRAME nil means use the selected frame. */)
3556 (frame)
3557 Lisp_Object frame;
3559 struct frame *f = check_x_frame (frame);
3560 Display *dpy = FRAME_X_DISPLAY (f);
3562 BLOCK_INPUT;
3563 x_catch_errors (dpy);
3564 XSetInputFocus (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
3565 RevertToParent, CurrentTime);
3566 x_ewmh_activate_frame (f);
3567 x_uncatch_errors ();
3568 UNBLOCK_INPUT;
3570 return Qnil;
3574 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
3575 doc: /* Internal function called by `color-defined-p', which see. */)
3576 (color, frame)
3577 Lisp_Object color, frame;
3579 XColor foo;
3580 FRAME_PTR f = check_x_frame (frame);
3582 CHECK_STRING (color);
3584 if (x_defined_color (f, SDATA (color), &foo, 0))
3585 return Qt;
3586 else
3587 return Qnil;
3590 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
3591 doc: /* Internal function called by `color-values', which see. */)
3592 (color, frame)
3593 Lisp_Object color, frame;
3595 XColor foo;
3596 FRAME_PTR f = check_x_frame (frame);
3598 CHECK_STRING (color);
3600 if (x_defined_color (f, SDATA (color), &foo, 0))
3601 return list3 (make_number (foo.red),
3602 make_number (foo.green),
3603 make_number (foo.blue));
3604 else
3605 return Qnil;
3608 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
3609 doc: /* Internal function called by `display-color-p', which see. */)
3610 (terminal)
3611 Lisp_Object terminal;
3613 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3615 if (dpyinfo->n_planes <= 2)
3616 return Qnil;
3618 switch (dpyinfo->visual->class)
3620 case StaticColor:
3621 case PseudoColor:
3622 case TrueColor:
3623 case DirectColor:
3624 return Qt;
3626 default:
3627 return Qnil;
3631 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p, Sx_display_grayscale_p,
3632 0, 1, 0,
3633 doc: /* Return t if the X display supports shades of gray.
3634 Note that color displays do support shades of gray.
3635 The optional argument TERMINAL specifies which display to ask about.
3636 TERMINAL should be a terminal object, a frame or a display name (a string).
3637 If omitted or nil, that stands for the selected frame's display. */)
3638 (terminal)
3639 Lisp_Object terminal;
3641 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3643 if (dpyinfo->n_planes <= 1)
3644 return Qnil;
3646 switch (dpyinfo->visual->class)
3648 case StaticColor:
3649 case PseudoColor:
3650 case TrueColor:
3651 case DirectColor:
3652 case StaticGray:
3653 case GrayScale:
3654 return Qt;
3656 default:
3657 return Qnil;
3661 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
3662 0, 1, 0,
3663 doc: /* Return the width in pixels of the X display TERMINAL.
3664 The optional argument TERMINAL specifies which display to ask about.
3665 TERMINAL should be a terminal object, a frame or a display name (a string).
3666 If omitted or nil, that stands for the selected frame's display. */)
3667 (terminal)
3668 Lisp_Object terminal;
3670 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3672 return make_number (x_display_pixel_width (dpyinfo));
3675 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
3676 Sx_display_pixel_height, 0, 1, 0,
3677 doc: /* Return the height in pixels of the X display TERMINAL.
3678 The optional argument TERMINAL specifies which display to ask about.
3679 TERMINAL should be a terminal object, a frame or a display name (a string).
3680 If omitted or nil, that stands for the selected frame's display. */)
3681 (terminal)
3682 Lisp_Object terminal;
3684 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3686 return make_number (x_display_pixel_height (dpyinfo));
3689 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
3690 0, 1, 0,
3691 doc: /* Return the number of bitplanes of the X display TERMINAL.
3692 The optional argument TERMINAL specifies which display to ask about.
3693 TERMINAL should be a terminal object, a frame or a display name (a string).
3694 If omitted or nil, that stands for the selected frame's display. */)
3695 (terminal)
3696 Lisp_Object terminal;
3698 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3700 return make_number (dpyinfo->n_planes);
3703 DEFUN ("x-display-color-cells", Fx_display_color_cells, Sx_display_color_cells,
3704 0, 1, 0,
3705 doc: /* Return the number of color cells of the X display TERMINAL.
3706 The optional argument TERMINAL specifies which display to ask about.
3707 TERMINAL should be a terminal object, a frame or a display name (a string).
3708 If omitted or nil, that stands for the selected frame's display. */)
3709 (terminal)
3710 Lisp_Object terminal;
3712 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3714 int nr_planes = DisplayPlanes (dpyinfo->display,
3715 XScreenNumberOfScreen (dpyinfo->screen));
3717 /* Truncate nr_planes to 24 to avoid integer overflow.
3718 Some displays says 32, but only 24 bits are actually significant.
3719 There are only very few and rare video cards that have more than
3720 24 significant bits. Also 24 bits is more than 16 million colors,
3721 it "should be enough for everyone". */
3722 if (nr_planes > 24) nr_planes = 24;
3724 return make_number (1 << nr_planes);
3727 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
3728 Sx_server_max_request_size,
3729 0, 1, 0,
3730 doc: /* Return the maximum request size of the X server of display TERMINAL.
3731 The optional argument TERMINAL specifies which display to ask about.
3732 TERMINAL should be a terminal object, a frame or a display name (a string).
3733 If omitted or nil, that stands for the selected frame's display. */)
3734 (terminal)
3735 Lisp_Object terminal;
3737 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3739 return make_number (MAXREQUEST (dpyinfo->display));
3742 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
3743 doc: /* Return the "vendor ID" string of the X server of display TERMINAL.
3744 \(Labelling every distributor as a "vendor" embodies the false assumption
3745 that operating systems cannot be developed and distributed noncommercially.)
3746 The optional argument TERMINAL specifies which display to ask about.
3747 TERMINAL should be a terminal object, a frame or a display name (a string).
3748 If omitted or nil, that stands for the selected frame's display. */)
3749 (terminal)
3750 Lisp_Object terminal;
3752 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3753 char *vendor = ServerVendor (dpyinfo->display);
3755 if (! vendor) vendor = "";
3756 return build_string (vendor);
3759 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
3760 doc: /* Return the version numbers of the X server of display TERMINAL.
3761 The value is a list of three integers: the major and minor
3762 version numbers of the X Protocol in use, and the distributor-specific release
3763 number. See also the function `x-server-vendor'.
3765 The optional argument TERMINAL specifies which display to ask about.
3766 TERMINAL should be a terminal object, a frame or a display name (a string).
3767 If omitted or nil, that stands for the selected frame's display. */)
3768 (terminal)
3769 Lisp_Object terminal;
3771 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3772 Display *dpy = dpyinfo->display;
3774 return Fcons (make_number (ProtocolVersion (dpy)),
3775 Fcons (make_number (ProtocolRevision (dpy)),
3776 Fcons (make_number (VendorRelease (dpy)), Qnil)));
3779 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
3780 doc: /* Return the number of screens on the X server of display TERMINAL.
3781 The optional argument TERMINAL specifies which display to ask about.
3782 TERMINAL should be a terminal object, a frame or a display name (a string).
3783 If omitted or nil, that stands for the selected frame's display. */)
3784 (terminal)
3785 Lisp_Object terminal;
3787 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3789 return make_number (ScreenCount (dpyinfo->display));
3792 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height, 0, 1, 0,
3793 doc: /* Return the height in millimeters of the X display TERMINAL.
3794 The optional argument TERMINAL specifies which display to ask about.
3795 TERMINAL should be a terminal object, a frame or a display name (a string).
3796 If omitted or nil, that stands for the selected frame's display. */)
3797 (terminal)
3798 Lisp_Object terminal;
3800 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3802 return make_number (HeightMMOfScreen (dpyinfo->screen));
3805 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width, 0, 1, 0,
3806 doc: /* Return the width in millimeters of the X display TERMINAL.
3807 The optional argument TERMINAL specifies which display to ask about.
3808 TERMINAL should be a terminal object, a frame or a display name (a string).
3809 If omitted or nil, that stands for the selected frame's display. */)
3810 (terminal)
3811 Lisp_Object terminal;
3813 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3815 return make_number (WidthMMOfScreen (dpyinfo->screen));
3818 DEFUN ("x-display-backing-store", Fx_display_backing_store,
3819 Sx_display_backing_store, 0, 1, 0,
3820 doc: /* Return an indication of whether X display TERMINAL does backing store.
3821 The value may be `always', `when-mapped', or `not-useful'.
3822 The optional argument TERMINAL specifies which display to ask about.
3823 TERMINAL should be a terminal object, a frame or a display name (a string).
3824 If omitted or nil, that stands for the selected frame's display. */)
3825 (terminal)
3826 Lisp_Object terminal;
3828 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3829 Lisp_Object result;
3831 switch (DoesBackingStore (dpyinfo->screen))
3833 case Always:
3834 result = intern ("always");
3835 break;
3837 case WhenMapped:
3838 result = intern ("when-mapped");
3839 break;
3841 case NotUseful:
3842 result = intern ("not-useful");
3843 break;
3845 default:
3846 error ("Strange value for BackingStore parameter of screen");
3847 result = Qnil;
3850 return result;
3853 DEFUN ("x-display-visual-class", Fx_display_visual_class,
3854 Sx_display_visual_class, 0, 1, 0,
3855 doc: /* Return the visual class of the X display TERMINAL.
3856 The value is one of the symbols `static-gray', `gray-scale',
3857 `static-color', `pseudo-color', `true-color', or `direct-color'.
3859 The optional argument TERMINAL specifies which display to ask about.
3860 TERMINAL should a terminal object, a frame or a display name (a string).
3861 If omitted or nil, that stands for the selected frame's display. */)
3862 (terminal)
3863 Lisp_Object terminal;
3865 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3866 Lisp_Object result;
3868 switch (dpyinfo->visual->class)
3870 case StaticGray:
3871 result = intern ("static-gray");
3872 break;
3873 case GrayScale:
3874 result = intern ("gray-scale");
3875 break;
3876 case StaticColor:
3877 result = intern ("static-color");
3878 break;
3879 case PseudoColor:
3880 result = intern ("pseudo-color");
3881 break;
3882 case TrueColor:
3883 result = intern ("true-color");
3884 break;
3885 case DirectColor:
3886 result = intern ("direct-color");
3887 break;
3888 default:
3889 error ("Display has an unknown visual class");
3890 result = Qnil;
3893 return result;
3896 DEFUN ("x-display-save-under", Fx_display_save_under,
3897 Sx_display_save_under, 0, 1, 0,
3898 doc: /* Return t if the X display TERMINAL supports the save-under feature.
3899 The optional argument TERMINAL specifies which display to ask about.
3900 TERMINAL should be a terminal object, a frame or a display name (a string).
3901 If omitted or nil, that stands for the selected frame's display. */)
3902 (terminal)
3903 Lisp_Object terminal;
3905 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3907 if (DoesSaveUnders (dpyinfo->screen) == True)
3908 return Qt;
3909 else
3910 return Qnil;
3914 x_pixel_width (f)
3915 register struct frame *f;
3917 return FRAME_PIXEL_WIDTH (f);
3921 x_pixel_height (f)
3922 register struct frame *f;
3924 return FRAME_PIXEL_HEIGHT (f);
3928 x_char_width (f)
3929 register struct frame *f;
3931 return FRAME_COLUMN_WIDTH (f);
3935 x_char_height (f)
3936 register struct frame *f;
3938 return FRAME_LINE_HEIGHT (f);
3942 x_screen_planes (f)
3943 register struct frame *f;
3945 return FRAME_X_DISPLAY_INFO (f)->n_planes;
3950 /************************************************************************
3951 X Displays
3952 ************************************************************************/
3955 /* Mapping visual names to visuals. */
3957 static struct visual_class
3959 char *name;
3960 int class;
3962 visual_classes[] =
3964 {"StaticGray", StaticGray},
3965 {"GrayScale", GrayScale},
3966 {"StaticColor", StaticColor},
3967 {"PseudoColor", PseudoColor},
3968 {"TrueColor", TrueColor},
3969 {"DirectColor", DirectColor},
3970 {NULL, 0}
3974 #ifndef HAVE_XSCREENNUMBEROFSCREEN
3976 /* Value is the screen number of screen SCR. This is a substitute for
3977 the X function with the same name when that doesn't exist. */
3980 XScreenNumberOfScreen (scr)
3981 register Screen *scr;
3983 Display *dpy = scr->display;
3984 int i;
3986 for (i = 0; i < dpy->nscreens; ++i)
3987 if (scr == dpy->screens + i)
3988 break;
3990 return i;
3993 #endif /* not HAVE_XSCREENNUMBEROFSCREEN */
3996 /* Select the visual that should be used on display DPYINFO. Set
3997 members of DPYINFO appropriately. Called from x_term_init. */
3999 void
4000 select_visual (dpyinfo)
4001 struct x_display_info *dpyinfo;
4003 Display *dpy = dpyinfo->display;
4004 Screen *screen = dpyinfo->screen;
4005 Lisp_Object value;
4007 /* See if a visual is specified. */
4008 value = display_x_get_resource (dpyinfo,
4009 build_string ("visualClass"),
4010 build_string ("VisualClass"),
4011 Qnil, Qnil);
4012 if (STRINGP (value))
4014 /* VALUE should be of the form CLASS-DEPTH, where CLASS is one
4015 of `PseudoColor', `TrueColor' etc. and DEPTH is the color
4016 depth, a decimal number. NAME is compared with case ignored. */
4017 char *s = (char *) alloca (SBYTES (value) + 1);
4018 char *dash;
4019 int i, class = -1;
4020 XVisualInfo vinfo;
4022 strcpy (s, SDATA (value));
4023 dash = index (s, '-');
4024 if (dash)
4026 dpyinfo->n_planes = atoi (dash + 1);
4027 *dash = '\0';
4029 else
4030 /* We won't find a matching visual with depth 0, so that
4031 an error will be printed below. */
4032 dpyinfo->n_planes = 0;
4034 /* Determine the visual class. */
4035 for (i = 0; visual_classes[i].name; ++i)
4036 if (xstrcasecmp (s, visual_classes[i].name) == 0)
4038 class = visual_classes[i].class;
4039 break;
4042 /* Look up a matching visual for the specified class. */
4043 if (class == -1
4044 || !XMatchVisualInfo (dpy, XScreenNumberOfScreen (screen),
4045 dpyinfo->n_planes, class, &vinfo))
4046 fatal ("Invalid visual specification `%s'", SDATA (value));
4048 dpyinfo->visual = vinfo.visual;
4050 else
4052 int n_visuals;
4053 XVisualInfo *vinfo, vinfo_template;
4055 dpyinfo->visual = DefaultVisualOfScreen (screen);
4057 vinfo_template.visualid = XVisualIDFromVisual (dpyinfo->visual);
4058 vinfo_template.screen = XScreenNumberOfScreen (screen);
4059 vinfo = XGetVisualInfo (dpy, VisualIDMask | VisualScreenMask,
4060 &vinfo_template, &n_visuals);
4061 if (n_visuals != 1)
4062 fatal ("Can't get proper X visual info");
4064 dpyinfo->n_planes = vinfo->depth;
4065 XFree ((char *) vinfo);
4070 /* Return the X display structure for the display named NAME.
4071 Open a new connection if necessary. */
4073 struct x_display_info *
4074 x_display_info_for_name (name)
4075 Lisp_Object name;
4077 Lisp_Object names;
4078 struct x_display_info *dpyinfo;
4080 CHECK_STRING (name);
4082 #if 0
4083 if (! EQ (Vinitial_window_system, intern ("x")))
4084 error ("Not using X Windows"); /* That doesn't stop us anymore. */
4085 #endif
4087 for (dpyinfo = x_display_list, names = x_display_name_list;
4088 dpyinfo;
4089 dpyinfo = dpyinfo->next, names = XCDR (names))
4091 Lisp_Object tem;
4092 tem = Fstring_equal (XCAR (XCAR (names)), name);
4093 if (!NILP (tem))
4094 return dpyinfo;
4097 /* Use this general default value to start with. */
4098 Vx_resource_name = Vinvocation_name;
4100 validate_x_resource_name ();
4102 dpyinfo = x_term_init (name, (char *)0,
4103 (char *) SDATA (Vx_resource_name));
4105 if (dpyinfo == 0)
4106 error ("Cannot connect to X server %s", SDATA (name));
4108 x_in_use = 1;
4109 XSETFASTINT (Vwindow_system_version, 11);
4111 return dpyinfo;
4115 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
4116 1, 3, 0,
4117 doc: /* Open a connection to an X server.
4118 DISPLAY is the name of the display to connect to.
4119 Optional second arg XRM-STRING is a string of resources in xrdb format.
4120 If the optional third arg MUST-SUCCEED is non-nil,
4121 terminate Emacs if we can't open the connection. */)
4122 (display, xrm_string, must_succeed)
4123 Lisp_Object display, xrm_string, must_succeed;
4125 unsigned char *xrm_option;
4126 struct x_display_info *dpyinfo;
4128 CHECK_STRING (display);
4129 if (! NILP (xrm_string))
4130 CHECK_STRING (xrm_string);
4132 #if 0
4133 if (! EQ (Vinitial_window_system, intern ("x")))
4134 error ("Not using X Windows"); /* That doesn't stop us anymore. */
4135 #endif
4137 if (! NILP (xrm_string))
4138 xrm_option = (unsigned char *) SDATA (xrm_string);
4139 else
4140 xrm_option = (unsigned char *) 0;
4142 validate_x_resource_name ();
4144 /* This is what opens the connection and sets x_current_display.
4145 This also initializes many symbols, such as those used for input. */
4146 dpyinfo = x_term_init (display, xrm_option,
4147 (char *) SDATA (Vx_resource_name));
4149 if (dpyinfo == 0)
4151 if (!NILP (must_succeed))
4152 fatal ("Cannot connect to X server %s.\n\
4153 Check the DISPLAY environment variable or use `-d'.\n\
4154 Also use the `xauth' program to verify that you have the proper\n\
4155 authorization information needed to connect the X server.\n\
4156 An insecure way to solve the problem may be to use `xhost'.\n",
4157 SDATA (display));
4158 else
4159 error ("Cannot connect to X server %s", SDATA (display));
4162 x_in_use = 1;
4164 XSETFASTINT (Vwindow_system_version, 11);
4165 return Qnil;
4168 DEFUN ("x-close-connection", Fx_close_connection,
4169 Sx_close_connection, 1, 1, 0,
4170 doc: /* Close the connection to TERMINAL's X server.
4171 For TERMINAL, specify a terminal object, a frame or a display name (a
4172 string). If TERMINAL is nil, that stands for the selected frame's
4173 terminal. */)
4174 (terminal)
4175 Lisp_Object terminal;
4177 struct x_display_info *dpyinfo = check_x_display_info (terminal);
4179 if (dpyinfo->reference_count > 0)
4180 error ("Display still has frames on it");
4182 x_delete_terminal (dpyinfo->terminal);
4184 return Qnil;
4187 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
4188 doc: /* Return the list of display names that Emacs has connections to. */)
4191 Lisp_Object tail, result;
4193 result = Qnil;
4194 for (tail = x_display_name_list; CONSP (tail); tail = XCDR (tail))
4195 result = Fcons (XCAR (XCAR (tail)), result);
4197 return result;
4200 DEFUN ("x-synchronize", Fx_synchronize, Sx_synchronize, 1, 2, 0,
4201 doc: /* If ON is non-nil, report X errors as soon as the erring request is made.
4202 If ON is nil, allow buffering of requests.
4203 Turning on synchronization prohibits the Xlib routines from buffering
4204 requests and seriously degrades performance, but makes debugging much
4205 easier.
4206 The optional second argument TERMINAL specifies which display to act on.
4207 TERMINAL should be a terminal object, a frame or a display name (a string).
4208 If TERMINAL is omitted or nil, that stands for the selected frame's display. */)
4209 (on, terminal)
4210 Lisp_Object terminal, on;
4212 struct x_display_info *dpyinfo = check_x_display_info (terminal);
4214 XSynchronize (dpyinfo->display, !EQ (on, Qnil));
4216 return Qnil;
4219 /* Wait for responses to all X commands issued so far for frame F. */
4221 void
4222 x_sync (f)
4223 FRAME_PTR f;
4225 BLOCK_INPUT;
4226 XSync (FRAME_X_DISPLAY (f), False);
4227 UNBLOCK_INPUT;
4231 /***********************************************************************
4232 Window properties
4233 ***********************************************************************/
4235 DEFUN ("x-change-window-property", Fx_change_window_property,
4236 Sx_change_window_property, 2, 6, 0,
4237 doc: /* Change window property PROP to VALUE on the X window of FRAME.
4238 PROP must be a string.
4239 VALUE may be a string or a list of conses, numbers and/or strings.
4240 If an element in the list is a string, it is converted to
4241 an Atom and the value of the Atom is used. If an element is a cons,
4242 it is converted to a 32 bit number where the car is the 16 top bits and the
4243 cdr is the lower 16 bits.
4244 FRAME nil or omitted means use the selected frame.
4245 If TYPE is given and non-nil, it is the name of the type of VALUE.
4246 If TYPE is not given or nil, the type is STRING.
4247 FORMAT gives the size in bits of each element if VALUE is a list.
4248 It must be one of 8, 16 or 32.
4249 If VALUE is a string or FORMAT is nil or not given, FORMAT defaults to 8.
4250 If OUTER_P is non-nil, the property is changed for the outer X window of
4251 FRAME. Default is to change on the edit X window.
4253 Value is VALUE. */)
4254 (prop, value, frame, type, format, outer_p)
4255 Lisp_Object prop, value, frame, type, format, outer_p;
4257 struct frame *f = check_x_frame (frame);
4258 Atom prop_atom;
4259 Atom target_type = XA_STRING;
4260 int element_format = 8;
4261 unsigned char *data;
4262 int nelements;
4263 Window w;
4265 CHECK_STRING (prop);
4267 if (! NILP (format))
4269 CHECK_NUMBER (format);
4270 element_format = XFASTINT (format);
4272 if (element_format != 8 && element_format != 16
4273 && element_format != 32)
4274 error ("FORMAT must be one of 8, 16 or 32");
4277 if (CONSP (value))
4279 nelements = x_check_property_data (value);
4280 if (nelements == -1)
4281 error ("Bad data in VALUE, must be number, string or cons");
4283 if (element_format == 8)
4284 data = (unsigned char *) xmalloc (nelements);
4285 else if (element_format == 16)
4286 data = (unsigned char *) xmalloc (nelements*2);
4287 else /* format == 32 */
4288 /* The man page for XChangeProperty:
4289 "If the specified format is 32, the property data must be a
4290 long array."
4291 This applies even if long is more than 64 bits. The X library
4292 converts to 32 bits before sending to the X server. */
4293 data = (unsigned char *) xmalloc (nelements * sizeof(long));
4295 x_fill_property_data (FRAME_X_DISPLAY (f), value, data, element_format);
4297 else
4299 CHECK_STRING (value);
4300 data = SDATA (value);
4301 nelements = SCHARS (value);
4304 BLOCK_INPUT;
4305 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SDATA (prop), False);
4306 if (! NILP (type))
4308 CHECK_STRING (type);
4309 target_type = XInternAtom (FRAME_X_DISPLAY (f), SDATA (type), False);
4312 if (! NILP (outer_p)) w = FRAME_OUTER_WINDOW (f);
4313 else w = FRAME_X_WINDOW (f);
4315 XChangeProperty (FRAME_X_DISPLAY (f), w,
4316 prop_atom, target_type, element_format, PropModeReplace,
4317 data, nelements);
4319 if (CONSP (value)) xfree (data);
4321 /* Make sure the property is set when we return. */
4322 XFlush (FRAME_X_DISPLAY (f));
4323 UNBLOCK_INPUT;
4325 return value;
4329 DEFUN ("x-delete-window-property", Fx_delete_window_property,
4330 Sx_delete_window_property, 1, 2, 0,
4331 doc: /* Remove window property PROP from X window of FRAME.
4332 FRAME nil or omitted means use the selected frame. Value is PROP. */)
4333 (prop, frame)
4334 Lisp_Object prop, frame;
4336 struct frame *f = check_x_frame (frame);
4337 Atom prop_atom;
4339 CHECK_STRING (prop);
4340 BLOCK_INPUT;
4341 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SDATA (prop), False);
4342 XDeleteProperty (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), prop_atom);
4344 /* Make sure the property is removed when we return. */
4345 XFlush (FRAME_X_DISPLAY (f));
4346 UNBLOCK_INPUT;
4348 return prop;
4352 DEFUN ("x-window-property", Fx_window_property, Sx_window_property,
4353 1, 6, 0,
4354 doc: /* Value is the value of window property PROP on FRAME.
4355 If FRAME is nil or omitted, use the selected frame.
4356 If TYPE is nil or omitted, get the property as a string. Otherwise TYPE
4357 is the name of the Atom that denotes the type expected.
4358 If SOURCE is non-nil, get the property on that window instead of from
4359 FRAME. The number 0 denotes the root window.
4360 If DELETE_P is non-nil, delete the property after retreiving it.
4361 If VECTOR_RET_P is non-nil, don't return a string but a vector of values.
4363 Value is nil if FRAME hasn't a property with name PROP or if PROP has
4364 no value of TYPE. */)
4365 (prop, frame, type, source, delete_p, vector_ret_p)
4366 Lisp_Object prop, frame, type, source, delete_p, vector_ret_p;
4368 struct frame *f = check_x_frame (frame);
4369 Atom prop_atom;
4370 int rc;
4371 Lisp_Object prop_value = Qnil;
4372 unsigned char *tmp_data = NULL;
4373 Atom actual_type;
4374 Atom target_type = XA_STRING;
4375 int actual_format;
4376 unsigned long actual_size, bytes_remaining;
4377 Window target_window = FRAME_X_WINDOW (f);
4378 struct gcpro gcpro1;
4380 GCPRO1 (prop_value);
4381 CHECK_STRING (prop);
4383 if (! NILP (source))
4385 if (NUMBERP (source))
4387 if (FLOATP (source))
4388 target_window = (Window) XFLOAT (source);
4389 else
4390 target_window = XFASTINT (source);
4392 if (target_window == 0)
4393 target_window = FRAME_X_DISPLAY_INFO (f)->root_window;
4395 else if (CONSP (source))
4396 target_window = cons_to_long (source);
4399 BLOCK_INPUT;
4400 if (STRINGP (type))
4402 if (strcmp ("AnyPropertyType", SDATA (type)) == 0)
4403 target_type = AnyPropertyType;
4404 else
4405 target_type = XInternAtom (FRAME_X_DISPLAY (f), SDATA (type), False);
4408 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SDATA (prop), False);
4409 rc = XGetWindowProperty (FRAME_X_DISPLAY (f), target_window,
4410 prop_atom, 0, 0, False, target_type,
4411 &actual_type, &actual_format, &actual_size,
4412 &bytes_remaining, &tmp_data);
4413 if (rc == Success)
4415 int size = bytes_remaining;
4417 XFree (tmp_data);
4418 tmp_data = NULL;
4420 rc = XGetWindowProperty (FRAME_X_DISPLAY (f), target_window,
4421 prop_atom, 0, bytes_remaining,
4422 ! NILP (delete_p), target_type,
4423 &actual_type, &actual_format,
4424 &actual_size, &bytes_remaining,
4425 &tmp_data);
4426 if (rc == Success && tmp_data)
4428 /* The man page for XGetWindowProperty says:
4429 "If the returned format is 32, the returned data is represented
4430 as a long array and should be cast to that type to obtain the
4431 elements."
4432 This applies even if long is more than 32 bits, the X library
4433 converts from 32 bit elements received from the X server to long
4434 and passes the long array to us. Thus, for that case bcopy can not
4435 be used. We convert to a 32 bit type here, because so much code
4436 assume on that.
4438 The bytes and offsets passed to XGetWindowProperty refers to the
4439 property and those are indeed in 32 bit quantities if format is
4440 32. */
4442 if (actual_format == 32 && actual_format < BITS_PER_LONG)
4444 unsigned long i;
4445 int *idata = (int *) tmp_data;
4446 long *ldata = (long *) tmp_data;
4448 for (i = 0; i < actual_size; ++i)
4449 idata[i] = (int) ldata[i];
4452 if (NILP (vector_ret_p))
4453 prop_value = make_string (tmp_data, size);
4454 else
4455 prop_value = x_property_data_to_lisp (f,
4456 tmp_data,
4457 actual_type,
4458 actual_format,
4459 actual_size);
4462 if (tmp_data) XFree (tmp_data);
4465 UNBLOCK_INPUT;
4466 UNGCPRO;
4467 return prop_value;
4472 /***********************************************************************
4473 Busy cursor
4474 ***********************************************************************/
4476 /* Timer function of hourglass_atimer. TIMER is equal to
4477 hourglass_atimer.
4479 Display an hourglass pointer on all frames by mapping the frames'
4480 hourglass_window. Set the hourglass_p flag in the frames'
4481 output_data.x structure to indicate that an hourglass cursor is
4482 shown on the frames. */
4484 void
4485 show_hourglass (timer)
4486 struct atimer *timer;
4488 /* The timer implementation will cancel this timer automatically
4489 after this function has run. Set hourglass_atimer to null
4490 so that we know the timer doesn't have to be canceled. */
4491 hourglass_atimer = NULL;
4493 if (!hourglass_shown_p)
4495 Lisp_Object rest, frame;
4497 BLOCK_INPUT;
4499 FOR_EACH_FRAME (rest, frame)
4501 struct frame *f = XFRAME (frame);
4503 if (FRAME_LIVE_P (f) && FRAME_X_P (f) && FRAME_X_DISPLAY (f))
4505 Display *dpy = FRAME_X_DISPLAY (f);
4507 #ifdef USE_X_TOOLKIT
4508 if (f->output_data.x->widget)
4509 #else
4510 if (FRAME_OUTER_WINDOW (f))
4511 #endif
4513 f->output_data.x->hourglass_p = 1;
4515 if (!f->output_data.x->hourglass_window)
4517 unsigned long mask = CWCursor;
4518 XSetWindowAttributes attrs;
4519 #ifdef USE_GTK
4520 Window parent = FRAME_X_WINDOW (f);
4521 #else
4522 Window parent = FRAME_OUTER_WINDOW (f);
4523 #endif
4524 attrs.cursor = f->output_data.x->hourglass_cursor;
4526 f->output_data.x->hourglass_window
4527 = XCreateWindow (dpy, parent,
4528 0, 0, 32000, 32000, 0, 0,
4529 InputOnly,
4530 CopyFromParent,
4531 mask, &attrs);
4534 XMapRaised (dpy, f->output_data.x->hourglass_window);
4535 XFlush (dpy);
4540 hourglass_shown_p = 1;
4541 UNBLOCK_INPUT;
4546 /* Hide the hourglass pointer on all frames, if it is currently
4547 shown. */
4549 void
4550 hide_hourglass ()
4552 if (hourglass_shown_p)
4554 Lisp_Object rest, frame;
4556 BLOCK_INPUT;
4557 FOR_EACH_FRAME (rest, frame)
4559 struct frame *f = XFRAME (frame);
4561 if (FRAME_X_P (f)
4562 /* Watch out for newly created frames. */
4563 && f->output_data.x->hourglass_window)
4565 XUnmapWindow (FRAME_X_DISPLAY (f),
4566 f->output_data.x->hourglass_window);
4567 /* Sync here because XTread_socket looks at the
4568 hourglass_p flag that is reset to zero below. */
4569 XSync (FRAME_X_DISPLAY (f), False);
4570 f->output_data.x->hourglass_p = 0;
4574 hourglass_shown_p = 0;
4575 UNBLOCK_INPUT;
4581 /***********************************************************************
4582 Tool tips
4583 ***********************************************************************/
4585 static Lisp_Object x_create_tip_frame P_ ((struct x_display_info *,
4586 Lisp_Object, Lisp_Object));
4587 static void compute_tip_xy P_ ((struct frame *, Lisp_Object, Lisp_Object,
4588 Lisp_Object, int, int, int *, int *));
4590 /* The frame of a currently visible tooltip. */
4592 Lisp_Object tip_frame;
4594 /* If non-nil, a timer started that hides the last tooltip when it
4595 fires. */
4597 Lisp_Object tip_timer;
4598 Window tip_window;
4600 /* If non-nil, a vector of 3 elements containing the last args
4601 with which x-show-tip was called. See there. */
4603 Lisp_Object last_show_tip_args;
4605 /* Maximum size for tooltips; a cons (COLUMNS . ROWS). */
4607 Lisp_Object Vx_max_tooltip_size;
4610 static Lisp_Object
4611 unwind_create_tip_frame (frame)
4612 Lisp_Object frame;
4614 Lisp_Object deleted;
4616 deleted = unwind_create_frame (frame);
4617 if (EQ (deleted, Qt))
4619 tip_window = None;
4620 tip_frame = Qnil;
4623 return deleted;
4627 /* Create a frame for a tooltip on the display described by DPYINFO.
4628 PARMS is a list of frame parameters. TEXT is the string to
4629 display in the tip frame. Value is the frame.
4631 Note that functions called here, esp. x_default_parameter can
4632 signal errors, for instance when a specified color name is
4633 undefined. We have to make sure that we're in a consistent state
4634 when this happens. */
4636 static Lisp_Object
4637 x_create_tip_frame (dpyinfo, parms, text)
4638 struct x_display_info *dpyinfo;
4639 Lisp_Object parms, text;
4641 struct frame *f;
4642 Lisp_Object frame, tem;
4643 Lisp_Object name;
4644 long window_prompting = 0;
4645 int width, height;
4646 int count = SPECPDL_INDEX ();
4647 struct gcpro gcpro1, gcpro2, gcpro3;
4648 int face_change_count_before = face_change_count;
4649 Lisp_Object buffer;
4650 struct buffer *old_buffer;
4652 check_x ();
4654 if (!dpyinfo->terminal->name)
4655 error ("Terminal is not live, can't create new frames on it");
4657 parms = Fcopy_alist (parms);
4659 /* Get the name of the frame to use for resource lookup. */
4660 name = x_get_arg (dpyinfo, parms, Qname, "name", "Name", RES_TYPE_STRING);
4661 if (!STRINGP (name)
4662 && !EQ (name, Qunbound)
4663 && !NILP (name))
4664 error ("Invalid frame name--not a string or nil");
4666 frame = Qnil;
4667 GCPRO3 (parms, name, frame);
4668 f = make_frame (1);
4669 XSETFRAME (frame, f);
4671 buffer = Fget_buffer_create (build_string (" *tip*"));
4672 Fset_window_buffer (FRAME_ROOT_WINDOW (f), buffer, Qnil);
4673 old_buffer = current_buffer;
4674 set_buffer_internal_1 (XBUFFER (buffer));
4675 current_buffer->truncate_lines = Qnil;
4676 specbind (Qinhibit_read_only, Qt);
4677 specbind (Qinhibit_modification_hooks, Qt);
4678 Ferase_buffer ();
4679 Finsert (1, &text);
4680 set_buffer_internal_1 (old_buffer);
4682 FRAME_CAN_HAVE_SCROLL_BARS (f) = 0;
4683 record_unwind_protect (unwind_create_tip_frame, frame);
4685 f->terminal = dpyinfo->terminal;
4686 f->terminal->reference_count++;
4688 /* By setting the output method, we're essentially saying that
4689 the frame is live, as per FRAME_LIVE_P. If we get a signal
4690 from this point on, x_destroy_window might screw up reference
4691 counts etc. */
4692 f->output_method = output_x_window;
4693 f->output_data.x = (struct x_output *) xmalloc (sizeof (struct x_output));
4694 bzero (f->output_data.x, sizeof (struct x_output));
4695 f->output_data.x->icon_bitmap = -1;
4696 FRAME_FONTSET (f) = -1;
4697 f->output_data.x->scroll_bar_foreground_pixel = -1;
4698 f->output_data.x->scroll_bar_background_pixel = -1;
4699 #ifdef USE_TOOLKIT_SCROLL_BARS
4700 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
4701 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
4702 #endif /* USE_TOOLKIT_SCROLL_BARS */
4703 f->icon_name = Qnil;
4704 FRAME_X_DISPLAY_INFO (f) = dpyinfo;
4705 #if GLYPH_DEBUG
4706 image_cache_refcount = FRAME_IMAGE_CACHE (f)->refcount;
4707 dpyinfo_refcount = dpyinfo->reference_count;
4708 #endif /* GLYPH_DEBUG */
4709 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
4710 f->output_data.x->explicit_parent = 0;
4712 /* These colors will be set anyway later, but it's important
4713 to get the color reference counts right, so initialize them! */
4715 Lisp_Object black;
4716 struct gcpro gcpro1;
4718 /* Function x_decode_color can signal an error. Make
4719 sure to initialize color slots so that we won't try
4720 to free colors we haven't allocated. */
4721 FRAME_FOREGROUND_PIXEL (f) = -1;
4722 FRAME_BACKGROUND_PIXEL (f) = -1;
4723 f->output_data.x->cursor_pixel = -1;
4724 f->output_data.x->cursor_foreground_pixel = -1;
4725 f->output_data.x->border_pixel = -1;
4726 f->output_data.x->mouse_pixel = -1;
4728 black = build_string ("black");
4729 GCPRO1 (black);
4730 FRAME_FOREGROUND_PIXEL (f)
4731 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4732 FRAME_BACKGROUND_PIXEL (f)
4733 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4734 f->output_data.x->cursor_pixel
4735 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4736 f->output_data.x->cursor_foreground_pixel
4737 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4738 f->output_data.x->border_pixel
4739 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4740 f->output_data.x->mouse_pixel
4741 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4742 UNGCPRO;
4745 /* Set the name; the functions to which we pass f expect the name to
4746 be set. */
4747 if (EQ (name, Qunbound) || NILP (name))
4749 f->name = build_string (dpyinfo->x_id_name);
4750 f->explicit_name = 0;
4752 else
4754 f->name = name;
4755 f->explicit_name = 1;
4756 /* use the frame's title when getting resources for this frame. */
4757 specbind (Qx_resource_name, name);
4760 f->resx = dpyinfo->resx;
4761 f->resy = dpyinfo->resy;
4763 register_font_driver (&xfont_driver, f);
4764 #ifdef HAVE_FREETYPE
4765 #ifdef HAVE_XFT
4766 register_font_driver (&xftfont_driver, f);
4767 #else /* not HAVE_XFT */
4768 register_font_driver (&ftxfont_driver, f);
4769 #endif /* not HAVE_XFT */
4770 #endif /* HAVE_FREETYPE */
4772 x_default_parameter (f, parms, Qfont_backend, Qnil,
4773 "fontBackend", "FontBackend", RES_TYPE_STRING);
4775 /* Extract the window parameters from the supplied values that are
4776 needed to determine window geometry. */
4777 x_default_font_parameter (f, parms);
4779 x_default_parameter (f, parms, Qborder_width, make_number (2),
4780 "borderWidth", "BorderWidth", RES_TYPE_NUMBER);
4782 /* This defaults to 2 in order to match xterm. We recognize either
4783 internalBorderWidth or internalBorder (which is what xterm calls
4784 it). */
4785 if (NILP (Fassq (Qinternal_border_width, parms)))
4787 Lisp_Object value;
4789 value = x_get_arg (dpyinfo, parms, Qinternal_border_width,
4790 "internalBorder", "internalBorder", RES_TYPE_NUMBER);
4791 if (! EQ (value, Qunbound))
4792 parms = Fcons (Fcons (Qinternal_border_width, value),
4793 parms);
4796 x_default_parameter (f, parms, Qinternal_border_width, make_number (1),
4797 "internalBorderWidth", "internalBorderWidth",
4798 RES_TYPE_NUMBER);
4800 /* Also do the stuff which must be set before the window exists. */
4801 x_default_parameter (f, parms, Qforeground_color, build_string ("black"),
4802 "foreground", "Foreground", RES_TYPE_STRING);
4803 x_default_parameter (f, parms, Qbackground_color, build_string ("white"),
4804 "background", "Background", RES_TYPE_STRING);
4805 x_default_parameter (f, parms, Qmouse_color, build_string ("black"),
4806 "pointerColor", "Foreground", RES_TYPE_STRING);
4807 x_default_parameter (f, parms, Qcursor_color, build_string ("black"),
4808 "cursorColor", "Foreground", RES_TYPE_STRING);
4809 x_default_parameter (f, parms, Qborder_color, build_string ("black"),
4810 "borderColor", "BorderColor", RES_TYPE_STRING);
4812 /* Init faces before x_default_parameter is called for scroll-bar
4813 parameters because that function calls x_set_scroll_bar_width,
4814 which calls change_frame_size, which calls Fset_window_buffer,
4815 which runs hooks, which call Fvertical_motion. At the end, we
4816 end up in init_iterator with a null face cache, which should not
4817 happen. */
4818 init_frame_faces (f);
4820 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
4822 window_prompting = x_figure_window_size (f, parms, 0);
4825 XSetWindowAttributes attrs;
4826 unsigned long mask;
4828 BLOCK_INPUT;
4829 mask = CWBackPixel | CWOverrideRedirect | CWEventMask;
4830 if (DoesSaveUnders (dpyinfo->screen))
4831 mask |= CWSaveUnder;
4833 /* Window managers look at the override-redirect flag to determine
4834 whether or net to give windows a decoration (Xlib spec, chapter
4835 3.2.8). */
4836 attrs.override_redirect = True;
4837 attrs.save_under = True;
4838 attrs.background_pixel = FRAME_BACKGROUND_PIXEL (f);
4839 /* Arrange for getting MapNotify and UnmapNotify events. */
4840 attrs.event_mask = StructureNotifyMask;
4841 tip_window
4842 = FRAME_X_WINDOW (f)
4843 = XCreateWindow (FRAME_X_DISPLAY (f),
4844 FRAME_X_DISPLAY_INFO (f)->root_window,
4845 /* x, y, width, height */
4846 0, 0, 1, 1,
4847 /* Border. */
4848 f->border_width,
4849 CopyFromParent, InputOutput, CopyFromParent,
4850 mask, &attrs);
4851 UNBLOCK_INPUT;
4854 x_make_gc (f);
4856 x_default_parameter (f, parms, Qauto_raise, Qnil,
4857 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
4858 x_default_parameter (f, parms, Qauto_lower, Qnil,
4859 "autoLower", "AutoRaiseLower", RES_TYPE_BOOLEAN);
4860 x_default_parameter (f, parms, Qcursor_type, Qbox,
4861 "cursorType", "CursorType", RES_TYPE_SYMBOL);
4863 /* Dimensions, especially FRAME_LINES (f), must be done via change_frame_size.
4864 Change will not be effected unless different from the current
4865 FRAME_LINES (f). */
4866 width = FRAME_COLS (f);
4867 height = FRAME_LINES (f);
4868 SET_FRAME_COLS (f, 0);
4869 FRAME_LINES (f) = 0;
4870 change_frame_size (f, height, width, 1, 0, 0);
4872 /* Add `tooltip' frame parameter's default value. */
4873 if (NILP (Fframe_parameter (frame, intern ("tooltip"))))
4874 Fmodify_frame_parameters (frame, Fcons (Fcons (intern ("tooltip"), Qt),
4875 Qnil));
4877 /* FIXME - can this be done in a similar way to normal frames?
4878 http://lists.gnu.org/archive/html/emacs-devel/2007-10/msg00641.html */
4880 /* Set the `display-type' frame parameter before setting up faces. */
4882 Lisp_Object disptype;
4884 if (FRAME_X_DISPLAY_INFO (f)->n_planes == 1)
4885 disptype = intern ("mono");
4886 else if (FRAME_X_DISPLAY_INFO (f)->visual->class == GrayScale
4887 || FRAME_X_DISPLAY_INFO (f)->visual->class == StaticGray)
4888 disptype = intern ("grayscale");
4889 else
4890 disptype = intern ("color");
4892 if (NILP (Fframe_parameter (frame, Qdisplay_type)))
4893 Fmodify_frame_parameters (frame, Fcons (Fcons (Qdisplay_type, disptype),
4894 Qnil));
4897 /* Set up faces after all frame parameters are known. This call
4898 also merges in face attributes specified for new frames.
4900 Frame parameters may be changed if .Xdefaults contains
4901 specifications for the default font. For example, if there is an
4902 `Emacs.default.attributeBackground: pink', the `background-color'
4903 attribute of the frame get's set, which let's the internal border
4904 of the tooltip frame appear in pink. Prevent this. */
4906 Lisp_Object bg = Fframe_parameter (frame, Qbackground_color);
4908 /* Set tip_frame here, so that */
4909 tip_frame = frame;
4910 call2 (Qface_set_after_frame_default, frame, Qnil);
4912 if (!EQ (bg, Fframe_parameter (frame, Qbackground_color)))
4913 Fmodify_frame_parameters (frame, Fcons (Fcons (Qbackground_color, bg),
4914 Qnil));
4917 f->no_split = 1;
4919 UNGCPRO;
4921 /* It is now ok to make the frame official even if we get an error
4922 below. And the frame needs to be on Vframe_list or making it
4923 visible won't work. */
4924 Vframe_list = Fcons (frame, Vframe_list);
4926 /* Now that the frame is official, it counts as a reference to
4927 its display. */
4928 FRAME_X_DISPLAY_INFO (f)->reference_count++;
4930 /* Setting attributes of faces of the tooltip frame from resources
4931 and similar will increment face_change_count, which leads to the
4932 clearing of all current matrices. Since this isn't necessary
4933 here, avoid it by resetting face_change_count to the value it
4934 had before we created the tip frame. */
4935 face_change_count = face_change_count_before;
4937 /* Discard the unwind_protect. */
4938 return unbind_to (count, frame);
4942 /* Compute where to display tip frame F. PARMS is the list of frame
4943 parameters for F. DX and DY are specified offsets from the current
4944 location of the mouse. WIDTH and HEIGHT are the width and height
4945 of the tooltip. Return coordinates relative to the root window of
4946 the display in *ROOT_X, and *ROOT_Y. */
4948 static void
4949 compute_tip_xy (f, parms, dx, dy, width, height, root_x, root_y)
4950 struct frame *f;
4951 Lisp_Object parms, dx, dy;
4952 int width, height;
4953 int *root_x, *root_y;
4955 Lisp_Object left, top;
4956 int win_x, win_y;
4957 Window root, child;
4958 unsigned pmask;
4960 /* User-specified position? */
4961 left = Fcdr (Fassq (Qleft, parms));
4962 top = Fcdr (Fassq (Qtop, parms));
4964 /* Move the tooltip window where the mouse pointer is. Resize and
4965 show it. */
4966 if (!INTEGERP (left) || !INTEGERP (top))
4968 BLOCK_INPUT;
4969 XQueryPointer (FRAME_X_DISPLAY (f), FRAME_X_DISPLAY_INFO (f)->root_window,
4970 &root, &child, root_x, root_y, &win_x, &win_y, &pmask);
4971 UNBLOCK_INPUT;
4974 if (INTEGERP (top))
4975 *root_y = XINT (top);
4976 else if (*root_y + XINT (dy) <= 0)
4977 *root_y = 0; /* Can happen for negative dy */
4978 else if (*root_y + XINT (dy) + height
4979 <= x_display_pixel_height (FRAME_X_DISPLAY_INFO (f)))
4980 /* It fits below the pointer */
4981 *root_y += XINT (dy);
4982 else if (height + XINT (dy) <= *root_y)
4983 /* It fits above the pointer. */
4984 *root_y -= height + XINT (dy);
4985 else
4986 /* Put it on the top. */
4987 *root_y = 0;
4989 if (INTEGERP (left))
4990 *root_x = XINT (left);
4991 else if (*root_x + XINT (dx) <= 0)
4992 *root_x = 0; /* Can happen for negative dx */
4993 else if (*root_x + XINT (dx) + width
4994 <= x_display_pixel_width (FRAME_X_DISPLAY_INFO (f)))
4995 /* It fits to the right of the pointer. */
4996 *root_x += XINT (dx);
4997 else if (width + XINT (dx) <= *root_x)
4998 /* It fits to the left of the pointer. */
4999 *root_x -= width + XINT (dx);
5000 else
5001 /* Put it left-justified on the screen--it ought to fit that way. */
5002 *root_x = 0;
5006 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
5007 doc: /* Show STRING in a "tooltip" window on frame FRAME.
5008 A tooltip window is a small X window displaying a string.
5010 This is an internal function; Lisp code should call `tooltip-show'.
5012 FRAME nil or omitted means use the selected frame.
5014 PARMS is an optional list of frame parameters which can be used to
5015 change the tooltip's appearance.
5017 Automatically hide the tooltip after TIMEOUT seconds. TIMEOUT nil
5018 means use the default timeout of 5 seconds.
5020 If the list of frame parameters PARAMS contains a `left' parameters,
5021 the tooltip is displayed at that x-position. Otherwise it is
5022 displayed at the mouse position, with offset DX added (default is 5 if
5023 DX isn't specified). Likewise for the y-position; if a `top' frame
5024 parameter is specified, it determines the y-position of the tooltip
5025 window, otherwise it is displayed at the mouse position, with offset
5026 DY added (default is -10).
5028 A tooltip's maximum size is specified by `x-max-tooltip-size'.
5029 Text larger than the specified size is clipped. */)
5030 (string, frame, parms, timeout, dx, dy)
5031 Lisp_Object string, frame, parms, timeout, dx, dy;
5033 struct frame *f;
5034 struct window *w;
5035 int root_x, root_y;
5036 struct buffer *old_buffer;
5037 struct text_pos pos;
5038 int i, width, height;
5039 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
5040 int old_windows_or_buffers_changed = windows_or_buffers_changed;
5041 int count = SPECPDL_INDEX ();
5043 specbind (Qinhibit_redisplay, Qt);
5045 GCPRO4 (string, parms, frame, timeout);
5047 CHECK_STRING (string);
5048 if (SCHARS (string) == 0)
5049 string = make_unibyte_string (" ", 1);
5051 f = check_x_frame (frame);
5052 if (NILP (timeout))
5053 timeout = make_number (5);
5054 else
5055 CHECK_NATNUM (timeout);
5057 if (NILP (dx))
5058 dx = make_number (5);
5059 else
5060 CHECK_NUMBER (dx);
5062 if (NILP (dy))
5063 dy = make_number (-10);
5064 else
5065 CHECK_NUMBER (dy);
5067 if (NILP (last_show_tip_args))
5068 last_show_tip_args = Fmake_vector (make_number (3), Qnil);
5070 if (!NILP (tip_frame))
5072 Lisp_Object last_string = AREF (last_show_tip_args, 0);
5073 Lisp_Object last_frame = AREF (last_show_tip_args, 1);
5074 Lisp_Object last_parms = AREF (last_show_tip_args, 2);
5076 if (EQ (frame, last_frame)
5077 && !NILP (Fequal (last_string, string))
5078 && !NILP (Fequal (last_parms, parms)))
5080 struct frame *f = XFRAME (tip_frame);
5082 /* Only DX and DY have changed. */
5083 if (!NILP (tip_timer))
5085 Lisp_Object timer = tip_timer;
5086 tip_timer = Qnil;
5087 call1 (Qcancel_timer, timer);
5090 BLOCK_INPUT;
5091 compute_tip_xy (f, parms, dx, dy, FRAME_PIXEL_WIDTH (f),
5092 FRAME_PIXEL_HEIGHT (f), &root_x, &root_y);
5093 XMoveWindow (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
5094 root_x, root_y);
5095 UNBLOCK_INPUT;
5096 goto start_timer;
5100 /* Hide a previous tip, if any. */
5101 Fx_hide_tip ();
5103 ASET (last_show_tip_args, 0, string);
5104 ASET (last_show_tip_args, 1, frame);
5105 ASET (last_show_tip_args, 2, parms);
5107 /* Add default values to frame parameters. */
5108 if (NILP (Fassq (Qname, parms)))
5109 parms = Fcons (Fcons (Qname, build_string ("tooltip")), parms);
5110 if (NILP (Fassq (Qinternal_border_width, parms)))
5111 parms = Fcons (Fcons (Qinternal_border_width, make_number (3)), parms);
5112 if (NILP (Fassq (Qborder_width, parms)))
5113 parms = Fcons (Fcons (Qborder_width, make_number (1)), parms);
5114 if (NILP (Fassq (Qborder_color, parms)))
5115 parms = Fcons (Fcons (Qborder_color, build_string ("lightyellow")), parms);
5116 if (NILP (Fassq (Qbackground_color, parms)))
5117 parms = Fcons (Fcons (Qbackground_color, build_string ("lightyellow")),
5118 parms);
5120 /* Create a frame for the tooltip, and record it in the global
5121 variable tip_frame. */
5122 frame = x_create_tip_frame (FRAME_X_DISPLAY_INFO (f), parms, string);
5123 f = XFRAME (frame);
5125 /* Set up the frame's root window. */
5126 w = XWINDOW (FRAME_ROOT_WINDOW (f));
5127 w->left_col = w->top_line = make_number (0);
5129 if (CONSP (Vx_max_tooltip_size)
5130 && INTEGERP (XCAR (Vx_max_tooltip_size))
5131 && XINT (XCAR (Vx_max_tooltip_size)) > 0
5132 && INTEGERP (XCDR (Vx_max_tooltip_size))
5133 && XINT (XCDR (Vx_max_tooltip_size)) > 0)
5135 w->total_cols = XCAR (Vx_max_tooltip_size);
5136 w->total_lines = XCDR (Vx_max_tooltip_size);
5138 else
5140 w->total_cols = make_number (80);
5141 w->total_lines = make_number (40);
5144 FRAME_TOTAL_COLS (f) = XINT (w->total_cols);
5145 adjust_glyphs (f);
5146 w->pseudo_window_p = 1;
5148 /* Display the tooltip text in a temporary buffer. */
5149 old_buffer = current_buffer;
5150 set_buffer_internal_1 (XBUFFER (XWINDOW (FRAME_ROOT_WINDOW (f))->buffer));
5151 current_buffer->truncate_lines = Qnil;
5152 clear_glyph_matrix (w->desired_matrix);
5153 clear_glyph_matrix (w->current_matrix);
5154 SET_TEXT_POS (pos, BEGV, BEGV_BYTE);
5155 try_window (FRAME_ROOT_WINDOW (f), pos, 0);
5157 /* Compute width and height of the tooltip. */
5158 width = height = 0;
5159 for (i = 0; i < w->desired_matrix->nrows; ++i)
5161 struct glyph_row *row = &w->desired_matrix->rows[i];
5162 struct glyph *last;
5163 int row_width;
5165 /* Stop at the first empty row at the end. */
5166 if (!row->enabled_p || !row->displays_text_p)
5167 break;
5169 /* Let the row go over the full width of the frame. */
5170 row->full_width_p = 1;
5172 /* There's a glyph at the end of rows that is used to place
5173 the cursor there. Don't include the width of this glyph. */
5174 if (row->used[TEXT_AREA])
5176 last = &row->glyphs[TEXT_AREA][row->used[TEXT_AREA] - 1];
5177 row_width = row->pixel_width - last->pixel_width;
5179 else
5180 row_width = row->pixel_width;
5182 height += row->height;
5183 width = max (width, row_width);
5186 /* Add the frame's internal border to the width and height the X
5187 window should have. */
5188 height += 2 * FRAME_INTERNAL_BORDER_WIDTH (f);
5189 width += 2 * FRAME_INTERNAL_BORDER_WIDTH (f);
5191 /* Move the tooltip window where the mouse pointer is. Resize and
5192 show it. */
5193 compute_tip_xy (f, parms, dx, dy, width, height, &root_x, &root_y);
5195 BLOCK_INPUT;
5196 XMoveResizeWindow (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
5197 root_x, root_y, width, height);
5198 XMapRaised (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f));
5199 UNBLOCK_INPUT;
5201 /* Draw into the window. */
5202 w->must_be_updated_p = 1;
5203 update_single_window (w, 1);
5205 /* Restore original current buffer. */
5206 set_buffer_internal_1 (old_buffer);
5207 windows_or_buffers_changed = old_windows_or_buffers_changed;
5209 start_timer:
5210 /* Let the tip disappear after timeout seconds. */
5211 tip_timer = call3 (intern ("run-at-time"), timeout, Qnil,
5212 intern ("x-hide-tip"));
5214 UNGCPRO;
5215 return unbind_to (count, Qnil);
5219 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
5220 doc: /* Hide the current tooltip window, if there is any.
5221 Value is t if tooltip was open, nil otherwise. */)
5224 int count;
5225 Lisp_Object deleted, frame, timer;
5226 struct gcpro gcpro1, gcpro2;
5228 /* Return quickly if nothing to do. */
5229 if (NILP (tip_timer) && NILP (tip_frame))
5230 return Qnil;
5232 frame = tip_frame;
5233 timer = tip_timer;
5234 GCPRO2 (frame, timer);
5235 tip_frame = tip_timer = deleted = Qnil;
5237 count = SPECPDL_INDEX ();
5238 specbind (Qinhibit_redisplay, Qt);
5239 specbind (Qinhibit_quit, Qt);
5241 if (!NILP (timer))
5242 call1 (Qcancel_timer, timer);
5244 if (FRAMEP (frame))
5246 delete_frame (frame, Qnil);
5247 deleted = Qt;
5249 #ifdef USE_LUCID
5250 /* Bloodcurdling hack alert: The Lucid menu bar widget's
5251 redisplay procedure is not called when a tip frame over menu
5252 items is unmapped. Redisplay the menu manually... */
5254 struct frame *f = SELECTED_FRAME ();
5255 Widget w = f->output_data.x->menubar_widget;
5256 extern void xlwmenu_redisplay P_ ((Widget));
5258 if (!DoesSaveUnders (FRAME_X_DISPLAY_INFO (f)->screen)
5259 && w != NULL)
5261 BLOCK_INPUT;
5262 xlwmenu_redisplay (w);
5263 UNBLOCK_INPUT;
5266 #endif /* USE_LUCID */
5269 UNGCPRO;
5270 return unbind_to (count, deleted);
5275 /***********************************************************************
5276 File selection dialog
5277 ***********************************************************************/
5279 DEFUN ("x-uses-old-gtk-dialog", Fx_uses_old_gtk_dialog,
5280 Sx_uses_old_gtk_dialog,
5281 0, 0, 0,
5282 doc: /* Return t if the old Gtk+ file selection dialog is used. */)
5285 #ifdef USE_GTK
5286 extern int use_dialog_box;
5287 extern int use_file_dialog;
5289 if (use_dialog_box
5290 && use_file_dialog
5291 && have_menus_p ()
5292 && xg_uses_old_file_dialog ())
5293 return Qt;
5294 #endif
5295 return Qnil;
5299 #ifdef USE_MOTIF
5300 /* Callback for "OK" and "Cancel" on file selection dialog. */
5302 static void
5303 file_dialog_cb (widget, client_data, call_data)
5304 Widget widget;
5305 XtPointer call_data, client_data;
5307 int *result = (int *) client_data;
5308 XmAnyCallbackStruct *cb = (XmAnyCallbackStruct *) call_data;
5309 *result = cb->reason;
5313 /* Callback for unmapping a file selection dialog. This is used to
5314 capture the case where a dialog is closed via a window manager's
5315 closer button, for example. Using a XmNdestroyCallback didn't work
5316 in this case. */
5318 static void
5319 file_dialog_unmap_cb (widget, client_data, call_data)
5320 Widget widget;
5321 XtPointer call_data, client_data;
5323 int *result = (int *) client_data;
5324 *result = XmCR_CANCEL;
5327 static Lisp_Object
5328 clean_up_file_dialog (arg)
5329 Lisp_Object arg;
5331 struct Lisp_Save_Value *p = XSAVE_VALUE (arg);
5332 Widget dialog = (Widget) p->pointer;
5334 /* Clean up. */
5335 BLOCK_INPUT;
5336 XtUnmanageChild (dialog);
5337 XtDestroyWidget (dialog);
5338 x_menu_set_in_use (0);
5339 UNBLOCK_INPUT;
5341 return Qnil;
5345 DEFUN ("x-file-dialog", Fx_file_dialog, Sx_file_dialog, 2, 5, 0,
5346 doc: /* Read file name, prompting with PROMPT in directory DIR.
5347 Use a file selection dialog. Select DEFAULT-FILENAME in the dialog's file
5348 selection box, if specified. If MUSTMATCH is non-nil, the returned file
5349 or directory must exist. ONLY-DIR-P is ignored." */)
5350 (prompt, dir, default_filename, mustmatch, only_dir_p)
5351 Lisp_Object prompt, dir, default_filename, mustmatch, only_dir_p;
5353 int result;
5354 struct frame *f = SELECTED_FRAME ();
5355 Lisp_Object file = Qnil;
5356 Lisp_Object decoded_file;
5357 Widget dialog, text, help;
5358 Arg al[10];
5359 int ac = 0;
5360 extern XtAppContext Xt_app_con;
5361 XmString dir_xmstring, pattern_xmstring;
5362 int count = SPECPDL_INDEX ();
5363 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
5365 check_x ();
5367 GCPRO6 (prompt, dir, default_filename, mustmatch, only_dir_p, file);
5369 if (popup_activated ())
5370 error ("Trying to use a menu from within a menu-entry");
5372 CHECK_STRING (prompt);
5373 CHECK_STRING (dir);
5375 /* Prevent redisplay. */
5376 specbind (Qinhibit_redisplay, Qt);
5378 BLOCK_INPUT;
5380 /* Create the dialog with PROMPT as title, using DIR as initial
5381 directory and using "*" as pattern. */
5382 dir = Fexpand_file_name (dir, Qnil);
5383 dir_xmstring = XmStringCreateLocalized (SDATA (dir));
5384 pattern_xmstring = XmStringCreateLocalized ("*");
5386 XtSetArg (al[ac], XmNtitle, SDATA (prompt)); ++ac;
5387 XtSetArg (al[ac], XmNdirectory, dir_xmstring); ++ac;
5388 XtSetArg (al[ac], XmNpattern, pattern_xmstring); ++ac;
5389 XtSetArg (al[ac], XmNresizePolicy, XmRESIZE_GROW); ++ac;
5390 XtSetArg (al[ac], XmNdialogStyle, XmDIALOG_APPLICATION_MODAL); ++ac;
5391 dialog = XmCreateFileSelectionDialog (f->output_data.x->widget,
5392 "fsb", al, ac);
5393 XmStringFree (dir_xmstring);
5394 XmStringFree (pattern_xmstring);
5396 /* Add callbacks for OK and Cancel. */
5397 XtAddCallback (dialog, XmNokCallback, file_dialog_cb,
5398 (XtPointer) &result);
5399 XtAddCallback (dialog, XmNcancelCallback, file_dialog_cb,
5400 (XtPointer) &result);
5401 XtAddCallback (dialog, XmNunmapCallback, file_dialog_unmap_cb,
5402 (XtPointer) &result);
5404 /* Remove the help button since we can't display help. */
5405 help = XmFileSelectionBoxGetChild (dialog, XmDIALOG_HELP_BUTTON);
5406 XtUnmanageChild (help);
5408 /* Mark OK button as default. */
5409 XtVaSetValues (XmFileSelectionBoxGetChild (dialog, XmDIALOG_OK_BUTTON),
5410 XmNshowAsDefault, True, NULL);
5412 /* If MUSTMATCH is non-nil, disable the file entry field of the
5413 dialog, so that the user must select a file from the files list
5414 box. We can't remove it because we wouldn't have a way to get at
5415 the result file name, then. */
5416 text = XmFileSelectionBoxGetChild (dialog, XmDIALOG_TEXT);
5417 if (!NILP (mustmatch))
5419 Widget label;
5420 label = XmFileSelectionBoxGetChild (dialog, XmDIALOG_SELECTION_LABEL);
5421 XtSetSensitive (text, False);
5422 XtSetSensitive (label, False);
5425 /* Manage the dialog, so that list boxes get filled. */
5426 XtManageChild (dialog);
5428 if (STRINGP (default_filename))
5430 XmString default_xmstring;
5431 Widget wtext = XmFileSelectionBoxGetChild (dialog, XmDIALOG_TEXT);
5432 Widget list = XmFileSelectionBoxGetChild (dialog, XmDIALOG_LIST);
5434 XmTextPosition last_pos = XmTextFieldGetLastPosition (wtext);
5435 XmTextFieldReplace (wtext, 0, last_pos,
5436 (SDATA (Ffile_name_nondirectory (default_filename))));
5438 /* Select DEFAULT_FILENAME in the files list box. DEFAULT_FILENAME
5439 must include the path for this to work. */
5441 default_xmstring = XmStringCreateLocalized (SDATA (default_filename));
5443 if (XmListItemExists (list, default_xmstring))
5445 int item_pos = XmListItemPos (list, default_xmstring);
5446 /* Select the item and scroll it into view. */
5447 XmListSelectPos (list, item_pos, True);
5448 XmListSetPos (list, item_pos);
5451 XmStringFree (default_xmstring);
5454 record_unwind_protect (clean_up_file_dialog, make_save_value (dialog, 0));
5456 /* Process events until the user presses Cancel or OK. */
5457 x_menu_set_in_use (1);
5458 result = 0;
5459 while (result == 0)
5461 XEvent event;
5462 x_menu_wait_for_event (0);
5463 XtAppNextEvent (Xt_app_con, &event);
5464 if (event.type == KeyPress
5465 && FRAME_X_DISPLAY (f) == event.xkey.display)
5467 KeySym keysym = XLookupKeysym (&event.xkey, 0);
5469 /* Pop down on C-g. */
5470 if (keysym == XK_g && (event.xkey.state & ControlMask) != 0)
5471 XtUnmanageChild (dialog);
5474 (void) x_dispatch_event (&event, FRAME_X_DISPLAY (f));
5477 /* Get the result. */
5478 if (result == XmCR_OK)
5480 XmString text;
5481 String data;
5483 XtVaGetValues (dialog, XmNtextString, &text, NULL);
5484 XmStringGetLtoR (text, XmFONTLIST_DEFAULT_TAG, &data);
5485 XmStringFree (text);
5486 file = build_string (data);
5487 XtFree (data);
5489 else
5490 file = Qnil;
5492 UNBLOCK_INPUT;
5493 UNGCPRO;
5495 /* Make "Cancel" equivalent to C-g. */
5496 if (NILP (file))
5497 Fsignal (Qquit, Qnil);
5499 decoded_file = DECODE_FILE (file);
5501 return unbind_to (count, decoded_file);
5504 #endif /* USE_MOTIF */
5506 #ifdef USE_GTK
5508 static Lisp_Object
5509 clean_up_dialog (arg)
5510 Lisp_Object arg;
5512 x_menu_set_in_use (0);
5514 return Qnil;
5517 DEFUN ("x-file-dialog", Fx_file_dialog, Sx_file_dialog, 2, 5, 0,
5518 doc: /* Read file name, prompting with PROMPT in directory DIR.
5519 Use a file selection dialog. Select DEFAULT-FILENAME in the dialog's file
5520 selection box, if specified. If MUSTMATCH is non-nil, the returned file
5521 or directory must exist. If ONLY-DIR-P is non-nil, the user can only select
5522 directories. */)
5523 (prompt, dir, default_filename, mustmatch, only_dir_p)
5524 Lisp_Object prompt, dir, default_filename, mustmatch, only_dir_p;
5526 FRAME_PTR f = SELECTED_FRAME ();
5527 char *fn;
5528 Lisp_Object file = Qnil;
5529 Lisp_Object decoded_file;
5530 int count = SPECPDL_INDEX ();
5531 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
5532 char *cdef_file;
5534 check_x ();
5536 GCPRO6 (prompt, dir, default_filename, mustmatch, only_dir_p, file);
5538 if (popup_activated ())
5539 error ("Trying to use a menu from within a menu-entry");
5541 CHECK_STRING (prompt);
5542 CHECK_STRING (dir);
5544 /* Prevent redisplay. */
5545 specbind (Qinhibit_redisplay, Qt);
5546 record_unwind_protect (clean_up_dialog, Qnil);
5548 BLOCK_INPUT;
5550 if (STRINGP (default_filename))
5551 cdef_file = SDATA (default_filename);
5552 else
5553 cdef_file = SDATA (dir);
5555 fn = xg_get_file_name (f, SDATA (prompt), cdef_file,
5556 ! NILP (mustmatch),
5557 ! NILP (only_dir_p));
5559 if (fn)
5561 file = build_string (fn);
5562 xfree (fn);
5565 UNBLOCK_INPUT;
5566 UNGCPRO;
5568 /* Make "Cancel" equivalent to C-g. */
5569 if (NILP (file))
5570 Fsignal (Qquit, Qnil);
5572 decoded_file = DECODE_FILE (file);
5574 return unbind_to (count, decoded_file);
5578 #ifdef HAVE_FREETYPE
5580 DEFUN ("x-select-font", Fx_select_font, Sx_select_font, 0, 2, 0,
5581 doc: /* Read a font name using a GTK font selection dialog.
5582 Return a GTK-style font string corresponding to the selection.
5584 If FRAME is omitted or nil, it defaults to the selected frame. */)
5585 (frame, ignored)
5586 Lisp_Object frame, ignored;
5588 FRAME_PTR f = check_x_frame (frame);
5589 char *name;
5590 Lisp_Object font;
5591 Lisp_Object font_param;
5592 char *default_name = NULL;
5593 struct gcpro gcpro1, gcpro2;
5594 int count = SPECPDL_INDEX ();
5596 check_x ();
5598 if (popup_activated ())
5599 error ("Trying to use a menu from within a menu-entry");
5601 /* Prevent redisplay. */
5602 specbind (Qinhibit_redisplay, Qt);
5603 record_unwind_protect (clean_up_dialog, Qnil);
5605 BLOCK_INPUT;
5607 GCPRO2(font_param, font);
5609 XSETFONT (font, FRAME_FONT (f));
5610 font_param = Ffont_get (font, intern_c_string (":name"));
5611 if (STRINGP (font_param))
5612 default_name = SDATA (font_param);
5613 else
5615 font_param = Fframe_parameter (frame, Qfont_param);
5616 if (STRINGP (font_param))
5617 default_name = SDATA (font_param);
5620 if (default_name == NULL && x_last_font_name != NULL)
5621 default_name = x_last_font_name;
5623 name = xg_get_font_name (f, default_name);
5625 if (name)
5627 font = build_string (name);
5628 g_free (x_last_font_name);
5629 x_last_font_name = name;
5632 UNBLOCK_INPUT;
5634 if (NILP (font))
5635 Fsignal (Qquit, Qnil);
5637 return unbind_to (count, font);
5639 #endif /* HAVE_FREETYPE */
5641 #endif /* USE_GTK */
5644 /***********************************************************************
5645 Keyboard
5646 ***********************************************************************/
5648 #ifdef HAVE_XKBGETKEYBOARD
5649 #include <X11/XKBlib.h>
5650 #include <X11/keysym.h>
5651 #endif
5653 DEFUN ("x-backspace-delete-keys-p", Fx_backspace_delete_keys_p,
5654 Sx_backspace_delete_keys_p, 0, 1, 0,
5655 doc: /* Check if both Backspace and Delete keys are on the keyboard of FRAME.
5656 FRAME nil means use the selected frame.
5657 Value is t if we know that both keys are present, and are mapped to the
5658 usual X keysyms. Value is `lambda' if we cannot determine if both keys are
5659 present and mapped to the usual X keysyms. */)
5660 (frame)
5661 Lisp_Object frame;
5663 #ifdef HAVE_XKBGETKEYBOARD
5664 XkbDescPtr kb;
5665 struct frame *f = check_x_frame (frame);
5666 Display *dpy = FRAME_X_DISPLAY (f);
5667 Lisp_Object have_keys;
5668 int major, minor, op, event, error;
5670 BLOCK_INPUT;
5672 /* Check library version in case we're dynamically linked. */
5673 major = XkbMajorVersion;
5674 minor = XkbMinorVersion;
5675 if (!XkbLibraryVersion (&major, &minor))
5677 UNBLOCK_INPUT;
5678 return Qlambda;
5681 /* Check that the server supports XKB. */
5682 major = XkbMajorVersion;
5683 minor = XkbMinorVersion;
5684 if (!XkbQueryExtension (dpy, &op, &event, &error, &major, &minor))
5686 UNBLOCK_INPUT;
5687 return Qlambda;
5690 /* In this code we check that the keyboard has physical keys with names
5691 that start with BKSP (Backspace) and DELE (Delete), and that they
5692 generate keysym XK_BackSpace and XK_Delete respectively.
5693 This function is used to test if normal-erase-is-backspace should be
5694 turned on.
5695 An alternative approach would be to just check if XK_BackSpace and
5696 XK_Delete are mapped to any key. But if any of those are mapped to
5697 some non-intuitive key combination (Meta-Shift-Ctrl-whatever) and the
5698 user doesn't know about it, it is better to return false here.
5699 It is more obvious to the user what to do if she/he has two keys
5700 clearly marked with names/symbols and one key does something not
5701 expected (i.e. she/he then tries the other).
5702 The cases where Backspace/Delete is mapped to some other key combination
5703 are rare, and in those cases, normal-erase-is-backspace can be turned on
5704 manually. */
5706 have_keys = Qnil;
5707 kb = XkbGetMap (dpy, XkbAllMapComponentsMask, XkbUseCoreKbd);
5708 if (kb)
5710 int delete_keycode = 0, backspace_keycode = 0, i;
5712 if (XkbGetNames (dpy, XkbAllNamesMask, kb) == Success)
5714 for (i = kb->min_key_code;
5715 (i < kb->max_key_code
5716 && (delete_keycode == 0 || backspace_keycode == 0));
5717 ++i)
5719 /* The XKB symbolic key names can be seen most easily in
5720 the PS file generated by `xkbprint -label name
5721 $DISPLAY'. */
5722 if (bcmp ("DELE", kb->names->keys[i].name, 4) == 0)
5723 delete_keycode = i;
5724 else if (bcmp ("BKSP", kb->names->keys[i].name, 4) == 0)
5725 backspace_keycode = i;
5728 XkbFreeNames (kb, 0, True);
5731 XkbFreeClientMap (kb, 0, True);
5733 if (delete_keycode
5734 && backspace_keycode
5735 && XKeysymToKeycode (dpy, XK_Delete) == delete_keycode
5736 && XKeysymToKeycode (dpy, XK_BackSpace) == backspace_keycode)
5737 have_keys = Qt;
5739 UNBLOCK_INPUT;
5740 return have_keys;
5741 #else /* not HAVE_XKBGETKEYBOARD */
5742 return Qlambda;
5743 #endif /* not HAVE_XKBGETKEYBOARD */
5748 /***********************************************************************
5749 Initialization
5750 ***********************************************************************/
5752 /* Keep this list in the same order as frame_parms in frame.c.
5753 Use 0 for unsupported frame parameters. */
5755 frame_parm_handler x_frame_parm_handlers[] =
5757 x_set_autoraise,
5758 x_set_autolower,
5759 x_set_background_color,
5760 x_set_border_color,
5761 x_set_border_width,
5762 x_set_cursor_color,
5763 x_set_cursor_type,
5764 x_set_font,
5765 x_set_foreground_color,
5766 x_set_icon_name,
5767 x_set_icon_type,
5768 x_set_internal_border_width,
5769 x_set_menu_bar_lines,
5770 x_set_mouse_color,
5771 x_explicitly_set_name,
5772 x_set_scroll_bar_width,
5773 x_set_title,
5774 x_set_unsplittable,
5775 x_set_vertical_scroll_bars,
5776 x_set_visibility,
5777 x_set_tool_bar_lines,
5778 x_set_scroll_bar_foreground,
5779 x_set_scroll_bar_background,
5780 x_set_screen_gamma,
5781 x_set_line_spacing,
5782 x_set_fringe_width,
5783 x_set_fringe_width,
5784 x_set_wait_for_wm,
5785 x_set_fullscreen,
5786 x_set_font_backend,
5787 x_set_alpha,
5788 x_set_sticky,
5791 void
5792 syms_of_xfns ()
5794 /* This is zero if not using X windows. */
5795 x_in_use = 0;
5797 /* The section below is built by the lisp expression at the top of the file,
5798 just above where these variables are declared. */
5799 /*&&& init symbols here &&&*/
5800 Qnone = intern_c_string ("none");
5801 staticpro (&Qnone);
5802 Qsuppress_icon = intern_c_string ("suppress-icon");
5803 staticpro (&Qsuppress_icon);
5804 Qundefined_color = intern_c_string ("undefined-color");
5805 staticpro (&Qundefined_color);
5806 Qcompound_text = intern_c_string ("compound-text");
5807 staticpro (&Qcompound_text);
5808 Qcancel_timer = intern_c_string ("cancel-timer");
5809 staticpro (&Qcancel_timer);
5810 Qfont_param = intern_c_string ("font-parameter");
5811 staticpro (&Qfont_param);
5812 /* This is the end of symbol initialization. */
5814 /* Text property `display' should be nonsticky by default. */
5815 Vtext_property_default_nonsticky
5816 = Fcons (Fcons (Qdisplay, Qt), Vtext_property_default_nonsticky);
5819 Fput (Qundefined_color, Qerror_conditions,
5820 pure_cons (Qundefined_color, pure_cons (Qerror, Qnil)));
5821 Fput (Qundefined_color, Qerror_message,
5822 make_pure_c_string ("Undefined color"));
5824 DEFVAR_LISP ("x-pointer-shape", &Vx_pointer_shape,
5825 doc: /* The shape of the pointer when over text.
5826 Changing the value does not affect existing frames
5827 unless you set the mouse color. */);
5828 Vx_pointer_shape = Qnil;
5830 #if 0 /* This doesn't really do anything. */
5831 DEFVAR_LISP ("x-nontext-pointer-shape", &Vx_nontext_pointer_shape,
5832 doc: /* The shape of the pointer when not over text.
5833 This variable takes effect when you create a new frame
5834 or when you set the mouse color. */);
5835 #endif
5836 Vx_nontext_pointer_shape = Qnil;
5838 DEFVAR_LISP ("x-hourglass-pointer-shape", &Vx_hourglass_pointer_shape,
5839 doc: /* The shape of the pointer when Emacs is busy.
5840 This variable takes effect when you create a new frame
5841 or when you set the mouse color. */);
5842 Vx_hourglass_pointer_shape = Qnil;
5844 #if 0 /* This doesn't really do anything. */
5845 DEFVAR_LISP ("x-mode-pointer-shape", &Vx_mode_pointer_shape,
5846 doc: /* The shape of the pointer when over the mode line.
5847 This variable takes effect when you create a new frame
5848 or when you set the mouse color. */);
5849 #endif
5850 Vx_mode_pointer_shape = Qnil;
5852 DEFVAR_LISP ("x-sensitive-text-pointer-shape",
5853 &Vx_sensitive_text_pointer_shape,
5854 doc: /* The shape of the pointer when over mouse-sensitive text.
5855 This variable takes effect when you create a new frame
5856 or when you set the mouse color. */);
5857 Vx_sensitive_text_pointer_shape = Qnil;
5859 DEFVAR_LISP ("x-window-horizontal-drag-cursor",
5860 &Vx_window_horizontal_drag_shape,
5861 doc: /* Pointer shape to use for indicating a window can be dragged horizontally.
5862 This variable takes effect when you create a new frame
5863 or when you set the mouse color. */);
5864 Vx_window_horizontal_drag_shape = Qnil;
5866 DEFVAR_LISP ("x-cursor-fore-pixel", &Vx_cursor_fore_pixel,
5867 doc: /* A string indicating the foreground color of the cursor box. */);
5868 Vx_cursor_fore_pixel = Qnil;
5870 DEFVAR_LISP ("x-max-tooltip-size", &Vx_max_tooltip_size,
5871 doc: /* Maximum size for tooltips. Value is a pair (COLUMNS . ROWS).
5872 Text larger than this is clipped. */);
5873 Vx_max_tooltip_size = Fcons (make_number (80), make_number (40));
5875 DEFVAR_LISP ("x-no-window-manager", &Vx_no_window_manager,
5876 doc: /* Non-nil if no X window manager is in use.
5877 Emacs doesn't try to figure this out; this is always nil
5878 unless you set it to something else. */);
5879 /* We don't have any way to find this out, so set it to nil
5880 and maybe the user would like to set it to t. */
5881 Vx_no_window_manager = Qnil;
5883 DEFVAR_LISP ("x-pixel-size-width-font-regexp",
5884 &Vx_pixel_size_width_font_regexp,
5885 doc: /* Regexp matching a font name whose width is the same as `PIXEL_SIZE'.
5887 Since Emacs gets width of a font matching with this regexp from
5888 PIXEL_SIZE field of the name, font finding mechanism gets faster for
5889 such a font. This is especially effective for such large fonts as
5890 Chinese, Japanese, and Korean. */);
5891 Vx_pixel_size_width_font_regexp = Qnil;
5893 /* This is not ifdef:ed, so other builds than GTK can customize it. */
5894 DEFVAR_BOOL ("x-gtk-use-old-file-dialog", &x_gtk_use_old_file_dialog,
5895 doc: /* *Non-nil means prompt with the old GTK file selection dialog.
5896 If nil or if the file selection dialog is not available, the new GTK file
5897 chooser is used instead. To turn off all file dialogs set the
5898 variable `use-file-dialog'. */);
5899 x_gtk_use_old_file_dialog = 0;
5901 DEFVAR_BOOL ("x-gtk-show-hidden-files", &x_gtk_show_hidden_files,
5902 doc: /* *If non-nil, the GTK file chooser will by default show hidden files.
5903 Note that this is just the default, there is a toggle button on the file
5904 chooser to show or not show hidden files on a case by case basis. */);
5905 x_gtk_show_hidden_files = 0;
5907 DEFVAR_BOOL ("x-gtk-file-dialog-help-text", &x_gtk_file_dialog_help_text,
5908 doc: /* *If non-nil, the GTK file chooser will show additional help text.
5909 If more space for files in the file chooser dialog is wanted, set this to nil
5910 to turn the additional text off. */);
5911 x_gtk_file_dialog_help_text = 1;
5913 DEFVAR_BOOL ("x-gtk-whole-detached-tool-bar", &x_gtk_whole_detached_tool_bar,
5914 doc: /* *If non-nil, a detached tool bar is shown in full.
5915 The default is to just show an arrow and pressing on that arrow shows
5916 the tool bar buttons. */);
5917 x_gtk_whole_detached_tool_bar = 0;
5919 Fprovide (intern_c_string ("x"), Qnil);
5921 #ifdef USE_X_TOOLKIT
5922 Fprovide (intern_c_string ("x-toolkit"), Qnil);
5923 #ifdef USE_MOTIF
5924 Fprovide (intern_c_string ("motif"), Qnil);
5926 DEFVAR_LISP ("motif-version-string", &Vmotif_version_string,
5927 doc: /* Version info for LessTif/Motif. */);
5928 Vmotif_version_string = build_string (XmVERSION_STRING);
5929 #endif /* USE_MOTIF */
5930 #endif /* USE_X_TOOLKIT */
5932 #ifdef USE_GTK
5933 /* Provide x-toolkit also for GTK. Internally GTK does not use Xt so it
5934 is not an X toolkit in that sense (USE_X_TOOLKIT is not defined).
5935 But for a user it is a toolkit for X, and indeed, configure
5936 accepts --with-x-toolkit=gtk. */
5937 Fprovide (intern_c_string ("x-toolkit"), Qnil);
5938 Fprovide (intern_c_string ("gtk"), Qnil);
5940 DEFVAR_LISP ("gtk-version-string", &Vgtk_version_string,
5941 doc: /* Version info for GTK+. */);
5943 char gtk_version[40];
5944 g_snprintf (gtk_version, sizeof (gtk_version), "%u.%u.%u",
5945 GTK_MAJOR_VERSION, GTK_MINOR_VERSION, GTK_MICRO_VERSION);
5946 Vgtk_version_string = make_pure_string (gtk_version, strlen (gtk_version), strlen (gtk_version), 0);
5948 #endif /* USE_GTK */
5950 /* X window properties. */
5951 defsubr (&Sx_change_window_property);
5952 defsubr (&Sx_delete_window_property);
5953 defsubr (&Sx_window_property);
5955 defsubr (&Sxw_display_color_p);
5956 defsubr (&Sx_display_grayscale_p);
5957 defsubr (&Sxw_color_defined_p);
5958 defsubr (&Sxw_color_values);
5959 defsubr (&Sx_server_max_request_size);
5960 defsubr (&Sx_server_vendor);
5961 defsubr (&Sx_server_version);
5962 defsubr (&Sx_display_pixel_width);
5963 defsubr (&Sx_display_pixel_height);
5964 defsubr (&Sx_display_mm_width);
5965 defsubr (&Sx_display_mm_height);
5966 defsubr (&Sx_display_screens);
5967 defsubr (&Sx_display_planes);
5968 defsubr (&Sx_display_color_cells);
5969 defsubr (&Sx_display_visual_class);
5970 defsubr (&Sx_display_backing_store);
5971 defsubr (&Sx_display_save_under);
5972 defsubr (&Sx_wm_set_size_hint);
5973 defsubr (&Sx_create_frame);
5974 defsubr (&Sx_open_connection);
5975 defsubr (&Sx_close_connection);
5976 defsubr (&Sx_display_list);
5977 defsubr (&Sx_synchronize);
5978 defsubr (&Sx_focus_frame);
5979 defsubr (&Sx_backspace_delete_keys_p);
5981 /* Setting callback functions for fontset handler. */
5982 check_window_system_func = check_x;
5984 defsubr (&Sx_show_tip);
5985 defsubr (&Sx_hide_tip);
5986 tip_timer = Qnil;
5987 staticpro (&tip_timer);
5988 tip_frame = Qnil;
5989 staticpro (&tip_frame);
5991 last_show_tip_args = Qnil;
5992 staticpro (&last_show_tip_args);
5994 defsubr (&Sx_uses_old_gtk_dialog);
5995 #if defined (USE_MOTIF) || defined (USE_GTK)
5996 defsubr (&Sx_file_dialog);
5997 #endif
5999 #if defined (USE_GTK) && defined (HAVE_FREETYPE)
6000 defsubr (&Sx_select_font);
6001 x_last_font_name = NULL;
6002 #endif
6005 #endif /* HAVE_X_WINDOWS */
6007 /* arch-tag: 55040d02-5485-4d58-8b22-95a7a05f3288
6008 (do not change this comment) */