*** empty log message ***
[emacs.git] / src / xselect.c
blob5519eecf64cb1287be198d898cf76433c8502421
1 /* X Selection processing for Emacs.
2 Copyright (C) 1993, 1994, 1995, 1996, 1997, 2000, 2001
3 Free Software Foundation.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
10 any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
23 /* Rewritten by jwz */
25 #include <config.h>
26 #include "lisp.h"
27 #include "xterm.h" /* for all of the X includes */
28 #include "dispextern.h" /* frame.h seems to want this */
29 #include "frame.h" /* Need this to get the X window of selected_frame */
30 #include "blockinput.h"
31 #include "buffer.h"
32 #include "charset.h"
33 #include "coding.h"
34 #include "process.h"
35 #include "composite.h"
37 struct prop_location;
39 static Lisp_Object x_atom_to_symbol P_ ((Display *dpy, Atom atom));
40 static Atom symbol_to_x_atom P_ ((struct x_display_info *, Display *,
41 Lisp_Object));
42 static void x_own_selection P_ ((Lisp_Object, Lisp_Object));
43 static Lisp_Object x_get_local_selection P_ ((Lisp_Object, Lisp_Object));
44 static void x_decline_selection_request P_ ((struct input_event *));
45 static Lisp_Object x_selection_request_lisp_error P_ ((Lisp_Object));
46 static Lisp_Object queue_selection_requests_unwind P_ ((Lisp_Object));
47 static Lisp_Object some_frame_on_display P_ ((struct x_display_info *));
48 static void x_reply_selection_request P_ ((struct input_event *, int,
49 unsigned char *, int, Atom));
50 static int waiting_for_other_props_on_window P_ ((Display *, Window));
51 static struct prop_location *expect_property_change P_ ((Display *, Window,
52 Atom, int));
53 static void unexpect_property_change P_ ((struct prop_location *));
54 static Lisp_Object wait_for_property_change_unwind P_ ((Lisp_Object));
55 static void wait_for_property_change P_ ((struct prop_location *));
56 static Lisp_Object x_get_foreign_selection P_ ((Lisp_Object, Lisp_Object));
57 static void x_get_window_property P_ ((Display *, Window, Atom,
58 unsigned char **, int *,
59 Atom *, int *, unsigned long *, int));
60 static void receive_incremental_selection P_ ((Display *, Window, Atom,
61 Lisp_Object, unsigned,
62 unsigned char **, int *,
63 Atom *, int *, unsigned long *));
64 static Lisp_Object x_get_window_property_as_lisp_data P_ ((Display *,
65 Window, Atom,
66 Lisp_Object, Atom));
67 static Lisp_Object selection_data_to_lisp_data P_ ((Display *, unsigned char *,
68 int, Atom, int));
69 static void lisp_data_to_selection_data P_ ((Display *, Lisp_Object,
70 unsigned char **, Atom *,
71 unsigned *, int *, int *));
72 static Lisp_Object clean_local_selection_data P_ ((Lisp_Object));
73 static void initialize_cut_buffers P_ ((Display *, Window));
76 /* Printing traces to stderr. */
78 #ifdef TRACE_SELECTION
79 #define TRACE0(fmt) \
80 fprintf (stderr, "%d: " fmt "\n", getpid ())
81 #define TRACE1(fmt, a0) \
82 fprintf (stderr, "%d: " fmt "\n", getpid (), a0)
83 #define TRACE2(fmt, a0, a1) \
84 fprintf (stderr, "%d: " fmt "\n", getpid (), a0, a1)
85 #else
86 #define TRACE0(fmt) (void) 0
87 #define TRACE1(fmt, a0) (void) 0
88 #define TRACE2(fmt, a0, a1) (void) 0
89 #endif
92 #define CUT_BUFFER_SUPPORT
94 Lisp_Object QPRIMARY, QSECONDARY, QSTRING, QINTEGER, QCLIPBOARD, QTIMESTAMP,
95 QTEXT, QDELETE, QMULTIPLE, QINCR, QEMACS_TMP, QTARGETS, QATOM, QNULL,
96 QATOM_PAIR;
98 Lisp_Object QCOMPOUND_TEXT; /* This is a type of selection. */
100 Lisp_Object Qcompound_text_with_extensions;
102 #ifdef CUT_BUFFER_SUPPORT
103 Lisp_Object QCUT_BUFFER0, QCUT_BUFFER1, QCUT_BUFFER2, QCUT_BUFFER3,
104 QCUT_BUFFER4, QCUT_BUFFER5, QCUT_BUFFER6, QCUT_BUFFER7;
105 #endif
107 static Lisp_Object Vx_lost_selection_hooks;
108 static Lisp_Object Vx_sent_selection_hooks;
109 /* Coding system for communicating with other X clients via cutbuffer,
110 selection, and clipboard. */
111 static Lisp_Object Vselection_coding_system;
113 /* Coding system for the next communicating with other X clients. */
114 static Lisp_Object Vnext_selection_coding_system;
116 /* If this is a smaller number than the max-request-size of the display,
117 emacs will use INCR selection transfer when the selection is larger
118 than this. The max-request-size is usually around 64k, so if you want
119 emacs to use incremental selection transfers when the selection is
120 smaller than that, set this. I added this mostly for debugging the
121 incremental transfer stuff, but it might improve server performance. */
122 #define MAX_SELECTION_QUANTUM 0xFFFFFF
124 #ifdef HAVE_X11R4
125 #define SELECTION_QUANTUM(dpy) ((XMaxRequestSize(dpy) << 2) - 100)
126 #else
127 #define SELECTION_QUANTUM(dpy) (((dpy)->max_request_size << 2) - 100)
128 #endif
130 /* The timestamp of the last input event Emacs received from the X server. */
131 /* Defined in keyboard.c. */
132 extern unsigned long last_event_timestamp;
134 /* This is an association list whose elements are of the form
135 ( SELECTION-NAME SELECTION-VALUE SELECTION-TIMESTAMP FRAME)
136 SELECTION-NAME is a lisp symbol, whose name is the name of an X Atom.
137 SELECTION-VALUE is the value that emacs owns for that selection.
138 It may be any kind of Lisp object.
139 SELECTION-TIMESTAMP is the time at which emacs began owning this selection,
140 as a cons of two 16-bit numbers (making a 32 bit time.)
141 FRAME is the frame for which we made the selection.
142 If there is an entry in this alist, then it can be assumed that Emacs owns
143 that selection.
144 The only (eq) parts of this list that are visible from Lisp are the
145 selection-values. */
146 static Lisp_Object Vselection_alist;
148 /* This is an alist whose CARs are selection-types (whose names are the same
149 as the names of X Atoms) and whose CDRs are the names of Lisp functions to
150 call to convert the given Emacs selection value to a string representing
151 the given selection type. This is for Lisp-level extension of the emacs
152 selection handling. */
153 static Lisp_Object Vselection_converter_alist;
155 /* If the selection owner takes too long to reply to a selection request,
156 we give up on it. This is in milliseconds (0 = no timeout.) */
157 static EMACS_INT x_selection_timeout;
159 /* Utility functions */
161 static void lisp_data_to_selection_data ();
162 static Lisp_Object selection_data_to_lisp_data ();
163 static Lisp_Object x_get_window_property_as_lisp_data ();
165 /* This converts a Lisp symbol to a server Atom, avoiding a server
166 roundtrip whenever possible. */
168 static Atom
169 symbol_to_x_atom (dpyinfo, display, sym)
170 struct x_display_info *dpyinfo;
171 Display *display;
172 Lisp_Object sym;
174 Atom val;
175 if (NILP (sym)) return 0;
176 if (EQ (sym, QPRIMARY)) return XA_PRIMARY;
177 if (EQ (sym, QSECONDARY)) return XA_SECONDARY;
178 if (EQ (sym, QSTRING)) return XA_STRING;
179 if (EQ (sym, QINTEGER)) return XA_INTEGER;
180 if (EQ (sym, QATOM)) return XA_ATOM;
181 if (EQ (sym, QCLIPBOARD)) return dpyinfo->Xatom_CLIPBOARD;
182 if (EQ (sym, QTIMESTAMP)) return dpyinfo->Xatom_TIMESTAMP;
183 if (EQ (sym, QTEXT)) return dpyinfo->Xatom_TEXT;
184 if (EQ (sym, QCOMPOUND_TEXT)) return dpyinfo->Xatom_COMPOUND_TEXT;
185 if (EQ (sym, QDELETE)) return dpyinfo->Xatom_DELETE;
186 if (EQ (sym, QMULTIPLE)) return dpyinfo->Xatom_MULTIPLE;
187 if (EQ (sym, QINCR)) return dpyinfo->Xatom_INCR;
188 if (EQ (sym, QEMACS_TMP)) return dpyinfo->Xatom_EMACS_TMP;
189 if (EQ (sym, QTARGETS)) return dpyinfo->Xatom_TARGETS;
190 if (EQ (sym, QNULL)) return dpyinfo->Xatom_NULL;
191 #ifdef CUT_BUFFER_SUPPORT
192 if (EQ (sym, QCUT_BUFFER0)) return XA_CUT_BUFFER0;
193 if (EQ (sym, QCUT_BUFFER1)) return XA_CUT_BUFFER1;
194 if (EQ (sym, QCUT_BUFFER2)) return XA_CUT_BUFFER2;
195 if (EQ (sym, QCUT_BUFFER3)) return XA_CUT_BUFFER3;
196 if (EQ (sym, QCUT_BUFFER4)) return XA_CUT_BUFFER4;
197 if (EQ (sym, QCUT_BUFFER5)) return XA_CUT_BUFFER5;
198 if (EQ (sym, QCUT_BUFFER6)) return XA_CUT_BUFFER6;
199 if (EQ (sym, QCUT_BUFFER7)) return XA_CUT_BUFFER7;
200 #endif
201 if (!SYMBOLP (sym)) abort ();
203 TRACE1 (" XInternAtom %s", (char *) SDATA (SYMBOL_NAME (sym)));
204 BLOCK_INPUT;
205 val = XInternAtom (display, (char *) SDATA (SYMBOL_NAME (sym)), False);
206 UNBLOCK_INPUT;
207 return val;
211 /* This converts a server Atom to a Lisp symbol, avoiding server roundtrips
212 and calls to intern whenever possible. */
214 static Lisp_Object
215 x_atom_to_symbol (dpy, atom)
216 Display *dpy;
217 Atom atom;
219 struct x_display_info *dpyinfo;
220 char *str;
221 Lisp_Object val;
223 if (! atom)
224 return Qnil;
226 switch (atom)
228 case XA_PRIMARY:
229 return QPRIMARY;
230 case XA_SECONDARY:
231 return QSECONDARY;
232 case XA_STRING:
233 return QSTRING;
234 case XA_INTEGER:
235 return QINTEGER;
236 case XA_ATOM:
237 return QATOM;
238 #ifdef CUT_BUFFER_SUPPORT
239 case XA_CUT_BUFFER0:
240 return QCUT_BUFFER0;
241 case XA_CUT_BUFFER1:
242 return QCUT_BUFFER1;
243 case XA_CUT_BUFFER2:
244 return QCUT_BUFFER2;
245 case XA_CUT_BUFFER3:
246 return QCUT_BUFFER3;
247 case XA_CUT_BUFFER4:
248 return QCUT_BUFFER4;
249 case XA_CUT_BUFFER5:
250 return QCUT_BUFFER5;
251 case XA_CUT_BUFFER6:
252 return QCUT_BUFFER6;
253 case XA_CUT_BUFFER7:
254 return QCUT_BUFFER7;
255 #endif
258 dpyinfo = x_display_info_for_display (dpy);
259 if (atom == dpyinfo->Xatom_CLIPBOARD)
260 return QCLIPBOARD;
261 if (atom == dpyinfo->Xatom_TIMESTAMP)
262 return QTIMESTAMP;
263 if (atom == dpyinfo->Xatom_TEXT)
264 return QTEXT;
265 if (atom == dpyinfo->Xatom_COMPOUND_TEXT)
266 return QCOMPOUND_TEXT;
267 if (atom == dpyinfo->Xatom_DELETE)
268 return QDELETE;
269 if (atom == dpyinfo->Xatom_MULTIPLE)
270 return QMULTIPLE;
271 if (atom == dpyinfo->Xatom_INCR)
272 return QINCR;
273 if (atom == dpyinfo->Xatom_EMACS_TMP)
274 return QEMACS_TMP;
275 if (atom == dpyinfo->Xatom_TARGETS)
276 return QTARGETS;
277 if (atom == dpyinfo->Xatom_NULL)
278 return QNULL;
280 BLOCK_INPUT;
281 str = XGetAtomName (dpy, atom);
282 UNBLOCK_INPUT;
283 TRACE1 ("XGetAtomName --> %s", str);
284 if (! str) return Qnil;
285 val = intern (str);
286 BLOCK_INPUT;
287 /* This was allocated by Xlib, so use XFree. */
288 XFree (str);
289 UNBLOCK_INPUT;
290 return val;
293 /* Do protocol to assert ourself as a selection owner.
294 Update the Vselection_alist so that we can reply to later requests for
295 our selection. */
297 static void
298 x_own_selection (selection_name, selection_value)
299 Lisp_Object selection_name, selection_value;
301 struct frame *sf = SELECTED_FRAME ();
302 Window selecting_window = FRAME_X_WINDOW (sf);
303 Display *display = FRAME_X_DISPLAY (sf);
304 Time time = last_event_timestamp;
305 Atom selection_atom;
306 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (sf);
307 int count;
309 CHECK_SYMBOL (selection_name);
310 selection_atom = symbol_to_x_atom (dpyinfo, display, selection_name);
312 BLOCK_INPUT;
313 count = x_catch_errors (display);
314 XSetSelectionOwner (display, selection_atom, selecting_window, time);
315 x_check_errors (display, "Can't set selection: %s");
316 x_uncatch_errors (display, count);
317 UNBLOCK_INPUT;
319 /* Now update the local cache */
321 Lisp_Object selection_time;
322 Lisp_Object selection_data;
323 Lisp_Object prev_value;
325 selection_time = long_to_cons ((unsigned long) time);
326 selection_data = Fcons (selection_name,
327 Fcons (selection_value,
328 Fcons (selection_time,
329 Fcons (selected_frame, Qnil))));
330 prev_value = assq_no_quit (selection_name, Vselection_alist);
332 Vselection_alist = Fcons (selection_data, Vselection_alist);
334 /* If we already owned the selection, remove the old selection data.
335 Perhaps we should destructively modify it instead.
336 Don't use Fdelq as that may QUIT. */
337 if (!NILP (prev_value))
339 Lisp_Object rest; /* we know it's not the CAR, so it's easy. */
340 for (rest = Vselection_alist; !NILP (rest); rest = Fcdr (rest))
341 if (EQ (prev_value, Fcar (XCDR (rest))))
343 XSETCDR (rest, Fcdr (XCDR (rest)));
344 break;
350 /* Given a selection-name and desired type, look up our local copy of
351 the selection value and convert it to the type.
352 The value is nil or a string.
353 This function is used both for remote requests
354 and for local x-get-selection-internal.
356 This calls random Lisp code, and may signal or gc. */
358 static Lisp_Object
359 x_get_local_selection (selection_symbol, target_type)
360 Lisp_Object selection_symbol, target_type;
362 Lisp_Object local_value;
363 Lisp_Object handler_fn, value, type, check;
364 int count;
366 local_value = assq_no_quit (selection_symbol, Vselection_alist);
368 if (NILP (local_value)) return Qnil;
370 /* TIMESTAMP and MULTIPLE are special cases 'cause that's easiest. */
371 if (EQ (target_type, QTIMESTAMP))
373 handler_fn = Qnil;
374 value = XCAR (XCDR (XCDR (local_value)));
376 #if 0
377 else if (EQ (target_type, QDELETE))
379 handler_fn = Qnil;
380 Fx_disown_selection_internal
381 (selection_symbol,
382 XCAR (XCDR (XCDR (local_value))));
383 value = QNULL;
385 #endif
387 #if 0 /* #### MULTIPLE doesn't work yet */
388 else if (CONSP (target_type)
389 && XCAR (target_type) == QMULTIPLE)
391 Lisp_Object pairs;
392 int size;
393 int i;
394 pairs = XCDR (target_type);
395 size = XVECTOR (pairs)->size;
396 /* If the target is MULTIPLE, then target_type looks like
397 (MULTIPLE . [[SELECTION1 TARGET1] [SELECTION2 TARGET2] ... ])
398 We modify the second element of each pair in the vector and
399 return it as [[SELECTION1 <value1>] [SELECTION2 <value2>] ... ]
401 for (i = 0; i < size; i++)
403 Lisp_Object pair;
404 pair = XVECTOR (pairs)->contents [i];
405 XVECTOR (pair)->contents [1]
406 = x_get_local_selection (XVECTOR (pair)->contents [0],
407 XVECTOR (pair)->contents [1]);
409 return pairs;
411 #endif
412 else
414 /* Don't allow a quit within the converter.
415 When the user types C-g, he would be surprised
416 if by luck it came during a converter. */
417 count = SPECPDL_INDEX ();
418 specbind (Qinhibit_quit, Qt);
420 CHECK_SYMBOL (target_type);
421 handler_fn = Fcdr (Fassq (target_type, Vselection_converter_alist));
422 if (!NILP (handler_fn))
423 value = call3 (handler_fn,
424 selection_symbol, target_type,
425 XCAR (XCDR (local_value)));
426 else
427 value = Qnil;
428 unbind_to (count, Qnil);
431 /* Make sure this value is of a type that we could transmit
432 to another X client. */
434 check = value;
435 if (CONSP (value)
436 && SYMBOLP (XCAR (value)))
437 type = XCAR (value),
438 check = XCDR (value);
440 if (STRINGP (check)
441 || VECTORP (check)
442 || SYMBOLP (check)
443 || INTEGERP (check)
444 || NILP (value))
445 return value;
446 /* Check for a value that cons_to_long could handle. */
447 else if (CONSP (check)
448 && INTEGERP (XCAR (check))
449 && (INTEGERP (XCDR (check))
451 (CONSP (XCDR (check))
452 && INTEGERP (XCAR (XCDR (check)))
453 && NILP (XCDR (XCDR (check))))))
454 return value;
455 else
456 return
457 Fsignal (Qerror,
458 Fcons (build_string ("invalid data returned by selection-conversion function"),
459 Fcons (handler_fn, Fcons (value, Qnil))));
462 /* Subroutines of x_reply_selection_request. */
464 /* Send a SelectionNotify event to the requestor with property=None,
465 meaning we were unable to do what they wanted. */
467 static void
468 x_decline_selection_request (event)
469 struct input_event *event;
471 XSelectionEvent reply;
472 int count;
474 reply.type = SelectionNotify;
475 reply.display = SELECTION_EVENT_DISPLAY (event);
476 reply.requestor = SELECTION_EVENT_REQUESTOR (event);
477 reply.selection = SELECTION_EVENT_SELECTION (event);
478 reply.time = SELECTION_EVENT_TIME (event);
479 reply.target = SELECTION_EVENT_TARGET (event);
480 reply.property = None;
482 /* The reason for the error may be that the receiver has
483 died in the meantime. Handle that case. */
484 BLOCK_INPUT;
485 count = x_catch_errors (reply.display);
486 XSendEvent (reply.display, reply.requestor, False, 0L, (XEvent *) &reply);
487 XFlush (reply.display);
488 x_uncatch_errors (reply.display, count);
489 UNBLOCK_INPUT;
492 /* This is the selection request currently being processed.
493 It is set to zero when the request is fully processed. */
494 static struct input_event *x_selection_current_request;
496 /* Display info in x_selection_request. */
498 static struct x_display_info *selection_request_dpyinfo;
500 /* Used as an unwind-protect clause so that, if a selection-converter signals
501 an error, we tell the requester that we were unable to do what they wanted
502 before we throw to top-level or go into the debugger or whatever. */
504 static Lisp_Object
505 x_selection_request_lisp_error (ignore)
506 Lisp_Object ignore;
508 if (x_selection_current_request != 0
509 && selection_request_dpyinfo->display)
510 x_decline_selection_request (x_selection_current_request);
511 return Qnil;
515 /* This stuff is so that INCR selections are reentrant (that is, so we can
516 be servicing multiple INCR selection requests simultaneously.) I haven't
517 actually tested that yet. */
519 /* Keep a list of the property changes that are awaited. */
521 struct prop_location
523 int identifier;
524 Display *display;
525 Window window;
526 Atom property;
527 int desired_state;
528 int arrived;
529 struct prop_location *next;
532 static struct prop_location *expect_property_change ();
533 static void wait_for_property_change ();
534 static void unexpect_property_change ();
535 static int waiting_for_other_props_on_window ();
537 static int prop_location_identifier;
539 static Lisp_Object property_change_reply;
541 static struct prop_location *property_change_reply_object;
543 static struct prop_location *property_change_wait_list;
545 static Lisp_Object
546 queue_selection_requests_unwind (frame)
547 Lisp_Object frame;
549 FRAME_PTR f = XFRAME (frame);
551 if (! NILP (frame))
552 x_stop_queuing_selection_requests (FRAME_X_DISPLAY (f));
553 return Qnil;
556 /* Return some frame whose display info is DPYINFO.
557 Return nil if there is none. */
559 static Lisp_Object
560 some_frame_on_display (dpyinfo)
561 struct x_display_info *dpyinfo;
563 Lisp_Object list, frame;
565 FOR_EACH_FRAME (list, frame)
567 if (FRAME_X_DISPLAY_INFO (XFRAME (frame)) == dpyinfo)
568 return frame;
571 return Qnil;
574 /* Send the reply to a selection request event EVENT.
575 TYPE is the type of selection data requested.
576 DATA and SIZE describe the data to send, already converted.
577 FORMAT is the unit-size (in bits) of the data to be transmitted. */
579 static void
580 x_reply_selection_request (event, format, data, size, type)
581 struct input_event *event;
582 int format, size;
583 unsigned char *data;
584 Atom type;
586 XSelectionEvent reply;
587 Display *display = SELECTION_EVENT_DISPLAY (event);
588 Window window = SELECTION_EVENT_REQUESTOR (event);
589 int bytes_remaining;
590 int format_bytes = format/8;
591 int max_bytes = SELECTION_QUANTUM (display);
592 struct x_display_info *dpyinfo = x_display_info_for_display (display);
593 int count;
595 if (max_bytes > MAX_SELECTION_QUANTUM)
596 max_bytes = MAX_SELECTION_QUANTUM;
598 reply.type = SelectionNotify;
599 reply.display = display;
600 reply.requestor = window;
601 reply.selection = SELECTION_EVENT_SELECTION (event);
602 reply.time = SELECTION_EVENT_TIME (event);
603 reply.target = SELECTION_EVENT_TARGET (event);
604 reply.property = SELECTION_EVENT_PROPERTY (event);
605 if (reply.property == None)
606 reply.property = reply.target;
608 /* #### XChangeProperty can generate BadAlloc, and we must handle it! */
609 BLOCK_INPUT;
610 count = x_catch_errors (display);
612 /* Store the data on the requested property.
613 If the selection is large, only store the first N bytes of it.
615 bytes_remaining = size * format_bytes;
616 if (bytes_remaining <= max_bytes)
618 /* Send all the data at once, with minimal handshaking. */
619 TRACE1 ("Sending all %d bytes", bytes_remaining);
620 XChangeProperty (display, window, reply.property, type, format,
621 PropModeReplace, data, size);
622 /* At this point, the selection was successfully stored; ack it. */
623 XSendEvent (display, window, False, 0L, (XEvent *) &reply);
625 else
627 /* Send an INCR selection. */
628 struct prop_location *wait_object;
629 int had_errors;
630 Lisp_Object frame;
632 frame = some_frame_on_display (dpyinfo);
634 /* If the display no longer has frames, we can't expect
635 to get many more selection requests from it, so don't
636 bother trying to queue them. */
637 if (!NILP (frame))
639 x_start_queuing_selection_requests (display);
641 record_unwind_protect (queue_selection_requests_unwind,
642 frame);
645 if (x_window_to_frame (dpyinfo, window)) /* #### debug */
646 error ("Attempt to transfer an INCR to ourself!");
648 TRACE2 ("Start sending %d bytes incrementally (%s)",
649 bytes_remaining, XGetAtomName (display, reply.property));
650 wait_object = expect_property_change (display, window, reply.property,
651 PropertyDelete);
653 TRACE1 ("Set %s to number of bytes to send",
654 XGetAtomName (display, reply.property));
655 XChangeProperty (display, window, reply.property, dpyinfo->Xatom_INCR,
656 32, PropModeReplace,
657 (unsigned char *) &bytes_remaining, 1);
658 XSelectInput (display, window, PropertyChangeMask);
660 /* Tell 'em the INCR data is there... */
661 TRACE0 ("Send SelectionNotify event");
662 XSendEvent (display, window, False, 0L, (XEvent *) &reply);
663 XFlush (display);
665 had_errors = x_had_errors_p (display);
666 UNBLOCK_INPUT;
668 /* First, wait for the requester to ack by deleting the property.
669 This can run random lisp code (process handlers) or signal. */
670 if (! had_errors)
672 TRACE1 ("Waiting for ACK (deletion of %s)",
673 XGetAtomName (display, reply.property));
674 wait_for_property_change (wait_object);
677 TRACE0 ("Got ACK");
678 while (bytes_remaining)
680 int i = ((bytes_remaining < max_bytes)
681 ? bytes_remaining
682 : max_bytes);
684 BLOCK_INPUT;
686 wait_object
687 = expect_property_change (display, window, reply.property,
688 PropertyDelete);
690 TRACE1 ("Sending increment of %d bytes", i);
691 TRACE1 ("Set %s to increment data",
692 XGetAtomName (display, reply.property));
694 /* Append the next chunk of data to the property. */
695 XChangeProperty (display, window, reply.property, type, format,
696 PropModeAppend, data, i / format_bytes);
697 bytes_remaining -= i;
698 data += i;
699 XFlush (display);
700 had_errors = x_had_errors_p (display);
701 UNBLOCK_INPUT;
703 if (had_errors)
704 break;
706 /* Now wait for the requester to ack this chunk by deleting the
707 property. This can run random lisp code or signal. */
708 TRACE1 ("Waiting for increment ACK (deletion of %s)",
709 XGetAtomName (display, reply.property));
710 wait_for_property_change (wait_object);
713 /* Now write a zero-length chunk to the property to tell the
714 requester that we're done. */
715 BLOCK_INPUT;
716 if (! waiting_for_other_props_on_window (display, window))
717 XSelectInput (display, window, 0L);
719 TRACE1 ("Set %s to a 0-length chunk to indicate EOF",
720 XGetAtomName (display, reply.property));
721 XChangeProperty (display, window, reply.property, type, format,
722 PropModeReplace, data, 0);
723 TRACE0 ("Done sending incrementally");
726 /* The window we're communicating with may have been deleted
727 in the meantime (that's a real situation from a bug report).
728 In this case, there may be events in the event queue still
729 refering to the deleted window, and we'll get a BadWindow error
730 in XTread_socket when processing the events. I don't have
731 an idea how to fix that. gerd, 2001-01-98. */
732 XFlush (display);
733 x_uncatch_errors (display, count);
734 UNBLOCK_INPUT;
737 /* Handle a SelectionRequest event EVENT.
738 This is called from keyboard.c when such an event is found in the queue. */
740 void
741 x_handle_selection_request (event)
742 struct input_event *event;
744 struct gcpro gcpro1, gcpro2, gcpro3;
745 Lisp_Object local_selection_data;
746 Lisp_Object selection_symbol;
747 Lisp_Object target_symbol;
748 Lisp_Object converted_selection;
749 Time local_selection_time;
750 Lisp_Object successful_p;
751 int count;
752 struct x_display_info *dpyinfo
753 = x_display_info_for_display (SELECTION_EVENT_DISPLAY (event));
755 local_selection_data = Qnil;
756 target_symbol = Qnil;
757 converted_selection = Qnil;
758 successful_p = Qnil;
760 GCPRO3 (local_selection_data, converted_selection, target_symbol);
762 selection_symbol = x_atom_to_symbol (SELECTION_EVENT_DISPLAY (event),
763 SELECTION_EVENT_SELECTION (event));
765 local_selection_data = assq_no_quit (selection_symbol, Vselection_alist);
767 if (NILP (local_selection_data))
769 /* Someone asked for the selection, but we don't have it any more.
771 x_decline_selection_request (event);
772 goto DONE;
775 local_selection_time = (Time)
776 cons_to_long (XCAR (XCDR (XCDR (local_selection_data))));
778 if (SELECTION_EVENT_TIME (event) != CurrentTime
779 && local_selection_time > SELECTION_EVENT_TIME (event))
781 /* Someone asked for the selection, and we have one, but not the one
782 they're looking for.
784 x_decline_selection_request (event);
785 goto DONE;
788 x_selection_current_request = event;
789 count = SPECPDL_INDEX ();
790 selection_request_dpyinfo = dpyinfo;
791 record_unwind_protect (x_selection_request_lisp_error, Qnil);
793 target_symbol = x_atom_to_symbol (SELECTION_EVENT_DISPLAY (event),
794 SELECTION_EVENT_TARGET (event));
796 #if 0 /* #### MULTIPLE doesn't work yet */
797 if (EQ (target_symbol, QMULTIPLE))
798 target_symbol = fetch_multiple_target (event);
799 #endif
801 /* Convert lisp objects back into binary data */
803 converted_selection
804 = x_get_local_selection (selection_symbol, target_symbol);
806 if (! NILP (converted_selection))
808 unsigned char *data;
809 unsigned int size;
810 int format;
811 Atom type;
812 int nofree;
814 lisp_data_to_selection_data (SELECTION_EVENT_DISPLAY (event),
815 converted_selection,
816 &data, &type, &size, &format, &nofree);
818 x_reply_selection_request (event, format, data, size, type);
819 successful_p = Qt;
821 /* Indicate we have successfully processed this event. */
822 x_selection_current_request = 0;
824 /* Use xfree, not XFree, because lisp_data_to_selection_data
825 calls xmalloc itself. */
826 if (!nofree)
827 xfree (data);
829 unbind_to (count, Qnil);
831 DONE:
833 UNGCPRO;
835 /* Let random lisp code notice that the selection has been asked for. */
837 Lisp_Object rest;
838 rest = Vx_sent_selection_hooks;
839 if (!EQ (rest, Qunbound))
840 for (; CONSP (rest); rest = Fcdr (rest))
841 call3 (Fcar (rest), selection_symbol, target_symbol, successful_p);
845 /* Handle a SelectionClear event EVENT, which indicates that some
846 client cleared out our previously asserted selection.
847 This is called from keyboard.c when such an event is found in the queue. */
849 void
850 x_handle_selection_clear (event)
851 struct input_event *event;
853 Display *display = SELECTION_EVENT_DISPLAY (event);
854 Atom selection = SELECTION_EVENT_SELECTION (event);
855 Time changed_owner_time = SELECTION_EVENT_TIME (event);
857 Lisp_Object selection_symbol, local_selection_data;
858 Time local_selection_time;
859 struct x_display_info *dpyinfo = x_display_info_for_display (display);
860 struct x_display_info *t_dpyinfo;
862 /* If the new selection owner is also Emacs,
863 don't clear the new selection. */
864 BLOCK_INPUT;
865 /* Check each display on the same terminal,
866 to see if this Emacs job now owns the selection
867 through that display. */
868 for (t_dpyinfo = x_display_list; t_dpyinfo; t_dpyinfo = t_dpyinfo->next)
869 if (t_dpyinfo->kboard == dpyinfo->kboard)
871 Window owner_window
872 = XGetSelectionOwner (t_dpyinfo->display, selection);
873 if (x_window_to_frame (t_dpyinfo, owner_window) != 0)
875 UNBLOCK_INPUT;
876 return;
879 UNBLOCK_INPUT;
881 selection_symbol = x_atom_to_symbol (display, selection);
883 local_selection_data = assq_no_quit (selection_symbol, Vselection_alist);
885 /* Well, we already believe that we don't own it, so that's just fine. */
886 if (NILP (local_selection_data)) return;
888 local_selection_time = (Time)
889 cons_to_long (XCAR (XCDR (XCDR (local_selection_data))));
891 /* This SelectionClear is for a selection that we no longer own, so we can
892 disregard it. (That is, we have reasserted the selection since this
893 request was generated.) */
895 if (changed_owner_time != CurrentTime
896 && local_selection_time > changed_owner_time)
897 return;
899 /* Otherwise, we're really honest and truly being told to drop it.
900 Don't use Fdelq as that may QUIT;. */
902 if (EQ (local_selection_data, Fcar (Vselection_alist)))
903 Vselection_alist = Fcdr (Vselection_alist);
904 else
906 Lisp_Object rest;
907 for (rest = Vselection_alist; !NILP (rest); rest = Fcdr (rest))
908 if (EQ (local_selection_data, Fcar (XCDR (rest))))
910 XSETCDR (rest, Fcdr (XCDR (rest)));
911 break;
915 /* Let random lisp code notice that the selection has been stolen. */
918 Lisp_Object rest;
919 rest = Vx_lost_selection_hooks;
920 if (!EQ (rest, Qunbound))
922 for (; CONSP (rest); rest = Fcdr (rest))
923 call1 (Fcar (rest), selection_symbol);
924 prepare_menu_bars ();
925 redisplay_preserve_echo_area (20);
930 /* Clear all selections that were made from frame F.
931 We do this when about to delete a frame. */
933 void
934 x_clear_frame_selections (f)
935 FRAME_PTR f;
937 Lisp_Object frame;
938 Lisp_Object rest;
940 XSETFRAME (frame, f);
942 /* Otherwise, we're really honest and truly being told to drop it.
943 Don't use Fdelq as that may QUIT;. */
945 /* Delete elements from the beginning of Vselection_alist. */
946 while (!NILP (Vselection_alist)
947 && EQ (frame, Fcar (Fcdr (Fcdr (Fcdr (Fcar (Vselection_alist)))))))
949 /* Let random Lisp code notice that the selection has been stolen. */
950 Lisp_Object hooks, selection_symbol;
952 hooks = Vx_lost_selection_hooks;
953 selection_symbol = Fcar (Fcar (Vselection_alist));
955 if (!EQ (hooks, Qunbound))
957 for (; CONSP (hooks); hooks = Fcdr (hooks))
958 call1 (Fcar (hooks), selection_symbol);
959 #if 0 /* This can crash when deleting a frame
960 from x_connection_closed. Anyway, it seems unnecessary;
961 something else should cause a redisplay. */
962 redisplay_preserve_echo_area (21);
963 #endif
966 Vselection_alist = Fcdr (Vselection_alist);
969 /* Delete elements after the beginning of Vselection_alist. */
970 for (rest = Vselection_alist; !NILP (rest); rest = Fcdr (rest))
971 if (EQ (frame, Fcar (Fcdr (Fcdr (Fcdr (Fcar (XCDR (rest))))))))
973 /* Let random Lisp code notice that the selection has been stolen. */
974 Lisp_Object hooks, selection_symbol;
976 hooks = Vx_lost_selection_hooks;
977 selection_symbol = Fcar (Fcar (XCDR (rest)));
979 if (!EQ (hooks, Qunbound))
981 for (; CONSP (hooks); hooks = Fcdr (hooks))
982 call1 (Fcar (hooks), selection_symbol);
983 #if 0 /* See above */
984 redisplay_preserve_echo_area (22);
985 #endif
987 XSETCDR (rest, Fcdr (XCDR (rest)));
988 break;
992 /* Nonzero if any properties for DISPLAY and WINDOW
993 are on the list of what we are waiting for. */
995 static int
996 waiting_for_other_props_on_window (display, window)
997 Display *display;
998 Window window;
1000 struct prop_location *rest = property_change_wait_list;
1001 while (rest)
1002 if (rest->display == display && rest->window == window)
1003 return 1;
1004 else
1005 rest = rest->next;
1006 return 0;
1009 /* Add an entry to the list of property changes we are waiting for.
1010 DISPLAY, WINDOW, PROPERTY, STATE describe what we will wait for.
1011 The return value is a number that uniquely identifies
1012 this awaited property change. */
1014 static struct prop_location *
1015 expect_property_change (display, window, property, state)
1016 Display *display;
1017 Window window;
1018 Atom property;
1019 int state;
1021 struct prop_location *pl = (struct prop_location *) xmalloc (sizeof *pl);
1022 pl->identifier = ++prop_location_identifier;
1023 pl->display = display;
1024 pl->window = window;
1025 pl->property = property;
1026 pl->desired_state = state;
1027 pl->next = property_change_wait_list;
1028 pl->arrived = 0;
1029 property_change_wait_list = pl;
1030 return pl;
1033 /* Delete an entry from the list of property changes we are waiting for.
1034 IDENTIFIER is the number that uniquely identifies the entry. */
1036 static void
1037 unexpect_property_change (location)
1038 struct prop_location *location;
1040 struct prop_location *prev = 0, *rest = property_change_wait_list;
1041 while (rest)
1043 if (rest == location)
1045 if (prev)
1046 prev->next = rest->next;
1047 else
1048 property_change_wait_list = rest->next;
1049 xfree (rest);
1050 return;
1052 prev = rest;
1053 rest = rest->next;
1057 /* Remove the property change expectation element for IDENTIFIER. */
1059 static Lisp_Object
1060 wait_for_property_change_unwind (identifierval)
1061 Lisp_Object identifierval;
1063 unexpect_property_change ((struct prop_location *)
1064 (XFASTINT (XCAR (identifierval)) << 16
1065 | XFASTINT (XCDR (identifierval))));
1066 return Qnil;
1069 /* Actually wait for a property change.
1070 IDENTIFIER should be the value that expect_property_change returned. */
1072 static void
1073 wait_for_property_change (location)
1074 struct prop_location *location;
1076 int secs, usecs;
1077 int count = SPECPDL_INDEX ();
1078 Lisp_Object tem;
1080 tem = Fcons (Qnil, Qnil);
1081 XSETCARFASTINT (tem, (EMACS_UINT)location >> 16);
1082 XSETCDRFASTINT (tem, (EMACS_UINT)location & 0xffff);
1084 /* Make sure to do unexpect_property_change if we quit or err. */
1085 record_unwind_protect (wait_for_property_change_unwind, tem);
1087 XSETCAR (property_change_reply, Qnil);
1089 property_change_reply_object = location;
1090 /* If the event we are waiting for arrives beyond here, it will set
1091 property_change_reply, because property_change_reply_object says so. */
1092 if (! location->arrived)
1094 secs = x_selection_timeout / 1000;
1095 usecs = (x_selection_timeout % 1000) * 1000;
1096 TRACE2 (" Waiting %d secs, %d usecs", secs, usecs);
1097 wait_reading_process_input (secs, usecs, property_change_reply, 0);
1099 if (NILP (XCAR (property_change_reply)))
1101 TRACE0 (" Timed out");
1102 error ("Timed out waiting for property-notify event");
1106 unbind_to (count, Qnil);
1109 /* Called from XTread_socket in response to a PropertyNotify event. */
1111 void
1112 x_handle_property_notify (event)
1113 XPropertyEvent *event;
1115 struct prop_location *prev = 0, *rest = property_change_wait_list;
1117 while (rest)
1119 if (rest->property == event->atom
1120 && rest->window == event->window
1121 && rest->display == event->display
1122 && rest->desired_state == event->state)
1124 TRACE2 ("Expected %s of property %s",
1125 (event->state == PropertyDelete ? "deletion" : "change"),
1126 XGetAtomName (event->display, event->atom));
1128 rest->arrived = 1;
1130 /* If this is the one wait_for_property_change is waiting for,
1131 tell it to wake up. */
1132 if (rest == property_change_reply_object)
1133 XSETCAR (property_change_reply, Qt);
1135 if (prev)
1136 prev->next = rest->next;
1137 else
1138 property_change_wait_list = rest->next;
1139 xfree (rest);
1140 return;
1143 prev = rest;
1144 rest = rest->next;
1150 #if 0 /* #### MULTIPLE doesn't work yet */
1152 static Lisp_Object
1153 fetch_multiple_target (event)
1154 XSelectionRequestEvent *event;
1156 Display *display = event->display;
1157 Window window = event->requestor;
1158 Atom target = event->target;
1159 Atom selection_atom = event->selection;
1160 int result;
1162 return
1163 Fcons (QMULTIPLE,
1164 x_get_window_property_as_lisp_data (display, window, target,
1165 QMULTIPLE, selection_atom));
1168 static Lisp_Object
1169 copy_multiple_data (obj)
1170 Lisp_Object obj;
1172 Lisp_Object vec;
1173 int i;
1174 int size;
1175 if (CONSP (obj))
1176 return Fcons (XCAR (obj), copy_multiple_data (XCDR (obj)));
1178 CHECK_VECTOR (obj);
1179 vec = Fmake_vector (size = XVECTOR (obj)->size, Qnil);
1180 for (i = 0; i < size; i++)
1182 Lisp_Object vec2 = XVECTOR (obj)->contents [i];
1183 CHECK_VECTOR (vec2);
1184 if (XVECTOR (vec2)->size != 2)
1185 /* ??? Confusing error message */
1186 Fsignal (Qerror, Fcons (build_string ("vectors must be of length 2"),
1187 Fcons (vec2, Qnil)));
1188 XVECTOR (vec)->contents [i] = Fmake_vector (2, Qnil);
1189 XVECTOR (XVECTOR (vec)->contents [i])->contents [0]
1190 = XVECTOR (vec2)->contents [0];
1191 XVECTOR (XVECTOR (vec)->contents [i])->contents [1]
1192 = XVECTOR (vec2)->contents [1];
1194 return vec;
1197 #endif
1200 /* Variables for communication with x_handle_selection_notify. */
1201 static Atom reading_which_selection;
1202 static Lisp_Object reading_selection_reply;
1203 static Window reading_selection_window;
1205 /* Do protocol to read selection-data from the server.
1206 Converts this to Lisp data and returns it. */
1208 static Lisp_Object
1209 x_get_foreign_selection (selection_symbol, target_type)
1210 Lisp_Object selection_symbol, target_type;
1212 struct frame *sf = SELECTED_FRAME ();
1213 Window requestor_window = FRAME_X_WINDOW (sf);
1214 Display *display = FRAME_X_DISPLAY (sf);
1215 struct x_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (sf);
1216 Time requestor_time = last_event_timestamp;
1217 Atom target_property = dpyinfo->Xatom_EMACS_TMP;
1218 Atom selection_atom = symbol_to_x_atom (dpyinfo, display, selection_symbol);
1219 Atom type_atom;
1220 int secs, usecs;
1221 int count;
1222 Lisp_Object frame;
1224 if (CONSP (target_type))
1225 type_atom = symbol_to_x_atom (dpyinfo, display, XCAR (target_type));
1226 else
1227 type_atom = symbol_to_x_atom (dpyinfo, display, target_type);
1229 BLOCK_INPUT;
1231 count = x_catch_errors (display);
1233 TRACE2 ("Get selection %s, type %s",
1234 XGetAtomName (display, type_atom),
1235 XGetAtomName (display, target_property));
1237 XConvertSelection (display, selection_atom, type_atom, target_property,
1238 requestor_window, requestor_time);
1239 XFlush (display);
1241 /* Prepare to block until the reply has been read. */
1242 reading_selection_window = requestor_window;
1243 reading_which_selection = selection_atom;
1244 XSETCAR (reading_selection_reply, Qnil);
1246 frame = some_frame_on_display (dpyinfo);
1248 /* If the display no longer has frames, we can't expect
1249 to get many more selection requests from it, so don't
1250 bother trying to queue them. */
1251 if (!NILP (frame))
1253 x_start_queuing_selection_requests (display);
1255 record_unwind_protect (queue_selection_requests_unwind,
1256 frame);
1258 UNBLOCK_INPUT;
1260 /* This allows quits. Also, don't wait forever. */
1261 secs = x_selection_timeout / 1000;
1262 usecs = (x_selection_timeout % 1000) * 1000;
1263 TRACE1 (" Start waiting %d secs for SelectionNotify", secs);
1264 wait_reading_process_input (secs, usecs, reading_selection_reply, 0);
1265 TRACE1 (" Got event = %d", !NILP (XCAR (reading_selection_reply)));
1267 BLOCK_INPUT;
1268 x_check_errors (display, "Cannot get selection: %s");
1269 x_uncatch_errors (display, count);
1270 UNBLOCK_INPUT;
1272 if (NILP (XCAR (reading_selection_reply)))
1273 error ("Timed out waiting for reply from selection owner");
1274 if (EQ (XCAR (reading_selection_reply), Qlambda))
1275 error ("No `%s' selection", SDATA (SYMBOL_NAME (selection_symbol)));
1277 /* Otherwise, the selection is waiting for us on the requested property. */
1278 return
1279 x_get_window_property_as_lisp_data (display, requestor_window,
1280 target_property, target_type,
1281 selection_atom);
1284 /* Subroutines of x_get_window_property_as_lisp_data */
1286 /* Use xfree, not XFree, to free the data obtained with this function. */
1288 static void
1289 x_get_window_property (display, window, property, data_ret, bytes_ret,
1290 actual_type_ret, actual_format_ret, actual_size_ret,
1291 delete_p)
1292 Display *display;
1293 Window window;
1294 Atom property;
1295 unsigned char **data_ret;
1296 int *bytes_ret;
1297 Atom *actual_type_ret;
1298 int *actual_format_ret;
1299 unsigned long *actual_size_ret;
1300 int delete_p;
1302 int total_size;
1303 unsigned long bytes_remaining;
1304 int offset = 0;
1305 unsigned char *tmp_data = 0;
1306 int result;
1307 int buffer_size = SELECTION_QUANTUM (display);
1309 if (buffer_size > MAX_SELECTION_QUANTUM)
1310 buffer_size = MAX_SELECTION_QUANTUM;
1312 BLOCK_INPUT;
1314 /* First probe the thing to find out how big it is. */
1315 result = XGetWindowProperty (display, window, property,
1316 0L, 0L, False, AnyPropertyType,
1317 actual_type_ret, actual_format_ret,
1318 actual_size_ret,
1319 &bytes_remaining, &tmp_data);
1320 if (result != Success)
1322 UNBLOCK_INPUT;
1323 *data_ret = 0;
1324 *bytes_ret = 0;
1325 return;
1328 /* This was allocated by Xlib, so use XFree. */
1329 XFree ((char *) tmp_data);
1331 if (*actual_type_ret == None || *actual_format_ret == 0)
1333 UNBLOCK_INPUT;
1334 return;
1337 total_size = bytes_remaining + 1;
1338 *data_ret = (unsigned char *) xmalloc (total_size);
1340 /* Now read, until we've gotten it all. */
1341 while (bytes_remaining)
1343 #ifdef TRACE_SELECTION
1344 int last = bytes_remaining;
1345 #endif
1346 result
1347 = XGetWindowProperty (display, window, property,
1348 (long)offset/4, (long)buffer_size/4,
1349 False,
1350 AnyPropertyType,
1351 actual_type_ret, actual_format_ret,
1352 actual_size_ret, &bytes_remaining, &tmp_data);
1354 TRACE2 ("Read %ld bytes from property %s",
1355 last - bytes_remaining,
1356 XGetAtomName (display, property));
1358 /* If this doesn't return Success at this point, it means that
1359 some clod deleted the selection while we were in the midst of
1360 reading it. Deal with that, I guess.... */
1361 if (result != Success)
1362 break;
1363 *actual_size_ret *= *actual_format_ret / 8;
1364 bcopy (tmp_data, (*data_ret) + offset, *actual_size_ret);
1365 offset += *actual_size_ret;
1367 /* This was allocated by Xlib, so use XFree. */
1368 XFree ((char *) tmp_data);
1371 XFlush (display);
1372 UNBLOCK_INPUT;
1373 *bytes_ret = offset;
1376 /* Use xfree, not XFree, to free the data obtained with this function. */
1378 static void
1379 receive_incremental_selection (display, window, property, target_type,
1380 min_size_bytes, data_ret, size_bytes_ret,
1381 type_ret, format_ret, size_ret)
1382 Display *display;
1383 Window window;
1384 Atom property;
1385 Lisp_Object target_type; /* for error messages only */
1386 unsigned int min_size_bytes;
1387 unsigned char **data_ret;
1388 int *size_bytes_ret;
1389 Atom *type_ret;
1390 unsigned long *size_ret;
1391 int *format_ret;
1393 int offset = 0;
1394 struct prop_location *wait_object;
1395 *size_bytes_ret = min_size_bytes;
1396 *data_ret = (unsigned char *) xmalloc (*size_bytes_ret);
1398 TRACE1 ("Read %d bytes incrementally", min_size_bytes);
1400 /* At this point, we have read an INCR property.
1401 Delete the property to ack it.
1402 (But first, prepare to receive the next event in this handshake.)
1404 Now, we must loop, waiting for the sending window to put a value on
1405 that property, then reading the property, then deleting it to ack.
1406 We are done when the sender places a property of length 0.
1408 BLOCK_INPUT;
1409 XSelectInput (display, window, STANDARD_EVENT_SET | PropertyChangeMask);
1410 TRACE1 (" Delete property %s",
1411 XSYMBOL (x_atom_to_symbol (display, property))->name->data);
1412 XDeleteProperty (display, window, property);
1413 TRACE1 (" Expect new value of property %s",
1414 XSYMBOL (x_atom_to_symbol (display, property))->name->data);
1415 wait_object = expect_property_change (display, window, property,
1416 PropertyNewValue);
1417 XFlush (display);
1418 UNBLOCK_INPUT;
1420 while (1)
1422 unsigned char *tmp_data;
1423 int tmp_size_bytes;
1425 TRACE0 (" Wait for property change");
1426 wait_for_property_change (wait_object);
1428 /* expect it again immediately, because x_get_window_property may
1429 .. no it won't, I don't get it.
1430 .. Ok, I get it now, the Xt code that implements INCR is broken. */
1431 TRACE0 (" Get property value");
1432 x_get_window_property (display, window, property,
1433 &tmp_data, &tmp_size_bytes,
1434 type_ret, format_ret, size_ret, 1);
1436 TRACE1 (" Read increment of %d bytes", tmp_size_bytes);
1438 if (tmp_size_bytes == 0) /* we're done */
1440 TRACE0 ("Done reading incrementally");
1442 if (! waiting_for_other_props_on_window (display, window))
1443 XSelectInput (display, window, STANDARD_EVENT_SET);
1444 unexpect_property_change (wait_object);
1445 /* Use xfree, not XFree, because x_get_window_property
1446 calls xmalloc itself. */
1447 if (tmp_data) xfree (tmp_data);
1448 break;
1451 BLOCK_INPUT;
1452 TRACE1 (" ACK by deleting property %s",
1453 XGetAtomName (display, property));
1454 XDeleteProperty (display, window, property);
1455 wait_object = expect_property_change (display, window, property,
1456 PropertyNewValue);
1457 XFlush (display);
1458 UNBLOCK_INPUT;
1460 if (*size_bytes_ret < offset + tmp_size_bytes)
1462 *size_bytes_ret = offset + tmp_size_bytes;
1463 *data_ret = (unsigned char *) xrealloc (*data_ret, *size_bytes_ret);
1466 bcopy (tmp_data, (*data_ret) + offset, tmp_size_bytes);
1467 offset += tmp_size_bytes;
1469 /* Use xfree, not XFree, because x_get_window_property
1470 calls xmalloc itself. */
1471 xfree (tmp_data);
1476 /* Once a requested selection is "ready" (we got a SelectionNotify event),
1477 fetch value from property PROPERTY of X window WINDOW on display DISPLAY.
1478 TARGET_TYPE and SELECTION_ATOM are used in error message if this fails. */
1480 static Lisp_Object
1481 x_get_window_property_as_lisp_data (display, window, property, target_type,
1482 selection_atom)
1483 Display *display;
1484 Window window;
1485 Atom property;
1486 Lisp_Object target_type; /* for error messages only */
1487 Atom selection_atom; /* for error messages only */
1489 Atom actual_type;
1490 int actual_format;
1491 unsigned long actual_size;
1492 unsigned char *data = 0;
1493 int bytes = 0;
1494 Lisp_Object val;
1495 struct x_display_info *dpyinfo = x_display_info_for_display (display);
1497 TRACE0 ("Reading selection data");
1499 x_get_window_property (display, window, property, &data, &bytes,
1500 &actual_type, &actual_format, &actual_size, 1);
1501 if (! data)
1503 int there_is_a_selection_owner;
1504 BLOCK_INPUT;
1505 there_is_a_selection_owner
1506 = XGetSelectionOwner (display, selection_atom);
1507 UNBLOCK_INPUT;
1508 Fsignal (Qerror,
1509 there_is_a_selection_owner
1510 ? Fcons (build_string ("selection owner couldn't convert"),
1511 actual_type
1512 ? Fcons (target_type,
1513 Fcons (x_atom_to_symbol (display,
1514 actual_type),
1515 Qnil))
1516 : Fcons (target_type, Qnil))
1517 : Fcons (build_string ("no selection"),
1518 Fcons (x_atom_to_symbol (display,
1519 selection_atom),
1520 Qnil)));
1523 if (actual_type == dpyinfo->Xatom_INCR)
1525 /* That wasn't really the data, just the beginning. */
1527 unsigned int min_size_bytes = * ((unsigned int *) data);
1528 BLOCK_INPUT;
1529 /* Use xfree, not XFree, because x_get_window_property
1530 calls xmalloc itself. */
1531 xfree ((char *) data);
1532 UNBLOCK_INPUT;
1533 receive_incremental_selection (display, window, property, target_type,
1534 min_size_bytes, &data, &bytes,
1535 &actual_type, &actual_format,
1536 &actual_size);
1539 BLOCK_INPUT;
1540 TRACE1 (" Delete property %s", XGetAtomName (display, property));
1541 XDeleteProperty (display, window, property);
1542 XFlush (display);
1543 UNBLOCK_INPUT;
1545 /* It's been read. Now convert it to a lisp object in some semi-rational
1546 manner. */
1547 val = selection_data_to_lisp_data (display, data, bytes,
1548 actual_type, actual_format);
1550 /* Use xfree, not XFree, because x_get_window_property
1551 calls xmalloc itself. */
1552 xfree ((char *) data);
1553 return val;
1556 /* These functions convert from the selection data read from the server into
1557 something that we can use from Lisp, and vice versa.
1559 Type: Format: Size: Lisp Type:
1560 ----- ------- ----- -----------
1561 * 8 * String
1562 ATOM 32 1 Symbol
1563 ATOM 32 > 1 Vector of Symbols
1564 * 16 1 Integer
1565 * 16 > 1 Vector of Integers
1566 * 32 1 if <=16 bits: Integer
1567 if > 16 bits: Cons of top16, bot16
1568 * 32 > 1 Vector of the above
1570 When converting a Lisp number to C, it is assumed to be of format 16 if
1571 it is an integer, and of format 32 if it is a cons of two integers.
1573 When converting a vector of numbers from Lisp to C, it is assumed to be
1574 of format 16 if every element in the vector is an integer, and is assumed
1575 to be of format 32 if any element is a cons of two integers.
1577 When converting an object to C, it may be of the form (SYMBOL . <data>)
1578 where SYMBOL is what we should claim that the type is. Format and
1579 representation are as above. */
1583 static Lisp_Object
1584 selection_data_to_lisp_data (display, data, size, type, format)
1585 Display *display;
1586 unsigned char *data;
1587 Atom type;
1588 int size, format;
1590 struct x_display_info *dpyinfo = x_display_info_for_display (display);
1592 if (type == dpyinfo->Xatom_NULL)
1593 return QNULL;
1595 /* Convert any 8-bit data to a string, for compactness. */
1596 else if (format == 8)
1598 Lisp_Object str;
1599 int require_encoding = 0;
1601 if (
1602 #if 1
1604 #else
1605 ! NILP (buffer_defaults.enable_multibyte_characters)
1606 #endif
1609 /* If TYPE is `TEXT' or `COMPOUND_TEXT', we should decode
1610 DATA to Emacs internal format because DATA may be encoded
1611 in compound text format. In addtion, if TYPE is `STRING'
1612 and DATA contains any 8-bit Latin-1 code, we should also
1613 decode it. */
1614 if (type == dpyinfo->Xatom_TEXT
1615 || type == dpyinfo->Xatom_COMPOUND_TEXT)
1616 require_encoding = 1;
1617 else if (type == XA_STRING)
1619 int i;
1620 for (i = 0; i < size; i++)
1622 if (data[i] >= 0x80)
1624 require_encoding = 1;
1625 break;
1630 if (!require_encoding)
1632 str = make_unibyte_string ((char *) data, size);
1633 Vlast_coding_system_used = Qraw_text;
1635 else
1637 int bufsize;
1638 unsigned char *buf;
1639 struct coding_system coding;
1641 if (NILP (Vnext_selection_coding_system))
1642 Vnext_selection_coding_system = Vselection_coding_system;
1643 setup_coding_system
1644 (Fcheck_coding_system(Vnext_selection_coding_system), &coding);
1645 coding.src_multibyte = 0;
1646 coding.dst_multibyte = 1;
1647 Vnext_selection_coding_system = Qnil;
1648 coding.mode |= CODING_MODE_LAST_BLOCK;
1649 /* We explicitely disable composition handling because
1650 selection data should not contain any composition
1651 sequence. */
1652 coding.composing = COMPOSITION_DISABLED;
1653 bufsize = decoding_buffer_size (&coding, size);
1654 buf = (unsigned char *) xmalloc (bufsize);
1655 decode_coding (&coding, data, buf, size, bufsize);
1656 str = make_string_from_bytes ((char *) buf,
1657 coding.produced_char, coding.produced);
1658 xfree (buf);
1660 if (SYMBOLP (coding.post_read_conversion)
1661 && !NILP (Ffboundp (coding.post_read_conversion)))
1662 str = run_pre_post_conversion_on_str (str, &coding, 0);
1663 Vlast_coding_system_used = coding.symbol;
1665 compose_chars_in_text (0, SCHARS (str), str);
1666 return str;
1668 /* Convert a single atom to a Lisp_Symbol. Convert a set of atoms to
1669 a vector of symbols.
1671 else if (type == XA_ATOM)
1673 int i;
1674 if (size == sizeof (Atom))
1675 return x_atom_to_symbol (display, *((Atom *) data));
1676 else
1678 Lisp_Object v = Fmake_vector (make_number (size / sizeof (Atom)),
1679 make_number (0));
1680 for (i = 0; i < size / sizeof (Atom); i++)
1681 Faset (v, make_number (i),
1682 x_atom_to_symbol (display, ((Atom *) data) [i]));
1683 return v;
1687 /* Convert a single 16 or small 32 bit number to a Lisp_Int.
1688 If the number is > 16 bits, convert it to a cons of integers,
1689 16 bits in each half.
1691 else if (format == 32 && size == sizeof (long))
1692 return long_to_cons (((unsigned long *) data) [0]);
1693 else if (format == 16 && size == sizeof (short))
1694 return make_number ((int) (((unsigned short *) data) [0]));
1696 /* Convert any other kind of data to a vector of numbers, represented
1697 as above (as an integer, or a cons of two 16 bit integers.)
1699 else if (format == 16)
1701 int i;
1702 Lisp_Object v;
1703 v = Fmake_vector (make_number (size / 2), make_number (0));
1704 for (i = 0; i < size / 2; i++)
1706 int j = (int) ((unsigned short *) data) [i];
1707 Faset (v, make_number (i), make_number (j));
1709 return v;
1711 else
1713 int i;
1714 Lisp_Object v = Fmake_vector (make_number (size / 4), make_number (0));
1715 for (i = 0; i < size / 4; i++)
1717 unsigned long j = ((unsigned long *) data) [i];
1718 Faset (v, make_number (i), long_to_cons (j));
1720 return v;
1725 /* Use xfree, not XFree, to free the data obtained with this function. */
1727 static void
1728 lisp_data_to_selection_data (display, obj,
1729 data_ret, type_ret, size_ret,
1730 format_ret, nofree_ret)
1731 Display *display;
1732 Lisp_Object obj;
1733 unsigned char **data_ret;
1734 Atom *type_ret;
1735 unsigned int *size_ret;
1736 int *format_ret;
1737 int *nofree_ret;
1739 Lisp_Object type = Qnil;
1740 struct x_display_info *dpyinfo = x_display_info_for_display (display);
1742 *nofree_ret = 0;
1744 if (CONSP (obj) && SYMBOLP (XCAR (obj)))
1746 type = XCAR (obj);
1747 obj = XCDR (obj);
1748 if (CONSP (obj) && NILP (XCDR (obj)))
1749 obj = XCAR (obj);
1752 if (EQ (obj, QNULL) || (EQ (type, QNULL)))
1753 { /* This is not the same as declining */
1754 *format_ret = 32;
1755 *size_ret = 0;
1756 *data_ret = 0;
1757 type = QNULL;
1759 else if (STRINGP (obj))
1761 /* Since we are now handling multilingual text, we must consider
1762 sending back compound text. */
1763 int stringp;
1764 extern Lisp_Object Qcompound_text;
1766 if (NILP (Vnext_selection_coding_system))
1767 Vnext_selection_coding_system = Vselection_coding_system;
1769 *format_ret = 8;
1770 /* If the requested type is STRING, we must encode the selected
1771 text as a string, even if the coding system set by the user
1772 is ctext or its derivatives. */
1773 if (EQ (type, QSTRING)
1774 && (EQ (Vnext_selection_coding_system, Qcompound_text)
1775 || EQ (Vnext_selection_coding_system,
1776 Qcompound_text_with_extensions)))
1778 Lisp_Object unibyte_string;
1780 unibyte_string = string_make_unibyte (obj);
1781 *data_ret = SDATA (unibyte_string);
1782 *nofree_ret = 1;
1783 *size_ret = SBYTES (unibyte_string);
1785 else
1787 *data_ret = x_encode_text (obj, Vnext_selection_coding_system, 1,
1788 (int *) size_ret, &stringp);
1789 *nofree_ret = (*data_ret == SDATA (obj));
1791 if (NILP (type))
1792 type = (stringp ? QSTRING : QCOMPOUND_TEXT);
1793 Vlast_coding_system_used = (*nofree_ret
1794 ? Qraw_text
1795 : Vnext_selection_coding_system);
1796 Vnext_selection_coding_system = Qnil;
1798 else if (SYMBOLP (obj))
1800 *format_ret = 32;
1801 *size_ret = 1;
1802 *data_ret = (unsigned char *) xmalloc (sizeof (Atom) + 1);
1803 (*data_ret) [sizeof (Atom)] = 0;
1804 (*(Atom **) data_ret) [0] = symbol_to_x_atom (dpyinfo, display, obj);
1805 if (NILP (type)) type = QATOM;
1807 else if (INTEGERP (obj)
1808 && XINT (obj) < 0xFFFF
1809 && XINT (obj) > -0xFFFF)
1811 *format_ret = 16;
1812 *size_ret = 1;
1813 *data_ret = (unsigned char *) xmalloc (sizeof (short) + 1);
1814 (*data_ret) [sizeof (short)] = 0;
1815 (*(short **) data_ret) [0] = (short) XINT (obj);
1816 if (NILP (type)) type = QINTEGER;
1818 else if (INTEGERP (obj)
1819 || (CONSP (obj) && INTEGERP (XCAR (obj))
1820 && (INTEGERP (XCDR (obj))
1821 || (CONSP (XCDR (obj))
1822 && INTEGERP (XCAR (XCDR (obj)))))))
1824 *format_ret = 32;
1825 *size_ret = 1;
1826 *data_ret = (unsigned char *) xmalloc (sizeof (long) + 1);
1827 (*data_ret) [sizeof (long)] = 0;
1828 (*(unsigned long **) data_ret) [0] = cons_to_long (obj);
1829 if (NILP (type)) type = QINTEGER;
1831 else if (VECTORP (obj))
1833 /* Lisp_Vectors may represent a set of ATOMs;
1834 a set of 16 or 32 bit INTEGERs;
1835 or a set of ATOM_PAIRs (represented as [[A1 A2] [A3 A4] ...]
1837 int i;
1839 if (SYMBOLP (XVECTOR (obj)->contents [0]))
1840 /* This vector is an ATOM set */
1842 if (NILP (type)) type = QATOM;
1843 *size_ret = XVECTOR (obj)->size;
1844 *format_ret = 32;
1845 *data_ret = (unsigned char *) xmalloc ((*size_ret) * sizeof (Atom));
1846 for (i = 0; i < *size_ret; i++)
1847 if (SYMBOLP (XVECTOR (obj)->contents [i]))
1848 (*(Atom **) data_ret) [i]
1849 = symbol_to_x_atom (dpyinfo, display, XVECTOR (obj)->contents [i]);
1850 else
1851 Fsignal (Qerror, /* Qselection_error */
1852 Fcons (build_string
1853 ("all elements of selection vector must have same type"),
1854 Fcons (obj, Qnil)));
1856 #if 0 /* #### MULTIPLE doesn't work yet */
1857 else if (VECTORP (XVECTOR (obj)->contents [0]))
1858 /* This vector is an ATOM_PAIR set */
1860 if (NILP (type)) type = QATOM_PAIR;
1861 *size_ret = XVECTOR (obj)->size;
1862 *format_ret = 32;
1863 *data_ret = (unsigned char *)
1864 xmalloc ((*size_ret) * sizeof (Atom) * 2);
1865 for (i = 0; i < *size_ret; i++)
1866 if (VECTORP (XVECTOR (obj)->contents [i]))
1868 Lisp_Object pair = XVECTOR (obj)->contents [i];
1869 if (XVECTOR (pair)->size != 2)
1870 Fsignal (Qerror,
1871 Fcons (build_string
1872 ("elements of the vector must be vectors of exactly two elements"),
1873 Fcons (pair, Qnil)));
1875 (*(Atom **) data_ret) [i * 2]
1876 = symbol_to_x_atom (dpyinfo, display,
1877 XVECTOR (pair)->contents [0]);
1878 (*(Atom **) data_ret) [(i * 2) + 1]
1879 = symbol_to_x_atom (dpyinfo, display,
1880 XVECTOR (pair)->contents [1]);
1882 else
1883 Fsignal (Qerror,
1884 Fcons (build_string
1885 ("all elements of the vector must be of the same type"),
1886 Fcons (obj, Qnil)));
1889 #endif
1890 else
1891 /* This vector is an INTEGER set, or something like it */
1893 *size_ret = XVECTOR (obj)->size;
1894 if (NILP (type)) type = QINTEGER;
1895 *format_ret = 16;
1896 for (i = 0; i < *size_ret; i++)
1897 if (CONSP (XVECTOR (obj)->contents [i]))
1898 *format_ret = 32;
1899 else if (!INTEGERP (XVECTOR (obj)->contents [i]))
1900 Fsignal (Qerror, /* Qselection_error */
1901 Fcons (build_string
1902 ("elements of selection vector must be integers or conses of integers"),
1903 Fcons (obj, Qnil)));
1905 *data_ret = (unsigned char *) xmalloc (*size_ret * (*format_ret/8));
1906 for (i = 0; i < *size_ret; i++)
1907 if (*format_ret == 32)
1908 (*((unsigned long **) data_ret)) [i]
1909 = cons_to_long (XVECTOR (obj)->contents [i]);
1910 else
1911 (*((unsigned short **) data_ret)) [i]
1912 = (unsigned short) cons_to_long (XVECTOR (obj)->contents [i]);
1915 else
1916 Fsignal (Qerror, /* Qselection_error */
1917 Fcons (build_string ("unrecognised selection data"),
1918 Fcons (obj, Qnil)));
1920 *type_ret = symbol_to_x_atom (dpyinfo, display, type);
1923 static Lisp_Object
1924 clean_local_selection_data (obj)
1925 Lisp_Object obj;
1927 if (CONSP (obj)
1928 && INTEGERP (XCAR (obj))
1929 && CONSP (XCDR (obj))
1930 && INTEGERP (XCAR (XCDR (obj)))
1931 && NILP (XCDR (XCDR (obj))))
1932 obj = Fcons (XCAR (obj), XCDR (obj));
1934 if (CONSP (obj)
1935 && INTEGERP (XCAR (obj))
1936 && INTEGERP (XCDR (obj)))
1938 if (XINT (XCAR (obj)) == 0)
1939 return XCDR (obj);
1940 if (XINT (XCAR (obj)) == -1)
1941 return make_number (- XINT (XCDR (obj)));
1943 if (VECTORP (obj))
1945 int i;
1946 int size = XVECTOR (obj)->size;
1947 Lisp_Object copy;
1948 if (size == 1)
1949 return clean_local_selection_data (XVECTOR (obj)->contents [0]);
1950 copy = Fmake_vector (make_number (size), Qnil);
1951 for (i = 0; i < size; i++)
1952 XVECTOR (copy)->contents [i]
1953 = clean_local_selection_data (XVECTOR (obj)->contents [i]);
1954 return copy;
1956 return obj;
1959 /* Called from XTread_socket to handle SelectionNotify events.
1960 If it's the selection we are waiting for, stop waiting
1961 by setting the car of reading_selection_reply to non-nil.
1962 We store t there if the reply is successful, lambda if not. */
1964 void
1965 x_handle_selection_notify (event)
1966 XSelectionEvent *event;
1968 if (event->requestor != reading_selection_window)
1969 return;
1970 if (event->selection != reading_which_selection)
1971 return;
1973 TRACE0 ("Received SelectionNotify");
1974 XSETCAR (reading_selection_reply,
1975 (event->property != 0 ? Qt : Qlambda));
1979 DEFUN ("x-own-selection-internal", Fx_own_selection_internal,
1980 Sx_own_selection_internal, 2, 2, 0,
1981 doc: /* Assert an X selection of the given TYPE with the given VALUE.
1982 TYPE is a symbol, typically `PRIMARY', `SECONDARY', or `CLIPBOARD'.
1983 \(Those are literal upper-case symbol names, since that's what X expects.)
1984 VALUE is typically a string, or a cons of two markers, but may be
1985 anything that the functions on `selection-converter-alist' know about. */)
1986 (selection_name, selection_value)
1987 Lisp_Object selection_name, selection_value;
1989 check_x ();
1990 CHECK_SYMBOL (selection_name);
1991 if (NILP (selection_value)) error ("selection-value may not be nil");
1992 x_own_selection (selection_name, selection_value);
1993 return selection_value;
1997 /* Request the selection value from the owner. If we are the owner,
1998 simply return our selection value. If we are not the owner, this
1999 will block until all of the data has arrived. */
2001 DEFUN ("x-get-selection-internal", Fx_get_selection_internal,
2002 Sx_get_selection_internal, 2, 2, 0,
2003 doc: /* Return text selected from some X window.
2004 SELECTION is a symbol, typically `PRIMARY', `SECONDARY', or `CLIPBOARD'.
2005 \(Those are literal upper-case symbol names, since that's what X expects.)
2006 TYPE is the type of data desired, typically `STRING'. */)
2007 (selection_symbol, target_type)
2008 Lisp_Object selection_symbol, target_type;
2010 Lisp_Object val = Qnil;
2011 struct gcpro gcpro1, gcpro2;
2012 GCPRO2 (target_type, val); /* we store newly consed data into these */
2013 check_x ();
2014 CHECK_SYMBOL (selection_symbol);
2016 #if 0 /* #### MULTIPLE doesn't work yet */
2017 if (CONSP (target_type)
2018 && XCAR (target_type) == QMULTIPLE)
2020 CHECK_VECTOR (XCDR (target_type));
2021 /* So we don't destructively modify this... */
2022 target_type = copy_multiple_data (target_type);
2024 else
2025 #endif
2026 CHECK_SYMBOL (target_type);
2028 val = x_get_local_selection (selection_symbol, target_type);
2030 if (NILP (val))
2032 val = x_get_foreign_selection (selection_symbol, target_type);
2033 goto DONE;
2036 if (CONSP (val)
2037 && SYMBOLP (XCAR (val)))
2039 val = XCDR (val);
2040 if (CONSP (val) && NILP (XCDR (val)))
2041 val = XCAR (val);
2043 val = clean_local_selection_data (val);
2044 DONE:
2045 UNGCPRO;
2046 return val;
2049 DEFUN ("x-disown-selection-internal", Fx_disown_selection_internal,
2050 Sx_disown_selection_internal, 1, 2, 0,
2051 doc: /* If we own the selection SELECTION, disown it.
2052 Disowning it means there is no such selection. */)
2053 (selection, time)
2054 Lisp_Object selection;
2055 Lisp_Object time;
2057 Time timestamp;
2058 Atom selection_atom;
2059 struct selection_input_event event;
2060 Display *display;
2061 struct x_display_info *dpyinfo;
2062 struct frame *sf = SELECTED_FRAME ();
2064 check_x ();
2065 display = FRAME_X_DISPLAY (sf);
2066 dpyinfo = FRAME_X_DISPLAY_INFO (sf);
2067 CHECK_SYMBOL (selection);
2068 if (NILP (time))
2069 timestamp = last_event_timestamp;
2070 else
2071 timestamp = cons_to_long (time);
2073 if (NILP (assq_no_quit (selection, Vselection_alist)))
2074 return Qnil; /* Don't disown the selection when we're not the owner. */
2076 selection_atom = symbol_to_x_atom (dpyinfo, display, selection);
2078 BLOCK_INPUT;
2079 XSetSelectionOwner (display, selection_atom, None, timestamp);
2080 UNBLOCK_INPUT;
2082 /* It doesn't seem to be guaranteed that a SelectionClear event will be
2083 generated for a window which owns the selection when that window sets
2084 the selection owner to None. The NCD server does, the MIT Sun4 server
2085 doesn't. So we synthesize one; this means we might get two, but
2086 that's ok, because the second one won't have any effect. */
2087 SELECTION_EVENT_DISPLAY (&event) = display;
2088 SELECTION_EVENT_SELECTION (&event) = selection_atom;
2089 SELECTION_EVENT_TIME (&event) = timestamp;
2090 x_handle_selection_clear ((struct input_event *) &event);
2092 return Qt;
2095 /* Get rid of all the selections in buffer BUFFER.
2096 This is used when we kill a buffer. */
2098 void
2099 x_disown_buffer_selections (buffer)
2100 Lisp_Object buffer;
2102 Lisp_Object tail;
2103 struct buffer *buf = XBUFFER (buffer);
2105 for (tail = Vselection_alist; CONSP (tail); tail = XCDR (tail))
2107 Lisp_Object elt, value;
2108 elt = XCAR (tail);
2109 value = XCDR (elt);
2110 if (CONSP (value) && MARKERP (XCAR (value))
2111 && XMARKER (XCAR (value))->buffer == buf)
2112 Fx_disown_selection_internal (XCAR (elt), Qnil);
2116 DEFUN ("x-selection-owner-p", Fx_selection_owner_p, Sx_selection_owner_p,
2117 0, 1, 0,
2118 doc: /* Whether the current Emacs process owns the given X Selection.
2119 The arg should be the name of the selection in question, typically one of
2120 the symbols `PRIMARY', `SECONDARY', or `CLIPBOARD'.
2121 \(Those are literal upper-case symbol names, since that's what X expects.)
2122 For convenience, the symbol nil is the same as `PRIMARY',
2123 and t is the same as `SECONDARY'. */)
2124 (selection)
2125 Lisp_Object selection;
2127 check_x ();
2128 CHECK_SYMBOL (selection);
2129 if (EQ (selection, Qnil)) selection = QPRIMARY;
2130 if (EQ (selection, Qt)) selection = QSECONDARY;
2132 if (NILP (Fassq (selection, Vselection_alist)))
2133 return Qnil;
2134 return Qt;
2137 DEFUN ("x-selection-exists-p", Fx_selection_exists_p, Sx_selection_exists_p,
2138 0, 1, 0,
2139 doc: /* Whether there is an owner for the given X Selection.
2140 The arg should be the name of the selection in question, typically one of
2141 the symbols `PRIMARY', `SECONDARY', or `CLIPBOARD'.
2142 \(Those are literal upper-case symbol names, since that's what X expects.)
2143 For convenience, the symbol nil is the same as `PRIMARY',
2144 and t is the same as `SECONDARY'. */)
2145 (selection)
2146 Lisp_Object selection;
2148 Window owner;
2149 Atom atom;
2150 Display *dpy;
2151 struct frame *sf = SELECTED_FRAME ();
2153 /* It should be safe to call this before we have an X frame. */
2154 if (! FRAME_X_P (sf))
2155 return Qnil;
2157 dpy = FRAME_X_DISPLAY (sf);
2158 CHECK_SYMBOL (selection);
2159 if (!NILP (Fx_selection_owner_p (selection)))
2160 return Qt;
2161 if (EQ (selection, Qnil)) selection = QPRIMARY;
2162 if (EQ (selection, Qt)) selection = QSECONDARY;
2163 atom = symbol_to_x_atom (FRAME_X_DISPLAY_INFO (sf), dpy, selection);
2164 if (atom == 0)
2165 return Qnil;
2166 BLOCK_INPUT;
2167 owner = XGetSelectionOwner (dpy, atom);
2168 UNBLOCK_INPUT;
2169 return (owner ? Qt : Qnil);
2173 #ifdef CUT_BUFFER_SUPPORT
2175 /* Ensure that all 8 cut buffers exist. ICCCM says we gotta... */
2176 static void
2177 initialize_cut_buffers (display, window)
2178 Display *display;
2179 Window window;
2181 unsigned char *data = (unsigned char *) "";
2182 BLOCK_INPUT;
2183 #define FROB(atom) XChangeProperty (display, window, atom, XA_STRING, 8, \
2184 PropModeAppend, data, 0)
2185 FROB (XA_CUT_BUFFER0);
2186 FROB (XA_CUT_BUFFER1);
2187 FROB (XA_CUT_BUFFER2);
2188 FROB (XA_CUT_BUFFER3);
2189 FROB (XA_CUT_BUFFER4);
2190 FROB (XA_CUT_BUFFER5);
2191 FROB (XA_CUT_BUFFER6);
2192 FROB (XA_CUT_BUFFER7);
2193 #undef FROB
2194 UNBLOCK_INPUT;
2198 #define CHECK_CUT_BUFFER(symbol) \
2199 { CHECK_SYMBOL ((symbol)); \
2200 if (!EQ((symbol), QCUT_BUFFER0) && !EQ((symbol), QCUT_BUFFER1) \
2201 && !EQ((symbol), QCUT_BUFFER2) && !EQ((symbol), QCUT_BUFFER3) \
2202 && !EQ((symbol), QCUT_BUFFER4) && !EQ((symbol), QCUT_BUFFER5) \
2203 && !EQ((symbol), QCUT_BUFFER6) && !EQ((symbol), QCUT_BUFFER7)) \
2204 Fsignal (Qerror, \
2205 Fcons (build_string ("doesn't name a cut buffer"), \
2206 Fcons ((symbol), Qnil))); \
2209 DEFUN ("x-get-cut-buffer-internal", Fx_get_cut_buffer_internal,
2210 Sx_get_cut_buffer_internal, 1, 1, 0,
2211 doc: /* Returns the value of the named cut buffer (typically CUT_BUFFER0). */)
2212 (buffer)
2213 Lisp_Object buffer;
2215 Window window;
2216 Atom buffer_atom;
2217 unsigned char *data;
2218 int bytes;
2219 Atom type;
2220 int format;
2221 unsigned long size;
2222 Lisp_Object ret;
2223 Display *display;
2224 struct x_display_info *dpyinfo;
2225 struct frame *sf = SELECTED_FRAME ();
2227 check_x ();
2228 display = FRAME_X_DISPLAY (sf);
2229 dpyinfo = FRAME_X_DISPLAY_INFO (sf);
2230 window = RootWindow (display, 0); /* Cut buffers are on screen 0 */
2231 CHECK_CUT_BUFFER (buffer);
2232 buffer_atom = symbol_to_x_atom (dpyinfo, display, buffer);
2234 x_get_window_property (display, window, buffer_atom, &data, &bytes,
2235 &type, &format, &size, 0);
2236 if (!data || !format)
2237 return Qnil;
2239 if (format != 8 || type != XA_STRING)
2240 Fsignal (Qerror,
2241 Fcons (build_string ("cut buffer doesn't contain 8-bit data"),
2242 Fcons (x_atom_to_symbol (display, type),
2243 Fcons (make_number (format), Qnil))));
2245 ret = (bytes ? make_string ((char *) data, bytes) : Qnil);
2246 /* Use xfree, not XFree, because x_get_window_property
2247 calls xmalloc itself. */
2248 xfree (data);
2249 return ret;
2253 DEFUN ("x-store-cut-buffer-internal", Fx_store_cut_buffer_internal,
2254 Sx_store_cut_buffer_internal, 2, 2, 0,
2255 doc: /* Sets the value of the named cut buffer (typically CUT_BUFFER0). */)
2256 (buffer, string)
2257 Lisp_Object buffer, string;
2259 Window window;
2260 Atom buffer_atom;
2261 unsigned char *data;
2262 int bytes;
2263 int bytes_remaining;
2264 int max_bytes;
2265 Display *display;
2266 struct frame *sf = SELECTED_FRAME ();
2268 check_x ();
2269 display = FRAME_X_DISPLAY (sf);
2270 window = RootWindow (display, 0); /* Cut buffers are on screen 0 */
2272 max_bytes = SELECTION_QUANTUM (display);
2273 if (max_bytes > MAX_SELECTION_QUANTUM)
2274 max_bytes = MAX_SELECTION_QUANTUM;
2276 CHECK_CUT_BUFFER (buffer);
2277 CHECK_STRING (string);
2278 buffer_atom = symbol_to_x_atom (FRAME_X_DISPLAY_INFO (sf),
2279 display, buffer);
2280 data = (unsigned char *) SDATA (string);
2281 bytes = SBYTES (string);
2282 bytes_remaining = bytes;
2284 if (! FRAME_X_DISPLAY_INFO (sf)->cut_buffers_initialized)
2286 initialize_cut_buffers (display, window);
2287 FRAME_X_DISPLAY_INFO (sf)->cut_buffers_initialized = 1;
2290 BLOCK_INPUT;
2292 /* Don't mess up with an empty value. */
2293 if (!bytes_remaining)
2294 XChangeProperty (display, window, buffer_atom, XA_STRING, 8,
2295 PropModeReplace, data, 0);
2297 while (bytes_remaining)
2299 int chunk = (bytes_remaining < max_bytes
2300 ? bytes_remaining : max_bytes);
2301 XChangeProperty (display, window, buffer_atom, XA_STRING, 8,
2302 (bytes_remaining == bytes
2303 ? PropModeReplace
2304 : PropModeAppend),
2305 data, chunk);
2306 data += chunk;
2307 bytes_remaining -= chunk;
2309 UNBLOCK_INPUT;
2310 return string;
2314 DEFUN ("x-rotate-cut-buffers-internal", Fx_rotate_cut_buffers_internal,
2315 Sx_rotate_cut_buffers_internal, 1, 1, 0,
2316 doc: /* Rotate the values of the cut buffers by the given number of step.
2317 Positive means shift the values forward, negative means backward. */)
2319 Lisp_Object n;
2321 Window window;
2322 Atom props[8];
2323 Display *display;
2324 struct frame *sf = SELECTED_FRAME ();
2326 check_x ();
2327 display = FRAME_X_DISPLAY (sf);
2328 window = RootWindow (display, 0); /* Cut buffers are on screen 0 */
2329 CHECK_NUMBER (n);
2330 if (XINT (n) == 0)
2331 return n;
2332 if (! FRAME_X_DISPLAY_INFO (sf)->cut_buffers_initialized)
2334 initialize_cut_buffers (display, window);
2335 FRAME_X_DISPLAY_INFO (sf)->cut_buffers_initialized = 1;
2338 props[0] = XA_CUT_BUFFER0;
2339 props[1] = XA_CUT_BUFFER1;
2340 props[2] = XA_CUT_BUFFER2;
2341 props[3] = XA_CUT_BUFFER3;
2342 props[4] = XA_CUT_BUFFER4;
2343 props[5] = XA_CUT_BUFFER5;
2344 props[6] = XA_CUT_BUFFER6;
2345 props[7] = XA_CUT_BUFFER7;
2346 BLOCK_INPUT;
2347 XRotateWindowProperties (display, window, props, 8, XINT (n));
2348 UNBLOCK_INPUT;
2349 return n;
2352 #endif
2354 void
2355 syms_of_xselect ()
2357 defsubr (&Sx_get_selection_internal);
2358 defsubr (&Sx_own_selection_internal);
2359 defsubr (&Sx_disown_selection_internal);
2360 defsubr (&Sx_selection_owner_p);
2361 defsubr (&Sx_selection_exists_p);
2363 #ifdef CUT_BUFFER_SUPPORT
2364 defsubr (&Sx_get_cut_buffer_internal);
2365 defsubr (&Sx_store_cut_buffer_internal);
2366 defsubr (&Sx_rotate_cut_buffers_internal);
2367 #endif
2369 reading_selection_reply = Fcons (Qnil, Qnil);
2370 staticpro (&reading_selection_reply);
2371 reading_selection_window = 0;
2372 reading_which_selection = 0;
2374 property_change_wait_list = 0;
2375 prop_location_identifier = 0;
2376 property_change_reply = Fcons (Qnil, Qnil);
2377 staticpro (&property_change_reply);
2379 Vselection_alist = Qnil;
2380 staticpro (&Vselection_alist);
2382 DEFVAR_LISP ("selection-converter-alist", &Vselection_converter_alist,
2383 doc: /* An alist associating X Windows selection-types with functions.
2384 These functions are called to convert the selection, with three args:
2385 the name of the selection (typically `PRIMARY', `SECONDARY', or `CLIPBOARD');
2386 a desired type to which the selection should be converted;
2387 and the local selection value (whatever was given to `x-own-selection').
2389 The function should return the value to send to the X server
2390 \(typically a string). A return value of nil
2391 means that the conversion could not be done.
2392 A return value which is the symbol `NULL'
2393 means that a side-effect was executed,
2394 and there is no meaningful selection value. */);
2395 Vselection_converter_alist = Qnil;
2397 DEFVAR_LISP ("x-lost-selection-hooks", &Vx_lost_selection_hooks,
2398 doc: /* A list of functions to be called when Emacs loses an X selection.
2399 \(This happens when some other X client makes its own selection
2400 or when a Lisp program explicitly clears the selection.)
2401 The functions are called with one argument, the selection type
2402 \(a symbol, typically `PRIMARY', `SECONDARY', or `CLIPBOARD'). */);
2403 Vx_lost_selection_hooks = Qnil;
2405 DEFVAR_LISP ("x-sent-selection-hooks", &Vx_sent_selection_hooks,
2406 doc: /* A list of functions to be called when Emacs answers a selection request.
2407 The functions are called with four arguments:
2408 - the selection name (typically `PRIMARY', `SECONDARY', or `CLIPBOARD');
2409 - the selection-type which Emacs was asked to convert the
2410 selection into before sending (for example, `STRING' or `LENGTH');
2411 - a flag indicating success or failure for responding to the request.
2412 We might have failed (and declined the request) for any number of reasons,
2413 including being asked for a selection that we no longer own, or being asked
2414 to convert into a type that we don't know about or that is inappropriate.
2415 This hook doesn't let you change the behavior of Emacs's selection replies,
2416 it merely informs you that they have happened. */);
2417 Vx_sent_selection_hooks = Qnil;
2419 DEFVAR_LISP ("selection-coding-system", &Vselection_coding_system,
2420 doc: /* Coding system for communicating with other X clients.
2421 When sending or receiving text via cut_buffer, selection, and clipboard,
2422 the text is encoded or decoded by this coding system.
2423 The default value is `compound-text-with-extensions'. */);
2424 Vselection_coding_system = intern ("compound-text-with-extensions");
2426 DEFVAR_LISP ("next-selection-coding-system", &Vnext_selection_coding_system,
2427 doc: /* Coding system for the next communication with other X clients.
2428 Usually, `selection-coding-system' is used for communicating with
2429 other X clients. But, if this variable is set, it is used for the
2430 next communication only. After the communication, this variable is
2431 set to nil. */);
2432 Vnext_selection_coding_system = Qnil;
2434 DEFVAR_INT ("x-selection-timeout", &x_selection_timeout,
2435 doc: /* Number of milliseconds to wait for a selection reply.
2436 If the selection owner doesn't reply in this time, we give up.
2437 A value of 0 means wait as long as necessary. This is initialized from the
2438 \"*selectionTimeout\" resource. */);
2439 x_selection_timeout = 0;
2441 QPRIMARY = intern ("PRIMARY"); staticpro (&QPRIMARY);
2442 QSECONDARY = intern ("SECONDARY"); staticpro (&QSECONDARY);
2443 QSTRING = intern ("STRING"); staticpro (&QSTRING);
2444 QINTEGER = intern ("INTEGER"); staticpro (&QINTEGER);
2445 QCLIPBOARD = intern ("CLIPBOARD"); staticpro (&QCLIPBOARD);
2446 QTIMESTAMP = intern ("TIMESTAMP"); staticpro (&QTIMESTAMP);
2447 QTEXT = intern ("TEXT"); staticpro (&QTEXT);
2448 QCOMPOUND_TEXT = intern ("COMPOUND_TEXT"); staticpro (&QCOMPOUND_TEXT);
2449 QTIMESTAMP = intern ("TIMESTAMP"); staticpro (&QTIMESTAMP);
2450 QDELETE = intern ("DELETE"); staticpro (&QDELETE);
2451 QMULTIPLE = intern ("MULTIPLE"); staticpro (&QMULTIPLE);
2452 QINCR = intern ("INCR"); staticpro (&QINCR);
2453 QEMACS_TMP = intern ("_EMACS_TMP_"); staticpro (&QEMACS_TMP);
2454 QTARGETS = intern ("TARGETS"); staticpro (&QTARGETS);
2455 QATOM = intern ("ATOM"); staticpro (&QATOM);
2456 QATOM_PAIR = intern ("ATOM_PAIR"); staticpro (&QATOM_PAIR);
2457 QNULL = intern ("NULL"); staticpro (&QNULL);
2458 Qcompound_text_with_extensions = intern ("compound-text-with-extensions");
2459 staticpro (&Qcompound_text_with_extensions);
2461 #ifdef CUT_BUFFER_SUPPORT
2462 QCUT_BUFFER0 = intern ("CUT_BUFFER0"); staticpro (&QCUT_BUFFER0);
2463 QCUT_BUFFER1 = intern ("CUT_BUFFER1"); staticpro (&QCUT_BUFFER1);
2464 QCUT_BUFFER2 = intern ("CUT_BUFFER2"); staticpro (&QCUT_BUFFER2);
2465 QCUT_BUFFER3 = intern ("CUT_BUFFER3"); staticpro (&QCUT_BUFFER3);
2466 QCUT_BUFFER4 = intern ("CUT_BUFFER4"); staticpro (&QCUT_BUFFER4);
2467 QCUT_BUFFER5 = intern ("CUT_BUFFER5"); staticpro (&QCUT_BUFFER5);
2468 QCUT_BUFFER6 = intern ("CUT_BUFFER6"); staticpro (&QCUT_BUFFER6);
2469 QCUT_BUFFER7 = intern ("CUT_BUFFER7"); staticpro (&QCUT_BUFFER7);
2470 #endif