1 /* xfaces.c -- "Face" primitives.
2 Copyright (C) 1993, 1994, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005
3 Free Software Foundation.
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., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, 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_update_face_colors. */
324 Lisp_Object Qframe_update_face_colors
;
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
;
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 */
789 extern XGCValues
*XCreateGC (void *, Window
, unsigned long, XGCValues
*);
792 x_create_gc (f
, mask
, xgcv
)
798 gc
= XCreateGC (FRAME_MAC_DISPLAY (f
), FRAME_MAC_WINDOW (f
), mask
, xgcv
);
807 XFreeGC (FRAME_MAC_DISPLAY (f
), gc
);
812 /* Like stricmp. Used to compare parts of font names which are in
817 const unsigned char *s1
, *s2
;
821 unsigned char c1
= tolower (*s1
);
822 unsigned char c2
= tolower (*s2
);
824 return c1
< c2
? -1 : 1;
829 return *s2
== 0 ? 0 : -1;
834 /* Like strlwr, which might not always be available. */
836 static unsigned char *
840 unsigned char *p
= s
;
849 /* Signal `error' with message S, and additional argument ARG. */
852 signal_error (s
, arg
)
856 Fsignal (Qerror
, Fcons (build_string (s
), Fcons (arg
, Qnil
)));
860 /* If FRAME is nil, return a pointer to the selected frame.
861 Otherwise, check that FRAME is a live frame, and return a pointer
862 to it. NPARAM is the parameter number of FRAME, for
863 CHECK_LIVE_FRAME. This is here because it's a frequent pattern in
864 Lisp function definitions. */
866 static INLINE
struct frame
*
867 frame_or_selected_frame (frame
, nparam
)
872 frame
= selected_frame
;
874 CHECK_LIVE_FRAME (frame
);
875 return XFRAME (frame
);
879 /***********************************************************************
881 ***********************************************************************/
883 /* Initialize face cache and basic faces for frame F. */
889 /* Make a face cache, if F doesn't have one. */
890 if (FRAME_FACE_CACHE (f
) == NULL
)
891 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
893 #ifdef HAVE_WINDOW_SYSTEM
894 /* Make the image cache. */
895 if (FRAME_WINDOW_P (f
))
897 if (FRAME_X_IMAGE_CACHE (f
) == NULL
)
898 FRAME_X_IMAGE_CACHE (f
) = make_image_cache ();
899 ++FRAME_X_IMAGE_CACHE (f
)->refcount
;
901 #endif /* HAVE_WINDOW_SYSTEM */
903 /* Realize basic faces. Must have enough information in frame
904 parameters to realize basic faces at this point. */
905 #ifdef HAVE_X_WINDOWS
906 if (!FRAME_X_P (f
) || FRAME_X_WINDOW (f
))
909 if (!FRAME_WINDOW_P (f
) || FRAME_W32_WINDOW (f
))
912 if (!FRAME_MAC_P (f
) || FRAME_MAC_WINDOW (f
))
914 if (!realize_basic_faces (f
))
919 /* Free face cache of frame F. Called from Fdelete_frame. */
925 struct face_cache
*face_cache
= FRAME_FACE_CACHE (f
);
929 free_face_cache (face_cache
);
930 FRAME_FACE_CACHE (f
) = NULL
;
933 #ifdef HAVE_WINDOW_SYSTEM
934 if (FRAME_WINDOW_P (f
))
936 struct image_cache
*image_cache
= FRAME_X_IMAGE_CACHE (f
);
939 --image_cache
->refcount
;
940 if (image_cache
->refcount
== 0)
941 free_image_cache (f
);
944 #endif /* HAVE_WINDOW_SYSTEM */
948 /* Clear face caches, and recompute basic faces for frame F. Call
949 this after changing frame parameters on which those faces depend,
950 or when realized faces have been freed due to changing attributes
954 recompute_basic_faces (f
)
957 if (FRAME_FACE_CACHE (f
))
959 clear_face_cache (0);
960 if (!realize_basic_faces (f
))
966 /* Clear the face caches of all frames. CLEAR_FONTS_P non-zero means
967 try to free unused fonts, too. */
970 clear_face_cache (clear_fonts_p
)
973 #ifdef HAVE_WINDOW_SYSTEM
974 Lisp_Object tail
, frame
;
978 || ++clear_font_table_count
== CLEAR_FONT_TABLE_COUNT
)
980 struct x_display_info
*dpyinfo
;
982 /* Fonts are common for frames on one display, i.e. on
984 for (dpyinfo
= x_display_list
; dpyinfo
; dpyinfo
= dpyinfo
->next
)
985 if (dpyinfo
->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
986 clear_font_table (dpyinfo
);
988 /* From time to time see if we can unload some fonts. This also
989 frees all realized faces on all frames. Fonts needed by
990 faces will be loaded again when faces are realized again. */
991 clear_font_table_count
= 0;
993 FOR_EACH_FRAME (tail
, frame
)
995 struct frame
*f
= XFRAME (frame
);
996 if (FRAME_WINDOW_P (f
)
997 && FRAME_X_DISPLAY_INFO (f
)->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
998 free_all_realized_faces (frame
);
1003 /* Clear GCs of realized faces. */
1004 FOR_EACH_FRAME (tail
, frame
)
1007 if (FRAME_WINDOW_P (f
))
1009 clear_face_gcs (FRAME_FACE_CACHE (f
));
1010 clear_image_cache (f
, 0);
1014 #endif /* HAVE_WINDOW_SYSTEM */
1018 DEFUN ("clear-face-cache", Fclear_face_cache
, Sclear_face_cache
, 0, 1, 0,
1019 doc
: /* Clear face caches on all frames.
1020 Optional THOROUGHLY non-nil means try to free unused fonts, too. */)
1022 Lisp_Object thoroughly
;
1024 clear_face_cache (!NILP (thoroughly
));
1025 ++face_change_count
;
1026 ++windows_or_buffers_changed
;
1032 #ifdef HAVE_WINDOW_SYSTEM
1035 /* Remove fonts from the font table of DPYINFO except for the default
1036 ASCII fonts of frames on that display. Called from clear_face_cache
1037 from time to time. */
1040 clear_font_table (dpyinfo
)
1041 struct x_display_info
*dpyinfo
;
1045 /* Free those fonts that are not used by frames on DPYINFO. */
1046 for (i
= 0; i
< dpyinfo
->n_fonts
; ++i
)
1048 struct font_info
*font_info
= dpyinfo
->font_table
+ i
;
1049 Lisp_Object tail
, frame
;
1051 /* Check if slot is already free. */
1052 if (font_info
->name
== NULL
)
1055 /* Don't free a default font of some frame. */
1056 FOR_EACH_FRAME (tail
, frame
)
1058 struct frame
*f
= XFRAME (frame
);
1059 if (FRAME_WINDOW_P (f
)
1060 && font_info
->font
== FRAME_FONT (f
))
1068 if (font_info
->full_name
!= font_info
->name
)
1069 xfree (font_info
->full_name
);
1070 xfree (font_info
->name
);
1072 /* Free the font. */
1074 #ifdef HAVE_X_WINDOWS
1075 XFreeFont (dpyinfo
->display
, font_info
->font
);
1078 w32_unload_font (dpyinfo
, font_info
->font
);
1081 mac_unload_font (dpyinfo
, font_info
->font
);
1085 /* Mark font table slot free. */
1086 font_info
->font
= NULL
;
1087 font_info
->name
= font_info
->full_name
= NULL
;
1091 #endif /* HAVE_WINDOW_SYSTEM */
1095 /***********************************************************************
1097 ***********************************************************************/
1099 #ifdef HAVE_WINDOW_SYSTEM
1101 DEFUN ("bitmap-spec-p", Fbitmap_spec_p
, Sbitmap_spec_p
, 1, 1, 0,
1102 doc
: /* Value is non-nil if OBJECT is a valid bitmap specification.
1103 A bitmap specification is either a string, a file name, or a list
1104 \(WIDTH HEIGHT DATA) where WIDTH is the pixel width of the bitmap,
1105 HEIGHT is its height, and DATA is a string containing the bits of
1106 the pixmap. Bits are stored row by row, each row occupies
1107 \(WIDTH + 7)/8 bytes. */)
1113 if (STRINGP (object
))
1114 /* If OBJECT is a string, it's a file name. */
1116 else if (CONSP (object
))
1118 /* Otherwise OBJECT must be (WIDTH HEIGHT DATA), WIDTH and
1119 HEIGHT must be integers > 0, and DATA must be string large
1120 enough to hold a bitmap of the specified size. */
1121 Lisp_Object width
, height
, data
;
1123 height
= width
= data
= Qnil
;
1127 width
= XCAR (object
);
1128 object
= XCDR (object
);
1131 height
= XCAR (object
);
1132 object
= XCDR (object
);
1134 data
= XCAR (object
);
1138 if (NATNUMP (width
) && NATNUMP (height
) && STRINGP (data
))
1140 int bytes_per_row
= ((XFASTINT (width
) + BITS_PER_CHAR
- 1)
1142 if (SBYTES (data
) >= bytes_per_row
* XINT (height
))
1147 return pixmap_p
? Qt
: Qnil
;
1151 /* Load a bitmap according to NAME (which is either a file name or a
1152 pixmap spec) for use on frame F. Value is the bitmap_id (see
1153 xfns.c). If NAME is nil, return with a bitmap id of zero. If
1154 bitmap cannot be loaded, display a message saying so, and return
1155 zero. Store the bitmap width in *W_PTR and its height in *H_PTR,
1156 if these pointers are not null. */
1159 load_pixmap (f
, name
, w_ptr
, h_ptr
)
1162 unsigned int *w_ptr
, *h_ptr
;
1170 tem
= Fbitmap_spec_p (name
);
1172 wrong_type_argument (Qbitmap_spec_p
, name
);
1177 /* Decode a bitmap spec into a bitmap. */
1182 w
= XINT (Fcar (name
));
1183 h
= XINT (Fcar (Fcdr (name
)));
1184 bits
= Fcar (Fcdr (Fcdr (name
)));
1186 bitmap_id
= x_create_bitmap_from_data (f
, SDATA (bits
),
1191 /* It must be a string -- a file name. */
1192 bitmap_id
= x_create_bitmap_from_file (f
, name
);
1198 add_to_log ("Invalid or undefined bitmap %s", name
, Qnil
);
1209 ++npixmaps_allocated
;
1212 *w_ptr
= x_bitmap_width (f
, bitmap_id
);
1215 *h_ptr
= x_bitmap_height (f
, bitmap_id
);
1221 #endif /* HAVE_WINDOW_SYSTEM */
1225 /***********************************************************************
1227 ***********************************************************************/
1229 #ifdef HAVE_WINDOW_SYSTEM
1231 /* Load font of face FACE which is used on frame F to display
1232 character C. The name of the font to load is determined by lface
1233 and fontset of FACE. */
1236 load_face_font (f
, face
, c
)
1241 struct font_info
*font_info
= NULL
;
1243 int needs_overstrike
;
1245 face
->font_info_id
= -1;
1248 font_name
= choose_face_font (f
, face
->lface
, face
->fontset
, c
,
1254 font_info
= FS_LOAD_FACE_FONT (f
, c
, font_name
, face
);
1259 face
->font_info_id
= font_info
->font_idx
;
1260 face
->font
= font_info
->font
;
1261 face
->font_name
= font_info
->full_name
;
1262 face
->overstrike
= needs_overstrike
;
1265 x_free_gc (f
, face
->gc
);
1270 add_to_log ("Unable to load font %s",
1271 build_string (font_name
), Qnil
);
1275 #endif /* HAVE_WINDOW_SYSTEM */
1279 /***********************************************************************
1281 ***********************************************************************/
1283 /* Parse RGB_LIST, and fill in the RGB fields of COLOR.
1284 RGB_LIST should contain (at least) 3 lisp integers.
1285 Return 0 if there's a problem with RGB_LIST, otherwise return 1. */
1288 parse_rgb_list (rgb_list
, color
)
1289 Lisp_Object rgb_list
;
1292 #define PARSE_RGB_LIST_FIELD(field) \
1293 if (CONSP (rgb_list) && INTEGERP (XCAR (rgb_list))) \
1295 color->field = XINT (XCAR (rgb_list)); \
1296 rgb_list = XCDR (rgb_list); \
1301 PARSE_RGB_LIST_FIELD (red
);
1302 PARSE_RGB_LIST_FIELD (green
);
1303 PARSE_RGB_LIST_FIELD (blue
);
1309 /* Lookup on frame F the color described by the lisp string COLOR.
1310 The resulting tty color is returned in TTY_COLOR; if STD_COLOR is
1311 non-zero, then the `standard' definition of the same color is
1315 tty_lookup_color (f
, color
, tty_color
, std_color
)
1318 XColor
*tty_color
, *std_color
;
1320 Lisp_Object frame
, color_desc
;
1322 if (!STRINGP (color
) || NILP (Ffboundp (Qtty_color_desc
)))
1325 XSETFRAME (frame
, f
);
1327 color_desc
= call2 (Qtty_color_desc
, color
, frame
);
1328 if (CONSP (color_desc
) && CONSP (XCDR (color_desc
)))
1332 if (! INTEGERP (XCAR (XCDR (color_desc
))))
1335 tty_color
->pixel
= XINT (XCAR (XCDR (color_desc
)));
1337 rgb
= XCDR (XCDR (color_desc
));
1338 if (! parse_rgb_list (rgb
, tty_color
))
1341 /* Should we fill in STD_COLOR too? */
1344 /* Default STD_COLOR to the same as TTY_COLOR. */
1345 *std_color
= *tty_color
;
1347 /* Do a quick check to see if the returned descriptor is
1348 actually _exactly_ equal to COLOR, otherwise we have to
1349 lookup STD_COLOR separately. If it's impossible to lookup
1350 a standard color, we just give up and use TTY_COLOR. */
1351 if ((!STRINGP (XCAR (color_desc
))
1352 || NILP (Fstring_equal (color
, XCAR (color_desc
))))
1353 && !NILP (Ffboundp (Qtty_color_standard_values
)))
1355 /* Look up STD_COLOR separately. */
1356 rgb
= call1 (Qtty_color_standard_values
, color
);
1357 if (! parse_rgb_list (rgb
, std_color
))
1364 else if (NILP (Fsymbol_value (intern ("tty-defined-color-alist"))))
1365 /* We were called early during startup, and the colors are not
1366 yet set up in tty-defined-color-alist. Don't return a failure
1367 indication, since this produces the annoying "Unable to
1368 load color" messages in the *Messages* buffer. */
1371 /* tty-color-desc seems to have returned a bad value. */
1375 /* A version of defined_color for non-X frames. */
1378 tty_defined_color (f
, color_name
, color_def
, alloc
)
1387 color_def
->pixel
= FACE_TTY_DEFAULT_COLOR
;
1389 color_def
->blue
= 0;
1390 color_def
->green
= 0;
1393 status
= tty_lookup_color (f
, build_string (color_name
), color_def
, 0);
1395 if (color_def
->pixel
== FACE_TTY_DEFAULT_COLOR
&& *color_name
)
1397 if (strcmp (color_name
, "unspecified-fg") == 0)
1398 color_def
->pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
1399 else if (strcmp (color_name
, "unspecified-bg") == 0)
1400 color_def
->pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
1403 if (color_def
->pixel
!= FACE_TTY_DEFAULT_COLOR
)
1410 /* Decide if color named COLOR_NAME is valid for the display
1411 associated with the frame F; if so, return the rgb values in
1412 COLOR_DEF. If ALLOC is nonzero, allocate a new colormap cell.
1414 This does the right thing for any type of frame. */
1417 defined_color (f
, color_name
, color_def
, alloc
)
1423 if (!FRAME_WINDOW_P (f
))
1424 return tty_defined_color (f
, color_name
, color_def
, alloc
);
1425 #ifdef HAVE_X_WINDOWS
1426 else if (FRAME_X_P (f
))
1427 return x_defined_color (f
, color_name
, color_def
, alloc
);
1430 else if (FRAME_W32_P (f
))
1431 return w32_defined_color (f
, color_name
, color_def
, alloc
);
1434 else if (FRAME_MAC_P (f
))
1435 return mac_defined_color (f
, color_name
, color_def
, alloc
);
1442 /* Given the index IDX of a tty color on frame F, return its name, a
1446 tty_color_name (f
, idx
)
1450 if (idx
>= 0 && !NILP (Ffboundp (Qtty_color_by_index
)))
1453 Lisp_Object coldesc
;
1455 XSETFRAME (frame
, f
);
1456 coldesc
= call2 (Qtty_color_by_index
, make_number (idx
), frame
);
1458 if (!NILP (coldesc
))
1459 return XCAR (coldesc
);
1462 /* We can have an MSDOG frame under -nw for a short window of
1463 opportunity before internal_terminal_init is called. DTRT. */
1464 if (FRAME_MSDOS_P (f
) && !inhibit_window_system
)
1465 return msdos_stdcolor_name (idx
);
1468 if (idx
== FACE_TTY_DEFAULT_FG_COLOR
)
1469 return build_string (unspecified_fg
);
1470 if (idx
== FACE_TTY_DEFAULT_BG_COLOR
)
1471 return build_string (unspecified_bg
);
1474 return vga_stdcolor_name (idx
);
1477 return Qunspecified
;
1481 /* Return non-zero if COLOR_NAME is a shade of gray (or white or
1482 black) on frame F. The algorithm is taken from 20.2 faces.el. */
1485 face_color_gray_p (f
, color_name
)
1492 if (defined_color (f
, color_name
, &color
, 0))
1493 gray_p
= ((abs (color
.red
- color
.green
)
1494 < max (color
.red
, color
.green
) / 20)
1495 && (abs (color
.green
- color
.blue
)
1496 < max (color
.green
, color
.blue
) / 20)
1497 && (abs (color
.blue
- color
.red
)
1498 < max (color
.blue
, color
.red
) / 20));
1506 /* Return non-zero if color COLOR_NAME can be displayed on frame F.
1507 BACKGROUND_P non-zero means the color will be used as background
1511 face_color_supported_p (f
, color_name
, background_p
)
1519 XSETFRAME (frame
, f
);
1521 #ifdef HAVE_WINDOW_SYSTEM
1523 ? (!NILP (Fxw_display_color_p (frame
))
1524 || xstricmp (color_name
, "black") == 0
1525 || xstricmp (color_name
, "white") == 0
1527 && face_color_gray_p (f
, color_name
))
1528 || (!NILP (Fx_display_grayscale_p (frame
))
1529 && face_color_gray_p (f
, color_name
)))
1532 tty_defined_color (f
, color_name
, ¬_used
, 0);
1536 DEFUN ("color-gray-p", Fcolor_gray_p
, Scolor_gray_p
, 1, 2, 0,
1537 doc
: /* Return non-nil if COLOR is a shade of gray (or white or black).
1538 FRAME specifies the frame and thus the display for interpreting COLOR.
1539 If FRAME is nil or omitted, use the selected frame. */)
1541 Lisp_Object color
, frame
;
1545 CHECK_STRING (color
);
1547 frame
= selected_frame
;
1549 CHECK_FRAME (frame
);
1551 return face_color_gray_p (f
, SDATA (color
)) ? Qt
: Qnil
;
1555 DEFUN ("color-supported-p", Fcolor_supported_p
,
1556 Scolor_supported_p
, 1, 3, 0,
1557 doc
: /* Return non-nil if COLOR can be displayed on FRAME.
1558 BACKGROUND-P non-nil means COLOR is used as a background.
1559 Otherwise, this function tells whether it can be used as a foreground.
1560 If FRAME is nil or omitted, use the selected frame.
1561 COLOR must be a valid color name. */)
1562 (color
, frame
, background_p
)
1563 Lisp_Object frame
, color
, background_p
;
1567 CHECK_STRING (color
);
1569 frame
= selected_frame
;
1571 CHECK_FRAME (frame
);
1573 if (face_color_supported_p (f
, SDATA (color
), !NILP (background_p
)))
1579 /* Load color with name NAME for use by face FACE on frame F.
1580 TARGET_INDEX must be one of LFACE_FOREGROUND_INDEX,
1581 LFACE_BACKGROUND_INDEX, LFACE_UNDERLINE_INDEX, LFACE_OVERLINE_INDEX,
1582 LFACE_STRIKE_THROUGH_INDEX, or LFACE_BOX_INDEX. Value is the
1583 pixel color. If color cannot be loaded, display a message, and
1584 return the foreground, background or underline color of F, but
1585 record that fact in flags of the face so that we don't try to free
1589 load_color (f
, face
, name
, target_index
)
1593 enum lface_attribute_index target_index
;
1597 xassert (STRINGP (name
));
1598 xassert (target_index
== LFACE_FOREGROUND_INDEX
1599 || target_index
== LFACE_BACKGROUND_INDEX
1600 || target_index
== LFACE_UNDERLINE_INDEX
1601 || target_index
== LFACE_OVERLINE_INDEX
1602 || target_index
== LFACE_STRIKE_THROUGH_INDEX
1603 || target_index
== LFACE_BOX_INDEX
);
1605 /* if the color map is full, defined_color will return a best match
1606 to the values in an existing cell. */
1607 if (!defined_color (f
, SDATA (name
), &color
, 1))
1609 add_to_log ("Unable to load color \"%s\"", name
, Qnil
);
1611 switch (target_index
)
1613 case LFACE_FOREGROUND_INDEX
:
1614 face
->foreground_defaulted_p
= 1;
1615 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1618 case LFACE_BACKGROUND_INDEX
:
1619 face
->background_defaulted_p
= 1;
1620 color
.pixel
= FRAME_BACKGROUND_PIXEL (f
);
1623 case LFACE_UNDERLINE_INDEX
:
1624 face
->underline_defaulted_p
= 1;
1625 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1628 case LFACE_OVERLINE_INDEX
:
1629 face
->overline_color_defaulted_p
= 1;
1630 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1633 case LFACE_STRIKE_THROUGH_INDEX
:
1634 face
->strike_through_color_defaulted_p
= 1;
1635 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1638 case LFACE_BOX_INDEX
:
1639 face
->box_color_defaulted_p
= 1;
1640 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1649 ++ncolors_allocated
;
1656 #ifdef HAVE_WINDOW_SYSTEM
1658 /* Load colors for face FACE which is used on frame F. Colors are
1659 specified by slots LFACE_BACKGROUND_INDEX and LFACE_FOREGROUND_INDEX
1660 of ATTRS. If the background color specified is not supported on F,
1661 try to emulate gray colors with a stipple from Vface_default_stipple. */
1664 load_face_colors (f
, face
, attrs
)
1671 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
1672 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
1674 /* Swap colors if face is inverse-video. */
1675 if (EQ (attrs
[LFACE_INVERSE_INDEX
], Qt
))
1683 /* Check for support for foreground, not for background because
1684 face_color_supported_p is smart enough to know that grays are
1685 "supported" as background because we are supposed to use stipple
1687 if (!face_color_supported_p (f
, SDATA (bg
), 0)
1688 && !NILP (Fbitmap_spec_p (Vface_default_stipple
)))
1690 x_destroy_bitmap (f
, face
->stipple
);
1691 face
->stipple
= load_pixmap (f
, Vface_default_stipple
,
1692 &face
->pixmap_w
, &face
->pixmap_h
);
1695 face
->background
= load_color (f
, face
, bg
, LFACE_BACKGROUND_INDEX
);
1696 face
->foreground
= load_color (f
, face
, fg
, LFACE_FOREGROUND_INDEX
);
1700 /* Free color PIXEL on frame F. */
1703 unload_color (f
, pixel
)
1705 unsigned long pixel
;
1707 #ifdef HAVE_X_WINDOWS
1711 x_free_colors (f
, &pixel
, 1);
1718 /* Free colors allocated for FACE. */
1721 free_face_colors (f
, face
)
1725 #ifdef HAVE_X_WINDOWS
1726 if (face
->colors_copied_bitwise_p
)
1731 if (!face
->foreground_defaulted_p
)
1733 x_free_colors (f
, &face
->foreground
, 1);
1734 IF_DEBUG (--ncolors_allocated
);
1737 if (!face
->background_defaulted_p
)
1739 x_free_colors (f
, &face
->background
, 1);
1740 IF_DEBUG (--ncolors_allocated
);
1743 if (face
->underline_p
1744 && !face
->underline_defaulted_p
)
1746 x_free_colors (f
, &face
->underline_color
, 1);
1747 IF_DEBUG (--ncolors_allocated
);
1750 if (face
->overline_p
1751 && !face
->overline_color_defaulted_p
)
1753 x_free_colors (f
, &face
->overline_color
, 1);
1754 IF_DEBUG (--ncolors_allocated
);
1757 if (face
->strike_through_p
1758 && !face
->strike_through_color_defaulted_p
)
1760 x_free_colors (f
, &face
->strike_through_color
, 1);
1761 IF_DEBUG (--ncolors_allocated
);
1764 if (face
->box
!= FACE_NO_BOX
1765 && !face
->box_color_defaulted_p
)
1767 x_free_colors (f
, &face
->box_color
, 1);
1768 IF_DEBUG (--ncolors_allocated
);
1772 #endif /* HAVE_X_WINDOWS */
1775 #endif /* HAVE_WINDOW_SYSTEM */
1779 /***********************************************************************
1781 ***********************************************************************/
1783 /* An enumerator for each field of an XLFD font name. */
1804 /* An enumerator for each possible slant value of a font. Taken from
1805 the XLFD specification. */
1813 XLFD_SLANT_REVERSE_ITALIC
,
1814 XLFD_SLANT_REVERSE_OBLIQUE
,
1818 /* Relative font weight according to XLFD documentation. */
1822 XLFD_WEIGHT_UNKNOWN
,
1823 XLFD_WEIGHT_ULTRA_LIGHT
, /* 10 */
1824 XLFD_WEIGHT_EXTRA_LIGHT
, /* 20 */
1825 XLFD_WEIGHT_LIGHT
, /* 30 */
1826 XLFD_WEIGHT_SEMI_LIGHT
, /* 40: SemiLight, Book, ... */
1827 XLFD_WEIGHT_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1828 XLFD_WEIGHT_SEMI_BOLD
, /* 60: SemiBold, DemiBold, ... */
1829 XLFD_WEIGHT_BOLD
, /* 70: Bold, ... */
1830 XLFD_WEIGHT_EXTRA_BOLD
, /* 80: ExtraBold, Heavy, ... */
1831 XLFD_WEIGHT_ULTRA_BOLD
/* 90: UltraBold, Black, ... */
1834 /* Relative proportionate width. */
1838 XLFD_SWIDTH_UNKNOWN
,
1839 XLFD_SWIDTH_ULTRA_CONDENSED
, /* 10 */
1840 XLFD_SWIDTH_EXTRA_CONDENSED
, /* 20 */
1841 XLFD_SWIDTH_CONDENSED
, /* 30: Condensed, Narrow, Compressed, ... */
1842 XLFD_SWIDTH_SEMI_CONDENSED
, /* 40: semicondensed */
1843 XLFD_SWIDTH_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1844 XLFD_SWIDTH_SEMI_EXPANDED
, /* 60: SemiExpanded, DemiExpanded, ... */
1845 XLFD_SWIDTH_EXPANDED
, /* 70: Expanded... */
1846 XLFD_SWIDTH_EXTRA_EXPANDED
, /* 80: ExtraExpanded, Wide... */
1847 XLFD_SWIDTH_ULTRA_EXPANDED
/* 90: UltraExpanded... */
1850 /* Structure used for tables mapping XLFD weight, slant, and width
1851 names to numeric and symbolic values. */
1857 Lisp_Object
*symbol
;
1860 /* Table of XLFD slant names and their numeric and symbolic
1861 representations. This table must be sorted by slant names in
1864 static struct table_entry slant_table
[] =
1866 {"i", XLFD_SLANT_ITALIC
, &Qitalic
},
1867 {"o", XLFD_SLANT_OBLIQUE
, &Qoblique
},
1868 {"ot", XLFD_SLANT_OTHER
, &Qitalic
},
1869 {"r", XLFD_SLANT_ROMAN
, &Qnormal
},
1870 {"ri", XLFD_SLANT_REVERSE_ITALIC
, &Qreverse_italic
},
1871 {"ro", XLFD_SLANT_REVERSE_OBLIQUE
, &Qreverse_oblique
}
1874 /* Table of XLFD weight names. This table must be sorted by weight
1875 names in ascending order. */
1877 static struct table_entry weight_table
[] =
1879 {"black", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
},
1880 {"bold", XLFD_WEIGHT_BOLD
, &Qbold
},
1881 {"book", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1882 {"demi", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1883 {"demibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1884 {"extralight", XLFD_WEIGHT_EXTRA_LIGHT
, &Qextra_light
},
1885 {"extrabold", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1886 {"heavy", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1887 {"light", XLFD_WEIGHT_LIGHT
, &Qlight
},
1888 {"medium", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1889 {"normal", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1890 {"regular", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1891 {"semibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1892 {"semilight", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1893 {"ultralight", XLFD_WEIGHT_ULTRA_LIGHT
, &Qultra_light
},
1894 {"ultrabold", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
}
1897 /* Table of XLFD width names. This table must be sorted by width
1898 names in ascending order. */
1900 static struct table_entry swidth_table
[] =
1902 {"compressed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1903 {"condensed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1904 {"demiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1905 {"expanded", XLFD_SWIDTH_EXPANDED
, &Qexpanded
},
1906 {"extracondensed", XLFD_SWIDTH_EXTRA_CONDENSED
, &Qextra_condensed
},
1907 {"extraexpanded", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
},
1908 {"medium", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1909 {"narrow", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1910 {"normal", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1911 {"regular", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1912 {"semicondensed", XLFD_SWIDTH_SEMI_CONDENSED
, &Qsemi_condensed
},
1913 {"semiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1914 {"ultracondensed", XLFD_SWIDTH_ULTRA_CONDENSED
, &Qultra_condensed
},
1915 {"ultraexpanded", XLFD_SWIDTH_ULTRA_EXPANDED
, &Qultra_expanded
},
1916 {"wide", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
}
1919 /* Structure used to hold the result of splitting font names in XLFD
1920 format into their fields. */
1924 /* The original name which is modified destructively by
1925 split_font_name. The pointer is kept here to be able to free it
1926 if it was allocated from the heap. */
1929 /* Font name fields. Each vector element points into `name' above.
1930 Fields are NUL-terminated. */
1931 char *fields
[XLFD_LAST
];
1933 /* Numeric values for those fields that interest us. See
1934 split_font_name for which these are. */
1935 int numeric
[XLFD_LAST
];
1937 /* If the original name matches one of Vface_font_rescale_alist,
1938 the value is the corresponding rescale ratio. Otherwise, the
1940 double rescale_ratio
;
1942 /* Lower value mean higher priority. */
1943 int registry_priority
;
1946 /* The frame in effect when sorting font names. Set temporarily in
1947 sort_fonts so that it is available in font comparison functions. */
1949 static struct frame
*font_frame
;
1951 /* Order by which font selection chooses fonts. The default values
1952 mean `first, find a best match for the font width, then for the
1953 font height, then for weight, then for slant.' This variable can be
1954 set via set-face-font-sort-order. */
1957 static int font_sort_order
[4] = {
1958 XLFD_SWIDTH
, XLFD_POINT_SIZE
, XLFD_WEIGHT
, XLFD_SLANT
1961 static int font_sort_order
[4];
1964 /* Look up FONT.fields[FIELD_INDEX] in TABLE which has DIM entries.
1965 TABLE must be sorted by TABLE[i]->name in ascending order. Value
1966 is a pointer to the matching table entry or null if no table entry
1969 static struct table_entry
*
1970 xlfd_lookup_field_contents (table
, dim
, font
, field_index
)
1971 struct table_entry
*table
;
1973 struct font_name
*font
;
1976 /* Function split_font_name converts fields to lower-case, so there
1977 is no need to use xstrlwr or xstricmp here. */
1978 char *s
= font
->fields
[field_index
];
1979 int low
, mid
, high
, cmp
;
1986 mid
= (low
+ high
) / 2;
1987 cmp
= strcmp (table
[mid
].name
, s
);
2001 /* Return a numeric representation for font name field
2002 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
2003 has DIM entries. Value is the numeric value found or DFLT if no
2004 table entry matches. This function is used to translate weight,
2005 slant, and swidth names of XLFD font names to numeric values. */
2008 xlfd_numeric_value (table
, dim
, font
, field_index
, dflt
)
2009 struct table_entry
*table
;
2011 struct font_name
*font
;
2015 struct table_entry
*p
;
2016 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2017 return p
? p
->numeric
: dflt
;
2021 /* Return a symbolic representation for font name field
2022 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
2023 has DIM entries. Value is the symbolic value found or DFLT if no
2024 table entry matches. This function is used to translate weight,
2025 slant, and swidth names of XLFD font names to symbols. */
2027 static INLINE Lisp_Object
2028 xlfd_symbolic_value (table
, dim
, font
, field_index
, dflt
)
2029 struct table_entry
*table
;
2031 struct font_name
*font
;
2035 struct table_entry
*p
;
2036 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2037 return p
? *p
->symbol
: dflt
;
2041 /* Return a numeric value for the slant of the font given by FONT. */
2044 xlfd_numeric_slant (font
)
2045 struct font_name
*font
;
2047 return xlfd_numeric_value (slant_table
, DIM (slant_table
),
2048 font
, XLFD_SLANT
, XLFD_SLANT_ROMAN
);
2052 /* Return a symbol representing the weight of the font given by FONT. */
2054 static INLINE Lisp_Object
2055 xlfd_symbolic_slant (font
)
2056 struct font_name
*font
;
2058 return xlfd_symbolic_value (slant_table
, DIM (slant_table
),
2059 font
, XLFD_SLANT
, Qnormal
);
2063 /* Return a numeric value for the weight of the font given by FONT. */
2066 xlfd_numeric_weight (font
)
2067 struct font_name
*font
;
2069 return xlfd_numeric_value (weight_table
, DIM (weight_table
),
2070 font
, XLFD_WEIGHT
, XLFD_WEIGHT_MEDIUM
);
2074 /* Return a symbol representing the slant of the font given by FONT. */
2076 static INLINE Lisp_Object
2077 xlfd_symbolic_weight (font
)
2078 struct font_name
*font
;
2080 return xlfd_symbolic_value (weight_table
, DIM (weight_table
),
2081 font
, XLFD_WEIGHT
, Qnormal
);
2085 /* Return a numeric value for the swidth of the font whose XLFD font
2086 name fields are found in FONT. */
2089 xlfd_numeric_swidth (font
)
2090 struct font_name
*font
;
2092 return xlfd_numeric_value (swidth_table
, DIM (swidth_table
),
2093 font
, XLFD_SWIDTH
, XLFD_SWIDTH_MEDIUM
);
2097 /* Return a symbolic value for the swidth of FONT. */
2099 static INLINE Lisp_Object
2100 xlfd_symbolic_swidth (font
)
2101 struct font_name
*font
;
2103 return xlfd_symbolic_value (swidth_table
, DIM (swidth_table
),
2104 font
, XLFD_SWIDTH
, Qnormal
);
2108 /* Look up the entry of SYMBOL in the vector TABLE which has DIM
2109 entries. Value is a pointer to the matching table entry or null if
2110 no element of TABLE contains SYMBOL. */
2112 static struct table_entry
*
2113 face_value (table
, dim
, symbol
)
2114 struct table_entry
*table
;
2120 xassert (SYMBOLP (symbol
));
2122 for (i
= 0; i
< dim
; ++i
)
2123 if (EQ (*table
[i
].symbol
, symbol
))
2126 return i
< dim
? table
+ i
: NULL
;
2130 /* Return a numeric value for SYMBOL in the vector TABLE which has DIM
2131 entries. Value is -1 if SYMBOL is not found in TABLE. */
2134 face_numeric_value (table
, dim
, symbol
)
2135 struct table_entry
*table
;
2139 struct table_entry
*p
= face_value (table
, dim
, symbol
);
2140 return p
? p
->numeric
: -1;
2144 /* Return a numeric value representing the weight specified by Lisp
2145 symbol WEIGHT. Value is one of the enumerators of enum
2149 face_numeric_weight (weight
)
2152 return face_numeric_value (weight_table
, DIM (weight_table
), weight
);
2156 /* Return a numeric value representing the slant specified by Lisp
2157 symbol SLANT. Value is one of the enumerators of enum xlfd_slant. */
2160 face_numeric_slant (slant
)
2163 return face_numeric_value (slant_table
, DIM (slant_table
), slant
);
2167 /* Return a numeric value representing the swidth specified by Lisp
2168 symbol WIDTH. Value is one of the enumerators of enum xlfd_swidth. */
2171 face_numeric_swidth (width
)
2174 return face_numeric_value (swidth_table
, DIM (swidth_table
), width
);
2178 #ifdef HAVE_WINDOW_SYSTEM
2180 /* Return non-zero if FONT is the name of a fixed-pitch font. */
2184 struct font_name
*font
;
2186 /* Function split_font_name converts fields to lower-case, so there
2187 is no need to use tolower here. */
2188 return *font
->fields
[XLFD_SPACING
] != 'p';
2192 /* Return the point size of FONT on frame F, measured in 1/10 pt.
2194 The actual height of the font when displayed on F depends on the
2195 resolution of both the font and frame. For example, a 10pt font
2196 designed for a 100dpi display will display larger than 10pt on a
2197 75dpi display. (It's not unusual to use fonts not designed for the
2198 display one is using. For example, some intlfonts are available in
2199 72dpi versions, only.)
2201 Value is the real point size of FONT on frame F, or 0 if it cannot
2205 xlfd_point_size (f
, font
)
2207 struct font_name
*font
;
2209 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2210 char *pixel_field
= font
->fields
[XLFD_PIXEL_SIZE
];
2214 if (*pixel_field
== '[')
2216 /* The pixel size field is `[A B C D]' which specifies
2217 a transformation matrix.
2223 by which all glyphs of the font are transformed. The spec
2224 says that s scalar value N for the pixel size is equivalent
2225 to A = N * resx/resy, B = C = 0, D = N. */
2226 char *start
= pixel_field
+ 1, *end
;
2230 for (i
= 0; i
< 4; ++i
)
2232 matrix
[i
] = strtod (start
, &end
);
2239 pixel
= atoi (pixel_field
);
2244 real_pt
= PT_PER_INCH
* 10.0 * pixel
/ resy
+ 0.5;
2250 /* Return point size of PIXEL dots while considering Y-resultion (DPI)
2251 of frame F. This function is used to guess a point size of font
2252 when only the pixel height of the font is available. */
2255 pixel_point_size (f
, pixel
)
2259 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2263 /* As one inch is PT_PER_INCH points, PT_PER_INCH/RESY gives the
2264 point size of one dot. */
2265 real_pt
= pixel
* PT_PER_INCH
/ resy
;
2266 int_pt
= real_pt
+ 0.5;
2272 /* Return a rescaling ratio of a font of NAME. */
2275 font_rescale_ratio (name
)
2278 Lisp_Object tail
, elt
;
2280 for (tail
= Vface_font_rescale_alist
; CONSP (tail
); tail
= XCDR (tail
))
2283 if (STRINGP (XCAR (elt
)) && FLOATP (XCDR (elt
))
2284 && fast_c_string_match_ignore_case (XCAR (elt
), name
) >= 0)
2285 return XFLOAT_DATA (XCDR (elt
));
2291 /* Split XLFD font name FONT->name destructively into NUL-terminated,
2292 lower-case fields in FONT->fields. NUMERIC_P non-zero means
2293 compute numeric values for fields XLFD_POINT_SIZE, XLFD_SWIDTH,
2294 XLFD_RESY, XLFD_SLANT, and XLFD_WEIGHT in FONT->numeric. Value is
2295 zero if the font name doesn't have the format we expect. The
2296 expected format is a font name that starts with a `-' and has
2297 XLFD_LAST fields separated by `-'. */
2300 split_font_name (f
, font
, numeric_p
)
2302 struct font_name
*font
;
2307 double rescale_ratio
;
2310 /* This must be done before splitting the font name. */
2311 rescale_ratio
= font_rescale_ratio (font
->name
);
2313 if (*font
->name
== '-')
2315 char *p
= xstrlwr (font
->name
) + 1;
2317 while (i
< XLFD_LAST
)
2319 font
->fields
[i
] = p
;
2322 /* Pixel and point size may be of the form `[....]'. For
2323 BNF, see XLFD spec, chapter 4. Negative values are
2324 indicated by tilde characters which we replace with
2325 `-' characters, here. */
2327 && (i
- 1 == XLFD_PIXEL_SIZE
2328 || i
- 1 == XLFD_POINT_SIZE
))
2333 for (++p
; *p
&& *p
!= ']'; ++p
)
2337 /* Check that the matrix contains 4 floating point
2339 for (j
= 0, start
= font
->fields
[i
- 1] + 1;
2342 if (strtod (start
, &end
) == 0 && start
== end
)
2349 while (*p
&& *p
!= '-')
2359 success_p
= i
== XLFD_LAST
;
2361 /* If requested, and font name was in the expected format,
2362 compute numeric values for some fields. */
2363 if (numeric_p
&& success_p
)
2365 font
->numeric
[XLFD_POINT_SIZE
] = xlfd_point_size (f
, font
);
2366 font
->numeric
[XLFD_RESY
] = atoi (font
->fields
[XLFD_RESY
]);
2367 font
->numeric
[XLFD_SLANT
] = xlfd_numeric_slant (font
);
2368 font
->numeric
[XLFD_WEIGHT
] = xlfd_numeric_weight (font
);
2369 font
->numeric
[XLFD_SWIDTH
] = xlfd_numeric_swidth (font
);
2370 font
->numeric
[XLFD_AVGWIDTH
] = atoi (font
->fields
[XLFD_AVGWIDTH
]);
2371 font
->rescale_ratio
= rescale_ratio
;
2374 /* Initialize it to zero. It will be overridden by font_list while
2375 trying alternate registries. */
2376 font
->registry_priority
= 0;
2382 /* Build an XLFD font name from font name fields in FONT. Value is a
2383 pointer to the font name, which is allocated via xmalloc. */
2386 build_font_name (font
)
2387 struct font_name
*font
;
2391 char *font_name
= (char *) xmalloc (size
);
2392 int total_length
= 0;
2394 for (i
= 0; i
< XLFD_LAST
; ++i
)
2396 /* Add 1 because of the leading `-'. */
2397 int len
= strlen (font
->fields
[i
]) + 1;
2399 /* Reallocate font_name if necessary. Add 1 for the final
2401 if (total_length
+ len
+ 1 >= size
)
2403 int new_size
= max (2 * size
, size
+ len
+ 1);
2404 int sz
= new_size
* sizeof *font_name
;
2405 font_name
= (char *) xrealloc (font_name
, sz
);
2409 font_name
[total_length
] = '-';
2410 bcopy (font
->fields
[i
], font_name
+ total_length
+ 1, len
- 1);
2411 total_length
+= len
;
2414 font_name
[total_length
] = 0;
2419 /* Free an array FONTS of N font_name structures. This frees FONTS
2420 itself and all `name' fields in its elements. */
2423 free_font_names (fonts
, n
)
2424 struct font_name
*fonts
;
2428 xfree (fonts
[--n
].name
);
2433 /* Sort vector FONTS of font_name structures which contains NFONTS
2434 elements using qsort and comparison function CMPFN. F is the frame
2435 on which the fonts will be used. The global variable font_frame
2436 is temporarily set to F to make it available in CMPFN. */
2439 sort_fonts (f
, fonts
, nfonts
, cmpfn
)
2441 struct font_name
*fonts
;
2443 int (*cmpfn
) P_ ((const void *, const void *));
2446 qsort (fonts
, nfonts
, sizeof *fonts
, cmpfn
);
2451 /* Get fonts matching PATTERN on frame F. If F is null, use the first
2452 display in x_display_list. FONTS is a pointer to a vector of
2453 NFONTS font_name structures. TRY_ALTERNATIVES_P non-zero means try
2454 alternative patterns from Valternate_fontname_alist if no fonts are
2455 found matching PATTERN.
2457 For all fonts found, set FONTS[i].name to the name of the font,
2458 allocated via xmalloc, and split font names into fields. Ignore
2459 fonts that we can't parse. Value is the number of fonts found. */
2462 x_face_list_fonts (f
, pattern
, pfonts
, nfonts
, try_alternatives_p
)
2465 struct font_name
**pfonts
;
2466 int nfonts
, try_alternatives_p
;
2470 /* NTEMACS_TODO : currently this uses w32_list_fonts, but it may be
2471 better to do it the other way around. */
2473 Lisp_Object lpattern
, tem
;
2474 struct font_name
*fonts
= 0;
2475 int num_fonts
= nfonts
;
2478 lpattern
= build_string (pattern
);
2480 /* Get the list of fonts matching PATTERN. */
2483 lfonts
= w32_list_fonts (f
, lpattern
, 0, nfonts
);
2486 lfonts
= x_list_fonts (f
, lpattern
, -1, nfonts
);
2489 if (nfonts
< 0 && CONSP (lfonts
))
2490 num_fonts
= XFASTINT (Flength (lfonts
));
2492 /* Make a copy of the font names we got from X, and
2493 split them into fields. */
2495 for (tem
= lfonts
; CONSP (tem
) && n
< num_fonts
; tem
= XCDR (tem
))
2497 Lisp_Object elt
, tail
;
2498 const char *name
= SDATA (XCAR (tem
));
2500 /* Ignore fonts matching a pattern from face-ignored-fonts. */
2501 for (tail
= Vface_ignored_fonts
; CONSP (tail
); tail
= XCDR (tail
))
2505 && fast_c_string_match_ignore_case (elt
, name
) >= 0)
2516 *pfonts
= (struct font_name
*) xmalloc (num_fonts
* sizeof **pfonts
);
2520 /* Make a copy of the font name. */
2521 fonts
[n
].name
= xstrdup (name
);
2523 if (split_font_name (f
, fonts
+ n
, 1))
2525 if (font_scalable_p (fonts
+ n
)
2526 && !may_use_scalable_font_p (name
))
2529 xfree (fonts
[n
].name
);
2535 xfree (fonts
[n
].name
);
2538 /* If no fonts found, try patterns from Valternate_fontname_alist. */
2539 if (n
== 0 && try_alternatives_p
)
2541 Lisp_Object list
= Valternate_fontname_alist
;
2549 while (CONSP (list
))
2551 Lisp_Object entry
= XCAR (list
);
2553 && STRINGP (XCAR (entry
))
2554 && strcmp (SDATA (XCAR (entry
)), pattern
) == 0)
2561 Lisp_Object patterns
= XCAR (list
);
2564 while (CONSP (patterns
)
2565 /* If list is screwed up, give up. */
2566 && (name
= XCAR (patterns
),
2568 /* Ignore patterns equal to PATTERN because we tried that
2569 already with no success. */
2570 && (strcmp (SDATA (name
), pattern
) == 0
2571 || (n
= x_face_list_fonts (f
, SDATA (name
),
2574 patterns
= XCDR (patterns
);
2582 /* Check if a font matching pattern_offset_t on frame F is available
2583 or not. PATTERN may be a cons (FAMILY . REGISTRY), in which case,
2584 a font name pattern is generated from FAMILY and REGISTRY. */
2587 face_font_available_p (f
, pattern
)
2589 Lisp_Object pattern
;
2593 if (! STRINGP (pattern
))
2595 Lisp_Object family
, registry
;
2596 char *family_str
, *registry_str
, *pattern_str
;
2598 CHECK_CONS (pattern
);
2599 family
= XCAR (pattern
);
2604 CHECK_STRING (family
);
2605 family_str
= (char *) SDATA (family
);
2607 registry
= XCDR (pattern
);
2608 if (NILP (registry
))
2612 CHECK_STRING (registry
);
2613 registry_str
= (char *) SDATA (registry
);
2616 pattern_str
= (char *) alloca (strlen (family_str
)
2617 + strlen (registry_str
)
2619 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2620 strcat (pattern_str
, family_str
);
2621 strcat (pattern_str
, "-*-");
2622 strcat (pattern_str
, registry_str
);
2623 if (!index (registry_str
, '-'))
2625 if (registry_str
[strlen (registry_str
) - 1] == '*')
2626 strcat (pattern_str
, "-*");
2628 strcat (pattern_str
, "*-*");
2630 pattern
= build_string (pattern_str
);
2633 /* Get the list of fonts matching PATTERN. */
2636 fonts
= w32_list_fonts (f
, pattern
, 0, 1);
2639 fonts
= x_list_fonts (f
, pattern
, -1, 1);
2641 return XINT (Flength (fonts
));
2645 /* Determine fonts matching PATTERN on frame F. Sort resulting fonts
2646 using comparison function CMPFN. Value is the number of fonts
2647 found. If value is non-zero, *FONTS is set to a vector of
2648 font_name structures allocated from the heap containing matching
2649 fonts. Each element of *FONTS contains a name member that is also
2650 allocated from the heap. Font names in these structures are split
2651 into fields. Use free_font_names to free such an array. */
2654 sorted_font_list (f
, pattern
, cmpfn
, fonts
)
2657 int (*cmpfn
) P_ ((const void *, const void *));
2658 struct font_name
**fonts
;
2662 /* Get the list of fonts matching pattern. 100 should suffice. */
2663 nfonts
= DEFAULT_FONT_LIST_LIMIT
;
2664 if (INTEGERP (Vfont_list_limit
))
2665 nfonts
= XINT (Vfont_list_limit
);
2668 nfonts
= x_face_list_fonts (f
, pattern
, fonts
, nfonts
, 1);
2670 /* Sort the resulting array and return it in *FONTS. If no
2671 fonts were found, make sure to set *FONTS to null. */
2673 sort_fonts (f
, *fonts
, nfonts
, cmpfn
);
2684 /* Compare two font_name structures *A and *B. Value is analogous to
2685 strcmp. Sort order is given by the global variable
2686 font_sort_order. Font names are sorted so that, everything else
2687 being equal, fonts with a resolution closer to that of the frame on
2688 which they are used are listed first. The global variable
2689 font_frame is the frame on which we operate. */
2692 cmp_font_names (a
, b
)
2695 struct font_name
*x
= (struct font_name
*) a
;
2696 struct font_name
*y
= (struct font_name
*) b
;
2699 /* All strings have been converted to lower-case by split_font_name,
2700 so we can use strcmp here. */
2701 cmp
= strcmp (x
->fields
[XLFD_FAMILY
], y
->fields
[XLFD_FAMILY
]);
2706 for (i
= 0; i
< DIM (font_sort_order
) && cmp
== 0; ++i
)
2708 int j
= font_sort_order
[i
];
2709 cmp
= x
->numeric
[j
] - y
->numeric
[j
];
2714 /* Everything else being equal, we prefer fonts with an
2715 y-resolution closer to that of the frame. */
2716 int resy
= FRAME_X_DISPLAY_INFO (font_frame
)->resy
;
2717 int x_resy
= x
->numeric
[XLFD_RESY
];
2718 int y_resy
= y
->numeric
[XLFD_RESY
];
2719 cmp
= abs (resy
- x_resy
) - abs (resy
- y_resy
);
2727 /* Get a sorted list of fonts of family FAMILY on frame F. If PATTERN
2728 is non-nil list fonts matching that pattern. Otherwise, if
2729 REGISTRY is non-nil return only fonts with that registry, otherwise
2730 return fonts of any registry. Set *FONTS to a vector of font_name
2731 structures allocated from the heap containing the fonts found.
2732 Value is the number of fonts found. */
2735 font_list_1 (f
, pattern
, family
, registry
, fonts
)
2737 Lisp_Object pattern
, family
, registry
;
2738 struct font_name
**fonts
;
2740 char *pattern_str
, *family_str
, *registry_str
;
2744 family_str
= (NILP (family
) ? "*" : (char *) SDATA (family
));
2745 registry_str
= (NILP (registry
) ? "*" : (char *) SDATA (registry
));
2747 pattern_str
= (char *) alloca (strlen (family_str
)
2748 + strlen (registry_str
)
2750 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2751 strcat (pattern_str
, family_str
);
2752 strcat (pattern_str
, "-*-");
2753 strcat (pattern_str
, registry_str
);
2754 if (!index (registry_str
, '-'))
2756 if (registry_str
[strlen (registry_str
) - 1] == '*')
2757 strcat (pattern_str
, "-*");
2759 strcat (pattern_str
, "*-*");
2763 pattern_str
= (char *) SDATA (pattern
);
2765 return sorted_font_list (f
, pattern_str
, cmp_font_names
, fonts
);
2769 /* Concatenate font list FONTS1 and FONTS2. FONTS1 and FONTS2
2770 contains NFONTS1 fonts and NFONTS2 fonts respectively. Return a
2771 pointer to a newly allocated font list. FONTS1 and FONTS2 are
2774 static struct font_name
*
2775 concat_font_list (fonts1
, nfonts1
, fonts2
, nfonts2
)
2776 struct font_name
*fonts1
, *fonts2
;
2777 int nfonts1
, nfonts2
;
2779 int new_nfonts
= nfonts1
+ nfonts2
;
2780 struct font_name
*new_fonts
;
2782 new_fonts
= (struct font_name
*) xmalloc (sizeof *new_fonts
* new_nfonts
);
2783 bcopy (fonts1
, new_fonts
, sizeof *new_fonts
* nfonts1
);
2784 bcopy (fonts2
, new_fonts
+ nfonts1
, sizeof *new_fonts
* nfonts2
);
2791 /* Get a sorted list of fonts of family FAMILY on frame F.
2793 If PATTERN is non-nil list fonts matching that pattern.
2795 If REGISTRY is non-nil, return fonts with that registry and the
2796 alternative registries from Vface_alternative_font_registry_alist.
2798 If REGISTRY is nil return fonts of any registry.
2800 Set *FONTS to a vector of font_name structures allocated from the
2801 heap containing the fonts found. Value is the number of fonts
2805 font_list (f
, pattern
, family
, registry
, fonts
)
2807 Lisp_Object pattern
, family
, registry
;
2808 struct font_name
**fonts
;
2810 int nfonts
= font_list_1 (f
, pattern
, family
, registry
, fonts
);
2812 if (!NILP (registry
)
2813 && CONSP (Vface_alternative_font_registry_alist
))
2817 alter
= Fassoc (registry
, Vface_alternative_font_registry_alist
);
2822 for (alter
= XCDR (alter
), reg_prio
= 1;
2824 alter
= XCDR (alter
), reg_prio
++)
2825 if (STRINGP (XCAR (alter
)))
2828 struct font_name
*fonts2
;
2830 nfonts2
= font_list_1 (f
, pattern
, family
, XCAR (alter
),
2832 for (i
= 0; i
< nfonts2
; i
++)
2833 fonts2
[i
].registry_priority
= reg_prio
;
2834 *fonts
= (nfonts
> 0
2835 ? concat_font_list (*fonts
, nfonts
, fonts2
, nfonts2
)
2846 /* Remove elements from LIST whose cars are `equal'. Called from
2847 x-family-fonts and x-font-family-list to remove duplicate font
2851 remove_duplicates (list
)
2854 Lisp_Object tail
= list
;
2856 while (!NILP (tail
) && !NILP (XCDR (tail
)))
2858 Lisp_Object next
= XCDR (tail
);
2859 if (!NILP (Fequal (XCAR (next
), XCAR (tail
))))
2860 XSETCDR (tail
, XCDR (next
));
2867 DEFUN ("x-family-fonts", Fx_family_fonts
, Sx_family_fonts
, 0, 2, 0,
2868 doc
: /* Return a list of available fonts of family FAMILY on FRAME.
2869 If FAMILY is omitted or nil, list all families.
2870 Otherwise, FAMILY must be a string, possibly containing wildcards
2872 If FRAME is omitted or nil, use the selected frame.
2873 Each element of the result is a vector [FAMILY WIDTH POINT-SIZE WEIGHT
2874 SLANT FIXED-P FULL REGISTRY-AND-ENCODING].
2875 FAMILY is the font family name. POINT-SIZE is the size of the
2876 font in 1/10 pt. WIDTH, WEIGHT, and SLANT are symbols describing the
2877 width, weight and slant of the font. These symbols are the same as for
2878 face attributes. FIXED-P is non-nil if the font is fixed-pitch.
2879 FULL is the full name of the font, and REGISTRY-AND-ENCODING is a string
2880 giving the registry and encoding of the font.
2881 The result list is sorted according to the current setting of
2882 the face font sort order. */)
2884 Lisp_Object family
, frame
;
2886 struct frame
*f
= check_x_frame (frame
);
2887 struct font_name
*fonts
;
2890 struct gcpro gcpro1
;
2893 CHECK_STRING (family
);
2897 nfonts
= font_list (f
, Qnil
, family
, Qnil
, &fonts
);
2898 for (i
= nfonts
- 1; i
>= 0; --i
)
2900 Lisp_Object v
= Fmake_vector (make_number (8), Qnil
);
2903 ASET (v
, 0, build_string (fonts
[i
].fields
[XLFD_FAMILY
]));
2904 ASET (v
, 1, xlfd_symbolic_swidth (fonts
+ i
));
2905 ASET (v
, 2, make_number (xlfd_point_size (f
, fonts
+ i
)));
2906 ASET (v
, 3, xlfd_symbolic_weight (fonts
+ i
));
2907 ASET (v
, 4, xlfd_symbolic_slant (fonts
+ i
));
2908 ASET (v
, 5, xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
);
2909 tem
= build_font_name (fonts
+ i
);
2910 ASET (v
, 6, build_string (tem
));
2911 sprintf (tem
, "%s-%s", fonts
[i
].fields
[XLFD_REGISTRY
],
2912 fonts
[i
].fields
[XLFD_ENCODING
]);
2913 ASET (v
, 7, build_string (tem
));
2916 result
= Fcons (v
, result
);
2919 remove_duplicates (result
);
2920 free_font_names (fonts
, nfonts
);
2926 DEFUN ("x-font-family-list", Fx_font_family_list
, Sx_font_family_list
,
2928 doc
: /* Return a list of available font families on FRAME.
2929 If FRAME is omitted or nil, use the selected frame.
2930 Value is a list of conses (FAMILY . FIXED-P) where FAMILY
2931 is a font family, and FIXED-P is non-nil if fonts of that family
2932 are fixed-pitch. */)
2936 struct frame
*f
= check_x_frame (frame
);
2938 struct font_name
*fonts
;
2940 struct gcpro gcpro1
;
2941 int count
= SPECPDL_INDEX ();
2943 /* Let's consider all fonts. */
2944 specbind (intern ("font-list-limit"), make_number (-1));
2945 nfonts
= font_list (f
, Qnil
, Qnil
, Qnil
, &fonts
);
2949 for (i
= nfonts
- 1; i
>= 0; --i
)
2950 result
= Fcons (Fcons (build_string (fonts
[i
].fields
[XLFD_FAMILY
]),
2951 xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
),
2954 remove_duplicates (result
);
2955 free_font_names (fonts
, nfonts
);
2957 return unbind_to (count
, result
);
2961 DEFUN ("x-list-fonts", Fx_list_fonts
, Sx_list_fonts
, 1, 5, 0,
2962 doc
: /* Return a list of the names of available fonts matching PATTERN.
2963 If optional arguments FACE and FRAME are specified, return only fonts
2964 the same size as FACE on FRAME.
2965 PATTERN is a string, perhaps with wildcard characters;
2966 the * character matches any substring, and
2967 the ? character matches any single character.
2968 PATTERN is case-insensitive.
2969 FACE is a face name--a symbol.
2971 The return value is a list of strings, suitable as arguments to
2974 Fonts Emacs can't use may or may not be excluded
2975 even if they match PATTERN and FACE.
2976 The optional fourth argument MAXIMUM sets a limit on how many
2977 fonts to match. The first MAXIMUM fonts are reported.
2978 The optional fifth argument WIDTH, if specified, is a number of columns
2979 occupied by a character of a font. In that case, return only fonts
2980 the WIDTH times as wide as FACE on FRAME. */)
2981 (pattern
, face
, frame
, maximum
, width
)
2982 Lisp_Object pattern
, face
, frame
, maximum
, width
;
2989 CHECK_STRING (pattern
);
2995 CHECK_NATNUM (maximum
);
2996 maxnames
= XINT (maximum
);
3000 CHECK_NUMBER (width
);
3002 /* We can't simply call check_x_frame because this function may be
3003 called before any frame is created. */
3004 f
= frame_or_selected_frame (frame
, 2);
3005 if (!FRAME_WINDOW_P (f
))
3007 /* Perhaps we have not yet created any frame. */
3012 /* Determine the width standard for comparison with the fonts we find. */
3018 /* This is of limited utility since it works with character
3019 widths. Keep it for compatibility. --gerd. */
3020 int face_id
= lookup_named_face (f
, face
, 0, 0);
3021 struct face
*face
= (face_id
< 0
3023 : FACE_FROM_ID (f
, face_id
));
3026 /* For historic reasons, FONT_WIDTH refers to average width on W32,
3027 not maximum as on X. Redefine here. */
3029 #define FONT_WIDTH FONT_MAX_WIDTH
3032 if (face
&& face
->font
)
3033 size
= FONT_WIDTH (face
->font
);
3035 size
= FONT_WIDTH (FRAME_FONT (f
)); /* FRAME_COLUMN_WIDTH (f) */
3038 size
*= XINT (width
);
3042 Lisp_Object args
[2];
3044 args
[0] = x_list_fonts (f
, pattern
, size
, maxnames
);
3046 /* We don't have to check fontsets. */
3048 args
[1] = list_fontsets (f
, pattern
, size
);
3049 return Fnconc (2, args
);
3053 #endif /* HAVE_WINDOW_SYSTEM */
3057 /***********************************************************************
3059 ***********************************************************************/
3061 /* Access face attributes of face LFACE, a Lisp vector. */
3063 #define LFACE_FAMILY(LFACE) AREF ((LFACE), LFACE_FAMILY_INDEX)
3064 #define LFACE_HEIGHT(LFACE) AREF ((LFACE), LFACE_HEIGHT_INDEX)
3065 #define LFACE_WEIGHT(LFACE) AREF ((LFACE), LFACE_WEIGHT_INDEX)
3066 #define LFACE_SLANT(LFACE) AREF ((LFACE), LFACE_SLANT_INDEX)
3067 #define LFACE_UNDERLINE(LFACE) AREF ((LFACE), LFACE_UNDERLINE_INDEX)
3068 #define LFACE_INVERSE(LFACE) AREF ((LFACE), LFACE_INVERSE_INDEX)
3069 #define LFACE_FOREGROUND(LFACE) AREF ((LFACE), LFACE_FOREGROUND_INDEX)
3070 #define LFACE_BACKGROUND(LFACE) AREF ((LFACE), LFACE_BACKGROUND_INDEX)
3071 #define LFACE_STIPPLE(LFACE) AREF ((LFACE), LFACE_STIPPLE_INDEX)
3072 #define LFACE_SWIDTH(LFACE) AREF ((LFACE), LFACE_SWIDTH_INDEX)
3073 #define LFACE_OVERLINE(LFACE) AREF ((LFACE), LFACE_OVERLINE_INDEX)
3074 #define LFACE_STRIKE_THROUGH(LFACE) AREF ((LFACE), LFACE_STRIKE_THROUGH_INDEX)
3075 #define LFACE_BOX(LFACE) AREF ((LFACE), LFACE_BOX_INDEX)
3076 #define LFACE_FONT(LFACE) AREF ((LFACE), LFACE_FONT_INDEX)
3077 #define LFACE_INHERIT(LFACE) AREF ((LFACE), LFACE_INHERIT_INDEX)
3078 #define LFACE_AVGWIDTH(LFACE) AREF ((LFACE), LFACE_AVGWIDTH_INDEX)
3080 /* Non-zero if LFACE is a Lisp face. A Lisp face is a vector of size
3081 LFACE_VECTOR_SIZE which has the symbol `face' in slot 0. */
3083 #define LFACEP(LFACE) \
3085 && XVECTOR (LFACE)->size == LFACE_VECTOR_SIZE \
3086 && EQ (AREF (LFACE, 0), Qface))
3091 /* Check consistency of Lisp face attribute vector ATTRS. */
3094 check_lface_attrs (attrs
)
3097 xassert (UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
3098 || STRINGP (attrs
[LFACE_FAMILY_INDEX
]));
3099 xassert (UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
3100 || SYMBOLP (attrs
[LFACE_SWIDTH_INDEX
]));
3101 xassert (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
3102 || INTEGERP (attrs
[LFACE_AVGWIDTH_INDEX
]));
3103 xassert (UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
3104 || INTEGERP (attrs
[LFACE_HEIGHT_INDEX
])
3105 || FLOATP (attrs
[LFACE_HEIGHT_INDEX
])
3106 || FUNCTIONP (attrs
[LFACE_HEIGHT_INDEX
]));
3107 xassert (UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
3108 || SYMBOLP (attrs
[LFACE_WEIGHT_INDEX
]));
3109 xassert (UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
3110 || SYMBOLP (attrs
[LFACE_SLANT_INDEX
]));
3111 xassert (UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
3112 || SYMBOLP (attrs
[LFACE_UNDERLINE_INDEX
])
3113 || STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]));
3114 xassert (UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
3115 || SYMBOLP (attrs
[LFACE_OVERLINE_INDEX
])
3116 || STRINGP (attrs
[LFACE_OVERLINE_INDEX
]));
3117 xassert (UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3118 || SYMBOLP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3119 || STRINGP (attrs
[LFACE_STRIKE_THROUGH_INDEX
]));
3120 xassert (UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
3121 || SYMBOLP (attrs
[LFACE_BOX_INDEX
])
3122 || STRINGP (attrs
[LFACE_BOX_INDEX
])
3123 || INTEGERP (attrs
[LFACE_BOX_INDEX
])
3124 || CONSP (attrs
[LFACE_BOX_INDEX
]));
3125 xassert (UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
3126 || SYMBOLP (attrs
[LFACE_INVERSE_INDEX
]));
3127 xassert (UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
3128 || STRINGP (attrs
[LFACE_FOREGROUND_INDEX
]));
3129 xassert (UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
3130 || STRINGP (attrs
[LFACE_BACKGROUND_INDEX
]));
3131 xassert (UNSPECIFIEDP (attrs
[LFACE_INHERIT_INDEX
])
3132 || NILP (attrs
[LFACE_INHERIT_INDEX
])
3133 || SYMBOLP (attrs
[LFACE_INHERIT_INDEX
])
3134 || CONSP (attrs
[LFACE_INHERIT_INDEX
]));
3135 #ifdef HAVE_WINDOW_SYSTEM
3136 xassert (UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
3137 || SYMBOLP (attrs
[LFACE_STIPPLE_INDEX
])
3138 || !NILP (Fbitmap_spec_p (attrs
[LFACE_STIPPLE_INDEX
])));
3139 xassert (UNSPECIFIEDP (attrs
[LFACE_FONT_INDEX
])
3140 || NILP (attrs
[LFACE_FONT_INDEX
])
3141 || STRINGP (attrs
[LFACE_FONT_INDEX
]));
3146 /* Check consistency of attributes of Lisp face LFACE (a Lisp vector). */
3154 xassert (LFACEP (lface
));
3155 check_lface_attrs (XVECTOR (lface
)->contents
);
3159 #else /* GLYPH_DEBUG == 0 */
3161 #define check_lface_attrs(attrs) (void) 0
3162 #define check_lface(lface) (void) 0
3164 #endif /* GLYPH_DEBUG == 0 */
3168 /* Face-merge cycle checking. */
3170 /* A `named merge point' is simply a point during face-merging where we
3171 look up a face by name. We keep a stack of which named lookups we're
3172 currently processing so that we can easily detect cycles, using a
3173 linked- list of struct named_merge_point structures, typically
3174 allocated on the stack frame of the named lookup functions which are
3175 active (so no consing is required). */
3176 struct named_merge_point
3178 Lisp_Object face_name
;
3179 struct named_merge_point
*prev
;
3183 /* If a face merging cycle is detected for FACE_NAME, return 0,
3184 otherwise add NEW_NAMED_MERGE_POINT, which is initialized using
3185 FACE_NAME, as the head of the linked list pointed to by
3186 NAMED_MERGE_POINTS, and return 1. */
3189 push_named_merge_point (struct named_merge_point
*new_named_merge_point
,
3190 Lisp_Object face_name
,
3191 struct named_merge_point
**named_merge_points
)
3193 struct named_merge_point
*prev
;
3195 for (prev
= *named_merge_points
; prev
; prev
= prev
->prev
)
3196 if (EQ (face_name
, prev
->face_name
))
3199 new_named_merge_point
->face_name
= face_name
;
3200 new_named_merge_point
->prev
= *named_merge_points
;
3202 *named_merge_points
= new_named_merge_point
;
3210 internal_resolve_face_name (nargs
, args
)
3214 Fget (args
[0], args
[1]);
3218 resolve_face_name_error (ignore
)
3224 /* Resolve face name FACE_NAME. If FACE_NAME is a string, intern it
3225 to make it a symbol. If FACE_NAME is an alias for another face,
3226 return that face's name.
3228 Return default face in case of errors. */
3231 resolve_face_name (face_name
, signal_p
)
3232 Lisp_Object face_name
;
3235 Lisp_Object orig_face
;
3236 Lisp_Object tortoise
, hare
;
3238 if (STRINGP (face_name
))
3239 face_name
= intern (SDATA (face_name
));
3241 if (NILP (face_name
) || !SYMBOLP (face_name
))
3244 orig_face
= face_name
;
3245 tortoise
= hare
= face_name
;
3250 hare
= Fget (hare
, Qface_alias
);
3251 if (NILP (hare
) || !SYMBOLP (hare
))
3255 hare
= Fget (hare
, Qface_alias
);
3256 if (NILP (hare
) || !SYMBOLP (hare
))
3259 tortoise
= Fget (tortoise
, Qface_alias
);
3260 if (EQ (hare
, tortoise
))
3263 Fsignal (Qcircular_list
, Fcons (orig_face
, Qnil
));
3272 /* Return the face definition of FACE_NAME on frame F. F null means
3273 return the definition for new frames. FACE_NAME may be a string or
3274 a symbol (apparently Emacs 20.2 allowed strings as face names in
3275 face text properties; Ediff uses that). If FACE_NAME is an alias
3276 for another face, return that face's definition. If SIGNAL_P is
3277 non-zero, signal an error if FACE_NAME is not a valid face name.
3278 If SIGNAL_P is zero, value is nil if FACE_NAME is not a valid face
3281 static INLINE Lisp_Object
3282 lface_from_face_name (f
, face_name
, signal_p
)
3284 Lisp_Object face_name
;
3289 face_name
= resolve_face_name (face_name
, signal_p
);
3292 lface
= assq_no_quit (face_name
, f
->face_alist
);
3294 lface
= assq_no_quit (face_name
, Vface_new_frame_defaults
);
3297 lface
= XCDR (lface
);
3299 signal_error ("Invalid face", face_name
);
3301 check_lface (lface
);
3306 /* Get face attributes of face FACE_NAME from frame-local faces on
3307 frame F. Store the resulting attributes in ATTRS which must point
3308 to a vector of Lisp_Objects of size LFACE_VECTOR_SIZE. If SIGNAL_P
3309 is non-zero, signal an error if FACE_NAME does not name a face.
3310 Otherwise, value is zero if FACE_NAME is not a face. */
3313 get_lface_attributes (f
, face_name
, attrs
, signal_p
)
3315 Lisp_Object face_name
;
3322 lface
= lface_from_face_name (f
, face_name
, signal_p
);
3325 bcopy (XVECTOR (lface
)->contents
, attrs
,
3326 LFACE_VECTOR_SIZE
* sizeof *attrs
);
3336 /* Non-zero if all attributes in face attribute vector ATTRS are
3337 specified, i.e. are non-nil. */
3340 lface_fully_specified_p (attrs
)
3345 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3346 if (i
!= LFACE_FONT_INDEX
&& i
!= LFACE_INHERIT_INDEX
3347 && i
!= LFACE_AVGWIDTH_INDEX
)
3348 if (UNSPECIFIEDP (attrs
[i
])
3350 /* MAC_TODO: No stipple support on Mac OS yet, this index is
3351 always unspecified. */
3352 && i
!= LFACE_STIPPLE_INDEX
3357 return i
== LFACE_VECTOR_SIZE
;
3360 #ifdef HAVE_WINDOW_SYSTEM
3362 /* Set font-related attributes of Lisp face LFACE from the fullname of
3363 the font opened by FONTNAME. If FORCE_P is zero, set only
3364 unspecified attributes of LFACE. The exception is `font'
3365 attribute. It is set to FONTNAME as is regardless of FORCE_P.
3367 If FONTNAME is not available on frame F,
3368 return 0 if MAY_FAIL_P is non-zero, otherwise abort.
3369 If the fullname is not in a valid XLFD format,
3370 return 0 if MAY_FAIL_P is non-zero, otherwise set normal values
3371 in LFACE and return 1.
3372 Otherwise, return 1. */
3375 set_lface_from_font_name (f
, lface
, fontname
, force_p
, may_fail_p
)
3378 Lisp_Object fontname
;
3379 int force_p
, may_fail_p
;
3381 struct font_name font
;
3386 char *font_name
= SDATA (fontname
);
3387 struct font_info
*font_info
;
3389 /* If FONTNAME is actually a fontset name, get ASCII font name of it. */
3390 fontset
= fs_query_fontset (fontname
, 0);
3392 font_name
= SDATA (fontset_ascii (fontset
));
3394 /* Check if FONT_NAME is surely available on the system. Usually
3395 FONT_NAME is already cached for the frame F and FS_LOAD_FONT
3396 returns quickly. But, even if FONT_NAME is not yet cached,
3397 caching it now is not futail because we anyway load the font
3400 font_info
= FS_LOAD_FONT (f
, 0, font_name
, -1);
3410 font
.name
= STRDUPA (font_info
->full_name
);
3411 have_xlfd_p
= split_font_name (f
, &font
, 1);
3413 /* Set attributes only if unspecified, otherwise face defaults for
3414 new frames would never take effect. If we couldn't get a font
3415 name conforming to XLFD, set normal values. */
3417 if (force_p
|| UNSPECIFIEDP (LFACE_FAMILY (lface
)))
3422 buffer
= (char *) alloca (strlen (font
.fields
[XLFD_FAMILY
])
3423 + strlen (font
.fields
[XLFD_FOUNDRY
])
3425 sprintf (buffer
, "%s-%s", font
.fields
[XLFD_FOUNDRY
],
3426 font
.fields
[XLFD_FAMILY
]);
3427 val
= build_string (buffer
);
3430 val
= build_string ("*");
3431 LFACE_FAMILY (lface
) = val
;
3434 if (force_p
|| UNSPECIFIEDP (LFACE_HEIGHT (lface
)))
3437 pt
= xlfd_point_size (f
, &font
);
3439 pt
= pixel_point_size (f
, font_info
->height
* 10);
3441 LFACE_HEIGHT (lface
) = make_number (pt
);
3444 if (force_p
|| UNSPECIFIEDP (LFACE_SWIDTH (lface
)))
3445 LFACE_SWIDTH (lface
)
3446 = have_xlfd_p
? xlfd_symbolic_swidth (&font
) : Qnormal
;
3448 if (force_p
|| UNSPECIFIEDP (LFACE_AVGWIDTH (lface
)))
3449 LFACE_AVGWIDTH (lface
)
3451 ? make_number (font
.numeric
[XLFD_AVGWIDTH
])
3454 if (force_p
|| UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
3455 LFACE_WEIGHT (lface
)
3456 = have_xlfd_p
? xlfd_symbolic_weight (&font
) : Qnormal
;
3458 if (force_p
|| UNSPECIFIEDP (LFACE_SLANT (lface
)))
3460 = have_xlfd_p
? xlfd_symbolic_slant (&font
) : Qnormal
;
3462 LFACE_FONT (lface
) = fontname
;
3467 #endif /* HAVE_WINDOW_SYSTEM */
3470 /* Merges the face height FROM with the face height TO, and returns the
3471 merged height. If FROM is an invalid height, then INVALID is
3472 returned instead. FROM and TO may be either absolute face heights or
3473 `relative' heights; the returned value is always an absolute height
3474 unless both FROM and TO are relative. GCPRO is a lisp value that
3475 will be protected from garbage-collection if this function makes a
3479 merge_face_heights (from
, to
, invalid
)
3480 Lisp_Object from
, to
, invalid
;
3482 Lisp_Object result
= invalid
;
3484 if (INTEGERP (from
))
3485 /* FROM is absolute, just use it as is. */
3487 else if (FLOATP (from
))
3488 /* FROM is a scale, use it to adjust TO. */
3491 /* relative X absolute => absolute */
3492 result
= make_number ((EMACS_INT
)(XFLOAT_DATA (from
) * XINT (to
)));
3493 else if (FLOATP (to
))
3494 /* relative X relative => relative */
3495 result
= make_float (XFLOAT_DATA (from
) * XFLOAT_DATA (to
));
3496 else if (UNSPECIFIEDP (to
))
3499 else if (FUNCTIONP (from
))
3500 /* FROM is a function, which use to adjust TO. */
3502 /* Call function with current height as argument.
3503 From is the new height. */
3504 Lisp_Object args
[2];
3508 result
= safe_call (2, args
);
3510 /* Ensure that if TO was absolute, so is the result. */
3511 if (INTEGERP (to
) && !INTEGERP (result
))
3519 /* Merge two Lisp face attribute vectors on frame F, FROM and TO, and
3520 store the resulting attributes in TO, which must be already be
3521 completely specified and contain only absolute attributes. Every
3522 specified attribute of FROM overrides the corresponding attribute of
3523 TO; relative attributes in FROM are merged with the absolute value in
3524 TO and replace it. NAMED_MERGE_POINTS is used internally to detect
3525 loops in face inheritance; it should be 0 when called from other
3529 merge_face_vectors (f
, from
, to
, named_merge_points
)
3531 Lisp_Object
*from
, *to
;
3532 struct named_merge_point
*named_merge_points
;
3536 /* If FROM inherits from some other faces, merge their attributes into
3537 TO before merging FROM's direct attributes. Note that an :inherit
3538 attribute of `unspecified' is the same as one of nil; we never
3539 merge :inherit attributes, so nil is more correct, but lots of
3540 other code uses `unspecified' as a generic value for face attributes. */
3541 if (!UNSPECIFIEDP (from
[LFACE_INHERIT_INDEX
])
3542 && !NILP (from
[LFACE_INHERIT_INDEX
]))
3543 merge_face_ref (f
, from
[LFACE_INHERIT_INDEX
], to
, 0, named_merge_points
);
3545 /* If TO specifies a :font attribute, and FROM specifies some
3546 font-related attribute, we need to clear TO's :font attribute
3547 (because it will be inconsistent with whatever FROM specifies, and
3548 FROM takes precedence). */
3549 if (!NILP (to
[LFACE_FONT_INDEX
])
3550 && (!UNSPECIFIEDP (from
[LFACE_FAMILY_INDEX
])
3551 || !UNSPECIFIEDP (from
[LFACE_HEIGHT_INDEX
])
3552 || !UNSPECIFIEDP (from
[LFACE_WEIGHT_INDEX
])
3553 || !UNSPECIFIEDP (from
[LFACE_SLANT_INDEX
])
3554 || !UNSPECIFIEDP (from
[LFACE_SWIDTH_INDEX
])
3555 || !UNSPECIFIEDP (from
[LFACE_AVGWIDTH_INDEX
])))
3556 to
[LFACE_FONT_INDEX
] = Qnil
;
3558 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3559 if (!UNSPECIFIEDP (from
[i
]))
3561 if (i
== LFACE_HEIGHT_INDEX
&& !INTEGERP (from
[i
]))
3562 to
[i
] = merge_face_heights (from
[i
], to
[i
], to
[i
]);
3567 /* TO is always an absolute face, which should inherit from nothing.
3568 We blindly copy the :inherit attribute above and fix it up here. */
3569 to
[LFACE_INHERIT_INDEX
] = Qnil
;
3572 /* Merge the named face FACE_NAME on frame F, into the vector of face
3573 attributes TO. NAMED_MERGE_POINTS is used to detect loops in face
3574 inheritance. Returns true if FACE_NAME is a valid face name and
3575 merging succeeded. */
3578 merge_named_face (f
, face_name
, to
, named_merge_points
)
3580 Lisp_Object face_name
;
3582 struct named_merge_point
*named_merge_points
;
3584 struct named_merge_point named_merge_point
;
3586 if (push_named_merge_point (&named_merge_point
,
3587 face_name
, &named_merge_points
))
3589 struct gcpro gcpro1
;
3590 Lisp_Object from
[LFACE_VECTOR_SIZE
];
3591 int ok
= get_lface_attributes (f
, face_name
, from
, 0);
3595 GCPRO1 (named_merge_point
.face_name
);
3596 merge_face_vectors (f
, from
, to
, named_merge_points
);
3607 /* Merge face attributes from the lisp `face reference' FACE_REF on
3608 frame F into the face attribute vector TO. If ERR_MSGS is non-zero,
3609 problems with FACE_REF cause an error message to be shown. Return
3610 non-zero if no errors occurred (regardless of the value of ERR_MSGS).
3611 NAMED_MERGE_POINTS is used to detect loops in face inheritance or
3612 list structure; it may be 0 for most callers.
3614 FACE_REF may be a single face specification or a list of such
3615 specifications. Each face specification can be:
3617 1. A symbol or string naming a Lisp face.
3619 2. A property list of the form (KEYWORD VALUE ...) where each
3620 KEYWORD is a face attribute name, and value is an appropriate value
3623 3. Conses or the form (FOREGROUND-COLOR . COLOR) or
3624 (BACKGROUND-COLOR . COLOR) where COLOR is a color name. This is
3625 for compatibility with 20.2.
3627 Face specifications earlier in lists take precedence over later
3631 merge_face_ref (f
, face_ref
, to
, err_msgs
, named_merge_points
)
3633 Lisp_Object face_ref
;
3636 struct named_merge_point
*named_merge_points
;
3638 int ok
= 1; /* Succeed without an error? */
3640 if (CONSP (face_ref
))
3642 Lisp_Object first
= XCAR (face_ref
);
3644 if (EQ (first
, Qforeground_color
)
3645 || EQ (first
, Qbackground_color
))
3647 /* One of (FOREGROUND-COLOR . COLOR) or (BACKGROUND-COLOR
3648 . COLOR). COLOR must be a string. */
3649 Lisp_Object color_name
= XCDR (face_ref
);
3650 Lisp_Object color
= first
;
3652 if (STRINGP (color_name
))
3654 if (EQ (color
, Qforeground_color
))
3655 to
[LFACE_FOREGROUND_INDEX
] = color_name
;
3657 to
[LFACE_BACKGROUND_INDEX
] = color_name
;
3662 add_to_log ("Invalid face color", color_name
, Qnil
);
3666 else if (SYMBOLP (first
)
3667 && *SDATA (SYMBOL_NAME (first
)) == ':')
3669 /* Assume this is the property list form. */
3670 while (CONSP (face_ref
) && CONSP (XCDR (face_ref
)))
3672 Lisp_Object keyword
= XCAR (face_ref
);
3673 Lisp_Object value
= XCAR (XCDR (face_ref
));
3676 /* Specifying `unspecified' is a no-op. */
3677 if (EQ (value
, Qunspecified
))
3679 else if (EQ (keyword
, QCfamily
))
3681 if (STRINGP (value
))
3682 to
[LFACE_FAMILY_INDEX
] = value
;
3686 else if (EQ (keyword
, QCheight
))
3688 Lisp_Object new_height
=
3689 merge_face_heights (value
, to
[LFACE_HEIGHT_INDEX
], Qnil
);
3691 if (! NILP (new_height
))
3692 to
[LFACE_HEIGHT_INDEX
] = new_height
;
3696 else if (EQ (keyword
, QCweight
))
3699 && face_numeric_weight (value
) >= 0)
3700 to
[LFACE_WEIGHT_INDEX
] = value
;
3704 else if (EQ (keyword
, QCslant
))
3707 && face_numeric_slant (value
) >= 0)
3708 to
[LFACE_SLANT_INDEX
] = value
;
3712 else if (EQ (keyword
, QCunderline
))
3717 to
[LFACE_UNDERLINE_INDEX
] = value
;
3721 else if (EQ (keyword
, QCoverline
))
3726 to
[LFACE_OVERLINE_INDEX
] = value
;
3730 else if (EQ (keyword
, QCstrike_through
))
3735 to
[LFACE_STRIKE_THROUGH_INDEX
] = value
;
3739 else if (EQ (keyword
, QCbox
))
3742 value
= make_number (1);
3743 if (INTEGERP (value
)
3747 to
[LFACE_BOX_INDEX
] = value
;
3751 else if (EQ (keyword
, QCinverse_video
)
3752 || EQ (keyword
, QCreverse_video
))
3754 if (EQ (value
, Qt
) || NILP (value
))
3755 to
[LFACE_INVERSE_INDEX
] = value
;
3759 else if (EQ (keyword
, QCforeground
))
3761 if (STRINGP (value
))
3762 to
[LFACE_FOREGROUND_INDEX
] = value
;
3766 else if (EQ (keyword
, QCbackground
))
3768 if (STRINGP (value
))
3769 to
[LFACE_BACKGROUND_INDEX
] = value
;
3773 else if (EQ (keyword
, QCstipple
))
3775 #ifdef HAVE_X_WINDOWS
3776 Lisp_Object pixmap_p
= Fbitmap_spec_p (value
);
3777 if (!NILP (pixmap_p
))
3778 to
[LFACE_STIPPLE_INDEX
] = value
;
3783 else if (EQ (keyword
, QCwidth
))
3786 && face_numeric_swidth (value
) >= 0)
3787 to
[LFACE_SWIDTH_INDEX
] = value
;
3791 else if (EQ (keyword
, QCinherit
))
3793 /* This is not really very useful; it's just like a
3794 normal face reference. */
3795 if (! merge_face_ref (f
, value
, to
,
3796 err_msgs
, named_merge_points
))
3804 add_to_log ("Invalid face attribute %S %S", keyword
, value
);
3808 face_ref
= XCDR (XCDR (face_ref
));
3813 /* This is a list of face refs. Those at the beginning of the
3814 list take precedence over what follows, so we have to merge
3815 from the end backwards. */
3816 Lisp_Object next
= XCDR (face_ref
);
3819 ok
= merge_face_ref (f
, next
, to
, err_msgs
, named_merge_points
);
3821 if (! merge_face_ref (f
, first
, to
, err_msgs
, named_merge_points
))
3827 /* FACE_REF ought to be a face name. */
3828 ok
= merge_named_face (f
, face_ref
, to
, named_merge_points
);
3829 if (!ok
&& err_msgs
)
3830 add_to_log ("Invalid face reference: %s", face_ref
, Qnil
);
3837 DEFUN ("internal-make-lisp-face", Finternal_make_lisp_face
,
3838 Sinternal_make_lisp_face
, 1, 2, 0,
3839 doc
: /* Make FACE, a symbol, a Lisp face with all attributes nil.
3840 If FACE was not known as a face before, create a new one.
3841 If optional argument FRAME is specified, make a frame-local face
3842 for that frame. Otherwise operate on the global face definition.
3843 Value is a vector of face attributes. */)
3845 Lisp_Object face
, frame
;
3847 Lisp_Object global_lface
, lface
;
3851 CHECK_SYMBOL (face
);
3852 global_lface
= lface_from_face_name (NULL
, face
, 0);
3856 CHECK_LIVE_FRAME (frame
);
3858 lface
= lface_from_face_name (f
, face
, 0);
3861 f
= NULL
, lface
= Qnil
;
3863 /* Add a global definition if there is none. */
3864 if (NILP (global_lface
))
3866 global_lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
3868 AREF (global_lface
, 0) = Qface
;
3869 Vface_new_frame_defaults
= Fcons (Fcons (face
, global_lface
),
3870 Vface_new_frame_defaults
);
3872 /* Assign the new Lisp face a unique ID. The mapping from Lisp
3873 face id to Lisp face is given by the vector lface_id_to_name.
3874 The mapping from Lisp face to Lisp face id is given by the
3875 property `face' of the Lisp face name. */
3876 if (next_lface_id
== lface_id_to_name_size
)
3878 int new_size
= max (50, 2 * lface_id_to_name_size
);
3879 int sz
= new_size
* sizeof *lface_id_to_name
;
3880 lface_id_to_name
= (Lisp_Object
*) xrealloc (lface_id_to_name
, sz
);
3881 lface_id_to_name_size
= new_size
;
3884 lface_id_to_name
[next_lface_id
] = face
;
3885 Fput (face
, Qface
, make_number (next_lface_id
));
3889 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3890 AREF (global_lface
, i
) = Qunspecified
;
3892 /* Add a frame-local definition. */
3897 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
3899 AREF (lface
, 0) = Qface
;
3900 f
->face_alist
= Fcons (Fcons (face
, lface
), f
->face_alist
);
3903 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3904 AREF (lface
, i
) = Qunspecified
;
3907 lface
= global_lface
;
3909 /* Changing a named face means that all realized faces depending on
3910 that face are invalid. Since we cannot tell which realized faces
3911 depend on the face, make sure they are all removed. This is done
3912 by incrementing face_change_count. The next call to
3913 init_iterator will then free realized faces. */
3914 if (NILP (Fget (face
, Qface_no_inherit
)))
3916 ++face_change_count
;
3917 ++windows_or_buffers_changed
;
3920 xassert (LFACEP (lface
));
3921 check_lface (lface
);
3926 DEFUN ("internal-lisp-face-p", Finternal_lisp_face_p
,
3927 Sinternal_lisp_face_p
, 1, 2, 0,
3928 doc
: /* Return non-nil if FACE names a face.
3929 If optional second parameter FRAME is non-nil, check for the
3930 existence of a frame-local face with name FACE on that frame.
3931 Otherwise check for the existence of a global face. */)
3933 Lisp_Object face
, frame
;
3939 CHECK_LIVE_FRAME (frame
);
3940 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
3943 lface
= lface_from_face_name (NULL
, face
, 0);
3949 DEFUN ("internal-copy-lisp-face", Finternal_copy_lisp_face
,
3950 Sinternal_copy_lisp_face
, 4, 4, 0,
3951 doc
: /* Copy face FROM to TO.
3952 If FRAME is t, copy the global face definition of FROM.
3953 Otherwise, copy the frame-local definition of FROM on FRAME.
3954 If NEW-FRAME is a frame, copy that data into the frame-local
3955 definition of TO on NEW-FRAME. If NEW-FRAME is nil.
3956 FRAME controls where the data is copied to.
3958 The value is TO. */)
3959 (from
, to
, frame
, new_frame
)
3960 Lisp_Object from
, to
, frame
, new_frame
;
3962 Lisp_Object lface
, copy
;
3964 CHECK_SYMBOL (from
);
3969 /* Copy global definition of FROM. We don't make copies of
3970 strings etc. because 20.2 didn't do it either. */
3971 lface
= lface_from_face_name (NULL
, from
, 1);
3972 copy
= Finternal_make_lisp_face (to
, Qnil
);
3976 /* Copy frame-local definition of FROM. */
3977 if (NILP (new_frame
))
3979 CHECK_LIVE_FRAME (frame
);
3980 CHECK_LIVE_FRAME (new_frame
);
3981 lface
= lface_from_face_name (XFRAME (frame
), from
, 1);
3982 copy
= Finternal_make_lisp_face (to
, new_frame
);
3985 bcopy (XVECTOR (lface
)->contents
, XVECTOR (copy
)->contents
,
3986 LFACE_VECTOR_SIZE
* sizeof (Lisp_Object
));
3988 /* Changing a named face means that all realized faces depending on
3989 that face are invalid. Since we cannot tell which realized faces
3990 depend on the face, make sure they are all removed. This is done
3991 by incrementing face_change_count. The next call to
3992 init_iterator will then free realized faces. */
3993 if (NILP (Fget (to
, Qface_no_inherit
)))
3995 ++face_change_count
;
3996 ++windows_or_buffers_changed
;
4003 DEFUN ("internal-set-lisp-face-attribute", Finternal_set_lisp_face_attribute
,
4004 Sinternal_set_lisp_face_attribute
, 3, 4, 0,
4005 doc
: /* Set attribute ATTR of FACE to VALUE.
4006 FRAME being a frame means change the face on that frame.
4007 FRAME nil means change the face of the selected frame.
4008 FRAME t means change the default for new frames.
4009 FRAME 0 means change the face on all frames, and change the default
4011 (face
, attr
, value
, frame
)
4012 Lisp_Object face
, attr
, value
, frame
;
4015 Lisp_Object old_value
= Qnil
;
4016 /* Set 1 if ATTR is QCfont. */
4017 int font_attr_p
= 0;
4018 /* Set 1 if ATTR is one of font-related attributes other than QCfont. */
4019 int font_related_attr_p
= 0;
4021 CHECK_SYMBOL (face
);
4022 CHECK_SYMBOL (attr
);
4024 face
= resolve_face_name (face
, 1);
4026 /* If FRAME is 0, change face on all frames, and change the
4027 default for new frames. */
4028 if (INTEGERP (frame
) && XINT (frame
) == 0)
4031 Finternal_set_lisp_face_attribute (face
, attr
, value
, Qt
);
4032 FOR_EACH_FRAME (tail
, frame
)
4033 Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
4037 /* Set lface to the Lisp attribute vector of FACE. */
4039 lface
= lface_from_face_name (NULL
, face
, 1);
4043 frame
= selected_frame
;
4045 CHECK_LIVE_FRAME (frame
);
4046 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
4048 /* If a frame-local face doesn't exist yet, create one. */
4050 lface
= Finternal_make_lisp_face (face
, frame
);
4053 if (EQ (attr
, QCfamily
))
4055 if (!UNSPECIFIEDP (value
))
4057 CHECK_STRING (value
);
4058 if (SCHARS (value
) == 0)
4059 signal_error ("Invalid face family", value
);
4061 old_value
= LFACE_FAMILY (lface
);
4062 LFACE_FAMILY (lface
) = value
;
4063 font_related_attr_p
= 1;
4065 else if (EQ (attr
, QCheight
))
4067 if (!UNSPECIFIEDP (value
))
4071 test
= (EQ (face
, Qdefault
)
4073 /* The default face must have an absolute size,
4074 otherwise, we do a test merge with a random
4075 height to see if VALUE's ok. */
4076 : merge_face_heights (value
, make_number (10), Qnil
));
4078 if (!INTEGERP (test
) || XINT (test
) <= 0)
4079 signal_error ("Invalid face height", value
);
4082 old_value
= LFACE_HEIGHT (lface
);
4083 LFACE_HEIGHT (lface
) = value
;
4084 font_related_attr_p
= 1;
4086 else if (EQ (attr
, QCweight
))
4088 if (!UNSPECIFIEDP (value
))
4090 CHECK_SYMBOL (value
);
4091 if (face_numeric_weight (value
) < 0)
4092 signal_error ("Invalid face weight", value
);
4094 old_value
= LFACE_WEIGHT (lface
);
4095 LFACE_WEIGHT (lface
) = value
;
4096 font_related_attr_p
= 1;
4098 else if (EQ (attr
, QCslant
))
4100 if (!UNSPECIFIEDP (value
))
4102 CHECK_SYMBOL (value
);
4103 if (face_numeric_slant (value
) < 0)
4104 signal_error ("Invalid face slant", value
);
4106 old_value
= LFACE_SLANT (lface
);
4107 LFACE_SLANT (lface
) = value
;
4108 font_related_attr_p
= 1;
4110 else if (EQ (attr
, QCunderline
))
4112 if (!UNSPECIFIEDP (value
))
4113 if ((SYMBOLP (value
)
4115 && !EQ (value
, Qnil
))
4116 /* Underline color. */
4118 && SCHARS (value
) == 0))
4119 signal_error ("Invalid face underline", value
);
4121 old_value
= LFACE_UNDERLINE (lface
);
4122 LFACE_UNDERLINE (lface
) = value
;
4124 else if (EQ (attr
, QCoverline
))
4126 if (!UNSPECIFIEDP (value
))
4127 if ((SYMBOLP (value
)
4129 && !EQ (value
, Qnil
))
4130 /* Overline color. */
4132 && SCHARS (value
) == 0))
4133 signal_error ("Invalid face overline", value
);
4135 old_value
= LFACE_OVERLINE (lface
);
4136 LFACE_OVERLINE (lface
) = value
;
4138 else if (EQ (attr
, QCstrike_through
))
4140 if (!UNSPECIFIEDP (value
))
4141 if ((SYMBOLP (value
)
4143 && !EQ (value
, Qnil
))
4144 /* Strike-through color. */
4146 && SCHARS (value
) == 0))
4147 signal_error ("Invalid face strike-through", value
);
4149 old_value
= LFACE_STRIKE_THROUGH (lface
);
4150 LFACE_STRIKE_THROUGH (lface
) = value
;
4152 else if (EQ (attr
, QCbox
))
4156 /* Allow t meaning a simple box of width 1 in foreground color
4159 value
= make_number (1);
4161 if (UNSPECIFIEDP (value
))
4163 else if (NILP (value
))
4165 else if (INTEGERP (value
))
4166 valid_p
= XINT (value
) != 0;
4167 else if (STRINGP (value
))
4168 valid_p
= SCHARS (value
) > 0;
4169 else if (CONSP (value
))
4185 if (EQ (k
, QCline_width
))
4187 if (!INTEGERP (v
) || XINT (v
) == 0)
4190 else if (EQ (k
, QCcolor
))
4192 if (!NILP (v
) && (!STRINGP (v
) || SCHARS (v
) == 0))
4195 else if (EQ (k
, QCstyle
))
4197 if (!EQ (v
, Qpressed_button
) && !EQ (v
, Qreleased_button
))
4204 valid_p
= NILP (tem
);
4210 signal_error ("Invalid face box", value
);
4212 old_value
= LFACE_BOX (lface
);
4213 LFACE_BOX (lface
) = value
;
4215 else if (EQ (attr
, QCinverse_video
)
4216 || EQ (attr
, QCreverse_video
))
4218 if (!UNSPECIFIEDP (value
))
4220 CHECK_SYMBOL (value
);
4221 if (!EQ (value
, Qt
) && !NILP (value
))
4222 signal_error ("Invalid inverse-video face attribute value", value
);
4224 old_value
= LFACE_INVERSE (lface
);
4225 LFACE_INVERSE (lface
) = value
;
4227 else if (EQ (attr
, QCforeground
))
4229 if (!UNSPECIFIEDP (value
))
4231 /* Don't check for valid color names here because it depends
4232 on the frame (display) whether the color will be valid
4233 when the face is realized. */
4234 CHECK_STRING (value
);
4235 if (SCHARS (value
) == 0)
4236 signal_error ("Empty foreground color value", value
);
4238 old_value
= LFACE_FOREGROUND (lface
);
4239 LFACE_FOREGROUND (lface
) = value
;
4241 else if (EQ (attr
, QCbackground
))
4243 if (!UNSPECIFIEDP (value
))
4245 /* Don't check for valid color names here because it depends
4246 on the frame (display) whether the color will be valid
4247 when the face is realized. */
4248 CHECK_STRING (value
);
4249 if (SCHARS (value
) == 0)
4250 signal_error ("Empty background color value", value
);
4252 old_value
= LFACE_BACKGROUND (lface
);
4253 LFACE_BACKGROUND (lface
) = value
;
4255 else if (EQ (attr
, QCstipple
))
4257 #ifdef HAVE_X_WINDOWS
4258 if (!UNSPECIFIEDP (value
)
4260 && NILP (Fbitmap_spec_p (value
)))
4261 signal_error ("Invalid stipple attribute", value
);
4262 old_value
= LFACE_STIPPLE (lface
);
4263 LFACE_STIPPLE (lface
) = value
;
4264 #endif /* HAVE_X_WINDOWS */
4266 else if (EQ (attr
, QCwidth
))
4268 if (!UNSPECIFIEDP (value
))
4270 CHECK_SYMBOL (value
);
4271 if (face_numeric_swidth (value
) < 0)
4272 signal_error ("Invalid face width", value
);
4274 old_value
= LFACE_SWIDTH (lface
);
4275 LFACE_SWIDTH (lface
) = value
;
4276 font_related_attr_p
= 1;
4278 else if (EQ (attr
, QCfont
))
4280 #ifdef HAVE_WINDOW_SYSTEM
4281 if (EQ (frame
, Qt
) || FRAME_WINDOW_P (XFRAME (frame
)))
4283 /* Set font-related attributes of the Lisp face from an XLFD
4289 f
= SELECTED_FRAME ();
4291 f
= check_x_frame (frame
);
4293 if (!UNSPECIFIEDP (value
))
4295 CHECK_STRING (value
);
4297 /* VALUE may be a fontset name or an alias of fontset. In
4298 such a case, use the base fontset name. */
4299 tmp
= Fquery_fontset (value
, Qnil
);
4303 if (!set_lface_from_font_name (f
, lface
, value
, 1, 1))
4304 signal_error ("Invalid font or fontset name", value
);
4309 #endif /* HAVE_WINDOW_SYSTEM */
4311 else if (EQ (attr
, QCinherit
))
4314 if (SYMBOLP (value
))
4317 for (tail
= value
; CONSP (tail
); tail
= XCDR (tail
))
4318 if (!SYMBOLP (XCAR (tail
)))
4321 LFACE_INHERIT (lface
) = value
;
4323 signal_error ("Invalid face inheritance", value
);
4325 else if (EQ (attr
, QCbold
))
4327 old_value
= LFACE_WEIGHT (lface
);
4328 LFACE_WEIGHT (lface
) = NILP (value
) ? Qnormal
: Qbold
;
4329 font_related_attr_p
= 1;
4331 else if (EQ (attr
, QCitalic
))
4333 old_value
= LFACE_SLANT (lface
);
4334 LFACE_SLANT (lface
) = NILP (value
) ? Qnormal
: Qitalic
;
4335 font_related_attr_p
= 1;
4338 signal_error ("Invalid face attribute name", attr
);
4340 if (font_related_attr_p
4341 && !UNSPECIFIEDP (value
))
4342 /* If a font-related attribute other than QCfont is specified, the
4343 original `font' attribute nor that of default face is useless
4344 to determine a new font. Thus, we set it to nil so that font
4345 selection mechanism doesn't use it. */
4346 LFACE_FONT (lface
) = Qnil
;
4348 /* Changing a named face means that all realized faces depending on
4349 that face are invalid. Since we cannot tell which realized faces
4350 depend on the face, make sure they are all removed. This is done
4351 by incrementing face_change_count. The next call to
4352 init_iterator will then free realized faces. */
4354 && NILP (Fget (face
, Qface_no_inherit
))
4355 && (EQ (attr
, QCfont
)
4356 || NILP (Fequal (old_value
, value
))))
4358 ++face_change_count
;
4359 ++windows_or_buffers_changed
;
4362 if (!UNSPECIFIEDP (value
)
4363 && NILP (Fequal (old_value
, value
)))
4369 if (EQ (face
, Qdefault
))
4371 #ifdef HAVE_WINDOW_SYSTEM
4372 /* Changed font-related attributes of the `default' face are
4373 reflected in changed `font' frame parameters. */
4375 && (font_related_attr_p
|| font_attr_p
)
4376 && lface_fully_specified_p (XVECTOR (lface
)->contents
))
4377 set_font_frame_param (frame
, lface
);
4379 #endif /* HAVE_WINDOW_SYSTEM */
4381 if (EQ (attr
, QCforeground
))
4382 param
= Qforeground_color
;
4383 else if (EQ (attr
, QCbackground
))
4384 param
= Qbackground_color
;
4386 #ifdef HAVE_WINDOW_SYSTEM
4388 else if (EQ (face
, Qscroll_bar
))
4390 /* Changing the colors of `scroll-bar' sets frame parameters
4391 `scroll-bar-foreground' and `scroll-bar-background'. */
4392 if (EQ (attr
, QCforeground
))
4393 param
= Qscroll_bar_foreground
;
4394 else if (EQ (attr
, QCbackground
))
4395 param
= Qscroll_bar_background
;
4397 #endif /* not WINDOWSNT */
4398 else if (EQ (face
, Qborder
))
4400 /* Changing background color of `border' sets frame parameter
4402 if (EQ (attr
, QCbackground
))
4403 param
= Qborder_color
;
4405 else if (EQ (face
, Qcursor
))
4407 /* Changing background color of `cursor' sets frame parameter
4409 if (EQ (attr
, QCbackground
))
4410 param
= Qcursor_color
;
4412 else if (EQ (face
, Qmouse
))
4414 /* Changing background color of `mouse' sets frame parameter
4416 if (EQ (attr
, QCbackground
))
4417 param
= Qmouse_color
;
4419 #endif /* HAVE_WINDOW_SYSTEM */
4420 else if (EQ (face
, Qmenu
))
4422 /* Indicate that we have to update the menu bar when
4423 realizing faces on FRAME. FRAME t change the
4424 default for new frames. We do this by setting
4425 setting the flag in new face caches */
4428 struct frame
*f
= XFRAME (frame
);
4429 if (FRAME_FACE_CACHE (f
) == NULL
)
4430 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
4431 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 1;
4434 menu_face_changed_default
= 1;
4440 /* Update `default-frame-alist', which is used for new frames. */
4442 store_in_alist (&Vdefault_frame_alist
, param
, value
);
4445 /* Update the current frame's parameters. */
4448 cons
= XCAR (Vparam_value_alist
);
4449 XSETCAR (cons
, param
);
4450 XSETCDR (cons
, value
);
4451 Fmodify_frame_parameters (frame
, Vparam_value_alist
);
4460 #ifdef HAVE_WINDOW_SYSTEM
4462 /* Set the `font' frame parameter of FRAME determined from `default'
4463 face attributes LFACE. If a face or fontset name is explicitely
4464 specfied in LFACE, use it as is. Otherwise, determine a font name
4465 from the other font-related atrributes of LFACE. In that case, if
4466 there's no matching font, signals an error. */
4469 set_font_frame_param (frame
, lface
)
4470 Lisp_Object frame
, lface
;
4472 struct frame
*f
= XFRAME (frame
);
4474 if (FRAME_WINDOW_P (f
))
4476 Lisp_Object font_name
;
4479 if (STRINGP (LFACE_FONT (lface
)))
4480 font_name
= LFACE_FONT (lface
);
4483 /* Choose a font name that reflects LFACE's attributes and has
4484 the registry and encoding pattern specified in the default
4485 fontset (3rd arg: -1) for ASCII characters (4th arg: 0). */
4486 font
= choose_face_font (f
, XVECTOR (lface
)->contents
, -1, 0, 0);
4488 error ("No font matches the specified attribute");
4489 font_name
= build_string (font
);
4493 f
->default_face_done_p
= 0;
4494 Fmodify_frame_parameters (frame
, Fcons (Fcons (Qfont
, font_name
), Qnil
));
4499 /* Update the corresponding face when frame parameter PARAM on frame F
4500 has been assigned the value NEW_VALUE. */
4503 update_face_from_frame_parameter (f
, param
, new_value
)
4505 Lisp_Object param
, new_value
;
4507 Lisp_Object face
= Qnil
;
4510 /* If there are no faces yet, give up. This is the case when called
4511 from Fx_create_frame, and we do the necessary things later in
4512 face-set-after-frame-defaults. */
4513 if (NILP (f
->face_alist
))
4516 if (EQ (param
, Qforeground_color
))
4519 lface
= lface_from_face_name (f
, face
, 1);
4520 LFACE_FOREGROUND (lface
) = (STRINGP (new_value
)
4521 ? new_value
: Qunspecified
);
4522 realize_basic_faces (f
);
4524 else if (EQ (param
, Qbackground_color
))
4528 /* Changing the background color might change the background
4529 mode, so that we have to load new defface specs. Call
4530 frame-update-face-colors to do that. */
4531 XSETFRAME (frame
, f
);
4532 call1 (Qframe_update_face_colors
, frame
);
4535 lface
= lface_from_face_name (f
, face
, 1);
4536 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4537 ? new_value
: Qunspecified
);
4538 realize_basic_faces (f
);
4540 else if (EQ (param
, Qborder_color
))
4543 lface
= lface_from_face_name (f
, face
, 1);
4544 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4545 ? new_value
: Qunspecified
);
4547 else if (EQ (param
, Qcursor_color
))
4550 lface
= lface_from_face_name (f
, face
, 1);
4551 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4552 ? new_value
: Qunspecified
);
4554 else if (EQ (param
, Qmouse_color
))
4557 lface
= lface_from_face_name (f
, face
, 1);
4558 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4559 ? new_value
: Qunspecified
);
4562 /* Changing a named face means that all realized faces depending on
4563 that face are invalid. Since we cannot tell which realized faces
4564 depend on the face, make sure they are all removed. This is done
4565 by incrementing face_change_count. The next call to
4566 init_iterator will then free realized faces. */
4568 && NILP (Fget (face
, Qface_no_inherit
)))
4570 ++face_change_count
;
4571 ++windows_or_buffers_changed
;
4576 /* Get the value of X resource RESOURCE, class CLASS for the display
4577 of frame FRAME. This is here because ordinary `x-get-resource'
4578 doesn't take a frame argument. */
4580 DEFUN ("internal-face-x-get-resource", Finternal_face_x_get_resource
,
4581 Sinternal_face_x_get_resource
, 3, 3, 0, doc
: /* */)
4582 (resource
, class, frame
)
4583 Lisp_Object resource
, class, frame
;
4585 Lisp_Object value
= Qnil
;
4586 CHECK_STRING (resource
);
4587 CHECK_STRING (class);
4588 CHECK_LIVE_FRAME (frame
);
4590 value
= display_x_get_resource (FRAME_X_DISPLAY_INFO (XFRAME (frame
)),
4591 resource
, class, Qnil
, Qnil
);
4597 /* Return resource string VALUE as a boolean value, i.e. nil, or t.
4598 If VALUE is "on" or "true", return t. If VALUE is "off" or
4599 "false", return nil. Otherwise, if SIGNAL_P is non-zero, signal an
4600 error; if SIGNAL_P is zero, return 0. */
4603 face_boolean_x_resource_value (value
, signal_p
)
4607 Lisp_Object result
= make_number (0);
4609 xassert (STRINGP (value
));
4611 if (xstricmp (SDATA (value
), "on") == 0
4612 || xstricmp (SDATA (value
), "true") == 0)
4614 else if (xstricmp (SDATA (value
), "off") == 0
4615 || xstricmp (SDATA (value
), "false") == 0)
4617 else if (xstricmp (SDATA (value
), "unspecified") == 0)
4618 result
= Qunspecified
;
4620 signal_error ("Invalid face attribute value from X resource", value
);
4626 DEFUN ("internal-set-lisp-face-attribute-from-resource",
4627 Finternal_set_lisp_face_attribute_from_resource
,
4628 Sinternal_set_lisp_face_attribute_from_resource
,
4629 3, 4, 0, doc
: /* */)
4630 (face
, attr
, value
, frame
)
4631 Lisp_Object face
, attr
, value
, frame
;
4633 CHECK_SYMBOL (face
);
4634 CHECK_SYMBOL (attr
);
4635 CHECK_STRING (value
);
4637 if (xstricmp (SDATA (value
), "unspecified") == 0)
4638 value
= Qunspecified
;
4639 else if (EQ (attr
, QCheight
))
4641 value
= Fstring_to_number (value
, make_number (10));
4642 if (XINT (value
) <= 0)
4643 signal_error ("Invalid face height from X resource", value
);
4645 else if (EQ (attr
, QCbold
) || EQ (attr
, QCitalic
))
4646 value
= face_boolean_x_resource_value (value
, 1);
4647 else if (EQ (attr
, QCweight
) || EQ (attr
, QCslant
) || EQ (attr
, QCwidth
))
4648 value
= intern (SDATA (value
));
4649 else if (EQ (attr
, QCreverse_video
) || EQ (attr
, QCinverse_video
))
4650 value
= face_boolean_x_resource_value (value
, 1);
4651 else if (EQ (attr
, QCunderline
)
4652 || EQ (attr
, QCoverline
)
4653 || EQ (attr
, QCstrike_through
))
4655 Lisp_Object boolean_value
;
4657 /* If the result of face_boolean_x_resource_value is t or nil,
4658 VALUE does NOT specify a color. */
4659 boolean_value
= face_boolean_x_resource_value (value
, 0);
4660 if (SYMBOLP (boolean_value
))
4661 value
= boolean_value
;
4663 else if (EQ (attr
, QCbox
))
4664 value
= Fcar (Fread_from_string (value
, Qnil
, Qnil
));
4666 return Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
4669 #endif /* HAVE_WINDOW_SYSTEM */
4672 /***********************************************************************
4674 ***********************************************************************/
4676 #if defined HAVE_X_WINDOWS && defined USE_X_TOOLKIT
4678 /* Make menus on frame F appear as specified by the `menu' face. */
4681 x_update_menu_appearance (f
)
4684 struct x_display_info
*dpyinfo
= FRAME_X_DISPLAY_INFO (f
);
4688 && (rdb
= XrmGetDatabase (FRAME_X_DISPLAY (f
)),
4692 Lisp_Object lface
= lface_from_face_name (f
, Qmenu
, 1);
4693 struct face
*face
= FACE_FROM_ID (f
, MENU_FACE_ID
);
4694 const char *myname
= SDATA (Vx_resource_name
);
4697 const char *popup_path
= "popup_menu";
4699 const char *popup_path
= "menu.popup";
4702 if (STRINGP (LFACE_FOREGROUND (lface
)))
4704 sprintf (line
, "%s.%s*foreground: %s",
4706 SDATA (LFACE_FOREGROUND (lface
)));
4707 XrmPutLineResource (&rdb
, line
);
4708 sprintf (line
, "%s.pane.menubar*foreground: %s",
4709 myname
, SDATA (LFACE_FOREGROUND (lface
)));
4710 XrmPutLineResource (&rdb
, line
);
4714 if (STRINGP (LFACE_BACKGROUND (lface
)))
4716 sprintf (line
, "%s.%s*background: %s",
4718 SDATA (LFACE_BACKGROUND (lface
)));
4719 XrmPutLineResource (&rdb
, line
);
4720 sprintf (line
, "%s.pane.menubar*background: %s",
4721 myname
, SDATA (LFACE_BACKGROUND (lface
)));
4722 XrmPutLineResource (&rdb
, line
);
4727 && (!UNSPECIFIEDP (LFACE_FAMILY (lface
))
4728 || !UNSPECIFIEDP (LFACE_SWIDTH (lface
))
4729 || !UNSPECIFIEDP (LFACE_AVGWIDTH (lface
))
4730 || !UNSPECIFIEDP (LFACE_WEIGHT (lface
))
4731 || !UNSPECIFIEDP (LFACE_SLANT (lface
))
4732 || !UNSPECIFIEDP (LFACE_HEIGHT (lface
))))
4735 const char *suffix
= "List";
4738 const char *suffix
= "";
4741 #if defined HAVE_X_I18N
4742 extern char *xic_create_fontsetname
4743 P_ ((char *base_fontname
, Bool motif
));
4744 char *fontsetname
= xic_create_fontsetname (face
->font_name
, motif
);
4746 char *fontsetname
= face
->font_name
;
4748 sprintf (line
, "%s.pane.menubar*font%s: %s",
4749 myname
, suffix
, fontsetname
);
4750 XrmPutLineResource (&rdb
, line
);
4751 sprintf (line
, "%s.%s*font%s: %s",
4752 myname
, popup_path
, suffix
, fontsetname
);
4753 XrmPutLineResource (&rdb
, line
);
4755 if (fontsetname
!= face
->font_name
)
4756 xfree (fontsetname
);
4759 if (changed_p
&& f
->output_data
.x
->menubar_widget
)
4760 free_frame_menubar (f
);
4764 #endif /* HAVE_X_WINDOWS && USE_X_TOOLKIT */
4767 DEFUN ("face-attribute-relative-p", Fface_attribute_relative_p
,
4768 Sface_attribute_relative_p
,
4770 doc
: /* Return non-nil if face ATTRIBUTE VALUE is relative. */)
4772 Lisp_Object attribute
, value
;
4774 if (EQ (value
, Qunspecified
))
4776 else if (EQ (attribute
, QCheight
))
4777 return INTEGERP (value
) ? Qnil
: Qt
;
4782 DEFUN ("merge-face-attribute", Fmerge_face_attribute
, Smerge_face_attribute
,
4784 doc
: /* Return face ATTRIBUTE VALUE1 merged with VALUE2.
4785 If VALUE1 or VALUE2 are absolute (see `face-attribute-relative-p'), then
4786 the result will be absolute, otherwise it will be relative. */)
4787 (attribute
, value1
, value2
)
4788 Lisp_Object attribute
, value1
, value2
;
4790 if (EQ (value1
, Qunspecified
))
4792 else if (EQ (attribute
, QCheight
))
4793 return merge_face_heights (value1
, value2
, value1
);
4799 DEFUN ("internal-get-lisp-face-attribute", Finternal_get_lisp_face_attribute
,
4800 Sinternal_get_lisp_face_attribute
,
4802 doc
: /* Return face attribute KEYWORD of face SYMBOL.
4803 If SYMBOL does not name a valid Lisp face or KEYWORD isn't a valid
4804 face attribute name, signal an error.
4805 If the optional argument FRAME is given, report on face SYMBOL in that
4806 frame. If FRAME is t, report on the defaults for face SYMBOL (for new
4807 frames). If FRAME is omitted or nil, use the selected frame. */)
4808 (symbol
, keyword
, frame
)
4809 Lisp_Object symbol
, keyword
, frame
;
4811 Lisp_Object lface
, value
= Qnil
;
4813 CHECK_SYMBOL (symbol
);
4814 CHECK_SYMBOL (keyword
);
4817 lface
= lface_from_face_name (NULL
, symbol
, 1);
4821 frame
= selected_frame
;
4822 CHECK_LIVE_FRAME (frame
);
4823 lface
= lface_from_face_name (XFRAME (frame
), symbol
, 1);
4826 if (EQ (keyword
, QCfamily
))
4827 value
= LFACE_FAMILY (lface
);
4828 else if (EQ (keyword
, QCheight
))
4829 value
= LFACE_HEIGHT (lface
);
4830 else if (EQ (keyword
, QCweight
))
4831 value
= LFACE_WEIGHT (lface
);
4832 else if (EQ (keyword
, QCslant
))
4833 value
= LFACE_SLANT (lface
);
4834 else if (EQ (keyword
, QCunderline
))
4835 value
= LFACE_UNDERLINE (lface
);
4836 else if (EQ (keyword
, QCoverline
))
4837 value
= LFACE_OVERLINE (lface
);
4838 else if (EQ (keyword
, QCstrike_through
))
4839 value
= LFACE_STRIKE_THROUGH (lface
);
4840 else if (EQ (keyword
, QCbox
))
4841 value
= LFACE_BOX (lface
);
4842 else if (EQ (keyword
, QCinverse_video
)
4843 || EQ (keyword
, QCreverse_video
))
4844 value
= LFACE_INVERSE (lface
);
4845 else if (EQ (keyword
, QCforeground
))
4846 value
= LFACE_FOREGROUND (lface
);
4847 else if (EQ (keyword
, QCbackground
))
4848 value
= LFACE_BACKGROUND (lface
);
4849 else if (EQ (keyword
, QCstipple
))
4850 value
= LFACE_STIPPLE (lface
);
4851 else if (EQ (keyword
, QCwidth
))
4852 value
= LFACE_SWIDTH (lface
);
4853 else if (EQ (keyword
, QCinherit
))
4854 value
= LFACE_INHERIT (lface
);
4855 else if (EQ (keyword
, QCfont
))
4856 value
= LFACE_FONT (lface
);
4858 signal_error ("Invalid face attribute name", keyword
);
4864 DEFUN ("internal-lisp-face-attribute-values",
4865 Finternal_lisp_face_attribute_values
,
4866 Sinternal_lisp_face_attribute_values
, 1, 1, 0,
4867 doc
: /* Return a list of valid discrete values for face attribute ATTR.
4868 Value is nil if ATTR doesn't have a discrete set of valid values. */)
4872 Lisp_Object result
= Qnil
;
4874 CHECK_SYMBOL (attr
);
4876 if (EQ (attr
, QCweight
)
4877 || EQ (attr
, QCslant
)
4878 || EQ (attr
, QCwidth
))
4880 /* Extract permissible symbols from tables. */
4881 struct table_entry
*table
;
4884 if (EQ (attr
, QCweight
))
4885 table
= weight_table
, dim
= DIM (weight_table
);
4886 else if (EQ (attr
, QCslant
))
4887 table
= slant_table
, dim
= DIM (slant_table
);
4889 table
= swidth_table
, dim
= DIM (swidth_table
);
4891 for (i
= 0; i
< dim
; ++i
)
4893 Lisp_Object symbol
= *table
[i
].symbol
;
4894 Lisp_Object tail
= result
;
4897 && !EQ (XCAR (tail
), symbol
))
4901 result
= Fcons (symbol
, result
);
4904 else if (EQ (attr
, QCunderline
))
4905 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4906 else if (EQ (attr
, QCoverline
))
4907 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4908 else if (EQ (attr
, QCstrike_through
))
4909 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4910 else if (EQ (attr
, QCinverse_video
) || EQ (attr
, QCreverse_video
))
4911 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4917 DEFUN ("internal-merge-in-global-face", Finternal_merge_in_global_face
,
4918 Sinternal_merge_in_global_face
, 2, 2, 0,
4919 doc
: /* Add attributes from frame-default definition of FACE to FACE on FRAME.
4920 Default face attributes override any local face attributes. */)
4922 Lisp_Object face
, frame
;
4925 Lisp_Object global_lface
, local_lface
, *gvec
, *lvec
;
4927 CHECK_LIVE_FRAME (frame
);
4928 global_lface
= lface_from_face_name (NULL
, face
, 1);
4929 local_lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
4930 if (NILP (local_lface
))
4931 local_lface
= Finternal_make_lisp_face (face
, frame
);
4933 /* Make every specified global attribute override the local one.
4934 BEWARE!! This is only used from `face-set-after-frame-default' where
4935 the local frame is defined from default specs in `face-defface-spec'
4936 and those should be overridden by global settings. Hence the strange
4937 "global before local" priority. */
4938 lvec
= XVECTOR (local_lface
)->contents
;
4939 gvec
= XVECTOR (global_lface
)->contents
;
4940 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
4941 if (! UNSPECIFIEDP (gvec
[i
]))
4948 /* The following function is implemented for compatibility with 20.2.
4949 The function is used in x-resolve-fonts when it is asked to
4950 return fonts with the same size as the font of a face. This is
4951 done in fontset.el. */
4953 DEFUN ("face-font", Fface_font
, Sface_font
, 1, 2, 0,
4954 doc
: /* Return the font name of face FACE, or nil if it is unspecified.
4955 If the optional argument FRAME is given, report on face FACE in that frame.
4956 If FRAME is t, report on the defaults for face FACE (for new frames).
4957 The font default for a face is either nil, or a list
4958 of the form (bold), (italic) or (bold italic).
4959 If FRAME is omitted or nil, use the selected frame. */)
4961 Lisp_Object face
, frame
;
4965 Lisp_Object result
= Qnil
;
4966 Lisp_Object lface
= lface_from_face_name (NULL
, face
, 1);
4968 if (!UNSPECIFIEDP (LFACE_WEIGHT (lface
))
4969 && !EQ (LFACE_WEIGHT (lface
), Qnormal
))
4970 result
= Fcons (Qbold
, result
);
4972 if (!UNSPECIFIEDP (LFACE_SLANT (lface
))
4973 && !EQ (LFACE_SLANT (lface
), Qnormal
))
4974 result
= Fcons (Qitalic
, result
);
4980 struct frame
*f
= frame_or_selected_frame (frame
, 1);
4981 int face_id
= lookup_named_face (f
, face
, 0, 1);
4982 struct face
*face
= FACE_FROM_ID (f
, face_id
);
4983 return face
? build_string (face
->font_name
) : Qnil
;
4988 /* Compare face-attribute values v1 and v2 for equality. Value is non-zero if
4989 all attributes are `equal'. Tries to be fast because this function
4990 is called quite often. */
4993 face_attr_equal_p (v1
, v2
)
4996 /* Type can differ, e.g. when one attribute is unspecified, i.e. nil,
4997 and the other is specified. */
4998 if (XTYPE (v1
) != XTYPE (v2
))
5007 if (SBYTES (v1
) != SBYTES (v2
))
5010 return bcmp (SDATA (v1
), SDATA (v2
), SBYTES (v1
)) == 0;
5017 return !NILP (Fequal (v1
, v2
));
5022 /* Compare face vectors V1 and V2 for equality. Value is non-zero if
5023 all attributes are `equal'. Tries to be fast because this function
5024 is called quite often. */
5027 lface_equal_p (v1
, v2
)
5028 Lisp_Object
*v1
, *v2
;
5032 for (i
= 1; i
< LFACE_VECTOR_SIZE
&& equal_p
; ++i
)
5033 equal_p
= face_attr_equal_p (v1
[i
], v2
[i
]);
5039 DEFUN ("internal-lisp-face-equal-p", Finternal_lisp_face_equal_p
,
5040 Sinternal_lisp_face_equal_p
, 2, 3, 0,
5041 doc
: /* True if FACE1 and FACE2 are equal.
5042 If the optional argument FRAME is given, report on face FACE in that frame.
5043 If FRAME is t, report on the defaults for face FACE (for new frames).
5044 If FRAME is omitted or nil, use the selected frame. */)
5045 (face1
, face2
, frame
)
5046 Lisp_Object face1
, face2
, frame
;
5050 Lisp_Object lface1
, lface2
;
5055 /* Don't use check_x_frame here because this function is called
5056 before X frames exist. At that time, if FRAME is nil,
5057 selected_frame will be used which is the frame dumped with
5058 Emacs. That frame is not an X frame. */
5059 f
= frame_or_selected_frame (frame
, 2);
5061 lface1
= lface_from_face_name (NULL
, face1
, 1);
5062 lface2
= lface_from_face_name (NULL
, face2
, 1);
5063 equal_p
= lface_equal_p (XVECTOR (lface1
)->contents
,
5064 XVECTOR (lface2
)->contents
);
5065 return equal_p
? Qt
: Qnil
;
5069 DEFUN ("internal-lisp-face-empty-p", Finternal_lisp_face_empty_p
,
5070 Sinternal_lisp_face_empty_p
, 1, 2, 0,
5071 doc
: /* True if FACE has no attribute specified.
5072 If the optional argument FRAME is given, report on face FACE in that frame.
5073 If FRAME is t, report on the defaults for face FACE (for new frames).
5074 If FRAME is omitted or nil, use the selected frame. */)
5076 Lisp_Object face
, frame
;
5083 frame
= selected_frame
;
5084 CHECK_LIVE_FRAME (frame
);
5088 lface
= lface_from_face_name (NULL
, face
, 1);
5090 lface
= lface_from_face_name (f
, face
, 1);
5092 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
5093 if (!UNSPECIFIEDP (AREF (lface
, i
)))
5096 return i
== LFACE_VECTOR_SIZE
? Qt
: Qnil
;
5100 DEFUN ("frame-face-alist", Fframe_face_alist
, Sframe_face_alist
,
5102 doc
: /* Return an alist of frame-local faces defined on FRAME.
5103 For internal use only. */)
5107 struct frame
*f
= frame_or_selected_frame (frame
, 0);
5108 return f
->face_alist
;
5112 /* Return a hash code for Lisp string STRING with case ignored. Used
5113 below in computing a hash value for a Lisp face. */
5115 static INLINE
unsigned
5116 hash_string_case_insensitive (string
)
5119 const unsigned char *s
;
5121 xassert (STRINGP (string
));
5122 for (s
= SDATA (string
); *s
; ++s
)
5123 hash
= (hash
<< 1) ^ tolower (*s
);
5128 /* Return a hash code for face attribute vector V. */
5130 static INLINE
unsigned
5134 return (hash_string_case_insensitive (v
[LFACE_FAMILY_INDEX
])
5135 ^ hash_string_case_insensitive (v
[LFACE_FOREGROUND_INDEX
])
5136 ^ hash_string_case_insensitive (v
[LFACE_BACKGROUND_INDEX
])
5137 ^ XFASTINT (v
[LFACE_WEIGHT_INDEX
])
5138 ^ XFASTINT (v
[LFACE_SLANT_INDEX
])
5139 ^ XFASTINT (v
[LFACE_SWIDTH_INDEX
])
5140 ^ XFASTINT (v
[LFACE_HEIGHT_INDEX
]));
5144 /* Return non-zero if LFACE1 and LFACE2 specify the same font (without
5145 considering charsets/registries). They do if they specify the same
5146 family, point size, weight, width, slant, and fontset. Both LFACE1
5147 and LFACE2 must be fully-specified. */
5150 lface_same_font_attributes_p (lface1
, lface2
)
5151 Lisp_Object
*lface1
, *lface2
;
5153 xassert (lface_fully_specified_p (lface1
)
5154 && lface_fully_specified_p (lface2
));
5155 return (xstricmp (SDATA (lface1
[LFACE_FAMILY_INDEX
]),
5156 SDATA (lface2
[LFACE_FAMILY_INDEX
])) == 0
5157 && EQ (lface1
[LFACE_HEIGHT_INDEX
], lface2
[LFACE_HEIGHT_INDEX
])
5158 && EQ (lface1
[LFACE_SWIDTH_INDEX
], lface2
[LFACE_SWIDTH_INDEX
])
5159 && EQ (lface1
[LFACE_AVGWIDTH_INDEX
], lface2
[LFACE_AVGWIDTH_INDEX
])
5160 && EQ (lface1
[LFACE_WEIGHT_INDEX
], lface2
[LFACE_WEIGHT_INDEX
])
5161 && EQ (lface1
[LFACE_SLANT_INDEX
], lface2
[LFACE_SLANT_INDEX
])
5162 && (EQ (lface1
[LFACE_FONT_INDEX
], lface2
[LFACE_FONT_INDEX
])
5163 || (STRINGP (lface1
[LFACE_FONT_INDEX
])
5164 && STRINGP (lface2
[LFACE_FONT_INDEX
])
5165 && xstricmp (SDATA (lface1
[LFACE_FONT_INDEX
]),
5166 SDATA (lface2
[LFACE_FONT_INDEX
])))));
5171 /***********************************************************************
5173 ***********************************************************************/
5175 /* Allocate and return a new realized face for Lisp face attribute
5178 static struct face
*
5179 make_realized_face (attr
)
5182 struct face
*face
= (struct face
*) xmalloc (sizeof *face
);
5183 bzero (face
, sizeof *face
);
5184 face
->ascii_face
= face
;
5185 bcopy (attr
, face
->lface
, sizeof face
->lface
);
5190 /* Free realized face FACE, including its X resources. FACE may
5194 free_realized_face (f
, face
)
5200 #ifdef HAVE_WINDOW_SYSTEM
5201 if (FRAME_WINDOW_P (f
))
5203 /* Free fontset of FACE if it is ASCII face. */
5204 if (face
->fontset
>= 0 && face
== face
->ascii_face
)
5205 free_face_fontset (f
, face
);
5208 x_free_gc (f
, face
->gc
);
5212 free_face_colors (f
, face
);
5213 x_destroy_bitmap (f
, face
->stipple
);
5215 #endif /* HAVE_WINDOW_SYSTEM */
5222 /* Prepare face FACE for subsequent display on frame F. This
5223 allocated GCs if they haven't been allocated yet or have been freed
5224 by clearing the face cache. */
5227 prepare_face_for_display (f
, face
)
5231 #ifdef HAVE_WINDOW_SYSTEM
5232 xassert (FRAME_WINDOW_P (f
));
5237 unsigned long mask
= GCForeground
| GCBackground
| GCGraphicsExposures
;
5239 xgcv
.foreground
= face
->foreground
;
5240 xgcv
.background
= face
->background
;
5241 #ifdef HAVE_X_WINDOWS
5242 xgcv
.graphics_exposures
= False
;
5244 /* The font of FACE may be null if we couldn't load it. */
5247 #ifdef HAVE_X_WINDOWS
5248 xgcv
.font
= face
->font
->fid
;
5251 xgcv
.font
= face
->font
;
5254 xgcv
.font
= face
->font
;
5260 #ifdef HAVE_X_WINDOWS
5263 xgcv
.fill_style
= FillOpaqueStippled
;
5264 xgcv
.stipple
= x_bitmap_pixmap (f
, face
->stipple
);
5265 mask
|= GCFillStyle
| GCStipple
;
5268 face
->gc
= x_create_gc (f
, mask
, &xgcv
);
5271 #endif /* HAVE_WINDOW_SYSTEM */
5275 /* Returns the `distance' between the colors X and Y. */
5278 color_distance (x
, y
)
5281 /* This formula is from a paper title `Colour metric' by Thiadmer Riemersma.
5282 Quoting from that paper:
5284 This formula has results that are very close to L*u*v* (with the
5285 modified lightness curve) and, more importantly, it is a more even
5286 algorithm: it does not have a range of colours where it suddenly
5287 gives far from optimal results.
5289 See <http://www.compuphase.com/cmetric.htm> for more info. */
5291 long r
= (x
->red
- y
->red
) >> 8;
5292 long g
= (x
->green
- y
->green
) >> 8;
5293 long b
= (x
->blue
- y
->blue
) >> 8;
5294 long r_mean
= (x
->red
+ y
->red
) >> 9;
5297 (((512 + r_mean
) * r
* r
) >> 8)
5299 + (((767 - r_mean
) * b
* b
) >> 8);
5303 DEFUN ("color-distance", Fcolor_distance
, Scolor_distance
, 2, 3, 0,
5304 doc
: /* Return an integer distance between COLOR1 and COLOR2 on FRAME.
5305 COLOR1 and COLOR2 may be either strings containing the color name,
5306 or lists of the form (RED GREEN BLUE).
5307 If FRAME is unspecified or nil, the current frame is used. */)
5308 (color1
, color2
, frame
)
5309 Lisp_Object color1
, color2
, frame
;
5312 XColor cdef1
, cdef2
;
5315 frame
= selected_frame
;
5316 CHECK_LIVE_FRAME (frame
);
5319 if ((CONSP (color1
) && !parse_rgb_list (color1
, &cdef1
))
5320 || !STRINGP (color1
)
5321 || !defined_color (f
, SDATA (color1
), &cdef1
, 0))
5322 signal_error ("Invalid color", color1
);
5323 if ((CONSP (color2
) && !parse_rgb_list (color2
, &cdef2
))
5324 || !STRINGP (color2
)
5325 || !defined_color (f
, SDATA (color2
), &cdef2
, 0))
5326 signal_error ("Invalid color", color2
);
5328 return make_number (color_distance (&cdef1
, &cdef2
));
5332 /***********************************************************************
5334 ***********************************************************************/
5336 /* Return a new face cache for frame F. */
5338 static struct face_cache
*
5342 struct face_cache
*c
;
5345 c
= (struct face_cache
*) xmalloc (sizeof *c
);
5346 bzero (c
, sizeof *c
);
5347 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5348 c
->buckets
= (struct face
**) xmalloc (size
);
5349 bzero (c
->buckets
, size
);
5351 c
->faces_by_id
= (struct face
**) xmalloc (c
->size
* sizeof *c
->faces_by_id
);
5353 c
->menu_face_changed_p
= menu_face_changed_default
;
5358 /* Clear out all graphics contexts for all realized faces, except for
5359 the basic faces. This should be done from time to time just to avoid
5360 keeping too many graphics contexts that are no longer needed. */
5364 struct face_cache
*c
;
5366 if (c
&& FRAME_WINDOW_P (c
->f
))
5368 #ifdef HAVE_WINDOW_SYSTEM
5370 for (i
= BASIC_FACE_ID_SENTINEL
; i
< c
->used
; ++i
)
5372 struct face
*face
= c
->faces_by_id
[i
];
5373 if (face
&& face
->gc
)
5375 x_free_gc (c
->f
, face
->gc
);
5379 #endif /* HAVE_WINDOW_SYSTEM */
5384 /* Free all realized faces in face cache C, including basic faces.
5385 C may be null. If faces are freed, make sure the frame's current
5386 matrix is marked invalid, so that a display caused by an expose
5387 event doesn't try to use faces we destroyed. */
5390 free_realized_faces (c
)
5391 struct face_cache
*c
;
5396 struct frame
*f
= c
->f
;
5398 /* We must block input here because we can't process X events
5399 safely while only some faces are freed, or when the frame's
5400 current matrix still references freed faces. */
5403 for (i
= 0; i
< c
->used
; ++i
)
5405 free_realized_face (f
, c
->faces_by_id
[i
]);
5406 c
->faces_by_id
[i
] = NULL
;
5410 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5411 bzero (c
->buckets
, size
);
5413 /* Must do a thorough redisplay the next time. Mark current
5414 matrices as invalid because they will reference faces freed
5415 above. This function is also called when a frame is
5416 destroyed. In this case, the root window of F is nil. */
5417 if (WINDOWP (f
->root_window
))
5419 clear_current_matrices (f
);
5420 ++windows_or_buffers_changed
;
5428 /* Free all faces realized for multibyte characters on frame F that
5432 free_realized_multibyte_face (f
, fontset
)
5436 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5440 /* We must block input here because we can't process X events safely
5441 while only some faces are freed, or when the frame's current
5442 matrix still references freed faces. */
5445 for (i
= 0; i
< cache
->used
; i
++)
5447 face
= cache
->faces_by_id
[i
];
5449 && face
!= face
->ascii_face
5450 && face
->fontset
== fontset
)
5452 uncache_face (cache
, face
);
5453 free_realized_face (f
, face
);
5457 /* Must do a thorough redisplay the next time. Mark current
5458 matrices as invalid because they will reference faces freed
5459 above. This function is also called when a frame is destroyed.
5460 In this case, the root window of F is nil. */
5461 if (WINDOWP (f
->root_window
))
5463 clear_current_matrices (f
);
5464 ++windows_or_buffers_changed
;
5471 /* Free all realized faces on FRAME or on all frames if FRAME is nil.
5472 This is done after attributes of a named face have been changed,
5473 because we can't tell which realized faces depend on that face. */
5476 free_all_realized_faces (frame
)
5482 FOR_EACH_FRAME (rest
, frame
)
5483 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5486 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5490 /* Free face cache C and faces in it, including their X resources. */
5494 struct face_cache
*c
;
5498 free_realized_faces (c
);
5500 xfree (c
->faces_by_id
);
5506 /* Cache realized face FACE in face cache C. HASH is the hash value
5507 of FACE. If FACE->fontset >= 0, add the new face to the end of the
5508 collision list of the face hash table of C. This is done because
5509 otherwise lookup_face would find FACE for every character, even if
5510 faces with the same attributes but for specific characters exist. */
5513 cache_face (c
, face
, hash
)
5514 struct face_cache
*c
;
5518 int i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5522 if (face
->fontset
>= 0)
5524 struct face
*last
= c
->buckets
[i
];
5535 c
->buckets
[i
] = face
;
5536 face
->prev
= face
->next
= NULL
;
5542 face
->next
= c
->buckets
[i
];
5544 face
->next
->prev
= face
;
5545 c
->buckets
[i
] = face
;
5548 /* Find a free slot in C->faces_by_id and use the index of the free
5549 slot as FACE->id. */
5550 for (i
= 0; i
< c
->used
; ++i
)
5551 if (c
->faces_by_id
[i
] == NULL
)
5555 /* Maybe enlarge C->faces_by_id. */
5558 if (c
->used
== c
->size
)
5561 new_size
= min (2 * c
->size
, MAX_FACE_ID
);
5562 if (new_size
== c
->size
)
5563 abort (); /* Alternatives? ++kfs */
5564 sz
= new_size
* sizeof *c
->faces_by_id
;
5565 c
->faces_by_id
= (struct face
**) xrealloc (c
->faces_by_id
, sz
);
5572 /* Check that FACE got a unique id. */
5577 for (j
= n
= 0; j
< FACE_CACHE_BUCKETS_SIZE
; ++j
)
5578 for (face
= c
->buckets
[j
]; face
; face
= face
->next
)
5584 #endif /* GLYPH_DEBUG */
5586 c
->faces_by_id
[i
] = face
;
5590 /* Remove face FACE from cache C. */
5593 uncache_face (c
, face
)
5594 struct face_cache
*c
;
5597 int i
= face
->hash
% FACE_CACHE_BUCKETS_SIZE
;
5600 face
->prev
->next
= face
->next
;
5602 c
->buckets
[i
] = face
->next
;
5605 face
->next
->prev
= face
->prev
;
5607 c
->faces_by_id
[face
->id
] = NULL
;
5608 if (face
->id
== c
->used
)
5613 /* Look up a realized face with face attributes ATTR in the face cache
5614 of frame F. The face will be used to display character C. Value
5615 is the ID of the face found. If no suitable face is found, realize
5616 a new one. In that case, if C is a multibyte character, BASE_FACE
5617 is a face that has the same attributes. */
5620 lookup_face (f
, attr
, c
, base_face
)
5624 struct face
*base_face
;
5626 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5631 xassert (cache
!= NULL
);
5632 check_lface_attrs (attr
);
5634 /* Look up ATTR in the face cache. */
5635 hash
= lface_hash (attr
);
5636 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5638 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
5639 if (face
->hash
== hash
5640 && (!FRAME_WINDOW_P (f
)
5641 || FACE_SUITABLE_FOR_CHAR_P (face
, c
))
5642 && lface_equal_p (face
->lface
, attr
))
5645 /* If not found, realize a new face. */
5647 face
= realize_face (cache
, attr
, c
, base_face
, -1);
5650 xassert (face
== FACE_FROM_ID (f
, face
->id
));
5652 /* When this function is called from face_for_char (in this case, C is
5653 a multibyte character), a fontset of a face returned by
5654 realize_face is not yet set, i.e. FACE_SUITABLE_FOR_CHAR_P (FACE,
5655 C) is not sutisfied. The fontset is set for this face by
5656 face_for_char later. */
5658 if (FRAME_WINDOW_P (f
))
5659 xassert (FACE_SUITABLE_FOR_CHAR_P (face
, c
));
5661 #endif /* GLYPH_DEBUG */
5667 /* Return the face id of the realized face for named face SYMBOL on
5668 frame F suitable for displaying character C. Value is -1 if the
5669 face couldn't be determined, which might happen if the default face
5670 isn't realized and cannot be realized. */
5673 lookup_named_face (f
, symbol
, c
, signal_p
)
5679 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5680 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5681 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5683 if (default_face
== NULL
)
5685 if (!realize_basic_faces (f
))
5687 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5690 if (!get_lface_attributes (f
, symbol
, symbol_attrs
, signal_p
))
5693 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
5694 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
5696 return lookup_face (f
, attrs
, c
, NULL
);
5700 /* Return the ID of the realized ASCII face of Lisp face with ID
5701 LFACE_ID on frame F. Value is -1 if LFACE_ID isn't valid. */
5704 ascii_face_of_lisp_face (f
, lface_id
)
5710 if (lface_id
>= 0 && lface_id
< lface_id_to_name_size
)
5712 Lisp_Object face_name
= lface_id_to_name
[lface_id
];
5713 face_id
= lookup_named_face (f
, face_name
, 0, 1);
5722 /* Return a face for charset ASCII that is like the face with id
5723 FACE_ID on frame F, but has a font that is STEPS steps smaller.
5724 STEPS < 0 means larger. Value is the id of the face. */
5727 smaller_face (f
, face_id
, steps
)
5731 #ifdef HAVE_WINDOW_SYSTEM
5733 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5734 int pt
, last_pt
, last_height
;
5737 struct face
*new_face
;
5739 /* If not called for an X frame, just return the original face. */
5740 if (FRAME_TERMCAP_P (f
))
5743 /* Try in increments of 1/2 pt. */
5744 delta
= steps
< 0 ? 5 : -5;
5745 steps
= abs (steps
);
5747 face
= FACE_FROM_ID (f
, face_id
);
5748 bcopy (face
->lface
, attrs
, sizeof attrs
);
5749 pt
= last_pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
5750 new_face_id
= face_id
;
5751 last_height
= FONT_HEIGHT (face
->font
);
5755 /* Give up if we cannot find a font within 10pt. */
5756 && abs (last_pt
- pt
) < 100)
5758 /* Look up a face for a slightly smaller/larger font. */
5760 attrs
[LFACE_HEIGHT_INDEX
] = make_number (pt
);
5761 new_face_id
= lookup_face (f
, attrs
, 0, NULL
);
5762 new_face
= FACE_FROM_ID (f
, new_face_id
);
5764 /* If height changes, count that as one step. */
5765 if ((delta
< 0 && FONT_HEIGHT (new_face
->font
) < last_height
)
5766 || (delta
> 0 && FONT_HEIGHT (new_face
->font
) > last_height
))
5769 last_height
= FONT_HEIGHT (new_face
->font
);
5776 #else /* not HAVE_WINDOW_SYSTEM */
5780 #endif /* not HAVE_WINDOW_SYSTEM */
5784 /* Return a face for charset ASCII that is like the face with id
5785 FACE_ID on frame F, but has height HEIGHT. */
5788 face_with_height (f
, face_id
, height
)
5793 #ifdef HAVE_WINDOW_SYSTEM
5795 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5797 if (FRAME_TERMCAP_P (f
)
5801 face
= FACE_FROM_ID (f
, face_id
);
5802 bcopy (face
->lface
, attrs
, sizeof attrs
);
5803 attrs
[LFACE_HEIGHT_INDEX
] = make_number (height
);
5804 face_id
= lookup_face (f
, attrs
, 0, NULL
);
5805 #endif /* HAVE_WINDOW_SYSTEM */
5811 /* Return the face id of the realized face for named face SYMBOL on
5812 frame F suitable for displaying character C, and use attributes of
5813 the face FACE_ID for attributes that aren't completely specified by
5814 SYMBOL. This is like lookup_named_face, except that the default
5815 attributes come from FACE_ID, not from the default face. FACE_ID
5816 is assumed to be already realized. */
5819 lookup_derived_face (f
, symbol
, c
, face_id
, signal_p
)
5825 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5826 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5827 struct face
*default_face
= FACE_FROM_ID (f
, face_id
);
5832 get_lface_attributes (f
, symbol
, symbol_attrs
, signal_p
);
5833 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
5834 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
5835 return lookup_face (f
, attrs
, c
, default_face
);
5838 DEFUN ("face-attributes-as-vector", Fface_attributes_as_vector
,
5839 Sface_attributes_as_vector
, 1, 1, 0,
5840 doc
: /* Return a vector of face attributes corresponding to PLIST. */)
5845 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
5847 merge_face_ref (XFRAME (selected_frame
), plist
, XVECTOR (lface
)->contents
,
5854 /***********************************************************************
5855 Face capability testing
5856 ***********************************************************************/
5859 /* If the distance (as returned by color_distance) between two colors is
5860 less than this, then they are considered the same, for determining
5861 whether a color is supported or not. The range of values is 0-65535. */
5863 #define TTY_SAME_COLOR_THRESHOLD 10000
5865 #ifdef HAVE_WINDOW_SYSTEM
5867 /* Return non-zero if all the face attributes in ATTRS are supported
5868 on the window-system frame F.
5870 The definition of `supported' is somewhat heuristic, but basically means
5871 that a face containing all the attributes in ATTRS, when merged with the
5872 default face for display, can be represented in a way that's
5874 \(1) different in appearance than the default face, and
5875 \(2) `close in spirit' to what the attributes specify, if not exact. */
5878 x_supports_face_attributes_p (f
, attrs
, def_face
)
5881 struct face
*def_face
;
5883 Lisp_Object
*def_attrs
= def_face
->lface
;
5885 /* Check that other specified attributes are different that the default
5887 if ((!UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
5888 && face_attr_equal_p (attrs
[LFACE_UNDERLINE_INDEX
],
5889 def_attrs
[LFACE_UNDERLINE_INDEX
]))
5890 || (!UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
5891 && face_attr_equal_p (attrs
[LFACE_INVERSE_INDEX
],
5892 def_attrs
[LFACE_INVERSE_INDEX
]))
5893 || (!UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
5894 && face_attr_equal_p (attrs
[LFACE_FOREGROUND_INDEX
],
5895 def_attrs
[LFACE_FOREGROUND_INDEX
]))
5896 || (!UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
5897 && face_attr_equal_p (attrs
[LFACE_BACKGROUND_INDEX
],
5898 def_attrs
[LFACE_BACKGROUND_INDEX
]))
5899 || (!UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
5900 && face_attr_equal_p (attrs
[LFACE_STIPPLE_INDEX
],
5901 def_attrs
[LFACE_STIPPLE_INDEX
]))
5902 || (!UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
5903 && face_attr_equal_p (attrs
[LFACE_OVERLINE_INDEX
],
5904 def_attrs
[LFACE_OVERLINE_INDEX
]))
5905 || (!UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
5906 && face_attr_equal_p (attrs
[LFACE_STRIKE_THROUGH_INDEX
],
5907 def_attrs
[LFACE_STRIKE_THROUGH_INDEX
]))
5908 || (!UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
5909 && face_attr_equal_p (attrs
[LFACE_BOX_INDEX
],
5910 def_attrs
[LFACE_BOX_INDEX
])))
5913 /* Check font-related attributes, as those are the most commonly
5914 "unsupported" on a window-system (because of missing fonts). */
5915 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
5916 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
5917 || !UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
5918 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
5919 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
5920 || !UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
]))
5923 Lisp_Object merged_attrs
[LFACE_VECTOR_SIZE
];
5925 bcopy (def_attrs
, merged_attrs
, sizeof merged_attrs
);
5927 merge_face_vectors (f
, attrs
, merged_attrs
, 0);
5929 face
= FACE_FROM_ID (f
, lookup_face (f
, merged_attrs
, 0, 0));
5932 error ("cannot make face");
5934 /* If the font is the same, then not supported. */
5935 if (face
->font
== def_face
->font
)
5939 /* Everything checks out, this face is supported. */
5943 #endif /* HAVE_WINDOW_SYSTEM */
5945 /* Return non-zero if all the face attributes in ATTRS are supported
5948 The definition of `supported' is somewhat heuristic, but basically means
5949 that a face containing all the attributes in ATTRS, when merged
5950 with the default face for display, can be represented in a way that's
5952 \(1) different in appearance than the default face, and
5953 \(2) `close in spirit' to what the attributes specify, if not exact.
5955 Point (2) implies that a `:weight black' attribute will be satisfied
5956 by any terminal that can display bold, and a `:foreground "yellow"' as
5957 long as the terminal can display a yellowish color, but `:slant italic'
5958 will _not_ be satisfied by the tty display code's automatic
5959 substitution of a `dim' face for italic. */
5962 tty_supports_face_attributes_p (f
, attrs
, def_face
)
5965 struct face
*def_face
;
5968 Lisp_Object val
, fg
, bg
;
5969 XColor fg_tty_color
, fg_std_color
;
5970 XColor bg_tty_color
, bg_std_color
;
5971 unsigned test_caps
= 0;
5972 Lisp_Object
*def_attrs
= def_face
->lface
;
5975 /* First check some easy-to-check stuff; ttys support none of the
5976 following attributes, so we can just return false if any are requested
5977 (even if `nominal' values are specified, we should still return false,
5978 as that will be the same value that the default face uses). We
5979 consider :slant unsupportable on ttys, even though the face code
5980 actually `fakes' them using a dim attribute if possible. This is
5981 because the faked result is too different from what the face
5983 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
5984 || !UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
5985 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
5986 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
5987 || !UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
5988 || !UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
5989 || !UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
5990 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
]))
5994 /* Test for terminal `capabilities' (non-color character attributes). */
5996 /* font weight (bold/dim) */
5997 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
6000 int def_weight
= face_numeric_weight (def_attrs
[LFACE_WEIGHT_INDEX
]);
6002 if (weight
> XLFD_WEIGHT_MEDIUM
)
6004 if (def_weight
> XLFD_WEIGHT_MEDIUM
)
6005 return 0; /* same as default */
6006 test_caps
= TTY_CAP_BOLD
;
6008 else if (weight
< XLFD_WEIGHT_MEDIUM
)
6010 if (def_weight
< XLFD_WEIGHT_MEDIUM
)
6011 return 0; /* same as default */
6012 test_caps
= TTY_CAP_DIM
;
6014 else if (def_weight
== XLFD_WEIGHT_MEDIUM
)
6015 return 0; /* same as default */
6019 val
= attrs
[LFACE_UNDERLINE_INDEX
];
6020 if (!UNSPECIFIEDP (val
))
6023 return 0; /* ttys can't use colored underlines */
6024 else if (face_attr_equal_p (val
, def_attrs
[LFACE_UNDERLINE_INDEX
]))
6025 return 0; /* same as default */
6027 test_caps
|= TTY_CAP_UNDERLINE
;
6031 val
= attrs
[LFACE_INVERSE_INDEX
];
6032 if (!UNSPECIFIEDP (val
))
6034 if (face_attr_equal_p (val
, def_attrs
[LFACE_UNDERLINE_INDEX
]))
6035 return 0; /* same as default */
6037 test_caps
|= TTY_CAP_INVERSE
;
6041 /* Color testing. */
6043 /* Default the color indices in FG_TTY_COLOR and BG_TTY_COLOR, since
6044 we use them when calling `tty_capable_p' below, even if the face
6045 specifies no colors. */
6046 fg_tty_color
.pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
6047 bg_tty_color
.pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
6049 /* Check if foreground color is close enough. */
6050 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
6053 Lisp_Object def_fg
= def_attrs
[LFACE_FOREGROUND_INDEX
];
6055 if (face_attr_equal_p (fg
, def_fg
))
6056 return 0; /* same as default */
6057 else if (! tty_lookup_color (f
, fg
, &fg_tty_color
, &fg_std_color
))
6058 return 0; /* not a valid color */
6059 else if (color_distance (&fg_tty_color
, &fg_std_color
)
6060 > TTY_SAME_COLOR_THRESHOLD
)
6061 return 0; /* displayed color is too different */
6063 /* Make sure the color is really different than the default. */
6065 XColor def_fg_color
;
6066 if (tty_lookup_color (f
, def_fg
, &def_fg_color
, 0)
6067 && (color_distance (&fg_tty_color
, &def_fg_color
)
6068 <= TTY_SAME_COLOR_THRESHOLD
))
6073 /* Check if background color is close enough. */
6074 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
6077 Lisp_Object def_bg
= def_attrs
[LFACE_FOREGROUND_INDEX
];
6079 if (face_attr_equal_p (bg
, def_bg
))
6080 return 0; /* same as default */
6081 else if (! tty_lookup_color (f
, bg
, &bg_tty_color
, &bg_std_color
))
6082 return 0; /* not a valid color */
6083 else if (color_distance (&bg_tty_color
, &bg_std_color
)
6084 > TTY_SAME_COLOR_THRESHOLD
)
6085 return 0; /* displayed color is too different */
6087 /* Make sure the color is really different than the default. */
6089 XColor def_bg_color
;
6090 if (tty_lookup_color (f
, def_bg
, &def_bg_color
, 0)
6091 && (color_distance (&bg_tty_color
, &def_bg_color
)
6092 <= TTY_SAME_COLOR_THRESHOLD
))
6097 /* If both foreground and background are requested, see if the
6098 distance between them is OK. We just check to see if the distance
6099 between the tty's foreground and background is close enough to the
6100 distance between the standard foreground and background. */
6101 if (STRINGP (fg
) && STRINGP (bg
))
6104 = (color_distance (&fg_std_color
, &bg_std_color
)
6105 - color_distance (&fg_tty_color
, &bg_tty_color
));
6106 if (delta_delta
> TTY_SAME_COLOR_THRESHOLD
6107 || delta_delta
< -TTY_SAME_COLOR_THRESHOLD
)
6112 /* See if the capabilities we selected above are supported, with the
6114 if (test_caps
!= 0 &&
6115 ! tty_capable_p (FRAME_TTY (f
), test_caps
, fg_tty_color
.pixel
, bg_tty_color
.pixel
))
6119 /* Hmmm, everything checks out, this terminal must support this face. */
6124 DEFUN ("display-supports-face-attributes-p",
6125 Fdisplay_supports_face_attributes_p
, Sdisplay_supports_face_attributes_p
,
6127 doc
: /* Return non-nil if all the face attributes in ATTRIBUTES are supported.
6128 The optional argument DISPLAY can be a display name, a frame, or
6129 nil (meaning the selected frame's display)
6131 The definition of `supported' is somewhat heuristic, but basically means
6132 that a face containing all the attributes in ATTRIBUTES, when merged
6133 with the default face for display, can be represented in a way that's
6135 \(1) different in appearance than the default face, and
6136 \(2) `close in spirit' to what the attributes specify, if not exact.
6138 Point (2) implies that a `:weight black' attribute will be satisfied by
6139 any display that can display bold, and a `:foreground \"yellow\"' as long
6140 as it can display a yellowish color, but `:slant italic' will _not_ be
6141 satisfied by the tty display code's automatic substitution of a `dim'
6142 face for italic. */)
6143 (attributes
, display
)
6144 Lisp_Object attributes
, display
;
6149 struct face
*def_face
;
6150 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6152 if (noninteractive
|| !initialized
)
6153 /* We may not be able to access low-level face information in batch
6154 mode, or before being dumped, and this function is not going to
6155 be very useful in those cases anyway, so just give up. */
6159 frame
= selected_frame
;
6160 else if (FRAMEP (display
))
6164 /* Find any frame on DISPLAY. */
6165 Lisp_Object fl_tail
;
6168 for (fl_tail
= Vframe_list
; CONSP (fl_tail
); fl_tail
= XCDR (fl_tail
))
6170 frame
= XCAR (fl_tail
);
6171 if (!NILP (Fequal (Fcdr (Fassq (Qdisplay
,
6172 XFRAME (frame
)->param_alist
)),
6178 CHECK_LIVE_FRAME (frame
);
6181 for (i
= 0; i
< LFACE_VECTOR_SIZE
; i
++)
6182 attrs
[i
] = Qunspecified
;
6183 merge_face_ref (f
, attributes
, attrs
, 1, 0);
6185 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6186 if (def_face
== NULL
)
6188 if (! realize_basic_faces (f
))
6189 error ("Cannot realize default face");
6190 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6193 /* Dispatch to the appropriate handler. */
6194 if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
6195 supports
= tty_supports_face_attributes_p (f
, attrs
, def_face
);
6196 #ifdef HAVE_WINDOW_SYSTEM
6198 supports
= x_supports_face_attributes_p (f
, attrs
, def_face
);
6201 return supports
? Qt
: Qnil
;
6205 /***********************************************************************
6207 ***********************************************************************/
6209 DEFUN ("internal-set-font-selection-order",
6210 Finternal_set_font_selection_order
,
6211 Sinternal_set_font_selection_order
, 1, 1, 0,
6212 doc
: /* Set font selection order for face font selection to ORDER.
6213 ORDER must be a list of length 4 containing the symbols `:width',
6214 `:height', `:weight', and `:slant'. Face attributes appearing
6215 first in ORDER are matched first, e.g. if `:height' appears before
6216 `:weight' in ORDER, font selection first tries to find a font with
6217 a suitable height, and then tries to match the font weight.
6224 int indices
[DIM (font_sort_order
)];
6227 bzero (indices
, sizeof indices
);
6231 CONSP (list
) && i
< DIM (indices
);
6232 list
= XCDR (list
), ++i
)
6234 Lisp_Object attr
= XCAR (list
);
6237 if (EQ (attr
, QCwidth
))
6239 else if (EQ (attr
, QCheight
))
6240 xlfd
= XLFD_POINT_SIZE
;
6241 else if (EQ (attr
, QCweight
))
6243 else if (EQ (attr
, QCslant
))
6248 if (indices
[i
] != 0)
6253 if (!NILP (list
) || i
!= DIM (indices
))
6254 signal_error ("Invalid font sort order", order
);
6255 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6256 if (indices
[i
] == 0)
6257 signal_error ("Invalid font sort order", order
);
6259 if (bcmp (indices
, font_sort_order
, sizeof indices
) != 0)
6261 bcopy (indices
, font_sort_order
, sizeof font_sort_order
);
6262 free_all_realized_faces (Qnil
);
6269 DEFUN ("internal-set-alternative-font-family-alist",
6270 Finternal_set_alternative_font_family_alist
,
6271 Sinternal_set_alternative_font_family_alist
, 1, 1, 0,
6272 doc
: /* Define alternative font families to try in face font selection.
6273 ALIST is an alist of (FAMILY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6274 Each ALTERNATIVE is tried in order if no fonts of font family FAMILY can
6275 be found. Value is ALIST. */)
6280 Vface_alternative_font_family_alist
= alist
;
6281 free_all_realized_faces (Qnil
);
6286 DEFUN ("internal-set-alternative-font-registry-alist",
6287 Finternal_set_alternative_font_registry_alist
,
6288 Sinternal_set_alternative_font_registry_alist
, 1, 1, 0,
6289 doc
: /* Define alternative font registries to try in face font selection.
6290 ALIST is an alist of (REGISTRY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6291 Each ALTERNATIVE is tried in order if no fonts of font registry REGISTRY can
6292 be found. Value is ALIST. */)
6297 Vface_alternative_font_registry_alist
= alist
;
6298 free_all_realized_faces (Qnil
);
6303 #ifdef HAVE_WINDOW_SYSTEM
6305 /* Value is non-zero if FONT is the name of a scalable font. The
6306 X11R6 XLFD spec says that point size, pixel size, and average width
6307 are zero for scalable fonts. Intlfonts contain at least one
6308 scalable font ("*-muleindian-1") for which this isn't true, so we
6309 just test average width. */
6312 font_scalable_p (font
)
6313 struct font_name
*font
;
6315 char *s
= font
->fields
[XLFD_AVGWIDTH
];
6316 return (*s
== '0' && *(s
+ 1) == '\0')
6318 /* Windows implementation of XLFD is slightly broken for backward
6319 compatibility with previous broken versions, so test for
6320 wildcards as well as 0. */
6327 /* Ignore the difference of font point size less than this value. */
6329 #define FONT_POINT_SIZE_QUANTUM 5
6331 /* Value is non-zero if FONT1 is a better match for font attributes
6332 VALUES than FONT2. VALUES is an array of face attribute values in
6333 font sort order. COMPARE_PT_P zero means don't compare point
6334 sizes. AVGWIDTH, if not zero, is a specified font average width
6338 better_font_p (values
, font1
, font2
, compare_pt_p
, avgwidth
)
6340 struct font_name
*font1
, *font2
;
6341 int compare_pt_p
, avgwidth
;
6345 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6347 int xlfd_idx
= font_sort_order
[i
];
6349 if (compare_pt_p
|| xlfd_idx
!= XLFD_POINT_SIZE
)
6353 if (xlfd_idx
== XLFD_POINT_SIZE
)
6355 delta1
= abs (values
[i
] - (font1
->numeric
[xlfd_idx
]
6356 / font1
->rescale_ratio
));
6357 delta2
= abs (values
[i
] - (font2
->numeric
[xlfd_idx
]
6358 / font2
->rescale_ratio
));
6359 if (abs (delta1
- delta2
) < FONT_POINT_SIZE_QUANTUM
)
6364 delta1
= abs (values
[i
] - font1
->numeric
[xlfd_idx
]);
6365 delta2
= abs (values
[i
] - font2
->numeric
[xlfd_idx
]);
6368 if (delta1
> delta2
)
6370 else if (delta1
< delta2
)
6374 /* The difference may be equal because, e.g., the face
6375 specifies `italic' but we have only `regular' and
6376 `oblique'. Prefer `oblique' in this case. */
6377 if ((xlfd_idx
== XLFD_WEIGHT
|| xlfd_idx
== XLFD_SLANT
)
6378 && font1
->numeric
[xlfd_idx
] > values
[i
]
6379 && font2
->numeric
[xlfd_idx
] < values
[i
])
6387 int delta1
= abs (avgwidth
- font1
->numeric
[XLFD_AVGWIDTH
]);
6388 int delta2
= abs (avgwidth
- font2
->numeric
[XLFD_AVGWIDTH
]);
6389 if (delta1
> delta2
)
6391 else if (delta1
< delta2
)
6397 /* We prefer a real scalable font; i.e. not what autoscaled. */
6398 int auto_scaled_1
= (font1
->numeric
[XLFD_POINT_SIZE
] == 0
6399 && font1
->numeric
[XLFD_RESY
] > 0);
6400 int auto_scaled_2
= (font2
->numeric
[XLFD_POINT_SIZE
] == 0
6401 && font2
->numeric
[XLFD_RESY
] > 0);
6403 if (auto_scaled_1
!= auto_scaled_2
)
6404 return auto_scaled_2
;
6407 return font1
->registry_priority
< font2
->registry_priority
;
6411 /* Value is non-zero if FONT is an exact match for face attributes in
6412 SPECIFIED. SPECIFIED is an array of face attribute values in font
6413 sort order. AVGWIDTH, if non-zero, is an average width to compare
6417 exact_face_match_p (specified
, font
, avgwidth
)
6419 struct font_name
*font
;
6424 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6425 if (specified
[i
] != font
->numeric
[font_sort_order
[i
]])
6428 return (i
== DIM (font_sort_order
)
6430 || avgwidth
== font
->numeric
[XLFD_AVGWIDTH
]));
6434 /* Value is the name of a scaled font, generated from scalable font
6435 FONT on frame F. SPECIFIED_PT is the point-size to scale FONT to.
6436 Value is allocated from heap. */
6439 build_scalable_font_name (f
, font
, specified_pt
)
6441 struct font_name
*font
;
6444 char pixel_size
[20];
6446 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
6449 /* If scalable font is for a specific resolution, compute
6450 the point size we must specify from the resolution of
6451 the display and the specified resolution of the font. */
6452 if (font
->numeric
[XLFD_RESY
] != 0)
6454 pt
= resy
/ font
->numeric
[XLFD_RESY
] * specified_pt
+ 0.5;
6455 pixel_value
= font
->numeric
[XLFD_RESY
] / (PT_PER_INCH
* 10.0) * pt
;
6460 pixel_value
= resy
/ (PT_PER_INCH
* 10.0) * pt
;
6462 /* We may need a font of the different size. */
6463 pixel_value
*= font
->rescale_ratio
;
6465 /* We should keep POINT_SIZE 0. Otherwise, X server can't open a
6466 font of the specified PIXEL_SIZE. */
6468 { /* Set point size of the font. */
6469 char point_size
[20];
6470 sprintf (point_size
, "%d", (int) pt
);
6471 font
->fields
[XLFD_POINT_SIZE
] = point_size
;
6472 font
->numeric
[XLFD_POINT_SIZE
] = pt
;
6476 /* Set pixel size. */
6477 sprintf (pixel_size
, "%d", pixel_value
);
6478 font
->fields
[XLFD_PIXEL_SIZE
] = pixel_size
;
6479 font
->numeric
[XLFD_PIXEL_SIZE
] = pixel_value
;
6481 /* If font doesn't specify its resolution, use the
6482 resolution of the display. */
6483 if (font
->numeric
[XLFD_RESY
] == 0)
6486 sprintf (buffer
, "%d", (int) resy
);
6487 font
->fields
[XLFD_RESY
] = buffer
;
6488 font
->numeric
[XLFD_RESY
] = resy
;
6491 if (strcmp (font
->fields
[XLFD_RESX
], "0") == 0)
6494 int resx
= FRAME_X_DISPLAY_INFO (f
)->resx
;
6495 sprintf (buffer
, "%d", resx
);
6496 font
->fields
[XLFD_RESX
] = buffer
;
6497 font
->numeric
[XLFD_RESX
] = resx
;
6500 return build_font_name (font
);
6504 /* Value is non-zero if we are allowed to use scalable font FONT. We
6505 can't run a Lisp function here since this function may be called
6506 with input blocked. */
6509 may_use_scalable_font_p (font
)
6512 if (EQ (Vscalable_fonts_allowed
, Qt
))
6514 else if (CONSP (Vscalable_fonts_allowed
))
6516 Lisp_Object tail
, regexp
;
6518 for (tail
= Vscalable_fonts_allowed
; CONSP (tail
); tail
= XCDR (tail
))
6520 regexp
= XCAR (tail
);
6521 if (STRINGP (regexp
)
6522 && fast_c_string_match_ignore_case (regexp
, font
) >= 0)
6532 /* Return the name of the best matching font for face attributes ATTRS
6533 in the array of font_name structures FONTS which contains NFONTS
6534 elements. WIDTH_RATIO is a factor with which to multiply average
6535 widths if ATTRS specifies such a width.
6537 Value is a font name which is allocated from the heap. FONTS is
6538 freed by this function.
6540 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
6541 indicate whether the resulting font should be drawn using overstrike
6542 to simulate bold-face. */
6545 best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
, needs_overstrike
)
6548 struct font_name
*fonts
;
6551 int *needs_overstrike
;
6554 struct font_name
*best
;
6557 int exact_p
, avgwidth
;
6562 /* Make specified font attributes available in `specified',
6563 indexed by sort order. */
6564 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6566 int xlfd_idx
= font_sort_order
[i
];
6568 if (xlfd_idx
== XLFD_SWIDTH
)
6569 specified
[i
] = face_numeric_swidth (attrs
[LFACE_SWIDTH_INDEX
]);
6570 else if (xlfd_idx
== XLFD_POINT_SIZE
)
6571 specified
[i
] = pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
6572 else if (xlfd_idx
== XLFD_WEIGHT
)
6573 specified
[i
] = face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
6574 else if (xlfd_idx
== XLFD_SLANT
)
6575 specified
[i
] = face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
6580 avgwidth
= (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
6582 : XFASTINT (attrs
[LFACE_AVGWIDTH_INDEX
]) * width_ratio
);
6586 if (needs_overstrike
)
6587 *needs_overstrike
= 0;
6589 /* Start with the first non-scalable font in the list. */
6590 for (i
= 0; i
< nfonts
; ++i
)
6591 if (!font_scalable_p (fonts
+ i
))
6594 /* Find the best match among the non-scalable fonts. */
6599 for (i
= 1; i
< nfonts
; ++i
)
6600 if (!font_scalable_p (fonts
+ i
)
6601 && better_font_p (specified
, fonts
+ i
, best
, 1, avgwidth
))
6605 exact_p
= exact_face_match_p (specified
, best
, avgwidth
);
6613 /* Unless we found an exact match among non-scalable fonts, see if
6614 we can find a better match among scalable fonts. */
6617 /* A scalable font is better if
6619 1. its weight, slant, swidth attributes are better, or.
6621 2. the best non-scalable font doesn't have the required
6622 point size, and the scalable fonts weight, slant, swidth
6625 int non_scalable_has_exact_height_p
;
6627 if (best
&& best
->numeric
[XLFD_POINT_SIZE
] == pt
)
6628 non_scalable_has_exact_height_p
= 1;
6630 non_scalable_has_exact_height_p
= 0;
6632 for (i
= 0; i
< nfonts
; ++i
)
6633 if (font_scalable_p (fonts
+ i
))
6636 || better_font_p (specified
, fonts
+ i
, best
, 0, 0)
6637 || (!non_scalable_has_exact_height_p
6638 && !better_font_p (specified
, best
, fonts
+ i
, 0, 0)))
6640 non_scalable_has_exact_height_p
= 1;
6645 if (needs_overstrike
)
6647 enum xlfd_weight want_weight
= specified
[XLFD_WEIGHT
];
6648 enum xlfd_weight got_weight
= best
->numeric
[XLFD_WEIGHT
];
6650 if (want_weight
> XLFD_WEIGHT_MEDIUM
&& want_weight
> got_weight
)
6652 /* We want a bold font, but didn't get one; try to use
6653 overstriking instead to simulate bold-face. However,
6654 don't overstrike an already-bold fontn unless the
6655 desired weight grossly exceeds the available weight. */
6656 if (got_weight
> XLFD_WEIGHT_MEDIUM
)
6657 *needs_overstrike
= (got_weight
- want_weight
) > 2;
6659 *needs_overstrike
= 1;
6664 if (font_scalable_p (best
))
6665 font_name
= build_scalable_font_name (f
, best
, pt
);
6667 font_name
= build_font_name (best
);
6669 /* Free font_name structures. */
6670 free_font_names (fonts
, nfonts
);
6676 /* Get a list of matching fonts on frame F, considering FAMILY
6677 and alternative font families from Vface_alternative_font_registry_alist.
6679 FAMILY is the font family whose alternatives are considered.
6681 REGISTRY, if a string, specifies a font registry and encoding to
6682 match. A value of nil means include fonts of any registry and
6685 Return in *FONTS a pointer to a vector of font_name structures for
6686 the fonts matched. Value is the number of fonts found. */
6689 try_alternative_families (f
, family
, registry
, fonts
)
6691 Lisp_Object family
, registry
;
6692 struct font_name
**fonts
;
6697 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
6700 /* Try alternative font families. */
6701 alter
= Fassoc (family
, Vface_alternative_font_family_alist
);
6704 for (alter
= XCDR (alter
);
6705 CONSP (alter
) && nfonts
== 0;
6706 alter
= XCDR (alter
))
6708 if (STRINGP (XCAR (alter
)))
6709 nfonts
= font_list (f
, Qnil
, XCAR (alter
), registry
, fonts
);
6713 /* Try all scalable fonts before giving up. */
6714 if (nfonts
== 0 && ! EQ (Vscalable_fonts_allowed
, Qt
))
6716 int count
= SPECPDL_INDEX ();
6717 specbind (Qscalable_fonts_allowed
, Qt
);
6718 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6719 unbind_to (count
, Qnil
);
6726 /* Get a list of matching fonts on frame F.
6728 FAMILY, if a string, specifies a font family derived from the fontset.
6729 It is only used if the face does not specify any family in ATTRS or
6730 if we cannot find any font of the face's family.
6732 REGISTRY, if a string, specifies a font registry and encoding to
6733 match. A value of nil means include fonts of any registry and
6736 If PREFER_FACE_FAMILY is nonzero, perfer face's family to FAMILY.
6737 Otherwise, prefer FAMILY.
6739 Return in *FONTS a pointer to a vector of font_name structures for
6740 the fonts matched. Value is the number of fonts found. */
6743 try_font_list (f
, attrs
, family
, registry
, fonts
, prefer_face_family
)
6746 Lisp_Object family
, registry
;
6747 struct font_name
**fonts
;
6748 int prefer_face_family
;
6751 Lisp_Object face_family
= attrs
[LFACE_FAMILY_INDEX
];
6752 Lisp_Object try_family
;
6754 try_family
= (prefer_face_family
|| NILP (family
)) ? face_family
: family
;
6756 if (STRINGP (try_family
))
6757 nfonts
= try_alternative_families (f
, try_family
, registry
, fonts
);
6760 /* When realizing the default face and a font spec does not matched
6761 exactly, Emacs looks for ones with the same registry as the
6762 default font. On the Mac, this is mac-roman, which does not work
6763 if the family is -etl-fixed, e.g. The following widens the
6764 choices and fixes that problem. */
6765 if (nfonts
== 0 && STRINGP (try_family
) && STRINGP (registry
)
6766 && xstricmp (SDATA (registry
), "mac-roman") == 0)
6767 nfonts
= try_alternative_families (f
, try_family
, Qnil
, fonts
);
6770 if (EQ (try_family
, family
))
6771 family
= face_family
;
6773 if (nfonts
== 0 && STRINGP (family
))
6774 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6776 /* Try font family of the default face or "fixed". */
6779 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6781 family
= default_face
->lface
[LFACE_FAMILY_INDEX
];
6783 family
= build_string ("fixed");
6784 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
6787 /* Try any family with the given registry. */
6789 nfonts
= try_alternative_families (f
, Qnil
, registry
, fonts
);
6795 /* Return the fontset id of the base fontset name or alias name given
6796 by the fontset attribute of ATTRS. Value is -1 if the fontset
6797 attribute of ATTRS doesn't name a fontset. */
6800 face_fontset (attrs
)
6805 name
= attrs
[LFACE_FONT_INDEX
];
6806 if (!STRINGP (name
))
6808 return fs_query_fontset (name
, 0);
6812 /* Choose a name of font to use on frame F to display character C with
6813 Lisp face attributes specified by ATTRS. The font name is
6814 determined by the font-related attributes in ATTRS and the name
6815 pattern for C in FONTSET. Value is the font name which is
6816 allocated from the heap and must be freed by the caller, or NULL if
6817 we can get no information about the font name of C. It is assured
6818 that we always get some information for a single byte
6821 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
6822 indicate whether the resulting font should be drawn using overstrike
6823 to simulate bold-face. */
6826 choose_face_font (f
, attrs
, fontset
, c
, needs_overstrike
)
6830 int *needs_overstrike
;
6832 Lisp_Object pattern
;
6833 char *font_name
= NULL
;
6834 struct font_name
*fonts
;
6835 int nfonts
, width_ratio
;
6837 if (needs_overstrike
)
6838 *needs_overstrike
= 0;
6840 /* Get (foundry and) family name and registry (and encoding) name of
6842 pattern
= fontset_font_pattern (f
, fontset
, c
);
6845 xassert (!SINGLE_BYTE_CHAR_P (c
));
6849 /* If what we got is a name pattern, return it. */
6850 if (STRINGP (pattern
))
6851 return xstrdup (SDATA (pattern
));
6853 /* Get a list of fonts matching that pattern and choose the
6854 best match for the specified face attributes from it. */
6855 nfonts
= try_font_list (f
, attrs
, XCAR (pattern
), XCDR (pattern
), &fonts
,
6856 (SINGLE_BYTE_CHAR_P (c
)
6857 || CHAR_CHARSET (c
) == charset_latin_iso8859_1
));
6858 width_ratio
= (SINGLE_BYTE_CHAR_P (c
)
6860 : CHARSET_WIDTH (CHAR_CHARSET (c
)));
6861 font_name
= best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
,
6866 #endif /* HAVE_WINDOW_SYSTEM */
6870 /***********************************************************************
6872 ***********************************************************************/
6874 /* Realize basic faces on frame F. Value is zero if frame parameters
6875 of F don't contain enough information needed to realize the default
6879 realize_basic_faces (f
)
6883 int count
= SPECPDL_INDEX ();
6885 /* Block input here so that we won't be surprised by an X expose
6886 event, for instance, without having the faces set up. */
6888 specbind (Qscalable_fonts_allowed
, Qt
);
6890 if (realize_default_face (f
))
6892 realize_named_face (f
, Qmode_line
, MODE_LINE_FACE_ID
);
6893 realize_named_face (f
, Qmode_line_inactive
, MODE_LINE_INACTIVE_FACE_ID
);
6894 realize_named_face (f
, Qtool_bar
, TOOL_BAR_FACE_ID
);
6895 realize_named_face (f
, Qfringe
, FRINGE_FACE_ID
);
6896 realize_named_face (f
, Qheader_line
, HEADER_LINE_FACE_ID
);
6897 realize_named_face (f
, Qscroll_bar
, SCROLL_BAR_FACE_ID
);
6898 realize_named_face (f
, Qborder
, BORDER_FACE_ID
);
6899 realize_named_face (f
, Qcursor
, CURSOR_FACE_ID
);
6900 realize_named_face (f
, Qmouse
, MOUSE_FACE_ID
);
6901 realize_named_face (f
, Qmenu
, MENU_FACE_ID
);
6903 /* Reflect changes in the `menu' face in menu bars. */
6904 if (FRAME_FACE_CACHE (f
)->menu_face_changed_p
)
6906 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 0;
6907 #ifdef USE_X_TOOLKIT
6908 if (FRAME_WINDOW_P (f
))
6909 x_update_menu_appearance (f
);
6916 unbind_to (count
, Qnil
);
6922 /* Realize the default face on frame F. If the face is not fully
6923 specified, make it fully-specified. Attributes of the default face
6924 that are not explicitly specified are taken from frame parameters. */
6927 realize_default_face (f
)
6930 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
6932 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6933 Lisp_Object frame_font
;
6936 /* If the `default' face is not yet known, create it. */
6937 lface
= lface_from_face_name (f
, Qdefault
, 0);
6941 XSETFRAME (frame
, f
);
6942 lface
= Finternal_make_lisp_face (Qdefault
, frame
);
6946 #ifdef HAVE_WINDOW_SYSTEM
6947 if (FRAME_WINDOW_P (f
))
6949 /* Set frame_font to the value of the `font' frame parameter. */
6950 frame_font
= Fassq (Qfont
, f
->param_alist
);
6951 xassert (CONSP (frame_font
) && STRINGP (XCDR (frame_font
)));
6952 frame_font
= XCDR (frame_font
);
6953 set_lface_from_font_name (f
, lface
, frame_font
,
6954 f
->default_face_done_p
, 1);
6955 f
->default_face_done_p
= 1;
6957 #endif /* HAVE_WINDOW_SYSTEM */
6959 if (!FRAME_WINDOW_P (f
))
6961 LFACE_FAMILY (lface
) = build_string ("default");
6962 LFACE_SWIDTH (lface
) = Qnormal
;
6963 LFACE_HEIGHT (lface
) = make_number (1);
6964 if (UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
6965 LFACE_WEIGHT (lface
) = Qnormal
;
6966 if (UNSPECIFIEDP (LFACE_SLANT (lface
)))
6967 LFACE_SLANT (lface
) = Qnormal
;
6968 LFACE_AVGWIDTH (lface
) = Qunspecified
;
6971 if (UNSPECIFIEDP (LFACE_UNDERLINE (lface
)))
6972 LFACE_UNDERLINE (lface
) = Qnil
;
6974 if (UNSPECIFIEDP (LFACE_OVERLINE (lface
)))
6975 LFACE_OVERLINE (lface
) = Qnil
;
6977 if (UNSPECIFIEDP (LFACE_STRIKE_THROUGH (lface
)))
6978 LFACE_STRIKE_THROUGH (lface
) = Qnil
;
6980 if (UNSPECIFIEDP (LFACE_BOX (lface
)))
6981 LFACE_BOX (lface
) = Qnil
;
6983 if (UNSPECIFIEDP (LFACE_INVERSE (lface
)))
6984 LFACE_INVERSE (lface
) = Qnil
;
6986 if (UNSPECIFIEDP (LFACE_FOREGROUND (lface
)))
6988 /* This function is called so early that colors are not yet
6989 set in the frame parameter list. */
6990 Lisp_Object color
= Fassq (Qforeground_color
, f
->param_alist
);
6992 if (CONSP (color
) && STRINGP (XCDR (color
)))
6993 LFACE_FOREGROUND (lface
) = XCDR (color
);
6994 else if (FRAME_WINDOW_P (f
))
6996 else if (FRAME_INITIAL_P (f
) || FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
6997 LFACE_FOREGROUND (lface
) = build_string (unspecified_fg
);
7002 if (UNSPECIFIEDP (LFACE_BACKGROUND (lface
)))
7004 /* This function is called so early that colors are not yet
7005 set in the frame parameter list. */
7006 Lisp_Object color
= Fassq (Qbackground_color
, f
->param_alist
);
7007 if (CONSP (color
) && STRINGP (XCDR (color
)))
7008 LFACE_BACKGROUND (lface
) = XCDR (color
);
7009 else if (FRAME_WINDOW_P (f
))
7011 else if (FRAME_INITIAL_P (f
) || FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
7012 LFACE_BACKGROUND (lface
) = build_string (unspecified_bg
);
7017 if (UNSPECIFIEDP (LFACE_STIPPLE (lface
)))
7018 LFACE_STIPPLE (lface
) = Qnil
;
7020 /* Realize the face; it must be fully-specified now. */
7021 xassert (lface_fully_specified_p (XVECTOR (lface
)->contents
));
7022 check_lface (lface
);
7023 bcopy (XVECTOR (lface
)->contents
, attrs
, sizeof attrs
);
7024 face
= realize_face (c
, attrs
, 0, NULL
, DEFAULT_FACE_ID
);
7029 /* Realize basic faces other than the default face in face cache C.
7030 SYMBOL is the face name, ID is the face id the realized face must
7031 have. The default face must have been realized already. */
7034 realize_named_face (f
, symbol
, id
)
7039 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
7040 Lisp_Object lface
= lface_from_face_name (f
, symbol
, 0);
7041 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7042 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
7043 struct face
*new_face
;
7045 /* The default face must exist and be fully specified. */
7046 get_lface_attributes (f
, Qdefault
, attrs
, 1);
7047 check_lface_attrs (attrs
);
7048 xassert (lface_fully_specified_p (attrs
));
7050 /* If SYMBOL isn't know as a face, create it. */
7054 XSETFRAME (frame
, f
);
7055 lface
= Finternal_make_lisp_face (symbol
, frame
);
7058 /* Merge SYMBOL's face with the default face. */
7059 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
7060 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
7062 /* Realize the face. */
7063 new_face
= realize_face (c
, attrs
, 0, NULL
, id
);
7067 /* Realize the fully-specified face with attributes ATTRS in face
7068 cache CACHE for character C. If C is a multibyte character,
7069 BASE_FACE is a face that has the same attributes. Otherwise,
7070 BASE_FACE is ignored. If FORMER_FACE_ID is non-negative, it is an
7071 ID of face to remove before caching the new face. Value is a
7072 pointer to the newly created realized face. */
7074 static struct face
*
7075 realize_face (cache
, attrs
, c
, base_face
, former_face_id
)
7076 struct face_cache
*cache
;
7079 struct face
*base_face
;
7084 /* LFACE must be fully specified. */
7085 xassert (cache
!= NULL
);
7086 check_lface_attrs (attrs
);
7088 if (former_face_id
>= 0 && cache
->used
> former_face_id
)
7090 /* Remove the former face. */
7091 struct face
*former_face
= cache
->faces_by_id
[former_face_id
];
7092 uncache_face (cache
, former_face
);
7093 free_realized_face (cache
->f
, former_face
);
7096 if (FRAME_WINDOW_P (cache
->f
))
7097 face
= realize_x_face (cache
, attrs
, c
, base_face
);
7098 else if (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
))
7099 face
= realize_tty_face (cache
, attrs
, c
);
7100 else if (FRAME_INITIAL_P (cache
->f
))
7102 /* Create a dummy face. */
7103 face
= make_realized_face (attrs
);
7108 /* Insert the new face. */
7109 cache_face (cache
, face
, lface_hash (attrs
));
7110 #ifdef HAVE_WINDOW_SYSTEM
7111 if (FRAME_WINDOW_P (cache
->f
) && face
->font
== NULL
)
7112 load_face_font (cache
->f
, face
, c
);
7113 #endif /* HAVE_WINDOW_SYSTEM */
7118 /* Realize the fully-specified face with attributes ATTRS in face
7119 cache CACHE for character C. Do it for X frame CACHE->f. If C is
7120 a multibyte character, BASE_FACE is a face that has the same
7121 attributes. Otherwise, BASE_FACE is ignored. If the new face
7122 doesn't share font with the default face, a fontname is allocated
7123 from the heap and set in `font_name' of the new face, but it is not
7124 yet loaded here. Value is a pointer to the newly created realized
7127 static struct face
*
7128 realize_x_face (cache
, attrs
, c
, base_face
)
7129 struct face_cache
*cache
;
7132 struct face
*base_face
;
7134 struct face
*face
= NULL
;
7135 #ifdef HAVE_WINDOW_SYSTEM
7136 struct face
*default_face
;
7138 Lisp_Object stipple
, overline
, strike_through
, box
;
7140 xassert (FRAME_WINDOW_P (cache
->f
));
7141 xassert (SINGLE_BYTE_CHAR_P (c
)
7144 /* Allocate a new realized face. */
7145 face
= make_realized_face (attrs
);
7149 /* If C is a multibyte character, we share all face attirbutes with
7150 BASE_FACE including the realized fontset. But, we must load a
7152 if (!SINGLE_BYTE_CHAR_P (c
))
7154 bcopy (base_face
, face
, sizeof *face
);
7157 /* Don't try to free the colors copied bitwise from BASE_FACE. */
7158 face
->colors_copied_bitwise_p
= 1;
7160 /* to force realize_face to load font */
7165 /* Now we are realizing a face for ASCII (and unibyte) characters. */
7167 /* Determine the font to use. Most of the time, the font will be
7168 the same as the font of the default face, so try that first. */
7169 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7171 && FACE_SUITABLE_FOR_CHAR_P (default_face
, c
)
7172 && lface_same_font_attributes_p (default_face
->lface
, attrs
))
7174 face
->font
= default_face
->font
;
7175 face
->fontset
= default_face
->fontset
;
7176 face
->font_info_id
= default_face
->font_info_id
;
7177 face
->font_name
= default_face
->font_name
;
7178 face
->ascii_face
= face
;
7180 /* But, as we can't share the fontset, make a new realized
7181 fontset that has the same base fontset as of the default
7184 = make_fontset_for_ascii_face (f
, default_face
->fontset
);
7188 /* If the face attribute ATTRS specifies a fontset, use it as
7189 the base of a new realized fontset. Otherwise, use the same
7190 base fontset as of the default face. The base determines
7191 registry and encoding of a font. It may also determine
7192 foundry and family. The other fields of font name pattern
7193 are constructed from ATTRS. */
7194 int fontset
= face_fontset (attrs
);
7196 if ((fontset
== -1) && default_face
)
7197 fontset
= default_face
->fontset
;
7198 face
->fontset
= make_fontset_for_ascii_face (f
, fontset
);
7199 face
->font
= NULL
; /* to force realize_face to load font */
7202 /* Load colors, and set remaining attributes. */
7204 load_face_colors (f
, face
, attrs
);
7207 box
= attrs
[LFACE_BOX_INDEX
];
7210 /* A simple box of line width 1 drawn in color given by
7212 face
->box_color
= load_color (f
, face
, attrs
[LFACE_BOX_INDEX
],
7214 face
->box
= FACE_SIMPLE_BOX
;
7215 face
->box_line_width
= 1;
7217 else if (INTEGERP (box
))
7219 /* Simple box of specified line width in foreground color of the
7221 xassert (XINT (box
) != 0);
7222 face
->box
= FACE_SIMPLE_BOX
;
7223 face
->box_line_width
= XINT (box
);
7224 face
->box_color
= face
->foreground
;
7225 face
->box_color_defaulted_p
= 1;
7227 else if (CONSP (box
))
7229 /* `(:width WIDTH :color COLOR :shadow SHADOW)'. SHADOW
7230 being one of `raised' or `sunken'. */
7231 face
->box
= FACE_SIMPLE_BOX
;
7232 face
->box_color
= face
->foreground
;
7233 face
->box_color_defaulted_p
= 1;
7234 face
->box_line_width
= 1;
7238 Lisp_Object keyword
, value
;
7240 keyword
= XCAR (box
);
7248 if (EQ (keyword
, QCline_width
))
7250 if (INTEGERP (value
) && XINT (value
) != 0)
7251 face
->box_line_width
= XINT (value
);
7253 else if (EQ (keyword
, QCcolor
))
7255 if (STRINGP (value
))
7257 face
->box_color
= load_color (f
, face
, value
,
7259 face
->use_box_color_for_shadows_p
= 1;
7262 else if (EQ (keyword
, QCstyle
))
7264 if (EQ (value
, Qreleased_button
))
7265 face
->box
= FACE_RAISED_BOX
;
7266 else if (EQ (value
, Qpressed_button
))
7267 face
->box
= FACE_SUNKEN_BOX
;
7272 /* Text underline, overline, strike-through. */
7274 if (EQ (attrs
[LFACE_UNDERLINE_INDEX
], Qt
))
7276 /* Use default color (same as foreground color). */
7277 face
->underline_p
= 1;
7278 face
->underline_defaulted_p
= 1;
7279 face
->underline_color
= 0;
7281 else if (STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]))
7283 /* Use specified color. */
7284 face
->underline_p
= 1;
7285 face
->underline_defaulted_p
= 0;
7286 face
->underline_color
7287 = load_color (f
, face
, attrs
[LFACE_UNDERLINE_INDEX
],
7288 LFACE_UNDERLINE_INDEX
);
7290 else if (NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7292 face
->underline_p
= 0;
7293 face
->underline_defaulted_p
= 0;
7294 face
->underline_color
= 0;
7297 overline
= attrs
[LFACE_OVERLINE_INDEX
];
7298 if (STRINGP (overline
))
7300 face
->overline_color
7301 = load_color (f
, face
, attrs
[LFACE_OVERLINE_INDEX
],
7302 LFACE_OVERLINE_INDEX
);
7303 face
->overline_p
= 1;
7305 else if (EQ (overline
, Qt
))
7307 face
->overline_color
= face
->foreground
;
7308 face
->overline_color_defaulted_p
= 1;
7309 face
->overline_p
= 1;
7312 strike_through
= attrs
[LFACE_STRIKE_THROUGH_INDEX
];
7313 if (STRINGP (strike_through
))
7315 face
->strike_through_color
7316 = load_color (f
, face
, attrs
[LFACE_STRIKE_THROUGH_INDEX
],
7317 LFACE_STRIKE_THROUGH_INDEX
);
7318 face
->strike_through_p
= 1;
7320 else if (EQ (strike_through
, Qt
))
7322 face
->strike_through_color
= face
->foreground
;
7323 face
->strike_through_color_defaulted_p
= 1;
7324 face
->strike_through_p
= 1;
7327 stipple
= attrs
[LFACE_STIPPLE_INDEX
];
7328 if (!NILP (stipple
))
7329 face
->stipple
= load_pixmap (f
, stipple
, &face
->pixmap_w
, &face
->pixmap_h
);
7331 xassert (FACE_SUITABLE_FOR_CHAR_P (face
, c
));
7332 #endif /* HAVE_WINDOW_SYSTEM */
7337 /* Map a specified color of face FACE on frame F to a tty color index.
7338 IDX is either LFACE_FOREGROUND_INDEX or LFACE_BACKGROUND_INDEX, and
7339 specifies which color to map. Set *DEFAULTED to 1 if mapping to the
7340 default foreground/background colors. */
7343 map_tty_color (f
, face
, idx
, defaulted
)
7346 enum lface_attribute_index idx
;
7349 Lisp_Object frame
, color
, def
;
7350 int foreground_p
= idx
== LFACE_FOREGROUND_INDEX
;
7351 unsigned long default_pixel
, default_other_pixel
, pixel
;
7353 xassert (idx
== LFACE_FOREGROUND_INDEX
|| idx
== LFACE_BACKGROUND_INDEX
);
7357 pixel
= default_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7358 default_other_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7362 pixel
= default_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7363 default_other_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7366 XSETFRAME (frame
, f
);
7367 color
= face
->lface
[idx
];
7371 && CONSP (Vtty_defined_color_alist
)
7372 && (def
= assq_no_quit (color
, call1 (Qtty_color_alist
, frame
)),
7375 /* Associations in tty-defined-color-alist are of the form
7376 (NAME INDEX R G B). We need the INDEX part. */
7377 pixel
= XINT (XCAR (XCDR (def
)));
7380 if (pixel
== default_pixel
&& STRINGP (color
))
7382 pixel
= load_color (f
, face
, color
, idx
);
7384 #if defined (MSDOS) || defined (WINDOWSNT)
7385 /* If the foreground of the default face is the default color,
7386 use the foreground color defined by the frame. */
7388 if (FRAME_MSDOS_P (f
))
7391 if (pixel
== default_pixel
7392 || pixel
== FACE_TTY_DEFAULT_COLOR
)
7395 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7397 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7398 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7401 else if (pixel
== default_other_pixel
)
7404 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7406 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7407 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7413 #endif /* MSDOS or WINDOWSNT */
7417 face
->foreground
= pixel
;
7419 face
->background
= pixel
;
7423 /* Realize the fully-specified face with attributes ATTRS in face
7424 cache CACHE for character C. Do it for TTY frame CACHE->f. Value is a
7425 pointer to the newly created realized face. */
7427 static struct face
*
7428 realize_tty_face (cache
, attrs
, c
)
7429 struct face_cache
*cache
;
7435 int face_colors_defaulted
= 0;
7436 struct frame
*f
= cache
->f
;
7438 /* Frame must be a termcap frame. */
7439 xassert (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
));
7441 /* Allocate a new realized face. */
7442 face
= make_realized_face (attrs
);
7443 face
->font_name
= FRAME_MSDOS_P (cache
->f
) ? "ms-dos" : "tty";
7445 /* Map face attributes to TTY appearances. We map slant to
7446 dimmed text because we want italic text to appear differently
7447 and because dimmed text is probably used infrequently. */
7448 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
7449 slant
= face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
7451 if (weight
> XLFD_WEIGHT_MEDIUM
)
7452 face
->tty_bold_p
= 1;
7453 if (weight
< XLFD_WEIGHT_MEDIUM
|| slant
!= XLFD_SLANT_ROMAN
)
7454 face
->tty_dim_p
= 1;
7455 if (!NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7456 face
->tty_underline_p
= 1;
7457 if (!NILP (attrs
[LFACE_INVERSE_INDEX
]))
7458 face
->tty_reverse_p
= 1;
7460 /* Map color names to color indices. */
7461 map_tty_color (f
, face
, LFACE_FOREGROUND_INDEX
, &face_colors_defaulted
);
7462 map_tty_color (f
, face
, LFACE_BACKGROUND_INDEX
, &face_colors_defaulted
);
7464 /* Swap colors if face is inverse-video. If the colors are taken
7465 from the frame colors, they are already inverted, since the
7466 frame-creation function calls x-handle-reverse-video. */
7467 if (face
->tty_reverse_p
&& !face_colors_defaulted
)
7469 unsigned long tem
= face
->foreground
;
7470 face
->foreground
= face
->background
;
7471 face
->background
= tem
;
7474 if (tty_suppress_bold_inverse_default_colors_p
7476 && face
->background
== FACE_TTY_DEFAULT_FG_COLOR
7477 && face
->foreground
== FACE_TTY_DEFAULT_BG_COLOR
)
7478 face
->tty_bold_p
= 0;
7484 DEFUN ("tty-suppress-bold-inverse-default-colors",
7485 Ftty_suppress_bold_inverse_default_colors
,
7486 Stty_suppress_bold_inverse_default_colors
, 1, 1, 0,
7487 doc
: /* Suppress/allow boldness of faces with inverse default colors.
7488 SUPPRESS non-nil means suppress it.
7489 This affects bold faces on TTYs whose foreground is the default background
7490 color of the display and whose background is the default foreground color.
7491 For such faces, the bold face attribute is ignored if this variable
7494 Lisp_Object suppress
;
7496 tty_suppress_bold_inverse_default_colors_p
= !NILP (suppress
);
7497 ++face_change_count
;
7503 /***********************************************************************
7505 ***********************************************************************/
7507 /* Return the ID of the face to use to display character CH with face
7508 property PROP on frame F in current_buffer. */
7511 compute_char_face (f
, ch
, prop
)
7518 if (NILP (current_buffer
->enable_multibyte_characters
))
7523 struct face
*face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7524 face_id
= FACE_FOR_CHAR (f
, face
, ch
);
7528 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7529 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7530 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7531 merge_face_ref (f
, prop
, attrs
, 1, 0);
7532 face_id
= lookup_face (f
, attrs
, ch
, NULL
);
7538 /* Return the face ID associated with buffer position POS for
7539 displaying ASCII characters. Return in *ENDPTR the position at
7540 which a different face is needed, as far as text properties and
7541 overlays are concerned. W is a window displaying current_buffer.
7543 REGION_BEG, REGION_END delimit the region, so it can be
7546 LIMIT is a position not to scan beyond. That is to limit the time
7547 this function can take.
7549 If MOUSE is non-zero, use the character's mouse-face, not its face.
7551 The face returned is suitable for displaying ASCII characters. */
7554 face_at_buffer_position (w
, pos
, region_beg
, region_end
,
7555 endptr
, limit
, mouse
)
7558 int region_beg
, region_end
;
7563 struct frame
*f
= XFRAME (w
->frame
);
7564 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7565 Lisp_Object prop
, position
;
7567 Lisp_Object
*overlay_vec
;
7570 Lisp_Object propname
= mouse
? Qmouse_face
: Qface
;
7571 Lisp_Object limit1
, end
;
7572 struct face
*default_face
;
7574 /* W must display the current buffer. We could write this function
7575 to use the frame and buffer of W, but right now it doesn't. */
7576 /* xassert (XBUFFER (w->buffer) == current_buffer); */
7578 XSETFRAME (frame
, f
);
7579 XSETFASTINT (position
, pos
);
7582 if (pos
< region_beg
&& region_beg
< endpos
)
7583 endpos
= region_beg
;
7585 /* Get the `face' or `mouse_face' text property at POS, and
7586 determine the next position at which the property changes. */
7587 prop
= Fget_text_property (position
, propname
, w
->buffer
);
7588 XSETFASTINT (limit1
, (limit
< endpos
? limit
: endpos
));
7589 end
= Fnext_single_property_change (position
, propname
, w
->buffer
, limit1
);
7591 endpos
= XINT (end
);
7593 /* Look at properties from overlays. */
7597 GET_OVERLAYS_AT (pos
, overlay_vec
, noverlays
, &next_overlay
, 0);
7598 if (next_overlay
< endpos
)
7599 endpos
= next_overlay
;
7604 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7606 /* Optimize common cases where we can use the default face. */
7609 && !(pos
>= region_beg
&& pos
< region_end
))
7610 return DEFAULT_FACE_ID
;
7612 /* Begin with attributes from the default face. */
7613 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7615 /* Merge in attributes specified via text properties. */
7617 merge_face_ref (f
, prop
, attrs
, 1, 0);
7619 /* Now merge the overlay data. */
7620 noverlays
= sort_overlays (overlay_vec
, noverlays
, w
);
7621 for (i
= 0; i
< noverlays
; i
++)
7626 prop
= Foverlay_get (overlay_vec
[i
], propname
);
7628 merge_face_ref (f
, prop
, attrs
, 1, 0);
7630 oend
= OVERLAY_END (overlay_vec
[i
]);
7631 oendpos
= OVERLAY_POSITION (oend
);
7632 if (oendpos
< endpos
)
7636 /* If in the region, merge in the region face. */
7637 if (pos
>= region_beg
&& pos
< region_end
)
7639 merge_named_face (f
, Qregion
, attrs
, 0);
7641 if (region_end
< endpos
)
7642 endpos
= region_end
;
7647 /* Look up a realized face with the given face attributes,
7648 or realize a new one for ASCII characters. */
7649 return lookup_face (f
, attrs
, 0, NULL
);
7653 /* Compute the face at character position POS in Lisp string STRING on
7654 window W, for ASCII characters.
7656 If STRING is an overlay string, it comes from position BUFPOS in
7657 current_buffer, otherwise BUFPOS is zero to indicate that STRING is
7658 not an overlay string. W must display the current buffer.
7659 REGION_BEG and REGION_END give the start and end positions of the
7660 region; both are -1 if no region is visible.
7662 BASE_FACE_ID is the id of a face to merge with. For strings coming
7663 from overlays or the `display' property it is the face at BUFPOS.
7665 If MOUSE_P is non-zero, use the character's mouse-face, not its face.
7667 Set *ENDPTR to the next position where to check for faces in
7668 STRING; -1 if the face is constant from POS to the end of the
7671 Value is the id of the face to use. The face returned is suitable
7672 for displaying ASCII characters. */
7675 face_at_string_position (w
, string
, pos
, bufpos
, region_beg
,
7676 region_end
, endptr
, base_face_id
, mouse_p
)
7680 int region_beg
, region_end
;
7682 enum face_id base_face_id
;
7685 Lisp_Object prop
, position
, end
, limit
;
7686 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
7687 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7688 struct face
*base_face
;
7689 int multibyte_p
= STRING_MULTIBYTE (string
);
7690 Lisp_Object prop_name
= mouse_p
? Qmouse_face
: Qface
;
7692 /* Get the value of the face property at the current position within
7693 STRING. Value is nil if there is no face property. */
7694 XSETFASTINT (position
, pos
);
7695 prop
= Fget_text_property (position
, prop_name
, string
);
7697 /* Get the next position at which to check for faces. Value of end
7698 is nil if face is constant all the way to the end of the string.
7699 Otherwise it is a string position where to check faces next.
7700 Limit is the maximum position up to which to check for property
7701 changes in Fnext_single_property_change. Strings are usually
7702 short, so set the limit to the end of the string. */
7703 XSETFASTINT (limit
, SCHARS (string
));
7704 end
= Fnext_single_property_change (position
, prop_name
, string
, limit
);
7706 *endptr
= XFASTINT (end
);
7710 base_face
= FACE_FROM_ID (f
, base_face_id
);
7711 xassert (base_face
);
7713 /* Optimize the default case that there is no face property and we
7714 are not in the region. */
7716 && (base_face_id
!= DEFAULT_FACE_ID
7717 /* BUFPOS <= 0 means STRING is not an overlay string, so
7718 that the region doesn't have to be taken into account. */
7720 || bufpos
< region_beg
7721 || bufpos
>= region_end
)
7723 /* We can't realize faces for different charsets differently
7724 if we don't have fonts, so we can stop here if not working
7725 on a window-system frame. */
7726 || !FRAME_WINDOW_P (f
)
7727 || FACE_SUITABLE_FOR_CHAR_P (base_face
, 0)))
7728 return base_face
->id
;
7730 /* Begin with attributes from the base face. */
7731 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
7733 /* Merge in attributes specified via text properties. */
7735 merge_face_ref (f
, prop
, attrs
, 1, 0);
7737 /* If in the region, merge in the region face. */
7739 && bufpos
>= region_beg
7740 && bufpos
< region_end
)
7741 merge_named_face (f
, Qregion
, attrs
, 0);
7743 /* Look up a realized face with the given face attributes,
7744 or realize a new one for ASCII characters. */
7745 return lookup_face (f
, attrs
, 0, NULL
);
7749 /* Merge a face into a realized face.
7751 F is frame where faces are (to be) realized.
7753 FACE_NAME is named face to merge.
7755 If FACE_NAME is nil, FACE_ID is face_id of realized face to merge.
7757 If FACE_NAME is t, FACE_ID is lface_id of face to merge.
7759 BASE_FACE_ID is realized face to merge into.
7765 merge_faces (f
, face_name
, face_id
, base_face_id
)
7767 Lisp_Object face_name
;
7768 int face_id
, base_face_id
;
7770 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7771 struct face
*base_face
;
7773 base_face
= FACE_FROM_ID (f
, base_face_id
);
7775 return base_face_id
;
7777 if (EQ (face_name
, Qt
))
7779 if (face_id
< 0 || face_id
>= lface_id_to_name_size
)
7780 return base_face_id
;
7781 face_name
= lface_id_to_name
[face_id
];
7782 face_id
= lookup_derived_face (f
, face_name
, 0, base_face_id
, 1);
7785 return base_face_id
;
7788 /* Begin with attributes from the base face. */
7789 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
7791 if (!NILP (face_name
))
7793 if (!merge_named_face (f
, face_name
, attrs
, 0))
7794 return base_face_id
;
7800 return base_face_id
;
7801 face
= FACE_FROM_ID (f
, face_id
);
7803 return base_face_id
;
7804 merge_face_vectors (f
, face
->lface
, attrs
, 0);
7807 /* Look up a realized face with the given face attributes,
7808 or realize a new one for ASCII characters. */
7809 return lookup_face (f
, attrs
, 0, NULL
);
7813 /***********************************************************************
7815 ***********************************************************************/
7819 /* Print the contents of the realized face FACE to stderr. */
7822 dump_realized_face (face
)
7825 fprintf (stderr
, "ID: %d\n", face
->id
);
7826 #ifdef HAVE_X_WINDOWS
7827 fprintf (stderr
, "gc: %ld\n", (long) face
->gc
);
7829 fprintf (stderr
, "foreground: 0x%lx (%s)\n",
7831 SDATA (face
->lface
[LFACE_FOREGROUND_INDEX
]));
7832 fprintf (stderr
, "background: 0x%lx (%s)\n",
7834 SDATA (face
->lface
[LFACE_BACKGROUND_INDEX
]));
7835 fprintf (stderr
, "font_name: %s (%s)\n",
7837 SDATA (face
->lface
[LFACE_FAMILY_INDEX
]));
7838 #ifdef HAVE_X_WINDOWS
7839 fprintf (stderr
, "font = %p\n", face
->font
);
7841 fprintf (stderr
, "font_info_id = %d\n", face
->font_info_id
);
7842 fprintf (stderr
, "fontset: %d\n", face
->fontset
);
7843 fprintf (stderr
, "underline: %d (%s)\n",
7845 SDATA (Fsymbol_name (face
->lface
[LFACE_UNDERLINE_INDEX
])));
7846 fprintf (stderr
, "hash: %d\n", face
->hash
);
7847 fprintf (stderr
, "charset: %d\n", face
->charset
);
7851 DEFUN ("dump-face", Fdump_face
, Sdump_face
, 0, 1, 0, doc
: /* */)
7859 fprintf (stderr
, "font selection order: ");
7860 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
7861 fprintf (stderr
, "%d ", font_sort_order
[i
]);
7862 fprintf (stderr
, "\n");
7864 fprintf (stderr
, "alternative fonts: ");
7865 debug_print (Vface_alternative_font_family_alist
);
7866 fprintf (stderr
, "\n");
7868 for (i
= 0; i
< FRAME_FACE_CACHE (SELECTED_FRAME ())->used
; ++i
)
7869 Fdump_face (make_number (i
));
7875 face
= FACE_FROM_ID (SELECTED_FRAME (), XINT (n
));
7877 error ("Not a valid face");
7878 dump_realized_face (face
);
7885 DEFUN ("show-face-resources", Fshow_face_resources
, Sshow_face_resources
,
7886 0, 0, 0, doc
: /* */)
7889 fprintf (stderr
, "number of colors = %d\n", ncolors_allocated
);
7890 fprintf (stderr
, "number of pixmaps = %d\n", npixmaps_allocated
);
7891 fprintf (stderr
, "number of GCs = %d\n", ngcs
);
7895 #endif /* GLYPH_DEBUG != 0 */
7899 /***********************************************************************
7901 ***********************************************************************/
7906 Qface
= intern ("face");
7908 Qface_no_inherit
= intern ("face-no-inherit");
7909 staticpro (&Qface_no_inherit
);
7910 Qbitmap_spec_p
= intern ("bitmap-spec-p");
7911 staticpro (&Qbitmap_spec_p
);
7912 Qframe_update_face_colors
= intern ("frame-update-face-colors");
7913 staticpro (&Qframe_update_face_colors
);
7915 /* Lisp face attribute keywords. */
7916 QCfamily
= intern (":family");
7917 staticpro (&QCfamily
);
7918 QCheight
= intern (":height");
7919 staticpro (&QCheight
);
7920 QCweight
= intern (":weight");
7921 staticpro (&QCweight
);
7922 QCslant
= intern (":slant");
7923 staticpro (&QCslant
);
7924 QCunderline
= intern (":underline");
7925 staticpro (&QCunderline
);
7926 QCinverse_video
= intern (":inverse-video");
7927 staticpro (&QCinverse_video
);
7928 QCreverse_video
= intern (":reverse-video");
7929 staticpro (&QCreverse_video
);
7930 QCforeground
= intern (":foreground");
7931 staticpro (&QCforeground
);
7932 QCbackground
= intern (":background");
7933 staticpro (&QCbackground
);
7934 QCstipple
= intern (":stipple");;
7935 staticpro (&QCstipple
);
7936 QCwidth
= intern (":width");
7937 staticpro (&QCwidth
);
7938 QCfont
= intern (":font");
7939 staticpro (&QCfont
);
7940 QCbold
= intern (":bold");
7941 staticpro (&QCbold
);
7942 QCitalic
= intern (":italic");
7943 staticpro (&QCitalic
);
7944 QCoverline
= intern (":overline");
7945 staticpro (&QCoverline
);
7946 QCstrike_through
= intern (":strike-through");
7947 staticpro (&QCstrike_through
);
7948 QCbox
= intern (":box");
7950 QCinherit
= intern (":inherit");
7951 staticpro (&QCinherit
);
7953 /* Symbols used for Lisp face attribute values. */
7954 QCcolor
= intern (":color");
7955 staticpro (&QCcolor
);
7956 QCline_width
= intern (":line-width");
7957 staticpro (&QCline_width
);
7958 QCstyle
= intern (":style");
7959 staticpro (&QCstyle
);
7960 Qreleased_button
= intern ("released-button");
7961 staticpro (&Qreleased_button
);
7962 Qpressed_button
= intern ("pressed-button");
7963 staticpro (&Qpressed_button
);
7964 Qnormal
= intern ("normal");
7965 staticpro (&Qnormal
);
7966 Qultra_light
= intern ("ultra-light");
7967 staticpro (&Qultra_light
);
7968 Qextra_light
= intern ("extra-light");
7969 staticpro (&Qextra_light
);
7970 Qlight
= intern ("light");
7971 staticpro (&Qlight
);
7972 Qsemi_light
= intern ("semi-light");
7973 staticpro (&Qsemi_light
);
7974 Qsemi_bold
= intern ("semi-bold");
7975 staticpro (&Qsemi_bold
);
7976 Qbold
= intern ("bold");
7978 Qextra_bold
= intern ("extra-bold");
7979 staticpro (&Qextra_bold
);
7980 Qultra_bold
= intern ("ultra-bold");
7981 staticpro (&Qultra_bold
);
7982 Qoblique
= intern ("oblique");
7983 staticpro (&Qoblique
);
7984 Qitalic
= intern ("italic");
7985 staticpro (&Qitalic
);
7986 Qreverse_oblique
= intern ("reverse-oblique");
7987 staticpro (&Qreverse_oblique
);
7988 Qreverse_italic
= intern ("reverse-italic");
7989 staticpro (&Qreverse_italic
);
7990 Qultra_condensed
= intern ("ultra-condensed");
7991 staticpro (&Qultra_condensed
);
7992 Qextra_condensed
= intern ("extra-condensed");
7993 staticpro (&Qextra_condensed
);
7994 Qcondensed
= intern ("condensed");
7995 staticpro (&Qcondensed
);
7996 Qsemi_condensed
= intern ("semi-condensed");
7997 staticpro (&Qsemi_condensed
);
7998 Qsemi_expanded
= intern ("semi-expanded");
7999 staticpro (&Qsemi_expanded
);
8000 Qexpanded
= intern ("expanded");
8001 staticpro (&Qexpanded
);
8002 Qextra_expanded
= intern ("extra-expanded");
8003 staticpro (&Qextra_expanded
);
8004 Qultra_expanded
= intern ("ultra-expanded");
8005 staticpro (&Qultra_expanded
);
8006 Qbackground_color
= intern ("background-color");
8007 staticpro (&Qbackground_color
);
8008 Qforeground_color
= intern ("foreground-color");
8009 staticpro (&Qforeground_color
);
8010 Qunspecified
= intern ("unspecified");
8011 staticpro (&Qunspecified
);
8013 Qface_alias
= intern ("face-alias");
8014 staticpro (&Qface_alias
);
8015 Qdefault
= intern ("default");
8016 staticpro (&Qdefault
);
8017 Qtool_bar
= intern ("tool-bar");
8018 staticpro (&Qtool_bar
);
8019 Qregion
= intern ("region");
8020 staticpro (&Qregion
);
8021 Qfringe
= intern ("fringe");
8022 staticpro (&Qfringe
);
8023 Qheader_line
= intern ("header-line");
8024 staticpro (&Qheader_line
);
8025 Qscroll_bar
= intern ("scroll-bar");
8026 staticpro (&Qscroll_bar
);
8027 Qmenu
= intern ("menu");
8029 Qcursor
= intern ("cursor");
8030 staticpro (&Qcursor
);
8031 Qborder
= intern ("border");
8032 staticpro (&Qborder
);
8033 Qmouse
= intern ("mouse");
8034 staticpro (&Qmouse
);
8035 Qmode_line_inactive
= intern ("mode-line-inactive");
8036 staticpro (&Qmode_line_inactive
);
8037 Qtty_color_desc
= intern ("tty-color-desc");
8038 staticpro (&Qtty_color_desc
);
8039 Qtty_color_standard_values
= intern ("tty-color-standard-values");
8040 staticpro (&Qtty_color_standard_values
);
8041 Qtty_color_by_index
= intern ("tty-color-by-index");
8042 staticpro (&Qtty_color_by_index
);
8043 Qtty_color_alist
= intern ("tty-color-alist");
8044 staticpro (&Qtty_color_alist
);
8045 Qscalable_fonts_allowed
= intern ("scalable-fonts-allowed");
8046 staticpro (&Qscalable_fonts_allowed
);
8048 Vparam_value_alist
= Fcons (Fcons (Qnil
, Qnil
), Qnil
);
8049 staticpro (&Vparam_value_alist
);
8050 Vface_alternative_font_family_alist
= Qnil
;
8051 staticpro (&Vface_alternative_font_family_alist
);
8052 Vface_alternative_font_registry_alist
= Qnil
;
8053 staticpro (&Vface_alternative_font_registry_alist
);
8055 defsubr (&Sinternal_make_lisp_face
);
8056 defsubr (&Sinternal_lisp_face_p
);
8057 defsubr (&Sinternal_set_lisp_face_attribute
);
8058 #ifdef HAVE_WINDOW_SYSTEM
8059 defsubr (&Sinternal_set_lisp_face_attribute_from_resource
);
8061 defsubr (&Scolor_gray_p
);
8062 defsubr (&Scolor_supported_p
);
8063 defsubr (&Sface_attribute_relative_p
);
8064 defsubr (&Smerge_face_attribute
);
8065 defsubr (&Sinternal_get_lisp_face_attribute
);
8066 defsubr (&Sinternal_lisp_face_attribute_values
);
8067 defsubr (&Sinternal_lisp_face_equal_p
);
8068 defsubr (&Sinternal_lisp_face_empty_p
);
8069 defsubr (&Sinternal_copy_lisp_face
);
8070 defsubr (&Sinternal_merge_in_global_face
);
8071 defsubr (&Sface_font
);
8072 defsubr (&Sframe_face_alist
);
8073 defsubr (&Sdisplay_supports_face_attributes_p
);
8074 defsubr (&Scolor_distance
);
8075 defsubr (&Sinternal_set_font_selection_order
);
8076 defsubr (&Sinternal_set_alternative_font_family_alist
);
8077 defsubr (&Sinternal_set_alternative_font_registry_alist
);
8078 defsubr (&Sface_attributes_as_vector
);
8080 defsubr (&Sdump_face
);
8081 defsubr (&Sshow_face_resources
);
8082 #endif /* GLYPH_DEBUG */
8083 defsubr (&Sclear_face_cache
);
8084 defsubr (&Stty_suppress_bold_inverse_default_colors
);
8086 #if defined DEBUG_X_COLORS && defined HAVE_X_WINDOWS
8087 defsubr (&Sdump_colors
);
8090 DEFVAR_LISP ("font-list-limit", &Vfont_list_limit
,
8091 doc
: /* *Limit for font matching.
8092 If an integer > 0, font matching functions won't load more than
8093 that number of fonts when searching for a matching font. */);
8094 Vfont_list_limit
= make_number (DEFAULT_FONT_LIST_LIMIT
);
8096 DEFVAR_LISP ("face-new-frame-defaults", &Vface_new_frame_defaults
,
8097 doc
: /* List of global face definitions (for internal use only.) */);
8098 Vface_new_frame_defaults
= Qnil
;
8100 DEFVAR_LISP ("face-default-stipple", &Vface_default_stipple
,
8101 doc
: /* *Default stipple pattern used on monochrome displays.
8102 This stipple pattern is used on monochrome displays
8103 instead of shades of gray for a face background color.
8104 See `set-face-stipple' for possible values for this variable. */);
8105 Vface_default_stipple
= build_string ("gray3");
8107 DEFVAR_LISP ("tty-defined-color-alist", &Vtty_defined_color_alist
,
8108 doc
: /* An alist of defined terminal colors and their RGB values. */);
8109 Vtty_defined_color_alist
= Qnil
;
8111 DEFVAR_LISP ("scalable-fonts-allowed", &Vscalable_fonts_allowed
,
8112 doc
: /* Allowed scalable fonts.
8113 A value of nil means don't allow any scalable fonts.
8114 A value of t means allow any scalable font.
8115 Otherwise, value must be a list of regular expressions. A font may be
8116 scaled if its name matches a regular expression in the list.
8117 Note that if value is nil, a scalable font might still be used, if no
8118 other font of the appropriate family and registry is available. */);
8119 Vscalable_fonts_allowed
= Qnil
;
8121 DEFVAR_LISP ("face-ignored-fonts", &Vface_ignored_fonts
,
8122 doc
: /* List of ignored fonts.
8123 Each element is a regular expression that matches names of fonts to
8125 Vface_ignored_fonts
= Qnil
;
8127 DEFVAR_LISP ("face-font-rescale-alist", &Vface_font_rescale_alist
,
8128 doc
: /* Alist of fonts vs the rescaling factors.
8129 Each element is a cons (FONT-NAME-PATTERN . RESCALE-RATIO), where
8130 FONT-NAME-PATTERN is a regular expression matching a font name, and
8131 RESCALE-RATIO is a floating point number to specify how much larger
8132 \(or smaller) font we should use. For instance, if a face requests
8133 a font of 10 point, we actually use a font of 10 * RESCALE-RATIO point. */);
8134 Vface_font_rescale_alist
= Qnil
;
8136 #ifdef HAVE_WINDOW_SYSTEM
8137 defsubr (&Sbitmap_spec_p
);
8138 defsubr (&Sx_list_fonts
);
8139 defsubr (&Sinternal_face_x_get_resource
);
8140 defsubr (&Sx_family_fonts
);
8141 defsubr (&Sx_font_family_list
);
8142 #endif /* HAVE_WINDOW_SYSTEM */
8145 /* arch-tag: 8a0f7598-5517-408d-9ab3-1da6fcd4c749
8146 (do not change this comment) */