1 /* xfaces.c -- "Face" primitives.
2 Copyright (C) 1993, 1994, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
3 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3, or (at your option)
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
20 Boston, MA 02110-1301, USA. */
22 /* New face implementation by Gerd Moellmann <gerd@gnu.org>. */
26 When using Emacs with X, the display style of characters can be
27 changed by defining `faces'. Each face can specify the following
32 2. Relative proportionate width, aka character set width or set
33 width (swidth), e.g. `semi-compressed'.
35 3. Font height in 1/10pt.
37 4. Font weight, e.g. `bold'.
39 5. Font slant, e.g. `italic'.
45 8. Whether or not characters should be underlined, and in what color.
47 9. Whether or not characters should be displayed in inverse video.
49 10. A background stipple, a bitmap.
51 11. Whether or not characters should be overlined, and in what color.
53 12. Whether or not characters should be strike-through, and in what
56 13. Whether or not a box should be drawn around characters, the box
57 type, and, for simple boxes, in what color.
59 14. Font pattern, or nil. This is a special attribute.
60 When this attribute is specified, the face uses a font opened by
61 that pattern as is. In addition, all the other font-related
62 attributes (1st thru 5th) are generated from the opened font name.
63 On the other hand, if one of the other font-related attributes are
64 specified, this attribute is set to nil. In that case, the face
65 doesn't inherit this attribute from the `default' face, and uses a
66 font determined by the other attributes (those may be inherited
67 from the `default' face).
69 15. A face name or list of face names from which to inherit attributes.
71 16. A specified average font width, which is invisible from Lisp,
72 and is used to ensure that a font specified on the command line,
73 for example, can be matched exactly.
77 Faces are frame-local by nature because Emacs allows to define the
78 same named face (face names are symbols) differently for different
79 frames. Each frame has an alist of face definitions for all named
80 faces. The value of a named face in such an alist is a Lisp vector
81 with the symbol `face' in slot 0, and a slot for each of the face
82 attributes mentioned above.
84 There is also a global face alist `Vface_new_frame_defaults'. Face
85 definitions from this list are used to initialize faces of newly
88 A face doesn't have to specify all attributes. Those not specified
89 have a value of `unspecified'. Faces specifying all attributes but
90 the 14th are called `fully-specified'.
95 The display style of a given character in the text is determined by
96 combining several faces. This process is called `face merging'.
97 Any aspect of the display style that isn't specified by overlays or
98 text properties is taken from the `default' face. Since it is made
99 sure that the default face is always fully-specified, face merging
100 always results in a fully-specified face.
105 After all face attributes for a character have been determined by
106 merging faces of that character, that face is `realized'. The
107 realization process maps face attributes to what is physically
108 available on the system where Emacs runs. The result is a
109 `realized face' in form of a struct face which is stored in the
110 face cache of the frame on which it was realized.
112 Face realization is done in the context of the character to display
113 because different fonts may be used for different characters. In
114 other words, for characters that have different font
115 specifications, different realized faces are needed to display
118 Font specification is done by fontsets. See the comment in
119 fontset.c for the details. In the current implementation, all ASCII
120 characters share the same font in a fontset.
122 Faces are at first realized for ASCII characters, and, at that
123 time, assigned a specific realized fontset. Hereafter, we call
124 such a face as `ASCII face'. When a face for a multibyte character
125 is realized, it inherits (thus shares) a fontset of an ASCII face
126 that has the same attributes other than font-related ones.
128 Thus, all realized faces have a realized fontset.
133 Unibyte text (i.e. raw 8-bit characters) is displayed with the same
134 font as ASCII characters. That is because it is expected that
135 unibyte text users specify a font that is suitable both for ASCII
136 and raw 8-bit characters.
141 Font selection tries to find the best available matching font for a
142 given (character, face) combination.
144 If the face specifies a fontset name, that fontset determines a
145 pattern for fonts of the given character. If the face specifies a
146 font name or the other font-related attributes, a fontset is
147 realized from the default fontset. In that case, that
148 specification determines a pattern for ASCII characters and the
149 default fontset determines a pattern for multibyte characters.
151 Available fonts on the system on which Emacs runs are then matched
152 against the font pattern. The result of font selection is the best
153 match for the given face attributes in this font list.
155 Font selection can be influenced by the user.
157 1. The user can specify the relative importance he gives the face
158 attributes width, height, weight, and slant by setting
159 face-font-selection-order (faces.el) to a list of face attribute
160 names. The default is '(:width :height :weight :slant), and means
161 that font selection first tries to find a good match for the font
162 width specified by a face, then---within fonts with that
163 width---tries to find a best match for the specified font height,
166 2. Setting face-font-family-alternatives allows the user to
167 specify alternative font families to try if a family specified by a
170 3. Setting face-font-registry-alternatives allows the user to
171 specify all alternative font registries to try for a face
172 specifying a registry.
174 4. Setting face-ignored-fonts allows the user to ignore specific
178 Character composition.
180 Usually, the realization process is already finished when Emacs
181 actually reflects the desired glyph matrix on the screen. However,
182 on displaying a composition (sequence of characters to be composed
183 on the screen), a suitable font for the components of the
184 composition is selected and realized while drawing them on the
185 screen, i.e. the realization process is delayed but in principle
189 Initialization of basic faces.
191 The faces `default', `modeline' are considered `basic faces'.
192 When redisplay happens the first time for a newly created frame,
193 basic faces are realized for CHARSET_ASCII. Frame parameters are
194 used to fill in unspecified attributes of the default face. */
198 #include <sys/types.h>
199 #include <sys/stat.h>
200 #include <stdio.h> /* This needs to be before termchar.h */
203 #include "character.h"
205 #include "keyboard.h"
207 #include "termhooks.h"
209 #ifdef HAVE_WINDOW_SYSTEM
211 #endif /* HAVE_WINDOW_SYSTEM */
213 #ifdef HAVE_X_WINDOWS
217 #include <Xm/XmStrDefs.h>
218 #endif /* USE_MOTIF */
219 #endif /* HAVE_X_WINDOWS */
228 /* Redefine X specifics to W32 equivalents to avoid cluttering the
229 code with #ifdef blocks. */
230 #undef FRAME_X_DISPLAY_INFO
231 #define FRAME_X_DISPLAY_INFO FRAME_W32_DISPLAY_INFO
232 #define x_display_info w32_display_info
233 #define FRAME_X_FONT_TABLE FRAME_W32_FONT_TABLE
234 #define check_x check_w32
235 #define x_list_fonts w32_list_fonts
236 #define GCGraphicsExposures 0
237 #endif /* WINDOWSNT */
241 #define x_display_info mac_display_info
242 #define check_x check_mac
246 #include "dispextern.h"
247 #include "blockinput.h"
249 #include "intervals.h"
250 #include "termchar.h"
252 #ifdef HAVE_WINDOW_SYSTEM
254 #endif /* HAVE_WINDOW_SYSTEM */
256 #ifdef HAVE_X_WINDOWS
258 /* Compensate for a bug in Xos.h on some systems, on which it requires
259 time.h. On some such systems, Xos.h tries to redefine struct
260 timeval and struct timezone if USG is #defined while it is
263 #ifdef XOS_NEEDS_TIME_H
269 #else /* not XOS_NEEDS_TIME_H */
271 #endif /* not XOS_NEEDS_TIME_H */
273 #endif /* HAVE_X_WINDOWS */
277 /* Number of pt per inch (from the TeXbook). */
279 #define PT_PER_INCH 72.27
281 /* Non-zero if face attribute ATTR is unspecified. */
283 #define UNSPECIFIEDP(ATTR) EQ ((ATTR), Qunspecified)
285 /* Non-zero if face attribute ATTR is `ignore-defface'. */
287 #define IGNORE_DEFFACE_P(ATTR) EQ ((ATTR), Qignore_defface)
289 /* Value is the number of elements of VECTOR. */
291 #define DIM(VECTOR) (sizeof (VECTOR) / sizeof *(VECTOR))
293 /* Make a copy of string S on the stack using alloca. Value is a pointer
296 #define STRDUPA(S) strcpy ((char *) alloca (strlen ((S)) + 1), (S))
298 /* Make a copy of the contents of Lisp string S on the stack using
299 alloca. Value is a pointer to the copy. */
301 #define LSTRDUPA(S) STRDUPA (SDATA ((S)))
303 /* Size of hash table of realized faces in face caches (should be a
306 #define FACE_CACHE_BUCKETS_SIZE 1001
308 /* Keyword symbols used for face attribute names. */
310 Lisp_Object QCfamily
, QCheight
, QCweight
, QCslant
, QCunderline
;
311 Lisp_Object QCinverse_video
, QCforeground
, QCbackground
, QCstipple
;
312 Lisp_Object QCwidth
, QCfont
, QCbold
, QCitalic
;
313 Lisp_Object QCreverse_video
;
314 Lisp_Object QCoverline
, QCstrike_through
, QCbox
, QCinherit
;
315 Lisp_Object QCfontset
;
317 /* Symbols used for attribute values. */
319 Lisp_Object Qnormal
, Qbold
, Qultra_light
, Qextra_light
, Qlight
;
320 Lisp_Object Qsemi_light
, Qsemi_bold
, Qextra_bold
, Qultra_bold
;
321 Lisp_Object Qoblique
, Qitalic
, Qreverse_oblique
, Qreverse_italic
;
322 Lisp_Object Qultra_condensed
, Qextra_condensed
, Qcondensed
;
323 Lisp_Object Qsemi_condensed
, Qsemi_expanded
, Qexpanded
, Qextra_expanded
;
324 Lisp_Object Qultra_expanded
;
325 Lisp_Object Qreleased_button
, Qpressed_button
;
326 Lisp_Object QCstyle
, QCcolor
, QCline_width
;
327 Lisp_Object Qunspecified
;
328 Lisp_Object Qignore_defface
;
330 char unspecified_fg
[] = "unspecified-fg", unspecified_bg
[] = "unspecified-bg";
332 /* The name of the function to call when the background of the frame
333 has changed, frame_set_background_mode. */
335 Lisp_Object Qframe_set_background_mode
;
337 /* Names of basic faces. */
339 Lisp_Object Qdefault
, Qtool_bar
, Qregion
, Qfringe
;
340 Lisp_Object Qheader_line
, Qscroll_bar
, Qcursor
, Qborder
, Qmouse
, Qmenu
;
341 Lisp_Object Qmode_line_inactive
, Qvertical_border
;
342 extern Lisp_Object Qmode_line
;
344 /* The symbol `face-alias'. A symbols having that property is an
345 alias for another face. Value of the property is the name of
348 Lisp_Object Qface_alias
;
350 extern Lisp_Object Qcircular_list
;
352 /* Default stipple pattern used on monochrome displays. This stipple
353 pattern is used on monochrome displays instead of shades of gray
354 for a face background color. See `set-face-stipple' for possible
355 values for this variable. */
357 Lisp_Object Vface_default_stipple
;
359 /* Alist of alternative font families. Each element is of the form
360 (FAMILY FAMILY1 FAMILY2 ...). If fonts of FAMILY can't be loaded,
361 try FAMILY1, then FAMILY2, ... */
363 Lisp_Object Vface_alternative_font_family_alist
;
365 /* Alist of alternative font registries. Each element is of the form
366 (REGISTRY REGISTRY1 REGISTRY2...). If fonts of REGISTRY can't be
367 loaded, try REGISTRY1, then REGISTRY2, ... */
369 Lisp_Object Vface_alternative_font_registry_alist
;
371 /* Allowed scalable fonts. A value of nil means don't allow any
372 scalable fonts. A value of t means allow the use of any scalable
373 font. Otherwise, value must be a list of regular expressions. A
374 font may be scaled if its name matches a regular expression in the
377 Lisp_Object Vscalable_fonts_allowed
, Qscalable_fonts_allowed
;
379 /* List of regular expressions that matches names of fonts to ignore. */
381 Lisp_Object Vface_ignored_fonts
;
383 /* Alist of font name patterns vs the rescaling factor. */
385 Lisp_Object Vface_font_rescale_alist
;
387 /* Maximum number of fonts to consider in font_list. If not an
388 integer > 0, DEFAULT_FONT_LIST_LIMIT is used instead. */
390 Lisp_Object Vfont_list_limit
;
391 #define DEFAULT_FONT_LIST_LIMIT 100
393 /* The symbols `foreground-color' and `background-color' which can be
394 used as part of a `face' property. This is for compatibility with
397 Lisp_Object Qforeground_color
, Qbackground_color
;
399 /* The symbols `face' and `mouse-face' used as text properties. */
402 extern Lisp_Object Qmouse_face
;
404 /* Property for basic faces which other faces cannot inherit. */
406 Lisp_Object Qface_no_inherit
;
408 /* Error symbol for wrong_type_argument in load_pixmap. */
410 Lisp_Object Qbitmap_spec_p
;
412 /* Alist of global face definitions. Each element is of the form
413 (FACE . LFACE) where FACE is a symbol naming a face and LFACE
414 is a Lisp vector of face attributes. These faces are used
415 to initialize faces for new frames. */
417 Lisp_Object Vface_new_frame_defaults
;
419 /* The next ID to assign to Lisp faces. */
421 static int next_lface_id
;
423 /* A vector mapping Lisp face Id's to face names. */
425 static Lisp_Object
*lface_id_to_name
;
426 static int lface_id_to_name_size
;
428 /* TTY color-related functions (defined in tty-colors.el). */
430 Lisp_Object Qtty_color_desc
, Qtty_color_by_index
, Qtty_color_standard_values
;
432 /* The name of the function used to compute colors on TTYs. */
434 Lisp_Object Qtty_color_alist
;
436 /* An alist of defined terminal colors and their RGB values. */
438 Lisp_Object Vtty_defined_color_alist
;
440 /* Counter for calls to clear_face_cache. If this counter reaches
441 CLEAR_FONT_TABLE_COUNT, and a frame has more than
442 CLEAR_FONT_TABLE_NFONTS load, unused fonts are freed. */
444 static int clear_font_table_count
;
445 #define CLEAR_FONT_TABLE_COUNT 100
446 #define CLEAR_FONT_TABLE_NFONTS 10
448 /* Non-zero means face attributes have been changed since the last
449 redisplay. Used in redisplay_internal. */
451 int face_change_count
;
453 /* Non-zero means don't display bold text if a face's foreground
454 and background colors are the inverse of the default colors of the
455 display. This is a kluge to suppress `bold black' foreground text
456 which is hard to read on an LCD monitor. */
458 int tty_suppress_bold_inverse_default_colors_p
;
460 /* A list of the form `((x . y))' used to avoid consing in
461 Finternal_set_lisp_face_attribute. */
463 static Lisp_Object Vparam_value_alist
;
465 /* The total number of colors currently allocated. */
468 static int ncolors_allocated
;
469 static int npixmaps_allocated
;
473 /* Non-zero means the definition of the `menu' face for new frames has
476 int menu_face_changed_default
;
479 /* Function prototypes. */
483 struct named_merge_point
;
485 static void map_tty_color
P_ ((struct frame
*, struct face
*,
486 enum lface_attribute_index
, int *));
487 static Lisp_Object resolve_face_name
P_ ((Lisp_Object
, int));
488 static int may_use_scalable_font_p
P_ ((const char *));
489 static void set_font_frame_param
P_ ((Lisp_Object
, Lisp_Object
));
490 static int better_font_p
P_ ((int *, struct font_name
*, struct font_name
*,
492 static int x_face_list_fonts
P_ ((struct frame
*, char *,
493 struct font_name
**, int, int));
494 static int font_scalable_p
P_ ((struct font_name
*));
495 static int get_lface_attributes
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*, int));
496 static int load_pixmap
P_ ((struct frame
*, Lisp_Object
, unsigned *, unsigned *));
497 static unsigned char *xstrlwr
P_ ((unsigned char *));
498 static struct frame
*frame_or_selected_frame
P_ ((Lisp_Object
, int));
499 static void load_face_font
P_ ((struct frame
*, struct face
*));
500 static void load_face_colors
P_ ((struct frame
*, struct face
*, Lisp_Object
*));
501 static void free_face_colors
P_ ((struct frame
*, struct face
*));
502 static int face_color_gray_p
P_ ((struct frame
*, char *));
503 static char *build_font_name
P_ ((struct font_name
*));
504 static void free_font_names
P_ ((struct font_name
*, int));
505 static int sorted_font_list
P_ ((struct frame
*, char *,
506 int (*cmpfn
) P_ ((const void *, const void *)),
507 struct font_name
**));
508 static int font_list_1
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
509 Lisp_Object
, struct font_name
**));
510 static int font_list
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
511 Lisp_Object
, struct font_name
**));
512 static int try_font_list
P_ ((struct frame
*, Lisp_Object
,
513 Lisp_Object
, Lisp_Object
, struct font_name
**));
514 static int try_alternative_families
P_ ((struct frame
*f
, Lisp_Object
,
515 Lisp_Object
, struct font_name
**));
516 static int cmp_font_names
P_ ((const void *, const void *));
517 static struct face
*realize_face
P_ ((struct face_cache
*, Lisp_Object
*,
519 static struct face
*realize_non_ascii_face
P_ ((struct frame
*, int,
521 static struct face
*realize_x_face
P_ ((struct face_cache
*, Lisp_Object
*));
522 static struct face
*realize_tty_face
P_ ((struct face_cache
*, Lisp_Object
*));
523 static int realize_basic_faces
P_ ((struct frame
*));
524 static int realize_default_face
P_ ((struct frame
*));
525 static void realize_named_face
P_ ((struct frame
*, Lisp_Object
, int));
526 static int lface_fully_specified_p
P_ ((Lisp_Object
*));
527 static int lface_equal_p
P_ ((Lisp_Object
*, Lisp_Object
*));
528 static unsigned hash_string_case_insensitive
P_ ((Lisp_Object
));
529 static unsigned lface_hash
P_ ((Lisp_Object
*));
530 static int lface_same_font_attributes_p
P_ ((Lisp_Object
*, Lisp_Object
*));
531 static struct face_cache
*make_face_cache
P_ ((struct frame
*));
532 static void clear_face_gcs
P_ ((struct face_cache
*));
533 static void free_face_cache
P_ ((struct face_cache
*));
534 static int face_numeric_weight
P_ ((Lisp_Object
));
535 static int face_numeric_slant
P_ ((Lisp_Object
));
536 static int face_numeric_swidth
P_ ((Lisp_Object
));
537 static int face_fontset
P_ ((Lisp_Object
*));
538 static void merge_face_vectors
P_ ((struct frame
*, Lisp_Object
*, Lisp_Object
*,
539 struct named_merge_point
*));
540 static int merge_face_ref
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*,
541 int, struct named_merge_point
*));
542 static int set_lface_from_font_name
P_ ((struct frame
*, Lisp_Object
,
543 Lisp_Object
, int, int));
544 static void set_lface_from_font_and_fontset
P_ ((struct frame
*, Lisp_Object
,
545 Lisp_Object
, int, int));
546 static Lisp_Object lface_from_face_name
P_ ((struct frame
*, Lisp_Object
, int));
547 static struct face
*make_realized_face
P_ ((Lisp_Object
*));
548 static char *best_matching_font
P_ ((struct frame
*, Lisp_Object
*,
549 struct font_name
*, int, int, int *));
550 static void cache_face
P_ ((struct face_cache
*, struct face
*, unsigned));
551 static void uncache_face
P_ ((struct face_cache
*, struct face
*));
552 static int xlfd_numeric_slant
P_ ((struct font_name
*));
553 static int xlfd_numeric_weight
P_ ((struct font_name
*));
554 static int xlfd_numeric_swidth
P_ ((struct font_name
*));
555 static Lisp_Object xlfd_symbolic_slant
P_ ((struct font_name
*));
556 static Lisp_Object xlfd_symbolic_weight
P_ ((struct font_name
*));
557 static Lisp_Object xlfd_symbolic_swidth
P_ ((struct font_name
*));
558 static int xlfd_fixed_p
P_ ((struct font_name
*));
559 static int xlfd_numeric_value
P_ ((struct table_entry
*, int, struct font_name
*,
561 static Lisp_Object xlfd_symbolic_value
P_ ((struct table_entry
*, int,
562 struct font_name
*, int,
564 static struct table_entry
*xlfd_lookup_field_contents
P_ ((struct table_entry
*, int,
565 struct font_name
*, int));
567 #ifdef HAVE_WINDOW_SYSTEM
569 static int split_font_name
P_ ((struct frame
*, struct font_name
*, int));
570 static int xlfd_point_size
P_ ((struct frame
*, struct font_name
*));
571 static void sort_fonts
P_ ((struct frame
*, struct font_name
*, int,
572 int (*cmpfn
) P_ ((const void *, const void *))));
573 static GC x_create_gc
P_ ((struct frame
*, unsigned long, XGCValues
*));
574 static void x_free_gc
P_ ((struct frame
*, GC
));
575 static void clear_font_table
P_ ((struct x_display_info
*));
578 extern Lisp_Object w32_list_fonts
P_ ((struct frame
*, Lisp_Object
, int, int));
579 #endif /* WINDOWSNT */
582 static void x_update_menu_appearance
P_ ((struct frame
*));
584 extern void free_frame_menubar
P_ ((struct frame
*));
585 #endif /* USE_X_TOOLKIT */
587 #endif /* HAVE_WINDOW_SYSTEM */
590 /***********************************************************************
592 ***********************************************************************/
594 #ifdef HAVE_X_WINDOWS
596 #ifdef DEBUG_X_COLORS
598 /* The following is a poor mans infrastructure for debugging X color
599 allocation problems on displays with PseudoColor-8. Some X servers
600 like 3.3.5 XF86_SVGA with Matrox cards apparently don't implement
601 color reference counts completely so that they don't signal an
602 error when a color is freed whose reference count is already 0.
603 Other X servers do. To help me debug this, the following code
604 implements a simple reference counting schema of its own, for a
605 single display/screen. --gerd. */
607 /* Reference counts for pixel colors. */
609 int color_count
[256];
611 /* Register color PIXEL as allocated. */
614 register_color (pixel
)
617 xassert (pixel
< 256);
618 ++color_count
[pixel
];
622 /* Register color PIXEL as deallocated. */
625 unregister_color (pixel
)
628 xassert (pixel
< 256);
629 if (color_count
[pixel
] > 0)
630 --color_count
[pixel
];
636 /* Register N colors from PIXELS as deallocated. */
639 unregister_colors (pixels
, n
)
640 unsigned long *pixels
;
644 for (i
= 0; i
< n
; ++i
)
645 unregister_color (pixels
[i
]);
649 DEFUN ("dump-colors", Fdump_colors
, Sdump_colors
, 0, 0, 0,
650 doc
: /* Dump currently allocated colors to stderr. */)
655 fputc ('\n', stderr
);
657 for (i
= n
= 0; i
< sizeof color_count
/ sizeof color_count
[0]; ++i
)
660 fprintf (stderr
, "%3d: %5d", i
, color_count
[i
]);
663 fputc ('\n', stderr
);
665 fputc ('\t', stderr
);
669 fputc ('\n', stderr
);
673 #endif /* DEBUG_X_COLORS */
676 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
677 color values. Interrupt input must be blocked when this function
681 x_free_colors (f
, pixels
, npixels
)
683 unsigned long *pixels
;
686 int class = FRAME_X_DISPLAY_INFO (f
)->visual
->class;
688 /* If display has an immutable color map, freeing colors is not
689 necessary and some servers don't allow it. So don't do it. */
690 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
692 #ifdef DEBUG_X_COLORS
693 unregister_colors (pixels
, npixels
);
695 XFreeColors (FRAME_X_DISPLAY (f
), FRAME_X_COLORMAP (f
),
701 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
702 color values. Interrupt input must be blocked when this function
706 x_free_dpy_colors (dpy
, screen
, cmap
, pixels
, npixels
)
710 unsigned long *pixels
;
713 struct x_display_info
*dpyinfo
= x_display_info_for_display (dpy
);
714 int class = dpyinfo
->visual
->class;
716 /* If display has an immutable color map, freeing colors is not
717 necessary and some servers don't allow it. So don't do it. */
718 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
720 #ifdef DEBUG_X_COLORS
721 unregister_colors (pixels
, npixels
);
723 XFreeColors (dpy
, cmap
, pixels
, npixels
, 0);
728 /* Create and return a GC for use on frame F. GC values and mask
729 are given by XGCV and MASK. */
732 x_create_gc (f
, mask
, xgcv
)
739 gc
= XCreateGC (FRAME_X_DISPLAY (f
), FRAME_X_WINDOW (f
), mask
, xgcv
);
746 /* Free GC which was used on frame F. */
753 eassert (interrupt_input_blocked
);
754 IF_DEBUG (xassert (--ngcs
>= 0));
755 XFreeGC (FRAME_X_DISPLAY (f
), gc
);
758 #endif /* HAVE_X_WINDOWS */
761 /* W32 emulation of GCs */
764 x_create_gc (f
, mask
, xgcv
)
771 gc
= XCreateGC (NULL
, FRAME_W32_WINDOW (f
), mask
, xgcv
);
778 /* Free GC which was used on frame F. */
785 IF_DEBUG (xassert (--ngcs
>= 0));
789 #endif /* WINDOWSNT */
792 /* Mac OS emulation of GCs */
795 x_create_gc (f
, mask
, xgcv
)
802 gc
= XCreateGC (FRAME_MAC_DISPLAY (f
), FRAME_MAC_WINDOW (f
), mask
, xgcv
);
813 eassert (interrupt_input_blocked
);
814 IF_DEBUG (xassert (--ngcs
>= 0));
815 XFreeGC (FRAME_MAC_DISPLAY (f
), gc
);
820 /* Like stricmp. Used to compare parts of font names which are in
825 const unsigned char *s1
, *s2
;
829 unsigned char c1
= tolower (*s1
);
830 unsigned char c2
= tolower (*s2
);
832 return c1
< c2
? -1 : 1;
837 return *s2
== 0 ? 0 : -1;
842 /* Like strlwr, which might not always be available. */
844 static unsigned char *
848 unsigned char *p
= s
;
851 /* On Mac OS X 10.3, tolower also converts non-ASCII characters
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 #ifdef USE_FONT_BACKEND
983 if (! enable_font_backend
)
984 #endif /* USE_FONT_BACKEND */
985 /* Fonts are common for frames on one display, i.e. on
987 for (dpyinfo
= x_display_list
; dpyinfo
; dpyinfo
= dpyinfo
->next
)
988 if (dpyinfo
->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
989 clear_font_table (dpyinfo
);
991 /* From time to time see if we can unload some fonts. This also
992 frees all realized faces on all frames. Fonts needed by
993 faces will be loaded again when faces are realized again. */
994 clear_font_table_count
= 0;
996 FOR_EACH_FRAME (tail
, frame
)
998 struct frame
*f
= XFRAME (frame
);
999 if (FRAME_WINDOW_P (f
)
1000 && FRAME_X_DISPLAY_INFO (f
)->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
1001 free_all_realized_faces (frame
);
1006 /* Clear GCs of realized faces. */
1007 FOR_EACH_FRAME (tail
, frame
)
1010 if (FRAME_WINDOW_P (f
))
1012 clear_face_gcs (FRAME_FACE_CACHE (f
));
1013 clear_image_cache (f
, 0);
1017 #endif /* HAVE_WINDOW_SYSTEM */
1021 DEFUN ("clear-face-cache", Fclear_face_cache
, Sclear_face_cache
, 0, 1, 0,
1022 doc
: /* Clear face caches on all frames.
1023 Optional THOROUGHLY non-nil means try to free unused fonts, too. */)
1025 Lisp_Object thoroughly
;
1027 clear_face_cache (!NILP (thoroughly
));
1028 ++face_change_count
;
1029 ++windows_or_buffers_changed
;
1035 #ifdef HAVE_WINDOW_SYSTEM
1038 /* Remove fonts from the font table of DPYINFO except for the default
1039 ASCII fonts of frames on that display. Called from clear_face_cache
1040 from time to time. */
1043 clear_font_table (dpyinfo
)
1044 struct x_display_info
*dpyinfo
;
1048 /* Free those fonts that are not used by frames on DPYINFO. */
1049 for (i
= 0; i
< dpyinfo
->n_fonts
; ++i
)
1051 struct font_info
*font_info
= dpyinfo
->font_table
+ i
;
1052 Lisp_Object tail
, frame
;
1054 /* Check if slot is already free. */
1055 if (font_info
->name
== NULL
)
1058 /* Don't free a default font of some frame. */
1059 FOR_EACH_FRAME (tail
, frame
)
1061 struct frame
*f
= XFRAME (frame
);
1062 if (FRAME_WINDOW_P (f
)
1063 && font_info
->font
== FRAME_FONT (f
))
1071 if (font_info
->full_name
!= font_info
->name
)
1072 xfree (font_info
->full_name
);
1073 xfree (font_info
->name
);
1075 /* Free the font. */
1077 #ifdef HAVE_X_WINDOWS
1078 XFreeFont (dpyinfo
->display
, font_info
->font
);
1081 w32_unload_font (dpyinfo
, font_info
->font
);
1084 mac_unload_font (dpyinfo
, font_info
->font
);
1088 /* Mark font table slot free. */
1089 font_info
->font
= NULL
;
1090 font_info
->name
= font_info
->full_name
= NULL
;
1094 #endif /* HAVE_WINDOW_SYSTEM */
1098 /***********************************************************************
1100 ***********************************************************************/
1102 #ifdef HAVE_WINDOW_SYSTEM
1104 DEFUN ("bitmap-spec-p", Fbitmap_spec_p
, Sbitmap_spec_p
, 1, 1, 0,
1105 doc
: /* Value is non-nil if OBJECT is a valid bitmap specification.
1106 A bitmap specification is either a string, a file name, or a list
1107 \(WIDTH HEIGHT DATA) where WIDTH is the pixel width of the bitmap,
1108 HEIGHT is its height, and DATA is a string containing the bits of
1109 the pixmap. Bits are stored row by row, each row occupies
1110 \(WIDTH + 7)/8 bytes. */)
1116 if (STRINGP (object
))
1117 /* If OBJECT is a string, it's a file name. */
1119 else if (CONSP (object
))
1121 /* Otherwise OBJECT must be (WIDTH HEIGHT DATA), WIDTH and
1122 HEIGHT must be integers > 0, and DATA must be string large
1123 enough to hold a bitmap of the specified size. */
1124 Lisp_Object width
, height
, data
;
1126 height
= width
= data
= Qnil
;
1130 width
= XCAR (object
);
1131 object
= XCDR (object
);
1134 height
= XCAR (object
);
1135 object
= XCDR (object
);
1137 data
= XCAR (object
);
1141 if (NATNUMP (width
) && NATNUMP (height
) && STRINGP (data
))
1143 int bytes_per_row
= ((XFASTINT (width
) + BITS_PER_CHAR
- 1)
1145 if (SBYTES (data
) >= bytes_per_row
* XINT (height
))
1150 return pixmap_p
? Qt
: Qnil
;
1154 /* Load a bitmap according to NAME (which is either a file name or a
1155 pixmap spec) for use on frame F. Value is the bitmap_id (see
1156 xfns.c). If NAME is nil, return with a bitmap id of zero. If
1157 bitmap cannot be loaded, display a message saying so, and return
1158 zero. Store the bitmap width in *W_PTR and its height in *H_PTR,
1159 if these pointers are not null. */
1162 load_pixmap (f
, name
, w_ptr
, h_ptr
)
1165 unsigned int *w_ptr
, *h_ptr
;
1172 CHECK_TYPE (!NILP (Fbitmap_spec_p (name
)), 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 ASCII
1232 characters. The name of the font to load is determined by lface. */
1235 load_face_font (f
, face
)
1239 struct font_info
*font_info
= NULL
;
1241 int needs_overstrike
;
1243 #ifdef USE_FONT_BACKEND
1244 if (enable_font_backend
)
1246 #endif /* USE_FONT_BACKEND */
1247 face
->font_info_id
= -1;
1249 face
->font_name
= NULL
;
1251 font_name
= choose_face_font (f
, face
->lface
, Qnil
, &needs_overstrike
);
1256 font_info
= FS_LOAD_FONT (f
, font_name
);
1261 face
->font_info_id
= font_info
->font_idx
;
1262 face
->font
= font_info
->font
;
1263 face
->font_name
= font_info
->full_name
;
1264 face
->overstrike
= needs_overstrike
;
1268 x_free_gc (f
, face
->gc
);
1274 add_to_log ("Unable to load font %s",
1275 build_string (font_name
), Qnil
);
1279 #endif /* HAVE_WINDOW_SYSTEM */
1283 /***********************************************************************
1285 ***********************************************************************/
1287 /* Parse RGB_LIST, and fill in the RGB fields of COLOR.
1288 RGB_LIST should contain (at least) 3 lisp integers.
1289 Return 0 if there's a problem with RGB_LIST, otherwise return 1. */
1292 parse_rgb_list (rgb_list
, color
)
1293 Lisp_Object rgb_list
;
1296 #define PARSE_RGB_LIST_FIELD(field) \
1297 if (CONSP (rgb_list) && INTEGERP (XCAR (rgb_list))) \
1299 color->field = XINT (XCAR (rgb_list)); \
1300 rgb_list = XCDR (rgb_list); \
1305 PARSE_RGB_LIST_FIELD (red
);
1306 PARSE_RGB_LIST_FIELD (green
);
1307 PARSE_RGB_LIST_FIELD (blue
);
1313 /* Lookup on frame F the color described by the lisp string COLOR.
1314 The resulting tty color is returned in TTY_COLOR; if STD_COLOR is
1315 non-zero, then the `standard' definition of the same color is
1319 tty_lookup_color (f
, color
, tty_color
, std_color
)
1322 XColor
*tty_color
, *std_color
;
1324 Lisp_Object frame
, color_desc
;
1326 if (!STRINGP (color
) || NILP (Ffboundp (Qtty_color_desc
)))
1329 XSETFRAME (frame
, f
);
1331 color_desc
= call2 (Qtty_color_desc
, color
, frame
);
1332 if (CONSP (color_desc
) && CONSP (XCDR (color_desc
)))
1336 if (! INTEGERP (XCAR (XCDR (color_desc
))))
1339 tty_color
->pixel
= XINT (XCAR (XCDR (color_desc
)));
1341 rgb
= XCDR (XCDR (color_desc
));
1342 if (! parse_rgb_list (rgb
, tty_color
))
1345 /* Should we fill in STD_COLOR too? */
1348 /* Default STD_COLOR to the same as TTY_COLOR. */
1349 *std_color
= *tty_color
;
1351 /* Do a quick check to see if the returned descriptor is
1352 actually _exactly_ equal to COLOR, otherwise we have to
1353 lookup STD_COLOR separately. If it's impossible to lookup
1354 a standard color, we just give up and use TTY_COLOR. */
1355 if ((!STRINGP (XCAR (color_desc
))
1356 || NILP (Fstring_equal (color
, XCAR (color_desc
))))
1357 && !NILP (Ffboundp (Qtty_color_standard_values
)))
1359 /* Look up STD_COLOR separately. */
1360 rgb
= call1 (Qtty_color_standard_values
, color
);
1361 if (! parse_rgb_list (rgb
, std_color
))
1368 else if (NILP (Fsymbol_value (intern ("tty-defined-color-alist"))))
1369 /* We were called early during startup, and the colors are not
1370 yet set up in tty-defined-color-alist. Don't return a failure
1371 indication, since this produces the annoying "Unable to
1372 load color" messages in the *Messages* buffer. */
1375 /* tty-color-desc seems to have returned a bad value. */
1379 /* A version of defined_color for non-X frames. */
1382 tty_defined_color (f
, color_name
, color_def
, alloc
)
1391 color_def
->pixel
= FACE_TTY_DEFAULT_COLOR
;
1393 color_def
->blue
= 0;
1394 color_def
->green
= 0;
1397 status
= tty_lookup_color (f
, build_string (color_name
), color_def
, NULL
);
1399 if (color_def
->pixel
== FACE_TTY_DEFAULT_COLOR
&& *color_name
)
1401 if (strcmp (color_name
, "unspecified-fg") == 0)
1402 color_def
->pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
1403 else if (strcmp (color_name
, "unspecified-bg") == 0)
1404 color_def
->pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
1407 if (color_def
->pixel
!= FACE_TTY_DEFAULT_COLOR
)
1414 /* Decide if color named COLOR_NAME is valid for the display
1415 associated with the frame F; if so, return the rgb values in
1416 COLOR_DEF. If ALLOC is nonzero, allocate a new colormap cell.
1418 This does the right thing for any type of frame. */
1421 defined_color (f
, color_name
, color_def
, alloc
)
1427 if (!FRAME_WINDOW_P (f
))
1428 return tty_defined_color (f
, color_name
, color_def
, alloc
);
1429 #ifdef HAVE_X_WINDOWS
1430 else if (FRAME_X_P (f
))
1431 return x_defined_color (f
, color_name
, color_def
, alloc
);
1434 else if (FRAME_W32_P (f
))
1435 return w32_defined_color (f
, color_name
, color_def
, alloc
);
1438 else if (FRAME_MAC_P (f
))
1439 return mac_defined_color (f
, color_name
, color_def
, alloc
);
1446 /* Given the index IDX of a tty color on frame F, return its name, a
1450 tty_color_name (f
, idx
)
1454 if (idx
>= 0 && !NILP (Ffboundp (Qtty_color_by_index
)))
1457 Lisp_Object coldesc
;
1459 XSETFRAME (frame
, f
);
1460 coldesc
= call2 (Qtty_color_by_index
, make_number (idx
), frame
);
1462 if (!NILP (coldesc
))
1463 return XCAR (coldesc
);
1466 /* We can have an MSDOG frame under -nw for a short window of
1467 opportunity before internal_terminal_init is called. DTRT. */
1468 if (FRAME_MSDOS_P (f
) && !inhibit_window_system
)
1469 return msdos_stdcolor_name (idx
);
1472 if (idx
== FACE_TTY_DEFAULT_FG_COLOR
)
1473 return build_string (unspecified_fg
);
1474 if (idx
== FACE_TTY_DEFAULT_BG_COLOR
)
1475 return build_string (unspecified_bg
);
1477 return Qunspecified
;
1481 /* Return non-zero if COLOR_NAME is a shade of gray (or white or
1484 The criterion implemented here is not a terribly sophisticated one. */
1487 face_color_gray_p (f
, color_name
)
1494 if (defined_color (f
, color_name
, &color
, 0))
1495 gray_p
= (/* Any color sufficiently close to black counts as grey. */
1496 (color
.red
< 5000 && color
.green
< 5000 && color
.blue
< 5000)
1498 ((eabs (color
.red
- color
.green
)
1499 < max (color
.red
, color
.green
) / 20)
1500 && (eabs (color
.green
- color
.blue
)
1501 < max (color
.green
, color
.blue
) / 20)
1502 && (eabs (color
.blue
- color
.red
)
1503 < max (color
.blue
, color
.red
) / 20)));
1511 /* Return non-zero if color COLOR_NAME can be displayed on frame F.
1512 BACKGROUND_P non-zero means the color will be used as background
1516 face_color_supported_p (f
, color_name
, background_p
)
1524 XSETFRAME (frame
, f
);
1526 #ifdef HAVE_WINDOW_SYSTEM
1528 ? (!NILP (Fxw_display_color_p (frame
))
1529 || xstricmp (color_name
, "black") == 0
1530 || xstricmp (color_name
, "white") == 0
1532 && face_color_gray_p (f
, color_name
))
1533 || (!NILP (Fx_display_grayscale_p (frame
))
1534 && face_color_gray_p (f
, color_name
)))
1537 tty_defined_color (f
, color_name
, ¬_used
, 0);
1541 DEFUN ("color-gray-p", Fcolor_gray_p
, Scolor_gray_p
, 1, 2, 0,
1542 doc
: /* Return non-nil if COLOR is a shade of gray (or white or black).
1543 FRAME specifies the frame and thus the display for interpreting COLOR.
1544 If FRAME is nil or omitted, use the selected frame. */)
1546 Lisp_Object color
, frame
;
1550 CHECK_STRING (color
);
1552 frame
= selected_frame
;
1554 CHECK_FRAME (frame
);
1556 return face_color_gray_p (f
, SDATA (color
)) ? Qt
: Qnil
;
1560 DEFUN ("color-supported-p", Fcolor_supported_p
,
1561 Scolor_supported_p
, 1, 3, 0,
1562 doc
: /* Return non-nil if COLOR can be displayed on FRAME.
1563 BACKGROUND-P non-nil means COLOR is used as a background.
1564 Otherwise, this function tells whether it can be used as a foreground.
1565 If FRAME is nil or omitted, use the selected frame.
1566 COLOR must be a valid color name. */)
1567 (color
, frame
, background_p
)
1568 Lisp_Object frame
, color
, background_p
;
1572 CHECK_STRING (color
);
1574 frame
= selected_frame
;
1576 CHECK_FRAME (frame
);
1578 if (face_color_supported_p (f
, SDATA (color
), !NILP (background_p
)))
1584 /* Load color with name NAME for use by face FACE on frame F.
1585 TARGET_INDEX must be one of LFACE_FOREGROUND_INDEX,
1586 LFACE_BACKGROUND_INDEX, LFACE_UNDERLINE_INDEX, LFACE_OVERLINE_INDEX,
1587 LFACE_STRIKE_THROUGH_INDEX, or LFACE_BOX_INDEX. Value is the
1588 pixel color. If color cannot be loaded, display a message, and
1589 return the foreground, background or underline color of F, but
1590 record that fact in flags of the face so that we don't try to free
1594 load_color (f
, face
, name
, target_index
)
1598 enum lface_attribute_index target_index
;
1602 xassert (STRINGP (name
));
1603 xassert (target_index
== LFACE_FOREGROUND_INDEX
1604 || target_index
== LFACE_BACKGROUND_INDEX
1605 || target_index
== LFACE_UNDERLINE_INDEX
1606 || target_index
== LFACE_OVERLINE_INDEX
1607 || target_index
== LFACE_STRIKE_THROUGH_INDEX
1608 || target_index
== LFACE_BOX_INDEX
);
1610 /* if the color map is full, defined_color will return a best match
1611 to the values in an existing cell. */
1612 if (!defined_color (f
, SDATA (name
), &color
, 1))
1614 add_to_log ("Unable to load color \"%s\"", name
, Qnil
);
1616 switch (target_index
)
1618 case LFACE_FOREGROUND_INDEX
:
1619 face
->foreground_defaulted_p
= 1;
1620 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1623 case LFACE_BACKGROUND_INDEX
:
1624 face
->background_defaulted_p
= 1;
1625 color
.pixel
= FRAME_BACKGROUND_PIXEL (f
);
1628 case LFACE_UNDERLINE_INDEX
:
1629 face
->underline_defaulted_p
= 1;
1630 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1633 case LFACE_OVERLINE_INDEX
:
1634 face
->overline_color_defaulted_p
= 1;
1635 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1638 case LFACE_STRIKE_THROUGH_INDEX
:
1639 face
->strike_through_color_defaulted_p
= 1;
1640 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1643 case LFACE_BOX_INDEX
:
1644 face
->box_color_defaulted_p
= 1;
1645 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1654 ++ncolors_allocated
;
1661 #ifdef HAVE_WINDOW_SYSTEM
1663 /* Load colors for face FACE which is used on frame F. Colors are
1664 specified by slots LFACE_BACKGROUND_INDEX and LFACE_FOREGROUND_INDEX
1665 of ATTRS. If the background color specified is not supported on F,
1666 try to emulate gray colors with a stipple from Vface_default_stipple. */
1669 load_face_colors (f
, face
, attrs
)
1676 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
1677 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
1679 /* Swap colors if face is inverse-video. */
1680 if (EQ (attrs
[LFACE_INVERSE_INDEX
], Qt
))
1688 /* Check for support for foreground, not for background because
1689 face_color_supported_p is smart enough to know that grays are
1690 "supported" as background because we are supposed to use stipple
1692 if (!face_color_supported_p (f
, SDATA (bg
), 0)
1693 && !NILP (Fbitmap_spec_p (Vface_default_stipple
)))
1695 x_destroy_bitmap (f
, face
->stipple
);
1696 face
->stipple
= load_pixmap (f
, Vface_default_stipple
,
1697 &face
->pixmap_w
, &face
->pixmap_h
);
1700 face
->background
= load_color (f
, face
, bg
, LFACE_BACKGROUND_INDEX
);
1701 face
->foreground
= load_color (f
, face
, fg
, LFACE_FOREGROUND_INDEX
);
1705 /* Free color PIXEL on frame F. */
1708 unload_color (f
, pixel
)
1710 unsigned long pixel
;
1712 #ifdef HAVE_X_WINDOWS
1716 x_free_colors (f
, &pixel
, 1);
1723 /* Free colors allocated for FACE. */
1726 free_face_colors (f
, face
)
1730 #ifdef HAVE_X_WINDOWS
1731 if (face
->colors_copied_bitwise_p
)
1736 if (!face
->foreground_defaulted_p
)
1738 x_free_colors (f
, &face
->foreground
, 1);
1739 IF_DEBUG (--ncolors_allocated
);
1742 if (!face
->background_defaulted_p
)
1744 x_free_colors (f
, &face
->background
, 1);
1745 IF_DEBUG (--ncolors_allocated
);
1748 if (face
->underline_p
1749 && !face
->underline_defaulted_p
)
1751 x_free_colors (f
, &face
->underline_color
, 1);
1752 IF_DEBUG (--ncolors_allocated
);
1755 if (face
->overline_p
1756 && !face
->overline_color_defaulted_p
)
1758 x_free_colors (f
, &face
->overline_color
, 1);
1759 IF_DEBUG (--ncolors_allocated
);
1762 if (face
->strike_through_p
1763 && !face
->strike_through_color_defaulted_p
)
1765 x_free_colors (f
, &face
->strike_through_color
, 1);
1766 IF_DEBUG (--ncolors_allocated
);
1769 if (face
->box
!= FACE_NO_BOX
1770 && !face
->box_color_defaulted_p
)
1772 x_free_colors (f
, &face
->box_color
, 1);
1773 IF_DEBUG (--ncolors_allocated
);
1777 #endif /* HAVE_X_WINDOWS */
1780 #endif /* HAVE_WINDOW_SYSTEM */
1784 /***********************************************************************
1786 ***********************************************************************/
1788 /* An enumerator for each field of an XLFD font name. */
1809 /* An enumerator for each possible slant value of a font. Taken from
1810 the XLFD specification. */
1818 XLFD_SLANT_REVERSE_ITALIC
,
1819 XLFD_SLANT_REVERSE_OBLIQUE
,
1823 /* Relative font weight according to XLFD documentation. */
1827 XLFD_WEIGHT_UNKNOWN
,
1828 XLFD_WEIGHT_ULTRA_LIGHT
, /* 10 */
1829 XLFD_WEIGHT_EXTRA_LIGHT
, /* 20 */
1830 XLFD_WEIGHT_LIGHT
, /* 30 */
1831 XLFD_WEIGHT_SEMI_LIGHT
, /* 40: SemiLight, Book, ... */
1832 XLFD_WEIGHT_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1833 XLFD_WEIGHT_SEMI_BOLD
, /* 60: SemiBold, DemiBold, ... */
1834 XLFD_WEIGHT_BOLD
, /* 70: Bold, ... */
1835 XLFD_WEIGHT_EXTRA_BOLD
, /* 80: ExtraBold, Heavy, ... */
1836 XLFD_WEIGHT_ULTRA_BOLD
/* 90: UltraBold, Black, ... */
1839 /* Relative proportionate width. */
1843 XLFD_SWIDTH_UNKNOWN
,
1844 XLFD_SWIDTH_ULTRA_CONDENSED
, /* 10 */
1845 XLFD_SWIDTH_EXTRA_CONDENSED
, /* 20 */
1846 XLFD_SWIDTH_CONDENSED
, /* 30: Condensed, Narrow, Compressed, ... */
1847 XLFD_SWIDTH_SEMI_CONDENSED
, /* 40: semicondensed */
1848 XLFD_SWIDTH_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1849 XLFD_SWIDTH_SEMI_EXPANDED
, /* 60: SemiExpanded, DemiExpanded, ... */
1850 XLFD_SWIDTH_EXPANDED
, /* 70: Expanded... */
1851 XLFD_SWIDTH_EXTRA_EXPANDED
, /* 80: ExtraExpanded, Wide... */
1852 XLFD_SWIDTH_ULTRA_EXPANDED
/* 90: UltraExpanded... */
1855 /* Structure used for tables mapping XLFD weight, slant, and width
1856 names to numeric and symbolic values. */
1862 Lisp_Object
*symbol
;
1865 /* Table of XLFD slant names and their numeric and symbolic
1866 representations. This table must be sorted by slant names in
1869 static struct table_entry slant_table
[] =
1871 {"i", XLFD_SLANT_ITALIC
, &Qitalic
},
1872 {"o", XLFD_SLANT_OBLIQUE
, &Qoblique
},
1873 {"ot", XLFD_SLANT_OTHER
, &Qitalic
},
1874 {"r", XLFD_SLANT_ROMAN
, &Qnormal
},
1875 {"ri", XLFD_SLANT_REVERSE_ITALIC
, &Qreverse_italic
},
1876 {"ro", XLFD_SLANT_REVERSE_OBLIQUE
, &Qreverse_oblique
}
1879 /* Table of XLFD weight names. This table must be sorted by weight
1880 names in ascending order. */
1882 static struct table_entry weight_table
[] =
1884 {"black", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
},
1885 {"bold", XLFD_WEIGHT_BOLD
, &Qbold
},
1886 {"book", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1887 {"demi", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1888 {"demibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1889 {"extralight", XLFD_WEIGHT_EXTRA_LIGHT
, &Qextra_light
},
1890 {"extrabold", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1891 {"heavy", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1892 {"light", XLFD_WEIGHT_LIGHT
, &Qlight
},
1893 {"medium", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1894 {"normal", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1895 {"regular", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1896 {"semibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1897 {"semilight", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1898 {"ultralight", XLFD_WEIGHT_ULTRA_LIGHT
, &Qultra_light
},
1899 {"ultrabold", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
}
1902 /* Table of XLFD width names. This table must be sorted by width
1903 names in ascending order. */
1905 static struct table_entry swidth_table
[] =
1907 {"compressed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1908 {"condensed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1909 {"demiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1910 {"expanded", XLFD_SWIDTH_EXPANDED
, &Qexpanded
},
1911 {"extracondensed", XLFD_SWIDTH_EXTRA_CONDENSED
, &Qextra_condensed
},
1912 {"extraexpanded", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
},
1913 {"medium", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1914 {"narrow", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1915 {"normal", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1916 {"regular", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1917 {"semicondensed", XLFD_SWIDTH_SEMI_CONDENSED
, &Qsemi_condensed
},
1918 {"semiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1919 {"ultracondensed", XLFD_SWIDTH_ULTRA_CONDENSED
, &Qultra_condensed
},
1920 {"ultraexpanded", XLFD_SWIDTH_ULTRA_EXPANDED
, &Qultra_expanded
},
1921 {"wide", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
}
1924 /* Structure used to hold the result of splitting font names in XLFD
1925 format into their fields. */
1929 /* The original name which is modified destructively by
1930 split_font_name. The pointer is kept here to be able to free it
1931 if it was allocated from the heap. */
1934 /* Font name fields. Each vector element points into `name' above.
1935 Fields are NUL-terminated. */
1936 char *fields
[XLFD_LAST
];
1938 /* Numeric values for those fields that interest us. See
1939 split_font_name for which these are. */
1940 int numeric
[XLFD_LAST
];
1942 /* If the original name matches one of Vface_font_rescale_alist,
1943 the value is the corresponding rescale ratio. Otherwise, the
1945 double rescale_ratio
;
1947 /* Lower value mean higher priority. */
1948 int registry_priority
;
1951 /* The frame in effect when sorting font names. Set temporarily in
1952 sort_fonts so that it is available in font comparison functions. */
1954 static struct frame
*font_frame
;
1956 /* Order by which font selection chooses fonts. The default values
1957 mean `first, find a best match for the font width, then for the
1958 font height, then for weight, then for slant.' This variable can be
1959 set via set-face-font-sort-order. */
1962 static int font_sort_order
[4] = {
1963 XLFD_SWIDTH
, XLFD_POINT_SIZE
, XLFD_WEIGHT
, XLFD_SLANT
1966 static int font_sort_order
[4];
1969 /* Look up FONT.fields[FIELD_INDEX] in TABLE which has DIM entries.
1970 TABLE must be sorted by TABLE[i]->name in ascending order. Value
1971 is a pointer to the matching table entry or null if no table entry
1974 static struct table_entry
*
1975 xlfd_lookup_field_contents (table
, dim
, font
, field_index
)
1976 struct table_entry
*table
;
1978 struct font_name
*font
;
1981 /* Function split_font_name converts fields to lower-case, so there
1982 is no need to use xstrlwr or xstricmp here. */
1983 char *s
= font
->fields
[field_index
];
1984 int low
, mid
, high
, cmp
;
1991 mid
= (low
+ high
) / 2;
1992 cmp
= strcmp (table
[mid
].name
, s
);
2006 /* Return a numeric representation for font name field
2007 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
2008 has DIM entries. Value is the numeric value found or DFLT if no
2009 table entry matches. This function is used to translate weight,
2010 slant, and swidth names of XLFD font names to numeric values. */
2013 xlfd_numeric_value (table
, dim
, font
, field_index
, dflt
)
2014 struct table_entry
*table
;
2016 struct font_name
*font
;
2020 struct table_entry
*p
;
2021 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2022 return p
? p
->numeric
: dflt
;
2026 /* Return a symbolic representation for font name field
2027 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
2028 has DIM entries. Value is the symbolic value found or DFLT if no
2029 table entry matches. This function is used to translate weight,
2030 slant, and swidth names of XLFD font names to symbols. */
2032 static INLINE Lisp_Object
2033 xlfd_symbolic_value (table
, dim
, font
, field_index
, dflt
)
2034 struct table_entry
*table
;
2036 struct font_name
*font
;
2040 struct table_entry
*p
;
2041 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2042 return p
? *p
->symbol
: dflt
;
2046 /* Return a numeric value for the slant of the font given by FONT. */
2049 xlfd_numeric_slant (font
)
2050 struct font_name
*font
;
2052 return xlfd_numeric_value (slant_table
, DIM (slant_table
),
2053 font
, XLFD_SLANT
, XLFD_SLANT_ROMAN
);
2057 /* Return a symbol representing the weight of the font given by FONT. */
2059 static INLINE Lisp_Object
2060 xlfd_symbolic_slant (font
)
2061 struct font_name
*font
;
2063 return xlfd_symbolic_value (slant_table
, DIM (slant_table
),
2064 font
, XLFD_SLANT
, Qnormal
);
2068 /* Return a numeric value for the weight of the font given by FONT. */
2071 xlfd_numeric_weight (font
)
2072 struct font_name
*font
;
2074 return xlfd_numeric_value (weight_table
, DIM (weight_table
),
2075 font
, XLFD_WEIGHT
, XLFD_WEIGHT_MEDIUM
);
2079 /* Return a symbol representing the slant of the font given by FONT. */
2081 static INLINE Lisp_Object
2082 xlfd_symbolic_weight (font
)
2083 struct font_name
*font
;
2085 return xlfd_symbolic_value (weight_table
, DIM (weight_table
),
2086 font
, XLFD_WEIGHT
, Qnormal
);
2090 /* Return a numeric value for the swidth of the font whose XLFD font
2091 name fields are found in FONT. */
2094 xlfd_numeric_swidth (font
)
2095 struct font_name
*font
;
2097 return xlfd_numeric_value (swidth_table
, DIM (swidth_table
),
2098 font
, XLFD_SWIDTH
, XLFD_SWIDTH_MEDIUM
);
2102 /* Return a symbolic value for the swidth of FONT. */
2104 static INLINE Lisp_Object
2105 xlfd_symbolic_swidth (font
)
2106 struct font_name
*font
;
2108 return xlfd_symbolic_value (swidth_table
, DIM (swidth_table
),
2109 font
, XLFD_SWIDTH
, Qnormal
);
2113 /* Look up the entry of SYMBOL in the vector TABLE which has DIM
2114 entries. Value is a pointer to the matching table entry or null if
2115 no element of TABLE contains SYMBOL. */
2117 static struct table_entry
*
2118 face_value (table
, dim
, symbol
)
2119 struct table_entry
*table
;
2125 xassert (SYMBOLP (symbol
));
2127 for (i
= 0; i
< dim
; ++i
)
2128 if (EQ (*table
[i
].symbol
, symbol
))
2131 return i
< dim
? table
+ i
: NULL
;
2135 /* Return a numeric value for SYMBOL in the vector TABLE which has DIM
2136 entries. Value is -1 if SYMBOL is not found in TABLE. */
2139 face_numeric_value (table
, dim
, symbol
)
2140 struct table_entry
*table
;
2144 struct table_entry
*p
= face_value (table
, dim
, symbol
);
2145 return p
? p
->numeric
: -1;
2149 /* Return a numeric value representing the weight specified by Lisp
2150 symbol WEIGHT. Value is one of the enumerators of enum
2154 face_numeric_weight (weight
)
2157 return face_numeric_value (weight_table
, DIM (weight_table
), weight
);
2161 /* Return a numeric value representing the slant specified by Lisp
2162 symbol SLANT. Value is one of the enumerators of enum xlfd_slant. */
2165 face_numeric_slant (slant
)
2168 return face_numeric_value (slant_table
, DIM (slant_table
), slant
);
2172 /* Return a numeric value representing the swidth specified by Lisp
2173 symbol WIDTH. Value is one of the enumerators of enum xlfd_swidth. */
2176 face_numeric_swidth (width
)
2179 return face_numeric_value (swidth_table
, DIM (swidth_table
), width
);
2182 #ifdef HAVE_WINDOW_SYSTEM
2184 #ifdef USE_FONT_BACKEND
2185 static INLINE Lisp_Object
2186 face_symbolic_value (table
, dim
, font_prop
)
2187 struct table_entry
*table
;
2189 Lisp_Object font_prop
;
2191 struct table_entry
*p
;
2192 char *s
= SDATA (SYMBOL_NAME (font_prop
));
2193 int low
, mid
, high
, cmp
;
2200 mid
= (low
+ high
) / 2;
2201 cmp
= strcmp (table
[mid
].name
, s
);
2208 return *table
[mid
].symbol
;
2214 static INLINE Lisp_Object
2215 face_symbolic_weight (weight
)
2218 return face_symbolic_value (weight_table
, DIM (weight_table
), weight
);
2221 static INLINE Lisp_Object
2222 face_symbolic_slant (slant
)
2225 return face_symbolic_value (slant_table
, DIM (slant_table
), slant
);
2228 static INLINE Lisp_Object
2229 face_symbolic_swidth (width
)
2232 return face_symbolic_value (swidth_table
, DIM (swidth_table
), width
);
2234 #endif /* USE_FONT_BACKEND */
2237 split_font_name_into_vector (fontname
)
2238 Lisp_Object fontname
;
2240 struct font_name font
;
2244 font
.name
= LSTRDUPA (fontname
);
2245 if (! split_font_name (NULL
, &font
, 0))
2247 vec
= Fmake_vector (make_number (XLFD_LAST
), Qnil
);
2248 for (i
= 0; i
< XLFD_LAST
; i
++)
2249 if (font
.fields
[i
][0] != '*')
2250 ASET (vec
, i
, build_string (font
.fields
[i
]));
2255 build_font_name_from_vector (vec
)
2258 struct font_name font
;
2259 Lisp_Object fontname
;
2263 for (i
= 0; i
< XLFD_LAST
; i
++)
2265 font
.fields
[i
] = (NILP (AREF (vec
, i
))
2266 ? "*" : (char *) SDATA (AREF (vec
, i
)));
2267 if ((i
== XLFD_FAMILY
|| i
== XLFD_REGISTRY
)
2268 && (p
= strchr (font
.fields
[i
], '-')))
2270 char *p1
= STRDUPA (font
.fields
[i
]);
2272 p1
[p
- font
.fields
[i
]] = '\0';
2273 if (i
== XLFD_FAMILY
)
2275 font
.fields
[XLFD_FOUNDRY
] = p1
;
2276 font
.fields
[XLFD_FAMILY
] = p
+ 1;
2280 font
.fields
[XLFD_REGISTRY
] = p1
;
2281 font
.fields
[XLFD_ENCODING
] = p
+ 1;
2287 p
= build_font_name (&font
);
2288 fontname
= build_string (p
);
2293 /* Return non-zero if FONT is the name of a fixed-pitch font. */
2297 struct font_name
*font
;
2299 /* Function split_font_name converts fields to lower-case, so there
2300 is no need to use tolower here. */
2301 return *font
->fields
[XLFD_SPACING
] != 'p';
2305 /* Return the point size of FONT on frame F, measured in 1/10 pt.
2307 The actual height of the font when displayed on F depends on the
2308 resolution of both the font and frame. For example, a 10pt font
2309 designed for a 100dpi display will display larger than 10pt on a
2310 75dpi display. (It's not unusual to use fonts not designed for the
2311 display one is using. For example, some intlfonts are available in
2312 72dpi versions, only.)
2314 Value is the real point size of FONT on frame F, or 0 if it cannot
2317 By side effect, set FONT->numeric[XLFD_PIXEL_SIZE]. */
2320 xlfd_point_size (f
, font
)
2322 struct font_name
*font
;
2324 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2325 char *pixel_field
= font
->fields
[XLFD_PIXEL_SIZE
];
2329 if (*pixel_field
== '[')
2331 /* The pixel size field is `[A B C D]' which specifies
2332 a transformation matrix.
2338 by which all glyphs of the font are transformed. The spec
2339 says that s scalar value N for the pixel size is equivalent
2340 to A = N * resx/resy, B = C = 0, D = N. */
2341 char *start
= pixel_field
+ 1, *end
;
2345 for (i
= 0; i
< 4; ++i
)
2347 matrix
[i
] = strtod (start
, &end
);
2354 pixel
= atoi (pixel_field
);
2356 font
->numeric
[XLFD_PIXEL_SIZE
] = pixel
;
2360 real_pt
= PT_PER_INCH
* 10.0 * pixel
/ resy
+ 0.5;
2366 /* Return point size of PIXEL dots while considering Y-resultion (DPI)
2367 of frame F. This function is used to guess a point size of font
2368 when only the pixel height of the font is available. */
2371 pixel_point_size (f
, pixel
)
2375 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2379 /* As one inch is PT_PER_INCH points, PT_PER_INCH/RESY gives the
2380 point size of one dot. */
2381 real_pt
= pixel
* PT_PER_INCH
/ resy
;
2382 int_pt
= real_pt
+ 0.5;
2388 /* Return a rescaling ratio of a font of NAME. */
2391 font_rescale_ratio (name
)
2394 Lisp_Object tail
, elt
;
2396 for (tail
= Vface_font_rescale_alist
; CONSP (tail
); tail
= XCDR (tail
))
2399 if (STRINGP (XCAR (elt
)) && FLOATP (XCDR (elt
))
2400 && fast_c_string_match_ignore_case (XCAR (elt
), name
) >= 0)
2401 return XFLOAT_DATA (XCDR (elt
));
2407 /* Split XLFD font name FONT->name destructively into NUL-terminated,
2408 lower-case fields in FONT->fields. NUMERIC_P non-zero means
2409 compute numeric values for fields XLFD_POINT_SIZE, XLFD_SWIDTH,
2410 XLFD_RESY, XLFD_SLANT, and XLFD_WEIGHT in FONT->numeric. Value is
2411 zero if the font name doesn't have the format we expect. The
2412 expected format is a font name that starts with a `-' and has
2413 XLFD_LAST fields separated by `-'. */
2416 split_font_name (f
, font
, numeric_p
)
2418 struct font_name
*font
;
2423 double rescale_ratio
;
2426 /* This must be done before splitting the font name. */
2427 rescale_ratio
= font_rescale_ratio (font
->name
);
2429 if (*font
->name
== '-')
2431 char *p
= xstrlwr (font
->name
) + 1;
2433 while (i
< XLFD_LAST
)
2435 font
->fields
[i
] = p
;
2438 /* Pixel and point size may be of the form `[....]'. For
2439 BNF, see XLFD spec, chapter 4. Negative values are
2440 indicated by tilde characters which we replace with
2441 `-' characters, here. */
2443 && (i
- 1 == XLFD_PIXEL_SIZE
2444 || i
- 1 == XLFD_POINT_SIZE
))
2449 for (++p
; *p
&& *p
!= ']'; ++p
)
2453 /* Check that the matrix contains 4 floating point
2455 for (j
= 0, start
= font
->fields
[i
- 1] + 1;
2458 if (strtod (start
, &end
) == 0 && start
== end
)
2465 while (*p
&& *p
!= '-')
2475 success_p
= i
== XLFD_LAST
;
2477 /* If requested, and font name was in the expected format,
2478 compute numeric values for some fields. */
2479 if (numeric_p
&& success_p
)
2481 font
->numeric
[XLFD_POINT_SIZE
] = xlfd_point_size (f
, font
);
2482 font
->numeric
[XLFD_RESY
] = atoi (font
->fields
[XLFD_RESY
]);
2483 font
->numeric
[XLFD_SLANT
] = xlfd_numeric_slant (font
);
2484 font
->numeric
[XLFD_WEIGHT
] = xlfd_numeric_weight (font
);
2485 font
->numeric
[XLFD_SWIDTH
] = xlfd_numeric_swidth (font
);
2486 font
->numeric
[XLFD_AVGWIDTH
] = atoi (font
->fields
[XLFD_AVGWIDTH
]);
2487 font
->rescale_ratio
= rescale_ratio
;
2490 /* Initialize it to zero. It will be overridden by font_list while
2491 trying alternate registries. */
2492 font
->registry_priority
= 0;
2498 /* Build an XLFD font name from font name fields in FONT. Value is a
2499 pointer to the font name, which is allocated via xmalloc. */
2502 build_font_name (font
)
2503 struct font_name
*font
;
2507 char *font_name
= (char *) xmalloc (size
);
2508 int total_length
= 0;
2510 for (i
= 0; i
< XLFD_LAST
; ++i
)
2512 /* Add 1 because of the leading `-'. */
2513 int len
= strlen (font
->fields
[i
]) + 1;
2515 /* Reallocate font_name if necessary. Add 1 for the final
2517 if (total_length
+ len
+ 1 >= size
)
2519 int new_size
= max (2 * size
, size
+ len
+ 1);
2520 int sz
= new_size
* sizeof *font_name
;
2521 font_name
= (char *) xrealloc (font_name
, sz
);
2525 font_name
[total_length
] = '-';
2526 bcopy (font
->fields
[i
], font_name
+ total_length
+ 1, len
- 1);
2527 total_length
+= len
;
2530 font_name
[total_length
] = 0;
2535 /* Free an array FONTS of N font_name structures. This frees FONTS
2536 itself and all `name' fields in its elements. */
2539 free_font_names (fonts
, n
)
2540 struct font_name
*fonts
;
2544 xfree (fonts
[--n
].name
);
2549 /* Sort vector FONTS of font_name structures which contains NFONTS
2550 elements using qsort and comparison function CMPFN. F is the frame
2551 on which the fonts will be used. The global variable font_frame
2552 is temporarily set to F to make it available in CMPFN. */
2555 sort_fonts (f
, fonts
, nfonts
, cmpfn
)
2557 struct font_name
*fonts
;
2559 int (*cmpfn
) P_ ((const void *, const void *));
2562 qsort (fonts
, nfonts
, sizeof *fonts
, cmpfn
);
2567 /* Get fonts matching PATTERN on frame F. If F is null, use the first
2568 display in x_display_list. FONTS is a pointer to a vector of
2569 NFONTS font_name structures. TRY_ALTERNATIVES_P non-zero means try
2570 alternative patterns from Valternate_fontname_alist if no fonts are
2571 found matching PATTERN.
2573 For all fonts found, set FONTS[i].name to the name of the font,
2574 allocated via xmalloc, and split font names into fields. Ignore
2575 fonts that we can't parse. Value is the number of fonts found. */
2578 x_face_list_fonts (f
, pattern
, pfonts
, nfonts
, try_alternatives_p
)
2581 struct font_name
**pfonts
;
2582 int nfonts
, try_alternatives_p
;
2586 /* NTEMACS_TODO : currently this uses w32_list_fonts, but it may be
2587 better to do it the other way around. */
2589 Lisp_Object lpattern
, tem
;
2590 struct font_name
*fonts
= 0;
2591 int num_fonts
= nfonts
;
2594 lpattern
= build_string (pattern
);
2596 /* Get the list of fonts matching PATTERN. */
2599 lfonts
= w32_list_fonts (f
, lpattern
, 0, nfonts
);
2602 lfonts
= x_list_fonts (f
, lpattern
, -1, nfonts
);
2605 if (nfonts
< 0 && CONSP (lfonts
))
2606 num_fonts
= XFASTINT (Flength (lfonts
));
2608 /* Make a copy of the font names we got from X, and
2609 split them into fields. */
2611 for (tem
= lfonts
; CONSP (tem
) && n
< num_fonts
; tem
= XCDR (tem
))
2613 Lisp_Object elt
, tail
;
2614 const char *name
= SDATA (XCAR (tem
));
2616 /* Ignore fonts matching a pattern from face-ignored-fonts. */
2617 for (tail
= Vface_ignored_fonts
; CONSP (tail
); tail
= XCDR (tail
))
2621 && fast_c_string_match_ignore_case (elt
, name
) >= 0)
2632 *pfonts
= (struct font_name
*) xmalloc (num_fonts
* sizeof **pfonts
);
2636 /* Make a copy of the font name. */
2637 fonts
[n
].name
= xstrdup (name
);
2639 if (split_font_name (f
, fonts
+ n
, 1))
2641 if (font_scalable_p (fonts
+ n
)
2642 && !may_use_scalable_font_p (name
))
2645 xfree (fonts
[n
].name
);
2651 xfree (fonts
[n
].name
);
2654 /* If no fonts found, try patterns from Valternate_fontname_alist. */
2655 if (n
== 0 && try_alternatives_p
)
2657 Lisp_Object list
= Valternate_fontname_alist
;
2665 while (CONSP (list
))
2667 Lisp_Object entry
= XCAR (list
);
2669 && STRINGP (XCAR (entry
))
2670 && strcmp (SDATA (XCAR (entry
)), pattern
) == 0)
2677 Lisp_Object patterns
= XCAR (list
);
2680 while (CONSP (patterns
)
2681 /* If list is screwed up, give up. */
2682 && (name
= XCAR (patterns
),
2684 /* Ignore patterns equal to PATTERN because we tried that
2685 already with no success. */
2686 && (strcmp (SDATA (name
), pattern
) == 0
2687 || (n
= x_face_list_fonts (f
, SDATA (name
),
2690 patterns
= XCDR (patterns
);
2698 /* Check if a font matching pattern_offset_t on frame F is available
2699 or not. PATTERN may be a cons (FAMILY . REGISTRY), in which case,
2700 a font name pattern is generated from FAMILY and REGISTRY. */
2703 face_font_available_p (f
, pattern
)
2705 Lisp_Object pattern
;
2709 if (! STRINGP (pattern
))
2711 Lisp_Object family
, registry
;
2712 char *family_str
, *registry_str
, *pattern_str
;
2714 CHECK_CONS (pattern
);
2715 family
= XCAR (pattern
);
2720 CHECK_STRING (family
);
2721 family_str
= (char *) SDATA (family
);
2723 registry
= XCDR (pattern
);
2724 if (NILP (registry
))
2728 CHECK_STRING (registry
);
2729 registry_str
= (char *) SDATA (registry
);
2732 pattern_str
= (char *) alloca (strlen (family_str
)
2733 + strlen (registry_str
)
2735 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2736 strcat (pattern_str
, family_str
);
2737 strcat (pattern_str
, "-*-");
2738 strcat (pattern_str
, registry_str
);
2739 if (!index (registry_str
, '-'))
2741 if (registry_str
[strlen (registry_str
) - 1] == '*')
2742 strcat (pattern_str
, "-*");
2744 strcat (pattern_str
, "*-*");
2746 pattern
= build_string (pattern_str
);
2749 /* Get the list of fonts matching PATTERN. */
2752 fonts
= w32_list_fonts (f
, pattern
, 0, 1);
2755 fonts
= x_list_fonts (f
, pattern
, -1, 1);
2757 return XINT (Flength (fonts
));
2761 /* Determine fonts matching PATTERN on frame F. Sort resulting fonts
2762 using comparison function CMPFN. Value is the number of fonts
2763 found. If value is non-zero, *FONTS is set to a vector of
2764 font_name structures allocated from the heap containing matching
2765 fonts. Each element of *FONTS contains a name member that is also
2766 allocated from the heap. Font names in these structures are split
2767 into fields. Use free_font_names to free such an array. */
2770 sorted_font_list (f
, pattern
, cmpfn
, fonts
)
2773 int (*cmpfn
) P_ ((const void *, const void *));
2774 struct font_name
**fonts
;
2778 /* Get the list of fonts matching pattern. 100 should suffice. */
2779 nfonts
= DEFAULT_FONT_LIST_LIMIT
;
2780 if (INTEGERP (Vfont_list_limit
))
2781 nfonts
= XINT (Vfont_list_limit
);
2784 nfonts
= x_face_list_fonts (f
, pattern
, fonts
, nfonts
, 1);
2786 /* Sort the resulting array and return it in *FONTS. If no
2787 fonts were found, make sure to set *FONTS to null. */
2789 sort_fonts (f
, *fonts
, nfonts
, cmpfn
);
2800 /* Compare two font_name structures *A and *B. Value is analogous to
2801 strcmp. Sort order is given by the global variable
2802 font_sort_order. Font names are sorted so that, everything else
2803 being equal, fonts with a resolution closer to that of the frame on
2804 which they are used are listed first. The global variable
2805 font_frame is the frame on which we operate. */
2808 cmp_font_names (a
, b
)
2811 struct font_name
*x
= (struct font_name
*) a
;
2812 struct font_name
*y
= (struct font_name
*) b
;
2815 /* All strings have been converted to lower-case by split_font_name,
2816 so we can use strcmp here. */
2817 cmp
= strcmp (x
->fields
[XLFD_FAMILY
], y
->fields
[XLFD_FAMILY
]);
2822 for (i
= 0; i
< DIM (font_sort_order
) && cmp
== 0; ++i
)
2824 int j
= font_sort_order
[i
];
2825 cmp
= x
->numeric
[j
] - y
->numeric
[j
];
2830 /* Everything else being equal, we prefer fonts with an
2831 y-resolution closer to that of the frame. */
2832 int resy
= FRAME_X_DISPLAY_INFO (font_frame
)->resy
;
2833 int x_resy
= x
->numeric
[XLFD_RESY
];
2834 int y_resy
= y
->numeric
[XLFD_RESY
];
2835 cmp
= eabs (resy
- x_resy
) - eabs (resy
- y_resy
);
2843 /* Get a sorted list of fonts matching PATTERN on frame F. If PATTERN
2844 is nil, list fonts matching FAMILY and REGISTRY. FAMILY is a
2845 family name string or nil. REGISTRY is a registry name string.
2846 Set *FONTS to a vector of font_name structures allocated from the
2847 heap containing the fonts found. Value is the number of fonts
2851 font_list_1 (f
, pattern
, family
, registry
, fonts
)
2853 Lisp_Object pattern
, family
, registry
;
2854 struct font_name
**fonts
;
2856 char *pattern_str
, *family_str
, *registry_str
;
2860 family_str
= (NILP (family
) ? "*" : (char *) SDATA (family
));
2861 registry_str
= (NILP (registry
) ? "*" : (char *) SDATA (registry
));
2863 pattern_str
= (char *) alloca (strlen (family_str
)
2864 + strlen (registry_str
)
2866 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2867 strcat (pattern_str
, family_str
);
2868 strcat (pattern_str
, "-*-");
2869 strcat (pattern_str
, registry_str
);
2870 if (!index (registry_str
, '-'))
2872 if (registry_str
[strlen (registry_str
) - 1] == '*')
2873 strcat (pattern_str
, "-*");
2875 strcat (pattern_str
, "*-*");
2879 pattern_str
= (char *) SDATA (pattern
);
2881 return sorted_font_list (f
, pattern_str
, cmp_font_names
, fonts
);
2885 /* Concatenate font list FONTS1 and FONTS2. FONTS1 and FONTS2
2886 contains NFONTS1 fonts and NFONTS2 fonts respectively. Return a
2887 pointer to a newly allocated font list. FONTS1 and FONTS2 are
2890 static struct font_name
*
2891 concat_font_list (fonts1
, nfonts1
, fonts2
, nfonts2
)
2892 struct font_name
*fonts1
, *fonts2
;
2893 int nfonts1
, nfonts2
;
2895 int new_nfonts
= nfonts1
+ nfonts2
;
2896 struct font_name
*new_fonts
;
2898 new_fonts
= (struct font_name
*) xmalloc (sizeof *new_fonts
* new_nfonts
);
2899 bcopy (fonts1
, new_fonts
, sizeof *new_fonts
* nfonts1
);
2900 bcopy (fonts2
, new_fonts
+ nfonts1
, sizeof *new_fonts
* nfonts2
);
2907 /* Get a sorted list of fonts of family FAMILY on frame F.
2909 If PATTERN is non-nil, list fonts matching that pattern.
2911 If REGISTRY is non-nil, it is a list of registry (and encoding)
2912 names. Return fonts with those registries and the alternative
2913 registries from Vface_alternative_font_registry_alist.
2915 If REGISTRY is nil return fonts of any registry.
2917 Set *FONTS to a vector of font_name structures allocated from the
2918 heap containing the fonts found. Value is the number of fonts
2922 font_list (f
, pattern
, family
, registry
, fonts
)
2924 Lisp_Object pattern
, family
, registry
;
2925 struct font_name
**fonts
;
2931 if (NILP (registry
))
2932 return font_list_1 (f
, pattern
, family
, registry
, fonts
);
2934 for (reg_prio
= 0, nfonts
= 0; CONSP (registry
); registry
= XCDR (registry
))
2936 Lisp_Object elt
, alter
;
2938 struct font_name
*fonts2
;
2940 elt
= XCAR (registry
);
2941 alter
= Fassoc (elt
, Vface_alternative_font_registry_alist
);
2943 alter
= Fcons (elt
, Qnil
);
2944 for (; CONSP (alter
); alter
= XCDR (alter
), reg_prio
++)
2946 nfonts2
= font_list_1 (f
, pattern
, family
, XCAR (alter
), &fonts2
);
2950 for (i
= 0; i
< nfonts2
; i
++)
2951 fonts2
[i
].registry_priority
= reg_prio
;
2953 *fonts
= concat_font_list (*fonts
, nfonts
, fonts2
, nfonts2
);
2965 /* Remove elements from LIST whose cars are `equal'. Called from
2966 x-family-fonts and x-font-family-list to remove duplicate font
2970 remove_duplicates (list
)
2973 Lisp_Object tail
= list
;
2975 while (!NILP (tail
) && !NILP (XCDR (tail
)))
2977 Lisp_Object next
= XCDR (tail
);
2978 if (!NILP (Fequal (XCAR (next
), XCAR (tail
))))
2979 XSETCDR (tail
, XCDR (next
));
2986 DEFUN ("x-family-fonts", Fx_family_fonts
, Sx_family_fonts
, 0, 2, 0,
2987 doc
: /* Return a list of available fonts of family FAMILY on FRAME.
2988 If FAMILY is omitted or nil, list all families.
2989 Otherwise, FAMILY must be a string, possibly containing wildcards
2991 If FRAME is omitted or nil, use the selected frame.
2992 Each element of the result is a vector [FAMILY WIDTH POINT-SIZE WEIGHT
2993 SLANT FIXED-P FULL REGISTRY-AND-ENCODING].
2994 FAMILY is the font family name. POINT-SIZE is the size of the
2995 font in 1/10 pt. WIDTH, WEIGHT, and SLANT are symbols describing the
2996 width, weight and slant of the font. These symbols are the same as for
2997 face attributes. FIXED-P is non-nil if the font is fixed-pitch.
2998 FULL is the full name of the font, and REGISTRY-AND-ENCODING is a string
2999 giving the registry and encoding of the font.
3000 The result list is sorted according to the current setting of
3001 the face font sort order. */)
3003 Lisp_Object family
, frame
;
3005 struct frame
*f
= check_x_frame (frame
);
3006 struct font_name
*fonts
;
3009 struct gcpro gcpro1
;
3012 CHECK_STRING (family
);
3016 nfonts
= font_list (f
, Qnil
, family
, Qnil
, &fonts
);
3017 for (i
= nfonts
- 1; i
>= 0; --i
)
3019 Lisp_Object v
= Fmake_vector (make_number (8), Qnil
);
3022 ASET (v
, 0, build_string (fonts
[i
].fields
[XLFD_FAMILY
]));
3023 ASET (v
, 1, xlfd_symbolic_swidth (fonts
+ i
));
3024 ASET (v
, 2, make_number (xlfd_point_size (f
, fonts
+ i
)));
3025 ASET (v
, 3, xlfd_symbolic_weight (fonts
+ i
));
3026 ASET (v
, 4, xlfd_symbolic_slant (fonts
+ i
));
3027 ASET (v
, 5, xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
);
3028 tem
= build_font_name (fonts
+ i
);
3029 ASET (v
, 6, build_string (tem
));
3030 sprintf (tem
, "%s-%s", fonts
[i
].fields
[XLFD_REGISTRY
],
3031 fonts
[i
].fields
[XLFD_ENCODING
]);
3032 ASET (v
, 7, build_string (tem
));
3035 result
= Fcons (v
, result
);
3038 remove_duplicates (result
);
3039 free_font_names (fonts
, nfonts
);
3045 DEFUN ("x-font-family-list", Fx_font_family_list
, Sx_font_family_list
,
3047 doc
: /* Return a list of available font families on FRAME.
3048 If FRAME is omitted or nil, use the selected frame.
3049 Value is a list of conses (FAMILY . FIXED-P) where FAMILY
3050 is a font family, and FIXED-P is non-nil if fonts of that family
3051 are fixed-pitch. */)
3055 struct frame
*f
= check_x_frame (frame
);
3057 struct font_name
*fonts
;
3059 struct gcpro gcpro1
;
3060 int count
= SPECPDL_INDEX ();
3062 /* Let's consider all fonts. */
3063 specbind (intern ("font-list-limit"), make_number (-1));
3064 nfonts
= font_list (f
, Qnil
, Qnil
, Qnil
, &fonts
);
3068 for (i
= nfonts
- 1; i
>= 0; --i
)
3069 result
= Fcons (Fcons (build_string (fonts
[i
].fields
[XLFD_FAMILY
]),
3070 xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
),
3073 remove_duplicates (result
);
3074 free_font_names (fonts
, nfonts
);
3076 return unbind_to (count
, result
);
3080 DEFUN ("x-list-fonts", Fx_list_fonts
, Sx_list_fonts
, 1, 5, 0,
3081 doc
: /* Return a list of the names of available fonts matching PATTERN.
3082 If optional arguments FACE and FRAME are specified, return only fonts
3083 the same size as FACE on FRAME.
3084 PATTERN is a string, perhaps with wildcard characters;
3085 the * character matches any substring, and
3086 the ? character matches any single character.
3087 PATTERN is case-insensitive.
3088 FACE is a face name--a symbol.
3090 The return value is a list of strings, suitable as arguments to
3093 Fonts Emacs can't use may or may not be excluded
3094 even if they match PATTERN and FACE.
3095 The optional fourth argument MAXIMUM sets a limit on how many
3096 fonts to match. The first MAXIMUM fonts are reported.
3097 The optional fifth argument WIDTH, if specified, is a number of columns
3098 occupied by a character of a font. In that case, return only fonts
3099 the WIDTH times as wide as FACE on FRAME. */)
3100 (pattern
, face
, frame
, maximum
, width
)
3101 Lisp_Object pattern
, face
, frame
, maximum
, width
;
3108 CHECK_STRING (pattern
);
3114 CHECK_NATNUM (maximum
);
3115 maxnames
= XINT (maximum
);
3119 CHECK_NUMBER (width
);
3121 /* We can't simply call check_x_frame because this function may be
3122 called before any frame is created. */
3123 f
= frame_or_selected_frame (frame
, 2);
3124 if (!FRAME_WINDOW_P (f
))
3126 /* Perhaps we have not yet created any frame. */
3131 /* Determine the width standard for comparison with the fonts we find. */
3137 /* This is of limited utility since it works with character
3138 widths. Keep it for compatibility. --gerd. */
3139 int face_id
= lookup_named_face (f
, face
, 0);
3140 struct face
*face
= (face_id
< 0
3142 : FACE_FROM_ID (f
, face_id
));
3144 if (face
&& face
->font
)
3145 size
= FONT_WIDTH (face
->font
);
3147 size
= FONT_WIDTH (FRAME_FONT (f
)); /* FRAME_COLUMN_WIDTH (f) */
3150 size
*= XINT (width
);
3154 Lisp_Object args
[2];
3156 args
[0] = x_list_fonts (f
, pattern
, size
, maxnames
);
3158 /* We don't have to check fontsets. */
3160 args
[1] = list_fontsets (f
, pattern
, size
);
3161 return Fnconc (2, args
);
3165 #endif /* HAVE_WINDOW_SYSTEM */
3169 /***********************************************************************
3171 ***********************************************************************/
3173 /* Access face attributes of face LFACE, a Lisp vector. */
3175 #define LFACE_FAMILY(LFACE) AREF ((LFACE), LFACE_FAMILY_INDEX)
3176 #define LFACE_HEIGHT(LFACE) AREF ((LFACE), LFACE_HEIGHT_INDEX)
3177 #define LFACE_WEIGHT(LFACE) AREF ((LFACE), LFACE_WEIGHT_INDEX)
3178 #define LFACE_SLANT(LFACE) AREF ((LFACE), LFACE_SLANT_INDEX)
3179 #define LFACE_UNDERLINE(LFACE) AREF ((LFACE), LFACE_UNDERLINE_INDEX)
3180 #define LFACE_INVERSE(LFACE) AREF ((LFACE), LFACE_INVERSE_INDEX)
3181 #define LFACE_FOREGROUND(LFACE) AREF ((LFACE), LFACE_FOREGROUND_INDEX)
3182 #define LFACE_BACKGROUND(LFACE) AREF ((LFACE), LFACE_BACKGROUND_INDEX)
3183 #define LFACE_STIPPLE(LFACE) AREF ((LFACE), LFACE_STIPPLE_INDEX)
3184 #define LFACE_SWIDTH(LFACE) AREF ((LFACE), LFACE_SWIDTH_INDEX)
3185 #define LFACE_OVERLINE(LFACE) AREF ((LFACE), LFACE_OVERLINE_INDEX)
3186 #define LFACE_STRIKE_THROUGH(LFACE) AREF ((LFACE), LFACE_STRIKE_THROUGH_INDEX)
3187 #define LFACE_BOX(LFACE) AREF ((LFACE), LFACE_BOX_INDEX)
3188 #define LFACE_FONT(LFACE) AREF ((LFACE), LFACE_FONT_INDEX)
3189 #define LFACE_INHERIT(LFACE) AREF ((LFACE), LFACE_INHERIT_INDEX)
3190 #define LFACE_AVGWIDTH(LFACE) AREF ((LFACE), LFACE_AVGWIDTH_INDEX)
3191 #define LFACE_FONTSET(LFACE) AREF ((LFACE), LFACE_FONTSET_INDEX)
3193 /* Non-zero if LFACE is a Lisp face. A Lisp face is a vector of size
3194 LFACE_VECTOR_SIZE which has the symbol `face' in slot 0. */
3196 #define LFACEP(LFACE) \
3198 && XVECTOR (LFACE)->size == LFACE_VECTOR_SIZE \
3199 && EQ (AREF (LFACE, 0), Qface))
3204 /* Check consistency of Lisp face attribute vector ATTRS. */
3207 check_lface_attrs (attrs
)
3210 xassert (UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
3211 || IGNORE_DEFFACE_P (attrs
[LFACE_FAMILY_INDEX
])
3212 || STRINGP (attrs
[LFACE_FAMILY_INDEX
]));
3213 xassert (UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
3214 || IGNORE_DEFFACE_P (attrs
[LFACE_SWIDTH_INDEX
])
3215 || SYMBOLP (attrs
[LFACE_SWIDTH_INDEX
]));
3216 xassert (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
3217 || IGNORE_DEFFACE_P (attrs
[LFACE_AVGWIDTH_INDEX
])
3218 || INTEGERP (attrs
[LFACE_AVGWIDTH_INDEX
]));
3219 xassert (UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
3220 || IGNORE_DEFFACE_P (attrs
[LFACE_HEIGHT_INDEX
])
3221 || INTEGERP (attrs
[LFACE_HEIGHT_INDEX
])
3222 || FLOATP (attrs
[LFACE_HEIGHT_INDEX
])
3223 || FUNCTIONP (attrs
[LFACE_HEIGHT_INDEX
]));
3224 xassert (UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
3225 || IGNORE_DEFFACE_P (attrs
[LFACE_WEIGHT_INDEX
])
3226 || SYMBOLP (attrs
[LFACE_WEIGHT_INDEX
]));
3227 xassert (UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
3228 || IGNORE_DEFFACE_P (attrs
[LFACE_SLANT_INDEX
])
3229 || SYMBOLP (attrs
[LFACE_SLANT_INDEX
]));
3230 xassert (UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
3231 || IGNORE_DEFFACE_P (attrs
[LFACE_UNDERLINE_INDEX
])
3232 || SYMBOLP (attrs
[LFACE_UNDERLINE_INDEX
])
3233 || STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]));
3234 xassert (UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
3235 || IGNORE_DEFFACE_P (attrs
[LFACE_OVERLINE_INDEX
])
3236 || SYMBOLP (attrs
[LFACE_OVERLINE_INDEX
])
3237 || STRINGP (attrs
[LFACE_OVERLINE_INDEX
]));
3238 xassert (UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3239 || IGNORE_DEFFACE_P (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3240 || SYMBOLP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3241 || STRINGP (attrs
[LFACE_STRIKE_THROUGH_INDEX
]));
3242 xassert (UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
3243 || IGNORE_DEFFACE_P (attrs
[LFACE_BOX_INDEX
])
3244 || SYMBOLP (attrs
[LFACE_BOX_INDEX
])
3245 || STRINGP (attrs
[LFACE_BOX_INDEX
])
3246 || INTEGERP (attrs
[LFACE_BOX_INDEX
])
3247 || CONSP (attrs
[LFACE_BOX_INDEX
]));
3248 xassert (UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
3249 || IGNORE_DEFFACE_P (attrs
[LFACE_INVERSE_INDEX
])
3250 || SYMBOLP (attrs
[LFACE_INVERSE_INDEX
]));
3251 xassert (UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
3252 || IGNORE_DEFFACE_P (attrs
[LFACE_FOREGROUND_INDEX
])
3253 || STRINGP (attrs
[LFACE_FOREGROUND_INDEX
]));
3254 xassert (UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
3255 || IGNORE_DEFFACE_P (attrs
[LFACE_BACKGROUND_INDEX
])
3256 || STRINGP (attrs
[LFACE_BACKGROUND_INDEX
]));
3257 xassert (UNSPECIFIEDP (attrs
[LFACE_INHERIT_INDEX
])
3258 || IGNORE_DEFFACE_P (attrs
[LFACE_INHERIT_INDEX
])
3259 || NILP (attrs
[LFACE_INHERIT_INDEX
])
3260 || SYMBOLP (attrs
[LFACE_INHERIT_INDEX
])
3261 || CONSP (attrs
[LFACE_INHERIT_INDEX
]));
3262 #ifdef HAVE_WINDOW_SYSTEM
3263 xassert (UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
3264 || IGNORE_DEFFACE_P (attrs
[LFACE_STIPPLE_INDEX
])
3265 || SYMBOLP (attrs
[LFACE_STIPPLE_INDEX
])
3266 || !NILP (Fbitmap_spec_p (attrs
[LFACE_STIPPLE_INDEX
])));
3267 xassert (UNSPECIFIEDP (attrs
[LFACE_FONT_INDEX
])
3268 || IGNORE_DEFFACE_P (attrs
[LFACE_FONT_INDEX
])
3269 || NILP (attrs
[LFACE_FONT_INDEX
])
3270 #ifdef USE_FONT_BACKEND
3271 || FONT_OBJECT_P (attrs
[LFACE_FONT_INDEX
])
3272 #endif /* USE_FONT_BACKEND */
3273 || STRINGP (attrs
[LFACE_FONT_INDEX
]));
3274 xassert (UNSPECIFIEDP (attrs
[LFACE_FONTSET_INDEX
])
3275 || STRINGP (attrs
[LFACE_FONTSET_INDEX
]));
3280 /* Check consistency of attributes of Lisp face LFACE (a Lisp vector). */
3288 xassert (LFACEP (lface
));
3289 check_lface_attrs (XVECTOR (lface
)->contents
);
3293 #else /* GLYPH_DEBUG == 0 */
3295 #define check_lface_attrs(attrs) (void) 0
3296 #define check_lface(lface) (void) 0
3298 #endif /* GLYPH_DEBUG == 0 */
3302 /* Face-merge cycle checking. */
3304 /* A `named merge point' is simply a point during face-merging where we
3305 look up a face by name. We keep a stack of which named lookups we're
3306 currently processing so that we can easily detect cycles, using a
3307 linked- list of struct named_merge_point structures, typically
3308 allocated on the stack frame of the named lookup functions which are
3309 active (so no consing is required). */
3310 struct named_merge_point
3312 Lisp_Object face_name
;
3313 struct named_merge_point
*prev
;
3317 /* If a face merging cycle is detected for FACE_NAME, return 0,
3318 otherwise add NEW_NAMED_MERGE_POINT, which is initialized using
3319 FACE_NAME, as the head of the linked list pointed to by
3320 NAMED_MERGE_POINTS, and return 1. */
3323 push_named_merge_point (struct named_merge_point
*new_named_merge_point
,
3324 Lisp_Object face_name
,
3325 struct named_merge_point
**named_merge_points
)
3327 struct named_merge_point
*prev
;
3329 for (prev
= *named_merge_points
; prev
; prev
= prev
->prev
)
3330 if (EQ (face_name
, prev
->face_name
))
3333 new_named_merge_point
->face_name
= face_name
;
3334 new_named_merge_point
->prev
= *named_merge_points
;
3336 *named_merge_points
= new_named_merge_point
;
3343 #if 0 /* Seems to be unused. */
3345 internal_resolve_face_name (nargs
, args
)
3349 return Fget (args
[0], args
[1]);
3353 resolve_face_name_error (ignore
)
3360 /* Resolve face name FACE_NAME. If FACE_NAME is a string, intern it
3361 to make it a symbol. If FACE_NAME is an alias for another face,
3362 return that face's name.
3364 Return default face in case of errors. */
3367 resolve_face_name (face_name
, signal_p
)
3368 Lisp_Object face_name
;
3371 Lisp_Object orig_face
;
3372 Lisp_Object tortoise
, hare
;
3374 if (STRINGP (face_name
))
3375 face_name
= intern (SDATA (face_name
));
3377 if (NILP (face_name
) || !SYMBOLP (face_name
))
3380 orig_face
= face_name
;
3381 tortoise
= hare
= face_name
;
3386 hare
= Fget (hare
, Qface_alias
);
3387 if (NILP (hare
) || !SYMBOLP (hare
))
3391 hare
= Fget (hare
, Qface_alias
);
3392 if (NILP (hare
) || !SYMBOLP (hare
))
3395 tortoise
= Fget (tortoise
, Qface_alias
);
3396 if (EQ (hare
, tortoise
))
3399 xsignal1 (Qcircular_list
, orig_face
);
3408 /* Return the face definition of FACE_NAME on frame F. F null means
3409 return the definition for new frames. FACE_NAME may be a string or
3410 a symbol (apparently Emacs 20.2 allowed strings as face names in
3411 face text properties; Ediff uses that). If FACE_NAME is an alias
3412 for another face, return that face's definition. If SIGNAL_P is
3413 non-zero, signal an error if FACE_NAME is not a valid face name.
3414 If SIGNAL_P is zero, value is nil if FACE_NAME is not a valid face
3417 static INLINE Lisp_Object
3418 lface_from_face_name (f
, face_name
, signal_p
)
3420 Lisp_Object face_name
;
3425 face_name
= resolve_face_name (face_name
, signal_p
);
3428 lface
= assq_no_quit (face_name
, f
->face_alist
);
3430 lface
= assq_no_quit (face_name
, Vface_new_frame_defaults
);
3433 lface
= XCDR (lface
);
3435 signal_error ("Invalid face", face_name
);
3437 check_lface (lface
);
3442 /* Get face attributes of face FACE_NAME from frame-local faces on
3443 frame F. Store the resulting attributes in ATTRS which must point
3444 to a vector of Lisp_Objects of size LFACE_VECTOR_SIZE. If SIGNAL_P
3445 is non-zero, signal an error if FACE_NAME does not name a face.
3446 Otherwise, value is zero if FACE_NAME is not a face. */
3449 get_lface_attributes (f
, face_name
, attrs
, signal_p
)
3451 Lisp_Object face_name
;
3458 lface
= lface_from_face_name (f
, face_name
, signal_p
);
3461 bcopy (XVECTOR (lface
)->contents
, attrs
,
3462 LFACE_VECTOR_SIZE
* sizeof *attrs
);
3472 /* Non-zero if all attributes in face attribute vector ATTRS are
3473 specified, i.e. are non-nil. */
3476 lface_fully_specified_p (attrs
)
3481 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3482 if (i
!= LFACE_FONT_INDEX
&& i
!= LFACE_INHERIT_INDEX
3483 && i
!= LFACE_AVGWIDTH_INDEX
&& i
!= LFACE_FONTSET_INDEX
)
3484 if ((UNSPECIFIEDP (attrs
[i
]) || IGNORE_DEFFACE_P (attrs
[i
]))
3486 /* MAC_TODO: No stipple support on Mac OS yet, this index is
3487 always unspecified. */
3488 && i
!= LFACE_STIPPLE_INDEX
3493 return i
== LFACE_VECTOR_SIZE
;
3496 #ifdef HAVE_WINDOW_SYSTEM
3498 /* Set font-related attributes of Lisp face LFACE from the fullname of
3499 the font opened by FONTNAME. If FORCE_P is zero, set only
3500 unspecified attributes of LFACE. The exception is `font'
3501 attribute. It is set to FONTNAME as is regardless of FORCE_P.
3503 If FONTNAME is not available on frame F,
3504 return 0 if MAY_FAIL_P is non-zero, otherwise abort.
3505 If the fullname is not in a valid XLFD format,
3506 return 0 if MAY_FAIL_P is non-zero, otherwise set normal values
3507 in LFACE and return 1.
3508 Otherwise, return 1. */
3511 set_lface_from_font_name (f
, lface
, fontname
, force_p
, may_fail_p
)
3514 Lisp_Object fontname
;
3515 int force_p
, may_fail_p
;
3517 struct font_name font
;
3522 char *font_name
= SDATA (fontname
);
3523 struct font_info
*font_info
;
3525 /* If FONTNAME is actually a fontset name, get ASCII font name of it. */
3526 fontset
= fs_query_fontset (fontname
, 0);
3529 font_name
= SDATA (fontset_ascii (fontset
));
3530 else if (fontset
== 0)
3537 /* Check if FONT_NAME is surely available on the system. Usually
3538 FONT_NAME is already cached for the frame F and FS_LOAD_FONT
3539 returns quickly. But, even if FONT_NAME is not yet cached,
3540 caching it now is not futail because we anyway load the font
3543 font_info
= FS_LOAD_FONT (f
, font_name
);
3553 font
.name
= STRDUPA (font_info
->full_name
);
3554 have_xlfd_p
= split_font_name (f
, &font
, 1);
3556 /* Set attributes only if unspecified, otherwise face defaults for
3557 new frames would never take effect. If we couldn't get a font
3558 name conforming to XLFD, set normal values. */
3560 if (force_p
|| UNSPECIFIEDP (LFACE_FAMILY (lface
)))
3565 buffer
= (char *) alloca (strlen (font
.fields
[XLFD_FAMILY
])
3566 + strlen (font
.fields
[XLFD_FOUNDRY
])
3568 sprintf (buffer
, "%s-%s", font
.fields
[XLFD_FOUNDRY
],
3569 font
.fields
[XLFD_FAMILY
]);
3570 val
= build_string (buffer
);
3573 val
= build_string ("*");
3574 LFACE_FAMILY (lface
) = val
;
3577 if (force_p
|| UNSPECIFIEDP (LFACE_HEIGHT (lface
)))
3580 pt
= xlfd_point_size (f
, &font
);
3582 pt
= pixel_point_size (f
, font_info
->height
* 10);
3584 LFACE_HEIGHT (lface
) = make_number (pt
);
3587 if (force_p
|| UNSPECIFIEDP (LFACE_SWIDTH (lface
)))
3588 LFACE_SWIDTH (lface
)
3589 = have_xlfd_p
? xlfd_symbolic_swidth (&font
) : Qnormal
;
3591 if (force_p
|| UNSPECIFIEDP (LFACE_AVGWIDTH (lface
)))
3592 LFACE_AVGWIDTH (lface
)
3594 ? make_number (font
.numeric
[XLFD_AVGWIDTH
])
3597 if (force_p
|| UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
3598 LFACE_WEIGHT (lface
)
3599 = have_xlfd_p
? xlfd_symbolic_weight (&font
) : Qnormal
;
3601 if (force_p
|| UNSPECIFIEDP (LFACE_SLANT (lface
)))
3603 = have_xlfd_p
? xlfd_symbolic_slant (&font
) : Qnormal
;
3607 LFACE_FONT (lface
) = build_string (font_info
->full_name
);
3608 LFACE_FONTSET (lface
) = fontset_name (fontset
);
3612 LFACE_FONT (lface
) = fontname
;
3614 = new_fontset_from_font_name (build_string (font_info
->full_name
));
3615 LFACE_FONTSET (lface
) = fontset_name (fontset
);
3620 #ifdef USE_FONT_BACKEND
3621 /* Set font-related attributes of Lisp face LFACE from FONT-OBJECT and
3622 FONTSET. If FORCE_P is zero, set only unspecified attributes of
3623 LFACE. The exceptions are `font' and `fontset' attributes. They
3624 are set regardless of FORCE_P. */
3627 set_lface_from_font_and_fontset (f
, lface
, font_object
, fontset
, force_p
)
3629 Lisp_Object lface
, font_object
;
3633 struct font
*font
= XSAVE_VALUE (font_object
)->pointer
;
3634 Lisp_Object entity
= font
->entity
;
3637 /* Set attributes only if unspecified, otherwise face defaults for
3638 new frames would never take effect. If the font doesn't have a
3639 specific property, set a normal value for that. */
3641 if (force_p
|| UNSPECIFIEDP (LFACE_FAMILY (lface
)))
3643 Lisp_Object foundry
= AREF (entity
, FONT_FOUNDRY_INDEX
);
3644 Lisp_Object family
= AREF (entity
, FONT_FAMILY_INDEX
);
3646 if (! NILP (foundry
))
3648 if (! NILP (family
))
3649 val
= concat3 (SYMBOL_NAME (foundry
), build_string ("-"),
3650 SYMBOL_NAME (family
));
3652 val
= concat2 (SYMBOL_NAME (foundry
), build_string ("-*"));
3656 if (! NILP (family
))
3657 val
= SYMBOL_NAME (family
);
3659 val
= build_string ("*");
3661 LFACE_FAMILY (lface
) = val
;
3664 if (force_p
|| UNSPECIFIEDP (LFACE_HEIGHT (lface
)))
3666 int pt
= pixel_point_size (f
, font
->pixel_size
* 10);
3669 LFACE_HEIGHT (lface
) = make_number (pt
);
3672 if (force_p
|| UNSPECIFIEDP (LFACE_AVGWIDTH (lface
)))
3673 LFACE_AVGWIDTH (lface
) = make_number (font
->font
.average_width
);
3675 if (force_p
|| UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
3677 Lisp_Object weight
= font_symbolic_weight (entity
);
3679 val
= NILP (weight
) ? Qnormal
: face_symbolic_weight (weight
);
3680 LFACE_WEIGHT (lface
) = ! NILP (val
) ? val
: weight
;
3682 if (force_p
|| UNSPECIFIEDP (LFACE_SLANT (lface
)))
3684 Lisp_Object slant
= font_symbolic_slant (entity
);
3686 val
= NILP (slant
) ? Qnormal
: face_symbolic_slant (slant
);
3687 LFACE_SLANT (lface
) = ! NILP (val
) ? val
: slant
;
3689 if (force_p
|| UNSPECIFIEDP (LFACE_SWIDTH (lface
)))
3691 Lisp_Object width
= font_symbolic_width (entity
);
3693 val
= NILP (width
) ? Qnormal
: face_symbolic_swidth (width
);
3694 LFACE_SWIDTH (lface
) = ! NILP (val
) ? val
: width
;
3697 LFACE_FONT (lface
) = make_unibyte_string (font
->font
.full_name
,
3698 strlen (font
->font
.full_name
));
3699 LFACE_FONTSET (lface
) = fontset_name (fontset
);
3701 #endif /* USE_FONT_BACKEND */
3703 #endif /* HAVE_WINDOW_SYSTEM */
3706 /* Merges the face height FROM with the face height TO, and returns the
3707 merged height. If FROM is an invalid height, then INVALID is
3708 returned instead. FROM and TO may be either absolute face heights or
3709 `relative' heights; the returned value is always an absolute height
3710 unless both FROM and TO are relative. GCPRO is a lisp value that
3711 will be protected from garbage-collection if this function makes a
3715 merge_face_heights (from
, to
, invalid
)
3716 Lisp_Object from
, to
, invalid
;
3718 Lisp_Object result
= invalid
;
3720 if (INTEGERP (from
))
3721 /* FROM is absolute, just use it as is. */
3723 else if (FLOATP (from
))
3724 /* FROM is a scale, use it to adjust TO. */
3727 /* relative X absolute => absolute */
3728 result
= make_number ((EMACS_INT
)(XFLOAT_DATA (from
) * XINT (to
)));
3729 else if (FLOATP (to
))
3730 /* relative X relative => relative */
3731 result
= make_float (XFLOAT_DATA (from
) * XFLOAT_DATA (to
));
3732 else if (UNSPECIFIEDP (to
))
3735 else if (FUNCTIONP (from
))
3736 /* FROM is a function, which use to adjust TO. */
3738 /* Call function with current height as argument.
3739 From is the new height. */
3740 Lisp_Object args
[2];
3744 result
= safe_call (2, args
);
3746 /* Ensure that if TO was absolute, so is the result. */
3747 if (INTEGERP (to
) && !INTEGERP (result
))
3755 /* Merge two Lisp face attribute vectors on frame F, FROM and TO, and
3756 store the resulting attributes in TO, which must be already be
3757 completely specified and contain only absolute attributes. Every
3758 specified attribute of FROM overrides the corresponding attribute of
3759 TO; relative attributes in FROM are merged with the absolute value in
3760 TO and replace it. NAMED_MERGE_POINTS is used internally to detect
3761 loops in face inheritance; it should be 0 when called from other
3765 merge_face_vectors (f
, from
, to
, named_merge_points
)
3767 Lisp_Object
*from
, *to
;
3768 struct named_merge_point
*named_merge_points
;
3772 /* If FROM inherits from some other faces, merge their attributes into
3773 TO before merging FROM's direct attributes. Note that an :inherit
3774 attribute of `unspecified' is the same as one of nil; we never
3775 merge :inherit attributes, so nil is more correct, but lots of
3776 other code uses `unspecified' as a generic value for face attributes. */
3777 if (!UNSPECIFIEDP (from
[LFACE_INHERIT_INDEX
])
3778 && !NILP (from
[LFACE_INHERIT_INDEX
]))
3779 merge_face_ref (f
, from
[LFACE_INHERIT_INDEX
], to
, 0, named_merge_points
);
3781 /* If TO specifies a :font attribute, and FROM specifies some
3782 font-related attribute, we need to clear TO's :font attribute
3783 (because it will be inconsistent with whatever FROM specifies, and
3784 FROM takes precedence). */
3785 if (!NILP (to
[LFACE_FONT_INDEX
])
3786 && (!UNSPECIFIEDP (from
[LFACE_FAMILY_INDEX
])
3787 || !UNSPECIFIEDP (from
[LFACE_HEIGHT_INDEX
])
3788 || !UNSPECIFIEDP (from
[LFACE_WEIGHT_INDEX
])
3789 || !UNSPECIFIEDP (from
[LFACE_SLANT_INDEX
])
3790 || !UNSPECIFIEDP (from
[LFACE_SWIDTH_INDEX
])
3791 || !UNSPECIFIEDP (from
[LFACE_AVGWIDTH_INDEX
])))
3792 to
[LFACE_FONT_INDEX
] = Qnil
;
3794 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3795 if (!UNSPECIFIEDP (from
[i
]))
3797 if (i
== LFACE_HEIGHT_INDEX
&& !INTEGERP (from
[i
]))
3798 to
[i
] = merge_face_heights (from
[i
], to
[i
], to
[i
]);
3803 /* TO is always an absolute face, which should inherit from nothing.
3804 We blindly copy the :inherit attribute above and fix it up here. */
3805 to
[LFACE_INHERIT_INDEX
] = Qnil
;
3808 /* Merge the named face FACE_NAME on frame F, into the vector of face
3809 attributes TO. NAMED_MERGE_POINTS is used to detect loops in face
3810 inheritance. Returns true if FACE_NAME is a valid face name and
3811 merging succeeded. */
3814 merge_named_face (f
, face_name
, to
, named_merge_points
)
3816 Lisp_Object face_name
;
3818 struct named_merge_point
*named_merge_points
;
3820 struct named_merge_point named_merge_point
;
3822 if (push_named_merge_point (&named_merge_point
,
3823 face_name
, &named_merge_points
))
3825 struct gcpro gcpro1
;
3826 Lisp_Object from
[LFACE_VECTOR_SIZE
];
3827 int ok
= get_lface_attributes (f
, face_name
, from
, 0);
3831 GCPRO1 (named_merge_point
.face_name
);
3832 merge_face_vectors (f
, from
, to
, named_merge_points
);
3843 /* Merge face attributes from the lisp `face reference' FACE_REF on
3844 frame F into the face attribute vector TO. If ERR_MSGS is non-zero,
3845 problems with FACE_REF cause an error message to be shown. Return
3846 non-zero if no errors occurred (regardless of the value of ERR_MSGS).
3847 NAMED_MERGE_POINTS is used to detect loops in face inheritance or
3848 list structure; it may be 0 for most callers.
3850 FACE_REF may be a single face specification or a list of such
3851 specifications. Each face specification can be:
3853 1. A symbol or string naming a Lisp face.
3855 2. A property list of the form (KEYWORD VALUE ...) where each
3856 KEYWORD is a face attribute name, and value is an appropriate value
3859 3. Conses or the form (FOREGROUND-COLOR . COLOR) or
3860 (BACKGROUND-COLOR . COLOR) where COLOR is a color name. This is
3861 for compatibility with 20.2.
3863 Face specifications earlier in lists take precedence over later
3867 merge_face_ref (f
, face_ref
, to
, err_msgs
, named_merge_points
)
3869 Lisp_Object face_ref
;
3872 struct named_merge_point
*named_merge_points
;
3874 int ok
= 1; /* Succeed without an error? */
3876 if (CONSP (face_ref
))
3878 Lisp_Object first
= XCAR (face_ref
);
3880 if (EQ (first
, Qforeground_color
)
3881 || EQ (first
, Qbackground_color
))
3883 /* One of (FOREGROUND-COLOR . COLOR) or (BACKGROUND-COLOR
3884 . COLOR). COLOR must be a string. */
3885 Lisp_Object color_name
= XCDR (face_ref
);
3886 Lisp_Object color
= first
;
3888 if (STRINGP (color_name
))
3890 if (EQ (color
, Qforeground_color
))
3891 to
[LFACE_FOREGROUND_INDEX
] = color_name
;
3893 to
[LFACE_BACKGROUND_INDEX
] = color_name
;
3898 add_to_log ("Invalid face color", color_name
, Qnil
);
3902 else if (SYMBOLP (first
)
3903 && *SDATA (SYMBOL_NAME (first
)) == ':')
3905 /* Assume this is the property list form. */
3906 while (CONSP (face_ref
) && CONSP (XCDR (face_ref
)))
3908 Lisp_Object keyword
= XCAR (face_ref
);
3909 Lisp_Object value
= XCAR (XCDR (face_ref
));
3912 /* Specifying `unspecified' is a no-op. */
3913 if (EQ (value
, Qunspecified
))
3915 else if (EQ (keyword
, QCfamily
))
3917 if (STRINGP (value
))
3918 to
[LFACE_FAMILY_INDEX
] = value
;
3922 else if (EQ (keyword
, QCheight
))
3924 Lisp_Object new_height
=
3925 merge_face_heights (value
, to
[LFACE_HEIGHT_INDEX
], Qnil
);
3927 if (! NILP (new_height
))
3928 to
[LFACE_HEIGHT_INDEX
] = new_height
;
3932 else if (EQ (keyword
, QCweight
))
3935 && face_numeric_weight (value
) >= 0)
3936 to
[LFACE_WEIGHT_INDEX
] = value
;
3940 else if (EQ (keyword
, QCslant
))
3943 && face_numeric_slant (value
) >= 0)
3944 to
[LFACE_SLANT_INDEX
] = value
;
3948 else if (EQ (keyword
, QCunderline
))
3953 to
[LFACE_UNDERLINE_INDEX
] = value
;
3957 else if (EQ (keyword
, QCoverline
))
3962 to
[LFACE_OVERLINE_INDEX
] = value
;
3966 else if (EQ (keyword
, QCstrike_through
))
3971 to
[LFACE_STRIKE_THROUGH_INDEX
] = value
;
3975 else if (EQ (keyword
, QCbox
))
3978 value
= make_number (1);
3979 if (INTEGERP (value
)
3983 to
[LFACE_BOX_INDEX
] = value
;
3987 else if (EQ (keyword
, QCinverse_video
)
3988 || EQ (keyword
, QCreverse_video
))
3990 if (EQ (value
, Qt
) || NILP (value
))
3991 to
[LFACE_INVERSE_INDEX
] = value
;
3995 else if (EQ (keyword
, QCforeground
))
3997 if (STRINGP (value
))
3998 to
[LFACE_FOREGROUND_INDEX
] = value
;
4002 else if (EQ (keyword
, QCbackground
))
4004 if (STRINGP (value
))
4005 to
[LFACE_BACKGROUND_INDEX
] = value
;
4009 else if (EQ (keyword
, QCstipple
))
4011 #ifdef HAVE_X_WINDOWS
4012 Lisp_Object pixmap_p
= Fbitmap_spec_p (value
);
4013 if (!NILP (pixmap_p
))
4014 to
[LFACE_STIPPLE_INDEX
] = value
;
4019 else if (EQ (keyword
, QCwidth
))
4022 && face_numeric_swidth (value
) >= 0)
4023 to
[LFACE_SWIDTH_INDEX
] = value
;
4027 else if (EQ (keyword
, QCinherit
))
4029 /* This is not really very useful; it's just like a
4030 normal face reference. */
4031 if (! merge_face_ref (f
, value
, to
,
4032 err_msgs
, named_merge_points
))
4040 add_to_log ("Invalid face attribute %S %S", keyword
, value
);
4044 face_ref
= XCDR (XCDR (face_ref
));
4049 /* This is a list of face refs. Those at the beginning of the
4050 list take precedence over what follows, so we have to merge
4051 from the end backwards. */
4052 Lisp_Object next
= XCDR (face_ref
);
4055 ok
= merge_face_ref (f
, next
, to
, err_msgs
, named_merge_points
);
4057 if (! merge_face_ref (f
, first
, to
, err_msgs
, named_merge_points
))
4063 /* FACE_REF ought to be a face name. */
4064 ok
= merge_named_face (f
, face_ref
, to
, named_merge_points
);
4065 if (!ok
&& err_msgs
)
4066 add_to_log ("Invalid face reference: %s", face_ref
, Qnil
);
4073 DEFUN ("internal-make-lisp-face", Finternal_make_lisp_face
,
4074 Sinternal_make_lisp_face
, 1, 2, 0,
4075 doc
: /* Make FACE, a symbol, a Lisp face with all attributes nil.
4076 If FACE was not known as a face before, create a new one.
4077 If optional argument FRAME is specified, make a frame-local face
4078 for that frame. Otherwise operate on the global face definition.
4079 Value is a vector of face attributes. */)
4081 Lisp_Object face
, frame
;
4083 Lisp_Object global_lface
, lface
;
4087 CHECK_SYMBOL (face
);
4088 global_lface
= lface_from_face_name (NULL
, face
, 0);
4092 CHECK_LIVE_FRAME (frame
);
4094 lface
= lface_from_face_name (f
, face
, 0);
4097 f
= NULL
, lface
= Qnil
;
4099 /* Add a global definition if there is none. */
4100 if (NILP (global_lface
))
4102 global_lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
4104 ASET (global_lface
, 0, Qface
);
4105 Vface_new_frame_defaults
= Fcons (Fcons (face
, global_lface
),
4106 Vface_new_frame_defaults
);
4108 /* Assign the new Lisp face a unique ID. The mapping from Lisp
4109 face id to Lisp face is given by the vector lface_id_to_name.
4110 The mapping from Lisp face to Lisp face id is given by the
4111 property `face' of the Lisp face name. */
4112 if (next_lface_id
== lface_id_to_name_size
)
4114 int new_size
= max (50, 2 * lface_id_to_name_size
);
4115 int sz
= new_size
* sizeof *lface_id_to_name
;
4116 lface_id_to_name
= (Lisp_Object
*) xrealloc (lface_id_to_name
, sz
);
4117 lface_id_to_name_size
= new_size
;
4120 lface_id_to_name
[next_lface_id
] = face
;
4121 Fput (face
, Qface
, make_number (next_lface_id
));
4125 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
4126 ASET (global_lface
, i
, Qunspecified
);
4128 /* Add a frame-local definition. */
4133 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
4135 ASET (lface
, 0, Qface
);
4136 f
->face_alist
= Fcons (Fcons (face
, lface
), f
->face_alist
);
4139 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
4140 ASET (lface
, i
, Qunspecified
);
4143 lface
= global_lface
;
4145 /* Changing a named face means that all realized faces depending on
4146 that face are invalid. Since we cannot tell which realized faces
4147 depend on the face, make sure they are all removed. This is done
4148 by incrementing face_change_count. The next call to
4149 init_iterator will then free realized faces. */
4150 if (NILP (Fget (face
, Qface_no_inherit
)))
4152 ++face_change_count
;
4153 ++windows_or_buffers_changed
;
4156 xassert (LFACEP (lface
));
4157 check_lface (lface
);
4162 DEFUN ("internal-lisp-face-p", Finternal_lisp_face_p
,
4163 Sinternal_lisp_face_p
, 1, 2, 0,
4164 doc
: /* Return non-nil if FACE names a face.
4165 If optional second argument FRAME is non-nil, check for the
4166 existence of a frame-local face with name FACE on that frame.
4167 Otherwise check for the existence of a global face. */)
4169 Lisp_Object face
, frame
;
4173 face
= resolve_face_name (face
, 1);
4177 CHECK_LIVE_FRAME (frame
);
4178 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
4181 lface
= lface_from_face_name (NULL
, face
, 0);
4187 DEFUN ("internal-copy-lisp-face", Finternal_copy_lisp_face
,
4188 Sinternal_copy_lisp_face
, 4, 4, 0,
4189 doc
: /* Copy face FROM to TO.
4190 If FRAME is t, copy the global face definition of FROM.
4191 Otherwise, copy the frame-local definition of FROM on FRAME.
4192 If NEW-FRAME is a frame, copy that data into the frame-local
4193 definition of TO on NEW-FRAME. If NEW-FRAME is nil.
4194 FRAME controls where the data is copied to.
4196 The value is TO. */)
4197 (from
, to
, frame
, new_frame
)
4198 Lisp_Object from
, to
, frame
, new_frame
;
4200 Lisp_Object lface
, copy
;
4202 CHECK_SYMBOL (from
);
4207 /* Copy global definition of FROM. We don't make copies of
4208 strings etc. because 20.2 didn't do it either. */
4209 lface
= lface_from_face_name (NULL
, from
, 1);
4210 copy
= Finternal_make_lisp_face (to
, Qnil
);
4214 /* Copy frame-local definition of FROM. */
4215 if (NILP (new_frame
))
4217 CHECK_LIVE_FRAME (frame
);
4218 CHECK_LIVE_FRAME (new_frame
);
4219 lface
= lface_from_face_name (XFRAME (frame
), from
, 1);
4220 copy
= Finternal_make_lisp_face (to
, new_frame
);
4223 bcopy (XVECTOR (lface
)->contents
, XVECTOR (copy
)->contents
,
4224 LFACE_VECTOR_SIZE
* sizeof (Lisp_Object
));
4226 /* Changing a named face means that all realized faces depending on
4227 that face are invalid. Since we cannot tell which realized faces
4228 depend on the face, make sure they are all removed. This is done
4229 by incrementing face_change_count. The next call to
4230 init_iterator will then free realized faces. */
4231 if (NILP (Fget (to
, Qface_no_inherit
)))
4233 ++face_change_count
;
4234 ++windows_or_buffers_changed
;
4241 DEFUN ("internal-set-lisp-face-attribute", Finternal_set_lisp_face_attribute
,
4242 Sinternal_set_lisp_face_attribute
, 3, 4, 0,
4243 doc
: /* Set attribute ATTR of FACE to VALUE.
4244 FRAME being a frame means change the face on that frame.
4245 FRAME nil means change the face of the selected frame.
4246 FRAME t means change the default for new frames.
4247 FRAME 0 means change the face on all frames, and change the default
4249 (face
, attr
, value
, frame
)
4250 Lisp_Object face
, attr
, value
, frame
;
4253 Lisp_Object old_value
= Qnil
;
4254 /* Set 1 if ATTR is QCfont. */
4255 int font_attr_p
= 0;
4256 /* Set 1 if ATTR is one of font-related attributes other than QCfont. */
4257 int font_related_attr_p
= 0;
4259 CHECK_SYMBOL (face
);
4260 CHECK_SYMBOL (attr
);
4262 face
= resolve_face_name (face
, 1);
4264 /* If FRAME is 0, change face on all frames, and change the
4265 default for new frames. */
4266 if (INTEGERP (frame
) && XINT (frame
) == 0)
4269 Finternal_set_lisp_face_attribute (face
, attr
, value
, Qt
);
4270 FOR_EACH_FRAME (tail
, frame
)
4271 Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
4275 /* Set lface to the Lisp attribute vector of FACE. */
4278 lface
= lface_from_face_name (NULL
, face
, 1);
4280 /* When updating face-new-frame-defaults, we put :ignore-defface
4281 where the caller wants `unspecified'. This forces the frame
4282 defaults to ignore the defface value. Otherwise, the defface
4283 will take effect, which is generally not what is intended.
4284 The value of that attribute will be inherited from some other
4285 face during face merging. See internal_merge_in_global_face. */
4286 if (UNSPECIFIEDP (value
))
4287 value
= Qignore_defface
;
4292 frame
= selected_frame
;
4294 CHECK_LIVE_FRAME (frame
);
4295 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
4297 /* If a frame-local face doesn't exist yet, create one. */
4299 lface
= Finternal_make_lisp_face (face
, frame
);
4302 if (EQ (attr
, QCfamily
))
4304 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4306 CHECK_STRING (value
);
4307 if (SCHARS (value
) == 0)
4308 signal_error ("Invalid face family", value
);
4310 old_value
= LFACE_FAMILY (lface
);
4311 LFACE_FAMILY (lface
) = value
;
4312 font_related_attr_p
= 1;
4314 else if (EQ (attr
, QCheight
))
4316 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4320 test
= (EQ (face
, Qdefault
)
4322 /* The default face must have an absolute size,
4323 otherwise, we do a test merge with a random
4324 height to see if VALUE's ok. */
4325 : merge_face_heights (value
, make_number (10), Qnil
));
4327 if (!INTEGERP (test
) || XINT (test
) <= 0)
4328 signal_error ("Invalid face height", value
);
4331 old_value
= LFACE_HEIGHT (lface
);
4332 LFACE_HEIGHT (lface
) = value
;
4333 font_related_attr_p
= 1;
4335 else if (EQ (attr
, QCweight
))
4337 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4339 CHECK_SYMBOL (value
);
4340 if (face_numeric_weight (value
) < 0)
4341 signal_error ("Invalid face weight", value
);
4343 old_value
= LFACE_WEIGHT (lface
);
4344 LFACE_WEIGHT (lface
) = value
;
4345 font_related_attr_p
= 1;
4347 else if (EQ (attr
, QCslant
))
4349 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4351 CHECK_SYMBOL (value
);
4352 if (face_numeric_slant (value
) < 0)
4353 signal_error ("Invalid face slant", value
);
4355 old_value
= LFACE_SLANT (lface
);
4356 LFACE_SLANT (lface
) = value
;
4357 font_related_attr_p
= 1;
4359 else if (EQ (attr
, QCunderline
))
4361 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4362 if ((SYMBOLP (value
)
4364 && !EQ (value
, Qnil
))
4365 /* Underline color. */
4367 && SCHARS (value
) == 0))
4368 signal_error ("Invalid face underline", value
);
4370 old_value
= LFACE_UNDERLINE (lface
);
4371 LFACE_UNDERLINE (lface
) = value
;
4373 else if (EQ (attr
, QCoverline
))
4375 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4376 if ((SYMBOLP (value
)
4378 && !EQ (value
, Qnil
))
4379 /* Overline color. */
4381 && SCHARS (value
) == 0))
4382 signal_error ("Invalid face overline", value
);
4384 old_value
= LFACE_OVERLINE (lface
);
4385 LFACE_OVERLINE (lface
) = value
;
4387 else if (EQ (attr
, QCstrike_through
))
4389 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4390 if ((SYMBOLP (value
)
4392 && !EQ (value
, Qnil
))
4393 /* Strike-through color. */
4395 && SCHARS (value
) == 0))
4396 signal_error ("Invalid face strike-through", value
);
4398 old_value
= LFACE_STRIKE_THROUGH (lface
);
4399 LFACE_STRIKE_THROUGH (lface
) = value
;
4401 else if (EQ (attr
, QCbox
))
4405 /* Allow t meaning a simple box of width 1 in foreground color
4408 value
= make_number (1);
4410 if (UNSPECIFIEDP (value
) || IGNORE_DEFFACE_P (value
))
4412 else if (NILP (value
))
4414 else if (INTEGERP (value
))
4415 valid_p
= XINT (value
) != 0;
4416 else if (STRINGP (value
))
4417 valid_p
= SCHARS (value
) > 0;
4418 else if (CONSP (value
))
4434 if (EQ (k
, QCline_width
))
4436 if (!INTEGERP (v
) || XINT (v
) == 0)
4439 else if (EQ (k
, QCcolor
))
4441 if (!NILP (v
) && (!STRINGP (v
) || SCHARS (v
) == 0))
4444 else if (EQ (k
, QCstyle
))
4446 if (!EQ (v
, Qpressed_button
) && !EQ (v
, Qreleased_button
))
4453 valid_p
= NILP (tem
);
4459 signal_error ("Invalid face box", value
);
4461 old_value
= LFACE_BOX (lface
);
4462 LFACE_BOX (lface
) = value
;
4464 else if (EQ (attr
, QCinverse_video
)
4465 || EQ (attr
, QCreverse_video
))
4467 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4469 CHECK_SYMBOL (value
);
4470 if (!EQ (value
, Qt
) && !NILP (value
))
4471 signal_error ("Invalid inverse-video face attribute value", value
);
4473 old_value
= LFACE_INVERSE (lface
);
4474 LFACE_INVERSE (lface
) = value
;
4476 else if (EQ (attr
, QCforeground
))
4478 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4480 /* Don't check for valid color names here because it depends
4481 on the frame (display) whether the color will be valid
4482 when the face is realized. */
4483 CHECK_STRING (value
);
4484 if (SCHARS (value
) == 0)
4485 signal_error ("Empty foreground color value", value
);
4487 old_value
= LFACE_FOREGROUND (lface
);
4488 LFACE_FOREGROUND (lface
) = value
;
4490 else if (EQ (attr
, QCbackground
))
4492 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4494 /* Don't check for valid color names here because it depends
4495 on the frame (display) whether the color will be valid
4496 when the face is realized. */
4497 CHECK_STRING (value
);
4498 if (SCHARS (value
) == 0)
4499 signal_error ("Empty background color value", value
);
4501 old_value
= LFACE_BACKGROUND (lface
);
4502 LFACE_BACKGROUND (lface
) = value
;
4504 else if (EQ (attr
, QCstipple
))
4506 #ifdef HAVE_X_WINDOWS
4507 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
)
4509 && NILP (Fbitmap_spec_p (value
)))
4510 signal_error ("Invalid stipple attribute", value
);
4511 old_value
= LFACE_STIPPLE (lface
);
4512 LFACE_STIPPLE (lface
) = value
;
4513 #endif /* HAVE_X_WINDOWS */
4515 else if (EQ (attr
, QCwidth
))
4517 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4519 CHECK_SYMBOL (value
);
4520 if (face_numeric_swidth (value
) < 0)
4521 signal_error ("Invalid face width", value
);
4523 old_value
= LFACE_SWIDTH (lface
);
4524 LFACE_SWIDTH (lface
) = value
;
4525 font_related_attr_p
= 1;
4527 else if (EQ (attr
, QCfont
) || EQ (attr
, QCfontset
))
4529 #ifdef HAVE_WINDOW_SYSTEM
4530 if (EQ (frame
, Qt
) || FRAME_WINDOW_P (XFRAME (frame
)))
4532 /* Set font-related attributes of the Lisp face from an XLFD
4538 f
= SELECTED_FRAME ();
4540 f
= check_x_frame (frame
);
4542 #ifdef USE_FONT_BACKEND
4543 if (enable_font_backend
4544 && !UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4546 tmp
= Fquery_fontset (value
, Qnil
);
4547 if (EQ (attr
, QCfontset
))
4550 signal_error ("Invalid fontset name", value
);
4551 LFACE_FONTSET (lface
) = tmp
;
4556 Lisp_Object font_object
;
4560 fontset
= fs_query_fontset (tmp
, 0);
4561 value
= fontset_ascii (fontset
);
4565 fontset
= FRAME_FONTSET (f
);
4567 font_object
= font_open_by_name (f
, SDATA (value
));
4568 if (NILP (font_object
))
4569 signal_error ("Invalid font", value
);
4570 set_lface_from_font_and_fontset (f
, lface
, font_object
,
4575 #endif /* USE_FONT_BACKEND */
4576 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4578 CHECK_STRING (value
);
4580 /* VALUE may be a fontset name or an alias of fontset. In
4581 such a case, use the base fontset name. */
4582 tmp
= Fquery_fontset (value
, Qnil
);
4585 else if (EQ (attr
, QCfontset
))
4586 signal_error ("Invalid fontset name", value
);
4588 if (EQ (attr
, QCfont
))
4590 if (!set_lface_from_font_name (f
, lface
, value
, 1, 1))
4591 signal_error ("Invalid font or fontset name", value
);
4594 LFACE_FONTSET (lface
) = value
;
4599 #endif /* HAVE_WINDOW_SYSTEM */
4601 else if (EQ (attr
, QCinherit
))
4604 if (SYMBOLP (value
))
4607 for (tail
= value
; CONSP (tail
); tail
= XCDR (tail
))
4608 if (!SYMBOLP (XCAR (tail
)))
4611 LFACE_INHERIT (lface
) = value
;
4613 signal_error ("Invalid face inheritance", value
);
4615 else if (EQ (attr
, QCbold
))
4617 old_value
= LFACE_WEIGHT (lface
);
4618 LFACE_WEIGHT (lface
) = NILP (value
) ? Qnormal
: Qbold
;
4619 font_related_attr_p
= 1;
4621 else if (EQ (attr
, QCitalic
))
4623 old_value
= LFACE_SLANT (lface
);
4624 LFACE_SLANT (lface
) = NILP (value
) ? Qnormal
: Qitalic
;
4625 font_related_attr_p
= 1;
4628 signal_error ("Invalid face attribute name", attr
);
4630 if (font_related_attr_p
4631 && !UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
))
4632 /* If a font-related attribute other than QCfont is specified, the
4633 original `font' attribute nor that of default face is useless
4634 to determine a new font. Thus, we set it to nil so that font
4635 selection mechanism doesn't use it. */
4636 LFACE_FONT (lface
) = Qnil
;
4638 /* Changing a named face means that all realized faces depending on
4639 that face are invalid. Since we cannot tell which realized faces
4640 depend on the face, make sure they are all removed. This is done
4641 by incrementing face_change_count. The next call to
4642 init_iterator will then free realized faces. */
4644 && NILP (Fget (face
, Qface_no_inherit
))
4645 && (EQ (attr
, QCfont
)
4646 || EQ (attr
, QCfontset
)
4647 || NILP (Fequal (old_value
, value
))))
4649 ++face_change_count
;
4650 ++windows_or_buffers_changed
;
4653 if (!UNSPECIFIEDP (value
) && !IGNORE_DEFFACE_P (value
)
4654 && NILP (Fequal (old_value
, value
)))
4660 if (EQ (face
, Qdefault
))
4662 #ifdef HAVE_WINDOW_SYSTEM
4663 /* Changed font-related attributes of the `default' face are
4664 reflected in changed `font' frame parameters. */
4666 && (font_related_attr_p
|| font_attr_p
)
4667 && lface_fully_specified_p (XVECTOR (lface
)->contents
))
4668 set_font_frame_param (frame
, lface
);
4670 #endif /* HAVE_WINDOW_SYSTEM */
4672 if (EQ (attr
, QCforeground
))
4673 param
= Qforeground_color
;
4674 else if (EQ (attr
, QCbackground
))
4675 param
= Qbackground_color
;
4677 #ifdef HAVE_WINDOW_SYSTEM
4679 else if (EQ (face
, Qscroll_bar
))
4681 /* Changing the colors of `scroll-bar' sets frame parameters
4682 `scroll-bar-foreground' and `scroll-bar-background'. */
4683 if (EQ (attr
, QCforeground
))
4684 param
= Qscroll_bar_foreground
;
4685 else if (EQ (attr
, QCbackground
))
4686 param
= Qscroll_bar_background
;
4688 #endif /* not WINDOWSNT */
4689 else if (EQ (face
, Qborder
))
4691 /* Changing background color of `border' sets frame parameter
4693 if (EQ (attr
, QCbackground
))
4694 param
= Qborder_color
;
4696 else if (EQ (face
, Qcursor
))
4698 /* Changing background color of `cursor' sets frame parameter
4700 if (EQ (attr
, QCbackground
))
4701 param
= Qcursor_color
;
4703 else if (EQ (face
, Qmouse
))
4705 /* Changing background color of `mouse' sets frame parameter
4707 if (EQ (attr
, QCbackground
))
4708 param
= Qmouse_color
;
4710 #endif /* HAVE_WINDOW_SYSTEM */
4711 else if (EQ (face
, Qmenu
))
4713 /* Indicate that we have to update the menu bar when
4714 realizing faces on FRAME. FRAME t change the
4715 default for new frames. We do this by setting
4716 setting the flag in new face caches */
4719 struct frame
*f
= XFRAME (frame
);
4720 if (FRAME_FACE_CACHE (f
) == NULL
)
4721 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
4722 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 1;
4725 menu_face_changed_default
= 1;
4731 /* Update `default-frame-alist', which is used for new frames. */
4733 store_in_alist (&Vdefault_frame_alist
, param
, value
);
4736 /* Update the current frame's parameters. */
4739 cons
= XCAR (Vparam_value_alist
);
4740 XSETCAR (cons
, param
);
4741 XSETCDR (cons
, value
);
4742 Fmodify_frame_parameters (frame
, Vparam_value_alist
);
4751 #ifdef HAVE_WINDOW_SYSTEM
4753 /* Set the `font' frame parameter of FRAME determined from `default'
4754 face attributes LFACE. If a font name is explicitely
4755 specfied in LFACE, use it as is. Otherwise, determine a font name
4756 from the other font-related atrributes of LFACE. In that case, if
4757 there's no matching font, signals an error. */
4760 set_font_frame_param (frame
, lface
)
4761 Lisp_Object frame
, lface
;
4763 struct frame
*f
= XFRAME (frame
);
4765 if (FRAME_WINDOW_P (f
))
4767 Lisp_Object font_name
;
4770 if (STRINGP (LFACE_FONT (lface
)))
4771 font_name
= LFACE_FONT (lface
);
4772 #ifdef USE_FONT_BACKEND
4773 else if (enable_font_backend
)
4775 /* We set FONT_NAME to a font-object. */
4776 if (FONT_OBJECT_P (LFACE_FONT (lface
)))
4777 font_name
= LFACE_FONT (lface
);
4780 font_name
= font_find_for_lface (f
, &AREF (lface
, 0), Qnil
, -1);
4781 if (NILP (font_name
))
4782 error ("No font matches the specified attribute");
4783 font_name
= font_open_for_lface (f
, font_name
, &AREF (lface
, 0),
4785 if (NILP (font_name
))
4786 error ("No font matches the specified attribute");
4792 /* Choose a font name that reflects LFACE's attributes and has
4793 the registry and encoding pattern specified in the default
4794 fontset (3rd arg: -1) for ASCII characters (4th arg: 0). */
4795 font
= choose_face_font (f
, XVECTOR (lface
)->contents
, Qnil
, NULL
);
4797 error ("No font matches the specified attribute");
4798 font_name
= build_string (font
);
4802 f
->default_face_done_p
= 0;
4803 Fmodify_frame_parameters (frame
, Fcons (Fcons (Qfont
, font_name
), Qnil
));
4808 /* Update the corresponding face when frame parameter PARAM on frame F
4809 has been assigned the value NEW_VALUE. */
4812 update_face_from_frame_parameter (f
, param
, new_value
)
4814 Lisp_Object param
, new_value
;
4816 Lisp_Object face
= Qnil
;
4819 /* If there are no faces yet, give up. This is the case when called
4820 from Fx_create_frame, and we do the necessary things later in
4821 face-set-after-frame-defaults. */
4822 if (NILP (f
->face_alist
))
4825 if (EQ (param
, Qforeground_color
))
4828 lface
= lface_from_face_name (f
, face
, 1);
4829 LFACE_FOREGROUND (lface
) = (STRINGP (new_value
)
4830 ? new_value
: Qunspecified
);
4831 realize_basic_faces (f
);
4833 else if (EQ (param
, Qbackground_color
))
4837 /* Changing the background color might change the background
4838 mode, so that we have to load new defface specs.
4839 Call frame-set-background-mode to do that. */
4840 XSETFRAME (frame
, f
);
4841 call1 (Qframe_set_background_mode
, frame
);
4844 lface
= lface_from_face_name (f
, face
, 1);
4845 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4846 ? new_value
: Qunspecified
);
4847 realize_basic_faces (f
);
4849 else if (EQ (param
, Qborder_color
))
4852 lface
= lface_from_face_name (f
, face
, 1);
4853 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4854 ? new_value
: Qunspecified
);
4856 else if (EQ (param
, Qcursor_color
))
4859 lface
= lface_from_face_name (f
, face
, 1);
4860 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4861 ? new_value
: Qunspecified
);
4863 else if (EQ (param
, Qmouse_color
))
4866 lface
= lface_from_face_name (f
, face
, 1);
4867 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4868 ? new_value
: Qunspecified
);
4871 /* Changing a named face means that all realized faces depending on
4872 that face are invalid. Since we cannot tell which realized faces
4873 depend on the face, make sure they are all removed. This is done
4874 by incrementing face_change_count. The next call to
4875 init_iterator will then free realized faces. */
4877 && NILP (Fget (face
, Qface_no_inherit
)))
4879 ++face_change_count
;
4880 ++windows_or_buffers_changed
;
4885 /* Get the value of X resource RESOURCE, class CLASS for the display
4886 of frame FRAME. This is here because ordinary `x-get-resource'
4887 doesn't take a frame argument. */
4889 DEFUN ("internal-face-x-get-resource", Finternal_face_x_get_resource
,
4890 Sinternal_face_x_get_resource
, 3, 3, 0, doc
: /* */)
4891 (resource
, class, frame
)
4892 Lisp_Object resource
, class, frame
;
4894 Lisp_Object value
= Qnil
;
4895 CHECK_STRING (resource
);
4896 CHECK_STRING (class);
4897 CHECK_LIVE_FRAME (frame
);
4899 value
= display_x_get_resource (FRAME_X_DISPLAY_INFO (XFRAME (frame
)),
4900 resource
, class, Qnil
, Qnil
);
4906 /* Return resource string VALUE as a boolean value, i.e. nil, or t.
4907 If VALUE is "on" or "true", return t. If VALUE is "off" or
4908 "false", return nil. Otherwise, if SIGNAL_P is non-zero, signal an
4909 error; if SIGNAL_P is zero, return 0. */
4912 face_boolean_x_resource_value (value
, signal_p
)
4916 Lisp_Object result
= make_number (0);
4918 xassert (STRINGP (value
));
4920 if (xstricmp (SDATA (value
), "on") == 0
4921 || xstricmp (SDATA (value
), "true") == 0)
4923 else if (xstricmp (SDATA (value
), "off") == 0
4924 || xstricmp (SDATA (value
), "false") == 0)
4926 else if (xstricmp (SDATA (value
), "unspecified") == 0)
4927 result
= Qunspecified
;
4929 signal_error ("Invalid face attribute value from X resource", value
);
4935 DEFUN ("internal-set-lisp-face-attribute-from-resource",
4936 Finternal_set_lisp_face_attribute_from_resource
,
4937 Sinternal_set_lisp_face_attribute_from_resource
,
4938 3, 4, 0, doc
: /* */)
4939 (face
, attr
, value
, frame
)
4940 Lisp_Object face
, attr
, value
, frame
;
4942 CHECK_SYMBOL (face
);
4943 CHECK_SYMBOL (attr
);
4944 CHECK_STRING (value
);
4946 if (xstricmp (SDATA (value
), "unspecified") == 0)
4947 value
= Qunspecified
;
4948 else if (EQ (attr
, QCheight
))
4950 value
= Fstring_to_number (value
, make_number (10));
4951 if (XINT (value
) <= 0)
4952 signal_error ("Invalid face height from X resource", value
);
4954 else if (EQ (attr
, QCbold
) || EQ (attr
, QCitalic
))
4955 value
= face_boolean_x_resource_value (value
, 1);
4956 else if (EQ (attr
, QCweight
) || EQ (attr
, QCslant
) || EQ (attr
, QCwidth
))
4957 value
= intern (SDATA (value
));
4958 else if (EQ (attr
, QCreverse_video
) || EQ (attr
, QCinverse_video
))
4959 value
= face_boolean_x_resource_value (value
, 1);
4960 else if (EQ (attr
, QCunderline
)
4961 || EQ (attr
, QCoverline
)
4962 || EQ (attr
, QCstrike_through
))
4964 Lisp_Object boolean_value
;
4966 /* If the result of face_boolean_x_resource_value is t or nil,
4967 VALUE does NOT specify a color. */
4968 boolean_value
= face_boolean_x_resource_value (value
, 0);
4969 if (SYMBOLP (boolean_value
))
4970 value
= boolean_value
;
4972 else if (EQ (attr
, QCbox
) || EQ (attr
, QCinherit
))
4973 value
= Fcar (Fread_from_string (value
, Qnil
, Qnil
));
4975 return Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
4978 #endif /* HAVE_WINDOW_SYSTEM */
4981 /***********************************************************************
4983 ***********************************************************************/
4985 #if defined HAVE_X_WINDOWS && defined USE_X_TOOLKIT
4987 /* Make menus on frame F appear as specified by the `menu' face. */
4990 x_update_menu_appearance (f
)
4993 struct x_display_info
*dpyinfo
= FRAME_X_DISPLAY_INFO (f
);
4997 && (rdb
= XrmGetDatabase (FRAME_X_DISPLAY (f
)),
5001 Lisp_Object lface
= lface_from_face_name (f
, Qmenu
, 1);
5002 struct face
*face
= FACE_FROM_ID (f
, MENU_FACE_ID
);
5003 const char *myname
= SDATA (Vx_resource_name
);
5006 const char *popup_path
= "popup_menu";
5008 const char *popup_path
= "menu.popup";
5011 if (STRINGP (LFACE_FOREGROUND (lface
)))
5013 sprintf (line
, "%s.%s*foreground: %s",
5015 SDATA (LFACE_FOREGROUND (lface
)));
5016 XrmPutLineResource (&rdb
, line
);
5017 sprintf (line
, "%s.pane.menubar*foreground: %s",
5018 myname
, SDATA (LFACE_FOREGROUND (lface
)));
5019 XrmPutLineResource (&rdb
, line
);
5023 if (STRINGP (LFACE_BACKGROUND (lface
)))
5025 sprintf (line
, "%s.%s*background: %s",
5027 SDATA (LFACE_BACKGROUND (lface
)));
5028 XrmPutLineResource (&rdb
, line
);
5029 sprintf (line
, "%s.pane.menubar*background: %s",
5030 myname
, SDATA (LFACE_BACKGROUND (lface
)));
5031 XrmPutLineResource (&rdb
, line
);
5036 && (!UNSPECIFIEDP (LFACE_FAMILY (lface
))
5037 || !UNSPECIFIEDP (LFACE_SWIDTH (lface
))
5038 || !UNSPECIFIEDP (LFACE_AVGWIDTH (lface
))
5039 || !UNSPECIFIEDP (LFACE_WEIGHT (lface
))
5040 || !UNSPECIFIEDP (LFACE_SLANT (lface
))
5041 || !UNSPECIFIEDP (LFACE_HEIGHT (lface
))))
5044 const char *suffix
= "List";
5047 #if defined HAVE_X_I18N
5049 const char *suffix
= "Set";
5051 const char *suffix
= "";
5055 #if defined HAVE_X_I18N
5056 extern char *xic_create_fontsetname
5057 P_ ((char *base_fontname
, Bool motif
));
5058 char *fontsetname
= xic_create_fontsetname (face
->font_name
, motif
);
5060 char *fontsetname
= face
->font_name
;
5062 sprintf (line
, "%s.pane.menubar*font%s: %s",
5063 myname
, suffix
, fontsetname
);
5064 XrmPutLineResource (&rdb
, line
);
5065 sprintf (line
, "%s.%s*font%s: %s",
5066 myname
, popup_path
, suffix
, fontsetname
);
5067 XrmPutLineResource (&rdb
, line
);
5069 if (fontsetname
!= face
->font_name
)
5070 xfree (fontsetname
);
5073 if (changed_p
&& f
->output_data
.x
->menubar_widget
)
5074 free_frame_menubar (f
);
5078 #endif /* HAVE_X_WINDOWS && USE_X_TOOLKIT */
5081 DEFUN ("face-attribute-relative-p", Fface_attribute_relative_p
,
5082 Sface_attribute_relative_p
,
5084 doc
: /* Check whether a face attribute value is relative.
5085 Specifically, this function returns t if the attribute ATTRIBUTE
5086 with the value VALUE is relative.
5088 A relative value is one that doesn't entirely override whatever is
5089 inherited from another face. For most possible attributes,
5090 the only relative value that users see is `unspecified'.
5091 However, for :height, floating point values are also relative. */)
5093 Lisp_Object attribute
, value
;
5095 if (EQ (value
, Qunspecified
) || (EQ (value
, Qignore_defface
)))
5097 else if (EQ (attribute
, QCheight
))
5098 return INTEGERP (value
) ? Qnil
: Qt
;
5103 DEFUN ("merge-face-attribute", Fmerge_face_attribute
, Smerge_face_attribute
,
5105 doc
: /* Return face ATTRIBUTE VALUE1 merged with VALUE2.
5106 If VALUE1 or VALUE2 are absolute (see `face-attribute-relative-p'), then
5107 the result will be absolute, otherwise it will be relative. */)
5108 (attribute
, value1
, value2
)
5109 Lisp_Object attribute
, value1
, value2
;
5111 if (EQ (value1
, Qunspecified
) || EQ (value1
, Qignore_defface
))
5113 else if (EQ (attribute
, QCheight
))
5114 return merge_face_heights (value1
, value2
, value1
);
5120 DEFUN ("internal-get-lisp-face-attribute", Finternal_get_lisp_face_attribute
,
5121 Sinternal_get_lisp_face_attribute
,
5123 doc
: /* Return face attribute KEYWORD of face SYMBOL.
5124 If SYMBOL does not name a valid Lisp face or KEYWORD isn't a valid
5125 face attribute name, signal an error.
5126 If the optional argument FRAME is given, report on face SYMBOL in that
5127 frame. If FRAME is t, report on the defaults for face SYMBOL (for new
5128 frames). If FRAME is omitted or nil, use the selected frame. */)
5129 (symbol
, keyword
, frame
)
5130 Lisp_Object symbol
, keyword
, frame
;
5132 Lisp_Object lface
, value
= Qnil
;
5134 CHECK_SYMBOL (symbol
);
5135 CHECK_SYMBOL (keyword
);
5138 lface
= lface_from_face_name (NULL
, symbol
, 1);
5142 frame
= selected_frame
;
5143 CHECK_LIVE_FRAME (frame
);
5144 lface
= lface_from_face_name (XFRAME (frame
), symbol
, 1);
5147 if (EQ (keyword
, QCfamily
))
5148 value
= LFACE_FAMILY (lface
);
5149 else if (EQ (keyword
, QCheight
))
5150 value
= LFACE_HEIGHT (lface
);
5151 else if (EQ (keyword
, QCweight
))
5152 value
= LFACE_WEIGHT (lface
);
5153 else if (EQ (keyword
, QCslant
))
5154 value
= LFACE_SLANT (lface
);
5155 else if (EQ (keyword
, QCunderline
))
5156 value
= LFACE_UNDERLINE (lface
);
5157 else if (EQ (keyword
, QCoverline
))
5158 value
= LFACE_OVERLINE (lface
);
5159 else if (EQ (keyword
, QCstrike_through
))
5160 value
= LFACE_STRIKE_THROUGH (lface
);
5161 else if (EQ (keyword
, QCbox
))
5162 value
= LFACE_BOX (lface
);
5163 else if (EQ (keyword
, QCinverse_video
)
5164 || EQ (keyword
, QCreverse_video
))
5165 value
= LFACE_INVERSE (lface
);
5166 else if (EQ (keyword
, QCforeground
))
5167 value
= LFACE_FOREGROUND (lface
);
5168 else if (EQ (keyword
, QCbackground
))
5169 value
= LFACE_BACKGROUND (lface
);
5170 else if (EQ (keyword
, QCstipple
))
5171 value
= LFACE_STIPPLE (lface
);
5172 else if (EQ (keyword
, QCwidth
))
5173 value
= LFACE_SWIDTH (lface
);
5174 else if (EQ (keyword
, QCinherit
))
5175 value
= LFACE_INHERIT (lface
);
5176 else if (EQ (keyword
, QCfont
))
5177 value
= LFACE_FONT (lface
);
5178 else if (EQ (keyword
, QCfontset
))
5179 value
= LFACE_FONTSET (lface
);
5181 signal_error ("Invalid face attribute name", keyword
);
5183 if (IGNORE_DEFFACE_P (value
))
5184 return Qunspecified
;
5190 DEFUN ("internal-lisp-face-attribute-values",
5191 Finternal_lisp_face_attribute_values
,
5192 Sinternal_lisp_face_attribute_values
, 1, 1, 0,
5193 doc
: /* Return a list of valid discrete values for face attribute ATTR.
5194 Value is nil if ATTR doesn't have a discrete set of valid values. */)
5198 Lisp_Object result
= Qnil
;
5200 CHECK_SYMBOL (attr
);
5202 if (EQ (attr
, QCweight
)
5203 || EQ (attr
, QCslant
)
5204 || EQ (attr
, QCwidth
))
5206 /* Extract permissible symbols from tables. */
5207 struct table_entry
*table
;
5210 if (EQ (attr
, QCweight
))
5211 table
= weight_table
, dim
= DIM (weight_table
);
5212 else if (EQ (attr
, QCslant
))
5213 table
= slant_table
, dim
= DIM (slant_table
);
5215 table
= swidth_table
, dim
= DIM (swidth_table
);
5217 for (i
= 0; i
< dim
; ++i
)
5219 Lisp_Object symbol
= *table
[i
].symbol
;
5220 Lisp_Object tail
= result
;
5223 && !EQ (XCAR (tail
), symbol
))
5227 result
= Fcons (symbol
, result
);
5230 else if (EQ (attr
, QCunderline
))
5231 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
5232 else if (EQ (attr
, QCoverline
))
5233 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
5234 else if (EQ (attr
, QCstrike_through
))
5235 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
5236 else if (EQ (attr
, QCinverse_video
) || EQ (attr
, QCreverse_video
))
5237 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
5243 DEFUN ("internal-merge-in-global-face", Finternal_merge_in_global_face
,
5244 Sinternal_merge_in_global_face
, 2, 2, 0,
5245 doc
: /* Add attributes from frame-default definition of FACE to FACE on FRAME.
5246 Default face attributes override any local face attributes. */)
5248 Lisp_Object face
, frame
;
5251 Lisp_Object global_lface
, local_lface
, *gvec
, *lvec
;
5253 CHECK_LIVE_FRAME (frame
);
5254 global_lface
= lface_from_face_name (NULL
, face
, 1);
5255 local_lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
5256 if (NILP (local_lface
))
5257 local_lface
= Finternal_make_lisp_face (face
, frame
);
5259 /* Make every specified global attribute override the local one.
5260 BEWARE!! This is only used from `face-set-after-frame-default' where
5261 the local frame is defined from default specs in `face-defface-spec'
5262 and those should be overridden by global settings. Hence the strange
5263 "global before local" priority. */
5264 lvec
= XVECTOR (local_lface
)->contents
;
5265 gvec
= XVECTOR (global_lface
)->contents
;
5266 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
5267 if (! UNSPECIFIEDP (gvec
[i
]))
5269 if (IGNORE_DEFFACE_P (gvec
[i
]))
5270 lvec
[i
] = Qunspecified
;
5279 /* The following function is implemented for compatibility with 20.2.
5280 The function is used in x-resolve-fonts when it is asked to
5281 return fonts with the same size as the font of a face. This is
5282 done in fontset.el. */
5284 DEFUN ("face-font", Fface_font
, Sface_font
, 1, 3, 0,
5285 doc
: /* Return the font name of face FACE, or nil if it is unspecified.
5286 The font name is, by default, for ASCII characters.
5287 If the optional argument FRAME is given, report on face FACE in that frame.
5288 If FRAME is t, report on the defaults for face FACE (for new frames).
5289 The font default for a face is either nil, or a list
5290 of the form (bold), (italic) or (bold italic).
5291 If FRAME is omitted or nil, use the selected frame. And, in this case,
5292 if the optional third argument CHARACTER is given,
5293 return the font name used for CHARACTER. */)
5294 (face
, frame
, character
)
5295 Lisp_Object face
, frame
, character
;
5299 Lisp_Object result
= Qnil
;
5300 Lisp_Object lface
= lface_from_face_name (NULL
, face
, 1);
5302 if (!UNSPECIFIEDP (LFACE_WEIGHT (lface
))
5303 && !EQ (LFACE_WEIGHT (lface
), Qnormal
))
5304 result
= Fcons (Qbold
, result
);
5306 if (!UNSPECIFIEDP (LFACE_SLANT (lface
))
5307 && !EQ (LFACE_SLANT (lface
), Qnormal
))
5308 result
= Fcons (Qitalic
, result
);
5314 struct frame
*f
= frame_or_selected_frame (frame
, 1);
5315 int face_id
= lookup_named_face (f
, face
, 1);
5316 struct face
*face
= FACE_FROM_ID (f
, face_id
);
5320 #ifdef HAVE_WINDOW_SYSTEM
5321 if (FRAME_WINDOW_P (f
) && !NILP (character
))
5323 CHECK_CHARACTER (character
);
5324 face_id
= FACE_FOR_CHAR (f
, face
, XINT (character
), -1, Qnil
);
5325 face
= FACE_FROM_ID (f
, face_id
);
5326 return (face
->font
&& face
->font_name
5327 ? build_string (face
->font_name
)
5331 return build_string (face
->font_name
);
5336 /* Compare face-attribute values v1 and v2 for equality. Value is non-zero if
5337 all attributes are `equal'. Tries to be fast because this function
5338 is called quite often. */
5341 face_attr_equal_p (v1
, v2
)
5344 /* Type can differ, e.g. when one attribute is unspecified, i.e. nil,
5345 and the other is specified. */
5346 if (XTYPE (v1
) != XTYPE (v2
))
5355 if (SBYTES (v1
) != SBYTES (v2
))
5358 return bcmp (SDATA (v1
), SDATA (v2
), SBYTES (v1
)) == 0;
5365 return !NILP (Fequal (v1
, v2
));
5370 /* Compare face vectors V1 and V2 for equality. Value is non-zero if
5371 all attributes are `equal'. Tries to be fast because this function
5372 is called quite often. */
5375 lface_equal_p (v1
, v2
)
5376 Lisp_Object
*v1
, *v2
;
5380 for (i
= 1; i
< LFACE_VECTOR_SIZE
&& equal_p
; ++i
)
5381 equal_p
= face_attr_equal_p (v1
[i
], v2
[i
]);
5387 DEFUN ("internal-lisp-face-equal-p", Finternal_lisp_face_equal_p
,
5388 Sinternal_lisp_face_equal_p
, 2, 3, 0,
5389 doc
: /* True if FACE1 and FACE2 are equal.
5390 If the optional argument FRAME is given, report on FACE1 and FACE2 in that frame.
5391 If FRAME is t, report on the defaults for FACE1 and FACE2 (for new frames).
5392 If FRAME is omitted or nil, use the selected frame. */)
5393 (face1
, face2
, frame
)
5394 Lisp_Object face1
, face2
, frame
;
5398 Lisp_Object lface1
, lface2
;
5403 /* Don't use check_x_frame here because this function is called
5404 before X frames exist. At that time, if FRAME is nil,
5405 selected_frame will be used which is the frame dumped with
5406 Emacs. That frame is not an X frame. */
5407 f
= frame_or_selected_frame (frame
, 2);
5409 lface1
= lface_from_face_name (f
, face1
, 1);
5410 lface2
= lface_from_face_name (f
, face2
, 1);
5411 equal_p
= lface_equal_p (XVECTOR (lface1
)->contents
,
5412 XVECTOR (lface2
)->contents
);
5413 return equal_p
? Qt
: Qnil
;
5417 DEFUN ("internal-lisp-face-empty-p", Finternal_lisp_face_empty_p
,
5418 Sinternal_lisp_face_empty_p
, 1, 2, 0,
5419 doc
: /* True if FACE has no attribute specified.
5420 If the optional argument FRAME is given, report on face FACE in that frame.
5421 If FRAME is t, report on the defaults for face FACE (for new frames).
5422 If FRAME is omitted or nil, use the selected frame. */)
5424 Lisp_Object face
, frame
;
5431 frame
= selected_frame
;
5432 CHECK_LIVE_FRAME (frame
);
5436 lface
= lface_from_face_name (NULL
, face
, 1);
5438 lface
= lface_from_face_name (f
, face
, 1);
5440 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
5441 if (!UNSPECIFIEDP (AREF (lface
, i
)))
5444 return i
== LFACE_VECTOR_SIZE
? Qt
: Qnil
;
5448 DEFUN ("frame-face-alist", Fframe_face_alist
, Sframe_face_alist
,
5450 doc
: /* Return an alist of frame-local faces defined on FRAME.
5451 For internal use only. */)
5455 struct frame
*f
= frame_or_selected_frame (frame
, 0);
5456 return f
->face_alist
;
5460 /* Return a hash code for Lisp string STRING with case ignored. Used
5461 below in computing a hash value for a Lisp face. */
5463 static INLINE
unsigned
5464 hash_string_case_insensitive (string
)
5467 const unsigned char *s
;
5469 xassert (STRINGP (string
));
5470 for (s
= SDATA (string
); *s
; ++s
)
5471 hash
= (hash
<< 1) ^ tolower (*s
);
5476 /* Return a hash code for face attribute vector V. */
5478 static INLINE
unsigned
5482 return (hash_string_case_insensitive (v
[LFACE_FAMILY_INDEX
])
5483 ^ hash_string_case_insensitive (v
[LFACE_FOREGROUND_INDEX
])
5484 ^ hash_string_case_insensitive (v
[LFACE_BACKGROUND_INDEX
])
5485 ^ XFASTINT (v
[LFACE_WEIGHT_INDEX
])
5486 ^ XFASTINT (v
[LFACE_SLANT_INDEX
])
5487 ^ XFASTINT (v
[LFACE_SWIDTH_INDEX
])
5488 ^ XFASTINT (v
[LFACE_HEIGHT_INDEX
]));
5492 /* Return non-zero if LFACE1 and LFACE2 specify the same font (without
5493 considering charsets/registries). They do if they specify the same
5494 family, point size, weight, width, slant, font, and fontset. Both
5495 LFACE1 and LFACE2 must be fully-specified. */
5498 lface_same_font_attributes_p (lface1
, lface2
)
5499 Lisp_Object
*lface1
, *lface2
;
5501 xassert (lface_fully_specified_p (lface1
)
5502 && lface_fully_specified_p (lface2
));
5503 return (xstricmp (SDATA (lface1
[LFACE_FAMILY_INDEX
]),
5504 SDATA (lface2
[LFACE_FAMILY_INDEX
])) == 0
5505 && EQ (lface1
[LFACE_HEIGHT_INDEX
], lface2
[LFACE_HEIGHT_INDEX
])
5506 && EQ (lface1
[LFACE_SWIDTH_INDEX
], lface2
[LFACE_SWIDTH_INDEX
])
5507 && EQ (lface1
[LFACE_AVGWIDTH_INDEX
], lface2
[LFACE_AVGWIDTH_INDEX
])
5508 && EQ (lface1
[LFACE_WEIGHT_INDEX
], lface2
[LFACE_WEIGHT_INDEX
])
5509 && EQ (lface1
[LFACE_SLANT_INDEX
], lface2
[LFACE_SLANT_INDEX
])
5510 && (EQ (lface1
[LFACE_FONT_INDEX
], lface2
[LFACE_FONT_INDEX
])
5511 || (STRINGP (lface1
[LFACE_FONT_INDEX
])
5512 && STRINGP (lface2
[LFACE_FONT_INDEX
])
5513 && ! xstricmp (SDATA (lface1
[LFACE_FONT_INDEX
]),
5514 SDATA (lface2
[LFACE_FONT_INDEX
]))))
5515 && (EQ (lface1
[LFACE_FONTSET_INDEX
], lface2
[LFACE_FONTSET_INDEX
])
5516 || (STRINGP (lface1
[LFACE_FONTSET_INDEX
])
5517 && STRINGP (lface2
[LFACE_FONTSET_INDEX
])
5518 && ! xstricmp (SDATA (lface1
[LFACE_FONTSET_INDEX
]),
5519 SDATA (lface2
[LFACE_FONTSET_INDEX
]))))
5525 /***********************************************************************
5527 ***********************************************************************/
5529 /* Allocate and return a new realized face for Lisp face attribute
5532 static struct face
*
5533 make_realized_face (attr
)
5536 struct face
*face
= (struct face
*) xmalloc (sizeof *face
);
5537 bzero (face
, sizeof *face
);
5538 face
->ascii_face
= face
;
5539 bcopy (attr
, face
->lface
, sizeof face
->lface
);
5544 /* Free realized face FACE, including its X resources. FACE may
5548 free_realized_face (f
, face
)
5554 #ifdef HAVE_WINDOW_SYSTEM
5555 if (FRAME_WINDOW_P (f
))
5557 /* Free fontset of FACE if it is ASCII face. */
5558 if (face
->fontset
>= 0 && face
== face
->ascii_face
)
5559 free_face_fontset (f
, face
);
5563 #ifdef USE_FONT_BACKEND
5564 if (enable_font_backend
&& face
->font_info
)
5565 font_done_for_face (f
, face
);
5566 #endif /* USE_FONT_BACKEND */
5567 x_free_gc (f
, face
->gc
);
5572 free_face_colors (f
, face
);
5573 x_destroy_bitmap (f
, face
->stipple
);
5575 #endif /* HAVE_WINDOW_SYSTEM */
5582 /* Prepare face FACE for subsequent display on frame F. This
5583 allocated GCs if they haven't been allocated yet or have been freed
5584 by clearing the face cache. */
5587 prepare_face_for_display (f
, face
)
5591 #ifdef HAVE_WINDOW_SYSTEM
5592 xassert (FRAME_WINDOW_P (f
));
5597 unsigned long mask
= GCForeground
| GCBackground
| GCGraphicsExposures
;
5599 xgcv
.foreground
= face
->foreground
;
5600 xgcv
.background
= face
->background
;
5601 #ifdef HAVE_X_WINDOWS
5602 xgcv
.graphics_exposures
= False
;
5604 /* The font of FACE may be null if we couldn't load it. */
5607 #ifdef HAVE_X_WINDOWS
5608 #ifdef USE_FONT_BACKEND
5609 if (enable_font_backend
)
5610 xgcv
.font
= FRAME_X_DISPLAY_INFO (f
)->font
->fid
;
5613 xgcv
.font
= face
->font
->fid
;
5616 xgcv
.font
= face
->font
;
5619 xgcv
.font
= face
->font
;
5625 #ifdef HAVE_X_WINDOWS
5628 xgcv
.fill_style
= FillOpaqueStippled
;
5629 xgcv
.stipple
= x_bitmap_pixmap (f
, face
->stipple
);
5630 mask
|= GCFillStyle
| GCStipple
;
5633 face
->gc
= x_create_gc (f
, mask
, &xgcv
);
5634 #ifdef USE_FONT_BACKEND
5635 if (enable_font_backend
&& face
->font
)
5636 font_prepare_for_face (f
, face
);
5637 #endif /* USE_FONT_BACKEND */
5640 #endif /* HAVE_WINDOW_SYSTEM */
5644 /* Returns the `distance' between the colors X and Y. */
5647 color_distance (x
, y
)
5650 /* This formula is from a paper title `Colour metric' by Thiadmer Riemersma.
5651 Quoting from that paper:
5653 This formula has results that are very close to L*u*v* (with the
5654 modified lightness curve) and, more importantly, it is a more even
5655 algorithm: it does not have a range of colours where it suddenly
5656 gives far from optimal results.
5658 See <http://www.compuphase.com/cmetric.htm> for more info. */
5660 long r
= (x
->red
- y
->red
) >> 8;
5661 long g
= (x
->green
- y
->green
) >> 8;
5662 long b
= (x
->blue
- y
->blue
) >> 8;
5663 long r_mean
= (x
->red
+ y
->red
) >> 9;
5666 (((512 + r_mean
) * r
* r
) >> 8)
5668 + (((767 - r_mean
) * b
* b
) >> 8);
5672 DEFUN ("color-distance", Fcolor_distance
, Scolor_distance
, 2, 3, 0,
5673 doc
: /* Return an integer distance between COLOR1 and COLOR2 on FRAME.
5674 COLOR1 and COLOR2 may be either strings containing the color name,
5675 or lists of the form (RED GREEN BLUE).
5676 If FRAME is unspecified or nil, the current frame is used. */)
5677 (color1
, color2
, frame
)
5678 Lisp_Object color1
, color2
, frame
;
5681 XColor cdef1
, cdef2
;
5684 frame
= selected_frame
;
5685 CHECK_LIVE_FRAME (frame
);
5688 if (!(CONSP (color1
) && parse_rgb_list (color1
, &cdef1
))
5689 && !(STRINGP (color1
) && defined_color (f
, SDATA (color1
), &cdef1
, 0)))
5690 signal_error ("Invalid color", color1
);
5691 if (!(CONSP (color2
) && parse_rgb_list (color2
, &cdef2
))
5692 && !(STRINGP (color2
) && defined_color (f
, SDATA (color2
), &cdef2
, 0)))
5693 signal_error ("Invalid color", color2
);
5695 return make_number (color_distance (&cdef1
, &cdef2
));
5699 /***********************************************************************
5701 ***********************************************************************/
5703 /* Return a new face cache for frame F. */
5705 static struct face_cache
*
5709 struct face_cache
*c
;
5712 c
= (struct face_cache
*) xmalloc (sizeof *c
);
5713 bzero (c
, sizeof *c
);
5714 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5715 c
->buckets
= (struct face
**) xmalloc (size
);
5716 bzero (c
->buckets
, size
);
5718 c
->faces_by_id
= (struct face
**) xmalloc (c
->size
* sizeof *c
->faces_by_id
);
5720 c
->menu_face_changed_p
= menu_face_changed_default
;
5725 /* Clear out all graphics contexts for all realized faces, except for
5726 the basic faces. This should be done from time to time just to avoid
5727 keeping too many graphics contexts that are no longer needed. */
5731 struct face_cache
*c
;
5733 if (c
&& FRAME_WINDOW_P (c
->f
))
5735 #ifdef HAVE_WINDOW_SYSTEM
5737 for (i
= BASIC_FACE_ID_SENTINEL
; i
< c
->used
; ++i
)
5739 struct face
*face
= c
->faces_by_id
[i
];
5740 if (face
&& face
->gc
)
5743 #ifdef USE_FONT_BACKEND
5744 if (enable_font_backend
&& face
->font_info
)
5745 font_done_for_face (c
->f
, face
);
5746 #endif /* USE_FONT_BACKEND */
5747 x_free_gc (c
->f
, face
->gc
);
5752 #endif /* HAVE_WINDOW_SYSTEM */
5757 /* Free all realized faces in face cache C, including basic faces.
5758 C may be null. If faces are freed, make sure the frame's current
5759 matrix is marked invalid, so that a display caused by an expose
5760 event doesn't try to use faces we destroyed. */
5763 free_realized_faces (c
)
5764 struct face_cache
*c
;
5769 struct frame
*f
= c
->f
;
5771 /* We must block input here because we can't process X events
5772 safely while only some faces are freed, or when the frame's
5773 current matrix still references freed faces. */
5776 for (i
= 0; i
< c
->used
; ++i
)
5778 free_realized_face (f
, c
->faces_by_id
[i
]);
5779 c
->faces_by_id
[i
] = NULL
;
5783 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5784 bzero (c
->buckets
, size
);
5786 /* Must do a thorough redisplay the next time. Mark current
5787 matrices as invalid because they will reference faces freed
5788 above. This function is also called when a frame is
5789 destroyed. In this case, the root window of F is nil. */
5790 if (WINDOWP (f
->root_window
))
5792 clear_current_matrices (f
);
5793 ++windows_or_buffers_changed
;
5801 /* Free all realized faces that are using FONTSET on frame F. */
5804 free_realized_faces_for_fontset (f
, fontset
)
5808 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5812 /* We must block input here because we can't process X events safely
5813 while only some faces are freed, or when the frame's current
5814 matrix still references freed faces. */
5817 for (i
= 0; i
< cache
->used
; i
++)
5819 face
= cache
->faces_by_id
[i
];
5821 && face
->fontset
== fontset
)
5823 uncache_face (cache
, face
);
5824 free_realized_face (f
, face
);
5828 /* Must do a thorough redisplay the next time. Mark current
5829 matrices as invalid because they will reference faces freed
5830 above. This function is also called when a frame is destroyed.
5831 In this case, the root window of F is nil. */
5832 if (WINDOWP (f
->root_window
))
5834 clear_current_matrices (f
);
5835 ++windows_or_buffers_changed
;
5842 /* Free all realized faces on FRAME or on all frames if FRAME is nil.
5843 This is done after attributes of a named face have been changed,
5844 because we can't tell which realized faces depend on that face. */
5847 free_all_realized_faces (frame
)
5853 FOR_EACH_FRAME (rest
, frame
)
5854 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5857 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5861 /* Free face cache C and faces in it, including their X resources. */
5865 struct face_cache
*c
;
5869 free_realized_faces (c
);
5871 xfree (c
->faces_by_id
);
5877 /* Cache realized face FACE in face cache C. HASH is the hash value
5878 of FACE. If FACE is for ASCII characters (i.e. FACE->ascii_face ==
5879 FACE), insert the new face to the beginning of the collision list
5880 of the face hash table of C. Otherwise, add the new face to the
5881 end of the collision list. This way, lookup_face can quickly find
5882 that a requested face is not cached. */
5885 cache_face (c
, face
, hash
)
5886 struct face_cache
*c
;
5890 int i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5894 if (face
->ascii_face
!= face
)
5896 struct face
*last
= c
->buckets
[i
];
5907 c
->buckets
[i
] = face
;
5908 face
->prev
= face
->next
= NULL
;
5914 face
->next
= c
->buckets
[i
];
5916 face
->next
->prev
= face
;
5917 c
->buckets
[i
] = face
;
5920 /* Find a free slot in C->faces_by_id and use the index of the free
5921 slot as FACE->id. */
5922 for (i
= 0; i
< c
->used
; ++i
)
5923 if (c
->faces_by_id
[i
] == NULL
)
5927 /* Maybe enlarge C->faces_by_id. */
5930 if (c
->used
== c
->size
)
5933 new_size
= min (2 * c
->size
, MAX_FACE_ID
);
5934 if (new_size
== c
->size
)
5935 abort (); /* Alternatives? ++kfs */
5936 sz
= new_size
* sizeof *c
->faces_by_id
;
5937 c
->faces_by_id
= (struct face
**) xrealloc (c
->faces_by_id
, sz
);
5944 /* Check that FACE got a unique id. */
5949 for (j
= n
= 0; j
< FACE_CACHE_BUCKETS_SIZE
; ++j
)
5950 for (face
= c
->buckets
[j
]; face
; face
= face
->next
)
5956 #endif /* GLYPH_DEBUG */
5958 c
->faces_by_id
[i
] = face
;
5962 /* Remove face FACE from cache C. */
5965 uncache_face (c
, face
)
5966 struct face_cache
*c
;
5969 int i
= face
->hash
% FACE_CACHE_BUCKETS_SIZE
;
5972 face
->prev
->next
= face
->next
;
5974 c
->buckets
[i
] = face
->next
;
5977 face
->next
->prev
= face
->prev
;
5979 c
->faces_by_id
[face
->id
] = NULL
;
5980 if (face
->id
== c
->used
)
5985 /* Look up a realized face with face attributes ATTR in the face cache
5986 of frame F. The face will be used to display ASCII characters.
5987 Value is the ID of the face found. If no suitable face is found,
5988 realize a new one. */
5991 lookup_face (f
, attr
)
5995 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
6000 xassert (cache
!= NULL
);
6001 check_lface_attrs (attr
);
6003 /* Look up ATTR in the face cache. */
6004 hash
= lface_hash (attr
);
6005 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
6007 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
6009 if (face
->ascii_face
!= face
)
6011 /* There's no more ASCII face. */
6015 if (face
->hash
== hash
6016 && lface_equal_p (face
->lface
, attr
))
6020 /* If not found, realize a new face. */
6022 face
= realize_face (cache
, attr
, -1);
6025 xassert (face
== FACE_FROM_ID (f
, face
->id
));
6026 #endif /* GLYPH_DEBUG */
6031 #ifdef HAVE_WINDOW_SYSTEM
6032 /* Look up a realized face that has the same attributes as BASE_FACE
6033 except for the font in the face cache of frame F. If FONT_ID is
6034 not negative, it is an ID number of an already opened font that is
6035 used by the face. If FONT_ID is negative, the face has no font.
6036 Value is the ID of the face found. If no suitable face is found,
6037 realize a new one. */
6040 lookup_non_ascii_face (f
, font_id
, base_face
)
6043 struct face
*base_face
;
6045 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
6050 xassert (cache
!= NULL
);
6051 base_face
= base_face
->ascii_face
;
6052 hash
= lface_hash (base_face
->lface
);
6053 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
6055 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
6057 if (face
->ascii_face
== face
)
6059 if (face
->ascii_face
== base_face
6060 && face
->font_info_id
== font_id
)
6064 /* If not found, realize a new face. */
6066 face
= realize_non_ascii_face (f
, font_id
, base_face
);
6069 xassert (face
== FACE_FROM_ID (f
, face
->id
));
6070 #endif /* GLYPH_DEBUG */
6075 #ifdef USE_FONT_BACKEND
6077 face_for_font (f
, font
, base_face
)
6080 struct face
*base_face
;
6082 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
6087 xassert (cache
!= NULL
);
6088 base_face
= base_face
->ascii_face
;
6089 hash
= lface_hash (base_face
->lface
);
6090 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
6092 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
6094 if (face
->ascii_face
== face
)
6096 if (face
->ascii_face
== base_face
6097 && face
->font
== font
->font
.font
6098 && face
->font_info
== (struct font_info
*) font
)
6102 /* If not found, realize a new face. */
6103 face
= realize_non_ascii_face (f
, -1, base_face
);
6104 face
->font
= font
->font
.font
;
6105 face
->font_info
= (struct font_info
*) font
;
6106 face
->font_info_id
= 0;
6107 face
->font_name
= font
->font
.full_name
;
6110 #endif /* USE_FONT_BACKEND */
6112 #endif /* HAVE_WINDOW_SYSTEM */
6114 /* Return the face id of the realized face for named face SYMBOL on
6115 frame F suitable for displaying ASCII characters. Value is -1 if
6116 the face couldn't be determined, which might happen if the default
6117 face isn't realized and cannot be realized. */
6120 lookup_named_face (f
, symbol
, signal_p
)
6125 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6126 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
6127 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6129 if (default_face
== NULL
)
6131 if (!realize_basic_faces (f
))
6133 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6134 if (default_face
== NULL
)
6135 abort (); /* realize_basic_faces must have set it up */
6138 if (!get_lface_attributes (f
, symbol
, symbol_attrs
, signal_p
))
6141 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
6142 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
6144 return lookup_face (f
, attrs
);
6148 /* Return the ID of the realized ASCII face of Lisp face with ID
6149 LFACE_ID on frame F. Value is -1 if LFACE_ID isn't valid. */
6152 ascii_face_of_lisp_face (f
, lface_id
)
6158 if (lface_id
>= 0 && lface_id
< lface_id_to_name_size
)
6160 Lisp_Object face_name
= lface_id_to_name
[lface_id
];
6161 face_id
= lookup_named_face (f
, face_name
, 1);
6170 /* Return a face for charset ASCII that is like the face with id
6171 FACE_ID on frame F, but has a font that is STEPS steps smaller.
6172 STEPS < 0 means larger. Value is the id of the face. */
6175 smaller_face (f
, face_id
, steps
)
6179 #ifdef HAVE_WINDOW_SYSTEM
6181 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6182 int pt
, last_pt
, last_height
;
6185 struct face
*new_face
;
6187 /* If not called for an X frame, just return the original face. */
6188 if (FRAME_TERMCAP_P (f
))
6191 /* Try in increments of 1/2 pt. */
6192 delta
= steps
< 0 ? 5 : -5;
6193 steps
= eabs (steps
);
6195 face
= FACE_FROM_ID (f
, face_id
);
6196 bcopy (face
->lface
, attrs
, sizeof attrs
);
6197 pt
= last_pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
6198 new_face_id
= face_id
;
6199 last_height
= FONT_HEIGHT (face
->font
);
6203 /* Give up if we cannot find a font within 10pt. */
6204 && eabs (last_pt
- pt
) < 100)
6206 /* Look up a face for a slightly smaller/larger font. */
6208 attrs
[LFACE_HEIGHT_INDEX
] = make_number (pt
);
6209 new_face_id
= lookup_face (f
, attrs
);
6210 new_face
= FACE_FROM_ID (f
, new_face_id
);
6212 /* If height changes, count that as one step. */
6213 if ((delta
< 0 && FONT_HEIGHT (new_face
->font
) < last_height
)
6214 || (delta
> 0 && FONT_HEIGHT (new_face
->font
) > last_height
))
6217 last_height
= FONT_HEIGHT (new_face
->font
);
6224 #else /* not HAVE_WINDOW_SYSTEM */
6228 #endif /* not HAVE_WINDOW_SYSTEM */
6232 /* Return a face for charset ASCII that is like the face with id
6233 FACE_ID on frame F, but has height HEIGHT. */
6236 face_with_height (f
, face_id
, height
)
6241 #ifdef HAVE_WINDOW_SYSTEM
6243 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6245 if (FRAME_TERMCAP_P (f
)
6249 face
= FACE_FROM_ID (f
, face_id
);
6250 bcopy (face
->lface
, attrs
, sizeof attrs
);
6251 attrs
[LFACE_HEIGHT_INDEX
] = make_number (height
);
6252 face_id
= lookup_face (f
, attrs
);
6253 #endif /* HAVE_WINDOW_SYSTEM */
6259 /* Return the face id of the realized face for named face SYMBOL on
6260 frame F suitable for displaying ASCII characters, and use
6261 attributes of the face FACE_ID for attributes that aren't
6262 completely specified by SYMBOL. This is like lookup_named_face,
6263 except that the default attributes come from FACE_ID, not from the
6264 default face. FACE_ID is assumed to be already realized. */
6267 lookup_derived_face (f
, symbol
, face_id
, signal_p
)
6273 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6274 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
6275 struct face
*default_face
= FACE_FROM_ID (f
, face_id
);
6280 get_lface_attributes (f
, symbol
, symbol_attrs
, signal_p
);
6281 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
6282 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
6283 return lookup_face (f
, attrs
);
6286 DEFUN ("face-attributes-as-vector", Fface_attributes_as_vector
,
6287 Sface_attributes_as_vector
, 1, 1, 0,
6288 doc
: /* Return a vector of face attributes corresponding to PLIST. */)
6293 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
6295 merge_face_ref (XFRAME (selected_frame
), plist
, XVECTOR (lface
)->contents
,
6302 /***********************************************************************
6303 Face capability testing
6304 ***********************************************************************/
6307 /* If the distance (as returned by color_distance) between two colors is
6308 less than this, then they are considered the same, for determining
6309 whether a color is supported or not. The range of values is 0-65535. */
6311 #define TTY_SAME_COLOR_THRESHOLD 10000
6313 #ifdef HAVE_WINDOW_SYSTEM
6315 /* Return non-zero if all the face attributes in ATTRS are supported
6316 on the window-system frame F.
6318 The definition of `supported' is somewhat heuristic, but basically means
6319 that a face containing all the attributes in ATTRS, when merged with the
6320 default face for display, can be represented in a way that's
6322 \(1) different in appearance than the default face, and
6323 \(2) `close in spirit' to what the attributes specify, if not exact. */
6326 x_supports_face_attributes_p (f
, attrs
, def_face
)
6329 struct face
*def_face
;
6331 Lisp_Object
*def_attrs
= def_face
->lface
;
6333 /* Check that other specified attributes are different that the default
6335 if ((!UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
6336 && face_attr_equal_p (attrs
[LFACE_UNDERLINE_INDEX
],
6337 def_attrs
[LFACE_UNDERLINE_INDEX
]))
6338 || (!UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
6339 && face_attr_equal_p (attrs
[LFACE_INVERSE_INDEX
],
6340 def_attrs
[LFACE_INVERSE_INDEX
]))
6341 || (!UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
6342 && face_attr_equal_p (attrs
[LFACE_FOREGROUND_INDEX
],
6343 def_attrs
[LFACE_FOREGROUND_INDEX
]))
6344 || (!UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
6345 && face_attr_equal_p (attrs
[LFACE_BACKGROUND_INDEX
],
6346 def_attrs
[LFACE_BACKGROUND_INDEX
]))
6347 || (!UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
6348 && face_attr_equal_p (attrs
[LFACE_STIPPLE_INDEX
],
6349 def_attrs
[LFACE_STIPPLE_INDEX
]))
6350 || (!UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
6351 && face_attr_equal_p (attrs
[LFACE_OVERLINE_INDEX
],
6352 def_attrs
[LFACE_OVERLINE_INDEX
]))
6353 || (!UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
6354 && face_attr_equal_p (attrs
[LFACE_STRIKE_THROUGH_INDEX
],
6355 def_attrs
[LFACE_STRIKE_THROUGH_INDEX
]))
6356 || (!UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
6357 && face_attr_equal_p (attrs
[LFACE_BOX_INDEX
],
6358 def_attrs
[LFACE_BOX_INDEX
])))
6361 /* Check font-related attributes, as those are the most commonly
6362 "unsupported" on a window-system (because of missing fonts). */
6363 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
6364 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
6365 || !UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
6366 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
6367 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
6368 || !UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
]))
6372 Lisp_Object merged_attrs
[LFACE_VECTOR_SIZE
];
6374 bcopy (def_attrs
, merged_attrs
, sizeof merged_attrs
);
6376 merge_face_vectors (f
, attrs
, merged_attrs
, 0);
6378 face_id
= lookup_face (f
, merged_attrs
);
6379 face
= FACE_FROM_ID (f
, face_id
);
6382 error ("Cannot make face");
6384 /* If the font is the same, then not supported. */
6385 if (face
->font
== def_face
->font
)
6389 /* Everything checks out, this face is supported. */
6393 #endif /* HAVE_WINDOW_SYSTEM */
6395 /* Return non-zero if all the face attributes in ATTRS are supported
6398 The definition of `supported' is somewhat heuristic, but basically means
6399 that a face containing all the attributes in ATTRS, when merged
6400 with the default face for display, can be represented in a way that's
6402 \(1) different in appearance than the default face, and
6403 \(2) `close in spirit' to what the attributes specify, if not exact.
6405 Point (2) implies that a `:weight black' attribute will be satisfied
6406 by any terminal that can display bold, and a `:foreground "yellow"' as
6407 long as the terminal can display a yellowish color, but `:slant italic'
6408 will _not_ be satisfied by the tty display code's automatic
6409 substitution of a `dim' face for italic. */
6412 tty_supports_face_attributes_p (f
, attrs
, def_face
)
6415 struct face
*def_face
;
6418 Lisp_Object val
, fg
, bg
;
6419 XColor fg_tty_color
, fg_std_color
;
6420 XColor bg_tty_color
, bg_std_color
;
6421 unsigned test_caps
= 0;
6422 Lisp_Object
*def_attrs
= def_face
->lface
;
6425 /* First check some easy-to-check stuff; ttys support none of the
6426 following attributes, so we can just return false if any are requested
6427 (even if `nominal' values are specified, we should still return false,
6428 as that will be the same value that the default face uses). We
6429 consider :slant unsupportable on ttys, even though the face code
6430 actually `fakes' them using a dim attribute if possible. This is
6431 because the faked result is too different from what the face
6433 if (!UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
6434 || !UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
6435 || !UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
6436 || !UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
6437 || !UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
6438 || !UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
6439 || !UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
6440 || !UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
]))
6444 /* Test for terminal `capabilities' (non-color character attributes). */
6446 /* font weight (bold/dim) */
6447 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
6450 int def_weight
= face_numeric_weight (def_attrs
[LFACE_WEIGHT_INDEX
]);
6452 if (weight
> XLFD_WEIGHT_MEDIUM
)
6454 if (def_weight
> XLFD_WEIGHT_MEDIUM
)
6455 return 0; /* same as default */
6456 test_caps
= TTY_CAP_BOLD
;
6458 else if (weight
< XLFD_WEIGHT_MEDIUM
)
6460 if (def_weight
< XLFD_WEIGHT_MEDIUM
)
6461 return 0; /* same as default */
6462 test_caps
= TTY_CAP_DIM
;
6464 else if (def_weight
== XLFD_WEIGHT_MEDIUM
)
6465 return 0; /* same as default */
6469 val
= attrs
[LFACE_UNDERLINE_INDEX
];
6470 if (!UNSPECIFIEDP (val
))
6473 return 0; /* ttys can't use colored underlines */
6474 else if (face_attr_equal_p (val
, def_attrs
[LFACE_UNDERLINE_INDEX
]))
6475 return 0; /* same as default */
6477 test_caps
|= TTY_CAP_UNDERLINE
;
6481 val
= attrs
[LFACE_INVERSE_INDEX
];
6482 if (!UNSPECIFIEDP (val
))
6484 if (face_attr_equal_p (val
, def_attrs
[LFACE_INVERSE_INDEX
]))
6485 return 0; /* same as default */
6487 test_caps
|= TTY_CAP_INVERSE
;
6491 /* Color testing. */
6493 /* Default the color indices in FG_TTY_COLOR and BG_TTY_COLOR, since
6494 we use them when calling `tty_capable_p' below, even if the face
6495 specifies no colors. */
6496 fg_tty_color
.pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
6497 bg_tty_color
.pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
6499 /* Check if foreground color is close enough. */
6500 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
6503 Lisp_Object def_fg
= def_attrs
[LFACE_FOREGROUND_INDEX
];
6505 if (face_attr_equal_p (fg
, def_fg
))
6506 return 0; /* same as default */
6507 else if (! tty_lookup_color (f
, fg
, &fg_tty_color
, &fg_std_color
))
6508 return 0; /* not a valid color */
6509 else if (color_distance (&fg_tty_color
, &fg_std_color
)
6510 > TTY_SAME_COLOR_THRESHOLD
)
6511 return 0; /* displayed color is too different */
6513 /* Make sure the color is really different than the default. */
6515 XColor def_fg_color
;
6516 if (tty_lookup_color (f
, def_fg
, &def_fg_color
, 0)
6517 && (color_distance (&fg_tty_color
, &def_fg_color
)
6518 <= TTY_SAME_COLOR_THRESHOLD
))
6523 /* Check if background color is close enough. */
6524 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
6527 Lisp_Object def_bg
= def_attrs
[LFACE_BACKGROUND_INDEX
];
6529 if (face_attr_equal_p (bg
, def_bg
))
6530 return 0; /* same as default */
6531 else if (! tty_lookup_color (f
, bg
, &bg_tty_color
, &bg_std_color
))
6532 return 0; /* not a valid color */
6533 else if (color_distance (&bg_tty_color
, &bg_std_color
)
6534 > TTY_SAME_COLOR_THRESHOLD
)
6535 return 0; /* displayed color is too different */
6537 /* Make sure the color is really different than the default. */
6539 XColor def_bg_color
;
6540 if (tty_lookup_color (f
, def_bg
, &def_bg_color
, 0)
6541 && (color_distance (&bg_tty_color
, &def_bg_color
)
6542 <= TTY_SAME_COLOR_THRESHOLD
))
6547 /* If both foreground and background are requested, see if the
6548 distance between them is OK. We just check to see if the distance
6549 between the tty's foreground and background is close enough to the
6550 distance between the standard foreground and background. */
6551 if (STRINGP (fg
) && STRINGP (bg
))
6554 = (color_distance (&fg_std_color
, &bg_std_color
)
6555 - color_distance (&fg_tty_color
, &bg_tty_color
));
6556 if (delta_delta
> TTY_SAME_COLOR_THRESHOLD
6557 || delta_delta
< -TTY_SAME_COLOR_THRESHOLD
)
6562 /* See if the capabilities we selected above are supported, with the
6564 if (test_caps
!= 0 &&
6565 ! tty_capable_p (FRAME_TTY (f
), test_caps
, fg_tty_color
.pixel
, bg_tty_color
.pixel
))
6569 /* Hmmm, everything checks out, this terminal must support this face. */
6574 DEFUN ("display-supports-face-attributes-p",
6575 Fdisplay_supports_face_attributes_p
, Sdisplay_supports_face_attributes_p
,
6577 doc
: /* Return non-nil if all the face attributes in ATTRIBUTES are supported.
6578 The optional argument DISPLAY can be a display name, a frame, or
6579 nil (meaning the selected frame's display).
6581 The definition of `supported' is somewhat heuristic, but basically means
6582 that a face containing all the attributes in ATTRIBUTES, when merged
6583 with the default face for display, can be represented in a way that's
6585 \(1) different in appearance than the default face, and
6586 \(2) `close in spirit' to what the attributes specify, if not exact.
6588 Point (2) implies that a `:weight black' attribute will be satisfied by
6589 any display that can display bold, and a `:foreground \"yellow\"' as long
6590 as it can display a yellowish color, but `:slant italic' will _not_ be
6591 satisfied by the tty display code's automatic substitution of a `dim'
6592 face for italic. */)
6593 (attributes
, display
)
6594 Lisp_Object attributes
, display
;
6596 int supports
= 0, i
;
6599 struct face
*def_face
;
6600 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6602 if (noninteractive
|| !initialized
)
6603 /* We may not be able to access low-level face information in batch
6604 mode, or before being dumped, and this function is not going to
6605 be very useful in those cases anyway, so just give up. */
6609 frame
= selected_frame
;
6610 else if (FRAMEP (display
))
6614 /* Find any frame on DISPLAY. */
6615 Lisp_Object fl_tail
;
6618 for (fl_tail
= Vframe_list
; CONSP (fl_tail
); fl_tail
= XCDR (fl_tail
))
6620 frame
= XCAR (fl_tail
);
6621 if (!NILP (Fequal (Fcdr (Fassq (Qdisplay
,
6622 XFRAME (frame
)->param_alist
)),
6628 CHECK_LIVE_FRAME (frame
);
6631 for (i
= 0; i
< LFACE_VECTOR_SIZE
; i
++)
6632 attrs
[i
] = Qunspecified
;
6633 merge_face_ref (f
, attributes
, attrs
, 1, 0);
6635 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6636 if (def_face
== NULL
)
6638 if (! realize_basic_faces (f
))
6639 error ("Cannot realize default face");
6640 def_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6641 if (def_face
== NULL
)
6642 abort (); /* realize_basic_faces must have set it up */
6645 /* Dispatch to the appropriate handler. */
6646 if (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
6647 supports
= tty_supports_face_attributes_p (f
, attrs
, def_face
);
6648 #ifdef HAVE_WINDOW_SYSTEM
6650 supports
= x_supports_face_attributes_p (f
, attrs
, def_face
);
6653 return supports
? Qt
: Qnil
;
6657 /***********************************************************************
6659 ***********************************************************************/
6661 DEFUN ("internal-set-font-selection-order",
6662 Finternal_set_font_selection_order
,
6663 Sinternal_set_font_selection_order
, 1, 1, 0,
6664 doc
: /* Set font selection order for face font selection to ORDER.
6665 ORDER must be a list of length 4 containing the symbols `:width',
6666 `:height', `:weight', and `:slant'. Face attributes appearing
6667 first in ORDER are matched first, e.g. if `:height' appears before
6668 `:weight' in ORDER, font selection first tries to find a font with
6669 a suitable height, and then tries to match the font weight.
6676 int indices
[DIM (font_sort_order
)];
6679 bzero (indices
, sizeof indices
);
6683 CONSP (list
) && i
< DIM (indices
);
6684 list
= XCDR (list
), ++i
)
6686 Lisp_Object attr
= XCAR (list
);
6689 if (EQ (attr
, QCwidth
))
6691 else if (EQ (attr
, QCheight
))
6692 xlfd
= XLFD_POINT_SIZE
;
6693 else if (EQ (attr
, QCweight
))
6695 else if (EQ (attr
, QCslant
))
6700 if (indices
[i
] != 0)
6705 if (!NILP (list
) || i
!= DIM (indices
))
6706 signal_error ("Invalid font sort order", order
);
6707 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6708 if (indices
[i
] == 0)
6709 signal_error ("Invalid font sort order", order
);
6711 if (bcmp (indices
, font_sort_order
, sizeof indices
) != 0)
6713 bcopy (indices
, font_sort_order
, sizeof font_sort_order
);
6714 free_all_realized_faces (Qnil
);
6717 #ifdef USE_FONT_BACKEND
6718 if (enable_font_backend
)
6719 font_update_sort_order (font_sort_order
);
6720 #endif /* USE_FONT_BACKEND */
6726 DEFUN ("internal-set-alternative-font-family-alist",
6727 Finternal_set_alternative_font_family_alist
,
6728 Sinternal_set_alternative_font_family_alist
, 1, 1, 0,
6729 doc
: /* Define alternative font families to try in face font selection.
6730 ALIST is an alist of (FAMILY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6731 Each ALTERNATIVE is tried in order if no fonts of font family FAMILY can
6732 be found. Value is ALIST. */)
6737 Vface_alternative_font_family_alist
= alist
;
6738 free_all_realized_faces (Qnil
);
6743 DEFUN ("internal-set-alternative-font-registry-alist",
6744 Finternal_set_alternative_font_registry_alist
,
6745 Sinternal_set_alternative_font_registry_alist
, 1, 1, 0,
6746 doc
: /* Define alternative font registries to try in face font selection.
6747 ALIST is an alist of (REGISTRY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6748 Each ALTERNATIVE is tried in order if no fonts of font registry REGISTRY can
6749 be found. Value is ALIST. */)
6754 Vface_alternative_font_registry_alist
= alist
;
6755 free_all_realized_faces (Qnil
);
6760 #ifdef HAVE_WINDOW_SYSTEM
6762 /* Value is non-zero if FONT is the name of a scalable font. The
6763 X11R6 XLFD spec says that point size, pixel size, and average width
6764 are zero for scalable fonts. Intlfonts contain at least one
6765 scalable font ("*-muleindian-1") for which this isn't true, so we
6766 just test average width. */
6769 font_scalable_p (font
)
6770 struct font_name
*font
;
6772 char *s
= font
->fields
[XLFD_AVGWIDTH
];
6773 return (*s
== '0' && *(s
+ 1) == '\0')
6775 /* Windows implementation of XLFD is slightly broken for backward
6776 compatibility with previous broken versions, so test for
6777 wildcards as well as 0. */
6784 /* Ignore the difference of font point size less than this value. */
6786 #define FONT_POINT_SIZE_QUANTUM 5
6788 /* Value is non-zero if FONT1 is a better match for font attributes
6789 VALUES than FONT2. VALUES is an array of face attribute values in
6790 font sort order. COMPARE_PT_P zero means don't compare point
6791 sizes. AVGWIDTH, if not zero, is a specified font average width
6795 better_font_p (values
, font1
, font2
, compare_pt_p
, avgwidth
)
6797 struct font_name
*font1
, *font2
;
6798 int compare_pt_p
, avgwidth
;
6802 /* Any font is better than no font. */
6808 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6810 int xlfd_idx
= font_sort_order
[i
];
6812 if (compare_pt_p
|| xlfd_idx
!= XLFD_POINT_SIZE
)
6816 if (xlfd_idx
== XLFD_POINT_SIZE
)
6818 delta1
= eabs (values
[i
] - (font1
->numeric
[xlfd_idx
]
6819 / font1
->rescale_ratio
));
6820 delta2
= eabs (values
[i
] - (font2
->numeric
[xlfd_idx
]
6821 / font2
->rescale_ratio
));
6822 if (eabs (delta1
- delta2
) < FONT_POINT_SIZE_QUANTUM
)
6827 delta1
= eabs (values
[i
] - font1
->numeric
[xlfd_idx
]);
6828 delta2
= eabs (values
[i
] - font2
->numeric
[xlfd_idx
]);
6831 if (delta1
> delta2
)
6833 else if (delta1
< delta2
)
6837 /* The difference may be equal because, e.g., the face
6838 specifies `italic' but we have only `regular' and
6839 `oblique'. Prefer `oblique' in this case. */
6840 if ((xlfd_idx
== XLFD_WEIGHT
|| xlfd_idx
== XLFD_SLANT
)
6841 && font1
->numeric
[xlfd_idx
] > values
[i
]
6842 && font2
->numeric
[xlfd_idx
] < values
[i
])
6850 int delta1
= eabs (avgwidth
- font1
->numeric
[XLFD_AVGWIDTH
]);
6851 int delta2
= eabs (avgwidth
- font2
->numeric
[XLFD_AVGWIDTH
]);
6852 if (delta1
> delta2
)
6854 else if (delta1
< delta2
)
6860 /* We prefer a real scalable font; i.e. not what autoscaled. */
6861 int auto_scaled_1
= (font1
->numeric
[XLFD_POINT_SIZE
] == 0
6862 && font1
->numeric
[XLFD_RESY
] > 0);
6863 int auto_scaled_2
= (font2
->numeric
[XLFD_POINT_SIZE
] == 0
6864 && font2
->numeric
[XLFD_RESY
] > 0);
6866 if (auto_scaled_1
!= auto_scaled_2
)
6867 return auto_scaled_2
;
6870 return font1
->registry_priority
< font2
->registry_priority
;
6874 /* Value is non-zero if FONT is an exact match for face attributes in
6875 SPECIFIED. SPECIFIED is an array of face attribute values in font
6876 sort order. AVGWIDTH, if non-zero, is an average width to compare
6880 exact_face_match_p (specified
, font
, avgwidth
)
6882 struct font_name
*font
;
6887 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6888 if (specified
[i
] != font
->numeric
[font_sort_order
[i
]])
6891 return (i
== DIM (font_sort_order
)
6893 || avgwidth
== font
->numeric
[XLFD_AVGWIDTH
]));
6897 /* Value is the name of a scaled font, generated from scalable font
6898 FONT on frame F. SPECIFIED_PT is the point-size to scale FONT to.
6899 Value is allocated from heap. */
6902 build_scalable_font_name (f
, font
, specified_pt
)
6904 struct font_name
*font
;
6907 char pixel_size
[20];
6909 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
6912 if (font
->numeric
[XLFD_PIXEL_SIZE
] != 0
6913 || font
->numeric
[XLFD_POINT_SIZE
] != 0)
6914 /* This is a scalable font but is requested for a specific size.
6915 We should not change that size. */
6916 return build_font_name (font
);
6918 /* If scalable font is for a specific resolution, compute
6919 the point size we must specify from the resolution of
6920 the display and the specified resolution of the font. */
6921 if (font
->numeric
[XLFD_RESY
] != 0)
6923 pt
= resy
/ font
->numeric
[XLFD_RESY
] * specified_pt
+ 0.5;
6924 pixel_value
= font
->numeric
[XLFD_RESY
] / (PT_PER_INCH
* 10.0) * pt
+ 0.5;
6929 pixel_value
= resy
/ (PT_PER_INCH
* 10.0) * pt
+ 0.5;
6931 /* We may need a font of the different size. */
6932 pixel_value
*= font
->rescale_ratio
;
6934 /* We should keep POINT_SIZE 0. Otherwise, X server can't open a
6935 font of the specified PIXEL_SIZE. */
6937 { /* Set point size of the font. */
6938 char point_size
[20];
6939 sprintf (point_size
, "%d", (int) pt
);
6940 font
->fields
[XLFD_POINT_SIZE
] = point_size
;
6941 font
->numeric
[XLFD_POINT_SIZE
] = pt
;
6945 /* Set pixel size. */
6946 sprintf (pixel_size
, "%d", pixel_value
);
6947 font
->fields
[XLFD_PIXEL_SIZE
] = pixel_size
;
6948 font
->numeric
[XLFD_PIXEL_SIZE
] = pixel_value
;
6950 /* If font doesn't specify its resolution, use the
6951 resolution of the display. */
6952 if (font
->numeric
[XLFD_RESY
] == 0)
6955 sprintf (buffer
, "%d", (int) resy
);
6956 font
->fields
[XLFD_RESY
] = buffer
;
6957 font
->numeric
[XLFD_RESY
] = resy
;
6960 if (strcmp (font
->fields
[XLFD_RESX
], "0") == 0)
6963 int resx
= FRAME_X_DISPLAY_INFO (f
)->resx
;
6964 sprintf (buffer
, "%d", resx
);
6965 font
->fields
[XLFD_RESX
] = buffer
;
6966 font
->numeric
[XLFD_RESX
] = resx
;
6969 return build_font_name (font
);
6973 /* Value is non-zero if we are allowed to use scalable font FONT. We
6974 can't run a Lisp function here since this function may be called
6975 with input blocked. */
6978 may_use_scalable_font_p (font
)
6981 if (EQ (Vscalable_fonts_allowed
, Qt
))
6983 else if (CONSP (Vscalable_fonts_allowed
))
6985 Lisp_Object tail
, regexp
;
6987 for (tail
= Vscalable_fonts_allowed
; CONSP (tail
); tail
= XCDR (tail
))
6989 regexp
= XCAR (tail
);
6990 if (STRINGP (regexp
)
6991 && fast_c_string_match_ignore_case (regexp
, font
) >= 0)
7001 /* Return the name of the best matching font for face attributes ATTRS
7002 in the array of font_name structures FONTS which contains NFONTS
7003 elements. WIDTH_RATIO is a factor with which to multiply average
7004 widths if ATTRS specifies such a width.
7006 Value is a font name which is allocated from the heap. FONTS is
7007 freed by this function.
7009 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
7010 indicate whether the resulting font should be drawn using overstrike
7011 to simulate bold-face. */
7014 best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
, needs_overstrike
)
7017 struct font_name
*fonts
;
7020 int *needs_overstrike
;
7023 struct font_name
*best
;
7026 int exact_p
, avgwidth
;
7031 /* Make specified font attributes available in `specified',
7032 indexed by sort order. */
7033 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
7035 int xlfd_idx
= font_sort_order
[i
];
7037 if (xlfd_idx
== XLFD_SWIDTH
)
7038 specified
[i
] = face_numeric_swidth (attrs
[LFACE_SWIDTH_INDEX
]);
7039 else if (xlfd_idx
== XLFD_POINT_SIZE
)
7040 specified
[i
] = pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
7041 else if (xlfd_idx
== XLFD_WEIGHT
)
7042 specified
[i
] = face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
7043 else if (xlfd_idx
== XLFD_SLANT
)
7044 specified
[i
] = face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
7049 avgwidth
= (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
7051 : XFASTINT (attrs
[LFACE_AVGWIDTH_INDEX
]) * width_ratio
);
7055 if (needs_overstrike
)
7056 *needs_overstrike
= 0;
7060 /* Find the best match among the non-scalable fonts. */
7061 for (i
= 0; i
< nfonts
; ++i
)
7062 if (!font_scalable_p (fonts
+ i
)
7063 && better_font_p (specified
, fonts
+ i
, best
, 1, avgwidth
))
7067 exact_p
= exact_face_match_p (specified
, best
, avgwidth
);
7072 /* Unless we found an exact match among non-scalable fonts, see if
7073 we can find a better match among scalable fonts. */
7076 /* A scalable font is better if
7078 1. its weight, slant, swidth attributes are better, or.
7080 2. the best non-scalable font doesn't have the required
7081 point size, and the scalable fonts weight, slant, swidth
7084 int non_scalable_has_exact_height_p
;
7086 if (best
&& best
->numeric
[XLFD_POINT_SIZE
] == pt
)
7087 non_scalable_has_exact_height_p
= 1;
7089 non_scalable_has_exact_height_p
= 0;
7091 for (i
= 0; i
< nfonts
; ++i
)
7092 if (font_scalable_p (fonts
+ i
))
7094 if (better_font_p (specified
, fonts
+ i
, best
, 0, 0)
7095 || (!non_scalable_has_exact_height_p
7096 && !better_font_p (specified
, best
, fonts
+ i
, 0, 0)))
7098 non_scalable_has_exact_height_p
= 1;
7104 /* We should have found SOME font. */
7108 if (! exact_p
&& needs_overstrike
)
7110 enum xlfd_weight want_weight
= specified
[XLFD_WEIGHT
];
7111 enum xlfd_weight got_weight
= best
->numeric
[XLFD_WEIGHT
];
7113 if (want_weight
> XLFD_WEIGHT_MEDIUM
&& want_weight
> got_weight
)
7115 /* We want a bold font, but didn't get one; try to use
7116 overstriking instead to simulate bold-face. However,
7117 don't overstrike an already-bold font unless the
7118 desired weight grossly exceeds the available weight. */
7119 if (got_weight
> XLFD_WEIGHT_MEDIUM
)
7120 *needs_overstrike
= (want_weight
- got_weight
) > 2;
7122 *needs_overstrike
= 1;
7126 if (font_scalable_p (best
))
7127 font_name
= build_scalable_font_name (f
, best
, pt
);
7129 font_name
= build_font_name (best
);
7131 /* Free font_name structures. */
7132 free_font_names (fonts
, nfonts
);
7138 /* Get a list of matching fonts on frame F, considering FAMILY
7139 and alternative font families from Vface_alternative_font_registry_alist.
7141 FAMILY is the font family whose alternatives are considered.
7143 REGISTRY, if a string, specifies a font registry and encoding to
7144 match. A value of nil means include fonts of any registry and
7147 Return in *FONTS a pointer to a vector of font_name structures for
7148 the fonts matched. Value is the number of fonts found. */
7151 try_alternative_families (f
, family
, registry
, fonts
)
7153 Lisp_Object family
, registry
;
7154 struct font_name
**fonts
;
7159 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
7162 /* Try alternative font families. */
7163 alter
= Fassoc (family
, Vface_alternative_font_family_alist
);
7166 for (alter
= XCDR (alter
);
7167 CONSP (alter
) && nfonts
== 0;
7168 alter
= XCDR (alter
))
7170 if (STRINGP (XCAR (alter
)))
7171 nfonts
= font_list (f
, Qnil
, XCAR (alter
), registry
, fonts
);
7175 /* Try all scalable fonts before giving up. */
7176 if (nfonts
== 0 && ! EQ (Vscalable_fonts_allowed
, Qt
))
7178 int count
= SPECPDL_INDEX ();
7179 specbind (Qscalable_fonts_allowed
, Qt
);
7180 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
7181 unbind_to (count
, Qnil
);
7188 /* Get a list of matching fonts on frame F.
7190 PATTERN, if a string, specifies a font name pattern to match while
7191 ignoring FAMILY and REGISTRY.
7193 FAMILY, if a list, specifies a list of font families to try.
7195 REGISTRY, if a list, specifies a list of font registries and
7198 Return in *FONTS a pointer to a vector of font_name structures for
7199 the fonts matched. Value is the number of fonts found. */
7202 try_font_list (f
, pattern
, family
, registry
, fonts
)
7204 Lisp_Object pattern
, family
, registry
;
7205 struct font_name
**fonts
;
7209 if (STRINGP (pattern
))
7211 nfonts
= font_list (f
, pattern
, Qnil
, Qnil
, fonts
);
7212 if (nfonts
== 0 && ! EQ (Vscalable_fonts_allowed
, Qt
))
7214 int count
= SPECPDL_INDEX ();
7215 specbind (Qscalable_fonts_allowed
, Qt
);
7216 nfonts
= font_list (f
, pattern
, Qnil
, Qnil
, fonts
);
7217 unbind_to (count
, Qnil
);
7225 nfonts
= font_list (f
, Qnil
, Qnil
, registry
, fonts
);
7227 for (tail
= family
; ! nfonts
&& CONSP (tail
); tail
= XCDR (tail
))
7228 nfonts
= try_alternative_families (f
, XCAR (tail
), registry
, fonts
);
7230 /* Try font family of the default face or "fixed". */
7231 if (nfonts
== 0 && !NILP (family
))
7233 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7235 family
= default_face
->lface
[LFACE_FAMILY_INDEX
];
7237 family
= build_string ("fixed");
7238 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
7241 /* Try any family with the given registry. */
7242 if (nfonts
== 0 && !NILP (family
))
7243 nfonts
= try_alternative_families (f
, Qnil
, registry
, fonts
);
7250 /* Return the fontset id of the base fontset name or alias name given
7251 by the fontset attribute of ATTRS. Value is -1 if the fontset
7252 attribute of ATTRS doesn't name a fontset. */
7255 face_fontset (attrs
)
7260 name
= attrs
[LFACE_FONTSET_INDEX
];
7261 if (!STRINGP (name
))
7263 return fs_query_fontset (name
, 0);
7267 /* Choose a name of font to use on frame F to display characters with
7268 Lisp face attributes specified by ATTRS. The font name is
7269 determined by the font-related attributes in ATTRS and FONT-SPEC
7272 When we are choosing a font for ASCII characters, FONT-SPEC is
7273 always nil. Otherwise FONT-SPEC is an object created by
7274 `font-spec' or a string specifying a font name pattern.
7276 If NEEDS_OVERSTRIKE is not NULL, a boolean is returned in it to
7277 indicate whether the resulting font should be drawn using
7278 overstrike to simulate bold-face.
7280 Value is the font name which is allocated from the heap and must be
7281 freed by the caller. */
7284 choose_face_font (f
, attrs
, font_spec
, needs_overstrike
)
7287 Lisp_Object font_spec
;
7288 int *needs_overstrike
;
7290 Lisp_Object pattern
, family
, adstyle
, registry
;
7291 char *font_name
= NULL
;
7292 struct font_name
*fonts
;
7295 if (needs_overstrike
)
7296 *needs_overstrike
= 0;
7298 /* If we are choosing an ASCII font and a font name is explicitly
7299 specified in ATTRS, return it. */
7300 if (NILP (font_spec
) && STRINGP (attrs
[LFACE_FONT_INDEX
]))
7301 return xstrdup (SDATA (attrs
[LFACE_FONT_INDEX
]));
7303 if (NILP (attrs
[LFACE_FAMILY_INDEX
]))
7306 family
= Fcons (attrs
[LFACE_FAMILY_INDEX
], Qnil
);
7308 /* Decide FAMILY, ADSTYLE, and REGISTRY from FONT_SPEC. But,
7309 ADSTYLE is not used in the font selector for the moment. */
7310 if (VECTORP (font_spec
))
7313 if (! NILP (AREF (font_spec
, FONT_FAMILY_INDEX
)))
7314 family
= Fcons (SYMBOL_NAME (AREF (font_spec
, FONT_FAMILY_INDEX
)),
7316 adstyle
= AREF (font_spec
, FONT_ADSTYLE_INDEX
);
7317 registry
= Fcons (SYMBOL_NAME (AREF (font_spec
, FONT_REGISTRY_INDEX
)),
7320 else if (STRINGP (font_spec
))
7322 pattern
= font_spec
;
7329 /* We are choosing an ASCII font. By default, use the registry
7330 name "iso8859-1". But, if the registry name of the ASCII
7331 font specified in the fontset of ATTRS is not "iso8859-1"
7332 (e.g "iso10646-1"), use also that name with higher
7334 int fontset
= face_fontset (attrs
);
7337 struct font_name font
;
7341 registry
= Fcons (build_string ("iso8859-1"), Qnil
);
7343 ascii
= fontset_ascii (fontset
);
7344 len
= SBYTES (ascii
);
7346 || strcmp (SDATA (ascii
) + len
- 9, "iso8859-1"))
7348 font
.name
= LSTRDUPA (ascii
);
7349 /* Check if the name is in XLFD. */
7350 if (split_font_name (f
, &font
, 0))
7352 font
.fields
[XLFD_ENCODING
][-1] = '-';
7353 registry
= Fcons (build_string (font
.fields
[XLFD_REGISTRY
]),
7359 /* Get a list of fonts matching that pattern and choose the
7360 best match for the specified face attributes from it. */
7361 nfonts
= try_font_list (f
, pattern
, family
, registry
, &fonts
);
7362 font_name
= best_matching_font (f
, attrs
, fonts
, nfonts
, NILP (font_spec
),
7367 #endif /* HAVE_WINDOW_SYSTEM */
7371 /***********************************************************************
7373 ***********************************************************************/
7375 /* Realize basic faces on frame F. Value is zero if frame parameters
7376 of F don't contain enough information needed to realize the default
7380 realize_basic_faces (f
)
7384 int count
= SPECPDL_INDEX ();
7386 /* Block input here so that we won't be surprised by an X expose
7387 event, for instance, without having the faces set up. */
7389 specbind (Qscalable_fonts_allowed
, Qt
);
7391 if (realize_default_face (f
))
7393 realize_named_face (f
, Qmode_line
, MODE_LINE_FACE_ID
);
7394 realize_named_face (f
, Qmode_line_inactive
, MODE_LINE_INACTIVE_FACE_ID
);
7395 realize_named_face (f
, Qtool_bar
, TOOL_BAR_FACE_ID
);
7396 realize_named_face (f
, Qfringe
, FRINGE_FACE_ID
);
7397 realize_named_face (f
, Qheader_line
, HEADER_LINE_FACE_ID
);
7398 realize_named_face (f
, Qscroll_bar
, SCROLL_BAR_FACE_ID
);
7399 realize_named_face (f
, Qborder
, BORDER_FACE_ID
);
7400 realize_named_face (f
, Qcursor
, CURSOR_FACE_ID
);
7401 realize_named_face (f
, Qmouse
, MOUSE_FACE_ID
);
7402 realize_named_face (f
, Qmenu
, MENU_FACE_ID
);
7403 realize_named_face (f
, Qvertical_border
, VERTICAL_BORDER_FACE_ID
);
7405 /* Reflect changes in the `menu' face in menu bars. */
7406 if (FRAME_FACE_CACHE (f
)->menu_face_changed_p
)
7408 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 0;
7409 #ifdef USE_X_TOOLKIT
7410 if (FRAME_WINDOW_P (f
))
7411 x_update_menu_appearance (f
);
7418 unbind_to (count
, Qnil
);
7424 /* Realize the default face on frame F. If the face is not fully
7425 specified, make it fully-specified. Attributes of the default face
7426 that are not explicitly specified are taken from frame parameters. */
7429 realize_default_face (f
)
7432 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
7434 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7435 Lisp_Object frame_font
;
7438 /* If the `default' face is not yet known, create it. */
7439 lface
= lface_from_face_name (f
, Qdefault
, 0);
7443 XSETFRAME (frame
, f
);
7444 lface
= Finternal_make_lisp_face (Qdefault
, frame
);
7448 #ifdef HAVE_WINDOW_SYSTEM
7449 if (FRAME_WINDOW_P (f
))
7451 #ifdef USE_FONT_BACKEND
7452 if (enable_font_backend
)
7454 frame_font
= font_find_object (FRAME_FONT_OBJECT (f
));
7455 xassert (FONT_OBJECT_P (frame_font
));
7456 set_lface_from_font_and_fontset (f
, lface
, frame_font
,
7458 f
->default_face_done_p
);
7462 #endif /* USE_FONT_BACKEND */
7463 /* Set frame_font to the value of the `font' frame parameter. */
7464 frame_font
= Fassq (Qfont
, f
->param_alist
);
7465 xassert (CONSP (frame_font
) && STRINGP (XCDR (frame_font
)));
7466 frame_font
= XCDR (frame_font
);
7467 set_lface_from_font_name (f
, lface
, frame_font
,
7468 f
->default_face_done_p
, 1);
7469 #ifdef USE_FONT_BACKEND
7471 #endif /* USE_FONT_BACKEND */
7472 f
->default_face_done_p
= 1;
7474 #endif /* HAVE_WINDOW_SYSTEM */
7476 if (!FRAME_WINDOW_P (f
))
7478 LFACE_FAMILY (lface
) = build_string ("default");
7479 LFACE_SWIDTH (lface
) = Qnormal
;
7480 LFACE_HEIGHT (lface
) = make_number (1);
7481 if (UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
7482 LFACE_WEIGHT (lface
) = Qnormal
;
7483 if (UNSPECIFIEDP (LFACE_SLANT (lface
)))
7484 LFACE_SLANT (lface
) = Qnormal
;
7485 LFACE_AVGWIDTH (lface
) = Qunspecified
;
7488 if (UNSPECIFIEDP (LFACE_UNDERLINE (lface
)))
7489 LFACE_UNDERLINE (lface
) = Qnil
;
7491 if (UNSPECIFIEDP (LFACE_OVERLINE (lface
)))
7492 LFACE_OVERLINE (lface
) = Qnil
;
7494 if (UNSPECIFIEDP (LFACE_STRIKE_THROUGH (lface
)))
7495 LFACE_STRIKE_THROUGH (lface
) = Qnil
;
7497 if (UNSPECIFIEDP (LFACE_BOX (lface
)))
7498 LFACE_BOX (lface
) = Qnil
;
7500 if (UNSPECIFIEDP (LFACE_INVERSE (lface
)))
7501 LFACE_INVERSE (lface
) = Qnil
;
7503 if (UNSPECIFIEDP (LFACE_FOREGROUND (lface
)))
7505 /* This function is called so early that colors are not yet
7506 set in the frame parameter list. */
7507 Lisp_Object color
= Fassq (Qforeground_color
, f
->param_alist
);
7509 if (CONSP (color
) && STRINGP (XCDR (color
)))
7510 LFACE_FOREGROUND (lface
) = XCDR (color
);
7511 else if (FRAME_WINDOW_P (f
))
7513 else if (FRAME_INITIAL_P (f
) || FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
7514 LFACE_FOREGROUND (lface
) = build_string (unspecified_fg
);
7519 if (UNSPECIFIEDP (LFACE_BACKGROUND (lface
)))
7521 /* This function is called so early that colors are not yet
7522 set in the frame parameter list. */
7523 Lisp_Object color
= Fassq (Qbackground_color
, f
->param_alist
);
7524 if (CONSP (color
) && STRINGP (XCDR (color
)))
7525 LFACE_BACKGROUND (lface
) = XCDR (color
);
7526 else if (FRAME_WINDOW_P (f
))
7528 else if (FRAME_INITIAL_P (f
) || FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
7529 LFACE_BACKGROUND (lface
) = build_string (unspecified_bg
);
7534 if (UNSPECIFIEDP (LFACE_STIPPLE (lface
)))
7535 LFACE_STIPPLE (lface
) = Qnil
;
7537 /* Realize the face; it must be fully-specified now. */
7538 xassert (lface_fully_specified_p (XVECTOR (lface
)->contents
));
7539 check_lface (lface
);
7540 bcopy (XVECTOR (lface
)->contents
, attrs
, sizeof attrs
);
7541 face
= realize_face (c
, attrs
, DEFAULT_FACE_ID
);
7543 #ifdef HAVE_WINDOW_SYSTEM
7544 #ifdef HAVE_X_WINDOWS
7545 if (FRAME_X_P (f
) && face
->font
!= FRAME_FONT (f
))
7547 /* This can happen when making a frame on a display that does
7548 not support the default font. */
7552 /* Otherwise, the font specified for the frame was not
7553 acceptable as a font for the default face (perhaps because
7554 auto-scaled fonts are rejected), so we must adjust the frame
7556 x_set_font (f
, build_string (face
->font_name
), Qnil
);
7558 #endif /* HAVE_X_WINDOWS */
7559 #endif /* HAVE_WINDOW_SYSTEM */
7564 /* Realize basic faces other than the default face in face cache C.
7565 SYMBOL is the face name, ID is the face id the realized face must
7566 have. The default face must have been realized already. */
7569 realize_named_face (f
, symbol
, id
)
7574 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
7575 Lisp_Object lface
= lface_from_face_name (f
, symbol
, 0);
7576 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7577 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
7578 struct face
*new_face
;
7580 /* The default face must exist and be fully specified. */
7581 get_lface_attributes (f
, Qdefault
, attrs
, 1);
7582 check_lface_attrs (attrs
);
7583 xassert (lface_fully_specified_p (attrs
));
7585 /* If SYMBOL isn't know as a face, create it. */
7589 XSETFRAME (frame
, f
);
7590 lface
= Finternal_make_lisp_face (symbol
, frame
);
7593 /* Merge SYMBOL's face with the default face. */
7594 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
7595 merge_face_vectors (f
, symbol_attrs
, attrs
, 0);
7597 /* Realize the face. */
7598 new_face
= realize_face (c
, attrs
, id
);
7602 /* Realize the fully-specified face with attributes ATTRS in face
7603 cache CACHE for ASCII characters. If FORMER_FACE_ID is
7604 non-negative, it is an ID of face to remove before caching the new
7605 face. Value is a pointer to the newly created realized face. */
7607 static struct face
*
7608 realize_face (cache
, attrs
, former_face_id
)
7609 struct face_cache
*cache
;
7615 /* LFACE must be fully specified. */
7616 xassert (cache
!= NULL
);
7617 check_lface_attrs (attrs
);
7619 if (former_face_id
>= 0 && cache
->used
> former_face_id
)
7621 /* Remove the former face. */
7622 struct face
*former_face
= cache
->faces_by_id
[former_face_id
];
7623 uncache_face (cache
, former_face
);
7624 free_realized_face (cache
->f
, former_face
);
7627 if (FRAME_WINDOW_P (cache
->f
))
7628 face
= realize_x_face (cache
, attrs
);
7629 else if (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
))
7630 face
= realize_tty_face (cache
, attrs
);
7631 else if (FRAME_INITIAL_P (cache
->f
))
7633 /* Create a dummy face. */
7634 face
= make_realized_face (attrs
);
7639 /* Insert the new face. */
7640 cache_face (cache
, face
, lface_hash (attrs
));
7645 #ifdef HAVE_WINDOW_SYSTEM
7646 /* Realize the fully-specified face that has the same attributes as
7647 BASE_FACE except for the font on frame F. If FONT_ID is not
7648 negative, it is an ID number of an already opened font that should
7649 be used by the face. If FONT_ID is negative, the face has no font,
7650 i.e., characters are displayed by empty boxes. */
7652 static struct face
*
7653 realize_non_ascii_face (f
, font_id
, base_face
)
7656 struct face
*base_face
;
7658 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
7660 struct font_info
*font_info
;
7662 face
= (struct face
*) xmalloc (sizeof *face
);
7665 #ifdef USE_FONT_BACKEND
7667 #endif /* USE_FONT_BACKEND */
7669 /* Don't try to free the colors copied bitwise from BASE_FACE. */
7670 face
->colors_copied_bitwise_p
= 1;
7672 face
->font_info_id
= font_id
;
7675 font_info
= FONT_INFO_FROM_ID (f
, font_id
);
7676 face
->font
= font_info
->font
;
7677 face
->font_name
= font_info
->full_name
;
7682 face
->font_name
= NULL
;
7687 cache_face (cache
, face
, face
->hash
);
7691 #endif /* HAVE_WINDOW_SYSTEM */
7694 /* Realize the fully-specified face with attributes ATTRS in face
7695 cache CACHE for ASCII characters. Do it for X frame CACHE->f. If
7696 the new face doesn't share font with the default face, a fontname
7697 is allocated from the heap and set in `font_name' of the new face,
7698 but it is not yet loaded here. Value is a pointer to the newly
7699 created realized face. */
7701 static struct face
*
7702 realize_x_face (cache
, attrs
)
7703 struct face_cache
*cache
;
7706 struct face
*face
= NULL
;
7707 #ifdef HAVE_WINDOW_SYSTEM
7708 struct face
*default_face
;
7710 Lisp_Object stipple
, overline
, strike_through
, box
;
7712 xassert (FRAME_WINDOW_P (cache
->f
));
7714 /* Allocate a new realized face. */
7715 face
= make_realized_face (attrs
);
7716 face
->ascii_face
= face
;
7720 /* Determine the font to use. Most of the time, the font will be
7721 the same as the font of the default face, so try that first. */
7722 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7724 && lface_same_font_attributes_p (default_face
->lface
, attrs
))
7726 face
->font
= default_face
->font
;
7727 face
->font_info_id
= default_face
->font_info_id
;
7728 #ifdef USE_FONT_BACKEND
7729 if (enable_font_backend
)
7730 face
->font_info
= default_face
->font_info
;
7731 #endif /* USE_FONT_BACKEND */
7732 face
->font_name
= default_face
->font_name
;
7734 = make_fontset_for_ascii_face (f
, default_face
->fontset
, face
);
7738 /* If the face attribute ATTRS specifies a fontset, use it as
7739 the base of a new realized fontset. Otherwise, use the same
7740 base fontset as of the default face. The base determines
7741 registry and encoding of a font. It may also determine
7742 foundry and family. The other fields of font name pattern
7743 are constructed from ATTRS. */
7744 int fontset
= face_fontset (attrs
);
7746 /* If we are realizing the default face, ATTRS should specify a
7747 fontset. In other words, if FONTSET is -1, we are not
7748 realizing the default face, thus the default face should have
7749 already been realized. */
7751 fontset
= default_face
->fontset
;
7754 #ifdef USE_FONT_BACKEND
7755 if (enable_font_backend
)
7756 font_load_for_face (f
, face
);
7758 #endif /* USE_FONT_BACKEND */
7759 load_face_font (f
, face
);
7761 face
->fontset
= make_fontset_for_ascii_face (f
, fontset
, face
);
7766 /* Load colors, and set remaining attributes. */
7768 load_face_colors (f
, face
, attrs
);
7771 box
= attrs
[LFACE_BOX_INDEX
];
7774 /* A simple box of line width 1 drawn in color given by
7776 face
->box_color
= load_color (f
, face
, attrs
[LFACE_BOX_INDEX
],
7778 face
->box
= FACE_SIMPLE_BOX
;
7779 face
->box_line_width
= 1;
7781 else if (INTEGERP (box
))
7783 /* Simple box of specified line width in foreground color of the
7785 xassert (XINT (box
) != 0);
7786 face
->box
= FACE_SIMPLE_BOX
;
7787 face
->box_line_width
= XINT (box
);
7788 face
->box_color
= face
->foreground
;
7789 face
->box_color_defaulted_p
= 1;
7791 else if (CONSP (box
))
7793 /* `(:width WIDTH :color COLOR :shadow SHADOW)'. SHADOW
7794 being one of `raised' or `sunken'. */
7795 face
->box
= FACE_SIMPLE_BOX
;
7796 face
->box_color
= face
->foreground
;
7797 face
->box_color_defaulted_p
= 1;
7798 face
->box_line_width
= 1;
7802 Lisp_Object keyword
, value
;
7804 keyword
= XCAR (box
);
7812 if (EQ (keyword
, QCline_width
))
7814 if (INTEGERP (value
) && XINT (value
) != 0)
7815 face
->box_line_width
= XINT (value
);
7817 else if (EQ (keyword
, QCcolor
))
7819 if (STRINGP (value
))
7821 face
->box_color
= load_color (f
, face
, value
,
7823 face
->use_box_color_for_shadows_p
= 1;
7826 else if (EQ (keyword
, QCstyle
))
7828 if (EQ (value
, Qreleased_button
))
7829 face
->box
= FACE_RAISED_BOX
;
7830 else if (EQ (value
, Qpressed_button
))
7831 face
->box
= FACE_SUNKEN_BOX
;
7836 /* Text underline, overline, strike-through. */
7838 if (EQ (attrs
[LFACE_UNDERLINE_INDEX
], Qt
))
7840 /* Use default color (same as foreground color). */
7841 face
->underline_p
= 1;
7842 face
->underline_defaulted_p
= 1;
7843 face
->underline_color
= 0;
7845 else if (STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]))
7847 /* Use specified color. */
7848 face
->underline_p
= 1;
7849 face
->underline_defaulted_p
= 0;
7850 face
->underline_color
7851 = load_color (f
, face
, attrs
[LFACE_UNDERLINE_INDEX
],
7852 LFACE_UNDERLINE_INDEX
);
7854 else if (NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7856 face
->underline_p
= 0;
7857 face
->underline_defaulted_p
= 0;
7858 face
->underline_color
= 0;
7861 overline
= attrs
[LFACE_OVERLINE_INDEX
];
7862 if (STRINGP (overline
))
7864 face
->overline_color
7865 = load_color (f
, face
, attrs
[LFACE_OVERLINE_INDEX
],
7866 LFACE_OVERLINE_INDEX
);
7867 face
->overline_p
= 1;
7869 else if (EQ (overline
, Qt
))
7871 face
->overline_color
= face
->foreground
;
7872 face
->overline_color_defaulted_p
= 1;
7873 face
->overline_p
= 1;
7876 strike_through
= attrs
[LFACE_STRIKE_THROUGH_INDEX
];
7877 if (STRINGP (strike_through
))
7879 face
->strike_through_color
7880 = load_color (f
, face
, attrs
[LFACE_STRIKE_THROUGH_INDEX
],
7881 LFACE_STRIKE_THROUGH_INDEX
);
7882 face
->strike_through_p
= 1;
7884 else if (EQ (strike_through
, Qt
))
7886 face
->strike_through_color
= face
->foreground
;
7887 face
->strike_through_color_defaulted_p
= 1;
7888 face
->strike_through_p
= 1;
7891 stipple
= attrs
[LFACE_STIPPLE_INDEX
];
7892 if (!NILP (stipple
))
7893 face
->stipple
= load_pixmap (f
, stipple
, &face
->pixmap_w
, &face
->pixmap_h
);
7894 #endif /* HAVE_WINDOW_SYSTEM */
7900 /* Map a specified color of face FACE on frame F to a tty color index.
7901 IDX is either LFACE_FOREGROUND_INDEX or LFACE_BACKGROUND_INDEX, and
7902 specifies which color to map. Set *DEFAULTED to 1 if mapping to the
7903 default foreground/background colors. */
7906 map_tty_color (f
, face
, idx
, defaulted
)
7909 enum lface_attribute_index idx
;
7912 Lisp_Object frame
, color
, def
;
7913 int foreground_p
= idx
== LFACE_FOREGROUND_INDEX
;
7914 unsigned long default_pixel
, default_other_pixel
, pixel
;
7916 xassert (idx
== LFACE_FOREGROUND_INDEX
|| idx
== LFACE_BACKGROUND_INDEX
);
7920 pixel
= default_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7921 default_other_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7925 pixel
= default_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7926 default_other_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7929 XSETFRAME (frame
, f
);
7930 color
= face
->lface
[idx
];
7934 && CONSP (Vtty_defined_color_alist
)
7935 && (def
= assq_no_quit (color
, call1 (Qtty_color_alist
, frame
)),
7938 /* Associations in tty-defined-color-alist are of the form
7939 (NAME INDEX R G B). We need the INDEX part. */
7940 pixel
= XINT (XCAR (XCDR (def
)));
7943 if (pixel
== default_pixel
&& STRINGP (color
))
7945 pixel
= load_color (f
, face
, color
, idx
);
7948 /* If the foreground of the default face is the default color,
7949 use the foreground color defined by the frame. */
7950 if (FRAME_MSDOS_P (f
))
7952 if (pixel
== default_pixel
7953 || pixel
== FACE_TTY_DEFAULT_COLOR
)
7956 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7958 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7959 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7962 else if (pixel
== default_other_pixel
)
7965 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7967 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7968 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7976 face
->foreground
= pixel
;
7978 face
->background
= pixel
;
7982 /* Realize the fully-specified face with attributes ATTRS in face
7983 cache CACHE for ASCII characters. Do it for TTY frame CACHE->f.
7984 Value is a pointer to the newly created realized face. */
7986 static struct face
*
7987 realize_tty_face (cache
, attrs
)
7988 struct face_cache
*cache
;
7993 int face_colors_defaulted
= 0;
7994 struct frame
*f
= cache
->f
;
7996 /* Frame must be a termcap frame. */
7997 xassert (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
));
7999 /* Allocate a new realized face. */
8000 face
= make_realized_face (attrs
);
8001 face
->font_name
= FRAME_MSDOS_P (cache
->f
) ? "ms-dos" : "tty";
8003 /* Map face attributes to TTY appearances. We map slant to
8004 dimmed text because we want italic text to appear differently
8005 and because dimmed text is probably used infrequently. */
8006 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
8007 slant
= face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
8009 if (weight
> XLFD_WEIGHT_MEDIUM
)
8010 face
->tty_bold_p
= 1;
8011 if (weight
< XLFD_WEIGHT_MEDIUM
|| slant
!= XLFD_SLANT_ROMAN
)
8012 face
->tty_dim_p
= 1;
8013 if (!NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
8014 face
->tty_underline_p
= 1;
8015 if (!NILP (attrs
[LFACE_INVERSE_INDEX
]))
8016 face
->tty_reverse_p
= 1;
8018 /* Map color names to color indices. */
8019 map_tty_color (f
, face
, LFACE_FOREGROUND_INDEX
, &face_colors_defaulted
);
8020 map_tty_color (f
, face
, LFACE_BACKGROUND_INDEX
, &face_colors_defaulted
);
8022 /* Swap colors if face is inverse-video. If the colors are taken
8023 from the frame colors, they are already inverted, since the
8024 frame-creation function calls x-handle-reverse-video. */
8025 if (face
->tty_reverse_p
&& !face_colors_defaulted
)
8027 unsigned long tem
= face
->foreground
;
8028 face
->foreground
= face
->background
;
8029 face
->background
= tem
;
8032 if (tty_suppress_bold_inverse_default_colors_p
8034 && face
->background
== FACE_TTY_DEFAULT_FG_COLOR
8035 && face
->foreground
== FACE_TTY_DEFAULT_BG_COLOR
)
8036 face
->tty_bold_p
= 0;
8042 DEFUN ("tty-suppress-bold-inverse-default-colors",
8043 Ftty_suppress_bold_inverse_default_colors
,
8044 Stty_suppress_bold_inverse_default_colors
, 1, 1, 0,
8045 doc
: /* Suppress/allow boldness of faces with inverse default colors.
8046 SUPPRESS non-nil means suppress it.
8047 This affects bold faces on TTYs whose foreground is the default background
8048 color of the display and whose background is the default foreground color.
8049 For such faces, the bold face attribute is ignored if this variable
8052 Lisp_Object suppress
;
8054 tty_suppress_bold_inverse_default_colors_p
= !NILP (suppress
);
8055 ++face_change_count
;
8061 /***********************************************************************
8063 ***********************************************************************/
8065 /* Return the ID of the face to use to display character CH with face
8066 property PROP on frame F in current_buffer. */
8069 compute_char_face (f
, ch
, prop
)
8076 if (NILP (current_buffer
->enable_multibyte_characters
))
8081 struct face
*face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
8082 face_id
= FACE_FOR_CHAR (f
, face
, ch
, -1, Qnil
);
8086 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
8087 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
8088 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
8089 merge_face_ref (f
, prop
, attrs
, 1, 0);
8090 face_id
= lookup_face (f
, attrs
);
8096 /* Return the face ID associated with buffer position POS for
8097 displaying ASCII characters. Return in *ENDPTR the position at
8098 which a different face is needed, as far as text properties and
8099 overlays are concerned. W is a window displaying current_buffer.
8101 REGION_BEG, REGION_END delimit the region, so it can be
8104 LIMIT is a position not to scan beyond. That is to limit the time
8105 this function can take.
8107 If MOUSE is non-zero, use the character's mouse-face, not its face.
8109 The face returned is suitable for displaying ASCII characters. */
8112 face_at_buffer_position (w
, pos
, region_beg
, region_end
,
8113 endptr
, limit
, mouse
)
8116 int region_beg
, region_end
;
8121 struct frame
*f
= XFRAME (w
->frame
);
8122 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
8123 Lisp_Object prop
, position
;
8125 Lisp_Object
*overlay_vec
;
8128 Lisp_Object propname
= mouse
? Qmouse_face
: Qface
;
8129 Lisp_Object limit1
, end
;
8130 struct face
*default_face
;
8132 /* W must display the current buffer. We could write this function
8133 to use the frame and buffer of W, but right now it doesn't. */
8134 /* xassert (XBUFFER (w->buffer) == current_buffer); */
8136 XSETFRAME (frame
, f
);
8137 XSETFASTINT (position
, pos
);
8140 if (pos
< region_beg
&& region_beg
< endpos
)
8141 endpos
= region_beg
;
8143 /* Get the `face' or `mouse_face' text property at POS, and
8144 determine the next position at which the property changes. */
8145 prop
= Fget_text_property (position
, propname
, w
->buffer
);
8146 XSETFASTINT (limit1
, (limit
< endpos
? limit
: endpos
));
8147 end
= Fnext_single_property_change (position
, propname
, w
->buffer
, limit1
);
8149 endpos
= XINT (end
);
8151 /* Look at properties from overlays. */
8155 GET_OVERLAYS_AT (pos
, overlay_vec
, noverlays
, &next_overlay
, 0);
8156 if (next_overlay
< endpos
)
8157 endpos
= next_overlay
;
8162 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
8164 /* Optimize common cases where we can use the default face. */
8167 && !(pos
>= region_beg
&& pos
< region_end
))
8168 return DEFAULT_FACE_ID
;
8170 /* Begin with attributes from the default face. */
8171 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
8173 /* Merge in attributes specified via text properties. */
8175 merge_face_ref (f
, prop
, attrs
, 1, 0);
8177 /* Now merge the overlay data. */
8178 noverlays
= sort_overlays (overlay_vec
, noverlays
, w
);
8179 for (i
= 0; i
< noverlays
; i
++)
8184 prop
= Foverlay_get (overlay_vec
[i
], propname
);
8186 merge_face_ref (f
, prop
, attrs
, 1, 0);
8188 oend
= OVERLAY_END (overlay_vec
[i
]);
8189 oendpos
= OVERLAY_POSITION (oend
);
8190 if (oendpos
< endpos
)
8194 /* If in the region, merge in the region face. */
8195 if (pos
>= region_beg
&& pos
< region_end
)
8197 merge_named_face (f
, Qregion
, attrs
, 0);
8199 if (region_end
< endpos
)
8200 endpos
= region_end
;
8205 /* Look up a realized face with the given face attributes,
8206 or realize a new one for ASCII characters. */
8207 return lookup_face (f
, attrs
);
8210 /* Return the face ID at buffer position POS for displaying ASCII
8211 characters associated with overlay strings for overlay OVERLAY.
8213 Like face_at_buffer_position except for OVERLAY. Currently it
8214 simply disregards the `face' properties of all overlays. */
8217 face_for_overlay_string (w
, pos
, region_beg
, region_end
,
8218 endptr
, limit
, mouse
, overlay
)
8221 int region_beg
, region_end
;
8225 Lisp_Object overlay
;
8227 struct frame
*f
= XFRAME (w
->frame
);
8228 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
8229 Lisp_Object prop
, position
;
8232 Lisp_Object propname
= mouse
? Qmouse_face
: Qface
;
8233 Lisp_Object limit1
, end
;
8234 struct face
*default_face
;
8236 /* W must display the current buffer. We could write this function
8237 to use the frame and buffer of W, but right now it doesn't. */
8238 /* xassert (XBUFFER (w->buffer) == current_buffer); */
8240 XSETFRAME (frame
, f
);
8241 XSETFASTINT (position
, pos
);
8244 if (pos
< region_beg
&& region_beg
< endpos
)
8245 endpos
= region_beg
;
8247 /* Get the `face' or `mouse_face' text property at POS, and
8248 determine the next position at which the property changes. */
8249 prop
= Fget_text_property (position
, propname
, w
->buffer
);
8250 XSETFASTINT (limit1
, (limit
< endpos
? limit
: endpos
));
8251 end
= Fnext_single_property_change (position
, propname
, w
->buffer
, limit1
);
8253 endpos
= XINT (end
);
8257 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
8259 /* Optimize common cases where we can use the default face. */
8261 && !(pos
>= region_beg
&& pos
< region_end
))
8262 return DEFAULT_FACE_ID
;
8264 /* Begin with attributes from the default face. */
8265 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
8267 /* Merge in attributes specified via text properties. */
8269 merge_face_ref (f
, prop
, attrs
, 1, 0);
8271 /* If in the region, merge in the region face. */
8272 if (pos
>= region_beg
&& pos
< region_end
)
8274 merge_named_face (f
, Qregion
, attrs
, 0);
8276 if (region_end
< endpos
)
8277 endpos
= region_end
;
8282 /* Look up a realized face with the given face attributes,
8283 or realize a new one for ASCII characters. */
8284 return lookup_face (f
, attrs
);
8288 /* Compute the face at character position POS in Lisp string STRING on
8289 window W, for ASCII characters.
8291 If STRING is an overlay string, it comes from position BUFPOS in
8292 current_buffer, otherwise BUFPOS is zero to indicate that STRING is
8293 not an overlay string. W must display the current buffer.
8294 REGION_BEG and REGION_END give the start and end positions of the
8295 region; both are -1 if no region is visible.
8297 BASE_FACE_ID is the id of a face to merge with. For strings coming
8298 from overlays or the `display' property it is the face at BUFPOS.
8300 If MOUSE_P is non-zero, use the character's mouse-face, not its face.
8302 Set *ENDPTR to the next position where to check for faces in
8303 STRING; -1 if the face is constant from POS to the end of the
8306 Value is the id of the face to use. The face returned is suitable
8307 for displaying ASCII characters. */
8310 face_at_string_position (w
, string
, pos
, bufpos
, region_beg
,
8311 region_end
, endptr
, base_face_id
, mouse_p
)
8315 int region_beg
, region_end
;
8317 enum face_id base_face_id
;
8320 Lisp_Object prop
, position
, end
, limit
;
8321 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
8322 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
8323 struct face
*base_face
;
8324 int multibyte_p
= STRING_MULTIBYTE (string
);
8325 Lisp_Object prop_name
= mouse_p
? Qmouse_face
: Qface
;
8327 /* Get the value of the face property at the current position within
8328 STRING. Value is nil if there is no face property. */
8329 XSETFASTINT (position
, pos
);
8330 prop
= Fget_text_property (position
, prop_name
, string
);
8332 /* Get the next position at which to check for faces. Value of end
8333 is nil if face is constant all the way to the end of the string.
8334 Otherwise it is a string position where to check faces next.
8335 Limit is the maximum position up to which to check for property
8336 changes in Fnext_single_property_change. Strings are usually
8337 short, so set the limit to the end of the string. */
8338 XSETFASTINT (limit
, SCHARS (string
));
8339 end
= Fnext_single_property_change (position
, prop_name
, string
, limit
);
8341 *endptr
= XFASTINT (end
);
8345 base_face
= FACE_FROM_ID (f
, base_face_id
);
8346 xassert (base_face
);
8348 /* Optimize the default case that there is no face property and we
8349 are not in the region. */
8351 && (base_face_id
!= DEFAULT_FACE_ID
8352 /* BUFPOS <= 0 means STRING is not an overlay string, so
8353 that the region doesn't have to be taken into account. */
8355 || bufpos
< region_beg
8356 || bufpos
>= region_end
)
8358 /* We can't realize faces for different charsets differently
8359 if we don't have fonts, so we can stop here if not working
8360 on a window-system frame. */
8361 || !FRAME_WINDOW_P (f
)
8362 || FACE_SUITABLE_FOR_CHAR_P (base_face
, 0)))
8363 return base_face
->id
;
8365 /* Begin with attributes from the base face. */
8366 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
8368 /* Merge in attributes specified via text properties. */
8370 merge_face_ref (f
, prop
, attrs
, 1, 0);
8372 /* If in the region, merge in the region face. */
8374 && bufpos
>= region_beg
8375 && bufpos
< region_end
)
8376 merge_named_face (f
, Qregion
, attrs
, 0);
8378 /* Look up a realized face with the given face attributes,
8379 or realize a new one for ASCII characters. */
8380 return lookup_face (f
, attrs
);
8384 /* Merge a face into a realized face.
8386 F is frame where faces are (to be) realized.
8388 FACE_NAME is named face to merge.
8390 If FACE_NAME is nil, FACE_ID is face_id of realized face to merge.
8392 If FACE_NAME is t, FACE_ID is lface_id of face to merge.
8394 BASE_FACE_ID is realized face to merge into.
8400 merge_faces (f
, face_name
, face_id
, base_face_id
)
8402 Lisp_Object face_name
;
8403 int face_id
, base_face_id
;
8405 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
8406 struct face
*base_face
;
8408 base_face
= FACE_FROM_ID (f
, base_face_id
);
8410 return base_face_id
;
8412 if (EQ (face_name
, Qt
))
8414 if (face_id
< 0 || face_id
>= lface_id_to_name_size
)
8415 return base_face_id
;
8416 face_name
= lface_id_to_name
[face_id
];
8417 face_id
= lookup_derived_face (f
, face_name
, base_face_id
, 1);
8420 return base_face_id
;
8423 /* Begin with attributes from the base face. */
8424 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
8426 if (!NILP (face_name
))
8428 if (!merge_named_face (f
, face_name
, attrs
, 0))
8429 return base_face_id
;
8435 return base_face_id
;
8436 face
= FACE_FROM_ID (f
, face_id
);
8438 return base_face_id
;
8439 merge_face_vectors (f
, face
->lface
, attrs
, 0);
8442 /* Look up a realized face with the given face attributes,
8443 or realize a new one for ASCII characters. */
8444 return lookup_face (f
, attrs
);
8448 /***********************************************************************
8450 ***********************************************************************/
8454 /* Print the contents of the realized face FACE to stderr. */
8457 dump_realized_face (face
)
8460 fprintf (stderr
, "ID: %d\n", face
->id
);
8461 #ifdef HAVE_X_WINDOWS
8462 fprintf (stderr
, "gc: %ld\n", (long) face
->gc
);
8464 fprintf (stderr
, "foreground: 0x%lx (%s)\n",
8466 SDATA (face
->lface
[LFACE_FOREGROUND_INDEX
]));
8467 fprintf (stderr
, "background: 0x%lx (%s)\n",
8469 SDATA (face
->lface
[LFACE_BACKGROUND_INDEX
]));
8470 fprintf (stderr
, "font_name: %s (%s)\n",
8472 SDATA (face
->lface
[LFACE_FAMILY_INDEX
]));
8473 #ifdef HAVE_X_WINDOWS
8474 fprintf (stderr
, "font = %p\n", face
->font
);
8476 fprintf (stderr
, "font_info_id = %d\n", face
->font_info_id
);
8477 fprintf (stderr
, "fontset: %d\n", face
->fontset
);
8478 fprintf (stderr
, "underline: %d (%s)\n",
8480 SDATA (Fsymbol_name (face
->lface
[LFACE_UNDERLINE_INDEX
])));
8481 fprintf (stderr
, "hash: %d\n", face
->hash
);
8485 DEFUN ("dump-face", Fdump_face
, Sdump_face
, 0, 1, 0, doc
: /* */)
8493 fprintf (stderr
, "font selection order: ");
8494 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
8495 fprintf (stderr
, "%d ", font_sort_order
[i
]);
8496 fprintf (stderr
, "\n");
8498 fprintf (stderr
, "alternative fonts: ");
8499 debug_print (Vface_alternative_font_family_alist
);
8500 fprintf (stderr
, "\n");
8502 for (i
= 0; i
< FRAME_FACE_CACHE (SELECTED_FRAME ())->used
; ++i
)
8503 Fdump_face (make_number (i
));
8509 face
= FACE_FROM_ID (SELECTED_FRAME (), XINT (n
));
8511 error ("Not a valid face");
8512 dump_realized_face (face
);
8519 DEFUN ("show-face-resources", Fshow_face_resources
, Sshow_face_resources
,
8520 0, 0, 0, doc
: /* */)
8523 fprintf (stderr
, "number of colors = %d\n", ncolors_allocated
);
8524 fprintf (stderr
, "number of pixmaps = %d\n", npixmaps_allocated
);
8525 fprintf (stderr
, "number of GCs = %d\n", ngcs
);
8529 #endif /* GLYPH_DEBUG != 0 */
8533 /***********************************************************************
8535 ***********************************************************************/
8540 Qface
= intern ("face");
8542 Qface_no_inherit
= intern ("face-no-inherit");
8543 staticpro (&Qface_no_inherit
);
8544 Qbitmap_spec_p
= intern ("bitmap-spec-p");
8545 staticpro (&Qbitmap_spec_p
);
8546 Qframe_set_background_mode
= intern ("frame-set-background-mode");
8547 staticpro (&Qframe_set_background_mode
);
8549 /* Lisp face attribute keywords. */
8550 QCfamily
= intern (":family");
8551 staticpro (&QCfamily
);
8552 QCheight
= intern (":height");
8553 staticpro (&QCheight
);
8554 QCweight
= intern (":weight");
8555 staticpro (&QCweight
);
8556 QCslant
= intern (":slant");
8557 staticpro (&QCslant
);
8558 QCunderline
= intern (":underline");
8559 staticpro (&QCunderline
);
8560 QCinverse_video
= intern (":inverse-video");
8561 staticpro (&QCinverse_video
);
8562 QCreverse_video
= intern (":reverse-video");
8563 staticpro (&QCreverse_video
);
8564 QCforeground
= intern (":foreground");
8565 staticpro (&QCforeground
);
8566 QCbackground
= intern (":background");
8567 staticpro (&QCbackground
);
8568 QCstipple
= intern (":stipple");
8569 staticpro (&QCstipple
);
8570 QCwidth
= intern (":width");
8571 staticpro (&QCwidth
);
8572 QCfont
= intern (":font");
8573 staticpro (&QCfont
);
8574 QCfontset
= intern (":fontset");
8575 staticpro (&QCfontset
);
8576 QCbold
= intern (":bold");
8577 staticpro (&QCbold
);
8578 QCitalic
= intern (":italic");
8579 staticpro (&QCitalic
);
8580 QCoverline
= intern (":overline");
8581 staticpro (&QCoverline
);
8582 QCstrike_through
= intern (":strike-through");
8583 staticpro (&QCstrike_through
);
8584 QCbox
= intern (":box");
8586 QCinherit
= intern (":inherit");
8587 staticpro (&QCinherit
);
8589 /* Symbols used for Lisp face attribute values. */
8590 QCcolor
= intern (":color");
8591 staticpro (&QCcolor
);
8592 QCline_width
= intern (":line-width");
8593 staticpro (&QCline_width
);
8594 QCstyle
= intern (":style");
8595 staticpro (&QCstyle
);
8596 Qreleased_button
= intern ("released-button");
8597 staticpro (&Qreleased_button
);
8598 Qpressed_button
= intern ("pressed-button");
8599 staticpro (&Qpressed_button
);
8600 Qnormal
= intern ("normal");
8601 staticpro (&Qnormal
);
8602 Qultra_light
= intern ("ultra-light");
8603 staticpro (&Qultra_light
);
8604 Qextra_light
= intern ("extra-light");
8605 staticpro (&Qextra_light
);
8606 Qlight
= intern ("light");
8607 staticpro (&Qlight
);
8608 Qsemi_light
= intern ("semi-light");
8609 staticpro (&Qsemi_light
);
8610 Qsemi_bold
= intern ("semi-bold");
8611 staticpro (&Qsemi_bold
);
8612 Qbold
= intern ("bold");
8614 Qextra_bold
= intern ("extra-bold");
8615 staticpro (&Qextra_bold
);
8616 Qultra_bold
= intern ("ultra-bold");
8617 staticpro (&Qultra_bold
);
8618 Qoblique
= intern ("oblique");
8619 staticpro (&Qoblique
);
8620 Qitalic
= intern ("italic");
8621 staticpro (&Qitalic
);
8622 Qreverse_oblique
= intern ("reverse-oblique");
8623 staticpro (&Qreverse_oblique
);
8624 Qreverse_italic
= intern ("reverse-italic");
8625 staticpro (&Qreverse_italic
);
8626 Qultra_condensed
= intern ("ultra-condensed");
8627 staticpro (&Qultra_condensed
);
8628 Qextra_condensed
= intern ("extra-condensed");
8629 staticpro (&Qextra_condensed
);
8630 Qcondensed
= intern ("condensed");
8631 staticpro (&Qcondensed
);
8632 Qsemi_condensed
= intern ("semi-condensed");
8633 staticpro (&Qsemi_condensed
);
8634 Qsemi_expanded
= intern ("semi-expanded");
8635 staticpro (&Qsemi_expanded
);
8636 Qexpanded
= intern ("expanded");
8637 staticpro (&Qexpanded
);
8638 Qextra_expanded
= intern ("extra-expanded");
8639 staticpro (&Qextra_expanded
);
8640 Qultra_expanded
= intern ("ultra-expanded");
8641 staticpro (&Qultra_expanded
);
8642 Qbackground_color
= intern ("background-color");
8643 staticpro (&Qbackground_color
);
8644 Qforeground_color
= intern ("foreground-color");
8645 staticpro (&Qforeground_color
);
8646 Qunspecified
= intern ("unspecified");
8647 staticpro (&Qunspecified
);
8648 Qignore_defface
= intern (":ignore-defface");
8649 staticpro (&Qignore_defface
);
8651 Qface_alias
= intern ("face-alias");
8652 staticpro (&Qface_alias
);
8653 Qdefault
= intern ("default");
8654 staticpro (&Qdefault
);
8655 Qtool_bar
= intern ("tool-bar");
8656 staticpro (&Qtool_bar
);
8657 Qregion
= intern ("region");
8658 staticpro (&Qregion
);
8659 Qfringe
= intern ("fringe");
8660 staticpro (&Qfringe
);
8661 Qheader_line
= intern ("header-line");
8662 staticpro (&Qheader_line
);
8663 Qscroll_bar
= intern ("scroll-bar");
8664 staticpro (&Qscroll_bar
);
8665 Qmenu
= intern ("menu");
8667 Qcursor
= intern ("cursor");
8668 staticpro (&Qcursor
);
8669 Qborder
= intern ("border");
8670 staticpro (&Qborder
);
8671 Qmouse
= intern ("mouse");
8672 staticpro (&Qmouse
);
8673 Qmode_line_inactive
= intern ("mode-line-inactive");
8674 staticpro (&Qmode_line_inactive
);
8675 Qvertical_border
= intern ("vertical-border");
8676 staticpro (&Qvertical_border
);
8677 Qtty_color_desc
= intern ("tty-color-desc");
8678 staticpro (&Qtty_color_desc
);
8679 Qtty_color_standard_values
= intern ("tty-color-standard-values");
8680 staticpro (&Qtty_color_standard_values
);
8681 Qtty_color_by_index
= intern ("tty-color-by-index");
8682 staticpro (&Qtty_color_by_index
);
8683 Qtty_color_alist
= intern ("tty-color-alist");
8684 staticpro (&Qtty_color_alist
);
8685 Qscalable_fonts_allowed
= intern ("scalable-fonts-allowed");
8686 staticpro (&Qscalable_fonts_allowed
);
8688 Vparam_value_alist
= Fcons (Fcons (Qnil
, Qnil
), Qnil
);
8689 staticpro (&Vparam_value_alist
);
8690 Vface_alternative_font_family_alist
= Qnil
;
8691 staticpro (&Vface_alternative_font_family_alist
);
8692 Vface_alternative_font_registry_alist
= Qnil
;
8693 staticpro (&Vface_alternative_font_registry_alist
);
8695 defsubr (&Sinternal_make_lisp_face
);
8696 defsubr (&Sinternal_lisp_face_p
);
8697 defsubr (&Sinternal_set_lisp_face_attribute
);
8698 #ifdef HAVE_WINDOW_SYSTEM
8699 defsubr (&Sinternal_set_lisp_face_attribute_from_resource
);
8701 defsubr (&Scolor_gray_p
);
8702 defsubr (&Scolor_supported_p
);
8703 defsubr (&Sface_attribute_relative_p
);
8704 defsubr (&Smerge_face_attribute
);
8705 defsubr (&Sinternal_get_lisp_face_attribute
);
8706 defsubr (&Sinternal_lisp_face_attribute_values
);
8707 defsubr (&Sinternal_lisp_face_equal_p
);
8708 defsubr (&Sinternal_lisp_face_empty_p
);
8709 defsubr (&Sinternal_copy_lisp_face
);
8710 defsubr (&Sinternal_merge_in_global_face
);
8711 defsubr (&Sface_font
);
8712 defsubr (&Sframe_face_alist
);
8713 defsubr (&Sdisplay_supports_face_attributes_p
);
8714 defsubr (&Scolor_distance
);
8715 defsubr (&Sinternal_set_font_selection_order
);
8716 defsubr (&Sinternal_set_alternative_font_family_alist
);
8717 defsubr (&Sinternal_set_alternative_font_registry_alist
);
8718 defsubr (&Sface_attributes_as_vector
);
8720 defsubr (&Sdump_face
);
8721 defsubr (&Sshow_face_resources
);
8722 #endif /* GLYPH_DEBUG */
8723 defsubr (&Sclear_face_cache
);
8724 defsubr (&Stty_suppress_bold_inverse_default_colors
);
8726 #if defined DEBUG_X_COLORS && defined HAVE_X_WINDOWS
8727 defsubr (&Sdump_colors
);
8730 DEFVAR_LISP ("font-list-limit", &Vfont_list_limit
,
8731 doc
: /* *Limit for font matching.
8732 If an integer > 0, font matching functions won't load more than
8733 that number of fonts when searching for a matching font. */);
8734 Vfont_list_limit
= make_number (DEFAULT_FONT_LIST_LIMIT
);
8736 DEFVAR_LISP ("face-new-frame-defaults", &Vface_new_frame_defaults
,
8737 doc
: /* List of global face definitions (for internal use only.) */);
8738 Vface_new_frame_defaults
= Qnil
;
8740 DEFVAR_LISP ("face-default-stipple", &Vface_default_stipple
,
8741 doc
: /* *Default stipple pattern used on monochrome displays.
8742 This stipple pattern is used on monochrome displays
8743 instead of shades of gray for a face background color.
8744 See `set-face-stipple' for possible values for this variable. */);
8745 Vface_default_stipple
= build_string ("gray3");
8747 DEFVAR_LISP ("tty-defined-color-alist", &Vtty_defined_color_alist
,
8748 doc
: /* An alist of defined terminal colors and their RGB values. */);
8749 Vtty_defined_color_alist
= Qnil
;
8751 DEFVAR_LISP ("scalable-fonts-allowed", &Vscalable_fonts_allowed
,
8752 doc
: /* Allowed scalable fonts.
8753 A value of nil means don't allow any scalable fonts.
8754 A value of t means allow any scalable font.
8755 Otherwise, value must be a list of regular expressions. A font may be
8756 scaled if its name matches a regular expression in the list.
8757 Note that if value is nil, a scalable font might still be used, if no
8758 other font of the appropriate family and registry is available. */);
8759 Vscalable_fonts_allowed
= Qnil
;
8761 DEFVAR_LISP ("face-ignored-fonts", &Vface_ignored_fonts
,
8762 doc
: /* List of ignored fonts.
8763 Each element is a regular expression that matches names of fonts to
8765 Vface_ignored_fonts
= Qnil
;
8767 DEFVAR_LISP ("face-font-rescale-alist", &Vface_font_rescale_alist
,
8768 doc
: /* Alist of fonts vs the rescaling factors.
8769 Each element is a cons (FONT-NAME-PATTERN . RESCALE-RATIO), where
8770 FONT-NAME-PATTERN is a regular expression matching a font name, and
8771 RESCALE-RATIO is a floating point number to specify how much larger
8772 \(or smaller) font we should use. For instance, if a face requests
8773 a font of 10 point, we actually use a font of 10 * RESCALE-RATIO point. */);
8774 Vface_font_rescale_alist
= Qnil
;
8776 #ifdef HAVE_WINDOW_SYSTEM
8777 defsubr (&Sbitmap_spec_p
);
8778 defsubr (&Sx_list_fonts
);
8779 defsubr (&Sinternal_face_x_get_resource
);
8780 defsubr (&Sx_family_fonts
);
8781 defsubr (&Sx_font_family_list
);
8782 #endif /* HAVE_WINDOW_SYSTEM */
8785 /* arch-tag: 8a0f7598-5517-408d-9ab3-1da6fcd4c749
8786 (do not change this comment) */