428
|
1 /* Generic glyph/image implementation + display tables
|
|
2 Copyright (C) 1994, 1995 Board of Trustees, University of Illinois.
|
|
3 Copyright (C) 1995 Tinker Systems
|
793
|
4 Copyright (C) 1995, 1996, 2000, 2001, 2002 Ben Wing
|
428
|
5 Copyright (C) 1995 Sun Microsystems
|
438
|
6 Copyright (C) 1998, 1999, 2000 Andy Piper
|
428
|
7
|
|
8 This file is part of XEmacs.
|
|
9
|
|
10 XEmacs is free software; you can redistribute it and/or modify it
|
|
11 under the terms of the GNU General Public License as published by the
|
|
12 Free Software Foundation; either version 2, or (at your option) any
|
|
13 later version.
|
|
14
|
|
15 XEmacs is distributed in the hope that it will be useful, but WITHOUT
|
|
16 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
17 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
18 for more details.
|
|
19
|
|
20 You should have received a copy of the GNU General Public License
|
|
21 along with XEmacs; see the file COPYING. If not, write to
|
|
22 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
23 Boston, MA 02111-1307, USA. */
|
|
24
|
|
25 /* Synched up with: Not in FSF. */
|
|
26
|
438
|
27 /* Written by Ben Wing and Chuck Thompson. Heavily modified /
|
|
28 rewritten by Andy Piper. */
|
428
|
29
|
|
30 #include <config.h>
|
|
31 #include "lisp.h"
|
|
32
|
442
|
33 #include "blocktype.h"
|
428
|
34 #include "buffer.h"
|
442
|
35 #include "chartab.h"
|
428
|
36 #include "device.h"
|
|
37 #include "elhash.h"
|
|
38 #include "faces.h"
|
|
39 #include "frame.h"
|
442
|
40 #include "glyphs.h"
|
428
|
41 #include "insdel.h"
|
442
|
42 #include "objects.h"
|
428
|
43 #include "opaque.h"
|
442
|
44 #include "rangetab.h"
|
428
|
45 #include "redisplay.h"
|
442
|
46 #include "specifier.h"
|
428
|
47 #include "window.h"
|
|
48
|
771
|
49 #include "sysfile.h"
|
|
50
|
462
|
51 #if defined (HAVE_XPM) && !defined (HAVE_GTK)
|
428
|
52 #include <X11/xpm.h>
|
|
53 #endif
|
|
54
|
|
55 Lisp_Object Qimage_conversion_error;
|
|
56
|
|
57 Lisp_Object Qglyphp, Qcontrib_p, Qbaseline;
|
|
58 Lisp_Object Qbuffer_glyph_p, Qpointer_glyph_p, Qicon_glyph_p;
|
|
59 Lisp_Object Qnothing_image_instance_p, Qtext_image_instance_p;
|
|
60 Lisp_Object Qmono_pixmap_image_instance_p;
|
|
61 Lisp_Object Qcolor_pixmap_image_instance_p;
|
|
62 Lisp_Object Qpointer_image_instance_p;
|
|
63 Lisp_Object Qsubwindow_image_instance_p;
|
|
64 Lisp_Object Qwidget_image_instance_p;
|
|
65 Lisp_Object Qconst_glyph_variable;
|
|
66 Lisp_Object Qmono_pixmap, Qcolor_pixmap, Qsubwindow;
|
|
67 Lisp_Object Q_file, Q_data, Q_face, Q_pixel_width, Q_pixel_height;
|
|
68 Lisp_Object Qformatted_string;
|
|
69 Lisp_Object Vcurrent_display_table;
|
|
70 Lisp_Object Vtruncation_glyph, Vcontinuation_glyph, Voctal_escape_glyph;
|
|
71 Lisp_Object Vcontrol_arrow_glyph, Vinvisible_text_glyph, Vhscroll_glyph;
|
|
72 Lisp_Object Vxemacs_logo;
|
|
73 Lisp_Object Vthe_nothing_vector;
|
|
74 Lisp_Object Vimage_instantiator_format_list;
|
|
75 Lisp_Object Vimage_instance_type_list;
|
|
76 Lisp_Object Vglyph_type_list;
|
|
77
|
|
78 int disable_animated_pixmaps;
|
|
79
|
|
80 DEFINE_IMAGE_INSTANTIATOR_FORMAT (nothing);
|
|
81 DEFINE_IMAGE_INSTANTIATOR_FORMAT (inherit);
|
|
82 DEFINE_IMAGE_INSTANTIATOR_FORMAT (string);
|
|
83 DEFINE_IMAGE_INSTANTIATOR_FORMAT (formatted_string);
|
|
84 DEFINE_IMAGE_INSTANTIATOR_FORMAT (subwindow);
|
|
85 DEFINE_IMAGE_INSTANTIATOR_FORMAT (text);
|
442
|
86 DEFINE_IMAGE_INSTANTIATOR_FORMAT (pointer);
|
428
|
87
|
|
88 #ifdef HAVE_WINDOW_SYSTEM
|
|
89 DEFINE_IMAGE_INSTANTIATOR_FORMAT (xbm);
|
|
90 Lisp_Object Qxbm;
|
|
91
|
|
92 Lisp_Object Q_mask_file, Q_mask_data, Q_hotspot_x, Q_hotspot_y;
|
|
93 Lisp_Object Q_foreground, Q_background;
|
|
94 #ifndef BitmapSuccess
|
|
95 #define BitmapSuccess 0
|
|
96 #define BitmapOpenFailed 1
|
|
97 #define BitmapFileInvalid 2
|
|
98 #define BitmapNoMemory 3
|
|
99 #endif
|
|
100 #endif
|
|
101
|
|
102 #ifdef HAVE_XFACE
|
|
103 DEFINE_IMAGE_INSTANTIATOR_FORMAT (xface);
|
|
104 Lisp_Object Qxface;
|
|
105 #endif
|
|
106
|
|
107 #ifdef HAVE_XPM
|
|
108 DEFINE_IMAGE_INSTANTIATOR_FORMAT (xpm);
|
|
109 Lisp_Object Qxpm;
|
|
110 Lisp_Object Q_color_symbols;
|
|
111 #endif
|
|
112
|
|
113 typedef struct image_instantiator_format_entry image_instantiator_format_entry;
|
|
114 struct image_instantiator_format_entry
|
|
115 {
|
|
116 Lisp_Object symbol;
|
|
117 Lisp_Object device;
|
|
118 struct image_instantiator_methods *meths;
|
|
119 };
|
|
120
|
|
121 typedef struct
|
|
122 {
|
|
123 Dynarr_declare (struct image_instantiator_format_entry);
|
|
124 } image_instantiator_format_entry_dynarr;
|
|
125
|
442
|
126 /* This contains one entry per format, per device it's defined on. */
|
428
|
127 image_instantiator_format_entry_dynarr *
|
|
128 the_image_instantiator_format_entry_dynarr;
|
|
129
|
442
|
130 static Lisp_Object allocate_image_instance (Lisp_Object governing_domain,
|
|
131 Lisp_Object parent,
|
|
132 Lisp_Object instantiator);
|
428
|
133 static void image_validate (Lisp_Object instantiator);
|
|
134 static void glyph_property_was_changed (Lisp_Object glyph,
|
|
135 Lisp_Object property,
|
|
136 Lisp_Object locale);
|
442
|
137 static void set_image_instance_dirty_p (Lisp_Object instance, int dirty);
|
428
|
138 static void register_ignored_expose (struct frame* f, int x, int y, int width, int height);
|
442
|
139 static void cache_subwindow_instance_in_frame_maybe (Lisp_Object instance);
|
|
140 static void update_image_instance (Lisp_Object image_instance,
|
|
141 Lisp_Object instantiator);
|
428
|
142 /* Unfortunately windows and X are different. In windows BeginPaint()
|
|
143 will prevent WM_PAINT messages being generated so it is unnecessary
|
|
144 to register exposures as they will not occur. Under X they will
|
|
145 always occur. */
|
|
146 int hold_ignored_expose_registration;
|
|
147
|
|
148 EXFUN (Fimage_instance_type, 1);
|
|
149 EXFUN (Fglyph_type, 1);
|
442
|
150 EXFUN (Fnext_window, 4);
|
428
|
151
|
|
152
|
|
153 /****************************************************************************
|
|
154 * Image Instantiators *
|
|
155 ****************************************************************************/
|
|
156
|
|
157 struct image_instantiator_methods *
|
|
158 decode_device_ii_format (Lisp_Object device, Lisp_Object format,
|
578
|
159 Error_Behavior errb)
|
428
|
160 {
|
|
161 int i;
|
|
162
|
|
163 if (!SYMBOLP (format))
|
|
164 {
|
|
165 if (ERRB_EQ (errb, ERROR_ME))
|
|
166 CHECK_SYMBOL (format);
|
|
167 return 0;
|
|
168 }
|
|
169
|
|
170 for (i = 0; i < Dynarr_length (the_image_instantiator_format_entry_dynarr);
|
|
171 i++)
|
|
172 {
|
|
173 if ( EQ (format,
|
|
174 Dynarr_at (the_image_instantiator_format_entry_dynarr, i).
|
|
175 symbol) )
|
|
176 {
|
|
177 Lisp_Object d = Dynarr_at (the_image_instantiator_format_entry_dynarr, i).
|
|
178 device;
|
|
179 if ((NILP (d) && NILP (device))
|
|
180 ||
|
|
181 (!NILP (device) &&
|
440
|
182 EQ (CONSOLE_TYPE (XCONSOLE
|
428
|
183 (DEVICE_CONSOLE (XDEVICE (device)))), d)))
|
|
184 return Dynarr_at (the_image_instantiator_format_entry_dynarr, i).meths;
|
|
185 }
|
|
186 }
|
|
187
|
563
|
188 maybe_invalid_argument ("Invalid image-instantiator format", format,
|
428
|
189 Qimage, errb);
|
|
190
|
|
191 return 0;
|
|
192 }
|
|
193
|
|
194 struct image_instantiator_methods *
|
578
|
195 decode_image_instantiator_format (Lisp_Object format, Error_Behavior errb)
|
428
|
196 {
|
|
197 return decode_device_ii_format (Qnil, format, errb);
|
|
198 }
|
|
199
|
|
200 static int
|
|
201 valid_image_instantiator_format_p (Lisp_Object format, Lisp_Object locale)
|
|
202 {
|
|
203 int i;
|
|
204 struct image_instantiator_methods* meths =
|
|
205 decode_image_instantiator_format (format, ERROR_ME_NOT);
|
|
206 Lisp_Object contype = Qnil;
|
|
207 /* mess with the locale */
|
|
208 if (!NILP (locale) && SYMBOLP (locale))
|
|
209 contype = locale;
|
|
210 else
|
|
211 {
|
|
212 struct console* console = decode_console (locale);
|
|
213 contype = console ? CONSOLE_TYPE (console) : locale;
|
|
214 }
|
|
215 /* nothing is valid in all locales */
|
|
216 if (EQ (format, Qnothing))
|
|
217 return 1;
|
|
218 /* reject unknown formats */
|
|
219 else if (NILP (contype) || !meths)
|
|
220 return 0;
|
|
221
|
|
222 for (i = 0; i < Dynarr_length (meths->consoles); i++)
|
|
223 if (EQ (contype, Dynarr_at (meths->consoles, i).symbol))
|
|
224 return 1;
|
|
225 return 0;
|
|
226 }
|
|
227
|
|
228 DEFUN ("valid-image-instantiator-format-p", Fvalid_image_instantiator_format_p,
|
|
229 1, 2, 0, /*
|
|
230 Given an IMAGE-INSTANTIATOR-FORMAT, return non-nil if it is valid.
|
444
|
231 If LOCALE is non-nil then the format is checked in that locale.
|
428
|
232 If LOCALE is nil the current console is used.
|
442
|
233
|
428
|
234 Valid formats are some subset of 'nothing, 'string, 'formatted-string,
|
|
235 'xpm, 'xbm, 'xface, 'gif, 'jpeg, 'png, 'tiff, 'cursor-font, 'font,
|
442
|
236 'autodetect, 'subwindow, 'inherit, 'mswindows-resource, 'bmp,
|
|
237 'native-layout, 'layout, 'label, 'tab-control, 'tree-view,
|
|
238 'progress-gauge, 'scrollbar, 'combo-box, 'edit-field, 'button,
|
|
239 'widget, 'pointer, and 'text, depending on how XEmacs was compiled.
|
428
|
240 */
|
|
241 (image_instantiator_format, locale))
|
|
242 {
|
442
|
243 return valid_image_instantiator_format_p (image_instantiator_format,
|
|
244 locale) ?
|
428
|
245 Qt : Qnil;
|
|
246 }
|
|
247
|
|
248 DEFUN ("image-instantiator-format-list", Fimage_instantiator_format_list,
|
|
249 0, 0, 0, /*
|
|
250 Return a list of valid image-instantiator formats.
|
|
251 */
|
|
252 ())
|
|
253 {
|
|
254 return Fcopy_sequence (Vimage_instantiator_format_list);
|
|
255 }
|
|
256
|
|
257 void
|
|
258 add_entry_to_device_ii_format_list (Lisp_Object device, Lisp_Object symbol,
|
|
259 struct image_instantiator_methods *meths)
|
|
260 {
|
|
261 struct image_instantiator_format_entry entry;
|
|
262
|
|
263 entry.symbol = symbol;
|
|
264 entry.device = device;
|
|
265 entry.meths = meths;
|
|
266 Dynarr_add (the_image_instantiator_format_entry_dynarr, entry);
|
442
|
267 if (NILP (memq_no_quit (symbol, Vimage_instantiator_format_list)))
|
|
268 Vimage_instantiator_format_list =
|
|
269 Fcons (symbol, Vimage_instantiator_format_list);
|
428
|
270 }
|
|
271
|
|
272 void
|
|
273 add_entry_to_image_instantiator_format_list (Lisp_Object symbol,
|
|
274 struct
|
|
275 image_instantiator_methods *meths)
|
|
276 {
|
|
277 add_entry_to_device_ii_format_list (Qnil, symbol, meths);
|
|
278 }
|
|
279
|
|
280 static Lisp_Object *
|
|
281 get_image_conversion_list (Lisp_Object console_type)
|
|
282 {
|
|
283 return &decode_console_type (console_type, ERROR_ME)->image_conversion_list;
|
|
284 }
|
|
285
|
|
286 DEFUN ("set-console-type-image-conversion-list", Fset_console_type_image_conversion_list,
|
|
287 2, 2, 0, /*
|
444
|
288 Set the image-conversion-list for consoles of the given CONSOLE-TYPE.
|
428
|
289 The image-conversion-list specifies how image instantiators that
|
|
290 are strings should be interpreted. Each element of the list should be
|
|
291 a list of two elements (a regular expression string and a vector) or
|
|
292 a list of three elements (the preceding two plus an integer index into
|
|
293 the vector). The string is converted to the vector associated with the
|
|
294 first matching regular expression. If a vector index is specified, the
|
|
295 string itself is substituted into that position in the vector.
|
|
296
|
|
297 Note: The conversion above is applied when the image instantiator is
|
|
298 added to an image specifier, not when the specifier is actually
|
|
299 instantiated. Therefore, changing the image-conversion-list only affects
|
|
300 newly-added instantiators. Existing instantiators in glyphs and image
|
|
301 specifiers will not be affected.
|
|
302 */
|
|
303 (console_type, list))
|
|
304 {
|
|
305 Lisp_Object tail;
|
|
306 Lisp_Object *imlist = get_image_conversion_list (console_type);
|
|
307
|
|
308 /* Check the list to make sure that it only has valid entries. */
|
|
309
|
|
310 EXTERNAL_LIST_LOOP (tail, list)
|
|
311 {
|
|
312 Lisp_Object mapping = XCAR (tail);
|
|
313
|
|
314 /* Mapping form should be (STRING VECTOR) or (STRING VECTOR INTEGER) */
|
|
315 if (!CONSP (mapping) ||
|
|
316 !CONSP (XCDR (mapping)) ||
|
|
317 (!NILP (XCDR (XCDR (mapping))) &&
|
|
318 (!CONSP (XCDR (XCDR (mapping))) ||
|
|
319 !NILP (XCDR (XCDR (XCDR (mapping)))))))
|
563
|
320 invalid_argument ("Invalid mapping form", mapping);
|
428
|
321 else
|
|
322 {
|
|
323 Lisp_Object exp = XCAR (mapping);
|
|
324 Lisp_Object typevec = XCAR (XCDR (mapping));
|
|
325 Lisp_Object pos = Qnil;
|
|
326 Lisp_Object newvec;
|
|
327 struct gcpro gcpro1;
|
|
328
|
|
329 CHECK_STRING (exp);
|
|
330 CHECK_VECTOR (typevec);
|
|
331 if (!NILP (XCDR (XCDR (mapping))))
|
|
332 {
|
|
333 pos = XCAR (XCDR (XCDR (mapping)));
|
|
334 CHECK_INT (pos);
|
|
335 if (XINT (pos) < 0 ||
|
|
336 XINT (pos) >= XVECTOR_LENGTH (typevec))
|
|
337 args_out_of_range_3
|
|
338 (pos, Qzero, make_int (XVECTOR_LENGTH (typevec) - 1));
|
|
339 }
|
|
340
|
|
341 newvec = Fcopy_sequence (typevec);
|
|
342 if (INTP (pos))
|
|
343 XVECTOR_DATA (newvec)[XINT (pos)] = exp;
|
|
344 GCPRO1 (newvec);
|
|
345 image_validate (newvec);
|
|
346 UNGCPRO;
|
|
347 }
|
|
348 }
|
|
349
|
|
350 *imlist = Fcopy_tree (list, Qt);
|
|
351 return list;
|
|
352 }
|
|
353
|
|
354 DEFUN ("console-type-image-conversion-list", Fconsole_type_image_conversion_list,
|
|
355 1, 1, 0, /*
|
444
|
356 Return the image-conversion-list for devices of the given CONSOLE-TYPE.
|
428
|
357 The image-conversion-list specifies how to interpret image string
|
|
358 instantiators for the specified console type. See
|
|
359 `set-console-type-image-conversion-list' for a description of its syntax.
|
|
360 */
|
|
361 (console_type))
|
|
362 {
|
|
363 return Fcopy_tree (*get_image_conversion_list (console_type), Qt);
|
|
364 }
|
|
365
|
|
366 /* Process a string instantiator according to the image-conversion-list for
|
|
367 CONSOLE_TYPE. Returns a vector. */
|
|
368
|
|
369 static Lisp_Object
|
|
370 process_image_string_instantiator (Lisp_Object data,
|
|
371 Lisp_Object console_type,
|
|
372 int dest_mask)
|
|
373 {
|
|
374 Lisp_Object tail;
|
|
375
|
|
376 LIST_LOOP (tail, *get_image_conversion_list (console_type))
|
|
377 {
|
|
378 Lisp_Object mapping = XCAR (tail);
|
|
379 Lisp_Object exp = XCAR (mapping);
|
|
380 Lisp_Object typevec = XCAR (XCDR (mapping));
|
|
381
|
|
382 /* if the result is of a type that can't be instantiated
|
|
383 (e.g. a string when we're dealing with a pointer glyph),
|
|
384 skip it. */
|
|
385 if (!(dest_mask &
|
|
386 IIFORMAT_METH (decode_image_instantiator_format
|
450
|
387 (INSTANTIATOR_TYPE (typevec), ERROR_ME),
|
428
|
388 possible_dest_types, ())))
|
|
389 continue;
|
|
390 if (fast_string_match (exp, 0, data, 0, -1, 0, ERROR_ME, 0) >= 0)
|
|
391 {
|
|
392 if (!NILP (XCDR (XCDR (mapping))))
|
|
393 {
|
|
394 int pos = XINT (XCAR (XCDR (XCDR (mapping))));
|
|
395 Lisp_Object newvec = Fcopy_sequence (typevec);
|
|
396 XVECTOR_DATA (newvec)[pos] = data;
|
|
397 return newvec;
|
|
398 }
|
|
399 else
|
|
400 return typevec;
|
|
401 }
|
|
402 }
|
|
403
|
|
404 /* Oh well. */
|
563
|
405 invalid_argument ("Unable to interpret glyph instantiator",
|
428
|
406 data);
|
|
407
|
|
408 return Qnil;
|
|
409 }
|
|
410
|
|
411 Lisp_Object
|
|
412 find_keyword_in_vector_or_given (Lisp_Object vector, Lisp_Object keyword,
|
|
413 Lisp_Object default_)
|
|
414 {
|
|
415 Lisp_Object *elt;
|
|
416 int instantiator_len;
|
|
417
|
|
418 elt = XVECTOR_DATA (vector);
|
|
419 instantiator_len = XVECTOR_LENGTH (vector);
|
|
420
|
|
421 elt++;
|
|
422 instantiator_len--;
|
|
423
|
|
424 while (instantiator_len > 0)
|
|
425 {
|
|
426 if (EQ (elt[0], keyword))
|
|
427 return elt[1];
|
|
428 elt += 2;
|
|
429 instantiator_len -= 2;
|
|
430 }
|
|
431
|
|
432 return default_;
|
|
433 }
|
|
434
|
|
435 Lisp_Object
|
|
436 find_keyword_in_vector (Lisp_Object vector, Lisp_Object keyword)
|
|
437 {
|
|
438 return find_keyword_in_vector_or_given (vector, keyword, Qnil);
|
|
439 }
|
|
440
|
442
|
441 static Lisp_Object
|
|
442 find_instantiator_differences (Lisp_Object new, Lisp_Object old)
|
|
443 {
|
|
444 Lisp_Object alist = Qnil;
|
|
445 Lisp_Object *elt = XVECTOR_DATA (new);
|
|
446 Lisp_Object *old_elt = XVECTOR_DATA (old);
|
|
447 int len = XVECTOR_LENGTH (new);
|
|
448 struct gcpro gcpro1;
|
|
449
|
|
450 /* If the vector length has changed then consider everything
|
|
451 changed. We could try and figure out what properties have
|
|
452 disappeared or been added, but this code is only used as an
|
|
453 optimization anyway so lets not bother. */
|
|
454 if (len != XVECTOR_LENGTH (old))
|
|
455 return new;
|
|
456
|
|
457 GCPRO1 (alist);
|
|
458
|
|
459 for (len -= 2; len >= 1; len -= 2)
|
|
460 {
|
|
461 /* Keyword comparisons can be done with eq, the value must be
|
|
462 done with equal.
|
|
463 #### Note that this does not optimize re-ordering. */
|
|
464 if (!EQ (elt[len], old_elt[len])
|
|
465 || !internal_equal (elt[len+1], old_elt[len+1], 0))
|
|
466 alist = Fcons (Fcons (elt[len], elt[len+1]), alist);
|
|
467 }
|
|
468
|
|
469 {
|
|
470 Lisp_Object result = alist_to_tagged_vector (elt[0], alist);
|
|
471 free_alist (alist);
|
|
472 RETURN_UNGCPRO (result);
|
|
473 }
|
|
474 }
|
|
475
|
|
476 DEFUN ("set-instantiator-property", Fset_instantiator_property,
|
|
477 3, 3, 0, /*
|
444
|
478 Destructively set the property KEYWORD of INSTANTIATOR to VALUE.
|
442
|
479 If the property is not set then it is added to a copy of the
|
|
480 instantiator and the new instantiator returned.
|
|
481 Use `set-glyph-image' on glyphs to register instantiator changes. */
|
444
|
482 (instantiator, keyword, value))
|
442
|
483 {
|
|
484 Lisp_Object *elt;
|
|
485 int len;
|
|
486
|
|
487 CHECK_VECTOR (instantiator);
|
|
488 if (!KEYWORDP (keyword))
|
563
|
489 invalid_argument ("instantiator property must be a keyword", keyword);
|
442
|
490
|
|
491 elt = XVECTOR_DATA (instantiator);
|
|
492 len = XVECTOR_LENGTH (instantiator);
|
|
493
|
|
494 for (len -= 2; len >= 1; len -= 2)
|
|
495 {
|
|
496 if (EQ (elt[len], keyword))
|
|
497 {
|
444
|
498 elt[len+1] = value;
|
442
|
499 break;
|
|
500 }
|
|
501 }
|
|
502
|
|
503 /* Didn't find it so add it. */
|
|
504 if (len < 1)
|
|
505 {
|
|
506 Lisp_Object alist = Qnil, result;
|
|
507 struct gcpro gcpro1;
|
|
508
|
|
509 GCPRO1 (alist);
|
|
510 alist = tagged_vector_to_alist (instantiator);
|
444
|
511 alist = Fcons (Fcons (keyword, value), alist);
|
442
|
512 result = alist_to_tagged_vector (elt[0], alist);
|
|
513 free_alist (alist);
|
|
514 RETURN_UNGCPRO (result);
|
|
515 }
|
|
516
|
|
517 return instantiator;
|
|
518 }
|
|
519
|
428
|
520 void
|
|
521 check_valid_string (Lisp_Object data)
|
|
522 {
|
|
523 CHECK_STRING (data);
|
|
524 }
|
|
525
|
|
526 void
|
|
527 check_valid_vector (Lisp_Object data)
|
|
528 {
|
|
529 CHECK_VECTOR (data);
|
|
530 }
|
|
531
|
|
532 void
|
|
533 check_valid_face (Lisp_Object data)
|
|
534 {
|
|
535 Fget_face (data);
|
|
536 }
|
|
537
|
|
538 void
|
|
539 check_valid_int (Lisp_Object data)
|
|
540 {
|
|
541 CHECK_INT (data);
|
|
542 }
|
|
543
|
|
544 void
|
|
545 file_or_data_must_be_present (Lisp_Object instantiator)
|
|
546 {
|
|
547 if (NILP (find_keyword_in_vector (instantiator, Q_file)) &&
|
|
548 NILP (find_keyword_in_vector (instantiator, Q_data)))
|
563
|
549 sferror ("Must supply either :file or :data",
|
428
|
550 instantiator);
|
|
551 }
|
|
552
|
|
553 void
|
|
554 data_must_be_present (Lisp_Object instantiator)
|
|
555 {
|
|
556 if (NILP (find_keyword_in_vector (instantiator, Q_data)))
|
563
|
557 sferror ("Must supply :data", instantiator);
|
428
|
558 }
|
|
559
|
|
560 static void
|
|
561 face_must_be_present (Lisp_Object instantiator)
|
|
562 {
|
|
563 if (NILP (find_keyword_in_vector (instantiator, Q_face)))
|
563
|
564 sferror ("Must supply :face", instantiator);
|
428
|
565 }
|
|
566
|
|
567 /* utility function useful in retrieving data from a file. */
|
|
568
|
|
569 Lisp_Object
|
|
570 make_string_from_file (Lisp_Object file)
|
|
571 {
|
|
572 /* This function can call lisp */
|
|
573 int count = specpdl_depth ();
|
|
574 Lisp_Object temp_buffer;
|
|
575 struct gcpro gcpro1;
|
|
576 Lisp_Object data;
|
|
577
|
|
578 specbind (Qinhibit_quit, Qt);
|
|
579 record_unwind_protect (Fset_buffer, Fcurrent_buffer ());
|
|
580 temp_buffer = Fget_buffer_create (build_string (" *pixmap conversion*"));
|
|
581 GCPRO1 (temp_buffer);
|
|
582 set_buffer_internal (XBUFFER (temp_buffer));
|
|
583 Ferase_buffer (Qnil);
|
|
584 specbind (intern ("format-alist"), Qnil);
|
|
585 Finsert_file_contents_internal (file, Qnil, Qnil, Qnil, Qnil, Qnil, Qnil);
|
|
586 data = Fbuffer_substring (Qnil, Qnil, Qnil);
|
771
|
587 unbind_to (count);
|
428
|
588 UNGCPRO;
|
|
589 return data;
|
|
590 }
|
|
591
|
|
592 /* The following two functions are provided to make it easier for
|
|
593 the normalize methods to work with keyword-value vectors.
|
|
594 Hash tables are kind of heavyweight for this purpose.
|
|
595 (If vectors were resizable, we could avoid this problem;
|
|
596 but they're not.) An alternative approach that might be
|
|
597 more efficient but require more work is to use a type of
|
|
598 assoc-Dynarr and provide primitives for deleting elements out
|
|
599 of it. (However, you'd also have to add an unwind-protect
|
|
600 to make sure the Dynarr got freed in case of an error in
|
|
601 the normalization process.) */
|
|
602
|
|
603 Lisp_Object
|
|
604 tagged_vector_to_alist (Lisp_Object vector)
|
|
605 {
|
|
606 Lisp_Object *elt = XVECTOR_DATA (vector);
|
|
607 int len = XVECTOR_LENGTH (vector);
|
|
608 Lisp_Object result = Qnil;
|
|
609
|
|
610 assert (len & 1);
|
|
611 for (len -= 2; len >= 1; len -= 2)
|
|
612 result = Fcons (Fcons (elt[len], elt[len+1]), result);
|
|
613
|
|
614 return result;
|
|
615 }
|
|
616
|
|
617 Lisp_Object
|
|
618 alist_to_tagged_vector (Lisp_Object tag, Lisp_Object alist)
|
|
619 {
|
|
620 int len = 1 + 2 * XINT (Flength (alist));
|
|
621 Lisp_Object *elt = alloca_array (Lisp_Object, len);
|
|
622 int i;
|
|
623 Lisp_Object rest;
|
|
624
|
|
625 i = 0;
|
|
626 elt[i++] = tag;
|
|
627 LIST_LOOP (rest, alist)
|
|
628 {
|
|
629 Lisp_Object pair = XCAR (rest);
|
|
630 elt[i] = XCAR (pair);
|
|
631 elt[i+1] = XCDR (pair);
|
|
632 i += 2;
|
|
633 }
|
|
634
|
|
635 return Fvector (len, elt);
|
|
636 }
|
|
637
|
442
|
638 #ifdef ERROR_CHECK_GLYPHS
|
|
639 static int
|
|
640 check_instance_cache_mapper (Lisp_Object key, Lisp_Object value,
|
|
641 void *flag_closure)
|
|
642 {
|
|
643 /* This function can GC */
|
|
644 /* value can be nil; we cache failures as well as successes */
|
|
645 if (!NILP (value))
|
|
646 {
|
|
647 Lisp_Object window;
|
|
648 VOID_TO_LISP (window, flag_closure);
|
|
649 assert (EQ (XIMAGE_INSTANCE_DOMAIN (value), window));
|
|
650 }
|
|
651
|
|
652 return 0;
|
|
653 }
|
|
654
|
|
655 void
|
|
656 check_window_subwindow_cache (struct window* w)
|
|
657 {
|
793
|
658 Lisp_Object window = wrap_window (w);
|
|
659
|
442
|
660
|
|
661 assert (!NILP (w->subwindow_instance_cache));
|
|
662 elisp_maphash (check_instance_cache_mapper,
|
|
663 w->subwindow_instance_cache,
|
|
664 LISP_TO_VOID (window));
|
|
665 }
|
|
666
|
|
667 void
|
|
668 check_image_instance_structure (Lisp_Object instance)
|
|
669 {
|
|
670 /* Weird nothing images exist at startup when the console is
|
|
671 deleted. */
|
|
672 if (!NOTHING_IMAGE_INSTANCEP (instance))
|
|
673 {
|
|
674 assert (DOMAIN_LIVE_P (instance));
|
|
675 assert (VECTORP (XIMAGE_INSTANCE_INSTANTIATOR (instance)));
|
|
676 }
|
|
677 if (WINDOWP (XIMAGE_INSTANCE_DOMAIN (instance)))
|
|
678 check_window_subwindow_cache
|
|
679 (XWINDOW (XIMAGE_INSTANCE_DOMAIN (instance)));
|
|
680 }
|
|
681 #endif
|
|
682
|
|
683 /* Determine what kind of domain governs the image instance.
|
|
684 Verify that the given domain is at least as specific, and extract
|
|
685 the governing domain from it. */
|
428
|
686 static Lisp_Object
|
442
|
687 get_image_instantiator_governing_domain (Lisp_Object instantiator,
|
|
688 Lisp_Object domain)
|
|
689 {
|
|
690 int governing_domain;
|
|
691
|
|
692 struct image_instantiator_methods *meths =
|
450
|
693 decode_image_instantiator_format (INSTANTIATOR_TYPE (instantiator),
|
442
|
694 ERROR_ME);
|
|
695 governing_domain = IIFORMAT_METH_OR_GIVEN (meths, governing_domain, (),
|
|
696 GOVERNING_DOMAIN_DEVICE);
|
|
697
|
|
698 if (governing_domain == GOVERNING_DOMAIN_WINDOW
|
|
699 && NILP (DOMAIN_WINDOW (domain)))
|
563
|
700 invalid_argument_2
|
|
701 ("Domain for this instantiator must be resolvable to a window",
|
|
702 instantiator, domain);
|
442
|
703 else if (governing_domain == GOVERNING_DOMAIN_FRAME
|
|
704 && NILP (DOMAIN_FRAME (domain)))
|
563
|
705 invalid_argument_2
|
442
|
706 ("Domain for this instantiator must be resolvable to a frame",
|
|
707 instantiator, domain);
|
|
708
|
|
709 if (governing_domain == GOVERNING_DOMAIN_WINDOW)
|
|
710 domain = DOMAIN_WINDOW (domain);
|
|
711 else if (governing_domain == GOVERNING_DOMAIN_FRAME)
|
|
712 domain = DOMAIN_FRAME (domain);
|
|
713 else if (governing_domain == GOVERNING_DOMAIN_DEVICE)
|
|
714 domain = DOMAIN_DEVICE (domain);
|
|
715 else
|
|
716 abort ();
|
|
717
|
|
718 return domain;
|
|
719 }
|
|
720
|
|
721 Lisp_Object
|
428
|
722 normalize_image_instantiator (Lisp_Object instantiator,
|
|
723 Lisp_Object contype,
|
|
724 Lisp_Object dest_mask)
|
|
725 {
|
|
726 if (IMAGE_INSTANCEP (instantiator))
|
|
727 return instantiator;
|
|
728
|
|
729 if (STRINGP (instantiator))
|
|
730 instantiator = process_image_string_instantiator (instantiator, contype,
|
|
731 XINT (dest_mask));
|
442
|
732 /* Subsequent validation will pick this up. */
|
|
733 if (!VECTORP (instantiator))
|
|
734 return instantiator;
|
428
|
735 /* We have to always store the actual pixmap data and not the
|
|
736 filename even though this is a potential memory pig. We have to
|
|
737 do this because it is quite possible that we will need to
|
|
738 instantiate a new instance of the pixmap and the file will no
|
|
739 longer exist (e.g. w3 pixmaps are almost always from temporary
|
|
740 files). */
|
|
741 {
|
|
742 struct gcpro gcpro1;
|
|
743 struct image_instantiator_methods *meths;
|
|
744
|
|
745 GCPRO1 (instantiator);
|
440
|
746
|
450
|
747 meths = decode_image_instantiator_format (INSTANTIATOR_TYPE (instantiator),
|
428
|
748 ERROR_ME);
|
|
749 RETURN_UNGCPRO (IIFORMAT_METH_OR_GIVEN (meths, normalize,
|
442
|
750 (instantiator, contype, dest_mask),
|
428
|
751 instantiator));
|
|
752 }
|
|
753 }
|
|
754
|
|
755 static Lisp_Object
|
442
|
756 instantiate_image_instantiator (Lisp_Object governing_domain,
|
|
757 Lisp_Object domain,
|
428
|
758 Lisp_Object instantiator,
|
|
759 Lisp_Object pointer_fg, Lisp_Object pointer_bg,
|
438
|
760 int dest_mask, Lisp_Object glyph)
|
428
|
761 {
|
442
|
762 Lisp_Object ii = allocate_image_instance (governing_domain,
|
|
763 IMAGE_INSTANCEP (domain) ?
|
|
764 domain : glyph, instantiator);
|
|
765 Lisp_Image_Instance* p = XIMAGE_INSTANCE (ii);
|
|
766 struct image_instantiator_methods *meths, *device_meths;
|
428
|
767 struct gcpro gcpro1;
|
|
768
|
|
769 GCPRO1 (ii);
|
450
|
770 if (!valid_image_instantiator_format_p (INSTANTIATOR_TYPE (instantiator),
|
442
|
771 DOMAIN_DEVICE (governing_domain)))
|
563
|
772 invalid_argument
|
428
|
773 ("Image instantiator format is invalid in this locale.",
|
|
774 instantiator);
|
|
775
|
450
|
776 meths = decode_image_instantiator_format (INSTANTIATOR_TYPE (instantiator),
|
428
|
777 ERROR_ME);
|
|
778 MAYBE_IIFORMAT_METH (meths, instantiate, (ii, instantiator, pointer_fg,
|
|
779 pointer_bg, dest_mask, domain));
|
440
|
780
|
442
|
781 /* Now do device specific instantiation. */
|
|
782 device_meths = decode_device_ii_format (DOMAIN_DEVICE (governing_domain),
|
450
|
783 INSTANTIATOR_TYPE (instantiator),
|
442
|
784 ERROR_ME_NOT);
|
|
785
|
|
786 if (!HAS_IIFORMAT_METH_P (meths, instantiate)
|
|
787 && (!device_meths || !HAS_IIFORMAT_METH_P (device_meths, instantiate)))
|
563
|
788 invalid_argument
|
428
|
789 ("Don't know how to instantiate this image instantiator?",
|
|
790 instantiator);
|
442
|
791
|
|
792 /* In general native window system methods will require sane
|
|
793 geometry values, thus the instance needs to have been laid-out
|
|
794 before they get called. */
|
|
795 image_instance_layout (ii, XIMAGE_INSTANCE_WIDTH (ii),
|
|
796 XIMAGE_INSTANCE_HEIGHT (ii),
|
|
797 IMAGE_UNCHANGED_GEOMETRY,
|
|
798 IMAGE_UNCHANGED_GEOMETRY, domain);
|
|
799
|
|
800 MAYBE_IIFORMAT_METH (device_meths, instantiate, (ii, instantiator, pointer_fg,
|
|
801 pointer_bg, dest_mask, domain));
|
|
802 /* Do post instantiation. */
|
|
803 MAYBE_IIFORMAT_METH (meths, post_instantiate, (ii, instantiator, domain));
|
|
804 MAYBE_IIFORMAT_METH (device_meths, post_instantiate, (ii, instantiator, domain));
|
|
805
|
|
806 /* We're done. */
|
|
807 IMAGE_INSTANCE_INITIALIZED (p) = 1;
|
|
808 /* Now that we're done verify that we really are laid out. */
|
|
809 if (IMAGE_INSTANCE_LAYOUT_CHANGED (p))
|
|
810 image_instance_layout (ii, XIMAGE_INSTANCE_WIDTH (ii),
|
|
811 XIMAGE_INSTANCE_HEIGHT (ii),
|
|
812 IMAGE_UNCHANGED_GEOMETRY,
|
|
813 IMAGE_UNCHANGED_GEOMETRY, domain);
|
|
814
|
|
815 /* We *must* have a clean image at this point. */
|
|
816 IMAGE_INSTANCE_TEXT_CHANGED (p) = 0;
|
|
817 IMAGE_INSTANCE_SIZE_CHANGED (p) = 0;
|
|
818 IMAGE_INSTANCE_LAYOUT_CHANGED (p) = 0;
|
|
819 IMAGE_INSTANCE_DIRTYP (p) = 0;
|
|
820
|
|
821 assert ( XIMAGE_INSTANCE_HEIGHT (ii) >= 0
|
|
822 && XIMAGE_INSTANCE_WIDTH (ii) >= 0 );
|
|
823
|
|
824 ERROR_CHECK_IMAGE_INSTANCE (ii);
|
|
825
|
|
826 RETURN_UNGCPRO (ii);
|
428
|
827 }
|
|
828
|
|
829
|
|
830 /****************************************************************************
|
|
831 * Image-Instance Object *
|
|
832 ****************************************************************************/
|
|
833
|
|
834 Lisp_Object Qimage_instancep;
|
|
835
|
|
836 static Lisp_Object
|
|
837 mark_image_instance (Lisp_Object obj)
|
|
838 {
|
440
|
839 Lisp_Image_Instance *i = XIMAGE_INSTANCE (obj);
|
428
|
840
|
442
|
841 /* #### I want to check the instance here, but there are way too
|
|
842 many instances of the instance being marked while the domain is
|
|
843 dead. For instance you can get marked through an event when using
|
|
844 callback_ex.*/
|
|
845 #if 0
|
|
846 ERROR_CHECK_IMAGE_INSTANCE (obj);
|
|
847 #endif
|
|
848
|
428
|
849 mark_object (i->name);
|
442
|
850 mark_object (i->instantiator);
|
|
851 /* Is this legal in marking? We may get in the situation where the
|
|
852 domain has been deleted - making the instance unusable. It seems
|
|
853 better to remove the domain so that it can be finalized. */
|
|
854 if (!DOMAIN_LIVE_P (i->domain))
|
|
855 i->domain = Qnil;
|
|
856 else
|
|
857 mark_object (i->domain);
|
|
858
|
438
|
859 /* We don't mark the glyph reference since that would create a
|
442
|
860 circularity preventing GC. Ditto the instantiator. */
|
428
|
861 switch (IMAGE_INSTANCE_TYPE (i))
|
|
862 {
|
|
863 case IMAGE_TEXT:
|
|
864 mark_object (IMAGE_INSTANCE_TEXT_STRING (i));
|
|
865 break;
|
|
866 case IMAGE_MONO_PIXMAP:
|
|
867 case IMAGE_COLOR_PIXMAP:
|
|
868 mark_object (IMAGE_INSTANCE_PIXMAP_FILENAME (i));
|
|
869 mark_object (IMAGE_INSTANCE_PIXMAP_MASK_FILENAME (i));
|
|
870 mark_object (IMAGE_INSTANCE_PIXMAP_HOTSPOT_X (i));
|
|
871 mark_object (IMAGE_INSTANCE_PIXMAP_HOTSPOT_Y (i));
|
|
872 mark_object (IMAGE_INSTANCE_PIXMAP_FG (i));
|
|
873 mark_object (IMAGE_INSTANCE_PIXMAP_BG (i));
|
|
874 break;
|
|
875
|
|
876 case IMAGE_WIDGET:
|
|
877 mark_object (IMAGE_INSTANCE_WIDGET_TYPE (i));
|
|
878 mark_object (IMAGE_INSTANCE_WIDGET_PROPS (i));
|
442
|
879 mark_object (IMAGE_INSTANCE_SUBWINDOW_FACE (i));
|
428
|
880 mark_object (IMAGE_INSTANCE_WIDGET_ITEMS (i));
|
442
|
881 mark_object (IMAGE_INSTANCE_LAYOUT_CHILDREN (i));
|
|
882 mark_object (IMAGE_INSTANCE_WIDGET_PENDING_ITEMS (i));
|
|
883 mark_object (IMAGE_INSTANCE_WIDGET_HEIGHT_SUBR (i));
|
|
884 mark_object (IMAGE_INSTANCE_WIDGET_WIDTH_SUBR (i));
|
428
|
885 case IMAGE_SUBWINDOW:
|
|
886 break;
|
|
887
|
|
888 default:
|
|
889 break;
|
|
890 }
|
|
891
|
442
|
892 /* The image may have been previously finalized (yes that's weird,
|
|
893 see Fdelete_frame() and mark_window_as_deleted()), in which case
|
|
894 the domain will be nil, so cope with this. */
|
|
895 if (!NILP (IMAGE_INSTANCE_DEVICE (i)))
|
|
896 MAYBE_DEVMETH (XDEVICE (IMAGE_INSTANCE_DEVICE (i)),
|
|
897 mark_image_instance, (i));
|
428
|
898
|
|
899 return i->device;
|
|
900 }
|
|
901
|
|
902 static void
|
|
903 print_image_instance (Lisp_Object obj, Lisp_Object printcharfun,
|
|
904 int escapeflag)
|
|
905 {
|
|
906 char buf[100];
|
440
|
907 Lisp_Image_Instance *ii = XIMAGE_INSTANCE (obj);
|
428
|
908
|
|
909 if (print_readably)
|
563
|
910 printing_unreadable_object ("#<image-instance 0x%x>",
|
428
|
911 ii->header.uid);
|
|
912 write_c_string ("#<image-instance (", printcharfun);
|
|
913 print_internal (Fimage_instance_type (obj), printcharfun, 0);
|
|
914 write_c_string (") ", printcharfun);
|
|
915 if (!NILP (ii->name))
|
|
916 {
|
|
917 print_internal (ii->name, printcharfun, 1);
|
|
918 write_c_string (" ", printcharfun);
|
|
919 }
|
|
920 write_c_string ("on ", printcharfun);
|
442
|
921 print_internal (ii->domain, printcharfun, 0);
|
428
|
922 write_c_string (" ", printcharfun);
|
|
923 switch (IMAGE_INSTANCE_TYPE (ii))
|
|
924 {
|
|
925 case IMAGE_NOTHING:
|
|
926 break;
|
|
927
|
|
928 case IMAGE_TEXT:
|
|
929 print_internal (IMAGE_INSTANCE_TEXT_STRING (ii), printcharfun, 1);
|
|
930 break;
|
|
931
|
|
932 case IMAGE_MONO_PIXMAP:
|
|
933 case IMAGE_COLOR_PIXMAP:
|
|
934 case IMAGE_POINTER:
|
|
935 if (STRINGP (IMAGE_INSTANCE_PIXMAP_FILENAME (ii)))
|
|
936 {
|
771
|
937 Intbyte *s;
|
428
|
938 Lisp_Object filename = IMAGE_INSTANCE_PIXMAP_FILENAME (ii);
|
771
|
939 s = qxestrrchr (XSTRING_DATA (filename), '/');
|
428
|
940 if (s)
|
771
|
941 print_internal (build_intstring (s + 1), printcharfun, 1);
|
428
|
942 else
|
|
943 print_internal (filename, printcharfun, 1);
|
|
944 }
|
|
945 if (IMAGE_INSTANCE_PIXMAP_DEPTH (ii) > 1)
|
|
946 sprintf (buf, " %dx%dx%d", IMAGE_INSTANCE_PIXMAP_WIDTH (ii),
|
|
947 IMAGE_INSTANCE_PIXMAP_HEIGHT (ii),
|
|
948 IMAGE_INSTANCE_PIXMAP_DEPTH (ii));
|
|
949 else
|
|
950 sprintf (buf, " %dx%d", IMAGE_INSTANCE_PIXMAP_WIDTH (ii),
|
|
951 IMAGE_INSTANCE_PIXMAP_HEIGHT (ii));
|
|
952 write_c_string (buf, printcharfun);
|
|
953 if (!NILP (IMAGE_INSTANCE_PIXMAP_HOTSPOT_X (ii)) ||
|
|
954 !NILP (IMAGE_INSTANCE_PIXMAP_HOTSPOT_Y (ii)))
|
|
955 {
|
|
956 write_c_string (" @", printcharfun);
|
|
957 if (!NILP (IMAGE_INSTANCE_PIXMAP_HOTSPOT_X (ii)))
|
|
958 {
|
|
959 long_to_string (buf, XINT (IMAGE_INSTANCE_PIXMAP_HOTSPOT_X (ii)));
|
|
960 write_c_string (buf, printcharfun);
|
|
961 }
|
|
962 else
|
|
963 write_c_string ("??", printcharfun);
|
|
964 write_c_string (",", printcharfun);
|
|
965 if (!NILP (IMAGE_INSTANCE_PIXMAP_HOTSPOT_Y (ii)))
|
|
966 {
|
|
967 long_to_string (buf, XINT (IMAGE_INSTANCE_PIXMAP_HOTSPOT_Y (ii)));
|
|
968 write_c_string (buf, printcharfun);
|
|
969 }
|
|
970 else
|
|
971 write_c_string ("??", printcharfun);
|
|
972 }
|
|
973 if (!NILP (IMAGE_INSTANCE_PIXMAP_FG (ii)) ||
|
|
974 !NILP (IMAGE_INSTANCE_PIXMAP_BG (ii)))
|
|
975 {
|
|
976 write_c_string (" (", printcharfun);
|
|
977 if (!NILP (IMAGE_INSTANCE_PIXMAP_FG (ii)))
|
|
978 {
|
|
979 print_internal
|
|
980 (XCOLOR_INSTANCE
|
|
981 (IMAGE_INSTANCE_PIXMAP_FG (ii))->name, printcharfun, 0);
|
|
982 }
|
|
983 write_c_string ("/", printcharfun);
|
|
984 if (!NILP (IMAGE_INSTANCE_PIXMAP_BG (ii)))
|
|
985 {
|
|
986 print_internal
|
|
987 (XCOLOR_INSTANCE
|
|
988 (IMAGE_INSTANCE_PIXMAP_BG (ii))->name, printcharfun, 0);
|
|
989 }
|
|
990 write_c_string (")", printcharfun);
|
|
991 }
|
|
992 break;
|
|
993
|
|
994 case IMAGE_WIDGET:
|
442
|
995 print_internal (IMAGE_INSTANCE_WIDGET_TYPE (ii), printcharfun, 0);
|
|
996
|
|
997 if (GUI_ITEMP (IMAGE_INSTANCE_WIDGET_ITEM (ii)))
|
|
998 {
|
|
999 write_c_string (" ", printcharfun);
|
|
1000 print_internal (IMAGE_INSTANCE_WIDGET_TEXT (ii), printcharfun, 1);
|
|
1001 }
|
|
1002
|
428
|
1003 if (!NILP (IMAGE_INSTANCE_WIDGET_FACE (ii)))
|
|
1004 {
|
442
|
1005 write_c_string (" face=", printcharfun);
|
428
|
1006 print_internal
|
|
1007 (IMAGE_INSTANCE_WIDGET_FACE (ii), printcharfun, 0);
|
|
1008 }
|
454
|
1009 /* fallthrough */
|
428
|
1010
|
|
1011 case IMAGE_SUBWINDOW:
|
442
|
1012 sprintf (buf, " %dx%d", IMAGE_INSTANCE_WIDTH (ii),
|
|
1013 IMAGE_INSTANCE_HEIGHT (ii));
|
428
|
1014 write_c_string (buf, printcharfun);
|
|
1015
|
|
1016 /* This is stolen from frame.c. Subwindows are strange in that they
|
|
1017 are specific to a particular frame so we want to print in their
|
|
1018 description what that frame is. */
|
|
1019
|
|
1020 write_c_string (" on #<", printcharfun);
|
|
1021 {
|
442
|
1022 struct frame* f = XFRAME (IMAGE_INSTANCE_FRAME (ii));
|
440
|
1023
|
428
|
1024 if (!FRAME_LIVE_P (f))
|
|
1025 write_c_string ("dead", printcharfun);
|
440
|
1026 else
|
428
|
1027 write_c_string (DEVICE_TYPE_NAME (XDEVICE (FRAME_DEVICE (f))),
|
|
1028 printcharfun);
|
|
1029 }
|
442
|
1030 write_c_string ("-frame>", printcharfun);
|
428
|
1031 sprintf (buf, " 0x%p", IMAGE_INSTANCE_SUBWINDOW_ID (ii));
|
|
1032 write_c_string (buf, printcharfun);
|
440
|
1033
|
428
|
1034 break;
|
|
1035
|
|
1036 default:
|
|
1037 abort ();
|
|
1038 }
|
|
1039
|
442
|
1040 MAYBE_DEVMETH (DOMAIN_XDEVICE (ii->domain), print_image_instance,
|
428
|
1041 (ii, printcharfun, escapeflag));
|
|
1042 sprintf (buf, " 0x%x>", ii->header.uid);
|
|
1043 write_c_string (buf, printcharfun);
|
|
1044 }
|
|
1045
|
|
1046 static void
|
|
1047 finalize_image_instance (void *header, int for_disksave)
|
|
1048 {
|
440
|
1049 Lisp_Image_Instance *i = (Lisp_Image_Instance *) header;
|
428
|
1050
|
442
|
1051 /* objects like this exist at dump time, so don't bomb out. */
|
|
1052 if (IMAGE_INSTANCE_TYPE (i) == IMAGE_NOTHING
|
|
1053 ||
|
|
1054 NILP (IMAGE_INSTANCE_DEVICE (i)))
|
428
|
1055 return;
|
|
1056 if (for_disksave) finalose (i);
|
|
1057
|
442
|
1058 /* We can't use the domain here, because it might have
|
|
1059 disappeared. */
|
|
1060 MAYBE_DEVMETH (XDEVICE (IMAGE_INSTANCE_DEVICE (i)),
|
|
1061 finalize_image_instance, (i));
|
|
1062
|
|
1063 /* Make sure we don't try this twice. */
|
|
1064 IMAGE_INSTANCE_DEVICE (i) = Qnil;
|
428
|
1065 }
|
|
1066
|
|
1067 static int
|
|
1068 image_instance_equal (Lisp_Object obj1, Lisp_Object obj2, int depth)
|
|
1069 {
|
440
|
1070 Lisp_Image_Instance *i1 = XIMAGE_INSTANCE (obj1);
|
|
1071 Lisp_Image_Instance *i2 = XIMAGE_INSTANCE (obj2);
|
442
|
1072
|
|
1073 ERROR_CHECK_IMAGE_INSTANCE (obj1);
|
|
1074 ERROR_CHECK_IMAGE_INSTANCE (obj2);
|
|
1075
|
|
1076 if (!EQ (IMAGE_INSTANCE_DOMAIN (i1),
|
|
1077 IMAGE_INSTANCE_DOMAIN (i2))
|
|
1078 || IMAGE_INSTANCE_TYPE (i1) != IMAGE_INSTANCE_TYPE (i2)
|
438
|
1079 || IMAGE_INSTANCE_WIDTH (i1) != IMAGE_INSTANCE_WIDTH (i2)
|
442
|
1080 || IMAGE_INSTANCE_MARGIN_WIDTH (i1) !=
|
|
1081 IMAGE_INSTANCE_MARGIN_WIDTH (i2)
|
438
|
1082 || IMAGE_INSTANCE_HEIGHT (i1) != IMAGE_INSTANCE_HEIGHT (i2)
|
|
1083 || IMAGE_INSTANCE_XOFFSET (i1) != IMAGE_INSTANCE_XOFFSET (i2)
|
|
1084 || IMAGE_INSTANCE_YOFFSET (i1) != IMAGE_INSTANCE_YOFFSET (i2))
|
428
|
1085 return 0;
|
|
1086 if (!internal_equal (IMAGE_INSTANCE_NAME (i1), IMAGE_INSTANCE_NAME (i2),
|
|
1087 depth + 1))
|
|
1088 return 0;
|
442
|
1089 if (!internal_equal (IMAGE_INSTANCE_INSTANTIATOR (i1),
|
|
1090 IMAGE_INSTANCE_INSTANTIATOR (i2),
|
|
1091 depth + 1))
|
|
1092 return 0;
|
428
|
1093
|
|
1094 switch (IMAGE_INSTANCE_TYPE (i1))
|
|
1095 {
|
|
1096 case IMAGE_NOTHING:
|
|
1097 break;
|
|
1098
|
|
1099 case IMAGE_TEXT:
|
|
1100 if (!internal_equal (IMAGE_INSTANCE_TEXT_STRING (i1),
|
|
1101 IMAGE_INSTANCE_TEXT_STRING (i2),
|
|
1102 depth + 1))
|
|
1103 return 0;
|
|
1104 break;
|
|
1105
|
|
1106 case IMAGE_MONO_PIXMAP:
|
|
1107 case IMAGE_COLOR_PIXMAP:
|
|
1108 case IMAGE_POINTER:
|
438
|
1109 if (!(IMAGE_INSTANCE_PIXMAP_DEPTH (i1) ==
|
428
|
1110 IMAGE_INSTANCE_PIXMAP_DEPTH (i2) &&
|
|
1111 IMAGE_INSTANCE_PIXMAP_SLICE (i1) ==
|
|
1112 IMAGE_INSTANCE_PIXMAP_SLICE (i2) &&
|
|
1113 EQ (IMAGE_INSTANCE_PIXMAP_HOTSPOT_X (i1),
|
|
1114 IMAGE_INSTANCE_PIXMAP_HOTSPOT_X (i2)) &&
|
|
1115 EQ (IMAGE_INSTANCE_PIXMAP_HOTSPOT_Y (i1),
|
|
1116 IMAGE_INSTANCE_PIXMAP_HOTSPOT_Y (i2)) &&
|
|
1117 internal_equal (IMAGE_INSTANCE_PIXMAP_FILENAME (i1),
|
|
1118 IMAGE_INSTANCE_PIXMAP_FILENAME (i2),
|
|
1119 depth + 1) &&
|
|
1120 internal_equal (IMAGE_INSTANCE_PIXMAP_MASK_FILENAME (i1),
|
|
1121 IMAGE_INSTANCE_PIXMAP_MASK_FILENAME (i2),
|
|
1122 depth + 1)))
|
|
1123 return 0;
|
|
1124 break;
|
|
1125
|
|
1126 case IMAGE_WIDGET:
|
|
1127 if (!(EQ (IMAGE_INSTANCE_WIDGET_TYPE (i1),
|
|
1128 IMAGE_INSTANCE_WIDGET_TYPE (i2))
|
438
|
1129 && IMAGE_INSTANCE_SUBWINDOW_ID (i1) ==
|
|
1130 IMAGE_INSTANCE_SUBWINDOW_ID (i2)
|
442
|
1131 &&
|
|
1132 EQ (IMAGE_INSTANCE_WIDGET_FACE (i1),
|
|
1133 IMAGE_INSTANCE_WIDGET_TYPE (i2))
|
428
|
1134 && internal_equal (IMAGE_INSTANCE_WIDGET_ITEMS (i1),
|
|
1135 IMAGE_INSTANCE_WIDGET_ITEMS (i2),
|
|
1136 depth + 1)
|
442
|
1137 && internal_equal (IMAGE_INSTANCE_LAYOUT_CHILDREN (i1),
|
|
1138 IMAGE_INSTANCE_LAYOUT_CHILDREN (i2),
|
|
1139 depth + 1)
|
428
|
1140 && internal_equal (IMAGE_INSTANCE_WIDGET_PROPS (i1),
|
|
1141 IMAGE_INSTANCE_WIDGET_PROPS (i2),
|
|
1142 depth + 1)
|
442
|
1143 && internal_equal (IMAGE_INSTANCE_WIDGET_WIDTH_SUBR (i1),
|
|
1144 IMAGE_INSTANCE_WIDGET_WIDTH_SUBR (i2),
|
|
1145 depth + 1)
|
|
1146 && internal_equal (IMAGE_INSTANCE_WIDGET_HEIGHT_SUBR (i1),
|
|
1147 IMAGE_INSTANCE_WIDGET_HEIGHT_SUBR (i2),
|
|
1148 depth + 1)
|
428
|
1149 ))
|
|
1150 return 0;
|
438
|
1151 break;
|
440
|
1152
|
428
|
1153 case IMAGE_SUBWINDOW:
|
438
|
1154 if (!(IMAGE_INSTANCE_SUBWINDOW_ID (i1) ==
|
428
|
1155 IMAGE_INSTANCE_SUBWINDOW_ID (i2)))
|
|
1156 return 0;
|
|
1157 break;
|
|
1158
|
|
1159 default:
|
|
1160 abort ();
|
|
1161 }
|
|
1162
|
442
|
1163 return DEVMETH_OR_GIVEN (DOMAIN_XDEVICE (i1->domain),
|
|
1164 image_instance_equal, (i1, i2, depth), 1);
|
|
1165 }
|
|
1166
|
|
1167 /* Image instance domain manipulators. We can't error check in these
|
|
1168 otherwise we get into infinite recursion. */
|
|
1169 Lisp_Object
|
|
1170 image_instance_device (Lisp_Object instance)
|
|
1171 {
|
|
1172 return XIMAGE_INSTANCE_DEVICE (instance);
|
|
1173 }
|
|
1174
|
|
1175 Lisp_Object
|
|
1176 image_instance_frame (Lisp_Object instance)
|
|
1177 {
|
|
1178 return XIMAGE_INSTANCE_FRAME (instance);
|
|
1179 }
|
|
1180
|
|
1181 Lisp_Object
|
|
1182 image_instance_window (Lisp_Object instance)
|
|
1183 {
|
|
1184 return DOMAIN_WINDOW (XIMAGE_INSTANCE_DOMAIN (instance));
|
|
1185 }
|
|
1186
|
|
1187 int
|
|
1188 image_instance_live_p (Lisp_Object instance)
|
|
1189 {
|
|
1190 return DOMAIN_LIVE_P (XIMAGE_INSTANCE_DOMAIN (instance));
|
428
|
1191 }
|
|
1192
|
665
|
1193 static Hashcode
|
428
|
1194 image_instance_hash (Lisp_Object obj, int depth)
|
|
1195 {
|
440
|
1196 Lisp_Image_Instance *i = XIMAGE_INSTANCE (obj);
|
665
|
1197 Hashcode hash = HASH5 (LISP_HASH (IMAGE_INSTANCE_DOMAIN (i)),
|
647
|
1198 IMAGE_INSTANCE_WIDTH (i),
|
|
1199 IMAGE_INSTANCE_MARGIN_WIDTH (i),
|
|
1200 IMAGE_INSTANCE_HEIGHT (i),
|
|
1201 internal_hash (IMAGE_INSTANCE_INSTANTIATOR (i),
|
|
1202 depth + 1));
|
442
|
1203
|
|
1204 ERROR_CHECK_IMAGE_INSTANCE (obj);
|
428
|
1205
|
|
1206 switch (IMAGE_INSTANCE_TYPE (i))
|
|
1207 {
|
|
1208 case IMAGE_NOTHING:
|
|
1209 break;
|
|
1210
|
|
1211 case IMAGE_TEXT:
|
|
1212 hash = HASH2 (hash, internal_hash (IMAGE_INSTANCE_TEXT_STRING (i),
|
|
1213 depth + 1));
|
|
1214 break;
|
|
1215
|
|
1216 case IMAGE_MONO_PIXMAP:
|
|
1217 case IMAGE_COLOR_PIXMAP:
|
|
1218 case IMAGE_POINTER:
|
438
|
1219 hash = HASH4 (hash, IMAGE_INSTANCE_PIXMAP_DEPTH (i),
|
428
|
1220 IMAGE_INSTANCE_PIXMAP_SLICE (i),
|
|
1221 internal_hash (IMAGE_INSTANCE_PIXMAP_FILENAME (i),
|
|
1222 depth + 1));
|
|
1223 break;
|
|
1224
|
|
1225 case IMAGE_WIDGET:
|
442
|
1226 /* We need the hash to be equivalent to what should be
|
|
1227 displayed. */
|
|
1228 hash = HASH5 (hash,
|
|
1229 LISP_HASH (IMAGE_INSTANCE_WIDGET_TYPE (i)),
|
428
|
1230 internal_hash (IMAGE_INSTANCE_WIDGET_PROPS (i), depth + 1),
|
442
|
1231 internal_hash (IMAGE_INSTANCE_WIDGET_ITEMS (i), depth + 1),
|
|
1232 internal_hash (IMAGE_INSTANCE_LAYOUT_CHILDREN (i),
|
|
1233 depth + 1));
|
438
|
1234 case IMAGE_SUBWINDOW:
|
442
|
1235 hash = HASH2 (hash, (EMACS_INT) IMAGE_INSTANCE_SUBWINDOW_ID (i));
|
438
|
1236 break;
|
|
1237
|
428
|
1238 default:
|
|
1239 abort ();
|
|
1240 }
|
|
1241
|
442
|
1242 return HASH2 (hash, DEVMETH_OR_GIVEN
|
|
1243 (XDEVICE (image_instance_device (obj)),
|
|
1244 image_instance_hash, (i, depth),
|
|
1245 0));
|
428
|
1246 }
|
|
1247
|
|
1248 DEFINE_LRECORD_IMPLEMENTATION ("image-instance", image_instance,
|
|
1249 mark_image_instance, print_image_instance,
|
|
1250 finalize_image_instance, image_instance_equal,
|
|
1251 image_instance_hash, 0,
|
440
|
1252 Lisp_Image_Instance);
|
428
|
1253
|
|
1254 static Lisp_Object
|
442
|
1255 allocate_image_instance (Lisp_Object governing_domain, Lisp_Object parent,
|
|
1256 Lisp_Object instantiator)
|
428
|
1257 {
|
440
|
1258 Lisp_Image_Instance *lp =
|
|
1259 alloc_lcrecord_type (Lisp_Image_Instance, &lrecord_image_instance);
|
428
|
1260 Lisp_Object val;
|
|
1261
|
|
1262 zero_lcrecord (lp);
|
442
|
1263 /* It's not possible to simply keep a record of the domain in which
|
|
1264 the instance was instantiated. This is because caching may mean
|
|
1265 that the domain becomes invalid but the instance remains
|
|
1266 valid. However, the only truly relevant domain is the domain in
|
|
1267 which the instance is cached since this is the one that will be
|
|
1268 common to the instances. */
|
|
1269 lp->domain = governing_domain;
|
|
1270 /* The cache domain is not quite sufficient since the domain can get
|
|
1271 deleted before the image instance does. We need to know the
|
|
1272 domain device in order to finalize the image instance
|
|
1273 properly. We therefore record the device also. */
|
|
1274 lp->device = DOMAIN_DEVICE (governing_domain);
|
428
|
1275 lp->type = IMAGE_NOTHING;
|
|
1276 lp->name = Qnil;
|
|
1277 lp->x_offset = 0;
|
|
1278 lp->y_offset = 0;
|
442
|
1279 lp->width = IMAGE_UNSPECIFIED_GEOMETRY;
|
|
1280 lp->margin_width = 0;
|
|
1281 lp->height = IMAGE_UNSPECIFIED_GEOMETRY;
|
|
1282 lp->parent = parent;
|
|
1283 lp->instantiator = instantiator;
|
|
1284 /* So that layouts get done. */
|
|
1285 lp->layout_changed = 1;
|
|
1286 lp->initialized = 0;
|
|
1287
|
793
|
1288 val = wrap_image_instance (lp);
|
442
|
1289 MARK_GLYPHS_CHANGED;
|
|
1290
|
428
|
1291 return val;
|
|
1292 }
|
|
1293
|
|
1294 static enum image_instance_type
|
578
|
1295 decode_image_instance_type (Lisp_Object type, Error_Behavior errb)
|
428
|
1296 {
|
|
1297 if (ERRB_EQ (errb, ERROR_ME))
|
|
1298 CHECK_SYMBOL (type);
|
|
1299
|
|
1300 if (EQ (type, Qnothing)) return IMAGE_NOTHING;
|
|
1301 if (EQ (type, Qtext)) return IMAGE_TEXT;
|
|
1302 if (EQ (type, Qmono_pixmap)) return IMAGE_MONO_PIXMAP;
|
|
1303 if (EQ (type, Qcolor_pixmap)) return IMAGE_COLOR_PIXMAP;
|
|
1304 if (EQ (type, Qpointer)) return IMAGE_POINTER;
|
|
1305 if (EQ (type, Qsubwindow)) return IMAGE_SUBWINDOW;
|
|
1306 if (EQ (type, Qwidget)) return IMAGE_WIDGET;
|
|
1307
|
563
|
1308 maybe_invalid_constant ("Invalid image-instance type", type,
|
428
|
1309 Qimage, errb);
|
|
1310
|
|
1311 return IMAGE_UNKNOWN; /* not reached */
|
|
1312 }
|
|
1313
|
|
1314 static Lisp_Object
|
|
1315 encode_image_instance_type (enum image_instance_type type)
|
|
1316 {
|
|
1317 switch (type)
|
|
1318 {
|
|
1319 case IMAGE_NOTHING: return Qnothing;
|
|
1320 case IMAGE_TEXT: return Qtext;
|
|
1321 case IMAGE_MONO_PIXMAP: return Qmono_pixmap;
|
|
1322 case IMAGE_COLOR_PIXMAP: return Qcolor_pixmap;
|
|
1323 case IMAGE_POINTER: return Qpointer;
|
|
1324 case IMAGE_SUBWINDOW: return Qsubwindow;
|
|
1325 case IMAGE_WIDGET: return Qwidget;
|
|
1326 default:
|
|
1327 abort ();
|
|
1328 }
|
|
1329
|
|
1330 return Qnil; /* not reached */
|
|
1331 }
|
|
1332
|
|
1333 static int
|
|
1334 decode_image_instance_type_list (Lisp_Object list)
|
|
1335 {
|
|
1336 Lisp_Object rest;
|
|
1337 int mask = 0;
|
|
1338
|
|
1339 if (NILP (list))
|
|
1340 return ~0;
|
|
1341
|
|
1342 if (!CONSP (list))
|
|
1343 {
|
|
1344 enum image_instance_type type =
|
|
1345 decode_image_instance_type (list, ERROR_ME);
|
|
1346 return image_instance_type_to_mask (type);
|
|
1347 }
|
|
1348
|
|
1349 EXTERNAL_LIST_LOOP (rest, list)
|
|
1350 {
|
|
1351 enum image_instance_type type =
|
|
1352 decode_image_instance_type (XCAR (rest), ERROR_ME);
|
|
1353 mask |= image_instance_type_to_mask (type);
|
|
1354 }
|
|
1355
|
|
1356 return mask;
|
|
1357 }
|
|
1358
|
|
1359 static Lisp_Object
|
|
1360 encode_image_instance_type_list (int mask)
|
|
1361 {
|
|
1362 int count = 0;
|
|
1363 Lisp_Object result = Qnil;
|
|
1364
|
|
1365 while (mask)
|
|
1366 {
|
|
1367 count++;
|
|
1368 if (mask & 1)
|
|
1369 result = Fcons (encode_image_instance_type
|
|
1370 ((enum image_instance_type) count), result);
|
|
1371 mask >>= 1;
|
|
1372 }
|
|
1373
|
|
1374 return Fnreverse (result);
|
|
1375 }
|
|
1376
|
|
1377 DOESNT_RETURN
|
|
1378 incompatible_image_types (Lisp_Object instantiator, int given_dest_mask,
|
|
1379 int desired_dest_mask)
|
|
1380 {
|
563
|
1381 signal_error_1
|
|
1382 (Qinvalid_argument,
|
428
|
1383 list2
|
771
|
1384 (emacs_sprintf_string_lisp
|
|
1385 ("No compatible image-instance types given: wanted one of %s, got %s",
|
|
1386 Qnil, 2, encode_image_instance_type_list (desired_dest_mask),
|
428
|
1387 encode_image_instance_type_list (given_dest_mask)),
|
|
1388 instantiator));
|
|
1389 }
|
|
1390
|
|
1391 static int
|
|
1392 valid_image_instance_type_p (Lisp_Object type)
|
|
1393 {
|
|
1394 return !NILP (memq_no_quit (type, Vimage_instance_type_list));
|
|
1395 }
|
|
1396
|
|
1397 DEFUN ("valid-image-instance-type-p", Fvalid_image_instance_type_p, 1, 1, 0, /*
|
|
1398 Given an IMAGE-INSTANCE-TYPE, return non-nil if it is valid.
|
|
1399 Valid types are some subset of 'nothing, 'text, 'mono-pixmap, 'color-pixmap,
|
442
|
1400 'pointer, 'subwindow, and 'widget, depending on how XEmacs was compiled.
|
428
|
1401 */
|
|
1402 (image_instance_type))
|
|
1403 {
|
|
1404 return valid_image_instance_type_p (image_instance_type) ? Qt : Qnil;
|
|
1405 }
|
|
1406
|
|
1407 DEFUN ("image-instance-type-list", Fimage_instance_type_list, 0, 0, 0, /*
|
|
1408 Return a list of valid image-instance types.
|
|
1409 */
|
|
1410 ())
|
|
1411 {
|
|
1412 return Fcopy_sequence (Vimage_instance_type_list);
|
|
1413 }
|
|
1414
|
578
|
1415 Error_Behavior
|
444
|
1416 decode_error_behavior_flag (Lisp_Object noerror)
|
|
1417 {
|
|
1418 if (NILP (noerror)) return ERROR_ME;
|
|
1419 else if (EQ (noerror, Qt)) return ERROR_ME_NOT;
|
793
|
1420 else if (EQ (noerror, Qdebug)) return ERROR_ME_DEBUG_WARN;
|
444
|
1421 else return ERROR_ME_WARN;
|
428
|
1422 }
|
|
1423
|
|
1424 Lisp_Object
|
578
|
1425 encode_error_behavior_flag (Error_Behavior errb)
|
428
|
1426 {
|
|
1427 if (ERRB_EQ (errb, ERROR_ME))
|
|
1428 return Qnil;
|
|
1429 else if (ERRB_EQ (errb, ERROR_ME_NOT))
|
|
1430 return Qt;
|
793
|
1431 else if (ERRB_EQ (errb, ERROR_ME_DEBUG_WARN))
|
|
1432 return Qdebug;
|
428
|
1433 else
|
|
1434 {
|
|
1435 assert (ERRB_EQ (errb, ERROR_ME_WARN));
|
|
1436 return Qwarning;
|
|
1437 }
|
|
1438 }
|
|
1439
|
442
|
1440 /* Recurse up the hierarchy looking for the topmost glyph. This means
|
|
1441 that instances in layouts will inherit face properties from their
|
|
1442 parent. */
|
|
1443 Lisp_Object image_instance_parent_glyph (Lisp_Image_Instance* ii)
|
|
1444 {
|
|
1445 if (IMAGE_INSTANCEP (IMAGE_INSTANCE_PARENT (ii)))
|
|
1446 {
|
|
1447 return image_instance_parent_glyph
|
|
1448 (XIMAGE_INSTANCE (IMAGE_INSTANCE_PARENT (ii)));
|
|
1449 }
|
|
1450 return IMAGE_INSTANCE_PARENT (ii);
|
|
1451 }
|
|
1452
|
428
|
1453 static Lisp_Object
|
442
|
1454 make_image_instance_1 (Lisp_Object data, Lisp_Object domain,
|
428
|
1455 Lisp_Object dest_types)
|
|
1456 {
|
|
1457 Lisp_Object ii;
|
|
1458 struct gcpro gcpro1;
|
|
1459 int dest_mask;
|
442
|
1460 Lisp_Object governing_domain;
|
|
1461
|
428
|
1462 if (IMAGE_INSTANCEP (data))
|
563
|
1463 invalid_argument ("Image instances not allowed here", data);
|
428
|
1464 image_validate (data);
|
442
|
1465 domain = decode_domain (domain);
|
|
1466 /* instantiate_image_instantiator() will abort if given an
|
|
1467 image instance ... */
|
428
|
1468 dest_mask = decode_image_instance_type_list (dest_types);
|
442
|
1469 data = normalize_image_instantiator (data,
|
|
1470 DEVICE_TYPE (DOMAIN_XDEVICE (domain)),
|
428
|
1471 make_int (dest_mask));
|
|
1472 GCPRO1 (data);
|
442
|
1473 /* After normalizing the data, it's always either an image instance (which
|
|
1474 we filtered out above) or a vector. */
|
450
|
1475 if (EQ (INSTANTIATOR_TYPE (data), Qinherit))
|
563
|
1476 invalid_argument ("Inheritance not allowed here", data);
|
442
|
1477 governing_domain =
|
|
1478 get_image_instantiator_governing_domain (data, domain);
|
|
1479 ii = instantiate_image_instantiator (governing_domain, domain, data,
|
438
|
1480 Qnil, Qnil, dest_mask, Qnil);
|
428
|
1481 RETURN_UNGCPRO (ii);
|
|
1482 }
|
|
1483
|
|
1484 DEFUN ("make-image-instance", Fmake_image_instance, 1, 4, 0, /*
|
|
1485 Return a new `image-instance' object.
|
|
1486
|
|
1487 Image-instance objects encapsulate the way a particular image (pixmap,
|
|
1488 etc.) is displayed on a particular device. In most circumstances, you
|
|
1489 do not need to directly create image instances; use a glyph instead.
|
|
1490 However, it may occasionally be useful to explicitly create image
|
|
1491 instances, if you want more control over the instantiation process.
|
|
1492
|
|
1493 DATA is an image instantiator, which describes the image; see
|
442
|
1494 `make-image-specifier' for a description of the allowed values.
|
428
|
1495
|
|
1496 DEST-TYPES should be a list of allowed image instance types that can
|
|
1497 be generated. The recognized image instance types are
|
|
1498
|
|
1499 'nothing
|
|
1500 Nothing is displayed.
|
|
1501 'text
|
|
1502 Displayed as text. The foreground and background colors and the
|
|
1503 font of the text are specified independent of the pixmap. Typically
|
|
1504 these attributes will come from the face of the surrounding text,
|
|
1505 unless a face is specified for the glyph in which the image appears.
|
|
1506 'mono-pixmap
|
|
1507 Displayed as a mono pixmap (a pixmap with only two colors where the
|
|
1508 foreground and background can be specified independent of the pixmap;
|
|
1509 typically the pixmap assumes the foreground and background colors of
|
|
1510 the text around it, unless a face is specified for the glyph in which
|
|
1511 the image appears).
|
|
1512 'color-pixmap
|
|
1513 Displayed as a color pixmap.
|
|
1514 'pointer
|
|
1515 Used as the mouse pointer for a window.
|
|
1516 'subwindow
|
|
1517 A child window that is treated as an image. This allows (e.g.)
|
|
1518 another program to be responsible for drawing into the window.
|
|
1519 'widget
|
|
1520 A child window that contains a window-system widget, e.g. a push
|
442
|
1521 button, text field, or slider.
|
|
1522
|
|
1523 The DEST-TYPES list is unordered. If multiple destination types are
|
|
1524 possible for a given instantiator, the "most natural" type for the
|
|
1525 instantiator's format is chosen. (For XBM, the most natural types are
|
|
1526 `mono-pixmap', followed by `color-pixmap', followed by `pointer'. For
|
|
1527 the other normal image formats, the most natural types are
|
|
1528 `color-pixmap', followed by `mono-pixmap', followed by `pointer'. For
|
|
1529 the string and formatted-string formats, the most natural types are
|
|
1530 `text', followed by `mono-pixmap' (not currently implemented),
|
|
1531 followed by `color-pixmap' (not currently implemented). For MS
|
|
1532 Windows resources, the most natural type for pointer resources is
|
|
1533 `pointer', and for the others it's `color-pixmap'. The other formats
|
|
1534 can only be instantiated as one type. (If you want to control more
|
|
1535 specifically the order of the types into which an image is
|
|
1536 instantiated, just call `make-image-instance' repeatedly until it
|
|
1537 succeeds, passing less and less preferred destination types each
|
|
1538 time.)
|
|
1539
|
|
1540 See `make-image-specifier' for a description of the different image
|
|
1541 instantiator formats.
|
428
|
1542
|
|
1543 If DEST-TYPES is omitted, all possible types are allowed.
|
|
1544
|
442
|
1545 DOMAIN specifies the domain to which the image instance will be attached.
|
|
1546 This domain is termed the \"governing domain\". The type of the governing
|
|
1547 domain depends on the image instantiator format. (Although, more correctly,
|
|
1548 it should probably depend on the image instance type.) For example, pixmap
|
|
1549 image instances are specific to a device, but widget image instances are
|
|
1550 specific to a particular XEmacs window because in order to display such a
|
|
1551 widget when two windows onto the same buffer want to display the widget,
|
|
1552 two separate underlying widgets must be created. (That's because a widget
|
|
1553 is actually a child window-system window, and all window-system windows have
|
|
1554 a unique existence on the screen.) This means that the governing domain for
|
|
1555 a pixmap image instance will be some device (most likely, the only existing
|
|
1556 device), whereas the governing domain for a widget image instance will be
|
|
1557 some XEmacs window.
|
|
1558
|
|
1559 If you specify an overly general DOMAIN (e.g. a frame when a window was
|
|
1560 wanted), an error is signaled. If you specify an overly specific DOMAIN
|
|
1561 \(e.g. a window when a device was wanted), the corresponding general domain
|
|
1562 is fetched and used instead. For `make-image-instance', it makes no
|
|
1563 difference whether you specify an overly specific domain or the properly
|
|
1564 general domain derived from it. However, it does matter when creating an
|
|
1565 image instance by instantiating a specifier or glyph (e.g. with
|
|
1566 `glyph-image-instance'), because the more specific domain causes spec lookup
|
|
1567 to start there and proceed to more general domains. (It would also matter
|
|
1568 when creating an image instance with an instantiator format of `inherit',
|
|
1569 but we currently disallow this. #### We should fix this.)
|
|
1570
|
|
1571 If omitted, DOMAIN defaults to the selected window.
|
|
1572
|
444
|
1573 NOERROR controls what happens when the image cannot be generated.
|
428
|
1574 If nil, an error message is generated. If t, no messages are
|
|
1575 generated and this function returns nil. If anything else, a warning
|
440
|
1576 message is generated and this function returns nil.
|
428
|
1577 */
|
444
|
1578 (data, domain, dest_types, noerror))
|
|
1579 {
|
578
|
1580 Error_Behavior errb = decode_error_behavior_flag (noerror);
|
428
|
1581
|
|
1582 return call_with_suspended_errors ((lisp_fn_t) make_image_instance_1,
|
|
1583 Qnil, Qimage, errb,
|
442
|
1584 3, data, domain, dest_types);
|
428
|
1585 }
|
|
1586
|
|
1587 DEFUN ("image-instance-p", Fimage_instance_p, 1, 1, 0, /*
|
|
1588 Return non-nil if OBJECT is an image instance.
|
|
1589 */
|
|
1590 (object))
|
|
1591 {
|
|
1592 return IMAGE_INSTANCEP (object) ? Qt : Qnil;
|
|
1593 }
|
|
1594
|
|
1595 DEFUN ("image-instance-type", Fimage_instance_type, 1, 1, 0, /*
|
|
1596 Return the type of the given image instance.
|
|
1597 The return value will be one of 'nothing, 'text, 'mono-pixmap,
|
|
1598 'color-pixmap, 'pointer, or 'subwindow.
|
|
1599 */
|
|
1600 (image_instance))
|
|
1601 {
|
|
1602 CHECK_IMAGE_INSTANCE (image_instance);
|
442
|
1603 ERROR_CHECK_IMAGE_INSTANCE (image_instance);
|
428
|
1604 return encode_image_instance_type (XIMAGE_INSTANCE_TYPE (image_instance));
|
|
1605 }
|
|
1606
|
|
1607 DEFUN ("image-instance-name", Fimage_instance_name, 1, 1, 0, /*
|
|
1608 Return the name of the given image instance.
|
|
1609 */
|
|
1610 (image_instance))
|
|
1611 {
|
|
1612 CHECK_IMAGE_INSTANCE (image_instance);
|
|
1613 return XIMAGE_INSTANCE_NAME (image_instance);
|
|
1614 }
|
|
1615
|
442
|
1616 DEFUN ("image-instance-domain", Fimage_instance_domain, 1, 1, 0, /*
|
|
1617 Return the governing domain of the given image instance.
|
|
1618 The governing domain of an image instance is the domain that the image
|
|
1619 instance is specific to. It is NOT necessarily the domain that was
|
|
1620 given to the call to `specifier-instance' that resulted in the creation
|
|
1621 of this image instance. See `make-image-instance' for more information
|
|
1622 on governing domains.
|
|
1623 */
|
|
1624 (image_instance))
|
|
1625 {
|
|
1626 CHECK_IMAGE_INSTANCE (image_instance);
|
|
1627 return XIMAGE_INSTANCE_DOMAIN (image_instance);
|
|
1628 }
|
|
1629
|
428
|
1630 DEFUN ("image-instance-string", Fimage_instance_string, 1, 1, 0, /*
|
|
1631 Return the string of the given image instance.
|
|
1632 This will only be non-nil for text image instances and widgets.
|
|
1633 */
|
|
1634 (image_instance))
|
|
1635 {
|
|
1636 CHECK_IMAGE_INSTANCE (image_instance);
|
|
1637 if (XIMAGE_INSTANCE_TYPE (image_instance) == IMAGE_TEXT)
|
|
1638 return XIMAGE_INSTANCE_TEXT_STRING (image_instance);
|
|
1639 else if (XIMAGE_INSTANCE_TYPE (image_instance) == IMAGE_WIDGET)
|
|
1640 return XIMAGE_INSTANCE_WIDGET_TEXT (image_instance);
|
|
1641 else
|
|
1642 return Qnil;
|
|
1643 }
|
|
1644
|
|
1645 DEFUN ("image-instance-property", Fimage_instance_property, 2, 2, 0, /*
|
440
|
1646 Return the given property of the given image instance.
|
428
|
1647 Returns nil if the property or the property method do not exist for
|
440
|
1648 the image instance in the domain.
|
428
|
1649 */
|
|
1650 (image_instance, prop))
|
|
1651 {
|
440
|
1652 Lisp_Image_Instance* ii;
|
428
|
1653 Lisp_Object type, ret;
|
|
1654 struct image_instantiator_methods* meths;
|
|
1655
|
|
1656 CHECK_IMAGE_INSTANCE (image_instance);
|
442
|
1657 ERROR_CHECK_IMAGE_INSTANCE (image_instance);
|
428
|
1658 CHECK_SYMBOL (prop);
|
|
1659 ii = XIMAGE_INSTANCE (image_instance);
|
|
1660
|
|
1661 /* ... then try device specific methods ... */
|
|
1662 type = encode_image_instance_type (IMAGE_INSTANCE_TYPE (ii));
|
442
|
1663 meths = decode_device_ii_format (image_instance_device (image_instance),
|
428
|
1664 type, ERROR_ME_NOT);
|
|
1665 if (meths && HAS_IIFORMAT_METH_P (meths, property)
|
440
|
1666 &&
|
428
|
1667 !UNBOUNDP (ret = IIFORMAT_METH (meths, property, (image_instance, prop))))
|
|
1668 {
|
|
1669 return ret;
|
|
1670 }
|
|
1671 /* ... then format specific methods ... */
|
|
1672 meths = decode_device_ii_format (Qnil, type, ERROR_ME_NOT);
|
|
1673 if (meths && HAS_IIFORMAT_METH_P (meths, property)
|
|
1674 &&
|
|
1675 !UNBOUNDP (ret = IIFORMAT_METH (meths, property, (image_instance, prop))))
|
|
1676 {
|
|
1677 return ret;
|
|
1678 }
|
|
1679 /* ... then fail */
|
|
1680 return Qnil;
|
|
1681 }
|
|
1682
|
|
1683 DEFUN ("image-instance-file-name", Fimage_instance_file_name, 1, 1, 0, /*
|
|
1684 Return the file name from which IMAGE-INSTANCE was read, if known.
|
|
1685 */
|
|
1686 (image_instance))
|
|
1687 {
|
|
1688 CHECK_IMAGE_INSTANCE (image_instance);
|
442
|
1689 ERROR_CHECK_IMAGE_INSTANCE (image_instance);
|
428
|
1690
|
|
1691 switch (XIMAGE_INSTANCE_TYPE (image_instance))
|
|
1692 {
|
|
1693 case IMAGE_MONO_PIXMAP:
|
|
1694 case IMAGE_COLOR_PIXMAP:
|
|
1695 case IMAGE_POINTER:
|
|
1696 return XIMAGE_INSTANCE_PIXMAP_FILENAME (image_instance);
|
|
1697
|
|
1698 default:
|
|
1699 return Qnil;
|
|
1700 }
|
|
1701 }
|
|
1702
|
|
1703 DEFUN ("image-instance-mask-file-name", Fimage_instance_mask_file_name, 1, 1, 0, /*
|
|
1704 Return the file name from which IMAGE-INSTANCE's mask was read, if known.
|
|
1705 */
|
|
1706 (image_instance))
|
|
1707 {
|
|
1708 CHECK_IMAGE_INSTANCE (image_instance);
|
442
|
1709 ERROR_CHECK_IMAGE_INSTANCE (image_instance);
|
428
|
1710
|
|
1711 switch (XIMAGE_INSTANCE_TYPE (image_instance))
|
|
1712 {
|
|
1713 case IMAGE_MONO_PIXMAP:
|
|
1714 case IMAGE_COLOR_PIXMAP:
|
|
1715 case IMAGE_POINTER:
|
|
1716 return XIMAGE_INSTANCE_PIXMAP_MASK_FILENAME (image_instance);
|
|
1717
|
|
1718 default:
|
|
1719 return Qnil;
|
|
1720 }
|
|
1721 }
|
|
1722
|
|
1723 DEFUN ("image-instance-depth", Fimage_instance_depth, 1, 1, 0, /*
|
|
1724 Return the depth of the image instance.
|
|
1725 This is 0 for a bitmap, or a positive integer for a pixmap.
|
|
1726 */
|
|
1727 (image_instance))
|
|
1728 {
|
|
1729 CHECK_IMAGE_INSTANCE (image_instance);
|
442
|
1730 ERROR_CHECK_IMAGE_INSTANCE (image_instance);
|
428
|
1731
|
|
1732 switch (XIMAGE_INSTANCE_TYPE (image_instance))
|
|
1733 {
|
|
1734 case IMAGE_MONO_PIXMAP:
|
|
1735 case IMAGE_COLOR_PIXMAP:
|
|
1736 case IMAGE_POINTER:
|
|
1737 return make_int (XIMAGE_INSTANCE_PIXMAP_DEPTH (image_instance));
|
|
1738
|
|
1739 default:
|
|
1740 return Qnil;
|
|
1741 }
|
|
1742 }
|
|
1743
|
|
1744 DEFUN ("image-instance-height", Fimage_instance_height, 1, 1, 0, /*
|
|
1745 Return the height of the image instance, in pixels.
|
|
1746 */
|
|
1747 (image_instance))
|
|
1748 {
|
|
1749 CHECK_IMAGE_INSTANCE (image_instance);
|
442
|
1750 ERROR_CHECK_IMAGE_INSTANCE (image_instance);
|
428
|
1751
|
|
1752 switch (XIMAGE_INSTANCE_TYPE (image_instance))
|
|
1753 {
|
|
1754 case IMAGE_MONO_PIXMAP:
|
|
1755 case IMAGE_COLOR_PIXMAP:
|
|
1756 case IMAGE_POINTER:
|
|
1757 case IMAGE_SUBWINDOW:
|
|
1758 case IMAGE_WIDGET:
|
438
|
1759 return make_int (XIMAGE_INSTANCE_HEIGHT (image_instance));
|
428
|
1760
|
|
1761 default:
|
|
1762 return Qnil;
|
|
1763 }
|
|
1764 }
|
|
1765
|
|
1766 DEFUN ("image-instance-width", Fimage_instance_width, 1, 1, 0, /*
|
|
1767 Return the width of the image instance, in pixels.
|
|
1768 */
|
|
1769 (image_instance))
|
|
1770 {
|
|
1771 CHECK_IMAGE_INSTANCE (image_instance);
|
442
|
1772 ERROR_CHECK_IMAGE_INSTANCE (image_instance);
|
428
|
1773
|
|
1774 switch (XIMAGE_INSTANCE_TYPE (image_instance))
|
|
1775 {
|
|
1776 case IMAGE_MONO_PIXMAP:
|
|
1777 case IMAGE_COLOR_PIXMAP:
|
|
1778 case IMAGE_POINTER:
|
|
1779 case IMAGE_SUBWINDOW:
|
|
1780 case IMAGE_WIDGET:
|
438
|
1781 return make_int (XIMAGE_INSTANCE_WIDTH (image_instance));
|
428
|
1782
|
|
1783 default:
|
|
1784 return Qnil;
|
|
1785 }
|
|
1786 }
|
|
1787
|
|
1788 DEFUN ("image-instance-hotspot-x", Fimage_instance_hotspot_x, 1, 1, 0, /*
|
|
1789 Return the X coordinate of the image instance's hotspot, if known.
|
|
1790 This is a point relative to the origin of the pixmap. When an image is
|
|
1791 used as a mouse pointer, the hotspot is the point on the image that sits
|
|
1792 over the location that the pointer points to. This is, for example, the
|
|
1793 tip of the arrow or the center of the crosshairs.
|
|
1794 This will always be nil for a non-pointer image instance.
|
|
1795 */
|
|
1796 (image_instance))
|
|
1797 {
|
|
1798 CHECK_IMAGE_INSTANCE (image_instance);
|
442
|
1799 ERROR_CHECK_IMAGE_INSTANCE (image_instance);
|
428
|
1800
|
|
1801 switch (XIMAGE_INSTANCE_TYPE (image_instance))
|
|
1802 {
|
|
1803 case IMAGE_MONO_PIXMAP:
|
|
1804 case IMAGE_COLOR_PIXMAP:
|
|
1805 case IMAGE_POINTER:
|
|
1806 return XIMAGE_INSTANCE_PIXMAP_HOTSPOT_X (image_instance);
|
|
1807
|
|
1808 default:
|
|
1809 return Qnil;
|
|
1810 }
|
|
1811 }
|
|
1812
|
|
1813 DEFUN ("image-instance-hotspot-y", Fimage_instance_hotspot_y, 1, 1, 0, /*
|
|
1814 Return the Y coordinate of the image instance's hotspot, if known.
|
|
1815 This is a point relative to the origin of the pixmap. When an image is
|
|
1816 used as a mouse pointer, the hotspot is the point on the image that sits
|
|
1817 over the location that the pointer points to. This is, for example, the
|
|
1818 tip of the arrow or the center of the crosshairs.
|
|
1819 This will always be nil for a non-pointer image instance.
|
|
1820 */
|
|
1821 (image_instance))
|
|
1822 {
|
|
1823 CHECK_IMAGE_INSTANCE (image_instance);
|
442
|
1824 ERROR_CHECK_IMAGE_INSTANCE (image_instance);
|
428
|
1825
|
|
1826 switch (XIMAGE_INSTANCE_TYPE (image_instance))
|
|
1827 {
|
|
1828 case IMAGE_MONO_PIXMAP:
|
|
1829 case IMAGE_COLOR_PIXMAP:
|
|
1830 case IMAGE_POINTER:
|
|
1831 return XIMAGE_INSTANCE_PIXMAP_HOTSPOT_Y (image_instance);
|
|
1832
|
|
1833 default:
|
|
1834 return Qnil;
|
|
1835 }
|
|
1836 }
|
|
1837
|
|
1838 DEFUN ("image-instance-foreground", Fimage_instance_foreground, 1, 1, 0, /*
|
|
1839 Return the foreground color of IMAGE-INSTANCE, if applicable.
|
|
1840 This will be a color instance or nil. (It will only be non-nil for
|
|
1841 colorized mono pixmaps and for pointers.)
|
|
1842 */
|
|
1843 (image_instance))
|
|
1844 {
|
|
1845 CHECK_IMAGE_INSTANCE (image_instance);
|
442
|
1846 ERROR_CHECK_IMAGE_INSTANCE (image_instance);
|
428
|
1847
|
|
1848 switch (XIMAGE_INSTANCE_TYPE (image_instance))
|
|
1849 {
|
|
1850 case IMAGE_MONO_PIXMAP:
|
|
1851 case IMAGE_COLOR_PIXMAP:
|
|
1852 case IMAGE_POINTER:
|
|
1853 return XIMAGE_INSTANCE_PIXMAP_FG (image_instance);
|
|
1854
|
|
1855 case IMAGE_WIDGET:
|
|
1856 return FACE_FOREGROUND (
|
|
1857 XIMAGE_INSTANCE_WIDGET_FACE (image_instance),
|
442
|
1858 XIMAGE_INSTANCE_FRAME
|
428
|
1859 (image_instance));
|
|
1860
|
|
1861 default:
|
|
1862 return Qnil;
|
|
1863 }
|
|
1864 }
|
|
1865
|
|
1866 DEFUN ("image-instance-background", Fimage_instance_background, 1, 1, 0, /*
|
|
1867 Return the background color of IMAGE-INSTANCE, if applicable.
|
|
1868 This will be a color instance or nil. (It will only be non-nil for
|
|
1869 colorized mono pixmaps and for pointers.)
|
|
1870 */
|
|
1871 (image_instance))
|
|
1872 {
|
|
1873 CHECK_IMAGE_INSTANCE (image_instance);
|
442
|
1874 ERROR_CHECK_IMAGE_INSTANCE (image_instance);
|
428
|
1875
|
|
1876 switch (XIMAGE_INSTANCE_TYPE (image_instance))
|
|
1877 {
|
|
1878 case IMAGE_MONO_PIXMAP:
|
|
1879 case IMAGE_COLOR_PIXMAP:
|
|
1880 case IMAGE_POINTER:
|
|
1881 return XIMAGE_INSTANCE_PIXMAP_BG (image_instance);
|
|
1882
|
|
1883 case IMAGE_WIDGET:
|
|
1884 return FACE_BACKGROUND (
|
|
1885 XIMAGE_INSTANCE_WIDGET_FACE (image_instance),
|
442
|
1886 XIMAGE_INSTANCE_FRAME
|
428
|
1887 (image_instance));
|
|
1888
|
|
1889 default:
|
|
1890 return Qnil;
|
|
1891 }
|
|
1892 }
|
|
1893
|
|
1894
|
|
1895 DEFUN ("colorize-image-instance", Fcolorize_image_instance, 3, 3, 0, /*
|
|
1896 Make the image instance be displayed in the given colors.
|
|
1897 This function returns a new image instance that is exactly like the
|
|
1898 specified one except that (if possible) the foreground and background
|
|
1899 colors and as specified. Currently, this only does anything if the image
|
|
1900 instance is a mono pixmap; otherwise, the same image instance is returned.
|
|
1901 */
|
|
1902 (image_instance, foreground, background))
|
|
1903 {
|
|
1904 Lisp_Object new;
|
|
1905 Lisp_Object device;
|
|
1906
|
|
1907 CHECK_IMAGE_INSTANCE (image_instance);
|
442
|
1908 ERROR_CHECK_IMAGE_INSTANCE (image_instance);
|
428
|
1909 CHECK_COLOR_INSTANCE (foreground);
|
|
1910 CHECK_COLOR_INSTANCE (background);
|
|
1911
|
442
|
1912 device = image_instance_device (image_instance);
|
428
|
1913 if (!HAS_DEVMETH_P (XDEVICE (device), colorize_image_instance))
|
|
1914 return image_instance;
|
|
1915
|
430
|
1916 /* #### There should be a copy_image_instance(), which calls a
|
|
1917 device-specific method to copy the window-system subobject. */
|
442
|
1918 new = allocate_image_instance (XIMAGE_INSTANCE_DOMAIN (image_instance),
|
|
1919 Qnil, Qnil);
|
428
|
1920 copy_lcrecord (XIMAGE_INSTANCE (new), XIMAGE_INSTANCE (image_instance));
|
|
1921 /* note that if this method returns non-zero, this method MUST
|
|
1922 copy any window-system resources, so that when one image instance is
|
|
1923 freed, the other one is not hosed. */
|
|
1924 if (!DEVMETH (XDEVICE (device), colorize_image_instance, (new, foreground,
|
|
1925 background)))
|
|
1926 return image_instance;
|
|
1927 return new;
|
|
1928 }
|
|
1929
|
438
|
1930
|
|
1931 /************************************************************************/
|
|
1932 /* Geometry calculations */
|
|
1933 /************************************************************************/
|
|
1934
|
|
1935 /* Find out desired geometry of the image instance. If there is no
|
|
1936 special function then just return the width and / or height. */
|
|
1937 void
|
440
|
1938 image_instance_query_geometry (Lisp_Object image_instance,
|
442
|
1939 int* width, int* height,
|
438
|
1940 enum image_instance_geometry disp,
|
|
1941 Lisp_Object domain)
|
|
1942 {
|
440
|
1943 Lisp_Image_Instance* ii = XIMAGE_INSTANCE (image_instance);
|
438
|
1944 Lisp_Object type;
|
|
1945 struct image_instantiator_methods* meths;
|
442
|
1946 ERROR_CHECK_IMAGE_INSTANCE (image_instance);
|
438
|
1947
|
|
1948 type = encode_image_instance_type (IMAGE_INSTANCE_TYPE (ii));
|
|
1949 meths = decode_device_ii_format (Qnil, type, ERROR_ME_NOT);
|
440
|
1950
|
438
|
1951 if (meths && HAS_IIFORMAT_METH_P (meths, query_geometry))
|
|
1952 {
|
440
|
1953 IIFORMAT_METH (meths, query_geometry, (image_instance, width, height,
|
438
|
1954 disp, domain));
|
|
1955 }
|
|
1956 else
|
|
1957 {
|
|
1958 if (width)
|
|
1959 *width = IMAGE_INSTANCE_WIDTH (ii);
|
|
1960 if (height)
|
|
1961 *height = IMAGE_INSTANCE_HEIGHT (ii);
|
|
1962 }
|
|
1963 }
|
|
1964
|
|
1965 /* Layout the image instance using the provided dimensions. Layout
|
|
1966 widgets are going to do different kinds of calculations to
|
|
1967 determine what size to give things so we could make the layout
|
|
1968 function relatively simple to take account of that. An alternative
|
|
1969 approach is to consider separately the two cases, one where you
|
|
1970 don't mind what size you have (normal widgets) and one where you
|
442
|
1971 want to specify something (layout widgets). */
|
438
|
1972 void
|
440
|
1973 image_instance_layout (Lisp_Object image_instance,
|
442
|
1974 int width, int height,
|
|
1975 int xoffset, int yoffset,
|
438
|
1976 Lisp_Object domain)
|
|
1977 {
|
440
|
1978 Lisp_Image_Instance* ii = XIMAGE_INSTANCE (image_instance);
|
438
|
1979 Lisp_Object type;
|
|
1980 struct image_instantiator_methods* meths;
|
|
1981
|
442
|
1982 ERROR_CHECK_IMAGE_INSTANCE (image_instance);
|
|
1983
|
|
1984 /* Nothing is as nothing does. */
|
|
1985 if (NOTHING_IMAGE_INSTANCEP (image_instance))
|
|
1986 return;
|
|
1987
|
|
1988 /* We don't want carefully calculated offsets to be mucked up by
|
|
1989 random layouts. */
|
|
1990 if (xoffset != IMAGE_UNCHANGED_GEOMETRY)
|
|
1991 XIMAGE_INSTANCE_XOFFSET (image_instance) = xoffset;
|
|
1992 if (yoffset != IMAGE_UNCHANGED_GEOMETRY)
|
|
1993 XIMAGE_INSTANCE_YOFFSET (image_instance) = yoffset;
|
|
1994
|
|
1995 assert (XIMAGE_INSTANCE_YOFFSET (image_instance) >= 0
|
|
1996 && XIMAGE_INSTANCE_XOFFSET (image_instance) >= 0);
|
|
1997
|
438
|
1998 /* If geometry is unspecified then get some reasonable values for it. */
|
|
1999 if (width == IMAGE_UNSPECIFIED_GEOMETRY
|
|
2000 ||
|
|
2001 height == IMAGE_UNSPECIFIED_GEOMETRY)
|
|
2002 {
|
442
|
2003 int dwidth = IMAGE_UNSPECIFIED_GEOMETRY;
|
|
2004 int dheight = IMAGE_UNSPECIFIED_GEOMETRY;
|
438
|
2005 /* Get the desired geometry. */
|
450
|
2006 image_instance_query_geometry (image_instance,
|
|
2007 &dwidth, &dheight,
|
|
2008 IMAGE_DESIRED_GEOMETRY,
|
|
2009 domain);
|
438
|
2010 /* Compare with allowed geometry. */
|
|
2011 if (width == IMAGE_UNSPECIFIED_GEOMETRY)
|
|
2012 width = dwidth;
|
|
2013 if (height == IMAGE_UNSPECIFIED_GEOMETRY)
|
|
2014 height = dheight;
|
|
2015 }
|
|
2016
|
442
|
2017 /* If we don't have sane values then we cannot layout at this point and
|
|
2018 must just return. */
|
|
2019 if (width == IMAGE_UNSPECIFIED_GEOMETRY
|
|
2020 ||
|
|
2021 height == IMAGE_UNSPECIFIED_GEOMETRY)
|
|
2022 return;
|
|
2023
|
438
|
2024 /* At this point width and height should contain sane values. Thus
|
|
2025 we set the glyph geometry and lay it out. */
|
442
|
2026 if (IMAGE_INSTANCE_WIDTH (ii) != width
|
|
2027 ||
|
|
2028 IMAGE_INSTANCE_HEIGHT (ii) != height)
|
|
2029 {
|
|
2030 IMAGE_INSTANCE_SIZE_CHANGED (ii) = 1;
|
|
2031 }
|
|
2032
|
438
|
2033 IMAGE_INSTANCE_WIDTH (ii) = width;
|
|
2034 IMAGE_INSTANCE_HEIGHT (ii) = height;
|
440
|
2035
|
450
|
2036 type = encode_image_instance_type (IMAGE_INSTANCE_TYPE (ii));
|
|
2037 meths = decode_device_ii_format (Qnil, type, ERROR_ME_NOT);
|
|
2038
|
|
2039 MAYBE_IIFORMAT_METH (meths, layout,
|
|
2040 (image_instance, width, height, xoffset, yoffset,
|
|
2041 domain));
|
|
2042 /* Do not clear the dirty flag here - redisplay will do this for
|
|
2043 us at the end. */
|
|
2044 IMAGE_INSTANCE_LAYOUT_CHANGED (ii) = 0;
|
442
|
2045 }
|
|
2046
|
|
2047 /* Update an image instance from its changed instantiator. */
|
|
2048 static void
|
|
2049 update_image_instance (Lisp_Object image_instance,
|
|
2050 Lisp_Object instantiator)
|
|
2051 {
|
|
2052 struct image_instantiator_methods* meths;
|
|
2053 Lisp_Image_Instance *ii = XIMAGE_INSTANCE (image_instance);
|
|
2054
|
|
2055 ERROR_CHECK_IMAGE_INSTANCE (image_instance);
|
|
2056
|
|
2057 if (NOTHING_IMAGE_INSTANCEP (image_instance))
|
|
2058 return;
|
|
2059
|
|
2060 assert (!internal_equal (IMAGE_INSTANCE_INSTANTIATOR (ii), instantiator, 0)
|
|
2061 || (internal_equal (IMAGE_INSTANCE_INSTANTIATOR (ii), instantiator, 0)
|
|
2062 && internal_equal (IMAGE_INSTANCE_INSTANTIATOR (ii), instantiator, -10)));
|
|
2063
|
|
2064 /* If the instantiator is identical then do nothing. We must use
|
|
2065 equal here because the specifier code copies the instantiator. */
|
|
2066 if (!internal_equal (IMAGE_INSTANCE_INSTANTIATOR (ii), instantiator, 0))
|
438
|
2067 {
|
442
|
2068 /* Extract the changed properties so that device / format
|
|
2069 methods only have to cope with these. We assume that
|
|
2070 normalization has already been done. */
|
|
2071 Lisp_Object diffs = find_instantiator_differences
|
|
2072 (instantiator,
|
|
2073 IMAGE_INSTANCE_INSTANTIATOR (ii));
|
|
2074 Lisp_Object type = encode_image_instance_type
|
|
2075 (IMAGE_INSTANCE_TYPE (ii));
|
|
2076 struct gcpro gcpro1;
|
|
2077 GCPRO1 (diffs);
|
|
2078
|
|
2079 /* try device specific methods first ... */
|
|
2080 meths = decode_device_ii_format (image_instance_device (image_instance),
|
|
2081 type, ERROR_ME_NOT);
|
|
2082 MAYBE_IIFORMAT_METH (meths, update, (image_instance, diffs));
|
|
2083 /* ... then format specific methods ... */
|
|
2084 meths = decode_device_ii_format (Qnil, type, ERROR_ME_NOT);
|
|
2085 MAYBE_IIFORMAT_METH (meths, update, (image_instance, diffs));
|
|
2086
|
|
2087 /* Instance and therefore glyph has changed so mark as dirty.
|
|
2088 If we don't do this output optimizations will assume the
|
|
2089 glyph is unchanged. */
|
|
2090 set_image_instance_dirty_p (image_instance, 1);
|
|
2091 /* Structure has changed. */
|
|
2092 IMAGE_INSTANCE_LAYOUT_CHANGED (ii) = 1;
|
|
2093
|
|
2094 UNGCPRO;
|
438
|
2095 }
|
442
|
2096 /* We should now have a consistent instantiator so keep a record of
|
|
2097 it. It is important that we don't actually update the window
|
|
2098 system widgets here - we must do that when redisplay tells us
|
|
2099 to.
|
|
2100
|
|
2101 #### should we delay doing this until the display is up-to-date
|
|
2102 also? */
|
|
2103 IMAGE_INSTANCE_INSTANTIATOR (ii) = instantiator;
|
440
|
2104 }
|
|
2105
|
|
2106 /*
|
|
2107 * Mark image instance in W as dirty if (a) W's faces have changed and
|
|
2108 * (b) GLYPH_OR_II instance in W is a string.
|
|
2109 *
|
|
2110 * Return non-zero if instance has been marked dirty.
|
|
2111 */
|
|
2112 int
|
|
2113 invalidate_glyph_geometry_maybe (Lisp_Object glyph_or_ii, struct window* w)
|
|
2114 {
|
|
2115 if (XFRAME(WINDOW_FRAME(w))->faces_changed)
|
|
2116 {
|
|
2117 Lisp_Object image = glyph_or_ii;
|
|
2118
|
|
2119 if (GLYPHP (glyph_or_ii))
|
|
2120 {
|
793
|
2121 Lisp_Object window = wrap_window (w);
|
|
2122
|
|
2123 image = glyph_image_instance (glyph_or_ii, window,
|
|
2124 ERROR_ME_DEBUG_WARN, 1);
|
440
|
2125 }
|
|
2126
|
|
2127 if (TEXT_IMAGE_INSTANCEP (image))
|
|
2128 {
|
442
|
2129 Lisp_Image_Instance* ii = XIMAGE_INSTANCE (image);
|
|
2130 IMAGE_INSTANCE_DIRTYP (ii) = 1;
|
|
2131 IMAGE_INSTANCE_LAYOUT_CHANGED (ii) = 1;
|
440
|
2132 if (GLYPHP (glyph_or_ii))
|
|
2133 XGLYPH_DIRTYP (glyph_or_ii) = 1;
|
|
2134 return 1;
|
|
2135 }
|
|
2136 }
|
|
2137
|
|
2138 return 0;
|
438
|
2139 }
|
|
2140
|
428
|
2141
|
|
2142 /************************************************************************/
|
|
2143 /* error helpers */
|
|
2144 /************************************************************************/
|
|
2145 DOESNT_RETURN
|
771
|
2146 signal_image_error (const CIntbyte *reason, Lisp_Object frob)
|
428
|
2147 {
|
563
|
2148 signal_error (Qimage_conversion_error, reason, frob);
|
428
|
2149 }
|
|
2150
|
|
2151 DOESNT_RETURN
|
771
|
2152 signal_image_error_2 (const CIntbyte *reason, Lisp_Object frob0, Lisp_Object frob1)
|
428
|
2153 {
|
563
|
2154 signal_error_2 (Qimage_conversion_error, reason, frob0, frob1);
|
|
2155 }
|
|
2156
|
|
2157 DOESNT_RETURN
|
771
|
2158 signal_double_image_error (const CIntbyte *string1, const CIntbyte *string2,
|
563
|
2159 Lisp_Object data)
|
|
2160 {
|
|
2161 signal_error_1 (Qimage_conversion_error,
|
771
|
2162 list3 (build_msg_string (string1),
|
|
2163 build_msg_string (string2),
|
563
|
2164 data));
|
|
2165 }
|
|
2166
|
|
2167 DOESNT_RETURN
|
771
|
2168 signal_double_image_error_2 (const CIntbyte *string1, const CIntbyte *string2,
|
563
|
2169 Lisp_Object data1, Lisp_Object data2)
|
|
2170 {
|
|
2171 signal_error_1 (Qimage_conversion_error,
|
771
|
2172 list4 (build_msg_string (string1),
|
|
2173 build_msg_string (string2),
|
563
|
2174 data1, data2));
|
428
|
2175 }
|
|
2176
|
|
2177 /****************************************************************************
|
|
2178 * nothing *
|
|
2179 ****************************************************************************/
|
|
2180
|
|
2181 static int
|
|
2182 nothing_possible_dest_types (void)
|
|
2183 {
|
|
2184 return IMAGE_NOTHING_MASK;
|
|
2185 }
|
|
2186
|
|
2187 static void
|
|
2188 nothing_instantiate (Lisp_Object image_instance, Lisp_Object instantiator,
|
|
2189 Lisp_Object pointer_fg, Lisp_Object pointer_bg,
|
|
2190 int dest_mask, Lisp_Object domain)
|
|
2191 {
|
440
|
2192 Lisp_Image_Instance *ii = XIMAGE_INSTANCE (image_instance);
|
428
|
2193
|
|
2194 if (dest_mask & IMAGE_NOTHING_MASK)
|
442
|
2195 {
|
|
2196 IMAGE_INSTANCE_TYPE (ii) = IMAGE_NOTHING;
|
|
2197 IMAGE_INSTANCE_HEIGHT (ii) = 0;
|
|
2198 IMAGE_INSTANCE_WIDTH (ii) = 0;
|
|
2199 }
|
428
|
2200 else
|
|
2201 incompatible_image_types (instantiator, dest_mask, IMAGE_NOTHING_MASK);
|
|
2202 }
|
|
2203
|
|
2204
|
|
2205 /****************************************************************************
|
|
2206 * inherit *
|
|
2207 ****************************************************************************/
|
|
2208
|
|
2209 static void
|
|
2210 inherit_validate (Lisp_Object instantiator)
|
|
2211 {
|
|
2212 face_must_be_present (instantiator);
|
|
2213 }
|
|
2214
|
|
2215 static Lisp_Object
|
442
|
2216 inherit_normalize (Lisp_Object inst, Lisp_Object console_type,
|
|
2217 Lisp_Object dest_mask)
|
428
|
2218 {
|
|
2219 Lisp_Object face;
|
|
2220
|
|
2221 assert (XVECTOR_LENGTH (inst) == 3);
|
|
2222 face = XVECTOR_DATA (inst)[2];
|
|
2223 if (!FACEP (face))
|
|
2224 inst = vector3 (Qinherit, Q_face, Fget_face (face));
|
|
2225 return inst;
|
|
2226 }
|
|
2227
|
|
2228 static int
|
|
2229 inherit_possible_dest_types (void)
|
|
2230 {
|
|
2231 return IMAGE_MONO_PIXMAP_MASK;
|
|
2232 }
|
|
2233
|
|
2234 static void
|
|
2235 inherit_instantiate (Lisp_Object image_instance, Lisp_Object instantiator,
|
|
2236 Lisp_Object pointer_fg, Lisp_Object pointer_bg,
|
|
2237 int dest_mask, Lisp_Object domain)
|
|
2238 {
|
|
2239 /* handled specially in image_instantiate */
|
|
2240 abort ();
|
|
2241 }
|
|
2242
|
|
2243
|
|
2244 /****************************************************************************
|
|
2245 * string *
|
|
2246 ****************************************************************************/
|
|
2247
|
|
2248 static void
|
|
2249 string_validate (Lisp_Object instantiator)
|
|
2250 {
|
|
2251 data_must_be_present (instantiator);
|
|
2252 }
|
|
2253
|
|
2254 static int
|
|
2255 string_possible_dest_types (void)
|
|
2256 {
|
|
2257 return IMAGE_TEXT_MASK;
|
|
2258 }
|
|
2259
|
438
|
2260 /* Called from autodetect_instantiate() */
|
428
|
2261 void
|
|
2262 string_instantiate (Lisp_Object image_instance, Lisp_Object instantiator,
|
|
2263 Lisp_Object pointer_fg, Lisp_Object pointer_bg,
|
|
2264 int dest_mask, Lisp_Object domain)
|
|
2265 {
|
434
|
2266 Lisp_Object string = find_keyword_in_vector (instantiator, Q_data);
|
440
|
2267 Lisp_Image_Instance *ii = XIMAGE_INSTANCE (image_instance);
|
|
2268
|
438
|
2269 /* Should never get here with a domain other than a window. */
|
442
|
2270 assert (!NILP (string) && WINDOWP (DOMAIN_WINDOW (domain)));
|
428
|
2271 if (dest_mask & IMAGE_TEXT_MASK)
|
|
2272 {
|
|
2273 IMAGE_INSTANCE_TYPE (ii) = IMAGE_TEXT;
|
434
|
2274 IMAGE_INSTANCE_TEXT_STRING (ii) = string;
|
428
|
2275 }
|
|
2276 else
|
|
2277 incompatible_image_types (instantiator, dest_mask, IMAGE_TEXT_MASK);
|
|
2278 }
|
|
2279
|
438
|
2280 /* Sort out the size of the text that is being displayed. Calculating
|
|
2281 it dynamically allows us to change the text and still see
|
|
2282 everything. Note that the following methods are for text not string
|
|
2283 since that is what the instantiated type is. The first method is a
|
|
2284 helper that is used elsewhere for calculating text geometry. */
|
|
2285 void
|
|
2286 query_string_geometry (Lisp_Object string, Lisp_Object face,
|
442
|
2287 int* width, int* height, int* descent, Lisp_Object domain)
|
438
|
2288 {
|
|
2289 struct font_metric_info fm;
|
|
2290 unsigned char charsets[NUM_LEADING_BYTES];
|
|
2291 struct face_cachel frame_cachel;
|
|
2292 struct face_cachel *cachel;
|
442
|
2293 Lisp_Object frame = DOMAIN_FRAME (domain);
|
438
|
2294
|
|
2295 /* Compute height */
|
|
2296 if (height)
|
|
2297 {
|
|
2298 /* Compute string metric info */
|
665
|
2299 find_charsets_in_intbyte_string (charsets,
|
438
|
2300 XSTRING_DATA (string),
|
|
2301 XSTRING_LENGTH (string));
|
440
|
2302
|
438
|
2303 /* Fallback to the default face if none was provided. */
|
|
2304 if (!NILP (face))
|
|
2305 {
|
|
2306 reset_face_cachel (&frame_cachel);
|
|
2307 update_face_cachel_data (&frame_cachel, frame, face);
|
|
2308 cachel = &frame_cachel;
|
|
2309 }
|
|
2310 else
|
|
2311 {
|
442
|
2312 cachel = WINDOW_FACE_CACHEL (DOMAIN_XWINDOW (domain),
|
|
2313 DEFAULT_INDEX);
|
438
|
2314 }
|
440
|
2315
|
438
|
2316 ensure_face_cachel_complete (cachel, domain, charsets);
|
|
2317 face_cachel_charset_font_metric_info (cachel, charsets, &fm);
|
440
|
2318
|
438
|
2319 *height = fm.ascent + fm.descent;
|
|
2320 /* #### descent only gets set if we query the height as well. */
|
|
2321 if (descent)
|
|
2322 *descent = fm.descent;
|
|
2323 }
|
440
|
2324
|
438
|
2325 /* Compute width */
|
|
2326 if (width)
|
|
2327 {
|
|
2328 if (!NILP (face))
|
|
2329 *width = redisplay_frame_text_width_string (XFRAME (frame),
|
|
2330 face,
|
|
2331 0, string, 0, -1);
|
|
2332 else
|
|
2333 *width = redisplay_frame_text_width_string (XFRAME (frame),
|
|
2334 Vdefault_face,
|
|
2335 0, string, 0, -1);
|
|
2336 }
|
|
2337 }
|
|
2338
|
|
2339 Lisp_Object
|
|
2340 query_string_font (Lisp_Object string, Lisp_Object face, Lisp_Object domain)
|
|
2341 {
|
|
2342 unsigned char charsets[NUM_LEADING_BYTES];
|
|
2343 struct face_cachel frame_cachel;
|
|
2344 struct face_cachel *cachel;
|
|
2345 int i;
|
442
|
2346 Lisp_Object frame = DOMAIN_FRAME (domain);
|
438
|
2347
|
|
2348 /* Compute string font info */
|
665
|
2349 find_charsets_in_intbyte_string (charsets,
|
438
|
2350 XSTRING_DATA (string),
|
|
2351 XSTRING_LENGTH (string));
|
440
|
2352
|
438
|
2353 reset_face_cachel (&frame_cachel);
|
|
2354 update_face_cachel_data (&frame_cachel, frame, face);
|
|
2355 cachel = &frame_cachel;
|
|
2356
|
|
2357 ensure_face_cachel_complete (cachel, domain, charsets);
|
440
|
2358
|
438
|
2359 for (i = 0; i < NUM_LEADING_BYTES; i++)
|
|
2360 {
|
|
2361 if (charsets[i])
|
|
2362 {
|
440
|
2363 return FACE_CACHEL_FONT (cachel,
|
|
2364 CHARSET_BY_LEADING_BYTE (i +
|
438
|
2365 MIN_LEADING_BYTE));
|
|
2366
|
440
|
2367 }
|
438
|
2368 }
|
|
2369
|
|
2370 return Qnil; /* NOT REACHED */
|
|
2371 }
|
|
2372
|
|
2373 static void
|
|
2374 text_query_geometry (Lisp_Object image_instance,
|
442
|
2375 int* width, int* height,
|
438
|
2376 enum image_instance_geometry disp, Lisp_Object domain)
|
|
2377 {
|
440
|
2378 Lisp_Image_Instance *ii = XIMAGE_INSTANCE (image_instance);
|
442
|
2379 int descent = 0;
|
438
|
2380
|
|
2381 query_string_geometry (IMAGE_INSTANCE_TEXT_STRING (ii),
|
|
2382 IMAGE_INSTANCE_FACE (ii),
|
|
2383 width, height, &descent, domain);
|
|
2384
|
|
2385 /* The descent gets set as a side effect of querying the
|
|
2386 geometry. */
|
|
2387 IMAGE_INSTANCE_TEXT_DESCENT (ii) = descent;
|
|
2388 }
|
|
2389
|
428
|
2390 /* set the properties of a string */
|
442
|
2391 static void
|
|
2392 text_update (Lisp_Object image_instance, Lisp_Object instantiator)
|
|
2393 {
|
|
2394 Lisp_Object val = find_keyword_in_vector (instantiator, Q_data);
|
|
2395
|
|
2396 if (!NILP (val))
|
428
|
2397 {
|
|
2398 CHECK_STRING (val);
|
442
|
2399 XIMAGE_INSTANCE_TEXT_STRING (image_instance) = val;
|
428
|
2400 }
|
|
2401 }
|
|
2402
|
|
2403
|
|
2404 /****************************************************************************
|
|
2405 * formatted-string *
|
|
2406 ****************************************************************************/
|
|
2407
|
|
2408 static void
|
|
2409 formatted_string_validate (Lisp_Object instantiator)
|
|
2410 {
|
|
2411 data_must_be_present (instantiator);
|
|
2412 }
|
|
2413
|
|
2414 static int
|
|
2415 formatted_string_possible_dest_types (void)
|
|
2416 {
|
|
2417 return IMAGE_TEXT_MASK;
|
|
2418 }
|
|
2419
|
|
2420 static void
|
|
2421 formatted_string_instantiate (Lisp_Object image_instance,
|
|
2422 Lisp_Object instantiator,
|
|
2423 Lisp_Object pointer_fg, Lisp_Object pointer_bg,
|
|
2424 int dest_mask, Lisp_Object domain)
|
|
2425 {
|
|
2426 /* #### implement this */
|
|
2427 warn_when_safe (Qunimplemented, Qnotice,
|
|
2428 "`formatted-string' not yet implemented; assuming `string'");
|
438
|
2429
|
440
|
2430 string_instantiate (image_instance, instantiator,
|
438
|
2431 pointer_fg, pointer_bg, dest_mask, domain);
|
428
|
2432 }
|
|
2433
|
|
2434
|
|
2435 /************************************************************************/
|
|
2436 /* pixmap file functions */
|
|
2437 /************************************************************************/
|
|
2438
|
|
2439 /* If INSTANTIATOR refers to inline data, return Qnil.
|
|
2440 If INSTANTIATOR refers to data in a file, return the full filename
|
|
2441 if it exists; otherwise, return a cons of (filename).
|
|
2442
|
|
2443 FILE_KEYWORD and DATA_KEYWORD are symbols specifying the
|
|
2444 keywords used to look up the file and inline data,
|
|
2445 respectively, in the instantiator. Normally these would
|
|
2446 be Q_file and Q_data, but might be different for mask data. */
|
|
2447
|
|
2448 Lisp_Object
|
|
2449 potential_pixmap_file_instantiator (Lisp_Object instantiator,
|
|
2450 Lisp_Object file_keyword,
|
|
2451 Lisp_Object data_keyword,
|
|
2452 Lisp_Object console_type)
|
|
2453 {
|
|
2454 Lisp_Object file;
|
|
2455 Lisp_Object data;
|
|
2456
|
|
2457 assert (VECTORP (instantiator));
|
|
2458
|
|
2459 data = find_keyword_in_vector (instantiator, data_keyword);
|
|
2460 file = find_keyword_in_vector (instantiator, file_keyword);
|
|
2461
|
|
2462 if (!NILP (file) && NILP (data))
|
|
2463 {
|
|
2464 Lisp_Object retval = MAYBE_LISP_CONTYPE_METH
|
|
2465 (decode_console_type(console_type, ERROR_ME),
|
|
2466 locate_pixmap_file, (file));
|
|
2467
|
|
2468 if (!NILP (retval))
|
|
2469 return retval;
|
|
2470 else
|
|
2471 return Fcons (file, Qnil); /* should have been file */
|
|
2472 }
|
|
2473
|
|
2474 return Qnil;
|
|
2475 }
|
|
2476
|
|
2477 Lisp_Object
|
|
2478 simple_image_type_normalize (Lisp_Object inst, Lisp_Object console_type,
|
|
2479 Lisp_Object image_type_tag)
|
|
2480 {
|
|
2481 /* This function can call lisp */
|
|
2482 Lisp_Object file = Qnil;
|
|
2483 struct gcpro gcpro1, gcpro2;
|
|
2484 Lisp_Object alist = Qnil;
|
|
2485
|
|
2486 GCPRO2 (file, alist);
|
|
2487
|
|
2488 /* Now, convert any file data into inline data. At the end of this,
|
|
2489 `data' will contain the inline data (if any) or Qnil, and `file'
|
|
2490 will contain the name this data was derived from (if known) or
|
|
2491 Qnil.
|
|
2492
|
|
2493 Note that if we cannot generate any regular inline data, we
|
|
2494 skip out. */
|
|
2495
|
|
2496 file = potential_pixmap_file_instantiator (inst, Q_file, Q_data,
|
|
2497 console_type);
|
|
2498
|
|
2499 if (CONSP (file)) /* failure locating filename */
|
563
|
2500 signal_double_image_error ("Opening pixmap file",
|
|
2501 "no such file or directory",
|
|
2502 Fcar (file));
|
428
|
2503
|
|
2504 if (NILP (file)) /* no conversion necessary */
|
|
2505 RETURN_UNGCPRO (inst);
|
|
2506
|
|
2507 alist = tagged_vector_to_alist (inst);
|
|
2508
|
|
2509 {
|
|
2510 Lisp_Object data = make_string_from_file (file);
|
|
2511 alist = remassq_no_quit (Q_file, alist);
|
|
2512 /* there can't be a :data at this point. */
|
|
2513 alist = Fcons (Fcons (Q_file, file),
|
|
2514 Fcons (Fcons (Q_data, data), alist));
|
|
2515 }
|
|
2516
|
|
2517 {
|
|
2518 Lisp_Object result = alist_to_tagged_vector (image_type_tag, alist);
|
|
2519 free_alist (alist);
|
|
2520 RETURN_UNGCPRO (result);
|
|
2521 }
|
|
2522 }
|
|
2523
|
|
2524
|
|
2525 #ifdef HAVE_WINDOW_SYSTEM
|
|
2526 /**********************************************************************
|
|
2527 * XBM *
|
|
2528 **********************************************************************/
|
|
2529
|
|
2530 /* Check if DATA represents a valid inline XBM spec (i.e. a list
|
|
2531 of (width height bits), with checking done on the dimensions).
|
|
2532 If not, signal an error. */
|
|
2533
|
|
2534 static void
|
|
2535 check_valid_xbm_inline (Lisp_Object data)
|
|
2536 {
|
|
2537 Lisp_Object width, height, bits;
|
|
2538
|
|
2539 if (!CONSP (data) ||
|
|
2540 !CONSP (XCDR (data)) ||
|
|
2541 !CONSP (XCDR (XCDR (data))) ||
|
|
2542 !NILP (XCDR (XCDR (XCDR (data)))))
|
563
|
2543 sferror ("Must be list of 3 elements", data);
|
428
|
2544
|
|
2545 width = XCAR (data);
|
|
2546 height = XCAR (XCDR (data));
|
|
2547 bits = XCAR (XCDR (XCDR (data)));
|
|
2548
|
|
2549 CHECK_STRING (bits);
|
|
2550
|
|
2551 if (!NATNUMP (width))
|
563
|
2552 invalid_argument ("Width must be a natural number", width);
|
428
|
2553
|
|
2554 if (!NATNUMP (height))
|
563
|
2555 invalid_argument ("Height must be a natural number", height);
|
428
|
2556
|
|
2557 if (((XINT (width) * XINT (height)) / 8) > XSTRING_CHAR_LENGTH (bits))
|
563
|
2558 invalid_argument ("data is too short for width and height",
|
428
|
2559 vector3 (width, height, bits));
|
|
2560 }
|
|
2561
|
|
2562 /* Validate method for XBM's. */
|
|
2563
|
|
2564 static void
|
|
2565 xbm_validate (Lisp_Object instantiator)
|
|
2566 {
|
|
2567 file_or_data_must_be_present (instantiator);
|
|
2568 }
|
|
2569
|
|
2570 /* Given a filename that is supposed to contain XBM data, return
|
|
2571 the inline representation of it as (width height bits). Return
|
|
2572 the hotspot through XHOT and YHOT, if those pointers are not 0.
|
|
2573 If there is no hotspot, XHOT and YHOT will contain -1.
|
|
2574
|
|
2575 If the function fails:
|
|
2576
|
|
2577 -- if OK_IF_DATA_INVALID is set and the data was invalid,
|
|
2578 return Qt.
|
|
2579 -- maybe return an error, or return Qnil.
|
|
2580 */
|
|
2581
|
|
2582 #ifdef HAVE_X_WINDOWS
|
|
2583 #include <X11/Xlib.h>
|
|
2584 #else
|
|
2585 #define XFree(data) free(data)
|
|
2586 #endif
|
|
2587
|
|
2588 Lisp_Object
|
|
2589 bitmap_to_lisp_data (Lisp_Object name, int *xhot, int *yhot,
|
|
2590 int ok_if_data_invalid)
|
|
2591 {
|
647
|
2592 int w, h;
|
771
|
2593 UChar_Binary *data;
|
428
|
2594 int result;
|
771
|
2595
|
|
2596 result = read_bitmap_data_from_file (name, &w, &h, &data, xhot, yhot);
|
428
|
2597
|
|
2598 if (result == BitmapSuccess)
|
|
2599 {
|
|
2600 Lisp_Object retval;
|
|
2601 int len = (w + 7) / 8 * h;
|
|
2602
|
|
2603 retval = list3 (make_int (w), make_int (h),
|
771
|
2604 make_ext_string ((Extbyte *) data, len, Qbinary));
|
444
|
2605 XFree (data);
|
428
|
2606 return retval;
|
|
2607 }
|
|
2608
|
|
2609 switch (result)
|
|
2610 {
|
|
2611 case BitmapOpenFailed:
|
|
2612 {
|
|
2613 /* should never happen */
|
563
|
2614 signal_double_image_error ("Opening bitmap file",
|
|
2615 "no such file or directory",
|
|
2616 name);
|
428
|
2617 }
|
|
2618 case BitmapFileInvalid:
|
|
2619 {
|
|
2620 if (ok_if_data_invalid)
|
|
2621 return Qt;
|
563
|
2622 signal_double_image_error ("Reading bitmap file",
|
|
2623 "invalid data in file",
|
|
2624 name);
|
428
|
2625 }
|
|
2626 case BitmapNoMemory:
|
|
2627 {
|
563
|
2628 signal_double_image_error ("Reading bitmap file",
|
|
2629 "out of memory",
|
|
2630 name);
|
428
|
2631 }
|
|
2632 default:
|
|
2633 {
|
563
|
2634 signal_double_image_error_2 ("Reading bitmap file",
|
|
2635 "unknown error code",
|
|
2636 make_int (result), name);
|
428
|
2637 }
|
|
2638 }
|
|
2639
|
|
2640 return Qnil; /* not reached */
|
|
2641 }
|
|
2642
|
|
2643 Lisp_Object
|
|
2644 xbm_mask_file_munging (Lisp_Object alist, Lisp_Object file,
|
|
2645 Lisp_Object mask_file, Lisp_Object console_type)
|
|
2646 {
|
|
2647 /* This is unclean but it's fairly standard -- a number of the
|
|
2648 bitmaps in /usr/include/X11/bitmaps use it -- so we support
|
|
2649 it. */
|
|
2650 if (NILP (mask_file)
|
|
2651 /* don't override explicitly specified mask data. */
|
|
2652 && NILP (assq_no_quit (Q_mask_data, alist))
|
|
2653 && !NILP (file))
|
|
2654 {
|
|
2655 mask_file = MAYBE_LISP_CONTYPE_METH
|
|
2656 (decode_console_type(console_type, ERROR_ME),
|
|
2657 locate_pixmap_file, (concat2 (file, build_string ("Mask"))));
|
|
2658 if (NILP (mask_file))
|
|
2659 mask_file = MAYBE_LISP_CONTYPE_METH
|
|
2660 (decode_console_type(console_type, ERROR_ME),
|
|
2661 locate_pixmap_file, (concat2 (file, build_string ("msk"))));
|
|
2662 }
|
|
2663
|
|
2664 if (!NILP (mask_file))
|
|
2665 {
|
|
2666 Lisp_Object mask_data =
|
|
2667 bitmap_to_lisp_data (mask_file, 0, 0, 0);
|
|
2668 alist = remassq_no_quit (Q_mask_file, alist);
|
|
2669 /* there can't be a :mask-data at this point. */
|
|
2670 alist = Fcons (Fcons (Q_mask_file, mask_file),
|
|
2671 Fcons (Fcons (Q_mask_data, mask_data), alist));
|
|
2672 }
|
|
2673
|
|
2674 return alist;
|
|
2675 }
|
|
2676
|
|
2677 /* Normalize method for XBM's. */
|
|
2678
|
|
2679 static Lisp_Object
|
442
|
2680 xbm_normalize (Lisp_Object inst, Lisp_Object console_type,
|
|
2681 Lisp_Object dest_mask)
|
428
|
2682 {
|
|
2683 Lisp_Object file = Qnil, mask_file = Qnil;
|
|
2684 struct gcpro gcpro1, gcpro2, gcpro3;
|
|
2685 Lisp_Object alist = Qnil;
|
|
2686
|
|
2687 GCPRO3 (file, mask_file, alist);
|
|
2688
|
|
2689 /* Now, convert any file data into inline data for both the regular
|
|
2690 data and the mask data. At the end of this, `data' will contain
|
|
2691 the inline data (if any) or Qnil, and `file' will contain
|
|
2692 the name this data was derived from (if known) or Qnil.
|
|
2693 Likewise for `mask_file' and `mask_data'.
|
|
2694
|
|
2695 Note that if we cannot generate any regular inline data, we
|
|
2696 skip out. */
|
|
2697
|
|
2698 file = potential_pixmap_file_instantiator (inst, Q_file, Q_data,
|
|
2699 console_type);
|
|
2700 mask_file = potential_pixmap_file_instantiator (inst, Q_mask_file,
|
|
2701 Q_mask_data, console_type);
|
|
2702
|
|
2703 if (CONSP (file)) /* failure locating filename */
|
563
|
2704 signal_double_image_error ("Opening bitmap file",
|
|
2705 "no such file or directory",
|
|
2706 Fcar (file));
|
428
|
2707
|
|
2708 if (NILP (file) && NILP (mask_file)) /* no conversion necessary */
|
|
2709 RETURN_UNGCPRO (inst);
|
|
2710
|
|
2711 alist = tagged_vector_to_alist (inst);
|
|
2712
|
|
2713 if (!NILP (file))
|
|
2714 {
|
|
2715 int xhot, yhot;
|
|
2716 Lisp_Object data = bitmap_to_lisp_data (file, &xhot, &yhot, 0);
|
|
2717 alist = remassq_no_quit (Q_file, alist);
|
|
2718 /* there can't be a :data at this point. */
|
|
2719 alist = Fcons (Fcons (Q_file, file),
|
|
2720 Fcons (Fcons (Q_data, data), alist));
|
|
2721
|
|
2722 if (xhot != -1 && NILP (assq_no_quit (Q_hotspot_x, alist)))
|
|
2723 alist = Fcons (Fcons (Q_hotspot_x, make_int (xhot)),
|
|
2724 alist);
|
|
2725 if (yhot != -1 && NILP (assq_no_quit (Q_hotspot_y, alist)))
|
|
2726 alist = Fcons (Fcons (Q_hotspot_y, make_int (yhot)),
|
|
2727 alist);
|
|
2728 }
|
|
2729
|
|
2730 alist = xbm_mask_file_munging (alist, file, mask_file, console_type);
|
|
2731
|
|
2732 {
|
|
2733 Lisp_Object result = alist_to_tagged_vector (Qxbm, alist);
|
|
2734 free_alist (alist);
|
|
2735 RETURN_UNGCPRO (result);
|
|
2736 }
|
|
2737 }
|
|
2738
|
|
2739
|
|
2740 static int
|
|
2741 xbm_possible_dest_types (void)
|
|
2742 {
|
|
2743 return
|
|
2744 IMAGE_MONO_PIXMAP_MASK |
|
|
2745 IMAGE_COLOR_PIXMAP_MASK |
|
|
2746 IMAGE_POINTER_MASK;
|
|
2747 }
|
|
2748
|
|
2749 #endif
|
|
2750
|
|
2751
|
|
2752 #ifdef HAVE_XFACE
|
|
2753 /**********************************************************************
|
|
2754 * X-Face *
|
|
2755 **********************************************************************/
|
|
2756
|
|
2757 static void
|
|
2758 xface_validate (Lisp_Object instantiator)
|
|
2759 {
|
|
2760 file_or_data_must_be_present (instantiator);
|
|
2761 }
|
|
2762
|
|
2763 static Lisp_Object
|
442
|
2764 xface_normalize (Lisp_Object inst, Lisp_Object console_type,
|
|
2765 Lisp_Object dest_mask)
|
428
|
2766 {
|
|
2767 /* This function can call lisp */
|
|
2768 Lisp_Object file = Qnil, mask_file = Qnil;
|
|
2769 struct gcpro gcpro1, gcpro2, gcpro3;
|
|
2770 Lisp_Object alist = Qnil;
|
|
2771
|
|
2772 GCPRO3 (file, mask_file, alist);
|
|
2773
|
|
2774 /* Now, convert any file data into inline data for both the regular
|
|
2775 data and the mask data. At the end of this, `data' will contain
|
|
2776 the inline data (if any) or Qnil, and `file' will contain
|
|
2777 the name this data was derived from (if known) or Qnil.
|
|
2778 Likewise for `mask_file' and `mask_data'.
|
|
2779
|
|
2780 Note that if we cannot generate any regular inline data, we
|
|
2781 skip out. */
|
|
2782
|
|
2783 file = potential_pixmap_file_instantiator (inst, Q_file, Q_data,
|
|
2784 console_type);
|
|
2785 mask_file = potential_pixmap_file_instantiator (inst, Q_mask_file,
|
|
2786 Q_mask_data, console_type);
|
|
2787
|
|
2788 if (CONSP (file)) /* failure locating filename */
|
563
|
2789 signal_double_image_error ("Opening bitmap file",
|
|
2790 "no such file or directory",
|
|
2791 Fcar (file));
|
428
|
2792
|
|
2793 if (NILP (file) && NILP (mask_file)) /* no conversion necessary */
|
|
2794 RETURN_UNGCPRO (inst);
|
|
2795
|
|
2796 alist = tagged_vector_to_alist (inst);
|
|
2797
|
|
2798 {
|
|
2799 Lisp_Object data = make_string_from_file (file);
|
|
2800 alist = remassq_no_quit (Q_file, alist);
|
|
2801 /* there can't be a :data at this point. */
|
|
2802 alist = Fcons (Fcons (Q_file, file),
|
|
2803 Fcons (Fcons (Q_data, data), alist));
|
|
2804 }
|
|
2805
|
|
2806 alist = xbm_mask_file_munging (alist, file, mask_file, console_type);
|
|
2807
|
|
2808 {
|
|
2809 Lisp_Object result = alist_to_tagged_vector (Qxface, alist);
|
|
2810 free_alist (alist);
|
|
2811 RETURN_UNGCPRO (result);
|
|
2812 }
|
|
2813 }
|
|
2814
|
|
2815 static int
|
|
2816 xface_possible_dest_types (void)
|
|
2817 {
|
|
2818 return
|
|
2819 IMAGE_MONO_PIXMAP_MASK |
|
|
2820 IMAGE_COLOR_PIXMAP_MASK |
|
|
2821 IMAGE_POINTER_MASK;
|
|
2822 }
|
|
2823
|
|
2824 #endif /* HAVE_XFACE */
|
|
2825
|
|
2826
|
|
2827 #ifdef HAVE_XPM
|
|
2828
|
|
2829 /**********************************************************************
|
|
2830 * XPM *
|
|
2831 **********************************************************************/
|
|
2832
|
462
|
2833 #ifdef HAVE_GTK
|
|
2834 /* Gtk has to be gratuitously different, eh? */
|
|
2835 Lisp_Object
|
|
2836 pixmap_to_lisp_data (Lisp_Object name, int ok_if_data_invalid)
|
|
2837 {
|
|
2838 return (make_string_from_file (name));
|
|
2839 }
|
|
2840 #else
|
428
|
2841 Lisp_Object
|
|
2842 pixmap_to_lisp_data (Lisp_Object name, int ok_if_data_invalid)
|
|
2843 {
|
|
2844 char **data;
|
|
2845 int result;
|
|
2846 char *fname = 0;
|
440
|
2847
|
442
|
2848 LISP_STRING_TO_EXTERNAL (name, fname, Qfile_name);
|
428
|
2849 result = XpmReadFileToData (fname, &data);
|
|
2850
|
|
2851 if (result == XpmSuccess)
|
|
2852 {
|
|
2853 Lisp_Object retval = Qnil;
|
|
2854 struct buffer *old_buffer = current_buffer;
|
|
2855 Lisp_Object temp_buffer =
|
|
2856 Fget_buffer_create (build_string (" *pixmap conversion*"));
|
|
2857 int elt;
|
|
2858 int height, width, ncolors;
|
|
2859 struct gcpro gcpro1, gcpro2, gcpro3;
|
|
2860 int speccount = specpdl_depth ();
|
|
2861
|
|
2862 GCPRO3 (name, retval, temp_buffer);
|
|
2863
|
|
2864 specbind (Qinhibit_quit, Qt);
|
|
2865 set_buffer_internal (XBUFFER (temp_buffer));
|
|
2866 Ferase_buffer (Qnil);
|
|
2867
|
|
2868 buffer_insert_c_string (current_buffer, "/* XPM */\r");
|
|
2869 buffer_insert_c_string (current_buffer, "static char *pixmap[] = {\r");
|
|
2870
|
|
2871 sscanf (data[0], "%d %d %d", &height, &width, &ncolors);
|
|
2872 for (elt = 0; elt <= width + ncolors; elt++)
|
|
2873 {
|
|
2874 buffer_insert_c_string (current_buffer, "\"");
|
|
2875 buffer_insert_c_string (current_buffer, data[elt]);
|
|
2876
|
|
2877 if (elt < width + ncolors)
|
|
2878 buffer_insert_c_string (current_buffer, "\",\r");
|
|
2879 else
|
|
2880 buffer_insert_c_string (current_buffer, "\"};\r");
|
|
2881 }
|
|
2882
|
|
2883 retval = Fbuffer_substring (Qnil, Qnil, Qnil);
|
|
2884 XpmFree (data);
|
|
2885
|
|
2886 set_buffer_internal (old_buffer);
|
771
|
2887 unbind_to (speccount);
|
428
|
2888
|
|
2889 RETURN_UNGCPRO (retval);
|
|
2890 }
|
|
2891
|
|
2892 switch (result)
|
|
2893 {
|
|
2894 case XpmFileInvalid:
|
|
2895 {
|
|
2896 if (ok_if_data_invalid)
|
|
2897 return Qt;
|
|
2898 signal_image_error ("invalid XPM data in file", name);
|
|
2899 }
|
|
2900 case XpmNoMemory:
|
|
2901 {
|
563
|
2902 signal_double_image_error ("Reading pixmap file",
|
|
2903 "out of memory", name);
|
428
|
2904 }
|
|
2905 case XpmOpenFailed:
|
|
2906 {
|
|
2907 /* should never happen? */
|
563
|
2908 signal_double_image_error ("Opening pixmap file",
|
|
2909 "no such file or directory", name);
|
428
|
2910 }
|
|
2911 default:
|
|
2912 {
|
563
|
2913 signal_double_image_error_2 ("Parsing pixmap file",
|
|
2914 "unknown error code",
|
|
2915 make_int (result), name);
|
428
|
2916 break;
|
|
2917 }
|
|
2918 }
|
|
2919
|
|
2920 return Qnil; /* not reached */
|
|
2921 }
|
462
|
2922 #endif /* !HAVE_GTK */
|
428
|
2923
|
|
2924 static void
|
|
2925 check_valid_xpm_color_symbols (Lisp_Object data)
|
|
2926 {
|
|
2927 Lisp_Object rest;
|
|
2928
|
|
2929 for (rest = data; !NILP (rest); rest = XCDR (rest))
|
|
2930 {
|
|
2931 if (!CONSP (rest) ||
|
|
2932 !CONSP (XCAR (rest)) ||
|
|
2933 !STRINGP (XCAR (XCAR (rest))) ||
|
|
2934 (!STRINGP (XCDR (XCAR (rest))) &&
|
|
2935 !COLOR_SPECIFIERP (XCDR (XCAR (rest)))))
|
563
|
2936 sferror ("Invalid color symbol alist", data);
|
428
|
2937 }
|
|
2938 }
|
|
2939
|
|
2940 static void
|
|
2941 xpm_validate (Lisp_Object instantiator)
|
|
2942 {
|
|
2943 file_or_data_must_be_present (instantiator);
|
|
2944 }
|
|
2945
|
|
2946 Lisp_Object Vxpm_color_symbols;
|
|
2947
|
|
2948 Lisp_Object
|
|
2949 evaluate_xpm_color_symbols (void)
|
|
2950 {
|
|
2951 Lisp_Object rest, results = Qnil;
|
|
2952 struct gcpro gcpro1, gcpro2;
|
|
2953
|
|
2954 GCPRO2 (rest, results);
|
|
2955 for (rest = Vxpm_color_symbols; !NILP (rest); rest = XCDR (rest))
|
|
2956 {
|
|
2957 Lisp_Object name, value, cons;
|
|
2958
|
|
2959 CHECK_CONS (rest);
|
|
2960 cons = XCAR (rest);
|
|
2961 CHECK_CONS (cons);
|
|
2962 name = XCAR (cons);
|
|
2963 CHECK_STRING (name);
|
|
2964 value = XCDR (cons);
|
|
2965 CHECK_CONS (value);
|
|
2966 value = XCAR (value);
|
|
2967 value = Feval (value);
|
|
2968 if (NILP (value))
|
|
2969 continue;
|
|
2970 if (!STRINGP (value) && !COLOR_SPECIFIERP (value))
|
563
|
2971 invalid_argument
|
428
|
2972 ("Result from xpm-color-symbols eval must be nil, string, or color",
|
|
2973 value);
|
|
2974 results = Fcons (Fcons (name, value), results);
|
|
2975 }
|
|
2976 UNGCPRO; /* no more evaluation */
|
|
2977 return results;
|
|
2978 }
|
|
2979
|
|
2980 static Lisp_Object
|
442
|
2981 xpm_normalize (Lisp_Object inst, Lisp_Object console_type,
|
|
2982 Lisp_Object dest_mask)
|
428
|
2983 {
|
|
2984 Lisp_Object file = Qnil;
|
|
2985 Lisp_Object color_symbols;
|
|
2986 struct gcpro gcpro1, gcpro2;
|
|
2987 Lisp_Object alist = Qnil;
|
|
2988
|
|
2989 GCPRO2 (file, alist);
|
|
2990
|
|
2991 /* Now, convert any file data into inline data. At the end of this,
|
|
2992 `data' will contain the inline data (if any) or Qnil, and
|
|
2993 `file' will contain the name this data was derived from (if
|
|
2994 known) or Qnil.
|
|
2995
|
|
2996 Note that if we cannot generate any regular inline data, we
|
|
2997 skip out. */
|
|
2998
|
|
2999 file = potential_pixmap_file_instantiator (inst, Q_file, Q_data,
|
|
3000 console_type);
|
|
3001
|
|
3002 if (CONSP (file)) /* failure locating filename */
|
563
|
3003 signal_double_image_error ("Opening pixmap file",
|
|
3004 "no such file or directory",
|
|
3005 Fcar (file));
|
428
|
3006
|
|
3007 color_symbols = find_keyword_in_vector_or_given (inst, Q_color_symbols,
|
|
3008 Qunbound);
|
|
3009
|
|
3010 if (NILP (file) && !UNBOUNDP (color_symbols))
|
|
3011 /* no conversion necessary */
|
|
3012 RETURN_UNGCPRO (inst);
|
|
3013
|
|
3014 alist = tagged_vector_to_alist (inst);
|
|
3015
|
|
3016 if (!NILP (file))
|
|
3017 {
|
|
3018 Lisp_Object data = pixmap_to_lisp_data (file, 0);
|
|
3019 alist = remassq_no_quit (Q_file, alist);
|
|
3020 /* there can't be a :data at this point. */
|
|
3021 alist = Fcons (Fcons (Q_file, file),
|
|
3022 Fcons (Fcons (Q_data, data), alist));
|
|
3023 }
|
|
3024
|
|
3025 if (UNBOUNDP (color_symbols))
|
|
3026 {
|
|
3027 color_symbols = evaluate_xpm_color_symbols ();
|
|
3028 alist = Fcons (Fcons (Q_color_symbols, color_symbols),
|
|
3029 alist);
|
|
3030 }
|
|
3031
|
|
3032 {
|
|
3033 Lisp_Object result = alist_to_tagged_vector (Qxpm, alist);
|
|
3034 free_alist (alist);
|
|
3035 RETURN_UNGCPRO (result);
|
|
3036 }
|
|
3037 }
|
|
3038
|
|
3039 static int
|
|
3040 xpm_possible_dest_types (void)
|
|
3041 {
|
|
3042 return
|
|
3043 IMAGE_MONO_PIXMAP_MASK |
|
|
3044 IMAGE_COLOR_PIXMAP_MASK |
|
|
3045 IMAGE_POINTER_MASK;
|
|
3046 }
|
|
3047
|
|
3048 #endif /* HAVE_XPM */
|
|
3049
|
|
3050
|
|
3051 /****************************************************************************
|
|
3052 * Image Specifier Object *
|
|
3053 ****************************************************************************/
|
|
3054
|
|
3055 DEFINE_SPECIFIER_TYPE (image);
|
|
3056
|
|
3057 static void
|
|
3058 image_create (Lisp_Object obj)
|
|
3059 {
|
440
|
3060 Lisp_Specifier *image = XIMAGE_SPECIFIER (obj);
|
428
|
3061
|
|
3062 IMAGE_SPECIFIER_ALLOWED (image) = ~0; /* all are allowed */
|
|
3063 IMAGE_SPECIFIER_ATTACHEE (image) = Qnil;
|
|
3064 IMAGE_SPECIFIER_ATTACHEE_PROPERTY (image) = Qnil;
|
|
3065 }
|
|
3066
|
|
3067 static void
|
|
3068 image_mark (Lisp_Object obj)
|
|
3069 {
|
440
|
3070 Lisp_Specifier *image = XIMAGE_SPECIFIER (obj);
|
428
|
3071
|
|
3072 mark_object (IMAGE_SPECIFIER_ATTACHEE (image));
|
|
3073 mark_object (IMAGE_SPECIFIER_ATTACHEE_PROPERTY (image));
|
|
3074 }
|
|
3075
|
450
|
3076 static int
|
|
3077 instantiator_eq_equal (Lisp_Object obj1, Lisp_Object obj2)
|
|
3078 {
|
|
3079 if (EQ (obj1, obj2))
|
|
3080 return 1;
|
|
3081
|
|
3082 else if (CONSP (obj1) && CONSP (obj2))
|
|
3083 {
|
|
3084 return instantiator_eq_equal (XCAR (obj1), XCAR (obj2))
|
|
3085 &&
|
|
3086 instantiator_eq_equal (XCDR (obj1), XCDR (obj2));
|
|
3087 }
|
|
3088 return 0;
|
|
3089 }
|
|
3090
|
665
|
3091 static Hashcode
|
450
|
3092 instantiator_eq_hash (Lisp_Object obj)
|
|
3093 {
|
|
3094 if (CONSP (obj))
|
|
3095 {
|
|
3096 /* no point in worrying about tail recursion, since we're not
|
|
3097 going very deep */
|
|
3098 return HASH2 (instantiator_eq_hash (XCAR (obj)),
|
|
3099 instantiator_eq_hash (XCDR (obj)));
|
|
3100 }
|
|
3101 return LISP_HASH (obj);
|
|
3102 }
|
|
3103
|
|
3104 /* We need a special hash table for storing image instances. */
|
|
3105 Lisp_Object
|
|
3106 make_image_instance_cache_hash_table (void)
|
|
3107 {
|
|
3108 return make_general_lisp_hash_table
|
|
3109 (instantiator_eq_hash, instantiator_eq_equal,
|
|
3110 30, -1.0, -1.0,
|
|
3111 HASH_TABLE_KEY_CAR_VALUE_WEAK);
|
|
3112 }
|
|
3113
|
428
|
3114 static Lisp_Object
|
|
3115 image_instantiate_cache_result (Lisp_Object locative)
|
|
3116 {
|
442
|
3117 /* locative = (instance instantiator . subtable)
|
|
3118
|
|
3119 So we are using the instantiator as the key and the instance as
|
|
3120 the value. Since the hashtable is key-weak this means that the
|
|
3121 image instance will stay around as long as the instantiator stays
|
|
3122 around. The instantiator is stored in the `image' slot of the
|
|
3123 glyph, so as long as the glyph is marked the instantiator will be
|
|
3124 as well and hence the cached image instance also.*/
|
428
|
3125 Fputhash (XCAR (XCDR (locative)), XCAR (locative), XCDR (XCDR (locative)));
|
|
3126 free_cons (XCONS (XCDR (locative)));
|
|
3127 free_cons (XCONS (locative));
|
|
3128 return Qnil;
|
|
3129 }
|
|
3130
|
|
3131 /* Given a specification for an image, return an instance of
|
|
3132 the image which matches the given instantiator and which can be
|
|
3133 displayed in the given domain. */
|
|
3134
|
|
3135 static Lisp_Object
|
|
3136 image_instantiate (Lisp_Object specifier, Lisp_Object matchspec,
|
|
3137 Lisp_Object domain, Lisp_Object instantiator,
|
|
3138 Lisp_Object depth)
|
|
3139 {
|
438
|
3140 Lisp_Object glyph = IMAGE_SPECIFIER_ATTACHEE (XIMAGE_SPECIFIER (specifier));
|
428
|
3141 int dest_mask = XIMAGE_SPECIFIER_ALLOWED (specifier);
|
|
3142 int pointerp = dest_mask & image_instance_type_to_mask (IMAGE_POINTER);
|
|
3143
|
|
3144 if (IMAGE_INSTANCEP (instantiator))
|
|
3145 {
|
442
|
3146 /* make sure that the image instance's governing domain and type are
|
428
|
3147 matching. */
|
442
|
3148 Lisp_Object governing_domain = XIMAGE_INSTANCE_DOMAIN (instantiator);
|
|
3149
|
|
3150 if ((DEVICEP (governing_domain)
|
|
3151 && EQ (governing_domain, DOMAIN_DEVICE (domain)))
|
|
3152 || (FRAMEP (governing_domain)
|
|
3153 && EQ (governing_domain, DOMAIN_FRAME (domain)))
|
|
3154 || (WINDOWP (governing_domain)
|
|
3155 && EQ (governing_domain, DOMAIN_WINDOW (domain))))
|
428
|
3156 {
|
|
3157 int mask =
|
|
3158 image_instance_type_to_mask (XIMAGE_INSTANCE_TYPE (instantiator));
|
|
3159 if (mask & dest_mask)
|
|
3160 return instantiator;
|
|
3161 else
|
563
|
3162 invalid_argument ("Type of image instance not allowed here",
|
428
|
3163 instantiator);
|
|
3164 }
|
|
3165 else
|
563
|
3166 invalid_argument_2 ("Wrong domain for image instance",
|
442
|
3167 instantiator, domain);
|
428
|
3168 }
|
452
|
3169 /* How ugly !! An image instanciator that uses a kludgy syntax to snarf in
|
|
3170 face properties. There's a design flaw here. -- didier */
|
428
|
3171 else if (VECTORP (instantiator)
|
450
|
3172 && EQ (INSTANTIATOR_TYPE (instantiator), Qinherit))
|
428
|
3173 {
|
|
3174 assert (XVECTOR_LENGTH (instantiator) == 3);
|
|
3175 return (FACE_PROPERTY_INSTANCE
|
|
3176 (Fget_face (XVECTOR_DATA (instantiator)[2]),
|
452
|
3177 Qbackground_pixmap, domain, 1, depth));
|
428
|
3178 }
|
|
3179 else
|
|
3180 {
|
442
|
3181 Lisp_Object instance = Qnil;
|
|
3182 Lisp_Object subtable = Qnil;
|
450
|
3183 /* #### Should this be GCPRO'd? */
|
|
3184 Lisp_Object hash_key = Qnil;
|
428
|
3185 Lisp_Object pointer_fg = Qnil;
|
|
3186 Lisp_Object pointer_bg = Qnil;
|
442
|
3187 Lisp_Object governing_domain =
|
|
3188 get_image_instantiator_governing_domain (instantiator, domain);
|
|
3189 struct gcpro gcpro1;
|
|
3190
|
|
3191 GCPRO1 (instance);
|
|
3192
|
|
3193 /* We have to put subwindow, widget and text image instances in
|
|
3194 a per-window cache so that we can see the same glyph in
|
|
3195 different windows. We use governing_domain to determine the type
|
|
3196 of image_instance that will be created. */
|
428
|
3197
|
|
3198 if (pointerp)
|
|
3199 {
|
|
3200 pointer_fg = FACE_FOREGROUND (Vpointer_face, domain);
|
|
3201 pointer_bg = FACE_BACKGROUND (Vpointer_face, domain);
|
452
|
3202 hash_key = list4 (glyph, INSTANTIATOR_TYPE (instantiator),
|
450
|
3203 pointer_fg, pointer_bg);
|
428
|
3204 }
|
450
|
3205 else
|
|
3206 /* We cannot simply key on the glyph since fallbacks could use
|
|
3207 the same glyph but have a totally different instantiator
|
|
3208 type. Thus we key on the glyph and the type (but not any
|
|
3209 other parts of the instantiator. */
|
|
3210 hash_key = list2 (glyph, INSTANTIATOR_TYPE (instantiator));
|
428
|
3211
|
442
|
3212 /* First look in the device cache. */
|
|
3213 if (DEVICEP (governing_domain))
|
428
|
3214 {
|
442
|
3215 subtable = Fgethash (make_int (dest_mask),
|
|
3216 XDEVICE (governing_domain)->
|
|
3217 image_instance_cache,
|
|
3218 Qunbound);
|
|
3219 if (UNBOUNDP (subtable))
|
|
3220 {
|
|
3221 /* For the image instance cache, we do comparisons with
|
|
3222 EQ rather than with EQUAL, as we do for color and
|
|
3223 font names. The reasons are:
|
|
3224
|
|
3225 1) pixmap data can be very long, and thus the hashing
|
|
3226 and comparing will take awhile.
|
|
3227
|
|
3228 2) It's not so likely that we'll run into things that
|
|
3229 are EQUAL but not EQ (that can happen a lot with
|
|
3230 faces, because their specifiers are copied around);
|
|
3231 but pixmaps tend not to be in faces.
|
|
3232
|
|
3233 However, if the image-instance could be a pointer, we
|
|
3234 have to use EQUAL because we massaged the
|
|
3235 instantiator into a cons3 also containing the
|
|
3236 foreground and background of the pointer face. */
|
450
|
3237 subtable = make_image_instance_cache_hash_table ();
|
|
3238
|
442
|
3239 Fputhash (make_int (dest_mask), subtable,
|
|
3240 XDEVICE (governing_domain)->image_instance_cache);
|
|
3241 instance = Qunbound;
|
|
3242 }
|
|
3243 else
|
|
3244 {
|
450
|
3245 instance = Fgethash (hash_key, subtable, Qunbound);
|
442
|
3246 }
|
|
3247 }
|
|
3248 else if (WINDOWP (governing_domain))
|
|
3249 {
|
|
3250 /* Subwindows have a per-window cache and have to be treated
|
|
3251 differently. */
|
|
3252 instance =
|
450
|
3253 Fgethash (hash_key,
|
442
|
3254 XWINDOW (governing_domain)->subwindow_instance_cache,
|
|
3255 Qunbound);
|
428
|
3256 }
|
|
3257 else
|
442
|
3258 abort (); /* We're not allowed anything else currently. */
|
|
3259
|
|
3260 /* If we don't have an instance at this point then create
|
|
3261 one. */
|
428
|
3262 if (UNBOUNDP (instance))
|
|
3263 {
|
|
3264 Lisp_Object locative =
|
|
3265 noseeum_cons (Qnil,
|
450
|
3266 noseeum_cons (hash_key,
|
442
|
3267 DEVICEP (governing_domain) ? subtable
|
|
3268 : XWINDOW (governing_domain)
|
|
3269 ->subwindow_instance_cache));
|
428
|
3270 int speccount = specpdl_depth ();
|
440
|
3271
|
442
|
3272 /* Make sure we cache the failures, too. Use an
|
|
3273 unwind-protect to catch such errors. If we fail, the
|
|
3274 unwind-protect records nil in the hash table. If we
|
|
3275 succeed, we change the car of the locative to the
|
|
3276 resulting instance, which gets recorded instead. */
|
428
|
3277 record_unwind_protect (image_instantiate_cache_result,
|
|
3278 locative);
|
442
|
3279 instance =
|
|
3280 instantiate_image_instantiator (governing_domain,
|
|
3281 domain, instantiator,
|
|
3282 pointer_fg, pointer_bg,
|
|
3283 dest_mask, glyph);
|
|
3284
|
|
3285 /* We need a per-frame cache for redisplay. */
|
|
3286 cache_subwindow_instance_in_frame_maybe (instance);
|
440
|
3287
|
428
|
3288 Fsetcar (locative, instance);
|
442
|
3289 #ifdef ERROR_CHECK_GLYPHS
|
|
3290 if (image_instance_type_to_mask (XIMAGE_INSTANCE_TYPE (instance))
|
|
3291 & (IMAGE_SUBWINDOW_MASK | IMAGE_WIDGET_MASK))
|
|
3292 assert (EQ (XIMAGE_INSTANCE_FRAME (instance),
|
|
3293 DOMAIN_FRAME (domain)));
|
|
3294 #endif
|
771
|
3295 unbind_to (speccount);
|
442
|
3296 #ifdef ERROR_CHECK_GLYPHS
|
428
|
3297 if (image_instance_type_to_mask (XIMAGE_INSTANCE_TYPE (instance))
|
442
|
3298 & (IMAGE_SUBWINDOW_MASK | IMAGE_WIDGET_MASK))
|
450
|
3299 assert (EQ (Fgethash (hash_key,
|
442
|
3300 XWINDOW (governing_domain)
|
|
3301 ->subwindow_instance_cache,
|
|
3302 Qunbound), instance));
|
|
3303 #endif
|
428
|
3304 }
|
442
|
3305 else if (NILP (instance))
|
563
|
3306 gui_error ("Can't instantiate image (probably cached)", instantiator);
|
442
|
3307 /* We found an instance. However, because we are using the glyph
|
|
3308 as the hash key instead of the instantiator, the current
|
|
3309 instantiator may not be the same as the original. Thus we
|
|
3310 must update the instance based on the new
|
|
3311 instantiator. Preserving instance identity like this is
|
|
3312 important to stop excessive window system widget creation and
|
|
3313 deletion - and hence flashing. */
|
|
3314 else
|
|
3315 {
|
|
3316 /* #### This function should be able to cope with *all*
|
|
3317 changes to the instantiator, but currently only copes
|
|
3318 with the most used properties. This means that it is
|
|
3319 possible to make changes that don't get reflected in the
|
|
3320 display. */
|
|
3321 update_image_instance (instance, instantiator);
|
450
|
3322 free_list (hash_key);
|
442
|
3323 }
|
|
3324
|
|
3325 #ifdef ERROR_CHECK_GLYPHS
|
|
3326 if (image_instance_type_to_mask (XIMAGE_INSTANCE_TYPE (instance))
|
|
3327 & (IMAGE_SUBWINDOW_MASK | IMAGE_WIDGET_MASK))
|
|
3328 assert (EQ (XIMAGE_INSTANCE_FRAME (instance),
|
|
3329 DOMAIN_FRAME (domain)));
|
|
3330 #endif
|
|
3331 ERROR_CHECK_IMAGE_INSTANCE (instance);
|
|
3332 RETURN_UNGCPRO (instance);
|
428
|
3333 }
|
|
3334
|
|
3335 abort ();
|
|
3336 return Qnil; /* not reached */
|
|
3337 }
|
|
3338
|
|
3339 /* Validate an image instantiator. */
|
|
3340
|
|
3341 static void
|
|
3342 image_validate (Lisp_Object instantiator)
|
|
3343 {
|
|
3344 if (IMAGE_INSTANCEP (instantiator) || STRINGP (instantiator))
|
|
3345 return;
|
|
3346 else if (VECTORP (instantiator))
|
|
3347 {
|
|
3348 Lisp_Object *elt = XVECTOR_DATA (instantiator);
|
|
3349 int instantiator_len = XVECTOR_LENGTH (instantiator);
|
|
3350 struct image_instantiator_methods *meths;
|
|
3351 Lisp_Object already_seen = Qnil;
|
|
3352 struct gcpro gcpro1;
|
|
3353 int i;
|
|
3354
|
|
3355 if (instantiator_len < 1)
|
563
|
3356 sferror ("Vector length must be at least 1",
|
428
|
3357 instantiator);
|
|
3358
|
|
3359 meths = decode_image_instantiator_format (elt[0], ERROR_ME);
|
|
3360 if (!(instantiator_len & 1))
|
563
|
3361 sferror
|
428
|
3362 ("Must have alternating keyword/value pairs", instantiator);
|
|
3363
|
|
3364 GCPRO1 (already_seen);
|
|
3365
|
|
3366 for (i = 1; i < instantiator_len; i += 2)
|
|
3367 {
|
|
3368 Lisp_Object keyword = elt[i];
|
|
3369 Lisp_Object value = elt[i+1];
|
|
3370 int j;
|
|
3371
|
|
3372 CHECK_SYMBOL (keyword);
|
|
3373 if (!SYMBOL_IS_KEYWORD (keyword))
|
563
|
3374 invalid_argument ("Symbol must begin with a colon", keyword);
|
428
|
3375
|
|
3376 for (j = 0; j < Dynarr_length (meths->keywords); j++)
|
|
3377 if (EQ (keyword, Dynarr_at (meths->keywords, j).keyword))
|
|
3378 break;
|
|
3379
|
|
3380 if (j == Dynarr_length (meths->keywords))
|
563
|
3381 invalid_argument ("Unrecognized keyword", keyword);
|
428
|
3382
|
|
3383 if (!Dynarr_at (meths->keywords, j).multiple_p)
|
|
3384 {
|
|
3385 if (!NILP (memq_no_quit (keyword, already_seen)))
|
563
|
3386 sferror
|
428
|
3387 ("Keyword may not appear more than once", keyword);
|
|
3388 already_seen = Fcons (keyword, already_seen);
|
|
3389 }
|
|
3390
|
|
3391 (Dynarr_at (meths->keywords, j).validate) (value);
|
|
3392 }
|
|
3393
|
|
3394 UNGCPRO;
|
|
3395
|
|
3396 MAYBE_IIFORMAT_METH (meths, validate, (instantiator));
|
|
3397 }
|
|
3398 else
|
563
|
3399 invalid_argument ("Must be string or vector", instantiator);
|
428
|
3400 }
|
|
3401
|
|
3402 static void
|
|
3403 image_after_change (Lisp_Object specifier, Lisp_Object locale)
|
|
3404 {
|
|
3405 Lisp_Object attachee =
|
|
3406 IMAGE_SPECIFIER_ATTACHEE (XIMAGE_SPECIFIER (specifier));
|
|
3407 Lisp_Object property =
|
|
3408 IMAGE_SPECIFIER_ATTACHEE_PROPERTY (XIMAGE_SPECIFIER (specifier));
|
|
3409 if (FACEP (attachee))
|
448
|
3410 {
|
|
3411 face_property_was_changed (attachee, property, locale);
|
|
3412 if (BUFFERP (locale))
|
|
3413 XBUFFER (locale)->buffer_local_face_property = 1;
|
|
3414 }
|
428
|
3415 else if (GLYPHP (attachee))
|
|
3416 glyph_property_was_changed (attachee, property, locale);
|
|
3417 }
|
|
3418
|
|
3419 void
|
|
3420 set_image_attached_to (Lisp_Object obj, Lisp_Object face_or_glyph,
|
|
3421 Lisp_Object property)
|
|
3422 {
|
440
|
3423 Lisp_Specifier *image = XIMAGE_SPECIFIER (obj);
|
428
|
3424
|
|
3425 IMAGE_SPECIFIER_ATTACHEE (image) = face_or_glyph;
|
|
3426 IMAGE_SPECIFIER_ATTACHEE_PROPERTY (image) = property;
|
|
3427 }
|
|
3428
|
|
3429 static Lisp_Object
|
|
3430 image_going_to_add (Lisp_Object specifier, Lisp_Object locale,
|
|
3431 Lisp_Object tag_set, Lisp_Object instantiator)
|
|
3432 {
|
|
3433 Lisp_Object possible_console_types = Qnil;
|
|
3434 Lisp_Object rest;
|
|
3435 Lisp_Object retlist = Qnil;
|
|
3436 struct gcpro gcpro1, gcpro2;
|
|
3437
|
|
3438 LIST_LOOP (rest, Vconsole_type_list)
|
|
3439 {
|
|
3440 Lisp_Object contype = XCAR (rest);
|
|
3441 if (!NILP (memq_no_quit (contype, tag_set)))
|
|
3442 possible_console_types = Fcons (contype, possible_console_types);
|
|
3443 }
|
|
3444
|
|
3445 if (XINT (Flength (possible_console_types)) > 1)
|
|
3446 /* two conflicting console types specified */
|
|
3447 return Qnil;
|
|
3448
|
|
3449 if (NILP (possible_console_types))
|
|
3450 possible_console_types = Vconsole_type_list;
|
|
3451
|
|
3452 GCPRO2 (retlist, possible_console_types);
|
|
3453
|
|
3454 LIST_LOOP (rest, possible_console_types)
|
|
3455 {
|
|
3456 Lisp_Object contype = XCAR (rest);
|
|
3457 Lisp_Object newinst = call_with_suspended_errors
|
|
3458 ((lisp_fn_t) normalize_image_instantiator,
|
793
|
3459 Qnil, Qimage, ERROR_ME_DEBUG_WARN, 3, instantiator, contype,
|
428
|
3460 make_int (XIMAGE_SPECIFIER_ALLOWED (specifier)));
|
|
3461
|
|
3462 if (!NILP (newinst))
|
|
3463 {
|
|
3464 Lisp_Object newtag;
|
|
3465 if (NILP (memq_no_quit (contype, tag_set)))
|
|
3466 newtag = Fcons (contype, tag_set);
|
|
3467 else
|
|
3468 newtag = tag_set;
|
|
3469 retlist = Fcons (Fcons (newtag, newinst), retlist);
|
|
3470 }
|
|
3471 }
|
|
3472
|
|
3473 UNGCPRO;
|
|
3474
|
|
3475 return retlist;
|
|
3476 }
|
|
3477
|
434
|
3478 /* Copy an image instantiator. We can't use Fcopy_tree since widgets
|
|
3479 may contain circular references which would send Fcopy_tree into
|
|
3480 infloop death. */
|
|
3481 static Lisp_Object
|
|
3482 image_copy_vector_instantiator (Lisp_Object instantiator)
|
|
3483 {
|
|
3484 int i;
|
|
3485 struct image_instantiator_methods *meths;
|
|
3486 Lisp_Object *elt;
|
|
3487 int instantiator_len;
|
|
3488
|
|
3489 CHECK_VECTOR (instantiator);
|
|
3490
|
|
3491 instantiator = Fcopy_sequence (instantiator);
|
|
3492 elt = XVECTOR_DATA (instantiator);
|
|
3493 instantiator_len = XVECTOR_LENGTH (instantiator);
|
440
|
3494
|
434
|
3495 meths = decode_image_instantiator_format (elt[0], ERROR_ME);
|
|
3496
|
|
3497 for (i = 1; i < instantiator_len; i += 2)
|
|
3498 {
|
|
3499 int j;
|
|
3500 Lisp_Object keyword = elt[i];
|
|
3501 Lisp_Object value = elt[i+1];
|
|
3502
|
|
3503 /* Find the keyword entry. */
|
|
3504 for (j = 0; j < Dynarr_length (meths->keywords); j++)
|
|
3505 {
|
|
3506 if (EQ (keyword, Dynarr_at (meths->keywords, j).keyword))
|
|
3507 break;
|
|
3508 }
|
|
3509
|
|
3510 /* Only copy keyword values that should be copied. */
|
|
3511 if (Dynarr_at (meths->keywords, j).copy_p
|
|
3512 &&
|
|
3513 (CONSP (value) || VECTORP (value)))
|
|
3514 {
|
|
3515 elt [i+1] = Fcopy_tree (value, Qt);
|
|
3516 }
|
|
3517 }
|
|
3518
|
|
3519 return instantiator;
|
|
3520 }
|
|
3521
|
|
3522 static Lisp_Object
|
|
3523 image_copy_instantiator (Lisp_Object arg)
|
|
3524 {
|
|
3525 if (CONSP (arg))
|
|
3526 {
|
|
3527 Lisp_Object rest;
|
|
3528 rest = arg = Fcopy_sequence (arg);
|
|
3529 while (CONSP (rest))
|
|
3530 {
|
|
3531 Lisp_Object elt = XCAR (rest);
|
|
3532 if (CONSP (elt))
|
|
3533 XCAR (rest) = Fcopy_tree (elt, Qt);
|
|
3534 else if (VECTORP (elt))
|
|
3535 XCAR (rest) = image_copy_vector_instantiator (elt);
|
|
3536 if (VECTORP (XCDR (rest))) /* hack for (a b . [c d]) */
|
|
3537 XCDR (rest) = Fcopy_tree (XCDR (rest), Qt);
|
|
3538 rest = XCDR (rest);
|
|
3539 }
|
|
3540 }
|
|
3541 else if (VECTORP (arg))
|
|
3542 {
|
|
3543 arg = image_copy_vector_instantiator (arg);
|
|
3544 }
|
|
3545 return arg;
|
|
3546 }
|
|
3547
|
428
|
3548 DEFUN ("image-specifier-p", Fimage_specifier_p, 1, 1, 0, /*
|
|
3549 Return non-nil if OBJECT is an image specifier.
|
442
|
3550 See `make-image-specifier' for a description of image instantiators.
|
428
|
3551 */
|
|
3552 (object))
|
|
3553 {
|
|
3554 return IMAGE_SPECIFIERP (object) ? Qt : Qnil;
|
|
3555 }
|
|
3556
|
|
3557
|
|
3558 /****************************************************************************
|
|
3559 * Glyph Object *
|
|
3560 ****************************************************************************/
|
|
3561
|
|
3562 static Lisp_Object
|
|
3563 mark_glyph (Lisp_Object obj)
|
|
3564 {
|
440
|
3565 Lisp_Glyph *glyph = XGLYPH (obj);
|
428
|
3566
|
|
3567 mark_object (glyph->image);
|
|
3568 mark_object (glyph->contrib_p);
|
|
3569 mark_object (glyph->baseline);
|
|
3570 mark_object (glyph->face);
|
|
3571
|
|
3572 return glyph->plist;
|
|
3573 }
|
|
3574
|
|
3575 static void
|
|
3576 print_glyph (Lisp_Object obj, Lisp_Object printcharfun, int escapeflag)
|
|
3577 {
|
440
|
3578 Lisp_Glyph *glyph = XGLYPH (obj);
|
428
|
3579 char buf[20];
|
|
3580
|
|
3581 if (print_readably)
|
563
|
3582 printing_unreadable_object ("#<glyph 0x%x>", glyph->header.uid);
|
428
|
3583
|
|
3584 write_c_string ("#<glyph (", printcharfun);
|
|
3585 print_internal (Fglyph_type (obj), printcharfun, 0);
|
|
3586 write_c_string (") ", printcharfun);
|
|
3587 print_internal (glyph->image, printcharfun, 1);
|
|
3588 sprintf (buf, "0x%x>", glyph->header.uid);
|
|
3589 write_c_string (buf, printcharfun);
|
|
3590 }
|
|
3591
|
|
3592 /* Glyphs are equal if all of their display attributes are equal. We
|
|
3593 don't compare names or doc-strings, because that would make equal
|
|
3594 be eq.
|
|
3595
|
|
3596 This isn't concerned with "unspecified" attributes, that's what
|
|
3597 #'glyph-differs-from-default-p is for. */
|
|
3598 static int
|
|
3599 glyph_equal (Lisp_Object obj1, Lisp_Object obj2, int depth)
|
|
3600 {
|
440
|
3601 Lisp_Glyph *g1 = XGLYPH (obj1);
|
|
3602 Lisp_Glyph *g2 = XGLYPH (obj2);
|
428
|
3603
|
|
3604 depth++;
|
|
3605
|
|
3606 return (internal_equal (g1->image, g2->image, depth) &&
|
|
3607 internal_equal (g1->contrib_p, g2->contrib_p, depth) &&
|
|
3608 internal_equal (g1->baseline, g2->baseline, depth) &&
|
|
3609 internal_equal (g1->face, g2->face, depth) &&
|
|
3610 !plists_differ (g1->plist, g2->plist, 0, 0, depth + 1));
|
|
3611 }
|
|
3612
|
665
|
3613 static Hashcode
|
428
|
3614 glyph_hash (Lisp_Object obj, int depth)
|
|
3615 {
|
|
3616 depth++;
|
|
3617
|
|
3618 /* No need to hash all of the elements; that would take too long.
|
|
3619 Just hash the most common ones. */
|
|
3620 return HASH2 (internal_hash (XGLYPH (obj)->image, depth),
|
|
3621 internal_hash (XGLYPH (obj)->face, depth));
|
|
3622 }
|
|
3623
|
|
3624 static Lisp_Object
|
|
3625 glyph_getprop (Lisp_Object obj, Lisp_Object prop)
|
|
3626 {
|
440
|
3627 Lisp_Glyph *g = XGLYPH (obj);
|
428
|
3628
|
|
3629 if (EQ (prop, Qimage)) return g->image;
|
|
3630 if (EQ (prop, Qcontrib_p)) return g->contrib_p;
|
|
3631 if (EQ (prop, Qbaseline)) return g->baseline;
|
|
3632 if (EQ (prop, Qface)) return g->face;
|
|
3633
|
|
3634 return external_plist_get (&g->plist, prop, 0, ERROR_ME);
|
|
3635 }
|
|
3636
|
|
3637 static int
|
|
3638 glyph_putprop (Lisp_Object obj, Lisp_Object prop, Lisp_Object value)
|
|
3639 {
|
|
3640 if (EQ (prop, Qimage) ||
|
|
3641 EQ (prop, Qcontrib_p) ||
|
|
3642 EQ (prop, Qbaseline))
|
|
3643 return 0;
|
|
3644
|
|
3645 if (EQ (prop, Qface))
|
|
3646 {
|
|
3647 XGLYPH (obj)->face = Fget_face (value);
|
|
3648 return 1;
|
|
3649 }
|
|
3650
|
|
3651 external_plist_put (&XGLYPH (obj)->plist, prop, value, 0, ERROR_ME);
|
|
3652 return 1;
|
|
3653 }
|
|
3654
|
|
3655 static int
|
|
3656 glyph_remprop (Lisp_Object obj, Lisp_Object prop)
|
|
3657 {
|
|
3658 if (EQ (prop, Qimage) ||
|
|
3659 EQ (prop, Qcontrib_p) ||
|
|
3660 EQ (prop, Qbaseline))
|
|
3661 return -1;
|
|
3662
|
|
3663 if (EQ (prop, Qface))
|
|
3664 {
|
|
3665 XGLYPH (obj)->face = Qnil;
|
|
3666 return 1;
|
|
3667 }
|
|
3668
|
|
3669 return external_remprop (&XGLYPH (obj)->plist, prop, 0, ERROR_ME);
|
|
3670 }
|
|
3671
|
|
3672 static Lisp_Object
|
|
3673 glyph_plist (Lisp_Object obj)
|
|
3674 {
|
440
|
3675 Lisp_Glyph *glyph = XGLYPH (obj);
|
428
|
3676 Lisp_Object result = glyph->plist;
|
|
3677
|
|
3678 result = cons3 (Qface, glyph->face, result);
|
|
3679 result = cons3 (Qbaseline, glyph->baseline, result);
|
|
3680 result = cons3 (Qcontrib_p, glyph->contrib_p, result);
|
|
3681 result = cons3 (Qimage, glyph->image, result);
|
|
3682
|
|
3683 return result;
|
|
3684 }
|
|
3685
|
|
3686 static const struct lrecord_description glyph_description[] = {
|
440
|
3687 { XD_LISP_OBJECT, offsetof (Lisp_Glyph, image) },
|
|
3688 { XD_LISP_OBJECT, offsetof (Lisp_Glyph, contrib_p) },
|
|
3689 { XD_LISP_OBJECT, offsetof (Lisp_Glyph, baseline) },
|
|
3690 { XD_LISP_OBJECT, offsetof (Lisp_Glyph, face) },
|
|
3691 { XD_LISP_OBJECT, offsetof (Lisp_Glyph, plist) },
|
428
|
3692 { XD_END }
|
|
3693 };
|
|
3694
|
|
3695 DEFINE_LRECORD_IMPLEMENTATION_WITH_PROPS ("glyph", glyph,
|
|
3696 mark_glyph, print_glyph, 0,
|
|
3697 glyph_equal, glyph_hash, glyph_description,
|
|
3698 glyph_getprop, glyph_putprop,
|
|
3699 glyph_remprop, glyph_plist,
|
440
|
3700 Lisp_Glyph);
|
428
|
3701
|
|
3702 Lisp_Object
|
|
3703 allocate_glyph (enum glyph_type type,
|
|
3704 void (*after_change) (Lisp_Object glyph, Lisp_Object property,
|
|
3705 Lisp_Object locale))
|
|
3706 {
|
|
3707 /* This function can GC */
|
|
3708 Lisp_Object obj = Qnil;
|
440
|
3709 Lisp_Glyph *g = alloc_lcrecord_type (Lisp_Glyph, &lrecord_glyph);
|
428
|
3710
|
|
3711 g->type = type;
|
|
3712 g->image = Fmake_specifier (Qimage); /* This function can GC */
|
|
3713 g->dirty = 0;
|
|
3714 switch (g->type)
|
|
3715 {
|
|
3716 case GLYPH_BUFFER:
|
|
3717 XIMAGE_SPECIFIER_ALLOWED (g->image) =
|
440
|
3718 IMAGE_NOTHING_MASK | IMAGE_TEXT_MASK
|
|
3719 | IMAGE_MONO_PIXMAP_MASK | IMAGE_COLOR_PIXMAP_MASK
|
442
|
3720 | IMAGE_SUBWINDOW_MASK | IMAGE_WIDGET_MASK;
|
428
|
3721 break;
|
|
3722 case GLYPH_POINTER:
|
|
3723 XIMAGE_SPECIFIER_ALLOWED (g->image) =
|
|
3724 IMAGE_NOTHING_MASK | IMAGE_POINTER_MASK;
|
|
3725 break;
|
|
3726 case GLYPH_ICON:
|
|
3727 XIMAGE_SPECIFIER_ALLOWED (g->image) =
|
438
|
3728 IMAGE_NOTHING_MASK | IMAGE_MONO_PIXMAP_MASK
|
|
3729 | IMAGE_COLOR_PIXMAP_MASK;
|
428
|
3730 break;
|
|
3731 default:
|
|
3732 abort ();
|
|
3733 }
|
|
3734
|
|
3735 /* I think Fmake_specifier can GC. I think set_specifier_fallback can GC. */
|
|
3736 /* We're getting enough reports of odd behavior in this area it seems */
|
|
3737 /* best to GCPRO everything. */
|
|
3738 {
|
|
3739 Lisp_Object tem1 = list1 (Fcons (Qnil, Vthe_nothing_vector));
|
|
3740 Lisp_Object tem2 = list1 (Fcons (Qnil, Qt));
|
|
3741 Lisp_Object tem3 = list1 (Fcons (Qnil, Qnil));
|
|
3742 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
|
|
3743
|
|
3744 GCPRO4 (obj, tem1, tem2, tem3);
|
|
3745
|
|
3746 set_specifier_fallback (g->image, tem1);
|
|
3747 g->contrib_p = Fmake_specifier (Qboolean);
|
|
3748 set_specifier_fallback (g->contrib_p, tem2);
|
|
3749 /* #### should have a specifier for the following */
|
|
3750 g->baseline = Fmake_specifier (Qgeneric);
|
|
3751 set_specifier_fallback (g->baseline, tem3);
|
|
3752 g->face = Qnil;
|
|
3753 g->plist = Qnil;
|
|
3754 g->after_change = after_change;
|
793
|
3755 obj = wrap_glyph (g);
|
428
|
3756
|
|
3757 set_image_attached_to (g->image, obj, Qimage);
|
|
3758 UNGCPRO;
|
|
3759 }
|
|
3760
|
|
3761 return obj;
|
|
3762 }
|
|
3763
|
|
3764 static enum glyph_type
|
578
|
3765 decode_glyph_type (Lisp_Object type, Error_Behavior errb)
|
428
|
3766 {
|
|
3767 if (NILP (type))
|
|
3768 return GLYPH_BUFFER;
|
|
3769
|
|
3770 if (ERRB_EQ (errb, ERROR_ME))
|
|
3771 CHECK_SYMBOL (type);
|
|
3772
|
|
3773 if (EQ (type, Qbuffer)) return GLYPH_BUFFER;
|
|
3774 if (EQ (type, Qpointer)) return GLYPH_POINTER;
|
|
3775 if (EQ (type, Qicon)) return GLYPH_ICON;
|
|
3776
|
563
|
3777 maybe_invalid_constant ("Invalid glyph type", type, Qimage, errb);
|
428
|
3778
|
|
3779 return GLYPH_UNKNOWN;
|
|
3780 }
|
|
3781
|
|
3782 static int
|
|
3783 valid_glyph_type_p (Lisp_Object type)
|
|
3784 {
|
|
3785 return !NILP (memq_no_quit (type, Vglyph_type_list));
|
|
3786 }
|
|
3787
|
|
3788 DEFUN ("valid-glyph-type-p", Fvalid_glyph_type_p, 1, 1, 0, /*
|
|
3789 Given a GLYPH-TYPE, return non-nil if it is valid.
|
|
3790 Valid types are `buffer', `pointer', and `icon'.
|
|
3791 */
|
|
3792 (glyph_type))
|
|
3793 {
|
|
3794 return valid_glyph_type_p (glyph_type) ? Qt : Qnil;
|
|
3795 }
|
|
3796
|
|
3797 DEFUN ("glyph-type-list", Fglyph_type_list, 0, 0, 0, /*
|
|
3798 Return a list of valid glyph types.
|
|
3799 */
|
|
3800 ())
|
|
3801 {
|
|
3802 return Fcopy_sequence (Vglyph_type_list);
|
|
3803 }
|
|
3804
|
|
3805 DEFUN ("make-glyph-internal", Fmake_glyph_internal, 0, 1, 0, /*
|
442
|
3806 Create and return a new uninitialized glyph of type TYPE.
|
428
|
3807
|
|
3808 TYPE specifies the type of the glyph; this should be one of `buffer',
|
|
3809 `pointer', or `icon', and defaults to `buffer'. The type of the glyph
|
|
3810 specifies in which contexts the glyph can be used, and controls the
|
|
3811 allowable image types into which the glyph's image can be
|
|
3812 instantiated.
|
|
3813
|
|
3814 `buffer' glyphs can be used as the begin-glyph or end-glyph of an
|
|
3815 extent, in the modeline, and in the toolbar. Their image can be
|
|
3816 instantiated as `nothing', `mono-pixmap', `color-pixmap', `text',
|
|
3817 and `subwindow'.
|
|
3818
|
|
3819 `pointer' glyphs can be used to specify the mouse pointer. Their
|
|
3820 image can be instantiated as `pointer'.
|
|
3821
|
|
3822 `icon' glyphs can be used to specify the icon used when a frame is
|
|
3823 iconified. Their image can be instantiated as `mono-pixmap' and
|
|
3824 `color-pixmap'.
|
|
3825 */
|
|
3826 (type))
|
|
3827 {
|
|
3828 enum glyph_type typeval = decode_glyph_type (type, ERROR_ME);
|
|
3829 return allocate_glyph (typeval, 0);
|
|
3830 }
|
|
3831
|
|
3832 DEFUN ("glyphp", Fglyphp, 1, 1, 0, /*
|
|
3833 Return non-nil if OBJECT is a glyph.
|
|
3834
|
442
|
3835 A glyph is an object used for pixmaps, widgets and the like. It is used
|
428
|
3836 in begin-glyphs and end-glyphs attached to extents, in marginal and textual
|
|
3837 annotations, in overlay arrows (overlay-arrow-* variables), in toolbar
|
442
|
3838 buttons, and the like. Much more detailed information can be found at
|
|
3839 `make-glyph'. Its image is described using an image specifier --
|
|
3840 see `make-image-specifier'. See also `make-image-instance' for further
|
|
3841 information.
|
428
|
3842 */
|
|
3843 (object))
|
|
3844 {
|
|
3845 return GLYPHP (object) ? Qt : Qnil;
|
|
3846 }
|
|
3847
|
|
3848 DEFUN ("glyph-type", Fglyph_type, 1, 1, 0, /*
|
|
3849 Return the type of the given glyph.
|
|
3850 The return value will be one of 'buffer, 'pointer, or 'icon.
|
|
3851 */
|
|
3852 (glyph))
|
|
3853 {
|
|
3854 CHECK_GLYPH (glyph);
|
|
3855 switch (XGLYPH_TYPE (glyph))
|
|
3856 {
|
|
3857 default: abort ();
|
|
3858 case GLYPH_BUFFER: return Qbuffer;
|
|
3859 case GLYPH_POINTER: return Qpointer;
|
|
3860 case GLYPH_ICON: return Qicon;
|
|
3861 }
|
|
3862 }
|
|
3863
|
438
|
3864 Lisp_Object
|
|
3865 glyph_image_instance (Lisp_Object glyph, Lisp_Object domain,
|
578
|
3866 Error_Behavior errb, int no_quit)
|
438
|
3867 {
|
|
3868 Lisp_Object specifier = GLYPH_IMAGE (XGLYPH (glyph));
|
|
3869
|
|
3870 /* This can never return Qunbound. All glyphs have 'nothing as
|
|
3871 a fallback. */
|
440
|
3872 Lisp_Object image_instance = specifier_instance (specifier, Qunbound,
|
438
|
3873 domain, errb, no_quit, 0,
|
|
3874 Qzero);
|
440
|
3875 assert (!UNBOUNDP (image_instance));
|
442
|
3876 ERROR_CHECK_IMAGE_INSTANCE (image_instance);
|
438
|
3877
|
|
3878 return image_instance;
|
|
3879 }
|
|
3880
|
|
3881 static Lisp_Object
|
|
3882 glyph_image_instance_maybe (Lisp_Object glyph_or_image, Lisp_Object window)
|
|
3883 {
|
|
3884 Lisp_Object instance = glyph_or_image;
|
|
3885
|
|
3886 if (GLYPHP (glyph_or_image))
|
793
|
3887 instance = glyph_image_instance (glyph_or_image, window,
|
|
3888 ERROR_ME_DEBUG_WARN, 1);
|
438
|
3889
|
|
3890 return instance;
|
|
3891 }
|
|
3892
|
428
|
3893 /*****************************************************************************
|
|
3894 glyph_width
|
|
3895
|
438
|
3896 Return the width of the given GLYPH on the given WINDOW.
|
|
3897 Calculations are done based on recursively querying the geometry of
|
|
3898 the associated image instances.
|
428
|
3899 ****************************************************************************/
|
|
3900 unsigned short
|
438
|
3901 glyph_width (Lisp_Object glyph_or_image, Lisp_Object domain)
|
428
|
3902 {
|
438
|
3903 Lisp_Object instance = glyph_image_instance_maybe (glyph_or_image,
|
|
3904 domain);
|
428
|
3905 if (!IMAGE_INSTANCEP (instance))
|
|
3906 return 0;
|
|
3907
|
442
|
3908 if (XIMAGE_INSTANCE_NEEDS_LAYOUT (instance))
|
438
|
3909 image_instance_layout (instance, IMAGE_UNSPECIFIED_GEOMETRY,
|
442
|
3910 IMAGE_UNSPECIFIED_GEOMETRY,
|
|
3911 IMAGE_UNCHANGED_GEOMETRY,
|
|
3912 IMAGE_UNCHANGED_GEOMETRY, domain);
|
438
|
3913
|
|
3914 return XIMAGE_INSTANCE_WIDTH (instance);
|
428
|
3915 }
|
|
3916
|
|
3917 DEFUN ("glyph-width", Fglyph_width, 1, 2, 0, /*
|
|
3918 Return the width of GLYPH on WINDOW.
|
|
3919 This may not be exact as it does not take into account all of the context
|
|
3920 that redisplay will.
|
|
3921 */
|
|
3922 (glyph, window))
|
|
3923 {
|
793
|
3924 window = wrap_window (decode_window (window));
|
428
|
3925 CHECK_GLYPH (glyph);
|
|
3926
|
438
|
3927 return make_int (glyph_width (glyph, window));
|
428
|
3928 }
|
|
3929
|
|
3930 unsigned short
|
438
|
3931 glyph_ascent (Lisp_Object glyph_or_image, Lisp_Object domain)
|
428
|
3932 {
|
438
|
3933 Lisp_Object instance = glyph_image_instance_maybe (glyph_or_image,
|
|
3934 domain);
|
|
3935 if (!IMAGE_INSTANCEP (instance))
|
|
3936 return 0;
|
|
3937
|
442
|
3938 if (XIMAGE_INSTANCE_NEEDS_LAYOUT (instance))
|
438
|
3939 image_instance_layout (instance, IMAGE_UNSPECIFIED_GEOMETRY,
|
442
|
3940 IMAGE_UNSPECIFIED_GEOMETRY,
|
|
3941 IMAGE_UNCHANGED_GEOMETRY,
|
|
3942 IMAGE_UNCHANGED_GEOMETRY, domain);
|
438
|
3943
|
|
3944 if (XIMAGE_INSTANCE_TYPE (instance) == IMAGE_TEXT)
|
|
3945 return XIMAGE_INSTANCE_TEXT_ASCENT (instance);
|
|
3946 else
|
|
3947 return XIMAGE_INSTANCE_HEIGHT (instance);
|
428
|
3948 }
|
|
3949
|
|
3950 unsigned short
|
438
|
3951 glyph_descent (Lisp_Object glyph_or_image, Lisp_Object domain)
|
428
|
3952 {
|
438
|
3953 Lisp_Object instance = glyph_image_instance_maybe (glyph_or_image,
|
|
3954 domain);
|
|
3955 if (!IMAGE_INSTANCEP (instance))
|
|
3956 return 0;
|
|
3957
|
442
|
3958 if (XIMAGE_INSTANCE_NEEDS_LAYOUT (instance))
|
438
|
3959 image_instance_layout (instance, IMAGE_UNSPECIFIED_GEOMETRY,
|
442
|
3960 IMAGE_UNSPECIFIED_GEOMETRY,
|
|
3961 IMAGE_UNCHANGED_GEOMETRY,
|
|
3962 IMAGE_UNCHANGED_GEOMETRY, domain);
|
438
|
3963
|
|
3964 if (XIMAGE_INSTANCE_TYPE (instance) == IMAGE_TEXT)
|
|
3965 return XIMAGE_INSTANCE_TEXT_DESCENT (instance);
|
|
3966 else
|
|
3967 return 0;
|
428
|
3968 }
|
|
3969
|
|
3970 /* strictly a convenience function. */
|
|
3971 unsigned short
|
438
|
3972 glyph_height (Lisp_Object glyph_or_image, Lisp_Object domain)
|
428
|
3973 {
|
438
|
3974 Lisp_Object instance = glyph_image_instance_maybe (glyph_or_image,
|
|
3975 domain);
|
440
|
3976
|
438
|
3977 if (!IMAGE_INSTANCEP (instance))
|
|
3978 return 0;
|
|
3979
|
442
|
3980 if (XIMAGE_INSTANCE_NEEDS_LAYOUT (instance))
|
438
|
3981 image_instance_layout (instance, IMAGE_UNSPECIFIED_GEOMETRY,
|
442
|
3982 IMAGE_UNSPECIFIED_GEOMETRY,
|
|
3983 IMAGE_UNCHANGED_GEOMETRY,
|
|
3984 IMAGE_UNCHANGED_GEOMETRY, domain);
|
438
|
3985
|
|
3986 return XIMAGE_INSTANCE_HEIGHT (instance);
|
428
|
3987 }
|
|
3988
|
|
3989 DEFUN ("glyph-ascent", Fglyph_ascent, 1, 2, 0, /*
|
|
3990 Return the ascent value of GLYPH on WINDOW.
|
|
3991 This may not be exact as it does not take into account all of the context
|
|
3992 that redisplay will.
|
|
3993 */
|
|
3994 (glyph, window))
|
|
3995 {
|
793
|
3996 window = wrap_window (decode_window (window));
|
428
|
3997 CHECK_GLYPH (glyph);
|
|
3998
|
438
|
3999 return make_int (glyph_ascent (glyph, window));
|
428
|
4000 }
|
|
4001
|
|
4002 DEFUN ("glyph-descent", Fglyph_descent, 1, 2, 0, /*
|
|
4003 Return the descent value of GLYPH on WINDOW.
|
|
4004 This may not be exact as it does not take into account all of the context
|
|
4005 that redisplay will.
|
|
4006 */
|
|
4007 (glyph, window))
|
|
4008 {
|
793
|
4009 window = wrap_window (decode_window (window));
|
428
|
4010 CHECK_GLYPH (glyph);
|
|
4011
|
438
|
4012 return make_int (glyph_descent (glyph, window));
|
428
|
4013 }
|
|
4014
|
|
4015 /* This is redundant but I bet a lot of people expect it to exist. */
|
|
4016 DEFUN ("glyph-height", Fglyph_height, 1, 2, 0, /*
|
|
4017 Return the height of GLYPH on WINDOW.
|
|
4018 This may not be exact as it does not take into account all of the context
|
|
4019 that redisplay will.
|
|
4020 */
|
|
4021 (glyph, window))
|
|
4022 {
|
793
|
4023 window = wrap_window (decode_window (window));
|
428
|
4024 CHECK_GLYPH (glyph);
|
|
4025
|
438
|
4026 return make_int (glyph_height (glyph, window));
|
428
|
4027 }
|
|
4028
|
|
4029 static void
|
|
4030 set_glyph_dirty_p (Lisp_Object glyph_or_image, Lisp_Object window, int dirty)
|
|
4031 {
|
|
4032 Lisp_Object instance = glyph_or_image;
|
|
4033
|
|
4034 if (!NILP (glyph_or_image))
|
|
4035 {
|
|
4036 if (GLYPHP (glyph_or_image))
|
|
4037 {
|
|
4038 instance = glyph_image_instance (glyph_or_image, window,
|
793
|
4039 ERROR_ME_DEBUG_WARN, 1);
|
428
|
4040 XGLYPH_DIRTYP (glyph_or_image) = dirty;
|
|
4041 }
|
|
4042
|
442
|
4043 if (!IMAGE_INSTANCEP (instance))
|
|
4044 return;
|
|
4045
|
428
|
4046 XIMAGE_INSTANCE_DIRTYP (instance) = dirty;
|
|
4047 }
|
|
4048 }
|
|
4049
|
442
|
4050 static void
|
|
4051 set_image_instance_dirty_p (Lisp_Object instance, int dirty)
|
|
4052 {
|
|
4053 if (IMAGE_INSTANCEP (instance))
|
|
4054 {
|
|
4055 XIMAGE_INSTANCE_DIRTYP (instance) = dirty;
|
|
4056 /* Now cascade up the hierarchy. */
|
|
4057 set_image_instance_dirty_p (XIMAGE_INSTANCE_PARENT (instance),
|
|
4058 dirty);
|
|
4059 }
|
|
4060 else if (GLYPHP (instance))
|
|
4061 {
|
|
4062 XGLYPH_DIRTYP (instance) = dirty;
|
|
4063 }
|
|
4064 }
|
|
4065
|
428
|
4066 /* #### do we need to cache this info to speed things up? */
|
|
4067
|
|
4068 Lisp_Object
|
|
4069 glyph_baseline (Lisp_Object glyph, Lisp_Object domain)
|
|
4070 {
|
|
4071 if (!GLYPHP (glyph))
|
|
4072 return Qnil;
|
|
4073 else
|
|
4074 {
|
|
4075 Lisp_Object retval =
|
|
4076 specifier_instance_no_quit (GLYPH_BASELINE (XGLYPH (glyph)),
|
793
|
4077 /* #### look into error flag */
|
|
4078 Qunbound, domain, ERROR_ME_DEBUG_WARN,
|
428
|
4079 0, Qzero);
|
|
4080 if (!NILP (retval) && !INTP (retval))
|
|
4081 retval = Qnil;
|
|
4082 else if (INTP (retval))
|
|
4083 {
|
|
4084 if (XINT (retval) < 0)
|
|
4085 retval = Qzero;
|
|
4086 if (XINT (retval) > 100)
|
|
4087 retval = make_int (100);
|
|
4088 }
|
|
4089 return retval;
|
|
4090 }
|
|
4091 }
|
|
4092
|
|
4093 Lisp_Object
|
|
4094 glyph_face (Lisp_Object glyph, Lisp_Object domain)
|
|
4095 {
|
|
4096 /* #### Domain parameter not currently used but it will be */
|
|
4097 return GLYPHP (glyph) ? GLYPH_FACE (XGLYPH (glyph)) : Qnil;
|
|
4098 }
|
|
4099
|
|
4100 int
|
|
4101 glyph_contrib_p (Lisp_Object glyph, Lisp_Object domain)
|
|
4102 {
|
|
4103 if (!GLYPHP (glyph))
|
|
4104 return 0;
|
|
4105 else
|
|
4106 return !NILP (specifier_instance_no_quit
|
|
4107 (GLYPH_CONTRIB_P (XGLYPH (glyph)), Qunbound, domain,
|
793
|
4108 /* #### look into error flag */
|
|
4109 ERROR_ME_DEBUG_WARN, 0, Qzero));
|
428
|
4110 }
|
|
4111
|
|
4112 static void
|
|
4113 glyph_property_was_changed (Lisp_Object glyph, Lisp_Object property,
|
|
4114 Lisp_Object locale)
|
|
4115 {
|
|
4116 if (XGLYPH (glyph)->after_change)
|
|
4117 (XGLYPH (glyph)->after_change) (glyph, property, locale);
|
|
4118 }
|
|
4119
|
442
|
4120 void
|
|
4121 glyph_query_geometry (Lisp_Object glyph_or_image, int* width, int* height,
|
438
|
4122 enum image_instance_geometry disp, Lisp_Object domain)
|
|
4123 {
|
|
4124 Lisp_Object instance = glyph_or_image;
|
|
4125
|
|
4126 if (GLYPHP (glyph_or_image))
|
793
|
4127 instance = glyph_image_instance (glyph_or_image, domain,
|
|
4128 ERROR_ME_DEBUG_WARN, 1);
|
440
|
4129
|
438
|
4130 image_instance_query_geometry (instance, width, height, disp, domain);
|
|
4131 }
|
|
4132
|
442
|
4133 void
|
|
4134 glyph_do_layout (Lisp_Object glyph_or_image, int width, int height,
|
|
4135 int xoffset, int yoffset, Lisp_Object domain)
|
438
|
4136 {
|
|
4137 Lisp_Object instance = glyph_or_image;
|
|
4138
|
|
4139 if (GLYPHP (glyph_or_image))
|
793
|
4140 instance = glyph_image_instance (glyph_or_image, domain,
|
|
4141 ERROR_ME_DEBUG_WARN, 1);
|
442
|
4142
|
|
4143 image_instance_layout (instance, width, height, xoffset, yoffset, domain);
|
|
4144 }
|
438
|
4145
|
428
|
4146
|
|
4147 /*****************************************************************************
|
|
4148 * glyph cachel functions *
|
|
4149 *****************************************************************************/
|
|
4150
|
442
|
4151 /* #### All of this is 95% copied from face cachels. Consider
|
|
4152 consolidating.
|
|
4153
|
|
4154 Why do we need glyph_cachels? Simply because a glyph_cachel captures
|
|
4155 per-window information about a particular glyph. A glyph itself is
|
|
4156 not created in any particular context, so if we were to rely on a
|
|
4157 glyph to tell us about its dirtiness we would not be able to reset
|
|
4158 the dirty flag after redisplaying it as it may exist in other
|
|
4159 contexts. When we have redisplayed we need to know which glyphs to
|
|
4160 reset the dirty flags on - the glyph_cachels give us a nice list we
|
|
4161 can iterate through doing this. */
|
428
|
4162 void
|
|
4163 mark_glyph_cachels (glyph_cachel_dynarr *elements)
|
|
4164 {
|
|
4165 int elt;
|
|
4166
|
|
4167 if (!elements)
|
|
4168 return;
|
|
4169
|
|
4170 for (elt = 0; elt < Dynarr_length (elements); elt++)
|
|
4171 {
|
|
4172 struct glyph_cachel *cachel = Dynarr_atp (elements, elt);
|
|
4173 mark_object (cachel->glyph);
|
|
4174 }
|
|
4175 }
|
|
4176
|
|
4177 static void
|
|
4178 update_glyph_cachel_data (struct window *w, Lisp_Object glyph,
|
|
4179 struct glyph_cachel *cachel)
|
|
4180 {
|
|
4181 if (!cachel->updated || NILP (cachel->glyph) || !EQ (cachel->glyph, glyph)
|
440
|
4182 || XGLYPH_DIRTYP (cachel->glyph)
|
|
4183 || XFRAME(WINDOW_FRAME(w))->faces_changed)
|
428
|
4184 {
|
|
4185 Lisp_Object window, instance;
|
|
4186
|
793
|
4187 window = wrap_window (w);
|
428
|
4188
|
|
4189 cachel->glyph = glyph;
|
440
|
4190 /* Speed things up slightly by grabbing the glyph instantiation
|
|
4191 and passing it to the size functions. */
|
793
|
4192 instance = glyph_image_instance (glyph, window, ERROR_ME_DEBUG_WARN, 1);
|
440
|
4193
|
442
|
4194 if (!IMAGE_INSTANCEP (instance))
|
|
4195 return;
|
|
4196
|
440
|
4197 /* Mark text instance of the glyph dirty if faces have changed,
|
|
4198 because its geometry might have changed. */
|
|
4199 invalidate_glyph_geometry_maybe (instance, w);
|
|
4200
|
|
4201 /* #### Do the following 2 lines buy us anything? --kkm */
|
|
4202 XGLYPH_DIRTYP (glyph) = XIMAGE_INSTANCE_DIRTYP (instance);
|
|
4203 cachel->dirty = XGLYPH_DIRTYP (glyph);
|
438
|
4204 cachel->width = glyph_width (instance, window);
|
|
4205 cachel->ascent = glyph_ascent (instance, window);
|
|
4206 cachel->descent = glyph_descent (instance, window);
|
428
|
4207 }
|
|
4208
|
|
4209 cachel->updated = 1;
|
|
4210 }
|
|
4211
|
|
4212 static void
|
|
4213 add_glyph_cachel (struct window *w, Lisp_Object glyph)
|
|
4214 {
|
|
4215 struct glyph_cachel new_cachel;
|
|
4216
|
|
4217 xzero (new_cachel);
|
|
4218 new_cachel.glyph = Qnil;
|
|
4219
|
|
4220 update_glyph_cachel_data (w, glyph, &new_cachel);
|
|
4221 Dynarr_add (w->glyph_cachels, new_cachel);
|
|
4222 }
|
|
4223
|
|
4224 glyph_index
|
|
4225 get_glyph_cachel_index (struct window *w, Lisp_Object glyph)
|
|
4226 {
|
|
4227 int elt;
|
|
4228
|
|
4229 if (noninteractive)
|
|
4230 return 0;
|
|
4231
|
|
4232 for (elt = 0; elt < Dynarr_length (w->glyph_cachels); elt++)
|
|
4233 {
|
|
4234 struct glyph_cachel *cachel =
|
|
4235 Dynarr_atp (w->glyph_cachels, elt);
|
|
4236
|
|
4237 if (EQ (cachel->glyph, glyph) && !NILP (glyph))
|
|
4238 {
|
|
4239 update_glyph_cachel_data (w, glyph, cachel);
|
|
4240 return elt;
|
|
4241 }
|
|
4242 }
|
|
4243
|
|
4244 /* If we didn't find the glyph, add it and then return its index. */
|
|
4245 add_glyph_cachel (w, glyph);
|
|
4246 return elt;
|
|
4247 }
|
|
4248
|
|
4249 void
|
|
4250 reset_glyph_cachels (struct window *w)
|
|
4251 {
|
|
4252 Dynarr_reset (w->glyph_cachels);
|
|
4253 get_glyph_cachel_index (w, Vcontinuation_glyph);
|
|
4254 get_glyph_cachel_index (w, Vtruncation_glyph);
|
|
4255 get_glyph_cachel_index (w, Vhscroll_glyph);
|
|
4256 get_glyph_cachel_index (w, Vcontrol_arrow_glyph);
|
|
4257 get_glyph_cachel_index (w, Voctal_escape_glyph);
|
|
4258 get_glyph_cachel_index (w, Vinvisible_text_glyph);
|
|
4259 }
|
|
4260
|
|
4261 void
|
|
4262 mark_glyph_cachels_as_not_updated (struct window *w)
|
|
4263 {
|
|
4264 int elt;
|
|
4265
|
|
4266 /* We need to have a dirty flag to tell if the glyph has changed.
|
|
4267 We can check to see if each glyph variable is actually a
|
|
4268 completely different glyph, though. */
|
|
4269 #define FROB(glyph_obj, gindex) \
|
|
4270 update_glyph_cachel_data (w, glyph_obj, \
|
|
4271 Dynarr_atp (w->glyph_cachels, gindex))
|
|
4272
|
|
4273 FROB (Vcontinuation_glyph, CONT_GLYPH_INDEX);
|
|
4274 FROB (Vtruncation_glyph, TRUN_GLYPH_INDEX);
|
|
4275 FROB (Vhscroll_glyph, HSCROLL_GLYPH_INDEX);
|
|
4276 FROB (Vcontrol_arrow_glyph, CONTROL_GLYPH_INDEX);
|
|
4277 FROB (Voctal_escape_glyph, OCT_ESC_GLYPH_INDEX);
|
|
4278 FROB (Vinvisible_text_glyph, INVIS_GLYPH_INDEX);
|
|
4279 #undef FROB
|
|
4280
|
|
4281 for (elt = 0; elt < Dynarr_length (w->glyph_cachels); elt++)
|
|
4282 {
|
|
4283 Dynarr_atp (w->glyph_cachels, elt)->updated = 0;
|
|
4284 }
|
|
4285 }
|
|
4286
|
|
4287 /* Unset the dirty bit on all the glyph cachels that have it. */
|
440
|
4288 void
|
428
|
4289 mark_glyph_cachels_as_clean (struct window* w)
|
|
4290 {
|
|
4291 int elt;
|
793
|
4292 Lisp_Object window = wrap_window (w);
|
|
4293
|
428
|
4294 for (elt = 0; elt < Dynarr_length (w->glyph_cachels); elt++)
|
|
4295 {
|
|
4296 struct glyph_cachel *cachel = Dynarr_atp (w->glyph_cachels, elt);
|
|
4297 cachel->dirty = 0;
|
|
4298 set_glyph_dirty_p (cachel->glyph, window, 0);
|
|
4299 }
|
|
4300 }
|
|
4301
|
|
4302 #ifdef MEMORY_USAGE_STATS
|
|
4303
|
|
4304 int
|
|
4305 compute_glyph_cachel_usage (glyph_cachel_dynarr *glyph_cachels,
|
|
4306 struct overhead_stats *ovstats)
|
|
4307 {
|
|
4308 int total = 0;
|
|
4309
|
|
4310 if (glyph_cachels)
|
|
4311 total += Dynarr_memory_usage (glyph_cachels, ovstats);
|
|
4312
|
|
4313 return total;
|
|
4314 }
|
|
4315
|
|
4316 #endif /* MEMORY_USAGE_STATS */
|
|
4317
|
|
4318
|
|
4319
|
|
4320 /*****************************************************************************
|
793
|
4321 * subwindow cachel functions *
|
428
|
4322 *****************************************************************************/
|
438
|
4323 /* Subwindows are curious in that you have to physically unmap them to
|
428
|
4324 not display them. It is problematic deciding what to do in
|
|
4325 redisplay. We have two caches - a per-window instance cache that
|
|
4326 keeps track of subwindows on a window, these are linked to their
|
|
4327 instantiator in the hashtable and when the instantiator goes away
|
|
4328 we want the instance to go away also. However we also have a
|
|
4329 per-frame instance cache that we use to determine if a subwindow is
|
|
4330 obscuring an area that we want to clear. We need to be able to flip
|
|
4331 through this quickly so a hashtable is not suitable hence the
|
442
|
4332 subwindow_cachels. This is a weak list so unreference instances
|
|
4333 will get deleted properly. */
|
428
|
4334
|
|
4335 /* redisplay in general assumes that drawing something will erase
|
|
4336 what was there before. unfortunately this does not apply to
|
|
4337 subwindows that need to be specifically unmapped in order to
|
|
4338 disappear. we take a brute force approach - on the basis that its
|
|
4339 cheap - and unmap all subwindows in a display line */
|
442
|
4340
|
|
4341 /* Put new instances in the frame subwindow cache. This is less costly than
|
|
4342 doing it every time something gets mapped, and deleted instances will be
|
|
4343 removed automatically. */
|
|
4344 static void
|
|
4345 cache_subwindow_instance_in_frame_maybe (Lisp_Object instance)
|
|
4346 {
|
|
4347 Lisp_Image_Instance* ii = XIMAGE_INSTANCE (instance);
|
|
4348 if (!NILP (DOMAIN_FRAME (IMAGE_INSTANCE_DOMAIN (ii))))
|
428
|
4349 {
|
442
|
4350 struct frame* f = DOMAIN_XFRAME (IMAGE_INSTANCE_DOMAIN (ii));
|
|
4351 XWEAK_LIST_LIST (FRAME_SUBWINDOW_CACHE (f))
|
|
4352 = Fcons (instance, XWEAK_LIST_LIST (FRAME_SUBWINDOW_CACHE (f)));
|
|
4353 }
|
|
4354 }
|
|
4355
|
|
4356 /* Unmap and finalize all subwindow instances in the frame cache. This
|
|
4357 is necessary because GC will not guarantee the order things get
|
|
4358 deleted in and moreover, frame finalization deletes the window
|
|
4359 system windows before deleting XEmacs windows, and hence
|
|
4360 subwindows. */
|
|
4361 int
|
|
4362 unmap_subwindow_instance_cache_mapper (Lisp_Object key, Lisp_Object value,
|
|
4363 void* finalize)
|
|
4364 {
|
|
4365 /* value can be nil; we cache failures as well as successes */
|
|
4366 if (!NILP (value))
|
|
4367 {
|
|
4368 struct frame* f = XFRAME (XIMAGE_INSTANCE_FRAME (value));
|
|
4369 unmap_subwindow (value);
|
|
4370 if (finalize)
|
428
|
4371 {
|
442
|
4372 /* In case GC doesn't catch up fast enough, remove from the frame
|
|
4373 cache also. Otherwise code that checks the sanity of the instance
|
|
4374 will fail. */
|
|
4375 XWEAK_LIST_LIST (FRAME_SUBWINDOW_CACHE (f))
|
|
4376 = delq_no_quit (value,
|
|
4377 XWEAK_LIST_LIST (FRAME_SUBWINDOW_CACHE (f)));
|
|
4378 finalize_image_instance (XIMAGE_INSTANCE (value), 0);
|
428
|
4379 }
|
|
4380 }
|
442
|
4381 return 0;
|
|
4382 }
|
|
4383
|
|
4384 static void
|
|
4385 finalize_all_subwindow_instances (struct window *w)
|
|
4386 {
|
|
4387 if (!NILP (w->next)) finalize_all_subwindow_instances (XWINDOW (w->next));
|
|
4388 if (!NILP (w->vchild)) finalize_all_subwindow_instances (XWINDOW (w->vchild));
|
|
4389 if (!NILP (w->hchild)) finalize_all_subwindow_instances (XWINDOW (w->hchild));
|
|
4390
|
|
4391 elisp_maphash (unmap_subwindow_instance_cache_mapper,
|
|
4392 w->subwindow_instance_cache, (void*)1);
|
428
|
4393 }
|
|
4394
|
|
4395 void
|
442
|
4396 free_frame_subwindow_instances (struct frame* f)
|
|
4397 {
|
|
4398 /* Make sure all instances are finalized. We have to do this via the
|
|
4399 instance cache since some instances may be extant but not
|
|
4400 displayed (and hence not in the frame cache). */
|
|
4401 finalize_all_subwindow_instances (XWINDOW (f->root_window));
|
|
4402 }
|
|
4403
|
|
4404 /* Unmap all instances in the frame cache. */
|
|
4405 void
|
|
4406 reset_frame_subwindow_instance_cache (struct frame* f)
|
|
4407 {
|
|
4408 Lisp_Object rest;
|
|
4409
|
|
4410 LIST_LOOP (rest, XWEAK_LIST_LIST (FRAME_SUBWINDOW_CACHE (f)))
|
|
4411 {
|
|
4412 Lisp_Object value = XCAR (rest);
|
|
4413 unmap_subwindow (value);
|
|
4414 }
|
|
4415 }
|
428
|
4416
|
|
4417 /*****************************************************************************
|
|
4418 * subwindow exposure ignorance *
|
|
4419 *****************************************************************************/
|
|
4420 /* when we unmap subwindows the associated window system will generate
|
|
4421 expose events. This we do not want as redisplay already copes with
|
|
4422 the repainting necessary. Worse, we can get in an endless cycle of
|
|
4423 redisplay if we are not careful. Thus we keep a per-frame list of
|
|
4424 expose events that are going to come and ignore them as
|
|
4425 required. */
|
|
4426
|
|
4427 struct expose_ignore_blocktype
|
|
4428 {
|
|
4429 Blocktype_declare (struct expose_ignore);
|
|
4430 } *the_expose_ignore_blocktype;
|
|
4431
|
|
4432 int
|
647
|
4433 check_for_ignored_expose (struct frame* f, int x, int y, int width, int height)
|
428
|
4434 {
|
|
4435 struct expose_ignore *ei, *prev;
|
|
4436 /* the ignore list is FIFO so we should generally get a match with
|
|
4437 the first element in the list */
|
|
4438 for (ei = f->subwindow_exposures, prev = 0; ei; ei = ei->next)
|
|
4439 {
|
|
4440 /* Checking for exact matches just isn't good enough as we
|
442
|
4441 might get exposures for partially obscured subwindows, thus
|
|
4442 we have to check for overlaps. Being conservative, we will
|
|
4443 check for exposures wholly contained by the subwindow - this
|
428
|
4444 might give us what we want.*/
|
440
|
4445 if (ei->x <= x && ei->y <= y
|
428
|
4446 && ei->x + ei->width >= x + width
|
|
4447 && ei->y + ei->height >= y + height)
|
|
4448 {
|
|
4449 #ifdef DEBUG_WIDGETS
|
|
4450 stderr_out ("ignored %d+%d, %dx%d for exposure %d+%d, %dx%d\n",
|
|
4451 x, y, width, height, ei->x, ei->y, ei->width, ei->height);
|
|
4452 #endif
|
|
4453 if (!prev)
|
|
4454 f->subwindow_exposures = ei->next;
|
|
4455 else
|
|
4456 prev->next = ei->next;
|
440
|
4457
|
428
|
4458 if (ei == f->subwindow_exposures_tail)
|
|
4459 f->subwindow_exposures_tail = prev;
|
|
4460
|
|
4461 Blocktype_free (the_expose_ignore_blocktype, ei);
|
|
4462 return 1;
|
|
4463 }
|
|
4464 prev = ei;
|
|
4465 }
|
|
4466 return 0;
|
|
4467 }
|
|
4468
|
|
4469 static void
|
|
4470 register_ignored_expose (struct frame* f, int x, int y, int width, int height)
|
|
4471 {
|
|
4472 if (!hold_ignored_expose_registration)
|
|
4473 {
|
|
4474 struct expose_ignore *ei;
|
440
|
4475
|
428
|
4476 ei = Blocktype_alloc (the_expose_ignore_blocktype);
|
440
|
4477
|
428
|
4478 ei->next = NULL;
|
|
4479 ei->x = x;
|
|
4480 ei->y = y;
|
|
4481 ei->width = width;
|
|
4482 ei->height = height;
|
440
|
4483
|
428
|
4484 /* we have to add the exposure to the end of the list, since we
|
|
4485 want to check the oldest events first. for speed we keep a record
|
|
4486 of the end so that we can add right to it. */
|
|
4487 if (f->subwindow_exposures_tail)
|
|
4488 {
|
|
4489 f->subwindow_exposures_tail->next = ei;
|
|
4490 }
|
|
4491 if (!f->subwindow_exposures)
|
|
4492 {
|
|
4493 f->subwindow_exposures = ei;
|
|
4494 }
|
|
4495 f->subwindow_exposures_tail = ei;
|
|
4496 }
|
|
4497 }
|
|
4498
|
|
4499 /****************************************************************************
|
|
4500 find_matching_subwindow
|
|
4501
|
|
4502 See if there is a subwindow that completely encloses the requested
|
|
4503 area.
|
|
4504 ****************************************************************************/
|
647
|
4505 int
|
|
4506 find_matching_subwindow (struct frame* f, int x, int y, int width, int height)
|
428
|
4507 {
|
442
|
4508 Lisp_Object rest;
|
|
4509
|
|
4510 LIST_LOOP (rest, XWEAK_LIST_LIST (FRAME_SUBWINDOW_CACHE (f)))
|
428
|
4511 {
|
442
|
4512 Lisp_Image_Instance *ii = XIMAGE_INSTANCE (XCAR (rest));
|
|
4513
|
|
4514 if (IMAGE_INSTANCE_SUBWINDOW_DISPLAYEDP (ii)
|
|
4515 &&
|
|
4516 IMAGE_INSTANCE_DISPLAY_X (ii) <= x
|
428
|
4517 &&
|
442
|
4518 IMAGE_INSTANCE_DISPLAY_Y (ii) <= y
|
440
|
4519 &&
|
442
|
4520 IMAGE_INSTANCE_DISPLAY_X (ii)
|
|
4521 + IMAGE_INSTANCE_DISPLAY_WIDTH (ii) >= x + width
|
428
|
4522 &&
|
442
|
4523 IMAGE_INSTANCE_DISPLAY_Y (ii)
|
|
4524 + IMAGE_INSTANCE_DISPLAY_HEIGHT (ii) >= y + height)
|
428
|
4525 {
|
|
4526 return 1;
|
|
4527 }
|
|
4528 }
|
|
4529 return 0;
|
|
4530 }
|
|
4531
|
|
4532
|
|
4533 /*****************************************************************************
|
|
4534 * subwindow functions *
|
|
4535 *****************************************************************************/
|
|
4536
|
442
|
4537 /* Update the displayed characteristics of a subwindow. This function
|
|
4538 should generally only get called if the subwindow is actually
|
|
4539 dirty. */
|
|
4540 void
|
|
4541 redisplay_subwindow (Lisp_Object subwindow)
|
428
|
4542 {
|
440
|
4543 Lisp_Image_Instance* ii = XIMAGE_INSTANCE (subwindow);
|
442
|
4544 int count = specpdl_depth ();
|
|
4545
|
|
4546 /* The update method is allowed to call eval. Since it is quite
|
|
4547 common for this function to get called from somewhere in
|
|
4548 redisplay we need to make sure that quits are ignored. Otherwise
|
|
4549 Fsignal will abort. */
|
|
4550 specbind (Qinhibit_quit, Qt);
|
|
4551
|
|
4552 ERROR_CHECK_IMAGE_INSTANCE (subwindow);
|
|
4553
|
|
4554 if (WIDGET_IMAGE_INSTANCEP (subwindow))
|
|
4555 {
|
|
4556 if (image_instance_changed (subwindow))
|
|
4557 redisplay_widget (subwindow);
|
|
4558 /* Reset the changed flags. */
|
|
4559 IMAGE_INSTANCE_WIDGET_FACE_CHANGED (ii) = 0;
|
|
4560 IMAGE_INSTANCE_WIDGET_ITEMS_CHANGED (ii) = 0;
|
|
4561 IMAGE_INSTANCE_WIDGET_ACTION_OCCURRED (ii) = 0;
|
|
4562 IMAGE_INSTANCE_TEXT_CHANGED (ii) = 0;
|
|
4563 }
|
|
4564 else if (IMAGE_INSTANCE_TYPE (ii) == IMAGE_SUBWINDOW
|
|
4565 &&
|
|
4566 !NILP (IMAGE_INSTANCE_FRAME (ii)))
|
|
4567 {
|
|
4568 MAYBE_DEVMETH (DOMAIN_XDEVICE (ii->domain),
|
|
4569 redisplay_subwindow, (ii));
|
|
4570 }
|
|
4571
|
|
4572 IMAGE_INSTANCE_SIZE_CHANGED (ii) = 0;
|
|
4573 /* This function is typically called by redisplay just before
|
|
4574 outputting the information to the screen. Thus we record a hash
|
|
4575 of the output to determine whether on-screen is the same as
|
|
4576 recorded structure. This approach has limitations in there is a
|
|
4577 good chance that hash values will be different for the same
|
|
4578 visual appearance. However, we would rather that then the other
|
|
4579 way round - it simply means that we will get more displays than
|
|
4580 we might need. We can get better hashing by making the depth
|
|
4581 negative - currently it will recurse down 7 levels.*/
|
|
4582 IMAGE_INSTANCE_DISPLAY_HASH (ii) = internal_hash (subwindow,
|
|
4583 IMAGE_INSTANCE_HASH_DEPTH);
|
|
4584
|
771
|
4585 unbind_to (count);
|
442
|
4586 }
|
|
4587
|
|
4588 /* Determine whether an image_instance has changed structurally and
|
|
4589 hence needs redisplaying in some way.
|
|
4590
|
|
4591 #### This should just look at the instantiator differences when we
|
|
4592 get rid of the stored items altogether. In fact we should probably
|
|
4593 store the new instantiator as well as the old - as we do with
|
|
4594 gui_items currently - and then pick-up the new on the next
|
|
4595 redisplay. This would obviate the need for any of this trickery
|
|
4596 with hashcodes. */
|
|
4597 int
|
|
4598 image_instance_changed (Lisp_Object subwindow)
|
|
4599 {
|
|
4600 Lisp_Image_Instance* ii = XIMAGE_INSTANCE (subwindow);
|
|
4601
|
|
4602 if (internal_hash (subwindow, IMAGE_INSTANCE_HASH_DEPTH) !=
|
|
4603 IMAGE_INSTANCE_DISPLAY_HASH (ii))
|
|
4604 return 1;
|
|
4605 /* #### I think there is probably a bug here. This gets called for
|
|
4606 layouts - and yet the pending items are always nil for
|
|
4607 layouts. We are saved by layout optimization, but I'm undecided
|
|
4608 as to what the correct fix is. */
|
|
4609 else if (WIDGET_IMAGE_INSTANCEP (subwindow)
|
|
4610 && (!internal_equal (IMAGE_INSTANCE_WIDGET_ITEMS (ii),
|
|
4611 IMAGE_INSTANCE_WIDGET_PENDING_ITEMS (ii), 0)
|
|
4612 || !NILP (IMAGE_INSTANCE_LAYOUT_CHILDREN (ii))
|
|
4613 || IMAGE_INSTANCE_WIDGET_ACTION_OCCURRED (ii)))
|
|
4614 return 1;
|
|
4615 else
|
|
4616 return 0;
|
428
|
4617 }
|
|
4618
|
438
|
4619 /* Update all the subwindows on a frame. */
|
428
|
4620 void
|
442
|
4621 update_widget_instances (Lisp_Object frame)
|
|
4622 {
|
|
4623 struct frame* f;
|
|
4624 Lisp_Object rest;
|
|
4625
|
|
4626 /* Its possible for the preceding callback to have deleted the
|
|
4627 frame, so cope with this. */
|
|
4628 if (!FRAMEP (frame) || !FRAME_LIVE_P (XFRAME (frame)))
|
|
4629 return;
|
|
4630
|
|
4631 CHECK_FRAME (frame);
|
|
4632 f = XFRAME (frame);
|
|
4633
|
|
4634 /* If we get called we know something has changed. */
|
|
4635 LIST_LOOP (rest, XWEAK_LIST_LIST (FRAME_SUBWINDOW_CACHE (f)))
|
|
4636 {
|
|
4637 Lisp_Object widget = XCAR (rest);
|
|
4638
|
|
4639 if (XIMAGE_INSTANCE_SUBWINDOW_DISPLAYEDP (widget)
|
|
4640 &&
|
|
4641 image_instance_changed (widget))
|
|
4642 {
|
|
4643 set_image_instance_dirty_p (widget, 1);
|
|
4644 MARK_FRAME_GLYPHS_CHANGED (f);
|
|
4645 }
|
|
4646 }
|
428
|
4647 }
|
|
4648
|
|
4649 /* remove a subwindow from its frame */
|
793
|
4650 void
|
|
4651 unmap_subwindow (Lisp_Object subwindow)
|
428
|
4652 {
|
440
|
4653 Lisp_Image_Instance* ii = XIMAGE_INSTANCE (subwindow);
|
428
|
4654 struct frame* f;
|
|
4655
|
442
|
4656 ERROR_CHECK_IMAGE_INSTANCE (subwindow);
|
|
4657
|
|
4658 if (!image_instance_type_to_mask (IMAGE_INSTANCE_TYPE (ii))
|
|
4659 & (IMAGE_WIDGET_MASK | IMAGE_SUBWINDOW_MASK)
|
428
|
4660 ||
|
442
|
4661 !IMAGE_INSTANCE_SUBWINDOW_DISPLAYEDP (ii))
|
428
|
4662 return;
|
442
|
4663
|
428
|
4664 #ifdef DEBUG_WIDGETS
|
442
|
4665 stderr_out ("unmapping subwindow %p\n", IMAGE_INSTANCE_SUBWINDOW_ID (ii));
|
428
|
4666 #endif
|
442
|
4667 f = XFRAME (IMAGE_INSTANCE_FRAME (ii));
|
428
|
4668
|
|
4669 /* make sure we don't get expose events */
|
442
|
4670 register_ignored_expose (f, IMAGE_INSTANCE_DISPLAY_X (ii),
|
|
4671 IMAGE_INSTANCE_DISPLAY_Y (ii),
|
|
4672 IMAGE_INSTANCE_DISPLAY_WIDTH (ii),
|
|
4673 IMAGE_INSTANCE_DISPLAY_HEIGHT (ii));
|
428
|
4674 IMAGE_INSTANCE_SUBWINDOW_DISPLAYEDP (ii) = 0;
|
|
4675
|
442
|
4676 MAYBE_DEVMETH (XDEVICE (IMAGE_INSTANCE_DEVICE (ii)),
|
|
4677 unmap_subwindow, (ii));
|
428
|
4678 }
|
|
4679
|
|
4680 /* show a subwindow in its frame */
|
793
|
4681 void
|
|
4682 map_subwindow (Lisp_Object subwindow, int x, int y,
|
|
4683 struct display_glyph_area *dga)
|
428
|
4684 {
|
440
|
4685 Lisp_Image_Instance* ii = XIMAGE_INSTANCE (subwindow);
|
428
|
4686 struct frame* f;
|
|
4687
|
442
|
4688 ERROR_CHECK_IMAGE_INSTANCE (subwindow);
|
|
4689
|
|
4690 if (!image_instance_type_to_mask (IMAGE_INSTANCE_TYPE (ii))
|
|
4691 & (IMAGE_WIDGET_MASK | IMAGE_SUBWINDOW_MASK))
|
428
|
4692 return;
|
|
4693
|
|
4694 #ifdef DEBUG_WIDGETS
|
442
|
4695 stderr_out ("mapping subwindow %p, %dx%d@%d+%d\n",
|
428
|
4696 IMAGE_INSTANCE_SUBWINDOW_ID (ii),
|
|
4697 dga->width, dga->height, x, y);
|
|
4698 #endif
|
442
|
4699 f = XFRAME (IMAGE_INSTANCE_FRAME (ii));
|
|
4700 IMAGE_INSTANCE_DISPLAY_X (ii) = x;
|
|
4701 IMAGE_INSTANCE_DISPLAY_Y (ii) = y;
|
|
4702 IMAGE_INSTANCE_DISPLAY_WIDTH (ii) = dga->width;
|
|
4703 IMAGE_INSTANCE_DISPLAY_HEIGHT (ii) = dga->height;
|
|
4704
|
|
4705 MAYBE_DEVMETH (DOMAIN_XDEVICE (ii->domain),
|
|
4706 map_subwindow, (ii, x, y, dga));
|
428
|
4707 IMAGE_INSTANCE_SUBWINDOW_DISPLAYEDP (ii) = 1;
|
|
4708 }
|
|
4709
|
|
4710 static int
|
|
4711 subwindow_possible_dest_types (void)
|
|
4712 {
|
|
4713 return IMAGE_SUBWINDOW_MASK;
|
|
4714 }
|
|
4715
|
442
|
4716 int
|
|
4717 subwindow_governing_domain (void)
|
|
4718 {
|
|
4719 return GOVERNING_DOMAIN_WINDOW;
|
|
4720 }
|
|
4721
|
428
|
4722 /* Partially instantiate a subwindow. */
|
|
4723 void
|
|
4724 subwindow_instantiate (Lisp_Object image_instance, Lisp_Object instantiator,
|
|
4725 Lisp_Object pointer_fg, Lisp_Object pointer_bg,
|
|
4726 int dest_mask, Lisp_Object domain)
|
|
4727 {
|
440
|
4728 Lisp_Image_Instance *ii = XIMAGE_INSTANCE (image_instance);
|
442
|
4729 Lisp_Object device = image_instance_device (image_instance);
|
|
4730 Lisp_Object frame = DOMAIN_FRAME (domain);
|
428
|
4731 Lisp_Object width = find_keyword_in_vector (instantiator, Q_pixel_width);
|
|
4732 Lisp_Object height = find_keyword_in_vector (instantiator, Q_pixel_height);
|
|
4733
|
|
4734 if (NILP (frame))
|
563
|
4735 invalid_state ("No selected frame", device);
|
440
|
4736
|
428
|
4737 if (!(dest_mask & IMAGE_SUBWINDOW_MASK))
|
|
4738 incompatible_image_types (instantiator, dest_mask, IMAGE_SUBWINDOW_MASK);
|
|
4739
|
|
4740 ii->data = 0;
|
|
4741 IMAGE_INSTANCE_SUBWINDOW_ID (ii) = 0;
|
|
4742 IMAGE_INSTANCE_SUBWINDOW_DISPLAYEDP (ii) = 0;
|
442
|
4743
|
|
4744 if (INTP (width))
|
428
|
4745 {
|
|
4746 int w = 1;
|
|
4747 if (XINT (width) > 1)
|
|
4748 w = XINT (width);
|
442
|
4749 IMAGE_INSTANCE_WIDTH (ii) = w;
|
|
4750 IMAGE_INSTANCE_SUBWINDOW_H_RESIZEP (ii) = 0;
|
428
|
4751 }
|
442
|
4752
|
|
4753 if (INTP (height))
|
428
|
4754 {
|
|
4755 int h = 1;
|
|
4756 if (XINT (height) > 1)
|
|
4757 h = XINT (height);
|
442
|
4758 IMAGE_INSTANCE_HEIGHT (ii) = h;
|
|
4759 IMAGE_INSTANCE_SUBWINDOW_V_RESIZEP (ii) = 0;
|
428
|
4760 }
|
|
4761 }
|
|
4762
|
442
|
4763 /* This is just a backup in case no-one has assigned a suitable geometry.
|
|
4764 #### It should really query the enclose window for geometry. */
|
|
4765 static void
|
|
4766 subwindow_query_geometry (Lisp_Object image_instance, int* width,
|
|
4767 int* height, enum image_instance_geometry disp,
|
|
4768 Lisp_Object domain)
|
|
4769 {
|
|
4770 if (width) *width = 20;
|
|
4771 if (height) *height = 20;
|
|
4772 }
|
|
4773
|
428
|
4774 DEFUN ("subwindowp", Fsubwindowp, 1, 1, 0, /*
|
|
4775 Return non-nil if OBJECT is a subwindow.
|
|
4776 */
|
|
4777 (object))
|
|
4778 {
|
|
4779 CHECK_IMAGE_INSTANCE (object);
|
|
4780 return (XIMAGE_INSTANCE_TYPE (object) == IMAGE_SUBWINDOW) ? Qt : Qnil;
|
|
4781 }
|
|
4782
|
|
4783 DEFUN ("image-instance-subwindow-id", Fimage_instance_subwindow_id, 1, 1, 0, /*
|
|
4784 Return the window id of SUBWINDOW as a number.
|
|
4785 */
|
|
4786 (subwindow))
|
|
4787 {
|
|
4788 CHECK_SUBWINDOW_IMAGE_INSTANCE (subwindow);
|
442
|
4789 return make_int ((EMACS_INT) XIMAGE_INSTANCE_SUBWINDOW_ID (subwindow));
|
428
|
4790 }
|
|
4791
|
|
4792 DEFUN ("resize-subwindow", Fresize_subwindow, 1, 3, 0, /*
|
|
4793 Resize SUBWINDOW to WIDTH x HEIGHT.
|
|
4794 If a value is nil that parameter is not changed.
|
|
4795 */
|
|
4796 (subwindow, width, height))
|
|
4797 {
|
|
4798 int neww, newh;
|
442
|
4799 Lisp_Image_Instance* ii;
|
428
|
4800
|
|
4801 CHECK_SUBWINDOW_IMAGE_INSTANCE (subwindow);
|
442
|
4802 ii = XIMAGE_INSTANCE (subwindow);
|
428
|
4803
|
|
4804 if (NILP (width))
|
442
|
4805 neww = IMAGE_INSTANCE_WIDTH (ii);
|
428
|
4806 else
|
|
4807 neww = XINT (width);
|
|
4808
|
|
4809 if (NILP (height))
|
442
|
4810 newh = IMAGE_INSTANCE_HEIGHT (ii);
|
428
|
4811 else
|
|
4812 newh = XINT (height);
|
|
4813
|
442
|
4814 /* The actual resizing gets done asynchronously by
|
438
|
4815 update_subwindow. */
|
442
|
4816 IMAGE_INSTANCE_HEIGHT (ii) = newh;
|
|
4817 IMAGE_INSTANCE_WIDTH (ii) = neww;
|
|
4818 IMAGE_INSTANCE_SIZE_CHANGED (ii) = 1;
|
428
|
4819
|
|
4820 return subwindow;
|
|
4821 }
|
|
4822
|
|
4823 DEFUN ("force-subwindow-map", Fforce_subwindow_map, 1, 1, 0, /*
|
|
4824 Generate a Map event for SUBWINDOW.
|
|
4825 */
|
|
4826 (subwindow))
|
|
4827 {
|
|
4828 CHECK_SUBWINDOW_IMAGE_INSTANCE (subwindow);
|
|
4829 #if 0
|
|
4830 map_subwindow (subwindow, 0, 0);
|
|
4831 #endif
|
|
4832 return subwindow;
|
|
4833 }
|
|
4834
|
|
4835
|
|
4836 /*****************************************************************************
|
|
4837 * display tables *
|
|
4838 *****************************************************************************/
|
|
4839
|
|
4840 /* Get the display tables for use currently on window W with face
|
|
4841 FACE. #### This will have to be redone. */
|
|
4842
|
|
4843 void
|
|
4844 get_display_tables (struct window *w, face_index findex,
|
|
4845 Lisp_Object *face_table, Lisp_Object *window_table)
|
|
4846 {
|
|
4847 Lisp_Object tem;
|
|
4848 tem = WINDOW_FACE_CACHEL_DISPLAY_TABLE (w, findex);
|
|
4849 if (UNBOUNDP (tem))
|
|
4850 tem = Qnil;
|
|
4851 if (!LISTP (tem))
|
|
4852 tem = noseeum_cons (tem, Qnil);
|
|
4853 *face_table = tem;
|
|
4854 tem = w->display_table;
|
|
4855 if (UNBOUNDP (tem))
|
|
4856 tem = Qnil;
|
|
4857 if (!LISTP (tem))
|
|
4858 tem = noseeum_cons (tem, Qnil);
|
|
4859 *window_table = tem;
|
|
4860 }
|
|
4861
|
|
4862 Lisp_Object
|
|
4863 display_table_entry (Emchar ch, Lisp_Object face_table,
|
|
4864 Lisp_Object window_table)
|
|
4865 {
|
|
4866 Lisp_Object tail;
|
|
4867
|
|
4868 /* Loop over FACE_TABLE, and then over WINDOW_TABLE. */
|
|
4869 for (tail = face_table; 1; tail = XCDR (tail))
|
|
4870 {
|
|
4871 Lisp_Object table;
|
|
4872 if (NILP (tail))
|
|
4873 {
|
|
4874 if (!NILP (window_table))
|
|
4875 {
|
|
4876 tail = window_table;
|
|
4877 window_table = Qnil;
|
|
4878 }
|
|
4879 else
|
|
4880 return Qnil;
|
|
4881 }
|
|
4882 table = XCAR (tail);
|
|
4883
|
|
4884 if (VECTORP (table))
|
|
4885 {
|
|
4886 if (ch < XVECTOR_LENGTH (table) && !NILP (XVECTOR_DATA (table)[ch]))
|
|
4887 return XVECTOR_DATA (table)[ch];
|
|
4888 else
|
|
4889 continue;
|
|
4890 }
|
|
4891 else if (CHAR_TABLEP (table)
|
|
4892 && XCHAR_TABLE_TYPE (table) == CHAR_TABLE_TYPE_CHAR)
|
|
4893 {
|
|
4894 return get_char_table (ch, XCHAR_TABLE (table));
|
|
4895 }
|
|
4896 else if (CHAR_TABLEP (table)
|
|
4897 && XCHAR_TABLE_TYPE (table) == CHAR_TABLE_TYPE_GENERIC)
|
|
4898 {
|
|
4899 Lisp_Object gotit = get_char_table (ch, XCHAR_TABLE (table));
|
|
4900 if (!NILP (gotit))
|
|
4901 return gotit;
|
|
4902 else
|
|
4903 continue;
|
|
4904 }
|
|
4905 else if (RANGE_TABLEP (table))
|
|
4906 {
|
|
4907 Lisp_Object gotit = Fget_range_table (make_char (ch), table, Qnil);
|
|
4908 if (!NILP (gotit))
|
|
4909 return gotit;
|
|
4910 else
|
|
4911 continue;
|
|
4912 }
|
|
4913 else
|
|
4914 abort ();
|
|
4915 }
|
|
4916 }
|
|
4917
|
793
|
4918 /****************************************************************************
|
|
4919 * timeouts for animated glyphs *
|
|
4920 ****************************************************************************/
|
428
|
4921 static Lisp_Object Qglyph_animated_timeout_handler;
|
|
4922
|
|
4923 DEFUN ("glyph-animated-timeout-handler", Fglyph_animated_timeout_handler, 1, 1, 0, /*
|
|
4924 Callback function for updating animated images.
|
|
4925 Don't use this.
|
|
4926 */
|
|
4927 (arg))
|
|
4928 {
|
|
4929 CHECK_WEAK_LIST (arg);
|
|
4930
|
|
4931 if (!NILP (XWEAK_LIST_LIST (arg)) && !NILP (XCAR (XWEAK_LIST_LIST (arg))))
|
|
4932 {
|
|
4933 Lisp_Object value = XCAR (XWEAK_LIST_LIST (arg));
|
440
|
4934
|
428
|
4935 if (IMAGE_INSTANCEP (value))
|
|
4936 {
|
440
|
4937 Lisp_Image_Instance* ii = XIMAGE_INSTANCE (value);
|
428
|
4938
|
|
4939 if (COLOR_PIXMAP_IMAGE_INSTANCEP (value)
|
|
4940 &&
|
|
4941 IMAGE_INSTANCE_PIXMAP_MAXSLICE (ii) > 1
|
|
4942 &&
|
|
4943 !disable_animated_pixmaps)
|
|
4944 {
|
|
4945 /* Increment the index of the image slice we are currently
|
|
4946 viewing. */
|
|
4947 IMAGE_INSTANCE_PIXMAP_SLICE (ii) =
|
|
4948 (IMAGE_INSTANCE_PIXMAP_SLICE (ii) + 1)
|
|
4949 % IMAGE_INSTANCE_PIXMAP_MAXSLICE (ii);
|
|
4950 /* We might need to kick redisplay at this point - but we
|
|
4951 also might not. */
|
440
|
4952 MARK_DEVICE_FRAMES_GLYPHS_CHANGED
|
442
|
4953 (XDEVICE (image_instance_device (value)));
|
|
4954 /* Cascade dirtiness so that we can have an animated glyph in a layout
|
|
4955 for instance. */
|
|
4956 set_image_instance_dirty_p (value, 1);
|
428
|
4957 }
|
|
4958 }
|
|
4959 }
|
|
4960 return Qnil;
|
|
4961 }
|
|
4962
|
793
|
4963 Lisp_Object
|
|
4964 add_glyph_animated_timeout (EMACS_INT tickms, Lisp_Object image)
|
428
|
4965 {
|
|
4966 Lisp_Object ret = Qnil;
|
|
4967
|
|
4968 if (tickms > 0 && IMAGE_INSTANCEP (image))
|
|
4969 {
|
|
4970 double ms = ((double)tickms) / 1000.0;
|
|
4971 struct gcpro gcpro1;
|
|
4972 Lisp_Object holder = make_weak_list (WEAK_LIST_SIMPLE);
|
|
4973
|
|
4974 GCPRO1 (holder);
|
|
4975 XWEAK_LIST_LIST (holder) = Fcons (image, Qnil);
|
|
4976
|
|
4977 ret = Fadd_timeout (make_float (ms),
|
|
4978 Qglyph_animated_timeout_handler,
|
|
4979 holder, make_float (ms));
|
|
4980
|
|
4981 UNGCPRO;
|
|
4982 }
|
|
4983 return ret;
|
|
4984 }
|
|
4985
|
793
|
4986 void
|
|
4987 disable_glyph_animated_timeout (int i)
|
|
4988 {
|
|
4989 Fdisable_timeout (make_int (i));
|
428
|
4990 }
|
|
4991
|
|
4992
|
|
4993 /*****************************************************************************
|
|
4994 * initialization *
|
|
4995 *****************************************************************************/
|
|
4996
|
|
4997 void
|
|
4998 syms_of_glyphs (void)
|
|
4999 {
|
442
|
5000 INIT_LRECORD_IMPLEMENTATION (glyph);
|
|
5001 INIT_LRECORD_IMPLEMENTATION (image_instance);
|
|
5002
|
428
|
5003 /* image instantiators */
|
|
5004
|
|
5005 DEFSUBR (Fimage_instantiator_format_list);
|
|
5006 DEFSUBR (Fvalid_image_instantiator_format_p);
|
|
5007 DEFSUBR (Fset_console_type_image_conversion_list);
|
|
5008 DEFSUBR (Fconsole_type_image_conversion_list);
|
|
5009
|
442
|
5010 DEFKEYWORD (Q_file);
|
|
5011 DEFKEYWORD (Q_data);
|
|
5012 DEFKEYWORD (Q_face);
|
|
5013 DEFKEYWORD (Q_pixel_height);
|
|
5014 DEFKEYWORD (Q_pixel_width);
|
428
|
5015
|
|
5016 #ifdef HAVE_XPM
|
442
|
5017 DEFKEYWORD (Q_color_symbols);
|
428
|
5018 #endif
|
|
5019 #ifdef HAVE_WINDOW_SYSTEM
|
442
|
5020 DEFKEYWORD (Q_mask_file);
|
|
5021 DEFKEYWORD (Q_mask_data);
|
|
5022 DEFKEYWORD (Q_hotspot_x);
|
|
5023 DEFKEYWORD (Q_hotspot_y);
|
|
5024 DEFKEYWORD (Q_foreground);
|
|
5025 DEFKEYWORD (Q_background);
|
428
|
5026 #endif
|
|
5027 /* image specifiers */
|
|
5028
|
|
5029 DEFSUBR (Fimage_specifier_p);
|
|
5030 /* Qimage in general.c */
|
|
5031
|
|
5032 /* image instances */
|
|
5033
|
563
|
5034 DEFSYMBOL_MULTIWORD_PREDICATE (Qimage_instancep);
|
428
|
5035
|
442
|
5036 DEFSYMBOL (Qnothing_image_instance_p);
|
|
5037 DEFSYMBOL (Qtext_image_instance_p);
|
|
5038 DEFSYMBOL (Qmono_pixmap_image_instance_p);
|
|
5039 DEFSYMBOL (Qcolor_pixmap_image_instance_p);
|
|
5040 DEFSYMBOL (Qpointer_image_instance_p);
|
|
5041 DEFSYMBOL (Qwidget_image_instance_p);
|
|
5042 DEFSYMBOL (Qsubwindow_image_instance_p);
|
428
|
5043
|
|
5044 DEFSUBR (Fmake_image_instance);
|
|
5045 DEFSUBR (Fimage_instance_p);
|
|
5046 DEFSUBR (Fimage_instance_type);
|
|
5047 DEFSUBR (Fvalid_image_instance_type_p);
|
|
5048 DEFSUBR (Fimage_instance_type_list);
|
|
5049 DEFSUBR (Fimage_instance_name);
|
442
|
5050 DEFSUBR (Fimage_instance_domain);
|
428
|
5051 DEFSUBR (Fimage_instance_string);
|
|
5052 DEFSUBR (Fimage_instance_file_name);
|
|
5053 DEFSUBR (Fimage_instance_mask_file_name);
|
|
5054 DEFSUBR (Fimage_instance_depth);
|
|
5055 DEFSUBR (Fimage_instance_height);
|
|
5056 DEFSUBR (Fimage_instance_width);
|
|
5057 DEFSUBR (Fimage_instance_hotspot_x);
|
|
5058 DEFSUBR (Fimage_instance_hotspot_y);
|
|
5059 DEFSUBR (Fimage_instance_foreground);
|
|
5060 DEFSUBR (Fimage_instance_background);
|
|
5061 DEFSUBR (Fimage_instance_property);
|
|
5062 DEFSUBR (Fcolorize_image_instance);
|
|
5063 /* subwindows */
|
|
5064 DEFSUBR (Fsubwindowp);
|
|
5065 DEFSUBR (Fimage_instance_subwindow_id);
|
|
5066 DEFSUBR (Fresize_subwindow);
|
|
5067 DEFSUBR (Fforce_subwindow_map);
|
|
5068
|
|
5069 /* Qnothing defined as part of the "nothing" image-instantiator
|
|
5070 type. */
|
|
5071 /* Qtext defined in general.c */
|
442
|
5072 DEFSYMBOL (Qmono_pixmap);
|
|
5073 DEFSYMBOL (Qcolor_pixmap);
|
428
|
5074 /* Qpointer defined in general.c */
|
|
5075
|
|
5076 /* glyphs */
|
|
5077
|
442
|
5078 DEFSYMBOL (Qglyphp);
|
|
5079 DEFSYMBOL (Qcontrib_p);
|
|
5080 DEFSYMBOL (Qbaseline);
|
|
5081
|
|
5082 DEFSYMBOL (Qbuffer_glyph_p);
|
|
5083 DEFSYMBOL (Qpointer_glyph_p);
|
|
5084 DEFSYMBOL (Qicon_glyph_p);
|
|
5085
|
|
5086 DEFSYMBOL (Qconst_glyph_variable);
|
428
|
5087
|
|
5088 DEFSUBR (Fglyph_type);
|
|
5089 DEFSUBR (Fvalid_glyph_type_p);
|
|
5090 DEFSUBR (Fglyph_type_list);
|
|
5091 DEFSUBR (Fglyphp);
|
|
5092 DEFSUBR (Fmake_glyph_internal);
|
|
5093 DEFSUBR (Fglyph_width);
|
|
5094 DEFSUBR (Fglyph_ascent);
|
|
5095 DEFSUBR (Fglyph_descent);
|
|
5096 DEFSUBR (Fglyph_height);
|
442
|
5097 DEFSUBR (Fset_instantiator_property);
|
428
|
5098
|
|
5099 /* Qbuffer defined in general.c. */
|
|
5100 /* Qpointer defined above */
|
|
5101
|
|
5102 /* Unfortunately, timeout handlers must be lisp functions. This is
|
|
5103 for animated glyphs. */
|
442
|
5104 DEFSYMBOL (Qglyph_animated_timeout_handler);
|
428
|
5105 DEFSUBR (Fglyph_animated_timeout_handler);
|
|
5106
|
|
5107 /* Errors */
|
563
|
5108 DEFERROR_STANDARD (Qimage_conversion_error, Qconversion_error);
|
428
|
5109 }
|
|
5110
|
|
5111 static const struct lrecord_description image_specifier_description[] = {
|
440
|
5112 { XD_LISP_OBJECT, specifier_data_offset + offsetof (struct image_specifier, attachee) },
|
|
5113 { XD_LISP_OBJECT, specifier_data_offset + offsetof (struct image_specifier, attachee_property) },
|
428
|
5114 { XD_END }
|
|
5115 };
|
|
5116
|
|
5117 void
|
|
5118 specifier_type_create_image (void)
|
|
5119 {
|
|
5120 /* image specifiers */
|
|
5121
|
|
5122 INITIALIZE_SPECIFIER_TYPE_WITH_DATA (image, "image", "imagep");
|
|
5123
|
|
5124 SPECIFIER_HAS_METHOD (image, create);
|
|
5125 SPECIFIER_HAS_METHOD (image, mark);
|
|
5126 SPECIFIER_HAS_METHOD (image, instantiate);
|
|
5127 SPECIFIER_HAS_METHOD (image, validate);
|
|
5128 SPECIFIER_HAS_METHOD (image, after_change);
|
|
5129 SPECIFIER_HAS_METHOD (image, going_to_add);
|
434
|
5130 SPECIFIER_HAS_METHOD (image, copy_instantiator);
|
428
|
5131 }
|
|
5132
|
|
5133 void
|
|
5134 reinit_specifier_type_create_image (void)
|
|
5135 {
|
|
5136 REINITIALIZE_SPECIFIER_TYPE (image);
|
|
5137 }
|
|
5138
|
|
5139
|
|
5140 static const struct lrecord_description iike_description_1[] = {
|
440
|
5141 { XD_LISP_OBJECT, offsetof (ii_keyword_entry, keyword) },
|
428
|
5142 { XD_END }
|
|
5143 };
|
|
5144
|
|
5145 static const struct struct_description iike_description = {
|
440
|
5146 sizeof (ii_keyword_entry),
|
428
|
5147 iike_description_1
|
|
5148 };
|
|
5149
|
|
5150 static const struct lrecord_description iiked_description_1[] = {
|
440
|
5151 XD_DYNARR_DESC (ii_keyword_entry_dynarr, &iike_description),
|
428
|
5152 { XD_END }
|
|
5153 };
|
|
5154
|
|
5155 static const struct struct_description iiked_description = {
|
440
|
5156 sizeof (ii_keyword_entry_dynarr),
|
428
|
5157 iiked_description_1
|
|
5158 };
|
|
5159
|
|
5160 static const struct lrecord_description iife_description_1[] = {
|
440
|
5161 { XD_LISP_OBJECT, offsetof (image_instantiator_format_entry, symbol) },
|
|
5162 { XD_LISP_OBJECT, offsetof (image_instantiator_format_entry, device) },
|
|
5163 { XD_STRUCT_PTR, offsetof (image_instantiator_format_entry, meths), 1, &iim_description },
|
428
|
5164 { XD_END }
|
|
5165 };
|
|
5166
|
|
5167 static const struct struct_description iife_description = {
|
440
|
5168 sizeof (image_instantiator_format_entry),
|
428
|
5169 iife_description_1
|
|
5170 };
|
|
5171
|
|
5172 static const struct lrecord_description iifed_description_1[] = {
|
440
|
5173 XD_DYNARR_DESC (image_instantiator_format_entry_dynarr, &iife_description),
|
428
|
5174 { XD_END }
|
|
5175 };
|
|
5176
|
|
5177 static const struct struct_description iifed_description = {
|
440
|
5178 sizeof (image_instantiator_format_entry_dynarr),
|
428
|
5179 iifed_description_1
|
|
5180 };
|
|
5181
|
|
5182 static const struct lrecord_description iim_description_1[] = {
|
440
|
5183 { XD_LISP_OBJECT, offsetof (struct image_instantiator_methods, symbol) },
|
|
5184 { XD_LISP_OBJECT, offsetof (struct image_instantiator_methods, device) },
|
|
5185 { XD_STRUCT_PTR, offsetof (struct image_instantiator_methods, keywords), 1, &iiked_description },
|
|
5186 { XD_STRUCT_PTR, offsetof (struct image_instantiator_methods, consoles), 1, &cted_description },
|
428
|
5187 { XD_END }
|
|
5188 };
|
|
5189
|
|
5190 const struct struct_description iim_description = {
|
442
|
5191 sizeof (struct image_instantiator_methods),
|
428
|
5192 iim_description_1
|
|
5193 };
|
|
5194
|
|
5195 void
|
|
5196 image_instantiator_format_create (void)
|
|
5197 {
|
|
5198 /* image instantiators */
|
|
5199
|
|
5200 the_image_instantiator_format_entry_dynarr =
|
|
5201 Dynarr_new (image_instantiator_format_entry);
|
|
5202
|
|
5203 Vimage_instantiator_format_list = Qnil;
|
|
5204 staticpro (&Vimage_instantiator_format_list);
|
|
5205
|
452
|
5206 dump_add_root_struct_ptr (&the_image_instantiator_format_entry_dynarr, &iifed_description);
|
428
|
5207
|
|
5208 INITIALIZE_IMAGE_INSTANTIATOR_FORMAT (nothing, "nothing");
|
|
5209
|
|
5210 IIFORMAT_HAS_METHOD (nothing, possible_dest_types);
|
|
5211 IIFORMAT_HAS_METHOD (nothing, instantiate);
|
|
5212
|
|
5213 INITIALIZE_IMAGE_INSTANTIATOR_FORMAT (inherit, "inherit");
|
|
5214
|
|
5215 IIFORMAT_HAS_METHOD (inherit, validate);
|
|
5216 IIFORMAT_HAS_METHOD (inherit, normalize);
|
|
5217 IIFORMAT_HAS_METHOD (inherit, possible_dest_types);
|
|
5218 IIFORMAT_HAS_METHOD (inherit, instantiate);
|
|
5219
|
|
5220 IIFORMAT_VALID_KEYWORD (inherit, Q_face, check_valid_face);
|
|
5221
|
|
5222 INITIALIZE_IMAGE_INSTANTIATOR_FORMAT (string, "string");
|
|
5223
|
|
5224 IIFORMAT_HAS_METHOD (string, validate);
|
442
|
5225 IIFORMAT_HAS_SHARED_METHOD (string, governing_domain, subwindow);
|
428
|
5226 IIFORMAT_HAS_METHOD (string, possible_dest_types);
|
|
5227 IIFORMAT_HAS_METHOD (string, instantiate);
|
|
5228
|
|
5229 IIFORMAT_VALID_KEYWORD (string, Q_data, check_valid_string);
|
|
5230 /* Do this so we can set strings. */
|
442
|
5231 /* #### Andy, what is this? This is a bogus format and should not be
|
|
5232 visible to the user. */
|
428
|
5233 INITIALIZE_IMAGE_INSTANTIATOR_FORMAT (text, "text");
|
442
|
5234 IIFORMAT_HAS_METHOD (text, update);
|
438
|
5235 IIFORMAT_HAS_METHOD (text, query_geometry);
|
428
|
5236
|
|
5237 INITIALIZE_IMAGE_INSTANTIATOR_FORMAT (formatted_string, "formatted-string");
|
|
5238
|
|
5239 IIFORMAT_HAS_METHOD (formatted_string, validate);
|
|
5240 IIFORMAT_HAS_METHOD (formatted_string, possible_dest_types);
|
|
5241 IIFORMAT_HAS_METHOD (formatted_string, instantiate);
|
|
5242 IIFORMAT_VALID_KEYWORD (formatted_string, Q_data, check_valid_string);
|
|
5243
|
442
|
5244 /* Do this so pointers have geometry. */
|
|
5245 /* #### Andy, what is this? This is a bogus format and should not be
|
|
5246 visible to the user. */
|
|
5247 INITIALIZE_IMAGE_INSTANTIATOR_FORMAT (pointer, "pointer");
|
|
5248 IIFORMAT_HAS_SHARED_METHOD (pointer, query_geometry, subwindow);
|
|
5249
|
428
|
5250 /* subwindows */
|
|
5251 INITIALIZE_IMAGE_INSTANTIATOR_FORMAT (subwindow, "subwindow");
|
|
5252 IIFORMAT_HAS_METHOD (subwindow, possible_dest_types);
|
442
|
5253 IIFORMAT_HAS_METHOD (subwindow, governing_domain);
|
428
|
5254 IIFORMAT_HAS_METHOD (subwindow, instantiate);
|
442
|
5255 IIFORMAT_HAS_METHOD (subwindow, query_geometry);
|
428
|
5256 IIFORMAT_VALID_KEYWORD (subwindow, Q_pixel_width, check_valid_int);
|
|
5257 IIFORMAT_VALID_KEYWORD (subwindow, Q_pixel_height, check_valid_int);
|
|
5258
|
|
5259 #ifdef HAVE_WINDOW_SYSTEM
|
|
5260 INITIALIZE_IMAGE_INSTANTIATOR_FORMAT (xbm, "xbm");
|
|
5261
|
|
5262 IIFORMAT_HAS_METHOD (xbm, validate);
|
|
5263 IIFORMAT_HAS_METHOD (xbm, normalize);
|
|
5264 IIFORMAT_HAS_METHOD (xbm, possible_dest_types);
|
|
5265
|
|
5266 IIFORMAT_VALID_KEYWORD (xbm, Q_data, check_valid_xbm_inline);
|
|
5267 IIFORMAT_VALID_KEYWORD (xbm, Q_file, check_valid_string);
|
|
5268 IIFORMAT_VALID_KEYWORD (xbm, Q_mask_data, check_valid_xbm_inline);
|
|
5269 IIFORMAT_VALID_KEYWORD (xbm, Q_mask_file, check_valid_string);
|
|
5270 IIFORMAT_VALID_KEYWORD (xbm, Q_hotspot_x, check_valid_int);
|
|
5271 IIFORMAT_VALID_KEYWORD (xbm, Q_hotspot_y, check_valid_int);
|
|
5272 IIFORMAT_VALID_KEYWORD (xbm, Q_foreground, check_valid_string);
|
|
5273 IIFORMAT_VALID_KEYWORD (xbm, Q_background, check_valid_string);
|
|
5274 #endif /* HAVE_WINDOW_SYSTEM */
|
|
5275
|
|
5276 #ifdef HAVE_XFACE
|
|
5277 INITIALIZE_IMAGE_INSTANTIATOR_FORMAT (xface, "xface");
|
|
5278
|
|
5279 IIFORMAT_HAS_METHOD (xface, validate);
|
|
5280 IIFORMAT_HAS_METHOD (xface, normalize);
|
|
5281 IIFORMAT_HAS_METHOD (xface, possible_dest_types);
|
|
5282
|
|
5283 IIFORMAT_VALID_KEYWORD (xface, Q_data, check_valid_string);
|
|
5284 IIFORMAT_VALID_KEYWORD (xface, Q_file, check_valid_string);
|
|
5285 IIFORMAT_VALID_KEYWORD (xface, Q_hotspot_x, check_valid_int);
|
|
5286 IIFORMAT_VALID_KEYWORD (xface, Q_hotspot_y, check_valid_int);
|
|
5287 IIFORMAT_VALID_KEYWORD (xface, Q_foreground, check_valid_string);
|
|
5288 IIFORMAT_VALID_KEYWORD (xface, Q_background, check_valid_string);
|
|
5289 #endif
|
|
5290
|
|
5291 #ifdef HAVE_XPM
|
|
5292 INITIALIZE_IMAGE_INSTANTIATOR_FORMAT (xpm, "xpm");
|
|
5293
|
|
5294 IIFORMAT_HAS_METHOD (xpm, validate);
|
|
5295 IIFORMAT_HAS_METHOD (xpm, normalize);
|
|
5296 IIFORMAT_HAS_METHOD (xpm, possible_dest_types);
|
|
5297
|
|
5298 IIFORMAT_VALID_KEYWORD (xpm, Q_data, check_valid_string);
|
|
5299 IIFORMAT_VALID_KEYWORD (xpm, Q_file, check_valid_string);
|
|
5300 IIFORMAT_VALID_KEYWORD (xpm, Q_color_symbols, check_valid_xpm_color_symbols);
|
|
5301 #endif /* HAVE_XPM */
|
|
5302 }
|
|
5303
|
|
5304 void
|
|
5305 reinit_vars_of_glyphs (void)
|
|
5306 {
|
|
5307 the_expose_ignore_blocktype =
|
|
5308 Blocktype_new (struct expose_ignore_blocktype);
|
|
5309
|
|
5310 hold_ignored_expose_registration = 0;
|
|
5311 }
|
|
5312
|
|
5313
|
|
5314 void
|
|
5315 vars_of_glyphs (void)
|
|
5316 {
|
|
5317 reinit_vars_of_glyphs ();
|
|
5318
|
|
5319 Vthe_nothing_vector = vector1 (Qnothing);
|
|
5320 staticpro (&Vthe_nothing_vector);
|
|
5321
|
|
5322 /* image instances */
|
|
5323
|
440
|
5324 Vimage_instance_type_list = Fcons (Qnothing,
|
|
5325 list6 (Qtext, Qmono_pixmap, Qcolor_pixmap,
|
428
|
5326 Qpointer, Qsubwindow, Qwidget));
|
|
5327 staticpro (&Vimage_instance_type_list);
|
|
5328
|
|
5329 /* glyphs */
|
|
5330
|
|
5331 Vglyph_type_list = list3 (Qbuffer, Qpointer, Qicon);
|
|
5332 staticpro (&Vglyph_type_list);
|
|
5333
|
|
5334 /* The octal-escape glyph, control-arrow-glyph and
|
|
5335 invisible-text-glyph are completely initialized in glyphs.el */
|
|
5336
|
|
5337 DEFVAR_LISP ("octal-escape-glyph", &Voctal_escape_glyph /*
|
|
5338 What to prefix character codes displayed in octal with.
|
|
5339 */);
|
|
5340 Voctal_escape_glyph = allocate_glyph (GLYPH_BUFFER, redisplay_glyph_changed);
|
|
5341
|
|
5342 DEFVAR_LISP ("control-arrow-glyph", &Vcontrol_arrow_glyph /*
|
|
5343 What to use as an arrow for control characters.
|
|
5344 */);
|
|
5345 Vcontrol_arrow_glyph = allocate_glyph (GLYPH_BUFFER,
|
|
5346 redisplay_glyph_changed);
|
|
5347
|
|
5348 DEFVAR_LISP ("invisible-text-glyph", &Vinvisible_text_glyph /*
|
|
5349 What to use to indicate the presence of invisible text.
|
|
5350 This is the glyph that is displayed when an ellipsis is called for
|
|
5351 \(see `selective-display-ellipses' and `buffer-invisibility-spec').
|
|
5352 Normally this is three dots ("...").
|
|
5353 */);
|
|
5354 Vinvisible_text_glyph = allocate_glyph (GLYPH_BUFFER,
|
|
5355 redisplay_glyph_changed);
|
|
5356
|
|
5357 /* Partially initialized in glyphs.el */
|
|
5358 DEFVAR_LISP ("hscroll-glyph", &Vhscroll_glyph /*
|
|
5359 What to display at the beginning of horizontally scrolled lines.
|
|
5360 */);
|
|
5361 Vhscroll_glyph = allocate_glyph (GLYPH_BUFFER, redisplay_glyph_changed);
|
|
5362 #ifdef HAVE_WINDOW_SYSTEM
|
|
5363 Fprovide (Qxbm);
|
|
5364 #endif
|
|
5365 #ifdef HAVE_XPM
|
|
5366 Fprovide (Qxpm);
|
|
5367
|
|
5368 DEFVAR_LISP ("xpm-color-symbols", &Vxpm_color_symbols /*
|
|
5369 Definitions of logical color-names used when reading XPM files.
|
|
5370 Elements of this list should be of the form (COLOR-NAME FORM-TO-EVALUATE).
|
|
5371 The COLOR-NAME should be a string, which is the name of the color to define;
|
|
5372 the FORM should evaluate to a `color' specifier object, or a string to be
|
|
5373 passed to `make-color-instance'. If a loaded XPM file references a symbolic
|
|
5374 color called COLOR-NAME, it will display as the computed color instead.
|
|
5375
|
|
5376 The default value of this variable defines the logical color names
|
|
5377 \"foreground\" and \"background\" to be the colors of the `default' face.
|
|
5378 */ );
|
|
5379 Vxpm_color_symbols = Qnil; /* initialized in x-faces.el */
|
|
5380 #endif /* HAVE_XPM */
|
|
5381 #ifdef HAVE_XFACE
|
|
5382 Fprovide (Qxface);
|
|
5383 #endif
|
|
5384
|
|
5385 DEFVAR_BOOL ("disable-animated-pixmaps", &disable_animated_pixmaps /*
|
|
5386 Whether animated pixmaps should be animated.
|
|
5387 Default is t.
|
|
5388 */);
|
|
5389 disable_animated_pixmaps = 0;
|
|
5390 }
|
|
5391
|
|
5392 void
|
|
5393 specifier_vars_of_glyphs (void)
|
|
5394 {
|
|
5395 /* #### Can we GC here? The set_specifier_* calls definitely need */
|
|
5396 /* protection. */
|
|
5397 /* display tables */
|
|
5398
|
|
5399 DEFVAR_SPECIFIER ("current-display-table", &Vcurrent_display_table /*
|
|
5400 *The display table currently in use.
|
|
5401 This is a specifier; use `set-specifier' to change it.
|
442
|
5402
|
|
5403 Display tables are used to control how characters are displayed. Each
|
|
5404 time that redisplay processes a character, it is looked up in all the
|
|
5405 display tables that apply (obtained by calling `specifier-instance' on
|
|
5406 `current-display-table' and any overriding display tables specified in
|
|
5407 currently active faces). The first entry found that matches the
|
|
5408 character determines how the character is displayed. If there is no
|
|
5409 matching entry, the default display method is used. (Non-control
|
|
5410 characters are displayed as themselves and control characters are
|
|
5411 displayed according to the buffer-local variable `ctl-arrow'. Control
|
|
5412 characters are further affected by `control-arrow-glyph' and
|
|
5413 `octal-escape-glyph'.)
|
|
5414
|
|
5415 Each instantiator in this specifier and the display-table specifiers
|
|
5416 in faces is a display table or a list of such tables. If a list, each
|
|
5417 table will be searched in turn for an entry matching a particular
|
|
5418 character. Each display table is one of
|
|
5419
|
|
5420 -- a vector, specifying values for characters starting at 0
|
|
5421 -- a char table, either of type `char' or `generic'
|
|
5422 -- a range table
|
|
5423
|
|
5424 Each entry in a display table should be one of
|
|
5425
|
|
5426 -- nil (this entry is ignored and the search continues)
|
|
5427 -- a character (use this character; if it happens to be the same as
|
|
5428 the original character, default processing happens, otherwise
|
|
5429 redisplay attempts to display this character directly;
|
|
5430 #### At some point recursive display-table lookup will be
|
|
5431 implemented.)
|
|
5432 -- a string (display each character in the string directly;
|
|
5433 #### At some point recursive display-table lookup will be
|
|
5434 implemented.)
|
|
5435 -- a glyph (display the glyph;
|
|
5436 #### At some point recursive display-table lookup will be
|
|
5437 implemented when a string glyph is being processed.)
|
|
5438 -- a cons of the form (format "STRING") where STRING is a printf-like
|
|
5439 spec used to process the character. #### Unfortunately no
|
|
5440 formatting directives other than %% are implemented.
|
|
5441 -- a vector (each element of the vector is processed recursively;
|
|
5442 in such a case, nil elements in the vector are simply ignored)
|
|
5443
|
|
5444 #### At some point in the near future, display tables are likely to
|
|
5445 be expanded to include other features, such as referencing characters
|
|
5446 in particular fonts and allowing the character search to continue
|
|
5447 all the way up the chain of specifier instantiators. These features
|
|
5448 are necessary to properly display Unicode characters.
|
428
|
5449 */ );
|
|
5450 Vcurrent_display_table = Fmake_specifier (Qdisplay_table);
|
|
5451 set_specifier_fallback (Vcurrent_display_table,
|
|
5452 list1 (Fcons (Qnil, Qnil)));
|
|
5453 set_specifier_caching (Vcurrent_display_table,
|
438
|
5454 offsetof (struct window, display_table),
|
428
|
5455 some_window_value_changed,
|
444
|
5456 0, 0, 0);
|
428
|
5457 }
|
|
5458
|
|
5459 void
|
|
5460 complex_vars_of_glyphs (void)
|
|
5461 {
|
|
5462 /* Partially initialized in glyphs-x.c, glyphs.el */
|
|
5463 DEFVAR_LISP ("truncation-glyph", &Vtruncation_glyph /*
|
|
5464 What to display at the end of truncated lines.
|
|
5465 */ );
|
|
5466 Vtruncation_glyph = allocate_glyph (GLYPH_BUFFER, redisplay_glyph_changed);
|
|
5467
|
|
5468 /* Partially initialized in glyphs-x.c, glyphs.el */
|
|
5469 DEFVAR_LISP ("continuation-glyph", &Vcontinuation_glyph /*
|
|
5470 What to display at the end of wrapped lines.
|
|
5471 */ );
|
|
5472 Vcontinuation_glyph = allocate_glyph (GLYPH_BUFFER, redisplay_glyph_changed);
|
|
5473
|
|
5474 /* Partially initialized in glyphs-x.c, glyphs.el */
|
|
5475 DEFVAR_LISP ("xemacs-logo", &Vxemacs_logo /*
|
|
5476 The glyph used to display the XEmacs logo at startup.
|
|
5477 */ );
|
|
5478 Vxemacs_logo = allocate_glyph (GLYPH_BUFFER, 0);
|
|
5479 }
|