1 /* xfaces.c -- "Face" primitives.
2 Copyright (C) 1993, 1994, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
3 2005 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
20 Boston, MA 02110-1301, USA. */
22 /* New face implementation by Gerd Moellmann <gerd@gnu.org>. */
26 When using Emacs with X, the display style of characters can be
27 changed by defining `faces'. Each face can specify the following
32 2. Relative proportionate width, aka character set width or set
33 width (swidth), e.g. `semi-compressed'.
35 3. Font height in 1/10pt.
37 4. Font weight, e.g. `bold'.
39 5. Font slant, e.g. `italic'.
45 8. Whether or not characters should be underlined, and in what color.
47 9. Whether or not characters should be displayed in inverse video.
49 10. A background stipple, a bitmap.
51 11. Whether or not characters should be overlined, and in what color.
53 12. Whether or not characters should be strike-through, and in what
56 13. Whether or not a box should be drawn around characters, the box
57 type, and, for simple boxes, in what color.
59 14. Font or fontset pattern, or nil. This is a special attribute.
60 When this attribute is specified, the face uses a font opened by
61 that pattern as is. In addition, all the other font-related
62 attributes (1st thru 5th) are generated from the opened font name.
63 On the other hand, if one of the other font-related attributes are
64 specified, this attribute is set to nil. In that case, the face
65 doesn't inherit this attribute from the `default' face, and uses a
66 font determined by the other attributes (those may be inherited
67 from the `default' face).
69 15. A face name or list of face names from which to inherit attributes.
71 16. A specified average font width, which is invisible from Lisp,
72 and is used to ensure that a font specified on the command line,
73 for example, can be matched exactly.
75 Faces are frame-local by nature because Emacs allows to define the
76 same named face (face names are symbols) differently for different
77 frames. Each frame has an alist of face definitions for all named
78 faces. The value of a named face in such an alist is a Lisp vector
79 with the symbol `face' in slot 0, and a slot for each of the face
80 attributes mentioned above.
82 There is also a global face alist `Vface_new_frame_defaults'. Face
83 definitions from this list are used to initialize faces of newly
86 A face doesn't have to specify all attributes. Those not specified
87 have a value of `unspecified'. Faces specifying all attributes but
88 the 14th are called `fully-specified'.
93 The display style of a given character in the text is determined by
94 combining several faces. This process is called `face merging'.
95 Any aspect of the display style that isn't specified by overlays or
96 text properties is taken from the `default' face. Since it is made
97 sure that the default face is always fully-specified, face merging
98 always results in a fully-specified face.
103 After all face attributes for a character have been determined by
104 merging faces of that character, that face is `realized'. The
105 realization process maps face attributes to what is physically
106 available on the system where Emacs runs. The result is a
107 `realized face' in form of a struct face which is stored in the
108 face cache of the frame on which it was realized.
110 Face realization is done in the context of the character to display
111 because different fonts may be used for different characters. In
112 other words, for characters that have different font
113 specifications, different realized faces are needed to display
116 Font specification is done by fontsets. See the comment in
117 fontset.c for the details. In the current implementation, all ASCII
118 characters share the same font in a fontset.
120 Faces are at first realized for ASCII characters, and, at that
121 time, assigned a specific realized fontset. Hereafter, we call
122 such a face as `ASCII face'. When a face for a multibyte character
123 is realized, it inherits (thus shares) a fontset of an ASCII face
124 that has the same attributes other than font-related ones.
126 Thus, all realized face have a realized fontset.
131 Unibyte text (i.e. raw 8-bit characters) is displayed with the same
132 font as ASCII characters. That is because it is expected that
133 unibyte text users specify a font that is suitable both for ASCII
134 and raw 8-bit characters.
139 Font selection tries to find the best available matching font for a
140 given (character, face) combination.
142 If the face specifies a fontset name, that fontset determines a
143 pattern for fonts of the given character. If the face specifies a
144 font name or the other font-related attributes, a fontset is
145 realized from the default fontset. In that case, that
146 specification determines a pattern for ASCII characters and the
147 default fontset determines a pattern for multibyte characters.
149 Available fonts on the system on which Emacs runs are then matched
150 against the font pattern. The result of font selection is the best
151 match for the given face attributes in this font list.
153 Font selection can be influenced by the user.
155 1. The user can specify the relative importance he gives the face
156 attributes width, height, weight, and slant by setting
157 face-font-selection-order (faces.el) to a list of face attribute
158 names. The default is '(:width :height :weight :slant), and means
159 that font selection first tries to find a good match for the font
160 width specified by a face, then---within fonts with that
161 width---tries to find a best match for the specified font height,
164 2. Setting face-font-family-alternatives allows the user to
165 specify alternative font families to try if a family specified by a
168 3. Setting face-font-registry-alternatives allows the user to
169 specify all alternative font registries to try for a face
170 specifying a registry.
172 4. Setting face-ignored-fonts allows the user to ignore specific
176 Character composition.
178 Usually, the realization process is already finished when Emacs
179 actually reflects the desired glyph matrix on the screen. However,
180 on displaying a composition (sequence of characters to be composed
181 on the screen), a suitable font for the components of the
182 composition is selected and realized while drawing them on the
183 screen, i.e. the realization process is delayed but in principle
187 Initialization of basic faces.
189 The faces `default', `modeline' are considered `basic faces'.
190 When redisplay happens the first time for a newly created frame,
191 basic faces are realized for CHARSET_ASCII. Frame parameters are
192 used to fill in unspecified attributes of the default face. */
196 #include <sys/types.h>
197 #include <sys/stat.h>
201 #include "keyboard.h"
204 #ifdef HAVE_WINDOW_SYSTEM
206 #endif /* HAVE_WINDOW_SYSTEM */
208 #ifdef HAVE_X_WINDOWS
212 #include <Xm/XmStrDefs.h>
213 #endif /* USE_MOTIF */
214 #endif /* HAVE_X_WINDOWS */
223 /* Redefine X specifics to W32 equivalents to avoid cluttering the
224 code with #ifdef blocks. */
225 #undef FRAME_X_DISPLAY_INFO
226 #define FRAME_X_DISPLAY_INFO FRAME_W32_DISPLAY_INFO
227 #define x_display_info w32_display_info
228 #define FRAME_X_FONT_TABLE FRAME_W32_FONT_TABLE
229 #define check_x check_w32
230 #define x_list_fonts w32_list_fonts
231 #define GCGraphicsExposures 0
232 #endif /* WINDOWSNT */
236 #define x_display_info mac_display_info
237 #define check_x check_mac
241 #include "dispextern.h"
242 #include "blockinput.h"
244 #include "intervals.h"
246 #ifdef HAVE_X_WINDOWS
248 /* Compensate for a bug in Xos.h on some systems, on which it requires
249 time.h. On some such systems, Xos.h tries to redefine struct
250 timeval and struct timezone if USG is #defined while it is
253 #ifdef XOS_NEEDS_TIME_H
259 #else /* not XOS_NEEDS_TIME_H */
261 #endif /* not XOS_NEEDS_TIME_H */
263 #endif /* HAVE_X_WINDOWS */
267 #define abs(X) ((X) < 0 ? -(X) : (X))
269 /* Number of pt per inch (from the TeXbook). */
271 #define PT_PER_INCH 72.27
273 /* Non-zero if face attribute ATTR is unspecified. */
275 #define UNSPECIFIEDP(ATTR) EQ ((ATTR), Qunspecified)
277 /* Value is the number of elements of VECTOR. */
279 #define DIM(VECTOR) (sizeof (VECTOR) / sizeof *(VECTOR))
281 /* Make a copy of string S on the stack using alloca. Value is a pointer
284 #define STRDUPA(S) strcpy ((char *) alloca (strlen ((S)) + 1), (S))
286 /* Make a copy of the contents of Lisp string S on the stack using
287 alloca. Value is a pointer to the copy. */
289 #define LSTRDUPA(S) STRDUPA (SDATA ((S)))
291 /* Size of hash table of realized faces in face caches (should be a
294 #define FACE_CACHE_BUCKETS_SIZE 1001
296 /* Keyword symbols used for face attribute names. */
298 Lisp_Object QCfamily
, QCheight
, QCweight
, QCslant
, QCunderline
;
299 Lisp_Object QCinverse_video
, QCforeground
, QCbackground
, QCstipple
;
300 Lisp_Object QCwidth
, QCfont
, QCbold
, QCitalic
;
301 Lisp_Object QCreverse_video
;
302 Lisp_Object QCoverline
, QCstrike_through
, QCbox
, QCinherit
;
304 /* Symbols used for attribute values. */
306 Lisp_Object Qnormal
, Qbold
, Qultra_light
, Qextra_light
, Qlight
;
307 Lisp_Object Qsemi_light
, Qsemi_bold
, Qextra_bold
, Qultra_bold
;
308 Lisp_Object Qoblique
, Qitalic
, Qreverse_oblique
, Qreverse_italic
;
309 Lisp_Object Qultra_condensed
, Qextra_condensed
, Qcondensed
;
310 Lisp_Object Qsemi_condensed
, Qsemi_expanded
, Qexpanded
, Qextra_expanded
;
311 Lisp_Object Qultra_expanded
;
312 Lisp_Object Qreleased_button
, Qpressed_button
;
313 Lisp_Object QCstyle
, QCcolor
, QCline_width
;
314 Lisp_Object Qunspecified
;
316 char unspecified_fg
[] = "unspecified-fg", unspecified_bg
[] = "unspecified-bg";
318 /* The name of the function to call when the background of the frame
319 has changed, frame_set_background_mode. */
321 Lisp_Object Qframe_set_background_mode
;
323 /* Names of basic faces. */
325 Lisp_Object Qdefault
, Qtool_bar
, Qregion
, Qfringe
;
326 Lisp_Object Qheader_line
, Qscroll_bar
, Qcursor
, Qborder
, Qmouse
, Qmenu
;
327 Lisp_Object Qmode_line_inactive
, Qvertical_border
;
328 extern Lisp_Object Qmode_line
;
330 /* The symbol `face-alias'. A symbols having that property is an
331 alias for another face. Value of the property is the name of
334 Lisp_Object Qface_alias
;
336 extern Lisp_Object Qcircular_list
;
338 /* Default stipple pattern used on monochrome displays. This stipple
339 pattern is used on monochrome displays instead of shades of gray
340 for a face background color. See `set-face-stipple' for possible
341 values for this variable. */
343 Lisp_Object Vface_default_stipple
;
345 /* Alist of alternative font families. Each element is of the form
346 (FAMILY FAMILY1 FAMILY2 ...). If fonts of FAMILY can't be loaded,
347 try FAMILY1, then FAMILY2, ... */
349 Lisp_Object Vface_alternative_font_family_alist
;
351 /* Alist of alternative font registries. Each element is of the form
352 (REGISTRY REGISTRY1 REGISTRY2...). If fonts of REGISTRY can't be
353 loaded, try REGISTRY1, then REGISTRY2, ... */
355 Lisp_Object Vface_alternative_font_registry_alist
;
357 /* Allowed scalable fonts. A value of nil means don't allow any
358 scalable fonts. A value of t means allow the use of any scalable
359 font. Otherwise, value must be a list of regular expressions. A
360 font may be scaled if its name matches a regular expression in the
363 Lisp_Object Vscalable_fonts_allowed
, Qscalable_fonts_allowed
;
365 /* List of regular expressions that matches names of fonts to ignore. */
367 Lisp_Object Vface_ignored_fonts
;
369 /* Alist of font name patterns vs the rescaling factor. */
371 Lisp_Object Vface_font_rescale_alist
;
373 /* Maximum number of fonts to consider in font_list. If not an
374 integer > 0, DEFAULT_FONT_LIST_LIMIT is used instead. */
376 Lisp_Object Vfont_list_limit
;
377 #define DEFAULT_FONT_LIST_LIMIT 100
379 /* The symbols `foreground-color' and `background-color' which can be
380 used as part of a `face' property. This is for compatibility with
383 Lisp_Object Qforeground_color
, Qbackground_color
;
385 /* The symbols `face' and `mouse-face' used as text properties. */
388 extern Lisp_Object Qmouse_face
;
390 /* Property for basic faces which other faces cannot inherit. */
392 Lisp_Object Qface_no_inherit
;
394 /* Error symbol for wrong_type_argument in load_pixmap. */
396 Lisp_Object Qbitmap_spec_p
;
398 /* Alist of global face definitions. Each element is of the form
399 (FACE . LFACE) where FACE is a symbol naming a face and LFACE
400 is a Lisp vector of face attributes. These faces are used
401 to initialize faces for new frames. */
403 Lisp_Object Vface_new_frame_defaults
;
405 /* The next ID to assign to Lisp faces. */
407 static int next_lface_id
;
409 /* A vector mapping Lisp face Id's to face names. */
411 static Lisp_Object
*lface_id_to_name
;
412 static int lface_id_to_name_size
;
414 /* TTY color-related functions (defined in tty-colors.el). */
416 Lisp_Object Qtty_color_desc
, Qtty_color_by_index
, Qtty_color_standard_values
;
418 /* The name of the function used to compute colors on TTYs. */
420 Lisp_Object Qtty_color_alist
;
422 /* An alist of defined terminal colors and their RGB values. */
424 Lisp_Object Vtty_defined_color_alist
;
426 /* Counter for calls to clear_face_cache. If this counter reaches
427 CLEAR_FONT_TABLE_COUNT, and a frame has more than
428 CLEAR_FONT_TABLE_NFONTS load, unused fonts are freed. */
430 static int clear_font_table_count
;
431 #define CLEAR_FONT_TABLE_COUNT 100
432 #define CLEAR_FONT_TABLE_NFONTS 10
434 /* Non-zero means face attributes have been changed since the last
435 redisplay. Used in redisplay_internal. */
437 int face_change_count
;
439 /* Non-zero means don't display bold text if a face's foreground
440 and background colors are the inverse of the default colors of the
441 display. This is a kluge to suppress `bold black' foreground text
442 which is hard to read on an LCD monitor. */
444 int tty_suppress_bold_inverse_default_colors_p
;
446 /* A list of the form `((x . y))' used to avoid consing in
447 Finternal_set_lisp_face_attribute. */
449 static Lisp_Object Vparam_value_alist
;
451 /* The total number of colors currently allocated. */
454 static int ncolors_allocated
;
455 static int npixmaps_allocated
;
459 /* Non-zero means the definition of the `menu' face for new frames has
462 int menu_face_changed_default
;
465 /* Function prototypes. */
469 struct named_merge_point
;
471 static void map_tty_color
P_ ((struct frame
*, struct face
*,
472 enum lface_attribute_index
, int *));
473 static Lisp_Object resolve_face_name
P_ ((Lisp_Object
, int));
474 static int may_use_scalable_font_p
P_ ((const char *));
475 static void set_font_frame_param
P_ ((Lisp_Object
, Lisp_Object
));
476 static int better_font_p
P_ ((int *, struct font_name
*, struct font_name
*,
478 static int x_face_list_fonts
P_ ((struct frame
*, char *,
479 struct font_name
**, int, int));
480 static int font_scalable_p
P_ ((struct font_name
*));
481 static int get_lface_attributes
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*, int));
482 static int load_pixmap
P_ ((struct frame
*, Lisp_Object
, unsigned *, unsigned *));
483 static unsigned char *xstrlwr
P_ ((unsigned char *));
484 static void signal_error
P_ ((char *, Lisp_Object
));
485 static struct frame
*frame_or_selected_frame
P_ ((Lisp_Object
, int));
486 static void load_face_font
P_ ((struct frame
*, struct face
*, int));
487 static void load_face_colors
P_ ((struct frame
*, struct face
*, Lisp_Object
*));
488 static void free_face_colors
P_ ((struct frame
*, struct face
*));
489 static int face_color_gray_p
P_ ((struct frame
*, char *));
490 static char *build_font_name
P_ ((struct font_name
*));
491 static void free_font_names
P_ ((struct font_name
*, int));
492 static int sorted_font_list
P_ ((struct frame
*, char *,
493 int (*cmpfn
) P_ ((const void *, const void *)),
494 struct font_name
**));
495 static int font_list_1
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
496 Lisp_Object
, struct font_name
**));
497 static int font_list
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
498 Lisp_Object
, struct font_name
**));
499 static int try_font_list
P_ ((struct frame
*, Lisp_Object
*,
500 Lisp_Object
, Lisp_Object
, struct font_name
**,
502 static int try_alternative_families
P_ ((struct frame
*f
, Lisp_Object
,
503 Lisp_Object
, struct font_name
**));
504 static int cmp_font_names
P_ ((const void *, const void *));
505 static struct face
*realize_face
P_ ((struct face_cache
*, Lisp_Object
*, int,
506 struct face
*, int));
507 static struct face
*realize_x_face
P_ ((struct face_cache
*,
508 Lisp_Object
*, int, struct face
*));
509 static struct face
*realize_tty_face
P_ ((struct face_cache
*,
510 Lisp_Object
*, int));
511 static int realize_basic_faces
P_ ((struct frame
*));
512 static int realize_default_face
P_ ((struct frame
*));
513 static void realize_named_face
P_ ((struct frame
*, Lisp_Object
, int));
514 static int lface_fully_specified_p
P_ ((Lisp_Object
*));
515 static int lface_equal_p
P_ ((Lisp_Object
*, Lisp_Object
*));
516 static unsigned hash_string_case_insensitive
P_ ((Lisp_Object
));
517 static unsigned lface_hash
P_ ((Lisp_Object
*));
518 static int lface_same_font_attributes_p
P_ ((Lisp_Object
*, Lisp_Object
*));
519 static struct face_cache
*make_face_cache
P_ ((struct frame
*));
520 static void free_realized_face
P_ ((struct frame
*, struct face
*));
521 static void clear_face_gcs
P_ ((struct face_cache
*));
522 static void free_face_cache
P_ ((struct face_cache
*));
523 static int face_numeric_weight
P_ ((Lisp_Object
));
524 static int face_numeric_slant
P_ ((Lisp_Object
));
525 static int face_numeric_swidth
P_ ((Lisp_Object
));
526 static int face_fontset
P_ ((Lisp_Object
*));
527 static char *choose_face_font
P_ ((struct frame
*, Lisp_Object
*, int, int, int*));
528 static void merge_face_vectors
P_ ((struct frame
*, Lisp_Object
*, Lisp_Object
*,
529 struct named_merge_point
*));
530 static int merge_face_ref
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*,
531 int, struct named_merge_point
*));
532 static int set_lface_from_font_name
P_ ((struct frame
*, Lisp_Object
,
533 Lisp_Object
, int, int));
534 static Lisp_Object lface_from_face_name
P_ ((struct frame
*, Lisp_Object
, int));
535 static struct face
*make_realized_face
P_ ((Lisp_Object
*));
536 static void free_realized_faces
P_ ((struct face_cache
*));
537 static char *best_matching_font
P_ ((struct frame
*, Lisp_Object
*,
538 struct font_name
*, int, int, int *));
539 static void cache_face
P_ ((struct face_cache
*, struct face
*, unsigned));
540 static void uncache_face
P_ ((struct face_cache
*, struct face
*));
541 static int xlfd_numeric_slant
P_ ((struct font_name
*));
542 static int xlfd_numeric_weight
P_ ((struct font_name
*));
543 static int xlfd_numeric_swidth
P_ ((struct font_name
*));
544 static Lisp_Object xlfd_symbolic_slant
P_ ((struct font_name
*));
545 static Lisp_Object xlfd_symbolic_weight
P_ ((struct font_name
*));
546 static Lisp_Object xlfd_symbolic_swidth
P_ ((struct font_name
*));
547 static int xlfd_fixed_p
P_ ((struct font_name
*));
548 static int xlfd_numeric_value
P_ ((struct table_entry
*, int, struct font_name
*,
550 static Lisp_Object xlfd_symbolic_value
P_ ((struct table_entry
*, int,
551 struct font_name
*, int,
553 static struct table_entry
*xlfd_lookup_field_contents
P_ ((struct table_entry
*, int,
554 struct font_name
*, int));
556 #ifdef HAVE_WINDOW_SYSTEM
558 static int split_font_name
P_ ((struct frame
*, struct font_name
*, int));
559 static int xlfd_point_size
P_ ((struct frame
*, struct font_name
*));
560 static void sort_fonts
P_ ((struct frame
*, struct font_name
*, int,
561 int (*cmpfn
) P_ ((const void *, const void *))));
562 static GC x_create_gc
P_ ((struct frame
*, unsigned long, XGCValues
*));
563 static void x_free_gc
P_ ((struct frame
*, GC
));
564 static void clear_font_table
P_ ((struct x_display_info
*));
567 extern Lisp_Object w32_list_fonts
P_ ((struct frame
*, Lisp_Object
, int, int));
568 #endif /* WINDOWSNT */
571 static void x_update_menu_appearance
P_ ((struct frame
*));
573 extern void free_frame_menubar
P_ ((struct frame
*));
574 #endif /* USE_X_TOOLKIT */
576 #endif /* HAVE_WINDOW_SYSTEM */
579 /***********************************************************************
581 ***********************************************************************/
583 #ifdef HAVE_X_WINDOWS
585 #ifdef DEBUG_X_COLORS
587 /* The following is a poor mans infrastructure for debugging X color
588 allocation problems on displays with PseudoColor-8. Some X servers
589 like 3.3.5 XF86_SVGA with Matrox cards apparently don't implement
590 color reference counts completely so that they don't signal an
591 error when a color is freed whose reference count is already 0.
592 Other X servers do. To help me debug this, the following code
593 implements a simple reference counting schema of its own, for a
594 single display/screen. --gerd. */
596 /* Reference counts for pixel colors. */
598 int color_count
[256];
600 /* Register color PIXEL as allocated. */
603 register_color (pixel
)
606 xassert (pixel
< 256);
607 ++color_count
[pixel
];
611 /* Register color PIXEL as deallocated. */
614 unregister_color (pixel
)
617 xassert (pixel
< 256);
618 if (color_count
[pixel
] > 0)
619 --color_count
[pixel
];
625 /* Register N colors from PIXELS as deallocated. */
628 unregister_colors (pixels
, n
)
629 unsigned long *pixels
;
633 for (i
= 0; i
< n
; ++i
)
634 unregister_color (pixels
[i
]);
638 DEFUN ("dump-colors", Fdump_colors
, Sdump_colors
, 0, 0, 0,
639 doc
: /* Dump currently allocated colors to stderr. */)
644 fputc ('\n', stderr
);
646 for (i
= n
= 0; i
< sizeof color_count
/ sizeof color_count
[0]; ++i
)
649 fprintf (stderr
, "%3d: %5d", i
, color_count
[i
]);
652 fputc ('\n', stderr
);
654 fputc ('\t', stderr
);
658 fputc ('\n', stderr
);
662 #endif /* DEBUG_X_COLORS */
665 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
666 color values. Interrupt input must be blocked when this function
670 x_free_colors (f
, pixels
, npixels
)
672 unsigned long *pixels
;
675 int class = FRAME_X_DISPLAY_INFO (f
)->visual
->class;
677 /* If display has an immutable color map, freeing colors is not
678 necessary and some servers don't allow it. So don't do it. */
679 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
681 #ifdef DEBUG_X_COLORS
682 unregister_colors (pixels
, npixels
);
684 XFreeColors (FRAME_X_DISPLAY (f
), FRAME_X_COLORMAP (f
),
690 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
691 color values. Interrupt input must be blocked when this function
695 x_free_dpy_colors (dpy
, screen
, cmap
, pixels
, npixels
)
699 unsigned long *pixels
;
702 struct x_display_info
*dpyinfo
= x_display_info_for_display (dpy
);
703 int class = dpyinfo
->visual
->class;
705 /* If display has an immutable color map, freeing colors is not
706 necessary and some servers don't allow it. So don't do it. */
707 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
709 #ifdef DEBUG_X_COLORS
710 unregister_colors (pixels
, npixels
);
712 XFreeColors (dpy
, cmap
, pixels
, npixels
, 0);
717 /* Create and return a GC for use on frame F. GC values and mask
718 are given by XGCV and MASK. */
721 x_create_gc (f
, mask
, xgcv
)
728 gc
= XCreateGC (FRAME_X_DISPLAY (f
), FRAME_X_WINDOW (f
), mask
, xgcv
);
735 /* Free GC which was used on frame F. */
743 IF_DEBUG (xassert (--ngcs
>= 0));
744 XFreeGC (FRAME_X_DISPLAY (f
), gc
);
748 #endif /* HAVE_X_WINDOWS */
751 /* W32 emulation of GCs */
754 x_create_gc (f
, mask
, xgcv
)
761 gc
= XCreateGC (NULL
, FRAME_W32_WINDOW (f
), mask
, xgcv
);
768 /* Free GC which was used on frame F. */
776 IF_DEBUG (xassert (--ngcs
>= 0));
781 #endif /* WINDOWSNT */
784 /* Mac OS emulation of GCs */
787 x_create_gc (f
, mask
, xgcv
)
793 gc
= XCreateGC (FRAME_MAC_DISPLAY (f
), FRAME_MAC_WINDOW (f
), mask
, xgcv
);
802 XFreeGC (FRAME_MAC_DISPLAY (f
), gc
);
807 /* Like stricmp. Used to compare parts of font names which are in
812 const unsigned char *s1
, *s2
;
816 unsigned char c1
= tolower (*s1
);
817 unsigned char c2
= tolower (*s2
);
819 return c1
< c2
? -1 : 1;
824 return *s2
== 0 ? 0 : -1;
829 /* Like strlwr, which might not always be available. */
831 static unsigned char *
835 unsigned char *p
= s
;
844 /* Signal `error' with message S, and additional argument ARG. */
847 signal_error (s
, arg
)
851 Fsignal (Qerror
, Fcons (build_string (s
), Fcons (arg
, Qnil
)));
855 /* If FRAME is nil, return a pointer to the selected frame.
856 Otherwise, check that FRAME is a live frame, and return a pointer
857 to it. NPARAM is the parameter number of FRAME, for
858 CHECK_LIVE_FRAME. This is here because it's a frequent pattern in
859 Lisp function definitions. */
861 static INLINE
struct frame
*
862 frame_or_selected_frame (frame
, nparam
)
867 frame
= selected_frame
;
869 CHECK_LIVE_FRAME (frame
);
870 return XFRAME (frame
);
874 /***********************************************************************
876 ***********************************************************************/
878 /* Initialize face cache and basic faces for frame F. */
884 /* Make a face cache, if F doesn't have one. */
885 if (FRAME_FACE_CACHE (f
) == NULL
)
886 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
888 #ifdef HAVE_WINDOW_SYSTEM
889 /* Make the image cache. */
890 if (FRAME_WINDOW_P (f
))
892 if (FRAME_X_IMAGE_CACHE (f
) == NULL
)
893 FRAME_X_IMAGE_CACHE (f
) = make_image_cache ();
894 ++FRAME_X_IMAGE_CACHE (f
)->refcount
;
896 #endif /* HAVE_WINDOW_SYSTEM */
898 /* Realize basic faces. Must have enough information in frame
899 parameters to realize basic faces at this point. */
900 #ifdef HAVE_X_WINDOWS
901 if (!FRAME_X_P (f
) || FRAME_X_WINDOW (f
))
904 if (!FRAME_WINDOW_P (f
) || FRAME_W32_WINDOW (f
))
907 if (!FRAME_MAC_P (f
) || FRAME_MAC_WINDOW (f
))
909 if (!realize_basic_faces (f
))
914 /* Free face cache of frame F. Called from Fdelete_frame. */
920 struct face_cache
*face_cache
= FRAME_FACE_CACHE (f
);
924 free_face_cache (face_cache
);
925 FRAME_FACE_CACHE (f
) = NULL
;
928 #ifdef HAVE_WINDOW_SYSTEM
929 if (FRAME_WINDOW_P (f
))
931 struct image_cache
*image_cache
= FRAME_X_IMAGE_CACHE (f
);
934 --image_cache
->refcount
;
935 if (image_cache
->refcount
== 0)
936 free_image_cache (f
);
939 #endif /* HAVE_WINDOW_SYSTEM */
943 /* Clear face caches, and recompute basic faces for frame F. Call
944 this after changing frame parameters on which those faces depend,
945 or when realized faces have been freed due to changing attributes
949 recompute_basic_faces (f
)
952 if (FRAME_FACE_CACHE (f
))
954 clear_face_cache (0);
955 if (!realize_basic_faces (f
))
961 /* Clear the face caches of all frames. CLEAR_FONTS_P non-zero means
962 try to free unused fonts, too. */
965 clear_face_cache (clear_fonts_p
)
968 #ifdef HAVE_WINDOW_SYSTEM
969 Lisp_Object tail
, frame
;
973 || ++clear_font_table_count
== CLEAR_FONT_TABLE_COUNT
)
975 struct x_display_info
*dpyinfo
;
977 /* Fonts are common for frames on one display, i.e. on
979 for (dpyinfo
= x_display_list
; dpyinfo
; dpyinfo
= dpyinfo
->next
)
980 if (dpyinfo
->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
981 clear_font_table (dpyinfo
);
983 /* From time to time see if we can unload some fonts. This also
984 frees all realized faces on all frames. Fonts needed by
985 faces will be loaded again when faces are realized again. */
986 clear_font_table_count
= 0;
988 FOR_EACH_FRAME (tail
, frame
)
990 struct frame
*f
= XFRAME (frame
);
991 if (FRAME_WINDOW_P (f
)
992 && FRAME_X_DISPLAY_INFO (f
)->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
993 free_all_realized_faces (frame
);
998 /* Clear GCs of realized faces. */
999 FOR_EACH_FRAME (tail
, frame
)
1002 if (FRAME_WINDOW_P (f
))
1004 clear_face_gcs (FRAME_FACE_CACHE (f
));
1005 clear_image_cache (f
, 0);
1009 #endif /* HAVE_WINDOW_SYSTEM */
1013 DEFUN ("clear-face-cache", Fclear_face_cache
, Sclear_face_cache
, 0, 1, 0,
1014 doc
: /* Clear face caches on all frames.
1015 Optional THOROUGHLY non-nil means try to free unused fonts, too. */)
1017 Lisp_Object thoroughly
;
1019 clear_face_cache (!NILP (thoroughly
));
1020 ++face_change_count
;
1021 ++windows_or_buffers_changed
;
1027 #ifdef HAVE_WINDOW_SYSTEM
1030 /* Remove fonts from the font table of DPYINFO except for the default
1031 ASCII fonts of frames on that display. Called from clear_face_cache
1032 from time to time. */
1035 clear_font_table (dpyinfo
)
1036 struct x_display_info
*dpyinfo
;
1040 /* Free those fonts that are not used by frames on DPYINFO. */
1041 for (i
= 0; i
< dpyinfo
->n_fonts
; ++i
)
1043 struct font_info
*font_info
= dpyinfo
->font_table
+ i
;
1044 Lisp_Object tail
, frame
;
1046 /* Check if slot is already free. */
1047 if (font_info
->name
== NULL
)
1050 /* Don't free a default font of some frame. */
1051 FOR_EACH_FRAME (tail
, frame
)
1053 struct frame
*f
= XFRAME (frame
);
1054 if (FRAME_WINDOW_P (f
)
1055 && font_info
->font
== FRAME_FONT (f
))
1063 if (font_info
->full_name
!= font_info
->name
)
1064 xfree (font_info
->full_name
);
1065 xfree (font_info
->name
);
1067 /* Free the font. */
1069 #ifdef HAVE_X_WINDOWS
1070 XFreeFont (dpyinfo
->display
, font_info
->font
);
1073 w32_unload_font (dpyinfo
, font_info
->font
);
1076 mac_unload_font (dpyinfo
, font_info
->font
);
1080 /* Mark font table slot free. */
1081 font_info
->font
= NULL
;
1082 font_info
->name
= font_info
->full_name
= NULL
;
1086 #endif /* HAVE_WINDOW_SYSTEM */
1090 /***********************************************************************
1092 ***********************************************************************/
1094 #ifdef HAVE_WINDOW_SYSTEM
1096 DEFUN ("bitmap-spec-p", Fbitmap_spec_p
, Sbitmap_spec_p
, 1, 1, 0,
1097 doc
: /* Value is non-nil if OBJECT is a valid bitmap specification.
1098 A bitmap specification is either a string, a file name, or a list
1099 \(WIDTH HEIGHT DATA) where WIDTH is the pixel width of the bitmap,
1100 HEIGHT is its height, and DATA is a string containing the bits of
1101 the pixmap. Bits are stored row by row, each row occupies
1102 \(WIDTH + 7)/8 bytes. */)
1108 if (STRINGP (object
))
1109 /* If OBJECT is a string, it's a file name. */
1111 else if (CONSP (object
))
1113 /* Otherwise OBJECT must be (WIDTH HEIGHT DATA), WIDTH and
1114 HEIGHT must be integers > 0, and DATA must be string large
1115 enough to hold a bitmap of the specified size. */
1116 Lisp_Object width
, height
, data
;
1118 height
= width
= data
= Qnil
;
1122 width
= XCAR (object
);
1123 object
= XCDR (object
);
1126 height
= XCAR (object
);
1127 object
= XCDR (object
);
1129 data
= XCAR (object
);
1133 if (NATNUMP (width
) && NATNUMP (height
) && STRINGP (data
))
1135 int bytes_per_row
= ((XFASTINT (width
) + BITS_PER_CHAR
- 1)
1137 if (SBYTES (data
) >= bytes_per_row
* XINT (height
))
1142 return pixmap_p
? Qt
: Qnil
;
1146 /* Load a bitmap according to NAME (which is either a file name or a
1147 pixmap spec) for use on frame F. Value is the bitmap_id (see
1148 xfns.c). If NAME is nil, return with a bitmap id of zero. If
1149 bitmap cannot be loaded, display a message saying so, and return
1150 zero. Store the bitmap width in *W_PTR and its height in *H_PTR,
1151 if these pointers are not null. */
1154 load_pixmap (f
, name
, w_ptr
, h_ptr
)
1157 unsigned int *w_ptr
, *h_ptr
;
1165 tem
= Fbitmap_spec_p (name
);
1167 wrong_type_argument (Qbitmap_spec_p
, name
);
1172 /* Decode a bitmap spec into a bitmap. */
1177 w
= XINT (Fcar (name
));
1178 h
= XINT (Fcar (Fcdr (name
)));
1179 bits
= Fcar (Fcdr (Fcdr (name
)));
1181 bitmap_id
= x_create_bitmap_from_data (f
, SDATA (bits
),
1186 /* It must be a string -- a file name. */
1187 bitmap_id
= x_create_bitmap_from_file (f
, name
);
1193 add_to_log ("Invalid or undefined bitmap %s", name
, Qnil
);
1204 ++npixmaps_allocated
;
1207 *w_ptr
= x_bitmap_width (f
, bitmap_id
);
1210 *h_ptr
= x_bitmap_height (f
, bitmap_id
);
1216 #endif /* HAVE_WINDOW_SYSTEM */
1220 /***********************************************************************
1222 ***********************************************************************/
1224 #ifdef HAVE_WINDOW_SYSTEM
1226 /* Load font of face FACE which is used on frame F to display
1227 character C. The name of the font to load is determined by lface
1228 and fontset of FACE. */
1231 load_face_font (f
, face
, c
)
1236 struct font_info
*font_info
= NULL
;
1238 int needs_overstrike
;
1240 face
->font_info_id
= -1;
1243 font_name
= choose_face_font (f
, face
->lface
, face
->fontset
, c
,
1249 font_info
= FS_LOAD_FACE_FONT (f
, c
, font_name
, face
);
1254 face
->font_info_id
= font_info
->font_idx
;
1255 face
->font
= font_info
->font
;
1256 face
->font_name
= font_info
->full_name
;
1257 face
->overstrike
= needs_overstrike
;
1260 x_free_gc (f
, face
->gc
);
1265 add_to_log ("Unable to load font %s",
1266 build_string (font_name
), Qnil
);
1270 #endif /* HAVE_WINDOW_SYSTEM */
1274 /***********************************************************************
1276 ***********************************************************************/
1278 /* Parse RGB_LIST, and fill in the RGB fields of COLOR.
1279 RGB_LIST should contain (at least) 3 lisp integers.
1280 Return 0 if there's a problem with RGB_LIST, otherwise return 1. */
1283 parse_rgb_list (rgb_list
, color
)
1284 Lisp_Object rgb_list
;
1287 #define PARSE_RGB_LIST_FIELD(field) \
1288 if (CONSP (rgb_list) && INTEGERP (XCAR (rgb_list))) \
1290 color->field = XINT (XCAR (rgb_list)); \
1291 rgb_list = XCDR (rgb_list); \
1296 PARSE_RGB_LIST_FIELD (red
);
1297 PARSE_RGB_LIST_FIELD (green
);
1298 PARSE_RGB_LIST_FIELD (blue
);
1304 /* Lookup on frame F the color described by the lisp string COLOR.
1305 The resulting tty color is returned in TTY_COLOR; if STD_COLOR is
1306 non-zero, then the `standard' definition of the same color is
1310 tty_lookup_color (f
, color
, tty_color
, std_color
)
1313 XColor
*tty_color
, *std_color
;
1315 Lisp_Object frame
, color_desc
;
1317 if (!STRINGP (color
) || NILP (Ffboundp (Qtty_color_desc
)))
1320 XSETFRAME (frame
, f
);
1322 color_desc
= call2 (Qtty_color_desc
, color
, frame
);
1323 if (CONSP (color_desc
) && CONSP (XCDR (color_desc
)))
1327 if (! INTEGERP (XCAR (XCDR (color_desc
))))
1330 tty_color
->pixel
= XINT (XCAR (XCDR (color_desc
)));
1332 rgb
= XCDR (XCDR (color_desc
));
1333 if (! parse_rgb_list (rgb
, tty_color
))
1336 /* Should we fill in STD_COLOR too? */
1339 /* Default STD_COLOR to the same as TTY_COLOR. */
1340 *std_color
= *tty_color
;
1342 /* Do a quick check to see if the returned descriptor is
1343 actually _exactly_ equal to COLOR, otherwise we have to
1344 lookup STD_COLOR separately. If it's impossible to lookup
1345 a standard color, we just give up and use TTY_COLOR. */
1346 if ((!STRINGP (XCAR (color_desc
))
1347 || NILP (Fstring_equal (color
, XCAR (color_desc
))))
1348 && !NILP (Ffboundp (Qtty_color_standard_values
)))
1350 /* Look up STD_COLOR separately. */
1351 rgb
= call1 (Qtty_color_standard_values
, color
);
1352 if (! parse_rgb_list (rgb
, std_color
))
1359 else if (NILP (Fsymbol_value (intern ("tty-defined-color-alist"))))
1360 /* We were called early during startup, and the colors are not
1361 yet set up in tty-defined-color-alist. Don't return a failure
1362 indication, since this produces the annoying "Unable to
1363 load color" messages in the *Messages* buffer. */
1366 /* tty-color-desc seems to have returned a bad value. */
1370 /* A version of defined_color for non-X frames. */
1373 tty_defined_color (f
, color_name
, color_def
, alloc
)
1382 color_def
->pixel
= FACE_TTY_DEFAULT_COLOR
;
1384 color_def
->blue
= 0;
1385 color_def
->green
= 0;
1388 status
= tty_lookup_color (f
, build_string (color_name
), color_def
, 0);
1390 if (color_def
->pixel
== FACE_TTY_DEFAULT_COLOR
&& *color_name
)
1392 if (strcmp (color_name
, "unspecified-fg") == 0)
1393 color_def
->pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
1394 else if (strcmp (color_name
, "unspecified-bg") == 0)
1395 color_def
->pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
1398 if (color_def
->pixel
!= FACE_TTY_DEFAULT_COLOR
)
1405 /* Decide if color named COLOR_NAME is valid for the display
1406 associated with the frame F; if so, return the rgb values in
1407 COLOR_DEF. If ALLOC is nonzero, allocate a new colormap cell.
1409 This does the right thing for any type of frame. */
1412 defined_color (f
, color_name
, color_def
, alloc
)
1418 if (!FRAME_WINDOW_P (f
))
1419 return tty_defined_color (f
, color_name
, color_def
, alloc
);
1420 #ifdef HAVE_X_WINDOWS
1421 else if (FRAME_X_P (f
))
1422 return x_defined_color (f
, color_name
, color_def
, alloc
);
1425 else if (FRAME_W32_P (f
))
1426 return w32_defined_color (f
, color_name
, color_def
, alloc
);
1429 else if (FRAME_MAC_P (f
))
1430 return mac_defined_color (f
, color_name
, color_def
, alloc
);
1437 /* Given the index IDX of a tty color on frame F, return its name, a
1441 tty_color_name (f
, idx
)
1445 if (idx
>= 0 && !NILP (Ffboundp (Qtty_color_by_index
)))
1448 Lisp_Object coldesc
;
1450 XSETFRAME (frame
, f
);
1451 coldesc
= call2 (Qtty_color_by_index
, make_number (idx
), frame
);
1453 if (!NILP (coldesc
))
1454 return XCAR (coldesc
);
1457 /* We can have an MSDOG frame under -nw for a short window of
1458 opportunity before internal_terminal_init is called. DTRT. */
1459 if (FRAME_MSDOS_P (f
) && !inhibit_window_system
)
1460 return msdos_stdcolor_name (idx
);
1463 if (idx
== FACE_TTY_DEFAULT_FG_COLOR
)
1464 return build_string (unspecified_fg
);
1465 if (idx
== FACE_TTY_DEFAULT_BG_COLOR
)
1466 return build_string (unspecified_bg
);
1469 return vga_stdcolor_name (idx
);
1472 return Qunspecified
;
1476 /* Return non-zero if COLOR_NAME is a shade of gray (or white or
1477 black) on frame F. The algorithm is taken from 20.2 faces.el. */
1480 face_color_gray_p (f
, color_name
)
1487 if (defined_color (f
, color_name
, &color
, 0))
1488 gray_p
= ((abs (color
.red
- color
.green
)
1489 < max (color
.red
, color
.green
) / 20)
1490 && (abs (color
.green
- color
.blue
)
1491 < max (color
.green
, color
.blue
) / 20)
1492 && (abs (color
.blue
- color
.red
)
1493 < max (color
.blue
, color
.red
) / 20));
1501 /* Return non-zero if color COLOR_NAME can be displayed on frame F.
1502 BACKGROUND_P non-zero means the color will be used as background
1506 face_color_supported_p (f
, color_name
, background_p
)
1514 XSETFRAME (frame
, f
);
1516 #ifdef HAVE_WINDOW_SYSTEM
1518 ? (!NILP (Fxw_display_color_p (frame
))
1519 || xstricmp (color_name
, "black") == 0
1520 || xstricmp (color_name
, "white") == 0
1522 && face_color_gray_p (f
, color_name
))
1523 || (!NILP (Fx_display_grayscale_p (frame
))
1524 && face_color_gray_p (f
, color_name
)))
1527 tty_defined_color (f
, color_name
, ¬_used
, 0);
1531 DEFUN ("color-gray-p", Fcolor_gray_p
, Scolor_gray_p
, 1, 2, 0,
1532 doc
: /* Return non-nil if COLOR is a shade of gray (or white or black).
1533 FRAME specifies the frame and thus the display for interpreting COLOR.
1534 If FRAME is nil or omitted, use the selected frame. */)
1536 Lisp_Object color
, frame
;
1540 CHECK_STRING (color
);
1542 frame
= selected_frame
;
1544 CHECK_FRAME (frame
);
1546 return face_color_gray_p (f
, SDATA (color
)) ? Qt
: Qnil
;
1550 DEFUN ("color-supported-p", Fcolor_supported_p
,
1551 Scolor_supported_p
, 1, 3, 0,
1552 doc
: /* Return non-nil if COLOR can be displayed on FRAME.
1553 BACKGROUND-P non-nil means COLOR is used as a background.
1554 Otherwise, this function tells whether it can be used as a foreground.
1555 If FRAME is nil or omitted, use the selected frame.
1556 COLOR must be a valid color name. */)
1557 (color
, frame
, background_p
)
1558 Lisp_Object frame
, color
, background_p
;
1562 CHECK_STRING (color
);
1564 frame
= selected_frame
;
1566 CHECK_FRAME (frame
);
1568 if (face_color_supported_p (f
, SDATA (color
), !NILP (background_p
)))
1574 /* Load color with name NAME for use by face FACE on frame F.
1575 TARGET_INDEX must be one of LFACE_FOREGROUND_INDEX,
1576 LFACE_BACKGROUND_INDEX, LFACE_UNDERLINE_INDEX, LFACE_OVERLINE_INDEX,
1577 LFACE_STRIKE_THROUGH_INDEX, or LFACE_BOX_INDEX. Value is the
1578 pixel color. If color cannot be loaded, display a message, and
1579 return the foreground, background or underline color of F, but
1580 record that fact in flags of the face so that we don't try to free
1584 load_color (f
, face
, name
, target_index
)
1588 enum lface_attribute_index target_index
;
1592 xassert (STRINGP (name
));
1593 xassert (target_index
== LFACE_FOREGROUND_INDEX
1594 || target_index
== LFACE_BACKGROUND_INDEX
1595 || target_index
== LFACE_UNDERLINE_INDEX
1596 || target_index
== LFACE_OVERLINE_INDEX
1597 || target_index
== LFACE_STRIKE_THROUGH_INDEX
1598 || target_index
== LFACE_BOX_INDEX
);
1600 /* if the color map is full, defined_color will return a best match
1601 to the values in an existing cell. */
1602 if (!defined_color (f
, SDATA (name
), &color
, 1))
1604 add_to_log ("Unable to load color \"%s\"", name
, Qnil
);
1606 switch (target_index
)
1608 case LFACE_FOREGROUND_INDEX
:
1609 face
->foreground_defaulted_p
= 1;
1610 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1613 case LFACE_BACKGROUND_INDEX
:
1614 face
->background_defaulted_p
= 1;
1615 color
.pixel
= FRAME_BACKGROUND_PIXEL (f
);
1618 case LFACE_UNDERLINE_INDEX
:
1619 face
->underline_defaulted_p
= 1;
1620 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1623 case LFACE_OVERLINE_INDEX
:
1624 face
->overline_color_defaulted_p
= 1;
1625 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1628 case LFACE_STRIKE_THROUGH_INDEX
:
1629 face
->strike_through_color_defaulted_p
= 1;
1630 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1633 case LFACE_BOX_INDEX
:
1634 face
->box_color_defaulted_p
= 1;
1635 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1644 ++ncolors_allocated
;
1651 #ifdef HAVE_WINDOW_SYSTEM
1653 /* Load colors for face FACE which is used on frame F. Colors are
1654 specified by slots LFACE_BACKGROUND_INDEX and LFACE_FOREGROUND_INDEX
1655 of ATTRS. If the background color specified is not supported on F,
1656 try to emulate gray colors with a stipple from Vface_default_stipple. */
1659 load_face_colors (f
, face
, attrs
)
1666 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
1667 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
1669 /* Swap colors if face is inverse-video. */
1670 if (EQ (attrs
[LFACE_INVERSE_INDEX
], Qt
))
1678 /* Check for support for foreground, not for background because
1679 face_color_supported_p is smart enough to know that grays are
1680 "supported" as background because we are supposed to use stipple
1682 if (!face_color_supported_p (f
, SDATA (bg
), 0)
1683 && !NILP (Fbitmap_spec_p (Vface_default_stipple
)))
1685 x_destroy_bitmap (f
, face
->stipple
);
1686 face
->stipple
= load_pixmap (f
, Vface_default_stipple
,
1687 &face
->pixmap_w
, &face
->pixmap_h
);
1690 face
->background
= load_color (f
, face
, bg
, LFACE_BACKGROUND_INDEX
);
1691 face
->foreground
= load_color (f
, face
, fg
, LFACE_FOREGROUND_INDEX
);
1695 /* Free color PIXEL on frame F. */
1698 unload_color (f
, pixel
)
1700 unsigned long pixel
;
1702 #ifdef HAVE_X_WINDOWS
1706 x_free_colors (f
, &pixel
, 1);
1713 /* Free colors allocated for FACE. */
1716 free_face_colors (f
, face
)
1720 #ifdef HAVE_X_WINDOWS
1721 if (face
->colors_copied_bitwise_p
)
1726 if (!face
->foreground_defaulted_p
)
1728 x_free_colors (f
, &face
->foreground
, 1);
1729 IF_DEBUG (--ncolors_allocated
);
1732 if (!face
->background_defaulted_p
)
1734 x_free_colors (f
, &face
->background
, 1);
1735 IF_DEBUG (--ncolors_allocated
);
1738 if (face
->underline_p
1739 && !face
->underline_defaulted_p
)
1741 x_free_colors (f
, &face
->underline_color
, 1);
1742 IF_DEBUG (--ncolors_allocated
);
1745 if (face
->overline_p
1746 && !face
->overline_color_defaulted_p
)
1748 x_free_colors (f
, &face
->overline_color
, 1);
1749 IF_DEBUG (--ncolors_allocated
);
1752 if (face
->strike_through_p
1753 && !face
->strike_through_color_defaulted_p
)
1755 x_free_colors (f
, &face
->strike_through_color
, 1);
1756 IF_DEBUG (--ncolors_allocated
);
1759 if (face
->box
!= FACE_NO_BOX
1760 && !face
->box_color_defaulted_p
)
1762 x_free_colors (f
, &face
->box_color
, 1);
1763 IF_DEBUG (--ncolors_allocated
);
1767 #endif /* HAVE_X_WINDOWS */
1770 #endif /* HAVE_WINDOW_SYSTEM */
1774 /***********************************************************************
1776 ***********************************************************************/
1778 /* An enumerator for each field of an XLFD font name. */
1799 /* An enumerator for each possible slant value of a font. Taken from
1800 the XLFD specification. */
1808 XLFD_SLANT_REVERSE_ITALIC
,
1809 XLFD_SLANT_REVERSE_OBLIQUE
,
1813 /* Relative font weight according to XLFD documentation. */
1817 XLFD_WEIGHT_UNKNOWN
,
1818 XLFD_WEIGHT_ULTRA_LIGHT
, /* 10 */
1819 XLFD_WEIGHT_EXTRA_LIGHT
, /* 20 */
1820 XLFD_WEIGHT_LIGHT
, /* 30 */
1821 XLFD_WEIGHT_SEMI_LIGHT
, /* 40: SemiLight, Book, ... */
1822 XLFD_WEIGHT_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1823 XLFD_WEIGHT_SEMI_BOLD
, /* 60: SemiBold, DemiBold, ... */
1824 XLFD_WEIGHT_BOLD
, /* 70: Bold, ... */
1825 XLFD_WEIGHT_EXTRA_BOLD
, /* 80: ExtraBold, Heavy, ... */
1826 XLFD_WEIGHT_ULTRA_BOLD
/* 90: UltraBold, Black, ... */
1829 /* Relative proportionate width. */
1833 XLFD_SWIDTH_UNKNOWN
,
1834 XLFD_SWIDTH_ULTRA_CONDENSED
, /* 10 */
1835 XLFD_SWIDTH_EXTRA_CONDENSED
, /* 20 */
1836 XLFD_SWIDTH_CONDENSED
, /* 30: Condensed, Narrow, Compressed, ... */
1837 XLFD_SWIDTH_SEMI_CONDENSED
, /* 40: semicondensed */
1838 XLFD_SWIDTH_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1839 XLFD_SWIDTH_SEMI_EXPANDED
, /* 60: SemiExpanded, DemiExpanded, ... */
1840 XLFD_SWIDTH_EXPANDED
, /* 70: Expanded... */
1841 XLFD_SWIDTH_EXTRA_EXPANDED
, /* 80: ExtraExpanded, Wide... */
1842 XLFD_SWIDTH_ULTRA_EXPANDED
/* 90: UltraExpanded... */
1845 /* Structure used for tables mapping XLFD weight, slant, and width
1846 names to numeric and symbolic values. */
1852 Lisp_Object
*symbol
;
1855 /* Table of XLFD slant names and their numeric and symbolic
1856 representations. This table must be sorted by slant names in
1859 static struct table_entry slant_table
[] =
1861 {"i", XLFD_SLANT_ITALIC
, &Qitalic
},
1862 {"o", XLFD_SLANT_OBLIQUE
, &Qoblique
},
1863 {"ot", XLFD_SLANT_OTHER
, &Qitalic
},
1864 {"r", XLFD_SLANT_ROMAN
, &Qnormal
},
1865 {"ri", XLFD_SLANT_REVERSE_ITALIC
, &Qreverse_italic
},
1866 {"ro", XLFD_SLANT_REVERSE_OBLIQUE
, &Qreverse_oblique
}
1869 /* Table of XLFD weight names. This table must be sorted by weight
1870 names in ascending order. */
1872 static struct table_entry weight_table
[] =
1874 {"black", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
},
1875 {"bold", XLFD_WEIGHT_BOLD
, &Qbold
},
1876 {"book", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1877 {"demi", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1878 {"demibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1879 {"extralight", XLFD_WEIGHT_EXTRA_LIGHT
, &Qextra_light
},
1880 {"extrabold", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1881 {"heavy", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1882 {"light", XLFD_WEIGHT_LIGHT
, &Qlight
},
1883 {"medium", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1884 {"normal", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1885 {"regular", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1886 {"semibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1887 {"semilight", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1888 {"ultralight", XLFD_WEIGHT_ULTRA_LIGHT
, &Qultra_light
},
1889 {"ultrabold", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
}
1892 /* Table of XLFD width names. This table must be sorted by width
1893 names in ascending order. */
1895 static struct table_entry swidth_table
[] =
1897 {"compressed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1898 {"condensed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1899 {"demiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1900 {"expanded", XLFD_SWIDTH_EXPANDED
, &Qexpanded
},
1901 {"extracondensed", XLFD_SWIDTH_EXTRA_CONDENSED
, &Qextra_condensed
},
1902 {"extraexpanded", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
},
1903 {"medium", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1904 {"narrow", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1905 {"normal", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1906 {"regular", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1907 {"semicondensed", XLFD_SWIDTH_SEMI_CONDENSED
, &Qsemi_condensed
},
1908 {"semiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1909 {"ultracondensed", XLFD_SWIDTH_ULTRA_CONDENSED
, &Qultra_condensed
},
1910 {"ultraexpanded", XLFD_SWIDTH_ULTRA_EXPANDED
, &Qultra_expanded
},
1911 {"wide", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
}
1914 /* Structure used to hold the result of splitting font names in XLFD
1915 format into their fields. */
1919 /* The original name which is modified destructively by
1920 split_font_name. The pointer is kept here to be able to free it
1921 if it was allocated from the heap. */
1924 /* Font name fields. Each vector element points into `name' above.
1925 Fields are NUL-terminated. */
1926 char *fields
[XLFD_LAST
];
1928 /* Numeric values for those fields that interest us. See
1929 split_font_name for which these are. */
1930 int numeric
[XLFD_LAST
];
1932 /* If the original name matches one of Vface_font_rescale_alist,
1933 the value is the corresponding rescale ratio. Otherwise, the
1935 double rescale_ratio
;
1937 /* Lower value mean higher priority. */
1938 int registry_priority
;
1941 /* The frame in effect when sorting font names. Set temporarily in
1942 sort_fonts so that it is available in font comparison functions. */
1944 static struct frame
*font_frame
;
1946 /* Order by which font selection chooses fonts. The default values
1947 mean `first, find a best match for the font width, then for the
1948 font height, then for weight, then for slant.' This variable can be
1949 set via set-face-font-sort-order. */
1952 static int font_sort_order
[4] = {
1953 XLFD_SWIDTH
, XLFD_POINT_SIZE
, XLFD_WEIGHT
, XLFD_SLANT
1956 static int font_sort_order
[4];
1959 /* Look up FONT.fields[FIELD_INDEX] in TABLE which has DIM entries.
1960 TABLE must be sorted by TABLE[i]->name in ascending order. Value
1961 is a pointer to the matching table entry or null if no table entry
1964 static struct table_entry
*
1965 xlfd_lookup_field_contents (table
, dim
, font
, field_index
)
1966 struct table_entry
*table
;
1968 struct font_name
*font
;
1971 /* Function split_font_name converts fields to lower-case, so there
1972 is no need to use xstrlwr or xstricmp here. */
1973 char *s
= font
->fields
[field_index
];
1974 int low
, mid
, high
, cmp
;
1981 mid
= (low
+ high
) / 2;
1982 cmp
= strcmp (table
[mid
].name
, s
);
1996 /* Return a numeric representation for font name field
1997 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
1998 has DIM entries. Value is the numeric value found or DFLT if no
1999 table entry matches. This function is used to translate weight,
2000 slant, and swidth names of XLFD font names to numeric values. */
2003 xlfd_numeric_value (table
, dim
, font
, field_index
, dflt
)
2004 struct table_entry
*table
;
2006 struct font_name
*font
;
2010 struct table_entry
*p
;
2011 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2012 return p
? p
->numeric
: dflt
;
2016 /* Return a symbolic representation for font name field
2017 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
2018 has DIM entries. Value is the symbolic value found or DFLT if no
2019 table entry matches. This function is used to translate weight,
2020 slant, and swidth names of XLFD font names to symbols. */
2022 static INLINE Lisp_Object
2023 xlfd_symbolic_value (table
, dim
, font
, field_index
, dflt
)
2024 struct table_entry
*table
;
2026 struct font_name
*font
;
2030 struct table_entry
*p
;
2031 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2032 return p
? *p
->symbol
: dflt
;
2036 /* Return a numeric value for the slant of the font given by FONT. */
2039 xlfd_numeric_slant (font
)
2040 struct font_name
*font
;
2042 return xlfd_numeric_value (slant_table
, DIM (slant_table
),
2043 font
, XLFD_SLANT
, XLFD_SLANT_ROMAN
);
2047 /* Return a symbol representing the weight of the font given by FONT. */
2049 static INLINE Lisp_Object
2050 xlfd_symbolic_slant (font
)
2051 struct font_name
*font
;
2053 return xlfd_symbolic_value (slant_table
, DIM (slant_table
),
2054 font
, XLFD_SLANT
, Qnormal
);
2058 /* Return a numeric value for the weight of the font given by FONT. */
2061 xlfd_numeric_weight (font
)
2062 struct font_name
*font
;
2064 return xlfd_numeric_value (weight_table
, DIM (weight_table
),
2065 font
, XLFD_WEIGHT
, XLFD_WEIGHT_MEDIUM
);
2069 /* Return a symbol representing the slant of the font given by FONT. */
2071 static INLINE Lisp_Object
2072 xlfd_symbolic_weight (font
)
2073 struct font_name
*font
;
2075 return xlfd_symbolic_value (weight_table
, DIM (weight_table
),
2076 font
, XLFD_WEIGHT
, Qnormal
);
2080 /* Return a numeric value for the swidth of the font whose XLFD font
2081 name fields are found in FONT. */
2084 xlfd_numeric_swidth (font
)
2085 struct font_name
*font
;
2087 return xlfd_numeric_value (swidth_table
, DIM (swidth_table
),
2088 font
, XLFD_SWIDTH
, XLFD_SWIDTH_MEDIUM
);
2092 /* Return a symbolic value for the swidth of FONT. */
2094 static INLINE Lisp_Object
2095 xlfd_symbolic_swidth (font
)
2096 struct font_name
*font
;
2098 return xlfd_symbolic_value (swidth_table
, DIM (swidth_table
),
2099 font
, XLFD_SWIDTH
, Qnormal
);
2103 /* Look up the entry of SYMBOL in the vector TABLE which has DIM
2104 entries. Value is a pointer to the matching table entry or null if
2105 no element of TABLE contains SYMBOL. */
2107 static struct table_entry
*
2108 face_value (table
, dim
, symbol
)
2109 struct table_entry
*table
;
2115 xassert (SYMBOLP (symbol
));
2117 for (i
= 0; i
< dim
; ++i
)
2118 if (EQ (*table
[i
].symbol
, symbol
))
2121 return i
< dim
? table
+ i
: NULL
;
2125 /* Return a numeric value for SYMBOL in the vector TABLE which has DIM
2126 entries. Value is -1 if SYMBOL is not found in TABLE. */
2129 face_numeric_value (table
, dim
, symbol
)
2130 struct table_entry
*table
;
2134 struct table_entry
*p
= face_value (table
, dim
, symbol
);
2135 return p
? p
->numeric
: -1;
2139 /* Return a numeric value representing the weight specified by Lisp
2140 symbol WEIGHT. Value is one of the enumerators of enum
2144 face_numeric_weight (weight
)
2147 return face_numeric_value (weight_table
, DIM (weight_table
), weight
);
2151 /* Return a numeric value representing the slant specified by Lisp
2152 symbol SLANT. Value is one of the enumerators of enum xlfd_slant. */
2155 face_numeric_slant (slant
)
2158 return face_numeric_value (slant_table
, DIM (slant_table
), slant
);
2162 /* Return a numeric value representing the swidth specified by Lisp
2163 symbol WIDTH. Value is one of the enumerators of enum xlfd_swidth. */
2166 face_numeric_swidth (width
)
2169 return face_numeric_value (swidth_table
, DIM (swidth_table
), width
);
2173 #ifdef HAVE_WINDOW_SYSTEM
2175 /* Return non-zero if FONT is the name of a fixed-pitch font. */
2179 struct font_name
*font
;
2181 /* Function split_font_name converts fields to lower-case, so there
2182 is no need to use tolower here. */
2183 return *font
->fields
[XLFD_SPACING
] != 'p';
2187 /* Return the point size of FONT on frame F, measured in 1/10 pt.
2189 The actual height of the font when displayed on F depends on the
2190 resolution of both the font and frame. For example, a 10pt font
2191 designed for a 100dpi display will display larger than 10pt on a
2192 75dpi display. (It's not unusual to use fonts not designed for the
2193 display one is using. For example, some intlfonts are available in
2194 72dpi versions, only.)
2196 Value is the real point size of FONT on frame F, or 0 if it cannot
2200 xlfd_point_size (f
, font
)
2202 struct font_name
*font
;
2204 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2205 char *pixel_field
= font
->fields
[XLFD_PIXEL_SIZE
];
2209 if (*pixel_field
== '[')
2211 /* The pixel size field is `[A B C D]' which specifies
2212 a transformation matrix.
2218 by which all glyphs of the font are transformed. The spec
2219 says that s scalar value N for the pixel size is equivalent
2220 to A = N * resx/resy, B = C = 0, D = N. */
2221 char *start
= pixel_field
+ 1, *end
;
2225 for (i
= 0; i
< 4; ++i
)
2227 matrix
[i
] = strtod (start
, &end
);
2234 pixel
= atoi (pixel_field
);
2239 real_pt
= PT_PER_INCH
* 10.0 * pixel
/ resy
+ 0.5;
2245 /* Return point size of PIXEL dots while considering Y-resultion (DPI)
2246 of frame F. This function is used to guess a point size of font
2247 when only the pixel height of the font is available. */
2250 pixel_point_size (f
, pixel
)
2254 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2258 /* As one inch is PT_PER_INCH points, PT_PER_INCH/RESY gives the
2259 point size of one dot. */
2260 real_pt
= pixel
* PT_PER_INCH
/ resy
;
2261 int_pt
= real_pt
+ 0.5;
2267 /* Return a rescaling ratio of a font of NAME. */
2270 font_rescale_ratio (name
)
2273 Lisp_Object tail
, elt
;
2275 for (tail
= Vface_font_rescale_alist
; CONSP (tail
); tail
= XCDR (tail
))
2278 if (STRINGP (XCAR (elt
)) && FLOATP (XCDR (elt
))
2279 && fast_c_string_match_ignore_case (XCAR (elt
), name
) >= 0)
2280 return XFLOAT_DATA (XCDR (elt
));
2286 /* Split XLFD font name FONT->name destructively into NUL-terminated,
2287 lower-case fields in FONT->fields. NUMERIC_P non-zero means
2288 compute numeric values for fields XLFD_POINT_SIZE, XLFD_SWIDTH,
2289 XLFD_RESY, XLFD_SLANT, and XLFD_WEIGHT in FONT->numeric. Value is
2290 zero if the font name doesn't have the format we expect. The
2291 expected format is a font name that starts with a `-' and has
2292 XLFD_LAST fields separated by `-'. */
2295 split_font_name (f
, font
, numeric_p
)
2297 struct font_name
*font
;
2302 double rescale_ratio
;
2305 /* This must be done before splitting the font name. */
2306 rescale_ratio
= font_rescale_ratio (font
->name
);
2308 if (*font
->name
== '-')
2310 char *p
= xstrlwr (font
->name
) + 1;
2312 while (i
< XLFD_LAST
)
2314 font
->fields
[i
] = p
;
2317 /* Pixel and point size may be of the form `[....]'. For
2318 BNF, see XLFD spec, chapter 4. Negative values are
2319 indicated by tilde characters which we replace with
2320 `-' characters, here. */
2322 && (i
- 1 == XLFD_PIXEL_SIZE
2323 || i
- 1 == XLFD_POINT_SIZE
))
2328 for (++p
; *p
&& *p
!= ']'; ++p
)
2332 /* Check that the matrix contains 4 floating point
2334 for (j
= 0, start
= font
->fields
[i
- 1] + 1;
2337 if (strtod (start
, &end
) == 0 && start
== end
)
2344 while (*p
&& *p
!= '-')
2354 success_p
= i
== XLFD_LAST
;
2356 /* If requested, and font name was in the expected format,
2357 compute numeric values for some fields. */
2358 if (numeric_p
&& success_p
)
2360 font
->numeric
[XLFD_POINT_SIZE
] = xlfd_point_size (f
, font
);
2361 font
->numeric
[XLFD_RESY
] = atoi (font
->fields
[XLFD_RESY
]);
2362 font
->numeric
[XLFD_SLANT
] = xlfd_numeric_slant (font
);
2363 font
->numeric
[XLFD_WEIGHT
] = xlfd_numeric_weight (font
);
2364 font
->numeric
[XLFD_SWIDTH
] = xlfd_numeric_swidth (font
);
2365 font
->numeric
[XLFD_AVGWIDTH
] = atoi (font
->fields
[XLFD_AVGWIDTH
]);
2366 font
->rescale_ratio
= rescale_ratio
;
2369 /* Initialize it to zero. It will be overridden by font_list while
2370 trying alternate registries. */
2371 font
->registry_priority
= 0;
2377 /* Build an XLFD font name from font name fields in FONT. Value is a
2378 pointer to the font name, which is allocated via xmalloc. */
2381 build_font_name (font
)
2382 struct font_name
*font
;
2386 char *font_name
= (char *) xmalloc (size
);
2387 int total_length
= 0;
2389 for (i
= 0; i
< XLFD_LAST
; ++i
)
2391 /* Add 1 because of the leading `-'. */
2392 int len
= strlen (font
->fields
[i
]) + 1;
2394 /* Reallocate font_name if necessary. Add 1 for the final
2396 if (total_length
+ len
+ 1 >= size
)
2398 int new_size
= max (2 * size
, size
+ len
+ 1);
2399 int sz
= new_size
* sizeof *font_name
;
2400 font_name
= (char *) xrealloc (font_name
, sz
);
2404 font_name
[total_length
] = '-';
2405 bcopy (font
->fields
[i
], font_name
+ total_length
+ 1, len
- 1);
2406 total_length
+= len
;
2409 font_name
[total_length
] = 0;
2414 /* Free an array FONTS of N font_name structures. This frees FONTS
2415 itself and all `name' fields in its elements. */
2418 free_font_names (fonts
, n
)
2419 struct font_name
*fonts
;
2423 xfree (fonts
[--n
].name
);
2428 /* Sort vector FONTS of font_name structures which contains NFONTS
2429 elements using qsort and comparison function CMPFN. F is the frame
2430 on which the fonts will be used. The global variable font_frame
2431 is temporarily set to F to make it available in CMPFN. */
2434 sort_fonts (f
, fonts
, nfonts
, cmpfn
)
2436 struct font_name
*fonts
;
2438 int (*cmpfn
) P_ ((const void *, const void *));
2441 qsort (fonts
, nfonts
, sizeof *fonts
, cmpfn
);
2446 /* Get fonts matching PATTERN on frame F. If F is null, use the first
2447 display in x_display_list. FONTS is a pointer to a vector of
2448 NFONTS font_name structures. TRY_ALTERNATIVES_P non-zero means try
2449 alternative patterns from Valternate_fontname_alist if no fonts are
2450 found matching PATTERN.
2452 For all fonts found, set FONTS[i].name to the name of the font,
2453 allocated via xmalloc, and split font names into fields. Ignore
2454 fonts that we can't parse. Value is the number of fonts found. */
2457 x_face_list_fonts (f
, pattern
, pfonts
, nfonts
, try_alternatives_p
)
2460 struct font_name
**pfonts
;
2461 int nfonts
, try_alternatives_p
;
2465 /* NTEMACS_TODO : currently this uses w32_list_fonts, but it may be
2466 better to do it the other way around. */
2468 Lisp_Object lpattern
, tem
;
2469 struct font_name
*fonts
= 0;
2470 int num_fonts
= nfonts
;
2473 lpattern
= build_string (pattern
);
2475 /* Get the list of fonts matching PATTERN. */
2478 lfonts
= w32_list_fonts (f
, lpattern
, 0, nfonts
);
2481 lfonts
= x_list_fonts (f
, lpattern
, -1, nfonts
);
2484 if (nfonts
< 0 && CONSP (lfonts
))
2485 num_fonts
= XFASTINT (Flength (lfonts
));
2487 /* Make a copy of the font names we got from X, and
2488 split them into fields. */
2490 for (tem
= lfonts
; CONSP (tem
) && n
< num_fonts
; tem
= XCDR (tem
))
2492 Lisp_Object elt
, tail
;
2493 const char *name
= SDATA (XCAR (tem
));
2495 /* Ignore fonts matching a pattern from face-ignored-fonts. */
2496 for (tail
= Vface_ignored_fonts
; CONSP (tail
); tail
= XCDR (tail
))
2500 && fast_c_string_match_ignore_case (elt
, name
) >= 0)
2511 *pfonts
= (struct font_name
*) xmalloc (num_fonts
* sizeof **pfonts
);
2515 /* Make a copy of the font name. */
2516 fonts
[n
].name
= xstrdup (name
);
2518 if (split_font_name (f
, fonts
+ n
, 1))
2520 if (font_scalable_p (fonts
+ n
)
2521 && !may_use_scalable_font_p (name
))
2524 xfree (fonts
[n
].name
);
2530 xfree (fonts
[n
].name
);
2533 /* If no fonts found, try patterns from Valternate_fontname_alist. */
2534 if (n
== 0 && try_alternatives_p
)
2536 Lisp_Object list
= Valternate_fontname_alist
;
2544 while (CONSP (list
))
2546 Lisp_Object entry
= XCAR (list
);
2548 && STRINGP (XCAR (entry
))
2549 && strcmp (SDATA (XCAR (entry
)), pattern
) == 0)
2556 Lisp_Object patterns
= XCAR (list
);
2559 while (CONSP (patterns
)
2560 /* If list is screwed up, give up. */
2561 && (name
= XCAR (patterns
),
2563 /* Ignore patterns equal to PATTERN because we tried that
2564 already with no success. */
2565 && (strcmp (SDATA (name
), pattern
) == 0
2566 || (n
= x_face_list_fonts (f
, SDATA (name
),
2569 patterns
= XCDR (patterns
);
2577 /* Check if a font matching pattern_offset_t on frame F is available
2578 or not. PATTERN may be a cons (FAMILY . REGISTRY), in which case,
2579 a font name pattern is generated from FAMILY and REGISTRY. */
2582 face_font_available_p (f
, pattern
)
2584 Lisp_Object pattern
;
2588 if (! STRINGP (pattern
))
2590 Lisp_Object family
, registry
;
2591 char *family_str
, *registry_str
, *pattern_str
;
2593 CHECK_CONS (pattern
);
2594 family
= XCAR (pattern
);
2599 CHECK_STRING (family
);
2600 family_str
= (char *) SDATA (family
);
2602 registry
= XCDR (pattern
);
2603 if (NILP (registry
))
2607 CHECK_STRING (registry
);
2608 registry_str
= (char *) SDATA (registry
);
2611 pattern_str
= (char *) alloca (strlen (family_str
)
2612 + strlen (registry_str
)
2614 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2615 strcat (pattern_str
, family_str
);
2616 strcat (pattern_str
, "-*-");
2617 strcat (pattern_str
, registry_str
);
2618 if (!index (registry_str
, '-'))
2620 if (registry_str
[strlen (registry_str
) - 1] == '*')
2621 strcat (pattern_str
, "-*");
2623 strcat (pattern_str
, "*-*");
2625 pattern
= build_string (pattern_str
);
2628 /* Get the list of fonts matching PATTERN. */
2631 fonts
= w32_list_fonts (f
, pattern
, 0, 1);
2634 fonts
= x_list_fonts (f
, pattern
, -1, 1);
2636 return XINT (Flength (fonts
));
2640 /* Determine fonts matching PATTERN on frame F. Sort resulting fonts
2641 using comparison function CMPFN. Value is the number of fonts
2642 found. If value is non-zero, *FONTS is set to a vector of
2643 font_name structures allocated from the heap containing matching
2644 fonts. Each element of *FONTS contains a name member that is also
2645 allocated from the heap. Font names in these structures are split
2646 into fields. Use free_font_names to free such an array. */
2649 sorted_font_list (f
, pattern
, cmpfn
, fonts
)
2652 int (*cmpfn
) P_ ((const void *, const void *));
2653 struct font_name
**fonts
;
2657 /* Get the list of fonts matching pattern. 100 should suffice. */
2658 nfonts
= DEFAULT_FONT_LIST_LIMIT
;
2659 if (INTEGERP (Vfont_list_limit
))
2660 nfonts
= XINT (Vfont_list_limit
);
2663 nfonts
= x_face_list_fonts (f
, pattern
, fonts
, nfonts
, 1);
2665 /* Sort the resulting array and return it in *FONTS. If no
2666 fonts were found, make sure to set *FONTS to null. */
2668 sort_fonts (f
, *fonts
, nfonts
, cmpfn
);
2679 /* Compare two font_name structures *A and *B. Value is analogous to
2680 strcmp. Sort order is given by the global variable
2681 font_sort_order. Font names are sorted so that, everything else
2682 being equal, fonts with a resolution closer to that of the frame on
2683 which they are used are listed first. The global variable
2684 font_frame is the frame on which we operate. */
2687 cmp_font_names (a
, b
)
2690 struct font_name
*x
= (struct font_name
*) a
;
2691 struct font_name
*y
= (struct font_name
*) b
;
2694 /* All strings have been converted to lower-case by split_font_name,
2695 so we can use strcmp here. */
2696 cmp
= strcmp (x
->fields
[XLFD_FAMILY
], y
->fields
[XLFD_FAMILY
]);
2701 for (i
= 0; i
< DIM (font_sort_order
) && cmp
== 0; ++i
)
2703 int j
= font_sort_order
[i
];
2704 cmp
= x
->numeric
[j
] - y
->numeric
[j
];
2709 /* Everything else being equal, we prefer fonts with an
2710 y-resolution closer to that of the frame. */
2711 int resy
= FRAME_X_DISPLAY_INFO (font_frame
)->resy
;
2712 int x_resy
= x
->numeric
[XLFD_RESY
];
2713 int y_resy
= y
->numeric
[XLFD_RESY
];
2714 cmp
= abs (resy
- x_resy
) - abs (resy
- y_resy
);
2722 /* Get a sorted list of fonts of family FAMILY on frame F. If PATTERN
2723 is non-nil list fonts matching that pattern. Otherwise, if
2724 REGISTRY is non-nil return only fonts with that registry, otherwise
2725 return fonts of any registry. Set *FONTS to a vector of font_name
2726 structures allocated from the heap containing the fonts found.
2727 Value is the number of fonts found. */
2730 font_list_1 (f
, pattern
, family
, registry
, fonts
)
2732 Lisp_Object pattern
, family
, registry
;
2733 struct font_name
**fonts
;
2735 char *pattern_str
, *family_str
, *registry_str
;
2739 family_str
= (NILP (family
) ? "*" : (char *) SDATA (family
));
2740 registry_str
= (NILP (registry
) ? "*" : (char *) SDATA (registry
));
2742 pattern_str
= (char *) alloca (strlen (family_str
)
2743 + strlen (registry_str
)
2745 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2746 strcat (pattern_str
, family_str
);
2747 strcat (pattern_str
, "-*-");
2748 strcat (pattern_str
, registry_str
);
2749 if (!index (registry_str
, '-'))
2751 if (registry_str
[strlen (registry_str
) - 1] == '*')
2752 strcat (pattern_str
, "-*");
2754 strcat (pattern_str
, "*-*");
2758 pattern_str
= (char *) SDATA (pattern
);
2760 return sorted_font_list (f
, pattern_str
, cmp_font_names
, fonts
);
2764 /* Concatenate font list FONTS1 and FONTS2. FONTS1 and FONTS2
2765 contains NFONTS1 fonts and NFONTS2 fonts respectively. Return a
2766 pointer to a newly allocated font list. FONTS1 and FONTS2 are
2769 static struct font_name
*
2770 concat_font_list (fonts1
, nfonts1
, fonts2
, nfonts2
)
2771 struct font_name
*fonts1
, *fonts2
;
2772 int nfonts1
, nfonts2
;
2774 int new_nfonts
= nfonts1
+ nfonts2
;
2775 struct font_name
*new_fonts
;
2777 new_fonts
= (struct font_name
*) xmalloc (sizeof *new_fonts
* new_nfonts
);
2778 bcopy (fonts1
, new_fonts
, sizeof *new_fonts
* nfonts1
);
2779 bcopy (fonts2
, new_fonts
+ nfonts1
, sizeof *new_fonts
* nfonts2
);
2786 /* Get a sorted list of fonts of family FAMILY on frame F.
2788 If PATTERN is non-nil list fonts matching that pattern.
2790 If REGISTRY is non-nil, return fonts with that registry and the
2791 alternative registries from Vface_alternative_font_registry_alist.
2793 If REGISTRY is nil return fonts of any registry.
2795 Set *FONTS to a vector of font_name structures allocated from the
2796 heap containing the fonts found. Value is the number of fonts
2800 font_list (f
, pattern
, family
, registry
, fonts
)
2802 Lisp_Object pattern
, family
, registry
;
2803 struct font_name
**fonts
;
2805 int nfonts
= font_list_1 (f
, pattern
, family
, registry
, fonts
);
2807 if (!NILP (registry
)
2808 && CONSP (Vface_alternative_font_registry_alist
))
2812 alter
= Fassoc (registry
, Vface_alternative_font_registry_alist
);
2817 for (alter
= XCDR (alter
), reg_prio
= 1;
2819 alter
= XCDR (alter
), reg_prio
++)
2820 if (STRINGP (XCAR (alter
)))
2823 struct font_name
*fonts2
;
2825 nfonts2
= font_list_1 (f
, pattern
, family
, XCAR (alter
),
2827 for (i
= 0; i
< nfonts2
; i
++)
2828 fonts2
[i
].registry_priority
= reg_prio
;
2829 *fonts
= (nfonts
> 0
2830 ? concat_font_list (*fonts
, nfonts
, fonts2
, nfonts2
)
2841 /* Remove elements from LIST whose cars are `equal'. Called from
2842 x-family-fonts and x-font-family-list to remove duplicate font
2846 remove_duplicates (list
)
2849 Lisp_Object tail
= list
;
2851 while (!NILP (tail
) && !NILP (XCDR (tail
)))
2853 Lisp_Object next
= XCDR (tail
);
2854 if (!NILP (Fequal (XCAR (next
), XCAR (tail
))))
2855 XSETCDR (tail
, XCDR (next
));
2862 DEFUN ("x-family-fonts", Fx_family_fonts
, Sx_family_fonts
, 0, 2, 0,
2863 doc
: /* Return a list of available fonts of family FAMILY on FRAME.
2864 If FAMILY is omitted or nil, list all families.
2865 Otherwise, FAMILY must be a string, possibly containing wildcards
2867 If FRAME is omitted or nil, use the selected frame.
2868 Each element of the result is a vector [FAMILY WIDTH POINT-SIZE WEIGHT
2869 SLANT FIXED-P FULL REGISTRY-AND-ENCODING].
2870 FAMILY is the font family name. POINT-SIZE is the size of the
2871 font in 1/10 pt. WIDTH, WEIGHT, and SLANT are symbols describing the
2872 width, weight and slant of the font. These symbols are the same as for
2873 face attributes. FIXED-P is non-nil if the font is fixed-pitch.
2874 FULL is the full name of the font, and REGISTRY-AND-ENCODING is a string
2875 giving the registry and encoding of the font.
2876 The result list is sorted according to the current setting of
2877 the face font sort order. */)
2879 Lisp_Object family
, frame
;
2881 struct frame
*f
= check_x_frame (frame
);
2882 struct font_name
*fonts
;
2885 struct gcpro gcpro1
;
2888 CHECK_STRING (family
);
2892 nfonts
= font_list (f
, Qnil
, family
, Qnil
, &fonts
);
2893 for (i
= nfonts
- 1; i
>= 0; --i
)
2895 Lisp_Object v
= Fmake_vector (make_number (8), Qnil
);
2898 ASET (v
, 0, build_string (fonts
[i
].fields
[XLFD_FAMILY
]));
2899 ASET (v
, 1, xlfd_symbolic_swidth (fonts
+ i
));
2900 ASET (v
, 2, make_number (xlfd_point_size (f
, fonts
+ i
)));
2901 ASET (v
, 3, xlfd_symbolic_weight (fonts
+ i
));
2902 ASET (v
, 4, xlfd_symbolic_slant (fonts
+ i
));
2903 ASET (v
, 5, xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
);
2904 tem
= build_font_name (fonts
+ i
);
2905 ASET (v
, 6, build_string (tem
));
2906 sprintf (tem
, "%s-%s", fonts
[i
].fields
[XLFD_REGISTRY
],
2907 fonts
[i
].fields
[XLFD_ENCODING
]);
2908 ASET (v
, 7, build_string (tem
));
2911 result
= Fcons (v
, result
);
2914 remove_duplicates (result
);
2915 free_font_names (fonts
, nfonts
);
2921 DEFUN ("x-font-family-list", Fx_font_family_list
, Sx_font_family_list
,
2923 doc
: /* Return a list of available font families on FRAME.
2924 If FRAME is omitted or nil, use the selected frame.
2925 Value is a list of conses (FAMILY . FIXED-P) where FAMILY
2926 is a font family, and FIXED-P is non-nil if fonts of that family
2927 are fixed-pitch. */)
2931 struct frame
*f
= check_x_frame (frame
);
2933 struct font_name
*fonts
;
2935 struct gcpro gcpro1
;
2936 int count
= SPECPDL_INDEX ();
2938 /* Let's consider all fonts. */
2939 specbind (intern ("font-list-limit"), make_number (-1));
2940 nfonts
= font_list (f
, Qnil
, Qnil
, Qnil
, &fonts
);
2944 for (i
= nfonts
- 1; i
>= 0; --i
)
2945 result
= Fcons (Fcons (build_string (fonts
[i
].fields
[XLFD_FAMILY
]),
2946 xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
),
2949 remove_duplicates (result
);
2950 free_font_names (fonts
, nfonts
);
2952 return unbind_to (count
, result
);
2956 DEFUN ("x-list-fonts", Fx_list_fonts
, Sx_list_fonts
, 1, 5, 0,
2957 doc
: /* Return a list of the names of available fonts matching PATTERN.
2958 If optional arguments FACE and FRAME are specified, return only fonts
2959 the same size as FACE on FRAME.
2960 PATTERN is a string, perhaps with wildcard characters;
2961 the * character matches any substring, and
2962 the ? character matches any single character.
2963 PATTERN is case-insensitive.
2964 FACE is a face name--a symbol.
2966 The return value is a list of strings, suitable as arguments to
2969 Fonts Emacs can't use may or may not be excluded
2970 even if they match PATTERN and FACE.
2971 The optional fourth argument MAXIMUM sets a limit on how many
2972 fonts to match. The first MAXIMUM fonts are reported.
2973 The optional fifth argument WIDTH, if specified, is a number of columns
2974 occupied by a character of a font. In that case, return only fonts
2975 the WIDTH times as wide as FACE on FRAME. */)
2976 (pattern
, face
, frame
, maximum
, width
)
2977 Lisp_Object pattern
, face
, frame
, maximum
, width
;
2984 CHECK_STRING (pattern
);
2990 CHECK_NATNUM (maximum
);
2991 maxnames
= XINT (maximum
);
2995 CHECK_NUMBER (width
);
2997 /* We can't simply call check_x_frame because this function may be
2998 called before any frame is created. */
2999 f
= frame_or_selected_frame (frame
, 2);
3000 if (!FRAME_WINDOW_P (f
))
3002 /* Perhaps we have not yet created any frame. */
3007 /* Determine the width standard for comparison with the fonts we find. */
3013 /* This is of limited utility since it works with character
3014 widths. Keep it for compatibility. --gerd. */
3015 int face_id
= lookup_named_face (f
, face
, 0, 0);
3016 struct face
*face
= (face_id
< 0
3018 : FACE_FROM_ID (f
, face_id
));
3021 /* For historic reasons, FONT_WIDTH refers to average width on W32,
3022 not maximum as on X. Redefine here. */
3024 #define FONT_WIDTH FONT_MAX_WIDTH
3027 if (face
&& face
->font
)
3028 size
= FONT_WIDTH (face
->font
);
3030 size
= FONT_WIDTH (FRAME_FONT (f
)); /* FRAME_COLUMN_WIDTH (f) */
3033 size
*= XINT (width
);
3037 Lisp_Object args
[2];
3039 args
[0] = x_list_fonts (f
, pattern
, size
, maxnames
);
3041 /* We don't have to check fontsets. */
3043 args
[1] = list_fontsets (f
, pattern
, size
);
3044 return Fnconc (2, args
);
3048 #endif /* HAVE_WINDOW_SYSTEM */
3052 /***********************************************************************
3054 ***********************************************************************/
3056 /* Access face attributes of face LFACE, a Lisp vector. */
3058 #define LFACE_FAMILY(LFACE) AREF ((LFACE), LFACE_FAMILY_INDEX)
3059 #define LFACE_HEIGHT(LFACE) AREF ((LFACE), LFACE_HEIGHT_INDEX)
3060 #define LFACE_WEIGHT(LFACE) AREF ((LFACE), LFACE_WEIGHT_INDEX)
3061 #define LFACE_SLANT(LFACE) AREF ((LFACE), LFACE_SLANT_INDEX)
3062 #define LFACE_UNDERLINE(LFACE) AREF ((LFACE), LFACE_UNDERLINE_INDEX)
3063 #define LFACE_INVERSE(LFACE) AREF ((LFACE), LFACE_INVERSE_INDEX)
3064 #define LFACE_FOREGROUND(LFACE) AREF ((LFACE), LFACE_FOREGROUND_INDEX)
3065 #define LFACE_BACKGROUND(LFACE) AREF ((LFACE), LFACE_BACKGROUND_INDEX)
3066 #define LFACE_STIPPLE(LFACE) AREF ((LFACE), LFACE_STIPPLE_INDEX)
3067 #define LFACE_SWIDTH(LFACE) AREF ((LFACE), LFACE_SWIDTH_INDEX)
3068 #define LFACE_OVERLINE(LFACE) AREF ((LFACE), LFACE_OVERLINE_INDEX)
3069 #define LFACE_STRIKE_THROUGH(LFACE) AREF ((LFACE), LFACE_STRIKE_THROUGH_INDEX)
3070 #define LFACE_BOX(LFACE) AREF ((LFACE), LFACE_BOX_INDEX)
3071 #define LFACE_FONT(LFACE) AREF ((LFACE), LFACE_FONT_INDEX)
3072 #define LFACE_INHERIT(LFACE) AREF ((LFACE), LFACE_INHERIT_INDEX)
3073 #define LFACE_AVGWIDTH(LFACE) AREF ((LFACE), LFACE_AVGWIDTH_INDEX)
3075 /* Non-zero if LFACE is a Lisp face. A Lisp face is a vector of size
3076 LFACE_VECTOR_SIZE which has the symbol `face' in slot 0. */
3078 #define LFACEP(LFACE) \
3080 && XVECTOR (LFACE)->size == LFACE_VECTOR_SIZE \
3081 && EQ (AREF (LFACE, 0), Qface))
3086 /* Check consistency of Lisp face attribute vector ATTRS. */
3089 check_lface_attrs (attrs
)
3092 xassert (UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
3093 || STRINGP (attrs
[LFACE_FAMILY_INDEX
]));
3094 xassert (UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
3095 || SYMBOLP (attrs
[LFACE_SWIDTH_INDEX
]));
3096 xassert (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
3097 || INTEGERP (attrs
[LFACE_AVGWIDTH_INDEX
]));
3098 xassert (UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
3099 || INTEGERP (attrs
[LFACE_HEIGHT_INDEX
])
3100 || FLOATP (attrs
[LFACE_HEIGHT_INDEX
])
3101 || FUNCTIONP (attrs
[LFACE_HEIGHT_INDEX
]));
3102 xassert (UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
3103 || SYMBOLP (attrs
[LFACE_WEIGHT_INDEX
]));
3104 xassert (UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
3105 || SYMBOLP (attrs
[LFACE_SLANT_INDEX
]));
3106 xassert (UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
3107 || SYMBOLP (attrs
[LFACE_UNDERLINE_INDEX
])
3108 || STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]));
3109 xassert (UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
3110 || SYMBOLP (attrs
[LFACE_OVERLINE_INDEX
])
3111 || STRINGP (attrs
[LFACE_OVERLINE_INDEX
]));
3112 xassert (UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3113 || SYMBOLP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3114 || STRINGP (attrs
[LFACE_STRIKE_THROUGH_INDEX
]));
3115 xassert (UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
3116 || SYMBOLP (attrs
[LFACE_BOX_INDEX
])
3117 || STRINGP (attrs
[LFACE_BOX_INDEX
])
3118 || INTEGERP (attrs
[LFACE_BOX_INDEX
])
3119 || CONSP (attrs
[LFACE_BOX_INDEX
]));
3120 xassert (UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
3121 || SYMBOLP (attrs
[LFACE_INVERSE_INDEX
]));
3122 xassert (UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
3123 || STRINGP (attrs
[LFACE_FOREGROUND_INDEX
]));
3124 xassert (UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
3125 || STRINGP (attrs
[LFACE_BACKGROUND_INDEX
]));
3126 xassert (UNSPECIFIEDP (attrs
[LFACE_INHERIT_INDEX
])
3127 || NILP (attrs
[LFACE_INHERIT_INDEX
])
3128 || SYMBOLP (attrs
[LFACE_INHERIT_INDEX
])
3129 || CONSP (attrs
[LFACE_INHERIT_INDEX
]));
3130 #ifdef HAVE_WINDOW_SYSTEM
3131 xassert (UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
3132 || SYMBOLP (attrs
[LFACE_STIPPLE_INDEX
])
3133 || !NILP (Fbitmap_spec_p (attrs
[LFACE_STIPPLE_INDEX
])));
3134 xassert (UNSPECIFIEDP (attrs
[LFACE_FONT_INDEX
])
3135 || NILP (attrs
[LFACE_FONT_INDEX
])
3136 || STRINGP (attrs
[LFACE_FONT_INDEX
]));
3141 /* Check consistency of attributes of Lisp face LFACE (a Lisp vector). */
3149 xassert (LFACEP (lface
));
3150 check_lface_attrs (XVECTOR (lface
)->contents
);
3154 #else /* GLYPH_DEBUG == 0 */
3156 #define check_lface_attrs(attrs) (void) 0
3157 #define check_lface(lface) (void) 0
3159 #endif /* GLYPH_DEBUG == 0 */
3163 /* Face-merge cycle checking. */
3165 /* A `named merge point' is simply a point during face-merging where we
3166 look up a face by name. We keep a stack of which named lookups we're
3167 currently processing so that we can easily detect cycles, using a
3168 linked- list of struct named_merge_point structures, typically
3169 allocated on the stack frame of the named lookup functions which are
3170 active (so no consing is required). */
3171 struct named_merge_point
3173 Lisp_Object face_name
;
3174 struct named_merge_point
*prev
;
3178 /* If a face merging cycle is detected for FACE_NAME, return 0,
3179 otherwise add NEW_NAMED_MERGE_POINT, which is initialized using
3180 FACE_NAME, as the head of the linked list pointed to by
3181 NAMED_MERGE_POINTS, and return 1. */
3184 push_named_merge_point (struct named_merge_point
*new_named_merge_point
,
3185 Lisp_Object face_name
,
3186 struct named_merge_point
**named_merge_points
)
3188 struct named_merge_point
*prev
;
3190 for (prev
= *named_merge_points
; prev
; prev
= prev
->prev
)
3191 if (EQ (face_name
, prev
->face_name
))
3194 new_named_merge_point
->face_name
= face_name
;
3195 new_named_merge_point
->prev
= *named_merge_points
;
3197 *named_merge_points
= new_named_merge_point
;
3205 /* Resolve face name FACE_NAME. If FACE_NAME is a string, intern it
3206 to make it a symbol. If FACE_NAME is an alias for another face,
3207 return that face's name.
3209 Return default face in case of errors. */
3212 resolve_face_name (face_name
, signal_p
)
3213 Lisp_Object face_name
;
3216 Lisp_Object orig_face
;
3217 Lisp_Object tortoise
, hare
;
3219 if (STRINGP (face_name
))
3220 face_name
= intern (SDATA (face_name
));
3222 if (NILP (face_name
) || !SYMBOLP (face_name
))
3225 orig_face
= face_name
;
3226 tortoise
= hare
= face_name
;
3231 hare
= Fget (hare
, Qface_alias
);
3232 if (NILP (hare
) || !SYMBOLP (hare
))
3236 hare
= Fget (hare
, Qface_alias
);
3237 if (NILP (hare
) || !SYMBOLP (hare
))
3240 tortoise
= Fget (tortoise
, Qface_alias
);
3241 if (EQ (hare
, tortoise
))
3244 Fsignal (Qcircular_list
, Fcons (orig_face
, Qnil
));
3253 /* Return the face definition of FACE_NAME on frame F. F null means
3254 return the definition for new frames. FACE_NAME may be a string or
3255 a symbol (apparently Emacs 20.2 allowed strings as face names in
3256 face text properties; Ediff uses that). If FACE_NAME is an alias
3257 for another face, return that face's definition. If SIGNAL_P is
3258 non-zero, signal an error if FACE_NAME is not a valid face name.
3259 If SIGNAL_P is zero, value is nil if FACE_NAME is not a valid face
3262 static INLINE Lisp_Object
3263 lface_from_face_name (f
, face_name
, signal_p
)
3265 Lisp_Object face_name
;
3270 face_name
= resolve_face_name (face_name
, signal_p
);
3273 lface
= assq_no_quit (face_name
, f
->face_alist
);
3275 lface
= assq_no_quit (face_name
, Vface_new_frame_defaults
);
3278 lface
= XCDR (lface
);
3280 signal_error ("Invalid face", face_name
);
3282 check_lface (lface
);
3287 /* Get face attributes of face FACE_NAME from frame-local faces on
3288 frame F. Store the resulting attributes in ATTRS which must point
3289 to a vector of Lisp_Objects of size LFACE_VECTOR_SIZE. If SIGNAL_P
3290 is non-zero, signal an error if FACE_NAME does not name a face.
3291 Otherwise, value is zero if FACE_NAME is not a face. */
3294 get_lface_attributes (f
, face_name
, attrs
, signal_p
)
3296 Lisp_Object face_name
;
3303 lface
= lface_from_face_name (f
, face_name
, signal_p
);
3306 bcopy (XVECTOR (lface
)->contents
, attrs
,
3307 LFACE_VECTOR_SIZE
* sizeof *attrs
);
3317 /* Non-zero if all attributes in face attribute vector ATTRS are
3318 specified, i.e. are non-nil. */
3321 lface_fully_specified_p (attrs
)
3326 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3327 if (i
!= LFACE_FONT_INDEX
&& i
!= LFACE_INHERIT_INDEX
3328 && i
!= LFACE_AVGWIDTH_INDEX
)
3329 if (UNSPECIFIEDP (attrs
[i
])
3331 /* MAC_TODO: No stipple support on Mac OS yet, this index is
3332 always unspecified. */
3333 && i
!= LFACE_STIPPLE_INDEX
3338 return i
== LFACE_VECTOR_SIZE
;
3341 #ifdef HAVE_WINDOW_SYSTEM
3343 /* Set font-related attributes of Lisp face LFACE from the fullname of
3344 the font opened by FONTNAME. If FORCE_P is zero, set only
3345 unspecified attributes of LFACE. The exception is `font'
3346 attribute. It is set to FONTNAME as is regardless of FORCE_P.
3348 If FONTNAME is not available on frame F,
3349 return 0 if MAY_FAIL_P is non-zero, otherwise abort.
3350 If the fullname is not in a valid XLFD format,
3351 return 0 if MAY_FAIL_P is non-zero, otherwise set normal values
3352 in LFACE and return 1.
3353 Otherwise, return 1. */
3356 set_lface_from_font_name (f
, lface
, fontname
, force_p
, may_fail_p
)
3359 Lisp_Object fontname
;
3360 int force_p
, may_fail_p
;
3362 struct font_name font
;
3367 char *font_name
= SDATA (fontname
);
3368 struct font_info
*font_info
;
3370 /* If FONTNAME is actually a fontset name, get ASCII font name of it. */
3371 fontset
= fs_query_fontset (fontname
, 0);
3373 font_name
= SDATA (fontset_ascii (fontset
));
3375 /* Check if FONT_NAME is surely available on the system. Usually
3376 FONT_NAME is already cached for the frame F and FS_LOAD_FONT
3377 returns quickly. But, even if FONT_NAME is not yet cached,
3378 caching it now is not futail because we anyway load the font
3381 font_info
= FS_LOAD_FONT (f
, 0, font_name
, -1);
3391 font
.name
= STRDUPA (font_info
->full_name
);
3392 have_xlfd_p
= split_font_name (f
, &font
, 1);
3394 /* Set attributes only if unspecified, otherwise face defaults for
3395 new frames would never take effect. If we couldn't get a font
3396 name conforming to XLFD, set normal values. */
3398 if (force_p
|| UNSPECIFIEDP (LFACE_FAMILY (lface
)))
3403 buffer
= (char *) alloca (strlen (font
.fields
[XLFD_FAMILY
])
3404 + strlen (font
.fields
[XLFD_FOUNDRY
])
3406 sprintf (buffer
, "%s-%s", font
.fields
[XLFD_FOUNDRY
],
3407 font
.fields
[XLFD_FAMILY
]);
3408 val
= build_string (buffer
);
3411 val
= build_string ("*");
3412 LFACE_FAMILY (lface
) = val
;
3415 if (force_p
|| UNSPECIFIEDP (LFACE_HEIGHT (lface
)))
3418 pt
= xlfd_point_size (f
, &font
);
3420 pt
= pixel_point_size (f
, font_info
->height
* 10);
3422 LFACE_HEIGHT (lface
) = make_number (pt
);
3425 if (force_p
|| UNSPECIFIEDP (LFACE_SWIDTH (lface
)))
3426 LFACE_SWIDTH (lface
)
3427 = have_xlfd_p
? xlfd_symbolic_swidth (&font
) : Qnormal
;
3429 if (force_p
|| UNSPECIFIEDP (LFACE_AVGWIDTH (lface
)))
3430 LFACE_AVGWIDTH (lface
)
3432 ? make_number (font
.numeric
[XLFD_AVGWIDTH
])
3435 if (force_p
|| UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
3436 LFACE_WEIGHT (lface
)
3437 = have_xlfd_p
? xlfd_symbolic_weight (&font
) : Qnormal
;
3439 if (force_p
|| UNSPECIFIEDP (LFACE_SLANT (lface
)))
3441 = have_xlfd_p
? xlfd_symbolic_slant (&font
) : Qnormal
;
3443 LFACE_FONT (lface
) = fontname
;
3448 #endif /* HAVE_WINDOW_SYSTEM */
3451 /* Merges the face height FROM with the face height TO, and returns the
3452 merged height. If FROM is an invalid height, then INVALID is
3453 returned instead. FROM and TO may be either absolute face heights or
3454 `relative' heights; the returned value is always an absolute height
3455 unless both FROM and TO are relative. GCPRO is a lisp value that
3456 will be protected from garbage-collection if this function makes a
3460 merge_face_heights (from
, to
, invalid
)
3461 Lisp_Object from
, to
, invalid
;
3463 Lisp_Object result
= invalid
;
3465 if (INTEGERP (from
))
3466 /* FROM is absolute, just use it as is. */
3468 else if (FLOATP (from
))
3469 /* FROM is a scale, use it to adjust TO. */
3472 /* relative X absolute => absolute */
3473 result
= make_number ((EMACS_INT
)(XFLOAT_DATA (from
) * XINT (to
)));
3474 else if (FLOATP (to
))
3475 /* relative X relative => relative */
3476 result
= make_float (XFLOAT_DATA (from
) * XFLOAT_DATA (to
));
3477 else if (UNSPECIFIEDP (to
))
3480 else if (FUNCTIONP (from
))
3481 /* FROM is a function, which use to adjust TO. */
3483 /* Call function with current height as argument.
3484 From is the new height. */
3485 Lisp_Object args
[2];
3489 result
= safe_call (2, args
);
3491 /* Ensure that if TO was absolute, so is the result. */
3492 if (INTEGERP (to
) && !INTEGERP (result
))
3500 /* Merge two Lisp face attribute vectors on frame F, FROM and TO, and
3501 store the resulting attributes in TO, which must be already be
3502 completely specified and contain only absolute attributes. Every
3503 specified attribute of FROM overrides the corresponding attribute of
3504 TO; relative attributes in FROM are merged with the absolute value in
3505 TO and replace it. NAMED_MERGE_POINTS is used internally to detect
3506 loops in face inheritance; it should be 0 when called from other
3510 merge_face_vectors (f
, from
, to
, named_merge_points
)
3512 Lisp_Object
*from
, *to
;
3513 struct named_merge_point
*named_merge_points
;
3517 /* If FROM inherits from some other faces, merge their attributes into
3518 TO before merging FROM's direct attributes. Note that an :inherit
3519 attribute of `unspecified' is the same as one of nil; we never
3520 merge :inherit attributes, so nil is more correct, but lots of
3521 other code uses `unspecified' as a generic value for face attributes. */
3522 if (!UNSPECIFIEDP (from
[LFACE_INHERIT_INDEX
])
3523 && !NILP (from
[LFACE_INHERIT_INDEX
]))
3524 merge_face_ref (f
, from
[LFACE_INHERIT_INDEX
], to
, 0, named_merge_points
);
3526 /* If TO specifies a :font attribute, and FROM specifies some
3527 font-related attribute, we need to clear TO's :font attribute
3528 (because it will be inconsistent with whatever FROM specifies, and
3529 FROM takes precedence). */
3530 if (!NILP (to
[LFACE_FONT_INDEX
])
3531 && (!UNSPECIFIEDP (from
[LFACE_FAMILY_INDEX
])
3532 || !UNSPECIFIEDP (from
[LFACE_HEIGHT_INDEX
])
3533 || !UNSPECIFIEDP (from
[LFACE_WEIGHT_INDEX
])
3534 || !UNSPECIFIEDP (from
[LFACE_SLANT_INDEX
])
3535 || !UNSPECIFIEDP (from
[LFACE_SWIDTH_INDEX
])
3536 || !UNSPECIFIEDP (from
[LFACE_AVGWIDTH_INDEX
])))
3537 to
[LFACE_FONT_INDEX
] = Qnil
;
3539 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3540 if (!UNSPECIFIEDP (from
[i
]))
3542 if (i
== LFACE_HEIGHT_INDEX
&& !INTEGERP (from
[i
]))
3543 to
[i
] = merge_face_heights (from
[i
], to
[i
], to
[i
]);
3548 /* TO is always an absolute face, which should inherit from nothing.
3549 We blindly copy the :inherit attribute above and fix it up here. */
3550 to
[LFACE_INHERIT_INDEX
] = Qnil
;
3553 /* Merge the named face FACE_NAME on frame F, into the vector of face
3554 attributes TO. NAMED_MERGE_POINTS is used to detect loops in face
3555 inheritance. Returns true if FACE_NAME is a valid face name and
3556 merging succeeded. */
3559 merge_named_face (f
, face_name
, to
, named_merge_points
)
3561 Lisp_Object face_name
;
3563 struct named_merge_point
*named_merge_points
;
3565 struct named_merge_point named_merge_point
;
3567 if (push_named_merge_point (&named_merge_point
,
3568 face_name
, &named_merge_points
))
3570 struct gcpro gcpro1
;
3571 Lisp_Object from
[LFACE_VECTOR_SIZE
];
3572 int ok
= get_lface_attributes (f
, face_name
, from
, 0);
3576 GCPRO1 (named_merge_point
.face_name
);
3577 merge_face_vectors (f
, from
, to
, named_merge_points
);
3588 /* Merge face attributes from the lisp `face reference' FACE_REF on
3589 frame F into the face attribute vector TO. If ERR_MSGS is non-zero,
3590 problems with FACE_REF cause an error message to be shown. Return
3591 non-zero if no errors occurred (regardless of the value of ERR_MSGS).
3592 NAMED_MERGE_POINTS is used to detect loops in face inheritance or
3593 list structure; it may be 0 for most callers.
3595 FACE_REF may be a single face specification or a list of such
3596 specifications. Each face specification can be:
3598 1. A symbol or string naming a Lisp face.
3600 2. A property list of the form (KEYWORD VALUE ...) where each
3601 KEYWORD is a face attribute name, and value is an appropriate value
3604 3. Conses or the form (FOREGROUND-COLOR . COLOR) or
3605 (BACKGROUND-COLOR . COLOR) where COLOR is a color name. This is
3606 for compatibility with 20.2.
3608 Face specifications earlier in lists take precedence over later
3612 merge_face_ref (f
, face_ref
, to
, err_msgs
, named_merge_points
)
3614 Lisp_Object face_ref
;
3617 struct named_merge_point
*named_merge_points
;
3619 int ok
= 1; /* Succeed without an error? */
3621 if (CONSP (face_ref
))
3623 Lisp_Object first
= XCAR (face_ref
);
3625 if (EQ (first
, Qforeground_color
)
3626 || EQ (first
, Qbackground_color
))
3628 /* One of (FOREGROUND-COLOR . COLOR) or (BACKGROUND-COLOR
3629 . COLOR). COLOR must be a string. */
3630 Lisp_Object color_name
= XCDR (face_ref
);
3631 Lisp_Object color
= first
;
3633 if (STRINGP (color_name
))
3635 if (EQ (color
, Qforeground_color
))
3636 to
[LFACE_FOREGROUND_INDEX
] = color_name
;
3638 to
[LFACE_BACKGROUND_INDEX
] = color_name
;
3643 add_to_log ("Invalid face color", color_name
, Qnil
);
3647 else if (SYMBOLP (first
)
3648 && *SDATA (SYMBOL_NAME (first
)) == ':')
3650 /* Assume this is the property list form. */
3651 while (CONSP (face_ref
) && CONSP (XCDR (face_ref
)))
3653 Lisp_Object keyword
= XCAR (face_ref
);
3654 Lisp_Object value
= XCAR (XCDR (face_ref
));
3657 /* Specifying `unspecified' is a no-op. */
3658 if (EQ (value
, Qunspecified
))
3660 else if (EQ (keyword
, QCfamily
))
3662 if (STRINGP (value
))
3663 to
[LFACE_FAMILY_INDEX
] = value
;
3667 else if (EQ (keyword
, QCheight
))
3669 Lisp_Object new_height
=
3670 merge_face_heights (value
, to
[LFACE_HEIGHT_INDEX
], Qnil
);
3672 if (! NILP (new_height
))
3673 to
[LFACE_HEIGHT_INDEX
] = new_height
;
3677 else if (EQ (keyword
, QCweight
))
3680 && face_numeric_weight (value
) >= 0)
3681 to
[LFACE_WEIGHT_INDEX
] = value
;
3685 else if (EQ (keyword
, QCslant
))
3688 && face_numeric_slant (value
) >= 0)
3689 to
[LFACE_SLANT_INDEX
] = value
;
3693 else if (EQ (keyword
, QCunderline
))
3698 to
[LFACE_UNDERLINE_INDEX
] = value
;
3702 else if (EQ (keyword
, QCoverline
))
3707 to
[LFACE_OVERLINE_INDEX
] = value
;
3711 else if (EQ (keyword
, QCstrike_through
))
3716 to
[LFACE_STRIKE_THROUGH_INDEX
] = value
;
3720 else if (EQ (keyword
, QCbox
))
3723 value
= make_number (1);
3724 if (INTEGERP (value
)
3728 to
[LFACE_BOX_INDEX
] = value
;
3732 else if (EQ (keyword
, QCinverse_video
)
3733 || EQ (keyword
, QCreverse_video
))
3735 if (EQ (value
, Qt
) || NILP (value
))
3736 to
[LFACE_INVERSE_INDEX
] = value
;
3740 else if (EQ (keyword
, QCforeground
))
3742 if (STRINGP (value
))
3743 to
[LFACE_FOREGROUND_INDEX
] = value
;
3747 else if (EQ (keyword
, QCbackground
))
3749 if (STRINGP (value
))
3750 to
[LFACE_BACKGROUND_INDEX
] = value
;
3754 else if (EQ (keyword
, QCstipple
))
3756 #ifdef HAVE_X_WINDOWS
3757 Lisp_Object pixmap_p
= Fbitmap_spec_p (value
);
3758 if (!NILP (pixmap_p
))
3759 to
[LFACE_STIPPLE_INDEX
] = value
;
3764 else if (EQ (keyword
, QCwidth
))
3767 && face_numeric_swidth (value
) >= 0)
3768 to
[LFACE_SWIDTH_INDEX
] = value
;
3772 else if (EQ (keyword
, QCinherit
))
3774 /* This is not really very useful; it's just like a
3775 normal face reference. */
3776 if (! merge_face_ref (f
, value
, to
,
3777 err_msgs
, named_merge_points
))
3785 add_to_log ("Invalid face attribute %S %S", keyword
, value
);
3789 face_ref
= XCDR (XCDR (face_ref
));
3794 /* This is a list of face refs. Those at the beginning of the
3795 list take precedence over what follows, so we have to merge
3796 from the end backwards. */
3797 Lisp_Object next
= XCDR (face_ref
);
3800 ok
= merge_face_ref (f
, next
, to
, err_msgs
, named_merge_points
);
3802 if (! merge_face_ref (f
, first
, to
, err_msgs
, named_merge_points
))
3808 /* FACE_REF ought to be a face name. */
3809 ok
= merge_named_face (f
, face_ref
, to
, named_merge_points
);
3810 if (!ok
&& err_msgs
)
3811 add_to_log ("Invalid face reference: %s", face_ref
, Qnil
);
3818 DEFUN ("internal-make-lisp-face", Finternal_make_lisp_face
,
3819 Sinternal_make_lisp_face
, 1, 2, 0,
3820 doc
: /* Make FACE, a symbol, a Lisp face with all attributes nil.
3821 If FACE was not known as a face before, create a new one.
3822 If optional argument FRAME is specified, make a frame-local face
3823 for that frame. Otherwise operate on the global face definition.
3824 Value is a vector of face attributes. */)
3826 Lisp_Object face
, frame
;
3828 Lisp_Object global_lface
, lface
;
3832 CHECK_SYMBOL (face
);
3833 global_lface
= lface_from_face_name (NULL
, face
, 0);
3837 CHECK_LIVE_FRAME (frame
);
3839 lface
= lface_from_face_name (f
, face
, 0);
3842 f
= NULL
, lface
= Qnil
;
3844 /* Add a global definition if there is none. */
3845 if (NILP (global_lface
))
3847 global_lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
3849 AREF (global_lface
, 0) = Qface
;
3850 Vface_new_frame_defaults
= Fcons (Fcons (face
, global_lface
),
3851 Vface_new_frame_defaults
);
3853 /* Assign the new Lisp face a unique ID. The mapping from Lisp
3854 face id to Lisp face is given by the vector lface_id_to_name.
3855 The mapping from Lisp face to Lisp face id is given by the
3856 property `face' of the Lisp face name. */
3857 if (next_lface_id
== lface_id_to_name_size
)
3859 int new_size
= max (50, 2 * lface_id_to_name_size
);
3860 int sz
= new_size
* sizeof *lface_id_to_name
;
3861 lface_id_to_name
= (Lisp_Object
*) xrealloc (lface_id_to_name
, sz
);
3862 lface_id_to_name_size
= new_size
;
3865 lface_id_to_name
[next_lface_id
] = face
;
3866 Fput (face
, Qface
, make_number (next_lface_id
));
3870 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3871 AREF (global_lface
, i
) = Qunspecified
;
3873 /* Add a frame-local definition. */
3878 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
3880 AREF (lface
, 0) = Qface
;
3881 f
->face_alist
= Fcons (Fcons (face
, lface
), f
->face_alist
);
3884 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3885 AREF (lface
, i
) = Qunspecified
;
3888 lface
= global_lface
;
3890 /* Changing a named face means that all realized faces depending on
3891 that face are invalid. Since we cannot tell which realized faces
3892 depend on the face, make sure they are all removed. This is done
3893 by incrementing face_change_count. The next call to
3894 init_iterator will then free realized faces. */
3895 if (NILP (Fget (face
, Qface_no_inherit
)))
3897 ++face_change_count
;
3898 ++windows_or_buffers_changed
;
3901 xassert (LFACEP (lface
));
3902 check_lface (lface
);
3907 DEFUN ("internal-lisp-face-p", Finternal_lisp_face_p
,
3908 Sinternal_lisp_face_p
, 1, 2, 0,
3909 doc
: /* Return non-nil if FACE names a face.
3910 If optional second argument FRAME is non-nil, check for the
3911 existence of a frame-local face with name FACE on that frame.
3912 Otherwise check for the existence of a global face. */)
3914 Lisp_Object face
, frame
;
3920 CHECK_LIVE_FRAME (frame
);
3921 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
3924 lface
= lface_from_face_name (NULL
, face
, 0);
3930 DEFUN ("internal-copy-lisp-face", Finternal_copy_lisp_face
,
3931 Sinternal_copy_lisp_face
, 4, 4, 0,
3932 doc
: /* Copy face FROM to TO.
3933 If FRAME is t, copy the global face definition of FROM.
3934 Otherwise, copy the frame-local definition of FROM on FRAME.
3935 If NEW-FRAME is a frame, copy that data into the frame-local
3936 definition of TO on NEW-FRAME. If NEW-FRAME is nil.
3937 FRAME controls where the data is copied to.
3939 The value is TO. */)
3940 (from
, to
, frame
, new_frame
)
3941 Lisp_Object from
, to
, frame
, new_frame
;
3943 Lisp_Object lface
, copy
;
3945 CHECK_SYMBOL (from
);
3950 /* Copy global definition of FROM. We don't make copies of
3951 strings etc. because 20.2 didn't do it either. */
3952 lface
= lface_from_face_name (NULL
, from
, 1);
3953 copy
= Finternal_make_lisp_face (to
, Qnil
);
3957 /* Copy frame-local definition of FROM. */
3958 if (NILP (new_frame
))
3960 CHECK_LIVE_FRAME (frame
);
3961 CHECK_LIVE_FRAME (new_frame
);
3962 lface
= lface_from_face_name (XFRAME (frame
), from
, 1);
3963 copy
= Finternal_make_lisp_face (to
, new_frame
);
3966 bcopy (XVECTOR (lface
)->contents
, XVECTOR (copy
)->contents
,
3967 LFACE_VECTOR_SIZE
* sizeof (Lisp_Object
));
3969 /* Changing a named face means that all realized faces depending on
3970 that face are invalid. Since we cannot tell which realized faces
3971 depend on the face, make sure they are all removed. This is done
3972 by incrementing face_change_count. The next call to
3973 init_iterator will then free realized faces. */
3974 if (NILP (Fget (to
, Qface_no_inherit
)))
3976 ++face_change_count
;
3977 ++windows_or_buffers_changed
;
3984 DEFUN ("internal-set-lisp-face-attribute", Finternal_set_lisp_face_attribute
,
3985 Sinternal_set_lisp_face_attribute
, 3, 4, 0,
3986 doc
: /* Set attribute ATTR of FACE to VALUE.
3987 FRAME being a frame means change the face on that frame.
3988 FRAME nil means change the face of the selected frame.
3989 FRAME t means change the default for new frames.
3990 FRAME 0 means change the face on all frames, and change the default
3992 (face
, attr
, value
, frame
)
3993 Lisp_Object face
, attr
, value
, frame
;
3996 Lisp_Object old_value
= Qnil
;
3997 /* Set 1 if ATTR is QCfont. */
3998 int font_attr_p
= 0;
3999 /* Set 1 if ATTR is one of font-related attributes other than QCfont. */
4000 int font_related_attr_p
= 0;
4002 CHECK_SYMBOL (face
);
4003 CHECK_SYMBOL (attr
);
4005 face
= resolve_face_name (face
, 1);
4007 /* If FRAME is 0, change face on all frames, and change the
4008 default for new frames. */
4009 if (INTEGERP (frame
) && XINT (frame
) == 0)
4012 Finternal_set_lisp_face_attribute (face
, attr
, value
, Qt
);
4013 FOR_EACH_FRAME (tail
, frame
)
4014 Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
4018 /* Set lface to the Lisp attribute vector of FACE. */
4020 lface
= lface_from_face_name (NULL
, face
, 1);
4024 frame
= selected_frame
;
4026 CHECK_LIVE_FRAME (frame
);
4027 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
4029 /* If a frame-local face doesn't exist yet, create one. */
4031 lface
= Finternal_make_lisp_face (face
, frame
);
4034 if (EQ (attr
, QCfamily
))
4036 if (!UNSPECIFIEDP (value
))
4038 CHECK_STRING (value
);
4039 if (SCHARS (value
) == 0)
4040 signal_error ("Invalid face family", value
);
4042 old_value
= LFACE_FAMILY (lface
);
4043 LFACE_FAMILY (lface
) = value
;
4044 font_related_attr_p
= 1;
4046 else if (EQ (attr
, QCheight
))
4048 if (!UNSPECIFIEDP (value
))
4052 test
= (EQ (face
, Qdefault
)
4054 /* The default face must have an absolute size,
4055 otherwise, we do a test merge with a random
4056 height to see if VALUE's ok. */
4057 : merge_face_heights (value
, make_number (10), Qnil
));
4059 if (!INTEGERP (test
) || XINT (test
) <= 0)
4060 signal_error ("Invalid face height", value
);
4063 old_value
= LFACE_HEIGHT (lface
);
4064 LFACE_HEIGHT (lface
) = value
;
4065 font_related_attr_p
= 1;
4067 else if (EQ (attr
, QCweight
))
4069 if (!UNSPECIFIEDP (value
))
4071 CHECK_SYMBOL (value
);
4072 if (face_numeric_weight (value
) < 0)
4073 signal_error ("Invalid face weight", value
);
4075 old_value
= LFACE_WEIGHT (lface
);
4076 LFACE_WEIGHT (lface
) = value
;
4077 font_related_attr_p
= 1;
4079 else if (EQ (attr
, QCslant
))
4081 if (!UNSPECIFIEDP (value
))
4083 CHECK_SYMBOL (value
);
4084 if (face_numeric_slant (value
) < 0)
4085 signal_error ("Invalid face slant", value
);
4087 old_value
= LFACE_SLANT (lface
);
4088 LFACE_SLANT (lface
) = value
;
4089 font_related_attr_p
= 1;
4091 else if (EQ (attr
, QCunderline
))
4093 if (!UNSPECIFIEDP (value
))
4094 if ((SYMBOLP (value
)
4096 && !EQ (value
, Qnil
))
4097 /* Underline color. */
4099 && SCHARS (value
) == 0))
4100 signal_error ("Invalid face underline", value
);
4102 old_value
= LFACE_UNDERLINE (lface
);
4103 LFACE_UNDERLINE (lface
) = value
;
4105 else if (EQ (attr
, QCoverline
))
4107 if (!UNSPECIFIEDP (value
))
4108 if ((SYMBOLP (value
)
4110 && !EQ (value
, Qnil
))
4111 /* Overline color. */
4113 && SCHARS (value
) == 0))
4114 signal_error ("Invalid face overline", value
);
4116 old_value
= LFACE_OVERLINE (lface
);
4117 LFACE_OVERLINE (lface
) = value
;
4119 else if (EQ (attr
, QCstrike_through
))
4121 if (!UNSPECIFIEDP (value
))
4122 if ((SYMBOLP (value
)
4124 && !EQ (value
, Qnil
))
4125 /* Strike-through color. */
4127 && SCHARS (value
) == 0))
4128 signal_error ("Invalid face strike-through", value
);
4130 old_value
= LFACE_STRIKE_THROUGH (lface
);
4131 LFACE_STRIKE_THROUGH (lface
) = value
;
4133 else if (EQ (attr
, QCbox
))
4137 /* Allow t meaning a simple box of width 1 in foreground color
4140 value
= make_number (1);
4142 if (UNSPECIFIEDP (value
))
4144 else if (NILP (value
))
4146 else if (INTEGERP (value
))
4147 valid_p
= XINT (value
) != 0;
4148 else if (STRINGP (value
))
4149 valid_p
= SCHARS (value
) > 0;
4150 else if (CONSP (value
))
4166 if (EQ (k
, QCline_width
))
4168 if (!INTEGERP (v
) || XINT (v
) == 0)
4171 else if (EQ (k
, QCcolor
))
4173 if (!NILP (v
) && (!STRINGP (v
) || SCHARS (v
) == 0))
4176 else if (EQ (k
, QCstyle
))
4178 if (!EQ (v
, Qpressed_button
) && !EQ (v
, Qreleased_button
))
4185 valid_p
= NILP (tem
);
4191 signal_error ("Invalid face box", value
);
4193 old_value
= LFACE_BOX (lface
);
4194 LFACE_BOX (lface
) = value
;
4196 else if (EQ (attr
, QCinverse_video
)
4197 || EQ (attr
, QCreverse_video
))
4199 if (!UNSPECIFIEDP (value
))
4201 CHECK_SYMBOL (value
);
4202 if (!EQ (value
, Qt
) && !NILP (value
))
4203 signal_error ("Invalid inverse-video face attribute value", value
);
4205 old_value
= LFACE_INVERSE (lface
);
4206 LFACE_INVERSE (lface
) = value
;
4208 else if (EQ (attr
, QCforeground
))
4210 if (!UNSPECIFIEDP (value
))
4212 /* Don't check for valid color names here because it depends
4213 on the frame (display) whether the color will be valid
4214 when the face is realized. */
4215 CHECK_STRING (value
);
4216 if (SCHARS (value
) == 0)
4217 signal_error ("Empty foreground color value", value
);
4219 old_value
= LFACE_FOREGROUND (lface
);
4220 LFACE_FOREGROUND (lface
) = value
;
4222 else if (EQ (attr
, QCbackground
))
4224 if (!UNSPECIFIEDP (value
))
4226 /* Don't check for valid color names here because it depends
4227 on the frame (display) whether the color will be valid
4228 when the face is realized. */
4229 CHECK_STRING (value
);
4230 if (SCHARS (value
) == 0)
4231 signal_error ("Empty background color value", value
);
4233 old_value
= LFACE_BACKGROUND (lface
);
4234 LFACE_BACKGROUND (lface
) = value
;
4236 else if (EQ (attr
, QCstipple
))
4238 #ifdef HAVE_X_WINDOWS
4239 if (!UNSPECIFIEDP (value
)
4241 && NILP (Fbitmap_spec_p (value
)))
4242 signal_error ("Invalid stipple attribute", value
);
4243 old_value
= LFACE_STIPPLE (lface
);
4244 LFACE_STIPPLE (lface
) = value
;
4245 #endif /* HAVE_X_WINDOWS */
4247 else if (EQ (attr
, QCwidth
))
4249 if (!UNSPECIFIEDP (value
))
4251 CHECK_SYMBOL (value
);
4252 if (face_numeric_swidth (value
) < 0)
4253 signal_error ("Invalid face width", value
);
4255 old_value
= LFACE_SWIDTH (lface
);
4256 LFACE_SWIDTH (lface
) = value
;
4257 font_related_attr_p
= 1;
4259 else if (EQ (attr
, QCfont
))
4261 #ifdef HAVE_WINDOW_SYSTEM
4262 if (EQ (frame
, Qt
) || FRAME_WINDOW_P (XFRAME (frame
)))
4264 /* Set font-related attributes of the Lisp face from an XLFD
4270 f
= SELECTED_FRAME ();
4272 f
= check_x_frame (frame
);
4274 if (!UNSPECIFIEDP (value
))
4276 CHECK_STRING (value
);
4278 /* VALUE may be a fontset name or an alias of fontset. In
4279 such a case, use the base fontset name. */
4280 tmp
= Fquery_fontset (value
, Qnil
);
4284 if (!set_lface_from_font_name (f
, lface
, value
, 1, 1))
4285 signal_error ("Invalid font or fontset name", value
);
4290 #endif /* HAVE_WINDOW_SYSTEM */
4292 else if (EQ (attr
, QCinherit
))
4295 if (SYMBOLP (value
))
4298 for (tail
= value
; CONSP (tail
); tail
= XCDR (tail
))
4299 if (!SYMBOLP (XCAR (tail
)))
4302 LFACE_INHERIT (lface
) = value
;
4304 signal_error ("Invalid face inheritance", value
);
4306 else if (EQ (attr
, QCbold
))
4308 old_value
= LFACE_WEIGHT (lface
);
4309 LFACE_WEIGHT (lface
) = NILP (value
) ? Qnormal
: Qbold
;
4310 font_related_attr_p
= 1;
4312 else if (EQ (attr
, QCitalic
))
4314 old_value
= LFACE_SLANT (lface
);
4315 LFACE_SLANT (lface
) = NILP (value
) ? Qnormal
: Qitalic
;
4316 font_related_attr_p
= 1;
4319 signal_error ("Invalid face attribute name", attr
);
4321 if (font_related_attr_p
4322 && !UNSPECIFIEDP (value
))
4323 /* If a font-related attribute other than QCfont is specified, the
4324 original `font' attribute nor that of default face is useless
4325 to determine a new font. Thus, we set it to nil so that font
4326 selection mechanism doesn't use it. */
4327 LFACE_FONT (lface
) = Qnil
;
4329 /* Changing a named face means that all realized faces depending on
4330 that face are invalid. Since we cannot tell which realized faces
4331 depend on the face, make sure they are all removed. This is done
4332 by incrementing face_change_count. The next call to
4333 init_iterator will then free realized faces. */
4335 && NILP (Fget (face
, Qface_no_inherit
))
4336 && (EQ (attr
, QCfont
)
4337 || NILP (Fequal (old_value
, value
))))
4339 ++face_change_count
;
4340 ++windows_or_buffers_changed
;
4343 if (!UNSPECIFIEDP (value
)
4344 && NILP (Fequal (old_value
, value
)))
4350 if (EQ (face
, Qdefault
))
4352 #ifdef HAVE_WINDOW_SYSTEM
4353 /* Changed font-related attributes of the `default' face are
4354 reflected in changed `font' frame parameters. */
4356 && (font_related_attr_p
|| font_attr_p
)
4357 && lface_fully_specified_p (XVECTOR (lface
)->contents
))
4358 set_font_frame_param (frame
, lface
);
4360 #endif /* HAVE_WINDOW_SYSTEM */
4362 if (EQ (attr
, QCforeground
))
4363 param
= Qforeground_color
;
4364 else if (EQ (attr
, QCbackground
))
4365 param
= Qbackground_color
;
4367 #ifdef HAVE_WINDOW_SYSTEM
4369 else if (EQ (face
, Qscroll_bar
))
4371 /* Changing the colors of `scroll-bar' sets frame parameters
4372 `scroll-bar-foreground' and `scroll-bar-background'. */
4373 if (EQ (attr
, QCforeground
))
4374 param
= Qscroll_bar_foreground
;
4375 else if (EQ (attr
, QCbackground
))
4376 param
= Qscroll_bar_background
;
4378 #endif /* not WINDOWSNT */
4379 else if (EQ (face
, Qborder
))
4381 /* Changing background color of `border' sets frame parameter
4383 if (EQ (attr
, QCbackground
))
4384 param
= Qborder_color
;
4386 else if (EQ (face
, Qcursor
))
4388 /* Changing background color of `cursor' sets frame parameter
4390 if (EQ (attr
, QCbackground
))
4391 param
= Qcursor_color
;
4393 else if (EQ (face
, Qmouse
))
4395 /* Changing background color of `mouse' sets frame parameter
4397 if (EQ (attr
, QCbackground
))
4398 param
= Qmouse_color
;
4400 #endif /* HAVE_WINDOW_SYSTEM */
4401 else if (EQ (face
, Qmenu
))
4403 /* Indicate that we have to update the menu bar when
4404 realizing faces on FRAME. FRAME t change the
4405 default for new frames. We do this by setting
4406 setting the flag in new face caches */
4409 struct frame
*f
= XFRAME (frame
);
4410 if (FRAME_FACE_CACHE (f
) == NULL
)
4411 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
4412 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 1;
4415 menu_face_changed_default
= 1;
4421 /* Update `default-frame-alist', which is used for new frames. */
4423 store_in_alist (&Vdefault_frame_alist
, param
, value
);
4426 /* Update the current frame's parameters. */
4429 cons
= XCAR (Vparam_value_alist
);
4430 XSETCAR (cons
, param
);
4431 XSETCDR (cons
, value
);
4432 Fmodify_frame_parameters (frame
, Vparam_value_alist
);
4441 #ifdef HAVE_WINDOW_SYSTEM
4443 /* Set the `font' frame parameter of FRAME determined from `default'
4444 face attributes LFACE. If a face or fontset name is explicitely
4445 specfied in LFACE, use it as is. Otherwise, determine a font name
4446 from the other font-related atrributes of LFACE. In that case, if
4447 there's no matching font, signals an error. */
4450 set_font_frame_param (frame
, lface
)
4451 Lisp_Object frame
, lface
;
4453 struct frame
*f
= XFRAME (frame
);
4455 if (FRAME_WINDOW_P (f
))
4457 Lisp_Object font_name
;
4460 if (STRINGP (LFACE_FONT (lface
)))
4461 font_name
= LFACE_FONT (lface
);
4464 /* Choose a font name that reflects LFACE's attributes and has
4465 the registry and encoding pattern specified in the default
4466 fontset (3rd arg: -1) for ASCII characters (4th arg: 0). */
4467 font
= choose_face_font (f
, XVECTOR (lface
)->contents
, -1, 0, 0);
4469 error ("No font matches the specified attribute");
4470 font_name
= build_string (font
);
4474 f
->default_face_done_p
= 0;
4475 Fmodify_frame_parameters (frame
, Fcons (Fcons (Qfont
, font_name
), Qnil
));
4480 /* Update the corresponding face when frame parameter PARAM on frame F
4481 has been assigned the value NEW_VALUE. */
4484 update_face_from_frame_parameter (f
, param
, new_value
)
4486 Lisp_Object param
, new_value
;
4488 Lisp_Object face
= Qnil
;
4491 /* If there are no faces yet, give up. This is the case when called
4492 from Fx_create_frame, and we do the necessary things later in
4493 face-set-after-frame-defaults. */
4494 if (NILP (f
->face_alist
))
4497 if (EQ (param
, Qforeground_color
))
4500 lface
= lface_from_face_name (f
, face
, 1);
4501 LFACE_FOREGROUND (lface
) = (STRINGP (new_value
)
4502 ? new_value
: Qunspecified
);
4503 realize_basic_faces (f
);
4505 else if (EQ (param
, Qbackground_color
))
4509 /* Changing the background color might change the background
4510 mode, so that we have to load new defface specs.
4511 Call frame-set-background-mode to do that. */
4512 XSETFRAME (frame
, f
);
4513 call1 (Qframe_set_background_mode
, frame
);
4516 lface
= lface_from_face_name (f
, face
, 1);
4517 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4518 ? new_value
: Qunspecified
);
4519 realize_basic_faces (f
);
4521 else if (EQ (param
, Qborder_color
))
4524 lface
= lface_from_face_name (f
, face
, 1);
4525 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4526 ? new_value
: Qunspecified
);
4528 else if (EQ (param
, Qcursor_color
))
4531 lface
= lface_from_face_name (f
, face
, 1);
4532 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4533 ? new_value
: Qunspecified
);
4535 else if (EQ (param
, Qmouse_color
))
4538 lface
= lface_from_face_name (f
, face
, 1);
4539 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4540 ? new_value
: Qunspecified
);
4543 /* Changing a named face means that all realized faces depending on
4544 that face are invalid. Since we cannot tell which realized faces
4545 depend on the face, make sure they are all removed. This is done
4546 by incrementing face_change_count. The next call to
4547 init_iterator will then free realized faces. */
4549 && NILP (Fget (face
, Qface_no_inherit
)))
4551 ++face_change_count
;
4552 ++windows_or_buffers_changed
;
4557 /* Get the value of X resource RESOURCE, class CLASS for the display
4558 of frame FRAME. This is here because ordinary `x-get-resource'
4559 doesn't take a frame argument. */
4561 DEFUN ("internal-face-x-get-resource", Finternal_face_x_get_resource
,
4562 Sinternal_face_x_get_resource
, 3, 3, 0, doc
: /* */)
4563 (resource
, class, frame
)
4564 Lisp_Object resource
, class, frame
;
4566 Lisp_Object value
= Qnil
;
4567 CHECK_STRING (resource
);
4568 CHECK_STRING (class);
4569 CHECK_LIVE_FRAME (frame
);
4571 value
= display_x_get_resource (FRAME_X_DISPLAY_INFO (XFRAME (frame
)),
4572 resource
, class, Qnil
, Qnil
);
4578 /* Return resource string VALUE as a boolean value, i.e. nil, or t.
4579 If VALUE is "on" or "true", return t. If VALUE is "off" or
4580 "false", return nil. Otherwise, if SIGNAL_P is non-zero, signal an
4581 error; if SIGNAL_P is zero, return 0. */
4584 face_boolean_x_resource_value (value
, signal_p
)
4588 Lisp_Object result
= make_number (0);
4590 xassert (STRINGP (value
));
4592 if (xstricmp (SDATA (value
), "on") == 0
4593 || xstricmp (SDATA (value
), "true") == 0)
4595 else if (xstricmp (SDATA (value
), "off") == 0
4596 || xstricmp (SDATA (value
), "false") == 0)
4598 else if (xstricmp (SDATA (value
), "unspecified") == 0)
4599 result
= Qunspecified
;
4601 signal_error ("Invalid face attribute value from X resource", value
);
4607 DEFUN ("internal-set-lisp-face-attribute-from-resource",
4608 Finternal_set_lisp_face_attribute_from_resource
,
4609 Sinternal_set_lisp_face_attribute_from_resource
,
4610 3, 4, 0, doc
: /* */)
4611 (face
, attr
, value
, frame
)
4612 Lisp_Object face
, attr
, value
, frame
;
4614 CHECK_SYMBOL (face
);
4615 CHECK_SYMBOL (attr
);
4616 CHECK_STRING (value
);
4618 if (xstricmp (SDATA (value
), "unspecified") == 0)
4619 value
= Qunspecified
;
4620 else if (EQ (attr
, QCheight
))
4622 value
= Fstring_to_number (value
, make_number (10));
4623 if (XINT (value
) <= 0)
4624 signal_error ("Invalid face height from X resource", value
);
4626 else if (EQ (attr
, QCbold
) || EQ (attr
, QCitalic
))
4627 value
= face_boolean_x_resource_value (value
, 1);
4628 else if (EQ (attr
, QCweight
) || EQ (attr
, QCslant
) || EQ (attr
, QCwidth
))
4629 value
= intern (SDATA (value
));
4630 else if (EQ (attr
, QCreverse_video
) || EQ (attr
, QCinverse_video
))
4631 value
= face_boolean_x_resource_value (value
, 1);
4632 else if (EQ (attr
, QCunderline
)
4633 || EQ (attr
, QCoverline
)
4634 || EQ (attr
, QCstrike_through
))
4636 Lisp_Object boolean_value
;
4638 /* If the result of face_boolean_x_resource_value is t or nil,
4639 VALUE does NOT specify a color. */
4640 boolean_value
= face_boolean_x_resource_value (value
, 0);
4641 if (SYMBOLP (boolean_value
))
4642 value
= boolean_value
;
4644 else if (EQ (attr
, QCbox
))
4645 value
= Fcar (Fread_from_string (value
, Qnil
, Qnil
));
4647 return Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
4650 #endif /* HAVE_WINDOW_SYSTEM */
4653 /***********************************************************************
4655 ***********************************************************************/
4657 #if defined HAVE_X_WINDOWS && defined USE_X_TOOLKIT
4659 /* Make menus on frame F appear as specified by the `menu' face. */
4662 x_update_menu_appearance (f
)
4665 struct x_display_info
*dpyinfo
= FRAME_X_DISPLAY_INFO (f
);
4669 && (rdb
= XrmGetDatabase (FRAME_X_DISPLAY (f
)),
4673 Lisp_Object lface
= lface_from_face_name (f
, Qmenu
, 1);
4674 struct face
*face
= FACE_FROM_ID (f
, MENU_FACE_ID
);
4675 const char *myname
= SDATA (Vx_resource_name
);
4678 const char *popup_path
= "popup_menu";
4680 const char *popup_path
= "menu.popup";
4683 if (STRINGP (LFACE_FOREGROUND (lface
)))
4685 sprintf (line
, "%s.%s*foreground: %s",
4687 SDATA (LFACE_FOREGROUND (lface
)));
4688 XrmPutLineResource (&rdb
, line
);
4689 sprintf (line
, "%s.pane.menubar*foreground: %s",
4690 myname
, SDATA (LFACE_FOREGROUND (lface
)));
4691 XrmPutLineResource (&rdb
, line
);
4695 if (STRINGP (LFACE_BACKGROUND (lface
)))
4697 sprintf (line
, "%s.%s*background: %s",
4699 SDATA (LFACE_BACKGROUND (lface
)));
4700 XrmPutLineResource (&rdb
, line
);
4701 sprintf (line
, "%s.pane.menubar*background: %s",
4702 myname
, SDATA (LFACE_BACKGROUND (lface
)));
4703 XrmPutLineResource (&rdb
, line
);
4708 && (!UNSPECIFIEDP (LFACE_FAMILY (lface
))
4709 || !UNSPECIFIEDP (LFACE_SWIDTH (lface
))
4710 || !UNSPECIFIEDP (LFACE_AVGWIDTH (lface
))
4711 || !UNSPECIFIEDP (LFACE_WEIGHT (lface
))
4712 || !UNSPECIFIEDP (LFACE_SLANT (lface
))
4713 || !UNSPECIFIEDP (LFACE_HEIGHT (lface
))))
4716 const char *suffix
= "List";
4719 #if defined HAVE_X_I18N
4721 const char *suffix
= "Set";
4723 const char *suffix
= "";
4727 #if defined HAVE_X_I18N
4728 extern char *xic_create_fontsetname
4729 P_ ((char *base_fontname
, Bool motif
));
4730 char *fontsetname
= xic_create_fontsetname (face
->font_name
, motif
);
4732 char *fontsetname
= face
->font_name
;
4734 sprintf (line
, "%s.pane.menubar*font%s: %s",
4735 myname
, suffix
, fontsetname
);
4736 XrmPutLineResource (&rdb
, line
);
4737 sprintf (line
, "%s.%s*font%s: %s",
4738 myname
, popup_path
, suffix
, fontsetname
);
4739 XrmPutLineResource (&rdb
, line
);
4741 if (fontsetname
!= face
->font_name
)
4742 xfree (fontsetname
);
4745 if (changed_p
&& f
->output_data
.x
->menubar_widget
)
4746 free_frame_menubar (f
);
4750 #endif /* HAVE_X_WINDOWS && USE_X_TOOLKIT */
4753 DEFUN ("face-attribute-relative-p", Fface_attribute_relative_p
,
4754 Sface_attribute_relative_p
,
4756 doc
: /* Return non-nil if face ATTRIBUTE VALUE is relative. */)
4758 Lisp_Object attribute
, value
;
4760 if (EQ (value
, Qunspecified
))
4762 else if (EQ (attribute
, QCheight
))
4763 return INTEGERP (value
) ? Qnil
: Qt
;
4768 DEFUN ("merge-face-attribute", Fmerge_face_attribute
, Smerge_face_attribute
,
4770 doc
: /* Return face ATTRIBUTE VALUE1 merged with VALUE2.
4771 If VALUE1 or VALUE2 are absolute (see `face-attribute-relative-p'), then
4772 the result will be absolute, otherwise it will be relative. */)
4773 (attribute
, value1
, value2
)
4774 Lisp_Object attribute
, value1
, value2
;
4776 if (EQ (value1
, Qunspecified
))
4778 else if (EQ (attribute
, QCheight
))
4779 return merge_face_heights (value1
, value2
, value1
);
4785 DEFUN ("internal-get-lisp-face-attribute", Finternal_get_lisp_face_attribute
,
4786 Sinternal_get_lisp_face_attribute
,
4788 doc
: /* Return face attribute KEYWORD of face SYMBOL.
4789 If SYMBOL does not name a valid Lisp face or KEYWORD isn't a valid
4790 face attribute name, signal an error.
4791 If the optional argument FRAME is given, report on face SYMBOL in that
4792 frame. If FRAME is t, report on the defaults for face SYMBOL (for new
4793 frames). If FRAME is omitted or nil, use the selected frame. */)
4794 (symbol
, keyword
, frame
)
4795 Lisp_Object symbol
, keyword
, frame
;
4797 Lisp_Object lface
, value
= Qnil
;
4799 CHECK_SYMBOL (symbol
);
4800 CHECK_SYMBOL (keyword
);
4803 lface
= lface_from_face_name (NULL
, symbol
, 1);
4807 frame
= selected_frame
;
4808 CHECK_LIVE_FRAME (frame
);
4809 lface
= lface_from_face_name (XFRAME (frame
), symbol
, 1);
4812 if (EQ (keyword
, QCfamily
))
4813 value
= LFACE_FAMILY (lface
);
4814 else if (EQ (keyword
, QCheight
))
4815 value
= LFACE_HEIGHT (lface
);
4816 else if (EQ (keyword
, QCweight
))
4817 value
= LFACE_WEIGHT (lface
);
4818 else if (EQ (keyword
, QCslant
))
4819 value
= LFACE_SLANT (lface
);
4820 else if (EQ (keyword
, QCunderline
))
4821 value
= LFACE_UNDERLINE (lface
);
4822 else if (EQ (keyword
, QCoverline
))
4823 value
= LFACE_OVERLINE (lface
);
4824 else if (EQ (keyword
, QCstrike_through
))
4825 value
= LFACE_STRIKE_THROUGH (lface
);
4826 else if (EQ (keyword
, QCbox
))
4827 value
= LFACE_BOX (lface
);
4828 else if (EQ (keyword
, QCinverse_video
)
4829 || EQ (keyword
, QCreverse_video
))
4830 value
= LFACE_INVERSE (lface
);
4831 else if (EQ (keyword
, QCforeground
))
4832 value
= LFACE_FOREGROUND (lface
);
4833 else if (EQ (keyword
, QCbackground
))
4834 value
= LFACE_BACKGROUND (lface
);
4835 else if (EQ (keyword
, QCstipple
))
4836 value
= LFACE_STIPPLE (lface
);
4837 else if (EQ (keyword
, QCwidth
))
4838 value
= LFACE_SWIDTH (lface
);
4839 else if (EQ (keyword
, QCinherit
))
4840 value
= LFACE_INHERIT (lface
);
4841 else if (EQ (keyword
, QCfont
))
4842 value
= LFACE_FONT (lface
);
4844 signal_error ("Invalid face attribute name", keyword
);
4850 DEFUN ("internal-lisp-face-attribute-values",
4851 Finternal_lisp_face_attribute_values
,
4852 Sinternal_lisp_face_attribute_values
, 1, 1, 0,
4853 doc
: /* Return a list of valid discrete values for face attribute ATTR.
4854 Value is nil if ATTR doesn't have a discrete set of valid values. */)
4858 Lisp_Object result
= Qnil
;
4860 CHECK_SYMBOL (attr
);
4862 if (EQ (attr
, QCweight
)
4863 || EQ (attr
, QCslant
)
4864 || EQ (attr
, QCwidth
))
4866 /* Extract permissible symbols from tables. */
4867 struct table_entry
*table
;
4870 if (EQ (attr
, QCweight
))
4871 table
= weight_table
, dim
= DIM (weight_table
);
4872 else if (EQ (attr
, QCslant
))
4873 table
= slant_table
, dim
= DIM (slant_table
);
4875 table
= swidth_table
, dim
= DIM (swidth_table
);
4877 for (i
= 0; i
< dim
; ++i
)
4879 Lisp_Object symbol
= *table
[i
].symbol
;
4880 Lisp_Object tail
= result
;
4883 && !EQ (XCAR (tail
), symbol
))
4887 result
= Fcons (symbol
, result
);
4890 else if (EQ (attr
, QCunderline
))
4891 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4892 else if (EQ (attr
, QCoverline
))
4893 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4894 else if (EQ (attr
, QCstrike_through
))
4895 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4896 else if (EQ (attr
, QCinverse_video
) || EQ (attr
, QCreverse_video
))
4897 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4903 DEFUN ("internal-merge-in-global-face", Finternal_merge_in_global_face
,
4904 Sinternal_merge_in_global_face
, 2, 2, 0,
4905 doc
: /* Add attributes from frame-default definition of FACE to FACE on FRAME.
4906 Default face attributes override any local face attributes. */)
4908 Lisp_Object face
, frame
;
4911 Lisp_Object global_lface
, local_lface
, *gvec
, *lvec
;
4913 CHECK_LIVE_FRAME (frame
);
4914 global_lface
= lface_from_face_name (NULL
, face
, 1);
4915 local_lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
4916 if (NILP (local_lface
))
4917 local_lface
= Finternal_make_lisp_face (face
, frame
);
4919 /* Make every specified global attribute override the local one.
4920 BEWARE!! This is only used from `face-set-after-frame-default' where
4921 the local frame is defined from default specs in `face-defface-spec'
4922 and those should be overridden by global settings. Hence the strange
4923 "global before local" priority. */
4924 lvec
= XVECTOR (local_lface
)->contents
;
4925 gvec
= XVECTOR (global_lface
)->contents
;
4926 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
4927 if (! UNSPECIFIEDP (gvec
[i
]))
4934 /* The following function is implemented for compatibility with 20.2.
4935 The function is used in x-resolve-fonts when it is asked to
4936 return fonts with the same size as the font of a face. This is
4937 done in fontset.el. */
4939 DEFUN ("face-font", Fface_font
, Sface_font
, 1, 2, 0,
4940 doc
: /* Return the font name of face FACE, or nil if it is unspecified.
4941 If the optional argument FRAME is given, report on face FACE in that frame.
4942 If FRAME is t, report on the defaults for face FACE (for new frames).
4943 The font default for a face is either nil, or a list
4944 of the form (bold), (italic) or (bold italic).
4945 If FRAME is omitted or nil, use the selected frame. */)
4947 Lisp_Object face
, frame
;
4951 Lisp_Object result
= Qnil
;
4952 Lisp_Object lface
= lface_from_face_name (NULL
, face
, 1);
4954 if (!UNSPECIFIEDP (LFACE_WEIGHT (lface
))
4955 && !EQ (LFACE_WEIGHT (lface
), Qnormal
))
4956 result
= Fcons (Qbold
, result
);
4958 if (!UNSPECIFIEDP (LFACE_SLANT (lface
))
4959 && !EQ (LFACE_SLANT (lface
), Qnormal
))
4960 result
= Fcons (Qitalic
, result
);
4966 struct frame
*f
= frame_or_selected_frame (frame
, 1);
4967 int face_id
= lookup_named_face (f
, face
, 0, 1);
4968 struct face
*face
= FACE_FROM_ID (f
, face_id
);
4969 return face
? build_string (face
->font_name
) : Qnil
;
4974 /* Compare face-attribute values v1 and v2 for equality. Value is non-zero if
4975 all attributes are `equal'. Tries to be fast because this function
4976 is called quite often. */
4979 face_attr_equal_p (v1
, v2
)
4982 /* Type can differ, e.g. when one attribute is unspecified, i.e. nil,
4983 and the other is specified. */
4984 if (XTYPE (v1
) != XTYPE (v2
))
4993 if (SBYTES (v1
) != SBYTES (v2
))
4996 return bcmp (SDATA (v1
), SDATA (v2
), SBYTES (v1
)) == 0;
5003 return !NILP (Fequal (v1
, v2
));
5008 /* Compare face vectors V1 and V2 for equality. Value is non-zero if
5009 all attributes are `equal'. Tries to be fast because this function
5010 is called quite often. */
5013 lface_equal_p (v1
, v2
)
5014 Lisp_Object
*v1
, *v2
;
5018 for (i
= 1; i
< LFACE_VECTOR_SIZE
&& equal_p
; ++i
)
5019 equal_p
= face_attr_equal_p (v1
[i
], v2
[i
]);
5025 DEFUN ("internal-lisp-face-equal-p", Finternal_lisp_face_equal_p
,
5026 Sinternal_lisp_face_equal_p
, 2, 3, 0,
5027 doc
: /* True if FACE1 and FACE2 are equal.
5028 If the optional argument FRAME is given, report on FACE1 and FACE2 in that frame.
5029 If FRAME is t, report on the defaults for FACE1 and FACE2 (for new frames).
5030 If FRAME is omitted or nil, use the selected frame. */)
5031 (face1
, face2
, frame
)
5032 Lisp_Object face1
, face2
, frame
;
5036 Lisp_Object lface1
, lface2
;
5041 /* Don't use check_x_frame here because this function is called
5042 before X frames exist. At that time, if FRAME is nil,
5043 selected_frame will be used which is the frame dumped with
5044 Emacs. That frame is not an X frame. */
5045 f
= frame_or_selected_frame (frame
, 2);
5047 lface1
= lface_from_face_name (f
, face1
, 1);
5048 lface2
= lface_from_face_name (f
, face2
, 1);
5049 equal_p
= lface_equal_p (XVECTOR (lface1
)->contents
,
5050 XVECTOR (lface2
)->contents
);
5051 return equal_p
? Qt
: Qnil
;
5055 DEFUN ("internal-lisp-face-empty-p", Finternal_lisp_face_empty_p
,
5056 Sinternal_lisp_face_empty_p
, 1, 2, 0,
5057 doc
: /* True if FACE has no attribute specified.
5058 If the optional argument FRAME is given, report on face FACE in that frame.
5059 If FRAME is t, report on the defaults for face FACE (for new frames).
5060 If FRAME is omitted or nil, use the selected frame. */)
5062 Lisp_Object face
, frame
;
5069 frame
= selected_frame
;
5070 CHECK_LIVE_FRAME (frame
);
5074 lface
= lface_from_face_name (NULL
, face
, 1);
5076 lface
= lface_from_face_name (f
, face
, 1);
5078 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
5079 if (!UNSPECIFIEDP (AREF (lface
, i
)))
5082 return i
== LFACE_VECTOR_SIZE
? Qt
: Qnil
;
5086 DEFUN ("frame-face-alist", Fframe_face_alist
, Sframe_face_alist
,
5088 doc
: /* Return an alist of frame-local faces defined on FRAME.
5089 For internal use only. */)
5093 struct frame
*f
= frame_or_selected_frame (frame
, 0);
5094 return f
->face_alist
;
5098 /* Return a hash code for Lisp string STRING with case ignored. Used
5099 below in computing a hash value for a Lisp face. */
5101 static INLINE
unsigned
5102 hash_string_case_insensitive (string
)
5105 const unsigned char *s
;
5107 xassert (STRINGP (string
));
5108 for (s
= SDATA (string
); *s
; ++s
)
5109 hash
= (hash
<< 1) ^ tolower (*s
);
5114 /* Return a hash code for face attribute vector V. */
5116 static INLINE
unsigned
5120 return (hash_string_case_insensitive (v
[LFACE_FAMILY_INDEX
])
5121 ^ hash_string_case_insensitive (v
[LFACE_FOREGROUND_INDEX
])
5122 ^ hash_string_case_insensitive (v
[LFACE_BACKGROUND_INDEX
])
5123 ^ XFASTINT (v
[LFACE_WEIGHT_INDEX
])
5124 ^ XFASTINT (v
[LFACE_SLANT_INDEX
])
5125 ^ XFASTINT (v
[LFACE_SWIDTH_INDEX
])
5126 ^ XFASTINT (v
[LFACE_HEIGHT_INDEX
]));
5130 /* Return non-zero if LFACE1 and LFACE2 specify the same font (without
5131 considering charsets/registries). They do if they specify the same
5132 family, point size, weight, width, slant, and fontset. Both LFACE1
5133 and LFACE2 must be fully-specified. */
5136 lface_same_font_attributes_p (lface1
, lface2
)
5137 Lisp_Object
*lface1
, *lface2
;
5139 xassert (lface_fully_specified_p (lface1
)
5140 && lface_fully_specified_p (lface2
));
5141 return (xstricmp (SDATA (lface1
[LFACE_FAMILY_INDEX
]),
5142 SDATA (lface2
[LFACE_FAMILY_INDEX
])) == 0
5143 && EQ (lface1
[LFACE_HEIGHT_INDEX
], lface2
[LFACE_HEIGHT_INDEX
])
5144 && EQ (lface1
[LFACE_SWIDTH_INDEX
], lface2
[LFACE_SWIDTH_INDEX
])
5145 && EQ (lface1
[LFACE_AVGWIDTH_INDEX
], lface2
[LFACE_AVGWIDTH_INDEX
])
5146 && EQ (lface1
[LFACE_WEIGHT_INDEX
], lface2
[LFACE_WEIGHT_INDEX
])
5147 && EQ (lface1
[LFACE_SLANT_INDEX
], lface2
[LFACE_SLANT_INDEX
])
5148 && (EQ (lface1
[LFACE_FONT_INDEX
], lface2
[LFACE_FONT_INDEX
])
5149 || (STRINGP (lface1
[LFACE_FONT_INDEX
])
5150 && STRINGP (lface2
[LFACE_FONT_INDEX
])
5151 && xstricmp (SDATA (lface1
[LFACE_FONT_INDEX
]),
5152 SDATA (lface2
[LFACE_FONT_INDEX
])))));
5157 /***********************************************************************
5159 ***********************************************************************/
5161 /* Allocate and return a new realized face for Lisp face attribute
5164 static struct face
*
5165 make_realized_face (attr
)
5168 struct face
*face
= (struct face
*) xmalloc (sizeof *face
);
5169 bzero (face
, sizeof *face
);
5170 face
->ascii_face
= face
;
5171 bcopy (attr
, face
->lface
, sizeof face
->lface
);
5176 /* Free realized face FACE, including its X resources. FACE may
5180 free_realized_face (f
, face
)
5186 #ifdef HAVE_WINDOW_SYSTEM
5187 if (FRAME_WINDOW_P (f
))
5189 /* Free fontset of FACE if it is ASCII face. */
5190 if (face
->fontset
>= 0 && face
== face
->ascii_face
)
5191 free_face_fontset (f
, face
);
5194 x_free_gc (f
, face
->gc
);
5198 free_face_colors (f
, face
);
5199 x_destroy_bitmap (f
, face
->stipple
);
5201 #endif /* HAVE_WINDOW_SYSTEM */
5208 /* Prepare face FACE for subsequent display on frame F. This
5209 allocated GCs if they haven't been allocated yet or have been freed
5210 by clearing the face cache. */
5213 prepare_face_for_display (f
, face
)
5217 #ifdef HAVE_WINDOW_SYSTEM
5218 xassert (FRAME_WINDOW_P (f
));
5223 unsigned long mask
= GCForeground
| GCBackground
| GCGraphicsExposures
;
5225 xgcv
.foreground
= face
->foreground
;
5226 xgcv
.background
= face
->background
;
5227 #ifdef HAVE_X_WINDOWS
5228 xgcv
.graphics_exposures
= False
;
5230 /* The font of FACE may be null if we couldn't load it. */
5233 #ifdef HAVE_X_WINDOWS
5234 xgcv
.font
= face
->font
->fid
;
5237 xgcv
.font
= face
->font
;
5240 xgcv
.font
= face
->font
;
5246 #ifdef HAVE_X_WINDOWS
5249 xgcv
.fill_style
= FillOpaqueStippled
;
5250 xgcv
.stipple
= x_bitmap_pixmap (f
, face
->stipple
);
5251 mask
|= GCFillStyle
| GCStipple
;
5254 face
->gc
= x_create_gc (f
, mask
, &xgcv
);
5257 #endif /* HAVE_WINDOW_SYSTEM */
5261 /* Returns the `distance' between the colors X and Y. */
5264 color_distance (x
, y
)
5267 /* This formula is from a paper title `Colour metric' by Thiadmer Riemersma.
5268 Quoting from that paper:
5270 This formula has results that are very close to L*u*v* (with the
5271 modified lightness curve) and, more importantly, it is a more even
5272 algorithm: it does not have a range of colours where it suddenly
5273 gives far from optimal results.
5275 See <http://www.compuphase.com/cmetric.htm> for more info. */
5277 long r
= (x
->red
- y
->red
) >> 8;
5278 long g
= (x
->green
- y
->green
) >> 8;
5279 long b
= (x
->blue
- y
->blue
) >> 8;
5280 long r_mean
= (x
->red
+ y
->red
) >> 9;
5283 (((512 + r_mean
) * r
* r
) >> 8)
5285 + (((767 - r_mean
) * b
* b
) >> 8);
5289 DEFUN ("color-distance", Fcolor_distance
, Scolor_distance
, 2, 3, 0,
5290 doc
: /* Return an integer distance between COLOR1 and COLOR2 on FRAME.
5291 COLOR1 and COLOR2 may be either strings containing the color name,
5292 or lists of the form (RED GREEN BLUE).
5293 If FRAME is unspecified or nil, the current frame is used. */)
5294 (color1
, color2
, frame
)
5295 Lisp_Object color1
, color2
, frame
;
5298 XColor cdef1
, cdef2
;
5301 frame
= selected_frame
;
5302 CHECK_LIVE_FRAME (frame
);
5305 if ((CONSP (color1
) && !parse_rgb_list (color1
, &cdef1
))
5306 || !STRINGP (color1
)
5307 || !defined_color (f
, SDATA (color1
), &cdef1
, 0))
5308 signal_error ("Invalid color", color1
);
5309 if ((CONSP (color2
) && !parse_rgb_list (color2
, &cdef2
))
5310 || !STRINGP (color2
)
5311 || !defined_color (f
, SDATA (color2
), &cdef2
, 0))
5312 signal_error ("Invalid color", color2
);
5314 return make_number (color_distance (&cdef1
, &cdef2
));
5318 /***********************************************************************
5320 ***********************************************************************/
5322 /* Return a new face cache for frame F. */
5324 static struct face_cache
*
5328 struct face_cache
*c
;
5331 c
= (struct face_cache
*) xmalloc (sizeof *c
);
5332 bzero (c
, sizeof *c
);
5333 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5334 c
->buckets
= (struct face
**) xmalloc (size
);
5335 bzero (c
->buckets
, size
);
5337 c
->faces_by_id
= (struct face
**) xmalloc (c
->size
* sizeof *c
->faces_by_id
);
5339 c
->menu_face_changed_p
= menu_face_changed_default
;
5344 /* Clear out all graphics contexts for all realized faces, except for
5345 the basic faces. This should be done from time to time just to avoid
5346 keeping too many graphics contexts that are no longer needed. */
5350 struct face_cache
*c
;
5352 if (c
&& FRAME_WINDOW_P (c
->f
))
5354 #ifdef HAVE_WINDOW_SYSTEM
5356 for (i
= BASIC_FACE_ID_SENTINEL
; i
< c
->used
; ++i
)
5358 struct face
*face
= c
->faces_by_id
[i
];
5359 if (face
&& face
->gc
)
5361 x_free_gc (c
->f
, face
->gc
);
5365 #endif /* HAVE_WINDOW_SYSTEM */
5370 /* Free all realized faces in face cache C, including basic faces.
5371 C may be null. If faces are freed, make sure the frame's current
5372 matrix is marked invalid, so that a display caused by an expose
5373 event doesn't try to use faces we destroyed. */
5376 free_realized_faces (c
)
5377 struct face_cache
*c
;
5382 struct frame
*f
= c
->f
;
5384 /* We must block input here because we can't process X events
5385 safely while only some faces are freed, or when the frame's
5386 current matrix still references freed faces. */
5389 for (i
= 0; i
< c
->used
; ++i
)
5391 free_realized_face (f
, c
->faces_by_id
[i
]);
5392 c
->faces_by_id
[i
] = NULL
;
5396 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5397 bzero (c
->buckets
, size
);
5399 /* Must do a thorough redisplay the next time. Mark current
5400 matrices as invalid because they will reference faces freed
5401 above. This function is also called when a frame is
5402 destroyed. In this case, the root window of F is nil. */
5403 if (WINDOWP (f
->root_window
))
5405 clear_current_matrices (f
);
5406 ++windows_or_buffers_changed
;
5414 /* Free all faces realized for multibyte characters on frame F that
5418 free_realized_multibyte_face (f
, fontset
)
5422 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5426 /* We must block input here because we can't process X events safely
5427 while only some faces are freed, or when the frame's current
5428 matrix still references freed faces. */
5431 for (i
= 0; i
< cache
->used
; i
++)
5433 face
= cache
->faces_by_id
[i
];
5435 && face
!= face
->ascii_face
5436 && face
->fontset
== fontset
)
5438 uncache_face (cache
, face
);
5439 free_realized_face (f
, face
);
5443 /* Must do a thorough redisplay the next time. Mark current
5444 matrices as invalid because they will reference faces freed
5445 above. This function is also called when a frame is destroyed.
5446 In this case, the root window of F is nil. */
5447 if (WINDOWP (f
->root_window
))
5449 clear_current_matrices (f
);
5450 ++windows_or_buffers_changed
;
5457 /* Free all realized faces on FRAME or on all frames if FRAME is nil.
5458 This is done after attributes of a named face have been changed,
5459 because we can't tell which realized faces depend on that face. */
5462 free_all_realized_faces (frame
)
5468 FOR_EACH_FRAME (rest
, frame
)
5469 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5472 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5476 /* Free face cache C and faces in it, including their X resources. */
5480 struct face_cache
*c
;
5484 free_realized_faces (c
);
5486 xfree (c
->faces_by_id
);
5492 /* Cache realized face FACE in face cache C. HASH is the hash value
5493 of FACE. If FACE->fontset >= 0, add the new face to the end of the
5494 collision list of the face hash table of C. This is done because
5495 otherwise lookup_face would find FACE for every character, even if
5496 faces with the same attributes but for specific characters exist. */
5499 cache_face (c
, face
, hash
)
5500 struct face_cache
*c
;
5504 int i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5508 if (face
->fontset
>= 0)
5510 struct face
*last
= c
->buckets
[i
];
5521 c
->buckets
[i
] = face
;
5522 face
->prev
= face
->next
= NULL
;
5528 face
->next
= c
->buckets
[i
];
5530 face
->next
->prev
= face
;
5531 c
->buckets
[i
] = face
;
5534 /* Find a free slot in C->faces_by_id and use the index of the free
5535 slot as FACE->id. */
5536 for (i
= 0; i
< c
->used
; ++i
)
5537 if (c
->faces_by_id
[i
] == NULL
)
5541 /* Maybe enlarge C->faces_by_id. */
5544 if (c
->used
== c
->size
)
5547 new_size
= min (2 * c
->size
, MAX_FACE_ID
);
5548 if (new_size
== c
->size
)
5549 abort (); /* Alternatives? ++kfs */
5550 sz
= new_size
* sizeof *c
->faces_by_id
;
5551 c
->faces_by_id
= (struct face
**) xrealloc (c
->faces_by_id
, sz
);
5558 /* Check that FACE got a unique id. */
5563 for (j
= n
= 0; j
< FACE_CACHE_BUCKETS_SIZE
; ++j
)
5564 for (face
= c
->buckets
[j
]; face
; face
= face
->next
)
5570 #endif /* GLYPH_DEBUG */
5572 c
->faces_by_id
[i
] = face
;
5576 /* Remove face FACE from cache C. */
5579 uncache_face (c
, face
)
5580 struct face_cache
*c
;
5583 int i
= face
->hash
% FACE_CACHE_BUCKETS_SIZE
;
5586 face
->prev
->next
= face
->next
;
5588 c
->buckets
[i
] = face
->next
;
5591 face
->next
->prev
= face
->prev
;
5593 c
->faces_by_id
[face
->id
] = NULL
;
5594 if (face
->id
== c
->used
)
5599 /* Look up a realized face with face attributes ATTR in the face cache
5600 of frame F. The face will be used to display character C. Value
5601 is the ID of the face found. If no suitable face is found, realize
5602 a new one. In that case, if C is a multibyte character, BASE_FACE
5603 is a face that has the same attributes. */
5606 lookup_face (f
, attr
, c
, base_face
)
5610 struct face
*base_face
;
5612 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5617 xassert (cache
!= NULL
);
5618 check_lface_attrs (attr
);
5620 /* Look up ATTR in the face cache. */
5621 hash
= lface_hash (attr
);
5622 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5624 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
5625 if (face
->hash
== hash
5626 && (!FRAME_WINDOW_P (f
)
5627 || FACE_SUITABLE_FOR_CHAR_P (face
, c
))
5628 && lface_equal_p (face
->lface
, attr
))
5631 /* If not found, realize a new face. */
5633 face
= realize_face (cache
, attr
, c
, base_face
, -1);
5636 xassert (face
== FACE_FROM_ID (f
, face
->id
));
5638 /* When this function is called from face_for_char (in this case, C is
5639 a multibyte character), a fontset of a face returned by
5640 realize_face is not yet set, i.e. FACE_SUITABLE_FOR_CHAR_P (FACE,
5641 C) is not sutisfied. The fontset is set for this face by
5642 face_for_char later. */
5644 if (FRAME_WINDOW_P (f
))
5645 xassert (FACE_SUITABLE_FOR_CHAR_P (face
, c
));
5647 #endif /* GLYPH_DEBUG */
5653 /* Return the face id of the realized face for named face SYMBOL on
5654 frame F suitable for displaying character C. Value is -1 if the
5655 face couldn't be determined, which might happen if the default face
5656 isn't realized and cannot be realized. */
5659 lookup_named_face (f
, symbol
, c
, signal_p
)
5665 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5666 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5667 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5669 if (default_face
== NULL
)
5671 if (!realize_basic_faces (f
))
5673 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5676 if (!get_lface_attributes (f
, symbol
, symbol_attrs
, signal_p
))
5679 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
5680 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
5682 return lookup_face (f
, attrs
, c
, NULL
);
5686 /* Return the ID of the realized ASCII face of Lisp face with ID
5687 LFACE_ID on frame F. Value is -1 if LFACE_ID isn't valid. */
5690 ascii_face_of_lisp_face (f
, lface_id
)
5696 if (lface_id
>= 0 && lface_id
< lface_id_to_name_size
)
5698 Lisp_Object face_name
= lface_id_to_name
[lface_id
];
5699 face_id
= lookup_named_face (f
, face_name
, 0, 1);
5708 /* Return a face for charset ASCII that is like the face with id
5709 FACE_ID on frame F, but has a font that is STEPS steps smaller.
5710 STEPS < 0 means larger. Value is the id of the face. */
5713 smaller_face (f
, face_id
, steps
)
5717 #ifdef HAVE_WINDOW_SYSTEM
5719 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5720 int pt
, last_pt
, last_height
;
5723 struct face
*new_face
;
5725 /* If not called for an X frame, just return the original face. */
5726 if (FRAME_TERMCAP_P (f
))
5729 /* Try in increments of 1/2 pt. */
5730 delta
= steps
< 0 ? 5 : -5;
5731 steps
= abs (steps
);
5733 face
= FACE_FROM_ID (f
, face_id
);
5734 bcopy (face
->lface
, attrs
, sizeof attrs
);
5735 pt
= last_pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
5736 new_face_id
= face_id
;
5737 last_height
= FONT_HEIGHT (face
->font
);
5741 /* Give up if we cannot find a font within 10pt. */
5742 && abs (last_pt
- pt
) < 100)
5744 /* Look up a face for a slightly smaller/larger font. */
5746 attrs
[LFACE_HEIGHT_INDEX
] = make_number (pt
);
5747 new_face_id
= lookup_face (f
, attrs
, 0, NULL
);
5748 new_face
= FACE_FROM_ID (f
, new_face_id
);
5750 /* If height changes, count that as one step. */
5751 if ((delta
< 0 && FONT_HEIGHT (new_face
->font
) < last_height
)
5752 || (delta
> 0 && FONT_HEIGHT (new_face
->font
) > last_height
))
5755 last_height
= FONT_HEIGHT (new_face
->font
);
5762 #else /* not HAVE_WINDOW_SYSTEM */
5766 #endif /* not HAVE_WINDOW_SYSTEM */
5770 /* Return a face for charset ASCII that is like the face with id
5771 FACE_ID on frame F, but has height HEIGHT. */
5774 face_with_height (f
, face_id
, height
)
5779 #ifdef HAVE_WINDOW_SYSTEM
5781 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5783 if (FRAME_TERMCAP_P (f
)
5787 face
= FACE_FROM_ID (f
, face_id
);
5788 bcopy (face
->lface
, attrs
, sizeof attrs
);
5789 attrs
[LFACE_HEIGHT_INDEX
] = make_number (height
);
5790 face_id
= lookup_face (f
, attrs
, 0, NULL
);
5791 #endif /* HAVE_WINDOW_SYSTEM */
5797 /* Return the face id of the realized face for named face SYMBOL on
5798 frame F suitable for displaying character C, and use attributes of
5799 the face FACE_ID for attributes that aren't completely specified by
5800 SYMBOL. This is like lookup_named_face, except that the default
5801 attributes come from FACE_ID, not from the default face. FACE_ID
5802 is assumed to be already realized. */
5805 lookup_derived_face (f
, symbol
, c
, face_id
, signal_p
)
5811 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5812 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5813 struct face
*default_face
= FACE_FROM_ID (f
, face_id
);
5818 get_lface_attributes (f
, symbol
, symbol_attrs
, signal_p
);
5819 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
5820 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
5821 return lookup_face (f
, attrs
, c
, default_face
);
5824 DEFUN ("face-attributes-as-vector", Fface_attributes_as_vector
,
5825 Sface_attributes_as_vector
, 1, 1, 0,
5826 doc
: /* Return a vector of face attributes corresponding to PLIST. */)
5831 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
5833 merge_face_ref (XFRAME (selected_frame
), plist
, XVECTOR (lface
)->contents
,
5840 /***********************************************************************
5841 Face capability testing
5842 ***********************************************************************/
5845 /* If the distance (as returned by color_distance) between two colors is
5846 less than this, then they are considered the same, for determining
5847 whether a color is supported or not. The range of values is 0-65535. */
5849 #define TTY_SAME_COLOR_THRESHOLD 10000
5851 #ifdef HAVE_WINDOW_SYSTEM
5853 /* Return non-zero if all the face attributes in ATTRS are supported
5854 on the window-system frame F.
5856 The definition of `supported' is somewhat heuristic, but basically means
5857 that a face containing all the attributes in ATTRS, when merged with the
5858 default face for display, can be represented in a way that's
5860 \(1) different in appearance than the default face, and
5861 \(2) `close in spirit' to what the attributes specify, if not exact. */
5864 x_supports_face_attributes_p (f
, attrs
, def_face
)
5867 struct face
*def_face
;
5869 Lisp_Object
*def_attrs
= def_face
->lface
;
5871 /* Check that other specified attributes are different that the default
5873 if ((!UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
5874 && face_attr_equal_p (attrs
[LFACE_UNDERLINE_INDEX
],
5875 def_attrs
[LFACE_UNDERLINE_INDEX
]))
5876 || (!UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
5877 && face_attr_equal_p (attrs
[LFACE_INVERSE_INDEX
],
5878 def_attrs
[LFACE_INVERSE_INDEX
]))
5879 || (!UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
5880 && face_attr_equal_p (attrs
[LFACE_FOREGROUND_INDEX
],
5881 def_attrs
[LFACE_FOREGROUND_INDEX
]))
5882 || (!UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
5883 && face_attr_equal_p (attrs
[LFACE_BACKGROUND_INDEX
],
5884 def_attrs
[LFACE_BACKGROUND_INDEX
]))
5885 || (!UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
5886 && face_attr_equal_p (attrs
[LFACE_STIPPLE_INDEX
],
5887 def_attrs
[LFACE_STIPPLE_INDEX
]))
5888 || (!UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
5889 && face_attr_equal_p (attrs
[LFACE_OVERLINE_INDEX
],
5890 def_attrs
[LFACE_OVERLINE_INDEX
]))
5891 || (!UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
5892 && face_attr_equal_p (attrs
[LFACE_STRIKE_THROUGH_INDEX
],
5893 def_attrs
[LFACE_STRIKE_THROUGH_INDEX
]))
5894 || (!UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
5895 && face_attr_equal_p (attrs
[LFACE_BOX_INDEX
],
5896 def_attrs
[LFACE_BOX_INDEX
])))
5899 /* Check font-related attributes, as those are the most commonly
5900 "unsupported" on a window-system (because of missing fonts). */
5901 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
5902 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
5903 || !UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
5904 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
5905 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
5906 || !UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
]))
5909 Lisp_Object merged_attrs
[LFACE_VECTOR_SIZE
];
5911 bcopy (def_attrs
, merged_attrs
, sizeof merged_attrs
);
5913 merge_face_vectors (f
, attrs
, merged_attrs
, 0);
5915 face
= FACE_FROM_ID (f
, lookup_face (f
, merged_attrs
, 0, 0));
5918 error ("Cannot make face");
5920 /* If the font is the same, then not supported. */
5921 if (face
->font
== def_face
->font
)
5925 /* Everything checks out, this face is supported. */
5929 #endif /* HAVE_WINDOW_SYSTEM */
5931 /* Return non-zero if all the face attributes in ATTRS are supported
5934 The definition of `supported' is somewhat heuristic, but basically means
5935 that a face containing all the attributes in ATTRS, when merged
5936 with the default face for display, can be represented in a way that's
5938 \(1) different in appearance than the default face, and
5939 \(2) `close in spirit' to what the attributes specify, if not exact.
5941 Point (2) implies that a `:weight black' attribute will be satisfied
5942 by any terminal that can display bold, and a `:foreground "yellow"' as
5943 long as the terminal can display a yellowish color, but `:slant italic'
5944 will _not_ be satisfied by the tty display code's automatic
5945 substitution of a `dim' face for italic. */
5948 tty_supports_face_attributes_p (f
, attrs
, def_face
)
5951 struct face
*def_face
;
5954 Lisp_Object val
, fg
, bg
;
5955 XColor fg_tty_color
, fg_std_color
;
5956 XColor bg_tty_color
, bg_std_color
;
5957 unsigned test_caps
= 0;
5958 Lisp_Object
*def_attrs
= def_face
->lface
;
5961 /* First check some easy-to-check stuff; ttys support none of the
5962 following attributes, so we can just return false if any are requested
5963 (even if `nominal' values are specified, we should still return false,
5964 as that will be the same value that the default face uses). We
5965 consider :slant unsupportable on ttys, even though the face code
5966 actually `fakes' them using a dim attribute if possible. This is
5967 because the faked result is too different from what the face
5969 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
5970 || !UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
5971 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
5972 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
5973 || !UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
5974 || !UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
5975 || !UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
5976 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
]))
5980 /* Test for terminal `capabilities' (non-color character attributes). */
5982 /* font weight (bold/dim) */
5983 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
5986 int def_weight
= face_numeric_weight (def_attrs
[LFACE_WEIGHT_INDEX
]);
5988 if (weight
> XLFD_WEIGHT_MEDIUM
)
5990 if (def_weight
> XLFD_WEIGHT_MEDIUM
)
5991 return 0; /* same as default */
5992 test_caps
= TTY_CAP_BOLD
;
5994 else if (weight
< XLFD_WEIGHT_MEDIUM
)
5996 if (def_weight
< XLFD_WEIGHT_MEDIUM
)
5997 return 0; /* same as default */
5998 test_caps
= TTY_CAP_DIM
;
6000 else if (def_weight
== XLFD_WEIGHT_MEDIUM
)
6001 return 0; /* same as default */
6005 val
= attrs
[LFACE_UNDERLINE_INDEX
];
6006 if (!UNSPECIFIEDP (val
))
6009 return 0; /* ttys can't use colored underlines */
6010 else if (face_attr_equal_p (val
, def_attrs
[LFACE_UNDERLINE_INDEX
]))
6011 return 0; /* same as default */
6013 test_caps
|= TTY_CAP_UNDERLINE
;
6017 val
= attrs
[LFACE_INVERSE_INDEX
];
6018 if (!UNSPECIFIEDP (val
))
6020 if (face_attr_equal_p (val
, def_attrs
[LFACE_UNDERLINE_INDEX
]))
6021 return 0; /* same as default */
6023 test_caps
|= TTY_CAP_INVERSE
;
6027 /* Color testing. */
6029 /* Default the color indices in FG_TTY_COLOR and BG_TTY_COLOR, since
6030 we use them when calling `tty_capable_p' below, even if the face
6031 specifies no colors. */
6032 fg_tty_color
.pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
6033 bg_tty_color
.pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
6035 /* Check if foreground color is close enough. */
6036 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
6039 Lisp_Object def_fg
= def_attrs
[LFACE_FOREGROUND_INDEX
];
6041 if (face_attr_equal_p (fg
, def_fg
))
6042 return 0; /* same as default */
6043 else if (! tty_lookup_color (f
, fg
, &fg_tty_color
, &fg_std_color
))
6044 return 0; /* not a valid color */
6045 else if (color_distance (&fg_tty_color
, &fg_std_color
)
6046 > TTY_SAME_COLOR_THRESHOLD
)
6047 return 0; /* displayed color is too different */
6049 /* Make sure the color is really different than the default. */
6051 XColor def_fg_color
;
6052 if (tty_lookup_color (f
, def_fg
, &def_fg_color
, 0)
6053 && (color_distance (&fg_tty_color
, &def_fg_color
)
6054 <= TTY_SAME_COLOR_THRESHOLD
))
6059 /* Check if background color is close enough. */
6060 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
6063 Lisp_Object def_bg
= def_attrs
[LFACE_FOREGROUND_INDEX
];
6065 if (face_attr_equal_p (bg
, def_bg
))
6066 return 0; /* same as default */
6067 else if (! tty_lookup_color (f
, bg
, &bg_tty_color
, &bg_std_color
))
6068 return 0; /* not a valid color */
6069 else if (color_distance (&bg_tty_color
, &bg_std_color
)
6070 > TTY_SAME_COLOR_THRESHOLD
)
6071 return 0; /* displayed color is too different */
6073 /* Make sure the color is really different than the default. */
6075 XColor def_bg_color
;
6076 if (tty_lookup_color (f
, def_bg
, &def_bg_color
, 0)
6077 && (color_distance (&bg_tty_color
, &def_bg_color
)
6078 <= TTY_SAME_COLOR_THRESHOLD
))
6083 /* If both foreground and background are requested, see if the
6084 distance between them is OK. We just check to see if the distance
6085 between the tty's foreground and background is close enough to the
6086 distance between the standard foreground and background. */
6087 if (STRINGP (fg
) && STRINGP (bg
))
6090 = (color_distance (&fg_std_color
, &bg_std_color
)
6091 - color_distance (&fg_tty_color
, &bg_tty_color
));
6092 if (delta_delta
> TTY_SAME_COLOR_THRESHOLD
6093 || delta_delta
< -TTY_SAME_COLOR_THRESHOLD
)
6098 /* See if the capabilities we selected above are supported, with the
6100 if (test_caps
!= 0 &&
6101 ! tty_capable_p (f
, test_caps
, fg_tty_color
.pixel
, bg_tty_color
.pixel
))
6105 /* Hmmm, everything checks out, this terminal must support this face. */
6110 DEFUN ("display-supports-face-attributes-p",
6111 Fdisplay_supports_face_attributes_p
, Sdisplay_supports_face_attributes_p
,
6113 doc
: /* Return non-nil if all the face attributes in ATTRIBUTES are supported.
6114 The optional argument DISPLAY can be a display name, a frame, or
6115 nil (meaning the selected frame's display).
6117 The definition of `supported' is somewhat heuristic, but basically means
6118 that a face containing all the attributes in ATTRIBUTES, when merged
6119 with the default face for display, can be represented in a way that's
6121 \(1) different in appearance than the default face, and
6122 \(2) `close in spirit' to what the attributes specify, if not exact.
6124 Point (2) implies that a `:weight black' attribute will be satisfied by
6125 any display that can display bold, and a `:foreground \"yellow\"' as long
6126 as it can display a yellowish color, but `:slant italic' will _not_ be
6127 satisfied by the tty display code's automatic substitution of a `dim'
6128 face for italic. */)
6129 (attributes
, display
)
6130 Lisp_Object attributes
, display
;
6135 struct face
*def_face
;
6136 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6138 if (noninteractive
|| !initialized
)
6139 /* We may not be able to access low-level face information in batch
6140 mode, or before being dumped, and this function is not going to
6141 be very useful in those cases anyway, so just give up. */
6145 frame
= selected_frame
;
6146 else if (FRAMEP (display
))
6150 /* Find any frame on DISPLAY. */
6151 Lisp_Object fl_tail
;
6154 for (fl_tail
= Vframe_list
; CONSP (fl_tail
); fl_tail
= XCDR (fl_tail
))
6156 frame
= XCAR (fl_tail
);
6157 if (!NILP (Fequal (Fcdr (Fassq (Qdisplay
,
6158 XFRAME (frame
)->param_alist
)),
6164 CHECK_LIVE_FRAME (frame
);
6167 for (i
= 0; i
< LFACE_VECTOR_SIZE
; i
++)
6168 attrs
[i
] = Qunspecified
;
6169 merge_face_ref (f
, attributes
, attrs
, 1, 0);
6171 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6172 if (def_face
== NULL
)
6174 if (! realize_basic_faces (f
))
6175 error ("Cannot realize default face");
6176 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6179 /* Dispatch to the appropriate handler. */
6180 if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
6181 supports
= tty_supports_face_attributes_p (f
, attrs
, def_face
);
6182 #ifdef HAVE_WINDOW_SYSTEM
6184 supports
= x_supports_face_attributes_p (f
, attrs
, def_face
);
6187 return supports
? Qt
: Qnil
;
6191 /***********************************************************************
6193 ***********************************************************************/
6195 DEFUN ("internal-set-font-selection-order",
6196 Finternal_set_font_selection_order
,
6197 Sinternal_set_font_selection_order
, 1, 1, 0,
6198 doc
: /* Set font selection order for face font selection to ORDER.
6199 ORDER must be a list of length 4 containing the symbols `:width',
6200 `:height', `:weight', and `:slant'. Face attributes appearing
6201 first in ORDER are matched first, e.g. if `:height' appears before
6202 `:weight' in ORDER, font selection first tries to find a font with
6203 a suitable height, and then tries to match the font weight.
6210 int indices
[DIM (font_sort_order
)];
6213 bzero (indices
, sizeof indices
);
6217 CONSP (list
) && i
< DIM (indices
);
6218 list
= XCDR (list
), ++i
)
6220 Lisp_Object attr
= XCAR (list
);
6223 if (EQ (attr
, QCwidth
))
6225 else if (EQ (attr
, QCheight
))
6226 xlfd
= XLFD_POINT_SIZE
;
6227 else if (EQ (attr
, QCweight
))
6229 else if (EQ (attr
, QCslant
))
6234 if (indices
[i
] != 0)
6239 if (!NILP (list
) || i
!= DIM (indices
))
6240 signal_error ("Invalid font sort order", order
);
6241 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6242 if (indices
[i
] == 0)
6243 signal_error ("Invalid font sort order", order
);
6245 if (bcmp (indices
, font_sort_order
, sizeof indices
) != 0)
6247 bcopy (indices
, font_sort_order
, sizeof font_sort_order
);
6248 free_all_realized_faces (Qnil
);
6255 DEFUN ("internal-set-alternative-font-family-alist",
6256 Finternal_set_alternative_font_family_alist
,
6257 Sinternal_set_alternative_font_family_alist
, 1, 1, 0,
6258 doc
: /* Define alternative font families to try in face font selection.
6259 ALIST is an alist of (FAMILY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6260 Each ALTERNATIVE is tried in order if no fonts of font family FAMILY can
6261 be found. Value is ALIST. */)
6266 Vface_alternative_font_family_alist
= alist
;
6267 free_all_realized_faces (Qnil
);
6272 DEFUN ("internal-set-alternative-font-registry-alist",
6273 Finternal_set_alternative_font_registry_alist
,
6274 Sinternal_set_alternative_font_registry_alist
, 1, 1, 0,
6275 doc
: /* Define alternative font registries to try in face font selection.
6276 ALIST is an alist of (REGISTRY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6277 Each ALTERNATIVE is tried in order if no fonts of font registry REGISTRY can
6278 be found. Value is ALIST. */)
6283 Vface_alternative_font_registry_alist
= alist
;
6284 free_all_realized_faces (Qnil
);
6289 #ifdef HAVE_WINDOW_SYSTEM
6291 /* Value is non-zero if FONT is the name of a scalable font. The
6292 X11R6 XLFD spec says that point size, pixel size, and average width
6293 are zero for scalable fonts. Intlfonts contain at least one
6294 scalable font ("*-muleindian-1") for which this isn't true, so we
6295 just test average width. */
6298 font_scalable_p (font
)
6299 struct font_name
*font
;
6301 char *s
= font
->fields
[XLFD_AVGWIDTH
];
6302 return (*s
== '0' && *(s
+ 1) == '\0')
6304 /* Windows implementation of XLFD is slightly broken for backward
6305 compatibility with previous broken versions, so test for
6306 wildcards as well as 0. */
6313 /* Ignore the difference of font point size less than this value. */
6315 #define FONT_POINT_SIZE_QUANTUM 5
6317 /* Value is non-zero if FONT1 is a better match for font attributes
6318 VALUES than FONT2. VALUES is an array of face attribute values in
6319 font sort order. COMPARE_PT_P zero means don't compare point
6320 sizes. AVGWIDTH, if not zero, is a specified font average width
6324 better_font_p (values
, font1
, font2
, compare_pt_p
, avgwidth
)
6326 struct font_name
*font1
, *font2
;
6327 int compare_pt_p
, avgwidth
;
6331 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6333 int xlfd_idx
= font_sort_order
[i
];
6335 if (compare_pt_p
|| xlfd_idx
!= XLFD_POINT_SIZE
)
6339 if (xlfd_idx
== XLFD_POINT_SIZE
)
6341 delta1
= abs (values
[i
] - (font1
->numeric
[xlfd_idx
]
6342 / font1
->rescale_ratio
));
6343 delta2
= abs (values
[i
] - (font2
->numeric
[xlfd_idx
]
6344 / font2
->rescale_ratio
));
6345 if (abs (delta1
- delta2
) < FONT_POINT_SIZE_QUANTUM
)
6350 delta1
= abs (values
[i
] - font1
->numeric
[xlfd_idx
]);
6351 delta2
= abs (values
[i
] - font2
->numeric
[xlfd_idx
]);
6354 if (delta1
> delta2
)
6356 else if (delta1
< delta2
)
6360 /* The difference may be equal because, e.g., the face
6361 specifies `italic' but we have only `regular' and
6362 `oblique'. Prefer `oblique' in this case. */
6363 if ((xlfd_idx
== XLFD_WEIGHT
|| xlfd_idx
== XLFD_SLANT
)
6364 && font1
->numeric
[xlfd_idx
] > values
[i
]
6365 && font2
->numeric
[xlfd_idx
] < values
[i
])
6373 int delta1
= abs (avgwidth
- font1
->numeric
[XLFD_AVGWIDTH
]);
6374 int delta2
= abs (avgwidth
- font2
->numeric
[XLFD_AVGWIDTH
]);
6375 if (delta1
> delta2
)
6377 else if (delta1
< delta2
)
6383 /* We prefer a real scalable font; i.e. not what autoscaled. */
6384 int auto_scaled_1
= (font1
->numeric
[XLFD_POINT_SIZE
] == 0
6385 && font1
->numeric
[XLFD_RESY
] > 0);
6386 int auto_scaled_2
= (font2
->numeric
[XLFD_POINT_SIZE
] == 0
6387 && font2
->numeric
[XLFD_RESY
] > 0);
6389 if (auto_scaled_1
!= auto_scaled_2
)
6390 return auto_scaled_2
;
6393 return font1
->registry_priority
< font2
->registry_priority
;
6397 /* Value is non-zero if FONT is an exact match for face attributes in
6398 SPECIFIED. SPECIFIED is an array of face attribute values in font
6399 sort order. AVGWIDTH, if non-zero, is an average width to compare
6403 exact_face_match_p (specified
, font
, avgwidth
)
6405 struct font_name
*font
;
6410 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6411 if (specified
[i
] != font
->numeric
[font_sort_order
[i
]])
6414 return (i
== DIM (font_sort_order
)
6416 || avgwidth
== font
->numeric
[XLFD_AVGWIDTH
]));
6420 /* Value is the name of a scaled font, generated from scalable font
6421 FONT on frame F. SPECIFIED_PT is the point-size to scale FONT to.
6422 Value is allocated from heap. */
6425 build_scalable_font_name (f
, font
, specified_pt
)
6427 struct font_name
*font
;
6430 char pixel_size
[20];
6432 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
6435 /* If scalable font is for a specific resolution, compute
6436 the point size we must specify from the resolution of
6437 the display and the specified resolution of the font. */
6438 if (font
->numeric
[XLFD_RESY
] != 0)
6440 pt
= resy
/ font
->numeric
[XLFD_RESY
] * specified_pt
+ 0.5;
6441 pixel_value
= font
->numeric
[XLFD_RESY
] / (PT_PER_INCH
* 10.0) * pt
+ 0.5;
6446 pixel_value
= resy
/ (PT_PER_INCH
* 10.0) * pt
+ 0.5;
6448 /* We may need a font of the different size. */
6449 pixel_value
*= font
->rescale_ratio
;
6451 /* We should keep POINT_SIZE 0. Otherwise, X server can't open a
6452 font of the specified PIXEL_SIZE. */
6454 { /* Set point size of the font. */
6455 char point_size
[20];
6456 sprintf (point_size
, "%d", (int) pt
);
6457 font
->fields
[XLFD_POINT_SIZE
] = point_size
;
6458 font
->numeric
[XLFD_POINT_SIZE
] = pt
;
6462 /* Set pixel size. */
6463 sprintf (pixel_size
, "%d", pixel_value
);
6464 font
->fields
[XLFD_PIXEL_SIZE
] = pixel_size
;
6465 font
->numeric
[XLFD_PIXEL_SIZE
] = pixel_value
;
6467 /* If font doesn't specify its resolution, use the
6468 resolution of the display. */
6469 if (font
->numeric
[XLFD_RESY
] == 0)
6472 sprintf (buffer
, "%d", (int) resy
);
6473 font
->fields
[XLFD_RESY
] = buffer
;
6474 font
->numeric
[XLFD_RESY
] = resy
;
6477 if (strcmp (font
->fields
[XLFD_RESX
], "0") == 0)
6480 int resx
= FRAME_X_DISPLAY_INFO (f
)->resx
;
6481 sprintf (buffer
, "%d", resx
);
6482 font
->fields
[XLFD_RESX
] = buffer
;
6483 font
->numeric
[XLFD_RESX
] = resx
;
6486 return build_font_name (font
);
6490 /* Value is non-zero if we are allowed to use scalable font FONT. We
6491 can't run a Lisp function here since this function may be called
6492 with input blocked. */
6495 may_use_scalable_font_p (font
)
6498 if (EQ (Vscalable_fonts_allowed
, Qt
))
6500 else if (CONSP (Vscalable_fonts_allowed
))
6502 Lisp_Object tail
, regexp
;
6504 for (tail
= Vscalable_fonts_allowed
; CONSP (tail
); tail
= XCDR (tail
))
6506 regexp
= XCAR (tail
);
6507 if (STRINGP (regexp
)
6508 && fast_c_string_match_ignore_case (regexp
, font
) >= 0)
6518 /* Return the name of the best matching font for face attributes ATTRS
6519 in the array of font_name structures FONTS which contains NFONTS
6520 elements. WIDTH_RATIO is a factor with which to multiply average
6521 widths if ATTRS specifies such a width.
6523 Value is a font name which is allocated from the heap. FONTS is
6524 freed by this function.
6526 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
6527 indicate whether the resulting font should be drawn using overstrike
6528 to simulate bold-face. */
6531 best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
, needs_overstrike
)
6534 struct font_name
*fonts
;
6537 int *needs_overstrike
;
6540 struct font_name
*best
;
6543 int exact_p
, avgwidth
;
6548 /* Make specified font attributes available in `specified',
6549 indexed by sort order. */
6550 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6552 int xlfd_idx
= font_sort_order
[i
];
6554 if (xlfd_idx
== XLFD_SWIDTH
)
6555 specified
[i
] = face_numeric_swidth (attrs
[LFACE_SWIDTH_INDEX
]);
6556 else if (xlfd_idx
== XLFD_POINT_SIZE
)
6557 specified
[i
] = pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
6558 else if (xlfd_idx
== XLFD_WEIGHT
)
6559 specified
[i
] = face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
6560 else if (xlfd_idx
== XLFD_SLANT
)
6561 specified
[i
] = face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
6566 avgwidth
= (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
6568 : XFASTINT (attrs
[LFACE_AVGWIDTH_INDEX
]) * width_ratio
);
6572 if (needs_overstrike
)
6573 *needs_overstrike
= 0;
6575 /* Start with the first non-scalable font in the list. */
6576 for (i
= 0; i
< nfonts
; ++i
)
6577 if (!font_scalable_p (fonts
+ i
))
6580 /* Find the best match among the non-scalable fonts. */
6585 for (i
= 1; i
< nfonts
; ++i
)
6586 if (!font_scalable_p (fonts
+ i
)
6587 && better_font_p (specified
, fonts
+ i
, best
, 1, avgwidth
))
6591 exact_p
= exact_face_match_p (specified
, best
, avgwidth
);
6599 /* Unless we found an exact match among non-scalable fonts, see if
6600 we can find a better match among scalable fonts. */
6603 /* A scalable font is better if
6605 1. its weight, slant, swidth attributes are better, or.
6607 2. the best non-scalable font doesn't have the required
6608 point size, and the scalable fonts weight, slant, swidth
6611 int non_scalable_has_exact_height_p
;
6613 if (best
&& best
->numeric
[XLFD_POINT_SIZE
] == pt
)
6614 non_scalable_has_exact_height_p
= 1;
6616 non_scalable_has_exact_height_p
= 0;
6618 for (i
= 0; i
< nfonts
; ++i
)
6619 if (font_scalable_p (fonts
+ i
))
6622 || better_font_p (specified
, fonts
+ i
, best
, 0, 0)
6623 || (!non_scalable_has_exact_height_p
6624 && !better_font_p (specified
, best
, fonts
+ i
, 0, 0)))
6626 non_scalable_has_exact_height_p
= 1;
6631 if (needs_overstrike
)
6633 enum xlfd_weight want_weight
= specified
[XLFD_WEIGHT
];
6634 enum xlfd_weight got_weight
= best
->numeric
[XLFD_WEIGHT
];
6636 if (want_weight
> XLFD_WEIGHT_MEDIUM
&& want_weight
> got_weight
)
6638 /* We want a bold font, but didn't get one; try to use
6639 overstriking instead to simulate bold-face. However,
6640 don't overstrike an already-bold fontn unless the
6641 desired weight grossly exceeds the available weight. */
6642 if (got_weight
> XLFD_WEIGHT_MEDIUM
)
6643 *needs_overstrike
= (got_weight
- want_weight
) > 2;
6645 *needs_overstrike
= 1;
6650 if (font_scalable_p (best
))
6651 font_name
= build_scalable_font_name (f
, best
, pt
);
6653 font_name
= build_font_name (best
);
6655 /* Free font_name structures. */
6656 free_font_names (fonts
, nfonts
);
6662 /* Get a list of matching fonts on frame F, considering FAMILY
6663 and alternative font families from Vface_alternative_font_registry_alist.
6665 FAMILY is the font family whose alternatives are considered.
6667 REGISTRY, if a string, specifies a font registry and encoding to
6668 match. A value of nil means include fonts of any registry and
6671 Return in *FONTS a pointer to a vector of font_name structures for
6672 the fonts matched. Value is the number of fonts found. */
6675 try_alternative_families (f
, family
, registry
, fonts
)
6677 Lisp_Object family
, registry
;
6678 struct font_name
**fonts
;
6683 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
6686 /* Try alternative font families. */
6687 alter
= Fassoc (family
, Vface_alternative_font_family_alist
);
6690 for (alter
= XCDR (alter
);
6691 CONSP (alter
) && nfonts
== 0;
6692 alter
= XCDR (alter
))
6694 if (STRINGP (XCAR (alter
)))
6695 nfonts
= font_list (f
, Qnil
, XCAR (alter
), registry
, fonts
);
6699 /* Try all scalable fonts before giving up. */
6700 if (nfonts
== 0 && ! EQ (Vscalable_fonts_allowed
, Qt
))
6702 int count
= SPECPDL_INDEX ();
6703 specbind (Qscalable_fonts_allowed
, Qt
);
6704 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6705 unbind_to (count
, Qnil
);
6712 /* Get a list of matching fonts on frame F.
6714 FAMILY, if a string, specifies a font family derived from the fontset.
6715 It is only used if the face does not specify any family in ATTRS or
6716 if we cannot find any font of the face's family.
6718 REGISTRY, if a string, specifies a font registry and encoding to
6719 match. A value of nil means include fonts of any registry and
6722 If PREFER_FACE_FAMILY is nonzero, perfer face's family to FAMILY.
6723 Otherwise, prefer FAMILY.
6725 Return in *FONTS a pointer to a vector of font_name structures for
6726 the fonts matched. Value is the number of fonts found. */
6729 try_font_list (f
, attrs
, family
, registry
, fonts
, prefer_face_family
)
6732 Lisp_Object family
, registry
;
6733 struct font_name
**fonts
;
6734 int prefer_face_family
;
6737 Lisp_Object face_family
= attrs
[LFACE_FAMILY_INDEX
];
6738 Lisp_Object try_family
;
6740 try_family
= (prefer_face_family
|| NILP (family
)) ? face_family
: family
;
6742 if (STRINGP (try_family
))
6743 nfonts
= try_alternative_families (f
, try_family
, registry
, fonts
);
6746 if (nfonts
== 0 && STRINGP (try_family
) && STRINGP (registry
))
6747 if (xstricmp (SDATA (registry
), "mac-roman") == 0)
6748 /* When realizing the default face and a font spec does not
6749 matched exactly, Emacs looks for ones with the same registry
6750 as the default font. On the Mac, this is mac-roman, which
6751 does not work if the family is -etl-fixed, e.g. The
6752 following widens the choices and fixes that problem. */
6753 nfonts
= try_alternative_families (f
, try_family
, Qnil
, fonts
);
6754 else if (SBYTES (try_family
) > 0
6755 && SREF (try_family
, SBYTES (try_family
) - 1) != '*')
6756 /* Some Central European/Cyrillic font family names have the
6757 Roman counterpart name as their prefix. */
6758 nfonts
= try_alternative_families (f
, concat2 (try_family
,
6759 build_string ("*")),
6763 if (EQ (try_family
, family
))
6764 family
= face_family
;
6766 if (nfonts
== 0 && STRINGP (family
))
6767 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6769 /* Try font family of the default face or "fixed". */
6772 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6774 family
= default_face
->lface
[LFACE_FAMILY_INDEX
];
6776 family
= build_string ("fixed");
6777 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
6780 /* Try any family with the given registry. */
6782 nfonts
= try_alternative_families (f
, Qnil
, registry
, fonts
);
6788 /* Return the fontset id of the base fontset name or alias name given
6789 by the fontset attribute of ATTRS. Value is -1 if the fontset
6790 attribute of ATTRS doesn't name a fontset. */
6793 face_fontset (attrs
)
6798 name
= attrs
[LFACE_FONT_INDEX
];
6799 if (!STRINGP (name
))
6801 return fs_query_fontset (name
, 0);
6805 /* Choose a name of font to use on frame F to display character C with
6806 Lisp face attributes specified by ATTRS. The font name is
6807 determined by the font-related attributes in ATTRS and the name
6808 pattern for C in FONTSET. Value is the font name which is
6809 allocated from the heap and must be freed by the caller, or NULL if
6810 we can get no information about the font name of C. It is assured
6811 that we always get some information for a single byte
6814 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
6815 indicate whether the resulting font should be drawn using overstrike
6816 to simulate bold-face. */
6819 choose_face_font (f
, attrs
, fontset
, c
, needs_overstrike
)
6823 int *needs_overstrike
;
6825 Lisp_Object pattern
;
6826 char *font_name
= NULL
;
6827 struct font_name
*fonts
;
6828 int nfonts
, width_ratio
;
6830 if (needs_overstrike
)
6831 *needs_overstrike
= 0;
6833 /* Get (foundry and) family name and registry (and encoding) name of
6835 pattern
= fontset_font_pattern (f
, fontset
, c
);
6838 xassert (!SINGLE_BYTE_CHAR_P (c
));
6842 /* If what we got is a name pattern, return it. */
6843 if (STRINGP (pattern
))
6844 return xstrdup (SDATA (pattern
));
6846 /* Get a list of fonts matching that pattern and choose the
6847 best match for the specified face attributes from it. */
6848 nfonts
= try_font_list (f
, attrs
, XCAR (pattern
), XCDR (pattern
), &fonts
,
6849 (SINGLE_BYTE_CHAR_P (c
)
6850 || CHAR_CHARSET (c
) == charset_latin_iso8859_1
));
6851 width_ratio
= (SINGLE_BYTE_CHAR_P (c
)
6853 : CHARSET_WIDTH (CHAR_CHARSET (c
)));
6854 font_name
= best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
,
6859 #endif /* HAVE_WINDOW_SYSTEM */
6863 /***********************************************************************
6865 ***********************************************************************/
6867 /* Realize basic faces on frame F. Value is zero if frame parameters
6868 of F don't contain enough information needed to realize the default
6872 realize_basic_faces (f
)
6876 int count
= SPECPDL_INDEX ();
6878 /* Block input here so that we won't be surprised by an X expose
6879 event, for instance, without having the faces set up. */
6881 specbind (Qscalable_fonts_allowed
, Qt
);
6883 if (realize_default_face (f
))
6885 realize_named_face (f
, Qmode_line
, MODE_LINE_FACE_ID
);
6886 realize_named_face (f
, Qmode_line_inactive
, MODE_LINE_INACTIVE_FACE_ID
);
6887 realize_named_face (f
, Qtool_bar
, TOOL_BAR_FACE_ID
);
6888 realize_named_face (f
, Qfringe
, FRINGE_FACE_ID
);
6889 realize_named_face (f
, Qheader_line
, HEADER_LINE_FACE_ID
);
6890 realize_named_face (f
, Qscroll_bar
, SCROLL_BAR_FACE_ID
);
6891 realize_named_face (f
, Qborder
, BORDER_FACE_ID
);
6892 realize_named_face (f
, Qcursor
, CURSOR_FACE_ID
);
6893 realize_named_face (f
, Qmouse
, MOUSE_FACE_ID
);
6894 realize_named_face (f
, Qmenu
, MENU_FACE_ID
);
6895 realize_named_face (f
, Qvertical_border
, VERTICAL_BORDER_FACE_ID
);
6897 /* Reflect changes in the `menu' face in menu bars. */
6898 if (FRAME_FACE_CACHE (f
)->menu_face_changed_p
)
6900 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 0;
6901 #ifdef USE_X_TOOLKIT
6902 x_update_menu_appearance (f
);
6909 unbind_to (count
, Qnil
);
6915 /* Realize the default face on frame F. If the face is not fully
6916 specified, make it fully-specified. Attributes of the default face
6917 that are not explicitly specified are taken from frame parameters. */
6920 realize_default_face (f
)
6923 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
6925 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6926 Lisp_Object frame_font
;
6929 /* If the `default' face is not yet known, create it. */
6930 lface
= lface_from_face_name (f
, Qdefault
, 0);
6934 XSETFRAME (frame
, f
);
6935 lface
= Finternal_make_lisp_face (Qdefault
, frame
);
6939 #ifdef HAVE_WINDOW_SYSTEM
6940 if (FRAME_WINDOW_P (f
))
6942 /* Set frame_font to the value of the `font' frame parameter. */
6943 frame_font
= Fassq (Qfont
, f
->param_alist
);
6944 xassert (CONSP (frame_font
) && STRINGP (XCDR (frame_font
)));
6945 frame_font
= XCDR (frame_font
);
6946 set_lface_from_font_name (f
, lface
, frame_font
,
6947 f
->default_face_done_p
, 1);
6948 f
->default_face_done_p
= 1;
6950 #endif /* HAVE_WINDOW_SYSTEM */
6952 if (!FRAME_WINDOW_P (f
))
6954 LFACE_FAMILY (lface
) = build_string ("default");
6955 LFACE_SWIDTH (lface
) = Qnormal
;
6956 LFACE_HEIGHT (lface
) = make_number (1);
6957 if (UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
6958 LFACE_WEIGHT (lface
) = Qnormal
;
6959 if (UNSPECIFIEDP (LFACE_SLANT (lface
)))
6960 LFACE_SLANT (lface
) = Qnormal
;
6961 LFACE_AVGWIDTH (lface
) = Qunspecified
;
6964 if (UNSPECIFIEDP (LFACE_UNDERLINE (lface
)))
6965 LFACE_UNDERLINE (lface
) = Qnil
;
6967 if (UNSPECIFIEDP (LFACE_OVERLINE (lface
)))
6968 LFACE_OVERLINE (lface
) = Qnil
;
6970 if (UNSPECIFIEDP (LFACE_STRIKE_THROUGH (lface
)))
6971 LFACE_STRIKE_THROUGH (lface
) = Qnil
;
6973 if (UNSPECIFIEDP (LFACE_BOX (lface
)))
6974 LFACE_BOX (lface
) = Qnil
;
6976 if (UNSPECIFIEDP (LFACE_INVERSE (lface
)))
6977 LFACE_INVERSE (lface
) = Qnil
;
6979 if (UNSPECIFIEDP (LFACE_FOREGROUND (lface
)))
6981 /* This function is called so early that colors are not yet
6982 set in the frame parameter list. */
6983 Lisp_Object color
= Fassq (Qforeground_color
, f
->param_alist
);
6985 if (CONSP (color
) && STRINGP (XCDR (color
)))
6986 LFACE_FOREGROUND (lface
) = XCDR (color
);
6987 else if (FRAME_WINDOW_P (f
))
6989 else if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
6990 LFACE_FOREGROUND (lface
) = build_string (unspecified_fg
);
6995 if (UNSPECIFIEDP (LFACE_BACKGROUND (lface
)))
6997 /* This function is called so early that colors are not yet
6998 set in the frame parameter list. */
6999 Lisp_Object color
= Fassq (Qbackground_color
, f
->param_alist
);
7000 if (CONSP (color
) && STRINGP (XCDR (color
)))
7001 LFACE_BACKGROUND (lface
) = XCDR (color
);
7002 else if (FRAME_WINDOW_P (f
))
7004 else if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
7005 LFACE_BACKGROUND (lface
) = build_string (unspecified_bg
);
7010 if (UNSPECIFIEDP (LFACE_STIPPLE (lface
)))
7011 LFACE_STIPPLE (lface
) = Qnil
;
7013 /* Realize the face; it must be fully-specified now. */
7014 xassert (lface_fully_specified_p (XVECTOR (lface
)->contents
));
7015 check_lface (lface
);
7016 bcopy (XVECTOR (lface
)->contents
, attrs
, sizeof attrs
);
7017 face
= realize_face (c
, attrs
, 0, NULL
, DEFAULT_FACE_ID
);
7022 /* Realize basic faces other than the default face in face cache C.
7023 SYMBOL is the face name, ID is the face id the realized face must
7024 have. The default face must have been realized already. */
7027 realize_named_face (f
, symbol
, id
)
7032 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
7033 Lisp_Object lface
= lface_from_face_name (f
, symbol
, 0);
7034 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7035 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
7036 struct face
*new_face
;
7038 /* The default face must exist and be fully specified. */
7039 get_lface_attributes (f
, Qdefault
, attrs
, 1);
7040 check_lface_attrs (attrs
);
7041 xassert (lface_fully_specified_p (attrs
));
7043 /* If SYMBOL isn't know as a face, create it. */
7047 XSETFRAME (frame
, f
);
7048 lface
= Finternal_make_lisp_face (symbol
, frame
);
7051 /* Merge SYMBOL's face with the default face. */
7052 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
7053 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
7055 /* Realize the face. */
7056 new_face
= realize_face (c
, attrs
, 0, NULL
, id
);
7060 /* Realize the fully-specified face with attributes ATTRS in face
7061 cache CACHE for character C. If C is a multibyte character,
7062 BASE_FACE is a face that has the same attributes. Otherwise,
7063 BASE_FACE is ignored. If FORMER_FACE_ID is non-negative, it is an
7064 ID of face to remove before caching the new face. Value is a
7065 pointer to the newly created realized face. */
7067 static struct face
*
7068 realize_face (cache
, attrs
, c
, base_face
, former_face_id
)
7069 struct face_cache
*cache
;
7072 struct face
*base_face
;
7077 /* LFACE must be fully specified. */
7078 xassert (cache
!= NULL
);
7079 check_lface_attrs (attrs
);
7081 if (former_face_id
>= 0 && cache
->used
> former_face_id
)
7083 /* Remove the former face. */
7084 struct face
*former_face
= cache
->faces_by_id
[former_face_id
];
7085 uncache_face (cache
, former_face
);
7086 free_realized_face (cache
->f
, former_face
);
7089 if (FRAME_WINDOW_P (cache
->f
))
7090 face
= realize_x_face (cache
, attrs
, c
, base_face
);
7091 else if (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
))
7092 face
= realize_tty_face (cache
, attrs
, c
);
7096 /* Insert the new face. */
7097 cache_face (cache
, face
, lface_hash (attrs
));
7098 #ifdef HAVE_WINDOW_SYSTEM
7099 if (FRAME_WINDOW_P (cache
->f
) && face
->font
== NULL
)
7100 load_face_font (cache
->f
, face
, c
);
7101 #endif /* HAVE_WINDOW_SYSTEM */
7106 /* Realize the fully-specified face with attributes ATTRS in face
7107 cache CACHE for character C. Do it for X frame CACHE->f. If C is
7108 a multibyte character, BASE_FACE is a face that has the same
7109 attributes. Otherwise, BASE_FACE is ignored. If the new face
7110 doesn't share font with the default face, a fontname is allocated
7111 from the heap and set in `font_name' of the new face, but it is not
7112 yet loaded here. Value is a pointer to the newly created realized
7115 static struct face
*
7116 realize_x_face (cache
, attrs
, c
, base_face
)
7117 struct face_cache
*cache
;
7120 struct face
*base_face
;
7122 struct face
*face
= NULL
;
7123 #ifdef HAVE_WINDOW_SYSTEM
7124 struct face
*default_face
;
7126 Lisp_Object stipple
, overline
, strike_through
, box
;
7128 xassert (FRAME_WINDOW_P (cache
->f
));
7129 xassert (SINGLE_BYTE_CHAR_P (c
)
7132 /* Allocate a new realized face. */
7133 face
= make_realized_face (attrs
);
7137 /* If C is a multibyte character, we share all face attirbutes with
7138 BASE_FACE including the realized fontset. But, we must load a
7140 if (!SINGLE_BYTE_CHAR_P (c
))
7142 bcopy (base_face
, face
, sizeof *face
);
7145 /* Don't try to free the colors copied bitwise from BASE_FACE. */
7146 face
->colors_copied_bitwise_p
= 1;
7148 /* to force realize_face to load font */
7153 /* Now we are realizing a face for ASCII (and unibyte) characters. */
7155 /* Determine the font to use. Most of the time, the font will be
7156 the same as the font of the default face, so try that first. */
7157 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7159 && FACE_SUITABLE_FOR_CHAR_P (default_face
, c
)
7160 && lface_same_font_attributes_p (default_face
->lface
, attrs
))
7162 face
->font
= default_face
->font
;
7163 face
->fontset
= default_face
->fontset
;
7164 face
->font_info_id
= default_face
->font_info_id
;
7165 face
->font_name
= default_face
->font_name
;
7166 face
->ascii_face
= face
;
7168 /* But, as we can't share the fontset, make a new realized
7169 fontset that has the same base fontset as of the default
7172 = make_fontset_for_ascii_face (f
, default_face
->fontset
);
7176 /* If the face attribute ATTRS specifies a fontset, use it as
7177 the base of a new realized fontset. Otherwise, use the same
7178 base fontset as of the default face. The base determines
7179 registry and encoding of a font. It may also determine
7180 foundry and family. The other fields of font name pattern
7181 are constructed from ATTRS. */
7182 int fontset
= face_fontset (attrs
);
7184 if ((fontset
== -1) && default_face
)
7185 fontset
= default_face
->fontset
;
7186 face
->fontset
= make_fontset_for_ascii_face (f
, fontset
);
7187 face
->font
= NULL
; /* to force realize_face to load font */
7190 /* Load colors, and set remaining attributes. */
7192 load_face_colors (f
, face
, attrs
);
7195 box
= attrs
[LFACE_BOX_INDEX
];
7198 /* A simple box of line width 1 drawn in color given by
7200 face
->box_color
= load_color (f
, face
, attrs
[LFACE_BOX_INDEX
],
7202 face
->box
= FACE_SIMPLE_BOX
;
7203 face
->box_line_width
= 1;
7205 else if (INTEGERP (box
))
7207 /* Simple box of specified line width in foreground color of the
7209 xassert (XINT (box
) != 0);
7210 face
->box
= FACE_SIMPLE_BOX
;
7211 face
->box_line_width
= XINT (box
);
7212 face
->box_color
= face
->foreground
;
7213 face
->box_color_defaulted_p
= 1;
7215 else if (CONSP (box
))
7217 /* `(:width WIDTH :color COLOR :shadow SHADOW)'. SHADOW
7218 being one of `raised' or `sunken'. */
7219 face
->box
= FACE_SIMPLE_BOX
;
7220 face
->box_color
= face
->foreground
;
7221 face
->box_color_defaulted_p
= 1;
7222 face
->box_line_width
= 1;
7226 Lisp_Object keyword
, value
;
7228 keyword
= XCAR (box
);
7236 if (EQ (keyword
, QCline_width
))
7238 if (INTEGERP (value
) && XINT (value
) != 0)
7239 face
->box_line_width
= XINT (value
);
7241 else if (EQ (keyword
, QCcolor
))
7243 if (STRINGP (value
))
7245 face
->box_color
= load_color (f
, face
, value
,
7247 face
->use_box_color_for_shadows_p
= 1;
7250 else if (EQ (keyword
, QCstyle
))
7252 if (EQ (value
, Qreleased_button
))
7253 face
->box
= FACE_RAISED_BOX
;
7254 else if (EQ (value
, Qpressed_button
))
7255 face
->box
= FACE_SUNKEN_BOX
;
7260 /* Text underline, overline, strike-through. */
7262 if (EQ (attrs
[LFACE_UNDERLINE_INDEX
], Qt
))
7264 /* Use default color (same as foreground color). */
7265 face
->underline_p
= 1;
7266 face
->underline_defaulted_p
= 1;
7267 face
->underline_color
= 0;
7269 else if (STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]))
7271 /* Use specified color. */
7272 face
->underline_p
= 1;
7273 face
->underline_defaulted_p
= 0;
7274 face
->underline_color
7275 = load_color (f
, face
, attrs
[LFACE_UNDERLINE_INDEX
],
7276 LFACE_UNDERLINE_INDEX
);
7278 else if (NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7280 face
->underline_p
= 0;
7281 face
->underline_defaulted_p
= 0;
7282 face
->underline_color
= 0;
7285 overline
= attrs
[LFACE_OVERLINE_INDEX
];
7286 if (STRINGP (overline
))
7288 face
->overline_color
7289 = load_color (f
, face
, attrs
[LFACE_OVERLINE_INDEX
],
7290 LFACE_OVERLINE_INDEX
);
7291 face
->overline_p
= 1;
7293 else if (EQ (overline
, Qt
))
7295 face
->overline_color
= face
->foreground
;
7296 face
->overline_color_defaulted_p
= 1;
7297 face
->overline_p
= 1;
7300 strike_through
= attrs
[LFACE_STRIKE_THROUGH_INDEX
];
7301 if (STRINGP (strike_through
))
7303 face
->strike_through_color
7304 = load_color (f
, face
, attrs
[LFACE_STRIKE_THROUGH_INDEX
],
7305 LFACE_STRIKE_THROUGH_INDEX
);
7306 face
->strike_through_p
= 1;
7308 else if (EQ (strike_through
, Qt
))
7310 face
->strike_through_color
= face
->foreground
;
7311 face
->strike_through_color_defaulted_p
= 1;
7312 face
->strike_through_p
= 1;
7315 stipple
= attrs
[LFACE_STIPPLE_INDEX
];
7316 if (!NILP (stipple
))
7317 face
->stipple
= load_pixmap (f
, stipple
, &face
->pixmap_w
, &face
->pixmap_h
);
7319 xassert (FACE_SUITABLE_FOR_CHAR_P (face
, c
));
7320 #endif /* HAVE_WINDOW_SYSTEM */
7325 /* Map a specified color of face FACE on frame F to a tty color index.
7326 IDX is either LFACE_FOREGROUND_INDEX or LFACE_BACKGROUND_INDEX, and
7327 specifies which color to map. Set *DEFAULTED to 1 if mapping to the
7328 default foreground/background colors. */
7331 map_tty_color (f
, face
, idx
, defaulted
)
7334 enum lface_attribute_index idx
;
7337 Lisp_Object frame
, color
, def
;
7338 int foreground_p
= idx
== LFACE_FOREGROUND_INDEX
;
7339 unsigned long default_pixel
, default_other_pixel
, pixel
;
7341 xassert (idx
== LFACE_FOREGROUND_INDEX
|| idx
== LFACE_BACKGROUND_INDEX
);
7345 pixel
= default_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7346 default_other_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7350 pixel
= default_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7351 default_other_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7354 XSETFRAME (frame
, f
);
7355 color
= face
->lface
[idx
];
7359 && CONSP (Vtty_defined_color_alist
)
7360 && (def
= assq_no_quit (color
, call1 (Qtty_color_alist
, frame
)),
7363 /* Associations in tty-defined-color-alist are of the form
7364 (NAME INDEX R G B). We need the INDEX part. */
7365 pixel
= XINT (XCAR (XCDR (def
)));
7368 if (pixel
== default_pixel
&& STRINGP (color
))
7370 pixel
= load_color (f
, face
, color
, idx
);
7372 #if defined (MSDOS) || defined (WINDOWSNT)
7373 /* If the foreground of the default face is the default color,
7374 use the foreground color defined by the frame. */
7376 if (FRAME_MSDOS_P (f
))
7379 if (pixel
== default_pixel
7380 || pixel
== FACE_TTY_DEFAULT_COLOR
)
7383 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7385 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7386 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7389 else if (pixel
== default_other_pixel
)
7392 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7394 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7395 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7401 #endif /* MSDOS or WINDOWSNT */
7405 face
->foreground
= pixel
;
7407 face
->background
= pixel
;
7411 /* Realize the fully-specified face with attributes ATTRS in face
7412 cache CACHE for character C. Do it for TTY frame CACHE->f. Value is a
7413 pointer to the newly created realized face. */
7415 static struct face
*
7416 realize_tty_face (cache
, attrs
, c
)
7417 struct face_cache
*cache
;
7423 int face_colors_defaulted
= 0;
7424 struct frame
*f
= cache
->f
;
7426 /* Frame must be a termcap frame. */
7427 xassert (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
));
7429 /* Allocate a new realized face. */
7430 face
= make_realized_face (attrs
);
7431 face
->font_name
= FRAME_MSDOS_P (cache
->f
) ? "ms-dos" : "tty";
7433 /* Map face attributes to TTY appearances. We map slant to
7434 dimmed text because we want italic text to appear differently
7435 and because dimmed text is probably used infrequently. */
7436 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
7437 slant
= face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
7439 if (weight
> XLFD_WEIGHT_MEDIUM
)
7440 face
->tty_bold_p
= 1;
7441 if (weight
< XLFD_WEIGHT_MEDIUM
|| slant
!= XLFD_SLANT_ROMAN
)
7442 face
->tty_dim_p
= 1;
7443 if (!NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7444 face
->tty_underline_p
= 1;
7445 if (!NILP (attrs
[LFACE_INVERSE_INDEX
]))
7446 face
->tty_reverse_p
= 1;
7448 /* Map color names to color indices. */
7449 map_tty_color (f
, face
, LFACE_FOREGROUND_INDEX
, &face_colors_defaulted
);
7450 map_tty_color (f
, face
, LFACE_BACKGROUND_INDEX
, &face_colors_defaulted
);
7452 /* Swap colors if face is inverse-video. If the colors are taken
7453 from the frame colors, they are already inverted, since the
7454 frame-creation function calls x-handle-reverse-video. */
7455 if (face
->tty_reverse_p
&& !face_colors_defaulted
)
7457 unsigned long tem
= face
->foreground
;
7458 face
->foreground
= face
->background
;
7459 face
->background
= tem
;
7462 if (tty_suppress_bold_inverse_default_colors_p
7464 && face
->background
== FACE_TTY_DEFAULT_FG_COLOR
7465 && face
->foreground
== FACE_TTY_DEFAULT_BG_COLOR
)
7466 face
->tty_bold_p
= 0;
7472 DEFUN ("tty-suppress-bold-inverse-default-colors",
7473 Ftty_suppress_bold_inverse_default_colors
,
7474 Stty_suppress_bold_inverse_default_colors
, 1, 1, 0,
7475 doc
: /* Suppress/allow boldness of faces with inverse default colors.
7476 SUPPRESS non-nil means suppress it.
7477 This affects bold faces on TTYs whose foreground is the default background
7478 color of the display and whose background is the default foreground color.
7479 For such faces, the bold face attribute is ignored if this variable
7482 Lisp_Object suppress
;
7484 tty_suppress_bold_inverse_default_colors_p
= !NILP (suppress
);
7485 ++face_change_count
;
7491 /***********************************************************************
7493 ***********************************************************************/
7495 /* Return the ID of the face to use to display character CH with face
7496 property PROP on frame F in current_buffer. */
7499 compute_char_face (f
, ch
, prop
)
7506 if (NILP (current_buffer
->enable_multibyte_characters
))
7511 struct face
*face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7512 face_id
= FACE_FOR_CHAR (f
, face
, ch
);
7516 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7517 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7518 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7519 merge_face_ref (f
, prop
, attrs
, 1, 0);
7520 face_id
= lookup_face (f
, attrs
, ch
, NULL
);
7526 /* Return the face ID associated with buffer position POS for
7527 displaying ASCII characters. Return in *ENDPTR the position at
7528 which a different face is needed, as far as text properties and
7529 overlays are concerned. W is a window displaying current_buffer.
7531 REGION_BEG, REGION_END delimit the region, so it can be
7534 LIMIT is a position not to scan beyond. That is to limit the time
7535 this function can take.
7537 If MOUSE is non-zero, use the character's mouse-face, not its face.
7539 The face returned is suitable for displaying ASCII characters. */
7542 face_at_buffer_position (w
, pos
, region_beg
, region_end
,
7543 endptr
, limit
, mouse
)
7546 int region_beg
, region_end
;
7551 struct frame
*f
= XFRAME (w
->frame
);
7552 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7553 Lisp_Object prop
, position
;
7555 Lisp_Object
*overlay_vec
;
7558 Lisp_Object propname
= mouse
? Qmouse_face
: Qface
;
7559 Lisp_Object limit1
, end
;
7560 struct face
*default_face
;
7562 /* W must display the current buffer. We could write this function
7563 to use the frame and buffer of W, but right now it doesn't. */
7564 /* xassert (XBUFFER (w->buffer) == current_buffer); */
7566 XSETFRAME (frame
, f
);
7567 XSETFASTINT (position
, pos
);
7570 if (pos
< region_beg
&& region_beg
< endpos
)
7571 endpos
= region_beg
;
7573 /* Get the `face' or `mouse_face' text property at POS, and
7574 determine the next position at which the property changes. */
7575 prop
= Fget_text_property (position
, propname
, w
->buffer
);
7576 XSETFASTINT (limit1
, (limit
< endpos
? limit
: endpos
));
7577 end
= Fnext_single_property_change (position
, propname
, w
->buffer
, limit1
);
7579 endpos
= XINT (end
);
7581 /* Look at properties from overlays. */
7585 GET_OVERLAYS_AT (pos
, overlay_vec
, noverlays
, &next_overlay
, 0);
7586 if (next_overlay
< endpos
)
7587 endpos
= next_overlay
;
7592 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7594 /* Optimize common cases where we can use the default face. */
7597 && !(pos
>= region_beg
&& pos
< region_end
))
7598 return DEFAULT_FACE_ID
;
7600 /* Begin with attributes from the default face. */
7601 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7603 /* Merge in attributes specified via text properties. */
7605 merge_face_ref (f
, prop
, attrs
, 1, 0);
7607 /* Now merge the overlay data. */
7608 noverlays
= sort_overlays (overlay_vec
, noverlays
, w
);
7609 for (i
= 0; i
< noverlays
; i
++)
7614 prop
= Foverlay_get (overlay_vec
[i
], propname
);
7616 merge_face_ref (f
, prop
, attrs
, 1, 0);
7618 oend
= OVERLAY_END (overlay_vec
[i
]);
7619 oendpos
= OVERLAY_POSITION (oend
);
7620 if (oendpos
< endpos
)
7624 /* If in the region, merge in the region face. */
7625 if (pos
>= region_beg
&& pos
< region_end
)
7627 merge_named_face (f
, Qregion
, attrs
, 0);
7629 if (region_end
< endpos
)
7630 endpos
= region_end
;
7635 /* Look up a realized face with the given face attributes,
7636 or realize a new one for ASCII characters. */
7637 return lookup_face (f
, attrs
, 0, NULL
);
7641 /* Compute the face at character position POS in Lisp string STRING on
7642 window W, for ASCII characters.
7644 If STRING is an overlay string, it comes from position BUFPOS in
7645 current_buffer, otherwise BUFPOS is zero to indicate that STRING is
7646 not an overlay string. W must display the current buffer.
7647 REGION_BEG and REGION_END give the start and end positions of the
7648 region; both are -1 if no region is visible.
7650 BASE_FACE_ID is the id of a face to merge with. For strings coming
7651 from overlays or the `display' property it is the face at BUFPOS.
7653 If MOUSE_P is non-zero, use the character's mouse-face, not its face.
7655 Set *ENDPTR to the next position where to check for faces in
7656 STRING; -1 if the face is constant from POS to the end of the
7659 Value is the id of the face to use. The face returned is suitable
7660 for displaying ASCII characters. */
7663 face_at_string_position (w
, string
, pos
, bufpos
, region_beg
,
7664 region_end
, endptr
, base_face_id
, mouse_p
)
7668 int region_beg
, region_end
;
7670 enum face_id base_face_id
;
7673 Lisp_Object prop
, position
, end
, limit
;
7674 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
7675 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7676 struct face
*base_face
;
7677 int multibyte_p
= STRING_MULTIBYTE (string
);
7678 Lisp_Object prop_name
= mouse_p
? Qmouse_face
: Qface
;
7680 /* Get the value of the face property at the current position within
7681 STRING. Value is nil if there is no face property. */
7682 XSETFASTINT (position
, pos
);
7683 prop
= Fget_text_property (position
, prop_name
, string
);
7685 /* Get the next position at which to check for faces. Value of end
7686 is nil if face is constant all the way to the end of the string.
7687 Otherwise it is a string position where to check faces next.
7688 Limit is the maximum position up to which to check for property
7689 changes in Fnext_single_property_change. Strings are usually
7690 short, so set the limit to the end of the string. */
7691 XSETFASTINT (limit
, SCHARS (string
));
7692 end
= Fnext_single_property_change (position
, prop_name
, string
, limit
);
7694 *endptr
= XFASTINT (end
);
7698 base_face
= FACE_FROM_ID (f
, base_face_id
);
7699 xassert (base_face
);
7701 /* Optimize the default case that there is no face property and we
7702 are not in the region. */
7704 && (base_face_id
!= DEFAULT_FACE_ID
7705 /* BUFPOS <= 0 means STRING is not an overlay string, so
7706 that the region doesn't have to be taken into account. */
7708 || bufpos
< region_beg
7709 || bufpos
>= region_end
)
7711 /* We can't realize faces for different charsets differently
7712 if we don't have fonts, so we can stop here if not working
7713 on a window-system frame. */
7714 || !FRAME_WINDOW_P (f
)
7715 || FACE_SUITABLE_FOR_CHAR_P (base_face
, 0)))
7716 return base_face
->id
;
7718 /* Begin with attributes from the base face. */
7719 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
7721 /* Merge in attributes specified via text properties. */
7723 merge_face_ref (f
, prop
, attrs
, 1, 0);
7725 /* If in the region, merge in the region face. */
7727 && bufpos
>= region_beg
7728 && bufpos
< region_end
)
7729 merge_named_face (f
, Qregion
, attrs
, 0);
7731 /* Look up a realized face with the given face attributes,
7732 or realize a new one for ASCII characters. */
7733 return lookup_face (f
, attrs
, 0, NULL
);
7737 /* Merge a face into a realized face.
7739 F is frame where faces are (to be) realized.
7741 FACE_NAME is named face to merge.
7743 If FACE_NAME is nil, FACE_ID is face_id of realized face to merge.
7745 If FACE_NAME is t, FACE_ID is lface_id of face to merge.
7747 BASE_FACE_ID is realized face to merge into.
7753 merge_faces (f
, face_name
, face_id
, base_face_id
)
7755 Lisp_Object face_name
;
7756 int face_id
, base_face_id
;
7758 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7759 struct face
*base_face
;
7761 base_face
= FACE_FROM_ID (f
, base_face_id
);
7763 return base_face_id
;
7765 if (EQ (face_name
, Qt
))
7767 if (face_id
< 0 || face_id
>= lface_id_to_name_size
)
7768 return base_face_id
;
7769 face_name
= lface_id_to_name
[face_id
];
7770 face_id
= lookup_derived_face (f
, face_name
, 0, base_face_id
, 1);
7773 return base_face_id
;
7776 /* Begin with attributes from the base face. */
7777 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
7779 if (!NILP (face_name
))
7781 if (!merge_named_face (f
, face_name
, attrs
, 0))
7782 return base_face_id
;
7788 return base_face_id
;
7789 face
= FACE_FROM_ID (f
, face_id
);
7791 return base_face_id
;
7792 merge_face_vectors (f
, face
->lface
, attrs
, 0);
7795 /* Look up a realized face with the given face attributes,
7796 or realize a new one for ASCII characters. */
7797 return lookup_face (f
, attrs
, 0, NULL
);
7801 /***********************************************************************
7803 ***********************************************************************/
7807 /* Print the contents of the realized face FACE to stderr. */
7810 dump_realized_face (face
)
7813 fprintf (stderr
, "ID: %d\n", face
->id
);
7814 #ifdef HAVE_X_WINDOWS
7815 fprintf (stderr
, "gc: %ld\n", (long) face
->gc
);
7817 fprintf (stderr
, "foreground: 0x%lx (%s)\n",
7819 SDATA (face
->lface
[LFACE_FOREGROUND_INDEX
]));
7820 fprintf (stderr
, "background: 0x%lx (%s)\n",
7822 SDATA (face
->lface
[LFACE_BACKGROUND_INDEX
]));
7823 fprintf (stderr
, "font_name: %s (%s)\n",
7825 SDATA (face
->lface
[LFACE_FAMILY_INDEX
]));
7826 #ifdef HAVE_X_WINDOWS
7827 fprintf (stderr
, "font = %p\n", face
->font
);
7829 fprintf (stderr
, "font_info_id = %d\n", face
->font_info_id
);
7830 fprintf (stderr
, "fontset: %d\n", face
->fontset
);
7831 fprintf (stderr
, "underline: %d (%s)\n",
7833 SDATA (Fsymbol_name (face
->lface
[LFACE_UNDERLINE_INDEX
])));
7834 fprintf (stderr
, "hash: %d\n", face
->hash
);
7835 fprintf (stderr
, "charset: %d\n", face
->charset
);
7839 DEFUN ("dump-face", Fdump_face
, Sdump_face
, 0, 1, 0, doc
: /* */)
7847 fprintf (stderr
, "font selection order: ");
7848 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
7849 fprintf (stderr
, "%d ", font_sort_order
[i
]);
7850 fprintf (stderr
, "\n");
7852 fprintf (stderr
, "alternative fonts: ");
7853 debug_print (Vface_alternative_font_family_alist
);
7854 fprintf (stderr
, "\n");
7856 for (i
= 0; i
< FRAME_FACE_CACHE (SELECTED_FRAME ())->used
; ++i
)
7857 Fdump_face (make_number (i
));
7863 face
= FACE_FROM_ID (SELECTED_FRAME (), XINT (n
));
7865 error ("Not a valid face");
7866 dump_realized_face (face
);
7873 DEFUN ("show-face-resources", Fshow_face_resources
, Sshow_face_resources
,
7874 0, 0, 0, doc
: /* */)
7877 fprintf (stderr
, "number of colors = %d\n", ncolors_allocated
);
7878 fprintf (stderr
, "number of pixmaps = %d\n", npixmaps_allocated
);
7879 fprintf (stderr
, "number of GCs = %d\n", ngcs
);
7883 #endif /* GLYPH_DEBUG != 0 */
7887 /***********************************************************************
7889 ***********************************************************************/
7894 Qface
= intern ("face");
7896 Qface_no_inherit
= intern ("face-no-inherit");
7897 staticpro (&Qface_no_inherit
);
7898 Qbitmap_spec_p
= intern ("bitmap-spec-p");
7899 staticpro (&Qbitmap_spec_p
);
7900 Qframe_set_background_mode
= intern ("frame-set-background-mode");
7901 staticpro (&Qframe_set_background_mode
);
7903 /* Lisp face attribute keywords. */
7904 QCfamily
= intern (":family");
7905 staticpro (&QCfamily
);
7906 QCheight
= intern (":height");
7907 staticpro (&QCheight
);
7908 QCweight
= intern (":weight");
7909 staticpro (&QCweight
);
7910 QCslant
= intern (":slant");
7911 staticpro (&QCslant
);
7912 QCunderline
= intern (":underline");
7913 staticpro (&QCunderline
);
7914 QCinverse_video
= intern (":inverse-video");
7915 staticpro (&QCinverse_video
);
7916 QCreverse_video
= intern (":reverse-video");
7917 staticpro (&QCreverse_video
);
7918 QCforeground
= intern (":foreground");
7919 staticpro (&QCforeground
);
7920 QCbackground
= intern (":background");
7921 staticpro (&QCbackground
);
7922 QCstipple
= intern (":stipple");;
7923 staticpro (&QCstipple
);
7924 QCwidth
= intern (":width");
7925 staticpro (&QCwidth
);
7926 QCfont
= intern (":font");
7927 staticpro (&QCfont
);
7928 QCbold
= intern (":bold");
7929 staticpro (&QCbold
);
7930 QCitalic
= intern (":italic");
7931 staticpro (&QCitalic
);
7932 QCoverline
= intern (":overline");
7933 staticpro (&QCoverline
);
7934 QCstrike_through
= intern (":strike-through");
7935 staticpro (&QCstrike_through
);
7936 QCbox
= intern (":box");
7938 QCinherit
= intern (":inherit");
7939 staticpro (&QCinherit
);
7941 /* Symbols used for Lisp face attribute values. */
7942 QCcolor
= intern (":color");
7943 staticpro (&QCcolor
);
7944 QCline_width
= intern (":line-width");
7945 staticpro (&QCline_width
);
7946 QCstyle
= intern (":style");
7947 staticpro (&QCstyle
);
7948 Qreleased_button
= intern ("released-button");
7949 staticpro (&Qreleased_button
);
7950 Qpressed_button
= intern ("pressed-button");
7951 staticpro (&Qpressed_button
);
7952 Qnormal
= intern ("normal");
7953 staticpro (&Qnormal
);
7954 Qultra_light
= intern ("ultra-light");
7955 staticpro (&Qultra_light
);
7956 Qextra_light
= intern ("extra-light");
7957 staticpro (&Qextra_light
);
7958 Qlight
= intern ("light");
7959 staticpro (&Qlight
);
7960 Qsemi_light
= intern ("semi-light");
7961 staticpro (&Qsemi_light
);
7962 Qsemi_bold
= intern ("semi-bold");
7963 staticpro (&Qsemi_bold
);
7964 Qbold
= intern ("bold");
7966 Qextra_bold
= intern ("extra-bold");
7967 staticpro (&Qextra_bold
);
7968 Qultra_bold
= intern ("ultra-bold");
7969 staticpro (&Qultra_bold
);
7970 Qoblique
= intern ("oblique");
7971 staticpro (&Qoblique
);
7972 Qitalic
= intern ("italic");
7973 staticpro (&Qitalic
);
7974 Qreverse_oblique
= intern ("reverse-oblique");
7975 staticpro (&Qreverse_oblique
);
7976 Qreverse_italic
= intern ("reverse-italic");
7977 staticpro (&Qreverse_italic
);
7978 Qultra_condensed
= intern ("ultra-condensed");
7979 staticpro (&Qultra_condensed
);
7980 Qextra_condensed
= intern ("extra-condensed");
7981 staticpro (&Qextra_condensed
);
7982 Qcondensed
= intern ("condensed");
7983 staticpro (&Qcondensed
);
7984 Qsemi_condensed
= intern ("semi-condensed");
7985 staticpro (&Qsemi_condensed
);
7986 Qsemi_expanded
= intern ("semi-expanded");
7987 staticpro (&Qsemi_expanded
);
7988 Qexpanded
= intern ("expanded");
7989 staticpro (&Qexpanded
);
7990 Qextra_expanded
= intern ("extra-expanded");
7991 staticpro (&Qextra_expanded
);
7992 Qultra_expanded
= intern ("ultra-expanded");
7993 staticpro (&Qultra_expanded
);
7994 Qbackground_color
= intern ("background-color");
7995 staticpro (&Qbackground_color
);
7996 Qforeground_color
= intern ("foreground-color");
7997 staticpro (&Qforeground_color
);
7998 Qunspecified
= intern ("unspecified");
7999 staticpro (&Qunspecified
);
8001 Qface_alias
= intern ("face-alias");
8002 staticpro (&Qface_alias
);
8003 Qdefault
= intern ("default");
8004 staticpro (&Qdefault
);
8005 Qtool_bar
= intern ("tool-bar");
8006 staticpro (&Qtool_bar
);
8007 Qregion
= intern ("region");
8008 staticpro (&Qregion
);
8009 Qfringe
= intern ("fringe");
8010 staticpro (&Qfringe
);
8011 Qheader_line
= intern ("header-line");
8012 staticpro (&Qheader_line
);
8013 Qscroll_bar
= intern ("scroll-bar");
8014 staticpro (&Qscroll_bar
);
8015 Qmenu
= intern ("menu");
8017 Qcursor
= intern ("cursor");
8018 staticpro (&Qcursor
);
8019 Qborder
= intern ("border");
8020 staticpro (&Qborder
);
8021 Qmouse
= intern ("mouse");
8022 staticpro (&Qmouse
);
8023 Qmode_line_inactive
= intern ("mode-line-inactive");
8024 staticpro (&Qmode_line_inactive
);
8025 Qvertical_border
= intern ("vertical-border");
8026 staticpro (&Qvertical_border
);
8027 Qtty_color_desc
= intern ("tty-color-desc");
8028 staticpro (&Qtty_color_desc
);
8029 Qtty_color_standard_values
= intern ("tty-color-standard-values");
8030 staticpro (&Qtty_color_standard_values
);
8031 Qtty_color_by_index
= intern ("tty-color-by-index");
8032 staticpro (&Qtty_color_by_index
);
8033 Qtty_color_alist
= intern ("tty-color-alist");
8034 staticpro (&Qtty_color_alist
);
8035 Qscalable_fonts_allowed
= intern ("scalable-fonts-allowed");
8036 staticpro (&Qscalable_fonts_allowed
);
8038 Vparam_value_alist
= Fcons (Fcons (Qnil
, Qnil
), Qnil
);
8039 staticpro (&Vparam_value_alist
);
8040 Vface_alternative_font_family_alist
= Qnil
;
8041 staticpro (&Vface_alternative_font_family_alist
);
8042 Vface_alternative_font_registry_alist
= Qnil
;
8043 staticpro (&Vface_alternative_font_registry_alist
);
8045 defsubr (&Sinternal_make_lisp_face
);
8046 defsubr (&Sinternal_lisp_face_p
);
8047 defsubr (&Sinternal_set_lisp_face_attribute
);
8048 #ifdef HAVE_WINDOW_SYSTEM
8049 defsubr (&Sinternal_set_lisp_face_attribute_from_resource
);
8051 defsubr (&Scolor_gray_p
);
8052 defsubr (&Scolor_supported_p
);
8053 defsubr (&Sface_attribute_relative_p
);
8054 defsubr (&Smerge_face_attribute
);
8055 defsubr (&Sinternal_get_lisp_face_attribute
);
8056 defsubr (&Sinternal_lisp_face_attribute_values
);
8057 defsubr (&Sinternal_lisp_face_equal_p
);
8058 defsubr (&Sinternal_lisp_face_empty_p
);
8059 defsubr (&Sinternal_copy_lisp_face
);
8060 defsubr (&Sinternal_merge_in_global_face
);
8061 defsubr (&Sface_font
);
8062 defsubr (&Sframe_face_alist
);
8063 defsubr (&Sdisplay_supports_face_attributes_p
);
8064 defsubr (&Scolor_distance
);
8065 defsubr (&Sinternal_set_font_selection_order
);
8066 defsubr (&Sinternal_set_alternative_font_family_alist
);
8067 defsubr (&Sinternal_set_alternative_font_registry_alist
);
8068 defsubr (&Sface_attributes_as_vector
);
8070 defsubr (&Sdump_face
);
8071 defsubr (&Sshow_face_resources
);
8072 #endif /* GLYPH_DEBUG */
8073 defsubr (&Sclear_face_cache
);
8074 defsubr (&Stty_suppress_bold_inverse_default_colors
);
8076 #if defined DEBUG_X_COLORS && defined HAVE_X_WINDOWS
8077 defsubr (&Sdump_colors
);
8080 DEFVAR_LISP ("font-list-limit", &Vfont_list_limit
,
8081 doc
: /* *Limit for font matching.
8082 If an integer > 0, font matching functions won't load more than
8083 that number of fonts when searching for a matching font. */);
8084 Vfont_list_limit
= make_number (DEFAULT_FONT_LIST_LIMIT
);
8086 DEFVAR_LISP ("face-new-frame-defaults", &Vface_new_frame_defaults
,
8087 doc
: /* List of global face definitions (for internal use only.) */);
8088 Vface_new_frame_defaults
= Qnil
;
8090 DEFVAR_LISP ("face-default-stipple", &Vface_default_stipple
,
8091 doc
: /* *Default stipple pattern used on monochrome displays.
8092 This stipple pattern is used on monochrome displays
8093 instead of shades of gray for a face background color.
8094 See `set-face-stipple' for possible values for this variable. */);
8095 Vface_default_stipple
= build_string ("gray3");
8097 DEFVAR_LISP ("tty-defined-color-alist", &Vtty_defined_color_alist
,
8098 doc
: /* An alist of defined terminal colors and their RGB values. */);
8099 Vtty_defined_color_alist
= Qnil
;
8101 DEFVAR_LISP ("scalable-fonts-allowed", &Vscalable_fonts_allowed
,
8102 doc
: /* Allowed scalable fonts.
8103 A value of nil means don't allow any scalable fonts.
8104 A value of t means allow any scalable font.
8105 Otherwise, value must be a list of regular expressions. A font may be
8106 scaled if its name matches a regular expression in the list.
8107 Note that if value is nil, a scalable font might still be used, if no
8108 other font of the appropriate family and registry is available. */);
8109 Vscalable_fonts_allowed
= Qnil
;
8111 DEFVAR_LISP ("face-ignored-fonts", &Vface_ignored_fonts
,
8112 doc
: /* List of ignored fonts.
8113 Each element is a regular expression that matches names of fonts to
8115 Vface_ignored_fonts
= Qnil
;
8117 DEFVAR_LISP ("face-font-rescale-alist", &Vface_font_rescale_alist
,
8118 doc
: /* Alist of fonts vs the rescaling factors.
8119 Each element is a cons (FONT-NAME-PATTERN . RESCALE-RATIO), where
8120 FONT-NAME-PATTERN is a regular expression matching a font name, and
8121 RESCALE-RATIO is a floating point number to specify how much larger
8122 \(or smaller) font we should use. For instance, if a face requests
8123 a font of 10 point, we actually use a font of 10 * RESCALE-RATIO point. */);
8124 Vface_font_rescale_alist
= Qnil
;
8126 #ifdef HAVE_WINDOW_SYSTEM
8127 defsubr (&Sbitmap_spec_p
);
8128 defsubr (&Sx_list_fonts
);
8129 defsubr (&Sinternal_face_x_get_resource
);
8130 defsubr (&Sx_family_fonts
);
8131 defsubr (&Sx_font_family_list
);
8132 #endif /* HAVE_WINDOW_SYSTEM */
8135 /* arch-tag: 8a0f7598-5517-408d-9ab3-1da6fcd4c749
8136 (do not change this comment) */