1 /* xfaces.c -- "Face" primitives.
2 Copyright (C) 1993, 1994, 1998, 1999, 2000, 2001, 2002, 2003
3 Free Software Foundation.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
22 /* New face implementation by Gerd Moellmann <gerd@gnu.org>. */
26 When using Emacs with X, the display style of characters can be
27 changed by defining `faces'. Each face can specify the following
32 2. Relative proportionate width, aka character set width or set
33 width (swidth), e.g. `semi-compressed'.
35 3. Font height in 1/10pt.
37 4. Font weight, e.g. `bold'.
39 5. Font slant, e.g. `italic'.
45 8. Whether or not characters should be underlined, and in what color.
47 9. Whether or not characters should be displayed in inverse video.
49 10. A background stipple, a bitmap.
51 11. Whether or not characters should be overlined, and in what color.
53 12. Whether or not characters should be strike-through, and in what
56 13. Whether or not a box should be drawn around characters, the box
57 type, and, for simple boxes, in what color.
59 14. Font or fontset pattern, or nil. This is a special attribute.
60 When this attribute is specified, the face uses a font opened by
61 that pattern as is. In addition, all the other font-related
62 attributes (1st thru 5th) are generated from the opened font name.
63 On the other hand, if one of the other font-related attributes are
64 specified, this attribute is set to nil. In that case, the face
65 doesn't inherit this attribute from the `default' face, and uses a
66 font determined by the other attributes (those may be inherited
67 from the `default' face).
69 15. A face name or list of face names from which to inherit attributes.
71 16. A specified average font width, which is invisible from Lisp,
72 and is used to ensure that a font specified on the command line,
73 for example, can be matched exactly.
75 Faces are frame-local by nature because Emacs allows to define the
76 same named face (face names are symbols) differently for different
77 frames. Each frame has an alist of face definitions for all named
78 faces. The value of a named face in such an alist is a Lisp vector
79 with the symbol `face' in slot 0, and a slot for each of the face
80 attributes mentioned above.
82 There is also a global face alist `Vface_new_frame_defaults'. Face
83 definitions from this list are used to initialize faces of newly
86 A face doesn't have to specify all attributes. Those not specified
87 have a value of `unspecified'. Faces specifying all attributes but
88 the 14th are called `fully-specified'.
93 The display style of a given character in the text is determined by
94 combining several faces. This process is called `face merging'.
95 Any aspect of the display style that isn't specified by overlays or
96 text properties is taken from the `default' face. Since it is made
97 sure that the default face is always fully-specified, face merging
98 always results in a fully-specified face.
103 After all face attributes for a character have been determined by
104 merging faces of that character, that face is `realized'. The
105 realization process maps face attributes to what is physically
106 available on the system where Emacs runs. The result is a
107 `realized face' in form of a struct face which is stored in the
108 face cache of the frame on which it was realized.
110 Face realization is done in the context of the character to display
111 because different fonts may be used for different characters. In
112 other words, for characters that have different font
113 specifications, different realized faces are needed to display
116 Font specification is done by fontsets. See the comment in
117 fontset.c for the details. In the current implementation, all ASCII
118 characters share the same font in a fontset.
120 Faces are at first realized for ASCII characters, and, at that
121 time, assigned a specific realized fontset. Hereafter, we call
122 such a face as `ASCII face'. When a face for a multibyte character
123 is realized, it inherits (thus shares) a fontset of an ASCII face
124 that has the same attributes other than font-related ones.
126 Thus, all realized face have a realized fontset.
131 Unibyte text (i.e. raw 8-bit characters) is displayed with the same
132 font as ASCII characters. That is because it is expected that
133 unibyte text users specify a font that is suitable both for ASCII
134 and raw 8-bit characters.
139 Font selection tries to find the best available matching font for a
140 given (character, face) combination.
142 If the face specifies a fontset name, that fontset determines a
143 pattern for fonts of the given character. If the face specifies a
144 font name or the other font-related attributes, a fontset is
145 realized from the default fontset. In that case, that
146 specification determines a pattern for ASCII characters and the
147 default fontset determines a pattern for multibyte characters.
149 Available fonts on the system on which Emacs runs are then matched
150 against the font pattern. The result of font selection is the best
151 match for the given face attributes in this font list.
153 Font selection can be influenced by the user.
155 1. The user can specify the relative importance he gives the face
156 attributes width, height, weight, and slant by setting
157 face-font-selection-order (faces.el) to a list of face attribute
158 names. The default is '(:width :height :weight :slant), and means
159 that font selection first tries to find a good match for the font
160 width specified by a face, then---within fonts with that
161 width---tries to find a best match for the specified font height,
164 2. Setting face-font-family-alternatives allows the user to
165 specify alternative font families to try if a family specified by a
168 3. Setting face-font-registry-alternatives allows the user to
169 specify all alternative font registries to try for a face
170 specifying a registry.
172 4. Setting face-ignored-fonts allows the user to ignore specific
176 Character composition.
178 Usually, the realization process is already finished when Emacs
179 actually reflects the desired glyph matrix on the screen. However,
180 on displaying a composition (sequence of characters to be composed
181 on the screen), a suitable font for the components of the
182 composition is selected and realized while drawing them on the
183 screen, i.e. the realization process is delayed but in principle
187 Initialization of basic faces.
189 The faces `default', `modeline' are considered `basic faces'.
190 When redisplay happens the first time for a newly created frame,
191 basic faces are realized for CHARSET_ASCII. Frame parameters are
192 used to fill in unspecified attributes of the default face. */
195 #include <sys/types.h>
196 #include <sys/stat.h>
197 #include <stdio.h> /* This needs to be before termchar.h */
201 #include "keyboard.h"
203 #include "termhooks.h"
205 #ifdef HAVE_WINDOW_SYSTEM
207 #endif /* HAVE_WINDOW_SYSTEM */
209 #ifdef HAVE_X_WINDOWS
213 #include <Xm/XmStrDefs.h>
214 #endif /* USE_MOTIF */
215 #endif /* HAVE_X_WINDOWS */
224 /* Redefine X specifics to W32 equivalents to avoid cluttering the
225 code with #ifdef blocks. */
226 #undef FRAME_X_DISPLAY_INFO
227 #define FRAME_X_DISPLAY_INFO FRAME_W32_DISPLAY_INFO
228 #define x_display_info w32_display_info
229 #define FRAME_X_FONT_TABLE FRAME_W32_FONT_TABLE
230 #define check_x check_w32
231 #define x_list_fonts w32_list_fonts
232 #define GCGraphicsExposures 0
233 #endif /* WINDOWSNT */
237 #define x_display_info mac_display_info
238 #define check_x check_mac
242 #include "dispextern.h"
243 #include "blockinput.h"
245 #include "intervals.h"
246 #include "termchar.h"
248 #ifdef HAVE_X_WINDOWS
250 /* Compensate for a bug in Xos.h on some systems, on which it requires
251 time.h. On some such systems, Xos.h tries to redefine struct
252 timeval and struct timezone if USG is #defined while it is
255 #ifdef XOS_NEEDS_TIME_H
261 #else /* not XOS_NEEDS_TIME_H */
263 #endif /* not XOS_NEEDS_TIME_H */
265 #endif /* HAVE_X_WINDOWS */
269 #define abs(X) ((X) < 0 ? -(X) : (X))
271 /* Number of pt per inch (from the TeXbook). */
273 #define PT_PER_INCH 72.27
275 /* Non-zero if face attribute ATTR is unspecified. */
277 #define UNSPECIFIEDP(ATTR) EQ ((ATTR), Qunspecified)
279 /* Value is the number of elements of VECTOR. */
281 #define DIM(VECTOR) (sizeof (VECTOR) / sizeof *(VECTOR))
283 /* Make a copy of string S on the stack using alloca. Value is a pointer
286 #define STRDUPA(S) strcpy ((char *) alloca (strlen ((S)) + 1), (S))
288 /* Make a copy of the contents of Lisp string S on the stack using
289 alloca. Value is a pointer to the copy. */
291 #define LSTRDUPA(S) STRDUPA (SDATA ((S)))
293 /* Size of hash table of realized faces in face caches (should be a
296 #define FACE_CACHE_BUCKETS_SIZE 1001
298 /* Keyword symbols used for face attribute names. */
300 Lisp_Object QCfamily
, QCheight
, QCweight
, QCslant
, QCunderline
;
301 Lisp_Object QCinverse_video
, QCforeground
, QCbackground
, QCstipple
;
302 Lisp_Object QCwidth
, QCfont
, QCbold
, QCitalic
;
303 Lisp_Object QCreverse_video
;
304 Lisp_Object QCoverline
, QCstrike_through
, QCbox
, QCinherit
;
306 /* Symbols used for attribute values. */
308 Lisp_Object Qnormal
, Qbold
, Qultra_light
, Qextra_light
, Qlight
;
309 Lisp_Object Qsemi_light
, Qsemi_bold
, Qextra_bold
, Qultra_bold
;
310 Lisp_Object Qoblique
, Qitalic
, Qreverse_oblique
, Qreverse_italic
;
311 Lisp_Object Qultra_condensed
, Qextra_condensed
, Qcondensed
;
312 Lisp_Object Qsemi_condensed
, Qsemi_expanded
, Qexpanded
, Qextra_expanded
;
313 Lisp_Object Qultra_expanded
;
314 Lisp_Object Qreleased_button
, Qpressed_button
;
315 Lisp_Object QCstyle
, QCcolor
, QCline_width
;
316 Lisp_Object Qunspecified
;
318 char unspecified_fg
[] = "unspecified-fg", unspecified_bg
[] = "unspecified-bg";
320 /* The name of the function to call when the background of the frame
321 has changed, frame_update_face_colors. */
323 Lisp_Object Qframe_update_face_colors
;
325 /* Names of basic faces. */
327 Lisp_Object Qdefault
, Qtool_bar
, Qregion
, Qfringe
;
328 Lisp_Object Qheader_line
, Qscroll_bar
, Qcursor
, Qborder
, Qmouse
, Qmenu
;
329 Lisp_Object Qmode_line_inactive
;
330 extern Lisp_Object Qmode_line
;
332 /* The symbol `face-alias'. A symbols having that property is an
333 alias for another face. Value of the property is the name of
336 Lisp_Object Qface_alias
;
338 /* Default stipple pattern used on monochrome displays. This stipple
339 pattern is used on monochrome displays instead of shades of gray
340 for a face background color. See `set-face-stipple' for possible
341 values for this variable. */
343 Lisp_Object Vface_default_stipple
;
345 /* Alist of alternative font families. Each element is of the form
346 (FAMILY FAMILY1 FAMILY2 ...). If fonts of FAMILY can't be loaded,
347 try FAMILY1, then FAMILY2, ... */
349 Lisp_Object Vface_alternative_font_family_alist
;
351 /* Alist of alternative font registries. Each element is of the form
352 (REGISTRY REGISTRY1 REGISTRY2...). If fonts of REGISTRY can't be
353 loaded, try REGISTRY1, then REGISTRY2, ... */
355 Lisp_Object Vface_alternative_font_registry_alist
;
357 /* Allowed scalable fonts. A value of nil means don't allow any
358 scalable fonts. A value of t means allow the use of any scalable
359 font. Otherwise, value must be a list of regular expressions. A
360 font may be scaled if its name matches a regular expression in the
363 Lisp_Object Vscalable_fonts_allowed
, Qscalable_fonts_allowed
;
365 /* List of regular expressions that matches names of fonts to ignore. */
367 Lisp_Object Vface_ignored_fonts
;
369 /* Alist of font name patterns vs the rescaling factor. */
371 Lisp_Object Vface_font_rescale_alist
;
373 /* Maximum number of fonts to consider in font_list. If not an
374 integer > 0, DEFAULT_FONT_LIST_LIMIT is used instead. */
376 Lisp_Object Vfont_list_limit
;
377 #define DEFAULT_FONT_LIST_LIMIT 100
379 /* The symbols `foreground-color' and `background-color' which can be
380 used as part of a `face' property. This is for compatibility with
383 Lisp_Object Qforeground_color
, Qbackground_color
;
385 /* The symbols `face' and `mouse-face' used as text properties. */
388 extern Lisp_Object Qmouse_face
;
390 /* Error symbol for wrong_type_argument in load_pixmap. */
392 Lisp_Object Qbitmap_spec_p
;
394 /* Alist of global face definitions. Each element is of the form
395 (FACE . LFACE) where FACE is a symbol naming a face and LFACE
396 is a Lisp vector of face attributes. These faces are used
397 to initialize faces for new frames. */
399 Lisp_Object Vface_new_frame_defaults
;
401 /* The next ID to assign to Lisp faces. */
403 static int next_lface_id
;
405 /* A vector mapping Lisp face Id's to face names. */
407 static Lisp_Object
*lface_id_to_name
;
408 static int lface_id_to_name_size
;
410 /* TTY color-related functions (defined in tty-colors.el). */
412 Lisp_Object Qtty_color_desc
, Qtty_color_by_index
, Qtty_color_standard_values
;
414 /* The name of the function used to compute colors on TTYs. */
416 Lisp_Object Qtty_color_alist
;
418 /* An alist of defined terminal colors and their RGB values. */
420 Lisp_Object Vtty_defined_color_alist
;
422 /* Counter for calls to clear_face_cache. If this counter reaches
423 CLEAR_FONT_TABLE_COUNT, and a frame has more than
424 CLEAR_FONT_TABLE_NFONTS load, unused fonts are freed. */
426 static int clear_font_table_count
;
427 #define CLEAR_FONT_TABLE_COUNT 100
428 #define CLEAR_FONT_TABLE_NFONTS 10
430 /* Non-zero means face attributes have been changed since the last
431 redisplay. Used in redisplay_internal. */
433 int face_change_count
;
435 /* Non-zero means don't display bold text if a face's foreground
436 and background colors are the inverse of the default colors of the
437 display. This is a kluge to suppress `bold black' foreground text
438 which is hard to read on an LCD monitor. */
440 int tty_suppress_bold_inverse_default_colors_p
;
442 /* A list of the form `((x . y))' used to avoid consing in
443 Finternal_set_lisp_face_attribute. */
445 static Lisp_Object Vparam_value_alist
;
447 /* The total number of colors currently allocated. */
450 static int ncolors_allocated
;
451 static int npixmaps_allocated
;
455 /* Non-zero means the definition of the `menu' face for new frames has
458 int menu_face_changed_default
;
461 /* Function prototypes. */
466 static void map_tty_color
P_ ((struct frame
*, struct face
*,
467 enum lface_attribute_index
, int *));
468 static Lisp_Object resolve_face_name
P_ ((Lisp_Object
));
469 static int may_use_scalable_font_p
P_ ((const char *));
470 static void set_font_frame_param
P_ ((Lisp_Object
, Lisp_Object
));
471 static int better_font_p
P_ ((int *, struct font_name
*, struct font_name
*,
473 static int x_face_list_fonts
P_ ((struct frame
*, char *,
474 struct font_name
**, int, int));
475 static int font_scalable_p
P_ ((struct font_name
*));
476 static int get_lface_attributes
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
*, int));
477 static int load_pixmap
P_ ((struct frame
*, Lisp_Object
, unsigned *, unsigned *));
478 static unsigned char *xstrlwr
P_ ((unsigned char *));
479 static void signal_error
P_ ((char *, Lisp_Object
));
480 static struct frame
*frame_or_selected_frame
P_ ((Lisp_Object
, int));
481 static void load_face_font
P_ ((struct frame
*, struct face
*, int));
482 static void load_face_colors
P_ ((struct frame
*, struct face
*, Lisp_Object
*));
483 static void free_face_colors
P_ ((struct frame
*, struct face
*));
484 static int face_color_gray_p
P_ ((struct frame
*, char *));
485 static char *build_font_name
P_ ((struct font_name
*));
486 static void free_font_names
P_ ((struct font_name
*, int));
487 static int sorted_font_list
P_ ((struct frame
*, char *,
488 int (*cmpfn
) P_ ((const void *, const void *)),
489 struct font_name
**));
490 static int font_list_1
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
491 Lisp_Object
, struct font_name
**));
492 static int font_list
P_ ((struct frame
*, Lisp_Object
, Lisp_Object
,
493 Lisp_Object
, struct font_name
**));
494 static int try_font_list
P_ ((struct frame
*, Lisp_Object
*,
495 Lisp_Object
, Lisp_Object
, struct font_name
**,
497 static int try_alternative_families
P_ ((struct frame
*f
, Lisp_Object
,
498 Lisp_Object
, struct font_name
**));
499 static int cmp_font_names
P_ ((const void *, const void *));
500 static struct face
*realize_face
P_ ((struct face_cache
*, Lisp_Object
*, int,
501 struct face
*, int));
502 static struct face
*realize_x_face
P_ ((struct face_cache
*,
503 Lisp_Object
*, int, struct face
*));
504 static struct face
*realize_tty_face
P_ ((struct face_cache
*,
505 Lisp_Object
*, int));
506 static int realize_basic_faces
P_ ((struct frame
*));
507 static int realize_default_face
P_ ((struct frame
*));
508 static void realize_named_face
P_ ((struct frame
*, Lisp_Object
, int));
509 static int lface_fully_specified_p
P_ ((Lisp_Object
*));
510 static int lface_equal_p
P_ ((Lisp_Object
*, Lisp_Object
*));
511 static unsigned hash_string_case_insensitive
P_ ((Lisp_Object
));
512 static unsigned lface_hash
P_ ((Lisp_Object
*));
513 static int lface_same_font_attributes_p
P_ ((Lisp_Object
*, Lisp_Object
*));
514 static struct face_cache
*make_face_cache
P_ ((struct frame
*));
515 static void free_realized_face
P_ ((struct frame
*, struct face
*));
516 static void clear_face_gcs
P_ ((struct face_cache
*));
517 static void free_face_cache
P_ ((struct face_cache
*));
518 static int face_numeric_weight
P_ ((Lisp_Object
));
519 static int face_numeric_slant
P_ ((Lisp_Object
));
520 static int face_numeric_swidth
P_ ((Lisp_Object
));
521 static int face_fontset
P_ ((Lisp_Object
*));
522 static char *choose_face_font
P_ ((struct frame
*, Lisp_Object
*, int, int, int*));
523 static void merge_face_vectors
P_ ((struct frame
*, Lisp_Object
*, Lisp_Object
*, Lisp_Object
));
524 static void merge_face_inheritance
P_ ((struct frame
*f
, Lisp_Object
,
525 Lisp_Object
*, Lisp_Object
));
526 static void merge_face_vector_with_property
P_ ((struct frame
*, Lisp_Object
*,
528 static int set_lface_from_font_name
P_ ((struct frame
*, Lisp_Object
,
529 Lisp_Object
, int, int));
530 static Lisp_Object lface_from_face_name
P_ ((struct frame
*, Lisp_Object
, int));
531 static struct face
*make_realized_face
P_ ((Lisp_Object
*));
532 static void free_realized_faces
P_ ((struct face_cache
*));
533 static char *best_matching_font
P_ ((struct frame
*, Lisp_Object
*,
534 struct font_name
*, int, int, int *));
535 static void cache_face
P_ ((struct face_cache
*, struct face
*, unsigned));
536 static void uncache_face
P_ ((struct face_cache
*, struct face
*));
537 static int xlfd_numeric_slant
P_ ((struct font_name
*));
538 static int xlfd_numeric_weight
P_ ((struct font_name
*));
539 static int xlfd_numeric_swidth
P_ ((struct font_name
*));
540 static Lisp_Object xlfd_symbolic_slant
P_ ((struct font_name
*));
541 static Lisp_Object xlfd_symbolic_weight
P_ ((struct font_name
*));
542 static Lisp_Object xlfd_symbolic_swidth
P_ ((struct font_name
*));
543 static int xlfd_fixed_p
P_ ((struct font_name
*));
544 static int xlfd_numeric_value
P_ ((struct table_entry
*, int, struct font_name
*,
546 static Lisp_Object xlfd_symbolic_value
P_ ((struct table_entry
*, int,
547 struct font_name
*, int,
549 static struct table_entry
*xlfd_lookup_field_contents
P_ ((struct table_entry
*, int,
550 struct font_name
*, int));
552 #ifdef HAVE_WINDOW_SYSTEM
554 static int split_font_name
P_ ((struct frame
*, struct font_name
*, int));
555 static int xlfd_point_size
P_ ((struct frame
*, struct font_name
*));
556 static void sort_fonts
P_ ((struct frame
*, struct font_name
*, int,
557 int (*cmpfn
) P_ ((const void *, const void *))));
558 static GC x_create_gc
P_ ((struct frame
*, unsigned long, XGCValues
*));
559 static void x_free_gc
P_ ((struct frame
*, GC
));
560 static void clear_font_table
P_ ((struct x_display_info
*));
563 extern Lisp_Object w32_list_fonts
P_ ((struct frame
*, Lisp_Object
, int, int));
564 #endif /* WINDOWSNT */
567 static void x_update_menu_appearance
P_ ((struct frame
*));
569 extern void free_frame_menubar
P_ ((struct frame
*));
570 #endif /* USE_X_TOOLKIT */
572 #endif /* HAVE_WINDOW_SYSTEM */
575 /***********************************************************************
577 ***********************************************************************/
579 #ifdef HAVE_X_WINDOWS
581 #ifdef DEBUG_X_COLORS
583 /* The following is a poor mans infrastructure for debugging X color
584 allocation problems on displays with PseudoColor-8. Some X servers
585 like 3.3.5 XF86_SVGA with Matrox cards apparently don't implement
586 color reference counts completely so that they don't signal an
587 error when a color is freed whose reference count is already 0.
588 Other X servers do. To help me debug this, the following code
589 implements a simple reference counting schema of its own, for a
590 single display/screen. --gerd. */
592 /* Reference counts for pixel colors. */
594 int color_count
[256];
596 /* Register color PIXEL as allocated. */
599 register_color (pixel
)
602 xassert (pixel
< 256);
603 ++color_count
[pixel
];
607 /* Register color PIXEL as deallocated. */
610 unregister_color (pixel
)
613 xassert (pixel
< 256);
614 if (color_count
[pixel
] > 0)
615 --color_count
[pixel
];
621 /* Register N colors from PIXELS as deallocated. */
624 unregister_colors (pixels
, n
)
625 unsigned long *pixels
;
629 for (i
= 0; i
< n
; ++i
)
630 unregister_color (pixels
[i
]);
634 DEFUN ("dump-colors", Fdump_colors
, Sdump_colors
, 0, 0, 0,
635 doc
: /* Dump currently allocated colors to stderr. */)
640 fputc ('\n', stderr
);
642 for (i
= n
= 0; i
< sizeof color_count
/ sizeof color_count
[0]; ++i
)
645 fprintf (stderr
, "%3d: %5d", i
, color_count
[i
]);
648 fputc ('\n', stderr
);
650 fputc ('\t', stderr
);
654 fputc ('\n', stderr
);
658 #endif /* DEBUG_X_COLORS */
661 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
662 color values. Interrupt input must be blocked when this function
666 x_free_colors (f
, pixels
, npixels
)
668 unsigned long *pixels
;
671 int class = FRAME_X_DISPLAY_INFO (f
)->visual
->class;
673 /* If display has an immutable color map, freeing colors is not
674 necessary and some servers don't allow it. So don't do it. */
675 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
677 #ifdef DEBUG_X_COLORS
678 unregister_colors (pixels
, npixels
);
680 XFreeColors (FRAME_X_DISPLAY (f
), FRAME_X_COLORMAP (f
),
686 /* Free colors used on frame F. PIXELS is an array of NPIXELS pixel
687 color values. Interrupt input must be blocked when this function
691 x_free_dpy_colors (dpy
, screen
, cmap
, pixels
, npixels
)
695 unsigned long *pixels
;
698 struct x_display_info
*dpyinfo
= x_display_info_for_display (dpy
);
699 int class = dpyinfo
->visual
->class;
701 /* If display has an immutable color map, freeing colors is not
702 necessary and some servers don't allow it. So don't do it. */
703 if (class != StaticColor
&& class != StaticGray
&& class != TrueColor
)
705 #ifdef DEBUG_X_COLORS
706 unregister_colors (pixels
, npixels
);
708 XFreeColors (dpy
, cmap
, pixels
, npixels
, 0);
713 /* Create and return a GC for use on frame F. GC values and mask
714 are given by XGCV and MASK. */
717 x_create_gc (f
, mask
, xgcv
)
724 gc
= XCreateGC (FRAME_X_DISPLAY (f
), FRAME_X_WINDOW (f
), mask
, xgcv
);
731 /* Free GC which was used on frame F. */
739 xassert (--ngcs
>= 0);
740 XFreeGC (FRAME_X_DISPLAY (f
), gc
);
744 #endif /* HAVE_X_WINDOWS */
747 /* W32 emulation of GCs */
750 x_create_gc (f
, mask
, xgcv
)
757 gc
= XCreateGC (NULL
, FRAME_W32_WINDOW (f
), mask
, xgcv
);
764 /* Free GC which was used on frame F. */
772 xassert (--ngcs
>= 0);
777 #endif /* WINDOWSNT */
780 /* Mac OS emulation of GCs */
782 extern XGCValues
*XCreateGC (void *, Window
, unsigned long, XGCValues
*);
785 x_create_gc (f
, mask
, xgcv
)
791 gc
= XCreateGC (FRAME_MAC_DISPLAY (f
), FRAME_MAC_WINDOW (f
), mask
, xgcv
);
800 XFreeGC (FRAME_MAC_DISPLAY (f
), gc
);
805 /* Like stricmp. Used to compare parts of font names which are in
810 const unsigned char *s1
, *s2
;
814 unsigned char c1
= tolower (*s1
);
815 unsigned char c2
= tolower (*s2
);
817 return c1
< c2
? -1 : 1;
822 return *s2
== 0 ? 0 : -1;
827 /* Like strlwr, which might not always be available. */
829 static unsigned char *
833 unsigned char *p
= s
;
842 /* Signal `error' with message S, and additional argument ARG. */
845 signal_error (s
, arg
)
849 Fsignal (Qerror
, Fcons (build_string (s
), Fcons (arg
, Qnil
)));
853 /* If FRAME is nil, return a pointer to the selected frame.
854 Otherwise, check that FRAME is a live frame, and return a pointer
855 to it. NPARAM is the parameter number of FRAME, for
856 CHECK_LIVE_FRAME. This is here because it's a frequent pattern in
857 Lisp function definitions. */
859 static INLINE
struct frame
*
860 frame_or_selected_frame (frame
, nparam
)
865 frame
= selected_frame
;
867 CHECK_LIVE_FRAME (frame
);
868 return XFRAME (frame
);
872 /***********************************************************************
874 ***********************************************************************/
876 /* Initialize face cache and basic faces for frame F. */
882 /* Make a face cache, if F doesn't have one. */
883 if (FRAME_FACE_CACHE (f
) == NULL
)
884 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
886 #ifdef HAVE_WINDOW_SYSTEM
887 /* Make the image cache. */
888 if (FRAME_WINDOW_P (f
))
890 if (FRAME_X_IMAGE_CACHE (f
) == NULL
)
891 FRAME_X_IMAGE_CACHE (f
) = make_image_cache ();
892 ++FRAME_X_IMAGE_CACHE (f
)->refcount
;
894 #endif /* HAVE_WINDOW_SYSTEM */
896 /* Realize basic faces. Must have enough information in frame
897 parameters to realize basic faces at this point. */
898 #ifdef HAVE_X_WINDOWS
899 if (!FRAME_X_P (f
) || FRAME_X_WINDOW (f
))
902 if (!FRAME_WINDOW_P (f
) || FRAME_W32_WINDOW (f
))
905 if (!FRAME_MAC_P (f
) || FRAME_MAC_WINDOW (f
))
907 if (!realize_basic_faces (f
))
912 /* Free face cache of frame F. Called from Fdelete_frame. */
918 struct face_cache
*face_cache
= FRAME_FACE_CACHE (f
);
922 free_face_cache (face_cache
);
923 FRAME_FACE_CACHE (f
) = NULL
;
926 #ifdef HAVE_WINDOW_SYSTEM
927 if (FRAME_WINDOW_P (f
))
929 struct image_cache
*image_cache
= FRAME_X_IMAGE_CACHE (f
);
932 --image_cache
->refcount
;
933 if (image_cache
->refcount
== 0)
934 free_image_cache (f
);
937 #endif /* HAVE_WINDOW_SYSTEM */
941 /* Clear face caches, and recompute basic faces for frame F. Call
942 this after changing frame parameters on which those faces depend,
943 or when realized faces have been freed due to changing attributes
947 recompute_basic_faces (f
)
950 if (FRAME_FACE_CACHE (f
))
952 clear_face_cache (0);
953 if (!realize_basic_faces (f
))
959 /* Clear the face caches of all frames. CLEAR_FONTS_P non-zero means
960 try to free unused fonts, too. */
963 clear_face_cache (clear_fonts_p
)
966 #ifdef HAVE_WINDOW_SYSTEM
967 Lisp_Object tail
, frame
;
971 || ++clear_font_table_count
== CLEAR_FONT_TABLE_COUNT
)
973 struct x_display_info
*dpyinfo
;
975 /* Fonts are common for frames on one display, i.e. on
977 for (dpyinfo
= x_display_list
; dpyinfo
; dpyinfo
= dpyinfo
->next
)
978 if (dpyinfo
->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
979 clear_font_table (dpyinfo
);
981 /* From time to time see if we can unload some fonts. This also
982 frees all realized faces on all frames. Fonts needed by
983 faces will be loaded again when faces are realized again. */
984 clear_font_table_count
= 0;
986 FOR_EACH_FRAME (tail
, frame
)
988 struct frame
*f
= XFRAME (frame
);
989 if (FRAME_WINDOW_P (f
)
990 && FRAME_X_DISPLAY_INFO (f
)->n_fonts
> CLEAR_FONT_TABLE_NFONTS
)
991 free_all_realized_faces (frame
);
996 /* Clear GCs of realized faces. */
997 FOR_EACH_FRAME (tail
, frame
)
1000 if (FRAME_WINDOW_P (f
))
1002 clear_face_gcs (FRAME_FACE_CACHE (f
));
1003 clear_image_cache (f
, 0);
1007 #endif /* HAVE_WINDOW_SYSTEM */
1011 DEFUN ("clear-face-cache", Fclear_face_cache
, Sclear_face_cache
, 0, 1, 0,
1012 doc
: /* Clear face caches on all frames.
1013 Optional THOROUGHLY non-nil means try to free unused fonts, too. */)
1015 Lisp_Object thoroughly
;
1017 clear_face_cache (!NILP (thoroughly
));
1018 ++face_change_count
;
1019 ++windows_or_buffers_changed
;
1025 #ifdef HAVE_WINDOW_SYSTEM
1028 /* Remove fonts from the font table of DPYINFO except for the default
1029 ASCII fonts of frames on that display. Called from clear_face_cache
1030 from time to time. */
1033 clear_font_table (dpyinfo
)
1034 struct x_display_info
*dpyinfo
;
1038 /* Free those fonts that are not used by frames on DPYINFO. */
1039 for (i
= 0; i
< dpyinfo
->n_fonts
; ++i
)
1041 struct font_info
*font_info
= dpyinfo
->font_table
+ i
;
1042 Lisp_Object tail
, frame
;
1044 /* Check if slot is already free. */
1045 if (font_info
->name
== NULL
)
1048 /* Don't free a default font of some frame. */
1049 FOR_EACH_FRAME (tail
, frame
)
1051 struct frame
*f
= XFRAME (frame
);
1052 if (FRAME_WINDOW_P (f
)
1053 && font_info
->font
== FRAME_FONT (f
))
1061 if (font_info
->full_name
!= font_info
->name
)
1062 xfree (font_info
->full_name
);
1063 xfree (font_info
->name
);
1065 /* Free the font. */
1067 #ifdef HAVE_X_WINDOWS
1068 XFreeFont (dpyinfo
->display
, font_info
->font
);
1071 w32_unload_font (dpyinfo
, font_info
->font
);
1075 /* Mark font table slot free. */
1076 font_info
->font
= NULL
;
1077 font_info
->name
= font_info
->full_name
= NULL
;
1081 #endif /* HAVE_WINDOW_SYSTEM */
1085 /***********************************************************************
1087 ***********************************************************************/
1089 #ifdef HAVE_WINDOW_SYSTEM
1091 DEFUN ("bitmap-spec-p", Fbitmap_spec_p
, Sbitmap_spec_p
, 1, 1, 0,
1092 doc
: /* Value is non-nil if OBJECT is a valid bitmap specification.
1093 A bitmap specification is either a string, a file name, or a list
1094 \(WIDTH HEIGHT DATA) where WIDTH is the pixel width of the bitmap,
1095 HEIGHT is its height, and DATA is a string containing the bits of
1096 the pixmap. Bits are stored row by row, each row occupies
1097 \(WIDTH + 7)/8 bytes. */)
1103 if (STRINGP (object
))
1104 /* If OBJECT is a string, it's a file name. */
1106 else if (CONSP (object
))
1108 /* Otherwise OBJECT must be (WIDTH HEIGHT DATA), WIDTH and
1109 HEIGHT must be integers > 0, and DATA must be string large
1110 enough to hold a bitmap of the specified size. */
1111 Lisp_Object width
, height
, data
;
1113 height
= width
= data
= Qnil
;
1117 width
= XCAR (object
);
1118 object
= XCDR (object
);
1121 height
= XCAR (object
);
1122 object
= XCDR (object
);
1124 data
= XCAR (object
);
1128 if (NATNUMP (width
) && NATNUMP (height
) && STRINGP (data
))
1130 int bytes_per_row
= ((XFASTINT (width
) + BITS_PER_CHAR
- 1)
1132 if (SBYTES (data
) >= bytes_per_row
* XINT (height
))
1137 return pixmap_p
? Qt
: Qnil
;
1141 /* Load a bitmap according to NAME (which is either a file name or a
1142 pixmap spec) for use on frame F. Value is the bitmap_id (see
1143 xfns.c). If NAME is nil, return with a bitmap id of zero. If
1144 bitmap cannot be loaded, display a message saying so, and return
1145 zero. Store the bitmap width in *W_PTR and its height in *H_PTR,
1146 if these pointers are not null. */
1149 load_pixmap (f
, name
, w_ptr
, h_ptr
)
1152 unsigned int *w_ptr
, *h_ptr
;
1160 tem
= Fbitmap_spec_p (name
);
1162 wrong_type_argument (Qbitmap_spec_p
, name
);
1167 /* Decode a bitmap spec into a bitmap. */
1172 w
= XINT (Fcar (name
));
1173 h
= XINT (Fcar (Fcdr (name
)));
1174 bits
= Fcar (Fcdr (Fcdr (name
)));
1176 bitmap_id
= x_create_bitmap_from_data (f
, SDATA (bits
),
1181 /* It must be a string -- a file name. */
1182 bitmap_id
= x_create_bitmap_from_file (f
, name
);
1188 add_to_log ("Invalid or undefined bitmap %s", name
, Qnil
);
1199 ++npixmaps_allocated
;
1202 *w_ptr
= x_bitmap_width (f
, bitmap_id
);
1205 *h_ptr
= x_bitmap_height (f
, bitmap_id
);
1211 #endif /* HAVE_WINDOW_SYSTEM */
1215 /***********************************************************************
1217 ***********************************************************************/
1219 #ifdef HAVE_WINDOW_SYSTEM
1221 /* Load font of face FACE which is used on frame F to display
1222 character C. The name of the font to load is determined by lface
1223 and fontset of FACE. */
1226 load_face_font (f
, face
, c
)
1231 struct font_info
*font_info
= NULL
;
1233 int needs_overstrike
;
1235 face
->font_info_id
= -1;
1238 font_name
= choose_face_font (f
, face
->lface
, face
->fontset
, c
,
1244 font_info
= FS_LOAD_FACE_FONT (f
, c
, font_name
, face
);
1249 face
->font_info_id
= font_info
->font_idx
;
1250 face
->font
= font_info
->font
;
1251 face
->font_name
= font_info
->full_name
;
1252 face
->overstrike
= needs_overstrike
;
1255 x_free_gc (f
, face
->gc
);
1260 add_to_log ("Unable to load font %s",
1261 build_string (font_name
), Qnil
);
1265 #endif /* HAVE_WINDOW_SYSTEM */
1269 /***********************************************************************
1271 ***********************************************************************/
1273 /* Parse RGB_LIST, and fill in the RGB fields of COLOR.
1274 RGB_LIST should contain (at least) 3 lisp integers.
1275 Return 0 if there's a problem with RGB_LIST, otherwise return 1. */
1278 parse_rgb_list (rgb_list
, color
)
1279 Lisp_Object rgb_list
;
1282 #define PARSE_RGB_LIST_FIELD(field) \
1283 if (CONSP (rgb_list) && INTEGERP (XCAR (rgb_list))) \
1285 color->field = XINT (XCAR (rgb_list)); \
1286 rgb_list = XCDR (rgb_list); \
1291 PARSE_RGB_LIST_FIELD (red
);
1292 PARSE_RGB_LIST_FIELD (green
);
1293 PARSE_RGB_LIST_FIELD (blue
);
1299 /* Lookup on frame F the color described by the lisp string COLOR.
1300 The resulting tty color is returned in TTY_COLOR; if STD_COLOR is
1301 non-zero, then the `standard' definition of the same color is
1305 tty_lookup_color (f
, color
, tty_color
, std_color
)
1308 XColor
*tty_color
, *std_color
;
1310 Lisp_Object frame
, color_desc
;
1312 if (!STRINGP (color
) || NILP (Ffboundp (Qtty_color_desc
)))
1315 XSETFRAME (frame
, f
);
1317 color_desc
= call2 (Qtty_color_desc
, color
, frame
);
1318 if (CONSP (color_desc
) && CONSP (XCDR (color_desc
)))
1322 if (! INTEGERP (XCAR (XCDR (color_desc
))))
1325 tty_color
->pixel
= XINT (XCAR (XCDR (color_desc
)));
1327 rgb
= XCDR (XCDR (color_desc
));
1328 if (! parse_rgb_list (rgb
, tty_color
))
1331 /* Should we fill in STD_COLOR too? */
1334 /* Default STD_COLOR to the same as TTY_COLOR. */
1335 *std_color
= *tty_color
;
1337 /* Do a quick check to see if the returned descriptor is
1338 actually _exactly_ equal to COLOR, otherwise we have to
1339 lookup STD_COLOR separately. If it's impossible to lookup
1340 a standard color, we just give up and use TTY_COLOR. */
1341 if ((!STRINGP (XCAR (color_desc
))
1342 || NILP (Fstring_equal (color
, XCAR (color_desc
))))
1343 && !NILP (Ffboundp (Qtty_color_standard_values
)))
1345 /* Look up STD_COLOR separately. */
1346 rgb
= call1 (Qtty_color_standard_values
, color
);
1347 if (! parse_rgb_list (rgb
, std_color
))
1354 else if (NILP (Fsymbol_value (intern ("tty-defined-color-alist"))))
1355 /* We were called early during startup, and the colors are not
1356 yet set up in tty-defined-color-alist. Don't return a failure
1357 indication, since this produces the annoying "Unable to
1358 load color" messages in the *Messages* buffer. */
1361 /* tty-color-desc seems to have returned a bad value. */
1365 /* A version of defined_color for non-X frames. */
1368 tty_defined_color (f
, color_name
, color_def
, alloc
)
1377 color_def
->pixel
= FACE_TTY_DEFAULT_COLOR
;
1379 color_def
->blue
= 0;
1380 color_def
->green
= 0;
1383 status
= tty_lookup_color (f
, build_string (color_name
), color_def
, 0);
1385 if (color_def
->pixel
== FACE_TTY_DEFAULT_COLOR
&& *color_name
)
1387 if (strcmp (color_name
, "unspecified-fg") == 0)
1388 color_def
->pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
1389 else if (strcmp (color_name
, "unspecified-bg") == 0)
1390 color_def
->pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
1393 if (color_def
->pixel
!= FACE_TTY_DEFAULT_COLOR
)
1400 /* Decide if color named COLOR_NAME is valid for the display
1401 associated with the frame F; if so, return the rgb values in
1402 COLOR_DEF. If ALLOC is nonzero, allocate a new colormap cell.
1404 This does the right thing for any type of frame. */
1407 defined_color (f
, color_name
, color_def
, alloc
)
1413 if (!FRAME_WINDOW_P (f
))
1414 return tty_defined_color (f
, color_name
, color_def
, alloc
);
1415 #ifdef HAVE_X_WINDOWS
1416 else if (FRAME_X_P (f
))
1417 return x_defined_color (f
, color_name
, color_def
, alloc
);
1420 else if (FRAME_W32_P (f
))
1421 return w32_defined_color (f
, color_name
, color_def
, alloc
);
1424 else if (FRAME_MAC_P (f
))
1425 return mac_defined_color (f
, color_name
, color_def
, alloc
);
1432 /* Given the index IDX of a tty color on frame F, return its name, a
1436 tty_color_name (f
, idx
)
1440 if (idx
>= 0 && !NILP (Ffboundp (Qtty_color_by_index
)))
1443 Lisp_Object coldesc
;
1445 XSETFRAME (frame
, f
);
1446 coldesc
= call2 (Qtty_color_by_index
, make_number (idx
), frame
);
1448 if (!NILP (coldesc
))
1449 return XCAR (coldesc
);
1452 /* We can have an MSDOG frame under -nw for a short window of
1453 opportunity before internal_terminal_init is called. DTRT. */
1454 if (FRAME_MSDOS_P (f
) && !inhibit_window_system
)
1455 return msdos_stdcolor_name (idx
);
1458 if (idx
== FACE_TTY_DEFAULT_FG_COLOR
)
1459 return build_string (unspecified_fg
);
1460 if (idx
== FACE_TTY_DEFAULT_BG_COLOR
)
1461 return build_string (unspecified_bg
);
1464 return vga_stdcolor_name (idx
);
1467 return Qunspecified
;
1471 /* Return non-zero if COLOR_NAME is a shade of gray (or white or
1472 black) on frame F. The algorithm is taken from 20.2 faces.el. */
1475 face_color_gray_p (f
, color_name
)
1482 if (defined_color (f
, color_name
, &color
, 0))
1483 gray_p
= ((abs (color
.red
- color
.green
)
1484 < max (color
.red
, color
.green
) / 20)
1485 && (abs (color
.green
- color
.blue
)
1486 < max (color
.green
, color
.blue
) / 20)
1487 && (abs (color
.blue
- color
.red
)
1488 < max (color
.blue
, color
.red
) / 20));
1496 /* Return non-zero if color COLOR_NAME can be displayed on frame F.
1497 BACKGROUND_P non-zero means the color will be used as background
1501 face_color_supported_p (f
, color_name
, background_p
)
1509 XSETFRAME (frame
, f
);
1510 return (FRAME_WINDOW_P (f
)
1511 ? (!NILP (Fxw_display_color_p (frame
))
1512 || xstricmp (color_name
, "black") == 0
1513 || xstricmp (color_name
, "white") == 0
1515 && face_color_gray_p (f
, color_name
))
1516 || (!NILP (Fx_display_grayscale_p (frame
))
1517 && face_color_gray_p (f
, color_name
)))
1518 : tty_defined_color (f
, color_name
, ¬_used
, 0));
1522 DEFUN ("color-gray-p", Fcolor_gray_p
, Scolor_gray_p
, 1, 2, 0,
1523 doc
: /* Return non-nil if COLOR is a shade of gray (or white or black).
1524 FRAME specifies the frame and thus the display for interpreting COLOR.
1525 If FRAME is nil or omitted, use the selected frame. */)
1527 Lisp_Object color
, frame
;
1531 CHECK_STRING (color
);
1533 frame
= selected_frame
;
1535 CHECK_FRAME (frame
);
1537 return face_color_gray_p (f
, SDATA (color
)) ? Qt
: Qnil
;
1541 DEFUN ("color-supported-p", Fcolor_supported_p
,
1542 Scolor_supported_p
, 1, 3, 0,
1543 doc
: /* Return non-nil if COLOR can be displayed on FRAME.
1544 BACKGROUND-P non-nil means COLOR is used as a background.
1545 If FRAME is nil or omitted, use the selected frame.
1546 COLOR must be a valid color name. */)
1547 (color
, frame
, background_p
)
1548 Lisp_Object frame
, color
, background_p
;
1552 CHECK_STRING (color
);
1554 frame
= selected_frame
;
1556 CHECK_FRAME (frame
);
1558 if (face_color_supported_p (f
, SDATA (color
), !NILP (background_p
)))
1564 /* Load color with name NAME for use by face FACE on frame F.
1565 TARGET_INDEX must be one of LFACE_FOREGROUND_INDEX,
1566 LFACE_BACKGROUND_INDEX, LFACE_UNDERLINE_INDEX, LFACE_OVERLINE_INDEX,
1567 LFACE_STRIKE_THROUGH_INDEX, or LFACE_BOX_INDEX. Value is the
1568 pixel color. If color cannot be loaded, display a message, and
1569 return the foreground, background or underline color of F, but
1570 record that fact in flags of the face so that we don't try to free
1574 load_color (f
, face
, name
, target_index
)
1578 enum lface_attribute_index target_index
;
1582 xassert (STRINGP (name
));
1583 xassert (target_index
== LFACE_FOREGROUND_INDEX
1584 || target_index
== LFACE_BACKGROUND_INDEX
1585 || target_index
== LFACE_UNDERLINE_INDEX
1586 || target_index
== LFACE_OVERLINE_INDEX
1587 || target_index
== LFACE_STRIKE_THROUGH_INDEX
1588 || target_index
== LFACE_BOX_INDEX
);
1590 /* if the color map is full, defined_color will return a best match
1591 to the values in an existing cell. */
1592 if (!defined_color (f
, SDATA (name
), &color
, 1))
1594 add_to_log ("Unable to load color \"%s\"", name
, Qnil
);
1596 switch (target_index
)
1598 case LFACE_FOREGROUND_INDEX
:
1599 face
->foreground_defaulted_p
= 1;
1600 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1603 case LFACE_BACKGROUND_INDEX
:
1604 face
->background_defaulted_p
= 1;
1605 color
.pixel
= FRAME_BACKGROUND_PIXEL (f
);
1608 case LFACE_UNDERLINE_INDEX
:
1609 face
->underline_defaulted_p
= 1;
1610 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1613 case LFACE_OVERLINE_INDEX
:
1614 face
->overline_color_defaulted_p
= 1;
1615 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1618 case LFACE_STRIKE_THROUGH_INDEX
:
1619 face
->strike_through_color_defaulted_p
= 1;
1620 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1623 case LFACE_BOX_INDEX
:
1624 face
->box_color_defaulted_p
= 1;
1625 color
.pixel
= FRAME_FOREGROUND_PIXEL (f
);
1634 ++ncolors_allocated
;
1641 #ifdef HAVE_WINDOW_SYSTEM
1643 /* Load colors for face FACE which is used on frame F. Colors are
1644 specified by slots LFACE_BACKGROUND_INDEX and LFACE_FOREGROUND_INDEX
1645 of ATTRS. If the background color specified is not supported on F,
1646 try to emulate gray colors with a stipple from Vface_default_stipple. */
1649 load_face_colors (f
, face
, attrs
)
1656 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
1657 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
1659 /* Swap colors if face is inverse-video. */
1660 if (EQ (attrs
[LFACE_INVERSE_INDEX
], Qt
))
1668 /* Check for support for foreground, not for background because
1669 face_color_supported_p is smart enough to know that grays are
1670 "supported" as background because we are supposed to use stipple
1672 if (!face_color_supported_p (f
, SDATA (bg
), 0)
1673 && !NILP (Fbitmap_spec_p (Vface_default_stipple
)))
1675 x_destroy_bitmap (f
, face
->stipple
);
1676 face
->stipple
= load_pixmap (f
, Vface_default_stipple
,
1677 &face
->pixmap_w
, &face
->pixmap_h
);
1680 face
->background
= load_color (f
, face
, bg
, LFACE_BACKGROUND_INDEX
);
1681 face
->foreground
= load_color (f
, face
, fg
, LFACE_FOREGROUND_INDEX
);
1685 /* Free color PIXEL on frame F. */
1688 unload_color (f
, pixel
)
1690 unsigned long pixel
;
1692 #ifdef HAVE_X_WINDOWS
1696 x_free_colors (f
, &pixel
, 1);
1703 /* Free colors allocated for FACE. */
1706 free_face_colors (f
, face
)
1710 #ifdef HAVE_X_WINDOWS
1711 if (face
->colors_copied_bitwise_p
)
1716 if (!face
->foreground_defaulted_p
)
1718 x_free_colors (f
, &face
->foreground
, 1);
1719 IF_DEBUG (--ncolors_allocated
);
1722 if (!face
->background_defaulted_p
)
1724 x_free_colors (f
, &face
->background
, 1);
1725 IF_DEBUG (--ncolors_allocated
);
1728 if (face
->underline_p
1729 && !face
->underline_defaulted_p
)
1731 x_free_colors (f
, &face
->underline_color
, 1);
1732 IF_DEBUG (--ncolors_allocated
);
1735 if (face
->overline_p
1736 && !face
->overline_color_defaulted_p
)
1738 x_free_colors (f
, &face
->overline_color
, 1);
1739 IF_DEBUG (--ncolors_allocated
);
1742 if (face
->strike_through_p
1743 && !face
->strike_through_color_defaulted_p
)
1745 x_free_colors (f
, &face
->strike_through_color
, 1);
1746 IF_DEBUG (--ncolors_allocated
);
1749 if (face
->box
!= FACE_NO_BOX
1750 && !face
->box_color_defaulted_p
)
1752 x_free_colors (f
, &face
->box_color
, 1);
1753 IF_DEBUG (--ncolors_allocated
);
1757 #endif /* HAVE_X_WINDOWS */
1760 #endif /* HAVE_WINDOW_SYSTEM */
1764 /***********************************************************************
1766 ***********************************************************************/
1768 /* An enumerator for each field of an XLFD font name. */
1789 /* An enumerator for each possible slant value of a font. Taken from
1790 the XLFD specification. */
1798 XLFD_SLANT_REVERSE_ITALIC
,
1799 XLFD_SLANT_REVERSE_OBLIQUE
,
1803 /* Relative font weight according to XLFD documentation. */
1807 XLFD_WEIGHT_UNKNOWN
,
1808 XLFD_WEIGHT_ULTRA_LIGHT
, /* 10 */
1809 XLFD_WEIGHT_EXTRA_LIGHT
, /* 20 */
1810 XLFD_WEIGHT_LIGHT
, /* 30 */
1811 XLFD_WEIGHT_SEMI_LIGHT
, /* 40: SemiLight, Book, ... */
1812 XLFD_WEIGHT_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1813 XLFD_WEIGHT_SEMI_BOLD
, /* 60: SemiBold, DemiBold, ... */
1814 XLFD_WEIGHT_BOLD
, /* 70: Bold, ... */
1815 XLFD_WEIGHT_EXTRA_BOLD
, /* 80: ExtraBold, Heavy, ... */
1816 XLFD_WEIGHT_ULTRA_BOLD
/* 90: UltraBold, Black, ... */
1819 /* Relative proportionate width. */
1823 XLFD_SWIDTH_UNKNOWN
,
1824 XLFD_SWIDTH_ULTRA_CONDENSED
, /* 10 */
1825 XLFD_SWIDTH_EXTRA_CONDENSED
, /* 20 */
1826 XLFD_SWIDTH_CONDENSED
, /* 30: Condensed, Narrow, Compressed, ... */
1827 XLFD_SWIDTH_SEMI_CONDENSED
, /* 40: semicondensed */
1828 XLFD_SWIDTH_MEDIUM
, /* 50: Medium, Normal, Regular, ... */
1829 XLFD_SWIDTH_SEMI_EXPANDED
, /* 60: SemiExpanded, DemiExpanded, ... */
1830 XLFD_SWIDTH_EXPANDED
, /* 70: Expanded... */
1831 XLFD_SWIDTH_EXTRA_EXPANDED
, /* 80: ExtraExpanded, Wide... */
1832 XLFD_SWIDTH_ULTRA_EXPANDED
/* 90: UltraExpanded... */
1835 /* Structure used for tables mapping XLFD weight, slant, and width
1836 names to numeric and symbolic values. */
1842 Lisp_Object
*symbol
;
1845 /* Table of XLFD slant names and their numeric and symbolic
1846 representations. This table must be sorted by slant names in
1849 static struct table_entry slant_table
[] =
1851 {"i", XLFD_SLANT_ITALIC
, &Qitalic
},
1852 {"o", XLFD_SLANT_OBLIQUE
, &Qoblique
},
1853 {"ot", XLFD_SLANT_OTHER
, &Qitalic
},
1854 {"r", XLFD_SLANT_ROMAN
, &Qnormal
},
1855 {"ri", XLFD_SLANT_REVERSE_ITALIC
, &Qreverse_italic
},
1856 {"ro", XLFD_SLANT_REVERSE_OBLIQUE
, &Qreverse_oblique
}
1859 /* Table of XLFD weight names. This table must be sorted by weight
1860 names in ascending order. */
1862 static struct table_entry weight_table
[] =
1864 {"black", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
},
1865 {"bold", XLFD_WEIGHT_BOLD
, &Qbold
},
1866 {"book", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1867 {"demi", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1868 {"demibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1869 {"extralight", XLFD_WEIGHT_EXTRA_LIGHT
, &Qextra_light
},
1870 {"extrabold", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1871 {"heavy", XLFD_WEIGHT_EXTRA_BOLD
, &Qextra_bold
},
1872 {"light", XLFD_WEIGHT_LIGHT
, &Qlight
},
1873 {"medium", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1874 {"normal", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1875 {"regular", XLFD_WEIGHT_MEDIUM
, &Qnormal
},
1876 {"semibold", XLFD_WEIGHT_SEMI_BOLD
, &Qsemi_bold
},
1877 {"semilight", XLFD_WEIGHT_SEMI_LIGHT
, &Qsemi_light
},
1878 {"ultralight", XLFD_WEIGHT_ULTRA_LIGHT
, &Qultra_light
},
1879 {"ultrabold", XLFD_WEIGHT_ULTRA_BOLD
, &Qultra_bold
}
1882 /* Table of XLFD width names. This table must be sorted by width
1883 names in ascending order. */
1885 static struct table_entry swidth_table
[] =
1887 {"compressed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1888 {"condensed", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1889 {"demiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1890 {"expanded", XLFD_SWIDTH_EXPANDED
, &Qexpanded
},
1891 {"extracondensed", XLFD_SWIDTH_EXTRA_CONDENSED
, &Qextra_condensed
},
1892 {"extraexpanded", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
},
1893 {"medium", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1894 {"narrow", XLFD_SWIDTH_CONDENSED
, &Qcondensed
},
1895 {"normal", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1896 {"regular", XLFD_SWIDTH_MEDIUM
, &Qnormal
},
1897 {"semicondensed", XLFD_SWIDTH_SEMI_CONDENSED
, &Qsemi_condensed
},
1898 {"semiexpanded", XLFD_SWIDTH_SEMI_EXPANDED
, &Qsemi_expanded
},
1899 {"ultracondensed", XLFD_SWIDTH_ULTRA_CONDENSED
, &Qultra_condensed
},
1900 {"ultraexpanded", XLFD_SWIDTH_ULTRA_EXPANDED
, &Qultra_expanded
},
1901 {"wide", XLFD_SWIDTH_EXTRA_EXPANDED
, &Qextra_expanded
}
1904 /* Structure used to hold the result of splitting font names in XLFD
1905 format into their fields. */
1909 /* The original name which is modified destructively by
1910 split_font_name. The pointer is kept here to be able to free it
1911 if it was allocated from the heap. */
1914 /* Font name fields. Each vector element points into `name' above.
1915 Fields are NUL-terminated. */
1916 char *fields
[XLFD_LAST
];
1918 /* Numeric values for those fields that interest us. See
1919 split_font_name for which these are. */
1920 int numeric
[XLFD_LAST
];
1922 /* If the original name matches one of Vface_font_rescale_alist,
1923 the value is the corresponding rescale ratio. Otherwise, the
1925 double rescale_ratio
;
1927 /* Lower value mean higher priority. */
1928 int registry_priority
;
1931 /* The frame in effect when sorting font names. Set temporarily in
1932 sort_fonts so that it is available in font comparison functions. */
1934 static struct frame
*font_frame
;
1936 /* Order by which font selection chooses fonts. The default values
1937 mean `first, find a best match for the font width, then for the
1938 font height, then for weight, then for slant.' This variable can be
1939 set via set-face-font-sort-order. */
1942 static int font_sort_order
[4] = {
1943 XLFD_SWIDTH
, XLFD_POINT_SIZE
, XLFD_WEIGHT
, XLFD_SLANT
1946 static int font_sort_order
[4];
1949 /* Look up FONT.fields[FIELD_INDEX] in TABLE which has DIM entries.
1950 TABLE must be sorted by TABLE[i]->name in ascending order. Value
1951 is a pointer to the matching table entry or null if no table entry
1954 static struct table_entry
*
1955 xlfd_lookup_field_contents (table
, dim
, font
, field_index
)
1956 struct table_entry
*table
;
1958 struct font_name
*font
;
1961 /* Function split_font_name converts fields to lower-case, so there
1962 is no need to use xstrlwr or xstricmp here. */
1963 char *s
= font
->fields
[field_index
];
1964 int low
, mid
, high
, cmp
;
1971 mid
= (low
+ high
) / 2;
1972 cmp
= strcmp (table
[mid
].name
, s
);
1986 /* Return a numeric representation for font name field
1987 FONT.fields[FIELD_INDEX]. The field is looked up in TABLE which
1988 has DIM entries. Value is the numeric value found or DFLT if no
1989 table entry matches. This function is used to translate weight,
1990 slant, and swidth names of XLFD font names to numeric values. */
1993 xlfd_numeric_value (table
, dim
, font
, field_index
, dflt
)
1994 struct table_entry
*table
;
1996 struct font_name
*font
;
2000 struct table_entry
*p
;
2001 p
= xlfd_lookup_field_contents (table
, dim
, font
, field_index
);
2002 return p
? p
->numeric
: dflt
;
2006 /* Return a symbolic 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 symbolic 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 symbols. */
2012 static INLINE Lisp_Object
2013 xlfd_symbolic_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
->symbol
: dflt
;
2026 /* Return a numeric value for the slant of the font given by FONT. */
2029 xlfd_numeric_slant (font
)
2030 struct font_name
*font
;
2032 return xlfd_numeric_value (slant_table
, DIM (slant_table
),
2033 font
, XLFD_SLANT
, XLFD_SLANT_ROMAN
);
2037 /* Return a symbol representing the weight of the font given by FONT. */
2039 static INLINE Lisp_Object
2040 xlfd_symbolic_slant (font
)
2041 struct font_name
*font
;
2043 return xlfd_symbolic_value (slant_table
, DIM (slant_table
),
2044 font
, XLFD_SLANT
, Qnormal
);
2048 /* Return a numeric value for the weight of the font given by FONT. */
2051 xlfd_numeric_weight (font
)
2052 struct font_name
*font
;
2054 return xlfd_numeric_value (weight_table
, DIM (weight_table
),
2055 font
, XLFD_WEIGHT
, XLFD_WEIGHT_MEDIUM
);
2059 /* Return a symbol representing the slant of the font given by FONT. */
2061 static INLINE Lisp_Object
2062 xlfd_symbolic_weight (font
)
2063 struct font_name
*font
;
2065 return xlfd_symbolic_value (weight_table
, DIM (weight_table
),
2066 font
, XLFD_WEIGHT
, Qnormal
);
2070 /* Return a numeric value for the swidth of the font whose XLFD font
2071 name fields are found in FONT. */
2074 xlfd_numeric_swidth (font
)
2075 struct font_name
*font
;
2077 return xlfd_numeric_value (swidth_table
, DIM (swidth_table
),
2078 font
, XLFD_SWIDTH
, XLFD_SWIDTH_MEDIUM
);
2082 /* Return a symbolic value for the swidth of FONT. */
2084 static INLINE Lisp_Object
2085 xlfd_symbolic_swidth (font
)
2086 struct font_name
*font
;
2088 return xlfd_symbolic_value (swidth_table
, DIM (swidth_table
),
2089 font
, XLFD_SWIDTH
, Qnormal
);
2093 /* Look up the entry of SYMBOL in the vector TABLE which has DIM
2094 entries. Value is a pointer to the matching table entry or null if
2095 no element of TABLE contains SYMBOL. */
2097 static struct table_entry
*
2098 face_value (table
, dim
, symbol
)
2099 struct table_entry
*table
;
2105 xassert (SYMBOLP (symbol
));
2107 for (i
= 0; i
< dim
; ++i
)
2108 if (EQ (*table
[i
].symbol
, symbol
))
2111 return i
< dim
? table
+ i
: NULL
;
2115 /* Return a numeric value for SYMBOL in the vector TABLE which has DIM
2116 entries. Value is -1 if SYMBOL is not found in TABLE. */
2119 face_numeric_value (table
, dim
, symbol
)
2120 struct table_entry
*table
;
2124 struct table_entry
*p
= face_value (table
, dim
, symbol
);
2125 return p
? p
->numeric
: -1;
2129 /* Return a numeric value representing the weight specified by Lisp
2130 symbol WEIGHT. Value is one of the enumerators of enum
2134 face_numeric_weight (weight
)
2137 return face_numeric_value (weight_table
, DIM (weight_table
), weight
);
2141 /* Return a numeric value representing the slant specified by Lisp
2142 symbol SLANT. Value is one of the enumerators of enum xlfd_slant. */
2145 face_numeric_slant (slant
)
2148 return face_numeric_value (slant_table
, DIM (slant_table
), slant
);
2152 /* Return a numeric value representing the swidth specified by Lisp
2153 symbol WIDTH. Value is one of the enumerators of enum xlfd_swidth. */
2156 face_numeric_swidth (width
)
2159 return face_numeric_value (swidth_table
, DIM (swidth_table
), width
);
2163 #ifdef HAVE_WINDOW_SYSTEM
2165 /* Return non-zero if FONT is the name of a fixed-pitch font. */
2169 struct font_name
*font
;
2171 /* Function split_font_name converts fields to lower-case, so there
2172 is no need to use tolower here. */
2173 return *font
->fields
[XLFD_SPACING
] != 'p';
2177 /* Return the point size of FONT on frame F, measured in 1/10 pt.
2179 The actual height of the font when displayed on F depends on the
2180 resolution of both the font and frame. For example, a 10pt font
2181 designed for a 100dpi display will display larger than 10pt on a
2182 75dpi display. (It's not unusual to use fonts not designed for the
2183 display one is using. For example, some intlfonts are available in
2184 72dpi versions, only.)
2186 Value is the real point size of FONT on frame F, or 0 if it cannot
2190 xlfd_point_size (f
, font
)
2192 struct font_name
*font
;
2194 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2195 char *pixel_field
= font
->fields
[XLFD_PIXEL_SIZE
];
2199 if (*pixel_field
== '[')
2201 /* The pixel size field is `[A B C D]' which specifies
2202 a transformation matrix.
2208 by which all glyphs of the font are transformed. The spec
2209 says that s scalar value N for the pixel size is equivalent
2210 to A = N * resx/resy, B = C = 0, D = N. */
2211 char *start
= pixel_field
+ 1, *end
;
2215 for (i
= 0; i
< 4; ++i
)
2217 matrix
[i
] = strtod (start
, &end
);
2224 pixel
= atoi (pixel_field
);
2229 real_pt
= PT_PER_INCH
* 10.0 * pixel
/ resy
+ 0.5;
2235 /* Return point size of PIXEL dots while considering Y-resultion (DPI)
2236 of frame F. This function is used to guess a point size of font
2237 when only the pixel height of the font is available. */
2240 pixel_point_size (f
, pixel
)
2244 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
2248 /* As one inch is PT_PER_INCH points, PT_PER_INCH/RESY gives the
2249 point size of one dot. */
2250 real_pt
= pixel
* PT_PER_INCH
/ resy
;
2251 int_pt
= real_pt
+ 0.5;
2257 /* Return a rescaling ratio of a font of NAME. */
2260 font_rescale_ratio (name
)
2263 Lisp_Object tail
, elt
;
2265 for (tail
= Vface_font_rescale_alist
; CONSP (tail
); tail
= XCDR (tail
))
2268 if (STRINGP (XCAR (elt
)) && FLOATP (XCDR (elt
))
2269 && fast_c_string_match_ignore_case (XCAR (elt
), name
) >= 0)
2270 return XFLOAT_DATA (XCDR (elt
));
2276 /* Split XLFD font name FONT->name destructively into NUL-terminated,
2277 lower-case fields in FONT->fields. NUMERIC_P non-zero means
2278 compute numeric values for fields XLFD_POINT_SIZE, XLFD_SWIDTH,
2279 XLFD_RESY, XLFD_SLANT, and XLFD_WEIGHT in FONT->numeric. Value is
2280 zero if the font name doesn't have the format we expect. The
2281 expected format is a font name that starts with a `-' and has
2282 XLFD_LAST fields separated by `-'. */
2285 split_font_name (f
, font
, numeric_p
)
2287 struct font_name
*font
;
2292 double rescale_ratio
;
2295 /* This must be done before splitting the font name. */
2296 rescale_ratio
= font_rescale_ratio (font
->name
);
2298 if (*font
->name
== '-')
2300 char *p
= xstrlwr (font
->name
) + 1;
2302 while (i
< XLFD_LAST
)
2304 font
->fields
[i
] = p
;
2307 /* Pixel and point size may be of the form `[....]'. For
2308 BNF, see XLFD spec, chapter 4. Negative values are
2309 indicated by tilde characters which we replace with
2310 `-' characters, here. */
2312 && (i
- 1 == XLFD_PIXEL_SIZE
2313 || i
- 1 == XLFD_POINT_SIZE
))
2318 for (++p
; *p
&& *p
!= ']'; ++p
)
2322 /* Check that the matrix contains 4 floating point
2324 for (j
= 0, start
= font
->fields
[i
- 1] + 1;
2327 if (strtod (start
, &end
) == 0 && start
== end
)
2334 while (*p
&& *p
!= '-')
2344 success_p
= i
== XLFD_LAST
;
2346 /* If requested, and font name was in the expected format,
2347 compute numeric values for some fields. */
2348 if (numeric_p
&& success_p
)
2350 font
->numeric
[XLFD_POINT_SIZE
] = xlfd_point_size (f
, font
);
2351 font
->numeric
[XLFD_RESY
] = atoi (font
->fields
[XLFD_RESY
]);
2352 font
->numeric
[XLFD_SLANT
] = xlfd_numeric_slant (font
);
2353 font
->numeric
[XLFD_WEIGHT
] = xlfd_numeric_weight (font
);
2354 font
->numeric
[XLFD_SWIDTH
] = xlfd_numeric_swidth (font
);
2355 font
->numeric
[XLFD_AVGWIDTH
] = atoi (font
->fields
[XLFD_AVGWIDTH
]);
2356 font
->rescale_ratio
= rescale_ratio
;
2359 /* Initialize it to zero. It will be overridden by font_list while
2360 trying alternate registries. */
2361 font
->registry_priority
= 0;
2367 /* Build an XLFD font name from font name fields in FONT. Value is a
2368 pointer to the font name, which is allocated via xmalloc. */
2371 build_font_name (font
)
2372 struct font_name
*font
;
2376 char *font_name
= (char *) xmalloc (size
);
2377 int total_length
= 0;
2379 for (i
= 0; i
< XLFD_LAST
; ++i
)
2381 /* Add 1 because of the leading `-'. */
2382 int len
= strlen (font
->fields
[i
]) + 1;
2384 /* Reallocate font_name if necessary. Add 1 for the final
2386 if (total_length
+ len
+ 1 >= size
)
2388 int new_size
= max (2 * size
, size
+ len
+ 1);
2389 int sz
= new_size
* sizeof *font_name
;
2390 font_name
= (char *) xrealloc (font_name
, sz
);
2394 font_name
[total_length
] = '-';
2395 bcopy (font
->fields
[i
], font_name
+ total_length
+ 1, len
- 1);
2396 total_length
+= len
;
2399 font_name
[total_length
] = 0;
2404 /* Free an array FONTS of N font_name structures. This frees FONTS
2405 itself and all `name' fields in its elements. */
2408 free_font_names (fonts
, n
)
2409 struct font_name
*fonts
;
2413 xfree (fonts
[--n
].name
);
2418 /* Sort vector FONTS of font_name structures which contains NFONTS
2419 elements using qsort and comparison function CMPFN. F is the frame
2420 on which the fonts will be used. The global variable font_frame
2421 is temporarily set to F to make it available in CMPFN. */
2424 sort_fonts (f
, fonts
, nfonts
, cmpfn
)
2426 struct font_name
*fonts
;
2428 int (*cmpfn
) P_ ((const void *, const void *));
2431 qsort (fonts
, nfonts
, sizeof *fonts
, cmpfn
);
2436 /* Get fonts matching PATTERN on frame F. If F is null, use the first
2437 display in x_display_list. FONTS is a pointer to a vector of
2438 NFONTS font_name structures. TRY_ALTERNATIVES_P non-zero means try
2439 alternative patterns from Valternate_fontname_alist if no fonts are
2440 found matching PATTERN.
2442 For all fonts found, set FONTS[i].name to the name of the font,
2443 allocated via xmalloc, and split font names into fields. Ignore
2444 fonts that we can't parse. Value is the number of fonts found. */
2447 x_face_list_fonts (f
, pattern
, pfonts
, nfonts
, try_alternatives_p
)
2450 struct font_name
**pfonts
;
2451 int nfonts
, try_alternatives_p
;
2455 /* NTEMACS_TODO : currently this uses w32_list_fonts, but it may be
2456 better to do it the other way around. */
2458 Lisp_Object lpattern
, tem
;
2459 struct font_name
*fonts
= 0;
2460 int num_fonts
= nfonts
;
2463 lpattern
= build_string (pattern
);
2465 /* Get the list of fonts matching PATTERN. */
2468 lfonts
= w32_list_fonts (f
, lpattern
, 0, nfonts
);
2471 lfonts
= x_list_fonts (f
, lpattern
, -1, nfonts
);
2474 if (nfonts
< 0 && CONSP (lfonts
))
2475 num_fonts
= XFASTINT (Flength (lfonts
));
2477 /* Make a copy of the font names we got from X, and
2478 split them into fields. */
2480 for (tem
= lfonts
; CONSP (tem
) && n
< num_fonts
; tem
= XCDR (tem
))
2482 Lisp_Object elt
, tail
;
2483 const char *name
= SDATA (XCAR (tem
));
2485 /* Ignore fonts matching a pattern from face-ignored-fonts. */
2486 for (tail
= Vface_ignored_fonts
; CONSP (tail
); tail
= XCDR (tail
))
2490 && fast_c_string_match_ignore_case (elt
, name
) >= 0)
2501 *pfonts
= (struct font_name
*) xmalloc (num_fonts
* sizeof **pfonts
);
2505 /* Make a copy of the font name. */
2506 fonts
[n
].name
= xstrdup (name
);
2508 if (split_font_name (f
, fonts
+ n
, 1))
2510 if (font_scalable_p (fonts
+ n
)
2511 && !may_use_scalable_font_p (name
))
2514 xfree (fonts
[n
].name
);
2520 xfree (fonts
[n
].name
);
2523 /* If no fonts found, try patterns from Valternate_fontname_alist. */
2524 if (n
== 0 && try_alternatives_p
)
2526 Lisp_Object list
= Valternate_fontname_alist
;
2534 while (CONSP (list
))
2536 Lisp_Object entry
= XCAR (list
);
2538 && STRINGP (XCAR (entry
))
2539 && strcmp (SDATA (XCAR (entry
)), pattern
) == 0)
2546 Lisp_Object patterns
= XCAR (list
);
2549 while (CONSP (patterns
)
2550 /* If list is screwed up, give up. */
2551 && (name
= XCAR (patterns
),
2553 /* Ignore patterns equal to PATTERN because we tried that
2554 already with no success. */
2555 && (strcmp (SDATA (name
), pattern
) == 0
2556 || (n
= x_face_list_fonts (f
, SDATA (name
),
2559 patterns
= XCDR (patterns
);
2567 /* Check if a font matching pattern_offset_t on frame F is available
2568 or not. PATTERN may be a cons (FAMILY . REGISTRY), in which case,
2569 a font name pattern is generated from FAMILY and REGISTRY. */
2572 face_font_available_p (f
, pattern
)
2574 Lisp_Object pattern
;
2578 if (! STRINGP (pattern
))
2580 Lisp_Object family
, registry
;
2581 char *family_str
, *registry_str
, *pattern_str
;
2583 CHECK_CONS (pattern
);
2584 family
= XCAR (pattern
);
2589 CHECK_STRING (family
);
2590 family_str
= (char *) SDATA (family
);
2592 registry
= XCDR (pattern
);
2593 if (NILP (registry
))
2597 CHECK_STRING (registry
);
2598 registry_str
= (char *) SDATA (registry
);
2601 pattern_str
= (char *) alloca (strlen (family_str
)
2602 + strlen (registry_str
)
2604 strcpy (pattern_str
, index (family_str
, '-') ? "-" : "-*-");
2605 strcat (pattern_str
, family_str
);
2606 strcat (pattern_str
, "-*-");
2607 strcat (pattern_str
, registry_str
);
2608 if (!index (registry_str
, '-'))
2610 if (registry_str
[strlen (registry_str
) - 1] == '*')
2611 strcat (pattern_str
, "-*");
2613 strcat (pattern_str
, "*-*");
2615 pattern
= build_string (pattern_str
);
2618 /* Get the list of fonts matching PATTERN. */
2621 fonts
= w32_list_fonts (f
, pattern
, 0, 1);
2624 fonts
= x_list_fonts (f
, pattern
, -1, 1);
2626 return XINT (Flength (fonts
));
2630 /* Determine fonts matching PATTERN on frame F. Sort resulting fonts
2631 using comparison function CMPFN. Value is the number of fonts
2632 found. If value is non-zero, *FONTS is set to a vector of
2633 font_name structures allocated from the heap containing matching
2634 fonts. Each element of *FONTS contains a name member that is also
2635 allocated from the heap. Font names in these structures are split
2636 into fields. Use free_font_names to free such an array. */
2639 sorted_font_list (f
, pattern
, cmpfn
, fonts
)
2642 int (*cmpfn
) P_ ((const void *, const void *));
2643 struct font_name
**fonts
;
2647 /* Get the list of fonts matching pattern. 100 should suffice. */
2648 nfonts
= DEFAULT_FONT_LIST_LIMIT
;
2649 if (INTEGERP (Vfont_list_limit
))
2650 nfonts
= XINT (Vfont_list_limit
);
2653 nfonts
= x_face_list_fonts (f
, pattern
, fonts
, nfonts
, 1);
2655 /* Sort the resulting array and return it in *FONTS. If no
2656 fonts were found, make sure to set *FONTS to null. */
2658 sort_fonts (f
, *fonts
, nfonts
, cmpfn
);
2669 /* Compare two font_name structures *A and *B. Value is analogous to
2670 strcmp. Sort order is given by the global variable
2671 font_sort_order. Font names are sorted so that, everything else
2672 being equal, fonts with a resolution closer to that of the frame on
2673 which they are used are listed first. The global variable
2674 font_frame is the frame on which we operate. */
2677 cmp_font_names (a
, b
)
2680 struct font_name
*x
= (struct font_name
*) a
;
2681 struct font_name
*y
= (struct font_name
*) b
;
2684 /* All strings have been converted to lower-case by split_font_name,
2685 so we can use strcmp here. */
2686 cmp
= strcmp (x
->fields
[XLFD_FAMILY
], y
->fields
[XLFD_FAMILY
]);
2691 for (i
= 0; i
< DIM (font_sort_order
) && cmp
== 0; ++i
)
2693 int j
= font_sort_order
[i
];
2694 cmp
= x
->numeric
[j
] - y
->numeric
[j
];
2699 /* Everything else being equal, we prefer fonts with an
2700 y-resolution closer to that of the frame. */
2701 int resy
= FRAME_X_DISPLAY_INFO (font_frame
)->resy
;
2702 int x_resy
= x
->numeric
[XLFD_RESY
];
2703 int y_resy
= y
->numeric
[XLFD_RESY
];
2704 cmp
= abs (resy
- x_resy
) - abs (resy
- y_resy
);
2712 /* Get a sorted list of fonts of family FAMILY on frame F. If PATTERN
2713 is non-nil list fonts matching that pattern. Otherwise, if
2714 REGISTRY is non-nil return only fonts with that registry, otherwise
2715 return fonts of any registry. Set *FONTS to a vector of font_name
2716 structures allocated from the heap containing the fonts found.
2717 Value is the number of fonts found. */
2720 font_list_1 (f
, pattern
, family
, registry
, fonts
)
2722 Lisp_Object pattern
, family
, registry
;
2723 struct font_name
**fonts
;
2725 char *pattern_str
, *family_str
, *registry_str
;
2729 family_str
= (NILP (family
) ? "*" : (char *) SDATA (family
));
2730 registry_str
= (NILP (registry
) ? "*" : (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
, "*-*");
2748 pattern_str
= (char *) SDATA (pattern
);
2750 return sorted_font_list (f
, pattern_str
, cmp_font_names
, fonts
);
2754 /* Concatenate font list FONTS1 and FONTS2. FONTS1 and FONTS2
2755 contains NFONTS1 fonts and NFONTS2 fonts respectively. Return a
2756 pointer to a newly allocated font list. FONTS1 and FONTS2 are
2759 static struct font_name
*
2760 concat_font_list (fonts1
, nfonts1
, fonts2
, nfonts2
)
2761 struct font_name
*fonts1
, *fonts2
;
2762 int nfonts1
, nfonts2
;
2764 int new_nfonts
= nfonts1
+ nfonts2
;
2765 struct font_name
*new_fonts
;
2767 new_fonts
= (struct font_name
*) xmalloc (sizeof *new_fonts
* new_nfonts
);
2768 bcopy (fonts1
, new_fonts
, sizeof *new_fonts
* nfonts1
);
2769 bcopy (fonts2
, new_fonts
+ nfonts1
, sizeof *new_fonts
* nfonts2
);
2776 /* Get a sorted list of fonts of family FAMILY on frame F.
2778 If PATTERN is non-nil list fonts matching that pattern.
2780 If REGISTRY is non-nil, return fonts with that registry and the
2781 alternative registries from Vface_alternative_font_registry_alist.
2783 If REGISTRY is nil return fonts of any registry.
2785 Set *FONTS to a vector of font_name structures allocated from the
2786 heap containing the fonts found. Value is the number of fonts
2790 font_list (f
, pattern
, family
, registry
, fonts
)
2792 Lisp_Object pattern
, family
, registry
;
2793 struct font_name
**fonts
;
2795 int nfonts
= font_list_1 (f
, pattern
, family
, registry
, fonts
);
2797 if (!NILP (registry
)
2798 && CONSP (Vface_alternative_font_registry_alist
))
2802 alter
= Fassoc (registry
, Vface_alternative_font_registry_alist
);
2807 for (alter
= XCDR (alter
), reg_prio
= 1;
2809 alter
= XCDR (alter
), reg_prio
++)
2810 if (STRINGP (XCAR (alter
)))
2813 struct font_name
*fonts2
;
2815 nfonts2
= font_list_1 (f
, pattern
, family
, XCAR (alter
),
2817 for (i
= 0; i
< nfonts2
; i
++)
2818 fonts2
[i
].registry_priority
= reg_prio
;
2819 *fonts
= (nfonts
> 0
2820 ? concat_font_list (*fonts
, nfonts
, fonts2
, nfonts2
)
2831 /* Remove elements from LIST whose cars are `equal'. Called from
2832 x-family-fonts and x-font-family-list to remove duplicate font
2836 remove_duplicates (list
)
2839 Lisp_Object tail
= list
;
2841 while (!NILP (tail
) && !NILP (XCDR (tail
)))
2843 Lisp_Object next
= XCDR (tail
);
2844 if (!NILP (Fequal (XCAR (next
), XCAR (tail
))))
2845 XSETCDR (tail
, XCDR (next
));
2852 DEFUN ("x-family-fonts", Fx_family_fonts
, Sx_family_fonts
, 0, 2, 0,
2853 doc
: /* Return a list of available fonts of family FAMILY on FRAME.
2854 If FAMILY is omitted or nil, list all families.
2855 Otherwise, FAMILY must be a string, possibly containing wildcards
2857 If FRAME is omitted or nil, use the selected frame.
2858 Each element of the result is a vector [FAMILY WIDTH POINT-SIZE WEIGHT
2859 SLANT FIXED-P FULL REGISTRY-AND-ENCODING].
2860 FAMILY is the font family name. POINT-SIZE is the size of the
2861 font in 1/10 pt. WIDTH, WEIGHT, and SLANT are symbols describing the
2862 width, weight and slant of the font. These symbols are the same as for
2863 face attributes. FIXED-P is non-nil if the font is fixed-pitch.
2864 FULL is the full name of the font, and REGISTRY-AND-ENCODING is a string
2865 giving the registry and encoding of the font.
2866 The result list is sorted according to the current setting of
2867 the face font sort order. */)
2869 Lisp_Object family
, frame
;
2871 struct frame
*f
= check_x_frame (frame
);
2872 struct font_name
*fonts
;
2875 struct gcpro gcpro1
;
2878 CHECK_STRING (family
);
2882 nfonts
= font_list (f
, Qnil
, family
, Qnil
, &fonts
);
2883 for (i
= nfonts
- 1; i
>= 0; --i
)
2885 Lisp_Object v
= Fmake_vector (make_number (8), Qnil
);
2888 ASET (v
, 0, build_string (fonts
[i
].fields
[XLFD_FAMILY
]));
2889 ASET (v
, 1, xlfd_symbolic_swidth (fonts
+ i
));
2890 ASET (v
, 2, make_number (xlfd_point_size (f
, fonts
+ i
)));
2891 ASET (v
, 3, xlfd_symbolic_weight (fonts
+ i
));
2892 ASET (v
, 4, xlfd_symbolic_slant (fonts
+ i
));
2893 ASET (v
, 5, xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
);
2894 tem
= build_font_name (fonts
+ i
);
2895 ASET (v
, 6, build_string (tem
));
2896 sprintf (tem
, "%s-%s", fonts
[i
].fields
[XLFD_REGISTRY
],
2897 fonts
[i
].fields
[XLFD_ENCODING
]);
2898 ASET (v
, 7, build_string (tem
));
2901 result
= Fcons (v
, result
);
2904 remove_duplicates (result
);
2905 free_font_names (fonts
, nfonts
);
2911 DEFUN ("x-font-family-list", Fx_font_family_list
, Sx_font_family_list
,
2913 doc
: /* Return a list of available font families on FRAME.
2914 If FRAME is omitted or nil, use the selected frame.
2915 Value is a list of conses (FAMILY . FIXED-P) where FAMILY
2916 is a font family, and FIXED-P is non-nil if fonts of that family
2917 are fixed-pitch. */)
2921 struct frame
*f
= check_x_frame (frame
);
2923 struct font_name
*fonts
;
2925 struct gcpro gcpro1
;
2926 int count
= SPECPDL_INDEX ();
2928 /* Let's consider all fonts. */
2929 specbind (intern ("font-list-limit"), make_number (-1));
2930 nfonts
= font_list (f
, Qnil
, Qnil
, Qnil
, &fonts
);
2934 for (i
= nfonts
- 1; i
>= 0; --i
)
2935 result
= Fcons (Fcons (build_string (fonts
[i
].fields
[XLFD_FAMILY
]),
2936 xlfd_fixed_p (fonts
+ i
) ? Qt
: Qnil
),
2939 remove_duplicates (result
);
2940 free_font_names (fonts
, nfonts
);
2942 return unbind_to (count
, result
);
2946 DEFUN ("x-list-fonts", Fx_list_fonts
, Sx_list_fonts
, 1, 5, 0,
2947 doc
: /* Return a list of the names of available fonts matching PATTERN.
2948 If optional arguments FACE and FRAME are specified, return only fonts
2949 the same size as FACE on FRAME.
2950 PATTERN is a string, perhaps with wildcard characters;
2951 the * character matches any substring, and
2952 the ? character matches any single character.
2953 PATTERN is case-insensitive.
2954 FACE is a face name--a symbol.
2956 The return value is a list of strings, suitable as arguments to
2959 Fonts Emacs can't use may or may not be excluded
2960 even if they match PATTERN and FACE.
2961 The optional fourth argument MAXIMUM sets a limit on how many
2962 fonts to match. The first MAXIMUM fonts are reported.
2963 The optional fifth argument WIDTH, if specified, is a number of columns
2964 occupied by a character of a font. In that case, return only fonts
2965 the WIDTH times as wide as FACE on FRAME. */)
2966 (pattern
, face
, frame
, maximum
, width
)
2967 Lisp_Object pattern
, face
, frame
, maximum
, width
;
2974 CHECK_STRING (pattern
);
2980 CHECK_NATNUM (maximum
);
2981 maxnames
= XINT (maximum
);
2985 CHECK_NUMBER (width
);
2987 /* We can't simply call check_x_frame because this function may be
2988 called before any frame is created. */
2989 f
= frame_or_selected_frame (frame
, 2);
2990 if (!FRAME_WINDOW_P (f
))
2992 /* Perhaps we have not yet created any frame. */
2997 /* Determine the width standard for comparison with the fonts we find. */
3003 /* This is of limited utility since it works with character
3004 widths. Keep it for compatibility. --gerd. */
3005 int face_id
= lookup_named_face (f
, face
, 0);
3006 struct face
*face
= (face_id
< 0
3008 : FACE_FROM_ID (f
, face_id
));
3011 /* For historic reasons, FONT_WIDTH refers to average width on W32,
3012 not maximum as on X. Redefine here. */
3014 #define FONT_WIDTH FONT_MAX_WIDTH
3017 if (face
&& face
->font
)
3018 size
= FONT_WIDTH (face
->font
);
3020 size
= FONT_WIDTH (FRAME_FONT (f
)); /* FRAME_COLUMN_WIDTH (f) */
3023 size
*= XINT (width
);
3027 Lisp_Object args
[2];
3029 args
[0] = x_list_fonts (f
, pattern
, size
, maxnames
);
3031 /* We don't have to check fontsets. */
3033 args
[1] = list_fontsets (f
, pattern
, size
);
3034 return Fnconc (2, args
);
3038 #endif /* HAVE_WINDOW_SYSTEM */
3042 /***********************************************************************
3044 ***********************************************************************/
3046 /* Access face attributes of face LFACE, a Lisp vector. */
3048 #define LFACE_FAMILY(LFACE) AREF ((LFACE), LFACE_FAMILY_INDEX)
3049 #define LFACE_HEIGHT(LFACE) AREF ((LFACE), LFACE_HEIGHT_INDEX)
3050 #define LFACE_WEIGHT(LFACE) AREF ((LFACE), LFACE_WEIGHT_INDEX)
3051 #define LFACE_SLANT(LFACE) AREF ((LFACE), LFACE_SLANT_INDEX)
3052 #define LFACE_UNDERLINE(LFACE) AREF ((LFACE), LFACE_UNDERLINE_INDEX)
3053 #define LFACE_INVERSE(LFACE) AREF ((LFACE), LFACE_INVERSE_INDEX)
3054 #define LFACE_FOREGROUND(LFACE) AREF ((LFACE), LFACE_FOREGROUND_INDEX)
3055 #define LFACE_BACKGROUND(LFACE) AREF ((LFACE), LFACE_BACKGROUND_INDEX)
3056 #define LFACE_STIPPLE(LFACE) AREF ((LFACE), LFACE_STIPPLE_INDEX)
3057 #define LFACE_SWIDTH(LFACE) AREF ((LFACE), LFACE_SWIDTH_INDEX)
3058 #define LFACE_OVERLINE(LFACE) AREF ((LFACE), LFACE_OVERLINE_INDEX)
3059 #define LFACE_STRIKE_THROUGH(LFACE) AREF ((LFACE), LFACE_STRIKE_THROUGH_INDEX)
3060 #define LFACE_BOX(LFACE) AREF ((LFACE), LFACE_BOX_INDEX)
3061 #define LFACE_FONT(LFACE) AREF ((LFACE), LFACE_FONT_INDEX)
3062 #define LFACE_INHERIT(LFACE) AREF ((LFACE), LFACE_INHERIT_INDEX)
3063 #define LFACE_AVGWIDTH(LFACE) AREF ((LFACE), LFACE_AVGWIDTH_INDEX)
3065 /* Non-zero if LFACE is a Lisp face. A Lisp face is a vector of size
3066 LFACE_VECTOR_SIZE which has the symbol `face' in slot 0. */
3068 #define LFACEP(LFACE) \
3070 && XVECTOR (LFACE)->size == LFACE_VECTOR_SIZE \
3071 && EQ (AREF (LFACE, 0), Qface))
3076 /* Check consistency of Lisp face attribute vector ATTRS. */
3079 check_lface_attrs (attrs
)
3082 xassert (UNSPECIFIEDP (attrs
[LFACE_FAMILY_INDEX
])
3083 || STRINGP (attrs
[LFACE_FAMILY_INDEX
]));
3084 xassert (UNSPECIFIEDP (attrs
[LFACE_SWIDTH_INDEX
])
3085 || SYMBOLP (attrs
[LFACE_SWIDTH_INDEX
]));
3086 xassert (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
3087 || INTEGERP (attrs
[LFACE_AVGWIDTH_INDEX
]));
3088 xassert (UNSPECIFIEDP (attrs
[LFACE_HEIGHT_INDEX
])
3089 || INTEGERP (attrs
[LFACE_HEIGHT_INDEX
])
3090 || FLOATP (attrs
[LFACE_HEIGHT_INDEX
])
3091 || FUNCTIONP (attrs
[LFACE_HEIGHT_INDEX
]));
3092 xassert (UNSPECIFIEDP (attrs
[LFACE_WEIGHT_INDEX
])
3093 || SYMBOLP (attrs
[LFACE_WEIGHT_INDEX
]));
3094 xassert (UNSPECIFIEDP (attrs
[LFACE_SLANT_INDEX
])
3095 || SYMBOLP (attrs
[LFACE_SLANT_INDEX
]));
3096 xassert (UNSPECIFIEDP (attrs
[LFACE_UNDERLINE_INDEX
])
3097 || SYMBOLP (attrs
[LFACE_UNDERLINE_INDEX
])
3098 || STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]));
3099 xassert (UNSPECIFIEDP (attrs
[LFACE_OVERLINE_INDEX
])
3100 || SYMBOLP (attrs
[LFACE_OVERLINE_INDEX
])
3101 || STRINGP (attrs
[LFACE_OVERLINE_INDEX
]));
3102 xassert (UNSPECIFIEDP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3103 || SYMBOLP (attrs
[LFACE_STRIKE_THROUGH_INDEX
])
3104 || STRINGP (attrs
[LFACE_STRIKE_THROUGH_INDEX
]));
3105 xassert (UNSPECIFIEDP (attrs
[LFACE_BOX_INDEX
])
3106 || SYMBOLP (attrs
[LFACE_BOX_INDEX
])
3107 || STRINGP (attrs
[LFACE_BOX_INDEX
])
3108 || INTEGERP (attrs
[LFACE_BOX_INDEX
])
3109 || CONSP (attrs
[LFACE_BOX_INDEX
]));
3110 xassert (UNSPECIFIEDP (attrs
[LFACE_INVERSE_INDEX
])
3111 || SYMBOLP (attrs
[LFACE_INVERSE_INDEX
]));
3112 xassert (UNSPECIFIEDP (attrs
[LFACE_FOREGROUND_INDEX
])
3113 || STRINGP (attrs
[LFACE_FOREGROUND_INDEX
]));
3114 xassert (UNSPECIFIEDP (attrs
[LFACE_BACKGROUND_INDEX
])
3115 || STRINGP (attrs
[LFACE_BACKGROUND_INDEX
]));
3116 xassert (UNSPECIFIEDP (attrs
[LFACE_INHERIT_INDEX
])
3117 || NILP (attrs
[LFACE_INHERIT_INDEX
])
3118 || SYMBOLP (attrs
[LFACE_INHERIT_INDEX
])
3119 || CONSP (attrs
[LFACE_INHERIT_INDEX
]));
3120 #ifdef HAVE_WINDOW_SYSTEM
3121 xassert (UNSPECIFIEDP (attrs
[LFACE_STIPPLE_INDEX
])
3122 || SYMBOLP (attrs
[LFACE_STIPPLE_INDEX
])
3123 || !NILP (Fbitmap_spec_p (attrs
[LFACE_STIPPLE_INDEX
])));
3124 xassert (UNSPECIFIEDP (attrs
[LFACE_FONT_INDEX
])
3125 || NILP (attrs
[LFACE_FONT_INDEX
])
3126 || STRINGP (attrs
[LFACE_FONT_INDEX
]));
3131 /* Check consistency of attributes of Lisp face LFACE (a Lisp vector). */
3139 xassert (LFACEP (lface
));
3140 check_lface_attrs (XVECTOR (lface
)->contents
);
3144 #else /* GLYPH_DEBUG == 0 */
3146 #define check_lface_attrs(attrs) (void) 0
3147 #define check_lface(lface) (void) 0
3149 #endif /* GLYPH_DEBUG == 0 */
3152 /* Resolve face name FACE_NAME. If FACE_NAME is a string, intern it
3153 to make it a symvol. If FACE_NAME is an alias for another face,
3154 return that face's name. */
3157 resolve_face_name (face_name
)
3158 Lisp_Object face_name
;
3160 Lisp_Object aliased
;
3162 if (STRINGP (face_name
))
3163 face_name
= intern (SDATA (face_name
));
3165 while (SYMBOLP (face_name
))
3167 aliased
= Fget (face_name
, Qface_alias
);
3171 face_name
= aliased
;
3178 /* Return the face definition of FACE_NAME on frame F. F null means
3179 return the definition for new frames. FACE_NAME may be a string or
3180 a symbol (apparently Emacs 20.2 allowed strings as face names in
3181 face text properties; Ediff uses that). If FACE_NAME is an alias
3182 for another face, return that face's definition. If SIGNAL_P is
3183 non-zero, signal an error if FACE_NAME is not a valid face name.
3184 If SIGNAL_P is zero, value is nil if FACE_NAME is not a valid face
3187 static INLINE Lisp_Object
3188 lface_from_face_name (f
, face_name
, signal_p
)
3190 Lisp_Object face_name
;
3195 face_name
= resolve_face_name (face_name
);
3198 lface
= assq_no_quit (face_name
, f
->face_alist
);
3200 lface
= assq_no_quit (face_name
, Vface_new_frame_defaults
);
3203 lface
= XCDR (lface
);
3205 signal_error ("Invalid face", face_name
);
3207 check_lface (lface
);
3212 /* Get face attributes of face FACE_NAME from frame-local faces on
3213 frame F. Store the resulting attributes in ATTRS which must point
3214 to a vector of Lisp_Objects of size LFACE_VECTOR_SIZE. If SIGNAL_P
3215 is non-zero, signal an error if FACE_NAME does not name a face.
3216 Otherwise, value is zero if FACE_NAME is not a face. */
3219 get_lface_attributes (f
, face_name
, attrs
, signal_p
)
3221 Lisp_Object face_name
;
3228 lface
= lface_from_face_name (f
, face_name
, signal_p
);
3231 bcopy (XVECTOR (lface
)->contents
, attrs
,
3232 LFACE_VECTOR_SIZE
* sizeof *attrs
);
3242 /* Non-zero if all attributes in face attribute vector ATTRS are
3243 specified, i.e. are non-nil. */
3246 lface_fully_specified_p (attrs
)
3251 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3252 if (i
!= LFACE_FONT_INDEX
&& i
!= LFACE_INHERIT_INDEX
3253 && i
!= LFACE_AVGWIDTH_INDEX
)
3254 if (UNSPECIFIEDP (attrs
[i
])
3256 /* MAC_TODO: No stipple support on Mac OS yet, this index is
3257 always unspecified. */
3258 && i
!= LFACE_STIPPLE_INDEX
3263 return i
== LFACE_VECTOR_SIZE
;
3266 #ifdef HAVE_WINDOW_SYSTEM
3268 /* Set font-related attributes of Lisp face LFACE from the fullname of
3269 the font opened by FONTNAME. If FORCE_P is zero, set only
3270 unspecified attributes of LFACE. The exception is `font'
3271 attribute. It is set to FONTNAME as is regardless of FORCE_P.
3273 If FONTNAME is not available on frame F,
3274 return 0 if MAY_FAIL_P is non-zero, otherwise abort.
3275 If the fullname is not in a valid XLFD format,
3276 return 0 if MAY_FAIL_P is non-zero, otherwise set normal values
3277 in LFACE and return 1.
3278 Otherwise, return 1. */
3281 set_lface_from_font_name (f
, lface
, fontname
, force_p
, may_fail_p
)
3284 Lisp_Object fontname
;
3285 int force_p
, may_fail_p
;
3287 struct font_name font
;
3292 char *font_name
= SDATA (fontname
);
3293 struct font_info
*font_info
;
3295 /* If FONTNAME is actually a fontset name, get ASCII font name of it. */
3296 fontset
= fs_query_fontset (fontname
, 0);
3298 font_name
= SDATA (fontset_ascii (fontset
));
3300 /* Check if FONT_NAME is surely available on the system. Usually
3301 FONT_NAME is already cached for the frame F and FS_LOAD_FONT
3302 returns quickly. But, even if FONT_NAME is not yet cached,
3303 caching it now is not futail because we anyway load the font
3306 font_info
= FS_LOAD_FONT (f
, 0, font_name
, -1);
3316 font
.name
= STRDUPA (font_info
->full_name
);
3317 have_xlfd_p
= split_font_name (f
, &font
, 1);
3319 /* Set attributes only if unspecified, otherwise face defaults for
3320 new frames would never take effect. If we couldn't get a font
3321 name conforming to XLFD, set normal values. */
3323 if (force_p
|| UNSPECIFIEDP (LFACE_FAMILY (lface
)))
3328 buffer
= (char *) alloca (strlen (font
.fields
[XLFD_FAMILY
])
3329 + strlen (font
.fields
[XLFD_FOUNDRY
])
3331 sprintf (buffer
, "%s-%s", font
.fields
[XLFD_FOUNDRY
],
3332 font
.fields
[XLFD_FAMILY
]);
3333 val
= build_string (buffer
);
3336 val
= build_string ("*");
3337 LFACE_FAMILY (lface
) = val
;
3340 if (force_p
|| UNSPECIFIEDP (LFACE_HEIGHT (lface
)))
3343 pt
= xlfd_point_size (f
, &font
);
3345 pt
= pixel_point_size (f
, font_info
->height
* 10);
3347 LFACE_HEIGHT (lface
) = make_number (pt
);
3350 if (force_p
|| UNSPECIFIEDP (LFACE_SWIDTH (lface
)))
3351 LFACE_SWIDTH (lface
)
3352 = have_xlfd_p
? xlfd_symbolic_swidth (&font
) : Qnormal
;
3354 if (force_p
|| UNSPECIFIEDP (LFACE_AVGWIDTH (lface
)))
3355 LFACE_AVGWIDTH (lface
)
3357 ? make_number (font
.numeric
[XLFD_AVGWIDTH
])
3360 if (force_p
|| UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
3361 LFACE_WEIGHT (lface
)
3362 = have_xlfd_p
? xlfd_symbolic_weight (&font
) : Qnormal
;
3364 if (force_p
|| UNSPECIFIEDP (LFACE_SLANT (lface
)))
3366 = have_xlfd_p
? xlfd_symbolic_slant (&font
) : Qnormal
;
3368 LFACE_FONT (lface
) = fontname
;
3373 #endif /* HAVE_WINDOW_SYSTEM */
3376 /* Merges the face height FROM with the face height TO, and returns the
3377 merged height. If FROM is an invalid height, then INVALID is
3378 returned instead. FROM and TO may be either absolute face heights or
3379 `relative' heights; the returned value is always an absolute height
3380 unless both FROM and TO are relative. GCPRO is a lisp value that
3381 will be protected from garbage-collection if this function makes a
3385 merge_face_heights (from
, to
, invalid
, gcpro
)
3386 Lisp_Object from
, to
, invalid
, gcpro
;
3388 Lisp_Object result
= invalid
;
3390 if (INTEGERP (from
))
3391 /* FROM is absolute, just use it as is. */
3393 else if (FLOATP (from
))
3394 /* FROM is a scale, use it to adjust TO. */
3397 /* relative X absolute => absolute */
3398 result
= make_number ((EMACS_INT
)(XFLOAT_DATA (from
) * XINT (to
)));
3399 else if (FLOATP (to
))
3400 /* relative X relative => relative */
3401 result
= make_float (XFLOAT_DATA (from
) * XFLOAT_DATA (to
));
3403 else if (FUNCTIONP (from
))
3404 /* FROM is a function, which use to adjust TO. */
3406 /* Call function with current height as argument.
3407 From is the new height. */
3408 Lisp_Object args
[2];
3409 struct gcpro gcpro1
;
3415 result
= safe_call (2, args
);
3419 /* Ensure that if TO was absolute, so is the result. */
3420 if (INTEGERP (to
) && !INTEGERP (result
))
3428 /* Merge two Lisp face attribute vectors on frame F, FROM and TO, and
3429 store the resulting attributes in TO, which must be already be
3430 completely specified and contain only absolute attributes. Every
3431 specified attribute of FROM overrides the corresponding attribute of
3432 TO; relative attributes in FROM are merged with the absolute value in
3433 TO and replace it. CYCLE_CHECK is used internally to detect loops in
3434 face inheritance; it should be Qnil when called from other places. */
3437 merge_face_vectors (f
, from
, to
, cycle_check
)
3439 Lisp_Object
*from
, *to
;
3440 Lisp_Object cycle_check
;
3444 /* If FROM inherits from some other faces, merge their attributes into
3445 TO before merging FROM's direct attributes. Note that an :inherit
3446 attribute of `unspecified' is the same as one of nil; we never
3447 merge :inherit attributes, so nil is more correct, but lots of
3448 other code uses `unspecified' as a generic value for face attributes. */
3449 if (!UNSPECIFIEDP (from
[LFACE_INHERIT_INDEX
])
3450 && !NILP (from
[LFACE_INHERIT_INDEX
]))
3451 merge_face_inheritance (f
, from
[LFACE_INHERIT_INDEX
], to
, cycle_check
);
3453 /* If TO specifies a :font attribute, and FROM specifies some
3454 font-related attribute, we need to clear TO's :font attribute
3455 (because it will be inconsistent with whatever FROM specifies, and
3456 FROM takes precedence). */
3457 if (!NILP (to
[LFACE_FONT_INDEX
])
3458 && (!UNSPECIFIEDP (from
[LFACE_FAMILY_INDEX
])
3459 || !UNSPECIFIEDP (from
[LFACE_HEIGHT_INDEX
])
3460 || !UNSPECIFIEDP (from
[LFACE_WEIGHT_INDEX
])
3461 || !UNSPECIFIEDP (from
[LFACE_SLANT_INDEX
])
3462 || !UNSPECIFIEDP (from
[LFACE_SWIDTH_INDEX
])
3463 || !UNSPECIFIEDP (from
[LFACE_AVGWIDTH_INDEX
])))
3464 to
[LFACE_FONT_INDEX
] = Qnil
;
3466 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3467 if (!UNSPECIFIEDP (from
[i
]))
3469 if (i
== LFACE_HEIGHT_INDEX
&& !INTEGERP (from
[i
]))
3470 to
[i
] = merge_face_heights (from
[i
], to
[i
], to
[i
], cycle_check
);
3475 /* TO is always an absolute face, which should inherit from nothing.
3476 We blindly copy the :inherit attribute above and fix it up here. */
3477 to
[LFACE_INHERIT_INDEX
] = Qnil
;
3481 /* Checks the `cycle check' variable CHECK to see if it indicates that
3482 EL is part of a cycle; CHECK must be either Qnil or a value returned
3483 by an earlier use of CYCLE_CHECK. SUSPICIOUS is the number of
3484 elements after which a cycle might be suspected; after that many
3485 elements, this macro begins consing in order to keep more precise
3488 Returns nil if a cycle was detected, otherwise a new value for CHECK
3491 CHECK is evaluated multiple times, EL and SUSPICIOUS 0 or 1 times, so
3492 the caller should make sure that's ok. */
3494 #define CYCLE_CHECK(check, el, suspicious) \
3497 : (INTEGERP (check) \
3498 ? (XFASTINT (check) < (suspicious) \
3499 ? make_number (XFASTINT (check) + 1) \
3500 : Fcons (el, Qnil)) \
3501 : (!NILP (Fmemq ((el), (check))) \
3503 : Fcons ((el), (check)))))
3506 /* Merge face attributes from the face on frame F whose name is
3507 INHERITS, into the vector of face attributes TO; INHERITS may also be
3508 a list of face names, in which case they are applied in order.
3509 CYCLE_CHECK is used to detect loops in face inheritance.
3510 Returns true if any of the inherited attributes are `font-related'. */
3513 merge_face_inheritance (f
, inherit
, to
, cycle_check
)
3515 Lisp_Object inherit
;
3517 Lisp_Object cycle_check
;
3519 if (SYMBOLP (inherit
) && !EQ (inherit
, Qunspecified
))
3520 /* Inherit from the named face INHERIT. */
3524 /* Make sure we're not in an inheritance loop. */
3525 cycle_check
= CYCLE_CHECK (cycle_check
, inherit
, 15);
3526 if (NILP (cycle_check
))
3527 /* Cycle detected, ignore any further inheritance. */
3530 lface
= lface_from_face_name (f
, inherit
, 0);
3532 merge_face_vectors (f
, XVECTOR (lface
)->contents
, to
, cycle_check
);
3534 else if (CONSP (inherit
))
3535 /* Handle a list of inherited faces by calling ourselves recursively
3536 on each element. Note that we only do so for symbol elements, so
3537 it's not possible to infinitely recurse. */
3539 while (CONSP (inherit
))
3541 if (SYMBOLP (XCAR (inherit
)))
3542 merge_face_inheritance (f
, XCAR (inherit
), to
, cycle_check
);
3544 /* Check for a circular inheritance list. */
3545 cycle_check
= CYCLE_CHECK (cycle_check
, inherit
, 15);
3546 if (NILP (cycle_check
))
3547 /* Cycle detected. */
3550 inherit
= XCDR (inherit
);
3556 /* Given a Lisp face attribute vector TO and a Lisp object PROP that
3557 is a face property, determine the resulting face attributes on
3558 frame F, and store them in TO. PROP may be a single face
3559 specification or a list of such specifications. Each face
3560 specification can be
3562 1. A symbol or string naming a Lisp face.
3564 2. A property list of the form (KEYWORD VALUE ...) where each
3565 KEYWORD is a face attribute name, and value is an appropriate value
3568 3. Conses or the form (FOREGROUND-COLOR . COLOR) or
3569 (BACKGROUND-COLOR . COLOR) where COLOR is a color name. This is
3570 for compatibility with 20.2.
3572 Face specifications earlier in lists take precedence over later
3576 merge_face_vector_with_property (f
, to
, prop
)
3583 Lisp_Object first
= XCAR (prop
);
3585 if (EQ (first
, Qforeground_color
)
3586 || EQ (first
, Qbackground_color
))
3588 /* One of (FOREGROUND-COLOR . COLOR) or (BACKGROUND-COLOR
3589 . COLOR). COLOR must be a string. */
3590 Lisp_Object color_name
= XCDR (prop
);
3591 Lisp_Object color
= first
;
3593 if (STRINGP (color_name
))
3595 if (EQ (color
, Qforeground_color
))
3596 to
[LFACE_FOREGROUND_INDEX
] = color_name
;
3598 to
[LFACE_BACKGROUND_INDEX
] = color_name
;
3601 add_to_log ("Invalid face color", color_name
, Qnil
);
3603 else if (SYMBOLP (first
)
3604 && *SDATA (SYMBOL_NAME (first
)) == ':')
3606 /* Assume this is the property list form. */
3607 while (CONSP (prop
) && CONSP (XCDR (prop
)))
3609 Lisp_Object keyword
= XCAR (prop
);
3610 Lisp_Object value
= XCAR (XCDR (prop
));
3612 if (EQ (keyword
, QCfamily
))
3614 if (STRINGP (value
))
3615 to
[LFACE_FAMILY_INDEX
] = value
;
3617 add_to_log ("Invalid face font family", value
, Qnil
);
3619 else if (EQ (keyword
, QCheight
))
3621 Lisp_Object new_height
=
3622 merge_face_heights (value
, to
[LFACE_HEIGHT_INDEX
],
3625 if (NILP (new_height
))
3626 add_to_log ("Invalid face font height", value
, Qnil
);
3628 to
[LFACE_HEIGHT_INDEX
] = new_height
;
3630 else if (EQ (keyword
, QCweight
))
3633 && face_numeric_weight (value
) >= 0)
3634 to
[LFACE_WEIGHT_INDEX
] = value
;
3636 add_to_log ("Invalid face weight", value
, Qnil
);
3638 else if (EQ (keyword
, QCslant
))
3641 && face_numeric_slant (value
) >= 0)
3642 to
[LFACE_SLANT_INDEX
] = value
;
3644 add_to_log ("Invalid face slant", value
, Qnil
);
3646 else if (EQ (keyword
, QCunderline
))
3651 to
[LFACE_UNDERLINE_INDEX
] = value
;
3653 add_to_log ("Invalid face underline", value
, Qnil
);
3655 else if (EQ (keyword
, QCoverline
))
3660 to
[LFACE_OVERLINE_INDEX
] = value
;
3662 add_to_log ("Invalid face overline", value
, Qnil
);
3664 else if (EQ (keyword
, QCstrike_through
))
3669 to
[LFACE_STRIKE_THROUGH_INDEX
] = value
;
3671 add_to_log ("Invalid face strike-through", value
, Qnil
);
3673 else if (EQ (keyword
, QCbox
))
3676 value
= make_number (1);
3677 if (INTEGERP (value
)
3681 to
[LFACE_BOX_INDEX
] = value
;
3683 add_to_log ("Invalid face box", value
, Qnil
);
3685 else if (EQ (keyword
, QCinverse_video
)
3686 || EQ (keyword
, QCreverse_video
))
3688 if (EQ (value
, Qt
) || NILP (value
))
3689 to
[LFACE_INVERSE_INDEX
] = value
;
3691 add_to_log ("Invalid face inverse-video", value
, Qnil
);
3693 else if (EQ (keyword
, QCforeground
))
3695 if (STRINGP (value
))
3696 to
[LFACE_FOREGROUND_INDEX
] = value
;
3698 add_to_log ("Invalid face foreground", value
, Qnil
);
3700 else if (EQ (keyword
, QCbackground
))
3702 if (STRINGP (value
))
3703 to
[LFACE_BACKGROUND_INDEX
] = value
;
3705 add_to_log ("Invalid face background", value
, Qnil
);
3707 else if (EQ (keyword
, QCstipple
))
3709 #ifdef HAVE_X_WINDOWS
3710 Lisp_Object pixmap_p
= Fbitmap_spec_p (value
);
3711 if (!NILP (pixmap_p
))
3712 to
[LFACE_STIPPLE_INDEX
] = value
;
3714 add_to_log ("Invalid face stipple", value
, Qnil
);
3717 else if (EQ (keyword
, QCwidth
))
3720 && face_numeric_swidth (value
) >= 0)
3721 to
[LFACE_SWIDTH_INDEX
] = value
;
3723 add_to_log ("Invalid face width", value
, Qnil
);
3725 else if (EQ (keyword
, QCinherit
))
3727 if (SYMBOLP (value
))
3728 to
[LFACE_INHERIT_INDEX
] = value
;
3732 for (tail
= value
; CONSP (tail
); tail
= XCDR (tail
))
3733 if (!SYMBOLP (XCAR (tail
)))
3736 to
[LFACE_INHERIT_INDEX
] = value
;
3738 add_to_log ("Invalid face inherit", value
, Qnil
);
3742 add_to_log ("Invalid attribute %s in face property",
3745 prop
= XCDR (XCDR (prop
));
3750 /* This is a list of face specs. Specifications at the
3751 beginning of the list take precedence over later
3752 specifications, so we have to merge starting with the
3753 last specification. */
3754 Lisp_Object next
= XCDR (prop
);
3756 merge_face_vector_with_property (f
, to
, next
);
3757 merge_face_vector_with_property (f
, to
, first
);
3762 /* PROP ought to be a face name. */
3763 Lisp_Object lface
= lface_from_face_name (f
, prop
, 0);
3765 add_to_log ("Invalid face text property value: %s", prop
, Qnil
);
3767 merge_face_vectors (f
, XVECTOR (lface
)->contents
, to
, Qnil
);
3772 DEFUN ("internal-make-lisp-face", Finternal_make_lisp_face
,
3773 Sinternal_make_lisp_face
, 1, 2, 0,
3774 doc
: /* Make FACE, a symbol, a Lisp face with all attributes nil.
3775 If FACE was not known as a face before, create a new one.
3776 If optional argument FRAME is specified, make a frame-local face
3777 for that frame. Otherwise operate on the global face definition.
3778 Value is a vector of face attributes. */)
3780 Lisp_Object face
, frame
;
3782 Lisp_Object global_lface
, lface
;
3786 CHECK_SYMBOL (face
);
3787 global_lface
= lface_from_face_name (NULL
, face
, 0);
3791 CHECK_LIVE_FRAME (frame
);
3793 lface
= lface_from_face_name (f
, face
, 0);
3796 f
= NULL
, lface
= Qnil
;
3798 /* Add a global definition if there is none. */
3799 if (NILP (global_lface
))
3801 global_lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
3803 AREF (global_lface
, 0) = Qface
;
3804 Vface_new_frame_defaults
= Fcons (Fcons (face
, global_lface
),
3805 Vface_new_frame_defaults
);
3807 /* Assign the new Lisp face a unique ID. The mapping from Lisp
3808 face id to Lisp face is given by the vector lface_id_to_name.
3809 The mapping from Lisp face to Lisp face id is given by the
3810 property `face' of the Lisp face name. */
3811 if (next_lface_id
== lface_id_to_name_size
)
3813 int new_size
= max (50, 2 * lface_id_to_name_size
);
3814 int sz
= new_size
* sizeof *lface_id_to_name
;
3815 lface_id_to_name
= (Lisp_Object
*) xrealloc (lface_id_to_name
, sz
);
3816 lface_id_to_name_size
= new_size
;
3819 lface_id_to_name
[next_lface_id
] = face
;
3820 Fput (face
, Qface
, make_number (next_lface_id
));
3824 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3825 AREF (global_lface
, i
) = Qunspecified
;
3827 /* Add a frame-local definition. */
3832 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
3834 AREF (lface
, 0) = Qface
;
3835 f
->face_alist
= Fcons (Fcons (face
, lface
), f
->face_alist
);
3838 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
3839 AREF (lface
, i
) = Qunspecified
;
3842 lface
= global_lface
;
3844 /* Changing a named face means that all realized faces depending on
3845 that face are invalid. Since we cannot tell which realized faces
3846 depend on the face, make sure they are all removed. This is done
3847 by incrementing face_change_count. The next call to
3848 init_iterator will then free realized faces. */
3849 ++face_change_count
;
3850 ++windows_or_buffers_changed
;
3852 xassert (LFACEP (lface
));
3853 check_lface (lface
);
3858 DEFUN ("internal-lisp-face-p", Finternal_lisp_face_p
,
3859 Sinternal_lisp_face_p
, 1, 2, 0,
3860 doc
: /* Return non-nil if FACE names a face.
3861 If optional second parameter FRAME is non-nil, check for the
3862 existence of a frame-local face with name FACE on that frame.
3863 Otherwise check for the existence of a global face. */)
3865 Lisp_Object face
, frame
;
3871 CHECK_LIVE_FRAME (frame
);
3872 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
3875 lface
= lface_from_face_name (NULL
, face
, 0);
3881 DEFUN ("internal-copy-lisp-face", Finternal_copy_lisp_face
,
3882 Sinternal_copy_lisp_face
, 4, 4, 0,
3883 doc
: /* Copy face FROM to TO.
3884 If FRAME it t, copy the global face definition of FROM to the
3885 global face definition of TO. Otherwise, copy the frame-local
3886 definition of FROM on FRAME to the frame-local definition of TO
3887 on NEW-FRAME, or FRAME if NEW-FRAME is nil.
3890 (from
, to
, frame
, new_frame
)
3891 Lisp_Object from
, to
, frame
, new_frame
;
3893 Lisp_Object lface
, copy
;
3895 CHECK_SYMBOL (from
);
3897 if (NILP (new_frame
))
3902 /* Copy global definition of FROM. We don't make copies of
3903 strings etc. because 20.2 didn't do it either. */
3904 lface
= lface_from_face_name (NULL
, from
, 1);
3905 copy
= Finternal_make_lisp_face (to
, Qnil
);
3909 /* Copy frame-local definition of FROM. */
3910 CHECK_LIVE_FRAME (frame
);
3911 CHECK_LIVE_FRAME (new_frame
);
3912 lface
= lface_from_face_name (XFRAME (frame
), from
, 1);
3913 copy
= Finternal_make_lisp_face (to
, new_frame
);
3916 bcopy (XVECTOR (lface
)->contents
, XVECTOR (copy
)->contents
,
3917 LFACE_VECTOR_SIZE
* sizeof (Lisp_Object
));
3919 /* Changing a named face means that all realized faces depending on
3920 that face are invalid. Since we cannot tell which realized faces
3921 depend on the face, make sure they are all removed. This is done
3922 by incrementing face_change_count. The next call to
3923 init_iterator will then free realized faces. */
3924 ++face_change_count
;
3925 ++windows_or_buffers_changed
;
3931 DEFUN ("internal-set-lisp-face-attribute", Finternal_set_lisp_face_attribute
,
3932 Sinternal_set_lisp_face_attribute
, 3, 4, 0,
3933 doc
: /* Set attribute ATTR of FACE to VALUE.
3934 FRAME being a frame means change the face on that frame.
3935 FRAME nil means change the face of the selected frame.
3936 FRAME t means change the default for new frames.
3937 FRAME 0 means change the face on all frames, and change the default
3939 (face
, attr
, value
, frame
)
3940 Lisp_Object face
, attr
, value
, frame
;
3943 Lisp_Object old_value
= Qnil
;
3944 /* Set 1 if ATTR is QCfont. */
3945 int font_attr_p
= 0;
3946 /* Set 1 if ATTR is one of font-related attributes other than QCfont. */
3947 int font_related_attr_p
= 0;
3949 CHECK_SYMBOL (face
);
3950 CHECK_SYMBOL (attr
);
3952 face
= resolve_face_name (face
);
3954 /* If FRAME is 0, change face on all frames, and change the
3955 default for new frames. */
3956 if (INTEGERP (frame
) && XINT (frame
) == 0)
3959 Finternal_set_lisp_face_attribute (face
, attr
, value
, Qt
);
3960 FOR_EACH_FRAME (tail
, frame
)
3961 Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
3965 /* Set lface to the Lisp attribute vector of FACE. */
3967 lface
= lface_from_face_name (NULL
, face
, 1);
3971 frame
= selected_frame
;
3973 CHECK_LIVE_FRAME (frame
);
3974 lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
3976 /* If a frame-local face doesn't exist yet, create one. */
3978 lface
= Finternal_make_lisp_face (face
, frame
);
3981 if (EQ (attr
, QCfamily
))
3983 if (!UNSPECIFIEDP (value
))
3985 CHECK_STRING (value
);
3986 if (SCHARS (value
) == 0)
3987 signal_error ("Invalid face family", value
);
3989 old_value
= LFACE_FAMILY (lface
);
3990 LFACE_FAMILY (lface
) = value
;
3991 font_related_attr_p
= 1;
3993 else if (EQ (attr
, QCheight
))
3995 if (!UNSPECIFIEDP (value
))
3999 test
= (EQ (face
, Qdefault
)
4001 /* The default face must have an absolute size,
4002 otherwise, we do a test merge with a random
4003 height to see if VALUE's ok. */
4004 : merge_face_heights (value
, make_number (10), Qnil
, Qnil
));
4006 if (!INTEGERP (test
) || XINT (test
) <= 0)
4007 signal_error ("Invalid face height", value
);
4010 old_value
= LFACE_HEIGHT (lface
);
4011 LFACE_HEIGHT (lface
) = value
;
4012 font_related_attr_p
= 1;
4014 else if (EQ (attr
, QCweight
))
4016 if (!UNSPECIFIEDP (value
))
4018 CHECK_SYMBOL (value
);
4019 if (face_numeric_weight (value
) < 0)
4020 signal_error ("Invalid face weight", value
);
4022 old_value
= LFACE_WEIGHT (lface
);
4023 LFACE_WEIGHT (lface
) = value
;
4024 font_related_attr_p
= 1;
4026 else if (EQ (attr
, QCslant
))
4028 if (!UNSPECIFIEDP (value
))
4030 CHECK_SYMBOL (value
);
4031 if (face_numeric_slant (value
) < 0)
4032 signal_error ("Invalid face slant", value
);
4034 old_value
= LFACE_SLANT (lface
);
4035 LFACE_SLANT (lface
) = value
;
4036 font_related_attr_p
= 1;
4038 else if (EQ (attr
, QCunderline
))
4040 if (!UNSPECIFIEDP (value
))
4041 if ((SYMBOLP (value
)
4043 && !EQ (value
, Qnil
))
4044 /* Underline color. */
4046 && SCHARS (value
) == 0))
4047 signal_error ("Invalid face underline", value
);
4049 old_value
= LFACE_UNDERLINE (lface
);
4050 LFACE_UNDERLINE (lface
) = value
;
4052 else if (EQ (attr
, QCoverline
))
4054 if (!UNSPECIFIEDP (value
))
4055 if ((SYMBOLP (value
)
4057 && !EQ (value
, Qnil
))
4058 /* Overline color. */
4060 && SCHARS (value
) == 0))
4061 signal_error ("Invalid face overline", value
);
4063 old_value
= LFACE_OVERLINE (lface
);
4064 LFACE_OVERLINE (lface
) = value
;
4066 else if (EQ (attr
, QCstrike_through
))
4068 if (!UNSPECIFIEDP (value
))
4069 if ((SYMBOLP (value
)
4071 && !EQ (value
, Qnil
))
4072 /* Strike-through color. */
4074 && SCHARS (value
) == 0))
4075 signal_error ("Invalid face strike-through", value
);
4077 old_value
= LFACE_STRIKE_THROUGH (lface
);
4078 LFACE_STRIKE_THROUGH (lface
) = value
;
4080 else if (EQ (attr
, QCbox
))
4084 /* Allow t meaning a simple box of width 1 in foreground color
4087 value
= make_number (1);
4089 if (UNSPECIFIEDP (value
))
4091 else if (NILP (value
))
4093 else if (INTEGERP (value
))
4094 valid_p
= XINT (value
) != 0;
4095 else if (STRINGP (value
))
4096 valid_p
= SCHARS (value
) > 0;
4097 else if (CONSP (value
))
4113 if (EQ (k
, QCline_width
))
4115 if (!INTEGERP (v
) || XINT (v
) == 0)
4118 else if (EQ (k
, QCcolor
))
4120 if (!STRINGP (v
) || SCHARS (v
) == 0)
4123 else if (EQ (k
, QCstyle
))
4125 if (!EQ (v
, Qpressed_button
) && !EQ (v
, Qreleased_button
))
4132 valid_p
= NILP (tem
);
4138 signal_error ("Invalid face box", value
);
4140 old_value
= LFACE_BOX (lface
);
4141 LFACE_BOX (lface
) = value
;
4143 else if (EQ (attr
, QCinverse_video
)
4144 || EQ (attr
, QCreverse_video
))
4146 if (!UNSPECIFIEDP (value
))
4148 CHECK_SYMBOL (value
);
4149 if (!EQ (value
, Qt
) && !NILP (value
))
4150 signal_error ("Invalid inverse-video face attribute value", value
);
4152 old_value
= LFACE_INVERSE (lface
);
4153 LFACE_INVERSE (lface
) = value
;
4155 else if (EQ (attr
, QCforeground
))
4157 if (!UNSPECIFIEDP (value
))
4159 /* Don't check for valid color names here because it depends
4160 on the frame (display) whether the color will be valid
4161 when the face is realized. */
4162 CHECK_STRING (value
);
4163 if (SCHARS (value
) == 0)
4164 signal_error ("Empty foreground color value", value
);
4166 old_value
= LFACE_FOREGROUND (lface
);
4167 LFACE_FOREGROUND (lface
) = value
;
4169 else if (EQ (attr
, QCbackground
))
4171 if (!UNSPECIFIEDP (value
))
4173 /* Don't check for valid color names here because it depends
4174 on the frame (display) whether the color will be valid
4175 when the face is realized. */
4176 CHECK_STRING (value
);
4177 if (SCHARS (value
) == 0)
4178 signal_error ("Empty background color value", value
);
4180 old_value
= LFACE_BACKGROUND (lface
);
4181 LFACE_BACKGROUND (lface
) = value
;
4183 else if (EQ (attr
, QCstipple
))
4185 #ifdef HAVE_X_WINDOWS
4186 if (!UNSPECIFIEDP (value
)
4188 && NILP (Fbitmap_spec_p (value
)))
4189 signal_error ("Invalid stipple attribute", value
);
4190 old_value
= LFACE_STIPPLE (lface
);
4191 LFACE_STIPPLE (lface
) = value
;
4192 #endif /* HAVE_X_WINDOWS */
4194 else if (EQ (attr
, QCwidth
))
4196 if (!UNSPECIFIEDP (value
))
4198 CHECK_SYMBOL (value
);
4199 if (face_numeric_swidth (value
) < 0)
4200 signal_error ("Invalid face width", value
);
4202 old_value
= LFACE_SWIDTH (lface
);
4203 LFACE_SWIDTH (lface
) = value
;
4204 font_related_attr_p
= 1;
4206 else if (EQ (attr
, QCfont
))
4208 #ifdef HAVE_WINDOW_SYSTEM
4209 if (EQ (frame
, Qt
) || FRAME_WINDOW_P (XFRAME (frame
)))
4211 /* Set font-related attributes of the Lisp face from an XLFD
4217 f
= SELECTED_FRAME ();
4219 f
= check_x_frame (frame
);
4221 if (!UNSPECIFIEDP (value
))
4223 CHECK_STRING (value
);
4225 /* VALUE may be a fontset name or an alias of fontset. In
4226 such a case, use the base fontset name. */
4227 tmp
= Fquery_fontset (value
, Qnil
);
4231 if (!set_lface_from_font_name (f
, lface
, value
, 1, 1))
4232 signal_error ("Invalid font or fontset name", value
);
4237 #endif /* HAVE_WINDOW_SYSTEM */
4239 else if (EQ (attr
, QCinherit
))
4242 if (SYMBOLP (value
))
4245 for (tail
= value
; CONSP (tail
); tail
= XCDR (tail
))
4246 if (!SYMBOLP (XCAR (tail
)))
4249 LFACE_INHERIT (lface
) = value
;
4251 signal_error ("Invalid face inheritance", value
);
4253 else if (EQ (attr
, QCbold
))
4255 old_value
= LFACE_WEIGHT (lface
);
4256 LFACE_WEIGHT (lface
) = NILP (value
) ? Qnormal
: Qbold
;
4257 font_related_attr_p
= 1;
4259 else if (EQ (attr
, QCitalic
))
4261 old_value
= LFACE_SLANT (lface
);
4262 LFACE_SLANT (lface
) = NILP (value
) ? Qnormal
: Qitalic
;
4263 font_related_attr_p
= 1;
4266 signal_error ("Invalid face attribute name", attr
);
4268 if (font_related_attr_p
4269 && !UNSPECIFIEDP (value
))
4270 /* If a font-related attribute other than QCfont is specified, the
4271 original `font' attribute nor that of default face is useless
4272 to determine a new font. Thus, we set it to nil so that font
4273 selection mechanism doesn't use it. */
4274 LFACE_FONT (lface
) = Qnil
;
4276 /* Changing a named face means that all realized faces depending on
4277 that face are invalid. Since we cannot tell which realized faces
4278 depend on the face, make sure they are all removed. This is done
4279 by incrementing face_change_count. The next call to
4280 init_iterator will then free realized faces. */
4282 && (EQ (attr
, QCfont
)
4283 || NILP (Fequal (old_value
, value
))))
4285 ++face_change_count
;
4286 ++windows_or_buffers_changed
;
4289 if (!UNSPECIFIEDP (value
)
4290 && NILP (Fequal (old_value
, value
)))
4296 if (EQ (face
, Qdefault
))
4298 #ifdef HAVE_WINDOW_SYSTEM
4299 /* Changed font-related attributes of the `default' face are
4300 reflected in changed `font' frame parameters. */
4302 && (font_related_attr_p
|| font_attr_p
)
4303 && lface_fully_specified_p (XVECTOR (lface
)->contents
))
4304 set_font_frame_param (frame
, lface
);
4306 #endif /* HAVE_WINDOW_SYSTEM */
4308 if (EQ (attr
, QCforeground
))
4309 param
= Qforeground_color
;
4310 else if (EQ (attr
, QCbackground
))
4311 param
= Qbackground_color
;
4313 #ifdef HAVE_WINDOW_SYSTEM
4315 else if (EQ (face
, Qscroll_bar
))
4317 /* Changing the colors of `scroll-bar' sets frame parameters
4318 `scroll-bar-foreground' and `scroll-bar-background'. */
4319 if (EQ (attr
, QCforeground
))
4320 param
= Qscroll_bar_foreground
;
4321 else if (EQ (attr
, QCbackground
))
4322 param
= Qscroll_bar_background
;
4324 #endif /* not WINDOWSNT */
4325 else if (EQ (face
, Qborder
))
4327 /* Changing background color of `border' sets frame parameter
4329 if (EQ (attr
, QCbackground
))
4330 param
= Qborder_color
;
4332 else if (EQ (face
, Qcursor
))
4334 /* Changing background color of `cursor' sets frame parameter
4336 if (EQ (attr
, QCbackground
))
4337 param
= Qcursor_color
;
4339 else if (EQ (face
, Qmouse
))
4341 /* Changing background color of `mouse' sets frame parameter
4343 if (EQ (attr
, QCbackground
))
4344 param
= Qmouse_color
;
4346 #endif /* HAVE_WINDOW_SYSTEM */
4347 else if (EQ (face
, Qmenu
))
4349 /* Indicate that we have to update the menu bar when
4350 realizing faces on FRAME. FRAME t change the
4351 default for new frames. We do this by setting
4352 setting the flag in new face caches */
4355 struct frame
*f
= XFRAME (frame
);
4356 if (FRAME_FACE_CACHE (f
) == NULL
)
4357 FRAME_FACE_CACHE (f
) = make_face_cache (f
);
4358 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 1;
4361 menu_face_changed_default
= 1;
4367 /* Update `default-frame-alist', which is used for new frames. */
4369 store_in_alist (&Vdefault_frame_alist
, param
, value
);
4372 /* Update the current frame's parameters. */
4375 cons
= XCAR (Vparam_value_alist
);
4376 XSETCAR (cons
, param
);
4377 XSETCDR (cons
, value
);
4378 Fmodify_frame_parameters (frame
, Vparam_value_alist
);
4387 #ifdef HAVE_WINDOW_SYSTEM
4389 /* Set the `font' frame parameter of FRAME determined from `default'
4390 face attributes LFACE. If a face or fontset name is explicitely
4391 specfied in LFACE, use it as is. Otherwise, determine a font name
4392 from the other font-related atrributes of LFACE. In that case, if
4393 there's no matching font, signals an error. */
4396 set_font_frame_param (frame
, lface
)
4397 Lisp_Object frame
, lface
;
4399 struct frame
*f
= XFRAME (frame
);
4401 if (FRAME_WINDOW_P (f
))
4403 Lisp_Object font_name
;
4406 if (STRINGP (LFACE_FONT (lface
)))
4407 font_name
= LFACE_FONT (lface
);
4410 /* Choose a font name that reflects LFACE's attributes and has
4411 the registry and encoding pattern specified in the default
4412 fontset (3rd arg: -1) for ASCII characters (4th arg: 0). */
4413 font
= choose_face_font (f
, XVECTOR (lface
)->contents
, -1, 0, 0);
4415 error ("No font matches the specified attribute");
4416 font_name
= build_string (font
);
4420 f
->default_face_done_p
= 0;
4421 Fmodify_frame_parameters (frame
, Fcons (Fcons (Qfont
, font_name
), Qnil
));
4426 /* Update the corresponding face when frame parameter PARAM on frame F
4427 has been assigned the value NEW_VALUE. */
4430 update_face_from_frame_parameter (f
, param
, new_value
)
4432 Lisp_Object param
, new_value
;
4436 /* If there are no faces yet, give up. This is the case when called
4437 from Fx_create_frame, and we do the necessary things later in
4438 face-set-after-frame-defaults. */
4439 if (NILP (f
->face_alist
))
4442 /* Changing a named face means that all realized faces depending on
4443 that face are invalid. Since we cannot tell which realized faces
4444 depend on the face, make sure they are all removed. This is done
4445 by incrementing face_change_count. The next call to
4446 init_iterator will then free realized faces. */
4447 ++face_change_count
;
4448 ++windows_or_buffers_changed
;
4450 if (EQ (param
, Qforeground_color
))
4452 lface
= lface_from_face_name (f
, Qdefault
, 1);
4453 LFACE_FOREGROUND (lface
) = (STRINGP (new_value
)
4454 ? new_value
: Qunspecified
);
4455 realize_basic_faces (f
);
4457 else if (EQ (param
, Qbackground_color
))
4461 /* Changing the background color might change the background
4462 mode, so that we have to load new defface specs. Call
4463 frame-update-face-colors to do that. */
4464 XSETFRAME (frame
, f
);
4465 call1 (Qframe_update_face_colors
, frame
);
4467 lface
= lface_from_face_name (f
, Qdefault
, 1);
4468 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4469 ? new_value
: Qunspecified
);
4470 realize_basic_faces (f
);
4472 if (EQ (param
, Qborder_color
))
4474 lface
= lface_from_face_name (f
, Qborder
, 1);
4475 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4476 ? new_value
: Qunspecified
);
4478 else if (EQ (param
, Qcursor_color
))
4480 lface
= lface_from_face_name (f
, Qcursor
, 1);
4481 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4482 ? new_value
: Qunspecified
);
4484 else if (EQ (param
, Qmouse_color
))
4486 lface
= lface_from_face_name (f
, Qmouse
, 1);
4487 LFACE_BACKGROUND (lface
) = (STRINGP (new_value
)
4488 ? new_value
: Qunspecified
);
4493 /* Get the value of X resource RESOURCE, class CLASS for the display
4494 of frame FRAME. This is here because ordinary `x-get-resource'
4495 doesn't take a frame argument. */
4497 DEFUN ("internal-face-x-get-resource", Finternal_face_x_get_resource
,
4498 Sinternal_face_x_get_resource
, 3, 3, 0, doc
: /* */)
4499 (resource
, class, frame
)
4500 Lisp_Object resource
, class, frame
;
4502 Lisp_Object value
= Qnil
;
4503 CHECK_STRING (resource
);
4504 CHECK_STRING (class);
4505 CHECK_LIVE_FRAME (frame
);
4507 value
= display_x_get_resource (FRAME_X_DISPLAY_INFO (XFRAME (frame
)),
4508 resource
, class, Qnil
, Qnil
);
4514 /* Return resource string VALUE as a boolean value, i.e. nil, or t.
4515 If VALUE is "on" or "true", return t. If VALUE is "off" or
4516 "false", return nil. Otherwise, if SIGNAL_P is non-zero, signal an
4517 error; if SIGNAL_P is zero, return 0. */
4520 face_boolean_x_resource_value (value
, signal_p
)
4524 Lisp_Object result
= make_number (0);
4526 xassert (STRINGP (value
));
4528 if (xstricmp (SDATA (value
), "on") == 0
4529 || xstricmp (SDATA (value
), "true") == 0)
4531 else if (xstricmp (SDATA (value
), "off") == 0
4532 || xstricmp (SDATA (value
), "false") == 0)
4534 else if (xstricmp (SDATA (value
), "unspecified") == 0)
4535 result
= Qunspecified
;
4537 signal_error ("Invalid face attribute value from X resource", value
);
4543 DEFUN ("internal-set-lisp-face-attribute-from-resource",
4544 Finternal_set_lisp_face_attribute_from_resource
,
4545 Sinternal_set_lisp_face_attribute_from_resource
,
4546 3, 4, 0, doc
: /* */)
4547 (face
, attr
, value
, frame
)
4548 Lisp_Object face
, attr
, value
, frame
;
4550 CHECK_SYMBOL (face
);
4551 CHECK_SYMBOL (attr
);
4552 CHECK_STRING (value
);
4554 if (xstricmp (SDATA (value
), "unspecified") == 0)
4555 value
= Qunspecified
;
4556 else if (EQ (attr
, QCheight
))
4558 value
= Fstring_to_number (value
, make_number (10));
4559 if (XINT (value
) <= 0)
4560 signal_error ("Invalid face height from X resource", value
);
4562 else if (EQ (attr
, QCbold
) || EQ (attr
, QCitalic
))
4563 value
= face_boolean_x_resource_value (value
, 1);
4564 else if (EQ (attr
, QCweight
) || EQ (attr
, QCslant
) || EQ (attr
, QCwidth
))
4565 value
= intern (SDATA (value
));
4566 else if (EQ (attr
, QCreverse_video
) || EQ (attr
, QCinverse_video
))
4567 value
= face_boolean_x_resource_value (value
, 1);
4568 else if (EQ (attr
, QCunderline
)
4569 || EQ (attr
, QCoverline
)
4570 || EQ (attr
, QCstrike_through
))
4572 Lisp_Object boolean_value
;
4574 /* If the result of face_boolean_x_resource_value is t or nil,
4575 VALUE does NOT specify a color. */
4576 boolean_value
= face_boolean_x_resource_value (value
, 0);
4577 if (SYMBOLP (boolean_value
))
4578 value
= boolean_value
;
4580 else if (EQ (attr
, QCbox
))
4581 value
= Fcar (Fread_from_string (value
, Qnil
, Qnil
));
4583 return Finternal_set_lisp_face_attribute (face
, attr
, value
, frame
);
4586 #endif /* HAVE_WINDOW_SYSTEM */
4589 /***********************************************************************
4591 ***********************************************************************/
4593 #if defined HAVE_X_WINDOWS && defined USE_X_TOOLKIT
4595 /* Make menus on frame F appear as specified by the `menu' face. */
4598 x_update_menu_appearance (f
)
4601 struct x_display_info
*dpyinfo
= FRAME_X_DISPLAY_INFO (f
);
4605 && (rdb
= XrmGetDatabase (FRAME_X_DISPLAY (f
)),
4609 Lisp_Object lface
= lface_from_face_name (f
, Qmenu
, 1);
4610 struct face
*face
= FACE_FROM_ID (f
, MENU_FACE_ID
);
4611 const char *myname
= SDATA (Vx_resource_name
);
4614 const char *popup_path
= "popup_menu";
4616 const char *popup_path
= "menu.popup";
4619 if (STRINGP (LFACE_FOREGROUND (lface
)))
4621 sprintf (line
, "%s.%s*foreground: %s",
4623 SDATA (LFACE_FOREGROUND (lface
)));
4624 XrmPutLineResource (&rdb
, line
);
4625 sprintf (line
, "%s.pane.menubar*foreground: %s",
4626 myname
, SDATA (LFACE_FOREGROUND (lface
)));
4627 XrmPutLineResource (&rdb
, line
);
4631 if (STRINGP (LFACE_BACKGROUND (lface
)))
4633 sprintf (line
, "%s.%s*background: %s",
4635 SDATA (LFACE_BACKGROUND (lface
)));
4636 XrmPutLineResource (&rdb
, line
);
4637 sprintf (line
, "%s.pane.menubar*background: %s",
4638 myname
, SDATA (LFACE_BACKGROUND (lface
)));
4639 XrmPutLineResource (&rdb
, line
);
4644 && (!UNSPECIFIEDP (LFACE_FAMILY (lface
))
4645 || !UNSPECIFIEDP (LFACE_SWIDTH (lface
))
4646 || !UNSPECIFIEDP (LFACE_AVGWIDTH (lface
))
4647 || !UNSPECIFIEDP (LFACE_WEIGHT (lface
))
4648 || !UNSPECIFIEDP (LFACE_SLANT (lface
))
4649 || !UNSPECIFIEDP (LFACE_HEIGHT (lface
))))
4652 const char *suffix
= "List";
4654 const char *suffix
= "";
4656 sprintf (line
, "%s.pane.menubar*font%s: %s",
4657 myname
, suffix
, face
->font_name
);
4658 XrmPutLineResource (&rdb
, line
);
4659 sprintf (line
, "%s.%s*font%s: %s",
4660 myname
, popup_path
, suffix
, face
->font_name
);
4661 XrmPutLineResource (&rdb
, line
);
4665 if (changed_p
&& f
->output_data
.x
->menubar_widget
)
4666 free_frame_menubar (f
);
4670 #endif /* HAVE_X_WINDOWS && USE_X_TOOLKIT */
4673 DEFUN ("face-attribute-relative-p", Fface_attribute_relative_p
,
4674 Sface_attribute_relative_p
,
4676 doc
: /* Return non-nil if face ATTRIBUTE VALUE is relative. */)
4678 Lisp_Object attribute
, value
;
4680 if (EQ (value
, Qunspecified
))
4682 else if (EQ (attribute
, QCheight
))
4683 return INTEGERP (value
) ? Qnil
: Qt
;
4688 DEFUN ("merge-face-attribute", Fmerge_face_attribute
, Smerge_face_attribute
,
4690 doc
: /* Return face ATTRIBUTE VALUE1 merged with VALUE2.
4691 If VALUE1 or VALUE2 are absolute (see `face-attribute-relative-p'), then
4692 the result will be absolute, otherwise it will be relative. */)
4693 (attribute
, value1
, value2
)
4694 Lisp_Object attribute
, value1
, value2
;
4696 if (EQ (value1
, Qunspecified
))
4698 else if (EQ (attribute
, QCheight
))
4699 return merge_face_heights (value1
, value2
, value1
, Qnil
);
4705 DEFUN ("internal-get-lisp-face-attribute", Finternal_get_lisp_face_attribute
,
4706 Sinternal_get_lisp_face_attribute
,
4708 doc
: /* Return face attribute KEYWORD of face SYMBOL.
4709 If SYMBOL does not name a valid Lisp face or KEYWORD isn't a valid
4710 face attribute name, signal an error.
4711 If the optional argument FRAME is given, report on face FACE in that
4712 frame. If FRAME is t, report on the defaults for face FACE (for new
4713 frames). If FRAME is omitted or nil, use the selected frame. */)
4714 (symbol
, keyword
, frame
)
4715 Lisp_Object symbol
, keyword
, frame
;
4717 Lisp_Object lface
, value
= Qnil
;
4719 CHECK_SYMBOL (symbol
);
4720 CHECK_SYMBOL (keyword
);
4723 lface
= lface_from_face_name (NULL
, symbol
, 1);
4727 frame
= selected_frame
;
4728 CHECK_LIVE_FRAME (frame
);
4729 lface
= lface_from_face_name (XFRAME (frame
), symbol
, 1);
4732 if (EQ (keyword
, QCfamily
))
4733 value
= LFACE_FAMILY (lface
);
4734 else if (EQ (keyword
, QCheight
))
4735 value
= LFACE_HEIGHT (lface
);
4736 else if (EQ (keyword
, QCweight
))
4737 value
= LFACE_WEIGHT (lface
);
4738 else if (EQ (keyword
, QCslant
))
4739 value
= LFACE_SLANT (lface
);
4740 else if (EQ (keyword
, QCunderline
))
4741 value
= LFACE_UNDERLINE (lface
);
4742 else if (EQ (keyword
, QCoverline
))
4743 value
= LFACE_OVERLINE (lface
);
4744 else if (EQ (keyword
, QCstrike_through
))
4745 value
= LFACE_STRIKE_THROUGH (lface
);
4746 else if (EQ (keyword
, QCbox
))
4747 value
= LFACE_BOX (lface
);
4748 else if (EQ (keyword
, QCinverse_video
)
4749 || EQ (keyword
, QCreverse_video
))
4750 value
= LFACE_INVERSE (lface
);
4751 else if (EQ (keyword
, QCforeground
))
4752 value
= LFACE_FOREGROUND (lface
);
4753 else if (EQ (keyword
, QCbackground
))
4754 value
= LFACE_BACKGROUND (lface
);
4755 else if (EQ (keyword
, QCstipple
))
4756 value
= LFACE_STIPPLE (lface
);
4757 else if (EQ (keyword
, QCwidth
))
4758 value
= LFACE_SWIDTH (lface
);
4759 else if (EQ (keyword
, QCinherit
))
4760 value
= LFACE_INHERIT (lface
);
4761 else if (EQ (keyword
, QCfont
))
4762 value
= LFACE_FONT (lface
);
4764 signal_error ("Invalid face attribute name", keyword
);
4770 DEFUN ("internal-lisp-face-attribute-values",
4771 Finternal_lisp_face_attribute_values
,
4772 Sinternal_lisp_face_attribute_values
, 1, 1, 0,
4773 doc
: /* Return a list of valid discrete values for face attribute ATTR.
4774 Value is nil if ATTR doesn't have a discrete set of valid values. */)
4778 Lisp_Object result
= Qnil
;
4780 CHECK_SYMBOL (attr
);
4782 if (EQ (attr
, QCweight
)
4783 || EQ (attr
, QCslant
)
4784 || EQ (attr
, QCwidth
))
4786 /* Extract permissible symbols from tables. */
4787 struct table_entry
*table
;
4790 if (EQ (attr
, QCweight
))
4791 table
= weight_table
, dim
= DIM (weight_table
);
4792 else if (EQ (attr
, QCslant
))
4793 table
= slant_table
, dim
= DIM (slant_table
);
4795 table
= swidth_table
, dim
= DIM (swidth_table
);
4797 for (i
= 0; i
< dim
; ++i
)
4799 Lisp_Object symbol
= *table
[i
].symbol
;
4800 Lisp_Object tail
= result
;
4803 && !EQ (XCAR (tail
), symbol
))
4807 result
= Fcons (symbol
, result
);
4810 else if (EQ (attr
, QCunderline
))
4811 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4812 else if (EQ (attr
, QCoverline
))
4813 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4814 else if (EQ (attr
, QCstrike_through
))
4815 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4816 else if (EQ (attr
, QCinverse_video
) || EQ (attr
, QCreverse_video
))
4817 result
= Fcons (Qt
, Fcons (Qnil
, Qnil
));
4823 DEFUN ("internal-merge-in-global-face", Finternal_merge_in_global_face
,
4824 Sinternal_merge_in_global_face
, 2, 2, 0,
4825 doc
: /* Add attributes from frame-default definition of FACE to FACE on FRAME.
4826 Default face attributes override any local face attributes. */)
4828 Lisp_Object face
, frame
;
4831 Lisp_Object global_lface
, local_lface
, *gvec
, *lvec
;
4833 CHECK_LIVE_FRAME (frame
);
4834 global_lface
= lface_from_face_name (NULL
, face
, 1);
4835 local_lface
= lface_from_face_name (XFRAME (frame
), face
, 0);
4836 if (NILP (local_lface
))
4837 local_lface
= Finternal_make_lisp_face (face
, frame
);
4839 /* Make every specified global attribute override the local one.
4840 BEWARE!! This is only used from `face-set-after-frame-default' where
4841 the local frame is defined from default specs in `face-defface-spec'
4842 and those should be overridden by global settings. Hence the strange
4843 "global before local" priority. */
4844 lvec
= XVECTOR (local_lface
)->contents
;
4845 gvec
= XVECTOR (global_lface
)->contents
;
4846 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
4847 if (! UNSPECIFIEDP (gvec
[i
]))
4854 /* The following function is implemented for compatibility with 20.2.
4855 The function is used in x-resolve-fonts when it is asked to
4856 return fonts with the same size as the font of a face. This is
4857 done in fontset.el. */
4859 DEFUN ("face-font", Fface_font
, Sface_font
, 1, 2, 0,
4860 doc
: /* Return the font name of face FACE, or nil if it is unspecified.
4861 If the optional argument FRAME is given, report on face FACE in that frame.
4862 If FRAME is t, report on the defaults for face FACE (for new frames).
4863 The font default for a face is either nil, or a list
4864 of the form (bold), (italic) or (bold italic).
4865 If FRAME is omitted or nil, use the selected frame. */)
4867 Lisp_Object face
, frame
;
4871 Lisp_Object result
= Qnil
;
4872 Lisp_Object lface
= lface_from_face_name (NULL
, face
, 1);
4874 if (!UNSPECIFIEDP (LFACE_WEIGHT (lface
))
4875 && !EQ (LFACE_WEIGHT (lface
), Qnormal
))
4876 result
= Fcons (Qbold
, result
);
4878 if (!UNSPECIFIEDP (LFACE_SLANT (lface
))
4879 && !EQ (LFACE_SLANT (lface
), Qnormal
))
4880 result
= Fcons (Qitalic
, result
);
4886 struct frame
*f
= frame_or_selected_frame (frame
, 1);
4887 int face_id
= lookup_named_face (f
, face
, 0);
4888 struct face
*face
= FACE_FROM_ID (f
, face_id
);
4889 return face
? build_string (face
->font_name
) : Qnil
;
4894 /* Compare face vectors V1 and V2 for equality. Value is non-zero if
4895 all attributes are `equal'. Tries to be fast because this function
4896 is called quite often. */
4899 lface_equal_p (v1
, v2
)
4900 Lisp_Object
*v1
, *v2
;
4904 for (i
= 1; i
< LFACE_VECTOR_SIZE
&& equal_p
; ++i
)
4906 Lisp_Object a
= v1
[i
];
4907 Lisp_Object b
= v2
[i
];
4909 /* Type can differ, e.g. when one attribute is unspecified, i.e. nil,
4910 and the other is specified. */
4911 equal_p
= XTYPE (a
) == XTYPE (b
);
4920 equal_p
= ((SBYTES (a
)
4922 && bcmp (SDATA (a
), SDATA (b
),
4932 equal_p
= !NILP (Fequal (a
, b
));
4942 DEFUN ("internal-lisp-face-equal-p", Finternal_lisp_face_equal_p
,
4943 Sinternal_lisp_face_equal_p
, 2, 3, 0,
4944 doc
: /* True if FACE1 and FACE2 are equal.
4945 If the optional argument FRAME is given, report on face FACE in that frame.
4946 If FRAME is t, report on the defaults for face FACE (for new frames).
4947 If FRAME is omitted or nil, use the selected frame. */)
4948 (face1
, face2
, frame
)
4949 Lisp_Object face1
, face2
, frame
;
4953 Lisp_Object lface1
, lface2
;
4958 /* Don't use check_x_frame here because this function is called
4959 before X frames exist. At that time, if FRAME is nil,
4960 selected_frame will be used which is the frame dumped with
4961 Emacs. That frame is not an X frame. */
4962 f
= frame_or_selected_frame (frame
, 2);
4964 lface1
= lface_from_face_name (NULL
, face1
, 1);
4965 lface2
= lface_from_face_name (NULL
, face2
, 1);
4966 equal_p
= lface_equal_p (XVECTOR (lface1
)->contents
,
4967 XVECTOR (lface2
)->contents
);
4968 return equal_p
? Qt
: Qnil
;
4972 DEFUN ("internal-lisp-face-empty-p", Finternal_lisp_face_empty_p
,
4973 Sinternal_lisp_face_empty_p
, 1, 2, 0,
4974 doc
: /* True if FACE has no attribute specified.
4975 If the optional argument FRAME is given, report on face FACE in that frame.
4976 If FRAME is t, report on the defaults for face FACE (for new frames).
4977 If FRAME is omitted or nil, use the selected frame. */)
4979 Lisp_Object face
, frame
;
4986 frame
= selected_frame
;
4987 CHECK_LIVE_FRAME (frame
);
4991 lface
= lface_from_face_name (NULL
, face
, 1);
4993 lface
= lface_from_face_name (f
, face
, 1);
4995 for (i
= 1; i
< LFACE_VECTOR_SIZE
; ++i
)
4996 if (!UNSPECIFIEDP (AREF (lface
, i
)))
4999 return i
== LFACE_VECTOR_SIZE
? Qt
: Qnil
;
5003 DEFUN ("frame-face-alist", Fframe_face_alist
, Sframe_face_alist
,
5005 doc
: /* Return an alist of frame-local faces defined on FRAME.
5006 For internal use only. */)
5010 struct frame
*f
= frame_or_selected_frame (frame
, 0);
5011 return f
->face_alist
;
5015 /* Return a hash code for Lisp string STRING with case ignored. Used
5016 below in computing a hash value for a Lisp face. */
5018 static INLINE
unsigned
5019 hash_string_case_insensitive (string
)
5022 const unsigned char *s
;
5024 xassert (STRINGP (string
));
5025 for (s
= SDATA (string
); *s
; ++s
)
5026 hash
= (hash
<< 1) ^ tolower (*s
);
5031 /* Return a hash code for face attribute vector V. */
5033 static INLINE
unsigned
5037 return (hash_string_case_insensitive (v
[LFACE_FAMILY_INDEX
])
5038 ^ hash_string_case_insensitive (v
[LFACE_FOREGROUND_INDEX
])
5039 ^ hash_string_case_insensitive (v
[LFACE_BACKGROUND_INDEX
])
5040 ^ XFASTINT (v
[LFACE_WEIGHT_INDEX
])
5041 ^ XFASTINT (v
[LFACE_SLANT_INDEX
])
5042 ^ XFASTINT (v
[LFACE_SWIDTH_INDEX
])
5043 ^ XFASTINT (v
[LFACE_HEIGHT_INDEX
]));
5047 /* Return non-zero if LFACE1 and LFACE2 specify the same font (without
5048 considering charsets/registries). They do if they specify the same
5049 family, point size, weight, width, slant, and fontset. Both LFACE1
5050 and LFACE2 must be fully-specified. */
5053 lface_same_font_attributes_p (lface1
, lface2
)
5054 Lisp_Object
*lface1
, *lface2
;
5056 xassert (lface_fully_specified_p (lface1
)
5057 && lface_fully_specified_p (lface2
));
5058 return (xstricmp (SDATA (lface1
[LFACE_FAMILY_INDEX
]),
5059 SDATA (lface2
[LFACE_FAMILY_INDEX
])) == 0
5060 && EQ (lface1
[LFACE_HEIGHT_INDEX
], lface2
[LFACE_HEIGHT_INDEX
])
5061 && EQ (lface1
[LFACE_SWIDTH_INDEX
], lface2
[LFACE_SWIDTH_INDEX
])
5062 && EQ (lface1
[LFACE_AVGWIDTH_INDEX
], lface2
[LFACE_AVGWIDTH_INDEX
])
5063 && EQ (lface1
[LFACE_WEIGHT_INDEX
], lface2
[LFACE_WEIGHT_INDEX
])
5064 && EQ (lface1
[LFACE_SLANT_INDEX
], lface2
[LFACE_SLANT_INDEX
])
5065 && (EQ (lface1
[LFACE_FONT_INDEX
], lface2
[LFACE_FONT_INDEX
])
5066 || (STRINGP (lface1
[LFACE_FONT_INDEX
])
5067 && STRINGP (lface2
[LFACE_FONT_INDEX
])
5068 && xstricmp (SDATA (lface1
[LFACE_FONT_INDEX
]),
5069 SDATA (lface2
[LFACE_FONT_INDEX
])))));
5074 /***********************************************************************
5076 ***********************************************************************/
5078 /* Allocate and return a new realized face for Lisp face attribute
5081 static struct face
*
5082 make_realized_face (attr
)
5085 struct face
*face
= (struct face
*) xmalloc (sizeof *face
);
5086 bzero (face
, sizeof *face
);
5087 face
->ascii_face
= face
;
5088 bcopy (attr
, face
->lface
, sizeof face
->lface
);
5093 /* Free realized face FACE, including its X resources. FACE may
5097 free_realized_face (f
, face
)
5103 #ifdef HAVE_WINDOW_SYSTEM
5104 if (FRAME_WINDOW_P (f
))
5106 /* Free fontset of FACE if it is ASCII face. */
5107 if (face
->fontset
>= 0 && face
== face
->ascii_face
)
5108 free_face_fontset (f
, face
);
5111 x_free_gc (f
, face
->gc
);
5115 free_face_colors (f
, face
);
5116 x_destroy_bitmap (f
, face
->stipple
);
5118 #endif /* HAVE_WINDOW_SYSTEM */
5125 /* Prepare face FACE for subsequent display on frame F. This
5126 allocated GCs if they haven't been allocated yet or have been freed
5127 by clearing the face cache. */
5130 prepare_face_for_display (f
, face
)
5134 #ifdef HAVE_WINDOW_SYSTEM
5135 xassert (FRAME_WINDOW_P (f
));
5140 unsigned long mask
= GCForeground
| GCBackground
| GCGraphicsExposures
;
5142 xgcv
.foreground
= face
->foreground
;
5143 xgcv
.background
= face
->background
;
5144 #ifdef HAVE_X_WINDOWS
5145 xgcv
.graphics_exposures
= False
;
5147 /* The font of FACE may be null if we couldn't load it. */
5150 #ifdef HAVE_X_WINDOWS
5151 xgcv
.font
= face
->font
->fid
;
5154 xgcv
.font
= face
->font
;
5157 xgcv
.font
= face
->font
;
5163 #ifdef HAVE_X_WINDOWS
5166 xgcv
.fill_style
= FillOpaqueStippled
;
5167 xgcv
.stipple
= x_bitmap_pixmap (f
, face
->stipple
);
5168 mask
|= GCFillStyle
| GCStipple
;
5171 face
->gc
= x_create_gc (f
, mask
, &xgcv
);
5174 #endif /* HAVE_WINDOW_SYSTEM */
5178 /* Returns the `distance' between the colors X and Y. */
5181 color_distance (x
, y
)
5184 /* This formula is from a paper title `Colour metric' by Thiadmer Riemersma.
5185 Quoting from that paper:
5187 This formula has results that are very close to L*u*v* (with the
5188 modified lightness curve) and, more importantly, it is a more even
5189 algorithm: it does not have a range of colours where it suddenly
5190 gives far from optimal results.
5192 See <http://www.compuphase.com/cmetric.htm> for more info. */
5194 long r
= (x
->red
- y
->red
) >> 8;
5195 long g
= (x
->green
- y
->green
) >> 8;
5196 long b
= (x
->blue
- y
->blue
) >> 8;
5197 long r_mean
= (x
->red
+ y
->red
) >> 9;
5200 (((512 + r_mean
) * r
* r
) >> 8)
5202 + (((767 - r_mean
) * b
* b
) >> 8);
5206 DEFUN ("color-distance", Fcolor_distance
, Scolor_distance
, 2, 3, 0,
5207 doc
: /* Return an integer distance between COLOR1 and COLOR2 on FRAME.
5208 COLOR1 and COLOR2 may be either strings containing the color name,
5209 or lists of the form (RED GREEN BLUE).
5210 If FRAME is unspecified or nil, the current frame is used. */)
5211 (color1
, color2
, frame
)
5212 Lisp_Object color1
, color2
, frame
;
5215 XColor cdef1
, cdef2
;
5218 frame
= selected_frame
;
5219 CHECK_LIVE_FRAME (frame
);
5222 if ((CONSP (color1
) && !parse_rgb_list (color1
, &cdef1
))
5223 || !STRINGP (color1
)
5224 || !defined_color (f
, SDATA (color1
), &cdef1
, 0))
5225 signal_error ("Invalid color", color1
);
5226 if ((CONSP (color2
) && !parse_rgb_list (color2
, &cdef2
))
5227 || !STRINGP (color2
)
5228 || !defined_color (f
, SDATA (color2
), &cdef2
, 0))
5229 signal_error ("Invalid color", color2
);
5231 return make_number (color_distance (&cdef1
, &cdef2
));
5235 /***********************************************************************
5236 Face capability testing for ttys
5237 ***********************************************************************/
5240 /* If the distance (as returned by color_distance) between two colors is
5241 less than this, then they are considered the same, for determining
5242 whether a color is supported or not. The range of values is 0-65535. */
5244 #define TTY_SAME_COLOR_THRESHOLD 10000
5247 DEFUN ("tty-supports-face-attributes-p",
5248 Ftty_supports_face_attributes_p
, Stty_supports_face_attributes_p
,
5250 doc
: /* Return non-nil if all the face attributes in ATTRIBUTES are supported.
5251 The optional argument FRAME is the frame on which to test; if it is nil
5252 or unspecified, then the current frame is used. If FRAME is not a tty
5253 frame, then nil is returned.
5255 The definition of `supported' is somewhat heuristic, but basically means
5256 that a face containing all the attributes in ATTRIBUTES, when merged
5257 with the default face for display, can be represented in a way that's
5259 \(1) different in appearance than the default face, and
5260 \(2) `close in spirit' to what the attributes specify, if not exact.
5262 Point (2) implies that a `:weight black' attribute will be satisified
5263 by any terminal that can display bold, and a `:foreground "yellow"' as
5264 long as the terminal can display a yellowish color, but `:slant italic'
5265 will _not_ be satisified by the tty display code's automatic
5266 substitution of a `dim' face for italic. */)
5268 Lisp_Object attributes
, frame
;
5272 Lisp_Object val
, fg
, bg
;
5273 XColor fg_tty_color
, fg_std_color
;
5274 XColor bg_tty_color
, bg_std_color
;
5275 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5276 unsigned test_caps
= 0;
5279 frame
= selected_frame
;
5280 CHECK_LIVE_FRAME (frame
);
5283 for (i
= 0; i
< LFACE_VECTOR_SIZE
; i
++)
5284 attrs
[i
] = Qunspecified
;
5285 merge_face_vector_with_property (f
, attrs
, attributes
);
5287 /* This function only works on ttys. */
5288 if (!FRAME_TERMCAP_P (f
) && !FRAME_MSDOS_P (f
))
5291 /* First check some easy-to-check stuff; ttys support none of the
5292 following attributes, so we can just return nil if any are requested. */
5295 val
= attrs
[LFACE_STIPPLE_INDEX
];
5296 if (!UNSPECIFIEDP (val
) && !NILP (val
))
5300 val
= attrs
[LFACE_HEIGHT_INDEX
];
5301 if (!UNSPECIFIEDP (val
) && !NILP (val
))
5305 val
= attrs
[LFACE_SWIDTH_INDEX
];
5306 if (!UNSPECIFIEDP (val
) && !NILP (val
)
5307 && face_numeric_swidth (val
) != XLFD_SWIDTH_MEDIUM
)
5311 val
= attrs
[LFACE_OVERLINE_INDEX
];
5312 if (!UNSPECIFIEDP (val
) && !NILP (val
))
5315 /* strike-through */
5316 val
= attrs
[LFACE_STRIKE_THROUGH_INDEX
];
5317 if (!UNSPECIFIEDP (val
) && !NILP (val
))
5321 val
= attrs
[LFACE_BOX_INDEX
];
5322 if (!UNSPECIFIEDP (val
) && !NILP (val
))
5325 /* slant (italics/oblique); We consider any non-default value
5326 unsupportable on ttys, even though the face code actually `fakes'
5327 them using a dim attribute if possible. This is because the faked
5328 result is too different from what the face specifies. */
5329 val
= attrs
[LFACE_SLANT_INDEX
];
5330 if (!UNSPECIFIEDP (val
) && !NILP (val
)
5331 && face_numeric_slant (val
) != XLFD_SLANT_ROMAN
)
5335 /* Test for terminal `capabilities' (non-color character attributes). */
5337 /* font weight (bold/dim) */
5338 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
5341 if (weight
> XLFD_WEIGHT_MEDIUM
)
5342 test_caps
= TTY_CAP_BOLD
;
5343 else if (weight
< XLFD_WEIGHT_MEDIUM
)
5344 test_caps
= TTY_CAP_DIM
;
5348 val
= attrs
[LFACE_UNDERLINE_INDEX
];
5349 if (!UNSPECIFIEDP (val
) && !NILP (val
))
5352 return Qnil
; /* ttys don't support colored underlines */
5354 test_caps
|= TTY_CAP_UNDERLINE
;
5358 val
= attrs
[LFACE_INVERSE_INDEX
];
5359 if (!UNSPECIFIEDP (val
) && !NILP (val
))
5360 test_caps
|= TTY_CAP_INVERSE
;
5363 /* Color testing. */
5365 /* Default the color indices in FG_TTY_COLOR and BG_TTY_COLOR, since
5366 we use them when calling `tty_capable_p' below, even if the face
5367 specifies no colors. */
5368 fg_tty_color
.pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
5369 bg_tty_color
.pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
5371 /* Check if foreground color is close enough. */
5372 fg
= attrs
[LFACE_FOREGROUND_INDEX
];
5375 if (! tty_lookup_color (f
, fg
, &fg_tty_color
, &fg_std_color
))
5377 else if (color_distance (&fg_tty_color
, &fg_std_color
)
5378 > TTY_SAME_COLOR_THRESHOLD
)
5382 /* Check if background color is close enough. */
5383 bg
= attrs
[LFACE_BACKGROUND_INDEX
];
5386 if (! tty_lookup_color (f
, bg
, &bg_tty_color
, &bg_std_color
))
5388 else if (color_distance (&bg_tty_color
, &bg_std_color
)
5389 > TTY_SAME_COLOR_THRESHOLD
)
5393 /* If both foreground and background are requested, see if the
5394 distance between them is OK. We just check to see if the distance
5395 between the tty's foreground and background is close enough to the
5396 distance between the standard foreground and background. */
5397 if (STRINGP (fg
) && STRINGP (bg
))
5400 = (color_distance (&fg_std_color
, &bg_std_color
)
5401 - color_distance (&fg_tty_color
, &bg_tty_color
));
5402 if (delta_delta
> TTY_SAME_COLOR_THRESHOLD
5403 || delta_delta
< -TTY_SAME_COLOR_THRESHOLD
)
5408 /* See if the capabilities we selected above are supported, with the
5410 if (test_caps
!= 0 &&
5411 ! tty_capable_p (FRAME_TTY (f
), test_caps
, fg_tty_color
.pixel
, bg_tty_color
.pixel
))
5415 /* Hmmm, everything checks out, this terminal must support this face. */
5421 /***********************************************************************
5423 ***********************************************************************/
5425 /* Return a new face cache for frame F. */
5427 static struct face_cache
*
5431 struct face_cache
*c
;
5434 c
= (struct face_cache
*) xmalloc (sizeof *c
);
5435 bzero (c
, sizeof *c
);
5436 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5437 c
->buckets
= (struct face
**) xmalloc (size
);
5438 bzero (c
->buckets
, size
);
5440 c
->faces_by_id
= (struct face
**) xmalloc (c
->size
* sizeof *c
->faces_by_id
);
5442 c
->menu_face_changed_p
= menu_face_changed_default
;
5447 /* Clear out all graphics contexts for all realized faces, except for
5448 the basic faces. This should be done from time to time just to avoid
5449 keeping too many graphics contexts that are no longer needed. */
5453 struct face_cache
*c
;
5455 if (c
&& FRAME_WINDOW_P (c
->f
))
5457 #ifdef HAVE_WINDOW_SYSTEM
5459 for (i
= BASIC_FACE_ID_SENTINEL
; i
< c
->used
; ++i
)
5461 struct face
*face
= c
->faces_by_id
[i
];
5462 if (face
&& face
->gc
)
5464 x_free_gc (c
->f
, face
->gc
);
5468 #endif /* HAVE_WINDOW_SYSTEM */
5473 /* Free all realized faces in face cache C, including basic faces. C
5474 may be null. If faces are freed, make sure the frame's current
5475 matrix is marked invalid, so that a display caused by an expose
5476 event doesn't try to use faces we destroyed. */
5479 free_realized_faces (c
)
5480 struct face_cache
*c
;
5485 struct frame
*f
= c
->f
;
5487 /* We must block input here because we can't process X events
5488 safely while only some faces are freed, or when the frame's
5489 current matrix still references freed faces. */
5492 for (i
= 0; i
< c
->used
; ++i
)
5494 free_realized_face (f
, c
->faces_by_id
[i
]);
5495 c
->faces_by_id
[i
] = NULL
;
5499 size
= FACE_CACHE_BUCKETS_SIZE
* sizeof *c
->buckets
;
5500 bzero (c
->buckets
, size
);
5502 /* Must do a thorough redisplay the next time. Mark current
5503 matrices as invalid because they will reference faces freed
5504 above. This function is also called when a frame is
5505 destroyed. In this case, the root window of F is nil. */
5506 if (WINDOWP (f
->root_window
))
5508 clear_current_matrices (f
);
5509 ++windows_or_buffers_changed
;
5517 /* Free all faces realized for multibyte characters on frame F that
5521 free_realized_multibyte_face (f
, fontset
)
5525 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5529 /* We must block input here because we can't process X events safely
5530 while only some faces are freed, or when the frame's current
5531 matrix still references freed faces. */
5534 for (i
= 0; i
< cache
->used
; i
++)
5536 face
= cache
->faces_by_id
[i
];
5538 && face
!= face
->ascii_face
5539 && face
->fontset
== fontset
)
5541 uncache_face (cache
, face
);
5542 free_realized_face (f
, face
);
5546 /* Must do a thorough redisplay the next time. Mark current
5547 matrices as invalid because they will reference faces freed
5548 above. This function is also called when a frame is destroyed.
5549 In this case, the root window of F is nil. */
5550 if (WINDOWP (f
->root_window
))
5552 clear_current_matrices (f
);
5553 ++windows_or_buffers_changed
;
5560 /* Free all realized faces on FRAME or on all frames if FRAME is nil.
5561 This is done after attributes of a named face have been changed,
5562 because we can't tell which realized faces depend on that face. */
5565 free_all_realized_faces (frame
)
5571 FOR_EACH_FRAME (rest
, frame
)
5572 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5575 free_realized_faces (FRAME_FACE_CACHE (XFRAME (frame
)));
5579 /* Free face cache C and faces in it, including their X resources. */
5583 struct face_cache
*c
;
5587 free_realized_faces (c
);
5589 xfree (c
->faces_by_id
);
5595 /* Cache realized face FACE in face cache C. HASH is the hash value
5596 of FACE. If FACE->fontset >= 0, add the new face to the end of the
5597 collision list of the face hash table of C. This is done because
5598 otherwise lookup_face would find FACE for every character, even if
5599 faces with the same attributes but for specific characters exist. */
5602 cache_face (c
, face
, hash
)
5603 struct face_cache
*c
;
5607 int i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5611 if (face
->fontset
>= 0)
5613 struct face
*last
= c
->buckets
[i
];
5624 c
->buckets
[i
] = face
;
5625 face
->prev
= face
->next
= NULL
;
5631 face
->next
= c
->buckets
[i
];
5633 face
->next
->prev
= face
;
5634 c
->buckets
[i
] = face
;
5637 /* Find a free slot in C->faces_by_id and use the index of the free
5638 slot as FACE->id. */
5639 for (i
= 0; i
< c
->used
; ++i
)
5640 if (c
->faces_by_id
[i
] == NULL
)
5644 /* Maybe enlarge C->faces_by_id. */
5647 if (c
->used
== c
->size
)
5650 new_size
= min (2 * c
->size
, MAX_FACE_ID
);
5651 if (new_size
== c
->size
)
5652 abort (); /* Alternatives? ++kfs */
5653 sz
= new_size
* sizeof *c
->faces_by_id
;
5654 c
->faces_by_id
= (struct face
**) xrealloc (c
->faces_by_id
, sz
);
5661 /* Check that FACE got a unique id. */
5666 for (j
= n
= 0; j
< FACE_CACHE_BUCKETS_SIZE
; ++j
)
5667 for (face
= c
->buckets
[j
]; face
; face
= face
->next
)
5673 #endif /* GLYPH_DEBUG */
5675 c
->faces_by_id
[i
] = face
;
5679 /* Remove face FACE from cache C. */
5682 uncache_face (c
, face
)
5683 struct face_cache
*c
;
5686 int i
= face
->hash
% FACE_CACHE_BUCKETS_SIZE
;
5689 face
->prev
->next
= face
->next
;
5691 c
->buckets
[i
] = face
->next
;
5694 face
->next
->prev
= face
->prev
;
5696 c
->faces_by_id
[face
->id
] = NULL
;
5697 if (face
->id
== c
->used
)
5702 /* Look up a realized face with face attributes ATTR in the face cache
5703 of frame F. The face will be used to display character C. Value
5704 is the ID of the face found. If no suitable face is found, realize
5705 a new one. In that case, if C is a multibyte character, BASE_FACE
5706 is a face that has the same attributes. */
5709 lookup_face (f
, attr
, c
, base_face
)
5713 struct face
*base_face
;
5715 struct face_cache
*cache
= FRAME_FACE_CACHE (f
);
5720 xassert (cache
!= NULL
);
5721 check_lface_attrs (attr
);
5723 /* Look up ATTR in the face cache. */
5724 hash
= lface_hash (attr
);
5725 i
= hash
% FACE_CACHE_BUCKETS_SIZE
;
5727 for (face
= cache
->buckets
[i
]; face
; face
= face
->next
)
5728 if (face
->hash
== hash
5729 && (!FRAME_WINDOW_P (f
)
5730 || FACE_SUITABLE_FOR_CHAR_P (face
, c
))
5731 && lface_equal_p (face
->lface
, attr
))
5734 /* If not found, realize a new face. */
5736 face
= realize_face (cache
, attr
, c
, base_face
, -1);
5739 xassert (face
== FACE_FROM_ID (f
, face
->id
));
5741 /* When this function is called from face_for_char (in this case, C is
5742 a multibyte character), a fontset of a face returned by
5743 realize_face is not yet set, i.e. FACE_SUITABLE_FOR_CHAR_P (FACE,
5744 C) is not sutisfied. The fontset is set for this face by
5745 face_for_char later. */
5747 if (FRAME_WINDOW_P (f
))
5748 xassert (FACE_SUITABLE_FOR_CHAR_P (face
, c
));
5750 #endif /* GLYPH_DEBUG */
5756 /* Return the face id of the realized face for named face SYMBOL on
5757 frame F suitable for displaying character C. Value is -1 if the
5758 face couldn't be determined, which might happen if the default face
5759 isn't realized and cannot be realized. */
5762 lookup_named_face (f
, symbol
, c
)
5767 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5768 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5769 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5771 if (default_face
== NULL
)
5773 if (!realize_basic_faces (f
))
5775 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
5778 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
5779 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
5780 merge_face_vectors (f
, symbol_attrs
, attrs
, Qnil
);
5781 return lookup_face (f
, attrs
, c
, NULL
);
5785 /* Return the ID of the realized ASCII face of Lisp face with ID
5786 LFACE_ID on frame F. Value is -1 if LFACE_ID isn't valid. */
5789 ascii_face_of_lisp_face (f
, lface_id
)
5795 if (lface_id
>= 0 && lface_id
< lface_id_to_name_size
)
5797 Lisp_Object face_name
= lface_id_to_name
[lface_id
];
5798 face_id
= lookup_named_face (f
, face_name
, 0);
5807 /* Return a face for charset ASCII that is like the face with id
5808 FACE_ID on frame F, but has a font that is STEPS steps smaller.
5809 STEPS < 0 means larger. Value is the id of the face. */
5812 smaller_face (f
, face_id
, steps
)
5816 #ifdef HAVE_WINDOW_SYSTEM
5818 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5819 int pt
, last_pt
, last_height
;
5822 struct face
*new_face
;
5824 /* If not called for an X frame, just return the original face. */
5825 if (FRAME_TERMCAP_P (f
))
5828 /* Try in increments of 1/2 pt. */
5829 delta
= steps
< 0 ? 5 : -5;
5830 steps
= abs (steps
);
5832 face
= FACE_FROM_ID (f
, face_id
);
5833 bcopy (face
->lface
, attrs
, sizeof attrs
);
5834 pt
= last_pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
5835 new_face_id
= face_id
;
5836 last_height
= FONT_HEIGHT (face
->font
);
5840 /* Give up if we cannot find a font within 10pt. */
5841 && abs (last_pt
- pt
) < 100)
5843 /* Look up a face for a slightly smaller/larger font. */
5845 attrs
[LFACE_HEIGHT_INDEX
] = make_number (pt
);
5846 new_face_id
= lookup_face (f
, attrs
, 0, NULL
);
5847 new_face
= FACE_FROM_ID (f
, new_face_id
);
5849 /* If height changes, count that as one step. */
5850 if ((delta
< 0 && FONT_HEIGHT (new_face
->font
) < last_height
)
5851 || (delta
> 0 && FONT_HEIGHT (new_face
->font
) > last_height
))
5854 last_height
= FONT_HEIGHT (new_face
->font
);
5861 #else /* not HAVE_WINDOW_SYSTEM */
5865 #endif /* not HAVE_WINDOW_SYSTEM */
5869 /* Return a face for charset ASCII that is like the face with id
5870 FACE_ID on frame F, but has height HEIGHT. */
5873 face_with_height (f
, face_id
, height
)
5878 #ifdef HAVE_WINDOW_SYSTEM
5880 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5882 if (FRAME_TERMCAP_P (f
)
5886 face
= FACE_FROM_ID (f
, face_id
);
5887 bcopy (face
->lface
, attrs
, sizeof attrs
);
5888 attrs
[LFACE_HEIGHT_INDEX
] = make_number (height
);
5889 face_id
= lookup_face (f
, attrs
, 0, NULL
);
5890 #endif /* HAVE_WINDOW_SYSTEM */
5896 /* Return the face id of the realized face for named face SYMBOL on
5897 frame F suitable for displaying character C, and use attributes of
5898 the face FACE_ID for attributes that aren't completely specified by
5899 SYMBOL. This is like lookup_named_face, except that the default
5900 attributes come from FACE_ID, not from the default face. FACE_ID
5901 is assumed to be already realized. */
5904 lookup_derived_face (f
, symbol
, c
, face_id
)
5910 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
5911 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
5912 struct face
*default_face
= FACE_FROM_ID (f
, face_id
);
5917 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
5918 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
5919 merge_face_vectors (f
, symbol_attrs
, attrs
, Qnil
);
5920 return lookup_face (f
, attrs
, c
, default_face
);
5923 DEFUN ("face-attributes-as-vector", Fface_attributes_as_vector
,
5924 Sface_attributes_as_vector
, 1, 1, 0,
5925 doc
: /* Return a vector of face attributes corresponding to PLIST. */)
5930 lface
= Fmake_vector (make_number (LFACE_VECTOR_SIZE
),
5932 merge_face_vector_with_property (XFRAME (selected_frame
),
5933 XVECTOR (lface
)->contents
,
5940 /***********************************************************************
5942 ***********************************************************************/
5944 DEFUN ("internal-set-font-selection-order",
5945 Finternal_set_font_selection_order
,
5946 Sinternal_set_font_selection_order
, 1, 1, 0,
5947 doc
: /* Set font selection order for face font selection to ORDER.
5948 ORDER must be a list of length 4 containing the symbols `:width',
5949 `:height', `:weight', and `:slant'. Face attributes appearing
5950 first in ORDER are matched first, e.g. if `:height' appears before
5951 `:weight' in ORDER, font selection first tries to find a font with
5952 a suitable height, and then tries to match the font weight.
5959 int indices
[DIM (font_sort_order
)];
5962 bzero (indices
, sizeof indices
);
5966 CONSP (list
) && i
< DIM (indices
);
5967 list
= XCDR (list
), ++i
)
5969 Lisp_Object attr
= XCAR (list
);
5972 if (EQ (attr
, QCwidth
))
5974 else if (EQ (attr
, QCheight
))
5975 xlfd
= XLFD_POINT_SIZE
;
5976 else if (EQ (attr
, QCweight
))
5978 else if (EQ (attr
, QCslant
))
5983 if (indices
[i
] != 0)
5988 if (!NILP (list
) || i
!= DIM (indices
))
5989 signal_error ("Invalid font sort order", order
);
5990 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
5991 if (indices
[i
] == 0)
5992 signal_error ("Invalid font sort order", order
);
5994 if (bcmp (indices
, font_sort_order
, sizeof indices
) != 0)
5996 bcopy (indices
, font_sort_order
, sizeof font_sort_order
);
5997 free_all_realized_faces (Qnil
);
6004 DEFUN ("internal-set-alternative-font-family-alist",
6005 Finternal_set_alternative_font_family_alist
,
6006 Sinternal_set_alternative_font_family_alist
, 1, 1, 0,
6007 doc
: /* Define alternative font families to try in face font selection.
6008 ALIST is an alist of (FAMILY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6009 Each ALTERNATIVE is tried in order if no fonts of font family FAMILY can
6010 be found. Value is ALIST. */)
6015 Vface_alternative_font_family_alist
= alist
;
6016 free_all_realized_faces (Qnil
);
6021 DEFUN ("internal-set-alternative-font-registry-alist",
6022 Finternal_set_alternative_font_registry_alist
,
6023 Sinternal_set_alternative_font_registry_alist
, 1, 1, 0,
6024 doc
: /* Define alternative font registries to try in face font selection.
6025 ALIST is an alist of (REGISTRY ALTERNATIVE1 ALTERNATIVE2 ...) entries.
6026 Each ALTERNATIVE is tried in order if no fonts of font registry REGISTRY can
6027 be found. Value is ALIST. */)
6032 Vface_alternative_font_registry_alist
= alist
;
6033 free_all_realized_faces (Qnil
);
6038 #ifdef HAVE_WINDOW_SYSTEM
6040 /* Value is non-zero if FONT is the name of a scalable font. The
6041 X11R6 XLFD spec says that point size, pixel size, and average width
6042 are zero for scalable fonts. Intlfonts contain at least one
6043 scalable font ("*-muleindian-1") for which this isn't true, so we
6044 just test average width. */
6047 font_scalable_p (font
)
6048 struct font_name
*font
;
6050 char *s
= font
->fields
[XLFD_AVGWIDTH
];
6051 return (*s
== '0' && *(s
+ 1) == '\0')
6053 /* Windows implementation of XLFD is slightly broken for backward
6054 compatibility with previous broken versions, so test for
6055 wildcards as well as 0. */
6062 /* Ignore the difference of font point size less than this value. */
6064 #define FONT_POINT_SIZE_QUANTUM 5
6066 /* Value is non-zero if FONT1 is a better match for font attributes
6067 VALUES than FONT2. VALUES is an array of face attribute values in
6068 font sort order. COMPARE_PT_P zero means don't compare point
6069 sizes. AVGWIDTH, if not zero, is a specified font average width
6073 better_font_p (values
, font1
, font2
, compare_pt_p
, avgwidth
)
6075 struct font_name
*font1
, *font2
;
6076 int compare_pt_p
, avgwidth
;
6080 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6082 int xlfd_idx
= font_sort_order
[i
];
6084 if (compare_pt_p
|| xlfd_idx
!= XLFD_POINT_SIZE
)
6088 if (xlfd_idx
== XLFD_POINT_SIZE
)
6090 delta1
= abs (values
[i
] - (font1
->numeric
[xlfd_idx
]
6091 / font1
->rescale_ratio
));
6092 delta2
= abs (values
[i
] - (font2
->numeric
[xlfd_idx
]
6093 / font2
->rescale_ratio
));
6094 if (abs (delta1
- delta2
) < FONT_POINT_SIZE_QUANTUM
)
6099 delta1
= abs (values
[i
] - font1
->numeric
[xlfd_idx
]);
6100 delta2
= abs (values
[i
] - font2
->numeric
[xlfd_idx
]);
6103 if (delta1
> delta2
)
6105 else if (delta1
< delta2
)
6109 /* The difference may be equal because, e.g., the face
6110 specifies `italic' but we have only `regular' and
6111 `oblique'. Prefer `oblique' in this case. */
6112 if ((xlfd_idx
== XLFD_WEIGHT
|| xlfd_idx
== XLFD_SLANT
)
6113 && font1
->numeric
[xlfd_idx
] > values
[i
]
6114 && font2
->numeric
[xlfd_idx
] < values
[i
])
6122 int delta1
= abs (avgwidth
- font1
->numeric
[XLFD_AVGWIDTH
]);
6123 int delta2
= abs (avgwidth
- font2
->numeric
[XLFD_AVGWIDTH
]);
6124 if (delta1
> delta2
)
6126 else if (delta1
< delta2
)
6132 /* We prefer a real scalable font; i.e. not what autoscaled. */
6133 int auto_scaled_1
= (font1
->numeric
[XLFD_POINT_SIZE
] == 0
6134 && font1
->numeric
[XLFD_RESY
] > 0);
6135 int auto_scaled_2
= (font2
->numeric
[XLFD_POINT_SIZE
] == 0
6136 && font2
->numeric
[XLFD_RESY
] > 0);
6138 if (auto_scaled_1
!= auto_scaled_2
)
6139 return auto_scaled_2
;
6142 return font1
->registry_priority
< font2
->registry_priority
;
6146 /* Value is non-zero if FONT is an exact match for face attributes in
6147 SPECIFIED. SPECIFIED is an array of face attribute values in font
6148 sort order. AVGWIDTH, if non-zero, is an average width to compare
6152 exact_face_match_p (specified
, font
, avgwidth
)
6154 struct font_name
*font
;
6159 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6160 if (specified
[i
] != font
->numeric
[font_sort_order
[i
]])
6163 return (i
== DIM (font_sort_order
)
6165 || avgwidth
== font
->numeric
[XLFD_AVGWIDTH
]));
6169 /* Value is the name of a scaled font, generated from scalable font
6170 FONT on frame F. SPECIFIED_PT is the point-size to scale FONT to.
6171 Value is allocated from heap. */
6174 build_scalable_font_name (f
, font
, specified_pt
)
6176 struct font_name
*font
;
6179 char pixel_size
[20];
6181 double resy
= FRAME_X_DISPLAY_INFO (f
)->resy
;
6184 /* If scalable font is for a specific resolution, compute
6185 the point size we must specify from the resolution of
6186 the display and the specified resolution of the font. */
6187 if (font
->numeric
[XLFD_RESY
] != 0)
6189 pt
= resy
/ font
->numeric
[XLFD_RESY
] * specified_pt
+ 0.5;
6190 pixel_value
= font
->numeric
[XLFD_RESY
] / (PT_PER_INCH
* 10.0) * pt
;
6195 pixel_value
= resy
/ (PT_PER_INCH
* 10.0) * pt
;
6197 /* We may need a font of the different size. */
6198 pixel_value
*= font
->rescale_ratio
;
6200 /* We should keep POINT_SIZE 0. Otherwise, X server can't open a
6201 font of the specified PIXEL_SIZE. */
6203 { /* Set point size of the font. */
6204 char point_size
[20];
6205 sprintf (point_size
, "%d", (int) pt
);
6206 font
->fields
[XLFD_POINT_SIZE
] = point_size
;
6207 font
->numeric
[XLFD_POINT_SIZE
] = pt
;
6211 /* Set pixel size. */
6212 sprintf (pixel_size
, "%d", pixel_value
);
6213 font
->fields
[XLFD_PIXEL_SIZE
] = pixel_size
;
6214 font
->numeric
[XLFD_PIXEL_SIZE
] = pixel_value
;
6216 /* If font doesn't specify its resolution, use the
6217 resolution of the display. */
6218 if (font
->numeric
[XLFD_RESY
] == 0)
6221 sprintf (buffer
, "%d", (int) resy
);
6222 font
->fields
[XLFD_RESY
] = buffer
;
6223 font
->numeric
[XLFD_RESY
] = resy
;
6226 if (strcmp (font
->fields
[XLFD_RESX
], "0") == 0)
6229 int resx
= FRAME_X_DISPLAY_INFO (f
)->resx
;
6230 sprintf (buffer
, "%d", resx
);
6231 font
->fields
[XLFD_RESX
] = buffer
;
6232 font
->numeric
[XLFD_RESX
] = resx
;
6235 return build_font_name (font
);
6239 /* Value is non-zero if we are allowed to use scalable font FONT. We
6240 can't run a Lisp function here since this function may be called
6241 with input blocked. */
6244 may_use_scalable_font_p (font
)
6247 if (EQ (Vscalable_fonts_allowed
, Qt
))
6249 else if (CONSP (Vscalable_fonts_allowed
))
6251 Lisp_Object tail
, regexp
;
6253 for (tail
= Vscalable_fonts_allowed
; CONSP (tail
); tail
= XCDR (tail
))
6255 regexp
= XCAR (tail
);
6256 if (STRINGP (regexp
)
6257 && fast_c_string_match_ignore_case (regexp
, font
) >= 0)
6267 /* Return the name of the best matching font for face attributes ATTRS
6268 in the array of font_name structures FONTS which contains NFONTS
6269 elements. WIDTH_RATIO is a factor with which to multiply average
6270 widths if ATTRS specifies such a width.
6272 Value is a font name which is allocated from the heap. FONTS is
6273 freed by this function.
6275 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
6276 indicate whether the resulting font should be drawn using overstrike
6277 to simulate bold-face. */
6280 best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
, needs_overstrike
)
6283 struct font_name
*fonts
;
6286 int *needs_overstrike
;
6289 struct font_name
*best
;
6292 int exact_p
, avgwidth
;
6297 /* Make specified font attributes available in `specified',
6298 indexed by sort order. */
6299 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
6301 int xlfd_idx
= font_sort_order
[i
];
6303 if (xlfd_idx
== XLFD_SWIDTH
)
6304 specified
[i
] = face_numeric_swidth (attrs
[LFACE_SWIDTH_INDEX
]);
6305 else if (xlfd_idx
== XLFD_POINT_SIZE
)
6306 specified
[i
] = pt
= XFASTINT (attrs
[LFACE_HEIGHT_INDEX
]);
6307 else if (xlfd_idx
== XLFD_WEIGHT
)
6308 specified
[i
] = face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
6309 else if (xlfd_idx
== XLFD_SLANT
)
6310 specified
[i
] = face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
6315 avgwidth
= (UNSPECIFIEDP (attrs
[LFACE_AVGWIDTH_INDEX
])
6317 : XFASTINT (attrs
[LFACE_AVGWIDTH_INDEX
]) * width_ratio
);
6321 if (needs_overstrike
)
6322 *needs_overstrike
= 0;
6324 /* Start with the first non-scalable font in the list. */
6325 for (i
= 0; i
< nfonts
; ++i
)
6326 if (!font_scalable_p (fonts
+ i
))
6329 /* Find the best match among the non-scalable fonts. */
6334 for (i
= 1; i
< nfonts
; ++i
)
6335 if (!font_scalable_p (fonts
+ i
)
6336 && better_font_p (specified
, fonts
+ i
, best
, 1, avgwidth
))
6340 exact_p
= exact_face_match_p (specified
, best
, avgwidth
);
6348 /* Unless we found an exact match among non-scalable fonts, see if
6349 we can find a better match among scalable fonts. */
6352 /* A scalable font is better if
6354 1. its weight, slant, swidth attributes are better, or.
6356 2. the best non-scalable font doesn't have the required
6357 point size, and the scalable fonts weight, slant, swidth
6360 int non_scalable_has_exact_height_p
;
6362 if (best
&& best
->numeric
[XLFD_POINT_SIZE
] == pt
)
6363 non_scalable_has_exact_height_p
= 1;
6365 non_scalable_has_exact_height_p
= 0;
6367 for (i
= 0; i
< nfonts
; ++i
)
6368 if (font_scalable_p (fonts
+ i
))
6371 || better_font_p (specified
, fonts
+ i
, best
, 0, 0)
6372 || (!non_scalable_has_exact_height_p
6373 && !better_font_p (specified
, best
, fonts
+ i
, 0, 0)))
6375 non_scalable_has_exact_height_p
= 1;
6380 if (needs_overstrike
)
6382 enum xlfd_weight want_weight
= specified
[XLFD_WEIGHT
];
6383 enum xlfd_weight got_weight
= best
->numeric
[XLFD_WEIGHT
];
6385 if (want_weight
> XLFD_WEIGHT_MEDIUM
&& want_weight
> got_weight
)
6387 /* We want a bold font, but didn't get one; try to use
6388 overstriking instead to simulate bold-face. However,
6389 don't overstrike an already-bold fontn unless the
6390 desired weight grossly exceeds the available weight. */
6391 if (got_weight
> XLFD_WEIGHT_MEDIUM
)
6392 *needs_overstrike
= (got_weight
- want_weight
) > 2;
6394 *needs_overstrike
= 1;
6399 if (font_scalable_p (best
))
6400 font_name
= build_scalable_font_name (f
, best
, pt
);
6402 font_name
= build_font_name (best
);
6404 /* Free font_name structures. */
6405 free_font_names (fonts
, nfonts
);
6411 /* Get a list of matching fonts on frame F, considering FAMILY
6412 and alternative font families from Vface_alternative_font_registry_alist.
6414 FAMILY is the font family whose alternatives are considered.
6416 REGISTRY, if a string, specifies a font registry and encoding to
6417 match. A value of nil means include fonts of any registry and
6420 Return in *FONTS a pointer to a vector of font_name structures for
6421 the fonts matched. Value is the number of fonts found. */
6424 try_alternative_families (f
, family
, registry
, fonts
)
6426 Lisp_Object family
, registry
;
6427 struct font_name
**fonts
;
6432 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
6435 /* Try alternative font families. */
6436 alter
= Fassoc (family
, Vface_alternative_font_family_alist
);
6439 for (alter
= XCDR (alter
);
6440 CONSP (alter
) && nfonts
== 0;
6441 alter
= XCDR (alter
))
6443 if (STRINGP (XCAR (alter
)))
6444 nfonts
= font_list (f
, Qnil
, XCAR (alter
), registry
, fonts
);
6448 /* Try all scalable fonts before giving up. */
6449 if (nfonts
== 0 && ! EQ (Vscalable_fonts_allowed
, Qt
))
6451 int count
= SPECPDL_INDEX ();
6452 specbind (Qscalable_fonts_allowed
, Qt
);
6453 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6454 unbind_to (count
, Qnil
);
6461 /* Get a list of matching fonts on frame F.
6463 FAMILY, if a string, specifies a font family derived from the fontset.
6464 It is only used if the face does not specify any family in ATTRS or
6465 if we cannot find any font of the face's family.
6467 REGISTRY, if a string, specifies a font registry and encoding to
6468 match. A value of nil means include fonts of any registry and
6471 If PREFER_FACE_FAMILY is nonzero, perfer face's family to FAMILY.
6472 Otherwise, prefer FAMILY.
6474 Return in *FONTS a pointer to a vector of font_name structures for
6475 the fonts matched. Value is the number of fonts found. */
6478 try_font_list (f
, attrs
, family
, registry
, fonts
, prefer_face_family
)
6481 Lisp_Object family
, registry
;
6482 struct font_name
**fonts
;
6483 int prefer_face_family
;
6486 Lisp_Object face_family
= attrs
[LFACE_FAMILY_INDEX
];
6487 Lisp_Object try_family
;
6489 try_family
= (prefer_face_family
|| NILP (family
)) ? face_family
: family
;
6491 if (STRINGP (try_family
))
6492 nfonts
= try_alternative_families (f
, try_family
, registry
, fonts
);
6495 /* When realizing the default face and a font spec does not matched
6496 exactly, Emacs looks for ones with the same registry as the
6497 default font. On the Mac, this is mac-roman, which does not work
6498 if the family is -etl-fixed, e.g. The following widens the
6499 choices and fixes that problem. */
6500 if (nfonts
== 0 && STRINGP (try_family
) && STRINGP (registry
)
6501 && xstricmp (SDATA (registry
), "mac-roman") == 0)
6502 nfonts
= try_alternative_families (f
, try_family
, Qnil
, fonts
);
6505 if (EQ (try_family
, family
))
6506 family
= face_family
;
6508 if (nfonts
== 0 && STRINGP (family
))
6509 nfonts
= try_alternative_families (f
, family
, registry
, fonts
);
6511 /* Try font family of the default face or "fixed". */
6514 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6516 family
= default_face
->lface
[LFACE_FAMILY_INDEX
];
6518 family
= build_string ("fixed");
6519 nfonts
= font_list (f
, Qnil
, family
, registry
, fonts
);
6522 /* Try any family with the given registry. */
6524 nfonts
= try_alternative_families (f
, Qnil
, registry
, fonts
);
6530 /* Return the fontset id of the base fontset name or alias name given
6531 by the fontset attribute of ATTRS. Value is -1 if the fontset
6532 attribute of ATTRS doesn't name a fontset. */
6535 face_fontset (attrs
)
6540 name
= attrs
[LFACE_FONT_INDEX
];
6541 if (!STRINGP (name
))
6543 return fs_query_fontset (name
, 0);
6547 /* Choose a name of font to use on frame F to display character C with
6548 Lisp face attributes specified by ATTRS. The font name is
6549 determined by the font-related attributes in ATTRS and the name
6550 pattern for C in FONTSET. Value is the font name which is
6551 allocated from the heap and must be freed by the caller, or NULL if
6552 we can get no information about the font name of C. It is assured
6553 that we always get some information for a single byte
6556 If NEEDS_OVERSTRIKE is non-zero, a boolean is returned in it to
6557 indicate whether the resulting font should be drawn using overstrike
6558 to simulate bold-face. */
6561 choose_face_font (f
, attrs
, fontset
, c
, needs_overstrike
)
6565 int *needs_overstrike
;
6567 Lisp_Object pattern
;
6568 char *font_name
= NULL
;
6569 struct font_name
*fonts
;
6570 int nfonts
, width_ratio
;
6572 if (needs_overstrike
)
6573 *needs_overstrike
= 0;
6575 /* Get (foundry and) family name and registry (and encoding) name of
6577 pattern
= fontset_font_pattern (f
, fontset
, c
);
6580 xassert (!SINGLE_BYTE_CHAR_P (c
));
6584 /* If what we got is a name pattern, return it. */
6585 if (STRINGP (pattern
))
6586 return xstrdup (SDATA (pattern
));
6588 /* Get a list of fonts matching that pattern and choose the
6589 best match for the specified face attributes from it. */
6590 nfonts
= try_font_list (f
, attrs
, XCAR (pattern
), XCDR (pattern
), &fonts
,
6591 (SINGLE_BYTE_CHAR_P (c
)
6592 || CHAR_CHARSET (c
) == charset_latin_iso8859_1
));
6593 width_ratio
= (SINGLE_BYTE_CHAR_P (c
)
6595 : CHARSET_WIDTH (CHAR_CHARSET (c
)));
6596 font_name
= best_matching_font (f
, attrs
, fonts
, nfonts
, width_ratio
,
6601 #endif /* HAVE_WINDOW_SYSTEM */
6605 /***********************************************************************
6607 ***********************************************************************/
6609 /* Realize basic faces on frame F. Value is zero if frame parameters
6610 of F don't contain enough information needed to realize the default
6614 realize_basic_faces (f
)
6618 int count
= SPECPDL_INDEX ();
6620 /* Block input here so that we won't be surprised by an X expose
6621 event, for instance, without having the faces set up. */
6623 specbind (Qscalable_fonts_allowed
, Qt
);
6625 if (realize_default_face (f
))
6627 realize_named_face (f
, Qmode_line
, MODE_LINE_FACE_ID
);
6628 realize_named_face (f
, Qmode_line_inactive
, MODE_LINE_INACTIVE_FACE_ID
);
6629 realize_named_face (f
, Qtool_bar
, TOOL_BAR_FACE_ID
);
6630 realize_named_face (f
, Qfringe
, FRINGE_FACE_ID
);
6631 realize_named_face (f
, Qheader_line
, HEADER_LINE_FACE_ID
);
6632 realize_named_face (f
, Qscroll_bar
, SCROLL_BAR_FACE_ID
);
6633 realize_named_face (f
, Qborder
, BORDER_FACE_ID
);
6634 realize_named_face (f
, Qcursor
, CURSOR_FACE_ID
);
6635 realize_named_face (f
, Qmouse
, MOUSE_FACE_ID
);
6636 realize_named_face (f
, Qmenu
, MENU_FACE_ID
);
6638 /* Reflect changes in the `menu' face in menu bars. */
6639 if (FRAME_FACE_CACHE (f
)->menu_face_changed_p
)
6641 FRAME_FACE_CACHE (f
)->menu_face_changed_p
= 0;
6642 #ifdef USE_X_TOOLKIT
6643 if (FRAME_WINDOW_P (f
))
6644 x_update_menu_appearance (f
);
6651 unbind_to (count
, Qnil
);
6657 /* Realize the default face on frame F. If the face is not fully
6658 specified, make it fully-specified. Attributes of the default face
6659 that are not explicitly specified are taken from frame parameters. */
6662 realize_default_face (f
)
6665 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
6667 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6668 Lisp_Object frame_font
;
6671 /* If the `default' face is not yet known, create it. */
6672 lface
= lface_from_face_name (f
, Qdefault
, 0);
6676 XSETFRAME (frame
, f
);
6677 lface
= Finternal_make_lisp_face (Qdefault
, frame
);
6681 #ifdef HAVE_WINDOW_SYSTEM
6682 if (FRAME_WINDOW_P (f
))
6684 /* Set frame_font to the value of the `font' frame parameter. */
6685 frame_font
= Fassq (Qfont
, f
->param_alist
);
6686 xassert (CONSP (frame_font
) && STRINGP (XCDR (frame_font
)));
6687 frame_font
= XCDR (frame_font
);
6688 set_lface_from_font_name (f
, lface
, frame_font
,
6689 f
->default_face_done_p
, 1);
6690 f
->default_face_done_p
= 1;
6692 #endif /* HAVE_WINDOW_SYSTEM */
6694 if (!FRAME_WINDOW_P (f
))
6696 LFACE_FAMILY (lface
) = build_string ("default");
6697 LFACE_SWIDTH (lface
) = Qnormal
;
6698 LFACE_HEIGHT (lface
) = make_number (1);
6699 if (UNSPECIFIEDP (LFACE_WEIGHT (lface
)))
6700 LFACE_WEIGHT (lface
) = Qnormal
;
6701 if (UNSPECIFIEDP (LFACE_SLANT (lface
)))
6702 LFACE_SLANT (lface
) = Qnormal
;
6703 LFACE_AVGWIDTH (lface
) = Qunspecified
;
6706 if (UNSPECIFIEDP (LFACE_UNDERLINE (lface
)))
6707 LFACE_UNDERLINE (lface
) = Qnil
;
6709 if (UNSPECIFIEDP (LFACE_OVERLINE (lface
)))
6710 LFACE_OVERLINE (lface
) = Qnil
;
6712 if (UNSPECIFIEDP (LFACE_STRIKE_THROUGH (lface
)))
6713 LFACE_STRIKE_THROUGH (lface
) = Qnil
;
6715 if (UNSPECIFIEDP (LFACE_BOX (lface
)))
6716 LFACE_BOX (lface
) = Qnil
;
6718 if (UNSPECIFIEDP (LFACE_INVERSE (lface
)))
6719 LFACE_INVERSE (lface
) = Qnil
;
6721 if (UNSPECIFIEDP (LFACE_FOREGROUND (lface
)))
6723 /* This function is called so early that colors are not yet
6724 set in the frame parameter list. */
6725 Lisp_Object color
= Fassq (Qforeground_color
, f
->param_alist
);
6727 if (CONSP (color
) && STRINGP (XCDR (color
)))
6728 LFACE_FOREGROUND (lface
) = XCDR (color
);
6729 else if (FRAME_WINDOW_P (f
))
6731 else if (FRAME_INITIAL_P (f
) || FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
6732 LFACE_FOREGROUND (lface
) = build_string (unspecified_fg
);
6737 if (UNSPECIFIEDP (LFACE_BACKGROUND (lface
)))
6739 /* This function is called so early that colors are not yet
6740 set in the frame parameter list. */
6741 Lisp_Object color
= Fassq (Qbackground_color
, f
->param_alist
);
6742 if (CONSP (color
) && STRINGP (XCDR (color
)))
6743 LFACE_BACKGROUND (lface
) = XCDR (color
);
6744 else if (FRAME_WINDOW_P (f
))
6746 else if (FRAME_INITIAL_P (f
) || FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
))
6747 LFACE_BACKGROUND (lface
) = build_string (unspecified_bg
);
6752 if (UNSPECIFIEDP (LFACE_STIPPLE (lface
)))
6753 LFACE_STIPPLE (lface
) = Qnil
;
6755 /* Realize the face; it must be fully-specified now. */
6756 xassert (lface_fully_specified_p (XVECTOR (lface
)->contents
));
6757 check_lface (lface
);
6758 bcopy (XVECTOR (lface
)->contents
, attrs
, sizeof attrs
);
6759 face
= realize_face (c
, attrs
, 0, NULL
, DEFAULT_FACE_ID
);
6764 /* Realize basic faces other than the default face in face cache C.
6765 SYMBOL is the face name, ID is the face id the realized face must
6766 have. The default face must have been realized already. */
6769 realize_named_face (f
, symbol
, id
)
6774 struct face_cache
*c
= FRAME_FACE_CACHE (f
);
6775 Lisp_Object lface
= lface_from_face_name (f
, symbol
, 0);
6776 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
6777 Lisp_Object symbol_attrs
[LFACE_VECTOR_SIZE
];
6778 struct face
*new_face
;
6780 /* The default face must exist and be fully specified. */
6781 get_lface_attributes (f
, Qdefault
, attrs
, 1);
6782 check_lface_attrs (attrs
);
6783 xassert (lface_fully_specified_p (attrs
));
6785 /* If SYMBOL isn't know as a face, create it. */
6789 XSETFRAME (frame
, f
);
6790 lface
= Finternal_make_lisp_face (symbol
, frame
);
6793 /* Merge SYMBOL's face with the default face. */
6794 get_lface_attributes (f
, symbol
, symbol_attrs
, 1);
6795 merge_face_vectors (f
, symbol_attrs
, attrs
, Qnil
);
6797 /* Realize the face. */
6798 new_face
= realize_face (c
, attrs
, 0, NULL
, id
);
6802 /* Realize the fully-specified face with attributes ATTRS in face
6803 cache CACHE for character C. If C is a multibyte character,
6804 BASE_FACE is a face that has the same attributes. Otherwise,
6805 BASE_FACE is ignored. If FORMER_FACE_ID is non-negative, it is an
6806 ID of face to remove before caching the new face. Value is a
6807 pointer to the newly created realized face. */
6809 static struct face
*
6810 realize_face (cache
, attrs
, c
, base_face
, former_face_id
)
6811 struct face_cache
*cache
;
6814 struct face
*base_face
;
6819 /* LFACE must be fully specified. */
6820 xassert (cache
!= NULL
);
6821 check_lface_attrs (attrs
);
6823 if (former_face_id
>= 0 && cache
->used
> former_face_id
)
6825 /* Remove the former face. */
6826 struct face
*former_face
= cache
->faces_by_id
[former_face_id
];
6827 uncache_face (cache
, former_face
);
6828 free_realized_face (cache
->f
, former_face
);
6831 if (FRAME_WINDOW_P (cache
->f
))
6832 face
= realize_x_face (cache
, attrs
, c
, base_face
);
6833 else if (FRAME_INITIAL_P (cache
->f
) || FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
))
6834 face
= realize_tty_face (cache
, attrs
, c
);
6838 /* Insert the new face. */
6839 cache_face (cache
, face
, lface_hash (attrs
));
6840 #ifdef HAVE_WINDOW_SYSTEM
6841 if (FRAME_WINDOW_P (cache
->f
) && face
->font
== NULL
)
6842 load_face_font (cache
->f
, face
, c
);
6843 #endif /* HAVE_WINDOW_SYSTEM */
6848 /* Realize the fully-specified face with attributes ATTRS in face
6849 cache CACHE for character C. Do it for X frame CACHE->f. If C is
6850 a multibyte character, BASE_FACE is a face that has the same
6851 attributes. Otherwise, BASE_FACE is ignored. If the new face
6852 doesn't share font with the default face, a fontname is allocated
6853 from the heap and set in `font_name' of the new face, but it is not
6854 yet loaded here. Value is a pointer to the newly created realized
6857 static struct face
*
6858 realize_x_face (cache
, attrs
, c
, base_face
)
6859 struct face_cache
*cache
;
6862 struct face
*base_face
;
6864 #ifdef HAVE_WINDOW_SYSTEM
6865 struct face
*face
, *default_face
;
6867 Lisp_Object stipple
, overline
, strike_through
, box
;
6869 xassert (FRAME_WINDOW_P (cache
->f
));
6870 xassert (SINGLE_BYTE_CHAR_P (c
)
6873 /* Allocate a new realized face. */
6874 face
= make_realized_face (attrs
);
6878 /* If C is a multibyte character, we share all face attirbutes with
6879 BASE_FACE including the realized fontset. But, we must load a
6881 if (!SINGLE_BYTE_CHAR_P (c
))
6883 bcopy (base_face
, face
, sizeof *face
);
6886 /* Don't try to free the colors copied bitwise from BASE_FACE. */
6887 face
->colors_copied_bitwise_p
= 1;
6889 /* to force realize_face to load font */
6894 /* Now we are realizing a face for ASCII (and unibyte) characters. */
6896 /* Determine the font to use. Most of the time, the font will be
6897 the same as the font of the default face, so try that first. */
6898 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
6900 && FACE_SUITABLE_FOR_CHAR_P (default_face
, c
)
6901 && lface_same_font_attributes_p (default_face
->lface
, attrs
))
6903 face
->font
= default_face
->font
;
6904 face
->fontset
= default_face
->fontset
;
6905 face
->font_info_id
= default_face
->font_info_id
;
6906 face
->font_name
= default_face
->font_name
;
6907 face
->ascii_face
= face
;
6909 /* But, as we can't share the fontset, make a new realized
6910 fontset that has the same base fontset as of the default
6913 = make_fontset_for_ascii_face (f
, default_face
->fontset
);
6917 /* If the face attribute ATTRS specifies a fontset, use it as
6918 the base of a new realized fontset. Otherwise, use the same
6919 base fontset as of the default face. The base determines
6920 registry and encoding of a font. It may also determine
6921 foundry and family. The other fields of font name pattern
6922 are constructed from ATTRS. */
6923 int fontset
= face_fontset (attrs
);
6925 if ((fontset
== -1) && default_face
)
6926 fontset
= default_face
->fontset
;
6927 face
->fontset
= make_fontset_for_ascii_face (f
, fontset
);
6928 face
->font
= NULL
; /* to force realize_face to load font */
6931 /* Load colors, and set remaining attributes. */
6933 load_face_colors (f
, face
, attrs
);
6936 box
= attrs
[LFACE_BOX_INDEX
];
6939 /* A simple box of line width 1 drawn in color given by
6941 face
->box_color
= load_color (f
, face
, attrs
[LFACE_BOX_INDEX
],
6943 face
->box
= FACE_SIMPLE_BOX
;
6944 face
->box_line_width
= 1;
6946 else if (INTEGERP (box
))
6948 /* Simple box of specified line width in foreground color of the
6950 xassert (XINT (box
) != 0);
6951 face
->box
= FACE_SIMPLE_BOX
;
6952 face
->box_line_width
= XINT (box
);
6953 face
->box_color
= face
->foreground
;
6954 face
->box_color_defaulted_p
= 1;
6956 else if (CONSP (box
))
6958 /* `(:width WIDTH :color COLOR :shadow SHADOW)'. SHADOW
6959 being one of `raised' or `sunken'. */
6960 face
->box
= FACE_SIMPLE_BOX
;
6961 face
->box_color
= face
->foreground
;
6962 face
->box_color_defaulted_p
= 1;
6963 face
->box_line_width
= 1;
6967 Lisp_Object keyword
, value
;
6969 keyword
= XCAR (box
);
6977 if (EQ (keyword
, QCline_width
))
6979 if (INTEGERP (value
) && XINT (value
) != 0)
6980 face
->box_line_width
= XINT (value
);
6982 else if (EQ (keyword
, QCcolor
))
6984 if (STRINGP (value
))
6986 face
->box_color
= load_color (f
, face
, value
,
6988 face
->use_box_color_for_shadows_p
= 1;
6991 else if (EQ (keyword
, QCstyle
))
6993 if (EQ (value
, Qreleased_button
))
6994 face
->box
= FACE_RAISED_BOX
;
6995 else if (EQ (value
, Qpressed_button
))
6996 face
->box
= FACE_SUNKEN_BOX
;
7001 /* Text underline, overline, strike-through. */
7003 if (EQ (attrs
[LFACE_UNDERLINE_INDEX
], Qt
))
7005 /* Use default color (same as foreground color). */
7006 face
->underline_p
= 1;
7007 face
->underline_defaulted_p
= 1;
7008 face
->underline_color
= 0;
7010 else if (STRINGP (attrs
[LFACE_UNDERLINE_INDEX
]))
7012 /* Use specified color. */
7013 face
->underline_p
= 1;
7014 face
->underline_defaulted_p
= 0;
7015 face
->underline_color
7016 = load_color (f
, face
, attrs
[LFACE_UNDERLINE_INDEX
],
7017 LFACE_UNDERLINE_INDEX
);
7019 else if (NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7021 face
->underline_p
= 0;
7022 face
->underline_defaulted_p
= 0;
7023 face
->underline_color
= 0;
7026 overline
= attrs
[LFACE_OVERLINE_INDEX
];
7027 if (STRINGP (overline
))
7029 face
->overline_color
7030 = load_color (f
, face
, attrs
[LFACE_OVERLINE_INDEX
],
7031 LFACE_OVERLINE_INDEX
);
7032 face
->overline_p
= 1;
7034 else if (EQ (overline
, Qt
))
7036 face
->overline_color
= face
->foreground
;
7037 face
->overline_color_defaulted_p
= 1;
7038 face
->overline_p
= 1;
7041 strike_through
= attrs
[LFACE_STRIKE_THROUGH_INDEX
];
7042 if (STRINGP (strike_through
))
7044 face
->strike_through_color
7045 = load_color (f
, face
, attrs
[LFACE_STRIKE_THROUGH_INDEX
],
7046 LFACE_STRIKE_THROUGH_INDEX
);
7047 face
->strike_through_p
= 1;
7049 else if (EQ (strike_through
, Qt
))
7051 face
->strike_through_color
= face
->foreground
;
7052 face
->strike_through_color_defaulted_p
= 1;
7053 face
->strike_through_p
= 1;
7056 stipple
= attrs
[LFACE_STIPPLE_INDEX
];
7057 if (!NILP (stipple
))
7058 face
->stipple
= load_pixmap (f
, stipple
, &face
->pixmap_w
, &face
->pixmap_h
);
7060 xassert (FACE_SUITABLE_FOR_CHAR_P (face
, c
));
7062 #endif /* HAVE_WINDOW_SYSTEM */
7066 /* Map a specified color of face FACE on frame F to a tty color index.
7067 IDX is either LFACE_FOREGROUND_INDEX or LFACE_BACKGROUND_INDEX, and
7068 specifies which color to map. Set *DEFAULTED to 1 if mapping to the
7069 default foreground/background colors. */
7072 map_tty_color (f
, face
, idx
, defaulted
)
7075 enum lface_attribute_index idx
;
7078 Lisp_Object frame
, color
, def
;
7079 int foreground_p
= idx
== LFACE_FOREGROUND_INDEX
;
7080 unsigned long default_pixel
, default_other_pixel
, pixel
;
7082 xassert (idx
== LFACE_FOREGROUND_INDEX
|| idx
== LFACE_BACKGROUND_INDEX
);
7086 pixel
= default_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7087 default_other_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7091 pixel
= default_pixel
= FACE_TTY_DEFAULT_BG_COLOR
;
7092 default_other_pixel
= FACE_TTY_DEFAULT_FG_COLOR
;
7095 XSETFRAME (frame
, f
);
7096 color
= face
->lface
[idx
];
7100 && CONSP (Vtty_defined_color_alist
)
7101 && (def
= assq_no_quit (color
, call1 (Qtty_color_alist
, frame
)),
7104 /* Associations in tty-defined-color-alist are of the form
7105 (NAME INDEX R G B). We need the INDEX part. */
7106 pixel
= XINT (XCAR (XCDR (def
)));
7109 if (pixel
== default_pixel
&& STRINGP (color
))
7111 pixel
= load_color (f
, face
, color
, idx
);
7113 #if defined (MSDOS) || defined (WINDOWSNT)
7114 /* If the foreground of the default face is the default color,
7115 use the foreground color defined by the frame. */
7117 if (FRAME_MSDOS_P (f
))
7120 if (pixel
== default_pixel
7121 || pixel
== FACE_TTY_DEFAULT_COLOR
)
7124 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7126 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7127 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7130 else if (pixel
== default_other_pixel
)
7133 pixel
= FRAME_BACKGROUND_PIXEL (f
);
7135 pixel
= FRAME_FOREGROUND_PIXEL (f
);
7136 face
->lface
[idx
] = tty_color_name (f
, pixel
);
7142 #endif /* MSDOS or WINDOWSNT */
7146 face
->foreground
= pixel
;
7148 face
->background
= pixel
;
7152 /* Realize the fully-specified face with attributes ATTRS in face
7153 cache CACHE for character C. Do it for TTY frame CACHE->f. Value is a
7154 pointer to the newly created realized face. */
7156 static struct face
*
7157 realize_tty_face (cache
, attrs
, c
)
7158 struct face_cache
*cache
;
7164 int face_colors_defaulted
= 0;
7165 struct frame
*f
= cache
->f
;
7167 /* Frame must be a termcap frame. */
7168 xassert (FRAME_TERMCAP_P (cache
->f
) || FRAME_MSDOS_P (cache
->f
));
7170 /* Allocate a new realized face. */
7171 face
= make_realized_face (attrs
);
7172 face
->font_name
= FRAME_MSDOS_P (cache
->f
) ? "ms-dos" : "tty";
7174 /* Map face attributes to TTY appearances. We map slant to
7175 dimmed text because we want italic text to appear differently
7176 and because dimmed text is probably used infrequently. */
7177 weight
= face_numeric_weight (attrs
[LFACE_WEIGHT_INDEX
]);
7178 slant
= face_numeric_slant (attrs
[LFACE_SLANT_INDEX
]);
7180 if (weight
> XLFD_WEIGHT_MEDIUM
)
7181 face
->tty_bold_p
= 1;
7182 if (weight
< XLFD_WEIGHT_MEDIUM
|| slant
!= XLFD_SLANT_ROMAN
)
7183 face
->tty_dim_p
= 1;
7184 if (!NILP (attrs
[LFACE_UNDERLINE_INDEX
]))
7185 face
->tty_underline_p
= 1;
7186 if (!NILP (attrs
[LFACE_INVERSE_INDEX
]))
7187 face
->tty_reverse_p
= 1;
7189 /* Map color names to color indices. */
7190 map_tty_color (f
, face
, LFACE_FOREGROUND_INDEX
, &face_colors_defaulted
);
7191 map_tty_color (f
, face
, LFACE_BACKGROUND_INDEX
, &face_colors_defaulted
);
7193 /* Swap colors if face is inverse-video. If the colors are taken
7194 from the frame colors, they are already inverted, since the
7195 frame-creation function calls x-handle-reverse-video. */
7196 if (face
->tty_reverse_p
&& !face_colors_defaulted
)
7198 unsigned long tem
= face
->foreground
;
7199 face
->foreground
= face
->background
;
7200 face
->background
= tem
;
7203 if (tty_suppress_bold_inverse_default_colors_p
7205 && face
->background
== FACE_TTY_DEFAULT_FG_COLOR
7206 && face
->foreground
== FACE_TTY_DEFAULT_BG_COLOR
)
7207 face
->tty_bold_p
= 0;
7213 DEFUN ("tty-suppress-bold-inverse-default-colors",
7214 Ftty_suppress_bold_inverse_default_colors
,
7215 Stty_suppress_bold_inverse_default_colors
, 1, 1, 0,
7216 doc
: /* Suppress/allow boldness of faces with inverse default colors.
7217 SUPPRESS non-nil means suppress it.
7218 This affects bold faces on TTYs whose foreground is the default background
7219 color of the display and whose background is the default foreground color.
7220 For such faces, the bold face attribute is ignored if this variable
7223 Lisp_Object suppress
;
7225 tty_suppress_bold_inverse_default_colors_p
= !NILP (suppress
);
7226 ++face_change_count
;
7232 /***********************************************************************
7234 ***********************************************************************/
7236 /* Return the ID of the face to use to display character CH with face
7237 property PROP on frame F in current_buffer. */
7240 compute_char_face (f
, ch
, prop
)
7247 if (NILP (current_buffer
->enable_multibyte_characters
))
7252 struct face
*face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7253 face_id
= FACE_FOR_CHAR (f
, face
, ch
);
7257 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7258 struct face
*default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7259 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7260 merge_face_vector_with_property (f
, attrs
, prop
);
7261 face_id
= lookup_face (f
, attrs
, ch
, NULL
);
7267 /* Return the face ID associated with buffer position POS for
7268 displaying ASCII characters. Return in *ENDPTR the position at
7269 which a different face is needed, as far as text properties and
7270 overlays are concerned. W is a window displaying current_buffer.
7272 REGION_BEG, REGION_END delimit the region, so it can be
7275 LIMIT is a position not to scan beyond. That is to limit the time
7276 this function can take.
7278 If MOUSE is non-zero, use the character's mouse-face, not its face.
7280 The face returned is suitable for displaying ASCII characters. */
7283 face_at_buffer_position (w
, pos
, region_beg
, region_end
,
7284 endptr
, limit
, mouse
)
7287 int region_beg
, region_end
;
7292 struct frame
*f
= XFRAME (w
->frame
);
7293 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7294 Lisp_Object prop
, position
;
7296 Lisp_Object
*overlay_vec
;
7299 Lisp_Object propname
= mouse
? Qmouse_face
: Qface
;
7300 Lisp_Object limit1
, end
;
7301 struct face
*default_face
;
7303 /* W must display the current buffer. We could write this function
7304 to use the frame and buffer of W, but right now it doesn't. */
7305 /* xassert (XBUFFER (w->buffer) == current_buffer); */
7307 XSETFRAME (frame
, f
);
7308 XSETFASTINT (position
, pos
);
7311 if (pos
< region_beg
&& region_beg
< endpos
)
7312 endpos
= region_beg
;
7314 /* Get the `face' or `mouse_face' text property at POS, and
7315 determine the next position at which the property changes. */
7316 prop
= Fget_text_property (position
, propname
, w
->buffer
);
7317 XSETFASTINT (limit1
, (limit
< endpos
? limit
: endpos
));
7318 end
= Fnext_single_property_change (position
, propname
, w
->buffer
, limit1
);
7320 endpos
= XINT (end
);
7322 /* Look at properties from overlays. */
7327 /* First try with room for 40 overlays. */
7329 overlay_vec
= (Lisp_Object
*) alloca (len
* sizeof (Lisp_Object
));
7330 noverlays
= overlays_at (pos
, 0, &overlay_vec
, &len
,
7331 &next_overlay
, NULL
, 0);
7333 /* If there are more than 40, make enough space for all, and try
7335 if (noverlays
> len
)
7338 overlay_vec
= (Lisp_Object
*) alloca (len
* sizeof (Lisp_Object
));
7339 noverlays
= overlays_at (pos
, 0, &overlay_vec
, &len
,
7340 &next_overlay
, NULL
, 0);
7343 if (next_overlay
< endpos
)
7344 endpos
= next_overlay
;
7349 default_face
= FACE_FROM_ID (f
, DEFAULT_FACE_ID
);
7351 /* Optimize common cases where we can use the default face. */
7354 && !(pos
>= region_beg
&& pos
< region_end
))
7355 return DEFAULT_FACE_ID
;
7357 /* Begin with attributes from the default face. */
7358 bcopy (default_face
->lface
, attrs
, sizeof attrs
);
7360 /* Merge in attributes specified via text properties. */
7362 merge_face_vector_with_property (f
, attrs
, prop
);
7364 /* Now merge the overlay data. */
7365 noverlays
= sort_overlays (overlay_vec
, noverlays
, w
);
7366 for (i
= 0; i
< noverlays
; i
++)
7371 prop
= Foverlay_get (overlay_vec
[i
], propname
);
7373 merge_face_vector_with_property (f
, attrs
, prop
);
7375 oend
= OVERLAY_END (overlay_vec
[i
]);
7376 oendpos
= OVERLAY_POSITION (oend
);
7377 if (oendpos
< endpos
)
7381 /* If in the region, merge in the region face. */
7382 if (pos
>= region_beg
&& pos
< region_end
)
7384 Lisp_Object region_face
= lface_from_face_name (f
, Qregion
, 0);
7385 merge_face_vectors (f
, XVECTOR (region_face
)->contents
, attrs
, Qnil
);
7387 if (region_end
< endpos
)
7388 endpos
= region_end
;
7393 /* Look up a realized face with the given face attributes,
7394 or realize a new one for ASCII characters. */
7395 return lookup_face (f
, attrs
, 0, NULL
);
7399 /* Compute the face at character position POS in Lisp string STRING on
7400 window W, for ASCII characters.
7402 If STRING is an overlay string, it comes from position BUFPOS in
7403 current_buffer, otherwise BUFPOS is zero to indicate that STRING is
7404 not an overlay string. W must display the current buffer.
7405 REGION_BEG and REGION_END give the start and end positions of the
7406 region; both are -1 if no region is visible.
7408 BASE_FACE_ID is the id of a face to merge with. For strings coming
7409 from overlays or the `display' property it is the face at BUFPOS.
7411 If MOUSE_P is non-zero, use the character's mouse-face, not its face.
7413 Set *ENDPTR to the next position where to check for faces in
7414 STRING; -1 if the face is constant from POS to the end of the
7417 Value is the id of the face to use. The face returned is suitable
7418 for displaying ASCII characters. */
7421 face_at_string_position (w
, string
, pos
, bufpos
, region_beg
,
7422 region_end
, endptr
, base_face_id
, mouse_p
)
7426 int region_beg
, region_end
;
7428 enum face_id base_face_id
;
7431 Lisp_Object prop
, position
, end
, limit
;
7432 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
7433 Lisp_Object attrs
[LFACE_VECTOR_SIZE
];
7434 struct face
*base_face
;
7435 int multibyte_p
= STRING_MULTIBYTE (string
);
7436 Lisp_Object prop_name
= mouse_p
? Qmouse_face
: Qface
;
7438 /* Get the value of the face property at the current position within
7439 STRING. Value is nil if there is no face property. */
7440 XSETFASTINT (position
, pos
);
7441 prop
= Fget_text_property (position
, prop_name
, string
);
7443 /* Get the next position at which to check for faces. Value of end
7444 is nil if face is constant all the way to the end of the string.
7445 Otherwise it is a string position where to check faces next.
7446 Limit is the maximum position up to which to check for property
7447 changes in Fnext_single_property_change. Strings are usually
7448 short, so set the limit to the end of the string. */
7449 XSETFASTINT (limit
, SCHARS (string
));
7450 end
= Fnext_single_property_change (position
, prop_name
, string
, limit
);
7452 *endptr
= XFASTINT (end
);
7456 base_face
= FACE_FROM_ID (f
, base_face_id
);
7457 xassert (base_face
);
7459 /* Optimize the default case that there is no face property and we
7460 are not in the region. */
7462 && (base_face_id
!= DEFAULT_FACE_ID
7463 /* BUFPOS <= 0 means STRING is not an overlay string, so
7464 that the region doesn't have to be taken into account. */
7466 || bufpos
< region_beg
7467 || bufpos
>= region_end
)
7469 /* We can't realize faces for different charsets differently
7470 if we don't have fonts, so we can stop here if not working
7471 on a window-system frame. */
7472 || !FRAME_WINDOW_P (f
)
7473 || FACE_SUITABLE_FOR_CHAR_P (base_face
, 0)))
7474 return base_face
->id
;
7476 /* Begin with attributes from the base face. */
7477 bcopy (base_face
->lface
, attrs
, sizeof attrs
);
7479 /* Merge in attributes specified via text properties. */
7481 merge_face_vector_with_property (f
, attrs
, prop
);
7483 /* If in the region, merge in the region face. */
7485 && bufpos
>= region_beg
7486 && bufpos
< region_end
)
7488 Lisp_Object region_face
= lface_from_face_name (f
, Qregion
, 0);
7489 merge_face_vectors (f
, XVECTOR (region_face
)->contents
, attrs
, Qnil
);
7492 /* Look up a realized face with the given face attributes,
7493 or realize a new one for ASCII characters. */
7494 return lookup_face (f
, attrs
, 0, NULL
);
7499 /***********************************************************************
7501 ***********************************************************************/
7505 /* Print the contents of the realized face FACE to stderr. */
7508 dump_realized_face (face
)
7511 fprintf (stderr
, "ID: %d\n", face
->id
);
7512 #ifdef HAVE_X_WINDOWS
7513 fprintf (stderr
, "gc: %d\n", (int) face
->gc
);
7515 fprintf (stderr
, "foreground: 0x%lx (%s)\n",
7517 SDATA (face
->lface
[LFACE_FOREGROUND_INDEX
]));
7518 fprintf (stderr
, "background: 0x%lx (%s)\n",
7520 SDATA (face
->lface
[LFACE_BACKGROUND_INDEX
]));
7521 fprintf (stderr
, "font_name: %s (%s)\n",
7523 SDATA (face
->lface
[LFACE_FAMILY_INDEX
]));
7524 #ifdef HAVE_X_WINDOWS
7525 fprintf (stderr
, "font = %p\n", face
->font
);
7527 fprintf (stderr
, "font_info_id = %d\n", face
->font_info_id
);
7528 fprintf (stderr
, "fontset: %d\n", face
->fontset
);
7529 fprintf (stderr
, "underline: %d (%s)\n",
7531 SDATA (Fsymbol_name (face
->lface
[LFACE_UNDERLINE_INDEX
])));
7532 fprintf (stderr
, "hash: %d\n", face
->hash
);
7533 fprintf (stderr
, "charset: %d\n", face
->charset
);
7537 DEFUN ("dump-face", Fdump_face
, Sdump_face
, 0, 1, 0, doc
: /* */)
7545 fprintf (stderr
, "font selection order: ");
7546 for (i
= 0; i
< DIM (font_sort_order
); ++i
)
7547 fprintf (stderr
, "%d ", font_sort_order
[i
]);
7548 fprintf (stderr
, "\n");
7550 fprintf (stderr
, "alternative fonts: ");
7551 debug_print (Vface_alternative_font_family_alist
);
7552 fprintf (stderr
, "\n");
7554 for (i
= 0; i
< FRAME_FACE_CACHE (SELECTED_FRAME ())->used
; ++i
)
7555 Fdump_face (make_number (i
));
7561 face
= FACE_FROM_ID (SELECTED_FRAME (), XINT (n
));
7563 error ("Not a valid face");
7564 dump_realized_face (face
);
7571 DEFUN ("show-face-resources", Fshow_face_resources
, Sshow_face_resources
,
7572 0, 0, 0, doc
: /* */)
7575 fprintf (stderr
, "number of colors = %d\n", ncolors_allocated
);
7576 fprintf (stderr
, "number of pixmaps = %d\n", npixmaps_allocated
);
7577 fprintf (stderr
, "number of GCs = %d\n", ngcs
);
7581 #endif /* GLYPH_DEBUG != 0 */
7585 /***********************************************************************
7587 ***********************************************************************/
7592 Qface
= intern ("face");
7594 Qbitmap_spec_p
= intern ("bitmap-spec-p");
7595 staticpro (&Qbitmap_spec_p
);
7596 Qframe_update_face_colors
= intern ("frame-update-face-colors");
7597 staticpro (&Qframe_update_face_colors
);
7599 /* Lisp face attribute keywords. */
7600 QCfamily
= intern (":family");
7601 staticpro (&QCfamily
);
7602 QCheight
= intern (":height");
7603 staticpro (&QCheight
);
7604 QCweight
= intern (":weight");
7605 staticpro (&QCweight
);
7606 QCslant
= intern (":slant");
7607 staticpro (&QCslant
);
7608 QCunderline
= intern (":underline");
7609 staticpro (&QCunderline
);
7610 QCinverse_video
= intern (":inverse-video");
7611 staticpro (&QCinverse_video
);
7612 QCreverse_video
= intern (":reverse-video");
7613 staticpro (&QCreverse_video
);
7614 QCforeground
= intern (":foreground");
7615 staticpro (&QCforeground
);
7616 QCbackground
= intern (":background");
7617 staticpro (&QCbackground
);
7618 QCstipple
= intern (":stipple");;
7619 staticpro (&QCstipple
);
7620 QCwidth
= intern (":width");
7621 staticpro (&QCwidth
);
7622 QCfont
= intern (":font");
7623 staticpro (&QCfont
);
7624 QCbold
= intern (":bold");
7625 staticpro (&QCbold
);
7626 QCitalic
= intern (":italic");
7627 staticpro (&QCitalic
);
7628 QCoverline
= intern (":overline");
7629 staticpro (&QCoverline
);
7630 QCstrike_through
= intern (":strike-through");
7631 staticpro (&QCstrike_through
);
7632 QCbox
= intern (":box");
7634 QCinherit
= intern (":inherit");
7635 staticpro (&QCinherit
);
7637 /* Symbols used for Lisp face attribute values. */
7638 QCcolor
= intern (":color");
7639 staticpro (&QCcolor
);
7640 QCline_width
= intern (":line-width");
7641 staticpro (&QCline_width
);
7642 QCstyle
= intern (":style");
7643 staticpro (&QCstyle
);
7644 Qreleased_button
= intern ("released-button");
7645 staticpro (&Qreleased_button
);
7646 Qpressed_button
= intern ("pressed-button");
7647 staticpro (&Qpressed_button
);
7648 Qnormal
= intern ("normal");
7649 staticpro (&Qnormal
);
7650 Qultra_light
= intern ("ultra-light");
7651 staticpro (&Qultra_light
);
7652 Qextra_light
= intern ("extra-light");
7653 staticpro (&Qextra_light
);
7654 Qlight
= intern ("light");
7655 staticpro (&Qlight
);
7656 Qsemi_light
= intern ("semi-light");
7657 staticpro (&Qsemi_light
);
7658 Qsemi_bold
= intern ("semi-bold");
7659 staticpro (&Qsemi_bold
);
7660 Qbold
= intern ("bold");
7662 Qextra_bold
= intern ("extra-bold");
7663 staticpro (&Qextra_bold
);
7664 Qultra_bold
= intern ("ultra-bold");
7665 staticpro (&Qultra_bold
);
7666 Qoblique
= intern ("oblique");
7667 staticpro (&Qoblique
);
7668 Qitalic
= intern ("italic");
7669 staticpro (&Qitalic
);
7670 Qreverse_oblique
= intern ("reverse-oblique");
7671 staticpro (&Qreverse_oblique
);
7672 Qreverse_italic
= intern ("reverse-italic");
7673 staticpro (&Qreverse_italic
);
7674 Qultra_condensed
= intern ("ultra-condensed");
7675 staticpro (&Qultra_condensed
);
7676 Qextra_condensed
= intern ("extra-condensed");
7677 staticpro (&Qextra_condensed
);
7678 Qcondensed
= intern ("condensed");
7679 staticpro (&Qcondensed
);
7680 Qsemi_condensed
= intern ("semi-condensed");
7681 staticpro (&Qsemi_condensed
);
7682 Qsemi_expanded
= intern ("semi-expanded");
7683 staticpro (&Qsemi_expanded
);
7684 Qexpanded
= intern ("expanded");
7685 staticpro (&Qexpanded
);
7686 Qextra_expanded
= intern ("extra-expanded");
7687 staticpro (&Qextra_expanded
);
7688 Qultra_expanded
= intern ("ultra-expanded");
7689 staticpro (&Qultra_expanded
);
7690 Qbackground_color
= intern ("background-color");
7691 staticpro (&Qbackground_color
);
7692 Qforeground_color
= intern ("foreground-color");
7693 staticpro (&Qforeground_color
);
7694 Qunspecified
= intern ("unspecified");
7695 staticpro (&Qunspecified
);
7697 Qface_alias
= intern ("face-alias");
7698 staticpro (&Qface_alias
);
7699 Qdefault
= intern ("default");
7700 staticpro (&Qdefault
);
7701 Qtool_bar
= intern ("tool-bar");
7702 staticpro (&Qtool_bar
);
7703 Qregion
= intern ("region");
7704 staticpro (&Qregion
);
7705 Qfringe
= intern ("fringe");
7706 staticpro (&Qfringe
);
7707 Qheader_line
= intern ("header-line");
7708 staticpro (&Qheader_line
);
7709 Qscroll_bar
= intern ("scroll-bar");
7710 staticpro (&Qscroll_bar
);
7711 Qmenu
= intern ("menu");
7713 Qcursor
= intern ("cursor");
7714 staticpro (&Qcursor
);
7715 Qborder
= intern ("border");
7716 staticpro (&Qborder
);
7717 Qmouse
= intern ("mouse");
7718 staticpro (&Qmouse
);
7719 Qmode_line_inactive
= intern ("mode-line-inactive");
7720 staticpro (&Qmode_line_inactive
);
7721 Qtty_color_desc
= intern ("tty-color-desc");
7722 staticpro (&Qtty_color_desc
);
7723 Qtty_color_standard_values
= intern ("tty-color-standard-values");
7724 staticpro (&Qtty_color_standard_values
);
7725 Qtty_color_by_index
= intern ("tty-color-by-index");
7726 staticpro (&Qtty_color_by_index
);
7727 Qtty_color_alist
= intern ("tty-color-alist");
7728 staticpro (&Qtty_color_alist
);
7729 Qscalable_fonts_allowed
= intern ("scalable-fonts-allowed");
7730 staticpro (&Qscalable_fonts_allowed
);
7732 Vparam_value_alist
= Fcons (Fcons (Qnil
, Qnil
), Qnil
);
7733 staticpro (&Vparam_value_alist
);
7734 Vface_alternative_font_family_alist
= Qnil
;
7735 staticpro (&Vface_alternative_font_family_alist
);
7736 Vface_alternative_font_registry_alist
= Qnil
;
7737 staticpro (&Vface_alternative_font_registry_alist
);
7739 defsubr (&Sinternal_make_lisp_face
);
7740 defsubr (&Sinternal_lisp_face_p
);
7741 defsubr (&Sinternal_set_lisp_face_attribute
);
7742 #ifdef HAVE_WINDOW_SYSTEM
7743 defsubr (&Sinternal_set_lisp_face_attribute_from_resource
);
7745 defsubr (&Scolor_gray_p
);
7746 defsubr (&Scolor_supported_p
);
7747 defsubr (&Sface_attribute_relative_p
);
7748 defsubr (&Smerge_face_attribute
);
7749 defsubr (&Sinternal_get_lisp_face_attribute
);
7750 defsubr (&Sinternal_lisp_face_attribute_values
);
7751 defsubr (&Sinternal_lisp_face_equal_p
);
7752 defsubr (&Sinternal_lisp_face_empty_p
);
7753 defsubr (&Sinternal_copy_lisp_face
);
7754 defsubr (&Sinternal_merge_in_global_face
);
7755 defsubr (&Sface_font
);
7756 defsubr (&Sframe_face_alist
);
7757 defsubr (&Stty_supports_face_attributes_p
);
7758 defsubr (&Scolor_distance
);
7759 defsubr (&Sinternal_set_font_selection_order
);
7760 defsubr (&Sinternal_set_alternative_font_family_alist
);
7761 defsubr (&Sinternal_set_alternative_font_registry_alist
);
7762 defsubr (&Sface_attributes_as_vector
);
7764 defsubr (&Sdump_face
);
7765 defsubr (&Sshow_face_resources
);
7766 #endif /* GLYPH_DEBUG */
7767 defsubr (&Sclear_face_cache
);
7768 defsubr (&Stty_suppress_bold_inverse_default_colors
);
7770 #if defined DEBUG_X_COLORS && defined HAVE_X_WINDOWS
7771 defsubr (&Sdump_colors
);
7774 DEFVAR_LISP ("font-list-limit", &Vfont_list_limit
,
7775 doc
: /* *Limit for font matching.
7776 If an integer > 0, font matching functions won't load more than
7777 that number of fonts when searching for a matching font. */);
7778 Vfont_list_limit
= make_number (DEFAULT_FONT_LIST_LIMIT
);
7780 DEFVAR_LISP ("face-new-frame-defaults", &Vface_new_frame_defaults
,
7781 doc
: /* List of global face definitions (for internal use only.) */);
7782 Vface_new_frame_defaults
= Qnil
;
7784 DEFVAR_LISP ("face-default-stipple", &Vface_default_stipple
,
7785 doc
: /* *Default stipple pattern used on monochrome displays.
7786 This stipple pattern is used on monochrome displays
7787 instead of shades of gray for a face background color.
7788 See `set-face-stipple' for possible values for this variable. */);
7789 Vface_default_stipple
= build_string ("gray3");
7791 DEFVAR_LISP ("tty-defined-color-alist", &Vtty_defined_color_alist
,
7792 doc
: /* An alist of defined terminal colors and their RGB values. */);
7793 Vtty_defined_color_alist
= Qnil
;
7795 DEFVAR_LISP ("scalable-fonts-allowed", &Vscalable_fonts_allowed
,
7796 doc
: /* Allowed scalable fonts.
7797 A value of nil means don't allow any scalable fonts.
7798 A value of t means allow any scalable font.
7799 Otherwise, value must be a list of regular expressions. A font may be
7800 scaled if its name matches a regular expression in the list.
7801 Note that if value is nil, a scalable font might still be used, if no
7802 other font of the appropriate family and registry is available. */);
7803 Vscalable_fonts_allowed
= Qnil
;
7805 DEFVAR_LISP ("face-ignored-fonts", &Vface_ignored_fonts
,
7806 doc
: /* List of ignored fonts.
7807 Each element is a regular expression that matches names of fonts to
7809 Vface_ignored_fonts
= Qnil
;
7811 DEFVAR_LISP ("face-font-rescale-alist", &Vface_font_rescale_alist
,
7812 doc
: /* Alist of fonts vs the rescaling factors.
7813 Each element is a cons (FONT-NAME-PATTERN . RESCALE-RATIO), where
7814 FONT-NAME-PATTERN is a regular expression matching a font name, and
7815 RESCALE-RATIO is a floating point number to specify how much larger
7816 \(or smaller) font we should use. For instance, if a face requests
7817 a font of 10 point, we actually use a font of 10 * RESCALE-RATIO point. */);
7818 Vface_font_rescale_alist
= Qnil
;
7820 #ifdef HAVE_WINDOW_SYSTEM
7821 defsubr (&Sbitmap_spec_p
);
7822 defsubr (&Sx_list_fonts
);
7823 defsubr (&Sinternal_face_x_get_resource
);
7824 defsubr (&Sx_family_fonts
);
7825 defsubr (&Sx_font_family_list
);
7826 #endif /* HAVE_WINDOW_SYSTEM */
7829 /* arch-tag: 8a0f7598-5517-408d-9ab3-1da6fcd4c749
7830 (do not change this comment) */