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