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>
198 #include <stdio.h> /* This needs to be before termchar.h */
202 #include "keyboard.h"
204 #include "termhooks.h"
206 #ifdef HAVE_WINDOW_SYSTEM
208 #endif /* HAVE_WINDOW_SYSTEM */
210 #ifdef HAVE_X_WINDOWS
214 #include <Xm/XmStrDefs.h>
215 #endif /* USE_MOTIF */
216 #endif /* HAVE_X_WINDOWS */
225 /* Redefine X specifics to W32 equivalents to avoid cluttering the
226 code with #ifdef blocks. */
227 #undef FRAME_X_DISPLAY_INFO
228 #define FRAME_X_DISPLAY_INFO FRAME_W32_DISPLAY_INFO
229 #define x_display_info w32_display_info
230 #define FRAME_X_FONT_TABLE FRAME_W32_FONT_TABLE
231 #define check_x check_w32
232 #define x_list_fonts w32_list_fonts
233 #define GCGraphicsExposures 0
234 #endif /* WINDOWSNT */
238 #define x_display_info mac_display_info
239 #define check_x check_mac
243 #include "dispextern.h"
244 #include "blockinput.h"
246 #include "intervals.h"
247 #include "termchar.h"
249 #ifdef HAVE_X_WINDOWS
251 /* Compensate for a bug in Xos.h on some systems, on which it requires
252 time.h. On some such systems, Xos.h tries to redefine struct
253 timeval and struct timezone if USG is #defined while it is
256 #ifdef XOS_NEEDS_TIME_H
262 #else /* not XOS_NEEDS_TIME_H */
264 #endif /* not XOS_NEEDS_TIME_H */
266 #endif /* HAVE_X_WINDOWS */
270 #define abs(X) ((X) < 0 ? -(X) : (X))
272 /* Number of pt per inch (from the TeXbook). */
274 #define PT_PER_INCH 72.27
276 /* Non-zero if face attribute ATTR is unspecified. */
278 #define UNSPECIFIEDP(ATTR) EQ ((ATTR), Qunspecified)
280 /* Value is the number of elements of VECTOR. */
282 #define DIM(VECTOR) (sizeof (VECTOR) / sizeof *(VECTOR))
284 /* Make a copy of string S on the stack using alloca. Value is a pointer
287 #define STRDUPA(S) strcpy ((char *) alloca (strlen ((S)) + 1), (S))
289 /* Make a copy of the contents of Lisp string S on the stack using
290 alloca. Value is a pointer to the copy. */
292 #define LSTRDUPA(S) STRDUPA (SDATA ((S)))
294 /* Size of hash table of realized faces in face caches (should be a
297 #define FACE_CACHE_BUCKETS_SIZE 1001
299 /* Keyword symbols used for face attribute names. */
301 Lisp_Object QCfamily
, QCheight
, QCweight
, QCslant
, QCunderline
;
302 Lisp_Object QCinverse_video
, QCforeground
, QCbackground
, QCstipple
;
303 Lisp_Object QCwidth
, QCfont
, QCbold
, QCitalic
;
304 Lisp_Object QCreverse_video
;
305 Lisp_Object QCoverline
, QCstrike_through
, QCbox
, QCinherit
;
307 /* Symbols used for attribute values. */
309 Lisp_Object Qnormal
, Qbold
, Qultra_light
, Qextra_light
, Qlight
;
310 Lisp_Object Qsemi_light
, Qsemi_bold
, Qextra_bold
, Qultra_bold
;
311 Lisp_Object Qoblique
, Qitalic
, Qreverse_oblique
, Qreverse_italic
;
312 Lisp_Object Qultra_condensed
, Qextra_condensed
, Qcondensed
;
313 Lisp_Object Qsemi_condensed
, Qsemi_expanded
, Qexpanded
, Qextra_expanded
;
314 Lisp_Object Qultra_expanded
;
315 Lisp_Object Qreleased_button
, Qpressed_button
;
316 Lisp_Object QCstyle
, QCcolor
, QCline_width
;
317 Lisp_Object Qunspecified
;
319 char unspecified_fg
[] = "unspecified-fg", unspecified_bg
[] = "unspecified-bg";
321 /* The name of the function to call when the background of the frame
322 has changed, frame_set_background_mode. */
324 Lisp_Object Qframe_set_background_mode
;
326 /* Names of basic faces. */
328 Lisp_Object Qdefault
, Qtool_bar
, Qregion
, Qfringe
;
329 Lisp_Object Qheader_line
, Qscroll_bar
, Qcursor
, Qborder
, Qmouse
, Qmenu
;
330 Lisp_Object Qmode_line_inactive
, Qvertical_border
;
331 extern Lisp_Object Qmode_line
;
333 /* The symbol `face-alias'. A symbols having that property is an
334 alias for another face. Value of the property is the name of
337 Lisp_Object Qface_alias
;
339 extern Lisp_Object Qcircular_list
;
341 /* Default stipple pattern used on monochrome displays. This stipple
342 pattern is used on monochrome displays instead of shades of gray
343 for a face background color. See `set-face-stipple' for possible
344 values for this variable. */
346 Lisp_Object Vface_default_stipple
;
348 /* Alist of alternative font families. Each element is of the form
349 (FAMILY FAMILY1 FAMILY2 ...). If fonts of FAMILY can't be loaded,
350 try FAMILY1, then FAMILY2, ... */
352 Lisp_Object Vface_alternative_font_family_alist
;
354 /* Alist of alternative font registries. Each element is of the form
355 (REGISTRY REGISTRY1 REGISTRY2...). If fonts of REGISTRY can't be
356 loaded, try REGISTRY1, then REGISTRY2, ... */
358 Lisp_Object Vface_alternative_font_registry_alist
;
360 /* Allowed scalable fonts. A value of nil means don't allow any
361 scalable fonts. A value of t means allow the use of any scalable
362 font. Otherwise, value must be a list of regular expressions. A
363 font may be scaled if its name matches a regular expression in the
366 Lisp_Object Vscalable_fonts_allowed
, Qscalable_fonts_allowed
;
368 /* List of regular expressions that matches names of fonts to ignore. */
370 Lisp_Object Vface_ignored_fonts
;
372 /* Alist of font name patterns vs the rescaling factor. */
374 Lisp_Object Vface_font_rescale_alist
;
376 /* Maximum number of fonts to consider in font_list. If not an
377 integer > 0, DEFAULT_FONT_LIST_LIMIT is used instead. */
379 Lisp_Object Vfont_list_limit
;
380 #define DEFAULT_FONT_LIST_LIMIT 100
382 /* The symbols `foreground-color' and `background-color' which can be
383 used as part of a `face' property. This is for compatibility with
386 Lisp_Object Qforeground_color
, Qbackground_color
;
388 /* The symbols `face' and `mouse-face' used as text properties. */
391 extern Lisp_Object Qmouse_face
;
393 /* Property for basic faces which other faces cannot inherit. */
395 Lisp_Object Qface_no_inherit
;
397 /* Error symbol for wrong_type_argument in load_pixmap. */
399 Lisp_Object Qbitmap_spec_p
;
401 /* Alist of global face definitions. Each element is of the form
402 (FACE . LFACE) where FACE is a symbol naming a face and LFACE
403 is a Lisp vector of face attributes. These faces are used
404 to initialize faces for new frames. */
406 Lisp_Object Vface_new_frame_defaults
;
408 /* The next ID to assign to Lisp faces. */
410 static int next_lface_id
;
412 /* A vector mapping Lisp face Id's to face names. */
414 static Lisp_Object
*lface_id_to_name
;
415 static int lface_id_to_name_size
;
417 /* TTY color-related functions (defined in tty-colors.el). */
419 Lisp_Object Qtty_color_desc
, Qtty_color_by_index
, Qtty_color_standard_values
;
421 /* The name of the function used to compute colors on TTYs. */
423 Lisp_Object Qtty_color_alist
;
425 /* An alist of defined terminal colors and their RGB values. */
427 Lisp_Object Vtty_defined_color_alist
;
429 /* Counter for calls to clear_face_cache. If this counter reaches
430 CLEAR_FONT_TABLE_COUNT, and a frame has more than
431 CLEAR_FONT_TABLE_NFONTS load, unused fonts are freed. */
433 static int clear_font_table_count
;
434 #define CLEAR_FONT_TABLE_COUNT 100
435 #define CLEAR_FONT_TABLE_NFONTS 10
437 /* Non-zero means face attributes have been changed since the last
438 redisplay. Used in redisplay_internal. */
440 int face_change_count
;
442 /* Non-zero means don't display bold text if a face's foreground
443 and background colors are the inverse of the default colors of the
444 display. This is a kluge to suppress `bold black' foreground text
445 which is hard to read on an LCD monitor. */
447 int tty_suppress_bold_inverse_default_colors_p
;
449 /* A list of the form `((x . y))' used to avoid consing in
450 Finternal_set_lisp_face_attribute. */
452 static Lisp_Object Vparam_value_alist
;
454 /* The total number of colors currently allocated. */
457 static int ncolors_allocated
;
458 static int npixmaps_allocated
;
462 /* Non-zero means the definition of the `menu' face for new frames has
465 int menu_face_changed_default
;
468 /* Function prototypes. */
472 struct named_merge_point
;
474 static void map_tty_color
P_ ((struct frame
*, struct face
*,
475 enum lface_attribute_index
, int *));
476 static Lisp_Object resolve_face_name
P_ ((Lisp_Object
, int));
477 static int may_use_scalable_font_p
P_ ((const char *));
478 static void set_font_frame_param
P_ ((Lisp_Object
, Lisp_Object
));
479 static int better_font_p
P_ ((int *, struct font_name
*, struct font_name
*,
481 static int x_face_list_fonts
P_ ((struct frame
*, char *,
482 struct font_name
**, int, int));
483 static int font_scalable_p
P_ ((struct font_name
*));
484 static int get_lface_attributes
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*, int));
485 static int load_pixmap
P_ ((struct frame
*, Lisp_Object
, unsigned *, unsigned *));
486 static unsigned char *xstrlwr
P_ ((unsigned char *));
487 static void signal_error
P_ ((char *, Lisp_Object
));
488 static struct frame
*frame_or_selected_frame
P_ ((Lisp_Object
, int));
489 static void load_face_font
P_ ((struct frame
*, struct face
*, int));
490 static void load_face_colors
P_ ((struct frame
*, struct face
*, Lisp_Object
*));
491 static void free_face_colors
P_ ((struct frame
*, struct face
*));
492 static int face_color_gray_p
P_ ((struct frame
*, char *));
493 static char *build_font_name
P_ ((struct font_name
*));
494 static void free_font_names
P_ ((struct font_name
*, int));
495 static int sorted_font_list
P_ ((struct frame
*, char *,
496 int (*cmpfn
) P_ ((const void *, const void *)),
497 struct font_name
**));
498 static int font_list_1
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
499 Lisp_Object
, struct font_name
**));
500 static int font_list
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
501 Lisp_Object
, struct font_name
**));
502 static int try_font_list
P_ ((struct frame
*, Lisp_Object
*,
503 Lisp_Object
, Lisp_Object
, struct font_name
**,
505 static int try_alternative_families
P_ ((struct frame
*f
, Lisp_Object
,
506 Lisp_Object
, struct font_name
**));
507 static int cmp_font_names
P_ ((const void *, const void *));
508 static struct face
*realize_face
P_ ((struct face_cache
*, Lisp_Object
*, int,
509 struct face
*, int));
510 static struct face
*realize_x_face
P_ ((struct face_cache
*,
511 Lisp_Object
*, int, struct face
*));
512 static struct face
*realize_tty_face
P_ ((struct face_cache
*,
513 Lisp_Object
*, int));
514 static int realize_basic_faces
P_ ((struct frame
*));
515 static int realize_default_face
P_ ((struct frame
*));
516 static void realize_named_face
P_ ((struct frame
*, Lisp_Object
, int));
517 static int lface_fully_specified_p
P_ ((Lisp_Object
*));
518 static int lface_equal_p
P_ ((Lisp_Object
*, Lisp_Object
*));
519 static unsigned hash_string_case_insensitive
P_ ((Lisp_Object
));
520 static unsigned lface_hash
P_ ((Lisp_Object
*));
521 static int lface_same_font_attributes_p
P_ ((Lisp_Object
*, Lisp_Object
*));
522 static struct face_cache
*make_face_cache
P_ ((struct frame
*));
523 static void free_realized_face
P_ ((struct frame
*, struct face
*));
524 static void clear_face_gcs
P_ ((struct face_cache
*));
525 static void free_face_cache
P_ ((struct face_cache
*));
526 static int face_numeric_weight
P_ ((Lisp_Object
));
527 static int face_numeric_slant
P_ ((Lisp_Object
));
528 static int face_numeric_swidth
P_ ((Lisp_Object
));
529 static int face_fontset
P_ ((Lisp_Object
*));
530 static char *choose_face_font
P_ ((struct frame
*, Lisp_Object
*, int, int, int*));
531 static void merge_face_vectors
P_ ((struct frame
*, Lisp_Object
*, Lisp_Object
*,
532 struct named_merge_point
*));
533 static int merge_face_ref
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*,
534 int, struct named_merge_point
*));
535 static int set_lface_from_font_name
P_ ((struct frame
*, Lisp_Object
,
536 Lisp_Object
, int, int));
537 static Lisp_Object lface_from_face_name
P_ ((struct frame
*, Lisp_Object
, int));
538 static struct face
*make_realized_face
P_ ((Lisp_Object
*));
539 static void free_realized_faces
P_ ((struct face_cache
*));
540 static char *best_matching_font
P_ ((struct frame
*, Lisp_Object
*,
541 struct font_name
*, int, int, int *));
542 static void cache_face
P_ ((struct face_cache
*, struct face
*, unsigned));
543 static void uncache_face
P_ ((struct face_cache
*, struct face
*));
544 static int xlfd_numeric_slant
P_ ((struct font_name
*));
545 static int xlfd_numeric_weight
P_ ((struct font_name
*));
546 static int xlfd_numeric_swidth
P_ ((struct font_name
*));
547 static Lisp_Object xlfd_symbolic_slant
P_ ((struct font_name
*));
548 static Lisp_Object xlfd_symbolic_weight
P_ ((struct font_name
*));
549 static Lisp_Object xlfd_symbolic_swidth
P_ ((struct font_name
*));
550 static int xlfd_fixed_p
P_ ((struct font_name
*));
551 static int xlfd_numeric_value
P_ ((struct table_entry
*, int, struct font_name
*,
553 static Lisp_Object xlfd_symbolic_value
P_ ((struct table_entry
*, int,
554 struct font_name
*, int,
556 static struct table_entry
*xlfd_lookup_field_contents
P_ ((struct table_entry
*, int,
557 struct font_name
*, int));
559 #ifdef HAVE_WINDOW_SYSTEM
561 static int split_font_name
P_ ((struct frame
*, struct font_name
*, int));
562 static int xlfd_point_size
P_ ((struct frame
*, struct font_name
*));
563 static void sort_fonts
P_ ((struct frame
*, struct font_name
*, int,
564 int (*cmpfn
) P_ ((const void *, const void *))));
565 static GC x_create_gc
P_ ((struct frame
*, unsigned long, XGCValues
*));
566 static void x_free_gc
P_ ((struct frame
*, GC
));
567 static void clear_font_table
P_ ((struct x_display_info
*));
570 extern Lisp_Object w32_list_fonts
P_ ((struct frame
*, Lisp_Object
, int, int));
571 #endif /* WINDOWSNT */
574 static void x_update_menu_appearance
P_ ((struct frame
*));
576 extern void free_frame_menubar
P_ ((struct frame
*));
577 #endif /* USE_X_TOOLKIT */
579 #endif /* HAVE_WINDOW_SYSTEM */
582 /***********************************************************************
584 ***********************************************************************/
586 #ifdef HAVE_X_WINDOWS
588 #ifdef DEBUG_X_COLORS
590 /* The following is a poor mans infrastructure for debugging X color
591 allocation problems on displays with PseudoColor-8. Some X servers
592 like 3.3.5 XF86_SVGA with Matrox cards apparently don't implement
593 color reference counts completely so that they don't signal an
594 error when a color is freed whose reference count is already 0.
595 Other X servers do. To help me debug this, the following code
596 implements a simple reference counting schema of its own, for a
597 single display/screen. --gerd. */
599 /* Reference counts for pixel colors. */
601 int color_count
[256];
603 /* Register color PIXEL as allocated. */
606 register_color (pixel
)
609 xassert (pixel
< 256);
610 ++color_count
[pixel
];
614 /* Register color PIXEL as deallocated. */
617 unregister_color (pixel
)
620 xassert (pixel
< 256);
621 if (color_count
[pixel
] > 0)
622 --color_count
[pixel
];
628 /* Register N colors from PIXELS as deallocated. */
631 unregister_colors (pixels
, n
)
632 unsigned long *pixels
;
636 for (i
= 0; i
< n
; ++i
)
637 unregister_color (pixels
[i
]);
641 DEFUN ("dump-colors", Fdump_colors
, Sdump_colors
, 0, 0, 0,
642 doc
: /* Dump currently allocated colors to stderr. */)
647 fputc ('\n', stderr
);
649 for (i
= n
= 0; i
< sizeof color_count
/ sizeof color_count
[0]; ++i
)
652 fprintf (stderr
, "%3d: %5d", i
, color_count
[i
]);
655 fputc ('\n', stderr
);
657 fputc ('\t', stderr
);
661 fputc ('\n', stderr
);
665 #endif /* DEBUG_X_COLORS */
668 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
669 color values. Interrupt input must be blocked when this function
673 x_free_colors (f
, pixels
, npixels
)
675 unsigned long *pixels
;
678 int class = FRAME_X_DISPLAY_INFO (f
)->visual
->class;
680 /* If display has an immutable color map, freeing colors is not
681 necessary and some servers don't allow it. So don't do it. */
682 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
684 #ifdef DEBUG_X_COLORS
685 unregister_colors (pixels
, npixels
);
687 XFreeColors (FRAME_X_DISPLAY (f
), FRAME_X_COLORMAP (f
),
693 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
694 color values. Interrupt input must be blocked when this function
698 x_free_dpy_colors (dpy
, screen
, cmap
, pixels
, npixels
)
702 unsigned long *pixels
;
705 struct x_display_info
*dpyinfo
= x_display_info_for_display (dpy
);
706 int class = dpyinfo
->visual
->class;
708 /* If display has an immutable color map, freeing colors is not
709 necessary and some servers don't allow it. So don't do it. */
710 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
712 #ifdef DEBUG_X_COLORS
713 unregister_colors (pixels
, npixels
);
715 XFreeColors (dpy
, cmap
, pixels
, npixels
, 0);
720 /* Create and return a GC for use on frame F. GC values and mask
721 are given by XGCV and MASK. */
724 x_create_gc (f
, mask
, xgcv
)
731 gc
= XCreateGC (FRAME_X_DISPLAY (f
), FRAME_X_WINDOW (f
), mask
, xgcv
);
738 /* Free GC which was used on frame F. */
746 IF_DEBUG (xassert (--ngcs
>= 0));
747 XFreeGC (FRAME_X_DISPLAY (f
), gc
);
751 #endif /* HAVE_X_WINDOWS */
754 /* W32 emulation of GCs */
757 x_create_gc (f
, mask
, xgcv
)
764 gc
= XCreateGC (NULL
, FRAME_W32_WINDOW (f
), mask
, xgcv
);
771 /* Free GC which was used on frame F. */
779 IF_DEBUG (xassert (--ngcs
>= 0));
784 #endif /* WINDOWSNT */
787 /* Mac OS emulation of GCs */
790 x_create_gc (f
, mask
, xgcv
)
796 gc
= XCreateGC (FRAME_MAC_DISPLAY (f
), FRAME_MAC_WINDOW (f
), mask
, xgcv
);
805 XFreeGC (FRAME_MAC_DISPLAY (f
), gc
);
810 /* Like stricmp. Used to compare parts of font names which are in
815 const unsigned char *s1
, *s2
;
819 unsigned char c1
= tolower (*s1
);
820 unsigned char c2
= tolower (*s2
);
822 return c1
< c2
? -1 : 1;
827 return *s2
== 0 ? 0 : -1;
832 /* Like strlwr, which might not always be available. */
834 static unsigned char *
838 unsigned char *p
= s
;
847 /* Signal `error' with message S, and additional argument ARG. */
850 signal_error (s
, arg
)
854 Fsignal (Qerror
, Fcons (build_string (s
), Fcons (arg
, Qnil
)));
858 /* If FRAME is nil, return a pointer to the selected frame.
859 Otherwise, check that FRAME is a live frame, and return a pointer
860 to it. NPARAM is the parameter number of FRAME, for
861 CHECK_LIVE_FRAME. This is here because it's a frequent pattern in
862 Lisp function definitions. */
864 static INLINE
struct frame
*
865 frame_or_selected_frame (frame
, nparam
)
870 frame
= selected_frame
;
872 CHECK_LIVE_FRAME (frame
);
873 return XFRAME (frame
);
877 /***********************************************************************
879 ***********************************************************************/
881 /* Initialize face cache and basic faces for frame F. */
887 /* Make a face cache, if F doesn't have one. */
888 if (FRAME_FACE_CACHE (f
) == NULL
)
889 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
891 #ifdef HAVE_WINDOW_SYSTEM
892 /* Make the image cache. */
893 if (FRAME_WINDOW_P (f
))
895 if (FRAME_X_IMAGE_CACHE (f
) == NULL
)
896 FRAME_X_IMAGE_CACHE (f
) = make_image_cache ();
897 ++FRAME_X_IMAGE_CACHE (f
)->refcount
;
899 #endif /* HAVE_WINDOW_SYSTEM */
901 /* Realize basic faces. Must have enough information in frame
902 parameters to realize basic faces at this point. */
903 #ifdef HAVE_X_WINDOWS
904 if (!FRAME_X_P (f
) || FRAME_X_WINDOW (f
))
907 if (!FRAME_WINDOW_P (f
) || FRAME_W32_WINDOW (f
))
910 if (!FRAME_MAC_P (f
) || FRAME_MAC_WINDOW (f
))
912 if (!realize_basic_faces (f
))
917 /* Free face cache of frame F. Called from Fdelete_frame. */
923 struct face_cache
*face_cache
= FRAME_FACE_CACHE (f
);
927 free_face_cache (face_cache
);
928 FRAME_FACE_CACHE (f
) = NULL
;
931 #ifdef HAVE_WINDOW_SYSTEM
932 if (FRAME_WINDOW_P (f
))
934 struct image_cache
*image_cache
= FRAME_X_IMAGE_CACHE (f
);
937 --image_cache
->refcount
;
938 if (image_cache
->refcount
== 0)
939 free_image_cache (f
);
942 #endif /* HAVE_WINDOW_SYSTEM */
946 /* Clear face caches, and recompute basic faces for frame F. Call
947 this after changing frame parameters on which those faces depend,
948 or when realized faces have been freed due to changing attributes
952 recompute_basic_faces (f
)
955 if (FRAME_FACE_CACHE (f
))
957 clear_face_cache (0);
958 if (!realize_basic_faces (f
))
964 /* Clear the face caches of all frames. CLEAR_FONTS_P non-zero means
965 try to free unused fonts, too. */
968 clear_face_cache (clear_fonts_p
)
971 #ifdef HAVE_WINDOW_SYSTEM
972 Lisp_Object tail
, frame
;
976 || ++clear_font_table_count
== CLEAR_FONT_TABLE_COUNT
)
978 struct x_display_info
*dpyinfo
;
980 /* Fonts are common for frames on one display, i.e. on
982 for (dpyinfo
= x_display_list
; dpyinfo
; dpyinfo
= dpyinfo
->next
)
983 if (dpyinfo
->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
984 clear_font_table (dpyinfo
);
986 /* From time to time see if we can unload some fonts. This also
987 frees all realized faces on all frames. Fonts needed by
988 faces will be loaded again when faces are realized again. */
989 clear_font_table_count
= 0;
991 FOR_EACH_FRAME (tail
, frame
)
993 struct frame
*f
= XFRAME (frame
);
994 if (FRAME_WINDOW_P (f
)
995 && FRAME_X_DISPLAY_INFO (f
)->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
996 free_all_realized_faces (frame
);
1001 /* Clear GCs of realized faces. */
1002 FOR_EACH_FRAME (tail
, frame
)
1005 if (FRAME_WINDOW_P (f
))
1007 clear_face_gcs (FRAME_FACE_CACHE (f
));
1008 clear_image_cache (f
, 0);
1012 #endif /* HAVE_WINDOW_SYSTEM */
1016 DEFUN ("clear-face-cache", Fclear_face_cache
, Sclear_face_cache
, 0, 1, 0,
1017 doc
: /* Clear face caches on all frames.
1018 Optional THOROUGHLY non-nil means try to free unused fonts, too. */)
1020 Lisp_Object thoroughly
;
1022 clear_face_cache (!NILP (thoroughly
));
1023 ++face_change_count
;
1024 ++windows_or_buffers_changed
;
1030 #ifdef HAVE_WINDOW_SYSTEM
1033 /* Remove fonts from the font table of DPYINFO except for the default
1034 ASCII fonts of frames on that display. Called from clear_face_cache
1035 from time to time. */
1038 clear_font_table (dpyinfo
)
1039 struct x_display_info
*dpyinfo
;
1043 /* Free those fonts that are not used by frames on DPYINFO. */
1044 for (i
= 0; i
< dpyinfo
->n_fonts
; ++i
)
1046 struct font_info
*font_info
= dpyinfo
->font_table
+ i
;
1047 Lisp_Object tail
, frame
;
1049 /* Check if slot is already free. */
1050 if (font_info
->name
== NULL
)
1053 /* Don't free a default font of some frame. */
1054 FOR_EACH_FRAME (tail
, frame
)
1056 struct frame
*f
= XFRAME (frame
);
1057 if (FRAME_WINDOW_P (f
)
1058 && font_info
->font
== FRAME_FONT (f
))
1066 if (font_info
->full_name
!= font_info
->name
)
1067 xfree (font_info
->full_name
);
1068 xfree (font_info
->name
);
1070 /* Free the font. */
1072 #ifdef HAVE_X_WINDOWS
1073 XFreeFont (dpyinfo
->display
, font_info
->font
);
1076 w32_unload_font (dpyinfo
, font_info
->font
);
1079 mac_unload_font (dpyinfo
, font_info
->font
);
1083 /* Mark font table slot free. */
1084 font_info
->font
= NULL
;
1085 font_info
->name
= font_info
->full_name
= NULL
;
1089 #endif /* HAVE_WINDOW_SYSTEM */
1093 /***********************************************************************
1095 ***********************************************************************/
1097 #ifdef HAVE_WINDOW_SYSTEM
1099 DEFUN ("bitmap-spec-p", Fbitmap_spec_p
, Sbitmap_spec_p
, 1, 1, 0,
1100 doc
: /* Value is non-nil if OBJECT is a valid bitmap specification.
1101 A bitmap specification is either a string, a file name, or a list
1102 \(WIDTH HEIGHT DATA) where WIDTH is the pixel width of the bitmap,
1103 HEIGHT is its height, and DATA is a string containing the bits of
1104 the pixmap. Bits are stored row by row, each row occupies
1105 \(WIDTH + 7)/8 bytes. */)
1111 if (STRINGP (object
))
1112 /* If OBJECT is a string, it's a file name. */
1114 else if (CONSP (object
))
1116 /* Otherwise OBJECT must be (WIDTH HEIGHT DATA), WIDTH and
1117 HEIGHT must be integers > 0, and DATA must be string large
1118 enough to hold a bitmap of the specified size. */
1119 Lisp_Object width
, height
, data
;
1121 height
= width
= data
= Qnil
;
1125 width
= XCAR (object
);
1126 object
= XCDR (object
);
1129 height
= XCAR (object
);
1130 object
= XCDR (object
);
1132 data
= XCAR (object
);
1136 if (NATNUMP (width
) && NATNUMP (height
) && STRINGP (data
))
1138 int bytes_per_row
= ((XFASTINT (width
) + BITS_PER_CHAR
- 1)
1140 if (SBYTES (data
) >= bytes_per_row
* XINT (height
))
1145 return pixmap_p
? Qt
: Qnil
;
1149 /* Load a bitmap according to NAME (which is either a file name or a
1150 pixmap spec) for use on frame F. Value is the bitmap_id (see
1151 xfns.c). If NAME is nil, return with a bitmap id of zero. If
1152 bitmap cannot be loaded, display a message saying so, and return
1153 zero. Store the bitmap width in *W_PTR and its height in *H_PTR,
1154 if these pointers are not null. */
1157 load_pixmap (f
, name
, w_ptr
, h_ptr
)
1160 unsigned int *w_ptr
, *h_ptr
;
1168 tem
= Fbitmap_spec_p (name
);
1170 wrong_type_argument (Qbitmap_spec_p
, name
);
1175 /* Decode a bitmap spec into a bitmap. */
1180 w
= XINT (Fcar (name
));
1181 h
= XINT (Fcar (Fcdr (name
)));
1182 bits
= Fcar (Fcdr (Fcdr (name
)));
1184 bitmap_id
= x_create_bitmap_from_data (f
, SDATA (bits
),
1189 /* It must be a string -- a file name. */
1190 bitmap_id
= x_create_bitmap_from_file (f
, name
);
1196 add_to_log ("Invalid or undefined bitmap %s", name
, Qnil
);
1207 ++npixmaps_allocated
;
1210 *w_ptr
= x_bitmap_width (f
, bitmap_id
);
1213 *h_ptr
= x_bitmap_height (f
, bitmap_id
);
1219 #endif /* HAVE_WINDOW_SYSTEM */
1223 /***********************************************************************
1225 ***********************************************************************/
1227 #ifdef HAVE_WINDOW_SYSTEM
1229 /* Load font of face FACE which is used on frame F to display
1230 character C. The name of the font to load is determined by lface
1231 and fontset of FACE. */
1234 load_face_font (f
, face
, c
)
1239 struct font_info
*font_info
= NULL
;
1241 int needs_overstrike
;
1243 face
->font_info_id
= -1;
1246 font_name
= choose_face_font (f
, face
->lface
, face
->fontset
, c
,
1252 font_info
= FS_LOAD_FACE_FONT (f
, c
, font_name
, face
);
1257 face
->font_info_id
= font_info
->font_idx
;
1258 face
->font
= font_info
->font
;
1259 face
->font_name
= font_info
->full_name
;
1260 face
->overstrike
= needs_overstrike
;
1263 x_free_gc (f
, face
->gc
);
1268 add_to_log ("Unable to load font %s",
1269 build_string (font_name
), Qnil
);
1273 #endif /* HAVE_WINDOW_SYSTEM */
1277 /***********************************************************************
1279 ***********************************************************************/
1281 /* Parse RGB_LIST, and fill in the RGB fields of COLOR.
1282 RGB_LIST should contain (at least) 3 lisp integers.
1283 Return 0 if there's a problem with RGB_LIST, otherwise return 1. */
1286 parse_rgb_list (rgb_list
, color
)
1287 Lisp_Object rgb_list
;
1290 #define PARSE_RGB_LIST_FIELD(field) \
1291 if (CONSP (rgb_list) && INTEGERP (XCAR (rgb_list))) \
1293 color->field = XINT (XCAR (rgb_list)); \
1294 rgb_list = XCDR (rgb_list); \
1299 PARSE_RGB_LIST_FIELD (red
);
1300 PARSE_RGB_LIST_FIELD (green
);
1301 PARSE_RGB_LIST_FIELD (blue
);
1307 /* Lookup on frame F the color described by the lisp string COLOR.
1308 The resulting tty color is returned in TTY_COLOR; if STD_COLOR is
1309 non-zero, then the `standard' definition of the same color is
1313 tty_lookup_color (f
, color
, tty_color
, std_color
)
1316 XColor
*tty_color
, *std_color
;
1318 Lisp_Object frame
, color_desc
;
1320 if (!STRINGP (color
) || NILP (Ffboundp (Qtty_color_desc
)))
1323 XSETFRAME (frame
, f
);
1325 color_desc
= call2 (Qtty_color_desc
, color
, frame
);
1326 if (CONSP (color_desc
) && CONSP (XCDR (color_desc
)))
1330 if (! INTEGERP (XCAR (XCDR (color_desc
))))
1333 tty_color
->pixel
= XINT (XCAR (XCDR (color_desc
)));
1335 rgb
= XCDR (XCDR (color_desc
));
1336 if (! parse_rgb_list (rgb
, tty_color
))
1339 /* Should we fill in STD_COLOR too? */
1342 /* Default STD_COLOR to the same as TTY_COLOR. */
1343 *std_color
= *tty_color
;
1345 /* Do a quick check to see if the returned descriptor is
1346 actually _exactly_ equal to COLOR, otherwise we have to
1347 lookup STD_COLOR separately. If it's impossible to lookup
1348 a standard color, we just give up and use TTY_COLOR. */
1349 if ((!STRINGP (XCAR (color_desc
))
1350 || NILP (Fstring_equal (color
, XCAR (color_desc
))))
1351 && !NILP (Ffboundp (Qtty_color_standard_values
)))
1353 /* Look up STD_COLOR separately. */
1354 rgb
= call1 (Qtty_color_standard_values
, color
);
1355 if (! parse_rgb_list (rgb
, std_color
))
1362 else if (NILP (Fsymbol_value (intern ("tty-defined-color-alist"))))
1363 /* We were called early during startup, and the colors are not
1364 yet set up in tty-defined-color-alist. Don't return a failure
1365 indication, since this produces the annoying "Unable to
1366 load color" messages in the *Messages* buffer. */
1369 /* tty-color-desc seems to have returned a bad value. */
1373 /* A version of defined_color for non-X frames. */
1376 tty_defined_color (f
, color_name
, color_def
, alloc
)
1385 color_def
->pixel
= FACE_TTY_DEFAULT_COLOR
;
1387 color_def
->blue
= 0;
1388 color_def
->green
= 0;
1391 status
= tty_lookup_color (f
, build_string (color_name
), color_def
, 0);
1393 if (color_def
->pixel
== FACE_TTY_DEFAULT_COLOR
&& *color_name
)
1395 if (strcmp (color_name
, "unspecified-fg") == 0)
1396 color_def
->pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
1397 else if (strcmp (color_name
, "unspecified-bg") == 0)
1398 color_def
->pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
1401 if (color_def
->pixel
!= FACE_TTY_DEFAULT_COLOR
)
1408 /* Decide if color named COLOR_NAME is valid for the display
1409 associated with the frame F; if so, return the rgb values in
1410 COLOR_DEF. If ALLOC is nonzero, allocate a new colormap cell.
1412 This does the right thing for any type of frame. */
1415 defined_color (f
, color_name
, color_def
, alloc
)
1421 if (!FRAME_WINDOW_P (f
))
1422 return tty_defined_color (f
, color_name
, color_def
, alloc
);
1423 #ifdef HAVE_X_WINDOWS
1424 else if (FRAME_X_P (f
))
1425 return x_defined_color (f
, color_name
, color_def
, alloc
);
1428 else if (FRAME_W32_P (f
))
1429 return w32_defined_color (f
, color_name
, color_def
, alloc
);
1432 else if (FRAME_MAC_P (f
))
1433 return mac_defined_color (f
, color_name
, color_def
, alloc
);
1440 /* Given the index IDX of a tty color on frame F, return its name, a
1444 tty_color_name (f
, idx
)
1448 if (idx
>= 0 && !NILP (Ffboundp (Qtty_color_by_index
)))
1451 Lisp_Object coldesc
;
1453 XSETFRAME (frame
, f
);
1454 coldesc
= call2 (Qtty_color_by_index
, make_number (idx
), frame
);
1456 if (!NILP (coldesc
))
1457 return XCAR (coldesc
);
1460 /* We can have an MSDOG frame under -nw for a short window of
1461 opportunity before internal_terminal_init is called. DTRT. */
1462 if (FRAME_MSDOS_P (f
) && !inhibit_window_system
)
1463 return msdos_stdcolor_name (idx
);
1466 if (idx
== FACE_TTY_DEFAULT_FG_COLOR
)
1467 return build_string (unspecified_fg
);
1468 if (idx
== FACE_TTY_DEFAULT_BG_COLOR
)
1469 return build_string (unspecified_bg
);
1472 return vga_stdcolor_name (idx
);
1475 return Qunspecified
;
1479 /* Return non-zero if COLOR_NAME is a shade of gray (or white or
1480 black) on frame F. The algorithm is taken from 20.2 faces.el. */
1483 face_color_gray_p (f
, color_name
)
1490 if (defined_color (f
, color_name
, &color
, 0))
1491 gray_p
= ((abs (color
.red
- color
.green
)
1492 < max (color
.red
, color
.green
) / 20)
1493 && (abs (color
.green
- color
.blue
)
1494 < max (color
.green
, color
.blue
) / 20)
1495 && (abs (color
.blue
- color
.red
)
1496 < max (color
.blue
, color
.red
) / 20));
1504 /* Return non-zero if color COLOR_NAME can be displayed on frame F.
1505 BACKGROUND_P non-zero means the color will be used as background
1509 face_color_supported_p (f
, color_name
, background_p
)
1517 XSETFRAME (frame
, f
);
1519 #ifdef HAVE_WINDOW_SYSTEM
1521 ? (!NILP (Fxw_display_color_p (frame
))
1522 || xstricmp (color_name
, "black") == 0
1523 || xstricmp (color_name
, "white") == 0
1525 && face_color_gray_p (f
, color_name
))
1526 || (!NILP (Fx_display_grayscale_p (frame
))
1527 && face_color_gray_p (f
, color_name
)))
1530 tty_defined_color (f
, color_name
, ¬_used
, 0);
1534 DEFUN ("color-gray-p", Fcolor_gray_p
, Scolor_gray_p
, 1, 2, 0,
1535 doc
: /* Return non-nil if COLOR is a shade of gray (or white or black).
1536 FRAME specifies the frame and thus the display for interpreting COLOR.
1537 If FRAME is nil or omitted, use the selected frame. */)
1539 Lisp_Object color
, frame
;
1543 CHECK_STRING (color
);
1545 frame
= selected_frame
;
1547 CHECK_FRAME (frame
);
1549 return face_color_gray_p (f
, SDATA (color
)) ? Qt
: Qnil
;
1553 DEFUN ("color-supported-p", Fcolor_supported_p
,
1554 Scolor_supported_p
, 1, 3, 0,
1555 doc
: /* Return non-nil if COLOR can be displayed on FRAME.
1556 BACKGROUND-P non-nil means COLOR is used as a background.
1557 Otherwise, this function tells whether it can be used as a foreground.
1558 If FRAME is nil or omitted, use the selected frame.
1559 COLOR must be a valid color name. */)
1560 (color
, frame
, background_p
)
1561 Lisp_Object frame
, color
, background_p
;
1565 CHECK_STRING (color
);
1567 frame
= selected_frame
;
1569 CHECK_FRAME (frame
);
1571 if (face_color_supported_p (f
, SDATA (color
), !NILP (background_p
)))
1577 /* Load color with name NAME for use by face FACE on frame F.
1578 TARGET_INDEX must be one of LFACE_FOREGROUND_INDEX,
1579 LFACE_BACKGROUND_INDEX, LFACE_UNDERLINE_INDEX, LFACE_OVERLINE_INDEX,
1580 LFACE_STRIKE_THROUGH_INDEX, or LFACE_BOX_INDEX. Value is the
1581 pixel color. If color cannot be loaded, display a message, and
1582 return the foreground, background or underline color of F, but
1583 record that fact in flags of the face so that we don't try to free
1587 load_color (f
, face
, name
, target_index
)
1591 enum lface_attribute_index target_index
;
1595 xassert (STRINGP (name
));
1596 xassert (target_index
== LFACE_FOREGROUND_INDEX
1597 || target_index
== LFACE_BACKGROUND_INDEX
1598 || target_index
== LFACE_UNDERLINE_INDEX
1599 || target_index
== LFACE_OVERLINE_INDEX
1600 || target_index
== LFACE_STRIKE_THROUGH_INDEX
1601 || target_index
== LFACE_BOX_INDEX
);
1603 /* if the color map is full, defined_color will return a best match
1604 to the values in an existing cell. */
1605 if (!defined_color (f
, SDATA (name
), &color
, 1))
1607 add_to_log ("Unable to load color \"%s\"", name
, Qnil
);
1609 switch (target_index
)
1611 case LFACE_FOREGROUND_INDEX
:
1612 face
->foreground_defaulted_p
= 1;
1613 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1616 case LFACE_BACKGROUND_INDEX
:
1617 face
->background_defaulted_p
= 1;
1618 color
.pixel
= FRAME_BACKGROUND_PIXEL (f
);
1621 case LFACE_UNDERLINE_INDEX
:
1622 face
->underline_defaulted_p
= 1;
1623 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1626 case LFACE_OVERLINE_INDEX
:
1627 face
->overline_color_defaulted_p
= 1;
1628 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1631 case LFACE_STRIKE_THROUGH_INDEX
:
1632 face
->strike_through_color_defaulted_p
= 1;
1633 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1636 case LFACE_BOX_INDEX
:
1637 face
->box_color_defaulted_p
= 1;
1638 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1647 ++ncolors_allocated
;
1654 #ifdef HAVE_WINDOW_SYSTEM
1656 /* Load colors for face FACE which is used on frame F. Colors are
1657 specified by slots LFACE_BACKGROUND_INDEX and LFACE_FOREGROUND_INDEX
1658 of ATTRS. If the background color specified is not supported on F,
1659 try to emulate gray colors with a stipple from Vface_default_stipple. */
1662 load_face_colors (f
, face
, attrs
)
1669 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
1670 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
1672 /* Swap colors if face is inverse-video. */
1673 if (EQ (attrs
[LFACE_INVERSE_INDEX
], Qt
))
1681 /* Check for support for foreground, not for background because
1682 face_color_supported_p is smart enough to know that grays are
1683 "supported" as background because we are supposed to use stipple
1685 if (!face_color_supported_p (f
, SDATA (bg
), 0)
1686 && !NILP (Fbitmap_spec_p (Vface_default_stipple
)))
1688 x_destroy_bitmap (f
, face
->stipple
);
1689 face
->stipple
= load_pixmap (f
, Vface_default_stipple
,
1690 &face
->pixmap_w
, &face
->pixmap_h
);
1693 face
->background
= load_color (f
, face
, bg
, LFACE_BACKGROUND_INDEX
);
1694 face
->foreground
= load_color (f
, face
, fg
, LFACE_FOREGROUND_INDEX
);
1698 /* Free color PIXEL on frame F. */
1701 unload_color (f
, pixel
)
1703 unsigned long pixel
;
1705 #ifdef HAVE_X_WINDOWS
1709 x_free_colors (f
, &pixel
, 1);
1716 /* Free colors allocated for FACE. */
1719 free_face_colors (f
, face
)
1723 #ifdef HAVE_X_WINDOWS
1724 if (face
->colors_copied_bitwise_p
)
1729 if (!face
->foreground_defaulted_p
)
1731 x_free_colors (f
, &face
->foreground
, 1);
1732 IF_DEBUG (--ncolors_allocated
);
1735 if (!face
->background_defaulted_p
)
1737 x_free_colors (f
, &face
->background
, 1);
1738 IF_DEBUG (--ncolors_allocated
);
1741 if (face
->underline_p
1742 && !face
->underline_defaulted_p
)
1744 x_free_colors (f
, &face
->underline_color
, 1);
1745 IF_DEBUG (--ncolors_allocated
);
1748 if (face
->overline_p
1749 && !face
->overline_color_defaulted_p
)
1751 x_free_colors (f
, &face
->overline_color
, 1);
1752 IF_DEBUG (--ncolors_allocated
);
1755 if (face
->strike_through_p
1756 && !face
->strike_through_color_defaulted_p
)
1758 x_free_colors (f
, &face
->strike_through_color
, 1);
1759 IF_DEBUG (--ncolors_allocated
);
1762 if (face
->box
!= FACE_NO_BOX
1763 && !face
->box_color_defaulted_p
)
1765 x_free_colors (f
, &face
->box_color
, 1);
1766 IF_DEBUG (--ncolors_allocated
);
1770 #endif /* HAVE_X_WINDOWS */
1773 #endif /* HAVE_WINDOW_SYSTEM */
1777 /***********************************************************************
1779 ***********************************************************************/
1781 /* An enumerator for each field of an XLFD font name. */
1802 /* An enumerator for each possible slant value of a font. Taken from
1803 the XLFD specification. */
1811 XLFD_SLANT_REVERSE_ITALIC
,
1812 XLFD_SLANT_REVERSE_OBLIQUE
,
1816 /* Relative font weight according to XLFD documentation. */
1820 XLFD_WEIGHT_UNKNOWN
,
1821 XLFD_WEIGHT_ULTRA_LIGHT
, /* 10 */
1822 XLFD_WEIGHT_EXTRA_LIGHT
, /* 20 */
1823 XLFD_WEIGHT_LIGHT
, /* 30 */
1824 XLFD_WEIGHT_SEMI_LIGHT
, /* 40: SemiLight, Book, ... */
1825 XLFD_WEIGHT_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1826 XLFD_WEIGHT_SEMI_BOLD
, /* 60: SemiBold, DemiBold, ... */
1827 XLFD_WEIGHT_BOLD
, /* 70: Bold, ... */
1828 XLFD_WEIGHT_EXTRA_BOLD
, /* 80: ExtraBold, Heavy, ... */
1829 XLFD_WEIGHT_ULTRA_BOLD
/* 90: UltraBold, Black, ... */
1832 /* Relative proportionate width. */
1836 XLFD_SWIDTH_UNKNOWN
,
1837 XLFD_SWIDTH_ULTRA_CONDENSED
, /* 10 */
1838 XLFD_SWIDTH_EXTRA_CONDENSED
, /* 20 */
1839 XLFD_SWIDTH_CONDENSED
, /* 30: Condensed, Narrow, Compressed, ... */
1840 XLFD_SWIDTH_SEMI_CONDENSED
, /* 40: semicondensed */
1841 XLFD_SWIDTH_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1842 XLFD_SWIDTH_SEMI_EXPANDED
, /* 60: SemiExpanded, DemiExpanded, ... */
1843 XLFD_SWIDTH_EXPANDED
, /* 70: Expanded... */
1844 XLFD_SWIDTH_EXTRA_EXPANDED
, /* 80: ExtraExpanded, Wide... */
1845 XLFD_SWIDTH_ULTRA_EXPANDED
/* 90: UltraExpanded... */
1848 /* Structure used for tables mapping XLFD weight, slant, and width
1849 names to numeric and symbolic values. */
1855 Lisp_Object
*symbol
;
1858 /* Table of XLFD slant names and their numeric and symbolic
1859 representations. This table must be sorted by slant names in
1862 static struct table_entry slant_table
[] =
1864 {"i", XLFD_SLANT_ITALIC
, &Qitalic
},
1865 {"o", XLFD_SLANT_OBLIQUE
, &Qoblique
},
1866 {"ot", XLFD_SLANT_OTHER
, &Qitalic
},
1867 {"r", XLFD_SLANT_ROMAN
, &Qnormal
},
1868 {"ri", XLFD_SLANT_REVERSE_ITALIC
, &Qreverse_italic
},
1869 {"ro", XLFD_SLANT_REVERSE_OBLIQUE
, &Qreverse_oblique
}
1872 /* Table of XLFD weight names. This table must be sorted by weight
1873 names in ascending order. */
1875 static struct table_entry weight_table
[] =
1877 {"black", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
},
1878 {"bold", XLFD_WEIGHT_BOLD
, &Qbold
},
1879 {"book", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1880 {"demi", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1881 {"demibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1882 {"extralight", XLFD_WEIGHT_EXTRA_LIGHT
, &Qextra_light
},
1883 {"extrabold", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1884 {"heavy", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1885 {"light", XLFD_WEIGHT_LIGHT
, &Qlight
},
1886 {"medium", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1887 {"normal", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1888 {"regular", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1889 {"semibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1890 {"semilight", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1891 {"ultralight", XLFD_WEIGHT_ULTRA_LIGHT
, &Qultra_light
},
1892 {"ultrabold", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
}
1895 /* Table of XLFD width names. This table must be sorted by width
1896 names in ascending order. */
1898 static struct table_entry swidth_table
[] =
1900 {"compressed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1901 {"condensed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1902 {"demiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1903 {"expanded", XLFD_SWIDTH_EXPANDED
, &Qexpanded
},
1904 {"extracondensed", XLFD_SWIDTH_EXTRA_CONDENSED
, &Qextra_condensed
},
1905 {"extraexpanded", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
},
1906 {"medium", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1907 {"narrow", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1908 {"normal", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1909 {"regular", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1910 {"semicondensed", XLFD_SWIDTH_SEMI_CONDENSED
, &Qsemi_condensed
},
1911 {"semiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1912 {"ultracondensed", XLFD_SWIDTH_ULTRA_CONDENSED
, &Qultra_condensed
},
1913 {"ultraexpanded", XLFD_SWIDTH_ULTRA_EXPANDED
, &Qultra_expanded
},
1914 {"wide", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
}
1917 /* Structure used to hold the result of splitting font names in XLFD
1918 format into their fields. */
1922 /* The original name which is modified destructively by
1923 split_font_name. The pointer is kept here to be able to free it
1924 if it was allocated from the heap. */
1927 /* Font name fields. Each vector element points into `name' above.
1928 Fields are NUL-terminated. */
1929 char *fields
[XLFD_LAST
];
1931 /* Numeric values for those fields that interest us. See
1932 split_font_name for which these are. */
1933 int numeric
[XLFD_LAST
];
1935 /* If the original name matches one of Vface_font_rescale_alist,
1936 the value is the corresponding rescale ratio. Otherwise, the
1938 double rescale_ratio
;
1940 /* Lower value mean higher priority. */
1941 int registry_priority
;
1944 /* The frame in effect when sorting font names. Set temporarily in
1945 sort_fonts so that it is available in font comparison functions. */
1947 static struct frame
*font_frame
;
1949 /* Order by which font selection chooses fonts. The default values
1950 mean `first, find a best match for the font width, then for the
1951 font height, then for weight, then for slant.' This variable can be
1952 set via set-face-font-sort-order. */
1955 static int font_sort_order
[4] = {
1956 XLFD_SWIDTH
, XLFD_POINT_SIZE
, XLFD_WEIGHT
, XLFD_SLANT
1959 static int font_sort_order
[4];
1962 /* Look up FONT.fields[FIELD_INDEX] in TABLE which has DIM entries.
1963 TABLE must be sorted by TABLE[i]->name in ascending order. Value
1964 is a pointer to the matching table entry or null if no table entry
1967 static struct table_entry
*
1968 xlfd_lookup_field_contents (table
, dim
, font
, field_index
)
1969 struct table_entry
*table
;
1971 struct font_name
*font
;
1974 /* Function split_font_name converts fields to lower-case, so there
1975 is no need to use xstrlwr or xstricmp here. */
1976 char *s
= font
->fields
[field_index
];
1977 int low
, mid
, high
, cmp
;
1984 mid
= (low
+ high
) / 2;
1985 cmp
= strcmp (table
[mid
].name
, s
);
1999 /* Return a numeric representation for font name field
2000 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
2001 has DIM entries. Value is the numeric value found or DFLT if no
2002 table entry matches. This function is used to translate weight,
2003 slant, and swidth names of XLFD font names to numeric values. */
2006 xlfd_numeric_value (table
, dim
, font
, field_index
, dflt
)
2007 struct table_entry
*table
;
2009 struct font_name
*font
;
2013 struct table_entry
*p
;
2014 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2015 return p
? p
->numeric
: dflt
;
2019 /* Return a symbolic representation for font name field
2020 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
2021 has DIM entries. Value is the symbolic value found or DFLT if no
2022 table entry matches. This function is used to translate weight,
2023 slant, and swidth names of XLFD font names to symbols. */
2025 static INLINE Lisp_Object
2026 xlfd_symbolic_value (table
, dim
, font
, field_index
, dflt
)
2027 struct table_entry
*table
;
2029 struct font_name
*font
;
2033 struct table_entry
*p
;
2034 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2035 return p
? *p
->symbol
: dflt
;
2039 /* Return a numeric value for the slant of the font given by FONT. */
2042 xlfd_numeric_slant (font
)
2043 struct font_name
*font
;
2045 return xlfd_numeric_value (slant_table
, DIM (slant_table
),
2046 font
, XLFD_SLANT
, XLFD_SLANT_ROMAN
);
2050 /* Return a symbol representing the weight of the font given by FONT. */
2052 static INLINE Lisp_Object
2053 xlfd_symbolic_slant (font
)
2054 struct font_name
*font
;
2056 return xlfd_symbolic_value (slant_table
, DIM (slant_table
),
2057 font
, XLFD_SLANT
, Qnormal
);
2061 /* Return a numeric value for the weight of the font given by FONT. */
2064 xlfd_numeric_weight (font
)
2065 struct font_name
*font
;
2067 return xlfd_numeric_value (weight_table
, DIM (weight_table
),
2068 font
, XLFD_WEIGHT
, XLFD_WEIGHT_MEDIUM
);
2072 /* Return a symbol representing the slant of the font given by FONT. */
2074 static INLINE Lisp_Object
2075 xlfd_symbolic_weight (font
)
2076 struct font_name
*font
;
2078 return xlfd_symbolic_value (weight_table
, DIM (weight_table
),
2079 font
, XLFD_WEIGHT
, Qnormal
);
2083 /* Return a numeric value for the swidth of the font whose XLFD font
2084 name fields are found in FONT. */
2087 xlfd_numeric_swidth (font
)
2088 struct font_name
*font
;
2090 return xlfd_numeric_value (swidth_table
, DIM (swidth_table
),
2091 font
, XLFD_SWIDTH
, XLFD_SWIDTH_MEDIUM
);
2095 /* Return a symbolic value for the swidth of FONT. */
2097 static INLINE Lisp_Object
2098 xlfd_symbolic_swidth (font
)
2099 struct font_name
*font
;
2101 return xlfd_symbolic_value (swidth_table
, DIM (swidth_table
),
2102 font
, XLFD_SWIDTH
, Qnormal
);
2106 /* Look up the entry of SYMBOL in the vector TABLE which has DIM
2107 entries. Value is a pointer to the matching table entry or null if
2108 no element of TABLE contains SYMBOL. */
2110 static struct table_entry
*
2111 face_value (table
, dim
, symbol
)
2112 struct table_entry
*table
;
2118 xassert (SYMBOLP (symbol
));
2120 for (i
= 0; i
< dim
; ++i
)
2121 if (EQ (*table
[i
].symbol
, symbol
))
2124 return i
< dim
? table
+ i
: NULL
;
2128 /* Return a numeric value for SYMBOL in the vector TABLE which has DIM
2129 entries. Value is -1 if SYMBOL is not found in TABLE. */
2132 face_numeric_value (table
, dim
, symbol
)
2133 struct table_entry
*table
;
2137 struct table_entry
*p
= face_value (table
, dim
, symbol
);
2138 return p
? p
->numeric
: -1;
2142 /* Return a numeric value representing the weight specified by Lisp
2143 symbol WEIGHT. Value is one of the enumerators of enum
2147 face_numeric_weight (weight
)
2150 return face_numeric_value (weight_table
, DIM (weight_table
), weight
);
2154 /* Return a numeric value representing the slant specified by Lisp
2155 symbol SLANT. Value is one of the enumerators of enum xlfd_slant. */
2158 face_numeric_slant (slant
)
2161 return face_numeric_value (slant_table
, DIM (slant_table
), slant
);
2165 /* Return a numeric value representing the swidth specified by Lisp
2166 symbol WIDTH. Value is one of the enumerators of enum xlfd_swidth. */
2169 face_numeric_swidth (width
)
2172 return face_numeric_value (swidth_table
, DIM (swidth_table
), width
);
2176 #ifdef HAVE_WINDOW_SYSTEM
2178 /* Return non-zero if FONT is the name of a fixed-pitch font. */
2182 struct font_name
*font
;
2184 /* Function split_font_name converts fields to lower-case, so there
2185 is no need to use tolower here. */
2186 return *font
->fields
[XLFD_SPACING
] != 'p';
2190 /* Return the point size of FONT on frame F, measured in 1/10 pt.
2192 The actual height of the font when displayed on F depends on the
2193 resolution of both the font and frame. For example, a 10pt font
2194 designed for a 100dpi display will display larger than 10pt on a
2195 75dpi display. (It's not unusual to use fonts not designed for the
2196 display one is using. For example, some intlfonts are available in
2197 72dpi versions, only.)
2199 Value is the real point size of FONT on frame F, or 0 if it cannot
2203 xlfd_point_size (f
, font
)
2205 struct font_name
*font
;
2207 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2208 char *pixel_field
= font
->fields
[XLFD_PIXEL_SIZE
];
2212 if (*pixel_field
== '[')
2214 /* The pixel size field is `[A B C D]' which specifies
2215 a transformation matrix.
2221 by which all glyphs of the font are transformed. The spec
2222 says that s scalar value N for the pixel size is equivalent
2223 to A = N * resx/resy, B = C = 0, D = N. */
2224 char *start
= pixel_field
+ 1, *end
;
2228 for (i
= 0; i
< 4; ++i
)
2230 matrix
[i
] = strtod (start
, &end
);
2237 pixel
= atoi (pixel_field
);
2242 real_pt
= PT_PER_INCH
* 10.0 * pixel
/ resy
+ 0.5;
2248 /* Return point size of PIXEL dots while considering Y-resultion (DPI)
2249 of frame F. This function is used to guess a point size of font
2250 when only the pixel height of the font is available. */
2253 pixel_point_size (f
, pixel
)
2257 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2261 /* As one inch is PT_PER_INCH points, PT_PER_INCH/RESY gives the
2262 point size of one dot. */
2263 real_pt
= pixel
* PT_PER_INCH
/ resy
;
2264 int_pt
= real_pt
+ 0.5;
2270 /* Return a rescaling ratio of a font of NAME. */
2273 font_rescale_ratio (name
)
2276 Lisp_Object tail
, elt
;
2278 for (tail
= Vface_font_rescale_alist
; CONSP (tail
); tail
= XCDR (tail
))
2281 if (STRINGP (XCAR (elt
)) && FLOATP (XCDR (elt
))
2282 && fast_c_string_match_ignore_case (XCAR (elt
), name
) >= 0)
2283 return XFLOAT_DATA (XCDR (elt
));
2289 /* Split XLFD font name FONT->name destructively into NUL-terminated,
2290 lower-case fields in FONT->fields. NUMERIC_P non-zero means
2291 compute numeric values for fields XLFD_POINT_SIZE, XLFD_SWIDTH,
2292 XLFD_RESY, XLFD_SLANT, and XLFD_WEIGHT in FONT->numeric. Value is
2293 zero if the font name doesn't have the format we expect. The
2294 expected format is a font name that starts with a `-' and has
2295 XLFD_LAST fields separated by `-'. */
2298 split_font_name (f
, font
, numeric_p
)
2300 struct font_name
*font
;
2305 double rescale_ratio
;
2308 /* This must be done before splitting the font name. */
2309 rescale_ratio
= font_rescale_ratio (font
->name
);
2311 if (*font
->name
== '-')
2313 char *p
= xstrlwr (font
->name
) + 1;
2315 while (i
< XLFD_LAST
)
2317 font
->fields
[i
] = p
;
2320 /* Pixel and point size may be of the form `[....]'. For
2321 BNF, see XLFD spec, chapter 4. Negative values are
2322 indicated by tilde characters which we replace with
2323 `-' characters, here. */
2325 && (i
- 1 == XLFD_PIXEL_SIZE
2326 || i
- 1 == XLFD_POINT_SIZE
))
2331 for (++p
; *p
&& *p
!= ']'; ++p
)
2335 /* Check that the matrix contains 4 floating point
2337 for (j
= 0, start
= font
->fields
[i
- 1] + 1;
2340 if (strtod (start
, &end
) == 0 && start
== end
)
2347 while (*p
&& *p
!= '-')
2357 success_p
= i
== XLFD_LAST
;
2359 /* If requested, and font name was in the expected format,
2360 compute numeric values for some fields. */
2361 if (numeric_p
&& success_p
)
2363 font
->numeric
[XLFD_POINT_SIZE
] = xlfd_point_size (f
, font
);
2364 font
->numeric
[XLFD_RESY
] = atoi (font
->fields
[XLFD_RESY
]);
2365 font
->numeric
[XLFD_SLANT
] = xlfd_numeric_slant (font
);
2366 font
->numeric
[XLFD_WEIGHT
] = xlfd_numeric_weight (font
);
2367 font
->numeric
[XLFD_SWIDTH
] = xlfd_numeric_swidth (font
);
2368 font
->numeric
[XLFD_AVGWIDTH
] = atoi (font
->fields
[XLFD_AVGWIDTH
]);
2369 font
->rescale_ratio
= rescale_ratio
;
2372 /* Initialize it to zero. It will be overridden by font_list while
2373 trying alternate registries. */
2374 font
->registry_priority
= 0;
2380 /* Build an XLFD font name from font name fields in FONT. Value is a
2381 pointer to the font name, which is allocated via xmalloc. */
2384 build_font_name (font
)
2385 struct font_name
*font
;
2389 char *font_name
= (char *) xmalloc (size
);
2390 int total_length
= 0;
2392 for (i
= 0; i
< XLFD_LAST
; ++i
)
2394 /* Add 1 because of the leading `-'. */
2395 int len
= strlen (font
->fields
[i
]) + 1;
2397 /* Reallocate font_name if necessary. Add 1 for the final
2399 if (total_length
+ len
+ 1 >= size
)
2401 int new_size
= max (2 * size
, size
+ len
+ 1);
2402 int sz
= new_size
* sizeof *font_name
;
2403 font_name
= (char *) xrealloc (font_name
, sz
);
2407 font_name
[total_length
] = '-';
2408 bcopy (font
->fields
[i
], font_name
+ total_length
+ 1, len
- 1);
2409 total_length
+= len
;
2412 font_name
[total_length
] = 0;
2417 /* Free an array FONTS of N font_name structures. This frees FONTS
2418 itself and all `name' fields in its elements. */
2421 free_font_names (fonts
, n
)
2422 struct font_name
*fonts
;
2426 xfree (fonts
[--n
].name
);
2431 /* Sort vector FONTS of font_name structures which contains NFONTS
2432 elements using qsort and comparison function CMPFN. F is the frame
2433 on which the fonts will be used. The global variable font_frame
2434 is temporarily set to F to make it available in CMPFN. */
2437 sort_fonts (f
, fonts
, nfonts
, cmpfn
)
2439 struct font_name
*fonts
;
2441 int (*cmpfn
) P_ ((const void *, const void *));
2444 qsort (fonts
, nfonts
, sizeof *fonts
, cmpfn
);
2449 /* Get fonts matching PATTERN on frame F. If F is null, use the first
2450 display in x_display_list. FONTS is a pointer to a vector of
2451 NFONTS font_name structures. TRY_ALTERNATIVES_P non-zero means try
2452 alternative patterns from Valternate_fontname_alist if no fonts are
2453 found matching PATTERN.
2455 For all fonts found, set FONTS[i].name to the name of the font,
2456 allocated via xmalloc, and split font names into fields. Ignore
2457 fonts that we can't parse. Value is the number of fonts found. */
2460 x_face_list_fonts (f
, pattern
, pfonts
, nfonts
, try_alternatives_p
)
2463 struct font_name
**pfonts
;
2464 int nfonts
, try_alternatives_p
;
2468 /* NTEMACS_TODO : currently this uses w32_list_fonts, but it may be
2469 better to do it the other way around. */
2471 Lisp_Object lpattern
, tem
;
2472 struct font_name
*fonts
= 0;
2473 int num_fonts
= nfonts
;
2476 lpattern
= build_string (pattern
);
2478 /* Get the list of fonts matching PATTERN. */
2481 lfonts
= w32_list_fonts (f
, lpattern
, 0, nfonts
);
2484 lfonts
= x_list_fonts (f
, lpattern
, -1, nfonts
);
2487 if (nfonts
< 0 && CONSP (lfonts
))
2488 num_fonts
= XFASTINT (Flength (lfonts
));
2490 /* Make a copy of the font names we got from X, and
2491 split them into fields. */
2493 for (tem
= lfonts
; CONSP (tem
) && n
< num_fonts
; tem
= XCDR (tem
))
2495 Lisp_Object elt
, tail
;
2496 const char *name
= SDATA (XCAR (tem
));
2498 /* Ignore fonts matching a pattern from face-ignored-fonts. */
2499 for (tail
= Vface_ignored_fonts
; CONSP (tail
); tail
= XCDR (tail
))
2503 && fast_c_string_match_ignore_case (elt
, name
) >= 0)
2514 *pfonts
= (struct font_name
*) xmalloc (num_fonts
* sizeof **pfonts
);
2518 /* Make a copy of the font name. */
2519 fonts
[n
].name
= xstrdup (name
);
2521 if (split_font_name (f
, fonts
+ n
, 1))
2523 if (font_scalable_p (fonts
+ n
)
2524 && !may_use_scalable_font_p (name
))
2527 xfree (fonts
[n
].name
);
2533 xfree (fonts
[n
].name
);
2536 /* If no fonts found, try patterns from Valternate_fontname_alist. */
2537 if (n
== 0 && try_alternatives_p
)
2539 Lisp_Object list
= Valternate_fontname_alist
;
2547 while (CONSP (list
))
2549 Lisp_Object entry
= XCAR (list
);
2551 && STRINGP (XCAR (entry
))
2552 && strcmp (SDATA (XCAR (entry
)), pattern
) == 0)
2559 Lisp_Object patterns
= XCAR (list
);
2562 while (CONSP (patterns
)
2563 /* If list is screwed up, give up. */
2564 && (name
= XCAR (patterns
),
2566 /* Ignore patterns equal to PATTERN because we tried that
2567 already with no success. */
2568 && (strcmp (SDATA (name
), pattern
) == 0
2569 || (n
= x_face_list_fonts (f
, SDATA (name
),
2572 patterns
= XCDR (patterns
);
2580 /* Check if a font matching pattern_offset_t on frame F is available
2581 or not. PATTERN may be a cons (FAMILY . REGISTRY), in which case,
2582 a font name pattern is generated from FAMILY and REGISTRY. */
2585 face_font_available_p (f
, pattern
)
2587 Lisp_Object pattern
;
2591 if (! STRINGP (pattern
))
2593 Lisp_Object family
, registry
;
2594 char *family_str
, *registry_str
, *pattern_str
;
2596 CHECK_CONS (pattern
);
2597 family
= XCAR (pattern
);
2602 CHECK_STRING (family
);
2603 family_str
= (char *) SDATA (family
);
2605 registry
= XCDR (pattern
);
2606 if (NILP (registry
))
2610 CHECK_STRING (registry
);
2611 registry_str
= (char *) SDATA (registry
);
2614 pattern_str
= (char *) alloca (strlen (family_str
)
2615 + strlen (registry_str
)
2617 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2618 strcat (pattern_str
, family_str
);
2619 strcat (pattern_str
, "-*-");
2620 strcat (pattern_str
, registry_str
);
2621 if (!index (registry_str
, '-'))
2623 if (registry_str
[strlen (registry_str
) - 1] == '*')
2624 strcat (pattern_str
, "-*");
2626 strcat (pattern_str
, "*-*");
2628 pattern
= build_string (pattern_str
);
2631 /* Get the list of fonts matching PATTERN. */
2634 fonts
= w32_list_fonts (f
, pattern
, 0, 1);
2637 fonts
= x_list_fonts (f
, pattern
, -1, 1);
2639 return XINT (Flength (fonts
));
2643 /* Determine fonts matching PATTERN on frame F. Sort resulting fonts
2644 using comparison function CMPFN. Value is the number of fonts
2645 found. If value is non-zero, *FONTS is set to a vector of
2646 font_name structures allocated from the heap containing matching
2647 fonts. Each element of *FONTS contains a name member that is also
2648 allocated from the heap. Font names in these structures are split
2649 into fields. Use free_font_names to free such an array. */
2652 sorted_font_list (f
, pattern
, cmpfn
, fonts
)
2655 int (*cmpfn
) P_ ((const void *, const void *));
2656 struct font_name
**fonts
;
2660 /* Get the list of fonts matching pattern. 100 should suffice. */
2661 nfonts
= DEFAULT_FONT_LIST_LIMIT
;
2662 if (INTEGERP (Vfont_list_limit
))
2663 nfonts
= XINT (Vfont_list_limit
);
2666 nfonts
= x_face_list_fonts (f
, pattern
, fonts
, nfonts
, 1);
2668 /* Sort the resulting array and return it in *FONTS. If no
2669 fonts were found, make sure to set *FONTS to null. */
2671 sort_fonts (f
, *fonts
, nfonts
, cmpfn
);
2682 /* Compare two font_name structures *A and *B. Value is analogous to
2683 strcmp. Sort order is given by the global variable
2684 font_sort_order. Font names are sorted so that, everything else
2685 being equal, fonts with a resolution closer to that of the frame on
2686 which they are used are listed first. The global variable
2687 font_frame is the frame on which we operate. */
2690 cmp_font_names (a
, b
)
2693 struct font_name
*x
= (struct font_name
*) a
;
2694 struct font_name
*y
= (struct font_name
*) b
;
2697 /* All strings have been converted to lower-case by split_font_name,
2698 so we can use strcmp here. */
2699 cmp
= strcmp (x
->fields
[XLFD_FAMILY
], y
->fields
[XLFD_FAMILY
]);
2704 for (i
= 0; i
< DIM (font_sort_order
) && cmp
== 0; ++i
)
2706 int j
= font_sort_order
[i
];
2707 cmp
= x
->numeric
[j
] - y
->numeric
[j
];
2712 /* Everything else being equal, we prefer fonts with an
2713 y-resolution closer to that of the frame. */
2714 int resy
= FRAME_X_DISPLAY_INFO (font_frame
)->resy
;
2715 int x_resy
= x
->numeric
[XLFD_RESY
];
2716 int y_resy
= y
->numeric
[XLFD_RESY
];
2717 cmp
= abs (resy
- x_resy
) - abs (resy
- y_resy
);
2725 /* Get a sorted list of fonts of family FAMILY on frame F. If PATTERN
2726 is non-nil list fonts matching that pattern. Otherwise, if
2727 REGISTRY is non-nil return only fonts with that registry, otherwise
2728 return fonts of any registry. Set *FONTS to a vector of font_name
2729 structures allocated from the heap containing the fonts found.
2730 Value is the number of fonts found. */
2733 font_list_1 (f
, pattern
, family
, registry
, fonts
)
2735 Lisp_Object pattern
, family
, registry
;
2736 struct font_name
**fonts
;
2738 char *pattern_str
, *family_str
, *registry_str
;
2742 family_str
= (NILP (family
) ? "*" : (char *) SDATA (family
));
2743 registry_str
= (NILP (registry
) ? "*" : (char *) SDATA (registry
));
2745 pattern_str
= (char *) alloca (strlen (family_str
)
2746 + strlen (registry_str
)
2748 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2749 strcat (pattern_str
, family_str
);
2750 strcat (pattern_str
, "-*-");
2751 strcat (pattern_str
, registry_str
);
2752 if (!index (registry_str
, '-'))
2754 if (registry_str
[strlen (registry_str
) - 1] == '*')
2755 strcat (pattern_str
, "-*");
2757 strcat (pattern_str
, "*-*");
2761 pattern_str
= (char *) SDATA (pattern
);
2763 return sorted_font_list (f
, pattern_str
, cmp_font_names
, fonts
);
2767 /* Concatenate font list FONTS1 and FONTS2. FONTS1 and FONTS2
2768 contains NFONTS1 fonts and NFONTS2 fonts respectively. Return a
2769 pointer to a newly allocated font list. FONTS1 and FONTS2 are
2772 static struct font_name
*
2773 concat_font_list (fonts1
, nfonts1
, fonts2
, nfonts2
)
2774 struct font_name
*fonts1
, *fonts2
;
2775 int nfonts1
, nfonts2
;
2777 int new_nfonts
= nfonts1
+ nfonts2
;
2778 struct font_name
*new_fonts
;
2780 new_fonts
= (struct font_name
*) xmalloc (sizeof *new_fonts
* new_nfonts
);
2781 bcopy (fonts1
, new_fonts
, sizeof *new_fonts
* nfonts1
);
2782 bcopy (fonts2
, new_fonts
+ nfonts1
, sizeof *new_fonts
* nfonts2
);
2789 /* Get a sorted list of fonts of family FAMILY on frame F.
2791 If PATTERN is non-nil list fonts matching that pattern.
2793 If REGISTRY is non-nil, return fonts with that registry and the
2794 alternative registries from Vface_alternative_font_registry_alist.
2796 If REGISTRY is nil return fonts of any registry.
2798 Set *FONTS to a vector of font_name structures allocated from the
2799 heap containing the fonts found. Value is the number of fonts
2803 font_list (f
, pattern
, family
, registry
, fonts
)
2805 Lisp_Object pattern
, family
, registry
;
2806 struct font_name
**fonts
;
2808 int nfonts
= font_list_1 (f
, pattern
, family
, registry
, fonts
);
2810 if (!NILP (registry
)
2811 && CONSP (Vface_alternative_font_registry_alist
))
2815 alter
= Fassoc (registry
, Vface_alternative_font_registry_alist
);
2820 for (alter
= XCDR (alter
), reg_prio
= 1;
2822 alter
= XCDR (alter
), reg_prio
++)
2823 if (STRINGP (XCAR (alter
)))
2826 struct font_name
*fonts2
;
2828 nfonts2
= font_list_1 (f
, pattern
, family
, XCAR (alter
),
2830 for (i
= 0; i
< nfonts2
; i
++)
2831 fonts2
[i
].registry_priority
= reg_prio
;
2832 *fonts
= (nfonts
> 0
2833 ? concat_font_list (*fonts
, nfonts
, fonts2
, nfonts2
)
2844 /* Remove elements from LIST whose cars are `equal'. Called from
2845 x-family-fonts and x-font-family-list to remove duplicate font
2849 remove_duplicates (list
)
2852 Lisp_Object tail
= list
;
2854 while (!NILP (tail
) && !NILP (XCDR (tail
)))
2856 Lisp_Object next
= XCDR (tail
);
2857 if (!NILP (Fequal (XCAR (next
), XCAR (tail
))))
2858 XSETCDR (tail
, XCDR (next
));
2865 DEFUN ("x-family-fonts", Fx_family_fonts
, Sx_family_fonts
, 0, 2, 0,
2866 doc
: /* Return a list of available fonts of family FAMILY on FRAME.
2867 If FAMILY is omitted or nil, list all families.
2868 Otherwise, FAMILY must be a string, possibly containing wildcards
2870 If FRAME is omitted or nil, use the selected frame.
2871 Each element of the result is a vector [FAMILY WIDTH POINT-SIZE WEIGHT
2872 SLANT FIXED-P FULL REGISTRY-AND-ENCODING].
2873 FAMILY is the font family name. POINT-SIZE is the size of the
2874 font in 1/10 pt. WIDTH, WEIGHT, and SLANT are symbols describing the
2875 width, weight and slant of the font. These symbols are the same as for
2876 face attributes. FIXED-P is non-nil if the font is fixed-pitch.
2877 FULL is the full name of the font, and REGISTRY-AND-ENCODING is a string
2878 giving the registry and encoding of the font.
2879 The result list is sorted according to the current setting of
2880 the face font sort order. */)
2882 Lisp_Object family
, frame
;
2884 struct frame
*f
= check_x_frame (frame
);
2885 struct font_name
*fonts
;
2888 struct gcpro gcpro1
;
2891 CHECK_STRING (family
);
2895 nfonts
= font_list (f
, Qnil
, family
, Qnil
, &fonts
);
2896 for (i
= nfonts
- 1; i
>= 0; --i
)
2898 Lisp_Object v
= Fmake_vector (make_number (8), Qnil
);
2901 ASET (v
, 0, build_string (fonts
[i
].fields
[XLFD_FAMILY
]));
2902 ASET (v
, 1, xlfd_symbolic_swidth (fonts
+ i
));
2903 ASET (v
, 2, make_number (xlfd_point_size (f
, fonts
+ i
)));
2904 ASET (v
, 3, xlfd_symbolic_weight (fonts
+ i
));
2905 ASET (v
, 4, xlfd_symbolic_slant (fonts
+ i
));
2906 ASET (v
, 5, xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
);
2907 tem
= build_font_name (fonts
+ i
);
2908 ASET (v
, 6, build_string (tem
));
2909 sprintf (tem
, "%s-%s", fonts
[i
].fields
[XLFD_REGISTRY
],
2910 fonts
[i
].fields
[XLFD_ENCODING
]);
2911 ASET (v
, 7, build_string (tem
));
2914 result
= Fcons (v
, result
);
2917 remove_duplicates (result
);
2918 free_font_names (fonts
, nfonts
);
2924 DEFUN ("x-font-family-list", Fx_font_family_list
, Sx_font_family_list
,
2926 doc
: /* Return a list of available font families on FRAME.
2927 If FRAME is omitted or nil, use the selected frame.
2928 Value is a list of conses (FAMILY . FIXED-P) where FAMILY
2929 is a font family, and FIXED-P is non-nil if fonts of that family
2930 are fixed-pitch. */)
2934 struct frame
*f
= check_x_frame (frame
);
2936 struct font_name
*fonts
;
2938 struct gcpro gcpro1
;
2939 int count
= SPECPDL_INDEX ();
2941 /* Let's consider all fonts. */
2942 specbind (intern ("font-list-limit"), make_number (-1));
2943 nfonts
= font_list (f
, Qnil
, Qnil
, Qnil
, &fonts
);
2947 for (i
= nfonts
- 1; i
>= 0; --i
)
2948 result
= Fcons (Fcons (build_string (fonts
[i
].fields
[XLFD_FAMILY
]),
2949 xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
),
2952 remove_duplicates (result
);
2953 free_font_names (fonts
, nfonts
);
2955 return unbind_to (count
, result
);
2959 DEFUN ("x-list-fonts", Fx_list_fonts
, Sx_list_fonts
, 1, 5, 0,
2960 doc
: /* Return a list of the names of available fonts matching PATTERN.
2961 If optional arguments FACE and FRAME are specified, return only fonts
2962 the same size as FACE on FRAME.
2963 PATTERN is a string, perhaps with wildcard characters;
2964 the * character matches any substring, and
2965 the ? character matches any single character.
2966 PATTERN is case-insensitive.
2967 FACE is a face name--a symbol.
2969 The return value is a list of strings, suitable as arguments to
2972 Fonts Emacs can't use may or may not be excluded
2973 even if they match PATTERN and FACE.
2974 The optional fourth argument MAXIMUM sets a limit on how many
2975 fonts to match. The first MAXIMUM fonts are reported.
2976 The optional fifth argument WIDTH, if specified, is a number of columns
2977 occupied by a character of a font. In that case, return only fonts
2978 the WIDTH times as wide as FACE on FRAME. */)
2979 (pattern
, face
, frame
, maximum
, width
)
2980 Lisp_Object pattern
, face
, frame
, maximum
, width
;
2987 CHECK_STRING (pattern
);
2993 CHECK_NATNUM (maximum
);
2994 maxnames
= XINT (maximum
);
2998 CHECK_NUMBER (width
);
3000 /* We can't simply call check_x_frame because this function may be
3001 called before any frame is created. */
3002 f
= frame_or_selected_frame (frame
, 2);
3003 if (!FRAME_WINDOW_P (f
))
3005 /* Perhaps we have not yet created any frame. */
3010 /* Determine the width standard for comparison with the fonts we find. */
3016 /* This is of limited utility since it works with character
3017 widths. Keep it for compatibility. --gerd. */
3018 int face_id
= lookup_named_face (f
, face
, 0, 0);
3019 struct face
*face
= (face_id
< 0
3021 : FACE_FROM_ID (f
, face_id
));
3024 /* For historic reasons, FONT_WIDTH refers to average width on W32,
3025 not maximum as on X. Redefine here. */
3027 #define FONT_WIDTH FONT_MAX_WIDTH
3030 if (face
&& face
->font
)
3031 size
= FONT_WIDTH (face
->font
);
3033 size
= FONT_WIDTH (FRAME_FONT (f
)); /* FRAME_COLUMN_WIDTH (f) */
3036 size
*= XINT (width
);
3040 Lisp_Object args
[2];
3042 args
[0] = x_list_fonts (f
, pattern
, size
, maxnames
);
3044 /* We don't have to check fontsets. */
3046 args
[1] = list_fontsets (f
, pattern
, size
);
3047 return Fnconc (2, args
);
3051 #endif /* HAVE_WINDOW_SYSTEM */
3055 /***********************************************************************
3057 ***********************************************************************/
3059 /* Access face attributes of face LFACE, a Lisp vector. */
3061 #define LFACE_FAMILY(LFACE) AREF ((LFACE), LFACE_FAMILY_INDEX)
3062 #define LFACE_HEIGHT(LFACE) AREF ((LFACE), LFACE_HEIGHT_INDEX)
3063 #define LFACE_WEIGHT(LFACE) AREF ((LFACE), LFACE_WEIGHT_INDEX)
3064 #define LFACE_SLANT(LFACE) AREF ((LFACE), LFACE_SLANT_INDEX)
3065 #define LFACE_UNDERLINE(LFACE) AREF ((LFACE), LFACE_UNDERLINE_INDEX)
3066 #define LFACE_INVERSE(LFACE) AREF ((LFACE), LFACE_INVERSE_INDEX)
3067 #define LFACE_FOREGROUND(LFACE) AREF ((LFACE), LFACE_FOREGROUND_INDEX)
3068 #define LFACE_BACKGROUND(LFACE) AREF ((LFACE), LFACE_BACKGROUND_INDEX)
3069 #define LFACE_STIPPLE(LFACE) AREF ((LFACE), LFACE_STIPPLE_INDEX)
3070 #define LFACE_SWIDTH(LFACE) AREF ((LFACE), LFACE_SWIDTH_INDEX)
3071 #define LFACE_OVERLINE(LFACE) AREF ((LFACE), LFACE_OVERLINE_INDEX)
3072 #define LFACE_STRIKE_THROUGH(LFACE) AREF ((LFACE), LFACE_STRIKE_THROUGH_INDEX)
3073 #define LFACE_BOX(LFACE) AREF ((LFACE), LFACE_BOX_INDEX)
3074 #define LFACE_FONT(LFACE) AREF ((LFACE), LFACE_FONT_INDEX)
3075 #define LFACE_INHERIT(LFACE) AREF ((LFACE), LFACE_INHERIT_INDEX)
3076 #define LFACE_AVGWIDTH(LFACE) AREF ((LFACE), LFACE_AVGWIDTH_INDEX)
3078 /* Non-zero if LFACE is a Lisp face. A Lisp face is a vector of size
3079 LFACE_VECTOR_SIZE which has the symbol `face' in slot 0. */
3081 #define LFACEP(LFACE) \
3083 && XVECTOR (LFACE)->size == LFACE_VECTOR_SIZE \
3084 && EQ (AREF (LFACE, 0), Qface))
3089 /* Check consistency of Lisp face attribute vector ATTRS. */
3092 check_lface_attrs (attrs
)
3095 xassert (UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
3096 || STRINGP (attrs
[LFACE_FAMILY_INDEX
]));
3097 xassert (UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
3098 || SYMBOLP (attrs
[LFACE_SWIDTH_INDEX
]));
3099 xassert (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
3100 || INTEGERP (attrs
[LFACE_AVGWIDTH_INDEX
]));
3101 xassert (UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
3102 || INTEGERP (attrs
[LFACE_HEIGHT_INDEX
])
3103 || FLOATP (attrs
[LFACE_HEIGHT_INDEX
])
3104 || FUNCTIONP (attrs
[LFACE_HEIGHT_INDEX
]));
3105 xassert (UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
3106 || SYMBOLP (attrs
[LFACE_WEIGHT_INDEX
]));
3107 xassert (UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
3108 || SYMBOLP (attrs
[LFACE_SLANT_INDEX
]));
3109 xassert (UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
3110 || SYMBOLP (attrs
[LFACE_UNDERLINE_INDEX
])
3111 || STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]));
3112 xassert (UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
3113 || SYMBOLP (attrs
[LFACE_OVERLINE_INDEX
])
3114 || STRINGP (attrs
[LFACE_OVERLINE_INDEX
]));
3115 xassert (UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3116 || SYMBOLP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3117 || STRINGP (attrs
[LFACE_STRIKE_THROUGH_INDEX
]));
3118 xassert (UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
3119 || SYMBOLP (attrs
[LFACE_BOX_INDEX
])
3120 || STRINGP (attrs
[LFACE_BOX_INDEX
])
3121 || INTEGERP (attrs
[LFACE_BOX_INDEX
])
3122 || CONSP (attrs
[LFACE_BOX_INDEX
]));
3123 xassert (UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
3124 || SYMBOLP (attrs
[LFACE_INVERSE_INDEX
]));
3125 xassert (UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
3126 || STRINGP (attrs
[LFACE_FOREGROUND_INDEX
]));
3127 xassert (UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
3128 || STRINGP (attrs
[LFACE_BACKGROUND_INDEX
]));
3129 xassert (UNSPECIFIEDP (attrs
[LFACE_INHERIT_INDEX
])
3130 || NILP (attrs
[LFACE_INHERIT_INDEX
])
3131 || SYMBOLP (attrs
[LFACE_INHERIT_INDEX
])
3132 || CONSP (attrs
[LFACE_INHERIT_INDEX
]));
3133 #ifdef HAVE_WINDOW_SYSTEM
3134 xassert (UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
3135 || SYMBOLP (attrs
[LFACE_STIPPLE_INDEX
])
3136 || !NILP (Fbitmap_spec_p (attrs
[LFACE_STIPPLE_INDEX
])));
3137 xassert (UNSPECIFIEDP (attrs
[LFACE_FONT_INDEX
])
3138 || NILP (attrs
[LFACE_FONT_INDEX
])
3139 || STRINGP (attrs
[LFACE_FONT_INDEX
]));
3144 /* Check consistency of attributes of Lisp face LFACE (a Lisp vector). */
3152 xassert (LFACEP (lface
));
3153 check_lface_attrs (XVECTOR (lface
)->contents
);
3157 #else /* GLYPH_DEBUG == 0 */
3159 #define check_lface_attrs(attrs) (void) 0
3160 #define check_lface(lface) (void) 0
3162 #endif /* GLYPH_DEBUG == 0 */
3166 /* Face-merge cycle checking. */
3168 /* A `named merge point' is simply a point during face-merging where we
3169 look up a face by name. We keep a stack of which named lookups we're
3170 currently processing so that we can easily detect cycles, using a
3171 linked- list of struct named_merge_point structures, typically
3172 allocated on the stack frame of the named lookup functions which are
3173 active (so no consing is required). */
3174 struct named_merge_point
3176 Lisp_Object face_name
;
3177 struct named_merge_point
*prev
;
3181 /* If a face merging cycle is detected for FACE_NAME, return 0,
3182 otherwise add NEW_NAMED_MERGE_POINT, which is initialized using
3183 FACE_NAME, as the head of the linked list pointed to by
3184 NAMED_MERGE_POINTS, and return 1. */
3187 push_named_merge_point (struct named_merge_point
*new_named_merge_point
,
3188 Lisp_Object face_name
,
3189 struct named_merge_point
**named_merge_points
)
3191 struct named_merge_point
*prev
;
3193 for (prev
= *named_merge_points
; prev
; prev
= prev
->prev
)
3194 if (EQ (face_name
, prev
->face_name
))
3197 new_named_merge_point
->face_name
= face_name
;
3198 new_named_merge_point
->prev
= *named_merge_points
;
3200 *named_merge_points
= new_named_merge_point
;
3208 internal_resolve_face_name (nargs
, args
)
3212 Fget (args
[0], args
[1]);
3216 resolve_face_name_error (ignore
)
3222 /* Resolve face name FACE_NAME. If FACE_NAME is a string, intern it
3223 to make it a symbol. If FACE_NAME is an alias for another face,
3224 return that face's name.
3226 Return default face in case of errors. */
3229 resolve_face_name (face_name
, signal_p
)
3230 Lisp_Object face_name
;
3233 Lisp_Object orig_face
;
3234 Lisp_Object tortoise
, hare
;
3236 if (STRINGP (face_name
))
3237 face_name
= intern (SDATA (face_name
));
3239 if (NILP (face_name
) || !SYMBOLP (face_name
))
3242 orig_face
= face_name
;
3243 tortoise
= hare
= face_name
;
3248 hare
= Fget (hare
, Qface_alias
);
3249 if (NILP (hare
) || !SYMBOLP (hare
))
3253 hare
= Fget (hare
, Qface_alias
);
3254 if (NILP (hare
) || !SYMBOLP (hare
))
3257 tortoise
= Fget (tortoise
, Qface_alias
);
3258 if (EQ (hare
, tortoise
))
3261 Fsignal (Qcircular_list
, Fcons (orig_face
, Qnil
));
3270 /* Return the face definition of FACE_NAME on frame F. F null means
3271 return the definition for new frames. FACE_NAME may be a string or
3272 a symbol (apparently Emacs 20.2 allowed strings as face names in
3273 face text properties; Ediff uses that). If FACE_NAME is an alias
3274 for another face, return that face's definition. If SIGNAL_P is
3275 non-zero, signal an error if FACE_NAME is not a valid face name.
3276 If SIGNAL_P is zero, value is nil if FACE_NAME is not a valid face
3279 static INLINE Lisp_Object
3280 lface_from_face_name (f
, face_name
, signal_p
)
3282 Lisp_Object face_name
;
3287 face_name
= resolve_face_name (face_name
, signal_p
);
3290 lface
= assq_no_quit (face_name
, f
->face_alist
);
3292 lface
= assq_no_quit (face_name
, Vface_new_frame_defaults
);
3295 lface
= XCDR (lface
);
3297 signal_error ("Invalid face", face_name
);
3299 check_lface (lface
);
3304 /* Get face attributes of face FACE_NAME from frame-local faces on
3305 frame F. Store the resulting attributes in ATTRS which must point
3306 to a vector of Lisp_Objects of size LFACE_VECTOR_SIZE. If SIGNAL_P
3307 is non-zero, signal an error if FACE_NAME does not name a face.
3308 Otherwise, value is zero if FACE_NAME is not a face. */
3311 get_lface_attributes (f
, face_name
, attrs
, signal_p
)
3313 Lisp_Object face_name
;
3320 lface
= lface_from_face_name (f
, face_name
, signal_p
);
3323 bcopy (XVECTOR (lface
)->contents
, attrs
,
3324 LFACE_VECTOR_SIZE
* sizeof *attrs
);
3334 /* Non-zero if all attributes in face attribute vector ATTRS are
3335 specified, i.e. are non-nil. */
3338 lface_fully_specified_p (attrs
)
3343 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3344 if (i
!= LFACE_FONT_INDEX
&& i
!= LFACE_INHERIT_INDEX
3345 && i
!= LFACE_AVGWIDTH_INDEX
)
3346 if (UNSPECIFIEDP (attrs
[i
])
3348 /* MAC_TODO: No stipple support on Mac OS yet, this index is
3349 always unspecified. */
3350 && i
!= LFACE_STIPPLE_INDEX
3355 return i
== LFACE_VECTOR_SIZE
;
3358 #ifdef HAVE_WINDOW_SYSTEM
3360 /* Set font-related attributes of Lisp face LFACE from the fullname of
3361 the font opened by FONTNAME. If FORCE_P is zero, set only
3362 unspecified attributes of LFACE. The exception is `font'
3363 attribute. It is set to FONTNAME as is regardless of FORCE_P.
3365 If FONTNAME is not available on frame F,
3366 return 0 if MAY_FAIL_P is non-zero, otherwise abort.
3367 If the fullname is not in a valid XLFD format,
3368 return 0 if MAY_FAIL_P is non-zero, otherwise set normal values
3369 in LFACE and return 1.
3370 Otherwise, return 1. */
3373 set_lface_from_font_name (f
, lface
, fontname
, force_p
, may_fail_p
)
3376 Lisp_Object fontname
;
3377 int force_p
, may_fail_p
;
3379 struct font_name font
;
3384 char *font_name
= SDATA (fontname
);
3385 struct font_info
*font_info
;
3387 /* If FONTNAME is actually a fontset name, get ASCII font name of it. */
3388 fontset
= fs_query_fontset (fontname
, 0);
3390 font_name
= SDATA (fontset_ascii (fontset
));
3392 /* Check if FONT_NAME is surely available on the system. Usually
3393 FONT_NAME is already cached for the frame F and FS_LOAD_FONT
3394 returns quickly. But, even if FONT_NAME is not yet cached,
3395 caching it now is not futail because we anyway load the font
3398 font_info
= FS_LOAD_FONT (f
, 0, font_name
, -1);
3408 font
.name
= STRDUPA (font_info
->full_name
);
3409 have_xlfd_p
= split_font_name (f
, &font
, 1);
3411 /* Set attributes only if unspecified, otherwise face defaults for
3412 new frames would never take effect. If we couldn't get a font
3413 name conforming to XLFD, set normal values. */
3415 if (force_p
|| UNSPECIFIEDP (LFACE_FAMILY (lface
)))
3420 buffer
= (char *) alloca (strlen (font
.fields
[XLFD_FAMILY
])
3421 + strlen (font
.fields
[XLFD_FOUNDRY
])
3423 sprintf (buffer
, "%s-%s", font
.fields
[XLFD_FOUNDRY
],
3424 font
.fields
[XLFD_FAMILY
]);
3425 val
= build_string (buffer
);
3428 val
= build_string ("*");
3429 LFACE_FAMILY (lface
) = val
;
3432 if (force_p
|| UNSPECIFIEDP (LFACE_HEIGHT (lface
)))
3435 pt
= xlfd_point_size (f
, &font
);
3437 pt
= pixel_point_size (f
, font_info
->height
* 10);
3439 LFACE_HEIGHT (lface
) = make_number (pt
);
3442 if (force_p
|| UNSPECIFIEDP (LFACE_SWIDTH (lface
)))
3443 LFACE_SWIDTH (lface
)
3444 = have_xlfd_p
? xlfd_symbolic_swidth (&font
) : Qnormal
;
3446 if (force_p
|| UNSPECIFIEDP (LFACE_AVGWIDTH (lface
)))
3447 LFACE_AVGWIDTH (lface
)
3449 ? make_number (font
.numeric
[XLFD_AVGWIDTH
])
3452 if (force_p
|| UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
3453 LFACE_WEIGHT (lface
)
3454 = have_xlfd_p
? xlfd_symbolic_weight (&font
) : Qnormal
;
3456 if (force_p
|| UNSPECIFIEDP (LFACE_SLANT (lface
)))
3458 = have_xlfd_p
? xlfd_symbolic_slant (&font
) : Qnormal
;
3460 LFACE_FONT (lface
) = fontname
;
3465 #endif /* HAVE_WINDOW_SYSTEM */
3468 /* Merges the face height FROM with the face height TO, and returns the
3469 merged height. If FROM is an invalid height, then INVALID is
3470 returned instead. FROM and TO may be either absolute face heights or
3471 `relative' heights; the returned value is always an absolute height
3472 unless both FROM and TO are relative. GCPRO is a lisp value that
3473 will be protected from garbage-collection if this function makes a
3477 merge_face_heights (from
, to
, invalid
)
3478 Lisp_Object from
, to
, invalid
;
3480 Lisp_Object result
= invalid
;
3482 if (INTEGERP (from
))
3483 /* FROM is absolute, just use it as is. */
3485 else if (FLOATP (from
))
3486 /* FROM is a scale, use it to adjust TO. */
3489 /* relative X absolute => absolute */
3490 result
= make_number ((EMACS_INT
)(XFLOAT_DATA (from
) * XINT (to
)));
3491 else if (FLOATP (to
))
3492 /* relative X relative => relative */
3493 result
= make_float (XFLOAT_DATA (from
) * XFLOAT_DATA (to
));
3494 else if (UNSPECIFIEDP (to
))
3497 else if (FUNCTIONP (from
))
3498 /* FROM is a function, which use to adjust TO. */
3500 /* Call function with current height as argument.
3501 From is the new height. */
3502 Lisp_Object args
[2];
3506 result
= safe_call (2, args
);
3508 /* Ensure that if TO was absolute, so is the result. */
3509 if (INTEGERP (to
) && !INTEGERP (result
))
3517 /* Merge two Lisp face attribute vectors on frame F, FROM and TO, and
3518 store the resulting attributes in TO, which must be already be
3519 completely specified and contain only absolute attributes. Every
3520 specified attribute of FROM overrides the corresponding attribute of
3521 TO; relative attributes in FROM are merged with the absolute value in
3522 TO and replace it. NAMED_MERGE_POINTS is used internally to detect
3523 loops in face inheritance; it should be 0 when called from other
3527 merge_face_vectors (f
, from
, to
, named_merge_points
)
3529 Lisp_Object
*from
, *to
;
3530 struct named_merge_point
*named_merge_points
;
3534 /* If FROM inherits from some other faces, merge their attributes into
3535 TO before merging FROM's direct attributes. Note that an :inherit
3536 attribute of `unspecified' is the same as one of nil; we never
3537 merge :inherit attributes, so nil is more correct, but lots of
3538 other code uses `unspecified' as a generic value for face attributes. */
3539 if (!UNSPECIFIEDP (from
[LFACE_INHERIT_INDEX
])
3540 && !NILP (from
[LFACE_INHERIT_INDEX
]))
3541 merge_face_ref (f
, from
[LFACE_INHERIT_INDEX
], to
, 0, named_merge_points
);
3543 /* If TO specifies a :font attribute, and FROM specifies some
3544 font-related attribute, we need to clear TO's :font attribute
3545 (because it will be inconsistent with whatever FROM specifies, and
3546 FROM takes precedence). */
3547 if (!NILP (to
[LFACE_FONT_INDEX
])
3548 && (!UNSPECIFIEDP (from
[LFACE_FAMILY_INDEX
])
3549 || !UNSPECIFIEDP (from
[LFACE_HEIGHT_INDEX
])
3550 || !UNSPECIFIEDP (from
[LFACE_WEIGHT_INDEX
])
3551 || !UNSPECIFIEDP (from
[LFACE_SLANT_INDEX
])
3552 || !UNSPECIFIEDP (from
[LFACE_SWIDTH_INDEX
])
3553 || !UNSPECIFIEDP (from
[LFACE_AVGWIDTH_INDEX
])))
3554 to
[LFACE_FONT_INDEX
] = Qnil
;
3556 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3557 if (!UNSPECIFIEDP (from
[i
]))
3559 if (i
== LFACE_HEIGHT_INDEX
&& !INTEGERP (from
[i
]))
3560 to
[i
] = merge_face_heights (from
[i
], to
[i
], to
[i
]);
3565 /* TO is always an absolute face, which should inherit from nothing.
3566 We blindly copy the :inherit attribute above and fix it up here. */
3567 to
[LFACE_INHERIT_INDEX
] = Qnil
;
3570 /* Merge the named face FACE_NAME on frame F, into the vector of face
3571 attributes TO. NAMED_MERGE_POINTS is used to detect loops in face
3572 inheritance. Returns true if FACE_NAME is a valid face name and
3573 merging succeeded. */
3576 merge_named_face (f
, face_name
, to
, named_merge_points
)
3578 Lisp_Object face_name
;
3580 struct named_merge_point
*named_merge_points
;
3582 struct named_merge_point named_merge_point
;
3584 if (push_named_merge_point (&named_merge_point
,
3585 face_name
, &named_merge_points
))
3587 struct gcpro gcpro1
;
3588 Lisp_Object from
[LFACE_VECTOR_SIZE
];
3589 int ok
= get_lface_attributes (f
, face_name
, from
, 0);
3593 GCPRO1 (named_merge_point
.face_name
);
3594 merge_face_vectors (f
, from
, to
, named_merge_points
);
3605 /* Merge face attributes from the lisp `face reference' FACE_REF on
3606 frame F into the face attribute vector TO. If ERR_MSGS is non-zero,
3607 problems with FACE_REF cause an error message to be shown. Return
3608 non-zero if no errors occurred (regardless of the value of ERR_MSGS).
3609 NAMED_MERGE_POINTS is used to detect loops in face inheritance or
3610 list structure; it may be 0 for most callers.
3612 FACE_REF may be a single face specification or a list of such
3613 specifications. Each face specification can be:
3615 1. A symbol or string naming a Lisp face.
3617 2. A property list of the form (KEYWORD VALUE ...) where each
3618 KEYWORD is a face attribute name, and value is an appropriate value
3621 3. Conses or the form (FOREGROUND-COLOR . COLOR) or
3622 (BACKGROUND-COLOR . COLOR) where COLOR is a color name. This is
3623 for compatibility with 20.2.
3625 Face specifications earlier in lists take precedence over later
3629 merge_face_ref (f
, face_ref
, to
, err_msgs
, named_merge_points
)
3631 Lisp_Object face_ref
;
3634 struct named_merge_point
*named_merge_points
;
3636 int ok
= 1; /* Succeed without an error? */
3638 if (CONSP (face_ref
))
3640 Lisp_Object first
= XCAR (face_ref
);
3642 if (EQ (first
, Qforeground_color
)
3643 || EQ (first
, Qbackground_color
))
3645 /* One of (FOREGROUND-COLOR . COLOR) or (BACKGROUND-COLOR
3646 . COLOR). COLOR must be a string. */
3647 Lisp_Object color_name
= XCDR (face_ref
);
3648 Lisp_Object color
= first
;
3650 if (STRINGP (color_name
))
3652 if (EQ (color
, Qforeground_color
))
3653 to
[LFACE_FOREGROUND_INDEX
] = color_name
;
3655 to
[LFACE_BACKGROUND_INDEX
] = color_name
;
3660 add_to_log ("Invalid face color", color_name
, Qnil
);
3664 else if (SYMBOLP (first
)
3665 && *SDATA (SYMBOL_NAME (first
)) == ':')
3667 /* Assume this is the property list form. */
3668 while (CONSP (face_ref
) && CONSP (XCDR (face_ref
)))
3670 Lisp_Object keyword
= XCAR (face_ref
);
3671 Lisp_Object value
= XCAR (XCDR (face_ref
));
3674 /* Specifying `unspecified' is a no-op. */
3675 if (EQ (value
, Qunspecified
))
3677 else if (EQ (keyword
, QCfamily
))
3679 if (STRINGP (value
))
3680 to
[LFACE_FAMILY_INDEX
] = value
;
3684 else if (EQ (keyword
, QCheight
))
3686 Lisp_Object new_height
=
3687 merge_face_heights (value
, to
[LFACE_HEIGHT_INDEX
], Qnil
);
3689 if (! NILP (new_height
))
3690 to
[LFACE_HEIGHT_INDEX
] = new_height
;
3694 else if (EQ (keyword
, QCweight
))
3697 && face_numeric_weight (value
) >= 0)
3698 to
[LFACE_WEIGHT_INDEX
] = value
;
3702 else if (EQ (keyword
, QCslant
))
3705 && face_numeric_slant (value
) >= 0)
3706 to
[LFACE_SLANT_INDEX
] = value
;
3710 else if (EQ (keyword
, QCunderline
))
3715 to
[LFACE_UNDERLINE_INDEX
] = value
;
3719 else if (EQ (keyword
, QCoverline
))
3724 to
[LFACE_OVERLINE_INDEX
] = value
;
3728 else if (EQ (keyword
, QCstrike_through
))
3733 to
[LFACE_STRIKE_THROUGH_INDEX
] = value
;
3737 else if (EQ (keyword
, QCbox
))
3740 value
= make_number (1);
3741 if (INTEGERP (value
)
3745 to
[LFACE_BOX_INDEX
] = value
;
3749 else if (EQ (keyword
, QCinverse_video
)
3750 || EQ (keyword
, QCreverse_video
))
3752 if (EQ (value
, Qt
) || NILP (value
))
3753 to
[LFACE_INVERSE_INDEX
] = value
;
3757 else if (EQ (keyword
, QCforeground
))
3759 if (STRINGP (value
))
3760 to
[LFACE_FOREGROUND_INDEX
] = value
;
3764 else if (EQ (keyword
, QCbackground
))
3766 if (STRINGP (value
))
3767 to
[LFACE_BACKGROUND_INDEX
] = value
;
3771 else if (EQ (keyword
, QCstipple
))
3773 #ifdef HAVE_X_WINDOWS
3774 Lisp_Object pixmap_p
= Fbitmap_spec_p (value
);
3775 if (!NILP (pixmap_p
))
3776 to
[LFACE_STIPPLE_INDEX
] = value
;
3781 else if (EQ (keyword
, QCwidth
))
3784 && face_numeric_swidth (value
) >= 0)
3785 to
[LFACE_SWIDTH_INDEX
] = value
;
3789 else if (EQ (keyword
, QCinherit
))
3791 /* This is not really very useful; it's just like a
3792 normal face reference. */
3793 if (! merge_face_ref (f
, value
, to
,
3794 err_msgs
, named_merge_points
))
3802 add_to_log ("Invalid face attribute %S %S", keyword
, value
);
3806 face_ref
= XCDR (XCDR (face_ref
));
3811 /* This is a list of face refs. Those at the beginning of the
3812 list take precedence over what follows, so we have to merge
3813 from the end backwards. */
3814 Lisp_Object next
= XCDR (face_ref
);
3817 ok
= merge_face_ref (f
, next
, to
, err_msgs
, named_merge_points
);
3819 if (! merge_face_ref (f
, first
, to
, err_msgs
, named_merge_points
))
3825 /* FACE_REF ought to be a face name. */
3826 ok
= merge_named_face (f
, face_ref
, to
, named_merge_points
);
3827 if (!ok
&& err_msgs
)
3828 add_to_log ("Invalid face reference: %s", face_ref
, Qnil
);
3835 DEFUN ("internal-make-lisp-face", Finternal_make_lisp_face
,
3836 Sinternal_make_lisp_face
, 1, 2, 0,
3837 doc
: /* Make FACE, a symbol, a Lisp face with all attributes nil.
3838 If FACE was not known as a face before, create a new one.
3839 If optional argument FRAME is specified, make a frame-local face
3840 for that frame. Otherwise operate on the global face definition.
3841 Value is a vector of face attributes. */)
3843 Lisp_Object face
, frame
;
3845 Lisp_Object global_lface
, lface
;
3849 CHECK_SYMBOL (face
);
3850 global_lface
= lface_from_face_name (NULL
, face
, 0);
3854 CHECK_LIVE_FRAME (frame
);
3856 lface
= lface_from_face_name (f
, face
, 0);
3859 f
= NULL
, lface
= Qnil
;
3861 /* Add a global definition if there is none. */
3862 if (NILP (global_lface
))
3864 global_lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
3866 AREF (global_lface
, 0) = Qface
;
3867 Vface_new_frame_defaults
= Fcons (Fcons (face
, global_lface
),
3868 Vface_new_frame_defaults
);
3870 /* Assign the new Lisp face a unique ID. The mapping from Lisp
3871 face id to Lisp face is given by the vector lface_id_to_name.
3872 The mapping from Lisp face to Lisp face id is given by the
3873 property `face' of the Lisp face name. */
3874 if (next_lface_id
== lface_id_to_name_size
)
3876 int new_size
= max (50, 2 * lface_id_to_name_size
);
3877 int sz
= new_size
* sizeof *lface_id_to_name
;
3878 lface_id_to_name
= (Lisp_Object
*) xrealloc (lface_id_to_name
, sz
);
3879 lface_id_to_name_size
= new_size
;
3882 lface_id_to_name
[next_lface_id
] = face
;
3883 Fput (face
, Qface
, make_number (next_lface_id
));
3887 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3888 AREF (global_lface
, i
) = Qunspecified
;
3890 /* Add a frame-local definition. */
3895 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
3897 AREF (lface
, 0) = Qface
;
3898 f
->face_alist
= Fcons (Fcons (face
, lface
), f
->face_alist
);
3901 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3902 AREF (lface
, i
) = Qunspecified
;
3905 lface
= global_lface
;
3907 /* Changing a named face means that all realized faces depending on
3908 that face are invalid. Since we cannot tell which realized faces
3909 depend on the face, make sure they are all removed. This is done
3910 by incrementing face_change_count. The next call to
3911 init_iterator will then free realized faces. */
3912 if (NILP (Fget (face
, Qface_no_inherit
)))
3914 ++face_change_count
;
3915 ++windows_or_buffers_changed
;
3918 xassert (LFACEP (lface
));
3919 check_lface (lface
);
3924 DEFUN ("internal-lisp-face-p", Finternal_lisp_face_p
,
3925 Sinternal_lisp_face_p
, 1, 2, 0,
3926 doc
: /* Return non-nil if FACE names a face.
3927 If optional second argument FRAME is non-nil, check for the
3928 existence of a frame-local face with name FACE on that frame.
3929 Otherwise check for the existence of a global face. */)
3931 Lisp_Object face
, frame
;
3937 CHECK_LIVE_FRAME (frame
);
3938 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
3941 lface
= lface_from_face_name (NULL
, face
, 0);
3947 DEFUN ("internal-copy-lisp-face", Finternal_copy_lisp_face
,
3948 Sinternal_copy_lisp_face
, 4, 4, 0,
3949 doc
: /* Copy face FROM to TO.
3950 If FRAME is t, copy the global face definition of FROM.
3951 Otherwise, copy the frame-local definition of FROM on FRAME.
3952 If NEW-FRAME is a frame, copy that data into the frame-local
3953 definition of TO on NEW-FRAME. If NEW-FRAME is nil.
3954 FRAME controls where the data is copied to.
3956 The value is TO. */)
3957 (from
, to
, frame
, new_frame
)
3958 Lisp_Object from
, to
, frame
, new_frame
;
3960 Lisp_Object lface
, copy
;
3962 CHECK_SYMBOL (from
);
3967 /* Copy global definition of FROM. We don't make copies of
3968 strings etc. because 20.2 didn't do it either. */
3969 lface
= lface_from_face_name (NULL
, from
, 1);
3970 copy
= Finternal_make_lisp_face (to
, Qnil
);
3974 /* Copy frame-local definition of FROM. */
3975 if (NILP (new_frame
))
3977 CHECK_LIVE_FRAME (frame
);
3978 CHECK_LIVE_FRAME (new_frame
);
3979 lface
= lface_from_face_name (XFRAME (frame
), from
, 1);
3980 copy
= Finternal_make_lisp_face (to
, new_frame
);
3983 bcopy (XVECTOR (lface
)->contents
, XVECTOR (copy
)->contents
,
3984 LFACE_VECTOR_SIZE
* sizeof (Lisp_Object
));
3986 /* Changing a named face means that all realized faces depending on
3987 that face are invalid. Since we cannot tell which realized faces
3988 depend on the face, make sure they are all removed. This is done
3989 by incrementing face_change_count. The next call to
3990 init_iterator will then free realized faces. */
3991 if (NILP (Fget (to
, Qface_no_inherit
)))
3993 ++face_change_count
;
3994 ++windows_or_buffers_changed
;
4001 DEFUN ("internal-set-lisp-face-attribute", Finternal_set_lisp_face_attribute
,
4002 Sinternal_set_lisp_face_attribute
, 3, 4, 0,
4003 doc
: /* Set attribute ATTR of FACE to VALUE.
4004 FRAME being a frame means change the face on that frame.
4005 FRAME nil means change the face of the selected frame.
4006 FRAME t means change the default for new frames.
4007 FRAME 0 means change the face on all frames, and change the default
4009 (face
, attr
, value
, frame
)
4010 Lisp_Object face
, attr
, value
, frame
;
4013 Lisp_Object old_value
= Qnil
;
4014 /* Set 1 if ATTR is QCfont. */
4015 int font_attr_p
= 0;
4016 /* Set 1 if ATTR is one of font-related attributes other than QCfont. */
4017 int font_related_attr_p
= 0;
4019 CHECK_SYMBOL (face
);
4020 CHECK_SYMBOL (attr
);
4022 face
= resolve_face_name (face
, 1);
4024 /* If FRAME is 0, change face on all frames, and change the
4025 default for new frames. */
4026 if (INTEGERP (frame
) && XINT (frame
) == 0)
4029 Finternal_set_lisp_face_attribute (face
, attr
, value
, Qt
);
4030 FOR_EACH_FRAME (tail
, frame
)
4031 Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
4035 /* Set lface to the Lisp attribute vector of FACE. */
4037 lface
= lface_from_face_name (NULL
, face
, 1);
4041 frame
= selected_frame
;
4043 CHECK_LIVE_FRAME (frame
);
4044 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
4046 /* If a frame-local face doesn't exist yet, create one. */
4048 lface
= Finternal_make_lisp_face (face
, frame
);
4051 if (EQ (attr
, QCfamily
))
4053 if (!UNSPECIFIEDP (value
))
4055 CHECK_STRING (value
);
4056 if (SCHARS (value
) == 0)
4057 signal_error ("Invalid face family", value
);
4059 old_value
= LFACE_FAMILY (lface
);
4060 LFACE_FAMILY (lface
) = value
;
4061 font_related_attr_p
= 1;
4063 else if (EQ (attr
, QCheight
))
4065 if (!UNSPECIFIEDP (value
))
4069 test
= (EQ (face
, Qdefault
)
4071 /* The default face must have an absolute size,
4072 otherwise, we do a test merge with a random
4073 height to see if VALUE's ok. */
4074 : merge_face_heights (value
, make_number (10), Qnil
));
4076 if (!INTEGERP (test
) || XINT (test
) <= 0)
4077 signal_error ("Invalid face height", value
);
4080 old_value
= LFACE_HEIGHT (lface
);
4081 LFACE_HEIGHT (lface
) = value
;
4082 font_related_attr_p
= 1;
4084 else if (EQ (attr
, QCweight
))
4086 if (!UNSPECIFIEDP (value
))
4088 CHECK_SYMBOL (value
);
4089 if (face_numeric_weight (value
) < 0)
4090 signal_error ("Invalid face weight", value
);
4092 old_value
= LFACE_WEIGHT (lface
);
4093 LFACE_WEIGHT (lface
) = value
;
4094 font_related_attr_p
= 1;
4096 else if (EQ (attr
, QCslant
))
4098 if (!UNSPECIFIEDP (value
))
4100 CHECK_SYMBOL (value
);
4101 if (face_numeric_slant (value
) < 0)
4102 signal_error ("Invalid face slant", value
);
4104 old_value
= LFACE_SLANT (lface
);
4105 LFACE_SLANT (lface
) = value
;
4106 font_related_attr_p
= 1;
4108 else if (EQ (attr
, QCunderline
))
4110 if (!UNSPECIFIEDP (value
))
4111 if ((SYMBOLP (value
)
4113 && !EQ (value
, Qnil
))
4114 /* Underline color. */
4116 && SCHARS (value
) == 0))
4117 signal_error ("Invalid face underline", value
);
4119 old_value
= LFACE_UNDERLINE (lface
);
4120 LFACE_UNDERLINE (lface
) = value
;
4122 else if (EQ (attr
, QCoverline
))
4124 if (!UNSPECIFIEDP (value
))
4125 if ((SYMBOLP (value
)
4127 && !EQ (value
, Qnil
))
4128 /* Overline color. */
4130 && SCHARS (value
) == 0))
4131 signal_error ("Invalid face overline", value
);
4133 old_value
= LFACE_OVERLINE (lface
);
4134 LFACE_OVERLINE (lface
) = value
;
4136 else if (EQ (attr
, QCstrike_through
))
4138 if (!UNSPECIFIEDP (value
))
4139 if ((SYMBOLP (value
)
4141 && !EQ (value
, Qnil
))
4142 /* Strike-through color. */
4144 && SCHARS (value
) == 0))
4145 signal_error ("Invalid face strike-through", value
);
4147 old_value
= LFACE_STRIKE_THROUGH (lface
);
4148 LFACE_STRIKE_THROUGH (lface
) = value
;
4150 else if (EQ (attr
, QCbox
))
4154 /* Allow t meaning a simple box of width 1 in foreground color
4157 value
= make_number (1);
4159 if (UNSPECIFIEDP (value
))
4161 else if (NILP (value
))
4163 else if (INTEGERP (value
))
4164 valid_p
= XINT (value
) != 0;
4165 else if (STRINGP (value
))
4166 valid_p
= SCHARS (value
) > 0;
4167 else if (CONSP (value
))
4183 if (EQ (k
, QCline_width
))
4185 if (!INTEGERP (v
) || XINT (v
) == 0)
4188 else if (EQ (k
, QCcolor
))
4190 if (!NILP (v
) && (!STRINGP (v
) || SCHARS (v
) == 0))
4193 else if (EQ (k
, QCstyle
))
4195 if (!EQ (v
, Qpressed_button
) && !EQ (v
, Qreleased_button
))
4202 valid_p
= NILP (tem
);
4208 signal_error ("Invalid face box", value
);
4210 old_value
= LFACE_BOX (lface
);
4211 LFACE_BOX (lface
) = value
;
4213 else if (EQ (attr
, QCinverse_video
)
4214 || EQ (attr
, QCreverse_video
))
4216 if (!UNSPECIFIEDP (value
))
4218 CHECK_SYMBOL (value
);
4219 if (!EQ (value
, Qt
) && !NILP (value
))
4220 signal_error ("Invalid inverse-video face attribute value", value
);
4222 old_value
= LFACE_INVERSE (lface
);
4223 LFACE_INVERSE (lface
) = value
;
4225 else if (EQ (attr
, QCforeground
))
4227 if (!UNSPECIFIEDP (value
))
4229 /* Don't check for valid color names here because it depends
4230 on the frame (display) whether the color will be valid
4231 when the face is realized. */
4232 CHECK_STRING (value
);
4233 if (SCHARS (value
) == 0)
4234 signal_error ("Empty foreground color value", value
);
4236 old_value
= LFACE_FOREGROUND (lface
);
4237 LFACE_FOREGROUND (lface
) = value
;
4239 else if (EQ (attr
, QCbackground
))
4241 if (!UNSPECIFIEDP (value
))
4243 /* Don't check for valid color names here because it depends
4244 on the frame (display) whether the color will be valid
4245 when the face is realized. */
4246 CHECK_STRING (value
);
4247 if (SCHARS (value
) == 0)
4248 signal_error ("Empty background color value", value
);
4250 old_value
= LFACE_BACKGROUND (lface
);
4251 LFACE_BACKGROUND (lface
) = value
;
4253 else if (EQ (attr
, QCstipple
))
4255 #ifdef HAVE_X_WINDOWS
4256 if (!UNSPECIFIEDP (value
)
4258 && NILP (Fbitmap_spec_p (value
)))
4259 signal_error ("Invalid stipple attribute", value
);
4260 old_value
= LFACE_STIPPLE (lface
);
4261 LFACE_STIPPLE (lface
) = value
;
4262 #endif /* HAVE_X_WINDOWS */
4264 else if (EQ (attr
, QCwidth
))
4266 if (!UNSPECIFIEDP (value
))
4268 CHECK_SYMBOL (value
);
4269 if (face_numeric_swidth (value
) < 0)
4270 signal_error ("Invalid face width", value
);
4272 old_value
= LFACE_SWIDTH (lface
);
4273 LFACE_SWIDTH (lface
) = value
;
4274 font_related_attr_p
= 1;
4276 else if (EQ (attr
, QCfont
))
4278 #ifdef HAVE_WINDOW_SYSTEM
4279 if (EQ (frame
, Qt
) || FRAME_WINDOW_P (XFRAME (frame
)))
4281 /* Set font-related attributes of the Lisp face from an XLFD
4287 f
= SELECTED_FRAME ();
4289 f
= check_x_frame (frame
);
4291 if (!UNSPECIFIEDP (value
))
4293 CHECK_STRING (value
);
4295 /* VALUE may be a fontset name or an alias of fontset. In
4296 such a case, use the base fontset name. */
4297 tmp
= Fquery_fontset (value
, Qnil
);
4301 if (!set_lface_from_font_name (f
, lface
, value
, 1, 1))
4302 signal_error ("Invalid font or fontset name", value
);
4307 #endif /* HAVE_WINDOW_SYSTEM */
4309 else if (EQ (attr
, QCinherit
))
4312 if (SYMBOLP (value
))
4315 for (tail
= value
; CONSP (tail
); tail
= XCDR (tail
))
4316 if (!SYMBOLP (XCAR (tail
)))
4319 LFACE_INHERIT (lface
) = value
;
4321 signal_error ("Invalid face inheritance", value
);
4323 else if (EQ (attr
, QCbold
))
4325 old_value
= LFACE_WEIGHT (lface
);
4326 LFACE_WEIGHT (lface
) = NILP (value
) ? Qnormal
: Qbold
;
4327 font_related_attr_p
= 1;
4329 else if (EQ (attr
, QCitalic
))
4331 old_value
= LFACE_SLANT (lface
);
4332 LFACE_SLANT (lface
) = NILP (value
) ? Qnormal
: Qitalic
;
4333 font_related_attr_p
= 1;
4336 signal_error ("Invalid face attribute name", attr
);
4338 if (font_related_attr_p
4339 && !UNSPECIFIEDP (value
))
4340 /* If a font-related attribute other than QCfont is specified, the
4341 original `font' attribute nor that of default face is useless
4342 to determine a new font. Thus, we set it to nil so that font
4343 selection mechanism doesn't use it. */
4344 LFACE_FONT (lface
) = Qnil
;
4346 /* Changing a named face means that all realized faces depending on
4347 that face are invalid. Since we cannot tell which realized faces
4348 depend on the face, make sure they are all removed. This is done
4349 by incrementing face_change_count. The next call to
4350 init_iterator will then free realized faces. */
4352 && NILP (Fget (face
, Qface_no_inherit
))
4353 && (EQ (attr
, QCfont
)
4354 || NILP (Fequal (old_value
, value
))))
4356 ++face_change_count
;
4357 ++windows_or_buffers_changed
;
4360 if (!UNSPECIFIEDP (value
)
4361 && NILP (Fequal (old_value
, value
)))
4367 if (EQ (face
, Qdefault
))
4369 #ifdef HAVE_WINDOW_SYSTEM
4370 /* Changed font-related attributes of the `default' face are
4371 reflected in changed `font' frame parameters. */
4373 && (font_related_attr_p
|| font_attr_p
)
4374 && lface_fully_specified_p (XVECTOR (lface
)->contents
))
4375 set_font_frame_param (frame
, lface
);
4377 #endif /* HAVE_WINDOW_SYSTEM */
4379 if (EQ (attr
, QCforeground
))
4380 param
= Qforeground_color
;
4381 else if (EQ (attr
, QCbackground
))
4382 param
= Qbackground_color
;
4384 #ifdef HAVE_WINDOW_SYSTEM
4386 else if (EQ (face
, Qscroll_bar
))
4388 /* Changing the colors of `scroll-bar' sets frame parameters
4389 `scroll-bar-foreground' and `scroll-bar-background'. */
4390 if (EQ (attr
, QCforeground
))
4391 param
= Qscroll_bar_foreground
;
4392 else if (EQ (attr
, QCbackground
))
4393 param
= Qscroll_bar_background
;
4395 #endif /* not WINDOWSNT */
4396 else if (EQ (face
, Qborder
))
4398 /* Changing background color of `border' sets frame parameter
4400 if (EQ (attr
, QCbackground
))
4401 param
= Qborder_color
;
4403 else if (EQ (face
, Qcursor
))
4405 /* Changing background color of `cursor' sets frame parameter
4407 if (EQ (attr
, QCbackground
))
4408 param
= Qcursor_color
;
4410 else if (EQ (face
, Qmouse
))
4412 /* Changing background color of `mouse' sets frame parameter
4414 if (EQ (attr
, QCbackground
))
4415 param
= Qmouse_color
;
4417 #endif /* HAVE_WINDOW_SYSTEM */
4418 else if (EQ (face
, Qmenu
))
4420 /* Indicate that we have to update the menu bar when
4421 realizing faces on FRAME. FRAME t change the
4422 default for new frames. We do this by setting
4423 setting the flag in new face caches */
4426 struct frame
*f
= XFRAME (frame
);
4427 if (FRAME_FACE_CACHE (f
) == NULL
)
4428 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
4429 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 1;
4432 menu_face_changed_default
= 1;
4438 /* Update `default-frame-alist', which is used for new frames. */
4440 store_in_alist (&Vdefault_frame_alist
, param
, value
);
4443 /* Update the current frame's parameters. */
4446 cons
= XCAR (Vparam_value_alist
);
4447 XSETCAR (cons
, param
);
4448 XSETCDR (cons
, value
);
4449 Fmodify_frame_parameters (frame
, Vparam_value_alist
);
4458 #ifdef HAVE_WINDOW_SYSTEM
4460 /* Set the `font' frame parameter of FRAME determined from `default'
4461 face attributes LFACE. If a face or fontset name is explicitely
4462 specfied in LFACE, use it as is. Otherwise, determine a font name
4463 from the other font-related atrributes of LFACE. In that case, if
4464 there's no matching font, signals an error. */
4467 set_font_frame_param (frame
, lface
)
4468 Lisp_Object frame
, lface
;
4470 struct frame
*f
= XFRAME (frame
);
4472 if (FRAME_WINDOW_P (f
))
4474 Lisp_Object font_name
;
4477 if (STRINGP (LFACE_FONT (lface
)))
4478 font_name
= LFACE_FONT (lface
);
4481 /* Choose a font name that reflects LFACE's attributes and has
4482 the registry and encoding pattern specified in the default
4483 fontset (3rd arg: -1) for ASCII characters (4th arg: 0). */
4484 font
= choose_face_font (f
, XVECTOR (lface
)->contents
, -1, 0, 0);
4486 error ("No font matches the specified attribute");
4487 font_name
= build_string (font
);
4491 f
->default_face_done_p
= 0;
4492 Fmodify_frame_parameters (frame
, Fcons (Fcons (Qfont
, font_name
), Qnil
));
4497 /* Update the corresponding face when frame parameter PARAM on frame F
4498 has been assigned the value NEW_VALUE. */
4501 update_face_from_frame_parameter (f
, param
, new_value
)
4503 Lisp_Object param
, new_value
;
4505 Lisp_Object face
= Qnil
;
4508 /* If there are no faces yet, give up. This is the case when called
4509 from Fx_create_frame, and we do the necessary things later in
4510 face-set-after-frame-defaults. */
4511 if (NILP (f
->face_alist
))
4514 if (EQ (param
, Qforeground_color
))
4517 lface
= lface_from_face_name (f
, face
, 1);
4518 LFACE_FOREGROUND (lface
) = (STRINGP (new_value
)
4519 ? new_value
: Qunspecified
);
4520 realize_basic_faces (f
);
4522 else if (EQ (param
, Qbackground_color
))
4526 /* Changing the background color might change the background
4527 mode, so that we have to load new defface specs.
4528 Call frame-set-background-mode to do that. */
4529 XSETFRAME (frame
, f
);
4530 call1 (Qframe_set_background_mode
, frame
);
4533 lface
= lface_from_face_name (f
, face
, 1);
4534 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4535 ? new_value
: Qunspecified
);
4536 realize_basic_faces (f
);
4538 else if (EQ (param
, Qborder_color
))
4541 lface
= lface_from_face_name (f
, face
, 1);
4542 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4543 ? new_value
: Qunspecified
);
4545 else if (EQ (param
, Qcursor_color
))
4548 lface
= lface_from_face_name (f
, face
, 1);
4549 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4550 ? new_value
: Qunspecified
);
4552 else if (EQ (param
, Qmouse_color
))
4555 lface
= lface_from_face_name (f
, face
, 1);
4556 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4557 ? new_value
: Qunspecified
);
4560 /* Changing a named face means that all realized faces depending on
4561 that face are invalid. Since we cannot tell which realized faces
4562 depend on the face, make sure they are all removed. This is done
4563 by incrementing face_change_count. The next call to
4564 init_iterator will then free realized faces. */
4566 && NILP (Fget (face
, Qface_no_inherit
)))
4568 ++face_change_count
;
4569 ++windows_or_buffers_changed
;
4574 /* Get the value of X resource RESOURCE, class CLASS for the display
4575 of frame FRAME. This is here because ordinary `x-get-resource'
4576 doesn't take a frame argument. */
4578 DEFUN ("internal-face-x-get-resource", Finternal_face_x_get_resource
,
4579 Sinternal_face_x_get_resource
, 3, 3, 0, doc
: /* */)
4580 (resource
, class, frame
)
4581 Lisp_Object resource
, class, frame
;
4583 Lisp_Object value
= Qnil
;
4584 CHECK_STRING (resource
);
4585 CHECK_STRING (class);
4586 CHECK_LIVE_FRAME (frame
);
4588 value
= display_x_get_resource (FRAME_X_DISPLAY_INFO (XFRAME (frame
)),
4589 resource
, class, Qnil
, Qnil
);
4595 /* Return resource string VALUE as a boolean value, i.e. nil, or t.
4596 If VALUE is "on" or "true", return t. If VALUE is "off" or
4597 "false", return nil. Otherwise, if SIGNAL_P is non-zero, signal an
4598 error; if SIGNAL_P is zero, return 0. */
4601 face_boolean_x_resource_value (value
, signal_p
)
4605 Lisp_Object result
= make_number (0);
4607 xassert (STRINGP (value
));
4609 if (xstricmp (SDATA (value
), "on") == 0
4610 || xstricmp (SDATA (value
), "true") == 0)
4612 else if (xstricmp (SDATA (value
), "off") == 0
4613 || xstricmp (SDATA (value
), "false") == 0)
4615 else if (xstricmp (SDATA (value
), "unspecified") == 0)
4616 result
= Qunspecified
;
4618 signal_error ("Invalid face attribute value from X resource", value
);
4624 DEFUN ("internal-set-lisp-face-attribute-from-resource",
4625 Finternal_set_lisp_face_attribute_from_resource
,
4626 Sinternal_set_lisp_face_attribute_from_resource
,
4627 3, 4, 0, doc
: /* */)
4628 (face
, attr
, value
, frame
)
4629 Lisp_Object face
, attr
, value
, frame
;
4631 CHECK_SYMBOL (face
);
4632 CHECK_SYMBOL (attr
);
4633 CHECK_STRING (value
);
4635 if (xstricmp (SDATA (value
), "unspecified") == 0)
4636 value
= Qunspecified
;
4637 else if (EQ (attr
, QCheight
))
4639 value
= Fstring_to_number (value
, make_number (10));
4640 if (XINT (value
) <= 0)
4641 signal_error ("Invalid face height from X resource", value
);
4643 else if (EQ (attr
, QCbold
) || EQ (attr
, QCitalic
))
4644 value
= face_boolean_x_resource_value (value
, 1);
4645 else if (EQ (attr
, QCweight
) || EQ (attr
, QCslant
) || EQ (attr
, QCwidth
))
4646 value
= intern (SDATA (value
));
4647 else if (EQ (attr
, QCreverse_video
) || EQ (attr
, QCinverse_video
))
4648 value
= face_boolean_x_resource_value (value
, 1);
4649 else if (EQ (attr
, QCunderline
)
4650 || EQ (attr
, QCoverline
)
4651 || EQ (attr
, QCstrike_through
))
4653 Lisp_Object boolean_value
;
4655 /* If the result of face_boolean_x_resource_value is t or nil,
4656 VALUE does NOT specify a color. */
4657 boolean_value
= face_boolean_x_resource_value (value
, 0);
4658 if (SYMBOLP (boolean_value
))
4659 value
= boolean_value
;
4661 else if (EQ (attr
, QCbox
))
4662 value
= Fcar (Fread_from_string (value
, Qnil
, Qnil
));
4664 return Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
4667 #endif /* HAVE_WINDOW_SYSTEM */
4670 /***********************************************************************
4672 ***********************************************************************/
4674 #if defined HAVE_X_WINDOWS && defined USE_X_TOOLKIT
4676 /* Make menus on frame F appear as specified by the `menu' face. */
4679 x_update_menu_appearance (f
)
4682 struct x_display_info
*dpyinfo
= FRAME_X_DISPLAY_INFO (f
);
4686 && (rdb
= XrmGetDatabase (FRAME_X_DISPLAY (f
)),
4690 Lisp_Object lface
= lface_from_face_name (f
, Qmenu
, 1);
4691 struct face
*face
= FACE_FROM_ID (f
, MENU_FACE_ID
);
4692 const char *myname
= SDATA (Vx_resource_name
);
4695 const char *popup_path
= "popup_menu";
4697 const char *popup_path
= "menu.popup";
4700 if (STRINGP (LFACE_FOREGROUND (lface
)))
4702 sprintf (line
, "%s.%s*foreground: %s",
4704 SDATA (LFACE_FOREGROUND (lface
)));
4705 XrmPutLineResource (&rdb
, line
);
4706 sprintf (line
, "%s.pane.menubar*foreground: %s",
4707 myname
, SDATA (LFACE_FOREGROUND (lface
)));
4708 XrmPutLineResource (&rdb
, line
);
4712 if (STRINGP (LFACE_BACKGROUND (lface
)))
4714 sprintf (line
, "%s.%s*background: %s",
4716 SDATA (LFACE_BACKGROUND (lface
)));
4717 XrmPutLineResource (&rdb
, line
);
4718 sprintf (line
, "%s.pane.menubar*background: %s",
4719 myname
, SDATA (LFACE_BACKGROUND (lface
)));
4720 XrmPutLineResource (&rdb
, line
);
4725 && (!UNSPECIFIEDP (LFACE_FAMILY (lface
))
4726 || !UNSPECIFIEDP (LFACE_SWIDTH (lface
))
4727 || !UNSPECIFIEDP (LFACE_AVGWIDTH (lface
))
4728 || !UNSPECIFIEDP (LFACE_WEIGHT (lface
))
4729 || !UNSPECIFIEDP (LFACE_SLANT (lface
))
4730 || !UNSPECIFIEDP (LFACE_HEIGHT (lface
))))
4733 const char *suffix
= "List";
4736 #if defined HAVE_X_I18N
4738 const char *suffix
= "Set";
4740 const char *suffix
= "";
4744 #if defined HAVE_X_I18N
4745 extern char *xic_create_fontsetname
4746 P_ ((char *base_fontname
, Bool motif
));
4747 char *fontsetname
= xic_create_fontsetname (face
->font_name
, motif
);
4749 char *fontsetname
= face
->font_name
;
4751 sprintf (line
, "%s.pane.menubar*font%s: %s",
4752 myname
, suffix
, fontsetname
);
4753 XrmPutLineResource (&rdb
, line
);
4754 sprintf (line
, "%s.%s*font%s: %s",
4755 myname
, popup_path
, suffix
, fontsetname
);
4756 XrmPutLineResource (&rdb
, line
);
4758 if (fontsetname
!= face
->font_name
)
4759 xfree (fontsetname
);
4762 if (changed_p
&& f
->output_data
.x
->menubar_widget
)
4763 free_frame_menubar (f
);
4767 #endif /* HAVE_X_WINDOWS && USE_X_TOOLKIT */
4770 DEFUN ("face-attribute-relative-p", Fface_attribute_relative_p
,
4771 Sface_attribute_relative_p
,
4773 doc
: /* Return non-nil if face ATTRIBUTE VALUE is relative. */)
4775 Lisp_Object attribute
, value
;
4777 if (EQ (value
, Qunspecified
))
4779 else if (EQ (attribute
, QCheight
))
4780 return INTEGERP (value
) ? Qnil
: Qt
;
4785 DEFUN ("merge-face-attribute", Fmerge_face_attribute
, Smerge_face_attribute
,
4787 doc
: /* Return face ATTRIBUTE VALUE1 merged with VALUE2.
4788 If VALUE1 or VALUE2 are absolute (see `face-attribute-relative-p'), then
4789 the result will be absolute, otherwise it will be relative. */)
4790 (attribute
, value1
, value2
)
4791 Lisp_Object attribute
, value1
, value2
;
4793 if (EQ (value1
, Qunspecified
))
4795 else if (EQ (attribute
, QCheight
))
4796 return merge_face_heights (value1
, value2
, value1
);
4802 DEFUN ("internal-get-lisp-face-attribute", Finternal_get_lisp_face_attribute
,
4803 Sinternal_get_lisp_face_attribute
,
4805 doc
: /* Return face attribute KEYWORD of face SYMBOL.
4806 If SYMBOL does not name a valid Lisp face or KEYWORD isn't a valid
4807 face attribute name, signal an error.
4808 If the optional argument FRAME is given, report on face SYMBOL in that
4809 frame. If FRAME is t, report on the defaults for face SYMBOL (for new
4810 frames). If FRAME is omitted or nil, use the selected frame. */)
4811 (symbol
, keyword
, frame
)
4812 Lisp_Object symbol
, keyword
, frame
;
4814 Lisp_Object lface
, value
= Qnil
;
4816 CHECK_SYMBOL (symbol
);
4817 CHECK_SYMBOL (keyword
);
4820 lface
= lface_from_face_name (NULL
, symbol
, 1);
4824 frame
= selected_frame
;
4825 CHECK_LIVE_FRAME (frame
);
4826 lface
= lface_from_face_name (XFRAME (frame
), symbol
, 1);
4829 if (EQ (keyword
, QCfamily
))
4830 value
= LFACE_FAMILY (lface
);
4831 else if (EQ (keyword
, QCheight
))
4832 value
= LFACE_HEIGHT (lface
);
4833 else if (EQ (keyword
, QCweight
))
4834 value
= LFACE_WEIGHT (lface
);
4835 else if (EQ (keyword
, QCslant
))
4836 value
= LFACE_SLANT (lface
);
4837 else if (EQ (keyword
, QCunderline
))
4838 value
= LFACE_UNDERLINE (lface
);
4839 else if (EQ (keyword
, QCoverline
))
4840 value
= LFACE_OVERLINE (lface
);
4841 else if (EQ (keyword
, QCstrike_through
))
4842 value
= LFACE_STRIKE_THROUGH (lface
);
4843 else if (EQ (keyword
, QCbox
))
4844 value
= LFACE_BOX (lface
);
4845 else if (EQ (keyword
, QCinverse_video
)
4846 || EQ (keyword
, QCreverse_video
))
4847 value
= LFACE_INVERSE (lface
);
4848 else if (EQ (keyword
, QCforeground
))
4849 value
= LFACE_FOREGROUND (lface
);
4850 else if (EQ (keyword
, QCbackground
))
4851 value
= LFACE_BACKGROUND (lface
);
4852 else if (EQ (keyword
, QCstipple
))
4853 value
= LFACE_STIPPLE (lface
);
4854 else if (EQ (keyword
, QCwidth
))
4855 value
= LFACE_SWIDTH (lface
);
4856 else if (EQ (keyword
, QCinherit
))
4857 value
= LFACE_INHERIT (lface
);
4858 else if (EQ (keyword
, QCfont
))
4859 value
= LFACE_FONT (lface
);
4861 signal_error ("Invalid face attribute name", keyword
);
4867 DEFUN ("internal-lisp-face-attribute-values",
4868 Finternal_lisp_face_attribute_values
,
4869 Sinternal_lisp_face_attribute_values
, 1, 1, 0,
4870 doc
: /* Return a list of valid discrete values for face attribute ATTR.
4871 Value is nil if ATTR doesn't have a discrete set of valid values. */)
4875 Lisp_Object result
= Qnil
;
4877 CHECK_SYMBOL (attr
);
4879 if (EQ (attr
, QCweight
)
4880 || EQ (attr
, QCslant
)
4881 || EQ (attr
, QCwidth
))
4883 /* Extract permissible symbols from tables. */
4884 struct table_entry
*table
;
4887 if (EQ (attr
, QCweight
))
4888 table
= weight_table
, dim
= DIM (weight_table
);
4889 else if (EQ (attr
, QCslant
))
4890 table
= slant_table
, dim
= DIM (slant_table
);
4892 table
= swidth_table
, dim
= DIM (swidth_table
);
4894 for (i
= 0; i
< dim
; ++i
)
4896 Lisp_Object symbol
= *table
[i
].symbol
;
4897 Lisp_Object tail
= result
;
4900 && !EQ (XCAR (tail
), symbol
))
4904 result
= Fcons (symbol
, result
);
4907 else if (EQ (attr
, QCunderline
))
4908 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4909 else if (EQ (attr
, QCoverline
))
4910 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4911 else if (EQ (attr
, QCstrike_through
))
4912 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4913 else if (EQ (attr
, QCinverse_video
) || EQ (attr
, QCreverse_video
))
4914 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4920 DEFUN ("internal-merge-in-global-face", Finternal_merge_in_global_face
,
4921 Sinternal_merge_in_global_face
, 2, 2, 0,
4922 doc
: /* Add attributes from frame-default definition of FACE to FACE on FRAME.
4923 Default face attributes override any local face attributes. */)
4925 Lisp_Object face
, frame
;
4928 Lisp_Object global_lface
, local_lface
, *gvec
, *lvec
;
4930 CHECK_LIVE_FRAME (frame
);
4931 global_lface
= lface_from_face_name (NULL
, face
, 1);
4932 local_lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
4933 if (NILP (local_lface
))
4934 local_lface
= Finternal_make_lisp_face (face
, frame
);
4936 /* Make every specified global attribute override the local one.
4937 BEWARE!! This is only used from `face-set-after-frame-default' where
4938 the local frame is defined from default specs in `face-defface-spec'
4939 and those should be overridden by global settings. Hence the strange
4940 "global before local" priority. */
4941 lvec
= XVECTOR (local_lface
)->contents
;
4942 gvec
= XVECTOR (global_lface
)->contents
;
4943 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
4944 if (! UNSPECIFIEDP (gvec
[i
]))
4951 /* The following function is implemented for compatibility with 20.2.
4952 The function is used in x-resolve-fonts when it is asked to
4953 return fonts with the same size as the font of a face. This is
4954 done in fontset.el. */
4956 DEFUN ("face-font", Fface_font
, Sface_font
, 1, 2, 0,
4957 doc
: /* Return the font name of face FACE, or nil if it is unspecified.
4958 If the optional argument FRAME is given, report on face FACE in that frame.
4959 If FRAME is t, report on the defaults for face FACE (for new frames).
4960 The font default for a face is either nil, or a list
4961 of the form (bold), (italic) or (bold italic).
4962 If FRAME is omitted or nil, use the selected frame. */)
4964 Lisp_Object face
, frame
;
4968 Lisp_Object result
= Qnil
;
4969 Lisp_Object lface
= lface_from_face_name (NULL
, face
, 1);
4971 if (!UNSPECIFIEDP (LFACE_WEIGHT (lface
))
4972 && !EQ (LFACE_WEIGHT (lface
), Qnormal
))
4973 result
= Fcons (Qbold
, result
);
4975 if (!UNSPECIFIEDP (LFACE_SLANT (lface
))
4976 && !EQ (LFACE_SLANT (lface
), Qnormal
))
4977 result
= Fcons (Qitalic
, result
);
4983 struct frame
*f
= frame_or_selected_frame (frame
, 1);
4984 int face_id
= lookup_named_face (f
, face
, 0, 1);
4985 struct face
*face
= FACE_FROM_ID (f
, face_id
);
4986 return face
? build_string (face
->font_name
) : Qnil
;
4991 /* Compare face-attribute values v1 and v2 for equality. Value is non-zero if
4992 all attributes are `equal'. Tries to be fast because this function
4993 is called quite often. */
4996 face_attr_equal_p (v1
, v2
)
4999 /* Type can differ, e.g. when one attribute is unspecified, i.e. nil,
5000 and the other is specified. */
5001 if (XTYPE (v1
) != XTYPE (v2
))
5010 if (SBYTES (v1
) != SBYTES (v2
))
5013 return bcmp (SDATA (v1
), SDATA (v2
), SBYTES (v1
)) == 0;
5020 return !NILP (Fequal (v1
, v2
));
5025 /* Compare face vectors V1 and V2 for equality. Value is non-zero if
5026 all attributes are `equal'. Tries to be fast because this function
5027 is called quite often. */
5030 lface_equal_p (v1
, v2
)
5031 Lisp_Object
*v1
, *v2
;
5035 for (i
= 1; i
< LFACE_VECTOR_SIZE
&& equal_p
; ++i
)
5036 equal_p
= face_attr_equal_p (v1
[i
], v2
[i
]);
5042 DEFUN ("internal-lisp-face-equal-p", Finternal_lisp_face_equal_p
,
5043 Sinternal_lisp_face_equal_p
, 2, 3, 0,
5044 doc
: /* True if FACE1 and FACE2 are equal.
5045 If the optional argument FRAME is given, report on FACE1 and FACE2 in that frame.
5046 If FRAME is t, report on the defaults for FACE1 and FACE2 (for new frames).
5047 If FRAME is omitted or nil, use the selected frame. */)
5048 (face1
, face2
, frame
)
5049 Lisp_Object face1
, face2
, frame
;
5053 Lisp_Object lface1
, lface2
;
5058 /* Don't use check_x_frame here because this function is called
5059 before X frames exist. At that time, if FRAME is nil,
5060 selected_frame will be used which is the frame dumped with
5061 Emacs. That frame is not an X frame. */
5062 f
= frame_or_selected_frame (frame
, 2);
5064 lface1
= lface_from_face_name (f
, face1
, 1);
5065 lface2
= lface_from_face_name (f
, face2
, 1);
5066 equal_p
= lface_equal_p (XVECTOR (lface1
)->contents
,
5067 XVECTOR (lface2
)->contents
);
5068 return equal_p
? Qt
: Qnil
;
5072 DEFUN ("internal-lisp-face-empty-p", Finternal_lisp_face_empty_p
,
5073 Sinternal_lisp_face_empty_p
, 1, 2, 0,
5074 doc
: /* True if FACE has no attribute specified.
5075 If the optional argument FRAME is given, report on face FACE in that frame.
5076 If FRAME is t, report on the defaults for face FACE (for new frames).
5077 If FRAME is omitted or nil, use the selected frame. */)
5079 Lisp_Object face
, frame
;
5086 frame
= selected_frame
;
5087 CHECK_LIVE_FRAME (frame
);
5091 lface
= lface_from_face_name (NULL
, face
, 1);
5093 lface
= lface_from_face_name (f
, face
, 1);
5095 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
5096 if (!UNSPECIFIEDP (AREF (lface
, i
)))
5099 return i
== LFACE_VECTOR_SIZE
? Qt
: Qnil
;
5103 DEFUN ("frame-face-alist", Fframe_face_alist
, Sframe_face_alist
,
5105 doc
: /* Return an alist of frame-local faces defined on FRAME.
5106 For internal use only. */)
5110 struct frame
*f
= frame_or_selected_frame (frame
, 0);
5111 return f
->face_alist
;
5115 /* Return a hash code for Lisp string STRING with case ignored. Used
5116 below in computing a hash value for a Lisp face. */
5118 static INLINE
unsigned
5119 hash_string_case_insensitive (string
)
5122 const unsigned char *s
;
5124 xassert (STRINGP (string
));
5125 for (s
= SDATA (string
); *s
; ++s
)
5126 hash
= (hash
<< 1) ^ tolower (*s
);
5131 /* Return a hash code for face attribute vector V. */
5133 static INLINE
unsigned
5137 return (hash_string_case_insensitive (v
[LFACE_FAMILY_INDEX
])
5138 ^ hash_string_case_insensitive (v
[LFACE_FOREGROUND_INDEX
])
5139 ^ hash_string_case_insensitive (v
[LFACE_BACKGROUND_INDEX
])
5140 ^ XFASTINT (v
[LFACE_WEIGHT_INDEX
])
5141 ^ XFASTINT (v
[LFACE_SLANT_INDEX
])
5142 ^ XFASTINT (v
[LFACE_SWIDTH_INDEX
])
5143 ^ XFASTINT (v
[LFACE_HEIGHT_INDEX
]));
5147 /* Return non-zero if LFACE1 and LFACE2 specify the same font (without
5148 considering charsets/registries). They do if they specify the same
5149 family, point size, weight, width, slant, and fontset. Both LFACE1
5150 and LFACE2 must be fully-specified. */
5153 lface_same_font_attributes_p (lface1
, lface2
)
5154 Lisp_Object
*lface1
, *lface2
;
5156 xassert (lface_fully_specified_p (lface1
)
5157 && lface_fully_specified_p (lface2
));
5158 return (xstricmp (SDATA (lface1
[LFACE_FAMILY_INDEX
]),
5159 SDATA (lface2
[LFACE_FAMILY_INDEX
])) == 0
5160 && EQ (lface1
[LFACE_HEIGHT_INDEX
], lface2
[LFACE_HEIGHT_INDEX
])
5161 && EQ (lface1
[LFACE_SWIDTH_INDEX
], lface2
[LFACE_SWIDTH_INDEX
])
5162 && EQ (lface1
[LFACE_AVGWIDTH_INDEX
], lface2
[LFACE_AVGWIDTH_INDEX
])
5163 && EQ (lface1
[LFACE_WEIGHT_INDEX
], lface2
[LFACE_WEIGHT_INDEX
])
5164 && EQ (lface1
[LFACE_SLANT_INDEX
], lface2
[LFACE_SLANT_INDEX
])
5165 && (EQ (lface1
[LFACE_FONT_INDEX
], lface2
[LFACE_FONT_INDEX
])
5166 || (STRINGP (lface1
[LFACE_FONT_INDEX
])
5167 && STRINGP (lface2
[LFACE_FONT_INDEX
])
5168 && xstricmp (SDATA (lface1
[LFACE_FONT_INDEX
]),
5169 SDATA (lface2
[LFACE_FONT_INDEX
])))));
5174 /***********************************************************************
5176 ***********************************************************************/
5178 /* Allocate and return a new realized face for Lisp face attribute
5181 static struct face
*
5182 make_realized_face (attr
)
5185 struct face
*face
= (struct face
*) xmalloc (sizeof *face
);
5186 bzero (face
, sizeof *face
);
5187 face
->ascii_face
= face
;
5188 bcopy (attr
, face
->lface
, sizeof face
->lface
);
5193 /* Free realized face FACE, including its X resources. FACE may
5197 free_realized_face (f
, face
)
5203 #ifdef HAVE_WINDOW_SYSTEM
5204 if (FRAME_WINDOW_P (f
))
5206 /* Free fontset of FACE if it is ASCII face. */
5207 if (face
->fontset
>= 0 && face
== face
->ascii_face
)
5208 free_face_fontset (f
, face
);
5211 x_free_gc (f
, face
->gc
);
5215 free_face_colors (f
, face
);
5216 x_destroy_bitmap (f
, face
->stipple
);
5218 #endif /* HAVE_WINDOW_SYSTEM */
5225 /* Prepare face FACE for subsequent display on frame F. This
5226 allocated GCs if they haven't been allocated yet or have been freed
5227 by clearing the face cache. */
5230 prepare_face_for_display (f
, face
)
5234 #ifdef HAVE_WINDOW_SYSTEM
5235 xassert (FRAME_WINDOW_P (f
));
5240 unsigned long mask
= GCForeground
| GCBackground
| GCGraphicsExposures
;
5242 xgcv
.foreground
= face
->foreground
;
5243 xgcv
.background
= face
->background
;
5244 #ifdef HAVE_X_WINDOWS
5245 xgcv
.graphics_exposures
= False
;
5247 /* The font of FACE may be null if we couldn't load it. */
5250 #ifdef HAVE_X_WINDOWS
5251 xgcv
.font
= face
->font
->fid
;
5254 xgcv
.font
= face
->font
;
5257 xgcv
.font
= face
->font
;
5263 #ifdef HAVE_X_WINDOWS
5266 xgcv
.fill_style
= FillOpaqueStippled
;
5267 xgcv
.stipple
= x_bitmap_pixmap (f
, face
->stipple
);
5268 mask
|= GCFillStyle
| GCStipple
;
5271 face
->gc
= x_create_gc (f
, mask
, &xgcv
);
5274 #endif /* HAVE_WINDOW_SYSTEM */
5278 /* Returns the `distance' between the colors X and Y. */
5281 color_distance (x
, y
)
5284 /* This formula is from a paper title `Colour metric' by Thiadmer Riemersma.
5285 Quoting from that paper:
5287 This formula has results that are very close to L*u*v* (with the
5288 modified lightness curve) and, more importantly, it is a more even
5289 algorithm: it does not have a range of colours where it suddenly
5290 gives far from optimal results.
5292 See <http://www.compuphase.com/cmetric.htm> for more info. */
5294 long r
= (x
->red
- y
->red
) >> 8;
5295 long g
= (x
->green
- y
->green
) >> 8;
5296 long b
= (x
->blue
- y
->blue
) >> 8;
5297 long r_mean
= (x
->red
+ y
->red
) >> 9;
5300 (((512 + r_mean
) * r
* r
) >> 8)
5302 + (((767 - r_mean
) * b
* b
) >> 8);
5306 DEFUN ("color-distance", Fcolor_distance
, Scolor_distance
, 2, 3, 0,
5307 doc
: /* Return an integer distance between COLOR1 and COLOR2 on FRAME.
5308 COLOR1 and COLOR2 may be either strings containing the color name,
5309 or lists of the form (RED GREEN BLUE).
5310 If FRAME is unspecified or nil, the current frame is used. */)
5311 (color1
, color2
, frame
)
5312 Lisp_Object color1
, color2
, frame
;
5315 XColor cdef1
, cdef2
;
5318 frame
= selected_frame
;
5319 CHECK_LIVE_FRAME (frame
);
5322 if ((CONSP (color1
) && !parse_rgb_list (color1
, &cdef1
))
5323 || !STRINGP (color1
)
5324 || !defined_color (f
, SDATA (color1
), &cdef1
, 0))
5325 signal_error ("Invalid color", color1
);
5326 if ((CONSP (color2
) && !parse_rgb_list (color2
, &cdef2
))
5327 || !STRINGP (color2
)
5328 || !defined_color (f
, SDATA (color2
), &cdef2
, 0))
5329 signal_error ("Invalid color", color2
);
5331 return make_number (color_distance (&cdef1
, &cdef2
));
5335 /***********************************************************************
5337 ***********************************************************************/
5339 /* Return a new face cache for frame F. */
5341 static struct face_cache
*
5345 struct face_cache
*c
;
5348 c
= (struct face_cache
*) xmalloc (sizeof *c
);
5349 bzero (c
, sizeof *c
);
5350 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5351 c
->buckets
= (struct face
**) xmalloc (size
);
5352 bzero (c
->buckets
, size
);
5354 c
->faces_by_id
= (struct face
**) xmalloc (c
->size
* sizeof *c
->faces_by_id
);
5356 c
->menu_face_changed_p
= menu_face_changed_default
;
5361 /* Clear out all graphics contexts for all realized faces, except for
5362 the basic faces. This should be done from time to time just to avoid
5363 keeping too many graphics contexts that are no longer needed. */
5367 struct face_cache
*c
;
5369 if (c
&& FRAME_WINDOW_P (c
->f
))
5371 #ifdef HAVE_WINDOW_SYSTEM
5373 for (i
= BASIC_FACE_ID_SENTINEL
; i
< c
->used
; ++i
)
5375 struct face
*face
= c
->faces_by_id
[i
];
5376 if (face
&& face
->gc
)
5378 x_free_gc (c
->f
, face
->gc
);
5382 #endif /* HAVE_WINDOW_SYSTEM */
5387 /* Free all realized faces in face cache C, including basic faces.
5388 C may be null. If faces are freed, make sure the frame's current
5389 matrix is marked invalid, so that a display caused by an expose
5390 event doesn't try to use faces we destroyed. */
5393 free_realized_faces (c
)
5394 struct face_cache
*c
;
5399 struct frame
*f
= c
->f
;
5401 /* We must block input here because we can't process X events
5402 safely while only some faces are freed, or when the frame's
5403 current matrix still references freed faces. */
5406 for (i
= 0; i
< c
->used
; ++i
)
5408 free_realized_face (f
, c
->faces_by_id
[i
]);
5409 c
->faces_by_id
[i
] = NULL
;
5413 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5414 bzero (c
->buckets
, size
);
5416 /* Must do a thorough redisplay the next time. Mark current
5417 matrices as invalid because they will reference faces freed
5418 above. This function is also called when a frame is
5419 destroyed. In this case, the root window of F is nil. */
5420 if (WINDOWP (f
->root_window
))
5422 clear_current_matrices (f
);
5423 ++windows_or_buffers_changed
;
5431 /* Free all faces realized for multibyte characters on frame F that
5435 free_realized_multibyte_face (f
, fontset
)
5439 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5443 /* We must block input here because we can't process X events safely
5444 while only some faces are freed, or when the frame's current
5445 matrix still references freed faces. */
5448 for (i
= 0; i
< cache
->used
; i
++)
5450 face
= cache
->faces_by_id
[i
];
5452 && face
!= face
->ascii_face
5453 && face
->fontset
== fontset
)
5455 uncache_face (cache
, face
);
5456 free_realized_face (f
, face
);
5460 /* Must do a thorough redisplay the next time. Mark current
5461 matrices as invalid because they will reference faces freed
5462 above. This function is also called when a frame is destroyed.
5463 In this case, the root window of F is nil. */
5464 if (WINDOWP (f
->root_window
))
5466 clear_current_matrices (f
);
5467 ++windows_or_buffers_changed
;
5474 /* Free all realized faces on FRAME or on all frames if FRAME is nil.
5475 This is done after attributes of a named face have been changed,
5476 because we can't tell which realized faces depend on that face. */
5479 free_all_realized_faces (frame
)
5485 FOR_EACH_FRAME (rest
, frame
)
5486 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5489 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5493 /* Free face cache C and faces in it, including their X resources. */
5497 struct face_cache
*c
;
5501 free_realized_faces (c
);
5503 xfree (c
->faces_by_id
);
5509 /* Cache realized face FACE in face cache C. HASH is the hash value
5510 of FACE. If FACE->fontset >= 0, add the new face to the end of the
5511 collision list of the face hash table of C. This is done because
5512 otherwise lookup_face would find FACE for every character, even if
5513 faces with the same attributes but for specific characters exist. */
5516 cache_face (c
, face
, hash
)
5517 struct face_cache
*c
;
5521 int i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5525 if (face
->fontset
>= 0)
5527 struct face
*last
= c
->buckets
[i
];
5538 c
->buckets
[i
] = face
;
5539 face
->prev
= face
->next
= NULL
;
5545 face
->next
= c
->buckets
[i
];
5547 face
->next
->prev
= face
;
5548 c
->buckets
[i
] = face
;
5551 /* Find a free slot in C->faces_by_id and use the index of the free
5552 slot as FACE->id. */
5553 for (i
= 0; i
< c
->used
; ++i
)
5554 if (c
->faces_by_id
[i
] == NULL
)
5558 /* Maybe enlarge C->faces_by_id. */
5561 if (c
->used
== c
->size
)
5564 new_size
= min (2 * c
->size
, MAX_FACE_ID
);
5565 if (new_size
== c
->size
)
5566 abort (); /* Alternatives? ++kfs */
5567 sz
= new_size
* sizeof *c
->faces_by_id
;
5568 c
->faces_by_id
= (struct face
**) xrealloc (c
->faces_by_id
, sz
);
5575 /* Check that FACE got a unique id. */
5580 for (j
= n
= 0; j
< FACE_CACHE_BUCKETS_SIZE
; ++j
)
5581 for (face
= c
->buckets
[j
]; face
; face
= face
->next
)
5587 #endif /* GLYPH_DEBUG */
5589 c
->faces_by_id
[i
] = face
;
5593 /* Remove face FACE from cache C. */
5596 uncache_face (c
, face
)
5597 struct face_cache
*c
;
5600 int i
= face
->hash
% FACE_CACHE_BUCKETS_SIZE
;
5603 face
->prev
->next
= face
->next
;
5605 c
->buckets
[i
] = face
->next
;
5608 face
->next
->prev
= face
->prev
;
5610 c
->faces_by_id
[face
->id
] = NULL
;
5611 if (face
->id
== c
->used
)
5616 /* Look up a realized face with face attributes ATTR in the face cache
5617 of frame F. The face will be used to display character C. Value
5618 is the ID of the face found. If no suitable face is found, realize
5619 a new one. In that case, if C is a multibyte character, BASE_FACE
5620 is a face that has the same attributes. */
5623 lookup_face (f
, attr
, c
, base_face
)
5627 struct face
*base_face
;
5629 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5634 xassert (cache
!= NULL
);
5635 check_lface_attrs (attr
);
5637 /* Look up ATTR in the face cache. */
5638 hash
= lface_hash (attr
);
5639 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5641 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
5642 if (face
->hash
== hash
5643 && (!FRAME_WINDOW_P (f
)
5644 || FACE_SUITABLE_FOR_CHAR_P (face
, c
))
5645 && lface_equal_p (face
->lface
, attr
))
5648 /* If not found, realize a new face. */
5650 face
= realize_face (cache
, attr
, c
, base_face
, -1);
5653 xassert (face
== FACE_FROM_ID (f
, face
->id
));
5655 /* When this function is called from face_for_char (in this case, C is
5656 a multibyte character), a fontset of a face returned by
5657 realize_face is not yet set, i.e. FACE_SUITABLE_FOR_CHAR_P (FACE,
5658 C) is not sutisfied. The fontset is set for this face by
5659 face_for_char later. */
5661 if (FRAME_WINDOW_P (f
))
5662 xassert (FACE_SUITABLE_FOR_CHAR_P (face
, c
));
5664 #endif /* GLYPH_DEBUG */
5670 /* Return the face id of the realized face for named face SYMBOL on
5671 frame F suitable for displaying character C. Value is -1 if the
5672 face couldn't be determined, which might happen if the default face
5673 isn't realized and cannot be realized. */
5676 lookup_named_face (f
, symbol
, c
, signal_p
)
5682 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5683 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5684 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5686 if (default_face
== NULL
)
5688 if (!realize_basic_faces (f
))
5690 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5693 if (!get_lface_attributes (f
, symbol
, symbol_attrs
, signal_p
))
5696 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
5697 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
5699 return lookup_face (f
, attrs
, c
, NULL
);
5703 /* Return the ID of the realized ASCII face of Lisp face with ID
5704 LFACE_ID on frame F. Value is -1 if LFACE_ID isn't valid. */
5707 ascii_face_of_lisp_face (f
, lface_id
)
5713 if (lface_id
>= 0 && lface_id
< lface_id_to_name_size
)
5715 Lisp_Object face_name
= lface_id_to_name
[lface_id
];
5716 face_id
= lookup_named_face (f
, face_name
, 0, 1);
5725 /* Return a face for charset ASCII that is like the face with id
5726 FACE_ID on frame F, but has a font that is STEPS steps smaller.
5727 STEPS < 0 means larger. Value is the id of the face. */
5730 smaller_face (f
, face_id
, steps
)
5734 #ifdef HAVE_WINDOW_SYSTEM
5736 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5737 int pt
, last_pt
, last_height
;
5740 struct face
*new_face
;
5742 /* If not called for an X frame, just return the original face. */
5743 if (FRAME_TERMCAP_P (f
))
5746 /* Try in increments of 1/2 pt. */
5747 delta
= steps
< 0 ? 5 : -5;
5748 steps
= abs (steps
);
5750 face
= FACE_FROM_ID (f
, face_id
);
5751 bcopy (face
->lface
, attrs
, sizeof attrs
);
5752 pt
= last_pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
5753 new_face_id
= face_id
;
5754 last_height
= FONT_HEIGHT (face
->font
);
5758 /* Give up if we cannot find a font within 10pt. */
5759 && abs (last_pt
- pt
) < 100)
5761 /* Look up a face for a slightly smaller/larger font. */
5763 attrs
[LFACE_HEIGHT_INDEX
] = make_number (pt
);
5764 new_face_id
= lookup_face (f
, attrs
, 0, NULL
);
5765 new_face
= FACE_FROM_ID (f
, new_face_id
);
5767 /* If height changes, count that as one step. */
5768 if ((delta
< 0 && FONT_HEIGHT (new_face
->font
) < last_height
)
5769 || (delta
> 0 && FONT_HEIGHT (new_face
->font
) > last_height
))
5772 last_height
= FONT_HEIGHT (new_face
->font
);
5779 #else /* not HAVE_WINDOW_SYSTEM */
5783 #endif /* not HAVE_WINDOW_SYSTEM */
5787 /* Return a face for charset ASCII that is like the face with id
5788 FACE_ID on frame F, but has height HEIGHT. */
5791 face_with_height (f
, face_id
, height
)
5796 #ifdef HAVE_WINDOW_SYSTEM
5798 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5800 if (FRAME_TERMCAP_P (f
)
5804 face
= FACE_FROM_ID (f
, face_id
);
5805 bcopy (face
->lface
, attrs
, sizeof attrs
);
5806 attrs
[LFACE_HEIGHT_INDEX
] = make_number (height
);
5807 face_id
= lookup_face (f
, attrs
, 0, NULL
);
5808 #endif /* HAVE_WINDOW_SYSTEM */
5814 /* Return the face id of the realized face for named face SYMBOL on
5815 frame F suitable for displaying character C, and use attributes of
5816 the face FACE_ID for attributes that aren't completely specified by
5817 SYMBOL. This is like lookup_named_face, except that the default
5818 attributes come from FACE_ID, not from the default face. FACE_ID
5819 is assumed to be already realized. */
5822 lookup_derived_face (f
, symbol
, c
, face_id
, signal_p
)
5828 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5829 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5830 struct face
*default_face
= FACE_FROM_ID (f
, face_id
);
5835 get_lface_attributes (f
, symbol
, symbol_attrs
, signal_p
);
5836 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
5837 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
5838 return lookup_face (f
, attrs
, c
, default_face
);
5841 DEFUN ("face-attributes-as-vector", Fface_attributes_as_vector
,
5842 Sface_attributes_as_vector
, 1, 1, 0,
5843 doc
: /* Return a vector of face attributes corresponding to PLIST. */)
5848 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
5850 merge_face_ref (XFRAME (selected_frame
), plist
, XVECTOR (lface
)->contents
,
5857 /***********************************************************************
5858 Face capability testing
5859 ***********************************************************************/
5862 /* If the distance (as returned by color_distance) between two colors is
5863 less than this, then they are considered the same, for determining
5864 whether a color is supported or not. The range of values is 0-65535. */
5866 #define TTY_SAME_COLOR_THRESHOLD 10000
5868 #ifdef HAVE_WINDOW_SYSTEM
5870 /* Return non-zero if all the face attributes in ATTRS are supported
5871 on the window-system frame F.
5873 The definition of `supported' is somewhat heuristic, but basically means
5874 that a face containing all the attributes in ATTRS, when merged with the
5875 default face for display, can be represented in a way that's
5877 \(1) different in appearance than the default face, and
5878 \(2) `close in spirit' to what the attributes specify, if not exact. */
5881 x_supports_face_attributes_p (f
, attrs
, def_face
)
5884 struct face
*def_face
;
5886 Lisp_Object
*def_attrs
= def_face
->lface
;
5888 /* Check that other specified attributes are different that the default
5890 if ((!UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
5891 && face_attr_equal_p (attrs
[LFACE_UNDERLINE_INDEX
],
5892 def_attrs
[LFACE_UNDERLINE_INDEX
]))
5893 || (!UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
5894 && face_attr_equal_p (attrs
[LFACE_INVERSE_INDEX
],
5895 def_attrs
[LFACE_INVERSE_INDEX
]))
5896 || (!UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
5897 && face_attr_equal_p (attrs
[LFACE_FOREGROUND_INDEX
],
5898 def_attrs
[LFACE_FOREGROUND_INDEX
]))
5899 || (!UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
5900 && face_attr_equal_p (attrs
[LFACE_BACKGROUND_INDEX
],
5901 def_attrs
[LFACE_BACKGROUND_INDEX
]))
5902 || (!UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
5903 && face_attr_equal_p (attrs
[LFACE_STIPPLE_INDEX
],
5904 def_attrs
[LFACE_STIPPLE_INDEX
]))
5905 || (!UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
5906 && face_attr_equal_p (attrs
[LFACE_OVERLINE_INDEX
],
5907 def_attrs
[LFACE_OVERLINE_INDEX
]))
5908 || (!UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
5909 && face_attr_equal_p (attrs
[LFACE_STRIKE_THROUGH_INDEX
],
5910 def_attrs
[LFACE_STRIKE_THROUGH_INDEX
]))
5911 || (!UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
5912 && face_attr_equal_p (attrs
[LFACE_BOX_INDEX
],
5913 def_attrs
[LFACE_BOX_INDEX
])))
5916 /* Check font-related attributes, as those are the most commonly
5917 "unsupported" on a window-system (because of missing fonts). */
5918 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
5919 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
5920 || !UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
5921 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
5922 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
5923 || !UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
]))
5926 Lisp_Object merged_attrs
[LFACE_VECTOR_SIZE
];
5928 bcopy (def_attrs
, merged_attrs
, sizeof merged_attrs
);
5930 merge_face_vectors (f
, attrs
, merged_attrs
, 0);
5932 face
= FACE_FROM_ID (f
, lookup_face (f
, merged_attrs
, 0, 0));
5935 error ("Cannot make face");
5937 /* If the font is the same, then not supported. */
5938 if (face
->font
== def_face
->font
)
5942 /* Everything checks out, this face is supported. */
5946 #endif /* HAVE_WINDOW_SYSTEM */
5948 /* Return non-zero if all the face attributes in ATTRS are supported
5951 The definition of `supported' is somewhat heuristic, but basically means
5952 that a face containing all the attributes in ATTRS, when merged
5953 with the default face for display, can be represented in a way that's
5955 \(1) different in appearance than the default face, and
5956 \(2) `close in spirit' to what the attributes specify, if not exact.
5958 Point (2) implies that a `:weight black' attribute will be satisfied
5959 by any terminal that can display bold, and a `:foreground "yellow"' as
5960 long as the terminal can display a yellowish color, but `:slant italic'
5961 will _not_ be satisfied by the tty display code's automatic
5962 substitution of a `dim' face for italic. */
5965 tty_supports_face_attributes_p (f
, attrs
, def_face
)
5968 struct face
*def_face
;
5971 Lisp_Object val
, fg
, bg
;
5972 XColor fg_tty_color
, fg_std_color
;
5973 XColor bg_tty_color
, bg_std_color
;
5974 unsigned test_caps
= 0;
5975 Lisp_Object
*def_attrs
= def_face
->lface
;
5978 /* First check some easy-to-check stuff; ttys support none of the
5979 following attributes, so we can just return false if any are requested
5980 (even if `nominal' values are specified, we should still return false,
5981 as that will be the same value that the default face uses). We
5982 consider :slant unsupportable on ttys, even though the face code
5983 actually `fakes' them using a dim attribute if possible. This is
5984 because the faked result is too different from what the face
5986 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
5987 || !UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
5988 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
5989 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
5990 || !UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
5991 || !UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
5992 || !UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
5993 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
]))
5997 /* Test for terminal `capabilities' (non-color character attributes). */
5999 /* font weight (bold/dim) */
6000 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
6003 int def_weight
= face_numeric_weight (def_attrs
[LFACE_WEIGHT_INDEX
]);
6005 if (weight
> XLFD_WEIGHT_MEDIUM
)
6007 if (def_weight
> XLFD_WEIGHT_MEDIUM
)
6008 return 0; /* same as default */
6009 test_caps
= TTY_CAP_BOLD
;
6011 else if (weight
< XLFD_WEIGHT_MEDIUM
)
6013 if (def_weight
< XLFD_WEIGHT_MEDIUM
)
6014 return 0; /* same as default */
6015 test_caps
= TTY_CAP_DIM
;
6017 else if (def_weight
== XLFD_WEIGHT_MEDIUM
)
6018 return 0; /* same as default */
6022 val
= attrs
[LFACE_UNDERLINE_INDEX
];
6023 if (!UNSPECIFIEDP (val
))
6026 return 0; /* ttys can't use colored underlines */
6027 else if (face_attr_equal_p (val
, def_attrs
[LFACE_UNDERLINE_INDEX
]))
6028 return 0; /* same as default */
6030 test_caps
|= TTY_CAP_UNDERLINE
;
6034 val
= attrs
[LFACE_INVERSE_INDEX
];
6035 if (!UNSPECIFIEDP (val
))
6037 if (face_attr_equal_p (val
, def_attrs
[LFACE_UNDERLINE_INDEX
]))
6038 return 0; /* same as default */
6040 test_caps
|= TTY_CAP_INVERSE
;
6044 /* Color testing. */
6046 /* Default the color indices in FG_TTY_COLOR and BG_TTY_COLOR, since
6047 we use them when calling `tty_capable_p' below, even if the face
6048 specifies no colors. */
6049 fg_tty_color
.pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
6050 bg_tty_color
.pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
6052 /* Check if foreground color is close enough. */
6053 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
6056 Lisp_Object def_fg
= def_attrs
[LFACE_FOREGROUND_INDEX
];
6058 if (face_attr_equal_p (fg
, def_fg
))
6059 return 0; /* same as default */
6060 else if (! tty_lookup_color (f
, fg
, &fg_tty_color
, &fg_std_color
))
6061 return 0; /* not a valid color */
6062 else if (color_distance (&fg_tty_color
, &fg_std_color
)
6063 > TTY_SAME_COLOR_THRESHOLD
)
6064 return 0; /* displayed color is too different */
6066 /* Make sure the color is really different than the default. */
6068 XColor def_fg_color
;
6069 if (tty_lookup_color (f
, def_fg
, &def_fg_color
, 0)
6070 && (color_distance (&fg_tty_color
, &def_fg_color
)
6071 <= TTY_SAME_COLOR_THRESHOLD
))
6076 /* Check if background color is close enough. */
6077 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
6080 Lisp_Object def_bg
= def_attrs
[LFACE_FOREGROUND_INDEX
];
6082 if (face_attr_equal_p (bg
, def_bg
))
6083 return 0; /* same as default */
6084 else if (! tty_lookup_color (f
, bg
, &bg_tty_color
, &bg_std_color
))
6085 return 0; /* not a valid color */
6086 else if (color_distance (&bg_tty_color
, &bg_std_color
)
6087 > TTY_SAME_COLOR_THRESHOLD
)
6088 return 0; /* displayed color is too different */
6090 /* Make sure the color is really different than the default. */
6092 XColor def_bg_color
;
6093 if (tty_lookup_color (f
, def_bg
, &def_bg_color
, 0)
6094 && (color_distance (&bg_tty_color
, &def_bg_color
)
6095 <= TTY_SAME_COLOR_THRESHOLD
))
6100 /* If both foreground and background are requested, see if the
6101 distance between them is OK. We just check to see if the distance
6102 between the tty's foreground and background is close enough to the
6103 distance between the standard foreground and background. */
6104 if (STRINGP (fg
) && STRINGP (bg
))
6107 = (color_distance (&fg_std_color
, &bg_std_color
)
6108 - color_distance (&fg_tty_color
, &bg_tty_color
));
6109 if (delta_delta
> TTY_SAME_COLOR_THRESHOLD
6110 || delta_delta
< -TTY_SAME_COLOR_THRESHOLD
)
6115 /* See if the capabilities we selected above are supported, with the
6117 if (test_caps
!= 0 &&
6118 ! tty_capable_p (FRAME_TTY (f
), test_caps
, fg_tty_color
.pixel
, bg_tty_color
.pixel
))
6122 /* Hmmm, everything checks out, this terminal must support this face. */
6127 DEFUN ("display-supports-face-attributes-p",
6128 Fdisplay_supports_face_attributes_p
, Sdisplay_supports_face_attributes_p
,
6130 doc
: /* Return non-nil if all the face attributes in ATTRIBUTES are supported.
6131 The optional argument DISPLAY can be a display name, a frame, or
6132 nil (meaning the selected frame's display).
6134 The definition of `supported' is somewhat heuristic, but basically means
6135 that a face containing all the attributes in ATTRIBUTES, when merged
6136 with the default face for display, can be represented in a way that's
6138 \(1) different in appearance than the default face, and
6139 \(2) `close in spirit' to what the attributes specify, if not exact.
6141 Point (2) implies that a `:weight black' attribute will be satisfied by
6142 any display that can display bold, and a `:foreground \"yellow\"' as long
6143 as it can display a yellowish color, but `:slant italic' will _not_ be
6144 satisfied by the tty display code's automatic substitution of a `dim'
6145 face for italic. */)
6146 (attributes
, display
)
6147 Lisp_Object attributes
, display
;
6152 struct face
*def_face
;
6153 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6155 if (noninteractive
|| !initialized
)
6156 /* We may not be able to access low-level face information in batch
6157 mode, or before being dumped, and this function is not going to
6158 be very useful in those cases anyway, so just give up. */
6162 frame
= selected_frame
;
6163 else if (FRAMEP (display
))
6167 /* Find any frame on DISPLAY. */
6168 Lisp_Object fl_tail
;
6171 for (fl_tail
= Vframe_list
; CONSP (fl_tail
); fl_tail
= XCDR (fl_tail
))
6173 frame
= XCAR (fl_tail
);
6174 if (!NILP (Fequal (Fcdr (Fassq (Qdisplay
,
6175 XFRAME (frame
)->param_alist
)),
6181 CHECK_LIVE_FRAME (frame
);
6184 for (i
= 0; i
< LFACE_VECTOR_SIZE
; i
++)
6185 attrs
[i
] = Qunspecified
;
6186 merge_face_ref (f
, attributes
, attrs
, 1, 0);
6188 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6189 if (def_face
== NULL
)
6191 if (! realize_basic_faces (f
))
6192 error ("Cannot realize default face");
6193 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6196 /* Dispatch to the appropriate handler. */
6197 if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
6198 supports
= tty_supports_face_attributes_p (f
, attrs
, def_face
);
6199 #ifdef HAVE_WINDOW_SYSTEM
6201 supports
= x_supports_face_attributes_p (f
, attrs
, def_face
);
6204 return supports
? Qt
: Qnil
;
6208 /***********************************************************************
6210 ***********************************************************************/
6212 DEFUN ("internal-set-font-selection-order",
6213 Finternal_set_font_selection_order
,
6214 Sinternal_set_font_selection_order
, 1, 1, 0,
6215 doc
: /* Set font selection order for face font selection to ORDER.
6216 ORDER must be a list of length 4 containing the symbols `:width',
6217 `:height', `:weight', and `:slant'. Face attributes appearing
6218 first in ORDER are matched first, e.g. if `:height' appears before
6219 `:weight' in ORDER, font selection first tries to find a font with
6220 a suitable height, and then tries to match the font weight.
6227 int indices
[DIM (font_sort_order
)];
6230 bzero (indices
, sizeof indices
);
6234 CONSP (list
) && i
< DIM (indices
);
6235 list
= XCDR (list
), ++i
)
6237 Lisp_Object attr
= XCAR (list
);
6240 if (EQ (attr
, QCwidth
))
6242 else if (EQ (attr
, QCheight
))
6243 xlfd
= XLFD_POINT_SIZE
;
6244 else if (EQ (attr
, QCweight
))
6246 else if (EQ (attr
, QCslant
))
6251 if (indices
[i
] != 0)
6256 if (!NILP (list
) || i
!= DIM (indices
))
6257 signal_error ("Invalid font sort order", order
);
6258 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6259 if (indices
[i
] == 0)
6260 signal_error ("Invalid font sort order", order
);
6262 if (bcmp (indices
, font_sort_order
, sizeof indices
) != 0)
6264 bcopy (indices
, font_sort_order
, sizeof font_sort_order
);
6265 free_all_realized_faces (Qnil
);
6272 DEFUN ("internal-set-alternative-font-family-alist",
6273 Finternal_set_alternative_font_family_alist
,
6274 Sinternal_set_alternative_font_family_alist
, 1, 1, 0,
6275 doc
: /* Define alternative font families to try in face font selection.
6276 ALIST is an alist of (FAMILY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6277 Each ALTERNATIVE is tried in order if no fonts of font family FAMILY can
6278 be found. Value is ALIST. */)
6283 Vface_alternative_font_family_alist
= alist
;
6284 free_all_realized_faces (Qnil
);
6289 DEFUN ("internal-set-alternative-font-registry-alist",
6290 Finternal_set_alternative_font_registry_alist
,
6291 Sinternal_set_alternative_font_registry_alist
, 1, 1, 0,
6292 doc
: /* Define alternative font registries to try in face font selection.
6293 ALIST is an alist of (REGISTRY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6294 Each ALTERNATIVE is tried in order if no fonts of font registry REGISTRY can
6295 be found. Value is ALIST. */)
6300 Vface_alternative_font_registry_alist
= alist
;
6301 free_all_realized_faces (Qnil
);
6306 #ifdef HAVE_WINDOW_SYSTEM
6308 /* Value is non-zero if FONT is the name of a scalable font. The
6309 X11R6 XLFD spec says that point size, pixel size, and average width
6310 are zero for scalable fonts. Intlfonts contain at least one
6311 scalable font ("*-muleindian-1") for which this isn't true, so we
6312 just test average width. */
6315 font_scalable_p (font
)
6316 struct font_name
*font
;
6318 char *s
= font
->fields
[XLFD_AVGWIDTH
];
6319 return (*s
== '0' && *(s
+ 1) == '\0')
6321 /* Windows implementation of XLFD is slightly broken for backward
6322 compatibility with previous broken versions, so test for
6323 wildcards as well as 0. */
6330 /* Ignore the difference of font point size less than this value. */
6332 #define FONT_POINT_SIZE_QUANTUM 5
6334 /* Value is non-zero if FONT1 is a better match for font attributes
6335 VALUES than FONT2. VALUES is an array of face attribute values in
6336 font sort order. COMPARE_PT_P zero means don't compare point
6337 sizes. AVGWIDTH, if not zero, is a specified font average width
6341 better_font_p (values
, font1
, font2
, compare_pt_p
, avgwidth
)
6343 struct font_name
*font1
, *font2
;
6344 int compare_pt_p
, avgwidth
;
6348 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6350 int xlfd_idx
= font_sort_order
[i
];
6352 if (compare_pt_p
|| xlfd_idx
!= XLFD_POINT_SIZE
)
6356 if (xlfd_idx
== XLFD_POINT_SIZE
)
6358 delta1
= abs (values
[i
] - (font1
->numeric
[xlfd_idx
]
6359 / font1
->rescale_ratio
));
6360 delta2
= abs (values
[i
] - (font2
->numeric
[xlfd_idx
]
6361 / font2
->rescale_ratio
));
6362 if (abs (delta1
- delta2
) < FONT_POINT_SIZE_QUANTUM
)
6367 delta1
= abs (values
[i
] - font1
->numeric
[xlfd_idx
]);
6368 delta2
= abs (values
[i
] - font2
->numeric
[xlfd_idx
]);
6371 if (delta1
> delta2
)
6373 else if (delta1
< delta2
)
6377 /* The difference may be equal because, e.g., the face
6378 specifies `italic' but we have only `regular' and
6379 `oblique'. Prefer `oblique' in this case. */
6380 if ((xlfd_idx
== XLFD_WEIGHT
|| xlfd_idx
== XLFD_SLANT
)
6381 && font1
->numeric
[xlfd_idx
] > values
[i
]
6382 && font2
->numeric
[xlfd_idx
] < values
[i
])
6390 int delta1
= abs (avgwidth
- font1
->numeric
[XLFD_AVGWIDTH
]);
6391 int delta2
= abs (avgwidth
- font2
->numeric
[XLFD_AVGWIDTH
]);
6392 if (delta1
> delta2
)
6394 else if (delta1
< delta2
)
6400 /* We prefer a real scalable font; i.e. not what autoscaled. */
6401 int auto_scaled_1
= (font1
->numeric
[XLFD_POINT_SIZE
] == 0
6402 && font1
->numeric
[XLFD_RESY
] > 0);
6403 int auto_scaled_2
= (font2
->numeric
[XLFD_POINT_SIZE
] == 0
6404 && font2
->numeric
[XLFD_RESY
] > 0);
6406 if (auto_scaled_1
!= auto_scaled_2
)
6407 return auto_scaled_2
;
6410 return font1
->registry_priority
< font2
->registry_priority
;
6414 /* Value is non-zero if FONT is an exact match for face attributes in
6415 SPECIFIED. SPECIFIED is an array of face attribute values in font
6416 sort order. AVGWIDTH, if non-zero, is an average width to compare
6420 exact_face_match_p (specified
, font
, avgwidth
)
6422 struct font_name
*font
;
6427 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6428 if (specified
[i
] != font
->numeric
[font_sort_order
[i
]])
6431 return (i
== DIM (font_sort_order
)
6433 || avgwidth
== font
->numeric
[XLFD_AVGWIDTH
]));
6437 /* Value is the name of a scaled font, generated from scalable font
6438 FONT on frame F. SPECIFIED_PT is the point-size to scale FONT to.
6439 Value is allocated from heap. */
6442 build_scalable_font_name (f
, font
, specified_pt
)
6444 struct font_name
*font
;
6447 char pixel_size
[20];
6449 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
6452 /* If scalable font is for a specific resolution, compute
6453 the point size we must specify from the resolution of
6454 the display and the specified resolution of the font. */
6455 if (font
->numeric
[XLFD_RESY
] != 0)
6457 pt
= resy
/ font
->numeric
[XLFD_RESY
] * specified_pt
+ 0.5;
6458 pixel_value
= font
->numeric
[XLFD_RESY
] / (PT_PER_INCH
* 10.0) * pt
+ 0.5;
6463 pixel_value
= resy
/ (PT_PER_INCH
* 10.0) * pt
+ 0.5;
6465 /* We may need a font of the different size. */
6466 pixel_value
*= font
->rescale_ratio
;
6468 /* We should keep POINT_SIZE 0. Otherwise, X server can't open a
6469 font of the specified PIXEL_SIZE. */
6471 { /* Set point size of the font. */
6472 char point_size
[20];
6473 sprintf (point_size
, "%d", (int) pt
);
6474 font
->fields
[XLFD_POINT_SIZE
] = point_size
;
6475 font
->numeric
[XLFD_POINT_SIZE
] = pt
;
6479 /* Set pixel size. */
6480 sprintf (pixel_size
, "%d", pixel_value
);
6481 font
->fields
[XLFD_PIXEL_SIZE
] = pixel_size
;
6482 font
->numeric
[XLFD_PIXEL_SIZE
] = pixel_value
;
6484 /* If font doesn't specify its resolution, use the
6485 resolution of the display. */
6486 if (font
->numeric
[XLFD_RESY
] == 0)
6489 sprintf (buffer
, "%d", (int) resy
);
6490 font
->fields
[XLFD_RESY
] = buffer
;
6491 font
->numeric
[XLFD_RESY
] = resy
;
6494 if (strcmp (font
->fields
[XLFD_RESX
], "0") == 0)
6497 int resx
= FRAME_X_DISPLAY_INFO (f
)->resx
;
6498 sprintf (buffer
, "%d", resx
);
6499 font
->fields
[XLFD_RESX
] = buffer
;
6500 font
->numeric
[XLFD_RESX
] = resx
;
6503 return build_font_name (font
);
6507 /* Value is non-zero if we are allowed to use scalable font FONT. We
6508 can't run a Lisp function here since this function may be called
6509 with input blocked. */
6512 may_use_scalable_font_p (font
)
6515 if (EQ (Vscalable_fonts_allowed
, Qt
))
6517 else if (CONSP (Vscalable_fonts_allowed
))
6519 Lisp_Object tail
, regexp
;
6521 for (tail
= Vscalable_fonts_allowed
; CONSP (tail
); tail
= XCDR (tail
))
6523 regexp
= XCAR (tail
);
6524 if (STRINGP (regexp
)
6525 && fast_c_string_match_ignore_case (regexp
, font
) >= 0)
6535 /* Return the name of the best matching font for face attributes ATTRS
6536 in the array of font_name structures FONTS which contains NFONTS
6537 elements. WIDTH_RATIO is a factor with which to multiply average
6538 widths if ATTRS specifies such a width.
6540 Value is a font name which is allocated from the heap. FONTS is
6541 freed by this function.
6543 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
6544 indicate whether the resulting font should be drawn using overstrike
6545 to simulate bold-face. */
6548 best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
, needs_overstrike
)
6551 struct font_name
*fonts
;
6554 int *needs_overstrike
;
6557 struct font_name
*best
;
6560 int exact_p
, avgwidth
;
6565 /* Make specified font attributes available in `specified',
6566 indexed by sort order. */
6567 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6569 int xlfd_idx
= font_sort_order
[i
];
6571 if (xlfd_idx
== XLFD_SWIDTH
)
6572 specified
[i
] = face_numeric_swidth (attrs
[LFACE_SWIDTH_INDEX
]);
6573 else if (xlfd_idx
== XLFD_POINT_SIZE
)
6574 specified
[i
] = pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
6575 else if (xlfd_idx
== XLFD_WEIGHT
)
6576 specified
[i
] = face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
6577 else if (xlfd_idx
== XLFD_SLANT
)
6578 specified
[i
] = face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
6583 avgwidth
= (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
6585 : XFASTINT (attrs
[LFACE_AVGWIDTH_INDEX
]) * width_ratio
);
6589 if (needs_overstrike
)
6590 *needs_overstrike
= 0;
6592 /* Start with the first non-scalable font in the list. */
6593 for (i
= 0; i
< nfonts
; ++i
)
6594 if (!font_scalable_p (fonts
+ i
))
6597 /* Find the best match among the non-scalable fonts. */
6602 for (i
= 1; i
< nfonts
; ++i
)
6603 if (!font_scalable_p (fonts
+ i
)
6604 && better_font_p (specified
, fonts
+ i
, best
, 1, avgwidth
))
6608 exact_p
= exact_face_match_p (specified
, best
, avgwidth
);
6616 /* Unless we found an exact match among non-scalable fonts, see if
6617 we can find a better match among scalable fonts. */
6620 /* A scalable font is better if
6622 1. its weight, slant, swidth attributes are better, or.
6624 2. the best non-scalable font doesn't have the required
6625 point size, and the scalable fonts weight, slant, swidth
6628 int non_scalable_has_exact_height_p
;
6630 if (best
&& best
->numeric
[XLFD_POINT_SIZE
] == pt
)
6631 non_scalable_has_exact_height_p
= 1;
6633 non_scalable_has_exact_height_p
= 0;
6635 for (i
= 0; i
< nfonts
; ++i
)
6636 if (font_scalable_p (fonts
+ i
))
6639 || better_font_p (specified
, fonts
+ i
, best
, 0, 0)
6640 || (!non_scalable_has_exact_height_p
6641 && !better_font_p (specified
, best
, fonts
+ i
, 0, 0)))
6643 non_scalable_has_exact_height_p
= 1;
6648 if (needs_overstrike
)
6650 enum xlfd_weight want_weight
= specified
[XLFD_WEIGHT
];
6651 enum xlfd_weight got_weight
= best
->numeric
[XLFD_WEIGHT
];
6653 if (want_weight
> XLFD_WEIGHT_MEDIUM
&& want_weight
> got_weight
)
6655 /* We want a bold font, but didn't get one; try to use
6656 overstriking instead to simulate bold-face. However,
6657 don't overstrike an already-bold fontn unless the
6658 desired weight grossly exceeds the available weight. */
6659 if (got_weight
> XLFD_WEIGHT_MEDIUM
)
6660 *needs_overstrike
= (got_weight
- want_weight
) > 2;
6662 *needs_overstrike
= 1;
6667 if (font_scalable_p (best
))
6668 font_name
= build_scalable_font_name (f
, best
, pt
);
6670 font_name
= build_font_name (best
);
6672 /* Free font_name structures. */
6673 free_font_names (fonts
, nfonts
);
6679 /* Get a list of matching fonts on frame F, considering FAMILY
6680 and alternative font families from Vface_alternative_font_registry_alist.
6682 FAMILY is the font family whose alternatives are considered.
6684 REGISTRY, if a string, specifies a font registry and encoding to
6685 match. A value of nil means include fonts of any registry and
6688 Return in *FONTS a pointer to a vector of font_name structures for
6689 the fonts matched. Value is the number of fonts found. */
6692 try_alternative_families (f
, family
, registry
, fonts
)
6694 Lisp_Object family
, registry
;
6695 struct font_name
**fonts
;
6700 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
6703 /* Try alternative font families. */
6704 alter
= Fassoc (family
, Vface_alternative_font_family_alist
);
6707 for (alter
= XCDR (alter
);
6708 CONSP (alter
) && nfonts
== 0;
6709 alter
= XCDR (alter
))
6711 if (STRINGP (XCAR (alter
)))
6712 nfonts
= font_list (f
, Qnil
, XCAR (alter
), registry
, fonts
);
6716 /* Try all scalable fonts before giving up. */
6717 if (nfonts
== 0 && ! EQ (Vscalable_fonts_allowed
, Qt
))
6719 int count
= SPECPDL_INDEX ();
6720 specbind (Qscalable_fonts_allowed
, Qt
);
6721 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6722 unbind_to (count
, Qnil
);
6729 /* Get a list of matching fonts on frame F.
6731 FAMILY, if a string, specifies a font family derived from the fontset.
6732 It is only used if the face does not specify any family in ATTRS or
6733 if we cannot find any font of the face's family.
6735 REGISTRY, if a string, specifies a font registry and encoding to
6736 match. A value of nil means include fonts of any registry and
6739 If PREFER_FACE_FAMILY is nonzero, perfer face's family to FAMILY.
6740 Otherwise, prefer FAMILY.
6742 Return in *FONTS a pointer to a vector of font_name structures for
6743 the fonts matched. Value is the number of fonts found. */
6746 try_font_list (f
, attrs
, family
, registry
, fonts
, prefer_face_family
)
6749 Lisp_Object family
, registry
;
6750 struct font_name
**fonts
;
6751 int prefer_face_family
;
6754 Lisp_Object face_family
= attrs
[LFACE_FAMILY_INDEX
];
6755 Lisp_Object try_family
;
6757 try_family
= (prefer_face_family
|| NILP (family
)) ? face_family
: family
;
6759 if (STRINGP (try_family
))
6760 nfonts
= try_alternative_families (f
, try_family
, registry
, fonts
);
6763 if (nfonts
== 0 && STRINGP (try_family
) && STRINGP (registry
))
6764 if (xstricmp (SDATA (registry
), "mac-roman") == 0)
6765 /* When realizing the default face and a font spec does not
6766 matched exactly, Emacs looks for ones with the same registry
6767 as the default font. On the Mac, this is mac-roman, which
6768 does not work if the family is -etl-fixed, e.g. The
6769 following widens the choices and fixes that problem. */
6770 nfonts
= try_alternative_families (f
, try_family
, Qnil
, fonts
);
6771 else if (SBYTES (try_family
) > 0
6772 && SREF (try_family
, SBYTES (try_family
) - 1) != '*')
6773 /* Some Central European/Cyrillic font family names have the
6774 Roman counterpart name as their prefix. */
6775 nfonts
= try_alternative_families (f
, concat2 (try_family
,
6776 build_string ("*")),
6780 if (EQ (try_family
, family
))
6781 family
= face_family
;
6783 if (nfonts
== 0 && STRINGP (family
))
6784 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6786 /* Try font family of the default face or "fixed". */
6789 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6791 family
= default_face
->lface
[LFACE_FAMILY_INDEX
];
6793 family
= build_string ("fixed");
6794 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
6797 /* Try any family with the given registry. */
6799 nfonts
= try_alternative_families (f
, Qnil
, registry
, fonts
);
6805 /* Return the fontset id of the base fontset name or alias name given
6806 by the fontset attribute of ATTRS. Value is -1 if the fontset
6807 attribute of ATTRS doesn't name a fontset. */
6810 face_fontset (attrs
)
6815 name
= attrs
[LFACE_FONT_INDEX
];
6816 if (!STRINGP (name
))
6818 return fs_query_fontset (name
, 0);
6822 /* Choose a name of font to use on frame F to display character C with
6823 Lisp face attributes specified by ATTRS. The font name is
6824 determined by the font-related attributes in ATTRS and the name
6825 pattern for C in FONTSET. Value is the font name which is
6826 allocated from the heap and must be freed by the caller, or NULL if
6827 we can get no information about the font name of C. It is assured
6828 that we always get some information for a single byte
6831 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
6832 indicate whether the resulting font should be drawn using overstrike
6833 to simulate bold-face. */
6836 choose_face_font (f
, attrs
, fontset
, c
, needs_overstrike
)
6840 int *needs_overstrike
;
6842 Lisp_Object pattern
;
6843 char *font_name
= NULL
;
6844 struct font_name
*fonts
;
6845 int nfonts
, width_ratio
;
6847 if (needs_overstrike
)
6848 *needs_overstrike
= 0;
6850 /* Get (foundry and) family name and registry (and encoding) name of
6852 pattern
= fontset_font_pattern (f
, fontset
, c
);
6855 xassert (!SINGLE_BYTE_CHAR_P (c
));
6859 /* If what we got is a name pattern, return it. */
6860 if (STRINGP (pattern
))
6861 return xstrdup (SDATA (pattern
));
6863 /* Get a list of fonts matching that pattern and choose the
6864 best match for the specified face attributes from it. */
6865 nfonts
= try_font_list (f
, attrs
, XCAR (pattern
), XCDR (pattern
), &fonts
,
6866 (SINGLE_BYTE_CHAR_P (c
)
6867 || CHAR_CHARSET (c
) == charset_latin_iso8859_1
));
6868 width_ratio
= (SINGLE_BYTE_CHAR_P (c
)
6870 : CHARSET_WIDTH (CHAR_CHARSET (c
)));
6871 font_name
= best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
,
6876 #endif /* HAVE_WINDOW_SYSTEM */
6880 /***********************************************************************
6882 ***********************************************************************/
6884 /* Realize basic faces on frame F. Value is zero if frame parameters
6885 of F don't contain enough information needed to realize the default
6889 realize_basic_faces (f
)
6893 int count
= SPECPDL_INDEX ();
6895 /* Block input here so that we won't be surprised by an X expose
6896 event, for instance, without having the faces set up. */
6898 specbind (Qscalable_fonts_allowed
, Qt
);
6900 if (realize_default_face (f
))
6902 realize_named_face (f
, Qmode_line
, MODE_LINE_FACE_ID
);
6903 realize_named_face (f
, Qmode_line_inactive
, MODE_LINE_INACTIVE_FACE_ID
);
6904 realize_named_face (f
, Qtool_bar
, TOOL_BAR_FACE_ID
);
6905 realize_named_face (f
, Qfringe
, FRINGE_FACE_ID
);
6906 realize_named_face (f
, Qheader_line
, HEADER_LINE_FACE_ID
);
6907 realize_named_face (f
, Qscroll_bar
, SCROLL_BAR_FACE_ID
);
6908 realize_named_face (f
, Qborder
, BORDER_FACE_ID
);
6909 realize_named_face (f
, Qcursor
, CURSOR_FACE_ID
);
6910 realize_named_face (f
, Qmouse
, MOUSE_FACE_ID
);
6911 realize_named_face (f
, Qmenu
, MENU_FACE_ID
);
6912 realize_named_face (f
, Qvertical_border
, VERTICAL_BORDER_FACE_ID
);
6914 /* Reflect changes in the `menu' face in menu bars. */
6915 if (FRAME_FACE_CACHE (f
)->menu_face_changed_p
)
6917 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 0;
6918 #ifdef USE_X_TOOLKIT
6919 if (FRAME_WINDOW_P (f
))
6920 x_update_menu_appearance (f
);
6927 unbind_to (count
, Qnil
);
6933 /* Realize the default face on frame F. If the face is not fully
6934 specified, make it fully-specified. Attributes of the default face
6935 that are not explicitly specified are taken from frame parameters. */
6938 realize_default_face (f
)
6941 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
6943 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6944 Lisp_Object frame_font
;
6947 /* If the `default' face is not yet known, create it. */
6948 lface
= lface_from_face_name (f
, Qdefault
, 0);
6952 XSETFRAME (frame
, f
);
6953 lface
= Finternal_make_lisp_face (Qdefault
, frame
);
6957 #ifdef HAVE_WINDOW_SYSTEM
6958 if (FRAME_WINDOW_P (f
))
6960 /* Set frame_font to the value of the `font' frame parameter. */
6961 frame_font
= Fassq (Qfont
, f
->param_alist
);
6962 xassert (CONSP (frame_font
) && STRINGP (XCDR (frame_font
)));
6963 frame_font
= XCDR (frame_font
);
6964 set_lface_from_font_name (f
, lface
, frame_font
,
6965 f
->default_face_done_p
, 1);
6966 f
->default_face_done_p
= 1;
6968 #endif /* HAVE_WINDOW_SYSTEM */
6970 if (!FRAME_WINDOW_P (f
))
6972 LFACE_FAMILY (lface
) = build_string ("default");
6973 LFACE_SWIDTH (lface
) = Qnormal
;
6974 LFACE_HEIGHT (lface
) = make_number (1);
6975 if (UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
6976 LFACE_WEIGHT (lface
) = Qnormal
;
6977 if (UNSPECIFIEDP (LFACE_SLANT (lface
)))
6978 LFACE_SLANT (lface
) = Qnormal
;
6979 LFACE_AVGWIDTH (lface
) = Qunspecified
;
6982 if (UNSPECIFIEDP (LFACE_UNDERLINE (lface
)))
6983 LFACE_UNDERLINE (lface
) = Qnil
;
6985 if (UNSPECIFIEDP (LFACE_OVERLINE (lface
)))
6986 LFACE_OVERLINE (lface
) = Qnil
;
6988 if (UNSPECIFIEDP (LFACE_STRIKE_THROUGH (lface
)))
6989 LFACE_STRIKE_THROUGH (lface
) = Qnil
;
6991 if (UNSPECIFIEDP (LFACE_BOX (lface
)))
6992 LFACE_BOX (lface
) = Qnil
;
6994 if (UNSPECIFIEDP (LFACE_INVERSE (lface
)))
6995 LFACE_INVERSE (lface
) = Qnil
;
6997 if (UNSPECIFIEDP (LFACE_FOREGROUND (lface
)))
6999 /* This function is called so early that colors are not yet
7000 set in the frame parameter list. */
7001 Lisp_Object color
= Fassq (Qforeground_color
, f
->param_alist
);
7003 if (CONSP (color
) && STRINGP (XCDR (color
)))
7004 LFACE_FOREGROUND (lface
) = XCDR (color
);
7005 else if (FRAME_WINDOW_P (f
))
7007 else if (FRAME_INITIAL_P (f
) || FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
7008 LFACE_FOREGROUND (lface
) = build_string (unspecified_fg
);
7013 if (UNSPECIFIEDP (LFACE_BACKGROUND (lface
)))
7015 /* This function is called so early that colors are not yet
7016 set in the frame parameter list. */
7017 Lisp_Object color
= Fassq (Qbackground_color
, f
->param_alist
);
7018 if (CONSP (color
) && STRINGP (XCDR (color
)))
7019 LFACE_BACKGROUND (lface
) = XCDR (color
);
7020 else if (FRAME_WINDOW_P (f
))
7022 else if (FRAME_INITIAL_P (f
) || FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
7023 LFACE_BACKGROUND (lface
) = build_string (unspecified_bg
);
7028 if (UNSPECIFIEDP (LFACE_STIPPLE (lface
)))
7029 LFACE_STIPPLE (lface
) = Qnil
;
7031 /* Realize the face; it must be fully-specified now. */
7032 xassert (lface_fully_specified_p (XVECTOR (lface
)->contents
));
7033 check_lface (lface
);
7034 bcopy (XVECTOR (lface
)->contents
, attrs
, sizeof attrs
);
7035 face
= realize_face (c
, attrs
, 0, NULL
, DEFAULT_FACE_ID
);
7040 /* Realize basic faces other than the default face in face cache C.
7041 SYMBOL is the face name, ID is the face id the realized face must
7042 have. The default face must have been realized already. */
7045 realize_named_face (f
, symbol
, id
)
7050 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
7051 Lisp_Object lface
= lface_from_face_name (f
, symbol
, 0);
7052 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7053 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
7054 struct face
*new_face
;
7056 /* The default face must exist and be fully specified. */
7057 get_lface_attributes (f
, Qdefault
, attrs
, 1);
7058 check_lface_attrs (attrs
);
7059 xassert (lface_fully_specified_p (attrs
));
7061 /* If SYMBOL isn't know as a face, create it. */
7065 XSETFRAME (frame
, f
);
7066 lface
= Finternal_make_lisp_face (symbol
, frame
);
7069 /* Merge SYMBOL's face with the default face. */
7070 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
7071 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
7073 /* Realize the face. */
7074 new_face
= realize_face (c
, attrs
, 0, NULL
, id
);
7078 /* Realize the fully-specified face with attributes ATTRS in face
7079 cache CACHE for character C. If C is a multibyte character,
7080 BASE_FACE is a face that has the same attributes. Otherwise,
7081 BASE_FACE is ignored. If FORMER_FACE_ID is non-negative, it is an
7082 ID of face to remove before caching the new face. Value is a
7083 pointer to the newly created realized face. */
7085 static struct face
*
7086 realize_face (cache
, attrs
, c
, base_face
, former_face_id
)
7087 struct face_cache
*cache
;
7090 struct face
*base_face
;
7095 /* LFACE must be fully specified. */
7096 xassert (cache
!= NULL
);
7097 check_lface_attrs (attrs
);
7099 if (former_face_id
>= 0 && cache
->used
> former_face_id
)
7101 /* Remove the former face. */
7102 struct face
*former_face
= cache
->faces_by_id
[former_face_id
];
7103 uncache_face (cache
, former_face
);
7104 free_realized_face (cache
->f
, former_face
);
7107 if (FRAME_WINDOW_P (cache
->f
))
7108 face
= realize_x_face (cache
, attrs
, c
, base_face
);
7109 else if (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
))
7110 face
= realize_tty_face (cache
, attrs
, c
);
7111 else if (FRAME_INITIAL_P (cache
->f
))
7113 /* Create a dummy face. */
7114 face
= make_realized_face (attrs
);
7119 /* Insert the new face. */
7120 cache_face (cache
, face
, lface_hash (attrs
));
7121 #ifdef HAVE_WINDOW_SYSTEM
7122 if (FRAME_WINDOW_P (cache
->f
) && face
->font
== NULL
)
7123 load_face_font (cache
->f
, face
, c
);
7124 #endif /* HAVE_WINDOW_SYSTEM */
7129 /* Realize the fully-specified face with attributes ATTRS in face
7130 cache CACHE for character C. Do it for X frame CACHE->f. If C is
7131 a multibyte character, BASE_FACE is a face that has the same
7132 attributes. Otherwise, BASE_FACE is ignored. If the new face
7133 doesn't share font with the default face, a fontname is allocated
7134 from the heap and set in `font_name' of the new face, but it is not
7135 yet loaded here. Value is a pointer to the newly created realized
7138 static struct face
*
7139 realize_x_face (cache
, attrs
, c
, base_face
)
7140 struct face_cache
*cache
;
7143 struct face
*base_face
;
7145 struct face
*face
= NULL
;
7146 #ifdef HAVE_WINDOW_SYSTEM
7147 struct face
*default_face
;
7149 Lisp_Object stipple
, overline
, strike_through
, box
;
7151 xassert (FRAME_WINDOW_P (cache
->f
));
7152 xassert (SINGLE_BYTE_CHAR_P (c
)
7155 /* Allocate a new realized face. */
7156 face
= make_realized_face (attrs
);
7160 /* If C is a multibyte character, we share all face attirbutes with
7161 BASE_FACE including the realized fontset. But, we must load a
7163 if (!SINGLE_BYTE_CHAR_P (c
))
7165 bcopy (base_face
, face
, sizeof *face
);
7168 /* Don't try to free the colors copied bitwise from BASE_FACE. */
7169 face
->colors_copied_bitwise_p
= 1;
7171 /* to force realize_face to load font */
7176 /* Now we are realizing a face for ASCII (and unibyte) characters. */
7178 /* Determine the font to use. Most of the time, the font will be
7179 the same as the font of the default face, so try that first. */
7180 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7182 && FACE_SUITABLE_FOR_CHAR_P (default_face
, c
)
7183 && lface_same_font_attributes_p (default_face
->lface
, attrs
))
7185 face
->font
= default_face
->font
;
7186 face
->fontset
= default_face
->fontset
;
7187 face
->font_info_id
= default_face
->font_info_id
;
7188 face
->font_name
= default_face
->font_name
;
7189 face
->ascii_face
= face
;
7191 /* But, as we can't share the fontset, make a new realized
7192 fontset that has the same base fontset as of the default
7195 = make_fontset_for_ascii_face (f
, default_face
->fontset
);
7199 /* If the face attribute ATTRS specifies a fontset, use it as
7200 the base of a new realized fontset. Otherwise, use the same
7201 base fontset as of the default face. The base determines
7202 registry and encoding of a font. It may also determine
7203 foundry and family. The other fields of font name pattern
7204 are constructed from ATTRS. */
7205 int fontset
= face_fontset (attrs
);
7207 if ((fontset
== -1) && default_face
)
7208 fontset
= default_face
->fontset
;
7209 face
->fontset
= make_fontset_for_ascii_face (f
, fontset
);
7210 face
->font
= NULL
; /* to force realize_face to load font */
7213 /* Load colors, and set remaining attributes. */
7215 load_face_colors (f
, face
, attrs
);
7218 box
= attrs
[LFACE_BOX_INDEX
];
7221 /* A simple box of line width 1 drawn in color given by
7223 face
->box_color
= load_color (f
, face
, attrs
[LFACE_BOX_INDEX
],
7225 face
->box
= FACE_SIMPLE_BOX
;
7226 face
->box_line_width
= 1;
7228 else if (INTEGERP (box
))
7230 /* Simple box of specified line width in foreground color of the
7232 xassert (XINT (box
) != 0);
7233 face
->box
= FACE_SIMPLE_BOX
;
7234 face
->box_line_width
= XINT (box
);
7235 face
->box_color
= face
->foreground
;
7236 face
->box_color_defaulted_p
= 1;
7238 else if (CONSP (box
))
7240 /* `(:width WIDTH :color COLOR :shadow SHADOW)'. SHADOW
7241 being one of `raised' or `sunken'. */
7242 face
->box
= FACE_SIMPLE_BOX
;
7243 face
->box_color
= face
->foreground
;
7244 face
->box_color_defaulted_p
= 1;
7245 face
->box_line_width
= 1;
7249 Lisp_Object keyword
, value
;
7251 keyword
= XCAR (box
);
7259 if (EQ (keyword
, QCline_width
))
7261 if (INTEGERP (value
) && XINT (value
) != 0)
7262 face
->box_line_width
= XINT (value
);
7264 else if (EQ (keyword
, QCcolor
))
7266 if (STRINGP (value
))
7268 face
->box_color
= load_color (f
, face
, value
,
7270 face
->use_box_color_for_shadows_p
= 1;
7273 else if (EQ (keyword
, QCstyle
))
7275 if (EQ (value
, Qreleased_button
))
7276 face
->box
= FACE_RAISED_BOX
;
7277 else if (EQ (value
, Qpressed_button
))
7278 face
->box
= FACE_SUNKEN_BOX
;
7283 /* Text underline, overline, strike-through. */
7285 if (EQ (attrs
[LFACE_UNDERLINE_INDEX
], Qt
))
7287 /* Use default color (same as foreground color). */
7288 face
->underline_p
= 1;
7289 face
->underline_defaulted_p
= 1;
7290 face
->underline_color
= 0;
7292 else if (STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]))
7294 /* Use specified color. */
7295 face
->underline_p
= 1;
7296 face
->underline_defaulted_p
= 0;
7297 face
->underline_color
7298 = load_color (f
, face
, attrs
[LFACE_UNDERLINE_INDEX
],
7299 LFACE_UNDERLINE_INDEX
);
7301 else if (NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7303 face
->underline_p
= 0;
7304 face
->underline_defaulted_p
= 0;
7305 face
->underline_color
= 0;
7308 overline
= attrs
[LFACE_OVERLINE_INDEX
];
7309 if (STRINGP (overline
))
7311 face
->overline_color
7312 = load_color (f
, face
, attrs
[LFACE_OVERLINE_INDEX
],
7313 LFACE_OVERLINE_INDEX
);
7314 face
->overline_p
= 1;
7316 else if (EQ (overline
, Qt
))
7318 face
->overline_color
= face
->foreground
;
7319 face
->overline_color_defaulted_p
= 1;
7320 face
->overline_p
= 1;
7323 strike_through
= attrs
[LFACE_STRIKE_THROUGH_INDEX
];
7324 if (STRINGP (strike_through
))
7326 face
->strike_through_color
7327 = load_color (f
, face
, attrs
[LFACE_STRIKE_THROUGH_INDEX
],
7328 LFACE_STRIKE_THROUGH_INDEX
);
7329 face
->strike_through_p
= 1;
7331 else if (EQ (strike_through
, Qt
))
7333 face
->strike_through_color
= face
->foreground
;
7334 face
->strike_through_color_defaulted_p
= 1;
7335 face
->strike_through_p
= 1;
7338 stipple
= attrs
[LFACE_STIPPLE_INDEX
];
7339 if (!NILP (stipple
))
7340 face
->stipple
= load_pixmap (f
, stipple
, &face
->pixmap_w
, &face
->pixmap_h
);
7342 xassert (FACE_SUITABLE_FOR_CHAR_P (face
, c
));
7343 #endif /* HAVE_WINDOW_SYSTEM */
7348 /* Map a specified color of face FACE on frame F to a tty color index.
7349 IDX is either LFACE_FOREGROUND_INDEX or LFACE_BACKGROUND_INDEX, and
7350 specifies which color to map. Set *DEFAULTED to 1 if mapping to the
7351 default foreground/background colors. */
7354 map_tty_color (f
, face
, idx
, defaulted
)
7357 enum lface_attribute_index idx
;
7360 Lisp_Object frame
, color
, def
;
7361 int foreground_p
= idx
== LFACE_FOREGROUND_INDEX
;
7362 unsigned long default_pixel
, default_other_pixel
, pixel
;
7364 xassert (idx
== LFACE_FOREGROUND_INDEX
|| idx
== LFACE_BACKGROUND_INDEX
);
7368 pixel
= default_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7369 default_other_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7373 pixel
= default_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7374 default_other_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7377 XSETFRAME (frame
, f
);
7378 color
= face
->lface
[idx
];
7382 && CONSP (Vtty_defined_color_alist
)
7383 && (def
= assq_no_quit (color
, call1 (Qtty_color_alist
, frame
)),
7386 /* Associations in tty-defined-color-alist are of the form
7387 (NAME INDEX R G B). We need the INDEX part. */
7388 pixel
= XINT (XCAR (XCDR (def
)));
7391 if (pixel
== default_pixel
&& STRINGP (color
))
7393 pixel
= load_color (f
, face
, color
, idx
);
7395 #if defined (MSDOS) || defined (WINDOWSNT)
7396 /* If the foreground of the default face is the default color,
7397 use the foreground color defined by the frame. */
7399 if (FRAME_MSDOS_P (f
))
7402 if (pixel
== default_pixel
7403 || pixel
== FACE_TTY_DEFAULT_COLOR
)
7406 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7408 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7409 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7412 else if (pixel
== default_other_pixel
)
7415 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7417 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7418 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7424 #endif /* MSDOS or WINDOWSNT */
7428 face
->foreground
= pixel
;
7430 face
->background
= pixel
;
7434 /* Realize the fully-specified face with attributes ATTRS in face
7435 cache CACHE for character C. Do it for TTY frame CACHE->f. Value is a
7436 pointer to the newly created realized face. */
7438 static struct face
*
7439 realize_tty_face (cache
, attrs
, c
)
7440 struct face_cache
*cache
;
7446 int face_colors_defaulted
= 0;
7447 struct frame
*f
= cache
->f
;
7449 /* Frame must be a termcap frame. */
7450 xassert (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
));
7452 /* Allocate a new realized face. */
7453 face
= make_realized_face (attrs
);
7454 face
->font_name
= FRAME_MSDOS_P (cache
->f
) ? "ms-dos" : "tty";
7456 /* Map face attributes to TTY appearances. We map slant to
7457 dimmed text because we want italic text to appear differently
7458 and because dimmed text is probably used infrequently. */
7459 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
7460 slant
= face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
7462 if (weight
> XLFD_WEIGHT_MEDIUM
)
7463 face
->tty_bold_p
= 1;
7464 if (weight
< XLFD_WEIGHT_MEDIUM
|| slant
!= XLFD_SLANT_ROMAN
)
7465 face
->tty_dim_p
= 1;
7466 if (!NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7467 face
->tty_underline_p
= 1;
7468 if (!NILP (attrs
[LFACE_INVERSE_INDEX
]))
7469 face
->tty_reverse_p
= 1;
7471 /* Map color names to color indices. */
7472 map_tty_color (f
, face
, LFACE_FOREGROUND_INDEX
, &face_colors_defaulted
);
7473 map_tty_color (f
, face
, LFACE_BACKGROUND_INDEX
, &face_colors_defaulted
);
7475 /* Swap colors if face is inverse-video. If the colors are taken
7476 from the frame colors, they are already inverted, since the
7477 frame-creation function calls x-handle-reverse-video. */
7478 if (face
->tty_reverse_p
&& !face_colors_defaulted
)
7480 unsigned long tem
= face
->foreground
;
7481 face
->foreground
= face
->background
;
7482 face
->background
= tem
;
7485 if (tty_suppress_bold_inverse_default_colors_p
7487 && face
->background
== FACE_TTY_DEFAULT_FG_COLOR
7488 && face
->foreground
== FACE_TTY_DEFAULT_BG_COLOR
)
7489 face
->tty_bold_p
= 0;
7495 DEFUN ("tty-suppress-bold-inverse-default-colors",
7496 Ftty_suppress_bold_inverse_default_colors
,
7497 Stty_suppress_bold_inverse_default_colors
, 1, 1, 0,
7498 doc
: /* Suppress/allow boldness of faces with inverse default colors.
7499 SUPPRESS non-nil means suppress it.
7500 This affects bold faces on TTYs whose foreground is the default background
7501 color of the display and whose background is the default foreground color.
7502 For such faces, the bold face attribute is ignored if this variable
7505 Lisp_Object suppress
;
7507 tty_suppress_bold_inverse_default_colors_p
= !NILP (suppress
);
7508 ++face_change_count
;
7514 /***********************************************************************
7516 ***********************************************************************/
7518 /* Return the ID of the face to use to display character CH with face
7519 property PROP on frame F in current_buffer. */
7522 compute_char_face (f
, ch
, prop
)
7529 if (NILP (current_buffer
->enable_multibyte_characters
))
7534 struct face
*face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7535 face_id
= FACE_FOR_CHAR (f
, face
, ch
);
7539 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7540 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7541 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7542 merge_face_ref (f
, prop
, attrs
, 1, 0);
7543 face_id
= lookup_face (f
, attrs
, ch
, NULL
);
7549 /* Return the face ID associated with buffer position POS for
7550 displaying ASCII characters. Return in *ENDPTR the position at
7551 which a different face is needed, as far as text properties and
7552 overlays are concerned. W is a window displaying current_buffer.
7554 REGION_BEG, REGION_END delimit the region, so it can be
7557 LIMIT is a position not to scan beyond. That is to limit the time
7558 this function can take.
7560 If MOUSE is non-zero, use the character's mouse-face, not its face.
7562 The face returned is suitable for displaying ASCII characters. */
7565 face_at_buffer_position (w
, pos
, region_beg
, region_end
,
7566 endptr
, limit
, mouse
)
7569 int region_beg
, region_end
;
7574 struct frame
*f
= XFRAME (w
->frame
);
7575 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7576 Lisp_Object prop
, position
;
7578 Lisp_Object
*overlay_vec
;
7581 Lisp_Object propname
= mouse
? Qmouse_face
: Qface
;
7582 Lisp_Object limit1
, end
;
7583 struct face
*default_face
;
7585 /* W must display the current buffer. We could write this function
7586 to use the frame and buffer of W, but right now it doesn't. */
7587 /* xassert (XBUFFER (w->buffer) == current_buffer); */
7589 XSETFRAME (frame
, f
);
7590 XSETFASTINT (position
, pos
);
7593 if (pos
< region_beg
&& region_beg
< endpos
)
7594 endpos
= region_beg
;
7596 /* Get the `face' or `mouse_face' text property at POS, and
7597 determine the next position at which the property changes. */
7598 prop
= Fget_text_property (position
, propname
, w
->buffer
);
7599 XSETFASTINT (limit1
, (limit
< endpos
? limit
: endpos
));
7600 end
= Fnext_single_property_change (position
, propname
, w
->buffer
, limit1
);
7602 endpos
= XINT (end
);
7604 /* Look at properties from overlays. */
7608 GET_OVERLAYS_AT (pos
, overlay_vec
, noverlays
, &next_overlay
, 0);
7609 if (next_overlay
< endpos
)
7610 endpos
= next_overlay
;
7615 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7617 /* Optimize common cases where we can use the default face. */
7620 && !(pos
>= region_beg
&& pos
< region_end
))
7621 return DEFAULT_FACE_ID
;
7623 /* Begin with attributes from the default face. */
7624 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7626 /* Merge in attributes specified via text properties. */
7628 merge_face_ref (f
, prop
, attrs
, 1, 0);
7630 /* Now merge the overlay data. */
7631 noverlays
= sort_overlays (overlay_vec
, noverlays
, w
);
7632 for (i
= 0; i
< noverlays
; i
++)
7637 prop
= Foverlay_get (overlay_vec
[i
], propname
);
7639 merge_face_ref (f
, prop
, attrs
, 1, 0);
7641 oend
= OVERLAY_END (overlay_vec
[i
]);
7642 oendpos
= OVERLAY_POSITION (oend
);
7643 if (oendpos
< endpos
)
7647 /* If in the region, merge in the region face. */
7648 if (pos
>= region_beg
&& pos
< region_end
)
7650 merge_named_face (f
, Qregion
, attrs
, 0);
7652 if (region_end
< endpos
)
7653 endpos
= region_end
;
7658 /* Look up a realized face with the given face attributes,
7659 or realize a new one for ASCII characters. */
7660 return lookup_face (f
, attrs
, 0, NULL
);
7664 /* Compute the face at character position POS in Lisp string STRING on
7665 window W, for ASCII characters.
7667 If STRING is an overlay string, it comes from position BUFPOS in
7668 current_buffer, otherwise BUFPOS is zero to indicate that STRING is
7669 not an overlay string. W must display the current buffer.
7670 REGION_BEG and REGION_END give the start and end positions of the
7671 region; both are -1 if no region is visible.
7673 BASE_FACE_ID is the id of a face to merge with. For strings coming
7674 from overlays or the `display' property it is the face at BUFPOS.
7676 If MOUSE_P is non-zero, use the character's mouse-face, not its face.
7678 Set *ENDPTR to the next position where to check for faces in
7679 STRING; -1 if the face is constant from POS to the end of the
7682 Value is the id of the face to use. The face returned is suitable
7683 for displaying ASCII characters. */
7686 face_at_string_position (w
, string
, pos
, bufpos
, region_beg
,
7687 region_end
, endptr
, base_face_id
, mouse_p
)
7691 int region_beg
, region_end
;
7693 enum face_id base_face_id
;
7696 Lisp_Object prop
, position
, end
, limit
;
7697 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
7698 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7699 struct face
*base_face
;
7700 int multibyte_p
= STRING_MULTIBYTE (string
);
7701 Lisp_Object prop_name
= mouse_p
? Qmouse_face
: Qface
;
7703 /* Get the value of the face property at the current position within
7704 STRING. Value is nil if there is no face property. */
7705 XSETFASTINT (position
, pos
);
7706 prop
= Fget_text_property (position
, prop_name
, string
);
7708 /* Get the next position at which to check for faces. Value of end
7709 is nil if face is constant all the way to the end of the string.
7710 Otherwise it is a string position where to check faces next.
7711 Limit is the maximum position up to which to check for property
7712 changes in Fnext_single_property_change. Strings are usually
7713 short, so set the limit to the end of the string. */
7714 XSETFASTINT (limit
, SCHARS (string
));
7715 end
= Fnext_single_property_change (position
, prop_name
, string
, limit
);
7717 *endptr
= XFASTINT (end
);
7721 base_face
= FACE_FROM_ID (f
, base_face_id
);
7722 xassert (base_face
);
7724 /* Optimize the default case that there is no face property and we
7725 are not in the region. */
7727 && (base_face_id
!= DEFAULT_FACE_ID
7728 /* BUFPOS <= 0 means STRING is not an overlay string, so
7729 that the region doesn't have to be taken into account. */
7731 || bufpos
< region_beg
7732 || bufpos
>= region_end
)
7734 /* We can't realize faces for different charsets differently
7735 if we don't have fonts, so we can stop here if not working
7736 on a window-system frame. */
7737 || !FRAME_WINDOW_P (f
)
7738 || FACE_SUITABLE_FOR_CHAR_P (base_face
, 0)))
7739 return base_face
->id
;
7741 /* Begin with attributes from the base face. */
7742 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
7744 /* Merge in attributes specified via text properties. */
7746 merge_face_ref (f
, prop
, attrs
, 1, 0);
7748 /* If in the region, merge in the region face. */
7750 && bufpos
>= region_beg
7751 && bufpos
< region_end
)
7752 merge_named_face (f
, Qregion
, attrs
, 0);
7754 /* Look up a realized face with the given face attributes,
7755 or realize a new one for ASCII characters. */
7756 return lookup_face (f
, attrs
, 0, NULL
);
7760 /* Merge a face into a realized face.
7762 F is frame where faces are (to be) realized.
7764 FACE_NAME is named face to merge.
7766 If FACE_NAME is nil, FACE_ID is face_id of realized face to merge.
7768 If FACE_NAME is t, FACE_ID is lface_id of face to merge.
7770 BASE_FACE_ID is realized face to merge into.
7776 merge_faces (f
, face_name
, face_id
, base_face_id
)
7778 Lisp_Object face_name
;
7779 int face_id
, base_face_id
;
7781 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7782 struct face
*base_face
;
7784 base_face
= FACE_FROM_ID (f
, base_face_id
);
7786 return base_face_id
;
7788 if (EQ (face_name
, Qt
))
7790 if (face_id
< 0 || face_id
>= lface_id_to_name_size
)
7791 return base_face_id
;
7792 face_name
= lface_id_to_name
[face_id
];
7793 face_id
= lookup_derived_face (f
, face_name
, 0, base_face_id
, 1);
7796 return base_face_id
;
7799 /* Begin with attributes from the base face. */
7800 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
7802 if (!NILP (face_name
))
7804 if (!merge_named_face (f
, face_name
, attrs
, 0))
7805 return base_face_id
;
7811 return base_face_id
;
7812 face
= FACE_FROM_ID (f
, face_id
);
7814 return base_face_id
;
7815 merge_face_vectors (f
, face
->lface
, attrs
, 0);
7818 /* Look up a realized face with the given face attributes,
7819 or realize a new one for ASCII characters. */
7820 return lookup_face (f
, attrs
, 0, NULL
);
7824 /***********************************************************************
7826 ***********************************************************************/
7830 /* Print the contents of the realized face FACE to stderr. */
7833 dump_realized_face (face
)
7836 fprintf (stderr
, "ID: %d\n", face
->id
);
7837 #ifdef HAVE_X_WINDOWS
7838 fprintf (stderr
, "gc: %ld\n", (long) face
->gc
);
7840 fprintf (stderr
, "foreground: 0x%lx (%s)\n",
7842 SDATA (face
->lface
[LFACE_FOREGROUND_INDEX
]));
7843 fprintf (stderr
, "background: 0x%lx (%s)\n",
7845 SDATA (face
->lface
[LFACE_BACKGROUND_INDEX
]));
7846 fprintf (stderr
, "font_name: %s (%s)\n",
7848 SDATA (face
->lface
[LFACE_FAMILY_INDEX
]));
7849 #ifdef HAVE_X_WINDOWS
7850 fprintf (stderr
, "font = %p\n", face
->font
);
7852 fprintf (stderr
, "font_info_id = %d\n", face
->font_info_id
);
7853 fprintf (stderr
, "fontset: %d\n", face
->fontset
);
7854 fprintf (stderr
, "underline: %d (%s)\n",
7856 SDATA (Fsymbol_name (face
->lface
[LFACE_UNDERLINE_INDEX
])));
7857 fprintf (stderr
, "hash: %d\n", face
->hash
);
7858 fprintf (stderr
, "charset: %d\n", face
->charset
);
7862 DEFUN ("dump-face", Fdump_face
, Sdump_face
, 0, 1, 0, doc
: /* */)
7870 fprintf (stderr
, "font selection order: ");
7871 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
7872 fprintf (stderr
, "%d ", font_sort_order
[i
]);
7873 fprintf (stderr
, "\n");
7875 fprintf (stderr
, "alternative fonts: ");
7876 debug_print (Vface_alternative_font_family_alist
);
7877 fprintf (stderr
, "\n");
7879 for (i
= 0; i
< FRAME_FACE_CACHE (SELECTED_FRAME ())->used
; ++i
)
7880 Fdump_face (make_number (i
));
7886 face
= FACE_FROM_ID (SELECTED_FRAME (), XINT (n
));
7888 error ("Not a valid face");
7889 dump_realized_face (face
);
7896 DEFUN ("show-face-resources", Fshow_face_resources
, Sshow_face_resources
,
7897 0, 0, 0, doc
: /* */)
7900 fprintf (stderr
, "number of colors = %d\n", ncolors_allocated
);
7901 fprintf (stderr
, "number of pixmaps = %d\n", npixmaps_allocated
);
7902 fprintf (stderr
, "number of GCs = %d\n", ngcs
);
7906 #endif /* GLYPH_DEBUG != 0 */
7910 /***********************************************************************
7912 ***********************************************************************/
7917 Qface
= intern ("face");
7919 Qface_no_inherit
= intern ("face-no-inherit");
7920 staticpro (&Qface_no_inherit
);
7921 Qbitmap_spec_p
= intern ("bitmap-spec-p");
7922 staticpro (&Qbitmap_spec_p
);
7923 Qframe_set_background_mode
= intern ("frame-set-background-mode");
7924 staticpro (&Qframe_set_background_mode
);
7926 /* Lisp face attribute keywords. */
7927 QCfamily
= intern (":family");
7928 staticpro (&QCfamily
);
7929 QCheight
= intern (":height");
7930 staticpro (&QCheight
);
7931 QCweight
= intern (":weight");
7932 staticpro (&QCweight
);
7933 QCslant
= intern (":slant");
7934 staticpro (&QCslant
);
7935 QCunderline
= intern (":underline");
7936 staticpro (&QCunderline
);
7937 QCinverse_video
= intern (":inverse-video");
7938 staticpro (&QCinverse_video
);
7939 QCreverse_video
= intern (":reverse-video");
7940 staticpro (&QCreverse_video
);
7941 QCforeground
= intern (":foreground");
7942 staticpro (&QCforeground
);
7943 QCbackground
= intern (":background");
7944 staticpro (&QCbackground
);
7945 QCstipple
= intern (":stipple");;
7946 staticpro (&QCstipple
);
7947 QCwidth
= intern (":width");
7948 staticpro (&QCwidth
);
7949 QCfont
= intern (":font");
7950 staticpro (&QCfont
);
7951 QCbold
= intern (":bold");
7952 staticpro (&QCbold
);
7953 QCitalic
= intern (":italic");
7954 staticpro (&QCitalic
);
7955 QCoverline
= intern (":overline");
7956 staticpro (&QCoverline
);
7957 QCstrike_through
= intern (":strike-through");
7958 staticpro (&QCstrike_through
);
7959 QCbox
= intern (":box");
7961 QCinherit
= intern (":inherit");
7962 staticpro (&QCinherit
);
7964 /* Symbols used for Lisp face attribute values. */
7965 QCcolor
= intern (":color");
7966 staticpro (&QCcolor
);
7967 QCline_width
= intern (":line-width");
7968 staticpro (&QCline_width
);
7969 QCstyle
= intern (":style");
7970 staticpro (&QCstyle
);
7971 Qreleased_button
= intern ("released-button");
7972 staticpro (&Qreleased_button
);
7973 Qpressed_button
= intern ("pressed-button");
7974 staticpro (&Qpressed_button
);
7975 Qnormal
= intern ("normal");
7976 staticpro (&Qnormal
);
7977 Qultra_light
= intern ("ultra-light");
7978 staticpro (&Qultra_light
);
7979 Qextra_light
= intern ("extra-light");
7980 staticpro (&Qextra_light
);
7981 Qlight
= intern ("light");
7982 staticpro (&Qlight
);
7983 Qsemi_light
= intern ("semi-light");
7984 staticpro (&Qsemi_light
);
7985 Qsemi_bold
= intern ("semi-bold");
7986 staticpro (&Qsemi_bold
);
7987 Qbold
= intern ("bold");
7989 Qextra_bold
= intern ("extra-bold");
7990 staticpro (&Qextra_bold
);
7991 Qultra_bold
= intern ("ultra-bold");
7992 staticpro (&Qultra_bold
);
7993 Qoblique
= intern ("oblique");
7994 staticpro (&Qoblique
);
7995 Qitalic
= intern ("italic");
7996 staticpro (&Qitalic
);
7997 Qreverse_oblique
= intern ("reverse-oblique");
7998 staticpro (&Qreverse_oblique
);
7999 Qreverse_italic
= intern ("reverse-italic");
8000 staticpro (&Qreverse_italic
);
8001 Qultra_condensed
= intern ("ultra-condensed");
8002 staticpro (&Qultra_condensed
);
8003 Qextra_condensed
= intern ("extra-condensed");
8004 staticpro (&Qextra_condensed
);
8005 Qcondensed
= intern ("condensed");
8006 staticpro (&Qcondensed
);
8007 Qsemi_condensed
= intern ("semi-condensed");
8008 staticpro (&Qsemi_condensed
);
8009 Qsemi_expanded
= intern ("semi-expanded");
8010 staticpro (&Qsemi_expanded
);
8011 Qexpanded
= intern ("expanded");
8012 staticpro (&Qexpanded
);
8013 Qextra_expanded
= intern ("extra-expanded");
8014 staticpro (&Qextra_expanded
);
8015 Qultra_expanded
= intern ("ultra-expanded");
8016 staticpro (&Qultra_expanded
);
8017 Qbackground_color
= intern ("background-color");
8018 staticpro (&Qbackground_color
);
8019 Qforeground_color
= intern ("foreground-color");
8020 staticpro (&Qforeground_color
);
8021 Qunspecified
= intern ("unspecified");
8022 staticpro (&Qunspecified
);
8024 Qface_alias
= intern ("face-alias");
8025 staticpro (&Qface_alias
);
8026 Qdefault
= intern ("default");
8027 staticpro (&Qdefault
);
8028 Qtool_bar
= intern ("tool-bar");
8029 staticpro (&Qtool_bar
);
8030 Qregion
= intern ("region");
8031 staticpro (&Qregion
);
8032 Qfringe
= intern ("fringe");
8033 staticpro (&Qfringe
);
8034 Qheader_line
= intern ("header-line");
8035 staticpro (&Qheader_line
);
8036 Qscroll_bar
= intern ("scroll-bar");
8037 staticpro (&Qscroll_bar
);
8038 Qmenu
= intern ("menu");
8040 Qcursor
= intern ("cursor");
8041 staticpro (&Qcursor
);
8042 Qborder
= intern ("border");
8043 staticpro (&Qborder
);
8044 Qmouse
= intern ("mouse");
8045 staticpro (&Qmouse
);
8046 Qmode_line_inactive
= intern ("mode-line-inactive");
8047 staticpro (&Qmode_line_inactive
);
8048 Qvertical_border
= intern ("vertical-border");
8049 staticpro (&Qvertical_border
);
8050 Qtty_color_desc
= intern ("tty-color-desc");
8051 staticpro (&Qtty_color_desc
);
8052 Qtty_color_standard_values
= intern ("tty-color-standard-values");
8053 staticpro (&Qtty_color_standard_values
);
8054 Qtty_color_by_index
= intern ("tty-color-by-index");
8055 staticpro (&Qtty_color_by_index
);
8056 Qtty_color_alist
= intern ("tty-color-alist");
8057 staticpro (&Qtty_color_alist
);
8058 Qscalable_fonts_allowed
= intern ("scalable-fonts-allowed");
8059 staticpro (&Qscalable_fonts_allowed
);
8061 Vparam_value_alist
= Fcons (Fcons (Qnil
, Qnil
), Qnil
);
8062 staticpro (&Vparam_value_alist
);
8063 Vface_alternative_font_family_alist
= Qnil
;
8064 staticpro (&Vface_alternative_font_family_alist
);
8065 Vface_alternative_font_registry_alist
= Qnil
;
8066 staticpro (&Vface_alternative_font_registry_alist
);
8068 defsubr (&Sinternal_make_lisp_face
);
8069 defsubr (&Sinternal_lisp_face_p
);
8070 defsubr (&Sinternal_set_lisp_face_attribute
);
8071 #ifdef HAVE_WINDOW_SYSTEM
8072 defsubr (&Sinternal_set_lisp_face_attribute_from_resource
);
8074 defsubr (&Scolor_gray_p
);
8075 defsubr (&Scolor_supported_p
);
8076 defsubr (&Sface_attribute_relative_p
);
8077 defsubr (&Smerge_face_attribute
);
8078 defsubr (&Sinternal_get_lisp_face_attribute
);
8079 defsubr (&Sinternal_lisp_face_attribute_values
);
8080 defsubr (&Sinternal_lisp_face_equal_p
);
8081 defsubr (&Sinternal_lisp_face_empty_p
);
8082 defsubr (&Sinternal_copy_lisp_face
);
8083 defsubr (&Sinternal_merge_in_global_face
);
8084 defsubr (&Sface_font
);
8085 defsubr (&Sframe_face_alist
);
8086 defsubr (&Sdisplay_supports_face_attributes_p
);
8087 defsubr (&Scolor_distance
);
8088 defsubr (&Sinternal_set_font_selection_order
);
8089 defsubr (&Sinternal_set_alternative_font_family_alist
);
8090 defsubr (&Sinternal_set_alternative_font_registry_alist
);
8091 defsubr (&Sface_attributes_as_vector
);
8093 defsubr (&Sdump_face
);
8094 defsubr (&Sshow_face_resources
);
8095 #endif /* GLYPH_DEBUG */
8096 defsubr (&Sclear_face_cache
);
8097 defsubr (&Stty_suppress_bold_inverse_default_colors
);
8099 #if defined DEBUG_X_COLORS && defined HAVE_X_WINDOWS
8100 defsubr (&Sdump_colors
);
8103 DEFVAR_LISP ("font-list-limit", &Vfont_list_limit
,
8104 doc
: /* *Limit for font matching.
8105 If an integer > 0, font matching functions won't load more than
8106 that number of fonts when searching for a matching font. */);
8107 Vfont_list_limit
= make_number (DEFAULT_FONT_LIST_LIMIT
);
8109 DEFVAR_LISP ("face-new-frame-defaults", &Vface_new_frame_defaults
,
8110 doc
: /* List of global face definitions (for internal use only.) */);
8111 Vface_new_frame_defaults
= Qnil
;
8113 DEFVAR_LISP ("face-default-stipple", &Vface_default_stipple
,
8114 doc
: /* *Default stipple pattern used on monochrome displays.
8115 This stipple pattern is used on monochrome displays
8116 instead of shades of gray for a face background color.
8117 See `set-face-stipple' for possible values for this variable. */);
8118 Vface_default_stipple
= build_string ("gray3");
8120 DEFVAR_LISP ("tty-defined-color-alist", &Vtty_defined_color_alist
,
8121 doc
: /* An alist of defined terminal colors and their RGB values. */);
8122 Vtty_defined_color_alist
= Qnil
;
8124 DEFVAR_LISP ("scalable-fonts-allowed", &Vscalable_fonts_allowed
,
8125 doc
: /* Allowed scalable fonts.
8126 A value of nil means don't allow any scalable fonts.
8127 A value of t means allow any scalable font.
8128 Otherwise, value must be a list of regular expressions. A font may be
8129 scaled if its name matches a regular expression in the list.
8130 Note that if value is nil, a scalable font might still be used, if no
8131 other font of the appropriate family and registry is available. */);
8132 Vscalable_fonts_allowed
= Qnil
;
8134 DEFVAR_LISP ("face-ignored-fonts", &Vface_ignored_fonts
,
8135 doc
: /* List of ignored fonts.
8136 Each element is a regular expression that matches names of fonts to
8138 Vface_ignored_fonts
= Qnil
;
8140 DEFVAR_LISP ("face-font-rescale-alist", &Vface_font_rescale_alist
,
8141 doc
: /* Alist of fonts vs the rescaling factors.
8142 Each element is a cons (FONT-NAME-PATTERN . RESCALE-RATIO), where
8143 FONT-NAME-PATTERN is a regular expression matching a font name, and
8144 RESCALE-RATIO is a floating point number to specify how much larger
8145 \(or smaller) font we should use. For instance, if a face requests
8146 a font of 10 point, we actually use a font of 10 * RESCALE-RATIO point. */);
8147 Vface_font_rescale_alist
= Qnil
;
8149 #ifdef HAVE_WINDOW_SYSTEM
8150 defsubr (&Sbitmap_spec_p
);
8151 defsubr (&Sx_list_fonts
);
8152 defsubr (&Sinternal_face_x_get_resource
);
8153 defsubr (&Sx_family_fonts
);
8154 defsubr (&Sx_font_family_list
);
8155 #endif /* HAVE_WINDOW_SYSTEM */
8158 /* arch-tag: 8a0f7598-5517-408d-9ab3-1da6fcd4c749
8159 (do not change this comment) */