1 /* xfaces.c -- "Face" primitives.
2 Copyright (C) 1993, 1994, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
3 2005, 2006, 2007, 2008 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 3 of the License, or
10 (at your option) any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
20 /* New face implementation by Gerd Moellmann <gerd@gnu.org>. */
24 When using Emacs with X, the display style of characters can be
25 changed by defining `faces'. Each face can specify the following
30 2. Relative proportionate width, aka character set width or set
31 width (swidth), e.g. `semi-compressed'.
33 3. Font height in 1/10pt.
35 4. Font weight, e.g. `bold'.
37 5. Font slant, e.g. `italic'.
43 8. Whether or not characters should be underlined, and in what color.
45 9. Whether or not characters should be displayed in inverse video.
47 10. A background stipple, a bitmap.
49 11. Whether or not characters should be overlined, and in what color.
51 12. Whether or not characters should be strike-through, and in what
54 13. Whether or not a box should be drawn around characters, the box
55 type, and, for simple boxes, in what color.
57 14. Font-spec, or nil. This is a special attribute.
59 A font-spec is a collection of font attributes (specs).
61 When this attribute is specified, the face uses a font matching
62 with the specs as is except for what overwritten by the specs in
63 the fontset (see below). In addition, the other font-related
64 attributes (1st thru 5th) are updated from the spec.
66 On the other hand, if one of the other font-related attributes are
67 specified, the correspoinding specs in this attribute is set to nil.
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 17. A fontset name. This is another special attribute.
77 A fontset is a mappings from characters to font-specs, and the
78 specs overwrite the font-spec in the 14th attribute.
81 Faces are frame-local by nature because Emacs allows to define the
82 same named face (face names are symbols) differently for different
83 frames. Each frame has an alist of face definitions for all named
84 faces. The value of a named face in such an alist is a Lisp vector
85 with the symbol `face' in slot 0, and a slot for each of the face
86 attributes mentioned above.
88 There is also a global face alist `Vface_new_frame_defaults'. Face
89 definitions from this list are used to initialize faces of newly
92 A face doesn't have to specify all attributes. Those not specified
93 have a value of `unspecified'. Faces specifying all attributes but
94 the 14th are called `fully-specified'.
99 The display style of a given character in the text is determined by
100 combining several faces. This process is called `face merging'.
101 Any aspect of the display style that isn't specified by overlays or
102 text properties is taken from the `default' face. Since it is made
103 sure that the default face is always fully-specified, face merging
104 always results in a fully-specified face.
109 After all face attributes for a character have been determined by
110 merging faces of that character, that face is `realized'. The
111 realization process maps face attributes to what is physically
112 available on the system where Emacs runs. The result is a
113 `realized face' in form of a struct face which is stored in the
114 face cache of the frame on which it was realized.
116 Face realization is done in the context of the character to display
117 because different fonts may be used for different characters. In
118 other words, for characters that have different font
119 specifications, different realized faces are needed to display
122 Font specification is done by fontsets. See the comment in
123 fontset.c for the details. In the current implementation, all ASCII
124 characters share the same font in a fontset.
126 Faces are at first realized for ASCII characters, and, at that
127 time, assigned a specific realized fontset. Hereafter, we call
128 such a face as `ASCII face'. When a face for a multibyte character
129 is realized, it inherits (thus shares) a fontset of an ASCII face
130 that has the same attributes other than font-related ones.
132 Thus, all realized faces have a realized fontset.
137 Unibyte text (i.e. raw 8-bit characters) is displayed with the same
138 font as ASCII characters. That is because it is expected that
139 unibyte text users specify a font that is suitable both for ASCII
140 and raw 8-bit characters.
145 Font selection tries to find the best available matching font for a
146 given (character, face) combination.
148 If the face specifies a fontset name, that fontset determines a
149 pattern for fonts of the given character. If the face specifies a
150 font name or the other font-related attributes, a fontset is
151 realized from the default fontset. In that case, that
152 specification determines a pattern for ASCII characters and the
153 default fontset determines a pattern for multibyte characters.
155 Available fonts on the system on which Emacs runs are then matched
156 against the font pattern. The result of font selection is the best
157 match for the given face attributes in this font list.
159 Font selection can be influenced by the user.
161 1. The user can specify the relative importance he gives the face
162 attributes width, height, weight, and slant by setting
163 face-font-selection-order (faces.el) to a list of face attribute
164 names. The default is '(:width :height :weight :slant), and means
165 that font selection first tries to find a good match for the font
166 width specified by a face, then---within fonts with that
167 width---tries to find a best match for the specified font height,
170 2. Setting face-font-family-alternatives allows the user to
171 specify alternative font families to try if a family specified by a
174 3. Setting face-font-registry-alternatives allows the user to
175 specify all alternative font registries to try for a face
176 specifying a registry.
178 4. Setting face-ignored-fonts allows the user to ignore specific
182 Character composition.
184 Usually, the realization process is already finished when Emacs
185 actually reflects the desired glyph matrix on the screen. However,
186 on displaying a composition (sequence of characters to be composed
187 on the screen), a suitable font for the components of the
188 composition is selected and realized while drawing them on the
189 screen, i.e. the realization process is delayed but in principle
193 Initialization of basic faces.
195 The faces `default', `modeline' are considered `basic faces'.
196 When redisplay happens the first time for a newly created frame,
197 basic faces are realized for CHARSET_ASCII. Frame parameters are
198 used to fill in unspecified attributes of the default face. */
202 #include <sys/types.h>
203 #include <sys/stat.h>
204 #include <stdio.h> /* This needs to be before termchar.h */
207 #include "character.h"
209 #include "keyboard.h"
211 #include "termhooks.h"
213 #ifdef HAVE_X_WINDOWS
217 #include <Xm/XmStrDefs.h>
218 #endif /* USE_MOTIF */
219 #endif /* HAVE_X_WINDOWS */
228 /* Redefine X specifics to W32 equivalents to avoid cluttering the
229 code with #ifdef blocks. */
230 #undef FRAME_X_DISPLAY_INFO
231 #define FRAME_X_DISPLAY_INFO FRAME_W32_DISPLAY_INFO
232 #define x_display_info w32_display_info
233 #define FRAME_X_FONT_TABLE FRAME_W32_FONT_TABLE
234 #define check_x check_w32
235 #define x_list_fonts w32_list_fonts
236 #define GCGraphicsExposures 0
237 #endif /* WINDOWSNT */
241 #define x_display_info mac_display_info
242 #define check_x check_mac
246 #include "dispextern.h"
247 #include "blockinput.h"
249 #include "intervals.h"
250 #include "termchar.h"
252 #ifdef HAVE_WINDOW_SYSTEM
255 #endif /* HAVE_WINDOW_SYSTEM */
257 #ifdef HAVE_X_WINDOWS
259 /* Compensate for a bug in Xos.h on some systems, on which it requires
260 time.h. On some such systems, Xos.h tries to redefine struct
261 timeval and struct timezone if USG is #defined while it is
264 #ifdef XOS_NEEDS_TIME_H
270 #else /* not XOS_NEEDS_TIME_H */
272 #endif /* not XOS_NEEDS_TIME_H */
274 #endif /* HAVE_X_WINDOWS */
278 /* Number of pt per inch (from the TeXbook). */
280 #define PT_PER_INCH 72.27
282 /* Non-zero if face attribute ATTR is unspecified. */
284 #define UNSPECIFIEDP(ATTR) EQ ((ATTR), Qunspecified)
286 /* Non-zero if face attribute ATTR is `ignore-defface'. */
288 #define IGNORE_DEFFACE_P(ATTR) EQ ((ATTR), Qignore_defface)
290 /* Value is the number of elements of VECTOR. */
292 #define DIM(VECTOR) (sizeof (VECTOR) / sizeof *(VECTOR))
294 /* Make a copy of string S on the stack using alloca. Value is a pointer
297 #define STRDUPA(S) strcpy ((char *) alloca (strlen ((S)) + 1), (S))
299 /* Make a copy of the contents of Lisp string S on the stack using
300 alloca. Value is a pointer to the copy. */
302 #define LSTRDUPA(S) STRDUPA (SDATA ((S)))
304 /* Size of hash table of realized faces in face caches (should be a
307 #define FACE_CACHE_BUCKETS_SIZE 1001
309 /* Keyword symbols used for face attribute names. */
311 Lisp_Object QCfamily
, QCheight
, QCweight
, QCslant
, QCunderline
;
312 Lisp_Object QCinverse_video
, QCforeground
, QCbackground
, QCstipple
;
313 Lisp_Object QCwidth
, QCfont
, QCbold
, QCitalic
;
314 Lisp_Object QCreverse_video
;
315 Lisp_Object QCoverline
, QCstrike_through
, QCbox
, QCinherit
;
316 Lisp_Object QCfontset
;
318 /* Keywords symbols used for font properties. */
319 extern Lisp_Object QCfoundry
, QCadstyle
, QCregistry
;
320 extern Lisp_Object QCspacing
, QCsize
, QCavgwidth
;
321 extern Lisp_Object Qp
;
323 /* Symbols used for attribute values. */
325 Lisp_Object Qnormal
, Qbold
, Qultra_light
, Qextra_light
, Qlight
;
326 Lisp_Object Qsemi_light
, Qsemi_bold
, Qextra_bold
, Qultra_bold
;
327 Lisp_Object Qoblique
, Qitalic
, Qreverse_oblique
, Qreverse_italic
;
328 Lisp_Object Qultra_condensed
, Qextra_condensed
, Qcondensed
;
329 Lisp_Object Qsemi_condensed
, Qsemi_expanded
, Qexpanded
, Qextra_expanded
;
330 Lisp_Object Qultra_expanded
;
331 Lisp_Object Qreleased_button
, Qpressed_button
;
332 Lisp_Object QCstyle
, QCcolor
, QCline_width
;
333 Lisp_Object Qunspecified
;
334 Lisp_Object Qignore_defface
;
336 char unspecified_fg
[] = "unspecified-fg", unspecified_bg
[] = "unspecified-bg";
338 /* The name of the function to call when the background of the frame
339 has changed, frame_set_background_mode. */
341 Lisp_Object Qframe_set_background_mode
;
343 /* Names of basic faces. */
345 Lisp_Object Qdefault
, Qtool_bar
, Qregion
, Qfringe
;
346 Lisp_Object Qheader_line
, Qscroll_bar
, Qcursor
, Qborder
, Qmouse
, Qmenu
;
347 Lisp_Object Qmode_line_inactive
, Qvertical_border
;
348 extern Lisp_Object Qmode_line
;
350 /* The symbol `face-alias'. A symbols having that property is an
351 alias for another face. Value of the property is the name of
354 Lisp_Object Qface_alias
;
356 extern Lisp_Object Qcircular_list
;
358 /* Default stipple pattern used on monochrome displays. This stipple
359 pattern is used on monochrome displays instead of shades of gray
360 for a face background color. See `set-face-stipple' for possible
361 values for this variable. */
363 Lisp_Object Vface_default_stipple
;
365 /* Alist of alternative font families. Each element is of the form
366 (FAMILY FAMILY1 FAMILY2 ...). If fonts of FAMILY can't be loaded,
367 try FAMILY1, then FAMILY2, ... */
369 Lisp_Object Vface_alternative_font_family_alist
;
371 /* Alist of alternative font registries. Each element is of the form
372 (REGISTRY REGISTRY1 REGISTRY2...). If fonts of REGISTRY can't be
373 loaded, try REGISTRY1, then REGISTRY2, ... */
375 Lisp_Object Vface_alternative_font_registry_alist
;
377 /* Allowed scalable fonts. A value of nil means don't allow any
378 scalable fonts. A value of t means allow the use of any scalable
379 font. Otherwise, value must be a list of regular expressions. A
380 font may be scaled if its name matches a regular expression in the
383 Lisp_Object Vscalable_fonts_allowed
, Qscalable_fonts_allowed
;
385 /* List of regular expressions that matches names of fonts to ignore. */
387 Lisp_Object Vface_ignored_fonts
;
389 /* Alist of font name patterns vs the rescaling factor. */
391 Lisp_Object Vface_font_rescale_alist
;
393 /* Maximum number of fonts to consider in font_list. If not an
394 integer > 0, DEFAULT_FONT_LIST_LIMIT is used instead. */
396 Lisp_Object Vfont_list_limit
;
397 #define DEFAULT_FONT_LIST_LIMIT 100
399 /* The symbols `foreground-color' and `background-color' which can be
400 used as part of a `face' property. This is for compatibility with
403 Lisp_Object Qforeground_color
, Qbackground_color
;
405 /* The symbols `face' and `mouse-face' used as text properties. */
408 extern Lisp_Object Qmouse_face
;
410 /* Property for basic faces which other faces cannot inherit. */
412 Lisp_Object Qface_no_inherit
;
414 /* Error symbol for wrong_type_argument in load_pixmap. */
416 Lisp_Object Qbitmap_spec_p
;
418 /* Alist of global face definitions. Each element is of the form
419 (FACE . LFACE) where FACE is a symbol naming a face and LFACE
420 is a Lisp vector of face attributes. These faces are used
421 to initialize faces for new frames. */
423 Lisp_Object Vface_new_frame_defaults
;
425 /* The next ID to assign to Lisp faces. */
427 static int next_lface_id
;
429 /* A vector mapping Lisp face Id's to face names. */
431 static Lisp_Object
*lface_id_to_name
;
432 static int lface_id_to_name_size
;
434 /* TTY color-related functions (defined in tty-colors.el). */
436 Lisp_Object Qtty_color_desc
, Qtty_color_by_index
, Qtty_color_standard_values
;
438 /* The name of the function used to compute colors on TTYs. */
440 Lisp_Object Qtty_color_alist
;
442 /* An alist of defined terminal colors and their RGB values. */
444 Lisp_Object Vtty_defined_color_alist
;
446 /* Counter for calls to clear_face_cache. If this counter reaches
447 CLEAR_FONT_TABLE_COUNT, and a frame has more than
448 CLEAR_FONT_TABLE_NFONTS load, unused fonts are freed. */
450 static int clear_font_table_count
;
451 #define CLEAR_FONT_TABLE_COUNT 100
452 #define CLEAR_FONT_TABLE_NFONTS 10
454 /* Non-zero means face attributes have been changed since the last
455 redisplay. Used in redisplay_internal. */
457 int face_change_count
;
459 /* Non-zero means don't display bold text if a face's foreground
460 and background colors are the inverse of the default colors of the
461 display. This is a kluge to suppress `bold black' foreground text
462 which is hard to read on an LCD monitor. */
464 int tty_suppress_bold_inverse_default_colors_p
;
466 /* A list of the form `((x . y))' used to avoid consing in
467 Finternal_set_lisp_face_attribute. */
469 static Lisp_Object Vparam_value_alist
;
471 /* The total number of colors currently allocated. */
474 static int ncolors_allocated
;
475 static int npixmaps_allocated
;
479 /* Non-zero means the definition of the `menu' face for new frames has
482 int menu_face_changed_default
;
485 /* Function prototypes. */
489 struct named_merge_point
;
491 static void map_tty_color
P_ ((struct frame
*, struct face
*,
492 enum lface_attribute_index
, int *));
493 static Lisp_Object resolve_face_name
P_ ((Lisp_Object
, int));
494 static int may_use_scalable_font_p
P_ ((const char *));
495 static void set_font_frame_param
P_ ((Lisp_Object
, Lisp_Object
));
496 static int better_font_p
P_ ((int *, struct font_name
*, struct font_name
*,
498 static int x_face_list_fonts
P_ ((struct frame
*, char *,
499 struct font_name
**, int, int));
500 static int get_lface_attributes
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*, int));
501 static int load_pixmap
P_ ((struct frame
*, Lisp_Object
, unsigned *, unsigned *));
502 static unsigned char *xstrlwr
P_ ((unsigned char *));
503 static struct frame
*frame_or_selected_frame
P_ ((Lisp_Object
, int));
504 static void load_face_font
P_ ((struct frame
*, struct face
*));
505 static void load_face_colors
P_ ((struct frame
*, struct face
*, Lisp_Object
*));
506 static void free_face_colors
P_ ((struct frame
*, struct face
*));
507 static int face_color_gray_p
P_ ((struct frame
*, char *));
508 static char *build_font_name
P_ ((struct font_name
*));
509 static void free_font_names
P_ ((struct font_name
*, int));
510 static int sorted_font_list
P_ ((struct frame
*, char *,
511 int (*cmpfn
) P_ ((const void *, const void *)),
512 struct font_name
**));
513 static int font_list_1
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
514 Lisp_Object
, struct font_name
**));
515 static int font_list
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
516 Lisp_Object
, struct font_name
**));
517 static int try_font_list
P_ ((struct frame
*, Lisp_Object
,
518 Lisp_Object
, Lisp_Object
, struct font_name
**));
519 static int try_alternative_families
P_ ((struct frame
*f
, Lisp_Object
,
520 Lisp_Object
, struct font_name
**));
521 static int cmp_font_names
P_ ((const void *, const void *));
522 static struct face
*realize_face
P_ ((struct face_cache
*, Lisp_Object
*,
524 static struct face
*realize_non_ascii_face
P_ ((struct frame
*, Lisp_Object
,
526 static struct face
*realize_x_face
P_ ((struct face_cache
*, Lisp_Object
*));
527 static struct face
*realize_tty_face
P_ ((struct face_cache
*, Lisp_Object
*));
528 static int realize_basic_faces
P_ ((struct frame
*));
529 static int realize_default_face
P_ ((struct frame
*));
530 static void realize_named_face
P_ ((struct frame
*, Lisp_Object
, int));
531 static int lface_fully_specified_p
P_ ((Lisp_Object
*));
532 static int lface_equal_p
P_ ((Lisp_Object
*, Lisp_Object
*));
533 static unsigned hash_string_case_insensitive
P_ ((Lisp_Object
));
534 static unsigned lface_hash
P_ ((Lisp_Object
*));
535 static int lface_same_font_attributes_p
P_ ((Lisp_Object
*, Lisp_Object
*));
536 static struct face_cache
*make_face_cache
P_ ((struct frame
*));
537 static void clear_face_gcs
P_ ((struct face_cache
*));
538 static void free_face_cache
P_ ((struct face_cache
*));
539 static int face_fontset
P_ ((Lisp_Object
*));
540 static void merge_face_vectors
P_ ((struct frame
*, Lisp_Object
*, Lisp_Object
*,
541 struct named_merge_point
*));
542 static int merge_face_ref
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*,
543 int, struct named_merge_point
*));
544 static int set_lface_from_font
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
546 static Lisp_Object lface_from_face_name
P_ ((struct frame
*, Lisp_Object
, int));
547 static struct face
*make_realized_face
P_ ((Lisp_Object
*));
548 static char *best_matching_font
P_ ((struct frame
*, Lisp_Object
*,
549 struct font_name
*, int, int, int *));
550 static void cache_face
P_ ((struct face_cache
*, struct face
*, unsigned));
551 static void uncache_face
P_ ((struct face_cache
*, struct face
*));
553 #ifdef HAVE_WINDOW_SYSTEM
555 static GC x_create_gc
P_ ((struct frame
*, unsigned long, XGCValues
*));
556 static void x_free_gc
P_ ((struct frame
*, GC
));
559 extern Lisp_Object w32_list_fonts
P_ ((struct frame
*, Lisp_Object
, int, int));
560 #endif /* WINDOWSNT */
563 static void x_update_menu_appearance
P_ ((struct frame
*));
565 extern void free_frame_menubar
P_ ((struct frame
*));
566 #endif /* USE_X_TOOLKIT */
568 #endif /* HAVE_WINDOW_SYSTEM */
571 /***********************************************************************
573 ***********************************************************************/
575 #ifdef HAVE_X_WINDOWS
577 #ifdef DEBUG_X_COLORS
579 /* The following is a poor mans infrastructure for debugging X color
580 allocation problems on displays with PseudoColor-8. Some X servers
581 like 3.3.5 XF86_SVGA with Matrox cards apparently don't implement
582 color reference counts completely so that they don't signal an
583 error when a color is freed whose reference count is already 0.
584 Other X servers do. To help me debug this, the following code
585 implements a simple reference counting schema of its own, for a
586 single display/screen. --gerd. */
588 /* Reference counts for pixel colors. */
590 int color_count
[256];
592 /* Register color PIXEL as allocated. */
595 register_color (pixel
)
598 xassert (pixel
< 256);
599 ++color_count
[pixel
];
603 /* Register color PIXEL as deallocated. */
606 unregister_color (pixel
)
609 xassert (pixel
< 256);
610 if (color_count
[pixel
] > 0)
611 --color_count
[pixel
];
617 /* Register N colors from PIXELS as deallocated. */
620 unregister_colors (pixels
, n
)
621 unsigned long *pixels
;
625 for (i
= 0; i
< n
; ++i
)
626 unregister_color (pixels
[i
]);
630 DEFUN ("dump-colors", Fdump_colors
, Sdump_colors
, 0, 0, 0,
631 doc
: /* Dump currently allocated colors to stderr. */)
636 fputc ('\n', stderr
);
638 for (i
= n
= 0; i
< sizeof color_count
/ sizeof color_count
[0]; ++i
)
641 fprintf (stderr
, "%3d: %5d", i
, color_count
[i
]);
644 fputc ('\n', stderr
);
646 fputc ('\t', stderr
);
650 fputc ('\n', stderr
);
654 #endif /* DEBUG_X_COLORS */
657 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
658 color values. Interrupt input must be blocked when this function
662 x_free_colors (f
, pixels
, npixels
)
664 unsigned long *pixels
;
667 int class = FRAME_X_DISPLAY_INFO (f
)->visual
->class;
669 /* If display has an immutable color map, freeing colors is not
670 necessary and some servers don't allow it. So don't do it. */
671 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
673 #ifdef DEBUG_X_COLORS
674 unregister_colors (pixels
, npixels
);
676 XFreeColors (FRAME_X_DISPLAY (f
), FRAME_X_COLORMAP (f
),
682 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
683 color values. Interrupt input must be blocked when this function
687 x_free_dpy_colors (dpy
, screen
, cmap
, pixels
, npixels
)
691 unsigned long *pixels
;
694 struct x_display_info
*dpyinfo
= x_display_info_for_display (dpy
);
695 int class = dpyinfo
->visual
->class;
697 /* If display has an immutable color map, freeing colors is not
698 necessary and some servers don't allow it. So don't do it. */
699 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
701 #ifdef DEBUG_X_COLORS
702 unregister_colors (pixels
, npixels
);
704 XFreeColors (dpy
, cmap
, pixels
, npixels
, 0);
709 /* Create and return a GC for use on frame F. GC values and mask
710 are given by XGCV and MASK. */
713 x_create_gc (f
, mask
, xgcv
)
720 gc
= XCreateGC (FRAME_X_DISPLAY (f
), FRAME_X_WINDOW (f
), mask
, xgcv
);
727 /* Free GC which was used on frame F. */
734 eassert (interrupt_input_blocked
);
735 IF_DEBUG (xassert (--ngcs
>= 0));
736 XFreeGC (FRAME_X_DISPLAY (f
), gc
);
739 #endif /* HAVE_X_WINDOWS */
742 /* W32 emulation of GCs */
745 x_create_gc (f
, mask
, xgcv
)
752 gc
= XCreateGC (NULL
, FRAME_W32_WINDOW (f
), mask
, xgcv
);
759 /* Free GC which was used on frame F. */
766 IF_DEBUG (xassert (--ngcs
>= 0));
770 #endif /* WINDOWSNT */
773 /* Mac OS emulation of GCs */
776 x_create_gc (f
, mask
, xgcv
)
783 gc
= XCreateGC (FRAME_MAC_DISPLAY (f
), FRAME_MAC_WINDOW (f
), mask
, xgcv
);
794 eassert (interrupt_input_blocked
);
795 IF_DEBUG (xassert (--ngcs
>= 0));
796 XFreeGC (FRAME_MAC_DISPLAY (f
), gc
);
801 /* Like stricmp. Used to compare parts of font names which are in
806 const unsigned char *s1
, *s2
;
810 unsigned char c1
= tolower (*s1
);
811 unsigned char c2
= tolower (*s2
);
813 return c1
< c2
? -1 : 1;
818 return *s2
== 0 ? 0 : -1;
823 /* Like strlwr, which might not always be available. */
825 static unsigned char *
829 unsigned char *p
= s
;
832 /* On Mac OS X 10.3, tolower also converts non-ASCII characters
841 /* If FRAME is nil, return a pointer to the selected frame.
842 Otherwise, check that FRAME is a live frame, and return a pointer
843 to it. NPARAM is the parameter number of FRAME, for
844 CHECK_LIVE_FRAME. This is here because it's a frequent pattern in
845 Lisp function definitions. */
847 static INLINE
struct frame
*
848 frame_or_selected_frame (frame
, nparam
)
853 frame
= selected_frame
;
855 CHECK_LIVE_FRAME (frame
);
856 return XFRAME (frame
);
860 /***********************************************************************
862 ***********************************************************************/
864 /* Initialize face cache and basic faces for frame F. */
870 /* Make a face cache, if F doesn't have one. */
871 if (FRAME_FACE_CACHE (f
) == NULL
)
872 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
874 #ifdef HAVE_WINDOW_SYSTEM
875 /* Make the image cache. */
876 if (FRAME_WINDOW_P (f
))
878 if (FRAME_IMAGE_CACHE (f
) == NULL
)
879 /* Is that ever possible?? --Stef */
880 FRAME_IMAGE_CACHE (f
) = make_image_cache ();
881 ++FRAME_IMAGE_CACHE (f
)->refcount
;
883 #endif /* HAVE_WINDOW_SYSTEM */
885 /* Realize basic faces. Must have enough information in frame
886 parameters to realize basic faces at this point. */
887 #ifdef HAVE_X_WINDOWS
888 if (!FRAME_X_P (f
) || FRAME_X_WINDOW (f
))
891 if (!FRAME_WINDOW_P (f
) || FRAME_W32_WINDOW (f
))
894 if (!FRAME_MAC_P (f
) || FRAME_MAC_WINDOW (f
))
896 if (!realize_basic_faces (f
))
901 /* Free face cache of frame F. Called from Fdelete_frame. */
907 struct face_cache
*face_cache
= FRAME_FACE_CACHE (f
);
911 free_face_cache (face_cache
);
912 FRAME_FACE_CACHE (f
) = NULL
;
915 #ifdef HAVE_WINDOW_SYSTEM
916 if (FRAME_WINDOW_P (f
))
918 struct image_cache
*image_cache
= FRAME_IMAGE_CACHE (f
);
921 --image_cache
->refcount
;
922 if (image_cache
->refcount
== 0)
923 free_image_cache (f
);
926 #endif /* HAVE_WINDOW_SYSTEM */
930 /* Clear face caches, and recompute basic faces for frame F. Call
931 this after changing frame parameters on which those faces depend,
932 or when realized faces have been freed due to changing attributes
936 recompute_basic_faces (f
)
939 if (FRAME_FACE_CACHE (f
))
941 clear_face_cache (0);
942 if (!realize_basic_faces (f
))
948 /* Clear the face caches of all frames. CLEAR_FONTS_P non-zero means
949 try to free unused fonts, too. */
952 clear_face_cache (clear_fonts_p
)
955 #ifdef HAVE_WINDOW_SYSTEM
956 Lisp_Object tail
, frame
;
960 || ++clear_font_table_count
== CLEAR_FONT_TABLE_COUNT
)
962 struct x_display_info
*dpyinfo
;
965 /* Not yet implemented. */
966 clear_font_cache (frame
);
970 /* From time to time see if we can unload some fonts. This also
971 frees all realized faces on all frames. Fonts needed by
972 faces will be loaded again when faces are realized again. */
973 clear_font_table_count
= 0;
975 FOR_EACH_FRAME (tail
, frame
)
977 struct frame
*f
= XFRAME (frame
);
978 if (FRAME_WINDOW_P (f
)
979 && FRAME_X_DISPLAY_INFO (f
)->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
980 free_all_realized_faces (frame
);
985 /* Clear GCs of realized faces. */
986 FOR_EACH_FRAME (tail
, frame
)
989 if (FRAME_WINDOW_P (f
))
990 clear_face_gcs (FRAME_FACE_CACHE (f
));
992 clear_image_caches (Qnil
);
994 #endif /* HAVE_WINDOW_SYSTEM */
998 DEFUN ("clear-face-cache", Fclear_face_cache
, Sclear_face_cache
, 0, 1, 0,
999 doc
: /* Clear face caches on all frames.
1000 Optional THOROUGHLY non-nil means try to free unused fonts, too. */)
1002 Lisp_Object thoroughly
;
1004 clear_face_cache (!NILP (thoroughly
));
1005 ++face_change_count
;
1006 ++windows_or_buffers_changed
;
1011 /***********************************************************************
1013 ***********************************************************************/
1015 #ifdef HAVE_WINDOW_SYSTEM
1017 DEFUN ("bitmap-spec-p", Fbitmap_spec_p
, Sbitmap_spec_p
, 1, 1, 0,
1018 doc
: /* Value is non-nil if OBJECT is a valid bitmap specification.
1019 A bitmap specification is either a string, a file name, or a list
1020 \(WIDTH HEIGHT DATA) where WIDTH is the pixel width of the bitmap,
1021 HEIGHT is its height, and DATA is a string containing the bits of
1022 the pixmap. Bits are stored row by row, each row occupies
1023 \(WIDTH + 7)/8 bytes. */)
1029 if (STRINGP (object
))
1030 /* If OBJECT is a string, it's a file name. */
1032 else if (CONSP (object
))
1034 /* Otherwise OBJECT must be (WIDTH HEIGHT DATA), WIDTH and
1035 HEIGHT must be integers > 0, and DATA must be string large
1036 enough to hold a bitmap of the specified size. */
1037 Lisp_Object width
, height
, data
;
1039 height
= width
= data
= Qnil
;
1043 width
= XCAR (object
);
1044 object
= XCDR (object
);
1047 height
= XCAR (object
);
1048 object
= XCDR (object
);
1050 data
= XCAR (object
);
1054 if (NATNUMP (width
) && NATNUMP (height
) && STRINGP (data
))
1056 int bytes_per_row
= ((XFASTINT (width
) + BITS_PER_CHAR
- 1)
1058 if (SBYTES (data
) >= bytes_per_row
* XINT (height
))
1063 return pixmap_p
? Qt
: Qnil
;
1067 /* Load a bitmap according to NAME (which is either a file name or a
1068 pixmap spec) for use on frame F. Value is the bitmap_id (see
1069 xfns.c). If NAME is nil, return with a bitmap id of zero. If
1070 bitmap cannot be loaded, display a message saying so, and return
1071 zero. Store the bitmap width in *W_PTR and its height in *H_PTR,
1072 if these pointers are not null. */
1075 load_pixmap (f
, name
, w_ptr
, h_ptr
)
1078 unsigned int *w_ptr
, *h_ptr
;
1085 CHECK_TYPE (!NILP (Fbitmap_spec_p (name
)), Qbitmap_spec_p
, name
);
1090 /* Decode a bitmap spec into a bitmap. */
1095 w
= XINT (Fcar (name
));
1096 h
= XINT (Fcar (Fcdr (name
)));
1097 bits
= Fcar (Fcdr (Fcdr (name
)));
1099 bitmap_id
= x_create_bitmap_from_data (f
, SDATA (bits
),
1104 /* It must be a string -- a file name. */
1105 bitmap_id
= x_create_bitmap_from_file (f
, name
);
1111 add_to_log ("Invalid or undefined bitmap `%s'", name
, Qnil
);
1122 ++npixmaps_allocated
;
1125 *w_ptr
= x_bitmap_width (f
, bitmap_id
);
1128 *h_ptr
= x_bitmap_height (f
, bitmap_id
);
1134 #endif /* HAVE_WINDOW_SYSTEM */
1138 /***********************************************************************
1140 ***********************************************************************/
1142 /* Parse RGB_LIST, and fill in the RGB fields of COLOR.
1143 RGB_LIST should contain (at least) 3 lisp integers.
1144 Return 0 if there's a problem with RGB_LIST, otherwise return 1. */
1147 parse_rgb_list (rgb_list
, color
)
1148 Lisp_Object rgb_list
;
1151 #define PARSE_RGB_LIST_FIELD(field) \
1152 if (CONSP (rgb_list) && INTEGERP (XCAR (rgb_list))) \
1154 color->field = XINT (XCAR (rgb_list)); \
1155 rgb_list = XCDR (rgb_list); \
1160 PARSE_RGB_LIST_FIELD (red
);
1161 PARSE_RGB_LIST_FIELD (green
);
1162 PARSE_RGB_LIST_FIELD (blue
);
1168 /* Lookup on frame F the color described by the lisp string COLOR.
1169 The resulting tty color is returned in TTY_COLOR; if STD_COLOR is
1170 non-zero, then the `standard' definition of the same color is
1174 tty_lookup_color (f
, color
, tty_color
, std_color
)
1177 XColor
*tty_color
, *std_color
;
1179 Lisp_Object frame
, color_desc
;
1181 if (!STRINGP (color
) || NILP (Ffboundp (Qtty_color_desc
)))
1184 XSETFRAME (frame
, f
);
1186 color_desc
= call2 (Qtty_color_desc
, color
, frame
);
1187 if (CONSP (color_desc
) && CONSP (XCDR (color_desc
)))
1191 if (! INTEGERP (XCAR (XCDR (color_desc
))))
1194 tty_color
->pixel
= XINT (XCAR (XCDR (color_desc
)));
1196 rgb
= XCDR (XCDR (color_desc
));
1197 if (! parse_rgb_list (rgb
, tty_color
))
1200 /* Should we fill in STD_COLOR too? */
1203 /* Default STD_COLOR to the same as TTY_COLOR. */
1204 *std_color
= *tty_color
;
1206 /* Do a quick check to see if the returned descriptor is
1207 actually _exactly_ equal to COLOR, otherwise we have to
1208 lookup STD_COLOR separately. If it's impossible to lookup
1209 a standard color, we just give up and use TTY_COLOR. */
1210 if ((!STRINGP (XCAR (color_desc
))
1211 || NILP (Fstring_equal (color
, XCAR (color_desc
))))
1212 && !NILP (Ffboundp (Qtty_color_standard_values
)))
1214 /* Look up STD_COLOR separately. */
1215 rgb
= call1 (Qtty_color_standard_values
, color
);
1216 if (! parse_rgb_list (rgb
, std_color
))
1223 else if (NILP (Fsymbol_value (intern ("tty-defined-color-alist"))))
1224 /* We were called early during startup, and the colors are not
1225 yet set up in tty-defined-color-alist. Don't return a failure
1226 indication, since this produces the annoying "Unable to
1227 load color" messages in the *Messages* buffer. */
1230 /* tty-color-desc seems to have returned a bad value. */
1234 /* A version of defined_color for non-X frames. */
1237 tty_defined_color (f
, color_name
, color_def
, alloc
)
1246 color_def
->pixel
= FACE_TTY_DEFAULT_COLOR
;
1248 color_def
->blue
= 0;
1249 color_def
->green
= 0;
1252 status
= tty_lookup_color (f
, build_string (color_name
), color_def
, NULL
);
1254 if (color_def
->pixel
== FACE_TTY_DEFAULT_COLOR
&& *color_name
)
1256 if (strcmp (color_name
, "unspecified-fg") == 0)
1257 color_def
->pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
1258 else if (strcmp (color_name
, "unspecified-bg") == 0)
1259 color_def
->pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
1262 if (color_def
->pixel
!= FACE_TTY_DEFAULT_COLOR
)
1269 /* Decide if color named COLOR_NAME is valid for the display
1270 associated with the frame F; if so, return the rgb values in
1271 COLOR_DEF. If ALLOC is nonzero, allocate a new colormap cell.
1273 This does the right thing for any type of frame. */
1276 defined_color (f
, color_name
, color_def
, alloc
)
1282 if (!FRAME_WINDOW_P (f
))
1283 return tty_defined_color (f
, color_name
, color_def
, alloc
);
1284 #ifdef HAVE_X_WINDOWS
1285 else if (FRAME_X_P (f
))
1286 return x_defined_color (f
, color_name
, color_def
, alloc
);
1289 else if (FRAME_W32_P (f
))
1290 return w32_defined_color (f
, color_name
, color_def
, alloc
);
1293 else if (FRAME_MAC_P (f
))
1294 return mac_defined_color (f
, color_name
, color_def
, alloc
);
1301 /* Given the index IDX of a tty color on frame F, return its name, a
1305 tty_color_name (f
, idx
)
1309 if (idx
>= 0 && !NILP (Ffboundp (Qtty_color_by_index
)))
1312 Lisp_Object coldesc
;
1314 XSETFRAME (frame
, f
);
1315 coldesc
= call2 (Qtty_color_by_index
, make_number (idx
), frame
);
1317 if (!NILP (coldesc
))
1318 return XCAR (coldesc
);
1321 /* We can have an MSDOG frame under -nw for a short window of
1322 opportunity before internal_terminal_init is called. DTRT. */
1323 if (FRAME_MSDOS_P (f
) && !inhibit_window_system
)
1324 return msdos_stdcolor_name (idx
);
1327 if (idx
== FACE_TTY_DEFAULT_FG_COLOR
)
1328 return build_string (unspecified_fg
);
1329 if (idx
== FACE_TTY_DEFAULT_BG_COLOR
)
1330 return build_string (unspecified_bg
);
1332 return Qunspecified
;
1336 /* Return non-zero if COLOR_NAME is a shade of gray (or white or
1339 The criterion implemented here is not a terribly sophisticated one. */
1342 face_color_gray_p (f
, color_name
)
1349 if (defined_color (f
, color_name
, &color
, 0))
1350 gray_p
= (/* Any color sufficiently close to black counts as grey. */
1351 (color
.red
< 5000 && color
.green
< 5000 && color
.blue
< 5000)
1353 ((eabs (color
.red
- color
.green
)
1354 < max (color
.red
, color
.green
) / 20)
1355 && (eabs (color
.green
- color
.blue
)
1356 < max (color
.green
, color
.blue
) / 20)
1357 && (eabs (color
.blue
- color
.red
)
1358 < max (color
.blue
, color
.red
) / 20)));
1366 /* Return non-zero if color COLOR_NAME can be displayed on frame F.
1367 BACKGROUND_P non-zero means the color will be used as background
1371 face_color_supported_p (f
, color_name
, background_p
)
1379 XSETFRAME (frame
, f
);
1381 #ifdef HAVE_WINDOW_SYSTEM
1383 ? (!NILP (Fxw_display_color_p (frame
))
1384 || xstricmp (color_name
, "black") == 0
1385 || xstricmp (color_name
, "white") == 0
1387 && face_color_gray_p (f
, color_name
))
1388 || (!NILP (Fx_display_grayscale_p (frame
))
1389 && face_color_gray_p (f
, color_name
)))
1392 tty_defined_color (f
, color_name
, ¬_used
, 0);
1396 DEFUN ("color-gray-p", Fcolor_gray_p
, Scolor_gray_p
, 1, 2, 0,
1397 doc
: /* Return non-nil if COLOR is a shade of gray (or white or black).
1398 FRAME specifies the frame and thus the display for interpreting COLOR.
1399 If FRAME is nil or omitted, use the selected frame. */)
1401 Lisp_Object color
, frame
;
1405 CHECK_STRING (color
);
1407 frame
= selected_frame
;
1409 CHECK_FRAME (frame
);
1411 return face_color_gray_p (f
, SDATA (color
)) ? Qt
: Qnil
;
1415 DEFUN ("color-supported-p", Fcolor_supported_p
,
1416 Scolor_supported_p
, 1, 3, 0,
1417 doc
: /* Return non-nil if COLOR can be displayed on FRAME.
1418 BACKGROUND-P non-nil means COLOR is used as a background.
1419 Otherwise, this function tells whether it can be used as a foreground.
1420 If FRAME is nil or omitted, use the selected frame.
1421 COLOR must be a valid color name. */)
1422 (color
, frame
, background_p
)
1423 Lisp_Object frame
, color
, background_p
;
1427 CHECK_STRING (color
);
1429 frame
= selected_frame
;
1431 CHECK_FRAME (frame
);
1433 if (face_color_supported_p (f
, SDATA (color
), !NILP (background_p
)))
1439 /* Load color with name NAME for use by face FACE on frame F.
1440 TARGET_INDEX must be one of LFACE_FOREGROUND_INDEX,
1441 LFACE_BACKGROUND_INDEX, LFACE_UNDERLINE_INDEX, LFACE_OVERLINE_INDEX,
1442 LFACE_STRIKE_THROUGH_INDEX, or LFACE_BOX_INDEX. Value is the
1443 pixel color. If color cannot be loaded, display a message, and
1444 return the foreground, background or underline color of F, but
1445 record that fact in flags of the face so that we don't try to free
1449 load_color (f
, face
, name
, target_index
)
1453 enum lface_attribute_index target_index
;
1457 xassert (STRINGP (name
));
1458 xassert (target_index
== LFACE_FOREGROUND_INDEX
1459 || target_index
== LFACE_BACKGROUND_INDEX
1460 || target_index
== LFACE_UNDERLINE_INDEX
1461 || target_index
== LFACE_OVERLINE_INDEX
1462 || target_index
== LFACE_STRIKE_THROUGH_INDEX
1463 || target_index
== LFACE_BOX_INDEX
);
1465 /* if the color map is full, defined_color will return a best match
1466 to the values in an existing cell. */
1467 if (!defined_color (f
, SDATA (name
), &color
, 1))
1469 add_to_log ("Unable to load color \"%s\"", name
, Qnil
);
1471 switch (target_index
)
1473 case LFACE_FOREGROUND_INDEX
:
1474 face
->foreground_defaulted_p
= 1;
1475 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1478 case LFACE_BACKGROUND_INDEX
:
1479 face
->background_defaulted_p
= 1;
1480 color
.pixel
= FRAME_BACKGROUND_PIXEL (f
);
1483 case LFACE_UNDERLINE_INDEX
:
1484 face
->underline_defaulted_p
= 1;
1485 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1488 case LFACE_OVERLINE_INDEX
:
1489 face
->overline_color_defaulted_p
= 1;
1490 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1493 case LFACE_STRIKE_THROUGH_INDEX
:
1494 face
->strike_through_color_defaulted_p
= 1;
1495 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1498 case LFACE_BOX_INDEX
:
1499 face
->box_color_defaulted_p
= 1;
1500 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1509 ++ncolors_allocated
;
1516 #ifdef HAVE_WINDOW_SYSTEM
1518 /* Load colors for face FACE which is used on frame F. Colors are
1519 specified by slots LFACE_BACKGROUND_INDEX and LFACE_FOREGROUND_INDEX
1520 of ATTRS. If the background color specified is not supported on F,
1521 try to emulate gray colors with a stipple from Vface_default_stipple. */
1524 load_face_colors (f
, face
, attrs
)
1531 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
1532 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
1534 /* Swap colors if face is inverse-video. */
1535 if (EQ (attrs
[LFACE_INVERSE_INDEX
], Qt
))
1543 /* Check for support for foreground, not for background because
1544 face_color_supported_p is smart enough to know that grays are
1545 "supported" as background because we are supposed to use stipple
1547 if (!face_color_supported_p (f
, SDATA (bg
), 0)
1548 && !NILP (Fbitmap_spec_p (Vface_default_stipple
)))
1550 x_destroy_bitmap (f
, face
->stipple
);
1551 face
->stipple
= load_pixmap (f
, Vface_default_stipple
,
1552 &face
->pixmap_w
, &face
->pixmap_h
);
1555 face
->background
= load_color (f
, face
, bg
, LFACE_BACKGROUND_INDEX
);
1556 face
->foreground
= load_color (f
, face
, fg
, LFACE_FOREGROUND_INDEX
);
1560 /* Free color PIXEL on frame F. */
1563 unload_color (f
, pixel
)
1565 unsigned long pixel
;
1567 #ifdef HAVE_X_WINDOWS
1571 x_free_colors (f
, &pixel
, 1);
1578 /* Free colors allocated for FACE. */
1581 free_face_colors (f
, face
)
1585 #ifdef HAVE_X_WINDOWS
1586 if (face
->colors_copied_bitwise_p
)
1591 if (!face
->foreground_defaulted_p
)
1593 x_free_colors (f
, &face
->foreground
, 1);
1594 IF_DEBUG (--ncolors_allocated
);
1597 if (!face
->background_defaulted_p
)
1599 x_free_colors (f
, &face
->background
, 1);
1600 IF_DEBUG (--ncolors_allocated
);
1603 if (face
->underline_p
1604 && !face
->underline_defaulted_p
)
1606 x_free_colors (f
, &face
->underline_color
, 1);
1607 IF_DEBUG (--ncolors_allocated
);
1610 if (face
->overline_p
1611 && !face
->overline_color_defaulted_p
)
1613 x_free_colors (f
, &face
->overline_color
, 1);
1614 IF_DEBUG (--ncolors_allocated
);
1617 if (face
->strike_through_p
1618 && !face
->strike_through_color_defaulted_p
)
1620 x_free_colors (f
, &face
->strike_through_color
, 1);
1621 IF_DEBUG (--ncolors_allocated
);
1624 if (face
->box
!= FACE_NO_BOX
1625 && !face
->box_color_defaulted_p
)
1627 x_free_colors (f
, &face
->box_color
, 1);
1628 IF_DEBUG (--ncolors_allocated
);
1632 #endif /* HAVE_X_WINDOWS */
1635 #endif /* HAVE_WINDOW_SYSTEM */
1639 /***********************************************************************
1641 ***********************************************************************/
1643 /* An enumerator for each field of an XLFD font name. */
1664 /* An enumerator for each possible slant value of a font. Taken from
1665 the XLFD specification. */
1673 XLFD_SLANT_REVERSE_ITALIC
,
1674 XLFD_SLANT_REVERSE_OBLIQUE
,
1678 /* Relative font weight according to XLFD documentation. */
1682 XLFD_WEIGHT_UNKNOWN
,
1683 XLFD_WEIGHT_ULTRA_LIGHT
, /* 10 */
1684 XLFD_WEIGHT_EXTRA_LIGHT
, /* 20 */
1685 XLFD_WEIGHT_LIGHT
, /* 30 */
1686 XLFD_WEIGHT_SEMI_LIGHT
, /* 40: SemiLight, Book, ... */
1687 XLFD_WEIGHT_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1688 XLFD_WEIGHT_SEMI_BOLD
, /* 60: SemiBold, DemiBold, ... */
1689 XLFD_WEIGHT_BOLD
, /* 70: Bold, ... */
1690 XLFD_WEIGHT_EXTRA_BOLD
, /* 80: ExtraBold, Heavy, ... */
1691 XLFD_WEIGHT_ULTRA_BOLD
/* 90: UltraBold, Black, ... */
1694 /* Relative proportionate width. */
1698 XLFD_SWIDTH_UNKNOWN
,
1699 XLFD_SWIDTH_ULTRA_CONDENSED
, /* 10 */
1700 XLFD_SWIDTH_EXTRA_CONDENSED
, /* 20 */
1701 XLFD_SWIDTH_CONDENSED
, /* 30: Condensed, Narrow, Compressed, ... */
1702 XLFD_SWIDTH_SEMI_CONDENSED
, /* 40: semicondensed */
1703 XLFD_SWIDTH_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1704 XLFD_SWIDTH_SEMI_EXPANDED
, /* 60: SemiExpanded, DemiExpanded, ... */
1705 XLFD_SWIDTH_EXPANDED
, /* 70: Expanded... */
1706 XLFD_SWIDTH_EXTRA_EXPANDED
, /* 80: ExtraExpanded, Wide... */
1707 XLFD_SWIDTH_ULTRA_EXPANDED
/* 90: UltraExpanded... */
1710 /* Structure used for tables mapping XLFD weight, slant, and width
1711 names to numeric and symbolic values. */
1717 Lisp_Object
*symbol
;
1720 /* Table of XLFD slant names and their numeric and symbolic
1721 representations. This table must be sorted by slant names in
1724 static struct table_entry slant_table
[] =
1726 {"i", XLFD_SLANT_ITALIC
, &Qitalic
},
1727 {"o", XLFD_SLANT_OBLIQUE
, &Qoblique
},
1728 {"ot", XLFD_SLANT_OTHER
, &Qitalic
},
1729 {"r", XLFD_SLANT_ROMAN
, &Qnormal
},
1730 {"ri", XLFD_SLANT_REVERSE_ITALIC
, &Qreverse_italic
},
1731 {"ro", XLFD_SLANT_REVERSE_OBLIQUE
, &Qreverse_oblique
}
1734 /* Table of XLFD weight names. This table must be sorted by weight
1735 names in ascending order. */
1737 static struct table_entry weight_table
[] =
1739 {"black", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
},
1740 {"bold", XLFD_WEIGHT_BOLD
, &Qbold
},
1741 {"book", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1742 {"demi", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1743 {"demibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1744 {"extralight", XLFD_WEIGHT_EXTRA_LIGHT
, &Qextra_light
},
1745 {"extrabold", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1746 {"heavy", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1747 {"light", XLFD_WEIGHT_LIGHT
, &Qlight
},
1748 {"medium", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1749 {"normal", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1750 {"regular", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1751 {"semibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1752 {"semilight", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1753 {"ultralight", XLFD_WEIGHT_ULTRA_LIGHT
, &Qultra_light
},
1754 {"ultrabold", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
}
1757 /* Table of XLFD width names. This table must be sorted by width
1758 names in ascending order. */
1760 static struct table_entry swidth_table
[] =
1762 {"compressed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1763 {"condensed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1764 {"demiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1765 {"expanded", XLFD_SWIDTH_EXPANDED
, &Qexpanded
},
1766 {"extracondensed", XLFD_SWIDTH_EXTRA_CONDENSED
, &Qextra_condensed
},
1767 {"extraexpanded", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
},
1768 {"medium", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1769 {"narrow", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1770 {"normal", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1771 {"regular", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1772 {"semicondensed", XLFD_SWIDTH_SEMI_CONDENSED
, &Qsemi_condensed
},
1773 {"semiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1774 {"ultracondensed", XLFD_SWIDTH_ULTRA_CONDENSED
, &Qultra_condensed
},
1775 {"ultraexpanded", XLFD_SWIDTH_ULTRA_EXPANDED
, &Qultra_expanded
},
1776 {"wide", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
}
1779 /* The frame in effect when sorting font names. Set temporarily in
1780 sort_fonts so that it is available in font comparison functions. */
1782 static struct frame
*font_frame
;
1784 /* Order by which font selection chooses fonts. The default values
1785 mean `first, find a best match for the font width, then for the
1786 font height, then for weight, then for slant.' This variable can be
1787 set via set-face-font-sort-order. */
1790 static int font_sort_order
[4] = {
1791 XLFD_SWIDTH
, XLFD_POINT_SIZE
, XLFD_WEIGHT
, XLFD_SLANT
1794 static int font_sort_order
[4];
1798 #ifdef HAVE_WINDOW_SYSTEM
1800 /* Return a rescaling ratio of a font of NAME. */
1803 font_rescale_ratio (name
)
1806 Lisp_Object tail
, elt
;
1808 for (tail
= Vface_font_rescale_alist
; CONSP (tail
); tail
= XCDR (tail
))
1811 if (STRINGP (XCAR (elt
)) && FLOATP (XCDR (elt
))
1812 && fast_c_string_match_ignore_case (XCAR (elt
), name
) >= 0)
1813 return XFLOAT_DATA (XCDR (elt
));
1818 static enum font_property_index font_props_for_sorting
[FONT_SIZE_INDEX
];
1821 compare_fonts_by_sort_order (v1
, v2
)
1822 const void *v1
, *v2
;
1824 Lisp_Object font1
= *(Lisp_Object
*) v1
;
1825 Lisp_Object font2
= *(Lisp_Object
*) v2
;
1828 for (i
= 0; i
< FONT_SIZE_INDEX
; i
++)
1830 enum font_property_index idx
= font_props_for_sorting
[i
];
1831 Lisp_Object val1
= AREF (font1
, idx
), val2
= AREF (font2
, idx
);
1834 if (idx
<= FONT_REGISTRY_INDEX
)
1837 result
= STRINGP (val2
) ? strcmp (SDATA (val1
), SDATA (val2
)) : -1;
1839 result
= STRINGP (val2
) ? 1 : 0;
1843 if (INTEGERP (val1
))
1844 result
= INTEGERP (val2
) ? XINT (val1
) - XINT (val2
) : -1;
1846 result
= INTEGERP (val2
) ? 1 : 0;
1854 DEFUN ("x-family-fonts", Fx_family_fonts
, Sx_family_fonts
, 0, 2, 0,
1855 doc
: /* Return a list of available fonts of family FAMILY on FRAME.
1856 If FAMILY is omitted or nil, list all families.
1857 Otherwise, FAMILY must be a string, possibly containing wildcards
1859 If FRAME is omitted or nil, use the selected frame.
1860 Each element of the result is a vector [FAMILY WIDTH POINT-SIZE WEIGHT
1861 SLANT FIXED-P FULL REGISTRY-AND-ENCODING].
1862 FAMILY is the font family name. POINT-SIZE is the size of the
1863 font in 1/10 pt. WIDTH, WEIGHT, and SLANT are symbols describing the
1864 width, weight and slant of the font. These symbols are the same as for
1865 face attributes. FIXED-P is non-nil if the font is fixed-pitch.
1866 FULL is the full name of the font, and REGISTRY-AND-ENCODING is a string
1867 giving the registry and encoding of the font.
1868 The result list is sorted according to the current setting of
1869 the face font sort order. */)
1871 Lisp_Object family
, frame
;
1873 struct frame
*f
= check_x_frame (frame
);
1874 Lisp_Object font_spec
= Qnil
, vec
;
1880 CHECK_STRING (family
);
1881 font_spec
= Ffont_spec (0, NULL
);
1882 Ffont_put (font_spec
, QCfamily
, family
);
1884 vec
= font_list_entities (frame
, font_spec
);
1885 nfonts
= ASIZE (vec
);
1890 for (i
= 0; i
< 4; i
++)
1891 switch (font_sort_order
[i
])
1894 font_props_for_sorting
[i
] = FONT_WIDTH_INDEX
; break;
1895 case XLFD_POINT_SIZE
:
1896 font_props_for_sorting
[i
] = FONT_SIZE_INDEX
; break;
1898 font_props_for_sorting
[i
] = FONT_WEIGHT_INDEX
; break;
1900 font_props_for_sorting
[i
] = FONT_SLANT_INDEX
; break;
1902 font_props_for_sorting
[i
++] = FONT_FAMILY_INDEX
;
1903 font_props_for_sorting
[i
++] = FONT_FOUNDRY_INDEX
;
1904 font_props_for_sorting
[i
++] = FONT_ADSTYLE_INDEX
;
1905 font_props_for_sorting
[i
++] = FONT_REGISTRY_INDEX
;
1907 qsort (XVECTOR (vec
)->contents
, nfonts
, sizeof (Lisp_Object
),
1908 compare_fonts_by_sort_order
);
1912 for (i
= nfonts
- 1; i
>= 0; --i
)
1914 Lisp_Object font
= AREF (vec
, i
);
1915 Lisp_Object v
= Fmake_vector (make_number (8), Qnil
);
1917 Lisp_Object spacing
;
1919 ASET (v
, 0, AREF (font
, FONT_FAMILY_INDEX
));
1920 ASET (v
, 1, FONT_WIDTH_SYMBOLIC (font
));
1921 point
= PIXEL_TO_POINT (XINT (AREF (font
, FONT_SIZE_INDEX
)) * 10,
1923 ASET (v
, 2, make_number (point
));
1924 ASET (v
, 3, FONT_WEIGHT_SYMBOLIC (font
));
1925 ASET (v
, 4, FONT_SLANT_SYMBOLIC (font
));
1926 spacing
= Ffont_get (font
, QCspacing
);
1927 ASET (v
, 5, (NILP (spacing
) || EQ (spacing
, Qp
)) ? Qnil
: Qt
);
1928 ASET (v
, 6, AREF (font
, FONT_NAME_INDEX
));
1929 ASET (v
, 7, AREF (font
, FONT_REGISTRY_INDEX
));
1931 result
= Fcons (v
, result
);
1938 DEFUN ("x-font-family-list", Fx_font_family_list
, Sx_font_family_list
,
1940 doc
: /* Return a list of available font families on FRAME.
1941 If FRAME is omitted or nil, use the selected frame.
1942 Value is a list of conses (FAMILY . FIXED-P) where FAMILY
1943 is a font family, and FIXED-P is non-nil if fonts of that family
1944 are fixed-pitch. */)
1948 return Ffont_family_list (frame
);
1952 DEFUN ("x-list-fonts", Fx_list_fonts
, Sx_list_fonts
, 1, 5, 0,
1953 doc
: /* Return a list of the names of available fonts matching PATTERN.
1954 If optional arguments FACE and FRAME are specified, return only fonts
1955 the same size as FACE on FRAME.
1956 PATTERN is a string, perhaps with wildcard characters;
1957 the * character matches any substring, and
1958 the ? character matches any single character.
1959 PATTERN is case-insensitive.
1960 FACE is a face name--a symbol.
1962 The return value is a list of strings, suitable as arguments to
1965 Fonts Emacs can't use may or may not be excluded
1966 even if they match PATTERN and FACE.
1967 The optional fourth argument MAXIMUM sets a limit on how many
1968 fonts to match. The first MAXIMUM fonts are reported.
1969 The optional fifth argument WIDTH, if specified, is a number of columns
1970 occupied by a character of a font. In that case, return only fonts
1971 the WIDTH times as wide as FACE on FRAME. */)
1972 (pattern
, face
, frame
, maximum
, width
)
1973 Lisp_Object pattern
, face
, frame
, maximum
, width
;
1979 CHECK_STRING (pattern
);
1981 if (! NILP (maximum
))
1982 CHECK_NATNUM (maximum
);
1985 CHECK_NUMBER (width
);
1987 /* We can't simply call check_x_frame because this function may be
1988 called before any frame is created. */
1990 frame
= selected_frame
;
1991 f
= frame_or_selected_frame (frame
, 2);
1992 if (! FRAME_WINDOW_P (f
))
1994 /* Perhaps we have not yet created any frame. */
2000 /* Determine the width standard for comparison with the fonts we find. */
2006 /* This is of limited utility since it works with character
2007 widths. Keep it for compatibility. --gerd. */
2008 int face_id
= lookup_named_face (f
, face
, 0);
2009 struct face
*face
= (face_id
< 0
2011 : FACE_FROM_ID (f
, face_id
));
2013 if (face
&& face
->font
)
2015 size
= face
->font
->pixel_size
;
2016 avgwidth
= face
->font
->average_width
;
2020 size
= FRAME_FONT (f
)->pixel_size
;
2021 avgwidth
= FRAME_FONT (f
)->average_width
;
2024 avgwidth
*= XINT (width
);
2028 Lisp_Object font_spec
;
2029 Lisp_Object args
[2];
2031 font_spec
= font_spec_from_name (pattern
);
2034 Ffont_put (font_spec
, QCsize
, make_number (size
));
2035 Ffont_put (font_spec
, QCavgwidth
, make_number (avgwidth
));
2037 args
[0] = Flist_fonts (font_spec
, frame
, maximum
, Qnil
);
2039 /* We don't have to check fontsets. */
2041 args
[1] = list_fontsets (f
, pattern
, size
);
2042 return Fnconc (2, args
);
2046 #endif /* HAVE_WINDOW_SYSTEM */
2050 /***********************************************************************
2052 ***********************************************************************/
2054 /* Access face attributes of face LFACE, a Lisp vector. */
2056 #define LFACE_FAMILY(LFACE) AREF ((LFACE), LFACE_FAMILY_INDEX)
2057 #define LFACE_HEIGHT(LFACE) AREF ((LFACE), LFACE_HEIGHT_INDEX)
2058 #define LFACE_WEIGHT(LFACE) AREF ((LFACE), LFACE_WEIGHT_INDEX)
2059 #define LFACE_SLANT(LFACE) AREF ((LFACE), LFACE_SLANT_INDEX)
2060 #define LFACE_UNDERLINE(LFACE) AREF ((LFACE), LFACE_UNDERLINE_INDEX)
2061 #define LFACE_INVERSE(LFACE) AREF ((LFACE), LFACE_INVERSE_INDEX)
2062 #define LFACE_FOREGROUND(LFACE) AREF ((LFACE), LFACE_FOREGROUND_INDEX)
2063 #define LFACE_BACKGROUND(LFACE) AREF ((LFACE), LFACE_BACKGROUND_INDEX)
2064 #define LFACE_STIPPLE(LFACE) AREF ((LFACE), LFACE_STIPPLE_INDEX)
2065 #define LFACE_SWIDTH(LFACE) AREF ((LFACE), LFACE_SWIDTH_INDEX)
2066 #define LFACE_OVERLINE(LFACE) AREF ((LFACE), LFACE_OVERLINE_INDEX)
2067 #define LFACE_STRIKE_THROUGH(LFACE) AREF ((LFACE), LFACE_STRIKE_THROUGH_INDEX)
2068 #define LFACE_BOX(LFACE) AREF ((LFACE), LFACE_BOX_INDEX)
2069 #define LFACE_FONT(LFACE) AREF ((LFACE), LFACE_FONT_INDEX)
2070 #define LFACE_INHERIT(LFACE) AREF ((LFACE), LFACE_INHERIT_INDEX)
2071 #define LFACE_FONTSET(LFACE) AREF ((LFACE), LFACE_FONTSET_INDEX)
2073 /* Non-zero if LFACE is a Lisp face. A Lisp face is a vector of size
2074 LFACE_VECTOR_SIZE which has the symbol `face' in slot 0. */
2076 #define LFACEP(LFACE) \
2078 && XVECTOR (LFACE)->size == LFACE_VECTOR_SIZE \
2079 && EQ (AREF (LFACE, 0), Qface))
2084 /* Check consistency of Lisp face attribute vector ATTRS. */
2087 check_lface_attrs (attrs
)
2090 xassert (UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
2091 || IGNORE_DEFFACE_P (attrs
[LFACE_FAMILY_INDEX
])
2092 || STRINGP (attrs
[LFACE_FAMILY_INDEX
]));
2093 xassert (UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
2094 || IGNORE_DEFFACE_P (attrs
[LFACE_SWIDTH_INDEX
])
2095 || SYMBOLP (attrs
[LFACE_SWIDTH_INDEX
]));
2096 xassert (UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
2097 || IGNORE_DEFFACE_P (attrs
[LFACE_HEIGHT_INDEX
])
2098 || INTEGERP (attrs
[LFACE_HEIGHT_INDEX
])
2099 || FLOATP (attrs
[LFACE_HEIGHT_INDEX
])
2100 || FUNCTIONP (attrs
[LFACE_HEIGHT_INDEX
]));
2101 xassert (UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
2102 || IGNORE_DEFFACE_P (attrs
[LFACE_WEIGHT_INDEX
])
2103 || SYMBOLP (attrs
[LFACE_WEIGHT_INDEX
]));
2104 xassert (UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
2105 || IGNORE_DEFFACE_P (attrs
[LFACE_SLANT_INDEX
])
2106 || SYMBOLP (attrs
[LFACE_SLANT_INDEX
]));
2107 xassert (UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
2108 || IGNORE_DEFFACE_P (attrs
[LFACE_UNDERLINE_INDEX
])
2109 || SYMBOLP (attrs
[LFACE_UNDERLINE_INDEX
])
2110 || STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]));
2111 xassert (UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
2112 || IGNORE_DEFFACE_P (attrs
[LFACE_OVERLINE_INDEX
])
2113 || SYMBOLP (attrs
[LFACE_OVERLINE_INDEX
])
2114 || STRINGP (attrs
[LFACE_OVERLINE_INDEX
]));
2115 xassert (UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
2116 || IGNORE_DEFFACE_P (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
2117 || SYMBOLP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
2118 || STRINGP (attrs
[LFACE_STRIKE_THROUGH_INDEX
]));
2119 xassert (UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
2120 || IGNORE_DEFFACE_P (attrs
[LFACE_BOX_INDEX
])
2121 || SYMBOLP (attrs
[LFACE_BOX_INDEX
])
2122 || STRINGP (attrs
[LFACE_BOX_INDEX
])
2123 || INTEGERP (attrs
[LFACE_BOX_INDEX
])
2124 || CONSP (attrs
[LFACE_BOX_INDEX
]));
2125 xassert (UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
2126 || IGNORE_DEFFACE_P (attrs
[LFACE_INVERSE_INDEX
])
2127 || SYMBOLP (attrs
[LFACE_INVERSE_INDEX
]));
2128 xassert (UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
2129 || IGNORE_DEFFACE_P (attrs
[LFACE_FOREGROUND_INDEX
])
2130 || STRINGP (attrs
[LFACE_FOREGROUND_INDEX
]));
2131 xassert (UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
2132 || IGNORE_DEFFACE_P (attrs
[LFACE_BACKGROUND_INDEX
])
2133 || STRINGP (attrs
[LFACE_BACKGROUND_INDEX
]));
2134 xassert (UNSPECIFIEDP (attrs
[LFACE_INHERIT_INDEX
])
2135 || IGNORE_DEFFACE_P (attrs
[LFACE_INHERIT_INDEX
])
2136 || NILP (attrs
[LFACE_INHERIT_INDEX
])
2137 || SYMBOLP (attrs
[LFACE_INHERIT_INDEX
])
2138 || CONSP (attrs
[LFACE_INHERIT_INDEX
]));
2139 #ifdef HAVE_WINDOW_SYSTEM
2140 xassert (UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
2141 || IGNORE_DEFFACE_P (attrs
[LFACE_STIPPLE_INDEX
])
2142 || SYMBOLP (attrs
[LFACE_STIPPLE_INDEX
])
2143 || !NILP (Fbitmap_spec_p (attrs
[LFACE_STIPPLE_INDEX
])));
2144 xassert (UNSPECIFIEDP (attrs
[LFACE_FONT_INDEX
])
2145 || IGNORE_DEFFACE_P (attrs
[LFACE_FONT_INDEX
])
2146 || FONTP (attrs
[LFACE_FONT_INDEX
]));
2147 xassert (UNSPECIFIEDP (attrs
[LFACE_FONTSET_INDEX
])
2148 || STRINGP (attrs
[LFACE_FONTSET_INDEX
]));
2153 /* Check consistency of attributes of Lisp face LFACE (a Lisp vector). */
2161 xassert (LFACEP (lface
));
2162 check_lface_attrs (XVECTOR (lface
)->contents
);
2166 #else /* GLYPH_DEBUG == 0 */
2168 #define check_lface_attrs(attrs) (void) 0
2169 #define check_lface(lface) (void) 0
2171 #endif /* GLYPH_DEBUG == 0 */
2175 /* Face-merge cycle checking. */
2177 /* A `named merge point' is simply a point during face-merging where we
2178 look up a face by name. We keep a stack of which named lookups we're
2179 currently processing so that we can easily detect cycles, using a
2180 linked- list of struct named_merge_point structures, typically
2181 allocated on the stack frame of the named lookup functions which are
2182 active (so no consing is required). */
2183 struct named_merge_point
2185 Lisp_Object face_name
;
2186 struct named_merge_point
*prev
;
2190 /* If a face merging cycle is detected for FACE_NAME, return 0,
2191 otherwise add NEW_NAMED_MERGE_POINT, which is initialized using
2192 FACE_NAME, as the head of the linked list pointed to by
2193 NAMED_MERGE_POINTS, and return 1. */
2196 push_named_merge_point (struct named_merge_point
*new_named_merge_point
,
2197 Lisp_Object face_name
,
2198 struct named_merge_point
**named_merge_points
)
2200 struct named_merge_point
*prev
;
2202 for (prev
= *named_merge_points
; prev
; prev
= prev
->prev
)
2203 if (EQ (face_name
, prev
->face_name
))
2206 new_named_merge_point
->face_name
= face_name
;
2207 new_named_merge_point
->prev
= *named_merge_points
;
2209 *named_merge_points
= new_named_merge_point
;
2216 #if 0 /* Seems to be unused. */
2218 internal_resolve_face_name (nargs
, args
)
2222 return Fget (args
[0], args
[1]);
2226 resolve_face_name_error (ignore
)
2233 /* Resolve face name FACE_NAME. If FACE_NAME is a string, intern it
2234 to make it a symbol. If FACE_NAME is an alias for another face,
2235 return that face's name.
2237 Return default face in case of errors. */
2240 resolve_face_name (face_name
, signal_p
)
2241 Lisp_Object face_name
;
2244 Lisp_Object orig_face
;
2245 Lisp_Object tortoise
, hare
;
2247 if (STRINGP (face_name
))
2248 face_name
= intern (SDATA (face_name
));
2250 if (NILP (face_name
) || !SYMBOLP (face_name
))
2253 orig_face
= face_name
;
2254 tortoise
= hare
= face_name
;
2259 hare
= Fget (hare
, Qface_alias
);
2260 if (NILP (hare
) || !SYMBOLP (hare
))
2264 hare
= Fget (hare
, Qface_alias
);
2265 if (NILP (hare
) || !SYMBOLP (hare
))
2268 tortoise
= Fget (tortoise
, Qface_alias
);
2269 if (EQ (hare
, tortoise
))
2272 xsignal1 (Qcircular_list
, orig_face
);
2281 /* Return the face definition of FACE_NAME on frame F. F null means
2282 return the definition for new frames. FACE_NAME may be a string or
2283 a symbol (apparently Emacs 20.2 allowed strings as face names in
2284 face text properties; Ediff uses that). If FACE_NAME is an alias
2285 for another face, return that face's definition. If SIGNAL_P is
2286 non-zero, signal an error if FACE_NAME is not a valid face name.
2287 If SIGNAL_P is zero, value is nil if FACE_NAME is not a valid face
2290 static INLINE Lisp_Object
2291 lface_from_face_name (f
, face_name
, signal_p
)
2293 Lisp_Object face_name
;
2298 face_name
= resolve_face_name (face_name
, signal_p
);
2301 lface
= assq_no_quit (face_name
, f
->face_alist
);
2303 lface
= assq_no_quit (face_name
, Vface_new_frame_defaults
);
2306 lface
= XCDR (lface
);
2308 signal_error ("Invalid face", face_name
);
2310 check_lface (lface
);
2315 /* Get face attributes of face FACE_NAME from frame-local faces on
2316 frame F. Store the resulting attributes in ATTRS which must point
2317 to a vector of Lisp_Objects of size LFACE_VECTOR_SIZE. If SIGNAL_P
2318 is non-zero, signal an error if FACE_NAME does not name a face.
2319 Otherwise, value is zero if FACE_NAME is not a face. */
2322 get_lface_attributes (f
, face_name
, attrs
, signal_p
)
2324 Lisp_Object face_name
;
2331 lface
= lface_from_face_name (f
, face_name
, signal_p
);
2334 bcopy (XVECTOR (lface
)->contents
, attrs
,
2335 LFACE_VECTOR_SIZE
* sizeof *attrs
);
2345 /* Non-zero if all attributes in face attribute vector ATTRS are
2346 specified, i.e. are non-nil. */
2349 lface_fully_specified_p (attrs
)
2354 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
2355 if (i
!= LFACE_FONT_INDEX
&& i
!= LFACE_INHERIT_INDEX
)
2356 if ((UNSPECIFIEDP (attrs
[i
]) || IGNORE_DEFFACE_P (attrs
[i
]))
2358 /* MAC_TODO: No stipple support on Mac OS yet, this index is
2359 always unspecified. */
2360 && i
!= LFACE_STIPPLE_INDEX
2365 return i
== LFACE_VECTOR_SIZE
;
2368 #ifdef HAVE_WINDOW_SYSTEM
2370 /* Set font-related attributes of Lisp face LFACE from FONT-OBJECT.
2371 If FORCE_P is zero, set only unspecified attributes of LFACE. The
2372 exception is `font' attribute. It is set to FONT_OBJECT regardless
2376 set_lface_from_font (f
, lface
, font_object
, force_p
)
2378 Lisp_Object lface
, font_object
;
2382 struct font
*font
= XFONT_OBJECT (font_object
);
2384 /* Set attributes only if unspecified, otherwise face defaults for
2385 new frames would never take effect. If the font doesn't have a
2386 specific property, set a normal value for that. */
2388 if (force_p
|| UNSPECIFIEDP (LFACE_FAMILY (lface
)))
2390 Lisp_Object foundry
= AREF (font_object
, FONT_FOUNDRY_INDEX
);
2391 Lisp_Object family
= AREF (font_object
, FONT_FAMILY_INDEX
);
2393 if (! NILP (foundry
))
2395 if (! NILP (family
))
2396 val
= concat3 (SYMBOL_NAME (foundry
), build_string ("-"),
2397 SYMBOL_NAME (family
));
2399 val
= concat2 (SYMBOL_NAME (foundry
), build_string ("-*"));
2403 if (! NILP (family
))
2404 val
= SYMBOL_NAME (family
);
2406 val
= build_string ("*");
2408 LFACE_FAMILY (lface
) = val
;
2411 if (force_p
|| UNSPECIFIEDP (LFACE_HEIGHT (lface
)))
2413 int pt
= PIXEL_TO_POINT (font
->pixel_size
* 10, f
->resy
);
2416 LFACE_HEIGHT (lface
) = make_number (pt
);
2419 if (force_p
|| UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
2421 val
= FONT_WEIGHT_FOR_FACE (font_object
);
2422 LFACE_WEIGHT (lface
) = ! NILP (val
) ? val
:Qnormal
;
2424 if (force_p
|| UNSPECIFIEDP (LFACE_SLANT (lface
)))
2426 val
= FONT_SLANT_FOR_FACE (font_object
);
2427 LFACE_SLANT (lface
) = ! NILP (val
) ? val
: Qnormal
;
2429 if (force_p
|| UNSPECIFIEDP (LFACE_SWIDTH (lface
)))
2431 val
= FONT_WIDTH_FOR_FACE (font_object
);
2432 LFACE_SWIDTH (lface
) = ! NILP (val
) ? val
: Qnormal
;
2435 LFACE_FONT (lface
) = font_object
;
2439 #endif /* HAVE_WINDOW_SYSTEM */
2442 /* Merges the face height FROM with the face height TO, and returns the
2443 merged height. If FROM is an invalid height, then INVALID is
2444 returned instead. FROM and TO may be either absolute face heights or
2445 `relative' heights; the returned value is always an absolute height
2446 unless both FROM and TO are relative. GCPRO is a lisp value that
2447 will be protected from garbage-collection if this function makes a
2451 merge_face_heights (from
, to
, invalid
)
2452 Lisp_Object from
, to
, invalid
;
2454 Lisp_Object result
= invalid
;
2456 if (INTEGERP (from
))
2457 /* FROM is absolute, just use it as is. */
2459 else if (FLOATP (from
))
2460 /* FROM is a scale, use it to adjust TO. */
2463 /* relative X absolute => absolute */
2464 result
= make_number ((EMACS_INT
)(XFLOAT_DATA (from
) * XINT (to
)));
2465 else if (FLOATP (to
))
2466 /* relative X relative => relative */
2467 result
= make_float (XFLOAT_DATA (from
) * XFLOAT_DATA (to
));
2468 else if (UNSPECIFIEDP (to
))
2471 else if (FUNCTIONP (from
))
2472 /* FROM is a function, which use to adjust TO. */
2474 /* Call function with current height as argument.
2475 From is the new height. */
2476 Lisp_Object args
[2];
2480 result
= safe_call (2, args
);
2482 /* Ensure that if TO was absolute, so is the result. */
2483 if (INTEGERP (to
) && !INTEGERP (result
))
2491 /* Merge two Lisp face attribute vectors on frame F, FROM and TO, and
2492 store the resulting attributes in TO, which must be already be
2493 completely specified and contain only absolute attributes. Every
2494 specified attribute of FROM overrides the corresponding attribute of
2495 TO; relative attributes in FROM are merged with the absolute value in
2496 TO and replace it. NAMED_MERGE_POINTS is used internally to detect
2497 loops in face inheritance; it should be 0 when called from other
2501 merge_face_vectors (f
, from
, to
, named_merge_points
)
2503 Lisp_Object
*from
, *to
;
2504 struct named_merge_point
*named_merge_points
;
2508 /* If FROM inherits from some other faces, merge their attributes into
2509 TO before merging FROM's direct attributes. Note that an :inherit
2510 attribute of `unspecified' is the same as one of nil; we never
2511 merge :inherit attributes, so nil is more correct, but lots of
2512 other code uses `unspecified' as a generic value for face attributes. */
2513 if (!UNSPECIFIEDP (from
[LFACE_INHERIT_INDEX
])
2514 && !NILP (from
[LFACE_INHERIT_INDEX
]))
2515 merge_face_ref (f
, from
[LFACE_INHERIT_INDEX
], to
, 0, named_merge_points
);
2517 i
= LFACE_FONT_INDEX
;
2518 if (!UNSPECIFIEDP (from
[i
]))
2520 if (!UNSPECIFIEDP (to
[i
]))
2521 to
[i
] = Fmerge_font_spec (from
[i
], to
[i
]);
2523 to
[i
] = Fcopy_font_spec (from
[i
]);
2524 ASET (to
[i
], FONT_SIZE_INDEX
, Qnil
);
2527 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
2528 if (!UNSPECIFIEDP (from
[i
]))
2530 if (i
== LFACE_HEIGHT_INDEX
&& !INTEGERP (from
[i
]))
2532 to
[i
] = merge_face_heights (from
[i
], to
[i
], to
[i
]);
2533 font_clear_prop (to
, FONT_SIZE_INDEX
);
2535 else if (i
!= LFACE_FONT_INDEX
)
2538 if (i
>= LFACE_FAMILY_INDEX
&& i
<=LFACE_SLANT_INDEX
)
2539 font_clear_prop (to
,
2540 (i
== LFACE_FAMILY_INDEX
? FONT_FAMILY_INDEX
2541 : i
== LFACE_SWIDTH_INDEX
? FONT_WIDTH_INDEX
2542 : i
== LFACE_HEIGHT_INDEX
? FONT_SIZE_INDEX
2543 : i
== LFACE_WEIGHT_INDEX
? FONT_WEIGHT_INDEX
2544 : FONT_SLANT_INDEX
));
2548 /* If `font' attribute is specified, reflect the font properties in
2549 it to the other attributes. */
2550 if (0 && !UNSPECIFIEDP (to
[LFACE_FONT_INDEX
]))
2551 font_update_lface (f
, to
);
2553 /* TO is always an absolute face, which should inherit from nothing.
2554 We blindly copy the :inherit attribute above and fix it up here. */
2555 to
[LFACE_INHERIT_INDEX
] = Qnil
;
2558 /* Merge the named face FACE_NAME on frame F, into the vector of face
2559 attributes TO. NAMED_MERGE_POINTS is used to detect loops in face
2560 inheritance. Returns true if FACE_NAME is a valid face name and
2561 merging succeeded. */
2564 merge_named_face (f
, face_name
, to
, named_merge_points
)
2566 Lisp_Object face_name
;
2568 struct named_merge_point
*named_merge_points
;
2570 struct named_merge_point named_merge_point
;
2572 if (push_named_merge_point (&named_merge_point
,
2573 face_name
, &named_merge_points
))
2575 struct gcpro gcpro1
;
2576 Lisp_Object from
[LFACE_VECTOR_SIZE
];
2577 int ok
= get_lface_attributes (f
, face_name
, from
, 0);
2581 GCPRO1 (named_merge_point
.face_name
);
2582 merge_face_vectors (f
, from
, to
, named_merge_points
);
2593 /* Merge face attributes from the lisp `face reference' FACE_REF on
2594 frame F into the face attribute vector TO. If ERR_MSGS is non-zero,
2595 problems with FACE_REF cause an error message to be shown. Return
2596 non-zero if no errors occurred (regardless of the value of ERR_MSGS).
2597 NAMED_MERGE_POINTS is used to detect loops in face inheritance or
2598 list structure; it may be 0 for most callers.
2600 FACE_REF may be a single face specification or a list of such
2601 specifications. Each face specification can be:
2603 1. A symbol or string naming a Lisp face.
2605 2. A property list of the form (KEYWORD VALUE ...) where each
2606 KEYWORD is a face attribute name, and value is an appropriate value
2609 3. Conses or the form (FOREGROUND-COLOR . COLOR) or
2610 (BACKGROUND-COLOR . COLOR) where COLOR is a color name. This is
2611 for compatibility with 20.2.
2613 Face specifications earlier in lists take precedence over later
2617 merge_face_ref (f
, face_ref
, to
, err_msgs
, named_merge_points
)
2619 Lisp_Object face_ref
;
2622 struct named_merge_point
*named_merge_points
;
2624 int ok
= 1; /* Succeed without an error? */
2626 if (CONSP (face_ref
))
2628 Lisp_Object first
= XCAR (face_ref
);
2630 if (EQ (first
, Qforeground_color
)
2631 || EQ (first
, Qbackground_color
))
2633 /* One of (FOREGROUND-COLOR . COLOR) or (BACKGROUND-COLOR
2634 . COLOR). COLOR must be a string. */
2635 Lisp_Object color_name
= XCDR (face_ref
);
2636 Lisp_Object color
= first
;
2638 if (STRINGP (color_name
))
2640 if (EQ (color
, Qforeground_color
))
2641 to
[LFACE_FOREGROUND_INDEX
] = color_name
;
2643 to
[LFACE_BACKGROUND_INDEX
] = color_name
;
2648 add_to_log ("Invalid face color", color_name
, Qnil
);
2652 else if (SYMBOLP (first
)
2653 && *SDATA (SYMBOL_NAME (first
)) == ':')
2655 /* Assume this is the property list form. */
2656 while (CONSP (face_ref
) && CONSP (XCDR (face_ref
)))
2658 Lisp_Object keyword
= XCAR (face_ref
);
2659 Lisp_Object value
= XCAR (XCDR (face_ref
));
2662 /* Specifying `unspecified' is a no-op. */
2663 if (EQ (value
, Qunspecified
))
2665 else if (EQ (keyword
, QCfamily
))
2667 if (STRINGP (value
))
2669 to
[LFACE_FAMILY_INDEX
] = value
;
2670 font_clear_prop (to
, FONT_FAMILY_INDEX
);
2675 else if (EQ (keyword
, QCheight
))
2677 Lisp_Object new_height
=
2678 merge_face_heights (value
, to
[LFACE_HEIGHT_INDEX
], Qnil
);
2680 if (! NILP (new_height
))
2682 to
[LFACE_HEIGHT_INDEX
] = new_height
;
2683 font_clear_prop (to
, FONT_SIZE_INDEX
);
2688 else if (EQ (keyword
, QCweight
))
2690 if (SYMBOLP (value
) && FONT_WEIGHT_NAME_NUMERIC (value
) >= 0)
2692 to
[LFACE_WEIGHT_INDEX
] = value
;
2693 font_clear_prop (to
, FONT_WEIGHT_INDEX
);
2698 else if (EQ (keyword
, QCslant
))
2700 if (SYMBOLP (value
) && FONT_SLANT_NAME_NUMERIC (value
) >= 0)
2702 to
[LFACE_SLANT_INDEX
] = value
;
2703 font_clear_prop (to
, FONT_SLANT_INDEX
);
2708 else if (EQ (keyword
, QCunderline
))
2713 to
[LFACE_UNDERLINE_INDEX
] = value
;
2717 else if (EQ (keyword
, QCoverline
))
2722 to
[LFACE_OVERLINE_INDEX
] = value
;
2726 else if (EQ (keyword
, QCstrike_through
))
2731 to
[LFACE_STRIKE_THROUGH_INDEX
] = value
;
2735 else if (EQ (keyword
, QCbox
))
2738 value
= make_number (1);
2739 if (INTEGERP (value
)
2743 to
[LFACE_BOX_INDEX
] = value
;
2747 else if (EQ (keyword
, QCinverse_video
)
2748 || EQ (keyword
, QCreverse_video
))
2750 if (EQ (value
, Qt
) || NILP (value
))
2751 to
[LFACE_INVERSE_INDEX
] = value
;
2755 else if (EQ (keyword
, QCforeground
))
2757 if (STRINGP (value
))
2758 to
[LFACE_FOREGROUND_INDEX
] = value
;
2762 else if (EQ (keyword
, QCbackground
))
2764 if (STRINGP (value
))
2765 to
[LFACE_BACKGROUND_INDEX
] = value
;
2769 else if (EQ (keyword
, QCstipple
))
2771 #ifdef HAVE_X_WINDOWS
2772 Lisp_Object pixmap_p
= Fbitmap_spec_p (value
);
2773 if (!NILP (pixmap_p
))
2774 to
[LFACE_STIPPLE_INDEX
] = value
;
2779 else if (EQ (keyword
, QCwidth
))
2781 if (SYMBOLP (value
) && FONT_WIDTH_NAME_NUMERIC (value
) >= 0)
2783 to
[LFACE_SWIDTH_INDEX
] = value
;
2784 font_clear_prop (to
, FONT_WIDTH_INDEX
);
2789 else if (EQ (keyword
, QCinherit
))
2791 /* This is not really very useful; it's just like a
2792 normal face reference. */
2793 if (! merge_face_ref (f
, value
, to
,
2794 err_msgs
, named_merge_points
))
2802 add_to_log ("Invalid face attribute %S %S", keyword
, value
);
2806 face_ref
= XCDR (XCDR (face_ref
));
2811 /* This is a list of face refs. Those at the beginning of the
2812 list take precedence over what follows, so we have to merge
2813 from the end backwards. */
2814 Lisp_Object next
= XCDR (face_ref
);
2817 ok
= merge_face_ref (f
, next
, to
, err_msgs
, named_merge_points
);
2819 if (! merge_face_ref (f
, first
, to
, err_msgs
, named_merge_points
))
2825 /* FACE_REF ought to be a face name. */
2826 ok
= merge_named_face (f
, face_ref
, to
, named_merge_points
);
2827 if (!ok
&& err_msgs
)
2828 add_to_log ("Invalid face reference: %s", face_ref
, Qnil
);
2835 DEFUN ("internal-make-lisp-face", Finternal_make_lisp_face
,
2836 Sinternal_make_lisp_face
, 1, 2, 0,
2837 doc
: /* Make FACE, a symbol, a Lisp face with all attributes nil.
2838 If FACE was not known as a face before, create a new one.
2839 If optional argument FRAME is specified, make a frame-local face
2840 for that frame. Otherwise operate on the global face definition.
2841 Value is a vector of face attributes. */)
2843 Lisp_Object face
, frame
;
2845 Lisp_Object global_lface
, lface
;
2849 CHECK_SYMBOL (face
);
2850 global_lface
= lface_from_face_name (NULL
, face
, 0);
2854 CHECK_LIVE_FRAME (frame
);
2856 lface
= lface_from_face_name (f
, face
, 0);
2859 f
= NULL
, lface
= Qnil
;
2861 /* Add a global definition if there is none. */
2862 if (NILP (global_lface
))
2864 global_lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
2866 ASET (global_lface
, 0, Qface
);
2867 Vface_new_frame_defaults
= Fcons (Fcons (face
, global_lface
),
2868 Vface_new_frame_defaults
);
2870 /* Assign the new Lisp face a unique ID. The mapping from Lisp
2871 face id to Lisp face is given by the vector lface_id_to_name.
2872 The mapping from Lisp face to Lisp face id is given by the
2873 property `face' of the Lisp face name. */
2874 if (next_lface_id
== lface_id_to_name_size
)
2876 int new_size
= max (50, 2 * lface_id_to_name_size
);
2877 int sz
= new_size
* sizeof *lface_id_to_name
;
2878 lface_id_to_name
= (Lisp_Object
*) xrealloc (lface_id_to_name
, sz
);
2879 lface_id_to_name_size
= new_size
;
2882 lface_id_to_name
[next_lface_id
] = face
;
2883 Fput (face
, Qface
, make_number (next_lface_id
));
2887 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
2888 ASET (global_lface
, i
, Qunspecified
);
2890 /* Add a frame-local definition. */
2895 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
2897 ASET (lface
, 0, Qface
);
2898 f
->face_alist
= Fcons (Fcons (face
, lface
), f
->face_alist
);
2901 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
2902 ASET (lface
, i
, Qunspecified
);
2905 lface
= global_lface
;
2907 /* Changing a named face means that all realized faces depending on
2908 that face are invalid. Since we cannot tell which realized faces
2909 depend on the face, make sure they are all removed. This is done
2910 by incrementing face_change_count. The next call to
2911 init_iterator will then free realized faces. */
2912 if (NILP (Fget (face
, Qface_no_inherit
)))
2914 ++face_change_count
;
2915 ++windows_or_buffers_changed
;
2918 xassert (LFACEP (lface
));
2919 check_lface (lface
);
2924 DEFUN ("internal-lisp-face-p", Finternal_lisp_face_p
,
2925 Sinternal_lisp_face_p
, 1, 2, 0,
2926 doc
: /* Return non-nil if FACE names a face.
2927 If optional second argument FRAME is non-nil, check for the
2928 existence of a frame-local face with name FACE on that frame.
2929 Otherwise check for the existence of a global face. */)
2931 Lisp_Object face
, frame
;
2935 face
= resolve_face_name (face
, 1);
2939 CHECK_LIVE_FRAME (frame
);
2940 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
2943 lface
= lface_from_face_name (NULL
, face
, 0);
2949 DEFUN ("internal-copy-lisp-face", Finternal_copy_lisp_face
,
2950 Sinternal_copy_lisp_face
, 4, 4, 0,
2951 doc
: /* Copy face FROM to TO.
2952 If FRAME is t, copy the global face definition of FROM.
2953 Otherwise, copy the frame-local definition of FROM on FRAME.
2954 If NEW-FRAME is a frame, copy that data into the frame-local
2955 definition of TO on NEW-FRAME. If NEW-FRAME is nil.
2956 FRAME controls where the data is copied to.
2958 The value is TO. */)
2959 (from
, to
, frame
, new_frame
)
2960 Lisp_Object from
, to
, frame
, new_frame
;
2962 Lisp_Object lface
, copy
;
2964 CHECK_SYMBOL (from
);
2969 /* Copy global definition of FROM. We don't make copies of
2970 strings etc. because 20.2 didn't do it either. */
2971 lface
= lface_from_face_name (NULL
, from
, 1);
2972 copy
= Finternal_make_lisp_face (to
, Qnil
);
2976 /* Copy frame-local definition of FROM. */
2977 if (NILP (new_frame
))
2979 CHECK_LIVE_FRAME (frame
);
2980 CHECK_LIVE_FRAME (new_frame
);
2981 lface
= lface_from_face_name (XFRAME (frame
), from
, 1);
2982 copy
= Finternal_make_lisp_face (to
, new_frame
);
2985 bcopy (XVECTOR (lface
)->contents
, XVECTOR (copy
)->contents
,
2986 LFACE_VECTOR_SIZE
* sizeof (Lisp_Object
));
2988 /* Changing a named face means that all realized faces depending on
2989 that face are invalid. Since we cannot tell which realized faces
2990 depend on the face, make sure they are all removed. This is done
2991 by incrementing face_change_count. The next call to
2992 init_iterator will then free realized faces. */
2993 if (NILP (Fget (to
, Qface_no_inherit
)))
2995 ++face_change_count
;
2996 ++windows_or_buffers_changed
;
3003 DEFUN ("internal-set-lisp-face-attribute", Finternal_set_lisp_face_attribute
,
3004 Sinternal_set_lisp_face_attribute
, 3, 4, 0,
3005 doc
: /* Set attribute ATTR of FACE to VALUE.
3006 FRAME being a frame means change the face on that frame.
3007 FRAME nil means change the face of the selected frame.
3008 FRAME t means change the default for new frames.
3009 FRAME 0 means change the face on all frames, and change the default
3011 (face
, attr
, value
, frame
)
3012 Lisp_Object face
, attr
, value
, frame
;
3015 Lisp_Object old_value
= Qnil
;
3016 /* Set one of enum font_property_index (> 0) if ATTR is one of
3017 font-related attributes other than QCfont and QCfontset. */
3018 enum font_property_index prop_index
= 0;
3020 CHECK_SYMBOL (face
);
3021 CHECK_SYMBOL (attr
);
3023 face
= resolve_face_name (face
, 1);
3025 /* If FRAME is 0, change face on all frames, and change the
3026 default for new frames. */
3027 if (INTEGERP (frame
) && XINT (frame
) == 0)
3030 Finternal_set_lisp_face_attribute (face
, attr
, value
, Qt
);
3031 FOR_EACH_FRAME (tail
, frame
)
3032 Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
3036 /* Set lface to the Lisp attribute vector of FACE. */
3039 lface
= lface_from_face_name (NULL
, face
, 1);
3041 /* When updating face-new-frame-defaults, we put :ignore-defface
3042 where the caller wants `unspecified'. This forces the frame
3043 defaults to ignore the defface value. Otherwise, the defface
3044 will take effect, which is generally not what is intended.
3045 The value of that attribute will be inherited from some other
3046 face during face merging. See internal_merge_in_global_face. */
3047 if (UNSPECIFIEDP (value
))
3048 value
= Qignore_defface
;
3053 frame
= selected_frame
;
3055 CHECK_LIVE_FRAME (frame
);
3056 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
3058 /* If a frame-local face doesn't exist yet, create one. */
3060 lface
= Finternal_make_lisp_face (face
, frame
);
3063 if (EQ (attr
, QCfamily
))
3065 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
3067 CHECK_STRING (value
);
3068 if (SCHARS (value
) == 0)
3069 signal_error ("Invalid face family", value
);
3071 old_value
= LFACE_FAMILY (lface
);
3072 LFACE_FAMILY (lface
) = value
;
3073 prop_index
= FONT_FAMILY_INDEX
;
3075 else if (EQ (attr
, QCheight
))
3077 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
3081 test
= (EQ (face
, Qdefault
)
3083 /* The default face must have an absolute size,
3084 otherwise, we do a test merge with a random
3085 height to see if VALUE's ok. */
3086 : merge_face_heights (value
, make_number (10), Qnil
));
3088 if (!INTEGERP (test
) || XINT (test
) <= 0)
3089 signal_error ("Invalid face height", value
);
3092 old_value
= LFACE_HEIGHT (lface
);
3093 LFACE_HEIGHT (lface
) = value
;
3094 prop_index
= FONT_SIZE_INDEX
;
3096 else if (EQ (attr
, QCweight
))
3098 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
3100 CHECK_SYMBOL (value
);
3101 if (FONT_WEIGHT_NAME_NUMERIC (value
) < 0)
3102 signal_error ("Invalid face weight", value
);
3104 old_value
= LFACE_WEIGHT (lface
);
3105 LFACE_WEIGHT (lface
) = value
;
3106 prop_index
= FONT_WEIGHT_INDEX
;
3108 else if (EQ (attr
, QCslant
))
3110 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
3112 CHECK_SYMBOL (value
);
3113 if (FONT_SLANT_NAME_NUMERIC (value
) < 0)
3114 signal_error ("Invalid face slant", value
);
3116 old_value
= LFACE_SLANT (lface
);
3117 LFACE_SLANT (lface
) = value
;
3118 prop_index
= FONT_SLANT_INDEX
;
3120 else if (EQ (attr
, QCunderline
))
3122 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
3123 if ((SYMBOLP (value
)
3125 && !EQ (value
, Qnil
))
3126 /* Underline color. */
3128 && SCHARS (value
) == 0))
3129 signal_error ("Invalid face underline", value
);
3131 old_value
= LFACE_UNDERLINE (lface
);
3132 LFACE_UNDERLINE (lface
) = value
;
3134 else if (EQ (attr
, QCoverline
))
3136 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
3137 if ((SYMBOLP (value
)
3139 && !EQ (value
, Qnil
))
3140 /* Overline color. */
3142 && SCHARS (value
) == 0))
3143 signal_error ("Invalid face overline", value
);
3145 old_value
= LFACE_OVERLINE (lface
);
3146 LFACE_OVERLINE (lface
) = value
;
3148 else if (EQ (attr
, QCstrike_through
))
3150 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
3151 if ((SYMBOLP (value
)
3153 && !EQ (value
, Qnil
))
3154 /* Strike-through color. */
3156 && SCHARS (value
) == 0))
3157 signal_error ("Invalid face strike-through", value
);
3159 old_value
= LFACE_STRIKE_THROUGH (lface
);
3160 LFACE_STRIKE_THROUGH (lface
) = value
;
3162 else if (EQ (attr
, QCbox
))
3166 /* Allow t meaning a simple box of width 1 in foreground color
3169 value
= make_number (1);
3171 if (UNSPECIFIEDP (value
) || IGNORE_DEFFACE_P (value
))
3173 else if (NILP (value
))
3175 else if (INTEGERP (value
))
3176 valid_p
= XINT (value
) != 0;
3177 else if (STRINGP (value
))
3178 valid_p
= SCHARS (value
) > 0;
3179 else if (CONSP (value
))
3195 if (EQ (k
, QCline_width
))
3197 if (!INTEGERP (v
) || XINT (v
) == 0)
3200 else if (EQ (k
, QCcolor
))
3202 if (!NILP (v
) && (!STRINGP (v
) || SCHARS (v
) == 0))
3205 else if (EQ (k
, QCstyle
))
3207 if (!EQ (v
, Qpressed_button
) && !EQ (v
, Qreleased_button
))
3214 valid_p
= NILP (tem
);
3220 signal_error ("Invalid face box", value
);
3222 old_value
= LFACE_BOX (lface
);
3223 LFACE_BOX (lface
) = value
;
3225 else if (EQ (attr
, QCinverse_video
)
3226 || EQ (attr
, QCreverse_video
))
3228 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
3230 CHECK_SYMBOL (value
);
3231 if (!EQ (value
, Qt
) && !NILP (value
))
3232 signal_error ("Invalid inverse-video face attribute value", value
);
3234 old_value
= LFACE_INVERSE (lface
);
3235 LFACE_INVERSE (lface
) = value
;
3237 else if (EQ (attr
, QCforeground
))
3239 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
3241 /* Don't check for valid color names here because it depends
3242 on the frame (display) whether the color will be valid
3243 when the face is realized. */
3244 CHECK_STRING (value
);
3245 if (SCHARS (value
) == 0)
3246 signal_error ("Empty foreground color value", value
);
3248 old_value
= LFACE_FOREGROUND (lface
);
3249 LFACE_FOREGROUND (lface
) = value
;
3251 else if (EQ (attr
, QCbackground
))
3253 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
3255 /* Don't check for valid color names here because it depends
3256 on the frame (display) whether the color will be valid
3257 when the face is realized. */
3258 CHECK_STRING (value
);
3259 if (SCHARS (value
) == 0)
3260 signal_error ("Empty background color value", value
);
3262 old_value
= LFACE_BACKGROUND (lface
);
3263 LFACE_BACKGROUND (lface
) = value
;
3265 else if (EQ (attr
, QCstipple
))
3267 #ifdef HAVE_X_WINDOWS
3268 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
)
3270 && NILP (Fbitmap_spec_p (value
)))
3271 signal_error ("Invalid stipple attribute", value
);
3272 old_value
= LFACE_STIPPLE (lface
);
3273 LFACE_STIPPLE (lface
) = value
;
3274 #endif /* HAVE_X_WINDOWS */
3276 else if (EQ (attr
, QCwidth
))
3278 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
3280 CHECK_SYMBOL (value
);
3281 if (FONT_WIDTH_NAME_NUMERIC (value
) < 0)
3282 signal_error ("Invalid face width", value
);
3284 old_value
= LFACE_SWIDTH (lface
);
3285 LFACE_SWIDTH (lface
) = value
;
3286 prop_index
= FONT_WIDTH_INDEX
;
3288 else if (EQ (attr
, QCfont
))
3290 #ifdef HAVE_WINDOW_SYSTEM
3291 if (EQ (frame
, Qt
) || FRAME_WINDOW_P (XFRAME (frame
)))
3293 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
3297 old_value
= LFACE_FONT (lface
);
3298 if (! FONTP (value
))
3300 if (STRINGP (value
))
3302 int fontset
= fs_query_fontset (value
, 0);
3305 value
= fontset_ascii (fontset
);
3306 value
= font_spec_from_name (value
);
3309 signal_error ("Invalid font or font-spec", value
);
3312 f
= XFRAME (selected_frame
);
3315 if (! FONT_OBJECT_P (value
))
3317 Lisp_Object
*attrs
= XVECTOR (lface
)->contents
;
3318 Lisp_Object font_object
;
3320 font_object
= font_load_for_lface (f
, attrs
, value
);
3321 if (NILP (font_object
))
3322 signal_error ("Font not available", value
);
3323 value
= font_object
;
3325 set_lface_from_font (f
, lface
, value
, 1);
3328 LFACE_FONT (lface
) = value
;
3330 #endif /* HAVE_WINDOW_SYSTEM */
3332 else if (EQ (attr
, QCfontset
))
3334 #ifdef HAVE_WINDOW_SYSTEM
3335 if (EQ (frame
, Qt
) || FRAME_WINDOW_P (XFRAME (frame
)))
3339 old_value
= LFACE_FONTSET (lface
);
3340 tmp
= Fquery_fontset (value
, Qnil
);
3342 signal_error ("Invalid fontset name", value
);
3343 LFACE_FONTSET (lface
) = value
= tmp
;
3345 #endif /* HAVE_WINDOW_SYSTEM */
3347 else if (EQ (attr
, QCinherit
))
3350 if (SYMBOLP (value
))
3353 for (tail
= value
; CONSP (tail
); tail
= XCDR (tail
))
3354 if (!SYMBOLP (XCAR (tail
)))
3357 LFACE_INHERIT (lface
) = value
;
3359 signal_error ("Invalid face inheritance", value
);
3361 else if (EQ (attr
, QCbold
))
3363 old_value
= LFACE_WEIGHT (lface
);
3364 LFACE_WEIGHT (lface
) = NILP (value
) ? Qnormal
: Qbold
;
3365 prop_index
= FONT_WEIGHT_INDEX
;
3367 else if (EQ (attr
, QCitalic
))
3370 old_value
= LFACE_SLANT (lface
);
3371 LFACE_SLANT (lface
) = NILP (value
) ? Qnormal
: Qitalic
;
3372 prop_index
= FONT_SLANT_INDEX
;
3375 signal_error ("Invalid face attribute name", attr
);
3378 /* If a font-related attribute other than QCfont and QCfontset is
3379 specified, and if the original QCfont attribute has a font
3380 (font-spec or font-object), set the corresponding property in
3381 the font to nil so that the font selector doesn't think that
3382 the attribute is mandatory. */
3383 font_clear_prop (XVECTOR (lface
)->contents
, prop_index
);
3385 /* Changing a named face means that all realized faces depending on
3386 that face are invalid. Since we cannot tell which realized faces
3387 depend on the face, make sure they are all removed. This is done
3388 by incrementing face_change_count. The next call to
3389 init_iterator will then free realized faces. */
3391 && NILP (Fget (face
, Qface_no_inherit
))
3392 && NILP (Fequal (old_value
, value
)))
3394 ++face_change_count
;
3395 ++windows_or_buffers_changed
;
3398 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
)
3399 && NILP (Fequal (old_value
, value
)))
3405 if (EQ (face
, Qdefault
))
3407 #ifdef HAVE_WINDOW_SYSTEM
3408 /* Changed font-related attributes of the `default' face are
3409 reflected in changed `font' frame parameters. */
3411 && (prop_index
|| EQ (attr
, QCfont
))
3412 && lface_fully_specified_p (XVECTOR (lface
)->contents
))
3413 set_font_frame_param (frame
, lface
);
3415 #endif /* HAVE_WINDOW_SYSTEM */
3417 if (EQ (attr
, QCforeground
))
3418 param
= Qforeground_color
;
3419 else if (EQ (attr
, QCbackground
))
3420 param
= Qbackground_color
;
3422 #ifdef HAVE_WINDOW_SYSTEM
3424 else if (EQ (face
, Qscroll_bar
))
3426 /* Changing the colors of `scroll-bar' sets frame parameters
3427 `scroll-bar-foreground' and `scroll-bar-background'. */
3428 if (EQ (attr
, QCforeground
))
3429 param
= Qscroll_bar_foreground
;
3430 else if (EQ (attr
, QCbackground
))
3431 param
= Qscroll_bar_background
;
3433 #endif /* not WINDOWSNT */
3434 else if (EQ (face
, Qborder
))
3436 /* Changing background color of `border' sets frame parameter
3438 if (EQ (attr
, QCbackground
))
3439 param
= Qborder_color
;
3441 else if (EQ (face
, Qcursor
))
3443 /* Changing background color of `cursor' sets frame parameter
3445 if (EQ (attr
, QCbackground
))
3446 param
= Qcursor_color
;
3448 else if (EQ (face
, Qmouse
))
3450 /* Changing background color of `mouse' sets frame parameter
3452 if (EQ (attr
, QCbackground
))
3453 param
= Qmouse_color
;
3455 #endif /* HAVE_WINDOW_SYSTEM */
3456 else if (EQ (face
, Qmenu
))
3458 /* Indicate that we have to update the menu bar when
3459 realizing faces on FRAME. FRAME t change the
3460 default for new frames. We do this by setting
3461 setting the flag in new face caches */
3464 struct frame
*f
= XFRAME (frame
);
3465 if (FRAME_FACE_CACHE (f
) == NULL
)
3466 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
3467 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 1;
3470 menu_face_changed_default
= 1;
3476 /* Update `default-frame-alist', which is used for new frames. */
3478 store_in_alist (&Vdefault_frame_alist
, param
, value
);
3481 /* Update the current frame's parameters. */
3484 cons
= XCAR (Vparam_value_alist
);
3485 XSETCAR (cons
, param
);
3486 XSETCDR (cons
, value
);
3487 Fmodify_frame_parameters (frame
, Vparam_value_alist
);
3496 #ifdef HAVE_WINDOW_SYSTEM
3498 /* Set the `font' frame parameter of FRAME determined from the
3499 font-object set in `default' face attributes LFACE. */
3502 set_font_frame_param (frame
, lface
)
3503 Lisp_Object frame
, lface
;
3505 struct frame
*f
= XFRAME (frame
);
3507 if (FRAME_WINDOW_P (f
))
3509 Lisp_Object font
= LFACE_FONT (lface
);
3511 if (FONT_SPEC_P (font
))
3513 font
= font_load_for_lface (f
, XVECTOR (lface
)->contents
, font
);
3516 LFACE_FONT (lface
) = font
;
3518 f
->default_face_done_p
= 0;
3519 Fmodify_frame_parameters (frame
, Fcons (Fcons (Qfont
, font
), Qnil
));
3524 /* Update the corresponding face when frame parameter PARAM on frame F
3525 has been assigned the value NEW_VALUE. */
3528 update_face_from_frame_parameter (f
, param
, new_value
)
3530 Lisp_Object param
, new_value
;
3532 Lisp_Object face
= Qnil
;
3535 /* If there are no faces yet, give up. This is the case when called
3536 from Fx_create_frame, and we do the necessary things later in
3537 face-set-after-frame-defaults. */
3538 if (NILP (f
->face_alist
))
3541 if (EQ (param
, Qforeground_color
))
3544 lface
= lface_from_face_name (f
, face
, 1);
3545 LFACE_FOREGROUND (lface
) = (STRINGP (new_value
)
3546 ? new_value
: Qunspecified
);
3547 realize_basic_faces (f
);
3549 else if (EQ (param
, Qbackground_color
))
3553 /* Changing the background color might change the background
3554 mode, so that we have to load new defface specs.
3555 Call frame-set-background-mode to do that. */
3556 XSETFRAME (frame
, f
);
3557 call1 (Qframe_set_background_mode
, frame
);
3560 lface
= lface_from_face_name (f
, face
, 1);
3561 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
3562 ? new_value
: Qunspecified
);
3563 realize_basic_faces (f
);
3565 else if (EQ (param
, Qborder_color
))
3568 lface
= lface_from_face_name (f
, face
, 1);
3569 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
3570 ? new_value
: Qunspecified
);
3572 else if (EQ (param
, Qcursor_color
))
3575 lface
= lface_from_face_name (f
, face
, 1);
3576 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
3577 ? new_value
: Qunspecified
);
3579 else if (EQ (param
, Qmouse_color
))
3582 lface
= lface_from_face_name (f
, face
, 1);
3583 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
3584 ? new_value
: Qunspecified
);
3587 /* Changing a named face means that all realized faces depending on
3588 that face are invalid. Since we cannot tell which realized faces
3589 depend on the face, make sure they are all removed. This is done
3590 by incrementing face_change_count. The next call to
3591 init_iterator will then free realized faces. */
3593 && NILP (Fget (face
, Qface_no_inherit
)))
3595 ++face_change_count
;
3596 ++windows_or_buffers_changed
;
3601 /* Get the value of X resource RESOURCE, class CLASS for the display
3602 of frame FRAME. This is here because ordinary `x-get-resource'
3603 doesn't take a frame argument. */
3605 DEFUN ("internal-face-x-get-resource", Finternal_face_x_get_resource
,
3606 Sinternal_face_x_get_resource
, 3, 3, 0, doc
: /* */)
3607 (resource
, class, frame
)
3608 Lisp_Object resource
, class, frame
;
3610 Lisp_Object value
= Qnil
;
3611 CHECK_STRING (resource
);
3612 CHECK_STRING (class);
3613 CHECK_LIVE_FRAME (frame
);
3615 value
= display_x_get_resource (FRAME_X_DISPLAY_INFO (XFRAME (frame
)),
3616 resource
, class, Qnil
, Qnil
);
3622 /* Return resource string VALUE as a boolean value, i.e. nil, or t.
3623 If VALUE is "on" or "true", return t. If VALUE is "off" or
3624 "false", return nil. Otherwise, if SIGNAL_P is non-zero, signal an
3625 error; if SIGNAL_P is zero, return 0. */
3628 face_boolean_x_resource_value (value
, signal_p
)
3632 Lisp_Object result
= make_number (0);
3634 xassert (STRINGP (value
));
3636 if (xstricmp (SDATA (value
), "on") == 0
3637 || xstricmp (SDATA (value
), "true") == 0)
3639 else if (xstricmp (SDATA (value
), "off") == 0
3640 || xstricmp (SDATA (value
), "false") == 0)
3642 else if (xstricmp (SDATA (value
), "unspecified") == 0)
3643 result
= Qunspecified
;
3645 signal_error ("Invalid face attribute value from X resource", value
);
3651 DEFUN ("internal-set-lisp-face-attribute-from-resource",
3652 Finternal_set_lisp_face_attribute_from_resource
,
3653 Sinternal_set_lisp_face_attribute_from_resource
,
3654 3, 4, 0, doc
: /* */)
3655 (face
, attr
, value
, frame
)
3656 Lisp_Object face
, attr
, value
, frame
;
3658 CHECK_SYMBOL (face
);
3659 CHECK_SYMBOL (attr
);
3660 CHECK_STRING (value
);
3662 if (xstricmp (SDATA (value
), "unspecified") == 0)
3663 value
= Qunspecified
;
3664 else if (EQ (attr
, QCheight
))
3666 value
= Fstring_to_number (value
, make_number (10));
3667 if (XINT (value
) <= 0)
3668 signal_error ("Invalid face height from X resource", value
);
3670 else if (EQ (attr
, QCbold
) || EQ (attr
, QCitalic
))
3671 value
= face_boolean_x_resource_value (value
, 1);
3672 else if (EQ (attr
, QCweight
) || EQ (attr
, QCslant
) || EQ (attr
, QCwidth
))
3673 value
= intern (SDATA (value
));
3674 else if (EQ (attr
, QCreverse_video
) || EQ (attr
, QCinverse_video
))
3675 value
= face_boolean_x_resource_value (value
, 1);
3676 else if (EQ (attr
, QCunderline
)
3677 || EQ (attr
, QCoverline
)
3678 || EQ (attr
, QCstrike_through
))
3680 Lisp_Object boolean_value
;
3682 /* If the result of face_boolean_x_resource_value is t or nil,
3683 VALUE does NOT specify a color. */
3684 boolean_value
= face_boolean_x_resource_value (value
, 0);
3685 if (SYMBOLP (boolean_value
))
3686 value
= boolean_value
;
3688 else if (EQ (attr
, QCbox
) || EQ (attr
, QCinherit
))
3689 value
= Fcar (Fread_from_string (value
, Qnil
, Qnil
));
3691 return Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
3694 #endif /* HAVE_WINDOW_SYSTEM */
3697 /***********************************************************************
3699 ***********************************************************************/
3701 #if defined HAVE_X_WINDOWS && defined USE_X_TOOLKIT
3703 /* Make menus on frame F appear as specified by the `menu' face. */
3706 x_update_menu_appearance (f
)
3709 struct x_display_info
*dpyinfo
= FRAME_X_DISPLAY_INFO (f
);
3713 && (rdb
= XrmGetDatabase (FRAME_X_DISPLAY (f
)),
3717 Lisp_Object lface
= lface_from_face_name (f
, Qmenu
, 1);
3718 struct face
*face
= FACE_FROM_ID (f
, MENU_FACE_ID
);
3719 const char *myname
= SDATA (Vx_resource_name
);
3722 const char *popup_path
= "popup_menu";
3724 const char *popup_path
= "menu.popup";
3727 if (STRINGP (LFACE_FOREGROUND (lface
)))
3729 sprintf (line
, "%s.%s*foreground: %s",
3731 SDATA (LFACE_FOREGROUND (lface
)));
3732 XrmPutLineResource (&rdb
, line
);
3733 sprintf (line
, "%s.pane.menubar*foreground: %s",
3734 myname
, SDATA (LFACE_FOREGROUND (lface
)));
3735 XrmPutLineResource (&rdb
, line
);
3739 if (STRINGP (LFACE_BACKGROUND (lface
)))
3741 sprintf (line
, "%s.%s*background: %s",
3743 SDATA (LFACE_BACKGROUND (lface
)));
3744 XrmPutLineResource (&rdb
, line
);
3745 sprintf (line
, "%s.pane.menubar*background: %s",
3746 myname
, SDATA (LFACE_BACKGROUND (lface
)));
3747 XrmPutLineResource (&rdb
, line
);
3752 && (!UNSPECIFIEDP (LFACE_FAMILY (lface
))
3753 || !UNSPECIFIEDP (LFACE_SWIDTH (lface
))
3754 || !UNSPECIFIEDP (LFACE_WEIGHT (lface
))
3755 || !UNSPECIFIEDP (LFACE_SLANT (lface
))
3756 || !UNSPECIFIEDP (LFACE_HEIGHT (lface
))))
3758 Lisp_Object xlfd
= Ffont_xlfd_name (LFACE_FONT (lface
));
3760 const char *suffix
= "List";
3763 #if defined HAVE_X_I18N
3765 const char *suffix
= "Set";
3767 const char *suffix
= "";
3774 #if defined HAVE_X_I18N
3775 extern char *xic_create_fontsetname
3776 P_ ((char *base_fontname
, Bool motif
));
3777 char *fontsetname
= xic_create_fontsetname (SDATA (xlfd
), motif
);
3779 char *fontsetname
= (char *) SDATA (xlfd
);
3781 sprintf (line
, "%s.pane.menubar*font%s: %s",
3782 myname
, suffix
, fontsetname
);
3783 XrmPutLineResource (&rdb
, line
);
3784 sprintf (line
, "%s.%s*font%s: %s",
3785 myname
, popup_path
, suffix
, fontsetname
);
3786 XrmPutLineResource (&rdb
, line
);
3788 if (fontsetname
!= (char *) SDATA (xlfd
))
3789 xfree (fontsetname
);
3793 if (changed_p
&& f
->output_data
.x
->menubar_widget
)
3794 free_frame_menubar (f
);
3798 #endif /* HAVE_X_WINDOWS && USE_X_TOOLKIT */
3801 DEFUN ("face-attribute-relative-p", Fface_attribute_relative_p
,
3802 Sface_attribute_relative_p
,
3804 doc
: /* Check whether a face attribute value is relative.
3805 Specifically, this function returns t if the attribute ATTRIBUTE
3806 with the value VALUE is relative.
3808 A relative value is one that doesn't entirely override whatever is
3809 inherited from another face. For most possible attributes,
3810 the only relative value that users see is `unspecified'.
3811 However, for :height, floating point values are also relative. */)
3813 Lisp_Object attribute
, value
;
3815 if (EQ (value
, Qunspecified
) || (EQ (value
, Qignore_defface
)))
3817 else if (EQ (attribute
, QCheight
))
3818 return INTEGERP (value
) ? Qnil
: Qt
;
3823 DEFUN ("merge-face-attribute", Fmerge_face_attribute
, Smerge_face_attribute
,
3825 doc
: /* Return face ATTRIBUTE VALUE1 merged with VALUE2.
3826 If VALUE1 or VALUE2 are absolute (see `face-attribute-relative-p'), then
3827 the result will be absolute, otherwise it will be relative. */)
3828 (attribute
, value1
, value2
)
3829 Lisp_Object attribute
, value1
, value2
;
3831 if (EQ (value1
, Qunspecified
) || EQ (value1
, Qignore_defface
))
3833 else if (EQ (attribute
, QCheight
))
3834 return merge_face_heights (value1
, value2
, value1
);
3840 DEFUN ("internal-get-lisp-face-attribute", Finternal_get_lisp_face_attribute
,
3841 Sinternal_get_lisp_face_attribute
,
3843 doc
: /* Return face attribute KEYWORD of face SYMBOL.
3844 If SYMBOL does not name a valid Lisp face or KEYWORD isn't a valid
3845 face attribute name, signal an error.
3846 If the optional argument FRAME is given, report on face SYMBOL in that
3847 frame. If FRAME is t, report on the defaults for face SYMBOL (for new
3848 frames). If FRAME is omitted or nil, use the selected frame. */)
3849 (symbol
, keyword
, frame
)
3850 Lisp_Object symbol
, keyword
, frame
;
3852 Lisp_Object lface
, value
= Qnil
;
3854 CHECK_SYMBOL (symbol
);
3855 CHECK_SYMBOL (keyword
);
3858 lface
= lface_from_face_name (NULL
, symbol
, 1);
3862 frame
= selected_frame
;
3863 CHECK_LIVE_FRAME (frame
);
3864 lface
= lface_from_face_name (XFRAME (frame
), symbol
, 1);
3867 if (EQ (keyword
, QCfamily
))
3868 value
= LFACE_FAMILY (lface
);
3869 else if (EQ (keyword
, QCheight
))
3870 value
= LFACE_HEIGHT (lface
);
3871 else if (EQ (keyword
, QCweight
))
3872 value
= LFACE_WEIGHT (lface
);
3873 else if (EQ (keyword
, QCslant
))
3874 value
= LFACE_SLANT (lface
);
3875 else if (EQ (keyword
, QCunderline
))
3876 value
= LFACE_UNDERLINE (lface
);
3877 else if (EQ (keyword
, QCoverline
))
3878 value
= LFACE_OVERLINE (lface
);
3879 else if (EQ (keyword
, QCstrike_through
))
3880 value
= LFACE_STRIKE_THROUGH (lface
);
3881 else if (EQ (keyword
, QCbox
))
3882 value
= LFACE_BOX (lface
);
3883 else if (EQ (keyword
, QCinverse_video
)
3884 || EQ (keyword
, QCreverse_video
))
3885 value
= LFACE_INVERSE (lface
);
3886 else if (EQ (keyword
, QCforeground
))
3887 value
= LFACE_FOREGROUND (lface
);
3888 else if (EQ (keyword
, QCbackground
))
3889 value
= LFACE_BACKGROUND (lface
);
3890 else if (EQ (keyword
, QCstipple
))
3891 value
= LFACE_STIPPLE (lface
);
3892 else if (EQ (keyword
, QCwidth
))
3893 value
= LFACE_SWIDTH (lface
);
3894 else if (EQ (keyword
, QCinherit
))
3895 value
= LFACE_INHERIT (lface
);
3896 else if (EQ (keyword
, QCfont
))
3897 value
= LFACE_FONT (lface
);
3898 else if (EQ (keyword
, QCfontset
))
3899 value
= LFACE_FONTSET (lface
);
3901 signal_error ("Invalid face attribute name", keyword
);
3903 if (IGNORE_DEFFACE_P (value
))
3904 return Qunspecified
;
3910 DEFUN ("internal-lisp-face-attribute-values",
3911 Finternal_lisp_face_attribute_values
,
3912 Sinternal_lisp_face_attribute_values
, 1, 1, 0,
3913 doc
: /* Return a list of valid discrete values for face attribute ATTR.
3914 Value is nil if ATTR doesn't have a discrete set of valid values. */)
3918 Lisp_Object result
= Qnil
;
3920 CHECK_SYMBOL (attr
);
3922 if (EQ (attr
, QCunderline
))
3923 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
3924 else if (EQ (attr
, QCoverline
))
3925 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
3926 else if (EQ (attr
, QCstrike_through
))
3927 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
3928 else if (EQ (attr
, QCinverse_video
) || EQ (attr
, QCreverse_video
))
3929 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
3935 DEFUN ("internal-merge-in-global-face", Finternal_merge_in_global_face
,
3936 Sinternal_merge_in_global_face
, 2, 2, 0,
3937 doc
: /* Add attributes from frame-default definition of FACE to FACE on FRAME.
3938 Default face attributes override any local face attributes. */)
3940 Lisp_Object face
, frame
;
3943 Lisp_Object global_lface
, local_lface
, *gvec
, *lvec
;
3945 CHECK_LIVE_FRAME (frame
);
3946 global_lface
= lface_from_face_name (NULL
, face
, 1);
3947 local_lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
3948 if (NILP (local_lface
))
3949 local_lface
= Finternal_make_lisp_face (face
, frame
);
3951 /* Make every specified global attribute override the local one.
3952 BEWARE!! This is only used from `face-set-after-frame-default' where
3953 the local frame is defined from default specs in `face-defface-spec'
3954 and those should be overridden by global settings. Hence the strange
3955 "global before local" priority. */
3956 lvec
= XVECTOR (local_lface
)->contents
;
3957 gvec
= XVECTOR (global_lface
)->contents
;
3958 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3959 if (! UNSPECIFIEDP (gvec
[i
]))
3961 if (IGNORE_DEFFACE_P (gvec
[i
]))
3962 lvec
[i
] = Qunspecified
;
3971 /* The following function is implemented for compatibility with 20.2.
3972 The function is used in x-resolve-fonts when it is asked to
3973 return fonts with the same size as the font of a face. This is
3974 done in fontset.el. */
3976 DEFUN ("face-font", Fface_font
, Sface_font
, 1, 3, 0,
3977 doc
: /* Return the font name of face FACE, or nil if it is unspecified.
3978 The font name is, by default, for ASCII characters.
3979 If the optional argument FRAME is given, report on face FACE in that frame.
3980 If FRAME is t, report on the defaults for face FACE (for new frames).
3981 The font default for a face is either nil, or a list
3982 of the form (bold), (italic) or (bold italic).
3983 If FRAME is omitted or nil, use the selected frame. And, in this case,
3984 if the optional third argument CHARACTER is given,
3985 return the font name used for CHARACTER. */)
3986 (face
, frame
, character
)
3987 Lisp_Object face
, frame
, character
;
3991 Lisp_Object result
= Qnil
;
3992 Lisp_Object lface
= lface_from_face_name (NULL
, face
, 1);
3994 if (!UNSPECIFIEDP (LFACE_WEIGHT (lface
))
3995 && !EQ (LFACE_WEIGHT (lface
), Qnormal
))
3996 result
= Fcons (Qbold
, result
);
3998 if (!UNSPECIFIEDP (LFACE_SLANT (lface
))
3999 && !EQ (LFACE_SLANT (lface
), Qnormal
))
4000 result
= Fcons (Qitalic
, result
);
4006 struct frame
*f
= frame_or_selected_frame (frame
, 1);
4007 int face_id
= lookup_named_face (f
, face
, 1);
4008 struct face
*face
= FACE_FROM_ID (f
, face_id
);
4012 #ifdef HAVE_WINDOW_SYSTEM
4013 if (FRAME_WINDOW_P (f
) && !NILP (character
))
4015 CHECK_CHARACTER (character
);
4016 face_id
= FACE_FOR_CHAR (f
, face
, XINT (character
), -1, Qnil
);
4017 face
= FACE_FROM_ID (f
, face_id
);
4021 ? face
->font
->props
[FONT_NAME_INDEX
]
4027 /* Compare face-attribute values v1 and v2 for equality. Value is non-zero if
4028 all attributes are `equal'. Tries to be fast because this function
4029 is called quite often. */
4032 face_attr_equal_p (v1
, v2
)
4035 /* Type can differ, e.g. when one attribute is unspecified, i.e. nil,
4036 and the other is specified. */
4037 if (XTYPE (v1
) != XTYPE (v2
))
4046 if (SBYTES (v1
) != SBYTES (v2
))
4049 return bcmp (SDATA (v1
), SDATA (v2
), SBYTES (v1
)) == 0;
4056 return !NILP (Fequal (v1
, v2
));
4061 /* Compare face vectors V1 and V2 for equality. Value is non-zero if
4062 all attributes are `equal'. Tries to be fast because this function
4063 is called quite often. */
4066 lface_equal_p (v1
, v2
)
4067 Lisp_Object
*v1
, *v2
;
4071 for (i
= 1; i
< LFACE_VECTOR_SIZE
&& equal_p
; ++i
)
4072 equal_p
= face_attr_equal_p (v1
[i
], v2
[i
]);
4078 DEFUN ("internal-lisp-face-equal-p", Finternal_lisp_face_equal_p
,
4079 Sinternal_lisp_face_equal_p
, 2, 3, 0,
4080 doc
: /* True if FACE1 and FACE2 are equal.
4081 If the optional argument FRAME is given, report on FACE1 and FACE2 in that frame.
4082 If FRAME is t, report on the defaults for FACE1 and FACE2 (for new frames).
4083 If FRAME is omitted or nil, use the selected frame. */)
4084 (face1
, face2
, frame
)
4085 Lisp_Object face1
, face2
, frame
;
4089 Lisp_Object lface1
, lface2
;
4094 /* Don't use check_x_frame here because this function is called
4095 before X frames exist. At that time, if FRAME is nil,
4096 selected_frame will be used which is the frame dumped with
4097 Emacs. That frame is not an X frame. */
4098 f
= frame_or_selected_frame (frame
, 2);
4100 lface1
= lface_from_face_name (f
, face1
, 1);
4101 lface2
= lface_from_face_name (f
, face2
, 1);
4102 equal_p
= lface_equal_p (XVECTOR (lface1
)->contents
,
4103 XVECTOR (lface2
)->contents
);
4104 return equal_p
? Qt
: Qnil
;
4108 DEFUN ("internal-lisp-face-empty-p", Finternal_lisp_face_empty_p
,
4109 Sinternal_lisp_face_empty_p
, 1, 2, 0,
4110 doc
: /* True if FACE has no attribute specified.
4111 If the optional argument FRAME is given, report on face FACE in that frame.
4112 If FRAME is t, report on the defaults for face FACE (for new frames).
4113 If FRAME is omitted or nil, use the selected frame. */)
4115 Lisp_Object face
, frame
;
4122 frame
= selected_frame
;
4123 CHECK_LIVE_FRAME (frame
);
4127 lface
= lface_from_face_name (NULL
, face
, 1);
4129 lface
= lface_from_face_name (f
, face
, 1);
4131 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
4132 if (!UNSPECIFIEDP (AREF (lface
, i
)))
4135 return i
== LFACE_VECTOR_SIZE
? Qt
: Qnil
;
4139 DEFUN ("frame-face-alist", Fframe_face_alist
, Sframe_face_alist
,
4141 doc
: /* Return an alist of frame-local faces defined on FRAME.
4142 For internal use only. */)
4146 struct frame
*f
= frame_or_selected_frame (frame
, 0);
4147 return f
->face_alist
;
4151 /* Return a hash code for Lisp string STRING with case ignored. Used
4152 below in computing a hash value for a Lisp face. */
4154 static INLINE
unsigned
4155 hash_string_case_insensitive (string
)
4158 const unsigned char *s
;
4160 xassert (STRINGP (string
));
4161 for (s
= SDATA (string
); *s
; ++s
)
4162 hash
= (hash
<< 1) ^ tolower (*s
);
4167 /* Return a hash code for face attribute vector V. */
4169 static INLINE
unsigned
4173 return (hash_string_case_insensitive (v
[LFACE_FAMILY_INDEX
])
4174 ^ hash_string_case_insensitive (v
[LFACE_FOREGROUND_INDEX
])
4175 ^ hash_string_case_insensitive (v
[LFACE_BACKGROUND_INDEX
])
4176 ^ XHASH (v
[LFACE_WEIGHT_INDEX
])
4177 ^ XHASH (v
[LFACE_SLANT_INDEX
])
4178 ^ XHASH (v
[LFACE_SWIDTH_INDEX
])
4179 ^ XHASH (v
[LFACE_HEIGHT_INDEX
]));
4183 /* Return non-zero if LFACE1 and LFACE2 specify the same font (without
4184 considering charsets/registries). They do if they specify the same
4185 family, point size, weight, width, slant, and font. Both
4186 LFACE1 and LFACE2 must be fully-specified. */
4189 lface_same_font_attributes_p (lface1
, lface2
)
4190 Lisp_Object
*lface1
, *lface2
;
4192 xassert (lface_fully_specified_p (lface1
)
4193 && lface_fully_specified_p (lface2
));
4194 return (xstricmp (SDATA (lface1
[LFACE_FAMILY_INDEX
]),
4195 SDATA (lface2
[LFACE_FAMILY_INDEX
])) == 0
4196 && EQ (lface1
[LFACE_HEIGHT_INDEX
], lface2
[LFACE_HEIGHT_INDEX
])
4197 && EQ (lface1
[LFACE_SWIDTH_INDEX
], lface2
[LFACE_SWIDTH_INDEX
])
4198 && EQ (lface1
[LFACE_WEIGHT_INDEX
], lface2
[LFACE_WEIGHT_INDEX
])
4199 && EQ (lface1
[LFACE_SLANT_INDEX
], lface2
[LFACE_SLANT_INDEX
])
4200 && EQ (lface1
[LFACE_FONT_INDEX
], lface2
[LFACE_FONT_INDEX
])
4201 && (EQ (lface1
[LFACE_FONTSET_INDEX
], lface2
[LFACE_FONTSET_INDEX
])
4202 || (STRINGP (lface1
[LFACE_FONTSET_INDEX
])
4203 && STRINGP (lface2
[LFACE_FONTSET_INDEX
])
4204 && ! xstricmp (SDATA (lface1
[LFACE_FONTSET_INDEX
]),
4205 SDATA (lface2
[LFACE_FONTSET_INDEX
]))))
4211 /***********************************************************************
4213 ***********************************************************************/
4215 /* Allocate and return a new realized face for Lisp face attribute
4218 static struct face
*
4219 make_realized_face (attr
)
4222 struct face
*face
= (struct face
*) xmalloc (sizeof *face
);
4223 bzero (face
, sizeof *face
);
4224 face
->ascii_face
= face
;
4225 bcopy (attr
, face
->lface
, sizeof face
->lface
);
4230 /* Free realized face FACE, including its X resources. FACE may
4234 free_realized_face (f
, face
)
4240 #ifdef HAVE_WINDOW_SYSTEM
4241 if (FRAME_WINDOW_P (f
))
4243 /* Free fontset of FACE if it is ASCII face. */
4244 if (face
->fontset
>= 0 && face
== face
->ascii_face
)
4245 free_face_fontset (f
, face
);
4250 font_done_for_face (f
, face
);
4251 x_free_gc (f
, face
->gc
);
4256 free_face_colors (f
, face
);
4257 x_destroy_bitmap (f
, face
->stipple
);
4259 #endif /* HAVE_WINDOW_SYSTEM */
4266 /* Prepare face FACE for subsequent display on frame F. This
4267 allocated GCs if they haven't been allocated yet or have been freed
4268 by clearing the face cache. */
4271 prepare_face_for_display (f
, face
)
4275 #ifdef HAVE_WINDOW_SYSTEM
4276 xassert (FRAME_WINDOW_P (f
));
4281 unsigned long mask
= GCForeground
| GCBackground
| GCGraphicsExposures
;
4283 xgcv
.foreground
= face
->foreground
;
4284 xgcv
.background
= face
->background
;
4285 #ifdef HAVE_X_WINDOWS
4286 xgcv
.graphics_exposures
= False
;
4290 #ifdef HAVE_X_WINDOWS
4293 xgcv
.fill_style
= FillOpaqueStippled
;
4294 xgcv
.stipple
= x_bitmap_pixmap (f
, face
->stipple
);
4295 mask
|= GCFillStyle
| GCStipple
;
4298 face
->gc
= x_create_gc (f
, mask
, &xgcv
);
4300 font_prepare_for_face (f
, face
);
4303 #endif /* HAVE_WINDOW_SYSTEM */
4307 /* Returns the `distance' between the colors X and Y. */
4310 color_distance (x
, y
)
4313 /* This formula is from a paper title `Colour metric' by Thiadmer Riemersma.
4314 Quoting from that paper:
4316 This formula has results that are very close to L*u*v* (with the
4317 modified lightness curve) and, more importantly, it is a more even
4318 algorithm: it does not have a range of colours where it suddenly
4319 gives far from optimal results.
4321 See <http://www.compuphase.com/cmetric.htm> for more info. */
4323 long r
= (x
->red
- y
->red
) >> 8;
4324 long g
= (x
->green
- y
->green
) >> 8;
4325 long b
= (x
->blue
- y
->blue
) >> 8;
4326 long r_mean
= (x
->red
+ y
->red
) >> 9;
4329 (((512 + r_mean
) * r
* r
) >> 8)
4331 + (((767 - r_mean
) * b
* b
) >> 8);
4335 DEFUN ("color-distance", Fcolor_distance
, Scolor_distance
, 2, 3, 0,
4336 doc
: /* Return an integer distance between COLOR1 and COLOR2 on FRAME.
4337 COLOR1 and COLOR2 may be either strings containing the color name,
4338 or lists of the form (RED GREEN BLUE).
4339 If FRAME is unspecified or nil, the current frame is used. */)
4340 (color1
, color2
, frame
)
4341 Lisp_Object color1
, color2
, frame
;
4344 XColor cdef1
, cdef2
;
4347 frame
= selected_frame
;
4348 CHECK_LIVE_FRAME (frame
);
4351 if (!(CONSP (color1
) && parse_rgb_list (color1
, &cdef1
))
4352 && !(STRINGP (color1
) && defined_color (f
, SDATA (color1
), &cdef1
, 0)))
4353 signal_error ("Invalid color", color1
);
4354 if (!(CONSP (color2
) && parse_rgb_list (color2
, &cdef2
))
4355 && !(STRINGP (color2
) && defined_color (f
, SDATA (color2
), &cdef2
, 0)))
4356 signal_error ("Invalid color", color2
);
4358 return make_number (color_distance (&cdef1
, &cdef2
));
4362 /***********************************************************************
4364 ***********************************************************************/
4366 /* Return a new face cache for frame F. */
4368 static struct face_cache
*
4372 struct face_cache
*c
;
4375 c
= (struct face_cache
*) xmalloc (sizeof *c
);
4376 bzero (c
, sizeof *c
);
4377 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
4378 c
->buckets
= (struct face
**) xmalloc (size
);
4379 bzero (c
->buckets
, size
);
4381 c
->faces_by_id
= (struct face
**) xmalloc (c
->size
* sizeof *c
->faces_by_id
);
4383 c
->menu_face_changed_p
= menu_face_changed_default
;
4388 /* Clear out all graphics contexts for all realized faces, except for
4389 the basic faces. This should be done from time to time just to avoid
4390 keeping too many graphics contexts that are no longer needed. */
4394 struct face_cache
*c
;
4396 if (c
&& FRAME_WINDOW_P (c
->f
))
4398 #ifdef HAVE_WINDOW_SYSTEM
4400 for (i
= BASIC_FACE_ID_SENTINEL
; i
< c
->used
; ++i
)
4402 struct face
*face
= c
->faces_by_id
[i
];
4403 if (face
&& face
->gc
)
4407 font_done_for_face (c
->f
, face
);
4408 x_free_gc (c
->f
, face
->gc
);
4413 #endif /* HAVE_WINDOW_SYSTEM */
4418 /* Free all realized faces in face cache C, including basic faces.
4419 C may be null. If faces are freed, make sure the frame's current
4420 matrix is marked invalid, so that a display caused by an expose
4421 event doesn't try to use faces we destroyed. */
4424 free_realized_faces (c
)
4425 struct face_cache
*c
;
4430 struct frame
*f
= c
->f
;
4432 /* We must block input here because we can't process X events
4433 safely while only some faces are freed, or when the frame's
4434 current matrix still references freed faces. */
4437 for (i
= 0; i
< c
->used
; ++i
)
4439 free_realized_face (f
, c
->faces_by_id
[i
]);
4440 c
->faces_by_id
[i
] = NULL
;
4444 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
4445 bzero (c
->buckets
, size
);
4447 /* Must do a thorough redisplay the next time. Mark current
4448 matrices as invalid because they will reference faces freed
4449 above. This function is also called when a frame is
4450 destroyed. In this case, the root window of F is nil. */
4451 if (WINDOWP (f
->root_window
))
4453 clear_current_matrices (f
);
4454 ++windows_or_buffers_changed
;
4462 /* Free all realized faces that are using FONTSET on frame F. */
4465 free_realized_faces_for_fontset (f
, fontset
)
4469 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
4473 /* We must block input here because we can't process X events safely
4474 while only some faces are freed, or when the frame's current
4475 matrix still references freed faces. */
4478 for (i
= 0; i
< cache
->used
; i
++)
4480 face
= cache
->faces_by_id
[i
];
4482 && face
->fontset
== fontset
)
4484 uncache_face (cache
, face
);
4485 free_realized_face (f
, face
);
4489 /* Must do a thorough redisplay the next time. Mark current
4490 matrices as invalid because they will reference faces freed
4491 above. This function is also called when a frame is destroyed.
4492 In this case, the root window of F is nil. */
4493 if (WINDOWP (f
->root_window
))
4495 clear_current_matrices (f
);
4496 ++windows_or_buffers_changed
;
4503 /* Free all realized faces on FRAME or on all frames if FRAME is nil.
4504 This is done after attributes of a named face have been changed,
4505 because we can't tell which realized faces depend on that face. */
4508 free_all_realized_faces (frame
)
4514 FOR_EACH_FRAME (rest
, frame
)
4515 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
4518 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
4522 /* Free face cache C and faces in it, including their X resources. */
4526 struct face_cache
*c
;
4530 free_realized_faces (c
);
4532 xfree (c
->faces_by_id
);
4538 /* Cache realized face FACE in face cache C. HASH is the hash value
4539 of FACE. If FACE is for ASCII characters (i.e. FACE->ascii_face ==
4540 FACE), insert the new face to the beginning of the collision list
4541 of the face hash table of C. Otherwise, add the new face to the
4542 end of the collision list. This way, lookup_face can quickly find
4543 that a requested face is not cached. */
4546 cache_face (c
, face
, hash
)
4547 struct face_cache
*c
;
4551 int i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
4555 if (face
->ascii_face
!= face
)
4557 struct face
*last
= c
->buckets
[i
];
4568 c
->buckets
[i
] = face
;
4569 face
->prev
= face
->next
= NULL
;
4575 face
->next
= c
->buckets
[i
];
4577 face
->next
->prev
= face
;
4578 c
->buckets
[i
] = face
;
4581 /* Find a free slot in C->faces_by_id and use the index of the free
4582 slot as FACE->id. */
4583 for (i
= 0; i
< c
->used
; ++i
)
4584 if (c
->faces_by_id
[i
] == NULL
)
4588 /* Maybe enlarge C->faces_by_id. */
4591 if (c
->used
== c
->size
)
4594 new_size
= min (2 * c
->size
, MAX_FACE_ID
);
4595 if (new_size
== c
->size
)
4596 abort (); /* Alternatives? ++kfs */
4597 sz
= new_size
* sizeof *c
->faces_by_id
;
4598 c
->faces_by_id
= (struct face
**) xrealloc (c
->faces_by_id
, sz
);
4605 /* Check that FACE got a unique id. */
4610 for (j
= n
= 0; j
< FACE_CACHE_BUCKETS_SIZE
; ++j
)
4611 for (face
= c
->buckets
[j
]; face
; face
= face
->next
)
4617 #endif /* GLYPH_DEBUG */
4619 c
->faces_by_id
[i
] = face
;
4623 /* Remove face FACE from cache C. */
4626 uncache_face (c
, face
)
4627 struct face_cache
*c
;
4630 int i
= face
->hash
% FACE_CACHE_BUCKETS_SIZE
;
4633 face
->prev
->next
= face
->next
;
4635 c
->buckets
[i
] = face
->next
;
4638 face
->next
->prev
= face
->prev
;
4640 c
->faces_by_id
[face
->id
] = NULL
;
4641 if (face
->id
== c
->used
)
4646 /* Look up a realized face with face attributes ATTR in the face cache
4647 of frame F. The face will be used to display ASCII characters.
4648 Value is the ID of the face found. If no suitable face is found,
4649 realize a new one. */
4652 lookup_face (f
, attr
)
4656 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
4661 xassert (cache
!= NULL
);
4662 check_lface_attrs (attr
);
4664 /* Look up ATTR in the face cache. */
4665 hash
= lface_hash (attr
);
4666 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
4668 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
4670 if (face
->ascii_face
!= face
)
4672 /* There's no more ASCII face. */
4676 if (face
->hash
== hash
4677 && lface_equal_p (face
->lface
, attr
))
4681 /* If not found, realize a new face. */
4683 face
= realize_face (cache
, attr
, -1);
4686 xassert (face
== FACE_FROM_ID (f
, face
->id
));
4687 #endif /* GLYPH_DEBUG */
4692 #ifdef HAVE_WINDOW_SYSTEM
4693 /* Look up a realized face that has the same attributes as BASE_FACE
4694 except for the font in the face cache of frame F. If FONT-OBJECT
4695 is not nil, it is an already opened font. If FONT-OBJECT is nil,
4696 the face has no font. Value is the ID of the face found. If no
4697 suitable face is found, realize a new one. */
4700 face_for_font (f
, font_object
, base_face
)
4702 Lisp_Object font_object
;
4703 struct face
*base_face
;
4705 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
4710 xassert (cache
!= NULL
);
4711 base_face
= base_face
->ascii_face
;
4712 hash
= lface_hash (base_face
->lface
);
4713 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
4715 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
4717 if (face
->ascii_face
== face
)
4719 if (face
->ascii_face
== base_face
4720 && face
->font
== (NILP (font_object
) ? NULL
4721 : XFONT_OBJECT (font_object
))
4722 && lface_equal_p (face
->lface
, base_face
->lface
))
4726 /* If not found, realize a new face. */
4727 face
= realize_non_ascii_face (f
, font_object
, base_face
);
4730 #endif /* HAVE_WINDOW_SYSTEM */
4732 /* Return the face id of the realized face for named face SYMBOL on
4733 frame F suitable for displaying ASCII characters. Value is -1 if
4734 the face couldn't be determined, which might happen if the default
4735 face isn't realized and cannot be realized. */
4738 lookup_named_face (f
, symbol
, signal_p
)
4743 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
4744 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
4745 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
4747 if (default_face
== NULL
)
4749 if (!realize_basic_faces (f
))
4751 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
4752 if (default_face
== NULL
)
4753 abort (); /* realize_basic_faces must have set it up */
4756 if (!get_lface_attributes (f
, symbol
, symbol_attrs
, signal_p
))
4759 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
4760 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
4762 return lookup_face (f
, attrs
);
4766 /* Return the ID of the realized ASCII face of Lisp face with ID
4767 LFACE_ID on frame F. Value is -1 if LFACE_ID isn't valid. */
4770 ascii_face_of_lisp_face (f
, lface_id
)
4776 if (lface_id
>= 0 && lface_id
< lface_id_to_name_size
)
4778 Lisp_Object face_name
= lface_id_to_name
[lface_id
];
4779 face_id
= lookup_named_face (f
, face_name
, 1);
4788 /* Return a face for charset ASCII that is like the face with id
4789 FACE_ID on frame F, but has a font that is STEPS steps smaller.
4790 STEPS < 0 means larger. Value is the id of the face. */
4793 smaller_face (f
, face_id
, steps
)
4797 #ifdef HAVE_WINDOW_SYSTEM
4799 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
4800 int pt
, last_pt
, last_height
;
4803 struct face
*new_face
;
4805 /* If not called for an X frame, just return the original face. */
4806 if (FRAME_TERMCAP_P (f
))
4809 /* Try in increments of 1/2 pt. */
4810 delta
= steps
< 0 ? 5 : -5;
4811 steps
= eabs (steps
);
4813 face
= FACE_FROM_ID (f
, face_id
);
4814 bcopy (face
->lface
, attrs
, sizeof attrs
);
4815 pt
= last_pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
4816 new_face_id
= face_id
;
4817 last_height
= FONT_HEIGHT (face
->font
);
4821 /* Give up if we cannot find a font within 10pt. */
4822 && eabs (last_pt
- pt
) < 100)
4824 /* Look up a face for a slightly smaller/larger font. */
4826 attrs
[LFACE_HEIGHT_INDEX
] = make_number (pt
);
4827 new_face_id
= lookup_face (f
, attrs
);
4828 new_face
= FACE_FROM_ID (f
, new_face_id
);
4830 /* If height changes, count that as one step. */
4831 if ((delta
< 0 && FONT_HEIGHT (new_face
->font
) < last_height
)
4832 || (delta
> 0 && FONT_HEIGHT (new_face
->font
) > last_height
))
4835 last_height
= FONT_HEIGHT (new_face
->font
);
4842 #else /* not HAVE_WINDOW_SYSTEM */
4846 #endif /* not HAVE_WINDOW_SYSTEM */
4850 /* Return a face for charset ASCII that is like the face with id
4851 FACE_ID on frame F, but has height HEIGHT. */
4854 face_with_height (f
, face_id
, height
)
4859 #ifdef HAVE_WINDOW_SYSTEM
4861 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
4863 if (FRAME_TERMCAP_P (f
)
4867 face
= FACE_FROM_ID (f
, face_id
);
4868 bcopy (face
->lface
, attrs
, sizeof attrs
);
4869 attrs
[LFACE_HEIGHT_INDEX
] = make_number (height
);
4870 face_id
= lookup_face (f
, attrs
);
4871 #endif /* HAVE_WINDOW_SYSTEM */
4877 /* Return the face id of the realized face for named face SYMBOL on
4878 frame F suitable for displaying ASCII characters, and use
4879 attributes of the face FACE_ID for attributes that aren't
4880 completely specified by SYMBOL. This is like lookup_named_face,
4881 except that the default attributes come from FACE_ID, not from the
4882 default face. FACE_ID is assumed to be already realized. */
4885 lookup_derived_face (f
, symbol
, face_id
, signal_p
)
4891 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
4892 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
4893 struct face
*default_face
= FACE_FROM_ID (f
, face_id
);
4898 get_lface_attributes (f
, symbol
, symbol_attrs
, signal_p
);
4899 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
4900 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
4901 return lookup_face (f
, attrs
);
4904 DEFUN ("face-attributes-as-vector", Fface_attributes_as_vector
,
4905 Sface_attributes_as_vector
, 1, 1, 0,
4906 doc
: /* Return a vector of face attributes corresponding to PLIST. */)
4911 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
4913 merge_face_ref (XFRAME (selected_frame
), plist
, XVECTOR (lface
)->contents
,
4920 /***********************************************************************
4921 Face capability testing
4922 ***********************************************************************/
4925 /* If the distance (as returned by color_distance) between two colors is
4926 less than this, then they are considered the same, for determining
4927 whether a color is supported or not. The range of values is 0-65535. */
4929 #define TTY_SAME_COLOR_THRESHOLD 10000
4931 #ifdef HAVE_WINDOW_SYSTEM
4933 /* Return non-zero if all the face attributes in ATTRS are supported
4934 on the window-system frame F.
4936 The definition of `supported' is somewhat heuristic, but basically means
4937 that a face containing all the attributes in ATTRS, when merged with the
4938 default face for display, can be represented in a way that's
4940 \(1) different in appearance than the default face, and
4941 \(2) `close in spirit' to what the attributes specify, if not exact. */
4944 x_supports_face_attributes_p (f
, attrs
, def_face
)
4947 struct face
*def_face
;
4949 Lisp_Object
*def_attrs
= def_face
->lface
;
4951 /* Check that other specified attributes are different that the default
4953 if ((!UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
4954 && face_attr_equal_p (attrs
[LFACE_UNDERLINE_INDEX
],
4955 def_attrs
[LFACE_UNDERLINE_INDEX
]))
4956 || (!UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
4957 && face_attr_equal_p (attrs
[LFACE_INVERSE_INDEX
],
4958 def_attrs
[LFACE_INVERSE_INDEX
]))
4959 || (!UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
4960 && face_attr_equal_p (attrs
[LFACE_FOREGROUND_INDEX
],
4961 def_attrs
[LFACE_FOREGROUND_INDEX
]))
4962 || (!UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
4963 && face_attr_equal_p (attrs
[LFACE_BACKGROUND_INDEX
],
4964 def_attrs
[LFACE_BACKGROUND_INDEX
]))
4965 || (!UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
4966 && face_attr_equal_p (attrs
[LFACE_STIPPLE_INDEX
],
4967 def_attrs
[LFACE_STIPPLE_INDEX
]))
4968 || (!UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
4969 && face_attr_equal_p (attrs
[LFACE_OVERLINE_INDEX
],
4970 def_attrs
[LFACE_OVERLINE_INDEX
]))
4971 || (!UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
4972 && face_attr_equal_p (attrs
[LFACE_STRIKE_THROUGH_INDEX
],
4973 def_attrs
[LFACE_STRIKE_THROUGH_INDEX
]))
4974 || (!UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
4975 && face_attr_equal_p (attrs
[LFACE_BOX_INDEX
],
4976 def_attrs
[LFACE_BOX_INDEX
])))
4979 /* Check font-related attributes, as those are the most commonly
4980 "unsupported" on a window-system (because of missing fonts). */
4981 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
4982 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
4983 || !UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
4984 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
4985 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
]))
4989 Lisp_Object merged_attrs
[LFACE_VECTOR_SIZE
];
4992 bcopy (def_attrs
, merged_attrs
, sizeof merged_attrs
);
4994 merge_face_vectors (f
, attrs
, merged_attrs
, 0);
4996 face_id
= lookup_face (f
, merged_attrs
);
4997 face
= FACE_FROM_ID (f
, face_id
);
5000 error ("Cannot make face");
5002 /* If the font is the same, then not supported. */
5003 if (face
->font
== def_face
->font
)
5005 for (i
= FONT_TYPE_INDEX
; i
<= FONT_SIZE_INDEX
; i
++)
5006 if (! EQ (face
->font
->props
[i
], def_face
->font
->props
[i
]))
5010 if (i
< FONT_FOUNDRY_INDEX
|| i
> FONT_REGISTRY_INDEX
5011 || face
->font
->driver
->case_sensitive
)
5013 s1
= SYMBOL_NAME (face
->font
->props
[i
]);
5014 s2
= SYMBOL_NAME (def_face
->font
->props
[i
]);
5015 if (! EQ (Fcompare_strings (s1
, make_number (0), Qnil
,
5016 s2
, make_number (0), Qnil
, Qt
), Qt
))
5022 /* Everything checks out, this face is supported. */
5026 #endif /* HAVE_WINDOW_SYSTEM */
5028 /* Return non-zero if all the face attributes in ATTRS are supported
5031 The definition of `supported' is somewhat heuristic, but basically means
5032 that a face containing all the attributes in ATTRS, when merged
5033 with the default face for display, can be represented in a way that's
5035 \(1) different in appearance than the default face, and
5036 \(2) `close in spirit' to what the attributes specify, if not exact.
5038 Point (2) implies that a `:weight black' attribute will be satisfied
5039 by any terminal that can display bold, and a `:foreground "yellow"' as
5040 long as the terminal can display a yellowish color, but `:slant italic'
5041 will _not_ be satisfied by the tty display code's automatic
5042 substitution of a `dim' face for italic. */
5045 tty_supports_face_attributes_p (f
, attrs
, def_face
)
5048 struct face
*def_face
;
5051 Lisp_Object val
, fg
, bg
;
5052 XColor fg_tty_color
, fg_std_color
;
5053 XColor bg_tty_color
, bg_std_color
;
5054 unsigned test_caps
= 0;
5055 Lisp_Object
*def_attrs
= def_face
->lface
;
5058 /* First check some easy-to-check stuff; ttys support none of the
5059 following attributes, so we can just return false if any are requested
5060 (even if `nominal' values are specified, we should still return false,
5061 as that will be the same value that the default face uses). We
5062 consider :slant unsupportable on ttys, even though the face code
5063 actually `fakes' them using a dim attribute if possible. This is
5064 because the faked result is too different from what the face
5066 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
5067 || !UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
5068 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
5069 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
5070 || !UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
5071 || !UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
5072 || !UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
5073 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
]))
5077 /* Test for terminal `capabilities' (non-color character attributes). */
5079 /* font weight (bold/dim) */
5080 weight
= FONT_WEIGHT_NAME_NUMERIC (attrs
[LFACE_WEIGHT_INDEX
]);
5083 int def_weight
= FONT_WEIGHT_NAME_NUMERIC (def_attrs
[LFACE_WEIGHT_INDEX
]);
5087 if (def_weight
> 100)
5088 return 0; /* same as default */
5089 test_caps
= TTY_CAP_BOLD
;
5091 else if (weight
< 100)
5093 if (def_weight
< 100)
5094 return 0; /* same as default */
5095 test_caps
= TTY_CAP_DIM
;
5097 else if (def_weight
== 100)
5098 return 0; /* same as default */
5102 val
= attrs
[LFACE_UNDERLINE_INDEX
];
5103 if (!UNSPECIFIEDP (val
))
5106 return 0; /* ttys can't use colored underlines */
5107 else if (face_attr_equal_p (val
, def_attrs
[LFACE_UNDERLINE_INDEX
]))
5108 return 0; /* same as default */
5110 test_caps
|= TTY_CAP_UNDERLINE
;
5114 val
= attrs
[LFACE_INVERSE_INDEX
];
5115 if (!UNSPECIFIEDP (val
))
5117 if (face_attr_equal_p (val
, def_attrs
[LFACE_INVERSE_INDEX
]))
5118 return 0; /* same as default */
5120 test_caps
|= TTY_CAP_INVERSE
;
5124 /* Color testing. */
5126 /* Default the color indices in FG_TTY_COLOR and BG_TTY_COLOR, since
5127 we use them when calling `tty_capable_p' below, even if the face
5128 specifies no colors. */
5129 fg_tty_color
.pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
5130 bg_tty_color
.pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
5132 /* Check if foreground color is close enough. */
5133 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
5136 Lisp_Object def_fg
= def_attrs
[LFACE_FOREGROUND_INDEX
];
5138 if (face_attr_equal_p (fg
, def_fg
))
5139 return 0; /* same as default */
5140 else if (! tty_lookup_color (f
, fg
, &fg_tty_color
, &fg_std_color
))
5141 return 0; /* not a valid color */
5142 else if (color_distance (&fg_tty_color
, &fg_std_color
)
5143 > TTY_SAME_COLOR_THRESHOLD
)
5144 return 0; /* displayed color is too different */
5146 /* Make sure the color is really different than the default. */
5148 XColor def_fg_color
;
5149 if (tty_lookup_color (f
, def_fg
, &def_fg_color
, 0)
5150 && (color_distance (&fg_tty_color
, &def_fg_color
)
5151 <= TTY_SAME_COLOR_THRESHOLD
))
5156 /* Check if background color is close enough. */
5157 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
5160 Lisp_Object def_bg
= def_attrs
[LFACE_BACKGROUND_INDEX
];
5162 if (face_attr_equal_p (bg
, def_bg
))
5163 return 0; /* same as default */
5164 else if (! tty_lookup_color (f
, bg
, &bg_tty_color
, &bg_std_color
))
5165 return 0; /* not a valid color */
5166 else if (color_distance (&bg_tty_color
, &bg_std_color
)
5167 > TTY_SAME_COLOR_THRESHOLD
)
5168 return 0; /* displayed color is too different */
5170 /* Make sure the color is really different than the default. */
5172 XColor def_bg_color
;
5173 if (tty_lookup_color (f
, def_bg
, &def_bg_color
, 0)
5174 && (color_distance (&bg_tty_color
, &def_bg_color
)
5175 <= TTY_SAME_COLOR_THRESHOLD
))
5180 /* If both foreground and background are requested, see if the
5181 distance between them is OK. We just check to see if the distance
5182 between the tty's foreground and background is close enough to the
5183 distance between the standard foreground and background. */
5184 if (STRINGP (fg
) && STRINGP (bg
))
5187 = (color_distance (&fg_std_color
, &bg_std_color
)
5188 - color_distance (&fg_tty_color
, &bg_tty_color
));
5189 if (delta_delta
> TTY_SAME_COLOR_THRESHOLD
5190 || delta_delta
< -TTY_SAME_COLOR_THRESHOLD
)
5195 /* See if the capabilities we selected above are supported, with the
5197 if (test_caps
!= 0 &&
5198 ! tty_capable_p (FRAME_TTY (f
), test_caps
, fg_tty_color
.pixel
, bg_tty_color
.pixel
))
5202 /* Hmmm, everything checks out, this terminal must support this face. */
5207 DEFUN ("display-supports-face-attributes-p",
5208 Fdisplay_supports_face_attributes_p
, Sdisplay_supports_face_attributes_p
,
5210 doc
: /* Return non-nil if all the face attributes in ATTRIBUTES are supported.
5211 The optional argument DISPLAY can be a display name, a frame, or
5212 nil (meaning the selected frame's display).
5214 The definition of `supported' is somewhat heuristic, but basically means
5215 that a face containing all the attributes in ATTRIBUTES, when merged
5216 with the default face for display, can be represented in a way that's
5218 \(1) different in appearance than the default face, and
5219 \(2) `close in spirit' to what the attributes specify, if not exact.
5221 Point (2) implies that a `:weight black' attribute will be satisfied by
5222 any display that can display bold, and a `:foreground \"yellow\"' as long
5223 as it can display a yellowish color, but `:slant italic' will _not_ be
5224 satisfied by the tty display code's automatic substitution of a `dim'
5225 face for italic. */)
5226 (attributes
, display
)
5227 Lisp_Object attributes
, display
;
5229 int supports
= 0, i
;
5232 struct face
*def_face
;
5233 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5235 if (noninteractive
|| !initialized
)
5236 /* We may not be able to access low-level face information in batch
5237 mode, or before being dumped, and this function is not going to
5238 be very useful in those cases anyway, so just give up. */
5242 frame
= selected_frame
;
5243 else if (FRAMEP (display
))
5247 /* Find any frame on DISPLAY. */
5248 Lisp_Object fl_tail
;
5251 for (fl_tail
= Vframe_list
; CONSP (fl_tail
); fl_tail
= XCDR (fl_tail
))
5253 frame
= XCAR (fl_tail
);
5254 if (!NILP (Fequal (Fcdr (Fassq (Qdisplay
,
5255 XFRAME (frame
)->param_alist
)),
5261 CHECK_LIVE_FRAME (frame
);
5264 for (i
= 0; i
< LFACE_VECTOR_SIZE
; i
++)
5265 attrs
[i
] = Qunspecified
;
5266 merge_face_ref (f
, attributes
, attrs
, 1, 0);
5268 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5269 if (def_face
== NULL
)
5271 if (! realize_basic_faces (f
))
5272 error ("Cannot realize default face");
5273 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5274 if (def_face
== NULL
)
5275 abort (); /* realize_basic_faces must have set it up */
5278 /* Dispatch to the appropriate handler. */
5279 if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
5280 supports
= tty_supports_face_attributes_p (f
, attrs
, def_face
);
5281 #ifdef HAVE_WINDOW_SYSTEM
5283 supports
= x_supports_face_attributes_p (f
, attrs
, def_face
);
5286 return supports
? Qt
: Qnil
;
5290 /***********************************************************************
5292 ***********************************************************************/
5294 DEFUN ("internal-set-font-selection-order",
5295 Finternal_set_font_selection_order
,
5296 Sinternal_set_font_selection_order
, 1, 1, 0,
5297 doc
: /* Set font selection order for face font selection to ORDER.
5298 ORDER must be a list of length 4 containing the symbols `:width',
5299 `:height', `:weight', and `:slant'. Face attributes appearing
5300 first in ORDER are matched first, e.g. if `:height' appears before
5301 `:weight' in ORDER, font selection first tries to find a font with
5302 a suitable height, and then tries to match the font weight.
5309 int indices
[DIM (font_sort_order
)];
5312 bzero (indices
, sizeof indices
);
5316 CONSP (list
) && i
< DIM (indices
);
5317 list
= XCDR (list
), ++i
)
5319 Lisp_Object attr
= XCAR (list
);
5322 if (EQ (attr
, QCwidth
))
5324 else if (EQ (attr
, QCheight
))
5325 xlfd
= XLFD_POINT_SIZE
;
5326 else if (EQ (attr
, QCweight
))
5328 else if (EQ (attr
, QCslant
))
5333 if (indices
[i
] != 0)
5338 if (!NILP (list
) || i
!= DIM (indices
))
5339 signal_error ("Invalid font sort order", order
);
5340 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
5341 if (indices
[i
] == 0)
5342 signal_error ("Invalid font sort order", order
);
5344 if (bcmp (indices
, font_sort_order
, sizeof indices
) != 0)
5346 bcopy (indices
, font_sort_order
, sizeof font_sort_order
);
5347 free_all_realized_faces (Qnil
);
5350 font_update_sort_order (font_sort_order
);
5356 DEFUN ("internal-set-alternative-font-family-alist",
5357 Finternal_set_alternative_font_family_alist
,
5358 Sinternal_set_alternative_font_family_alist
, 1, 1, 0,
5359 doc
: /* Define alternative font families to try in face font selection.
5360 ALIST is an alist of (FAMILY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
5361 Each ALTERNATIVE is tried in order if no fonts of font family FAMILY can
5362 be found. Value is ALIST. */)
5367 Vface_alternative_font_family_alist
= alist
;
5368 free_all_realized_faces (Qnil
);
5373 DEFUN ("internal-set-alternative-font-registry-alist",
5374 Finternal_set_alternative_font_registry_alist
,
5375 Sinternal_set_alternative_font_registry_alist
, 1, 1, 0,
5376 doc
: /* Define alternative font registries to try in face font selection.
5377 ALIST is an alist of (REGISTRY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
5378 Each ALTERNATIVE is tried in order if no fonts of font registry REGISTRY can
5379 be found. Value is ALIST. */)
5384 Vface_alternative_font_registry_alist
= alist
;
5385 free_all_realized_faces (Qnil
);
5390 #ifdef HAVE_WINDOW_SYSTEM
5392 /* Ignore the difference of font point size less than this value. */
5394 #define FONT_POINT_SIZE_QUANTUM 5
5396 /* Return the fontset id of the base fontset name or alias name given
5397 by the fontset attribute of ATTRS. Value is -1 if the fontset
5398 attribute of ATTRS doesn't name a fontset. */
5401 face_fontset (attrs
)
5406 name
= attrs
[LFACE_FONTSET_INDEX
];
5407 if (!STRINGP (name
))
5409 return fs_query_fontset (name
, 0);
5412 #endif /* HAVE_WINDOW_SYSTEM */
5416 /***********************************************************************
5418 ***********************************************************************/
5420 /* Realize basic faces on frame F. Value is zero if frame parameters
5421 of F don't contain enough information needed to realize the default
5425 realize_basic_faces (f
)
5429 int count
= SPECPDL_INDEX ();
5431 /* Block input here so that we won't be surprised by an X expose
5432 event, for instance, without having the faces set up. */
5434 specbind (Qscalable_fonts_allowed
, Qt
);
5436 if (realize_default_face (f
))
5438 realize_named_face (f
, Qmode_line
, MODE_LINE_FACE_ID
);
5439 realize_named_face (f
, Qmode_line_inactive
, MODE_LINE_INACTIVE_FACE_ID
);
5440 realize_named_face (f
, Qtool_bar
, TOOL_BAR_FACE_ID
);
5441 realize_named_face (f
, Qfringe
, FRINGE_FACE_ID
);
5442 realize_named_face (f
, Qheader_line
, HEADER_LINE_FACE_ID
);
5443 realize_named_face (f
, Qscroll_bar
, SCROLL_BAR_FACE_ID
);
5444 realize_named_face (f
, Qborder
, BORDER_FACE_ID
);
5445 realize_named_face (f
, Qcursor
, CURSOR_FACE_ID
);
5446 realize_named_face (f
, Qmouse
, MOUSE_FACE_ID
);
5447 realize_named_face (f
, Qmenu
, MENU_FACE_ID
);
5448 realize_named_face (f
, Qvertical_border
, VERTICAL_BORDER_FACE_ID
);
5450 /* Reflect changes in the `menu' face in menu bars. */
5451 if (FRAME_FACE_CACHE (f
)->menu_face_changed_p
)
5453 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 0;
5454 #ifdef USE_X_TOOLKIT
5455 if (FRAME_WINDOW_P (f
))
5456 x_update_menu_appearance (f
);
5463 unbind_to (count
, Qnil
);
5469 /* Realize the default face on frame F. If the face is not fully
5470 specified, make it fully-specified. Attributes of the default face
5471 that are not explicitly specified are taken from frame parameters. */
5474 realize_default_face (f
)
5477 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
5479 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5482 /* If the `default' face is not yet known, create it. */
5483 lface
= lface_from_face_name (f
, Qdefault
, 0);
5487 XSETFRAME (frame
, f
);
5488 lface
= Finternal_make_lisp_face (Qdefault
, frame
);
5491 #ifdef HAVE_WINDOW_SYSTEM
5492 if (FRAME_WINDOW_P (f
))
5494 Lisp_Object font_object
;
5496 XSETFONT (font_object
, FRAME_FONT (f
));
5497 set_lface_from_font (f
, lface
, font_object
, f
->default_face_done_p
);
5498 LFACE_FONTSET (lface
) = fontset_name (FRAME_FONTSET (f
));
5499 f
->default_face_done_p
= 1;
5501 #endif /* HAVE_WINDOW_SYSTEM */
5503 if (!FRAME_WINDOW_P (f
))
5505 LFACE_FAMILY (lface
) = build_string ("default");
5506 LFACE_SWIDTH (lface
) = Qnormal
;
5507 LFACE_HEIGHT (lface
) = make_number (1);
5508 if (UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
5509 LFACE_WEIGHT (lface
) = Qnormal
;
5510 if (UNSPECIFIEDP (LFACE_SLANT (lface
)))
5511 LFACE_SLANT (lface
) = Qnormal
;
5514 if (UNSPECIFIEDP (LFACE_UNDERLINE (lface
)))
5515 LFACE_UNDERLINE (lface
) = Qnil
;
5517 if (UNSPECIFIEDP (LFACE_OVERLINE (lface
)))
5518 LFACE_OVERLINE (lface
) = Qnil
;
5520 if (UNSPECIFIEDP (LFACE_STRIKE_THROUGH (lface
)))
5521 LFACE_STRIKE_THROUGH (lface
) = Qnil
;
5523 if (UNSPECIFIEDP (LFACE_BOX (lface
)))
5524 LFACE_BOX (lface
) = Qnil
;
5526 if (UNSPECIFIEDP (LFACE_INVERSE (lface
)))
5527 LFACE_INVERSE (lface
) = Qnil
;
5529 if (UNSPECIFIEDP (LFACE_FOREGROUND (lface
)))
5531 /* This function is called so early that colors are not yet
5532 set in the frame parameter list. */
5533 Lisp_Object color
= Fassq (Qforeground_color
, f
->param_alist
);
5535 if (CONSP (color
) && STRINGP (XCDR (color
)))
5536 LFACE_FOREGROUND (lface
) = XCDR (color
);
5537 else if (FRAME_WINDOW_P (f
))
5539 else if (FRAME_INITIAL_P (f
) || FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
5540 LFACE_FOREGROUND (lface
) = build_string (unspecified_fg
);
5545 if (UNSPECIFIEDP (LFACE_BACKGROUND (lface
)))
5547 /* This function is called so early that colors are not yet
5548 set in the frame parameter list. */
5549 Lisp_Object color
= Fassq (Qbackground_color
, f
->param_alist
);
5550 if (CONSP (color
) && STRINGP (XCDR (color
)))
5551 LFACE_BACKGROUND (lface
) = XCDR (color
);
5552 else if (FRAME_WINDOW_P (f
))
5554 else if (FRAME_INITIAL_P (f
) || FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
5555 LFACE_BACKGROUND (lface
) = build_string (unspecified_bg
);
5560 if (UNSPECIFIEDP (LFACE_STIPPLE (lface
)))
5561 LFACE_STIPPLE (lface
) = Qnil
;
5563 /* Realize the face; it must be fully-specified now. */
5564 xassert (lface_fully_specified_p (XVECTOR (lface
)->contents
));
5565 check_lface (lface
);
5566 bcopy (XVECTOR (lface
)->contents
, attrs
, sizeof attrs
);
5567 face
= realize_face (c
, attrs
, DEFAULT_FACE_ID
);
5569 #ifdef HAVE_WINDOW_SYSTEM
5570 #ifdef HAVE_X_WINDOWS
5571 if (FRAME_X_P (f
) && face
->font
!= FRAME_FONT (f
))
5573 /* This can happen when making a frame on a display that does
5574 not support the default font. */
5578 /* Otherwise, the font specified for the frame was not
5579 acceptable as a font for the default face (perhaps because
5580 auto-scaled fonts are rejected), so we must adjust the frame
5582 x_set_font (f
, LFACE_FONT (lface
), Qnil
);
5584 #endif /* HAVE_X_WINDOWS */
5585 #endif /* HAVE_WINDOW_SYSTEM */
5590 /* Realize basic faces other than the default face in face cache C.
5591 SYMBOL is the face name, ID is the face id the realized face must
5592 have. The default face must have been realized already. */
5595 realize_named_face (f
, symbol
, id
)
5600 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
5601 Lisp_Object lface
= lface_from_face_name (f
, symbol
, 0);
5602 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5603 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5604 struct face
*new_face
;
5606 /* The default face must exist and be fully specified. */
5607 get_lface_attributes (f
, Qdefault
, attrs
, 1);
5608 check_lface_attrs (attrs
);
5609 xassert (lface_fully_specified_p (attrs
));
5611 /* If SYMBOL isn't know as a face, create it. */
5615 XSETFRAME (frame
, f
);
5616 lface
= Finternal_make_lisp_face (symbol
, frame
);
5619 /* Merge SYMBOL's face with the default face. */
5620 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
5621 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
5623 /* Realize the face. */
5624 new_face
= realize_face (c
, attrs
, id
);
5628 /* Realize the fully-specified face with attributes ATTRS in face
5629 cache CACHE for ASCII characters. If FORMER_FACE_ID is
5630 non-negative, it is an ID of face to remove before caching the new
5631 face. Value is a pointer to the newly created realized face. */
5633 static struct face
*
5634 realize_face (cache
, attrs
, former_face_id
)
5635 struct face_cache
*cache
;
5641 /* LFACE must be fully specified. */
5642 xassert (cache
!= NULL
);
5643 check_lface_attrs (attrs
);
5645 if (former_face_id
>= 0 && cache
->used
> former_face_id
)
5647 /* Remove the former face. */
5648 struct face
*former_face
= cache
->faces_by_id
[former_face_id
];
5649 uncache_face (cache
, former_face
);
5650 free_realized_face (cache
->f
, former_face
);
5653 if (FRAME_WINDOW_P (cache
->f
))
5654 face
= realize_x_face (cache
, attrs
);
5655 else if (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
))
5656 face
= realize_tty_face (cache
, attrs
);
5657 else if (FRAME_INITIAL_P (cache
->f
))
5659 /* Create a dummy face. */
5660 face
= make_realized_face (attrs
);
5665 /* Insert the new face. */
5666 cache_face (cache
, face
, lface_hash (attrs
));
5671 #ifdef HAVE_WINDOW_SYSTEM
5672 /* Realize the fully-specified face that uses FONT-OBJECT and has the
5673 same attributes as BASE_FACE except for the font on frame F.
5674 FONT-OBJECT may be nil, in which case, realized a face of
5677 static struct face
*
5678 realize_non_ascii_face (f
, font_object
, base_face
)
5680 Lisp_Object font_object
;
5681 struct face
*base_face
;
5683 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5686 face
= (struct face
*) xmalloc (sizeof *face
);
5691 = (! NILP (font_object
)
5692 && FONT_WEIGHT_NAME_NUMERIC (face
->lface
[LFACE_WEIGHT_INDEX
]) > 100
5693 && FONT_WEIGHT_NUMERIC (font_object
) <= 100);
5695 /* Don't try to free the colors copied bitwise from BASE_FACE. */
5696 face
->colors_copied_bitwise_p
= 1;
5697 face
->font
= NILP (font_object
) ? NULL
: XFONT_OBJECT (font_object
);
5700 cache_face (cache
, face
, face
->hash
);
5704 #endif /* HAVE_WINDOW_SYSTEM */
5707 /* Realize the fully-specified face with attributes ATTRS in face
5708 cache CACHE for ASCII characters. Do it for X frame CACHE->f. If
5709 the new face doesn't share font with the default face, a fontname
5710 is allocated from the heap and set in `font_name' of the new face,
5711 but it is not yet loaded here. Value is a pointer to the newly
5712 created realized face. */
5714 static struct face
*
5715 realize_x_face (cache
, attrs
)
5716 struct face_cache
*cache
;
5719 struct face
*face
= NULL
;
5720 #ifdef HAVE_WINDOW_SYSTEM
5721 struct face
*default_face
;
5723 Lisp_Object stipple
, overline
, strike_through
, box
;
5725 xassert (FRAME_WINDOW_P (cache
->f
));
5727 /* Allocate a new realized face. */
5728 face
= make_realized_face (attrs
);
5729 face
->ascii_face
= face
;
5733 /* Determine the font to use. Most of the time, the font will be
5734 the same as the font of the default face, so try that first. */
5735 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5737 && lface_same_font_attributes_p (default_face
->lface
, attrs
))
5739 face
->font
= default_face
->font
;
5740 face
->fontset
= make_fontset_for_ascii_face (f
, -1, face
);
5744 /* If the face attribute ATTRS specifies a fontset, use it as
5745 the base of a new realized fontset. Otherwise, use the same
5746 base fontset as of the default face. The base determines
5747 registry and encoding of a font. It may also determine
5748 foundry and family. The other fields of font name pattern
5749 are constructed from ATTRS. */
5750 int fontset
= face_fontset (attrs
);
5752 /* If we are realizing the default face, ATTRS should specify a
5753 fontset. In other words, if FONTSET is -1, we are not
5754 realizing the default face, thus the default face should have
5755 already been realized. */
5757 fontset
= default_face
->fontset
;
5760 if (! FONT_OBJECT_P (attrs
[LFACE_FONT_INDEX
]))
5761 attrs
[LFACE_FONT_INDEX
]
5762 = font_load_for_lface (f
, attrs
, attrs
[LFACE_FONT_INDEX
]);
5763 if (FONT_OBJECT_P (attrs
[LFACE_FONT_INDEX
]))
5765 face
->font
= XFONT_OBJECT (attrs
[LFACE_FONT_INDEX
]);
5766 face
->fontset
= make_fontset_for_ascii_face (f
, fontset
, face
);
5776 && FONT_WEIGHT_NAME_NUMERIC (attrs
[LFACE_WEIGHT_INDEX
]) > 100
5777 && FONT_WEIGHT_NUMERIC (attrs
[LFACE_FONT_INDEX
]) <= 100)
5778 face
->overstrike
= 1;
5780 /* Load colors, and set remaining attributes. */
5782 load_face_colors (f
, face
, attrs
);
5785 box
= attrs
[LFACE_BOX_INDEX
];
5788 /* A simple box of line width 1 drawn in color given by
5790 face
->box_color
= load_color (f
, face
, attrs
[LFACE_BOX_INDEX
],
5792 face
->box
= FACE_SIMPLE_BOX
;
5793 face
->box_line_width
= 1;
5795 else if (INTEGERP (box
))
5797 /* Simple box of specified line width in foreground color of the
5799 xassert (XINT (box
) != 0);
5800 face
->box
= FACE_SIMPLE_BOX
;
5801 face
->box_line_width
= XINT (box
);
5802 face
->box_color
= face
->foreground
;
5803 face
->box_color_defaulted_p
= 1;
5805 else if (CONSP (box
))
5807 /* `(:width WIDTH :color COLOR :shadow SHADOW)'. SHADOW
5808 being one of `raised' or `sunken'. */
5809 face
->box
= FACE_SIMPLE_BOX
;
5810 face
->box_color
= face
->foreground
;
5811 face
->box_color_defaulted_p
= 1;
5812 face
->box_line_width
= 1;
5816 Lisp_Object keyword
, value
;
5818 keyword
= XCAR (box
);
5826 if (EQ (keyword
, QCline_width
))
5828 if (INTEGERP (value
) && XINT (value
) != 0)
5829 face
->box_line_width
= XINT (value
);
5831 else if (EQ (keyword
, QCcolor
))
5833 if (STRINGP (value
))
5835 face
->box_color
= load_color (f
, face
, value
,
5837 face
->use_box_color_for_shadows_p
= 1;
5840 else if (EQ (keyword
, QCstyle
))
5842 if (EQ (value
, Qreleased_button
))
5843 face
->box
= FACE_RAISED_BOX
;
5844 else if (EQ (value
, Qpressed_button
))
5845 face
->box
= FACE_SUNKEN_BOX
;
5850 /* Text underline, overline, strike-through. */
5852 if (EQ (attrs
[LFACE_UNDERLINE_INDEX
], Qt
))
5854 /* Use default color (same as foreground color). */
5855 face
->underline_p
= 1;
5856 face
->underline_defaulted_p
= 1;
5857 face
->underline_color
= 0;
5859 else if (STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]))
5861 /* Use specified color. */
5862 face
->underline_p
= 1;
5863 face
->underline_defaulted_p
= 0;
5864 face
->underline_color
5865 = load_color (f
, face
, attrs
[LFACE_UNDERLINE_INDEX
],
5866 LFACE_UNDERLINE_INDEX
);
5868 else if (NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
5870 face
->underline_p
= 0;
5871 face
->underline_defaulted_p
= 0;
5872 face
->underline_color
= 0;
5875 overline
= attrs
[LFACE_OVERLINE_INDEX
];
5876 if (STRINGP (overline
))
5878 face
->overline_color
5879 = load_color (f
, face
, attrs
[LFACE_OVERLINE_INDEX
],
5880 LFACE_OVERLINE_INDEX
);
5881 face
->overline_p
= 1;
5883 else if (EQ (overline
, Qt
))
5885 face
->overline_color
= face
->foreground
;
5886 face
->overline_color_defaulted_p
= 1;
5887 face
->overline_p
= 1;
5890 strike_through
= attrs
[LFACE_STRIKE_THROUGH_INDEX
];
5891 if (STRINGP (strike_through
))
5893 face
->strike_through_color
5894 = load_color (f
, face
, attrs
[LFACE_STRIKE_THROUGH_INDEX
],
5895 LFACE_STRIKE_THROUGH_INDEX
);
5896 face
->strike_through_p
= 1;
5898 else if (EQ (strike_through
, Qt
))
5900 face
->strike_through_color
= face
->foreground
;
5901 face
->strike_through_color_defaulted_p
= 1;
5902 face
->strike_through_p
= 1;
5905 stipple
= attrs
[LFACE_STIPPLE_INDEX
];
5906 if (!NILP (stipple
))
5907 face
->stipple
= load_pixmap (f
, stipple
, &face
->pixmap_w
, &face
->pixmap_h
);
5908 #endif /* HAVE_WINDOW_SYSTEM */
5914 /* Map a specified color of face FACE on frame F to a tty color index.
5915 IDX is either LFACE_FOREGROUND_INDEX or LFACE_BACKGROUND_INDEX, and
5916 specifies which color to map. Set *DEFAULTED to 1 if mapping to the
5917 default foreground/background colors. */
5920 map_tty_color (f
, face
, idx
, defaulted
)
5923 enum lface_attribute_index idx
;
5926 Lisp_Object frame
, color
, def
;
5927 int foreground_p
= idx
== LFACE_FOREGROUND_INDEX
;
5928 unsigned long default_pixel
, default_other_pixel
, pixel
;
5930 xassert (idx
== LFACE_FOREGROUND_INDEX
|| idx
== LFACE_BACKGROUND_INDEX
);
5934 pixel
= default_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
5935 default_other_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
5939 pixel
= default_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
5940 default_other_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
5943 XSETFRAME (frame
, f
);
5944 color
= face
->lface
[idx
];
5948 && CONSP (Vtty_defined_color_alist
)
5949 && (def
= assq_no_quit (color
, call1 (Qtty_color_alist
, frame
)),
5952 /* Associations in tty-defined-color-alist are of the form
5953 (NAME INDEX R G B). We need the INDEX part. */
5954 pixel
= XINT (XCAR (XCDR (def
)));
5957 if (pixel
== default_pixel
&& STRINGP (color
))
5959 pixel
= load_color (f
, face
, color
, idx
);
5962 /* If the foreground of the default face is the default color,
5963 use the foreground color defined by the frame. */
5964 if (FRAME_MSDOS_P (f
))
5966 if (pixel
== default_pixel
5967 || pixel
== FACE_TTY_DEFAULT_COLOR
)
5970 pixel
= FRAME_FOREGROUND_PIXEL (f
);
5972 pixel
= FRAME_BACKGROUND_PIXEL (f
);
5973 face
->lface
[idx
] = tty_color_name (f
, pixel
);
5976 else if (pixel
== default_other_pixel
)
5979 pixel
= FRAME_BACKGROUND_PIXEL (f
);
5981 pixel
= FRAME_FOREGROUND_PIXEL (f
);
5982 face
->lface
[idx
] = tty_color_name (f
, pixel
);
5990 face
->foreground
= pixel
;
5992 face
->background
= pixel
;
5996 /* Realize the fully-specified face with attributes ATTRS in face
5997 cache CACHE for ASCII characters. Do it for TTY frame CACHE->f.
5998 Value is a pointer to the newly created realized face. */
6000 static struct face
*
6001 realize_tty_face (cache
, attrs
)
6002 struct face_cache
*cache
;
6007 int face_colors_defaulted
= 0;
6008 struct frame
*f
= cache
->f
;
6010 /* Frame must be a termcap frame. */
6011 xassert (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
));
6013 /* Allocate a new realized face. */
6014 face
= make_realized_face (attrs
);
6016 face
->font_name
= FRAME_MSDOS_P (cache
->f
) ? "ms-dos" : "tty";
6019 /* Map face attributes to TTY appearances. We map slant to
6020 dimmed text because we want italic text to appear differently
6021 and because dimmed text is probably used infrequently. */
6022 weight
= FONT_WEIGHT_NAME_NUMERIC (attrs
[LFACE_WEIGHT_INDEX
]);
6023 slant
= FONT_SLANT_NAME_NUMERIC (attrs
[LFACE_SLANT_INDEX
]);
6025 face
->tty_bold_p
= 1;
6026 if (weight
< 100 || slant
!= 100)
6027 face
->tty_dim_p
= 1;
6028 if (!NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
6029 face
->tty_underline_p
= 1;
6030 if (!NILP (attrs
[LFACE_INVERSE_INDEX
]))
6031 face
->tty_reverse_p
= 1;
6033 /* Map color names to color indices. */
6034 map_tty_color (f
, face
, LFACE_FOREGROUND_INDEX
, &face_colors_defaulted
);
6035 map_tty_color (f
, face
, LFACE_BACKGROUND_INDEX
, &face_colors_defaulted
);
6037 /* Swap colors if face is inverse-video. If the colors are taken
6038 from the frame colors, they are already inverted, since the
6039 frame-creation function calls x-handle-reverse-video. */
6040 if (face
->tty_reverse_p
&& !face_colors_defaulted
)
6042 unsigned long tem
= face
->foreground
;
6043 face
->foreground
= face
->background
;
6044 face
->background
= tem
;
6047 if (tty_suppress_bold_inverse_default_colors_p
6049 && face
->background
== FACE_TTY_DEFAULT_FG_COLOR
6050 && face
->foreground
== FACE_TTY_DEFAULT_BG_COLOR
)
6051 face
->tty_bold_p
= 0;
6057 DEFUN ("tty-suppress-bold-inverse-default-colors",
6058 Ftty_suppress_bold_inverse_default_colors
,
6059 Stty_suppress_bold_inverse_default_colors
, 1, 1, 0,
6060 doc
: /* Suppress/allow boldness of faces with inverse default colors.
6061 SUPPRESS non-nil means suppress it.
6062 This affects bold faces on TTYs whose foreground is the default background
6063 color of the display and whose background is the default foreground color.
6064 For such faces, the bold face attribute is ignored if this variable
6067 Lisp_Object suppress
;
6069 tty_suppress_bold_inverse_default_colors_p
= !NILP (suppress
);
6070 ++face_change_count
;
6076 /***********************************************************************
6078 ***********************************************************************/
6080 /* Return the ID of the face to use to display character CH with face
6081 property PROP on frame F in current_buffer. */
6084 compute_char_face (f
, ch
, prop
)
6091 if (NILP (current_buffer
->enable_multibyte_characters
))
6096 struct face
*face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6097 face_id
= FACE_FOR_CHAR (f
, face
, ch
, -1, Qnil
);
6101 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6102 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6103 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
6104 merge_face_ref (f
, prop
, attrs
, 1, 0);
6105 face_id
= lookup_face (f
, attrs
);
6111 /* Return the face ID associated with buffer position POS for
6112 displaying ASCII characters. Return in *ENDPTR the position at
6113 which a different face is needed, as far as text properties and
6114 overlays are concerned. W is a window displaying current_buffer.
6116 REGION_BEG, REGION_END delimit the region, so it can be
6119 LIMIT is a position not to scan beyond. That is to limit the time
6120 this function can take.
6122 If MOUSE is non-zero, use the character's mouse-face, not its face.
6124 The face returned is suitable for displaying ASCII characters. */
6127 face_at_buffer_position (w
, pos
, region_beg
, region_end
,
6128 endptr
, limit
, mouse
)
6131 EMACS_INT region_beg
, region_end
;
6136 struct frame
*f
= XFRAME (w
->frame
);
6137 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6138 Lisp_Object prop
, position
;
6140 Lisp_Object
*overlay_vec
;
6143 Lisp_Object propname
= mouse
? Qmouse_face
: Qface
;
6144 Lisp_Object limit1
, end
;
6145 struct face
*default_face
;
6147 /* W must display the current buffer. We could write this function
6148 to use the frame and buffer of W, but right now it doesn't. */
6149 /* xassert (XBUFFER (w->buffer) == current_buffer); */
6151 XSETFRAME (frame
, f
);
6152 XSETFASTINT (position
, pos
);
6155 if (pos
< region_beg
&& region_beg
< endpos
)
6156 endpos
= region_beg
;
6158 /* Get the `face' or `mouse_face' text property at POS, and
6159 determine the next position at which the property changes. */
6160 prop
= Fget_text_property (position
, propname
, w
->buffer
);
6161 XSETFASTINT (limit1
, (limit
< endpos
? limit
: endpos
));
6162 end
= Fnext_single_property_change (position
, propname
, w
->buffer
, limit1
);
6164 endpos
= XINT (end
);
6166 /* Look at properties from overlays. */
6168 EMACS_INT next_overlay
;
6170 GET_OVERLAYS_AT (pos
, overlay_vec
, noverlays
, &next_overlay
, 0);
6171 if (next_overlay
< endpos
)
6172 endpos
= next_overlay
;
6177 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6179 /* Optimize common cases where we can use the default face. */
6182 && !(pos
>= region_beg
&& pos
< region_end
))
6183 return DEFAULT_FACE_ID
;
6185 /* Begin with attributes from the default face. */
6186 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
6188 /* Merge in attributes specified via text properties. */
6190 merge_face_ref (f
, prop
, attrs
, 1, 0);
6192 /* Now merge the overlay data. */
6193 noverlays
= sort_overlays (overlay_vec
, noverlays
, w
);
6194 for (i
= 0; i
< noverlays
; i
++)
6199 prop
= Foverlay_get (overlay_vec
[i
], propname
);
6201 merge_face_ref (f
, prop
, attrs
, 1, 0);
6203 oend
= OVERLAY_END (overlay_vec
[i
]);
6204 oendpos
= OVERLAY_POSITION (oend
);
6205 if (oendpos
< endpos
)
6209 /* If in the region, merge in the region face. */
6210 if (pos
>= region_beg
&& pos
< region_end
)
6212 merge_named_face (f
, Qregion
, attrs
, 0);
6214 if (region_end
< endpos
)
6215 endpos
= region_end
;
6220 /* Look up a realized face with the given face attributes,
6221 or realize a new one for ASCII characters. */
6222 return lookup_face (f
, attrs
);
6225 /* Return the face ID at buffer position POS for displaying ASCII
6226 characters associated with overlay strings for overlay OVERLAY.
6228 Like face_at_buffer_position except for OVERLAY. Currently it
6229 simply disregards the `face' properties of all overlays. */
6232 face_for_overlay_string (w
, pos
, region_beg
, region_end
,
6233 endptr
, limit
, mouse
, overlay
)
6236 EMACS_INT region_beg
, region_end
;
6240 Lisp_Object overlay
;
6242 struct frame
*f
= XFRAME (w
->frame
);
6243 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6244 Lisp_Object prop
, position
;
6247 Lisp_Object propname
= mouse
? Qmouse_face
: Qface
;
6248 Lisp_Object limit1
, end
;
6249 struct face
*default_face
;
6251 /* W must display the current buffer. We could write this function
6252 to use the frame and buffer of W, but right now it doesn't. */
6253 /* xassert (XBUFFER (w->buffer) == current_buffer); */
6255 XSETFRAME (frame
, f
);
6256 XSETFASTINT (position
, pos
);
6259 if (pos
< region_beg
&& region_beg
< endpos
)
6260 endpos
= region_beg
;
6262 /* Get the `face' or `mouse_face' text property at POS, and
6263 determine the next position at which the property changes. */
6264 prop
= Fget_text_property (position
, propname
, w
->buffer
);
6265 XSETFASTINT (limit1
, (limit
< endpos
? limit
: endpos
));
6266 end
= Fnext_single_property_change (position
, propname
, w
->buffer
, limit1
);
6268 endpos
= XINT (end
);
6272 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6274 /* Optimize common cases where we can use the default face. */
6276 && !(pos
>= region_beg
&& pos
< region_end
))
6277 return DEFAULT_FACE_ID
;
6279 /* Begin with attributes from the default face. */
6280 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
6282 /* Merge in attributes specified via text properties. */
6284 merge_face_ref (f
, prop
, attrs
, 1, 0);
6286 /* If in the region, merge in the region face. */
6287 if (pos
>= region_beg
&& pos
< region_end
)
6289 merge_named_face (f
, Qregion
, attrs
, 0);
6291 if (region_end
< endpos
)
6292 endpos
= region_end
;
6297 /* Look up a realized face with the given face attributes,
6298 or realize a new one for ASCII characters. */
6299 return lookup_face (f
, attrs
);
6303 /* Compute the face at character position POS in Lisp string STRING on
6304 window W, for ASCII characters.
6306 If STRING is an overlay string, it comes from position BUFPOS in
6307 current_buffer, otherwise BUFPOS is zero to indicate that STRING is
6308 not an overlay string. W must display the current buffer.
6309 REGION_BEG and REGION_END give the start and end positions of the
6310 region; both are -1 if no region is visible.
6312 BASE_FACE_ID is the id of a face to merge with. For strings coming
6313 from overlays or the `display' property it is the face at BUFPOS.
6315 If MOUSE_P is non-zero, use the character's mouse-face, not its face.
6317 Set *ENDPTR to the next position where to check for faces in
6318 STRING; -1 if the face is constant from POS to the end of the
6321 Value is the id of the face to use. The face returned is suitable
6322 for displaying ASCII characters. */
6325 face_at_string_position (w
, string
, pos
, bufpos
, region_beg
,
6326 region_end
, endptr
, base_face_id
, mouse_p
)
6329 EMACS_INT pos
, bufpos
;
6330 EMACS_INT region_beg
, region_end
;
6332 enum face_id base_face_id
;
6335 Lisp_Object prop
, position
, end
, limit
;
6336 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
6337 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6338 struct face
*base_face
;
6339 int multibyte_p
= STRING_MULTIBYTE (string
);
6340 Lisp_Object prop_name
= mouse_p
? Qmouse_face
: Qface
;
6342 /* Get the value of the face property at the current position within
6343 STRING. Value is nil if there is no face property. */
6344 XSETFASTINT (position
, pos
);
6345 prop
= Fget_text_property (position
, prop_name
, string
);
6347 /* Get the next position at which to check for faces. Value of end
6348 is nil if face is constant all the way to the end of the string.
6349 Otherwise it is a string position where to check faces next.
6350 Limit is the maximum position up to which to check for property
6351 changes in Fnext_single_property_change. Strings are usually
6352 short, so set the limit to the end of the string. */
6353 XSETFASTINT (limit
, SCHARS (string
));
6354 end
= Fnext_single_property_change (position
, prop_name
, string
, limit
);
6356 *endptr
= XFASTINT (end
);
6360 base_face
= FACE_FROM_ID (f
, base_face_id
);
6361 xassert (base_face
);
6363 /* Optimize the default case that there is no face property and we
6364 are not in the region. */
6366 && (base_face_id
!= DEFAULT_FACE_ID
6367 /* BUFPOS <= 0 means STRING is not an overlay string, so
6368 that the region doesn't have to be taken into account. */
6370 || bufpos
< region_beg
6371 || bufpos
>= region_end
)
6373 /* We can't realize faces for different charsets differently
6374 if we don't have fonts, so we can stop here if not working
6375 on a window-system frame. */
6376 || !FRAME_WINDOW_P (f
)
6377 || FACE_SUITABLE_FOR_CHAR_P (base_face
, 0)))
6378 return base_face
->id
;
6380 /* Begin with attributes from the base face. */
6381 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
6383 /* Merge in attributes specified via text properties. */
6385 merge_face_ref (f
, prop
, attrs
, 1, 0);
6387 /* If in the region, merge in the region face. */
6389 && bufpos
>= region_beg
6390 && bufpos
< region_end
)
6391 merge_named_face (f
, Qregion
, attrs
, 0);
6393 /* Look up a realized face with the given face attributes,
6394 or realize a new one for ASCII characters. */
6395 return lookup_face (f
, attrs
);
6399 /* Merge a face into a realized face.
6401 F is frame where faces are (to be) realized.
6403 FACE_NAME is named face to merge.
6405 If FACE_NAME is nil, FACE_ID is face_id of realized face to merge.
6407 If FACE_NAME is t, FACE_ID is lface_id of face to merge.
6409 BASE_FACE_ID is realized face to merge into.
6415 merge_faces (f
, face_name
, face_id
, base_face_id
)
6417 Lisp_Object face_name
;
6418 int face_id
, base_face_id
;
6420 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6421 struct face
*base_face
;
6423 base_face
= FACE_FROM_ID (f
, base_face_id
);
6425 return base_face_id
;
6427 if (EQ (face_name
, Qt
))
6429 if (face_id
< 0 || face_id
>= lface_id_to_name_size
)
6430 return base_face_id
;
6431 face_name
= lface_id_to_name
[face_id
];
6432 face_id
= lookup_derived_face (f
, face_name
, base_face_id
, 1);
6435 return base_face_id
;
6438 /* Begin with attributes from the base face. */
6439 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
6441 if (!NILP (face_name
))
6443 if (!merge_named_face (f
, face_name
, attrs
, 0))
6444 return base_face_id
;
6450 return base_face_id
;
6451 face
= FACE_FROM_ID (f
, face_id
);
6453 return base_face_id
;
6454 merge_face_vectors (f
, face
->lface
, attrs
, 0);
6457 /* Look up a realized face with the given face attributes,
6458 or realize a new one for ASCII characters. */
6459 return lookup_face (f
, attrs
);
6463 /***********************************************************************
6465 ***********************************************************************/
6469 /* Print the contents of the realized face FACE to stderr. */
6472 dump_realized_face (face
)
6475 fprintf (stderr
, "ID: %d\n", face
->id
);
6476 #ifdef HAVE_X_WINDOWS
6477 fprintf (stderr
, "gc: %ld\n", (long) face
->gc
);
6479 fprintf (stderr
, "foreground: 0x%lx (%s)\n",
6481 SDATA (face
->lface
[LFACE_FOREGROUND_INDEX
]));
6482 fprintf (stderr
, "background: 0x%lx (%s)\n",
6484 SDATA (face
->lface
[LFACE_BACKGROUND_INDEX
]));
6486 fprintf (stderr
, "font_name: %s (%s)\n",
6487 SDATA (face
->font
->props
[FONT_NAME_INDEX
]),
6488 SDATA (face
->lface
[LFACE_FAMILY_INDEX
]));
6489 #ifdef HAVE_X_WINDOWS
6490 fprintf (stderr
, "font = %p\n", face
->font
);
6492 fprintf (stderr
, "fontset: %d\n", face
->fontset
);
6493 fprintf (stderr
, "underline: %d (%s)\n",
6495 SDATA (Fsymbol_name (face
->lface
[LFACE_UNDERLINE_INDEX
])));
6496 fprintf (stderr
, "hash: %d\n", face
->hash
);
6500 DEFUN ("dump-face", Fdump_face
, Sdump_face
, 0, 1, 0, doc
: /* */)
6508 fprintf (stderr
, "font selection order: ");
6509 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6510 fprintf (stderr
, "%d ", font_sort_order
[i
]);
6511 fprintf (stderr
, "\n");
6513 fprintf (stderr
, "alternative fonts: ");
6514 debug_print (Vface_alternative_font_family_alist
);
6515 fprintf (stderr
, "\n");
6517 for (i
= 0; i
< FRAME_FACE_CACHE (SELECTED_FRAME ())->used
; ++i
)
6518 Fdump_face (make_number (i
));
6524 face
= FACE_FROM_ID (SELECTED_FRAME (), XINT (n
));
6526 error ("Not a valid face");
6527 dump_realized_face (face
);
6534 DEFUN ("show-face-resources", Fshow_face_resources
, Sshow_face_resources
,
6535 0, 0, 0, doc
: /* */)
6538 fprintf (stderr
, "number of colors = %d\n", ncolors_allocated
);
6539 fprintf (stderr
, "number of pixmaps = %d\n", npixmaps_allocated
);
6540 fprintf (stderr
, "number of GCs = %d\n", ngcs
);
6544 #endif /* GLYPH_DEBUG != 0 */
6548 /***********************************************************************
6550 ***********************************************************************/
6555 Qface
= intern ("face");
6557 Qface_no_inherit
= intern ("face-no-inherit");
6558 staticpro (&Qface_no_inherit
);
6559 Qbitmap_spec_p
= intern ("bitmap-spec-p");
6560 staticpro (&Qbitmap_spec_p
);
6561 Qframe_set_background_mode
= intern ("frame-set-background-mode");
6562 staticpro (&Qframe_set_background_mode
);
6564 /* Lisp face attribute keywords. */
6565 QCfamily
= intern (":family");
6566 staticpro (&QCfamily
);
6567 QCheight
= intern (":height");
6568 staticpro (&QCheight
);
6569 QCweight
= intern (":weight");
6570 staticpro (&QCweight
);
6571 QCslant
= intern (":slant");
6572 staticpro (&QCslant
);
6573 QCunderline
= intern (":underline");
6574 staticpro (&QCunderline
);
6575 QCinverse_video
= intern (":inverse-video");
6576 staticpro (&QCinverse_video
);
6577 QCreverse_video
= intern (":reverse-video");
6578 staticpro (&QCreverse_video
);
6579 QCforeground
= intern (":foreground");
6580 staticpro (&QCforeground
);
6581 QCbackground
= intern (":background");
6582 staticpro (&QCbackground
);
6583 QCstipple
= intern (":stipple");
6584 staticpro (&QCstipple
);
6585 QCwidth
= intern (":width");
6586 staticpro (&QCwidth
);
6587 QCfont
= intern (":font");
6588 staticpro (&QCfont
);
6589 QCfontset
= intern (":fontset");
6590 staticpro (&QCfontset
);
6591 QCbold
= intern (":bold");
6592 staticpro (&QCbold
);
6593 QCitalic
= intern (":italic");
6594 staticpro (&QCitalic
);
6595 QCoverline
= intern (":overline");
6596 staticpro (&QCoverline
);
6597 QCstrike_through
= intern (":strike-through");
6598 staticpro (&QCstrike_through
);
6599 QCbox
= intern (":box");
6601 QCinherit
= intern (":inherit");
6602 staticpro (&QCinherit
);
6604 /* Symbols used for Lisp face attribute values. */
6605 QCcolor
= intern (":color");
6606 staticpro (&QCcolor
);
6607 QCline_width
= intern (":line-width");
6608 staticpro (&QCline_width
);
6609 QCstyle
= intern (":style");
6610 staticpro (&QCstyle
);
6611 Qreleased_button
= intern ("released-button");
6612 staticpro (&Qreleased_button
);
6613 Qpressed_button
= intern ("pressed-button");
6614 staticpro (&Qpressed_button
);
6615 Qnormal
= intern ("normal");
6616 staticpro (&Qnormal
);
6617 Qultra_light
= intern ("ultra-light");
6618 staticpro (&Qultra_light
);
6619 Qextra_light
= intern ("extra-light");
6620 staticpro (&Qextra_light
);
6621 Qlight
= intern ("light");
6622 staticpro (&Qlight
);
6623 Qsemi_light
= intern ("semi-light");
6624 staticpro (&Qsemi_light
);
6625 Qsemi_bold
= intern ("semi-bold");
6626 staticpro (&Qsemi_bold
);
6627 Qbold
= intern ("bold");
6629 Qextra_bold
= intern ("extra-bold");
6630 staticpro (&Qextra_bold
);
6631 Qultra_bold
= intern ("ultra-bold");
6632 staticpro (&Qultra_bold
);
6633 Qoblique
= intern ("oblique");
6634 staticpro (&Qoblique
);
6635 Qitalic
= intern ("italic");
6636 staticpro (&Qitalic
);
6637 Qreverse_oblique
= intern ("reverse-oblique");
6638 staticpro (&Qreverse_oblique
);
6639 Qreverse_italic
= intern ("reverse-italic");
6640 staticpro (&Qreverse_italic
);
6641 Qultra_condensed
= intern ("ultra-condensed");
6642 staticpro (&Qultra_condensed
);
6643 Qextra_condensed
= intern ("extra-condensed");
6644 staticpro (&Qextra_condensed
);
6645 Qcondensed
= intern ("condensed");
6646 staticpro (&Qcondensed
);
6647 Qsemi_condensed
= intern ("semi-condensed");
6648 staticpro (&Qsemi_condensed
);
6649 Qsemi_expanded
= intern ("semi-expanded");
6650 staticpro (&Qsemi_expanded
);
6651 Qexpanded
= intern ("expanded");
6652 staticpro (&Qexpanded
);
6653 Qextra_expanded
= intern ("extra-expanded");
6654 staticpro (&Qextra_expanded
);
6655 Qultra_expanded
= intern ("ultra-expanded");
6656 staticpro (&Qultra_expanded
);
6657 Qbackground_color
= intern ("background-color");
6658 staticpro (&Qbackground_color
);
6659 Qforeground_color
= intern ("foreground-color");
6660 staticpro (&Qforeground_color
);
6661 Qunspecified
= intern ("unspecified");
6662 staticpro (&Qunspecified
);
6663 Qignore_defface
= intern (":ignore-defface");
6664 staticpro (&Qignore_defface
);
6666 Qface_alias
= intern ("face-alias");
6667 staticpro (&Qface_alias
);
6668 Qdefault
= intern ("default");
6669 staticpro (&Qdefault
);
6670 Qtool_bar
= intern ("tool-bar");
6671 staticpro (&Qtool_bar
);
6672 Qregion
= intern ("region");
6673 staticpro (&Qregion
);
6674 Qfringe
= intern ("fringe");
6675 staticpro (&Qfringe
);
6676 Qheader_line
= intern ("header-line");
6677 staticpro (&Qheader_line
);
6678 Qscroll_bar
= intern ("scroll-bar");
6679 staticpro (&Qscroll_bar
);
6680 Qmenu
= intern ("menu");
6682 Qcursor
= intern ("cursor");
6683 staticpro (&Qcursor
);
6684 Qborder
= intern ("border");
6685 staticpro (&Qborder
);
6686 Qmouse
= intern ("mouse");
6687 staticpro (&Qmouse
);
6688 Qmode_line_inactive
= intern ("mode-line-inactive");
6689 staticpro (&Qmode_line_inactive
);
6690 Qvertical_border
= intern ("vertical-border");
6691 staticpro (&Qvertical_border
);
6692 Qtty_color_desc
= intern ("tty-color-desc");
6693 staticpro (&Qtty_color_desc
);
6694 Qtty_color_standard_values
= intern ("tty-color-standard-values");
6695 staticpro (&Qtty_color_standard_values
);
6696 Qtty_color_by_index
= intern ("tty-color-by-index");
6697 staticpro (&Qtty_color_by_index
);
6698 Qtty_color_alist
= intern ("tty-color-alist");
6699 staticpro (&Qtty_color_alist
);
6700 Qscalable_fonts_allowed
= intern ("scalable-fonts-allowed");
6701 staticpro (&Qscalable_fonts_allowed
);
6703 Vparam_value_alist
= Fcons (Fcons (Qnil
, Qnil
), Qnil
);
6704 staticpro (&Vparam_value_alist
);
6705 Vface_alternative_font_family_alist
= Qnil
;
6706 staticpro (&Vface_alternative_font_family_alist
);
6707 Vface_alternative_font_registry_alist
= Qnil
;
6708 staticpro (&Vface_alternative_font_registry_alist
);
6710 defsubr (&Sinternal_make_lisp_face
);
6711 defsubr (&Sinternal_lisp_face_p
);
6712 defsubr (&Sinternal_set_lisp_face_attribute
);
6713 #ifdef HAVE_WINDOW_SYSTEM
6714 defsubr (&Sinternal_set_lisp_face_attribute_from_resource
);
6716 defsubr (&Scolor_gray_p
);
6717 defsubr (&Scolor_supported_p
);
6718 defsubr (&Sface_attribute_relative_p
);
6719 defsubr (&Smerge_face_attribute
);
6720 defsubr (&Sinternal_get_lisp_face_attribute
);
6721 defsubr (&Sinternal_lisp_face_attribute_values
);
6722 defsubr (&Sinternal_lisp_face_equal_p
);
6723 defsubr (&Sinternal_lisp_face_empty_p
);
6724 defsubr (&Sinternal_copy_lisp_face
);
6725 defsubr (&Sinternal_merge_in_global_face
);
6726 defsubr (&Sface_font
);
6727 defsubr (&Sframe_face_alist
);
6728 defsubr (&Sdisplay_supports_face_attributes_p
);
6729 defsubr (&Scolor_distance
);
6730 defsubr (&Sinternal_set_font_selection_order
);
6731 defsubr (&Sinternal_set_alternative_font_family_alist
);
6732 defsubr (&Sinternal_set_alternative_font_registry_alist
);
6733 defsubr (&Sface_attributes_as_vector
);
6735 defsubr (&Sdump_face
);
6736 defsubr (&Sshow_face_resources
);
6737 #endif /* GLYPH_DEBUG */
6738 defsubr (&Sclear_face_cache
);
6739 defsubr (&Stty_suppress_bold_inverse_default_colors
);
6741 #if defined DEBUG_X_COLORS && defined HAVE_X_WINDOWS
6742 defsubr (&Sdump_colors
);
6745 DEFVAR_LISP ("font-list-limit", &Vfont_list_limit
,
6746 doc
: /* *Limit for font matching.
6747 If an integer > 0, font matching functions won't load more than
6748 that number of fonts when searching for a matching font. */);
6749 Vfont_list_limit
= make_number (DEFAULT_FONT_LIST_LIMIT
);
6751 DEFVAR_LISP ("face-new-frame-defaults", &Vface_new_frame_defaults
,
6752 doc
: /* List of global face definitions (for internal use only.) */);
6753 Vface_new_frame_defaults
= Qnil
;
6755 DEFVAR_LISP ("face-default-stipple", &Vface_default_stipple
,
6756 doc
: /* *Default stipple pattern used on monochrome displays.
6757 This stipple pattern is used on monochrome displays
6758 instead of shades of gray for a face background color.
6759 See `set-face-stipple' for possible values for this variable. */);
6760 Vface_default_stipple
= build_string ("gray3");
6762 DEFVAR_LISP ("tty-defined-color-alist", &Vtty_defined_color_alist
,
6763 doc
: /* An alist of defined terminal colors and their RGB values. */);
6764 Vtty_defined_color_alist
= Qnil
;
6766 DEFVAR_LISP ("scalable-fonts-allowed", &Vscalable_fonts_allowed
,
6767 doc
: /* Allowed scalable fonts.
6768 A value of nil means don't allow any scalable fonts.
6769 A value of t means allow any scalable font.
6770 Otherwise, value must be a list of regular expressions. A font may be
6771 scaled if its name matches a regular expression in the list.
6772 Note that if value is nil, a scalable font might still be used, if no
6773 other font of the appropriate family and registry is available. */);
6774 Vscalable_fonts_allowed
= Qnil
;
6776 DEFVAR_LISP ("face-ignored-fonts", &Vface_ignored_fonts
,
6777 doc
: /* List of ignored fonts.
6778 Each element is a regular expression that matches names of fonts to
6780 Vface_ignored_fonts
= Qnil
;
6782 DEFVAR_LISP ("face-font-rescale-alist", &Vface_font_rescale_alist
,
6783 doc
: /* Alist of fonts vs the rescaling factors.
6784 Each element is a cons (FONT-NAME-PATTERN . RESCALE-RATIO), where
6785 FONT-NAME-PATTERN is a regular expression matching a font name, and
6786 RESCALE-RATIO is a floating point number to specify how much larger
6787 \(or smaller) font we should use. For instance, if a face requests
6788 a font of 10 point, we actually use a font of 10 * RESCALE-RATIO point. */);
6789 Vface_font_rescale_alist
= Qnil
;
6791 #ifdef HAVE_WINDOW_SYSTEM
6792 defsubr (&Sbitmap_spec_p
);
6793 defsubr (&Sx_list_fonts
);
6794 defsubr (&Sinternal_face_x_get_resource
);
6795 defsubr (&Sx_family_fonts
);
6796 defsubr (&Sx_font_family_list
);
6797 #endif /* HAVE_WINDOW_SYSTEM */
6800 /* arch-tag: 8a0f7598-5517-408d-9ab3-1da6fcd4c749
6801 (do not change this comment) */