* xdisp.c (display_mode_element): Don't assume strlen fits in int.
[bpt/emacs.git] / src / xfns.c
CommitLineData
01f1ba30 1/* Functions for the X window system.
e9bffc61 2
73b0cd50 3Copyright (C) 1989, 1992-2011 Free Software Foundation, Inc.
01f1ba30
JB
4
5This file is part of GNU Emacs.
6
9ec0b715 7GNU Emacs is free software: you can redistribute it and/or modify
01f1ba30 8it under the terms of the GNU General Public License as published by
9ec0b715
GM
9the Free Software Foundation, either version 3 of the License, or
10(at your option) any later version.
01f1ba30
JB
11
12GNU Emacs is distributed in the hope that it will be useful,
13but WITHOUT ANY WARRANTY; without even the implied warranty of
14MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15GNU General Public License for more details.
16
17You should have received a copy of the GNU General Public License
9ec0b715 18along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
01f1ba30 19
c389a86d 20#include <config.h>
333b20bb 21#include <stdio.h>
d62c8769 22#include <math.h>
d7306fe6 23#include <setjmp.h>
581e51e8 24#include <ctype.h>
3ecaf7e5 25#include <unistd.h>
3ecaf7e5 26
40e6f148 27/* This makes the fields of a Display accessible, in Xlib header files. */
333b20bb 28
40e6f148
RS
29#define XLIB_ILLEGAL_ACCESS
30
01f1ba30
JB
31#include "lisp.h"
32#include "xterm.h"
f676886a 33#include "frame.h"
01f1ba30
JB
34#include "window.h"
35#include "buffer.h"
58cad5ed 36#include "intervals.h"
01f1ba30 37#include "dispextern.h"
1f98fa48 38#include "keyboard.h"
9ac0d9e0 39#include "blockinput.h"
57bda87a 40#include <epaths.h>
0f8c4c4f 41#include "character.h"
942ea06d 42#include "charset.h"
96db09e4 43#include "coding.h"
942ea06d 44#include "fontset.h"
333b20bb
GM
45#include "systime.h"
46#include "termhooks.h"
4ae9a85e 47#include "atimer.h"
28d440ab 48#include "termchar.h"
02ed2ea8 49#include "font.h"
02ed2ea8 50
01f1ba30 51#ifdef HAVE_X_WINDOWS
67ba84d1 52
67ba84d1 53#include <ctype.h>
63cec32f
GM
54#include <sys/types.h>
55#include <sys/stat.h>
01f1ba30 56
0505a740 57#if 1 /* Used to be #ifdef EMACS_BITMAP_FILES, but this should always work. */
ef493a27
RS
58#include "bitmaps/gray.xbm"
59#else
dbc4e1c1 60#include <X11/bitmaps/gray>
ef493a27 61#endif
dbc4e1c1 62
1b9ac145
AS
63#include "xsettings.h"
64
488dd4c4
JD
65#ifdef USE_GTK
66#include "gtkutil.h"
67#endif
68
9ef48a9d
RS
69#ifdef USE_X_TOOLKIT
70#include <X11/Shell.h>
71
398ffa92 72#ifndef USE_MOTIF
8ab9202e
CY
73#ifdef HAVE_XAW3D
74#include <X11/Xaw3d/Paned.h>
a6ec6cfb 75#include <X11/Xaw3d/Label.h>
8ab9202e 76#else /* !HAVE_XAW3D */
9ef48a9d
RS
77#include <X11/Xaw/Paned.h>
78#include <X11/Xaw/Label.h>
8ab9202e 79#endif /* HAVE_XAW3D */
398ffa92 80#endif /* USE_MOTIF */
9ef48a9d
RS
81
82#ifdef USG
83#undef USG /* ####KLUDGE for Solaris 2.2 and up */
84#include <X11/Xos.h>
85#define USG
dc5ddd85
PE
86#ifdef USG /* Pacify gcc -Wunused-macros. */
87#endif
9ef48a9d
RS
88#else
89#include <X11/Xos.h>
90#endif
91
92#include "widget.h"
93
94#include "../lwlib/lwlib.h"
95
333b20bb
GM
96#ifdef USE_MOTIF
97#include <Xm/Xm.h>
98#include <Xm/DialogS.h>
99#include <Xm/FileSB.h>
dee186b6
J
100#include <Xm/List.h>
101#include <Xm/TextF.h>
333b20bb
GM
102#endif
103
eec47d6b
DN
104#ifdef USE_LUCID
105#include "../lwlib/xlwmenu.h"
106#endif
107
ee6bacd4 108#if !defined(NO_EDITRES)
6c32dd68 109#define HACK_EDITRES
764430a3 110extern void _XEditResCheckMessages (Widget, XtPointer, XEvent *, Boolean *);
ee6bacd4 111#endif /* not defined NO_EDITRES */
6c32dd68 112
333b20bb
GM
113/* Unique id counter for widgets created by the Lucid Widget Library. */
114
6c32dd68
PR
115extern LWLIB_ID widget_id_tick;
116
fc2cdd9a
GM
117#ifdef USE_MOTIF
118
fc2cdd9a
GM
119#endif /* USE_MOTIF */
120
9ef48a9d
RS
121#endif /* USE_X_TOOLKIT */
122
6b61353c
KH
123#ifdef USE_GTK
124
6b61353c
KH
125#endif /* USE_GTK */
126
9d317b2c 127#define MAXREQUEST(dpy) (XMaxRequestSize (dpy))
9d317b2c 128
333b20bb
GM
129/* The gray bitmap `bitmaps/gray'. This is done because xterm.c uses
130 it, and including `bitmaps/gray' more than once is a problem when
131 config.h defines `static' as an empty replacement string. */
132
133int gray_bitmap_width = gray_width;
134int gray_bitmap_height = gray_height;
62906360 135char *gray_bitmap_bits = gray_bits;
333b20bb 136
b9dc4443 137/* Nonzero if using X. */
333b20bb 138
b9dc4443 139static int x_in_use;
01f1ba30 140
955cbe7b
PE
141static Lisp_Object Qnone;
142static Lisp_Object Qsuppress_icon;
143static Lisp_Object Qundefined_color;
144static Lisp_Object Qcompound_text, Qcancel_timer;
581e51e8 145Lisp_Object Qfont_param;
01f1ba30 146
f1d2ce7f 147#if GLYPH_DEBUG
eaf1eea9
GM
148int image_cache_refcount, dpyinfo_refcount;
149#endif
150
e0ab5fcf 151#if defined (USE_GTK) && defined (HAVE_FREETYPE)
e4cebfca 152static char *x_last_font_name;
e0ab5fcf 153#endif
eaf1eea9 154
e4cebfca
PE
155static struct x_display_info *x_display_info_for_name (Lisp_Object);
156
01f1ba30 157\f
11ae94fe 158/* Error if we are not connected to X. */
333b20bb 159
7fc9de26 160void
971de7fb 161check_x (void)
11ae94fe 162{
b9dc4443 163 if (! x_in_use)
11ae94fe
RS
164 error ("X windows are not in use or not initialized");
165}
166
1c59f5df
RS
167/* Nonzero if we can use mouse menus.
168 You should not call this unless HAVE_MENUS is defined. */
75cc8ee5
RS
169
170int
971de7fb 171have_menus_p (void)
75cc8ee5 172{
b9dc4443
RS
173 return x_in_use;
174}
175
176/* Extract a frame as a FRAME_PTR, defaulting to the selected frame
177 and checking validity for X. */
178
179FRAME_PTR
971de7fb 180check_x_frame (Lisp_Object frame)
b9dc4443
RS
181{
182 FRAME_PTR f;
183
184 if (NILP (frame))
0fe92f72 185 frame = selected_frame;
b7826503 186 CHECK_LIVE_FRAME (frame);
0fe92f72 187 f = XFRAME (frame);
b9dc4443 188 if (! FRAME_X_P (f))
1c59f5df 189 error ("Non-X frame used");
b9dc4443 190 return f;
75cc8ee5
RS
191}
192
7e59217d 193/* Let the user specify an X display with a Lisp object.
708e05dc 194 OBJECT may be nil, a frame or a terminal object.
b9dc4443
RS
195 nil stands for the selected frame--or, if that is not an X frame,
196 the first X display on the list. */
197
7c0d3ed8 198struct x_display_info *
971de7fb 199check_x_display_info (Lisp_Object object)
b9dc4443 200{
8ec8a5ec 201 struct x_display_info *dpyinfo = NULL;
177c0ea7 202
7e59217d 203 if (NILP (object))
b9dc4443 204 {
0fe92f72 205 struct frame *sf = XFRAME (selected_frame);
177c0ea7 206
0fe92f72 207 if (FRAME_X_P (sf) && FRAME_LIVE_P (sf))
8ec8a5ec 208 dpyinfo = FRAME_X_DISPLAY_INFO (sf);
b9dc4443 209 else if (x_display_list != 0)
8ec8a5ec 210 dpyinfo = x_display_list;
b9dc4443
RS
211 else
212 error ("X windows are not in use or not initialized");
213 }
708e05dc 214 else if (TERMINALP (object))
b6660415 215 {
fd0f53a9 216 struct terminal *t = get_terminal (object, 1);
b6660415 217
6ed8eeff 218 if (t->type != output_x_window)
c2982e87 219 error ("Terminal %"pI"d is not an X display", XINT (object));
b6660415 220
6ed8eeff 221 dpyinfo = t->display_info.x;
b6660415 222 }
7e59217d
KL
223 else if (STRINGP (object))
224 dpyinfo = x_display_info_for_name (object);
b9dc4443
RS
225 else
226 {
7e59217d 227 FRAME_PTR f = check_x_frame (object);
8ec8a5ec 228 dpyinfo = FRAME_X_DISPLAY_INFO (f);
b9dc4443 229 }
8ec8a5ec
GM
230
231 return dpyinfo;
b9dc4443 232}
333b20bb 233
b9dc4443 234\f
f676886a
JB
235/* Return the Emacs frame-object corresponding to an X window.
236 It could be the frame's main window or an icon window. */
01f1ba30 237
34ca5317 238/* This function can be called during GC, so use GC_xxx type test macros. */
bcb2db92 239
f676886a 240struct frame *
971de7fb 241x_window_to_frame (struct x_display_info *dpyinfo, int wdesc)
01f1ba30 242{
f676886a
JB
243 Lisp_Object tail, frame;
244 struct frame *f;
01f1ba30 245
10b43ac3
JD
246 if (wdesc == None) return 0;
247
8e50cc2d 248 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
01f1ba30 249 {
8e713be6 250 frame = XCAR (tail);
8e50cc2d 251 if (!FRAMEP (frame))
01f1ba30 252 continue;
f676886a 253 f = XFRAME (frame);
2d764c78 254 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
2d271e2e 255 continue;
0af913d7 256 if (f->output_data.x->hourglass_window == wdesc)
17cbbf95 257 return f;
9ef48a9d 258#ifdef USE_X_TOOLKIT
177c0ea7 259 if ((f->output_data.x->edit_widget
7556890b 260 && XtWindow (f->output_data.x->edit_widget) == wdesc)
333b20bb
GM
261 /* A tooltip frame? */
262 || (!f->output_data.x->edit_widget
263 && FRAME_X_WINDOW (f) == wdesc)
7556890b 264 || f->output_data.x->icon_desc == wdesc)
9ef48a9d
RS
265 return f;
266#else /* not USE_X_TOOLKIT */
488dd4c4
JD
267#ifdef USE_GTK
268 if (f->output_data.x->edit_widget)
269 {
6b61353c 270 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
488dd4c4
JD
271 struct x_output *x = f->output_data.x;
272 if (gwdesc != 0 && gwdesc == x->edit_widget)
273 return f;
274 }
275#endif /* USE_GTK */
fe24a618 276 if (FRAME_X_WINDOW (f) == wdesc
7556890b 277 || f->output_data.x->icon_desc == wdesc)
f676886a 278 return f;
9ef48a9d
RS
279#endif /* not USE_X_TOOLKIT */
280 }
281 return 0;
282}
283
488dd4c4 284#if defined (USE_X_TOOLKIT) || defined (USE_GTK)
9ef48a9d
RS
285/* Like x_window_to_frame but also compares the window with the widget's
286 windows. */
287
288struct frame *
971de7fb 289x_any_window_to_frame (struct x_display_info *dpyinfo, int wdesc)
9ef48a9d
RS
290{
291 Lisp_Object tail, frame;
17cbbf95 292 struct frame *f, *found;
7556890b 293 struct x_output *x;
9ef48a9d 294
10b43ac3
JD
295 if (wdesc == None) return NULL;
296
17cbbf95 297 found = NULL;
8e50cc2d 298 for (tail = Vframe_list; CONSP (tail) && !found; tail = XCDR (tail))
9ef48a9d 299 {
8e713be6 300 frame = XCAR (tail);
8e50cc2d 301 if (!FRAMEP (frame))
9ef48a9d 302 continue;
177c0ea7 303
9ef48a9d 304 f = XFRAME (frame);
17cbbf95 305 if (FRAME_X_P (f) && FRAME_X_DISPLAY_INFO (f) == dpyinfo)
333b20bb 306 {
17cbbf95
GM
307 /* This frame matches if the window is any of its widgets. */
308 x = f->output_data.x;
0af913d7 309 if (x->hourglass_window == wdesc)
17cbbf95
GM
310 found = f;
311 else if (x->widget)
312 {
488dd4c4 313#ifdef USE_GTK
6b61353c 314 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
488dd4c4 315 if (gwdesc != 0
a54fa5b7 316 && gtk_widget_get_toplevel (gwdesc) == x->widget)
488dd4c4
JD
317 found = f;
318#else
177c0ea7
JB
319 if (wdesc == XtWindow (x->widget)
320 || wdesc == XtWindow (x->column_widget)
17cbbf95
GM
321 || wdesc == XtWindow (x->edit_widget))
322 found = f;
323 /* Match if the window is this frame's menubar. */
324 else if (lw_window_is_in_menubar (wdesc, x->menubar_widget))
325 found = f;
488dd4c4 326#endif
17cbbf95
GM
327 }
328 else if (FRAME_X_WINDOW (f) == wdesc)
329 /* A tooltip frame. */
330 found = f;
333b20bb 331 }
01f1ba30 332 }
177c0ea7 333
17cbbf95 334 return found;
01f1ba30 335}
5e65b9ab 336
fd3a3022
RS
337/* Likewise, but consider only the menu bar widget. */
338
339struct frame *
fea9cabd 340x_menubar_window_to_frame (struct x_display_info *dpyinfo, XEvent *event)
fd3a3022 341{
b78f9767 342 Window wdesc = event->xany.window;
fd3a3022
RS
343 Lisp_Object tail, frame;
344 struct frame *f;
7556890b 345 struct x_output *x;
fd3a3022 346
10b43ac3
JD
347 if (wdesc == None) return 0;
348
8e50cc2d 349 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
fd3a3022 350 {
8e713be6 351 frame = XCAR (tail);
8e50cc2d 352 if (!FRAMEP (frame))
fd3a3022
RS
353 continue;
354 f = XFRAME (frame);
2d764c78 355 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
fd3a3022 356 continue;
7556890b 357 x = f->output_data.x;
488dd4c4 358#ifdef USE_GTK
b78f9767
J
359 if (x->menubar_widget && xg_event_is_for_menubar (f, event))
360 return f;
488dd4c4 361#else
b78f9767 362 /* Match if the window is this frame's menubar. */
333b20bb
GM
363 if (x->menubar_widget
364 && lw_window_is_in_menubar (wdesc, x->menubar_widget))
fd3a3022 365 return f;
488dd4c4 366#endif
fd3a3022
RS
367 }
368 return 0;
369}
370
5e65b9ab
RS
371/* Return the frame whose principal (outermost) window is WDESC.
372 If WDESC is some other (smaller) window, we return 0. */
373
374struct frame *
971de7fb 375x_top_window_to_frame (struct x_display_info *dpyinfo, int wdesc)
5e65b9ab
RS
376{
377 Lisp_Object tail, frame;
378 struct frame *f;
7556890b 379 struct x_output *x;
5e65b9ab 380
10b43ac3
JD
381 if (wdesc == None) return 0;
382
8e50cc2d 383 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
5e65b9ab 384 {
8e713be6 385 frame = XCAR (tail);
8e50cc2d 386 if (!FRAMEP (frame))
5e65b9ab
RS
387 continue;
388 f = XFRAME (frame);
2d764c78 389 if (!FRAME_X_P (f) || FRAME_X_DISPLAY_INFO (f) != dpyinfo)
2d271e2e 390 continue;
7556890b 391 x = f->output_data.x;
333b20bb
GM
392
393 if (x->widget)
394 {
395 /* This frame matches if the window is its topmost widget. */
488dd4c4 396#ifdef USE_GTK
6b61353c 397 GtkWidget *gwdesc = xg_win_to_widget (dpyinfo->display, wdesc);
488dd4c4
JD
398 if (gwdesc == x->widget)
399 return f;
400#else
333b20bb
GM
401 if (wdesc == XtWindow (x->widget))
402 return f;
7a994728
KH
403#if 0 /* I don't know why it did this,
404 but it seems logically wrong,
405 and it causes trouble for MapNotify events. */
333b20bb 406 /* Match if the window is this frame's menubar. */
177c0ea7 407 if (x->menubar_widget
333b20bb
GM
408 && wdesc == XtWindow (x->menubar_widget))
409 return f;
488dd4c4 410#endif
7a994728 411#endif
333b20bb
GM
412 }
413 else if (FRAME_X_WINDOW (f) == wdesc)
414 /* Tooltip frame. */
415 return f;
5e65b9ab
RS
416 }
417 return 0;
418}
488dd4c4 419#endif /* USE_X_TOOLKIT || USE_GTK */
01f1ba30 420
01f1ba30 421\f
203c1d73 422
08a90d6a 423/* Store the screen positions of frame F into XPTR and YPTR.
e9445337
RS
424 These are the positions of the containing window manager window,
425 not Emacs's own window. */
426
427void
971de7fb 428x_real_positions (FRAME_PTR f, int *xptr, int *yptr)
e9445337 429{
8ffc96f5 430 int win_x, win_y, outer_x IF_LINT (= 0), outer_y IF_LINT (= 0);
49d41073
EZ
431 int real_x = 0, real_y = 0;
432 int had_errors = 0;
433 Window win = f->output_data.x->parent_desc;
d75c9992
JD
434 Atom actual_type;
435 unsigned long actual_size, bytes_remaining;
06b0c8a0 436 int rc, actual_format;
d75c9992
JD
437 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
438 long max_len = 400;
439 Display *dpy = FRAME_X_DISPLAY (f);
440 unsigned char *tmp_data = NULL;
441 Atom target_type = XA_CARDINAL;
e9445337 442
49d41073
EZ
443 BLOCK_INPUT;
444
d75c9992 445 x_catch_errors (dpy);
043835a3 446
31887d45 447 if (win == dpyinfo->root_window)
49d41073
EZ
448 win = FRAME_OUTER_WINDOW (f);
449
450 /* This loop traverses up the containment tree until we hit the root
451 window. Window managers may intersect many windows between our window
452 and the root window. The window we find just before the root window
453 should be the outer WM window. */
454 for (;;)
e9445337 455 {
49d41073
EZ
456 Window wm_window, rootw;
457 Window *tmp_children;
458 unsigned int tmp_nchildren;
e7161ad9 459 int success;
ca7bac79 460
e7161ad9
RS
461 success = XQueryTree (FRAME_X_DISPLAY (f), win, &rootw,
462 &wm_window, &tmp_children, &tmp_nchildren);
08a90d6a 463
49d41073 464 had_errors = x_had_errors_p (FRAME_X_DISPLAY (f));
08a90d6a 465
e7161ad9
RS
466 /* Don't free tmp_children if XQueryTree failed. */
467 if (! success)
468 break;
469
470 XFree ((char *) tmp_children);
471
49d41073
EZ
472 if (wm_window == rootw || had_errors)
473 break;
08a90d6a 474
49d41073
EZ
475 win = wm_window;
476 }
177c0ea7 477
49d41073
EZ
478 if (! had_errors)
479 {
47c53789 480 unsigned int ign;
49d41073 481 Window child, rootw;
177c0ea7 482
49d41073
EZ
483 /* Get the real coordinates for the WM window upper left corner */
484 XGetGeometry (FRAME_X_DISPLAY (f), win,
485 &rootw, &real_x, &real_y, &ign, &ign, &ign, &ign);
486
487 /* Translate real coordinates to coordinates relative to our
488 window. For our window, the upper left corner is 0, 0.
489 Since the upper left corner of the WM window is outside
490 our window, win_x and win_y will be negative:
491
492 ------------------ ---> x
493 | title |
494 | ----------------- v y
495 | | our window
496 */
8a07bba0 497 XTranslateCoordinates (FRAME_X_DISPLAY (f),
e9445337 498
8a07bba0 499 /* From-window, to-window. */
8a07bba0 500 FRAME_X_DISPLAY_INFO (f)->root_window,
49d41073 501 FRAME_X_WINDOW (f),
e9445337 502
8a07bba0 503 /* From-position, to-position. */
49d41073 504 real_x, real_y, &win_x, &win_y,
08a90d6a 505
8a07bba0
RS
506 /* Child of win. */
507 &child);
e9445337 508
49d41073 509 if (FRAME_X_WINDOW (f) == FRAME_OUTER_WINDOW (f))
845e9d85 510 {
49d41073
EZ
511 outer_x = win_x;
512 outer_y = win_y;
845e9d85 513 }
49d41073
EZ
514 else
515 {
516 XTranslateCoordinates (FRAME_X_DISPLAY (f),
ca7bac79 517
49d41073
EZ
518 /* From-window, to-window. */
519 FRAME_X_DISPLAY_INFO (f)->root_window,
520 FRAME_OUTER_WINDOW (f),
177c0ea7 521
49d41073
EZ
522 /* From-position, to-position. */
523 real_x, real_y, &outer_x, &outer_y,
177c0ea7 524
49d41073
EZ
525 /* Child of win. */
526 &child);
be786000 527 }
08a90d6a 528
49d41073
EZ
529 had_errors = x_had_errors_p (FRAME_X_DISPLAY (f));
530 }
177c0ea7 531
31887d45
JD
532
533 if (dpyinfo->root_window == f->output_data.x->parent_desc)
534 {
535 /* Try _NET_FRAME_EXTENTS if our parent is the root window. */
536 rc = XGetWindowProperty (dpy, win, dpyinfo->Xatom_net_frame_extents,
537 0, max_len, False, target_type,
538 &actual_type, &actual_format, &actual_size,
539 &bytes_remaining, &tmp_data);
540
541 if (rc == Success && actual_type == target_type && !x_had_errors_p (dpy)
542 && actual_size == 4 && actual_format == 32)
543 {
717c30e0 544 unsigned int ign;
31887d45 545 Window rootw;
c0098065 546 long *fe = (long *)tmp_data;
31887d45
JD
547
548 XGetGeometry (FRAME_X_DISPLAY (f), win,
549 &rootw, &real_x, &real_y, &ign, &ign, &ign, &ign);
31887d45
JD
550 outer_x = -fe[0];
551 outer_y = -fe[2];
552 real_x -= fe[0];
553 real_y -= fe[2];
554 }
555 }
556
557 if (tmp_data) XFree (tmp_data);
558
4545fa20 559 x_uncatch_errors ();
177c0ea7 560
49d41073
EZ
561 UNBLOCK_INPUT;
562
563 if (had_errors) return;
177c0ea7 564
be786000
KS
565 f->x_pixels_diff = -win_x;
566 f->y_pixels_diff = -win_y;
567
568 FRAME_X_OUTPUT (f)->x_pixels_outer_diff = -outer_x;
569 FRAME_X_OUTPUT (f)->y_pixels_outer_diff = -outer_y;
49d41073
EZ
570
571 *xptr = real_x;
572 *yptr = real_y;
e9445337
RS
573}
574
01f1ba30 575\f
82978295 576
d62c8769
GM
577
578/* Gamma-correct COLOR on frame F. */
579
580void
971de7fb 581gamma_correct (struct frame *f, XColor *color)
d62c8769
GM
582{
583 if (f->gamma)
584 {
585 color->red = pow (color->red / 65535.0, f->gamma) * 65535.0 + 0.5;
586 color->green = pow (color->green / 65535.0, f->gamma) * 65535.0 + 0.5;
587 color->blue = pow (color->blue / 65535.0, f->gamma) * 65535.0 + 0.5;
588 }
589}
590
591
7b746c38
GM
592/* Decide if color named COLOR_NAME is valid for use on frame F. If
593 so, return the RGB values in COLOR. If ALLOC_P is non-zero,
594 allocate the color. Value is zero if COLOR_NAME is invalid, or
595 no color could be allocated. */
e12d55b2 596
01f1ba30 597int
eec47d6b
DN
598x_defined_color (struct frame *f, const char *color_name,
599 XColor *color, int alloc_p)
01f1ba30 600{
3a46642b 601 int success_p = 0;
7b746c38
GM
602 Display *dpy = FRAME_X_DISPLAY (f);
603 Colormap cmap = FRAME_X_COLORMAP (f);
01f1ba30
JB
604
605 BLOCK_INPUT;
3a46642b
J
606#ifdef USE_GTK
607 success_p = xg_check_special_colors (f, color_name, color);
608#endif
609 if (!success_p)
610 success_p = XParseColor (dpy, cmap, color_name, color);
7b746c38
GM
611 if (success_p && alloc_p)
612 success_p = x_alloc_nearest_color (f, cmap, color);
01f1ba30
JB
613 UNBLOCK_INPUT;
614
7b746c38 615 return success_p;
01f1ba30
JB
616}
617
9b2956e2
GM
618
619/* Return the pixel color value for color COLOR_NAME on frame F. If F
620 is a monochrome frame, return MONO_COLOR regardless of what ARG says.
621 Signal an error if color can't be allocated. */
01f1ba30 622
f78faa98 623static int
971de7fb 624x_decode_color (FRAME_PTR f, Lisp_Object color_name, int mono_color)
01f1ba30 625{
b9dc4443 626 XColor cdef;
01f1ba30 627
b7826503 628 CHECK_STRING (color_name);
01f1ba30 629
9b2956e2
GM
630#if 0 /* Don't do this. It's wrong when we're not using the default
631 colormap, it makes freeing difficult, and it's probably not
632 an important optimization. */
d5db4077 633 if (strcmp (SDATA (color_name), "black") == 0)
b9dc4443 634 return BLACK_PIX_DEFAULT (f);
d5db4077 635 else if (strcmp (SDATA (color_name), "white") == 0)
b9dc4443 636 return WHITE_PIX_DEFAULT (f);
9b2956e2 637#endif
01f1ba30 638
9b2956e2 639 /* Return MONO_COLOR for monochrome frames. */
b9dc4443 640 if (FRAME_X_DISPLAY_INFO (f)->n_planes == 1)
9b2956e2 641 return mono_color;
01f1ba30 642
2d764c78 643 /* x_defined_color is responsible for coping with failures
95626e11 644 by looking for a near-miss. */
42a5b22f 645 if (x_defined_color (f, SSDATA (color_name), &cdef, 1))
95626e11
RS
646 return cdef.pixel;
647
93217cef 648 signal_error ("Undefined color", color_name);
01f1ba30 649}
9b2956e2
GM
650
651
01f1ba30 652\f
ea0a1f53
GM
653/* Change the `wait-for-wm' frame parameter of frame F. OLD_VALUE is
654 the previous value of that parameter, NEW_VALUE is the new value.
655 See also the comment of wait_for_wm in struct x_output. */
656
657static void
971de7fb 658x_set_wait_for_wm (struct frame *f, Lisp_Object new_value, Lisp_Object old_value)
ea0a1f53
GM
659{
660 f->output_data.x->wait_for_wm = !NILP (new_value);
661}
662
bfeabdc3
JD
663static void
664x_set_tool_bar_position (struct frame *f,
665 Lisp_Object new_value,
666 Lisp_Object old_value)
667{
668 if (! EQ (new_value, Qleft) && ! EQ (new_value, Qright)
669 && ! EQ (new_value, Qbottom) && ! EQ (new_value, Qtop))
670 return;
671 if (EQ (new_value, old_value)) return;
672
673#ifdef USE_GTK
717c30e0 674 if (xg_change_toolbar_position (f, new_value))
bfeabdc3
JD
675 f->tool_bar_position = new_value;
676#endif
677}
678
993d0721
JB
679#ifdef USE_GTK
680
465aa50a
JD
681/* Set icon from FILE for frame F. By using GTK functions the icon
682 may be any format that GdkPixbuf knows about, i.e. not just bitmaps. */
993d0721
JB
683
684int
971de7fb 685xg_set_icon (FRAME_PTR f, Lisp_Object file)
993d0721 686{
465aa50a
JD
687 int result = 0;
688 Lisp_Object found;
993d0721 689
465aa50a
JD
690 found = x_find_image_file (file);
691
692 if (! NILP (found))
693 {
694 GdkPixbuf *pixbuf;
695 GError *err = NULL;
51b59d79 696 char *filename = SSDATA (found);
465aa50a
JD
697 BLOCK_INPUT;
698
699 pixbuf = gdk_pixbuf_new_from_file (filename, &err);
700
701 if (pixbuf)
702 {
703 gtk_window_set_icon (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)),
704 pixbuf);
705 g_object_unref (pixbuf);
706
707 result = 1;
708 }
709 else
710 g_error_free (err);
711
712 UNBLOCK_INPUT;
713 }
714
465aa50a 715 return result;
993d0721 716}
9f7b984b
CY
717
718int
648801d1 719xg_set_icon_from_xpm_data (FRAME_PTR f, const char **data)
9f7b984b 720{
648801d1 721 GdkPixbuf *pixbuf = gdk_pixbuf_new_from_xpm_data (data);
9f7b984b
CY
722
723 if (!pixbuf)
47c53789 724 return 0;
9f7b984b 725
47c53789 726 gtk_window_set_icon (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)), pixbuf);
9f7b984b
CY
727 g_object_unref (pixbuf);
728 return 1;
729}
993d0721
JB
730#endif /* USE_GTK */
731
ea0a1f53 732
f676886a 733/* Functions called only from `x_set_frame_param'
01f1ba30
JB
734 to set individual parameters.
735
fe24a618 736 If FRAME_X_WINDOW (f) is 0,
f676886a 737 the frame is being created and its X-window does not exist yet.
01f1ba30
JB
738 In that case, just record the parameter's new value
739 in the standard place; do not attempt to change the window. */
740
e4cebfca 741static void
971de7fb 742x_set_foreground_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
01f1ba30 743{
09393d07
GM
744 struct x_output *x = f->output_data.x;
745 unsigned long fg, old_fg;
a76206dc 746
09393d07 747 fg = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
ce593f6e
KL
748 old_fg = FRAME_FOREGROUND_PIXEL (f);
749 FRAME_FOREGROUND_PIXEL (f) = fg;
a76206dc 750
fe24a618 751 if (FRAME_X_WINDOW (f) != 0)
01f1ba30 752 {
09393d07 753 Display *dpy = FRAME_X_DISPLAY (f);
177c0ea7 754
09393d07
GM
755 BLOCK_INPUT;
756 XSetForeground (dpy, x->normal_gc, fg);
757 XSetBackground (dpy, x->reverse_gc, fg);
36d42089 758
09393d07
GM
759 if (x->cursor_pixel == old_fg)
760 {
761 unload_color (f, x->cursor_pixel);
762 x->cursor_pixel = x_copy_color (f, fg);
763 XSetBackground (dpy, x->cursor_gc, x->cursor_pixel);
764 }
177c0ea7 765
01f1ba30 766 UNBLOCK_INPUT;
177c0ea7 767
05c8abbe 768 update_face_from_frame_parameter (f, Qforeground_color, arg);
177c0ea7 769
179956b9 770 if (FRAME_VISIBLE_P (f))
f676886a 771 redraw_frame (f);
01f1ba30 772 }
177c0ea7 773
09393d07 774 unload_color (f, old_fg);
01f1ba30
JB
775}
776
e4cebfca 777static void
971de7fb 778x_set_background_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
01f1ba30 779{
09393d07
GM
780 struct x_output *x = f->output_data.x;
781 unsigned long bg;
01f1ba30 782
09393d07 783 bg = x_decode_color (f, arg, WHITE_PIX_DEFAULT (f));
ce593f6e
KL
784 unload_color (f, FRAME_BACKGROUND_PIXEL (f));
785 FRAME_BACKGROUND_PIXEL (f) = bg;
a76206dc 786
fe24a618 787 if (FRAME_X_WINDOW (f) != 0)
01f1ba30 788 {
09393d07 789 Display *dpy = FRAME_X_DISPLAY (f);
177c0ea7 790
09393d07
GM
791 BLOCK_INPUT;
792 XSetBackground (dpy, x->normal_gc, bg);
793 XSetForeground (dpy, x->reverse_gc, bg);
794 XSetWindowBackground (dpy, FRAME_X_WINDOW (f), bg);
795 XSetForeground (dpy, x->cursor_gc, bg);
796
488dd4c4
JD
797#ifdef USE_GTK
798 xg_set_background_color (f, bg);
799#endif
800
f76e0368
GM
801#ifndef USE_TOOLKIT_SCROLL_BARS /* Turns out to be annoying with
802 toolkit scroll bars. */
803 {
804 Lisp_Object bar;
805 for (bar = FRAME_SCROLL_BARS (f);
806 !NILP (bar);
807 bar = XSCROLL_BAR (bar)->next)
808 {
056ce195 809 Window window = XSCROLL_BAR (bar)->x_window;
f76e0368
GM
810 XSetWindowBackground (dpy, window, bg);
811 }
812 }
813#endif /* USE_TOOLKIT_SCROLL_BARS */
01f1ba30 814
09393d07 815 UNBLOCK_INPUT;
05c8abbe 816 update_face_from_frame_parameter (f, Qbackground_color, arg);
ea96210c 817
179956b9 818 if (FRAME_VISIBLE_P (f))
f676886a 819 redraw_frame (f);
01f1ba30
JB
820 }
821}
822
e044e4fc 823static Cursor
971de7fb 824make_invisible_cursor (struct frame *f)
e044e4fc
JD
825{
826 Display *dpy = FRAME_X_DISPLAY (f);
827 static char const no_data[] = { 0 };
828 Pixmap pix;
829 XColor col;
8664db06 830 Cursor c = 0;
e044e4fc
JD
831
832 x_catch_errors (dpy);
833 pix = XCreateBitmapFromData (dpy, FRAME_X_DISPLAY_INFO (f)->root_window,
834 no_data, 1, 1);
835 if (! x_had_errors_p (dpy) && pix != None)
836 {
8664db06 837 Cursor pixc;
e044e4fc
JD
838 col.pixel = 0;
839 col.red = col.green = col.blue = 0;
840 col.flags = DoRed | DoGreen | DoBlue;
8664db06
PE
841 pixc = XCreatePixmapCursor (dpy, pix, pix, &col, &col, 0, 0);
842 if (! x_had_errors_p (dpy) && pixc != None)
843 c = pixc;
e044e4fc
JD
844 XFreePixmap (dpy, pix);
845 }
846
847 x_uncatch_errors ();
848
849 return c;
850}
851
e4cebfca 852static void
971de7fb 853x_set_mouse_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
01f1ba30 854{
09393d07
GM
855 struct x_output *x = f->output_data.x;
856 Display *dpy = FRAME_X_DISPLAY (f);
3d970f28 857 Cursor cursor, nontext_cursor, mode_cursor, hand_cursor;
0af913d7 858 Cursor hourglass_cursor, horizontal_drag_cursor;
51a1d2d8 859 unsigned long pixel = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
ce593f6e 860 unsigned long mask_color = FRAME_BACKGROUND_PIXEL (f);
a76206dc 861
51a1d2d8 862 /* Don't let pointers be invisible. */
09393d07 863 if (mask_color == pixel)
bcf26b38
GM
864 {
865 x_free_colors (f, &pixel, 1);
ce593f6e 866 pixel = x_copy_color (f, FRAME_FOREGROUND_PIXEL (f));
bcf26b38 867 }
a76206dc 868
09393d07
GM
869 unload_color (f, x->mouse_pixel);
870 x->mouse_pixel = pixel;
01f1ba30
JB
871
872 BLOCK_INPUT;
fe24a618 873
eb8c3be9 874 /* It's not okay to crash if the user selects a screwy cursor. */
9ba8e10d 875 x_catch_errors (dpy);
fe24a618 876
09393d07 877 if (!NILP (Vx_pointer_shape))
01f1ba30 878 {
b7826503 879 CHECK_NUMBER (Vx_pointer_shape);
09393d07 880 cursor = XCreateFontCursor (dpy, XINT (Vx_pointer_shape));
01f1ba30
JB
881 }
882 else
09393d07
GM
883 cursor = XCreateFontCursor (dpy, XC_xterm);
884 x_check_errors (dpy, "bad text pointer cursor: %s");
01f1ba30 885
09393d07 886 if (!NILP (Vx_nontext_pointer_shape))
01f1ba30 887 {
b7826503 888 CHECK_NUMBER (Vx_nontext_pointer_shape);
09393d07
GM
889 nontext_cursor
890 = XCreateFontCursor (dpy, XINT (Vx_nontext_pointer_shape));
01f1ba30
JB
891 }
892 else
09393d07
GM
893 nontext_cursor = XCreateFontCursor (dpy, XC_left_ptr);
894 x_check_errors (dpy, "bad nontext pointer cursor: %s");
01f1ba30 895
09393d07 896 if (!NILP (Vx_hourglass_pointer_shape))
333b20bb 897 {
b7826503 898 CHECK_NUMBER (Vx_hourglass_pointer_shape);
09393d07
GM
899 hourglass_cursor
900 = XCreateFontCursor (dpy, XINT (Vx_hourglass_pointer_shape));
333b20bb
GM
901 }
902 else
09393d07
GM
903 hourglass_cursor = XCreateFontCursor (dpy, XC_watch);
904 x_check_errors (dpy, "bad hourglass pointer cursor: %s");
177c0ea7 905
09393d07 906 if (!NILP (Vx_mode_pointer_shape))
01f1ba30 907 {
b7826503 908 CHECK_NUMBER (Vx_mode_pointer_shape);
09393d07 909 mode_cursor = XCreateFontCursor (dpy, XINT (Vx_mode_pointer_shape));
01f1ba30
JB
910 }
911 else
09393d07
GM
912 mode_cursor = XCreateFontCursor (dpy, XC_xterm);
913 x_check_errors (dpy, "bad modeline pointer cursor: %s");
95f80c78 914
09393d07 915 if (!NILP (Vx_sensitive_text_pointer_shape))
95f80c78 916 {
b7826503 917 CHECK_NUMBER (Vx_sensitive_text_pointer_shape);
3d970f28 918 hand_cursor
09393d07 919 = XCreateFontCursor (dpy, XINT (Vx_sensitive_text_pointer_shape));
95f80c78
FP
920 }
921 else
3d970f28 922 hand_cursor = XCreateFontCursor (dpy, XC_hand2);
01f1ba30 923
8fb4ec9c
GM
924 if (!NILP (Vx_window_horizontal_drag_shape))
925 {
b7826503 926 CHECK_NUMBER (Vx_window_horizontal_drag_shape);
8fb4ec9c 927 horizontal_drag_cursor
09393d07 928 = XCreateFontCursor (dpy, XINT (Vx_window_horizontal_drag_shape));
8fb4ec9c
GM
929 }
930 else
931 horizontal_drag_cursor
09393d07 932 = XCreateFontCursor (dpy, XC_sb_h_double_arrow);
8fb4ec9c 933
fe24a618 934 /* Check and report errors with the above calls. */
09393d07 935 x_check_errors (dpy, "can't set cursor shape: %s");
4545fa20 936 x_uncatch_errors ();
fe24a618 937
01f1ba30
JB
938 {
939 XColor fore_color, back_color;
940
09393d07 941 fore_color.pixel = x->mouse_pixel;
a31fedb7 942 x_query_color (f, &fore_color);
01f1ba30 943 back_color.pixel = mask_color;
a31fedb7 944 x_query_color (f, &back_color);
177c0ea7 945
09393d07
GM
946 XRecolorCursor (dpy, cursor, &fore_color, &back_color);
947 XRecolorCursor (dpy, nontext_cursor, &fore_color, &back_color);
948 XRecolorCursor (dpy, mode_cursor, &fore_color, &back_color);
3d970f28 949 XRecolorCursor (dpy, hand_cursor, &fore_color, &back_color);
09393d07
GM
950 XRecolorCursor (dpy, hourglass_cursor, &fore_color, &back_color);
951 XRecolorCursor (dpy, horizontal_drag_cursor, &fore_color, &back_color);
01f1ba30 952 }
01f1ba30 953
fe24a618 954 if (FRAME_X_WINDOW (f) != 0)
e044e4fc
JD
955 XDefineCursor (dpy, FRAME_X_WINDOW (f),
956 f->output_data.x->current_cursor = cursor);
09393d07 957
e044e4fc
JD
958 if (FRAME_X_DISPLAY_INFO (f)->invisible_cursor == 0)
959 FRAME_X_DISPLAY_INFO (f)->invisible_cursor = make_invisible_cursor (f);
f5f6c0e0 960
09393d07
GM
961 if (cursor != x->text_cursor
962 && x->text_cursor != 0)
963 XFreeCursor (dpy, x->text_cursor);
964 x->text_cursor = cursor;
965
966 if (nontext_cursor != x->nontext_cursor
967 && x->nontext_cursor != 0)
968 XFreeCursor (dpy, x->nontext_cursor);
969 x->nontext_cursor = nontext_cursor;
970
971 if (hourglass_cursor != x->hourglass_cursor
972 && x->hourglass_cursor != 0)
973 XFreeCursor (dpy, x->hourglass_cursor);
974 x->hourglass_cursor = hourglass_cursor;
975
976 if (mode_cursor != x->modeline_cursor
977 && x->modeline_cursor != 0)
978 XFreeCursor (dpy, f->output_data.x->modeline_cursor);
979 x->modeline_cursor = mode_cursor;
177c0ea7 980
3d970f28
KS
981 if (hand_cursor != x->hand_cursor
982 && x->hand_cursor != 0)
983 XFreeCursor (dpy, x->hand_cursor);
984 x->hand_cursor = hand_cursor;
01f1ba30 985
09393d07
GM
986 if (horizontal_drag_cursor != x->horizontal_drag_cursor
987 && x->horizontal_drag_cursor != 0)
988 XFreeCursor (dpy, x->horizontal_drag_cursor);
989 x->horizontal_drag_cursor = horizontal_drag_cursor;
8fb4ec9c 990
09393d07 991 XFlush (dpy);
01f1ba30 992 UNBLOCK_INPUT;
05c8abbe
GM
993
994 update_face_from_frame_parameter (f, Qmouse_color, arg);
01f1ba30
JB
995}
996
e4cebfca 997static void
971de7fb 998x_set_cursor_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
01f1ba30 999{
a76206dc 1000 unsigned long fore_pixel, pixel;
10168ebb 1001 int fore_pixel_allocated_p = 0, pixel_allocated_p = 0;
09393d07 1002 struct x_output *x = f->output_data.x;
01f1ba30 1003
10168ebb
GM
1004 if (!NILP (Vx_cursor_fore_pixel))
1005 {
1006 fore_pixel = x_decode_color (f, Vx_cursor_fore_pixel,
1007 WHITE_PIX_DEFAULT (f));
1008 fore_pixel_allocated_p = 1;
1009 }
01f1ba30 1010 else
ce593f6e 1011 fore_pixel = FRAME_BACKGROUND_PIXEL (f);
177c0ea7 1012
a76206dc 1013 pixel = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
10168ebb 1014 pixel_allocated_p = 1;
a76206dc 1015
f9942c9e 1016 /* Make sure that the cursor color differs from the background color. */
ce593f6e 1017 if (pixel == FRAME_BACKGROUND_PIXEL (f))
01f1ba30 1018 {
10168ebb
GM
1019 if (pixel_allocated_p)
1020 {
1021 x_free_colors (f, &pixel, 1);
1022 pixel_allocated_p = 0;
1023 }
177c0ea7 1024
09393d07 1025 pixel = x->mouse_pixel;
a76206dc 1026 if (pixel == fore_pixel)
10168ebb
GM
1027 {
1028 if (fore_pixel_allocated_p)
1029 {
1030 x_free_colors (f, &fore_pixel, 1);
1031 fore_pixel_allocated_p = 0;
1032 }
ce593f6e 1033 fore_pixel = FRAME_BACKGROUND_PIXEL (f);
10168ebb 1034 }
01f1ba30 1035 }
a76206dc 1036
09393d07 1037 unload_color (f, x->cursor_foreground_pixel);
10168ebb
GM
1038 if (!fore_pixel_allocated_p)
1039 fore_pixel = x_copy_color (f, fore_pixel);
09393d07 1040 x->cursor_foreground_pixel = fore_pixel;
01f1ba30 1041
09393d07 1042 unload_color (f, x->cursor_pixel);
10168ebb
GM
1043 if (!pixel_allocated_p)
1044 pixel = x_copy_color (f, pixel);
09393d07 1045 x->cursor_pixel = pixel;
a76206dc 1046
fe24a618 1047 if (FRAME_X_WINDOW (f) != 0)
01f1ba30 1048 {
01f1ba30 1049 BLOCK_INPUT;
09393d07
GM
1050 XSetBackground (FRAME_X_DISPLAY (f), x->cursor_gc, x->cursor_pixel);
1051 XSetForeground (FRAME_X_DISPLAY (f), x->cursor_gc, fore_pixel);
01f1ba30 1052 UNBLOCK_INPUT;
01f1ba30 1053
179956b9 1054 if (FRAME_VISIBLE_P (f))
01f1ba30 1055 {
cedadcfa
RS
1056 x_update_cursor (f, 0);
1057 x_update_cursor (f, 1);
01f1ba30
JB
1058 }
1059 }
05c8abbe
GM
1060
1061 update_face_from_frame_parameter (f, Qcursor_color, arg);
01f1ba30 1062}
943b580d 1063\f
f676886a 1064/* Set the border-color of frame F to pixel value PIX.
01f1ba30 1065 Note that this does not fully take effect if done before
f676886a 1066 F has an x-window. */
01f1ba30 1067
e4cebfca 1068static void
971de7fb 1069x_set_border_pixel (struct frame *f, int pix)
01f1ba30 1070{
a76206dc 1071 unload_color (f, f->output_data.x->border_pixel);
7556890b 1072 f->output_data.x->border_pixel = pix;
01f1ba30 1073
be786000 1074 if (FRAME_X_WINDOW (f) != 0 && f->border_width > 0)
01f1ba30 1075 {
01f1ba30 1076 BLOCK_INPUT;
578c21e6 1077 XSetWindowBorder (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), pix);
01f1ba30
JB
1078 UNBLOCK_INPUT;
1079
179956b9 1080 if (FRAME_VISIBLE_P (f))
f676886a 1081 redraw_frame (f);
01f1ba30
JB
1082 }
1083}
1084
7c0d3ed8
KS
1085/* Set the border-color of frame F to value described by ARG.
1086 ARG can be a string naming a color.
1087 The border-color is used for the border that is drawn by the X server.
1088 Note that this does not fully take effect if done before
1089 F has an x-window; it must be redone when the window is created.
1090
1091 Note: this is done in two routines because of the way X10 works.
1092
1093 Note: under X11, this is normally the province of the window manager,
1094 and so emacs' border colors may be overridden. */
1095
e4cebfca 1096static void
971de7fb 1097x_set_border_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
7c0d3ed8
KS
1098{
1099 int pix;
1100
1101 CHECK_STRING (arg);
1102 pix = x_decode_color (f, arg, BLACK_PIX_DEFAULT (f));
1103 x_set_border_pixel (f, pix);
1104 update_face_from_frame_parameter (f, Qborder_color, arg);
1105}
0d1469d6 1106
0d1469d6 1107
e4cebfca 1108static void
971de7fb 1109x_set_cursor_type (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
0d1469d6 1110{
33b2311e 1111 set_frame_cursor_types (f, arg);
dbc4e1c1 1112
75691005
RS
1113 /* Make sure the cursor gets redrawn. */
1114 cursor_type_changed = 1;
dbc4e1c1 1115}
943b580d 1116\f
e4cebfca 1117static void
971de7fb 1118x_set_icon_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
01f1ba30 1119{
01f1ba30
JB
1120 int result;
1121
203c1d73
RS
1122 if (STRINGP (arg))
1123 {
1124 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
1125 return;
1126 }
1127 else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
01f1ba30
JB
1128 return;
1129
1130 BLOCK_INPUT;
265a9e55 1131 if (NILP (arg))
80534dd6 1132 result = x_text_icon (f,
51b59d79
PE
1133 SSDATA ((!NILP (f->icon_name)
1134 ? f->icon_name
1135 : f->name)));
f1c7b5a6
RS
1136 else
1137 result = x_bitmap_icon (f, arg);
01f1ba30
JB
1138
1139 if (result)
1140 {
01f1ba30 1141 UNBLOCK_INPUT;
0fb53770 1142 error ("No icon window available");
01f1ba30
JB
1143 }
1144
b9dc4443 1145 XFlush (FRAME_X_DISPLAY (f));
01f1ba30
JB
1146 UNBLOCK_INPUT;
1147}
1148
e4cebfca 1149static void
971de7fb 1150x_set_icon_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
80534dd6 1151{
80534dd6
KH
1152 int result;
1153
1154 if (STRINGP (arg))
1155 {
1156 if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
1157 return;
1158 }
56f41f98 1159 else if (!NILP (arg) || NILP (oldval))
80534dd6
KH
1160 return;
1161
f468da95 1162 f->icon_name = arg;
80534dd6 1163
7556890b 1164 if (f->output_data.x->icon_bitmap != 0)
80534dd6
KH
1165 return;
1166
1167 BLOCK_INPUT;
1168
1169 result = x_text_icon (f,
51b59d79
PE
1170 SSDATA ((!NILP (f->icon_name)
1171 ? f->icon_name
1172 : !NILP (f->title)
1173 ? f->title
1174 : f->name)));
80534dd6
KH
1175
1176 if (result)
1177 {
1178 UNBLOCK_INPUT;
1179 error ("No icon window available");
1180 }
1181
80534dd6
KH
1182 XFlush (FRAME_X_DISPLAY (f));
1183 UNBLOCK_INPUT;
1184}
7c0d3ed8 1185
943b580d 1186\f
01f1ba30 1187void
971de7fb 1188x_set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
01f1ba30 1189{
7c0d3ed8 1190 int nlines;
6b61353c 1191#if ! defined (USE_X_TOOLKIT) && ! defined (USE_GTK)
7c0d3ed8
KS
1192 int olines = FRAME_MENU_BAR_LINES (f);
1193#endif
177c0ea7 1194
7c0d3ed8
KS
1195 /* Right now, menu bars don't work properly in minibuf-only frames;
1196 most of the commands try to apply themselves to the minibuffer
1197 frame itself, and get an error because you can't switch buffers
1198 in or split the minibuffer window. */
1199 if (FRAME_MINIBUF_ONLY_P (f))
1200 return;
177c0ea7 1201
7c0d3ed8
KS
1202 if (INTEGERP (value))
1203 nlines = XINT (value);
ea96210c 1204 else
7c0d3ed8 1205 nlines = 0;
a367641f 1206
7c0d3ed8
KS
1207 /* Make sure we redisplay all windows in this frame. */
1208 windows_or_buffers_changed++;
3d09b6be 1209
488dd4c4 1210#if defined (USE_X_TOOLKIT) || defined (USE_GTK)
9ef48a9d
RS
1211 FRAME_MENU_BAR_LINES (f) = 0;
1212 if (nlines)
0d8ef3f4
RS
1213 {
1214 FRAME_EXTERNAL_MENU_BAR (f) = 1;
97a1ff91 1215 if (FRAME_X_P (f) && f->output_data.x->menubar_widget == 0)
0d8ef3f4
RS
1216 /* Make sure next redisplay shows the menu bar. */
1217 XWINDOW (FRAME_SELECTED_WINDOW (f))->update_mode_line = Qt;
1218 }
9ef48a9d
RS
1219 else
1220 {
6bc20398
FP
1221 if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
1222 free_frame_menubar (f);
9ef48a9d 1223 FRAME_EXTERNAL_MENU_BAR (f) = 0;
97a1ff91
RS
1224 if (FRAME_X_P (f))
1225 f->output_data.x->menubar_widget = 0;
9ef48a9d 1226 }
488dd4c4 1227#else /* not USE_X_TOOLKIT && not USE_GTK */
d043f1a4 1228 FRAME_MENU_BAR_LINES (f) = nlines;
562dd5e9 1229 resize_frame_windows (f, FRAME_LINES (f), 0);
1df47e38
YM
1230
1231 /* If the menu bar height gets changed, the internal border below
1232 the top margin has to be cleared. Also, if the menu bar gets
1233 larger, the area for the added lines has to be cleared except for
1234 the first menu bar line that is to be drawn later. */
1235 if (nlines != olines)
1236 {
1237 int height = FRAME_INTERNAL_BORDER_WIDTH (f);
1238 int width = FRAME_PIXEL_WIDTH (f);
1239 int y;
1240
1241 /* height can be zero here. */
1242 if (height > 0 && width > 0)
1243 {
1244 y = FRAME_TOP_MARGIN_HEIGHT (f);
1245
1246 BLOCK_INPUT;
1247 x_clear_area (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1248 0, y, width, height, False);
1249 UNBLOCK_INPUT;
1250 }
1251
1252 if (nlines > 1 && nlines > olines)
1253 {
1254 y = (olines == 0 ? 1 : olines) * FRAME_LINE_HEIGHT (f);
1255 height = nlines * FRAME_LINE_HEIGHT (f) - y;
1256
1257 BLOCK_INPUT;
1258 x_clear_area (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1259 0, y, width, height, False);
1260 UNBLOCK_INPUT;
1261 }
1262
1263 if (nlines == 0 && WINDOWP (f->menu_bar_window))
1264 clear_glyph_matrix (XWINDOW (f->menu_bar_window)->current_matrix);
1265 }
1266#endif /* not USE_X_TOOLKIT && not USE_GTK */
333b20bb 1267 adjust_glyphs (f);
562dd5e9 1268 run_window_configuration_change_hook (f);
333b20bb
GM
1269}
1270
1271
1272/* Set the number of lines used for the tool bar of frame F to VALUE.
1273 VALUE not an integer, or < 0 means set the lines to zero. OLDVAL
1274 is the old number of tool bar lines. This function changes the
1275 height of all windows on frame F to match the new tool bar height.
1276 The frame's height doesn't change. */
1277
1278void
971de7fb 1279x_set_tool_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
333b20bb 1280{
52de7ce9
GM
1281 int delta, nlines, root_height;
1282 Lisp_Object root_window;
333b20bb 1283
e870b7ba
GM
1284 /* Treat tool bars like menu bars. */
1285 if (FRAME_MINIBUF_ONLY_P (f))
1286 return;
1287
333b20bb
GM
1288 /* Use VALUE only if an integer >= 0. */
1289 if (INTEGERP (value) && XINT (value) >= 0)
1290 nlines = XFASTINT (value);
1291 else
1292 nlines = 0;
1293
488dd4c4
JD
1294#ifdef USE_GTK
1295 FRAME_TOOL_BAR_LINES (f) = 0;
1296 if (nlines)
1297 {
1298 FRAME_EXTERNAL_TOOL_BAR (f) = 1;
1299 if (FRAME_X_P (f) && f->output_data.x->toolbar_widget == 0)
1300 /* Make sure next redisplay shows the tool bar. */
1301 XWINDOW (FRAME_SELECTED_WINDOW (f))->update_mode_line = Qt;
1302 update_frame_tool_bar (f);
1303 }
1304 else
1305 {
1306 if (FRAME_EXTERNAL_TOOL_BAR (f))
1307 free_frame_tool_bar (f);
1308 FRAME_EXTERNAL_TOOL_BAR (f) = 0;
1309 }
1310
1311 return;
1312#endif
177c0ea7 1313
488dd4c4 1314 /* Make sure we redisplay all windows in this frame. */
333b20bb
GM
1315 ++windows_or_buffers_changed;
1316
9ea173e8 1317 delta = nlines - FRAME_TOOL_BAR_LINES (f);
52de7ce9
GM
1318
1319 /* Don't resize the tool-bar to more than we have room for. */
1320 root_window = FRAME_ROOT_WINDOW (f);
be786000 1321 root_height = WINDOW_TOTAL_LINES (XWINDOW (root_window));
52de7ce9
GM
1322 if (root_height - delta < 1)
1323 {
1324 delta = root_height - 1;
1325 nlines = FRAME_TOOL_BAR_LINES (f) + delta;
1326 }
1327
9ea173e8 1328 FRAME_TOOL_BAR_LINES (f) = nlines;
562dd5e9 1329 resize_frame_windows (f, FRAME_LINES (f), 0);
333b20bb 1330 adjust_glyphs (f);
177c0ea7 1331
ccba751c
GM
1332 /* We also have to make sure that the internal border at the top of
1333 the frame, below the menu bar or tool bar, is redrawn when the
1334 tool bar disappears. This is so because the internal border is
1335 below the tool bar if one is displayed, but is below the menu bar
1336 if there isn't a tool bar. The tool bar draws into the area
1337 below the menu bar. */
1338 if (FRAME_X_WINDOW (f) && FRAME_TOOL_BAR_LINES (f) == 0)
1339 {
385ed61f 1340 clear_frame (f);
fb3cd89b 1341 clear_current_matrices (f);
ccba751c 1342 }
b6f91066
GM
1343
1344 /* If the tool bar gets smaller, the internal border below it
1345 has to be cleared. It was formerly part of the display
1346 of the larger tool bar, and updating windows won't clear it. */
1347 if (delta < 0)
1348 {
1349 int height = FRAME_INTERNAL_BORDER_WIDTH (f);
be786000 1350 int width = FRAME_PIXEL_WIDTH (f);
4b00d3b1 1351 int y = (FRAME_MENU_BAR_LINES (f) + nlines) * FRAME_LINE_HEIGHT (f);
b6f91066 1352
caacfeb8
JD
1353 /* height can be zero here. */
1354 if (height > 0 && width > 0)
1355 {
1356 BLOCK_INPUT;
1357 x_clear_area (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
1358 0, y, width, height, False);
1359 UNBLOCK_INPUT;
1360 }
ddc24747
GM
1361
1362 if (WINDOWP (f->tool_bar_window))
1363 clear_glyph_matrix (XWINDOW (f->tool_bar_window)->current_matrix);
b6f91066 1364 }
562dd5e9
MR
1365
1366 run_window_configuration_change_hook (f);
1367
333b20bb
GM
1368}
1369
1370
1371/* Set the foreground color for scroll bars on frame F to VALUE.
1372 VALUE should be a string, a color name. If it isn't a string or
1373 isn't a valid color name, do nothing. OLDVAL is the old value of
1374 the frame parameter. */
1375
e4cebfca 1376static void
971de7fb 1377x_set_scroll_bar_foreground (struct frame *f, Lisp_Object value, Lisp_Object oldval)
333b20bb
GM
1378{
1379 unsigned long pixel;
177c0ea7 1380
333b20bb
GM
1381 if (STRINGP (value))
1382 pixel = x_decode_color (f, value, BLACK_PIX_DEFAULT (f));
1383 else
1384 pixel = -1;
1385
1386 if (f->output_data.x->scroll_bar_foreground_pixel != -1)
1387 unload_color (f, f->output_data.x->scroll_bar_foreground_pixel);
177c0ea7 1388
333b20bb
GM
1389 f->output_data.x->scroll_bar_foreground_pixel = pixel;
1390 if (FRAME_X_WINDOW (f) && FRAME_VISIBLE_P (f))
1391 {
1392 /* Remove all scroll bars because they have wrong colors. */
6ed8eeff
KL
1393 if (FRAME_TERMINAL (f)->condemn_scroll_bars_hook)
1394 (*FRAME_TERMINAL (f)->condemn_scroll_bars_hook) (f);
1395 if (FRAME_TERMINAL (f)->judge_scroll_bars_hook)
1396 (*FRAME_TERMINAL (f)->judge_scroll_bars_hook) (f);
05c8abbe
GM
1397
1398 update_face_from_frame_parameter (f, Qscroll_bar_foreground, value);
333b20bb
GM
1399 redraw_frame (f);
1400 }
1401}
1402
1403
1404/* Set the background color for scroll bars on frame F to VALUE VALUE
1405 should be a string, a color name. If it isn't a string or isn't a
1406 valid color name, do nothing. OLDVAL is the old value of the frame
1407 parameter. */
1408
e4cebfca 1409static void
971de7fb 1410x_set_scroll_bar_background (struct frame *f, Lisp_Object value, Lisp_Object oldval)
333b20bb
GM
1411{
1412 unsigned long pixel;
1413
1414 if (STRINGP (value))
1415 pixel = x_decode_color (f, value, WHITE_PIX_DEFAULT (f));
1416 else
1417 pixel = -1;
177c0ea7 1418
333b20bb
GM
1419 if (f->output_data.x->scroll_bar_background_pixel != -1)
1420 unload_color (f, f->output_data.x->scroll_bar_background_pixel);
177c0ea7 1421
f15340b7
MB
1422#ifdef USE_TOOLKIT_SCROLL_BARS
1423 /* Scrollbar shadow colors. */
1424 if (f->output_data.x->scroll_bar_top_shadow_pixel != -1)
1425 {
1426 unload_color (f, f->output_data.x->scroll_bar_top_shadow_pixel);
1427 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
1428 }
1429 if (f->output_data.x->scroll_bar_bottom_shadow_pixel != -1)
1430 {
1431 unload_color (f, f->output_data.x->scroll_bar_bottom_shadow_pixel);
1432 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
1433 }
1434#endif /* USE_TOOLKIT_SCROLL_BARS */
1435
333b20bb
GM
1436 f->output_data.x->scroll_bar_background_pixel = pixel;
1437 if (FRAME_X_WINDOW (f) && FRAME_VISIBLE_P (f))
1438 {
1439 /* Remove all scroll bars because they have wrong colors. */
6ed8eeff
KL
1440 if (FRAME_TERMINAL (f)->condemn_scroll_bars_hook)
1441 (*FRAME_TERMINAL (f)->condemn_scroll_bars_hook) (f);
1442 if (FRAME_TERMINAL (f)->judge_scroll_bars_hook)
1443 (*FRAME_TERMINAL (f)->judge_scroll_bars_hook) (f);
177c0ea7 1444
05c8abbe 1445 update_face_from_frame_parameter (f, Qscroll_bar_background, value);
333b20bb
GM
1446 redraw_frame (f);
1447 }
d043f1a4 1448}
333b20bb 1449
943b580d 1450\f
3a258507 1451/* Encode Lisp string STRING as a text in a format appropriate for
96db09e4
KH
1452 XICCC (X Inter Client Communication Conventions).
1453
6f103132
RS
1454 This can call Lisp code, so callers must GCPRO.
1455
96db09e4
KH
1456 If STRING contains only ASCII characters, do no conversion and
1457 return the string data of STRING. Otherwise, encode the text by
1458 CODING_SYSTEM, and return a newly allocated memory area which
1459 should be freed by `xfree' by a caller.
1460
37323f34
EZ
1461 SELECTIONP non-zero means the string is being encoded for an X
1462 selection, so it is safe to run pre-write conversions (which
1463 may run Lisp code).
1464
96db09e4
KH
1465 Store the byte length of resulting text in *TEXT_BYTES.
1466
d60660d6 1467 If the text contains only ASCII and Latin-1, store 1 in *STRING_P,
96db09e4 1468 which means that the `encoding' of the result can be `STRING'.
d60660d6 1469 Otherwise store 0 in *STRINGP, which means that the `encoding' of
96db09e4
KH
1470 the result should be `COMPOUND_TEXT'. */
1471
df630496 1472static unsigned char *
971de7fb 1473x_encode_text (Lisp_Object string, Lisp_Object coding_system, int selectionp, int *text_bytes, int *stringp, int *freep)
96db09e4 1474{
0f8c4c4f 1475 int result = string_xstring_p (string);
96db09e4
KH
1476 struct coding_system coding;
1477
0f8c4c4f 1478 if (result == 0)
96db09e4
KH
1479 {
1480 /* No multibyte character in OBJ. We need not encode it. */
8f924df7 1481 *text_bytes = SBYTES (string);
d60660d6 1482 *stringp = 1;
df630496 1483 *freep = 0;
8f924df7 1484 return SDATA (string);
96db09e4
KH
1485 }
1486
1487 setup_coding_system (coding_system, &coding);
0f8c4c4f 1488 coding.mode |= (CODING_MODE_SAFE_ENCODING | CODING_MODE_LAST_BLOCK);
35bc5887 1489 /* We suppress producing escape sequences for composition. */
0f8c4c4f 1490 coding.common_flags &= ~CODING_ANNOTATION_MASK;
8f924df7 1491 coding.dst_bytes = SCHARS (string) * 2;
b954d586 1492 coding.destination = (unsigned char *) xmalloc (coding.dst_bytes);
0f8c4c4f 1493 encode_coding_object (&coding, string, 0, 0,
8f924df7 1494 SCHARS (string), SBYTES (string), Qnil);
96db09e4 1495 *text_bytes = coding.produced;
0f8c4c4f 1496 *stringp = (result == 1 || !EQ (coding_system, Qcompound_text));
df630496 1497 *freep = 1;
b954d586 1498 return coding.destination;
96db09e4
KH
1499}
1500
1501\f
b10daec7
JD
1502/* Set the WM name to NAME for frame F. Also set the icon name.
1503 If the frame already has an icon name, use that, otherwise set the
1504 icon name to NAME. */
f945b920 1505
b10daec7 1506static void
971de7fb 1507x_set_name_internal (FRAME_PTR f, Lisp_Object name)
f945b920 1508{
fe24a618 1509 if (FRAME_X_WINDOW (f))
01f1ba30 1510 {
01f1ba30 1511 BLOCK_INPUT;
fe24a618 1512 {
80534dd6 1513 XTextProperty text, icon;
d60660d6 1514 int bytes, stringp;
b10daec7 1515 int do_free_icon_value = 0, do_free_text_value = 0;
11270583 1516 Lisp_Object coding_system;
c2915ced 1517 Lisp_Object encoded_name;
00be444c 1518 Lisp_Object encoded_icon_name;
c2915ced
CY
1519 struct gcpro gcpro1;
1520
1521 /* As ENCODE_UTF_8 may cause GC and relocation of string data,
1522 we use it before x_encode_text that may return string data. */
1523 GCPRO1 (name);
1524 encoded_name = ENCODE_UTF_8 (name);
1525 UNGCPRO;
80534dd6 1526
b10daec7 1527 coding_system = Qcompound_text;
3201ea57
KH
1528 /* Note: Encoding strategy
1529
1530 We encode NAME by compound-text and use "COMPOUND-TEXT" in
1531 text.encoding. But, there are non-internationalized window
1532 managers which don't support that encoding. So, if NAME
1533 contains only ASCII and 8859-1 characters, encode it by
1534 iso-latin-1, and use "STRING" in text.encoding hoping that
34e8c597 1535 such window managers at least analyze this format correctly,
3201ea57
KH
1536 i.e. treat 8-bit bytes as 8859-1 characters.
1537
1538 We may also be able to use "UTF8_STRING" in text.encoding
34e8c597 1539 in the future which can encode all Unicode characters.
3201ea57 1540 But, for the moment, there's no way to know that the
00be444c
J
1541 current window manager supports it or not.
1542
1543 Either way, we also set the _NET_WM_NAME and _NET_WM_ICON_NAME
1544 properties. Per the EWMH specification, those two properties
1545 are always UTF8_STRING. This matches what gtk_window_set_title()
1546 does in the USE_GTK case. */
df630496
KS
1547 text.value = x_encode_text (name, coding_system, 0, &bytes, &stringp,
1548 &do_free_text_value);
d60660d6 1549 text.encoding = (stringp ? XA_STRING
96db09e4 1550 : FRAME_X_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
fe24a618 1551 text.format = 8;
96db09e4 1552 text.nitems = bytes;
80534dd6 1553
4985dde2 1554 if (!STRINGP (f->icon_name))
96db09e4
KH
1555 {
1556 icon = text;
00be444c 1557 encoded_icon_name = encoded_name;
96db09e4
KH
1558 }
1559 else
1560 {
3201ea57 1561 /* See the above comment "Note: Encoding strategy". */
37323f34 1562 icon.value = x_encode_text (f->icon_name, coding_system, 0,
df630496 1563 &bytes, &stringp, &do_free_icon_value);
d60660d6 1564 icon.encoding = (stringp ? XA_STRING
96db09e4
KH
1565 : FRAME_X_DISPLAY_INFO (f)->Xatom_COMPOUND_TEXT);
1566 icon.format = 8;
1567 icon.nitems = bytes;
00be444c
J
1568
1569 encoded_icon_name = ENCODE_UTF_8 (f->icon_name);
96db09e4 1570 }
b10daec7 1571
488dd4c4
JD
1572#ifdef USE_GTK
1573 gtk_window_set_title (GTK_WINDOW (FRAME_GTK_OUTER_WIDGET (f)),
51b59d79 1574 SSDATA (encoded_name));
488dd4c4 1575#else /* not USE_GTK */
2436a4e4 1576 XSetWMName (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &text);
00be444c
J
1577 XChangeProperty (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f),
1578 FRAME_X_DISPLAY_INFO (f)->Xatom_net_wm_name,
1579 FRAME_X_DISPLAY_INFO (f)->Xatom_UTF8_STRING,
1580 8, PropModeReplace,
42a5b22f 1581 SDATA (encoded_name),
00be444c 1582 SBYTES (encoded_name));
7c0d3ed8 1583#endif /* not USE_GTK */
abb4b7ec 1584
7c0d3ed8 1585 XSetWMIconName (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), &icon);
00be444c
J
1586 XChangeProperty (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f),
1587 FRAME_X_DISPLAY_INFO (f)->Xatom_net_wm_icon_name,
1588 FRAME_X_DISPLAY_INFO (f)->Xatom_UTF8_STRING,
1589 8, PropModeReplace,
42a5b22f 1590 SDATA (encoded_icon_name),
00be444c 1591 SBYTES (encoded_icon_name));
abb4b7ec 1592
b10daec7 1593 if (do_free_icon_value)
7c0d3ed8 1594 xfree (icon.value);
b10daec7 1595 if (do_free_text_value)
7c0d3ed8
KS
1596 xfree (text.value);
1597 }
7c0d3ed8
KS
1598 UNBLOCK_INPUT;
1599 }
abb4b7ec
RS
1600}
1601
b10daec7
JD
1602/* Change the name of frame F to NAME. If NAME is nil, set F's name to
1603 x_id_name.
1604
1605 If EXPLICIT is non-zero, that indicates that lisp code is setting the
1606 name; if NAME is a string, set F's name to NAME and set
1607 F->explicit_name; if NAME is Qnil, then clear F->explicit_name.
1608
1609 If EXPLICIT is zero, that indicates that Emacs redisplay code is
1610 suggesting a new name, which lisp code should override; if
1611 F->explicit_name is set, ignore the new name; otherwise, set it. */
1612
f78faa98 1613static void
971de7fb 1614x_set_name (struct frame *f, Lisp_Object name, int explicit)
b10daec7
JD
1615{
1616 /* Make sure that requests from lisp code override requests from
1617 Emacs redisplay code. */
1618 if (explicit)
1619 {
1620 /* If we're switching from explicit to implicit, we had better
1621 update the mode lines and thereby update the title. */
1622 if (f->explicit_name && NILP (name))
1623 update_mode_lines = 1;
1624
1625 f->explicit_name = ! NILP (name);
1626 }
1627 else if (f->explicit_name)
1628 return;
1629
1630 /* If NAME is nil, set the name to the x_id_name. */
1631 if (NILP (name))
1632 {
1633 /* Check for no change needed in this very common case
1634 before we do any consing. */
1635 if (!strcmp (FRAME_X_DISPLAY_INFO (f)->x_id_name,
42a5b22f 1636 SSDATA (f->name)))
b10daec7
JD
1637 return;
1638 name = build_string (FRAME_X_DISPLAY_INFO (f)->x_id_name);
1639 }
1640 else
1641 CHECK_STRING (name);
1642
1643 /* Don't change the name if it's already NAME. */
1644 if (! NILP (Fstring_equal (name, f->name)))
1645 return;
1646
1647 f->name = name;
1648
1649 /* For setting the frame title, the title parameter should override
1650 the name parameter. */
1651 if (! NILP (f->title))
1652 name = f->title;
1653
1654 x_set_name_internal (f, name);
1655}
1656
7c0d3ed8
KS
1657/* This function should be called when the user's lisp code has
1658 specified a name for the frame; the name will override any set by the
1659 redisplay code. */
e4cebfca 1660static void
971de7fb 1661x_explicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
3402e1a4 1662{
7c0d3ed8 1663 x_set_name (f, arg, 1);
3402e1a4
RS
1664}
1665
7c0d3ed8
KS
1666/* This function should be called by Emacs redisplay code to set the
1667 name; names set this way will never override names set by the user's
1668 lisp code. */
1669void
971de7fb 1670x_implicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
333b20bb 1671{
7c0d3ed8
KS
1672 x_set_name (f, arg, 0);
1673}
1674\f
1675/* Change the title of frame F to NAME.
40aa4c27 1676 If NAME is nil, use the frame name as the title. */
01f1ba30 1677
e4cebfca 1678static void
971de7fb 1679x_set_title (struct frame *f, Lisp_Object name, Lisp_Object old_name)
01f1ba30 1680{
7c0d3ed8
KS
1681 /* Don't change the title if it's already NAME. */
1682 if (EQ (name, f->title))
1683 return;
01f1ba30 1684
7c0d3ed8 1685 update_mode_lines = 1;
60fb3ee1 1686
7c0d3ed8 1687 f->title = name;
f9942c9e 1688
7c0d3ed8
KS
1689 if (NILP (name))
1690 name = f->name;
1691 else
1692 CHECK_STRING (name);
f9942c9e 1693
b10daec7 1694 x_set_name_internal (f, name);
01f1ba30
JB
1695}
1696
7c0d3ed8 1697void
971de7fb 1698x_set_scroll_bar_default_width (struct frame *f)
e4f79258 1699{
be786000 1700 int wid = FRAME_COLUMN_WIDTH (f);
7c0d3ed8 1701#ifdef USE_TOOLKIT_SCROLL_BARS
a059fe24 1702#ifdef USE_GTK
c195f2de 1703 int minw = xg_get_default_scrollbar_width ();
4a1b9832
PE
1704#else
1705 int minw = 16;
a059fe24 1706#endif
7c0d3ed8 1707 /* A minimum width of 14 doesn't look good for toolkit scroll bars. */
4a1b9832 1708 int width = minw + 2 * VERTICAL_SCROLL_BAR_WIDTH_TRIM;
be786000
KS
1709 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (width + wid - 1) / wid;
1710 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = width;
7c0d3ed8
KS
1711#else
1712 /* Make the actual width at least 14 pixels and a multiple of a
1713 character width. */
be786000 1714 FRAME_CONFIG_SCROLL_BAR_COLS (f) = (14 + wid - 1) / wid;
01f1ba30 1715
7c0d3ed8
KS
1716 /* Use all of that space (aside from required margins) for the
1717 scroll bar. */
be786000 1718 FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = 0;
7c0d3ed8 1719#endif
01f1ba30 1720}
333b20bb 1721
7c0d3ed8 1722\f
333b20bb
GM
1723/* Record in frame F the specified or default value according to ALIST
1724 of the parameter named PROP (a Lisp symbol). If no value is
1725 specified for PROP, look for an X default for XPROP on the frame
1726 named NAME. If that is not found either, use the value DEFLT. */
1727
1728static Lisp_Object
d5a3eaaf
AS
1729x_default_scroll_bar_color_parameter (struct frame *f,
1730 Lisp_Object alist, Lisp_Object prop,
675e2c69 1731 const char *xprop, const char *xclass,
d5a3eaaf 1732 int foreground_p)
333b20bb
GM
1733{
1734 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
1735 Lisp_Object tem;
1736
1737 tem = x_get_arg (dpyinfo, alist, prop, xprop, xclass, RES_TYPE_STRING);
1738 if (EQ (tem, Qunbound))
1739 {
1740#ifdef USE_TOOLKIT_SCROLL_BARS
1741
1742 /* See if an X resource for the scroll bar color has been
1743 specified. */
1744 tem = display_x_get_resource (dpyinfo,
1745 build_string (foreground_p
1746 ? "foreground"
1747 : "background"),
6ecd75be 1748 empty_unibyte_string,
333b20bb 1749 build_string ("verticalScrollBar"),
6ecd75be 1750 empty_unibyte_string);
333b20bb
GM
1751 if (!STRINGP (tem))
1752 {
1753 /* If nothing has been specified, scroll bars will use a
1754 toolkit-dependent default. Because these defaults are
1755 difficult to get at without actually creating a scroll
1756 bar, use nil to indicate that no color has been
1757 specified. */
1758 tem = Qnil;
1759 }
177c0ea7 1760
333b20bb 1761#else /* not USE_TOOLKIT_SCROLL_BARS */
177c0ea7 1762
333b20bb 1763 tem = Qnil;
177c0ea7 1764
333b20bb
GM
1765#endif /* not USE_TOOLKIT_SCROLL_BARS */
1766 }
1767
1768 x_set_frame_parameters (f, Fcons (Fcons (prop, tem), Qnil));
1769 return tem;
1770}
1771
1772
01f1ba30 1773
9ef48a9d
RS
1774\f
1775#ifdef USE_X_TOOLKIT
1776
8e3d10a9
RS
1777/* If the WM_PROTOCOLS property does not already contain WM_TAKE_FOCUS,
1778 WM_DELETE_WINDOW, and WM_SAVE_YOURSELF, then add them. (They may
59aa6c90
RS
1779 already be present because of the toolkit (Motif adds some of them,
1780 for example, but Xt doesn't). */
9ef48a9d
RS
1781
1782static void
ebd15611 1783hack_wm_protocols (FRAME_PTR f, Widget widget)
9ef48a9d
RS
1784{
1785 Display *dpy = XtDisplay (widget);
1786 Window w = XtWindow (widget);
1787 int need_delete = 1;
1788 int need_focus = 1;
59aa6c90 1789 int need_save = 1;
9ef48a9d
RS
1790
1791 BLOCK_INPUT;
1792 {
a3db4b26
AS
1793 Atom type;
1794 unsigned char *catoms;
9ef48a9d
RS
1795 int format = 0;
1796 unsigned long nitems = 0;
1797 unsigned long bytes_after;
1798
270958e8
KH
1799 if ((XGetWindowProperty (dpy, w,
1800 FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
34d5ae1e 1801 (long)0, (long)100, False, XA_ATOM,
270958e8 1802 &type, &format, &nitems, &bytes_after,
a3db4b26 1803 &catoms)
270958e8 1804 == Success)
9ef48a9d 1805 && format == 32 && type == XA_ATOM)
a3db4b26
AS
1806 {
1807 Atom *atoms = (Atom *) catoms;
1808 while (nitems > 0)
1809 {
1810 nitems--;
1811 if (atoms[nitems]
1812 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window)
1813 need_delete = 0;
1814 else if (atoms[nitems]
1815 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_take_focus)
1816 need_focus = 0;
1817 else if (atoms[nitems]
1818 == FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself)
1819 need_save = 0;
1820 }
1821 }
1822 if (catoms)
1823 XFree (catoms);
9ef48a9d
RS
1824 }
1825 {
1826 Atom props [10];
1827 int count = 0;
b9dc4443
RS
1828 if (need_delete)
1829 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window;
1830 if (need_focus)
1831 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_take_focus;
1832 if (need_save)
1833 props[count++] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself;
9ef48a9d 1834 if (count)
b9dc4443
RS
1835 XChangeProperty (dpy, w, FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
1836 XA_ATOM, 32, PropModeAppend,
9ef48a9d
RS
1837 (unsigned char *) props, count);
1838 }
1839 UNBLOCK_INPUT;
1840}
1841#endif
86779fac
GM
1842
1843
5a7df7d7
GM
1844\f
1845/* Support routines for XIC (X Input Context). */
86779fac 1846
5a7df7d7
GM
1847#ifdef HAVE_X_I18N
1848
f57e2426
J
1849static XFontSet xic_create_xfontset (struct frame *);
1850static XIMStyle best_xim_style (XIMStyles *, XIMStyles *);
5a7df7d7
GM
1851
1852
1576f1ad 1853/* Supported XIM styles, ordered by preference. */
5a7df7d7
GM
1854
1855static XIMStyle supported_xim_styles[] =
1856{
1857 XIMPreeditPosition | XIMStatusArea,
1858 XIMPreeditPosition | XIMStatusNothing,
1859 XIMPreeditPosition | XIMStatusNone,
1860 XIMPreeditNothing | XIMStatusArea,
1861 XIMPreeditNothing | XIMStatusNothing,
1862 XIMPreeditNothing | XIMStatusNone,
1863 XIMPreeditNone | XIMStatusArea,
1864 XIMPreeditNone | XIMStatusNothing,
1865 XIMPreeditNone | XIMStatusNone,
1866 0,
1867};
1868
1869
e4cebfca 1870#if defined HAVE_X_WINDOWS && defined USE_X_TOOLKIT
c27ed90a 1871/* Create an X fontset on frame F with base font name BASE_FONTNAME. */
5a7df7d7 1872
e4cebfca 1873static const char xic_defaut_fontset[] = "-*-*-*-r-normal--14-*-*-*-*-*-*-*";
bb07fa29 1874
c28e7ae8
SM
1875/* Create an Xt fontset spec from the name of a base font.
1876 If `motif' is True use the Motif syntax. */
bb07fa29 1877char *
e6cba650 1878xic_create_fontsetname (const char *base_fontname, int motif)
bb07fa29 1879{
c28e7ae8
SM
1880 const char *sep = motif ? ";" : ",";
1881 char *fontsetname;
1882
bb07fa29
SM
1883 /* Make a fontset name from the base font name. */
1884 if (xic_defaut_fontset == base_fontname)
c28e7ae8
SM
1885 { /* There is no base font name, use the default. */
1886 int len = strlen (base_fontname) + 2;
1887 fontsetname = xmalloc (len);
72af86bd 1888 memset (fontsetname, 0, len);
c28e7ae8
SM
1889 strcpy (fontsetname, base_fontname);
1890 }
bb07fa29
SM
1891 else
1892 {
1893 /* Make a fontset name from the base font name.
1894 The font set will be made of the following elements:
1895 - the base font.
1896 - the base font where the charset spec is replaced by -*-*.
1897 - the same but with the family also replaced with -*-*-. */
e6cba650 1898 const char *p = base_fontname;
bb07fa29 1899 int i;
df630496 1900
bb07fa29
SM
1901 for (i = 0; *p; p++)
1902 if (*p == '-') i++;
1903 if (i != 14)
1904 { /* As the font name doesn't conform to XLFD, we can't
1905 modify it to generalize it to allcs and allfamilies.
1906 Use the specified font plus the default. */
c28e7ae8 1907 int len = strlen (base_fontname) + strlen (xic_defaut_fontset) + 3;
bb07fa29 1908 fontsetname = xmalloc (len);
72af86bd 1909 memset (fontsetname, 0, len);
bb07fa29 1910 strcpy (fontsetname, base_fontname);
c28e7ae8 1911 strcat (fontsetname, sep);
bb07fa29
SM
1912 strcat (fontsetname, xic_defaut_fontset);
1913 }
1914 else
1915 {
1916 int len;
e6cba650 1917 const char *p1 = NULL, *p2 = NULL, *p3 = NULL;
bb07fa29
SM
1918 char *font_allcs = NULL;
1919 char *font_allfamilies = NULL;
968a6679 1920 char *font_all = NULL;
e6cba650
DN
1921 const char *allcs = "*-*-*-*-*-*-*";
1922 const char *allfamilies = "-*-*-";
1923 const char *all = "*-*-*-*-";
cd987aaa 1924 char *base;
df630496 1925
bb07fa29
SM
1926 for (i = 0, p = base_fontname; i < 8; p++)
1927 {
1928 if (*p == '-')
1929 {
1930 i++;
1931 if (i == 3)
1932 p1 = p + 1;
968a6679
SM
1933 else if (i == 7)
1934 p2 = p + 1;
cd987aaa
KH
1935 else if (i == 6)
1936 p3 = p + 1;
bb07fa29
SM
1937 }
1938 }
cd987aaa
KH
1939 /* If base_fontname specifies ADSTYLE, make it a
1940 wildcard. */
1941 if (*p3 != '*')
1942 {
1943 int diff = (p2 - p3) - 2;
1944
1945 base = alloca (strlen (base_fontname) + 1);
72af86bd 1946 memcpy (base, base_fontname, p3 - base_fontname);
cd987aaa
KH
1947 base[p3 - base_fontname] = '*';
1948 base[(p3 - base_fontname) + 1] = '-';
1949 strcpy (base + (p3 - base_fontname) + 2, p2);
1950 p = base + (p - base_fontname) - diff;
1951 p1 = base + (p1 - base_fontname);
1952 p2 = base + (p2 - base_fontname) - diff;
1953 base_fontname = base;
1954 }
1955
bb07fa29
SM
1956 /* Build the font spec that matches all charsets. */
1957 len = p - base_fontname + strlen (allcs) + 1;
1958 font_allcs = (char *) alloca (len);
72af86bd
AS
1959 memset (font_allcs, 0, len);
1960 memcpy (font_allcs, base_fontname, p - base_fontname);
bb07fa29
SM
1961 strcat (font_allcs, allcs);
1962
cd987aaa
KH
1963 /* Build the font spec that matches all families and
1964 add-styles. */
bb07fa29
SM
1965 len = p - p1 + strlen (allcs) + strlen (allfamilies) + 1;
1966 font_allfamilies = (char *) alloca (len);
72af86bd 1967 memset (font_allfamilies, 0, len);
bb07fa29 1968 strcpy (font_allfamilies, allfamilies);
72af86bd 1969 memcpy (font_allfamilies + strlen (allfamilies), p1, p - p1);
bb07fa29
SM
1970 strcat (font_allfamilies, allcs);
1971
968a6679
SM
1972 /* Build the font spec that matches all. */
1973 len = p - p2 + strlen (allcs) + strlen (all) + strlen (allfamilies) + 1;
1974 font_all = (char *) alloca (len);
72af86bd 1975 memset (font_all, 0, len);
968a6679
SM
1976 strcpy (font_all, allfamilies);
1977 strcat (font_all, all);
72af86bd 1978 memcpy (font_all + strlen (all) + strlen (allfamilies), p2, p - p2);
968a6679
SM
1979 strcat (font_all, allcs);
1980
bb07fa29
SM
1981 /* Build the actual font set name. */
1982 len = strlen (base_fontname) + strlen (font_allcs)
968a6679 1983 + strlen (font_allfamilies) + strlen (font_all) + 5;
bb07fa29 1984 fontsetname = xmalloc (len);
72af86bd 1985 memset (fontsetname, 0, len);
bb07fa29 1986 strcpy (fontsetname, base_fontname);
c28e7ae8 1987 strcat (fontsetname, sep);
bb07fa29 1988 strcat (fontsetname, font_allcs);
c28e7ae8 1989 strcat (fontsetname, sep);
bb07fa29 1990 strcat (fontsetname, font_allfamilies);
968a6679
SM
1991 strcat (fontsetname, sep);
1992 strcat (fontsetname, font_all);
bb07fa29 1993 }
bb07fa29 1994 }
c28e7ae8
SM
1995 if (motif)
1996 strcat (fontsetname, ":");
1997 return fontsetname;
bb07fa29 1998}
e4cebfca 1999#endif /* HAVE_X_WINDOWS && USE_X_TOOLKIT */
bb07fa29 2000
2da34f50
KH
2001#ifdef DEBUG_XIC_FONTSET
2002static void
2003print_fontset_result (xfs, name, missing_list, missing_count)
2004 XFontSet xfs;
2005 char *name;
2006 char **missing_list;
2007 int missing_count;
2008{
2009 if (xfs)
2010 fprintf (stderr, "XIC Fontset created: %s\n", name);
2011 else
2012 {
2013 fprintf (stderr, "XIC Fontset failed: %s\n", name);
2014 while (missing_count-- > 0)
2015 {
2016 fprintf (stderr, " missing: %s\n", *missing_list);
2017 missing_list++;
2018 }
2019 }
2020
2021}
2022#endif
2023
5a7df7d7 2024static XFontSet
971de7fb 2025xic_create_xfontset (struct frame *f)
86779fac 2026{
c27ed90a 2027 XFontSet xfs = NULL;
b51238f5 2028 struct font *font = FRAME_FONT (f);
a32f056c
KH
2029 int pixel_size = font->pixel_size;
2030 Lisp_Object rest, frame;
2031
2032 /* See if there is another frame already using same fontset. */
2033 FOR_EACH_FRAME (rest, frame)
2034 {
2035 struct frame *cf = XFRAME (frame);
2036
2037 if (cf != f && FRAME_LIVE_P (f) && FRAME_X_P (cf)
2038 && FRAME_X_DISPLAY_INFO (cf) == FRAME_X_DISPLAY_INFO (f)
b51238f5
KH
2039 && FRAME_FONT (f)
2040 && FRAME_FONT (f)->pixel_size == pixel_size)
a32f056c
KH
2041 {
2042 xfs = FRAME_XIC_FONTSET (cf);
2043 break;
2044 }
2045 }
2046
2047 if (! xfs)
2048 {
2049 char buf[256];
2050 char **missing_list;
2051 int missing_count;
2052 char *def_string;
e6cba650 2053 const char *xlfd_format = "-*-*-medium-r-normal--%d-*-*-*-*-*";
a32f056c
KH
2054
2055 sprintf (buf, xlfd_format, pixel_size);
2056 missing_list = NULL;
2057 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), buf,
2058 &missing_list, &missing_count, &def_string);
d3483d71 2059#ifdef DEBUG_XIC_FONTSET
22a8f595 2060 print_fontset_result (xfs, buf, missing_list, missing_count);
d3483d71 2061#endif
a32f056c
KH
2062 if (missing_list)
2063 XFreeStringList (missing_list);
2064 if (! xfs)
2065 {
2066 /* List of pixel sizes most likely available. Find one that
2067 is closest to pixel_size. */
2068 int sizes[] = {0, 8, 10, 11, 12, 14, 17, 18, 20, 24, 26, 34, 0};
2069 int *smaller, *larger;
2070
2071 for (smaller = sizes; smaller[1]; smaller++)
2072 if (smaller[1] >= pixel_size)
2073 break;
2074 larger = smaller + 1;
2075 if (*larger == pixel_size)
2076 larger++;
2077 while (*smaller || *larger)
2078 {
2079 int this_size;
2080
2081 if (! *larger)
2082 this_size = *smaller--;
2083 else if (! *smaller)
2084 this_size = *larger++;
2085 else if (pixel_size - *smaller < *larger - pixel_size)
2086 this_size = *smaller--;
2087 else
2088 this_size = *larger++;
2089 sprintf (buf, xlfd_format, this_size);
2090 missing_list = NULL;
2091 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), buf,
2092 &missing_list, &missing_count, &def_string);
d3483d71 2093#ifdef DEBUG_XIC_FONTSET
22a8f595 2094 print_fontset_result (xfs, buf, missing_list, missing_count);
d3483d71 2095#endif
a32f056c
KH
2096 if (missing_list)
2097 XFreeStringList (missing_list);
2098 if (xfs)
2099 break;
2100 }
2101 }
2da34f50
KH
2102 if (! xfs)
2103 {
675e2c69 2104 const char *last_resort = "-*-*-*-r-normal--*-*-*-*-*-*";
2da34f50
KH
2105
2106 missing_list = NULL;
2107 xfs = XCreateFontSet (FRAME_X_DISPLAY (f), last_resort,
2108 &missing_list, &missing_count, &def_string);
2109#ifdef DEBUG_XIC_FONTSET
2110 print_fontset_result (xfs, last_resort, missing_list, missing_count);
2111#endif
2112 if (missing_list)
2113 XFreeStringList (missing_list);
2114 }
2115
a32f056c
KH
2116 }
2117
2118 return xfs;
2119}
a32f056c 2120
c27ed90a
JD
2121/* Free the X fontset of frame F if it is the last frame using it. */
2122
2123void
971de7fb 2124xic_free_xfontset (struct frame *f)
c27ed90a
JD
2125{
2126 Lisp_Object rest, frame;
2127 int shared_p = 0;
2128
2129 if (!FRAME_XIC_FONTSET (f))
2130 return;
2131
2132 /* See if there is another frame sharing the same fontset. */
2133 FOR_EACH_FRAME (rest, frame)
2134 {
2135 struct frame *cf = XFRAME (frame);
2136 if (cf != f && FRAME_LIVE_P (f) && FRAME_X_P (cf)
2137 && FRAME_X_DISPLAY_INFO (cf) == FRAME_X_DISPLAY_INFO (f)
2138 && FRAME_XIC_FONTSET (cf) == FRAME_XIC_FONTSET (f))
2139 {
2140 shared_p = 1;
2141 break;
2142 }
2143 }
2144
2145 if (!shared_p)
2146 /* The fontset is not used anymore. It is safe to free it. */
2147 XFreeFontSet (FRAME_X_DISPLAY (f), FRAME_XIC_FONTSET (f));
2148
2149 if (FRAME_XIC_BASE_FONTNAME (f))
2150 xfree (FRAME_XIC_BASE_FONTNAME (f));
2151 FRAME_XIC_BASE_FONTNAME (f) = NULL;
2152 FRAME_XIC_FONTSET (f) = NULL;
2153}
2154
5a7df7d7
GM
2155
2156/* Value is the best input style, given user preferences USER (already
2157 checked to be supported by Emacs), and styles supported by the
2158 input method XIM. */
2159
2160static XIMStyle
971de7fb 2161best_xim_style (XIMStyles *user, XIMStyles *xim)
5a7df7d7
GM
2162{
2163 int i, j;
2164
2165 for (i = 0; i < user->count_styles; ++i)
2166 for (j = 0; j < xim->count_styles; ++j)
2167 if (user->supported_styles[i] == xim->supported_styles[j])
2168 return user->supported_styles[i];
2169
2170 /* Return the default style. */
2171 return XIMPreeditNothing | XIMStatusNothing;
2172}
2173
2174/* Create XIC for frame F. */
2175
5df79d3d
GM
2176static XIMStyle xic_style;
2177
5a7df7d7 2178void
971de7fb 2179create_frame_xic (struct frame *f)
5a7df7d7 2180{
5a7df7d7
GM
2181 XIM xim;
2182 XIC xic = NULL;
2183 XFontSet xfs = NULL;
86779fac 2184
5a7df7d7
GM
2185 if (FRAME_XIC (f))
2186 return;
177c0ea7 2187
bb07fa29 2188 /* Create X fontset. */
b51238f5 2189 xfs = xic_create_xfontset (f);
5a7df7d7
GM
2190 xim = FRAME_X_XIM (f);
2191 if (xim)
2192 {
d9d57cb2
DL
2193 XRectangle s_area;
2194 XPoint spot;
5a7df7d7
GM
2195 XVaNestedList preedit_attr;
2196 XVaNestedList status_attr;
5a7df7d7 2197
d9d57cb2
DL
2198 s_area.x = 0; s_area.y = 0; s_area.width = 1; s_area.height = 1;
2199 spot.x = 0; spot.y = 1;
86779fac 2200
5a7df7d7
GM
2201 /* Determine XIC style. */
2202 if (xic_style == 0)
2203 {
2204 XIMStyles supported_list;
2205 supported_list.count_styles = (sizeof supported_xim_styles
2206 / sizeof supported_xim_styles[0]);
2207 supported_list.supported_styles = supported_xim_styles;
2208 xic_style = best_xim_style (&supported_list,
2209 FRAME_X_XIM_STYLES (f));
2210 }
86779fac 2211
5a7df7d7
GM
2212 preedit_attr = XVaCreateNestedList (0,
2213 XNFontSet, xfs,
2214 XNForeground,
2215 FRAME_FOREGROUND_PIXEL (f),
2216 XNBackground,
2217 FRAME_BACKGROUND_PIXEL (f),
2218 (xic_style & XIMPreeditPosition
2219 ? XNSpotLocation
2220 : NULL),
2221 &spot,
2222 NULL);
2223 status_attr = XVaCreateNestedList (0,
2224 XNArea,
2225 &s_area,
2226 XNFontSet,
2227 xfs,
2228 XNForeground,
2229 FRAME_FOREGROUND_PIXEL (f),
2230 XNBackground,
2231 FRAME_BACKGROUND_PIXEL (f),
2232 NULL);
2233
2234 xic = XCreateIC (xim,
2235 XNInputStyle, xic_style,
6b61353c
KH
2236 XNClientWindow, FRAME_X_WINDOW (f),
2237 XNFocusWindow, FRAME_X_WINDOW (f),
5a7df7d7
GM
2238 XNStatusAttributes, status_attr,
2239 XNPreeditAttributes, preedit_attr,
2240 NULL);
2241 XFree (preedit_attr);
2242 XFree (status_attr);
2243 }
177c0ea7 2244
5a7df7d7
GM
2245 FRAME_XIC (f) = xic;
2246 FRAME_XIC_STYLE (f) = xic_style;
2247 FRAME_XIC_FONTSET (f) = xfs;
86779fac
GM
2248}
2249
5a7df7d7
GM
2250
2251/* Destroy XIC and free XIC fontset of frame F, if any. */
2252
2253void
971de7fb 2254free_frame_xic (struct frame *f)
5a7df7d7
GM
2255{
2256 if (FRAME_XIC (f) == NULL)
2257 return;
177c0ea7 2258
5a7df7d7 2259 XDestroyIC (FRAME_XIC (f));
c27ed90a 2260 xic_free_xfontset (f);
5a7df7d7
GM
2261
2262 FRAME_XIC (f) = NULL;
5a7df7d7
GM
2263}
2264
2265
2266/* Place preedit area for XIC of window W's frame to specified
2267 pixel position X/Y. X and Y are relative to window W. */
2268
2269void
971de7fb 2270xic_set_preeditarea (struct window *w, int x, int y)
5a7df7d7
GM
2271{
2272 struct frame *f = XFRAME (w->frame);
2273 XVaNestedList attr;
2274 XPoint spot;
177c0ea7 2275
17e6d491 2276 spot.x = WINDOW_TO_FRAME_PIXEL_X (w, x) + WINDOW_LEFT_FRINGE_WIDTH (w);
5a7df7d7
GM
2277 spot.y = WINDOW_TO_FRAME_PIXEL_Y (w, y) + FONT_BASE (FRAME_FONT (f));
2278 attr = XVaCreateNestedList (0, XNSpotLocation, &spot, NULL);
2279 XSetICValues (FRAME_XIC (f), XNPreeditAttributes, attr, NULL);
2280 XFree (attr);
2281}
2282
2283
2284/* Place status area for XIC in bottom right corner of frame F.. */
2285
2286void
971de7fb 2287xic_set_statusarea (struct frame *f)
5a7df7d7
GM
2288{
2289 XIC xic = FRAME_XIC (f);
2290 XVaNestedList attr;
2291 XRectangle area;
2292 XRectangle *needed;
2293
2294 /* Negotiate geometry of status area. If input method has existing
2295 status area, use its current size. */
2296 area.x = area.y = area.width = area.height = 0;
2297 attr = XVaCreateNestedList (0, XNAreaNeeded, &area, NULL);
2298 XSetICValues (xic, XNStatusAttributes, attr, NULL);
2299 XFree (attr);
177c0ea7 2300
5a7df7d7
GM
2301 attr = XVaCreateNestedList (0, XNAreaNeeded, &needed, NULL);
2302 XGetICValues (xic, XNStatusAttributes, attr, NULL);
2303 XFree (attr);
2304
2305 if (needed->width == 0) /* Use XNArea instead of XNAreaNeeded */
2306 {
2307 attr = XVaCreateNestedList (0, XNArea, &needed, NULL);
2308 XGetICValues (xic, XNStatusAttributes, attr, NULL);
2309 XFree (attr);
2310 }
2311
2312 area.width = needed->width;
2313 area.height = needed->height;
be786000
KS
2314 area.x = FRAME_PIXEL_WIDTH (f) - area.width - FRAME_INTERNAL_BORDER_WIDTH (f);
2315 area.y = (FRAME_PIXEL_HEIGHT (f) - area.height
488dd4c4 2316 - FRAME_MENUBAR_HEIGHT (f)
bfeabdc3 2317 - FRAME_TOOLBAR_TOP_HEIGHT (f)
488dd4c4 2318 - FRAME_INTERNAL_BORDER_WIDTH (f));
5a7df7d7
GM
2319 XFree (needed);
2320
2321 attr = XVaCreateNestedList (0, XNArea, &area, NULL);
6b61353c 2322 XSetICValues (xic, XNStatusAttributes, attr, NULL);
5a7df7d7
GM
2323 XFree (attr);
2324}
2325
2326
2327/* Set X fontset for XIC of frame F, using base font name
2328 BASE_FONTNAME. Called when a new Emacs fontset is chosen. */
2329
2330void
eec47d6b 2331xic_set_xfontset (struct frame *f, const char *base_fontname)
5a7df7d7
GM
2332{
2333 XVaNestedList attr;
2334 XFontSet xfs;
2335
c27ed90a
JD
2336 xic_free_xfontset (f);
2337
b51238f5 2338 xfs = xic_create_xfontset (f);
5a7df7d7
GM
2339
2340 attr = XVaCreateNestedList (0, XNFontSet, xfs, NULL);
2341 if (FRAME_XIC_STYLE (f) & XIMPreeditPosition)
2342 XSetICValues (FRAME_XIC (f), XNPreeditAttributes, attr, NULL);
2343 if (FRAME_XIC_STYLE (f) & XIMStatusArea)
2344 XSetICValues (FRAME_XIC (f), XNStatusAttributes, attr, NULL);
2345 XFree (attr);
177c0ea7 2346
5a7df7d7
GM
2347 FRAME_XIC_FONTSET (f) = xfs;
2348}
2349
2350#endif /* HAVE_X_I18N */
2351
2352
9ef48a9d 2353\f
8fc2766b
RS
2354#ifdef USE_X_TOOLKIT
2355
2356/* Create and set up the X widget for frame F. */
f58534a3 2357
01f1ba30 2358static void
ebd15611 2359x_window (struct frame *f, long window_prompting, int minibuffer_only)
01f1ba30 2360{
9ef48a9d 2361 XClassHint class_hints;
31ac8d8c
FP
2362 XSetWindowAttributes attributes;
2363 unsigned long attribute_mask;
9ef48a9d
RS
2364 Widget shell_widget;
2365 Widget pane_widget;
6c32dd68 2366 Widget frame_widget;
9ef48a9d
RS
2367 Arg al [25];
2368 int ac;
2369
2370 BLOCK_INPUT;
2371
b7975ee4
KH
2372 /* Use the resource name as the top-level widget name
2373 for looking up resources. Make a non-Lisp copy
2374 for the window manager, so GC relocation won't bother it.
2375
2376 Elsewhere we specify the window name for the window manager. */
177c0ea7 2377
cca176a0 2378 {
51b59d79 2379 char *str = SSDATA (Vx_resource_name);
b7975ee4 2380 f->namebuf = (char *) xmalloc (strlen (str) + 1);
cca176a0
KH
2381 strcpy (f->namebuf, str);
2382 }
9ef48a9d
RS
2383
2384 ac = 0;
2385 XtSetArg (al[ac], XtNallowShellResize, 1); ac++;
2386 XtSetArg (al[ac], XtNinput, 1); ac++;
97787173 2387 XtSetArg (al[ac], XtNmappedWhenManaged, 0); ac++;
be786000 2388 XtSetArg (al[ac], XtNborderWidth, f->border_width); ac++;
9b2956e2
GM
2389 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2390 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2391 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
cca176a0 2392 shell_widget = XtAppCreateShell (f->namebuf, EMACS_CLASS,
7a994728 2393 applicationShellWidgetClass,
82c90203 2394 FRAME_X_DISPLAY (f), al, ac);
9ef48a9d 2395
7556890b 2396 f->output_data.x->widget = shell_widget;
9ef48a9d
RS
2397 /* maybe_set_screen_title_format (shell_widget); */
2398
6c32dd68
PR
2399 pane_widget = lw_create_widget ("main", "pane", widget_id_tick++,
2400 (widget_value *) NULL,
2401 shell_widget, False,
2402 (lw_callback) NULL,
2403 (lw_callback) NULL,
b6e11efd 2404 (lw_callback) NULL,
6c32dd68 2405 (lw_callback) NULL);
9ef48a9d 2406
9b2956e2
GM
2407 ac = 0;
2408 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2409 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2410 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
723f5a07 2411 XtSetArg (al[ac], XtNborderWidth, 0); ac++;
9b2956e2 2412 XtSetValues (pane_widget, al, ac);
7556890b 2413 f->output_data.x->column_widget = pane_widget;
a7f7d550 2414
177c0ea7 2415 /* mappedWhenManaged to false tells to the paned window to not map/unmap
5e65b9ab 2416 the emacs screen when changing menubar. This reduces flickering. */
9ef48a9d
RS
2417
2418 ac = 0;
2419 XtSetArg (al[ac], XtNmappedWhenManaged, 0); ac++;
2420 XtSetArg (al[ac], XtNshowGrip, 0); ac++;
2421 XtSetArg (al[ac], XtNallowResize, 1); ac++;
2422 XtSetArg (al[ac], XtNresizeToPreferred, 1); ac++;
2423 XtSetArg (al[ac], XtNemacsFrame, f); ac++;
9b2956e2
GM
2424 XtSetArg (al[ac], XtNvisual, FRAME_X_VISUAL (f)); ac++;
2425 XtSetArg (al[ac], XtNdepth, FRAME_X_DISPLAY_INFO (f)->n_planes); ac++;
2426 XtSetArg (al[ac], XtNcolormap, FRAME_X_COLORMAP (f)); ac++;
723f5a07 2427 XtSetArg (al[ac], XtNborderWidth, 0); ac++;
9b2956e2
GM
2428 frame_widget = XtCreateWidget (f->namebuf, emacsFrameClass, pane_widget,
2429 al, ac);
177c0ea7 2430
7556890b 2431 f->output_data.x->edit_widget = frame_widget;
177c0ea7
JB
2432
2433 XtManageChild (frame_widget);
a7f7d550
FP
2434
2435 /* Do some needed geometry management. */
2436 {
2437 int len;
2438 char *tem, shell_position[32];
8a94ea33
PE
2439 Arg gal[10];
2440 int gac = 0;
5031cc10 2441 int extra_borders = 0;
177c0ea7 2442 int menubar_size
7556890b
RS
2443 = (f->output_data.x->menubar_widget
2444 ? (f->output_data.x->menubar_widget->core.height
2445 + f->output_data.x->menubar_widget->core.border_width)
8fc2766b 2446 : 0);
a7f7d550 2447
f7008aff
RS
2448#if 0 /* Experimentally, we now get the right results
2449 for -geometry -0-0 without this. 24 Aug 96, rms. */
01cbdba5
RS
2450 if (FRAME_EXTERNAL_MENU_BAR (f))
2451 {
dd254b21 2452 Dimension ibw = 0;
01cbdba5
RS
2453 XtVaGetValues (pane_widget, XtNinternalBorderWidth, &ibw, NULL);
2454 menubar_size += ibw;
2455 }
f7008aff 2456#endif
01cbdba5 2457
7556890b 2458 f->output_data.x->menubar_height = menubar_size;
00983aba 2459
440b0bfd 2460#ifndef USE_LUCID
5031cc10
KH
2461 /* Motif seems to need this amount added to the sizes
2462 specified for the shell widget. The Athena/Lucid widgets don't.
2463 Both conclusions reached experimentally. -- rms. */
440b0bfd
RS
2464 XtVaGetValues (f->output_data.x->edit_widget, XtNinternalBorderWidth,
2465 &extra_borders, NULL);
2466 extra_borders *= 2;
2467#endif
5031cc10 2468
97787173
RS
2469 /* Convert our geometry parameters into a geometry string
2470 and specify it.
2471 Note that we do not specify here whether the position
2472 is a user-specified or program-specified one.
2473 We pass that information later, in x_wm_set_size_hints. */
2474 {
be786000 2475 int left = f->left_pos;
97787173 2476 int xneg = window_prompting & XNegative;
be786000 2477 int top = f->top_pos;
97787173
RS
2478 int yneg = window_prompting & YNegative;
2479 if (xneg)
2480 left = -left;
2481 if (yneg)
2482 top = -top;
c760f47e
KH
2483
2484 if (window_prompting & USPosition)
5031cc10 2485 sprintf (shell_position, "=%dx%d%c%d%c%d",
be786000
KS
2486 FRAME_PIXEL_WIDTH (f) + extra_borders,
2487 FRAME_PIXEL_HEIGHT (f) + menubar_size + extra_borders,
c760f47e
KH
2488 (xneg ? '-' : '+'), left,
2489 (yneg ? '-' : '+'), top);
2490 else
6b61353c
KH
2491 {
2492 sprintf (shell_position, "=%dx%d",
2493 FRAME_PIXEL_WIDTH (f) + extra_borders,
2494 FRAME_PIXEL_HEIGHT (f) + menubar_size + extra_borders);
2495
2496 /* Setting x and y when the position is not specified in
2497 the geometry string will set program position in the WM hints.
2498 If Emacs had just one program position, we could set it in
2499 fallback resources, but since each make-frame call can specify
2500 different program positions, this is easier. */
8a94ea33
PE
2501 XtSetArg (gal[gac], XtNx, left); gac++;
2502 XtSetArg (gal[gac], XtNy, top); gac++;
6b61353c 2503 }
97787173
RS
2504 }
2505
a7f7d550 2506 len = strlen (shell_position) + 1;
77110caa
RS
2507 /* We don't free this because we don't know whether
2508 it is safe to free it while the frame exists.
2509 It isn't worth the trouble of arranging to free it
2510 when the frame is deleted. */
a7f7d550
FP
2511 tem = (char *) xmalloc (len);
2512 strncpy (tem, shell_position, len);
8a94ea33
PE
2513 XtSetArg (gal[gac], XtNgeometry, tem); gac++;
2514 XtSetValues (shell_widget, gal, gac);
a7f7d550
FP
2515 }
2516
9ef48a9d
RS
2517 XtManageChild (pane_widget);
2518 XtRealizeWidget (shell_widget);
2519
2532f20c
JD
2520 if (FRAME_X_EMBEDDED_P (f))
2521 XReparentWindow (FRAME_X_DISPLAY (f), XtWindow (shell_widget),
2522 f->output_data.x->parent_desc, 0, 0);
2523
177c0ea7 2524 FRAME_X_WINDOW (f) = XtWindow (frame_widget);
9ef48a9d
RS
2525
2526 validate_x_resource_name ();
b7975ee4 2527
51b59d79
PE
2528 class_hints.res_name = SSDATA (Vx_resource_name);
2529 class_hints.res_class = SSDATA (Vx_resource_class);
b9dc4443 2530 XSetClassHint (FRAME_X_DISPLAY (f), XtWindow (shell_widget), &class_hints);
5a7df7d7
GM
2531
2532#ifdef HAVE_X_I18N
2533 FRAME_XIC (f) = NULL;
1576f1ad
DL
2534 if (use_xim)
2535 create_frame_xic (f);
5a7df7d7 2536#endif
64d16748 2537
7556890b
RS
2538 f->output_data.x->wm_hints.input = True;
2539 f->output_data.x->wm_hints.flags |= InputHint;
b9dc4443 2540 XSetWMHints (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
7556890b 2541 &f->output_data.x->wm_hints);
b8228beb 2542
c4ec904f 2543 hack_wm_protocols (f, shell_widget);
9ef48a9d 2544
6c32dd68
PR
2545#ifdef HACK_EDITRES
2546 XtAddEventHandler (shell_widget, 0, True, _XEditResCheckMessages, 0);
2547#endif
2548
9ef48a9d 2549 /* Do a stupid property change to force the server to generate a
333b20bb 2550 PropertyNotify event so that the event_stream server timestamp will
9ef48a9d
RS
2551 be initialized to something relevant to the time we created the window.
2552 */
6c32dd68 2553 XChangeProperty (XtDisplay (frame_widget), XtWindow (frame_widget),
b9dc4443
RS
2554 FRAME_X_DISPLAY_INFO (f)->Xatom_wm_protocols,
2555 XA_ATOM, 32, PropModeAppend,
9ef48a9d
RS
2556 (unsigned char*) NULL, 0);
2557
5a7df7d7 2558 /* Make all the standard events reach the Emacs frame. */
31ac8d8c 2559 attributes.event_mask = STANDARD_EVENT_SET;
5a7df7d7
GM
2560
2561#ifdef HAVE_X_I18N
2562 if (FRAME_XIC (f))
2563 {
2564 /* XIM server might require some X events. */
2565 unsigned long fevent = NoEventMask;
6b61353c 2566 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
5a7df7d7
GM
2567 attributes.event_mask |= fevent;
2568 }
2569#endif /* HAVE_X_I18N */
177c0ea7 2570
31ac8d8c
FP
2571 attribute_mask = CWEventMask;
2572 XChangeWindowAttributes (XtDisplay (shell_widget), XtWindow (shell_widget),
2573 attribute_mask, &attributes);
2574
6c32dd68 2575 XtMapWidget (frame_widget);
9ef48a9d 2576
8fc2766b
RS
2577 /* x_set_name normally ignores requests to set the name if the
2578 requested name is the same as the current name. This is the one
2579 place where that assumption isn't correct; f->name is set, but
2580 the X server hasn't been told. */
2581 {
2582 Lisp_Object name;
2583 int explicit = f->explicit_name;
2584
2585 f->explicit_name = 0;
2586 name = f->name;
2587 f->name = Qnil;
2588 x_set_name (f, name, explicit);
2589 }
2590
b9dc4443 2591 XDefineCursor (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
db3b2dc8
JD
2592 f->output_data.x->current_cursor
2593 = f->output_data.x->text_cursor);
8fc2766b
RS
2594
2595 UNBLOCK_INPUT;
2596
495fa05e
GM
2597 /* This is a no-op, except under Motif. Make sure main areas are
2598 set to something reasonable, in case we get an error later. */
2599 lw_set_main_areas (pane_widget, 0, frame_widget);
8fc2766b
RS
2600}
2601
9ef48a9d 2602#else /* not USE_X_TOOLKIT */
488dd4c4 2603#ifdef USE_GTK
f78faa98 2604static void
971de7fb 2605x_window (FRAME_PTR f)
488dd4c4
JD
2606{
2607 if (! xg_create_frame_widgets (f))
2608 error ("Unable to create window");
1fcfb866
JD
2609
2610#ifdef HAVE_X_I18N
2611 FRAME_XIC (f) = NULL;
6b61353c 2612 if (use_xim)
1576f1ad
DL
2613 {
2614 BLOCK_INPUT;
2615 create_frame_xic (f);
2616 if (FRAME_XIC (f))
2617 {
2618 /* XIM server might require some X events. */
2619 unsigned long fevent = NoEventMask;
6b61353c 2620 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
1fcfb866 2621
1576f1ad
DL
2622 if (fevent != NoEventMask)
2623 {
2624 XSetWindowAttributes attributes;
2625 XWindowAttributes wattr;
2626 unsigned long attribute_mask;
2627
2628 XGetWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2629 &wattr);
2630 attributes.event_mask = wattr.your_event_mask | fevent;
2631 attribute_mask = CWEventMask;
2632 XChangeWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2633 attribute_mask, &attributes);
2634 }
2635 }
2636 UNBLOCK_INPUT;
2637 }
1fcfb866 2638#endif
488dd4c4 2639}
9ef48a9d 2640
488dd4c4 2641#else /*! USE_GTK */
8fc2766b
RS
2642/* Create and set up the X window for frame F. */
2643
f78faa98 2644static void
0521f580 2645x_window (struct frame *f)
8fc2766b
RS
2646{
2647 XClassHint class_hints;
2648 XSetWindowAttributes attributes;
2649 unsigned long attribute_mask;
2650
5bcee7ef 2651 attributes.background_pixel = FRAME_BACKGROUND_PIXEL (f);
7556890b 2652 attributes.border_pixel = f->output_data.x->border_pixel;
01f1ba30
JB
2653 attributes.bit_gravity = StaticGravity;
2654 attributes.backing_store = NotUseful;
2655 attributes.save_under = True;
2656 attributes.event_mask = STANDARD_EVENT_SET;
9b2956e2
GM
2657 attributes.colormap = FRAME_X_COLORMAP (f);
2658 attribute_mask = (CWBackPixel | CWBorderPixel | CWBitGravity | CWEventMask
2659 | CWColormap);
01f1ba30
JB
2660
2661 BLOCK_INPUT;
fe24a618 2662 FRAME_X_WINDOW (f)
b9dc4443 2663 = XCreateWindow (FRAME_X_DISPLAY (f),
7556890b 2664 f->output_data.x->parent_desc,
be786000
KS
2665 f->left_pos,
2666 f->top_pos,
2667 FRAME_PIXEL_WIDTH (f), FRAME_PIXEL_HEIGHT (f),
2668 f->border_width,
01f1ba30
JB
2669 CopyFromParent, /* depth */
2670 InputOutput, /* class */
383d6ffc 2671 FRAME_X_VISUAL (f),
01f1ba30 2672 attribute_mask, &attributes);
5a7df7d7
GM
2673
2674#ifdef HAVE_X_I18N
4dacadcc 2675 if (use_xim)
5a7df7d7 2676 {
1576f1ad
DL
2677 create_frame_xic (f);
2678 if (FRAME_XIC (f))
2679 {
2680 /* XIM server might require some X events. */
2681 unsigned long fevent = NoEventMask;
6b61353c 2682 XGetICValues (FRAME_XIC (f), XNFilterEvents, &fevent, NULL);
1576f1ad
DL
2683 attributes.event_mask |= fevent;
2684 attribute_mask = CWEventMask;
2685 XChangeWindowAttributes (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
2686 attribute_mask, &attributes);
2687 }
5a7df7d7
GM
2688 }
2689#endif /* HAVE_X_I18N */
177c0ea7 2690
d387c960 2691 validate_x_resource_name ();
b7975ee4 2692
51b59d79
PE
2693 class_hints.res_name = SSDATA (Vx_resource_name);
2694 class_hints.res_class = SSDATA (Vx_resource_class);
b9dc4443 2695 XSetClassHint (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), &class_hints);
01f1ba30 2696
00983aba
KH
2697 /* The menubar is part of the ordinary display;
2698 it does not count in addition to the height of the window. */
7556890b 2699 f->output_data.x->menubar_height = 0;
00983aba 2700
179956b9
JB
2701 /* This indicates that we use the "Passive Input" input model.
2702 Unless we do this, we don't get the Focus{In,Out} events that we
2703 need to draw the cursor correctly. Accursed bureaucrats.
b9dc4443 2704 XWhipsAndChains (FRAME_X_DISPLAY (f), IronMaiden, &TheRack); */
179956b9 2705
7556890b
RS
2706 f->output_data.x->wm_hints.input = True;
2707 f->output_data.x->wm_hints.flags |= InputHint;
b9dc4443 2708 XSetWMHints (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
7556890b 2709 &f->output_data.x->wm_hints);
6d078211 2710 f->output_data.x->wm_hints.icon_pixmap = None;
179956b9 2711
032e4ebe
RS
2712 /* Request "save yourself" and "delete window" commands from wm. */
2713 {
2714 Atom protocols[2];
b9dc4443
RS
2715 protocols[0] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_delete_window;
2716 protocols[1] = FRAME_X_DISPLAY_INFO (f)->Xatom_wm_save_yourself;
2717 XSetWMProtocols (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), protocols, 2);
032e4ebe 2718 }
9ef48a9d 2719
e373f201
JB
2720 /* x_set_name normally ignores requests to set the name if the
2721 requested name is the same as the current name. This is the one
2722 place where that assumption isn't correct; f->name is set, but
2723 the X server hasn't been told. */
2724 {
98381190 2725 Lisp_Object name;
cf177271 2726 int explicit = f->explicit_name;
e373f201 2727
cf177271 2728 f->explicit_name = 0;
98381190
KH
2729 name = f->name;
2730 f->name = Qnil;
cf177271 2731 x_set_name (f, name, explicit);
e373f201
JB
2732 }
2733
b9dc4443 2734 XDefineCursor (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
72ec0c8d
JD
2735 f->output_data.x->current_cursor
2736 = f->output_data.x->text_cursor);
9ef48a9d 2737
01f1ba30
JB
2738 UNBLOCK_INPUT;
2739
fe24a618 2740 if (FRAME_X_WINDOW (f) == 0)
9ef48a9d 2741 error ("Unable to create window");
01f1ba30
JB
2742}
2743
488dd4c4 2744#endif /* not USE_GTK */
8fc2766b
RS
2745#endif /* not USE_X_TOOLKIT */
2746
289978b5
LT
2747/* Verify that the icon position args for this window are valid. */
2748
2749static void
971de7fb 2750x_icon_verify (struct frame *f, Lisp_Object parms)
289978b5
LT
2751{
2752 Lisp_Object icon_x, icon_y;
2753
2754 /* Set the position of the icon. Note that twm groups all
2755 icons in an icon window. */
2756 icon_x = x_frame_get_and_record_arg (f, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
2757 icon_y = x_frame_get_and_record_arg (f, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
2758 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
2759 {
2760 CHECK_NUMBER (icon_x);
2761 CHECK_NUMBER (icon_y);
2762 }
2763 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
2764 error ("Both left and top icon corners of icon must be specified");
2765}
2766
01f1ba30
JB
2767/* Handle the icon stuff for this window. Perhaps later we might
2768 want an x_set_icon_position which can be called interactively as
b9dc4443 2769 well. */
01f1ba30
JB
2770
2771static void
971de7fb 2772x_icon (struct frame *f, Lisp_Object parms)
01f1ba30 2773{
f9942c9e 2774 Lisp_Object icon_x, icon_y;
fd0f53a9 2775#if 0
abb4b7ec 2776 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
fd0f53a9 2777#endif
01f1ba30
JB
2778
2779 /* Set the position of the icon. Note that twm groups all
b9dc4443 2780 icons in an icon window. */
7c0d3ed8
KS
2781 icon_x = x_frame_get_and_record_arg (f, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
2782 icon_y = x_frame_get_and_record_arg (f, parms, Qicon_top, 0, 0, RES_TYPE_NUMBER);
f9942c9e 2783 if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
01f1ba30 2784 {
b7826503
PJ
2785 CHECK_NUMBER (icon_x);
2786 CHECK_NUMBER (icon_y);
01f1ba30 2787 }
f9942c9e 2788 else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
01f1ba30 2789 error ("Both left and top icon corners of icon must be specified");
01f1ba30 2790
f9942c9e
JB
2791 BLOCK_INPUT;
2792
fe24a618
JB
2793 if (! EQ (icon_x, Qunbound))
2794 x_wm_set_icon_position (f, XINT (icon_x), XINT (icon_y));
f9942c9e 2795
a9d54793
KL
2796#if 0 /* x_get_arg removes the visibility parameter as a side effect,
2797 but x_create_frame still needs it. */
01f1ba30 2798 /* Start up iconic or window? */
49795535 2799 x_wm_set_window_state
333b20bb
GM
2800 (f, (EQ (x_get_arg (dpyinfo, parms, Qvisibility, 0, 0, RES_TYPE_SYMBOL),
2801 Qicon)
49795535
JB
2802 ? IconicState
2803 : NormalState));
a9d54793 2804#endif
01f1ba30 2805
51b59d79
PE
2806 x_text_icon (f, SSDATA ((!NILP (f->icon_name)
2807 ? f->icon_name
2808 : f->name)));
80534dd6 2809
01f1ba30
JB
2810 UNBLOCK_INPUT;
2811}
2812
b243755a 2813/* Make the GCs needed for this window, setting the
01f1ba30
JB
2814 background, border and mouse colors; also create the
2815 mouse cursor and the gray border tile. */
2816
2817static void
971de7fb 2818x_make_gc (struct frame *f)
01f1ba30
JB
2819{
2820 XGCValues gc_values;
01f1ba30 2821
6afb1d07
JB
2822 BLOCK_INPUT;
2823
b243755a 2824 /* Create the GCs of this frame.
9ef48a9d 2825 Note that many default values are used. */
01f1ba30 2826
ce593f6e
KL
2827 gc_values.foreground = FRAME_FOREGROUND_PIXEL (f);
2828 gc_values.background = FRAME_BACKGROUND_PIXEL (f);
9ef48a9d 2829 gc_values.line_width = 0; /* Means 1 using fast algorithm. */
959e647d
GM
2830 f->output_data.x->normal_gc
2831 = XCreateGC (FRAME_X_DISPLAY (f),
2832 FRAME_X_WINDOW (f),
b51238f5 2833 GCLineWidth | GCForeground | GCBackground,
959e647d 2834 &gc_values);
01f1ba30 2835
b9dc4443 2836 /* Reverse video style. */
ce593f6e
KL
2837 gc_values.foreground = FRAME_BACKGROUND_PIXEL (f);
2838 gc_values.background = FRAME_FOREGROUND_PIXEL (f);
959e647d
GM
2839 f->output_data.x->reverse_gc
2840 = XCreateGC (FRAME_X_DISPLAY (f),
2841 FRAME_X_WINDOW (f),
b51238f5 2842 GCForeground | GCBackground | GCLineWidth,
959e647d 2843 &gc_values);
01f1ba30 2844
9ef48a9d 2845 /* Cursor has cursor-color background, background-color foreground. */
ce593f6e 2846 gc_values.foreground = FRAME_BACKGROUND_PIXEL (f);
7556890b 2847 gc_values.background = f->output_data.x->cursor_pixel;
01f1ba30 2848 gc_values.fill_style = FillOpaqueStippled;
7556890b 2849 f->output_data.x->cursor_gc
b9dc4443 2850 = XCreateGC (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
b51238f5 2851 (GCForeground | GCBackground
c8bcd18a 2852 | GCFillStyle | GCLineWidth),
01f1ba30
JB
2853 &gc_values);
2854
333b20bb
GM
2855 /* Reliefs. */
2856 f->output_data.x->white_relief.gc = 0;
2857 f->output_data.x->black_relief.gc = 0;
2858
01f1ba30 2859 /* Create the gray border tile used when the pointer is not in
f676886a 2860 the frame. Since this depends on the frame's pixel values,
9ef48a9d 2861 this must be done on a per-frame basis. */
7556890b 2862 f->output_data.x->border_tile
d043f1a4 2863 = (XCreatePixmapFromBitmapData
177c0ea7 2864 (FRAME_X_DISPLAY (f), FRAME_X_DISPLAY_INFO (f)->root_window,
d043f1a4 2865 gray_bits, gray_width, gray_height,
ce593f6e
KL
2866 FRAME_FOREGROUND_PIXEL (f),
2867 FRAME_BACKGROUND_PIXEL (f),
ab452f99 2868 DefaultDepth (FRAME_X_DISPLAY (f), FRAME_X_SCREEN_NUMBER (f))));
6afb1d07
JB
2869
2870 UNBLOCK_INPUT;
01f1ba30 2871}
01f1ba30 2872
959e647d 2873
2b34df4e 2874/* Free what was allocated in x_make_gc. */
959e647d
GM
2875
2876void
971de7fb 2877x_free_gcs (struct frame *f)
959e647d
GM
2878{
2879 Display *dpy = FRAME_X_DISPLAY (f);
2880
2881 BLOCK_INPUT;
177c0ea7 2882
959e647d
GM
2883 if (f->output_data.x->normal_gc)
2884 {
2885 XFreeGC (dpy, f->output_data.x->normal_gc);
2886 f->output_data.x->normal_gc = 0;
2887 }
2888
2889 if (f->output_data.x->reverse_gc)
2890 {
2891 XFreeGC (dpy, f->output_data.x->reverse_gc);
2892 f->output_data.x->reverse_gc = 0;
2893 }
177c0ea7 2894
959e647d
GM
2895 if (f->output_data.x->cursor_gc)
2896 {
2897 XFreeGC (dpy, f->output_data.x->cursor_gc);
2898 f->output_data.x->cursor_gc = 0;
2899 }
2900
2901 if (f->output_data.x->border_tile)
2902 {
2903 XFreePixmap (dpy, f->output_data.x->border_tile);
2904 f->output_data.x->border_tile = 0;
2905 }
2906
2907 UNBLOCK_INPUT;
2908}
2909
2910
eaf1eea9
GM
2911/* Handler for signals raised during x_create_frame and
2912 x_create_top_frame. FRAME is the frame which is partially
2913 constructed. */
2914
2915static Lisp_Object
971de7fb 2916unwind_create_frame (Lisp_Object frame)
eaf1eea9
GM
2917{
2918 struct frame *f = XFRAME (frame);
2919
8346e08b
KL
2920 /* If frame is already dead, nothing to do. This can happen if the
2921 display is disconnected after the frame has become official, but
2922 before x_create_frame removes the unwind protect. */
2923 if (!FRAME_LIVE_P (f))
2924 return Qnil;
2925
eaf1eea9
GM
2926 /* If frame is ``official'', nothing to do. */
2927 if (!CONSP (Vframe_list) || !EQ (XCAR (Vframe_list), frame))
2928 {
f1d2ce7f 2929#if GLYPH_DEBUG
eaf1eea9
GM
2930 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
2931#endif
177c0ea7 2932
eaf1eea9
GM
2933 x_free_frame_resources (f);
2934
5b3f8550 2935#if GLYPH_DEBUG
eaf1eea9
GM
2936 /* Check that reference counts are indeed correct. */
2937 xassert (dpyinfo->reference_count == dpyinfo_refcount);
2938 xassert (dpyinfo->image_cache->refcount == image_cache_refcount);
5b3f8550 2939#endif
c844a81a 2940 return Qt;
eaf1eea9 2941 }
177c0ea7 2942
eaf1eea9
GM
2943 return Qnil;
2944}
2945
b51238f5 2946
02ed2ea8 2947static void
971de7fb 2948x_default_font_parameter (struct frame *f, Lisp_Object parms)
02ed2ea8
KH
2949{
2950 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
770e2e6e 2951 Lisp_Object font_param = x_get_arg (dpyinfo, parms, Qfont, NULL, NULL,
637fa988 2952 RES_TYPE_STRING);
e9b7ab96 2953 Lisp_Object font = Qnil;
770e2e6e 2954 if (EQ (font_param, Qunbound))
0d1d0d26
JD
2955 font_param = Qnil;
2956
2957 if (NILP (font_param))
637fa988 2958 {
5fc8e5bc 2959 /* System font should take precedendce over X resources. We suggest this
0d1d0d26
JD
2960 regardless of font-use-system-font because .emacs may not have been
2961 read yet. */
2962 const char *system_font = xsettings_get_system_font ();
e9b7ab96
JD
2963 if (system_font)
2964 {
2965 char *name = xstrdup (system_font);
2966 font = font_open_by_name (f, name);
baad03f0 2967 xfree (name);
e9b7ab96 2968 }
637fa988 2969 }
0d1d0d26 2970
e9b7ab96
JD
2971 if (NILP (font))
2972 font = !NILP (font_param) ? font_param
2973 : x_get_arg (dpyinfo, parms, Qfont, "font", "Font", RES_TYPE_STRING);
2974
2975 if (! FONTP (font) && ! STRINGP (font))
02ed2ea8 2976 {
675e2c69 2977 const char *names[]
be9d013a
CY
2978 = {
2979#ifdef HAVE_XFT
d7afccca 2980 /* This will find the normal Xft font. */
c024ac08 2981 "monospace-10",
be9d013a
CY
2982#endif
2983 "-adobe-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-1",
2984 "-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-1",
02ed2ea8
KH
2985 "-*-*-medium-r-normal-*-*-140-*-*-c-*-iso8859-1",
2986 /* This was formerly the first thing tried, but it finds
2987 too many fonts and takes too long. */
2988 "-*-*-medium-r-*-*-*-*-*-*-c-*-iso8859-1",
2989 /* If those didn't work, look for something which will
2990 at least work. */
2991 "-*-fixed-*-*-*-*-*-140-*-*-c-*-iso8859-1",
25c25256 2992 "fixed",
02ed2ea8
KH
2993 NULL };
2994 int i;
2995
2996 for (i = 0; names[i]; i++)
2997 {
2998 font = font_open_by_name (f, names[i]);
2999 if (! NILP (font))
3000 break;
3001 }
3002 if (NILP (font))
25c25256 3003 error ("No suitable font was found");
02ed2ea8 3004 }
770e2e6e 3005 else if (!NILP (font_param))
27129af9
SM
3006 {
3007 /* Remember the explicit font parameter, so we can re-apply it after
3008 we've applied the `default' face settings. */
770e2e6e
SM
3009 x_set_frame_parameters (f, Fcons (Fcons (Qfont_param, font_param), Qnil));
3010 }
637fa988 3011
5fc8e5bc
J
3012 /* This call will make X resources override any system font setting. */
3013 x_default_parameter (f, parms, Qfont, font, "font", "Font", RES_TYPE_STRING);
02ed2ea8 3014}
b51238f5 3015
eaf1eea9 3016
1c44e124
CY
3017DEFUN ("x-wm-set-size-hint", Fx_wm_set_size_hint, Sx_wm_set_size_hint,
3018 0, 1, 0,
3019 doc: /* Send the size hints for frame FRAME to the window manager.
3020If FRAME is nil, use the selected frame. */)
5842a27b 3021 (Lisp_Object frame)
1c44e124
CY
3022{
3023 struct frame *f;
3024 if (NILP (frame))
3025 frame = selected_frame;
3026 f = XFRAME (frame);
3027 BLOCK_INPUT;
3b18571d
CY
3028 if (FRAME_X_P (f))
3029 x_wm_set_size_hint (f, 0, 0);
1c44e124 3030 UNBLOCK_INPUT;
653a3150 3031 return Qnil;
1c44e124
CY
3032}
3033
3e6bec3b
JD
3034static void
3035set_machine_and_pid_properties (struct frame *f)
3036{
ac61e7e1 3037 long pid = (long) getpid ();
3e6bec3b 3038
66b16767
J
3039 /* This will set WM_CLIENT_MACHINE and WM_LOCALE_NAME. */
3040 XSetWMProperties (FRAME_X_DISPLAY (f), FRAME_OUTER_WINDOW (f), NULL, NULL,
3041 NULL, 0, NULL, NULL, NULL);
3e6bec3b
JD
3042 XChangeProperty (FRAME_X_DISPLAY (f),
3043 FRAME_OUTER_WINDOW (f),
3044 XInternAtom (FRAME_X_DISPLAY (f),
3045 "_NET_WM_PID",
3046 False),
3047 XA_CARDINAL, 32, PropModeReplace,
3048 (unsigned char *) &pid, 1);
3049}
3050
f676886a 3051DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
01f1ba30 3052 1, 1, 0,
7ee72033 3053 doc: /* Make a new X window, which is called a "frame" in Emacs terms.
d29a9848 3054Return an Emacs frame object.
e0079d39 3055PARMS is an alist of frame parameters.
c061c855
GM
3056If the parameters specify that the frame should not have a minibuffer,
3057and do not specify a specific minibuffer window to use,
3058then `default-minibuffer-frame' must be a frame whose minibuffer can
3059be shared by the new frame.
3060
7ee72033 3061This function is an internal primitive--use `make-frame' instead. */)
5842a27b 3062 (Lisp_Object parms)
01f1ba30 3063{
f676886a 3064 struct frame *f;
2365c027 3065 Lisp_Object frame, tem;
01f1ba30
JB
3066 Lisp_Object name;
3067 int minibuffer_only = 0;
3068 long window_prompting = 0;
45d45af5 3069 int width, height;
331379bf 3070 int count = SPECPDL_INDEX ();
ecaca587 3071 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
b9dc4443 3072 Lisp_Object display;
333b20bb 3073 struct x_display_info *dpyinfo = NULL;
a59e4f3d 3074 Lisp_Object parent;
e557f19d 3075 struct kboard *kb;
01f1ba30 3076
5fa98fcf
RS
3077 parms = Fcopy_alist (parms);
3078
b7975ee4
KH
3079 /* Use this general default value to start with
3080 until we know if this frame has a specified name. */
3081 Vx_resource_name = Vinvocation_name;
3082
6ed8eeff 3083 display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_NUMBER);
1705c933 3084 if (EQ (display, Qunbound))
b6660415 3085 display = x_get_arg (dpyinfo, parms, Qdisplay, 0, 0, RES_TYPE_STRING);
b9dc4443
RS
3086 if (EQ (display, Qunbound))
3087 display = Qnil;
3088 dpyinfo = check_x_display_info (display);
6ed8eeff 3089 kb = dpyinfo->terminal->kboard;
b9dc4443 3090
89acb56d
SM
3091 if (!dpyinfo->terminal->name)
3092 error ("Terminal is not live, can't create new frames on it");
ab797f65 3093
333b20bb 3094 name = x_get_arg (dpyinfo, parms, Qname, "name", "Name", RES_TYPE_STRING);
6a5e54e2 3095 if (!STRINGP (name)
cf177271
JB
3096 && ! EQ (name, Qunbound)
3097 && ! NILP (name))
08a90d6a 3098 error ("Invalid frame name--not a string or nil");
01f1ba30 3099
b7975ee4
KH
3100 if (STRINGP (name))
3101 Vx_resource_name = name;
3102
a59e4f3d 3103 /* See if parent window is specified. */
333b20bb 3104 parent = x_get_arg (dpyinfo, parms, Qparent_id, NULL, NULL, RES_TYPE_NUMBER);
a59e4f3d
RS
3105 if (EQ (parent, Qunbound))
3106 parent = Qnil;
3107 if (! NILP (parent))
b7826503 3108 CHECK_NUMBER (parent);
a59e4f3d 3109
ecaca587
RS
3110 /* make_frame_without_minibuffer can run Lisp code and garbage collect. */
3111 /* No need to protect DISPLAY because that's not used after passing
3112 it to make_frame_without_minibuffer. */
3113 frame = Qnil;
3114 GCPRO4 (parms, parent, name, frame);
333b20bb
GM
3115 tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
3116 RES_TYPE_SYMBOL);
f9942c9e 3117 if (EQ (tem, Qnone) || NILP (tem))
2526c290 3118 f = make_frame_without_minibuffer (Qnil, kb, display);
f9942c9e 3119 else if (EQ (tem, Qonly))
01f1ba30 3120 {
f676886a 3121 f = make_minibuffer_frame ();
01f1ba30
JB
3122 minibuffer_only = 1;
3123 }
6a5e54e2 3124 else if (WINDOWP (tem))
2526c290 3125 f = make_frame_without_minibuffer (tem, kb, display);
f9942c9e
JB
3126 else
3127 f = make_frame (1);
01f1ba30 3128
ecaca587
RS
3129 XSETFRAME (frame, f);
3130
a3c87d4e
JB
3131 /* Note that X Windows does support scroll bars. */
3132 FRAME_CAN_HAVE_SCROLL_BARS (f) = 1;
179956b9 3133
6ed8eeff
KL
3134 f->terminal = dpyinfo->terminal;
3135 f->terminal->reference_count++;
428a555e 3136
08a90d6a 3137 f->output_method = output_x_window;
7556890b 3138 f->output_data.x = (struct x_output *) xmalloc (sizeof (struct x_output));
72af86bd 3139 memset (f->output_data.x, 0, sizeof (struct x_output));
7556890b 3140 f->output_data.x->icon_bitmap = -1;
be786000 3141 FRAME_FONTSET (f) = -1;
333b20bb
GM
3142 f->output_data.x->scroll_bar_foreground_pixel = -1;
3143 f->output_data.x->scroll_bar_background_pixel = -1;
f15340b7
MB
3144#ifdef USE_TOOLKIT_SCROLL_BARS
3145 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
3146 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
3147#endif /* USE_TOOLKIT_SCROLL_BARS */
08a90d6a 3148
f468da95 3149 f->icon_name
333b20bb
GM
3150 = x_get_arg (dpyinfo, parms, Qicon_name, "iconName", "Title",
3151 RES_TYPE_STRING);
f468da95
RS
3152 if (! STRINGP (f->icon_name))
3153 f->icon_name = Qnil;
80534dd6 3154
08a90d6a 3155 FRAME_X_DISPLAY_INFO (f) = dpyinfo;
e3d56613
RS
3156
3157 /* With FRAME_X_DISPLAY_INFO set up, this unwind-protect is safe. */
3158 record_unwind_protect (unwind_create_frame, frame);
08a90d6a 3159
9b2956e2
GM
3160 /* These colors will be set anyway later, but it's important
3161 to get the color reference counts right, so initialize them! */
3162 {
3163 Lisp_Object black;
58d2d479 3164 struct gcpro inner_gcpro1;
cefecbcf
GM
3165
3166 /* Function x_decode_color can signal an error. Make
3167 sure to initialize color slots so that we won't try
3168 to free colors we haven't allocated. */
ce593f6e
KL
3169 FRAME_FOREGROUND_PIXEL (f) = -1;
3170 FRAME_BACKGROUND_PIXEL (f) = -1;
cefecbcf
GM
3171 f->output_data.x->cursor_pixel = -1;
3172 f->output_data.x->cursor_foreground_pixel = -1;
3173 f->output_data.x->border_pixel = -1;
3174 f->output_data.x->mouse_pixel = -1;
177c0ea7 3175
9b2956e2 3176 black = build_string ("black");
7082eac6 3177 GCPRO1_VAR (black, inner_gcpro);
ce593f6e 3178 FRAME_FOREGROUND_PIXEL (f)
9b2956e2 3179 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
ce593f6e 3180 FRAME_BACKGROUND_PIXEL (f)
9b2956e2
GM
3181 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3182 f->output_data.x->cursor_pixel
3183 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3184 f->output_data.x->cursor_foreground_pixel
3185 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3186 f->output_data.x->border_pixel
3187 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
3188 f->output_data.x->mouse_pixel
3189 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
7082eac6 3190 UNGCPRO_VAR (inner_gcpro);
9b2956e2
GM
3191 }
3192
a59e4f3d
RS
3193 /* Specify the parent under which to make this X window. */
3194
3195 if (!NILP (parent))
3196 {
8c239ac3 3197 f->output_data.x->parent_desc = (Window) XFASTINT (parent);
7556890b 3198 f->output_data.x->explicit_parent = 1;
a59e4f3d
RS
3199 }
3200 else
3201 {
7556890b
RS
3202 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
3203 f->output_data.x->explicit_parent = 0;
a59e4f3d
RS
3204 }
3205
cf177271
JB
3206 /* Set the name; the functions to which we pass f expect the name to
3207 be set. */
3208 if (EQ (name, Qunbound) || NILP (name))
3209 {
08a90d6a 3210 f->name = build_string (dpyinfo->x_id_name);
cf177271
JB
3211 f->explicit_name = 0;
3212 }
3213 else
3214 {
3215 f->name = name;
3216 f->explicit_name = 1;
9ef48a9d
RS
3217 /* use the frame's title when getting resources for this frame. */
3218 specbind (Qx_resource_name, name);
cf177271 3219 }
01f1ba30 3220
02ed2ea8
KH
3221 f->resx = dpyinfo->resx;
3222 f->resy = dpyinfo->resy;
3223
02ed2ea8
KH
3224#ifdef HAVE_FREETYPE
3225#ifdef HAVE_XFT
b51238f5 3226 register_font_driver (&xftfont_driver, f);
02ed2ea8 3227#else /* not HAVE_XFT */
b51238f5 3228 register_font_driver (&ftxfont_driver, f);
02ed2ea8
KH
3229#endif /* not HAVE_XFT */
3230#endif /* HAVE_FREETYPE */
6332668d 3231 register_font_driver (&xfont_driver, f);
297cc20a 3232
b51238f5
KH
3233 x_default_parameter (f, parms, Qfont_backend, Qnil,
3234 "fontBackend", "FontBackend", RES_TYPE_STRING);
02ed2ea8 3235
01f1ba30
JB
3236 /* Extract the window parameters from the supplied values
3237 that are needed to determine window geometry. */
b51238f5 3238 x_default_font_parameter (f, parms);
62d168d8
CY
3239 if (!FRAME_FONT (f))
3240 {
3241 delete_frame (frame, Qnoelisp);
3242 error ("Invalid frame font");
3243 }
9ef48a9d 3244
2532f20c
JD
3245 /* Frame contents get displaced if an embedded X window has a border. */
3246 if (! FRAME_X_EMBEDDED_P (f))
4bef8d26 3247 x_default_parameter (f, parms, Qborder_width, make_number (0),
2532f20c 3248 "borderWidth", "BorderWidth", RES_TYPE_NUMBER);
177c0ea7 3249
4e397688 3250 /* This defaults to 1 in order to match xterm. We recognize either
ddf768c3
JB
3251 internalBorderWidth or internalBorder (which is what xterm calls
3252 it). */
3253 if (NILP (Fassq (Qinternal_border_width, parms)))
3254 {
3255 Lisp_Object value;
3256
abb4b7ec 3257 value = x_get_arg (dpyinfo, parms, Qinternal_border_width,
333b20bb 3258 "internalBorder", "internalBorder", RES_TYPE_NUMBER);
ddf768c3
JB
3259 if (! EQ (value, Qunbound))
3260 parms = Fcons (Fcons (Qinternal_border_width, value),
3261 parms);
3262 }
a099c27a
SM
3263 x_default_parameter (f, parms, Qinternal_border_width,
3264#ifdef USE_GTK /* We used to impose 0 in xg_create_frame_widgets. */
3265 make_number (0),
3266#else
3267 make_number (1),
3268#endif
333b20bb
GM
3269 "internalBorderWidth", "internalBorderWidth",
3270 RES_TYPE_NUMBER);
303500aa
CY
3271 x_default_parameter (f, parms, Qvertical_scroll_bars,
3272#if defined(USE_GTK) && defined(USE_TOOLKIT_SCROLL_BARS)
3273 Qright,
3274#else
3275 Qleft,
3276#endif
333b20bb
GM
3277 "verticalScrollBars", "ScrollBars",
3278 RES_TYPE_SYMBOL);
01f1ba30 3279
b9dc4443 3280 /* Also do the stuff which must be set before the window exists. */
cf177271 3281 x_default_parameter (f, parms, Qforeground_color, build_string ("black"),
333b20bb 3282 "foreground", "Foreground", RES_TYPE_STRING);
cf177271 3283 x_default_parameter (f, parms, Qbackground_color, build_string ("white"),
0b60fc91 3284 "background", "Background", RES_TYPE_STRING);
cf177271 3285 x_default_parameter (f, parms, Qmouse_color, build_string ("black"),
333b20bb 3286 "pointerColor", "Foreground", RES_TYPE_STRING);
cf177271 3287 x_default_parameter (f, parms, Qborder_color, build_string ("black"),
333b20bb 3288 "borderColor", "BorderColor", RES_TYPE_STRING);
d62c8769
GM
3289 x_default_parameter (f, parms, Qscreen_gamma, Qnil,
3290 "screenGamma", "ScreenGamma", RES_TYPE_FLOAT);
563b67aa
GM
3291 x_default_parameter (f, parms, Qline_spacing, Qnil,
3292 "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
b3ba0aa8
KS
3293 x_default_parameter (f, parms, Qleft_fringe, Qnil,
3294 "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
3295 x_default_parameter (f, parms, Qright_fringe, Qnil,
3296 "rightFringe", "RightFringe", RES_TYPE_NUMBER);
333b20bb
GM
3297
3298 x_default_scroll_bar_color_parameter (f, parms, Qscroll_bar_foreground,
3299 "scrollBarForeground",
3300 "ScrollBarForeground", 1);
3301 x_default_scroll_bar_color_parameter (f, parms, Qscroll_bar_background,
3302 "scrollBarBackground",
3303 "ScrollBarBackground", 0);
3304
3305 /* Init faces before x_default_parameter is called for scroll-bar
3306 parameters because that function calls x_set_scroll_bar_width,
3307 which calls change_frame_size, which calls Fset_window_buffer,
3308 which runs hooks, which call Fvertical_motion. At the end, we
3309 end up in init_iterator with a null face cache, which should not
3310 happen. */
3311 init_frame_faces (f);
177c0ea7 3312
7d7d0045
CY
3313#if GLYPH_DEBUG
3314 image_cache_refcount = FRAME_IMAGE_CACHE (f)->refcount;
3315 dpyinfo_refcount = dpyinfo->reference_count;
3316#endif /* GLYPH_DEBUG */
3317
6431f2e6
CY
3318 /* The X resources controlling the menu-bar and tool-bar are
3319 processed specially at startup, and reflected in the mode
3320 variables; ignore them here. */
3321 x_default_parameter (f, parms, Qmenu_bar_lines,
3322 NILP (Vmenu_bar_mode)
3323 ? make_number (0) : make_number (1),
3324 NULL, NULL, RES_TYPE_NUMBER);
3325 x_default_parameter (f, parms, Qtool_bar_lines,
3326 NILP (Vtool_bar_mode)
3327 ? make_number (0) : make_number (1),
3328 NULL, NULL, RES_TYPE_NUMBER);
3329
79873d50 3330 x_default_parameter (f, parms, Qbuffer_predicate, Qnil,
333b20bb
GM
3331 "bufferPredicate", "BufferPredicate",
3332 RES_TYPE_SYMBOL);
c2304e02 3333 x_default_parameter (f, parms, Qtitle, Qnil,
333b20bb 3334 "title", "Title", RES_TYPE_STRING);
ea0a1f53
GM
3335 x_default_parameter (f, parms, Qwait_for_wm, Qt,
3336 "waitForWM", "WaitForWM", RES_TYPE_BOOLEAN);
49d41073
EZ
3337 x_default_parameter (f, parms, Qfullscreen, Qnil,
3338 "fullscreen", "Fullscreen", RES_TYPE_SYMBOL);
2b4e6277
J
3339 x_default_parameter (f, parms, Qtool_bar_position,
3340 f->tool_bar_position, 0, 0, RES_TYPE_SYMBOL);
90eb1019 3341
35f59f6b 3342 /* Compute the size of the X window. */
7c0d3ed8 3343 window_prompting = x_figure_window_size (f, parms, 1);
38d22040 3344
495fa05e
GM
3345 tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
3346 f->no_split = minibuffer_only || EQ (tem, Qt);
3347
289978b5
LT
3348 x_icon_verify (f, parms);
3349
6a1bcd01 3350 /* Create the X widget or window. */
a7f7d550
FP
3351#ifdef USE_X_TOOLKIT
3352 x_window (f, window_prompting, minibuffer_only);
3353#else
f676886a 3354 x_window (f);
a7f7d550 3355#endif
177c0ea7 3356
f676886a
JB
3357 x_icon (f, parms);
3358 x_make_gc (f);
01f1ba30 3359
495fa05e
GM
3360 /* Now consider the frame official. */
3361 FRAME_X_DISPLAY_INFO (f)->reference_count++;
3362 Vframe_list = Fcons (frame, Vframe_list);
3363
f9942c9e
JB
3364 /* We need to do this after creating the X window, so that the
3365 icon-creation functions can say whose icon they're describing. */
84f25880 3366 x_default_parameter (f, parms, Qicon_type, Qt,
333b20bb 3367 "bitmapIcon", "BitmapIcon", RES_TYPE_SYMBOL);
f9942c9e 3368
cf177271 3369 x_default_parameter (f, parms, Qauto_raise, Qnil,
333b20bb 3370 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
cf177271 3371 x_default_parameter (f, parms, Qauto_lower, Qnil,
333b20bb 3372 "autoLower", "AutoRaiseLower", RES_TYPE_BOOLEAN);
dbc4e1c1 3373 x_default_parameter (f, parms, Qcursor_type, Qbox,
333b20bb 3374 "cursorType", "CursorType", RES_TYPE_SYMBOL);
28d7281d
GM
3375 x_default_parameter (f, parms, Qscroll_bar_width, Qnil,
3376 "scrollBarWidth", "ScrollBarWidth",
3377 RES_TYPE_NUMBER);
271a71c7
GM
3378 x_default_parameter (f, parms, Qalpha, Qnil,
3379 "alpha", "Alpha", RES_TYPE_NUMBER);
f9942c9e 3380
be786000 3381 /* Dimensions, especially FRAME_LINES (f), must be done via change_frame_size.
01f1ba30 3382 Change will not be effected unless different from the current
be786000
KS
3383 FRAME_LINES (f). */
3384 width = FRAME_COLS (f);
3385 height = FRAME_LINES (f);
177c0ea7 3386
be786000
KS
3387 SET_FRAME_COLS (f, 0);
3388 FRAME_LINES (f) = 0;
8938a4fb 3389 change_frame_size (f, height, width, 1, 0, 0);
d043f1a4 3390
488dd4c4 3391#if defined (USE_X_TOOLKIT) || defined (USE_GTK)
495fa05e
GM
3392 /* Create the menu bar. */
3393 if (!minibuffer_only && FRAME_EXTERNAL_MENU_BAR (f))
3394 {
3395 /* If this signals an error, we haven't set size hints for the
3396 frame and we didn't make it visible. */
3397 initialize_frame_menubar (f);
3398
488dd4c4 3399#ifndef USE_GTK
495fa05e
GM
3400 /* This is a no-op, except under Motif where it arranges the
3401 main window for the widgets on it. */
3402 lw_set_main_areas (f->output_data.x->column_widget,
3403 f->output_data.x->menubar_widget,
3404 f->output_data.x->edit_widget);
488dd4c4 3405#endif /* not USE_GTK */
495fa05e 3406 }
488dd4c4 3407#endif /* USE_X_TOOLKIT || USE_GTK */
495fa05e
GM
3408
3409 /* Tell the server what size and position, etc, we want, and how
3410 badly we want them. This should be done after we have the menu
3411 bar so that its size can be taken into account. */
01f1ba30 3412 BLOCK_INPUT;
7989f084 3413 x_wm_set_size_hint (f, window_prompting, 0);
01f1ba30
JB
3414 UNBLOCK_INPUT;
3415
495fa05e
GM
3416 /* Make the window appear on the frame and enable display, unless
3417 the caller says not to. However, with explicit parent, Emacs
3418 cannot control visibility, so don't try. */
7556890b 3419 if (! f->output_data.x->explicit_parent)
a59e4f3d
RS
3420 {
3421 Lisp_Object visibility;
49795535 3422
333b20bb
GM
3423 visibility = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0,
3424 RES_TYPE_SYMBOL);
a59e4f3d
RS
3425 if (EQ (visibility, Qunbound))
3426 visibility = Qt;
49795535 3427
a59e4f3d
RS
3428 if (EQ (visibility, Qicon))
3429 x_iconify_frame (f);
3430 else if (! NILP (visibility))
3431 x_make_frame_visible (f);
3432 else
6b437900
PE
3433 {
3434 /* Must have been Qnil. */
3435 }
a59e4f3d 3436 }
01f1ba30 3437
3e6bec3b 3438 BLOCK_INPUT;
717c30e0 3439
3e6bec3b
JD
3440 /* Set machine name and pid for the purpose of window managers. */
3441 set_machine_and_pid_properties(f);
3442
6b61353c
KH
3443 /* Set the WM leader property. GTK does this itself, so this is not
3444 needed when using GTK. */
3445 if (dpyinfo->client_leader_window != 0)
3446 {
6b61353c
KH
3447 XChangeProperty (FRAME_X_DISPLAY (f),
3448 FRAME_OUTER_WINDOW (f),
3449 dpyinfo->Xatom_wm_client_leader,
3450 XA_WINDOW, 32, PropModeReplace,
47c53789 3451 (unsigned char *) &dpyinfo->client_leader_window, 1);
6b61353c
KH
3452 }
3453
3e6bec3b
JD
3454 UNBLOCK_INPUT;
3455
225c13a5 3456 /* Initialize `default-minibuffer-frame' in case this is the first
6ed8eeff 3457 frame on this terminal. */
225c13a5 3458 if (FRAME_HAS_MINIBUF_P (f)
1344aad4
TT
3459 && (!FRAMEP (KVAR (kb, Vdefault_minibuffer_frame))
3460 || !FRAME_LIVE_P (XFRAME (KVAR (kb, Vdefault_minibuffer_frame)))))
3461 KVAR (kb, Vdefault_minibuffer_frame) = frame;
225c13a5 3462
5fa98fcf
RS
3463 /* All remaining specified parameters, which have not been "used"
3464 by x_get_arg and friends, now go in the misc. alist of the frame. */
9beb8baa 3465 for (tem = parms; CONSP (tem); tem = XCDR (tem))
5fa98fcf
RS
3466 if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
3467 f->param_alist = Fcons (XCAR (tem), f->param_alist);
3468
495fa05e 3469 UNGCPRO;
9e57df62
GM
3470
3471 /* Make sure windows on this frame appear in calls to next-window
3472 and similar functions. */
3473 Vwindow_list = Qnil;
177c0ea7 3474
9ef48a9d 3475 return unbind_to (count, frame);
01f1ba30
JB
3476}
3477
eaf1eea9 3478
0d17d282
KH
3479/* FRAME is used only to get a handle on the X display. We don't pass the
3480 display info directly because we're called from frame.c, which doesn't
3481 know about that structure. */
e4f79258 3482
87498171 3483Lisp_Object
971de7fb 3484x_get_focus_frame (struct frame *frame)
87498171 3485{
0d17d282 3486 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (frame);
87498171 3487 Lisp_Object xfocus;
0d17d282 3488 if (! dpyinfo->x_focus_frame)
87498171
KH
3489 return Qnil;
3490
0d17d282 3491 XSETFRAME (xfocus, dpyinfo->x_focus_frame);
87498171
KH
3492 return xfocus;
3493}
f0614854 3494
3decc1e7
GM
3495
3496/* In certain situations, when the window manager follows a
3497 click-to-focus policy, there seems to be no way around calling
3498 XSetInputFocus to give another frame the input focus .
3499
3500 In an ideal world, XSetInputFocus should generally be avoided so
3501 that applications don't interfere with the window manager's focus
3502 policy. But I think it's okay to use when it's clearly done
3503 following a user-command. */
3504
a7ca3326 3505DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
7ee72033
MB
3506 doc: /* Set the input focus to FRAME.
3507FRAME nil means use the selected frame. */)
5842a27b 3508 (Lisp_Object frame)
3decc1e7
GM
3509{
3510 struct frame *f = check_x_frame (frame);
3511 Display *dpy = FRAME_X_DISPLAY (f);
3decc1e7
GM
3512
3513 BLOCK_INPUT;
9ba8e10d 3514 x_catch_errors (dpy);
3decc1e7
GM
3515 XSetInputFocus (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
3516 RevertToParent, CurrentTime);
457a6b0a 3517 x_ewmh_activate_frame (f);
4545fa20 3518 x_uncatch_errors ();
3decc1e7 3519 UNBLOCK_INPUT;
177c0ea7 3520
3decc1e7
GM
3521 return Qnil;
3522}
3523
f0614854 3524\f
2d764c78 3525DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
4f4f2973
GM
3526 doc: /* Internal function called by `color-defined-p', which see
3527.\(Note that the Nextstep version of this function ignores FRAME.) */)
5842a27b 3528 (Lisp_Object color, Lisp_Object frame)
e12d55b2 3529{
b9dc4443
RS
3530 XColor foo;
3531 FRAME_PTR f = check_x_frame (frame);
e12d55b2 3532
b7826503 3533 CHECK_STRING (color);
b9dc4443 3534
42a5b22f 3535 if (x_defined_color (f, SSDATA (color), &foo, 0))
e12d55b2
RS
3536 return Qt;
3537 else
3538 return Qnil;
3539}
3540
2d764c78 3541DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
7ee72033 3542 doc: /* Internal function called by `color-values', which see. */)
5842a27b 3543 (Lisp_Object color, Lisp_Object frame)
01f1ba30 3544{
b9dc4443
RS
3545 XColor foo;
3546 FRAME_PTR f = check_x_frame (frame);
3547
b7826503 3548 CHECK_STRING (color);
01f1ba30 3549
42a5b22f 3550 if (x_defined_color (f, SSDATA (color), &foo, 0))
a508663b
KS
3551 return list3 (make_number (foo.red),
3552 make_number (foo.green),
3553 make_number (foo.blue));
01f1ba30
JB
3554 else
3555 return Qnil;
3556}
3557
a7ca3326 3558DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
7ee72033 3559 doc: /* Internal function called by `display-color-p', which see. */)
5842a27b 3560 (Lisp_Object terminal)
01f1ba30 3561{
6ed8eeff 3562 struct x_display_info *dpyinfo = check_x_display_info (terminal);
11ae94fe 3563
b9dc4443 3564 if (dpyinfo->n_planes <= 2)
01f1ba30
JB
3565 return Qnil;
3566
b9dc4443 3567 switch (dpyinfo->visual->class)
01f1ba30
JB
3568 {
3569 case StaticColor:
3570 case PseudoColor:
3571 case TrueColor:
3572 case DirectColor:
3573 return Qt;
3574
3575 default:
3576 return Qnil;
3577 }
3578}
3579
a7ca3326 3580DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p, Sx_display_grayscale_p,
c061c855 3581 0, 1, 0,
7ee72033 3582 doc: /* Return t if the X display supports shades of gray.
c061c855 3583Note that color displays do support shades of gray.
6ed8eeff 3584The optional argument TERMINAL specifies which display to ask about.
708e05dc 3585TERMINAL should be a terminal object, a frame or a display name (a string).
7ee72033 3586If omitted or nil, that stands for the selected frame's display. */)
5842a27b 3587 (Lisp_Object terminal)
d0c9d219 3588{
6ed8eeff 3589 struct x_display_info *dpyinfo = check_x_display_info (terminal);
d0c9d219 3590
ae6b58f9 3591 if (dpyinfo->n_planes <= 1)
b9dc4443
RS
3592 return Qnil;
3593
ae6b58f9
RS
3594 switch (dpyinfo->visual->class)
3595 {
3596 case StaticColor:
3597 case PseudoColor:
3598 case TrueColor:
3599 case DirectColor:
3600 case StaticGray:
3601 case GrayScale:
3602 return Qt;
3603
3604 default:
3605 return Qnil;
3606 }
d0c9d219
RS
3607}
3608
41beb8fc 3609DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
c061c855 3610 0, 1, 0,
d29a9848 3611 doc: /* Return the width in pixels of the X display TERMINAL.
6ed8eeff 3612The optional argument TERMINAL specifies which display to ask about.
708e05dc 3613TERMINAL should be a terminal object, a frame or a display name (a string).
7ee72033 3614If omitted or nil, that stands for the selected frame's display. */)
5842a27b 3615 (Lisp_Object terminal)
41beb8fc 3616{
6ed8eeff 3617 struct x_display_info *dpyinfo = check_x_display_info (terminal);
b9dc4443 3618
abe9d29c 3619 return make_number (x_display_pixel_width (dpyinfo));
41beb8fc
RS
3620}
3621
3622DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
c061c855 3623 Sx_display_pixel_height, 0, 1, 0,
d29a9848 3624 doc: /* Return the height in pixels of the X display TERMINAL.
6ed8eeff 3625The optional argument TERMINAL specifies which display to ask about.
708e05dc 3626TERMINAL should be a terminal object, a frame or a display name (a string).
7ee72033 3627If omitted or nil, that stands for the selected frame's display. */)
5842a27b 3628 (Lisp_Object terminal)
41beb8fc 3629{
6ed8eeff 3630 struct x_display_info *dpyinfo = check_x_display_info (terminal);
b9dc4443 3631
abe9d29c 3632 return make_number (x_display_pixel_height (dpyinfo));
41beb8fc
RS
3633}
3634
3635DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
c061c855 3636 0, 1, 0,
d29a9848 3637 doc: /* Return the number of bitplanes of the X display TERMINAL.
6ed8eeff 3638The optional argument TERMINAL specifies which display to ask about.
708e05dc 3639TERMINAL should be a terminal object, a frame or a display name (a string).
7ee72033 3640If omitted or nil, that stands for the selected frame's display. */)
5842a27b 3641 (Lisp_Object terminal)
41beb8fc 3642{
6ed8eeff 3643 struct x_display_info *dpyinfo = check_x_display_info (terminal);
b9dc4443
RS
3644
3645 return make_number (dpyinfo->n_planes);
41beb8fc
RS
3646}
3647
3648DEFUN ("x-display-color-cells", Fx_display_color_cells, Sx_display_color_cells,
c061c855 3649 0, 1, 0,
d29a9848 3650 doc: /* Return the number of color cells of the X display TERMINAL.
6ed8eeff 3651The optional argument TERMINAL specifies which display to ask about.
708e05dc 3652TERMINAL should be a terminal object, a frame or a display name (a string).
7ee72033 3653If omitted or nil, that stands for the selected frame's display. */)
5842a27b 3654 (Lisp_Object terminal)
41beb8fc 3655{
6ed8eeff 3656 struct x_display_info *dpyinfo = check_x_display_info (terminal);
b9dc4443 3657
6b61353c
KH
3658 int nr_planes = DisplayPlanes (dpyinfo->display,
3659 XScreenNumberOfScreen (dpyinfo->screen));
3660
3661 /* Truncate nr_planes to 24 to avoid integer overflow.
3662 Some displays says 32, but only 24 bits are actually significant.
3663 There are only very few and rare video cards that have more than
3664 24 significant bits. Also 24 bits is more than 16 million colors,
3665 it "should be enough for everyone". */
3666 if (nr_planes > 24) nr_planes = 24;
3667
3668 return make_number (1 << nr_planes);
41beb8fc
RS
3669}
3670
9d317b2c
RS
3671DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
3672 Sx_server_max_request_size,
c061c855 3673 0, 1, 0,
d29a9848 3674 doc: /* Return the maximum request size of the X server of display TERMINAL.
6ed8eeff 3675The optional argument TERMINAL specifies which display to ask about.
708e05dc 3676TERMINAL should be a terminal object, a frame or a display name (a string).
7ee72033 3677If omitted or nil, that stands for the selected frame's display. */)
5842a27b 3678 (Lisp_Object terminal)
9d317b2c 3679{
6ed8eeff 3680 struct x_display_info *dpyinfo = check_x_display_info (terminal);
b9dc4443
RS
3681
3682 return make_number (MAXREQUEST (dpyinfo->display));
9d317b2c
RS
3683}
3684
41beb8fc 3685DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
d29a9848 3686 doc: /* Return the "vendor ID" string of the X server of display TERMINAL.
95d62d8a
RS
3687\(Labelling every distributor as a "vendor" embodies the false assumption
3688that operating systems cannot be developed and distributed noncommercially.)
6ed8eeff 3689The optional argument TERMINAL specifies which display to ask about.
708e05dc 3690TERMINAL should be a terminal object, a frame or a display name (a string).
7ee72033 3691If omitted or nil, that stands for the selected frame's display. */)
5842a27b 3692 (Lisp_Object terminal)
41beb8fc 3693{
6ed8eeff 3694 struct x_display_info *dpyinfo = check_x_display_info (terminal);
675e2c69 3695 const char *vendor = ServerVendor (dpyinfo->display);
b9dc4443 3696
41beb8fc
RS
3697 if (! vendor) vendor = "";
3698 return build_string (vendor);
3699}
3700
3701DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
d29a9848 3702 doc: /* Return the version numbers of the X server of display TERMINAL.
c061c855 3703The value is a list of three integers: the major and minor
95d62d8a 3704version numbers of the X Protocol in use, and the distributor-specific release
c061c855
GM
3705number. See also the function `x-server-vendor'.
3706
6ed8eeff 3707The optional argument TERMINAL specifies which display to ask about.
708e05dc 3708TERMINAL should be a terminal object, a frame or a display name (a string).
7ee72033 3709If omitted or nil, that stands for the selected frame's display. */)
5842a27b 3710 (Lisp_Object terminal)
41beb8fc 3711{
6ed8eeff 3712 struct x_display_info *dpyinfo = check_x_display_info (terminal);
b9dc4443 3713 Display *dpy = dpyinfo->display;
11ae94fe 3714
41beb8fc
RS
3715 return Fcons (make_number (ProtocolVersion (dpy)),
3716 Fcons (make_number (ProtocolRevision (dpy)),
3717 Fcons (make_number (VendorRelease (dpy)), Qnil)));
3718}
3719
3720DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
6ed8eeff
KL
3721 doc: /* Return the number of screens on the X server of display TERMINAL.
3722The optional argument TERMINAL specifies which display to ask about.
708e05dc 3723TERMINAL should be a terminal object, a frame or a display name (a string).
7ee72033 3724If omitted or nil, that stands for the selected frame's display. */)
5842a27b 3725 (Lisp_Object terminal)
41beb8fc 3726{
6ed8eeff 3727 struct x_display_info *dpyinfo = check_x_display_info (terminal);
b9dc4443
RS
3728
3729 return make_number (ScreenCount (dpyinfo->display));
41beb8fc
RS
3730}
3731
3732DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height, 0, 1, 0,
6ed8eeff
KL
3733 doc: /* Return the height in millimeters of the X display TERMINAL.
3734The optional argument TERMINAL specifies which display to ask about.
708e05dc 3735TERMINAL should be a terminal object, a frame or a display name (a string).
7ee72033 3736If omitted or nil, that stands for the selected frame's display. */)
5842a27b 3737 (Lisp_Object terminal)
41beb8fc 3738{
6ed8eeff 3739 struct x_display_info *dpyinfo = check_x_display_info (terminal);
b9dc4443
RS
3740
3741 return make_number (HeightMMOfScreen (dpyinfo->screen));
41beb8fc
RS
3742}
3743
3744DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width, 0, 1, 0,
6ed8eeff
KL
3745 doc: /* Return the width in millimeters of the X display TERMINAL.
3746The optional argument TERMINAL specifies which display to ask about.
708e05dc 3747TERMINAL should be a terminal object, a frame or a display name (a string).
7ee72033 3748If omitted or nil, that stands for the selected frame's display. */)
5842a27b 3749 (Lisp_Object terminal)
41beb8fc 3750{
6ed8eeff 3751 struct x_display_info *dpyinfo = check_x_display_info (terminal);
b9dc4443
RS
3752
3753 return make_number (WidthMMOfScreen (dpyinfo->screen));
41beb8fc
RS
3754}
3755
3756DEFUN ("x-display-backing-store", Fx_display_backing_store,
c061c855 3757 Sx_display_backing_store, 0, 1, 0,
d29a9848 3758 doc: /* Return an indication of whether X display TERMINAL does backing store.
c061c855 3759The value may be `always', `when-mapped', or `not-useful'.
6ed8eeff 3760The optional argument TERMINAL specifies which display to ask about.
708e05dc 3761TERMINAL should be a terminal object, a frame or a display name (a string).
7ee72033 3762If omitted or nil, that stands for the selected frame's display. */)
5842a27b 3763 (Lisp_Object terminal)
41beb8fc 3764{
6ed8eeff 3765 struct x_display_info *dpyinfo = check_x_display_info (terminal);
8ec8a5ec 3766 Lisp_Object result;
11ae94fe 3767
b9dc4443 3768 switch (DoesBackingStore (dpyinfo->screen))
41beb8fc
RS
3769 {
3770 case Always:
8ec8a5ec
GM
3771 result = intern ("always");
3772 break;
41beb8fc
RS
3773
3774 case WhenMapped:
8ec8a5ec
GM
3775 result = intern ("when-mapped");
3776 break;
41beb8fc
RS
3777
3778 case NotUseful:
8ec8a5ec
GM
3779 result = intern ("not-useful");
3780 break;
41beb8fc
RS
3781
3782 default:
3783 error ("Strange value for BackingStore parameter of screen");
8ec8a5ec 3784 result = Qnil;
41beb8fc 3785 }
8ec8a5ec
GM
3786
3787 return result;
41beb8fc
RS
3788}
3789
3790DEFUN ("x-display-visual-class", Fx_display_visual_class,
c061c855 3791 Sx_display_visual_class, 0, 1, 0,
6ed8eeff 3792 doc: /* Return the visual class of the X display TERMINAL.
c061c855
GM
3793The value is one of the symbols `static-gray', `gray-scale',
3794`static-color', `pseudo-color', `true-color', or `direct-color'.
3795
6ed8eeff 3796The optional argument TERMINAL specifies which display to ask about.
708e05dc 3797TERMINAL should a terminal object, a frame or a display name (a string).
7ee72033 3798If omitted or nil, that stands for the selected frame's display. */)
5842a27b 3799 (Lisp_Object terminal)
41beb8fc 3800{
6ed8eeff 3801 struct x_display_info *dpyinfo = check_x_display_info (terminal);
8ec8a5ec 3802 Lisp_Object result;
11ae94fe 3803
b9dc4443 3804 switch (dpyinfo->visual->class)
41beb8fc 3805 {
8ec8a5ec
GM
3806 case StaticGray:
3807 result = intern ("static-gray");
3808 break;
3809 case GrayScale:
3810 result = intern ("gray-scale");
3811 break;
3812 case StaticColor:
3813 result = intern ("static-color");
3814 break;
3815 case PseudoColor:
3816 result = intern ("pseudo-color");
3817 break;
3818 case TrueColor:
3819 result = intern ("true-color");
3820 break;
3821 case DirectColor:
3822 result = intern ("direct-color");
3823 break;
41beb8fc
RS
3824 default:
3825 error ("Display has an unknown visual class");
8ec8a5ec 3826 result = Qnil;
41beb8fc 3827 }
177c0ea7 3828
8ec8a5ec 3829 return result;
41beb8fc
RS
3830}
3831
3832DEFUN ("x-display-save-under", Fx_display_save_under,
c061c855 3833 Sx_display_save_under, 0, 1, 0,
d29a9848 3834 doc: /* Return t if the X display TERMINAL supports the save-under feature.
6ed8eeff 3835The optional argument TERMINAL specifies which display to ask about.
708e05dc 3836TERMINAL should be a terminal object, a frame or a display name (a string).
7ee72033 3837If omitted or nil, that stands for the selected frame's display. */)
5842a27b 3838 (Lisp_Object terminal)
41beb8fc 3839{
6ed8eeff 3840 struct x_display_info *dpyinfo = check_x_display_info (terminal);
11ae94fe 3841
b9dc4443 3842 if (DoesSaveUnders (dpyinfo->screen) == True)
41beb8fc
RS
3843 return Qt;
3844 else
3845 return Qnil;
3846}
3847\f
b9dc4443 3848int
971de7fb 3849x_pixel_width (register struct frame *f)
01f1ba30 3850{
be786000 3851 return FRAME_PIXEL_WIDTH (f);
01f1ba30
JB
3852}
3853
b9dc4443 3854int
971de7fb 3855x_pixel_height (register struct frame *f)
01f1ba30 3856{
be786000 3857 return FRAME_PIXEL_HEIGHT (f);
55caf99c
RS
3858}
3859
b9dc4443 3860int
971de7fb 3861x_char_width (register struct frame *f)
55caf99c 3862{
be786000 3863 return FRAME_COLUMN_WIDTH (f);
55caf99c
RS
3864}
3865
b9dc4443 3866int
971de7fb 3867x_char_height (register struct frame *f)
55caf99c 3868{
be786000 3869 return FRAME_LINE_HEIGHT (f);
01f1ba30 3870}
b9dc4443 3871
a6ad00c0
GM
3872
3873\f
3874/************************************************************************
3875 X Displays
3876 ************************************************************************/
3877
01f1ba30 3878\f
a6ad00c0
GM
3879/* Mapping visual names to visuals. */
3880
3881static struct visual_class
3882{
675e2c69 3883 const char *name;
a6ad00c0
GM
3884 int class;
3885}
3886visual_classes[] =
3887{
3888 {"StaticGray", StaticGray},
3889 {"GrayScale", GrayScale},
3890 {"StaticColor", StaticColor},
3891 {"PseudoColor", PseudoColor},
3892 {"TrueColor", TrueColor},
3893 {"DirectColor", DirectColor},
9908a324 3894 {NULL, 0}
a6ad00c0
GM
3895};
3896
3897
404daac1 3898#ifndef HAVE_XSCREENNUMBEROFSCREEN
a6ad00c0
GM
3899
3900/* Value is the screen number of screen SCR. This is a substitute for
3901 the X function with the same name when that doesn't exist. */
3902
404daac1
RS
3903int
3904XScreenNumberOfScreen (scr)
3905 register Screen *scr;
3906{
a6ad00c0
GM
3907 Display *dpy = scr->display;
3908 int i;
3df34fdb 3909
a6ad00c0 3910 for (i = 0; i < dpy->nscreens; ++i)
fbd5ceb2 3911 if (scr == dpy->screens + i)
a6ad00c0 3912 break;
404daac1 3913
a6ad00c0 3914 return i;
404daac1 3915}
a6ad00c0 3916
404daac1
RS
3917#endif /* not HAVE_XSCREENNUMBEROFSCREEN */
3918
01f1ba30 3919
a6ad00c0
GM
3920/* Select the visual that should be used on display DPYINFO. Set
3921 members of DPYINFO appropriately. Called from x_term_init. */
fe24a618 3922
a6ad00c0 3923void
971de7fb 3924select_visual (struct x_display_info *dpyinfo)
a6ad00c0
GM
3925{
3926 Display *dpy = dpyinfo->display;
3927 Screen *screen = dpyinfo->screen;
3928 Lisp_Object value;
fe24a618 3929
a6ad00c0
GM
3930 /* See if a visual is specified. */
3931 value = display_x_get_resource (dpyinfo,
3932 build_string ("visualClass"),
3933 build_string ("VisualClass"),
3934 Qnil, Qnil);
3935 if (STRINGP (value))
3936 {
3937 /* VALUE should be of the form CLASS-DEPTH, where CLASS is one
3938 of `PseudoColor', `TrueColor' etc. and DEPTH is the color
3939 depth, a decimal number. NAME is compared with case ignored. */
d5db4077 3940 char *s = (char *) alloca (SBYTES (value) + 1);
a6ad00c0
GM
3941 char *dash;
3942 int i, class = -1;
3943 XVisualInfo vinfo;
3944
42a5b22f 3945 strcpy (s, SSDATA (value));
8966b757 3946 dash = strchr (s, '-');
a6ad00c0
GM
3947 if (dash)
3948 {
3949 dpyinfo->n_planes = atoi (dash + 1);
3950 *dash = '\0';
3951 }
3952 else
3953 /* We won't find a matching visual with depth 0, so that
3954 an error will be printed below. */
3955 dpyinfo->n_planes = 0;
f0614854 3956
a6ad00c0
GM
3957 /* Determine the visual class. */
3958 for (i = 0; visual_classes[i].name; ++i)
05131107 3959 if (xstrcasecmp (s, visual_classes[i].name) == 0)
a6ad00c0
GM
3960 {
3961 class = visual_classes[i].class;
3962 break;
3963 }
01f1ba30 3964
a6ad00c0
GM
3965 /* Look up a matching visual for the specified class. */
3966 if (class == -1
3967 || !XMatchVisualInfo (dpy, XScreenNumberOfScreen (screen),
3968 dpyinfo->n_planes, class, &vinfo))
d5db4077 3969 fatal ("Invalid visual specification `%s'", SDATA (value));
177c0ea7 3970
a6ad00c0
GM
3971 dpyinfo->visual = vinfo.visual;
3972 }
01f1ba30
JB
3973 else
3974 {
a6ad00c0
GM
3975 int n_visuals;
3976 XVisualInfo *vinfo, vinfo_template;
177c0ea7 3977
a6ad00c0
GM
3978 dpyinfo->visual = DefaultVisualOfScreen (screen);
3979
a6ad00c0 3980 vinfo_template.visualid = XVisualIDFromVisual (dpyinfo->visual);
a6ad00c0
GM
3981 vinfo_template.screen = XScreenNumberOfScreen (screen);
3982 vinfo = XGetVisualInfo (dpy, VisualIDMask | VisualScreenMask,
3983 &vinfo_template, &n_visuals);
83725342 3984 if (n_visuals <= 0)
a6ad00c0
GM
3985 fatal ("Can't get proper X visual info");
3986
94ac875b 3987 dpyinfo->n_planes = vinfo->depth;
a6ad00c0
GM
3988 XFree ((char *) vinfo);
3989 }
01f1ba30 3990}
01f1ba30 3991
a6ad00c0 3992
b9dc4443
RS
3993/* Return the X display structure for the display named NAME.
3994 Open a new connection if necessary. */
3995
e4cebfca 3996static struct x_display_info *
971de7fb 3997x_display_info_for_name (Lisp_Object name)
b9dc4443 3998{
08a90d6a 3999 Lisp_Object names;
b9dc4443
RS
4000 struct x_display_info *dpyinfo;
4001
b7826503 4002 CHECK_STRING (name);
b9dc4443 4003
2246281f
KL
4004#if 0
4005 if (! EQ (Vinitial_window_system, intern ("x")))
4006 error ("Not using X Windows"); /* That doesn't stop us anymore. */
4007#endif
806048df 4008
08a90d6a
RS
4009 for (dpyinfo = x_display_list, names = x_display_name_list;
4010 dpyinfo;
8e713be6 4011 dpyinfo = dpyinfo->next, names = XCDR (names))
b9dc4443
RS
4012 {
4013 Lisp_Object tem;
8e713be6 4014 tem = Fstring_equal (XCAR (XCAR (names)), name);
08a90d6a 4015 if (!NILP (tem))
b9dc4443
RS
4016 return dpyinfo;
4017 }
4018
b7975ee4
KH
4019 /* Use this general default value to start with. */
4020 Vx_resource_name = Vinvocation_name;
4021
b9dc4443
RS
4022 validate_x_resource_name ();
4023
9b207e8e 4024 dpyinfo = x_term_init (name, (char *)0,
51b59d79 4025 SSDATA (Vx_resource_name));
b9dc4443 4026
08a90d6a 4027 if (dpyinfo == 0)
d5db4077 4028 error ("Cannot connect to X server %s", SDATA (name));
08a90d6a 4029
b9dc4443
RS
4030 x_in_use = 1;
4031 XSETFASTINT (Vwindow_system_version, 11);
4032
4033 return dpyinfo;
4034}
4035
a6ad00c0 4036
01f1ba30 4037DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
c061c855 4038 1, 3, 0,
4f4f2973 4039 doc: /* Open a connection to a display server.
c061c855
GM
4040DISPLAY is the name of the display to connect to.
4041Optional second arg XRM-STRING is a string of resources in xrdb format.
4042If the optional third arg MUST-SUCCEED is non-nil,
4f4f2973
GM
4043terminate Emacs if we can't open the connection.
4044\(In the Nextstep version, the last two arguments are currently ignored.) */)
5842a27b 4045 (Lisp_Object display, Lisp_Object xrm_string, Lisp_Object must_succeed)
01f1ba30 4046{
5f742c1b 4047 char *xrm_option;
b9dc4443 4048 struct x_display_info *dpyinfo;
01f1ba30 4049
b7826503 4050 CHECK_STRING (display);
d387c960 4051 if (! NILP (xrm_string))
b7826503 4052 CHECK_STRING (xrm_string);
01f1ba30 4053
2246281f
KL
4054#if 0
4055 if (! EQ (Vinitial_window_system, intern ("x")))
4056 error ("Not using X Windows"); /* That doesn't stop us anymore. */
4057#endif
806048df 4058
d387c960 4059 if (! NILP (xrm_string))
5f742c1b 4060 xrm_option = SSDATA (xrm_string);
01f1ba30 4061 else
5f742c1b 4062 xrm_option = (char *) 0;
d387c960
JB
4063
4064 validate_x_resource_name ();
4065
e1b1bee8 4066 /* This is what opens the connection and sets x_current_display.
b9dc4443
RS
4067 This also initializes many symbols, such as those used for input. */
4068 dpyinfo = x_term_init (display, xrm_option,
51b59d79 4069 SSDATA (Vx_resource_name));
f1c16f36 4070
08a90d6a
RS
4071 if (dpyinfo == 0)
4072 {
4073 if (!NILP (must_succeed))
10ffbc14
GM
4074 fatal ("Cannot connect to X server %s.\n\
4075Check the DISPLAY environment variable or use `-d'.\n\
842a9389
JB
4076Also use the `xauth' program to verify that you have the proper\n\
4077authorization information needed to connect the X server.\n\
bf770132 4078An insecure way to solve the problem may be to use `xhost'.\n",
d5db4077 4079 SDATA (display));
08a90d6a 4080 else
d5db4077 4081 error ("Cannot connect to X server %s", SDATA (display));
08a90d6a
RS
4082 }
4083
b9dc4443 4084 x_in_use = 1;
01f1ba30 4085
b9dc4443 4086 XSETFASTINT (Vwindow_system_version, 11);
01f1ba30
JB
4087 return Qnil;
4088}
4089
08a90d6a
RS
4090DEFUN ("x-close-connection", Fx_close_connection,
4091 Sx_close_connection, 1, 1, 0,
00d385b0 4092 doc: /* Close the connection to TERMINAL's X server.
708e05dc 4093For TERMINAL, specify a terminal object, a frame or a display name (a
00d385b0
KL
4094string). If TERMINAL is nil, that stands for the selected frame's
4095terminal. */)
5842a27b 4096 (Lisp_Object terminal)
01f1ba30 4097{
00d385b0 4098 struct x_display_info *dpyinfo = check_x_display_info (terminal);
3457bc6e 4099
08a90d6a
RS
4100 if (dpyinfo->reference_count > 0)
4101 error ("Display still has frames on it");
01f1ba30 4102
6ed8eeff 4103 x_delete_terminal (dpyinfo->terminal);
3457bc6e 4104
01f1ba30
JB
4105 return Qnil;
4106}
4107
08a90d6a 4108DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
7ee72033 4109 doc: /* Return the list of display names that Emacs has connections to. */)
5842a27b 4110 (void)
08a90d6a
RS
4111{
4112 Lisp_Object tail, result;
4113
4114 result = Qnil;
9beb8baa 4115 for (tail = x_display_name_list; CONSP (tail); tail = XCDR (tail))
8e713be6 4116 result = Fcons (XCAR (XCAR (tail)), result);
08a90d6a
RS
4117
4118 return result;
4119}
4120
4121DEFUN ("x-synchronize", Fx_synchronize, Sx_synchronize, 1, 2, 0,
7ee72033 4122 doc: /* If ON is non-nil, report X errors as soon as the erring request is made.
7c051dd8
GM
4123This function only has an effect on X Windows. With MS Windows, it is
4124defined but does nothing.
4125
c061c855
GM
4126If ON is nil, allow buffering of requests.
4127Turning on synchronization prohibits the Xlib routines from buffering
4128requests and seriously degrades performance, but makes debugging much
4129easier.
00d385b0 4130The optional second argument TERMINAL specifies which display to act on.
708e05dc 4131TERMINAL should be a terminal object, a frame or a display name (a string).
00d385b0 4132If TERMINAL is omitted or nil, that stands for the selected frame's display. */)
5842a27b 4133 (Lisp_Object on, Lisp_Object terminal)
01f1ba30 4134{
00d385b0 4135 struct x_display_info *dpyinfo = check_x_display_info (terminal);
11ae94fe 4136
b9dc4443 4137 XSynchronize (dpyinfo->display, !EQ (on, Qnil));
01f1ba30
JB
4138
4139 return Qnil;
4140}
4141
b9dc4443 4142/* Wait for responses to all X commands issued so far for frame F. */
6b7b1820
RS
4143
4144void
971de7fb 4145x_sync (FRAME_PTR f)
6b7b1820 4146{
4e87f4d2 4147 BLOCK_INPUT;
b9dc4443 4148 XSync (FRAME_X_DISPLAY (f), False);
4e87f4d2 4149 UNBLOCK_INPUT;
6b7b1820 4150}
333b20bb 4151
01f1ba30 4152\f
333b20bb 4153/***********************************************************************
6b61353c 4154 Window properties
333b20bb 4155 ***********************************************************************/
f1c16f36 4156
6b61353c
KH
4157DEFUN ("x-change-window-property", Fx_change_window_property,
4158 Sx_change_window_property, 2, 6, 0,
4159 doc: /* Change window property PROP to VALUE on the X window of FRAME.
7c051dd8
GM
4160PROP must be a string. VALUE may be a string or a list of conses,
4161numbers and/or strings. If an element in the list is a string, it is
4162converted to an atom and the value of the atom is used. If an element
4163is a cons, it is converted to a 32 bit number where the car is the 16
4164top bits and the cdr is the lower 16 bits.
4165
6b61353c
KH
4166FRAME nil or omitted means use the selected frame.
4167If TYPE is given and non-nil, it is the name of the type of VALUE.
4168If TYPE is not given or nil, the type is STRING.
4169FORMAT gives the size in bits of each element if VALUE is a list.
4170It must be one of 8, 16 or 32.
4171If VALUE is a string or FORMAT is nil or not given, FORMAT defaults to 8.
4172If OUTER_P is non-nil, the property is changed for the outer X window of
7c051dd8 4173FRAME. Default is to change on the edit X window. */)
5842a27b 4174 (Lisp_Object prop, Lisp_Object value, Lisp_Object frame, Lisp_Object type, Lisp_Object format, Lisp_Object outer_p)
6b61353c
KH
4175{
4176 struct frame *f = check_x_frame (frame);
4177 Atom prop_atom;
4178 Atom target_type = XA_STRING;
4179 int element_format = 8;
4180 unsigned char *data;
4181 int nelements;
4182 Window w;
333b20bb 4183
6b61353c 4184 CHECK_STRING (prop);
333b20bb 4185
6b61353c
KH
4186 if (! NILP (format))
4187 {
4188 CHECK_NUMBER (format);
4189 element_format = XFASTINT (format);
333b20bb 4190
6b61353c
KH
4191 if (element_format != 8 && element_format != 16
4192 && element_format != 32)
4193 error ("FORMAT must be one of 8, 16 or 32");
4194 }
333b20bb 4195
6b61353c
KH
4196 if (CONSP (value))
4197 {
4198 nelements = x_check_property_data (value);
4199 if (nelements == -1)
4200 error ("Bad data in VALUE, must be number, string or cons");
333b20bb 4201
6b61353c
KH
4202 if (element_format == 8)
4203 data = (unsigned char *) xmalloc (nelements);
4204 else if (element_format == 16)
4205 data = (unsigned char *) xmalloc (nelements*2);
fede04ef
JD
4206 else /* format == 32 */
4207 /* The man page for XChangeProperty:
4208 "If the specified format is 32, the property data must be a
4209 long array."
4210 This applies even if long is more than 64 bits. The X library
4211 converts to 32 bits before sending to the X server. */
4212 data = (unsigned char *) xmalloc (nelements * sizeof(long));
333b20bb 4213
6b61353c
KH
4214 x_fill_property_data (FRAME_X_DISPLAY (f), value, data, element_format);
4215 }
4216 else
4217 {
4218 CHECK_STRING (value);
4219 data = SDATA (value);
4220 nelements = SCHARS (value);
4221 }
333b20bb 4222
6b61353c 4223 BLOCK_INPUT;
42a5b22f 4224 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SSDATA (prop), False);
6b61353c
KH
4225 if (! NILP (type))
4226 {
4227 CHECK_STRING (type);
42a5b22f 4228 target_type = XInternAtom (FRAME_X_DISPLAY (f), SSDATA (type), False);
6b61353c 4229 }
333b20bb 4230
6b61353c
KH
4231 if (! NILP (outer_p)) w = FRAME_OUTER_WINDOW (f);
4232 else w = FRAME_X_WINDOW (f);
5b3f8550 4233
6b61353c
KH
4234 XChangeProperty (FRAME_X_DISPLAY (f), w,
4235 prop_atom, target_type, element_format, PropModeReplace,
4236 data, nelements);
333b20bb 4237
6b61353c 4238 if (CONSP (value)) xfree (data);
333b20bb 4239
6b61353c
KH
4240 /* Make sure the property is set when we return. */
4241 XFlush (FRAME_X_DISPLAY (f));
4242 UNBLOCK_INPUT;
333b20bb 4243
6b61353c 4244 return value;
333b20bb
GM
4245}
4246
4247
6b61353c
KH
4248DEFUN ("x-delete-window-property", Fx_delete_window_property,
4249 Sx_delete_window_property, 1, 2, 0,
4250 doc: /* Remove window property PROP from X window of FRAME.
4251FRAME nil or omitted means use the selected frame. Value is PROP. */)
5842a27b 4252 (Lisp_Object prop, Lisp_Object frame)
333b20bb 4253{
6b61353c
KH
4254 struct frame *f = check_x_frame (frame);
4255 Atom prop_atom;
333b20bb 4256
6b61353c
KH
4257 CHECK_STRING (prop);
4258 BLOCK_INPUT;
42a5b22f 4259 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SSDATA (prop), False);
6b61353c 4260 XDeleteProperty (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f), prop_atom);
333b20bb 4261
6b61353c
KH
4262 /* Make sure the property is removed when we return. */
4263 XFlush (FRAME_X_DISPLAY (f));
4264 UNBLOCK_INPUT;
333b20bb 4265
6b61353c
KH
4266 return prop;
4267}
333b20bb 4268
333b20bb 4269
6b61353c
KH
4270DEFUN ("x-window-property", Fx_window_property, Sx_window_property,
4271 1, 6, 0,
4272 doc: /* Value is the value of window property PROP on FRAME.
4273If FRAME is nil or omitted, use the selected frame.
7c051dd8
GM
4274
4275On MS Windows, this function only accepts the PROP and FRAME arguments.
4276
4277On X Windows, the following optional arguments are also accepted:
4278If TYPE is nil or omitted, get the property as a string.
4279Otherwise TYPE is the name of the atom that denotes the type expected.
6b61353c
KH
4280If SOURCE is non-nil, get the property on that window instead of from
4281FRAME. The number 0 denotes the root window.
4282If DELETE_P is non-nil, delete the property after retreiving it.
4283If VECTOR_RET_P is non-nil, don't return a string but a vector of values.
4284
4285Value is nil if FRAME hasn't a property with name PROP or if PROP has
7c051dd8 4286no value of TYPE (always string in the MS Windows case). */)
5842a27b 4287 (Lisp_Object prop, Lisp_Object frame, Lisp_Object type, Lisp_Object source, Lisp_Object delete_p, Lisp_Object vector_ret_p)
333b20bb 4288{
6b61353c
KH
4289 struct frame *f = check_x_frame (frame);
4290 Atom prop_atom;
4291 int rc;
4292 Lisp_Object prop_value = Qnil;
a3db4b26 4293 unsigned char *tmp_data = NULL;
6b61353c
KH
4294 Atom actual_type;
4295 Atom target_type = XA_STRING;
4296 int actual_format;
4297 unsigned long actual_size, bytes_remaining;
4298 Window target_window = FRAME_X_WINDOW (f);
4299 struct gcpro gcpro1;
177c0ea7 4300
6b61353c
KH
4301 GCPRO1 (prop_value);
4302 CHECK_STRING (prop);
1783ffa2 4303
6b61353c
KH
4304 if (! NILP (source))
4305 {
be44ca6c
PE
4306 CONS_TO_INTEGER (source, Window, target_window);
4307 if (! target_window)
4308 target_window = FRAME_X_DISPLAY_INFO (f)->root_window;
333b20bb
GM
4309 }
4310
6b61353c
KH
4311 BLOCK_INPUT;
4312 if (STRINGP (type))
4313 {
42a5b22f 4314 if (strcmp ("AnyPropertyType", SSDATA (type)) == 0)
6b61353c
KH
4315 target_type = AnyPropertyType;
4316 else
42a5b22f 4317 target_type = XInternAtom (FRAME_X_DISPLAY (f), SSDATA (type), False);
6b61353c 4318 }
333b20bb 4319
42a5b22f 4320 prop_atom = XInternAtom (FRAME_X_DISPLAY (f), SSDATA (prop), False);
6b61353c
KH
4321 rc = XGetWindowProperty (FRAME_X_DISPLAY (f), target_window,
4322 prop_atom, 0, 0, False, target_type,
4323 &actual_type, &actual_format, &actual_size,
a3db4b26 4324 &bytes_remaining, &tmp_data);
6b61353c
KH
4325 if (rc == Success)
4326 {
4327 int size = bytes_remaining;
333b20bb 4328
6b61353c
KH
4329 XFree (tmp_data);
4330 tmp_data = NULL;
333b20bb 4331
6b61353c 4332 rc = XGetWindowProperty (FRAME_X_DISPLAY (f), target_window,
333b20bb 4333 prop_atom, 0, bytes_remaining,
6b61353c 4334 ! NILP (delete_p), target_type,
177c0ea7
JB
4335 &actual_type, &actual_format,
4336 &actual_size, &bytes_remaining,
a3db4b26 4337 &tmp_data);
4c8c7926 4338 if (rc == Success && tmp_data)
6b61353c 4339 {
fede04ef
JD
4340 /* The man page for XGetWindowProperty says:
4341 "If the returned format is 32, the returned data is represented
4342 as a long array and should be cast to that type to obtain the
4343 elements."
4344 This applies even if long is more than 32 bits, the X library
4345 converts from 32 bit elements received from the X server to long
72af86bd 4346 and passes the long array to us. Thus, for that case memcpy can not
fede04ef
JD
4347 be used. We convert to a 32 bit type here, because so much code
4348 assume on that.
4349
4350 The bytes and offsets passed to XGetWindowProperty refers to the
4351 property and those are indeed in 32 bit quantities if format is
4352 32. */
4353
2172544b 4354 if (32 < BITS_PER_LONG && actual_format == 32)
fede04ef
JD
4355 {
4356 unsigned long i;
4357 int *idata = (int *) tmp_data;
4358 long *ldata = (long *) tmp_data;
4359
4360 for (i = 0; i < actual_size; ++i)
a3db4b26 4361 idata[i] = (int) ldata[i];
fede04ef
JD
4362 }
4363
6b61353c 4364 if (NILP (vector_ret_p))
5f742c1b 4365 prop_value = make_string ((char *) tmp_data, size);
6b61353c
KH
4366 else
4367 prop_value = x_property_data_to_lisp (f,
a3db4b26 4368 tmp_data,
6b61353c
KH
4369 actual_type,
4370 actual_format,
4371 actual_size);
4372 }
333b20bb 4373
6b61353c 4374 if (tmp_data) XFree (tmp_data);
333b20bb
GM
4375 }
4376
4377 UNBLOCK_INPUT;
6b61353c 4378 UNGCPRO;
333b20bb
GM
4379 return prop_value;
4380}
4381
4382
4383\f
4384/***********************************************************************
4385 Busy cursor
4386 ***********************************************************************/
4387
0af913d7
GM
4388/* Timer function of hourglass_atimer. TIMER is equal to
4389 hourglass_atimer.
4ae9a85e 4390
0af913d7
GM
4391 Display an hourglass pointer on all frames by mapping the frames'
4392 hourglass_window. Set the hourglass_p flag in the frames'
4393 output_data.x structure to indicate that an hourglass cursor is
4394 shown on the frames. */
4ae9a85e 4395
1885ab29 4396void
971de7fb 4397show_hourglass (struct atimer *timer)
4ae9a85e
GM
4398{
4399 /* The timer implementation will cancel this timer automatically
0af913d7 4400 after this function has run. Set hourglass_atimer to null
4ae9a85e 4401 so that we know the timer doesn't have to be canceled. */
0af913d7 4402 hourglass_atimer = NULL;
4ae9a85e 4403
0af913d7 4404 if (!hourglass_shown_p)
333b20bb
GM
4405 {
4406 Lisp_Object rest, frame;
177c0ea7 4407
4ae9a85e 4408 BLOCK_INPUT;
177c0ea7 4409
333b20bb 4410 FOR_EACH_FRAME (rest, frame)
5f7a1890
GM
4411 {
4412 struct frame *f = XFRAME (frame);
177c0ea7 4413
5f7a1890
GM
4414 if (FRAME_LIVE_P (f) && FRAME_X_P (f) && FRAME_X_DISPLAY (f))
4415 {
4416 Display *dpy = FRAME_X_DISPLAY (f);
177c0ea7 4417
5f7a1890
GM
4418#ifdef USE_X_TOOLKIT
4419 if (f->output_data.x->widget)
4420#else
4421 if (FRAME_OUTER_WINDOW (f))
4422#endif
4423 {
0af913d7 4424 f->output_data.x->hourglass_p = 1;
177c0ea7 4425
0af913d7 4426 if (!f->output_data.x->hourglass_window)
5f7a1890
GM
4427 {
4428 unsigned long mask = CWCursor;
4429 XSetWindowAttributes attrs;
49b8b5dc
JD
4430#ifdef USE_GTK
4431 Window parent = FRAME_X_WINDOW (f);
4432#else
4433 Window parent = FRAME_OUTER_WINDOW (f);
4434#endif
0af913d7 4435 attrs.cursor = f->output_data.x->hourglass_cursor;
177c0ea7 4436
0af913d7 4437 f->output_data.x->hourglass_window
49b8b5dc 4438 = XCreateWindow (dpy, parent,
5f7a1890
GM
4439 0, 0, 32000, 32000, 0, 0,
4440 InputOnly,
4441 CopyFromParent,
4442 mask, &attrs);
4443 }
177c0ea7 4444
0af913d7 4445 XMapRaised (dpy, f->output_data.x->hourglass_window);
5f7a1890
GM
4446 XFlush (dpy);
4447 }
4448 }
4449 }
333b20bb 4450
0af913d7 4451 hourglass_shown_p = 1;
4ae9a85e
GM
4452 UNBLOCK_INPUT;
4453 }
333b20bb
GM
4454}
4455
4456
0af913d7
GM
4457/* Hide the hourglass pointer on all frames, if it is currently
4458 shown. */
333b20bb 4459
1885ab29 4460void
971de7fb 4461hide_hourglass (void)
4ae9a85e 4462{
0af913d7 4463 if (hourglass_shown_p)
333b20bb 4464 {
4ae9a85e
GM
4465 Lisp_Object rest, frame;
4466
4467 BLOCK_INPUT;
4468 FOR_EACH_FRAME (rest, frame)
333b20bb 4469 {
4ae9a85e 4470 struct frame *f = XFRAME (frame);
177c0ea7 4471
4ae9a85e
GM
4472 if (FRAME_X_P (f)
4473 /* Watch out for newly created frames. */
0af913d7 4474 && f->output_data.x->hourglass_window)
4ae9a85e 4475 {
0af913d7
GM
4476 XUnmapWindow (FRAME_X_DISPLAY (f),
4477 f->output_data.x->hourglass_window);
4478 /* Sync here because XTread_socket looks at the
4479 hourglass_p flag that is reset to zero below. */
4ae9a85e 4480 XSync (FRAME_X_DISPLAY (f), False);
0af913d7 4481 f->output_data.x->hourglass_p = 0;
4ae9a85e 4482 }
333b20bb 4483 }
333b20bb 4484
0af913d7 4485 hourglass_shown_p = 0;
4ae9a85e
GM
4486 UNBLOCK_INPUT;
4487 }
333b20bb
GM
4488}
4489
4490
4491\f
4492/***********************************************************************
4493 Tool tips
4494 ***********************************************************************/
4495
f57e2426
J
4496static Lisp_Object x_create_tip_frame (struct x_display_info *,
4497 Lisp_Object, Lisp_Object);
4498static void compute_tip_xy (struct frame *, Lisp_Object, Lisp_Object,
4499 Lisp_Object, int, int, int *, int *);
177c0ea7 4500
44b5a125 4501/* The frame of a currently visible tooltip. */
333b20bb 4502
44b5a125 4503Lisp_Object tip_frame;
333b20bb
GM
4504
4505/* If non-nil, a timer started that hides the last tooltip when it
4506 fires. */
4507
e4cebfca 4508static Lisp_Object tip_timer;
333b20bb
GM
4509Window tip_window;
4510
06d62053
GM
4511/* If non-nil, a vector of 3 elements containing the last args
4512 with which x-show-tip was called. See there. */
4513
e4cebfca 4514static Lisp_Object last_show_tip_args;
06d62053 4515
eaf1eea9
GM
4516
4517static Lisp_Object
971de7fb 4518unwind_create_tip_frame (Lisp_Object frame)
eaf1eea9 4519{
c844a81a
GM
4520 Lisp_Object deleted;
4521
4522 deleted = unwind_create_frame (frame);
4523 if (EQ (deleted, Qt))
4524 {
4525 tip_window = None;
4526 tip_frame = Qnil;
4527 }
177c0ea7 4528
c844a81a 4529 return deleted;
eaf1eea9
GM
4530}
4531
4532
333b20bb 4533/* Create a frame for a tooltip on the display described by DPYINFO.
275841bf
GM
4534 PARMS is a list of frame parameters. TEXT is the string to
4535 display in the tip frame. Value is the frame.
eaf1eea9
GM
4536
4537 Note that functions called here, esp. x_default_parameter can
4538 signal errors, for instance when a specified color name is
4539 undefined. We have to make sure that we're in a consistent state
4540 when this happens. */
333b20bb
GM
4541
4542static Lisp_Object
aa1859f5
J
4543x_create_tip_frame (struct x_display_info *dpyinfo,
4544 Lisp_Object parms,
4545 Lisp_Object text)
333b20bb
GM
4546{
4547 struct frame *f;
06b0c8a0 4548 Lisp_Object frame;
333b20bb 4549 Lisp_Object name;
333b20bb 4550 int width, height;
331379bf 4551 int count = SPECPDL_INDEX ();
b6d7acec 4552 struct gcpro gcpro1, gcpro2, gcpro3;
06d62053 4553 int face_change_count_before = face_change_count;
275841bf
GM
4554 Lisp_Object buffer;
4555 struct buffer *old_buffer;
333b20bb
GM
4556
4557 check_x ();
4558
89acb56d
SM
4559 if (!dpyinfo->terminal->name)
4560 error ("Terminal is not live, can't create new frames on it");
333b20bb 4561
47f3c6b4 4562 parms = Fcopy_alist (parms);
333b20bb
GM
4563
4564 /* Get the name of the frame to use for resource lookup. */
4565 name = x_get_arg (dpyinfo, parms, Qname, "name", "Name", RES_TYPE_STRING);
4566 if (!STRINGP (name)
4567 && !EQ (name, Qunbound)
4568 && !NILP (name))
4569 error ("Invalid frame name--not a string or nil");
333b20bb
GM
4570
4571 frame = Qnil;
4572 GCPRO3 (parms, name, frame);
44b5a125 4573 f = make_frame (1);
333b20bb 4574 XSETFRAME (frame, f);
275841bf
GM
4575
4576 buffer = Fget_buffer_create (build_string (" *tip*"));
be786000 4577 Fset_window_buffer (FRAME_ROOT_WINDOW (f), buffer, Qnil);
275841bf
GM
4578 old_buffer = current_buffer;
4579 set_buffer_internal_1 (XBUFFER (buffer));
4b4deea2 4580 BVAR (current_buffer, truncate_lines) = Qnil;
5c2a995d
KH
4581 specbind (Qinhibit_read_only, Qt);
4582 specbind (Qinhibit_modification_hooks, Qt);
275841bf
GM
4583 Ferase_buffer ();
4584 Finsert (1, &text);
4585 set_buffer_internal_1 (old_buffer);
177c0ea7 4586
333b20bb 4587 FRAME_CAN_HAVE_SCROLL_BARS (f) = 0;
8a1a7743 4588 record_unwind_protect (unwind_create_tip_frame, frame);
333b20bb 4589
6ed8eeff
KL
4590 f->terminal = dpyinfo->terminal;
4591 f->terminal->reference_count++;
daf01701 4592
eaf1eea9
GM
4593 /* By setting the output method, we're essentially saying that
4594 the frame is live, as per FRAME_LIVE_P. If we get a signal
4595 from this point on, x_destroy_window might screw up reference
4596 counts etc. */
333b20bb
GM
4597 f->output_method = output_x_window;
4598 f->output_data.x = (struct x_output *) xmalloc (sizeof (struct x_output));
72af86bd 4599 memset (f->output_data.x, 0, sizeof (struct x_output));
333b20bb 4600 f->output_data.x->icon_bitmap = -1;
be786000 4601 FRAME_FONTSET (f) = -1;
61d461a8
GM
4602 f->output_data.x->scroll_bar_foreground_pixel = -1;
4603 f->output_data.x->scroll_bar_background_pixel = -1;
f15340b7
MB
4604#ifdef USE_TOOLKIT_SCROLL_BARS
4605 f->output_data.x->scroll_bar_top_shadow_pixel = -1;
4606 f->output_data.x->scroll_bar_bottom_shadow_pixel = -1;
4607#endif /* USE_TOOLKIT_SCROLL_BARS */
333b20bb
GM
4608 f->icon_name = Qnil;
4609 FRAME_X_DISPLAY_INFO (f) = dpyinfo;
333b20bb
GM
4610 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
4611 f->output_data.x->explicit_parent = 0;
4612
61d461a8
GM
4613 /* These colors will be set anyway later, but it's important
4614 to get the color reference counts right, so initialize them! */
4615 {
4616 Lisp_Object black;
58d2d479 4617 struct gcpro inner_gcpro1;
177c0ea7 4618
9d3d44ba
KL
4619 /* Function x_decode_color can signal an error. Make
4620 sure to initialize color slots so that we won't try
4621 to free colors we haven't allocated. */
ce593f6e
KL
4622 FRAME_FOREGROUND_PIXEL (f) = -1;
4623 FRAME_BACKGROUND_PIXEL (f) = -1;
9d3d44ba
KL
4624 f->output_data.x->cursor_pixel = -1;
4625 f->output_data.x->cursor_foreground_pixel = -1;
4626 f->output_data.x->border_pixel = -1;
4627 f->output_data.x->mouse_pixel = -1;
4628
61d461a8 4629 black = build_string ("black");
7082eac6 4630 GCPRO1_VAR (black, inner_gcpro);
ce593f6e 4631 FRAME_FOREGROUND_PIXEL (f)
61d461a8 4632 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
ce593f6e 4633 FRAME_BACKGROUND_PIXEL (f)
61d461a8
GM
4634 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4635 f->output_data.x->cursor_pixel
4636 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4637 f->output_data.x->cursor_foreground_pixel
4638 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4639 f->output_data.x->border_pixel
4640 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
4641 f->output_data.x->mouse_pixel
4642 = x_decode_color (f, black, BLACK_PIX_DEFAULT (f));
7082eac6 4643 UNGCPRO_VAR (inner_gcpro);
61d461a8
GM
4644 }
4645
333b20bb
GM
4646 /* Set the name; the functions to which we pass f expect the name to
4647 be set. */
4648 if (EQ (name, Qunbound) || NILP (name))
4649 {
4650 f->name = build_string (dpyinfo->x_id_name);
4651 f->explicit_name = 0;
4652 }
4653 else
4654 {
4655 f->name = name;
4656 f->explicit_name = 1;
4657 /* use the frame's title when getting resources for this frame. */
4658 specbind (Qx_resource_name, name);
4659 }
4660
02ed2ea8
KH
4661 f->resx = dpyinfo->resx;
4662 f->resy = dpyinfo->resy;
4663
bf970f2b 4664 register_font_driver (&xfont_driver, f);
02ed2ea8
KH
4665#ifdef HAVE_FREETYPE
4666#ifdef HAVE_XFT
b51238f5 4667 register_font_driver (&xftfont_driver, f);
02ed2ea8 4668#else /* not HAVE_XFT */
b51238f5 4669 register_font_driver (&ftxfont_driver, f);
02ed2ea8
KH
4670#endif /* not HAVE_XFT */
4671#endif /* HAVE_FREETYPE */
d43f6b74 4672
b51238f5
KH
4673 x_default_parameter (f, parms, Qfont_backend, Qnil,
4674 "fontBackend", "FontBackend", RES_TYPE_STRING);
02ed2ea8 4675
eaf1eea9
GM
4676 /* Extract the window parameters from the supplied values that are
4677 needed to determine window geometry. */
b51238f5 4678 x_default_font_parameter (f, parms);
333b20bb 4679
4bef8d26 4680 x_default_parameter (f, parms, Qborder_width, make_number (0),
333b20bb 4681 "borderWidth", "BorderWidth", RES_TYPE_NUMBER);
177c0ea7 4682
333b20bb
GM
4683 /* This defaults to 2 in order to match xterm. We recognize either
4684 internalBorderWidth or internalBorder (which is what xterm calls
4685 it). */
4686 if (NILP (Fassq (Qinternal_border_width, parms)))
4687 {
4688 Lisp_Object value;
4689
4690 value = x_get_arg (dpyinfo, parms, Qinternal_border_width,
4691 "internalBorder", "internalBorder", RES_TYPE_NUMBER);
4692 if (! EQ (value, Qunbound))
4693 parms = Fcons (Fcons (Qinternal_border_width, value),
4694 parms);
4695 }
4696
4697 x_default_parameter (f, parms, Qinternal_border_width, make_number (1),
4698 "internalBorderWidth", "internalBorderWidth",
4699 RES_TYPE_NUMBER);
4700
4701 /* Also do the stuff which must be set before the window exists. */
4702 x_default_parameter (f, parms, Qforeground_color, build_string ("black"),
4703 "foreground", "Foreground", RES_TYPE_STRING);
4704 x_default_parameter (f, parms, Qbackground_color, build_string ("white"),
4705 "background", "Background", RES_TYPE_STRING);
4706 x_default_parameter (f, parms, Qmouse_color, build_string ("black"),
4707 "pointerColor", "Foreground", RES_TYPE_STRING);
4708 x_default_parameter (f, parms, Qcursor_color, build_string ("black"),
4709 "cursorColor", "Foreground", RES_TYPE_STRING);
4710 x_default_parameter (f, parms, Qborder_color, build_string ("black"),
4711 "borderColor", "BorderColor", RES_TYPE_STRING);
4712
4713 /* Init faces before x_default_parameter is called for scroll-bar
4714 parameters because that function calls x_set_scroll_bar_width,
4715 which calls change_frame_size, which calls Fset_window_buffer,
4716 which runs hooks, which call Fvertical_motion. At the end, we
4717 end up in init_iterator with a null face cache, which should not
4718 happen. */
4719 init_frame_faces (f);
177c0ea7 4720
7d7d0045
CY
4721#if GLYPH_DEBUG
4722 image_cache_refcount = FRAME_IMAGE_CACHE (f)->refcount;
4723 dpyinfo_refcount = dpyinfo->reference_count;
4724#endif /* GLYPH_DEBUG */
4725
333b20bb 4726 f->output_data.x->parent_desc = FRAME_X_DISPLAY_INFO (f)->root_window;
333b20bb 4727
0ce7538d 4728 x_figure_window_size (f, parms, 0);
333b20bb 4729
333b20bb
GM
4730 {
4731 XSetWindowAttributes attrs;
4732 unsigned long mask;
36acb2a7 4733 Atom type = FRAME_X_DISPLAY_INFO (f)->Xatom_net_window_type_tooltip;
177c0ea7 4734
333b20bb 4735 BLOCK_INPUT;
c51d2b5e
GM
4736 mask = CWBackPixel | CWOverrideRedirect | CWEventMask;
4737 if (DoesSaveUnders (dpyinfo->screen))
4738 mask |= CWSaveUnder;
177c0ea7 4739
9b2956e2
GM
4740 /* Window managers look at the override-redirect flag to determine
4741 whether or net to give windows a decoration (Xlib spec, chapter
333b20bb
GM
4742 3.2.8). */
4743 attrs.override_redirect = True;
4744 attrs.save_under = True;
4745 attrs.background_pixel = FRAME_BACKGROUND_PIXEL (f);
4746 /* Arrange for getting MapNotify and UnmapNotify events. */
4747 attrs.event_mask = StructureNotifyMask;
4748 tip_window
4749 = FRAME_X_WINDOW (f)
4750 = XCreateWindow (FRAME_X_DISPLAY (f),
4751 FRAME_X_DISPLAY_INFO (f)->root_window,
4752 /* x, y, width, height */
4753 0, 0, 1, 1,
4754 /* Border. */
a979dde1 4755 f->border_width,
333b20bb
GM
4756 CopyFromParent, InputOutput, CopyFromParent,
4757 mask, &attrs);
36acb2a7
JD
4758 XChangeProperty (FRAME_X_DISPLAY (f), tip_window,
4759 FRAME_X_DISPLAY_INFO (f)->Xatom_net_window_type,
4760 XA_ATOM, 32, PropModeReplace,
4761 (unsigned char *)&type, 1);
333b20bb
GM
4762 UNBLOCK_INPUT;
4763 }
4764
4765 x_make_gc (f);
4766
333b20bb
GM
4767 x_default_parameter (f, parms, Qauto_raise, Qnil,
4768 "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
4769 x_default_parameter (f, parms, Qauto_lower, Qnil,
4770 "autoLower", "AutoRaiseLower", RES_TYPE_BOOLEAN);
4771 x_default_parameter (f, parms, Qcursor_type, Qbox,
4772 "cursorType", "CursorType", RES_TYPE_SYMBOL);
4773
be786000 4774 /* Dimensions, especially FRAME_LINES (f), must be done via change_frame_size.
333b20bb 4775 Change will not be effected unless different from the current
be786000
KS
4776 FRAME_LINES (f). */
4777 width = FRAME_COLS (f);
4778 height = FRAME_LINES (f);
4779 SET_FRAME_COLS (f, 0);
4780 FRAME_LINES (f) = 0;
8938a4fb 4781 change_frame_size (f, height, width, 1, 0, 0);
177c0ea7 4782
cd1d850f 4783 /* Add `tooltip' frame parameter's default value. */
54ee7410
CY
4784 if (NILP (Fframe_parameter (frame, Qtooltip)))
4785 Fmodify_frame_parameters (frame, Fcons (Fcons (Qtooltip, Qt), Qnil));
177c0ea7 4786
cedb4d8b
GM
4787 /* FIXME - can this be done in a similar way to normal frames?
4788 http://lists.gnu.org/archive/html/emacs-devel/2007-10/msg00641.html */
4789
35fdaa62
GM
4790 /* Set the `display-type' frame parameter before setting up faces. */
4791 {
4792 Lisp_Object disptype;
4793
4794 if (FRAME_X_DISPLAY_INFO (f)->n_planes == 1)
4795 disptype = intern ("mono");
219ccf1b
RS
4796 else if (FRAME_X_DISPLAY_INFO (f)->visual->class == GrayScale
4797 || FRAME_X_DISPLAY_INFO (f)->visual->class == StaticGray)
35fdaa62
GM
4798 disptype = intern ("grayscale");
4799 else
4800 disptype = intern ("color");
4801
4802 if (NILP (Fframe_parameter (frame, Qdisplay_type)))
4803 Fmodify_frame_parameters (frame, Fcons (Fcons (Qdisplay_type, disptype),
4804 Qnil));
4805 }
4806
035d5114 4807 /* Set up faces after all frame parameters are known. This call
6801a572
GM
4808 also merges in face attributes specified for new frames.
4809
4810 Frame parameters may be changed if .Xdefaults contains
4811 specifications for the default font. For example, if there is an
4812 `Emacs.default.attributeBackground: pink', the `background-color'
4813 attribute of the frame get's set, which let's the internal border
4814 of the tooltip frame appear in pink. Prevent this. */
4815 {
4816 Lisp_Object bg = Fframe_parameter (frame, Qbackground_color);
4817
4818 /* Set tip_frame here, so that */
4819 tip_frame = frame;
45cebfd9 4820 call2 (Qface_set_after_frame_default, frame, Qnil);
177c0ea7 4821
6801a572
GM
4822 if (!EQ (bg, Fframe_parameter (frame, Qbackground_color)))
4823 Fmodify_frame_parameters (frame, Fcons (Fcons (Qbackground_color, bg),
4824 Qnil));
4825 }
177c0ea7 4826
333b20bb
GM
4827 f->no_split = 1;
4828
4829 UNGCPRO;
4830
4831 /* It is now ok to make the frame official even if we get an error
4832 below. And the frame needs to be on Vframe_list or making it
4833 visible won't work. */
4834 Vframe_list = Fcons (frame, Vframe_list);
4835
4836 /* Now that the frame is official, it counts as a reference to
4837 its display. */
4838 FRAME_X_DISPLAY_INFO (f)->reference_count++;
4839
06d62053
GM
4840 /* Setting attributes of faces of the tooltip frame from resources
4841 and similar will increment face_change_count, which leads to the
4842 clearing of all current matrices. Since this isn't necessary
4843 here, avoid it by resetting face_change_count to the value it
4844 had before we created the tip frame. */
4845 face_change_count = face_change_count_before;
4846
eaf1eea9 4847 /* Discard the unwind_protect. */
333b20bb
GM
4848 return unbind_to (count, frame);
4849}
4850
4851
06d62053
GM
4852/* Compute where to display tip frame F. PARMS is the list of frame
4853 parameters for F. DX and DY are specified offsets from the current
ab452f99
GM
4854 location of the mouse. WIDTH and HEIGHT are the width and height
4855 of the tooltip. Return coordinates relative to the root window of
4856 the display in *ROOT_X, and *ROOT_Y. */
06d62053
GM
4857
4858static void
971de7fb 4859compute_tip_xy (struct frame *f, Lisp_Object parms, Lisp_Object dx, Lisp_Object dy, int width, int height, int *root_x, int *root_y)
06d62053
GM
4860{
4861 Lisp_Object left, top;
4862 int win_x, win_y;
4863 Window root, child;
4864 unsigned pmask;
177c0ea7 4865
06d62053
GM
4866 /* User-specified position? */
4867 left = Fcdr (Fassq (Qleft, parms));
4868 top = Fcdr (Fassq (Qtop, parms));
177c0ea7 4869
06d62053
GM
4870 /* Move the tooltip window where the mouse pointer is. Resize and
4871 show it. */
570d22b0 4872 if (!INTEGERP (left) || !INTEGERP (top))
ab452f99
GM
4873 {
4874 BLOCK_INPUT;
4875 XQueryPointer (FRAME_X_DISPLAY (f), FRAME_X_DISPLAY_INFO (f)->root_window,
4876 &root, &child, root_x, root_y, &win_x, &win_y, &pmask);
4877 UNBLOCK_INPUT;
4878 }
06d62053 4879
06d62053
GM
4880 if (INTEGERP (top))
4881 *root_y = XINT (top);
bf63eb69
JD
4882 else if (*root_y + XINT (dy) <= 0)
4883 *root_y = 0; /* Can happen for negative dy */
abe9d29c
CY
4884 else if (*root_y + XINT (dy) + height
4885 <= x_display_pixel_height (FRAME_X_DISPLAY_INFO (f)))
7e8410d1 4886 /* It fits below the pointer */
abe9d29c 4887 *root_y += XINT (dy);
7e8410d1
JD
4888 else if (height + XINT (dy) <= *root_y)
4889 /* It fits above the pointer. */
4890 *root_y -= height + XINT (dy);
4891 else
4892 /* Put it on the top. */
4893 *root_y = 0;
ab452f99
GM
4894
4895 if (INTEGERP (left))
4896 *root_x = XINT (left);
bf63eb69
JD
4897 else if (*root_x + XINT (dx) <= 0)
4898 *root_x = 0; /* Can happen for negative dx */
abe9d29c
CY
4899 else if (*root_x + XINT (dx) + width
4900 <= x_display_pixel_width (FRAME_X_DISPLAY_INFO (f)))
d682d3df
RS
4901 /* It fits to the right of the pointer. */
4902 *root_x += XINT (dx);
4903 else if (width + XINT (dx) <= *root_x)
4904 /* It fits to the left of the pointer. */
ab452f99
GM
4905 *root_x -= width + XINT (dx);
4906 else
d682d3df
RS
4907 /* Put it left-justified on the screen--it ought to fit that way. */
4908 *root_x = 0;
06d62053
GM
4909}
4910
4911
0634ce98 4912DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
7ee72033 4913 doc: /* Show STRING in a "tooltip" window on frame FRAME.
c061c855
GM
4914A tooltip window is a small X window displaying a string.
4915
87c891c7
EZ
4916This is an internal function; Lisp code should call `tooltip-show'.
4917
c061c855
GM
4918FRAME nil or omitted means use the selected frame.
4919
4920PARMS is an optional list of frame parameters which can be used to
4921change the tooltip's appearance.
4922
4923Automatically hide the tooltip after TIMEOUT seconds. TIMEOUT nil
4924means use the default timeout of 5 seconds.
4925
c869cc37 4926If the list of frame parameters PARMS contains a `left' parameters,
c061c855
GM
4927the tooltip is displayed at that x-position. Otherwise it is
4928displayed at the mouse position, with offset DX added (default is 5 if
4929DX isn't specified). Likewise for the y-position; if a `top' frame
4930parameter is specified, it determines the y-position of the tooltip
4931window, otherwise it is displayed at the mouse position, with offset
4932DY added (default is -10).
4933
4934A tooltip's maximum size is specified by `x-max-tooltip-size'.
7ee72033 4935Text larger than the specified size is clipped. */)
5842a27b 4936 (Lisp_Object string, Lisp_Object frame, Lisp_Object parms, Lisp_Object timeout, Lisp_Object dx, Lisp_Object dy)
333b20bb
GM
4937{
4938 struct frame *f;
4939 struct window *w;
06d62053 4940 int root_x, root_y;
333b20bb
GM
4941 struct buffer *old_buffer;
4942 struct text_pos pos;
a971c0a7 4943 int i, width, height, seen_reversed_p;
393f2d14 4944 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
333b20bb 4945 int old_windows_or_buffers_changed = windows_or_buffers_changed;
331379bf 4946 int count = SPECPDL_INDEX ();
177c0ea7 4947
333b20bb
GM
4948 specbind (Qinhibit_redisplay, Qt);
4949
393f2d14 4950 GCPRO4 (string, parms, frame, timeout);
333b20bb 4951
b7826503 4952 CHECK_STRING (string);
2d7117fe
JD
4953 if (SCHARS (string) == 0)
4954 string = make_unibyte_string (" ", 1);
4955
333b20bb
GM
4956 f = check_x_frame (frame);
4957 if (NILP (timeout))
4958 timeout = make_number (5);
4959 else
b7826503 4960 CHECK_NATNUM (timeout);
177c0ea7 4961
0634ce98
GM
4962 if (NILP (dx))
4963 dx = make_number (5);
4964 else
b7826503 4965 CHECK_NUMBER (dx);
177c0ea7 4966
0634ce98 4967 if (NILP (dy))
12c67a7f 4968 dy = make_number (-10);
0634ce98 4969 else
b7826503 4970 CHECK_NUMBER (dy);
333b20bb 4971
aa1859f5
J
4972#ifdef USE_GTK
4973 if (x_gtk_use_system_tooltips)
4974 {
717c30e0 4975 int ok;
aa1859f5
J
4976
4977 /* Hide a previous tip, if any. */
4978 Fx_hide_tip ();
4979
4980 BLOCK_INPUT;
4981 if ((ok = xg_prepare_tooltip (f, string, &width, &height)) != 0)
4982 {
4983 compute_tip_xy (f, parms, dx, dy, width, height, &root_x, &root_y);
4984 xg_show_tooltip (f, root_x, root_y);
4985 /* This is used in Fx_hide_tip. */
4986 XSETFRAME (tip_frame, f);
4987 }
4988 UNBLOCK_INPUT;
4989 if (ok) goto start_timer;
4990 }
4991#endif /* USE_GTK */
4992
06d62053
GM
4993 if (NILP (last_show_tip_args))
4994 last_show_tip_args = Fmake_vector (make_number (3), Qnil);
4995
4996 if (!NILP (tip_frame))
4997 {
4998 Lisp_Object last_string = AREF (last_show_tip_args, 0);
4999 Lisp_Object last_frame = AREF (last_show_tip_args, 1);
5000 Lisp_Object last_parms = AREF (last_show_tip_args, 2);
5001
5002 if (EQ (frame, last_frame)
5003 && !NILP (Fequal (last_string, string))
5004 && !NILP (Fequal (last_parms, parms)))
5005 {
58d2d479 5006 struct frame *tip_f = XFRAME (tip_frame);
177c0ea7 5007
06d62053
GM
5008 /* Only DX and DY have changed. */
5009 if (!NILP (tip_timer))
ae782866
GM
5010 {
5011 Lisp_Object timer = tip_timer;
5012 tip_timer = Qnil;
5013 call1 (Qcancel_timer, timer);
5014 }
06d62053
GM
5015
5016 BLOCK_INPUT;
58d2d479
PE
5017 compute_tip_xy (tip_f, parms, dx, dy, FRAME_PIXEL_WIDTH (tip_f),
5018 FRAME_PIXEL_HEIGHT (tip_f), &root_x, &root_y);
5019 XMoveWindow (FRAME_X_DISPLAY (tip_f), FRAME_X_WINDOW (tip_f),
ab452f99 5020 root_x, root_y);
06d62053
GM
5021 UNBLOCK_INPUT;
5022 goto start_timer;
5023 }
5024 }
5025
333b20bb
GM
5026 /* Hide a previous tip, if any. */
5027 Fx_hide_tip ();
5028
06d62053
GM
5029 ASET (last_show_tip_args, 0, string);
5030 ASET (last_show_tip_args, 1, frame);
5031 ASET (last_show_tip_args, 2, parms);
5032
333b20bb
GM
5033 /* Add default values to frame parameters. */
5034 if (NILP (Fassq (Qname, parms)))
5035 parms = Fcons (Fcons (Qname, build_string ("tooltip")), parms);
5036 if (NILP (Fassq (Qinternal_border_width, parms)))
5037 parms = Fcons (Fcons (Qinternal_border_width, make_number (3)), parms);
5038 if (NILP (Fassq (Qborder_width, parms)))
5039 parms = Fcons (Fcons (Qborder_width, make_number (1)), parms);
5040 if (NILP (Fassq (Qborder_color, parms)))
5041 parms = Fcons (Fcons (Qborder_color, build_string ("lightyellow")), parms);
5042 if (NILP (Fassq (Qbackground_color, parms)))
5043 parms = Fcons (Fcons (Qbackground_color, build_string ("lightyellow")),
5044 parms);
5045
5046 /* Create a frame for the tooltip, and record it in the global
5047 variable tip_frame. */
275841bf 5048 frame = x_create_tip_frame (FRAME_X_DISPLAY_INFO (f), parms, string);
44b5a125 5049 f = XFRAME (frame);
333b20bb 5050
d63931a2 5051 /* Set up the frame's root window. */
333b20bb 5052 w = XWINDOW (FRAME_ROOT_WINDOW (f));
be786000 5053 w->left_col = w->top_line = make_number (0);
177c0ea7 5054
d63931a2
GM
5055 if (CONSP (Vx_max_tooltip_size)
5056 && INTEGERP (XCAR (Vx_max_tooltip_size))
5057 && XINT (XCAR (Vx_max_tooltip_size)) > 0
5058 && INTEGERP (XCDR (Vx_max_tooltip_size))
5059 && XINT (XCDR (Vx_max_tooltip_size)) > 0)
5060 {
be786000
KS
5061 w->total_cols = XCAR (Vx_max_tooltip_size);
5062 w->total_lines = XCDR (Vx_max_tooltip_size);
d63931a2
GM
5063 }
5064 else
5065 {
be786000
KS
5066 w->total_cols = make_number (80);
5067 w->total_lines = make_number (40);
d63931a2 5068 }
177c0ea7 5069
be786000 5070 FRAME_TOTAL_COLS (f) = XINT (w->total_cols);
333b20bb
GM
5071 adjust_glyphs (f);
5072 w->pseudo_window_p = 1;
5073
5074 /* Display the tooltip text in a temporary buffer. */
333b20bb 5075 old_buffer = current_buffer;
275841bf 5076 set_buffer_internal_1 (XBUFFER (XWINDOW (FRAME_ROOT_WINDOW (f))->buffer));
4b4deea2 5077 BVAR (current_buffer, truncate_lines) = Qnil;
5634ff85
YM
5078 clear_glyph_matrix (w->desired_matrix);
5079 clear_glyph_matrix (w->current_matrix);
5080 SET_TEXT_POS (pos, BEGV, BEGV_BYTE);
6eff5c3d 5081 try_window (FRAME_ROOT_WINDOW (f), pos, TRY_WINDOW_IGNORE_FONTS_CHANGE);
333b20bb
GM
5082
5083 /* Compute width and height of the tooltip. */
a971c0a7 5084 width = height = seen_reversed_p = 0;
333b20bb
GM
5085 for (i = 0; i < w->desired_matrix->nrows; ++i)
5086 {
5087 struct glyph_row *row = &w->desired_matrix->rows[i];
5088 struct glyph *last;
5089 int row_width;
5090
5091 /* Stop at the first empty row at the end. */
5092 if (!row->enabled_p || !row->displays_text_p)
5093 break;
5094
d7bf0342
GM
5095 /* Let the row go over the full width of the frame. */
5096 row->full_width_p = 1;
333b20bb 5097
5b253e9c 5098 row_width = row->pixel_width;
333b20bb
GM
5099 if (row->used[TEXT_AREA])
5100 {
a971c0a7
EZ
5101 /* There's a glyph at the end of rows that is used to place
5102 the cursor there. Don't include the width of this glyph. */
5103 if (!row->reversed_p)
5104 {
5105 last = &row->glyphs[TEXT_AREA][row->used[TEXT_AREA] - 1];
5106 if (INTEGERP (last->object))
5107 row_width -= last->pixel_width;
5108 }
5109 else
5110 {
5111 /* There could be a stretch glyph at the beginning of R2L
5112 rows that is produced by extend_face_to_end_of_line.
5113 Don't count that glyph. */
5114 struct glyph *g = row->glyphs[TEXT_AREA];
5115
5116 if (g->type == STRETCH_GLYPH && INTEGERP (g->object))
5117 {
5118 row_width -= g->pixel_width;
5119 seen_reversed_p = 1;
5120 }
5121 }
333b20bb 5122 }
177c0ea7 5123
333b20bb
GM
5124 height += row->height;
5125 width = max (width, row_width);
5126 }
5127
a971c0a7
EZ
5128 /* If we've seen partial-length R2L rows, we need to re-adjust the
5129 tool-tip frame width and redisplay it again, to avoid over-wide
5130 tips due to the stretch glyph that extends R2L lines to full
5131 width of the frame. */
5132 if (seen_reversed_p)
5133 {
5134 /* w->total_cols and FRAME_TOTAL_COLS want the width in columns,
5135 not in pixels. */
5136 width /= WINDOW_FRAME_COLUMN_WIDTH (w);
5137 w->total_cols = make_number (width);
5138 FRAME_TOTAL_COLS (f) = width;
5139 adjust_glyphs (f);
5140 clear_glyph_matrix (w->desired_matrix);
5141 clear_glyph_matrix (w->current_matrix);
5142 try_window (FRAME_ROOT_WINDOW (f), pos, 0);
5143 width = height = 0;
5144 /* Recompute width and height of the tooltip. */
5145 for (i = 0; i < w->desired_matrix->nrows; ++i)
5146 {
5147 struct glyph_row *row = &w->desired_matrix->rows[i];
5148 struct glyph *last;
5149 int row_width;
5150
5151 if (!row->enabled_p || !row->displays_text_p)
5152 break;
5153 row->full_width_p = 1;
5154 row_width = row->pixel_width;
5155 if (row->used[TEXT_AREA] && !row->reversed_p)
5156 {
5157 last = &row->glyphs[TEXT_AREA][row->used[TEXT_AREA] - 1];
5158 if (INTEGERP (last->object))
5159 row_width -= last->pixel_width;
5160 }
5161
5162 height += row->height;
5163 width = max (width, row_width);
5164 }
5165 }
5166
333b20bb
GM
5167 /* Add the frame's internal border to the width and height the X
5168 window should have. */
5169 height += 2 * FRAME_INTERNAL_BORDER_WIDTH (f);
5170 width += 2 * FRAME_INTERNAL_BORDER_WIDTH (f);
5171
5172 /* Move the tooltip window where the mouse pointer is. Resize and
5173 show it. */
ab452f99 5174 compute_tip_xy (f, parms, dx, dy, width, height, &root_x, &root_y);
0634ce98 5175
0634ce98 5176 BLOCK_INPUT;
333b20bb 5177 XMoveResizeWindow (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f),
ab452f99 5178 root_x, root_y, width, height);
333b20bb
GM
5179 XMapRaised (FRAME_X_DISPLAY (f), FRAME_X_WINDOW (f));
5180 UNBLOCK_INPUT;
177c0ea7 5181
333b20bb
GM
5182 /* Draw into the window. */
5183 w->must_be_updated_p = 1;
5184 update_single_window (w, 1);
5185
5186 /* Restore original current buffer. */
5187 set_buffer_internal_1 (old_buffer);
5188 windows_or_buffers_changed = old_windows_or_buffers_changed;
5189
06d62053 5190 start_timer:
333b20bb
GM
5191 /* Let the tip disappear after timeout seconds. */
5192 tip_timer = call3 (intern ("run-at-time"), timeout, Qnil,
5193 intern ("x-hide-tip"));
a744a2ec
DL
5194
5195 UNGCPRO;
333b20bb
GM
5196 return unbind_to (count, Qnil);
5197}
5198
5199
a7ca3326 5200DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
7ee72033
MB
5201 doc: /* Hide the current tooltip window, if there is any.
5202Value is t if tooltip was open, nil otherwise. */)
5842a27b 5203 (void)
333b20bb 5204{
44b5a125 5205 int count;
c0006262
GM
5206 Lisp_Object deleted, frame, timer;
5207 struct gcpro gcpro1, gcpro2;
44b5a125
GM
5208
5209 /* Return quickly if nothing to do. */
c0006262 5210 if (NILP (tip_timer) && NILP (tip_frame))
44b5a125 5211 return Qnil;
177c0ea7 5212
c0006262
GM
5213 frame = tip_frame;
5214 timer = tip_timer;
5215 GCPRO2 (frame, timer);
5216 tip_frame = tip_timer = deleted = Qnil;
177c0ea7 5217
331379bf 5218 count = SPECPDL_INDEX ();
333b20bb 5219 specbind (Qinhibit_redisplay, Qt);
44b5a125 5220 specbind (Qinhibit_quit, Qt);
177c0ea7 5221
c0006262 5222 if (!NILP (timer))
ae782866 5223 call1 (Qcancel_timer, timer);
333b20bb 5224
aa1859f5 5225#ifdef USE_GTK
1fe72bf8
PE
5226 {
5227 /* When using system tooltip, tip_frame is the Emacs frame on which
5228 the tip is shown. */
5229 struct frame *f = XFRAME (frame);
5230 if (FRAME_LIVE_P (f) && xg_hide_tooltip (f))
5231 frame = Qnil;
5232 }
aa1859f5
J
5233#endif
5234
c0006262 5235 if (FRAMEP (frame))
333b20bb 5236 {
56f2de10 5237 delete_frame (frame, Qnil);
44b5a125 5238 deleted = Qt;
f6c44811
GM
5239
5240#ifdef USE_LUCID
5241 /* Bloodcurdling hack alert: The Lucid menu bar widget's
5242 redisplay procedure is not called when a tip frame over menu
5243 items is unmapped. Redisplay the menu manually... */
5244 {
aa1859f5 5245 Widget w;
1fe72bf8 5246 struct frame *f = SELECTED_FRAME ();
aa1859f5 5247 w = f->output_data.x->menubar_widget;
9180dc8c 5248
f6c44811 5249 if (!DoesSaveUnders (FRAME_X_DISPLAY_INFO (f)->screen)
dbc64aa7 5250 && w != NULL)
f6c44811
GM
5251 {
5252 BLOCK_INPUT;
5253 xlwmenu_redisplay (w);
5254 UNBLOCK_INPUT;
5255 }
5256 }
5257#endif /* USE_LUCID */
333b20bb
GM
5258 }
5259
c0006262 5260 UNGCPRO;
44b5a125 5261 return unbind_to (count, deleted);
333b20bb
GM
5262}
5263
5264
5265\f
5266/***********************************************************************
5267 File selection dialog
5268 ***********************************************************************/
5269
90f2e16b
JD
5270DEFUN ("x-uses-old-gtk-dialog", Fx_uses_old_gtk_dialog,
5271 Sx_uses_old_gtk_dialog,
5272 0, 0, 0,
5273 doc: /* Return t if the old Gtk+ file selection dialog is used. */)
5842a27b 5274 (void)
90f2e16b
JD
5275{
5276#ifdef USE_GTK
90f2e16b
JD
5277 if (use_dialog_box
5278 && use_file_dialog
5279 && have_menus_p ()
5280 && xg_uses_old_file_dialog ())
5281 return Qt;
5282#endif
5283 return Qnil;
5284}
5285
333b20bb 5286
90f2e16b 5287#ifdef USE_MOTIF
333b20bb
GM
5288/* Callback for "OK" and "Cancel" on file selection dialog. */
5289
5290static void
dee186b6 5291file_dialog_cb (Widget widget, XtPointer client_data, XtPointer call_data)
333b20bb
GM
5292{
5293 int *result = (int *) client_data;
5294 XmAnyCallbackStruct *cb = (XmAnyCallbackStruct *) call_data;
5295 *result = cb->reason;
5296}
5297
5298
a779d213
GM
5299/* Callback for unmapping a file selection dialog. This is used to
5300 capture the case where a dialog is closed via a window manager's
5301 closer button, for example. Using a XmNdestroyCallback didn't work
5302 in this case. */
5303
5304static void
dee186b6 5305file_dialog_unmap_cb (Widget widget, XtPointer client_data, XtPointer call_data)
a779d213
GM
5306{
5307 int *result = (int *) client_data;
5308 *result = XmCR_CANCEL;
5309}
5310
24ca7c5a 5311static Lisp_Object
dee186b6 5312clean_up_file_dialog (Lisp_Object arg)
24ca7c5a
JD
5313{
5314 struct Lisp_Save_Value *p = XSAVE_VALUE (arg);
5315 Widget dialog = (Widget) p->pointer;
5316
5317 /* Clean up. */
5318 BLOCK_INPUT;
5319 XtUnmanageChild (dialog);
5320 XtDestroyWidget (dialog);
5321 x_menu_set_in_use (0);
5322 UNBLOCK_INPUT;
5323
5324 return Qnil;
5325}
5326
a779d213 5327
f9d64bb3 5328DEFUN ("x-file-dialog", Fx_file_dialog, Sx_file_dialog, 2, 5, 0,
7ee72033 5329 doc: /* Read file name, prompting with PROMPT in directory DIR.
f9d64bb3
JD
5330Use a file selection dialog. Select DEFAULT-FILENAME in the dialog's file
5331selection box, if specified. If MUSTMATCH is non-nil, the returned file
7c051dd8
GM
5332or directory must exist.
5333
5334This function is only defined on MS Windows, and X Windows with the
5335Motif or Gtk toolkits. With the Motif toolkit, ONLY-DIR-P is ignored.
5336Otherwise, if ONLY-DIR-P is non-nil, the user can only select directories. */)
5842a27b 5337 (Lisp_Object prompt, Lisp_Object dir, Lisp_Object default_filename, Lisp_Object mustmatch, Lisp_Object only_dir_p)
333b20bb
GM
5338{
5339 int result;
0fe92f72 5340 struct frame *f = SELECTED_FRAME ();
333b20bb 5341 Lisp_Object file = Qnil;
a8f4bdc6 5342 Lisp_Object decoded_file;
f9d64bb3 5343 Widget dialog, text, help;
333b20bb
GM
5344 Arg al[10];
5345 int ac = 0;
333b20bb 5346 XmString dir_xmstring, pattern_xmstring;
65b21658 5347 int count = SPECPDL_INDEX ();
f9d64bb3 5348 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
333b20bb 5349
6eeee4d6
YM
5350 check_x ();
5351
f9d64bb3 5352 GCPRO6 (prompt, dir, default_filename, mustmatch, only_dir_p, file);
24ca7c5a 5353
5ae53dcf 5354 if (popup_activated ())
24ca7c5a
JD
5355 error ("Trying to use a menu from within a menu-entry");
5356
b7826503
PJ
5357 CHECK_STRING (prompt);
5358 CHECK_STRING (dir);
333b20bb
GM
5359
5360 /* Prevent redisplay. */
5361 specbind (Qinhibit_redisplay, Qt);
5362
5363 BLOCK_INPUT;
5364
5365 /* Create the dialog with PROMPT as title, using DIR as initial
5366 directory and using "*" as pattern. */
5367 dir = Fexpand_file_name (dir, Qnil);
d5db4077 5368 dir_xmstring = XmStringCreateLocalized (SDATA (dir));
333b20bb 5369 pattern_xmstring = XmStringCreateLocalized ("*");
177c0ea7 5370
d5db4077 5371 XtSetArg (al[ac], XmNtitle, SDATA (prompt)); ++ac;
333b20bb
GM
5372 XtSetArg (al[ac], XmNdirectory, dir_xmstring); ++ac;
5373 XtSetArg (al[ac], XmNpattern, pattern_xmstring); ++ac;
5374 XtSetArg (al[ac], XmNresizePolicy, XmRESIZE_GROW); ++ac;
5375 XtSetArg (al[ac], XmNdialogStyle, XmDIALOG_APPLICATION_MODAL); ++ac;
5376 dialog = XmCreateFileSelectionDialog (f->output_data.x->widget,
5377 "fsb", al, ac);
5378 XmStringFree (dir_xmstring);
5379 XmStringFree (pattern_xmstring);
5380
5381 /* Add callbacks for OK and Cancel. */
5382 XtAddCallback (dialog, XmNokCallback, file_dialog_cb,
5383 (XtPointer) &result);
5384 XtAddCallback (dialog, XmNcancelCallback, file_dialog_cb,
5385 (XtPointer) &result);
a779d213
GM
5386 XtAddCallback (dialog, XmNunmapCallback, file_dialog_unmap_cb,
5387 (XtPointer) &result);
333b20bb 5388
f9d64bb3 5389 /* Remove the help button since we can't display help. */
333b20bb 5390 help = XmFileSelectionBoxGetChild (dialog, XmDIALOG_HELP_BUTTON);
f9d64bb3 5391 XtUnmanageChild (help);
333b20bb 5392
177c0ea7 5393 /* Mark OK button as default. */
333b20bb
GM
5394 XtVaSetValues (XmFileSelectionBoxGetChild (dialog, XmDIALOG_OK_BUTTON),
5395 XmNshowAsDefault, True, NULL);
5396
5397 /* If MUSTMATCH is non-nil, disable the file entry field of the
5398 dialog, so that the user must select a file from the files list
5399 box. We can't remove it because we wouldn't have a way to get at
5400 the result file name, then. */
5401 text = XmFileSelectionBoxGetChild (dialog, XmDIALOG_TEXT);
5402 if (!NILP (mustmatch))
5403 {
5404 Widget label;
5405 label = XmFileSelectionBoxGetChild (dialog, XmDIALOG_SELECTION_LABEL);
5406 XtSetSensitive (text, False);
5407 XtSetSensitive (label, False);
5408 }
5409
5410 /* Manage the dialog, so that list boxes get filled. */
5411 XtManageChild (dialog);
5412
333b20bb
GM
5413 if (STRINGP (default_filename))
5414 {
5415 XmString default_xmstring;
f9d64bb3
JD
5416 Widget wtext = XmFileSelectionBoxGetChild (dialog, XmDIALOG_TEXT);
5417 Widget list = XmFileSelectionBoxGetChild (dialog, XmDIALOG_LIST);
333b20bb 5418
f9d64bb3
JD
5419 XmTextPosition last_pos = XmTextFieldGetLastPosition (wtext);
5420 XmTextFieldReplace (wtext, 0, last_pos,
5421 (SDATA (Ffile_name_nondirectory (default_filename))));
333b20bb 5422
f9d64bb3
JD
5423 /* Select DEFAULT_FILENAME in the files list box. DEFAULT_FILENAME
5424 must include the path for this to work. */
5425
5426 default_xmstring = XmStringCreateLocalized (SDATA (default_filename));
333b20bb 5427
f9d64bb3
JD
5428 if (XmListItemExists (list, default_xmstring))
5429 {
5430 int item_pos = XmListItemPos (list, default_xmstring);
5431 /* Select the item and scroll it into view. */
5432 XmListSelectPos (list, item_pos, True);
5433 XmListSetPos (list, item_pos);
5434 }
5435
5436 XmStringFree (default_xmstring);
333b20bb
GM
5437 }
5438
24ca7c5a
JD
5439 record_unwind_protect (clean_up_file_dialog, make_save_value (dialog, 0));
5440
bf338245 5441 /* Process events until the user presses Cancel or OK. */
5ae53dcf 5442 x_menu_set_in_use (1);
03100098 5443 result = 0;
a779d213 5444 while (result == 0)
563b384d 5445 {
bf338245 5446 XEvent event;
24ca7c5a 5447 x_menu_wait_for_event (0);
bf338245 5448 XtAppNextEvent (Xt_app_con, &event);
9f6fcdc5
JD
5449 if (event.type == KeyPress
5450 && FRAME_X_DISPLAY (f) == event.xkey.display)
5451 {
5452 KeySym keysym = XLookupKeysym (&event.xkey, 0);
5453
5454 /* Pop down on C-g. */
5455 if (keysym == XK_g && (event.xkey.state & ControlMask) != 0)
5456 XtUnmanageChild (dialog);
5457 }
5b3f8550 5458
24ca7c5a 5459 (void) x_dispatch_event (&event, FRAME_X_DISPLAY (f));
563b384d 5460 }
03100098 5461
333b20bb
GM
5462 /* Get the result. */
5463 if (result == XmCR_OK)
5464 {
91a3e27b 5465 XmString text_string;
333b20bb 5466 String data;
177c0ea7 5467
91a3e27b
PE
5468 XtVaGetValues (dialog, XmNtextString, &text_string, NULL);
5469 XmStringGetLtoR (text_string, XmFONTLIST_DEFAULT_TAG, &data);
5470 XmStringFree (text_string);
333b20bb
GM
5471 file = build_string (data);
5472 XtFree (data);
5473 }
5474 else
5475 file = Qnil;
5476
333b20bb
GM
5477 UNBLOCK_INPUT;
5478 UNGCPRO;
5479
5480 /* Make "Cancel" equivalent to C-g. */
5481 if (NILP (file))
5482 Fsignal (Qquit, Qnil);
177c0ea7 5483
a8f4bdc6
JD
5484 decoded_file = DECODE_FILE (file);
5485
5486 return unbind_to (count, decoded_file);
333b20bb
GM
5487}
5488
5489#endif /* USE_MOTIF */
5490
488dd4c4
JD
5491#ifdef USE_GTK
5492
24ca7c5a 5493static Lisp_Object
971de7fb 5494clean_up_dialog (Lisp_Object arg)
24ca7c5a
JD
5495{
5496 x_menu_set_in_use (0);
5497
5498 return Qnil;
5499}
5500
f9d64bb3
JD
5501DEFUN ("x-file-dialog", Fx_file_dialog, Sx_file_dialog, 2, 5, 0,
5502 doc: /* Read file name, prompting with PROMPT in directory DIR.
5503Use a file selection dialog. Select DEFAULT-FILENAME in the dialog's file
5504selection box, if specified. If MUSTMATCH is non-nil, the returned file
7c051dd8
GM
5505or directory must exist.
5506
5507This function is only defined on MS Windows, and X Windows with the
5508Motif or Gtk toolkits. With the Motif toolkit, ONLY-DIR-P is ignored.
5509Otherwise, if ONLY-DIR-P is non-nil, the user can only select directories. */)
5842a27b 5510 (Lisp_Object prompt, Lisp_Object dir, Lisp_Object default_filename, Lisp_Object mustmatch, Lisp_Object only_dir_p)
488dd4c4
JD
5511{
5512 FRAME_PTR f = SELECTED_FRAME ();
5513 char *fn;
5514 Lisp_Object file = Qnil;
a8f4bdc6 5515 Lisp_Object decoded_file;
24ca7c5a 5516 int count = SPECPDL_INDEX ();
f9d64bb3 5517 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
488dd4c4 5518 char *cdef_file;
177c0ea7 5519
6eeee4d6
YM
5520 check_x ();
5521
f9d64bb3 5522 GCPRO6 (prompt, dir, default_filename, mustmatch, only_dir_p, file);
24ca7c5a 5523
5ae53dcf 5524 if (popup_activated ())
24ca7c5a
JD
5525 error ("Trying to use a menu from within a menu-entry");
5526
488dd4c4
JD
5527 CHECK_STRING (prompt);
5528 CHECK_STRING (dir);
5529
5530 /* Prevent redisplay. */
5531 specbind (Qinhibit_redisplay, Qt);
24ca7c5a 5532 record_unwind_protect (clean_up_dialog, Qnil);
488dd4c4
JD
5533
5534 BLOCK_INPUT;
5535
5536 if (STRINGP (default_filename))
c0951e53 5537 cdef_file = SSDATA (default_filename);
488dd4c4 5538 else
c0951e53 5539 cdef_file = SSDATA (dir);
488dd4c4 5540
c0951e53 5541 fn = xg_get_file_name (f, SSDATA (prompt), cdef_file,
f9d64bb3
JD
5542 ! NILP (mustmatch),
5543 ! NILP (only_dir_p));
177c0ea7 5544
488dd4c4
JD
5545 if (fn)
5546 {
5547 file = build_string (fn);
5548 xfree (fn);
5549 }
5550
5551 UNBLOCK_INPUT;
5552 UNGCPRO;
5553
5554 /* Make "Cancel" equivalent to C-g. */
5555 if (NILP (file))
5556 Fsignal (Qquit, Qnil);
177c0ea7 5557
a8f4bdc6
JD
5558 decoded_file = DECODE_FILE (file);
5559
5560 return unbind_to (count, decoded_file);
488dd4c4
JD
5561}
5562
9bf80974
CY
5563
5564#ifdef HAVE_FREETYPE
5565
f82605c6
CY
5566DEFUN ("x-select-font", Fx_select_font, Sx_select_font, 0, 2, 0,
5567 doc: /* Read a font name using a GTK font selection dialog.
5568Return a GTK-style font string corresponding to the selection.
5569
5570If FRAME is omitted or nil, it defaults to the selected frame. */)
5842a27b 5571 (Lisp_Object frame, Lisp_Object ignored)
9bf80974 5572{
f82605c6 5573 FRAME_PTR f = check_x_frame (frame);
53c7540d 5574 char *name;
637fa988 5575 Lisp_Object font;
e0ab5fcf
JD
5576 Lisp_Object font_param;
5577 char *default_name = NULL;
637fa988 5578 struct gcpro gcpro1, gcpro2;
9bf80974
CY
5579 int count = SPECPDL_INDEX ();
5580
5581 check_x ();
5582
5583 if (popup_activated ())
5584 error ("Trying to use a menu from within a menu-entry");
5585
5586 /* Prevent redisplay. */
5587 specbind (Qinhibit_redisplay, Qt);
5588 record_unwind_protect (clean_up_dialog, Qnil);
5589
5590 BLOCK_INPUT;
5591
637fa988 5592 GCPRO2(font_param, font);
e0ab5fcf 5593
637fa988 5594 XSETFONT (font, FRAME_FONT (f));
581e51e8 5595 font_param = Ffont_get (font, intern (":name"));
637fa988 5596 if (STRINGP (font_param))
c0951e53 5597 default_name = xstrdup (SSDATA (font_param));
f5f6c0e0 5598 else
53c7540d 5599 {
637fa988
JD
5600 font_param = Fframe_parameter (frame, Qfont_param);
5601 if (STRINGP (font_param))
c0951e53 5602 default_name = xstrdup (SSDATA (font_param));
53c7540d 5603 }
e0ab5fcf 5604
637fa988 5605 if (default_name == NULL && x_last_font_name != NULL)
581e51e8
JD
5606 default_name = xstrdup (x_last_font_name);
5607
5608 /* Convert fontconfig names to Gtk names, i.e. remove - before number */
f5f6c0e0 5609 if (default_name)
581e51e8
JD
5610 {
5611 char *p = strrchr (default_name, '-');
5612 if (p)
5613 {
5614 char *ep = p+1;
5615 while (isdigit (*ep))
5616 ++ep;
5617 if (*ep == '\0') *p = ' ';
5618 }
5619 }
637fa988 5620
e0ab5fcf 5621 name = xg_get_font_name (f, default_name);
581e51e8 5622 xfree (default_name);
9bf80974 5623
53c7540d 5624 if (name)
9bf80974 5625 {
53c7540d 5626 font = build_string (name);
e0ab5fcf
JD
5627 g_free (x_last_font_name);
5628 x_last_font_name = name;
9bf80974
CY
5629 }
5630
5631 UNBLOCK_INPUT;
5632
5633 if (NILP (font))
5634 Fsignal (Qquit, Qnil);
5635
5636 return unbind_to (count, font);
5637}
5638#endif /* HAVE_FREETYPE */
5639
488dd4c4 5640#endif /* USE_GTK */
333b20bb
GM
5641
5642\f
82bab41c
GM
5643/***********************************************************************
5644 Keyboard
5645 ***********************************************************************/
5646
5647#ifdef HAVE_XKBGETKEYBOARD
5648#include <X11/XKBlib.h>
5649#include <X11/keysym.h>
5650#endif
5651
5652DEFUN ("x-backspace-delete-keys-p", Fx_backspace_delete_keys_p,
5653 Sx_backspace_delete_keys_p, 0, 1, 0,
7ee72033 5654 doc: /* Check if both Backspace and Delete keys are on the keyboard of FRAME.
c061c855
GM
5655FRAME nil means use the selected frame.
5656Value is t if we know that both keys are present, and are mapped to the
20d1c5c5
DN
5657usual X keysyms. Value is `lambda' if we cannot determine if both keys are
5658present and mapped to the usual X keysyms. */)
5842a27b 5659 (Lisp_Object frame)
82bab41c
GM
5660{
5661#ifdef HAVE_XKBGETKEYBOARD
5662 XkbDescPtr kb;
5663 struct frame *f = check_x_frame (frame);
5664 Display *dpy = FRAME_X_DISPLAY (f);
5665 Lisp_Object have_keys;
58d2d479 5666 int major, minor, op, event, error_code;
82bab41c
GM
5667
5668 BLOCK_INPUT;
46f6a258
GM
5669
5670 /* Check library version in case we're dynamically linked. */
5671 major = XkbMajorVersion;
5672 minor = XkbMinorVersion;
5673 if (!XkbLibraryVersion (&major, &minor))
c1efd260
GM
5674 {
5675 UNBLOCK_INPUT;
20d1c5c5 5676 return Qlambda;
c1efd260 5677 }
46f6a258
GM
5678
5679 /* Check that the server supports XKB. */
5680 major = XkbMajorVersion;
5681 minor = XkbMinorVersion;
58d2d479 5682 if (!XkbQueryExtension (dpy, &op, &event, &error_code, &major, &minor))
c1efd260
GM
5683 {
5684 UNBLOCK_INPUT;
20d1c5c5 5685 return Qlambda;
c1efd260 5686 }
177c0ea7 5687
3a441526
JD
5688 /* In this code we check that the keyboard has physical keys with names
5689 that start with BKSP (Backspace) and DELE (Delete), and that they
5690 generate keysym XK_BackSpace and XK_Delete respectively.
5691 This function is used to test if normal-erase-is-backspace should be
5692 turned on.
5693 An alternative approach would be to just check if XK_BackSpace and
5694 XK_Delete are mapped to any key. But if any of those are mapped to
5695 some non-intuitive key combination (Meta-Shift-Ctrl-whatever) and the
5696 user doesn't know about it, it is better to return false here.
5697 It is more obvious to the user what to do if she/he has two keys
5698 clearly marked with names/symbols and one key does something not
5699 expected (i.e. she/he then tries the other).
5700 The cases where Backspace/Delete is mapped to some other key combination
5701 are rare, and in those cases, normal-erase-is-backspace can be turned on
5702 manually. */
5703
46f6a258 5704 have_keys = Qnil;
c1efd260 5705 kb = XkbGetMap (dpy, XkbAllMapComponentsMask, XkbUseCoreKbd);
82bab41c
GM
5706 if (kb)
5707 {
5708 int delete_keycode = 0, backspace_keycode = 0, i;
c1efd260
GM
5709
5710 if (XkbGetNames (dpy, XkbAllNamesMask, kb) == Success)
82bab41c 5711 {
c1efd260
GM
5712 for (i = kb->min_key_code;
5713 (i < kb->max_key_code
5714 && (delete_keycode == 0 || backspace_keycode == 0));
5715 ++i)
5716 {
d63931a2
GM
5717 /* The XKB symbolic key names can be seen most easily in
5718 the PS file generated by `xkbprint -label name
5719 $DISPLAY'. */
72af86bd 5720 if (memcmp ("DELE", kb->names->keys[i].name, 4) == 0)
c1efd260 5721 delete_keycode = i;
72af86bd 5722 else if (memcmp ("BKSP", kb->names->keys[i].name, 4) == 0)
c1efd260
GM
5723 backspace_keycode = i;
5724 }
5725
5726 XkbFreeNames (kb, 0, True);
82bab41c
GM
5727 }
5728
c1efd260 5729 XkbFreeClientMap (kb, 0, True);
177c0ea7 5730
82bab41c
GM
5731 if (delete_keycode
5732 && backspace_keycode
5733 && XKeysymToKeycode (dpy, XK_Delete) == delete_keycode
5734 && XKeysymToKeycode (dpy, XK_BackSpace) == backspace_keycode)
5735 have_keys = Qt;
5736 }
5737 UNBLOCK_INPUT;
5738 return have_keys;
5739#else /* not HAVE_XKBGETKEYBOARD */
20d1c5c5 5740 return Qlambda;
82bab41c
GM
5741#endif /* not HAVE_XKBGETKEYBOARD */
5742}
5743
5744
5745\f
333b20bb
GM
5746/***********************************************************************
5747 Initialization
5748 ***********************************************************************/
5749
4dacadcc 5750/* Keep this list in the same order as frame_parms in frame.c.
7c0d3ed8
KS
5751 Use 0 for unsupported frame parameters. */
5752
5753frame_parm_handler x_frame_parm_handlers[] =
5754{
5755 x_set_autoraise,
5756 x_set_autolower,
5757 x_set_background_color,
5758 x_set_border_color,
5759 x_set_border_width,
5760 x_set_cursor_color,
5761 x_set_cursor_type,
5762 x_set_font,
5763 x_set_foreground_color,
5764 x_set_icon_name,
5765 x_set_icon_type,
5766 x_set_internal_border_width,
5767 x_set_menu_bar_lines,
5768 x_set_mouse_color,
5769 x_explicitly_set_name,
5770 x_set_scroll_bar_width,
5771 x_set_title,
5772 x_set_unsplittable,
5773 x_set_vertical_scroll_bars,
5774 x_set_visibility,
5775 x_set_tool_bar_lines,
5776 x_set_scroll_bar_foreground,
5777 x_set_scroll_bar_background,
5778 x_set_screen_gamma,
5779 x_set_line_spacing,
5780 x_set_fringe_width,
5781 x_set_fringe_width,
5782 x_set_wait_for_wm,
5783 x_set_fullscreen,
271a71c7 5784 x_set_font_backend,
cad9ef74
JD
5785 x_set_alpha,
5786 x_set_sticky,
bfeabdc3 5787 x_set_tool_bar_position,
7c0d3ed8
KS
5788};
5789
333b20bb 5790void
971de7fb 5791syms_of_xfns (void)
333b20bb
GM
5792{
5793 /* This is zero if not using X windows. */
5794 x_in_use = 0;
5795
5796 /* The section below is built by the lisp expression at the top of the file,
5797 just above where these variables are declared. */
5798 /*&&& init symbols here &&&*/
d67b4f80 5799 Qnone = intern_c_string ("none");
baaed68e 5800 staticpro (&Qnone);
d67b4f80 5801 Qsuppress_icon = intern_c_string ("suppress-icon");
8af1d7ca 5802 staticpro (&Qsuppress_icon);
d67b4f80 5803 Qundefined_color = intern_c_string ("undefined-color");
f9942c9e 5804 staticpro (&Qundefined_color);
d67b4f80 5805 Qcompound_text = intern_c_string ("compound-text");
96db09e4 5806 staticpro (&Qcompound_text);
d67b4f80 5807 Qcancel_timer = intern_c_string ("cancel-timer");
ae782866 5808 staticpro (&Qcancel_timer);
d67b4f80 5809 Qfont_param = intern_c_string ("font-parameter");
27129af9 5810 staticpro (&Qfont_param);
f9942c9e
JB
5811 /* This is the end of symbol initialization. */
5812
58cad5ed
KH
5813 /* Text property `display' should be nonsticky by default. */
5814 Vtext_property_default_nonsticky
5815 = Fcons (Fcons (Qdisplay, Qt), Vtext_property_default_nonsticky);
5816
5817
01f1ba30 5818 Fput (Qundefined_color, Qerror_conditions,
d67b4f80 5819 pure_cons (Qundefined_color, pure_cons (Qerror, Qnil)));
01f1ba30 5820 Fput (Qundefined_color, Qerror_message,
d67b4f80 5821 make_pure_c_string ("Undefined color"));
01f1ba30 5822
29208e82 5823 DEFVAR_LISP ("x-pointer-shape", Vx_pointer_shape,
7ee72033 5824 doc: /* The shape of the pointer when over text.
c061c855
GM
5825Changing the value does not affect existing frames
5826unless you set the mouse color. */);
01f1ba30
JB
5827 Vx_pointer_shape = Qnil;
5828
ca0ecbf5 5829#if 0 /* This doesn't really do anything. */
29208e82 5830 DEFVAR_LISP ("x-nontext-pointer-shape", Vx_nontext_pointer_shape,
7ee72033 5831 doc: /* The shape of the pointer when not over text.
c061c855
GM
5832This variable takes effect when you create a new frame
5833or when you set the mouse color. */);
af01ef26 5834#endif
01f1ba30
JB
5835 Vx_nontext_pointer_shape = Qnil;
5836
29208e82 5837 DEFVAR_LISP ("x-hourglass-pointer-shape", Vx_hourglass_pointer_shape,
7ee72033 5838 doc: /* The shape of the pointer when Emacs is busy.
c061c855
GM
5839This variable takes effect when you create a new frame
5840or when you set the mouse color. */);
0af913d7 5841 Vx_hourglass_pointer_shape = Qnil;
333b20bb 5842
ca0ecbf5 5843#if 0 /* This doesn't really do anything. */
29208e82 5844 DEFVAR_LISP ("x-mode-pointer-shape", Vx_mode_pointer_shape,
7ee72033 5845 doc: /* The shape of the pointer when over the mode line.
c061c855
GM
5846This variable takes effect when you create a new frame
5847or when you set the mouse color. */);
af01ef26 5848#endif
01f1ba30
JB
5849 Vx_mode_pointer_shape = Qnil;
5850
d3b06468 5851 DEFVAR_LISP ("x-sensitive-text-pointer-shape",
29208e82 5852 Vx_sensitive_text_pointer_shape,
7ee72033 5853 doc: /* The shape of the pointer when over mouse-sensitive text.
c061c855
GM
5854This variable takes effect when you create a new frame
5855or when you set the mouse color. */);
ca0ecbf5 5856 Vx_sensitive_text_pointer_shape = Qnil;
95f80c78 5857
8fb4ec9c 5858 DEFVAR_LISP ("x-window-horizontal-drag-cursor",
29208e82 5859 Vx_window_horizontal_drag_shape,
7ee72033 5860 doc: /* Pointer shape to use for indicating a window can be dragged horizontally.
c061c855
GM
5861This variable takes effect when you create a new frame
5862or when you set the mouse color. */);
8fb4ec9c
GM
5863 Vx_window_horizontal_drag_shape = Qnil;
5864
29208e82 5865 DEFVAR_LISP ("x-cursor-fore-pixel", Vx_cursor_fore_pixel,
7ee72033 5866 doc: /* A string indicating the foreground color of the cursor box. */);
01f1ba30
JB
5867 Vx_cursor_fore_pixel = Qnil;
5868
29208e82 5869 DEFVAR_LISP ("x-max-tooltip-size", Vx_max_tooltip_size,
f5f6c0e0
JB
5870 doc: /* Maximum size for tooltips.
5871Value is a pair (COLUMNS . ROWS). Text larger than this is clipped. */);
d63931a2 5872 Vx_max_tooltip_size = Fcons (make_number (80), make_number (40));
177c0ea7 5873
29208e82 5874 DEFVAR_LISP ("x-no-window-manager", Vx_no_window_manager,
7ee72033 5875 doc: /* Non-nil if no X window manager is in use.
c061c855
GM
5876Emacs doesn't try to figure this out; this is always nil
5877unless you set it to something else. */);
2d38195d
RS
5878 /* We don't have any way to find this out, so set it to nil
5879 and maybe the user would like to set it to t. */
5880 Vx_no_window_manager = Qnil;
1d3dac41 5881
942ea06d 5882 DEFVAR_LISP ("x-pixel-size-width-font-regexp",
29208e82 5883 Vx_pixel_size_width_font_regexp,
7ee72033 5884 doc: /* Regexp matching a font name whose width is the same as `PIXEL_SIZE'.
c061c855
GM
5885
5886Since Emacs gets width of a font matching with this regexp from
5887PIXEL_SIZE field of the name, font finding mechanism gets faster for
5888such a font. This is especially effective for such large fonts as
5889Chinese, Japanese, and Korean. */);
942ea06d
KH
5890 Vx_pixel_size_width_font_regexp = Qnil;
5891
255e4140 5892/* This is not ifdef:ed, so other builds than GTK can customize it. */
29208e82 5893 DEFVAR_BOOL ("x-gtk-use-old-file-dialog", x_gtk_use_old_file_dialog,
255e4140
JD
5894 doc: /* *Non-nil means prompt with the old GTK file selection dialog.
5895If nil or if the file selection dialog is not available, the new GTK file
5896chooser is used instead. To turn off all file dialogs set the
5897variable `use-file-dialog'. */);
fe2b14b7 5898 x_gtk_use_old_file_dialog = 0;
255e4140 5899
29208e82 5900 DEFVAR_BOOL ("x-gtk-show-hidden-files", x_gtk_show_hidden_files,
a8a35720
JD
5901 doc: /* *If non-nil, the GTK file chooser will by default show hidden files.
5902Note that this is just the default, there is a toggle button on the file
5903chooser to show or not show hidden files on a case by case basis. */);
5904 x_gtk_show_hidden_files = 0;
5905
29208e82 5906 DEFVAR_BOOL ("x-gtk-file-dialog-help-text", x_gtk_file_dialog_help_text,
66687b7c 5907 doc: /* *If non-nil, the GTK file chooser will show additional help text.
641c0105
JD
5908If more space for files in the file chooser dialog is wanted, set this to nil
5909to turn the additional text off. */);
159f8da7 5910 x_gtk_file_dialog_help_text = 1;
641c0105 5911
29208e82 5912 DEFVAR_BOOL ("x-gtk-whole-detached-tool-bar", x_gtk_whole_detached_tool_bar,
e0f467cb
JD
5913 doc: /* *If non-nil, a detached tool bar is shown in full.
5914The default is to just show an arrow and pressing on that arrow shows
5915the tool bar buttons. */);
5916 x_gtk_whole_detached_tool_bar = 0;
5917
29208e82 5918 DEFVAR_BOOL ("x-gtk-use-system-tooltips", x_gtk_use_system_tooltips,
aa1859f5
J
5919 doc: /* *If non-nil with a Gtk+ built Emacs, the Gtk+ toolip is used.
5920Otherwise use Emacs own tooltip implementation.
5921When using Gtk+ tooltips, the tooltip face is not used. */);
5922 x_gtk_use_system_tooltips = 1;
5923
d67b4f80 5924 Fprovide (intern_c_string ("x"), Qnil);
49be9d28 5925
1d3dac41 5926#ifdef USE_X_TOOLKIT
d67b4f80 5927 Fprovide (intern_c_string ("x-toolkit"), Qnil);
5b827abb 5928#ifdef USE_MOTIF
d67b4f80 5929 Fprovide (intern_c_string ("motif"), Qnil);
fc2cdd9a 5930
29208e82 5931 DEFVAR_LISP ("motif-version-string", Vmotif_version_string,
7ee72033 5932 doc: /* Version info for LessTif/Motif. */);
fc2cdd9a
GM
5933 Vmotif_version_string = build_string (XmVERSION_STRING);
5934#endif /* USE_MOTIF */
5935#endif /* USE_X_TOOLKIT */
01f1ba30 5936
6b61353c 5937#ifdef USE_GTK
1ec2a572
JD
5938 /* Provide x-toolkit also for GTK. Internally GTK does not use Xt so it
5939 is not an X toolkit in that sense (USE_X_TOOLKIT is not defined).
5940 But for a user it is a toolkit for X, and indeed, configure
5941 accepts --with-x-toolkit=gtk. */
d67b4f80
DN
5942 Fprovide (intern_c_string ("x-toolkit"), Qnil);
5943 Fprovide (intern_c_string ("gtk"), Qnil);
bfeabdc3 5944 Fprovide (intern_c_string ("move-toolbar"), Qnil);
6b61353c 5945
29208e82 5946 DEFVAR_LISP ("gtk-version-string", Vgtk_version_string,
6b61353c
KH
5947 doc: /* Version info for GTK+. */);
5948 {
5949 char gtk_version[40];
5950 g_snprintf (gtk_version, sizeof (gtk_version), "%u.%u.%u",
5951 GTK_MAJOR_VERSION, GTK_MINOR_VERSION, GTK_MICRO_VERSION);
a4ada374 5952 Vgtk_version_string = make_pure_string (gtk_version, strlen (gtk_version), strlen (gtk_version), 0);
6b61353c
KH
5953 }
5954#endif /* USE_GTK */
5955
333b20bb
GM
5956 /* X window properties. */
5957 defsubr (&Sx_change_window_property);
5958 defsubr (&Sx_delete_window_property);
5959 defsubr (&Sx_window_property);
5960
2d764c78 5961 defsubr (&Sxw_display_color_p);
d0c9d219 5962 defsubr (&Sx_display_grayscale_p);
2d764c78
EZ
5963 defsubr (&Sxw_color_defined_p);
5964 defsubr (&Sxw_color_values);
9d317b2c 5965 defsubr (&Sx_server_max_request_size);
41beb8fc
RS
5966 defsubr (&Sx_server_vendor);
5967 defsubr (&Sx_server_version);
5968 defsubr (&Sx_display_pixel_width);
5969 defsubr (&Sx_display_pixel_height);
5970 defsubr (&Sx_display_mm_width);
5971 defsubr (&Sx_display_mm_height);
5972 defsubr (&Sx_display_screens);
5973 defsubr (&Sx_display_planes);
5974 defsubr (&Sx_display_color_cells);
5975 defsubr (&Sx_display_visual_class);
5976 defsubr (&Sx_display_backing_store);
5977 defsubr (&Sx_display_save_under);
1c44e124 5978 defsubr (&Sx_wm_set_size_hint);
f676886a 5979 defsubr (&Sx_create_frame);
01f1ba30 5980 defsubr (&Sx_open_connection);
08a90d6a
RS
5981 defsubr (&Sx_close_connection);
5982 defsubr (&Sx_display_list);
01f1ba30 5983 defsubr (&Sx_synchronize);
3decc1e7 5984 defsubr (&Sx_focus_frame);
82bab41c 5985 defsubr (&Sx_backspace_delete_keys_p);
177c0ea7 5986
942ea06d 5987 /* Setting callback functions for fontset handler. */
942ea06d 5988 check_window_system_func = check_x;
333b20bb 5989
333b20bb
GM
5990 defsubr (&Sx_show_tip);
5991 defsubr (&Sx_hide_tip);
333b20bb 5992 tip_timer = Qnil;
44b5a125
GM
5993 staticpro (&tip_timer);
5994 tip_frame = Qnil;
5995 staticpro (&tip_frame);
333b20bb 5996
06d62053
GM
5997 last_show_tip_args = Qnil;
5998 staticpro (&last_show_tip_args);
5999
90f2e16b 6000 defsubr (&Sx_uses_old_gtk_dialog);
29fabd8c 6001#if defined (USE_MOTIF) || defined (USE_GTK)
333b20bb
GM
6002 defsubr (&Sx_file_dialog);
6003#endif
9bf80974 6004
946598bf 6005#if defined (USE_GTK) && defined (HAVE_FREETYPE)
f82605c6 6006 defsubr (&Sx_select_font);
e0ab5fcf 6007 x_last_font_name = NULL;
9bf80974 6008#endif
333b20bb
GM
6009}
6010
01f1ba30 6011#endif /* HAVE_X_WINDOWS */