1 /* xfaces.c -- "Face" primitives.
2 Copyright (C) 1993, 1994, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
3 2005, 2006, 2007 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
20 Boston, MA 02110-1301, USA. */
22 /* New face implementation by Gerd Moellmann <gerd@gnu.org>. */
26 When using Emacs with X, the display style of characters can be
27 changed by defining `faces'. Each face can specify the following
32 2. Relative proportionate width, aka character set width or set
33 width (swidth), e.g. `semi-compressed'.
35 3. Font height in 1/10pt.
37 4. Font weight, e.g. `bold'.
39 5. Font slant, e.g. `italic'.
45 8. Whether or not characters should be underlined, and in what color.
47 9. Whether or not characters should be displayed in inverse video.
49 10. A background stipple, a bitmap.
51 11. Whether or not characters should be overlined, and in what color.
53 12. Whether or not characters should be strike-through, and in what
56 13. Whether or not a box should be drawn around characters, the box
57 type, and, for simple boxes, in what color.
59 14. Font pattern, or nil. This is a special attribute.
60 When this attribute is specified, the face uses a font opened by
61 that pattern as is. In addition, all the other font-related
62 attributes (1st thru 5th) are generated from the opened font name.
63 On the other hand, if one of the other font-related attributes are
64 specified, this attribute is set to nil. In that case, the face
65 doesn't inherit this attribute from the `default' face, and uses a
66 font determined by the other attributes (those may be inherited
67 from the `default' face).
69 15. A face name or list of face names from which to inherit attributes.
71 16. A specified average font width, which is invisible from Lisp,
72 and is used to ensure that a font specified on the command line,
73 for example, can be matched exactly.
77 Faces are frame-local by nature because Emacs allows to define the
78 same named face (face names are symbols) differently for different
79 frames. Each frame has an alist of face definitions for all named
80 faces. The value of a named face in such an alist is a Lisp vector
81 with the symbol `face' in slot 0, and a slot for each of the face
82 attributes mentioned above.
84 There is also a global face alist `Vface_new_frame_defaults'. Face
85 definitions from this list are used to initialize faces of newly
88 A face doesn't have to specify all attributes. Those not specified
89 have a value of `unspecified'. Faces specifying all attributes but
90 the 14th are called `fully-specified'.
95 The display style of a given character in the text is determined by
96 combining several faces. This process is called `face merging'.
97 Any aspect of the display style that isn't specified by overlays or
98 text properties is taken from the `default' face. Since it is made
99 sure that the default face is always fully-specified, face merging
100 always results in a fully-specified face.
105 After all face attributes for a character have been determined by
106 merging faces of that character, that face is `realized'. The
107 realization process maps face attributes to what is physically
108 available on the system where Emacs runs. The result is a
109 `realized face' in form of a struct face which is stored in the
110 face cache of the frame on which it was realized.
112 Face realization is done in the context of the character to display
113 because different fonts may be used for different characters. In
114 other words, for characters that have different font
115 specifications, different realized faces are needed to display
118 Font specification is done by fontsets. See the comment in
119 fontset.c for the details. In the current implementation, all ASCII
120 characters share the same font in a fontset.
122 Faces are at first realized for ASCII characters, and, at that
123 time, assigned a specific realized fontset. Hereafter, we call
124 such a face as `ASCII face'. When a face for a multibyte character
125 is realized, it inherits (thus shares) a fontset of an ASCII face
126 that has the same attributes other than font-related ones.
128 Thus, all realized faces have a realized fontset.
133 Unibyte text (i.e. raw 8-bit characters) is displayed with the same
134 font as ASCII characters. That is because it is expected that
135 unibyte text users specify a font that is suitable both for ASCII
136 and raw 8-bit characters.
141 Font selection tries to find the best available matching font for a
142 given (character, face) combination.
144 If the face specifies a fontset name, that fontset determines a
145 pattern for fonts of the given character. If the face specifies a
146 font name or the other font-related attributes, a fontset is
147 realized from the default fontset. In that case, that
148 specification determines a pattern for ASCII characters and the
149 default fontset determines a pattern for multibyte characters.
151 Available fonts on the system on which Emacs runs are then matched
152 against the font pattern. The result of font selection is the best
153 match for the given face attributes in this font list.
155 Font selection can be influenced by the user.
157 1. The user can specify the relative importance he gives the face
158 attributes width, height, weight, and slant by setting
159 face-font-selection-order (faces.el) to a list of face attribute
160 names. The default is '(:width :height :weight :slant), and means
161 that font selection first tries to find a good match for the font
162 width specified by a face, then---within fonts with that
163 width---tries to find a best match for the specified font height,
166 2. Setting face-font-family-alternatives allows the user to
167 specify alternative font families to try if a family specified by a
170 3. Setting face-font-registry-alternatives allows the user to
171 specify all alternative font registries to try for a face
172 specifying a registry.
174 4. Setting face-ignored-fonts allows the user to ignore specific
178 Character composition.
180 Usually, the realization process is already finished when Emacs
181 actually reflects the desired glyph matrix on the screen. However,
182 on displaying a composition (sequence of characters to be composed
183 on the screen), a suitable font for the components of the
184 composition is selected and realized while drawing them on the
185 screen, i.e. the realization process is delayed but in principle
189 Initialization of basic faces.
191 The faces `default', `modeline' are considered `basic faces'.
192 When redisplay happens the first time for a newly created frame,
193 basic faces are realized for CHARSET_ASCII. Frame parameters are
194 used to fill in unspecified attributes of the default face. */
198 #include <sys/types.h>
199 #include <sys/stat.h>
202 #include "character.h"
204 #include "keyboard.h"
207 #ifdef HAVE_WINDOW_SYSTEM
209 #endif /* HAVE_WINDOW_SYSTEM */
211 #ifdef HAVE_X_WINDOWS
215 #include <Xm/XmStrDefs.h>
216 #endif /* USE_MOTIF */
217 #endif /* HAVE_X_WINDOWS */
226 /* Redefine X specifics to W32 equivalents to avoid cluttering the
227 code with #ifdef blocks. */
228 #undef FRAME_X_DISPLAY_INFO
229 #define FRAME_X_DISPLAY_INFO FRAME_W32_DISPLAY_INFO
230 #define x_display_info w32_display_info
231 #define FRAME_X_FONT_TABLE FRAME_W32_FONT_TABLE
232 #define check_x check_w32
233 #define x_list_fonts w32_list_fonts
234 #define GCGraphicsExposures 0
235 #endif /* WINDOWSNT */
239 #define x_display_info mac_display_info
240 #define check_x check_mac
244 #include "dispextern.h"
245 #include "blockinput.h"
247 #include "intervals.h"
249 #ifdef HAVE_WINDOW_SYSTEM
250 #ifdef USE_FONT_BACKEND
252 #endif /* USE_FONT_BACKEND */
253 #endif /* HAVE_WINDOW_SYSTEM */
255 #ifdef HAVE_X_WINDOWS
257 /* Compensate for a bug in Xos.h on some systems, on which it requires
258 time.h. On some such systems, Xos.h tries to redefine struct
259 timeval and struct timezone if USG is #defined while it is
262 #ifdef XOS_NEEDS_TIME_H
268 #else /* not XOS_NEEDS_TIME_H */
270 #endif /* not XOS_NEEDS_TIME_H */
272 #endif /* HAVE_X_WINDOWS */
276 #define abs(X) ((X) < 0 ? -(X) : (X))
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 /* Symbols used for attribute values. */
320 Lisp_Object Qnormal
, Qbold
, Qultra_light
, Qextra_light
, Qlight
;
321 Lisp_Object Qsemi_light
, Qsemi_bold
, Qextra_bold
, Qultra_bold
;
322 Lisp_Object Qoblique
, Qitalic
, Qreverse_oblique
, Qreverse_italic
;
323 Lisp_Object Qultra_condensed
, Qextra_condensed
, Qcondensed
;
324 Lisp_Object Qsemi_condensed
, Qsemi_expanded
, Qexpanded
, Qextra_expanded
;
325 Lisp_Object Qultra_expanded
;
326 Lisp_Object Qreleased_button
, Qpressed_button
;
327 Lisp_Object QCstyle
, QCcolor
, QCline_width
;
328 Lisp_Object Qunspecified
;
329 Lisp_Object Qignore_defface
;
331 char unspecified_fg
[] = "unspecified-fg", unspecified_bg
[] = "unspecified-bg";
333 /* The name of the function to call when the background of the frame
334 has changed, frame_set_background_mode. */
336 Lisp_Object Qframe_set_background_mode
;
338 /* Names of basic faces. */
340 Lisp_Object Qdefault
, Qtool_bar
, Qregion
, Qfringe
;
341 Lisp_Object Qheader_line
, Qscroll_bar
, Qcursor
, Qborder
, Qmouse
, Qmenu
;
342 Lisp_Object Qmode_line_inactive
, Qvertical_border
;
343 extern Lisp_Object Qmode_line
;
345 /* The symbol `face-alias'. A symbols having that property is an
346 alias for another face. Value of the property is the name of
349 Lisp_Object Qface_alias
;
351 extern Lisp_Object Qcircular_list
;
353 /* Default stipple pattern used on monochrome displays. This stipple
354 pattern is used on monochrome displays instead of shades of gray
355 for a face background color. See `set-face-stipple' for possible
356 values for this variable. */
358 Lisp_Object Vface_default_stipple
;
360 /* Alist of alternative font families. Each element is of the form
361 (FAMILY FAMILY1 FAMILY2 ...). If fonts of FAMILY can't be loaded,
362 try FAMILY1, then FAMILY2, ... */
364 Lisp_Object Vface_alternative_font_family_alist
;
366 /* Alist of alternative font registries. Each element is of the form
367 (REGISTRY REGISTRY1 REGISTRY2...). If fonts of REGISTRY can't be
368 loaded, try REGISTRY1, then REGISTRY2, ... */
370 Lisp_Object Vface_alternative_font_registry_alist
;
372 /* Allowed scalable fonts. A value of nil means don't allow any
373 scalable fonts. A value of t means allow the use of any scalable
374 font. Otherwise, value must be a list of regular expressions. A
375 font may be scaled if its name matches a regular expression in the
378 Lisp_Object Vscalable_fonts_allowed
, Qscalable_fonts_allowed
;
380 /* List of regular expressions that matches names of fonts to ignore. */
382 Lisp_Object Vface_ignored_fonts
;
384 /* Alist of font name patterns vs the rescaling factor. */
386 Lisp_Object Vface_font_rescale_alist
;
388 /* Maximum number of fonts to consider in font_list. If not an
389 integer > 0, DEFAULT_FONT_LIST_LIMIT is used instead. */
391 Lisp_Object Vfont_list_limit
;
392 #define DEFAULT_FONT_LIST_LIMIT 100
394 /* The symbols `foreground-color' and `background-color' which can be
395 used as part of a `face' property. This is for compatibility with
398 Lisp_Object Qforeground_color
, Qbackground_color
;
400 /* The symbols `face' and `mouse-face' used as text properties. */
403 extern Lisp_Object Qmouse_face
;
405 /* Property for basic faces which other faces cannot inherit. */
407 Lisp_Object Qface_no_inherit
;
409 /* Error symbol for wrong_type_argument in load_pixmap. */
411 Lisp_Object Qbitmap_spec_p
;
413 /* Alist of global face definitions. Each element is of the form
414 (FACE . LFACE) where FACE is a symbol naming a face and LFACE
415 is a Lisp vector of face attributes. These faces are used
416 to initialize faces for new frames. */
418 Lisp_Object Vface_new_frame_defaults
;
420 /* The next ID to assign to Lisp faces. */
422 static int next_lface_id
;
424 /* A vector mapping Lisp face Id's to face names. */
426 static Lisp_Object
*lface_id_to_name
;
427 static int lface_id_to_name_size
;
429 /* TTY color-related functions (defined in tty-colors.el). */
431 Lisp_Object Qtty_color_desc
, Qtty_color_by_index
, Qtty_color_standard_values
;
433 /* The name of the function used to compute colors on TTYs. */
435 Lisp_Object Qtty_color_alist
;
437 /* An alist of defined terminal colors and their RGB values. */
439 Lisp_Object Vtty_defined_color_alist
;
441 /* Counter for calls to clear_face_cache. If this counter reaches
442 CLEAR_FONT_TABLE_COUNT, and a frame has more than
443 CLEAR_FONT_TABLE_NFONTS load, unused fonts are freed. */
445 static int clear_font_table_count
;
446 #define CLEAR_FONT_TABLE_COUNT 100
447 #define CLEAR_FONT_TABLE_NFONTS 10
449 /* Non-zero means face attributes have been changed since the last
450 redisplay. Used in redisplay_internal. */
452 int face_change_count
;
454 /* Non-zero means don't display bold text if a face's foreground
455 and background colors are the inverse of the default colors of the
456 display. This is a kluge to suppress `bold black' foreground text
457 which is hard to read on an LCD monitor. */
459 int tty_suppress_bold_inverse_default_colors_p
;
461 /* A list of the form `((x . y))' used to avoid consing in
462 Finternal_set_lisp_face_attribute. */
464 static Lisp_Object Vparam_value_alist
;
466 /* The total number of colors currently allocated. */
469 static int ncolors_allocated
;
470 static int npixmaps_allocated
;
474 /* Non-zero means the definition of the `menu' face for new frames has
477 int menu_face_changed_default
;
480 /* Function prototypes. */
484 struct named_merge_point
;
486 static void map_tty_color
P_ ((struct frame
*, struct face
*,
487 enum lface_attribute_index
, int *));
488 static Lisp_Object resolve_face_name
P_ ((Lisp_Object
, int));
489 static int may_use_scalable_font_p
P_ ((const char *));
490 static void set_font_frame_param
P_ ((Lisp_Object
, Lisp_Object
));
491 static int better_font_p
P_ ((int *, struct font_name
*, struct font_name
*,
493 static int x_face_list_fonts
P_ ((struct frame
*, char *,
494 struct font_name
**, int, int));
495 static int font_scalable_p
P_ ((struct font_name
*));
496 static int get_lface_attributes
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*, int));
497 static int load_pixmap
P_ ((struct frame
*, Lisp_Object
, unsigned *, unsigned *));
498 static unsigned char *xstrlwr
P_ ((unsigned char *));
499 static struct frame
*frame_or_selected_frame
P_ ((Lisp_Object
, int));
500 static void load_face_font
P_ ((struct frame
*, struct face
*));
501 static void load_face_colors
P_ ((struct frame
*, struct face
*, Lisp_Object
*));
502 static void free_face_colors
P_ ((struct frame
*, struct face
*));
503 static int face_color_gray_p
P_ ((struct frame
*, char *));
504 static char *build_font_name
P_ ((struct font_name
*));
505 static void free_font_names
P_ ((struct font_name
*, int));
506 static int sorted_font_list
P_ ((struct frame
*, char *,
507 int (*cmpfn
) P_ ((const void *, const void *)),
508 struct font_name
**));
509 static int font_list_1
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
510 Lisp_Object
, struct font_name
**));
511 static int font_list
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
512 Lisp_Object
, struct font_name
**));
513 static int try_font_list
P_ ((struct frame
*, Lisp_Object
,
514 Lisp_Object
, Lisp_Object
, struct font_name
**));
515 static int try_alternative_families
P_ ((struct frame
*f
, Lisp_Object
,
516 Lisp_Object
, struct font_name
**));
517 static int cmp_font_names
P_ ((const void *, const void *));
518 static struct face
*realize_face
P_ ((struct face_cache
*, Lisp_Object
*,
520 static struct face
*realize_non_ascii_face
P_ ((struct frame
*, int,
522 static struct face
*realize_x_face
P_ ((struct face_cache
*, Lisp_Object
*));
523 static struct face
*realize_tty_face
P_ ((struct face_cache
*, Lisp_Object
*));
524 static int realize_basic_faces
P_ ((struct frame
*));
525 static int realize_default_face
P_ ((struct frame
*));
526 static void realize_named_face
P_ ((struct frame
*, Lisp_Object
, int));
527 static int lface_fully_specified_p
P_ ((Lisp_Object
*));
528 static int lface_equal_p
P_ ((Lisp_Object
*, Lisp_Object
*));
529 static unsigned hash_string_case_insensitive
P_ ((Lisp_Object
));
530 static unsigned lface_hash
P_ ((Lisp_Object
*));
531 static int lface_same_font_attributes_p
P_ ((Lisp_Object
*, Lisp_Object
*));
532 static struct face_cache
*make_face_cache
P_ ((struct frame
*));
533 static void clear_face_gcs
P_ ((struct face_cache
*));
534 static void free_face_cache
P_ ((struct face_cache
*));
535 static int face_numeric_weight
P_ ((Lisp_Object
));
536 static int face_numeric_slant
P_ ((Lisp_Object
));
537 static int face_numeric_swidth
P_ ((Lisp_Object
));
538 static int face_fontset
P_ ((Lisp_Object
*));
539 static void merge_face_vectors
P_ ((struct frame
*, Lisp_Object
*, Lisp_Object
*,
540 struct named_merge_point
*));
541 static int merge_face_ref
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*,
542 int, struct named_merge_point
*));
543 static int set_lface_from_font_name
P_ ((struct frame
*, Lisp_Object
,
544 Lisp_Object
, int, int));
545 static void set_lface_from_font_and_fontset
P_ ((struct frame
*, Lisp_Object
,
546 Lisp_Object
, int, int));
547 static Lisp_Object lface_from_face_name
P_ ((struct frame
*, Lisp_Object
, int));
548 static struct face
*make_realized_face
P_ ((Lisp_Object
*));
549 static char *best_matching_font
P_ ((struct frame
*, Lisp_Object
*,
550 struct font_name
*, int, int, int *));
551 static void cache_face
P_ ((struct face_cache
*, struct face
*, unsigned));
552 static void uncache_face
P_ ((struct face_cache
*, struct face
*));
553 static int xlfd_numeric_slant
P_ ((struct font_name
*));
554 static int xlfd_numeric_weight
P_ ((struct font_name
*));
555 static int xlfd_numeric_swidth
P_ ((struct font_name
*));
556 static Lisp_Object xlfd_symbolic_slant
P_ ((struct font_name
*));
557 static Lisp_Object xlfd_symbolic_weight
P_ ((struct font_name
*));
558 static Lisp_Object xlfd_symbolic_swidth
P_ ((struct font_name
*));
559 static int xlfd_fixed_p
P_ ((struct font_name
*));
560 static int xlfd_numeric_value
P_ ((struct table_entry
*, int, struct font_name
*,
562 static Lisp_Object xlfd_symbolic_value
P_ ((struct table_entry
*, int,
563 struct font_name
*, int,
565 static struct table_entry
*xlfd_lookup_field_contents
P_ ((struct table_entry
*, int,
566 struct font_name
*, int));
568 #ifdef HAVE_WINDOW_SYSTEM
570 static int split_font_name
P_ ((struct frame
*, struct font_name
*, int));
571 static int xlfd_point_size
P_ ((struct frame
*, struct font_name
*));
572 static void sort_fonts
P_ ((struct frame
*, struct font_name
*, int,
573 int (*cmpfn
) P_ ((const void *, const void *))));
574 static GC x_create_gc
P_ ((struct frame
*, unsigned long, XGCValues
*));
575 static void x_free_gc
P_ ((struct frame
*, GC
));
576 static void clear_font_table
P_ ((struct x_display_info
*));
579 extern Lisp_Object w32_list_fonts
P_ ((struct frame
*, Lisp_Object
, int, int));
580 #endif /* WINDOWSNT */
583 static void x_update_menu_appearance
P_ ((struct frame
*));
585 extern void free_frame_menubar
P_ ((struct frame
*));
586 #endif /* USE_X_TOOLKIT */
588 #endif /* HAVE_WINDOW_SYSTEM */
591 /***********************************************************************
593 ***********************************************************************/
595 #ifdef HAVE_X_WINDOWS
597 #ifdef DEBUG_X_COLORS
599 /* The following is a poor mans infrastructure for debugging X color
600 allocation problems on displays with PseudoColor-8. Some X servers
601 like 3.3.5 XF86_SVGA with Matrox cards apparently don't implement
602 color reference counts completely so that they don't signal an
603 error when a color is freed whose reference count is already 0.
604 Other X servers do. To help me debug this, the following code
605 implements a simple reference counting schema of its own, for a
606 single display/screen. --gerd. */
608 /* Reference counts for pixel colors. */
610 int color_count
[256];
612 /* Register color PIXEL as allocated. */
615 register_color (pixel
)
618 xassert (pixel
< 256);
619 ++color_count
[pixel
];
623 /* Register color PIXEL as deallocated. */
626 unregister_color (pixel
)
629 xassert (pixel
< 256);
630 if (color_count
[pixel
] > 0)
631 --color_count
[pixel
];
637 /* Register N colors from PIXELS as deallocated. */
640 unregister_colors (pixels
, n
)
641 unsigned long *pixels
;
645 for (i
= 0; i
< n
; ++i
)
646 unregister_color (pixels
[i
]);
650 DEFUN ("dump-colors", Fdump_colors
, Sdump_colors
, 0, 0, 0,
651 doc
: /* Dump currently allocated colors to stderr. */)
656 fputc ('\n', stderr
);
658 for (i
= n
= 0; i
< sizeof color_count
/ sizeof color_count
[0]; ++i
)
661 fprintf (stderr
, "%3d: %5d", i
, color_count
[i
]);
664 fputc ('\n', stderr
);
666 fputc ('\t', stderr
);
670 fputc ('\n', stderr
);
674 #endif /* DEBUG_X_COLORS */
677 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
678 color values. Interrupt input must be blocked when this function
682 x_free_colors (f
, pixels
, npixels
)
684 unsigned long *pixels
;
687 int class = FRAME_X_DISPLAY_INFO (f
)->visual
->class;
689 /* If display has an immutable color map, freeing colors is not
690 necessary and some servers don't allow it. So don't do it. */
691 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
693 #ifdef DEBUG_X_COLORS
694 unregister_colors (pixels
, npixels
);
696 XFreeColors (FRAME_X_DISPLAY (f
), FRAME_X_COLORMAP (f
),
702 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
703 color values. Interrupt input must be blocked when this function
707 x_free_dpy_colors (dpy
, screen
, cmap
, pixels
, npixels
)
711 unsigned long *pixels
;
714 struct x_display_info
*dpyinfo
= x_display_info_for_display (dpy
);
715 int class = dpyinfo
->visual
->class;
717 /* If display has an immutable color map, freeing colors is not
718 necessary and some servers don't allow it. So don't do it. */
719 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
721 #ifdef DEBUG_X_COLORS
722 unregister_colors (pixels
, npixels
);
724 XFreeColors (dpy
, cmap
, pixels
, npixels
, 0);
729 /* Create and return a GC for use on frame F. GC values and mask
730 are given by XGCV and MASK. */
733 x_create_gc (f
, mask
, xgcv
)
740 gc
= XCreateGC (FRAME_X_DISPLAY (f
), FRAME_X_WINDOW (f
), mask
, xgcv
);
747 /* Free GC which was used on frame F. */
755 IF_DEBUG (xassert (--ngcs
>= 0));
756 XFreeGC (FRAME_X_DISPLAY (f
), gc
);
760 #endif /* HAVE_X_WINDOWS */
763 /* W32 emulation of GCs */
766 x_create_gc (f
, mask
, xgcv
)
773 gc
= XCreateGC (NULL
, FRAME_W32_WINDOW (f
), mask
, xgcv
);
780 /* Free GC which was used on frame F. */
788 IF_DEBUG (xassert (--ngcs
>= 0));
793 #endif /* WINDOWSNT */
796 /* Mac OS emulation of GCs */
799 x_create_gc (f
, mask
, xgcv
)
806 gc
= XCreateGC (FRAME_MAC_DISPLAY (f
), FRAME_MAC_WINDOW (f
), mask
, xgcv
);
818 IF_DEBUG (xassert (--ngcs
>= 0));
819 XFreeGC (FRAME_MAC_DISPLAY (f
), gc
);
825 /* Like stricmp. Used to compare parts of font names which are in
830 const unsigned char *s1
, *s2
;
834 unsigned char c1
= tolower (*s1
);
835 unsigned char c2
= tolower (*s2
);
837 return c1
< c2
? -1 : 1;
842 return *s2
== 0 ? 0 : -1;
847 /* Like strlwr, which might not always be available. */
849 static unsigned char *
853 unsigned char *p
= s
;
856 /* On Mac OS X 10.3, tolower also converts non-ASCII characters
865 /* If FRAME is nil, return a pointer to the selected frame.
866 Otherwise, check that FRAME is a live frame, and return a pointer
867 to it. NPARAM is the parameter number of FRAME, for
868 CHECK_LIVE_FRAME. This is here because it's a frequent pattern in
869 Lisp function definitions. */
871 static INLINE
struct frame
*
872 frame_or_selected_frame (frame
, nparam
)
877 frame
= selected_frame
;
879 CHECK_LIVE_FRAME (frame
);
880 return XFRAME (frame
);
884 /***********************************************************************
886 ***********************************************************************/
888 /* Initialize face cache and basic faces for frame F. */
894 /* Make a face cache, if F doesn't have one. */
895 if (FRAME_FACE_CACHE (f
) == NULL
)
896 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
898 #ifdef HAVE_WINDOW_SYSTEM
899 /* Make the image cache. */
900 if (FRAME_WINDOW_P (f
))
902 if (FRAME_X_IMAGE_CACHE (f
) == NULL
)
903 FRAME_X_IMAGE_CACHE (f
) = make_image_cache ();
904 ++FRAME_X_IMAGE_CACHE (f
)->refcount
;
906 #endif /* HAVE_WINDOW_SYSTEM */
908 /* Realize basic faces. Must have enough information in frame
909 parameters to realize basic faces at this point. */
910 #ifdef HAVE_X_WINDOWS
911 if (!FRAME_X_P (f
) || FRAME_X_WINDOW (f
))
914 if (!FRAME_WINDOW_P (f
) || FRAME_W32_WINDOW (f
))
917 if (!FRAME_MAC_P (f
) || FRAME_MAC_WINDOW (f
))
919 if (!realize_basic_faces (f
))
924 /* Free face cache of frame F. Called from Fdelete_frame. */
930 struct face_cache
*face_cache
= FRAME_FACE_CACHE (f
);
934 free_face_cache (face_cache
);
935 FRAME_FACE_CACHE (f
) = NULL
;
938 #ifdef HAVE_WINDOW_SYSTEM
939 if (FRAME_WINDOW_P (f
))
941 struct image_cache
*image_cache
= FRAME_X_IMAGE_CACHE (f
);
944 --image_cache
->refcount
;
945 if (image_cache
->refcount
== 0)
946 free_image_cache (f
);
949 #endif /* HAVE_WINDOW_SYSTEM */
953 /* Clear face caches, and recompute basic faces for frame F. Call
954 this after changing frame parameters on which those faces depend,
955 or when realized faces have been freed due to changing attributes
959 recompute_basic_faces (f
)
962 if (FRAME_FACE_CACHE (f
))
964 clear_face_cache (0);
965 if (!realize_basic_faces (f
))
971 /* Clear the face caches of all frames. CLEAR_FONTS_P non-zero means
972 try to free unused fonts, too. */
975 clear_face_cache (clear_fonts_p
)
978 #ifdef HAVE_WINDOW_SYSTEM
979 Lisp_Object tail
, frame
;
983 || ++clear_font_table_count
== CLEAR_FONT_TABLE_COUNT
)
985 struct x_display_info
*dpyinfo
;
987 #ifdef USE_FONT_BACKEND
988 if (! enable_font_backend
)
989 #endif /* USE_FONT_BACKEND */
990 /* Fonts are common for frames on one display, i.e. on
992 for (dpyinfo
= x_display_list
; dpyinfo
; dpyinfo
= dpyinfo
->next
)
993 if (dpyinfo
->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
994 clear_font_table (dpyinfo
);
996 /* From time to time see if we can unload some fonts. This also
997 frees all realized faces on all frames. Fonts needed by
998 faces will be loaded again when faces are realized again. */
999 clear_font_table_count
= 0;
1001 FOR_EACH_FRAME (tail
, frame
)
1003 struct frame
*f
= XFRAME (frame
);
1004 if (FRAME_WINDOW_P (f
)
1005 && FRAME_X_DISPLAY_INFO (f
)->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
1006 free_all_realized_faces (frame
);
1011 /* Clear GCs of realized faces. */
1012 FOR_EACH_FRAME (tail
, frame
)
1015 if (FRAME_WINDOW_P (f
))
1017 clear_face_gcs (FRAME_FACE_CACHE (f
));
1018 clear_image_cache (f
, 0);
1022 #endif /* HAVE_WINDOW_SYSTEM */
1026 DEFUN ("clear-face-cache", Fclear_face_cache
, Sclear_face_cache
, 0, 1, 0,
1027 doc
: /* Clear face caches on all frames.
1028 Optional THOROUGHLY non-nil means try to free unused fonts, too. */)
1030 Lisp_Object thoroughly
;
1032 clear_face_cache (!NILP (thoroughly
));
1033 ++face_change_count
;
1034 ++windows_or_buffers_changed
;
1040 #ifdef HAVE_WINDOW_SYSTEM
1043 /* Remove fonts from the font table of DPYINFO except for the default
1044 ASCII fonts of frames on that display. Called from clear_face_cache
1045 from time to time. */
1048 clear_font_table (dpyinfo
)
1049 struct x_display_info
*dpyinfo
;
1053 /* Free those fonts that are not used by frames on DPYINFO. */
1054 for (i
= 0; i
< dpyinfo
->n_fonts
; ++i
)
1056 struct font_info
*font_info
= dpyinfo
->font_table
+ i
;
1057 Lisp_Object tail
, frame
;
1059 /* Check if slot is already free. */
1060 if (font_info
->name
== NULL
)
1063 /* Don't free a default font of some frame. */
1064 FOR_EACH_FRAME (tail
, frame
)
1066 struct frame
*f
= XFRAME (frame
);
1067 if (FRAME_WINDOW_P (f
)
1068 && font_info
->font
== FRAME_FONT (f
))
1076 if (font_info
->full_name
!= font_info
->name
)
1077 xfree (font_info
->full_name
);
1078 xfree (font_info
->name
);
1080 /* Free the font. */
1082 #ifdef HAVE_X_WINDOWS
1083 XFreeFont (dpyinfo
->display
, font_info
->font
);
1086 w32_unload_font (dpyinfo
, font_info
->font
);
1089 mac_unload_font (dpyinfo
, font_info
->font
);
1093 /* Mark font table slot free. */
1094 font_info
->font
= NULL
;
1095 font_info
->name
= font_info
->full_name
= NULL
;
1099 #endif /* HAVE_WINDOW_SYSTEM */
1103 /***********************************************************************
1105 ***********************************************************************/
1107 #ifdef HAVE_WINDOW_SYSTEM
1109 DEFUN ("bitmap-spec-p", Fbitmap_spec_p
, Sbitmap_spec_p
, 1, 1, 0,
1110 doc
: /* Value is non-nil if OBJECT is a valid bitmap specification.
1111 A bitmap specification is either a string, a file name, or a list
1112 \(WIDTH HEIGHT DATA) where WIDTH is the pixel width of the bitmap,
1113 HEIGHT is its height, and DATA is a string containing the bits of
1114 the pixmap. Bits are stored row by row, each row occupies
1115 \(WIDTH + 7)/8 bytes. */)
1121 if (STRINGP (object
))
1122 /* If OBJECT is a string, it's a file name. */
1124 else if (CONSP (object
))
1126 /* Otherwise OBJECT must be (WIDTH HEIGHT DATA), WIDTH and
1127 HEIGHT must be integers > 0, and DATA must be string large
1128 enough to hold a bitmap of the specified size. */
1129 Lisp_Object width
, height
, data
;
1131 height
= width
= data
= Qnil
;
1135 width
= XCAR (object
);
1136 object
= XCDR (object
);
1139 height
= XCAR (object
);
1140 object
= XCDR (object
);
1142 data
= XCAR (object
);
1146 if (NATNUMP (width
) && NATNUMP (height
) && STRINGP (data
))
1148 int bytes_per_row
= ((XFASTINT (width
) + BITS_PER_CHAR
- 1)
1150 if (SBYTES (data
) >= bytes_per_row
* XINT (height
))
1155 return pixmap_p
? Qt
: Qnil
;
1159 /* Load a bitmap according to NAME (which is either a file name or a
1160 pixmap spec) for use on frame F. Value is the bitmap_id (see
1161 xfns.c). If NAME is nil, return with a bitmap id of zero. If
1162 bitmap cannot be loaded, display a message saying so, and return
1163 zero. Store the bitmap width in *W_PTR and its height in *H_PTR,
1164 if these pointers are not null. */
1167 load_pixmap (f
, name
, w_ptr
, h_ptr
)
1170 unsigned int *w_ptr
, *h_ptr
;
1177 CHECK_TYPE (!NILP (Fbitmap_spec_p (name
)), Qbitmap_spec_p
, name
);
1182 /* Decode a bitmap spec into a bitmap. */
1187 w
= XINT (Fcar (name
));
1188 h
= XINT (Fcar (Fcdr (name
)));
1189 bits
= Fcar (Fcdr (Fcdr (name
)));
1191 bitmap_id
= x_create_bitmap_from_data (f
, SDATA (bits
),
1196 /* It must be a string -- a file name. */
1197 bitmap_id
= x_create_bitmap_from_file (f
, name
);
1203 add_to_log ("Invalid or undefined bitmap `%s'", name
, Qnil
);
1214 ++npixmaps_allocated
;
1217 *w_ptr
= x_bitmap_width (f
, bitmap_id
);
1220 *h_ptr
= x_bitmap_height (f
, bitmap_id
);
1226 #endif /* HAVE_WINDOW_SYSTEM */
1230 /***********************************************************************
1232 ***********************************************************************/
1234 #ifdef HAVE_WINDOW_SYSTEM
1236 /* Load font of face FACE which is used on frame F to display ASCII
1237 characters. The name of the font to load is determined by lface. */
1240 load_face_font (f
, face
)
1244 struct font_info
*font_info
= NULL
;
1246 int needs_overstrike
;
1248 #ifdef USE_FONT_BACKEND
1249 if (enable_font_backend
)
1251 #endif /* USE_FONT_BACKEND */
1252 face
->font_info_id
= -1;
1254 face
->font_name
= NULL
;
1256 font_name
= choose_face_font (f
, face
->lface
, Qnil
, &needs_overstrike
);
1261 font_info
= FS_LOAD_FONT (f
, font_name
);
1266 face
->font_info_id
= font_info
->font_idx
;
1267 face
->font
= font_info
->font
;
1268 face
->font_name
= font_info
->full_name
;
1269 face
->overstrike
= needs_overstrike
;
1272 x_free_gc (f
, face
->gc
);
1277 add_to_log ("Unable to load font %s",
1278 build_string (font_name
), Qnil
);
1282 #endif /* HAVE_WINDOW_SYSTEM */
1286 /***********************************************************************
1288 ***********************************************************************/
1290 /* Parse RGB_LIST, and fill in the RGB fields of COLOR.
1291 RGB_LIST should contain (at least) 3 lisp integers.
1292 Return 0 if there's a problem with RGB_LIST, otherwise return 1. */
1295 parse_rgb_list (rgb_list
, color
)
1296 Lisp_Object rgb_list
;
1299 #define PARSE_RGB_LIST_FIELD(field) \
1300 if (CONSP (rgb_list) && INTEGERP (XCAR (rgb_list))) \
1302 color->field = XINT (XCAR (rgb_list)); \
1303 rgb_list = XCDR (rgb_list); \
1308 PARSE_RGB_LIST_FIELD (red
);
1309 PARSE_RGB_LIST_FIELD (green
);
1310 PARSE_RGB_LIST_FIELD (blue
);
1316 /* Lookup on frame F the color described by the lisp string COLOR.
1317 The resulting tty color is returned in TTY_COLOR; if STD_COLOR is
1318 non-zero, then the `standard' definition of the same color is
1322 tty_lookup_color (f
, color
, tty_color
, std_color
)
1325 XColor
*tty_color
, *std_color
;
1327 Lisp_Object frame
, color_desc
;
1329 if (!STRINGP (color
) || NILP (Ffboundp (Qtty_color_desc
)))
1332 XSETFRAME (frame
, f
);
1334 color_desc
= call2 (Qtty_color_desc
, color
, frame
);
1335 if (CONSP (color_desc
) && CONSP (XCDR (color_desc
)))
1339 if (! INTEGERP (XCAR (XCDR (color_desc
))))
1342 tty_color
->pixel
= XINT (XCAR (XCDR (color_desc
)));
1344 rgb
= XCDR (XCDR (color_desc
));
1345 if (! parse_rgb_list (rgb
, tty_color
))
1348 /* Should we fill in STD_COLOR too? */
1351 /* Default STD_COLOR to the same as TTY_COLOR. */
1352 *std_color
= *tty_color
;
1354 /* Do a quick check to see if the returned descriptor is
1355 actually _exactly_ equal to COLOR, otherwise we have to
1356 lookup STD_COLOR separately. If it's impossible to lookup
1357 a standard color, we just give up and use TTY_COLOR. */
1358 if ((!STRINGP (XCAR (color_desc
))
1359 || NILP (Fstring_equal (color
, XCAR (color_desc
))))
1360 && !NILP (Ffboundp (Qtty_color_standard_values
)))
1362 /* Look up STD_COLOR separately. */
1363 rgb
= call1 (Qtty_color_standard_values
, color
);
1364 if (! parse_rgb_list (rgb
, std_color
))
1371 else if (NILP (Fsymbol_value (intern ("tty-defined-color-alist"))))
1372 /* We were called early during startup, and the colors are not
1373 yet set up in tty-defined-color-alist. Don't return a failure
1374 indication, since this produces the annoying "Unable to
1375 load color" messages in the *Messages* buffer. */
1378 /* tty-color-desc seems to have returned a bad value. */
1382 /* A version of defined_color for non-X frames. */
1385 tty_defined_color (f
, color_name
, color_def
, alloc
)
1394 color_def
->pixel
= FACE_TTY_DEFAULT_COLOR
;
1396 color_def
->blue
= 0;
1397 color_def
->green
= 0;
1400 status
= tty_lookup_color (f
, build_string (color_name
), color_def
, NULL
);
1402 if (color_def
->pixel
== FACE_TTY_DEFAULT_COLOR
&& *color_name
)
1404 if (strcmp (color_name
, "unspecified-fg") == 0)
1405 color_def
->pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
1406 else if (strcmp (color_name
, "unspecified-bg") == 0)
1407 color_def
->pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
1410 if (color_def
->pixel
!= FACE_TTY_DEFAULT_COLOR
)
1417 /* Decide if color named COLOR_NAME is valid for the display
1418 associated with the frame F; if so, return the rgb values in
1419 COLOR_DEF. If ALLOC is nonzero, allocate a new colormap cell.
1421 This does the right thing for any type of frame. */
1424 defined_color (f
, color_name
, color_def
, alloc
)
1430 if (!FRAME_WINDOW_P (f
))
1431 return tty_defined_color (f
, color_name
, color_def
, alloc
);
1432 #ifdef HAVE_X_WINDOWS
1433 else if (FRAME_X_P (f
))
1434 return x_defined_color (f
, color_name
, color_def
, alloc
);
1437 else if (FRAME_W32_P (f
))
1438 return w32_defined_color (f
, color_name
, color_def
, alloc
);
1441 else if (FRAME_MAC_P (f
))
1442 return mac_defined_color (f
, color_name
, color_def
, alloc
);
1449 /* Given the index IDX of a tty color on frame F, return its name, a
1453 tty_color_name (f
, idx
)
1457 if (idx
>= 0 && !NILP (Ffboundp (Qtty_color_by_index
)))
1460 Lisp_Object coldesc
;
1462 XSETFRAME (frame
, f
);
1463 coldesc
= call2 (Qtty_color_by_index
, make_number (idx
), frame
);
1465 if (!NILP (coldesc
))
1466 return XCAR (coldesc
);
1469 /* We can have an MSDOG frame under -nw for a short window of
1470 opportunity before internal_terminal_init is called. DTRT. */
1471 if (FRAME_MSDOS_P (f
) && !inhibit_window_system
)
1472 return msdos_stdcolor_name (idx
);
1475 if (idx
== FACE_TTY_DEFAULT_FG_COLOR
)
1476 return build_string (unspecified_fg
);
1477 if (idx
== FACE_TTY_DEFAULT_BG_COLOR
)
1478 return build_string (unspecified_bg
);
1481 return vga_stdcolor_name (idx
);
1484 return Qunspecified
;
1488 /* Return non-zero if COLOR_NAME is a shade of gray (or white or
1491 The criterion implemented here is not a terribly sophisticated one. */
1494 face_color_gray_p (f
, color_name
)
1501 if (defined_color (f
, color_name
, &color
, 0))
1502 gray_p
= (/* Any color sufficiently close to black counts as grey. */
1503 (color
.red
< 5000 && color
.green
< 5000 && color
.blue
< 5000)
1505 ((abs (color
.red
- color
.green
)
1506 < max (color
.red
, color
.green
) / 20)
1507 && (abs (color
.green
- color
.blue
)
1508 < max (color
.green
, color
.blue
) / 20)
1509 && (abs (color
.blue
- color
.red
)
1510 < max (color
.blue
, color
.red
) / 20)));
1518 /* Return non-zero if color COLOR_NAME can be displayed on frame F.
1519 BACKGROUND_P non-zero means the color will be used as background
1523 face_color_supported_p (f
, color_name
, background_p
)
1531 XSETFRAME (frame
, f
);
1533 #ifdef HAVE_WINDOW_SYSTEM
1535 ? (!NILP (Fxw_display_color_p (frame
))
1536 || xstricmp (color_name
, "black") == 0
1537 || xstricmp (color_name
, "white") == 0
1539 && face_color_gray_p (f
, color_name
))
1540 || (!NILP (Fx_display_grayscale_p (frame
))
1541 && face_color_gray_p (f
, color_name
)))
1544 tty_defined_color (f
, color_name
, ¬_used
, 0);
1548 DEFUN ("color-gray-p", Fcolor_gray_p
, Scolor_gray_p
, 1, 2, 0,
1549 doc
: /* Return non-nil if COLOR is a shade of gray (or white or black).
1550 FRAME specifies the frame and thus the display for interpreting COLOR.
1551 If FRAME is nil or omitted, use the selected frame. */)
1553 Lisp_Object color
, frame
;
1557 CHECK_STRING (color
);
1559 frame
= selected_frame
;
1561 CHECK_FRAME (frame
);
1563 return face_color_gray_p (f
, SDATA (color
)) ? Qt
: Qnil
;
1567 DEFUN ("color-supported-p", Fcolor_supported_p
,
1568 Scolor_supported_p
, 1, 3, 0,
1569 doc
: /* Return non-nil if COLOR can be displayed on FRAME.
1570 BACKGROUND-P non-nil means COLOR is used as a background.
1571 Otherwise, this function tells whether it can be used as a foreground.
1572 If FRAME is nil or omitted, use the selected frame.
1573 COLOR must be a valid color name. */)
1574 (color
, frame
, background_p
)
1575 Lisp_Object frame
, color
, background_p
;
1579 CHECK_STRING (color
);
1581 frame
= selected_frame
;
1583 CHECK_FRAME (frame
);
1585 if (face_color_supported_p (f
, SDATA (color
), !NILP (background_p
)))
1591 /* Load color with name NAME for use by face FACE on frame F.
1592 TARGET_INDEX must be one of LFACE_FOREGROUND_INDEX,
1593 LFACE_BACKGROUND_INDEX, LFACE_UNDERLINE_INDEX, LFACE_OVERLINE_INDEX,
1594 LFACE_STRIKE_THROUGH_INDEX, or LFACE_BOX_INDEX. Value is the
1595 pixel color. If color cannot be loaded, display a message, and
1596 return the foreground, background or underline color of F, but
1597 record that fact in flags of the face so that we don't try to free
1601 load_color (f
, face
, name
, target_index
)
1605 enum lface_attribute_index target_index
;
1609 xassert (STRINGP (name
));
1610 xassert (target_index
== LFACE_FOREGROUND_INDEX
1611 || target_index
== LFACE_BACKGROUND_INDEX
1612 || target_index
== LFACE_UNDERLINE_INDEX
1613 || target_index
== LFACE_OVERLINE_INDEX
1614 || target_index
== LFACE_STRIKE_THROUGH_INDEX
1615 || target_index
== LFACE_BOX_INDEX
);
1617 /* if the color map is full, defined_color will return a best match
1618 to the values in an existing cell. */
1619 if (!defined_color (f
, SDATA (name
), &color
, 1))
1621 add_to_log ("Unable to load color \"%s\"", name
, Qnil
);
1623 switch (target_index
)
1625 case LFACE_FOREGROUND_INDEX
:
1626 face
->foreground_defaulted_p
= 1;
1627 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1630 case LFACE_BACKGROUND_INDEX
:
1631 face
->background_defaulted_p
= 1;
1632 color
.pixel
= FRAME_BACKGROUND_PIXEL (f
);
1635 case LFACE_UNDERLINE_INDEX
:
1636 face
->underline_defaulted_p
= 1;
1637 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1640 case LFACE_OVERLINE_INDEX
:
1641 face
->overline_color_defaulted_p
= 1;
1642 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1645 case LFACE_STRIKE_THROUGH_INDEX
:
1646 face
->strike_through_color_defaulted_p
= 1;
1647 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1650 case LFACE_BOX_INDEX
:
1651 face
->box_color_defaulted_p
= 1;
1652 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1661 ++ncolors_allocated
;
1668 #ifdef HAVE_WINDOW_SYSTEM
1670 /* Load colors for face FACE which is used on frame F. Colors are
1671 specified by slots LFACE_BACKGROUND_INDEX and LFACE_FOREGROUND_INDEX
1672 of ATTRS. If the background color specified is not supported on F,
1673 try to emulate gray colors with a stipple from Vface_default_stipple. */
1676 load_face_colors (f
, face
, attrs
)
1683 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
1684 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
1686 /* Swap colors if face is inverse-video. */
1687 if (EQ (attrs
[LFACE_INVERSE_INDEX
], Qt
))
1695 /* Check for support for foreground, not for background because
1696 face_color_supported_p is smart enough to know that grays are
1697 "supported" as background because we are supposed to use stipple
1699 if (!face_color_supported_p (f
, SDATA (bg
), 0)
1700 && !NILP (Fbitmap_spec_p (Vface_default_stipple
)))
1702 x_destroy_bitmap (f
, face
->stipple
);
1703 face
->stipple
= load_pixmap (f
, Vface_default_stipple
,
1704 &face
->pixmap_w
, &face
->pixmap_h
);
1707 face
->background
= load_color (f
, face
, bg
, LFACE_BACKGROUND_INDEX
);
1708 face
->foreground
= load_color (f
, face
, fg
, LFACE_FOREGROUND_INDEX
);
1712 /* Free color PIXEL on frame F. */
1715 unload_color (f
, pixel
)
1717 unsigned long pixel
;
1719 #ifdef HAVE_X_WINDOWS
1723 x_free_colors (f
, &pixel
, 1);
1730 /* Free colors allocated for FACE. */
1733 free_face_colors (f
, face
)
1737 #ifdef HAVE_X_WINDOWS
1738 if (face
->colors_copied_bitwise_p
)
1743 if (!face
->foreground_defaulted_p
)
1745 x_free_colors (f
, &face
->foreground
, 1);
1746 IF_DEBUG (--ncolors_allocated
);
1749 if (!face
->background_defaulted_p
)
1751 x_free_colors (f
, &face
->background
, 1);
1752 IF_DEBUG (--ncolors_allocated
);
1755 if (face
->underline_p
1756 && !face
->underline_defaulted_p
)
1758 x_free_colors (f
, &face
->underline_color
, 1);
1759 IF_DEBUG (--ncolors_allocated
);
1762 if (face
->overline_p
1763 && !face
->overline_color_defaulted_p
)
1765 x_free_colors (f
, &face
->overline_color
, 1);
1766 IF_DEBUG (--ncolors_allocated
);
1769 if (face
->strike_through_p
1770 && !face
->strike_through_color_defaulted_p
)
1772 x_free_colors (f
, &face
->strike_through_color
, 1);
1773 IF_DEBUG (--ncolors_allocated
);
1776 if (face
->box
!= FACE_NO_BOX
1777 && !face
->box_color_defaulted_p
)
1779 x_free_colors (f
, &face
->box_color
, 1);
1780 IF_DEBUG (--ncolors_allocated
);
1784 #endif /* HAVE_X_WINDOWS */
1787 #endif /* HAVE_WINDOW_SYSTEM */
1791 /***********************************************************************
1793 ***********************************************************************/
1795 /* An enumerator for each field of an XLFD font name. */
1816 /* An enumerator for each possible slant value of a font. Taken from
1817 the XLFD specification. */
1825 XLFD_SLANT_REVERSE_ITALIC
,
1826 XLFD_SLANT_REVERSE_OBLIQUE
,
1830 /* Relative font weight according to XLFD documentation. */
1834 XLFD_WEIGHT_UNKNOWN
,
1835 XLFD_WEIGHT_ULTRA_LIGHT
, /* 10 */
1836 XLFD_WEIGHT_EXTRA_LIGHT
, /* 20 */
1837 XLFD_WEIGHT_LIGHT
, /* 30 */
1838 XLFD_WEIGHT_SEMI_LIGHT
, /* 40: SemiLight, Book, ... */
1839 XLFD_WEIGHT_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1840 XLFD_WEIGHT_SEMI_BOLD
, /* 60: SemiBold, DemiBold, ... */
1841 XLFD_WEIGHT_BOLD
, /* 70: Bold, ... */
1842 XLFD_WEIGHT_EXTRA_BOLD
, /* 80: ExtraBold, Heavy, ... */
1843 XLFD_WEIGHT_ULTRA_BOLD
/* 90: UltraBold, Black, ... */
1846 /* Relative proportionate width. */
1850 XLFD_SWIDTH_UNKNOWN
,
1851 XLFD_SWIDTH_ULTRA_CONDENSED
, /* 10 */
1852 XLFD_SWIDTH_EXTRA_CONDENSED
, /* 20 */
1853 XLFD_SWIDTH_CONDENSED
, /* 30: Condensed, Narrow, Compressed, ... */
1854 XLFD_SWIDTH_SEMI_CONDENSED
, /* 40: semicondensed */
1855 XLFD_SWIDTH_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1856 XLFD_SWIDTH_SEMI_EXPANDED
, /* 60: SemiExpanded, DemiExpanded, ... */
1857 XLFD_SWIDTH_EXPANDED
, /* 70: Expanded... */
1858 XLFD_SWIDTH_EXTRA_EXPANDED
, /* 80: ExtraExpanded, Wide... */
1859 XLFD_SWIDTH_ULTRA_EXPANDED
/* 90: UltraExpanded... */
1862 /* Structure used for tables mapping XLFD weight, slant, and width
1863 names to numeric and symbolic values. */
1869 Lisp_Object
*symbol
;
1872 /* Table of XLFD slant names and their numeric and symbolic
1873 representations. This table must be sorted by slant names in
1876 static struct table_entry slant_table
[] =
1878 {"i", XLFD_SLANT_ITALIC
, &Qitalic
},
1879 {"o", XLFD_SLANT_OBLIQUE
, &Qoblique
},
1880 {"ot", XLFD_SLANT_OTHER
, &Qitalic
},
1881 {"r", XLFD_SLANT_ROMAN
, &Qnormal
},
1882 {"ri", XLFD_SLANT_REVERSE_ITALIC
, &Qreverse_italic
},
1883 {"ro", XLFD_SLANT_REVERSE_OBLIQUE
, &Qreverse_oblique
}
1886 /* Table of XLFD weight names. This table must be sorted by weight
1887 names in ascending order. */
1889 static struct table_entry weight_table
[] =
1891 {"black", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
},
1892 {"bold", XLFD_WEIGHT_BOLD
, &Qbold
},
1893 {"book", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1894 {"demi", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1895 {"demibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1896 {"extralight", XLFD_WEIGHT_EXTRA_LIGHT
, &Qextra_light
},
1897 {"extrabold", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1898 {"heavy", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1899 {"light", XLFD_WEIGHT_LIGHT
, &Qlight
},
1900 {"medium", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1901 {"normal", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1902 {"regular", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1903 {"semibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1904 {"semilight", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1905 {"ultralight", XLFD_WEIGHT_ULTRA_LIGHT
, &Qultra_light
},
1906 {"ultrabold", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
}
1909 /* Table of XLFD width names. This table must be sorted by width
1910 names in ascending order. */
1912 static struct table_entry swidth_table
[] =
1914 {"compressed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1915 {"condensed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1916 {"demiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1917 {"expanded", XLFD_SWIDTH_EXPANDED
, &Qexpanded
},
1918 {"extracondensed", XLFD_SWIDTH_EXTRA_CONDENSED
, &Qextra_condensed
},
1919 {"extraexpanded", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
},
1920 {"medium", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1921 {"narrow", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1922 {"normal", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1923 {"regular", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1924 {"semicondensed", XLFD_SWIDTH_SEMI_CONDENSED
, &Qsemi_condensed
},
1925 {"semiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1926 {"ultracondensed", XLFD_SWIDTH_ULTRA_CONDENSED
, &Qultra_condensed
},
1927 {"ultraexpanded", XLFD_SWIDTH_ULTRA_EXPANDED
, &Qultra_expanded
},
1928 {"wide", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
}
1931 /* Structure used to hold the result of splitting font names in XLFD
1932 format into their fields. */
1936 /* The original name which is modified destructively by
1937 split_font_name. The pointer is kept here to be able to free it
1938 if it was allocated from the heap. */
1941 /* Font name fields. Each vector element points into `name' above.
1942 Fields are NUL-terminated. */
1943 char *fields
[XLFD_LAST
];
1945 /* Numeric values for those fields that interest us. See
1946 split_font_name for which these are. */
1947 int numeric
[XLFD_LAST
];
1949 /* If the original name matches one of Vface_font_rescale_alist,
1950 the value is the corresponding rescale ratio. Otherwise, the
1952 double rescale_ratio
;
1954 /* Lower value mean higher priority. */
1955 int registry_priority
;
1958 /* The frame in effect when sorting font names. Set temporarily in
1959 sort_fonts so that it is available in font comparison functions. */
1961 static struct frame
*font_frame
;
1963 /* Order by which font selection chooses fonts. The default values
1964 mean `first, find a best match for the font width, then for the
1965 font height, then for weight, then for slant.' This variable can be
1966 set via set-face-font-sort-order. */
1969 static int font_sort_order
[4] = {
1970 XLFD_SWIDTH
, XLFD_POINT_SIZE
, XLFD_WEIGHT
, XLFD_SLANT
1973 static int font_sort_order
[4];
1976 /* Look up FONT.fields[FIELD_INDEX] in TABLE which has DIM entries.
1977 TABLE must be sorted by TABLE[i]->name in ascending order. Value
1978 is a pointer to the matching table entry or null if no table entry
1981 static struct table_entry
*
1982 xlfd_lookup_field_contents (table
, dim
, font
, field_index
)
1983 struct table_entry
*table
;
1985 struct font_name
*font
;
1988 /* Function split_font_name converts fields to lower-case, so there
1989 is no need to use xstrlwr or xstricmp here. */
1990 char *s
= font
->fields
[field_index
];
1991 int low
, mid
, high
, cmp
;
1998 mid
= (low
+ high
) / 2;
1999 cmp
= strcmp (table
[mid
].name
, s
);
2013 /* Return a numeric representation for font name field
2014 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
2015 has DIM entries. Value is the numeric value found or DFLT if no
2016 table entry matches. This function is used to translate weight,
2017 slant, and swidth names of XLFD font names to numeric values. */
2020 xlfd_numeric_value (table
, dim
, font
, field_index
, dflt
)
2021 struct table_entry
*table
;
2023 struct font_name
*font
;
2027 struct table_entry
*p
;
2028 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2029 return p
? p
->numeric
: dflt
;
2033 /* Return a symbolic representation for font name field
2034 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
2035 has DIM entries. Value is the symbolic value found or DFLT if no
2036 table entry matches. This function is used to translate weight,
2037 slant, and swidth names of XLFD font names to symbols. */
2039 static INLINE Lisp_Object
2040 xlfd_symbolic_value (table
, dim
, font
, field_index
, dflt
)
2041 struct table_entry
*table
;
2043 struct font_name
*font
;
2047 struct table_entry
*p
;
2048 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2049 return p
? *p
->symbol
: dflt
;
2053 /* Return a numeric value for the slant of the font given by FONT. */
2056 xlfd_numeric_slant (font
)
2057 struct font_name
*font
;
2059 return xlfd_numeric_value (slant_table
, DIM (slant_table
),
2060 font
, XLFD_SLANT
, XLFD_SLANT_ROMAN
);
2064 /* Return a symbol representing the weight of the font given by FONT. */
2066 static INLINE Lisp_Object
2067 xlfd_symbolic_slant (font
)
2068 struct font_name
*font
;
2070 return xlfd_symbolic_value (slant_table
, DIM (slant_table
),
2071 font
, XLFD_SLANT
, Qnormal
);
2075 /* Return a numeric value for the weight of the font given by FONT. */
2078 xlfd_numeric_weight (font
)
2079 struct font_name
*font
;
2081 return xlfd_numeric_value (weight_table
, DIM (weight_table
),
2082 font
, XLFD_WEIGHT
, XLFD_WEIGHT_MEDIUM
);
2086 /* Return a symbol representing the slant of the font given by FONT. */
2088 static INLINE Lisp_Object
2089 xlfd_symbolic_weight (font
)
2090 struct font_name
*font
;
2092 return xlfd_symbolic_value (weight_table
, DIM (weight_table
),
2093 font
, XLFD_WEIGHT
, Qnormal
);
2097 /* Return a numeric value for the swidth of the font whose XLFD font
2098 name fields are found in FONT. */
2101 xlfd_numeric_swidth (font
)
2102 struct font_name
*font
;
2104 return xlfd_numeric_value (swidth_table
, DIM (swidth_table
),
2105 font
, XLFD_SWIDTH
, XLFD_SWIDTH_MEDIUM
);
2109 /* Return a symbolic value for the swidth of FONT. */
2111 static INLINE Lisp_Object
2112 xlfd_symbolic_swidth (font
)
2113 struct font_name
*font
;
2115 return xlfd_symbolic_value (swidth_table
, DIM (swidth_table
),
2116 font
, XLFD_SWIDTH
, Qnormal
);
2120 /* Look up the entry of SYMBOL in the vector TABLE which has DIM
2121 entries. Value is a pointer to the matching table entry or null if
2122 no element of TABLE contains SYMBOL. */
2124 static struct table_entry
*
2125 face_value (table
, dim
, symbol
)
2126 struct table_entry
*table
;
2132 xassert (SYMBOLP (symbol
));
2134 for (i
= 0; i
< dim
; ++i
)
2135 if (EQ (*table
[i
].symbol
, symbol
))
2138 return i
< dim
? table
+ i
: NULL
;
2142 /* Return a numeric value for SYMBOL in the vector TABLE which has DIM
2143 entries. Value is -1 if SYMBOL is not found in TABLE. */
2146 face_numeric_value (table
, dim
, symbol
)
2147 struct table_entry
*table
;
2151 struct table_entry
*p
= face_value (table
, dim
, symbol
);
2152 return p
? p
->numeric
: -1;
2156 /* Return a numeric value representing the weight specified by Lisp
2157 symbol WEIGHT. Value is one of the enumerators of enum
2161 face_numeric_weight (weight
)
2164 return face_numeric_value (weight_table
, DIM (weight_table
), weight
);
2168 /* Return a numeric value representing the slant specified by Lisp
2169 symbol SLANT. Value is one of the enumerators of enum xlfd_slant. */
2172 face_numeric_slant (slant
)
2175 return face_numeric_value (slant_table
, DIM (slant_table
), slant
);
2179 /* Return a numeric value representing the swidth specified by Lisp
2180 symbol WIDTH. Value is one of the enumerators of enum xlfd_swidth. */
2183 face_numeric_swidth (width
)
2186 return face_numeric_value (swidth_table
, DIM (swidth_table
), width
);
2189 #ifdef HAVE_WINDOW_SYSTEM
2191 #ifdef USE_FONT_BACKEND
2192 static INLINE Lisp_Object
2193 face_symbolic_value (table
, dim
, font_prop
)
2194 struct table_entry
*table
;
2196 Lisp_Object font_prop
;
2198 struct table_entry
*p
;
2199 char *s
= SDATA (SYMBOL_NAME (font_prop
));
2200 int low
, mid
, high
, cmp
;
2207 mid
= (low
+ high
) / 2;
2208 cmp
= strcmp (table
[mid
].name
, s
);
2215 return *table
[mid
].symbol
;
2221 static INLINE Lisp_Object
2222 face_symbolic_weight (weight
)
2225 return face_symbolic_value (weight_table
, DIM (weight_table
), weight
);
2228 static INLINE Lisp_Object
2229 face_symbolic_slant (slant
)
2232 return face_symbolic_value (slant_table
, DIM (slant_table
), slant
);
2235 static INLINE Lisp_Object
2236 face_symbolic_swidth (width
)
2239 return face_symbolic_value (swidth_table
, DIM (swidth_table
), width
);
2241 #endif /* USE_FONT_BACKEND */
2244 split_font_name_into_vector (fontname
)
2245 Lisp_Object fontname
;
2247 struct font_name font
;
2251 font
.name
= LSTRDUPA (fontname
);
2252 if (! split_font_name (NULL
, &font
, 0))
2254 vec
= Fmake_vector (make_number (XLFD_LAST
), Qnil
);
2255 for (i
= 0; i
< XLFD_LAST
; i
++)
2256 if (font
.fields
[i
][0] != '*')
2257 ASET (vec
, i
, build_string (font
.fields
[i
]));
2262 build_font_name_from_vector (vec
)
2265 struct font_name font
;
2266 Lisp_Object fontname
;
2270 for (i
= 0; i
< XLFD_LAST
; i
++)
2272 font
.fields
[i
] = (NILP (AREF (vec
, i
))
2273 ? "*" : (char *) SDATA (AREF (vec
, i
)));
2274 if ((i
== XLFD_FAMILY
|| i
== XLFD_REGISTRY
)
2275 && (p
= strchr (font
.fields
[i
], '-')))
2277 char *p1
= STRDUPA (font
.fields
[i
]);
2279 p1
[p
- font
.fields
[i
]] = '\0';
2280 if (i
== XLFD_FAMILY
)
2282 font
.fields
[XLFD_FOUNDRY
] = p1
;
2283 font
.fields
[XLFD_FAMILY
] = p
+ 1;
2287 font
.fields
[XLFD_REGISTRY
] = p1
;
2288 font
.fields
[XLFD_ENCODING
] = p
+ 1;
2294 p
= build_font_name (&font
);
2295 fontname
= build_string (p
);
2300 /* Return non-zero if FONT is the name of a fixed-pitch font. */
2304 struct font_name
*font
;
2306 /* Function split_font_name converts fields to lower-case, so there
2307 is no need to use tolower here. */
2308 return *font
->fields
[XLFD_SPACING
] != 'p';
2312 /* Return the point size of FONT on frame F, measured in 1/10 pt.
2314 The actual height of the font when displayed on F depends on the
2315 resolution of both the font and frame. For example, a 10pt font
2316 designed for a 100dpi display will display larger than 10pt on a
2317 75dpi display. (It's not unusual to use fonts not designed for the
2318 display one is using. For example, some intlfonts are available in
2319 72dpi versions, only.)
2321 Value is the real point size of FONT on frame F, or 0 if it cannot
2324 By side effect, set FONT->numeric[XLFD_PIXEL_SIZE]. */
2327 xlfd_point_size (f
, font
)
2329 struct font_name
*font
;
2331 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2332 char *pixel_field
= font
->fields
[XLFD_PIXEL_SIZE
];
2336 if (*pixel_field
== '[')
2338 /* The pixel size field is `[A B C D]' which specifies
2339 a transformation matrix.
2345 by which all glyphs of the font are transformed. The spec
2346 says that s scalar value N for the pixel size is equivalent
2347 to A = N * resx/resy, B = C = 0, D = N. */
2348 char *start
= pixel_field
+ 1, *end
;
2352 for (i
= 0; i
< 4; ++i
)
2354 matrix
[i
] = strtod (start
, &end
);
2361 pixel
= atoi (pixel_field
);
2363 font
->numeric
[XLFD_PIXEL_SIZE
] = pixel
;
2367 real_pt
= PT_PER_INCH
* 10.0 * pixel
/ resy
+ 0.5;
2373 /* Return point size of PIXEL dots while considering Y-resultion (DPI)
2374 of frame F. This function is used to guess a point size of font
2375 when only the pixel height of the font is available. */
2378 pixel_point_size (f
, pixel
)
2382 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2386 /* As one inch is PT_PER_INCH points, PT_PER_INCH/RESY gives the
2387 point size of one dot. */
2388 real_pt
= pixel
* PT_PER_INCH
/ resy
;
2389 int_pt
= real_pt
+ 0.5;
2395 /* Return a rescaling ratio of a font of NAME. */
2398 font_rescale_ratio (name
)
2401 Lisp_Object tail
, elt
;
2403 for (tail
= Vface_font_rescale_alist
; CONSP (tail
); tail
= XCDR (tail
))
2406 if (STRINGP (XCAR (elt
)) && FLOATP (XCDR (elt
))
2407 && fast_c_string_match_ignore_case (XCAR (elt
), name
) >= 0)
2408 return XFLOAT_DATA (XCDR (elt
));
2414 /* Split XLFD font name FONT->name destructively into NUL-terminated,
2415 lower-case fields in FONT->fields. NUMERIC_P non-zero means
2416 compute numeric values for fields XLFD_POINT_SIZE, XLFD_SWIDTH,
2417 XLFD_RESY, XLFD_SLANT, and XLFD_WEIGHT in FONT->numeric. Value is
2418 zero if the font name doesn't have the format we expect. The
2419 expected format is a font name that starts with a `-' and has
2420 XLFD_LAST fields separated by `-'. */
2423 split_font_name (f
, font
, numeric_p
)
2425 struct font_name
*font
;
2430 double rescale_ratio
;
2433 /* This must be done before splitting the font name. */
2434 rescale_ratio
= font_rescale_ratio (font
->name
);
2436 if (*font
->name
== '-')
2438 char *p
= xstrlwr (font
->name
) + 1;
2440 while (i
< XLFD_LAST
)
2442 font
->fields
[i
] = p
;
2445 /* Pixel and point size may be of the form `[....]'. For
2446 BNF, see XLFD spec, chapter 4. Negative values are
2447 indicated by tilde characters which we replace with
2448 `-' characters, here. */
2450 && (i
- 1 == XLFD_PIXEL_SIZE
2451 || i
- 1 == XLFD_POINT_SIZE
))
2456 for (++p
; *p
&& *p
!= ']'; ++p
)
2460 /* Check that the matrix contains 4 floating point
2462 for (j
= 0, start
= font
->fields
[i
- 1] + 1;
2465 if (strtod (start
, &end
) == 0 && start
== end
)
2472 while (*p
&& *p
!= '-')
2482 success_p
= i
== XLFD_LAST
;
2484 /* If requested, and font name was in the expected format,
2485 compute numeric values for some fields. */
2486 if (numeric_p
&& success_p
)
2488 font
->numeric
[XLFD_POINT_SIZE
] = xlfd_point_size (f
, font
);
2489 font
->numeric
[XLFD_RESY
] = atoi (font
->fields
[XLFD_RESY
]);
2490 font
->numeric
[XLFD_SLANT
] = xlfd_numeric_slant (font
);
2491 font
->numeric
[XLFD_WEIGHT
] = xlfd_numeric_weight (font
);
2492 font
->numeric
[XLFD_SWIDTH
] = xlfd_numeric_swidth (font
);
2493 font
->numeric
[XLFD_AVGWIDTH
] = atoi (font
->fields
[XLFD_AVGWIDTH
]);
2494 font
->rescale_ratio
= rescale_ratio
;
2497 /* Initialize it to zero. It will be overridden by font_list while
2498 trying alternate registries. */
2499 font
->registry_priority
= 0;
2505 /* Build an XLFD font name from font name fields in FONT. Value is a
2506 pointer to the font name, which is allocated via xmalloc. */
2509 build_font_name (font
)
2510 struct font_name
*font
;
2514 char *font_name
= (char *) xmalloc (size
);
2515 int total_length
= 0;
2517 for (i
= 0; i
< XLFD_LAST
; ++i
)
2519 /* Add 1 because of the leading `-'. */
2520 int len
= strlen (font
->fields
[i
]) + 1;
2522 /* Reallocate font_name if necessary. Add 1 for the final
2524 if (total_length
+ len
+ 1 >= size
)
2526 int new_size
= max (2 * size
, size
+ len
+ 1);
2527 int sz
= new_size
* sizeof *font_name
;
2528 font_name
= (char *) xrealloc (font_name
, sz
);
2532 font_name
[total_length
] = '-';
2533 bcopy (font
->fields
[i
], font_name
+ total_length
+ 1, len
- 1);
2534 total_length
+= len
;
2537 font_name
[total_length
] = 0;
2542 /* Free an array FONTS of N font_name structures. This frees FONTS
2543 itself and all `name' fields in its elements. */
2546 free_font_names (fonts
, n
)
2547 struct font_name
*fonts
;
2551 xfree (fonts
[--n
].name
);
2556 /* Sort vector FONTS of font_name structures which contains NFONTS
2557 elements using qsort and comparison function CMPFN. F is the frame
2558 on which the fonts will be used. The global variable font_frame
2559 is temporarily set to F to make it available in CMPFN. */
2562 sort_fonts (f
, fonts
, nfonts
, cmpfn
)
2564 struct font_name
*fonts
;
2566 int (*cmpfn
) P_ ((const void *, const void *));
2569 qsort (fonts
, nfonts
, sizeof *fonts
, cmpfn
);
2574 /* Get fonts matching PATTERN on frame F. If F is null, use the first
2575 display in x_display_list. FONTS is a pointer to a vector of
2576 NFONTS font_name structures. TRY_ALTERNATIVES_P non-zero means try
2577 alternative patterns from Valternate_fontname_alist if no fonts are
2578 found matching PATTERN.
2580 For all fonts found, set FONTS[i].name to the name of the font,
2581 allocated via xmalloc, and split font names into fields. Ignore
2582 fonts that we can't parse. Value is the number of fonts found. */
2585 x_face_list_fonts (f
, pattern
, pfonts
, nfonts
, try_alternatives_p
)
2588 struct font_name
**pfonts
;
2589 int nfonts
, try_alternatives_p
;
2593 /* NTEMACS_TODO : currently this uses w32_list_fonts, but it may be
2594 better to do it the other way around. */
2596 Lisp_Object lpattern
, tem
;
2597 struct font_name
*fonts
= 0;
2598 int num_fonts
= nfonts
;
2601 lpattern
= build_string (pattern
);
2603 /* Get the list of fonts matching PATTERN. */
2606 lfonts
= w32_list_fonts (f
, lpattern
, 0, nfonts
);
2609 lfonts
= x_list_fonts (f
, lpattern
, -1, nfonts
);
2612 if (nfonts
< 0 && CONSP (lfonts
))
2613 num_fonts
= XFASTINT (Flength (lfonts
));
2615 /* Make a copy of the font names we got from X, and
2616 split them into fields. */
2618 for (tem
= lfonts
; CONSP (tem
) && n
< num_fonts
; tem
= XCDR (tem
))
2620 Lisp_Object elt
, tail
;
2621 const char *name
= SDATA (XCAR (tem
));
2623 /* Ignore fonts matching a pattern from face-ignored-fonts. */
2624 for (tail
= Vface_ignored_fonts
; CONSP (tail
); tail
= XCDR (tail
))
2628 && fast_c_string_match_ignore_case (elt
, name
) >= 0)
2639 *pfonts
= (struct font_name
*) xmalloc (num_fonts
* sizeof **pfonts
);
2643 /* Make a copy of the font name. */
2644 fonts
[n
].name
= xstrdup (name
);
2646 if (split_font_name (f
, fonts
+ n
, 1))
2648 if (font_scalable_p (fonts
+ n
)
2649 && !may_use_scalable_font_p (name
))
2652 xfree (fonts
[n
].name
);
2658 xfree (fonts
[n
].name
);
2661 /* If no fonts found, try patterns from Valternate_fontname_alist. */
2662 if (n
== 0 && try_alternatives_p
)
2664 Lisp_Object list
= Valternate_fontname_alist
;
2672 while (CONSP (list
))
2674 Lisp_Object entry
= XCAR (list
);
2676 && STRINGP (XCAR (entry
))
2677 && strcmp (SDATA (XCAR (entry
)), pattern
) == 0)
2684 Lisp_Object patterns
= XCAR (list
);
2687 while (CONSP (patterns
)
2688 /* If list is screwed up, give up. */
2689 && (name
= XCAR (patterns
),
2691 /* Ignore patterns equal to PATTERN because we tried that
2692 already with no success. */
2693 && (strcmp (SDATA (name
), pattern
) == 0
2694 || (n
= x_face_list_fonts (f
, SDATA (name
),
2697 patterns
= XCDR (patterns
);
2705 /* Check if a font matching pattern_offset_t on frame F is available
2706 or not. PATTERN may be a cons (FAMILY . REGISTRY), in which case,
2707 a font name pattern is generated from FAMILY and REGISTRY. */
2710 face_font_available_p (f
, pattern
)
2712 Lisp_Object pattern
;
2716 if (! STRINGP (pattern
))
2718 Lisp_Object family
, registry
;
2719 char *family_str
, *registry_str
, *pattern_str
;
2721 CHECK_CONS (pattern
);
2722 family
= XCAR (pattern
);
2727 CHECK_STRING (family
);
2728 family_str
= (char *) SDATA (family
);
2730 registry
= XCDR (pattern
);
2731 if (NILP (registry
))
2735 CHECK_STRING (registry
);
2736 registry_str
= (char *) SDATA (registry
);
2739 pattern_str
= (char *) alloca (strlen (family_str
)
2740 + strlen (registry_str
)
2742 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2743 strcat (pattern_str
, family_str
);
2744 strcat (pattern_str
, "-*-");
2745 strcat (pattern_str
, registry_str
);
2746 if (!index (registry_str
, '-'))
2748 if (registry_str
[strlen (registry_str
) - 1] == '*')
2749 strcat (pattern_str
, "-*");
2751 strcat (pattern_str
, "*-*");
2753 pattern
= build_string (pattern_str
);
2756 /* Get the list of fonts matching PATTERN. */
2759 fonts
= w32_list_fonts (f
, pattern
, 0, 1);
2762 fonts
= x_list_fonts (f
, pattern
, -1, 1);
2764 return XINT (Flength (fonts
));
2768 /* Determine fonts matching PATTERN on frame F. Sort resulting fonts
2769 using comparison function CMPFN. Value is the number of fonts
2770 found. If value is non-zero, *FONTS is set to a vector of
2771 font_name structures allocated from the heap containing matching
2772 fonts. Each element of *FONTS contains a name member that is also
2773 allocated from the heap. Font names in these structures are split
2774 into fields. Use free_font_names to free such an array. */
2777 sorted_font_list (f
, pattern
, cmpfn
, fonts
)
2780 int (*cmpfn
) P_ ((const void *, const void *));
2781 struct font_name
**fonts
;
2785 /* Get the list of fonts matching pattern. 100 should suffice. */
2786 nfonts
= DEFAULT_FONT_LIST_LIMIT
;
2787 if (INTEGERP (Vfont_list_limit
))
2788 nfonts
= XINT (Vfont_list_limit
);
2791 nfonts
= x_face_list_fonts (f
, pattern
, fonts
, nfonts
, 1);
2793 /* Sort the resulting array and return it in *FONTS. If no
2794 fonts were found, make sure to set *FONTS to null. */
2796 sort_fonts (f
, *fonts
, nfonts
, cmpfn
);
2807 /* Compare two font_name structures *A and *B. Value is analogous to
2808 strcmp. Sort order is given by the global variable
2809 font_sort_order. Font names are sorted so that, everything else
2810 being equal, fonts with a resolution closer to that of the frame on
2811 which they are used are listed first. The global variable
2812 font_frame is the frame on which we operate. */
2815 cmp_font_names (a
, b
)
2818 struct font_name
*x
= (struct font_name
*) a
;
2819 struct font_name
*y
= (struct font_name
*) b
;
2822 /* All strings have been converted to lower-case by split_font_name,
2823 so we can use strcmp here. */
2824 cmp
= strcmp (x
->fields
[XLFD_FAMILY
], y
->fields
[XLFD_FAMILY
]);
2829 for (i
= 0; i
< DIM (font_sort_order
) && cmp
== 0; ++i
)
2831 int j
= font_sort_order
[i
];
2832 cmp
= x
->numeric
[j
] - y
->numeric
[j
];
2837 /* Everything else being equal, we prefer fonts with an
2838 y-resolution closer to that of the frame. */
2839 int resy
= FRAME_X_DISPLAY_INFO (font_frame
)->resy
;
2840 int x_resy
= x
->numeric
[XLFD_RESY
];
2841 int y_resy
= y
->numeric
[XLFD_RESY
];
2842 cmp
= abs (resy
- x_resy
) - abs (resy
- y_resy
);
2850 /* Get a sorted list of fonts matching PATTERN on frame F. If PATTERN
2851 is nil, list fonts matching FAMILY and REGISTRY. FAMILY is a
2852 family name string or nil. REGISTRY is a registry name string.
2853 Set *FONTS to a vector of font_name structures allocated from the
2854 heap containing the fonts found. Value is the number of fonts
2858 font_list_1 (f
, pattern
, family
, registry
, fonts
)
2860 Lisp_Object pattern
, family
, registry
;
2861 struct font_name
**fonts
;
2863 char *pattern_str
, *family_str
, *registry_str
;
2867 family_str
= (NILP (family
) ? "*" : (char *) SDATA (family
));
2868 registry_str
= (NILP (registry
) ? "*" : (char *) SDATA (registry
));
2870 pattern_str
= (char *) alloca (strlen (family_str
)
2871 + strlen (registry_str
)
2873 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2874 strcat (pattern_str
, family_str
);
2875 strcat (pattern_str
, "-*-");
2876 strcat (pattern_str
, registry_str
);
2877 if (!index (registry_str
, '-'))
2879 if (registry_str
[strlen (registry_str
) - 1] == '*')
2880 strcat (pattern_str
, "-*");
2882 strcat (pattern_str
, "*-*");
2886 pattern_str
= (char *) SDATA (pattern
);
2888 return sorted_font_list (f
, pattern_str
, cmp_font_names
, fonts
);
2892 /* Concatenate font list FONTS1 and FONTS2. FONTS1 and FONTS2
2893 contains NFONTS1 fonts and NFONTS2 fonts respectively. Return a
2894 pointer to a newly allocated font list. FONTS1 and FONTS2 are
2897 static struct font_name
*
2898 concat_font_list (fonts1
, nfonts1
, fonts2
, nfonts2
)
2899 struct font_name
*fonts1
, *fonts2
;
2900 int nfonts1
, nfonts2
;
2902 int new_nfonts
= nfonts1
+ nfonts2
;
2903 struct font_name
*new_fonts
;
2905 new_fonts
= (struct font_name
*) xmalloc (sizeof *new_fonts
* new_nfonts
);
2906 bcopy (fonts1
, new_fonts
, sizeof *new_fonts
* nfonts1
);
2907 bcopy (fonts2
, new_fonts
+ nfonts1
, sizeof *new_fonts
* nfonts2
);
2914 /* Get a sorted list of fonts of family FAMILY on frame F.
2916 If PATTERN is non-nil, list fonts matching that pattern.
2918 If REGISTRY is non-nil, it is a list of registry (and encoding)
2919 names. Return fonts with those registries and the alternative
2920 registries from Vface_alternative_font_registry_alist.
2922 If REGISTRY is nil return fonts of any registry.
2924 Set *FONTS to a vector of font_name structures allocated from the
2925 heap containing the fonts found. Value is the number of fonts
2929 font_list (f
, pattern
, family
, registry
, fonts
)
2931 Lisp_Object pattern
, family
, registry
;
2932 struct font_name
**fonts
;
2938 if (NILP (registry
))
2939 return font_list_1 (f
, pattern
, family
, registry
, fonts
);
2941 for (reg_prio
= 0, nfonts
= 0; CONSP (registry
); registry
= XCDR (registry
))
2943 Lisp_Object elt
, alter
;
2945 struct font_name
*fonts2
;
2947 elt
= XCAR (registry
);
2948 alter
= Fassoc (elt
, Vface_alternative_font_registry_alist
);
2950 alter
= Fcons (elt
, Qnil
);
2951 for (; CONSP (alter
); alter
= XCDR (alter
), reg_prio
++)
2953 nfonts2
= font_list_1 (f
, pattern
, family
, XCAR (alter
), &fonts2
);
2957 for (i
= 0; i
< nfonts2
; i
++)
2958 fonts2
[i
].registry_priority
= reg_prio
;
2960 *fonts
= concat_font_list (*fonts
, nfonts
, fonts2
, nfonts2
);
2972 /* Remove elements from LIST whose cars are `equal'. Called from
2973 x-family-fonts and x-font-family-list to remove duplicate font
2977 remove_duplicates (list
)
2980 Lisp_Object tail
= list
;
2982 while (!NILP (tail
) && !NILP (XCDR (tail
)))
2984 Lisp_Object next
= XCDR (tail
);
2985 if (!NILP (Fequal (XCAR (next
), XCAR (tail
))))
2986 XSETCDR (tail
, XCDR (next
));
2993 DEFUN ("x-family-fonts", Fx_family_fonts
, Sx_family_fonts
, 0, 2, 0,
2994 doc
: /* Return a list of available fonts of family FAMILY on FRAME.
2995 If FAMILY is omitted or nil, list all families.
2996 Otherwise, FAMILY must be a string, possibly containing wildcards
2998 If FRAME is omitted or nil, use the selected frame.
2999 Each element of the result is a vector [FAMILY WIDTH POINT-SIZE WEIGHT
3000 SLANT FIXED-P FULL REGISTRY-AND-ENCODING].
3001 FAMILY is the font family name. POINT-SIZE is the size of the
3002 font in 1/10 pt. WIDTH, WEIGHT, and SLANT are symbols describing the
3003 width, weight and slant of the font. These symbols are the same as for
3004 face attributes. FIXED-P is non-nil if the font is fixed-pitch.
3005 FULL is the full name of the font, and REGISTRY-AND-ENCODING is a string
3006 giving the registry and encoding of the font.
3007 The result list is sorted according to the current setting of
3008 the face font sort order. */)
3010 Lisp_Object family
, frame
;
3012 struct frame
*f
= check_x_frame (frame
);
3013 struct font_name
*fonts
;
3016 struct gcpro gcpro1
;
3019 CHECK_STRING (family
);
3023 nfonts
= font_list (f
, Qnil
, family
, Qnil
, &fonts
);
3024 for (i
= nfonts
- 1; i
>= 0; --i
)
3026 Lisp_Object v
= Fmake_vector (make_number (8), Qnil
);
3029 ASET (v
, 0, build_string (fonts
[i
].fields
[XLFD_FAMILY
]));
3030 ASET (v
, 1, xlfd_symbolic_swidth (fonts
+ i
));
3031 ASET (v
, 2, make_number (xlfd_point_size (f
, fonts
+ i
)));
3032 ASET (v
, 3, xlfd_symbolic_weight (fonts
+ i
));
3033 ASET (v
, 4, xlfd_symbolic_slant (fonts
+ i
));
3034 ASET (v
, 5, xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
);
3035 tem
= build_font_name (fonts
+ i
);
3036 ASET (v
, 6, build_string (tem
));
3037 sprintf (tem
, "%s-%s", fonts
[i
].fields
[XLFD_REGISTRY
],
3038 fonts
[i
].fields
[XLFD_ENCODING
]);
3039 ASET (v
, 7, build_string (tem
));
3042 result
= Fcons (v
, result
);
3045 remove_duplicates (result
);
3046 free_font_names (fonts
, nfonts
);
3052 DEFUN ("x-font-family-list", Fx_font_family_list
, Sx_font_family_list
,
3054 doc
: /* Return a list of available font families on FRAME.
3055 If FRAME is omitted or nil, use the selected frame.
3056 Value is a list of conses (FAMILY . FIXED-P) where FAMILY
3057 is a font family, and FIXED-P is non-nil if fonts of that family
3058 are fixed-pitch. */)
3062 struct frame
*f
= check_x_frame (frame
);
3064 struct font_name
*fonts
;
3066 struct gcpro gcpro1
;
3067 int count
= SPECPDL_INDEX ();
3069 /* Let's consider all fonts. */
3070 specbind (intern ("font-list-limit"), make_number (-1));
3071 nfonts
= font_list (f
, Qnil
, Qnil
, Qnil
, &fonts
);
3075 for (i
= nfonts
- 1; i
>= 0; --i
)
3076 result
= Fcons (Fcons (build_string (fonts
[i
].fields
[XLFD_FAMILY
]),
3077 xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
),
3080 remove_duplicates (result
);
3081 free_font_names (fonts
, nfonts
);
3083 return unbind_to (count
, result
);
3087 DEFUN ("x-list-fonts", Fx_list_fonts
, Sx_list_fonts
, 1, 5, 0,
3088 doc
: /* Return a list of the names of available fonts matching PATTERN.
3089 If optional arguments FACE and FRAME are specified, return only fonts
3090 the same size as FACE on FRAME.
3091 PATTERN is a string, perhaps with wildcard characters;
3092 the * character matches any substring, and
3093 the ? character matches any single character.
3094 PATTERN is case-insensitive.
3095 FACE is a face name--a symbol.
3097 The return value is a list of strings, suitable as arguments to
3100 Fonts Emacs can't use may or may not be excluded
3101 even if they match PATTERN and FACE.
3102 The optional fourth argument MAXIMUM sets a limit on how many
3103 fonts to match. The first MAXIMUM fonts are reported.
3104 The optional fifth argument WIDTH, if specified, is a number of columns
3105 occupied by a character of a font. In that case, return only fonts
3106 the WIDTH times as wide as FACE on FRAME. */)
3107 (pattern
, face
, frame
, maximum
, width
)
3108 Lisp_Object pattern
, face
, frame
, maximum
, width
;
3115 CHECK_STRING (pattern
);
3121 CHECK_NATNUM (maximum
);
3122 maxnames
= XINT (maximum
);
3126 CHECK_NUMBER (width
);
3128 /* We can't simply call check_x_frame because this function may be
3129 called before any frame is created. */
3130 f
= frame_or_selected_frame (frame
, 2);
3131 if (!FRAME_WINDOW_P (f
))
3133 /* Perhaps we have not yet created any frame. */
3138 /* Determine the width standard for comparison with the fonts we find. */
3144 /* This is of limited utility since it works with character
3145 widths. Keep it for compatibility. --gerd. */
3146 int face_id
= lookup_named_face (f
, face
, 0);
3147 struct face
*face
= (face_id
< 0
3149 : FACE_FROM_ID (f
, face_id
));
3152 /* For historic reasons, FONT_WIDTH refers to average width on W32,
3153 not maximum as on X. Redefine here. */
3155 #define FONT_WIDTH FONT_MAX_WIDTH
3158 if (face
&& face
->font
)
3159 size
= FONT_WIDTH (face
->font
);
3161 size
= FONT_WIDTH (FRAME_FONT (f
)); /* FRAME_COLUMN_WIDTH (f) */
3164 size
*= XINT (width
);
3168 Lisp_Object args
[2];
3170 args
[0] = x_list_fonts (f
, pattern
, size
, maxnames
);
3172 /* We don't have to check fontsets. */
3174 args
[1] = list_fontsets (f
, pattern
, size
);
3175 return Fnconc (2, args
);
3179 #endif /* HAVE_WINDOW_SYSTEM */
3183 /***********************************************************************
3185 ***********************************************************************/
3187 /* Access face attributes of face LFACE, a Lisp vector. */
3189 #define LFACE_FAMILY(LFACE) AREF ((LFACE), LFACE_FAMILY_INDEX)
3190 #define LFACE_HEIGHT(LFACE) AREF ((LFACE), LFACE_HEIGHT_INDEX)
3191 #define LFACE_WEIGHT(LFACE) AREF ((LFACE), LFACE_WEIGHT_INDEX)
3192 #define LFACE_SLANT(LFACE) AREF ((LFACE), LFACE_SLANT_INDEX)
3193 #define LFACE_UNDERLINE(LFACE) AREF ((LFACE), LFACE_UNDERLINE_INDEX)
3194 #define LFACE_INVERSE(LFACE) AREF ((LFACE), LFACE_INVERSE_INDEX)
3195 #define LFACE_FOREGROUND(LFACE) AREF ((LFACE), LFACE_FOREGROUND_INDEX)
3196 #define LFACE_BACKGROUND(LFACE) AREF ((LFACE), LFACE_BACKGROUND_INDEX)
3197 #define LFACE_STIPPLE(LFACE) AREF ((LFACE), LFACE_STIPPLE_INDEX)
3198 #define LFACE_SWIDTH(LFACE) AREF ((LFACE), LFACE_SWIDTH_INDEX)
3199 #define LFACE_OVERLINE(LFACE) AREF ((LFACE), LFACE_OVERLINE_INDEX)
3200 #define LFACE_STRIKE_THROUGH(LFACE) AREF ((LFACE), LFACE_STRIKE_THROUGH_INDEX)
3201 #define LFACE_BOX(LFACE) AREF ((LFACE), LFACE_BOX_INDEX)
3202 #define LFACE_FONT(LFACE) AREF ((LFACE), LFACE_FONT_INDEX)
3203 #define LFACE_INHERIT(LFACE) AREF ((LFACE), LFACE_INHERIT_INDEX)
3204 #define LFACE_AVGWIDTH(LFACE) AREF ((LFACE), LFACE_AVGWIDTH_INDEX)
3205 #define LFACE_FONTSET(LFACE) AREF ((LFACE), LFACE_FONTSET_INDEX)
3207 /* Non-zero if LFACE is a Lisp face. A Lisp face is a vector of size
3208 LFACE_VECTOR_SIZE which has the symbol `face' in slot 0. */
3210 #define LFACEP(LFACE) \
3212 && XVECTOR (LFACE)->size == LFACE_VECTOR_SIZE \
3213 && EQ (AREF (LFACE, 0), Qface))
3218 /* Check consistency of Lisp face attribute vector ATTRS. */
3221 check_lface_attrs (attrs
)
3224 xassert (UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
3225 || IGNORE_DEFFACE_P (attrs
[LFACE_FAMILY_INDEX
])
3226 || STRINGP (attrs
[LFACE_FAMILY_INDEX
]));
3227 xassert (UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
3228 || IGNORE_DEFFACE_P (attrs
[LFACE_SWIDTH_INDEX
])
3229 || SYMBOLP (attrs
[LFACE_SWIDTH_INDEX
]));
3230 xassert (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
3231 || IGNORE_DEFFACE_P (attrs
[LFACE_AVGWIDTH_INDEX
])
3232 || INTEGERP (attrs
[LFACE_AVGWIDTH_INDEX
]));
3233 xassert (UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
3234 || IGNORE_DEFFACE_P (attrs
[LFACE_HEIGHT_INDEX
])
3235 || INTEGERP (attrs
[LFACE_HEIGHT_INDEX
])
3236 || FLOATP (attrs
[LFACE_HEIGHT_INDEX
])
3237 || FUNCTIONP (attrs
[LFACE_HEIGHT_INDEX
]));
3238 xassert (UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
3239 || IGNORE_DEFFACE_P (attrs
[LFACE_WEIGHT_INDEX
])
3240 || SYMBOLP (attrs
[LFACE_WEIGHT_INDEX
]));
3241 xassert (UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
3242 || IGNORE_DEFFACE_P (attrs
[LFACE_SLANT_INDEX
])
3243 || SYMBOLP (attrs
[LFACE_SLANT_INDEX
]));
3244 xassert (UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
3245 || IGNORE_DEFFACE_P (attrs
[LFACE_UNDERLINE_INDEX
])
3246 || SYMBOLP (attrs
[LFACE_UNDERLINE_INDEX
])
3247 || STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]));
3248 xassert (UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
3249 || IGNORE_DEFFACE_P (attrs
[LFACE_OVERLINE_INDEX
])
3250 || SYMBOLP (attrs
[LFACE_OVERLINE_INDEX
])
3251 || STRINGP (attrs
[LFACE_OVERLINE_INDEX
]));
3252 xassert (UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3253 || IGNORE_DEFFACE_P (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3254 || SYMBOLP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3255 || STRINGP (attrs
[LFACE_STRIKE_THROUGH_INDEX
]));
3256 xassert (UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
3257 || IGNORE_DEFFACE_P (attrs
[LFACE_BOX_INDEX
])
3258 || SYMBOLP (attrs
[LFACE_BOX_INDEX
])
3259 || STRINGP (attrs
[LFACE_BOX_INDEX
])
3260 || INTEGERP (attrs
[LFACE_BOX_INDEX
])
3261 || CONSP (attrs
[LFACE_BOX_INDEX
]));
3262 xassert (UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
3263 || IGNORE_DEFFACE_P (attrs
[LFACE_INVERSE_INDEX
])
3264 || SYMBOLP (attrs
[LFACE_INVERSE_INDEX
]));
3265 xassert (UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
3266 || IGNORE_DEFFACE_P (attrs
[LFACE_FOREGROUND_INDEX
])
3267 || STRINGP (attrs
[LFACE_FOREGROUND_INDEX
]));
3268 xassert (UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
3269 || IGNORE_DEFFACE_P (attrs
[LFACE_BACKGROUND_INDEX
])
3270 || STRINGP (attrs
[LFACE_BACKGROUND_INDEX
]));
3271 xassert (UNSPECIFIEDP (attrs
[LFACE_INHERIT_INDEX
])
3272 || IGNORE_DEFFACE_P (attrs
[LFACE_INHERIT_INDEX
])
3273 || NILP (attrs
[LFACE_INHERIT_INDEX
])
3274 || SYMBOLP (attrs
[LFACE_INHERIT_INDEX
])
3275 || CONSP (attrs
[LFACE_INHERIT_INDEX
]));
3276 #ifdef HAVE_WINDOW_SYSTEM
3277 xassert (UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
3278 || IGNORE_DEFFACE_P (attrs
[LFACE_STIPPLE_INDEX
])
3279 || SYMBOLP (attrs
[LFACE_STIPPLE_INDEX
])
3280 || !NILP (Fbitmap_spec_p (attrs
[LFACE_STIPPLE_INDEX
])));
3281 xassert (UNSPECIFIEDP (attrs
[LFACE_FONT_INDEX
])
3282 || IGNORE_DEFFACE_P (attrs
[LFACE_FONT_INDEX
])
3283 || NILP (attrs
[LFACE_FONT_INDEX
])
3284 #ifdef USE_FONT_BACKEND
3285 || FONT_OBJECT_P (attrs
[LFACE_FONT_INDEX
])
3286 #endif /* USE_FONT_BACKEND */
3287 || STRINGP (attrs
[LFACE_FONT_INDEX
]));
3288 xassert (UNSPECIFIEDP (attrs
[LFACE_FONTSET_INDEX
])
3289 || STRINGP (attrs
[LFACE_FONTSET_INDEX
]));
3294 /* Check consistency of attributes of Lisp face LFACE (a Lisp vector). */
3302 xassert (LFACEP (lface
));
3303 check_lface_attrs (XVECTOR (lface
)->contents
);
3307 #else /* GLYPH_DEBUG == 0 */
3309 #define check_lface_attrs(attrs) (void) 0
3310 #define check_lface(lface) (void) 0
3312 #endif /* GLYPH_DEBUG == 0 */
3316 /* Face-merge cycle checking. */
3318 /* A `named merge point' is simply a point during face-merging where we
3319 look up a face by name. We keep a stack of which named lookups we're
3320 currently processing so that we can easily detect cycles, using a
3321 linked- list of struct named_merge_point structures, typically
3322 allocated on the stack frame of the named lookup functions which are
3323 active (so no consing is required). */
3324 struct named_merge_point
3326 Lisp_Object face_name
;
3327 struct named_merge_point
*prev
;
3331 /* If a face merging cycle is detected for FACE_NAME, return 0,
3332 otherwise add NEW_NAMED_MERGE_POINT, which is initialized using
3333 FACE_NAME, as the head of the linked list pointed to by
3334 NAMED_MERGE_POINTS, and return 1. */
3337 push_named_merge_point (struct named_merge_point
*new_named_merge_point
,
3338 Lisp_Object face_name
,
3339 struct named_merge_point
**named_merge_points
)
3341 struct named_merge_point
*prev
;
3343 for (prev
= *named_merge_points
; prev
; prev
= prev
->prev
)
3344 if (EQ (face_name
, prev
->face_name
))
3347 new_named_merge_point
->face_name
= face_name
;
3348 new_named_merge_point
->prev
= *named_merge_points
;
3350 *named_merge_points
= new_named_merge_point
;
3358 /* Resolve face name FACE_NAME. If FACE_NAME is a string, intern it
3359 to make it a symbol. If FACE_NAME is an alias for another face,
3360 return that face's name.
3362 Return default face in case of errors. */
3365 resolve_face_name (face_name
, signal_p
)
3366 Lisp_Object face_name
;
3369 Lisp_Object orig_face
;
3370 Lisp_Object tortoise
, hare
;
3372 if (STRINGP (face_name
))
3373 face_name
= intern (SDATA (face_name
));
3375 if (NILP (face_name
) || !SYMBOLP (face_name
))
3378 orig_face
= face_name
;
3379 tortoise
= hare
= face_name
;
3384 hare
= Fget (hare
, Qface_alias
);
3385 if (NILP (hare
) || !SYMBOLP (hare
))
3389 hare
= Fget (hare
, Qface_alias
);
3390 if (NILP (hare
) || !SYMBOLP (hare
))
3393 tortoise
= Fget (tortoise
, Qface_alias
);
3394 if (EQ (hare
, tortoise
))
3397 xsignal1 (Qcircular_list
, orig_face
);
3406 /* Return the face definition of FACE_NAME on frame F. F null means
3407 return the definition for new frames. FACE_NAME may be a string or
3408 a symbol (apparently Emacs 20.2 allowed strings as face names in
3409 face text properties; Ediff uses that). If FACE_NAME is an alias
3410 for another face, return that face's definition. If SIGNAL_P is
3411 non-zero, signal an error if FACE_NAME is not a valid face name.
3412 If SIGNAL_P is zero, value is nil if FACE_NAME is not a valid face
3415 static INLINE Lisp_Object
3416 lface_from_face_name (f
, face_name
, signal_p
)
3418 Lisp_Object face_name
;
3423 face_name
= resolve_face_name (face_name
, signal_p
);
3426 lface
= assq_no_quit (face_name
, f
->face_alist
);
3428 lface
= assq_no_quit (face_name
, Vface_new_frame_defaults
);
3431 lface
= XCDR (lface
);
3433 signal_error ("Invalid face", face_name
);
3435 check_lface (lface
);
3440 /* Get face attributes of face FACE_NAME from frame-local faces on
3441 frame F. Store the resulting attributes in ATTRS which must point
3442 to a vector of Lisp_Objects of size LFACE_VECTOR_SIZE. If SIGNAL_P
3443 is non-zero, signal an error if FACE_NAME does not name a face.
3444 Otherwise, value is zero if FACE_NAME is not a face. */
3447 get_lface_attributes (f
, face_name
, attrs
, signal_p
)
3449 Lisp_Object face_name
;
3456 lface
= lface_from_face_name (f
, face_name
, signal_p
);
3459 bcopy (XVECTOR (lface
)->contents
, attrs
,
3460 LFACE_VECTOR_SIZE
* sizeof *attrs
);
3470 /* Non-zero if all attributes in face attribute vector ATTRS are
3471 specified, i.e. are non-nil. */
3474 lface_fully_specified_p (attrs
)
3479 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3480 if (i
!= LFACE_FONT_INDEX
&& i
!= LFACE_INHERIT_INDEX
3481 && i
!= LFACE_AVGWIDTH_INDEX
&& i
!= LFACE_FONTSET_INDEX
)
3482 if ((UNSPECIFIEDP (attrs
[i
]) || IGNORE_DEFFACE_P (attrs
[i
]))
3484 /* MAC_TODO: No stipple support on Mac OS yet, this index is
3485 always unspecified. */
3486 && i
!= LFACE_STIPPLE_INDEX
3491 return i
== LFACE_VECTOR_SIZE
;
3494 #ifdef HAVE_WINDOW_SYSTEM
3496 /* Set font-related attributes of Lisp face LFACE from the fullname of
3497 the font opened by FONTNAME. If FORCE_P is zero, set only
3498 unspecified attributes of LFACE. The exception is `font'
3499 attribute. It is set to FONTNAME as is regardless of FORCE_P.
3501 If FONTNAME is not available on frame F,
3502 return 0 if MAY_FAIL_P is non-zero, otherwise abort.
3503 If the fullname is not in a valid XLFD format,
3504 return 0 if MAY_FAIL_P is non-zero, otherwise set normal values
3505 in LFACE and return 1.
3506 Otherwise, return 1. */
3509 set_lface_from_font_name (f
, lface
, fontname
, force_p
, may_fail_p
)
3512 Lisp_Object fontname
;
3513 int force_p
, may_fail_p
;
3515 struct font_name font
;
3520 char *font_name
= SDATA (fontname
);
3521 struct font_info
*font_info
;
3523 /* If FONTNAME is actually a fontset name, get ASCII font name of it. */
3524 fontset
= fs_query_fontset (fontname
, 0);
3527 font_name
= SDATA (fontset_ascii (fontset
));
3528 else if (fontset
== 0)
3535 /* Check if FONT_NAME is surely available on the system. Usually
3536 FONT_NAME is already cached for the frame F and FS_LOAD_FONT
3537 returns quickly. But, even if FONT_NAME is not yet cached,
3538 caching it now is not futail because we anyway load the font
3541 font_info
= FS_LOAD_FONT (f
, font_name
);
3551 font
.name
= STRDUPA (font_info
->full_name
);
3552 have_xlfd_p
= split_font_name (f
, &font
, 1);
3554 /* Set attributes only if unspecified, otherwise face defaults for
3555 new frames would never take effect. If we couldn't get a font
3556 name conforming to XLFD, set normal values. */
3558 if (force_p
|| UNSPECIFIEDP (LFACE_FAMILY (lface
)))
3563 buffer
= (char *) alloca (strlen (font
.fields
[XLFD_FAMILY
])
3564 + strlen (font
.fields
[XLFD_FOUNDRY
])
3566 sprintf (buffer
, "%s-%s", font
.fields
[XLFD_FOUNDRY
],
3567 font
.fields
[XLFD_FAMILY
]);
3568 val
= build_string (buffer
);
3571 val
= build_string ("*");
3572 LFACE_FAMILY (lface
) = val
;
3575 if (force_p
|| UNSPECIFIEDP (LFACE_HEIGHT (lface
)))
3578 pt
= xlfd_point_size (f
, &font
);
3580 pt
= pixel_point_size (f
, font_info
->height
* 10);
3582 LFACE_HEIGHT (lface
) = make_number (pt
);
3585 if (force_p
|| UNSPECIFIEDP (LFACE_SWIDTH (lface
)))
3586 LFACE_SWIDTH (lface
)
3587 = have_xlfd_p
? xlfd_symbolic_swidth (&font
) : Qnormal
;
3589 if (force_p
|| UNSPECIFIEDP (LFACE_AVGWIDTH (lface
)))
3590 LFACE_AVGWIDTH (lface
)
3592 ? make_number (font
.numeric
[XLFD_AVGWIDTH
])
3595 if (force_p
|| UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
3596 LFACE_WEIGHT (lface
)
3597 = have_xlfd_p
? xlfd_symbolic_weight (&font
) : Qnormal
;
3599 if (force_p
|| UNSPECIFIEDP (LFACE_SLANT (lface
)))
3601 = have_xlfd_p
? xlfd_symbolic_slant (&font
) : Qnormal
;
3605 LFACE_FONT (lface
) = build_string (font_info
->full_name
);
3606 LFACE_FONTSET (lface
) = fontset_name (fontset
);
3610 LFACE_FONT (lface
) = fontname
;
3612 = new_fontset_from_font_name (build_string (font_info
->full_name
));
3613 LFACE_FONTSET (lface
) = fontset_name (fontset
);
3618 #ifdef USE_FONT_BACKEND
3619 /* Set font-related attributes of Lisp face LFACE from FONT-OBJECT and
3620 FONTSET. If FORCE_P is zero, set only unspecified attributes of
3621 LFACE. The exceptions are `font' and `fontset' attributes. They
3622 are set regardless of FORCE_P. */
3625 set_lface_from_font_and_fontset (f
, lface
, font_object
, fontset
, force_p
)
3627 Lisp_Object lface
, font_object
;
3631 struct font
*font
= XSAVE_VALUE (font_object
)->pointer
;
3632 Lisp_Object entity
= font
->entity
;
3635 /* Set attributes only if unspecified, otherwise face defaults for
3636 new frames would never take effect. If the font doesn't have a
3637 specific property, set a normal value for that. */
3639 if (force_p
|| UNSPECIFIEDP (LFACE_FAMILY (lface
)))
3641 Lisp_Object foundry
= AREF (entity
, FONT_FOUNDRY_INDEX
);
3642 Lisp_Object family
= AREF (entity
, FONT_FAMILY_INDEX
);
3644 if (! NILP (foundry
))
3646 if (! NILP (family
))
3647 val
= concat3 (SYMBOL_NAME (foundry
), build_string ("-"),
3648 SYMBOL_NAME (family
));
3650 val
= concat2 (SYMBOL_NAME (foundry
), build_string ("-*"));
3654 if (! NILP (family
))
3655 val
= SYMBOL_NAME (family
);
3657 val
= build_string ("*");
3659 LFACE_FAMILY (lface
) = val
;
3662 if (force_p
|| UNSPECIFIEDP (LFACE_HEIGHT (lface
)))
3664 int pt
= pixel_point_size (f
, font
->pixel_size
* 10);
3667 LFACE_HEIGHT (lface
) = make_number (pt
);
3670 if (force_p
|| UNSPECIFIEDP (LFACE_AVGWIDTH (lface
)))
3671 LFACE_AVGWIDTH (lface
) = make_number (font
->font
.average_width
);
3673 if (force_p
|| UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
3675 Lisp_Object weight
= font_symbolic_weight (entity
);
3677 val
= NILP (weight
) ? Qnormal
: face_symbolic_weight (weight
);
3678 LFACE_WEIGHT (lface
) = ! NILP (val
) ? val
: weight
;
3680 if (force_p
|| UNSPECIFIEDP (LFACE_SLANT (lface
)))
3682 Lisp_Object slant
= font_symbolic_slant (entity
);
3684 val
= NILP (slant
) ? Qnormal
: face_symbolic_slant (slant
);
3685 LFACE_SLANT (lface
) = ! NILP (val
) ? val
: slant
;
3687 if (force_p
|| UNSPECIFIEDP (LFACE_SWIDTH (lface
)))
3689 Lisp_Object width
= font_symbolic_width (entity
);
3691 val
= NILP (width
) ? Qnormal
: face_symbolic_swidth (width
);
3692 LFACE_SWIDTH (lface
) = ! NILP (val
) ? val
: width
;
3695 LFACE_FONT (lface
) = font_object
;
3696 LFACE_FONTSET (lface
) = fontset_name (fontset
);
3698 #endif /* USE_FONT_BACKEND */
3700 #endif /* HAVE_WINDOW_SYSTEM */
3703 /* Merges the face height FROM with the face height TO, and returns the
3704 merged height. If FROM is an invalid height, then INVALID is
3705 returned instead. FROM and TO may be either absolute face heights or
3706 `relative' heights; the returned value is always an absolute height
3707 unless both FROM and TO are relative. GCPRO is a lisp value that
3708 will be protected from garbage-collection if this function makes a
3712 merge_face_heights (from
, to
, invalid
)
3713 Lisp_Object from
, to
, invalid
;
3715 Lisp_Object result
= invalid
;
3717 if (INTEGERP (from
))
3718 /* FROM is absolute, just use it as is. */
3720 else if (FLOATP (from
))
3721 /* FROM is a scale, use it to adjust TO. */
3724 /* relative X absolute => absolute */
3725 result
= make_number ((EMACS_INT
)(XFLOAT_DATA (from
) * XINT (to
)));
3726 else if (FLOATP (to
))
3727 /* relative X relative => relative */
3728 result
= make_float (XFLOAT_DATA (from
) * XFLOAT_DATA (to
));
3729 else if (UNSPECIFIEDP (to
))
3732 else if (FUNCTIONP (from
))
3733 /* FROM is a function, which use to adjust TO. */
3735 /* Call function with current height as argument.
3736 From is the new height. */
3737 Lisp_Object args
[2];
3741 result
= safe_call (2, args
);
3743 /* Ensure that if TO was absolute, so is the result. */
3744 if (INTEGERP (to
) && !INTEGERP (result
))
3752 /* Merge two Lisp face attribute vectors on frame F, FROM and TO, and
3753 store the resulting attributes in TO, which must be already be
3754 completely specified and contain only absolute attributes. Every
3755 specified attribute of FROM overrides the corresponding attribute of
3756 TO; relative attributes in FROM are merged with the absolute value in
3757 TO and replace it. NAMED_MERGE_POINTS is used internally to detect
3758 loops in face inheritance; it should be 0 when called from other
3762 merge_face_vectors (f
, from
, to
, named_merge_points
)
3764 Lisp_Object
*from
, *to
;
3765 struct named_merge_point
*named_merge_points
;
3769 /* If FROM inherits from some other faces, merge their attributes into
3770 TO before merging FROM's direct attributes. Note that an :inherit
3771 attribute of `unspecified' is the same as one of nil; we never
3772 merge :inherit attributes, so nil is more correct, but lots of
3773 other code uses `unspecified' as a generic value for face attributes. */
3774 if (!UNSPECIFIEDP (from
[LFACE_INHERIT_INDEX
])
3775 && !NILP (from
[LFACE_INHERIT_INDEX
]))
3776 merge_face_ref (f
, from
[LFACE_INHERIT_INDEX
], to
, 0, named_merge_points
);
3778 /* If TO specifies a :font attribute, and FROM specifies some
3779 font-related attribute, we need to clear TO's :font attribute
3780 (because it will be inconsistent with whatever FROM specifies, and
3781 FROM takes precedence). */
3782 if (!NILP (to
[LFACE_FONT_INDEX
])
3783 && (!UNSPECIFIEDP (from
[LFACE_FAMILY_INDEX
])
3784 || !UNSPECIFIEDP (from
[LFACE_HEIGHT_INDEX
])
3785 || !UNSPECIFIEDP (from
[LFACE_WEIGHT_INDEX
])
3786 || !UNSPECIFIEDP (from
[LFACE_SLANT_INDEX
])
3787 || !UNSPECIFIEDP (from
[LFACE_SWIDTH_INDEX
])
3788 || !UNSPECIFIEDP (from
[LFACE_AVGWIDTH_INDEX
])))
3789 to
[LFACE_FONT_INDEX
] = Qnil
;
3791 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3792 if (!UNSPECIFIEDP (from
[i
]))
3794 if (i
== LFACE_HEIGHT_INDEX
&& !INTEGERP (from
[i
]))
3795 to
[i
] = merge_face_heights (from
[i
], to
[i
], to
[i
]);
3800 /* TO is always an absolute face, which should inherit from nothing.
3801 We blindly copy the :inherit attribute above and fix it up here. */
3802 to
[LFACE_INHERIT_INDEX
] = Qnil
;
3805 /* Merge the named face FACE_NAME on frame F, into the vector of face
3806 attributes TO. NAMED_MERGE_POINTS is used to detect loops in face
3807 inheritance. Returns true if FACE_NAME is a valid face name and
3808 merging succeeded. */
3811 merge_named_face (f
, face_name
, to
, named_merge_points
)
3813 Lisp_Object face_name
;
3815 struct named_merge_point
*named_merge_points
;
3817 struct named_merge_point named_merge_point
;
3819 if (push_named_merge_point (&named_merge_point
,
3820 face_name
, &named_merge_points
))
3822 struct gcpro gcpro1
;
3823 Lisp_Object from
[LFACE_VECTOR_SIZE
];
3824 int ok
= get_lface_attributes (f
, face_name
, from
, 0);
3828 GCPRO1 (named_merge_point
.face_name
);
3829 merge_face_vectors (f
, from
, to
, named_merge_points
);
3840 /* Merge face attributes from the lisp `face reference' FACE_REF on
3841 frame F into the face attribute vector TO. If ERR_MSGS is non-zero,
3842 problems with FACE_REF cause an error message to be shown. Return
3843 non-zero if no errors occurred (regardless of the value of ERR_MSGS).
3844 NAMED_MERGE_POINTS is used to detect loops in face inheritance or
3845 list structure; it may be 0 for most callers.
3847 FACE_REF may be a single face specification or a list of such
3848 specifications. Each face specification can be:
3850 1. A symbol or string naming a Lisp face.
3852 2. A property list of the form (KEYWORD VALUE ...) where each
3853 KEYWORD is a face attribute name, and value is an appropriate value
3856 3. Conses or the form (FOREGROUND-COLOR . COLOR) or
3857 (BACKGROUND-COLOR . COLOR) where COLOR is a color name. This is
3858 for compatibility with 20.2.
3860 Face specifications earlier in lists take precedence over later
3864 merge_face_ref (f
, face_ref
, to
, err_msgs
, named_merge_points
)
3866 Lisp_Object face_ref
;
3869 struct named_merge_point
*named_merge_points
;
3871 int ok
= 1; /* Succeed without an error? */
3873 if (CONSP (face_ref
))
3875 Lisp_Object first
= XCAR (face_ref
);
3877 if (EQ (first
, Qforeground_color
)
3878 || EQ (first
, Qbackground_color
))
3880 /* One of (FOREGROUND-COLOR . COLOR) or (BACKGROUND-COLOR
3881 . COLOR). COLOR must be a string. */
3882 Lisp_Object color_name
= XCDR (face_ref
);
3883 Lisp_Object color
= first
;
3885 if (STRINGP (color_name
))
3887 if (EQ (color
, Qforeground_color
))
3888 to
[LFACE_FOREGROUND_INDEX
] = color_name
;
3890 to
[LFACE_BACKGROUND_INDEX
] = color_name
;
3895 add_to_log ("Invalid face color", color_name
, Qnil
);
3899 else if (SYMBOLP (first
)
3900 && *SDATA (SYMBOL_NAME (first
)) == ':')
3902 /* Assume this is the property list form. */
3903 while (CONSP (face_ref
) && CONSP (XCDR (face_ref
)))
3905 Lisp_Object keyword
= XCAR (face_ref
);
3906 Lisp_Object value
= XCAR (XCDR (face_ref
));
3909 /* Specifying `unspecified' is a no-op. */
3910 if (EQ (value
, Qunspecified
))
3912 else if (EQ (keyword
, QCfamily
))
3914 if (STRINGP (value
))
3915 to
[LFACE_FAMILY_INDEX
] = value
;
3919 else if (EQ (keyword
, QCheight
))
3921 Lisp_Object new_height
=
3922 merge_face_heights (value
, to
[LFACE_HEIGHT_INDEX
], Qnil
);
3924 if (! NILP (new_height
))
3925 to
[LFACE_HEIGHT_INDEX
] = new_height
;
3929 else if (EQ (keyword
, QCweight
))
3932 && face_numeric_weight (value
) >= 0)
3933 to
[LFACE_WEIGHT_INDEX
] = value
;
3937 else if (EQ (keyword
, QCslant
))
3940 && face_numeric_slant (value
) >= 0)
3941 to
[LFACE_SLANT_INDEX
] = value
;
3945 else if (EQ (keyword
, QCunderline
))
3950 to
[LFACE_UNDERLINE_INDEX
] = value
;
3954 else if (EQ (keyword
, QCoverline
))
3959 to
[LFACE_OVERLINE_INDEX
] = value
;
3963 else if (EQ (keyword
, QCstrike_through
))
3968 to
[LFACE_STRIKE_THROUGH_INDEX
] = value
;
3972 else if (EQ (keyword
, QCbox
))
3975 value
= make_number (1);
3976 if (INTEGERP (value
)
3980 to
[LFACE_BOX_INDEX
] = value
;
3984 else if (EQ (keyword
, QCinverse_video
)
3985 || EQ (keyword
, QCreverse_video
))
3987 if (EQ (value
, Qt
) || NILP (value
))
3988 to
[LFACE_INVERSE_INDEX
] = value
;
3992 else if (EQ (keyword
, QCforeground
))
3994 if (STRINGP (value
))
3995 to
[LFACE_FOREGROUND_INDEX
] = value
;
3999 else if (EQ (keyword
, QCbackground
))
4001 if (STRINGP (value
))
4002 to
[LFACE_BACKGROUND_INDEX
] = value
;
4006 else if (EQ (keyword
, QCstipple
))
4008 #ifdef HAVE_X_WINDOWS
4009 Lisp_Object pixmap_p
= Fbitmap_spec_p (value
);
4010 if (!NILP (pixmap_p
))
4011 to
[LFACE_STIPPLE_INDEX
] = value
;
4016 else if (EQ (keyword
, QCwidth
))
4019 && face_numeric_swidth (value
) >= 0)
4020 to
[LFACE_SWIDTH_INDEX
] = value
;
4024 else if (EQ (keyword
, QCinherit
))
4026 /* This is not really very useful; it's just like a
4027 normal face reference. */
4028 if (! merge_face_ref (f
, value
, to
,
4029 err_msgs
, named_merge_points
))
4037 add_to_log ("Invalid face attribute %S %S", keyword
, value
);
4041 face_ref
= XCDR (XCDR (face_ref
));
4046 /* This is a list of face refs. Those at the beginning of the
4047 list take precedence over what follows, so we have to merge
4048 from the end backwards. */
4049 Lisp_Object next
= XCDR (face_ref
);
4052 ok
= merge_face_ref (f
, next
, to
, err_msgs
, named_merge_points
);
4054 if (! merge_face_ref (f
, first
, to
, err_msgs
, named_merge_points
))
4060 /* FACE_REF ought to be a face name. */
4061 ok
= merge_named_face (f
, face_ref
, to
, named_merge_points
);
4062 if (!ok
&& err_msgs
)
4063 add_to_log ("Invalid face reference: %s", face_ref
, Qnil
);
4070 DEFUN ("internal-make-lisp-face", Finternal_make_lisp_face
,
4071 Sinternal_make_lisp_face
, 1, 2, 0,
4072 doc
: /* Make FACE, a symbol, a Lisp face with all attributes nil.
4073 If FACE was not known as a face before, create a new one.
4074 If optional argument FRAME is specified, make a frame-local face
4075 for that frame. Otherwise operate on the global face definition.
4076 Value is a vector of face attributes. */)
4078 Lisp_Object face
, frame
;
4080 Lisp_Object global_lface
, lface
;
4084 CHECK_SYMBOL (face
);
4085 global_lface
= lface_from_face_name (NULL
, face
, 0);
4089 CHECK_LIVE_FRAME (frame
);
4091 lface
= lface_from_face_name (f
, face
, 0);
4094 f
= NULL
, lface
= Qnil
;
4096 /* Add a global definition if there is none. */
4097 if (NILP (global_lface
))
4099 global_lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
4101 AREF (global_lface
, 0) = Qface
;
4102 Vface_new_frame_defaults
= Fcons (Fcons (face
, global_lface
),
4103 Vface_new_frame_defaults
);
4105 /* Assign the new Lisp face a unique ID. The mapping from Lisp
4106 face id to Lisp face is given by the vector lface_id_to_name.
4107 The mapping from Lisp face to Lisp face id is given by the
4108 property `face' of the Lisp face name. */
4109 if (next_lface_id
== lface_id_to_name_size
)
4111 int new_size
= max (50, 2 * lface_id_to_name_size
);
4112 int sz
= new_size
* sizeof *lface_id_to_name
;
4113 lface_id_to_name
= (Lisp_Object
*) xrealloc (lface_id_to_name
, sz
);
4114 lface_id_to_name_size
= new_size
;
4117 lface_id_to_name
[next_lface_id
] = face
;
4118 Fput (face
, Qface
, make_number (next_lface_id
));
4122 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
4123 AREF (global_lface
, i
) = Qunspecified
;
4125 /* Add a frame-local definition. */
4130 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
4132 AREF (lface
, 0) = Qface
;
4133 f
->face_alist
= Fcons (Fcons (face
, lface
), f
->face_alist
);
4136 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
4137 AREF (lface
, i
) = Qunspecified
;
4140 lface
= global_lface
;
4142 /* Changing a named face means that all realized faces depending on
4143 that face are invalid. Since we cannot tell which realized faces
4144 depend on the face, make sure they are all removed. This is done
4145 by incrementing face_change_count. The next call to
4146 init_iterator will then free realized faces. */
4147 if (NILP (Fget (face
, Qface_no_inherit
)))
4149 ++face_change_count
;
4150 ++windows_or_buffers_changed
;
4153 xassert (LFACEP (lface
));
4154 check_lface (lface
);
4159 DEFUN ("internal-lisp-face-p", Finternal_lisp_face_p
,
4160 Sinternal_lisp_face_p
, 1, 2, 0,
4161 doc
: /* Return non-nil if FACE names a face.
4162 If optional second argument FRAME is non-nil, check for the
4163 existence of a frame-local face with name FACE on that frame.
4164 Otherwise check for the existence of a global face. */)
4166 Lisp_Object face
, frame
;
4172 CHECK_LIVE_FRAME (frame
);
4173 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
4176 lface
= lface_from_face_name (NULL
, face
, 0);
4182 DEFUN ("internal-copy-lisp-face", Finternal_copy_lisp_face
,
4183 Sinternal_copy_lisp_face
, 4, 4, 0,
4184 doc
: /* Copy face FROM to TO.
4185 If FRAME is t, copy the global face definition of FROM.
4186 Otherwise, copy the frame-local definition of FROM on FRAME.
4187 If NEW-FRAME is a frame, copy that data into the frame-local
4188 definition of TO on NEW-FRAME. If NEW-FRAME is nil.
4189 FRAME controls where the data is copied to.
4191 The value is TO. */)
4192 (from
, to
, frame
, new_frame
)
4193 Lisp_Object from
, to
, frame
, new_frame
;
4195 Lisp_Object lface
, copy
;
4197 CHECK_SYMBOL (from
);
4202 /* Copy global definition of FROM. We don't make copies of
4203 strings etc. because 20.2 didn't do it either. */
4204 lface
= lface_from_face_name (NULL
, from
, 1);
4205 copy
= Finternal_make_lisp_face (to
, Qnil
);
4209 /* Copy frame-local definition of FROM. */
4210 if (NILP (new_frame
))
4212 CHECK_LIVE_FRAME (frame
);
4213 CHECK_LIVE_FRAME (new_frame
);
4214 lface
= lface_from_face_name (XFRAME (frame
), from
, 1);
4215 copy
= Finternal_make_lisp_face (to
, new_frame
);
4218 bcopy (XVECTOR (lface
)->contents
, XVECTOR (copy
)->contents
,
4219 LFACE_VECTOR_SIZE
* sizeof (Lisp_Object
));
4221 /* Changing a named face means that all realized faces depending on
4222 that face are invalid. Since we cannot tell which realized faces
4223 depend on the face, make sure they are all removed. This is done
4224 by incrementing face_change_count. The next call to
4225 init_iterator will then free realized faces. */
4226 if (NILP (Fget (to
, Qface_no_inherit
)))
4228 ++face_change_count
;
4229 ++windows_or_buffers_changed
;
4236 DEFUN ("internal-set-lisp-face-attribute", Finternal_set_lisp_face_attribute
,
4237 Sinternal_set_lisp_face_attribute
, 3, 4, 0,
4238 doc
: /* Set attribute ATTR of FACE to VALUE.
4239 FRAME being a frame means change the face on that frame.
4240 FRAME nil means change the face of the selected frame.
4241 FRAME t means change the default for new frames.
4242 FRAME 0 means change the face on all frames, and change the default
4244 (face
, attr
, value
, frame
)
4245 Lisp_Object face
, attr
, value
, frame
;
4248 Lisp_Object old_value
= Qnil
;
4249 /* Set 1 if ATTR is QCfont. */
4250 int font_attr_p
= 0;
4251 /* Set 1 if ATTR is one of font-related attributes other than QCfont. */
4252 int font_related_attr_p
= 0;
4254 CHECK_SYMBOL (face
);
4255 CHECK_SYMBOL (attr
);
4257 face
= resolve_face_name (face
, 1);
4259 /* If FRAME is 0, change face on all frames, and change the
4260 default for new frames. */
4261 if (INTEGERP (frame
) && XINT (frame
) == 0)
4264 Finternal_set_lisp_face_attribute (face
, attr
, value
, Qt
);
4265 FOR_EACH_FRAME (tail
, frame
)
4266 Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
4270 /* Set lface to the Lisp attribute vector of FACE. */
4273 lface
= lface_from_face_name (NULL
, face
, 1);
4275 /* When updating face-new-frame-defaults, we put :ignore-defface
4276 where the caller wants `unspecified'. This forces the frame
4277 defaults to ignore the defface value. Otherwise, the defface
4278 will take effect, which is generally not what is intended.
4279 The value of that attribute will be inherited from some other
4280 face during face merging. See internal_merge_in_global_face. */
4281 if (UNSPECIFIEDP (value
))
4282 value
= Qignore_defface
;
4287 frame
= selected_frame
;
4289 CHECK_LIVE_FRAME (frame
);
4290 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
4292 /* If a frame-local face doesn't exist yet, create one. */
4294 lface
= Finternal_make_lisp_face (face
, frame
);
4297 if (EQ (attr
, QCfamily
))
4299 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4301 CHECK_STRING (value
);
4302 if (SCHARS (value
) == 0)
4303 signal_error ("Invalid face family", value
);
4305 old_value
= LFACE_FAMILY (lface
);
4306 LFACE_FAMILY (lface
) = value
;
4307 font_related_attr_p
= 1;
4309 else if (EQ (attr
, QCheight
))
4311 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4315 test
= (EQ (face
, Qdefault
)
4317 /* The default face must have an absolute size,
4318 otherwise, we do a test merge with a random
4319 height to see if VALUE's ok. */
4320 : merge_face_heights (value
, make_number (10), Qnil
));
4322 if (!INTEGERP (test
) || XINT (test
) <= 0)
4323 signal_error ("Invalid face height", value
);
4326 old_value
= LFACE_HEIGHT (lface
);
4327 LFACE_HEIGHT (lface
) = value
;
4328 font_related_attr_p
= 1;
4330 else if (EQ (attr
, QCweight
))
4332 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4334 CHECK_SYMBOL (value
);
4335 if (face_numeric_weight (value
) < 0)
4336 signal_error ("Invalid face weight", value
);
4338 old_value
= LFACE_WEIGHT (lface
);
4339 LFACE_WEIGHT (lface
) = value
;
4340 font_related_attr_p
= 1;
4342 else if (EQ (attr
, QCslant
))
4344 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4346 CHECK_SYMBOL (value
);
4347 if (face_numeric_slant (value
) < 0)
4348 signal_error ("Invalid face slant", value
);
4350 old_value
= LFACE_SLANT (lface
);
4351 LFACE_SLANT (lface
) = value
;
4352 font_related_attr_p
= 1;
4354 else if (EQ (attr
, QCunderline
))
4356 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4357 if ((SYMBOLP (value
)
4359 && !EQ (value
, Qnil
))
4360 /* Underline color. */
4362 && SCHARS (value
) == 0))
4363 signal_error ("Invalid face underline", value
);
4365 old_value
= LFACE_UNDERLINE (lface
);
4366 LFACE_UNDERLINE (lface
) = value
;
4368 else if (EQ (attr
, QCoverline
))
4370 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4371 if ((SYMBOLP (value
)
4373 && !EQ (value
, Qnil
))
4374 /* Overline color. */
4376 && SCHARS (value
) == 0))
4377 signal_error ("Invalid face overline", value
);
4379 old_value
= LFACE_OVERLINE (lface
);
4380 LFACE_OVERLINE (lface
) = value
;
4382 else if (EQ (attr
, QCstrike_through
))
4384 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4385 if ((SYMBOLP (value
)
4387 && !EQ (value
, Qnil
))
4388 /* Strike-through color. */
4390 && SCHARS (value
) == 0))
4391 signal_error ("Invalid face strike-through", value
);
4393 old_value
= LFACE_STRIKE_THROUGH (lface
);
4394 LFACE_STRIKE_THROUGH (lface
) = value
;
4396 else if (EQ (attr
, QCbox
))
4400 /* Allow t meaning a simple box of width 1 in foreground color
4403 value
= make_number (1);
4405 if (UNSPECIFIEDP (value
) || IGNORE_DEFFACE_P (value
))
4407 else if (NILP (value
))
4409 else if (INTEGERP (value
))
4410 valid_p
= XINT (value
) != 0;
4411 else if (STRINGP (value
))
4412 valid_p
= SCHARS (value
) > 0;
4413 else if (CONSP (value
))
4429 if (EQ (k
, QCline_width
))
4431 if (!INTEGERP (v
) || XINT (v
) == 0)
4434 else if (EQ (k
, QCcolor
))
4436 if (!NILP (v
) && (!STRINGP (v
) || SCHARS (v
) == 0))
4439 else if (EQ (k
, QCstyle
))
4441 if (!EQ (v
, Qpressed_button
) && !EQ (v
, Qreleased_button
))
4448 valid_p
= NILP (tem
);
4454 signal_error ("Invalid face box", value
);
4456 old_value
= LFACE_BOX (lface
);
4457 LFACE_BOX (lface
) = value
;
4459 else if (EQ (attr
, QCinverse_video
)
4460 || EQ (attr
, QCreverse_video
))
4462 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4464 CHECK_SYMBOL (value
);
4465 if (!EQ (value
, Qt
) && !NILP (value
))
4466 signal_error ("Invalid inverse-video face attribute value", value
);
4468 old_value
= LFACE_INVERSE (lface
);
4469 LFACE_INVERSE (lface
) = value
;
4471 else if (EQ (attr
, QCforeground
))
4473 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4475 /* Don't check for valid color names here because it depends
4476 on the frame (display) whether the color will be valid
4477 when the face is realized. */
4478 CHECK_STRING (value
);
4479 if (SCHARS (value
) == 0)
4480 signal_error ("Empty foreground color value", value
);
4482 old_value
= LFACE_FOREGROUND (lface
);
4483 LFACE_FOREGROUND (lface
) = value
;
4485 else if (EQ (attr
, QCbackground
))
4487 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4489 /* Don't check for valid color names here because it depends
4490 on the frame (display) whether the color will be valid
4491 when the face is realized. */
4492 CHECK_STRING (value
);
4493 if (SCHARS (value
) == 0)
4494 signal_error ("Empty background color value", value
);
4496 old_value
= LFACE_BACKGROUND (lface
);
4497 LFACE_BACKGROUND (lface
) = value
;
4499 else if (EQ (attr
, QCstipple
))
4501 #ifdef HAVE_X_WINDOWS
4502 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
)
4504 && NILP (Fbitmap_spec_p (value
)))
4505 signal_error ("Invalid stipple attribute", value
);
4506 old_value
= LFACE_STIPPLE (lface
);
4507 LFACE_STIPPLE (lface
) = value
;
4508 #endif /* HAVE_X_WINDOWS */
4510 else if (EQ (attr
, QCwidth
))
4512 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4514 CHECK_SYMBOL (value
);
4515 if (face_numeric_swidth (value
) < 0)
4516 signal_error ("Invalid face width", value
);
4518 old_value
= LFACE_SWIDTH (lface
);
4519 LFACE_SWIDTH (lface
) = value
;
4520 font_related_attr_p
= 1;
4522 else if (EQ (attr
, QCfont
) || EQ (attr
, QCfontset
))
4524 #ifdef HAVE_WINDOW_SYSTEM
4525 if (EQ (frame
, Qt
) || FRAME_WINDOW_P (XFRAME (frame
)))
4527 /* Set font-related attributes of the Lisp face from an XLFD
4533 f
= SELECTED_FRAME ();
4535 f
= check_x_frame (frame
);
4537 #ifdef USE_FONT_BACKEND
4538 if (enable_font_backend
4539 && !UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4543 if (EQ (attr
, QCfontset
))
4545 Lisp_Object fontset_name
= Fquery_fontset (value
, Qnil
);
4547 if (NILP (fontset_name
))
4548 signal_error ("Invalid fontset name", value
);
4549 LFACE_FONTSET (lface
) = value
;
4553 Lisp_Object font_object
;
4555 if (FONT_OBJECT_P (value
))
4557 font_object
= value
;
4558 fontset
= FRAME_FONTSET (f
);
4562 CHECK_STRING (value
);
4564 fontset
= fs_query_fontset (value
, 0);
4566 value
= fontset_ascii (fontset
);
4568 fontset
= FRAME_FONTSET (f
);
4569 font_object
= font_open_by_name (f
, SDATA (value
));
4570 if (NILP (font_object
))
4571 signal_error ("Invalid font", value
);
4573 set_lface_from_font_and_fontset (f
, lface
, font_object
,
4578 #endif /* USE_FONT_BACKEND */
4579 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4581 CHECK_STRING (value
);
4583 /* VALUE may be a fontset name or an alias of fontset. In
4584 such a case, use the base fontset name. */
4585 tmp
= Fquery_fontset (value
, Qnil
);
4588 else if (EQ (attr
, QCfontset
))
4589 signal_error ("Invalid fontset name", value
);
4591 if (EQ (attr
, QCfont
))
4593 if (!set_lface_from_font_name (f
, lface
, value
, 1, 1))
4594 signal_error ("Invalid font or fontset name", value
);
4597 LFACE_FONTSET (lface
) = value
;
4602 #endif /* HAVE_WINDOW_SYSTEM */
4604 else if (EQ (attr
, QCinherit
))
4607 if (SYMBOLP (value
))
4610 for (tail
= value
; CONSP (tail
); tail
= XCDR (tail
))
4611 if (!SYMBOLP (XCAR (tail
)))
4614 LFACE_INHERIT (lface
) = value
;
4616 signal_error ("Invalid face inheritance", value
);
4618 else if (EQ (attr
, QCbold
))
4620 old_value
= LFACE_WEIGHT (lface
);
4621 LFACE_WEIGHT (lface
) = NILP (value
) ? Qnormal
: Qbold
;
4622 font_related_attr_p
= 1;
4624 else if (EQ (attr
, QCitalic
))
4626 old_value
= LFACE_SLANT (lface
);
4627 LFACE_SLANT (lface
) = NILP (value
) ? Qnormal
: Qitalic
;
4628 font_related_attr_p
= 1;
4631 signal_error ("Invalid face attribute name", attr
);
4633 if (font_related_attr_p
4634 && !UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4635 /* If a font-related attribute other than QCfont is specified, the
4636 original `font' attribute nor that of default face is useless
4637 to determine a new font. Thus, we set it to nil so that font
4638 selection mechanism doesn't use it. */
4639 LFACE_FONT (lface
) = Qnil
;
4641 /* Changing a named face means that all realized faces depending on
4642 that face are invalid. Since we cannot tell which realized faces
4643 depend on the face, make sure they are all removed. This is done
4644 by incrementing face_change_count. The next call to
4645 init_iterator will then free realized faces. */
4647 && NILP (Fget (face
, Qface_no_inherit
))
4648 && (EQ (attr
, QCfont
)
4649 || EQ (attr
, QCfontset
)
4650 || NILP (Fequal (old_value
, value
))))
4652 ++face_change_count
;
4653 ++windows_or_buffers_changed
;
4656 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
)
4657 && NILP (Fequal (old_value
, value
)))
4663 if (EQ (face
, Qdefault
))
4665 #ifdef HAVE_WINDOW_SYSTEM
4666 /* Changed font-related attributes of the `default' face are
4667 reflected in changed `font' frame parameters. */
4669 && (font_related_attr_p
|| font_attr_p
)
4670 && lface_fully_specified_p (XVECTOR (lface
)->contents
))
4671 set_font_frame_param (frame
, lface
);
4673 #endif /* HAVE_WINDOW_SYSTEM */
4675 if (EQ (attr
, QCforeground
))
4676 param
= Qforeground_color
;
4677 else if (EQ (attr
, QCbackground
))
4678 param
= Qbackground_color
;
4680 #ifdef HAVE_WINDOW_SYSTEM
4682 else if (EQ (face
, Qscroll_bar
))
4684 /* Changing the colors of `scroll-bar' sets frame parameters
4685 `scroll-bar-foreground' and `scroll-bar-background'. */
4686 if (EQ (attr
, QCforeground
))
4687 param
= Qscroll_bar_foreground
;
4688 else if (EQ (attr
, QCbackground
))
4689 param
= Qscroll_bar_background
;
4691 #endif /* not WINDOWSNT */
4692 else if (EQ (face
, Qborder
))
4694 /* Changing background color of `border' sets frame parameter
4696 if (EQ (attr
, QCbackground
))
4697 param
= Qborder_color
;
4699 else if (EQ (face
, Qcursor
))
4701 /* Changing background color of `cursor' sets frame parameter
4703 if (EQ (attr
, QCbackground
))
4704 param
= Qcursor_color
;
4706 else if (EQ (face
, Qmouse
))
4708 /* Changing background color of `mouse' sets frame parameter
4710 if (EQ (attr
, QCbackground
))
4711 param
= Qmouse_color
;
4713 #endif /* HAVE_WINDOW_SYSTEM */
4714 else if (EQ (face
, Qmenu
))
4716 /* Indicate that we have to update the menu bar when
4717 realizing faces on FRAME. FRAME t change the
4718 default for new frames. We do this by setting
4719 setting the flag in new face caches */
4722 struct frame
*f
= XFRAME (frame
);
4723 if (FRAME_FACE_CACHE (f
) == NULL
)
4724 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
4725 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 1;
4728 menu_face_changed_default
= 1;
4734 /* Update `default-frame-alist', which is used for new frames. */
4736 store_in_alist (&Vdefault_frame_alist
, param
, value
);
4739 /* Update the current frame's parameters. */
4742 cons
= XCAR (Vparam_value_alist
);
4743 XSETCAR (cons
, param
);
4744 XSETCDR (cons
, value
);
4745 Fmodify_frame_parameters (frame
, Vparam_value_alist
);
4754 #ifdef HAVE_WINDOW_SYSTEM
4756 /* Set the `font' frame parameter of FRAME determined from `default'
4757 face attributes LFACE. If a font name is explicitely
4758 specfied in LFACE, use it as is. Otherwise, determine a font name
4759 from the other font-related atrributes of LFACE. In that case, if
4760 there's no matching font, signals an error. */
4763 set_font_frame_param (frame
, lface
)
4764 Lisp_Object frame
, lface
;
4766 struct frame
*f
= XFRAME (frame
);
4768 if (FRAME_WINDOW_P (f
))
4770 Lisp_Object font_name
;
4773 if (STRINGP (LFACE_FONT (lface
)))
4774 font_name
= LFACE_FONT (lface
);
4775 #ifdef USE_FONT_BACKEND
4776 else if (enable_font_backend
)
4778 /* We set FONT_NAME to a font-object. */
4779 if (FONT_OBJECT_P (LFACE_FONT (lface
)))
4780 font_name
= LFACE_FONT (lface
);
4783 font_name
= font_find_for_lface (f
, &AREF (lface
, 0), Qnil
);
4784 if (NILP (font_name
))
4785 error ("No font matches the specified attribute");
4786 font_name
= font_open_for_lface (f
, &AREF (lface
, 0), font_name
);
4787 if (NILP (font_name
))
4788 error ("No font matches the specified attribute");
4794 /* Choose a font name that reflects LFACE's attributes and has
4795 the registry and encoding pattern specified in the default
4796 fontset (3rd arg: -1) for ASCII characters (4th arg: 0). */
4797 font
= choose_face_font (f
, XVECTOR (lface
)->contents
, Qnil
, NULL
);
4799 error ("No font matches the specified attribute");
4800 font_name
= build_string (font
);
4804 f
->default_face_done_p
= 0;
4805 Fmodify_frame_parameters (frame
, Fcons (Fcons (Qfont
, font_name
), Qnil
));
4810 /* Update the corresponding face when frame parameter PARAM on frame F
4811 has been assigned the value NEW_VALUE. */
4814 update_face_from_frame_parameter (f
, param
, new_value
)
4816 Lisp_Object param
, new_value
;
4818 Lisp_Object face
= Qnil
;
4821 /* If there are no faces yet, give up. This is the case when called
4822 from Fx_create_frame, and we do the necessary things later in
4823 face-set-after-frame-defaults. */
4824 if (NILP (f
->face_alist
))
4827 if (EQ (param
, Qforeground_color
))
4830 lface
= lface_from_face_name (f
, face
, 1);
4831 LFACE_FOREGROUND (lface
) = (STRINGP (new_value
)
4832 ? new_value
: Qunspecified
);
4833 realize_basic_faces (f
);
4835 else if (EQ (param
, Qbackground_color
))
4839 /* Changing the background color might change the background
4840 mode, so that we have to load new defface specs.
4841 Call frame-set-background-mode to do that. */
4842 XSETFRAME (frame
, f
);
4843 call1 (Qframe_set_background_mode
, frame
);
4846 lface
= lface_from_face_name (f
, face
, 1);
4847 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4848 ? new_value
: Qunspecified
);
4849 realize_basic_faces (f
);
4851 else if (EQ (param
, Qborder_color
))
4854 lface
= lface_from_face_name (f
, face
, 1);
4855 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4856 ? new_value
: Qunspecified
);
4858 else if (EQ (param
, Qcursor_color
))
4861 lface
= lface_from_face_name (f
, face
, 1);
4862 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4863 ? new_value
: Qunspecified
);
4865 else if (EQ (param
, Qmouse_color
))
4868 lface
= lface_from_face_name (f
, face
, 1);
4869 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4870 ? new_value
: Qunspecified
);
4873 /* Changing a named face means that all realized faces depending on
4874 that face are invalid. Since we cannot tell which realized faces
4875 depend on the face, make sure they are all removed. This is done
4876 by incrementing face_change_count. The next call to
4877 init_iterator will then free realized faces. */
4879 && NILP (Fget (face
, Qface_no_inherit
)))
4881 ++face_change_count
;
4882 ++windows_or_buffers_changed
;
4887 /* Get the value of X resource RESOURCE, class CLASS for the display
4888 of frame FRAME. This is here because ordinary `x-get-resource'
4889 doesn't take a frame argument. */
4891 DEFUN ("internal-face-x-get-resource", Finternal_face_x_get_resource
,
4892 Sinternal_face_x_get_resource
, 3, 3, 0, doc
: /* */)
4893 (resource
, class, frame
)
4894 Lisp_Object resource
, class, frame
;
4896 Lisp_Object value
= Qnil
;
4897 CHECK_STRING (resource
);
4898 CHECK_STRING (class);
4899 CHECK_LIVE_FRAME (frame
);
4901 value
= display_x_get_resource (FRAME_X_DISPLAY_INFO (XFRAME (frame
)),
4902 resource
, class, Qnil
, Qnil
);
4908 /* Return resource string VALUE as a boolean value, i.e. nil, or t.
4909 If VALUE is "on" or "true", return t. If VALUE is "off" or
4910 "false", return nil. Otherwise, if SIGNAL_P is non-zero, signal an
4911 error; if SIGNAL_P is zero, return 0. */
4914 face_boolean_x_resource_value (value
, signal_p
)
4918 Lisp_Object result
= make_number (0);
4920 xassert (STRINGP (value
));
4922 if (xstricmp (SDATA (value
), "on") == 0
4923 || xstricmp (SDATA (value
), "true") == 0)
4925 else if (xstricmp (SDATA (value
), "off") == 0
4926 || xstricmp (SDATA (value
), "false") == 0)
4928 else if (xstricmp (SDATA (value
), "unspecified") == 0)
4929 result
= Qunspecified
;
4931 signal_error ("Invalid face attribute value from X resource", value
);
4937 DEFUN ("internal-set-lisp-face-attribute-from-resource",
4938 Finternal_set_lisp_face_attribute_from_resource
,
4939 Sinternal_set_lisp_face_attribute_from_resource
,
4940 3, 4, 0, doc
: /* */)
4941 (face
, attr
, value
, frame
)
4942 Lisp_Object face
, attr
, value
, frame
;
4944 CHECK_SYMBOL (face
);
4945 CHECK_SYMBOL (attr
);
4946 CHECK_STRING (value
);
4948 if (xstricmp (SDATA (value
), "unspecified") == 0)
4949 value
= Qunspecified
;
4950 else if (EQ (attr
, QCheight
))
4952 value
= Fstring_to_number (value
, make_number (10));
4953 if (XINT (value
) <= 0)
4954 signal_error ("Invalid face height from X resource", value
);
4956 else if (EQ (attr
, QCbold
) || EQ (attr
, QCitalic
))
4957 value
= face_boolean_x_resource_value (value
, 1);
4958 else if (EQ (attr
, QCweight
) || EQ (attr
, QCslant
) || EQ (attr
, QCwidth
))
4959 value
= intern (SDATA (value
));
4960 else if (EQ (attr
, QCreverse_video
) || EQ (attr
, QCinverse_video
))
4961 value
= face_boolean_x_resource_value (value
, 1);
4962 else if (EQ (attr
, QCunderline
)
4963 || EQ (attr
, QCoverline
)
4964 || EQ (attr
, QCstrike_through
))
4966 Lisp_Object boolean_value
;
4968 /* If the result of face_boolean_x_resource_value is t or nil,
4969 VALUE does NOT specify a color. */
4970 boolean_value
= face_boolean_x_resource_value (value
, 0);
4971 if (SYMBOLP (boolean_value
))
4972 value
= boolean_value
;
4974 else if (EQ (attr
, QCbox
) || EQ (attr
, QCinherit
))
4975 value
= Fcar (Fread_from_string (value
, Qnil
, Qnil
));
4977 return Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
4980 #endif /* HAVE_WINDOW_SYSTEM */
4983 /***********************************************************************
4985 ***********************************************************************/
4987 #if defined HAVE_X_WINDOWS && defined USE_X_TOOLKIT
4989 /* Make menus on frame F appear as specified by the `menu' face. */
4992 x_update_menu_appearance (f
)
4995 struct x_display_info
*dpyinfo
= FRAME_X_DISPLAY_INFO (f
);
4999 && (rdb
= XrmGetDatabase (FRAME_X_DISPLAY (f
)),
5003 Lisp_Object lface
= lface_from_face_name (f
, Qmenu
, 1);
5004 struct face
*face
= FACE_FROM_ID (f
, MENU_FACE_ID
);
5005 const char *myname
= SDATA (Vx_resource_name
);
5008 const char *popup_path
= "popup_menu";
5010 const char *popup_path
= "menu.popup";
5013 if (STRINGP (LFACE_FOREGROUND (lface
)))
5015 sprintf (line
, "%s.%s*foreground: %s",
5017 SDATA (LFACE_FOREGROUND (lface
)));
5018 XrmPutLineResource (&rdb
, line
);
5019 sprintf (line
, "%s.pane.menubar*foreground: %s",
5020 myname
, SDATA (LFACE_FOREGROUND (lface
)));
5021 XrmPutLineResource (&rdb
, line
);
5025 if (STRINGP (LFACE_BACKGROUND (lface
)))
5027 sprintf (line
, "%s.%s*background: %s",
5029 SDATA (LFACE_BACKGROUND (lface
)));
5030 XrmPutLineResource (&rdb
, line
);
5031 sprintf (line
, "%s.pane.menubar*background: %s",
5032 myname
, SDATA (LFACE_BACKGROUND (lface
)));
5033 XrmPutLineResource (&rdb
, line
);
5038 && (!UNSPECIFIEDP (LFACE_FAMILY (lface
))
5039 || !UNSPECIFIEDP (LFACE_SWIDTH (lface
))
5040 || !UNSPECIFIEDP (LFACE_AVGWIDTH (lface
))
5041 || !UNSPECIFIEDP (LFACE_WEIGHT (lface
))
5042 || !UNSPECIFIEDP (LFACE_SLANT (lface
))
5043 || !UNSPECIFIEDP (LFACE_HEIGHT (lface
))))
5046 const char *suffix
= "List";
5049 #if defined HAVE_X_I18N
5051 const char *suffix
= "Set";
5053 const char *suffix
= "";
5057 #if defined HAVE_X_I18N
5058 extern char *xic_create_fontsetname
5059 P_ ((char *base_fontname
, Bool motif
));
5060 char *fontsetname
= xic_create_fontsetname (face
->font_name
, motif
);
5062 char *fontsetname
= face
->font_name
;
5064 sprintf (line
, "%s.pane.menubar*font%s: %s",
5065 myname
, suffix
, fontsetname
);
5066 XrmPutLineResource (&rdb
, line
);
5067 sprintf (line
, "%s.%s*font%s: %s",
5068 myname
, popup_path
, suffix
, fontsetname
);
5069 XrmPutLineResource (&rdb
, line
);
5071 if (fontsetname
!= face
->font_name
)
5072 xfree (fontsetname
);
5075 if (changed_p
&& f
->output_data
.x
->menubar_widget
)
5076 free_frame_menubar (f
);
5080 #endif /* HAVE_X_WINDOWS && USE_X_TOOLKIT */
5083 DEFUN ("face-attribute-relative-p", Fface_attribute_relative_p
,
5084 Sface_attribute_relative_p
,
5086 doc
: /* Check whether a face attribute value is relative.
5087 Specifically, this function returns t if the attribute ATTRIBUTE
5088 with the value VALUE is relative.
5090 A relative value is one that doesn't entirely override whatever is
5091 inherited from another face. For most possible attributes,
5092 the only relative value that users see is `unspecified'.
5093 However, for :height, floating point values are also relative. */)
5095 Lisp_Object attribute
, value
;
5097 if (EQ (value
, Qunspecified
) || (EQ (value
, Qignore_defface
)))
5099 else if (EQ (attribute
, QCheight
))
5100 return INTEGERP (value
) ? Qnil
: Qt
;
5105 DEFUN ("merge-face-attribute", Fmerge_face_attribute
, Smerge_face_attribute
,
5107 doc
: /* Return face ATTRIBUTE VALUE1 merged with VALUE2.
5108 If VALUE1 or VALUE2 are absolute (see `face-attribute-relative-p'), then
5109 the result will be absolute, otherwise it will be relative. */)
5110 (attribute
, value1
, value2
)
5111 Lisp_Object attribute
, value1
, value2
;
5113 if (EQ (value1
, Qunspecified
) || EQ (value1
, Qignore_defface
))
5115 else if (EQ (attribute
, QCheight
))
5116 return merge_face_heights (value1
, value2
, value1
);
5122 DEFUN ("internal-get-lisp-face-attribute", Finternal_get_lisp_face_attribute
,
5123 Sinternal_get_lisp_face_attribute
,
5125 doc
: /* Return face attribute KEYWORD of face SYMBOL.
5126 If SYMBOL does not name a valid Lisp face or KEYWORD isn't a valid
5127 face attribute name, signal an error.
5128 If the optional argument FRAME is given, report on face SYMBOL in that
5129 frame. If FRAME is t, report on the defaults for face SYMBOL (for new
5130 frames). If FRAME is omitted or nil, use the selected frame. */)
5131 (symbol
, keyword
, frame
)
5132 Lisp_Object symbol
, keyword
, frame
;
5134 Lisp_Object lface
, value
= Qnil
;
5136 CHECK_SYMBOL (symbol
);
5137 CHECK_SYMBOL (keyword
);
5140 lface
= lface_from_face_name (NULL
, symbol
, 1);
5144 frame
= selected_frame
;
5145 CHECK_LIVE_FRAME (frame
);
5146 lface
= lface_from_face_name (XFRAME (frame
), symbol
, 1);
5149 if (EQ (keyword
, QCfamily
))
5150 value
= LFACE_FAMILY (lface
);
5151 else if (EQ (keyword
, QCheight
))
5152 value
= LFACE_HEIGHT (lface
);
5153 else if (EQ (keyword
, QCweight
))
5154 value
= LFACE_WEIGHT (lface
);
5155 else if (EQ (keyword
, QCslant
))
5156 value
= LFACE_SLANT (lface
);
5157 else if (EQ (keyword
, QCunderline
))
5158 value
= LFACE_UNDERLINE (lface
);
5159 else if (EQ (keyword
, QCoverline
))
5160 value
= LFACE_OVERLINE (lface
);
5161 else if (EQ (keyword
, QCstrike_through
))
5162 value
= LFACE_STRIKE_THROUGH (lface
);
5163 else if (EQ (keyword
, QCbox
))
5164 value
= LFACE_BOX (lface
);
5165 else if (EQ (keyword
, QCinverse_video
)
5166 || EQ (keyword
, QCreverse_video
))
5167 value
= LFACE_INVERSE (lface
);
5168 else if (EQ (keyword
, QCforeground
))
5169 value
= LFACE_FOREGROUND (lface
);
5170 else if (EQ (keyword
, QCbackground
))
5171 value
= LFACE_BACKGROUND (lface
);
5172 else if (EQ (keyword
, QCstipple
))
5173 value
= LFACE_STIPPLE (lface
);
5174 else if (EQ (keyword
, QCwidth
))
5175 value
= LFACE_SWIDTH (lface
);
5176 else if (EQ (keyword
, QCinherit
))
5177 value
= LFACE_INHERIT (lface
);
5178 else if (EQ (keyword
, QCfont
))
5179 value
= LFACE_FONT (lface
);
5180 else if (EQ (keyword
, QCfontset
))
5181 value
= LFACE_FONTSET (lface
);
5183 signal_error ("Invalid face attribute name", keyword
);
5185 if (IGNORE_DEFFACE_P (value
))
5186 return Qunspecified
;
5192 DEFUN ("internal-lisp-face-attribute-values",
5193 Finternal_lisp_face_attribute_values
,
5194 Sinternal_lisp_face_attribute_values
, 1, 1, 0,
5195 doc
: /* Return a list of valid discrete values for face attribute ATTR.
5196 Value is nil if ATTR doesn't have a discrete set of valid values. */)
5200 Lisp_Object result
= Qnil
;
5202 CHECK_SYMBOL (attr
);
5204 if (EQ (attr
, QCweight
)
5205 || EQ (attr
, QCslant
)
5206 || EQ (attr
, QCwidth
))
5208 /* Extract permissible symbols from tables. */
5209 struct table_entry
*table
;
5212 if (EQ (attr
, QCweight
))
5213 table
= weight_table
, dim
= DIM (weight_table
);
5214 else if (EQ (attr
, QCslant
))
5215 table
= slant_table
, dim
= DIM (slant_table
);
5217 table
= swidth_table
, dim
= DIM (swidth_table
);
5219 for (i
= 0; i
< dim
; ++i
)
5221 Lisp_Object symbol
= *table
[i
].symbol
;
5222 Lisp_Object tail
= result
;
5225 && !EQ (XCAR (tail
), symbol
))
5229 result
= Fcons (symbol
, result
);
5232 else if (EQ (attr
, QCunderline
))
5233 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
5234 else if (EQ (attr
, QCoverline
))
5235 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
5236 else if (EQ (attr
, QCstrike_through
))
5237 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
5238 else if (EQ (attr
, QCinverse_video
) || EQ (attr
, QCreverse_video
))
5239 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
5245 DEFUN ("internal-merge-in-global-face", Finternal_merge_in_global_face
,
5246 Sinternal_merge_in_global_face
, 2, 2, 0,
5247 doc
: /* Add attributes from frame-default definition of FACE to FACE on FRAME.
5248 Default face attributes override any local face attributes. */)
5250 Lisp_Object face
, frame
;
5253 Lisp_Object global_lface
, local_lface
, *gvec
, *lvec
;
5255 CHECK_LIVE_FRAME (frame
);
5256 global_lface
= lface_from_face_name (NULL
, face
, 1);
5257 local_lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
5258 if (NILP (local_lface
))
5259 local_lface
= Finternal_make_lisp_face (face
, frame
);
5261 /* Make every specified global attribute override the local one.
5262 BEWARE!! This is only used from `face-set-after-frame-default' where
5263 the local frame is defined from default specs in `face-defface-spec'
5264 and those should be overridden by global settings. Hence the strange
5265 "global before local" priority. */
5266 lvec
= XVECTOR (local_lface
)->contents
;
5267 gvec
= XVECTOR (global_lface
)->contents
;
5268 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
5269 if (! UNSPECIFIEDP (gvec
[i
]))
5271 if (IGNORE_DEFFACE_P (gvec
[i
]))
5272 lvec
[i
] = Qunspecified
;
5281 /* The following function is implemented for compatibility with 20.2.
5282 The function is used in x-resolve-fonts when it is asked to
5283 return fonts with the same size as the font of a face. This is
5284 done in fontset.el. */
5286 DEFUN ("face-font", Fface_font
, Sface_font
, 1, 3, 0,
5287 doc
: /* Return the font name of face FACE, or nil if it is unspecified.
5288 The font name is, by default, for ASCII characters.
5289 If the optional argument FRAME is given, report on face FACE in that frame.
5290 If FRAME is t, report on the defaults for face FACE (for new frames).
5291 The font default for a face is either nil, or a list
5292 of the form (bold), (italic) or (bold italic).
5293 If FRAME is omitted or nil, use the selected frame. And, in this case,
5294 if the optional third argument CHARACTER is given,
5295 return the font name used for CHARACTER. */)
5296 (face
, frame
, character
)
5297 Lisp_Object face
, frame
, character
;
5301 Lisp_Object result
= Qnil
;
5302 Lisp_Object lface
= lface_from_face_name (NULL
, face
, 1);
5304 if (!UNSPECIFIEDP (LFACE_WEIGHT (lface
))
5305 && !EQ (LFACE_WEIGHT (lface
), Qnormal
))
5306 result
= Fcons (Qbold
, result
);
5308 if (!UNSPECIFIEDP (LFACE_SLANT (lface
))
5309 && !EQ (LFACE_SLANT (lface
), Qnormal
))
5310 result
= Fcons (Qitalic
, result
);
5316 struct frame
*f
= frame_or_selected_frame (frame
, 1);
5317 int face_id
= lookup_named_face (f
, face
, 1);
5318 struct face
*face
= FACE_FROM_ID (f
, face_id
);
5322 #ifdef HAVE_WINDOW_SYSTEM
5323 if (FRAME_WINDOW_P (f
) && !NILP (character
))
5325 CHECK_CHARACTER (character
);
5326 face_id
= FACE_FOR_CHAR (f
, face
, XINT (character
), -1, Qnil
);
5327 face
= FACE_FROM_ID (f
, face_id
);
5328 return (face
->font
&& face
->font_name
5329 ? build_string (face
->font_name
)
5333 return build_string (face
->font_name
);
5338 /* Compare face-attribute values v1 and v2 for equality. Value is non-zero if
5339 all attributes are `equal'. Tries to be fast because this function
5340 is called quite often. */
5343 face_attr_equal_p (v1
, v2
)
5346 /* Type can differ, e.g. when one attribute is unspecified, i.e. nil,
5347 and the other is specified. */
5348 if (XTYPE (v1
) != XTYPE (v2
))
5357 if (SBYTES (v1
) != SBYTES (v2
))
5360 return bcmp (SDATA (v1
), SDATA (v2
), SBYTES (v1
)) == 0;
5367 return !NILP (Fequal (v1
, v2
));
5372 /* Compare face vectors V1 and V2 for equality. Value is non-zero if
5373 all attributes are `equal'. Tries to be fast because this function
5374 is called quite often. */
5377 lface_equal_p (v1
, v2
)
5378 Lisp_Object
*v1
, *v2
;
5382 for (i
= 1; i
< LFACE_VECTOR_SIZE
&& equal_p
; ++i
)
5383 equal_p
= face_attr_equal_p (v1
[i
], v2
[i
]);
5389 DEFUN ("internal-lisp-face-equal-p", Finternal_lisp_face_equal_p
,
5390 Sinternal_lisp_face_equal_p
, 2, 3, 0,
5391 doc
: /* True if FACE1 and FACE2 are equal.
5392 If the optional argument FRAME is given, report on FACE1 and FACE2 in that frame.
5393 If FRAME is t, report on the defaults for FACE1 and FACE2 (for new frames).
5394 If FRAME is omitted or nil, use the selected frame. */)
5395 (face1
, face2
, frame
)
5396 Lisp_Object face1
, face2
, frame
;
5400 Lisp_Object lface1
, lface2
;
5405 /* Don't use check_x_frame here because this function is called
5406 before X frames exist. At that time, if FRAME is nil,
5407 selected_frame will be used which is the frame dumped with
5408 Emacs. That frame is not an X frame. */
5409 f
= frame_or_selected_frame (frame
, 2);
5411 lface1
= lface_from_face_name (f
, face1
, 1);
5412 lface2
= lface_from_face_name (f
, face2
, 1);
5413 equal_p
= lface_equal_p (XVECTOR (lface1
)->contents
,
5414 XVECTOR (lface2
)->contents
);
5415 return equal_p
? Qt
: Qnil
;
5419 DEFUN ("internal-lisp-face-empty-p", Finternal_lisp_face_empty_p
,
5420 Sinternal_lisp_face_empty_p
, 1, 2, 0,
5421 doc
: /* True if FACE has no attribute specified.
5422 If the optional argument FRAME is given, report on face FACE in that frame.
5423 If FRAME is t, report on the defaults for face FACE (for new frames).
5424 If FRAME is omitted or nil, use the selected frame. */)
5426 Lisp_Object face
, frame
;
5433 frame
= selected_frame
;
5434 CHECK_LIVE_FRAME (frame
);
5438 lface
= lface_from_face_name (NULL
, face
, 1);
5440 lface
= lface_from_face_name (f
, face
, 1);
5442 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
5443 if (!UNSPECIFIEDP (AREF (lface
, i
)))
5446 return i
== LFACE_VECTOR_SIZE
? Qt
: Qnil
;
5450 DEFUN ("frame-face-alist", Fframe_face_alist
, Sframe_face_alist
,
5452 doc
: /* Return an alist of frame-local faces defined on FRAME.
5453 For internal use only. */)
5457 struct frame
*f
= frame_or_selected_frame (frame
, 0);
5458 return f
->face_alist
;
5462 /* Return a hash code for Lisp string STRING with case ignored. Used
5463 below in computing a hash value for a Lisp face. */
5465 static INLINE
unsigned
5466 hash_string_case_insensitive (string
)
5469 const unsigned char *s
;
5471 xassert (STRINGP (string
));
5472 for (s
= SDATA (string
); *s
; ++s
)
5473 hash
= (hash
<< 1) ^ tolower (*s
);
5478 /* Return a hash code for face attribute vector V. */
5480 static INLINE
unsigned
5484 return (hash_string_case_insensitive (v
[LFACE_FAMILY_INDEX
])
5485 ^ hash_string_case_insensitive (v
[LFACE_FOREGROUND_INDEX
])
5486 ^ hash_string_case_insensitive (v
[LFACE_BACKGROUND_INDEX
])
5487 ^ XFASTINT (v
[LFACE_WEIGHT_INDEX
])
5488 ^ XFASTINT (v
[LFACE_SLANT_INDEX
])
5489 ^ XFASTINT (v
[LFACE_SWIDTH_INDEX
])
5490 ^ XFASTINT (v
[LFACE_HEIGHT_INDEX
]));
5494 /* Return non-zero if LFACE1 and LFACE2 specify the same font (without
5495 considering charsets/registries). They do if they specify the same
5496 family, point size, weight, width, slant, font, and fontset. Both
5497 LFACE1 and LFACE2 must be fully-specified. */
5500 lface_same_font_attributes_p (lface1
, lface2
)
5501 Lisp_Object
*lface1
, *lface2
;
5503 xassert (lface_fully_specified_p (lface1
)
5504 && lface_fully_specified_p (lface2
));
5505 return (xstricmp (SDATA (lface1
[LFACE_FAMILY_INDEX
]),
5506 SDATA (lface2
[LFACE_FAMILY_INDEX
])) == 0
5507 && EQ (lface1
[LFACE_HEIGHT_INDEX
], lface2
[LFACE_HEIGHT_INDEX
])
5508 && EQ (lface1
[LFACE_SWIDTH_INDEX
], lface2
[LFACE_SWIDTH_INDEX
])
5509 && EQ (lface1
[LFACE_AVGWIDTH_INDEX
], lface2
[LFACE_AVGWIDTH_INDEX
])
5510 && EQ (lface1
[LFACE_WEIGHT_INDEX
], lface2
[LFACE_WEIGHT_INDEX
])
5511 && EQ (lface1
[LFACE_SLANT_INDEX
], lface2
[LFACE_SLANT_INDEX
])
5512 && (EQ (lface1
[LFACE_FONT_INDEX
], lface2
[LFACE_FONT_INDEX
])
5513 || (STRINGP (lface1
[LFACE_FONT_INDEX
])
5514 && STRINGP (lface2
[LFACE_FONT_INDEX
])
5515 && ! xstricmp (SDATA (lface1
[LFACE_FONT_INDEX
]),
5516 SDATA (lface2
[LFACE_FONT_INDEX
]))))
5517 && (EQ (lface1
[LFACE_FONTSET_INDEX
], lface2
[LFACE_FONTSET_INDEX
])
5518 || (STRINGP (lface1
[LFACE_FONTSET_INDEX
])
5519 && STRINGP (lface2
[LFACE_FONTSET_INDEX
])
5520 && ! xstricmp (SDATA (lface1
[LFACE_FONTSET_INDEX
]),
5521 SDATA (lface2
[LFACE_FONTSET_INDEX
]))))
5527 /***********************************************************************
5529 ***********************************************************************/
5531 /* Allocate and return a new realized face for Lisp face attribute
5534 static struct face
*
5535 make_realized_face (attr
)
5538 struct face
*face
= (struct face
*) xmalloc (sizeof *face
);
5539 bzero (face
, sizeof *face
);
5540 face
->ascii_face
= face
;
5541 bcopy (attr
, face
->lface
, sizeof face
->lface
);
5546 /* Free realized face FACE, including its X resources. FACE may
5550 free_realized_face (f
, face
)
5556 #ifdef HAVE_WINDOW_SYSTEM
5557 if (FRAME_WINDOW_P (f
))
5559 /* Free fontset of FACE if it is ASCII face. */
5560 if (face
->fontset
>= 0 && face
== face
->ascii_face
)
5561 free_face_fontset (f
, face
);
5564 #ifdef USE_FONT_BACKEND
5565 if (enable_font_backend
&& face
->font_info
)
5566 font_done_for_face (f
, face
);
5567 #endif /* USE_FONT_BACKEND */
5568 x_free_gc (f
, face
->gc
);
5572 free_face_colors (f
, face
);
5573 x_destroy_bitmap (f
, face
->stipple
);
5575 #endif /* HAVE_WINDOW_SYSTEM */
5582 /* Prepare face FACE for subsequent display on frame F. This
5583 allocated GCs if they haven't been allocated yet or have been freed
5584 by clearing the face cache. */
5587 prepare_face_for_display (f
, face
)
5591 #ifdef HAVE_WINDOW_SYSTEM
5592 xassert (FRAME_WINDOW_P (f
));
5597 unsigned long mask
= GCForeground
| GCBackground
| GCGraphicsExposures
;
5599 xgcv
.foreground
= face
->foreground
;
5600 xgcv
.background
= face
->background
;
5601 #ifdef HAVE_X_WINDOWS
5602 xgcv
.graphics_exposures
= False
;
5604 /* The font of FACE may be null if we couldn't load it. */
5607 #ifdef HAVE_X_WINDOWS
5608 xgcv
.font
= face
->font
->fid
;
5611 xgcv
.font
= face
->font
;
5614 xgcv
.font
= face
->font
;
5620 #ifdef HAVE_X_WINDOWS
5623 xgcv
.fill_style
= FillOpaqueStippled
;
5624 xgcv
.stipple
= x_bitmap_pixmap (f
, face
->stipple
);
5625 mask
|= GCFillStyle
| GCStipple
;
5628 face
->gc
= x_create_gc (f
, mask
, &xgcv
);
5629 #ifdef USE_FONT_BACKEND
5630 if (enable_font_backend
&& face
->font
)
5631 font_prepare_for_face (f
, face
);
5632 #endif /* USE_FONT_BACKEND */
5635 #endif /* HAVE_WINDOW_SYSTEM */
5639 /* Returns the `distance' between the colors X and Y. */
5642 color_distance (x
, y
)
5645 /* This formula is from a paper title `Colour metric' by Thiadmer Riemersma.
5646 Quoting from that paper:
5648 This formula has results that are very close to L*u*v* (with the
5649 modified lightness curve) and, more importantly, it is a more even
5650 algorithm: it does not have a range of colours where it suddenly
5651 gives far from optimal results.
5653 See <http://www.compuphase.com/cmetric.htm> for more info. */
5655 long r
= (x
->red
- y
->red
) >> 8;
5656 long g
= (x
->green
- y
->green
) >> 8;
5657 long b
= (x
->blue
- y
->blue
) >> 8;
5658 long r_mean
= (x
->red
+ y
->red
) >> 9;
5661 (((512 + r_mean
) * r
* r
) >> 8)
5663 + (((767 - r_mean
) * b
* b
) >> 8);
5667 DEFUN ("color-distance", Fcolor_distance
, Scolor_distance
, 2, 3, 0,
5668 doc
: /* Return an integer distance between COLOR1 and COLOR2 on FRAME.
5669 COLOR1 and COLOR2 may be either strings containing the color name,
5670 or lists of the form (RED GREEN BLUE).
5671 If FRAME is unspecified or nil, the current frame is used. */)
5672 (color1
, color2
, frame
)
5673 Lisp_Object color1
, color2
, frame
;
5676 XColor cdef1
, cdef2
;
5679 frame
= selected_frame
;
5680 CHECK_LIVE_FRAME (frame
);
5683 if (!(CONSP (color1
) && parse_rgb_list (color1
, &cdef1
))
5684 && !(STRINGP (color1
) && defined_color (f
, SDATA (color1
), &cdef1
, 0)))
5685 signal_error ("Invalid color", color1
);
5686 if (!(CONSP (color2
) && parse_rgb_list (color2
, &cdef2
))
5687 && !(STRINGP (color2
) && defined_color (f
, SDATA (color2
), &cdef2
, 0)))
5688 signal_error ("Invalid color", color2
);
5690 return make_number (color_distance (&cdef1
, &cdef2
));
5694 /***********************************************************************
5696 ***********************************************************************/
5698 /* Return a new face cache for frame F. */
5700 static struct face_cache
*
5704 struct face_cache
*c
;
5707 c
= (struct face_cache
*) xmalloc (sizeof *c
);
5708 bzero (c
, sizeof *c
);
5709 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5710 c
->buckets
= (struct face
**) xmalloc (size
);
5711 bzero (c
->buckets
, size
);
5713 c
->faces_by_id
= (struct face
**) xmalloc (c
->size
* sizeof *c
->faces_by_id
);
5715 c
->menu_face_changed_p
= menu_face_changed_default
;
5720 /* Clear out all graphics contexts for all realized faces, except for
5721 the basic faces. This should be done from time to time just to avoid
5722 keeping too many graphics contexts that are no longer needed. */
5726 struct face_cache
*c
;
5728 if (c
&& FRAME_WINDOW_P (c
->f
))
5730 #ifdef HAVE_WINDOW_SYSTEM
5732 for (i
= BASIC_FACE_ID_SENTINEL
; i
< c
->used
; ++i
)
5734 struct face
*face
= c
->faces_by_id
[i
];
5735 if (face
&& face
->gc
)
5737 #ifdef USE_FONT_BACKEND
5738 if (enable_font_backend
&& face
->font_info
)
5739 font_done_for_face (c
->f
, face
);
5740 #endif /* USE_FONT_BACKEND */
5741 x_free_gc (c
->f
, face
->gc
);
5745 #endif /* HAVE_WINDOW_SYSTEM */
5750 /* Free all realized faces in face cache C, including basic faces.
5751 C may be null. If faces are freed, make sure the frame's current
5752 matrix is marked invalid, so that a display caused by an expose
5753 event doesn't try to use faces we destroyed. */
5756 free_realized_faces (c
)
5757 struct face_cache
*c
;
5762 struct frame
*f
= c
->f
;
5764 /* We must block input here because we can't process X events
5765 safely while only some faces are freed, or when the frame's
5766 current matrix still references freed faces. */
5769 for (i
= 0; i
< c
->used
; ++i
)
5771 free_realized_face (f
, c
->faces_by_id
[i
]);
5772 c
->faces_by_id
[i
] = NULL
;
5776 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5777 bzero (c
->buckets
, size
);
5779 /* Must do a thorough redisplay the next time. Mark current
5780 matrices as invalid because they will reference faces freed
5781 above. This function is also called when a frame is
5782 destroyed. In this case, the root window of F is nil. */
5783 if (WINDOWP (f
->root_window
))
5785 clear_current_matrices (f
);
5786 ++windows_or_buffers_changed
;
5794 /* Free all realized faces that are using FONTSET on frame F. */
5797 free_realized_faces_for_fontset (f
, fontset
)
5801 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5805 /* We must block input here because we can't process X events safely
5806 while only some faces are freed, or when the frame's current
5807 matrix still references freed faces. */
5810 for (i
= 0; i
< cache
->used
; i
++)
5812 face
= cache
->faces_by_id
[i
];
5814 && face
->fontset
== fontset
)
5816 uncache_face (cache
, face
);
5817 free_realized_face (f
, face
);
5821 /* Must do a thorough redisplay the next time. Mark current
5822 matrices as invalid because they will reference faces freed
5823 above. This function is also called when a frame is destroyed.
5824 In this case, the root window of F is nil. */
5825 if (WINDOWP (f
->root_window
))
5827 clear_current_matrices (f
);
5828 ++windows_or_buffers_changed
;
5835 /* Free all realized faces on FRAME or on all frames if FRAME is nil.
5836 This is done after attributes of a named face have been changed,
5837 because we can't tell which realized faces depend on that face. */
5840 free_all_realized_faces (frame
)
5846 FOR_EACH_FRAME (rest
, frame
)
5847 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5850 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5854 /* Free face cache C and faces in it, including their X resources. */
5858 struct face_cache
*c
;
5862 free_realized_faces (c
);
5864 xfree (c
->faces_by_id
);
5870 /* Cache realized face FACE in face cache C. HASH is the hash value
5871 of FACE. If FACE is for ASCII characters (i.e. FACE->ascii_face ==
5872 FACE), insert the new face to the beginning of the collision list
5873 of the face hash table of C. Otherwise, add the new face to the
5874 end of the collision list. This way, lookup_face can quickly find
5875 that a requested face is not cached. */
5878 cache_face (c
, face
, hash
)
5879 struct face_cache
*c
;
5883 int i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5887 if (face
->ascii_face
!= face
)
5889 struct face
*last
= c
->buckets
[i
];
5900 c
->buckets
[i
] = face
;
5901 face
->prev
= face
->next
= NULL
;
5907 face
->next
= c
->buckets
[i
];
5909 face
->next
->prev
= face
;
5910 c
->buckets
[i
] = face
;
5913 /* Find a free slot in C->faces_by_id and use the index of the free
5914 slot as FACE->id. */
5915 for (i
= 0; i
< c
->used
; ++i
)
5916 if (c
->faces_by_id
[i
] == NULL
)
5920 /* Maybe enlarge C->faces_by_id. */
5923 if (c
->used
== c
->size
)
5926 new_size
= min (2 * c
->size
, MAX_FACE_ID
);
5927 if (new_size
== c
->size
)
5928 abort (); /* Alternatives? ++kfs */
5929 sz
= new_size
* sizeof *c
->faces_by_id
;
5930 c
->faces_by_id
= (struct face
**) xrealloc (c
->faces_by_id
, sz
);
5937 /* Check that FACE got a unique id. */
5942 for (j
= n
= 0; j
< FACE_CACHE_BUCKETS_SIZE
; ++j
)
5943 for (face
= c
->buckets
[j
]; face
; face
= face
->next
)
5949 #endif /* GLYPH_DEBUG */
5951 c
->faces_by_id
[i
] = face
;
5955 /* Remove face FACE from cache C. */
5958 uncache_face (c
, face
)
5959 struct face_cache
*c
;
5962 int i
= face
->hash
% FACE_CACHE_BUCKETS_SIZE
;
5965 face
->prev
->next
= face
->next
;
5967 c
->buckets
[i
] = face
->next
;
5970 face
->next
->prev
= face
->prev
;
5972 c
->faces_by_id
[face
->id
] = NULL
;
5973 if (face
->id
== c
->used
)
5978 /* Look up a realized face with face attributes ATTR in the face cache
5979 of frame F. The face will be used to display ASCII characters.
5980 Value is the ID of the face found. If no suitable face is found,
5981 realize a new one. */
5984 lookup_face (f
, attr
)
5988 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5993 xassert (cache
!= NULL
);
5994 check_lface_attrs (attr
);
5996 /* Look up ATTR in the face cache. */
5997 hash
= lface_hash (attr
);
5998 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
6000 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
6002 if (face
->ascii_face
!= face
)
6004 /* There's no more ASCII face. */
6008 if (face
->hash
== hash
6009 && lface_equal_p (face
->lface
, attr
))
6013 /* If not found, realize a new face. */
6015 face
= realize_face (cache
, attr
, -1);
6018 xassert (face
== FACE_FROM_ID (f
, face
->id
));
6019 #endif /* GLYPH_DEBUG */
6024 #ifdef HAVE_WINDOW_SYSTEM
6025 /* Look up a realized face that has the same attributes as BASE_FACE
6026 except for the font in the face cache of frame F. If FONT_ID is
6027 not negative, it is an ID number of an already opened font that is
6028 used by the face. If FONT_ID is negative, the face has no font.
6029 Value is the ID of the face found. If no suitable face is found,
6030 realize a new one. */
6033 lookup_non_ascii_face (f
, font_id
, base_face
)
6036 struct face
*base_face
;
6038 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
6043 xassert (cache
!= NULL
);
6044 base_face
= base_face
->ascii_face
;
6045 hash
= lface_hash (base_face
->lface
);
6046 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
6048 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
6050 if (face
->ascii_face
== face
)
6052 if (face
->ascii_face
== base_face
6053 && face
->font_info_id
== font_id
)
6057 /* If not found, realize a new face. */
6059 face
= realize_non_ascii_face (f
, font_id
, base_face
);
6062 xassert (face
== FACE_FROM_ID (f
, face
->id
));
6063 #endif /* GLYPH_DEBUG */
6068 #ifdef USE_FONT_BACKEND
6070 face_for_font (f
, font
, base_face
)
6073 struct face
*base_face
;
6075 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
6080 xassert (cache
!= NULL
);
6081 base_face
= base_face
->ascii_face
;
6082 hash
= lface_hash (base_face
->lface
);
6083 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
6085 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
6087 if (face
->ascii_face
== face
)
6089 if (face
->ascii_face
== base_face
6090 && face
->font_info
== (struct font_info
*) font
)
6094 /* If not found, realize a new face. */
6095 face
= realize_non_ascii_face (f
, -1, base_face
);
6096 face
->font
= font
->font
.font
;
6097 face
->font_info
= (struct font_info
*) font
;
6098 face
->font_info_id
= 0;
6099 face
->font_name
= font
->font
.full_name
;
6102 #endif /* USE_FONT_BACKEND */
6104 #endif /* HAVE_WINDOW_SYSTEM */
6106 /* Return the face id of the realized face for named face SYMBOL on
6107 frame F suitable for displaying ASCII characters. Value is -1 if
6108 the face couldn't be determined, which might happen if the default
6109 face isn't realized and cannot be realized. */
6112 lookup_named_face (f
, symbol
, signal_p
)
6117 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6118 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
6119 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6121 if (default_face
== NULL
)
6123 if (!realize_basic_faces (f
))
6125 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6126 if (default_face
== NULL
)
6127 abort (); /* realize_basic_faces must have set it up */
6130 if (!get_lface_attributes (f
, symbol
, symbol_attrs
, signal_p
))
6133 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
6134 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
6136 return lookup_face (f
, attrs
);
6140 /* Return the ID of the realized ASCII face of Lisp face with ID
6141 LFACE_ID on frame F. Value is -1 if LFACE_ID isn't valid. */
6144 ascii_face_of_lisp_face (f
, lface_id
)
6150 if (lface_id
>= 0 && lface_id
< lface_id_to_name_size
)
6152 Lisp_Object face_name
= lface_id_to_name
[lface_id
];
6153 face_id
= lookup_named_face (f
, face_name
, 1);
6162 /* Return a face for charset ASCII that is like the face with id
6163 FACE_ID on frame F, but has a font that is STEPS steps smaller.
6164 STEPS < 0 means larger. Value is the id of the face. */
6167 smaller_face (f
, face_id
, steps
)
6171 #ifdef HAVE_WINDOW_SYSTEM
6173 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6174 int pt
, last_pt
, last_height
;
6177 struct face
*new_face
;
6179 /* If not called for an X frame, just return the original face. */
6180 if (FRAME_TERMCAP_P (f
))
6183 /* Try in increments of 1/2 pt. */
6184 delta
= steps
< 0 ? 5 : -5;
6185 steps
= abs (steps
);
6187 face
= FACE_FROM_ID (f
, face_id
);
6188 bcopy (face
->lface
, attrs
, sizeof attrs
);
6189 pt
= last_pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
6190 new_face_id
= face_id
;
6191 last_height
= FONT_HEIGHT (face
->font
);
6195 /* Give up if we cannot find a font within 10pt. */
6196 && abs (last_pt
- pt
) < 100)
6198 /* Look up a face for a slightly smaller/larger font. */
6200 attrs
[LFACE_HEIGHT_INDEX
] = make_number (pt
);
6201 new_face_id
= lookup_face (f
, attrs
);
6202 new_face
= FACE_FROM_ID (f
, new_face_id
);
6204 /* If height changes, count that as one step. */
6205 if ((delta
< 0 && FONT_HEIGHT (new_face
->font
) < last_height
)
6206 || (delta
> 0 && FONT_HEIGHT (new_face
->font
) > last_height
))
6209 last_height
= FONT_HEIGHT (new_face
->font
);
6216 #else /* not HAVE_WINDOW_SYSTEM */
6220 #endif /* not HAVE_WINDOW_SYSTEM */
6224 /* Return a face for charset ASCII that is like the face with id
6225 FACE_ID on frame F, but has height HEIGHT. */
6228 face_with_height (f
, face_id
, height
)
6233 #ifdef HAVE_WINDOW_SYSTEM
6235 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6237 if (FRAME_TERMCAP_P (f
)
6241 face
= FACE_FROM_ID (f
, face_id
);
6242 bcopy (face
->lface
, attrs
, sizeof attrs
);
6243 attrs
[LFACE_HEIGHT_INDEX
] = make_number (height
);
6244 face_id
= lookup_face (f
, attrs
);
6245 #endif /* HAVE_WINDOW_SYSTEM */
6251 /* Return the face id of the realized face for named face SYMBOL on
6252 frame F suitable for displaying ASCII characters, and use
6253 attributes of the face FACE_ID for attributes that aren't
6254 completely specified by SYMBOL. This is like lookup_named_face,
6255 except that the default attributes come from FACE_ID, not from the
6256 default face. FACE_ID is assumed to be already realized. */
6259 lookup_derived_face (f
, symbol
, face_id
, signal_p
)
6265 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6266 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
6267 struct face
*default_face
= FACE_FROM_ID (f
, face_id
);
6272 get_lface_attributes (f
, symbol
, symbol_attrs
, signal_p
);
6273 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
6274 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
6275 return lookup_face (f
, attrs
);
6278 DEFUN ("face-attributes-as-vector", Fface_attributes_as_vector
,
6279 Sface_attributes_as_vector
, 1, 1, 0,
6280 doc
: /* Return a vector of face attributes corresponding to PLIST. */)
6285 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
6287 merge_face_ref (XFRAME (selected_frame
), plist
, XVECTOR (lface
)->contents
,
6294 /***********************************************************************
6295 Face capability testing
6296 ***********************************************************************/
6299 /* If the distance (as returned by color_distance) between two colors is
6300 less than this, then they are considered the same, for determining
6301 whether a color is supported or not. The range of values is 0-65535. */
6303 #define TTY_SAME_COLOR_THRESHOLD 10000
6305 #ifdef HAVE_WINDOW_SYSTEM
6307 /* Return non-zero if all the face attributes in ATTRS are supported
6308 on the window-system frame F.
6310 The definition of `supported' is somewhat heuristic, but basically means
6311 that a face containing all the attributes in ATTRS, when merged with the
6312 default face for display, can be represented in a way that's
6314 \(1) different in appearance than the default face, and
6315 \(2) `close in spirit' to what the attributes specify, if not exact. */
6318 x_supports_face_attributes_p (f
, attrs
, def_face
)
6321 struct face
*def_face
;
6323 Lisp_Object
*def_attrs
= def_face
->lface
;
6325 /* Check that other specified attributes are different that the default
6327 if ((!UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
6328 && face_attr_equal_p (attrs
[LFACE_UNDERLINE_INDEX
],
6329 def_attrs
[LFACE_UNDERLINE_INDEX
]))
6330 || (!UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
6331 && face_attr_equal_p (attrs
[LFACE_INVERSE_INDEX
],
6332 def_attrs
[LFACE_INVERSE_INDEX
]))
6333 || (!UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
6334 && face_attr_equal_p (attrs
[LFACE_FOREGROUND_INDEX
],
6335 def_attrs
[LFACE_FOREGROUND_INDEX
]))
6336 || (!UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
6337 && face_attr_equal_p (attrs
[LFACE_BACKGROUND_INDEX
],
6338 def_attrs
[LFACE_BACKGROUND_INDEX
]))
6339 || (!UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
6340 && face_attr_equal_p (attrs
[LFACE_STIPPLE_INDEX
],
6341 def_attrs
[LFACE_STIPPLE_INDEX
]))
6342 || (!UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
6343 && face_attr_equal_p (attrs
[LFACE_OVERLINE_INDEX
],
6344 def_attrs
[LFACE_OVERLINE_INDEX
]))
6345 || (!UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
6346 && face_attr_equal_p (attrs
[LFACE_STRIKE_THROUGH_INDEX
],
6347 def_attrs
[LFACE_STRIKE_THROUGH_INDEX
]))
6348 || (!UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
6349 && face_attr_equal_p (attrs
[LFACE_BOX_INDEX
],
6350 def_attrs
[LFACE_BOX_INDEX
])))
6353 /* Check font-related attributes, as those are the most commonly
6354 "unsupported" on a window-system (because of missing fonts). */
6355 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
6356 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
6357 || !UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
6358 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
6359 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
6360 || !UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
]))
6364 Lisp_Object merged_attrs
[LFACE_VECTOR_SIZE
];
6366 bcopy (def_attrs
, merged_attrs
, sizeof merged_attrs
);
6368 merge_face_vectors (f
, attrs
, merged_attrs
, 0);
6370 face_id
= lookup_face (f
, merged_attrs
);
6371 face
= FACE_FROM_ID (f
, face_id
);
6374 error ("Cannot make face");
6376 /* If the font is the same, then not supported. */
6377 if (face
->font
== def_face
->font
)
6381 /* Everything checks out, this face is supported. */
6385 #endif /* HAVE_WINDOW_SYSTEM */
6387 /* Return non-zero if all the face attributes in ATTRS are supported
6390 The definition of `supported' is somewhat heuristic, but basically means
6391 that a face containing all the attributes in ATTRS, when merged
6392 with the default face for display, can be represented in a way that's
6394 \(1) different in appearance than the default face, and
6395 \(2) `close in spirit' to what the attributes specify, if not exact.
6397 Point (2) implies that a `:weight black' attribute will be satisfied
6398 by any terminal that can display bold, and a `:foreground "yellow"' as
6399 long as the terminal can display a yellowish color, but `:slant italic'
6400 will _not_ be satisfied by the tty display code's automatic
6401 substitution of a `dim' face for italic. */
6404 tty_supports_face_attributes_p (f
, attrs
, def_face
)
6407 struct face
*def_face
;
6410 Lisp_Object val
, fg
, bg
;
6411 XColor fg_tty_color
, fg_std_color
;
6412 XColor bg_tty_color
, bg_std_color
;
6413 unsigned test_caps
= 0;
6414 Lisp_Object
*def_attrs
= def_face
->lface
;
6417 /* First check some easy-to-check stuff; ttys support none of the
6418 following attributes, so we can just return false if any are requested
6419 (even if `nominal' values are specified, we should still return false,
6420 as that will be the same value that the default face uses). We
6421 consider :slant unsupportable on ttys, even though the face code
6422 actually `fakes' them using a dim attribute if possible. This is
6423 because the faked result is too different from what the face
6425 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
6426 || !UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
6427 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
6428 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
6429 || !UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
6430 || !UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
6431 || !UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
6432 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
]))
6436 /* Test for terminal `capabilities' (non-color character attributes). */
6438 /* font weight (bold/dim) */
6439 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
6442 int def_weight
= face_numeric_weight (def_attrs
[LFACE_WEIGHT_INDEX
]);
6444 if (weight
> XLFD_WEIGHT_MEDIUM
)
6446 if (def_weight
> XLFD_WEIGHT_MEDIUM
)
6447 return 0; /* same as default */
6448 test_caps
= TTY_CAP_BOLD
;
6450 else if (weight
< XLFD_WEIGHT_MEDIUM
)
6452 if (def_weight
< XLFD_WEIGHT_MEDIUM
)
6453 return 0; /* same as default */
6454 test_caps
= TTY_CAP_DIM
;
6456 else if (def_weight
== XLFD_WEIGHT_MEDIUM
)
6457 return 0; /* same as default */
6461 val
= attrs
[LFACE_UNDERLINE_INDEX
];
6462 if (!UNSPECIFIEDP (val
))
6465 return 0; /* ttys can't use colored underlines */
6466 else if (face_attr_equal_p (val
, def_attrs
[LFACE_UNDERLINE_INDEX
]))
6467 return 0; /* same as default */
6469 test_caps
|= TTY_CAP_UNDERLINE
;
6473 val
= attrs
[LFACE_INVERSE_INDEX
];
6474 if (!UNSPECIFIEDP (val
))
6476 if (face_attr_equal_p (val
, def_attrs
[LFACE_UNDERLINE_INDEX
]))
6477 return 0; /* same as default */
6479 test_caps
|= TTY_CAP_INVERSE
;
6483 /* Color testing. */
6485 /* Default the color indices in FG_TTY_COLOR and BG_TTY_COLOR, since
6486 we use them when calling `tty_capable_p' below, even if the face
6487 specifies no colors. */
6488 fg_tty_color
.pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
6489 bg_tty_color
.pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
6491 /* Check if foreground color is close enough. */
6492 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
6495 Lisp_Object def_fg
= def_attrs
[LFACE_FOREGROUND_INDEX
];
6497 if (face_attr_equal_p (fg
, def_fg
))
6498 return 0; /* same as default */
6499 else if (! tty_lookup_color (f
, fg
, &fg_tty_color
, &fg_std_color
))
6500 return 0; /* not a valid color */
6501 else if (color_distance (&fg_tty_color
, &fg_std_color
)
6502 > TTY_SAME_COLOR_THRESHOLD
)
6503 return 0; /* displayed color is too different */
6505 /* Make sure the color is really different than the default. */
6507 XColor def_fg_color
;
6508 if (tty_lookup_color (f
, def_fg
, &def_fg_color
, 0)
6509 && (color_distance (&fg_tty_color
, &def_fg_color
)
6510 <= TTY_SAME_COLOR_THRESHOLD
))
6515 /* Check if background color is close enough. */
6516 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
6519 Lisp_Object def_bg
= def_attrs
[LFACE_FOREGROUND_INDEX
];
6521 if (face_attr_equal_p (bg
, def_bg
))
6522 return 0; /* same as default */
6523 else if (! tty_lookup_color (f
, bg
, &bg_tty_color
, &bg_std_color
))
6524 return 0; /* not a valid color */
6525 else if (color_distance (&bg_tty_color
, &bg_std_color
)
6526 > TTY_SAME_COLOR_THRESHOLD
)
6527 return 0; /* displayed color is too different */
6529 /* Make sure the color is really different than the default. */
6531 XColor def_bg_color
;
6532 if (tty_lookup_color (f
, def_bg
, &def_bg_color
, 0)
6533 && (color_distance (&bg_tty_color
, &def_bg_color
)
6534 <= TTY_SAME_COLOR_THRESHOLD
))
6539 /* If both foreground and background are requested, see if the
6540 distance between them is OK. We just check to see if the distance
6541 between the tty's foreground and background is close enough to the
6542 distance between the standard foreground and background. */
6543 if (STRINGP (fg
) && STRINGP (bg
))
6546 = (color_distance (&fg_std_color
, &bg_std_color
)
6547 - color_distance (&fg_tty_color
, &bg_tty_color
));
6548 if (delta_delta
> TTY_SAME_COLOR_THRESHOLD
6549 || delta_delta
< -TTY_SAME_COLOR_THRESHOLD
)
6554 /* See if the capabilities we selected above are supported, with the
6556 if (test_caps
!= 0 &&
6557 ! tty_capable_p (f
, test_caps
, fg_tty_color
.pixel
, bg_tty_color
.pixel
))
6561 /* Hmmm, everything checks out, this terminal must support this face. */
6566 DEFUN ("display-supports-face-attributes-p",
6567 Fdisplay_supports_face_attributes_p
, Sdisplay_supports_face_attributes_p
,
6569 doc
: /* Return non-nil if all the face attributes in ATTRIBUTES are supported.
6570 The optional argument DISPLAY can be a display name, a frame, or
6571 nil (meaning the selected frame's display).
6573 The definition of `supported' is somewhat heuristic, but basically means
6574 that a face containing all the attributes in ATTRIBUTES, when merged
6575 with the default face for display, can be represented in a way that's
6577 \(1) different in appearance than the default face, and
6578 \(2) `close in spirit' to what the attributes specify, if not exact.
6580 Point (2) implies that a `:weight black' attribute will be satisfied by
6581 any display that can display bold, and a `:foreground \"yellow\"' as long
6582 as it can display a yellowish color, but `:slant italic' will _not_ be
6583 satisfied by the tty display code's automatic substitution of a `dim'
6584 face for italic. */)
6585 (attributes
, display
)
6586 Lisp_Object attributes
, display
;
6588 int supports
= 0, i
;
6591 struct face
*def_face
;
6592 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6594 if (noninteractive
|| !initialized
)
6595 /* We may not be able to access low-level face information in batch
6596 mode, or before being dumped, and this function is not going to
6597 be very useful in those cases anyway, so just give up. */
6601 frame
= selected_frame
;
6602 else if (FRAMEP (display
))
6606 /* Find any frame on DISPLAY. */
6607 Lisp_Object fl_tail
;
6610 for (fl_tail
= Vframe_list
; CONSP (fl_tail
); fl_tail
= XCDR (fl_tail
))
6612 frame
= XCAR (fl_tail
);
6613 if (!NILP (Fequal (Fcdr (Fassq (Qdisplay
,
6614 XFRAME (frame
)->param_alist
)),
6620 CHECK_LIVE_FRAME (frame
);
6623 for (i
= 0; i
< LFACE_VECTOR_SIZE
; i
++)
6624 attrs
[i
] = Qunspecified
;
6625 merge_face_ref (f
, attributes
, attrs
, 1, 0);
6627 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6628 if (def_face
== NULL
)
6630 if (! realize_basic_faces (f
))
6631 error ("Cannot realize default face");
6632 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6633 if (def_face
== NULL
)
6634 abort (); /* realize_basic_faces must have set it up */
6637 /* Dispatch to the appropriate handler. */
6638 if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
6639 supports
= tty_supports_face_attributes_p (f
, attrs
, def_face
);
6640 #ifdef HAVE_WINDOW_SYSTEM
6642 supports
= x_supports_face_attributes_p (f
, attrs
, def_face
);
6645 return supports
? Qt
: Qnil
;
6649 /***********************************************************************
6651 ***********************************************************************/
6653 DEFUN ("internal-set-font-selection-order",
6654 Finternal_set_font_selection_order
,
6655 Sinternal_set_font_selection_order
, 1, 1, 0,
6656 doc
: /* Set font selection order for face font selection to ORDER.
6657 ORDER must be a list of length 4 containing the symbols `:width',
6658 `:height', `:weight', and `:slant'. Face attributes appearing
6659 first in ORDER are matched first, e.g. if `:height' appears before
6660 `:weight' in ORDER, font selection first tries to find a font with
6661 a suitable height, and then tries to match the font weight.
6668 int indices
[DIM (font_sort_order
)];
6671 bzero (indices
, sizeof indices
);
6675 CONSP (list
) && i
< DIM (indices
);
6676 list
= XCDR (list
), ++i
)
6678 Lisp_Object attr
= XCAR (list
);
6681 if (EQ (attr
, QCwidth
))
6683 else if (EQ (attr
, QCheight
))
6684 xlfd
= XLFD_POINT_SIZE
;
6685 else if (EQ (attr
, QCweight
))
6687 else if (EQ (attr
, QCslant
))
6692 if (indices
[i
] != 0)
6697 if (!NILP (list
) || i
!= DIM (indices
))
6698 signal_error ("Invalid font sort order", order
);
6699 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6700 if (indices
[i
] == 0)
6701 signal_error ("Invalid font sort order", order
);
6703 if (bcmp (indices
, font_sort_order
, sizeof indices
) != 0)
6705 bcopy (indices
, font_sort_order
, sizeof font_sort_order
);
6706 free_all_realized_faces (Qnil
);
6709 #ifdef USE_FONT_BACKEND
6710 font_update_sort_order (font_sort_order
);
6711 #endif /* USE_FONT_BACKEND */
6717 DEFUN ("internal-set-alternative-font-family-alist",
6718 Finternal_set_alternative_font_family_alist
,
6719 Sinternal_set_alternative_font_family_alist
, 1, 1, 0,
6720 doc
: /* Define alternative font families to try in face font selection.
6721 ALIST is an alist of (FAMILY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6722 Each ALTERNATIVE is tried in order if no fonts of font family FAMILY can
6723 be found. Value is ALIST. */)
6728 Vface_alternative_font_family_alist
= alist
;
6729 free_all_realized_faces (Qnil
);
6734 DEFUN ("internal-set-alternative-font-registry-alist",
6735 Finternal_set_alternative_font_registry_alist
,
6736 Sinternal_set_alternative_font_registry_alist
, 1, 1, 0,
6737 doc
: /* Define alternative font registries to try in face font selection.
6738 ALIST is an alist of (REGISTRY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6739 Each ALTERNATIVE is tried in order if no fonts of font registry REGISTRY can
6740 be found. Value is ALIST. */)
6745 Vface_alternative_font_registry_alist
= alist
;
6746 free_all_realized_faces (Qnil
);
6751 #ifdef HAVE_WINDOW_SYSTEM
6753 /* Value is non-zero if FONT is the name of a scalable font. The
6754 X11R6 XLFD spec says that point size, pixel size, and average width
6755 are zero for scalable fonts. Intlfonts contain at least one
6756 scalable font ("*-muleindian-1") for which this isn't true, so we
6757 just test average width. */
6760 font_scalable_p (font
)
6761 struct font_name
*font
;
6763 char *s
= font
->fields
[XLFD_AVGWIDTH
];
6764 return (*s
== '0' && *(s
+ 1) == '\0')
6766 /* Windows implementation of XLFD is slightly broken for backward
6767 compatibility with previous broken versions, so test for
6768 wildcards as well as 0. */
6775 /* Ignore the difference of font point size less than this value. */
6777 #define FONT_POINT_SIZE_QUANTUM 5
6779 /* Value is non-zero if FONT1 is a better match for font attributes
6780 VALUES than FONT2. VALUES is an array of face attribute values in
6781 font sort order. COMPARE_PT_P zero means don't compare point
6782 sizes. AVGWIDTH, if not zero, is a specified font average width
6786 better_font_p (values
, font1
, font2
, compare_pt_p
, avgwidth
)
6788 struct font_name
*font1
, *font2
;
6789 int compare_pt_p
, avgwidth
;
6793 /* Any font is better than no font. */
6799 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6801 int xlfd_idx
= font_sort_order
[i
];
6803 if (compare_pt_p
|| xlfd_idx
!= XLFD_POINT_SIZE
)
6807 if (xlfd_idx
== XLFD_POINT_SIZE
)
6809 delta1
= abs (values
[i
] - (font1
->numeric
[xlfd_idx
]
6810 / font1
->rescale_ratio
));
6811 delta2
= abs (values
[i
] - (font2
->numeric
[xlfd_idx
]
6812 / font2
->rescale_ratio
));
6813 if (abs (delta1
- delta2
) < FONT_POINT_SIZE_QUANTUM
)
6818 delta1
= abs (values
[i
] - font1
->numeric
[xlfd_idx
]);
6819 delta2
= abs (values
[i
] - font2
->numeric
[xlfd_idx
]);
6822 if (delta1
> delta2
)
6824 else if (delta1
< delta2
)
6828 /* The difference may be equal because, e.g., the face
6829 specifies `italic' but we have only `regular' and
6830 `oblique'. Prefer `oblique' in this case. */
6831 if ((xlfd_idx
== XLFD_WEIGHT
|| xlfd_idx
== XLFD_SLANT
)
6832 && font1
->numeric
[xlfd_idx
] > values
[i
]
6833 && font2
->numeric
[xlfd_idx
] < values
[i
])
6841 int delta1
= abs (avgwidth
- font1
->numeric
[XLFD_AVGWIDTH
]);
6842 int delta2
= abs (avgwidth
- font2
->numeric
[XLFD_AVGWIDTH
]);
6843 if (delta1
> delta2
)
6845 else if (delta1
< delta2
)
6851 /* We prefer a real scalable font; i.e. not what autoscaled. */
6852 int auto_scaled_1
= (font1
->numeric
[XLFD_POINT_SIZE
] == 0
6853 && font1
->numeric
[XLFD_RESY
] > 0);
6854 int auto_scaled_2
= (font2
->numeric
[XLFD_POINT_SIZE
] == 0
6855 && font2
->numeric
[XLFD_RESY
] > 0);
6857 if (auto_scaled_1
!= auto_scaled_2
)
6858 return auto_scaled_2
;
6861 return font1
->registry_priority
< font2
->registry_priority
;
6865 /* Value is non-zero if FONT is an exact match for face attributes in
6866 SPECIFIED. SPECIFIED is an array of face attribute values in font
6867 sort order. AVGWIDTH, if non-zero, is an average width to compare
6871 exact_face_match_p (specified
, font
, avgwidth
)
6873 struct font_name
*font
;
6878 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6879 if (specified
[i
] != font
->numeric
[font_sort_order
[i
]])
6882 return (i
== DIM (font_sort_order
)
6884 || avgwidth
== font
->numeric
[XLFD_AVGWIDTH
]));
6888 /* Value is the name of a scaled font, generated from scalable font
6889 FONT on frame F. SPECIFIED_PT is the point-size to scale FONT to.
6890 Value is allocated from heap. */
6893 build_scalable_font_name (f
, font
, specified_pt
)
6895 struct font_name
*font
;
6898 char pixel_size
[20];
6900 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
6903 if (font
->numeric
[XLFD_PIXEL_SIZE
] != 0
6904 || font
->numeric
[XLFD_POINT_SIZE
] != 0)
6905 /* This is a scalable font but is requested for a specific size.
6906 We should not change that size. */
6907 return build_font_name (font
);
6909 /* If scalable font is for a specific resolution, compute
6910 the point size we must specify from the resolution of
6911 the display and the specified resolution of the font. */
6912 if (font
->numeric
[XLFD_RESY
] != 0)
6914 pt
= resy
/ font
->numeric
[XLFD_RESY
] * specified_pt
+ 0.5;
6915 pixel_value
= font
->numeric
[XLFD_RESY
] / (PT_PER_INCH
* 10.0) * pt
+ 0.5;
6920 pixel_value
= resy
/ (PT_PER_INCH
* 10.0) * pt
+ 0.5;
6922 /* We may need a font of the different size. */
6923 pixel_value
*= font
->rescale_ratio
;
6925 /* We should keep POINT_SIZE 0. Otherwise, X server can't open a
6926 font of the specified PIXEL_SIZE. */
6928 { /* Set point size of the font. */
6929 char point_size
[20];
6930 sprintf (point_size
, "%d", (int) pt
);
6931 font
->fields
[XLFD_POINT_SIZE
] = point_size
;
6932 font
->numeric
[XLFD_POINT_SIZE
] = pt
;
6936 /* Set pixel size. */
6937 sprintf (pixel_size
, "%d", pixel_value
);
6938 font
->fields
[XLFD_PIXEL_SIZE
] = pixel_size
;
6939 font
->numeric
[XLFD_PIXEL_SIZE
] = pixel_value
;
6941 /* If font doesn't specify its resolution, use the
6942 resolution of the display. */
6943 if (font
->numeric
[XLFD_RESY
] == 0)
6946 sprintf (buffer
, "%d", (int) resy
);
6947 font
->fields
[XLFD_RESY
] = buffer
;
6948 font
->numeric
[XLFD_RESY
] = resy
;
6951 if (strcmp (font
->fields
[XLFD_RESX
], "0") == 0)
6954 int resx
= FRAME_X_DISPLAY_INFO (f
)->resx
;
6955 sprintf (buffer
, "%d", resx
);
6956 font
->fields
[XLFD_RESX
] = buffer
;
6957 font
->numeric
[XLFD_RESX
] = resx
;
6960 return build_font_name (font
);
6964 /* Value is non-zero if we are allowed to use scalable font FONT. We
6965 can't run a Lisp function here since this function may be called
6966 with input blocked. */
6969 may_use_scalable_font_p (font
)
6972 if (EQ (Vscalable_fonts_allowed
, Qt
))
6974 else if (CONSP (Vscalable_fonts_allowed
))
6976 Lisp_Object tail
, regexp
;
6978 for (tail
= Vscalable_fonts_allowed
; CONSP (tail
); tail
= XCDR (tail
))
6980 regexp
= XCAR (tail
);
6981 if (STRINGP (regexp
)
6982 && fast_c_string_match_ignore_case (regexp
, font
) >= 0)
6992 /* Return the name of the best matching font for face attributes ATTRS
6993 in the array of font_name structures FONTS which contains NFONTS
6994 elements. WIDTH_RATIO is a factor with which to multiply average
6995 widths if ATTRS specifies such a width.
6997 Value is a font name which is allocated from the heap. FONTS is
6998 freed by this function.
7000 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
7001 indicate whether the resulting font should be drawn using overstrike
7002 to simulate bold-face. */
7005 best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
, needs_overstrike
)
7008 struct font_name
*fonts
;
7011 int *needs_overstrike
;
7014 struct font_name
*best
;
7017 int exact_p
, avgwidth
;
7022 /* Make specified font attributes available in `specified',
7023 indexed by sort order. */
7024 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
7026 int xlfd_idx
= font_sort_order
[i
];
7028 if (xlfd_idx
== XLFD_SWIDTH
)
7029 specified
[i
] = face_numeric_swidth (attrs
[LFACE_SWIDTH_INDEX
]);
7030 else if (xlfd_idx
== XLFD_POINT_SIZE
)
7031 specified
[i
] = pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
7032 else if (xlfd_idx
== XLFD_WEIGHT
)
7033 specified
[i
] = face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
7034 else if (xlfd_idx
== XLFD_SLANT
)
7035 specified
[i
] = face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
7040 avgwidth
= (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
7042 : XFASTINT (attrs
[LFACE_AVGWIDTH_INDEX
]) * width_ratio
);
7046 if (needs_overstrike
)
7047 *needs_overstrike
= 0;
7051 /* Find the best match among the non-scalable fonts. */
7052 for (i
= 0; i
< nfonts
; ++i
)
7053 if (!font_scalable_p (fonts
+ i
)
7054 && better_font_p (specified
, fonts
+ i
, best
, 1, avgwidth
))
7058 exact_p
= exact_face_match_p (specified
, best
, avgwidth
);
7063 /* Unless we found an exact match among non-scalable fonts, see if
7064 we can find a better match among scalable fonts. */
7067 /* A scalable font is better if
7069 1. its weight, slant, swidth attributes are better, or.
7071 2. the best non-scalable font doesn't have the required
7072 point size, and the scalable fonts weight, slant, swidth
7075 int non_scalable_has_exact_height_p
;
7077 if (best
&& best
->numeric
[XLFD_POINT_SIZE
] == pt
)
7078 non_scalable_has_exact_height_p
= 1;
7080 non_scalable_has_exact_height_p
= 0;
7082 for (i
= 0; i
< nfonts
; ++i
)
7083 if (font_scalable_p (fonts
+ i
))
7085 if (better_font_p (specified
, fonts
+ i
, best
, 0, 0)
7086 || (!non_scalable_has_exact_height_p
7087 && !better_font_p (specified
, best
, fonts
+ i
, 0, 0)))
7089 non_scalable_has_exact_height_p
= 1;
7095 /* We should have found SOME font. */
7099 if (! exact_p
&& needs_overstrike
)
7101 enum xlfd_weight want_weight
= specified
[XLFD_WEIGHT
];
7102 enum xlfd_weight got_weight
= best
->numeric
[XLFD_WEIGHT
];
7104 if (want_weight
> XLFD_WEIGHT_MEDIUM
&& want_weight
> got_weight
)
7106 /* We want a bold font, but didn't get one; try to use
7107 overstriking instead to simulate bold-face. However,
7108 don't overstrike an already-bold font unless the
7109 desired weight grossly exceeds the available weight. */
7110 if (got_weight
> XLFD_WEIGHT_MEDIUM
)
7111 *needs_overstrike
= (want_weight
- got_weight
) > 2;
7113 *needs_overstrike
= 1;
7117 if (font_scalable_p (best
))
7118 font_name
= build_scalable_font_name (f
, best
, pt
);
7120 font_name
= build_font_name (best
);
7122 /* Free font_name structures. */
7123 free_font_names (fonts
, nfonts
);
7129 /* Get a list of matching fonts on frame F, considering FAMILY
7130 and alternative font families from Vface_alternative_font_registry_alist.
7132 FAMILY is the font family whose alternatives are considered.
7134 REGISTRY, if a string, specifies a font registry and encoding to
7135 match. A value of nil means include fonts of any registry and
7138 Return in *FONTS a pointer to a vector of font_name structures for
7139 the fonts matched. Value is the number of fonts found. */
7142 try_alternative_families (f
, family
, registry
, fonts
)
7144 Lisp_Object family
, registry
;
7145 struct font_name
**fonts
;
7150 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
7153 /* Try alternative font families. */
7154 alter
= Fassoc (family
, Vface_alternative_font_family_alist
);
7157 for (alter
= XCDR (alter
);
7158 CONSP (alter
) && nfonts
== 0;
7159 alter
= XCDR (alter
))
7161 if (STRINGP (XCAR (alter
)))
7162 nfonts
= font_list (f
, Qnil
, XCAR (alter
), registry
, fonts
);
7166 /* Try all scalable fonts before giving up. */
7167 if (nfonts
== 0 && ! EQ (Vscalable_fonts_allowed
, Qt
))
7169 int count
= SPECPDL_INDEX ();
7170 specbind (Qscalable_fonts_allowed
, Qt
);
7171 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
7172 unbind_to (count
, Qnil
);
7179 /* Get a list of matching fonts on frame F.
7181 PATTERN, if a string, specifies a font name pattern to match while
7182 ignoring FAMILY and REGISTRY.
7184 FAMILY, if a list, specifies a list of font families to try.
7186 REGISTRY, if a list, specifies a list of font registries and
7189 Return in *FONTS a pointer to a vector of font_name structures for
7190 the fonts matched. Value is the number of fonts found. */
7193 try_font_list (f
, pattern
, family
, registry
, fonts
)
7195 Lisp_Object pattern
, family
, registry
;
7196 struct font_name
**fonts
;
7200 if (STRINGP (pattern
))
7202 nfonts
= font_list (f
, pattern
, Qnil
, Qnil
, fonts
);
7203 if (nfonts
== 0 && ! EQ (Vscalable_fonts_allowed
, Qt
))
7205 int count
= SPECPDL_INDEX ();
7206 specbind (Qscalable_fonts_allowed
, Qt
);
7207 nfonts
= font_list (f
, pattern
, Qnil
, Qnil
, fonts
);
7208 unbind_to (count
, Qnil
);
7216 nfonts
= font_list (f
, Qnil
, Qnil
, registry
, fonts
);
7218 for (tail
= family
; ! nfonts
&& CONSP (tail
); tail
= XCDR (tail
))
7219 nfonts
= try_alternative_families (f
, XCAR (tail
), registry
, fonts
);
7221 /* Try font family of the default face or "fixed". */
7222 if (nfonts
== 0 && !NILP (family
))
7224 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7226 family
= default_face
->lface
[LFACE_FAMILY_INDEX
];
7228 family
= build_string ("fixed");
7229 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
7232 /* Try any family with the given registry. */
7233 if (nfonts
== 0 && !NILP (family
))
7234 nfonts
= try_alternative_families (f
, Qnil
, registry
, fonts
);
7241 /* Return the fontset id of the base fontset name or alias name given
7242 by the fontset attribute of ATTRS. Value is -1 if the fontset
7243 attribute of ATTRS doesn't name a fontset. */
7246 face_fontset (attrs
)
7251 name
= attrs
[LFACE_FONTSET_INDEX
];
7252 if (!STRINGP (name
))
7254 return fs_query_fontset (name
, 0);
7258 /* Choose a name of font to use on frame F to display characters with
7259 Lisp face attributes specified by ATTRS. The font name is
7260 determined by the font-related attributes in ATTRS and FONT-SPEC
7263 When we are choosing a font for ASCII characters, FONT-SPEC is
7264 always nil. Otherwise FONT-SPEC is a list
7265 [ FAMILY WEIGHT SLANT SWIDTH ADSTYLE REGISTRY ]
7266 or a string specifying a font name pattern.
7268 If NEEDS_OVERSTRIKE is not NULL, a boolean is returned in it to
7269 indicate whether the resulting font should be drawn using
7270 overstrike to simulate bold-face.
7272 Value is the font name which is allocated from the heap and must be
7273 freed by the caller. */
7276 choose_face_font (f
, attrs
, font_spec
, needs_overstrike
)
7279 Lisp_Object font_spec
;
7280 int *needs_overstrike
;
7282 Lisp_Object pattern
, family
, adstyle
, registry
;
7283 char *font_name
= NULL
;
7284 struct font_name
*fonts
;
7287 if (needs_overstrike
)
7288 *needs_overstrike
= 0;
7290 /* If we are choosing an ASCII font and a font name is explicitly
7291 specified in ATTRS, return it. */
7292 if (NILP (font_spec
) && STRINGP (attrs
[LFACE_FONT_INDEX
]))
7293 return xstrdup (SDATA (attrs
[LFACE_FONT_INDEX
]));
7295 if (NILP (attrs
[LFACE_FAMILY_INDEX
]))
7298 family
= Fcons (attrs
[LFACE_FAMILY_INDEX
], Qnil
);
7300 /* Decide FAMILY, ADSTYLE, and REGISTRY from FONT_SPEC. But,
7301 ADSTYLE is not used in the font selector for the moment. */
7302 if (VECTORP (font_spec
))
7305 if (STRINGP (AREF (font_spec
, FONT_SPEC_FAMILY_INDEX
)))
7306 family
= Fcons (AREF (font_spec
, FONT_SPEC_FAMILY_INDEX
), family
);
7307 adstyle
= AREF (font_spec
, FONT_SPEC_ADSTYLE_INDEX
);
7308 registry
= Fcons (AREF (font_spec
, FONT_SPEC_REGISTRY_INDEX
), Qnil
);
7310 else if (STRINGP (font_spec
))
7312 pattern
= font_spec
;
7319 /* We are choosing an ASCII font. By default, use the registry
7320 name "iso8859-1". But, if the registry name of the ASCII
7321 font specified in the fontset of ATTRS is not "iso8859-1"
7322 (e.g "iso10646-1"), use also that name with higher
7324 int fontset
= face_fontset (attrs
);
7327 struct font_name font
;
7331 registry
= Fcons (build_string ("iso8859-1"), Qnil
);
7333 ascii
= fontset_ascii (fontset
);
7334 len
= SBYTES (ascii
);
7336 || strcmp (SDATA (ascii
) + len
- 9, "iso8859-1"))
7338 font
.name
= LSTRDUPA (ascii
);
7339 /* Check if the name is in XLFD. */
7340 if (split_font_name (f
, &font
, 0))
7342 font
.fields
[XLFD_ENCODING
][-1] = '-';
7343 registry
= Fcons (build_string (font
.fields
[XLFD_REGISTRY
]),
7349 /* Get a list of fonts matching that pattern and choose the
7350 best match for the specified face attributes from it. */
7351 nfonts
= try_font_list (f
, pattern
, family
, registry
, &fonts
);
7352 font_name
= best_matching_font (f
, attrs
, fonts
, nfonts
, NILP (font_spec
),
7357 #endif /* HAVE_WINDOW_SYSTEM */
7361 /***********************************************************************
7363 ***********************************************************************/
7365 /* Realize basic faces on frame F. Value is zero if frame parameters
7366 of F don't contain enough information needed to realize the default
7370 realize_basic_faces (f
)
7374 int count
= SPECPDL_INDEX ();
7376 /* Block input here so that we won't be surprised by an X expose
7377 event, for instance, without having the faces set up. */
7379 specbind (Qscalable_fonts_allowed
, Qt
);
7381 if (realize_default_face (f
))
7383 realize_named_face (f
, Qmode_line
, MODE_LINE_FACE_ID
);
7384 realize_named_face (f
, Qmode_line_inactive
, MODE_LINE_INACTIVE_FACE_ID
);
7385 realize_named_face (f
, Qtool_bar
, TOOL_BAR_FACE_ID
);
7386 realize_named_face (f
, Qfringe
, FRINGE_FACE_ID
);
7387 realize_named_face (f
, Qheader_line
, HEADER_LINE_FACE_ID
);
7388 realize_named_face (f
, Qscroll_bar
, SCROLL_BAR_FACE_ID
);
7389 realize_named_face (f
, Qborder
, BORDER_FACE_ID
);
7390 realize_named_face (f
, Qcursor
, CURSOR_FACE_ID
);
7391 realize_named_face (f
, Qmouse
, MOUSE_FACE_ID
);
7392 realize_named_face (f
, Qmenu
, MENU_FACE_ID
);
7393 realize_named_face (f
, Qvertical_border
, VERTICAL_BORDER_FACE_ID
);
7395 /* Reflect changes in the `menu' face in menu bars. */
7396 if (FRAME_FACE_CACHE (f
)->menu_face_changed_p
)
7398 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 0;
7399 #ifdef USE_X_TOOLKIT
7400 x_update_menu_appearance (f
);
7407 unbind_to (count
, Qnil
);
7413 /* Realize the default face on frame F. If the face is not fully
7414 specified, make it fully-specified. Attributes of the default face
7415 that are not explicitly specified are taken from frame parameters. */
7418 realize_default_face (f
)
7421 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
7423 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7424 Lisp_Object frame_font
;
7427 /* If the `default' face is not yet known, create it. */
7428 lface
= lface_from_face_name (f
, Qdefault
, 0);
7432 XSETFRAME (frame
, f
);
7433 lface
= Finternal_make_lisp_face (Qdefault
, frame
);
7437 #ifdef HAVE_WINDOW_SYSTEM
7438 if (FRAME_WINDOW_P (f
))
7440 #ifdef USE_FONT_BACKEND
7441 if (enable_font_backend
)
7443 frame_font
= font_find_object (FRAME_FONT_OBJECT (f
));
7444 xassert (FONT_OBJECT_P (frame_font
));
7445 set_lface_from_font_and_fontset (f
, lface
, frame_font
,
7447 f
->default_face_done_p
);
7451 #endif /* USE_FONT_BACKEND */
7452 /* Set frame_font to the value of the `font' frame parameter. */
7453 frame_font
= Fassq (Qfont
, f
->param_alist
);
7454 xassert (CONSP (frame_font
) && STRINGP (XCDR (frame_font
)));
7455 frame_font
= XCDR (frame_font
);
7456 set_lface_from_font_name (f
, lface
, frame_font
,
7457 f
->default_face_done_p
, 1);
7458 #ifdef USE_FONT_BACKEND
7460 #endif /* USE_FONT_BACKEND */
7461 f
->default_face_done_p
= 1;
7463 #endif /* HAVE_WINDOW_SYSTEM */
7465 if (!FRAME_WINDOW_P (f
))
7467 LFACE_FAMILY (lface
) = build_string ("default");
7468 LFACE_SWIDTH (lface
) = Qnormal
;
7469 LFACE_HEIGHT (lface
) = make_number (1);
7470 if (UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
7471 LFACE_WEIGHT (lface
) = Qnormal
;
7472 if (UNSPECIFIEDP (LFACE_SLANT (lface
)))
7473 LFACE_SLANT (lface
) = Qnormal
;
7474 LFACE_AVGWIDTH (lface
) = Qunspecified
;
7477 if (UNSPECIFIEDP (LFACE_UNDERLINE (lface
)))
7478 LFACE_UNDERLINE (lface
) = Qnil
;
7480 if (UNSPECIFIEDP (LFACE_OVERLINE (lface
)))
7481 LFACE_OVERLINE (lface
) = Qnil
;
7483 if (UNSPECIFIEDP (LFACE_STRIKE_THROUGH (lface
)))
7484 LFACE_STRIKE_THROUGH (lface
) = Qnil
;
7486 if (UNSPECIFIEDP (LFACE_BOX (lface
)))
7487 LFACE_BOX (lface
) = Qnil
;
7489 if (UNSPECIFIEDP (LFACE_INVERSE (lface
)))
7490 LFACE_INVERSE (lface
) = Qnil
;
7492 if (UNSPECIFIEDP (LFACE_FOREGROUND (lface
)))
7494 /* This function is called so early that colors are not yet
7495 set in the frame parameter list. */
7496 Lisp_Object color
= Fassq (Qforeground_color
, f
->param_alist
);
7498 if (CONSP (color
) && STRINGP (XCDR (color
)))
7499 LFACE_FOREGROUND (lface
) = XCDR (color
);
7500 else if (FRAME_WINDOW_P (f
))
7502 else if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
7503 LFACE_FOREGROUND (lface
) = build_string (unspecified_fg
);
7508 if (UNSPECIFIEDP (LFACE_BACKGROUND (lface
)))
7510 /* This function is called so early that colors are not yet
7511 set in the frame parameter list. */
7512 Lisp_Object color
= Fassq (Qbackground_color
, f
->param_alist
);
7513 if (CONSP (color
) && STRINGP (XCDR (color
)))
7514 LFACE_BACKGROUND (lface
) = XCDR (color
);
7515 else if (FRAME_WINDOW_P (f
))
7517 else if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
7518 LFACE_BACKGROUND (lface
) = build_string (unspecified_bg
);
7523 if (UNSPECIFIEDP (LFACE_STIPPLE (lface
)))
7524 LFACE_STIPPLE (lface
) = Qnil
;
7526 /* Realize the face; it must be fully-specified now. */
7527 xassert (lface_fully_specified_p (XVECTOR (lface
)->contents
));
7528 check_lface (lface
);
7529 bcopy (XVECTOR (lface
)->contents
, attrs
, sizeof attrs
);
7530 face
= realize_face (c
, attrs
, DEFAULT_FACE_ID
);
7532 #ifdef HAVE_WINDOW_SYSTEM
7533 #ifdef HAVE_X_WINDOWS
7534 if (face
->font
!= FRAME_FONT (f
))
7536 /* This can happen when making a frame on a display that does
7537 not support the default font. */
7541 /* Otherwise, the font specified for the frame was not
7542 acceptable as a font for the default face (perhaps because
7543 auto-scaled fonts are rejected), so we must adjust the frame
7545 x_set_font (f
, build_string (face
->font_name
), Qnil
);
7547 #endif /* HAVE_X_WINDOWS */
7548 #endif /* HAVE_WINDOW_SYSTEM */
7553 /* Realize basic faces other than the default face in face cache C.
7554 SYMBOL is the face name, ID is the face id the realized face must
7555 have. The default face must have been realized already. */
7558 realize_named_face (f
, symbol
, id
)
7563 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
7564 Lisp_Object lface
= lface_from_face_name (f
, symbol
, 0);
7565 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7566 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
7567 struct face
*new_face
;
7569 /* The default face must exist and be fully specified. */
7570 get_lface_attributes (f
, Qdefault
, attrs
, 1);
7571 check_lface_attrs (attrs
);
7572 xassert (lface_fully_specified_p (attrs
));
7574 /* If SYMBOL isn't know as a face, create it. */
7578 XSETFRAME (frame
, f
);
7579 lface
= Finternal_make_lisp_face (symbol
, frame
);
7582 /* Merge SYMBOL's face with the default face. */
7583 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
7584 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
7586 /* Realize the face. */
7587 new_face
= realize_face (c
, attrs
, id
);
7591 /* Realize the fully-specified face with attributes ATTRS in face
7592 cache CACHE for ASCII characters. If FORMER_FACE_ID is
7593 non-negative, it is an ID of face to remove before caching the new
7594 face. Value is a pointer to the newly created realized face. */
7596 static struct face
*
7597 realize_face (cache
, attrs
, former_face_id
)
7598 struct face_cache
*cache
;
7604 /* LFACE must be fully specified. */
7605 xassert (cache
!= NULL
);
7606 check_lface_attrs (attrs
);
7608 if (former_face_id
>= 0 && cache
->used
> former_face_id
)
7610 /* Remove the former face. */
7611 struct face
*former_face
= cache
->faces_by_id
[former_face_id
];
7612 uncache_face (cache
, former_face
);
7613 free_realized_face (cache
->f
, former_face
);
7616 if (FRAME_WINDOW_P (cache
->f
))
7617 face
= realize_x_face (cache
, attrs
);
7618 else if (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
))
7619 face
= realize_tty_face (cache
, attrs
);
7623 /* Insert the new face. */
7624 cache_face (cache
, face
, lface_hash (attrs
));
7629 #ifdef HAVE_WINDOW_SYSTEM
7630 /* Realize the fully-specified face that has the same attributes as
7631 BASE_FACE except for the font on frame F. If FONT_ID is not
7632 negative, it is an ID number of an already opened font that should
7633 be used by the face. If FONT_ID is negative, the face has no font,
7634 i.e., characters are displayed by empty boxes. */
7636 static struct face
*
7637 realize_non_ascii_face (f
, font_id
, base_face
)
7640 struct face
*base_face
;
7642 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
7644 struct font_info
*font_info
;
7646 face
= (struct face
*) xmalloc (sizeof *face
);
7649 #ifdef USE_FONT_BACKEND
7653 /* Don't try to free the colors copied bitwise from BASE_FACE. */
7654 face
->colors_copied_bitwise_p
= 1;
7656 face
->font_info_id
= font_id
;
7659 font_info
= FONT_INFO_FROM_ID (f
, font_id
);
7660 face
->font
= font_info
->font
;
7661 face
->font_name
= font_info
->full_name
;
7666 face
->font_name
= NULL
;
7671 cache_face (cache
, face
, face
->hash
);
7675 #endif /* HAVE_WINDOW_SYSTEM */
7678 /* Realize the fully-specified face with attributes ATTRS in face
7679 cache CACHE for ASCII characters. Do it for X frame CACHE->f. If
7680 the new face doesn't share font with the default face, a fontname
7681 is allocated from the heap and set in `font_name' of the new face,
7682 but it is not yet loaded here. Value is a pointer to the newly
7683 created realized face. */
7685 static struct face
*
7686 realize_x_face (cache
, attrs
)
7687 struct face_cache
*cache
;
7690 struct face
*face
= NULL
;
7691 #ifdef HAVE_WINDOW_SYSTEM
7692 struct face
*default_face
;
7694 Lisp_Object stipple
, overline
, strike_through
, box
;
7696 xassert (FRAME_WINDOW_P (cache
->f
));
7698 /* Allocate a new realized face. */
7699 face
= make_realized_face (attrs
);
7700 face
->ascii_face
= face
;
7704 /* Determine the font to use. Most of the time, the font will be
7705 the same as the font of the default face, so try that first. */
7706 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7708 && lface_same_font_attributes_p (default_face
->lface
, attrs
))
7710 face
->font
= default_face
->font
;
7711 face
->font_info_id
= default_face
->font_info_id
;
7712 #ifdef USE_FONT_BACKEND
7713 face
->font_info
= default_face
->font_info
;
7714 #endif /* USE_FONT_BACKEND */
7715 face
->font_name
= default_face
->font_name
;
7717 = make_fontset_for_ascii_face (f
, default_face
->fontset
, face
);
7721 /* If the face attribute ATTRS specifies a fontset, use it as
7722 the base of a new realized fontset. Otherwise, use the same
7723 base fontset as of the default face. The base determines
7724 registry and encoding of a font. It may also determine
7725 foundry and family. The other fields of font name pattern
7726 are constructed from ATTRS. */
7727 int fontset
= face_fontset (attrs
);
7729 /* If we are realizing the default face, ATTRS should specify a
7730 fontset. In other words, if FONTSET is -1, we are not
7731 realizing the default face, thus the default face should have
7732 already been realized. */
7734 fontset
= default_face
->fontset
;
7737 #ifdef USE_FONT_BACKEND
7738 if (enable_font_backend
)
7739 font_load_for_face (f
, face
);
7741 #endif /* USE_FONT_BACKEND */
7742 load_face_font (f
, face
);
7744 face
->fontset
= make_fontset_for_ascii_face (f
, fontset
, face
);
7749 /* Load colors, and set remaining attributes. */
7751 load_face_colors (f
, face
, attrs
);
7754 box
= attrs
[LFACE_BOX_INDEX
];
7757 /* A simple box of line width 1 drawn in color given by
7759 face
->box_color
= load_color (f
, face
, attrs
[LFACE_BOX_INDEX
],
7761 face
->box
= FACE_SIMPLE_BOX
;
7762 face
->box_line_width
= 1;
7764 else if (INTEGERP (box
))
7766 /* Simple box of specified line width in foreground color of the
7768 xassert (XINT (box
) != 0);
7769 face
->box
= FACE_SIMPLE_BOX
;
7770 face
->box_line_width
= XINT (box
);
7771 face
->box_color
= face
->foreground
;
7772 face
->box_color_defaulted_p
= 1;
7774 else if (CONSP (box
))
7776 /* `(:width WIDTH :color COLOR :shadow SHADOW)'. SHADOW
7777 being one of `raised' or `sunken'. */
7778 face
->box
= FACE_SIMPLE_BOX
;
7779 face
->box_color
= face
->foreground
;
7780 face
->box_color_defaulted_p
= 1;
7781 face
->box_line_width
= 1;
7785 Lisp_Object keyword
, value
;
7787 keyword
= XCAR (box
);
7795 if (EQ (keyword
, QCline_width
))
7797 if (INTEGERP (value
) && XINT (value
) != 0)
7798 face
->box_line_width
= XINT (value
);
7800 else if (EQ (keyword
, QCcolor
))
7802 if (STRINGP (value
))
7804 face
->box_color
= load_color (f
, face
, value
,
7806 face
->use_box_color_for_shadows_p
= 1;
7809 else if (EQ (keyword
, QCstyle
))
7811 if (EQ (value
, Qreleased_button
))
7812 face
->box
= FACE_RAISED_BOX
;
7813 else if (EQ (value
, Qpressed_button
))
7814 face
->box
= FACE_SUNKEN_BOX
;
7819 /* Text underline, overline, strike-through. */
7821 if (EQ (attrs
[LFACE_UNDERLINE_INDEX
], Qt
))
7823 /* Use default color (same as foreground color). */
7824 face
->underline_p
= 1;
7825 face
->underline_defaulted_p
= 1;
7826 face
->underline_color
= 0;
7828 else if (STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]))
7830 /* Use specified color. */
7831 face
->underline_p
= 1;
7832 face
->underline_defaulted_p
= 0;
7833 face
->underline_color
7834 = load_color (f
, face
, attrs
[LFACE_UNDERLINE_INDEX
],
7835 LFACE_UNDERLINE_INDEX
);
7837 else if (NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7839 face
->underline_p
= 0;
7840 face
->underline_defaulted_p
= 0;
7841 face
->underline_color
= 0;
7844 overline
= attrs
[LFACE_OVERLINE_INDEX
];
7845 if (STRINGP (overline
))
7847 face
->overline_color
7848 = load_color (f
, face
, attrs
[LFACE_OVERLINE_INDEX
],
7849 LFACE_OVERLINE_INDEX
);
7850 face
->overline_p
= 1;
7852 else if (EQ (overline
, Qt
))
7854 face
->overline_color
= face
->foreground
;
7855 face
->overline_color_defaulted_p
= 1;
7856 face
->overline_p
= 1;
7859 strike_through
= attrs
[LFACE_STRIKE_THROUGH_INDEX
];
7860 if (STRINGP (strike_through
))
7862 face
->strike_through_color
7863 = load_color (f
, face
, attrs
[LFACE_STRIKE_THROUGH_INDEX
],
7864 LFACE_STRIKE_THROUGH_INDEX
);
7865 face
->strike_through_p
= 1;
7867 else if (EQ (strike_through
, Qt
))
7869 face
->strike_through_color
= face
->foreground
;
7870 face
->strike_through_color_defaulted_p
= 1;
7871 face
->strike_through_p
= 1;
7874 stipple
= attrs
[LFACE_STIPPLE_INDEX
];
7875 if (!NILP (stipple
))
7876 face
->stipple
= load_pixmap (f
, stipple
, &face
->pixmap_w
, &face
->pixmap_h
);
7877 #endif /* HAVE_WINDOW_SYSTEM */
7883 /* Map a specified color of face FACE on frame F to a tty color index.
7884 IDX is either LFACE_FOREGROUND_INDEX or LFACE_BACKGROUND_INDEX, and
7885 specifies which color to map. Set *DEFAULTED to 1 if mapping to the
7886 default foreground/background colors. */
7889 map_tty_color (f
, face
, idx
, defaulted
)
7892 enum lface_attribute_index idx
;
7895 Lisp_Object frame
, color
, def
;
7896 int foreground_p
= idx
== LFACE_FOREGROUND_INDEX
;
7897 unsigned long default_pixel
, default_other_pixel
, pixel
;
7899 xassert (idx
== LFACE_FOREGROUND_INDEX
|| idx
== LFACE_BACKGROUND_INDEX
);
7903 pixel
= default_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7904 default_other_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7908 pixel
= default_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7909 default_other_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7912 XSETFRAME (frame
, f
);
7913 color
= face
->lface
[idx
];
7917 && CONSP (Vtty_defined_color_alist
)
7918 && (def
= assq_no_quit (color
, call1 (Qtty_color_alist
, frame
)),
7921 /* Associations in tty-defined-color-alist are of the form
7922 (NAME INDEX R G B). We need the INDEX part. */
7923 pixel
= XINT (XCAR (XCDR (def
)));
7926 if (pixel
== default_pixel
&& STRINGP (color
))
7928 pixel
= load_color (f
, face
, color
, idx
);
7930 #if defined (MSDOS) || defined (WINDOWSNT)
7931 /* If the foreground of the default face is the default color,
7932 use the foreground color defined by the frame. */
7934 if (FRAME_MSDOS_P (f
))
7937 if (pixel
== default_pixel
7938 || pixel
== FACE_TTY_DEFAULT_COLOR
)
7941 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7943 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7944 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7947 else if (pixel
== default_other_pixel
)
7950 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7952 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7953 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7959 #endif /* MSDOS or WINDOWSNT */
7963 face
->foreground
= pixel
;
7965 face
->background
= pixel
;
7969 /* Realize the fully-specified face with attributes ATTRS in face
7970 cache CACHE for ASCII characters. Do it for TTY frame CACHE->f.
7971 Value is a pointer to the newly created realized face. */
7973 static struct face
*
7974 realize_tty_face (cache
, attrs
)
7975 struct face_cache
*cache
;
7980 int face_colors_defaulted
= 0;
7981 struct frame
*f
= cache
->f
;
7983 /* Frame must be a termcap frame. */
7984 xassert (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
));
7986 /* Allocate a new realized face. */
7987 face
= make_realized_face (attrs
);
7988 face
->font_name
= FRAME_MSDOS_P (cache
->f
) ? "ms-dos" : "tty";
7990 /* Map face attributes to TTY appearances. We map slant to
7991 dimmed text because we want italic text to appear differently
7992 and because dimmed text is probably used infrequently. */
7993 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
7994 slant
= face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
7996 if (weight
> XLFD_WEIGHT_MEDIUM
)
7997 face
->tty_bold_p
= 1;
7998 if (weight
< XLFD_WEIGHT_MEDIUM
|| slant
!= XLFD_SLANT_ROMAN
)
7999 face
->tty_dim_p
= 1;
8000 if (!NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
8001 face
->tty_underline_p
= 1;
8002 if (!NILP (attrs
[LFACE_INVERSE_INDEX
]))
8003 face
->tty_reverse_p
= 1;
8005 /* Map color names to color indices. */
8006 map_tty_color (f
, face
, LFACE_FOREGROUND_INDEX
, &face_colors_defaulted
);
8007 map_tty_color (f
, face
, LFACE_BACKGROUND_INDEX
, &face_colors_defaulted
);
8009 /* Swap colors if face is inverse-video. If the colors are taken
8010 from the frame colors, they are already inverted, since the
8011 frame-creation function calls x-handle-reverse-video. */
8012 if (face
->tty_reverse_p
&& !face_colors_defaulted
)
8014 unsigned long tem
= face
->foreground
;
8015 face
->foreground
= face
->background
;
8016 face
->background
= tem
;
8019 if (tty_suppress_bold_inverse_default_colors_p
8021 && face
->background
== FACE_TTY_DEFAULT_FG_COLOR
8022 && face
->foreground
== FACE_TTY_DEFAULT_BG_COLOR
)
8023 face
->tty_bold_p
= 0;
8029 DEFUN ("tty-suppress-bold-inverse-default-colors",
8030 Ftty_suppress_bold_inverse_default_colors
,
8031 Stty_suppress_bold_inverse_default_colors
, 1, 1, 0,
8032 doc
: /* Suppress/allow boldness of faces with inverse default colors.
8033 SUPPRESS non-nil means suppress it.
8034 This affects bold faces on TTYs whose foreground is the default background
8035 color of the display and whose background is the default foreground color.
8036 For such faces, the bold face attribute is ignored if this variable
8039 Lisp_Object suppress
;
8041 tty_suppress_bold_inverse_default_colors_p
= !NILP (suppress
);
8042 ++face_change_count
;
8048 /***********************************************************************
8050 ***********************************************************************/
8052 /* Return the ID of the face to use to display character CH with face
8053 property PROP on frame F in current_buffer. */
8056 compute_char_face (f
, ch
, prop
)
8063 if (NILP (current_buffer
->enable_multibyte_characters
))
8068 struct face
*face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
8069 face_id
= FACE_FOR_CHAR (f
, face
, ch
, -1, Qnil
);
8073 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
8074 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
8075 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
8076 merge_face_ref (f
, prop
, attrs
, 1, 0);
8077 face_id
= lookup_face (f
, attrs
);
8083 /* Return the face ID associated with buffer position POS for
8084 displaying ASCII characters. Return in *ENDPTR the position at
8085 which a different face is needed, as far as text properties and
8086 overlays are concerned. W is a window displaying current_buffer.
8088 REGION_BEG, REGION_END delimit the region, so it can be
8091 LIMIT is a position not to scan beyond. That is to limit the time
8092 this function can take.
8094 If MOUSE is non-zero, use the character's mouse-face, not its face.
8096 The face returned is suitable for displaying ASCII characters. */
8099 face_at_buffer_position (w
, pos
, region_beg
, region_end
,
8100 endptr
, limit
, mouse
)
8103 int region_beg
, region_end
;
8108 struct frame
*f
= XFRAME (w
->frame
);
8109 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
8110 Lisp_Object prop
, position
;
8112 Lisp_Object
*overlay_vec
;
8115 Lisp_Object propname
= mouse
? Qmouse_face
: Qface
;
8116 Lisp_Object limit1
, end
;
8117 struct face
*default_face
;
8119 /* W must display the current buffer. We could write this function
8120 to use the frame and buffer of W, but right now it doesn't. */
8121 /* xassert (XBUFFER (w->buffer) == current_buffer); */
8123 XSETFRAME (frame
, f
);
8124 XSETFASTINT (position
, pos
);
8127 if (pos
< region_beg
&& region_beg
< endpos
)
8128 endpos
= region_beg
;
8130 /* Get the `face' or `mouse_face' text property at POS, and
8131 determine the next position at which the property changes. */
8132 prop
= Fget_text_property (position
, propname
, w
->buffer
);
8133 XSETFASTINT (limit1
, (limit
< endpos
? limit
: endpos
));
8134 end
= Fnext_single_property_change (position
, propname
, w
->buffer
, limit1
);
8136 endpos
= XINT (end
);
8138 /* Look at properties from overlays. */
8142 GET_OVERLAYS_AT (pos
, overlay_vec
, noverlays
, &next_overlay
, 0);
8143 if (next_overlay
< endpos
)
8144 endpos
= next_overlay
;
8149 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
8151 /* Optimize common cases where we can use the default face. */
8154 && !(pos
>= region_beg
&& pos
< region_end
))
8155 return DEFAULT_FACE_ID
;
8157 /* Begin with attributes from the default face. */
8158 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
8160 /* Merge in attributes specified via text properties. */
8162 merge_face_ref (f
, prop
, attrs
, 1, 0);
8164 /* Now merge the overlay data. */
8165 noverlays
= sort_overlays (overlay_vec
, noverlays
, w
);
8166 for (i
= 0; i
< noverlays
; i
++)
8171 prop
= Foverlay_get (overlay_vec
[i
], propname
);
8173 merge_face_ref (f
, prop
, attrs
, 1, 0);
8175 oend
= OVERLAY_END (overlay_vec
[i
]);
8176 oendpos
= OVERLAY_POSITION (oend
);
8177 if (oendpos
< endpos
)
8181 /* If in the region, merge in the region face. */
8182 if (pos
>= region_beg
&& pos
< region_end
)
8184 merge_named_face (f
, Qregion
, attrs
, 0);
8186 if (region_end
< endpos
)
8187 endpos
= region_end
;
8192 /* Look up a realized face with the given face attributes,
8193 or realize a new one for ASCII characters. */
8194 return lookup_face (f
, attrs
);
8198 /* Compute the face at character position POS in Lisp string STRING on
8199 window W, for ASCII characters.
8201 If STRING is an overlay string, it comes from position BUFPOS in
8202 current_buffer, otherwise BUFPOS is zero to indicate that STRING is
8203 not an overlay string. W must display the current buffer.
8204 REGION_BEG and REGION_END give the start and end positions of the
8205 region; both are -1 if no region is visible.
8207 BASE_FACE_ID is the id of a face to merge with. For strings coming
8208 from overlays or the `display' property it is the face at BUFPOS.
8210 If MOUSE_P is non-zero, use the character's mouse-face, not its face.
8212 Set *ENDPTR to the next position where to check for faces in
8213 STRING; -1 if the face is constant from POS to the end of the
8216 Value is the id of the face to use. The face returned is suitable
8217 for displaying ASCII characters. */
8220 face_at_string_position (w
, string
, pos
, bufpos
, region_beg
,
8221 region_end
, endptr
, base_face_id
, mouse_p
)
8225 int region_beg
, region_end
;
8227 enum face_id base_face_id
;
8230 Lisp_Object prop
, position
, end
, limit
;
8231 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
8232 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
8233 struct face
*base_face
;
8234 int multibyte_p
= STRING_MULTIBYTE (string
);
8235 Lisp_Object prop_name
= mouse_p
? Qmouse_face
: Qface
;
8237 /* Get the value of the face property at the current position within
8238 STRING. Value is nil if there is no face property. */
8239 XSETFASTINT (position
, pos
);
8240 prop
= Fget_text_property (position
, prop_name
, string
);
8242 /* Get the next position at which to check for faces. Value of end
8243 is nil if face is constant all the way to the end of the string.
8244 Otherwise it is a string position where to check faces next.
8245 Limit is the maximum position up to which to check for property
8246 changes in Fnext_single_property_change. Strings are usually
8247 short, so set the limit to the end of the string. */
8248 XSETFASTINT (limit
, SCHARS (string
));
8249 end
= Fnext_single_property_change (position
, prop_name
, string
, limit
);
8251 *endptr
= XFASTINT (end
);
8255 base_face
= FACE_FROM_ID (f
, base_face_id
);
8256 xassert (base_face
);
8258 /* Optimize the default case that there is no face property and we
8259 are not in the region. */
8261 && (base_face_id
!= DEFAULT_FACE_ID
8262 /* BUFPOS <= 0 means STRING is not an overlay string, so
8263 that the region doesn't have to be taken into account. */
8265 || bufpos
< region_beg
8266 || bufpos
>= region_end
)
8268 /* We can't realize faces for different charsets differently
8269 if we don't have fonts, so we can stop here if not working
8270 on a window-system frame. */
8271 || !FRAME_WINDOW_P (f
)
8272 || FACE_SUITABLE_FOR_CHAR_P (base_face
, 0)))
8273 return base_face
->id
;
8275 /* Begin with attributes from the base face. */
8276 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
8278 /* Merge in attributes specified via text properties. */
8280 merge_face_ref (f
, prop
, attrs
, 1, 0);
8282 /* If in the region, merge in the region face. */
8284 && bufpos
>= region_beg
8285 && bufpos
< region_end
)
8286 merge_named_face (f
, Qregion
, attrs
, 0);
8288 /* Look up a realized face with the given face attributes,
8289 or realize a new one for ASCII characters. */
8290 return lookup_face (f
, attrs
);
8294 /* Merge a face into a realized face.
8296 F is frame where faces are (to be) realized.
8298 FACE_NAME is named face to merge.
8300 If FACE_NAME is nil, FACE_ID is face_id of realized face to merge.
8302 If FACE_NAME is t, FACE_ID is lface_id of face to merge.
8304 BASE_FACE_ID is realized face to merge into.
8310 merge_faces (f
, face_name
, face_id
, base_face_id
)
8312 Lisp_Object face_name
;
8313 int face_id
, base_face_id
;
8315 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
8316 struct face
*base_face
;
8318 base_face
= FACE_FROM_ID (f
, base_face_id
);
8320 return base_face_id
;
8322 if (EQ (face_name
, Qt
))
8324 if (face_id
< 0 || face_id
>= lface_id_to_name_size
)
8325 return base_face_id
;
8326 face_name
= lface_id_to_name
[face_id
];
8327 face_id
= lookup_derived_face (f
, face_name
, base_face_id
, 1);
8330 return base_face_id
;
8333 /* Begin with attributes from the base face. */
8334 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
8336 if (!NILP (face_name
))
8338 if (!merge_named_face (f
, face_name
, attrs
, 0))
8339 return base_face_id
;
8345 return base_face_id
;
8346 face
= FACE_FROM_ID (f
, face_id
);
8348 return base_face_id
;
8349 merge_face_vectors (f
, face
->lface
, attrs
, 0);
8352 /* Look up a realized face with the given face attributes,
8353 or realize a new one for ASCII characters. */
8354 return lookup_face (f
, attrs
);
8358 /***********************************************************************
8360 ***********************************************************************/
8364 /* Print the contents of the realized face FACE to stderr. */
8367 dump_realized_face (face
)
8370 fprintf (stderr
, "ID: %d\n", face
->id
);
8371 #ifdef HAVE_X_WINDOWS
8372 fprintf (stderr
, "gc: %ld\n", (long) face
->gc
);
8374 fprintf (stderr
, "foreground: 0x%lx (%s)\n",
8376 SDATA (face
->lface
[LFACE_FOREGROUND_INDEX
]));
8377 fprintf (stderr
, "background: 0x%lx (%s)\n",
8379 SDATA (face
->lface
[LFACE_BACKGROUND_INDEX
]));
8380 fprintf (stderr
, "font_name: %s (%s)\n",
8382 SDATA (face
->lface
[LFACE_FAMILY_INDEX
]));
8383 #ifdef HAVE_X_WINDOWS
8384 fprintf (stderr
, "font = %p\n", face
->font
);
8386 fprintf (stderr
, "font_info_id = %d\n", face
->font_info_id
);
8387 fprintf (stderr
, "fontset: %d\n", face
->fontset
);
8388 fprintf (stderr
, "underline: %d (%s)\n",
8390 SDATA (Fsymbol_name (face
->lface
[LFACE_UNDERLINE_INDEX
])));
8391 fprintf (stderr
, "hash: %d\n", face
->hash
);
8395 DEFUN ("dump-face", Fdump_face
, Sdump_face
, 0, 1, 0, doc
: /* */)
8403 fprintf (stderr
, "font selection order: ");
8404 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
8405 fprintf (stderr
, "%d ", font_sort_order
[i
]);
8406 fprintf (stderr
, "\n");
8408 fprintf (stderr
, "alternative fonts: ");
8409 debug_print (Vface_alternative_font_family_alist
);
8410 fprintf (stderr
, "\n");
8412 for (i
= 0; i
< FRAME_FACE_CACHE (SELECTED_FRAME ())->used
; ++i
)
8413 Fdump_face (make_number (i
));
8419 face
= FACE_FROM_ID (SELECTED_FRAME (), XINT (n
));
8421 error ("Not a valid face");
8422 dump_realized_face (face
);
8429 DEFUN ("show-face-resources", Fshow_face_resources
, Sshow_face_resources
,
8430 0, 0, 0, doc
: /* */)
8433 fprintf (stderr
, "number of colors = %d\n", ncolors_allocated
);
8434 fprintf (stderr
, "number of pixmaps = %d\n", npixmaps_allocated
);
8435 fprintf (stderr
, "number of GCs = %d\n", ngcs
);
8439 #endif /* GLYPH_DEBUG != 0 */
8443 /***********************************************************************
8445 ***********************************************************************/
8450 Qface
= intern ("face");
8452 Qface_no_inherit
= intern ("face-no-inherit");
8453 staticpro (&Qface_no_inherit
);
8454 Qbitmap_spec_p
= intern ("bitmap-spec-p");
8455 staticpro (&Qbitmap_spec_p
);
8456 Qframe_set_background_mode
= intern ("frame-set-background-mode");
8457 staticpro (&Qframe_set_background_mode
);
8459 /* Lisp face attribute keywords. */
8460 QCfamily
= intern (":family");
8461 staticpro (&QCfamily
);
8462 QCheight
= intern (":height");
8463 staticpro (&QCheight
);
8464 QCweight
= intern (":weight");
8465 staticpro (&QCweight
);
8466 QCslant
= intern (":slant");
8467 staticpro (&QCslant
);
8468 QCunderline
= intern (":underline");
8469 staticpro (&QCunderline
);
8470 QCinverse_video
= intern (":inverse-video");
8471 staticpro (&QCinverse_video
);
8472 QCreverse_video
= intern (":reverse-video");
8473 staticpro (&QCreverse_video
);
8474 QCforeground
= intern (":foreground");
8475 staticpro (&QCforeground
);
8476 QCbackground
= intern (":background");
8477 staticpro (&QCbackground
);
8478 QCstipple
= intern (":stipple");;
8479 staticpro (&QCstipple
);
8480 QCwidth
= intern (":width");
8481 staticpro (&QCwidth
);
8482 QCfont
= intern (":font");
8483 staticpro (&QCfont
);
8484 QCfontset
= intern (":fontset");
8485 staticpro (&QCfontset
);
8486 QCbold
= intern (":bold");
8487 staticpro (&QCbold
);
8488 QCitalic
= intern (":italic");
8489 staticpro (&QCitalic
);
8490 QCoverline
= intern (":overline");
8491 staticpro (&QCoverline
);
8492 QCstrike_through
= intern (":strike-through");
8493 staticpro (&QCstrike_through
);
8494 QCbox
= intern (":box");
8496 QCinherit
= intern (":inherit");
8497 staticpro (&QCinherit
);
8499 /* Symbols used for Lisp face attribute values. */
8500 QCcolor
= intern (":color");
8501 staticpro (&QCcolor
);
8502 QCline_width
= intern (":line-width");
8503 staticpro (&QCline_width
);
8504 QCstyle
= intern (":style");
8505 staticpro (&QCstyle
);
8506 Qreleased_button
= intern ("released-button");
8507 staticpro (&Qreleased_button
);
8508 Qpressed_button
= intern ("pressed-button");
8509 staticpro (&Qpressed_button
);
8510 Qnormal
= intern ("normal");
8511 staticpro (&Qnormal
);
8512 Qultra_light
= intern ("ultra-light");
8513 staticpro (&Qultra_light
);
8514 Qextra_light
= intern ("extra-light");
8515 staticpro (&Qextra_light
);
8516 Qlight
= intern ("light");
8517 staticpro (&Qlight
);
8518 Qsemi_light
= intern ("semi-light");
8519 staticpro (&Qsemi_light
);
8520 Qsemi_bold
= intern ("semi-bold");
8521 staticpro (&Qsemi_bold
);
8522 Qbold
= intern ("bold");
8524 Qextra_bold
= intern ("extra-bold");
8525 staticpro (&Qextra_bold
);
8526 Qultra_bold
= intern ("ultra-bold");
8527 staticpro (&Qultra_bold
);
8528 Qoblique
= intern ("oblique");
8529 staticpro (&Qoblique
);
8530 Qitalic
= intern ("italic");
8531 staticpro (&Qitalic
);
8532 Qreverse_oblique
= intern ("reverse-oblique");
8533 staticpro (&Qreverse_oblique
);
8534 Qreverse_italic
= intern ("reverse-italic");
8535 staticpro (&Qreverse_italic
);
8536 Qultra_condensed
= intern ("ultra-condensed");
8537 staticpro (&Qultra_condensed
);
8538 Qextra_condensed
= intern ("extra-condensed");
8539 staticpro (&Qextra_condensed
);
8540 Qcondensed
= intern ("condensed");
8541 staticpro (&Qcondensed
);
8542 Qsemi_condensed
= intern ("semi-condensed");
8543 staticpro (&Qsemi_condensed
);
8544 Qsemi_expanded
= intern ("semi-expanded");
8545 staticpro (&Qsemi_expanded
);
8546 Qexpanded
= intern ("expanded");
8547 staticpro (&Qexpanded
);
8548 Qextra_expanded
= intern ("extra-expanded");
8549 staticpro (&Qextra_expanded
);
8550 Qultra_expanded
= intern ("ultra-expanded");
8551 staticpro (&Qultra_expanded
);
8552 Qbackground_color
= intern ("background-color");
8553 staticpro (&Qbackground_color
);
8554 Qforeground_color
= intern ("foreground-color");
8555 staticpro (&Qforeground_color
);
8556 Qunspecified
= intern ("unspecified");
8557 staticpro (&Qunspecified
);
8558 Qignore_defface
= intern (":ignore-defface");
8559 staticpro (&Qignore_defface
);
8561 Qface_alias
= intern ("face-alias");
8562 staticpro (&Qface_alias
);
8563 Qdefault
= intern ("default");
8564 staticpro (&Qdefault
);
8565 Qtool_bar
= intern ("tool-bar");
8566 staticpro (&Qtool_bar
);
8567 Qregion
= intern ("region");
8568 staticpro (&Qregion
);
8569 Qfringe
= intern ("fringe");
8570 staticpro (&Qfringe
);
8571 Qheader_line
= intern ("header-line");
8572 staticpro (&Qheader_line
);
8573 Qscroll_bar
= intern ("scroll-bar");
8574 staticpro (&Qscroll_bar
);
8575 Qmenu
= intern ("menu");
8577 Qcursor
= intern ("cursor");
8578 staticpro (&Qcursor
);
8579 Qborder
= intern ("border");
8580 staticpro (&Qborder
);
8581 Qmouse
= intern ("mouse");
8582 staticpro (&Qmouse
);
8583 Qmode_line_inactive
= intern ("mode-line-inactive");
8584 staticpro (&Qmode_line_inactive
);
8585 Qvertical_border
= intern ("vertical-border");
8586 staticpro (&Qvertical_border
);
8587 Qtty_color_desc
= intern ("tty-color-desc");
8588 staticpro (&Qtty_color_desc
);
8589 Qtty_color_standard_values
= intern ("tty-color-standard-values");
8590 staticpro (&Qtty_color_standard_values
);
8591 Qtty_color_by_index
= intern ("tty-color-by-index");
8592 staticpro (&Qtty_color_by_index
);
8593 Qtty_color_alist
= intern ("tty-color-alist");
8594 staticpro (&Qtty_color_alist
);
8595 Qscalable_fonts_allowed
= intern ("scalable-fonts-allowed");
8596 staticpro (&Qscalable_fonts_allowed
);
8598 Vparam_value_alist
= Fcons (Fcons (Qnil
, Qnil
), Qnil
);
8599 staticpro (&Vparam_value_alist
);
8600 Vface_alternative_font_family_alist
= Qnil
;
8601 staticpro (&Vface_alternative_font_family_alist
);
8602 Vface_alternative_font_registry_alist
= Qnil
;
8603 staticpro (&Vface_alternative_font_registry_alist
);
8605 defsubr (&Sinternal_make_lisp_face
);
8606 defsubr (&Sinternal_lisp_face_p
);
8607 defsubr (&Sinternal_set_lisp_face_attribute
);
8608 #ifdef HAVE_WINDOW_SYSTEM
8609 defsubr (&Sinternal_set_lisp_face_attribute_from_resource
);
8611 defsubr (&Scolor_gray_p
);
8612 defsubr (&Scolor_supported_p
);
8613 defsubr (&Sface_attribute_relative_p
);
8614 defsubr (&Smerge_face_attribute
);
8615 defsubr (&Sinternal_get_lisp_face_attribute
);
8616 defsubr (&Sinternal_lisp_face_attribute_values
);
8617 defsubr (&Sinternal_lisp_face_equal_p
);
8618 defsubr (&Sinternal_lisp_face_empty_p
);
8619 defsubr (&Sinternal_copy_lisp_face
);
8620 defsubr (&Sinternal_merge_in_global_face
);
8621 defsubr (&Sface_font
);
8622 defsubr (&Sframe_face_alist
);
8623 defsubr (&Sdisplay_supports_face_attributes_p
);
8624 defsubr (&Scolor_distance
);
8625 defsubr (&Sinternal_set_font_selection_order
);
8626 defsubr (&Sinternal_set_alternative_font_family_alist
);
8627 defsubr (&Sinternal_set_alternative_font_registry_alist
);
8628 defsubr (&Sface_attributes_as_vector
);
8630 defsubr (&Sdump_face
);
8631 defsubr (&Sshow_face_resources
);
8632 #endif /* GLYPH_DEBUG */
8633 defsubr (&Sclear_face_cache
);
8634 defsubr (&Stty_suppress_bold_inverse_default_colors
);
8636 #if defined DEBUG_X_COLORS && defined HAVE_X_WINDOWS
8637 defsubr (&Sdump_colors
);
8640 DEFVAR_LISP ("font-list-limit", &Vfont_list_limit
,
8641 doc
: /* *Limit for font matching.
8642 If an integer > 0, font matching functions won't load more than
8643 that number of fonts when searching for a matching font. */);
8644 Vfont_list_limit
= make_number (DEFAULT_FONT_LIST_LIMIT
);
8646 DEFVAR_LISP ("face-new-frame-defaults", &Vface_new_frame_defaults
,
8647 doc
: /* List of global face definitions (for internal use only.) */);
8648 Vface_new_frame_defaults
= Qnil
;
8650 DEFVAR_LISP ("face-default-stipple", &Vface_default_stipple
,
8651 doc
: /* *Default stipple pattern used on monochrome displays.
8652 This stipple pattern is used on monochrome displays
8653 instead of shades of gray for a face background color.
8654 See `set-face-stipple' for possible values for this variable. */);
8655 Vface_default_stipple
= build_string ("gray3");
8657 DEFVAR_LISP ("tty-defined-color-alist", &Vtty_defined_color_alist
,
8658 doc
: /* An alist of defined terminal colors and their RGB values. */);
8659 Vtty_defined_color_alist
= Qnil
;
8661 DEFVAR_LISP ("scalable-fonts-allowed", &Vscalable_fonts_allowed
,
8662 doc
: /* Allowed scalable fonts.
8663 A value of nil means don't allow any scalable fonts.
8664 A value of t means allow any scalable font.
8665 Otherwise, value must be a list of regular expressions. A font may be
8666 scaled if its name matches a regular expression in the list.
8667 Note that if value is nil, a scalable font might still be used, if no
8668 other font of the appropriate family and registry is available. */);
8669 Vscalable_fonts_allowed
= Qnil
;
8671 DEFVAR_LISP ("face-ignored-fonts", &Vface_ignored_fonts
,
8672 doc
: /* List of ignored fonts.
8673 Each element is a regular expression that matches names of fonts to
8675 Vface_ignored_fonts
= Qnil
;
8677 DEFVAR_LISP ("face-font-rescale-alist", &Vface_font_rescale_alist
,
8678 doc
: /* Alist of fonts vs the rescaling factors.
8679 Each element is a cons (FONT-NAME-PATTERN . RESCALE-RATIO), where
8680 FONT-NAME-PATTERN is a regular expression matching a font name, and
8681 RESCALE-RATIO is a floating point number to specify how much larger
8682 \(or smaller) font we should use. For instance, if a face requests
8683 a font of 10 point, we actually use a font of 10 * RESCALE-RATIO point. */);
8684 Vface_font_rescale_alist
= Qnil
;
8686 #ifdef HAVE_WINDOW_SYSTEM
8687 defsubr (&Sbitmap_spec_p
);
8688 defsubr (&Sx_list_fonts
);
8689 defsubr (&Sinternal_face_x_get_resource
);
8690 defsubr (&Sx_family_fonts
);
8691 defsubr (&Sx_font_family_list
);
8692 #endif /* HAVE_WINDOW_SYSTEM */
8695 /* arch-tag: 8a0f7598-5517-408d-9ab3-1da6fcd4c749
8696 (do not change this comment) */