1 /* xfaces.c -- "Face" primitives.
2 Copyright (C) 1993, 1994, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
3 2005, 2006 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
20 Boston, MA 02110-1301, USA. */
22 /* New face implementation by Gerd Moellmann <gerd@gnu.org>. */
26 When using Emacs with X, the display style of characters can be
27 changed by defining `faces'. Each face can specify the following
32 2. Relative proportionate width, aka character set width or set
33 width (swidth), e.g. `semi-compressed'.
35 3. Font height in 1/10pt.
37 4. Font weight, e.g. `bold'.
39 5. Font slant, e.g. `italic'.
45 8. Whether or not characters should be underlined, and in what color.
47 9. Whether or not characters should be displayed in inverse video.
49 10. A background stipple, a bitmap.
51 11. Whether or not characters should be overlined, and in what color.
53 12. Whether or not characters should be strike-through, and in what
56 13. Whether or not a box should be drawn around characters, the box
57 type, and, for simple boxes, in what color.
59 14. Font or fontset pattern, or nil. This is a special attribute.
60 When this attribute is specified, the face uses a font opened by
61 that pattern as is. In addition, all the other font-related
62 attributes (1st thru 5th) are generated from the opened font name.
63 On the other hand, if one of the other font-related attributes are
64 specified, this attribute is set to nil. In that case, the face
65 doesn't inherit this attribute from the `default' face, and uses a
66 font determined by the other attributes (those may be inherited
67 from the `default' face).
69 15. A face name or list of face names from which to inherit attributes.
71 16. A specified average font width, which is invisible from Lisp,
72 and is used to ensure that a font specified on the command line,
73 for example, can be matched exactly.
75 Faces are frame-local by nature because Emacs allows to define the
76 same named face (face names are symbols) differently for different
77 frames. Each frame has an alist of face definitions for all named
78 faces. The value of a named face in such an alist is a Lisp vector
79 with the symbol `face' in slot 0, and a slot for each of the face
80 attributes mentioned above.
82 There is also a global face alist `Vface_new_frame_defaults'. Face
83 definitions from this list are used to initialize faces of newly
86 A face doesn't have to specify all attributes. Those not specified
87 have a value of `unspecified'. Faces specifying all attributes but
88 the 14th are called `fully-specified'.
93 The display style of a given character in the text is determined by
94 combining several faces. This process is called `face merging'.
95 Any aspect of the display style that isn't specified by overlays or
96 text properties is taken from the `default' face. Since it is made
97 sure that the default face is always fully-specified, face merging
98 always results in a fully-specified face.
103 After all face attributes for a character have been determined by
104 merging faces of that character, that face is `realized'. The
105 realization process maps face attributes to what is physically
106 available on the system where Emacs runs. The result is a
107 `realized face' in form of a struct face which is stored in the
108 face cache of the frame on which it was realized.
110 Face realization is done in the context of the character to display
111 because different fonts may be used for different characters. In
112 other words, for characters that have different font
113 specifications, different realized faces are needed to display
116 Font specification is done by fontsets. See the comment in
117 fontset.c for the details. In the current implementation, all ASCII
118 characters share the same font in a fontset.
120 Faces are at first realized for ASCII characters, and, at that
121 time, assigned a specific realized fontset. Hereafter, we call
122 such a face as `ASCII face'. When a face for a multibyte character
123 is realized, it inherits (thus shares) a fontset of an ASCII face
124 that has the same attributes other than font-related ones.
126 Thus, all realized face have a realized fontset.
131 Unibyte text (i.e. raw 8-bit characters) is displayed with the same
132 font as ASCII characters. That is because it is expected that
133 unibyte text users specify a font that is suitable both for ASCII
134 and raw 8-bit characters.
139 Font selection tries to find the best available matching font for a
140 given (character, face) combination.
142 If the face specifies a fontset name, that fontset determines a
143 pattern for fonts of the given character. If the face specifies a
144 font name or the other font-related attributes, a fontset is
145 realized from the default fontset. In that case, that
146 specification determines a pattern for ASCII characters and the
147 default fontset determines a pattern for multibyte characters.
149 Available fonts on the system on which Emacs runs are then matched
150 against the font pattern. The result of font selection is the best
151 match for the given face attributes in this font list.
153 Font selection can be influenced by the user.
155 1. The user can specify the relative importance he gives the face
156 attributes width, height, weight, and slant by setting
157 face-font-selection-order (faces.el) to a list of face attribute
158 names. The default is '(:width :height :weight :slant), and means
159 that font selection first tries to find a good match for the font
160 width specified by a face, then---within fonts with that
161 width---tries to find a best match for the specified font height,
164 2. Setting face-font-family-alternatives allows the user to
165 specify alternative font families to try if a family specified by a
168 3. Setting face-font-registry-alternatives allows the user to
169 specify all alternative font registries to try for a face
170 specifying a registry.
172 4. Setting face-ignored-fonts allows the user to ignore specific
176 Character composition.
178 Usually, the realization process is already finished when Emacs
179 actually reflects the desired glyph matrix on the screen. However,
180 on displaying a composition (sequence of characters to be composed
181 on the screen), a suitable font for the components of the
182 composition is selected and realized while drawing them on the
183 screen, i.e. the realization process is delayed but in principle
187 Initialization of basic faces.
189 The faces `default', `modeline' are considered `basic faces'.
190 When redisplay happens the first time for a newly created frame,
191 basic faces are realized for CHARSET_ASCII. Frame parameters are
192 used to fill in unspecified attributes of the default face. */
196 #include <sys/types.h>
197 #include <sys/stat.h>
198 #include <stdio.h> /* This needs to be before termchar.h */
202 #include "keyboard.h"
204 #include "termhooks.h"
206 #ifdef HAVE_WINDOW_SYSTEM
208 #endif /* HAVE_WINDOW_SYSTEM */
210 #ifdef HAVE_X_WINDOWS
214 #include <Xm/XmStrDefs.h>
215 #endif /* USE_MOTIF */
216 #endif /* HAVE_X_WINDOWS */
225 /* Redefine X specifics to W32 equivalents to avoid cluttering the
226 code with #ifdef blocks. */
227 #undef FRAME_X_DISPLAY_INFO
228 #define FRAME_X_DISPLAY_INFO FRAME_W32_DISPLAY_INFO
229 #define x_display_info w32_display_info
230 #define FRAME_X_FONT_TABLE FRAME_W32_FONT_TABLE
231 #define check_x check_w32
232 #define x_list_fonts w32_list_fonts
233 #define GCGraphicsExposures 0
234 #endif /* WINDOWSNT */
238 #define x_display_info mac_display_info
239 #define check_x check_mac
243 #include "dispextern.h"
244 #include "blockinput.h"
246 #include "intervals.h"
247 #include "termchar.h"
249 #ifdef HAVE_X_WINDOWS
251 /* Compensate for a bug in Xos.h on some systems, on which it requires
252 time.h. On some such systems, Xos.h tries to redefine struct
253 timeval and struct timezone if USG is #defined while it is
256 #ifdef XOS_NEEDS_TIME_H
262 #else /* not XOS_NEEDS_TIME_H */
264 #endif /* not XOS_NEEDS_TIME_H */
266 #endif /* HAVE_X_WINDOWS */
270 #define abs(X) ((X) < 0 ? -(X) : (X))
272 /* Number of pt per inch (from the TeXbook). */
274 #define PT_PER_INCH 72.27
276 /* Non-zero if face attribute ATTR is unspecified. */
278 #define UNSPECIFIEDP(ATTR) EQ ((ATTR), Qunspecified)
280 /* Non-zero if face attribute ATTR is `ignore-defface'. */
282 #define IGNORE_DEFFACE_P(ATTR) EQ ((ATTR), Qignore_defface)
284 /* Value is the number of elements of VECTOR. */
286 #define DIM(VECTOR) (sizeof (VECTOR) / sizeof *(VECTOR))
288 /* Make a copy of string S on the stack using alloca. Value is a pointer
291 #define STRDUPA(S) strcpy ((char *) alloca (strlen ((S)) + 1), (S))
293 /* Make a copy of the contents of Lisp string S on the stack using
294 alloca. Value is a pointer to the copy. */
296 #define LSTRDUPA(S) STRDUPA (SDATA ((S)))
298 /* Size of hash table of realized faces in face caches (should be a
301 #define FACE_CACHE_BUCKETS_SIZE 1001
303 /* Keyword symbols used for face attribute names. */
305 Lisp_Object QCfamily
, QCheight
, QCweight
, QCslant
, QCunderline
;
306 Lisp_Object QCinverse_video
, QCforeground
, QCbackground
, QCstipple
;
307 Lisp_Object QCwidth
, QCfont
, QCbold
, QCitalic
;
308 Lisp_Object QCreverse_video
;
309 Lisp_Object QCoverline
, QCstrike_through
, QCbox
, QCinherit
;
311 /* Symbols used for attribute values. */
313 Lisp_Object Qnormal
, Qbold
, Qultra_light
, Qextra_light
, Qlight
;
314 Lisp_Object Qsemi_light
, Qsemi_bold
, Qextra_bold
, Qultra_bold
;
315 Lisp_Object Qoblique
, Qitalic
, Qreverse_oblique
, Qreverse_italic
;
316 Lisp_Object Qultra_condensed
, Qextra_condensed
, Qcondensed
;
317 Lisp_Object Qsemi_condensed
, Qsemi_expanded
, Qexpanded
, Qextra_expanded
;
318 Lisp_Object Qultra_expanded
;
319 Lisp_Object Qreleased_button
, Qpressed_button
;
320 Lisp_Object QCstyle
, QCcolor
, QCline_width
;
321 Lisp_Object Qunspecified
;
322 Lisp_Object Qignore_defface
;
324 char unspecified_fg
[] = "unspecified-fg", unspecified_bg
[] = "unspecified-bg";
326 /* The name of the function to call when the background of the frame
327 has changed, frame_set_background_mode. */
329 Lisp_Object Qframe_set_background_mode
;
331 /* Names of basic faces. */
333 Lisp_Object Qdefault
, Qtool_bar
, Qregion
, Qfringe
;
334 Lisp_Object Qheader_line
, Qscroll_bar
, Qcursor
, Qborder
, Qmouse
, Qmenu
;
335 Lisp_Object Qmode_line_inactive
, Qvertical_border
;
336 extern Lisp_Object Qmode_line
;
338 /* The symbol `face-alias'. A symbols having that property is an
339 alias for another face. Value of the property is the name of
342 Lisp_Object Qface_alias
;
344 extern Lisp_Object Qcircular_list
;
346 /* Default stipple pattern used on monochrome displays. This stipple
347 pattern is used on monochrome displays instead of shades of gray
348 for a face background color. See `set-face-stipple' for possible
349 values for this variable. */
351 Lisp_Object Vface_default_stipple
;
353 /* Alist of alternative font families. Each element is of the form
354 (FAMILY FAMILY1 FAMILY2 ...). If fonts of FAMILY can't be loaded,
355 try FAMILY1, then FAMILY2, ... */
357 Lisp_Object Vface_alternative_font_family_alist
;
359 /* Alist of alternative font registries. Each element is of the form
360 (REGISTRY REGISTRY1 REGISTRY2...). If fonts of REGISTRY can't be
361 loaded, try REGISTRY1, then REGISTRY2, ... */
363 Lisp_Object Vface_alternative_font_registry_alist
;
365 /* Allowed scalable fonts. A value of nil means don't allow any
366 scalable fonts. A value of t means allow the use of any scalable
367 font. Otherwise, value must be a list of regular expressions. A
368 font may be scaled if its name matches a regular expression in the
371 Lisp_Object Vscalable_fonts_allowed
, Qscalable_fonts_allowed
;
373 /* List of regular expressions that matches names of fonts to ignore. */
375 Lisp_Object Vface_ignored_fonts
;
377 /* Alist of font name patterns vs the rescaling factor. */
379 Lisp_Object Vface_font_rescale_alist
;
381 /* Maximum number of fonts to consider in font_list. If not an
382 integer > 0, DEFAULT_FONT_LIST_LIMIT is used instead. */
384 Lisp_Object Vfont_list_limit
;
385 #define DEFAULT_FONT_LIST_LIMIT 100
387 /* The symbols `foreground-color' and `background-color' which can be
388 used as part of a `face' property. This is for compatibility with
391 Lisp_Object Qforeground_color
, Qbackground_color
;
393 /* The symbols `face' and `mouse-face' used as text properties. */
396 extern Lisp_Object Qmouse_face
;
398 /* Property for basic faces which other faces cannot inherit. */
400 Lisp_Object Qface_no_inherit
;
402 /* Error symbol for wrong_type_argument in load_pixmap. */
404 Lisp_Object Qbitmap_spec_p
;
406 /* Alist of global face definitions. Each element is of the form
407 (FACE . LFACE) where FACE is a symbol naming a face and LFACE
408 is a Lisp vector of face attributes. These faces are used
409 to initialize faces for new frames. */
411 Lisp_Object Vface_new_frame_defaults
;
413 /* The next ID to assign to Lisp faces. */
415 static int next_lface_id
;
417 /* A vector mapping Lisp face Id's to face names. */
419 static Lisp_Object
*lface_id_to_name
;
420 static int lface_id_to_name_size
;
422 /* TTY color-related functions (defined in tty-colors.el). */
424 Lisp_Object Qtty_color_desc
, Qtty_color_by_index
, Qtty_color_standard_values
;
426 /* The name of the function used to compute colors on TTYs. */
428 Lisp_Object Qtty_color_alist
;
430 /* An alist of defined terminal colors and their RGB values. */
432 Lisp_Object Vtty_defined_color_alist
;
434 /* Counter for calls to clear_face_cache. If this counter reaches
435 CLEAR_FONT_TABLE_COUNT, and a frame has more than
436 CLEAR_FONT_TABLE_NFONTS load, unused fonts are freed. */
438 static int clear_font_table_count
;
439 #define CLEAR_FONT_TABLE_COUNT 100
440 #define CLEAR_FONT_TABLE_NFONTS 10
442 /* Non-zero means face attributes have been changed since the last
443 redisplay. Used in redisplay_internal. */
445 int face_change_count
;
447 /* Non-zero means don't display bold text if a face's foreground
448 and background colors are the inverse of the default colors of the
449 display. This is a kluge to suppress `bold black' foreground text
450 which is hard to read on an LCD monitor. */
452 int tty_suppress_bold_inverse_default_colors_p
;
454 /* A list of the form `((x . y))' used to avoid consing in
455 Finternal_set_lisp_face_attribute. */
457 static Lisp_Object Vparam_value_alist
;
459 /* The total number of colors currently allocated. */
462 static int ncolors_allocated
;
463 static int npixmaps_allocated
;
467 /* Non-zero means the definition of the `menu' face for new frames has
470 int menu_face_changed_default
;
473 /* Function prototypes. */
477 struct named_merge_point
;
479 static void map_tty_color
P_ ((struct frame
*, struct face
*,
480 enum lface_attribute_index
, int *));
481 static Lisp_Object resolve_face_name
P_ ((Lisp_Object
, int));
482 static int may_use_scalable_font_p
P_ ((const char *));
483 static void set_font_frame_param
P_ ((Lisp_Object
, Lisp_Object
));
484 static int better_font_p
P_ ((int *, struct font_name
*, struct font_name
*,
486 static int x_face_list_fonts
P_ ((struct frame
*, char *,
487 struct font_name
**, int, int));
488 static int font_scalable_p
P_ ((struct font_name
*));
489 static int get_lface_attributes
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*, int));
490 static int load_pixmap
P_ ((struct frame
*, Lisp_Object
, unsigned *, unsigned *));
491 static unsigned char *xstrlwr
P_ ((unsigned char *));
492 static void signal_error
P_ ((char *, Lisp_Object
));
493 static struct frame
*frame_or_selected_frame
P_ ((Lisp_Object
, int));
494 static void load_face_font
P_ ((struct frame
*, struct face
*, int));
495 static void load_face_colors
P_ ((struct frame
*, struct face
*, Lisp_Object
*));
496 static void free_face_colors
P_ ((struct frame
*, struct face
*));
497 static int face_color_gray_p
P_ ((struct frame
*, char *));
498 static char *build_font_name
P_ ((struct font_name
*));
499 static void free_font_names
P_ ((struct font_name
*, int));
500 static int sorted_font_list
P_ ((struct frame
*, char *,
501 int (*cmpfn
) P_ ((const void *, const void *)),
502 struct font_name
**));
503 static int font_list_1
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
504 Lisp_Object
, struct font_name
**));
505 static int font_list
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
506 Lisp_Object
, struct font_name
**));
507 static int try_font_list
P_ ((struct frame
*, Lisp_Object
*,
508 Lisp_Object
, Lisp_Object
, struct font_name
**,
510 static int try_alternative_families
P_ ((struct frame
*f
, Lisp_Object
,
511 Lisp_Object
, struct font_name
**));
512 static int cmp_font_names
P_ ((const void *, const void *));
513 static struct face
*realize_face
P_ ((struct face_cache
*, Lisp_Object
*, int,
514 struct face
*, int));
515 static struct face
*realize_x_face
P_ ((struct face_cache
*,
516 Lisp_Object
*, int, struct face
*));
517 static struct face
*realize_tty_face
P_ ((struct face_cache
*,
518 Lisp_Object
*, int));
519 static int realize_basic_faces
P_ ((struct frame
*));
520 static int realize_default_face
P_ ((struct frame
*));
521 static void realize_named_face
P_ ((struct frame
*, Lisp_Object
, int));
522 static int lface_fully_specified_p
P_ ((Lisp_Object
*));
523 static int lface_equal_p
P_ ((Lisp_Object
*, Lisp_Object
*));
524 static unsigned hash_string_case_insensitive
P_ ((Lisp_Object
));
525 static unsigned lface_hash
P_ ((Lisp_Object
*));
526 static int lface_same_font_attributes_p
P_ ((Lisp_Object
*, Lisp_Object
*));
527 static struct face_cache
*make_face_cache
P_ ((struct frame
*));
528 static void free_realized_face
P_ ((struct frame
*, struct face
*));
529 static void clear_face_gcs
P_ ((struct face_cache
*));
530 static void free_face_cache
P_ ((struct face_cache
*));
531 static int face_numeric_weight
P_ ((Lisp_Object
));
532 static int face_numeric_slant
P_ ((Lisp_Object
));
533 static int face_numeric_swidth
P_ ((Lisp_Object
));
534 static int face_fontset
P_ ((Lisp_Object
*));
535 static char *choose_face_font
P_ ((struct frame
*, Lisp_Object
*, int, int, int*));
536 static void merge_face_vectors
P_ ((struct frame
*, Lisp_Object
*, Lisp_Object
*,
537 struct named_merge_point
*));
538 static int merge_face_ref
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*,
539 int, struct named_merge_point
*));
540 static int set_lface_from_font_name
P_ ((struct frame
*, Lisp_Object
,
541 Lisp_Object
, int, int));
542 static Lisp_Object lface_from_face_name
P_ ((struct frame
*, Lisp_Object
, int));
543 static struct face
*make_realized_face
P_ ((Lisp_Object
*));
544 static void free_realized_faces
P_ ((struct face_cache
*));
545 static char *best_matching_font
P_ ((struct frame
*, Lisp_Object
*,
546 struct font_name
*, int, int, int *));
547 static void cache_face
P_ ((struct face_cache
*, struct face
*, unsigned));
548 static void uncache_face
P_ ((struct face_cache
*, struct face
*));
549 static int xlfd_numeric_slant
P_ ((struct font_name
*));
550 static int xlfd_numeric_weight
P_ ((struct font_name
*));
551 static int xlfd_numeric_swidth
P_ ((struct font_name
*));
552 static Lisp_Object xlfd_symbolic_slant
P_ ((struct font_name
*));
553 static Lisp_Object xlfd_symbolic_weight
P_ ((struct font_name
*));
554 static Lisp_Object xlfd_symbolic_swidth
P_ ((struct font_name
*));
555 static int xlfd_fixed_p
P_ ((struct font_name
*));
556 static int xlfd_numeric_value
P_ ((struct table_entry
*, int, struct font_name
*,
558 static Lisp_Object xlfd_symbolic_value
P_ ((struct table_entry
*, int,
559 struct font_name
*, int,
561 static struct table_entry
*xlfd_lookup_field_contents
P_ ((struct table_entry
*, int,
562 struct font_name
*, int));
564 #ifdef HAVE_WINDOW_SYSTEM
566 static int split_font_name
P_ ((struct frame
*, struct font_name
*, int));
567 static int xlfd_point_size
P_ ((struct frame
*, struct font_name
*));
568 static void sort_fonts
P_ ((struct frame
*, struct font_name
*, int,
569 int (*cmpfn
) P_ ((const void *, const void *))));
570 static GC x_create_gc
P_ ((struct frame
*, unsigned long, XGCValues
*));
571 static void x_free_gc
P_ ((struct frame
*, GC
));
572 static void clear_font_table
P_ ((struct x_display_info
*));
575 extern Lisp_Object w32_list_fonts
P_ ((struct frame
*, Lisp_Object
, int, int));
576 #endif /* WINDOWSNT */
579 static void x_update_menu_appearance
P_ ((struct frame
*));
581 extern void free_frame_menubar
P_ ((struct frame
*));
582 #endif /* USE_X_TOOLKIT */
584 #endif /* HAVE_WINDOW_SYSTEM */
587 /***********************************************************************
589 ***********************************************************************/
591 #ifdef HAVE_X_WINDOWS
593 #ifdef DEBUG_X_COLORS
595 /* The following is a poor mans infrastructure for debugging X color
596 allocation problems on displays with PseudoColor-8. Some X servers
597 like 3.3.5 XF86_SVGA with Matrox cards apparently don't implement
598 color reference counts completely so that they don't signal an
599 error when a color is freed whose reference count is already 0.
600 Other X servers do. To help me debug this, the following code
601 implements a simple reference counting schema of its own, for a
602 single display/screen. --gerd. */
604 /* Reference counts for pixel colors. */
606 int color_count
[256];
608 /* Register color PIXEL as allocated. */
611 register_color (pixel
)
614 xassert (pixel
< 256);
615 ++color_count
[pixel
];
619 /* Register color PIXEL as deallocated. */
622 unregister_color (pixel
)
625 xassert (pixel
< 256);
626 if (color_count
[pixel
] > 0)
627 --color_count
[pixel
];
633 /* Register N colors from PIXELS as deallocated. */
636 unregister_colors (pixels
, n
)
637 unsigned long *pixels
;
641 for (i
= 0; i
< n
; ++i
)
642 unregister_color (pixels
[i
]);
646 DEFUN ("dump-colors", Fdump_colors
, Sdump_colors
, 0, 0, 0,
647 doc
: /* Dump currently allocated colors to stderr. */)
652 fputc ('\n', stderr
);
654 for (i
= n
= 0; i
< sizeof color_count
/ sizeof color_count
[0]; ++i
)
657 fprintf (stderr
, "%3d: %5d", i
, color_count
[i
]);
660 fputc ('\n', stderr
);
662 fputc ('\t', stderr
);
666 fputc ('\n', stderr
);
670 #endif /* DEBUG_X_COLORS */
673 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
674 color values. Interrupt input must be blocked when this function
678 x_free_colors (f
, pixels
, npixels
)
680 unsigned long *pixels
;
683 int class = FRAME_X_DISPLAY_INFO (f
)->visual
->class;
685 /* If display has an immutable color map, freeing colors is not
686 necessary and some servers don't allow it. So don't do it. */
687 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
689 #ifdef DEBUG_X_COLORS
690 unregister_colors (pixels
, npixels
);
692 XFreeColors (FRAME_X_DISPLAY (f
), FRAME_X_COLORMAP (f
),
698 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
699 color values. Interrupt input must be blocked when this function
703 x_free_dpy_colors (dpy
, screen
, cmap
, pixels
, npixels
)
707 unsigned long *pixels
;
710 struct x_display_info
*dpyinfo
= x_display_info_for_display (dpy
);
711 int class = dpyinfo
->visual
->class;
713 /* If display has an immutable color map, freeing colors is not
714 necessary and some servers don't allow it. So don't do it. */
715 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
717 #ifdef DEBUG_X_COLORS
718 unregister_colors (pixels
, npixels
);
720 XFreeColors (dpy
, cmap
, pixels
, npixels
, 0);
725 /* Create and return a GC for use on frame F. GC values and mask
726 are given by XGCV and MASK. */
729 x_create_gc (f
, mask
, xgcv
)
736 gc
= XCreateGC (FRAME_X_DISPLAY (f
), FRAME_X_WINDOW (f
), mask
, xgcv
);
743 /* Free GC which was used on frame F. */
751 IF_DEBUG (xassert (--ngcs
>= 0));
752 XFreeGC (FRAME_X_DISPLAY (f
), gc
);
756 #endif /* HAVE_X_WINDOWS */
759 /* W32 emulation of GCs */
762 x_create_gc (f
, mask
, xgcv
)
769 gc
= XCreateGC (NULL
, FRAME_W32_WINDOW (f
), mask
, xgcv
);
776 /* Free GC which was used on frame F. */
784 IF_DEBUG (xassert (--ngcs
>= 0));
789 #endif /* WINDOWSNT */
792 /* Mac OS emulation of GCs */
795 x_create_gc (f
, mask
, xgcv
)
802 gc
= XCreateGC (FRAME_MAC_DISPLAY (f
), FRAME_MAC_WINDOW (f
), mask
, xgcv
);
814 IF_DEBUG (xassert (--ngcs
>= 0));
815 XFreeGC (FRAME_MAC_DISPLAY (f
), gc
);
821 /* Like stricmp. Used to compare parts of font names which are in
826 const unsigned char *s1
, *s2
;
830 unsigned char c1
= tolower (*s1
);
831 unsigned char c2
= tolower (*s2
);
833 return c1
< c2
? -1 : 1;
838 return *s2
== 0 ? 0 : -1;
843 /* Like strlwr, which might not always be available. */
845 static unsigned char *
849 unsigned char *p
= s
;
852 /* On Mac OS X 10.3, tolower also converts non-ASCII characters
861 /* Signal `error' with message S, and additional argument ARG. */
864 signal_error (s
, arg
)
868 Fsignal (Qerror
, Fcons (build_string (s
), Fcons (arg
, Qnil
)));
872 /* If FRAME is nil, return a pointer to the selected frame.
873 Otherwise, check that FRAME is a live frame, and return a pointer
874 to it. NPARAM is the parameter number of FRAME, for
875 CHECK_LIVE_FRAME. This is here because it's a frequent pattern in
876 Lisp function definitions. */
878 static INLINE
struct frame
*
879 frame_or_selected_frame (frame
, nparam
)
884 frame
= selected_frame
;
886 CHECK_LIVE_FRAME (frame
);
887 return XFRAME (frame
);
891 /***********************************************************************
893 ***********************************************************************/
895 /* Initialize face cache and basic faces for frame F. */
901 /* Make a face cache, if F doesn't have one. */
902 if (FRAME_FACE_CACHE (f
) == NULL
)
903 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
905 #ifdef HAVE_WINDOW_SYSTEM
906 /* Make the image cache. */
907 if (FRAME_WINDOW_P (f
))
909 if (FRAME_X_IMAGE_CACHE (f
) == NULL
)
910 FRAME_X_IMAGE_CACHE (f
) = make_image_cache ();
911 ++FRAME_X_IMAGE_CACHE (f
)->refcount
;
913 #endif /* HAVE_WINDOW_SYSTEM */
915 /* Realize basic faces. Must have enough information in frame
916 parameters to realize basic faces at this point. */
917 #ifdef HAVE_X_WINDOWS
918 if (!FRAME_X_P (f
) || FRAME_X_WINDOW (f
))
921 if (!FRAME_WINDOW_P (f
) || FRAME_W32_WINDOW (f
))
924 if (!FRAME_MAC_P (f
) || FRAME_MAC_WINDOW (f
))
926 if (!realize_basic_faces (f
))
931 /* Free face cache of frame F. Called from Fdelete_frame. */
937 struct face_cache
*face_cache
= FRAME_FACE_CACHE (f
);
941 free_face_cache (face_cache
);
942 FRAME_FACE_CACHE (f
) = NULL
;
945 #ifdef HAVE_WINDOW_SYSTEM
946 if (FRAME_WINDOW_P (f
))
948 struct image_cache
*image_cache
= FRAME_X_IMAGE_CACHE (f
);
951 --image_cache
->refcount
;
952 if (image_cache
->refcount
== 0)
953 free_image_cache (f
);
956 #endif /* HAVE_WINDOW_SYSTEM */
960 /* Clear face caches, and recompute basic faces for frame F. Call
961 this after changing frame parameters on which those faces depend,
962 or when realized faces have been freed due to changing attributes
966 recompute_basic_faces (f
)
969 if (FRAME_FACE_CACHE (f
))
971 clear_face_cache (0);
972 if (!realize_basic_faces (f
))
978 /* Clear the face caches of all frames. CLEAR_FONTS_P non-zero means
979 try to free unused fonts, too. */
982 clear_face_cache (clear_fonts_p
)
985 #ifdef HAVE_WINDOW_SYSTEM
986 Lisp_Object tail
, frame
;
990 || ++clear_font_table_count
== CLEAR_FONT_TABLE_COUNT
)
992 struct x_display_info
*dpyinfo
;
994 /* Fonts are common for frames on one display, i.e. on
996 for (dpyinfo
= x_display_list
; dpyinfo
; dpyinfo
= dpyinfo
->next
)
997 if (dpyinfo
->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
998 clear_font_table (dpyinfo
);
1000 /* From time to time see if we can unload some fonts. This also
1001 frees all realized faces on all frames. Fonts needed by
1002 faces will be loaded again when faces are realized again. */
1003 clear_font_table_count
= 0;
1005 FOR_EACH_FRAME (tail
, frame
)
1007 struct frame
*f
= XFRAME (frame
);
1008 if (FRAME_WINDOW_P (f
)
1009 && FRAME_X_DISPLAY_INFO (f
)->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
1010 free_all_realized_faces (frame
);
1015 /* Clear GCs of realized faces. */
1016 FOR_EACH_FRAME (tail
, frame
)
1019 if (FRAME_WINDOW_P (f
))
1021 clear_face_gcs (FRAME_FACE_CACHE (f
));
1022 clear_image_cache (f
, 0);
1026 #endif /* HAVE_WINDOW_SYSTEM */
1030 DEFUN ("clear-face-cache", Fclear_face_cache
, Sclear_face_cache
, 0, 1, 0,
1031 doc
: /* Clear face caches on all frames.
1032 Optional THOROUGHLY non-nil means try to free unused fonts, too. */)
1034 Lisp_Object thoroughly
;
1036 clear_face_cache (!NILP (thoroughly
));
1037 ++face_change_count
;
1038 ++windows_or_buffers_changed
;
1044 #ifdef HAVE_WINDOW_SYSTEM
1047 /* Remove fonts from the font table of DPYINFO except for the default
1048 ASCII fonts of frames on that display. Called from clear_face_cache
1049 from time to time. */
1052 clear_font_table (dpyinfo
)
1053 struct x_display_info
*dpyinfo
;
1057 /* Free those fonts that are not used by frames on DPYINFO. */
1058 for (i
= 0; i
< dpyinfo
->n_fonts
; ++i
)
1060 struct font_info
*font_info
= dpyinfo
->font_table
+ i
;
1061 Lisp_Object tail
, frame
;
1063 /* Check if slot is already free. */
1064 if (font_info
->name
== NULL
)
1067 /* Don't free a default font of some frame. */
1068 FOR_EACH_FRAME (tail
, frame
)
1070 struct frame
*f
= XFRAME (frame
);
1071 if (FRAME_WINDOW_P (f
)
1072 && font_info
->font
== FRAME_FONT (f
))
1080 if (font_info
->full_name
!= font_info
->name
)
1081 xfree (font_info
->full_name
);
1082 xfree (font_info
->name
);
1084 /* Free the font. */
1086 #ifdef HAVE_X_WINDOWS
1087 XFreeFont (dpyinfo
->display
, font_info
->font
);
1090 w32_unload_font (dpyinfo
, font_info
->font
);
1093 mac_unload_font (dpyinfo
, font_info
->font
);
1097 /* Mark font table slot free. */
1098 font_info
->font
= NULL
;
1099 font_info
->name
= font_info
->full_name
= NULL
;
1103 #endif /* HAVE_WINDOW_SYSTEM */
1107 /***********************************************************************
1109 ***********************************************************************/
1111 #ifdef HAVE_WINDOW_SYSTEM
1113 DEFUN ("bitmap-spec-p", Fbitmap_spec_p
, Sbitmap_spec_p
, 1, 1, 0,
1114 doc
: /* Value is non-nil if OBJECT is a valid bitmap specification.
1115 A bitmap specification is either a string, a file name, or a list
1116 \(WIDTH HEIGHT DATA) where WIDTH is the pixel width of the bitmap,
1117 HEIGHT is its height, and DATA is a string containing the bits of
1118 the pixmap. Bits are stored row by row, each row occupies
1119 \(WIDTH + 7)/8 bytes. */)
1125 if (STRINGP (object
))
1126 /* If OBJECT is a string, it's a file name. */
1128 else if (CONSP (object
))
1130 /* Otherwise OBJECT must be (WIDTH HEIGHT DATA), WIDTH and
1131 HEIGHT must be integers > 0, and DATA must be string large
1132 enough to hold a bitmap of the specified size. */
1133 Lisp_Object width
, height
, data
;
1135 height
= width
= data
= Qnil
;
1139 width
= XCAR (object
);
1140 object
= XCDR (object
);
1143 height
= XCAR (object
);
1144 object
= XCDR (object
);
1146 data
= XCAR (object
);
1150 if (NATNUMP (width
) && NATNUMP (height
) && STRINGP (data
))
1152 int bytes_per_row
= ((XFASTINT (width
) + BITS_PER_CHAR
- 1)
1154 if (SBYTES (data
) >= bytes_per_row
* XINT (height
))
1159 return pixmap_p
? Qt
: Qnil
;
1163 /* Load a bitmap according to NAME (which is either a file name or a
1164 pixmap spec) for use on frame F. Value is the bitmap_id (see
1165 xfns.c). If NAME is nil, return with a bitmap id of zero. If
1166 bitmap cannot be loaded, display a message saying so, and return
1167 zero. Store the bitmap width in *W_PTR and its height in *H_PTR,
1168 if these pointers are not null. */
1171 load_pixmap (f
, name
, w_ptr
, h_ptr
)
1174 unsigned int *w_ptr
, *h_ptr
;
1182 tem
= Fbitmap_spec_p (name
);
1184 wrong_type_argument (Qbitmap_spec_p
, name
);
1189 /* Decode a bitmap spec into a bitmap. */
1194 w
= XINT (Fcar (name
));
1195 h
= XINT (Fcar (Fcdr (name
)));
1196 bits
= Fcar (Fcdr (Fcdr (name
)));
1198 bitmap_id
= x_create_bitmap_from_data (f
, SDATA (bits
),
1203 /* It must be a string -- a file name. */
1204 bitmap_id
= x_create_bitmap_from_file (f
, name
);
1210 add_to_log ("Invalid or undefined bitmap %s", name
, Qnil
);
1221 ++npixmaps_allocated
;
1224 *w_ptr
= x_bitmap_width (f
, bitmap_id
);
1227 *h_ptr
= x_bitmap_height (f
, bitmap_id
);
1233 #endif /* HAVE_WINDOW_SYSTEM */
1237 /***********************************************************************
1239 ***********************************************************************/
1241 #ifdef HAVE_WINDOW_SYSTEM
1243 /* Load font of face FACE which is used on frame F to display
1244 character C. The name of the font to load is determined by lface
1245 and fontset of FACE. */
1248 load_face_font (f
, face
, c
)
1253 struct font_info
*font_info
= NULL
;
1255 int needs_overstrike
;
1257 face
->font_info_id
= -1;
1260 font_name
= choose_face_font (f
, face
->lface
, face
->fontset
, c
,
1266 font_info
= FS_LOAD_FACE_FONT (f
, c
, font_name
, face
);
1271 face
->font_info_id
= font_info
->font_idx
;
1272 face
->font
= font_info
->font
;
1273 face
->font_name
= font_info
->full_name
;
1274 face
->overstrike
= needs_overstrike
;
1277 x_free_gc (f
, face
->gc
);
1282 add_to_log ("Unable to load font %s",
1283 build_string (font_name
), Qnil
);
1287 #endif /* HAVE_WINDOW_SYSTEM */
1291 /***********************************************************************
1293 ***********************************************************************/
1295 /* Parse RGB_LIST, and fill in the RGB fields of COLOR.
1296 RGB_LIST should contain (at least) 3 lisp integers.
1297 Return 0 if there's a problem with RGB_LIST, otherwise return 1. */
1300 parse_rgb_list (rgb_list
, color
)
1301 Lisp_Object rgb_list
;
1304 #define PARSE_RGB_LIST_FIELD(field) \
1305 if (CONSP (rgb_list) && INTEGERP (XCAR (rgb_list))) \
1307 color->field = XINT (XCAR (rgb_list)); \
1308 rgb_list = XCDR (rgb_list); \
1313 PARSE_RGB_LIST_FIELD (red
);
1314 PARSE_RGB_LIST_FIELD (green
);
1315 PARSE_RGB_LIST_FIELD (blue
);
1321 /* Lookup on frame F the color described by the lisp string COLOR.
1322 The resulting tty color is returned in TTY_COLOR; if STD_COLOR is
1323 non-zero, then the `standard' definition of the same color is
1327 tty_lookup_color (f
, color
, tty_color
, std_color
)
1330 XColor
*tty_color
, *std_color
;
1332 Lisp_Object frame
, color_desc
;
1334 if (!STRINGP (color
) || NILP (Ffboundp (Qtty_color_desc
)))
1337 XSETFRAME (frame
, f
);
1339 color_desc
= call2 (Qtty_color_desc
, color
, frame
);
1340 if (CONSP (color_desc
) && CONSP (XCDR (color_desc
)))
1344 if (! INTEGERP (XCAR (XCDR (color_desc
))))
1347 tty_color
->pixel
= XINT (XCAR (XCDR (color_desc
)));
1349 rgb
= XCDR (XCDR (color_desc
));
1350 if (! parse_rgb_list (rgb
, tty_color
))
1353 /* Should we fill in STD_COLOR too? */
1356 /* Default STD_COLOR to the same as TTY_COLOR. */
1357 *std_color
= *tty_color
;
1359 /* Do a quick check to see if the returned descriptor is
1360 actually _exactly_ equal to COLOR, otherwise we have to
1361 lookup STD_COLOR separately. If it's impossible to lookup
1362 a standard color, we just give up and use TTY_COLOR. */
1363 if ((!STRINGP (XCAR (color_desc
))
1364 || NILP (Fstring_equal (color
, XCAR (color_desc
))))
1365 && !NILP (Ffboundp (Qtty_color_standard_values
)))
1367 /* Look up STD_COLOR separately. */
1368 rgb
= call1 (Qtty_color_standard_values
, color
);
1369 if (! parse_rgb_list (rgb
, std_color
))
1376 else if (NILP (Fsymbol_value (intern ("tty-defined-color-alist"))))
1377 /* We were called early during startup, and the colors are not
1378 yet set up in tty-defined-color-alist. Don't return a failure
1379 indication, since this produces the annoying "Unable to
1380 load color" messages in the *Messages* buffer. */
1383 /* tty-color-desc seems to have returned a bad value. */
1387 /* A version of defined_color for non-X frames. */
1390 tty_defined_color (f
, color_name
, color_def
, alloc
)
1399 color_def
->pixel
= FACE_TTY_DEFAULT_COLOR
;
1401 color_def
->blue
= 0;
1402 color_def
->green
= 0;
1405 status
= tty_lookup_color (f
, build_string (color_name
), color_def
, 0);
1407 if (color_def
->pixel
== FACE_TTY_DEFAULT_COLOR
&& *color_name
)
1409 if (strcmp (color_name
, "unspecified-fg") == 0)
1410 color_def
->pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
1411 else if (strcmp (color_name
, "unspecified-bg") == 0)
1412 color_def
->pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
1415 if (color_def
->pixel
!= FACE_TTY_DEFAULT_COLOR
)
1422 /* Decide if color named COLOR_NAME is valid for the display
1423 associated with the frame F; if so, return the rgb values in
1424 COLOR_DEF. If ALLOC is nonzero, allocate a new colormap cell.
1426 This does the right thing for any type of frame. */
1429 defined_color (f
, color_name
, color_def
, alloc
)
1435 if (!FRAME_WINDOW_P (f
))
1436 return tty_defined_color (f
, color_name
, color_def
, alloc
);
1437 #ifdef HAVE_X_WINDOWS
1438 else if (FRAME_X_P (f
))
1439 return x_defined_color (f
, color_name
, color_def
, alloc
);
1442 else if (FRAME_W32_P (f
))
1443 return w32_defined_color (f
, color_name
, color_def
, alloc
);
1446 else if (FRAME_MAC_P (f
))
1447 return mac_defined_color (f
, color_name
, color_def
, alloc
);
1454 /* Given the index IDX of a tty color on frame F, return its name, a
1458 tty_color_name (f
, idx
)
1462 if (idx
>= 0 && !NILP (Ffboundp (Qtty_color_by_index
)))
1465 Lisp_Object coldesc
;
1467 XSETFRAME (frame
, f
);
1468 coldesc
= call2 (Qtty_color_by_index
, make_number (idx
), frame
);
1470 if (!NILP (coldesc
))
1471 return XCAR (coldesc
);
1474 /* We can have an MSDOG frame under -nw for a short window of
1475 opportunity before internal_terminal_init is called. DTRT. */
1476 if (FRAME_MSDOS_P (f
) && !inhibit_window_system
)
1477 return msdos_stdcolor_name (idx
);
1480 if (idx
== FACE_TTY_DEFAULT_FG_COLOR
)
1481 return build_string (unspecified_fg
);
1482 if (idx
== FACE_TTY_DEFAULT_BG_COLOR
)
1483 return build_string (unspecified_bg
);
1486 return vga_stdcolor_name (idx
);
1489 return Qunspecified
;
1493 /* Return non-zero if COLOR_NAME is a shade of gray (or white or
1496 The criterion implemented here is not a terribly sophisticated one. */
1499 face_color_gray_p (f
, color_name
)
1506 if (defined_color (f
, color_name
, &color
, 0))
1507 gray_p
= (/* Any color sufficiently close to black counts as grey. */
1508 (color
.red
< 5000 && color
.green
< 5000 && color
.blue
< 5000)
1510 ((abs (color
.red
- color
.green
)
1511 < max (color
.red
, color
.green
) / 20)
1512 && (abs (color
.green
- color
.blue
)
1513 < max (color
.green
, color
.blue
) / 20)
1514 && (abs (color
.blue
- color
.red
)
1515 < max (color
.blue
, color
.red
) / 20)));
1523 /* Return non-zero if color COLOR_NAME can be displayed on frame F.
1524 BACKGROUND_P non-zero means the color will be used as background
1528 face_color_supported_p (f
, color_name
, background_p
)
1536 XSETFRAME (frame
, f
);
1538 #ifdef HAVE_WINDOW_SYSTEM
1540 ? (!NILP (Fxw_display_color_p (frame
))
1541 || xstricmp (color_name
, "black") == 0
1542 || xstricmp (color_name
, "white") == 0
1544 && face_color_gray_p (f
, color_name
))
1545 || (!NILP (Fx_display_grayscale_p (frame
))
1546 && face_color_gray_p (f
, color_name
)))
1549 tty_defined_color (f
, color_name
, ¬_used
, 0);
1553 DEFUN ("color-gray-p", Fcolor_gray_p
, Scolor_gray_p
, 1, 2, 0,
1554 doc
: /* Return non-nil if COLOR is a shade of gray (or white or black).
1555 FRAME specifies the frame and thus the display for interpreting COLOR.
1556 If FRAME is nil or omitted, use the selected frame. */)
1558 Lisp_Object color
, frame
;
1562 CHECK_STRING (color
);
1564 frame
= selected_frame
;
1566 CHECK_FRAME (frame
);
1568 return face_color_gray_p (f
, SDATA (color
)) ? Qt
: Qnil
;
1572 DEFUN ("color-supported-p", Fcolor_supported_p
,
1573 Scolor_supported_p
, 1, 3, 0,
1574 doc
: /* Return non-nil if COLOR can be displayed on FRAME.
1575 BACKGROUND-P non-nil means COLOR is used as a background.
1576 Otherwise, this function tells whether it can be used as a foreground.
1577 If FRAME is nil or omitted, use the selected frame.
1578 COLOR must be a valid color name. */)
1579 (color
, frame
, background_p
)
1580 Lisp_Object frame
, color
, background_p
;
1584 CHECK_STRING (color
);
1586 frame
= selected_frame
;
1588 CHECK_FRAME (frame
);
1590 if (face_color_supported_p (f
, SDATA (color
), !NILP (background_p
)))
1596 /* Load color with name NAME for use by face FACE on frame F.
1597 TARGET_INDEX must be one of LFACE_FOREGROUND_INDEX,
1598 LFACE_BACKGROUND_INDEX, LFACE_UNDERLINE_INDEX, LFACE_OVERLINE_INDEX,
1599 LFACE_STRIKE_THROUGH_INDEX, or LFACE_BOX_INDEX. Value is the
1600 pixel color. If color cannot be loaded, display a message, and
1601 return the foreground, background or underline color of F, but
1602 record that fact in flags of the face so that we don't try to free
1606 load_color (f
, face
, name
, target_index
)
1610 enum lface_attribute_index target_index
;
1614 xassert (STRINGP (name
));
1615 xassert (target_index
== LFACE_FOREGROUND_INDEX
1616 || target_index
== LFACE_BACKGROUND_INDEX
1617 || target_index
== LFACE_UNDERLINE_INDEX
1618 || target_index
== LFACE_OVERLINE_INDEX
1619 || target_index
== LFACE_STRIKE_THROUGH_INDEX
1620 || target_index
== LFACE_BOX_INDEX
);
1622 /* if the color map is full, defined_color will return a best match
1623 to the values in an existing cell. */
1624 if (!defined_color (f
, SDATA (name
), &color
, 1))
1626 add_to_log ("Unable to load color \"%s\"", name
, Qnil
);
1628 switch (target_index
)
1630 case LFACE_FOREGROUND_INDEX
:
1631 face
->foreground_defaulted_p
= 1;
1632 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1635 case LFACE_BACKGROUND_INDEX
:
1636 face
->background_defaulted_p
= 1;
1637 color
.pixel
= FRAME_BACKGROUND_PIXEL (f
);
1640 case LFACE_UNDERLINE_INDEX
:
1641 face
->underline_defaulted_p
= 1;
1642 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1645 case LFACE_OVERLINE_INDEX
:
1646 face
->overline_color_defaulted_p
= 1;
1647 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1650 case LFACE_STRIKE_THROUGH_INDEX
:
1651 face
->strike_through_color_defaulted_p
= 1;
1652 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1655 case LFACE_BOX_INDEX
:
1656 face
->box_color_defaulted_p
= 1;
1657 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1666 ++ncolors_allocated
;
1673 #ifdef HAVE_WINDOW_SYSTEM
1675 /* Load colors for face FACE which is used on frame F. Colors are
1676 specified by slots LFACE_BACKGROUND_INDEX and LFACE_FOREGROUND_INDEX
1677 of ATTRS. If the background color specified is not supported on F,
1678 try to emulate gray colors with a stipple from Vface_default_stipple. */
1681 load_face_colors (f
, face
, attrs
)
1688 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
1689 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
1691 /* Swap colors if face is inverse-video. */
1692 if (EQ (attrs
[LFACE_INVERSE_INDEX
], Qt
))
1700 /* Check for support for foreground, not for background because
1701 face_color_supported_p is smart enough to know that grays are
1702 "supported" as background because we are supposed to use stipple
1704 if (!face_color_supported_p (f
, SDATA (bg
), 0)
1705 && !NILP (Fbitmap_spec_p (Vface_default_stipple
)))
1707 x_destroy_bitmap (f
, face
->stipple
);
1708 face
->stipple
= load_pixmap (f
, Vface_default_stipple
,
1709 &face
->pixmap_w
, &face
->pixmap_h
);
1712 face
->background
= load_color (f
, face
, bg
, LFACE_BACKGROUND_INDEX
);
1713 face
->foreground
= load_color (f
, face
, fg
, LFACE_FOREGROUND_INDEX
);
1717 /* Free color PIXEL on frame F. */
1720 unload_color (f
, pixel
)
1722 unsigned long pixel
;
1724 #ifdef HAVE_X_WINDOWS
1728 x_free_colors (f
, &pixel
, 1);
1735 /* Free colors allocated for FACE. */
1738 free_face_colors (f
, face
)
1742 #ifdef HAVE_X_WINDOWS
1743 if (face
->colors_copied_bitwise_p
)
1748 if (!face
->foreground_defaulted_p
)
1750 x_free_colors (f
, &face
->foreground
, 1);
1751 IF_DEBUG (--ncolors_allocated
);
1754 if (!face
->background_defaulted_p
)
1756 x_free_colors (f
, &face
->background
, 1);
1757 IF_DEBUG (--ncolors_allocated
);
1760 if (face
->underline_p
1761 && !face
->underline_defaulted_p
)
1763 x_free_colors (f
, &face
->underline_color
, 1);
1764 IF_DEBUG (--ncolors_allocated
);
1767 if (face
->overline_p
1768 && !face
->overline_color_defaulted_p
)
1770 x_free_colors (f
, &face
->overline_color
, 1);
1771 IF_DEBUG (--ncolors_allocated
);
1774 if (face
->strike_through_p
1775 && !face
->strike_through_color_defaulted_p
)
1777 x_free_colors (f
, &face
->strike_through_color
, 1);
1778 IF_DEBUG (--ncolors_allocated
);
1781 if (face
->box
!= FACE_NO_BOX
1782 && !face
->box_color_defaulted_p
)
1784 x_free_colors (f
, &face
->box_color
, 1);
1785 IF_DEBUG (--ncolors_allocated
);
1789 #endif /* HAVE_X_WINDOWS */
1792 #endif /* HAVE_WINDOW_SYSTEM */
1796 /***********************************************************************
1798 ***********************************************************************/
1800 /* An enumerator for each field of an XLFD font name. */
1821 /* An enumerator for each possible slant value of a font. Taken from
1822 the XLFD specification. */
1830 XLFD_SLANT_REVERSE_ITALIC
,
1831 XLFD_SLANT_REVERSE_OBLIQUE
,
1835 /* Relative font weight according to XLFD documentation. */
1839 XLFD_WEIGHT_UNKNOWN
,
1840 XLFD_WEIGHT_ULTRA_LIGHT
, /* 10 */
1841 XLFD_WEIGHT_EXTRA_LIGHT
, /* 20 */
1842 XLFD_WEIGHT_LIGHT
, /* 30 */
1843 XLFD_WEIGHT_SEMI_LIGHT
, /* 40: SemiLight, Book, ... */
1844 XLFD_WEIGHT_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1845 XLFD_WEIGHT_SEMI_BOLD
, /* 60: SemiBold, DemiBold, ... */
1846 XLFD_WEIGHT_BOLD
, /* 70: Bold, ... */
1847 XLFD_WEIGHT_EXTRA_BOLD
, /* 80: ExtraBold, Heavy, ... */
1848 XLFD_WEIGHT_ULTRA_BOLD
/* 90: UltraBold, Black, ... */
1851 /* Relative proportionate width. */
1855 XLFD_SWIDTH_UNKNOWN
,
1856 XLFD_SWIDTH_ULTRA_CONDENSED
, /* 10 */
1857 XLFD_SWIDTH_EXTRA_CONDENSED
, /* 20 */
1858 XLFD_SWIDTH_CONDENSED
, /* 30: Condensed, Narrow, Compressed, ... */
1859 XLFD_SWIDTH_SEMI_CONDENSED
, /* 40: semicondensed */
1860 XLFD_SWIDTH_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1861 XLFD_SWIDTH_SEMI_EXPANDED
, /* 60: SemiExpanded, DemiExpanded, ... */
1862 XLFD_SWIDTH_EXPANDED
, /* 70: Expanded... */
1863 XLFD_SWIDTH_EXTRA_EXPANDED
, /* 80: ExtraExpanded, Wide... */
1864 XLFD_SWIDTH_ULTRA_EXPANDED
/* 90: UltraExpanded... */
1867 /* Structure used for tables mapping XLFD weight, slant, and width
1868 names to numeric and symbolic values. */
1874 Lisp_Object
*symbol
;
1877 /* Table of XLFD slant names and their numeric and symbolic
1878 representations. This table must be sorted by slant names in
1881 static struct table_entry slant_table
[] =
1883 {"i", XLFD_SLANT_ITALIC
, &Qitalic
},
1884 {"o", XLFD_SLANT_OBLIQUE
, &Qoblique
},
1885 {"ot", XLFD_SLANT_OTHER
, &Qitalic
},
1886 {"r", XLFD_SLANT_ROMAN
, &Qnormal
},
1887 {"ri", XLFD_SLANT_REVERSE_ITALIC
, &Qreverse_italic
},
1888 {"ro", XLFD_SLANT_REVERSE_OBLIQUE
, &Qreverse_oblique
}
1891 /* Table of XLFD weight names. This table must be sorted by weight
1892 names in ascending order. */
1894 static struct table_entry weight_table
[] =
1896 {"black", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
},
1897 {"bold", XLFD_WEIGHT_BOLD
, &Qbold
},
1898 {"book", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1899 {"demi", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1900 {"demibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1901 {"extralight", XLFD_WEIGHT_EXTRA_LIGHT
, &Qextra_light
},
1902 {"extrabold", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1903 {"heavy", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1904 {"light", XLFD_WEIGHT_LIGHT
, &Qlight
},
1905 {"medium", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1906 {"normal", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1907 {"regular", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1908 {"semibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1909 {"semilight", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1910 {"ultralight", XLFD_WEIGHT_ULTRA_LIGHT
, &Qultra_light
},
1911 {"ultrabold", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
}
1914 /* Table of XLFD width names. This table must be sorted by width
1915 names in ascending order. */
1917 static struct table_entry swidth_table
[] =
1919 {"compressed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1920 {"condensed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1921 {"demiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1922 {"expanded", XLFD_SWIDTH_EXPANDED
, &Qexpanded
},
1923 {"extracondensed", XLFD_SWIDTH_EXTRA_CONDENSED
, &Qextra_condensed
},
1924 {"extraexpanded", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
},
1925 {"medium", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1926 {"narrow", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1927 {"normal", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1928 {"regular", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1929 {"semicondensed", XLFD_SWIDTH_SEMI_CONDENSED
, &Qsemi_condensed
},
1930 {"semiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1931 {"ultracondensed", XLFD_SWIDTH_ULTRA_CONDENSED
, &Qultra_condensed
},
1932 {"ultraexpanded", XLFD_SWIDTH_ULTRA_EXPANDED
, &Qultra_expanded
},
1933 {"wide", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
}
1936 /* Structure used to hold the result of splitting font names in XLFD
1937 format into their fields. */
1941 /* The original name which is modified destructively by
1942 split_font_name. The pointer is kept here to be able to free it
1943 if it was allocated from the heap. */
1946 /* Font name fields. Each vector element points into `name' above.
1947 Fields are NUL-terminated. */
1948 char *fields
[XLFD_LAST
];
1950 /* Numeric values for those fields that interest us. See
1951 split_font_name for which these are. */
1952 int numeric
[XLFD_LAST
];
1954 /* If the original name matches one of Vface_font_rescale_alist,
1955 the value is the corresponding rescale ratio. Otherwise, the
1957 double rescale_ratio
;
1959 /* Lower value mean higher priority. */
1960 int registry_priority
;
1963 /* The frame in effect when sorting font names. Set temporarily in
1964 sort_fonts so that it is available in font comparison functions. */
1966 static struct frame
*font_frame
;
1968 /* Order by which font selection chooses fonts. The default values
1969 mean `first, find a best match for the font width, then for the
1970 font height, then for weight, then for slant.' This variable can be
1971 set via set-face-font-sort-order. */
1974 static int font_sort_order
[4] = {
1975 XLFD_SWIDTH
, XLFD_POINT_SIZE
, XLFD_WEIGHT
, XLFD_SLANT
1978 static int font_sort_order
[4];
1981 /* Look up FONT.fields[FIELD_INDEX] in TABLE which has DIM entries.
1982 TABLE must be sorted by TABLE[i]->name in ascending order. Value
1983 is a pointer to the matching table entry or null if no table entry
1986 static struct table_entry
*
1987 xlfd_lookup_field_contents (table
, dim
, font
, field_index
)
1988 struct table_entry
*table
;
1990 struct font_name
*font
;
1993 /* Function split_font_name converts fields to lower-case, so there
1994 is no need to use xstrlwr or xstricmp here. */
1995 char *s
= font
->fields
[field_index
];
1996 int low
, mid
, high
, cmp
;
2003 mid
= (low
+ high
) / 2;
2004 cmp
= strcmp (table
[mid
].name
, s
);
2018 /* Return a numeric representation for font name field
2019 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
2020 has DIM entries. Value is the numeric value found or DFLT if no
2021 table entry matches. This function is used to translate weight,
2022 slant, and swidth names of XLFD font names to numeric values. */
2025 xlfd_numeric_value (table
, dim
, font
, field_index
, dflt
)
2026 struct table_entry
*table
;
2028 struct font_name
*font
;
2032 struct table_entry
*p
;
2033 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2034 return p
? p
->numeric
: dflt
;
2038 /* Return a symbolic representation for font name field
2039 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
2040 has DIM entries. Value is the symbolic value found or DFLT if no
2041 table entry matches. This function is used to translate weight,
2042 slant, and swidth names of XLFD font names to symbols. */
2044 static INLINE Lisp_Object
2045 xlfd_symbolic_value (table
, dim
, font
, field_index
, dflt
)
2046 struct table_entry
*table
;
2048 struct font_name
*font
;
2052 struct table_entry
*p
;
2053 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2054 return p
? *p
->symbol
: dflt
;
2058 /* Return a numeric value for the slant of the font given by FONT. */
2061 xlfd_numeric_slant (font
)
2062 struct font_name
*font
;
2064 return xlfd_numeric_value (slant_table
, DIM (slant_table
),
2065 font
, XLFD_SLANT
, XLFD_SLANT_ROMAN
);
2069 /* Return a symbol representing the weight of the font given by FONT. */
2071 static INLINE Lisp_Object
2072 xlfd_symbolic_slant (font
)
2073 struct font_name
*font
;
2075 return xlfd_symbolic_value (slant_table
, DIM (slant_table
),
2076 font
, XLFD_SLANT
, Qnormal
);
2080 /* Return a numeric value for the weight of the font given by FONT. */
2083 xlfd_numeric_weight (font
)
2084 struct font_name
*font
;
2086 return xlfd_numeric_value (weight_table
, DIM (weight_table
),
2087 font
, XLFD_WEIGHT
, XLFD_WEIGHT_MEDIUM
);
2091 /* Return a symbol representing the slant of the font given by FONT. */
2093 static INLINE Lisp_Object
2094 xlfd_symbolic_weight (font
)
2095 struct font_name
*font
;
2097 return xlfd_symbolic_value (weight_table
, DIM (weight_table
),
2098 font
, XLFD_WEIGHT
, Qnormal
);
2102 /* Return a numeric value for the swidth of the font whose XLFD font
2103 name fields are found in FONT. */
2106 xlfd_numeric_swidth (font
)
2107 struct font_name
*font
;
2109 return xlfd_numeric_value (swidth_table
, DIM (swidth_table
),
2110 font
, XLFD_SWIDTH
, XLFD_SWIDTH_MEDIUM
);
2114 /* Return a symbolic value for the swidth of FONT. */
2116 static INLINE Lisp_Object
2117 xlfd_symbolic_swidth (font
)
2118 struct font_name
*font
;
2120 return xlfd_symbolic_value (swidth_table
, DIM (swidth_table
),
2121 font
, XLFD_SWIDTH
, Qnormal
);
2125 /* Look up the entry of SYMBOL in the vector TABLE which has DIM
2126 entries. Value is a pointer to the matching table entry or null if
2127 no element of TABLE contains SYMBOL. */
2129 static struct table_entry
*
2130 face_value (table
, dim
, symbol
)
2131 struct table_entry
*table
;
2137 xassert (SYMBOLP (symbol
));
2139 for (i
= 0; i
< dim
; ++i
)
2140 if (EQ (*table
[i
].symbol
, symbol
))
2143 return i
< dim
? table
+ i
: NULL
;
2147 /* Return a numeric value for SYMBOL in the vector TABLE which has DIM
2148 entries. Value is -1 if SYMBOL is not found in TABLE. */
2151 face_numeric_value (table
, dim
, symbol
)
2152 struct table_entry
*table
;
2156 struct table_entry
*p
= face_value (table
, dim
, symbol
);
2157 return p
? p
->numeric
: -1;
2161 /* Return a numeric value representing the weight specified by Lisp
2162 symbol WEIGHT. Value is one of the enumerators of enum
2166 face_numeric_weight (weight
)
2169 return face_numeric_value (weight_table
, DIM (weight_table
), weight
);
2173 /* Return a numeric value representing the slant specified by Lisp
2174 symbol SLANT. Value is one of the enumerators of enum xlfd_slant. */
2177 face_numeric_slant (slant
)
2180 return face_numeric_value (slant_table
, DIM (slant_table
), slant
);
2184 /* Return a numeric value representing the swidth specified by Lisp
2185 symbol WIDTH. Value is one of the enumerators of enum xlfd_swidth. */
2188 face_numeric_swidth (width
)
2191 return face_numeric_value (swidth_table
, DIM (swidth_table
), width
);
2195 #ifdef HAVE_WINDOW_SYSTEM
2197 /* Return non-zero if FONT is the name of a fixed-pitch font. */
2201 struct font_name
*font
;
2203 /* Function split_font_name converts fields to lower-case, so there
2204 is no need to use tolower here. */
2205 return *font
->fields
[XLFD_SPACING
] != 'p';
2209 /* Return the point size of FONT on frame F, measured in 1/10 pt.
2211 The actual height of the font when displayed on F depends on the
2212 resolution of both the font and frame. For example, a 10pt font
2213 designed for a 100dpi display will display larger than 10pt on a
2214 75dpi display. (It's not unusual to use fonts not designed for the
2215 display one is using. For example, some intlfonts are available in
2216 72dpi versions, only.)
2218 Value is the real point size of FONT on frame F, or 0 if it cannot
2222 xlfd_point_size (f
, font
)
2224 struct font_name
*font
;
2226 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2227 char *pixel_field
= font
->fields
[XLFD_PIXEL_SIZE
];
2231 if (*pixel_field
== '[')
2233 /* The pixel size field is `[A B C D]' which specifies
2234 a transformation matrix.
2240 by which all glyphs of the font are transformed. The spec
2241 says that s scalar value N for the pixel size is equivalent
2242 to A = N * resx/resy, B = C = 0, D = N. */
2243 char *start
= pixel_field
+ 1, *end
;
2247 for (i
= 0; i
< 4; ++i
)
2249 matrix
[i
] = strtod (start
, &end
);
2256 pixel
= atoi (pixel_field
);
2261 real_pt
= PT_PER_INCH
* 10.0 * pixel
/ resy
+ 0.5;
2267 /* Return point size of PIXEL dots while considering Y-resultion (DPI)
2268 of frame F. This function is used to guess a point size of font
2269 when only the pixel height of the font is available. */
2272 pixel_point_size (f
, pixel
)
2276 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2280 /* As one inch is PT_PER_INCH points, PT_PER_INCH/RESY gives the
2281 point size of one dot. */
2282 real_pt
= pixel
* PT_PER_INCH
/ resy
;
2283 int_pt
= real_pt
+ 0.5;
2289 /* Return a rescaling ratio of a font of NAME. */
2292 font_rescale_ratio (name
)
2295 Lisp_Object tail
, elt
;
2297 for (tail
= Vface_font_rescale_alist
; CONSP (tail
); tail
= XCDR (tail
))
2300 if (STRINGP (XCAR (elt
)) && FLOATP (XCDR (elt
))
2301 && fast_c_string_match_ignore_case (XCAR (elt
), name
) >= 0)
2302 return XFLOAT_DATA (XCDR (elt
));
2308 /* Split XLFD font name FONT->name destructively into NUL-terminated,
2309 lower-case fields in FONT->fields. NUMERIC_P non-zero means
2310 compute numeric values for fields XLFD_POINT_SIZE, XLFD_SWIDTH,
2311 XLFD_RESY, XLFD_SLANT, and XLFD_WEIGHT in FONT->numeric. Value is
2312 zero if the font name doesn't have the format we expect. The
2313 expected format is a font name that starts with a `-' and has
2314 XLFD_LAST fields separated by `-'. */
2317 split_font_name (f
, font
, numeric_p
)
2319 struct font_name
*font
;
2324 double rescale_ratio
;
2327 /* This must be done before splitting the font name. */
2328 rescale_ratio
= font_rescale_ratio (font
->name
);
2330 if (*font
->name
== '-')
2332 char *p
= xstrlwr (font
->name
) + 1;
2334 while (i
< XLFD_LAST
)
2336 font
->fields
[i
] = p
;
2339 /* Pixel and point size may be of the form `[....]'. For
2340 BNF, see XLFD spec, chapter 4. Negative values are
2341 indicated by tilde characters which we replace with
2342 `-' characters, here. */
2344 && (i
- 1 == XLFD_PIXEL_SIZE
2345 || i
- 1 == XLFD_POINT_SIZE
))
2350 for (++p
; *p
&& *p
!= ']'; ++p
)
2354 /* Check that the matrix contains 4 floating point
2356 for (j
= 0, start
= font
->fields
[i
- 1] + 1;
2359 if (strtod (start
, &end
) == 0 && start
== end
)
2366 while (*p
&& *p
!= '-')
2376 success_p
= i
== XLFD_LAST
;
2378 /* If requested, and font name was in the expected format,
2379 compute numeric values for some fields. */
2380 if (numeric_p
&& success_p
)
2382 font
->numeric
[XLFD_POINT_SIZE
] = xlfd_point_size (f
, font
);
2383 font
->numeric
[XLFD_RESY
] = atoi (font
->fields
[XLFD_RESY
]);
2384 font
->numeric
[XLFD_SLANT
] = xlfd_numeric_slant (font
);
2385 font
->numeric
[XLFD_WEIGHT
] = xlfd_numeric_weight (font
);
2386 font
->numeric
[XLFD_SWIDTH
] = xlfd_numeric_swidth (font
);
2387 font
->numeric
[XLFD_AVGWIDTH
] = atoi (font
->fields
[XLFD_AVGWIDTH
]);
2388 font
->rescale_ratio
= rescale_ratio
;
2391 /* Initialize it to zero. It will be overridden by font_list while
2392 trying alternate registries. */
2393 font
->registry_priority
= 0;
2399 /* Build an XLFD font name from font name fields in FONT. Value is a
2400 pointer to the font name, which is allocated via xmalloc. */
2403 build_font_name (font
)
2404 struct font_name
*font
;
2408 char *font_name
= (char *) xmalloc (size
);
2409 int total_length
= 0;
2411 for (i
= 0; i
< XLFD_LAST
; ++i
)
2413 /* Add 1 because of the leading `-'. */
2414 int len
= strlen (font
->fields
[i
]) + 1;
2416 /* Reallocate font_name if necessary. Add 1 for the final
2418 if (total_length
+ len
+ 1 >= size
)
2420 int new_size
= max (2 * size
, size
+ len
+ 1);
2421 int sz
= new_size
* sizeof *font_name
;
2422 font_name
= (char *) xrealloc (font_name
, sz
);
2426 font_name
[total_length
] = '-';
2427 bcopy (font
->fields
[i
], font_name
+ total_length
+ 1, len
- 1);
2428 total_length
+= len
;
2431 font_name
[total_length
] = 0;
2436 /* Free an array FONTS of N font_name structures. This frees FONTS
2437 itself and all `name' fields in its elements. */
2440 free_font_names (fonts
, n
)
2441 struct font_name
*fonts
;
2445 xfree (fonts
[--n
].name
);
2450 /* Sort vector FONTS of font_name structures which contains NFONTS
2451 elements using qsort and comparison function CMPFN. F is the frame
2452 on which the fonts will be used. The global variable font_frame
2453 is temporarily set to F to make it available in CMPFN. */
2456 sort_fonts (f
, fonts
, nfonts
, cmpfn
)
2458 struct font_name
*fonts
;
2460 int (*cmpfn
) P_ ((const void *, const void *));
2463 qsort (fonts
, nfonts
, sizeof *fonts
, cmpfn
);
2468 /* Get fonts matching PATTERN on frame F. If F is null, use the first
2469 display in x_display_list. FONTS is a pointer to a vector of
2470 NFONTS font_name structures. TRY_ALTERNATIVES_P non-zero means try
2471 alternative patterns from Valternate_fontname_alist if no fonts are
2472 found matching PATTERN.
2474 For all fonts found, set FONTS[i].name to the name of the font,
2475 allocated via xmalloc, and split font names into fields. Ignore
2476 fonts that we can't parse. Value is the number of fonts found. */
2479 x_face_list_fonts (f
, pattern
, pfonts
, nfonts
, try_alternatives_p
)
2482 struct font_name
**pfonts
;
2483 int nfonts
, try_alternatives_p
;
2487 /* NTEMACS_TODO : currently this uses w32_list_fonts, but it may be
2488 better to do it the other way around. */
2490 Lisp_Object lpattern
, tem
;
2491 struct font_name
*fonts
= 0;
2492 int num_fonts
= nfonts
;
2495 lpattern
= build_string (pattern
);
2497 /* Get the list of fonts matching PATTERN. */
2500 lfonts
= w32_list_fonts (f
, lpattern
, 0, nfonts
);
2503 lfonts
= x_list_fonts (f
, lpattern
, -1, nfonts
);
2506 if (nfonts
< 0 && CONSP (lfonts
))
2507 num_fonts
= XFASTINT (Flength (lfonts
));
2509 /* Make a copy of the font names we got from X, and
2510 split them into fields. */
2512 for (tem
= lfonts
; CONSP (tem
) && n
< num_fonts
; tem
= XCDR (tem
))
2514 Lisp_Object elt
, tail
;
2515 const char *name
= SDATA (XCAR (tem
));
2517 /* Ignore fonts matching a pattern from face-ignored-fonts. */
2518 for (tail
= Vface_ignored_fonts
; CONSP (tail
); tail
= XCDR (tail
))
2522 && fast_c_string_match_ignore_case (elt
, name
) >= 0)
2533 *pfonts
= (struct font_name
*) xmalloc (num_fonts
* sizeof **pfonts
);
2537 /* Make a copy of the font name. */
2538 fonts
[n
].name
= xstrdup (name
);
2540 if (split_font_name (f
, fonts
+ n
, 1))
2542 if (font_scalable_p (fonts
+ n
)
2543 && !may_use_scalable_font_p (name
))
2546 xfree (fonts
[n
].name
);
2552 xfree (fonts
[n
].name
);
2555 /* If no fonts found, try patterns from Valternate_fontname_alist. */
2556 if (n
== 0 && try_alternatives_p
)
2558 Lisp_Object list
= Valternate_fontname_alist
;
2566 while (CONSP (list
))
2568 Lisp_Object entry
= XCAR (list
);
2570 && STRINGP (XCAR (entry
))
2571 && strcmp (SDATA (XCAR (entry
)), pattern
) == 0)
2578 Lisp_Object patterns
= XCAR (list
);
2581 while (CONSP (patterns
)
2582 /* If list is screwed up, give up. */
2583 && (name
= XCAR (patterns
),
2585 /* Ignore patterns equal to PATTERN because we tried that
2586 already with no success. */
2587 && (strcmp (SDATA (name
), pattern
) == 0
2588 || (n
= x_face_list_fonts (f
, SDATA (name
),
2591 patterns
= XCDR (patterns
);
2599 /* Check if a font matching pattern_offset_t on frame F is available
2600 or not. PATTERN may be a cons (FAMILY . REGISTRY), in which case,
2601 a font name pattern is generated from FAMILY and REGISTRY. */
2604 face_font_available_p (f
, pattern
)
2606 Lisp_Object pattern
;
2610 if (! STRINGP (pattern
))
2612 Lisp_Object family
, registry
;
2613 char *family_str
, *registry_str
, *pattern_str
;
2615 CHECK_CONS (pattern
);
2616 family
= XCAR (pattern
);
2621 CHECK_STRING (family
);
2622 family_str
= (char *) SDATA (family
);
2624 registry
= XCDR (pattern
);
2625 if (NILP (registry
))
2629 CHECK_STRING (registry
);
2630 registry_str
= (char *) SDATA (registry
);
2633 pattern_str
= (char *) alloca (strlen (family_str
)
2634 + strlen (registry_str
)
2636 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2637 strcat (pattern_str
, family_str
);
2638 strcat (pattern_str
, "-*-");
2639 strcat (pattern_str
, registry_str
);
2640 if (!index (registry_str
, '-'))
2642 if (registry_str
[strlen (registry_str
) - 1] == '*')
2643 strcat (pattern_str
, "-*");
2645 strcat (pattern_str
, "*-*");
2647 pattern
= build_string (pattern_str
);
2650 /* Get the list of fonts matching PATTERN. */
2653 fonts
= w32_list_fonts (f
, pattern
, 0, 1);
2656 fonts
= x_list_fonts (f
, pattern
, -1, 1);
2658 return XINT (Flength (fonts
));
2662 /* Determine fonts matching PATTERN on frame F. Sort resulting fonts
2663 using comparison function CMPFN. Value is the number of fonts
2664 found. If value is non-zero, *FONTS is set to a vector of
2665 font_name structures allocated from the heap containing matching
2666 fonts. Each element of *FONTS contains a name member that is also
2667 allocated from the heap. Font names in these structures are split
2668 into fields. Use free_font_names to free such an array. */
2671 sorted_font_list (f
, pattern
, cmpfn
, fonts
)
2674 int (*cmpfn
) P_ ((const void *, const void *));
2675 struct font_name
**fonts
;
2679 /* Get the list of fonts matching pattern. 100 should suffice. */
2680 nfonts
= DEFAULT_FONT_LIST_LIMIT
;
2681 if (INTEGERP (Vfont_list_limit
))
2682 nfonts
= XINT (Vfont_list_limit
);
2685 nfonts
= x_face_list_fonts (f
, pattern
, fonts
, nfonts
, 1);
2687 /* Sort the resulting array and return it in *FONTS. If no
2688 fonts were found, make sure to set *FONTS to null. */
2690 sort_fonts (f
, *fonts
, nfonts
, cmpfn
);
2701 /* Compare two font_name structures *A and *B. Value is analogous to
2702 strcmp. Sort order is given by the global variable
2703 font_sort_order. Font names are sorted so that, everything else
2704 being equal, fonts with a resolution closer to that of the frame on
2705 which they are used are listed first. The global variable
2706 font_frame is the frame on which we operate. */
2709 cmp_font_names (a
, b
)
2712 struct font_name
*x
= (struct font_name
*) a
;
2713 struct font_name
*y
= (struct font_name
*) b
;
2716 /* All strings have been converted to lower-case by split_font_name,
2717 so we can use strcmp here. */
2718 cmp
= strcmp (x
->fields
[XLFD_FAMILY
], y
->fields
[XLFD_FAMILY
]);
2723 for (i
= 0; i
< DIM (font_sort_order
) && cmp
== 0; ++i
)
2725 int j
= font_sort_order
[i
];
2726 cmp
= x
->numeric
[j
] - y
->numeric
[j
];
2731 /* Everything else being equal, we prefer fonts with an
2732 y-resolution closer to that of the frame. */
2733 int resy
= FRAME_X_DISPLAY_INFO (font_frame
)->resy
;
2734 int x_resy
= x
->numeric
[XLFD_RESY
];
2735 int y_resy
= y
->numeric
[XLFD_RESY
];
2736 cmp
= abs (resy
- x_resy
) - abs (resy
- y_resy
);
2744 /* Get a sorted list of fonts of family FAMILY on frame F. If PATTERN
2745 is non-nil list fonts matching that pattern. Otherwise, if
2746 REGISTRY is non-nil return only fonts with that registry, otherwise
2747 return fonts of any registry. Set *FONTS to a vector of font_name
2748 structures allocated from the heap containing the fonts found.
2749 Value is the number of fonts found. */
2752 font_list_1 (f
, pattern
, family
, registry
, fonts
)
2754 Lisp_Object pattern
, family
, registry
;
2755 struct font_name
**fonts
;
2757 char *pattern_str
, *family_str
, *registry_str
;
2761 family_str
= (NILP (family
) ? "*" : (char *) SDATA (family
));
2762 registry_str
= (NILP (registry
) ? "*" : (char *) SDATA (registry
));
2764 pattern_str
= (char *) alloca (strlen (family_str
)
2765 + strlen (registry_str
)
2767 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2768 strcat (pattern_str
, family_str
);
2769 strcat (pattern_str
, "-*-");
2770 strcat (pattern_str
, registry_str
);
2771 if (!index (registry_str
, '-'))
2773 if (registry_str
[strlen (registry_str
) - 1] == '*')
2774 strcat (pattern_str
, "-*");
2776 strcat (pattern_str
, "*-*");
2780 pattern_str
= (char *) SDATA (pattern
);
2782 return sorted_font_list (f
, pattern_str
, cmp_font_names
, fonts
);
2786 /* Concatenate font list FONTS1 and FONTS2. FONTS1 and FONTS2
2787 contains NFONTS1 fonts and NFONTS2 fonts respectively. Return a
2788 pointer to a newly allocated font list. FONTS1 and FONTS2 are
2791 static struct font_name
*
2792 concat_font_list (fonts1
, nfonts1
, fonts2
, nfonts2
)
2793 struct font_name
*fonts1
, *fonts2
;
2794 int nfonts1
, nfonts2
;
2796 int new_nfonts
= nfonts1
+ nfonts2
;
2797 struct font_name
*new_fonts
;
2799 new_fonts
= (struct font_name
*) xmalloc (sizeof *new_fonts
* new_nfonts
);
2800 bcopy (fonts1
, new_fonts
, sizeof *new_fonts
* nfonts1
);
2801 bcopy (fonts2
, new_fonts
+ nfonts1
, sizeof *new_fonts
* nfonts2
);
2808 /* Get a sorted list of fonts of family FAMILY on frame F.
2810 If PATTERN is non-nil list fonts matching that pattern.
2812 If REGISTRY is non-nil, return fonts with that registry and the
2813 alternative registries from Vface_alternative_font_registry_alist.
2815 If REGISTRY is nil return fonts of any registry.
2817 Set *FONTS to a vector of font_name structures allocated from the
2818 heap containing the fonts found. Value is the number of fonts
2822 font_list (f
, pattern
, family
, registry
, fonts
)
2824 Lisp_Object pattern
, family
, registry
;
2825 struct font_name
**fonts
;
2827 int nfonts
= font_list_1 (f
, pattern
, family
, registry
, fonts
);
2829 if (!NILP (registry
)
2830 && CONSP (Vface_alternative_font_registry_alist
))
2834 alter
= Fassoc (registry
, Vface_alternative_font_registry_alist
);
2839 for (alter
= XCDR (alter
), reg_prio
= 1;
2841 alter
= XCDR (alter
), reg_prio
++)
2842 if (STRINGP (XCAR (alter
)))
2845 struct font_name
*fonts2
;
2847 nfonts2
= font_list_1 (f
, pattern
, family
, XCAR (alter
),
2849 for (i
= 0; i
< nfonts2
; i
++)
2850 fonts2
[i
].registry_priority
= reg_prio
;
2851 *fonts
= (nfonts
> 0
2852 ? concat_font_list (*fonts
, nfonts
, fonts2
, nfonts2
)
2863 /* Remove elements from LIST whose cars are `equal'. Called from
2864 x-family-fonts and x-font-family-list to remove duplicate font
2868 remove_duplicates (list
)
2871 Lisp_Object tail
= list
;
2873 while (!NILP (tail
) && !NILP (XCDR (tail
)))
2875 Lisp_Object next
= XCDR (tail
);
2876 if (!NILP (Fequal (XCAR (next
), XCAR (tail
))))
2877 XSETCDR (tail
, XCDR (next
));
2884 DEFUN ("x-family-fonts", Fx_family_fonts
, Sx_family_fonts
, 0, 2, 0,
2885 doc
: /* Return a list of available fonts of family FAMILY on FRAME.
2886 If FAMILY is omitted or nil, list all families.
2887 Otherwise, FAMILY must be a string, possibly containing wildcards
2889 If FRAME is omitted or nil, use the selected frame.
2890 Each element of the result is a vector [FAMILY WIDTH POINT-SIZE WEIGHT
2891 SLANT FIXED-P FULL REGISTRY-AND-ENCODING].
2892 FAMILY is the font family name. POINT-SIZE is the size of the
2893 font in 1/10 pt. WIDTH, WEIGHT, and SLANT are symbols describing the
2894 width, weight and slant of the font. These symbols are the same as for
2895 face attributes. FIXED-P is non-nil if the font is fixed-pitch.
2896 FULL is the full name of the font, and REGISTRY-AND-ENCODING is a string
2897 giving the registry and encoding of the font.
2898 The result list is sorted according to the current setting of
2899 the face font sort order. */)
2901 Lisp_Object family
, frame
;
2903 struct frame
*f
= check_x_frame (frame
);
2904 struct font_name
*fonts
;
2907 struct gcpro gcpro1
;
2910 CHECK_STRING (family
);
2914 nfonts
= font_list (f
, Qnil
, family
, Qnil
, &fonts
);
2915 for (i
= nfonts
- 1; i
>= 0; --i
)
2917 Lisp_Object v
= Fmake_vector (make_number (8), Qnil
);
2920 ASET (v
, 0, build_string (fonts
[i
].fields
[XLFD_FAMILY
]));
2921 ASET (v
, 1, xlfd_symbolic_swidth (fonts
+ i
));
2922 ASET (v
, 2, make_number (xlfd_point_size (f
, fonts
+ i
)));
2923 ASET (v
, 3, xlfd_symbolic_weight (fonts
+ i
));
2924 ASET (v
, 4, xlfd_symbolic_slant (fonts
+ i
));
2925 ASET (v
, 5, xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
);
2926 tem
= build_font_name (fonts
+ i
);
2927 ASET (v
, 6, build_string (tem
));
2928 sprintf (tem
, "%s-%s", fonts
[i
].fields
[XLFD_REGISTRY
],
2929 fonts
[i
].fields
[XLFD_ENCODING
]);
2930 ASET (v
, 7, build_string (tem
));
2933 result
= Fcons (v
, result
);
2936 remove_duplicates (result
);
2937 free_font_names (fonts
, nfonts
);
2943 DEFUN ("x-font-family-list", Fx_font_family_list
, Sx_font_family_list
,
2945 doc
: /* Return a list of available font families on FRAME.
2946 If FRAME is omitted or nil, use the selected frame.
2947 Value is a list of conses (FAMILY . FIXED-P) where FAMILY
2948 is a font family, and FIXED-P is non-nil if fonts of that family
2949 are fixed-pitch. */)
2953 struct frame
*f
= check_x_frame (frame
);
2955 struct font_name
*fonts
;
2957 struct gcpro gcpro1
;
2958 int count
= SPECPDL_INDEX ();
2960 /* Let's consider all fonts. */
2961 specbind (intern ("font-list-limit"), make_number (-1));
2962 nfonts
= font_list (f
, Qnil
, Qnil
, Qnil
, &fonts
);
2966 for (i
= nfonts
- 1; i
>= 0; --i
)
2967 result
= Fcons (Fcons (build_string (fonts
[i
].fields
[XLFD_FAMILY
]),
2968 xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
),
2971 remove_duplicates (result
);
2972 free_font_names (fonts
, nfonts
);
2974 return unbind_to (count
, result
);
2978 DEFUN ("x-list-fonts", Fx_list_fonts
, Sx_list_fonts
, 1, 5, 0,
2979 doc
: /* Return a list of the names of available fonts matching PATTERN.
2980 If optional arguments FACE and FRAME are specified, return only fonts
2981 the same size as FACE on FRAME.
2982 PATTERN is a string, perhaps with wildcard characters;
2983 the * character matches any substring, and
2984 the ? character matches any single character.
2985 PATTERN is case-insensitive.
2986 FACE is a face name--a symbol.
2988 The return value is a list of strings, suitable as arguments to
2991 Fonts Emacs can't use may or may not be excluded
2992 even if they match PATTERN and FACE.
2993 The optional fourth argument MAXIMUM sets a limit on how many
2994 fonts to match. The first MAXIMUM fonts are reported.
2995 The optional fifth argument WIDTH, if specified, is a number of columns
2996 occupied by a character of a font. In that case, return only fonts
2997 the WIDTH times as wide as FACE on FRAME. */)
2998 (pattern
, face
, frame
, maximum
, width
)
2999 Lisp_Object pattern
, face
, frame
, maximum
, width
;
3006 CHECK_STRING (pattern
);
3012 CHECK_NATNUM (maximum
);
3013 maxnames
= XINT (maximum
);
3017 CHECK_NUMBER (width
);
3019 /* We can't simply call check_x_frame because this function may be
3020 called before any frame is created. */
3021 f
= frame_or_selected_frame (frame
, 2);
3022 if (!FRAME_WINDOW_P (f
))
3024 /* Perhaps we have not yet created any frame. */
3029 /* Determine the width standard for comparison with the fonts we find. */
3035 /* This is of limited utility since it works with character
3036 widths. Keep it for compatibility. --gerd. */
3037 int face_id
= lookup_named_face (f
, face
, 0, 0);
3038 struct face
*face
= (face_id
< 0
3040 : FACE_FROM_ID (f
, face_id
));
3043 /* For historic reasons, FONT_WIDTH refers to average width on W32,
3044 not maximum as on X. Redefine here. */
3046 #define FONT_WIDTH FONT_MAX_WIDTH
3049 if (face
&& face
->font
)
3050 size
= FONT_WIDTH (face
->font
);
3052 size
= FONT_WIDTH (FRAME_FONT (f
)); /* FRAME_COLUMN_WIDTH (f) */
3055 size
*= XINT (width
);
3059 Lisp_Object args
[2];
3061 args
[0] = x_list_fonts (f
, pattern
, size
, maxnames
);
3063 /* We don't have to check fontsets. */
3065 args
[1] = list_fontsets (f
, pattern
, size
);
3066 return Fnconc (2, args
);
3070 #endif /* HAVE_WINDOW_SYSTEM */
3074 /***********************************************************************
3076 ***********************************************************************/
3078 /* Access face attributes of face LFACE, a Lisp vector. */
3080 #define LFACE_FAMILY(LFACE) AREF ((LFACE), LFACE_FAMILY_INDEX)
3081 #define LFACE_HEIGHT(LFACE) AREF ((LFACE), LFACE_HEIGHT_INDEX)
3082 #define LFACE_WEIGHT(LFACE) AREF ((LFACE), LFACE_WEIGHT_INDEX)
3083 #define LFACE_SLANT(LFACE) AREF ((LFACE), LFACE_SLANT_INDEX)
3084 #define LFACE_UNDERLINE(LFACE) AREF ((LFACE), LFACE_UNDERLINE_INDEX)
3085 #define LFACE_INVERSE(LFACE) AREF ((LFACE), LFACE_INVERSE_INDEX)
3086 #define LFACE_FOREGROUND(LFACE) AREF ((LFACE), LFACE_FOREGROUND_INDEX)
3087 #define LFACE_BACKGROUND(LFACE) AREF ((LFACE), LFACE_BACKGROUND_INDEX)
3088 #define LFACE_STIPPLE(LFACE) AREF ((LFACE), LFACE_STIPPLE_INDEX)
3089 #define LFACE_SWIDTH(LFACE) AREF ((LFACE), LFACE_SWIDTH_INDEX)
3090 #define LFACE_OVERLINE(LFACE) AREF ((LFACE), LFACE_OVERLINE_INDEX)
3091 #define LFACE_STRIKE_THROUGH(LFACE) AREF ((LFACE), LFACE_STRIKE_THROUGH_INDEX)
3092 #define LFACE_BOX(LFACE) AREF ((LFACE), LFACE_BOX_INDEX)
3093 #define LFACE_FONT(LFACE) AREF ((LFACE), LFACE_FONT_INDEX)
3094 #define LFACE_INHERIT(LFACE) AREF ((LFACE), LFACE_INHERIT_INDEX)
3095 #define LFACE_AVGWIDTH(LFACE) AREF ((LFACE), LFACE_AVGWIDTH_INDEX)
3097 /* Non-zero if LFACE is a Lisp face. A Lisp face is a vector of size
3098 LFACE_VECTOR_SIZE which has the symbol `face' in slot 0. */
3100 #define LFACEP(LFACE) \
3102 && XVECTOR (LFACE)->size == LFACE_VECTOR_SIZE \
3103 && EQ (AREF (LFACE, 0), Qface))
3108 /* Check consistency of Lisp face attribute vector ATTRS. */
3111 check_lface_attrs (attrs
)
3114 xassert (UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
3115 || IGNORE_DEFFACE_P (attrs
[LFACE_FAMILY_INDEX
])
3116 || STRINGP (attrs
[LFACE_FAMILY_INDEX
]));
3117 xassert (UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
3118 || IGNORE_DEFFACE_P (attrs
[LFACE_SWIDTH_INDEX
])
3119 || SYMBOLP (attrs
[LFACE_SWIDTH_INDEX
]));
3120 xassert (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
3121 || IGNORE_DEFFACE_P (attrs
[LFACE_AVGWIDTH_INDEX
])
3122 || INTEGERP (attrs
[LFACE_AVGWIDTH_INDEX
]));
3123 xassert (UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
3124 || IGNORE_DEFFACE_P (attrs
[LFACE_HEIGHT_INDEX
])
3125 || INTEGERP (attrs
[LFACE_HEIGHT_INDEX
])
3126 || FLOATP (attrs
[LFACE_HEIGHT_INDEX
])
3127 || FUNCTIONP (attrs
[LFACE_HEIGHT_INDEX
]));
3128 xassert (UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
3129 || IGNORE_DEFFACE_P (attrs
[LFACE_WEIGHT_INDEX
])
3130 || SYMBOLP (attrs
[LFACE_WEIGHT_INDEX
]));
3131 xassert (UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
3132 || IGNORE_DEFFACE_P (attrs
[LFACE_SLANT_INDEX
])
3133 || SYMBOLP (attrs
[LFACE_SLANT_INDEX
]));
3134 xassert (UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
3135 || IGNORE_DEFFACE_P (attrs
[LFACE_UNDERLINE_INDEX
])
3136 || SYMBOLP (attrs
[LFACE_UNDERLINE_INDEX
])
3137 || STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]));
3138 xassert (UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
3139 || IGNORE_DEFFACE_P (attrs
[LFACE_OVERLINE_INDEX
])
3140 || SYMBOLP (attrs
[LFACE_OVERLINE_INDEX
])
3141 || STRINGP (attrs
[LFACE_OVERLINE_INDEX
]));
3142 xassert (UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3143 || IGNORE_DEFFACE_P (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3144 || SYMBOLP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3145 || STRINGP (attrs
[LFACE_STRIKE_THROUGH_INDEX
]));
3146 xassert (UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
3147 || IGNORE_DEFFACE_P (attrs
[LFACE_BOX_INDEX
])
3148 || SYMBOLP (attrs
[LFACE_BOX_INDEX
])
3149 || STRINGP (attrs
[LFACE_BOX_INDEX
])
3150 || INTEGERP (attrs
[LFACE_BOX_INDEX
])
3151 || CONSP (attrs
[LFACE_BOX_INDEX
]));
3152 xassert (UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
3153 || IGNORE_DEFFACE_P (attrs
[LFACE_INVERSE_INDEX
])
3154 || SYMBOLP (attrs
[LFACE_INVERSE_INDEX
]));
3155 xassert (UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
3156 || IGNORE_DEFFACE_P (attrs
[LFACE_FOREGROUND_INDEX
])
3157 || STRINGP (attrs
[LFACE_FOREGROUND_INDEX
]));
3158 xassert (UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
3159 || IGNORE_DEFFACE_P (attrs
[LFACE_BACKGROUND_INDEX
])
3160 || STRINGP (attrs
[LFACE_BACKGROUND_INDEX
]));
3161 xassert (UNSPECIFIEDP (attrs
[LFACE_INHERIT_INDEX
])
3162 || IGNORE_DEFFACE_P (attrs
[LFACE_INHERIT_INDEX
])
3163 || NILP (attrs
[LFACE_INHERIT_INDEX
])
3164 || SYMBOLP (attrs
[LFACE_INHERIT_INDEX
])
3165 || CONSP (attrs
[LFACE_INHERIT_INDEX
]));
3166 #ifdef HAVE_WINDOW_SYSTEM
3167 xassert (UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
3168 || IGNORE_DEFFACE_P (attrs
[LFACE_STIPPLE_INDEX
])
3169 || SYMBOLP (attrs
[LFACE_STIPPLE_INDEX
])
3170 || !NILP (Fbitmap_spec_p (attrs
[LFACE_STIPPLE_INDEX
])));
3171 xassert (UNSPECIFIEDP (attrs
[LFACE_FONT_INDEX
])
3172 || IGNORE_DEFFACE_P (attrs
[LFACE_FONT_INDEX
])
3173 || NILP (attrs
[LFACE_FONT_INDEX
])
3174 || STRINGP (attrs
[LFACE_FONT_INDEX
]));
3179 /* Check consistency of attributes of Lisp face LFACE (a Lisp vector). */
3187 xassert (LFACEP (lface
));
3188 check_lface_attrs (XVECTOR (lface
)->contents
);
3192 #else /* GLYPH_DEBUG == 0 */
3194 #define check_lface_attrs(attrs) (void) 0
3195 #define check_lface(lface) (void) 0
3197 #endif /* GLYPH_DEBUG == 0 */
3201 /* Face-merge cycle checking. */
3203 /* A `named merge point' is simply a point during face-merging where we
3204 look up a face by name. We keep a stack of which named lookups we're
3205 currently processing so that we can easily detect cycles, using a
3206 linked- list of struct named_merge_point structures, typically
3207 allocated on the stack frame of the named lookup functions which are
3208 active (so no consing is required). */
3209 struct named_merge_point
3211 Lisp_Object face_name
;
3212 struct named_merge_point
*prev
;
3216 /* If a face merging cycle is detected for FACE_NAME, return 0,
3217 otherwise add NEW_NAMED_MERGE_POINT, which is initialized using
3218 FACE_NAME, as the head of the linked list pointed to by
3219 NAMED_MERGE_POINTS, and return 1. */
3222 push_named_merge_point (struct named_merge_point
*new_named_merge_point
,
3223 Lisp_Object face_name
,
3224 struct named_merge_point
**named_merge_points
)
3226 struct named_merge_point
*prev
;
3228 for (prev
= *named_merge_points
; prev
; prev
= prev
->prev
)
3229 if (EQ (face_name
, prev
->face_name
))
3232 new_named_merge_point
->face_name
= face_name
;
3233 new_named_merge_point
->prev
= *named_merge_points
;
3235 *named_merge_points
= new_named_merge_point
;
3243 internal_resolve_face_name (nargs
, args
)
3247 Fget (args
[0], args
[1]);
3251 resolve_face_name_error (ignore
)
3257 /* Resolve face name FACE_NAME. If FACE_NAME is a string, intern it
3258 to make it a symbol. If FACE_NAME is an alias for another face,
3259 return that face's name.
3261 Return default face in case of errors. */
3264 resolve_face_name (face_name
, signal_p
)
3265 Lisp_Object face_name
;
3268 Lisp_Object orig_face
;
3269 Lisp_Object tortoise
, hare
;
3271 if (STRINGP (face_name
))
3272 face_name
= intern (SDATA (face_name
));
3274 if (NILP (face_name
) || !SYMBOLP (face_name
))
3277 orig_face
= face_name
;
3278 tortoise
= hare
= face_name
;
3283 hare
= Fget (hare
, Qface_alias
);
3284 if (NILP (hare
) || !SYMBOLP (hare
))
3288 hare
= Fget (hare
, Qface_alias
);
3289 if (NILP (hare
) || !SYMBOLP (hare
))
3292 tortoise
= Fget (tortoise
, Qface_alias
);
3293 if (EQ (hare
, tortoise
))
3296 Fsignal (Qcircular_list
, Fcons (orig_face
, Qnil
));
3305 /* Return the face definition of FACE_NAME on frame F. F null means
3306 return the definition for new frames. FACE_NAME may be a string or
3307 a symbol (apparently Emacs 20.2 allowed strings as face names in
3308 face text properties; Ediff uses that). If FACE_NAME is an alias
3309 for another face, return that face's definition. If SIGNAL_P is
3310 non-zero, signal an error if FACE_NAME is not a valid face name.
3311 If SIGNAL_P is zero, value is nil if FACE_NAME is not a valid face
3314 static INLINE Lisp_Object
3315 lface_from_face_name (f
, face_name
, signal_p
)
3317 Lisp_Object face_name
;
3322 face_name
= resolve_face_name (face_name
, signal_p
);
3325 lface
= assq_no_quit (face_name
, f
->face_alist
);
3327 lface
= assq_no_quit (face_name
, Vface_new_frame_defaults
);
3330 lface
= XCDR (lface
);
3332 signal_error ("Invalid face", face_name
);
3334 check_lface (lface
);
3339 /* Get face attributes of face FACE_NAME from frame-local faces on
3340 frame F. Store the resulting attributes in ATTRS which must point
3341 to a vector of Lisp_Objects of size LFACE_VECTOR_SIZE. If SIGNAL_P
3342 is non-zero, signal an error if FACE_NAME does not name a face.
3343 Otherwise, value is zero if FACE_NAME is not a face. */
3346 get_lface_attributes (f
, face_name
, attrs
, signal_p
)
3348 Lisp_Object face_name
;
3355 lface
= lface_from_face_name (f
, face_name
, signal_p
);
3358 bcopy (XVECTOR (lface
)->contents
, attrs
,
3359 LFACE_VECTOR_SIZE
* sizeof *attrs
);
3369 /* Non-zero if all attributes in face attribute vector ATTRS are
3370 specified, i.e. are non-nil. */
3373 lface_fully_specified_p (attrs
)
3378 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3379 if (i
!= LFACE_FONT_INDEX
&& i
!= LFACE_INHERIT_INDEX
3380 && i
!= LFACE_AVGWIDTH_INDEX
)
3381 if ((UNSPECIFIEDP (attrs
[i
]) || IGNORE_DEFFACE_P (attrs
[i
]))
3383 /* MAC_TODO: No stipple support on Mac OS yet, this index is
3384 always unspecified. */
3385 && i
!= LFACE_STIPPLE_INDEX
3390 return i
== LFACE_VECTOR_SIZE
;
3393 #ifdef HAVE_WINDOW_SYSTEM
3395 /* Set font-related attributes of Lisp face LFACE from the fullname of
3396 the font opened by FONTNAME. If FORCE_P is zero, set only
3397 unspecified attributes of LFACE. The exception is `font'
3398 attribute. It is set to FONTNAME as is regardless of FORCE_P.
3400 If FONTNAME is not available on frame F,
3401 return 0 if MAY_FAIL_P is non-zero, otherwise abort.
3402 If the fullname is not in a valid XLFD format,
3403 return 0 if MAY_FAIL_P is non-zero, otherwise set normal values
3404 in LFACE and return 1.
3405 Otherwise, return 1. */
3408 set_lface_from_font_name (f
, lface
, fontname
, force_p
, may_fail_p
)
3411 Lisp_Object fontname
;
3412 int force_p
, may_fail_p
;
3414 struct font_name font
;
3419 char *font_name
= SDATA (fontname
);
3420 struct font_info
*font_info
;
3422 /* If FONTNAME is actually a fontset name, get ASCII font name of it. */
3423 fontset
= fs_query_fontset (fontname
, 0);
3425 font_name
= SDATA (fontset_ascii (fontset
));
3427 /* Check if FONT_NAME is surely available on the system. Usually
3428 FONT_NAME is already cached for the frame F and FS_LOAD_FONT
3429 returns quickly. But, even if FONT_NAME is not yet cached,
3430 caching it now is not futail because we anyway load the font
3433 font_info
= FS_LOAD_FONT (f
, 0, font_name
, -1);
3443 font
.name
= STRDUPA (font_info
->full_name
);
3444 have_xlfd_p
= split_font_name (f
, &font
, 1);
3446 /* Set attributes only if unspecified, otherwise face defaults for
3447 new frames would never take effect. If we couldn't get a font
3448 name conforming to XLFD, set normal values. */
3450 if (force_p
|| UNSPECIFIEDP (LFACE_FAMILY (lface
)))
3455 buffer
= (char *) alloca (strlen (font
.fields
[XLFD_FAMILY
])
3456 + strlen (font
.fields
[XLFD_FOUNDRY
])
3458 sprintf (buffer
, "%s-%s", font
.fields
[XLFD_FOUNDRY
],
3459 font
.fields
[XLFD_FAMILY
]);
3460 val
= build_string (buffer
);
3463 val
= build_string ("*");
3464 LFACE_FAMILY (lface
) = val
;
3467 if (force_p
|| UNSPECIFIEDP (LFACE_HEIGHT (lface
)))
3470 pt
= xlfd_point_size (f
, &font
);
3472 pt
= pixel_point_size (f
, font_info
->height
* 10);
3474 LFACE_HEIGHT (lface
) = make_number (pt
);
3477 if (force_p
|| UNSPECIFIEDP (LFACE_SWIDTH (lface
)))
3478 LFACE_SWIDTH (lface
)
3479 = have_xlfd_p
? xlfd_symbolic_swidth (&font
) : Qnormal
;
3481 if (force_p
|| UNSPECIFIEDP (LFACE_AVGWIDTH (lface
)))
3482 LFACE_AVGWIDTH (lface
)
3484 ? make_number (font
.numeric
[XLFD_AVGWIDTH
])
3487 if (force_p
|| UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
3488 LFACE_WEIGHT (lface
)
3489 = have_xlfd_p
? xlfd_symbolic_weight (&font
) : Qnormal
;
3491 if (force_p
|| UNSPECIFIEDP (LFACE_SLANT (lface
)))
3493 = have_xlfd_p
? xlfd_symbolic_slant (&font
) : Qnormal
;
3495 LFACE_FONT (lface
) = fontname
;
3500 #endif /* HAVE_WINDOW_SYSTEM */
3503 /* Merges the face height FROM with the face height TO, and returns the
3504 merged height. If FROM is an invalid height, then INVALID is
3505 returned instead. FROM and TO may be either absolute face heights or
3506 `relative' heights; the returned value is always an absolute height
3507 unless both FROM and TO are relative. GCPRO is a lisp value that
3508 will be protected from garbage-collection if this function makes a
3512 merge_face_heights (from
, to
, invalid
)
3513 Lisp_Object from
, to
, invalid
;
3515 Lisp_Object result
= invalid
;
3517 if (INTEGERP (from
))
3518 /* FROM is absolute, just use it as is. */
3520 else if (FLOATP (from
))
3521 /* FROM is a scale, use it to adjust TO. */
3524 /* relative X absolute => absolute */
3525 result
= make_number ((EMACS_INT
)(XFLOAT_DATA (from
) * XINT (to
)));
3526 else if (FLOATP (to
))
3527 /* relative X relative => relative */
3528 result
= make_float (XFLOAT_DATA (from
) * XFLOAT_DATA (to
));
3529 else if (UNSPECIFIEDP (to
))
3532 else if (FUNCTIONP (from
))
3533 /* FROM is a function, which use to adjust TO. */
3535 /* Call function with current height as argument.
3536 From is the new height. */
3537 Lisp_Object args
[2];
3541 result
= safe_call (2, args
);
3543 /* Ensure that if TO was absolute, so is the result. */
3544 if (INTEGERP (to
) && !INTEGERP (result
))
3552 /* Merge two Lisp face attribute vectors on frame F, FROM and TO, and
3553 store the resulting attributes in TO, which must be already be
3554 completely specified and contain only absolute attributes. Every
3555 specified attribute of FROM overrides the corresponding attribute of
3556 TO; relative attributes in FROM are merged with the absolute value in
3557 TO and replace it. NAMED_MERGE_POINTS is used internally to detect
3558 loops in face inheritance; it should be 0 when called from other
3562 merge_face_vectors (f
, from
, to
, named_merge_points
)
3564 Lisp_Object
*from
, *to
;
3565 struct named_merge_point
*named_merge_points
;
3569 /* If FROM inherits from some other faces, merge their attributes into
3570 TO before merging FROM's direct attributes. Note that an :inherit
3571 attribute of `unspecified' is the same as one of nil; we never
3572 merge :inherit attributes, so nil is more correct, but lots of
3573 other code uses `unspecified' as a generic value for face attributes. */
3574 if (!UNSPECIFIEDP (from
[LFACE_INHERIT_INDEX
])
3575 && !NILP (from
[LFACE_INHERIT_INDEX
]))
3576 merge_face_ref (f
, from
[LFACE_INHERIT_INDEX
], to
, 0, named_merge_points
);
3578 /* If TO specifies a :font attribute, and FROM specifies some
3579 font-related attribute, we need to clear TO's :font attribute
3580 (because it will be inconsistent with whatever FROM specifies, and
3581 FROM takes precedence). */
3582 if (!NILP (to
[LFACE_FONT_INDEX
])
3583 && (!UNSPECIFIEDP (from
[LFACE_FAMILY_INDEX
])
3584 || !UNSPECIFIEDP (from
[LFACE_HEIGHT_INDEX
])
3585 || !UNSPECIFIEDP (from
[LFACE_WEIGHT_INDEX
])
3586 || !UNSPECIFIEDP (from
[LFACE_SLANT_INDEX
])
3587 || !UNSPECIFIEDP (from
[LFACE_SWIDTH_INDEX
])
3588 || !UNSPECIFIEDP (from
[LFACE_AVGWIDTH_INDEX
])))
3589 to
[LFACE_FONT_INDEX
] = Qnil
;
3591 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3592 if (!UNSPECIFIEDP (from
[i
]))
3594 if (i
== LFACE_HEIGHT_INDEX
&& !INTEGERP (from
[i
]))
3595 to
[i
] = merge_face_heights (from
[i
], to
[i
], to
[i
]);
3600 /* TO is always an absolute face, which should inherit from nothing.
3601 We blindly copy the :inherit attribute above and fix it up here. */
3602 to
[LFACE_INHERIT_INDEX
] = Qnil
;
3605 /* Merge the named face FACE_NAME on frame F, into the vector of face
3606 attributes TO. NAMED_MERGE_POINTS is used to detect loops in face
3607 inheritance. Returns true if FACE_NAME is a valid face name and
3608 merging succeeded. */
3611 merge_named_face (f
, face_name
, to
, named_merge_points
)
3613 Lisp_Object face_name
;
3615 struct named_merge_point
*named_merge_points
;
3617 struct named_merge_point named_merge_point
;
3619 if (push_named_merge_point (&named_merge_point
,
3620 face_name
, &named_merge_points
))
3622 struct gcpro gcpro1
;
3623 Lisp_Object from
[LFACE_VECTOR_SIZE
];
3624 int ok
= get_lface_attributes (f
, face_name
, from
, 0);
3628 GCPRO1 (named_merge_point
.face_name
);
3629 merge_face_vectors (f
, from
, to
, named_merge_points
);
3640 /* Merge face attributes from the lisp `face reference' FACE_REF on
3641 frame F into the face attribute vector TO. If ERR_MSGS is non-zero,
3642 problems with FACE_REF cause an error message to be shown. Return
3643 non-zero if no errors occurred (regardless of the value of ERR_MSGS).
3644 NAMED_MERGE_POINTS is used to detect loops in face inheritance or
3645 list structure; it may be 0 for most callers.
3647 FACE_REF may be a single face specification or a list of such
3648 specifications. Each face specification can be:
3650 1. A symbol or string naming a Lisp face.
3652 2. A property list of the form (KEYWORD VALUE ...) where each
3653 KEYWORD is a face attribute name, and value is an appropriate value
3656 3. Conses or the form (FOREGROUND-COLOR . COLOR) or
3657 (BACKGROUND-COLOR . COLOR) where COLOR is a color name. This is
3658 for compatibility with 20.2.
3660 Face specifications earlier in lists take precedence over later
3664 merge_face_ref (f
, face_ref
, to
, err_msgs
, named_merge_points
)
3666 Lisp_Object face_ref
;
3669 struct named_merge_point
*named_merge_points
;
3671 int ok
= 1; /* Succeed without an error? */
3673 if (CONSP (face_ref
))
3675 Lisp_Object first
= XCAR (face_ref
);
3677 if (EQ (first
, Qforeground_color
)
3678 || EQ (first
, Qbackground_color
))
3680 /* One of (FOREGROUND-COLOR . COLOR) or (BACKGROUND-COLOR
3681 . COLOR). COLOR must be a string. */
3682 Lisp_Object color_name
= XCDR (face_ref
);
3683 Lisp_Object color
= first
;
3685 if (STRINGP (color_name
))
3687 if (EQ (color
, Qforeground_color
))
3688 to
[LFACE_FOREGROUND_INDEX
] = color_name
;
3690 to
[LFACE_BACKGROUND_INDEX
] = color_name
;
3695 add_to_log ("Invalid face color", color_name
, Qnil
);
3699 else if (SYMBOLP (first
)
3700 && *SDATA (SYMBOL_NAME (first
)) == ':')
3702 /* Assume this is the property list form. */
3703 while (CONSP (face_ref
) && CONSP (XCDR (face_ref
)))
3705 Lisp_Object keyword
= XCAR (face_ref
);
3706 Lisp_Object value
= XCAR (XCDR (face_ref
));
3709 /* Specifying `unspecified' is a no-op. */
3710 if (EQ (value
, Qunspecified
))
3712 else if (EQ (keyword
, QCfamily
))
3714 if (STRINGP (value
))
3715 to
[LFACE_FAMILY_INDEX
] = value
;
3719 else if (EQ (keyword
, QCheight
))
3721 Lisp_Object new_height
=
3722 merge_face_heights (value
, to
[LFACE_HEIGHT_INDEX
], Qnil
);
3724 if (! NILP (new_height
))
3725 to
[LFACE_HEIGHT_INDEX
] = new_height
;
3729 else if (EQ (keyword
, QCweight
))
3732 && face_numeric_weight (value
) >= 0)
3733 to
[LFACE_WEIGHT_INDEX
] = value
;
3737 else if (EQ (keyword
, QCslant
))
3740 && face_numeric_slant (value
) >= 0)
3741 to
[LFACE_SLANT_INDEX
] = value
;
3745 else if (EQ (keyword
, QCunderline
))
3750 to
[LFACE_UNDERLINE_INDEX
] = value
;
3754 else if (EQ (keyword
, QCoverline
))
3759 to
[LFACE_OVERLINE_INDEX
] = value
;
3763 else if (EQ (keyword
, QCstrike_through
))
3768 to
[LFACE_STRIKE_THROUGH_INDEX
] = value
;
3772 else if (EQ (keyword
, QCbox
))
3775 value
= make_number (1);
3776 if (INTEGERP (value
)
3780 to
[LFACE_BOX_INDEX
] = value
;
3784 else if (EQ (keyword
, QCinverse_video
)
3785 || EQ (keyword
, QCreverse_video
))
3787 if (EQ (value
, Qt
) || NILP (value
))
3788 to
[LFACE_INVERSE_INDEX
] = value
;
3792 else if (EQ (keyword
, QCforeground
))
3794 if (STRINGP (value
))
3795 to
[LFACE_FOREGROUND_INDEX
] = value
;
3799 else if (EQ (keyword
, QCbackground
))
3801 if (STRINGP (value
))
3802 to
[LFACE_BACKGROUND_INDEX
] = value
;
3806 else if (EQ (keyword
, QCstipple
))
3808 #ifdef HAVE_X_WINDOWS
3809 Lisp_Object pixmap_p
= Fbitmap_spec_p (value
);
3810 if (!NILP (pixmap_p
))
3811 to
[LFACE_STIPPLE_INDEX
] = value
;
3816 else if (EQ (keyword
, QCwidth
))
3819 && face_numeric_swidth (value
) >= 0)
3820 to
[LFACE_SWIDTH_INDEX
] = value
;
3824 else if (EQ (keyword
, QCinherit
))
3826 /* This is not really very useful; it's just like a
3827 normal face reference. */
3828 if (! merge_face_ref (f
, value
, to
,
3829 err_msgs
, named_merge_points
))
3837 add_to_log ("Invalid face attribute %S %S", keyword
, value
);
3841 face_ref
= XCDR (XCDR (face_ref
));
3846 /* This is a list of face refs. Those at the beginning of the
3847 list take precedence over what follows, so we have to merge
3848 from the end backwards. */
3849 Lisp_Object next
= XCDR (face_ref
);
3852 ok
= merge_face_ref (f
, next
, to
, err_msgs
, named_merge_points
);
3854 if (! merge_face_ref (f
, first
, to
, err_msgs
, named_merge_points
))
3860 /* FACE_REF ought to be a face name. */
3861 ok
= merge_named_face (f
, face_ref
, to
, named_merge_points
);
3862 if (!ok
&& err_msgs
)
3863 add_to_log ("Invalid face reference: %s", face_ref
, Qnil
);
3870 DEFUN ("internal-make-lisp-face", Finternal_make_lisp_face
,
3871 Sinternal_make_lisp_face
, 1, 2, 0,
3872 doc
: /* Make FACE, a symbol, a Lisp face with all attributes nil.
3873 If FACE was not known as a face before, create a new one.
3874 If optional argument FRAME is specified, make a frame-local face
3875 for that frame. Otherwise operate on the global face definition.
3876 Value is a vector of face attributes. */)
3878 Lisp_Object face
, frame
;
3880 Lisp_Object global_lface
, lface
;
3884 CHECK_SYMBOL (face
);
3885 global_lface
= lface_from_face_name (NULL
, face
, 0);
3889 CHECK_LIVE_FRAME (frame
);
3891 lface
= lface_from_face_name (f
, face
, 0);
3894 f
= NULL
, lface
= Qnil
;
3896 /* Add a global definition if there is none. */
3897 if (NILP (global_lface
))
3899 global_lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
3901 AREF (global_lface
, 0) = Qface
;
3902 Vface_new_frame_defaults
= Fcons (Fcons (face
, global_lface
),
3903 Vface_new_frame_defaults
);
3905 /* Assign the new Lisp face a unique ID. The mapping from Lisp
3906 face id to Lisp face is given by the vector lface_id_to_name.
3907 The mapping from Lisp face to Lisp face id is given by the
3908 property `face' of the Lisp face name. */
3909 if (next_lface_id
== lface_id_to_name_size
)
3911 int new_size
= max (50, 2 * lface_id_to_name_size
);
3912 int sz
= new_size
* sizeof *lface_id_to_name
;
3913 lface_id_to_name
= (Lisp_Object
*) xrealloc (lface_id_to_name
, sz
);
3914 lface_id_to_name_size
= new_size
;
3917 lface_id_to_name
[next_lface_id
] = face
;
3918 Fput (face
, Qface
, make_number (next_lface_id
));
3922 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3923 AREF (global_lface
, i
) = Qunspecified
;
3925 /* Add a frame-local definition. */
3930 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
3932 AREF (lface
, 0) = Qface
;
3933 f
->face_alist
= Fcons (Fcons (face
, lface
), f
->face_alist
);
3936 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3937 AREF (lface
, i
) = Qunspecified
;
3940 lface
= global_lface
;
3942 /* Changing a named face means that all realized faces depending on
3943 that face are invalid. Since we cannot tell which realized faces
3944 depend on the face, make sure they are all removed. This is done
3945 by incrementing face_change_count. The next call to
3946 init_iterator will then free realized faces. */
3947 if (NILP (Fget (face
, Qface_no_inherit
)))
3949 ++face_change_count
;
3950 ++windows_or_buffers_changed
;
3953 xassert (LFACEP (lface
));
3954 check_lface (lface
);
3959 DEFUN ("internal-lisp-face-p", Finternal_lisp_face_p
,
3960 Sinternal_lisp_face_p
, 1, 2, 0,
3961 doc
: /* Return non-nil if FACE names a face.
3962 If optional second argument FRAME is non-nil, check for the
3963 existence of a frame-local face with name FACE on that frame.
3964 Otherwise check for the existence of a global face. */)
3966 Lisp_Object face
, frame
;
3972 CHECK_LIVE_FRAME (frame
);
3973 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
3976 lface
= lface_from_face_name (NULL
, face
, 0);
3982 DEFUN ("internal-copy-lisp-face", Finternal_copy_lisp_face
,
3983 Sinternal_copy_lisp_face
, 4, 4, 0,
3984 doc
: /* Copy face FROM to TO.
3985 If FRAME is t, copy the global face definition of FROM.
3986 Otherwise, copy the frame-local definition of FROM on FRAME.
3987 If NEW-FRAME is a frame, copy that data into the frame-local
3988 definition of TO on NEW-FRAME. If NEW-FRAME is nil.
3989 FRAME controls where the data is copied to.
3991 The value is TO. */)
3992 (from
, to
, frame
, new_frame
)
3993 Lisp_Object from
, to
, frame
, new_frame
;
3995 Lisp_Object lface
, copy
;
3997 CHECK_SYMBOL (from
);
4002 /* Copy global definition of FROM. We don't make copies of
4003 strings etc. because 20.2 didn't do it either. */
4004 lface
= lface_from_face_name (NULL
, from
, 1);
4005 copy
= Finternal_make_lisp_face (to
, Qnil
);
4009 /* Copy frame-local definition of FROM. */
4010 if (NILP (new_frame
))
4012 CHECK_LIVE_FRAME (frame
);
4013 CHECK_LIVE_FRAME (new_frame
);
4014 lface
= lface_from_face_name (XFRAME (frame
), from
, 1);
4015 copy
= Finternal_make_lisp_face (to
, new_frame
);
4018 bcopy (XVECTOR (lface
)->contents
, XVECTOR (copy
)->contents
,
4019 LFACE_VECTOR_SIZE
* sizeof (Lisp_Object
));
4021 /* Changing a named face means that all realized faces depending on
4022 that face are invalid. Since we cannot tell which realized faces
4023 depend on the face, make sure they are all removed. This is done
4024 by incrementing face_change_count. The next call to
4025 init_iterator will then free realized faces. */
4026 if (NILP (Fget (to
, Qface_no_inherit
)))
4028 ++face_change_count
;
4029 ++windows_or_buffers_changed
;
4036 DEFUN ("internal-set-lisp-face-attribute", Finternal_set_lisp_face_attribute
,
4037 Sinternal_set_lisp_face_attribute
, 3, 4, 0,
4038 doc
: /* Set attribute ATTR of FACE to VALUE.
4039 FRAME being a frame means change the face on that frame.
4040 FRAME nil means change the face of the selected frame.
4041 FRAME t means change the default for new frames.
4042 FRAME 0 means change the face on all frames, and change the default
4044 (face
, attr
, value
, frame
)
4045 Lisp_Object face
, attr
, value
, frame
;
4048 Lisp_Object old_value
= Qnil
;
4049 /* Set 1 if ATTR is QCfont. */
4050 int font_attr_p
= 0;
4051 /* Set 1 if ATTR is one of font-related attributes other than QCfont. */
4052 int font_related_attr_p
= 0;
4054 CHECK_SYMBOL (face
);
4055 CHECK_SYMBOL (attr
);
4057 face
= resolve_face_name (face
, 1);
4059 /* If FRAME is 0, change face on all frames, and change the
4060 default for new frames. */
4061 if (INTEGERP (frame
) && XINT (frame
) == 0)
4064 Finternal_set_lisp_face_attribute (face
, attr
, value
, Qt
);
4065 FOR_EACH_FRAME (tail
, frame
)
4066 Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
4070 /* Set lface to the Lisp attribute vector of FACE. */
4073 lface
= lface_from_face_name (NULL
, face
, 1);
4075 /* When updating face-new-frame-defaults, we put :ignore-defface
4076 where the caller wants `unspecified'. This forces the frame
4077 defaults to ignore the defface value. Otherwise, the defface
4078 will take effect, which is generally not what is intended.
4079 The value of that attribute will be inherited from some other
4080 face during face merging. See internal_merge_in_global_face. */
4081 if (UNSPECIFIEDP (value
))
4082 value
= Qignore_defface
;
4087 frame
= selected_frame
;
4089 CHECK_LIVE_FRAME (frame
);
4090 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
4092 /* If a frame-local face doesn't exist yet, create one. */
4094 lface
= Finternal_make_lisp_face (face
, frame
);
4097 if (EQ (attr
, QCfamily
))
4099 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4101 CHECK_STRING (value
);
4102 if (SCHARS (value
) == 0)
4103 signal_error ("Invalid face family", value
);
4105 old_value
= LFACE_FAMILY (lface
);
4106 LFACE_FAMILY (lface
) = value
;
4107 font_related_attr_p
= 1;
4109 else if (EQ (attr
, QCheight
))
4111 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4115 test
= (EQ (face
, Qdefault
)
4117 /* The default face must have an absolute size,
4118 otherwise, we do a test merge with a random
4119 height to see if VALUE's ok. */
4120 : merge_face_heights (value
, make_number (10), Qnil
));
4122 if (!INTEGERP (test
) || XINT (test
) <= 0)
4123 signal_error ("Invalid face height", value
);
4126 old_value
= LFACE_HEIGHT (lface
);
4127 LFACE_HEIGHT (lface
) = value
;
4128 font_related_attr_p
= 1;
4130 else if (EQ (attr
, QCweight
))
4132 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4134 CHECK_SYMBOL (value
);
4135 if (face_numeric_weight (value
) < 0)
4136 signal_error ("Invalid face weight", value
);
4138 old_value
= LFACE_WEIGHT (lface
);
4139 LFACE_WEIGHT (lface
) = value
;
4140 font_related_attr_p
= 1;
4142 else if (EQ (attr
, QCslant
))
4144 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4146 CHECK_SYMBOL (value
);
4147 if (face_numeric_slant (value
) < 0)
4148 signal_error ("Invalid face slant", value
);
4150 old_value
= LFACE_SLANT (lface
);
4151 LFACE_SLANT (lface
) = value
;
4152 font_related_attr_p
= 1;
4154 else if (EQ (attr
, QCunderline
))
4156 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4157 if ((SYMBOLP (value
)
4159 && !EQ (value
, Qnil
))
4160 /* Underline color. */
4162 && SCHARS (value
) == 0))
4163 signal_error ("Invalid face underline", value
);
4165 old_value
= LFACE_UNDERLINE (lface
);
4166 LFACE_UNDERLINE (lface
) = value
;
4168 else if (EQ (attr
, QCoverline
))
4170 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4171 if ((SYMBOLP (value
)
4173 && !EQ (value
, Qnil
))
4174 /* Overline color. */
4176 && SCHARS (value
) == 0))
4177 signal_error ("Invalid face overline", value
);
4179 old_value
= LFACE_OVERLINE (lface
);
4180 LFACE_OVERLINE (lface
) = value
;
4182 else if (EQ (attr
, QCstrike_through
))
4184 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4185 if ((SYMBOLP (value
)
4187 && !EQ (value
, Qnil
))
4188 /* Strike-through color. */
4190 && SCHARS (value
) == 0))
4191 signal_error ("Invalid face strike-through", value
);
4193 old_value
= LFACE_STRIKE_THROUGH (lface
);
4194 LFACE_STRIKE_THROUGH (lface
) = value
;
4196 else if (EQ (attr
, QCbox
))
4200 /* Allow t meaning a simple box of width 1 in foreground color
4203 value
= make_number (1);
4205 if (UNSPECIFIEDP (value
) || IGNORE_DEFFACE_P (value
))
4207 else if (NILP (value
))
4209 else if (INTEGERP (value
))
4210 valid_p
= XINT (value
) != 0;
4211 else if (STRINGP (value
))
4212 valid_p
= SCHARS (value
) > 0;
4213 else if (CONSP (value
))
4229 if (EQ (k
, QCline_width
))
4231 if (!INTEGERP (v
) || XINT (v
) == 0)
4234 else if (EQ (k
, QCcolor
))
4236 if (!NILP (v
) && (!STRINGP (v
) || SCHARS (v
) == 0))
4239 else if (EQ (k
, QCstyle
))
4241 if (!EQ (v
, Qpressed_button
) && !EQ (v
, Qreleased_button
))
4248 valid_p
= NILP (tem
);
4254 signal_error ("Invalid face box", value
);
4256 old_value
= LFACE_BOX (lface
);
4257 LFACE_BOX (lface
) = value
;
4259 else if (EQ (attr
, QCinverse_video
)
4260 || EQ (attr
, QCreverse_video
))
4262 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4264 CHECK_SYMBOL (value
);
4265 if (!EQ (value
, Qt
) && !NILP (value
))
4266 signal_error ("Invalid inverse-video face attribute value", value
);
4268 old_value
= LFACE_INVERSE (lface
);
4269 LFACE_INVERSE (lface
) = value
;
4271 else if (EQ (attr
, QCforeground
))
4273 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4275 /* Don't check for valid color names here because it depends
4276 on the frame (display) whether the color will be valid
4277 when the face is realized. */
4278 CHECK_STRING (value
);
4279 if (SCHARS (value
) == 0)
4280 signal_error ("Empty foreground color value", value
);
4282 old_value
= LFACE_FOREGROUND (lface
);
4283 LFACE_FOREGROUND (lface
) = value
;
4285 else if (EQ (attr
, QCbackground
))
4287 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4289 /* Don't check for valid color names here because it depends
4290 on the frame (display) whether the color will be valid
4291 when the face is realized. */
4292 CHECK_STRING (value
);
4293 if (SCHARS (value
) == 0)
4294 signal_error ("Empty background color value", value
);
4296 old_value
= LFACE_BACKGROUND (lface
);
4297 LFACE_BACKGROUND (lface
) = value
;
4299 else if (EQ (attr
, QCstipple
))
4301 #ifdef HAVE_X_WINDOWS
4302 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
)
4304 && NILP (Fbitmap_spec_p (value
)))
4305 signal_error ("Invalid stipple attribute", value
);
4306 old_value
= LFACE_STIPPLE (lface
);
4307 LFACE_STIPPLE (lface
) = value
;
4308 #endif /* HAVE_X_WINDOWS */
4310 else if (EQ (attr
, QCwidth
))
4312 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4314 CHECK_SYMBOL (value
);
4315 if (face_numeric_swidth (value
) < 0)
4316 signal_error ("Invalid face width", value
);
4318 old_value
= LFACE_SWIDTH (lface
);
4319 LFACE_SWIDTH (lface
) = value
;
4320 font_related_attr_p
= 1;
4322 else if (EQ (attr
, QCfont
))
4324 #ifdef HAVE_WINDOW_SYSTEM
4325 if (EQ (frame
, Qt
) || FRAME_WINDOW_P (XFRAME (frame
)))
4327 /* Set font-related attributes of the Lisp face from an XLFD
4333 f
= SELECTED_FRAME ();
4335 f
= check_x_frame (frame
);
4337 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4339 CHECK_STRING (value
);
4341 /* VALUE may be a fontset name or an alias of fontset. In
4342 such a case, use the base fontset name. */
4343 tmp
= Fquery_fontset (value
, Qnil
);
4347 if (!set_lface_from_font_name (f
, lface
, value
, 1, 1))
4348 signal_error ("Invalid font or fontset name", value
);
4353 #endif /* HAVE_WINDOW_SYSTEM */
4355 else if (EQ (attr
, QCinherit
))
4358 if (SYMBOLP (value
))
4361 for (tail
= value
; CONSP (tail
); tail
= XCDR (tail
))
4362 if (!SYMBOLP (XCAR (tail
)))
4365 LFACE_INHERIT (lface
) = value
;
4367 signal_error ("Invalid face inheritance", value
);
4369 else if (EQ (attr
, QCbold
))
4371 old_value
= LFACE_WEIGHT (lface
);
4372 LFACE_WEIGHT (lface
) = NILP (value
) ? Qnormal
: Qbold
;
4373 font_related_attr_p
= 1;
4375 else if (EQ (attr
, QCitalic
))
4377 old_value
= LFACE_SLANT (lface
);
4378 LFACE_SLANT (lface
) = NILP (value
) ? Qnormal
: Qitalic
;
4379 font_related_attr_p
= 1;
4382 signal_error ("Invalid face attribute name", attr
);
4384 if (font_related_attr_p
4385 && !UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4386 /* If a font-related attribute other than QCfont is specified, the
4387 original `font' attribute nor that of default face is useless
4388 to determine a new font. Thus, we set it to nil so that font
4389 selection mechanism doesn't use it. */
4390 LFACE_FONT (lface
) = Qnil
;
4392 /* Changing a named face means that all realized faces depending on
4393 that face are invalid. Since we cannot tell which realized faces
4394 depend on the face, make sure they are all removed. This is done
4395 by incrementing face_change_count. The next call to
4396 init_iterator will then free realized faces. */
4398 && NILP (Fget (face
, Qface_no_inherit
))
4399 && (EQ (attr
, QCfont
)
4400 || NILP (Fequal (old_value
, value
))))
4402 ++face_change_count
;
4403 ++windows_or_buffers_changed
;
4406 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
)
4407 && NILP (Fequal (old_value
, value
)))
4413 if (EQ (face
, Qdefault
))
4415 #ifdef HAVE_WINDOW_SYSTEM
4416 /* Changed font-related attributes of the `default' face are
4417 reflected in changed `font' frame parameters. */
4419 && (font_related_attr_p
|| font_attr_p
)
4420 && lface_fully_specified_p (XVECTOR (lface
)->contents
))
4421 set_font_frame_param (frame
, lface
);
4423 #endif /* HAVE_WINDOW_SYSTEM */
4425 if (EQ (attr
, QCforeground
))
4426 param
= Qforeground_color
;
4427 else if (EQ (attr
, QCbackground
))
4428 param
= Qbackground_color
;
4430 #ifdef HAVE_WINDOW_SYSTEM
4432 else if (EQ (face
, Qscroll_bar
))
4434 /* Changing the colors of `scroll-bar' sets frame parameters
4435 `scroll-bar-foreground' and `scroll-bar-background'. */
4436 if (EQ (attr
, QCforeground
))
4437 param
= Qscroll_bar_foreground
;
4438 else if (EQ (attr
, QCbackground
))
4439 param
= Qscroll_bar_background
;
4441 #endif /* not WINDOWSNT */
4442 else if (EQ (face
, Qborder
))
4444 /* Changing background color of `border' sets frame parameter
4446 if (EQ (attr
, QCbackground
))
4447 param
= Qborder_color
;
4449 else if (EQ (face
, Qcursor
))
4451 /* Changing background color of `cursor' sets frame parameter
4453 if (EQ (attr
, QCbackground
))
4454 param
= Qcursor_color
;
4456 else if (EQ (face
, Qmouse
))
4458 /* Changing background color of `mouse' sets frame parameter
4460 if (EQ (attr
, QCbackground
))
4461 param
= Qmouse_color
;
4463 #endif /* HAVE_WINDOW_SYSTEM */
4464 else if (EQ (face
, Qmenu
))
4466 /* Indicate that we have to update the menu bar when
4467 realizing faces on FRAME. FRAME t change the
4468 default for new frames. We do this by setting
4469 setting the flag in new face caches */
4472 struct frame
*f
= XFRAME (frame
);
4473 if (FRAME_FACE_CACHE (f
) == NULL
)
4474 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
4475 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 1;
4478 menu_face_changed_default
= 1;
4484 /* Update `default-frame-alist', which is used for new frames. */
4486 store_in_alist (&Vdefault_frame_alist
, param
, value
);
4489 /* Update the current frame's parameters. */
4492 cons
= XCAR (Vparam_value_alist
);
4493 XSETCAR (cons
, param
);
4494 XSETCDR (cons
, value
);
4495 Fmodify_frame_parameters (frame
, Vparam_value_alist
);
4504 #ifdef HAVE_WINDOW_SYSTEM
4506 /* Set the `font' frame parameter of FRAME determined from `default'
4507 face attributes LFACE. If a face or fontset name is explicitely
4508 specfied in LFACE, use it as is. Otherwise, determine a font name
4509 from the other font-related atrributes of LFACE. In that case, if
4510 there's no matching font, signals an error. */
4513 set_font_frame_param (frame
, lface
)
4514 Lisp_Object frame
, lface
;
4516 struct frame
*f
= XFRAME (frame
);
4518 if (FRAME_WINDOW_P (f
))
4520 Lisp_Object font_name
;
4523 if (STRINGP (LFACE_FONT (lface
)))
4524 font_name
= LFACE_FONT (lface
);
4527 /* Choose a font name that reflects LFACE's attributes and has
4528 the registry and encoding pattern specified in the default
4529 fontset (3rd arg: -1) for ASCII characters (4th arg: 0). */
4530 font
= choose_face_font (f
, XVECTOR (lface
)->contents
, -1, 0, 0);
4532 error ("No font matches the specified attribute");
4533 font_name
= build_string (font
);
4537 f
->default_face_done_p
= 0;
4538 Fmodify_frame_parameters (frame
, Fcons (Fcons (Qfont
, font_name
), Qnil
));
4543 /* Update the corresponding face when frame parameter PARAM on frame F
4544 has been assigned the value NEW_VALUE. */
4547 update_face_from_frame_parameter (f
, param
, new_value
)
4549 Lisp_Object param
, new_value
;
4551 Lisp_Object face
= Qnil
;
4554 /* If there are no faces yet, give up. This is the case when called
4555 from Fx_create_frame, and we do the necessary things later in
4556 face-set-after-frame-defaults. */
4557 if (NILP (f
->face_alist
))
4560 if (EQ (param
, Qforeground_color
))
4563 lface
= lface_from_face_name (f
, face
, 1);
4564 LFACE_FOREGROUND (lface
) = (STRINGP (new_value
)
4565 ? new_value
: Qunspecified
);
4566 realize_basic_faces (f
);
4568 else if (EQ (param
, Qbackground_color
))
4572 /* Changing the background color might change the background
4573 mode, so that we have to load new defface specs.
4574 Call frame-set-background-mode to do that. */
4575 XSETFRAME (frame
, f
);
4576 call1 (Qframe_set_background_mode
, frame
);
4579 lface
= lface_from_face_name (f
, face
, 1);
4580 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4581 ? new_value
: Qunspecified
);
4582 realize_basic_faces (f
);
4584 else if (EQ (param
, Qborder_color
))
4587 lface
= lface_from_face_name (f
, face
, 1);
4588 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4589 ? new_value
: Qunspecified
);
4591 else if (EQ (param
, Qcursor_color
))
4594 lface
= lface_from_face_name (f
, face
, 1);
4595 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4596 ? new_value
: Qunspecified
);
4598 else if (EQ (param
, Qmouse_color
))
4601 lface
= lface_from_face_name (f
, face
, 1);
4602 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4603 ? new_value
: Qunspecified
);
4606 /* Changing a named face means that all realized faces depending on
4607 that face are invalid. Since we cannot tell which realized faces
4608 depend on the face, make sure they are all removed. This is done
4609 by incrementing face_change_count. The next call to
4610 init_iterator will then free realized faces. */
4612 && NILP (Fget (face
, Qface_no_inherit
)))
4614 ++face_change_count
;
4615 ++windows_or_buffers_changed
;
4620 /* Get the value of X resource RESOURCE, class CLASS for the display
4621 of frame FRAME. This is here because ordinary `x-get-resource'
4622 doesn't take a frame argument. */
4624 DEFUN ("internal-face-x-get-resource", Finternal_face_x_get_resource
,
4625 Sinternal_face_x_get_resource
, 3, 3, 0, doc
: /* */)
4626 (resource
, class, frame
)
4627 Lisp_Object resource
, class, frame
;
4629 Lisp_Object value
= Qnil
;
4630 CHECK_STRING (resource
);
4631 CHECK_STRING (class);
4632 CHECK_LIVE_FRAME (frame
);
4634 value
= display_x_get_resource (FRAME_X_DISPLAY_INFO (XFRAME (frame
)),
4635 resource
, class, Qnil
, Qnil
);
4641 /* Return resource string VALUE as a boolean value, i.e. nil, or t.
4642 If VALUE is "on" or "true", return t. If VALUE is "off" or
4643 "false", return nil. Otherwise, if SIGNAL_P is non-zero, signal an
4644 error; if SIGNAL_P is zero, return 0. */
4647 face_boolean_x_resource_value (value
, signal_p
)
4651 Lisp_Object result
= make_number (0);
4653 xassert (STRINGP (value
));
4655 if (xstricmp (SDATA (value
), "on") == 0
4656 || xstricmp (SDATA (value
), "true") == 0)
4658 else if (xstricmp (SDATA (value
), "off") == 0
4659 || xstricmp (SDATA (value
), "false") == 0)
4661 else if (xstricmp (SDATA (value
), "unspecified") == 0)
4662 result
= Qunspecified
;
4664 signal_error ("Invalid face attribute value from X resource", value
);
4670 DEFUN ("internal-set-lisp-face-attribute-from-resource",
4671 Finternal_set_lisp_face_attribute_from_resource
,
4672 Sinternal_set_lisp_face_attribute_from_resource
,
4673 3, 4, 0, doc
: /* */)
4674 (face
, attr
, value
, frame
)
4675 Lisp_Object face
, attr
, value
, frame
;
4677 CHECK_SYMBOL (face
);
4678 CHECK_SYMBOL (attr
);
4679 CHECK_STRING (value
);
4681 if (xstricmp (SDATA (value
), "unspecified") == 0)
4682 value
= Qunspecified
;
4683 else if (EQ (attr
, QCheight
))
4685 value
= Fstring_to_number (value
, make_number (10));
4686 if (XINT (value
) <= 0)
4687 signal_error ("Invalid face height from X resource", value
);
4689 else if (EQ (attr
, QCbold
) || EQ (attr
, QCitalic
))
4690 value
= face_boolean_x_resource_value (value
, 1);
4691 else if (EQ (attr
, QCweight
) || EQ (attr
, QCslant
) || EQ (attr
, QCwidth
))
4692 value
= intern (SDATA (value
));
4693 else if (EQ (attr
, QCreverse_video
) || EQ (attr
, QCinverse_video
))
4694 value
= face_boolean_x_resource_value (value
, 1);
4695 else if (EQ (attr
, QCunderline
)
4696 || EQ (attr
, QCoverline
)
4697 || EQ (attr
, QCstrike_through
))
4699 Lisp_Object boolean_value
;
4701 /* If the result of face_boolean_x_resource_value is t or nil,
4702 VALUE does NOT specify a color. */
4703 boolean_value
= face_boolean_x_resource_value (value
, 0);
4704 if (SYMBOLP (boolean_value
))
4705 value
= boolean_value
;
4707 else if (EQ (attr
, QCbox
) || EQ (attr
, QCinherit
))
4708 value
= Fcar (Fread_from_string (value
, Qnil
, Qnil
));
4710 return Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
4713 #endif /* HAVE_WINDOW_SYSTEM */
4716 /***********************************************************************
4718 ***********************************************************************/
4720 #if defined HAVE_X_WINDOWS && defined USE_X_TOOLKIT
4722 /* Make menus on frame F appear as specified by the `menu' face. */
4725 x_update_menu_appearance (f
)
4728 struct x_display_info
*dpyinfo
= FRAME_X_DISPLAY_INFO (f
);
4732 && (rdb
= XrmGetDatabase (FRAME_X_DISPLAY (f
)),
4736 Lisp_Object lface
= lface_from_face_name (f
, Qmenu
, 1);
4737 struct face
*face
= FACE_FROM_ID (f
, MENU_FACE_ID
);
4738 const char *myname
= SDATA (Vx_resource_name
);
4741 const char *popup_path
= "popup_menu";
4743 const char *popup_path
= "menu.popup";
4746 if (STRINGP (LFACE_FOREGROUND (lface
)))
4748 sprintf (line
, "%s.%s*foreground: %s",
4750 SDATA (LFACE_FOREGROUND (lface
)));
4751 XrmPutLineResource (&rdb
, line
);
4752 sprintf (line
, "%s.pane.menubar*foreground: %s",
4753 myname
, SDATA (LFACE_FOREGROUND (lface
)));
4754 XrmPutLineResource (&rdb
, line
);
4758 if (STRINGP (LFACE_BACKGROUND (lface
)))
4760 sprintf (line
, "%s.%s*background: %s",
4762 SDATA (LFACE_BACKGROUND (lface
)));
4763 XrmPutLineResource (&rdb
, line
);
4764 sprintf (line
, "%s.pane.menubar*background: %s",
4765 myname
, SDATA (LFACE_BACKGROUND (lface
)));
4766 XrmPutLineResource (&rdb
, line
);
4771 && (!UNSPECIFIEDP (LFACE_FAMILY (lface
))
4772 || !UNSPECIFIEDP (LFACE_SWIDTH (lface
))
4773 || !UNSPECIFIEDP (LFACE_AVGWIDTH (lface
))
4774 || !UNSPECIFIEDP (LFACE_WEIGHT (lface
))
4775 || !UNSPECIFIEDP (LFACE_SLANT (lface
))
4776 || !UNSPECIFIEDP (LFACE_HEIGHT (lface
))))
4779 const char *suffix
= "List";
4782 #if defined HAVE_X_I18N
4784 const char *suffix
= "Set";
4786 const char *suffix
= "";
4790 #if defined HAVE_X_I18N
4791 extern char *xic_create_fontsetname
4792 P_ ((char *base_fontname
, Bool motif
));
4793 char *fontsetname
= xic_create_fontsetname (face
->font_name
, motif
);
4795 char *fontsetname
= face
->font_name
;
4797 sprintf (line
, "%s.pane.menubar*font%s: %s",
4798 myname
, suffix
, fontsetname
);
4799 XrmPutLineResource (&rdb
, line
);
4800 sprintf (line
, "%s.%s*font%s: %s",
4801 myname
, popup_path
, suffix
, fontsetname
);
4802 XrmPutLineResource (&rdb
, line
);
4804 if (fontsetname
!= face
->font_name
)
4805 xfree (fontsetname
);
4808 if (changed_p
&& f
->output_data
.x
->menubar_widget
)
4809 free_frame_menubar (f
);
4813 #endif /* HAVE_X_WINDOWS && USE_X_TOOLKIT */
4816 DEFUN ("face-attribute-relative-p", Fface_attribute_relative_p
,
4817 Sface_attribute_relative_p
,
4819 doc
: /* Return non-nil if face ATTRIBUTE VALUE is relative. */)
4821 Lisp_Object attribute
, value
;
4823 if (EQ (value
, Qunspecified
) || (EQ (value
, Qignore_defface
)))
4825 else if (EQ (attribute
, QCheight
))
4826 return INTEGERP (value
) ? Qnil
: Qt
;
4831 DEFUN ("merge-face-attribute", Fmerge_face_attribute
, Smerge_face_attribute
,
4833 doc
: /* Return face ATTRIBUTE VALUE1 merged with VALUE2.
4834 If VALUE1 or VALUE2 are absolute (see `face-attribute-relative-p'), then
4835 the result will be absolute, otherwise it will be relative. */)
4836 (attribute
, value1
, value2
)
4837 Lisp_Object attribute
, value1
, value2
;
4839 if (EQ (value1
, Qunspecified
) || EQ (value1
, Qignore_defface
))
4841 else if (EQ (attribute
, QCheight
))
4842 return merge_face_heights (value1
, value2
, value1
);
4848 DEFUN ("internal-get-lisp-face-attribute", Finternal_get_lisp_face_attribute
,
4849 Sinternal_get_lisp_face_attribute
,
4851 doc
: /* Return face attribute KEYWORD of face SYMBOL.
4852 If SYMBOL does not name a valid Lisp face or KEYWORD isn't a valid
4853 face attribute name, signal an error.
4854 If the optional argument FRAME is given, report on face SYMBOL in that
4855 frame. If FRAME is t, report on the defaults for face SYMBOL (for new
4856 frames). If FRAME is omitted or nil, use the selected frame. */)
4857 (symbol
, keyword
, frame
)
4858 Lisp_Object symbol
, keyword
, frame
;
4860 Lisp_Object lface
, value
= Qnil
;
4862 CHECK_SYMBOL (symbol
);
4863 CHECK_SYMBOL (keyword
);
4866 lface
= lface_from_face_name (NULL
, symbol
, 1);
4870 frame
= selected_frame
;
4871 CHECK_LIVE_FRAME (frame
);
4872 lface
= lface_from_face_name (XFRAME (frame
), symbol
, 1);
4875 if (EQ (keyword
, QCfamily
))
4876 value
= LFACE_FAMILY (lface
);
4877 else if (EQ (keyword
, QCheight
))
4878 value
= LFACE_HEIGHT (lface
);
4879 else if (EQ (keyword
, QCweight
))
4880 value
= LFACE_WEIGHT (lface
);
4881 else if (EQ (keyword
, QCslant
))
4882 value
= LFACE_SLANT (lface
);
4883 else if (EQ (keyword
, QCunderline
))
4884 value
= LFACE_UNDERLINE (lface
);
4885 else if (EQ (keyword
, QCoverline
))
4886 value
= LFACE_OVERLINE (lface
);
4887 else if (EQ (keyword
, QCstrike_through
))
4888 value
= LFACE_STRIKE_THROUGH (lface
);
4889 else if (EQ (keyword
, QCbox
))
4890 value
= LFACE_BOX (lface
);
4891 else if (EQ (keyword
, QCinverse_video
)
4892 || EQ (keyword
, QCreverse_video
))
4893 value
= LFACE_INVERSE (lface
);
4894 else if (EQ (keyword
, QCforeground
))
4895 value
= LFACE_FOREGROUND (lface
);
4896 else if (EQ (keyword
, QCbackground
))
4897 value
= LFACE_BACKGROUND (lface
);
4898 else if (EQ (keyword
, QCstipple
))
4899 value
= LFACE_STIPPLE (lface
);
4900 else if (EQ (keyword
, QCwidth
))
4901 value
= LFACE_SWIDTH (lface
);
4902 else if (EQ (keyword
, QCinherit
))
4903 value
= LFACE_INHERIT (lface
);
4904 else if (EQ (keyword
, QCfont
))
4905 value
= LFACE_FONT (lface
);
4907 signal_error ("Invalid face attribute name", keyword
);
4909 if (IGNORE_DEFFACE_P (value
))
4910 return Qunspecified
;
4916 DEFUN ("internal-lisp-face-attribute-values",
4917 Finternal_lisp_face_attribute_values
,
4918 Sinternal_lisp_face_attribute_values
, 1, 1, 0,
4919 doc
: /* Return a list of valid discrete values for face attribute ATTR.
4920 Value is nil if ATTR doesn't have a discrete set of valid values. */)
4924 Lisp_Object result
= Qnil
;
4926 CHECK_SYMBOL (attr
);
4928 if (EQ (attr
, QCweight
)
4929 || EQ (attr
, QCslant
)
4930 || EQ (attr
, QCwidth
))
4932 /* Extract permissible symbols from tables. */
4933 struct table_entry
*table
;
4936 if (EQ (attr
, QCweight
))
4937 table
= weight_table
, dim
= DIM (weight_table
);
4938 else if (EQ (attr
, QCslant
))
4939 table
= slant_table
, dim
= DIM (slant_table
);
4941 table
= swidth_table
, dim
= DIM (swidth_table
);
4943 for (i
= 0; i
< dim
; ++i
)
4945 Lisp_Object symbol
= *table
[i
].symbol
;
4946 Lisp_Object tail
= result
;
4949 && !EQ (XCAR (tail
), symbol
))
4953 result
= Fcons (symbol
, result
);
4956 else if (EQ (attr
, QCunderline
))
4957 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4958 else if (EQ (attr
, QCoverline
))
4959 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4960 else if (EQ (attr
, QCstrike_through
))
4961 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4962 else if (EQ (attr
, QCinverse_video
) || EQ (attr
, QCreverse_video
))
4963 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4969 DEFUN ("internal-merge-in-global-face", Finternal_merge_in_global_face
,
4970 Sinternal_merge_in_global_face
, 2, 2, 0,
4971 doc
: /* Add attributes from frame-default definition of FACE to FACE on FRAME.
4972 Default face attributes override any local face attributes. */)
4974 Lisp_Object face
, frame
;
4977 Lisp_Object global_lface
, local_lface
, *gvec
, *lvec
;
4979 CHECK_LIVE_FRAME (frame
);
4980 global_lface
= lface_from_face_name (NULL
, face
, 1);
4981 local_lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
4982 if (NILP (local_lface
))
4983 local_lface
= Finternal_make_lisp_face (face
, frame
);
4985 /* Make every specified global attribute override the local one.
4986 BEWARE!! This is only used from `face-set-after-frame-default' where
4987 the local frame is defined from default specs in `face-defface-spec'
4988 and those should be overridden by global settings. Hence the strange
4989 "global before local" priority. */
4990 lvec
= XVECTOR (local_lface
)->contents
;
4991 gvec
= XVECTOR (global_lface
)->contents
;
4992 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
4993 if (! UNSPECIFIEDP (gvec
[i
]))
4995 if (IGNORE_DEFFACE_P (gvec
[i
]))
4996 lvec
[i
] = Qunspecified
;
5005 /* The following function is implemented for compatibility with 20.2.
5006 The function is used in x-resolve-fonts when it is asked to
5007 return fonts with the same size as the font of a face. This is
5008 done in fontset.el. */
5010 DEFUN ("face-font", Fface_font
, Sface_font
, 1, 2, 0,
5011 doc
: /* Return the font name of face FACE, or nil if it is unspecified.
5012 If the optional argument FRAME is given, report on face FACE in that frame.
5013 If FRAME is t, report on the defaults for face FACE (for new frames).
5014 The font default for a face is either nil, or a list
5015 of the form (bold), (italic) or (bold italic).
5016 If FRAME is omitted or nil, use the selected frame. */)
5018 Lisp_Object face
, frame
;
5022 Lisp_Object result
= Qnil
;
5023 Lisp_Object lface
= lface_from_face_name (NULL
, face
, 1);
5025 if (!UNSPECIFIEDP (LFACE_WEIGHT (lface
))
5026 && !EQ (LFACE_WEIGHT (lface
), Qnormal
))
5027 result
= Fcons (Qbold
, result
);
5029 if (!UNSPECIFIEDP (LFACE_SLANT (lface
))
5030 && !EQ (LFACE_SLANT (lface
), Qnormal
))
5031 result
= Fcons (Qitalic
, result
);
5037 struct frame
*f
= frame_or_selected_frame (frame
, 1);
5038 int face_id
= lookup_named_face (f
, face
, 0, 1);
5039 struct face
*face
= FACE_FROM_ID (f
, face_id
);
5040 return face
? build_string (face
->font_name
) : Qnil
;
5045 /* Compare face-attribute values v1 and v2 for equality. Value is non-zero if
5046 all attributes are `equal'. Tries to be fast because this function
5047 is called quite often. */
5050 face_attr_equal_p (v1
, v2
)
5053 /* Type can differ, e.g. when one attribute is unspecified, i.e. nil,
5054 and the other is specified. */
5055 if (XTYPE (v1
) != XTYPE (v2
))
5064 if (SBYTES (v1
) != SBYTES (v2
))
5067 return bcmp (SDATA (v1
), SDATA (v2
), SBYTES (v1
)) == 0;
5074 return !NILP (Fequal (v1
, v2
));
5079 /* Compare face vectors V1 and V2 for equality. Value is non-zero if
5080 all attributes are `equal'. Tries to be fast because this function
5081 is called quite often. */
5084 lface_equal_p (v1
, v2
)
5085 Lisp_Object
*v1
, *v2
;
5089 for (i
= 1; i
< LFACE_VECTOR_SIZE
&& equal_p
; ++i
)
5090 equal_p
= face_attr_equal_p (v1
[i
], v2
[i
]);
5096 DEFUN ("internal-lisp-face-equal-p", Finternal_lisp_face_equal_p
,
5097 Sinternal_lisp_face_equal_p
, 2, 3, 0,
5098 doc
: /* True if FACE1 and FACE2 are equal.
5099 If the optional argument FRAME is given, report on FACE1 and FACE2 in that frame.
5100 If FRAME is t, report on the defaults for FACE1 and FACE2 (for new frames).
5101 If FRAME is omitted or nil, use the selected frame. */)
5102 (face1
, face2
, frame
)
5103 Lisp_Object face1
, face2
, frame
;
5107 Lisp_Object lface1
, lface2
;
5112 /* Don't use check_x_frame here because this function is called
5113 before X frames exist. At that time, if FRAME is nil,
5114 selected_frame will be used which is the frame dumped with
5115 Emacs. That frame is not an X frame. */
5116 f
= frame_or_selected_frame (frame
, 2);
5118 lface1
= lface_from_face_name (f
, face1
, 1);
5119 lface2
= lface_from_face_name (f
, face2
, 1);
5120 equal_p
= lface_equal_p (XVECTOR (lface1
)->contents
,
5121 XVECTOR (lface2
)->contents
);
5122 return equal_p
? Qt
: Qnil
;
5126 DEFUN ("internal-lisp-face-empty-p", Finternal_lisp_face_empty_p
,
5127 Sinternal_lisp_face_empty_p
, 1, 2, 0,
5128 doc
: /* True if FACE has no attribute specified.
5129 If the optional argument FRAME is given, report on face FACE in that frame.
5130 If FRAME is t, report on the defaults for face FACE (for new frames).
5131 If FRAME is omitted or nil, use the selected frame. */)
5133 Lisp_Object face
, frame
;
5140 frame
= selected_frame
;
5141 CHECK_LIVE_FRAME (frame
);
5145 lface
= lface_from_face_name (NULL
, face
, 1);
5147 lface
= lface_from_face_name (f
, face
, 1);
5149 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
5150 if (!UNSPECIFIEDP (AREF (lface
, i
)))
5153 return i
== LFACE_VECTOR_SIZE
? Qt
: Qnil
;
5157 DEFUN ("frame-face-alist", Fframe_face_alist
, Sframe_face_alist
,
5159 doc
: /* Return an alist of frame-local faces defined on FRAME.
5160 For internal use only. */)
5164 struct frame
*f
= frame_or_selected_frame (frame
, 0);
5165 return f
->face_alist
;
5169 /* Return a hash code for Lisp string STRING with case ignored. Used
5170 below in computing a hash value for a Lisp face. */
5172 static INLINE
unsigned
5173 hash_string_case_insensitive (string
)
5176 const unsigned char *s
;
5178 xassert (STRINGP (string
));
5179 for (s
= SDATA (string
); *s
; ++s
)
5180 hash
= (hash
<< 1) ^ tolower (*s
);
5185 /* Return a hash code for face attribute vector V. */
5187 static INLINE
unsigned
5191 return (hash_string_case_insensitive (v
[LFACE_FAMILY_INDEX
])
5192 ^ hash_string_case_insensitive (v
[LFACE_FOREGROUND_INDEX
])
5193 ^ hash_string_case_insensitive (v
[LFACE_BACKGROUND_INDEX
])
5194 ^ XFASTINT (v
[LFACE_WEIGHT_INDEX
])
5195 ^ XFASTINT (v
[LFACE_SLANT_INDEX
])
5196 ^ XFASTINT (v
[LFACE_SWIDTH_INDEX
])
5197 ^ XFASTINT (v
[LFACE_HEIGHT_INDEX
]));
5201 /* Return non-zero if LFACE1 and LFACE2 specify the same font (without
5202 considering charsets/registries). They do if they specify the same
5203 family, point size, weight, width, slant, and fontset. Both LFACE1
5204 and LFACE2 must be fully-specified. */
5207 lface_same_font_attributes_p (lface1
, lface2
)
5208 Lisp_Object
*lface1
, *lface2
;
5210 xassert (lface_fully_specified_p (lface1
)
5211 && lface_fully_specified_p (lface2
));
5212 return (xstricmp (SDATA (lface1
[LFACE_FAMILY_INDEX
]),
5213 SDATA (lface2
[LFACE_FAMILY_INDEX
])) == 0
5214 && EQ (lface1
[LFACE_HEIGHT_INDEX
], lface2
[LFACE_HEIGHT_INDEX
])
5215 && EQ (lface1
[LFACE_SWIDTH_INDEX
], lface2
[LFACE_SWIDTH_INDEX
])
5216 && EQ (lface1
[LFACE_AVGWIDTH_INDEX
], lface2
[LFACE_AVGWIDTH_INDEX
])
5217 && EQ (lface1
[LFACE_WEIGHT_INDEX
], lface2
[LFACE_WEIGHT_INDEX
])
5218 && EQ (lface1
[LFACE_SLANT_INDEX
], lface2
[LFACE_SLANT_INDEX
])
5219 && (EQ (lface1
[LFACE_FONT_INDEX
], lface2
[LFACE_FONT_INDEX
])
5220 || (STRINGP (lface1
[LFACE_FONT_INDEX
])
5221 && STRINGP (lface2
[LFACE_FONT_INDEX
])
5222 && xstricmp (SDATA (lface1
[LFACE_FONT_INDEX
]),
5223 SDATA (lface2
[LFACE_FONT_INDEX
])))));
5228 /***********************************************************************
5230 ***********************************************************************/
5232 /* Allocate and return a new realized face for Lisp face attribute
5235 static struct face
*
5236 make_realized_face (attr
)
5239 struct face
*face
= (struct face
*) xmalloc (sizeof *face
);
5240 bzero (face
, sizeof *face
);
5241 face
->ascii_face
= face
;
5242 bcopy (attr
, face
->lface
, sizeof face
->lface
);
5247 /* Free realized face FACE, including its X resources. FACE may
5251 free_realized_face (f
, face
)
5257 #ifdef HAVE_WINDOW_SYSTEM
5258 if (FRAME_WINDOW_P (f
))
5260 /* Free fontset of FACE if it is ASCII face. */
5261 if (face
->fontset
>= 0 && face
== face
->ascii_face
)
5262 free_face_fontset (f
, face
);
5265 x_free_gc (f
, face
->gc
);
5269 free_face_colors (f
, face
);
5270 x_destroy_bitmap (f
, face
->stipple
);
5272 #endif /* HAVE_WINDOW_SYSTEM */
5279 /* Prepare face FACE for subsequent display on frame F. This
5280 allocated GCs if they haven't been allocated yet or have been freed
5281 by clearing the face cache. */
5284 prepare_face_for_display (f
, face
)
5288 #ifdef HAVE_WINDOW_SYSTEM
5289 xassert (FRAME_WINDOW_P (f
));
5294 unsigned long mask
= GCForeground
| GCBackground
| GCGraphicsExposures
;
5296 xgcv
.foreground
= face
->foreground
;
5297 xgcv
.background
= face
->background
;
5298 #ifdef HAVE_X_WINDOWS
5299 xgcv
.graphics_exposures
= False
;
5301 /* The font of FACE may be null if we couldn't load it. */
5304 #ifdef HAVE_X_WINDOWS
5305 xgcv
.font
= face
->font
->fid
;
5308 xgcv
.font
= face
->font
;
5311 xgcv
.font
= face
->font
;
5317 #ifdef HAVE_X_WINDOWS
5320 xgcv
.fill_style
= FillOpaqueStippled
;
5321 xgcv
.stipple
= x_bitmap_pixmap (f
, face
->stipple
);
5322 mask
|= GCFillStyle
| GCStipple
;
5325 face
->gc
= x_create_gc (f
, mask
, &xgcv
);
5328 #endif /* HAVE_WINDOW_SYSTEM */
5332 /* Returns the `distance' between the colors X and Y. */
5335 color_distance (x
, y
)
5338 /* This formula is from a paper title `Colour metric' by Thiadmer Riemersma.
5339 Quoting from that paper:
5341 This formula has results that are very close to L*u*v* (with the
5342 modified lightness curve) and, more importantly, it is a more even
5343 algorithm: it does not have a range of colours where it suddenly
5344 gives far from optimal results.
5346 See <http://www.compuphase.com/cmetric.htm> for more info. */
5348 long r
= (x
->red
- y
->red
) >> 8;
5349 long g
= (x
->green
- y
->green
) >> 8;
5350 long b
= (x
->blue
- y
->blue
) >> 8;
5351 long r_mean
= (x
->red
+ y
->red
) >> 9;
5354 (((512 + r_mean
) * r
* r
) >> 8)
5356 + (((767 - r_mean
) * b
* b
) >> 8);
5360 DEFUN ("color-distance", Fcolor_distance
, Scolor_distance
, 2, 3, 0,
5361 doc
: /* Return an integer distance between COLOR1 and COLOR2 on FRAME.
5362 COLOR1 and COLOR2 may be either strings containing the color name,
5363 or lists of the form (RED GREEN BLUE).
5364 If FRAME is unspecified or nil, the current frame is used. */)
5365 (color1
, color2
, frame
)
5366 Lisp_Object color1
, color2
, frame
;
5369 XColor cdef1
, cdef2
;
5372 frame
= selected_frame
;
5373 CHECK_LIVE_FRAME (frame
);
5376 if ((CONSP (color1
) && !parse_rgb_list (color1
, &cdef1
))
5377 || !STRINGP (color1
)
5378 || !defined_color (f
, SDATA (color1
), &cdef1
, 0))
5379 signal_error ("Invalid color", color1
);
5380 if ((CONSP (color2
) && !parse_rgb_list (color2
, &cdef2
))
5381 || !STRINGP (color2
)
5382 || !defined_color (f
, SDATA (color2
), &cdef2
, 0))
5383 signal_error ("Invalid color", color2
);
5385 return make_number (color_distance (&cdef1
, &cdef2
));
5389 /***********************************************************************
5391 ***********************************************************************/
5393 /* Return a new face cache for frame F. */
5395 static struct face_cache
*
5399 struct face_cache
*c
;
5402 c
= (struct face_cache
*) xmalloc (sizeof *c
);
5403 bzero (c
, sizeof *c
);
5404 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5405 c
->buckets
= (struct face
**) xmalloc (size
);
5406 bzero (c
->buckets
, size
);
5408 c
->faces_by_id
= (struct face
**) xmalloc (c
->size
* sizeof *c
->faces_by_id
);
5410 c
->menu_face_changed_p
= menu_face_changed_default
;
5415 /* Clear out all graphics contexts for all realized faces, except for
5416 the basic faces. This should be done from time to time just to avoid
5417 keeping too many graphics contexts that are no longer needed. */
5421 struct face_cache
*c
;
5423 if (c
&& FRAME_WINDOW_P (c
->f
))
5425 #ifdef HAVE_WINDOW_SYSTEM
5427 for (i
= BASIC_FACE_ID_SENTINEL
; i
< c
->used
; ++i
)
5429 struct face
*face
= c
->faces_by_id
[i
];
5430 if (face
&& face
->gc
)
5432 x_free_gc (c
->f
, face
->gc
);
5436 #endif /* HAVE_WINDOW_SYSTEM */
5441 /* Free all realized faces in face cache C, including basic faces.
5442 C may be null. If faces are freed, make sure the frame's current
5443 matrix is marked invalid, so that a display caused by an expose
5444 event doesn't try to use faces we destroyed. */
5447 free_realized_faces (c
)
5448 struct face_cache
*c
;
5453 struct frame
*f
= c
->f
;
5455 /* We must block input here because we can't process X events
5456 safely while only some faces are freed, or when the frame's
5457 current matrix still references freed faces. */
5460 for (i
= 0; i
< c
->used
; ++i
)
5462 free_realized_face (f
, c
->faces_by_id
[i
]);
5463 c
->faces_by_id
[i
] = NULL
;
5467 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5468 bzero (c
->buckets
, size
);
5470 /* Must do a thorough redisplay the next time. Mark current
5471 matrices as invalid because they will reference faces freed
5472 above. This function is also called when a frame is
5473 destroyed. In this case, the root window of F is nil. */
5474 if (WINDOWP (f
->root_window
))
5476 clear_current_matrices (f
);
5477 ++windows_or_buffers_changed
;
5485 /* Free all faces realized for multibyte characters on frame F that
5489 free_realized_multibyte_face (f
, fontset
)
5493 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5497 /* We must block input here because we can't process X events safely
5498 while only some faces are freed, or when the frame's current
5499 matrix still references freed faces. */
5502 for (i
= 0; i
< cache
->used
; i
++)
5504 face
= cache
->faces_by_id
[i
];
5506 && face
!= face
->ascii_face
5507 && face
->fontset
== fontset
)
5509 uncache_face (cache
, face
);
5510 free_realized_face (f
, face
);
5514 /* Must do a thorough redisplay the next time. Mark current
5515 matrices as invalid because they will reference faces freed
5516 above. This function is also called when a frame is destroyed.
5517 In this case, the root window of F is nil. */
5518 if (WINDOWP (f
->root_window
))
5520 clear_current_matrices (f
);
5521 ++windows_or_buffers_changed
;
5528 /* Free all realized faces on FRAME or on all frames if FRAME is nil.
5529 This is done after attributes of a named face have been changed,
5530 because we can't tell which realized faces depend on that face. */
5533 free_all_realized_faces (frame
)
5539 FOR_EACH_FRAME (rest
, frame
)
5540 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5543 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5547 /* Free face cache C and faces in it, including their X resources. */
5551 struct face_cache
*c
;
5555 free_realized_faces (c
);
5557 xfree (c
->faces_by_id
);
5563 /* Cache realized face FACE in face cache C. HASH is the hash value
5564 of FACE. If FACE->fontset >= 0, add the new face to the end of the
5565 collision list of the face hash table of C. This is done because
5566 otherwise lookup_face would find FACE for every character, even if
5567 faces with the same attributes but for specific characters exist. */
5570 cache_face (c
, face
, hash
)
5571 struct face_cache
*c
;
5575 int i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5579 if (face
->fontset
>= 0)
5581 struct face
*last
= c
->buckets
[i
];
5592 c
->buckets
[i
] = face
;
5593 face
->prev
= face
->next
= NULL
;
5599 face
->next
= c
->buckets
[i
];
5601 face
->next
->prev
= face
;
5602 c
->buckets
[i
] = face
;
5605 /* Find a free slot in C->faces_by_id and use the index of the free
5606 slot as FACE->id. */
5607 for (i
= 0; i
< c
->used
; ++i
)
5608 if (c
->faces_by_id
[i
] == NULL
)
5612 /* Maybe enlarge C->faces_by_id. */
5615 if (c
->used
== c
->size
)
5618 new_size
= min (2 * c
->size
, MAX_FACE_ID
);
5619 if (new_size
== c
->size
)
5620 abort (); /* Alternatives? ++kfs */
5621 sz
= new_size
* sizeof *c
->faces_by_id
;
5622 c
->faces_by_id
= (struct face
**) xrealloc (c
->faces_by_id
, sz
);
5629 /* Check that FACE got a unique id. */
5634 for (j
= n
= 0; j
< FACE_CACHE_BUCKETS_SIZE
; ++j
)
5635 for (face
= c
->buckets
[j
]; face
; face
= face
->next
)
5641 #endif /* GLYPH_DEBUG */
5643 c
->faces_by_id
[i
] = face
;
5647 /* Remove face FACE from cache C. */
5650 uncache_face (c
, face
)
5651 struct face_cache
*c
;
5654 int i
= face
->hash
% FACE_CACHE_BUCKETS_SIZE
;
5657 face
->prev
->next
= face
->next
;
5659 c
->buckets
[i
] = face
->next
;
5662 face
->next
->prev
= face
->prev
;
5664 c
->faces_by_id
[face
->id
] = NULL
;
5665 if (face
->id
== c
->used
)
5670 /* Look up a realized face with face attributes ATTR in the face cache
5671 of frame F. The face will be used to display character C. Value
5672 is the ID of the face found. If no suitable face is found, realize
5673 a new one. In that case, if C is a multibyte character, BASE_FACE
5674 is a face that has the same attributes. */
5677 lookup_face (f
, attr
, c
, base_face
)
5681 struct face
*base_face
;
5683 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5688 xassert (cache
!= NULL
);
5689 check_lface_attrs (attr
);
5691 /* Look up ATTR in the face cache. */
5692 hash
= lface_hash (attr
);
5693 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5695 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
5696 if (face
->hash
== hash
5697 && (!FRAME_WINDOW_P (f
)
5698 || FACE_SUITABLE_FOR_CHAR_P (face
, c
))
5699 && lface_equal_p (face
->lface
, attr
))
5702 /* If not found, realize a new face. */
5704 face
= realize_face (cache
, attr
, c
, base_face
, -1);
5707 xassert (face
== FACE_FROM_ID (f
, face
->id
));
5709 /* When this function is called from face_for_char (in this case, C is
5710 a multibyte character), a fontset of a face returned by
5711 realize_face is not yet set, i.e. FACE_SUITABLE_FOR_CHAR_P (FACE,
5712 C) is not sutisfied. The fontset is set for this face by
5713 face_for_char later. */
5715 if (FRAME_WINDOW_P (f
))
5716 xassert (FACE_SUITABLE_FOR_CHAR_P (face
, c
));
5718 #endif /* GLYPH_DEBUG */
5724 /* Return the face id of the realized face for named face SYMBOL on
5725 frame F suitable for displaying character C. Value is -1 if the
5726 face couldn't be determined, which might happen if the default face
5727 isn't realized and cannot be realized. */
5730 lookup_named_face (f
, symbol
, c
, signal_p
)
5736 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5737 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5738 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5740 if (default_face
== NULL
)
5742 if (!realize_basic_faces (f
))
5744 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5747 if (!get_lface_attributes (f
, symbol
, symbol_attrs
, signal_p
))
5750 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
5751 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
5753 return lookup_face (f
, attrs
, c
, NULL
);
5757 /* Return the ID of the realized ASCII face of Lisp face with ID
5758 LFACE_ID on frame F. Value is -1 if LFACE_ID isn't valid. */
5761 ascii_face_of_lisp_face (f
, lface_id
)
5767 if (lface_id
>= 0 && lface_id
< lface_id_to_name_size
)
5769 Lisp_Object face_name
= lface_id_to_name
[lface_id
];
5770 face_id
= lookup_named_face (f
, face_name
, 0, 1);
5779 /* Return a face for charset ASCII that is like the face with id
5780 FACE_ID on frame F, but has a font that is STEPS steps smaller.
5781 STEPS < 0 means larger. Value is the id of the face. */
5784 smaller_face (f
, face_id
, steps
)
5788 #ifdef HAVE_WINDOW_SYSTEM
5790 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5791 int pt
, last_pt
, last_height
;
5794 struct face
*new_face
;
5796 /* If not called for an X frame, just return the original face. */
5797 if (FRAME_TERMCAP_P (f
))
5800 /* Try in increments of 1/2 pt. */
5801 delta
= steps
< 0 ? 5 : -5;
5802 steps
= abs (steps
);
5804 face
= FACE_FROM_ID (f
, face_id
);
5805 bcopy (face
->lface
, attrs
, sizeof attrs
);
5806 pt
= last_pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
5807 new_face_id
= face_id
;
5808 last_height
= FONT_HEIGHT (face
->font
);
5812 /* Give up if we cannot find a font within 10pt. */
5813 && abs (last_pt
- pt
) < 100)
5815 /* Look up a face for a slightly smaller/larger font. */
5817 attrs
[LFACE_HEIGHT_INDEX
] = make_number (pt
);
5818 new_face_id
= lookup_face (f
, attrs
, 0, NULL
);
5819 new_face
= FACE_FROM_ID (f
, new_face_id
);
5821 /* If height changes, count that as one step. */
5822 if ((delta
< 0 && FONT_HEIGHT (new_face
->font
) < last_height
)
5823 || (delta
> 0 && FONT_HEIGHT (new_face
->font
) > last_height
))
5826 last_height
= FONT_HEIGHT (new_face
->font
);
5833 #else /* not HAVE_WINDOW_SYSTEM */
5837 #endif /* not HAVE_WINDOW_SYSTEM */
5841 /* Return a face for charset ASCII that is like the face with id
5842 FACE_ID on frame F, but has height HEIGHT. */
5845 face_with_height (f
, face_id
, height
)
5850 #ifdef HAVE_WINDOW_SYSTEM
5852 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5854 if (FRAME_TERMCAP_P (f
)
5858 face
= FACE_FROM_ID (f
, face_id
);
5859 bcopy (face
->lface
, attrs
, sizeof attrs
);
5860 attrs
[LFACE_HEIGHT_INDEX
] = make_number (height
);
5861 face_id
= lookup_face (f
, attrs
, 0, NULL
);
5862 #endif /* HAVE_WINDOW_SYSTEM */
5868 /* Return the face id of the realized face for named face SYMBOL on
5869 frame F suitable for displaying character C, and use attributes of
5870 the face FACE_ID for attributes that aren't completely specified by
5871 SYMBOL. This is like lookup_named_face, except that the default
5872 attributes come from FACE_ID, not from the default face. FACE_ID
5873 is assumed to be already realized. */
5876 lookup_derived_face (f
, symbol
, c
, face_id
, signal_p
)
5883 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5884 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5885 struct face
*default_face
= FACE_FROM_ID (f
, face_id
);
5890 get_lface_attributes (f
, symbol
, symbol_attrs
, signal_p
);
5891 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
5892 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
5893 return lookup_face (f
, attrs
, c
, default_face
);
5896 DEFUN ("face-attributes-as-vector", Fface_attributes_as_vector
,
5897 Sface_attributes_as_vector
, 1, 1, 0,
5898 doc
: /* Return a vector of face attributes corresponding to PLIST. */)
5903 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
5905 merge_face_ref (XFRAME (selected_frame
), plist
, XVECTOR (lface
)->contents
,
5912 /***********************************************************************
5913 Face capability testing
5914 ***********************************************************************/
5917 /* If the distance (as returned by color_distance) between two colors is
5918 less than this, then they are considered the same, for determining
5919 whether a color is supported or not. The range of values is 0-65535. */
5921 #define TTY_SAME_COLOR_THRESHOLD 10000
5923 #ifdef HAVE_WINDOW_SYSTEM
5925 /* Return non-zero if all the face attributes in ATTRS are supported
5926 on the window-system frame F.
5928 The definition of `supported' is somewhat heuristic, but basically means
5929 that a face containing all the attributes in ATTRS, when merged with the
5930 default face for display, can be represented in a way that's
5932 \(1) different in appearance than the default face, and
5933 \(2) `close in spirit' to what the attributes specify, if not exact. */
5936 x_supports_face_attributes_p (f
, attrs
, def_face
)
5939 struct face
*def_face
;
5941 Lisp_Object
*def_attrs
= def_face
->lface
;
5943 /* Check that other specified attributes are different that the default
5945 if ((!UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
5946 && face_attr_equal_p (attrs
[LFACE_UNDERLINE_INDEX
],
5947 def_attrs
[LFACE_UNDERLINE_INDEX
]))
5948 || (!UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
5949 && face_attr_equal_p (attrs
[LFACE_INVERSE_INDEX
],
5950 def_attrs
[LFACE_INVERSE_INDEX
]))
5951 || (!UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
5952 && face_attr_equal_p (attrs
[LFACE_FOREGROUND_INDEX
],
5953 def_attrs
[LFACE_FOREGROUND_INDEX
]))
5954 || (!UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
5955 && face_attr_equal_p (attrs
[LFACE_BACKGROUND_INDEX
],
5956 def_attrs
[LFACE_BACKGROUND_INDEX
]))
5957 || (!UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
5958 && face_attr_equal_p (attrs
[LFACE_STIPPLE_INDEX
],
5959 def_attrs
[LFACE_STIPPLE_INDEX
]))
5960 || (!UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
5961 && face_attr_equal_p (attrs
[LFACE_OVERLINE_INDEX
],
5962 def_attrs
[LFACE_OVERLINE_INDEX
]))
5963 || (!UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
5964 && face_attr_equal_p (attrs
[LFACE_STRIKE_THROUGH_INDEX
],
5965 def_attrs
[LFACE_STRIKE_THROUGH_INDEX
]))
5966 || (!UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
5967 && face_attr_equal_p (attrs
[LFACE_BOX_INDEX
],
5968 def_attrs
[LFACE_BOX_INDEX
])))
5971 /* Check font-related attributes, as those are the most commonly
5972 "unsupported" on a window-system (because of missing fonts). */
5973 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
5974 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
5975 || !UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
5976 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
5977 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
5978 || !UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
]))
5981 Lisp_Object merged_attrs
[LFACE_VECTOR_SIZE
];
5983 bcopy (def_attrs
, merged_attrs
, sizeof merged_attrs
);
5985 merge_face_vectors (f
, attrs
, merged_attrs
, 0);
5987 face
= FACE_FROM_ID (f
, lookup_face (f
, merged_attrs
, 0, 0));
5990 error ("Cannot make face");
5992 /* If the font is the same, then not supported. */
5993 if (face
->font
== def_face
->font
)
5997 /* Everything checks out, this face is supported. */
6001 #endif /* HAVE_WINDOW_SYSTEM */
6003 /* Return non-zero if all the face attributes in ATTRS are supported
6006 The definition of `supported' is somewhat heuristic, but basically means
6007 that a face containing all the attributes in ATTRS, when merged
6008 with the default face for display, can be represented in a way that's
6010 \(1) different in appearance than the default face, and
6011 \(2) `close in spirit' to what the attributes specify, if not exact.
6013 Point (2) implies that a `:weight black' attribute will be satisfied
6014 by any terminal that can display bold, and a `:foreground "yellow"' as
6015 long as the terminal can display a yellowish color, but `:slant italic'
6016 will _not_ be satisfied by the tty display code's automatic
6017 substitution of a `dim' face for italic. */
6020 tty_supports_face_attributes_p (f
, attrs
, def_face
)
6023 struct face
*def_face
;
6026 Lisp_Object val
, fg
, bg
;
6027 XColor fg_tty_color
, fg_std_color
;
6028 XColor bg_tty_color
, bg_std_color
;
6029 unsigned test_caps
= 0;
6030 Lisp_Object
*def_attrs
= def_face
->lface
;
6033 /* First check some easy-to-check stuff; ttys support none of the
6034 following attributes, so we can just return false if any are requested
6035 (even if `nominal' values are specified, we should still return false,
6036 as that will be the same value that the default face uses). We
6037 consider :slant unsupportable on ttys, even though the face code
6038 actually `fakes' them using a dim attribute if possible. This is
6039 because the faked result is too different from what the face
6041 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
6042 || !UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
6043 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
6044 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
6045 || !UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
6046 || !UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
6047 || !UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
6048 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
]))
6052 /* Test for terminal `capabilities' (non-color character attributes). */
6054 /* font weight (bold/dim) */
6055 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
6058 int def_weight
= face_numeric_weight (def_attrs
[LFACE_WEIGHT_INDEX
]);
6060 if (weight
> XLFD_WEIGHT_MEDIUM
)
6062 if (def_weight
> XLFD_WEIGHT_MEDIUM
)
6063 return 0; /* same as default */
6064 test_caps
= TTY_CAP_BOLD
;
6066 else if (weight
< XLFD_WEIGHT_MEDIUM
)
6068 if (def_weight
< XLFD_WEIGHT_MEDIUM
)
6069 return 0; /* same as default */
6070 test_caps
= TTY_CAP_DIM
;
6072 else if (def_weight
== XLFD_WEIGHT_MEDIUM
)
6073 return 0; /* same as default */
6077 val
= attrs
[LFACE_UNDERLINE_INDEX
];
6078 if (!UNSPECIFIEDP (val
))
6081 return 0; /* ttys can't use colored underlines */
6082 else if (face_attr_equal_p (val
, def_attrs
[LFACE_UNDERLINE_INDEX
]))
6083 return 0; /* same as default */
6085 test_caps
|= TTY_CAP_UNDERLINE
;
6089 val
= attrs
[LFACE_INVERSE_INDEX
];
6090 if (!UNSPECIFIEDP (val
))
6092 if (face_attr_equal_p (val
, def_attrs
[LFACE_UNDERLINE_INDEX
]))
6093 return 0; /* same as default */
6095 test_caps
|= TTY_CAP_INVERSE
;
6099 /* Color testing. */
6101 /* Default the color indices in FG_TTY_COLOR and BG_TTY_COLOR, since
6102 we use them when calling `tty_capable_p' below, even if the face
6103 specifies no colors. */
6104 fg_tty_color
.pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
6105 bg_tty_color
.pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
6107 /* Check if foreground color is close enough. */
6108 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
6111 Lisp_Object def_fg
= def_attrs
[LFACE_FOREGROUND_INDEX
];
6113 if (face_attr_equal_p (fg
, def_fg
))
6114 return 0; /* same as default */
6115 else if (! tty_lookup_color (f
, fg
, &fg_tty_color
, &fg_std_color
))
6116 return 0; /* not a valid color */
6117 else if (color_distance (&fg_tty_color
, &fg_std_color
)
6118 > TTY_SAME_COLOR_THRESHOLD
)
6119 return 0; /* displayed color is too different */
6121 /* Make sure the color is really different than the default. */
6123 XColor def_fg_color
;
6124 if (tty_lookup_color (f
, def_fg
, &def_fg_color
, 0)
6125 && (color_distance (&fg_tty_color
, &def_fg_color
)
6126 <= TTY_SAME_COLOR_THRESHOLD
))
6131 /* Check if background color is close enough. */
6132 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
6135 Lisp_Object def_bg
= def_attrs
[LFACE_FOREGROUND_INDEX
];
6137 if (face_attr_equal_p (bg
, def_bg
))
6138 return 0; /* same as default */
6139 else if (! tty_lookup_color (f
, bg
, &bg_tty_color
, &bg_std_color
))
6140 return 0; /* not a valid color */
6141 else if (color_distance (&bg_tty_color
, &bg_std_color
)
6142 > TTY_SAME_COLOR_THRESHOLD
)
6143 return 0; /* displayed color is too different */
6145 /* Make sure the color is really different than the default. */
6147 XColor def_bg_color
;
6148 if (tty_lookup_color (f
, def_bg
, &def_bg_color
, 0)
6149 && (color_distance (&bg_tty_color
, &def_bg_color
)
6150 <= TTY_SAME_COLOR_THRESHOLD
))
6155 /* If both foreground and background are requested, see if the
6156 distance between them is OK. We just check to see if the distance
6157 between the tty's foreground and background is close enough to the
6158 distance between the standard foreground and background. */
6159 if (STRINGP (fg
) && STRINGP (bg
))
6162 = (color_distance (&fg_std_color
, &bg_std_color
)
6163 - color_distance (&fg_tty_color
, &bg_tty_color
));
6164 if (delta_delta
> TTY_SAME_COLOR_THRESHOLD
6165 || delta_delta
< -TTY_SAME_COLOR_THRESHOLD
)
6170 /* See if the capabilities we selected above are supported, with the
6172 if (test_caps
!= 0 &&
6173 ! tty_capable_p (FRAME_TTY (f
), test_caps
, fg_tty_color
.pixel
, bg_tty_color
.pixel
))
6177 /* Hmmm, everything checks out, this terminal must support this face. */
6182 DEFUN ("display-supports-face-attributes-p",
6183 Fdisplay_supports_face_attributes_p
, Sdisplay_supports_face_attributes_p
,
6185 doc
: /* Return non-nil if all the face attributes in ATTRIBUTES are supported.
6186 The optional argument DISPLAY can be a display name, a frame, or
6187 nil (meaning the selected frame's display).
6189 The definition of `supported' is somewhat heuristic, but basically means
6190 that a face containing all the attributes in ATTRIBUTES, when merged
6191 with the default face for display, can be represented in a way that's
6193 \(1) different in appearance than the default face, and
6194 \(2) `close in spirit' to what the attributes specify, if not exact.
6196 Point (2) implies that a `:weight black' attribute will be satisfied by
6197 any display that can display bold, and a `:foreground \"yellow\"' as long
6198 as it can display a yellowish color, but `:slant italic' will _not_ be
6199 satisfied by the tty display code's automatic substitution of a `dim'
6200 face for italic. */)
6201 (attributes
, display
)
6202 Lisp_Object attributes
, display
;
6207 struct face
*def_face
;
6208 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6210 if (noninteractive
|| !initialized
)
6211 /* We may not be able to access low-level face information in batch
6212 mode, or before being dumped, and this function is not going to
6213 be very useful in those cases anyway, so just give up. */
6217 frame
= selected_frame
;
6218 else if (FRAMEP (display
))
6222 /* Find any frame on DISPLAY. */
6223 Lisp_Object fl_tail
;
6226 for (fl_tail
= Vframe_list
; CONSP (fl_tail
); fl_tail
= XCDR (fl_tail
))
6228 frame
= XCAR (fl_tail
);
6229 if (!NILP (Fequal (Fcdr (Fassq (Qdisplay
,
6230 XFRAME (frame
)->param_alist
)),
6236 CHECK_LIVE_FRAME (frame
);
6239 for (i
= 0; i
< LFACE_VECTOR_SIZE
; i
++)
6240 attrs
[i
] = Qunspecified
;
6241 merge_face_ref (f
, attributes
, attrs
, 1, 0);
6243 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6244 if (def_face
== NULL
)
6246 if (! realize_basic_faces (f
))
6247 error ("Cannot realize default face");
6248 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6251 /* Dispatch to the appropriate handler. */
6252 if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
6253 supports
= tty_supports_face_attributes_p (f
, attrs
, def_face
);
6254 #ifdef HAVE_WINDOW_SYSTEM
6256 supports
= x_supports_face_attributes_p (f
, attrs
, def_face
);
6259 return supports
? Qt
: Qnil
;
6263 /***********************************************************************
6265 ***********************************************************************/
6267 DEFUN ("internal-set-font-selection-order",
6268 Finternal_set_font_selection_order
,
6269 Sinternal_set_font_selection_order
, 1, 1, 0,
6270 doc
: /* Set font selection order for face font selection to ORDER.
6271 ORDER must be a list of length 4 containing the symbols `:width',
6272 `:height', `:weight', and `:slant'. Face attributes appearing
6273 first in ORDER are matched first, e.g. if `:height' appears before
6274 `:weight' in ORDER, font selection first tries to find a font with
6275 a suitable height, and then tries to match the font weight.
6282 int indices
[DIM (font_sort_order
)];
6285 bzero (indices
, sizeof indices
);
6289 CONSP (list
) && i
< DIM (indices
);
6290 list
= XCDR (list
), ++i
)
6292 Lisp_Object attr
= XCAR (list
);
6295 if (EQ (attr
, QCwidth
))
6297 else if (EQ (attr
, QCheight
))
6298 xlfd
= XLFD_POINT_SIZE
;
6299 else if (EQ (attr
, QCweight
))
6301 else if (EQ (attr
, QCslant
))
6306 if (indices
[i
] != 0)
6311 if (!NILP (list
) || i
!= DIM (indices
))
6312 signal_error ("Invalid font sort order", order
);
6313 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6314 if (indices
[i
] == 0)
6315 signal_error ("Invalid font sort order", order
);
6317 if (bcmp (indices
, font_sort_order
, sizeof indices
) != 0)
6319 bcopy (indices
, font_sort_order
, sizeof font_sort_order
);
6320 free_all_realized_faces (Qnil
);
6327 DEFUN ("internal-set-alternative-font-family-alist",
6328 Finternal_set_alternative_font_family_alist
,
6329 Sinternal_set_alternative_font_family_alist
, 1, 1, 0,
6330 doc
: /* Define alternative font families to try in face font selection.
6331 ALIST is an alist of (FAMILY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6332 Each ALTERNATIVE is tried in order if no fonts of font family FAMILY can
6333 be found. Value is ALIST. */)
6338 Vface_alternative_font_family_alist
= alist
;
6339 free_all_realized_faces (Qnil
);
6344 DEFUN ("internal-set-alternative-font-registry-alist",
6345 Finternal_set_alternative_font_registry_alist
,
6346 Sinternal_set_alternative_font_registry_alist
, 1, 1, 0,
6347 doc
: /* Define alternative font registries to try in face font selection.
6348 ALIST is an alist of (REGISTRY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6349 Each ALTERNATIVE is tried in order if no fonts of font registry REGISTRY can
6350 be found. Value is ALIST. */)
6355 Vface_alternative_font_registry_alist
= alist
;
6356 free_all_realized_faces (Qnil
);
6361 #ifdef HAVE_WINDOW_SYSTEM
6363 /* Value is non-zero if FONT is the name of a scalable font. The
6364 X11R6 XLFD spec says that point size, pixel size, and average width
6365 are zero for scalable fonts. Intlfonts contain at least one
6366 scalable font ("*-muleindian-1") for which this isn't true, so we
6367 just test average width. */
6370 font_scalable_p (font
)
6371 struct font_name
*font
;
6373 char *s
= font
->fields
[XLFD_AVGWIDTH
];
6374 return (*s
== '0' && *(s
+ 1) == '\0')
6376 /* Windows implementation of XLFD is slightly broken for backward
6377 compatibility with previous broken versions, so test for
6378 wildcards as well as 0. */
6385 /* Ignore the difference of font point size less than this value. */
6387 #define FONT_POINT_SIZE_QUANTUM 5
6389 /* Value is non-zero if FONT1 is a better match for font attributes
6390 VALUES than FONT2. VALUES is an array of face attribute values in
6391 font sort order. COMPARE_PT_P zero means don't compare point
6392 sizes. AVGWIDTH, if not zero, is a specified font average width
6396 better_font_p (values
, font1
, font2
, compare_pt_p
, avgwidth
)
6398 struct font_name
*font1
, *font2
;
6399 int compare_pt_p
, avgwidth
;
6403 /* Any font is better than no font. */
6409 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6411 int xlfd_idx
= font_sort_order
[i
];
6413 if (compare_pt_p
|| xlfd_idx
!= XLFD_POINT_SIZE
)
6417 if (xlfd_idx
== XLFD_POINT_SIZE
)
6419 delta1
= abs (values
[i
] - (font1
->numeric
[xlfd_idx
]
6420 / font1
->rescale_ratio
));
6421 delta2
= abs (values
[i
] - (font2
->numeric
[xlfd_idx
]
6422 / font2
->rescale_ratio
));
6423 if (abs (delta1
- delta2
) < FONT_POINT_SIZE_QUANTUM
)
6428 delta1
= abs (values
[i
] - font1
->numeric
[xlfd_idx
]);
6429 delta2
= abs (values
[i
] - font2
->numeric
[xlfd_idx
]);
6432 if (delta1
> delta2
)
6434 else if (delta1
< delta2
)
6438 /* The difference may be equal because, e.g., the face
6439 specifies `italic' but we have only `regular' and
6440 `oblique'. Prefer `oblique' in this case. */
6441 if ((xlfd_idx
== XLFD_WEIGHT
|| xlfd_idx
== XLFD_SLANT
)
6442 && font1
->numeric
[xlfd_idx
] > values
[i
]
6443 && font2
->numeric
[xlfd_idx
] < values
[i
])
6451 int delta1
= abs (avgwidth
- font1
->numeric
[XLFD_AVGWIDTH
]);
6452 int delta2
= abs (avgwidth
- font2
->numeric
[XLFD_AVGWIDTH
]);
6453 if (delta1
> delta2
)
6455 else if (delta1
< delta2
)
6461 /* We prefer a real scalable font; i.e. not what autoscaled. */
6462 int auto_scaled_1
= (font1
->numeric
[XLFD_POINT_SIZE
] == 0
6463 && font1
->numeric
[XLFD_RESY
] > 0);
6464 int auto_scaled_2
= (font2
->numeric
[XLFD_POINT_SIZE
] == 0
6465 && font2
->numeric
[XLFD_RESY
] > 0);
6467 if (auto_scaled_1
!= auto_scaled_2
)
6468 return auto_scaled_2
;
6471 return font1
->registry_priority
< font2
->registry_priority
;
6475 /* Value is non-zero if FONT is an exact match for face attributes in
6476 SPECIFIED. SPECIFIED is an array of face attribute values in font
6477 sort order. AVGWIDTH, if non-zero, is an average width to compare
6481 exact_face_match_p (specified
, font
, avgwidth
)
6483 struct font_name
*font
;
6488 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6489 if (specified
[i
] != font
->numeric
[font_sort_order
[i
]])
6492 return (i
== DIM (font_sort_order
)
6494 || avgwidth
== font
->numeric
[XLFD_AVGWIDTH
]));
6498 /* Value is the name of a scaled font, generated from scalable font
6499 FONT on frame F. SPECIFIED_PT is the point-size to scale FONT to.
6500 Value is allocated from heap. */
6503 build_scalable_font_name (f
, font
, specified_pt
)
6505 struct font_name
*font
;
6508 char pixel_size
[20];
6510 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
6513 /* If scalable font is for a specific resolution, compute
6514 the point size we must specify from the resolution of
6515 the display and the specified resolution of the font. */
6516 if (font
->numeric
[XLFD_RESY
] != 0)
6518 pt
= resy
/ font
->numeric
[XLFD_RESY
] * specified_pt
+ 0.5;
6519 pixel_value
= font
->numeric
[XLFD_RESY
] / (PT_PER_INCH
* 10.0) * pt
+ 0.5;
6524 pixel_value
= resy
/ (PT_PER_INCH
* 10.0) * pt
+ 0.5;
6526 /* We may need a font of the different size. */
6527 pixel_value
*= font
->rescale_ratio
;
6529 /* We should keep POINT_SIZE 0. Otherwise, X server can't open a
6530 font of the specified PIXEL_SIZE. */
6532 { /* Set point size of the font. */
6533 char point_size
[20];
6534 sprintf (point_size
, "%d", (int) pt
);
6535 font
->fields
[XLFD_POINT_SIZE
] = point_size
;
6536 font
->numeric
[XLFD_POINT_SIZE
] = pt
;
6540 /* Set pixel size. */
6541 sprintf (pixel_size
, "%d", pixel_value
);
6542 font
->fields
[XLFD_PIXEL_SIZE
] = pixel_size
;
6543 font
->numeric
[XLFD_PIXEL_SIZE
] = pixel_value
;
6545 /* If font doesn't specify its resolution, use the
6546 resolution of the display. */
6547 if (font
->numeric
[XLFD_RESY
] == 0)
6550 sprintf (buffer
, "%d", (int) resy
);
6551 font
->fields
[XLFD_RESY
] = buffer
;
6552 font
->numeric
[XLFD_RESY
] = resy
;
6555 if (strcmp (font
->fields
[XLFD_RESX
], "0") == 0)
6558 int resx
= FRAME_X_DISPLAY_INFO (f
)->resx
;
6559 sprintf (buffer
, "%d", resx
);
6560 font
->fields
[XLFD_RESX
] = buffer
;
6561 font
->numeric
[XLFD_RESX
] = resx
;
6564 return build_font_name (font
);
6568 /* Value is non-zero if we are allowed to use scalable font FONT. We
6569 can't run a Lisp function here since this function may be called
6570 with input blocked. */
6573 may_use_scalable_font_p (font
)
6576 if (EQ (Vscalable_fonts_allowed
, Qt
))
6578 else if (CONSP (Vscalable_fonts_allowed
))
6580 Lisp_Object tail
, regexp
;
6582 for (tail
= Vscalable_fonts_allowed
; CONSP (tail
); tail
= XCDR (tail
))
6584 regexp
= XCAR (tail
);
6585 if (STRINGP (regexp
)
6586 && fast_c_string_match_ignore_case (regexp
, font
) >= 0)
6596 /* Return the name of the best matching font for face attributes ATTRS
6597 in the array of font_name structures FONTS which contains NFONTS
6598 elements. WIDTH_RATIO is a factor with which to multiply average
6599 widths if ATTRS specifies such a width.
6601 Value is a font name which is allocated from the heap. FONTS is
6602 freed by this function.
6604 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
6605 indicate whether the resulting font should be drawn using overstrike
6606 to simulate bold-face. */
6609 best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
, needs_overstrike
)
6612 struct font_name
*fonts
;
6615 int *needs_overstrike
;
6618 struct font_name
*best
;
6621 int exact_p
, avgwidth
;
6626 /* Make specified font attributes available in `specified',
6627 indexed by sort order. */
6628 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6630 int xlfd_idx
= font_sort_order
[i
];
6632 if (xlfd_idx
== XLFD_SWIDTH
)
6633 specified
[i
] = face_numeric_swidth (attrs
[LFACE_SWIDTH_INDEX
]);
6634 else if (xlfd_idx
== XLFD_POINT_SIZE
)
6635 specified
[i
] = pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
6636 else if (xlfd_idx
== XLFD_WEIGHT
)
6637 specified
[i
] = face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
6638 else if (xlfd_idx
== XLFD_SLANT
)
6639 specified
[i
] = face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
6644 avgwidth
= (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
6646 : XFASTINT (attrs
[LFACE_AVGWIDTH_INDEX
]) * width_ratio
);
6650 if (needs_overstrike
)
6651 *needs_overstrike
= 0;
6655 /* Find the best match among the non-scalable fonts. */
6656 for (i
= 0; i
< nfonts
; ++i
)
6657 if (!font_scalable_p (fonts
+ i
)
6658 && better_font_p (specified
, fonts
+ i
, best
, 1, avgwidth
))
6662 exact_p
= exact_face_match_p (specified
, best
, avgwidth
);
6667 /* Unless we found an exact match among non-scalable fonts, see if
6668 we can find a better match among scalable fonts. */
6671 /* A scalable font is better if
6673 1. its weight, slant, swidth attributes are better, or.
6675 2. the best non-scalable font doesn't have the required
6676 point size, and the scalable fonts weight, slant, swidth
6679 int non_scalable_has_exact_height_p
;
6681 if (best
&& best
->numeric
[XLFD_POINT_SIZE
] == pt
)
6682 non_scalable_has_exact_height_p
= 1;
6684 non_scalable_has_exact_height_p
= 0;
6686 for (i
= 0; i
< nfonts
; ++i
)
6687 if (font_scalable_p (fonts
+ i
))
6689 if (better_font_p (specified
, fonts
+ i
, best
, 0, 0)
6690 || (!non_scalable_has_exact_height_p
6691 && !better_font_p (specified
, best
, fonts
+ i
, 0, 0)))
6693 non_scalable_has_exact_height_p
= 1;
6699 /* We should have found SOME font. */
6703 if (! exact_p
&& needs_overstrike
)
6705 enum xlfd_weight want_weight
= specified
[XLFD_WEIGHT
];
6706 enum xlfd_weight got_weight
= best
->numeric
[XLFD_WEIGHT
];
6708 if (want_weight
> XLFD_WEIGHT_MEDIUM
&& want_weight
> got_weight
)
6710 /* We want a bold font, but didn't get one; try to use
6711 overstriking instead to simulate bold-face. However,
6712 don't overstrike an already-bold fontn unless the
6713 desired weight grossly exceeds the available weight. */
6714 if (got_weight
> XLFD_WEIGHT_MEDIUM
)
6715 *needs_overstrike
= (got_weight
- want_weight
) > 2;
6717 *needs_overstrike
= 1;
6721 if (font_scalable_p (best
))
6722 font_name
= build_scalable_font_name (f
, best
, pt
);
6724 font_name
= build_font_name (best
);
6726 /* Free font_name structures. */
6727 free_font_names (fonts
, nfonts
);
6733 /* Get a list of matching fonts on frame F, considering FAMILY
6734 and alternative font families from Vface_alternative_font_registry_alist.
6736 FAMILY is the font family whose alternatives are considered.
6738 REGISTRY, if a string, specifies a font registry and encoding to
6739 match. A value of nil means include fonts of any registry and
6742 Return in *FONTS a pointer to a vector of font_name structures for
6743 the fonts matched. Value is the number of fonts found. */
6746 try_alternative_families (f
, family
, registry
, fonts
)
6748 Lisp_Object family
, registry
;
6749 struct font_name
**fonts
;
6754 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
6757 /* Try alternative font families. */
6758 alter
= Fassoc (family
, Vface_alternative_font_family_alist
);
6761 for (alter
= XCDR (alter
);
6762 CONSP (alter
) && nfonts
== 0;
6763 alter
= XCDR (alter
))
6765 if (STRINGP (XCAR (alter
)))
6766 nfonts
= font_list (f
, Qnil
, XCAR (alter
), registry
, fonts
);
6770 /* Try all scalable fonts before giving up. */
6771 if (nfonts
== 0 && ! EQ (Vscalable_fonts_allowed
, Qt
))
6773 int count
= SPECPDL_INDEX ();
6774 specbind (Qscalable_fonts_allowed
, Qt
);
6775 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6776 unbind_to (count
, Qnil
);
6783 /* Get a list of matching fonts on frame F.
6785 FAMILY, if a string, specifies a font family derived from the fontset.
6786 It is only used if the face does not specify any family in ATTRS or
6787 if we cannot find any font of the face's family.
6789 REGISTRY, if a string, specifies a font registry and encoding to
6790 match. A value of nil means include fonts of any registry and
6793 If PREFER_FACE_FAMILY is nonzero, perfer face's family to FAMILY.
6794 Otherwise, prefer FAMILY.
6796 Return in *FONTS a pointer to a vector of font_name structures for
6797 the fonts matched. Value is the number of fonts found. */
6800 try_font_list (f
, attrs
, family
, registry
, fonts
, prefer_face_family
)
6803 Lisp_Object family
, registry
;
6804 struct font_name
**fonts
;
6805 int prefer_face_family
;
6808 Lisp_Object face_family
= attrs
[LFACE_FAMILY_INDEX
];
6809 Lisp_Object try_family
;
6811 try_family
= (prefer_face_family
|| NILP (family
)) ? face_family
: family
;
6813 if (STRINGP (try_family
))
6814 nfonts
= try_alternative_families (f
, try_family
, registry
, fonts
);
6817 if (nfonts
== 0 && STRINGP (try_family
) && STRINGP (registry
))
6819 if (xstricmp (SDATA (registry
), "mac-roman") == 0)
6820 /* When realizing the default face and a font spec does not
6821 matched exactly, Emacs looks for ones with the same registry
6822 as the default font. On the Mac, this is mac-roman, which
6823 does not work if the family is -etl-fixed, e.g. The
6824 following widens the choices and fixes that problem. */
6825 nfonts
= try_alternative_families (f
, try_family
, Qnil
, fonts
);
6826 else if (SBYTES (try_family
) > 0
6827 && SREF (try_family
, SBYTES (try_family
) - 1) != '*')
6828 /* Some Central European/Cyrillic font family names have the
6829 Roman counterpart name as their prefix. */
6830 nfonts
= try_alternative_families (f
, concat2 (try_family
,
6831 build_string ("*")),
6836 if (EQ (try_family
, family
))
6837 family
= face_family
;
6839 if (nfonts
== 0 && STRINGP (family
))
6840 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6842 /* Try font family of the default face or "fixed". */
6845 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6847 family
= default_face
->lface
[LFACE_FAMILY_INDEX
];
6849 family
= build_string ("fixed");
6850 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
6853 /* Try any family with the given registry. */
6855 nfonts
= try_alternative_families (f
, Qnil
, registry
, fonts
);
6861 /* Return the fontset id of the base fontset name or alias name given
6862 by the fontset attribute of ATTRS. Value is -1 if the fontset
6863 attribute of ATTRS doesn't name a fontset. */
6866 face_fontset (attrs
)
6871 name
= attrs
[LFACE_FONT_INDEX
];
6872 if (!STRINGP (name
))
6874 return fs_query_fontset (name
, 0);
6878 /* Choose a name of font to use on frame F to display character C with
6879 Lisp face attributes specified by ATTRS. The font name is
6880 determined by the font-related attributes in ATTRS and the name
6881 pattern for C in FONTSET. Value is the font name which is
6882 allocated from the heap and must be freed by the caller, or NULL if
6883 we can get no information about the font name of C. It is assured
6884 that we always get some information for a single byte
6887 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
6888 indicate whether the resulting font should be drawn using overstrike
6889 to simulate bold-face. */
6892 choose_face_font (f
, attrs
, fontset
, c
, needs_overstrike
)
6896 int *needs_overstrike
;
6898 Lisp_Object pattern
;
6899 char *font_name
= NULL
;
6900 struct font_name
*fonts
;
6901 int nfonts
, width_ratio
;
6903 if (needs_overstrike
)
6904 *needs_overstrike
= 0;
6906 /* Get (foundry and) family name and registry (and encoding) name of
6908 pattern
= fontset_font_pattern (f
, fontset
, c
);
6911 xassert (!SINGLE_BYTE_CHAR_P (c
));
6915 /* If what we got is a name pattern, return it. */
6916 if (STRINGP (pattern
))
6917 return xstrdup (SDATA (pattern
));
6919 /* Get a list of fonts matching that pattern and choose the
6920 best match for the specified face attributes from it. */
6921 nfonts
= try_font_list (f
, attrs
, XCAR (pattern
), XCDR (pattern
), &fonts
,
6922 (SINGLE_BYTE_CHAR_P (c
)
6923 || CHAR_CHARSET (c
) == charset_latin_iso8859_1
));
6924 width_ratio
= (SINGLE_BYTE_CHAR_P (c
)
6926 : CHARSET_WIDTH (CHAR_CHARSET (c
)));
6927 font_name
= best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
,
6932 #endif /* HAVE_WINDOW_SYSTEM */
6936 /***********************************************************************
6938 ***********************************************************************/
6940 /* Realize basic faces on frame F. Value is zero if frame parameters
6941 of F don't contain enough information needed to realize the default
6945 realize_basic_faces (f
)
6949 int count
= SPECPDL_INDEX ();
6951 /* Block input here so that we won't be surprised by an X expose
6952 event, for instance, without having the faces set up. */
6954 specbind (Qscalable_fonts_allowed
, Qt
);
6956 if (realize_default_face (f
))
6958 realize_named_face (f
, Qmode_line
, MODE_LINE_FACE_ID
);
6959 realize_named_face (f
, Qmode_line_inactive
, MODE_LINE_INACTIVE_FACE_ID
);
6960 realize_named_face (f
, Qtool_bar
, TOOL_BAR_FACE_ID
);
6961 realize_named_face (f
, Qfringe
, FRINGE_FACE_ID
);
6962 realize_named_face (f
, Qheader_line
, HEADER_LINE_FACE_ID
);
6963 realize_named_face (f
, Qscroll_bar
, SCROLL_BAR_FACE_ID
);
6964 realize_named_face (f
, Qborder
, BORDER_FACE_ID
);
6965 realize_named_face (f
, Qcursor
, CURSOR_FACE_ID
);
6966 realize_named_face (f
, Qmouse
, MOUSE_FACE_ID
);
6967 realize_named_face (f
, Qmenu
, MENU_FACE_ID
);
6968 realize_named_face (f
, Qvertical_border
, VERTICAL_BORDER_FACE_ID
);
6970 /* Reflect changes in the `menu' face in menu bars. */
6971 if (FRAME_FACE_CACHE (f
)->menu_face_changed_p
)
6973 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 0;
6974 #ifdef USE_X_TOOLKIT
6975 if (FRAME_WINDOW_P (f
))
6976 x_update_menu_appearance (f
);
6983 unbind_to (count
, Qnil
);
6989 /* Realize the default face on frame F. If the face is not fully
6990 specified, make it fully-specified. Attributes of the default face
6991 that are not explicitly specified are taken from frame parameters. */
6994 realize_default_face (f
)
6997 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
6999 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7000 Lisp_Object frame_font
;
7003 /* If the `default' face is not yet known, create it. */
7004 lface
= lface_from_face_name (f
, Qdefault
, 0);
7008 XSETFRAME (frame
, f
);
7009 lface
= Finternal_make_lisp_face (Qdefault
, frame
);
7013 #ifdef HAVE_WINDOW_SYSTEM
7014 if (FRAME_WINDOW_P (f
))
7016 /* Set frame_font to the value of the `font' frame parameter. */
7017 frame_font
= Fassq (Qfont
, f
->param_alist
);
7018 xassert (CONSP (frame_font
) && STRINGP (XCDR (frame_font
)));
7019 frame_font
= XCDR (frame_font
);
7020 set_lface_from_font_name (f
, lface
, frame_font
,
7021 f
->default_face_done_p
, 1);
7022 f
->default_face_done_p
= 1;
7024 #endif /* HAVE_WINDOW_SYSTEM */
7026 if (!FRAME_WINDOW_P (f
))
7028 LFACE_FAMILY (lface
) = build_string ("default");
7029 LFACE_SWIDTH (lface
) = Qnormal
;
7030 LFACE_HEIGHT (lface
) = make_number (1);
7031 if (UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
7032 LFACE_WEIGHT (lface
) = Qnormal
;
7033 if (UNSPECIFIEDP (LFACE_SLANT (lface
)))
7034 LFACE_SLANT (lface
) = Qnormal
;
7035 LFACE_AVGWIDTH (lface
) = Qunspecified
;
7038 if (UNSPECIFIEDP (LFACE_UNDERLINE (lface
)))
7039 LFACE_UNDERLINE (lface
) = Qnil
;
7041 if (UNSPECIFIEDP (LFACE_OVERLINE (lface
)))
7042 LFACE_OVERLINE (lface
) = Qnil
;
7044 if (UNSPECIFIEDP (LFACE_STRIKE_THROUGH (lface
)))
7045 LFACE_STRIKE_THROUGH (lface
) = Qnil
;
7047 if (UNSPECIFIEDP (LFACE_BOX (lface
)))
7048 LFACE_BOX (lface
) = Qnil
;
7050 if (UNSPECIFIEDP (LFACE_INVERSE (lface
)))
7051 LFACE_INVERSE (lface
) = Qnil
;
7053 if (UNSPECIFIEDP (LFACE_FOREGROUND (lface
)))
7055 /* This function is called so early that colors are not yet
7056 set in the frame parameter list. */
7057 Lisp_Object color
= Fassq (Qforeground_color
, f
->param_alist
);
7059 if (CONSP (color
) && STRINGP (XCDR (color
)))
7060 LFACE_FOREGROUND (lface
) = XCDR (color
);
7061 else if (FRAME_WINDOW_P (f
))
7063 else if (FRAME_INITIAL_P (f
) || FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
7064 LFACE_FOREGROUND (lface
) = build_string (unspecified_fg
);
7069 if (UNSPECIFIEDP (LFACE_BACKGROUND (lface
)))
7071 /* This function is called so early that colors are not yet
7072 set in the frame parameter list. */
7073 Lisp_Object color
= Fassq (Qbackground_color
, f
->param_alist
);
7074 if (CONSP (color
) && STRINGP (XCDR (color
)))
7075 LFACE_BACKGROUND (lface
) = XCDR (color
);
7076 else if (FRAME_WINDOW_P (f
))
7078 else if (FRAME_INITIAL_P (f
) || FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
7079 LFACE_BACKGROUND (lface
) = build_string (unspecified_bg
);
7084 if (UNSPECIFIEDP (LFACE_STIPPLE (lface
)))
7085 LFACE_STIPPLE (lface
) = Qnil
;
7087 /* Realize the face; it must be fully-specified now. */
7088 xassert (lface_fully_specified_p (XVECTOR (lface
)->contents
));
7089 check_lface (lface
);
7090 bcopy (XVECTOR (lface
)->contents
, attrs
, sizeof attrs
);
7091 face
= realize_face (c
, attrs
, 0, NULL
, DEFAULT_FACE_ID
);
7093 #ifdef HAVE_WINDOW_SYSTEM
7094 #ifdef HAVE_X_WINDOWS
7095 if (FRAME_X_P (f
) && face
->font
!= FRAME_FONT (f
))
7096 /* As the font specified for the frame was not acceptable as a
7097 font for the default face (perhaps because auto-scaled fonts
7098 are rejected), we must adjust the frame font. */
7099 x_set_font (f
, build_string (face
->font_name
), Qnil
);
7100 #endif /* HAVE_X_WINDOWS */
7101 #endif /* HAVE_WINDOW_SYSTEM */
7106 /* Realize basic faces other than the default face in face cache C.
7107 SYMBOL is the face name, ID is the face id the realized face must
7108 have. The default face must have been realized already. */
7111 realize_named_face (f
, symbol
, id
)
7116 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
7117 Lisp_Object lface
= lface_from_face_name (f
, symbol
, 0);
7118 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7119 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
7120 struct face
*new_face
;
7122 /* The default face must exist and be fully specified. */
7123 get_lface_attributes (f
, Qdefault
, attrs
, 1);
7124 check_lface_attrs (attrs
);
7125 xassert (lface_fully_specified_p (attrs
));
7127 /* If SYMBOL isn't know as a face, create it. */
7131 XSETFRAME (frame
, f
);
7132 lface
= Finternal_make_lisp_face (symbol
, frame
);
7135 /* Merge SYMBOL's face with the default face. */
7136 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
7137 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
7139 /* Realize the face. */
7140 new_face
= realize_face (c
, attrs
, 0, NULL
, id
);
7144 /* Realize the fully-specified face with attributes ATTRS in face
7145 cache CACHE for character C. If C is a multibyte character,
7146 BASE_FACE is a face that has the same attributes. Otherwise,
7147 BASE_FACE is ignored. If FORMER_FACE_ID is non-negative, it is an
7148 ID of face to remove before caching the new face. Value is a
7149 pointer to the newly created realized face. */
7151 static struct face
*
7152 realize_face (cache
, attrs
, c
, base_face
, former_face_id
)
7153 struct face_cache
*cache
;
7156 struct face
*base_face
;
7161 /* LFACE must be fully specified. */
7162 xassert (cache
!= NULL
);
7163 check_lface_attrs (attrs
);
7165 if (former_face_id
>= 0 && cache
->used
> former_face_id
)
7167 /* Remove the former face. */
7168 struct face
*former_face
= cache
->faces_by_id
[former_face_id
];
7169 uncache_face (cache
, former_face
);
7170 free_realized_face (cache
->f
, former_face
);
7173 if (FRAME_WINDOW_P (cache
->f
))
7174 face
= realize_x_face (cache
, attrs
, c
, base_face
);
7175 else if (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
))
7176 face
= realize_tty_face (cache
, attrs
, c
);
7177 else if (FRAME_INITIAL_P (cache
->f
))
7179 /* Create a dummy face. */
7180 face
= make_realized_face (attrs
);
7185 /* Insert the new face. */
7186 cache_face (cache
, face
, lface_hash (attrs
));
7187 #ifdef HAVE_WINDOW_SYSTEM
7188 if (FRAME_WINDOW_P (cache
->f
) && face
->font
== NULL
)
7189 load_face_font (cache
->f
, face
, c
);
7190 #endif /* HAVE_WINDOW_SYSTEM */
7195 /* Realize the fully-specified face with attributes ATTRS in face
7196 cache CACHE for character C. Do it for X frame CACHE->f. If C is
7197 a multibyte character, BASE_FACE is a face that has the same
7198 attributes. Otherwise, BASE_FACE is ignored. If the new face
7199 doesn't share font with the default face, a fontname is allocated
7200 from the heap and set in `font_name' of the new face, but it is not
7201 yet loaded here. Value is a pointer to the newly created realized
7204 static struct face
*
7205 realize_x_face (cache
, attrs
, c
, base_face
)
7206 struct face_cache
*cache
;
7209 struct face
*base_face
;
7211 struct face
*face
= NULL
;
7212 #ifdef HAVE_WINDOW_SYSTEM
7213 struct face
*default_face
;
7215 Lisp_Object stipple
, overline
, strike_through
, box
;
7217 xassert (FRAME_WINDOW_P (cache
->f
));
7218 xassert (SINGLE_BYTE_CHAR_P (c
)
7221 /* Allocate a new realized face. */
7222 face
= make_realized_face (attrs
);
7226 /* If C is a multibyte character, we share all face attirbutes with
7227 BASE_FACE including the realized fontset. But, we must load a
7229 if (!SINGLE_BYTE_CHAR_P (c
))
7231 bcopy (base_face
, face
, sizeof *face
);
7234 /* Don't try to free the colors copied bitwise from BASE_FACE. */
7235 face
->colors_copied_bitwise_p
= 1;
7237 /* to force realize_face to load font */
7242 /* Now we are realizing a face for ASCII (and unibyte) characters. */
7244 /* Determine the font to use. Most of the time, the font will be
7245 the same as the font of the default face, so try that first. */
7246 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7248 && FACE_SUITABLE_FOR_CHAR_P (default_face
, c
)
7249 && lface_same_font_attributes_p (default_face
->lface
, attrs
))
7251 face
->font
= default_face
->font
;
7252 face
->fontset
= default_face
->fontset
;
7253 face
->font_info_id
= default_face
->font_info_id
;
7254 face
->font_name
= default_face
->font_name
;
7255 face
->ascii_face
= face
;
7257 /* But, as we can't share the fontset, make a new realized
7258 fontset that has the same base fontset as of the default
7261 = make_fontset_for_ascii_face (f
, default_face
->fontset
);
7265 /* If the face attribute ATTRS specifies a fontset, use it as
7266 the base of a new realized fontset. Otherwise, use the same
7267 base fontset as of the default face. The base determines
7268 registry and encoding of a font. It may also determine
7269 foundry and family. The other fields of font name pattern
7270 are constructed from ATTRS. */
7271 int fontset
= face_fontset (attrs
);
7273 if ((fontset
== -1) && default_face
)
7274 fontset
= default_face
->fontset
;
7275 face
->fontset
= make_fontset_for_ascii_face (f
, fontset
);
7276 face
->font
= NULL
; /* to force realize_face to load font */
7279 /* Load colors, and set remaining attributes. */
7281 load_face_colors (f
, face
, attrs
);
7284 box
= attrs
[LFACE_BOX_INDEX
];
7287 /* A simple box of line width 1 drawn in color given by
7289 face
->box_color
= load_color (f
, face
, attrs
[LFACE_BOX_INDEX
],
7291 face
->box
= FACE_SIMPLE_BOX
;
7292 face
->box_line_width
= 1;
7294 else if (INTEGERP (box
))
7296 /* Simple box of specified line width in foreground color of the
7298 xassert (XINT (box
) != 0);
7299 face
->box
= FACE_SIMPLE_BOX
;
7300 face
->box_line_width
= XINT (box
);
7301 face
->box_color
= face
->foreground
;
7302 face
->box_color_defaulted_p
= 1;
7304 else if (CONSP (box
))
7306 /* `(:width WIDTH :color COLOR :shadow SHADOW)'. SHADOW
7307 being one of `raised' or `sunken'. */
7308 face
->box
= FACE_SIMPLE_BOX
;
7309 face
->box_color
= face
->foreground
;
7310 face
->box_color_defaulted_p
= 1;
7311 face
->box_line_width
= 1;
7315 Lisp_Object keyword
, value
;
7317 keyword
= XCAR (box
);
7325 if (EQ (keyword
, QCline_width
))
7327 if (INTEGERP (value
) && XINT (value
) != 0)
7328 face
->box_line_width
= XINT (value
);
7330 else if (EQ (keyword
, QCcolor
))
7332 if (STRINGP (value
))
7334 face
->box_color
= load_color (f
, face
, value
,
7336 face
->use_box_color_for_shadows_p
= 1;
7339 else if (EQ (keyword
, QCstyle
))
7341 if (EQ (value
, Qreleased_button
))
7342 face
->box
= FACE_RAISED_BOX
;
7343 else if (EQ (value
, Qpressed_button
))
7344 face
->box
= FACE_SUNKEN_BOX
;
7349 /* Text underline, overline, strike-through. */
7351 if (EQ (attrs
[LFACE_UNDERLINE_INDEX
], Qt
))
7353 /* Use default color (same as foreground color). */
7354 face
->underline_p
= 1;
7355 face
->underline_defaulted_p
= 1;
7356 face
->underline_color
= 0;
7358 else if (STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]))
7360 /* Use specified color. */
7361 face
->underline_p
= 1;
7362 face
->underline_defaulted_p
= 0;
7363 face
->underline_color
7364 = load_color (f
, face
, attrs
[LFACE_UNDERLINE_INDEX
],
7365 LFACE_UNDERLINE_INDEX
);
7367 else if (NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7369 face
->underline_p
= 0;
7370 face
->underline_defaulted_p
= 0;
7371 face
->underline_color
= 0;
7374 overline
= attrs
[LFACE_OVERLINE_INDEX
];
7375 if (STRINGP (overline
))
7377 face
->overline_color
7378 = load_color (f
, face
, attrs
[LFACE_OVERLINE_INDEX
],
7379 LFACE_OVERLINE_INDEX
);
7380 face
->overline_p
= 1;
7382 else if (EQ (overline
, Qt
))
7384 face
->overline_color
= face
->foreground
;
7385 face
->overline_color_defaulted_p
= 1;
7386 face
->overline_p
= 1;
7389 strike_through
= attrs
[LFACE_STRIKE_THROUGH_INDEX
];
7390 if (STRINGP (strike_through
))
7392 face
->strike_through_color
7393 = load_color (f
, face
, attrs
[LFACE_STRIKE_THROUGH_INDEX
],
7394 LFACE_STRIKE_THROUGH_INDEX
);
7395 face
->strike_through_p
= 1;
7397 else if (EQ (strike_through
, Qt
))
7399 face
->strike_through_color
= face
->foreground
;
7400 face
->strike_through_color_defaulted_p
= 1;
7401 face
->strike_through_p
= 1;
7404 stipple
= attrs
[LFACE_STIPPLE_INDEX
];
7405 if (!NILP (stipple
))
7406 face
->stipple
= load_pixmap (f
, stipple
, &face
->pixmap_w
, &face
->pixmap_h
);
7408 xassert (FACE_SUITABLE_FOR_CHAR_P (face
, c
));
7409 #endif /* HAVE_WINDOW_SYSTEM */
7414 /* Map a specified color of face FACE on frame F to a tty color index.
7415 IDX is either LFACE_FOREGROUND_INDEX or LFACE_BACKGROUND_INDEX, and
7416 specifies which color to map. Set *DEFAULTED to 1 if mapping to the
7417 default foreground/background colors. */
7420 map_tty_color (f
, face
, idx
, defaulted
)
7423 enum lface_attribute_index idx
;
7426 Lisp_Object frame
, color
, def
;
7427 int foreground_p
= idx
== LFACE_FOREGROUND_INDEX
;
7428 unsigned long default_pixel
, default_other_pixel
, pixel
;
7430 xassert (idx
== LFACE_FOREGROUND_INDEX
|| idx
== LFACE_BACKGROUND_INDEX
);
7434 pixel
= default_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7435 default_other_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7439 pixel
= default_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7440 default_other_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7443 XSETFRAME (frame
, f
);
7444 color
= face
->lface
[idx
];
7448 && CONSP (Vtty_defined_color_alist
)
7449 && (def
= assq_no_quit (color
, call1 (Qtty_color_alist
, frame
)),
7452 /* Associations in tty-defined-color-alist are of the form
7453 (NAME INDEX R G B). We need the INDEX part. */
7454 pixel
= XINT (XCAR (XCDR (def
)));
7457 if (pixel
== default_pixel
&& STRINGP (color
))
7459 pixel
= load_color (f
, face
, color
, idx
);
7461 #if defined (MSDOS) || defined (WINDOWSNT)
7462 /* If the foreground of the default face is the default color,
7463 use the foreground color defined by the frame. */
7465 if (FRAME_MSDOS_P (f
))
7468 if (pixel
== default_pixel
7469 || pixel
== FACE_TTY_DEFAULT_COLOR
)
7472 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7474 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7475 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7478 else if (pixel
== default_other_pixel
)
7481 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7483 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7484 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7490 #endif /* MSDOS or WINDOWSNT */
7494 face
->foreground
= pixel
;
7496 face
->background
= pixel
;
7500 /* Realize the fully-specified face with attributes ATTRS in face
7501 cache CACHE for character C. Do it for TTY frame CACHE->f. Value is a
7502 pointer to the newly created realized face. */
7504 static struct face
*
7505 realize_tty_face (cache
, attrs
, c
)
7506 struct face_cache
*cache
;
7512 int face_colors_defaulted
= 0;
7513 struct frame
*f
= cache
->f
;
7515 /* Frame must be a termcap frame. */
7516 xassert (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
));
7518 /* Allocate a new realized face. */
7519 face
= make_realized_face (attrs
);
7520 face
->font_name
= FRAME_MSDOS_P (cache
->f
) ? "ms-dos" : "tty";
7522 /* Map face attributes to TTY appearances. We map slant to
7523 dimmed text because we want italic text to appear differently
7524 and because dimmed text is probably used infrequently. */
7525 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
7526 slant
= face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
7528 if (weight
> XLFD_WEIGHT_MEDIUM
)
7529 face
->tty_bold_p
= 1;
7530 if (weight
< XLFD_WEIGHT_MEDIUM
|| slant
!= XLFD_SLANT_ROMAN
)
7531 face
->tty_dim_p
= 1;
7532 if (!NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7533 face
->tty_underline_p
= 1;
7534 if (!NILP (attrs
[LFACE_INVERSE_INDEX
]))
7535 face
->tty_reverse_p
= 1;
7537 /* Map color names to color indices. */
7538 map_tty_color (f
, face
, LFACE_FOREGROUND_INDEX
, &face_colors_defaulted
);
7539 map_tty_color (f
, face
, LFACE_BACKGROUND_INDEX
, &face_colors_defaulted
);
7541 /* Swap colors if face is inverse-video. If the colors are taken
7542 from the frame colors, they are already inverted, since the
7543 frame-creation function calls x-handle-reverse-video. */
7544 if (face
->tty_reverse_p
&& !face_colors_defaulted
)
7546 unsigned long tem
= face
->foreground
;
7547 face
->foreground
= face
->background
;
7548 face
->background
= tem
;
7551 if (tty_suppress_bold_inverse_default_colors_p
7553 && face
->background
== FACE_TTY_DEFAULT_FG_COLOR
7554 && face
->foreground
== FACE_TTY_DEFAULT_BG_COLOR
)
7555 face
->tty_bold_p
= 0;
7561 DEFUN ("tty-suppress-bold-inverse-default-colors",
7562 Ftty_suppress_bold_inverse_default_colors
,
7563 Stty_suppress_bold_inverse_default_colors
, 1, 1, 0,
7564 doc
: /* Suppress/allow boldness of faces with inverse default colors.
7565 SUPPRESS non-nil means suppress it.
7566 This affects bold faces on TTYs whose foreground is the default background
7567 color of the display and whose background is the default foreground color.
7568 For such faces, the bold face attribute is ignored if this variable
7571 Lisp_Object suppress
;
7573 tty_suppress_bold_inverse_default_colors_p
= !NILP (suppress
);
7574 ++face_change_count
;
7580 /***********************************************************************
7582 ***********************************************************************/
7584 /* Return the ID of the face to use to display character CH with face
7585 property PROP on frame F in current_buffer. */
7588 compute_char_face (f
, ch
, prop
)
7595 if (NILP (current_buffer
->enable_multibyte_characters
))
7600 struct face
*face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7601 face_id
= FACE_FOR_CHAR (f
, face
, ch
);
7605 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7606 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7607 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7608 merge_face_ref (f
, prop
, attrs
, 1, 0);
7609 face_id
= lookup_face (f
, attrs
, ch
, NULL
);
7615 /* Return the face ID associated with buffer position POS for
7616 displaying ASCII characters. Return in *ENDPTR the position at
7617 which a different face is needed, as far as text properties and
7618 overlays are concerned. W is a window displaying current_buffer.
7620 REGION_BEG, REGION_END delimit the region, so it can be
7623 LIMIT is a position not to scan beyond. That is to limit the time
7624 this function can take.
7626 If MOUSE is non-zero, use the character's mouse-face, not its face.
7628 The face returned is suitable for displaying ASCII characters. */
7631 face_at_buffer_position (w
, pos
, region_beg
, region_end
,
7632 endptr
, limit
, mouse
)
7635 int region_beg
, region_end
;
7640 struct frame
*f
= XFRAME (w
->frame
);
7641 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7642 Lisp_Object prop
, position
;
7644 Lisp_Object
*overlay_vec
;
7647 Lisp_Object propname
= mouse
? Qmouse_face
: Qface
;
7648 Lisp_Object limit1
, end
;
7649 struct face
*default_face
;
7651 /* W must display the current buffer. We could write this function
7652 to use the frame and buffer of W, but right now it doesn't. */
7653 /* xassert (XBUFFER (w->buffer) == current_buffer); */
7655 XSETFRAME (frame
, f
);
7656 XSETFASTINT (position
, pos
);
7659 if (pos
< region_beg
&& region_beg
< endpos
)
7660 endpos
= region_beg
;
7662 /* Get the `face' or `mouse_face' text property at POS, and
7663 determine the next position at which the property changes. */
7664 prop
= Fget_text_property (position
, propname
, w
->buffer
);
7665 XSETFASTINT (limit1
, (limit
< endpos
? limit
: endpos
));
7666 end
= Fnext_single_property_change (position
, propname
, w
->buffer
, limit1
);
7668 endpos
= XINT (end
);
7670 /* Look at properties from overlays. */
7674 GET_OVERLAYS_AT (pos
, overlay_vec
, noverlays
, &next_overlay
, 0);
7675 if (next_overlay
< endpos
)
7676 endpos
= next_overlay
;
7681 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7683 /* Optimize common cases where we can use the default face. */
7686 && !(pos
>= region_beg
&& pos
< region_end
))
7687 return DEFAULT_FACE_ID
;
7689 /* Begin with attributes from the default face. */
7690 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7692 /* Merge in attributes specified via text properties. */
7694 merge_face_ref (f
, prop
, attrs
, 1, 0);
7696 /* Now merge the overlay data. */
7697 noverlays
= sort_overlays (overlay_vec
, noverlays
, w
);
7698 for (i
= 0; i
< noverlays
; i
++)
7703 prop
= Foverlay_get (overlay_vec
[i
], propname
);
7705 merge_face_ref (f
, prop
, attrs
, 1, 0);
7707 oend
= OVERLAY_END (overlay_vec
[i
]);
7708 oendpos
= OVERLAY_POSITION (oend
);
7709 if (oendpos
< endpos
)
7713 /* If in the region, merge in the region face. */
7714 if (pos
>= region_beg
&& pos
< region_end
)
7716 merge_named_face (f
, Qregion
, attrs
, 0);
7718 if (region_end
< endpos
)
7719 endpos
= region_end
;
7724 /* Look up a realized face with the given face attributes,
7725 or realize a new one for ASCII characters. */
7726 return lookup_face (f
, attrs
, 0, NULL
);
7730 /* Compute the face at character position POS in Lisp string STRING on
7731 window W, for ASCII characters.
7733 If STRING is an overlay string, it comes from position BUFPOS in
7734 current_buffer, otherwise BUFPOS is zero to indicate that STRING is
7735 not an overlay string. W must display the current buffer.
7736 REGION_BEG and REGION_END give the start and end positions of the
7737 region; both are -1 if no region is visible.
7739 BASE_FACE_ID is the id of a face to merge with. For strings coming
7740 from overlays or the `display' property it is the face at BUFPOS.
7742 If MOUSE_P is non-zero, use the character's mouse-face, not its face.
7744 Set *ENDPTR to the next position where to check for faces in
7745 STRING; -1 if the face is constant from POS to the end of the
7748 Value is the id of the face to use. The face returned is suitable
7749 for displaying ASCII characters. */
7752 face_at_string_position (w
, string
, pos
, bufpos
, region_beg
,
7753 region_end
, endptr
, base_face_id
, mouse_p
)
7757 int region_beg
, region_end
;
7759 enum face_id base_face_id
;
7762 Lisp_Object prop
, position
, end
, limit
;
7763 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
7764 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7765 struct face
*base_face
;
7766 int multibyte_p
= STRING_MULTIBYTE (string
);
7767 Lisp_Object prop_name
= mouse_p
? Qmouse_face
: Qface
;
7769 /* Get the value of the face property at the current position within
7770 STRING. Value is nil if there is no face property. */
7771 XSETFASTINT (position
, pos
);
7772 prop
= Fget_text_property (position
, prop_name
, string
);
7774 /* Get the next position at which to check for faces. Value of end
7775 is nil if face is constant all the way to the end of the string.
7776 Otherwise it is a string position where to check faces next.
7777 Limit is the maximum position up to which to check for property
7778 changes in Fnext_single_property_change. Strings are usually
7779 short, so set the limit to the end of the string. */
7780 XSETFASTINT (limit
, SCHARS (string
));
7781 end
= Fnext_single_property_change (position
, prop_name
, string
, limit
);
7783 *endptr
= XFASTINT (end
);
7787 base_face
= FACE_FROM_ID (f
, base_face_id
);
7788 xassert (base_face
);
7790 /* Optimize the default case that there is no face property and we
7791 are not in the region. */
7793 && (base_face_id
!= DEFAULT_FACE_ID
7794 /* BUFPOS <= 0 means STRING is not an overlay string, so
7795 that the region doesn't have to be taken into account. */
7797 || bufpos
< region_beg
7798 || bufpos
>= region_end
)
7800 /* We can't realize faces for different charsets differently
7801 if we don't have fonts, so we can stop here if not working
7802 on a window-system frame. */
7803 || !FRAME_WINDOW_P (f
)
7804 || FACE_SUITABLE_FOR_CHAR_P (base_face
, 0)))
7805 return base_face
->id
;
7807 /* Begin with attributes from the base face. */
7808 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
7810 /* Merge in attributes specified via text properties. */
7812 merge_face_ref (f
, prop
, attrs
, 1, 0);
7814 /* If in the region, merge in the region face. */
7816 && bufpos
>= region_beg
7817 && bufpos
< region_end
)
7818 merge_named_face (f
, Qregion
, attrs
, 0);
7820 /* Look up a realized face with the given face attributes,
7821 or realize a new one for ASCII characters. */
7822 return lookup_face (f
, attrs
, 0, NULL
);
7826 /* Merge a face into a realized face.
7828 F is frame where faces are (to be) realized.
7830 FACE_NAME is named face to merge.
7832 If FACE_NAME is nil, FACE_ID is face_id of realized face to merge.
7834 If FACE_NAME is t, FACE_ID is lface_id of face to merge.
7836 BASE_FACE_ID is realized face to merge into.
7842 merge_faces (f
, face_name
, face_id
, base_face_id
)
7844 Lisp_Object face_name
;
7845 int face_id
, base_face_id
;
7847 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7848 struct face
*base_face
;
7850 base_face
= FACE_FROM_ID (f
, base_face_id
);
7852 return base_face_id
;
7854 if (EQ (face_name
, Qt
))
7856 if (face_id
< 0 || face_id
>= lface_id_to_name_size
)
7857 return base_face_id
;
7858 face_name
= lface_id_to_name
[face_id
];
7859 face_id
= lookup_derived_face (f
, face_name
, 0, base_face_id
, 1);
7862 return base_face_id
;
7865 /* Begin with attributes from the base face. */
7866 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
7868 if (!NILP (face_name
))
7870 if (!merge_named_face (f
, face_name
, attrs
, 0))
7871 return base_face_id
;
7877 return base_face_id
;
7878 face
= FACE_FROM_ID (f
, face_id
);
7880 return base_face_id
;
7881 merge_face_vectors (f
, face
->lface
, attrs
, 0);
7884 /* Look up a realized face with the given face attributes,
7885 or realize a new one for ASCII characters. */
7886 return lookup_face (f
, attrs
, 0, NULL
);
7890 /***********************************************************************
7892 ***********************************************************************/
7896 /* Print the contents of the realized face FACE to stderr. */
7899 dump_realized_face (face
)
7902 fprintf (stderr
, "ID: %d\n", face
->id
);
7903 #ifdef HAVE_X_WINDOWS
7904 fprintf (stderr
, "gc: %ld\n", (long) face
->gc
);
7906 fprintf (stderr
, "foreground: 0x%lx (%s)\n",
7908 SDATA (face
->lface
[LFACE_FOREGROUND_INDEX
]));
7909 fprintf (stderr
, "background: 0x%lx (%s)\n",
7911 SDATA (face
->lface
[LFACE_BACKGROUND_INDEX
]));
7912 fprintf (stderr
, "font_name: %s (%s)\n",
7914 SDATA (face
->lface
[LFACE_FAMILY_INDEX
]));
7915 #ifdef HAVE_X_WINDOWS
7916 fprintf (stderr
, "font = %p\n", face
->font
);
7918 fprintf (stderr
, "font_info_id = %d\n", face
->font_info_id
);
7919 fprintf (stderr
, "fontset: %d\n", face
->fontset
);
7920 fprintf (stderr
, "underline: %d (%s)\n",
7922 SDATA (Fsymbol_name (face
->lface
[LFACE_UNDERLINE_INDEX
])));
7923 fprintf (stderr
, "hash: %d\n", face
->hash
);
7924 fprintf (stderr
, "charset: %d\n", face
->charset
);
7928 DEFUN ("dump-face", Fdump_face
, Sdump_face
, 0, 1, 0, doc
: /* */)
7936 fprintf (stderr
, "font selection order: ");
7937 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
7938 fprintf (stderr
, "%d ", font_sort_order
[i
]);
7939 fprintf (stderr
, "\n");
7941 fprintf (stderr
, "alternative fonts: ");
7942 debug_print (Vface_alternative_font_family_alist
);
7943 fprintf (stderr
, "\n");
7945 for (i
= 0; i
< FRAME_FACE_CACHE (SELECTED_FRAME ())->used
; ++i
)
7946 Fdump_face (make_number (i
));
7952 face
= FACE_FROM_ID (SELECTED_FRAME (), XINT (n
));
7954 error ("Not a valid face");
7955 dump_realized_face (face
);
7962 DEFUN ("show-face-resources", Fshow_face_resources
, Sshow_face_resources
,
7963 0, 0, 0, doc
: /* */)
7966 fprintf (stderr
, "number of colors = %d\n", ncolors_allocated
);
7967 fprintf (stderr
, "number of pixmaps = %d\n", npixmaps_allocated
);
7968 fprintf (stderr
, "number of GCs = %d\n", ngcs
);
7972 #endif /* GLYPH_DEBUG != 0 */
7976 /***********************************************************************
7978 ***********************************************************************/
7983 Qface
= intern ("face");
7985 Qface_no_inherit
= intern ("face-no-inherit");
7986 staticpro (&Qface_no_inherit
);
7987 Qbitmap_spec_p
= intern ("bitmap-spec-p");
7988 staticpro (&Qbitmap_spec_p
);
7989 Qframe_set_background_mode
= intern ("frame-set-background-mode");
7990 staticpro (&Qframe_set_background_mode
);
7992 /* Lisp face attribute keywords. */
7993 QCfamily
= intern (":family");
7994 staticpro (&QCfamily
);
7995 QCheight
= intern (":height");
7996 staticpro (&QCheight
);
7997 QCweight
= intern (":weight");
7998 staticpro (&QCweight
);
7999 QCslant
= intern (":slant");
8000 staticpro (&QCslant
);
8001 QCunderline
= intern (":underline");
8002 staticpro (&QCunderline
);
8003 QCinverse_video
= intern (":inverse-video");
8004 staticpro (&QCinverse_video
);
8005 QCreverse_video
= intern (":reverse-video");
8006 staticpro (&QCreverse_video
);
8007 QCforeground
= intern (":foreground");
8008 staticpro (&QCforeground
);
8009 QCbackground
= intern (":background");
8010 staticpro (&QCbackground
);
8011 QCstipple
= intern (":stipple");;
8012 staticpro (&QCstipple
);
8013 QCwidth
= intern (":width");
8014 staticpro (&QCwidth
);
8015 QCfont
= intern (":font");
8016 staticpro (&QCfont
);
8017 QCbold
= intern (":bold");
8018 staticpro (&QCbold
);
8019 QCitalic
= intern (":italic");
8020 staticpro (&QCitalic
);
8021 QCoverline
= intern (":overline");
8022 staticpro (&QCoverline
);
8023 QCstrike_through
= intern (":strike-through");
8024 staticpro (&QCstrike_through
);
8025 QCbox
= intern (":box");
8027 QCinherit
= intern (":inherit");
8028 staticpro (&QCinherit
);
8030 /* Symbols used for Lisp face attribute values. */
8031 QCcolor
= intern (":color");
8032 staticpro (&QCcolor
);
8033 QCline_width
= intern (":line-width");
8034 staticpro (&QCline_width
);
8035 QCstyle
= intern (":style");
8036 staticpro (&QCstyle
);
8037 Qreleased_button
= intern ("released-button");
8038 staticpro (&Qreleased_button
);
8039 Qpressed_button
= intern ("pressed-button");
8040 staticpro (&Qpressed_button
);
8041 Qnormal
= intern ("normal");
8042 staticpro (&Qnormal
);
8043 Qultra_light
= intern ("ultra-light");
8044 staticpro (&Qultra_light
);
8045 Qextra_light
= intern ("extra-light");
8046 staticpro (&Qextra_light
);
8047 Qlight
= intern ("light");
8048 staticpro (&Qlight
);
8049 Qsemi_light
= intern ("semi-light");
8050 staticpro (&Qsemi_light
);
8051 Qsemi_bold
= intern ("semi-bold");
8052 staticpro (&Qsemi_bold
);
8053 Qbold
= intern ("bold");
8055 Qextra_bold
= intern ("extra-bold");
8056 staticpro (&Qextra_bold
);
8057 Qultra_bold
= intern ("ultra-bold");
8058 staticpro (&Qultra_bold
);
8059 Qoblique
= intern ("oblique");
8060 staticpro (&Qoblique
);
8061 Qitalic
= intern ("italic");
8062 staticpro (&Qitalic
);
8063 Qreverse_oblique
= intern ("reverse-oblique");
8064 staticpro (&Qreverse_oblique
);
8065 Qreverse_italic
= intern ("reverse-italic");
8066 staticpro (&Qreverse_italic
);
8067 Qultra_condensed
= intern ("ultra-condensed");
8068 staticpro (&Qultra_condensed
);
8069 Qextra_condensed
= intern ("extra-condensed");
8070 staticpro (&Qextra_condensed
);
8071 Qcondensed
= intern ("condensed");
8072 staticpro (&Qcondensed
);
8073 Qsemi_condensed
= intern ("semi-condensed");
8074 staticpro (&Qsemi_condensed
);
8075 Qsemi_expanded
= intern ("semi-expanded");
8076 staticpro (&Qsemi_expanded
);
8077 Qexpanded
= intern ("expanded");
8078 staticpro (&Qexpanded
);
8079 Qextra_expanded
= intern ("extra-expanded");
8080 staticpro (&Qextra_expanded
);
8081 Qultra_expanded
= intern ("ultra-expanded");
8082 staticpro (&Qultra_expanded
);
8083 Qbackground_color
= intern ("background-color");
8084 staticpro (&Qbackground_color
);
8085 Qforeground_color
= intern ("foreground-color");
8086 staticpro (&Qforeground_color
);
8087 Qunspecified
= intern ("unspecified");
8088 staticpro (&Qunspecified
);
8089 Qignore_defface
= intern (":ignore-defface");
8090 staticpro (&Qignore_defface
);
8092 Qface_alias
= intern ("face-alias");
8093 staticpro (&Qface_alias
);
8094 Qdefault
= intern ("default");
8095 staticpro (&Qdefault
);
8096 Qtool_bar
= intern ("tool-bar");
8097 staticpro (&Qtool_bar
);
8098 Qregion
= intern ("region");
8099 staticpro (&Qregion
);
8100 Qfringe
= intern ("fringe");
8101 staticpro (&Qfringe
);
8102 Qheader_line
= intern ("header-line");
8103 staticpro (&Qheader_line
);
8104 Qscroll_bar
= intern ("scroll-bar");
8105 staticpro (&Qscroll_bar
);
8106 Qmenu
= intern ("menu");
8108 Qcursor
= intern ("cursor");
8109 staticpro (&Qcursor
);
8110 Qborder
= intern ("border");
8111 staticpro (&Qborder
);
8112 Qmouse
= intern ("mouse");
8113 staticpro (&Qmouse
);
8114 Qmode_line_inactive
= intern ("mode-line-inactive");
8115 staticpro (&Qmode_line_inactive
);
8116 Qvertical_border
= intern ("vertical-border");
8117 staticpro (&Qvertical_border
);
8118 Qtty_color_desc
= intern ("tty-color-desc");
8119 staticpro (&Qtty_color_desc
);
8120 Qtty_color_standard_values
= intern ("tty-color-standard-values");
8121 staticpro (&Qtty_color_standard_values
);
8122 Qtty_color_by_index
= intern ("tty-color-by-index");
8123 staticpro (&Qtty_color_by_index
);
8124 Qtty_color_alist
= intern ("tty-color-alist");
8125 staticpro (&Qtty_color_alist
);
8126 Qscalable_fonts_allowed
= intern ("scalable-fonts-allowed");
8127 staticpro (&Qscalable_fonts_allowed
);
8129 Vparam_value_alist
= Fcons (Fcons (Qnil
, Qnil
), Qnil
);
8130 staticpro (&Vparam_value_alist
);
8131 Vface_alternative_font_family_alist
= Qnil
;
8132 staticpro (&Vface_alternative_font_family_alist
);
8133 Vface_alternative_font_registry_alist
= Qnil
;
8134 staticpro (&Vface_alternative_font_registry_alist
);
8136 defsubr (&Sinternal_make_lisp_face
);
8137 defsubr (&Sinternal_lisp_face_p
);
8138 defsubr (&Sinternal_set_lisp_face_attribute
);
8139 #ifdef HAVE_WINDOW_SYSTEM
8140 defsubr (&Sinternal_set_lisp_face_attribute_from_resource
);
8142 defsubr (&Scolor_gray_p
);
8143 defsubr (&Scolor_supported_p
);
8144 defsubr (&Sface_attribute_relative_p
);
8145 defsubr (&Smerge_face_attribute
);
8146 defsubr (&Sinternal_get_lisp_face_attribute
);
8147 defsubr (&Sinternal_lisp_face_attribute_values
);
8148 defsubr (&Sinternal_lisp_face_equal_p
);
8149 defsubr (&Sinternal_lisp_face_empty_p
);
8150 defsubr (&Sinternal_copy_lisp_face
);
8151 defsubr (&Sinternal_merge_in_global_face
);
8152 defsubr (&Sface_font
);
8153 defsubr (&Sframe_face_alist
);
8154 defsubr (&Sdisplay_supports_face_attributes_p
);
8155 defsubr (&Scolor_distance
);
8156 defsubr (&Sinternal_set_font_selection_order
);
8157 defsubr (&Sinternal_set_alternative_font_family_alist
);
8158 defsubr (&Sinternal_set_alternative_font_registry_alist
);
8159 defsubr (&Sface_attributes_as_vector
);
8161 defsubr (&Sdump_face
);
8162 defsubr (&Sshow_face_resources
);
8163 #endif /* GLYPH_DEBUG */
8164 defsubr (&Sclear_face_cache
);
8165 defsubr (&Stty_suppress_bold_inverse_default_colors
);
8167 #if defined DEBUG_X_COLORS && defined HAVE_X_WINDOWS
8168 defsubr (&Sdump_colors
);
8171 DEFVAR_LISP ("font-list-limit", &Vfont_list_limit
,
8172 doc
: /* *Limit for font matching.
8173 If an integer > 0, font matching functions won't load more than
8174 that number of fonts when searching for a matching font. */);
8175 Vfont_list_limit
= make_number (DEFAULT_FONT_LIST_LIMIT
);
8177 DEFVAR_LISP ("face-new-frame-defaults", &Vface_new_frame_defaults
,
8178 doc
: /* List of global face definitions (for internal use only.) */);
8179 Vface_new_frame_defaults
= Qnil
;
8181 DEFVAR_LISP ("face-default-stipple", &Vface_default_stipple
,
8182 doc
: /* *Default stipple pattern used on monochrome displays.
8183 This stipple pattern is used on monochrome displays
8184 instead of shades of gray for a face background color.
8185 See `set-face-stipple' for possible values for this variable. */);
8186 Vface_default_stipple
= build_string ("gray3");
8188 DEFVAR_LISP ("tty-defined-color-alist", &Vtty_defined_color_alist
,
8189 doc
: /* An alist of defined terminal colors and their RGB values. */);
8190 Vtty_defined_color_alist
= Qnil
;
8192 DEFVAR_LISP ("scalable-fonts-allowed", &Vscalable_fonts_allowed
,
8193 doc
: /* Allowed scalable fonts.
8194 A value of nil means don't allow any scalable fonts.
8195 A value of t means allow any scalable font.
8196 Otherwise, value must be a list of regular expressions. A font may be
8197 scaled if its name matches a regular expression in the list.
8198 Note that if value is nil, a scalable font might still be used, if no
8199 other font of the appropriate family and registry is available. */);
8200 Vscalable_fonts_allowed
= Qnil
;
8202 DEFVAR_LISP ("face-ignored-fonts", &Vface_ignored_fonts
,
8203 doc
: /* List of ignored fonts.
8204 Each element is a regular expression that matches names of fonts to
8206 Vface_ignored_fonts
= Qnil
;
8208 DEFVAR_LISP ("face-font-rescale-alist", &Vface_font_rescale_alist
,
8209 doc
: /* Alist of fonts vs the rescaling factors.
8210 Each element is a cons (FONT-NAME-PATTERN . RESCALE-RATIO), where
8211 FONT-NAME-PATTERN is a regular expression matching a font name, and
8212 RESCALE-RATIO is a floating point number to specify how much larger
8213 \(or smaller) font we should use. For instance, if a face requests
8214 a font of 10 point, we actually use a font of 10 * RESCALE-RATIO point. */);
8215 Vface_font_rescale_alist
= Qnil
;
8217 #ifdef HAVE_WINDOW_SYSTEM
8218 defsubr (&Sbitmap_spec_p
);
8219 defsubr (&Sx_list_fonts
);
8220 defsubr (&Sinternal_face_x_get_resource
);
8221 defsubr (&Sx_family_fonts
);
8222 defsubr (&Sx_font_family_list
);
8223 #endif /* HAVE_WINDOW_SYSTEM */
8226 /* arch-tag: 8a0f7598-5517-408d-9ab3-1da6fcd4c749
8227 (do not change this comment) */